plucky (3) mongoc_rand.3.gz

SYNOPSIS

          void
          mongoc_rand_add (const void *buf, int num, double 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.

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2009-present, MongoDB, Inc.