help/seed

   1 NAME
   2     seed - return a value that may be used to seed a pseudo-random generator
   3
   4 SYNOPSIS
   5     seed()
   6
   7 TYPES
   8     return      integer
   9
  10 DESCRIPTION
  11     Generate a pseudo-random seed based on a collection of system and process
  12     information.  The seed() builtin function returns a value:
  13
  14                 0 <= seed < 2^64
  15
  16     IMPORTANT WARNING:
  17
  18         It should be pointed out that the information collected by seed
  19         is almost certainly non-chaotic.  This function is likely not
  20         suitable for applications (such as cryptographic applications)
  21         where the unpredictability of seeds is critical.  For such critical
  22         applications, LavaRnd should be used.   See the URL:
  23
  24                 http://www.LavaRnd.org/
  25
  26         for information about seeding a pseudo-random number generator
  27         (such as rand() or random()) with the cryptographic hash of the
  28         digitization of chaotic system.
  29
  30     Given the above warning, this builtin function produces a seed that is
  31     suitable for most applications that desire a different pseudo-random
  32     sequence each time they are run.
  33
  34     The return value of this builtin function should NOT be considered
  35     a random or pseudo-random value.  The return value should be used
  36     as an argument to a seed function such as srand() or srandom().
  37
  38 EXAMPLE
  39     > print srand(seed())
  40     RAND state
  41
  42     > print srandom(seed())
  43     RAND state
  44
  45 LIMITS
  46     none
  47
  48 LINK LIBRARY
  49     NUMBER *pseudo_seed(void)
  50
  51 SEE ALSO
  52     seed, srand, randbit, isrand, rand, random, srandom, israndom
  53