cdsa/cdsa_utilities/devrandom.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 // devrandom - RNG operations based on /dev/random
  21 //
  22 #ifndef _H_DEVRANDOM
  23 #define _H_DEVRANDOM
  24
  25 #include <Security/utilities.h>
  26 #include <Security/unix++.h>
  27 #include <Security/globalizer.h>
  28
  29
  30 namespace Security {
  31
  32
  33 //
  34 // This RNG uses /dev/random.
  35 // It is not repeatable. AddEntropy() contributes random entropy to a global pool (only).
  36 //
  37 class DevRandomGenerator {
  38 public:
  39     DevRandomGenerator(bool writable = false);
  40
  41     void random(void *data, size_t length);
  42     void addEntropy(const void *data, size_t length);
  43
  44 private:
  45     static ModuleNexus<UnixPlusPlus::FileDesc> mDevRandom;
  46 };
  47
  48
  49 };      // end namespace Security
  50
  51
  52 #endif //_H_DEVRANDOM