BlumBlumShub without factorization of the modulus. More...

#include <blumshub.h>

Inheritance diagram for PublicBlumBlumShub:

Public Member Functions
	PublicBlumBlumShub (const Integer &n, const Integer &seed)
	Construct a PublicBlumBlumShub.

unsigned int	GenerateBit ()
	Generate new random bit and return it.

byte	GenerateByte ()
	Generate new random byte and return it.

void	GenerateBlock (byte *output, size_t size)
	Generate random array of bytes.

void	ProcessData (byte outString, const byte inString, size_t length)
	Encrypt or decrypt an array of bytes.

bool	IsSelfInverting () const
	Determines whether the cipher is self-inverting.

bool	IsForwardTransformation () const
	Determines if the cipher is being operated in its forward direction.

Public Member Functions inherited from RandomNumberGenerator
virtual void	IncorporateEntropy (const byte *input, size_t length)
	Update RNG state with additional unpredictable values.

virtual bool	CanIncorporateEntropy () const
	Determines if a generator can accept additional entropy.

virtual word32	GenerateWord32 (word32 min=0, word32 max=0xffffffffUL)
	Generate a random 32 bit word in the range min to max, inclusive.

virtual void	GenerateIntoBufferedTransformation (BufferedTransformation &target, const std::string &channel, lword length)
	Generate random bytes into a BufferedTransformation.

virtual void	DiscardBytes (size_t n)
	Generate and discard n bytes.

template<class IT >
void	Shuffle (IT begin, IT end)
	Randomly shuffle the specified array.

Public Member Functions inherited from Algorithm
	Algorithm (bool checkSelfTestStatus=true)
	Interface for all crypto algorithms.

virtual std::string	AlgorithmName () const
	Provides the name of this algorithm.

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

Public Member Functions inherited from Clonable
virtual Clonable *	Clone () const
	Copies this object.

Public Member Functions inherited from StreamTransformation
StreamTransformation &	Ref ()
	Provides a reference to this object.

virtual unsigned int	MandatoryBlockSize () const
	Provides the mandatory block size of the cipher.

virtual unsigned int	OptimalBlockSize () const
	Provides the input block size most efficient for this cipher.

virtual unsigned int	GetOptimalBlockSizeUsed () const
	Provides the number of bytes used in the current block when processing at optimal block size.

virtual unsigned int	OptimalDataAlignment () const
	Provides input and output data alignment for optimal performance.

virtual size_t	ProcessLastBlock (byte outString, size_t outLength, const byte inString, size_t inLength)
	Encrypt or decrypt the last block of data.

virtual unsigned int	MinLastBlockSize () const
	Provides the size of the last block.

virtual bool	IsLastBlockSpecial () const
	Determines if the last block receives special processing.

void	ProcessString (byte *inoutString, size_t length)
	Encrypt or decrypt a string of bytes.

void	ProcessString (byte outString, const byte inString, size_t length)
	Encrypt or decrypt a string of bytes.

byte	ProcessByte (byte input)
	Encrypt or decrypt a byte.

virtual bool	IsRandomAccess () const =0
	Determines whether the cipher supports random access.

virtual void	Seek (lword pos)
	Seek to an absolute position.

Detailed Description

BlumBlumShub without factorization of the modulus.

You should reseed the generator after a fork() to avoid multiple generators with the same internal state.

Definition at line 18 of file blumshub.h.

Constructor & Destructor Documentation

◆ ~PublicBlumBlumShub()

virtual PublicBlumBlumShub::~PublicBlumBlumShub ( )

inlinevirtual

Definition at line 22 of file blumshub.h.

◆ PublicBlumBlumShub()

PublicBlumBlumShub::PublicBlumBlumShub	(	const Integer &	n,
		const Integer &	seed )

Construct a PublicBlumBlumShub.

Parameters

n	the modulus
seed	the seed for the generator

seed is the secret key and should be about as large as n.

Definition at line 9 of file blumshub.cpp.

Member Function Documentation

◆ GenerateBit()

unsigned int PublicBlumBlumShub::GenerateBit ( )

virtual

Generate new random bit and return it.

Returns: a random bit

The default implementation calls GenerateByte() and return its lowest bit.

All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.

Reimplemented from RandomNumberGenerator.

Definition at line 17 of file blumshub.cpp.

◆ GenerateByte()

byte PublicBlumBlumShub::GenerateByte ( )

virtual

Generate new random byte and return it.

Returns: a random 8-bit byte

Default implementation calls GenerateBlock() with one byte.

All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.

Reimplemented from RandomNumberGenerator.

Definition at line 28 of file blumshub.cpp.

◆ GenerateBlock()

void PublicBlumBlumShub::GenerateBlock	(	byte *	output,
		size_t	size )

virtual

Generate random array of bytes.

Parameters

output	the byte buffer
size	the length of the buffer, in bytes

All generated values are uniformly distributed over the range specified within the the constraints of a particular generator.

Note: A derived generator must override either GenerateBlock() or GenerateIntoBufferedTransformation(). They can override both, or have one call the other.

Reimplemented from RandomNumberGenerator.

Definition at line 36 of file blumshub.cpp.

◆ ProcessData()

void PublicBlumBlumShub::ProcessData	(	byte *	outString,
		const byte *	inString,
		size_t	length )

virtual

Encrypt or decrypt an array of bytes.

Parameters

outString	the output byte buffer
inString	the input byte buffer
length	the size of the input and output byte buffers, in bytes

ProcessData is called with a string of bytes whose size depends on MandatoryBlockSize. Either inString == outString, or they must not overlap.

See also: ProcessData, ProcessLastBlock, MandatoryBlockSize, MinLastBlockSize, BlockPaddingSchemeDef, IsLastBlockSpecial

Implements StreamTransformation.

Definition at line 42 of file blumshub.cpp.

◆ IsSelfInverting()

bool PublicBlumBlumShub::IsSelfInverting ( ) const

inlinevirtual

Determines whether the cipher is self-inverting.

Returns: true if the cipher is self-inverting, false otherwise

IsSelfInverting determines whether this transformation is self-inverting (e.g. xor with a keystream).

Implements StreamTransformation.

Definition at line 35 of file blumshub.h.

◆ IsForwardTransformation()

bool PublicBlumBlumShub::IsForwardTransformation ( ) const

inlinevirtual

Determines if the cipher is being operated in its forward direction.

Returns: true if DIR is ENCRYPTION, false otherwise

See also: IsForwardTransformation(), IsPermutation(), GetCipherDirection()

Implements StreamTransformation.

Definition at line 36 of file blumshub.h.

The documentation for this class was generated from the following files:

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~PublicBlumBlumShub()

◆ PublicBlumBlumShub()

Member Function Documentation

◆ GenerateBit()

◆ GenerateByte()

◆ GenerateBlock()

◆ ProcessData()

◆ IsSelfInverting()

◆ IsForwardTransformation()