A C D E F G I M N O P R S T U V W

A

addEntropy(byte[], int) - Method in class org.hd.d.efs.EntropyPool

Add entropy-bearing bits with an estimated total entropy in bits.

C

checkGeneratedBits(byte[], boolean) - Static method in class org.hd.d.efs.EntropyPool

Simple and fast check on generated bits; throws an Error if the generator may be broken.

cleanArray(byte[]) - Static method in class org.hd.d.efs.EntropyPool

Cleans a byte array by overwriting it; leaves it all zeros as if newly created.

clear() - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Clear the map and reset the hit/miss counters.

compact() - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Compact by discarding all LRU items above the minimum size, ignoring the miss-rate target.

create(float, int, int, float) - Static method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Create an instance with the given parameters.

D

DEFAULT_ENTROPYEST - Static variable in class org.hd.d.efs.SrcParams

Default value of fetchTimeEntropyBits; assume a modest 1 bit from the whole input.

DEFAULT_INSECURE_ENTROPY_MULTIPLIER - Static variable in class org.hd.d.efs.GenParams

Weighting (multiplier) to apply to estimated entropy from non-secure source.

DEFAULT_ISEXPENSIVE - Static variable in class org.hd.d.efs.SrcParams

Default value of `isExpensive' attribute.

DEFAULT_ISSECURE - Static variable in class org.hd.d.efs.SrcParams

Default value of `isSecure' attribute.

DEFAULT_LOAD_FACTOR - Static variable in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Default load factor.

DEFAULT_MAX_BYTES_FROM_ENTROPY_SOURCE - Static variable in class org.hd.d.efs.GenParams

Default maximum input to be read from any entropy source (bytes).

DEFAULT_MAX_CONCURRENT - Static variable in class org.hd.d.efs.GenParams

Default maximum concurrency in fetching from entropy sources; strictly positive.

DEFAULT_MAX_DATA_FETCH_TIME_MS - Static variable in class org.hd.d.efs.GenParams

Default maximum time to wait for data from an entropy source (ms).

DEFAULT_MAX_MISS_RATE - Static variable in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Default maximum miss rate ]0.0,1.0[.

DEFAULT_MAX_REFETCH_INTERVAL_MS - Static variable in class org.hd.d.efs.GenParams

Default maximum time between successive fetches of data from one source (ms), even after errors.

DEFAULT_MIN_EXPENSIVE_REFETCH_INTERVAL_MS - Static variable in class org.hd.d.efs.GenParams

Default minimum time between successive fetches of data from one expensive source (ms).

DEFAULT_MIN_INITIAL_ENTROPY_BITS_BASE - Static variable in class org.hd.d.efs.EntropyPool

Minimum (default) initial base starting bits of entropy in the pool; strictly positive.

DEFAULT_MIN_REFETCH_INTERVAL_MS - Static variable in class org.hd.d.efs.GenParams

Default minimum time between successive fetches of data from one inexpensive source (ms).

DEFAULT_MIN_SEED_DUMP_MS - Static variable in class org.hd.d.efs.GenParams

Default minimum interval (ms) between automatic seed dumps; strictly positive.

DEFAULT_MIN_SEED_DUMP_TEST_MS - Static variable in class org.hd.d.efs.GenParams

Default minimum interval (ms) between automatic seed dumps attempts; strictly positive.

DEFAULT_MIN_SIZE - Static variable in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Default minimum size/capacity, also initial capacity; strictly positive.

DEFAULT_POOL_CAPACITY_BASE - Static variable in class org.hd.d.efs.EntropyPool

Default (maximum) entropy pool base size in bits; strictly positive.

DEFAULT_POOL_NAME - Static variable in class org.hd.d.efs.servlet.GathererServlet

By default this pool exists.

DEFAULT_SEEKFROMEND - Static variable in class org.hd.d.efs.SrcParams

Default value of `seek-from-end' attribute.

DEFAULT_STIR_INTERVAL_MS - Static variable in class org.hd.d.efs.GenParams

Default pool-stirrer interval (ms); prime and strictly positive.

DEFAULT_USESEEDFILE - Static variable in class org.hd.d.efs.Gatherer

Default value of useSeedFile.

DEFAULT_VERBOSITY - Static variable in class org.hd.d.efs.GenParams

Default verbosity level.

definition - Variable in class org.hd.d.efs.SrcParams

Source description/definition string; never null nor zero-length.

definition_pName - Static variable in class org.hd.d.efs.SrcParams

Property name /attribute for source definition string.

destroy() - Method in class org.hd.d.efs.EntropyPool

Destroy the pool contents.

destroy() - Method in class org.hd.d.efs.servlet.GathererServlet

Shut down, saving a seed file from each pool if possible.

destroy() - Method in class org.hd.d.efs.servlet.GathererServletFilter

Take this filter out of service.

doFilter(ServletRequest, ServletResponse, FilterChain) - Method in class org.hd.d.efs.servlet.GathererServletFilter

Intercepts an incoming HTTP request.

E

entropyBits - Variable in class org.hd.d.efs.SrcParams

If less than 1.0 the number of entropy bits per input bit, else total entropy bits per fetch; non-null, non-negative.

EntropyPool - Class in org.hd.d.efs

Manages a pool of truly random bits, hopefully cryptographically secure.

EntropyPool(URL) - Constructor for class org.hd.d.efs.EntropyPool

Make default-size pool with external entropy source and SecureRandom guarantor.

EntropyPool() - Constructor for class org.hd.d.efs.EntropyPool

Make default-size pool with some real entropy added c/o SecureRandom.

EntropyPool(SecureRandom, int, int, boolean) - Constructor for class org.hd.d.efs.EntropyPool

Initialise the pool with some bits and a minimum amount of entropy.

EntropyPool(SecureRandom, int, int, boolean, URL) - Constructor for class org.hd.d.efs.EntropyPool

Initialise the pool with some bits and a minimum amount of entropy.

ES_FILE - Static variable in class org.hd.d.efs.SrcParams

Indicates a file-based entropy source.

ES_INT - Static variable in class org.hd.d.efs.SrcParams

Indicates internal seed-bit-generator entropy source.

ES_PROC - Static variable in class org.hd.d.efs.SrcParams

Indicates a process-based entropy source.

ES_SR - Static variable in class org.hd.d.efs.SrcParams

Indicates a SecureRandom seed-bit-generator entropy source.

ES_URL - Static variable in class org.hd.d.efs.SrcParams

Indicates an URL-based entropy source.

EXTERNAL_ENTROPY_SOURCE_COMMON_URL - Static variable in class org.hd.d.efs.EntropyPool

Suggested URL for emergency entropy source as String.

EXTERNAL_ENTROPY_SOURCE_READ_SIZE - Static variable in class org.hd.d.efs.EntropyPool

Size of chunk that we expect to read from the externalEntropySource; strictly positive.

F

fetchTimeEntropyBits - Variable in class org.hd.d.efs.SrcParams

Number of estimated entropy bits in fetch time itself; non-negative.

FILE_DESC_SPECIAL - Static variable in class org.hd.d.efs.SrcParams

Special file source definition value that invites poking around in filesystem...

finalize() - Method in class org.hd.d.efs.EntropyPool

Help discard sensitive information when we are GCed.

finalize() - Method in class org.hd.d.efs.Gatherer

Make sure gathering has been stopped by GC of this Gatherer object.

G

Gatherer - Class in org.hd.d.efs

General gatherer of entropy from sources other than serlvet page hits.

Gatherer(EntropyPool, GenParams, SrcParams[], File) - Constructor for class org.hd.d.efs.Gatherer

Make new gatherer.

GathererServlet - Class in org.hd.d.efs.servlet

Basic servlet to hold and gather noise for entropy pool(s).

GathererServlet() - Constructor for class org.hd.d.efs.servlet.GathererServlet

GathererServletFilter - Class in org.hd.d.efs.servlet

This servlet filter gathers clickstream entropy for the EntropyPool.

GathererServletFilter() - Constructor for class org.hd.d.efs.servlet.GathererServletFilter

generateSeed(int) - Method in class org.hd.d.efs.EntropyPool

Returns seed bytes which should be entropy-laden.

generateSeed() - Method in class org.hd.d.efs.EntropyPool

Extract a seed value to save for a restart later.

generateSeed(int) - Static method in class org.hd.d.efs.InternalEntropySource

Generates seed bits for the internal generator.

generateSeed(int) - Method in class org.hd.d.efs.Whitener

Returns seed bytes from both generators XORed together.

GenParams - Class in org.hd.d.efs

General parameters for gatherer mechanism.

GenParams() - Constructor for class org.hd.d.efs.GenParams

Creates default set of general parameters.

GenParams(int, int, int, int, float, int, boolean) - Constructor for class org.hd.d.efs.GenParams

Create custom set of general parameters.

get(K) - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Get an entry from the map, making it the Most Recently Used; null if no such element.

getCopy() - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Take a copy of the map contents, which does not alter LRU; never null.

getCurrentPoolLevelBits() - Method in class org.hd.d.efs.EntropyPool

Get current pool size in bits; non-negative and no more than the maximum size specified.

getInjectEmergencyBitsIfPoolEmpty() - Method in class org.hd.d.efs.EntropyPool

If true, emergency entropy is injected when bits are extracted from an empty pool.

getMaxPoolSizeBits() - Method in class org.hd.d.efs.EntropyPool

Returns (maximum) size of entropy pool (bits).

getNullDigestStream() - Static method in class org.hd.d.efs.Gatherer

Make a stream that computes a secure digest an throws away its content.

getPool() - Method in class org.hd.d.efs.Gatherer

Recover a reference to the underlying EntropyPool; never returns null.

getPool(String) - Static method in class org.hd.d.efs.servlet.GathererServlet

Get entropy pool by name.

gParams - Variable in class org.hd.d.efs.SrcParams

Generic parameters; never null.

I

init() - Method in class org.hd.d.efs.servlet.GathererServlet

Capture any config info and then create the selected entropy pools.

init(FilterConfig) - Method in class org.hd.d.efs.servlet.GathererServletFilter

Place this filter into service.

insecureEntropyMultiplier - Variable in class org.hd.d.efs.GenParams

Weighting (multiplier) to apply to estimated entropy from non-secure source; in range 0.0f to 1.0f inclusive.

InternalEntropySource - Class in org.hd.d.efs

Used by EntropyPool (and Gatherer) to generate entropy within the JVM.

InternalEntropySource() - Constructor for class org.hd.d.efs.InternalEntropySource

isExpensive - Variable in class org.hd.d.efs.SrcParams

If true, source is expensive and should not be used during bootup.

isMemoryStressed() - Static method in class org.hd.d.efs.Utils

Returns true if the memory system may be under stress, eg not enough free.

isSecure - Variable in class org.hd.d.efs.SrcParams

If true, source is secure and private from outside inspection.

M

makeSpecialFileSource(GenParams) - Static method in class org.hd.d.efs.SrcParams

Returns a ready-made source definition for the `special' file source.

MAX_COMPRESSIBILITY - Static variable in class org.hd.d.efs.EntropyPool

If a block of supposedly-random output can be compressed smaller than this, we have a problem.

maxBytesFromEntropySource - Variable in class org.hd.d.efs.GenParams

Maximum input to be read from any entropy source (bytes); strictly positive.

maxBytesFromEntropySource - Variable in class org.hd.d.efs.SrcParams

Maximum bytes to fetch each time from source; non-negative.

maxConcurrent - Variable in class org.hd.d.efs.GenParams

Maximum concurrency in fetching from entropy sources; strictly positive.

maxDataReadTimeMs - Variable in class org.hd.d.efs.GenParams

Maximum time to wait for data from an entropy source (ms); strictly positive.

maxDataReadTimeMs - Variable in class org.hd.d.efs.SrcParams

Minimum time allowed to fetch data on each run; strictly positive.

maxRefetchIntervalMs - Variable in class org.hd.d.efs.GenParams

Minimum time between successive fetches of data from one source (ms); non-negative, even after errors.

maxRefetchIntervalMs - Variable in class org.hd.d.efs.SrcParams

Maximum interval between fetches in milliseconds, even after errors; non-negative.

MIN_LENGTH_CHECKABLE - Static variable in class org.hd.d.efs.EntropyPool

Minimum length of data we can usefully check.

minBytesChange - Variable in class org.hd.d.efs.SrcParams

Minimum bytes that must change between runs to count entropy; non-negative.

minRefetchIntervalMs - Variable in class org.hd.d.efs.GenParams

Minimum time between successive fetches of data from one inexpensive source (ms); non-negative.

minRefetchIntervalMs - Variable in class org.hd.d.efs.SrcParams

Minimum interval between fetches in milliseconds; non-negative.

mustConservePower(GenParams) - Static method in class org.hd.d.efs.Gatherer

If true, the system should conserve power (eg CPU cycles).

N

needsMoreEntropy() - Method in class org.hd.d.efs.EntropyPool

Returns true if the pool is short of entropy and needs more added.

nextBytes(byte[]) - Method in class org.hd.d.efs.EntropyPool

Get unlimited random bytes (a la Linux's /dev/urandom).

nextBytes(byte[]) - Method in class org.hd.d.efs.Whitener

Generates a user-specified number of random bytes.

nextBytesLimited(int) - Method in class org.hd.d.efs.EntropyPool

Get random bytes limited by the amount of entropy in the system.

nextLong() - Method in class org.hd.d.efs.EntropyPool

Returns the next pseudo-random, uniformly distributed long value.

O

org.hd.d.efs - package org.hd.d.efs

Main EntropyPool classes.

org.hd.d.efs.servlet - package org.hd.d.efs.servlet

Web/WAR/servlet support.

P

parseGatherer(Properties, String, EntropyPool, File) - Static method in class org.hd.d.efs.Gatherer

Retrieve Gatherer from Properties.

parseGenParams(Properties, String) - Static method in class org.hd.d.efs.GenParams

Retrieve GenParams from Properties.

parseSrcParams(GenParams, Properties, String, String) - Static method in class org.hd.d.efs.SrcParams

Retrieve SrcParams from Properties.

PNAME__GENPARAMS - Static variable in class org.hd.d.efs.GenParams

Generic top-level property (attribute) name for GenParams.

PNAME__POOLBYTES - Static variable in class org.hd.d.efs.servlet.GathererServlet

Top-level property (attribute) name for (strictly positive) size of pool in bytes if present.

PNAME__SRCLIST - Static variable in class org.hd.d.efs.Gatherer

Top-level property (attribute) name for the list of sources.

PNAME__SRCPARAMS - Static variable in class org.hd.d.efs.SrcParams

Generic top-level property (attribute) name for SrcParams.

PNAME__USESEEDFILE - Static variable in class org.hd.d.efs.Gatherer

Top-level property (attribute) name for flag to use a seed file or not.

PNAME_ENTROPYEST - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for fetchTimeEntropyBits.

PNAME_FILE - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name of file-based entropy source.

PNAME_INSECURE_ENTROPY_MULTIPLIER - Static variable in class org.hd.d.efs.GenParams

Property (and printable) name for isSecure.

PNAME_INT - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name of internal seed-bit-generator entropy source.

PNAME_ISEXPENSIVE - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for isExpensive.

PNAME_ISSECURE - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for isSecure.

PNAME_MAX_CONCURRENT - Static variable in class org.hd.d.efs.GenParams

Property (and printable) name for maximum concurrency in fetching from entropy sources.

PNAME_MAXBYTES - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for maxBytesFromEntropySource.

PNAME_MAXREADTIME - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for maxDataReadTimeMs.

PNAME_MAXREFETCH - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for maxRefetchIntervalMs.

PNAME_MINBYTESCHANGE - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for minBytesChange.

PNAME_MINREFETCH - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for minRefetchIntervalMs.

PNAME_PROC - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name of process-based entropy source.

PNAME_SEEKFROMEND - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name for seek direction.

PNAME_SR - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name of SecureRandom seed-bit-generator entropy source.

PNAME_URL - Static variable in class org.hd.d.efs.SrcParams

Property (and printable) name of URL-based entropy source.

PNAME_VERBOSITY - Static variable in class org.hd.d.efs.GenParams

Property (attribute) name for verbosity.

put(K, V) - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Put an entry in the map, making it the Most Recently Used, returning the previous value if any.

R

remove(K) - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Remove an entry from the map and return the removed value, if any, else null.

S

saveSeed() - Method in class org.hd.d.efs.Gatherer

Attempt to save a seed file (if seedFile is set).

seekFromEnd - Variable in class org.hd.d.efs.SrcParams

If true and source is seekable, take bytes from end of source.

setSeed(byte[]) - Method in class org.hd.d.efs.EntropyPool

Add seed (after creating an instance).

setSeed(long) - Method in class org.hd.d.efs.EntropyPool

Set a seed in a manner compatible with java.util.Random.

setSeed(byte[]) - Method in class org.hd.d.efs.Whitener

Reseeds both underlying generators with this seed.

setSeed(long) - Method in class org.hd.d.efs.Whitener

Reseeds both underlying generators with this seed.

size() - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Return the number of entries in the map; non-negative.

sourceType - Variable in class org.hd.d.efs.SrcParams

Source type; EC_XXX value.

sourceType_pName - Static variable in class org.hd.d.efs.SrcParams

Property name/attribute for source type (as String).

SrcParams - Class in org.hd.d.efs

Per-source gatherer parameters.

SrcParams(GenParams, byte, String, boolean, boolean, Number, int, int, int, int, int, byte, int, boolean, int) - Constructor for class org.hd.d.efs.SrcParams

Make an entropy gatherer definition.

start() - Method in class org.hd.d.efs.Gatherer

Call once after construction to start gatherer activity.

stop() - Method in class org.hd.d.efs.Gatherer

Stops the entropy gathering.

T

toString() - Method in class org.hd.d.efs.EntropyPool

Return a simple description of the state of the pool.

toString() - Method in class org.hd.d.efs.SrcParams

Generate human-readable concise (single-line) form.

toString() - Method in class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Provide a human-readable summary of status.

U

usefulDays - Variable in class org.hd.d.efs.SrcParams

Bit pattern for days (GMT/UTC) that the source is useful; bit 0 is Sunday, bit 6 is Saturday.

usefulHours - Variable in class org.hd.d.efs.SrcParams

Bit pattern for hours (GMT/UTC) that the source is useful; bit 0 is 00XX, 1 is 01XX, etc.

Utils - Class in org.hd.d.efs

Utility routines, eg for memory and threading.

Utils.SimpleLRUMapAutoSizeForHitRate<K,V> - Class in org.hd.d.efs

Simplified map with fixed capacity that discards excess items in LRU (Least Recently Used) order to meet a hit/miss ratio goal.

Utils.SimpleLRUMapAutoSizeForHitRate() - Constructor for class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Create an instance with all defaults and therefore an effectively-unbounded upper capacity of Integer.MAX_VALUE.

Utils.SimpleLRUMapAutoSizeForHitRate(int, int) - Constructor for class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Create an instance with all defaults except for the specified minimum/maximum capacities.

Utils.SimpleLRUMapAutoSizeForHitRate(float, int) - Constructor for class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Create an instance with the given parameters.

Utils.SimpleLRUMapAutoSizeForHitRate(float, int, int, float) - Constructor for class org.hd.d.efs.Utils.SimpleLRUMapAutoSizeForHitRate

Create an instance with the given parameters.

V

verbose - Variable in class org.hd.d.efs.GenParams

If true, run verbose.

W

Whitener - Class in org.hd.d.efs

This class whitens one source of random numbers with another.

Whitener(SecureRandom, SecureRandom) - Constructor for class org.hd.d.efs.Whitener

Construct a combo generator with main and whitener sources.

Whitener(SecureRandom) - Constructor for class org.hd.d.efs.Whitener

Construct a combo generator with a main source and a private whitener.

A C D E F G I M N O P R S T U V W