aboutsummaryrefslogtreecommitdiffstats
path: root/man5
AgeCommit message (Collapse)AuthorFilesLines
2022-08-02proc.5: ffixAlejandro Colomar1-58/+68
an.tmac:man5/proc.5:2010: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2011: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2012: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2013: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2014: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2015: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2016: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2017: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2018: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2019: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2020: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2021: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2022: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2023: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2024: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2025: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2026: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2027: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2028: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2029: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2030: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2031: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2032: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2033: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2034: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2035: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2036: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2037: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2038: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2039: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2040: style: 4 leading space(s) on input line an.tmac:man5/proc.5:2041: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3332: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3333: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3334: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3335: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3336: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3337: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3338: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3339: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3340: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3341: style: 5 leading space(s) on input line an.tmac:man5/proc.5:3342: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3343: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3344: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3345: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3346: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3347: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3348: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3349: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3350: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3351: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3352: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3353: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3354: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3355: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3357: style: 4 leading space(s) on input line an.tmac:man5/proc.5:3359: style: 4 leading space(s) on input line Reported-by: 'make lint-man' Reported-by: groff(1) Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-07-29Many pages: Use STANDARDS instead of CONFORMING TOAlejandro Colomar6-6/+6
STANDARDS seems to be much more extended than CONFORMING TO. For consistency across the whole manual pages corpus, let's try to unify, by following the most commonly used section name. On 7/27/22 12:49, Ingo Schwarze wrote: > Alejandro Colomar wrote on Tue, Jul 26, 2022 at 02:02:56PM +0200: > > We use CONFORMING TO in Linux. Don't know why; just history, I guess. > > See man-pages(7). > > Weird. > > I failed to find a single instance of "CONFORMING TO" in AT&T UNIX > (including v6, PWB, v7, 32v, v8, v10, System III, SVR1, SVR2) nor in > any version of UCB CSRG BSD. So considering that System V and BSD are > widely considered the two main original branches of the development > of Unix-like operating systems and Linux is often considered to have > drawn inspiration from both, the section name "CONFORMING TO" does > not appear to be a UNIX thing. For example, Aeleen Frisch, "Essential > System Administration", O'Reilly, Cambridge 1995, considers Linux > as slightly more influenced by 4.3BSD than by System V Release 3. > > STANDARDS, on the other hand, is present since 4.3BSD-Reno (June 1990). > > 4.3BSD-Reno predates the first version of the Linux kernel by more than > a year, and the first Linux manual pages probably for longer than that. > > So i have no idea where "CONFORMING TO" may have come from. Scripted change: $ find man* -type f | xargs sed -i 's/CONFORMING TO/STANDARDS/' plus a few manual fixes to the following files: - man2/getrlimit.2 - man3/syslog.3 - scripts/bash_aliases Reported-by: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-06-08proc.5: Document bit 57 for /proc/[pid]/pagemapMarco Bonelli1-1/+5
Bit 57 was introduced in Linux v5.14 to reflect the userfaultfd write-protect bit (commit fb8e37f35a2fe1f983ac21850e856e2c7498d469). Signed-off-by: Marco Bonelli <marco@mebeim.net> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-03-20Many pages: Fix style issues reported by `make lint-mandoc`Alejandro Colomar4-10/+17
Plus some other found in the process. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-03-20Many pages: Fix style issues reported by `make lint-groff`Alejandro Colomar15-654/+744
Plus some other found in the process. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-03-14nscd.conf.5: Add debug level descriptionChristian Aistleitner1-0/+4
With only the default debug level documented, neither the possible range of the debug levels nor their purpose was apparent. This made it hard to use debug levels. So we add a short description of them. Signed-off-by: Christian Aistleitner <christian@quelltextlich.at> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-02-25Various pages: [Linux-man-pages-copyleft] Use SPDX-License-IdentifierAlejandro Colomar6-126/+6
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-02-25Various pages: [GPL-2.0-only] Use SPDX-License-IdentifierAlejandro Colomar2-28/+2
$ find man? -type f \ | xargs sed -i '/%%%LICENSE_START(GPLv2/,/%%%LICENSE_END/c\.\\" SPDX-License-Identifier: GPL-2.0-only' Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-02-25Various pages: [GPL-2.0-or-later] Use SPDX-License-IdentifierAlejandro Colomar23-440/+23
$ find man? -type f \ | xargs sed -i '/%%%LICENSE_START(GPLv2+/,/%%%LICENSE_END/c\.\\" SPDX-License-Identifier: GPL-2.0-or-later' Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2022-02-25Various pages: [GPL-1.0-or-later] Use SPDX-License-IdentifierAlejandro Colomar1-3/+1
$ find man? -type f \ | xargs sed -i '/%%%LICENSE_START(GPL_NOVERSION_ONELINE/,/%%%LICENSE_END/c\.\\" SPDX-License-Identifier: GPL-1.0-or-later' Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2021-12-18mount_setattr.2, proc.5, netlink.7, tcp.7: tfixSamanta Navarro1-2/+2
Typos found with codespell. Signed-off-by: Samanta Navarro <ferivoz@riseup.net> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2021-09-11nscd.conf.5: describe reloading, clarificationsGreg Banks1-3/+112
- Added a subsection of NOTES describing nscd's reloading behavior and providing advice on how to configure it. - Clarifications for the threads, reload-count, positive-time-to-live, check-files, and shared attributes. Derived by reading the nscd, libresolv and glibc source and some painful experience. Signed-off-by: Greg Banks <gbanks@linkedin.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2021-08-31proc.5: Fixes various references to kernel docs in Documentation/Michael Kerrisk1-7/+18
Especially the change to .rst format in the kernel Documentation/ tree has rendered many of the references in this manual page obsolete. Fix them. Reported-by: Vito Caputo <vcaputo@pengaru.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-27iconv.1, ldd.1, accept.2, access.2, add_key.2, arch_prctl.2, bpf.2, chmod.2, ↵Michael Kerrisk1-1/+1
chown.2, close_range.2, copy_file_range.2, execve.2, execveat.2, fanotify_mark.2, futex.2, futimesat.2, getpriority.2, intro.2, ioctl_tty.2, keyctl.2, link.2, membarrier.2, mkdir.2, mknod.2, mlock.2, mount.2, mount_setattr.2, open.2, open_by_handle_at.2, perf_event_open.2, pidfd_open.2, readlink.2, readv.2, rename.2, request_key.2, seccomp.2, sigaction.2, stat.2, statx.2, symlink.2, syscalls.2, umount.2, unlink.2, utimensat.2, wait.2, bsearch.3, fflush.3, getaddrinfo.3, getauxval.3, getopt.3, getsubopt.3, mkfifo.3, pthread_mutex_consistent.3, pthread_setname_np.3, pthread_tryjoin_np.3, scandir.3, sem_wait.3, stailq.3, strlen.3, strstr.3, termios.3, tsearch.3, wcslen.3, wcstok.3, wordexp.3, proc.5, capabilities.7, cgroups.7, fanotify.7, mount_namespaces.7, namespaces.7, path_resolution.7, pipe.7, posixoptions.7, user_namespaces.7, vdso.7, iconvconfig.8, ld.so.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-18proc.5: Remove duplicated /proc/[pid]/gid_map entryMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-18proc.5: Add /proc/PID/projid_map, referring reader to user_namespaces(7)Michael Kerrisk1-2/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-18fanotify_mark.2, link.2, mount.2, umount.2, proc.5, cgroups.7, fanotify.7: ↵Michael Kerrisk1-9/+9
Terminology clean-up: "mount point" ==> "mount" Many times, these pages use the terminology "mount point", where "mount" would be better. A "mount point" is the location at which a mount is attached. A "mount" is an association between a filesystem and a mount point. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-09localedef.1, access.2, ioctl_console.2, ioctl_fslabel.2, openat2.2, write.2, ↵Michael Kerrisk2-4/+6
dlsym.3, getopt.3, nl_langinfo.3, termios.3, xcrypt.3, hosts.equiv.5, nsswitch.conf.5, cgroups.7, man-pages.7, netlink.7, system_data_types.7: srcfix: semantic newlines Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-08-08proc.5: 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>
2021-07-26proc.5: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-05-17proc.5: Document /proc/sys/vm/sysctl_hugetlb_shm_groupMichael Kerrisk1-0/+13
As a deprecated feature, it appears that the RLIMIT_MEMLOCK can also be used to permit huge page allocation, but let's not document that for now. In the Linux 5.12, see fs/hugetlbfs/inode.c. static int can_do_hugetlb_shm(void) { kgid_t shm_group; shm_group = make_kgid(&init_user_ns, sysctl_hugetlb_shm_group); return capable(CAP_IPC_LOCK) || in_group_p(shm_group); } ... struct file *hugetlb_file_setup(const char *name, size_t size, vm_flags_t acctflag, struct user_struct **user, int creat_flags, int page_size_log) { ... if (creat_flags == HUGETLB_SHMFS_INODE && !can_do_hugetlb_shm()) { *user = current_user(); if (user_shm_lock(size, *user)) { task_lock(current); pr_warn_once("%s (%d): Using mlock ulimits for SHM_HUGETLB is deprecated\n", current->comm, current->pid); task_unlock(current); } else { *user = NULL; return ERR_PTR(-EPERM); } } ... } Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-03-22getent.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, ↵Michael Kerrisk12-12/+12
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-02-16elf.5: srcfix: Remove idiosyncratic mark-upMichael Kerrisk1-17/+16
This page uses some idiosyncratic mark-up involving the use of a groff register. The mark-up actually makes no difference to the formatted result, but does cause man2html(1) to emit error messages, since it does not understand the mark-up. So, remove that mark-up. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21Various pages: use "\-" to generate real minus in circumstances where ↵Michael Kerrisk4-15/+15
appropriate Use \- for math formulas, pathnames, manual page cross references, etc. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21Various pages: use real minus signs in pathnamesMichael Kerrisk5-6/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-21Various pages: Inside code blocks (.EX/.EE) use \- to get real minus signsMichael Kerrisk6-22/+22
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-10Various pages: srcfix: Remove redundant .PPAlejandro Colomar1-2/+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/+2
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-2/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09Various pages: tfix (Oxford comma)Michael Kerrisk2-3/+3
Found using: git grep -lE '^[^.].*,.*,.*[^,] (and|or)\>' Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-09Various pages: tfix (Oxford comma)Michael Kerrisk4-6/+6
Discovered using: git grep -lE '^[^.].*, [^ ]*[^,] (or|and)\>' 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-06resolv.conf.5: tfixJohn Morris1-1/+1
Change `RES_USE_EDNSO` to `RES_USE_EDNS0`, defined in `resolv.h`. (This is written correctly in `man3/resolver.3` in this same repo.) Helps with grepping and internet searches! Signed-off-by: John Morris <john@zultron.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2021-01-03Various pages: Use .nf/.fi in SYNOPSISMichael Kerrisk6-0/+12
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>
2020-12-30filesystems.5: 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-27ioctl_ns.2, keyctl.2, memfd_create.2, pidfd_send_signal.2, poll.2, ↵Michael Kerrisk2-8/+8
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-21getent.1, access.2, cacheflush.2, chroot.2, clock_getres.2, fcntl.2, ↵Michael Kerrisk5-5/+5
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-20filesystems.5: wfix: ntfs: remove FAT comparisonнаб1-3/+2
The main point I was driving at with this patch was to fix "Microsoft Window's FAT filesystems" (i.e., FAT filesystems which belong to Microsoft Windows, which is decidedly wrong). FAT32 first shipped with MS-DOS 7.1, as part of Windows 95 OSR2, but it's a (relatively) simple logical extension of the previous FATx filesystems (16 and 12 as we know and love them today, I don't think the PC ever saw 8), hence the "VFAT" driver name ‒ calling FAT-anything a Windows filesystem would be a flat-out lie, calling it a Microsoft filesystem would be, uh, facetious. NTFS (as part of Windows NT), on the other hand, is wholly different WRT the scope and feature-set (it does borrow some layouting from FAT, but reading NTFS as FAT doesn't get you very far, or much). The replacing bit is also questionable, especially in a.d. 2020: while it is true that you cannot install NT on FAT (after a certain point? my memory ain't what it used to be), and must therefore replace your existing FAT partitions with NTFS during upgrades; Windows NT 4.0, the last product to be NT-branded came out in 1996, i.e. you could not install Windows on FAT (and, therefore, upgrade it to NTFS, replacing it) during my entire lifetime. Indeed, in $(date +%Y) we live in a post-NTFS world ‒ putting NTFS in the same class as FAT beyond "is a filesystem" is a joke. 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>
2020-12-20filesystems.5: Note ncpfs removal from kernelAhelenia Ziemiańska1-2/+3
Relevant Linux commits: * moved to staging in 1bb8155080c652c4853e6228f8f0d262b3049699 (describe: v4.15-rc1-129-g1bb8155080c6) in Nov 2017, described as "broken" and "obsolete" * purged in bd32895c750bcd2b511bf93917bf7ae723e3d0b6 (describe: v4.17-rc3-1010-gbd32895c750b) in Jun 2018, "since no one has complained or even noticed it was gone" 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>
2020-12-20filesystems.5: Fix link to user space tooling for ncpfsAhelenia Ziemiańska1-1/+1
Corresponds to Linux commit 1b83df308f69a5a3cc59be03bd7fb23e4bcebd8e 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>
2020-12-18elf.5: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-13elf.5: srcfixMichael Kerrisk1-3/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-12-13elf.5: SEE ALSO: add objcopy(1)Michael Kerrisk1-0/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-11-21utmp.5: Oxford commaAlejandro Colomar1-3/+12
Found using: $ grep -rn '\\f., [^ ]*\\f. and' man? I also updated the markup in that paragraph: \f -> . Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> 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 Colomar3-4/+4
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-1/+1
[.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-06proc.5: wfixMichael Kerrisk1-1/+1
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 Kerrisk3-3/+3
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-10-27proc.5: Document inaccurate RSS due to SPLIT_RSS_COUNTINGJann Horn1-2/+34
[mtk: Manually applied patch, because of conflicts with other merged changes; also added an edit suggested by Jann; see the thread at https://lore.kernel.org/linux-man/20201012114940.1317510-1-jannh@google.com/] Since 34e55232e59f7b19050267a05ff1226e5cd122a5 (introduced back in v2.6.34), Linux uses per-thread RSS counters to reduce cache contention on the per-mm counters. With a 4K page size, that means that you can end up with the counters off by up to 252KiB per thread. Example: $ cat rsstest.c #include <stdlib.h> #include <err.h> #include <stdio.h> #include <signal.h> #include <unistd.h> #include <sys/mman.h> #include <sys/eventfd.h> #include <sys/prctl.h> void dump(int pid) { char cmd[1000]; sprintf(cmd, "grep '^VmRSS' /proc/%d/status;" "grep '^Rss:' /proc/%d/smaps_rollup;" "echo", pid, pid ); system(cmd); } int main(void) { eventfd_t dummy; int child_wait = eventfd(0, EFD_SEMAPHORE|EFD_CLOEXEC); int child_resume = eventfd(0, EFD_SEMAPHORE|EFD_CLOEXEC); if (child_wait == -1 || child_resume == -1) err(1, "eventfd"); pid_t child = fork(); if (child == -1) err(1, "fork"); if (child == 0) { if (prctl(PR_SET_PDEATHSIG, SIGKILL)) err(1, "PDEATHSIG"); if (getppid() == 1) exit(0); char *mapping = mmap(NULL, 80 * 0x1000, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0); eventfd_write(child_wait, 1); eventfd_read(child_resume, &dummy); for (int i=0; i<40; i++) mapping[0x1000 * i] = 1; eventfd_write(child_wait, 1); eventfd_read(child_resume, &dummy); for (int i=40; i<80; i++) mapping[0x1000 * i] = 1; eventfd_write(child_wait, 1); eventfd_read(child_resume, &dummy); exit(0); } eventfd_read(child_wait, &dummy); dump(child); eventfd_write(child_resume, 1); eventfd_read(child_wait, &dummy); dump(child); eventfd_write(child_resume, 1); eventfd_read(child_wait, &dummy); dump(child); eventfd_write(child_resume, 1); exit(0); } $ gcc -o rsstest rsstest.c && ./rsstest VmRSS: 68 kB Rss: 616 kB VmRSS: 68 kB Rss: 776 kB VmRSS: 812 kB Rss: 936 kB $ Let's document that those counters aren't entirely accurate. Reported-by: Mark Mossberg <mark.mossberg@gmail.com> Signed-off-by: Jann Horn <jannh@google.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27proc.5: Minor fixesMichael Kerrisk1-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27proc.5: ffix: use a hanging list as is done elsewhere in the pageMichael Kerrisk1-92/+92
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-27proc.5: Update capability requirements for accessing /proc/[pid]/map_filesMichael Kerrisk1-3/+10
The requirements changed with kernel commit 12886f8ab10ce6. 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-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-25proc.5: wfixJing Peng1-8/+1
In the section for /proc/[pid]/smaps, the description of field ProtectionKey occurs twice: both before and after the description of VmFlags. Changes made by this patch: 1) Only the first occurrence is kept because its order matches the output of /proc/[pid]/smaps. 2) The kernel version that CONFIG_X86_INTEL_MEMORY_PROTECTION_KEYS was introduced is only mentioned in the second occurrence. Now it's moved to the first one. Signed-off-by: Jing Peng <pj.hades@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-12resolv.conf.5: Minor edits to Florian Weimer's patchMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-12resolv.conf.5: srcfix: rewrap source linesMichael Kerrisk1-14/+18
No content changes Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-12resolv.5: Document the trust-ad optionFlorian Weimer1-3/+28
Signed-off-by: Florian Weimer <fweimer@redhat.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-10-10locale.5: Decimal points, thousands separators must be one characterFlorian Weimer1-8/+8
This is implied by POSIX because it requires that these strings in the locale definition file contain one symbol. Currently, locale.5 does not document the concept of symbols, this change glosses over that and just uses the term "single-character string". Signed-off-by: Florian Weimer <fweimer@redhat.com> 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-29proc.5: ffix + srcfixMichael Kerrisk1-13/+5
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 Kerrisk1-2/+0
srcfix 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 Kerrisk1-2/+2
mtrace.3, posix_spawn.3, strfromd.3, proc.5: srcfix Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24core.5: srcfixMichael Kerrisk1-1/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-24core.5: ffixMichael Kerrisk1-2/+0
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 Kerrisk2-4/+4
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-12msgctl.2, outb.2, abs.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, ↵Alejandro Colomar1-2/+2
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-11core.5: Use adequate typeAlejandro Colomar1-3/+2
'nread' is of type 'ssize_t' 'tot' adds up different values contained in 'nread', so it should also be 'ssize_t', and not 'int' (which possibly overflows). Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-09proc.5: Note "open file description" as (better) synonym for "file handle"Michael Kerrisk1-1/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-09-05sprof.1, eventfd.2, execve.2, futex.2, getdents.2, mprotect.2, ↵Michael Kerrisk1-2/+2
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-08-13intro.1, clock_getres.2, execve.2, fcntl.2, iopl.2, lseek.2, mknod.2, ↵Michael Kerrisk5-5/+5
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-13drop "coding: UTF-8" headerMike Frysinger1-1/+0
This header is used inconsistently -- man pages are UTF-8 encoded but not setting this marker. It's only respected by the man-db package, and seems a bit anachronistic at this point when UTF-8 is the standard default nowadays. Signed-off-by: Mike Frysinger <vapier@gentoo.org> 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 Kerrisk3-9/+9
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 Kerrisk5-6/+6
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-24Various pages: Trim leading blank comment lineMike Frysinger1-1/+0
Very few pages do this, so trim them. Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-20proc.5: Use "pwd -P" for printing cwdJakub Wilk1-10/+1
"/bin/pwd" happens to work with the GNU coreutils implementation, which has -P as the default, contrary to POSIX requirements. Use "pwd -P" instead, which is shorter, easier to type, and should work everywhere. Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-20proc.5: tfixJakub Wilk1-1/+1
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> 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 Kerrisk3-15/+15
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-06resolv.conf.5: Clarify that ip6-bytestring was removed in 2.25Michael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06proc.5: srcfixMichael Kerrisk1-3/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-06proc.5: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-07-02man5/*: ffix: change '-' to '\-' for optionsBjarni Ingi Gislason1-1/+1
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-30hosts.5: Clarify capability for IPv6 outside of examplesThomas Bartelsmeier1-0/+3
Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279 Signed-off-by: Thomas Bartelsmeier <t.bartelsmeier@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26locale.5: srcfixMichael Kerrisk1-2/+0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-26locale.5: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-21proc.5: srcfix: trim trailing spaceBjarni Ingi Gislason1-3/+3
Output is from: test-groff -b -mandoc -T utf8 -rF0 -t -w w -z [ "test-groff" is a developmental version of "groff" ] Input file is ./proc.5 troff: <proc.5>:4410: warning: trailing space troff: <proc.5>:5206: warning: trailing space troff: <proc.5>:5488: warning: trailing space ### There is no change in the output from "nroff" and "groff". Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-19getdtablesize.2, sigqueue.2, clock_getres.3, clock_gettime.3, ↵Michael Kerrisk2-7/+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-19proc.5: Inform that comm in /proc/pid/{stat,status} might also be truncatedArkadiusz Drabczyk1-0/+6
pgrep for example searches for a process name in /proc/pid/status and therefore cannot find processes whose names are longer than 15 characters unless -f is specified. Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-11proc.5: srcfixMichael Kerrisk1-5/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-10proc.5: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-10proc.5: ffixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09iconv.1, locale.1, memusage.1, memusagestat.1, pldd.1, sprof.1, _syscall.2, ↵Michael Kerrisk12-12/+12
add_key.2, adjtimex.2, bind.2, bpf.2, chown.2, clone.2, close.2, copy_file_range.2, eventfd.2, fanotify_init.2, fanotify_mark.2, fork.2, fsync.2, futex.2, getdents.2, getrlimit.2, getxattr.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, ioctl_fat.2, ioctl_getfsmap.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, kcmp.2, keyctl.2, listen.2, listxattr.2, mbind.2, membarrier.2, memfd_create.2, mkdir.2, move_pages.2, mremap.2, msync.2, nfsservctl.2, open.2, perf_event_open.2, pidfd_send_signal.2, pipe.2, pivot_root.2, pkey_alloc.2, process_vm_readv.2, ptrace.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, s390_runtime_instr.2, sched_setaffinity.2, seccomp.2, send.2, sendmmsg.2, sigaltstack.2, signalfd.2, socket.2, socketpair.2, splice.2, spu_create.2, spu_run.2, statfs.2, syscall.2, sysctl.2, sysfs.2, tee.2, timer_getoverrun.2, timer_settime.2, umount.2, userfaultfd.2, utimensat.2, wait4.2, INFINITY.3, __ppc_get_timebase.3, __setfpucw.3, abort.3, aio_cancel.3, aio_error.3, aio_read.3, aio_return.3, atexit.3, backtrace.3, basename.3, bsearch.3, bswap.3, cacos.3, cacosh.3, catan.3, catanh.3, cexp2.3, clock_getcpuclockid.3, clog2.3, cmsg.3, confstr.3, div.3, dl_iterate_phdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, err.3, expm1.3, fdim.3, flockfile.3, fmtmsg.3, frexp.3, ftw.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo_a.3, getauxval.3, getdate.3, getdtablesize.3, getgrent_r.3, getgrouplist.3, gethostbyname.3, getline.3, getnameinfo.3, getopt.3, getprotoent_r.3, getpwent_r.3, getpwnam.3, getservent_r.3, getsubopt.3, getutent.3, glob.3, gnu_get_libc_version.3, hsearch.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, insque.3, killpg.3, makecontext.3, mallinfo.3, malloc.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbstowcs.3, mcheck.3, mempcpy.3, mq_getattr.3, mq_notify.3, mtrace.3, newlocale.3, nextafter.3, ntp_gettime.3, offsetof.3, open_memstream.3, pow.3, printf.3, pthread_attr_init.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setstack.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_detach.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_mutex_consistent.3, pthread_mutexattr_setrobust.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_spin_init.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, qsort.3, rand.3, random.3, remainder.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, sem_getvalue.3, sem_wait.3, setaliasent.3, setlogmask.3, sigwait.3, sincos.3, sockatmark.3, stdarg.3, stpcpy.3, strcat.3, strfmon.3, strptime.3, strtod.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, tsearch.3, uselocale.3, wcstok.3, wcstombs.3, wordexp.3, y0.3, loop.4, vcs.4, veth.4, charmap.5, core.5, filesystems.5, gai.conf.5, hosts.5, hosts.equiv.5, locale.5, nss.5, repertoiremap.5, securetty.5, shells.5, ttytype.5, ascii.7, complex.7, cpuset.7, credentials.7, fanotify.7, hier.7, inotify.7, ip.7, mount_namespaces.7, mq_overview.7, netlink.7, network_namespaces.7, pid_namespaces.7, pkeys.7, rtld-audit.7, rtnetlink.7, sem_overview.7, signal-safety.7, sock_diag.7, spufs.7, standards.7, symlink.7, tcp.7, time_namespaces.7, unix.7, user_namespaces.7, xattr.7, ldconfig.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09openat2.2, proc.5, bpf-helpers.7: srcfix: strip trailing whitespaceMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09proc.5: Add a detail to /proc/[pid]/commMichael Kerrisk1-0/+6
Note the connection to the "%e" specifier in /proc/sys/kernel/core_pattern. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09proc.5: TASK_COMM_LEN limit includes the terminating '\0'Michael Kerrisk1-1/+1
Clarify this detail in the discussion of /proc/[pid]/comm. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09core.5: minor tweaksMichael Kerrisk1-15/+15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-09core.5: Explain that core_pattern %e is process/thread 'comm' valueMichael Kerrisk1-1/+11
The 'comm' value is typically the same as the (possibly truncated) executable name, but may be something different. Reported-by: Jonny Grant <jg@jguk.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-08core.5: Note that not dumping core of an unreadable binary is a security measureMichael Kerrisk1-0/+4
Reported-by: Jonny Grant <jg@jguk.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-08core.5: wfixMichael Kerrisk1-3/+3
Reported-by: Jonny Grant <jg@jguk.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-06-08proc.5: ffixJakub Wilk1-2/+2
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-31Various pages: retitle EXAMPLE section heading to EXAMPLESMichael Kerrisk9-9/+9
EXAMPLES appears to be the wider majority usage across various projects' manual pages, and is also what is used in the POSIX manual pages. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-28core.5: tfixMichael Kerrisk1-1/+1
Reported-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-28core.5: Mention 'sysctl -w' as a way of changing core_pattern settingMichael Kerrisk1-1/+13
Reported-by: Jonny Grant <jg@jguk.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-28core.5: ffixMichael Kerrisk1-2/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-27core.5: ffixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-26proc.5: Remove "mp" under VmFlags in /proc/[pid]/smapsMichael Kerrisk1-1/+0
Reported-by: Kirill A. Shutemov <kirill@shutemov.name> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Add "sf" to VmFlags in /proc/[pid]/smapsMichael Kerrisk1-0/+1
Added in kernel commit b6fb293f2497a9841d94f6b57bd2bb2cd222da43 Text from comment in include/uapi/asm-generic/mman.h. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Add "um" and "uw" to VmFlags in /proc/[pid]/smapsMichael Kerrisk1-0/+2
Added in kernel commit 16ba6f811dfe44bc14f7946a4b257b85476fc16e. Text taken from comments in include/linux/mm.h. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Add "mp" to VmFlags in /proc/[pid]/smapsMichael Kerrisk1-0/+1
Added in kernel commit 4aae7e436fa51faf4bf5d11b175aea82cfe8224a. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Note kernel version for /proc/PID/smaps VmFlags "dd" flagMichael Kerrisk1-1/+1
Kernel commit ec8e41aec13005fed0dbee002fb8c99b4e001d50 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Note kernel version that removed /proc/PID/smaps VmFlags "nl" flagMichael Kerrisk1-1/+1
Kernel commit 1da4b35b001481df99a6dcab12d5d39a876f7056 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Note kernel version for /proc/PID/smaps VmFlags "wf" flagMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-25proc.5: Add "wf" to VmFlags in /proc/[pid]/smapsIan Rogers1-0/+1
This patch documents a flag added in the following kernel commit: commit d2cd9ede6e193dd7d88b6d27399e96229a551b19 Author: Rik van Riel <riel@redhat.com> Date: Wed Sep 6 16:25:15 2017 -0700 mm,fork: introduce MADV_WIPEONFORK This was already documented in man2/madvise.2 in the commit: commit c0c4f6c29c494c466f3a2a6273c5b55b76a72927 Author: Rik van Riel <riel@redhat.com> Date: Tue Sep 19 20:32:00 2017 +0200 madvise.2: Document MADV_WIPEONFORK and MADV_KEEPONFORK Signed-off-by: Ian Rogers <irogers@google.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-05-15filesystems.5: SEE ALSO: add sysfs(5) and xfs(5)Michael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-27tzfile.5: Sync to 2020a tzdb releaseMichael Kerrisk1-33/+255
From https://www.iana.org/time-zones, version 2020a. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-21proc.5: Alert the reader that UID/GID changes can reset the "dumpable" attributeMichael Kerrisk1-0/+6
Reported-by: Eric Hopper <hopper@omnifarious.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-21tzfile.5: Explain UT abbreviationMichael Kerrisk1-0/+1
From a conversation with Paul Eggert: From: Paul Eggert <eggert@cs.ucla.edu> Subject: Re: Errors in man pages, here: tzfile(5): Typo? On 4/20/20 12:27 AM, Michael Kerrisk (man-pages) wrote: > I think "UT" here is intended to mean "Universal Time", and as such > should not be "UTC". Perhaps Paul can comment. Yes, that's right. The tzfile format covers timestamps that predate the introduction of UTC in 1960, so the documentation uses the sloppier and more-general term "UT" instead of the more-precise term "UTC". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20locale.5: Improve description of 'first_weekday'Michael Kerrisk1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20proc.5: tfixMichael Kerrisk1-21/+21
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20proc.5: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20networks.5: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20securetty.5: Improve wording of .SH one-line descriptionMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20proc.5: Minor tweaks to /proc/[pid]/mountstats example lineMichael Kerrisk1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20proc.5: Better explanation of some /proc/ide fieldsMichael Kerrisk1-2/+2
Taken from Documentation/filesystems/proc.txt. Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20proc.5: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-20proc.5: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19utmp.5: tfixMichael Kerrisk1-2/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19utmp.5: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19termcap.5: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19proc.5: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19pipe.2, st.4, filesystems.5: tfixMichael Kerrisk1-2/+2
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19proc.5: wfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-19filesystems.5: tfixMichael Kerrisk1-1/+1
Reported-by: Helge Kreutzmann <debian@helgefjell.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-13proc.5: Document /proc/sys/fs/protected_regularMichael Kerrisk1-0/+26
Text heavily based on Documentation/admin-guide/sysctl/fs.rst. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-13proc.5: Document /proc/sys/fs/protected_fifosMichael Kerrisk1-0/+22
Text heavily based on Documentation/admin-guide/sysctl/fs.rst. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-13proc.5: Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nrMichael Kerrisk1-0/+18
Text taken nearly verbatim from Documentation/admin-guide/sysctl/fs.rst. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-13proc.5: Minor tweaks to Keno Fischer's patchMichael Kerrisk1-2/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-13proc.5: Fix an outdated note about map_filesKeno Fischer1-8/+10
The restriction to CAP_SYS_ADMIN was removed from map_files in 2015 [1]. There was a fixme that indicted this might happen, but the main text was never updated when this commit landed. While we're at it, add a note about the ptrace access check that is still required. [1] https://github.com/torvalds/linux/commit/bdb4d100afe9818aebd1d98ced575c5ef143456c Signed-off-by: Keno Fischer <keno@juliacomputing.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-11getent.1, localedef.1, accept.2, arch_prctl.2, clock_getres.2, ↵Michael Kerrisk4-4/+4
clock_nanosleep.2, connect.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, execve.2, getitimer.2, getsockopt.2, gettid.2, inotify_add_watch.2, inotify_init.2, io_submit.2, ioctl.2, lseek.2, madvise.2, mlock.2, mmap.2, mprotect.2, msgctl.2, msgop.2, open_by_handle_at.2, openat2.2, pidfd_open.2, poll.2, prctl.2, quotactl.2, s390_sthyi.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, setns.2, shmctl.2, shmget.2, shmop.2, sigaction.2, stat.2, statx.2, syscalls.2, timer_create.2, timerfd_create.2, unshare.2, wait.2, CPU_SET.3, aio_init.3, atoi.3, des_crypt.3, dirfd.3, fmemopen.3, fopencookie.3, ftok.3, fts.3, getaddrinfo.3, getifaddrs.3, getrpcent.3, gsignal.3, lio_listio.3, nl_langinfo.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, scanf.3, sem_init.3, sem_post.3, shm_open.3, strcmp.3, strftime.3, st.4, elf.5, group.5, proc.5, services.5, aio.7, cgroups.7, feature_test_macros.7, keyrings.7, man-pages.7, namespaces.7, path_resolution.7, sigevent.7, signal.7, socket.7, sysvipc.7, time.7, udp.7: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-11proc.5: ffixMichael Kerrisk1-2/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-04-10proc.5: Clarify /proc/[pid]/cmdline mutabilityMike Frysinger1-0/+12
The cmdline file is a window into memory that is controlled by the target process, and that memory may be changed arbitrarily, as can the window via prctl settings. Make sure people understand that this file is all an illusion. Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-03-12proc.5: tfixJakub Wilk1-96/+96
Escape hyphens. Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23filesystems.5: tfixEugene Syromyatnikov1-1/+1
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23getent.1, localedef.1, clock_nanosleep.2, fcntl.2, getitimer.2, ↵Michael Kerrisk4-14/+14
getsockopt.2, inotify_init.2, ioctl.2, mlock.2, mprotect.2, quotactl.2, s390_sthyi.2, semctl.2, shmctl.2, shmget.2, wait.2, CPU_SET.3, aio_init.3, des_crypt.3, fmemopen.3, fopencookie.3, fts.3, getaddrinfo.3, getrpcent.3, lio_listio.3, posix_spawn.3, shm_open.3, st.4, elf.5, group.5, proc.5, services.5, aio.7, feature_test_macros.7, keyrings.7, man-pages.7, sigevent.7, tcp.7, udp.7: Global formatting fix: disfavor nonstandard .TP indents In many cases, these don't improve readability, and (when stacked) they sometimes have the side effect of sometimes forcing text to be justified within a narrow column range. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-01-21proc.5: Document /proc/sys/vm/unprivileged_userfaultfdMichael Kerrisk1-0/+13
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-12-11elf.5: tfixMichael Kerrisk1-2/+2
Reported-by: Robin Kuzmin <kuzmin.robin@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-11-19clone.2, fallocate.2, ioctl_iflags.2, ioctl_list.2, pidfd_open.2, ↵Michael Kerrisk1-1/+1
pivot_root.2, quotactl.2, seccomp.2, select.2, wait.2, proc.5, cgroups.7, netdevice.7, uts_namespaces.7: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-11-07resolv.conf.5: srcfixMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-11-07resolv.conf.5: Attempt clarify domain/search interactionFlorian Weimer1-21/+20
The domain directive is historic at this point; it should not be used. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-10-31clone.2, proc.5: Adjust references to namespaces(7)Michael Kerrisk1-1/+1
Adjust references to namespaces(7) to be references to pages describing specific namespace types. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-10-11localedef.1, close.2, copy_file_range.2, execve.2, get_robust_list.2, ↵Michael Kerrisk2-2/+2
getdomainname.2, gethostname.2, inotify_add_watch.2, io_submit.2, ioctl_fideduperange.2, kcmp.2, kill.2, mmap.2, move_pages.2, perf_event_open.2, ptrace.2, rt_sigqueueinfo.2, sched_setaffinity.2, sched_setparam.2, setns.2, sigaction.2, signalfd.2, statx.2, syscall.2, syscalls.2, uname.2, write.2, errno.3, fexecve.3, getauxval.3, printf.3, pthread_mutex_consistent.3, pthread_mutexattr_init.3, pthread_mutexattr_setrobust.3, pthread_setcancelstate.3, regex.3, strtok.3, strtol.3, ttyname.3, smartpqi.4, core.5, resolv.conf.5, man-pages.7, mq_overview.7, operator.7, pthreads.7, signal-safety.7, sysvipc.7: Update timestamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-09-13resolv.conf.5: srcfixMichael Kerrisk1-2/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-09-13resolv.conf.5: Update information about search listNikola Forró1-1/+3
Since glibc 2.26, the number of domains in the search list is no longer limited. Reference: https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=3f853f22c87f0b671c0366eb290919719fa56c0e Signed-off-by: Nikola Forró <nforro@redhat.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-09-13core.5: Minor tweaks to Paul Wise's patchMichael Kerrisk1-6/+12
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-09-13core.5: Explain the new situation with argument splittingPaul Wise1-0/+14
Things changed in Linux v5.3-rc3 commit 315c69261dd3 from splitting after template expansion to splitting beforehand. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-08-03proc.5: tfixJakub Wilk1-2/+2
Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-08-02proc.5: ffixIngo Schwarze1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-08-02proc.5: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-08-02pldd.1, bpf.2, chdir.2, clone.2, fanotify_init.2, fanotify_mark.2, intro.2, ↵Michael Kerrisk1-1/+1
ipc.2, mount.2, mprotect.2, msgctl.2, msgget.2, msgop.2, pivot_root.2, pkey_alloc.2, poll.2, prctl.2, semctl.2, semget.2, semop.2, setxattr.2, shmctl.2, shmget.2, shmop.2, tkill.2, dlopen.3, exec.3, ftok.3, getutent.3, on_exit.3, strcat.3, cpuid.4, proc.5, capabilities.7, cgroup_namespaces.7, credentials.7, fanotify.7, mount_namespaces.7, namespaces.7, sched.7, signal.7, socket.7, unix.7, user_namespaces.7, vdso.7, xattr.7, ld.so.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-07-10proc.5: Correct description of /pro/PID/status 'ShdPnd' and 'SigPnd' fieldsMichael Kerrisk1-1/+2
These fields are signal masks, not counters. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-07-10proc.5: Clarify that various mask fields in /proc/PID/status are in hexadecimalMichael Kerrisk1-5/+7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-07-10proc.5: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-06-25ipc.5: Remove old link to svipc.7/sysvipc.7 pageMichael Kerrisk1-1/+0
Long ago, the sysvipc.7 page was called ipc.5, which was both a misnaming (too general a name) and an inconsistent section. The page was renamed (to svipc.7) many years ago, and the link with the old name has probably ceased to be needed. So, remove it. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-06-25clone.2, intro.2, ipc.2, msgctl.2, msgget.2, msgop.2, semctl.2, semget.2, ↵Michael Kerrisk1-1/+1
semop.2, shmctl.2, shmget.2, shmop.2, ftok.3, proc.5, namespaces.7: Change reference to svipc(7) to sysvipc(7) Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-06-18proc.5: Minor fix: add some paragraph breaks to /proc/[pid]/attr/current textMichael Kerrisk1-0/+2
Break the text up a little, to improve readability. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-05-28elf.5: SEE ALSO: add ld.so(8)Michael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-05-09execve.2, setfsgid.2, setfsuid.2, splice.2, fopen.3, malloc_trim.3, ↵Michael Kerrisk1-1/+1
posix_memalign.3, stdarg.3, sysconf.3, tsearch.3, elf.5, hostname.7, inode.7: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-05-06intro.1, execve.2, getcontext.3, passwd.5, bpf-helpers.7: wfixJakub Wilk1-1/+1
Use gender-neutral pronouns. Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-04-15elf.5: A data segment does not have PF_XMichael Kerrisk1-2/+1
Reported-by: Keegan Saunders <keeganwsaunders@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-03-20core.5: tfixJakub Wilk1-9/+9
Escape hyphens. Signed-off-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-03-08proc.5 Add missing Inode field to /proc/net/unixMichael Witten1-3/+6
Signed-off-by: Anisse Astier <anisse@astier.eu> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-03-06getent.1, iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, ↵Michael Kerrisk10-10/+10
pldd.1, sprof.1, time.1, _syscall.2, accept.2, add_key.2, adjtimex.2, bind.2, bpf.2, capget.2, chown.2, chroot.2, clock_getres.2, clone.2, connect.2, copy_file_range.2, epoll_ctl.2, epoll_wait.2, eventfd.2, fanotify_init.2, fanotify_mark.2, fcntl.2, fsync.2, futex.2, getcpu.2, getdents.2, getgid.2, getgroups.2, getpid.2, gettid.2, gettimeofday.2, getuid.2, getxattr.2, inotify_add_watch.2, inotify_init.2, ioctl_fat.2, ioctl_ns.2, ioctl_userfaultfd.2, ioprio_set.2, kcmp.2, kexec_load.2, keyctl.2, listxattr.2, lseek.2, madvise.2, memfd_create.2, migrate_pages.2, mount.2, mprotect.2, mremap.2, msgctl.2, msgop.2, nfsservctl.2, open_by_handle_at.2, perf_event_open.2, pipe.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, readahead.2, readdir.2, readlink.2, reboot.2, recvmmsg.2, removexattr.2, rename.2, request_key.2, s390_guarded_storage.2, s390_runtime_instr.2, s390_sthyi.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, seccomp.2, select.2, select_tut.2, semctl.2, sendmmsg.2, set_thread_area.2, setgid.2, setns.2, setuid.2, setxattr.2, shmctl.2, sigaction.2, signalfd.2, sigsuspend.2, socket.2, socketpair.2, spu_run.2, stat.2, statx.2, subpage_prot.2, syscalls.2, sysctl.2, tee.2, timer_create.2, timerfd_create.2, truncate.2, uname.2, unshare.2, userfaultfd.2, ustat.2, vmsplice.2, write.2, CPU_SET.3, __ppc_get_timebase.3, alloca.3, argz_add.3, asprintf.3, backtrace.3, basename.3, bsd_signal.3, bstring.3, bswap.3, bzero.3, cacos.3, cacosh.3, catan.3, catanh.3, catgets.3, clock_getcpuclockid.3, cmsg.3, confstr.3, ctermid.3, ctime.3, des_crypt.3, dl_iterate_phdr.3, dlinfo.3, dlsym.3, duplocale.3, end.3, endian.3, errno.3, exec.3, exit.3, ferror.3, fgetws.3, fmemopen.3, fnmatch.3, fopencookie.3, fputws.3, frexp.3, ftw.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getgrouplist.3, getifaddrs.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getopt.3, getpass.3, getprotoent_r.3, getpwnam.3, getservent_r.3, getsubopt.3, glob.3, gnu_get_libc_version.3, hsearch.3, if_nameindex.3, index.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, isatty.3, iswblank.3, iswspace.3, lockf.3, makecontext.3, mallinfo.3, malloc.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbrtowc.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memchr.3, mq_getattr.3, mq_notify.3, newlocale.3, nl_langinfo.3, offsetof.3, perror.3, posix_spawn.3, printf.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_setaffinity_np.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, putenv.3, qsort.3, rand.3, random.3, readdir.3, regex.3, resolver.3, rpmatch.3, rtime.3, scanf.3, sem_wait.3, setaliasent.3, setbuf.3, stpcpy.3, stpncpy.3, strcat.3, strchr.3, strcmp.3, strcpy.3, strdup.3, strerror.3, strfromd.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strsep.3, strstr.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, system.3, termios.3, trunc.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscat.3, wcscpy.3, wcslen.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wcsstr.3, wcstok.3, wcstombs.3, wcwidth.3, wprintf.3, xcrypt.3, console_codes.4, dsp56k.4, full.4, initrd.4, lirc.4, loop.4, st.4, tty.4, vcs.4, charmap.5, core.5, host.conf.5, locale.5, proc.5, repertoiremap.5, resolv.conf.5, termcap.5, tmpfs.5, tzfile.5, aio.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, complex.7, epoll.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, locale.7, man-pages.7, man.7, namespaces.7, pid_namespaces.7, pkeys.7, pthreads.7, rtld-audit.7, sched.7, signal.7, sock_diag.7, socket.7, tcp.7, udp.7, unicode.7, user_namespaces.7, utf-8.7, zdump.8, zic.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-27locale.1, memusage.1, pldd.1, _syscall.2, add_key.2, bind.2, bpf.2, chown.2, ↵Michael Kerrisk8-16/+16
clone.2, copy_file_range.2, eventfd.2, execve.2, futex.2, getdents.2, getrlimit.2, ioctl_fat.2, ioctl_ns.2, kcmp.2, kexec_load.2, keyctl.2, listxattr.2, lseek.2, membarrier.2, memfd_create.2, mmap.2, mprotect.2, msgop.2, open_by_handle_at.2, perf_event_open.2, pipe.2, readdir.2, readlink.2, readv.2, recvmmsg.2, request_key.2, sched_setaffinity.2, seccomp.2, select.2, select_tut.2, sendmmsg.2, setns.2, signalfd.2, spu_run.2, stat.2, sysctl.2, tee.2, timer_create.2, timerfd_create.2, truncate.2, uname.2, unshare.2, userfaultfd.2, ustat.2, wait.2, CPU_SET.3, __ppc_get_timebase.3, argz_add.3, asprintf.3, backtrace.3, basename.3, bswap.3, bzero.3, cacos.3, cacosh.3, catan.3, catanh.3, catgets.3, clock_getcpuclockid.3, confstr.3, ctime.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, end.3, endian.3, fgetws.3, fmemopen.3, fopencookie.3, fputws.3, frexp.3, ftw.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getgrouplist.3, getifaddrs.3, getline.3, getlogin.3, getopt.3, getpass.3, getprotoent_r.3, getpwnam.3, getservent_r.3, getsubopt.3, glob.3, gnu_get_libc_version.3, hsearch.3, if_nameindex.3, index.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, iswblank.3, iswspace.3, makecontext.3, mallinfo.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbrtowc.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memchr.3, mq_getattr.3, mq_notify.3, newlocale.3, nl_langinfo.3, offsetof.3, perror.3, posix_spawn.3, printf.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_mutexattr_setrobust.3, pthread_setaffinity_np.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, qsort.3, rand.3, readdir.3, regex.3, rpmatch.3, rtime.3, scanf.3, sem_wait.3, setaliasent.3, setbuf.3, stpcpy.3, stpncpy.3, strcat.3, strchr.3, strcpy.3, strdup.3, strerror.3, strfromd.3, strftime.3, strlen.3, strnlen.3, strsep.3, strstr.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, termios.3, tsearch.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscat.3, wcscpy.3, wcslen.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wcsstr.3, wcstok.3, wcstombs.3, wcwidth.3, wprintf.3, console_codes.4, dsp56k.4, full.4, initrd.4, loop.4, vcs.4, charmap.5, core.5, elf.5, locale.5, proc.5, repertoiremap.5, sysfs.5, termcap.5, aio.7, bpf-helpers.7, cgroups.7, charsets.7, complex.7, fanotify.7, feature_test_macros.7, inotify.7, locale.7, man-pages.7, man.7, pkeys.7, pthreads.7, rtld-audit.7, sock_diag.7, unix.7, user_namespaces.7, utf-8.7: Use '\e' rather than '\\' to get a backslash Quoting Branden: *roff escape sequences may sometimes look like C escapes, but that is misleading. *roff is in part a macro language and that means recursive expansion to arbitrary depths. You can get away with "\\" in a context where no macro expansion is taking place, but try to spell a literal backslash this way in the argument to a macro and you will likely be unhappy with results. Try viewing the attached file with "man -l". "\e" is the preferred and portable way to get a portable "escape literal" going back to CSTR #54, the original Bell Labs troff paper. groff(7) discusses the issue: \\ reduces to a single backslash; useful to delay its interpretation as escape character in copy mode. For a printable backslash, use \e, or even better \[rs], to be independent from the current escape character. As of groff 1.22.4, groff_man(7) does as well: \e Widely used in man pages to represent a backslash output glyph. It works reliably as long as the .ec request is not used, which should never happen in man pages, and it is slightly more portable than the more exact ‘\(rs’ (“reverse solidus”) escape sequence. People not concerned with portability to extremely old troffs should probably just use \(rs (or \[rs]), as it means "the backslash glyph", not "the glyph corresponding to whatever the current escape character is". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-27adjtimex.2, futex.2, mremap.2, seccomp.2, getnameinfo.3, random.3, ↵Michael Kerrisk1-1/+1
console_codes.4, sysfs.5, sched.7, unicode.7: Use zero‐width space in appropriate locations Quoting Branden: *roff systems will interpret the period in the unpatched page as sentence-ending punctuation and put inter-sentence spacing after it. (This might not be visible on nroff/terminal devices, but it is more likely to be on typesetter/PostScript/PDF output). groff_man(7) in groff 1.22.4 attempts to throw man page writers a bone here: \& Zero‐width space. Append to an input line to prevent an end‐of‐ sentence punctuation sequence from being recognized as such, or insert at the beginning of an input line to prevent a dot or apostrophe from being interpreted as the beginning of a roff request. Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-27man5/g-n.5: srcfix: Use a single-font-style macro for a single argumentBjarni Ingi Gislason5-18/+18
Use a single-font-style macro (".B", ".I") for a single argument. The output from "nroff" and "groff" is unchanged, except for the 1) change of '-.' to '\- .' in the file "locale.5" 2) change of some '-' to '\-' in the file "locale.5". Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-27proc.5: tfixMichael Kerrisk1-1/+1
Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-27tzfile.5: tfixMichael Kerrisk1-1/+1
Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-25filesystems.5: Minor wording fixesMichael Kerrisk1-3/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-25filesystems.5: Minor tweaks to Eugene Syromyatnikov's patchMichael Kerrisk1-4/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-25filesystems.5: Mention sysfs(2)Eugene Syromyatnikov1-0/+11
* man5/filesystems.5 (.SH DESCRIPTION): Add a note that the information about available file systems can be obtained via sysfs() syscall. Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-02-01proc.5: SEE ALSO: add htop(1) and pstree(1)Michael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-01-25proc.5: Since Linux 4.5, "stack:" is no longer shown in /proc/PID/mapsMichael Kerrisk1-2/+5
Reported-by: Nick Gregory <ghost@capsule8.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2019-01-25proc.5: Mention /proc/uptime includes time spent in suspendStephan Knauss1-2/+3
fs/proc/uptime.c:uptime_proc_show() fetches time using ktime_get_boottime which includes the time spent in suspend. Signed-off-by: Stephan Knauss <linux@stephans-server.de> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-12-14proc.5: Refer to mount(2) for explanation of mount vs superblock optionsMichael Kerrisk1-2/+4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-20proc.5: Minor clean-ups for Alan Jenkins' patchMichael Kerrisk1-4/+10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-20proc.5: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-20proc.5: Vmalloc information is no longer calculated (Linux 4.4)Alan Jenkins1-2/+6
See Linux commit a5ad88ce8c7fae7ddc72ee49a11a75aa837788e0, "mm: get rid of 'vmalloc_info' from /proc/meminfo". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-19clone.2, prctl.2, st.4, proc.5: Change references to '2.6.0-test*' series ↵Michael Kerrisk1-4/+8
kernels to just '2.6.0' The extra detail has little of noting with -test 2.6.0 added a particular feature has little value these days, and is likely to confuse some readers who don't know (and probably don't care) about the historical details. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-17ioctl_userfaultfd.2, madvise.2, memfd_create.2, migrate_pages.2, mmap.2, ↵Mike Rapoport3-14/+14
shmget.2, subpage_prot.2, userfaultfd.2, malloc.3, proc.5, sysfs.5, tmpfs.5: Update paths for in-kernel memory management documentation files Signed-off-by: Mike Rapoport <rppt@linux.ibm.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: ffix: break /proc/[pid]/task text into smaller paragraphsMichael Kerrisk1-0/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: srcfixMichael Kerrisk1-1/+2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: tfixMichael Kerrisk1-3/+3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: Minor reworking of description of /proc/[tid] directoriesMichael Kerrisk1-0/+6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: wfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: Document /proc/PID/status CoreDumping fieldMichael Kerrisk1-0/+10
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: tfixMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: /proc/[pid]/status VmPMD field was removed in Linux 4.15Michael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: Document /proc/Meminfo LazyFree fieldMichael Kerrisk1-0/+5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: Fix kernel source pathname for soft-dirty documentationMichael Kerrisk1-1/+1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05proc.5: Document /proc/meminfo KReclaimable fieldMichael Kerrisk1-0/+7
Added in Linux 4.20. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>