[deliverable/linux.git] / include / linux / random.h

/*
 * include/linux/random.h
 *
 * Include file for the random number generator.
 */

#ifndef _LINUX_RANDOM_H
#define _LINUX_RANDOM_H

#include <linux/types.h>
#include <linux/ioctl.h>
#include <linux/irqnr.h>

/* ioctl()'s for the random number generator */

/* Get the entropy count. */
#define RNDGETENTCNT	_IOR( 'R', 0x00, int )

/* Add to (or subtract from) the entropy count.  (Superuser only.) */
#define RNDADDTOENTCNT	_IOW( 'R', 0x01, int )

/* Get the contents of the entropy pool.  (Superuser only.) */
#define RNDGETPOOL	_IOR( 'R', 0x02, int [2] )

/* 
 * Write bytes into the entropy pool and add to the entropy count.
 * (Superuser only.)
 */
#define RNDADDENTROPY	_IOW( 'R', 0x03, int [2] )

/* Clear entropy count to 0.  (Superuser only.) */
#define RNDZAPENTCNT	_IO( 'R', 0x04 )

/* Clear the entropy pool and associated counters.  (Superuser only.) */
#define RNDCLEARPOOL	_IO( 'R', 0x06 )

struct rand_pool_info {
	int	entropy_count;
	int	buf_size;
	__u32	buf[0];
};

struct rnd_state {
	__u32 s1, s2, s3;
};

/* Exported functions */

#ifdef __KERNEL__

extern void rand_initialize_irq(int irq);

extern void add_device_randomness(const void *, unsigned int);
extern void add_input_randomness(unsigned int type, unsigned int code,
				 unsigned int value);
extern void add_interrupt_randomness(int irq, int irq_flags);

extern void get_random_bytes(void *buf, int nbytes);
void generate_random_uuid(unsigned char uuid_out[16]);

#ifndef MODULE
extern const struct file_operations random_fops, urandom_fops;
#endif

unsigned int get_random_int(void);
unsigned long randomize_range(unsigned long start, unsigned long end, unsigned long len);

u32 random32(void);
void srandom32(u32 seed);

u32 prandom32(struct rnd_state *);

/*
 * Handle minimum values for seeds
 */
static inline u32 __seed(u32 x, u32 m)
{
	return (x < m) ? x + m : x;
}

/**
 * prandom32_seed - set seed for prandom32().
 * @state: pointer to state structure to receive the seed.
 * @seed: arbitrary 64-bit value to use as a seed.
 */
static inline void prandom32_seed(struct rnd_state *state, u64 seed)
{
	u32 i = (seed >> 32) ^ (seed << 10) ^ seed;

	state->s1 = __seed(i, 1);
	state->s2 = __seed(i, 7);
	state->s3 = __seed(i, 15);
}

#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

#endif /* __KERNEL___ */

#endif /* _LINUX_RANDOM_H */
Commit	Line	Data
1da177e4 LT	1	/*
	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
68622c61	10	#include <linux/types.h>
1da177e4	11	#include <linux/ioctl.h>
0ebb26e7	12	#include <linux/irqnr.h>
1da177e4 LT	13
	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
	37	struct rand_pool_info {
	38	int entropy_count;
	39	int buf_size;
	40	__u32 buf[0];
	41	};
	42
5960164f JE	43	struct rnd_state {
	44	__u32 s1, s2, s3;
	45	};
	46
1da177e4 LT	47	/* Exported functions */
	48
	49	#ifdef __KERNEL__
	50
	51	extern void rand_initialize_irq(int irq);
	52
a2080a67	53	extern void add_device_randomness(const void *, unsigned int);
1da177e4 LT	54	extern void add_input_randomness(unsigned int type, unsigned int code,
1da177e4 LT	55	unsigned int value);
775f4b29	56	extern void add_interrupt_randomness(int irq, int irq_flags);
1da177e4 LT	57
	58	extern void get_random_bytes(void *buf, int nbytes);
	59	void generate_random_uuid(unsigned char uuid_out[16]);
	60
1da177e4	61	#ifndef MODULE
54047320	62	extern const struct file_operations random_fops, urandom_fops;
1da177e4 LT	63	#endif
	64
	65	unsigned int get_random_int(void);
	66	unsigned long randomize_range(unsigned long start, unsigned long end, unsigned long len);
	67
aaa248f6 SH	68	u32 random32(void);
	69	void srandom32(u32 seed);
	70
5960164f JE	71	u32 prandom32(struct rnd_state *);
	72
	73	/*
	74	* Handle minimum values for seeds
	75	*/
	76	static 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	*/
	86	static 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
63d77173 PA	95	#ifdef CONFIG_ARCH_RANDOM
	96	# include <asm/archrandom.h>
	97	#else
	98	static inline int arch_get_random_long(unsigned long *v)
	99	{
	100	return 0;
	101	}
	102	static inline int arch_get_random_int(unsigned int *v)
	103	{
	104	return 0;
	105	}
	106	#endif
	107
1da177e4 LT	108	#endif /* __KERNEL___ */
	109
	110	#endif /* _LINUX_RANDOM_H */