aboutsummaryrefslogtreecommitdiff
path: root/secure/lib/libcrypto/man/man3/RSA_set_method.3
diff options
context:
space:
mode:
Diffstat (limited to 'secure/lib/libcrypto/man/man3/RSA_set_method.3')
-rw-r--r--secure/lib/libcrypto/man/man3/RSA_set_method.327
1 files changed, 12 insertions, 15 deletions
diff --git a/secure/lib/libcrypto/man/man3/RSA_set_method.3 b/secure/lib/libcrypto/man/man3/RSA_set_method.3
index 5e7844cb54bb..f992c549665d 100644
--- a/secure/lib/libcrypto/man/man3/RSA_set_method.3
+++ b/secure/lib/libcrypto/man/man3/RSA_set_method.3
@@ -1,5 +1,5 @@
.\" -*- mode: troff; coding: utf-8 -*-
-.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
+.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -52,10 +52,13 @@
. \}
.\}
.rr rF
+.\"
+.\" Required to disable full justification in groff 1.23.0.
+.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "RSA_SET_METHOD 3ossl"
-.TH RSA_SET_METHOD 3ossl 2025-09-30 3.5.4 OpenSSL
+.TH RSA_SET_METHOD 3ossl 2026-04-07 3.5.6 OpenSSL
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -107,7 +110,7 @@ as returned by \fBRSA_PKCS1_OpenSSL()\fR.
structures created later.
\&\fBNB\fR: This is true only whilst no ENGINE has
been set as a default for RSA, so this function is no longer recommended.
-This function is not thread-safe and should not be called at the same time
+This function is not thread\-safe and should not be called at the same time
as other OpenSSL functions.
.PP
\&\fBRSA_get_default_method()\fR returns a pointer to the current default
@@ -120,7 +123,7 @@ recommended.
previous method was supplied by an ENGINE, the handle to that ENGINE will
be released during the change. It is possible to have RSA keys that only
work with certain RSA_METHOD implementations (e.g. from an ENGINE module
-that supports embedded hardware-protected keys), and in such cases
+that supports embedded hardware\-protected keys), and in such cases
attempting to change the RSA_METHOD for the key can have unexpected
results.
.PP
@@ -130,7 +133,7 @@ it is, the return value can only be guaranteed to be valid as long as the
RSA key itself is valid and does not have its implementation changed by
\&\fBRSA_set_method()\fR.
.PP
-\&\fBRSA_flags()\fR returns the \fBflags\fR that are set for \fBrsa\fR's current
+\&\fBRSA_flags()\fR returns the \fBflags\fR that are set for \fBrsa\fR\*(Aqs current
RSA_METHOD. See the BUGS section.
.PP
\&\fBRSA_new_method()\fR allocates and initializes an RSA structure so that
@@ -138,7 +141,7 @@ RSA_METHOD. See the BUGS section.
default ENGINE for RSA operations is used, and if no default ENGINE is set,
the RSA_METHOD controlled by \fBRSA_set_default_method()\fR is used.
.PP
-\&\fBRSA_flags()\fR returns the \fBflags\fR that are set for \fBrsa\fR's current method.
+\&\fBRSA_flags()\fR returns the \fBflags\fR that are set for \fBrsa\fR\*(Aqs current method.
.PP
\&\fBRSA_new_method()\fR allocates and initializes an \fBRSA\fR structure so that
\&\fBmethod\fR will be used for the RSA operations. If \fBmethod\fR is \fBNULL\fR,
@@ -209,20 +212,14 @@ and \fBRSA_get_method()\fR return pointers to the respective RSA_METHODs.
.PP
\&\fBRSA_set_default_method()\fR returns no value.
.PP
-\&\fBRSA_set_method()\fR returns a pointer to the old RSA_METHOD implementation
-that was replaced. However, this return value should probably be ignored
-because if it was supplied by an ENGINE, the pointer could be invalidated
-at any time if the ENGINE is unloaded (in fact it could be unloaded as a
-result of the \fBRSA_set_method()\fR function releasing its handle to the
-ENGINE). For this reason, the return type may be replaced with a \fBvoid\fR
-declaration in a future release.
+\&\fBRSA_set_method()\fR returns 1 for success. It always succeeds.
.PP
\&\fBRSA_new_method()\fR returns NULL and sets an error code that can be obtained
by \fBERR_get_error\fR\|(3) if the allocation fails. Otherwise
it returns a pointer to the newly allocated structure.
.SH BUGS
.IX Header "BUGS"
-The behaviour of \fBRSA_flags()\fR is a mis-feature that is left as-is for now
+The behaviour of \fBRSA_flags()\fR is a mis\-feature that is left as\-is for now
to avoid creating compatibility problems. RSA functionality, such as the
encryption functions, are controlled by the \fBflags\fR value in the RSA key
itself, not by the \fBflags\fR value in the RSA_METHOD attached to the RSA key
@@ -242,7 +239,7 @@ The \fBRSA_null_method()\fR, which was a partial attempt to avoid patent issues,
was replaced to always return NULL in OpenSSL 1.1.1.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
-Copyright 2000\-2020 The OpenSSL Project Authors. All Rights Reserved.
+Copyright 2000\-2026 The OpenSSL Project Authors. All Rights Reserved.
.PP
Licensed under the Apache License 2.0 (the "License"). You may not use
this file except in compliance with the License. You can obtain a copy