Ticket #3725: sr_doc.patch

File sr_doc.patch, 1.4 KB (added by malb, 11 years ago)
  • sage/crypto/mq/sr.py

    # HG changeset patch
    # User Martin Albrecht <malb@informatik.uni-bremen.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 
    11341134        Variables are ordered in the reverse of their natural
    11351135        ordering, i.e. the reverse of as they appear.
    11361136
     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
    11371143        EXAMPLE:
    11381144            sage: sr = mq.SR(2, 1, 1, 4)
    11391145            sage: P = sr.ring(order='block')
    class SR_generic(MPolynomialSystemGenera 
    13381344
    13391345    def polynomial_system(self, P=None, K=None):
    13401346        """
    1341         Return a MPolynomialSystem for self for a given plaintext-key pair.
     1347        Return a MPolynomialSystem for self for a given plaintext-key
     1348        pair.
    13421349
    13431350        If none are provided a random pair will be generated.
    13441351