1/* $NetBSD: rndpool.h,v 1.3 2015/04/14 13:14:20 riastradh Exp $ */
2
3/*-
4 * Copyright (c) 1997 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Michael Graff <explorer@flame.org>. This code uses ideas and
9 * algorithms from the Linux driver written by Ted Ts'o.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
31 */
32
33#ifndef _SYS_RNDPOOL_H
34#define _SYS_RNDPOOL_H
35
36#ifndef _KERNEL /* XXX */
37#error <sys/rndpool.h> is meant for kernel consumers only.
38#endif
39
40#include <sys/types.h>
41#include <sys/rndio.h> /* rndpoolstat_t */
42
43/*
44 * Size of entropy pool in 32-bit words. This _MUST_ be a power of 2. Don't
45 * change this unless you really know what you are doing...
46 */
47#ifndef RND_POOLWORDS
48#define RND_POOLWORDS 128
49#endif
50#define RND_POOLBITS (RND_POOLWORDS * 32)
51
52typedef struct {
53 uint32_t cursor; /* current add point in the pool */
54 uint32_t rotate; /* how many bits to rotate by */
55 rndpoolstat_t stats; /* current statistics */
56 uint32_t pool[RND_POOLWORDS]; /* random pool data */
57} rndpool_t;
58
59/* Mode for rnd_extract_data. */
60#define RND_EXTRACT_ANY 0 /* extract as many bits as requested */
61#define RND_EXTRACT_GOOD 1 /* extract as many bits as we have counted
62 * entropy */
63
64void rndpool_init(rndpool_t *);
65uint32_t rndpool_get_entropy_count(rndpool_t *);
66void rndpool_set_entropy_count(rndpool_t *, uint32_t);
67void rndpool_get_stats(rndpool_t *, void *, int);
68void rndpool_add_data(rndpool_t *,
69 const void *const , uint32_t, uint32_t);
70uint32_t rndpool_extract_data(rndpool_t *, void *, uint32_t, uint32_t);
71
72#endif /* _SYS_RNDPOOL_H */
73