random.c 53.2 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3
/*
 * random.c -- A strong random number generator
 *
4
 * Copyright (C) 2017-2022 Jason A. Donenfeld <Jason@zx2c4.com>. All Rights Reserved.
5
 *
6
 * Copyright Matt Mackall <mpm@selenic.com>, 2003, 2004, 2005
L
Linus Torvalds 已提交
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
 *
 * Copyright Theodore Ts'o, 1994, 1995, 1996, 1997, 1998, 1999.  All
 * rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, and the entire permission notice in its entirety,
 *    including the disclaimer of warranties.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. The name of the author may not be used to endorse or promote
 *    products derived from this software without specific prior
 *    written permission.
 *
 * ALTERNATIVELY, this product may be distributed under the terms of
 * the GNU General Public License, in which case the provisions of the GPL are
 * required INSTEAD OF the above restrictions.  (This clause is
 * necessary due to a potential bad interaction between the GPL and
 * the restrictions contained in a BSD-style copyright.)
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
 * WHICH ARE HEREBY DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
 * USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 */

/*
 * Exported interfaces ---- output
 * ===============================
 *
48
 * There are four exported interfaces; two for use within the kernel,
schspa's avatar
schspa 已提交
49
 * and two for use from userspace.
L
Linus Torvalds 已提交
50
 *
51 52
 * Exported interfaces ---- userspace output
 * -----------------------------------------
L
Linus Torvalds 已提交
53
 *
54
 * The userspace interfaces are two character devices /dev/random and
L
Linus Torvalds 已提交
55 56 57 58 59 60 61 62 63 64 65 66
 * /dev/urandom.  /dev/random is suitable for use when very high
 * quality randomness is desired (for example, for key generation or
 * one-time pads), as it will only return a maximum of the number of
 * bits of randomness (as estimated by the random number generator)
 * contained in the entropy pool.
 *
 * The /dev/urandom device does not have this limit, and will return
 * as many bytes as are requested.  As more and more random bytes are
 * requested without giving time for the entropy pool to recharge,
 * this will result in random numbers that are merely cryptographically
 * strong.  For many applications, however, this is acceptable.
 *
67 68 69 70 71
 * Exported interfaces ---- kernel output
 * --------------------------------------
 *
 * The primary kernel interface is
 *
72
 *	void get_random_bytes(void *buf, int nbytes);
73 74 75 76 77 78 79
 *
 * This interface will return the requested number of random bytes,
 * and place it in the requested buffer.  This is equivalent to a
 * read from /dev/urandom.
 *
 * For less critical applications, there are the functions:
 *
80 81 82 83
 *	u32 get_random_u32()
 *	u64 get_random_u64()
 *	unsigned int get_random_int()
 *	unsigned long get_random_long()
84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
 *
 * These are produced by a cryptographic RNG seeded from get_random_bytes,
 * and so do not deplete the entropy pool as much.  These are recommended
 * for most in-kernel operations *if the result is going to be stored in
 * the kernel*.
 *
 * Specifically, the get_random_int() family do not attempt to do
 * "anti-backtracking".  If you capture the state of the kernel (e.g.
 * by snapshotting the VM), you can figure out previous get_random_int()
 * return values.  But if the value is stored in the kernel anyway,
 * this is not a problem.
 *
 * It *is* safe to expose get_random_int() output to attackers (e.g. as
 * network cookies); given outputs 1..n, it's not feasible to predict
 * outputs 0 or n+1.  The only concern is an attacker who breaks into
 * the kernel later; the get_random_int() engine is not reseeded as
 * often as the get_random_bytes() one.
 *
 * get_random_bytes() is needed for keys that need to stay secret after
 * they are erased from the kernel.  For example, any key that will
 * be wrapped and stored encrypted.  And session encryption keys: we'd
 * like to know that after the session is closed and the keys erased,
 * the plaintext is unrecoverable to someone who recorded the ciphertext.
 *
 * But for network ports/cookies, stack canaries, PRNG seeds, address
 * space layout randomization, session *authentication* keys, or other
 * applications where the sensitive data is stored in the kernel in
 * plaintext for as long as it's sensitive, the get_random_int() family
 * is just fine.
 *
 * Consider ASLR.  We want to keep the address space secret from an
 * outside attacker while the process is running, but once the address
 * space is torn down, it's of no use to an attacker any more.  And it's
 * stored in kernel data structures as long as it's alive, so worrying
 * about an attacker's ability to extrapolate it from the get_random_int()
 * CRNG is silly.
 *
 * Even some cryptographic keys are safe to generate with get_random_int().
 * In particular, keys for SipHash are generally fine.  Here, knowledge
 * of the key authorizes you to do something to a kernel object (inject
 * packets to a network connection, or flood a hash table), and the
 * key is stored with the object being protected.  Once it goes away,
 * we no longer care if anyone knows the key.
 *
 * prandom_u32()
 * -------------
 *
 * For even weaker applications, see the pseudorandom generator
 * prandom_u32(), prandom_max(), and prandom_bytes().  If the random
 * numbers aren't security-critical at all, these are *far* cheaper.
 * Useful for self-tests, random error simulation, randomized backoffs,
 * and any other application where you trust that nobody is trying to
 * maliciously mess with you by guessing the "random" numbers.
 *
L
Linus Torvalds 已提交
138 139 140 141 142 143
 * Exported interfaces ---- input
 * ==============================
 *
 * The current exported interfaces for gathering environmental noise
 * from the devices are:
 *
144
 *	void add_device_randomness(const void *buf, unsigned int size);
145
 *	void add_input_randomness(unsigned int type, unsigned int code,
L
Linus Torvalds 已提交
146
 *                                unsigned int value);
147
 *	void add_interrupt_randomness(int irq);
148
 *	void add_disk_randomness(struct gendisk *disk);
149 150 151
 *	void add_hwgenerator_randomness(const char *buffer, size_t count,
 *					size_t entropy);
 *	void add_bootloader_randomness(const void *buf, unsigned int size);
L
Linus Torvalds 已提交
152
 *
153 154 155 156 157 158 159 160
 * add_device_randomness() is for adding data to the random pool that
 * is likely to differ between two devices (or possibly even per boot).
 * This would be things like MAC addresses or serial numbers, or the
 * read-out of the RTC. This does *not* add any actual entropy to the
 * pool, but it initializes the pool to different values for devices
 * that might otherwise be identical and have very little entropy
 * available to them (particularly common in the embedded world).
 *
L
Linus Torvalds 已提交
161 162 163
 * add_input_randomness() uses the input layer interrupt timing, as well as
 * the event type information from the hardware.
 *
164 165 166
 * add_interrupt_randomness() uses the interrupt timing as random
 * inputs to the entropy pool. Using the cycle counters and the irq source
 * as inputs, it feeds the randomness roughly once a second.
167 168 169 170 171 172
 *
 * add_disk_randomness() uses what amounts to the seek time of block
 * layer request events, on a per-disk_devt basis, as input to the
 * entropy pool. Note that high-speed solid state drives with very low
 * seek times do not make for good sources of entropy, as their seek
 * times are usually fairly consistent.
L
Linus Torvalds 已提交
173 174 175 176 177
 *
 * All of these routines try to estimate how many bits of randomness a
 * particular randomness source.  They do this by keeping track of the
 * first and second order deltas of the event timings.
 *
178 179 180 181 182 183 184 185
 * add_hwgenerator_randomness() is for true hardware RNGs, and will credit
 * entropy as specified by the caller. If the entropy pool is full it will
 * block until more entropy is needed.
 *
 * add_bootloader_randomness() is the same as add_hwgenerator_randomness() or
 * add_device_randomness(), depending on whether or not the configuration
 * option CONFIG_RANDOM_TRUST_BOOTLOADER is set.
 *
L
Linus Torvalds 已提交
186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243
 * Ensuring unpredictability at system startup
 * ============================================
 *
 * When any operating system starts up, it will go through a sequence
 * of actions that are fairly predictable by an adversary, especially
 * if the start-up does not involve interaction with a human operator.
 * This reduces the actual number of bits of unpredictability in the
 * entropy pool below the value in entropy_count.  In order to
 * counteract this effect, it helps to carry information in the
 * entropy pool across shut-downs and start-ups.  To do this, put the
 * following lines an appropriate script which is run during the boot
 * sequence:
 *
 *	echo "Initializing random number generator..."
 *	random_seed=/var/run/random-seed
 *	# Carry a random seed from start-up to start-up
 *	# Load and then save the whole entropy pool
 *	if [ -f $random_seed ]; then
 *		cat $random_seed >/dev/urandom
 *	else
 *		touch $random_seed
 *	fi
 *	chmod 600 $random_seed
 *	dd if=/dev/urandom of=$random_seed count=1 bs=512
 *
 * and the following lines in an appropriate script which is run as
 * the system is shutdown:
 *
 *	# Carry a random seed from shut-down to start-up
 *	# Save the whole entropy pool
 *	echo "Saving random seed..."
 *	random_seed=/var/run/random-seed
 *	touch $random_seed
 *	chmod 600 $random_seed
 *	dd if=/dev/urandom of=$random_seed count=1 bs=512
 *
 * For example, on most modern systems using the System V init
 * scripts, such code fragments would be found in
 * /etc/rc.d/init.d/random.  On older Linux systems, the correct script
 * location might be in /etc/rcb.d/rc.local or /etc/rc.d/rc.0.
 *
 * Effectively, these commands cause the contents of the entropy pool
 * to be saved at shut-down time and reloaded into the entropy pool at
 * start-up.  (The 'dd' in the addition to the bootup script is to
 * make sure that /etc/random-seed is different for every start-up,
 * even if the system crashes without executing rc.0.)  Even with
 * complete knowledge of the start-up activities, predicting the state
 * of the entropy pool requires knowledge of the previous history of
 * the system.
 *
 * Configuring the /dev/random driver under Linux
 * ==============================================
 *
 * The /dev/random driver under Linux uses minor numbers 8 and 9 of
 * the /dev/mem major number (#1).  So if your system does not have
 * /dev/random and /dev/urandom created already, they can be created
 * by using the commands:
 *
244 245
 *	mknod /dev/random c 1 8
 *	mknod /dev/urandom c 1 9
L
Linus Torvalds 已提交
246 247
 */

Y
Yangtao Li 已提交
248 249
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

L
Linus Torvalds 已提交
250 251 252 253 254 255 256 257 258 259 260 261 262
#include <linux/utsname.h>
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/major.h>
#include <linux/string.h>
#include <linux/fcntl.h>
#include <linux/slab.h>
#include <linux/random.h>
#include <linux/poll.h>
#include <linux/init.h>
#include <linux/fs.h>
#include <linux/genhd.h>
#include <linux/interrupt.h>
263
#include <linux/mm.h>
264
#include <linux/nodemask.h>
L
Linus Torvalds 已提交
265
#include <linux/spinlock.h>
266
#include <linux/kthread.h>
L
Linus Torvalds 已提交
267
#include <linux/percpu.h>
268
#include <linux/ptrace.h>
269
#include <linux/workqueue.h>
270
#include <linux/irq.h>
271
#include <linux/ratelimit.h>
272 273
#include <linux/syscalls.h>
#include <linux/completion.h>
274
#include <linux/uuid.h>
275
#include <crypto/chacha.h>
276
#include <crypto/blake2s.h>
277

L
Linus Torvalds 已提交
278
#include <asm/processor.h>
279
#include <linux/uaccess.h>
L
Linus Torvalds 已提交
280
#include <asm/irq.h>
281
#include <asm/irq_regs.h>
L
Linus Torvalds 已提交
282 283
#include <asm/io.h>

284 285 286
#define CREATE_TRACE_POINTS
#include <trace/events/random.h>

287 288
/* #define ADD_INTERRUPT_BENCH */

289
enum {
290
	POOL_BITS = BLAKE2S_HASH_SIZE * 8,
291
	POOL_MIN_BITS = POOL_BITS /* No point in settling for less. */
L
Linus Torvalds 已提交
292 293 294 295 296
};

/*
 * Static global variables
 */
297
static DECLARE_WAIT_QUEUE_HEAD(random_write_wait);
298
static struct fasync_struct *fasync;
L
Linus Torvalds 已提交
299

300 301 302
static DEFINE_SPINLOCK(random_ready_list_lock);
static LIST_HEAD(random_ready_list);

303
struct crng_state {
304 305 306
	u32 state[16];
	unsigned long init_time;
	spinlock_t lock;
307 308
};

309
static struct crng_state primary_crng = {
310
	.lock = __SPIN_LOCK_UNLOCKED(primary_crng.lock),
311 312 313 314
	.state[0] = CHACHA_CONSTANT_EXPA,
	.state[1] = CHACHA_CONSTANT_ND_3,
	.state[2] = CHACHA_CONSTANT_2_BY,
	.state[3] = CHACHA_CONSTANT_TE_K,
315 316 317 318 319 320 321 322 323 324 325
};

/*
 * crng_init =  0 --> Uninitialized
 *		1 --> Initialized
 *		2 --> Initialized from input_pool
 *
 * crng_init is protected by primary_crng->lock, and only increases
 * its value (from 0->1->2).
 */
static int crng_init = 0;
326
static bool crng_need_final_init = false;
T
Theodore Ts'o 已提交
327
#define crng_ready() (likely(crng_init > 1))
328
static int crng_init_cnt = 0;
329
static unsigned long crng_global_init_time = 0;
330
#define CRNG_INIT_CNT_THRESH (2 * CHACHA_KEY_SIZE)
331
static void _extract_crng(struct crng_state *crng, u8 out[CHACHA_BLOCK_SIZE]);
332
static void _crng_backtrack_protect(struct crng_state *crng,
333
				    u8 tmp[CHACHA_BLOCK_SIZE], int used);
334
static void process_random_ready_list(void);
335
static void _get_random_bytes(void *buf, int nbytes);
336

337 338 339 340 341 342 343 344 345 346
static struct ratelimit_state unseeded_warning =
	RATELIMIT_STATE_INIT("warn_unseeded_randomness", HZ, 3);
static struct ratelimit_state urandom_warning =
	RATELIMIT_STATE_INIT("warn_urandom_randomness", HZ, 3);

static int ratelimit_disable __read_mostly;

module_param_named(ratelimit_disable, ratelimit_disable, int, 0644);
MODULE_PARM_DESC(ratelimit_disable, "Disable random ratelimit suppression");

L
Linus Torvalds 已提交
347 348 349 350 351 352 353
/**********************************************************************
 *
 * OS independent entropy store.   Here are the functions which handle
 * storing entropy in an entropy pool.
 *
 **********************************************************************/

354
static struct {
355
	struct blake2s_state hash;
356
	spinlock_t lock;
357
	int entropy_count;
358
} input_pool = {
359 360 361 362
	.hash.h = { BLAKE2S_IV0 ^ (0x01010000 | BLAKE2S_HASH_SIZE),
		    BLAKE2S_IV1, BLAKE2S_IV2, BLAKE2S_IV3, BLAKE2S_IV4,
		    BLAKE2S_IV5, BLAKE2S_IV6, BLAKE2S_IV7 },
	.hash.outlen = BLAKE2S_HASH_SIZE,
363
	.lock = __SPIN_LOCK_UNLOCKED(input_pool.lock),
L
Linus Torvalds 已提交
364 365
};

366
static void extract_entropy(void *buf, size_t nbytes);
367 368 369

static void crng_reseed(struct crng_state *crng, bool use_input_pool);

L
Linus Torvalds 已提交
370
/*
371
 * This function adds bytes into the entropy "pool".  It does not
L
Linus Torvalds 已提交
372
 * update the entropy estimate.  The caller should call
373
 * credit_entropy_bits if this is appropriate.
L
Linus Torvalds 已提交
374
 */
375
static void _mix_pool_bytes(const void *in, int nbytes)
L
Linus Torvalds 已提交
376
{
377
	blake2s_update(&input_pool.hash, in, nbytes);
L
Linus Torvalds 已提交
378 379
}

380
static void __mix_pool_bytes(const void *in, int nbytes)
381
{
382 383
	trace_mix_pool_bytes_nolock(nbytes, _RET_IP_);
	_mix_pool_bytes(in, nbytes);
384 385
}

386
static void mix_pool_bytes(const void *in, int nbytes)
L
Linus Torvalds 已提交
387
{
388 389
	unsigned long flags;

390 391 392 393
	trace_mix_pool_bytes(nbytes, _RET_IP_);
	spin_lock_irqsave(&input_pool.lock, flags);
	_mix_pool_bytes(in, nbytes);
	spin_unlock_irqrestore(&input_pool.lock, flags);
L
Linus Torvalds 已提交
394 395
}

396
struct fast_pool {
397 398 399 400
	u32 pool[4];
	unsigned long last;
	u16 reg_idx;
	u8 count;
401 402 403 404 405 406 407
};

/*
 * This is a fast mixing routine used by the interrupt randomness
 * collector.  It's hardcoded for an 128 bit pool and assumes that any
 * locks that might be needed are taken by the caller.
 */
408
static void fast_mix(struct fast_pool *f)
409
{
410 411
	u32 a = f->pool[0],	b = f->pool[1];
	u32 c = f->pool[2],	d = f->pool[3];
412 413

	a += b;			c += d;
G
George Spelvin 已提交
414
	b = rol32(b, 6);	d = rol32(d, 27);
415 416 417
	d ^= a;			b ^= c;

	a += b;			c += d;
G
George Spelvin 已提交
418
	b = rol32(b, 16);	d = rol32(d, 14);
419 420 421
	d ^= a;			b ^= c;

	a += b;			c += d;
G
George Spelvin 已提交
422
	b = rol32(b, 6);	d = rol32(d, 27);
423 424 425
	d ^= a;			b ^= c;

	a += b;			c += d;
G
George Spelvin 已提交
426
	b = rol32(b, 16);	d = rol32(d, 14);
427 428 429 430
	d ^= a;			b ^= c;

	f->pool[0] = a;  f->pool[1] = b;
	f->pool[2] = c;  f->pool[3] = d;
431
	f->count++;
432 433
}

434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449
static void process_random_ready_list(void)
{
	unsigned long flags;
	struct random_ready_callback *rdy, *tmp;

	spin_lock_irqsave(&random_ready_list_lock, flags);
	list_for_each_entry_safe(rdy, tmp, &random_ready_list, list) {
		struct module *owner = rdy->owner;

		list_del_init(&rdy->list);
		rdy->func(rdy);
		module_put(owner);
	}
	spin_unlock_irqrestore(&random_ready_list_lock, flags);
}

450
static void credit_entropy_bits(int nbits)
L
Linus Torvalds 已提交
451
{
452
	int entropy_count, orig;
453

454
	if (nbits <= 0)
455 456
		return;

457 458
	nbits = min(nbits, POOL_BITS);

459 460 461 462
	do {
		orig = READ_ONCE(input_pool.entropy_count);
		entropy_count = min(POOL_BITS, orig + nbits);
	} while (cmpxchg(&input_pool.entropy_count, orig, entropy_count) != orig);
L
Linus Torvalds 已提交
463

464
	trace_credit_entropy_bits(nbits, entropy_count, _RET_IP_);
465

466
	if (crng_init < 2 && entropy_count >= POOL_MIN_BITS)
467
		crng_reseed(&primary_crng, true);
L
Linus Torvalds 已提交
468 469
}

470 471 472 473 474 475
/*********************************************************************
 *
 * CRNG using CHACHA20
 *
 *********************************************************************/

476
#define CRNG_RESEED_INTERVAL (300 * HZ)
477 478 479

static DECLARE_WAIT_QUEUE_HEAD(crng_init_wait);

480 481 482 483 484 485 486 487
/*
 * Hack to deal with crazy userspace progams when they are all trying
 * to access /dev/urandom in parallel.  The programs are almost
 * certainly doing something terribly wrong, but we'll work around
 * their brain damage.
 */
static struct crng_state **crng_node_pool __read_mostly;

488
static void invalidate_batched_entropy(void);
489
static void numa_crng_init(void);
490

491 492 493 494 495 496 497
static bool trust_cpu __ro_after_init = IS_ENABLED(CONFIG_RANDOM_TRUST_CPU);
static int __init parse_trust_cpu(char *arg)
{
	return kstrtobool(arg, &trust_cpu);
}
early_param("random.trust_cpu", parse_trust_cpu);

498
static bool crng_init_try_arch(struct crng_state *crng)
499
{
500 501 502
	int i;
	bool arch_init = true;
	unsigned long rv;
503 504 505

	for (i = 4; i < 16; i++) {
		if (!arch_get_random_seed_long(&rv) &&
506
		    !arch_get_random_long(&rv)) {
507
			rv = random_get_entropy();
508
			arch_init = false;
509
		}
510 511
		crng->state[i] ^= rv;
	}
512 513 514 515

	return arch_init;
}

516
static bool __init crng_init_try_arch_early(void)
517
{
518 519 520
	int i;
	bool arch_init = true;
	unsigned long rv;
521 522 523 524 525 526 527

	for (i = 4; i < 16; i++) {
		if (!arch_get_random_seed_long_early(&rv) &&
		    !arch_get_random_long_early(&rv)) {
			rv = random_get_entropy();
			arch_init = false;
		}
528
		primary_crng.state[i] ^= rv;
529 530 531 532 533
	}

	return arch_init;
}

534
static void crng_initialize_secondary(struct crng_state *crng)
535
{
536
	chacha_init_consts(crng->state);
537
	_get_random_bytes(&crng->state[4], sizeof(u32) * 12);
538 539 540 541
	crng_init_try_arch(crng);
	crng->init_time = jiffies - CRNG_RESEED_INTERVAL - 1;
}

542
static void __init crng_initialize_primary(void)
543
{
544
	extract_entropy(&primary_crng.state[4], sizeof(u32) * 12);
545
	if (crng_init_try_arch_early() && trust_cpu && crng_init < 2) {
546 547
		invalidate_batched_entropy();
		numa_crng_init();
548
		crng_init = 2;
549
		pr_notice("crng init done (trusting CPU's manufacturer)\n");
550
	}
551
	primary_crng.init_time = jiffies - CRNG_RESEED_INTERVAL - 1;
552 553
}

554
static void crng_finalize_init(void)
555 556 557 558 559 560 561 562 563 564 565
{
	if (!system_wq) {
		/* We can't call numa_crng_init until we have workqueues,
		 * so mark this for processing later. */
		crng_need_final_init = true;
		return;
	}

	invalidate_batched_entropy();
	numa_crng_init();
	crng_init = 2;
566
	crng_need_final_init = false;
567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582
	process_random_ready_list();
	wake_up_interruptible(&crng_init_wait);
	kill_fasync(&fasync, SIGIO, POLL_IN);
	pr_notice("crng init done\n");
	if (unseeded_warning.missed) {
		pr_notice("%d get_random_xx warning(s) missed due to ratelimiting\n",
			  unseeded_warning.missed);
		unseeded_warning.missed = 0;
	}
	if (urandom_warning.missed) {
		pr_notice("%d urandom warning(s) missed due to ratelimiting\n",
			  urandom_warning.missed);
		urandom_warning.missed = 0;
	}
}

583
static void do_numa_crng_init(struct work_struct *work)
584 585 586 587 588
{
	int i;
	struct crng_state *crng;
	struct crng_state **pool;

589
	pool = kcalloc(nr_node_ids, sizeof(*pool), GFP_KERNEL | __GFP_NOFAIL);
590 591 592 593
	for_each_online_node(i) {
		crng = kmalloc_node(sizeof(struct crng_state),
				    GFP_KERNEL | __GFP_NOFAIL, i);
		spin_lock_init(&crng->lock);
594
		crng_initialize_secondary(crng);
595 596
		pool[i] = crng;
	}
597 598
	/* pairs with READ_ONCE() in select_crng() */
	if (cmpxchg_release(&crng_node_pool, NULL, pool) != NULL) {
599 600 601 602 603
		for_each_node(i)
			kfree(pool[i]);
		kfree(pool);
	}
}
604 605 606 607 608

static DECLARE_WORK(numa_crng_init_work, do_numa_crng_init);

static void numa_crng_init(void)
{
609 610
	if (IS_ENABLED(CONFIG_NUMA))
		schedule_work(&numa_crng_init_work);
611
}
612 613 614

static struct crng_state *select_crng(void)
{
615 616 617 618 619 620 621 622 623
	if (IS_ENABLED(CONFIG_NUMA)) {
		struct crng_state **pool;
		int nid = numa_node_id();

		/* pairs with cmpxchg_release() in do_numa_crng_init() */
		pool = READ_ONCE(crng_node_pool);
		if (pool && pool[nid])
			return pool[nid];
	}
624 625 626

	return &primary_crng;
}
627

628 629
/*
 * crng_fast_load() can be called by code in the interrupt service
630 631
 * path.  So we can't afford to dilly-dally. Returns the number of
 * bytes processed from cp.
632
 */
633
static size_t crng_fast_load(const u8 *cp, size_t len)
634 635
{
	unsigned long flags;
636
	u8 *p;
637
	size_t ret = 0;
638 639 640

	if (!spin_trylock_irqsave(&primary_crng.lock, flags))
		return 0;
T
Theodore Ts'o 已提交
641
	if (crng_init != 0) {
642 643 644
		spin_unlock_irqrestore(&primary_crng.lock, flags);
		return 0;
	}
645
	p = (u8 *)&primary_crng.state[4];
646
	while (len > 0 && crng_init_cnt < CRNG_INIT_CNT_THRESH) {
647
		p[crng_init_cnt % CHACHA_KEY_SIZE] ^= *cp;
648
		cp++; crng_init_cnt++; len--; ret++;
649
	}
650
	spin_unlock_irqrestore(&primary_crng.lock, flags);
651
	if (crng_init_cnt >= CRNG_INIT_CNT_THRESH) {
652
		invalidate_batched_entropy();
653
		crng_init = 1;
Y
Yangtao Li 已提交
654
		pr_notice("fast init done\n");
655
	}
656
	return ret;
657 658
}

659 660 661 662 663 664 665 666 667 668 669 670 671 672
/*
 * crng_slow_load() is called by add_device_randomness, which has two
 * attributes.  (1) We can't trust the buffer passed to it is
 * guaranteed to be unpredictable (so it might not have any entropy at
 * all), and (2) it doesn't have the performance constraints of
 * crng_fast_load().
 *
 * So we do something more comprehensive which is guaranteed to touch
 * all of the primary_crng's state, and which uses a LFSR with a
 * period of 255 as part of the mixing algorithm.  Finally, we do
 * *not* advance crng_init_cnt since buffer we may get may be something
 * like a fixed DMI table (for example), which might very well be
 * unique to the machine, but is otherwise unvarying.
 */
673
static int crng_slow_load(const u8 *cp, size_t len)
674
{
675 676 677 678 679 680
	unsigned long flags;
	static u8 lfsr = 1;
	u8 tmp;
	unsigned int i, max = CHACHA_KEY_SIZE;
	const u8 *src_buf = cp;
	u8 *dest_buf = (u8 *)&primary_crng.state[4];
681 682 683 684 685 686 687 688 689 690

	if (!spin_trylock_irqsave(&primary_crng.lock, flags))
		return 0;
	if (crng_init != 0) {
		spin_unlock_irqrestore(&primary_crng.lock, flags);
		return 0;
	}
	if (len > max)
		max = len;

691
	for (i = 0; i < max; i++) {
692 693 694 695
		tmp = lfsr;
		lfsr >>= 1;
		if (tmp & 1)
			lfsr ^= 0xE1;
696 697
		tmp = dest_buf[i % CHACHA_KEY_SIZE];
		dest_buf[i % CHACHA_KEY_SIZE] ^= src_buf[i % len] ^ lfsr;
698 699 700 701 702 703
		lfsr += (tmp << 3) | (tmp >> 5);
	}
	spin_unlock_irqrestore(&primary_crng.lock, flags);
	return 1;
}

704
static void crng_reseed(struct crng_state *crng, bool use_input_pool)
705
{
706
	unsigned long flags;
707
	int i;
708
	union {
709 710
		u8 block[CHACHA_BLOCK_SIZE];
		u32 key[8];
711 712
	} buf;

713
	if (use_input_pool) {
714 715 716
		int entropy_count;
		do {
			entropy_count = READ_ONCE(input_pool.entropy_count);
717
			if (entropy_count < POOL_MIN_BITS)
718 719 720
				return;
		} while (cmpxchg(&input_pool.entropy_count, entropy_count, 0) != entropy_count);
		extract_entropy(buf.key, sizeof(buf.key));
721 722
		wake_up_interruptible(&random_write_wait);
		kill_fasync(&fasync, SIGIO, POLL_OUT);
723
	} else {
724
		_extract_crng(&primary_crng, buf.block);
725
		_crng_backtrack_protect(&primary_crng, buf.block,
726
					CHACHA_KEY_SIZE);
727
	}
728
	spin_lock_irqsave(&crng->lock, flags);
729
	for (i = 0; i < 8; i++) {
730
		unsigned long rv;
731 732 733
		if (!arch_get_random_seed_long(&rv) &&
		    !arch_get_random_long(&rv))
			rv = random_get_entropy();
734
		crng->state[i + 4] ^= buf.key[i] ^ rv;
735 736
	}
	memzero_explicit(&buf, sizeof(buf));
737
	WRITE_ONCE(crng->init_time, jiffies);
738
	spin_unlock_irqrestore(&crng->lock, flags);
739 740
	if (crng == &primary_crng && crng_init < 2)
		crng_finalize_init();
741 742
}

743
static void _extract_crng(struct crng_state *crng, u8 out[CHACHA_BLOCK_SIZE])
744
{
745
	unsigned long flags, init_time;
746 747 748 749 750

	if (crng_ready()) {
		init_time = READ_ONCE(crng->init_time);
		if (time_after(READ_ONCE(crng_global_init_time), init_time) ||
		    time_after(jiffies, init_time + CRNG_RESEED_INTERVAL))
751
			crng_reseed(crng, crng == &primary_crng);
752
	}
753 754 755 756 757 758 759
	spin_lock_irqsave(&crng->lock, flags);
	chacha20_block(&crng->state[0], out);
	if (crng->state[12] == 0)
		crng->state[13]++;
	spin_unlock_irqrestore(&crng->lock, flags);
}

760
static void extract_crng(u8 out[CHACHA_BLOCK_SIZE])
761
{
762
	_extract_crng(select_crng(), out);
763 764
}

765 766 767 768 769
/*
 * Use the leftover bytes from the CRNG block output (if there is
 * enough) to mutate the CRNG key to provide backtracking protection.
 */
static void _crng_backtrack_protect(struct crng_state *crng,
770
				    u8 tmp[CHACHA_BLOCK_SIZE], int used)
771
{
772 773 774
	unsigned long flags;
	u32 *s, *d;
	int i;
775

776
	used = round_up(used, sizeof(u32));
777
	if (used + CHACHA_KEY_SIZE > CHACHA_BLOCK_SIZE) {
778 779 780 781
		extract_crng(tmp);
		used = 0;
	}
	spin_lock_irqsave(&crng->lock, flags);
782
	s = (u32 *)&tmp[used];
783
	d = &crng->state[4];
784
	for (i = 0; i < 8; i++)
785 786 787 788
		*d++ ^= *s++;
	spin_unlock_irqrestore(&crng->lock, flags);
}

789
static void crng_backtrack_protect(u8 tmp[CHACHA_BLOCK_SIZE], int used)
790
{
791
	_crng_backtrack_protect(select_crng(), tmp, used);
792 793
}

794 795
static ssize_t extract_crng_user(void __user *buf, size_t nbytes)
{
796
	ssize_t ret = 0, i = CHACHA_BLOCK_SIZE;
797
	u8 tmp[CHACHA_BLOCK_SIZE] __aligned(4);
798 799 800 801 802 803 804 805 806 807 808 809 810
	int large_request = (nbytes > 256);

	while (nbytes) {
		if (large_request && need_resched()) {
			if (signal_pending(current)) {
				if (ret == 0)
					ret = -ERESTARTSYS;
				break;
			}
			schedule();
		}

		extract_crng(tmp);
811
		i = min_t(int, nbytes, CHACHA_BLOCK_SIZE);
812 813 814 815 816 817 818 819 820
		if (copy_to_user(buf, tmp, i)) {
			ret = -EFAULT;
			break;
		}

		nbytes -= i;
		buf += i;
		ret += i;
	}
821
	crng_backtrack_protect(tmp, i);
822 823 824 825 826 827 828

	/* Wipe data just written to memory */
	memzero_explicit(tmp, sizeof(tmp));

	return ret;
}

L
Linus Torvalds 已提交
829 830 831 832 833 834 835 836 837
/*********************************************************************
 *
 * Entropy input management
 *
 *********************************************************************/

/* There is one of these per entropy source */
struct timer_rand_state {
	cycles_t last_time;
838
	long last_delta, last_delta2;
L
Linus Torvalds 已提交
839 840
};

841 842
#define INIT_TIMER_RAND_STATE { INITIAL_JIFFIES, };

843
/*
844 845
 * Add device- or boot-specific data to the input pool to help
 * initialize it.
846
 *
847 848 849
 * None of this adds any entropy; it is meant to avoid the problem of
 * the entropy pool having similar initial state across largely
 * identical devices.
850 851 852
 */
void add_device_randomness(const void *buf, unsigned int size)
{
853
	unsigned long time = random_get_entropy() ^ jiffies;
854
	unsigned long flags;
855

856 857
	if (!crng_ready() && size)
		crng_slow_load(buf, size);
858

859
	trace_add_device_randomness(size, _RET_IP_);
860
	spin_lock_irqsave(&input_pool.lock, flags);
861 862
	_mix_pool_bytes(buf, size);
	_mix_pool_bytes(&time, sizeof(time));
863
	spin_unlock_irqrestore(&input_pool.lock, flags);
864 865 866
}
EXPORT_SYMBOL(add_device_randomness);

867
static struct timer_rand_state input_timer_state = INIT_TIMER_RAND_STATE;
868

L
Linus Torvalds 已提交
869 870 871 872 873 874 875 876 877 878 879 880 881 882
/*
 * This function adds entropy to the entropy "pool" by using timing
 * delays.  It uses the timer_rand_state structure to make an estimate
 * of how many bits of entropy this call has added to the pool.
 *
 * The number "num" is also added to the pool - it should somehow describe
 * the type of event which just happened.  This is currently 0-255 for
 * keyboard scan codes, and 256 upwards for interrupts.
 *
 */
static void add_timer_randomness(struct timer_rand_state *state, unsigned num)
{
	struct {
		long jiffies;
883 884
		unsigned int cycles;
		unsigned int num;
L
Linus Torvalds 已提交
885 886 887 888
	} sample;
	long delta, delta2, delta3;

	sample.jiffies = jiffies;
889
	sample.cycles = random_get_entropy();
L
Linus Torvalds 已提交
890
	sample.num = num;
891
	mix_pool_bytes(&sample, sizeof(sample));
L
Linus Torvalds 已提交
892 893 894 895 896 897

	/*
	 * Calculate number of bits of randomness we probably added.
	 * We take into account the first, second and third-order deltas
	 * in order to make our estimate.
	 */
898 899
	delta = sample.jiffies - READ_ONCE(state->last_time);
	WRITE_ONCE(state->last_time, sample.jiffies);
900

901 902
	delta2 = delta - READ_ONCE(state->last_delta);
	WRITE_ONCE(state->last_delta, delta);
903

904 905
	delta3 = delta2 - READ_ONCE(state->last_delta2);
	WRITE_ONCE(state->last_delta2, delta2);
906 907 908 909 910 911 912 913 914 915 916

	if (delta < 0)
		delta = -delta;
	if (delta2 < 0)
		delta2 = -delta2;
	if (delta3 < 0)
		delta3 = -delta3;
	if (delta > delta2)
		delta = delta2;
	if (delta > delta3)
		delta = delta3;
L
Linus Torvalds 已提交
917

918 919 920
	/*
	 * delta is now minimum absolute delta.
	 * Round down by 1 bit on general principles,
921
	 * and limit entropy estimate to 12 bits.
922
	 */
923
	credit_entropy_bits(min_t(int, fls(delta >> 1), 11));
L
Linus Torvalds 已提交
924 925
}

926
void add_input_randomness(unsigned int type, unsigned int code,
927
			  unsigned int value)
L
Linus Torvalds 已提交
928 929 930 931 932 933 934 935 936 937
{
	static unsigned char last_value;

	/* ignore autorepeat and the like */
	if (value == last_value)
		return;

	last_value = value;
	add_timer_randomness(&input_timer_state,
			     (type << 4) ^ code ^ (code >> 4) ^ value);
938
	trace_add_input_randomness(input_pool.entropy_count);
L
Linus Torvalds 已提交
939
}
940
EXPORT_SYMBOL_GPL(add_input_randomness);
L
Linus Torvalds 已提交
941

942 943
static DEFINE_PER_CPU(struct fast_pool, irq_randomness);

944 945 946
#ifdef ADD_INTERRUPT_BENCH
static unsigned long avg_cycles, avg_deviation;

947 948
#define AVG_SHIFT 8 /* Exponential average factor k=1/256 */
#define FIXED_1_2 (1 << (AVG_SHIFT - 1))
949 950 951

static void add_interrupt_bench(cycles_t start)
{
952
	long delta = random_get_entropy() - start;
953

954 955 956 957 958 959
	/* Use a weighted moving average */
	delta = delta - ((avg_cycles + FIXED_1_2) >> AVG_SHIFT);
	avg_cycles += delta;
	/* And average deviation */
	delta = abs(delta) - ((avg_deviation + FIXED_1_2) >> AVG_SHIFT);
	avg_deviation += delta;
960 961 962 963 964
}
#else
#define add_interrupt_bench(x)
#endif

965
static u32 get_reg(struct fast_pool *f, struct pt_regs *regs)
966
{
967
	u32 *ptr = (u32 *)regs;
968
	unsigned int idx;
969 970 971

	if (regs == NULL)
		return 0;
972
	idx = READ_ONCE(f->reg_idx);
973
	if (idx >= sizeof(struct pt_regs) / sizeof(u32))
974 975 976
		idx = 0;
	ptr += idx++;
	WRITE_ONCE(f->reg_idx, idx);
977
	return *ptr;
978 979
}

980
void add_interrupt_randomness(int irq)
L
Linus Torvalds 已提交
981
{
982 983 984 985 986 987
	struct fast_pool *fast_pool = this_cpu_ptr(&irq_randomness);
	struct pt_regs *regs = get_irq_regs();
	unsigned long now = jiffies;
	cycles_t cycles = random_get_entropy();
	u32 c_high, j_high;
	u64 ip;
988

989 990
	if (cycles == 0)
		cycles = get_reg(fast_pool, regs);
991 992
	c_high = (sizeof(cycles) > 4) ? cycles >> 32 : 0;
	j_high = (sizeof(now) > 4) ? now >> 32 : 0;
993 994
	fast_pool->pool[0] ^= cycles ^ j_high ^ irq;
	fast_pool->pool[1] ^= now ^ c_high;
995
	ip = regs ? instruction_pointer(regs) : _RET_IP_;
996
	fast_pool->pool[2] ^= ip;
997 998
	fast_pool->pool[3] ^=
		(sizeof(ip) > 4) ? ip >> 32 : get_reg(fast_pool, regs);
999

1000 1001
	fast_mix(fast_pool);
	add_interrupt_bench(cycles);
1002

T
Theodore Ts'o 已提交
1003
	if (unlikely(crng_init == 0)) {
1004
		if ((fast_pool->count >= 64) &&
1005
		    crng_fast_load((u8 *)fast_pool->pool, sizeof(fast_pool->pool)) > 0) {
1006 1007 1008 1009 1010 1011
			fast_pool->count = 0;
			fast_pool->last = now;
		}
		return;
	}

1012
	if ((fast_pool->count < 64) && !time_after(now, fast_pool->last + HZ))
L
Linus Torvalds 已提交
1013 1014
		return;

1015
	if (!spin_trylock(&input_pool.lock))
1016
		return;
1017

1018
	fast_pool->last = now;
1019 1020
	__mix_pool_bytes(&fast_pool->pool, sizeof(fast_pool->pool));
	spin_unlock(&input_pool.lock);
1021

1022
	fast_pool->count = 0;
1023

1024
	/* award one bit for the contents of the fast pool */
1025
	credit_entropy_bits(1);
L
Linus Torvalds 已提交
1026
}
1027
EXPORT_SYMBOL_GPL(add_interrupt_randomness);
L
Linus Torvalds 已提交
1028

1029
#ifdef CONFIG_BLOCK
L
Linus Torvalds 已提交
1030 1031 1032 1033 1034
void add_disk_randomness(struct gendisk *disk)
{
	if (!disk || !disk->random)
		return;
	/* first major is 1, so we get >= 0x200 here */
1035
	add_timer_randomness(disk->random, 0x100 + disk_devt(disk));
1036
	trace_add_disk_randomness(disk_devt(disk), input_pool.entropy_count);
L
Linus Torvalds 已提交
1037
}
1038
EXPORT_SYMBOL_GPL(add_disk_randomness);
1039
#endif
L
Linus Torvalds 已提交
1040 1041 1042 1043 1044 1045 1046

/*********************************************************************
 *
 * Entropy extraction routines
 *
 *********************************************************************/

G
Greg Price 已提交
1047
/*
1048 1049
 * This is an HKDF-like construction for using the hashed collected entropy
 * as a PRF key, that's then expanded block-by-block.
G
Greg Price 已提交
1050
 */
1051
static void extract_entropy(void *buf, size_t nbytes)
L
Linus Torvalds 已提交
1052
{
1053
	unsigned long flags;
1054 1055 1056 1057 1058 1059 1060
	u8 seed[BLAKE2S_HASH_SIZE], next_key[BLAKE2S_HASH_SIZE];
	struct {
		unsigned long rdrand[32 / sizeof(long)];
		size_t counter;
	} block;
	size_t i;

1061
	trace_extract_entropy(nbytes, input_pool.entropy_count);
1062

1063 1064 1065
	for (i = 0; i < ARRAY_SIZE(block.rdrand); ++i) {
		if (!arch_get_random_long(&block.rdrand[i]))
			block.rdrand[i] = random_get_entropy();
1066 1067
	}

1068
	spin_lock_irqsave(&input_pool.lock, flags);
1069

1070 1071
	/* seed = HASHPRF(last_key, entropy_input) */
	blake2s_final(&input_pool.hash, seed);
L
Linus Torvalds 已提交
1072

1073 1074 1075 1076
	/* next_key = HASHPRF(seed, RDRAND || 0) */
	block.counter = 0;
	blake2s(next_key, (u8 *)&block, seed, sizeof(next_key), sizeof(block), sizeof(seed));
	blake2s_init_key(&input_pool.hash, BLAKE2S_HASH_SIZE, next_key, sizeof(next_key));
L
Linus Torvalds 已提交
1077

1078 1079
	spin_unlock_irqrestore(&input_pool.lock, flags);
	memzero_explicit(next_key, sizeof(next_key));
1080 1081

	while (nbytes) {
1082 1083 1084 1085
		i = min_t(size_t, nbytes, BLAKE2S_HASH_SIZE);
		/* output = HASHPRF(seed, RDRAND || ++counter) */
		++block.counter;
		blake2s(buf, (u8 *)&block, seed, i, sizeof(block), sizeof(seed));
1086 1087 1088 1089
		nbytes -= i;
		buf += i;
	}

1090 1091
	memzero_explicit(seed, sizeof(seed));
	memzero_explicit(&block, sizeof(block));
1092 1093
}

1094
#define warn_unseeded_randomness(previous) \
1095
	_warn_unseeded_randomness(__func__, (void *)_RET_IP_, (previous))
1096

1097
static void _warn_unseeded_randomness(const char *func_name, void *caller, void **previous)
1098 1099 1100 1101 1102 1103 1104
{
#ifdef CONFIG_WARN_ALL_UNSEEDED_RANDOM
	const bool print_once = false;
#else
	static bool print_once __read_mostly;
#endif

1105
	if (print_once || crng_ready() ||
1106 1107 1108 1109 1110 1111
	    (previous && (caller == READ_ONCE(*previous))))
		return;
	WRITE_ONCE(*previous, caller);
#ifndef CONFIG_WARN_ALL_UNSEEDED_RANDOM
	print_once = true;
#endif
1112
	if (__ratelimit(&unseeded_warning))
1113 1114
		printk_deferred(KERN_NOTICE "random: %s called from %pS with crng_init=%d\n",
				func_name, caller, crng_init);
1115 1116
}

L
Linus Torvalds 已提交
1117 1118
/*
 * This function is the exported kernel interface.  It returns some
1119
 * number of good random numbers, suitable for key generation, seeding
1120 1121
 * TCP sequence numbers, etc.  It does not rely on the hardware random
 * number generator.  For random bytes direct from the hardware RNG
1122 1123 1124 1125
 * (when available), use get_random_bytes_arch(). In order to ensure
 * that the randomness provided by this function is okay, the function
 * wait_for_random_bytes() should be called and return 0 at least once
 * at any point prior.
L
Linus Torvalds 已提交
1126
 */
1127
static void _get_random_bytes(void *buf, int nbytes)
1128
{
1129
	u8 tmp[CHACHA_BLOCK_SIZE] __aligned(4);
1130

1131
	trace_get_random_bytes(nbytes, _RET_IP_);
1132

1133
	while (nbytes >= CHACHA_BLOCK_SIZE) {
1134
		extract_crng(buf);
1135 1136
		buf += CHACHA_BLOCK_SIZE;
		nbytes -= CHACHA_BLOCK_SIZE;
1137 1138 1139 1140 1141
	}

	if (nbytes > 0) {
		extract_crng(tmp);
		memcpy(buf, tmp, nbytes);
1142 1143
		crng_backtrack_protect(tmp, nbytes);
	} else
1144
		crng_backtrack_protect(tmp, CHACHA_BLOCK_SIZE);
1145
	memzero_explicit(tmp, sizeof(tmp));
1146
}
1147 1148 1149 1150 1151 1152 1153 1154

void get_random_bytes(void *buf, int nbytes)
{
	static void *previous;

	warn_unseeded_randomness(&previous);
	_get_random_bytes(buf, nbytes);
}
1155 1156
EXPORT_SYMBOL(get_random_bytes);

1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171
/*
 * Each time the timer fires, we expect that we got an unpredictable
 * jump in the cycle counter. Even if the timer is running on another
 * CPU, the timer activity will be touching the stack of the CPU that is
 * generating entropy..
 *
 * Note that we don't re-arm the timer in the timer itself - we are
 * happy to be scheduled away, since that just makes the load more
 * complex, but we do not want the timer to keep ticking unless the
 * entropy loop is running.
 *
 * So the re-arming always happens in the entropy loop itself.
 */
static void entropy_timer(struct timer_list *t)
{
1172
	credit_entropy_bits(1);
1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194
}

/*
 * If we have an actual cycle counter, see if we can
 * generate enough entropy with timing noise
 */
static void try_to_generate_entropy(void)
{
	struct {
		unsigned long now;
		struct timer_list timer;
	} stack;

	stack.now = random_get_entropy();

	/* Slow counter - or none. Don't even bother */
	if (stack.now == random_get_entropy())
		return;

	timer_setup_on_stack(&stack.timer, entropy_timer, 0);
	while (!crng_ready()) {
		if (!timer_pending(&stack.timer))
1195
			mod_timer(&stack.timer, jiffies + 1);
1196
		mix_pool_bytes(&stack.now, sizeof(stack.now));
1197 1198 1199 1200 1201 1202
		schedule();
		stack.now = random_get_entropy();
	}

	del_timer_sync(&stack.timer);
	destroy_timer_on_stack(&stack.timer);
1203
	mix_pool_bytes(&stack.now, sizeof(stack.now));
1204 1205
}

1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219
/*
 * Wait for the urandom pool to be seeded and thus guaranteed to supply
 * cryptographically secure random numbers. This applies to: the /dev/urandom
 * device, the get_random_bytes function, and the get_random_{u32,u64,int,long}
 * family of functions. Using any of these functions without first calling
 * this function forfeits the guarantee of security.
 *
 * Returns: 0 if the urandom pool has been seeded.
 *          -ERESTARTSYS if the function was interrupted by a signal.
 */
int wait_for_random_bytes(void)
{
	if (likely(crng_ready()))
		return 0;
1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230

	do {
		int ret;
		ret = wait_event_interruptible_timeout(crng_init_wait, crng_ready(), HZ);
		if (ret)
			return ret > 0 ? 0 : ret;

		try_to_generate_entropy();
	} while (!crng_ready());

	return 0;
1231 1232 1233
}
EXPORT_SYMBOL(wait_for_random_bytes);

1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248
/*
 * Returns whether or not the urandom pool has been seeded and thus guaranteed
 * to supply cryptographically secure random numbers. This applies to: the
 * /dev/urandom device, the get_random_bytes function, and the get_random_{u32,
 * ,u64,int,long} family of functions.
 *
 * Returns: true if the urandom pool has been seeded.
 *          false if the urandom pool has not been seeded.
 */
bool rng_is_initialized(void)
{
	return crng_ready();
}
EXPORT_SYMBOL(rng_is_initialized);

1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262
/*
 * Add a callback function that will be invoked when the nonblocking
 * pool is initialised.
 *
 * returns: 0 if callback is successfully added
 *	    -EALREADY if pool is already initialised (callback not called)
 *	    -ENOENT if module for callback is not alive
 */
int add_random_ready_callback(struct random_ready_callback *rdy)
{
	struct module *owner;
	unsigned long flags;
	int err = -EALREADY;

1263
	if (crng_ready())
1264 1265 1266 1267 1268 1269 1270
		return err;

	owner = rdy->owner;
	if (!try_module_get(owner))
		return -ENOENT;

	spin_lock_irqsave(&random_ready_list_lock, flags);
1271
	if (crng_ready())
1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306
		goto out;

	owner = NULL;

	list_add(&rdy->list, &random_ready_list);
	err = 0;

out:
	spin_unlock_irqrestore(&random_ready_list_lock, flags);

	module_put(owner);

	return err;
}
EXPORT_SYMBOL(add_random_ready_callback);

/*
 * Delete a previously registered readiness callback function.
 */
void del_random_ready_callback(struct random_ready_callback *rdy)
{
	unsigned long flags;
	struct module *owner = NULL;

	spin_lock_irqsave(&random_ready_list_lock, flags);
	if (!list_empty(&rdy->list)) {
		list_del_init(&rdy->list);
		owner = rdy->owner;
	}
	spin_unlock_irqrestore(&random_ready_list_lock, flags);

	module_put(owner);
}
EXPORT_SYMBOL(del_random_ready_callback);

1307 1308 1309 1310 1311 1312 1313 1314 1315
/*
 * This function will use the architecture-specific hardware random
 * number generator if it is available.  The arch-specific hw RNG will
 * almost certainly be faster than what we can do in software, but it
 * is impossible to verify that it is implemented securely (as
 * opposed, to, say, the AES encryption of a sequence number using a
 * key known by the NSA).  So it's useful if we need the speed, but
 * only if we're willing to trust the hardware manufacturer not to
 * have put in a back door.
1316 1317
 *
 * Return number of bytes filled in.
1318
 */
1319
int __must_check get_random_bytes_arch(void *buf, int nbytes)
L
Linus Torvalds 已提交
1320
{
1321
	int left = nbytes;
1322
	u8 *p = buf;
1323

1324 1325
	trace_get_random_bytes_arch(left, _RET_IP_);
	while (left) {
1326
		unsigned long v;
1327
		int chunk = min_t(int, left, sizeof(unsigned long));
1328

1329 1330
		if (!arch_get_random_long(&v))
			break;
1331

L
Luck, Tony 已提交
1332
		memcpy(p, &v, chunk);
1333
		p += chunk;
1334
		left -= chunk;
1335 1336
	}

1337
	return nbytes - left;
L
Linus Torvalds 已提交
1338
}
1339 1340
EXPORT_SYMBOL(get_random_bytes_arch);

L
Linus Torvalds 已提交
1341 1342 1343 1344 1345 1346 1347
/*
 * init_std_data - initialize pool with system data
 *
 * This function clears the pool's entropy count and mixes some system
 * data into the pool to prepare it for use. The pool is not cleared
 * as that can only decrease the entropy in the pool.
 */
1348
static void __init init_std_data(void)
L
Linus Torvalds 已提交
1349
{
1350
	int i;
1351 1352
	ktime_t now = ktime_get_real();
	unsigned long rv;
L
Linus Torvalds 已提交
1353

1354
	mix_pool_bytes(&now, sizeof(now));
1355
	for (i = BLAKE2S_BLOCK_SIZE; i > 0; i -= sizeof(rv)) {
1356 1357
		if (!arch_get_random_seed_long(&rv) &&
		    !arch_get_random_long(&rv))
1358
			rv = random_get_entropy();
1359
		mix_pool_bytes(&rv, sizeof(rv));
1360
	}
1361
	mix_pool_bytes(utsname(), sizeof(*(utsname())));
L
Linus Torvalds 已提交
1362 1363
}

1364 1365 1366 1367 1368 1369 1370 1371 1372 1373
/*
 * Note that setup_arch() may call add_device_randomness()
 * long before we get here. This allows seeding of the pools
 * with some platform dependent data very early in the boot
 * process. But it limits our options here. We must use
 * statically allocated structures that already have all
 * initializations complete at compile time. We should also
 * take care not to overwrite the precious per platform data
 * we were given.
 */
1374
int __init rand_initialize(void)
L
Linus Torvalds 已提交
1375
{
1376
	init_std_data();
1377
	if (crng_need_final_init)
1378
		crng_finalize_init();
1379
	crng_initialize_primary();
1380
	crng_global_init_time = jiffies;
1381 1382 1383 1384
	if (ratelimit_disable) {
		urandom_warning.interval = 0;
		unseeded_warning.interval = 0;
	}
L
Linus Torvalds 已提交
1385 1386 1387
	return 0;
}

1388
#ifdef CONFIG_BLOCK
L
Linus Torvalds 已提交
1389 1390 1391 1392 1393
void rand_initialize_disk(struct gendisk *disk)
{
	struct timer_rand_state *state;

	/*
1394
	 * If kzalloc returns null, we just won't use that entropy
L
Linus Torvalds 已提交
1395 1396
	 * source.
	 */
1397
	state = kzalloc(sizeof(struct timer_rand_state), GFP_KERNEL);
1398 1399
	if (state) {
		state->last_time = INITIAL_JIFFIES;
L
Linus Torvalds 已提交
1400
		disk->random = state;
1401
	}
L
Linus Torvalds 已提交
1402
}
1403
#endif
L
Linus Torvalds 已提交
1404

1405 1406
static ssize_t urandom_read_nowarn(struct file *file, char __user *buf,
				   size_t nbytes, loff_t *ppos)
1407 1408 1409
{
	int ret;

1410
	nbytes = min_t(size_t, nbytes, INT_MAX >> 6);
1411
	ret = extract_crng_user(buf, nbytes);
1412
	trace_urandom_read(8 * nbytes, 0, input_pool.entropy_count);
1413 1414 1415
	return ret;
}

1416 1417
static ssize_t urandom_read(struct file *file, char __user *buf, size_t nbytes,
			    loff_t *ppos)
L
Linus Torvalds 已提交
1418
{
1419
	static int maxwarn = 10;
1420

1421
	if (!crng_ready() && maxwarn > 0) {
1422
		maxwarn--;
1423
		if (__ratelimit(&urandom_warning))
Y
Yangtao Li 已提交
1424 1425
			pr_notice("%s: uninitialized urandom read (%zd bytes read)\n",
				  current->comm, nbytes);
1426
	}
1427 1428

	return urandom_read_nowarn(file, buf, nbytes, ppos);
L
Linus Torvalds 已提交
1429 1430
}

1431 1432
static ssize_t random_read(struct file *file, char __user *buf, size_t nbytes,
			   loff_t *ppos)
1433 1434 1435 1436 1437 1438 1439 1440 1441
{
	int ret;

	ret = wait_for_random_bytes();
	if (ret != 0)
		return ret;
	return urandom_read_nowarn(file, buf, nbytes, ppos);
}

1442
static __poll_t random_poll(struct file *file, poll_table *wait)
L
Linus Torvalds 已提交
1443
{
1444
	__poll_t mask;
L
Linus Torvalds 已提交
1445

1446
	poll_wait(file, &crng_init_wait, wait);
1447 1448
	poll_wait(file, &random_write_wait, wait);
	mask = 0;
1449
	if (crng_ready())
1450
		mask |= EPOLLIN | EPOLLRDNORM;
1451
	if (input_pool.entropy_count < POOL_MIN_BITS)
1452
		mask |= EPOLLOUT | EPOLLWRNORM;
L
Linus Torvalds 已提交
1453 1454 1455
	return mask;
}

1456
static int write_pool(const char __user *buffer, size_t count)
L
Linus Torvalds 已提交
1457 1458
{
	size_t bytes;
1459
	u32 t, buf[16];
L
Linus Torvalds 已提交
1460 1461
	const char __user *p = buffer;

1462
	while (count > 0) {
1463 1464
		int b, i = 0;

1465 1466 1467
		bytes = min(count, sizeof(buf));
		if (copy_from_user(&buf, p, bytes))
			return -EFAULT;
L
Linus Torvalds 已提交
1468

1469
		for (b = bytes; b > 0; b -= sizeof(u32), i++) {
1470 1471 1472 1473 1474
			if (!arch_get_random_int(&t))
				break;
			buf[i] ^= t;
		}

1475
		count -= bytes;
L
Linus Torvalds 已提交
1476 1477
		p += bytes;

1478
		mix_pool_bytes(buf, bytes);
1479
		cond_resched();
L
Linus Torvalds 已提交
1480
	}
1481 1482 1483 1484

	return 0;
}

1485 1486
static ssize_t random_write(struct file *file, const char __user *buffer,
			    size_t count, loff_t *ppos)
1487 1488 1489
{
	size_t ret;

1490
	ret = write_pool(buffer, count);
1491 1492 1493 1494
	if (ret)
		return ret;

	return (ssize_t)count;
L
Linus Torvalds 已提交
1495 1496
}

M
Matt Mackall 已提交
1497
static long random_ioctl(struct file *f, unsigned int cmd, unsigned long arg)
L
Linus Torvalds 已提交
1498 1499 1500 1501 1502 1503 1504
{
	int size, ent_count;
	int __user *p = (int __user *)arg;
	int retval;

	switch (cmd) {
	case RNDGETENTCNT:
M
Matt Mackall 已提交
1505
		/* inherently racy, no point locking */
1506
		if (put_user(input_pool.entropy_count, p))
L
Linus Torvalds 已提交
1507 1508 1509 1510 1511 1512 1513
			return -EFAULT;
		return 0;
	case RNDADDTOENTCNT:
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
		if (get_user(ent_count, p))
			return -EFAULT;
1514 1515 1516 1517
		if (ent_count < 0)
			return -EINVAL;
		credit_entropy_bits(ent_count);
		return 0;
L
Linus Torvalds 已提交
1518 1519 1520 1521 1522 1523 1524 1525 1526
	case RNDADDENTROPY:
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
		if (get_user(ent_count, p++))
			return -EFAULT;
		if (ent_count < 0)
			return -EINVAL;
		if (get_user(size, p++))
			return -EFAULT;
1527
		retval = write_pool((const char __user *)p, size);
L
Linus Torvalds 已提交
1528 1529
		if (retval < 0)
			return retval;
1530 1531
		credit_entropy_bits(ent_count);
		return 0;
L
Linus Torvalds 已提交
1532 1533
	case RNDZAPENTCNT:
	case RNDCLEARPOOL:
1534 1535 1536 1537
		/*
		 * Clear the entropy pool counters. We no longer clear
		 * the entropy pool, as that's silly.
		 */
L
Linus Torvalds 已提交
1538 1539
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
1540
		if (xchg(&input_pool.entropy_count, 0)) {
1541 1542 1543
			wake_up_interruptible(&random_write_wait);
			kill_fasync(&fasync, SIGIO, POLL_OUT);
		}
L
Linus Torvalds 已提交
1544
		return 0;
1545 1546 1547 1548 1549
	case RNDRESEEDCRNG:
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
		if (crng_init < 2)
			return -ENODATA;
1550
		crng_reseed(&primary_crng, true);
1551
		WRITE_ONCE(crng_global_init_time, jiffies - 1);
1552
		return 0;
L
Linus Torvalds 已提交
1553 1554 1555 1556 1557
	default:
		return -EINVAL;
	}
}

1558 1559 1560 1561 1562
static int random_fasync(int fd, struct file *filp, int on)
{
	return fasync_helper(fd, filp, on, &fasync);
}

1563
const struct file_operations random_fops = {
1564
	.read = random_read,
L
Linus Torvalds 已提交
1565
	.write = random_write,
1566
	.poll = random_poll,
M
Matt Mackall 已提交
1567
	.unlocked_ioctl = random_ioctl,
1568
	.compat_ioctl = compat_ptr_ioctl,
1569
	.fasync = random_fasync,
1570
	.llseek = noop_llseek,
L
Linus Torvalds 已提交
1571 1572
};

1573
const struct file_operations urandom_fops = {
1574
	.read = urandom_read,
L
Linus Torvalds 已提交
1575
	.write = random_write,
M
Matt Mackall 已提交
1576
	.unlocked_ioctl = random_ioctl,
1577
	.compat_ioctl = compat_ptr_ioctl,
1578
	.fasync = random_fasync,
1579
	.llseek = noop_llseek,
L
Linus Torvalds 已提交
1580 1581
};

1582 1583
SYSCALL_DEFINE3(getrandom, char __user *, buf, size_t, count, unsigned int,
		flags)
1584
{
1585 1586
	int ret;

1587
	if (flags & ~(GRND_NONBLOCK | GRND_RANDOM | GRND_INSECURE))
1588 1589 1590 1591 1592 1593
		return -EINVAL;

	/*
	 * Requesting insecure and blocking randomness at the same time makes
	 * no sense.
	 */
1594
	if ((flags & (GRND_INSECURE | GRND_RANDOM)) == (GRND_INSECURE | GRND_RANDOM))
1595 1596 1597 1598 1599
		return -EINVAL;

	if (count > INT_MAX)
		count = INT_MAX;

1600
	if (!(flags & GRND_INSECURE) && !crng_ready()) {
1601 1602
		if (flags & GRND_NONBLOCK)
			return -EAGAIN;
1603 1604 1605
		ret = wait_for_random_bytes();
		if (unlikely(ret))
			return ret;
1606
	}
1607
	return urandom_read_nowarn(NULL, buf, count, NULL);
1608 1609
}

L
Linus Torvalds 已提交
1610 1611 1612 1613 1614 1615 1616 1617 1618 1619
/********************************************************************
 *
 * Sysctl interface
 *
 ********************************************************************/

#ifdef CONFIG_SYSCTL

#include <linux/sysctl.h>

1620
static int random_min_urandom_seed = 60;
1621 1622
static int random_write_wakeup_bits = POOL_MIN_BITS;
static int sysctl_poolsize = POOL_BITS;
L
Linus Torvalds 已提交
1623 1624 1625
static char sysctl_bootid[16];

/*
G
Greg Price 已提交
1626
 * This function is used to return both the bootid UUID, and random
L
Linus Torvalds 已提交
1627 1628 1629
 * UUID.  The difference is in whether table->data is NULL; if it is,
 * then a new UUID is generated and returned to the user.
 *
G
Greg Price 已提交
1630 1631 1632
 * If the user accesses this via the proc interface, the UUID will be
 * returned as an ASCII string in the standard UUID format; if via the
 * sysctl system call, as 16 bytes of binary data.
L
Linus Torvalds 已提交
1633
 */
1634 1635
static int proc_do_uuid(struct ctl_table *table, int write, void *buffer,
			size_t *lenp, loff_t *ppos)
L
Linus Torvalds 已提交
1636
{
1637
	struct ctl_table fake_table;
L
Linus Torvalds 已提交
1638 1639 1640 1641 1642 1643
	unsigned char buf[64], tmp_uuid[16], *uuid;

	uuid = table->data;
	if (!uuid) {
		uuid = tmp_uuid;
		generate_random_uuid(uuid);
1644 1645 1646 1647 1648 1649 1650 1651
	} else {
		static DEFINE_SPINLOCK(bootid_spinlock);

		spin_lock(&bootid_spinlock);
		if (!uuid[8])
			generate_random_uuid(uuid);
		spin_unlock(&bootid_spinlock);
	}
L
Linus Torvalds 已提交
1652

J
Joe Perches 已提交
1653 1654
	sprintf(buf, "%pU", uuid);

L
Linus Torvalds 已提交
1655 1656 1657
	fake_table.data = buf;
	fake_table.maxlen = sizeof(buf);

1658
	return proc_dostring(&fake_table, write, buffer, lenp, ppos);
L
Linus Torvalds 已提交
1659 1660
}

1661
static struct ctl_table random_table[] = {
L
Linus Torvalds 已提交
1662 1663 1664 1665 1666
	{
		.procname	= "poolsize",
		.data		= &sysctl_poolsize,
		.maxlen		= sizeof(int),
		.mode		= 0444,
1667
		.proc_handler	= proc_dointvec,
L
Linus Torvalds 已提交
1668 1669 1670
	},
	{
		.procname	= "entropy_avail",
1671
		.data		= &input_pool.entropy_count,
L
Linus Torvalds 已提交
1672 1673
		.maxlen		= sizeof(int),
		.mode		= 0444,
1674
		.proc_handler	= proc_dointvec,
L
Linus Torvalds 已提交
1675 1676 1677
	},
	{
		.procname	= "write_wakeup_threshold",
1678
		.data		= &random_write_wakeup_bits,
L
Linus Torvalds 已提交
1679 1680
		.maxlen		= sizeof(int),
		.mode		= 0644,
1681
		.proc_handler	= proc_dointvec,
L
Linus Torvalds 已提交
1682
	},
1683 1684 1685 1686 1687 1688 1689
	{
		.procname	= "urandom_min_reseed_secs",
		.data		= &random_min_urandom_seed,
		.maxlen		= sizeof(int),
		.mode		= 0644,
		.proc_handler	= proc_dointvec,
	},
L
Linus Torvalds 已提交
1690 1691 1692 1693 1694
	{
		.procname	= "boot_id",
		.data		= &sysctl_bootid,
		.maxlen		= 16,
		.mode		= 0444,
1695
		.proc_handler	= proc_do_uuid,
L
Linus Torvalds 已提交
1696 1697 1698 1699 1700
	},
	{
		.procname	= "uuid",
		.maxlen		= 16,
		.mode		= 0444,
1701
		.proc_handler	= proc_do_uuid,
L
Linus Torvalds 已提交
1702
	},
1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718
#ifdef ADD_INTERRUPT_BENCH
	{
		.procname	= "add_interrupt_avg_cycles",
		.data		= &avg_cycles,
		.maxlen		= sizeof(avg_cycles),
		.mode		= 0444,
		.proc_handler	= proc_doulongvec_minmax,
	},
	{
		.procname	= "add_interrupt_avg_deviation",
		.data		= &avg_deviation,
		.maxlen		= sizeof(avg_deviation),
		.mode		= 0444,
		.proc_handler	= proc_doulongvec_minmax,
	},
#endif
1719
	{ }
L
Linus Torvalds 已提交
1720
};
1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731

/*
 * rand_initialize() is called before sysctl_init(),
 * so we cannot call register_sysctl_init() in rand_initialize()
 */
static int __init random_sysctls_init(void)
{
	register_sysctl_init("kernel/random", random_table);
	return 0;
}
device_initcall(random_sysctls_init);
1732
#endif	/* CONFIG_SYSCTL */
L
Linus Torvalds 已提交
1733

1734 1735
struct batched_entropy {
	union {
1736 1737
		u64 entropy_u64[CHACHA_BLOCK_SIZE / sizeof(u64)];
		u32 entropy_u32[CHACHA_BLOCK_SIZE / sizeof(u32)];
1738 1739
	};
	unsigned int position;
1740
	spinlock_t batch_lock;
1741
};
1742

L
Linus Torvalds 已提交
1743
/*
1744
 * Get a random word for internal kernel use only. The quality of the random
1745 1746
 * number is good as /dev/urandom, but there is no backtrack protection, with
 * the goal of being quite fast and not depleting entropy. In order to ensure
1747
 * that the randomness provided by this function is okay, the function
1748 1749
 * wait_for_random_bytes() should be called and return 0 at least once at any
 * point prior.
L
Linus Torvalds 已提交
1750
 */
1751
static DEFINE_PER_CPU(struct batched_entropy, batched_entropy_u64) = {
1752
	.batch_lock = __SPIN_LOCK_UNLOCKED(batched_entropy_u64.lock),
1753 1754
};

1755
u64 get_random_u64(void)
L
Linus Torvalds 已提交
1756
{
1757
	u64 ret;
1758
	unsigned long flags;
1759
	struct batched_entropy *batch;
1760
	static void *previous;
1761

1762
	warn_unseeded_randomness(&previous);
1763

1764 1765
	batch = raw_cpu_ptr(&batched_entropy_u64);
	spin_lock_irqsave(&batch->batch_lock, flags);
1766
	if (batch->position % ARRAY_SIZE(batch->entropy_u64) == 0) {
1767
		extract_crng((u8 *)batch->entropy_u64);
1768 1769
		batch->position = 0;
	}
1770
	ret = batch->entropy_u64[batch->position++];
1771
	spin_unlock_irqrestore(&batch->batch_lock, flags);
1772
	return ret;
L
Linus Torvalds 已提交
1773
}
1774
EXPORT_SYMBOL(get_random_u64);
L
Linus Torvalds 已提交
1775

1776
static DEFINE_PER_CPU(struct batched_entropy, batched_entropy_u32) = {
1777
	.batch_lock = __SPIN_LOCK_UNLOCKED(batched_entropy_u32.lock),
1778
};
1779
u32 get_random_u32(void)
1780
{
1781
	u32 ret;
1782
	unsigned long flags;
1783
	struct batched_entropy *batch;
1784
	static void *previous;
1785

1786
	warn_unseeded_randomness(&previous);
1787

1788 1789
	batch = raw_cpu_ptr(&batched_entropy_u32);
	spin_lock_irqsave(&batch->batch_lock, flags);
1790
	if (batch->position % ARRAY_SIZE(batch->entropy_u32) == 0) {
1791
		extract_crng((u8 *)batch->entropy_u32);
1792 1793
		batch->position = 0;
	}
1794
	ret = batch->entropy_u32[batch->position++];
1795
	spin_unlock_irqrestore(&batch->batch_lock, flags);
1796 1797
	return ret;
}
1798
EXPORT_SYMBOL(get_random_u32);
1799

1800 1801 1802 1803 1804 1805 1806 1807 1808
/* It's important to invalidate all potential batched entropy that might
 * be stored before the crng is initialized, which we can do lazily by
 * simply resetting the counter to zero so that it's re-extracted on the
 * next usage. */
static void invalidate_batched_entropy(void)
{
	int cpu;
	unsigned long flags;

1809
	for_each_possible_cpu(cpu) {
1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820
		struct batched_entropy *batched_entropy;

		batched_entropy = per_cpu_ptr(&batched_entropy_u32, cpu);
		spin_lock_irqsave(&batched_entropy->batch_lock, flags);
		batched_entropy->position = 0;
		spin_unlock(&batched_entropy->batch_lock);

		batched_entropy = per_cpu_ptr(&batched_entropy_u64, cpu);
		spin_lock(&batched_entropy->batch_lock);
		batched_entropy->position = 0;
		spin_unlock_irqrestore(&batched_entropy->batch_lock, flags);
1821 1822 1823
	}
}

1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837
/**
 * randomize_page - Generate a random, page aligned address
 * @start:	The smallest acceptable address the caller will take.
 * @range:	The size of the area, starting at @start, within which the
 *		random address must fall.
 *
 * If @start + @range would overflow, @range is capped.
 *
 * NOTE: Historical use of randomize_range, which this replaces, presumed that
 * @start was already page aligned.  We now align it regardless.
 *
 * Return: A page aligned address within [start, start + range).  On error,
 * @start is returned.
 */
1838
unsigned long randomize_page(unsigned long start, unsigned long range)
1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855
{
	if (!PAGE_ALIGNED(start)) {
		range -= PAGE_ALIGN(start) - start;
		start = PAGE_ALIGN(start);
	}

	if (start > ULONG_MAX - range)
		range = ULONG_MAX - start;

	range >>= PAGE_SHIFT;

	if (range == 0)
		return start;

	return start + (get_random_long() % range << PAGE_SHIFT);
}

1856 1857 1858 1859 1860 1861 1862
/* Interface for in-kernel drivers of true hardware RNGs.
 * Those devices may produce endless random bits and will be throttled
 * when our pool is full.
 */
void add_hwgenerator_randomness(const char *buffer, size_t count,
				size_t entropy)
{
T
Theodore Ts'o 已提交
1863
	if (unlikely(crng_init == 0)) {
1864
		size_t ret = crng_fast_load(buffer, count);
1865
		mix_pool_bytes(buffer, ret);
1866 1867 1868 1869
		count -= ret;
		buffer += ret;
		if (!count || crng_init == 0)
			return;
1870
	}
1871

1872
	/* Throttle writing if we're above the trickle threshold.
1873 1874 1875
	 * We'll be woken up again once below POOL_MIN_BITS, when
	 * the calling thread is about to terminate, or once
	 * CRNG_RESEED_INTERVAL has elapsed.
1876
	 */
1877
	wait_event_interruptible_timeout(random_write_wait,
1878
			!system_wq || kthread_should_stop() ||
1879
			input_pool.entropy_count < POOL_MIN_BITS,
1880
			CRNG_RESEED_INTERVAL);
1881 1882
	mix_pool_bytes(buffer, count);
	credit_entropy_bits(entropy);
1883 1884
}
EXPORT_SYMBOL_GPL(add_hwgenerator_randomness);
H
Hsin-Yi Wang 已提交
1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897

/* Handle random seed passed by bootloader.
 * If the seed is trustworthy, it would be regarded as hardware RNGs. Otherwise
 * it would be regarded as device data.
 * The decision is controlled by CONFIG_RANDOM_TRUST_BOOTLOADER.
 */
void add_bootloader_randomness(const void *buf, unsigned int size)
{
	if (IS_ENABLED(CONFIG_RANDOM_TRUST_BOOTLOADER))
		add_hwgenerator_randomness(buf, size, size * 8);
	else
		add_device_randomness(buf, size);
}
1898
EXPORT_SYMBOL_GPL(add_bootloader_randomness);