Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MONGOC_RAND(3)			   libmongoc			MONGOC_RAND(3)

MongoDB	Random Number Generator

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 spec-
       ify 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.

1.30.2				 Apr 12, 2025			MONGOC_RAND(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mongoc_rand&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help