blob: e14b4387354a672ba93863593c5a0873acbf8f22 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * include/linux/random.h
3 *
4 * Include file for the random number generator.
5 */
6
7#ifndef _LINUX_RANDOM_H
8#define _LINUX_RANDOM_H
9
Jaswinder Singh Rajput68622c62009-01-30 22:11:32 +053010#include <linux/types.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070011#include <linux/ioctl.h>
Ingo Molnar0ebb26e2008-12-12 11:26:39 +010012#include <linux/irqnr.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070013
14/* ioctl()'s for the random number generator */
15
16/* Get the entropy count. */
17#define RNDGETENTCNT _IOR( 'R', 0x00, int )
18
19/* Add to (or subtract from) the entropy count. (Superuser only.) */
20#define RNDADDTOENTCNT _IOW( 'R', 0x01, int )
21
22/* Get the contents of the entropy pool. (Superuser only.) */
23#define RNDGETPOOL _IOR( 'R', 0x02, int [2] )
24
25/*
26 * Write bytes into the entropy pool and add to the entropy count.
27 * (Superuser only.)
28 */
29#define RNDADDENTROPY _IOW( 'R', 0x03, int [2] )
30
31/* Clear entropy count to 0. (Superuser only.) */
32#define RNDZAPENTCNT _IO( 'R', 0x04 )
33
34/* Clear the entropy pool and associated counters. (Superuser only.) */
35#define RNDCLEARPOOL _IO( 'R', 0x06 )
36
37struct rand_pool_info {
38 int entropy_count;
39 int buf_size;
40 __u32 buf[0];
41};
42
Joe Eykholt59601642010-05-26 14:44:13 -070043struct rnd_state {
44 __u32 s1, s2, s3;
45};
46
Linus Torvalds1da177e2005-04-16 15:20:36 -070047/* Exported functions */
48
49#ifdef __KERNEL__
50
51extern void rand_initialize_irq(int irq);
52
Linus Torvalds1d0eb352012-07-04 11:16:01 -040053extern void add_device_randomness(const void *, unsigned int);
Linus Torvalds1da177e2005-04-16 15:20:36 -070054extern void add_input_randomness(unsigned int type, unsigned int code,
55 unsigned int value);
Theodore Ts'o0110bbf2012-07-02 07:52:16 -040056extern void add_interrupt_randomness(int irq, int irq_flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -070057
58extern void get_random_bytes(void *buf, int nbytes);
59void generate_random_uuid(unsigned char uuid_out[16]);
60
Linus Torvalds1da177e2005-04-16 15:20:36 -070061#ifndef MODULE
Arjan van de Ven54047322007-02-12 00:55:28 -080062extern const struct file_operations random_fops, urandom_fops;
Linus Torvalds1da177e2005-04-16 15:20:36 -070063#endif
64
65unsigned int get_random_int(void);
66unsigned long randomize_range(unsigned long start, unsigned long end, unsigned long len);
67
Stephen Hemmingeraaa248f2006-10-17 00:09:42 -070068u32 random32(void);
69void srandom32(u32 seed);
70
Joe Eykholt59601642010-05-26 14:44:13 -070071u32 prandom32(struct rnd_state *);
72
73/*
74 * Handle minimum values for seeds
75 */
76static inline u32 __seed(u32 x, u32 m)
77{
78 return (x < m) ? x + m : x;
79}
80
81/**
82 * prandom32_seed - set seed for prandom32().
83 * @state: pointer to state structure to receive the seed.
84 * @seed: arbitrary 64-bit value to use as a seed.
85 */
86static inline void prandom32_seed(struct rnd_state *state, u64 seed)
87{
88 u32 i = (seed >> 32) ^ (seed << 10) ^ seed;
89
90 state->s1 = __seed(i, 1);
91 state->s2 = __seed(i, 7);
92 state->s3 = __seed(i, 15);
93}
94
H. Peter Anvin63d77172011-07-31 13:54:50 -070095#ifdef CONFIG_ARCH_RANDOM
96# include <asm/archrandom.h>
97#else
98static inline int arch_get_random_long(unsigned long *v)
99{
100 return 0;
101}
102static inline int arch_get_random_int(unsigned int *v)
103{
104 return 0;
105}
106#endif
107
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108#endif /* __KERNEL___ */
109
110#endif /* _LINUX_RANDOM_H */