191 lines
6.6 KiB
C
191 lines
6.6 KiB
C
/* $NetBSD: rnd.h,v 1.11 1999/02/28 17:18:42 explorer Exp $ */
|
|
|
|
/*-
|
|
* Copyright (c) 1997 The NetBSD Foundation, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
* by Michael Graff <explorer@flame.org>. This code uses ideas and
|
|
* algorithms from the Linux driver written by Ted Ts'o.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* This product includes software developed by the NetBSD
|
|
* Foundation, Inc. and its contributors.
|
|
* 4. Neither the name of The NetBSD Foundation nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _SYS_RND_H_
|
|
#define _SYS_RND_H_
|
|
|
|
#ifndef _KERNEL
|
|
#include <sys/cdefs.h>
|
|
#endif /* !_KERNEL */
|
|
|
|
#include <sys/types.h>
|
|
|
|
#ifdef _KERNEL
|
|
#include <sys/queue.h>
|
|
#endif
|
|
|
|
#define RND_DEV_RANDOM 0 /* minor devices for random and kinda random */
|
|
#define RND_DEV_URANDOM 1
|
|
|
|
/*
|
|
* size of entropy pool in 32-bit words. This _MUST_ be a power of 2. Don't
|
|
* change this unless you really know what you are doing...
|
|
*/
|
|
#ifndef RND_POOLWORDS
|
|
#define RND_POOLWORDS 128
|
|
#endif
|
|
#define RND_POOLBITS (RND_POOLWORDS * 32)
|
|
|
|
/*
|
|
* Number of bytes returned per hash. This value is used in both
|
|
* rnd.c and rndpool.c to decide when enough entropy exists to do a
|
|
* hash to extract it.
|
|
*/
|
|
#define RND_ENTROPY_THRESHOLD 12
|
|
|
|
/*
|
|
* size of the event queue. This _MUST_ be a power of 2.
|
|
*/
|
|
#ifndef RND_EVENTQSIZE
|
|
#define RND_EVENTQSIZE 128
|
|
#endif
|
|
|
|
typedef struct {
|
|
u_int32_t cursor; /* current add point in the pool */
|
|
u_int32_t entropy; /* current entropy estimate in bits */
|
|
u_int32_t rotate; /* how many bits to rotate by */
|
|
u_int32_t pool[RND_POOLWORDS]; /* random pool data */
|
|
} rndpool_t;
|
|
|
|
typedef struct {
|
|
char name[16]; /* device name */
|
|
u_int32_t last_time; /* last time recorded */
|
|
u_int32_t last_delta; /* last delta value */
|
|
u_int32_t last_delta2; /* last delta2 value */
|
|
u_int32_t total; /* entropy from this source */
|
|
u_int32_t type; /* type */
|
|
u_int32_t flags; /* flags */
|
|
void *state; /* state informaiton */
|
|
} rndsource_t;
|
|
|
|
/*
|
|
* Flags to control the source. Low byte is type, upper bits are flags.
|
|
*/
|
|
#define RND_FLAG_NO_ESTIMATE 0x00000100 /* don't estimate entropy */
|
|
#define RND_FLAG_NO_COLLECT 0x00000200 /* don't collect entropy */
|
|
|
|
#define RND_TYPE_UNKNOWN 0 /* unknown source */
|
|
#define RND_TYPE_DISK 1 /* source is physical disk */
|
|
#define RND_TYPE_NET 2 /* source is a network device */
|
|
#define RND_TYPE_TAPE 3 /* source is a tape drive */
|
|
#define RND_TYPE_TTY 4 /* source is a tty device */
|
|
#define RND_TYPE_MAX 4 /* last type id used */
|
|
|
|
#ifdef _KERNEL
|
|
typedef struct __rndsource_element rndsource_element_t;
|
|
|
|
struct __rndsource_element {
|
|
LIST_ENTRY(__rndsource_element) list; /* the linked list */
|
|
rndsource_t data; /* the actual data */
|
|
};
|
|
|
|
/*
|
|
* Used by rnd_extract_data() and rndpool_extract_data() to describe how
|
|
* "good" the data has to be.
|
|
*/
|
|
#define RND_EXTRACT_ANY 0 /* extract anything, even if no entropy */
|
|
#define RND_EXTRACT_GOOD 1 /* return as many good bytes (short read ok) */
|
|
|
|
void rndpool_init __P((rndpool_t *));
|
|
void rndpool_init_global __P((void));
|
|
u_int32_t rndpool_get_entropy_count __P((rndpool_t *));
|
|
void rndpool_set_entropy_count __P((rndpool_t *, u_int32_t));
|
|
void rndpool_increment_entropy_count __P((rndpool_t *, u_int32_t));
|
|
u_int32_t *rndpool_get_pool __P((rndpool_t *));
|
|
u_int32_t rndpool_get_poolsize __P((void));
|
|
void rndpool_add_uint32 __P((rndpool_t *, u_int32_t, u_int32_t));
|
|
void rndpool_add_data __P((rndpool_t *, void *, u_int32_t,
|
|
u_int32_t));
|
|
int rndpool_extract_data __P((rndpool_t *, void *, u_int32_t,
|
|
u_int32_t));
|
|
|
|
void rnd_init __P((void));
|
|
void rnd_add_uint32 __P((rndsource_element_t *, u_int32_t));
|
|
int rnd_extract_data __P((void *, u_int32_t, u_int32_t));
|
|
void rnd_attach_source __P((rndsource_element_t *, char *,
|
|
u_int32_t, u_int32_t));
|
|
void rnd_detach_source __P((rndsource_element_t *));
|
|
|
|
#endif /* _KERNEL */
|
|
|
|
#define RND_MAXSTATCOUNT 10 /* 10 sources at once max */
|
|
|
|
/*
|
|
* return "count" random entries, starting at "start"
|
|
*/
|
|
typedef struct {
|
|
u_int32_t start;
|
|
u_int32_t count;
|
|
rndsource_t source[RND_MAXSTATCOUNT];
|
|
} rndstat_t;
|
|
|
|
/*
|
|
* return information on a specific source by name
|
|
*/
|
|
typedef struct {
|
|
char name[16];
|
|
rndsource_t source;
|
|
} rndstat_name_t;
|
|
|
|
/*
|
|
* set/clear device flags. If type is set to 0xff, the name is used
|
|
* instead. Otherwise, the flags set/cleared apply to all devices of
|
|
* the specified type, and the name is ignored.
|
|
*/
|
|
typedef struct {
|
|
char name[16]; /* the name we are adjusting */
|
|
u_int32_t type; /* the type of device we want */
|
|
u_int32_t flags; /* flags to set or clear */
|
|
u_int32_t mask; /* mask for the flags we are setting */
|
|
} rndctl_t;
|
|
|
|
typedef struct {
|
|
u_int32_t len;
|
|
u_int32_t entropy;
|
|
u_char data[RND_POOLWORDS * 4];
|
|
} rnddata_t;
|
|
|
|
#define RNDGETENTCNT _IOR('R', 101, u_int32_t) /* get entropy count */
|
|
#define RNDGETSRCNUM _IOWR('R', 102, rndstat_t) /* get rnd source info */
|
|
#define RNDGETSRCNAME _IOWR('R', 103, rndstat_name_t) /* get src by name */
|
|
#define RNDCTL _IOW('R', 104, rndctl_t) /* set/clear source flags */
|
|
#define RNDADDDATA _IOW('R', 105, rnddata_t) /* add data to the pool */
|
|
|
|
#endif /* !_SYS_RND_H_ */
|