summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/EVP_SignInit.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/EVP_SignInit.3')
-rw-r--r--src/lib/libcrypto/man/EVP_SignInit.341
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
99The EVP signature routines are a high level interface to digital 89The EVP signature routines are a high level interface to digital
100signatures. 90signatures.
@@ -132,7 +122,7 @@ and places the signature in
132.Fa sig . 122.Fa sig .
133.Fa sig 123.Fa sig
134must be at least 124must be at least
135.Fn EVP_PKEY_size pkey 125.Xr EVP_PKEY_size 3
136bytes in size. 126bytes in size.
137.Fa s 127.Fa s
138is an OUT parameter, and not used as an IN parameter. 128is an OUT parameter, and not used as an IN parameter.
@@ -140,7 +130,7 @@ The number of bytes of data written (i.e.\&
140the length of the signature) will be written to the integer at 130the length of the signature) will be written to the integer at
141.Fa s . 131.Fa s .
142At most 132At most
143.Fn EVP_PKEY_size pkey 133.Xr EVP_PKEY_size 3
144bytes will be written. 134bytes will be written.
145.Pp 135.Pp
146.Fn EVP_SignInit 136.Fn EVP_SignInit
@@ -149,12 +139,6 @@ initializes a signing context
149to use the default implementation of digest 139to use the default implementation of digest
150.Fa type . 140.Fa type .
151.Pp 141.Pp
152.Fn EVP_PKEY_size
153returns the maximum size of a signature in bytes.
154The actual signature returned by
155.Fn EVP_SignFinal
156may be smaller.
157.Pp
158The EVP interface to digital signatures should almost always be 142The EVP interface to digital signatures should almost always be
159used in preference to the low level interfaces. 143used in preference to the low level interfaces.
160This is because the code then becomes transparent to the algorithm used 144This is because the code then becomes transparent to the algorithm used
@@ -180,31 +164,20 @@ and
180.Fn EVP_SignFinal 164.Fn EVP_SignFinal
181return 1 for success and 0 for failure. 165return 1 for success and 0 for failure.
182.Pp 166.Pp
183.Fn EVP_PKEY_size
184returns the maximum size of a signature in bytes.
185.Pp
186.Fn EVP_PKEY_bits
187returns the number of significant bits in the key
188or 0 if an error occurs.
189.Pp
190The error codes can be obtained by 167The 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 ,
200and 178and
201.Fn EVP_SignFinal 179.Fn EVP_SignFinal
202first appeared in SSLeay 0.5.1. 180first appeared in SSLeay 0.5.1 and have been available since
203.Fn EVP_PKEY_size
204first appeared in SSLeay 0.6.0.
205.Fn EVP_PKEY_bits
206first appeared in SSLeay 0.9.0.
207These 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