Debian Codegraph @

upstream/debian-unstable/man3/X509_dup.3ssl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "X509_DUP 3SSL"
58 .TH X509_DUP 3SSL 2026-04-07 3.6.2 OpenSSL
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 DECLARE_ASN1_FUNCTIONS,
65 IMPLEMENT_ASN1_FUNCTIONS,
66 ASN1_ITEM,
67 ACCESS_DESCRIPTION_free,
68 ACCESS_DESCRIPTION_new,
69 ADMISSIONS_free,
70 ADMISSIONS_new,
71 ADMISSION_SYNTAX_free,
72 ADMISSION_SYNTAX_new,
73 ASIdOrRange_free,
74 ASIdOrRange_new,
75 ASIdentifierChoice_free,
76 ASIdentifierChoice_new,
77 ASIdentifiers_free,
78 ASIdentifiers_new,
79 ASRange_free,
80 ASRange_new,
81 AUTHORITY_INFO_ACCESS_free,
82 AUTHORITY_INFO_ACCESS_new,
83 AUTHORITY_KEYID_free,
84 AUTHORITY_KEYID_new,
85 BASIC_CONSTRAINTS_free,
86 BASIC_CONSTRAINTS_new,
87 CERTIFICATEPOLICIES_free,
88 CERTIFICATEPOLICIES_new,
89 CMS_ContentInfo_free,
90 CMS_ContentInfo_new,
91 CMS_ContentInfo_new_ex,
92 CMS_ContentInfo_print_ctx,
93 CMS_EnvelopedData_it,
94 CMS_EnvelopedData_dup,
95 CMS_ReceiptRequest_free,
96 CMS_ReceiptRequest_new,
97 CMS_SignedData_free,
98 CMS_SignedData_new,
99 CRL_DIST_POINTS_free,
100 CRL_DIST_POINTS_new,
101 DIRECTORYSTRING_free,
102 DIRECTORYSTRING_new,
103 DISPLAYTEXT_free,
104 DISPLAYTEXT_new,
105 DIST_POINT_NAME_free,
106 DIST_POINT_NAME_new,
107 DIST_POINT_NAME_dup,
108 DIST_POINT_free,
109 DIST_POINT_new,
110 DSAparams_dup,
111 ECPARAMETERS_free,
112 ECPARAMETERS_new,
113 ECPKPARAMETERS_free,
114 ECPKPARAMETERS_new,
115 EDIPARTYNAME_free,
116 EDIPARTYNAME_new,
117 ESS_CERT_ID_dup,
118 ESS_CERT_ID_free,
119 ESS_CERT_ID_new,
120 ESS_CERT_ID_V2_dup,
121 ESS_CERT_ID_V2_free,
122 ESS_CERT_ID_V2_new,
123 ESS_ISSUER_SERIAL_dup,
124 ESS_ISSUER_SERIAL_free,
125 ESS_ISSUER_SERIAL_new,
126 ESS_SIGNING_CERT_dup,
127 ESS_SIGNING_CERT_free,
128 ESS_SIGNING_CERT_it,
129 ESS_SIGNING_CERT_new,
130 ESS_SIGNING_CERT_V2_dup,
131 ESS_SIGNING_CERT_V2_free,
132 ESS_SIGNING_CERT_V2_it,
133 ESS_SIGNING_CERT_V2_new,
134 EXTENDED_KEY_USAGE_free,
135 EXTENDED_KEY_USAGE_new,
136 GENERAL_NAMES_free,
137 GENERAL_NAMES_new,
138 GENERAL_NAME_dup,
139 GENERAL_NAME_free,
140 GENERAL_NAME_new,
141 GENERAL_SUBTREE_free,
142 GENERAL_SUBTREE_new,
143 OSSL_IETF_ATTR_SYNTAX_free,
144 OSSL_IETF_ATTR_SYNTAX_it,
145 OSSL_IETF_ATTR_SYNTAX_new,
146 IPAddressChoice_free,
147 IPAddressChoice_new,
148 IPAddressFamily_free,
149 IPAddressFamily_new,
150 IPAddressOrRange_free,
151 IPAddressOrRange_new,
152 IPAddressRange_free,
153 IPAddressRange_new,
154 ISSUER_SIGN_TOOL_free,
155 ISSUER_SIGN_TOOL_it,
156 ISSUER_SIGN_TOOL_new,
157 ISSUING_DIST_POINT_free,
158 ISSUING_DIST_POINT_it,
159 ISSUING_DIST_POINT_new,
160 NAME_CONSTRAINTS_free,
161 NAME_CONSTRAINTS_new,
162 NAMING_AUTHORITY_free,
163 NAMING_AUTHORITY_new,
164 NETSCAPE_CERT_SEQUENCE_free,
165 NETSCAPE_CERT_SEQUENCE_new,
166 NETSCAPE_SPKAC_free,
167 NETSCAPE_SPKAC_new,
168 NETSCAPE_SPKI_free,
169 NETSCAPE_SPKI_new,
170 NOTICEREF_free,
171 NOTICEREF_new,
172 OCSP_BASICRESP_free,
173 OCSP_BASICRESP_new,
174 OCSP_CERTID_dup,
175 OCSP_CERTID_new,
176 OCSP_CERTSTATUS_free,
177 OCSP_CERTSTATUS_new,
178 OCSP_CRLID_free,
179 OCSP_CRLID_new,
180 OCSP_ONEREQ_free,
181 OCSP_ONEREQ_new,
182 OCSP_REQINFO_free,
183 OCSP_REQINFO_new,
184 OCSP_RESPBYTES_free,
185 OCSP_RESPBYTES_new,
186 OCSP_RESPDATA_free,
187 OCSP_RESPDATA_new,
188 OCSP_RESPID_free,
189 OCSP_RESPID_new,
190 OCSP_RESPONSE_new,
191 OCSP_REVOKEDINFO_free,
192 OCSP_REVOKEDINFO_new,
193 OCSP_SERVICELOC_free,
194 OCSP_SERVICELOC_new,
195 OCSP_SIGNATURE_free,
196 OCSP_SIGNATURE_new,
197 OCSP_SINGLERESP_free,
198 OCSP_SINGLERESP_new,
199 OSSL_AA_DIST_POINT_free,
200 OSSL_AA_DIST_POINT_new,
201 OSSL_AA_DIST_POINT_it,
202 OSSL_ALLOWED_ATTRIBUTES_CHOICE_free,
203 OSSL_ALLOWED_ATTRIBUTES_CHOICE_new,
204 OSSL_ALLOWED_ATTRIBUTES_CHOICE_it,
205 OSSL_ALLOWED_ATTRIBUTES_ITEM_free,
206 OSSL_ALLOWED_ATTRIBUTES_ITEM_new,
207 OSSL_ALLOWED_ATTRIBUTES_ITEM_it,
208 OSSL_ALLOWED_ATTRIBUTES_SYNTAX_free,
209 OSSL_ALLOWED_ATTRIBUTES_SYNTAX_new,
210 OSSL_ALLOWED_ATTRIBUTES_SYNTAX_it,
211 OSSL_ATAV_free,
212 OSSL_ATAV_new,
213 OSSL_ATAV_it,
214 OSSL_ATTRIBUTE_DESCRIPTOR_free,
215 OSSL_ATTRIBUTE_DESCRIPTOR_new,
216 OSSL_ATTRIBUTE_DESCRIPTOR_it,
217 OSSL_ATTRIBUTE_MAPPING_free,
218 OSSL_ATTRIBUTE_MAPPING_new,
219 OSSL_ATTRIBUTE_MAPPING_it,
220 OSSL_ATTRIBUTE_MAPPINGS_free,
221 OSSL_ATTRIBUTE_MAPPINGS_new,
222 OSSL_ATTRIBUTE_MAPPINGS_it,
223 OSSL_ATTRIBUTE_TYPE_MAPPING_free,
224 OSSL_ATTRIBUTE_TYPE_MAPPING_new,
225 OSSL_ATTRIBUTE_TYPE_MAPPING_it,
226 OSSL_ATTRIBUTE_VALUE_MAPPING_free,
227 OSSL_ATTRIBUTE_VALUE_MAPPING_new,
228 OSSL_ATTRIBUTE_VALUE_MAPPING_it,
229 OSSL_ATTRIBUTES_SYNTAX_free,
230 OSSL_ATTRIBUTES_SYNTAX_it,
231 OSSL_ATTRIBUTES_SYNTAX_new,
232 OSSL_AUTHORITY_ATTRIBUTE_ID_SYNTAX_free,
233 OSSL_AUTHORITY_ATTRIBUTE_ID_SYNTAX_it,
234 OSSL_AUTHORITY_ATTRIBUTE_ID_SYNTAX_new,
235 OSSL_BASIC_ATTR_CONSTRAINTS_free,
236 OSSL_BASIC_ATTR_CONSTRAINTS_it,
237 OSSL_BASIC_ATTR_CONSTRAINTS_new,
238 OSSL_CMP_ATAVS_new,
239 OSSL_CMP_ATAVS_free,
240 OSSL_CMP_ATAVS_it,
241 OSSL_CMP_CRLSTATUS_free,
242 OSSL_CMP_ITAV_dup,
243 OSSL_CMP_ITAV_free,
244 OSSL_CMP_MSG_dup,
245 OSSL_CMP_MSG_it,
246 OSSL_CMP_MSG_free,
247 OSSL_CMP_PKIHEADER_free,
248 OSSL_CMP_PKIHEADER_it,
249 OSSL_CMP_PKIHEADER_new,
250 OSSL_CMP_PKISI_dup,
251 OSSL_CMP_PKISI_free,
252 OSSL_CMP_PKISI_it,
253 OSSL_CMP_PKISI_new,
254 OSSL_CMP_PKISTATUS_it,
255 OSSL_CRMF_CERTID_dup,
256 OSSL_CRMF_CERTID_free,
257 OSSL_CRMF_CERTID_it,
258 OSSL_CRMF_CERTID_new,
259 OSSL_CRMF_CERTTEMPLATE_free,
260 OSSL_CRMF_CERTTEMPLATE_it,
261 OSSL_CRMF_CERTTEMPLATE_new,
262 OSSL_CRMF_CERTTEMPLATE_dup,
263 OSSL_CRMF_ATTRIBUTETYPEANDVALUE_dup,
264 OSSL_CRMF_ATTRIBUTETYPEANDVALUE_free,
265 OSSL_CRMF_ENCRYPTEDKEY_free,
266 OSSL_CRMF_ENCRYPTEDKEY_it,
267 OSSL_CRMF_ENCRYPTEDKEY_new,
268 OSSL_CRMF_ENCRYPTEDVALUE_free,
269 OSSL_CRMF_ENCRYPTEDVALUE_it,
270 OSSL_CRMF_ENCRYPTEDVALUE_new,
271 OSSL_CRMF_MSGS_free,
272 OSSL_CRMF_MSGS_it,
273 OSSL_CRMF_MSGS_new,
274 OSSL_CRMF_MSG_dup,
275 OSSL_CRMF_MSG_free,
276 OSSL_CRMF_MSG_it,
277 OSSL_CRMF_MSG_new,
278 OSSL_CRMF_PBMPARAMETER_free,
279 OSSL_CRMF_PBMPARAMETER_it,
280 OSSL_CRMF_PBMPARAMETER_new,
281 OSSL_CRMF_PKIPUBLICATIONINFO_free,
282 OSSL_CRMF_PKIPUBLICATIONINFO_it,
283 OSSL_CRMF_PKIPUBLICATIONINFO_new,
284 OSSL_CRMF_SINGLEPUBINFO_free,
285 OSSL_CRMF_SINGLEPUBINFO_it,
286 OSSL_CRMF_SINGLEPUBINFO_new,
287 OSSL_DAY_TIME_free,
288 OSSL_DAY_TIME_new,
289 OSSL_DAY_TIME_it,
290 OSSL_DAY_TIME_BAND_free,
291 OSSL_DAY_TIME_BAND_new,
292 OSSL_DAY_TIME_BAND_it,
293 OSSL_HASH_free,
294 OSSL_HASH_it,
295 OSSL_HASH_new,
296 OSSL_INFO_SYNTAX_free,
297 OSSL_INFO_SYNTAX_it,
298 OSSL_INFO_SYNTAX_new,
299 OSSL_INFO_SYNTAX_POINTER_free,
300 OSSL_INFO_SYNTAX_POINTER_it,
301 OSSL_INFO_SYNTAX_POINTER_new,
302 OSSL_PRIVILEGE_POLICY_ID_free,
303 OSSL_PRIVILEGE_POLICY_ID_it,
304 OSSL_PRIVILEGE_POLICY_ID_new,
305 OSSL_TARGET_CERT_free,
306 OSSL_TARGET_CERT_it,
307 OSSL_TARGET_CERT_new,
308 OSSL_TARGET_free,
309 OSSL_TARGET_it,
310 OSSL_TARGET_new,
311 OSSL_TARGETING_INFORMATION_free,
312 OSSL_TARGETING_INFORMATION_it,
313 OSSL_TARGETING_INFORMATION_new,
314 OSSL_TARGETS_free,
315 OSSL_TARGETS_it,
316 OSSL_TARGETS_new,
317 OSSL_IETF_ATTR_SYNTAX_VALUE_free,
318 OSSL_IETF_ATTR_SYNTAX_VALUE_it,
319 OSSL_IETF_ATTR_SYNTAX_VALUE_new,
320 OSSL_ISSUER_SERIAL_free,
321 OSSL_ISSUER_SERIAL_new,
322 OSSL_NAMED_DAY_free,
323 OSSL_NAMED_DAY_new,
324 OSSL_NAMED_DAY_it,
325 OSSL_OBJECT_DIGEST_INFO_free,
326 OSSL_OBJECT_DIGEST_INFO_new,
327 OSSL_ROLE_SPEC_CERT_ID_free,
328 OSSL_ROLE_SPEC_CERT_ID_new,
329 OSSL_ROLE_SPEC_CERT_ID_it,
330 OSSL_ROLE_SPEC_CERT_ID_SYNTAX_free,
331 OSSL_ROLE_SPEC_CERT_ID_SYNTAX_new,
332 OSSL_ROLE_SPEC_CERT_ID_SYNTAX_it,
333 OSSL_TIME_PERIOD_free,
334 OSSL_TIME_PERIOD_new,
335 OSSL_TIME_PERIOD_it,
336 OSSL_TIME_SPEC_ABSOLUTE_free,
337 OSSL_TIME_SPEC_ABSOLUTE_new,
338 OSSL_TIME_SPEC_ABSOLUTE_it,
339 OSSL_TIME_SPEC_free,
340 OSSL_TIME_SPEC_new,
341 OSSL_TIME_SPEC_it,
342 OSSL_TIME_SPEC_DAY_free,
343 OSSL_TIME_SPEC_DAY_new,
344 OSSL_TIME_SPEC_DAY_it,
345 OSSL_TIME_SPEC_MONTH_free,
346 OSSL_TIME_SPEC_MONTH_new,
347 OSSL_TIME_SPEC_MONTH_it,
348 OSSL_TIME_SPEC_TIME_free,
349 OSSL_TIME_SPEC_TIME_new,
350 OSSL_TIME_SPEC_TIME_it,
351 OSSL_TIME_SPEC_WEEKS_free,
352 OSSL_TIME_SPEC_WEEKS_new,
353 OSSL_TIME_SPEC_WEEKS_it,
354 OSSL_TIME_SPEC_X_DAY_OF_free,
355 OSSL_TIME_SPEC_X_DAY_OF_new,
356 OSSL_TIME_SPEC_X_DAY_OF_it,
357 OSSL_USER_NOTICE_SYNTAX_free,
358 OSSL_USER_NOTICE_SYNTAX_new,
359 OSSL_USER_NOTICE_SYNTAX_it,
360 OTHERNAME_free,
361 OTHERNAME_new,
362 PBE2PARAM_free,
363 PBE2PARAM_new,
364 PBEPARAM_free,
365 PBEPARAM_new,
366 PBKDF2PARAM_free,
367 PBKDF2PARAM_new,
368 PBMAC1PARAM_free,
369 PBMAC1PARAM_it,
370 PBMAC1PARAM_new,
371 PKCS12_BAGS_free,
372 PKCS12_BAGS_new,
373 PKCS12_MAC_DATA_free,
374 PKCS12_MAC_DATA_new,
375 PKCS12_SAFEBAG_free,
376 PKCS12_SAFEBAG_new,
377 PKCS12_free,
378 PKCS12_new,
379 PKCS7_DIGEST_free,
380 PKCS7_DIGEST_new,
381 PKCS7_ENCRYPT_free,
382 PKCS7_ENCRYPT_new,
383 PKCS7_ENC_CONTENT_free,
384 PKCS7_ENC_CONTENT_new,
385 PKCS7_ENVELOPE_free,
386 PKCS7_ENVELOPE_new,
387 PKCS7_ISSUER_AND_SERIAL_free,
388 PKCS7_ISSUER_AND_SERIAL_new,
389 PKCS7_RECIP_INFO_free,
390 PKCS7_RECIP_INFO_new,
391 PKCS7_SIGNED_free,
392 PKCS7_SIGNED_new,
393 PKCS7_SIGNER_INFO_free,
394 PKCS7_SIGNER_INFO_new,
395 PKCS7_SIGN_ENVELOPE_free,
396 PKCS7_SIGN_ENVELOPE_new,
397 PKCS7_dup,
398 PKCS7_free,
399 PKCS7_new_ex,
400 PKCS7_new,
401 PKCS7_print_ctx,
402 PKCS8_PRIV_KEY_INFO_free,
403 PKCS8_PRIV_KEY_INFO_new,
404 PKEY_USAGE_PERIOD_free,
405 PKEY_USAGE_PERIOD_new,
406 POLICYINFO_free,
407 POLICYINFO_new,
408 POLICYQUALINFO_free,
409 POLICYQUALINFO_new,
410 POLICY_CONSTRAINTS_free,
411 POLICY_CONSTRAINTS_new,
412 POLICY_MAPPING_free,
413 POLICY_MAPPING_new,
414 PROFESSION_INFOS_free,
415 PROFESSION_INFOS_new,
416 PROFESSION_INFO_free,
417 PROFESSION_INFO_new,
418 PROXY_CERT_INFO_EXTENSION_free,
419 PROXY_CERT_INFO_EXTENSION_new,
420 PROXY_POLICY_free,
421 PROXY_POLICY_new,
422 RSAPrivateKey_dup,
423 RSAPublicKey_dup,
424 RSA_OAEP_PARAMS_free,
425 RSA_OAEP_PARAMS_new,
426 RSA_PSS_PARAMS_free,
427 RSA_PSS_PARAMS_new,
428 RSA_PSS_PARAMS_dup,
429 SCRYPT_PARAMS_free,
430 SCRYPT_PARAMS_new,
431 SXNETID_free,
432 SXNETID_new,
433 SXNET_free,
434 SXNET_new,
435 TLS_FEATURE_free,
436 TLS_FEATURE_new,
437 TS_ACCURACY_dup,
438 TS_ACCURACY_free,
439 TS_ACCURACY_new,
440 TS_MSG_IMPRINT_dup,
441 TS_MSG_IMPRINT_free,
442 TS_MSG_IMPRINT_new,
443 TS_REQ_dup,
444 TS_REQ_free,
445 TS_REQ_new,
446 TS_RESP_dup,
447 TS_RESP_free,
448 TS_RESP_new,
449 TS_STATUS_INFO_dup,
450 TS_STATUS_INFO_free,
451 TS_STATUS_INFO_new,
452 TS_TST_INFO_dup,
453 TS_TST_INFO_free,
454 TS_TST_INFO_new,
455 USERNOTICE_free,
456 USERNOTICE_new,
457 X509_ACERT_dup,
458 X509_ACERT_free,
459 X509_ACERT_it,
460 X509_ACERT_new,
461 X509_ACERT_INFO_free,
462 X509_ACERT_INFO_it,
463 X509_ACERT_INFO_new,
464 X509_ACERT_ISSUER_V2FORM_free,
465 X509_ACERT_ISSUER_V2FORM_new,
466 X509_ALGOR_free,
467 X509_ALGOR_it,
468 X509_ALGOR_new,
469 X509_ATTRIBUTE_dup,
470 X509_ATTRIBUTE_free,
471 X509_ATTRIBUTE_new,
472 X509_CERT_AUX_free,
473 X509_CERT_AUX_new,
474 X509_CINF_free,
475 X509_CINF_new,
476 X509_CRL_INFO_free,
477 X509_CRL_INFO_new,
478 X509_CRL_dup,
479 X509_CRL_free,
480 X509_CRL_new_ex,
481 X509_CRL_new,
482 X509_EXTENSION_dup,
483 X509_EXTENSION_free,
484 X509_EXTENSION_new,
485 X509_NAME_ENTRY_dup,
486 X509_NAME_ENTRY_free,
487 X509_NAME_ENTRY_new,
488 X509_NAME_dup,
489 X509_NAME_free,
490 X509_NAME_new,
491 X509_REQ_INFO_free,
492 X509_REQ_INFO_new,
493 X509_REQ_dup,
494 X509_REQ_free,
495 X509_REQ_new,
496 X509_REQ_new_ex,
497 X509_REVOKED_dup,
498 X509_REVOKED_free,
499 X509_REVOKED_new,
500 X509_SIG_free,
501 X509_SIG_new,
502 X509_VAL_free,
503 X509_VAL_new,
504 X509_dup,
505 \&\- ASN1 object utilities
506 .SH SYNOPSIS
507 .IX Header "SYNOPSIS"
508 .Vb 1
509 \& #include <openssl/asn1t.h>
510 \&
511 \& DECLARE_ASN1_FUNCTIONS(type)
512 \& IMPLEMENT_ASN1_FUNCTIONS(stname)
513 \&
514 \& typedef struct ASN1_ITEM_st ASN1_ITEM;
515 \&
516 \& extern const ASN1_ITEM TYPE_it;
517 \& TYPE *TYPE_new(void);
518 \& TYPE *TYPE_dup(const TYPE *a);
519 \& void TYPE_free(TYPE *a);
520 \& int TYPE_print_ctx(BIO *out, TYPE *a, int indent, const ASN1_PCTX *pctx);
521 .Ve
522 .PP
523 The following functions have been deprecated since OpenSSL 3.0, and can be
524 hidden entirely by defining \fBOPENSSL_API_COMPAT\fR with a suitable version value,
525 see \fBopenssl_user_macros\fR\|(7):
526 .PP
527 .Vb 3
528 \& DSA *DSAparams_dup(const DSA *dsa);
529 \& RSA *RSAPrivateKey_dup(const RSA *rsa);
530 \& RSA *RSAPublicKey_dup(const RSA *rsa);
531 .Ve
532 .SH DESCRIPTION
533 .IX Header "DESCRIPTION"
534 In the description below, \fR\f(BITYPE\fR\fB\fR is used
535 as a placeholder for any of the OpenSSL datatypes, such as \fBX509\fR.
536 .PP
537 The OpenSSL ASN1 parsing library templates are like a data-driven bytecode
538 interpreter.
539 Every ASN1 object as a global variable, TYPE_it, that describes the item
540 such as its fields. (On systems which cannot export variables from shared
541 libraries, the global is instead a function which returns a pointer to a
542 static variable.
543 .PP
544 The macro \fBDECLARE_ASN1_FUNCTIONS()\fR is typically used in header files
545 to generate the function declarations.
546 .PP
547 The macro \fBIMPLEMENT_ASN1_FUNCTIONS()\fR is used once in a source file
548 to generate the function bodies.
549 .PP
550 \&\fR\f(BITYPE\fR\fB_new\fR() allocates an empty object of the indicated type.
551 The object returned must be released by calling \fB\fR\f(BITYPE\fR\fB_free\fR().
552 .PP
553 \&\fR\f(BITYPE\fR\fB_new_ex\fR() is similar to \fB\fR\f(BITYPE\fR\fB_new\fR() but also passes the
554 library context \fIlibctx\fR and the property query \fIpropq\fR to use when retrieving
555 algorithms from providers. This created object can then be used when loading
556 binary data using \fBd2i_\fR\f(BITYPE\fR\fB\fR().
557 .PP
558 \&\fR\f(BITYPE\fR\fB_dup\fR() copies an existing object, leaving it untouched.
559 Note, however, that the internal representation of the object
560 may contain (besides the ASN.1 structure) further data, which is not copied.
561 For instance, an \fBX509\fR object usually is augmented by cached information
562 on X.509v3 extensions, etc., and losing it can lead to wrong validation results.
563 To avoid such situations, better use \fB\fR\f(BITYPE\fR\fB_up_ref\fR() if available.
564 For the case of \fBX509\fR objects, an alternative to using \fBX509_up_ref\fR\|(3)
565 may be to still call \fB\fR\f(BITYPE\fR\fB_dup\fR(), e.g., \fIcopied_cert = X509_dup(cert)\fR,
566 followed by \fIX509_check_purpose(copied_cert, \-1, 0)\fR,
567 which re-builds the cached data.
568 .PP
569 \&\fR\f(BITYPE\fR\fB_free\fR() releases the object and all pointers and sub-objects
570 within it. If the argument is NULL, nothing is done.
571 .PP
572 \&\fR\f(BITYPE\fR\fB_print_ctx\fR() prints the object \fIa\fR on the specified BIO \fIout\fR.
573 Each line will be prefixed with \fIindent\fR spaces.
574 The \fIpctx\fR specifies the printing context and is for internal
575 use; use NULL to get the default behavior. If a print function is
576 user-defined, then pass in any \fIpctx\fR down to any nested calls.
577 .SH "RETURN VALUES"
578 .IX Header "RETURN VALUES"
579 \&\fR\f(BITYPE\fR\fB_new\fR(), \fB\fR\f(BITYPE\fR\fB_new_ex\fR() and \fB\fR\f(BITYPE\fR\fB_dup\fR() return a pointer to
580 the object or NULL on failure.
581 .PP
582 \&\fR\f(BITYPE\fR\fB_print_ctx\fR() returns 1 on success or zero on failure.
583 .SH "SEE ALSO"
584 .IX Header "SEE ALSO"
585 \&\fBX509_up_ref\fR\|(3)
586 .SH HISTORY
587 .IX Header "HISTORY"
588 The functions \fBX509_REQ_new_ex()\fR, \fBX509_CRL_new_ex()\fR, \fBPKCS7_new_ex()\fR and
589 \&\fBCMS_ContentInfo_new_ex()\fR were added in OpenSSL 3.0.
590 .PP
591 The functions \fBDSAparams_dup()\fR, \fBRSAPrivateKey_dup()\fR and \fBRSAPublicKey_dup()\fR were
592 deprecated in 3.0.
593 .PP
594 \&\fBCMS_EnvelopedData_it()\fR, \fBCMS_SignedData_free()\fR, \fBCMS_SignedData_new()\fR
595 were added in OpenSSL 3.2.
596 .PP
597 \&\fBDIST_POINT_NAME_dup()\fR, \fBOSSL_IETF_ATTR_SYNTAX_free()\fR, \fBOSSL_IETF_ATTR_SYNTAX_it()\fR,
598 \&\fBOSSL_IETF_ATTR_SYNTAX_new()\fR, \fBOSSL_ATTRIBUTES_SYNTAX_free()\fR,
599 \&\fBOSSL_ATTRIBUTES_SYNTAX_it()\fR, \fBOSSL_ATTRIBUTES_SYNTAX_new()\fR,
600 \&\fBOSSL_BASIC_ATTR_CONSTRAINTS_free()\fR, \fBOSSL_BASIC_ATTR_CONSTRAINTS_it()\fR,
601 \&\fBOSSL_BASIC_ATTR_CONSTRAINTS_new()\fR, \fBOSSL_CMP_ATAVS_new()\fR, \fBOSSL_CMP_ATAVS_free()\fR,
602 \&\fBOSSL_CMP_ATAVS_it()\fR, \fBOSSL_CMP_CRLSTATUS_free()\fR, \fBOSSL_CRMF_CERTTEMPLATE_dup()\fR,
603 \&\fBOSSL_CRMF_ATTRIBUTETYPEANDVALUE_dup()\fR, \fBOSSL_CRMF_ATTRIBUTETYPEANDVALUE_free()\fR,
604 \&\fBOSSL_TARGET_free()\fR, \fBOSSL_TARGET_it()\fR, \fBOSSL_TARGET_new()\fR,
605 \&\fBOSSL_TARGETING_INFORMATION_free()\fR, \fBOSSL_TARGETING_INFORMATION_it()\fR,
606 \&\fBOSSL_TARGETING_INFORMATION_new()\fR, \fBOSSL_TARGETS_free()\fR,
607 \&\fBOSSL_TARGETS_it()\fR, \fBOSSL_TARGETS_new()\fR, \fBOSSL_IETF_ATTR_SYNTAX_VALUE_free()\fR,
608 \&\fBOSSL_IETF_ATTR_SYNTAX_VALUE_it()\fR, \fBOSSL_IETF_ATTR_SYNTAX_VALUE_new()\fR,
609 \&\fBOSSL_ISSUER_SERIAL_free()\fR, \fBOSSL_ISSUER_SERIAL_new()\fR,
610 \&\fBOSSL_OBJECT_DIGEST_INFO_free()\fR, \fBOSSL_OBJECT_DIGEST_INFO_new()\fR,
611 \&\fBOSSL_USER_NOTICE_SYNTAX_free()\fR, \fBOSSL_USER_NOTICE_SYNTAX_new()\fR,
612 \&\fBOSSL_USER_NOTICE_SYNTAX_it()\fR, \fBPBMAC1PARAM_free()\fR, \fBPBMAC1PARAM_it()\fR,
613 \&\fBPBMAC1PARAM_new()\fR, \fBX509_ACERT_dup()\fR, \fBX509_ACERT_free()\fR, \fBX509_ACERT_it()\fR,
614 \&\fBX509_ACERT_new()\fR, \fBX509_ACERT_INFO_free()\fR, \fBX509_ACERT_INFO_it()\fR,
615 \&\fBX509_ACERT_INFO_new()\fR, \fBX509_ACERT_ISSUER_V2FORM_free()\fR,
616 \&\fBX509_ACERT_ISSUER_V2FORM_new()\fR
617 were added in OpenSSL 3.4.
618 .PP
619 \&\fBOSSL_AA_DIST_POINT_free()\fR, \fBOSSL_AA_DIST_POINT_new()\fR, \fBOSSL_AA_DIST_POINT_it()\fR,
620 \&\fBOSSL_ALLOWED_ATTRIBUTES_CHOICE_free()\fR, \fBOSSL_ALLOWED_ATTRIBUTES_CHOICE_new()\fR,
621 \&\fBOSSL_ALLOWED_ATTRIBUTES_CHOICE_it()\fR, \fBOSSL_ALLOWED_ATTRIBUTES_ITEM_free()\fR,
622 \&\fBOSSL_ALLOWED_ATTRIBUTES_ITEM_new()\fR, \fBOSSL_ALLOWED_ATTRIBUTES_ITEM_it()\fR,
623 \&\fBOSSL_ALLOWED_ATTRIBUTES_SYNTAX_free()\fR, \fBOSSL_ALLOWED_ATTRIBUTES_SYNTAX_new()\fR,
624 \&\fBOSSL_ALLOWED_ATTRIBUTES_SYNTAX_it()\fR,
625 \&\fBOSSL_ATAV_free()\fR, \fBOSSL_ATAV_it()\fR, \fBOSSL_ATAV_new()\fR,
626 \&\fBOSSL_ATTRIBUTE_DESCRIPTOR_free()\fR, \fBOSSL_ATTRIBUTE_DESCRIPTOR_new()\fR,
627 \&\fBOSSL_ATTRIBUTE_DESCRIPTOR_it()\fR,
628 \&\fBOSSL_ATTRIBUTE_MAPPINGS_free()\fR, \fBOSSL_ATTRIBUTE_MAPPINGS_it()\fR,
629 \&\fBOSSL_ATTRIBUTE_MAPPINGS_new()\fR, \fBOSSL_ATTRIBUTE_MAPPING_free()\fR,
630 \&\fBOSSL_ATTRIBUTE_MAPPING_it()\fR, \fBOSSL_ATTRIBUTE_MAPPING_new()\fR,
631 \&\fBOSSL_ATTRIBUTE_TYPE_MAPPING_free()\fR, \fBOSSL_ATTRIBUTE_TYPE_MAPPING_it()\fR,
632 \&\fBOSSL_ATTRIBUTE_TYPE_MAPPING_new()\fR, \fBOSSL_ATTRIBUTE_VALUE_MAPPING_free()\fR,
633 \&\fBOSSL_ATTRIBUTE_VALUE_MAPPING_it()\fR, \fBOSSL_ATTRIBUTE_VALUE_MAPPING_new()\fR,
634 \&\fBOSSL_AUTHORITY_ATTRIBUTE_ID_SYNTAX_free()\fR,
635 \&\fBOSSL_AUTHORITY_ATTRIBUTE_ID_SYNTAX_it()\fR, \fBOSSL_AUTHORITY_ATTRIBUTE_ID_SYNTAX_new()\fR,
636 \&\fBOSSL_HASH_free()\fR, \fBOSSL_HASH_it()\fR, \fBOSSL_HASH_new()\fR, \fBOSSL_INFO_SYNTAX_free()\fR,
637 \&\fBOSSL_INFO_SYNTAX_it()\fR, \fBOSSL_INFO_SYNTAX_new()\fR, \fBOSSL_INFO_SYNTAX_POINTER_free()\fR,
638 \&\fBOSSL_INFO_SYNTAX_POINTER_it()\fR, \fBOSSL_INFO_SYNTAX_POINTER_new()\fR,
639 \&\fBOSSL_PRIVILEGE_POLICY_ID_free()\fR, \fBOSSL_PRIVILEGE_POLICY_ID_it()\fR,
640 \&\fBOSSL_PRIVILEGE_POLICY_ID_new()\fR, \fBOSSL_ROLE_SPEC_CERT_ID_free()\fR,
641 \&\fBOSSL_ROLE_SPEC_CERT_ID_new()\fR, \fBOSSL_ROLE_SPEC_CERT_ID_it()\fR,
642 \&\fBOSSL_ROLE_SPEC_CERT_ID_SYNTAX_free()\fR, \fBOSSL_ROLE_SPEC_CERT_ID_SYNTAX_new()\fR,
643 \&\fBOSSL_ROLE_SPEC_CERT_ID_SYNTAX_it()\fR, \fBOSSL_DAY_TIME_BAND_free()\fR,
644 \&\fBOSSL_DAY_TIME_BAND_it()\fR, \fBOSSL_DAY_TIME_BAND_new()\fR,
645 \&\fBOSSL_DAY_TIME_free()\fR, \fBOSSL_DAY_TIME_it()\fR, \fBOSSL_DAY_TIME_new()\fR,
646 \&\fBOSSL_NAMED_DAY_free()\fR, \fBOSSL_NAMED_DAY_it()\fR, \fBOSSL_NAMED_DAY_new()\fR,
647 \&\fBOSSL_TIME_PERIOD_free()\fR, \fBOSSL_TIME_PERIOD_it()\fR, \fBOSSL_TIME_PERIOD_new()\fR,
648 \&\fBOSSL_TIME_SPEC_ABSOLUTE_free()\fR, \fBOSSL_TIME_SPEC_ABSOLUTE_it()\fR,
649 \&\fBOSSL_TIME_SPEC_ABSOLUTE_new()\fR, \fBOSSL_TIME_SPEC_DAY_free()\fR,
650 \&\fBOSSL_TIME_SPEC_DAY_it()\fR, \fBOSSL_TIME_SPEC_DAY_new()\fR,
651 \&\fBOSSL_TIME_SPEC_MONTH_free()\fR, \fBOSSL_TIME_SPEC_MONTH_it()\fR,
652 \&\fBOSSL_TIME_SPEC_MONTH_new()\fR, \fBOSSL_TIME_SPEC_TIME_free()\fR,
653 \&\fBOSSL_TIME_SPEC_TIME_it()\fR, \fBOSSL_TIME_SPEC_TIME_new()\fR,
654 \&\fBOSSL_TIME_SPEC_WEEKS_free()\fR, \fBOSSL_TIME_SPEC_WEEKS_it()\fR,
655 \&\fBOSSL_TIME_SPEC_WEEKS_new()\fR, \fBOSSL_TIME_SPEC_X_DAY_OF_free()\fR,
656 \&\fBOSSL_TIME_SPEC_X_DAY_OF_it()\fR, \fBOSSL_TIME_SPEC_X_DAY_OF_new()\fR,
657 \&\fBOSSL_TIME_SPEC_free()\fR, \fBOSSL_TIME_SPEC_it()\fR, \fBOSSL_TIME_SPEC_new()\fR,
658 \&\fBCMS_EnvelopedData_dup()\fR, \fBOSSL_CRMF_ENCRYPTEDKEY_free()\fR,
659 \&\fBOSSL_CRMF_ENCRYPTEDKEY_it()\fR and \fBOSSL_CRMF_ENCRYPTEDKEY_new()\fR
660 were added in OpenSSL 3.5.
661 .SH COPYRIGHT
662 .IX Header "COPYRIGHT"
663 Copyright 2016\-2025 The OpenSSL Project Authors. All Rights Reserved.
664 .PP
665 Licensed under the Apache License 2.0 (the "License"). You may not use
666 this file except in compliance with the License. You can obtain a copy
667 in the file LICENSE in the source distribution or at
668 <https://www.openssl.org/source/license.html>.