summaryrefslogtreecommitdiffstats
path: root/secure/lib/libcrypto/man/d2i_X509.3
diff options
context:
space:
mode:
authorjkim <jkim@FreeBSD.org>2015-03-20 19:16:18 +0000
committerjkim <jkim@FreeBSD.org>2015-03-20 19:16:18 +0000
commitd962da16eb69c08beb3d1028d1edbb20241cfead (patch)
treebf9f5c26fab5c18be80ab30783e5c7e5082594fc /secure/lib/libcrypto/man/d2i_X509.3
parent778929f2cccf19c8b69d8bcd0da2243bf9e3fb95 (diff)
parent038f65e5fb1f35e1e485aa4781cda353c4e903f4 (diff)
downloadFreeBSD-src-d962da16eb69c08beb3d1028d1edbb20241cfead.zip
FreeBSD-src-d962da16eb69c08beb3d1028d1edbb20241cfead.tar.gz
Merge OpenSSL 1.0.1m.
Diffstat (limited to 'secure/lib/libcrypto/man/d2i_X509.3')
-rw-r--r--secure/lib/libcrypto/man/d2i_X509.316
1 files changed, 11 insertions, 5 deletions
diff --git a/secure/lib/libcrypto/man/d2i_X509.3 b/secure/lib/libcrypto/man/d2i_X509.3
index 4dfb31a..e5f63a8 100644
--- a/secure/lib/libcrypto/man/d2i_X509.3
+++ b/secure/lib/libcrypto/man/d2i_X509.3
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
+.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.30)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "d2i_X509 3"
-.TH d2i_X509 3 "2015-01-15" "1.0.1l" "OpenSSL"
+.TH d2i_X509 3 "2015-03-19" "1.0.1m" "OpenSSL"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -165,8 +165,11 @@ successful a pointer to the \fBX509\fR structure is returned. If an error
occurred then \fB\s-1NULL\s0\fR is returned. If \fBpx\fR is not \fB\s-1NULL\s0\fR then the
returned structure is written to \fB*px\fR. If \fB*px\fR is not \fB\s-1NULL\s0\fR
then it is assumed that \fB*px\fR contains a valid \fBX509\fR
-structure and an attempt is made to reuse it. If the call is
-successful \fB*in\fR is incremented to the byte following the
+structure and an attempt is made to reuse it. This \*(L"reuse\*(R" capability is present
+for historical compatibility but its use is \fBstrongly discouraged\fR (see \s-1BUGS\s0
+below, and the discussion in the \s-1RETURN VALUES\s0 section).
+.PP
+If the call is successful \fB*in\fR is incremented to the byte following the
parsed data.
.PP
\&\fIi2d_X509()\fR encodes the structure pointed to by \fBx\fR into \s-1DER\s0 format.
@@ -352,7 +355,10 @@ always succeed.
.IX Header "RETURN VALUES"
\&\fId2i_X509()\fR, \fId2i_X509_bio()\fR and \fId2i_X509_fp()\fR return a valid \fBX509\fR structure
or \fB\s-1NULL\s0\fR if an error occurs. The error code that can be obtained by
-\&\fIERR_get_error\fR\|(3).
+\&\fIERR_get_error\fR\|(3). If the \*(L"reuse\*(R" capability has been used
+with a valid X509 structure being passed in via \fBpx\fR then the object is not
+freed in the event of error but may be in a potentially invalid or inconsistent
+state.
.PP
\&\fIi2d_X509()\fR returns the number of bytes successfully encoded or a negative
value if an error occurs. The error code can be obtained by
OpenPOWER on IntegriCloud