Michael Kerrisk
bb02bcefe9
random.4: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-15 07:05:53 +01:00
Michael Kerrisk
8888079cca
random.4: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
e6e258366d
random.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
c5d010ebd6
random.4: wfix
...
The word "very" here is overkill, and inclines the reader to
think that /dev/urandom is inferior.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
379df7a0ec
random.4: Add reference to new random(7) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
6a0c1add49
random.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
daaeba959c
random.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
724d21bbb8
random.4: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-12 12:22:10 +01:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
af0b099051
random.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 13:48:48 +01:00
Michael Kerrisk
82f0a1f9b5
random.4: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 13:48:48 +01:00
Michael Kerrisk
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
Michael Kerrisk
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
Nikos Mavrogiannopoulos
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
Michael Kerrisk
f64cc74595
killpg.2, crypt.3, mbsinit.3, printf.3, rpc.3, ulimit.3, wprintf.3, xdr.3, fd.4, elf.5, group.5: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-12 16:03:38 +02:00
Michael Kerrisk
789353dadf
console_ioctl.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-12 08:52:07 +02:00
Michael Kerrisk
baf6737ea9
console_ioctl.4: Add brief descriptive text for KDGKBMODE modes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-12 08:50:13 +02:00
Miroslav Koskar
cdfa5c7f8e
console_ioctl.4: Add K_OFF keyboard mode
...
In addition to the already documented keyboard modes (K_RAW, K_XLATE,
K_MEDIUMRAW, and K_UNICODE) there is also K_OFF one, defined for
KDGKBMODE and KDSKBMODE ioctl requests in <linux/kd.h>.
2016-10-12 08:41:47 +02:00
Michael Kerrisk
b8efb41432
memusage.1, memusagestat.1, pldd.1, accept.2, adjtimex.2, arch_prctl.2, bdflush.2, bpf.2, close.2, epoll_ctl.2, epoll_wait.2, execve.2, execveat.2, fanotify_init.2, fanotify_mark.2, fcntl.2, fsync.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getrandom.2, getrlimit.2, getrusage.2, getsid.2, getunwind.2, io_getevents.2, ioctl_fat.2, kexec_load.2, killpg.2, listxattr.2, lseek.2, madvise.2, memfd_create.2, mknod.2, mlock.2, modify_ldt.2, msgctl.2, msgget.2, msgop.2, readlink.2, readv.2, reboot.2, recvmmsg.2, rename.2, request_key.2, restart_syscall.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, seccomp.2, select_tut.2, semctl.2, semget.2, semop.2, set_thread_area.2, seteuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigprocmask.2, stat.2, symlink.2, syscall.2, sysctl.2, unlink.2, bindresvport.3, byteorder.3, dlopen.3, endian.3, error.3, ffs.3, fmemopen.3, getcwd.3, getlogin.3, getnetent.3, getprotoent.3, getservent.3, getumask.3, getutent.3, glob.3, isalpha.3, lio_listio.3, login.3, mbsinit.3, mbstowcs.3, mbtowc.3, mkstemp.3, nextup.3, ntp_gettime.3, posix_fallocate.3, posix_spawn.3, pthread_join.3, pthread_rwlockattr_setkind_np.3, random.3, rcmd.3, realpath.3, resolver.3, setjmp.3, setnetgrent.3, sigvec.3, strerror.3, strverscmp.3, system.3, toupper.3, towlower.3, towupper.3, wcstombs.3, wordexp.3, cciss.4, loop.4, mouse.4, random.4, core.5, group.5, hosts.5, resolv.conf.5, ascii.7, environ.7, epoll.7, glob.7, ip.7, mq_overview.7, packet.7, pipe.7, raw.7, sched.7, signal.7, socket.7, symlink.7, ld.so.8, sln.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-08 14:08:23 +02:00
Michael Kerrisk
6f858d5ccc
lirc.4, proc.5, netlink.7: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:42:20 +02:00
Michael Kerrisk
82bf58ade7
initrd.4: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 10:56:42 +01:00
Michael Kerrisk
5e19dee2b7
initrd.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 10:56:42 +01:00
Michael Kerrisk
e722b67cbe
mouse.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 08:12:09 +01:00
Michael Kerrisk
f7e09ea961
mouse.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 08:12:09 +01:00
Michael Kerrisk
02f47ea7ca
lp.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 08:12:09 +01:00
Michael Kerrisk
999f6d03db
mouse.4: Eliminate groff "cannot adjust line" warnings
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-12 07:14:42 +12:00
Michael Kerrisk
69f351b0bc
loop.4: Fix section ordering
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:15 +10:00
Michael Kerrisk
d830b8be07
cciss.4: Fix order of SEE ALSO entries
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:14 +10:00
Michael Kerrisk
a46e3ad25e
cciss.4: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:14 +10:00
Michael Kerrisk
59732c2a92
random.4: Fix order of SEE ALSO entries
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:14 +10:00
Michael Kerrisk
228234e4c9
console_ioctl.4: Order ERRORS alphabetically
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:13 +10:00
Michael Kerrisk
3df541c0e6
ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-17 18:10:19 +02:00
Michael Kerrisk
5231e1bb72
console_ioctl.4: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-16 12:42:06 +02:00
Michael Kerrisk
40c7eed4ef
console_ioctl.4: The argument to KDGETMODE is an 'int'
...
As reported by Chris:i
The manual entry for KDGETMODE specifies "argp points to
a long which is set to one of the above values." At least
on x86_64-bit Fedora24, the text should probably specify
argp is an int (32-bit), rather than a long (64-bit).
[To verify:]
Open a file descriptor to the local console, and execute
some code like the following:
long arg = -1;
if (-1 == ioctl(fd, KDGETMODE, &arg)) { return -1; }
printf("KDGETMODE: 0x%lx\n", arg);
Now try this version:
int arg = -1;
if (-1 == ioctl(fd, KDGETMODE, &arg)) { return -1; }
printf("KDGETMODE: 0x%x\n", arg);
Result:
The first version gives this result:
KDGETMODE: 0xffffffff00000001
The second version gives this result:
KDGETMODE: 0x1
Reading the kernel source confirms this point.
Reported-by: Chris Gassib <position0x45@hotmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-16 12:32:19 +02:00
Jakub Wilk
076d4cd970
rtc.4: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-07-07 12:10:10 +02:00
Michael Kerrisk
9787e2b681
st.4: wfix + srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 11:32:33 +02:00
Michael Kerrisk
401117dc5d
st.4: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-08 11:30:34 +02:00
Kai Mäkisara
8661af1103
st.4: Update MTMKPART for kernels >= 4.6
...
Update the description of the MTMKPART operation of MTIOCTOP to match
the changes in kernel version 4.6 (commit
8038e6456a3e6f5c4759e0d73c4f9165b90c93e7)
Signed-off-by: Kai Mäkisara <kai.makisara@kolumbus.fi>
2016-06-08 11:29:41 +02:00
Kai Mäkisara
34ba508b82
st.4: Fix description of read() when block is larger than request
...
Fix the description of read() in variable block mode if the next
block is larger than the requested byte count: error is returned
(as already documented with ENOMEM; better to complete the change
later than never ?-)
Signed-off-by: Kai Mäkisara <kai.makisara@kolumbus.fi>
2016-06-08 11:27:47 +02:00
Jakub Wilk
d1f84ed72a
clone.2, confstr.3, hpsa.4, tcp.7: tfix
...
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-06-08 11:24:08 +02:00
Marko Myllynen
d010c9c02f
console_codes.4, console_ioctl.4, tty.4, vcs.4, charsets.7: Remove console(4) references
...
Hi Michael,
0f9e647
removed the obsolete console(4) page but we still have few
references to it. The patch below removes them or converts to refs
to concole_ioctl(4) where appropriate.
2016-06-01 10:20:03 -05:00
Michael Kerrisk
2dcd302656
lirc.4: Minor fixes to Alec's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-05-29 06:42:45 -05:00
Alec Leamas
f625b7284e
lirc.4: Update after upstreamed lirc.h, bugfixes.
...
The lirc.h header has landed in the kernel, and the kernel docs
has been updated all of which reflected in this patch.
Here is still an open issue with duplicated info in the kernel
docs and the manpage. Eventually, this should be addressed but
I frankly don't know how. In the meantime, acknowledge the fact
that the kernel docs is the ultimate source
2016-05-26 16:19:19 -05:00
Michael Kerrisk
9a40ea4194
lirc.4: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-17 11:31:16 +13:00
Dr. Tobias Quathamer
c219eb530a
lirc.4: srcfix: add missing .TH line
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-17 11:30:33 +13:00
Michael Kerrisk
0f9e6478e4
console.4: Remove outdated page
...
This page has seen no significant updates in 20 years,
and is no correct or up to date. iReportedly, Debian
no longer carries it. The simplest solution seems to
be to delete it.
See https://bugzilla.kernel.org/show_bug.cgi?id=110481
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 21:38:25 +13:00
Michael Kerrisk
979867082b
locale.1, localedef.1, _exit.2, accept.2, access.2, acct.2, adjtimex.2, bdflush.2, bind.2, bpf.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_ctl.2, eventfd.2, execve.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, gettimeofday.2, init_module.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, kexec_load.2, kill.2, killpg.2, link.2, listen.2, llseek.2, lseek.2, madvise.2, memfd_create.2, mincore.2, mkdir.2, mknod.2, mmap.2, mount.2, nanosleep.2, nice.2, open.2, personality.2, pipe.2, poll.2, posix_fadvise.2, read.2, readahead.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, sched_setaffinity.2, sched_setattr.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendfile.2, sendmmsg.2, seteuid.2, setns.2, setpgid.2, setreuid.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigsuspend.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, symlink.2, sync.2, syscall.2, syscalls.2, times.2, truncate.2, unlink.2, unshare.2, uselib.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, write.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_read.3, aio_write.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, backtrace.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, clog10.3, cmsg.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, errno.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, fts.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getmntent.3, getnameinfo.3, getnetent_r.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getutent.3, getw.3, gsignal.3, hypot.3, ilogb.3, inet.3, initgroups.3, insque.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, makedev.3, matherr.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, on_exit.3, open_memstream.3, opendir.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_setaffinity_np.3, putenv.3, putpwent.3, qecvt.3, rand.3, random.3, random_r.3, rcmd.3, readdir.3, realpath.3, remainder.3, remquo.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strftime.3, strlen.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wprintf.3, y0.3, pts.4, st.4, tty_ioctl.4, elf.5, gai.conf.5, group.5, locale.5, nsswitch.conf.5, proc.5, utmp.5, aio.7, capabilities.7, credentials.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, mq_overview.7, namespaces.7, pipe.7, signal.7, socket.7, standards.7, svipc.7, symlink.7, time.7, unicode.7, unix.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-15 17:30:43 +13:00