# HG changeset patch
# User Martin Albrecht <malb@informatik.unibremen.de>
# Date 1216905952 7200
# Node ID 3c1c6be7c5cb8bdc5682b6581068747177e47c63
# Parent 4895e2844a19fcaf0bea366ddeff94cb8836661c
document what the variables in the AES equation systems mean.
diff r 4895e2844a19 r 3c1c6be7c5cb sage/crypto/mq/sr.py
a

b

class SR_generic(MPolynomialSystemGenera 
1134  1134  Variables are ordered in the reverse of their natural 
1135  1135  ordering, i.e. the reverse of as they appear. 
1136  1136  
 1137  The variable assignment is as follows: 
 1138  * k_ijl subkey round i word j conjugate/bit l 
 1139  * s_ijl subkey inverse round i word j conjugate/bit l 
 1140  * w_ijl inversion input round i word j conjugate/bit l 
 1141  * x_ijl inversion output round i word j conjugate/bit l 
 1142  
1137  1143  EXAMPLE: 
1138  1144  sage: sr = mq.SR(2, 1, 1, 4) 
1139  1145  sage: P = sr.ring(order='block') 
… 
… 
class SR_generic(MPolynomialSystemGenera 
1338  1344  
1339  1345  def polynomial_system(self, P=None, K=None): 
1340  1346  """ 
1341   Return a MPolynomialSystem for self for a given plaintextkey pair. 
 1347  Return a MPolynomialSystem for self for a given plaintextkey 
 1348  pair. 
1342  1349  
1343  1350  If none are provided a random pair will be generated. 
1344  1351  