sioutil

Documentation

Overview

Package sioutil implements some I/O utility functions.

Index

• func MustRandom(n int) []byte
• func NativeAES() bool
• func NopCloser(w io.Writer) io.WriteCloser
• func Random(n int) (b []byte, err error)

Functions

func MustRandom

func MustRandom(n int) []byte

MustRandom returns n randomly generated bytes. It panics if it fails to read n random bytes from its entropy source.

MustRandom uses crypto/rand.Reader as cryptographically secure random number generator (CSPRNG).

func NativeAES

func NativeAES() bool

NativeAES returns true when the executing CPU provides AES-GCM hardware instructions and an optimized assembler implementation is available.

It is strongly recommended to only use AES-GCM when NativeAES() returns true. Otherwise, the AES-GCM implementation may be vulnerable to timing attacks. See: https://golang.org/pkg/crypto/aes

func NopCloser

func NopCloser(w io.Writer) io.WriteCloser

NopCloser returns a WriteCloser that wraps w and implements Close as a no-op.

func Random

func Random(n int) (b []byte, err error)

Random returns n randomly generated bytes if and only if err == nil.

Random uses crypto/rand.Reader as cryptographically secure random number generator (CSPRNG).