SecurityServer/MacYarrow/YarrowServer/systemEntropy.h

   1 /*
   2  * Copyright (c) 2000-2001 Apple Computer, Inc. All Rights Reserved.
   3  *
   4  * The contents of this file constitute Original Code as defined in and are
   5  * subject to the Apple Public Source License Version 1.2 (the 'License').
   6  * You may not use this file except in compliance with the License. Please obtain
   7  * a copy of the License at http://www.apple.com/publicsource and read it before
   8  * using this file.
   9  *
  10  * This Original Code and all software distributed under the License are
  11  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
  12  * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT
  13  * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  14  * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
  15  * specific language governing rights and limitations under the License.
  16  */
  17
  18
  19 /*
  20         File:           systemEntropy.h
  21
  22         Contains:       System entropy collector, using
  23                                 sysctl(CTL_KERN:KERN_KDEBUG) trace info
  24
  25         Copyright:      (C) 2000 by Apple Computer, Inc., all rights reserved
  26
  27         Written by:     Doug Mitchell <dmitch@apple.com>
  28 */
  29
  30 #ifndef _YARROW_SYSTEM_ENTROPY_H_
  31 #define _YARROW_SYSTEM_ENTROPY_H_
  32
  33 #include <CoreServices/../Frameworks/CarbonCore.framework/Headers/MacTypes.h>
  34
  35 #ifdef  __cplusplus
  36 extern "C" {
  37 #endif
  38
  39 /* start collecting system entropy */
  40 int systemEntropyBegin(
  41         UInt32 bufSize);                // desired number of bytes to collect
  42
  43
  44 /* gather system entropy in caller-supplied buffer */
  45 int systemEntropyCollect(
  46         UInt8 *buf,
  47         UInt32 bufSize,
  48         UInt32 *numBytes,               // RETURNED - number of bytes obtained
  49         UInt32 *bitsOfEntropy); // RETURNED - est. amount of entropy
  50
  51 /* minimum number of milliseconds between calling systemEntropyBegin() and
  52  * systemEntropyCollect() */
  53 #define SYSTEM_ENTROPY_COLLECT_TIME             100
  54 //#define SYSTEM_ENTROPY_COLLECT_TIME           5000
  55
  56 #ifdef  __cplusplus
  57 }
  58 #endif
  59
  60 #endif  /* _YARROW_SYSTEM_ENTROPY_H_*/