Home | History | Annotate | Line # | Download | only in man7 
      1 =pod
      2 
      3 =head1 NAME
      4 
      5 EVP_CIPHER-NULL - The NULL EVP_CIPHER implementation
      6 
      7 =head1 DESCRIPTION
      8 
      9 Support for a NULL symmetric encryption using the B<EVP_CIPHER> API.
     10 This is used when the TLS cipher suite is TLS_NULL_WITH_NULL_NULL.
     11 This does no encryption (just copies the data) and has a mac size of zero.
     12 
     13 =head2 Algorithm Name
     14 
     15 The following algorithm is available in the default provider:
     16 
     17 =over 4
     18 
     19 =item "NULL"
     20 
     21 =back
     22 
     23 =head2 Parameters
     24 
     25 This implementation supports the following parameters:
     26 
     27 =head3 Gettable EVP_CIPHER parameters
     28 
     29 See L<EVP_EncryptInit(3)/Gettable EVP_CIPHER parameters>
     30 
     31 =head3 Gettable EVP_CIPHER_CTX parameters
     32 
     33 =over 4
     34 
     35 =item "keylen" (B<OSSL_CIPHER_PARAM_KEYLEN>) <unsigned integer>
     36 
     37 =item "ivlen" (B<OSSL_CIPHER_PARAM_IVLEN> and <B<OSSL_CIPHER_PARAM_AEAD_IVLEN>) <unsigned integer>
     38 
     39 =item "tls-mac" (B<OSSL_CIPHER_PARAM_TLS_MAC>) <octet ptr>
     40 
     41 =back
     42 
     43 See L<EVP_EncryptInit(3)/PARAMETERS> for further information.
     44 
     45 =head3 Settable EVP_CIPHER_CTX parameters
     46 
     47 =over 4
     48 
     49 =item "tls-mac-size" (B<OSSL_CIPHER_PARAM_TLS_MAC_SIZE>) <unsigned integer>
     50 
     51 =back
     52 
     53 See L<EVP_EncryptInit(3)/PARAMETERS> for further information.
     54 
     55 =head1 CONFORMING TO
     56 
     57 RFC 5246 section-6.2.3.1
     58 
     59 =head1 SEE ALSO
     60 
     61 L<provider-cipher(7)>, L<OSSL_PROVIDER-default(7)>
     62 
     63 =head1 COPYRIGHT
     64 
     65 Copyright 2023 The OpenSSL Project Authors. All Rights Reserved.
     66 
     67 Licensed under the Apache License 2.0 (the "License").  You may not use
     68 this file except in compliance with the License.  You can obtain a copy
     69 in the file LICENSE in the source distribution or at
     70 L<https://www.openssl.org/source/license.html>.
     71 
     72 =cut
     73