1 /* 2 * random.h -- A strong random number generator 3 * 4 * $FreeBSD: src/sys/sys/random.h,v 1.19.2.2 2002/09/17 17:11:54 sam Exp $ 5 * $DragonFly: src/sys/sys/random.h,v 1.10 2006/09/10 01:26:40 dillon Exp $ 6 * 7 * Version 0.95, last modified 18-Oct-95 8 * 9 * Copyright Theodore Ts'o, 1994, 1995. All rights reserved. 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, and the entire permission notice in its entirety, 16 * including the disclaimer of warranties. 17 * 2. Redistributions in binary form must reproduce the above copyright 18 * notice, this list of conditions and the following disclaimer in the 19 * documentation and/or other materials provided with the distribution. 20 * 3. The name of the author may not be used to endorse or promote 21 * products derived from this software without specific prior 22 * written permission. 23 * 24 * ALTERNATIVELY, this product may be distributed under the terms of 25 * the GNU Public License, in which case the provisions of the GPL are 26 * required INSTEAD OF the above restrictions. (This clause is 27 * necessary due to a potential bad interaction between the GPL and 28 * the restrictions contained in a BSD-style copyright.) 29 * 30 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED 31 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 32 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 33 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 34 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 35 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 36 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 37 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 38 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 39 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 40 * OF THE POSSIBILITY OF SUCH DAMAGE. 41 * 42 */ 43 44 /* 45 * Many kernel routines will have a use for good random numbers, 46 * for example, for truely random TCP sequence numbers, which prevent 47 * certain forms of TCP spoofing attacks. 48 * 49 */ 50 51 #ifndef _SYS_RANDOM_H_ 52 #define _SYS_RANDOM_H_ 53 54 #ifndef _SYS_TYPES_H_ 55 #include <sys/types.h> 56 #endif 57 #ifndef _SYS_INTERRUPT_H_ 58 #include <sys/interrupt.h> 59 #endif 60 #ifndef _SYS_IOCCOM_H_ 61 #include <sys/ioccom.h> 62 #endif 63 64 #define MEM_SETIRQ _IOW('r', 1, u_int16_t) /* set interrupt */ 65 #define MEM_CLEARIRQ _IOW('r', 2, u_int16_t) /* clear interrupt */ 66 #define MEM_RETURNIRQ _IOR('r', 3, u_int16_t) /* obsolete */ 67 #define MEM_FINDIRQ _IOWR('r', 4, u_int16_t) /* next interrupt */ 68 69 #ifdef _KERNEL 70 71 /* Type of the cookie passed to add_interrupt_randomness. */ 72 73 struct random_softc { 74 int sc_intr; 75 int sc_enabled; 76 }; 77 78 /* Exported functions */ 79 80 void rand_initialize(void); 81 void add_keyboard_randomness(u_char scancode); 82 void add_interrupt_randomness(int intr); 83 #ifdef notused 84 void add_blkdev_randomness(int major); 85 #endif 86 void add_true_randomness(int); 87 int add_buffer_randomness(const char *, int); 88 89 #ifdef notused 90 void get_random_bytes(void *buf, u_int nbytes); 91 #endif 92 u_int read_random(void *buf, u_int size); 93 u_int read_random_unlimited(void *buf, u_int size); 94 #ifdef notused 95 u_int write_random(const char *buf, u_int nbytes); 96 #endif 97 struct thread; 98 struct knote; 99 int random_poll(cdev_t dev, int events); 100 int random_filter_read(struct knote *kn, long hint); 101 102 #endif /* _KERNEL */ 103 104 #endif /* !_SYS_RANDOM_H_ */ 105