diff options
author | Dr. Stephen Henson <steve@openssl.org> | 2016-01-30 02:51:01 +0000 |
---|---|---|
committer | Dr. Stephen Henson <steve@openssl.org> | 2016-01-30 16:02:48 +0000 |
commit | 7ab507495b86371756575d606af556b4fd74e27a (patch) | |
tree | 07b1c2b00859f8e6764d190833657b7fbfeccfc1 /doc | |
parent | 33254e1c6fa6a1acf28fd0d9b6dc4ee30e569b95 (diff) |
Add function to return internal enoding of X509_NAME.
PR#4280
Reviewed-by: Tim Hudson <tjh@openssl.org>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/crypto/d2i_X509_NAME.pod | 26 |
1 files changed, 20 insertions, 6 deletions
diff --git a/doc/crypto/d2i_X509_NAME.pod b/doc/crypto/d2i_X509_NAME.pod index ca52f53f16..d1d32dfcd8 100644 --- a/doc/crypto/d2i_X509_NAME.pod +++ b/doc/crypto/d2i_X509_NAME.pod @@ -11,21 +11,35 @@ d2i_X509_NAME, i2d_X509_NAME - X509_NAME encoding functions X509_NAME *d2i_X509_NAME(X509_NAME **a, unsigned char **pp, long length); int i2d_X509_NAME(X509_NAME *a, unsigned char **pp); + int X509_NAME_get0_der(const unsigned char **pder, size_t *pderlen, + X509_NAME *nm) + + =head1 DESCRIPTION -These functions decode and encode an B<X509_NAME> structure which is the -same as the B<Name> type defined in RFC2459 (and elsewhere) and used -for example in certificate subject and issuer names. +The functions d2i_X509_NAME() and i2d_X509_NAME() decode and encode an +B<X509_NAME> structure which is the same as the B<Name> type defined in +RFC3280 (and elsewhere) and used for example in certificate subject and +issuer names. Otherwise the functions behave in a similar way to d2i_X509() and i2d_X509() described in the L<d2i_X509(3)> manual page. +The function X509_NAME_get0_der() returns an internal pointer to the +encoding of an B<X509_NAME> structure in B<*pder> and consisting of +B<*pderlen> bytes. It is useful for applications that wish to examine +the encoding of an B<X509_NAME> structure without copying it. + +=head1 RETURN VALUES + =head1 SEE ALSO -L<d2i_X509(3)> +The meanings of the return values of d2i_X509_NAME() and i2d_X509_NAME() +are similar to those for d2i_X509() and i2d_X509(). -=head1 HISTORY +The function X509_NAME_get0_der() returns 1 for success and 0 if an error +occurred. -TBA +L<d2i_X509(3)> =cut |