Blame stdlib/random.c

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