diff options
author | Dr. Stephen Henson <steve@openssl.org> | 2016-08-18 15:16:31 +0100 |
---|---|---|
committer | Dr. Stephen Henson <steve@openssl.org> | 2016-08-19 12:47:31 +0100 |
commit | 68c12bfc6601d40e85146f36f26fe8ff0472f36b (patch) | |
tree | 4070d574355a2f9b25befbd55bc639aa96e0ab0f /doc | |
parent | 11222483d75c1e18fb53fe71b9a86fcfdb6d0725 (diff) |
Add X509_get0_serialNumber() and constify OCSP_cert_to_id()
Reviewed-by: Matt Caswell <matt@openssl.org>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/crypto/X509_get_serialNumber.pod | 15 |
1 files changed, 11 insertions, 4 deletions
diff --git a/doc/crypto/X509_get_serialNumber.pod b/doc/crypto/X509_get_serialNumber.pod index 4f1b033ade..2e81c62396 100644 --- a/doc/crypto/X509_get_serialNumber.pod +++ b/doc/crypto/X509_get_serialNumber.pod @@ -2,14 +2,17 @@ =head1 NAME -X509_get_serialNumber, X509_set_serialNumber - get or set certificate serial -number +X509_get_serialNumber, +X509_get0_serialNumber, +X509_set_serialNumber +- get or set certificate serial number =head1 SYNOPSIS #include <openssl/x509.h> ASN1_INTEGER *X509_get_serialNumber(X509 *x); + const ASN1_INTEGER *X509_get0_serialNumber(const X509 *x); int X509_set_serialNumber(X509 *x, ASN1_INTEGER *serial); =head1 DESCRIPTION @@ -18,13 +21,17 @@ X509_get_serialNumber() returns the serial number of certificate B<x> as an B<ASN1_INTEGER> structure which can be examined or initialised. The value returned is an internal pointer which B<MUST NOT> be freed up after the call. +X509_get0_serialNumber() is the same as X509_get_serialNumber() except it +accepts a const parameter and returns a const result. + X509_set_serialNumber() sets the serial number of certificate B<x> to B<serial>. A copy of the serial number is used internally so B<serial> should be freed up after use. =head1 RETURN VALUES -X509_get_serialNumber() returns an B<ASN1_INTEGER> structure. +X509_get_serialNumber() and X509_get0_serialNumber() return an B<ASN1_INTEGER> +structure. X509_set_serialNumber() returns 1 for success and 0 for failure. @@ -50,7 +57,7 @@ L<X509_verify_cert(3)> =head1 HISTORY X509_get_serialNumber() and X509_set_serialNumber() are available in -all versions of OpenSSL. +all versions of OpenSSL. X509_get0_serialNumber() was added in OpenSSL 1.1.0. =head1 COPYRIGHT |