From: Dmitry Belyavskiy Date: Tue, 10 Jan 2023 17:54:51 +0000 (+0100) Subject: Documenting lack of error codes stability X-Git-Tag: openssl-3.2.0-alpha1~1453 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ae61bd34e676036f22e44e8184d1ba649a990619;p=thirdparty%2Fopenssl.git Documenting lack of error codes stability Reviewed-by: Hugo Landau Reviewed-by: Matt Caswell Reviewed-by: Tomas Mraz (Merged from https://github.com/openssl/openssl/pull/20019) --- diff --git a/doc/man3/ERR_GET_LIB.pod b/doc/man3/ERR_GET_LIB.pod index f0779548e6d..a35165b059f 100644 --- a/doc/man3/ERR_GET_LIB.pod +++ b/doc/man3/ERR_GET_LIB.pod @@ -42,6 +42,14 @@ The library number, reason code, and whether the error is fatal, respectively. Starting with OpenSSL 3.0.0, the function code is always set to zero. +=head1 NOTES + +Applications should not make control flow decisions based on specific error +codes. Error codes are subject to change at any time (even in patch releases of +OpenSSL). A particular error code can only be considered meaningful for control +flow decisions if it is explicitly documented as such. New failure codes may +still appear at any time. + =head1 SEE ALSO L