Policy object for additive stream ciphers. More...

#include <strciphr.h>

Inheritance diagram for AdditiveCipherAbstractPolicy:

Public Member Functions
virtual unsigned int	GetAlignment () const
	Provides data alignment requirements.

virtual unsigned int	GetBytesPerIteration () const =0
	Provides number of bytes operated upon during an iteration.

virtual unsigned int	GetOptimalBlockSize () const
	Provides number of ideal bytes to process.

virtual unsigned int	GetIterationsToBuffer () const =0
	Provides buffer size based on iterations.

virtual void	WriteKeystream (byte *keystream, size_t iterationCount)
	Generate the keystream.

virtual bool	CanOperateKeystream () const
	Flag indicating.

virtual void	OperateKeystream (KeystreamOperation operation, byte output, const byte input, size_t iterationCount)
	Operates the keystream.

virtual void	CipherSetKey (const NameValuePairs &params, const byte *key, size_t length)=0
	Key the cipher.

virtual void	CipherResynchronize (byte keystreamBuffer, const byte iv, size_t length)
	Resynchronize the cipher.

virtual bool	CipherIsRandomAccess () const =0
	Flag indicating random access.

virtual void	SeekToIteration (lword iterationCount)
	Seeks to a random position in the stream.

virtual std::string	AlgorithmProvider () const
	Retrieve the provider of this algorithm.

Detailed Description

Policy object for additive stream ciphers.

Definition at line 104 of file strciphr.h.

Constructor & Destructor Documentation

◆ ~AdditiveCipherAbstractPolicy()

virtual AdditiveCipherAbstractPolicy::~AdditiveCipherAbstractPolicy ( )

inlinevirtual

Definition at line 106 of file strciphr.h.

Member Function Documentation

◆ AlgorithmProvider()

virtual std::string AdditiveCipherAbstractPolicy::AlgorithmProvider ( ) const

inlinevirtual

Retrieve the provider of this algorithm.

Returns: the algorithm provider

The algorithm provider can be a name like "C++", "SSE", "NEON", "AESNI", "ARMv8" and "Power8". C++ is standard C++ code. Other labels, like SSE, usually indicate a specialized implementation using instructions from a higher instruction set architecture (ISA). Future labels may include external hardware like a hardware security module (HSM).

Generally speaking Wei Dai's original IA-32 ASM code falls under "SSE2". Labels like "SSSE3" and "SSE4.1" follow after Wei's code and use intrinsics instead of ASM.

Algorithms which combine different instructions or ISAs provide the dominant one. For example on x86 AES/GCM returns "AESNI" rather than "CLMUL" or "AES+SSE4.1" or "AES+CLMUL" or "AES+SSE4.1+CLMUL".

Note: Provider is not universally implemented yet.

Reimplemented in ChaCha_Policy, ChaChaTLS_Policy, XChaCha20_Policy, PanamaCipherPolicy, Salsa20_Policy, SosemanukPolicy, and AdditiveCipherTemplate< AbstractPolicyHolder< AdditiveCipherAbstractPolicy, CTR_ModePolicy > >.

Definition at line 192 of file strciphr.h.

◆ CanOperateKeystream()

virtual bool AdditiveCipherAbstractPolicy::CanOperateKeystream ( ) const

inlinevirtual

Flag indicating.

Returns: true if the stream can be generated independent of the transformation input, false otherwise

See also: CanOperateKeystream(), OperateKeystream(), WriteKeystream()

Reimplemented in HC128Policy, HC256Policy, CTR_ModePolicy, RabbitPolicy, RabbitWithIVPolicy, AdditiveCipherConcretePolicy< WT, W, X, BASE >, AdditiveCipherConcretePolicy< word32, 1, 64 >, AdditiveCipherConcretePolicy< word32, 16 >, AdditiveCipherConcretePolicy< word32, 20 >, AdditiveCipherConcretePolicy< word32, 256 >, AdditiveCipherConcretePolicy< word32, 4 >, and AdditiveCipherConcretePolicy< word32, 8 >.

Definition at line 139 of file strciphr.h.

◆ CipherIsRandomAccess()

virtual bool AdditiveCipherAbstractPolicy::CipherIsRandomAccess ( ) const

pure virtual

Flag indicating random access.

Returns: true if the cipher is seekable, false otherwise

See also: SeekToIteration()

Implemented in ChaCha_Policy, ChaChaTLS_Policy, XChaCha20_Policy, HC128Policy, HC256Policy, OFB_ModePolicy, CTR_ModePolicy, PanamaCipherPolicy, RabbitPolicy, RabbitWithIVPolicy, Salsa20_Policy, SEAL_Policy, SosemanukPolicy, and WAKE_Policy.

◆ CipherResynchronize()

virtual void AdditiveCipherAbstractPolicy::CipherResynchronize	(	byte *	keystreamBuffer,
		const byte *	iv,
		size_t	length
	)

inlinevirtual

Resynchronize the cipher.

Parameters

keystreamBuffer	the keystream buffer
iv	a byte array used to resynchronize the cipher
length	the size of the IV array

Reimplemented in ChaCha_Policy, ChaChaTLS_Policy, XChaCha20_Policy, HC128Policy, HC256Policy, OFB_ModePolicy, CTR_ModePolicy, PanamaCipherPolicy, RabbitWithIVPolicy, Salsa20_Policy, XSalsa20_Policy, SEAL_Policy, and SosemanukPolicy.

Definition at line 163 of file strciphr.h.

◆ CipherSetKey()

virtual void AdditiveCipherAbstractPolicy::CipherSetKey	(	const NameValuePairs &	params,
		const byte *	key,
		size_t	length
	)

pure virtual

Key the cipher.

Parameters

params	set of NameValuePairs use to initialize this object
key	a byte array used to key the cipher
length	the size of the key array

Implemented in ChaCha_Policy, ChaChaTLS_Policy, XChaCha20_Policy, HC128Policy, HC256Policy, PanamaCipherPolicy, RabbitPolicy, RabbitWithIVPolicy, Salsa20_Policy, XSalsa20_Policy, SEAL_Policy, SosemanukPolicy, and WAKE_Policy.

◆ GetAlignment()

virtual unsigned int AdditiveCipherAbstractPolicy::GetAlignment ( ) const

inlinevirtual

Provides data alignment requirements.

Returns: data alignment requirements, in bytes

Internally, the default implementation returns 1. If the stream cipher is implemented using an SSE2 ASM or intrinsics, then the value returned is usually 16.

Reimplemented in ChaCha_Policy, ChaChaTLS_Policy, XChaCha20_Policy, CTR_ModePolicy, PanamaCipherPolicy, AdditiveCipherConcretePolicy< WT, W, X, BASE >, AdditiveCipherConcretePolicy< word32, 1, 64 >, AdditiveCipherConcretePolicy< word32, 16 >, AdditiveCipherConcretePolicy< word32, 20 >, AdditiveCipherConcretePolicy< word32, 256 >, AdditiveCipherConcretePolicy< word32, 4 >, and AdditiveCipherConcretePolicy< word32, 8 >.

Definition at line 112 of file strciphr.h.

◆ GetBytesPerIteration()

virtual unsigned int AdditiveCipherAbstractPolicy::GetBytesPerIteration ( ) const

pure virtual

Provides number of bytes operated upon during an iteration.

Returns: bytes operated upon during an iteration, in bytes

See also: GetOptimalBlockSize()

Implemented in OFB_ModePolicy, CTR_ModePolicy, AdditiveCipherConcretePolicy< WT, W, X, BASE >, AdditiveCipherConcretePolicy< word32, 1, 64 >, AdditiveCipherConcretePolicy< word32, 16 >, AdditiveCipherConcretePolicy< word32, 20 >, AdditiveCipherConcretePolicy< word32, 256 >, AdditiveCipherConcretePolicy< word32, 4 >, and AdditiveCipherConcretePolicy< word32, 8 >.

◆ GetIterationsToBuffer()

virtual unsigned int AdditiveCipherAbstractPolicy::GetIterationsToBuffer ( ) const

pure virtual

Provides buffer size based on iterations.

Returns: the buffer size based on iterations, in bytes

Implemented in OFB_ModePolicy, CTR_ModePolicy, AdditiveCipherConcretePolicy< WT, W, X, BASE >, AdditiveCipherConcretePolicy< word32, 1, 64 >, AdditiveCipherConcretePolicy< word32, 16 >, AdditiveCipherConcretePolicy< word32, 20 >, AdditiveCipherConcretePolicy< word32, 256 >, AdditiveCipherConcretePolicy< word32, 4 >, and AdditiveCipherConcretePolicy< word32, 8 >.

◆ GetOptimalBlockSize()

virtual unsigned int AdditiveCipherAbstractPolicy::GetOptimalBlockSize ( ) const

inlinevirtual

Provides number of ideal bytes to process.

Returns: the ideal number of bytes to process

Internally, the default implementation returns GetBytesPerIteration()

See also: GetBytesPerIteration()

Reimplemented in ChaCha_Policy, ChaChaTLS_Policy, and XChaCha20_Policy.

Definition at line 123 of file strciphr.h.

◆ OperateKeystream()

virtual void AdditiveCipherAbstractPolicy::OperateKeystream	(	KeystreamOperation	operation,
		byte *	output,
		const byte *	input,
		size_t	iterationCount
	)

inlinevirtual

Operates the keystream.

Parameters

operation	the operation with additional flags
output	the output buffer
input	the input buffer
iterationCount	the number of iterations to perform on the input

OperateKeystream() will attempt to operate upon GetOptimalBlockSize() buffer, which will be derived from GetBytesPerIteration().