diff options
Diffstat (limited to 'src/lib/libcrypto/man/X509_get0_signature.3')
| -rw-r--r-- | src/lib/libcrypto/man/X509_get0_signature.3 | 44 |
1 files changed, 40 insertions, 4 deletions
diff --git a/src/lib/libcrypto/man/X509_get0_signature.3 b/src/lib/libcrypto/man/X509_get0_signature.3 index a0982f2193..903cc043d9 100644 --- a/src/lib/libcrypto/man/X509_get0_signature.3 +++ b/src/lib/libcrypto/man/X509_get0_signature.3 | |||
| @@ -1,8 +1,25 @@ | |||
| 1 | .\" $OpenBSD: X509_get0_signature.3,v 1.5 2018/03/23 23:18:17 schwarze Exp $ | 1 | .\" $OpenBSD: X509_get0_signature.3,v 1.6 2020/06/24 19:55:55 schwarze Exp $ |
| 2 | .\" selective merge up to: | 2 | .\" selective merge up to: |
| 3 | .\" OpenSSL man3/X509_get0_signature 2f7a2520 Apr 25 17:28:08 2017 +0100 | 3 | .\" OpenSSL man3/X509_get0_signature 2f7a2520 Apr 25 17:28:08 2017 +0100 |
| 4 | .\" | 4 | .\" |
| 5 | .\" This file was written by Dr. Stephen Henson <steve@openssl.org>. | 5 | .\" This file is a derived work. |
| 6 | .\" The changes are covered by the following Copyright and license: | ||
| 7 | .\" | ||
| 8 | .\" Copyright (c) 2020 Ingo Schwarze <schwarze@openbsd.org> | ||
| 9 | .\" | ||
| 10 | .\" Permission to use, copy, modify, and distribute this software for any | ||
| 11 | .\" purpose with or without fee is hereby granted, provided that the above | ||
| 12 | .\" copyright notice and this permission notice appear in all copies. | ||
| 13 | .\" | ||
| 14 | .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | ||
| 15 | .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | ||
| 16 | .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | ||
| 17 | .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | ||
| 18 | .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | ||
| 19 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | ||
| 20 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | ||
| 21 | .\" | ||
| 22 | .\" The original file was written by Dr. Stephen Henson <steve@openssl.org>. | ||
| 6 | .\" Copyright (c) 2015 The OpenSSL Project. All rights reserved. | 23 | .\" Copyright (c) 2015 The OpenSSL Project. All rights reserved. |
| 7 | .\" | 24 | .\" |
| 8 | .\" Redistribution and use in source and binary forms, with or without | 25 | .\" Redistribution and use in source and binary forms, with or without |
| @@ -49,7 +66,7 @@ | |||
| 49 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | 66 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED |
| 50 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | 67 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. |
| 51 | .\" | 68 | .\" |
| 52 | .Dd $Mdocdate: March 23 2018 $ | 69 | .Dd $Mdocdate: June 24 2020 $ |
| 53 | .Dt X509_GET0_SIGNATURE 3 | 70 | .Dt X509_GET0_SIGNATURE 3 |
| 54 | .Os | 71 | .Os |
| 55 | .Sh NAME | 72 | .Sh NAME |
| @@ -57,6 +74,7 @@ | |||
| 57 | .Nm X509_REQ_get0_signature , | 74 | .Nm X509_REQ_get0_signature , |
| 58 | .Nm X509_CRL_get0_signature , | 75 | .Nm X509_CRL_get0_signature , |
| 59 | .Nm X509_get0_tbs_sigalg , | 76 | .Nm X509_get0_tbs_sigalg , |
| 77 | .Nm X509_get_signature_type , | ||
| 60 | .Nm X509_get_signature_nid , | 78 | .Nm X509_get_signature_nid , |
| 61 | .Nm X509_REQ_get_signature_nid , | 79 | .Nm X509_REQ_get_signature_nid , |
| 62 | .Nm X509_CRL_get_signature_nid | 80 | .Nm X509_CRL_get_signature_nid |
| @@ -86,6 +104,10 @@ | |||
| 86 | .Fa "const X509 *x" | 104 | .Fa "const X509 *x" |
| 87 | .Fc | 105 | .Fc |
| 88 | .Ft int | 106 | .Ft int |
| 107 | .Fo X509_get_signature_type | ||
| 108 | .Fa "const X509 *x" | ||
| 109 | .Fc | ||
| 110 | .Ft int | ||
| 89 | .Fo X509_get_signature_nid | 111 | .Fo X509_get_signature_nid |
| 90 | .Fa "const X509 *x" | 112 | .Fa "const X509 *x" |
| 91 | .Fc | 113 | .Fc |
| @@ -118,6 +140,13 @@ returns the signature algorithm in the signed portion of | |||
| 118 | The values returned are internal pointers | 140 | The values returned are internal pointers |
| 119 | that must not be freed by the caller. | 141 | that must not be freed by the caller. |
| 120 | .Pp | 142 | .Pp |
| 143 | .Fn X509_get_signature_type | ||
| 144 | returns the base NID corresponding to the signature algorithm of | ||
| 145 | .Fa x | ||
| 146 | just like | ||
| 147 | .Xr EVP_PKEY_base_id 3 | ||
| 148 | does. | ||
| 149 | .Pp | ||
| 121 | .Fn X509_get_signature_nid , | 150 | .Fn X509_get_signature_nid , |
| 122 | .Fn X509_REQ_get_signature_nid , | 151 | .Fn X509_REQ_get_signature_nid , |
| 123 | and | 152 | and |
| @@ -127,7 +156,9 @@ return the NID corresponding to the signature algorithm of | |||
| 127 | .Fa req , | 156 | .Fa req , |
| 128 | or | 157 | or |
| 129 | .Fa crl , | 158 | .Fa crl , |
| 130 | respectively. | 159 | respectively, just like |
| 160 | .Xr EVP_PKEY_id 3 | ||
| 161 | does. | ||
| 131 | .Pp | 162 | .Pp |
| 132 | These functions provide lower level access to the signature | 163 | These functions provide lower level access to the signature |
| 133 | for cases where an application wishes to analyse or generate a | 164 | for cases where an application wishes to analyse or generate a |
| @@ -135,6 +166,7 @@ signature in a form where | |||
| 135 | .Xr X509_sign 3 | 166 | .Xr X509_sign 3 |
| 136 | is not appropriate, for example in a non-standard or unsupported format. | 167 | is not appropriate, for example in a non-standard or unsupported format. |
| 137 | .Sh SEE ALSO | 168 | .Sh SEE ALSO |
| 169 | .Xr EVP_PKEY_base_id 3 , | ||
| 138 | .Xr OBJ_obj2nid 3 , | 170 | .Xr OBJ_obj2nid 3 , |
| 139 | .Xr X509_ALGOR_new 3 , | 171 | .Xr X509_ALGOR_new 3 , |
| 140 | .Xr X509_CRL_get0_by_serial 3 , | 172 | .Xr X509_CRL_get0_by_serial 3 , |
| @@ -147,6 +179,10 @@ is not appropriate, for example in a non-standard or unsupported format. | |||
| 147 | .Xr X509_sign 3 , | 179 | .Xr X509_sign 3 , |
| 148 | .Xr X509_verify_cert 3 | 180 | .Xr X509_verify_cert 3 |
| 149 | .Sh HISTORY | 181 | .Sh HISTORY |
| 182 | .Fn X509_get_signature_type | ||
| 183 | first appeared in SSLeay 0.8.0 and has been available since | ||
| 184 | .Ox 2.4 . | ||
| 185 | .Pp | ||
| 150 | .Fn X509_get0_signature | 186 | .Fn X509_get0_signature |
| 151 | and | 187 | and |
| 152 | .Fn X509_get_signature_nid | 188 | .Fn X509_get_signature_nid |
