Commit Graph

548 Commits

Author SHA1 Message Date
Michael Kerrisk faaf38b615 fuse.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 660bc76cdd fuse.4: Tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Keno Fischer 4085d7ab46 fuse.4: Address FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk ac3c78bdde fuse.4: Remove FUSE_* constant values
No need to show the values of the FUSE_* constants, I believe.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 2949f098a3 fuse.4: Add list of undocumented messages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 0bc65f952c fuse.4: Add list of FOPEN_* flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk a2027c8fb7 fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 7099221801 fuse.4: Add SEE ALSO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk abf2a19d72 fuse.4: Add CONFORMING TO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 996925d5ab fuse.4: Repair ENODEV description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 551e8425de fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk f8fe67a15d fuse.4: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 83b87d658b fuse.4: Small rewording in FUSE_INIT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 53c028d171 fuse.4: Repair wording in EINVAL error text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
Michael Kerrisk 3280cb6ba5 fuse.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk 5d69a98a99 fuse.4: fuse_entry_out: rework discussion of uniqueness of nodeid + generation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk 7260a6e1e8 fuse.4: Various minor edits to Keno Fischer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk 72e830cc18 fuse.4: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Michael Kerrisk b03c828e1f fuse.4: Kill information about FUSE header license
I'd say this is fair use (many other man pages do the same).
So, no need to clutter the man page source with this information.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
Keno Fischer 5963519cfe fuse.4: New page describing /dev/fuse
This is my writeup of a basic description of /dev/fuse after
playing with it for a few hours today. It is of course woefully
incomplete, and since I neither have a use case nor am working
on this code, I will not be in a position to expand it in the
near future. However, I'm hoping this could still serve as a
handy reference for others looking at this interface.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:34:59 +01:00
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