package drbg

Import Path
	crypto/internal/fips140/drbg (on go.dev)

Dependency Relation
	imports 13 packages, and imported by 8 packages

Involved Source Files

	    cast.go
	    ctrdrbg.go
	    rand.go
Package-Level Type Names (total 2)

	/* sort by: alphabet | popularity */
	 type Counter (struct)
		Counter is an SP 800-90A Rev. 1 CTR_DRBG instantiated with AES-256.
		
		Per Table 3, it has a security strength of 256 bits, a seed size of 384 bits,
		a counter length of 128 bits, a reseed interval of 2^48 requests, and a
		maximum request size of 2^19 bits (2^16 bytes, 64 KiB).
		
		We support a narrow range of parameters that fit the needs of our RNG:
		AES-256, no derivation function, no personalization string, no prediction
		resistance, and 384-bit additional input.

		Methods (total 2)
			(*Counter) Generate(out []byte, additionalInput *[48]byte) (reseedRequired bool)
				Generate produces at most maxRequestSize bytes of random data in out.

			(*Counter) Reseed(entropy, additionalInput *[48]byte)
		As Outputs Of (at least one exported)
			func NewCounter(entropy *[48]byte) *Counter

	 type DefaultReader (interface)
		DefaultReader is a sentinel type, embedded in the default
		[crypto/rand.Reader], used to recognize it when passed to
		APIs that accept a rand io.Reader.


Package-Level Functions (total 4)

	 func NewCounter(entropy *[48]byte) *Counter
	 func Read(b []byte)
		Read fills b with cryptographically secure random bytes. In FIPS mode, it
		uses an SP 800-90A Rev. 1 Deterministic Random Bit Generator (DRBG).
		Otherwise, it uses the operating system's random number generator.

	 func ReadWithReader(r io.Reader, b []byte) error
		ReadWithReader uses Reader to fill b with cryptographically secure random
		bytes. It is intended for use in APIs that expose a rand io.Reader.
		
		If Reader is not the default Reader from crypto/rand,
		[randutil.MaybeReadByte] and [fips140.RecordNonApproved] are called.

	 func ReadWithReaderDeterministic(r io.Reader, b []byte) error
		ReadWithReaderDeterministic is like ReadWithReader, but it doesn't call
		[randutil.MaybeReadByte] on non-default Readers.


Package-Level Constants (only one)

	const SeedSize = 48

The pages are generated with Golds v0.7.3-preview. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @zigo_101 (reachable from the left QR code) to get the latest news of Golds.