NAME    [Toc]    [Back]

       get_random_bytes  -  General: Returns the requested number
       of random bytes and stores them in a buffer.

SYNOPSIS    [Toc]    [Back]

       void get_random_bytes(
               void *buf,
               int nbytes );

ARGUMENTS    [Toc]    [Back]

       Specifies the address of the buffer in which the requested
       random  bytes  are stored.  Specifies the number of random
       bytes.

DESCRIPTION    [Toc]    [Back]

       The get_random_bytes() routine returns the requested  number
 of random bytes and stores them in a buffer. This routine
 is for kernel modules that cannot be in a wait state.

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion, get_random_bytes() returns a
       buffer filled with random bytes.

       ************Fran,  what  does  it  return  upon   failure,
       efault?

EXAMPLE    [Toc]    [Back]

       The  following  example  shows  how  to  use  the get_random_bytes()
 routine to generate a random DCE UUID:

       unsigned  char  uuid[16];  get_random_bytes(uuid,   sizeof
       (uuid));  uuid[6]  =  (uuid[6] & 0x0f) | 0x40;     /* UUID
       version 4 -- random genmeration */ uuid[8]  =  (uuid[8]  &
       0x3f) | 0x80;     /* UUID variant DCE */

       ************Fran, what does DCE UUID stand for?

SEE ALSO    [Toc]    [Back]

       Routines: get_random_bytes_wait(9r)

       Files: random(4) and urandom(4)



                                             get_random_bytes(9r)