summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorTheo Buehler <tb@cvs.openbsd.org>2023-04-15 18:59:50 +0000
committerTheo Buehler <tb@cvs.openbsd.org>2023-04-15 18:59:50 +0000
commit5978d65a2c5839b1e13c94b6a0853894418832dc (patch)
treeadcfcd534ebe21a709f613c05cda181644e3ef10 /lib
parent4e7c2af999c3428088e97c9691b86368ed686662 (diff)
Adjust documentation of X9.31 padding mode
Diffstat (limited to 'lib')
-rw-r--r--lib/libcrypto/man/RSA_pkey_ctx_ctrl.312
1 files changed, 6 insertions, 6 deletions
diff --git a/lib/libcrypto/man/RSA_pkey_ctx_ctrl.3 b/lib/libcrypto/man/RSA_pkey_ctx_ctrl.3
index c89ceec4363..582581b8f75 100644
--- a/lib/libcrypto/man/RSA_pkey_ctx_ctrl.3
+++ b/lib/libcrypto/man/RSA_pkey_ctx_ctrl.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: RSA_pkey_ctx_ctrl.3,v 1.4 2019/11/01 19:37:21 schwarze Exp $
+.\" $OpenBSD: RSA_pkey_ctx_ctrl.3,v 1.5 2023/04/15 18:59:49 tb Exp $
.\" full merge up to:
.\" OpenSSL man3/EVP_PKEY_CTX_ctrl.pod 99d63d46 Oct 26 13:56:48 2016 -0400
.\" OpenSSL man3/EVP_PKEY_CTX_set_rsa_pss_keygen_md.pod
@@ -55,7 +55,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 1 2019 $
+.Dd $Mdocdate: April 15 2023 $
.Dt RSA_PKEY_CTX_CTRL 3
.Os
.Sh NAME
@@ -189,12 +189,14 @@ for PKCS#1 padding,
for no padding,
.Dv RSA_PKCS1_OAEP_PADDING
for OAEP padding (encrypt and decrypt only),
-.Dv RSA_X931_PADDING
-for X9.31 padding (signature operations only) and
.Dv RSA_PKCS1_PSS_PADDING
(sign and verify only).
Only the last one can be used with keys of the type
.Dv EVP_PKEY_RSA_PSS .
+X9.31 padding mode is unsupported.
+.Dv RSA_X931_PADDING
+is provided for backward compatibility with some existing
+application software.
.Pp
Two RSA padding modes behave differently if
.Xr EVP_PKEY_CTX_set_signature_md 3
@@ -206,8 +208,6 @@ structure according to PKCS#1 when signing and this structure is
expected (and stripped off) when verifying.
If this control is not used with RSA and PKCS#1 padding then the
supplied data is used directly and not encapsulated.
-In the case of X9.31 padding for RSA the algorithm identifier byte is
-added or checked and removed if this control is called.
If it is not called then the first byte of the plaintext buffer is
expected to be the algorithm identifier byte.
.Pp