summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man3/X509_new.3ssl
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man3/X509_new.3ssl')
-rw-r--r--upstream/debian-unstable/man3/X509_new.3ssl16
1 files changed, 13 insertions, 3 deletions
diff --git a/upstream/debian-unstable/man3/X509_new.3ssl b/upstream/debian-unstable/man3/X509_new.3ssl
index 839833b1..ab7723ef 100644
--- a/upstream/debian-unstable/man3/X509_new.3ssl
+++ b/upstream/debian-unstable/man3/X509_new.3ssl
@@ -55,7 +55,7 @@
.\" ========================================================================
.\"
.IX Title "X509_NEW 3SSL"
-.TH X509_NEW 3SSL 2024-02-03 3.1.5 OpenSSL
+.TH X509_NEW 3SSL 2024-04-04 3.2.2-dev OpenSSL
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -63,7 +63,9 @@
.SH NAME
X509_new, X509_new_ex,
X509_free, X509_up_ref,
-X509_chain_up_ref \- X509 certificate ASN1 allocation functions
+X509_chain_up_ref,
+OSSL_STACK_OF_X509_free
+\&\- X509 certificate ASN1 allocation and deallocation functions
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
@@ -74,6 +76,7 @@ X509_chain_up_ref \- X509 certificate ASN1 allocation functions
\& void X509_free(X509 *a);
\& int X509_up_ref(X509 *a);
\& STACK_OF(X509) *X509_chain_up_ref(STACK_OF(X509) *x);
+\& void OSSL_STACK_OF_X509_free(STACK_OF(X509) *certs);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
@@ -98,6 +101,9 @@ frees it up if the reference count is zero. If \fBa\fR is NULL nothing is done.
.PP
\&\fBX509_chain_up_ref()\fR increases the reference count of all certificates in
chain \fBx\fR and returns a copy of the stack, or an empty stack if \fBa\fR is NULL.
+.PP
+\&\fBOSSL_STACK_OF_X509_free()\fR deallocates the given list of pointers to
+certificates after calling \fBX509_free()\fR on all its elements.
.SH NOTES
.IX Header "NOTES"
The function \fBX509_up_ref()\fR if useful if a certificate structure is being
@@ -117,6 +123,8 @@ Otherwise it returns a pointer to the newly allocated structure.
\&\fBX509_up_ref()\fR returns 1 for success and 0 for failure.
.PP
\&\fBX509_chain_up_ref()\fR returns a copy of the stack or NULL if an error occurred.
+.PP
+\&\fBOSSL_STACK_OF_X509_free()\fR has no return value.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBd2i_X509\fR\|(3),
@@ -137,7 +145,9 @@ Otherwise it returns a pointer to the newly allocated structure.
\&\fBX509_verify_cert\fR\|(3)
.SH HISTORY
.IX Header "HISTORY"
-The function \fBX509_new_ex()\fR was added in OpenSSL 3.0.
+\&\fBX509_new_ex()\fR was added in OpenSSL 3.0.
+.PP
+\&\fBOSSL_STACK_OF_X509_free()\fR was added in OpenSSL 3.2.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2002\-2021 The OpenSSL Project Authors. All Rights Reserved.