2005-04-16 22:20:36 +00:00
|
|
|
/*
|
|
|
|
|
* include/linux/random.h
|
|
|
|
|
*
|
|
|
|
|
* Include file for the random number generator.
|
|
|
|
|
*/
|
|
|
|
|
#ifndef _LINUX_RANDOM_H
|
|
|
|
|
#define _LINUX_RANDOM_H
|
|
|
|
|
|
2012-10-13 09:46:48 +00:00
|
|
|
#include <uapi/linux/random.h>
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
|
|
2012-07-04 15:16:01 +00:00
|
|
|
extern void add_device_randomness(const void *, unsigned int);
|
2005-04-16 22:20:36 +00:00
|
|
|
extern void add_input_randomness(unsigned int type, unsigned int code,
|
|
|
|
|
unsigned int value);
|
2012-07-02 11:52:16 +00:00
|
|
|
extern void add_interrupt_randomness(int irq, int irq_flags);
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
|
extern void get_random_bytes(void *buf, int nbytes);
|
random: add new get_random_bytes_arch() function
Create a new function, get_random_bytes_arch() which will use the
architecture-specific hardware random number generator if it is
present. Change get_random_bytes() to not use the HW RNG, even if it
is avaiable.
The reason for this is that the hw random number generator is fast (if
it is present), but it requires that we trust the hardware
manufacturer to have not put in a back door. (For example, an
increasing counter encrypted by an AES key known to the NSA.)
It's unlikely that Intel (for example) was paid off by the US
Government to do this, but it's impossible for them to prove otherwise
--- especially since Bull Mountain is documented to use AES as a
whitener. Hence, the output of an evil, trojan-horse version of
RDRAND is statistically indistinguishable from an RDRAND implemented
to the specifications claimed by Intel. Short of using a tunnelling
electronic microscope to reverse engineer an Ivy Bridge chip and
disassembling and analyzing the CPU microcode, there's no way for us
to tell for sure.
Since users of get_random_bytes() in the Linux kernel need to be able
to support hardware systems where the HW RNG is not present, most
time-sensitive users of this interface have already created their own
cryptographic RNG interface which uses get_random_bytes() as a seed.
So it's much better to use the HW RNG to improve the existing random
number generator, by mixing in any entropy returned by the HW RNG into
/dev/random's entropy pool, but to always _use_ /dev/random's entropy
pool.
This way we get almost of the benefits of the HW RNG without any
potential liabilities. The only benefits we forgo is the
speed/performance enhancements --- and generic kernel code can't
depend on depend on get_random_bytes() having the speed of a HW RNG
anyway.
For those places that really want access to the arch-specific HW RNG,
if it is available, we provide get_random_bytes_arch().
Signed-off-by: "Theodore Ts'o" <tytso@mit.edu>
Cc: stable@vger.kernel.org
2012-07-05 14:35:23 +00:00
|
|
|
extern void get_random_bytes_arch(void *buf, int nbytes);
|
2005-04-16 22:20:36 +00:00
|
|
|
void generate_random_uuid(unsigned char uuid_out[16]);
|
|
|
|
|
|
|
|
|
|
#ifndef MODULE
|
2007-02-12 08:55:28 +00:00
|
|
|
extern const struct file_operations random_fops, urandom_fops;
|
2005-04-16 22:20:36 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
unsigned int get_random_int(void);
|
|
|
|
|
unsigned long randomize_range(unsigned long start, unsigned long end, unsigned long len);
|
|
|
|
|
|
2012-12-18 00:04:23 +00:00
|
|
|
u32 prandom_u32(void);
|
|
|
|
|
void prandom_seed(u32 seed);
|
2006-10-17 07:09:42 +00:00
|
|
|
|
2012-12-18 00:04:23 +00:00
|
|
|
/*
|
|
|
|
|
* These macros are preserved for backward compatibility and should be
|
|
|
|
|
* removed as soon as a transition is finished.
|
|
|
|
|
*/
|
|
|
|
|
#define random32() prandom_u32()
|
|
|
|
|
#define srandom32(seed) prandom_seed(seed)
|
|
|
|
|
|
|
|
|
|
u32 prandom_u32_state(struct rnd_state *);
|
2010-05-26 21:44:13 +00:00
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Handle minimum values for seeds
|
|
|
|
|
*/
|
|
|
|
|
static inline u32 __seed(u32 x, u32 m)
|
|
|
|
|
{
|
|
|
|
|
return (x < m) ? x + m : x;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
2012-12-18 00:04:23 +00:00
|
|
|
* prandom_seed_state - set seed for prandom_u32_state().
|
2010-05-26 21:44:13 +00:00
|
|
|
* @state: pointer to state structure to receive the seed.
|
|
|
|
|
* @seed: arbitrary 64-bit value to use as a seed.
|
|
|
|
|
*/
|
2012-12-18 00:04:23 +00:00
|
|
|
static inline void prandom_seed_state(struct rnd_state *state, u64 seed)
|
2010-05-26 21:44:13 +00:00
|
|
|
{
|
|
|
|
|
u32 i = (seed >> 32) ^ (seed << 10) ^ seed;
|
|
|
|
|
|
|
|
|
|
state->s1 = __seed(i, 1);
|
|
|
|
|
state->s2 = __seed(i, 7);
|
|
|
|
|
state->s3 = __seed(i, 15);
|
|
|
|
|
}
|
|
|
|
|
|
2011-07-31 20:54:50 +00:00
|
|
|
#ifdef CONFIG_ARCH_RANDOM
|
|
|
|
|
# include <asm/archrandom.h>
|
|
|
|
|
#else
|
|
|
|
|
static inline int arch_get_random_long(unsigned long *v)
|
|
|
|
|
{
|
|
|
|
|
return 0;
|
|
|
|
|
}
|
|
|
|
|
static inline int arch_get_random_int(unsigned int *v)
|
|
|
|
|
{
|
|
|
|
|
return 0;
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
#endif /* _LINUX_RANDOM_H */
|