mirror of
https://github.com/freebsd/freebsd-src.git
synced 2026-10-28 11:25:21 +01:00
crypto/openssl: update generated files to match 3.5.9 release content
A new manpage has been added and some source files have been refactored slightly, but by and large this is just a standard "version bump" update (3.5.8 -> 3.5.9). MFC after: 1 day MFC with: b3a31d78
This commit is contained in:
910 files changed
+4295
-6061
No files matched your search
@@ -498,6 +498,9 @@ SRCS+= file_store.c file_store_any2obj.c
|
||||
SRCS+= prov_seed.c rand_deprecated.c rand_err.c rand_lib.c
|
||||
SRCS+= rand_meth.c rand_pool.c rand_uniform.c randfile.c
|
||||
|
||||
# rbtree
|
||||
SRCS+= rbtree.c
|
||||
|
||||
# rc2
|
||||
SRCS+= rc2_cbc.c rc2_ecb.c rc2_skey.c rc2cfb64.c rc2ofb64.c
|
||||
|
||||
@@ -752,6 +755,7 @@ SUBDIR.${MK_TESTS}= tests
|
||||
${LCRYPTO_SRC}/crypto/poly1305 \
|
||||
${LCRYPTO_SRC}/crypto/property \
|
||||
${LCRYPTO_SRC}/crypto/rand \
|
||||
${LCRYPTO_SRC}/crypto/rbtree \
|
||||
${LCRYPTO_SRC}/crypto/rc2 \
|
||||
${LCRYPTO_SRC}/crypto/rc4 \
|
||||
${LCRYPTO_SRC}/crypto/rc5 \
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ADMISSIONS 3ossl"
|
||||
.TH ADMISSIONS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ADMISSIONS 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_EXTERN_FUNCS 3ossl"
|
||||
.TH ASN1_EXTERN_FUNCS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_EXTERN_FUNCS 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -146,7 +143,7 @@ macro.
|
||||
.IP \fIasn1_ex_d2i\fR 4
|
||||
.IX Item "asn1_ex_d2i"
|
||||
A "d2i" function responsible for converting DER data with the tag \fItag\fR and
|
||||
class \fIclass\fR into an \fBASN1_VALUE\fR. If \fI*pval\fR is non\-NULL then the
|
||||
class \fIclass\fR into an \fBASN1_VALUE\fR. If \fI*pval\fR is non-NULL then the
|
||||
\&\fBASN_VALUE\fR it points to should be reused. Otherwise a new \fBASN1_VALUE\fR
|
||||
should be allocated and stored in \fI*pval\fR. \fI*in\fR points to the DER data to be
|
||||
decoded and \fIlen\fR is the length of that data. After decoding \fI*in\fR should be
|
||||
@@ -180,7 +177,7 @@ The \fIasn1_ex_i2d\fR entry may be NULL if \fIasn1_ex_i2d_ex\fR has been specifi
|
||||
instead.
|
||||
.Sp
|
||||
The return value should be negative if a fatal error occurred, or 0 if a
|
||||
non\-fatal error occurred. Otherwise it should return the length of the encoded
|
||||
non-fatal error occurred. Otherwise it should return the length of the encoded
|
||||
data.
|
||||
.IP \fIasn1_ex_print\fR 4
|
||||
.IX Item "asn1_ex_print"
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_INTEGER_GET_INT64 3ossl"
|
||||
.TH ASN1_INTEGER_GET_INT64 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_INTEGER_GET_INT64 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_INTEGER_NEW 3ossl"
|
||||
.TH ASN1_INTEGER_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_INTEGER_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_ITEM_LOOKUP 3ossl"
|
||||
.TH ASN1_ITEM_LOOKUP 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_ITEM_LOOKUP 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_OBJECT_NEW 3ossl"
|
||||
.TH ASN1_OBJECT_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_OBJECT_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_STRING_TABLE_ADD 3ossl"
|
||||
.TH ASN1_STRING_TABLE_ADD 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_STRING_TABLE_ADD 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_STRING_LENGTH 3ossl"
|
||||
.TH ASN1_STRING_LENGTH 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_STRING_LENGTH 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -119,7 +116,7 @@ should be freed using \fBOPENSSL_free()\fR.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
Almost all ASN1 types in OpenSSL are represented as an \fBASN1_STRING\fR
|
||||
structure. Other types such as \fBASN1_OCTET_STRING\fR are simply typedef\*(Aqed
|
||||
structure. Other types such as \fBASN1_OCTET_STRING\fR are simply typedef'ed
|
||||
to \fBASN1_STRING\fR and the functions call the \fBASN1_STRING\fR equivalents.
|
||||
\&\fBASN1_STRING\fR is also used for some \fBCHOICE\fR types which consist
|
||||
entirely of primitive string types such as \fBDirectoryString\fR and
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_STRING_NEW 3ossl"
|
||||
.TH ASN1_STRING_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_STRING_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_STRING_PRINT_EX 3ossl"
|
||||
.TH ASN1_STRING_PRINT_EX 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_STRING_PRINT_EX 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -88,9 +85,9 @@ to \fIfp\fR instead.
|
||||
.PP
|
||||
\&\fBASN1_STRING_print()\fR prints \fIstr\fR to \fIout\fR but using a different format to
|
||||
\&\fBASN1_STRING_print_ex()\fR. It replaces unprintable characters (other than CR, LF)
|
||||
with \*(Aq.\*(Aq.
|
||||
with '.'.
|
||||
.PP
|
||||
\&\fBASN1_tag2str()\fR returns a human\-readable name of the specified ASN.1 \fItag\fR.
|
||||
\&\fBASN1_tag2str()\fR returns a human-readable name of the specified ASN.1 \fItag\fR.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
\&\fBASN1_STRING_print()\fR is a deprecated function which should be avoided; use
|
||||
@@ -114,7 +111,7 @@ using exactly four characters for the hex representation. If it is 32 bits then
|
||||
"\eWXXXXXXXX" is used using eight characters of its hex representation. These forms
|
||||
will only be used if UTF8 conversion is not set (see below).
|
||||
.PP
|
||||
Printable characters are normally escaped using the backslash \*(Aq\e\*(Aq character. If
|
||||
Printable characters are normally escaped using the backslash '\e' character. If
|
||||
\&\fBASN1_STRFLGS_ESC_QUOTE\fR is set then the whole string is instead surrounded by
|
||||
double quote characters: this is arguably more readable than the backslash
|
||||
notation. Other characters use the "\eXX" using exactly two characters of the hex
|
||||
@@ -156,7 +153,7 @@ characters written or \-1 if an error occurred.
|
||||
.PP
|
||||
\&\fBASN1_STRING_print()\fR returns 1 on success or 0 on error.
|
||||
.PP
|
||||
\&\fBASN1_tag2str()\fR returns a human\-readable name of the specified ASN.1 \fItag\fR.
|
||||
\&\fBASN1_tag2str()\fR returns a human-readable name of the specified ASN.1 \fItag\fR.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fBX509_NAME_print_ex\fR\|(3),
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_TIME_SET 3ossl"
|
||||
.TH ASN1_TIME_SET 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_TIME_SET 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -278,7 +275,7 @@ return 1 if the time is successfully printed out and
|
||||
error occurred (invalid time format).
|
||||
.PP
|
||||
\&\fBASN1_TIME_diff()\fR returns 1 for success and 0 for failure. It can fail if the
|
||||
passed\-in time structure has invalid syntax, for example.
|
||||
passed-in time structure has invalid syntax, for example.
|
||||
.PP
|
||||
\&\fBASN1_TIME_cmp_time_t()\fR and \fBASN1_UTCTIME_cmp_time_t()\fR return \-1 if \fIs\fR is
|
||||
before \fIt\fR, 0 if \fIs\fR equals \fIt\fR, or 1 if \fIs\fR is after \fIt\fR. \-2 is returned
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_TYPE_GET 3ossl"
|
||||
.TH ASN1_TYPE_GET 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_TYPE_GET 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_AUX_CB 3ossl"
|
||||
.TH ASN1_AUX_CB 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_AUX_CB 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_GENERATE_NCONF 3ossl"
|
||||
.TH ASN1_GENERATE_NCONF 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_GENERATE_NCONF 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -237,7 +234,7 @@ SEQUENCE consisting of a BOOL an OID and a UTF8String:
|
||||
.PP
|
||||
This example produces an RSAPrivateKey structure, this is the
|
||||
key contained in the file client.pem in all OpenSSL distributions
|
||||
(note: the field names such as \*(Aqcoeff\*(Aq are ignored and are present just
|
||||
(note: the field names such as 'coeff' are ignored and are present just
|
||||
for clarity):
|
||||
.PP
|
||||
.Vb 3
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_ITEM_D2I_BIO 3ossl"
|
||||
.TH ASN1_ITEM_D2I_BIO 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_ITEM_D2I_BIO 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_ITEM_NEW 3ossl"
|
||||
.TH ASN1_ITEM_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_ITEM_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASN1_ITEM_SIGN 3ossl"
|
||||
.TH ASN1_ITEM_SIGN 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASN1_ITEM_SIGN 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -148,10 +145,10 @@ zero for failure.
|
||||
.PP
|
||||
All verify functions return 1 if the signature is valid and 0 if the signature
|
||||
check fails. If the signature could not be checked at all because it was
|
||||
ill\-formed or some other error occurred then \-1 is returned.
|
||||
ill-formed or some other error occurred then \-1 is returned.
|
||||
.SH EXAMPLES
|
||||
.IX Header "EXAMPLES"
|
||||
In the following example a \*(AqMyObject\*(Aq object is signed using the key contained
|
||||
In the following example a 'MyObject' object is signed using the key contained
|
||||
in an EVP_MD_CTX. The signature is written to MyObject.signature. The object is
|
||||
then output in DER format and then loaded back in and verified.
|
||||
.PP
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASYNC_WAIT_CTX_NEW 3ossl"
|
||||
.TH ASYNC_WAIT_CTX_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASYNC_WAIT_CTX_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -111,7 +108,7 @@ ASYNC_STATUS_EAGAIN
|
||||
For an overview of how asynchronous operations are implemented in OpenSSL see
|
||||
\&\fBASYNC_start_job\fR\|(3). An \fBASYNC_WAIT_CTX\fR object represents an asynchronous
|
||||
"session", i.e. a related set of crypto operations. For example in SSL terms
|
||||
this would have a one\-to\-one correspondence with an SSL connection.
|
||||
this would have a one-to-one correspondence with an SSL connection.
|
||||
.PP
|
||||
Application code must create an \fBASYNC_WAIT_CTX\fR using the \fBASYNC_WAIT_CTX_new()\fR
|
||||
function prior to calling \fBASYNC_start_job()\fR (see \fBASYNC_start_job\fR\|(3)). When
|
||||
@@ -125,7 +122,7 @@ is closed), application code cleans up with \fBASYNC_WAIT_CTX_free()\fR.
|
||||
Calling \fBASYNC_WAIT_CTX_get_all_fds()\fR and passing in a pointer to an
|
||||
\&\fBASYNC_WAIT_CTX\fR in the \fIctx\fR parameter will return the wait file descriptors
|
||||
associated with that job in \fI*fd\fR. The number of file descriptors returned will
|
||||
be stored in \fI*numfds\fR. It is the caller\*(Aqs responsibility to ensure that
|
||||
be stored in \fI*numfds\fR. It is the caller's responsibility to ensure that
|
||||
sufficient memory has been allocated in \fI*fd\fR to receive all the file
|
||||
descriptors. Calling \fBASYNC_WAIT_CTX_get_all_fds()\fR with a NULL \fIfd\fR value will
|
||||
return no file descriptors but will still populate \fI*numfds\fR. Therefore,
|
||||
@@ -249,7 +246,7 @@ On Windows platforms the \fI<openssl/async.h>\fR header is dependent on some
|
||||
of the types customarily made available by including \fI<windows.h>\fR. The
|
||||
application developer is likely to require control over when the latter
|
||||
is included, commonly as one of the first included headers. Therefore,
|
||||
it is defined as an application developer\*(Aqs responsibility to include
|
||||
it is defined as an application developer's responsibility to include
|
||||
\&\fI<windows.h>\fR prior to \fI<openssl/async.h>\fR.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "ASYNC_START_JOB 3ossl"
|
||||
.TH ASYNC_START_JOB 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH ASYNC_START_JOB 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -100,16 +97,16 @@ ASYNC_stack_alloc_fn, ASYNC_stack_free_fn, ASYNC_set_mem_functions, ASYNC_get_me
|
||||
OpenSSL implements asynchronous capabilities through an \fBASYNC_JOB\fR. This
|
||||
represents code that can be started and executes until some event occurs. At
|
||||
that point the code can be paused and control returns to user code until some
|
||||
subsequent event indicates that the job can be resumed. It\*(Aqs OpenSSL
|
||||
subsequent event indicates that the job can be resumed. It's OpenSSL
|
||||
specific implementation of cooperative multitasking.
|
||||
.PP
|
||||
The creation of an \fBASYNC_JOB\fR is a relatively expensive operation. Therefore,
|
||||
for efficiency reasons, jobs can be created up front and reused many times. They
|
||||
are held in a pool until they are needed, at which point they are removed from
|
||||
the pool, used, and then returned to the pool when the job completes. If the
|
||||
user application is multi\-threaded, then \fBASYNC_init_thread()\fR may be called for
|
||||
user application is multi-threaded, then \fBASYNC_init_thread()\fR may be called for
|
||||
each thread that will initiate asynchronous jobs. Before
|
||||
user code exits per\-thread resources need to be cleaned up. This will normally
|
||||
user code exits per-thread resources need to be cleaned up. This will normally
|
||||
occur automatically (see \fBOPENSSL_init_crypto\fR\|(3)) but may be explicitly
|
||||
initiated by using \fBASYNC_cleanup_thread()\fR. No asynchronous jobs must be
|
||||
outstanding for the thread when \fBASYNC_cleanup_thread()\fR is called. Failing to
|
||||
@@ -198,7 +195,7 @@ The \fBASYNC_block_pause()\fR function will prevent the currently active job fro
|
||||
pausing. The block will remain in place until a subsequent call to
|
||||
\&\fBASYNC_unblock_pause()\fR. These functions can be nested, e.g. if you call
|
||||
\&\fBASYNC_block_pause()\fR twice then you must call \fBASYNC_unblock_pause()\fR twice in
|
||||
order to re\-enable pausing. If these functions are called while there is no
|
||||
order to re-enable pausing. If these functions are called while there is no
|
||||
currently active job then they have no effect. This functionality can be useful
|
||||
to avoid deadlock scenarios. For example during the execution of an \fBASYNC_JOB\fR
|
||||
an application acquires a lock. It then calls some cryptographic function which
|
||||
@@ -218,7 +215,7 @@ stack memory such as mmap, or using stack memory from the current thread.
|
||||
Using an ASYNC_stack_alloc_fn callback also allows manipulation of the stack
|
||||
size, which defaults to 32k.
|
||||
The stack size can be altered by allocating a stack of a size different to
|
||||
the requested size, and passing back the new stack size in the callback\*(Aqs \fI*num\fR
|
||||
the requested size, and passing back the new stack size in the callback's \fI*num\fR
|
||||
parameter.
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
@@ -247,7 +244,7 @@ On Windows platforms the \fI<openssl/async.h>\fR header is dependent on some
|
||||
of the types customarily made available by including \fI<windows.h>\fR. The
|
||||
application developer is likely to require control over when the latter
|
||||
is included, commonly as one of the first included headers. Therefore,
|
||||
it is defined as an application developer\*(Aqs responsibility to include
|
||||
it is defined as an application developer's responsibility to include
|
||||
\&\fI<windows.h>\fR prior to \fI<openssl/async.h>\fR.
|
||||
.SH EXAMPLES
|
||||
.IX Header "EXAMPLES"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BF_ENCRYPT 3ossl"
|
||||
.TH BF_ENCRYPT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BF_ENCRYPT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -128,7 +125,7 @@ The mode functions \fBBF_cbc_encrypt()\fR, \fBBF_cfb64_encrypt()\fR and \fBBF_of
|
||||
all operate on variable length data. They all take an initialization vector
|
||||
\&\fBivec\fR which needs to be passed along into the next call of the same function
|
||||
for the same message. \fBivec\fR may be initialized with anything, but the
|
||||
recipient needs to know what it was initialized with, or it won\*(Aqt be able
|
||||
recipient needs to know what it was initialized with, or it won't be able
|
||||
to decrypt. Some programs and protocols simplify this, like SSH, where
|
||||
\&\fBivec\fR is simply initialized to zero.
|
||||
\&\fBBF_cbc_encrypt()\fR operates on data that is a multiple of 8 bytes long, while
|
||||
@@ -159,10 +156,10 @@ the same way.
|
||||
\&\fBBF_encrypt()\fR and \fBBF_decrypt()\fR are the lowest level functions for Blowfish
|
||||
encryption. They encrypt/decrypt the first 64 bits of the vector pointed by
|
||||
\&\fBdata\fR, using the key \fBkey\fR. These functions should not be used unless you
|
||||
implement \*(Aqmodes\*(Aq of Blowfish. The alternative is to use \fBBF_ecb_encrypt()\fR.
|
||||
implement 'modes' of Blowfish. The alternative is to use \fBBF_ecb_encrypt()\fR.
|
||||
If you still want to use these functions, you should be aware that they take
|
||||
each 32\-bit chunk in host\-byte order, which is little\-endian on little\-endian
|
||||
platforms and big\-endian on big\-endian ones.
|
||||
each 32\-bit chunk in host-byte order, which is little-endian on little-endian
|
||||
platforms and big-endian on big-endian ones.
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
None of the functions presented here return any value.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_ADDR 3ossl"
|
||||
.TH BIO_ADDR 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_ADDR 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -95,7 +92,7 @@ BIO_ADDR_path_string \- BIO_ADDR routines
|
||||
.IX Header "DESCRIPTION"
|
||||
The \fBBIO_ADDR\fR type is a wrapper around all types of socket
|
||||
addresses that OpenSSL deals with, currently transparently
|
||||
supporting AF_INET, AF_INET6 and AF_UNIX according to what\*(Aqs
|
||||
supporting AF_INET, AF_INET6 and AF_UNIX according to what's
|
||||
available on the platform at hand.
|
||||
.PP
|
||||
\&\fBBIO_ADDR_new()\fR creates a new unfilled \fBBIO_ADDR\fR, to be used
|
||||
@@ -125,14 +122,14 @@ NUL, such as the result of a call to \fBstrlen()\fR).
|
||||
Read on about the addresses in "RAW ADDRESSES" below.
|
||||
.PP
|
||||
\&\fBBIO_ADDR_family()\fR returns the protocol family of the given
|
||||
\&\fBBIO_ADDR\fR. The possible non\-error results are one of the
|
||||
\&\fBBIO_ADDR\fR. The possible non-error results are one of the
|
||||
constants AF_INET, AF_INET6 and AF_UNIX. It will also return AF_UNSPEC if the
|
||||
BIO_ADDR has not been initialised.
|
||||
.PP
|
||||
\&\fBBIO_ADDR_rawaddress()\fR will write the raw address of the given
|
||||
\&\fBBIO_ADDR\fR in the area pointed at by \fBp\fR if \fBp\fR is non\-NULL,
|
||||
\&\fBBIO_ADDR\fR in the area pointed at by \fBp\fR if \fBp\fR is non-NULL,
|
||||
and will set \fB*l\fR to be the amount of bytes the raw address
|
||||
takes up if \fBl\fR is non\-NULL.
|
||||
takes up if \fBl\fR is non-NULL.
|
||||
A technique to only find out the size of the address is a call
|
||||
with \fBp\fR set to \fBNULL\fR. The raw address will be in network byte
|
||||
order, most significant byte first.
|
||||
@@ -179,7 +176,7 @@ OpenSSL error stack.
|
||||
\&\fBBIO_ADDR_copy()\fR returns 1 on success or 0 on error.
|
||||
.PP
|
||||
All other functions described here return 0 or \fBNULL\fR when the
|
||||
information they should return isn\*(Aqt available.
|
||||
information they should return isn't available.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fBBIO_connect\fR\|(3), \fBBIO_s_connect\fR\|(3)
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_ADDRINFO 3ossl"
|
||||
.TH BIO_ADDRINFO 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_ADDRINFO 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -148,7 +145,7 @@ occurred, and will leave an error indication on the OpenSSL error stack in that
|
||||
case.
|
||||
.PP
|
||||
All other functions described here return 0 or \fBNULL\fR when the
|
||||
information they should return isn\*(Aqt available.
|
||||
information they should return isn't available.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
The \fBBIO_lookup_ex()\fR implementation uses the platform provided \fBgetaddrinfo()\fR
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_CONNECT 3ossl"
|
||||
.TH BIO_CONNECT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_CONNECT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -101,7 +98,7 @@ The flags are described in "FLAGS" below.
|
||||
.PP
|
||||
\&\fBBIO_accept_ex()\fR waits for an incoming connections on the given
|
||||
socket \fBaccept_sock\fR. When it gets a connection, the address and
|
||||
port of the peer gets stored in \fBpeer\fR if that one is non\-NULL.
|
||||
port of the peer gets stored in \fBpeer\fR if that one is non-NULL.
|
||||
Accept \fBoptions\fR may be zero or \fBBIO_SOCK_NONBLOCK\fR, and is applied
|
||||
on the accepted socket. The flags are described in "FLAGS" below.
|
||||
.PP
|
||||
@@ -110,7 +107,7 @@ on the accepted socket. The flags are described in "FLAGS" below.
|
||||
.IX Header "FLAGS"
|
||||
.IP BIO_SOCK_KEEPALIVE 4
|
||||
.IX Item "BIO_SOCK_KEEPALIVE"
|
||||
Enables regular sending of keep\-alive messages.
|
||||
Enables regular sending of keep-alive messages.
|
||||
.IP BIO_SOCK_NONBLOCK 4
|
||||
.IX Item "BIO_SOCK_NONBLOCK"
|
||||
Sets the socket to nonblocking mode.
|
||||
@@ -118,7 +115,7 @@ Sets the socket to nonblocking mode.
|
||||
.IX Item "BIO_SOCK_NODELAY"
|
||||
Corresponds to \fBTCP_NODELAY\fR, and disables the Nagle algorithm. With
|
||||
this set, any data will be sent as soon as possible instead of being
|
||||
buffered until there\*(Aqs enough for the socket to send out in one go.
|
||||
buffered until there's enough for the socket to send out in one go.
|
||||
.IP BIO_SOCK_REUSEADDR 4
|
||||
.IX Item "BIO_SOCK_REUSEADDR"
|
||||
Try to reuse the address and port combination for a recently closed
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_CTRL 3ossl"
|
||||
.TH BIO_CTRL 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_CTRL 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -119,7 +116,7 @@ calls.
|
||||
of file related BIOs for example it rewinds the file pointer to the
|
||||
start of the file.
|
||||
.PP
|
||||
\&\fBBIO_seek()\fR resets a file related BIO\*(Aqs (that is file descriptor and
|
||||
\&\fBBIO_seek()\fR resets a file related BIO's (that is file descriptor and
|
||||
FILE BIOs) file position pointer to \fBofs\fR bytes from start of file.
|
||||
.PP
|
||||
\&\fBBIO_tell()\fR returns the current file position of a file related BIO.
|
||||
@@ -143,9 +140,9 @@ Not all BIOs support these calls. \fBBIO_ctrl_pending()\fR and \fBBIO_ctrl_wpend
|
||||
return a size_t type and are functions, \fBBIO_pending()\fR and \fBBIO_wpending()\fR are
|
||||
macros which call \fBBIO_ctrl()\fR.
|
||||
.PP
|
||||
\&\fBBIO_get_ktls_send()\fR returns 1 if the BIO is using the Kernel TLS data\-path for
|
||||
\&\fBBIO_get_ktls_send()\fR returns 1 if the BIO is using the Kernel TLS data-path for
|
||||
sending. Otherwise, it returns zero.
|
||||
\&\fBBIO_get_ktls_recv()\fR returns 1 if the BIO is using the Kernel TLS data\-path for
|
||||
\&\fBBIO_get_ktls_recv()\fR returns 1 if the BIO is using the Kernel TLS data-path for
|
||||
receiving. Otherwise, it returns zero.
|
||||
.PP
|
||||
\&\fBBIO_get_conn_mode()\fR returns the BIO connection mode. \fBBIO_set_conn_mode()\fR sets
|
||||
@@ -177,13 +174,13 @@ return the amount of pending data. \fBBIO_pending()\fR and \fBBIO_wpending()\fR
|
||||
negative value or 0 on error. \fBBIO_ctrl_pending()\fR and \fBBIO_ctrl_wpending()\fR return
|
||||
0 on error.
|
||||
.PP
|
||||
\&\fBBIO_get_ktls_send()\fR returns 1 if the BIO is using the Kernel TLS data\-path for
|
||||
\&\fBBIO_get_ktls_send()\fR returns 1 if the BIO is using the Kernel TLS data-path for
|
||||
sending. Otherwise, it returns zero.
|
||||
\&\fBBIO_get_ktls_recv()\fR returns 1 if the BIO is using the Kernel TLS data\-path for
|
||||
\&\fBBIO_get_ktls_recv()\fR returns 1 if the BIO is using the Kernel TLS data-path for
|
||||
receiving. Otherwise, it returns zero.
|
||||
.PP
|
||||
\&\fBBIO_set_conn_mode()\fR returns 1 for success and 0 for failure. \fBBIO_get_conn_mode()\fR
|
||||
returns the current connection mode. Which may contain the bitwise\-or of the
|
||||
returns the current connection mode. Which may contain the bitwise-or of the
|
||||
following flags:
|
||||
.PP
|
||||
.Vb 6
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_BASE64 3ossl"
|
||||
.TH BIO_F_BASE64 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_BASE64 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -96,7 +93,7 @@ skipped, as are lines longer than 1024 bytes.
|
||||
Decoding starts with the first line that is shorter than 1024 bytes (including
|
||||
the newline) and consists of only (at least one) valid base64 characters plus
|
||||
optional whitespace.
|
||||
Decoding stops when base64 padding is encountered, a soft end\-of\-input
|
||||
Decoding stops when base64 padding is encountered, a soft end-of-input
|
||||
character (\fB\-\fR, see \fBEVP_DecodeUpdate\fR\|(3)) occurs as the first byte after a
|
||||
complete group of 4 valid base64 characters is decoded, or when an error occurs
|
||||
(e.g. due to input characters other than valid base64 or whitespace).
|
||||
@@ -160,12 +157,12 @@ data to standard output:
|
||||
.Ve
|
||||
.SH BUGS
|
||||
.IX Header "BUGS"
|
||||
The hyphen character (\fB\-\fR) is treated as an ad hoc soft end\-of\-input
|
||||
The hyphen character (\fB\-\fR) is treated as an ad hoc soft end-of-input
|
||||
character when it occurs at the start of a base64 group of 4 encoded
|
||||
characters.
|
||||
.PP
|
||||
This heuristic works to detect the ends of base64 blocks in PEM or
|
||||
multi\-part MIME, provided there are no stray hyphens in the middle
|
||||
multi-part MIME, provided there are no stray hyphens in the middle
|
||||
input.
|
||||
But it is just a heuristic, and sufficiently unusual input could produce
|
||||
unexpected results.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_BUFFER 3ossl"
|
||||
.TH BIO_F_BUFFER 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_BUFFER 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -115,7 +112,7 @@ Buffering BIOs implement \fBBIO_read_ex()\fR and \fBBIO_gets()\fR by using
|
||||
result in an internal buffer, from which bytes are given back to the
|
||||
caller as appropriate for the call; a \fBBIO_gets()\fR is guaranteed to give
|
||||
the caller a whole line, and \fBBIO_read_ex()\fR is guaranteed to give the
|
||||
caller the number of bytes it asks for, unless there\*(Aqs an error or end
|
||||
caller the number of bytes it asks for, unless there's an error or end
|
||||
of communication is reached in the next BIO. By prepending a
|
||||
buffering BIO to a chain it is therefore possible to provide
|
||||
\&\fBBIO_gets()\fR or exact size \fBBIO_read_ex()\fR functionality if the following
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_CIPHER 3ossl"
|
||||
.TH BIO_F_CIPHER 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_CIPHER 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_MD 3ossl"
|
||||
.TH BIO_F_MD 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_MD 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_NULL 3ossl"
|
||||
.TH BIO_F_NULL 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_NULL 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_PREFIX 3ossl"
|
||||
.TH BIO_F_PREFIX 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_PREFIX 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -91,7 +88,7 @@ By default, there is no prefix, and indentation is set to 0.
|
||||
.PP
|
||||
\&\fBBIO_set_prefix()\fR sets the prefix to be used for future lines of
|
||||
text, using \fIprefix\fR. \fIprefix\fR may be NULL, signifying that there
|
||||
should be no prefix. If \fIprefix\fR isn\*(Aqt NULL, this function makes a
|
||||
should be no prefix. If \fIprefix\fR isn't NULL, this function makes a
|
||||
copy of it.
|
||||
.PP
|
||||
\&\fBBIO_set_indent()\fR sets the indentation to be used for future lines of
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_READBUFFER 3ossl"
|
||||
.TH BIO_F_READBUFFER 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_READBUFFER 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -77,7 +74,7 @@ BIO_f_readbuffer
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBIO_f_readbuffer()\fR returns the read buffering BIO method.
|
||||
.PP
|
||||
This BIO filter can be inserted on top of BIO\*(Aqs that do not support \fBBIO_tell()\fR
|
||||
This BIO filter can be inserted on top of BIO's that do not support \fBBIO_tell()\fR
|
||||
or \fBBIO_seek()\fR (e.g. A file BIO that uses stdin).
|
||||
.PP
|
||||
Data read from a read buffering BIO comes from an internal buffer which is
|
||||
@@ -93,7 +90,7 @@ Read buffering BIOs implement \fBBIO_read_ex()\fR by using \fBBIO_read_ex()\fR o
|
||||
on the next BIO (e.g. a file BIO) in the chain and storing the result in an
|
||||
internal buffer, from which bytes are given back to the caller as appropriate
|
||||
for the call. \fBBIO_read_ex()\fR is guaranteed to give the caller the number of bytes
|
||||
it asks for, unless there\*(Aqs an error or end of communication is reached in the
|
||||
it asks for, unless there's an error or end of communication is reached in the
|
||||
next BIO. The internal buffer can grow to cache the entire contents of the next
|
||||
BIO in the chain. \fBBIO_seek()\fR uses the internal buffer, so that it can only seek
|
||||
into data that is already read.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_F_SSL 3ossl"
|
||||
.TH BIO_F_SSL 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_F_SSL 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -156,7 +153,7 @@ pointer.
|
||||
.PP
|
||||
\&\fBBIO_do_handshake()\fR attempts to complete an SSL handshake on the
|
||||
supplied BIO and establish the SSL connection.
|
||||
For non\-SSL BIOs the connection is done typically at TCP level.
|
||||
For non-SSL BIOs the connection is done typically at TCP level.
|
||||
If domain name resolution yields multiple IP addresses all of them are tried
|
||||
after \fBconnect()\fR failures.
|
||||
The function returns 1 if the connection was established successfully.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_FIND_TYPE 3ossl"
|
||||
.TH BIO_FIND_TYPE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_FIND_TYPE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_GET_DATA 3ossl"
|
||||
.TH BIO_GET_DATA 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_GET_DATA 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_GET_EX_NEW_INDEX 3ossl"
|
||||
.TH BIO_GET_EX_NEW_INDEX 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_GET_EX_NEW_INDEX 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -144,7 +141,7 @@ Applications should instead use \fBEVP_PKEY_set_ex_data()\fR,
|
||||
All functions with a \fITYPE\fR of \fBENGINE\fR are deprecated.
|
||||
Applications using engines should be replaced by providers.
|
||||
.PP
|
||||
These functions handle application\-specific data for OpenSSL data
|
||||
These functions handle application-specific data for OpenSSL data
|
||||
structures.
|
||||
.PP
|
||||
\&\fBTYPE_get_ex_new_index()\fR is a macro that calls \fBCRYPTO_get_ex_new_index()\fR
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_GET_RPOLL_DESCRIPTOR 3ossl"
|
||||
.TH BIO_GET_RPOLL_DESCRIPTOR 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_GET_RPOLL_DESCRIPTOR 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -87,7 +84,7 @@ can be used to determine when a BIO object can next be read or written
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBIO_get_rpoll_descriptor()\fR and \fBBIO_get_wpoll_descriptor()\fR, on success, fill
|
||||
\&\fI*desc\fR with a poll descriptor. A poll descriptor is a tagged union structure
|
||||
which represents some kind of OS or non\-OS resource which can be used to
|
||||
which represents some kind of OS or non-OS resource which can be used to
|
||||
synchronise on I/O availability events.
|
||||
.PP
|
||||
\&\fBBIO_get_rpoll_descriptor()\fR outputs a descriptor which can be used to determine
|
||||
@@ -118,7 +115,7 @@ in the \fBBIO_POLL_DESCRIPTOR\fR is valid if it is not set to \-1.
|
||||
.Sp
|
||||
The resource is whatever kind of handle is used by a given OS to represent
|
||||
sockets, which may vary by OS. For example, on Windows, the value is a \fBSOCKET\fR
|
||||
for use with the Winsock API. On POSIX\-like platforms, it is a file descriptor.
|
||||
for use with the Winsock API. On POSIX-like platforms, it is a file descriptor.
|
||||
.Sp
|
||||
Where a poll descriptor of this type is output by \fBBIO_get_rpoll_descriptor()\fR, it
|
||||
should be polled for readability to determine when the BIO might next be able to
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_METH_NEW 3ossl"
|
||||
.TH BIO_METH_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_METH_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -247,7 +244,7 @@ The \fBBIO_meth_get\fR functions return the corresponding function pointers.
|
||||
.IX Header "BUGS"
|
||||
It is not safe to use \f(CW\*(C`BIO_meth_get_\*(C'\fR functions to reuse the \fBBIO\fR
|
||||
implementation of \fBBIO\fRs implemented by OpenSSL itself with
|
||||
application\-implemented \fBBIO\fRs. Instead either the applications ought to
|
||||
application-implemented \fBBIO\fRs. Instead either the applications ought to
|
||||
implement these functions themselves or they should implement a filter BIO.
|
||||
.PP
|
||||
For more details please see <https://github.com/openssl/openssl/issues/26047>.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_NEW 3ossl"
|
||||
.TH BIO_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_NEW_CMS 3ossl"
|
||||
.TH BIO_NEW_CMS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_NEW_CMS 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_PARSE_HOSTSERV 3ossl"
|
||||
.TH BIO_PARSE_HOSTSERV 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_PARSE_HOSTSERV 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -99,8 +96,8 @@ The syntax the \fBBIO_parse_hostserv()\fR recognises is:
|
||||
\& service
|
||||
.Ve
|
||||
.PP
|
||||
The host part can be a name or an IP address. If it\*(Aqs a IPv6
|
||||
address, it MUST be enclosed in brackets, such as \*(Aq[::1]\*(Aq.
|
||||
The host part can be a name or an IP address. If it's a IPv6
|
||||
address, it MUST be enclosed in brackets, such as '[::1]'.
|
||||
.PP
|
||||
The service part can be a service name or its port number. A service name
|
||||
will be mapped to a port number using the system function \fBgetservbyname()\fR.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_PRINTF 3ossl"
|
||||
.TH BIO_PRINTF 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_PRINTF 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_PUSH 3ossl"
|
||||
.TH BIO_PUSH 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_PUSH 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_READ 3ossl"
|
||||
.TH BIO_READ 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_READ 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_ACCEPT 3ossl"
|
||||
.TH BIO_S_ACCEPT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_ACCEPT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -101,7 +98,7 @@ BIO_set_bind_mode, BIO_get_bind_mode, BIO_do_accept \- accept BIO
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBIO_s_accept()\fR returns the accept BIO method. This is a wrapper
|
||||
round the platform\*(Aqs TCP/IP socket accept routines.
|
||||
round the platform's TCP/IP socket accept routines.
|
||||
.PP
|
||||
Using accept BIOs, TCP/IP connections can be accepted and data
|
||||
transferred using only BIO routines. In this way any platform
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_BIO 3ossl"
|
||||
.TH BIO_S_BIO 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_BIO 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_CONNECT 3ossl"
|
||||
.TH BIO_S_CONNECT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_CONNECT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -100,7 +97,7 @@ BIO_do_connect \- connect BIO
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBIO_s_connect()\fR returns the connect BIO method. This is a wrapper
|
||||
round the platform\*(Aqs TCP/IP socket connection routines.
|
||||
round the platform's TCP/IP socket connection routines.
|
||||
.PP
|
||||
Using connect BIOs, TCP/IP connections can be made and data
|
||||
transferred using only BIO routines. In this way any platform
|
||||
@@ -159,7 +156,7 @@ non blocking I/O is set during the connect process.
|
||||
.PP
|
||||
\&\fBBIO_do_connect()\fR attempts to connect the supplied BIO.
|
||||
This performs an SSL/TLS handshake as far as supported by the BIO.
|
||||
For non\-SSL BIOs the connection is done typically at TCP level.
|
||||
For non-SSL BIOs the connection is done typically at TCP level.
|
||||
If domain name resolution yields multiple IP addresses all of them are tried
|
||||
after \fBconnect()\fR failures.
|
||||
The function returns 1 if the connection was established successfully.
|
||||
@@ -189,7 +186,7 @@ will normally mean that the connection was closed.
|
||||
If the port name is supplied as part of the hostname then this will
|
||||
override any value set with \fBBIO_set_conn_port()\fR. This may be undesirable
|
||||
if the application does not wish to allow connection to arbitrary
|
||||
ports. This can be avoided by checking for the presence of the \*(Aq:\*(Aq
|
||||
ports. This can be avoided by checking for the presence of the ':'
|
||||
character in the passed hostname and either indicating an error or
|
||||
truncating the string at that point.
|
||||
.PP
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_CORE 3ossl"
|
||||
.TH BIO_S_CORE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_CORE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_DATAGRAM 3ossl"
|
||||
.TH BIO_S_DATAGRAM 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_DATAGRAM 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_DGRAM_PAIR 3ossl"
|
||||
.TH BIO_S_DGRAM_PAIR 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_DGRAM_PAIR 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -137,8 +134,8 @@ size of the next datagram waiting to be read in bytes. An application can use
|
||||
this function to ensure it provides an adequate buffer to a subsequent read
|
||||
call. If no datagram is waiting to be read, zero is returned.
|
||||
.PP
|
||||
This BIO does not support sending or receiving zero\-length datagrams. Passing a
|
||||
zero\-length buffer to BIO_write is treated as a no\-op.
|
||||
This BIO does not support sending or receiving zero-length datagrams. Passing a
|
||||
zero-length buffer to BIO_write is treated as a no-op.
|
||||
.PP
|
||||
\&\fBBIO_eof\fR\|(3) returns 1 only if the given BIO datagram pair BIO is not currently
|
||||
connected to a peer BIO.
|
||||
@@ -152,9 +149,9 @@ intending to write it to a BIO datagram pair, but where the received datagram
|
||||
ends up being too large to write to the BIO datagram pair.
|
||||
.PP
|
||||
\&\fBBIO_dgram_set_no_trunc()\fR and \fBBIO_ctrl_get_no_trunc()\fR set and retrieve the
|
||||
truncation mode for the given half of a BIO datagram pair. When no\-truncate mode
|
||||
truncation mode for the given half of a BIO datagram pair. When no-truncate mode
|
||||
is enabled, \fBBIO_read()\fR will fail if the buffer provided is inadequate to hold
|
||||
the next datagram to be read. If no\-truncate mode is disabled (the default), the
|
||||
the next datagram to be read. If no-truncate mode is disabled (the default), the
|
||||
datagram will be silently truncated. This default behaviour maintains
|
||||
compatibility with the semantics of the Berkeley sockets API.
|
||||
.PP
|
||||
@@ -174,7 +171,7 @@ explicitly specified local address takes precedence. The reference to the
|
||||
BIO_ADDR is passed to the BIO by this call and will be freed automatically when
|
||||
the BIO is freed.
|
||||
.PP
|
||||
\&\fBBIO_flush\fR\|(3) is a no\-op.
|
||||
\&\fBBIO_flush\fR\|(3) is a no-op.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
The halves of a BIO datagram pair have independent lifetimes and must be
|
||||
@@ -257,8 +254,8 @@ locations for \fBbio1\fR and \fBbio2\fR. Check the error stack for more informat
|
||||
\&\fBBIO_dgram_set_no_trunc()\fR, \fBBIO_dgram_set_caps()\fR and \fBBIO_dgram_set_mtu()\fR return 1
|
||||
on success and 0 on failure.
|
||||
.PP
|
||||
\&\fBBIO_dgram_get_no_trunc()\fR returns 1 if no\-truncate mode is enabled on a BIO, or 0
|
||||
if no\-truncate mode is not enabled or not supported on a given BIO.
|
||||
\&\fBBIO_dgram_get_no_trunc()\fR returns 1 if no-truncate mode is enabled on a BIO, or 0
|
||||
if no-truncate mode is not enabled or not supported on a given BIO.
|
||||
.PP
|
||||
\&\fBBIO_dgram_get_effective_caps()\fR and \fBBIO_dgram_get_caps()\fR return zero if no
|
||||
capabilities are supported.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_FD 3ossl"
|
||||
.TH BIO_S_FD 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_FD 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_FILE 3ossl"
|
||||
.TH BIO_S_FILE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_FILE 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_MEM 3ossl"
|
||||
.TH BIO_S_MEM 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_MEM 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_NULL 3ossl"
|
||||
.TH BIO_S_NULL 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_NULL 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_S_SOCKET 3ossl"
|
||||
.TH BIO_S_SOCKET 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_S_SOCKET 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -77,7 +74,7 @@ BIO_s_socket, BIO_new_socket \- socket BIO
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBIO_s_socket()\fR returns the socket BIO method. This is a wrapper
|
||||
round the platform\*(Aqs socket routines.
|
||||
round the platform's socket routines.
|
||||
.PP
|
||||
\&\fBBIO_read_ex()\fR and \fBBIO_write_ex()\fR read or write the underlying socket.
|
||||
\&\fBBIO_puts()\fR is supported but \fBBIO_gets()\fR is not.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_SENDMMSG 3ossl"
|
||||
.TH BIO_SENDMMSG 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_SENDMMSG 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -108,14 +105,14 @@ The caller should set the \fIdata\fR member of a \fBBIO_MSG\fR to a buffer conta
|
||||
the data to send, or to be filled with a received message. \fIdata_len\fR should be
|
||||
set to the size of the buffer in bytes. If the given \fBBIO_MSG\fR is processed (in
|
||||
other words, if the integer returned by the function is greater than or equal to
|
||||
that \fBBIO_MSG\fR\*(Aqs array index), \fIdata_len\fR will be modified to specify the
|
||||
that \fBBIO_MSG\fR's array index), \fIdata_len\fR will be modified to specify the
|
||||
actual amount of data sent or received.
|
||||
.PP
|
||||
The \fIflags\fR field of a \fBBIO_MSG\fR provides input per\-message flags to the
|
||||
The \fIflags\fR field of a \fBBIO_MSG\fR provides input per-message flags to the
|
||||
invocation. If the invocation processes that \fBBIO_MSG\fR, the \fIflags\fR field is
|
||||
written with output per\-message flags, or zero if no such flags are applicable.
|
||||
written with output per-message flags, or zero if no such flags are applicable.
|
||||
.PP
|
||||
Currently, no input or output per\-message flags are defined and this field
|
||||
Currently, no input or output per-message flags are defined and this field
|
||||
should be set to zero before calling \fBBIO_sendmmsg()\fR or \fBBIO_recvmmsg()\fR.
|
||||
.PP
|
||||
The \fIflags\fR argument to \fBBIO_sendmmsg()\fR and \fBBIO_recvmmsg()\fR provides global
|
||||
@@ -124,47 +121,47 @@ defined and this argument should be set to zero.
|
||||
.PP
|
||||
When these functions are used to send and receive datagrams, the \fIpeer\fR field
|
||||
of a \fBBIO_MSG\fR allows the destination address of sent datagrams to be specified
|
||||
on a per\-datagram basis, and the source address of received datagrams to be
|
||||
on a per-datagram basis, and the source address of received datagrams to be
|
||||
determined. The \fIpeer\fR field should be set to point to a \fBBIO_ADDR\fR, which
|
||||
will be read by \fBBIO_sendmmsg()\fR and used as the destination address for sent
|
||||
datagrams, and written by \fBBIO_recvmmsg()\fR with the source address of received
|
||||
datagrams.
|
||||
.PP
|
||||
Similarly, the \fIlocal\fR field of a \fBBIO_MSG\fR allows the source address of sent
|
||||
datagrams to be specified on a per\-datagram basis, and the destination address
|
||||
datagrams to be specified on a per-datagram basis, and the destination address
|
||||
of received datagrams to be determined. Unlike \fIpeer\fR, support for \fIlocal\fR
|
||||
must be explicitly enabled on a \fBBIO\fR before it can be used; see
|
||||
\&\fBBIO_dgram_set_local_addr_enable()\fR. If \fIlocal\fR is non\-NULL in a \fBBIO_MSG\fR and
|
||||
\&\fBBIO_dgram_set_local_addr_enable()\fR. If \fIlocal\fR is non-NULL in a \fBBIO_MSG\fR and
|
||||
support for \fIlocal\fR has not been enabled, processing of that \fBBIO_MSG\fR fails.
|
||||
.PP
|
||||
\&\fIpeer\fR and \fIlocal\fR should be set to NULL if they are not required. Support for
|
||||
\&\fIlocal\fR may not be available on all platforms; on these platforms, these
|
||||
functions always fail if \fIlocal\fR is non\-NULL.
|
||||
functions always fail if \fIlocal\fR is non-NULL.
|
||||
.PP
|
||||
If \fIlocal\fR is specified and local address support is enabled, but the operating
|
||||
system does not report a local address for a specific received message, the
|
||||
\&\fBBIO_ADDR\fR it points to will be cleared (address family set to \f(CW\*(C`AF_UNSPEC\*(C'\fR).
|
||||
This is known to happen on Windows when a packet is received which was sent by
|
||||
the local system, regardless of whether the packet\*(Aqs destination address was the
|
||||
loopback address or the IP address of a local non\-loopback interface. This is
|
||||
the local system, regardless of whether the packet's destination address was the
|
||||
loopback address or the IP address of a local non-loopback interface. This is
|
||||
also known to happen on macOS in some circumstances, such as for packets sent
|
||||
before local address support was enabled for a receiving socket. These are
|
||||
OS\-specific limitations. As such, users of this API using local address support
|
||||
OS-specific limitations. As such, users of this API using local address support
|
||||
should expect to sometimes receive a cleared local \fBBIO_ADDR\fR instead of the
|
||||
correct value.
|
||||
.PP
|
||||
The \fIstride\fR argument must be set to \f(CWsizeof(BIO_MSG)\fR. This argument
|
||||
facilitates backwards compatibility if fields are added to \fBBIO_MSG\fR. Callers
|
||||
must zero\-initialize \fBBIO_MSG\fR.
|
||||
must zero-initialize \fBBIO_MSG\fR.
|
||||
.PP
|
||||
\&\fInum_msg\fR should be sent to the maximum number of messages to send or receive,
|
||||
which is also the length of the array pointed to by \fImsg\fR.
|
||||
.PP
|
||||
\&\fImsgs_processed\fR must be non\-NULL and points to an integer written with the
|
||||
\&\fImsgs_processed\fR must be non-NULL and points to an integer written with the
|
||||
number of messages successfully processed; see the RETURN VALUES section for
|
||||
further discussion.
|
||||
.PP
|
||||
Unlike most BIO functions, these functions explicitly support multi\-threaded
|
||||
Unlike most BIO functions, these functions explicitly support multi-threaded
|
||||
use. Multiple concurrent writers and multiple concurrent readers of the same BIO
|
||||
are permitted in any combination. As such, these functions do not clear, set, or
|
||||
otherwise modify BIO retry flags. The return value must be used to determine
|
||||
@@ -189,7 +186,7 @@ which is transient in nature.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
Some implementations of the \fBBIO_sendmmsg()\fR and \fBBIO_recvmmsg()\fR BIO methods might
|
||||
always process at most one message at a time, for example when OS\-level
|
||||
always process at most one message at a time, for example when OS-level
|
||||
functionality to transmit or receive multiple messages at a time is not
|
||||
available.
|
||||
.SH "RETURN VALUES"
|
||||
@@ -200,7 +197,7 @@ the number of messages successfully processed (which need not be nonzero) to
|
||||
entries in the \fBBIO_MSG\fR array from 0 through n\-1 inclusive have their
|
||||
\&\fIdata_len\fR and \fIflags\fR fields updated with the results of the operation on
|
||||
that message. If the call was to \fBBIO_recvmmsg()\fR and the \fIpeer\fR or \fIlocal\fR
|
||||
fields of that message are non\-NULL, the \fBBIO_ADDR\fR structures they point to
|
||||
fields of that message are non-NULL, the \fBBIO_ADDR\fR structures they point to
|
||||
are written with the relevant address.
|
||||
.PP
|
||||
On failure, the functions \fBBIO_sendmmsg()\fR and \fBBIO_recvmmsg()\fR return 0 and write
|
||||
@@ -212,35 +209,35 @@ error using \fBERR_raise\fR\|(3). Any error may be raised, but the following in
|
||||
particular may be noted:
|
||||
.IP \fBBIO_R_LOCAL_ADDR_NOT_AVAILABLE\fR 2
|
||||
.IX Item "BIO_R_LOCAL_ADDR_NOT_AVAILABLE"
|
||||
The \fIlocal\fR field was set to a non\-NULL value, but local address support is not
|
||||
The \fIlocal\fR field was set to a non-NULL value, but local address support is not
|
||||
available or not enabled on the BIO.
|
||||
.IP \fBBIO_R_PEER_ADDR_NOT_AVAILABLE\fR 2
|
||||
.IX Item "BIO_R_PEER_ADDR_NOT_AVAILABLE"
|
||||
The \fIpeer\fR field was set to a non\-NULL value, but peer address support is not
|
||||
The \fIpeer\fR field was set to a non-NULL value, but peer address support is not
|
||||
available on the BIO.
|
||||
.IP \fBBIO_R_UNSUPPORTED_METHOD\fR 2
|
||||
.IX Item "BIO_R_UNSUPPORTED_METHOD"
|
||||
The \fBBIO_sendmmsg()\fR or \fBBIO_recvmmsg()\fR method is not supported on the BIO.
|
||||
.IP \fBBIO_R_NON_FATAL\fR 2
|
||||
.IX Item "BIO_R_NON_FATAL"
|
||||
The call failed due to a transient, non\-fatal error (for example, because the
|
||||
The call failed due to a transient, non-fatal error (for example, because the
|
||||
BIO is in nonblocking mode and the call would otherwise have blocked).
|
||||
.Sp
|
||||
Implementations of this interface which do not make system calls and thereby
|
||||
pass through system error codes using \fBERR_LIB_SYS\fR (for example, memory\-based
|
||||
pass through system error codes using \fBERR_LIB_SYS\fR (for example, memory-based
|
||||
implementations) should issue this reason code to indicate a transient failure.
|
||||
However, users of this interface should not test for this reason code directly,
|
||||
as there are multiple possible packed error codes representing a transient
|
||||
failure; use \fBBIO_err_is_non_fatal()\fR instead (discussed below).
|
||||
.IP "Socket errors" 2
|
||||
.IX Item "Socket errors"
|
||||
OS\-level socket errors are reported using an error with library code
|
||||
OS-level socket errors are reported using an error with library code
|
||||
\&\fBERR_LIB_SYS\fR; for a packed error code \fBerrcode\fR where
|
||||
\&\f(CW\*(C`ERR_SYSTEM_ERROR(errcode) == 1\*(C'\fR, the OS\-level socket error code can be
|
||||
\&\f(CW\*(C`ERR_SYSTEM_ERROR(errcode) == 1\*(C'\fR, the OS-level socket error code can be
|
||||
retrieved using \f(CWERR_GET_REASON(errcode)\fR. The packed error code can be
|
||||
retrieved by calling \fBERR_peek_last_error\fR\|(3) after the call to \fBBIO_sendmmsg()\fR
|
||||
or \fBBIO_recvmmsg()\fR returns 0.
|
||||
.IP "Non\-fatal errors" 2
|
||||
.IP "Non-fatal errors" 2
|
||||
.IX Item "Non-fatal errors"
|
||||
Whether an error is transient can be determined by passing the packed error code
|
||||
to \fBBIO_err_is_non_fatal()\fR. Callers should do this instead of testing the reason
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_SET_CALLBACK 3ossl"
|
||||
.TH BIO_SET_CALLBACK 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_SET_CALLBACK 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -109,7 +106,7 @@ see \fBopenssl_user_macros\fR\|(7):
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBIO_set_callback_ex()\fR and \fBBIO_get_callback_ex()\fR set and retrieve the BIO
|
||||
callback. The callback is called during most high\-level BIO operations. It can
|
||||
callback. The callback is called during most high-level BIO operations. It can
|
||||
be used for debugging purposes to trace operations on a BIO or to modify its
|
||||
operation.
|
||||
.PP
|
||||
@@ -138,7 +135,7 @@ The BIO the callback is attached to is passed in \fBb\fR.
|
||||
.IX Item "oper"
|
||||
\&\fBoper\fR is set to the operation being performed. For some operations
|
||||
the callback is called twice, once before and once after the actual
|
||||
operation, the latter case has \fBoper\fR or\*(Aqed with BIO_CB_RETURN.
|
||||
operation, the latter case has \fBoper\fR or'ed with BIO_CB_RETURN.
|
||||
.IP \fBlen\fR 4
|
||||
.IX Item "len"
|
||||
The length of the data requested to be read or written. This is only useful if
|
||||
@@ -356,7 +353,7 @@ respectively.
|
||||
\&\fBBIO_get_callback_arg()\fR returns a \fBchar\fR pointer to the value previously set
|
||||
via a call to \fBBIO_set_callback_arg()\fR.
|
||||
.PP
|
||||
\&\fBBIO_debug_callback()\fR returns 1 or \fBret\fR if it\*(Aqs called after specific BIO
|
||||
\&\fBBIO_debug_callback()\fR returns 1 or \fBret\fR if it's called after specific BIO
|
||||
operations.
|
||||
.SH EXAMPLES
|
||||
.IX Header "EXAMPLES"
|
||||
@@ -367,7 +364,7 @@ in crypto/bio/bio_cb.c
|
||||
The \fBBIO_debug_callback_ex()\fR function was added in OpenSSL 3.0.
|
||||
.PP
|
||||
\&\fBBIO_set_callback()\fR, \fBBIO_get_callback()\fR, and \fBBIO_debug_callback()\fR were
|
||||
deprecated in OpenSSL 3.0. Use the non\-deprecated _ex functions instead.
|
||||
deprecated in OpenSSL 3.0. Use the non-deprecated _ex functions instead.
|
||||
.SH COPYRIGHT
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright 2000\-2021 The OpenSSL Project Authors. All Rights Reserved.
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_SET_FLAGS 3ossl"
|
||||
.TH BIO_SET_FLAGS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_SET_FLAGS 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_SHOULD_RETRY 3ossl"
|
||||
.TH BIO_SHOULD_RETRY 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_SHOULD_RETRY 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BIO_SOCKET_WAIT 3ossl"
|
||||
.TH BIO_SOCKET_WAIT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BIO_SOCKET_WAIT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -85,7 +82,7 @@ BIO_do_connect_retry
|
||||
else for writing, at most until \fBmax_time\fR.
|
||||
It succeeds immediately if \fBmax_time\fR == 0 (which means no timeout given).
|
||||
.PP
|
||||
\&\fBBIO_wait()\fR waits at most until \fBmax_time\fR on the given (typically socket\-based)
|
||||
\&\fBBIO_wait()\fR waits at most until \fBmax_time\fR on the given (typically socket-based)
|
||||
\&\fBbio\fR, for reading if \fBbio\fR is supposed to read, else for writing.
|
||||
It is used by \fBBIO_do_connect_retry()\fR and can be used together \fBBIO_read\fR\|(3).
|
||||
It succeeds immediately if \fBmax_time\fR == 0 (which means no timeout given).
|
||||
@@ -96,7 +93,7 @@ Via \fBnap_milliseconds\fR the caller determines the polling granularity.
|
||||
\&\fBBIO_do_connect_retry()\fR connects via the given \fBbio\fR.
|
||||
It retries \fBBIO_do_connect()\fR as far as needed to reach a definite outcome,
|
||||
i.e., connection succeeded, timeout has been reached, or an error occurred.
|
||||
For nonblocking and potentially even non\-socket BIOs it polls
|
||||
For nonblocking and potentially even non-socket BIOs it polls
|
||||
every \fBnap_milliseconds\fR and sleeps in between using \fBBIO_wait()\fR.
|
||||
If \fBnap_milliseconds\fR is < 0 then a default value of 100 ms is used.
|
||||
If the \fBtimeout\fR parameter is > 0 this indicates the maximum number of seconds
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_BLINDING_NEW 3ossl"
|
||||
.TH BN_BLINDING_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_BLINDING_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -110,7 +107,7 @@ If \fBb\fR is NULL, nothing is done.
|
||||
.PP
|
||||
\&\fBBN_BLINDING_update()\fR updates the \fBBN_BLINDING\fR parameters by squaring
|
||||
the \fBA\fR and \fBAi\fR or, after specific number of uses and if the
|
||||
necessary parameters are set, by re\-creating the blinding parameters.
|
||||
necessary parameters are set, by re-creating the blinding parameters.
|
||||
.PP
|
||||
\&\fBBN_BLINDING_convert_ex()\fR multiplies \fBn\fR with the blinding factor \fBA\fR.
|
||||
If \fBr\fR is not NULL a copy the inverse blinding factor \fBAi\fR will be
|
||||
@@ -125,7 +122,7 @@ with \fBr\fR set to NULL.
|
||||
.PP
|
||||
\&\fBBN_BLINDING_is_current_thread()\fR returns whether the \fBBN_BLINDING\fR
|
||||
structure is owned by the current thread. This is to help users
|
||||
provide proper locking if needed for multi\-threaded use.
|
||||
provide proper locking if needed for multi-threaded use.
|
||||
.PP
|
||||
\&\fBBN_BLINDING_set_current_thread()\fR sets the current thread as the
|
||||
owner of the \fBBN_BLINDING\fR structure.
|
||||
@@ -138,7 +135,7 @@ owner of the \fBBN_BLINDING\fR structure.
|
||||
there are two supported flags: \fBBN_BLINDING_NO_UPDATE\fR and
|
||||
\&\fBBN_BLINDING_NO_RECREATE\fR. \fBBN_BLINDING_NO_UPDATE\fR inhibits the
|
||||
automatic update of the \fBBN_BLINDING\fR parameters after each use
|
||||
and \fBBN_BLINDING_NO_RECREATE\fR inhibits the automatic re\-creation
|
||||
and \fBBN_BLINDING_NO_RECREATE\fR inhibits the automatic re-creation
|
||||
of the \fBBN_BLINDING\fR parameters after a fixed number of uses (currently
|
||||
32). In newly allocated \fBBN_BLINDING\fR objects no flags are set.
|
||||
\&\fBBN_BLINDING_set_flags()\fR sets the \fBBN_BLINDING\fR parameters flags.
|
||||
@@ -159,7 +156,7 @@ success and 0 if an error occurred.
|
||||
\&\fBBN_BLINDING_is_current_thread()\fR returns 1 if the current thread owns
|
||||
the \fBBN_BLINDING\fR object, 0 otherwise.
|
||||
.PP
|
||||
\&\fBBN_BLINDING_set_current_thread()\fR doesn\*(Aqt return anything.
|
||||
\&\fBBN_BLINDING_set_current_thread()\fR doesn't return anything.
|
||||
.PP
|
||||
\&\fBBN_BLINDING_lock()\fR, \fBBN_BLINDING_unlock()\fR return 1 if the operation
|
||||
succeeded or 0 on error.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_CTX_NEW 3ossl"
|
||||
.TH BN_CTX_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_CTX_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_CTX_START 3ossl"
|
||||
.TH BN_CTX_START 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_CTX_START 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_ADD 3ossl"
|
||||
.TH BN_ADD 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_ADD 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_ADD_WORD 3ossl"
|
||||
.TH BN_ADD_WORD 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_ADD_WORD 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_BN2BIN 3ossl"
|
||||
.TH BN_BN2BIN 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_BN2BIN 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -103,46 +100,46 @@ BN_print, BN_print_fp, BN_bn2mpi, BN_mpi2bn \- format conversions
|
||||
.Ve
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBN_bn2bin()\fR converts the absolute value of \fBa\fR into big\-endian form
|
||||
\&\fBBN_bn2bin()\fR converts the absolute value of \fBa\fR into big-endian form
|
||||
and stores it at \fBto\fR. \fBto\fR must point to BN_num_bytes(\fBa\fR) bytes of
|
||||
memory. \fBa\fR and \fBto\fR \fBMUST NOT\fR be NULL.
|
||||
.PP
|
||||
\&\fBBN_bn2binpad()\fR also converts the absolute value of \fBa\fR into big\-endian form
|
||||
\&\fBBN_bn2binpad()\fR also converts the absolute value of \fBa\fR into big-endian form
|
||||
and stores it at \fBto\fR. \fBtolen\fR indicates the length of the output buffer
|
||||
\&\fBto\fR. The result is padded with zeros if necessary. If \fBtolen\fR is less than
|
||||
BN_num_bytes(\fBa\fR) an error is returned.
|
||||
.PP
|
||||
\&\fBBN_signed_bn2bin()\fR converts the value of \fBa\fR into big\-endian signed 2\*(Aqs
|
||||
\&\fBBN_signed_bn2bin()\fR converts the value of \fBa\fR into big-endian signed 2's
|
||||
complements form and stores it at \fBto\fR. \fBtolen\fR indicates the length of
|
||||
the output buffer \fBto\fR. The result is signed extended (padded with 0x00
|
||||
for positive numbers or with 0xff for negative numbers) if necessary.
|
||||
If \fBtolen\fR is smaller than the necessary size (which may be
|
||||
\&\f(CW\*(C`<BN_num_bytes(\fR\f(CBa\fR\f(CW) + 1\*(C'\fR>), an error is returned.
|
||||
.PP
|
||||
\&\fBBN_bin2bn()\fR converts the positive integer in big\-endian form of length
|
||||
\&\fBBN_bin2bn()\fR converts the positive integer in big-endian form of length
|
||||
\&\fBlen\fR at \fBs\fR into a \fBBIGNUM\fR and places it in \fBret\fR. If \fBret\fR is
|
||||
NULL, a new \fBBIGNUM\fR is created. \fBs\fR \fBMUST NOT\fR be NULL.
|
||||
.PP
|
||||
\&\fBBN_signed_bin2bn()\fR converts the integer in big\-endian signed 2\*(Aqs complement
|
||||
\&\fBBN_signed_bin2bn()\fR converts the integer in big-endian signed 2's complement
|
||||
form of length \fBlen\fR at \fBs\fR into a \fBBIGNUM\fR and places it in \fBret\fR. If
|
||||
\&\fBret\fR is NULL, a new \fBBIGNUM\fR is created.
|
||||
.PP
|
||||
\&\fBBN_bn2lebinpad()\fR, \fBBN_signed_bn2lebin()\fR and \fBBN_lebin2bn()\fR are identical to
|
||||
\&\fBBN_bn2binpad()\fR, \fBBN_signed_bn2bin()\fR and \fBBN_bin2bn()\fR except the buffer is in
|
||||
little\-endian format.
|
||||
little-endian format.
|
||||
.PP
|
||||
\&\fBBN_bn2nativepad()\fR, \fBBN_signed_bn2native()\fR and \fBBN_native2bn()\fR are identical
|
||||
to \fBBN_bn2binpad()\fR, \fBBN_signed_bn2bin()\fR and \fBBN_bin2bn()\fR except the buffer is
|
||||
in native format, i.e. most significant byte first on big\-endian platforms,
|
||||
and least significant byte first on little\-endian platforms.
|
||||
in native format, i.e. most significant byte first on big-endian platforms,
|
||||
and least significant byte first on little-endian platforms.
|
||||
.PP
|
||||
\&\fBBN_bn2hex()\fR and \fBBN_bn2dec()\fR return printable strings containing the
|
||||
hexadecimal and decimal encoding of \fBa\fR respectively. For negative
|
||||
numbers, the string is prefaced with a leading \*(Aq\-\*(Aq. The string must be
|
||||
numbers, the string is prefaced with a leading '\-'. The string must be
|
||||
freed later using \fBOPENSSL_free()\fR.
|
||||
.PP
|
||||
\&\fBBN_hex2bn()\fR takes as many characters as possible from the string \fBstr\fR,
|
||||
including the leading character \*(Aq\-\*(Aq which means negative, to form a valid
|
||||
including the leading character '\-' which means negative, to form a valid
|
||||
hexadecimal number representation and converts them to a \fBBIGNUM\fR and
|
||||
stores it in **\fBa\fR. If *\fBa\fR is NULL, a new \fBBIGNUM\fR is created. If
|
||||
\&\fBa\fR is NULL, it only computes the length of valid representation.
|
||||
@@ -150,12 +147,12 @@ A "negative zero" is converted to zero.
|
||||
\&\fBBN_dec2bn()\fR is the same using the decimal system.
|
||||
.PP
|
||||
\&\fBBN_print()\fR and \fBBN_print_fp()\fR write the hexadecimal encoding of \fBa\fR,
|
||||
with a leading \*(Aq\-\*(Aq for negative numbers, to the \fBBIO\fR or \fBFILE\fR
|
||||
with a leading '\-' for negative numbers, to the \fBBIO\fR or \fBFILE\fR
|
||||
\&\fBfp\fR.
|
||||
.PP
|
||||
\&\fBBN_bn2mpi()\fR and \fBBN_mpi2bn()\fR convert \fBBIGNUM\fRs from and to a format
|
||||
that consists of the number\*(Aqs length in bytes represented as a 4\-byte
|
||||
big\-endian number, and the number itself in big\-endian format, where
|
||||
that consists of the number's length in bytes represented as a 4\-byte
|
||||
big-endian number, and the number itself in big-endian format, where
|
||||
the most significant bit signals a negative number (the representation
|
||||
of numbers with the MSB set is prefixed with null byte).
|
||||
.PP
|
||||
@@ -168,14 +165,14 @@ a \fBBIGNUM\fR and stores it at \fBret\fR, or in a newly allocated \fBBIGNUM\fR
|
||||
if \fBret\fR is NULL.
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
\&\fBBN_bn2bin()\fR returns the length of the big\-endian number placed at \fBto\fR.
|
||||
\&\fBBN_bn2bin()\fR returns the length of the big-endian number placed at \fBto\fR.
|
||||
\&\fBBN_bin2bn()\fR returns the \fBBIGNUM\fR, NULL on error.
|
||||
.PP
|
||||
\&\fBBN_bn2binpad()\fR, \fBBN_signed_bn2bin()\fR, \fBBN_bn2lebinpad()\fR, \fBBN_signed_bn2lebin()\fR,
|
||||
\&\fBBN_bn2nativepad()\fR, and_signed \fBBN_bn2native()\fR return the number of bytes
|
||||
written or \-1 if the supplied buffer is too small.
|
||||
.PP
|
||||
\&\fBBN_bn2hex()\fR and \fBBN_bn2dec()\fR return a NUL\-terminated string, or NULL
|
||||
\&\fBBN_bn2hex()\fR and \fBBN_bn2dec()\fR return a NUL-terminated string, or NULL
|
||||
on error. \fBBN_hex2bn()\fR and \fBBN_dec2bn()\fR return the number of characters
|
||||
used in parsing, or 0 on error, in which
|
||||
case no new \fBBIGNUM\fR will be created.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_CMP 3ossl"
|
||||
.TH BN_CMP 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_CMP 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -103,7 +100,7 @@ of \fIa\fR and \fIb\fR.
|
||||
\&\fBBN_is_zero()\fR, \fBBN_is_one()\fR \fBBN_is_word()\fR, \fBBN_abs_is_word()\fR and
|
||||
\&\fBBN_is_odd()\fR return 1 if the condition is true, 0 otherwise.
|
||||
.PP
|
||||
\&\fBBN_are_coprime()\fR returns 1 if the \fBBIGNUM\fR\*(Aqs are coprime, otherwise it
|
||||
\&\fBBN_are_coprime()\fR returns 1 if the \fBBIGNUM\fR's are coprime, otherwise it
|
||||
returns 0.
|
||||
.SH HISTORY
|
||||
.IX Header "HISTORY"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_COPY 3ossl"
|
||||
.TH BN_COPY 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_COPY 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -94,7 +91,7 @@ restrictions apply to the use of \fBdest\fR:
|
||||
\&\fBdest\fR should be a newly allocated BIGNUM obtained via a call to \fBBN_new()\fR. It
|
||||
should not have been used for other purposes or initialised in any way.
|
||||
.IP \(bu 2
|
||||
\&\fBdest\fR must only be used in "read\-only" operations, i.e. typically those
|
||||
\&\fBdest\fR must only be used in "read-only" operations, i.e. typically those
|
||||
functions where the relevant parameter is declared "const".
|
||||
.IP \(bu 2
|
||||
\&\fBdest\fR must be used and freed before any further subsequent use of \fBb\fR
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_GENERATE_PRIME 3ossl"
|
||||
.TH BN_GENERATE_PRIME 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_GENERATE_PRIME 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_MOD_EXP_MONT 3ossl"
|
||||
.TH BN_MOD_EXP_MONT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_MOD_EXP_MONT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -95,7 +92,7 @@ function, so you can save time on initialization if you provide it in advance.
|
||||
\&\fBBN_mod_exp_mont_consttime()\fR computes \fIa\fR to the \fIp\fR\-th power modulo \fIm\fR
|
||||
(\f(CW\*(C`rr=a^p % m\*(C'\fR) using Montgomery multiplication. It is a variant of
|
||||
\&\fBBN_mod_exp_mont\fR\|(3) that uses fixed windows and the special precomputation
|
||||
memory layout to limit data\-dependency to a minimum to protect secret exponents.
|
||||
memory layout to limit data-dependency to a minimum to protect secret exponents.
|
||||
It is called automatically when \fBBN_mod_exp_mont\fR\|(3) is called with parameters
|
||||
\&\fIa\fR, \fIp\fR, \fIm\fR, any of which have \fBBN_FLG_CONSTTIME\fR flag.
|
||||
.PP
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_MOD_INVERSE 3ossl"
|
||||
.TH BN_MOD_INVERSE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_MOD_INVERSE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_MOD_MUL_MONTGOMERY 3ossl"
|
||||
.TH BN_MOD_MUL_MONTGOMERY 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_MOD_MUL_MONTGOMERY 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_MOD_MUL_RECIPROCAL 3ossl"
|
||||
.TH BN_MOD_MUL_RECIPROCAL 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_MOD_MUL_RECIPROCAL 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_NEW 3ossl"
|
||||
.TH BN_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_NUM_BYTES 3ossl"
|
||||
.TH BN_NUM_BYTES 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_NUM_BYTES 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -94,14 +91,14 @@ The size.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
Some have tried using \fBBN_num_bits()\fR on individual numbers in RSA keys,
|
||||
DH keys and DSA keys, and found that they don\*(Aqt always come up with
|
||||
DH keys and DSA keys, and found that they don't always come up with
|
||||
the number of bits they expected (something like 512, 1024, 2048,
|
||||
\&...). This is because generating a number with some specific number
|
||||
of bits doesn\*(Aqt always set the highest bits, thereby making the number
|
||||
of bits doesn't always set the highest bits, thereby making the number
|
||||
of \fIsignificant\fR bits a little lower. If you want to know the "key
|
||||
size" of such a key, either use functions like \fBRSA_size()\fR, \fBDH_size()\fR
|
||||
and \fBDSA_size()\fR, or use \fBBN_num_bytes()\fR and multiply with 8 (although
|
||||
there\*(Aqs no real guarantee that will match the "key size", just a lot
|
||||
there's no real guarantee that will match the "key size", just a lot
|
||||
more probability).
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_RAND 3ossl"
|
||||
.TH BN_RAND 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_RAND 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -100,7 +97,7 @@ see \fBopenssl_user_macros\fR\|(7):
|
||||
.Ve
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBBN_rand_ex()\fR generates a cryptographically strong pseudo\-random
|
||||
\&\fBBN_rand_ex()\fR generates a cryptographically strong pseudo-random
|
||||
number of \fIbits\fR in length and security strength at least \fIstrength\fR bits
|
||||
using the random number generator for the library context associated with
|
||||
\&\fIctx\fR. The function stores the generated data in \fIrnd\fR. The parameter \fIctx\fR
|
||||
@@ -122,7 +119,7 @@ If \fIbits\fR is 1 then \fItop\fR cannot also be \fBBN_RAND_TOP_TWO\fR.
|
||||
\&\fBBN_rand()\fR is the same as \fBBN_rand_ex()\fR except that the default library context
|
||||
is always used.
|
||||
.PP
|
||||
\&\fBBN_rand_range_ex()\fR generates a cryptographically strong pseudo\-random
|
||||
\&\fBBN_rand_range_ex()\fR generates a cryptographically strong pseudo-random
|
||||
number \fIrnd\fR, of security strength at least \fIstrength\fR bits,
|
||||
in the range 0 <= \fIrnd\fR < \fIrange\fR using the random number
|
||||
generator for the library context associated with \fIctx\fR. The parameter \fIctx\fR
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_SECURITY_BITS 3ossl"
|
||||
.TH BN_SECURITY_BITS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_SECURITY_BITS 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -81,7 +78,7 @@ of asymmetric algorithms: the FFC (Finite Field Cryptography) and IFC
|
||||
(Integer Factorization Cryptography). For FFC, e.g., DSA and DH, both
|
||||
parameters \fBL\fR and \fBN\fR are used to decide the bits of security, where
|
||||
\&\fBL\fR is the size of the public key and \fBN\fR is the size of the private
|
||||
key. For IFC, e.g., RSA, only \fBL\fR is used and it\*(Aqs commonly considered
|
||||
key. For IFC, e.g., RSA, only \fBL\fR is used and it's commonly considered
|
||||
to be the key size (modulus).
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_SET_BIT 3ossl"
|
||||
.TH BN_SET_BIT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_SET_BIT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -97,7 +94,7 @@ error occurs if \fBa\fR is shorter than \fBn\fR bits.
|
||||
\&\fBBN_mask_bits()\fR truncates \fBa\fR to an \fBn\fR bit number
|
||||
(\f(CW\*(C`a&=~((~0)<<n)\*(C'\fR). An error occurs if \fBn\fR is negative. An error is
|
||||
also returned if the internal representation of \fBa\fR is already shorter than
|
||||
\&\fBn\fR bits. The internal representation depends on the platform\*(Aqs word size, and
|
||||
\&\fBn\fR bits. The internal representation depends on the platform's word size, and
|
||||
this error can be safely ignored. Use \fBBN_num_bits\fR\|(3) to determine the exact
|
||||
number of bits if needed.
|
||||
.PP
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_SWAP 3ossl"
|
||||
.TH BN_SWAP 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_SWAP 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BN_ZERO 3ossl"
|
||||
.TH BN_ZERO 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BN_ZERO 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -93,7 +90,7 @@ is useful for use in comparisons and assignment.
|
||||
\&\fBBN_get_word()\fR returns \fBa\fR, if it can be represented as a \fBBN_ULONG\fR.
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
\&\fBBN_get_word()\fR returns the value \fBa\fR, or all\-bits\-set if \fBa\fR cannot
|
||||
\&\fBBN_get_word()\fR returns the value \fBa\fR, or all-bits-set if \fBa\fR cannot
|
||||
be represented as a single integer.
|
||||
.PP
|
||||
\&\fBBN_one()\fR and \fBBN_set_word()\fR return 1 on success, 0 otherwise.
|
||||
@@ -101,7 +98,7 @@ be represented as a single integer.
|
||||
\&\fBBN_zero()\fR never fails and returns no value.
|
||||
.SH BUGS
|
||||
.IX Header "BUGS"
|
||||
If a \fBBIGNUM\fR is equal to the value of all\-bits\-set, it will collide
|
||||
If a \fBBIGNUM\fR is equal to the value of all-bits-set, it will collide
|
||||
with the error condition returned by \fBBN_get_word()\fR which uses that
|
||||
as an error value.
|
||||
.PP
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "BUF_MEM_NEW 3ossl"
|
||||
.TH BUF_MEM_NEW 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH BUF_MEM_NEW 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -102,11 +99,11 @@ If the argument is NULL, nothing is done.
|
||||
\&\fBlen\fR. Any data already in the buffer is preserved if it increases in
|
||||
size.
|
||||
.PP
|
||||
\&\fBBUF_MEM_grow_clean()\fR is similar to \fBBUF_MEM_grow()\fR but it sets any free\*(Aqd
|
||||
or additionally\-allocated memory to zero.
|
||||
\&\fBBUF_MEM_grow_clean()\fR is similar to \fBBUF_MEM_grow()\fR but it sets any free'd
|
||||
or additionally-allocated memory to zero.
|
||||
.PP
|
||||
\&\fBBUF_reverse()\fR reverses \fBsize\fR bytes at \fBin\fR into \fBout\fR. If \fBin\fR
|
||||
is NULL, the array is reversed in\-place.
|
||||
is NULL, the array is reversed in-place.
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
\&\fBBUF_MEM_new()\fR returns the buffer or NULL on error.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMAC_CTX 3ossl"
|
||||
.TH CMAC_CTX 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMAC_CTX 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -94,7 +91,7 @@ value, see \fBopenssl_user_macros\fR\|(7).
|
||||
.Ve
|
||||
.SH DESCRIPTION
|
||||
.IX Header "DESCRIPTION"
|
||||
The low\-level MAC functions documented on this page are deprecated.
|
||||
The low-level MAC functions documented on this page are deprecated.
|
||||
Applications should use the new \fBEVP_MAC\fR\|(3) interface.
|
||||
Specifically, utilize the following functions for MAC operations:
|
||||
.IP "\fBEVP_MAC_CTX_new\fR\|(3) to create a new MAC context." 4
|
||||
@@ -110,11 +107,11 @@ Specifically, utilize the following functions for MAC operations:
|
||||
.IX Item "EVP_MAC_final to finalize the MAC and retrieve the output."
|
||||
.PD
|
||||
.PP
|
||||
Alternatively, for a single\-step MAC computation, use the \fBEVP_Q_mac\fR\|(3)
|
||||
Alternatively, for a single-step MAC computation, use the \fBEVP_Q_mac\fR\|(3)
|
||||
function.
|
||||
.PP
|
||||
The \fBCMAC_CTX\fR type is a structure used for the provision of CMAC
|
||||
(Cipher\-based Message Authentication Code) operations.
|
||||
(Cipher-based Message Authentication Code) operations.
|
||||
.PP
|
||||
\&\fBCMAC_CTX_new()\fR creates a new \fBCMAC_CTX\fR structure and returns a pointer to it.
|
||||
.PP
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ENCRYPTEDDATA_DECRYPT 3ossl"
|
||||
.TH CMS_ENCRYPTEDDATA_DECRYPT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ENCRYPTEDDATA_DECRYPT 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ENCRYPTEDDATA_ENCRYPT 3ossl"
|
||||
.TH CMS_ENCRYPTEDDATA_ENCRYPT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ENCRYPTEDDATA_ENCRYPT 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ENCRYPTEDDATA_SET1_KEY 3ossl"
|
||||
.TH CMS_ENCRYPTEDDATA_SET1_KEY 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ENCRYPTEDDATA_SET1_KEY 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ENVELOPEDDATA_CREATE 3ossl"
|
||||
.TH CMS_ENVELOPEDDATA_CREATE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ENVELOPEDDATA_CREATE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ADD0_CERT 3ossl"
|
||||
.TH CMS_ADD0_CERT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ADD0_CERT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -119,7 +116,7 @@ For enveloped data they are added to \fBOriginatorInfo\fR.
|
||||
.PP
|
||||
\&\fBCMS_get1_certs()\fR and \fBCMS_get1_crls()\fR return the STACK of certificates or CRLs
|
||||
or NULL if there are none or an error occurs.
|
||||
Besides out\-of\-memory, the only error which will occur
|
||||
Besides out-of-memory, the only error which will occur
|
||||
in practice is if the \fIcms\fR type is invalid.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ADD1_RECIPIENT_CERT 3ossl"
|
||||
.TH CMS_ADD1_RECIPIENT_CERT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ADD1_RECIPIENT_CERT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -88,7 +85,7 @@ CMS_add1_recipient, CMS_add1_recipient_cert, CMS_add0_recipient_key \- add recip
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\fBCMS_add1_recipient()\fR adds recipient \fBrecip\fR and provides the originator pkey
|
||||
\&\fBoriginatorPrivKey\fR and originator certificate \fBoriginator\fR to CMS_ContentInfo.
|
||||
The originator\-related fields are relevant only in case when the keyAgreement
|
||||
The originator-related fields are relevant only in case when the keyAgreement
|
||||
method of providing of the shared key is in use.
|
||||
.PP
|
||||
\&\fBCMS_add1_recipient_cert()\fR adds recipient \fBrecip\fR to CMS_ContentInfo enveloped
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ADD1_SIGNER 3ossl"
|
||||
.TH CMS_ADD1_SIGNER 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ADD1_SIGNER 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -83,7 +80,7 @@ key \fBpkey\fR using message digest \fBmd\fR to CMS_ContentInfo SignedData
|
||||
structure \fBcms\fR.
|
||||
.PP
|
||||
The CMS_ContentInfo structure should be obtained from an initial call to
|
||||
\&\fBCMS_sign()\fR with the flag \fBCMS_PARTIAL\fR set or in the case or re\-signing a
|
||||
\&\fBCMS_sign()\fR with the flag \fBCMS_PARTIAL\fR set or in the case or re-signing a
|
||||
valid CMS_ContentInfo SignedData structure.
|
||||
.PP
|
||||
If the \fBmd\fR parameter is \fBNULL\fR then the default digest for the public
|
||||
@@ -119,8 +116,8 @@ CMS_SignerInfo structure will not be finalized so additional attributes
|
||||
can be added. In this case an explicit call to \fBCMS_SignerInfo_sign()\fR is
|
||||
needed to finalize it.
|
||||
.PP
|
||||
If \fBCMS_NOCERTS\fR is set the signer\*(Aqs certificate will not be included in the
|
||||
CMS_ContentInfo structure, the signer\*(Aqs certificate must still be supplied in
|
||||
If \fBCMS_NOCERTS\fR is set the signer's certificate will not be included in the
|
||||
CMS_ContentInfo structure, the signer's certificate must still be supplied in
|
||||
the \fBsigncert\fR parameter though. This can reduce the size of the signature if
|
||||
the signers certificate can be obtained by other means: for example a
|
||||
previously signed message.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_COMPRESS 3ossl"
|
||||
.TH CMS_COMPRESS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_COMPRESS 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_DATA_CREATE 3ossl"
|
||||
.TH CMS_DATA_CREATE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_DATA_CREATE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -58,7 +58,7 @@
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_DECRYPT 3ossl"
|
||||
.TH CMS_DECRYPT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_DECRYPT 3ossl 2026-09-29 3.5.9 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_DIGEST_CREATE 3ossl"
|
||||
.TH CMS_DIGEST_CREATE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_DIGEST_CREATE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_ENCRYPT 3ossl"
|
||||
.TH CMS_ENCRYPT 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_ENCRYPT 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -85,7 +82,7 @@ AuthEnvelopedData structure. \fIcerts\fR is a list of recipient certificates.
|
||||
property query \fIpropq\fR are used internally when retrieving algorithms from
|
||||
providers.
|
||||
.PP
|
||||
Only certificates carrying RSA, Diffie\-Hellman or EC keys are supported by this
|
||||
Only certificates carrying RSA, Diffie-Hellman or EC keys are supported by this
|
||||
function.
|
||||
.PP
|
||||
\&\fBEVP_des_ede3_cbc()\fR (triple DES) is the algorithm of choice for S/MIME use
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_FINAL 3ossl"
|
||||
.TH CMS_FINAL 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_FINAL 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -83,7 +80,7 @@ processed. The \fBdcont\fR parameter contains a BIO to write content to after
|
||||
processing: this is only used with detached data and will usually be set to
|
||||
NULL.
|
||||
.PP
|
||||
\&\fBCMS_final_digest()\fR finalises the structure \fBcms\fR using a pre\-computed digest,
|
||||
\&\fBCMS_final_digest()\fR finalises the structure \fBcms\fR using a pre-computed digest,
|
||||
rather than computing the digest from the original data.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
@@ -91,10 +88,10 @@ These functions will normally be called when the \fBCMS_PARTIAL\fR flag is used.
|
||||
should only be used when streaming is not performed because the streaming
|
||||
I/O functions perform finalisation operations internally.
|
||||
.PP
|
||||
To sign a pre\-computed digest, \fBCMS_sign\fR\|(3) or \fBCMS_sign_ex()\fR is called
|
||||
To sign a pre-computed digest, \fBCMS_sign\fR\|(3) or \fBCMS_sign_ex()\fR is called
|
||||
with the \fBdata\fR parameter set to NULL before the CMS structure is finalised
|
||||
with the digest provided to \fBCMS_final_digest()\fR in binary form.
|
||||
When signing a pre\-computed digest, the security relies on the digest and its
|
||||
When signing a pre-computed digest, the security relies on the digest and its
|
||||
computation from the original message being trusted.
|
||||
.SH "RETURN VALUES"
|
||||
.IX Header "RETURN VALUES"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_GET0_RECIPIENTINFOS 3ossl"
|
||||
.TH CMS_GET0_RECIPIENTINFOS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_GET0_RECIPIENTINFOS 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_GET0_SIGNERINFOS 3ossl"
|
||||
.TH CMS_GET0_SIGNERINFOS 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_GET0_SIGNERINFOS 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -100,7 +97,7 @@ modified.
|
||||
identifier \fBsi\fR. It returns zero if the comparison is successful and non zero
|
||||
if not.
|
||||
.PP
|
||||
\&\fBCMS_SignerInfo_set1_signer_cert()\fR sets the signer\*(Aqs certificate of \fBsi\fR to
|
||||
\&\fBCMS_SignerInfo_set1_signer_cert()\fR sets the signer's certificate of \fBsi\fR to
|
||||
\&\fBsigner\fR.
|
||||
.SH NOTES
|
||||
.IX Header "NOTES"
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_GET0_TYPE 3ossl"
|
||||
.TH CMS_GET0_TYPE 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_GET0_TYPE 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_GET1_RECEIPTREQUEST 3ossl"
|
||||
.TH CMS_GET1_RECEIPTREQUEST 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_GET1_RECEIPTREQUEST 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
.\" -*- mode: troff; coding: utf-8 -*-
|
||||
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
|
||||
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ========================================================================
|
||||
@@ -52,13 +52,10 @@
|
||||
. \}
|
||||
.\}
|
||||
.rr rF
|
||||
.\"
|
||||
.\" Required to disable full justification in groff 1.23.0.
|
||||
.if n .ds AD l
|
||||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "CMS_SIGN 3ossl"
|
||||
.TH CMS_SIGN 3ossl 2026-08-25 3.5.8 OpenSSL
|
||||
.TH CMS_SIGN 3ossl 2025-09-30 3.5.4 OpenSSL
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
@@ -102,8 +99,8 @@ Many S/MIME clients expect the signed content to include valid MIME headers. If
|
||||
the \fBCMS_TEXT\fR flag is set MIME headers for type \fBtext/plain\fR are prepended
|
||||
to the data.
|
||||
.PP
|
||||
If \fBCMS_NOCERTS\fR is set the signer\*(Aqs certificate will not be included in the
|
||||
CMS_ContentInfo structure, the signer\*(Aqs certificate must still be supplied in
|
||||
If \fBCMS_NOCERTS\fR is set the signer's certificate will not be included in the
|
||||
CMS_ContentInfo structure, the signer's certificate must still be supplied in
|
||||
the \fBsigncert\fR parameter though. This can reduce the size of the signature if
|
||||
the signers certificate can be obtained by other means: for example a
|
||||
previously signed message.
|
||||
|
||||
Loaded 100 of 910 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user