diff options
Diffstat (limited to 'doc/libtasn1.info')
| -rw-r--r-- | doc/libtasn1.info | 187 |
1 files changed, 96 insertions, 91 deletions
diff --git a/doc/libtasn1.info b/doc/libtasn1.info index cb9ba88..8f0aa76 100644 --- a/doc/libtasn1.info +++ b/doc/libtasn1.info @@ -1,11 +1,11 @@ -This is libtasn1.info, produced by makeinfo version 6.3 from +This is libtasn1.info, produced by makeinfo version 6.5 from libtasn1.texi. -This manual is for GNU Libtasn1 (version 4.13, 4 April 2016), which is a -library for Abstract Syntax Notation One (ASN.1) and Distinguished +This manual is for GNU Libtasn1 (version 4.14, 29 March 2019), which is +a library for Abstract Syntax Notation One (ASN.1) and Distinguished Encoding Rules (DER) manipulation. - Copyright (C) 2001-2015 Free Software Foundation, Inc. + Copyright (C) 2001-2019 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, @@ -24,11 +24,11 @@ File: libtasn1.info, Node: Top, Next: Introduction, Up: (dir) Libtasn1 ******** -This manual is for GNU Libtasn1 (version 4.13, 4 April 2016), which is a -library for Abstract Syntax Notation One (ASN.1) and Distinguished +This manual is for GNU Libtasn1 (version 4.14, 29 March 2019), which is +a library for Abstract Syntax Notation One (ASN.1) and Distinguished Encoding Rules (DER) manipulation. - Copyright (C) 2001-2015 Free Software Foundation, Inc. + Copyright (C) 2001-2019 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, @@ -433,10 +433,10 @@ asn1_parser2tree *Returns:* 'ASN1_SUCCESS' if the file has a correct syntax and every identifier is known, 'ASN1_ELEMENT_NOT_EMPTY' if 'definitions' not 'NULL' , 'ASN1_FILE_NOT_FOUND' if an error - occured while opening 'file' , 'ASN1_SYNTAX_ERROR' if the syntax is - not correct, 'ASN1_IDENTIFIER_NOT_FOUND' if in the file there is an - identifier that is not defined, 'ASN1_NAME_TOO_LONG' if in the file - there is an identifier whith more than 'ASN1_MAX_NAME_SIZE' + occurred while opening 'file' , 'ASN1_SYNTAX_ERROR' if the syntax + is not correct, 'ASN1_IDENTIFIER_NOT_FOUND' if in the file there is + an identifier that is not defined, 'ASN1_NAME_TOO_LONG' if in the + file there is an identifier whith more than 'ASN1_MAX_NAME_SIZE' characters. asn1_parser2array @@ -465,7 +465,7 @@ asn1_parser2array *Returns:* 'ASN1_SUCCESS' if the file has a correct syntax and every identifier is known, 'ASN1_FILE_NOT_FOUND' if an error - occured while opening 'inputFileName' , 'ASN1_SYNTAX_ERROR' if the + occurred while opening 'inputFileName' , 'ASN1_SYNTAX_ERROR' if the syntax is not correct, 'ASN1_IDENTIFIER_NOT_FOUND' if in the file there is an identifier that is not defined, 'ASN1_NAME_TOO_LONG' if in the file there is an identifier whith more than @@ -824,7 +824,9 @@ asn1_read_value 'ASN1_VALUE_NOT_FOUND' if there isn't any value for the element selected, and 'ASN1_MEM_ERROR' if The value vector isn't big enough to store the result, and in this case 'len' will contain the number - of bytes needed. + of bytes needed. On the occasion that the stored data are of + zero-length this function may return 'ASN1_SUCCESS' even if the + provided 'len' is zero. asn1_read_value_type -------------------- @@ -898,7 +900,9 @@ asn1_read_value_type 'ASN1_VALUE_NOT_FOUND' if there isn't any value for the element selected, and 'ASN1_MEM_ERROR' if The value vector isn't big enough to store the result, and in this case 'len' will contain the number - of bytes needed. + of bytes needed. On the occasion that the stored data are of + zero-length this function may return 'ASN1_SUCCESS' even if the + provided 'len' is zero. asn1_read_tag ------------- @@ -1092,7 +1096,7 @@ asn1_get_tag_der LEN: Output variable containing the length of the DER TAG data. - TAG: Output variable containing the decoded tag. + TAG: Output variable containing the decoded tag (may be 'NULL' ). Decode the class and TAG from DER code. @@ -1159,7 +1163,8 @@ asn1_get_object_id_der STR_SIZE: Length of pre-allocated output buffer. - Converts a DER encoded object identifier to its textual form. + Converts a DER encoded object identifier to its textual form. This + function expects the DER object identifier without the tag. *Returns:* 'ASN1_SUCCESS' on success, or an error. @@ -1461,7 +1466,7 @@ asn1_find_node NAME: null terminated string with the element's name to find. Searches for an element called 'name' starting from 'pointer' . - The name is composed by differents identifiers separated by dots. + The name is composed by different identifiers separated by dots. When * 'pointer' has a name, the first identifier must be the name of * 'pointer' , otherwise it must be the name of one child of * 'pointer' . @@ -2017,8 +2022,8 @@ Function and Data Index (line 144) * asn1_create_element: ASN.1 field functions. (line 72) -* asn1_decode_simple_ber: DER functions. (line 456) -* asn1_decode_simple_der: DER functions. (line 435) +* asn1_decode_simple_ber: DER functions. (line 457) +* asn1_decode_simple_der: DER functions. (line 436) * asn1_delete_element: ASN.1 field functions. (line 57) * asn1_delete_structure: ASN.1 field functions. @@ -2026,20 +2031,20 @@ Function and Data Index * asn1_delete_structure2: ASN.1 field functions. (line 42) * asn1_der_coding: DER functions. (line 102) -* asn1_der_decoding: DER functions. (line 289) -* asn1_der_decoding2: DER functions. (line 253) -* asn1_der_decoding_element: DER functions. (line 316) -* asn1_der_decoding_startEnd: DER functions. (line 349) +* asn1_der_decoding: DER functions. (line 290) +* asn1_der_decoding2: DER functions. (line 254) +* asn1_der_decoding_element: DER functions. (line 317) +* asn1_der_decoding_startEnd: DER functions. (line 350) * asn1_dup_node: ASN.1 field functions. (line 162) * asn1_encode_simple_der: DER functions. (line 51) -* asn1_expand_any_defined_by: DER functions. (line 389) -* asn1_expand_octet_string: DER functions. (line 409) +* asn1_expand_any_defined_by: DER functions. (line 390) +* asn1_expand_octet_string: DER functions. (line 410) * asn1_find_node: Auxilliary functions. (line 9) * asn1_find_structure_from_oid: ASN.1 field functions. (line 129) -* asn1_get_bit_der: DER functions. (line 231) +* asn1_get_bit_der: DER functions. (line 232) * asn1_get_length_ber: DER functions. (line 166) * asn1_get_length_der: DER functions. (line 130) * asn1_get_object_id_der: DER functions. (line 212) @@ -2058,13 +2063,13 @@ Function and Data Index * asn1_print_structure: ASN.1 field functions. (line 93) * asn1_read_node_value: ASN.1 field functions. - (line 453) + (line 457) * asn1_read_tag: ASN.1 field functions. - (line 432) + (line 436) * asn1_read_value: ASN.1 field functions. (line 286) * asn1_read_value_type: ASN.1 field functions. - (line 358) + (line 360) * asn1_strerror: Error handling functions. (line 21) * asn1_write_value: ASN.1 field functions. @@ -2073,67 +2078,67 @@ Function and Data Index Tag Table: -Node: Top862 -Node: Introduction1853 -Node: ASN.1 structure handling3222 -Node: ASN.1 syntax3481 -Node: Naming5069 -Node: Simple parsing6050 -Node: Library Notes6377 -Node: Future developments7159 -Node: Utilities7458 -Node: Invoking asn1Parser7678 -Node: Invoking asn1Coding8140 -Node: Invoking asn1Decoding9877 -Node: Function reference10632 -Node: ASN.1 schema functions10916 -Ref: asn1_parser2tree11115 -Ref: asn1_parser2array12166 -Node: ASN.1 field functions13484 -Ref: asn1_array2tree13701 -Ref: asn1_delete_structure14553 -Ref: asn1_delete_structure214927 -Ref: asn1_delete_element15382 -Ref: asn1_create_element15854 -Ref: asn1_print_structure16508 -Ref: asn1_number_of_elements17137 -Ref: asn1_find_structure_from_oid17732 -Ref: asn1_copy_node18210 -Ref: asn1_dup_node18696 -Ref: asn1_write_value19056 -Ref: asn1_read_value23090 -Ref: asn1_read_value_type25880 -Ref: asn1_read_tag28745 -Ref: asn1_read_node_value29452 -Node: DER functions29798 -Ref: asn1_length_der30001 -Ref: asn1_octet_der30587 -Ref: asn1_encode_simple_der31395 -Ref: asn1_bit_der32225 -Ref: asn1_der_coding33016 -Ref: asn1_get_length_der34039 -Ref: asn1_get_tag_der34579 -Ref: asn1_get_length_ber35124 -Ref: asn1_get_octet_der35717 -Ref: asn1_get_object_id_der36576 -Ref: asn1_get_bit_der37174 -Ref: asn1_der_decoding237847 -Ref: asn1_der_decoding39245 -Ref: asn1_der_decoding_element40184 -Ref: asn1_der_decoding_startEnd41491 -Ref: asn1_expand_any_defined_by42943 -Ref: asn1_expand_octet_string43748 -Ref: asn1_decode_simple_der44749 -Ref: asn1_decode_simple_ber45391 -Node: Error handling functions46092 -Ref: asn1_perror46308 -Ref: asn1_strerror46649 -Node: Auxilliary functions47060 -Ref: asn1_find_node47252 -Ref: asn1_check_version47848 -Node: Copying Information48447 -Node: GNU Free Documentation License48700 -Node: Concept Index73815 -Node: Function and Data Index74921 +Node: Top863 +Node: Introduction1855 +Node: ASN.1 structure handling3224 +Node: ASN.1 syntax3483 +Node: Naming5071 +Node: Simple parsing6052 +Node: Library Notes6379 +Node: Future developments7161 +Node: Utilities7460 +Node: Invoking asn1Parser7680 +Node: Invoking asn1Coding8142 +Node: Invoking asn1Decoding9879 +Node: Function reference10634 +Node: ASN.1 schema functions10918 +Ref: asn1_parser2tree11117 +Ref: asn1_parser2array12169 +Node: ASN.1 field functions13488 +Ref: asn1_array2tree13705 +Ref: asn1_delete_structure14557 +Ref: asn1_delete_structure214931 +Ref: asn1_delete_element15386 +Ref: asn1_create_element15858 +Ref: asn1_print_structure16512 +Ref: asn1_number_of_elements17141 +Ref: asn1_find_structure_from_oid17736 +Ref: asn1_copy_node18214 +Ref: asn1_dup_node18700 +Ref: asn1_write_value19060 +Ref: asn1_read_value23094 +Ref: asn1_read_value_type26027 +Ref: asn1_read_tag29035 +Ref: asn1_read_node_value29742 +Node: DER functions30088 +Ref: asn1_length_der30291 +Ref: asn1_octet_der30877 +Ref: asn1_encode_simple_der31685 +Ref: asn1_bit_der32515 +Ref: asn1_der_coding33306 +Ref: asn1_get_length_der34329 +Ref: asn1_get_tag_der34869 +Ref: asn1_get_length_ber35431 +Ref: asn1_get_octet_der36024 +Ref: asn1_get_object_id_der36883 +Ref: asn1_get_bit_der37552 +Ref: asn1_der_decoding238225 +Ref: asn1_der_decoding39623 +Ref: asn1_der_decoding_element40562 +Ref: asn1_der_decoding_startEnd41869 +Ref: asn1_expand_any_defined_by43321 +Ref: asn1_expand_octet_string44126 +Ref: asn1_decode_simple_der45127 +Ref: asn1_decode_simple_ber45769 +Node: Error handling functions46470 +Ref: asn1_perror46686 +Ref: asn1_strerror47027 +Node: Auxilliary functions47438 +Ref: asn1_find_node47630 +Ref: asn1_check_version48225 +Node: Copying Information48824 +Node: GNU Free Documentation License49077 +Node: Concept Index74192 +Node: Function and Data Index75298 End Tag Table |