blob: 7398a294c9e1e696ca7a096d5dec5a2d5ed505a3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
.Dd $Mdocdate: November 4 2016 $
.Dt RSA_SIGN_ASN1_OCTET_STRING 3
.Os
.Sh NAME
.Nm RSA_sign_ASN1_OCTET_STRING ,
.Nm RSA_verify_ASN1_OCTET_STRING
.Nd RSA signatures
.Sh SYNOPSIS
.In openssl/rsa.h
.Ft int
.Fo RSA_sign_ASN1_OCTET_STRING
.Fa "int dummy"
.Fa "unsigned char *m"
.Fa "unsigned int m_len"
.Fa "unsigned char *sigret"
.Fa "unsigned int *siglen"
.Fa "RSA *rsa"
.Fc
.Ft int
.Fo RSA_verify_ASN1_OCTET_STRING
.Fa "int dummy"
.Fa "unsigned char *m"
.Fa "unsigned int m_len"
.Fa "unsigned char *sigbuf"
.Fa "unsigned int siglen"
.Fa "RSA *rsa"
.Fc
.Sh DESCRIPTION
.Fn RSA_sign_ASN1_OCTET_STRING
signs the octet string
.Fa m
of size
.Fa m_len
using the private key
.Fa rsa
represented in DER using PKCS #1 padding.
It stores the signature in
.Fa sigret
and the signature size in
.Fa siglen .
.Fa sigret
must point to
.Fn RSA_size rsa
bytes of memory.
.Pp
.Fa dummy
is ignored.
.Pp
.Fn RSA_verify_ASN1_OCTET_STRING
verifies that the signature
.Fa sigbuf
of size
.Fa siglen
is the DER representation of a given octet string
.Fa m
of size
.Fa m_len .
.Fa dummy
is ignored.
.Fa rsa
is the signer's public key.
.Sh RETURN VALUES
.Fn RSA_sign_ASN1_OCTET_STRING
returns 1 on success or 0 otherwise.
.Fn RSA_verify_ASN1_OCTET_STRING
returns 1 on successful verification or 0 otherwise.
.Pp
The error codes can be obtained by
.Xr ERR_get_error 3 .
.Sh SEE ALSO
.Xr ERR_get_error 3 ,
.Xr rsa 3 ,
.Xr RSA_sign 3 ,
.Xr RSA_verify 3
.Sh HISTORY
.Fn RSA_sign_ASN1_OCTET_STRING
and
.Fn RSA_verify_ASN1_OCTET_STRING
were added in SSLeay 0.8.
.Sh BUGS
These functions serve no recognizable purpose.
|