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 |