X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fexamples.rst;h=e9387a21b9868601eef1b1f1047211dd5b972429;hb=df4f5c5e256f0474778eab5022c7dac71bf4ba48;hp=e95369c84f3f1f9155329e36fdb814fb6fd1fad9;hpb=f8f92c66af855c581d4b6e8b824da63f6987cc33;p=pyderasn.git diff --git a/doc/examples.rst b/doc/examples.rst index e95369c..e9387a2 100644 --- a/doc/examples.rst +++ b/doc/examples.rst @@ -236,12 +236,12 @@ Let's parse that output, human:: :: - 52-2 [1,1,1054]-4 . . . . eContent: [0] EXPLICIT BER OCTET STRING 1046 bytes + 52-2I [1,1,1054]I . . . . eContent: [0] EXPLICIT BER OCTET STRING 1046 bytes ^ ^ ^ ^ 12 13 9 10 :0: - Offset of the object, where its DER encoding begins. + Offset of the object, where its DER/BER encoding begins. Pay attention that it does **not** include explicit tag. :1: If explicit tag exists, then this is its length (tag + encoded length). @@ -272,24 +272,18 @@ Let's parse that output, human:: Possible other flags like OPTIONAL and DEFAULT, if value equals to the default one, specified in the schema. :12: - Only applicable to BER encoded data. If object has indefinite length - encoding, then subtract 2 bytes EOC from its length. If object has - explicit tag with indefinite length, then subtract another EOC bytes. - In example above, ``eContent`` field has both indefinite field encoding - and indefinite length explicit tag. ``BIT STRING``, ``OCTET STRING`` - (and its derivatives), ``SEQUENCE``, ``SET``, ``SEQUENCE OF``, ``SET - OF``, ``ANY`` could have indefinite length coding. + Only applicable to BER encoded data. Indefinite length encoding mark. :13: Only applicable to BER encoded data. If object has BER-specific encoding, then ``BER`` will be shown. It does not depend on indefinite - length encoding. ``BOOLEAN``, ``BIT STRING``, ``OCTET STRING`` (and its - derivatives) could be BERed. + length encoding. ``EOC``, ``BOOLEAN``, ``BIT STRING``, ``OCTET STRING`` + (and its derivatives) could be BERed. As command line utility ----------------------- -You can decode DER files using command line abilities and get the same -picture as above by executing:: +You can decode DER/BER files using command line abilities and get the +same picture as above by executing:: % python -m pyderasn --schema tests.test_crts:Certificate path/to/file @@ -358,7 +352,7 @@ then you can pass it to pretty printer to see human readable OIDs:: Descriptive errors ------------------ -If you have bad DER, then errors will show you where error occurred:: +If you have bad DER/BER, then errors will show you where error occurred:: % python -m pyderasn --schema tests.test_crts:Certificate path/to/bad/file Traceback (most recent call last):