X-Git-Url: https://git.openssl.org/gitweb/?a=blobdiff_plain;f=doc%2Fcrypto%2Fd2i_X509_NAME.pod;h=d1d32dfcd87c572e1ff0f561a14fe87bb9b1658a;hb=8ab31975bacb9c907261088937d3aa4102e3af84;hp=ca52f53f1626d7c075504f50beef5de55fc74b39;hpb=d900a015b5a89ea2018e6122dd2738925e4d68ab;p=openssl.git 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 structure which is the -same as the B 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 structure which is the same as the B 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 manual page. +The function X509_NAME_get0_der() returns an internal pointer to the +encoding of an B structure in B<*pder> and consisting of +B<*pderlen> bytes. It is useful for applications that wish to examine +the encoding of an B structure without copying it. + +=head1 RETURN VALUES + =head1 SEE ALSO -L +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 =cut