Crypto++ 8.7
Free C++ class library of cryptographic schemes
Public Member Functions | List of all members
PublicBlumBlumShub Class Reference

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. More...
 
unsigned int GenerateBit ()
 Generate new random bit and return it. More...
 
byte GenerateByte ()
 Generate new random byte and return it. More...
 
void GenerateBlock (byte *output, size_t size)
 Generate random array of bytes. More...
 
void ProcessData (byte *outString, const byte *inString, size_t length)
 Encrypt or decrypt an array of bytes. More...
 
bool IsSelfInverting () const
 Determines whether the cipher is self-inverting. More...
 
bool IsForwardTransformation () const
 Determines if the cipher is being operated in its forward direction. More...
 
- Public Member Functions inherited from RandomNumberGenerator
virtual void IncorporateEntropy (const byte *input, size_t length)
 Update RNG state with additional unpredictable values. More...
 
virtual bool CanIncorporateEntropy () const
 Determines if a generator can accept additional entropy. More...
 
virtual byte GenerateByte ()
 Generate new random byte and return it. More...
 
virtual unsigned int GenerateBit ()
 Generate new random bit and return it. More...
 
virtual word32 GenerateWord32 (word32 min=0, word32 max=0xffffffffUL)
 Generate a random 32 bit word in the range min to max, inclusive. More...
 
virtual void GenerateBlock (byte *output, size_t size)
 Generate random array of bytes. More...
 
virtual void GenerateIntoBufferedTransformation (BufferedTransformation &target, const std::string &channel, lword length)
 Generate random bytes into a BufferedTransformation. More...
 
virtual void DiscardBytes (size_t n)
 Generate and discard n bytes. More...
 
template<class IT >
void Shuffle (IT begin, IT end)
 Randomly shuffle the specified array. More...
 
- Public Member Functions inherited from Algorithm
 Algorithm (bool checkSelfTestStatus=true)
 Interface for all crypto algorithms. More...
 
virtual std::string AlgorithmName () const
 Provides the name of this algorithm. More...
 
virtual std::string AlgorithmProvider () const
 Retrieve the provider of this algorithm. More...
 
- Public Member Functions inherited from Clonable
virtual ClonableClone () const
 Copies this object. More...
 
- Public Member Functions inherited from StreamTransformation
StreamTransformationRef ()
 Provides a reference to this object. More...
 
virtual unsigned int MandatoryBlockSize () const
 Provides the mandatory block size of the cipher. More...
 
virtual unsigned int OptimalBlockSize () const
 Provides the input block size most efficient for this cipher. More...
 
virtual unsigned int GetOptimalBlockSizeUsed () const
 Provides the number of bytes used in the current block when processing at optimal block size. More...
 
virtual unsigned int OptimalDataAlignment () const
 Provides input and output data alignment for optimal performance. More...
 
virtual void ProcessData (byte *outString, const byte *inString, size_t length)=0
 Encrypt or decrypt an array of bytes. More...
 
virtual size_t ProcessLastBlock (byte *outString, size_t outLength, const byte *inString, size_t inLength)
 Encrypt or decrypt the last block of data. More...
 
virtual unsigned int MinLastBlockSize () const
 Provides the size of the last block. More...
 
virtual bool IsLastBlockSpecial () const
 Determines if the last block receives special processing. More...
 
void ProcessString (byte *inoutString, size_t length)
 Encrypt or decrypt a string of bytes. More...
 
void ProcessString (byte *outString, const byte *inString, size_t length)
 Encrypt or decrypt a string of bytes. More...
 
byte ProcessByte (byte input)
 Encrypt or decrypt a byte. More...
 
virtual bool IsRandomAccess () const =0
 Determines whether the cipher supports random access. More...
 
virtual void Seek (lword pos)
 Seek to an absolute position. More...
 
virtual bool IsSelfInverting () const =0
 Determines whether the cipher is self-inverting. More...
 
virtual bool IsForwardTransformation () const =0
 Determines if the cipher is being operated in its forward direction. More...
 

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
nthe modulus
seedthe 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
outputthe byte buffer
sizethe 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
outStringthe output byte buffer
inStringthe input byte buffer
lengththe 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: