diff options
| -rw-r--r-- | src/lib/libcrypto/man/d2i_X509_NAME.3 | 86 |
1 files changed, 84 insertions, 2 deletions
diff --git a/src/lib/libcrypto/man/d2i_X509_NAME.3 b/src/lib/libcrypto/man/d2i_X509_NAME.3 index 1f1836abaf..0dacb648c7 100644 --- a/src/lib/libcrypto/man/d2i_X509_NAME.3 +++ b/src/lib/libcrypto/man/d2i_X509_NAME.3 | |||
| @@ -1,4 +1,4 @@ | |||
| 1 | .\" $OpenBSD: d2i_X509_NAME.3,v 1.5 2016/12/14 16:18:31 schwarze Exp $ | 1 | .\" $OpenBSD: d2i_X509_NAME.3,v 1.6 2016/12/14 17:26:35 schwarze Exp $ |
| 2 | .\" OpenSSL d900a015 Oct 8 14:40:42 2015 +0200 | 2 | .\" OpenSSL d900a015 Oct 8 14:40:42 2015 +0200 |
| 3 | .\" | 3 | .\" |
| 4 | .\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org> | 4 | .\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org> |
| @@ -20,7 +20,11 @@ | |||
| 20 | .Os | 20 | .Os |
| 21 | .Sh NAME | 21 | .Sh NAME |
| 22 | .Nm d2i_X509_NAME , | 22 | .Nm d2i_X509_NAME , |
| 23 | .Nm i2d_X509_NAME | 23 | .Nm i2d_X509_NAME , |
| 24 | .Nm X509_NAME_dup , | ||
| 25 | .Nm d2i_X509_NAME_ENTRY , | ||
| 26 | .Nm i2d_X509_NAME_ENTRY , | ||
| 27 | .Nm X509_NAME_ENTRY_dup | ||
| 24 | .\" In the following line, "X.501" and "Name" are not typos. | 28 | .\" In the following line, "X.501" and "Name" are not typos. |
| 25 | .\" The "Name" type is defined in X.501, not in X.509. | 29 | .\" The "Name" type is defined in X.501, not in X.509. |
| 26 | .\" The type in called "Name" with capital "N", not "name". | 30 | .\" The type in called "Name" with capital "N", not "name". |
| @@ -38,6 +42,25 @@ | |||
| 38 | .Fa "X509_NAME *name" | 42 | .Fa "X509_NAME *name" |
| 39 | .Fa "unsigned char **out" | 43 | .Fa "unsigned char **out" |
| 40 | .Fc | 44 | .Fc |
| 45 | .Ft X509_NAME * | ||
| 46 | .Fo X509_NAME_dup | ||
| 47 | .Fa "X509_NAME *name" | ||
| 48 | .Fc | ||
| 49 | .Ft X509_NAME_ENTRY * | ||
| 50 | .Fo d2i_X509_NAME_ENTRY | ||
| 51 | .Fa "X509_NAME_ENTRY **ne" | ||
| 52 | .Fa "unsigned char **in" | ||
| 53 | .Fa "long length" | ||
| 54 | .Fc | ||
| 55 | .Ft int | ||
| 56 | .Fo i2d_X509_NAME_ENTRY | ||
| 57 | .Fa "X509_NAME_ENTRY *ne" | ||
| 58 | .Fa "unsigned char **out" | ||
| 59 | .Fc | ||
| 60 | .Ft X509_NAME_ENTRY * | ||
| 61 | .Fo X509_NAME_ENTRY_dup | ||
| 62 | .Fa "X509_NAME_ENTRY *ne" | ||
| 63 | .Fc | ||
| 41 | .Sh DESCRIPTION | 64 | .Sh DESCRIPTION |
| 42 | .Fn d2i_X509_NAME | 65 | .Fn d2i_X509_NAME |
| 43 | decodes | 66 | decodes |
| @@ -53,6 +76,36 @@ encodes | |||
| 53 | into DER format and stores the result to | 76 | into DER format and stores the result to |
| 54 | .Pf * Fa out . | 77 | .Pf * Fa out . |
| 55 | .Pp | 78 | .Pp |
| 79 | .Fn X509_NAME_dup | ||
| 80 | copies | ||
| 81 | .Fa name | ||
| 82 | by calling | ||
| 83 | .Fn i2d_X509_NAME | ||
| 84 | and | ||
| 85 | .Fn d2i_X509_NAME . | ||
| 86 | .Pp | ||
| 87 | .Fn d2i_X509_NAME_ENTRY | ||
| 88 | decodes | ||
| 89 | .Fa length | ||
| 90 | bytes of the DER-encoded string | ||
| 91 | .Pf * Fa in | ||
| 92 | and stores the resulting RelativeDistinguishedName object in | ||
| 93 | .Pf * Fa ne . | ||
| 94 | .Pp | ||
| 95 | .Fn i2d_X509_NAME_ENTRY | ||
| 96 | encodes | ||
| 97 | .Fa ne | ||
| 98 | into DER format and stores the result to | ||
| 99 | .Pf * Fa out . | ||
| 100 | .Pp | ||
| 101 | .Fn X509_NAME_ENTRY_dup | ||
| 102 | copies | ||
| 103 | .Fa ne | ||
| 104 | by calling | ||
| 105 | .Fn i2d_X509_NAME_ENTRY | ||
| 106 | and | ||
| 107 | .Fn d2i_X509_NAME_ENTRY . | ||
| 108 | .Pp | ||
| 56 | For details of the behaviour, see | 109 | For details of the behaviour, see |
| 57 | .Xr d2i_X509 3 . | 110 | .Xr d2i_X509 3 . |
| 58 | .Pp | 111 | .Pp |
| @@ -60,8 +113,37 @@ Regarding | |||
| 60 | .Vt X509_NAME | 113 | .Vt X509_NAME |
| 61 | objects, see | 114 | objects, see |
| 62 | .Xr X509_NAME_new 3 . | 115 | .Xr X509_NAME_new 3 . |
| 116 | Regarding | ||
| 117 | .Vt X509_NAME_ENTRY | ||
| 118 | objects, see | ||
| 119 | .Xr X509_NAME_ENTRY_new 3 . | ||
| 120 | .Sh RETURN VALUES | ||
| 121 | .Fn d2i_X509_NAME | ||
| 122 | and | ||
| 123 | .Fn X509_NAME_dup | ||
| 124 | return the new | ||
| 125 | .Vt X509_NAME | ||
| 126 | object or | ||
| 127 | .Dv NULL | ||
| 128 | if an error occurs. | ||
| 129 | .Pp | ||
| 130 | .Fn d2i_X509_NAME_ENTRY | ||
| 131 | and | ||
| 132 | .Fn X509_NAME_ENTRY_dup | ||
| 133 | return the new | ||
| 134 | .Vt X509_NAME_ENTRY | ||
| 135 | object or | ||
| 136 | .Dv NULL | ||
| 137 | if an error occurs. | ||
| 138 | .Pp | ||
| 139 | .Fn i2d_X509_NAME | ||
| 140 | and | ||
| 141 | .Fn i2d_X509_NAME_ENTRY | ||
| 142 | returns the number of bytes successfully encoded or a negative value | ||
| 143 | if an error occurs. | ||
| 63 | .Sh SEE ALSO | 144 | .Sh SEE ALSO |
| 64 | .Xr d2i_X509 3 , | 145 | .Xr d2i_X509 3 , |
| 146 | .Xr X509_NAME_ENTRY_new 3 , | ||
| 65 | .Xr X509_NAME_new 3 , | 147 | .Xr X509_NAME_new 3 , |
| 66 | .Xr X509_NAME_print_ex 3 | 148 | .Xr X509_NAME_print_ex 3 |
| 67 | .Sh STANDARDS | 149 | .Sh STANDARDS |
