freenet.crypt

Class RandomSource

java.lang.Object

java.util.Random

freenet.crypt.RandomSource

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

DummyRandomSource, Yarrow

public abstract class RandomSource
extends java.util.Random

Interface for any random-number source in Freenet

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
RandomSource()

Method Summary

Modifier and Type	Method and Description
abstract int	acceptEntropy(EntropySource source, long data, int entropyGuess) Accepts entropy data from a source
abstract int	acceptEntropyBytes(EntropySource myPacketDataSource, byte[] buf, int offset, int length, double bias) Accepts larger amounts of entropy data from a source, with a bias
abstract int	acceptTimerEntropy(EntropySource timer) Accepts entropy in the form of timing data from a source
abstract int	acceptTimerEntropy(EntropySource fnpTimingSource, double bias) Accept entropy from a source with a bias
abstract void	close() If the RandomSource has any resources it wants to close, it can do so when this method is called
protected int	next(int bits)
double	nextFullDouble() Returns a 64 bit random double.
float	nextFullFloat() Returns a 32 bit random floating point number.
void	waitForEntropy(int bits) If entropy estimation is supported, this method will block until the specified number of bits of entropy are available.

Methods inherited from class java.util.Random

doubles, doubles, doubles, doubles, ints, ints, ints, ints, longs, longs, longs, longs, nextBoolean, nextBytes, nextDouble, nextFloat, nextGaussian, nextInt, nextInt, nextLong, setSeed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RandomSource

public RandomSource()

Method Detail

nextFullFloat

public float nextFullFloat()

Returns a 32 bit random floating point number. With this method, all possible float values are approximately as likely to occur. This method may return NaN, +Inf, -Inf or other weird stuff. If you don't know what they are, this method is not for you.

See Also:

Random.nextFloat()

nextFullDouble

public double nextFullDouble()

Returns a 64 bit random double. With this method, all possible double values are approximately as likely to occur. This method may return NaN, +Inf, -Inf or other weird stuff. If you don't know what they are, this method is not for you.

See Also:

Random.nextDouble()

acceptEntropy

public abstract int acceptEntropy(EntropySource source,
                                  long data,
                                  int entropyGuess)

Accepts entropy data from a source

acceptTimerEntropy

public abstract int acceptTimerEntropy(EntropySource timer)

Accepts entropy in the form of timing data from a source

acceptTimerEntropy

public abstract int acceptTimerEntropy(EntropySource fnpTimingSource,
                                       double bias)

Accept entropy from a source with a bias

Parameters:

bias - Value by which we multiply the entropy before counting it. Must be <= 1.0.

acceptEntropyBytes

public abstract int acceptEntropyBytes(EntropySource myPacketDataSource,
                                       byte[] buf,
                                       int offset,
                                       int length,
                                       double bias)

Accepts larger amounts of entropy data from a source, with a bias

Parameters:

myPacketDataSource - The source from which the data has come.

buf - The buffer to read bytes from.

offset - The offset to start reading from.

length - The number of bytes to read.

bias - The bias. Value by which we multiply the entropy before counting it. Must be <= 1.0.

waitForEntropy

public void waitForEntropy(int bits)

If entropy estimation is supported, this method will block until the specified number of bits of entropy are available. If estimation isn't supported, this method will return immediately.

close

public abstract void close()

If the RandomSource has any resources it wants to close, it can do so when this method is called

next

protected int next(int bits)

Overrides:

next in class java.util.Random