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.

COLOPHON

       This    page    is    part    of    MongoDB    C    Driver.     Please     report     any     bugs     at
       https://jira.mongodb.org/browse/CDRIVER.

MongoDB C Driver                                   2016‐01‐18                                     MONGOC_RAND(3)