Security Scol plugin
Public Member Functions | Protected Attributes | List of all members
BlumBlumShub Class Reference

BlumBlumShub with factorization of the modulus. More...

#include <blumshub.h>

Inheritance diagram for BlumBlumShub:
PublicBlumBlumShub RandomNumberGenerator StreamTransformation Algorithm Algorithm Clonable Clonable

Public Member Functions

 BlumBlumShub (const Integer &p, const Integer &q, const Integer &seed)
 Construct a BlumBlumShub.
 
bool IsRandomAccess () const
 Determines whether the cipher supports random access.
 
void Seek (lword index)
 Seek to an absolute position.
 
- Public Member Functions inherited from PublicBlumBlumShub
 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 ClonableClone () const
 Copies this object.
 
- Public Member Functions inherited from StreamTransformation
StreamTransformationRef ()
 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.
 

Protected Attributes

const Integer p
 
const Integer q
 
const Integer x0
 
- Protected Attributes inherited from PublicBlumBlumShub
ModularArithmetic modn
 
Integer current
 
word maxBits
 
word bitsLeft
 

Detailed Description

BlumBlumShub with factorization of the modulus.

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

Definition at line 47 of file blumshub.h.

Constructor & Destructor Documentation

◆ ~BlumBlumShub()

virtual BlumBlumShub::~BlumBlumShub ( )
inlinevirtual

Definition at line 50 of file blumshub.h.

◆ BlumBlumShub()

BlumBlumShub::BlumBlumShub ( const Integer p,
const Integer q,
const Integer seed 
)

Construct a BlumBlumShub.

Parameters
pthe first prime factor
qthe second prime factor
seedthe seed for the generator

Esure p and q are both primes congruent to 3 mod 4 and at least 512 bits long. seed is the secret key and should be about as large as p*q.

Definition at line 48 of file blumshub.cpp.

Member Function Documentation

◆ IsRandomAccess()

bool BlumBlumShub::IsRandomAccess ( ) const
inlinevirtual

Determines whether the cipher supports random access.

Returns
true if the cipher supports random access, false otherwise

Implements StreamTransformation.

Definition at line 60 of file blumshub.h.

◆ Seek()

void BlumBlumShub::Seek ( lword  pos)
virtual

Seek to an absolute position.

Parameters
posposition to seek
Exceptions
NotImplemented

The base class implementation throws NotImplemented. The function asserts IsRandomAccess() in debug builds.

Reimplemented from StreamTransformation.

Definition at line 55 of file blumshub.cpp.

Member Data Documentation

◆ p

const Integer BlumBlumShub::p
protected

Definition at line 64 of file blumshub.h.

◆ q

const Integer BlumBlumShub::q
protected

Definition at line 64 of file blumshub.h.

◆ x0

const Integer BlumBlumShub::x0
protected

Definition at line 65 of file blumshub.h.


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