]>
Commit | Line | Data |
---|---|---|
29e48c18 DSH |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
5 | d2i_X509_NAME, i2d_X509_NAME - X509_NAME encoding functions | |
6 | ||
7 | =head1 SYNOPSIS | |
8 | ||
9 | #include <openssl/x509.h> | |
10 | ||
11 | X509_NAME *d2i_X509_NAME(X509_NAME **a, unsigned char **pp, long length); | |
12 | int i2d_X509_NAME(X509_NAME *a, unsigned char **pp); | |
13 | ||
7ab50749 DSH |
14 | int X509_NAME_get0_der(const unsigned char **pder, size_t *pderlen, |
15 | X509_NAME *nm) | |
16 | ||
17 | ||
29e48c18 DSH |
18 | =head1 DESCRIPTION |
19 | ||
7ab50749 DSH |
20 | The functions d2i_X509_NAME() and i2d_X509_NAME() decode and encode an |
21 | B<X509_NAME> structure which is the same as the B<Name> type defined in | |
22 | RFC3280 (and elsewhere) and used for example in certificate subject and | |
23 | issuer names. | |
29e48c18 | 24 | |
186bb907 | 25 | Otherwise the functions behave in a similar way to d2i_X509() and i2d_X509() |
9b86974e | 26 | described in the L<d2i_X509(3)> manual page. |
29e48c18 | 27 | |
7ab50749 DSH |
28 | The function X509_NAME_get0_der() returns an internal pointer to the |
29 | encoding of an B<X509_NAME> structure in B<*pder> and consisting of | |
30 | B<*pderlen> bytes. It is useful for applications that wish to examine | |
31 | the encoding of an B<X509_NAME> structure without copying it. | |
32 | ||
33 | =head1 RETURN VALUES | |
34 | ||
29e48c18 DSH |
35 | =head1 SEE ALSO |
36 | ||
7ab50749 DSH |
37 | The meanings of the return values of d2i_X509_NAME() and i2d_X509_NAME() |
38 | are similar to those for d2i_X509() and i2d_X509(). | |
29e48c18 | 39 | |
7ab50749 DSH |
40 | The function X509_NAME_get0_der() returns 1 for success and 0 if an error |
41 | occurred. | |
29e48c18 | 42 | |
7ab50749 | 43 | L<d2i_X509(3)> |
29e48c18 DSH |
44 | |
45 | =cut | |
e2f92610 RS |
46 | |
47 | =head1 COPYRIGHT | |
48 | ||
49 | Copyright 2002-2016 The OpenSSL Project Authors. All Rights Reserved. | |
50 | ||
51 | Licensed under the OpenSSL license (the "License"). You may not use | |
52 | this file except in compliance with the License. You can obtain a copy | |
53 | in the file LICENSE in the source distribution or at | |
54 | L<https://www.openssl.org/source/license.html>. | |
55 | ||
56 | =cut |