Go to file
Jason A. Donenfeld eaad4f9e8f arc4random: simplify design for better safety
Rather than buffering 16 MiB of entropy in userspace (by way of
chacha20), simply call getrandom() every time.

This approach is doubtlessly slower, for now, but trying to prematurely
optimize arc4random appears to be leading toward all sorts of nasty
properties and gotchas. Instead, this patch takes a much more
conservative approach. The interface is added as a basic loop wrapper
around getrandom(), and then later, the kernel and libc together can
work together on optimizing that.

This prevents numerous issues in which userspace is unaware of when it
really must throw away its buffer, since we avoid buffering all
together. Future improvements may include userspace learning more from
the kernel about when to do that, which might make these sorts of
chacha20-based optimizations more possible. The current heuristic of 16
MiB is meaningless garbage that doesn't correspond to anything the
kernel might know about. So for now, let's just do something
conservative that we know is correct and won't lead to cryptographic
issues for users of this function.

This patch might be considered along the lines of, "optimization is the
root of all evil," in that the much more complex implementation it
replaces moves too fast without considering security implications,
whereas the incremental approach done here is a much safer way of going
about things. Once this lands, we can take our time in optimizing this
properly using new interplay between the kernel and userspace.

getrandom(0) is used, since that's the one that ensures the bytes
returned are cryptographically secure. But on systems without it, we
fallback to using /dev/urandom. This is unfortunate because it means
opening a file descriptor, but there's not much of a choice. Secondly,
as part of the fallback, in order to get more or less the same
properties of getrandom(0), we poll on /dev/random, and if the poll
succeeds at least once, then we assume the RNG is initialized. This is a
rough approximation, as the ancient "non-blocking pool" initialized
after the "blocking pool", not before, and it may not port back to all
ancient kernels, though it does to all kernels supported by glibc
(≥3.2), so generally it's the best approximation we can do.

The motivation for including arc4random, in the first place, is to have
source-level compatibility with existing code. That means this patch
doesn't attempt to litigate the interface itself. It does, however,
choose a conservative approach for implementing it.

Cc: Adhemerval Zanella Netto <adhemerval.zanella@linaro.org>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: Cristian Rodríguez <crrodriguez@opensuse.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Eric Biggers <ebiggers@kernel.org>
Cc: linux-crypto@vger.kernel.org
Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>

Reviewed-by: Adhemerval Zanella  <adhemerval.zanella@linaro.org>
2022-07-27 08:58:27 -03:00
argp argp: Remove old includes in !_LIBC case 2022-07-04 15:25:18 +02:00
assert Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
benchtests benchtests: Add arc4random benchtest 2022-07-22 11:58:27 -03:00
bits linux: Add process_madvise 2022-06-02 15:43:28 -03:00
catgets catgets: Use 64 bit stat for __open_catalog (BZ# 29211) 2022-06-01 13:23:16 -03:00
ChangeLog.old Create ChangeLog.old/ChangeLog.24. 2022-02-03 00:27:54 -05:00
conform hurd: drop SA_SIGINFO availability xfail 2022-01-15 17:43:07 +01:00
crypt crypt: Remove unused variable on cert test 2022-03-31 09:00:54 -03:00
csu Remove kernel version check 2022-05-16 15:03:49 -03:00
ctype Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
debug debug: make __read_chk a cancellation point (bug 29274) 2022-06-22 17:00:44 +02:00
dirent associate a deallocation for opendir 2022-03-14 20:02:46 +05:30
dlfcn dlfcn: Move RTLD_DEFAULT/RTLD_NEXT outside __USE_GNU 2022-05-23 10:23:23 -07:00
elf LoongArch: Add relocations and ELF flags to elf.h and scripts/glibcelf.py 2022-07-26 12:35:12 -03:00
gmon Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
gnulib Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
grp Add access function attributes to grp and shadow headers 2022-03-14 20:02:30 +05:30
gshadow Add access function attributes to grp and shadow headers 2022-03-14 20:02:30 +05:30
hesiod Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
htl htl: Destroy thread-specific data before releasing joins 2022-02-14 19:29:02 +01:00
hurd Replace {u}int_fast{16|32} with {u}int32_t 2022-04-13 21:23:04 -05:00
iconv Avoid -Wstringop-overflow= warning in iconv module. 2022-06-14 11:03:06 +02:00
iconvdata gconv: Correct Big5-HKSCS conversion to preserve all state bits. [BZ #25744] 2022-07-06 09:27:13 -03:00
include arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
inet inet: Use 64 bit stat for ruserpass (BZ# 29210) 2022-06-01 13:23:16 -03:00
intl intl: Avoid -Wuse-after-free [BZ #26779] 2022-01-25 17:38:31 -07:00
io grep: egrep -> grep -E, fgrep -> grep -F 2022-06-05 12:09:02 -07:00
libio Apply asm redirections in stdio.h before first use [BZ #27087] 2022-07-14 16:01:14 -03:00
locale locale: Optimize tst-localedef-path-norm 2022-07-22 11:06:16 -03:00
localedata de_DE: Convert to UTF-8 2022-07-05 09:07:02 +02:00
login Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
mach mach: Fix LLL_SHARED value 2022-02-14 19:29:02 +01:00
malloc stdlib: Add arc4random, arc4random_buf, and arc4random_uniform (BZ #4417) 2022-07-22 11:58:27 -03:00
manual arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
math math: Add more input to atanh accuracy tests 2022-02-24 09:20:43 -08:00
mathvec Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
misc misc: Optimize internal usage of __libc_single_threaded 2022-06-24 17:45:58 -03:00
nis Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
nptl stdlib: Add arc4random, arc4random_buf, and arc4random_uniform (BZ #4417) 2022-07-22 11:58:27 -03:00
nptl_db nptl_db: disable DT_RELR on libthread_db.so 2022-06-08 11:17:47 -05:00
nscd nscd: Remove unused variable 2022-03-23 15:33:17 -03:00
nss nss: handle stat failure in check_reload_and_get (BZ #28752) 2022-06-08 21:29:39 -04:00
po grep: egrep -> grep -E, fgrep -> grep -F 2022-06-05 12:09:02 -07:00
posix Replace __libc_multiple_threads with __libc_single_threaded 2022-07-05 10:14:47 -03:00
pwd Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
resolv resolv/tst-resolv-noaaaa: Support building for older C standards 2022-06-24 19:44:42 +02:00
resource Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
rt Refactor internal-signals.h 2022-06-30 14:56:21 -03:00
scripts LoongArch: Update build-many-glibcs.py for the LoongArch Port. 2022-07-26 12:35:12 -03:00
setjmp Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
shadow Add access function attributes to grp and shadow headers 2022-03-14 20:02:30 +05:30
signal Refactor internal-signals.h 2022-06-30 14:56:21 -03:00
socket socket: Fix mistyped define statement in socket/sys/socket.h (BZ #29225) 2022-06-06 12:46:14 -03:00
soft-fp Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
stdio-common libio: Avoid RMW of flags2 outside lock (BZ #27842) 2022-06-10 13:35:57 +01:00
stdlib arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
string x86: Fix page cross case in rawmemchr-avx2 [BZ #29234] 2022-06-08 17:07:34 -07:00
sunrpc CVE-2022-23218: Buffer overflow in sunrpc svcunix_create (bug 28768) 2022-01-17 10:47:58 +01:00
support test-container: return UNSUPPORTED for ENOSPC on clone() 2022-07-05 22:34:51 -04:00
sysdeps arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
sysvipc Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
termios posix: Add terminal control setting support for posix_spawn 2022-01-25 14:07:53 -03:00
time Declare timegm for ISO C2X 2022-06-06 14:47:03 +00:00
timezone timezone: Fix tst-bz28707 Makefile rule 2022-01-12 10:30:10 -03:00
wcsmbs stdlib: Tests for mbrtoc8, c8rtomb, and the char8_t typedef. 2022-07-06 09:29:45 -03:00
wctype Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
.clang-format Add .clang-format style file 2022-04-11 10:51:03 -05:00
.gitattributes Assume __NR_openat is always defined 2016-03-23 23:35:08 +01:00
.gitignore Add *.pyc to .gitignore 2015-05-18 15:26:26 +05:30
abi-tags Remove the bulk of the NaCl port. 2017-05-20 08:09:10 -04:00
aclocal.m4 grep: egrep -> grep -E, fgrep -> grep -F 2022-06-05 12:09:02 -07:00
config.h.in LoongArch: Add LoongArch entries to config.h.in 2022-07-26 12:35:12 -03:00
config.make.in Remove configure fno_unit_at_a_time 2022-05-13 10:54:41 -03:00
configure Remove configure fno_unit_at_a_time 2022-05-13 10:54:41 -03:00
configure.ac Remove configure fno_unit_at_a_time 2022-05-13 10:54:41 -03:00
CONTRIBUTED-BY Remove "Contributed by" lines 2021-09-03 22:06:44 +05:30
COPYING Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
COPYING.LIB Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
extra-lib.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
gen-locales.mk Improve gen-locales.mk and gen-locale.sh to make test files with @ options work 2018-02-27 17:01:57 +01:00
INSTALL INSTALL: Rephrase -with-default-link documentation 2022-04-26 14:22:23 +02:00
libc-abis riscv: support GNU indirect function 2021-01-10 21:25:13 -05:00
libof-iterator.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
LICENSES arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
MAINTAINERS Add MAINTAINERS 2017-05-11 13:38:30 -04:00
Makeconfig Enable DT_RELR in glibc shared libraries and PIEs automatically 2022-05-18 13:04:13 -07:00
Makefile grep: egrep -> grep -E, fgrep -> grep -F 2022-06-05 12:09:02 -07:00
Makefile.help Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Makerules: Remove no-op -Wl,-d when linking libc_pic.os 2022-06-26 15:31:19 -07:00
NEWS arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
o-iterator.mk
README LoongArch: Update NEWS and README for the LoongArch port. 2022-07-26 12:35:12 -03:00
Rules Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
SHARED-FILES Mention today's regex merge in SHARED-FILES 2021-09-21 18:00:10 -07:00
shlib-versions nss: Do not mention NSS test modules in <gnu/lib-names.h> 2022-03-11 08:24:04 +01:00
test-skeleton.c Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
version.h Open master branch for glibc 2.36 development 2022-02-03 01:21:33 -05:00

This directory contains the sources of the GNU C Library.
See the file "version.h" for what release version you have.

The GNU C Library is the standard system C library for all GNU systems,
and is an important part of what makes up a GNU system.  It provides the
system API for all programs written in C and C-compatible languages such
as C++ and Objective C; the runtime facilities of other programming
languages use the C library to access the underlying operating system.

In GNU/Linux systems, the C library works with the Linux kernel to
implement the operating system behavior seen by user applications.
In GNU/Hurd systems, it works with a microkernel and Hurd servers.

The GNU C Library implements much of the POSIX.1 functionality in the
GNU/Hurd system, using configurations i[4567]86-*-gnu.

When working with Linux kernels, this version of the GNU C Library
requires Linux kernel version 3.2 or later.

Also note that the shared version of the libgcc_s library must be
installed for the pthread library to work correctly.

The GNU C Library supports these configurations for using Linux kernels:

	aarch64*-*-linux-gnu
	alpha*-*-linux-gnu
	arc*-*-linux-gnu
	arm-*-linux-gnueabi
	csky-*-linux-gnuabiv2
	hppa-*-linux-gnu
	i[4567]86-*-linux-gnu
	x86_64-*-linux-gnu	Can build either x86_64 or x32
	ia64-*-linux-gnu
	loongarch64-*-linux-gnu Hardware floating point, LE only.
	m68k-*-linux-gnu
	microblaze*-*-linux-gnu
	mips-*-linux-gnu
	mips64-*-linux-gnu
	or1k-*-linux-gnu
	powerpc-*-linux-gnu	Hardware or software floating point, BE only.
	powerpc64*-*-linux-gnu	Big-endian and little-endian.
	s390-*-linux-gnu
	s390x-*-linux-gnu
	riscv32-*-linux-gnu
	riscv64-*-linux-gnu
	sh[34]-*-linux-gnu
	sparc*-*-linux-gnu
	sparc64*-*-linux-gnu

If you are interested in doing a port, please contact the glibc
maintainers; see https://www.gnu.org/software/libc/ for more
information.

See the file INSTALL to find out how to configure, build, and install
the GNU C Library.  You might also consider reading the WWW pages for
the C library at https://www.gnu.org/software/libc/.

The GNU C Library is (almost) completely documented by the Texinfo manual
found in the `manual/' subdirectory.  The manual is still being updated
and contains some known errors and omissions; we regret that we do not
have the resources to work on the manual as much as we would like.  For
corrections to the manual, please file a bug in the `manual' component,
following the bug-reporting instructions below.  Please be sure to check
the manual in the current development sources to see if your problem has
already been corrected.

Please see https://www.gnu.org/software/libc/bugs.html for bug reporting
information.  We are now using the Bugzilla system to track all bug reports.
This web page gives detailed information on how to report bugs properly.

The GNU C Library is free software.  See the file COPYING.LIB for copying
conditions, and LICENSES for notices about a few contributions that require
these additional notices to be distributed.  License copyright years may be
listed using range notation, e.g., 1996-2015, indicating that every year in
the range, inclusive, is a copyrightable year that would otherwise be listed
individually.