PolarSSL v1.2.9
ctr_drbg.h
Go to the documentation of this file.
1 
27 #ifndef POLARSSL_CTR_DRBG_H
28 #define POLARSSL_CTR_DRBG_H
29 
30 #include <string.h>
31 
32 #include "aes.h"
33 
34 #define POLARSSL_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED -0x0034
35 #define POLARSSL_ERR_CTR_DRBG_REQUEST_TOO_BIG -0x0036
36 #define POLARSSL_ERR_CTR_DRBG_INPUT_TOO_BIG -0x0038
37 #define POLARSSL_ERR_CTR_DRBG_FILE_IO_ERROR -0x003A
39 #define CTR_DRBG_BLOCKSIZE 16
40 #define CTR_DRBG_KEYSIZE 32
41 #define CTR_DRBG_KEYBITS ( CTR_DRBG_KEYSIZE * 8 )
42 #define CTR_DRBG_SEEDLEN ( CTR_DRBG_KEYSIZE + CTR_DRBG_BLOCKSIZE )
43 
45 #if !defined(POLARSSL_CONFIG_OPTIONS)
46 #define CTR_DRBG_ENTROPY_LEN 48
47 #define CTR_DRBG_RESEED_INTERVAL 10000
48 #define CTR_DRBG_MAX_INPUT 256
49 #define CTR_DRBG_MAX_REQUEST 1024
50 #define CTR_DRBG_MAX_SEED_INPUT 384
51 #endif /* !POLARSSL_CONFIG_OPTIONS */
52 
53 #define CTR_DRBG_PR_OFF 0
54 #define CTR_DRBG_PR_ON 1
56 #ifdef __cplusplus
57 extern "C" {
58 #endif
59 
63 typedef struct
64 {
65  unsigned char counter[16];
67  int prediction_resistance;
69  size_t entropy_len;
74  /*
75  * Callbacks (Entropy)
76  */
77  int (*f_entropy)(void *, unsigned char *, size_t);
78 
79  void *p_entropy;
80 }
82 
101  int (*f_entropy)(void *, unsigned char *, size_t),
102  void *p_entropy,
103  const unsigned char *custom,
104  size_t len );
105 
116  int resistance );
117 
126  size_t len );
127 
136  int interval );
137 
149  const unsigned char *additional, size_t len );
150 
159  const unsigned char *additional, size_t add_len );
160 
176 int ctr_drbg_random_with_add( void *p_rng,
177  unsigned char *output, size_t output_len,
178  const unsigned char *additional, size_t add_len );
179 
193 int ctr_drbg_random( void *p_rng,
194  unsigned char *output, size_t output_len );
195 
196 #if defined(POLARSSL_FS_IO)
197 
205 int ctr_drbg_write_seed_file( ctr_drbg_context *ctx, const char *path );
206 
217 int ctr_drbg_update_seed_file( ctr_drbg_context *ctx, const char *path );
218 #endif
219 
225 int ctr_drbg_self_test( int verbose );
226 
227 #ifdef __cplusplus
228 }
229 #endif
230 
231 #endif /* ctr_drbg.h */