random.c 50.6 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
 * Exported interfaces ---- kernel output
 * --------------------------------------
 *
70
 * The primary kernel interfaces are:
71
 *
72 73 74 75 76
 *	void get_random_bytes(void *buf, int nbytes);
 *	u32 get_random_u32()
 *	u64 get_random_u64()
 *	unsigned int get_random_int()
 *	unsigned long get_random_long()
77
 *
78 79 80 81 82
 * These interfaces will return the requested number of random bytes
 * into the given buffer or as a return value. This is equivalent to a
 * read from /dev/urandom. The get_random_{u32,u64,int,long}() family
 * of functions may be higher performance for one-off random integers,
 * because they do a bit of buffering.
83 84 85 86 87 88 89 90 91 92 93
 *
 * 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 已提交
94 95 96 97 98 99
 * Exported interfaces ---- input
 * ==============================
 *
 * The current exported interfaces for gathering environmental noise
 * from the devices are:
 *
100
 *	void add_device_randomness(const void *buf, unsigned int size);
101
 *	void add_input_randomness(unsigned int type, unsigned int code,
L
Linus Torvalds 已提交
102
 *                                unsigned int value);
103
 *	void add_interrupt_randomness(int irq);
104
 *	void add_disk_randomness(struct gendisk *disk);
105 106 107
 *	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 已提交
108
 *
109 110 111 112 113 114 115 116
 * 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 已提交
117 118 119
 * add_input_randomness() uses the input layer interrupt timing, as well as
 * the event type information from the hardware.
 *
120 121 122
 * 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.
123 124 125 126 127 128
 *
 * 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 已提交
129 130 131 132 133
 *
 * 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.
 *
134 135 136 137 138 139 140 141
 * 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 已提交
142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199
 * 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:
 *
200 201
 *	mknod /dev/random c 1 8
 *	mknod /dev/urandom c 1 9
L
Linus Torvalds 已提交
202 203
 */

Y
Yangtao Li 已提交
204 205
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

L
Linus Torvalds 已提交
206 207 208 209 210 211 212 213 214 215 216 217 218
#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>
219
#include <linux/mm.h>
220
#include <linux/nodemask.h>
L
Linus Torvalds 已提交
221
#include <linux/spinlock.h>
222
#include <linux/kthread.h>
L
Linus Torvalds 已提交
223
#include <linux/percpu.h>
224
#include <linux/ptrace.h>
225
#include <linux/workqueue.h>
226
#include <linux/irq.h>
227
#include <linux/ratelimit.h>
228 229
#include <linux/syscalls.h>
#include <linux/completion.h>
230
#include <linux/uuid.h>
231
#include <crypto/chacha.h>
232
#include <crypto/blake2s.h>
233

L
Linus Torvalds 已提交
234
#include <asm/processor.h>
235
#include <linux/uaccess.h>
L
Linus Torvalds 已提交
236
#include <asm/irq.h>
237
#include <asm/irq_regs.h>
L
Linus Torvalds 已提交
238 239
#include <asm/io.h>

240 241 242
#define CREATE_TRACE_POINTS
#include <trace/events/random.h>

243 244
/* #define ADD_INTERRUPT_BENCH */

245
enum {
246
	POOL_BITS = BLAKE2S_HASH_SIZE * 8,
247
	POOL_MIN_BITS = POOL_BITS /* No point in settling for less. */
L
Linus Torvalds 已提交
248 249 250 251 252
};

/*
 * Static global variables
 */
253
static DECLARE_WAIT_QUEUE_HEAD(random_write_wait);
254
static struct fasync_struct *fasync;
L
Linus Torvalds 已提交
255

256 257 258
static DEFINE_SPINLOCK(random_ready_list_lock);
static LIST_HEAD(random_ready_list);

259 260 261 262 263 264 265 266 267
/*
 * 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;
T
Theodore Ts'o 已提交
268
#define crng_ready() (likely(crng_init > 1))
269 270
static int crng_init_cnt = 0;
static void process_random_ready_list(void);
271
static void _get_random_bytes(void *buf, int nbytes);
272

273 274 275 276 277 278 279 280 281 282
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 已提交
283 284 285 286 287 288 289
/**********************************************************************
 *
 * OS independent entropy store.   Here are the functions which handle
 * storing entropy in an entropy pool.
 *
 **********************************************************************/

290
static struct {
291
	struct blake2s_state hash;
292
	spinlock_t lock;
293
	int entropy_count;
294
} input_pool = {
295 296 297 298
	.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,
299
	.lock = __SPIN_LOCK_UNLOCKED(input_pool.lock),
L
Linus Torvalds 已提交
300 301
};

302
static void extract_entropy(void *buf, size_t nbytes);
303

304
static void crng_reseed(void);
305

L
Linus Torvalds 已提交
306
/*
307
 * This function adds bytes into the entropy "pool".  It does not
L
Linus Torvalds 已提交
308
 * update the entropy estimate.  The caller should call
309
 * credit_entropy_bits if this is appropriate.
L
Linus Torvalds 已提交
310
 */
311
static void _mix_pool_bytes(const void *in, int nbytes)
L
Linus Torvalds 已提交
312
{
313
	blake2s_update(&input_pool.hash, in, nbytes);
L
Linus Torvalds 已提交
314 315
}

316
static void __mix_pool_bytes(const void *in, int nbytes)
317
{
318 319
	trace_mix_pool_bytes_nolock(nbytes, _RET_IP_);
	_mix_pool_bytes(in, nbytes);
320 321
}

322
static void mix_pool_bytes(const void *in, int nbytes)
L
Linus Torvalds 已提交
323
{
324 325
	unsigned long flags;

326 327 328 329
	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 已提交
330 331
}

332
struct fast_pool {
333 334 335 336
	u32 pool[4];
	unsigned long last;
	u16 reg_idx;
	u8 count;
337 338 339 340 341 342 343
};

/*
 * 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.
 */
344
static void fast_mix(struct fast_pool *f)
345
{
346 347
	u32 a = f->pool[0],	b = f->pool[1];
	u32 c = f->pool[2],	d = f->pool[3];
348 349

	a += b;			c += d;
G
George Spelvin 已提交
350
	b = rol32(b, 6);	d = rol32(d, 27);
351 352 353
	d ^= a;			b ^= c;

	a += b;			c += d;
G
George Spelvin 已提交
354
	b = rol32(b, 16);	d = rol32(d, 14);
355 356 357
	d ^= a;			b ^= c;

	a += b;			c += d;
G
George Spelvin 已提交
358
	b = rol32(b, 6);	d = rol32(d, 27);
359 360 361
	d ^= a;			b ^= c;

	a += b;			c += d;
G
George Spelvin 已提交
362
	b = rol32(b, 16);	d = rol32(d, 14);
363 364 365 366
	d ^= a;			b ^= c;

	f->pool[0] = a;  f->pool[1] = b;
	f->pool[2] = c;  f->pool[3] = d;
367
	f->count++;
368 369
}

370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385
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);
}

386
static void credit_entropy_bits(int nbits)
L
Linus Torvalds 已提交
387
{
388
	int entropy_count, orig;
389

390
	if (nbits <= 0)
391 392
		return;

393 394
	nbits = min(nbits, POOL_BITS);

395 396 397 398
	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 已提交
399

400
	trace_credit_entropy_bits(nbits, entropy_count, _RET_IP_);
401

402
	if (crng_init < 2 && entropy_count >= POOL_MIN_BITS)
403
		crng_reseed();
L
Linus Torvalds 已提交
404 405
}

406 407 408 409 410 411
/*********************************************************************
 *
 * CRNG using CHACHA20
 *
 *********************************************************************/

412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435
enum {
	CRNG_RESEED_INTERVAL = 300 * HZ,
	CRNG_INIT_CNT_THRESH = 2 * CHACHA_KEY_SIZE
};

static struct {
	u8 key[CHACHA_KEY_SIZE] __aligned(__alignof__(long));
	unsigned long birth;
	unsigned long generation;
	spinlock_t lock;
} base_crng = {
	.lock = __SPIN_LOCK_UNLOCKED(base_crng.lock)
};

struct crng {
	u8 key[CHACHA_KEY_SIZE];
	unsigned long generation;
	local_lock_t lock;
};

static DEFINE_PER_CPU(struct crng, crngs) = {
	.generation = ULONG_MAX,
	.lock = INIT_LOCAL_LOCK(crngs.lock),
};
436 437 438

static DECLARE_WAIT_QUEUE_HEAD(crng_init_wait);

439 440
static void invalidate_batched_entropy(void);

441 442
/*
 * crng_fast_load() can be called by code in the interrupt service
443 444
 * path.  So we can't afford to dilly-dally. Returns the number of
 * bytes processed from cp.
445
 */
446
static size_t crng_fast_load(const u8 *cp, size_t len)
447 448
{
	unsigned long flags;
449
	u8 *p;
450
	size_t ret = 0;
451

452
	if (!spin_trylock_irqsave(&base_crng.lock, flags))
453
		return 0;
T
Theodore Ts'o 已提交
454
	if (crng_init != 0) {
455
		spin_unlock_irqrestore(&base_crng.lock, flags);
456 457
		return 0;
	}
458
	p = base_crng.key;
459
	while (len > 0 && crng_init_cnt < CRNG_INIT_CNT_THRESH) {
460
		p[crng_init_cnt % sizeof(base_crng.key)] ^= *cp;
461
		cp++; crng_init_cnt++; len--; ret++;
462 463
	}
	if (crng_init_cnt >= CRNG_INIT_CNT_THRESH) {
464
		invalidate_batched_entropy();
465 466
		crng_init = 1;
	}
467
	spin_unlock_irqrestore(&base_crng.lock, flags);
468 469
	if (crng_init == 1)
		pr_notice("fast init done\n");
470
	return ret;
471 472
}

473 474 475 476 477 478 479 480 481 482 483 484 485 486
/*
 * 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.
 */
487
static int crng_slow_load(const u8 *cp, size_t len)
488
{
489 490 491
	unsigned long flags;
	static u8 lfsr = 1;
	u8 tmp;
492
	unsigned int i, max = sizeof(base_crng.key);
493
	const u8 *src_buf = cp;
494
	u8 *dest_buf = base_crng.key;
495

496
	if (!spin_trylock_irqsave(&base_crng.lock, flags))
497 498
		return 0;
	if (crng_init != 0) {
499
		spin_unlock_irqrestore(&base_crng.lock, flags);
500 501 502 503 504
		return 0;
	}
	if (len > max)
		max = len;

505
	for (i = 0; i < max; i++) {
506 507 508 509
		tmp = lfsr;
		lfsr >>= 1;
		if (tmp & 1)
			lfsr ^= 0xE1;
510 511
		tmp = dest_buf[i % sizeof(base_crng.key)];
		dest_buf[i % sizeof(base_crng.key)] ^= src_buf[i % len] ^ lfsr;
512 513
		lfsr += (tmp << 3) | (tmp >> 5);
	}
514
	spin_unlock_irqrestore(&base_crng.lock, flags);
515 516 517
	return 1;
}

518
static void crng_reseed(void)
519
{
520
	unsigned long flags;
521 522 523
	int entropy_count;
	unsigned long next_gen;
	u8 key[CHACHA_KEY_SIZE];
524

525 526 527 528
	/*
	 * First we make sure we have POOL_MIN_BITS of entropy in the pool,
	 * and then we drain all of it. Only then can we extract a new key.
	 */
529 530 531 532 533
	do {
		entropy_count = READ_ONCE(input_pool.entropy_count);
		if (entropy_count < POOL_MIN_BITS)
			return;
	} while (cmpxchg(&input_pool.entropy_count, entropy_count, 0) != entropy_count);
534
	extract_entropy(key, sizeof(key));
535 536 537
	wake_up_interruptible(&random_write_wait);
	kill_fasync(&fasync, SIGIO, POLL_OUT);

538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553
	/*
	 * We copy the new key into the base_crng, overwriting the old one,
	 * and update the generation counter. We avoid hitting ULONG_MAX,
	 * because the per-cpu crngs are initialized to ULONG_MAX, so this
	 * forces new CPUs that come online to always initialize.
	 */
	spin_lock_irqsave(&base_crng.lock, flags);
	memcpy(base_crng.key, key, sizeof(base_crng.key));
	next_gen = base_crng.generation + 1;
	if (next_gen == ULONG_MAX)
		++next_gen;
	WRITE_ONCE(base_crng.generation, next_gen);
	WRITE_ONCE(base_crng.birth, jiffies);
	spin_unlock_irqrestore(&base_crng.lock, flags);
	memzero_explicit(key, sizeof(key));

554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571
	if (crng_init < 2) {
		invalidate_batched_entropy();
		crng_init = 2;
		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;
		}
	}
572 573
}

574 575 576 577 578 579 580 581 582 583 584 585
/*
 * The general form here is based on a "fast key erasure RNG" from
 * <https://blog.cr.yp.to/20170723-random.html>. It generates a ChaCha
 * block using the provided key, and then immediately overwites that
 * key with half the block. It returns the resultant ChaCha state to the
 * user, along with the second half of the block containing 32 bytes of
 * random data that may be used; random_data_len may not be greater than
 * 32.
 */
static void crng_fast_key_erasure(u8 key[CHACHA_KEY_SIZE],
				  u32 chacha_state[CHACHA_STATE_WORDS],
				  u8 *random_data, size_t random_data_len)
586
{
587
	u8 first_block[CHACHA_BLOCK_SIZE];
588

589 590 591 592 593 594 595 596 597 598
	BUG_ON(random_data_len > 32);

	chacha_init_consts(chacha_state);
	memcpy(&chacha_state[4], key, CHACHA_KEY_SIZE);
	memset(&chacha_state[12], 0, sizeof(u32) * 4);
	chacha20_block(chacha_state, first_block);

	memcpy(key, first_block, CHACHA_KEY_SIZE);
	memcpy(random_data, first_block + CHACHA_KEY_SIZE, random_data_len);
	memzero_explicit(first_block, sizeof(first_block));
599 600
}

601
/*
602 603 604
 * This function returns a ChaCha state that you may use for generating
 * random data. It also returns up to 32 bytes on its own of random data
 * that may be used; random_data_len may not be greater than 32.
605
 */
606 607
static void crng_make_state(u32 chacha_state[CHACHA_STATE_WORDS],
			    u8 *random_data, size_t random_data_len)
608
{
609
	unsigned long flags;
610
	struct crng *crng;
611

612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630
	BUG_ON(random_data_len > 32);

	/*
	 * For the fast path, we check whether we're ready, unlocked first, and
	 * then re-check once locked later. In the case where we're really not
	 * ready, we do fast key erasure with the base_crng directly, because
	 * this is what crng_{fast,slow}_load mutate during early init.
	 */
	if (unlikely(!crng_ready())) {
		bool ready;

		spin_lock_irqsave(&base_crng.lock, flags);
		ready = crng_ready();
		if (!ready)
			crng_fast_key_erasure(base_crng.key, chacha_state,
					      random_data, random_data_len);
		spin_unlock_irqrestore(&base_crng.lock, flags);
		if (!ready)
			return;
631
	}
632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665

	/*
	 * If the base_crng is more than 5 minutes old, we reseed, which
	 * in turn bumps the generation counter that we check below.
	 */
	if (unlikely(time_after(jiffies, READ_ONCE(base_crng.birth) + CRNG_RESEED_INTERVAL)))
		crng_reseed();

	local_lock_irqsave(&crngs.lock, flags);
	crng = raw_cpu_ptr(&crngs);

	/*
	 * If our per-cpu crng is older than the base_crng, then it means
	 * somebody reseeded the base_crng. In that case, we do fast key
	 * erasure on the base_crng, and use its output as the new key
	 * for our per-cpu crng. This brings us up to date with base_crng.
	 */
	if (unlikely(crng->generation != READ_ONCE(base_crng.generation))) {
		spin_lock(&base_crng.lock);
		crng_fast_key_erasure(base_crng.key, chacha_state,
				      crng->key, sizeof(crng->key));
		crng->generation = base_crng.generation;
		spin_unlock(&base_crng.lock);
	}

	/*
	 * Finally, when we've made it this far, our per-cpu crng has an up
	 * to date key, and we can do fast key erasure with it to produce
	 * some random data and a ChaCha state for the caller. All other
	 * branches of this function are "unlikely", so most of the time we
	 * should wind up here immediately.
	 */
	crng_fast_key_erasure(crng->key, chacha_state, random_data, random_data_len);
	local_unlock_irqrestore(&crngs.lock, flags);
666 667
}

668
static ssize_t get_random_bytes_user(void __user *buf, size_t nbytes)
669
{
670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685
	bool large_request = nbytes > 256;
	ssize_t ret = 0, len;
	u32 chacha_state[CHACHA_STATE_WORDS];
	u8 output[CHACHA_BLOCK_SIZE];

	if (!nbytes)
		return 0;

	len = min_t(ssize_t, 32, nbytes);
	crng_make_state(chacha_state, output, len);

	if (copy_to_user(buf, output, len))
		return -EFAULT;
	nbytes -= len;
	buf += len;
	ret += len;
686 687 688

	while (nbytes) {
		if (large_request && need_resched()) {
689
			if (signal_pending(current))
690 691 692 693
				break;
			schedule();
		}

694 695 696 697 698 699
		chacha20_block(chacha_state, output);
		if (unlikely(chacha_state[12] == 0))
			++chacha_state[13];

		len = min_t(ssize_t, nbytes, CHACHA_BLOCK_SIZE);
		if (copy_to_user(buf, output, len)) {
700 701 702 703
			ret = -EFAULT;
			break;
		}

704 705 706
		nbytes -= len;
		buf += len;
		ret += len;
707 708
	}

709 710
	memzero_explicit(chacha_state, sizeof(chacha_state));
	memzero_explicit(output, sizeof(output));
711 712 713
	return ret;
}

L
Linus Torvalds 已提交
714 715 716 717 718 719 720 721 722
/*********************************************************************
 *
 * Entropy input management
 *
 *********************************************************************/

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

726 727
#define INIT_TIMER_RAND_STATE { INITIAL_JIFFIES, };

728
/*
729 730
 * Add device- or boot-specific data to the input pool to help
 * initialize it.
731
 *
732 733 734
 * 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.
735 736 737
 */
void add_device_randomness(const void *buf, unsigned int size)
{
738
	unsigned long time = random_get_entropy() ^ jiffies;
739
	unsigned long flags;
740

741 742
	if (!crng_ready() && size)
		crng_slow_load(buf, size);
743

744
	trace_add_device_randomness(size, _RET_IP_);
745
	spin_lock_irqsave(&input_pool.lock, flags);
746 747
	_mix_pool_bytes(buf, size);
	_mix_pool_bytes(&time, sizeof(time));
748
	spin_unlock_irqrestore(&input_pool.lock, flags);
749 750 751
}
EXPORT_SYMBOL(add_device_randomness);

752
static struct timer_rand_state input_timer_state = INIT_TIMER_RAND_STATE;
753

L
Linus Torvalds 已提交
754 755 756 757 758 759 760 761 762 763 764 765 766 767
/*
 * 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;
768 769
		unsigned int cycles;
		unsigned int num;
L
Linus Torvalds 已提交
770 771 772 773
	} sample;
	long delta, delta2, delta3;

	sample.jiffies = jiffies;
774
	sample.cycles = random_get_entropy();
L
Linus Torvalds 已提交
775
	sample.num = num;
776
	mix_pool_bytes(&sample, sizeof(sample));
L
Linus Torvalds 已提交
777 778 779 780 781 782

	/*
	 * 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.
	 */
783 784
	delta = sample.jiffies - READ_ONCE(state->last_time);
	WRITE_ONCE(state->last_time, sample.jiffies);
785

786 787
	delta2 = delta - READ_ONCE(state->last_delta);
	WRITE_ONCE(state->last_delta, delta);
788

789 790
	delta3 = delta2 - READ_ONCE(state->last_delta2);
	WRITE_ONCE(state->last_delta2, delta2);
791 792 793 794 795 796 797 798 799 800 801

	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 已提交
802

803 804 805
	/*
	 * delta is now minimum absolute delta.
	 * Round down by 1 bit on general principles,
806
	 * and limit entropy estimate to 12 bits.
807
	 */
808
	credit_entropy_bits(min_t(int, fls(delta >> 1), 11));
L
Linus Torvalds 已提交
809 810
}

811
void add_input_randomness(unsigned int type, unsigned int code,
812
			  unsigned int value)
L
Linus Torvalds 已提交
813 814 815 816 817 818 819 820 821 822
{
	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);
823
	trace_add_input_randomness(input_pool.entropy_count);
L
Linus Torvalds 已提交
824
}
825
EXPORT_SYMBOL_GPL(add_input_randomness);
L
Linus Torvalds 已提交
826

827 828
static DEFINE_PER_CPU(struct fast_pool, irq_randomness);

829 830 831
#ifdef ADD_INTERRUPT_BENCH
static unsigned long avg_cycles, avg_deviation;

832 833
#define AVG_SHIFT 8 /* Exponential average factor k=1/256 */
#define FIXED_1_2 (1 << (AVG_SHIFT - 1))
834 835 836

static void add_interrupt_bench(cycles_t start)
{
837
	long delta = random_get_entropy() - start;
838

839 840 841 842 843 844
	/* 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;
845 846 847 848 849
}
#else
#define add_interrupt_bench(x)
#endif

850
static u32 get_reg(struct fast_pool *f, struct pt_regs *regs)
851
{
852
	u32 *ptr = (u32 *)regs;
853
	unsigned int idx;
854 855 856

	if (regs == NULL)
		return 0;
857
	idx = READ_ONCE(f->reg_idx);
858
	if (idx >= sizeof(struct pt_regs) / sizeof(u32))
859 860 861
		idx = 0;
	ptr += idx++;
	WRITE_ONCE(f->reg_idx, idx);
862
	return *ptr;
863 864
}

865
void add_interrupt_randomness(int irq)
L
Linus Torvalds 已提交
866
{
867 868 869 870 871 872
	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;
873

874 875
	if (cycles == 0)
		cycles = get_reg(fast_pool, regs);
876 877
	c_high = (sizeof(cycles) > 4) ? cycles >> 32 : 0;
	j_high = (sizeof(now) > 4) ? now >> 32 : 0;
878 879
	fast_pool->pool[0] ^= cycles ^ j_high ^ irq;
	fast_pool->pool[1] ^= now ^ c_high;
880
	ip = regs ? instruction_pointer(regs) : _RET_IP_;
881
	fast_pool->pool[2] ^= ip;
882 883
	fast_pool->pool[3] ^=
		(sizeof(ip) > 4) ? ip >> 32 : get_reg(fast_pool, regs);
884

885 886
	fast_mix(fast_pool);
	add_interrupt_bench(cycles);
887

T
Theodore Ts'o 已提交
888
	if (unlikely(crng_init == 0)) {
889
		if ((fast_pool->count >= 64) &&
890
		    crng_fast_load((u8 *)fast_pool->pool, sizeof(fast_pool->pool)) > 0) {
891 892
			fast_pool->count = 0;
			fast_pool->last = now;
893 894 895 896
			if (spin_trylock(&input_pool.lock)) {
				_mix_pool_bytes(&fast_pool->pool, sizeof(fast_pool->pool));
				spin_unlock(&input_pool.lock);
			}
897 898 899 900
		}
		return;
	}

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

904
	if (!spin_trylock(&input_pool.lock))
905
		return;
906

907
	fast_pool->last = now;
908 909
	__mix_pool_bytes(&fast_pool->pool, sizeof(fast_pool->pool));
	spin_unlock(&input_pool.lock);
910

911
	fast_pool->count = 0;
912

913
	/* award one bit for the contents of the fast pool */
914
	credit_entropy_bits(1);
L
Linus Torvalds 已提交
915
}
916
EXPORT_SYMBOL_GPL(add_interrupt_randomness);
L
Linus Torvalds 已提交
917

918
#ifdef CONFIG_BLOCK
L
Linus Torvalds 已提交
919 920 921 922 923
void add_disk_randomness(struct gendisk *disk)
{
	if (!disk || !disk->random)
		return;
	/* first major is 1, so we get >= 0x200 here */
924
	add_timer_randomness(disk->random, 0x100 + disk_devt(disk));
925
	trace_add_disk_randomness(disk_devt(disk), input_pool.entropy_count);
L
Linus Torvalds 已提交
926
}
927
EXPORT_SYMBOL_GPL(add_disk_randomness);
928
#endif
L
Linus Torvalds 已提交
929 930 931 932 933 934 935

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

G
Greg Price 已提交
936
/*
937 938
 * 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 已提交
939
 */
940
static void extract_entropy(void *buf, size_t nbytes)
L
Linus Torvalds 已提交
941
{
942
	unsigned long flags;
943 944
	u8 seed[BLAKE2S_HASH_SIZE], next_key[BLAKE2S_HASH_SIZE];
	struct {
945
		unsigned long rdseed[32 / sizeof(long)];
946 947 948 949
		size_t counter;
	} block;
	size_t i;

950
	trace_extract_entropy(nbytes, input_pool.entropy_count);
951

952 953 954 955
	for (i = 0; i < ARRAY_SIZE(block.rdseed); ++i) {
		if (!arch_get_random_seed_long(&block.rdseed[i]) &&
		    !arch_get_random_long(&block.rdseed[i]))
			block.rdseed[i] = random_get_entropy();
956 957
	}

958
	spin_lock_irqsave(&input_pool.lock, flags);
959

960 961
	/* seed = HASHPRF(last_key, entropy_input) */
	blake2s_final(&input_pool.hash, seed);
L
Linus Torvalds 已提交
962

963
	/* next_key = HASHPRF(seed, RDSEED || 0) */
964 965 966
	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 已提交
967

968 969
	spin_unlock_irqrestore(&input_pool.lock, flags);
	memzero_explicit(next_key, sizeof(next_key));
970 971

	while (nbytes) {
972
		i = min_t(size_t, nbytes, BLAKE2S_HASH_SIZE);
973
		/* output = HASHPRF(seed, RDSEED || ++counter) */
974 975
		++block.counter;
		blake2s(buf, (u8 *)&block, seed, i, sizeof(block), sizeof(seed));
976 977 978 979
		nbytes -= i;
		buf += i;
	}

980 981
	memzero_explicit(seed, sizeof(seed));
	memzero_explicit(&block, sizeof(block));
982 983
}

984
#define warn_unseeded_randomness(previous) \
985
	_warn_unseeded_randomness(__func__, (void *)_RET_IP_, (previous))
986

987
static void _warn_unseeded_randomness(const char *func_name, void *caller, void **previous)
988 989 990 991 992 993 994
{
#ifdef CONFIG_WARN_ALL_UNSEEDED_RANDOM
	const bool print_once = false;
#else
	static bool print_once __read_mostly;
#endif

995
	if (print_once || crng_ready() ||
996 997 998 999 1000 1001
	    (previous && (caller == READ_ONCE(*previous))))
		return;
	WRITE_ONCE(*previous, caller);
#ifndef CONFIG_WARN_ALL_UNSEEDED_RANDOM
	print_once = true;
#endif
1002
	if (__ratelimit(&unseeded_warning))
1003 1004
		printk_deferred(KERN_NOTICE "random: %s called from %pS with crng_init=%d\n",
				func_name, caller, crng_init);
1005 1006
}

L
Linus Torvalds 已提交
1007 1008
/*
 * This function is the exported kernel interface.  It returns some
1009
 * number of good random numbers, suitable for key generation, seeding
1010 1011
 * TCP sequence numbers, etc.  It does not rely on the hardware random
 * number generator.  For random bytes direct from the hardware RNG
1012 1013 1014 1015
 * (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 已提交
1016
 */
1017
static void _get_random_bytes(void *buf, int nbytes)
1018
{
1019 1020 1021
	u32 chacha_state[CHACHA_STATE_WORDS];
	u8 tmp[CHACHA_BLOCK_SIZE];
	ssize_t len;
1022

1023
	trace_get_random_bytes(nbytes, _RET_IP_);
1024

1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
	if (!nbytes)
		return;

	len = min_t(ssize_t, 32, nbytes);
	crng_make_state(chacha_state, buf, len);
	nbytes -= len;
	buf += len;

	while (nbytes) {
		if (nbytes < CHACHA_BLOCK_SIZE) {
			chacha20_block(chacha_state, tmp);
			memcpy(buf, tmp, nbytes);
			memzero_explicit(tmp, sizeof(tmp));
			break;
		}

		chacha20_block(chacha_state, buf);
		if (unlikely(chacha_state[12] == 0))
			++chacha_state[13];
1044
		nbytes -= CHACHA_BLOCK_SIZE;
1045
		buf += CHACHA_BLOCK_SIZE;
1046 1047
	}

1048
	memzero_explicit(chacha_state, sizeof(chacha_state));
1049
}
1050 1051 1052 1053 1054 1055 1056 1057

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

	warn_unseeded_randomness(&previous);
	_get_random_bytes(buf, nbytes);
}
1058 1059
EXPORT_SYMBOL(get_random_bytes);

1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074
/*
 * 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)
{
1075
	credit_entropy_bits(1);
1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097
}

/*
 * 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))
1098
			mod_timer(&stack.timer, jiffies + 1);
1099
		mix_pool_bytes(&stack.now, sizeof(stack.now));
1100 1101 1102 1103 1104 1105
		schedule();
		stack.now = random_get_entropy();
	}

	del_timer_sync(&stack.timer);
	destroy_timer_on_stack(&stack.timer);
1106
	mix_pool_bytes(&stack.now, sizeof(stack.now));
1107 1108
}

1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122
/*
 * 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;
1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133

	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;
1134 1135 1136
}
EXPORT_SYMBOL(wait_for_random_bytes);

1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151
/*
 * 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);

1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165
/*
 * 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;

1166
	if (crng_ready())
1167 1168 1169 1170 1171 1172 1173
		return err;

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

	spin_lock_irqsave(&random_ready_list_lock, flags);
1174
	if (crng_ready())
1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209
		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);

1210 1211 1212 1213 1214 1215 1216 1217 1218
/*
 * 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.
1219 1220
 *
 * Return number of bytes filled in.
1221
 */
1222
int __must_check get_random_bytes_arch(void *buf, int nbytes)
L
Linus Torvalds 已提交
1223
{
1224
	int left = nbytes;
1225
	u8 *p = buf;
1226

1227 1228
	trace_get_random_bytes_arch(left, _RET_IP_);
	while (left) {
1229
		unsigned long v;
1230
		int chunk = min_t(int, left, sizeof(unsigned long));
1231

1232 1233
		if (!arch_get_random_long(&v))
			break;
1234

L
Luck, Tony 已提交
1235
		memcpy(p, &v, chunk);
1236
		p += chunk;
1237
		left -= chunk;
1238 1239
	}

1240
	return nbytes - left;
L
Linus Torvalds 已提交
1241
}
1242 1243
EXPORT_SYMBOL(get_random_bytes_arch);

1244 1245 1246 1247 1248 1249 1250
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);

L
Linus Torvalds 已提交
1251
/*
1252 1253 1254 1255 1256 1257 1258 1259
 * 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.
L
Linus Torvalds 已提交
1260
 */
1261
int __init rand_initialize(void)
L
Linus Torvalds 已提交
1262
{
1263
	int i;
1264
	ktime_t now = ktime_get_real();
1265
	bool arch_init = true;
1266
	unsigned long rv;
L
Linus Torvalds 已提交
1267

1268
	for (i = BLAKE2S_BLOCK_SIZE; i > 0; i -= sizeof(rv)) {
1269 1270 1271 1272 1273
		if (!arch_get_random_seed_long_early(&rv) &&
		    !arch_get_random_long_early(&rv)) {
			rv = random_get_entropy();
			arch_init = false;
		}
1274
		mix_pool_bytes(&rv, sizeof(rv));
1275
	}
1276 1277 1278
	mix_pool_bytes(&now, sizeof(now));
	mix_pool_bytes(utsname(), sizeof(*(utsname())));

1279
	extract_entropy(base_crng.key, sizeof(base_crng.key));
1280 1281 1282 1283 1284 1285
	if (arch_init && trust_cpu && crng_init < 2) {
		invalidate_batched_entropy();
		crng_init = 2;
		pr_notice("crng init done (trusting CPU's manufacturer)\n");
	}

1286 1287 1288 1289
	if (ratelimit_disable) {
		urandom_warning.interval = 0;
		unseeded_warning.interval = 0;
	}
L
Linus Torvalds 已提交
1290 1291 1292
	return 0;
}

1293
#ifdef CONFIG_BLOCK
L
Linus Torvalds 已提交
1294 1295 1296 1297 1298
void rand_initialize_disk(struct gendisk *disk)
{
	struct timer_rand_state *state;

	/*
1299
	 * If kzalloc returns null, we just won't use that entropy
L
Linus Torvalds 已提交
1300 1301
	 * source.
	 */
1302
	state = kzalloc(sizeof(struct timer_rand_state), GFP_KERNEL);
1303 1304
	if (state) {
		state->last_time = INITIAL_JIFFIES;
L
Linus Torvalds 已提交
1305
		disk->random = state;
1306
	}
L
Linus Torvalds 已提交
1307
}
1308
#endif
L
Linus Torvalds 已提交
1309

1310 1311
static ssize_t urandom_read_nowarn(struct file *file, char __user *buf,
				   size_t nbytes, loff_t *ppos)
1312 1313 1314
{
	int ret;

1315
	nbytes = min_t(size_t, nbytes, INT_MAX >> 6);
1316
	ret = get_random_bytes_user(buf, nbytes);
1317
	trace_urandom_read(8 * nbytes, 0, input_pool.entropy_count);
1318 1319 1320
	return ret;
}

1321 1322
static ssize_t urandom_read(struct file *file, char __user *buf, size_t nbytes,
			    loff_t *ppos)
L
Linus Torvalds 已提交
1323
{
1324
	static int maxwarn = 10;
1325

1326
	if (!crng_ready() && maxwarn > 0) {
1327
		maxwarn--;
1328
		if (__ratelimit(&urandom_warning))
Y
Yangtao Li 已提交
1329 1330
			pr_notice("%s: uninitialized urandom read (%zd bytes read)\n",
				  current->comm, nbytes);
1331
	}
1332 1333

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

1336 1337
static ssize_t random_read(struct file *file, char __user *buf, size_t nbytes,
			   loff_t *ppos)
1338 1339 1340 1341 1342 1343 1344 1345 1346
{
	int ret;

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

1347
static __poll_t random_poll(struct file *file, poll_table *wait)
L
Linus Torvalds 已提交
1348
{
1349
	__poll_t mask;
L
Linus Torvalds 已提交
1350

1351
	poll_wait(file, &crng_init_wait, wait);
1352 1353
	poll_wait(file, &random_write_wait, wait);
	mask = 0;
1354
	if (crng_ready())
1355
		mask |= EPOLLIN | EPOLLRDNORM;
1356
	if (input_pool.entropy_count < POOL_MIN_BITS)
1357
		mask |= EPOLLOUT | EPOLLWRNORM;
L
Linus Torvalds 已提交
1358 1359 1360
	return mask;
}

1361
static int write_pool(const char __user *buffer, size_t count)
L
Linus Torvalds 已提交
1362 1363
{
	size_t bytes;
1364
	u8 buf[BLAKE2S_BLOCK_SIZE];
L
Linus Torvalds 已提交
1365 1366
	const char __user *p = buffer;

1367 1368
	while (count > 0) {
		bytes = min(count, sizeof(buf));
1369
		if (copy_from_user(buf, p, bytes))
1370 1371
			return -EFAULT;
		count -= bytes;
L
Linus Torvalds 已提交
1372
		p += bytes;
1373
		mix_pool_bytes(buf, bytes);
1374
		cond_resched();
L
Linus Torvalds 已提交
1375
	}
1376 1377 1378 1379

	return 0;
}

1380 1381
static ssize_t random_write(struct file *file, const char __user *buffer,
			    size_t count, loff_t *ppos)
1382 1383 1384
{
	size_t ret;

1385
	ret = write_pool(buffer, count);
1386 1387 1388 1389
	if (ret)
		return ret;

	return (ssize_t)count;
L
Linus Torvalds 已提交
1390 1391
}

M
Matt Mackall 已提交
1392
static long random_ioctl(struct file *f, unsigned int cmd, unsigned long arg)
L
Linus Torvalds 已提交
1393 1394 1395 1396 1397 1398 1399
{
	int size, ent_count;
	int __user *p = (int __user *)arg;
	int retval;

	switch (cmd) {
	case RNDGETENTCNT:
M
Matt Mackall 已提交
1400
		/* inherently racy, no point locking */
1401
		if (put_user(input_pool.entropy_count, p))
L
Linus Torvalds 已提交
1402 1403 1404 1405 1406 1407 1408
			return -EFAULT;
		return 0;
	case RNDADDTOENTCNT:
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
		if (get_user(ent_count, p))
			return -EFAULT;
1409 1410 1411 1412
		if (ent_count < 0)
			return -EINVAL;
		credit_entropy_bits(ent_count);
		return 0;
L
Linus Torvalds 已提交
1413 1414 1415 1416 1417 1418 1419 1420 1421
	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;
1422
		retval = write_pool((const char __user *)p, size);
L
Linus Torvalds 已提交
1423 1424
		if (retval < 0)
			return retval;
1425 1426
		credit_entropy_bits(ent_count);
		return 0;
L
Linus Torvalds 已提交
1427 1428
	case RNDZAPENTCNT:
	case RNDCLEARPOOL:
1429 1430 1431 1432
		/*
		 * Clear the entropy pool counters. We no longer clear
		 * the entropy pool, as that's silly.
		 */
L
Linus Torvalds 已提交
1433 1434
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
1435
		if (xchg(&input_pool.entropy_count, 0)) {
1436 1437 1438
			wake_up_interruptible(&random_write_wait);
			kill_fasync(&fasync, SIGIO, POLL_OUT);
		}
L
Linus Torvalds 已提交
1439
		return 0;
1440 1441 1442 1443 1444
	case RNDRESEEDCRNG:
		if (!capable(CAP_SYS_ADMIN))
			return -EPERM;
		if (crng_init < 2)
			return -ENODATA;
1445
		crng_reseed();
1446
		return 0;
L
Linus Torvalds 已提交
1447 1448 1449 1450 1451
	default:
		return -EINVAL;
	}
}

1452 1453 1454 1455 1456
static int random_fasync(int fd, struct file *filp, int on)
{
	return fasync_helper(fd, filp, on, &fasync);
}

1457
const struct file_operations random_fops = {
1458
	.read = random_read,
L
Linus Torvalds 已提交
1459
	.write = random_write,
1460
	.poll = random_poll,
M
Matt Mackall 已提交
1461
	.unlocked_ioctl = random_ioctl,
1462
	.compat_ioctl = compat_ptr_ioctl,
1463
	.fasync = random_fasync,
1464
	.llseek = noop_llseek,
L
Linus Torvalds 已提交
1465 1466
};

1467
const struct file_operations urandom_fops = {
1468
	.read = urandom_read,
L
Linus Torvalds 已提交
1469
	.write = random_write,
M
Matt Mackall 已提交
1470
	.unlocked_ioctl = random_ioctl,
1471
	.compat_ioctl = compat_ptr_ioctl,
1472
	.fasync = random_fasync,
1473
	.llseek = noop_llseek,
L
Linus Torvalds 已提交
1474 1475
};

1476 1477
SYSCALL_DEFINE3(getrandom, char __user *, buf, size_t, count, unsigned int,
		flags)
1478
{
1479 1480
	int ret;

1481
	if (flags & ~(GRND_NONBLOCK | GRND_RANDOM | GRND_INSECURE))
1482 1483 1484 1485 1486 1487
		return -EINVAL;

	/*
	 * Requesting insecure and blocking randomness at the same time makes
	 * no sense.
	 */
1488
	if ((flags & (GRND_INSECURE | GRND_RANDOM)) == (GRND_INSECURE | GRND_RANDOM))
1489 1490 1491 1492 1493
		return -EINVAL;

	if (count > INT_MAX)
		count = INT_MAX;

1494
	if (!(flags & GRND_INSECURE) && !crng_ready()) {
1495 1496
		if (flags & GRND_NONBLOCK)
			return -EAGAIN;
1497 1498 1499
		ret = wait_for_random_bytes();
		if (unlikely(ret))
			return ret;
1500
	}
1501
	return urandom_read_nowarn(NULL, buf, count, NULL);
1502 1503
}

L
Linus Torvalds 已提交
1504 1505 1506 1507 1508 1509 1510 1511 1512 1513
/********************************************************************
 *
 * Sysctl interface
 *
 ********************************************************************/

#ifdef CONFIG_SYSCTL

#include <linux/sysctl.h>

1514
static int random_min_urandom_seed = 60;
1515 1516
static int random_write_wakeup_bits = POOL_MIN_BITS;
static int sysctl_poolsize = POOL_BITS;
L
Linus Torvalds 已提交
1517 1518 1519
static char sysctl_bootid[16];

/*
G
Greg Price 已提交
1520
 * This function is used to return both the bootid UUID, and random
L
Linus Torvalds 已提交
1521 1522 1523
 * 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 已提交
1524 1525 1526
 * 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 已提交
1527
 */
1528 1529
static int proc_do_uuid(struct ctl_table *table, int write, void *buffer,
			size_t *lenp, loff_t *ppos)
L
Linus Torvalds 已提交
1530
{
1531
	struct ctl_table fake_table;
L
Linus Torvalds 已提交
1532 1533 1534 1535 1536 1537
	unsigned char buf[64], tmp_uuid[16], *uuid;

	uuid = table->data;
	if (!uuid) {
		uuid = tmp_uuid;
		generate_random_uuid(uuid);
1538 1539 1540 1541 1542 1543 1544 1545
	} else {
		static DEFINE_SPINLOCK(bootid_spinlock);

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

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

L
Linus Torvalds 已提交
1549 1550 1551
	fake_table.data = buf;
	fake_table.maxlen = sizeof(buf);

1552
	return proc_dostring(&fake_table, write, buffer, lenp, ppos);
L
Linus Torvalds 已提交
1553 1554
}

1555
static struct ctl_table random_table[] = {
L
Linus Torvalds 已提交
1556 1557 1558 1559 1560
	{
		.procname	= "poolsize",
		.data		= &sysctl_poolsize,
		.maxlen		= sizeof(int),
		.mode		= 0444,
1561
		.proc_handler	= proc_dointvec,
L
Linus Torvalds 已提交
1562 1563 1564
	},
	{
		.procname	= "entropy_avail",
1565
		.data		= &input_pool.entropy_count,
L
Linus Torvalds 已提交
1566 1567
		.maxlen		= sizeof(int),
		.mode		= 0444,
1568
		.proc_handler	= proc_dointvec,
L
Linus Torvalds 已提交
1569 1570 1571
	},
	{
		.procname	= "write_wakeup_threshold",
1572
		.data		= &random_write_wakeup_bits,
L
Linus Torvalds 已提交
1573 1574
		.maxlen		= sizeof(int),
		.mode		= 0644,
1575
		.proc_handler	= proc_dointvec,
L
Linus Torvalds 已提交
1576
	},
1577 1578 1579 1580 1581 1582 1583
	{
		.procname	= "urandom_min_reseed_secs",
		.data		= &random_min_urandom_seed,
		.maxlen		= sizeof(int),
		.mode		= 0644,
		.proc_handler	= proc_dointvec,
	},
L
Linus Torvalds 已提交
1584 1585 1586 1587 1588
	{
		.procname	= "boot_id",
		.data		= &sysctl_bootid,
		.maxlen		= 16,
		.mode		= 0444,
1589
		.proc_handler	= proc_do_uuid,
L
Linus Torvalds 已提交
1590 1591 1592 1593 1594
	},
	{
		.procname	= "uuid",
		.maxlen		= 16,
		.mode		= 0444,
1595
		.proc_handler	= proc_do_uuid,
L
Linus Torvalds 已提交
1596
	},
1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612
#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
1613
	{ }
L
Linus Torvalds 已提交
1614
};
1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625

/*
 * 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);
1626
#endif	/* CONFIG_SYSCTL */
L
Linus Torvalds 已提交
1627

1628 1629
static atomic_t batch_generation = ATOMIC_INIT(0);

1630 1631
struct batched_entropy {
	union {
1632 1633 1634 1635 1636 1637 1638 1639 1640
		/*
		 * We make this 1.5x a ChaCha block, so that we get the
		 * remaining 32 bytes from fast key erasure, plus one full
		 * block from the detached ChaCha state. We can increase
		 * the size of this later if needed so long as we keep the
		 * formula of (integer_blocks + 0.5) * CHACHA_BLOCK_SIZE.
		 */
		u64 entropy_u64[CHACHA_BLOCK_SIZE * 3 / (2 * sizeof(u64))];
		u32 entropy_u32[CHACHA_BLOCK_SIZE * 3 / (2 * sizeof(u32))];
1641
	};
1642
	local_lock_t lock;
1643
	unsigned int position;
1644
	int generation;
1645
};
1646

L
Linus Torvalds 已提交
1647
/*
1648
 * Get a random word for internal kernel use only. The quality of the random
1649 1650 1651
 * number is good as /dev/urandom. 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 已提交
1652
 */
1653
static DEFINE_PER_CPU(struct batched_entropy, batched_entropy_u64) = {
1654 1655
	.lock = INIT_LOCAL_LOCK(batched_entropy_u64.lock),
	.position = UINT_MAX
1656 1657
};

1658
u64 get_random_u64(void)
L
Linus Torvalds 已提交
1659
{
1660
	u64 ret;
1661
	unsigned long flags;
1662
	struct batched_entropy *batch;
1663
	static void *previous;
1664
	int next_gen;
1665

1666
	warn_unseeded_randomness(&previous);
1667

1668
	local_lock_irqsave(&batched_entropy_u64.lock, flags);
1669
	batch = raw_cpu_ptr(&batched_entropy_u64);
1670 1671

	next_gen = atomic_read(&batch_generation);
1672
	if (batch->position >= ARRAY_SIZE(batch->entropy_u64) ||
1673
	    next_gen != batch->generation) {
1674
		_get_random_bytes(batch->entropy_u64, sizeof(batch->entropy_u64));
1675
		batch->position = 0;
1676
		batch->generation = next_gen;
1677
	}
1678

1679 1680 1681
	ret = batch->entropy_u64[batch->position];
	batch->entropy_u64[batch->position] = 0;
	++batch->position;
1682
	local_unlock_irqrestore(&batched_entropy_u64.lock, flags);
1683
	return ret;
L
Linus Torvalds 已提交
1684
}
1685
EXPORT_SYMBOL(get_random_u64);
L
Linus Torvalds 已提交
1686

1687
static DEFINE_PER_CPU(struct batched_entropy, batched_entropy_u32) = {
1688 1689
	.lock = INIT_LOCAL_LOCK(batched_entropy_u32.lock),
	.position = UINT_MAX
1690
};
1691

1692
u32 get_random_u32(void)
1693
{
1694
	u32 ret;
1695
	unsigned long flags;
1696
	struct batched_entropy *batch;
1697
	static void *previous;
1698
	int next_gen;
1699

1700
	warn_unseeded_randomness(&previous);
1701

1702
	local_lock_irqsave(&batched_entropy_u32.lock, flags);
1703
	batch = raw_cpu_ptr(&batched_entropy_u32);
1704 1705

	next_gen = atomic_read(&batch_generation);
1706
	if (batch->position >= ARRAY_SIZE(batch->entropy_u32) ||
1707
	    next_gen != batch->generation) {
1708
		_get_random_bytes(batch->entropy_u32, sizeof(batch->entropy_u32));
1709
		batch->position = 0;
1710
		batch->generation = next_gen;
1711
	}
1712

1713 1714 1715
	ret = batch->entropy_u32[batch->position];
	batch->entropy_u32[batch->position] = 0;
	++batch->position;
1716
	local_unlock_irqrestore(&batched_entropy_u32.lock, flags);
1717 1718
	return ret;
}
1719
EXPORT_SYMBOL(get_random_u32);
1720

1721 1722
/* It's important to invalidate all potential batched entropy that might
 * be stored before the crng is initialized, which we can do lazily by
1723 1724
 * bumping the generation counter.
 */
1725 1726
static void invalidate_batched_entropy(void)
{
1727
	atomic_inc(&batch_generation);
1728 1729
}

1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743
/**
 * 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.
 */
1744
unsigned long randomize_page(unsigned long start, unsigned long range)
1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761
{
	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);
}

1762 1763 1764 1765 1766 1767 1768
/* 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 已提交
1769
	if (unlikely(crng_init == 0)) {
1770
		size_t ret = crng_fast_load(buffer, count);
1771
		mix_pool_bytes(buffer, ret);
1772 1773 1774 1775
		count -= ret;
		buffer += ret;
		if (!count || crng_init == 0)
			return;
1776
	}
1777

1778
	/* Throttle writing if we're above the trickle threshold.
1779 1780 1781
	 * 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.
1782
	 */
1783
	wait_event_interruptible_timeout(random_write_wait,
1784
			!system_wq || kthread_should_stop() ||
1785
			input_pool.entropy_count < POOL_MIN_BITS,
1786
			CRNG_RESEED_INTERVAL);
1787 1788
	mix_pool_bytes(buffer, count);
	credit_entropy_bits(entropy);
1789 1790
}
EXPORT_SYMBOL_GPL(add_hwgenerator_randomness);
H
Hsin-Yi Wang 已提交
1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803

/* 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);
}
1804
EXPORT_SYMBOL_GPL(add_bootloader_randomness);