aboutsummaryrefslogtreecommitdiffstats
path: root/man2
AgeCommit message (Collapse)AuthorFilesLines
2020-11-16uselib.2, posix_memalign.3, profil.3, rtime.3: Remove some text about libc/libc5Michael Kerrisk1-18/+18
With this change, there remain almost no vestiges of information about the long defunct Linux libc. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16ioctl_tty.2, matherr.3, cciss.4, sk98lin.4: ffix: use proper table for ↵Michael Kerrisk1-21/+23
formatting, not .nf/.fi This gives better PDF rendering. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16pidfd_open.2, pidfd_send_signal.2, poll.2, semget.2: ffix: EXAMPLES: use ↵Michael Kerrisk4-8/+8
.EX/.EE instead of .nf/.fi Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16bpf.2: Place EXAMPLES section in correct locationMichael Kerrisk1-69/+69
As per section ordering rules given in man-pages(7). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-16prctl.2, setns.2: tfix: remove section number from API documented in this pageMichael Kerrisk2-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15chroot.2, memfd_create.2, tailq.3: Fix unbalanced .nf/.fiMichael Kerrisk2-0/+2
Reported-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15uname.2, feature_test_macros.7: ffixMichael Kerrisk1-1/+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 Colomar12-13/+13
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-15faccessat2.2: New link to access.2Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15access.2: Document faccessat2()Michael Kerrisk1-4/+37
faccessat2() was added in Linux 5.8 and enables a fix to longstanding bugs in the faccessat() wrapper function. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15access.2: BUGS: note that faccessat() wrapper function emulation ignores ACLsMichael Kerrisk1-1/+15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15openat.2: Fix include path, should be linux/openat2.hColin Ian King1-1/+1
The include path is linux/openat2, so fix the manual to reference this correct path. Signed-off-by: Colin Ian King <colin.king@canonical.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15shmctl.2: wfix (for consistency with other *ctl.2 pages)Michael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15msgctl.2, semctl.2, shmctl.2: Minor fixMichael Kerrisk3-0/+6
Break text into more paragraphs to ease readability Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15msgctl.2: Make comments in 'msqid_ds' definition more compactMichael Kerrisk1-13/+10
The comments do not need to be so verbose, since the main text provides the full details. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15msgctl.2: Add description of 'msg_cbytes' fieldMichael Kerrisk1-0/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15msgctl.2: Use field name "msg_cbytes" rather than "__msg_cbytes"Michael Kerrisk1-1/+1
The shorter name is provided by default (i.e., if _DEFAULT_SOURCE is defined). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15msgctl.2: Place list of field descriptions in same order as structure definitionMichael Kerrisk1-16/+16
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15shmctl.2: Place list of field descriptions in same order as structure definitionMichael Kerrisk1-13/+13
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-15semctl.2: ffixMichael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-14sigaction.2: tfixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-14sigaction.2: Minor wording improvementsMichael Kerrisk1-3/+7
Restructure the sa_handler description as a list, for easier reading. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-14sigaction.2: Clarify description of SA_NODEFERMichael Kerrisk1-3/+6
Clarify description of SA_NODEFER, and note interaction with act.sa_mask. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-14sigaction.2: ffixMichael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-14sigaction.2: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-13perf_event_open.2: srcfixAlejandro Colomar1-93/+122
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-13io_setup.2: SYNOPSIS: return longAlejandro Colomar1-1/+1
The Linux kernel uses a long as the return type for this syscall. As glibc provides no wrapper, use the same types the kernel uses. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12perf_event_open.2: Assign calculated value explicitly to 'config'Alejandro Colomar1-4/+7
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12sigaltstack.2: Clarify that the alternate signal stack is per-threadMichael Kerrisk1-10/+10
Clarify that the alternate signal stack is per-thread (rather than process-wide). Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12clone.2, sigaltstack.2: clone(CLONE_VM) disdables the alternate signal stackMichael Kerrisk2-0/+17
In the kernel sources (kernel/fork.c::copy_process()), we have: /* * sigaltstack should be cleared when sharing the same VM */ if ((clone_flags & (CLONE_VM|CLONE_VFORK)) == CLONE_VM) sas_ss_reset(p); Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-12sigaction.2: Further clarify the effect of the SA_NODEFER flagMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-11getrlimit.2: State more precisely the range of kernel versions that had ↵Michael Kerrisk1-1/+1
RLIMIT_LOCKS Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-11timer_getoverrun.2: timer_getoverrun() now clamps the overrun count to ↵Michael Kerrisk1-3/+12
DELAYTIMER_MAX See https://bugzilla.kernel.org/show_bug.cgi?id=12665. The fix by Thomas Gleixner was in kernel commit 78c9c4dfbf8c04883941445a195276bb4bb92c76. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-10signal.2: wfix: Make the warning against the use of signal() even more obviousMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-06syscalls.2: Note that sysctl() was removed in Linux 5.5Michael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-06bpf.2: Minor wording improvementMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-06syscalls.2: Add process_madvise()Michael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-06mount.2, statfs.2: Minor tweaks to Ross Zwisler's patchMichael Kerrisk2-4/+7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-06mount.2, statfs.2: Add NOSYMFOLLOW flags to mount(2) and statfs(2)Ross Zwisler2-0/+14
Signed-off-by: Ross Zwisler <zwisler@google.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-05membarrier.2: Update for Linux 5.10Peter Oskolkov1-7/+53
Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840 (part of 5.10 release) changed sys_membarrier prototype/parameters and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ]. This man-pages patch reflects these changes, by mostly copying comments from the kernel patch into the man-page ([Peter Oskolkov] was also the author of the kernel change). [mtk: commit message tweaked] Signed-off-by: Peter Oskolkov <posk@google.com> Cowritten-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-02mmap.2: Clarify SIGBUS text and treatment of partial page at end of a mappingMichael Kerrisk1-5/+9
See https://unix.stackexchange.com/questions/616848/what-is-the-behaviour-of-a-file-backed-memory-map-when-reading-from-or-writing-t Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-02io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2: ↵Alejandro Colomar5-5/+50
SYNOPSIS: s/io_context_t/aio_context_t/ Linux uses aio_context_t for these syscalls, and it's the type provided by <linux/aio_abi.h>. Use it in the SYNOPSIS. libaio uses 'io_context_t', but that difference is already noted in NOTES. [mtk: patch slightly tweaked] Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.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 Kerrisk44-44/+44
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-01openat.2: SYNOPSIS: return longAlejandro Colomar1-2/+2
The Linux kernel uses long as the return type for this syscall. As glibc provides no wrapper, use the same type the kernel uses. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-01mq_getsetattr.2: Use 'const' when appropriateAlejandro Colomar1-1/+1
The Linux kernel uses the following: ipc/mqueue.c:1480: SYSCALL_DEFINE3(mq_getsetattr, mqd_t, mqdes, const struct mq_attr __user *, u_mqstat, struct mq_attr __user *, u_omqstat) Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-01statx.2: ffixMichael Kerrisk1-5/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-30futex.2: ffixAlejandro Colomar1-1/+2
That comment wrapped on an 80-column terminal. Divide it into two lines. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-30futex.2: Use appropriate typesAlejandro Colomar1-13/+14
The Linux kernel uses the following: kernel/futex.c:3778: SYSCALL_DEFINE6(futex, u32 __user *, uaddr, int, op, u32, val, struct __kernel_timespec __user *, utime, u32 __user *, uaddr2, u32, val3) Since there is no glibc wrapper, use the same types the kernel uses. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-30futex.2: srcfixAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-29getdents.2: Use appropriate typesAlejandro Colomar1-5/+5
[mtk: Applied patch manually] getdents(): This function has no glibc wrapper. As such, we should use the same types the Linux kernel uses: Use 'long' as the return type. getdents64(): The glibc wrapper uses: ssize_t getdents64(int, void *, size_t); Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-28getdents.2: Minor tweak to Alex's patchMichael Kerrisk1-1/+1
The text in NOTES doesn't really relate specifically to the #include, so remove the comment on the #include. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-28getdents.2: SYNOPSIS: Add missing header and feature test macroAlejandro Colomar1-0/+4
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-28getdents.2: wfixAlejandro 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-28clock_getres.2: EXAMPLES: Use 'const' when appropriateAlejandro 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-27perf_event_open.2: wfixMichael Kerrisk1-1/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27perf_event_open.2: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27perf_event_open.2: Update the man page with CAP_PERFMON related informationAlexey Budankov1-2/+30
Extend this page with the information about CAP_PERFMON capability designed to secure performance monitoring and observability operation in a system according to the principle of least privilege [1] (POSIX IEEE 1003.1e, 2.2.2.39). [1] https://sites.google.com/site/fullycapable/, posix_1003.1e-990310.pdf Signed-off-by: Alexey Budankov <alexey.budankov@linux.intel.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27clone.2: CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid'Michael Kerrisk1-0/+5
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 Kerrisk2-3/+3
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-22openat2.2, loop.4: tfix: s/non-zero/nonzero/Alejandro Colomar1-3/+3
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-20setns.2: Correct the version for time namespace supportMichael Kerrisk1-1/+2
Time namespaces were added in kernel 5.6, but setns() support for time namespaces was added only starting with kernel 5.8: commit 76c12881a38aaa83e1eb4ce2fada36c3a732bad4 Author: Christian Brauner <christian.brauner@ubuntu.com> Date: Mon Jul 6 17:49:11 2020 +0200 nsproxy: support CLONE_NEWTIME with setns() Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-16link.2: ffixMichael Kerrisk1-1/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-15seccomp.2: Warn reader that SECCOMP_RET_TRACE can be overriddenMichael Kerrisk1-0/+4
Highlight to the reader that if another filter returns a higher-precedence action value, then the ptracer will not be notified. Reported-by: Jann Horn <jannh@google.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-14futex.2, quotactl.2: wfix: use "bitwise" rather than "bit-wise"Michael Kerrisk2-4/+4
Most manual pages already use "bitwise". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-09epoll_ctl.2: epoll instances can be nested to a maximum depth of 5Michael Kerrisk1-1/+2
This limit appears to be an off-by-one count against EP_MAX_NESTS (4). Verified by experiment. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-09epoll_ctl.2: Move some version info from CONFORMING TO to VERSIONSMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08recv.2, send.2: Add cross references to pages with further info about ↵Michael Kerrisk2-0/+10
ancillary data Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-08send.2: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-07mmap.2, proc.5, bpf-helpers.7, cpuset.7: tfixSamanta Navarro1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-30openat2.2: tfix: fix minor reference typoAleksa Sarai1-1/+1
Signed-off-by: Aleksa Sarai <cyphar@cyphar.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-30sched_getattr.2: Update to include changed size semanticsAleksa Sarai1-4/+12
Due to a userspace breakage, commit 1251201c0d34 ("sched/core: Fix uclamp ABI bug, clean up and robustify sched_read_attr() ABI logic and code") changed the semantics of sched_getattr(2) when the userspace struct is smaller than the kernel struct. Now, any trailing non-zero data in the kernel structure is ignored when copying to userspace. We also document the original error code correctly (it was EFBIG not E2BIG) in the BUGS section. Ref: 1251201c0d34 ("sched/core: Fix uclamp ABI bug, clean up and robustify sched_read_attr() ABI logic and code") Signed-off-by: Aleksa Sarai <cyphar@cyphar.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29perf_event_open.2: srcfixMichael Kerrisk1-0/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29adjtimex.2, futex.2, semop.2, slabinfo.5, feature_test_macros.7, keyrings.7: ↵Michael Kerrisk3-4/+4
srcfix Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29_exit.2, access.2, acct.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, ↵Michael Kerrisk61-122/+122
clock_getres.2, clock_nanosleep.2, fsync.2, futimesat.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getrlimit.2, getsid.2, gettimeofday.2, kill.2, link.2, madvise.2, mincore.2, mkdir.2, mknod.2, nanosleep.2, nice.2, open.2, posix_fadvise.2, pread.2, process_vm_readv.2, readlink.2, readv.2, rename.2, select.2, semop.2, seteuid.2, setpgid.2, setreuid.2, sigaction.2, sigaltstack.2, sigpending.2, sigprocmask.2, sigsuspend.2, sigwaitinfo.2, stat.2, stime.2, symlink.2, sync.2, syscall.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, truncate.2, unlink.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, bsd_signal.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, confstr.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.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, fmemopen.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent_r.3, getopt.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, getw.3, grantpt.3, group_member.3, gsignal.3, hypot.3, ilogb.3, inet.3, inet_net_pton.3, initgroups.3, insque.3, isalpha.3, isfdtype.3, isgreater.3, iswblank.3, j0.3, killpg.3, ldexp.3, lgamma.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, malloc.3, mbsnrtowcs.3, memchr.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_receive.3, mq_send.3, nan.3, newlocale.3, nextafter.3, nl_langinfo.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, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_cleanup_push_defer_np.3, pthread_kill.3, pthread_mutex_consistent.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_spin_init.3, pthread_spin_lock.3, ptsname.3, putenv.3, putpwent.3, qecvt.3, qsort.3, rand.3, random.3, random_r.3, rcmd.3, readdir_r.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sockatmark.3, sqrt.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strfromd.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpnam.3, toascii.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, unlockpt.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wordexp.3, wprintf.3, y0.3: srcfix: use better macros in SYNOPSIS Around the text: "Feature Test Macro Requirements for glibc..." replace ".in -4n/.in" with ".RS -4/.RE". The latter form is more idiomatic use of man macros. The nroff output is unchanged. Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29chmod.2, connect.2, recv.2: srcfixMichael Kerrisk3-3/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29clone.2, io_submit.2, select.2, shmget.2, getcontext.3, malloc_info.3, ↵Michael Kerrisk4-9/+9
mtrace.3, posix_spawn.3, strfromd.3, proc.5: srcfix Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29statx.2: Minor edits to Ira Weiny'sMichael Kerrisk1-10/+16
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-29statx.2: Add STATX_ATTR_DAXIra Weiny1-0/+24
Linux 5.8 adds STATX_ATTR_DAX support. https://lore.kernel.org/lkml/20200428002142.404144-4-ira.weiny@intel.com/ https://lore.kernel.org/lkml/20200504161352.GA13783@magnolia/ Add the text to the statx man page. Signed-off-by: Ira Weiny <ira.weiny@intel.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-28ioctl_fslabel.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-26seccomp.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25seccomp.2: Use ARRAY_SIZE() macro instead of raw sizeof divisionAlejandro Colomar1-1/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-25seccomp.2: Remove unneeded castAlejandro Colomar1-1/+1
From the email discussion: > Hi Alex, > > On 9/25/20 9:31 AM, Alejandro Colomar wrote: >> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> >> --- >> man2/seccomp.2 | 2 +- >> 1 file changed, 1 insertion(+), 1 deletion(-) >> >> diff --git a/man2/seccomp.2 b/man2/seccomp.2 >> index 58033da1c..d6b856c32 100644 >> --- a/man2/seccomp.2 >> +++ b/man2/seccomp.2 >> @@ -1101,7 +1101,7 @@ install_filter(int syscall_nr, int t_arch, int f_errno) >> }; >> >> struct sock_fprog prog = { >> - .len = (unsigned short) (sizeof(filter) / sizeof(filter[0])), >> + .len = sizeof(filter) / sizeof(filter[0]), >> .filter = filter, >> }; > > I have a small doubt about this change. With the change, > there are no compilation warnings. > > But, if we change the code to something slightly different: > > [[ > size_t x = (sizeof(filter) / sizeof(filter[0])); > struct sock_fprog prog = { > .len = x, > .filter = filter, > }; > ]] > > The "cc -Wconversion" gives us the following warning: > > warning: conversion from ‘size_t’ {aka ‘long unsigned int’} > to ‘short unsigned int’ may change value > > Presumably we don't get a warning for an assignment of the form > > .len = (sizeof(filter) / sizeof(filter[0])) > > because the compiler is smart enough to work out that the > value of the constant expression is within the range of > "unsigned short". > > Your thoughts? Hi Michael, I'd say that the cast doesn't fix any problems at all. It silences a valid warning, and I'd use a pragma for that (to be more explicit about the intention of silencing a warning) if I do want -Wconversion enabled (which usually I don't want, because it's too noisy) and I'm sure that this won't overflow. I'd limit the use casts to only when I *really* need to. I guess that if you enable -O3, the warning will vanish again because the compiler will optimize away 'x' (but I didn't test). Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24ptrace.2: ffixMichael Kerrisk1-20/+20
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24pldd.1, bpf.2, clone.2, dup.2, ioctl_fat.2, nfsservctl.2, ↵Michael Kerrisk13-39/+39
open_by_handle_at.2, perf_event_open.2, pivot_root.2, request_key.2, sched_setaffinity.2, seccomp.2, select.2, statx.2, dl_iterate_phdr.3, dlinfo.3, dlopen.3, insque.3, newlocale.3, printf.3, pthread_setname_np.3, rpc.3, stdarg.3, strfmon.3, veth.4, proc.5, slabinfo.5, cgroup_namespaces.7, cgroups.7, cpuset.7, fanotify.7, inotify.7, mount_namespaces.7, sock_diag.7, user_namespaces.7, ld.so.8: Use \(aq instead of ' inside monospace fonts Use \(aq to get an unslanted single quote inside monospace code blocks. Using a simple ' results in a slanted quote inside PDFs. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24open.2: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24ioctl_ns.2, stat.2: Fix signedness of printf specifiersAlejandro Colomar2-8/+8
These variables are either of an unsigned integer type per POSIX; or of an integer type per POSIX, that Linux defines as an unsigned integer type. Print them with 'uintmax_t' instead of 'intmax_t' to avoid big positive numbers being printed as negative numbers. Bug report: From: Konstantin Bukin @ 2020-09-13 15:04 UTC To: mtk.manpages; +Cc: Konstantin Bukin, linux-man inode numbers are expected to be positive. Casting them to a signed type may result in printing negative values. E.g. running example program on the following file: $ ls -li test.txt 9280843260537405888 -r--r--r-- 1 kbukin hardware 300 Jul 21 06:36 test.txt results in the following output: $ ./example test.txt ID of containing device: [0,480] File type: regular file I-node number: -9165900813172145728 Mode: 100444 (octal) Link count: 1 Ownership: UID=2743 GID=30 Preferred I/O block size: 32768 bytes File size: 300 bytes Blocks allocated: 8 Last status change: Tue Jul 21 06:36:50 2020 Last file access: Sat Sep 12 14:13:38 2020 Last file modification: Tue Jul 21 06:36:50 2020 Such erroneous reporting happens for inode values greater than maximum value which can be stored in signed long. Casting does not seem to be necessary here. Printing inode as unsigned long fixes the issue. Reported-by: Konstantin Bukin <kbukin@gmail.com> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-22kcmp.2: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-20syscalls.2: Move system calls from discontinued ports out of main syscall listMichael Kerrisk1-65/+65
Various ports that had their own indigenous system calls have been discontinued. Remove those system calls (none of which had manual pages!) to a separate part of the page, to avoid cluttering the main list of system calls. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-20getcwd.2, mq_notify.2, mq_open.2, mq_timedreceive.2, mq_timedsend.2, ↵Michael Kerrisk6-0/+12
mq_unlink.2: Reinstate links to section 3 pages that document system calls Some of the links removed in commit 247c654385128fd0748 should have been kept, because in some cases there are real system calls whose wrapper functions are documented in Section 3. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-20syscalls.2: Remove duplicate entry for swapcontext(2)Michael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-17intro.2, intro.3, feature_test_macros.7, standards.7: SEE ALSO: add ↵Michael Kerrisk1-0/+1
system_data_types(7) Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-16sigaction.2: Use correct POSIX type for siginfo_t.si_valueMichael Kerrisk1-1/+1
Reported-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-15add_key.2, clock_getres.2, clone.2, futex.2, getdents.2, getpid.2, ↵Alejandro Colomar15-59/+77
getrlimit.2, ioctl_ns.2, kcmp.2, keyctl.2, memfd_create.2, request_key.2, stat.2, timer_create.2, wait.2, clock_getcpuclockid.3, dl_iterate_phdr.3, getgrent_r.3, getpwent_r.3, getpwnam.3, posix_spawn.3, pthread_getcpuclockid.3, strcat.3, feature_test_macros.7, user_namespaces.7: Switch printf() casts to use [u]intmax_t + %ju / %jd Let's move to the 21st century. Instead of casting system data types to long/long long/etc. in printf() calls, instead cast to intmax_t or uintmax_t, the largest available signed/unsigned integer types. [mtk: rewrote commit message] Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-13clock_getres.2: Cast 'time_t' to 'int' for printf() and fix the length modifiersAlejandro Colomar1-2/+4
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Reviewed-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-13userfaultfd.2: Use 'PRIx64' rather than "%llx" when printing 64-bit ↵Alejandro Colomar1-3/+4
fixed-width types Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-13open_by_handle_at.2: Use "%u" rather than "%d" when printing 'unsigned int' ↵Alejandro Colomar1-1/+1
values Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-13mprotect.2: Use "%p" rather than casting to 'long' when printing pointer valuesAlejandro Colomar1-3/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-12eventfd.2, mprotect.2, pidfd_open.2, spu_run.2, timer_create.2, bswap.3, ↵Alejandro Colomar5-7/+7
dl_iterate_phdr.3, endian.3, pthread_attr_init.3, pthread_getattr_np.3, vcs.4, rtld-audit.7: In printf(): s/0x%/%#/ except when followed by X instead of x Use printf()'s '#' flag character to prepend the string "0x". However, when the number is printed in uppercase, and the prefix is in lowercase, the string "0x" needs to be manually written. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-12msgctl.2, outb.2, abs.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, ↵Alejandro Colomar2-25/+25
encrypt.3, ffs.3, lrint.3, lround.3, ntp_gettime.3, printf.3, random.3, scalbln.3, scanf.3, strtol.3, strtoul.3, utmp.5, feature_test_macros.7, rtld-audit.7: Omit 'int' keyword for 'short', 'long' and 'long long' types, both signed and 'unsigned' For consistency. The types are written both with and without the redundant 'int' keyword all over the man-pages. However, the most used form, by far, is the one without 'int'. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11userfaultfd.2: Use a better type (uint64_t) for 'len' in EXAMPLESMichael Kerrisk1-2/+2
See the previous commit to bswap.3... Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11stat.2: wsfixAlejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11timerfd_create.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11stat.2: Cast to 'unsigned long' rather than 'long' when printing with "%lx"Alejandro Colomar1-1/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11ioctl_ns.2: Cast to 'unsigned long' rather than 'long' when printing with "%lx"Alejandro Colomar1-2/+4
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11eventfd.2: Use 'PRIxN' macros when printing C99 fixed-width integer typesAlejandro Colomar1-2/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11timerfd_create.2: Use 'PRIxN' macros when printing C99 fixed-width integer typesAlejandro Colomar1-3/+2
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11timer_create.2: Cast to 'unsigned long' rather than 'long' when printing ↵Alejandro Colomar1-2/+2
with "%lx" Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11request_key.2: Cast to 'unsigned long' rather than 'long' when printing with ↵Alejandro Colomar1-1/+1
"%lx" Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11add_key.2: Cast to 'unsigned long' rather than 'long' when printing with "%lx"Alejandro Colomar1-1/+1
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11membarrier.2: Note that glibc does not provide a wrapperAlejandro Colomar1-0/+9
Notes: I copied .nf and .fi from futex.2, but they made no visual difference. What do they actually do? Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11readlink.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11spu_create.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11copy_file_range.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-11ioctl_userfaultfd.2: ffixMichael Kerrisk1-5/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-09msgop.2: Minor tweak's to Yang Xu's patchMichael Kerrisk1-3/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-09msgop.2: Add restriction on ENOSYS errorYang Xu1-1/+3
When calling msgrcv() with the MSG_COPY flag, it will report EINVAL error even we if have disabled CONFIG_CHECKPOINT_RESTORE. ENOSYS will be reported only if we also specify the IPC_NOWAIT flag. [mtk: edited commit message] Notes from mtk: The relevant kernel code is this: [[ #ifdef CONFIG_CHECKPOINT_RESTORE ... #else static inline struct msg_msg *prepare_copy(void __user *buf, size_t bufsz) { return ERR_PTR(-ENOSYS); } ... static long do_msgrcv(int msqid, void __user *buf, size_t bufsz, long msgtyp, int msgflg, long (*msg_handler)(void __user *, struct msg_msg *, size_t)) { ... if (msgflg & MSG_COPY) { if ((msgflg & MSG_EXCEPT) || !(msgflg & IPC_NOWAIT)) return -EINVAL; copy = prepare_copy(buf, min_t(size_t, bufsz, ns->msg_ctlmax)); ... } ]] We'll only hit the ENOSYS error if: (1) MSG_COPY was specified; (2) IPC_NOWAIT was not specified; and (3) CONFIG_CHECKPOINT_RESTORE was not enabled. Signed-off-by: Yang Xu <xuyang2018.jy@cn.fujitsu.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-07open.2: ERRORS: EBUSYMichael Kerrisk1-0/+8
An EBUSY error case is mentioned in DESCRIPTIOn; add it to ERRORS also. See also https://bugzilla.kernel.org/show_bug.cgi?id=209109 Reported-by: henrik@optoscale.no Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-06msgop.2: Remove unneeded castsAlejandro Colomar1-2/+2
The type `struct msgbuf *` is implicitly casted to `const void *`. Not only that, but the explicit cast to `void *` was slightly misleading. Explicitly casting can silence warnings when mistakes are made, so it's better to remove those casts when possible. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05sprof.1, eventfd.2, execve.2, futex.2, getdents.2, mprotect.2, ↵Michael Kerrisk8-22/+18
open_by_handle_at.2, recvmmsg.2, sched_setaffinity.2, CPU_SET.3, backtrace.3, bsearch.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, envz_add.3, fopencookie.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getgrent_r.3, getgrouplist.3, getifaddrs.3, getprotoent_r.3, getservent_r.3, hsearch.3, mallinfo.3, malloc_info.3, mbstowcs.3, mtrace.3, pthread_create.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, qsort.3, rand.3, strcat.3, strtok.3, tsearch.3, wordexp.3, core.5, aio.7, inotify.7, sock_diag.7, unix.7, user_namespaces.7: Use C99 style to declare loop counter variables Rather than: sometype x; for (x = ....; ...) use for (sometype x = ...; ...) This brings the declaration and use closer together (thus aiding readability) and also clearly indicates the scope of the loop counter variable. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05getdents.2: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05signalfd.2: Use sizeof consistentlyAlejandro Colomar1-2/+2
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05sysctl.2: Use sizeof consistentlyAlejandro Colomar1-1/+1
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05perf_event_open.2: Use sizeof consistentlyAlejandro Colomar1-1/+1
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05perf_event_open.2: Use sizeof consistentlyAlejandro Colomar1-2/+2
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05open_by_handle_at.2: Use sizeof consistentlyAlejandro Colomar1-2/+2
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05futex.2: Use sizeof consistentlyAlejandro Colomar1-1/+1
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05bind.2: Use sizeof consistentlyAlejandro Colomar1-3/+3
Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05bind.2, ioctl_ns.2, open_by_handle_at.2, duplocale.3: tfixMichael Kerrisk3-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify_init.2, fanotify.7: Minor edits to Amir Goldstein's patchesMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify_init.2, fanotify.7: srcfix: Semantic newlinesMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7, fanotify_init.2: Document FAN_REPORT_NAMEAmir Goldstein1-0/+54
Document fanotify_init(2) flag FAN_REPORT_NAME and the format of the event info type FAN_EVENT_INFO_TYPE_DFID_NAME. The fanotify_fid.c example is extended to also report the name of the created file or subdirectory. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7, fanotify_init.2: Document FAN_REPORT_DIR_FIDAmir Goldstein1-2/+33
Document fanotify_init(2) flag FAN_REPORT_DIR_FID and event info type FAN_EVENT_INFO_TYPE_DFID. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28fanotify.7, fanotify_mark.2: Generalize documentation of FAN_REPORT_FIDAmir Goldstein2-44/+32
With fanotify_init(2) flag FAN_REPORT_FID, the group identifies filesystem objects by file handles in a single event info record of type FAN_EVENT_INFO_TYPE_FID. We intend to add support for new fanotify_init(2) flags for which the group identifies filesystem objects by file handles and add more event info record types. To that end, start by changing the language of the man page to refer to a "group that identifies filesystem objects by file handles" instead of referring to the FAN_REPORT_FID flag and document the extended event format structure in a more generic manner that allows more than a single event info record and not only a record of type FAN_EVENT_INFO_TYPE_FID. Clarify that the object identified by the file handle refers to the directory in directory entry modification events. Remove a note about directory entry modification events and monitoring a mount point that I found to be too confusing and out of context. Signed-off-by: Amir Goldstein <amir73il@gmail.com> Reviewed-by: Jan Kara <jack@suse.cz> Reviewed-by: Matthew Bobrowski <mbobrowski@mbobrowski.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28mount.2: Minor wording improvementMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-28syscalls.2: Bump kernel version numberMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-27syscalls.2: Add close_range (Linux 5.9)Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-26clock_getres.2: Fix type and variable name in dynamic clock code exampleMichael Kerrisk1-2/+2
Use 'struct timespec', not 'struct timeval', and adjust the variable name accordingly. Reported-by: Tony May <tony.may@mediakind.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-23seccomp.2: EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILLMichael Kerrisk1-2/+2
See previous commit. Reported-by: Rich Felker <dalias@libc.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-23seccomp.2: Warn against the use of SECCOMP_RET_KILL_THREADMichael Kerrisk1-0/+6
Killing a thread with SECCOMP_RET_KILL_THREAD is very likely to leave the rest of the process in a broken state. Wording pretty much taken from Rick Felker's suggestion. Reported-by: Rich Felker <dalias@libc.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-13intro.1, clock_getres.2, execve.2, fcntl.2, iopl.2, lseek.2, mknod.2, ↵Michael Kerrisk21-21/+21
mmap.2, mount.2, mq_getsetattr.2, pidfd_open.2, prctl.2, setns.2, sgetmask.2, sigaction.2, stat.2, statx.2, sync.2, syscalls.2, syslog.2, timerfd_create.2, umask.2, a64l.3, aio_init.3, atoi.3, dladdr.3, fread.3, getpt.3, isfdtype.3, malloc_stats.3, malloc_trim.3, mkfifo.3, mq_close.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, posix_memalign.3, posix_openpt.3, pthread_atfork.3, pthread_rwlockattr_setkind_np.3, regex.3, scanf.3, sem_close.3, sem_destroy.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sigset.3, sigvec.3, strftime.3, termios.3, console_codes.4, dsp56k.4, fd.4, lp.4, mouse.4, pts.4, sk98lin.4, dir_colors.5, proc.5, resolv.conf.5, termcap.5, utmp.5, aio.7, armscii-8.7, arp.7, capabilities.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, environ.7, glob.7, inode.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, keyrings.7, koi8-r.7, koi8-u.7, mailaddr.7, man-pages.7, netdevice.7, operator.7, persistent-keyring.7, process-keyring.7, pthreads.7, pty.7, raw.7, regex.7, session-keyring.7, shm_overview.7, signal.7, socket.7, suffixes.7, thread-keyring.7, unicode.7, units.7, uri.7, user-keyring.7, user-session-keyring.7, iconvconfig.8, ld.so.8, zic.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-09pldd.1, bpf.2, execve.2, futex.2, ioctl_fat.2, ioctl_tty.2, keyctl.2, ↵Michael Kerrisk8-13/+13
signalfd.2, timerfd_create.2, __ppc_get_timebase.3, a64l.3, frexp.3, pthread_setname_np.3, regex.3, rpmatch.3, scanf.3, strfmon.3, strftime.3, termios.3, console_codes.4, vcs.4, veth.4, core.5, dir_colors.5, termcap.5, ascii.7, charsets.7, glob.7, man-pages.7, operator.7, regex.7, user_namespaces.7, zic.8: Use "\(ha" rather than "^" in code This renders better in PDF. Reported-by: Geoff Clare <gwc@opengroup.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-08-06intro.1, clock_getres.2, clone.2, futex.2, ioctl_fat.2, mkdir.2, mknod.2, ↵Michael Kerrisk11-12/+12
mmap.2, open.2, statx.2, umask.2, userfaultfd.2, glob.3, mkfifo.3, termios.3, wordexp.3, console_codes.4, sk98lin.4, vcs.4, dir_colors.5, hosts.equiv.5, proc.5, termcap.5, utmp.5, ascii.7, bpf-helpers.7, charsets.7, environ.7, glob.7, mailaddr.7, netlink.7, operator.7, suffixes.7, tcp.7, unicode.7, uri.7, zic.8: Use "\(ti" instead of "~" A naked tilde ("~") renders poorly in PDF. Instead use "\(ti", which renders better in a PDF, and produces the same glyph when rendering on a terminal. Reported-by: Geoff Clare <gwc@opengroup.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-31open.2, proc.5: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-30ioctl_tty.2: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-30ioctl_tty.2: ffixMichael Kerrisk1-9/+9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-30socket.2, address_families.7: wfix: multiplexor ==> multiplexerMichael Kerrisk1-1/+1
Both are used, but "multiplexer" seems to be majority usage in English. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-29ioctl_tty.2: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-29ioctl_tty.2: Minor wording and formatting fixesMichael Kerrisk1-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-29ioctl_tty.2: Fix a confusing wording error in description of TIOCSPTLCKMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24Various pages: Drop t comment headerMike Frysinger10-10/+0
Historically, a comment of the following form at the top of a manual page was used to indicate too man(1) that the use of tbl(1) was required in order to process tables: '\" t However, at least as far back as 2001 (according to Branden), man-db's man(1) automatically uses tbl(1) as needed, rendering this comment unnecessary. And indeed many existing pages in man-pages that have tables don't have this comment at the top of the file. So, drop the comment from those files where it is present. [mtk: completely rewrote commit message] Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com> Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24seccomp.2: Minor tweaks to Andy Lutomirski's patchMichael Kerrisk1-7/+10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24seccomp.2: Improve x32 and nr truncation notesAndy Lutomirski1-11/+33
Signed-off-by: Andy Lutomirski <luto@kernel.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24open.2: Say a bit more about what happens when 'mode' is wrongly omittedMichael Kerrisk1-9/+17
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24open.2: Minor wording fixesMichael Kerrisk1-1/+5
Add some paragraph breaks to the discussion of 'mode' to make the details a bit easier to read. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24open.2: srcfix: use saner macros to achieve same formatting effectMichael Kerrisk1-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-24Various pages: Use standard .\" comment styleMike Frysinger2-9/+9
The \" comment produces blank lines. Use the .\" that the vast majority of the codebase uses instead. Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-20ioctl_fat.2, dladdr.3: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-20prctl.2: tfixJakub Wilk1-1/+1
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-17lseek.2: List gfs2 support for SEEK_HOLE/SEEK_DATAAndrew Price1-0/+3
Signed-off-by: Andrew Price <anprice@redhat.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-17setns.2: EXAMPLE: use O_CLOEXEC when opening namespace file descriptorMichael Kerrisk1-1/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-17pidfd_open.2: Close the pidfd in EXAMPLEMichael Kerrisk1-0/+1
Close the PID file descriptor in the example program, to hint to the reader that like every other kind of file descriptor, a PID FD should be closed. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-13truncate.2: tfixMichael Kerrisk1-1/+1
Reported-by: Diogo Miguel Ferreira Rodrigues <dmfrodrigues2000@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-11prctl.2: The parent death signal is cleared on some credential changesMichael Kerrisk1-0/+6
See kernel/cred.c::commit_creds() in the Linux 5.6 source code. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06intro.1, localedef.1, memusage.1, memusagestat.1, bpf.2, execve.2, fork.2, ↵Michael Kerrisk8-45/+45
keyctl.2, request_key.2, sigaction.2, signal.2, socket.2, dlopen.3, getauxval.3, gnu_get_libc_version.3, pthread_atfork.3, sem_post.3, setjmp.3, strftime.3, veth.4, locale.5, nscd.conf.5, resolv.conf.5, address_families.7, armscii-8.7, ascii.7, capabilities.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, keyrings.7, koi8-r.7, koi8-u.7, libc.7, locale.7, man.7, network_namespaces.7, persistent-keyring.7, session-keyring.7, signal.7, unicode.7, uri.7, user-keyring.7, user-session-keyring.7: ffix: replace - with real\- Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06move_pages.2: ffixMichael Kerrisk1-7/+7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06prctl.2: tfixJakub Wilk1-1/+1
Remove duplicated word. Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06shmop.2: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06open.2: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06mremap.2: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06mmap.2: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06execve.2: tfixMichael Kerrisk1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-03send.2, recv.2: Add msg_iovlen POSIX noteAlyssa Ross2-8/+18
msg_iovlen is incorrectly typed (according to POSIX) in addition to msg_controllen, but unlike msg_controllen, this wasn't mentioned for msg_iovlen. msg_iovlen being incorrectly typed hasn't been reported as a GCC bug, but there's no point since it is caused by the same underlying issue. Sources: POSIX.1-2017 (<sys/socket.h>), Linux (include/linux/socket.h) Signed-off-by: Alyssa Ross <hi@alyssa.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-03mount.2: ERRORS: add EINVAL for bind mount of mount namespace inodeMichael Kerrisk1-0/+16
See kernel commit 8823c079ba7136dc1948d6f6dcb5f8022bde438e and the in fs/namespace.c::do_loopback(): err = -EINVAL; if (mnt_ns_loop(old_path.dentry)) goto out; Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-02man2/*: ffix: change '-' to '\-' for optionsBjarni Ingi Gislason9-12/+12
Change '-' to '\-' for the prefix of names to indicate an option. Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-29iopl.2: Minor tweaks to Thomas Piekarski's patchMichael Kerrisk1-5/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-29iopl.2: Updating description of permissions and disabling interruptsThomas Piekarski1-20/+14
Update description of permissions for port-mapped I/O set per-thread and not per-process. Mention that iopl() can not disable interrupts since Linux 5.5 anymore and is in general deprecated and only provided for legacy X servers. See https://bugzilla.kernel.org/show_bug.cgi?id=205317 Reported-by: victorm007@yahoo.com Signed-off-by: Thomas Piekarski <t.piekarski@deloquencia.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-29prctl.2: srcfix: add various people to copyrightMichael Kerrisk1-1/+5
Based on git history. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26prctl.2: Minor fixes to Dave Martin's patchMichael Kerrisk1-8/+9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26prctl.2: Add tagged address ABI control prctls (arm64)Dave Martin1-2/+163
Add documentation for the the PR_SET_TAGGED_ADDR_CTRL and PR_GET_TAGGED_ADDR_CTRL prctls added in Linux 5.4 for arm64. Signed-off-by: Dave Martin <Dave.Martin@arm.com> Reviewed-by: Catalin Marinas <catalin.marinas@arm.com> Cc: Vincenzo Frascino <vincenzo.frascino@arm.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26prctl.2: Minor tweaks to Dave Martin's patchMichael Kerrisk1-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26prctl.2: Add SVE prctls (arm64)Dave Martin1-0/+170
Add documentation for the the PR_SVE_SET_VL and PR_SVE_GET_VL prctls added in Linux 4.15 for arm64. Signed-off-by: Dave Martin <Dave.Martin@arm.com> Cc: Catalin Marinas <catalin.marinas@arm.com> Cc: Will Deacon <will@kernel.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26clone.2: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26semctl.2: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26sync.2: Minor fixesMichael Kerrisk1-3/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26sync.2: Minor tweaks to Jeff Layton's patchMichael Kerrisk1-3/+8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26sync.2: syncfs() now returns errors if writeback failsJeff Layton1-1/+23
A patch has been merged for v5.8 that changes how syncfs() reports errors. Change the sync() manpage accordingly. Signed-off-by: Jeff Layton <jlayton@kernel.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26tcp.7: tfixPhilip Adams1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-25mmap.2: tfixMichael Kerrisk1-1/+1
Reported-by: Bruno Haible <bruno@clisp.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-23sysctl.2: glibc removed support for sysctl() starting in version 2.32Michael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-21connect.2, pidfd_send_signal.2, ptrace.2, socket.7: ffixMichael Kerrisk3-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-21man2/*: srcfix: fix warnings from "mandoc -Tlint"Bjarni Ingi Gislason55-107/+2
Remove superfluous paragraph macros. Remove ".br" if it is before a line that starts with a space character, as such lines automatically cause a break. ### The output is unchanged, except two empty lines are added at the bottom (before the footer line) in the output of "nroff" for the files "alloc_hugepages.2" and "userfaultfd.2". ### Examples of warnings from "mandoc -Tlint": mandoc: access.2:283:2: WARNING: skipping paragraph macro: PP after SH mandoc: adjtimex.2:185:2: WARNING: skipping paragraph macro: PP empty mandoc: futex.2:728:2: WARNING: skipping paragraph macro: IP empty mandoc: getsid.2:48:2: WARNING: skipping paragraph macro: br before text line with leading blank mandoc: init_module.2:290:2: WARNING: skipping paragraph macro: PP after SS mandoc: ioctl_fideduperange.2:27:2: WARNING: skipping paragraph macro: br after SH Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-20fstatvfs.2, getcontext.2, getcwd.2, gethostid.2, killpg.2, mq_notify.2, ↵Michael Kerrisk13-14/+0
mq_open.2, mq_timedreceive.2, mq_timedsend.2, mq_unlink.2, setcontext.2, sethostid.2, statvfs.2: Remove historical .so links These links were mostly created when pages were moved between sections, in almost every case several years ago. The idea was to allow people time to get used to the new section numbers while still having commands of the form "man <sec> <page>" work as before. Let's assume that people have now had time to get used to the new section numbers, and remove these links. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-19getdtablesize.2, sigqueue.2, clock_getres.3, clock_gettime.3, ↵Michael Kerrisk2-4/+0
clock_settime.3, attr.5, numa_maps.5: Remove old links These are all links that were created several years ago, mainly when pages were migrated to different sections, in order to allow the 'man' commands using the old section numbers to work. However, the plan was always to eventually remove them, after allowing people who cared to get used to the new section numbers. Now, after 5+ years in each case, it's time to remove these links. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-19keyctl.2: Declare auth_keyOleksandr Kravchuk1-0/+1
The variable is used in the code example, but not declared, leading to a compilation error. Signed-off-by: Oleksandr Kravchuk <open.source@oleksandr-kravchuk.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-15setns.2: ERRORS: add ESRCH for PID FD that refers to a terminated processMichael Kerrisk1-0/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-15setns.2: Minor wording fixesMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-15setns.2: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-15setns.2: Minor tweakMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-15setns.2: Document the use of PID file descriptors with setns()Michael Kerrisk1-18/+81
Starting with Linux 5.8, setns() can take a PID file descriptor as an argument, and move the caller into or more of the namespaces of the thread referred to by that descriptor. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-15pidfd_open.2: Add the setns(2) use case for PID file descriptorsMichael Kerrisk1-0/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
generated by cgit 1.2.3-korg (git 2.43.0) at 2025-12-02 01:58:05 +0000