Crypto.Sodium.Init

Libsodium initialisation.

Documentation

sodiumInit :: IO ()

Initialise libsodium.

This is just sodium_init() from libsodium. Calling it before using any Sodium functions is optional, but strongly recommended.

This function does the following:

1. Open /dev/urandom (on Unix) to make it accessible even after chroot().
2. Make all libsodium functions thread-safe.
3. Benchmark different implementations of cryptographic primitives provided and choose the best ones.

This function itself is thread-safe (since libsodium-1.0.11).

data SodiumInitException

Exception thrown by sodiumInit.

Constructors

SodiumInitFailed

libsodium failed to initialise.

Instances

Show SodiumInitException

Defined in Crypto.Sodium.Init

Methods

showsPrec :: Int -> SodiumInitException -> ShowS

show :: SodiumInitException -> String

showList :: [SodiumInitException] -> ShowS

Exception SodiumInitException

Defined in Crypto.Sodium.Init

Methods

toException :: SodiumInitException -> SomeException

fromException :: SomeException -> Maybe SodiumInitException

displayException :: SodiumInitException -> String