diff options
author | Pauli <paul.dale@oracle.com> | 2019-09-26 12:14:00 +1000 |
---|---|---|
committer | Pauli <paul.dale@oracle.com> | 2019-09-27 16:21:51 +1000 |
commit | d56eba1fd109faa2c25fcb7cb2d9ee85e62b827f (patch) | |
tree | 5a6c61cd87b3ae9d6c0705ea924a890ab62d3763 /doc/man7/provider-cipher.pod | |
parent | 318e074e1f55c556d0ab4f9e3fbdca7c9b284847 (diff) |
Make OSSL_PARAM descriptions uniformly formatted.
=item B<MACRO> ("name") <type>
Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/10024)
Diffstat (limited to 'doc/man7/provider-cipher.pod')
-rw-r--r-- | doc/man7/provider-cipher.pod | 38 |
1 files changed, 23 insertions, 15 deletions
diff --git a/doc/man7/provider-cipher.pod b/doc/man7/provider-cipher.pod index d5d2f13390..4753c326a0 100644 --- a/doc/man7/provider-cipher.pod +++ b/doc/man7/provider-cipher.pod @@ -197,18 +197,18 @@ parameters are relevant to, or are understood by all ciphers: =over 4 -=item B<OSSL_CIPHER_PARAM_PADDING> (uint) +=item B<OSSL_CIPHER_PARAM_PADDING> ("padding") <unsigned integer> Sets the padding mode for the associated cipher ctx. Setting a value of 1 will turn padding on. Setting a value of 0 will turn padding off. -=item B<OSSL_CIPHER_PARAM_MODE> (uint) +=item B<OSSL_CIPHER_PARAM_MODE> ("mode") <unsigned integer> Gets the mode for the associated cipher algorithm. See L<EVP_CIPHER_mode(3)> for a list of valid modes. -=item B<OSSL_CIPHER_PARAM_BLOCK_SIZE> (size_t) +=item B<OSSL_CIPHER_PARAM_BLOCK_SIZE> ("blocksize") <unsigned integer> Gets the block size for the associated cipher algorithm. The block size should be 1 for stream ciphers. @@ -216,44 +216,50 @@ Note that the block size for a cipher may be different to the block size for the underlying encryption/decryption primitive. For example AES in CTR mode has a block size of 1 (because it operates like a stream cipher), even though AES has a block size of 16. +The length of the "blocksize" parameter should not exceed that of a B<size_t>. -=item B<OSSL_CIPHER_PARAM_FLAGS> (ulong) +=item B<OSSL_CIPHER_PARAM_FLAGS> ("flags") <unsigned integer> Gets any flags for the associated cipher algorithm. See L<EVP_CIPHER_meth_set_flags(3)> for a list of currently defined cipher flags. +The length of the "flags" parameter should equal that of an +B<unsigned long int>. -=item B<OSSL_CIPHER_PARAM_KEYLEN> (size_t) +=item B<OSSL_CIPHER_PARAM_KEYLEN> ("keylen") <unsigned integer> Gets the key length for the associated cipher algorithm. This can also be used to get or set the key length for the associated cipher ctx. +The length of the "keylen" parameter should not exceed that of a B<size_t>. -=item B<OSSL_CIPHER_PARAM_IVLEN> (size_t) +=item B<OSSL_CIPHER_PARAM_IVLEN> ("ivlen") <unsigned integer> Gets the IV length for the associated cipher algorithm. +The length of the "ivlen" parameter should not exceed that of a B<size_t>. -=item B<OSSL_CIPHER_PARAM_IV> (octet_string OR octet_ptr) +=item B<OSSL_CIPHER_PARAM_IV> ("iv") <octet string OR octet ptr> Gets the IV for the associated cipher ctx. -=item B<OSSL_CIPHER_PARAM_NUM> (uint) +=item B<OSSL_CIPHER_PARAM_NUM> ("num") <unsigned integer> Gets or sets the cipher specific "num" parameter for the associated cipher ctx. Built-in ciphers typically use this to track how much of the current underlying block has been "used" already. -=item B<OSSL_CIPHER_PARAM_AEAD_TAG> (octet_string) +=item B<OSSL_CIPHER_PARAM_AEAD_TAG> ("tag") <octet string> Gets or sets the AEAD tag for the associated cipher ctx. See L<EVP_EncryptInit(3)/AEAD Interface>. -=item B<OSSL_CIPHER_PARAM_AEAD_TAGLEN> (size_t) +=item B<OSSL_CIPHER_PARAM_AEAD_TAGLEN> ("taglen") <unsigned integer> Gets the tag length to be used for an AEAD cipher for the associated cipher ctx. It returns a default value if it has not been set. +The length of the "taglen" parameter should not exceed that of a B<size_t>. -=item B<OSSL_CIPHER_PARAM_AEAD_TLS1_AAD> (octet_string) +=item B<OSSL_CIPHER_PARAM_AEAD_TLS1_AAD> ("tlsaad") <octet string> =for comment TODO(3.0): Consider changing this interface so that all ciphers use the standard AEAD interface - rather than having this special purpose @@ -263,12 +269,13 @@ Sets TLSv1.2 AAD information for the associated cipher ctx. TLSv1.2 AAD information is always 13 bytes in length and is as defined for the "additional_data" field described in section 6.2.3.3 of RFC5246. -=item B<OSSL_CIPHER_PARAM_AEAD_TLS1_AAD_PAD> (size_t) +=item B<OSSL_CIPHER_PARAM_AEAD_TLS1_AAD_PAD> ("tlsaadpad") <unsigned integer> Gets the length of the tag that will be added to a TLS record for the AEAD tag for the associated cipher ctx. +The length of the "tlsaadpad" parameter should not exceed that of a B<size_t>. -=item B<OSSL_CIPHER_PARAM_AEAD_TLS1_IV_FIXED> (octet_string) +=item B<OSSL_CIPHER_PARAM_AEAD_TLS1_IV_FIXED> ("tlsivfixed") <octet string> =for comment TODO(3.0): This interface needs completely redesigning! @@ -303,11 +310,12 @@ Whether encrypting or decrypting the value written to B<*outl> in the OP_cipher_cipher call should be the length of the payload excluding the explicit IV length and the tag length. -=item B<OSSL_CIPHER_PARAM_AEAD_IVLEN> (size_t) +=item B<OSSL_CIPHER_PARAM_AEAD_IVLEN> ("ivlen") <unsigned integer> Sets the IV length to be used for an AEAD cipher for the associated cipher ctx. +The length of the "ivlen" parameter should not exceed that of a B<size_t>. -=item B<OSSL_CIPHER_PARAM_RANDOM_KEY> (octet_string) +=item B<OSSL_CIPHER_PARAM_RANDOM_KEY> ("randkey") <octet string> Gets a implementation specific randomly generated key for the associated cipher ctx. This is currently only supported by 3DES (which sets the key to |