|
|
virtual | ~BlockCipher () |
| | Virtual destructor.
|
| |
| virtual size_t | blockSize () const =0 |
| | Size in bytes of the block used by the algorithm. More...
|
| |
| virtual bool | decrypt (const void *cipher, size_t cipher_length, void *plain, size_t plain_maxsize, size_t *plain_length=nullptr)=0 |
| | Decrypt one block of data. More...
|
| |
| virtual bool | decryptInPlace (void *data, size_t data_length, size_t *max_actual_length=nullptr) |
| | Decrypt one block of data in place. More...
|
| |
| virtual size_t | defaultRounds () const =0 |
| | Default number of rounds for the algorithm. More...
|
| |
| virtual bool | encrypt (const void *plain, size_t plain_length, void *cipher, size_t cipher_maxsize, size_t *cipher_length=nullptr)=0 |
| | Encrypt one block of data. More...
|
| |
| virtual bool | encryptInPlace (void *data, size_t data_length, size_t *max_actual_length=nullptr) |
| | Encrypt one block of data in place. More...
|
| |
| virtual bool | isValidKeySize (size_t size) const =0 |
| | Check if a size in bytes is a valid key size. More...
|
| |
| virtual size_t | maxKeySize () const =0 |
| | Maximum key sizes in bytes. More...
|
| |
| virtual size_t | maxRounds () const =0 |
| | Maximum number of rounds for the algorithm. More...
|
| |
| virtual size_t | minKeySize () const =0 |
| | Minimum key sizes in bytes. More...
|
| |
| virtual size_t | minRounds () const =0 |
| | Minimum number of rounds for the algorithm. More...
|
| |
| virtual UString | name () const =0 |
| | Algorithm name (informational only). More...
|
| |
| virtual bool | setKey (const void *key, size_t key_length, size_t rounds=0)=0 |
| | Schedule a new key. More...
|
| |
Abstract interface of block ciphers.
| virtual bool ts::BlockCipher::encrypt |
( |
const void * |
plain, |
|
|
size_t |
plain_length, |
|
|
void * |
cipher, |
|
|
size_t |
cipher_maxsize, |
|
|
size_t * |
cipher_length = nullptr |
|
) |
| |
|
pure virtual |
Encrypt one block of data.
For pure block ciphers such as AES or DES, the plain text and cipher text must have the block size of the algorithm. For cipher chainings, the acceptable message sizes depend on the chaining mode.
- Parameters
-
| [in] | plain | Address of plain text. |
| [in] | plain_length | Plain text length in bytes. |
| [out] | cipher | Address of buffer for cipher text. |
| [in] | cipher_maxsize | Size of cipher buffer. |
| [out] | cipher_length | Returned actual size of cipher text. Ignored if zero. |
- Returns
- True on success, false on error.
Implemented in ts::DVBCSA2, ts::DVS042< CIPHER >, ts::DVS042< AES >, ts::DVS042< DES >, ts::CBC< CIPHER >, ts::CBC< AES >, ts::CTS1< CIPHER >, ts::CTS3< CIPHER >, ts::CTS2< CIPHER >, ts::CTS4< CIPHER >, ts::AES, ts::ECB< CIPHER >, ts::DES, and ts::TDES.
| virtual bool ts::BlockCipher::decrypt |
( |
const void * |
cipher, |
|
|
size_t |
cipher_length, |
|
|
void * |
plain, |
|
|
size_t |
plain_maxsize, |
|
|
size_t * |
plain_length = nullptr |
|
) |
| |
|
pure virtual |
Decrypt one block of data.
For pure block ciphers such as AES or DES, the plain text and cipher text must have the block size of the algorithm. For cipher chainings, the acceptable message sizes depend on the chaining mode.
- Parameters
-
| [in] | cipher | Address of cipher text. |
| [in] | cipher_length | Cipher text length in bytes. |
| [out] | plain | Address of buffer for plain text. |
| [in] | plain_maxsize | Size of plain buffer. |
| [out] | plain_length | Returned actual size of plain text. Ignored if zero. |
- Returns
- True on success, false on error.
Implemented in ts::DVBCSA2, ts::DVS042< CIPHER >, ts::DVS042< AES >, ts::DVS042< DES >, ts::CBC< CIPHER >, ts::CBC< AES >, ts::CTS1< CIPHER >, ts::CTS3< CIPHER >, ts::CTS2< CIPHER >, ts::CTS4< CIPHER >, ts::AES, ts::ECB< CIPHER >, ts::DES, and ts::TDES.
| virtual bool ts::BlockCipher::encryptInPlace |
( |
void * |
data, |
|
|
size_t |
data_length, |
|
|
size_t * |
max_actual_length = nullptr |
|
) |
| |
|
virtual |
Encrypt one block of data in place.
The default implementation is to call encrypt() and copy the data. A subclass may provide a more efficient implementation.
For pure block ciphers such as AES or DES, the plain text and cipher text must have the block size of the algorithm. For cipher chainings, the acceptable message sizes depend on the chaining mode.
- Parameters
-
| [in,out] | data | Address of data buffer to encrypt. |
| [in] | data_length | Input plain text length in bytes. |
| [in,out] | max_actual_length | Optional, ignored if zero. On input, contain the maximum size of the data buffer, which can be larger than data_length. On output, receive the actual size of the encrypted data. For pure block ciphers, this is the same as data_length. For cipher chainings with padding, this can be larger. |
- Returns
- True on success, false on error.
Reimplemented in ts::DVBCSA2.
| virtual bool ts::BlockCipher::decryptInPlace |
( |
void * |
data, |
|
|
size_t |
data_length, |
|
|
size_t * |
max_actual_length = nullptr |
|
) |
| |
|
virtual |
Decrypt one block of data in place.
The default implementation is to call decrypt() and copy the data. A subclass may provide a more efficient implementation.
For pure block ciphers such as AES or DES, the plain text and cipher text must have the block size of the algorithm. For cipher chainings, the acceptable message sizes depend on the chaining mode.
- Parameters
-
| [in,out] | data | Address of data buffer to decrypt. |
| [in] | data_length | Input cipher text length in bytes. |
| [in,out] | max_actual_length | Optional, ignored if zero. On input, contain the maximum size of the data buffer, which can be larger than data_length. On output, receive the actual size of the decrypted data. For pure block ciphers, this is the same as data_length. For cipher chainings with padding, this can be smaller. |
- Returns
- True on success, false on error.
Reimplemented in ts::DVBCSA2.
