iPXE
entropy_sample.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2012 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 /** @file
27  *
28  * Entropy sampling
29  *
30  */
31 
32 #include <stdio.h>
33 #include <ipxe/entropy.h>
34 #include <ipxe/test.h>
35 
36 /** Total number of test samples */
37 #define SAMPLE_COUNT 65536
38 
39 /** Number of samples per block */
40 #define SAMPLE_BLOCKSIZE 256
41 
42 /**
43  * Generate entropy samples for external testing
44  *
45  * @v source Entropy source
46  */
47 static void entropy_sample ( struct entropy_source *source ) {
48  static noise_sample_t samples[SAMPLE_BLOCKSIZE];
49  unsigned int i;
50  unsigned int j;
51  int rc;
52 
53  /* Collect and print blocks of samples */
54  for ( i = 0 ; i < ( SAMPLE_COUNT / SAMPLE_BLOCKSIZE ) ; i++ ) {
55 
56  /* Collect one block of samples */
57  rc = entropy_enable ( source );
58  ok ( rc == 0 );
59  for ( j = 0 ; j < SAMPLE_BLOCKSIZE ; j++ ) {
60  rc = get_noise ( source, &samples[j] );
61  ok ( rc == 0 );
62  }
63  entropy_disable ( source );
64 
65  /* Print out sample values */
66  for ( j = 0 ; j < SAMPLE_BLOCKSIZE ; j++ ) {
67  printf ( "SAMPLE %s %d %d\n", source->name,
68  ( i * SAMPLE_BLOCKSIZE + j ), samples[j] );
69  }
70  }
71 }
72 
73 /**
74  * Generate entropy samples for external testing
75  *
76  */
77 static void entropy_sample_test_exec ( void ) {
78  struct entropy_source *source;
79 
80  /* Test each entropy source */
82  entropy_sample ( source );
83  }
84 }
85 
86 /** Entropy sampling self-test */
87 struct self_test entropy_sample_test __self_test = {
88  .name = "entropy_sample",
90 };
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
static void entropy_sample(struct entropy_source *source)
Generate entropy samples for external testing.
int printf(const char *fmt,...)
Write a formatted string to the console.
Definition: vsprintf.c:464
Self-test infrastructure.
const char * name
Test set name.
Definition: test.h:17
A self-test set.
Definition: test.h:15
#define ENTROPY_SOURCES
Entropy source table.
Definition: entropy.h:169
An entropy source.
Definition: entropy.h:116
struct self_test entropy_sample_test __self_test
Entropy sampling self-test.
const char * name
Name.
Definition: entropy.h:118
#define SAMPLE_COUNT
Total number of test samples.
#define for_each_table_entry(pointer, table)
Iterate through all entries within a linker table.
Definition: tables.h:385
static int get_noise(struct entropy_source *source, noise_sample_t *noise)
Get noise sample.
Definition: entropy.h:208
int entropy_enable(struct entropy_source *source)
Enable entropy gathering.
Definition: entropy.c:302
#define SAMPLE_BLOCKSIZE
Number of samples per block.
uint8_t noise_sample_t
A noise sample.
Definition: entropy.h:21
static void entropy_sample_test_exec(void)
Generate entropy samples for external testing.
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
void entropy_disable(struct entropy_source *source)
Disable entropy gathering.
Definition: entropy.c:385
#define ok(success)
Definition: test.h:46
Entropy source.