sys/dev/random/randomdev_soft.h

   1 /*-
   2  * Copyright (c) 2000-2013 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$
  27  */
  28
  29 /* This header contains only those definitions that are global
  30  * and harvester-specific for the entropy processor
  31  */
  32
  33 /* #define ENTROPYSOURCE nn        entropy sources (actually classes)
  34  *                                      This is properly defined in
  35  *                                      an enum in sys/random.h
  36  */
  37
  38 /* The ring size _MUST_ be a power of 2 */
  39 #define HARVEST_RING_SIZE       1024    /* harvest ring buffer size */
  40 #define HARVEST_RING_MASK       (HARVEST_RING_SIZE - 1)
  41
  42 #define HARVESTSIZE     16      /* max size of each harvested entropy unit */
  43
  44 MALLOC_DECLARE(M_ENTROPY);
  45
  46 /* These are used to queue harvested packets of entropy. The entropy
  47  * buffer size is pretty arbitrary.
  48  */
  49 struct harvest {
  50         uintmax_t somecounter;          /* fast counter for clock jitter */
  51         uint8_t entropy[HARVESTSIZE];   /* the harvested entropy */
  52         u_int size, bits, frac;         /* stats about the entropy */
  53         enum esource source;            /* stats about the entropy */
  54         STAILQ_ENTRY(harvest) next;     /* next item on the list */
  55 };
  56
  57 void randomdev_init(void);
  58 void randomdev_deinit(void);
  59
  60 void randomdev_write(void *, int);
  61
  62 void randomdev_init_harvester(void (*)(u_int64_t, const void *, u_int,
  63         u_int, u_int, enum esource), int (*)(void *, int));
  64 void randomdev_deinit_harvester(void);
  65
  66 void random_set_wakeup_exit(void *);
  67 void random_process_event(struct harvest *event);
  68 void randomdev_unblock(void);
  69
  70 extern struct mtx random_reseed_mtx;
  71
  72 /* If this was C++, the macro below would be a template */
  73 #define RANDOM_CHECK_UINT(name, min, max)                               \
  74 static int                                                              \
  75 random_check_uint_##name(SYSCTL_HANDLER_ARGS)                           \
  76 {                                                                       \
  77         if (oidp->oid_arg1 != NULL) {                                   \
  78                  if (*(u_int *)(oidp->oid_arg1) <= (min))               \
  79                         *(u_int *)(oidp->oid_arg1) = (min);             \
  80                  else if (*(u_int *)(oidp->oid_arg1) > (max))           \
  81                         *(u_int *)(oidp->oid_arg1) = (max);             \
  82         }                                                               \
  83         return sysctl_handle_int(oidp, oidp->oid_arg1, oidp->oid_arg2,  \
  84                 req);                                                   \
  85 }