yarrow.h revision 65752
1/*- 2 * Copyright (c) 2000 Mark R V Murray 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer 10 * in this position and unchanged. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25 * 26 * $FreeBSD: head/sys/dev/random/yarrow.h 65752 2000-09-11 19:31:28Z jhb $ 27 */ 28 29/* #define ENTROPYSOURCE nn entropy sources (actually classes) 30 * The entropy classes will as follows: 31 * 0 - Direct write 32 * 1 - Keyboard 33 * 2 - Mouse 34 */ 35 36#define ENTROPYBIN 256 /* buckets to harvest entropy events */ 37#define TIMEBIN 16 /* max value for Pt/t */ 38 39#define FAST 0 40#define SLOW 1 41 42int random_init(void); 43void random_deinit(void); 44void random_init_harvester(void (*)(struct timespec *, void *, u_int, u_int, u_int, enum esource)); 45void random_deinit_harvester(void); 46void random_set_wakeup(int *, int); 47void random_set_wakeup_exit(int *, int, int); 48 49void write_random(void *, u_int); 50 51/* This is the beastie that needs protecting. It contains all of the 52 * state that we are excited about. 53 * This is a biiig structure. It may move over to a malloc(9)ed 54 * replacement. 55 */ 56struct random_state { 57 u_int64_t counter; /* C */ 58 struct yarrowkey key; /* K */ 59 int gengateinterval; /* Pg */ 60 int bins; /* Pt/t */ 61 int outputblocks; /* count output blocks for gates */ 62 u_int slowoverthresh; /* slow pool overthreshhold reseed count */ 63 struct pool { 64 struct source { 65 u_int bits; /* estimated bits of entropy */ 66 u_int frac; /* fractional bits of entropy 67 (given as 1024/n) */ 68 } source[ENTROPYSOURCE]; 69 u_int thresh; /* pool reseed threshhold */ 70 struct yarrowhash hash; /* accumulated entropy */ 71 } pool[2]; /* pool[0] is fast, pool[1] is slow */ 72 int which; /* toggle - shows the current insertion pool */ 73}; 74 75extern struct random_state random_state; 76