1 /* 2 * magic.h - PPP Magic Number definitions. 3 * 4 * Copyright (c) 1984-2000 Carnegie Mellon University. All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in 15 * the documentation and/or other materials provided with the 16 * distribution. 17 * 18 * 3. The name "Carnegie Mellon University" must not be used to 19 * endorse or promote products derived from this software without 20 * prior written permission. For permission or any legal 21 * details, please contact 22 * Office of Technology Transfer 23 * Carnegie Mellon University 24 * 5000 Forbes Avenue 25 * Pittsburgh, PA 15213-3890 26 * (412) 268-4387, fax: (412) 268-7395 27 * tech-transfer@andrew.cmu.edu 28 * 29 * 4. Redistributions of any form whatsoever must retain the following 30 * acknowledgment: 31 * "This product includes software developed by Computing Services 32 * at Carnegie Mellon University (http://www.cmu.edu/computing/)." 33 * 34 * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO 35 * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 36 * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE 37 * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 38 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN 39 * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING 40 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 41 * 42 * $Id: magic.h,v 1.5 2003/06/11 23:56:26 paulus Exp $ 43 */ 44 /***************************************************************************** 45 * randm.h - Random number generator header file. 46 * 47 * Copyright (c) 2003 by Marc Boucher, Services Informatiques (MBSI) inc. 48 * Copyright (c) 1998 Global Election Systems Inc. 49 * 50 * The authors hereby grant permission to use, copy, modify, distribute, 51 * and license this software and its documentation for any purpose, provided 52 * that existing copyright notices are retained in all copies and that this 53 * notice and the following disclaimer are included verbatim in any 54 * distributions. No written agreement, license, or royalty fee is required 55 * for any of the authorized uses. 56 * 57 * THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR 58 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 59 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 60 * IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 61 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 62 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 63 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 64 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 65 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 66 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 67 * 68 ****************************************************************************** 69 * REVISION HISTORY 70 * 71 * 03-01-01 Marc Boucher <marc@mbsi.ca> 72 * Ported to lwIP. 73 * 98-05-29 Guy Lancaster <glanca@gesn.com>, Global Election Systems Inc. 74 * Extracted from avos. 75 *****************************************************************************/ 76 77 #include "netif/ppp/ppp_opts.h" 78 #if PPP_SUPPORT /* don't build if not configured for use in lwipopts.h */ 79 80 #ifndef MAGIC_H 81 #define MAGIC_H 82 83 #ifdef __cplusplus 84 extern "C" { 85 #endif 86 87 /*********************** 88 *** PUBLIC FUNCTIONS *** 89 ***********************/ 90 91 /* 92 * Initialize the random number generator. 93 */ 94 void magic_init(void); 95 96 /* 97 * Randomize our random seed value. To be called for truly random events 98 * such as user operations and network traffic. 99 */ 100 void magic_randomize(void); 101 102 /* 103 * Return a new random number. 104 */ 105 u32_t magic(void); /* Returns the next magic number */ 106 107 /* 108 * Fill buffer with random bytes 109 * 110 * Use the random pool to generate random data. This degrades to pseudo 111 * random when used faster than randomness is supplied using magic_churnrand(). 112 * Thus it's important to make sure that the results of this are not 113 * published directly because one could predict the next result to at 114 * least some degree. Also, it's important to get a good seed before 115 * the first use. 116 */ 117 void magic_random_bytes(unsigned char *buf, u32_t buf_len); 118 119 /* 120 * Return a new random number between 0 and (2^pow)-1 included. 121 */ 122 u32_t magic_pow(u8_t pow); 123 124 #ifdef __cplusplus 125 } 126 #endif 127 128 #endif /* MAGIC_H */ 129 130 #endif /* PPP_SUPPORT */ 131