476 lines
12 KiB
Groff
Executable File
476 lines
12 KiB
Groff
Executable File
.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
|
|
.\"
|
|
.\" Standard preamble:
|
|
.\" ========================================================================
|
|
.de Sp \" Vertical space (when we can't use .PP)
|
|
.if t .sp .5v
|
|
.if n .sp
|
|
..
|
|
.de Vb \" Begin verbatim text
|
|
.ft CW
|
|
.nf
|
|
.ne \\$1
|
|
..
|
|
.de Ve \" End verbatim text
|
|
.ft R
|
|
.fi
|
|
..
|
|
.\" Set up some character translations and predefined strings. \*(-- will
|
|
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
|
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
|
|
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
|
|
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
|
|
.\" nothing in troff, for use with C<>.
|
|
.tr \(*W-
|
|
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
|
.ie n \{\
|
|
. ds -- \(*W-
|
|
. ds PI pi
|
|
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
|
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
|
. ds L" ""
|
|
. ds R" ""
|
|
. ds C` ""
|
|
. ds C' ""
|
|
'br\}
|
|
.el\{\
|
|
. ds -- \|\(em\|
|
|
. ds PI \(*p
|
|
. ds L" ``
|
|
. ds R" ''
|
|
'br\}
|
|
.\"
|
|
.\" Escape single quotes in literal strings from groff's Unicode transform.
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\"
|
|
.\" If the F register is turned on, we'll generate index entries on stderr for
|
|
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
|
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
|
.\" output yourself in some meaningful fashion.
|
|
.ie \nF \{\
|
|
. de IX
|
|
. tm Index:\\$1\t\\n%\t"\\$2"
|
|
..
|
|
. nr % 0
|
|
. rr F
|
|
.\}
|
|
.el \{\
|
|
. de IX
|
|
..
|
|
.\}
|
|
.\"
|
|
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
|
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
|
. \" fudge factors for nroff and troff
|
|
.if n \{\
|
|
. ds #H 0
|
|
. ds #V .8m
|
|
. ds #F .3m
|
|
. ds #[ \f1
|
|
. ds #] \fP
|
|
.\}
|
|
.if t \{\
|
|
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
|
. ds #V .6m
|
|
. ds #F 0
|
|
. ds #[ \&
|
|
. ds #] \&
|
|
.\}
|
|
. \" simple accents for nroff and troff
|
|
.if n \{\
|
|
. ds ' \&
|
|
. ds ` \&
|
|
. ds ^ \&
|
|
. ds , \&
|
|
. ds ~ ~
|
|
. ds /
|
|
.\}
|
|
.if t \{\
|
|
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
|
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
|
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
|
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
|
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
|
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
|
.\}
|
|
. \" troff and (daisy-wheel) nroff accents
|
|
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
|
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
|
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
|
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
|
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
|
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
|
|
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
|
.ds ae a\h'-(\w'a'u*4/10)'e
|
|
.ds Ae A\h'-(\w'A'u*4/10)'E
|
|
. \" corrections for vroff
|
|
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
|
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
|
. \" for low resolution devices (crt and lpr)
|
|
.if \n(.H>23 .if \n(.V>19 \
|
|
\{\
|
|
. ds : e
|
|
. ds 8 ss
|
|
. ds o a
|
|
. ds d- d\h'-1'\(ga
|
|
. ds D- D\h'-1'\(hy
|
|
. ds th \o'bp'
|
|
. ds Th \o'LP'
|
|
. ds ae ae
|
|
. ds Ae AE
|
|
.\}
|
|
.rm #[ #] #H #V #F C
|
|
.\" ========================================================================
|
|
.\"
|
|
.IX Title "X509_DUP 3"
|
|
.TH X509_DUP 3 "2020-03-02" "3.0.0-dev" "OpenSSL"
|
|
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
|
.\" way too many mistakes in technical documents.
|
|
.if n .ad l
|
|
.nh
|
|
.SH "NAME"
|
|
DECLARE_ASN1_FUNCTIONS,
|
|
IMPLEMENT_ASN1_FUNCTIONS,
|
|
ASN1_ITEM,
|
|
ACCESS_DESCRIPTION_free,
|
|
ACCESS_DESCRIPTION_new,
|
|
ADMISSIONS_free,
|
|
ADMISSIONS_new,
|
|
ADMISSION_SYNTAX_free,
|
|
ADMISSION_SYNTAX_new,
|
|
ASIdOrRange_free,
|
|
ASIdOrRange_new,
|
|
ASIdentifierChoice_free,
|
|
ASIdentifierChoice_new,
|
|
ASIdentifiers_free,
|
|
ASIdentifiers_new,
|
|
ASRange_free,
|
|
ASRange_new,
|
|
AUTHORITY_INFO_ACCESS_free,
|
|
AUTHORITY_INFO_ACCESS_new,
|
|
AUTHORITY_KEYID_free,
|
|
AUTHORITY_KEYID_new,
|
|
BASIC_CONSTRAINTS_free,
|
|
BASIC_CONSTRAINTS_new,
|
|
CERTIFICATEPOLICIES_free,
|
|
CERTIFICATEPOLICIES_new,
|
|
CMS_ContentInfo_free,
|
|
CMS_ContentInfo_new,
|
|
CMS_ContentInfo_print_ctx,
|
|
CMS_ReceiptRequest_free,
|
|
CMS_ReceiptRequest_new,
|
|
CRL_DIST_POINTS_free,
|
|
CRL_DIST_POINTS_new,
|
|
DIRECTORYSTRING_free,
|
|
DIRECTORYSTRING_new,
|
|
DISPLAYTEXT_free,
|
|
DISPLAYTEXT_new,
|
|
DIST_POINT_NAME_free,
|
|
DIST_POINT_NAME_new,
|
|
DIST_POINT_free,
|
|
DIST_POINT_new,
|
|
DSAparams_dup,
|
|
ECPARAMETERS_free,
|
|
ECPARAMETERS_new,
|
|
ECPKPARAMETERS_free,
|
|
ECPKPARAMETERS_new,
|
|
EDIPARTYNAME_free,
|
|
EDIPARTYNAME_new,
|
|
ESS_CERT_ID_dup,
|
|
ESS_CERT_ID_free,
|
|
ESS_CERT_ID_new,
|
|
ESS_CERT_ID_V2_dup,
|
|
ESS_CERT_ID_V2_free,
|
|
ESS_CERT_ID_V2_new,
|
|
ESS_ISSUER_SERIAL_dup,
|
|
ESS_ISSUER_SERIAL_free,
|
|
ESS_ISSUER_SERIAL_new,
|
|
ESS_SIGNING_CERT_dup,
|
|
ESS_SIGNING_CERT_free,
|
|
ESS_SIGNING_CERT_new,
|
|
ESS_SIGNING_CERT_V2_dup,
|
|
ESS_SIGNING_CERT_V2_free,
|
|
ESS_SIGNING_CERT_V2_new,
|
|
EXTENDED_KEY_USAGE_free,
|
|
EXTENDED_KEY_USAGE_new,
|
|
GENERAL_NAMES_free,
|
|
GENERAL_NAMES_new,
|
|
GENERAL_NAME_dup,
|
|
GENERAL_NAME_free,
|
|
GENERAL_NAME_new,
|
|
GENERAL_SUBTREE_free,
|
|
GENERAL_SUBTREE_new,
|
|
IPAddressChoice_free,
|
|
IPAddressChoice_new,
|
|
IPAddressFamily_free,
|
|
IPAddressFamily_new,
|
|
IPAddressOrRange_free,
|
|
IPAddressOrRange_new,
|
|
IPAddressRange_free,
|
|
IPAddressRange_new,
|
|
ISSUING_DIST_POINT_free,
|
|
ISSUING_DIST_POINT_new,
|
|
NAME_CONSTRAINTS_free,
|
|
NAME_CONSTRAINTS_new,
|
|
NAMING_AUTHORITY_free,
|
|
NAMING_AUTHORITY_new,
|
|
NETSCAPE_CERT_SEQUENCE_free,
|
|
NETSCAPE_CERT_SEQUENCE_new,
|
|
NETSCAPE_SPKAC_free,
|
|
NETSCAPE_SPKAC_new,
|
|
NETSCAPE_SPKI_free,
|
|
NETSCAPE_SPKI_new,
|
|
NOTICEREF_free,
|
|
NOTICEREF_new,
|
|
OCSP_BASICRESP_free,
|
|
OCSP_BASICRESP_new,
|
|
OCSP_CERTID_dup,
|
|
OCSP_CERTID_new,
|
|
OCSP_CERTSTATUS_free,
|
|
OCSP_CERTSTATUS_new,
|
|
OCSP_CRLID_free,
|
|
OCSP_CRLID_new,
|
|
OCSP_ONEREQ_free,
|
|
OCSP_ONEREQ_new,
|
|
OCSP_REQINFO_free,
|
|
OCSP_REQINFO_new,
|
|
OCSP_RESPBYTES_free,
|
|
OCSP_RESPBYTES_new,
|
|
OCSP_RESPDATA_free,
|
|
OCSP_RESPDATA_new,
|
|
OCSP_RESPID_free,
|
|
OCSP_RESPID_new,
|
|
OCSP_RESPONSE_new,
|
|
OCSP_REVOKEDINFO_free,
|
|
OCSP_REVOKEDINFO_new,
|
|
OCSP_SERVICELOC_free,
|
|
OCSP_SERVICELOC_new,
|
|
OCSP_SIGNATURE_free,
|
|
OCSP_SIGNATURE_new,
|
|
OCSP_SINGLERESP_free,
|
|
OCSP_SINGLERESP_new,
|
|
OSSL_CMP_ITAV_free,
|
|
OSSL_CMP_MSG_it,
|
|
OSSL_CMP_MSG_free,
|
|
OSSL_CMP_PKIHEADER_free,
|
|
OSSL_CMP_PKIHEADER_it,
|
|
OSSL_CMP_PKIHEADER_new,
|
|
OSSL_CMP_PKISI_free,
|
|
OSSL_CMP_PKISI_new,
|
|
OSSL_CMP_PKISTATUS_it,
|
|
OSSL_CRMF_CERTID_free,
|
|
OSSL_CRMF_CERTID_it,
|
|
OSSL_CRMF_CERTID_new,
|
|
OSSL_CRMF_CERTTEMPLATE_free,
|
|
OSSL_CRMF_CERTTEMPLATE_it,
|
|
OSSL_CRMF_CERTTEMPLATE_new,
|
|
OSSL_CRMF_ENCRYPTEDVALUE_free,
|
|
OSSL_CRMF_ENCRYPTEDVALUE_it,
|
|
OSSL_CRMF_ENCRYPTEDVALUE_new,
|
|
OSSL_CRMF_MSGS_free,
|
|
OSSL_CRMF_MSGS_it,
|
|
OSSL_CRMF_MSGS_new,
|
|
OSSL_CRMF_MSG_free,
|
|
OSSL_CRMF_MSG_it,
|
|
OSSL_CRMF_MSG_new,
|
|
OSSL_CRMF_PBMPARAMETER_free,
|
|
OSSL_CRMF_PBMPARAMETER_it,
|
|
OSSL_CRMF_PBMPARAMETER_new,
|
|
OSSL_CRMF_PKIPUBLICATIONINFO_free,
|
|
OSSL_CRMF_PKIPUBLICATIONINFO_it,
|
|
OSSL_CRMF_PKIPUBLICATIONINFO_new,
|
|
OSSL_CRMF_SINGLEPUBINFO_free,
|
|
OSSL_CRMF_SINGLEPUBINFO_it,
|
|
OSSL_CRMF_SINGLEPUBINFO_new,
|
|
OTHERNAME_free,
|
|
OTHERNAME_new,
|
|
PBE2PARAM_free,
|
|
PBE2PARAM_new,
|
|
PBEPARAM_free,
|
|
PBEPARAM_new,
|
|
PBKDF2PARAM_free,
|
|
PBKDF2PARAM_new,
|
|
PKCS12_BAGS_free,
|
|
PKCS12_BAGS_new,
|
|
PKCS12_MAC_DATA_free,
|
|
PKCS12_MAC_DATA_new,
|
|
PKCS12_SAFEBAG_free,
|
|
PKCS12_SAFEBAG_new,
|
|
PKCS12_free,
|
|
PKCS12_new,
|
|
PKCS7_DIGEST_free,
|
|
PKCS7_DIGEST_new,
|
|
PKCS7_ENCRYPT_free,
|
|
PKCS7_ENCRYPT_new,
|
|
PKCS7_ENC_CONTENT_free,
|
|
PKCS7_ENC_CONTENT_new,
|
|
PKCS7_ENVELOPE_free,
|
|
PKCS7_ENVELOPE_new,
|
|
PKCS7_ISSUER_AND_SERIAL_free,
|
|
PKCS7_ISSUER_AND_SERIAL_new,
|
|
PKCS7_RECIP_INFO_free,
|
|
PKCS7_RECIP_INFO_new,
|
|
PKCS7_SIGNED_free,
|
|
PKCS7_SIGNED_new,
|
|
PKCS7_SIGNER_INFO_free,
|
|
PKCS7_SIGNER_INFO_new,
|
|
PKCS7_SIGN_ENVELOPE_free,
|
|
PKCS7_SIGN_ENVELOPE_new,
|
|
PKCS7_dup,
|
|
PKCS7_free,
|
|
PKCS7_new,
|
|
PKCS7_print_ctx,
|
|
PKCS8_PRIV_KEY_INFO_free,
|
|
PKCS8_PRIV_KEY_INFO_new,
|
|
PKEY_USAGE_PERIOD_free,
|
|
PKEY_USAGE_PERIOD_new,
|
|
POLICYINFO_free,
|
|
POLICYINFO_new,
|
|
POLICYQUALINFO_free,
|
|
POLICYQUALINFO_new,
|
|
POLICY_CONSTRAINTS_free,
|
|
POLICY_CONSTRAINTS_new,
|
|
POLICY_MAPPING_free,
|
|
POLICY_MAPPING_new,
|
|
PROFESSION_INFOS_free,
|
|
PROFESSION_INFOS_new,
|
|
PROFESSION_INFO_free,
|
|
PROFESSION_INFO_new,
|
|
PROXY_CERT_INFO_EXTENSION_free,
|
|
PROXY_CERT_INFO_EXTENSION_new,
|
|
PROXY_POLICY_free,
|
|
PROXY_POLICY_new,
|
|
RSAPrivateKey_dup,
|
|
RSAPublicKey_dup,
|
|
RSA_OAEP_PARAMS_free,
|
|
RSA_OAEP_PARAMS_new,
|
|
RSA_PSS_PARAMS_free,
|
|
RSA_PSS_PARAMS_new,
|
|
SCRYPT_PARAMS_free,
|
|
SCRYPT_PARAMS_new,
|
|
SXNETID_free,
|
|
SXNETID_new,
|
|
SXNET_free,
|
|
SXNET_new,
|
|
TLS_FEATURE_free,
|
|
TLS_FEATURE_new,
|
|
TS_ACCURACY_dup,
|
|
TS_ACCURACY_free,
|
|
TS_ACCURACY_new,
|
|
TS_MSG_IMPRINT_dup,
|
|
TS_MSG_IMPRINT_free,
|
|
TS_MSG_IMPRINT_new,
|
|
TS_REQ_dup,
|
|
TS_REQ_free,
|
|
TS_REQ_new,
|
|
TS_RESP_dup,
|
|
TS_RESP_free,
|
|
TS_RESP_new,
|
|
TS_STATUS_INFO_dup,
|
|
TS_STATUS_INFO_free,
|
|
TS_STATUS_INFO_new,
|
|
TS_TST_INFO_dup,
|
|
TS_TST_INFO_free,
|
|
TS_TST_INFO_new,
|
|
USERNOTICE_free,
|
|
USERNOTICE_new,
|
|
X509_ALGOR_free,
|
|
X509_ALGOR_new,
|
|
X509_ATTRIBUTE_dup,
|
|
X509_ATTRIBUTE_free,
|
|
X509_ATTRIBUTE_new,
|
|
X509_CERT_AUX_free,
|
|
X509_CERT_AUX_new,
|
|
X509_CINF_free,
|
|
X509_CINF_new,
|
|
X509_CRL_INFO_free,
|
|
X509_CRL_INFO_new,
|
|
X509_CRL_dup,
|
|
X509_CRL_free,
|
|
X509_CRL_new,
|
|
X509_EXTENSION_dup,
|
|
X509_EXTENSION_free,
|
|
X509_EXTENSION_new,
|
|
X509_NAME_ENTRY_dup,
|
|
X509_NAME_ENTRY_free,
|
|
X509_NAME_ENTRY_new,
|
|
X509_NAME_dup,
|
|
X509_NAME_free,
|
|
X509_NAME_new,
|
|
X509_REQ_INFO_free,
|
|
X509_REQ_INFO_new,
|
|
X509_REQ_dup,
|
|
X509_REQ_free,
|
|
X509_REQ_new,
|
|
X509_REVOKED_dup,
|
|
X509_REVOKED_free,
|
|
X509_REVOKED_new,
|
|
X509_SIG_free,
|
|
X509_SIG_new,
|
|
X509_VAL_free,
|
|
X509_VAL_new,
|
|
X509_dup,
|
|
\&\- ASN1 object utilities
|
|
.SH "SYNOPSIS"
|
|
.IX Header "SYNOPSIS"
|
|
.Vb 1
|
|
\& #include <openssl/asn1t.h>
|
|
\&
|
|
\& DECLARE_ASN1_FUNCTIONS(type)
|
|
\& IMPLEMENT_ASN1_FUNCTIONS(stname)
|
|
\&
|
|
\& typedef struct ASN1_ITEM_st ASN1_ITEM;
|
|
\&
|
|
\& extern const ASN1_ITEM TYPE_it;
|
|
\& TYPE *TYPE_new(void);
|
|
\& TYPE *TYPE_dup(const TYPE *a);
|
|
\& void TYPE_free(TYPE *a);
|
|
\& int TYPE_print_ctx(BIO *out, TYPE *a, int indent, const ASN1_PCTX *pctx);
|
|
.Ve
|
|
.SH "DESCRIPTION"
|
|
.IX Header "DESCRIPTION"
|
|
In the description below, \fB\f(BI\s-1TYPE\s0\fB\fR is used
|
|
as a placeholder for any of the OpenSSL datatypes, such as \fBX509\fR.
|
|
.PP
|
|
The OpenSSL \s-1ASN1\s0 parsing library templates are like a data-driven bytecode
|
|
interpreter.
|
|
Every \s-1ASN1\s0 object as a global variable, TYPE_it, that describes the item
|
|
such as its fields. (On systems which cannot export variables from shared
|
|
libraries, the global is instead a function which returns a pointer to a
|
|
static variable.
|
|
.PP
|
|
The macro \s-1\fIDECLARE_ASN1_FUNCTIONS\s0()\fR is typically used in header files
|
|
to generate the function declarations.
|
|
.PP
|
|
The macro \s-1\fIIMPLEMENT_ASN1_FUNCTIONS\s0()\fR is used once in a source file
|
|
to generate the function bodies.
|
|
.PP
|
|
\&\fB\f(BI\s-1TYPE\s0\fB_new\fR() allocates an empty object of the indicated type.
|
|
The object returned must be released by calling \fB\f(BI\s-1TYPE\s0\fB_free\fR().
|
|
.PP
|
|
\&\fB\f(BI\s-1TYPE\s0\fB_dup\fR() copies an existing object, leaving it untouched.
|
|
.PP
|
|
\&\fB\f(BI\s-1TYPE\s0\fB_free\fR() releases the object and all pointers and sub-objects
|
|
within it.
|
|
.PP
|
|
\&\fB\f(BI\s-1TYPE\s0\fB_print_ctx\fR() prints the object \fIa\fR on the specified \s-1BIO\s0 \fIout\fR.
|
|
Each line will be prefixed with \fIindent\fR spaces.
|
|
The \fIpctx\fR specifies the printing context and is for internal
|
|
use; use \s-1NULL\s0 to get the default behavior. If a print function is
|
|
user-defined, then pass in any \fIpctx\fR down to any nested calls.
|
|
.SH "RETURN VALUES"
|
|
.IX Header "RETURN VALUES"
|
|
\&\fB\f(BI\s-1TYPE\s0\fB_new\fR() and \fB\f(BI\s-1TYPE\s0\fB_dup\fR() return a pointer to the object or \s-1NULL\s0 on
|
|
failure.
|
|
.PP
|
|
\&\fB\f(BI\s-1TYPE\s0\fB_print_ctx\fR() returns 1 on success or zero on failure.
|
|
.SH "COPYRIGHT"
|
|
.IX Header "COPYRIGHT"
|
|
Copyright 2016\-2018 The OpenSSL Project Authors. All Rights Reserved.
|
|
.PP
|
|
Licensed under the Apache License 2.0 (the \*(L"License\*(R"). You may not use
|
|
this file except in compliance with the License. You can obtain a copy
|
|
in the file \s-1LICENSE\s0 in the source distribution or at
|
|
<https://www.openssl.org/source/license.html>.
|