xref: /freebsd/lib/libc/stdlib/random.h (revision 0b37c1590418417c894529d371800dfac71ef887)
1 /*-
2  * Copyright 2020 Conrad Meyer <cem@FreeBSD.org>.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23  * SUCH DAMAGE.
24  *
25  * $FreeBSD$
26  */
27 
28 #pragma once
29 
30 /* A full instance of the random(3) generator. */
31 struct __random_state {
32 	uint32_t	*rst_fptr;
33 	uint32_t	*rst_rptr;
34 	uint32_t	*rst_state;
35 	int		rst_type;
36 	int		rst_deg;
37 	int		rst_sep;
38 	uint32_t	*rst_end_ptr;
39 	/* Flexible array member must be last. */
40 	uint32_t	rst_randtbl[];
41 };
42 
43 int initstate_r(struct __random_state *, unsigned, uint32_t *, size_t);
44 long random_r(struct __random_state *);
45 void srandom_r(struct __random_state *, unsigned);
46 void srandomdev_r(struct __random_state *);
47