Blame stdlib/random.c

Packit 6c4009
/* Copyright (C) 1995-2018 Free Software Foundation, Inc.
Packit 6c4009
Packit 6c4009
   The GNU C Library is free software; you can redistribute it and/or
Packit 6c4009
   modify it under the terms of the GNU Lesser General Public
Packit 6c4009
   License as published by the Free Software Foundation; either
Packit 6c4009
   version 2.1 of the License, or (at your option) any later version.
Packit 6c4009
Packit 6c4009
   The GNU C Library is distributed in the hope that it will be useful,
Packit 6c4009
   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 6c4009
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit 6c4009
   Lesser General Public License for more details.
Packit 6c4009
Packit 6c4009
   You should have received a copy of the GNU Lesser General Public
Packit 6c4009
   License along with the GNU C Library; if not, see
Packit 6c4009
   <http://www.gnu.org/licenses/>.  */
Packit 6c4009
Packit 6c4009
/*
Packit 6c4009
 * This is derived from the Berkeley source:
Packit 6c4009
 *	@(#)random.c	5.5 (Berkeley) 7/6/88
Packit 6c4009
 * It was reworked for the GNU C Library by Roland McGrath.
Packit 6c4009
 * Rewritten to use reentrant functions by Ulrich Drepper, 1995.
Packit 6c4009
 */
Packit 6c4009
Packit 6c4009
/*
Packit 6c4009
   Copyright (C) 1983 Regents of the University of California.
Packit 6c4009
   All rights reserved.
Packit 6c4009
Packit 6c4009
   Redistribution and use in source and binary forms, with or without
Packit 6c4009
   modification, are permitted provided that the following conditions
Packit 6c4009
   are met:
Packit 6c4009
Packit 6c4009
   1. Redistributions of source code must retain the above copyright
Packit 6c4009
      notice, this list of conditions and the following disclaimer.
Packit 6c4009
   2. Redistributions in binary form must reproduce the above copyright
Packit 6c4009
      notice, this list of conditions and the following disclaimer in the
Packit 6c4009
      documentation and/or other materials provided with the distribution.
Packit 6c4009
   4. Neither the name of the University nor the names of its contributors
Packit 6c4009
      may be used to endorse or promote products derived from this software
Packit 6c4009
      without specific prior written permission.
Packit 6c4009
Packit 6c4009
   THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
Packit 6c4009
   ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Packit 6c4009
   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Packit 6c4009
   ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
Packit 6c4009
   FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Packit 6c4009
   DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
Packit 6c4009
   OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
Packit 6c4009
   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
Packit 6c4009
   LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
Packit 6c4009
   OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
Packit 6c4009
   SUCH DAMAGE.*/
Packit 6c4009
Packit 6c4009
#include <libc-lock.h>
Packit 6c4009
#include <limits.h>
Packit 6c4009
#include <stddef.h>
Packit 6c4009
#include <stdlib.h>
Packit 6c4009
Packit 6c4009
Packit 6c4009
/* An improved random number generation package.  In addition to the standard
Packit 6c4009
   rand()/srand() like interface, this package also has a special state info
Packit 6c4009
   interface.  The initstate() routine is called with a seed, an array of
Packit 6c4009
   bytes, and a count of how many bytes are being passed in; this array is
Packit 6c4009
   then initialized to contain information for random number generation with
Packit 6c4009
   that much state information.  Good sizes for the amount of state
Packit 6c4009
   information are 32, 64, 128, and 256 bytes.  The state can be switched by
Packit 6c4009
   calling the setstate() function with the same array as was initialized
Packit 6c4009
   with initstate().  By default, the package runs with 128 bytes of state
Packit 6c4009
   information and generates far better random numbers than a linear
Packit 6c4009
   congruential generator.  If the amount of state information is less than
Packit 6c4009
   32 bytes, a simple linear congruential R.N.G. is used.  Internally, the
Packit 6c4009
   state information is treated as an array of longs; the zeroth element of
Packit 6c4009
   the array is the type of R.N.G. being used (small integer); the remainder
Packit 6c4009
   of the array is the state information for the R.N.G.  Thus, 32 bytes of
Packit 6c4009
   state information will give 7 longs worth of state information, which will
Packit 6c4009
   allow a degree seven polynomial.  (Note: The zeroth word of state
Packit 6c4009
   information also has some other information stored in it; see setstate
Packit 6c4009
   for details).  The random number generation technique is a linear feedback
Packit 6c4009
   shift register approach, employing trinomials (since there are fewer terms
Packit 6c4009
   to sum up that way).  In this approach, the least significant bit of all
Packit 6c4009
   the numbers in the state table will act as a linear feedback shift register,
Packit 6c4009
   and will have period 2^deg - 1 (where deg is the degree of the polynomial
Packit 6c4009
   being used, assuming that the polynomial is irreducible and primitive).
Packit 6c4009
   The higher order bits will have longer periods, since their values are
Packit 6c4009
   also influenced by pseudo-random carries out of the lower bits.  The
Packit 6c4009
   total period of the generator is approximately deg*(2**deg - 1); thus
Packit 6c4009
   doubling the amount of state information has a vast influence on the
Packit 6c4009
   period of the generator.  Note: The deg*(2**deg - 1) is an approximation
Packit 6c4009
   only good for large deg, when the period of the shift register is the
Packit 6c4009
   dominant factor.  With deg equal to seven, the period is actually much
Packit 6c4009
   longer than the 7*(2**7 - 1) predicted by this formula.  */
Packit 6c4009
Packit 6c4009
Packit 6c4009
Packit 6c4009
/* For each of the currently supported random number generators, we have a
Packit 6c4009
   break value on the amount of state information (you need at least this many
Packit 6c4009
   bytes of state info to support this random number generator), a degree for
Packit 6c4009
   the polynomial (actually a trinomial) that the R.N.G. is based on, and
Packit 6c4009
   separation between the two lower order coefficients of the trinomial.  */
Packit 6c4009
Packit 6c4009
/* Linear congruential.  */
Packit 6c4009
#define	TYPE_0		0
Packit 6c4009
#define	BREAK_0		8
Packit 6c4009
#define	DEG_0		0
Packit 6c4009
#define	SEP_0		0
Packit 6c4009
Packit 6c4009
/* x**7 + x**3 + 1.  */
Packit 6c4009
#define	TYPE_1		1
Packit 6c4009
#define	BREAK_1		32
Packit 6c4009
#define	DEG_1		7
Packit 6c4009
#define	SEP_1		3
Packit 6c4009
Packit 6c4009
/* x**15 + x + 1.  */
Packit 6c4009
#define	TYPE_2		2
Packit 6c4009
#define	BREAK_2		64
Packit 6c4009
#define	DEG_2		15
Packit 6c4009
#define	SEP_2		1
Packit 6c4009
Packit 6c4009
/* x**31 + x**3 + 1.  */
Packit 6c4009
#define	TYPE_3		3
Packit 6c4009
#define	BREAK_3		128
Packit 6c4009
#define	DEG_3		31
Packit 6c4009
#define	SEP_3		3
Packit 6c4009
Packit 6c4009
/* x**63 + x + 1.  */
Packit 6c4009
#define	TYPE_4		4
Packit 6c4009
#define	BREAK_4		256
Packit 6c4009
#define	DEG_4		63
Packit 6c4009
#define	SEP_4		1
Packit 6c4009
Packit 6c4009
Packit 6c4009
/* Array versions of the above information to make code run faster.
Packit 6c4009
   Relies on fact that TYPE_i == i.  */
Packit 6c4009
Packit 6c4009
#define	MAX_TYPES	5	/* Max number of types above.  */
Packit 6c4009
Packit 6c4009
Packit 6c4009
/* Initially, everything is set up as if from:
Packit 6c4009
	initstate(1, randtbl, 128);
Packit 6c4009
   Note that this initialization takes advantage of the fact that srandom
Packit 6c4009
   advances the front and rear pointers 10*rand_deg times, and hence the
Packit 6c4009
   rear pointer which starts at 0 will also end up at zero; thus the zeroth
Packit 6c4009
   element of the state information, which contains info about the current
Packit 6c4009
   position of the rear pointer is just
Packit 6c4009
	(MAX_TYPES * (rptr - state)) + TYPE_3 == TYPE_3.  */
Packit 6c4009
Packit 6c4009
static int32_t randtbl[DEG_3 + 1] =
Packit 6c4009
  {
Packit 6c4009
    TYPE_3,
Packit 6c4009
Packit 6c4009
    -1726662223, 379960547, 1735697613, 1040273694, 1313901226,
Packit 6c4009
    1627687941, -179304937, -2073333483, 1780058412, -1989503057,
Packit 6c4009
    -615974602, 344556628, 939512070, -1249116260, 1507946756,
Packit 6c4009
    -812545463, 154635395, 1388815473, -1926676823, 525320961,
Packit 6c4009
    -1009028674, 968117788, -123449607, 1284210865, 435012392,
Packit 6c4009
    -2017506339, -911064859, -370259173, 1132637927, 1398500161,
Packit 6c4009
    -205601318,
Packit 6c4009
  };
Packit 6c4009
Packit 6c4009
Packit 6c4009
static struct random_data unsafe_state =
Packit 6c4009
  {
Packit 6c4009
/* FPTR and RPTR are two pointers into the state info, a front and a rear
Packit 6c4009
   pointer.  These two pointers are always rand_sep places apart, as they
Packit 6c4009
   cycle through the state information.  (Yes, this does mean we could get
Packit 6c4009
   away with just one pointer, but the code for random is more efficient
Packit 6c4009
   this way).  The pointers are left positioned as they would be from the call:
Packit 6c4009
	initstate(1, randtbl, 128);
Packit 6c4009
   (The position of the rear pointer, rptr, is really 0 (as explained above
Packit 6c4009
   in the initialization of randtbl) because the state table pointer is set
Packit 6c4009
   to point to randtbl[1] (as explained below).)  */
Packit 6c4009
Packit 6c4009
    .fptr = &randtbl[SEP_3 + 1],
Packit 6c4009
    .rptr = &randtbl[1],
Packit 6c4009
Packit 6c4009
/* The following things are the pointer to the state information table,
Packit 6c4009
   the type of the current generator, the degree of the current polynomial
Packit 6c4009
   being used, and the separation between the two pointers.
Packit 6c4009
   Note that for efficiency of random, we remember the first location of
Packit 6c4009
   the state information, not the zeroth.  Hence it is valid to access
Packit 6c4009
   state[-1], which is used to store the type of the R.N.G.
Packit 6c4009
   Also, we remember the last location, since this is more efficient than
Packit 6c4009
   indexing every time to find the address of the last element to see if
Packit 6c4009
   the front and rear pointers have wrapped.  */
Packit 6c4009
Packit 6c4009
    .state = &randtbl[1],
Packit 6c4009
Packit 6c4009
    .rand_type = TYPE_3,
Packit 6c4009
    .rand_deg = DEG_3,
Packit 6c4009
    .rand_sep = SEP_3,
Packit 6c4009
Packit 6c4009
    .end_ptr = &randtbl[sizeof (randtbl) / sizeof (randtbl[0])]
Packit 6c4009
};
Packit 6c4009

Packit 6c4009
/* POSIX.1c requires that there is mutual exclusion for the `rand' and
Packit 6c4009
   `srand' functions to prevent concurrent calls from modifying common
Packit 6c4009
   data.  */
Packit 6c4009
__libc_lock_define_initialized (static, lock)
Packit 6c4009

Packit 6c4009
/* Initialize the random number generator based on the given seed.  If the
Packit 6c4009
   type is the trivial no-state-information type, just remember the seed.
Packit 6c4009
   Otherwise, initializes state[] based on the given "seed" via a linear
Packit 6c4009
   congruential generator.  Then, the pointers are set to known locations
Packit 6c4009
   that are exactly rand_sep places apart.  Lastly, it cycles the state
Packit 6c4009
   information a given number of times to get rid of any initial dependencies
Packit 6c4009
   introduced by the L.C.R.N.G.  Note that the initialization of randtbl[]
Packit 6c4009
   for default usage relies on values produced by this routine.  */
Packit 6c4009
void
Packit 6c4009
__srandom (unsigned int x)
Packit 6c4009
{
Packit 6c4009
  __libc_lock_lock (lock);
Packit 6c4009
  (void) __srandom_r (x, &unsafe_state);
Packit 6c4009
  __libc_lock_unlock (lock);
Packit 6c4009
}
Packit 6c4009
Packit 6c4009
weak_alias (__srandom, srandom)
Packit 6c4009
weak_alias (__srandom, srand)
Packit 6c4009

Packit 6c4009
/* Initialize the state information in the given array of N bytes for
Packit 6c4009
   future random number generation.  Based on the number of bytes we
Packit 6c4009
   are given, and the break values for the different R.N.G.'s, we choose
Packit 6c4009
   the best (largest) one we can and set things up for it.  srandom is
Packit 6c4009
   then called to initialize the state information.  Note that on return
Packit 6c4009
   from srandom, we set state[-1] to be the type multiplexed with the current
Packit 6c4009
   value of the rear pointer; this is so successive calls to initstate won't
Packit 6c4009
   lose this information and will be able to restart with setstate.
Packit 6c4009
   Note: The first thing we do is save the current state, if any, just like
Packit 6c4009
   setstate so that it doesn't matter when initstate is called.
Packit 6c4009
   Returns a pointer to the old state.  */
Packit 6c4009
char *
Packit 6c4009
__initstate (unsigned int seed, char *arg_state, size_t n)
Packit 6c4009
{
Packit 6c4009
  int32_t *ostate;
Packit 6c4009
  int ret;
Packit 6c4009
Packit 6c4009
  __libc_lock_lock (lock);
Packit 6c4009
Packit 6c4009
  ostate = &unsafe_state.state[-1];
Packit 6c4009
Packit 6c4009
  ret = __initstate_r (seed, arg_state, n, &unsafe_state);
Packit 6c4009
Packit 6c4009
  __libc_lock_unlock (lock);
Packit 6c4009
Packit 6c4009
  return ret == -1 ? NULL : (char *) ostate;
Packit 6c4009
}
Packit 6c4009
Packit 6c4009
weak_alias (__initstate, initstate)
Packit 6c4009

Packit 6c4009
/* Restore the state from the given state array.
Packit 6c4009
   Note: It is important that we also remember the locations of the pointers
Packit 6c4009
   in the current state information, and restore the locations of the pointers
Packit 6c4009
   from the old state information.  This is done by multiplexing the pointer
Packit 6c4009
   location into the zeroth word of the state information. Note that due
Packit 6c4009
   to the order in which things are done, it is OK to call setstate with the
Packit 6c4009
   same state as the current state
Packit 6c4009
   Returns a pointer to the old state information.  */
Packit 6c4009
char *
Packit 6c4009
__setstate (char *arg_state)
Packit 6c4009
{
Packit 6c4009
  int32_t *ostate;
Packit 6c4009
Packit 6c4009
  __libc_lock_lock (lock);
Packit 6c4009
Packit 6c4009
  ostate = &unsafe_state.state[-1];
Packit 6c4009
Packit 6c4009
  if (__setstate_r (arg_state, &unsafe_state) < 0)
Packit 6c4009
    ostate = NULL;
Packit 6c4009
Packit 6c4009
  __libc_lock_unlock (lock);
Packit 6c4009
Packit 6c4009
  return (char *) ostate;
Packit 6c4009
}
Packit 6c4009
Packit 6c4009
weak_alias (__setstate, setstate)
Packit 6c4009

Packit 6c4009
/* If we are using the trivial TYPE_0 R.N.G., just do the old linear
Packit 6c4009
   congruential bit.  Otherwise, we do our fancy trinomial stuff, which is the
Packit 6c4009
   same in all the other cases due to all the global variables that have been
Packit 6c4009
   set up.  The basic operation is to add the number at the rear pointer into
Packit 6c4009
   the one at the front pointer.  Then both pointers are advanced to the next
Packit 6c4009
   location cyclically in the table.  The value returned is the sum generated,
Packit 6c4009
   reduced to 31 bits by throwing away the "least random" low bit.
Packit 6c4009
   Note: The code takes advantage of the fact that both the front and
Packit 6c4009
   rear pointers can't wrap on the same call by not testing the rear
Packit 6c4009
   pointer if the front one has wrapped.  Returns a 31-bit random number.  */
Packit 6c4009
Packit 6c4009
long int
Packit 6c4009
__random (void)
Packit 6c4009
{
Packit 6c4009
  int32_t retval;
Packit 6c4009
Packit 6c4009
  __libc_lock_lock (lock);
Packit 6c4009
Packit 6c4009
  (void) __random_r (&unsafe_state, &retval);
Packit 6c4009
Packit 6c4009
  __libc_lock_unlock (lock);
Packit 6c4009
Packit 6c4009
  return retval;
Packit 6c4009
}
Packit 6c4009
Packit 6c4009
weak_alias (__random, random)