SysSrandom()

Supply entropy to the kernel's pseudorandom number generator

Synopsis:

#include <sys/neutrino.h>

int SysSrandom( const uint64_t *seedp );

Arguments:

seedp: A pointer to a 64-bit seed.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The SysSrandom() kernel call sets one source of entropy that's used for the kernel's pseudorandom number generator (PRNG). The PRNG is used with address space layout randomization (ASLR). For more information about ASLR, refer to “Address space layout randomization (ASLR)” in the System Security Guide. This call makes it possible to use an external source, such as a random number generator implemented in hardware, to augment the other sources of entropy.

Note:

In order to use this call, your process must have the PROCMGR_AID_SRANDOM ability enabled. For more information, see procmgr_ability().
Trace event logs intentionally don't include the new value of the source of entropy, for security reasons.

Blocking states

This call doesn't block.

Returns:

EOK on success. If an error occurs, it returns -1 and sets errno.

Errors:

EFAULT: The destination buffer for gathering entropy is not valid.
EPERM: The calling process doesn't have the required permission; see procmgr_ability().

Classification:

QNX Neutrino

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes