e196d31917
getrandom.2: Clarify that getrandom() is not "reading" from /dev/{random,urandom}
...
The existing text is a little confusing, since it somewhat
suggests that getrandom() "reads" from the /dev/random and
/dev/urandom devices. Rather, it is drawing from the same
pools as those devices. Reword the text to clarify that.
Plus a few other wording improvements.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
b4a9630f4b
getrandom.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
724d21bbb8
random.4: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
311edc011a
getrandom.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
c35966b125
getrandom.2: Note advantages of fact that getrandom() doesn't use file descriptors
...
Inspired by Nikos Mavrogiannopoulos's post at
http://nmav.gnutls.org/2016/10/random-generator-linux.html
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
2e1f8bfa17
getrandom.2, random.4: Consolidate and improve discussion on usage of randomness
...
Currently, recommendations on how to consume randomness are
spread across both getrandom(2) and random(4) and the general
opinion seems to be that the text in getrandom(2) does a
somewhat better job. Consolidate the discussion to a single
page (getrandom(2)) and address some of the concerns
expressed about the existing text in random(4).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
4818990d09
random.4: Minor tweak to discussion of /dev/urandom, blocking reads, and signals
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
dbf63eed2d
random.4: Improve discussion of /dev/urandom, blocking reads, and signals
...
The text currently states that O_NONBLOCK has no effect for
/dev/urandom, which is true. It also says that reads from
/dev/urandom are nonblocking. This is at the least confusing.
If one attempts large reads (say 10MB) from /dev/urandom
there is an appreciable delay, and interruption by a signal
handler will result in a short read. Amend the text to
reflect this.
Reviewed-by: Laurent Georget <laurent.georget@supelec.fr>
Reviewed-by: Theodore Ts'o <tytso@mit.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
1d99db5f09
udplite.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:46:13 +01:00
2941a9b709
localedef.1: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:41:35 +01:00
b64fbdca61
user_namespaces.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:38:06 +01:00
37fa8a5ae1
ldconfig.8: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:36:15 +01:00
e613d016ad
ld.so.8: wrcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:35:38 +01:00
d51fc363eb
udp.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:34:52 +01:00
d70877837a
socket.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:34:08 +01:00
d4c45a8e43
ipv6.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:33:18 +01:00
82d28cfa21
ip.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:32:09 +01:00
4e9362fe4b
inotify.7: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:30:27 +01:00
e8840edfbd
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:29:14 +01:00
f12f1b9b0b
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:27:58 +01:00
54c7242d7d
elf.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:23:22 +01:00
7903974202
dlopen.3: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:20:54 +01:00
b50a708ba6
wait.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:20:27 +01:00
68246229ba
send.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:09:30 +01:00
fcc4f4f456
perf_event_open.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:08:56 +01:00
3f06ade3af
mmap.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:08:31 +01:00
721381be5b
quotactl.2: tfix
2016-11-10 20:28:38 +01:00
388ee0f4b6
random.4: Rework formatting of /proc interfaces
...
Make the information easier to parse by formatting the file
descriptions as hanging lists. No significant content changes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 13:48:48 +01:00
af0b099051
random.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 13:48:48 +01:00
82f0a1f9b5
random.4: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 13:48:48 +01:00
debb291e3f
random.4: Minor wording fixes
...
Reviewed-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 13:48:48 +01:00
f64f220c5e
random.4: Minor tweaks to Nikos Mavrogiannopoulos's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 12:38:58 +01:00
67b7fcba2b
random.4: Provide a more accurate description of /dev/urandom
...
This documents the "property" of /dev/urandom of being able to
serve numbers prior to pool being initialized, and removes any
suggested usages of /dev/random which are disputable
(i.e., one-time pad). Document the fact /dev/random is only
suitable for applications which can afford indeterminate delays
since very few applications can do so. Smooth the alarming
language about a theoretical attack, and mention that its
security depends on the cryptographic primitives used by the
kernel, as well as the total entropy gathered.
Reviewed-by: Laurent Georget <laurent@lgeorget.eu>
Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
2016-11-10 12:24:41 +01:00
2e3cf491f1
utime.2, utimensat.2: SEE ALSO: add touch(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:23:38 +01:00
37ad14c2fb
utmp.5: SEE ALSO: add users(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:21:04 +01:00
160b2e8799
ttyname.3: SEE ALSO: add tty(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:19:56 +01:00
2a47cc96ba
getlogin.3: SEE ALSO: add logname(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:18:16 +01:00
e20370e4c2
unlink.2: SEE ALSO: add unlink(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:16:27 +01:00
792f20ea4a
gethostname.2: SEE ALSO: add hostname(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:13:12 +01:00
0c28210ecb
kill.2: SEE ALSO: add kill(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:13:12 +01:00
9bab77a4a4
chroot.2: SEE ALSO: add chroot(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:13:12 +01:00
1bf54566e6
chown.2: SEE ALSO: add chgrp(1) and chown(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:13:12 +01:00
3dd7a7eeea
chmod.2: SEE ALSO: add chmod(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:05:49 +01:00
34e922812e
mount.2: SEE ALSO: add mountpoint(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 09:11:01 +01:00
1ce611a3c2
adjtimex.2, clock_getres.2, gettimeofday.2: SEE ALSO: add hwclock(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 09:07:48 +01:00
9f1002a1c4
proc.5: Mention lslocks(8) in discussion of /proc/locks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 08:55:19 +01:00
d097377b9d
symlink.2: SEE ALSO: add namei(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 08:50:40 +01:00
dac9acbf99
credentials.7: SEE ALSO: add setpriv(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 08:33:46 +01:00
5501509f34
mq_open.3: Rework details in Eugene Syromyatnikov's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 08:32:54 +01:00
c8665710a3
mq_open.3: clarification regarding usage of mq_flags attribute in mq_open()
2016-11-10 08:23:18 +01:00
Michael Kerrisk