diff options
Diffstat (limited to 'src/lib/libcrypto/man/EVP_SignInit.3')
| -rw-r--r-- | src/lib/libcrypto/man/EVP_SignInit.3 | 41 |
1 files changed, 7 insertions, 34 deletions
diff --git a/src/lib/libcrypto/man/EVP_SignInit.3 b/src/lib/libcrypto/man/EVP_SignInit.3 index 06aeb2f141..59dbca1e5b 100644 --- a/src/lib/libcrypto/man/EVP_SignInit.3 +++ b/src/lib/libcrypto/man/EVP_SignInit.3 | |||
| @@ -1,4 +1,4 @@ | |||
| 1 | .\" $OpenBSD: EVP_SignInit.3,v 1.15 2022/03/31 17:27:17 naddy Exp $ | 1 | .\" $OpenBSD: EVP_SignInit.3,v 1.16 2022/07/13 19:10:40 schwarze Exp $ |
| 2 | .\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 | 2 | .\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 |
| 3 | .\" selective merge up to: OpenSSL 79b49fb0 Mar 20 10:03:10 2018 +1000 | 3 | .\" selective merge up to: OpenSSL 79b49fb0 Mar 20 10:03:10 2018 +1000 |
| 4 | .\" | 4 | .\" |
| @@ -50,16 +50,14 @@ | |||
| 50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | 50 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED |
| 51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. | 51 | .\" OF THE POSSIBILITY OF SUCH DAMAGE. |
| 52 | .\" | 52 | .\" |
| 53 | .Dd $Mdocdate: March 31 2022 $ | 53 | .Dd $Mdocdate: July 13 2022 $ |
| 54 | .Dt EVP_SIGNINIT 3 | 54 | .Dt EVP_SIGNINIT 3 |
| 55 | .Os | 55 | .Os |
| 56 | .Sh NAME | 56 | .Sh NAME |
| 57 | .Nm EVP_SignInit_ex , | 57 | .Nm EVP_SignInit_ex , |
| 58 | .Nm EVP_SignUpdate , | 58 | .Nm EVP_SignUpdate , |
| 59 | .Nm EVP_SignFinal , | 59 | .Nm EVP_SignFinal , |
| 60 | .Nm EVP_SignInit , | 60 | .Nm EVP_SignInit |
| 61 | .Nm EVP_PKEY_size , | ||
| 62 | .Nm EVP_PKEY_bits | ||
| 63 | .Nd EVP signing functions | 61 | .Nd EVP signing functions |
| 64 | .Sh SYNOPSIS | 62 | .Sh SYNOPSIS |
| 65 | .In openssl/evp.h | 63 | .In openssl/evp.h |
| @@ -87,14 +85,6 @@ | |||
| 87 | .Fa "EVP_MD_CTX *ctx" | 85 | .Fa "EVP_MD_CTX *ctx" |
| 88 | .Fa "const EVP_MD *type" | 86 | .Fa "const EVP_MD *type" |
| 89 | .Fc | 87 | .Fc |
| 90 | .Ft int | ||
| 91 | .Fo EVP_PKEY_size | ||
| 92 | .Fa "const EVP_PKEY *pkey" | ||
| 93 | .Fc | ||
| 94 | .Ft int | ||
| 95 | .Fo EVP_PKEY_bits | ||
| 96 | .Fa "const EVP_PKEY *pkey" | ||
| 97 | .Fc | ||
| 98 | .Sh DESCRIPTION | 88 | .Sh DESCRIPTION |
| 99 | The EVP signature routines are a high level interface to digital | 89 | The EVP signature routines are a high level interface to digital |
| 100 | signatures. | 90 | signatures. |
| @@ -132,7 +122,7 @@ and places the signature in | |||
| 132 | .Fa sig . | 122 | .Fa sig . |
| 133 | .Fa sig | 123 | .Fa sig |
| 134 | must be at least | 124 | must be at least |
| 135 | .Fn EVP_PKEY_size pkey | 125 | .Xr EVP_PKEY_size 3 |
| 136 | bytes in size. | 126 | bytes in size. |
| 137 | .Fa s | 127 | .Fa s |
| 138 | is an OUT parameter, and not used as an IN parameter. | 128 | is an OUT parameter, and not used as an IN parameter. |
| @@ -140,7 +130,7 @@ The number of bytes of data written (i.e.\& | |||
| 140 | the length of the signature) will be written to the integer at | 130 | the length of the signature) will be written to the integer at |
| 141 | .Fa s . | 131 | .Fa s . |
| 142 | At most | 132 | At most |
| 143 | .Fn EVP_PKEY_size pkey | 133 | .Xr EVP_PKEY_size 3 |
| 144 | bytes will be written. | 134 | bytes will be written. |
| 145 | .Pp | 135 | .Pp |
| 146 | .Fn EVP_SignInit | 136 | .Fn EVP_SignInit |
| @@ -149,12 +139,6 @@ initializes a signing context | |||
| 149 | to use the default implementation of digest | 139 | to use the default implementation of digest |
| 150 | .Fa type . | 140 | .Fa type . |
| 151 | .Pp | 141 | .Pp |
| 152 | .Fn EVP_PKEY_size | ||
| 153 | returns the maximum size of a signature in bytes. | ||
| 154 | The actual signature returned by | ||
| 155 | .Fn EVP_SignFinal | ||
| 156 | may be smaller. | ||
| 157 | .Pp | ||
| 158 | The EVP interface to digital signatures should almost always be | 142 | The EVP interface to digital signatures should almost always be |
| 159 | used in preference to the low level interfaces. | 143 | used in preference to the low level interfaces. |
| 160 | This is because the code then becomes transparent to the algorithm used | 144 | This is because the code then becomes transparent to the algorithm used |
| @@ -180,31 +164,20 @@ and | |||
| 180 | .Fn EVP_SignFinal | 164 | .Fn EVP_SignFinal |
| 181 | return 1 for success and 0 for failure. | 165 | return 1 for success and 0 for failure. |
| 182 | .Pp | 166 | .Pp |
| 183 | .Fn EVP_PKEY_size | ||
| 184 | returns the maximum size of a signature in bytes. | ||
| 185 | .Pp | ||
| 186 | .Fn EVP_PKEY_bits | ||
| 187 | returns the number of significant bits in the key | ||
| 188 | or 0 if an error occurs. | ||
| 189 | .Pp | ||
| 190 | The error codes can be obtained by | 167 | The error codes can be obtained by |
| 191 | .Xr ERR_get_error 3 . | 168 | .Xr ERR_get_error 3 . |
| 192 | .Sh SEE ALSO | 169 | .Sh SEE ALSO |
| 193 | .Xr evp 3 , | 170 | .Xr evp 3 , |
| 194 | .Xr EVP_DigestInit 3 , | 171 | .Xr EVP_DigestInit 3 , |
| 195 | .Xr EVP_PKEY_asn1_set_public 3 , | 172 | .Xr EVP_PKEY_asn1_set_public 3 , |
| 173 | .Xr EVP_PKEY_size 3 , | ||
| 196 | .Xr EVP_VerifyInit 3 | 174 | .Xr EVP_VerifyInit 3 |
| 197 | .Sh HISTORY | 175 | .Sh HISTORY |
| 198 | .Fn EVP_SignInit , | 176 | .Fn EVP_SignInit , |
| 199 | .Fn EVP_SignUpdate , | 177 | .Fn EVP_SignUpdate , |
| 200 | and | 178 | and |
| 201 | .Fn EVP_SignFinal | 179 | .Fn EVP_SignFinal |
| 202 | first appeared in SSLeay 0.5.1. | 180 | first appeared in SSLeay 0.5.1 and have been available since |
| 203 | .Fn EVP_PKEY_size | ||
| 204 | first appeared in SSLeay 0.6.0. | ||
| 205 | .Fn EVP_PKEY_bits | ||
| 206 | first appeared in SSLeay 0.9.0. | ||
| 207 | These functions have been available since | ||
| 208 | .Ox 2.4 . | 181 | .Ox 2.4 . |
| 209 | .Pp | 182 | .Pp |
| 210 | .Fn EVP_SignInit_ex | 183 | .Fn EVP_SignInit_ex |
