diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2022-02-17 19:43:55 +0100 |
---|---|---|
committer | Dr. David von Oheimb <dev@ddvo.net> | 2022-02-22 12:05:08 +0100 |
commit | 2455a21f4ef9826b465ba68fd96f26ea25b80b10 (patch) | |
tree | 57d3f656c6a0ddd4d70ac0a4f851f1c0f6571bdc /doc/man3 | |
parent | cd7ec0bca00ceb6e8d4af46a57c6c096a7ed8947 (diff) |
X509V3_get_d2i.pod: Fix glitch on X509V3_get{,_ext}_d2i and align order
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/17724)
Diffstat (limited to 'doc/man3')
-rw-r--r-- | doc/man3/X509V3_get_d2i.pod | 28 |
1 files changed, 15 insertions, 13 deletions
diff --git a/doc/man3/X509V3_get_d2i.pod b/doc/man3/X509V3_get_d2i.pod index 981eab14b8..4098f9aa6f 100644 --- a/doc/man3/X509V3_get_d2i.pod +++ b/doc/man3/X509V3_get_d2i.pod @@ -2,11 +2,12 @@ =head1 NAME -X509_get0_extensions, X509_CRL_get0_extensions, X509_REVOKED_get0_extensions, X509V3_get_d2i, X509V3_add1_i2d, X509V3_EXT_d2i, X509V3_EXT_i2d, -X509_get_ext_d2i, X509_add1_ext_i2d, X509_CRL_get_ext_d2i, -X509_CRL_add1_ext_i2d, X509_REVOKED_get_ext_d2i, -X509_REVOKED_add1_ext_i2d - X509 extension decode and encode functions +X509_get_ext_d2i, X509_add1_ext_i2d, +X509_CRL_get_ext_d2i, X509_CRL_add1_ext_i2d, +X509_REVOKED_get_ext_d2i, X509_REVOKED_add1_ext_i2d, +X509_get0_extensions, X509_CRL_get0_extensions, +X509_REVOKED_get0_extensions - X509 extension decode and encode functions =head1 SYNOPSIS @@ -38,7 +39,7 @@ X509_REVOKED_add1_ext_i2d - X509 extension decode and encode functions =head1 DESCRIPTION -X509V3_get_ext_d2i() looks for an extension with OID B<nid> in the extensions +X509V3_get_d2i() looks for an extension with OID B<nid> in the extensions B<x> and, if found, decodes it. If B<idx> is B<NULL> then only one occurrence of an extension is permissible otherwise the first extension after index B<*idx> is returned and B<*idx> updated to the location of the extension. @@ -104,7 +105,8 @@ B<X509V3_ADD_DELETE> extension B<nid> is deleted: no new extension is added. If B<X509V3_ADD_SILENT> is ored with B<flags>: any error returned will not be added to the error queue. -The function X509V3_get_d2i() will return B<NULL> if the extension is not +The function X509V3_get_d2i() and its variants +will return B<NULL> if the extension is not found, occurs multiple times or cannot be decoded. It is possible to determine the precise reason by checking the value of B<*crit>. @@ -195,17 +197,17 @@ The following extensions are used by certificate transparency, RFC6962 =head1 RETURN VALUES -X509V3_EXT_d2i() and *X509V3_get_d2i() return a pointer to an extension -specific structure or B<NULL> if an error occurs. +X509V3_get_d2i(), its variants, and X509V3_EXT_d2i() return +a pointer to an extension specific structure or B<NULL> if an error occurs. -X509V3_EXT_i2d() returns a pointer to an B<X509_EXTENSION> structure -or B<NULL> if an error occurs. - -X509V3_add1_i2d() returns 1 if the operation is successful and 0 if it -fails due to a non-fatal error (extension not found, already exists, +X509V3_add1_i2d() and its variants return 1 if the operation is successful +and 0 if it fails due to a non-fatal error (extension not found, already exists, cannot be encoded) or -1 due to a fatal error such as a memory allocation failure. +X509V3_EXT_i2d() returns a pointer to an B<X509_EXTENSION> structure +or B<NULL> if an error occurs. + X509_get0_extensions(), X509_CRL_get0_extensions() and X509_REVOKED_get0_extensions() return a stack of extensions. They return NULL if no extensions are present. |