NAME¶
mongoc_rand - MongoDB Random Number Generator
SYNOPSIS¶
void
mongoc_rand_add (const void *buf,
int num,
doubel entropy);
void
mongoc_rand_seed (const void *buf,
int num);
int
mongoc_rand_status (void);
DESCRIPTION¶
The mongoc_rand family of functions provide access to the low level
randomness primitives used by the MongoDB C Driver. In particular, they
control the creation of cryptographically strong pseudo‐random bytes
required by some security mechanisms.
While we can usually pull enough entropy from the environment, you
may be required to seed the PRNG manually depending on your OS, hardware and
other entropy consumers running on the same system.
ENTROPY¶
mongoc_rand_add and mongoc_rand_seed allow the user to directly
provide entropy. They differ insofar as mongoc_rand_seed requires that
each bit provided is fully random. mongoc_rand_add allows the user to
specify the degree of randomness in the provided bytes as well.
STATUS¶
The mongoc_rand_status function allows the user to check the status of
the mongoc PRNG. This can be used to guarantee sufficient entropy at program
startup, rather than waiting for runtime errors to occur.