From 016428cfc5d72786c43245b2bc879963e4dd6a0f Mon Sep 17 00:00:00 2001 From: Rajeev Ranjan Date: Wed, 6 Mar 2024 15:25:01 +0100 Subject: [PATCH] fixup! remove old code with EVP cipher --- doc/man7/EVP_CIPHER-NULL.pod | 60 +++++++++++++++++++++++------------- 1 file changed, 38 insertions(+), 22 deletions(-) diff --git a/doc/man7/EVP_CIPHER-NULL.pod b/doc/man7/EVP_CIPHER-NULL.pod index dbb767099d13bf..44e07dcf1b0562 100644 --- a/doc/man7/EVP_CIPHER-NULL.pod +++ b/doc/man7/EVP_CIPHER-NULL.pod @@ -2,55 +2,71 @@ =head1 NAME -EVP_CIPHER-NULL - NULL encryption EVP_CIPHER implementation +EVP_CIPHER-NULL - The NULL EVP_CIPHER implementation =head1 DESCRIPTION -This module provides support for NULL encryption using the B API. -It simply copies the data without any encryption. +Support for a NULL symmetric encryption using the B API. +This is used when the TLS cipher suite is TLS_NULL_WITH_NULL_NULL. +This does no encryption (just copies the data) and has a mac size of zero. -=head2 Algorithm Names +=head2 Algorithm Name -The default provider offers the following algorithms: +The following algorithm is available in the default provider: =over 4 =item "NULL" -=item "NULL-HMAC-SHA256" and "NULL-HMAC-SHA384" - =back =head2 Parameters -The parameters supported by this implementation are detailed in -L. +This implementation supports the following parameters: -=head1 NOTES +=head3 Gettable EVP_CIPHER parameters -"NULL" algorithm is used when the TLS cipher suite is TLS_NULL_WITH_NULL_NULL. -This does no encryption (just copies the data) and has a mac size of zero. -This conforms to RFC 5246 section-6.2.3.1. +See L -"NULL-HMAC-SHA256" and "NULL-HMAC-SHA384" are used when the TLS cipher suite is -TLS_SHA256_SHA256 and TLS_SHA384_SHA384 respectively. -This conforms to RFC 9150. +=head3 Gettable EVP_CIPHER_CTX parameters -=head1 SEE ALSO +=over 4 -L, L +=item "keylen" (B) + +=item "ivlen" (B and ) + +=item "tls-mac" (B) + +=back + +See L for further information. -=head1 HISTORY +=head3 Settable EVP_CIPHER_CTX parameters -The NULL-HMAC-SHA256 and NULL-HMAC-SHA384 ciphers were added in OpenSSL version 3.3. +=over 4 + +=item "tls-mac-size" (B) + +=back + +See L for further information. + +=head1 CONFORMING TO + +RFC 5246 section-6.2.3.1 + +=head1 SEE ALSO + +L, L =head1 COPYRIGHT -Copyright 2021-2024 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2023 The OpenSSL Project Authors. All Rights Reserved. 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 in the file LICENSE in the source distribution or at L. -=cut \ No newline at end of file +=cut