/* $NetBSD: rnd.h,v 1.8 1997/10/20 15:06:04 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 . 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 #endif /* !_KERNEL */ #include #ifdef _KERNEL #include #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) /* * 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 tyfl; /* type and flags */ } 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)); void rnd_add_data __P((rndsource_element_t *, void *, u_int32_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)); 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 RNDSETENTCNT _IOW('R', 102, u_int32_t) /* set the entropy count */ #define RNDGETPOOL _IOR('R', 103, u_char *) /* get whole pool */ #define RNDADDTOENTCNT _IOW('R', 104, u_int32_t) /* add to entropy count */ #define RNDGETSRCNUM _IOWR('R', 105, rndstat_t) /* get rnd source info */ #define RNDGETSRCNAME _IOWR('R', 106, rndstat_name_t) /* get src by name */ #define RNDCTL _IOW('R', 107, rndctl_t) /* set/clear source flags */ #define RNDADDDATA _IOW('R', 108, rnddata_t) /* add data to the pool */ #endif /* !_SYS_RND_H_ */