]>
Commit | Line | Data |
---|---|---|
12ce9ea2 RS |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
5 | DECLARE_ASN1_FUNCTIONS, | |
6 | IMPLEMENT_ASN1_FUNCTIONS, | |
7 | ASN1_ITEM, | |
8 | ACCESS_DESCRIPTION_free, | |
9 | ACCESS_DESCRIPTION_new, | |
fa743582 RS |
10 | ADMISSIONS_free, |
11 | ADMISSIONS_new, | |
12 | ADMISSION_SYNTAX_free, | |
13 | ADMISSION_SYNTAX_new, | |
12ce9ea2 RS |
14 | ASIdOrRange_free, |
15 | ASIdOrRange_new, | |
16 | ASIdentifierChoice_free, | |
17 | ASIdentifierChoice_new, | |
18 | ASIdentifiers_free, | |
19 | ASIdentifiers_new, | |
20 | ASRange_free, | |
21 | ASRange_new, | |
22 | AUTHORITY_INFO_ACCESS_free, | |
23 | AUTHORITY_INFO_ACCESS_new, | |
24 | AUTHORITY_KEYID_free, | |
25 | AUTHORITY_KEYID_new, | |
26 | BASIC_CONSTRAINTS_free, | |
27 | BASIC_CONSTRAINTS_new, | |
28 | CERTIFICATEPOLICIES_free, | |
29 | CERTIFICATEPOLICIES_new, | |
30 | CMS_ContentInfo_free, | |
31 | CMS_ContentInfo_new, | |
32 | CMS_ContentInfo_print_ctx, | |
33 | CMS_ReceiptRequest_free, | |
34 | CMS_ReceiptRequest_new, | |
35 | CRL_DIST_POINTS_free, | |
36 | CRL_DIST_POINTS_new, | |
37 | DIRECTORYSTRING_free, | |
38 | DIRECTORYSTRING_new, | |
39 | DISPLAYTEXT_free, | |
40 | DISPLAYTEXT_new, | |
41 | DIST_POINT_NAME_free, | |
42 | DIST_POINT_NAME_new, | |
43 | DIST_POINT_free, | |
44 | DIST_POINT_new, | |
45 | DSAparams_dup, | |
9ba6f347 KY |
46 | ECPARAMETERS_free, |
47 | ECPARAMETERS_new, | |
48 | ECPKPARAMETERS_free, | |
49 | ECPKPARAMETERS_new, | |
12ce9ea2 RS |
50 | EDIPARTYNAME_free, |
51 | EDIPARTYNAME_new, | |
52 | ESS_CERT_ID_dup, | |
53 | ESS_CERT_ID_free, | |
54 | ESS_CERT_ID_new, | |
55 | ESS_ISSUER_SERIAL_dup, | |
56 | ESS_ISSUER_SERIAL_free, | |
57 | ESS_ISSUER_SERIAL_new, | |
58 | ESS_SIGNING_CERT_dup, | |
59 | ESS_SIGNING_CERT_free, | |
60 | ESS_SIGNING_CERT_new, | |
61 | EXTENDED_KEY_USAGE_free, | |
62 | EXTENDED_KEY_USAGE_new, | |
63 | GENERAL_NAMES_free, | |
64 | GENERAL_NAMES_new, | |
65 | GENERAL_NAME_dup, | |
66 | GENERAL_NAME_free, | |
67 | GENERAL_NAME_new, | |
68 | GENERAL_SUBTREE_free, | |
69 | GENERAL_SUBTREE_new, | |
70 | IPAddressChoice_free, | |
71 | IPAddressChoice_new, | |
72 | IPAddressFamily_free, | |
73 | IPAddressFamily_new, | |
74 | IPAddressOrRange_free, | |
75 | IPAddressOrRange_new, | |
76 | IPAddressRange_free, | |
77 | IPAddressRange_new, | |
78 | ISSUING_DIST_POINT_free, | |
79 | ISSUING_DIST_POINT_new, | |
80 | NAME_CONSTRAINTS_free, | |
81 | NAME_CONSTRAINTS_new, | |
fa743582 RS |
82 | NAMING_AUTHORITY_free, |
83 | NAMING_AUTHORITY_new, | |
12ce9ea2 RS |
84 | NETSCAPE_CERT_SEQUENCE_free, |
85 | NETSCAPE_CERT_SEQUENCE_new, | |
86 | NETSCAPE_SPKAC_free, | |
87 | NETSCAPE_SPKAC_new, | |
88 | NETSCAPE_SPKI_free, | |
89 | NETSCAPE_SPKI_new, | |
90 | NOTICEREF_free, | |
91 | NOTICEREF_new, | |
92 | OCSP_BASICRESP_free, | |
93 | OCSP_BASICRESP_new, | |
94 | OCSP_CERTID_dup, | |
95 | OCSP_CERTID_new, | |
96 | OCSP_CERTSTATUS_free, | |
97 | OCSP_CERTSTATUS_new, | |
98 | OCSP_CRLID_free, | |
99 | OCSP_CRLID_new, | |
100 | OCSP_ONEREQ_free, | |
101 | OCSP_ONEREQ_new, | |
102 | OCSP_REQINFO_free, | |
103 | OCSP_REQINFO_new, | |
104 | OCSP_RESPBYTES_free, | |
105 | OCSP_RESPBYTES_new, | |
106 | OCSP_RESPDATA_free, | |
107 | OCSP_RESPDATA_new, | |
108 | OCSP_RESPID_free, | |
109 | OCSP_RESPID_new, | |
110 | OCSP_RESPONSE_new, | |
111 | OCSP_REVOKEDINFO_free, | |
112 | OCSP_REVOKEDINFO_new, | |
113 | OCSP_SERVICELOC_free, | |
114 | OCSP_SERVICELOC_new, | |
115 | OCSP_SIGNATURE_free, | |
116 | OCSP_SIGNATURE_new, | |
117 | OCSP_SINGLERESP_free, | |
118 | OCSP_SINGLERESP_new, | |
119 | OTHERNAME_free, | |
120 | OTHERNAME_new, | |
121 | PBE2PARAM_free, | |
122 | PBE2PARAM_new, | |
123 | PBEPARAM_free, | |
124 | PBEPARAM_new, | |
125 | PBKDF2PARAM_free, | |
126 | PBKDF2PARAM_new, | |
127 | PKCS12_BAGS_free, | |
128 | PKCS12_BAGS_new, | |
129 | PKCS12_MAC_DATA_free, | |
130 | PKCS12_MAC_DATA_new, | |
131 | PKCS12_SAFEBAG_free, | |
132 | PKCS12_SAFEBAG_new, | |
133 | PKCS12_free, | |
134 | PKCS12_new, | |
135 | PKCS7_DIGEST_free, | |
136 | PKCS7_DIGEST_new, | |
137 | PKCS7_ENCRYPT_free, | |
138 | PKCS7_ENCRYPT_new, | |
139 | PKCS7_ENC_CONTENT_free, | |
140 | PKCS7_ENC_CONTENT_new, | |
141 | PKCS7_ENVELOPE_free, | |
142 | PKCS7_ENVELOPE_new, | |
143 | PKCS7_ISSUER_AND_SERIAL_free, | |
144 | PKCS7_ISSUER_AND_SERIAL_new, | |
145 | PKCS7_RECIP_INFO_free, | |
146 | PKCS7_RECIP_INFO_new, | |
147 | PKCS7_SIGNED_free, | |
148 | PKCS7_SIGNED_new, | |
149 | PKCS7_SIGNER_INFO_free, | |
150 | PKCS7_SIGNER_INFO_new, | |
151 | PKCS7_SIGN_ENVELOPE_free, | |
152 | PKCS7_SIGN_ENVELOPE_new, | |
153 | PKCS7_dup, | |
154 | PKCS7_free, | |
155 | PKCS7_new, | |
156 | PKCS7_print_ctx, | |
157 | PKCS8_PRIV_KEY_INFO_free, | |
158 | PKCS8_PRIV_KEY_INFO_new, | |
159 | PKEY_USAGE_PERIOD_free, | |
160 | PKEY_USAGE_PERIOD_new, | |
161 | POLICYINFO_free, | |
162 | POLICYINFO_new, | |
163 | POLICYQUALINFO_free, | |
164 | POLICYQUALINFO_new, | |
165 | POLICY_CONSTRAINTS_free, | |
166 | POLICY_CONSTRAINTS_new, | |
167 | POLICY_MAPPING_free, | |
168 | POLICY_MAPPING_new, | |
fa743582 RS |
169 | PROFESSION_INFO_free, |
170 | PROFESSION_INFO_new, | |
171 | PROFESSION_INFOS_free, | |
172 | PROFESSION_INFOS_new, | |
12ce9ea2 RS |
173 | PROXY_CERT_INFO_EXTENSION_free, |
174 | PROXY_CERT_INFO_EXTENSION_new, | |
175 | PROXY_POLICY_free, | |
176 | PROXY_POLICY_new, | |
177 | RSAPrivateKey_dup, | |
178 | RSAPublicKey_dup, | |
179 | RSA_OAEP_PARAMS_free, | |
180 | RSA_OAEP_PARAMS_new, | |
181 | RSA_PSS_PARAMS_free, | |
182 | RSA_PSS_PARAMS_new, | |
00606b06 HK |
183 | SCRYPT_PARAMS_free, |
184 | SCRYPT_PARAMS_new, | |
12ce9ea2 RS |
185 | SXNETID_free, |
186 | SXNETID_new, | |
187 | SXNET_free, | |
188 | SXNET_new, | |
189 | TLS_FEATURE_free, | |
190 | TLS_FEATURE_new, | |
191 | TS_ACCURACY_dup, | |
192 | TS_ACCURACY_free, | |
193 | TS_ACCURACY_new, | |
194 | TS_MSG_IMPRINT_dup, | |
195 | TS_MSG_IMPRINT_free, | |
196 | TS_MSG_IMPRINT_new, | |
197 | TS_REQ_dup, | |
198 | TS_REQ_free, | |
199 | TS_REQ_new, | |
200 | TS_RESP_dup, | |
201 | TS_RESP_free, | |
202 | TS_RESP_new, | |
203 | TS_STATUS_INFO_dup, | |
204 | TS_STATUS_INFO_free, | |
205 | TS_STATUS_INFO_new, | |
206 | TS_TST_INFO_dup, | |
207 | TS_TST_INFO_free, | |
208 | TS_TST_INFO_new, | |
209 | USERNOTICE_free, | |
210 | USERNOTICE_new, | |
211 | X509_ALGOR_free, | |
212 | X509_ALGOR_new, | |
213 | X509_ATTRIBUTE_dup, | |
214 | X509_ATTRIBUTE_free, | |
215 | X509_ATTRIBUTE_new, | |
216 | X509_CERT_AUX_free, | |
217 | X509_CERT_AUX_new, | |
218 | X509_CINF_free, | |
219 | X509_CINF_new, | |
220 | X509_CRL_INFO_free, | |
221 | X509_CRL_INFO_new, | |
12ce9ea2 RS |
222 | X509_CRL_dup, |
223 | X509_CRL_free, | |
224 | X509_CRL_new, | |
225 | X509_EXTENSION_dup, | |
226 | X509_EXTENSION_free, | |
227 | X509_EXTENSION_new, | |
228 | X509_NAME_ENTRY_dup, | |
229 | X509_NAME_ENTRY_free, | |
230 | X509_NAME_ENTRY_new, | |
231 | X509_NAME_dup, | |
232 | X509_NAME_free, | |
233 | X509_NAME_new, | |
234 | X509_REQ_INFO_free, | |
235 | X509_REQ_INFO_new, | |
236 | X509_REQ_dup, | |
237 | X509_REQ_free, | |
238 | X509_REQ_new, | |
239 | X509_REVOKED_dup, | |
240 | X509_REVOKED_free, | |
241 | X509_REVOKED_new, | |
242 | X509_SIG_free, | |
243 | X509_SIG_new, | |
244 | X509_VAL_free, | |
245 | X509_VAL_new, | |
246 | X509_dup, | |
247 | - ASN1 object utilities | |
248 | ||
249 | =head1 SYNOPSIS | |
250 | ||
b97fdb57 RL |
251 | =for comment generic |
252 | ||
12ce9ea2 RS |
253 | #include <openssl/asn1t.h> |
254 | ||
91da5e77 RS |
255 | DECLARE_ASN1_FUNCTIONS(type) |
256 | IMPLEMENT_ASN1_FUNCTIONS(stname) | |
12ce9ea2 RS |
257 | |
258 | typedef struct ASN1_ITEM_st ASN1_ITEM; | |
259 | ||
260 | extern const ASN1_ITEM TYPE_it; | |
261 | TYPE *TYPE_new(void); | |
9fdcc21f | 262 | TYPE *TYPE_dup(const TYPE *a); |
12ce9ea2 RS |
263 | void TYPE_free(TYPE *a); |
264 | int TYPE_print_ctx(BIO *out, TYPE *a, int indent, const ASN1_PCTX *pctx); | |
265 | ||
12ce9ea2 RS |
266 | =head1 DESCRIPTION |
267 | ||
268 | In the description below, I<TYPE> is used | |
269 | as a placeholder for any of the OpenSSL datatypes, such as I<X509>. | |
270 | ||
271 | The OpenSSL ASN1 parsing library templates are like a data-driven bytecode | |
272 | interpreter. | |
273 | Every ASN1 object as a global variable, TYPE_it, that describes the item | |
274 | such as its fields. (On systems which cannot export variables from shared | |
275 | libraries, the global is instead a function which returns a pointer to a | |
276 | static variable. | |
277 | ||
278 | The macro DECLARE_ASN1_FUNCTIONS() is typically used in header files | |
279 | to generate the function declarations. | |
280 | ||
281 | The macro IMPLEMENT_ASN1_FUNCTIONS() is used once in a source file | |
282 | to generate the function bodies. | |
283 | ||
284 | ||
285 | TYPE_new() allocates an empty object of the indicated type. | |
286 | The object returned must be released by calling TYPE_free(). | |
287 | ||
9fdcc21f | 288 | TYPE_dup() copies an existing object, leaving it untouched. |
12ce9ea2 RS |
289 | |
290 | TYPE_free() releases the object and all pointers and sub-objects | |
291 | within it. | |
292 | ||
293 | TYPE_print_ctx() prints the object B<a> on the specified BIO B<out>. | |
294 | Each line will be prefixed with B<indent> spaces. | |
295 | The B<pctx> specifies the printing context and is for internal | |
296 | use; use NULL to get the default behavior. If a print function is | |
297 | user-defined, then pass in any B<pctx> down to any nested calls. | |
298 | ||
299 | =head1 RETURN VALUES | |
300 | ||
301 | TYPE_new() and TYPE_dup() return a pointer to the object or NULL on failure. | |
302 | ||
303 | TYPE_print_ctx() returns 1 on success or zero on failure. | |
304 | ||
305 | =head1 COPYRIGHT | |
306 | ||
6738bf14 | 307 | Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. |
12ce9ea2 | 308 | |
4746f25a | 309 | Licensed under the Apache License 2.0 (the "License"). You may not use |
12ce9ea2 RS |
310 | this file except in compliance with the License. You can obtain a copy |
311 | in the file LICENSE in the source distribution or at | |
312 | L<https://www.openssl.org/source/license.html>. | |
313 | ||
314 | =cut |