X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=doc%2Fcrypto%2FASN1_generate_nconf.pod;h=724ccfe04030b51d6a0057f875d5d4462b94d4ac;hb=64cee65ebc4a5a23d9f6d6f73cb25e78a80af5c2;hp=c9af7e49b7864e4567dd2ca9a30394681fb0c1c1;hpb=137e7e3aa1e83af7c5194542e23aba38b3106548;p=oweals%2Fopenssl.git diff --git a/doc/crypto/ASN1_generate_nconf.pod b/doc/crypto/ASN1_generate_nconf.pod index c9af7e49b7..724ccfe040 100644 --- a/doc/crypto/ASN1_generate_nconf.pod +++ b/doc/crypto/ASN1_generate_nconf.pod @@ -6,6 +6,8 @@ ASN1_generate_nconf, ASN1_generate_v3 - ASN1 generation functions =head1 SYNOPSIS + #include + ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf); ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf); @@ -32,7 +34,7 @@ is: That is zero or more comma separated modifiers followed by a type followed by an optional colon and a value. The formats of B, -B and B is explained below. +B and B are explained below. =head2 SUPPORTED TYPES @@ -45,7 +47,7 @@ only the B format is permissible. This encodes a boolean type. The B string is mandatory and should be B or B. Additionally B, B, B, -B, B, B, B B, B, B, B and B +B, B, B, B, B, B, B, B and B are acceptable. =item B @@ -74,9 +76,9 @@ a short name, a long name or numerical format. Encodes an ASN1 B structure, the value should be in the format B. -=item B, B +=item B, B -Encodes an ASN1 B structure, the value should be in +Encodes an ASN1 B structure, the value should be in the format B. =item B, B @@ -97,7 +99,8 @@ bits is set to zero. =item B, B, B, B, B, B, B, B, B, B, B, B, B, -B, B +B, B, B, B, +B These encode the corresponding string types. B represents the contents of this structure. The format can be B or B. @@ -106,10 +109,11 @@ contents of this structure. The format can be B or B. Formats the result as an ASN1 B or B type. B should be a section name which will contain the contents. The -field names are ignored and the values are in the generated -string format. If B is absent the the content will be empty. +field names in the section are ignored and the values are in the +generated string format. If B is absent then an empty SEQUENCE +will be encoded. -=cut +=back =head2 MODIFIERS @@ -135,10 +139,10 @@ the default is CONTEXT SPECIFIC. This is the same as B except IMPLICIT tagging is used instead. -=item B, B, B +=item B, B, B, B -The following structure is surrounded by an OCTET STRING, a SEQUENCE -or a BIT STRING respectively. For a BIT STRING the number of unused +The following structure is surrounded by an OCTET STRING, a SEQUENCE, +a SET or a BIT STRING respectively. For a BIT STRING the number of unused bits is set to zero. =item B @@ -151,7 +155,7 @@ then the value string must be a valid B string. For B the output must be a set of hex digits. B (which is only valid for a BIT STRING) is a comma separated list of set bits. -=cut +=back =head1 EXAMPLES