From b9098d4edd48fd094afee82ed1e0324f5d247ace Mon Sep 17 00:00:00 2001 From: Shane Lontis Date: Sat, 22 May 2021 12:37:11 +1000 Subject: Add Docs for EVP_CIPHER-* Reviewed-by: Tomas Mraz (Merged from https://github.com/openssl/openssl/pull/15416) --- doc/man7/EVP_CIPHER-AES.pod | 77 +++++++++++++++++++++++++++++++++++++ doc/man7/EVP_CIPHER-ARIA.pod | 55 +++++++++++++++++++++++++++ doc/man7/EVP_CIPHER-BLOWFISH.pod | 46 ++++++++++++++++++++++ doc/man7/EVP_CIPHER-CAMELLIA.pod | 49 ++++++++++++++++++++++++ doc/man7/EVP_CIPHER-CAST.pod | 45 ++++++++++++++++++++++ doc/man7/EVP_CIPHER-CHACHA.pod | 41 ++++++++++++++++++++ doc/man7/EVP_CIPHER-DES.pod | 78 ++++++++++++++++++++++++++++++++++++++ doc/man7/EVP_CIPHER-IDEA.pod | 45 ++++++++++++++++++++++ doc/man7/EVP_CIPHER-RC2.pod | 49 ++++++++++++++++++++++++ doc/man7/EVP_CIPHER-RC4.pod | 43 +++++++++++++++++++++ doc/man7/EVP_CIPHER-RC5.pod | 47 +++++++++++++++++++++++ doc/man7/EVP_CIPHER-SEED.pod | 45 ++++++++++++++++++++++ doc/man7/EVP_CIPHER-SM4.pod | 47 +++++++++++++++++++++++ doc/man7/OSSL_PROVIDER-FIPS.pod | 2 +- doc/man7/OSSL_PROVIDER-default.pod | 8 ++-- doc/man7/OSSL_PROVIDER-legacy.pod | 16 ++++---- doc/man7/provider-cipher.pod | 2 +- 17 files changed, 682 insertions(+), 13 deletions(-) create mode 100644 doc/man7/EVP_CIPHER-AES.pod create mode 100644 doc/man7/EVP_CIPHER-ARIA.pod create mode 100644 doc/man7/EVP_CIPHER-BLOWFISH.pod create mode 100644 doc/man7/EVP_CIPHER-CAMELLIA.pod create mode 100644 doc/man7/EVP_CIPHER-CAST.pod create mode 100644 doc/man7/EVP_CIPHER-CHACHA.pod create mode 100644 doc/man7/EVP_CIPHER-DES.pod create mode 100644 doc/man7/EVP_CIPHER-IDEA.pod create mode 100644 doc/man7/EVP_CIPHER-RC2.pod create mode 100644 doc/man7/EVP_CIPHER-RC4.pod create mode 100644 doc/man7/EVP_CIPHER-RC5.pod create mode 100644 doc/man7/EVP_CIPHER-SEED.pod create mode 100644 doc/man7/EVP_CIPHER-SM4.pod (limited to 'doc/man7') diff --git a/doc/man7/EVP_CIPHER-AES.pod b/doc/man7/EVP_CIPHER-AES.pod new file mode 100644 index 0000000000..4cd59e4aae --- /dev/null +++ b/doc/man7/EVP_CIPHER-AES.pod @@ -0,0 +1,77 @@ +=pod + +=head1 NAME + +EVP_CIPHER-AES - The AES EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for AES symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the FIPS provider as well as the +default provider: + +=over 4 + +=item "AES-128-CBC", "AES-192-CBC" and "AES-256-CBC" + +=item "AES-128-CBC-CTS", "AES-192-CBC-CTS" and "AES-256-CBC-CTS" + +=item "AES-128-CFB", "AES-192-CFB", "AES-256-CFB", +"AES-128-CFB1", "AES-192-CFB1", "AES-256-CFB1", +"AES-128-CFB8", "AES-192-CFB8" and "AES-256-CFB8" + +=item "AES-128-CTR", "AES-192-CTR" and "AES-256-CTR" + +=item "AES-128-ECB", "AES-192-ECB" and "AES-256-ECB" + +=item "AES-192-OCB", "AES-128-OCB" and "AES-256-OCB" + +=item "AES-128-SIV", "AES-192-SIV" and "AES-256-SIV" + +=item "AES-128-XTS" and "AES-256-XTS" + +=item "AES-128-CCM", "AES-192-CCM" and "AES-256-CCM" + +=item "AES-128-GCM", "AES-192-GCM" and "AES-256-GCM" + +=item "AES-128-WRAP", "AES-192-WRAP", "AES-256-WRAP", +"AES-128-WRAP-PAD", "AES-192-WRAP-PAD", "AES-256-WRAP-PAD", +"AES-128-WRAP-INV", "AES-192-WRAP-INV", "AES-256-WRAP-INV", +"AES-128-WRAP-PAD-INV", "AES-192-WRAP-PAD-INV" and "AES-256-WRAP-PAD-INV" + +=item "AES-128-CBC-HMAC-SHA1", "AES-256-CBC-HMAC-SHA1", +"AES-128-CBC-HMAC-SHA256" and "AES-256-CBC-HMAC-SHA256" + +=back + +The following algorithms are available in the default provider, but not the +FIPS provider: + +=over 4 + +=item "AES-128-OFB", "AES-192-OFB" and "AES-256-OFB" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-ARIA.pod b/doc/man7/EVP_CIPHER-ARIA.pod new file mode 100644 index 0000000000..0528741665 --- /dev/null +++ b/doc/man7/EVP_CIPHER-ARIA.pod @@ -0,0 +1,55 @@ +=pod + +=head1 NAME + +EVP_CIPHER-ARIA - The ARIA EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for ARIA symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the default provider: + +=over 4 + +=item "ARIA-128-CBC", "ARIA-192-CBC" and "ARIA-256-CBC" + +=item "ARIA-128-CFB", "ARIA-192-CFB", "ARIA-256-CFB", +"ARIA-128-CFB1", "ARIA-192-CFB1", "ARIA-256-CFB1", +"ARIA-128-CFB8", "ARIA-192-CFB8" and "ARIA-256-CFB8" + +=item "ARIA-128-CTR", "ARIA-192-CTR" and "ARIA-256-CTR" + +=item "ARIA-128-ECB", "ARIA-192-ECB" and "ARIA-256-ECB" + +=item "AES-192-OCB", "AES-128-OCB" and "AES-256-OCB" + +=item "ARIA-128-OFB", "ARIA-192-OFB" and "ARIA-256-OFB" + +=item "ARIA-128-CCM", "ARIA-192-CCM" and "ARIA-256-CCM" + +=item "ARIA-128-GCM", "ARIA-192-GCM" and "ARIA-256-GCM" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-BLOWFISH.pod b/doc/man7/EVP_CIPHER-BLOWFISH.pod new file mode 100644 index 0000000000..d79fc75539 --- /dev/null +++ b/doc/man7/EVP_CIPHER-BLOWFISH.pod @@ -0,0 +1,46 @@ +=pod + +=head1 NAME + +EVP_CIPHER-BLOWFISH - The BLOBFISH EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for BLOWFISH symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "BF-ECB" + +=item "BF-CBC" + +=item "BF-OFB" + +=item "BF-CFB" + +=back + + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-CAMELLIA.pod b/doc/man7/EVP_CIPHER-CAMELLIA.pod new file mode 100644 index 0000000000..7b129c6407 --- /dev/null +++ b/doc/man7/EVP_CIPHER-CAMELLIA.pod @@ -0,0 +1,49 @@ +=pod + +=head1 NAME + +EVP_CIPHER-CAMELLIA - The CAMELLIA EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for CAMELLIA symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the default provider: + +=over 4 + +=item "CAMELLIA-128-CBC", "CAMELLIA-192-CBC" and "CAMELLIA-256-CBC" + +=item "CAMELLIA-128-CFB", "CAMELLIA-192-CFB", "CAMELLIA-256-CFB", +"CAMELLIA-128-CFB1", "CAMELLIA-192-CFB1", "CAMELLIA-256-CFB1", +"CAMELLIA-128-CFB8", "CAMELLIA-192-CFB8" and "CAMELLIA-256-CFB8" + +=item "CAMELLIA-128-CTR", "CAMELLIA-192-CTR" and "CAMELLIA-256-CTR" + +=item "CAMELLIA-128-ECB", "CAMELLIA-192-ECB" and "CAMELLIA-256-ECB" + +=item "CAMELLIA-192-OFB", "CAMELLIA-128-OFB" and "CAMELLIA-256-OFB" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-CAST.pod b/doc/man7/EVP_CIPHER-CAST.pod new file mode 100644 index 0000000000..e68751d643 --- /dev/null +++ b/doc/man7/EVP_CIPHER-CAST.pod @@ -0,0 +1,45 @@ +=pod + +=head1 NAME + +EVP_CIPHER-CAST - The CAST EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for CAST symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "CAST-128-CBC", "CAST-192-CBC" and "CAST-256-CBC" + +=item "CAST-128-CFB", "CAST-192-CFB", "CAST-256-CFB" + +=item "CAST-128-ECB", "CAST-192-ECB" and "CAST-256-ECB" + +=item "CAST-192-OFB", "CAST-128-OFB" and "CAST-256-OFB" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-CHACHA.pod b/doc/man7/EVP_CIPHER-CHACHA.pod new file mode 100644 index 0000000000..b7d57481ac --- /dev/null +++ b/doc/man7/EVP_CIPHER-CHACHA.pod @@ -0,0 +1,41 @@ +=pod + +=head1 NAME + +EVP_CIPHER-CHACHA - The CHACHA EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for CHACHA symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the default provider: + +=over 4 + +=item "ChaCha20" + +=item "ChaCha20-Poly1305" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-DES.pod b/doc/man7/EVP_CIPHER-DES.pod new file mode 100644 index 0000000000..25603f6fc6 --- /dev/null +++ b/doc/man7/EVP_CIPHER-DES.pod @@ -0,0 +1,78 @@ +=pod + +=head1 NAME + +EVP_CIPHER-DES - The DES EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for DES symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the FIPS provider as well as the +default provider: + +=over 4 + +=item "DES-EDE3-ECB" or "DES-EDE3" + +=item "DES-EDE3-CBC" or "DES3" + +=back + +The following algorithms are available in the default provider, but not the +FIPS provider: + +=over 4 + +=item "DES-EDE3-CFB8" and "DES-EDE3-CFB1" + +=item "DES-EDE-ECB" or "DES-EDE" + +=item "DES-EDE-CBC" + +=item "DES-EDE-OFB" + +=item "DES-EDE-CFB" + +=item "DES3-WRAP" + +=back + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "DES-ECB" + +=item "DES-CBC" + +=item "DES-OFB" + +=item "DES-CFB", "DES-CFB1" and "DES-CFB8" + +=item "DESX-CBC" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L, L, +L, + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-IDEA.pod b/doc/man7/EVP_CIPHER-IDEA.pod new file mode 100644 index 0000000000..29041592c7 --- /dev/null +++ b/doc/man7/EVP_CIPHER-IDEA.pod @@ -0,0 +1,45 @@ +=pod + +=head1 NAME + +EVP_CIPHER-IDEA - The IDEA EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for IDEA symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "IDEA-ECB" + +=item "IDEA-CBC" + +=item "IDEA-OFB" or "IDEA-OFB64" + +=item "IDEA-CFB" or "IDEA-CFB64" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-RC2.pod b/doc/man7/EVP_CIPHER-RC2.pod new file mode 100644 index 0000000000..8a69a74622 --- /dev/null +++ b/doc/man7/EVP_CIPHER-RC2.pod @@ -0,0 +1,49 @@ +=pod + +=head1 NAME + +EVP_CIPHER-RC2 - The RC2 EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for RC2 symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "RC2-CBC", "RC2" or "RC2-128" + +=item "RC2-40-CBC" or "RC2-40" + +=item "RC2-64-CBC" or "RC2-64" + +=item "RC2-ECB" + +=item "RC2-CFB" + +=item "RC2-OFB" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-RC4.pod b/doc/man7/EVP_CIPHER-RC4.pod new file mode 100644 index 0000000000..309b7e24a0 --- /dev/null +++ b/doc/man7/EVP_CIPHER-RC4.pod @@ -0,0 +1,43 @@ +=pod + +=head1 NAME + +EVP_CIPHER-RC4 - The RC4 EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for RC4 symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "RC4" + +=item "RC4-40" + +=item "RC4-HMAC-MD5" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-RC5.pod b/doc/man7/EVP_CIPHER-RC5.pod new file mode 100644 index 0000000000..84204834b1 --- /dev/null +++ b/doc/man7/EVP_CIPHER-RC5.pod @@ -0,0 +1,47 @@ +=pod + +=head1 NAME + +EVP_CIPHER-RC5 - The RC5 EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for RC5 symmetric encryption using the B API. + +Disabled by default. Use the I configuration option to enable. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "RC5-CBC" or "RC5" + +=item "RC5-ECB" + +=item "RC5-OFB" + +=item "RC5-CFB" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-SEED.pod b/doc/man7/EVP_CIPHER-SEED.pod new file mode 100644 index 0000000000..07b28917f8 --- /dev/null +++ b/doc/man7/EVP_CIPHER-SEED.pod @@ -0,0 +1,45 @@ +=pod + +=head1 NAME + +EVP_CIPHER-SEED - The SEED EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for SEED symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the legacy provider: + +=over 4 + +=item "SEED-CBC" or "SEED" + +=item "SEED-ECB" + +=item "SEED-OFB" or "SEED-OFB128" + +=item "SEED-CFB" or "SEED-CFB128" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/EVP_CIPHER-SM4.pod b/doc/man7/EVP_CIPHER-SM4.pod new file mode 100644 index 0000000000..36a51d18a4 --- /dev/null +++ b/doc/man7/EVP_CIPHER-SM4.pod @@ -0,0 +1,47 @@ +=pod + +=head1 NAME + +EVP_CIPHER-SM4 - The SM4 EVP_CIPHER implementations + +=head1 DESCRIPTION + +Support for SM4 symmetric encryption using the B API. + +=head2 Algorithm Names + +The following algorithms are available in the default provider: + +=over 4 + +=item "SM4-CBC:SM4" + +=item "SM4-ECB" + +=item "SM4-CTR" + +=item "SM4-OFB" or "SM4-OFB128" + +=item "SM4-CFB" or "SM4-CFB128" + +=back + +=head2 Parameters + +This implementation supports the parameters described in +L. + +=head1 SEE ALSO + +L, L + +=head1 COPYRIGHT + +Copyright 2021 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 diff --git a/doc/man7/OSSL_PROVIDER-FIPS.pod b/doc/man7/OSSL_PROVIDER-FIPS.pod index a1b03e9b19..af423e6224 100644 --- a/doc/man7/OSSL_PROVIDER-FIPS.pod +++ b/doc/man7/OSSL_PROVIDER-FIPS.pod @@ -62,7 +62,7 @@ The OpenSSL FIPS provider supports these operations and algorithms: =item AES, see L -=item DES-EDE3 (TrippleDES), see L +=item DES-EDE3 (TripleDES), see L =back diff --git a/doc/man7/OSSL_PROVIDER-default.pod b/doc/man7/OSSL_PROVIDER-default.pod index 2175e27af3..88ae3fec9d 100644 --- a/doc/man7/OSSL_PROVIDER-default.pod +++ b/doc/man7/OSSL_PROVIDER-default.pod @@ -83,11 +83,11 @@ The OpenSSL default provider supports these operations and algorithms: =item DES, see L -=item BF, see L +=item BF, see L =item IDEA, see L -=item CAST5, see L +=item CAST5, see L =item SEED, see L @@ -99,9 +99,9 @@ The OpenSSL default provider supports these operations and algorithms: =item RC5, see L -=item ChaCha20, see L +=item ChaCha20, see L -=item ChaCha20-Poly1305, see L +=item ChaCha20-Poly1305, see L =back diff --git a/doc/man7/OSSL_PROVIDER-legacy.pod b/doc/man7/OSSL_PROVIDER-legacy.pod index 0e2965d618..d2fdfe3676 100644 --- a/doc/man7/OSSL_PROVIDER-legacy.pod +++ b/doc/man7/OSSL_PROVIDER-legacy.pod @@ -58,24 +58,26 @@ Not all of these symmetric cipher algorithms are enabled by default. =over 4 -=item Blowfish +=item Blowfish, see L -=item CAST +=item CAST, see L -=item DES +=item DES, see L The algorithm names are: DES_ECB, DES_CBC, DES_OFB, DES_CFB, DES_CFB1, DES_CFB8 and DESX_CBC. -=item RC2 +=item IDEA, see L -=item RC4 +=item RC2, see L -=item RC5 +=item RC4, see L + +=item RC5, see L Disabled by default. Use I config option to enable. -=item SEED +=item SEED, see L =back diff --git a/doc/man7/provider-cipher.pod b/doc/man7/provider-cipher.pod index 900db616ba..52e8417e73 100644 --- a/doc/man7/provider-cipher.pod +++ b/doc/man7/provider-cipher.pod @@ -204,7 +204,7 @@ provider side algorithm I. Parameters currently recognised by built-in ciphers are listed in L. -Not all parameters are relevant to, or are understood by all ciphers: +Not all parameters are relevant to, or are understood by all ciphers. =head1 RETURN VALUES -- cgit v1.2.1