diff options
Diffstat (limited to 'Source/charon/utils/randomizer.h')
-rw-r--r-- | Source/charon/utils/randomizer.h | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/Source/charon/utils/randomizer.h b/Source/charon/utils/randomizer.h new file mode 100644 index 000000000..ae2bb539c --- /dev/null +++ b/Source/charon/utils/randomizer.h @@ -0,0 +1,94 @@ +/** + * @file randomizer.h + * + * @brief Class used to get random and pseudo random values + * + */ + +/* + * Copyright (C) 2005 Jan Hutter, Martin Willi + * Hochschule fuer Technik Rapperswil + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the + * Free Software Foundation; either version 2 of the License, or (at your + * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>. + * + * This program is distributed in the hope that it will be useful, but + * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * for more details. + */ + +#ifndef RANDOMIZER_H_ +#define RANDOMIZER_H_ + +#include "../types.h" + +/** + * Object representing an randomizer + * + * This class is thread save as file system read calls are thread save... + */ +typedef struct randomizer_s randomizer_t; + +struct randomizer_s { + + /** + * @brief Reads a specific number of bytes from random device. + * + * @param this calling randomizer_t object + * @param bytes Number of bytes to read + * @param[out] buffer Pointer to buffer where to write the data in. + * Size of buffer has to be at least bytes. + * @return + * - SUCCESS + * - FAILED + */ + status_t (*get_random_bytes) (randomizer_t *this,size_t bytes, u_int8_t *buffer); + + /** + * @brief Reads a specific number of bytes from pseudo random device. + * + * @param this calling randomizer_t object + * @param bytes Number of bytes to read + * @param[out] buffer Pointer to buffer where to write the data in. + * Size of buffer has to be at least bytes. + * @return + * - SUCCESS + * - FAILED + */ + status_t (*get_pseudo_random_bytes) (randomizer_t *this,size_t bytes, u_int8_t *buffer); + + + /** + * @brief Destroys a randomizer_t object. + * + * @param this randomizer_t object to destroy + * @return + * SUCCESS in any case + */ + status_t (*destroy) (randomizer_t *this); +}; + +/** + * @brief Create an randomizer_t object + * + * @return + * - created randomizer_t, or + * - NULL if failed + */ +randomizer_t *randomizer_create(); + +/** + * @brief Create an randomizer_t object with specific random device names + * + * @param random_dev_name Device name for random values, etc /dev/random + * @param prandom_dev_name Device name for pseudo random values, etc /dev/urandom + * @return + * - created randomizer_t, or + * - NULL if failed + */ +randomizer_t *randomizer_create_on_devices(char * random_dev_name,char * prandom_dev_name); + +#endif /*RANDOMIZER_H_*/ |