openssl: Import version 3.5.1

Migrate to OpenSSL 3.5 in advance of FreeBSD 15.0. OpenSSL 3.0 will be
EOL after 2026-09-07.

Approved by:	philip (mentor)
Sponsored by:	Alpha-Omega Beach Cleaning Project
Sponsored by:	The FreeBSD Foundation
Differential revision:	https://reviews.freebsd.org/D51613

This commit is contained in:

Pierre Pronchery

2025-07-11 23:57:10 +02:00

parent e7be843b4a

commit 4757b351ea

1039 changed files with 168555 additions and 99130 deletions

secure/lib/libcrypto/man/man3/ASN1_item_d2i_bio.3

+62 -111

View File

@@ -1,4 +1,5 @@
 .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
 .\" -*- mode: troff; coding: utf-8 -*-
 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -15,29 +16,12 @@
 .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'
 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
 .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" ''
 .    ds C`
 .    ds C'
 'br\}
@@ -68,79 +52,20 @@
 .    \}
 .\}
 .rr rF
 .\" 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 "ASN1_ITEM_D2I_BIO 3ossl"
 .TH ASN1_ITEM_D2I_BIO 3ossl "2023-09-19" "3.0.11" "OpenSSL"
 .TH ASN1_ITEM_D2I_BIO 3ossl 2025-07-01 3.5.1 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"
 .SH NAME
 ASN1_item_d2i_ex, ASN1_item_d2i, ASN1_item_d2i_bio_ex, ASN1_item_d2i_bio,
 ASN1_item_d2i_fp_ex, ASN1_item_d2i_fp, ASN1_item_i2d_mem_bio
 ASN1_item_d2i_fp_ex, ASN1_item_d2i_fp, ASN1_item_i2d_mem_bio,
 ASN1_item_pack, ASN1_item_unpack_ex, ASN1_item_unpack
 \&\- decode and encode DER\-encoded ASN.1 structures
 .SH "SYNOPSIS"
 .SH SYNOPSIS
 .IX Header "SYNOPSIS"
 .Vb 1
 \& #include <openssl/asn1.h>
@@ -160,59 +85,85 @@ ASN1_item_d2i_fp_ex, ASN1_item_d2i_fp, ASN1_item_i2d_mem_bio
 \& void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x);
 \&
 \& BIO *ASN1_item_i2d_mem_bio(const ASN1_ITEM *it, const ASN1_VALUE *val);
 \&
 \& ASN1_STRING *ASN1_item_pack(void *obj, const ASN1_ITEM *it, ASN1_STRING **oct);
 \&
 \& void *ASN1_item_unpack(const ASN1_STRING *oct, const ASN1_ITEM *it);
 \&
 \& void *ASN1_item_unpack_ex(const ASN1_STRING *oct, const ASN1_ITEM *it,
 \&                          OSSL_LIB_CTX *libctx, const char *propq);
 .Ve
 .SH "DESCRIPTION"
 .SH DESCRIPTION
 .IX Header "DESCRIPTION"
 \&\fBASN1_item_d2i_ex()\fR decodes the contents of the data stored in \fI*in\fR of length
 \&\fIlen\fR which must be a DER-encoded \s-1ASN.1\s0 structure, using the \s-1ASN.1\s0 template
 \&\fIit\fR. It places the result in \fI*pval\fR unless \fIpval\fR is \s-1NULL.\s0 If \fI*pval\fR is
 non-NULL on entry then the \fB\s-1ASN1_VALUE\s0\fR present there will be reused. Otherwise
 a new \fB\s-1ASN1_VALUE\s0\fR will be allocated. If any algorithm fetches are required
 during the process then they will use the \fB\s-1OSSL_LIB_CTX\s0\fRprovided in the
 \&\fIlen\fR which must be a DER-encoded ASN.1 structure, using the ASN.1 template
 \&\fIit\fR. It places the result in \fI*pval\fR unless \fIpval\fR is NULL. If \fI*pval\fR is
 non-NULL on entry then the \fBASN1_VALUE\fR present there will be reused. Otherwise
 a new \fBASN1_VALUE\fR will be allocated. If any algorithm fetches are required
 during the process then they will use the \fBOSSL_LIB_CTX\fRprovided in the
 \&\fIlibctx\fR parameter and the property query string in \fIpropq\fR. See
 \&\*(L"\s-1ALGORITHM FETCHING\*(R"\s0 in \fBcrypto\fR\|(7) for more information about algorithm fetching.
 "ALGORITHM FETCHING" in \fBcrypto\fR\|(7) for more information about algorithm fetching.
 On exit \fI*in\fR will be updated to point to the next byte in the buffer after the
 decoded structure.
 .PP
 \&\fBASN1_item_d2i()\fR is the same as \fBASN1_item_d2i_ex()\fR except that the default
 \&\s-1OSSL_LIB_CTX\s0 is used (i.e. \s-1NULL\s0) and with a \s-1NULL\s0 property query string.
 OSSL_LIB_CTX is used (i.e. NULL) and with a NULL property query string.
 .PP
 \&\fBASN1_item_d2i_bio_ex()\fR decodes the contents of its input \s-1BIO\s0 \fIin\fR,
 which must be a DER-encoded \s-1ASN.1\s0 structure, using the \s-1ASN.1\s0 template \fIit\fR
 and places the result in \fI*pval\fR unless \fIpval\fR is \s-1NULL.\s0
 If \fIin\fR is \s-1NULL\s0 it returns \s-1NULL,\s0 else a pointer to the parsed structure. If any
 \&\fBASN1_item_d2i_bio_ex()\fR decodes the contents of its input BIO \fIin\fR,
 which must be a DER-encoded ASN.1 structure, using the ASN.1 template \fIit\fR
 and places the result in \fI*pval\fR unless \fIpval\fR is NULL.
 If \fIin\fR is NULL it returns NULL, else a pointer to the parsed structure. If any
 algorithm fetches are required during the process then they will use the
 \&\fB\s-1OSSL_LIB_CTX\s0\fR provided in the \fIlibctx\fR parameter and the property query
 string in \fIpropq\fR. See \*(L"\s-1ALGORITHM FETCHING\*(R"\s0 in \fBcrypto\fR\|(7) for more information
 \&\fBOSSL_LIB_CTX\fR provided in the \fIlibctx\fR parameter and the property query
 string in \fIpropq\fR. See "ALGORITHM FETCHING" in \fBcrypto\fR\|(7) for more information
 about algorithm fetching.
 .PP
 \&\fBASN1_item_d2i_bio()\fR is the same as \fBASN1_item_d2i_bio_ex()\fR except that the
 default \fB\s-1OSSL_LIB_CTX\s0\fR is used (i.e. \s-1NULL\s0) and with a \s-1NULL\s0 property query
 default \fBOSSL_LIB_CTX\fR is used (i.e. NULL) and with a NULL property query
 string.
 .PP
 \&\fBASN1_item_d2i_fp_ex()\fR is the same as \fBASN1_item_d2i_bio_ex()\fR except that a \s-1FILE\s0
 pointer is provided instead of a \s-1BIO.\s0
 \&\fBASN1_item_d2i_fp_ex()\fR is the same as \fBASN1_item_d2i_bio_ex()\fR except that a FILE
 pointer is provided instead of a BIO.
 .PP
 \&\fBASN1_item_d2i_fp()\fR is the same as \fBASN1_item_d2i_fp_ex()\fR except that the
 default \fB\s-1OSSL_LIB_CTX\s0\fR is used (i.e. \s-1NULL\s0) and with a \s-1NULL\s0 property query
 default \fBOSSL_LIB_CTX\fR is used (i.e. NULL) and with a NULL property query
 string.
 .PP
 \&\fBASN1_item_i2d_mem_bio()\fR encodes the given \s-1ASN.1\s0 value \fIval\fR
 using the \s-1ASN.1\s0 template \fIit\fR and returns the result in a memory \s-1BIO.\s0
 \&\fBASN1_item_i2d_mem_bio()\fR encodes the given ASN.1 value \fIval\fR
 using the ASN.1 template \fIit\fR and returns the result in a memory BIO.
 .PP
 \&\fBASN1_item_pack()\fR encodes the given ASN.1 value in \fIobj\fR using the
 ASN.1 template \fIit\fR and returns an \fBASN1_STRING\fR object. If the passed in
 \&\fI*oct\fR is not NULL then this is used to store the returned result, otherwise
 a new \fBASN1_STRING\fR object is created. If \fIoct\fR is not NULL and \fI*oct\fR is NULL
 then the returned return is also set into \fI*oct\fR. If there is an error the optional
 passed in \fBASN1_STRING\fR will not be freed, but the previous value may be cleared when
 ASN1_STRING_set0(*oct, NULL, 0) is called internally.
 .PP
 \&\fBASN1_item_unpack()\fR uses \fBASN1_item_d2i()\fR to decode the DER-encoded \fBASN1_STRING\fR
 \&\fIoct\fR using the ASN.1 template \fIit\fR.
 .PP
 \&\fBASN1_item_unpack_ex()\fR is similar to \fBASN1_item_unpack()\fR, but uses \fBASN1_item_d2i_ex()\fR so
 that the \fIlibctx\fR and \fIpropq\fR can be used when doing algorithm fetching.
 .SH "RETURN VALUES"
 .IX Header "RETURN VALUES"
 \&\fBASN1_item_d2i_bio()\fR returns a pointer to an \fB\s-1ASN1_VALUE\s0\fR or \s-1NULL.\s0
 \&\fBASN1_item_d2i_bio()\fR, \fBASN1_item_unpack_ex()\fR and \fBASN1_item_unpack()\fR return a pointer to
 an \fBASN1_VALUE\fR or NULL on error.
 .PP
 \&\fBASN1_item_i2d_mem_bio()\fR returns a pointer to a memory \s-1BIO\s0 or \s-1NULL\s0 on error.
 .SH "HISTORY"
 \&\fBASN1_item_i2d_mem_bio()\fR returns a pointer to a memory BIO or NULL on error.
 .PP
 \&\fBASN1_item_pack()\fR returns a pointer to an \fBASN1_STRING\fR or NULL on error.
 .SH HISTORY
 .IX Header "HISTORY"
 The functions \fBASN1_item_d2i_ex()\fR, \fBASN1_item_d2i_bio_ex()\fR, \fBASN1_item_d2i_fp_ex()\fR
 and \fBASN1_item_i2d_mem_bio()\fR were added in OpenSSL 3.0.
 .SH "COPYRIGHT"
 .IX Header "COPYRIGHT"
 Copyright 2021 The OpenSSL Project Authors. All Rights Reserved.
 .PP
 Licensed under the Apache License 2.0 (the \*(L"License\*(R").  You may not use
 The function \fBASN1_item_unpack_ex()\fR was added in OpenSSL 3.2.
 .SH COPYRIGHT
 .IX Header "COPYRIGHT"
 Copyright 2021\-2023 The OpenSSL Project Authors. All Rights Reserved.
 .PP
 Licensed under the Apache License 2.0 (the "License").  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
 in the file LICENSE in the source distribution or at
 <https://www.openssl.org/source/license.html>.