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
  28
  29 namespace Security {
  30
  31
  32 //
  33 // This RNG uses /dev/random.
  34 // It is not repeatable. AddEntropy() contributes random entropy to a global pool (only).
  35 //
  36 class DevRandomGenerator {
  37 public:
  38     DevRandomGenerator(bool writable = false);
  39
  40     void random(void *data, size_t length);
  41     void addEntropy(const void *data, size_t length);
  42
  43 private:
  44     UnixPlusPlus::FileDesc mDevRandom;
  45 };
  46
  47
  48 };      // end namespace Security
  49
  50
  51 #endif //_H_DEVRANDOM