aboutsummaryrefslogtreecommitdiffstats
path: root/man7
AgeCommit message (Collapse)AuthorFilesLines
2021-08-09unix.7: tfixŠtěpán Němec1-1/+1
Signed-off-by: Štěpán Němec <stepnem@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-09man-pages.7: wfixG. Branden Robinson1-1/+1
Saw this while preparing the "switch to \~" change Alex invited. Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-09namespaces.7: ffixMichael Weiß1-1/+2
Signed-off-by: Michael Weiß <michael.weiss@aisec.fraunhofer.de> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-09readv.2, pipe.7: Make text on pipe writes more general to avoid a confusion ↵Michael Kerrisk1-3/+1
in writev(2) After a patch proposal from наб triggered by concerns that, when talking about PIPE_BUF, pipe(7) explicitly mentions write(2) but not writev(2), I've concluded that the reference in writev(2) to pipe(7) is not needed (mea culpa; I added that text), and I think the text in pipe(7) could be written to be closer to the POSIX spec, which doesn't talk about "write() calls", but simply about "writes". Reported-by: наб <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08capabilities.7, user_namespaces.7: Minor tweaks (part 2) to Kir Kolyshkin's ↵Michael Kerrisk2-5/+5
patch Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08capabilities.7: Minor tweaks to Kir's patchAlejandro Colomar1-2/+3
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08capabilities.7, user_namespaces.7: Describe CAP_SETFCAPKir Kolyshkin2-0/+12
mtk: The kernel commit message is quite enlihtening: commit db2e718a47984b9d71ed890eb2ea36ecf150de18 Author: Serge E. Hallyn <serge@hallyn.com> Date: Tue Apr 20 08:43:34 2021 -0500 Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08vdso.7: Minor tweak to Alejandro Colomar's patchMichael Kerrisk1-1/+1
The correct kernel version seems to 5.11, not 5.10: $ git describe --contains d0e3fc69d00d v5.11-rc1~76^2~251 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08vdso.7: Add y2038 compliant gettime for ppc/32Alejandro Colomar1-0/+1
Christophe Leroy via Bugzilla: https://bugzilla.kernel.org/show_bug.cgi?id=213421 [ In ppc32 functions section, the Y2038 compliant function __kernel_clock_gettime64() is missing. It was added by commit d0e3fc69d00d ("powerpc/vdso: Provide __kernel_clock_gettime64() on vdso32") ] .../linux$ git describe d0e3fc69d00d v5.10-rc2-76-gd0e3fc69d00d Reported-by: Christophe Leroy <christophe.leroy@csgroup.eu> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08posixoptions.7: Fix legacy functions list (s/getcwd/getwd/)Alejandro Colomar1-1/+1
Alan: [ The on-line copy of the manual page "posixoptions(7)" dated 2018-04-30 has an entry for "getcwd()" in the section headed "XSI - _XOPEN_LEGACY - _SC_XOPEN_LEGACY". I believe that entry should be "getwd()" as that is the API call which was present in X/Open-6 but withdrawn in X/Open-7. ] mtk: confirmed by reviewing the table ("Removed Functions and Symbols in Issue 7") at the end of Section B.1.1 on page 3564 of IEEE Std 1003.1, 2016 Edition. Reported-by: Alan Peakall <Alan.Peakall@helpsystems.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08vdso.7: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08vdso.7: Update CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE info for powerpcMichael Kerrisk1-2/+6
See https://bugzilla.kernel.org/show_bug.cgi?id=213419 ppc/32 and ppc/64 sections both have the following note: The CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE clocks are not supported by the __kernel_clock_getres and __kernel_clock_gettime interfaces; the kernel falls back to the real system call This note has been wrong from quite some time now, since commit 654abc69ef2e ("powerpc/vdso32: Add support for CLOCK_{REALTIME/MONOTONIC}_COARSE") and commit 5c929885f1bb ("powerpc/vdso64: Add support for CLOCK_{REALTIME/MONOTONIC}_COARSE") Reported-by: Christophe Leroy <christophe.leroy@csgroup.eu> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08namespaces.7: Fix confusion caused by text reorganizationŠtěpán Němec1-2/+2
Since commit ee81d7e41852, the flags list has been (only) above, not below, these references. (The flags table was added even before that, in commit 0b497138b908 ("namespaces.7: Add table of namespaces to top of page")) Fixes: ee81d7e41852 ("namespaces.7: Include manual page references in the summary table of namespace types") Signed-off-by: Štěpán Němec <stepnem@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08ascii.7: ffix: add vertical rule to separate the two columnsнаб1-1/+1
I regularly get mildly lost in this table (and, indeed, didn't realise it had two columns the first few times I used it to look at something from the left column) ‒ separating the two columns improves clarity, and makes which soup of numbers belongs to which character much more obvious Other encodings don't need this as they don't use double-columnated tables Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-07user_namespaces.7: Fix a reference to a kernel documentKir Kolyshkin1-1/+1
The file being referred to no longer exists, as it was moved to *.rst first (commit 20a78ae9ed297f2) and then to under admin-guide (commit bf6b7a742e3f82b). Both those commits are from 2019 (Linux 5.3). Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-07capabilities.7: tfixKir Kolyshkin1-1/+1
Add a missing comma. Fixes: 3dcdef9437fafb Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-07path_resolution.7: tfixŠtěpán Němec1-1/+1
Signed-off-by: Štěpán Němec <stepnem@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-07Various pages: Consistently use '*argv[]'Thomas Voss1-1/+1
Scripted change: $ find man? -type f \ | sed -i 's/int argc, char \*\*argv/int argc, char \*argv\[\]/'; Signed-off-by: Thomas Voss <thomasavoss@protonmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-07-26sysvipc.7: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-07-26hier.7: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-07-26environ.7: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-07-26unicode.7: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-07-26uri.7: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-07-25pid_namespaces.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-22exit_group.2, ioprio_set.2, process_madvise.2, seccomp_unotify.2, ↵Michael Kerrisk1-1/+1
set_mempolicy.2, set_tid_address.2, bswap.3, kernel_lockdown.7: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10cmsg.3, unix.7: Refer to seccomp_unotify(2) for an example of SCM_RIGHTS usageMichael Kerrisk1-3/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10signal.7: Add reference to seccomp_unotify(2)Michael Kerrisk1-0/+9
The seccomp user-space notification feature can cause changes in the semantics of SA_RESTART with respect to system calls that would never normally be restarted. Point the reader to the page that provide further details. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10system_data_types.7: Minor enhancement of description of mode_tMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10system_data_types.7: Add 'mode_t'Alejandro Colomar1-0/+29
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10system_data_types.7: Add 'blksize_t'Alejandro Colomar1-0/+19
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10system_data_types.7: Add 'cc_t'Alejandro Colomar1-0/+17
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10system_data_types.7: Add 'blkcnt_t'Alejandro Colomar1-0/+19
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10kernel_lockdown.7: Remove additional text alluding to lifting via SysRqdann frazier1-3/+0
My previous patch intended to drop the docs for the lockdown lift SysRq, but it missed this other section that refers to lifting it via a keyboard - an allusion to that same SysRq. Signed-off-by: dann frazier <dann.frazier@canonical.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-06-10kernel_lockdown.7: Remove description of lifting via SysRq (not upstream)dann frazier1-5/+0
The patch that implemented lockdown lifting via SysRq ended up getting dropped[*] before the feature was merged upstream. Having the feature documented but unsupported has caused some confusion for our users. [*] http://archive.lwn.net:8080/linux-kernel/CACdnJuuxAM06TcnczOA6NwxhnmQUeqqm3Ma8btukZpuCS+dOqg@mail.gmail.com/ Signed-off-by: dann frazier <dann.frazier@canonical.com> Cc: Heinrich Schuchardt <xypron.glpk@gmx.de> Cc: David Howells <dhowells@redhat.com> Cc: Pedro Principeza <pedro.principeza@canonical.com> Cc: Randy Dunlap <rdunlap@infradead.org> Cc: Kyle McMartin <kyle@redhat.com> Cc: Matthew Garrett <mjg59@google.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-05-17capabilities.7: CAP_IPC_LOCK also governs memory allocation using huge pagesMichael Kerrisk1-0/+10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-05-12capabilities.7: ffixAkihiro Motoki1-2/+2
Signed-off-by: Akihiro Motoki <amotoki@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-05-10system_data_types.7: tfixAlejandro Colomar1-3/+3
Those pages didn't exist. Fix the section number. I noticed the typo thanks to the HTML pages on man7.org. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-05-10fanotify.7: ffixAkihiro Motoki1-1/+1
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-05-10shm_overview.7: ffixAkihiro Motoki1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-04-06mount_namespaces.7, namespaces.7: Relocate reference to pam_namespace(8)Michael Kerrisk2-1/+1
SEE ALSO: move pam_namespace(8) from namespaces(7) to mount_namespaces(7) (since pam_namespace(8) makes use of mount namespaces specifically). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-04-06vsock.7: ffixMichael Kerrisk1-4/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-04-06vsock.7: ioctls are on /dev/vsock, not socketsAlyssa Ross1-1/+4
Signed-off-by: Alyssa Ross <hi@alyssa.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-04-05system_data_types.7: Add 'socklen_t'Alejandro Colomar1-0/+28
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-04-05system_data_types.7: Add 'struct sockaddr'Alejandro Colomar1-0/+25
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-04-04environ.7: Remove obsolete admonishment of the GZIP environment variableJosh Triplett1-7/+2
gzip deprecated the GZIP environment variable long ago. Signed-off-by: Josh Triplett <josh@joshtriplett.org> [ alx: srcfix ] Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-03-22getent.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, ↵Michael Kerrisk55-55/+55
mtrace.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, add_key.2, adjtimex.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, bpf.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, close_range.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, fanotify_init.2, fanotify_mark.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_rm_watch.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_fslabel.2, ioctl_getfsmap.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, openat2.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pidfd_getfd.2, pidfd_open.2, pidfd_send_signal.2, pipe.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, request_key.2, restart_syscall.2, rmdir.2, rt_sigqueueinfo.2, s390_guarded_storage.2, s390_pci_mmio_write.2, s390_runtime_instr.2, s390_sthyi.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_thread_area.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, stime.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cexp2.3, cfree.3, cimag.3, circleq.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, fileno.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fopencookie.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getutmp.3, getw.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, group_member.3, gsignal.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, isalpha.3, isatty.3, isfdtype.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, list.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_hook.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, psignal.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setsigmask_np.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_mutex_consistent.3, pthread_mutexattr_getpshared.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_spin_init.3, pthread_spin_lock.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, readdir_r.3, realpath.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sincos.3, sinh.3, sleep.3, slist.3, sockatmark.3, sqrt.3, stailq.3, statvfs.3, stdarg.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tailq.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console_codes.4, dsp56k.4, hpsa.4, initrd.4, loop.4, lp.4, msr.4, random.4, rtc.4, smartpqi.4, veth.4, wavelan.4, acct.5, core.5, elf.5, hosts.5, locale.5, proc.5, resolv.conf.5, rpc.5, slabinfo.5, sysfs.5, tmpfs.5, utmp.5, address_families.7, aio.7, attributes.7, bootparam.7, capabilities.7, cgroups.7, complex.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, hier.7, inode.7, inotify.7, ip.7, ipv6.7, keyrings.7, locale.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, namespaces.7, netdevice.7, netlink.7, numa.7, packet.7, pkeys.7, pthreads.7, queue.7, raw.7, rtnetlink.7, sched.7, session-keyring.7, shm_overview.7, sigevent.7, signal-safety.7, signal.7, sock_diag.7, socket.7, spufs.7, symlink.7, system_data_types.7, tcp.7, time_namespaces.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, user_namespaces.7, vdso.7, vsock.7, x25.7, iconvconfig.8, ld.so.8, ldconfig.8, sln.8, tzselect.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-03-21user_namespaces.7: CAP_SYS_ADMIN now allows mounting of overlayfs fileseystemsMichael Kerrisk1-0/+5
Reported by: Szunti <szunti@gmail.com> Reported by: Dmitry V. Levin <ldv@altlinux.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-03-03inode.7: tfixAlejandro Colomar1-1/+1
Epoch is 1970-01-01 00:00:00 +0000, UTC (see time(7)). Reported-by: Walter Franzini <walter.franzini@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-02-21netlink.7: Clarify details of netlink error responsesPhilipp Schuster1-1/+13
Make it clear that netlink error responses (i.e., messages with type NLMSG_ERROR (0x2)), can be longer than sizeof(struct nlmsgerr). In certain circumstances, the payload can be longer. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-02-20time_namespaces.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-02-15simpleq.3, stailq.3, queue.7, SIMPLEQ_*.3: Document SIMPLEQ_*() as an alias ↵Alejandro Colomar1-0/+9
to STAILQ_*() macros Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-02-12shm_overview.7: SEE ALSO: add memfd_create(2)Michael Kerrisk1-0/+1
People interested POSIX shared memory may also be interested in memfd and file sealing. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-02-09netdevice.7: wfixMichael Kerrisk1-2/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-02-09netdevice.7: ffixMichael Kerrisk1-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: Minor tweaks to Bastien's patchMichael Kerrisk1-4/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: Reorder the textBastien Roucariès1-43/+52
Move the the text describing how to set environment variable before the list(s) of variables in order to improve readability. [mtk: rewrote commit message] Signed-off-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: Note the default if PAGER is not definedMichael Kerrisk1-0/+7
Reported-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: ffix + tfixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: Various edits to Bastien Roucariès's patchMichael Kerrisk1-15/+12
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: Document that HOME, LOGNAME, SHELL, USER are set at login timeBastien Roucariès1-4/+30
Clearly document that HOME, LOGNAME, SHELL and USER are set at login time by a program like such as login(1). Document also that using su could result in a mixed environment, and point to the su(1) manual page. [mtk: edited commit message] Signed-off-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: wfixMichael Kerrisk1-2/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: Improve the description of PATHMichael Kerrisk1-2/+16
Add more details of how PATH is used, and mention the legacy use of an empty prefix. Changed after a suggested patch by Bastien Roucariès. Reported-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-30environ.7: wfix in description of PATHMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28netdevice.7: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28netdevice.7: Update documentation for SIOCGIFADDR SIOCSIFADDR SIOCDIFADDRPali Rohár1-9/+55
Unlike SIOCGIFADDR and SIOCSIFADDR which are supported by many protocol families, SIOCDIFADDR is supported by AF_INET6 and AF_APPLETALK only. Unlike other protocols, AF_INET6 uses struct in6_ifreq. Cc: Dmitry V. Levin <ldv@altlinux.org> Cc: <netdev@vger.kernel.org> Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28man-pages.7: tfixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28uri.7: tfix (logical quoting style)Michael Kerrisk1-1/+1
Reported-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28man.7: tfix (logical quoting style)Michael Kerrisk1-1/+1
Reported-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28man-pages.7: tfixJakub Wilk1-1/+1
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28environ.7: Minor tweaks to Bastien's patchMichael Kerrisk1-4/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28environ.7: Document convention of string in environBastien Roucariès1-1/+7
Document the name=value system and that nul byte is forbidden. Signed-off-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28environ.7: Minor fixes to Bastien's patchMichael Kerrisk1-2/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28environ.7: Add see also ld.so(8) for LD_ variablesBastien Roucariès1-1/+2
Signed-off-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28environ.7: Be a little more precise when discussing 'exec'Michael Kerrisk1-2/+2
Say "execve(2)" instead of "exec(3)", and note that this step starts a new program (not a new process!). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-28environ.7: Relocate and reword the mention of _GNU_SOURCEMichael Kerrisk1-6/+12
Using _GNU_SOURCE to obtain the declaration of 'environ' is nonstandard. Therefore, move the mention of this detail to NOTES. At the same time, add a few words proposed by Bastien. Cowritten-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-25man-pages.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-25man-pages.7: Add a FORMATTING AND WORDING CONVENTIONS sectionMichael Kerrisk1-0/+95
In man-pages-5.11, a large number of pages were edited to achieve greater consistency in the SYNOPIS, RETURN VALUE and ATTRIBUTES sections. To avoid future inconsistencies, try to capture some of the preferred conventions in text in man-pages(7). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-25sock_diag.7: Fix recvmsg() usage in the examplePali Rohár1-3/+6
The msg_name field for recvmsg() call points to a caller-allocated buffer nladdr that is used to return the source address of the (netlink) socket. As recvmsg() does not read this buffer and fills it for a caller, do not initialize it and instead check its value in the example. Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-23uri.7: Note that 'logical' quoting is the norm in EuropeMichael Kerrisk1-6/+1
Drop the reference to the Hacker Writing Guide (and the broken URL) and simply note that the logical quoting style is the norm in European languages also. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21man-pages.7: Note some rationale for the use of real minus signsMichael Kerrisk1-0/+10
See: https://lore.kernel.org/linux-man/20210121061158.5ul7226fgbrmodbt@localhost.localdomain/ From: "G. Branden Robinson" <g.branden.robinson@gmail.com> Cc: linux-man <linux-man@vger.kernel.org>, groff@gnu.org Subject: Re: Escaping hyphens ("real" minus signs in groff) Date: Thu, 21 Jan 2021 17:12:00 +1100 and also groff_char(7). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21Various pages: use "\-" to generate real minus in circumstances where ↵Michael Kerrisk11-19/+19
appropriate Use \- for math formulas, pathnames, manual page cross references, etc. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21inotify.7: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21mq_overview.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21Various pages: use real minus signs in pathnamesMichael Kerrisk14-28/+28
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21Various pages: Inside code blocks (.EX/.EE) use \- to get real minus signsMichael Kerrisk12-27/+27
A real minus can be cut and pasted... THere are a few exceptions that gave been excluded in the this change. For example, where there' is a string such as "<p1-name>", where p1-name is soome sort of pseudo-identifier. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-20tcp.7: Documentation revision for TCP_USER_TIMEOUTEnke Chen1-1/+2
mtk: Enke later noted that this patch provides better documentation of longstanding behavior (rather documenting a change in behavior). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-20environ.7: Document valid values of pathnames for SHELL, PAGER and EDITOR/VISUALBastien Roucariès1-1/+7
The environ(7) man page says: SHELL The pathname of the user's login shell. PAGER The user's preferred utility to display text files. EDITOR/VISUAL The user's preferred utility to edit text files. but doesn't say whether the pathnames must be absolute or they can be resolved using $PATH, or whether they can have options. Note that at least for SHELL, this is not specified by POSIX. This issue was raised in the Austin Group mailing-list, and the answer is that "what constitutes a valid value for a platform should be documented" [1]. Since OpenSSH assumes that $SHELL is an absolute pathname (when set), it is supposed that the documentation should be: SHELL The absolute pathname of the user's login shell. For PAGER, POSIX says: "Any string acceptable as a command_string operand to the sh -c command shall be valid." For EDITOR, it does not need to be an absolute pathname since POSIX gives the example: EDITOR=vi fc and since it is specified as "the name of a utility", It assumes that arguments (options) must not be provided. Page 3013 about "more", it is said: "If the last pathname component in EDITOR is either vi or ex, [...]", thus again, it is assumed to be a pathname. For VISUAL, POSIX says: "Determine a pathname of a utility to invoke when the visual command [...]", thus it is also a pathname. It is not clear whether the pathname must be absolute, but for consistency with EDITOR, it will be resolved using $PATH. [1] https://www.mail-archive.com/austin-group-l@opengroup.org/msg01399.html Reported-by: Vincent Lefevre <vincent@vinc17.net> Signed-off-by: Bastien Roucaries <rouca@debian.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-19man-pages.7: Document "acknowledgement" as the preferred spellingMichael Kerrisk1-0/+5
When I inherited man-pages in 2004, it was a hodge-podge mix of American vs British spelling. My native spelling is the latter, but I value consistency and felt that things needed to be standardized on one or other, and in computing, American is the norm so that is what I settled on. Among the changes was the substitution of various instances of "acknowledgement" for "acknowledgment". The latter spelling is not one I care for, but I believed it to be the American norm. Alex Colomar proposed a patch to change the spelling back to "acknowledgement", and some discussion and investigation ensued, whereby I learned the following: * The situation is not clear cut. * Historically, "acknowledgment" was the norm in British English, but was eclipsed by "acknowledgement" some decades ago. * Even in American English, "acknowledgment" is not universal, and "acknowledgement" has become more common in recent decades (although it still remains minority usage) [2]. * The BSD license uses "acknowledgement" even though it was (presumably) written in California. * The POSIX standard uses "acknowledgement". * The Debian BTS uses "acknowledgement". * Looking at a corpus of manual pages from various systems that I have assembled over the years, "acknowledgement" seems a little more common than "acknowledgment". Summary: the situation is not clear cut, but let's follow BSD, POSIX, and the personal preference of the man-pages maintainers. [1] https://books.google.com/ngrams/graph?content=acknowledgment%2Cacknowledgement&year_start=1800&year_end=2019&corpus=29&smoothing=3# [2] https://books.google.com/ngrams/graph?content=acknowledgment%2Cacknowledgement&year_start=1800&year_end=2000&corpus=5&smoothing=3& Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-19netlink.7, tcp.7: Spelling fix: s/acknowledgment/acknowledgement/Alejandro Colomar2-9/+9
Signed-off-by: Alejandro Colomar (man-pages) <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-18pipe.7: tfixJakub Wilk1-9/+9
Escape hyphens in pathnames, as per man-pages(7) Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-17netlink.7: Fix minimal Linux version for NETLINK_CAP_ACKPali Rohár1-1/+1
NETLINK_CAP_ACK option was introduced in commit 0a6a3a23ea6e which first appeared in Linux version 4.3 and not 4.2. Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-17rtnetlink.7: Remove IPv4 from descriptionPali Rohár1-1/+1
rtnetlink is not only used for IPv4 Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-10Various pages: srcfix: Remove redundant .PPAlejandro Colomar7-18/+0
.PP are redundant just after .SH or .SS. Remove them. $ find man? -type f \ |xargs sed -i '/^\.S[HS]/{n;/\.PP/d}'; Plus a couple manual edits. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-10Revert "stailq.3, utmp.5, time_namespaces.7: srcfix: remove redundant .PP"Michael Kerrisk1-0/+1
Do this in order to apply a better patch from Alex Colomar. This reverts commit f7fc28f97a1012631f835adcbfdcd3a048fa31b2.
2021-01-10stailq.3, utmp.5, time_namespaces.7: srcfix: remove redundant .PPMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09mprotect.2, readv.2, sigaltstack.2, sigreturn.2, ctime.3, scandir.3, ↵Michael Kerrisk1-2/+2
random.4, pkeys.7: ffix: s/-1/\-1/ Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09inode.7: wfixMichael Kerrisk1-1/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09Various pages: tfix (Oxford comma)Michael Kerrisk3-3/+3
Found using: git grep -lE '^[^.].*,.*,.*[^,] (and|or)\>' Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09suffixes.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09Various pages: tfix (Oxford comma)Michael Kerrisk12-20/+20
Discovered using: git grep -lE '^[^.].*, [^ ]*[^,] (or|and)\>' Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09circleq.3, list.3, slist.3, stailq.3, queue.7: tfix (Oxford comma)Michael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-08Various pages: Remove redundant "\\ " to escape spacesMichael Kerrisk1-1/+1
Reported-by: Alejandro Colomar (man-pages) <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-08msr.4, veth.4, packet.7, sched.7, unicode.7: Remove redundant .PPAlejandro Colomar3-3/+0
.PP and .IP are redundant just before .SH or .SS. Remove them. $ find man? -type f \ |xargs sed -i '/^\.[IP]P$/{N;s/.*\n\(\.S[HS]\)/\1/}'; Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-08Various pages: tfix: Use Oxford commaAlejandro Colomar1-1/+1
Found using: $ pcregrep -rnM "^\.[B|I]R .*,\n\.[B|I].*[^,]\nor" man? \ |grep ^man \ |sort; Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-08close.2, getpriority.2, ioctl_userfaultfd.2, expm1.3, lio_listio.3, rcmd.3, ↵Alejandro Colomar1-2/+2
lirc.4, mount_namespaces.7: tfix: Fix punctuation Found using: $ pcregrep -rnM '^..[^"].*[^.]\.\n[a-z]' man? Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-07netlink.7: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-07clone.2, ioctl_tty.2, syslog.2, setlocale.3, stdio.3, console_codes.4, ↵Michael Kerrisk5-40/+114
inode.7, namespaces.7, netlink.7, signal-safety.7, socket.7: Better table formatting In particular, allow for rendering in widths different from (especially less than) 80 columns. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-06man-pages.7: ffix: don't fill text in tablesMichael Kerrisk1-1/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-06man-pages.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-05futex.2, syscalls.2, vmsplice.2, bpf-helpers.7: wfix: Write consistently ↵Alejandro Colomar1-1/+1
'user space' instead of 'userspace' Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-04fanotify_init.2, fanotify.7: Minor edits to Jan Kara's patchMichael Kerrisk1-3/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-04fanotify_init.2, fanotify.7: Document FAN_AUDIT flag and FAN_ENABLE_AUDITJan Kara1-1/+8
Acked-by: Steve Grubb <sgrubb@redhat.com> Signed-off-by: Jan Kara <jack@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-04feature_test_macros.7: wfixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-04feature_test_macros.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-03Various pages: Use .nf/.fi in SYNOPSISMichael Kerrisk17-26/+34
The majority of pages use .nf/.fi in SYNOPSIS, but there are still many that don't and use .br to achieve newlines. Fix many of those. This brings greater consistency to the pages, which eases editing and may ease future scripted edits to the pages. Many of these changes were script-assisted, with some additional manual edits. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-03Various pages: Further clean-ups after "bring more whitespace consistency in ↵Michael Kerrisk2-2/+2
SYNOPSIS" Yet more clean-ups after commit 15d6565317dad749ef57e69023139bc405caab88. Reported-by: Alejandro Colomar (man-pages) <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-01system_data_types.7: Add off64_t to system_data_types(7)Alejandro Colomar1-6/+38
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-30cgroups.7: tfixJakub Wilk1-1/+1
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-30signal.7: tfixJakub Wilk1-1/+1
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-27pkeys.7: srcfix: remove redundant .PPMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-27user_namespaces.7: srcfix: remove redundant .PP after .SSMichael Kerrisk1-6/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-27fanotify.7, inotify.7: wfix: Tweak location of tag commentsMichael Kerrisk2-12/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-27ioctl_ns.2, keyctl.2, memfd_create.2, pidfd_send_signal.2, poll.2, ↵Michael Kerrisk5-36/+36
seccomp.2, signalfd.2, timerfd_create.2, unshare.2, dlinfo.3, duplocale.3, fopencookie.3, getgrouplist.3, getifaddrs.3, getprotoent_r.3, getservent_r.3, insque.3, printf.3, pthread_attr_init.3, pthread_cancel.3, pthread_create.3, pthread_mutexattr_setrobust.3, pthread_setaffinity_np.3, qsort.3, sem_wait.3, core.5, elf.5, aio.7, epoll.7, pkeys.7, system_data_types.7, unix.7: Use periods more consistently inside code comments In general, complete sentences in free-standing comments should be terminated by periods. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-27bind.2, clone.2, dup.2, futex.2, mprotect.2, open_by_handle_at.2, ↵Michael Kerrisk3-45/+45
pivot_root.2, select_tut.2, shmop.2, timer_create.2, userfaultfd.2, getaddrinfo.3, getaddrinfo_a.3, inet_net_pton.3, malloc_info.3, mbstowcs.3, newlocale.3, posix_spawn.3, pthread_sigmask.3, shm_open.3, strtol.3, inotify.7, user_namespaces.7: Add periods at end of sentences in comments Try to bring a little more consistency on the use of periods in comments in example code. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-27man-pages.7: Add some notes on comments in example codeMichael Kerrisk1-1/+9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-23seccomp.2, circleq.3, list.3, malloc_hook.3, slist.3, stailq.3, tailq.3, ↵Michael Kerrisk2-19/+19
ip.7, unix.7: tfix Remove "." at the end of sentence fragments/short single sentences in comments. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-23system_data_types.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-23Various pages: Remove explicit blank lines, replacing them with .PP when ↵Alejandro Colomar3-4/+1
appropriate Rationale: $ man 7 man-pages 2>/dev/null | sed -n /Paragraphs/,/^$/p Paragraphs should be separated by suitable markers (usually either .PP or .IP). Do not separate paragraphs using blank lines, as this results in poor rendering in some output formats (such as PostScript and PDF). Fix: $ sed -i -e '1,/^\.EX/s/^$/.PP/' -e '/^\.EE/,/^\.EX/s/^$/.PP/' man?/* And then some manual adjustments. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-21getent.1, access.2, cacheflush.2, chroot.2, clock_getres.2, fcntl.2, ↵Michael Kerrisk9-9/+9
getrusage.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, link.2, llseek.2, mmap.2, mount.2, readv.2, restart_syscall.2, semctl.2, set_mempolicy.2, set_tid_address.2, shmctl.2, sigaction.2, sigaltstack.2, spu_create.2, statfs.2, subpage_prot.2, syscalls.2, timer_getoverrun.2, uselib.2, INFINITY.3, __ppc_set_ppr_med.3, bstring.3, btree.3, ctime.3, fgetc.3, fopen.3, getcontext.3, gethostbyname.3, getnetent.3, getprotoent.3, getservent.3, inet.3, j0.3, list.3, makecontext.3, nextafter.3, posix_memalign.3, profil.3, pthread_tryjoin_np.3, puts.3, rcmd.3, resolver.3, rtime.3, sigsetops.3, strnlen.3, tailq.3, elf.5, filesystems.5, nscd.conf.5, proc.5, utmp.5, attributes.7, ipv6.7, packet.7, pthreads.7, signal-safety.7, signal.7, spufs.7, system_data_types.7, tcp.7: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-20packet.7: Update references to kernel documentationBaruch Siach1-4/+4
Files moved from .txt to .rst. Also, drop / prefix from kernel source tree references. Signed-off-by: Baruch Siach <baruch@tkos.co.il> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-20pthreads.7: ffixMichael Kerrisk1-4/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-20pthreads.7: Rephrase function list in terms of POSIX rather than SUSMichael Kerrisk1-3/+3
The list was using an inconsistent mixture of "POSIX" and "SUS". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-16mount_namespaces.7: ffixMichael Kerrisk1-7/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-13tcp.7: tcp_syncookies: It is now an integer [0, 2]Alejandro Colomar1-2/+13
Since Linux kernel 3.12, tcp_syncookies can have the value 2, which sends out cookies unconditionally. Related kernel commits: 5ad37d5deee1ff7150a2d0602370101de158ad86 d8513df2598e5142f8a5c4724f28411936e1dfc7 Reported-by: Philip Rowlands <linux-kernel@dimebar.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Cc: Eric Dumazet <eric.dumazet@gmail.com> Cc: Hannes Frederic Sowa <hannes@stressinduktion.org> Cc: David S. Miller <davem@davemloft.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-26fanotify.7: fix outdated descriptionAmir Goldstein1-3/+4
Reviewed-by: Jan Kara <jack@suse.cz> Signed-off-by: Amir Goldstein <amir73il@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-23attributes.7: SEE ALSO: add signal-safety(7)Michael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-23standards.7: Add LFS (Large File Summit)Michael Kerrisk1-0/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-21standards.7: Relocate the discussion on POSIX manual pagesMichael Kerrisk1-3/+6
Rather than mention these pages under the discussion of one version of the standard, move that text to the end of the page, where it is probably a little more obvious. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-21standards.7: Add URL for POSIX.1-2008/SUSv4Michael Kerrisk1-0/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-21standards.7: Fix some URLs for locations of the standardsMichael Kerrisk1-2/+2
Reported-by: Rob Landley <rob@landley.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-19socket.7: ffixMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-19socket.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-18signal.7: Add pidfd_send_signal() to list of APIs for sending signalsMichael Kerrisk1-0/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-18signal.7: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-17signal.7: Fixes and additions to text on execution of signal handlersMichael Kerrisk1-4/+16
After comments from Dave Martin. Reported-by: Dave Martin <Dave.Martin@arm.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-17signal.7: Mention 'ucontext_t' in the discussion of signal handler executionMichael Kerrisk1-2/+2
Linking up the info presented on this page with the discussion in getcontext(3) helps the reader. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-17makecontext.3: Minor rewordingMichael Kerrisk1-0/+7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-17signal.7: Fixes to the text of "Execution of signals handlers"Michael Kerrisk1-3/+1
See https://lore.kernel.org/linux-man/3fac10ea-7fed-739b-4974-09845f34867f@gmail.com/ Reported-by: Dave Martin <Dave.Martin@arm.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-17getcontext.3, signal.7: tfixMichael Kerrisk1-13/+18
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16man-pages.7: ffix: use a table rather .nf/.fiMichael Kerrisk1-14/+15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16queue.7: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16kernel_lockdown.7: Remove unneeded quotesMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15uname.2, feature_test_macros.7: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15getent.1, fanotify_mark.2, fcntl.2, futex.2, membarrier.2, mmap.2, mount.2, ↵Alejandro Colomar4-5/+5
msgctl.2, readv.2, semctl.2, set_mempolicy.2, shmctl.2, syscalls.2, abs.3, bstring.3, btree.3, ctime.3, drand48.3, fgetc.3, fopen.3, gethostbyname.3, getnetent.3, getprotoent.3, getservent.3, INFINITY.3, __ppc_set_ppr_med.3, inet.3, j0.3, makecontext.3, printf.3, puts.3, resolver.3, sigsetops.3, elf.5, nscd.conf.5, proc.5, inotify.7, ipv6.7, spufs.7, system_data_types.7: Use Oxford comma Found using: pcregrep -rnM "^\.[B|I]R .*,\n\.[B|I].*[^,]\nand" man? |grep ^man |sort Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15locale.5, ipv6.7: ffixAlejandro Colomar1-2/+2
[.B XX_*] is the most extended form in the pages. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-14signal-safety.7: Note async-signal-safety details for errnoMichael Kerrisk1-1/+9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-13signal.7: Minor tweaks to new "Execution of signal handlers" subsectionMichael Kerrisk1-5/+16
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12signal.7: Relocate the new "Execution of signal handlers" subsectionMichael Kerrisk1-77/+78
It is probably more sensible to place this section after the subsection "Signal mask and pending signals". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12signal.7: Minor tweaks to the test on execution of signal handlersMichael Kerrisk1-1/+4
Reported-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12signal.7: Add some details on the execution of signal handlersMichael Kerrisk1-1/+76
Add a "big picture" of what happens when a signal handler is invoked. Reported-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12signal.7: SEE ALSO: add swapcontext(3)Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-02feature_test_macros.7: tfixJohn A. Leuenhagen1-1/+1
Signed-off-by: John A. Leuenhagen <john@zlima12.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-01memusage.1, pldd.1, sprof.1, add_key.2, bind.2, bpf.2, clone.2, dup.2, ↵Michael Kerrisk18-18/+18
epoll_ctl.2, eventfd.2, fanotify_init.2, fanotify_mark.2, futex.2, getdents.2, getpid.2, getrlimit.2, intro.2, ioctl_fat.2, ioctl_ns.2, kcmp.2, keyctl.2, membarrier.2, memfd_create.2, mprotect.2, msgctl.2, msgop.2, nfsservctl.2, open.2, open_by_handle_at.2, openat2.2, outb.2, perf_event_open.2, pivot_root.2, recv.2, recvmmsg.2, request_key.2, sched_setaffinity.2, sched_setattr.2, seccomp.2, select.2, send.2, signalfd.2, spu_run.2, sysctl.2, timer_create.2, userfaultfd.2, wait.2, CPU_SET.3, abs.3, argz_add.3, backtrace.3, bsearch.3, bswap.3, clock_getcpuclockid.3, cmsg.3, dl_iterate_phdr.3, dlinfo.3, dlopen.3, drand48.3, drand48_r.3, duplocale.3, encrypt.3, endian.3, envz_add.3, errno.3, ffs.3, fopencookie.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getgrent_r.3, getgrouplist.3, getifaddrs.3, getline.3, getprotoent_r.3, getpwent_r.3, getpwnam.3, getservent_r.3, hsearch.3, insque.3, intro.3, lrint.3, lround.3, lseek64.3, mallinfo.3, malloc_hook.3, malloc_info.3, mbsinit.3, mbstowcs.3, mtrace.3, newlocale.3, ntp_gettime.3, offsetof.3, perror.3, posix_fallocate.3, posix_spawn.3, printf.3, psignal.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setname_np.3, pthread_sigmask.3, qsort.3, rand.3, random.3, rpc.3, rtnetlink.3, scalbln.3, shm_open.3, stdarg.3, strcat.3, strerror.3, strfmon.3, strptime.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, tsearch.3, wordexp.3, loop.4, vcs.4, veth.4, core.5, locale.5, slabinfo.5, cgroup_namespaces.7, cpuset.7, credentials.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, kernel_lockdown.7, man.7, mount_namespaces.7, namespaces.7, pid_namespaces.7, rtld-audit.7, sigevent.7, sock_diag.7, standards.7, unix.7, user_namespaces.7: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-01bpf-helpers.7: tfixMichael Kerrisk1-5/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-28socket.7: srcfix: rewrap source linesMichael Kerrisk1-6/+10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-28socket.7: Document SO_INCOMING_NAPI_IDSridhar Samudrala1-0/+12
Signed-off-by: Sridhar Samudrala <sridhar.samudrala@intel.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27system_data_types.7: off_t: Add note about _FILE_OFFSET_BITSAlejandro Colomar1-1/+7
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27system_data_types.7: ffixAlejandro Colomar1-136/+147
Format section names inside each type. Follow the same pattern as in stat.2 (see line 158: ".IR Note :") Before this ffix, it was visually harder to find sections inside a type. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27system_data_types.7: ffixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27capabilities.7: Under CAP_SYS_ADMIN, group "sub-capabilities" togetherMichael Kerrisk1-7/+10
CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been added to split out the power of CAP_SYS_ADMIN into weaker pieces. Group all of these capabilities together in the list under CAP_SYS_ADMIN, to make it clear that there is a pattern to these capabilities. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27capabilities.7: CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTOREMichael Kerrisk1-0/+5
But the latter, weaker capability is preferred. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27capabilities.7: tfixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27capabilities.7: Document the CAP_CHECKPOINT_RESTORE capability added in ↵Michael Kerrisk1-0/+29
Linux 5.9 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27pid_namespaces.7: Update capability requirements for ↵Michael Kerrisk1-0/+2
/proc/sys/kernel/ns_last_pid Since Linux 5.9, CONFIG_CHECKPOINT_RESTORE also allows writing to /proc/sys/kernel/ns_last_pid. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27capabilities.7: Add kernel doc reference for CAP_PERFMONMichael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27capabilities.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27system_data_types.7: Promote makedev(3) in discussion of 'dev_t'Michael Kerrisk1-2/+3
makedev(3) provides much more detail on this type, so mention it in the description rather than in 'See also'. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27system_data_types.7: Under 'dev_t' mention stat(2) rather than ustat(2) in ↵Michael Kerrisk1-1/+1
"See also" stat(2) is the most interesting API here; ustat(2) is obscure. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27system_data_types.7: Add 'dev_t'Alejandro Colomar1-0/+21
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-25system_Data_types.7: Add 'clockid_t'Alejandro Colomar1-0/+23
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-25queue.3, queue.7: Move queue.3 to queue.7Alejandro Colomar1-0/+148
After forking slist.3, list.3, tailq.3, stailq.3 & circleq.3 in the previous commits, this page no longer belongs in Section 3 of the manual pages. According to its contents, the most suitable section is Section 7. Because of legacy reasons, a link queue.3 -> queue(7) would be appropriate. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-25membarrier.2, openat2.2, insque.3, proc.5, tzfile.5, hier.7: Minor grammar fixMichael Kerrisk1-2/+2
Don't hyphenate after adjective ending in "ly". See, for example: https://www.dragoman.ist/compound-modifiers-with-words-ending-in-ly/ https://www.merriam-webster.com/words-at-play/6-common-hypercorrections-and-how-to-avoid-them/between-you-and-i Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-24signal.7: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-20namespaces.7: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-20namespaces.7: A 'time_for_children' symlink can also pin a namespaceMichael Kerrisk1-0/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-18system_data_types.7: Add 'clock_t'Alejandro Colomar1-0/+25
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-18system_data_types.7: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-18system_data_types.7: srcfix: add comment noting time_t difference in ↵Michael Kerrisk1-0/+4
POSIX.1-2001 Paul Eggert commented on a patch that proposed to note the POSIX.2001 details: No actual POSIXish implementation ever made it a real-floating type, though, and that point should be made lest some conscientious programmer worry about a nonexistent porting issue. We opted to drop the patch, but in case someone else points out this POSIX.1-2001 difference in the future, let's leave a comment in the page source. Reported-by: Paul Eggert <eggert@cs.ucla.edu> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-17kernel_lockdown.7: Describe LSM activationHeinrich Schuchardt1-0/+13
Describe the activation of the Kernel Lockdown feature via Kconfig and the command line. Cf. Documentation/admin-guide/kernel-parameters.rst. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16kernel_lockdown.7: Add a VERSIONS sectionMichael Kerrisk1-0/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16kernel_lockdown.7: Various minor edits to bring this page closer to ↵Michael Kerrisk1-46/+43
man-pages stype No content changes... Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16kernel_lockdown.7: New page documenting the Kernel Lockdown featureHeinrich Schuchardt1-0/+107
Provide a man-page for kernel_lockdown. The content is taken from a patch for the Fedora 34 man-pages available at https://kojipkgs.fedoraproject.org//packages/man-pages/5.08/1.fc34/src/man-pages-5.08-1.fc34.src.rpm Signed-off-by: David Howells <dhowells@redhat.com> Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-11system_data_types.7: Add 'regex_t'Alejandro Colomar1-0/+23
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-10system_data_types.7: Add 'fd_set'Alejandro Colomar1-0/+22
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08man.7: srcfixMichael Kerrisk1-3/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08man.7: Clarify that alternating typeface macros print arguments without spacesMichael Kerrisk1-1/+2
Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08socket.7: ffixMichael Kerrisk1-1/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08socket.7: SEE ALSO: add ipv6(7)Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07mmap.2, proc.5, bpf-helpers.7, cpuset.7: tfixSamanta Navarro2-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07system_data_types.7: Trim "See also" list of 'off_t'Michael Kerrisk1-4/+4
Trim the list to just be a representative sample of the APIs that use 'off_t'. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>