package rand

import "crypto/internal/rand"

Index ¶

• Variables
• func CustomReader(r io.Reader) io.Reader
• func IsDefaultReader(r io.Reader) bool
• func SetTestingReader(r io.Reader)

Variables ¶

var Reader io.Reader = reader{}

Reader is an io.Reader that calls drbg.Read.

It should be used internally instead of crypto/rand.Reader, because the latter can be set by applications outside of tests. These applications then risk breaking between Go releases, if the way the Reader is used changes.

Functions ¶

func CustomReader ¶

func CustomReader(r io.Reader) io.Reader

CustomReader returns Reader or, only if the GODEBUG setting "cryptocustomrand=1" is set, the provided io.Reader.

If returning a non-default Reader, it calls randutil.MaybeReadByte on it.

func IsDefaultReader ¶

func IsDefaultReader(r io.Reader) bool

IsDefaultReader reports whether r is the default crypto/rand.Reader.

If true, the Read method of r can be assumed to call drbg.Read.

func SetTestingReader ¶

func SetTestingReader(r io.Reader)

SetTestingReader overrides all calls to drbg.Read. The Read method of r must never return an error or return short.

SetTestingReader panics when building against Go Cryptographic Module v1.0.0.

SetTestingReader is pulled by testing/cryptotest.setGlobalRandom via go:linkname.

Source Files ¶

rand.go rand_fipsv2.0.go