doc/crypto/RAND_egd.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 RAND_egd - query entropy gathering daemon
   6
   7 =head1 SYNOPSIS
   8
   9  #include <openssl/rand.h>
  10
  11  int RAND_egd(const char *path);
  12
  13 =head1 DESCRIPTION
  14
  15 RAND_egd() queries the entropy gathering daemon EGD on socket B<path>.
  16
  17 EGD is available from http://www.lothar.com/tech/crypto/ (C<perl
  18 Makefile.PL; make; make install> to install). It is run as B<egd>
  19 I<path>, where I<path> is an absolute path designating a socket. When
  20 RAND_egd() is called with that path as an argument, it tries to read
  21 random bytes that EGD has collected. The read is performed in
  22 non-blocking mode.
  23
  24 =head1 RETURN VALUE
  25
  26 RAND_egd() returns the number of bytes read from the daemon on
  27 success, and -1 if the connection failed or the daemon did not return
  28 enough data to fully seed the PRNG.
  29
  30 =head1 SEE ALSO
  31
  32 L<rand(3)|rand(3)>, L<RAND_add(3)|RAND_add(3)>, L<RAND_cleanup(3)|RAND_cleanup(3)>
  33
  34 =head1 HISTORY
  35
  36 RAND_egd() is available since OpenSSL 0.9.5.
  37
  38 =cut