Manual Pages for UNIX Operating System command usage for man BN_rand

OpenSSL                                         BN_rand(3openssl)



NNNNAAAAMMMMEEEE
     BN_rand, BN_pseudo_rand - generate pseudo-random number

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
      #include 

      int BN_rand(BIGNUM *rnd, int bits, int top, int bottom);

      int BN_pseudo_rand(BIGNUM *rnd, int bits, int top, int bottom);

      int BN_rand_range(BIGNUM *rnd, BIGNUM *range);

      int BN_pseudo_rand_range(BIGNUM *rnd, BIGNUM *range);


DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     BN_rand() generates a cryptographically strong pseudo-random
     number of bbbbiiiittttssss bits in length and stores it in rrrrnnnndddd. If ttttoooopppp
     is -1, the most significant bit of the random number can be
     zero. If ttttoooopppp is 0, it is set to 1, and if ttttoooopppp is 1, the two
     most significant bits of the number will be set to 1, so
     that the product of two such random numbers will always have
     2*bbbbiiiittttssss length.  If bbbboooottttttttoooommmm is true, the number will be odd.

     BN_pseudo_rand() does the same, but pseudo-random numbers
     generated by this function are not necessarily
     unpredictable. They can be used for non-cryptographic
     purposes and for certain purposes in cryptographic
     protocols, but usually not for key generation etc.

     BN_rand_range() generates a cryptographically strong
     pseudo-random number rrrrnnnndddd in the range 0 = rrrrnnnndddd < rrrraaaannnnggggeeee.
     BN_pseudo_rand_range() does the same, but is based on
     BN_pseudo_rand(), and hence numbers generated by it are not
     necessarily unpredictable.

     The PRNG must be seeded prior to calling BN_rand() or
     BN_rand_range().

RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
     The functions return 1 on success, 0 on error.  The error
     codes can be obtained by ERR_get_error(3).

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     bn(3), ERR_get_error(3), rand(3), RAND_add(3), RAND_bytes(3)

HHHHIIIISSSSTTTTOOOORRRRYYYY
     BN_rand() is available in all versions of SSLeay and
     OpenSSL.  BN_pseudo_rand() was added in OpenSSL 0.9.5. The
     ttttoooopppp == -1 case and the function BN_rand_range() were added
     in OpenSSL 0.9.6a.  BN_pseudo_rand_range() was added in
     OpenSSL 0.9.6c.



25/Sep/2002            Last change: 0.9.8o                      1






OpenSSL                                         BN_rand(3openssl)























































25/Sep/2002            Last change: 0.9.8o                      2