diff options
| author | Dr. Tobias Quathamer <toddy@debian.org> | 2019-10-12 14:23:41 +0200 |
|---|---|---|
| committer | Dr. Tobias Quathamer <toddy@debian.org> | 2019-10-12 14:23:41 +0200 |
| commit | f4aa4330f5673fcda07ddebdb3ec08826a1cf076 (patch) | |
| tree | c78da42a145efaf79eea0913a951d6246b1ddc6a | |
| parent | c10d26684ab7559f2a0a9b038b4b95b0bed8a6c9 (diff) | |
New upstream version 5.03
1052 files changed, 3659 insertions, 1781 deletions
diff --git a/CONTRIBUTING b/CONTRIBUTING new file mode 100644 index 000000000..4977ba3ba --- /dev/null +++ b/CONTRIBUTING @@ -0,0 +1,13 @@ +For general information about how to contribute, see: +https://www.kernel.org/doc/man-pages/contributing.html + +For information on how to send patches, see: +https://www.kernel.org/doc/man-pages/patches.html + +For a description of the preferred layout of manual pages, +as well as some style guide notes, see: + + $ man 7 man-pages + +For information about reporting bugs, see: +https://www.kernel.org/doc/man-pages/reporting_bugs.html @@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.02 ==================== +==================== Changes in man-pages-5.03 ==================== -Released: 2019-08-02, Munich +Released: 2019-10-10, Munich Contributors @@ -10,290 +10,369 @@ The following people contributed patches/fixes or (noted in brackets in the changelog below) reports, notes, and ideas that have been incorporated in changes in this release: -Alan Stern <stern@rowland.harvard.edu> -Alexey Izbyshev <izbyshev@ispras.ru> +Adam Borowski <kilobyte@angband.pl> +Aleksa Sarai <asarai@suse.de> +Alexey Budankov <alexey.budankov@linux.intel.com> Amir Goldstein <amir73il@gmail.com> -Cyrill Gorcunov <gorcunov@gmail.com> -Eric Sanchis <eric.sanchis@iut-rodez.fr> -Eugene Syromyatnikov <evgsyr@gmail.com> -Finn O'Leary <finnoleary@inventati.org> -Florian Weimer <fweimer@redhat.com> -G. Branden Robinson <g.branden.robinson@gmail.com> -Guillaume Laporte <guillaume.laporte.adm@gmail.com> +Andrew Clayton <andrew@digital-domain.net> +Carlos O'Donell <carlos@redhat.com> +Christian Brauner <christian@brauner.io> +Christopher M. Riedl <cmr@informatik.wtf> +Daniel Colascione <dancol@google.com> +Dave Carroll <david.carroll@microsemi.com> +Dave Chinner <dchinner@redhat.com> +Дилян Палаузов <dilyan.palauzov@aegee.org> +Dmitry V. Levin <ldv@altlinux.org> +Don Brace <don.brace@microsemi.com> +eponymous alias <eponymousalias@yahoo.com> +Eric Biggers <ebiggers@google.com> +Eric W. Biederman <ebiederm@xmission.com> +Florian Weimer <fw@deneb.enyo.de> +Florin Blanaru <florin.blanaru96@gmail.com> +Gilbert Wu <gilbert.wu@microsemi.com> +Ingo Schwarze <schwarze@usta.de> Jakub Wilk <jwilk@jwilk.net> -Jan Kara <jack@suse.cz> -Kumar Chaudhary, Naveen <naveen.kumar.chaudhary@intel.com> -Mark Wielaard <mark@klomp.org> -Matthew Bobrowski <mbobrowski@mbobrowski.org> -Matthew Kenigsberg <matthewkenigsberg@gmail.com> -Matthias Hertel <Matthias.Hertel@rohde-schwarz.com> +Kevin Barnett <kevin.barnett@microsemi.com> +Marko Myllynen <myllynen@redhat.com> +Matti Moell <Matti.Moell@opensynergy.com> +Matti Möll <Matti.Moell@opensynergy.com> +Matt Perricone <matt.perricone@microsemi.com> Michael Kerrisk <mtk.manpages@gmail.com> -Michal Sekletar <msekleta@redhat.com> -Oleg Nesterov <oleg@redhat.com> -Palmer Dabbelt <palmer@sifive.com> -Petr Vaněk <arkamar@atlas.cz> -Sami Kerola <kerolasa@iki.fi> -Shawn Landden <shawn@git.icu> -Thorsten Glaser <tg@mirbsd.de> -Tobias Klauser <tklauser@distanz.ch> -Tomas Skäre <tomas.skare@gmail.com> +Mike Frysinger <vapier@gentoo.org> +Murthy Bhat <Murthy.Bhat@microsemi.com> +Nikola Forró <nforro@redhat.com> +nilsocket <nilsocket@gmail.com> +Paul Wise <pabs3@bonedaddy.net> +Philipp Wendler <ml@philippwendler.de> +Raphael Moreira Zinsly <rzinsly@linux.vnet.ibm.com> +Rasmus Villemoes <rv@rasmusvillemoes.dk> +Reid Priedhorsky <reidpr@lanl.gov> +Rick Stanley <rstanley@rsiny.com> +Rob Landley <rob@landley.net> +Scott Benesh <scott.benesh@microsemi.com> +Scott Teel <scott.teel@microsemi.com> +Shawn Anastasio <shawn@anastas.io> +Simone Piccardi <piccardi@truelite.it> +Vincent Lefevre <vincent@vinc17.net> Yang Xu <xuyang2018.jy@cn.fujitsu.com> Apologies if I missed anyone! +New and rewritten pages +----------------------- + +pidfd_open.2 + Michael Kerrisk [Christian Brauner, Florian Weimer, Daniel Colascione] + New page documenting pidfd_open(2) + +pidfd_send_signal.2 + Michael Kerrisk [Florian Weimer, Christian Brauner] + New page documenting pidfd_send_signal(2) + +pivot_root.2 + Michael Kerrisk [Eric W. Biederman, Reid Priedhorsky, Philipp Wendler] + This page has been completely rewritten, adding a lot of missing + details (including the use of (pivot_root(".", ".")) and an example + program. In addition, the text prevaricating on whether or not + pivot_root() might change the root and current working directories has + been eliminated, and replaced with a simple description of the behavior + of the system call, which has not changed for 19 years, and will not + change in the future. Many longstanding errors in the old version of + the page have also been corrected. + +ipc_namespaces.7 + Michael Kerrisk + New page with content migrated from namespaces(7) + +uts_namespaces.7 + Michael Kerrisk + New page with content migrated from namespaces(7) + + Newly documented interfaces in existing pages --------------------------------------------- -fanotify.7 -fanotify_init.2 +clone.2 + Christian Brauner, Michael Kerrisk + Document CLONE_PIDFD + Add an entry for CLONE_PIDFD. This flag is available starting + with kernel 5.2. If specified, a process file descriptor + ("pidfd") referring to the child process will be returned in + the ptid argument. + fanotify_mark.2 - Matthew Bobrowski [Amir Goldstein, Jan Kara] - Document FAN_REPORT_FID and directory modification events + Jakub Wilk + Document FAN_MOVE_SELF -vdso.7 - Tobias Klauser [Palmer Dabbelt] - Document vDSO for RISCV +ptrace.2 + Dmitry V. Levin [Michael Kerrisk] + Document PTRACE_GET_SYSCALL_INFO -Renamed pages -------------- +regex.3 + Rob Landley + Document REG_STARTEND -sysvipc.7 - svipc(7) is renamed to sysvipc(7). - The name sysvipc is a bit more natural, and is the name used in - /proc/sysvipc. New and changed links --------------------- -svipc.7 +res_nclose.3 Michael Kerrisk - Add old name of sysvipc(7) page as a link + Add NEW link to resolver.3 Global changes -------------- +Varios pages + Michael Kerrisk + SEE ALSO: correct list order + Various pages Michael Kerrisk - Change reference to svipc(7) to sysvipc(7) + Remove section number from references to function in its own page + +Various pages + Michael Kerrisk + ERRORS: correct alphabetical order Changes to individual pages --------------------------- -pldd.1 - G. Branden Robinson [Michael Kerrisk] - Document glibc's unbreakage of tool - After a longstanding breakage, pldd now works again (glibc 2.30). +localedef.1 + Marko Myllynen + Describe recently added options + Describe few recently added options (present in glibc-2.29). -bpf.2 +clone.2 Michael Kerrisk - Correct kernel version for JIT support on s390 + SEE ALSO: add pidfd_open(2) -chdir.2 - Michael Kerrisk - Add ENOTDIR error for fchdir() +copy_file_range.2 + Amir Goldstein [Dave Chinner] + Kernel v5.3 updates -execve.2 - Michael Kerrisk [Eugene Syromyatnikov] - Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127) - Shawn Landden [Michael Kerrisk] - Add more detail about Shebangs - Michael Kerrisk - Linux is not alone in ignoring the set-UID and set-GID bits for scripts +fanotify_mark.2 + Jakub Wilk + Add kernel version numbers for some FAN_* constants -mount.2 - Michael Kerrisk - ERRORS: Add a couple of EINVAL errors for MS_MOVE +getdomainname.2 Michael Kerrisk - SEE ALSO: add chroot(2) and pivot_root(2) + Add mention of UTS namespaces -mprotect.2 - Mark Wielaard - pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0 +gethostname.2 + Michael Kerrisk [Jakub Wilk] + Mention UTS namespaces -mprotect.2 -pkey_alloc.2 - Mark Wielaard [Florian Weimer] - _GNU_SOURCE is required for the pkey functions. +io_submit.2 + Matti Moell [Matti Möll] + Fix kernel version numbers for 'aio_rw_flags' flags -pivot_root.2 - Michael Kerrisk - ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation +kill.2 Michael Kerrisk - 'new_root' must be a mount point - It appears that 'new_root' may not have needed to be a mount - point on ancient kernels, but already in Linux 2.4.5 this changed. + SEE ALSO: add pidfd_send_signal(2) + +mmap.2 + Nikola Forró + Fix EINVAL conditions + Since introduction of MAP_SHARED_VALIDATE, in case flags contain + both MAP_PRIVATE and MAP_SHARED, mmap() doesn't fail with EINVAL, + it succeeds. + + The reason for that is that MAP_SHARED_VALIDATE is in fact equal + to MAP_PRIVATE | MAP_SHARED. + +mount.2 + Michael Kerrisk [Reid Priedhorsky] + Describe the concept of "parent mounts" Michael Kerrisk - 'put_old' can't be a mount point with MS_SHARED propagation + NOTES: add subsection heading for /proc/[pid]/{mounts,mountinfo} Michael Kerrisk - SEE ALSO: add mount(2) + Rework the text on mount namespaces a little + Eliminate the term "Per-process namespaces" and add a reference + to mount_namespaces(7). -poll.2 - Michael Kerrisk [Alan Stern] - Note that poll() equivalent code for ppoll() is not quite equivalent +move_pages.2 + Yang Xu [Michael Kerrisk] + Mark E2BIG as deprecated + E2BIG was removed in 2.6.29, we should mark it as deprecated. -prctl.2 - Yang Xu [Cyrill Gorcunov] - Correct some details for PR_SET_TIMERSLACK - -setxattr.2 - Finn O'Leary [Michael Kerrisk] - Add ERANGE to 'ERRORS' section +perf_event_open.2 + Michael Kerrisk [Alexey Budankov] + SEE ALSO: add Documentation/admin-guide/perf-security.rst -tkill.2 +prctl.2 Michael Kerrisk - glibc 2.30 provides a wrapper for tgkill() - -dlopen.3 + Clarify that PR_GET_SPECULATION_CTRL returns value as function result Michael Kerrisk - Clarify the rules for symbol resolution in a dlopen'ed object - The existing text wrongly implied that symbol look up first - occurred in the object and then in main, and did not mention - whether dependencies of main where used for symbol resolution. + Clarify that PR_MCE_KILL_GET returns value via function result Michael Kerrisk - Clarify when an executable's symbols can be used for symbol resolution - The --export-dynamic linker option is not the only way that main's - global symbols may end up in the dynamic symbol table and thus be - used to satisfy symbol reference in a shared object. A symbol - may also be placed into the dynamic symbol table if ld(1) - notices a dependency in another object during the static link. + Clarify that PR_GET_FP_MODE returns value as function result Michael Kerrisk - An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL + RETURN VALUE: add some missing entries + Note success return for PR_GET_SPECULATION_CTRL and PR_GET_FP_MODE. + +rt_sigqueueinfo.2 Michael Kerrisk - Note that symbol use might keep a dlclose'd object in memory - My earlier commit was in error: + Note that 'si_code' can't be specified as SI_KERNEL Michael Kerrisk - On dlclose(), destructors are called when reference count falls to 0 + The rules for 'si_code' don't apply when sending a signal to oneself + The restriction on what values may be specified in 'si_code' + apply only when sending a signal to a process other than the + caller itself. Michael Kerrisk - Make it clear that RTLD_NODELETE also affects global variables + Rename 'uinfo' argument to 'info' + This is more consistent with the naming in other pages + that refer to a 'siginfo_t' structure. Michael Kerrisk - Clarify that constructors are called only when library is first loaded + SEE ALSO: add pidfd_send_signal(2) -exec.3 - Matthew Kenigsberg - Explain function groupings - I've found the exec man page quite difficult to read when trying - to find the behavior for a specific function. Since the names of - the functions are inline and the order of the descriptions isn't - clear, it's hard to find which paragraphs apply to each function. - I thought it would be much easier to read if the grouping based on - letters is stated. +sched_setaffinity.2 + Michael Kerrisk + RETURN VALUE: sched_getaffinity() syscall differs from the wrapper -getutent.3 - Michael Kerrisk [Thorsten Glaser] - Fix missing include file in EXAMPLE - See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382 +setns.2 + Mike Frysinger + Fix CLONE_NEWNS restriction info -on_exit.3 - Michael Kerrisk [Sami Kerola] - Stack variables may be out of scope when exit handler is invoked +sigaction.2 + Michael Kerrisk + SEE ALSO: add pidfd_send_signal(2) -strcat.3 - Michael Kerrisk [Eric Sanchis] - Fix off-by-one error in example code +signalfd.2 + Andrew Clayton, Michael Kerrisk + Note about interactions with epoll & fork -cpuid.4 - Michael Kerrisk - SEE ALSO: add cpuid(1) +statx.2 + Michael Kerrisk [Simone Piccardi] + Clarify details of a case where an invalid 'mask' value may be rejected -elf.5 - Michael Kerrisk - SEE ALSO: add ld.so(8) +syscall.2 + Shawn Anastasio + Add information for powerpc64 + Michael Kerrisk [Adam Borowski, Florin Blanaru] + Update name of syscall instruction for riscv -proc.5 +syscalls.2 Michael Kerrisk - Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields - These fields are signal masks, not counters. + Add fsconfig(), fsmount(), fsopen(), fspick(), move_mount(), open_tree() + Michael Kerrisk [(), Michael(), Kerrisk(),] + Add new syscalls in 5.1 + Add io_uring_enter(), io_uring_register(), io_uring_setup(), and + pidfd_send_signal(). Michael Kerrisk - Clarify that various mask fields in /proc/PID/status are in hexadecimal + Add clone3() and pidfd_open() -capabilities.7 - Michael Kerrisk - Add a note about using strace on binaries that have capabilities - Michael Kerrisk - Add pivot_root(2) to CAP_SYS_ADMIN list +uname.2 Michael Kerrisk - CAP_FOWNER also allows modifying user xattrs on sticky directories + Replace reference to namespaces(7) with reference to uts_namespaces(7) -cgroup_namespaces.7 - Michael Kerrisk - Some wording fixes to improve clarity - Michael Kerrisk - In the example shell session, give second shell a different prompt +errno.3 + Rasmus Villemoes + Add some comments on EAGAIN/EWOULDBLOCK and EDEADLK/EDEADLOCK -credentials.7 - Michael Kerrisk - Note that /proc/PID/status shows a process's credentials - Michael Kerrisk - SEE ALSO: add tcgetsid(3) +fexecve.3 + Michael Kerrisk [Simone Piccardi] + ENOSYS occurs only if the kernel provides no execveat() syscall + Michael Kerrisk [Simone Piccardi] + ERRORS: add ENOENT -fanotify.7 - Matthew Bobrowski - Reword FAN_REPORT_FID data structure inclusion semantics - Michael Kerrisk - Clarify logic in ESTALE check +getauxval.3 + Raphael Moreira Zinsly + Add new cache geometry entries + +printf.3 + Vincent Lefevre + Add detail on the first digit with the %e format + +pthread_setcancelstate.3 +pthreads.7 +signal-safety.7 + Carlos O'Donell + Describe issues with cancellation points in signal handlers + +strtok.3 + Michael Kerrisk [eponymous alias] + Correct description of use of 'saveptr' argument in strtok_r() + Michael Kerrisk [eponymous alias] + The caller should not modify 'saveptr' between strtok_r() calls Michael Kerrisk - Reorder text in EXAMPLE + Add portability note for strtok_r() '*saveptr' value + On some implementations, '*saveptr' must be NULL on first call + to strtok_r(). + +smartpqi.4 + Murthy Bhat [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] + Add sysfs entries + Gilbert Wu [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] + Add module param expose ld first + Dave Carroll [Don Brace, Kevin Barnett, Matt Perricone, Scott Benesh] + Add module param to hide vsep + +core.5 + Paul Wise + Explain the new situation with argument splitting + Things changed in Linux v5.3-rc3 commit 315c69261dd3 from + splitting after template expansion to splitting beforehand. + +resolv.conf.5 + Nikola Forró + Update information about search list + Since glibc 2.26, the number of domains in the search list is + no longer limited. + +man-pages.7 Michael Kerrisk - Reformat program output to fit in 80 columns + Relocate and enhance the text on semantic newlines + Michael Kerrisk [Paul Wise] + Paragraphs should not be separated by blank lines mount_namespaces.7 Michael Kerrisk - Clarify implications for other NS if mount point is removed in one NS - If a mount point is deleted or renamed or removed in one mount - namespace, this will cause an object that is mounted at that - location in another mount namespace to be unmounted (as verified - by experiment). This was implied by the existing text, but it is - better to make this detail explicit. + Explain how a namespace's mount point list is initialized + Provide a more detailed explanation of the initialization of + the mount point list in a new mount namespace. + Michael Kerrisk [Eric W. Biederman] + Clarify description of "less privileged" mount namespaces Michael Kerrisk - SEE ALSO: add pivot_root(2), pivot_root(8) + SEE ALSO: refer to example in pivot_root(2) + Michael Kerrisk [Eric W. Biederman] + It may be desirable to disable propagation after creating a namespace + After creating a new mount namespace, it may be desirable to + disable mount propagation. Give the reader a more explicit + hint about this. -namespaces.7 +mq_overview.7 +sysvipc.7 Michael Kerrisk - Note initial values of hostname and domainname in a new UTS namespace + Adjust references to namespaces(7) to ipc_namespaces(7) -sched.7 +namespaces.7 Michael Kerrisk - SEE ALSO: add pthread_getschedparam(3) - -signal.7 - Michal Sekletar [Oleg Nesterov, Michael Kerrisk] - Clarify that siginfo_t isn't changed on coalescing + Remove content migrated to new ipc_namespaces(7) page Michael Kerrisk - Various fields in /proc/PID/status show signal-related information + Remove content migrated to uts_namespaces(7) Michael Kerrisk - Add subsection on queuing and delivery semantics for standard signals + Include manual page references in the summary table of namespace types + Make the page more compact by removing the stub subsections that + list the manual pages for the namespace types. And while we're + here, add an explanation of the table columns. -socket.7 - Michael Kerrisk - select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28 +operator.7 + Michael Kerrisk [Rick Stanley] + Prefix and postfix ++/-- have different precedences + Harbison and Steele also agree on this. -unix.7 +signal.7 + Michael Kerrisk + Enhance the text on process-directed and thread-directed signals + clone(2) has a good description of these concepts; borrow + from it liberally. Michael Kerrisk - Note SCM_RIGHTS interaction with RLIMIT_NOFILE - If the file descriptors received in SCM_RIGHTS would cause - the process to its exceed RLIMIT_NOFILE limit, the excess - FDs are discarded. + SEE ALSO: add pidfd_send_signal(2) user_namespaces.7 Michael Kerrisk - Describe the effect of file-related capabilities inside use namespaces - Michael Kerrisk - Describe how kernel treats UIDs/GIDs when a process accesses files - -vdso.7 - Tobias Klauser - Mention removal of Blackfin port in Linux 4.17 - -ld.so.8 - Michael Kerrisk [Matthias Hertel] - Note some further details of secure-execution mode - Note some further details of the treatment of environment - variables in secure execution mode. In particular (as noted by - Matthias Hertel), note that ignored environment variables are also - stripped from the environment. Furthermore, there are some other - variables, not used by the dynamic linker itself, that are also - treated in this way (see the glibc source file - sysdeps/generic/unsecvars.h). + Improve explanation of meaning of ownership of nonuser namespaces diff --git a/Changes.old b/Changes.old index 008d80c58..a8bc6ae08 100644 --- a/Changes.old +++ b/Changes.old @@ -49431,3 +49431,303 @@ inode.7 Timestamp fields are structures that include a nanosecond component Michael Kerrisk Add references to execve(2) to describe set-UID/set-GID behaviors + + +==================== Changes in man-pages-5.02 ==================== + +Released: 2019-08-02, Munich + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + +Alan Stern <stern@rowland.harvard.edu> +Alexey Izbyshev <izbyshev@ispras.ru> +Amir Goldstein <amir73il@gmail.com> +Cyrill Gorcunov <gorcunov@gmail.com> +Eric Sanchis <eric.sanchis@iut-rodez.fr> +Eugene Syromyatnikov <evgsyr@gmail.com> +Finn O'Leary <finnoleary@inventati.org> +Florian Weimer <fweimer@redhat.com> +G. Branden Robinson <g.branden.robinson@gmail.com> +Guillaume Laporte <guillaume.laporte.adm@gmail.com> +Jakub Wilk <jwilk@jwilk.net> +Jan Kara <jack@suse.cz> +Kumar Chaudhary, Naveen <naveen.kumar.chaudhary@intel.com> +Mark Wielaard <mark@klomp.org> +Matthew Bobrowski <mbobrowski@mbobrowski.org> +Matthew Kenigsberg <matthewkenigsberg@gmail.com> +Matthias Hertel <Matthias.Hertel@rohde-schwarz.com> +Michael Kerrisk <mtk.manpages@gmail.com> +Michal Sekletar <msekleta@redhat.com> +Oleg Nesterov <oleg@redhat.com> +Palmer Dabbelt <palmer@sifive.com> +Petr Vaněk <arkamar@atlas.cz> +Sami Kerola <kerolasa@iki.fi> +Shawn Landden <shawn@git.icu> +Thorsten Glaser <tg@mirbsd.de> +Tobias Klauser <tklauser@distanz.ch> +Tomas Skäre <tomas.skare@gmail.com> +Yang Xu <xuyang2018.jy@cn.fujitsu.com> + +Apologies if I missed anyone! + + +Newly documented interfaces in existing pages +--------------------------------------------- + +fanotify.7 +fanotify_init.2 +fanotify_mark.2 + Matthew Bobrowski [Amir Goldstein, Jan Kara] + Document FAN_REPORT_FID and directory modification events + +vdso.7 + Tobias Klauser [Palmer Dabbelt] + Document vDSO for RISCV + +Renamed pages +------------- + +sysvipc.7 + svipc(7) is renamed to sysvipc(7). + The name sysvipc is a bit more natural, and is the name used in + /proc/sysvipc. + +New and changed links +--------------------- + +svipc.7 + Michael Kerrisk + Add old name of sysvipc(7) page as a link + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Change reference to svipc(7) to sysvipc(7) + + +Changes to individual pages +--------------------------- + +pldd.1 + G. Branden Robinson [Michael Kerrisk] + Document glibc's unbreakage of tool + After a longstanding breakage, pldd now works again (glibc 2.30). + +bpf.2 + Michael Kerrisk + Correct kernel version for JIT support on s390 + +chdir.2 + Michael Kerrisk + Add ENOTDIR error for fchdir() + +execve.2 + Michael Kerrisk [Eugene Syromyatnikov] + Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127) + Shawn Landden [Michael Kerrisk] + Add more detail about Shebangs + Michael Kerrisk + Linux is not alone in ignoring the set-UID and set-GID bits for scripts + +mount.2 + Michael Kerrisk + ERRORS: Add a couple of EINVAL errors for MS_MOVE + Michael Kerrisk + SEE ALSO: add chroot(2) and pivot_root(2) + +mprotect.2 + Mark Wielaard + pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0 + +mprotect.2 +pkey_alloc.2 + Mark Wielaard [Florian Weimer] + _GNU_SOURCE is required for the pkey functions. + +pivot_root.2 + Michael Kerrisk + ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation + Michael Kerrisk + 'new_root' must be a mount point + It appears that 'new_root' may not have needed to be a mount + point on ancient kernels, but already in Linux 2.4.5 this changed. + Michael Kerrisk + 'put_old' can't be a mount point with MS_SHARED propagation + Michael Kerrisk + SEE ALSO: add mount(2) + +poll.2 + Michael Kerrisk [Alan Stern] + Note that poll() equivalent code for ppoll() is not quite equivalent + +prctl.2 + Yang Xu [Cyrill Gorcunov] + Correct some details for PR_SET_TIMERSLACK + +setxattr.2 + Finn O'Leary [Michael Kerrisk] + Add ERANGE to 'ERRORS' section + +tkill.2 + Michael Kerrisk + glibc 2.30 provides a wrapper for tgkill() + +dlopen.3 + Michael Kerrisk + Clarify the rules for symbol resolution in a dlopen'ed object + The existing text wrongly implied that symbol look up first + occurred in the object and then in main, and did not mention + whether dependencies of main where used for symbol resolution. + Michael Kerrisk + Clarify when an executable's symbols can be used for symbol resolution + The --export-dynamic linker option is not the only way that main's + global symbols may end up in the dynamic symbol table and thus be + used to satisfy symbol reference in a shared object. A symbol + may also be placed into the dynamic symbol table if ld(1) + notices a dependency in another object during the static link. + Michael Kerrisk + An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL + Michael Kerrisk + Note that symbol use might keep a dlclose'd object in memory + Michael Kerrisk + On dlclose(), destructors are called when reference count falls to 0 + Michael Kerrisk + Make it clear that RTLD_NODELETE also affects global variables + Michael Kerrisk + Clarify that constructors are called only when library is first loaded + +exec.3 + Matthew Kenigsberg + Explain function groupings + I've found the exec man page quite difficult to read when trying + to find the behavior for a specific function. Since the names of + the functions are inline and the order of the descriptions isn't + clear, it's hard to find which paragraphs apply to each function. + I thought it would be much easier to read if the grouping based on + letters is stated. + +getutent.3 + Michael Kerrisk [Thorsten Glaser] + Fix missing include file in EXAMPLE + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382 + +on_exit.3 + Michael Kerrisk [Sami Kerola] + Stack variables may be out of scope when exit handler is invoked + +strcat.3 + Michael Kerrisk [Eric Sanchis] + Fix off-by-one error in example code + +cpuid.4 + Michael Kerrisk + SEE ALSO: add cpuid(1) + +elf.5 + Michael Kerrisk + SEE ALSO: add ld.so(8) + +proc.5 + Michael Kerrisk + Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields + These fields are signal masks, not counters. + Michael Kerrisk + Clarify that various mask fields in /proc/PID/status are in hexadecimal + +capabilities.7 + Michael Kerrisk + Add a note about using strace on binaries that have capabilities + Michael Kerrisk + Add pivot_root(2) to CAP_SYS_ADMIN list + Michael Kerrisk + CAP_FOWNER also allows modifying user xattrs on sticky directories + +cgroup_namespaces.7 + Michael Kerrisk + Some wording fixes to improve clarity + Michael Kerrisk + In the example shell session, give second shell a different prompt + +credentials.7 + Michael Kerrisk + Note that /proc/PID/status shows a process's credentials + Michael Kerrisk + SEE ALSO: add tcgetsid(3) + +fanotify.7 + Matthew Bobrowski + Reword FAN_REPORT_FID data structure inclusion semantics + Michael Kerrisk + Clarify logic in ESTALE check + Michael Kerrisk + Reorder text in EXAMPLE + Michael Kerrisk + Reformat program output to fit in 80 columns + +mount_namespaces.7 + Michael Kerrisk + Clarify implications for other NS if mount point is removed in one NS + If a mount point is deleted or renamed or removed in one mount + namespace, this will cause an object that is mounted at that + location in another mount namespace to be unmounted (as verified + by experiment). This was implied by the existing text, but it is + better to make this detail explicit. + Michael Kerrisk + SEE ALSO: add pivot_root(2), pivot_root(8) + +namespaces.7 + Michael Kerrisk + Note initial values of hostname and domainname in a new UTS namespace + +sched.7 + Michael Kerrisk + SEE ALSO: add pthread_getschedparam(3) + +signal.7 + Michal Sekletar [Oleg Nesterov, Michael Kerrisk] + Clarify that siginfo_t isn't changed on coalescing + Michael Kerrisk + Various fields in /proc/PID/status show signal-related information + Michael Kerrisk + Add subsection on queuing and delivery semantics for standard signals + +socket.7 + Michael Kerrisk + select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28 + +unix.7 + Michael Kerrisk + Note SCM_RIGHTS interaction with RLIMIT_NOFILE + If the file descriptors received in SCM_RIGHTS would cause + the process to its exceed RLIMIT_NOFILE limit, the excess + FDs are discarded. + +user_namespaces.7 + Michael Kerrisk + Describe the effect of file-related capabilities inside user namespaces + Michael Kerrisk + Describe how kernel treats UIDs/GIDs when a process accesses files + +vdso.7 + Tobias Klauser + Mention removal of Blackfin port in Linux 4.17 + +ld.so.8 + Michael Kerrisk [Matthias Hertel] + Note some further details of secure-execution mode + Note some further details of the treatment of environment + variables in secure execution mode. In particular (as noted by + Matthias Hertel), note that ignored environment variables are also + stripped from the environment. Furthermore, there are some other + variables, not used by the dynamic linker itself, that are also + treated in this way (see the glibc source file + sysdeps/generic/unsecvars.h). diff --git a/man-pages-5.02.Announce b/man-pages-5.03.Announce index 3b0c60f2e..d4903b0bb 100644 --- a/man-pages-5.02.Announce +++ b/man-pages-5.03.Announce @@ -1,7 +1,7 @@ RELEASE The Linux man page maintainer proudly announces. . . - man-pages-5.02.tar.gz - man pages for Linux + man-pages-5.03.tar.gz - man pages for Linux Differences from the previous manual pages release are listed in the file "Changes". diff --git a/man-pages-5.02.lsm b/man-pages-5.03.lsm index d4f40e1b2..5661b1206 100644 --- a/man-pages-5.02.lsm +++ b/man-pages-5.03.lsm @@ -1,13 +1,13 @@ Begin3 Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 5.05.02 -Entered-date: 2019-08-02 +Version: 5.05.05.03 +Entered-date: 2019-10-10 Description: Linux manual pages Keywords: man pages Author: several Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com> Primary-site: http://www.kernel.org/pub/linux/docs/man-pages - 2643k man-pages-5.02.tar.gz + 2657k man-pages-5.03.tar.gz Copying-policy: several; the pages are all freely distributable as long as nroff source is provided End diff --git a/man1/getent.1 b/man1/getent.1 index 85b497841..d1675c5d5 100644 --- a/man1/getent.1 +++ b/man1/getent.1 @@ -398,7 +398,7 @@ Enumeration not supported on this .SH SEE ALSO .BR nsswitch.conf (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/iconv.1 b/man1/iconv.1 index fa4c321c6..d3ed3cf42 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -204,7 +204,7 @@ abc ss ? EUR abc .BR charsets (7), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/intro.1 b/man1/intro.1 index 861f3de58..9bc05c636 100644 --- a/man1/intro.1 +++ b/man1/intro.1 @@ -324,7 +324,7 @@ and use a browser if you find HTML files there. .BR man-pages (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/ldd.1 b/man1/ldd.1 index 338855908..a45162b90 100644 --- a/man1/ldd.1 +++ b/man1/ldd.1 @@ -171,7 +171,7 @@ on one of these programs, the program will attempt to run with .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/locale.1 b/man1/locale.1 index 017d92b02..babb7eadd 100644 --- a/man1/locale.1 +++ b/man1/locale.1 @@ -207,7 +207,7 @@ $ \fBecho "export LANG=fi_SE.UTF-8" >> $HOME/.bashrc\fP .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/localedef.1 b/man1/localedef.1 index d97384665..6694de644 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -31,7 +31,7 @@ .\" Lars Wirzenius to document new functionality (as of GNU .\" C library 2.3.5). .\" -.TH LOCALEDEF 1 2019-03-06 "Linux" "Linux User Manual" +.TH LOCALEDEF 1 2019-10-10 "Linux" "Linux User Manual" .SH NAME localedef \- compile locale definition files .SH SYNOPSIS @@ -41,22 +41,22 @@ localedef \- compile locale definition files .RI [ options ] .I outputpath .br -.B "localedef \-\-list\-archive" +.B "localedef \-\-add\-to\-archive" .RI [ options ] +.I compiledpath .br .B "localedef \-\-delete\-from\-archive" .RI [ options ] .IR localename " ..." .br -.B "localedef \-\-add\-to\-archive" +.B "localedef \-\-list\-archive" .RI [ options ] -.I compiledpath -.br -.B "localedef \-\-version" .br .B "localedef \-\-help" .br .B "localedef \-\-usage" +.br +.B "localedef \-\-version" .ad b .hy .SH DESCRIPTION @@ -128,12 +128,6 @@ A few options direct to do something other than compile locale definitions. Only one of these options should be used at a time. .TP -.B \-\-delete\-from\-archive -Delete the named locales from the locale archive file. -.TP -.B \-\-list\-archive -List the locales contained in the locale archive file. -.TP .B \-\-add\-to\-archive Add the .I compiledpath @@ -142,6 +136,12 @@ The directories should have been created by previous runs of .BR localedef , using .BR \-\-no\-archive . +.TP +.B \-\-delete\-from\-archive +Delete the named locales from the locale archive file. +.TP +.B \-\-list\-archive +List the locales contained in the locale archive file. .SS Other options Some of the following options are sensible only for certain operations; generally, it should be self-evident which ones. @@ -212,14 +212,6 @@ Use to look up aliases for locale names. There is no default aliases file. .TP -.BI \-\-prefix= pathname -Set the prefix to be prepended to the full archive pathname. -By default, the prefix is empty. -Setting the prefix to -.IR foo , -the archive would be placed in -.IR foo/usr/lib/locale/locale-archive . -.TP .BR \-c ", " \-\-force Write the output files even if warnings were generated about the input file. @@ -227,8 +219,30 @@ file. .BR \-v ", " \-\-verbose Generate extra warnings about errors that are normally ignored. .TP -.B \-\-quiet -Suppress all notifications and warnings, and report only fatal errors. +.B \-\-big\-endian +Generate big-ending output. +.TP +.B \-\-little\-endian +Generate little-ending output. +.TP +.B \-\-no\-archive +Do not use the locale archive file, instead create +.I outputpath +as a subdirectory in the same directory as the locale archive file, +and create separate output files for locale categories in it. +This is helpful to prevent system locale archive updates from overwriting +custom locales created with +.BR localedef . +.TP +.B \-\-no\-hard\-links +Do not create hard links between installed locales. +.TP +.BI \-\-no\-warnings= warnings +Comma-separated list of warnings to disable. +Supported warnings are +.I ascii +and +.IR intcurrsym . .TP .B \-\-posix Conform strictly to POSIX. Implies @@ -238,19 +252,28 @@ POSIX conformance is assumed if the environment variable .B POSIXLY_CORRECT is set. .TP +.BI \-\-prefix= pathname +Set the prefix to be prepended to the full archive pathname. +By default, the prefix is empty. +Setting the prefix to +.IR foo , +the archive would be placed in +.IR foo/usr/lib/locale/locale-archive . +.TP +.B \-\-quiet +Suppress all notifications and warnings, and report only fatal errors. +.TP .B \-\-replace Replace a locale in the locale archive file. Without this option, if the locale is in the archive file already, an error occurs. .TP -.B \-\-no\-archive -Do not use the locale archive file, instead create -.I outputpath -as a subdirectory in the same directory as the locale archive file, -and create separate output files for locale categories in it. -This is helpful to prevent system locale archive updates from overwriting -custom locales created with -.BR localedef . +.BI \-\-warnings= warnings +Comma-separated list of warnings to enable. +Supported warnings are +.I ascii +and +.IR intcurrsym . .TP .BR \-? ", " \-\-help Print a usage summary and exit. @@ -381,7 +404,7 @@ localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8 .BR repertoiremap (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusage.1 b/man1/memusage.1 index 7fa4c6003..69716fb78 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -272,7 +272,7 @@ main(int argc, char *argv[]) .BR mtrace (1) .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusagestat.1 b/man1/memusagestat.1 index b749f1072..08f6d3675 100644 --- a/man1/memusagestat.1 +++ b/man1/memusagestat.1 @@ -89,7 +89,7 @@ See .BR memusage (1), .BR mtrace (1) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/mtrace.1 b/man1/mtrace.1 index df350f7fd..1715fe444 100644 --- a/man1/mtrace.1 +++ b/man1/mtrace.1 @@ -63,7 +63,7 @@ For bug reporting instructions, please see: .BR memusage (1), .BR mtrace (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/pldd.1 b/man1/pldd.1 index 2cf7bff46..f7c5f1ecb 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -122,7 +122,7 @@ linux\-vdso.so.1 .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/sprof.1 b/man1/sprof.1 index 81782a1bb..fe36b1781 100644 --- a/man1/sprof.1 +++ b/man1/sprof.1 @@ -301,7 +301,7 @@ x2 consumeCpu2 1000 .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man1/time.1 b/man1/time.1 index f56069f34..90954d77c 100644 --- a/man1/time.1 +++ b/man1/time.1 @@ -330,7 +330,7 @@ and C compiler you used. .BR times (2), .BR wait3 (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_exit.2 b/man2/_exit.2 index e410e8688..a83ce21c7 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -132,7 +132,7 @@ in order to terminate all of the threads in a process. .BR on_exit (3), .BR termios (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_syscall.2 b/man2/_syscall.2 index 479f3d1e6..8a3c38f0a 100644 --- a/man2/_syscall.2 +++ b/man2/_syscall.2 @@ -185,7 +185,7 @@ Number of processes = 40 .BR syscall (2), .BR errno (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/accept.2 b/man2/accept.2 index 884853087..8e11dad45 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -378,7 +378,7 @@ See .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/access.2 b/man2/access.2 index 8bbe6ec53..dbdea89e5 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -413,7 +413,7 @@ flag is honored. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/acct.2 b/man2/acct.2 index dc5eb01ae..9fac56e74 100644 --- a/man2/acct.2 +++ b/man2/acct.2 @@ -151,7 +151,7 @@ The structure of the records written to the accounting file is described in .SH SEE ALSO .BR acct (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/add_key.2 b/man2/add_key.2 index f92dd5b03..f2bdc141d 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -294,7 +294,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 index 9170932db..45c854411 100644 --- a/man2/adjtimex.2 +++ b/man2/adjtimex.2 @@ -546,7 +546,7 @@ for the leap second to be inserted or deleted. NTP "Kernel Application Program Interface" .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/alarm.2 b/man2/alarm.2 index dcc4463f8..b779c0583 100644 --- a/man2/alarm.2 +++ b/man2/alarm.2 @@ -95,7 +95,7 @@ be delayed by an arbitrary amount of time. .BR sleep (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2 index 52dcc2f4b..c5d9d2755 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -149,7 +149,7 @@ boot parameter. .\" mount -t hugetlbfs hugetlbfs /huge .\" SHM_HUGETLB .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/arch_prctl.2 b/man2/arch_prctl.2 index a80d0e17d..eee06d718 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -148,7 +148,7 @@ directly are very likely to crash. .PP AMD X86-64 Programmer's manual .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bdflush.2 b/man2/bdflush.2 index c31d5089d..6d63b8fdb 100644 --- a/man2/bdflush.2 +++ b/man2/bdflush.2 @@ -123,7 +123,7 @@ intended to be portable. .BR fsync (2), .BR sync (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bind.2 b/man2/bind.2 index ce55fff77..2fb9d0c71 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -334,7 +334,7 @@ main(int argc, char *argv[]) .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bpf.2 b/man2/bpf.2 index 4f89bf2cd..c999fe40d 100644 --- a/man2/bpf.2 +++ b/man2/bpf.2 @@ -1229,7 +1229,7 @@ riscv (since Linux 5.1). Both classic and extended BPF are explained in the kernel source file .IR Documentation/networking/filter.txt . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/brk.2 b/man2/brk.2 index a9773ce4b..fa980d5ee 100644 --- a/man2/brk.2 +++ b/man2/brk.2 @@ -176,7 +176,7 @@ return the old break value. .BR end (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index 908ac140e..9419c5e30 100644 --- a/man2/cacheflush.2 +++ b/man2/cacheflush.2 @@ -102,7 +102,7 @@ argument and does not do any error checking on the .I cache argument. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/capget.2 b/man2/capget.2 index 50a7111fd..fce6c95bd 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -234,7 +234,7 @@ library and is available here: .BR gettid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chdir.2 b/man2/chdir.2 index 7cb13b5d2..69c3d2e08 100644 --- a/man2/chdir.2 +++ b/man2/chdir.2 @@ -144,7 +144,7 @@ The current working directory is left unchanged by .BR getcwd (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chmod.2 b/man2/chmod.2 index 31a8e96a5..5e59f9773 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -387,7 +387,7 @@ argument. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chown.2 b/man2/chown.2 index f15fd23cb..95c3897d9 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -502,7 +502,7 @@ main(int argc, char *argv[]) .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chroot.2 b/man2/chroot.2 index c7b162b9e..aa4f287ce 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -185,7 +185,7 @@ system call. .BR path_resolution (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index d6ae81dc3..53a548374 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -357,7 +357,7 @@ On Linux, these clocks are not settable .BR vdso (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clock_nanosleep.2 b/man2/clock_nanosleep.2 index 2bcf52b2e..bf848f6b1 100644 --- a/man2/clock_nanosleep.2 +++ b/man2/clock_nanosleep.2 @@ -260,7 +260,7 @@ shall have no effect on a thread that is blocked on a relative .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clone.2 b/man2/clone.2 index 58e41005f..fdf52c428 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -539,6 +539,42 @@ The flag disappeared completely from the kernel sources in Linux 2.5.16. Since then, the kernel silently ignores this bit if it is specified in .IR flags . .TP +.BR CLONE_PIDFD " (since Linux 5.2)" +.\" commit b3e5838252665ee4cfa76b82bdf1198dca81e5be +If +.B CLONE_PIDFD +is set, +.BR clone () +stores a PID file descriptor referring to the child process at +the location +.I ptid +in the parent's memory. +The close-on-exec flag is set on this new file descriptor. +PID file descriptors can be used for the purposes described in +.BR pidfd_open (2). +.IP +Since the +.I ptid +argument is used to return the PID file descriptor, +.B CLONE_PIDFD +cannot be used with +.B CLONE_PARENT_SETTID. +.IP +It is currently not possible to use this flag together with +.B CLONE_THREAD. +This means that the process identified by the PID file descriptor +will always be a thread-group leader. +.IP +For a while there was a +.B CLONE_DETACHED +flag. +This flag is usually ignored when passed along with other flags. +However, when passed alongside +.BR CLONE_PIDFD , +an error is returned. +This ensures that this flag can be reused +for further PID file descriptor features in the future. +.TP .BR CLONE_PTRACE " (since Linux 2.2)" If .B CLONE_PTRACE @@ -744,7 +780,7 @@ A signal may be process-directed or thread-directed. A process-directed signal is targeted at a thread group (i.e., a TGID), and is delivered to an arbitrarily selected thread from among those that are not blocking the signal. -A signal may be process directed because it was generated by the kernel +A signal may be process-directed because it was generated by the kernel for reasons other than a hardware exception, or because it was sent using .BR kill (2) or @@ -1122,6 +1158,21 @@ For example, on aarch64, .I child_stack must be a multiple of 16. .TP +.B EINVAL +.B CLONE_PIDFD +was specified together with +.B CLONE_DETACHED. +.TP +.B EINVAL +.B CLONE_PIDFD +was specified together with +.B CLONE_PARENT_SETTID. +.TP +.B EINVAL +.B CLONE_PIDFD +was specified together with +.B CLONE_THREAD. +.TP .B ENOMEM Cannot allocate sufficient memory to allocate a task structure for the child, or to copy those parts of the caller's context that need to be @@ -1401,6 +1452,7 @@ main(int argc, char *argv[]) .BR getpid (2), .BR gettid (2), .BR kcmp (2), +.BR pidfd_open (2), .BR set_thread_area (2), .BR set_tid_address (2), .BR setns (2), @@ -1411,7 +1463,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/close.2 b/man2/close.2 index b6d48e3cb..df6e97546 100644 --- a/man2/close.2 +++ b/man2/close.2 @@ -33,7 +33,7 @@ .\" Modified 2000-07-22 by Nicolás Lichtmaier <nick@debian.org> .\" added note about close(2) not guaranteeing that data is safe on close. .\" -.TH CLOSE 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH CLOSE 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME close \- close a file descriptor .SH SYNOPSIS @@ -92,7 +92,7 @@ subsequent .BR write (2), .BR fsync (2), or -.BR close (2). +.BR close (). .PP See NOTES for a discussion of why .BR close () @@ -249,7 +249,7 @@ the next major release of the POSIX.1 standard. .BR unlink (2), .BR fclose (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/connect.2 b/man2/connect.2 index 226d3aac0..75f85ca09 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -289,7 +289,7 @@ is shown in .BR socket (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/copy_file_range.2 b/man2/copy_file_range.2 index d337c90d7..8bdcb6edf 100644 --- a/man2/copy_file_range.2 +++ b/man2/copy_file_range.2 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH COPY_FILE_RANGE 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH COPY_FILE_RANGE 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME copy_file_range \- Copy a range of data from one file to another .SH SYNOPSIS @@ -42,9 +42,9 @@ without the additional cost of transferring data from the kernel to user space and then back into the kernel. It copies up to .I len -bytes of data from file descriptor +bytes of data from the source file descriptor .I fd_in -to file descriptor +to the target file descriptor .IR fd_out , overwriting any data that exists within the requested range of the target file. .PP @@ -74,6 +74,12 @@ is not changed, but .I off_in is adjusted appropriately. .PP +.I fd_in +and +.I fd_out +can refer to the same file. +If they refer to the same file, then the source and target ranges are not +allowed to overlap. .PP The .I flags @@ -84,6 +90,11 @@ Upon successful completion, .BR copy_file_range () will return the number of bytes copied between files. This could be less than the length originally requested. +If the file offset of +.I fd_in +is at or past the end of file, no bytes are copied, and +.BR copy_file_range () +returns zero. .PP On error, .BR copy_file_range () @@ -93,12 +104,16 @@ is set to indicate the error. .SH ERRORS .TP .B EBADF -One or more file descriptors are not valid; or +One or more file descriptors are not valid. +.TP +.B EBADF .I fd_in is not open for reading; or .I fd_out -is not open for writing; or -the +is not open for writing. +.TP +.B EBADF +The .B O_APPEND flag is set for the open file description (see .BR open (2)) @@ -106,19 +121,43 @@ referred to by the file descriptor .IR fd_out . .TP .B EFBIG -An attempt was made to write a file that exceeds the implementation-defined -maximum file size or the process's file size limit, -or to write at a position past the maximum allowed offset. +An attempt was made to write at a position past the maximum file offset the +kernel supports. +.TP +.B EFBIG +An attempt was made to write a range that exceeds the allowed maximum file size. +The maximum file size differs between filesystem implementations and can be +different from the maximum allowed file offset. +.TP +.B EFBIG +An attempt was made to write beyond the process's file size resource limit. +This may also result in the process receiving a +.I SIGXFSZ +signal. .TP .B EINVAL -Requested range extends beyond the end of the source file; or the +The .I flags argument is not 0. .TP +.B EINVAL +.I fd_in +and +.I fd_out +refer to the same file and the source and target ranges overlap. +.TP +.B EINVAL +Either +.I fd_in +or +.I fd_out +is not a regular file. +.TP .B EIO A low-level I/O error occurred while copying. .TP .B EISDIR +Either .I fd_in or .I fd_out @@ -130,16 +169,39 @@ Out of memory. .B ENOSPC There is not enough space on the target filesystem to complete the copy. .TP +.B EOVERFLOW +The requested source or destination range is too large to represent in the +specified data types. +.TP +.B EPERM +.I fd_out +refers to an immutable file. +.TP +.B TXTBSY +Either +.I fd_in +or +.I fd_out +refers to an active swap file. +.TP .B EXDEV The files referred to by .IR file_in " and " file_out -are not on the same mounted filesystem. +are not on the same mounted filesystem (pre Linux 5.3). .SH VERSIONS The .BR copy_file_range () system call first appeared in Linux 4.5, but glibc 2.27 provides a user-space emulation when it is not available. .\" https://sourceware.org/git/?p=glibc.git;a=commit;f=posix/unistd.h;h=bad7a0c81f501fbbcc79af9eaa4b8254441c4a1f +.PP +A major rework of the kernel implementation occurred in 5.3. +Areas of the API that weren't clearly defined were clarified and the API bounds +are much more strictly checked than on earlier kernels. +Applications should target the behaviour and requirements of 5.3 kernels. +.PP +First support for cross-filesystem copies was introduced in Linux 5.3. +Older kernels will return -EXDEV when cross-filesystem copies are attempted. .SH CONFORMING TO The .BR copy_file_range () @@ -224,7 +286,7 @@ main(int argc, char **argv) } len \-= ret; - } while (len > 0); + } while (len > 0 && ret > 0); close(fd_in); close(fd_out); @@ -236,7 +298,7 @@ main(int argc, char **argv) .BR sendfile (2), .BR splice (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/create_module.2 b/man2/create_module.2 index 3ffe423c8..aa04f65fc 100644 --- a/man2/create_module.2 +++ b/man2/create_module.2 @@ -78,7 +78,7 @@ alternatively, you could invoke the system call using .BR init_module (2), .BR query_module (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/delete_module.2 b/man2/delete_module.2 index 25ecdf9a4..b1f5d4e59 100644 --- a/man2/delete_module.2 +++ b/man2/delete_module.2 @@ -215,7 +215,7 @@ currently explained in this manual page. .BR modprobe (8), .BR rmmod (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/dup.2 b/man2/dup.2 index 4d19ce25c..b9f854032 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -277,7 +277,7 @@ Instead, code something like the following could be used: .BR fcntl (2), .BR open (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/epoll_create.2 b/man2/epoll_create.2 index bc6f7c757..cac4783b3 100644 --- a/man2/epoll_create.2 +++ b/man2/epoll_create.2 @@ -150,7 +150,7 @@ applications are run on older kernels. .BR epoll_wait (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2 index 81710222b..c4658a035 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -428,7 +428,7 @@ flag. .BR poll (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/epoll_wait.2 b/man2/epoll_wait.2 index 10ad426b8..e6743d8eb 100644 --- a/man2/epoll_wait.2 +++ b/man2/epoll_wait.2 @@ -208,7 +208,7 @@ Library support is provided in glibc starting with version 2.6. is Linux-specific. .SH NOTES While one thread is blocked in a call to -.BR epoll_pwait (), +.BR epoll_wait (), it is possible for another thread to add a file descriptor to the waited-upon .B epoll instance. @@ -268,7 +268,7 @@ wrapper function specifies this argument as a fixed value .BR epoll_ctl (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/eventfd.2 b/man2/eventfd.2 index 592916cbf..1e0be6dcd 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -452,7 +452,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execve.2 b/man2/execve.2 index 92c9d63b9..3a6796c7a 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -34,7 +34,7 @@ .\" 2007-09-14 Ollie Wild <aaw@google.com>, mtk .\" Add text describing limits on command-line arguments + environment .\" -.TH EXECVE 2 2019-05-09 "Linux" "Linux Programmer's Manual" +.TH EXECVE 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME execve \- execute program .SH SYNOPSIS @@ -560,7 +560,7 @@ there is no new process; many attributes of the calling process remain unchanged (in particular, its PID). All that -.BR execve (2) +.BR execve () does is arrange for an existing process (the calling process) to execute a new program. .PP @@ -869,7 +869,7 @@ argv[4]: world .BR path_resolution (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execveat.2 b/man2/execveat.2 index 130e8e52c..d74a552cd 100644 --- a/man2/execveat.2 +++ b/man2/execveat.2 @@ -231,7 +231,7 @@ where scripts recursively employ .BR openat (2), .BR fexecve (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/exit_group.2 b/man2/exit_group.2 index 3825477bf..7e7eda129 100644 --- a/man2/exit_group.2 +++ b/man2/exit_group.2 @@ -49,7 +49,7 @@ wrapper function is called. .SH SEE ALSO .BR exit (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fallocate.2 b/man2/fallocate.2 index 4cbae5602..481389130 100644 --- a/man2/fallocate.2 +++ b/man2/fallocate.2 @@ -477,7 +477,7 @@ is Linux-specific. .BR posix_fadvise (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fanotify_init.2 b/man2/fanotify_init.2 index 55bc8dd56..309ab677d 100644 --- a/man2/fanotify_init.2 +++ b/man2/fanotify_init.2 @@ -308,7 +308,7 @@ returned when reading from the fanotify file descriptor. .BR fanotify_mark (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fanotify_mark.2 b/man2/fanotify_mark.2 index 3ebda6037..6194f8f62 100644 --- a/man2/fanotify_mark.2 +++ b/man2/fanotify_mark.2 @@ -176,32 +176,43 @@ Create an event when a read-only file or directory is closed. .B FAN_OPEN Create an event when a file or directory is opened. .TP -.B FAN_OPEN_EXEC " (since Linux 5.0)" +.BR FAN_OPEN_EXEC " (since Linux 5.0)" +.\" commit 9b076f1c0f4869b838a1b7aa0edb5664d47ec8aa Create an event when a file is opened with the intent to be executed. See NOTES for additional details. .TP -.B FAN_ATTRIB +.BR FAN_ATTRIB " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when the metadata for a file or directory has changed. .TP -.B FAN_CREATE +.BR FAN_CREATE " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when a file or directory has been created in a marked parent directory. .TP -.B FAN_DELETE +.BR FAN_DELETE " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when a file or directory has been deleted in a marked parent directory. .TP -.B FAN_DELETE_SELF +.BR FAN_DELETE_SELF " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when a marked file or directory itself is deleted. .TP -.B FAN_MOVED_FROM +.BR FAN_MOVED_FROM " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when a file or directory has been moved from a marked parent directory. .TP -.B FAN_MOVED_TO +.BR FAN_MOVED_TO " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when a file or directory has been moved to a marked parent directory. .TP +.BR FAN_MOVE_SELF " (since Linux 5.1)" +.\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 +Create an event when a marked file or directory itself has been moved. +.TP .B FAN_Q_OVERFLOW Create an event when an overflow of the event queue occurs. The size of the event queue is limited to 16384 entries if @@ -218,6 +229,7 @@ or is required. .TP .BR FAN_OPEN_EXEC_PERM " (since Linux 5.0)" +.\" commit 66917a3130f218dcef9eeab4fd11a71cd00cd7c9 Create an event when a permission to open a file for execution is requested. An fanotify file descriptor created with @@ -361,6 +373,19 @@ and mask contains a flag for permission events or .BR FAN_ACCESS_PERM ). .TP +.B ENODEV +The filesystem object indicated by +.I pathname +is not associated with a filesystem that supports +.I fsid +(e.g., +.BR tmpfs (5)). +This error can be returned only when an fanotify file descriptor returned +by +.BR fanotify_init (2) +has been created with +.BR FAN_REPORT_FID . +.TP .B ENOENT The filesystem object indicated by .IR dirfd @@ -395,38 +420,25 @@ and .I pathname do not specify a directory. .TP -.B EXDEV -The filesystem object indicated by +.B EOPNOTSUPP +The object indicated by .I pathname -resides within a filesystem subvolume (e.g., -.BR btrfs (5)) -which uses a different -.I fsid -than its root superblock. +is associated with a filesystem that does not support the encoding of file +handles. This error can be returned only when an fanotify file descriptor returned by .BR fanotify_init (2) has been created with .BR FAN_REPORT_FID . .TP -.B ENODEV +.B EXDEV The filesystem object indicated by .I pathname -is not associated with a filesystem that supports +resides within a filesystem subvolume (e.g., +.BR btrfs (5)) +which uses a different .I fsid -(e.g., -.BR tmpfs (5)). -This error can be returned only when an fanotify file descriptor returned -by -.BR fanotify_init (2) -has been created with -.BR FAN_REPORT_FID . -.TP -.B EOPNOTSUPP -The object indicated by -.I pathname -is associated with a filesystem that does not support the encoding of file -handles. +than its root superblock. This error can be returned only when an fanotify file descriptor returned by .BR fanotify_init (2) @@ -514,7 +526,7 @@ is not checked for invalid values. .BR fanotify_init (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 06dbfd0a2..6ee2a5144 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -2109,7 +2109,7 @@ directory, and is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/flock.2 b/man2/flock.2 index 8e7e608b9..c15f43f67 100644 --- a/man2/flock.2 +++ b/man2/flock.2 @@ -253,7 +253,7 @@ in the Linux kernel source tree .RI ( Documentation/locks.txt in older kernels) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fork.2 b/man2/fork.2 index 4c791d3fd..27abefe26 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -327,7 +327,7 @@ and .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fsync.2 b/man2/fsync.2 index 564e02b69..c6278733e 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -199,7 +199,7 @@ to guarantee safe operation. .BR hdparm (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futex.2 b/man2/futex.2 index 1c5329e0b..e8b01122a 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -1935,7 +1935,7 @@ Futex example library, futex-*.tar.bz2 at .\" WIP, and the generic pthread_mutex_t and perhaps condvar .\" implementations. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futimesat.2 b/man2/futimesat.2 index 53ac61bc9..64ed16382 100644 --- a/man2/futimesat.2 +++ b/man2/futimesat.2 @@ -132,7 +132,7 @@ wrapper function updates the times for the file referred to by .BR futimes (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/get_kernel_syms.2 b/man2/get_kernel_syms.2 index ed3b8ab1d..62a2f5d5d 100644 --- a/man2/get_kernel_syms.2 +++ b/man2/get_kernel_syms.2 @@ -94,7 +94,7 @@ in favor of other interfaces described on its manual page). .BR init_module (2), .BR query_module (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/get_mempolicy.2 b/man2/get_mempolicy.2 index d830436d1..a3c3e72bd 100644 --- a/man2/get_mempolicy.2 +++ b/man2/get_mempolicy.2 @@ -250,7 +250,7 @@ For information on library support, see .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2 index 749c20021..19c7a0ea4 100644 --- a/man2/get_robust_list.2 +++ b/man2/get_robust_list.2 @@ -27,7 +27,7 @@ .\" FIXME Something could be added to this page (or exit(2)) .\" about exit_robust_list processing .\" -.TH GET_ROBUST_LIST 2 2017-09-15 Linux "Linux System Calls" +.TH GET_ROBUST_LIST 2 2019-10-10 Linux "Linux System Calls" .SH NAME get_robust_list, set_robust_list \- get/set list of robust futexes .SH SYNOPSIS @@ -119,6 +119,10 @@ The .BR get_robust_list () system call can fail with the following errors: .TP +.B EFAULT +The head of the robust futex list can't be stored at the location +.IR head . +.TP .B EPERM The calling process does not have permission to see the robust futex list of the thread with the thread ID @@ -131,10 +135,6 @@ capability. No thread with the thread ID .I pid could be found. -.TP -.B EFAULT -The head of the robust futex list can't be stored at the location -.IR head . .SH VERSIONS These system calls were added in Linux 2.6.17. .SH NOTES @@ -171,7 +171,7 @@ and in the Linux kernel source tree .\" http://lwn.net/Articles/172149/ .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getcpu.2 b/man2/getcpu.2 index cfa97d945..7097450fe 100644 --- a/man2/getcpu.2 +++ b/man2/getcpu.2 @@ -141,7 +141,7 @@ migrating threads between CPUs, and so the argument is now ignored. .BR cpuset (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdents.2 b/man2/getdents.2 index 00a26af6c..4000210e2 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -310,7 +310,7 @@ main(int argc, char *argv[]) .BR readdir (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index dfa4f4bbb..acb20a85b 100644 --- a/man2/getdomainname.2 +++ b/man2/getdomainname.2 @@ -26,7 +26,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2008-11-27 by mtk .\" -.TH GETDOMAINNAME 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH GETDOMAINNAME 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME getdomainname, setdomainname \- get/set NIS domain name .SH SYNOPSIS @@ -57,6 +57,8 @@ Feature Test Macro Requirements for glibc (see .SH DESCRIPTION These functions are used to access or to change the NIS domain name of the host system. +More precisely, they operate on the NIS domain name associated with the calling +process's UTS namespace. .PP .BR setdomainname () sets the domain name to the value given in the character array @@ -134,9 +136,10 @@ field returned from a call to .SH SEE ALSO .BR gethostname (2), .BR sethostname (2), -.BR uname (2) +.BR uname (2), +.BR uts_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgid.2 b/man2/getgid.2 index 42fbbb080..c437f5a47 100644 --- a/man2/getgid.2 +++ b/man2/getgid.2 @@ -81,7 +81,7 @@ for details regarding register mapping. .BR setregid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 50210fb23..dda88b4a6 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -226,7 +226,7 @@ For details, see .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gethostname.2 b/man2/gethostname.2 index b9e64e199..071dad874 100644 --- a/man2/gethostname.2 +++ b/man2/gethostname.2 @@ -29,7 +29,7 @@ .\" Modified 2004-06-17 by mtk .\" Modified 2008-11-27 by mtk .\" -.TH GETHOSTNAME 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH GETHOSTNAME 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME gethostname, sethostname \- get/set hostname .SH SYNOPSIS @@ -67,8 +67,9 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .PD .ad .SH DESCRIPTION -These system calls are used to access or to change the hostname of the -current processor. +These system calls are used to access or to change the system hostname. +More precisely, they operate on the hostname associated with the calling +process's UTS namespace. .PP .BR sethostname () sets the hostname to the value given in the character array @@ -184,9 +185,10 @@ set to .BR hostname (1), .BR getdomainname (2), .BR setdomainname (2), -.BR uname (2) +.BR uname (2), +.BR uts_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getitimer.2 b/man2/getitimer.2 index b97ae5986..ce510d5d4 100644 --- a/man2/getitimer.2 +++ b/man2/getitimer.2 @@ -264,7 +264,7 @@ error. .BR timerfd_create (2), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index f7f0b3400..0407ccfc5 100644 --- a/man2/getpagesize.2 +++ b/man2/getpagesize.2 @@ -113,7 +113,7 @@ Things are OK in glibc 2.1. .BR mmap (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 5ffde1151..2bfc1aa19 100644 --- a/man2/getpeername.2 +++ b/man2/getpeername.2 @@ -142,7 +142,7 @@ the address of the sender when using .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpid.2 b/man2/getpid.2 index 48ac70d3b..0abf55b9e 100644 --- a/man2/getpid.2 +++ b/man2/getpid.2 @@ -165,7 +165,7 @@ for details regarding register mapping. .BR credentials (7), .BR pid_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpriority.2 b/man2/getpriority.2 index 84c99cba4..2d80abd56 100644 --- a/man2/getpriority.2 +++ b/man2/getpriority.2 @@ -251,7 +251,7 @@ which may be made standards conformant in the future. .I Documentation/scheduler/sched-nice-design.txt in the Linux kernel source tree (since Linux 2.6.23) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrandom.2 b/man2/getrandom.2 index e29caac17..b33e4d927 100644 --- a/man2/getrandom.2 +++ b/man2/getrandom.2 @@ -309,7 +309,7 @@ does not react to interrupts before reading all bytes requested. .BR random (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getresuid.2 b/man2/getresuid.2 index 9ad730960..2df29fa17 100644 --- a/man2/getresuid.2 +++ b/man2/getresuid.2 @@ -90,7 +90,7 @@ wrapper functions transparently deal with the variations across kernel versions. .BR setuid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 916b0989b..9ae73ed39 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -853,7 +853,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrusage.2 b/man2/getrusage.2 index 203519f30..716ccb1cf 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -271,7 +271,7 @@ in .BR wait4 (2), .BR clock (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsid.2 b/man2/getsid.2 index dd313a084..f1f400d4b 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -96,7 +96,7 @@ for a description of sessions and session IDs. .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockname.2 b/man2/getsockname.2 index 292f4da29..c7a4775c8 100644 --- a/man2/getsockname.2 +++ b/man2/getsockname.2 @@ -113,7 +113,7 @@ type, see .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index 32a29567e..5eeffb0e5 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -204,7 +204,7 @@ system. .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettid.2 b/man2/gettid.2 index 205ee94dc..b42cbadda 100644 --- a/man2/gettid.2 +++ b/man2/gettid.2 @@ -98,7 +98,7 @@ is the same as its thread ID (the value returned by .BR tgkill (2), .BR timer_create (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index af20d5d82..1c76c7a08 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -289,7 +289,7 @@ has been abandoned. .BR vdso (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getuid.2 b/man2/getuid.2 index c6d5b8084..a856f0488 100644 --- a/man2/getuid.2 +++ b/man2/getuid.2 @@ -92,7 +92,7 @@ for details regarding register mapping. .BR setuid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getunwind.2 b/man2/getunwind.2 index a4e0fb72f..f96c20483 100644 --- a/man2/getunwind.2 +++ b/man2/getunwind.2 @@ -109,7 +109,7 @@ in the unlikely event that you want to call it, use .SH SEE ALSO .BR getauxval (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getxattr.2 b/man2/getxattr.2 index 2d90c2d5c..3a8cc01e6 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -162,7 +162,7 @@ See .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/idle.2 b/man2/idle.2 index 4d68b9934..fecebe4b7 100644 --- a/man2/idle.2 +++ b/man2/idle.2 @@ -62,7 +62,7 @@ Since Linux 2.3.13, this system call does not exist anymore. This function is Linux-specific, and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/init_module.2 b/man2/init_module.2 index 0802f14f2..810eb7a30 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -358,7 +358,7 @@ the rest of the module. .BR lsmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2 index 67dff40e6..a52fb4893 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -25,7 +25,7 @@ .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version .\" 2006-02-07 mtk, various changes .\" -.TH INOTIFY_ADD_WATCH 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH INOTIFY_ADD_WATCH 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME inotify_add_watch \- add a watch to an initialized inotify instance .SH SYNOPSIS @@ -89,6 +89,15 @@ Read access to the given file is not permitted. .B EBADF The given file descriptor is not valid. .TP +.B EEXIST +.I mask +contains +.B IN_MASK_CREATE +and +.I pathname +refers to a file already being watched by the same +.IR fd . +.TP .B EFAULT .I pathname points outside of the process's accessible address space. @@ -127,15 +136,6 @@ contains and .I pathname is not a directory. -.TP -.B EEXIST -.I mask -contains -.B IN_MASK_CREATE -and -.I pathname -refers to a file already being watched by the same -.IR fd . .SH VERSIONS Inotify was merged into the 2.6.13 Linux kernel. .SH CONFORMING TO @@ -145,7 +145,7 @@ This system call is Linux-specific. .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/inotify_init.2 b/man2/inotify_init.2 index 2297ffd3d..8ae2c000e 100644 --- a/man2/inotify_init.2 +++ b/man2/inotify_init.2 @@ -110,7 +110,7 @@ These system calls are Linux-specific. .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/inotify_rm_watch.2 b/man2/inotify_rm_watch.2 index d76bc770f..7ca57ceaa 100644 --- a/man2/inotify_rm_watch.2 +++ b/man2/inotify_rm_watch.2 @@ -73,7 +73,7 @@ This system call is Linux-specific. .BR inotify_init (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/intro.2 b/man2/intro.2 index 8edae79a2..b2cedfd8c 100644 --- a/man2/intro.2 +++ b/man2/intro.2 @@ -133,7 +133,7 @@ Note that these can be different from page to page! .BR sysvipc (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/io_cancel.2 b/man2/io_cancel.2 index 6b56de55c..4d18bb4ec 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -100,7 +100,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/io_destroy.2 b/man2/io_destroy.2 index 1127a0117..5fe731b1e 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -89,7 +89,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/io_getevents.2 b/man2/io_getevents.2 index b2ac0f344..4bd5be77e 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -133,7 +133,7 @@ may cause a segmentation fault instead of generating the error .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/io_setup.2 b/man2/io_setup.2 index 37fa405df..76c8fac6c 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -102,7 +102,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/io_submit.2 b/man2/io_submit.2 index 9bf3101dd..4818435b1 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -5,7 +5,7 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_SUBMIT 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH IO_SUBMIT 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME io_submit \- submit asynchronous I/O blocks for processing .SH SYNOPSIS @@ -69,7 +69,7 @@ structure upon I/O completion (see .I aio_key This is an internal field used by the kernel. Do not modify this field after an -.BR io_submit (2) +.BR io_submit () call. .TP .I aio_rw_flags @@ -91,7 +91,7 @@ The field is ignored. The file offset is not changed. .TP -.BR RWF_DSYNC " (since Linux 4.7)" +.BR RWF_DSYNC " (since Linux 4.13)" Write operation complete according to requirement of synchronized I/O data integrity. See the description of the flag of the same name in @@ -101,7 +101,7 @@ as well the description of in .BR open (2). .TP -.BR RWF_HIPRI " (since Linux 4.6)" +.BR RWF_HIPRI " (since Linux 4.13)" High priority request, poll if possible .TP .BR RWF_NOWAIT " (since Linux 4.14)" @@ -118,7 +118,7 @@ field of the structure (see .BR io_getevents (2)). .TP -.BR RWF_SYNC " (since Linux 4.7)" +.BR RWF_SYNC " (since Linux 4.13)" Write operation complete according to requirement of synchronized I/O file integrity. See the description of the flag of the same name in @@ -278,7 +278,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl.2 b/man2/ioctl.2 index 0d3902ede..dcd00ca35 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -157,7 +157,7 @@ flag. .BR sd (4), .BR tty (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2 index 53f8041e3..a9a914e63 100644 --- a/man2/ioctl_console.2 +++ b/man2/ioctl_console.2 @@ -872,7 +872,7 @@ Use POSIX functions. .IR /usr/include/linux/kd.h , .I /usr/include/linux/vt.h .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_fat.2 b/man2/ioctl_fat.2 index 935777244..acc4c70d9 100644 --- a/man2/ioctl_fat.2 +++ b/man2/ioctl_fat.2 @@ -501,7 +501,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_ficlonerange.2 b/man2/ioctl_ficlonerange.2 index 23ee40733..d603819ed 100644 --- a/man2/ioctl_ficlonerange.2 +++ b/man2/ioctl_ficlonerange.2 @@ -144,7 +144,7 @@ not fail because of lack of disk space. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_fideduperange.2 b/man2/ioctl_fideduperange.2 index 2b2c7339a..a4d79257f 100644 --- a/man2/ioctl_fideduperange.2 +++ b/man2/ioctl_fideduperange.2 @@ -20,7 +20,7 @@ .\" License along with this manual; if not, see .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END -.TH IOCTL-FIDEDUPERANGE 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IOCTL-FIDEDUPERANGE 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_fideduperange \- share some the data of one file with another file .SH SYNOPSIS @@ -151,13 +151,6 @@ is set to indicate the error. .SH ERRORS Error codes can be one of, but are not limited to, the following: .TP -.B ENOMEM -The kernel was unable to allocate sufficient memory to perform the -operation or -.IR dest_count -is so large that the input argument description spans more than a single -page of memory. -.TP .B EBADF .IR src_fd is not open for reading; @@ -180,6 +173,13 @@ overlapping deduplication ranges in the same file. One of the files is a directory and the filesystem does not support shared regions in directories. .TP +.B ENOMEM +The kernel was unable to allocate sufficient memory to perform the +operation or +.IR dest_count +is so large that the input argument description spans more than a single +page of memory. +.TP .B EOPNOTSUPP This can appear if the filesystem does not support deduplicating either file descriptor, or if either file descriptor refers to special inodes. @@ -213,7 +213,7 @@ single call. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_getfsmap.2 b/man2/ioctl_getfsmap.2 index 3a71a977f..334e2665e 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -372,7 +372,7 @@ distribution for a sample program. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_iflags.2 b/man2/ioctl_iflags.2 index 4ce2fe3b6..69cfb4832 100644 --- a/man2/ioctl_iflags.2 +++ b/man2/ioctl_iflags.2 @@ -210,7 +210,7 @@ capability. .BR xattr (7), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_list.2 b/man2/ioctl_list.2 index 193546254..f4804b2e3 100644 --- a/man2/ioctl_list.2 +++ b/man2/ioctl_list.2 @@ -1042,7 +1042,7 @@ l l l. .BR ioctl_fat (2), .BR netdevice (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_ns.2 b/man2/ioctl_ns.2 index 8b665e095..2a30933f0 100644 --- a/man2/ioctl_ns.2 +++ b/man2/ioctl_ns.2 @@ -361,7 +361,7 @@ main(int argc, char *argv[]) .BR proc (5), .BR namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index ca8a455cd..66bee9112 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -592,7 +592,7 @@ main(void) .\" TIOCSERSETMULTI const struct serial_multiport_struct * .\" TIOCGSERIAL, TIOCSSERIAL (see above) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_userfaultfd.2 b/man2/ioctl_userfaultfd.2 index 10d6c753b..5d1cf13d7 100644 --- a/man2/ioctl_userfaultfd.2 +++ b/man2/ioctl_userfaultfd.2 @@ -690,7 +690,7 @@ See .IR Documentation/admin-guide/mm/userfaultfd.rst in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioperm.2 b/man2/ioperm.2 index f7218d766..58a8c7d97 100644 --- a/man2/ioperm.2 +++ b/man2/ioperm.2 @@ -121,7 +121,7 @@ Avoid the latter, it is available on i386 only. .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/iopl.2 b/man2/iopl.2 index b8972e72a..c6eef2f20 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -113,7 +113,7 @@ and won't be reinstated. .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioprio_set.2 b/man2/ioprio_set.2 index 7026d91ca..62b00c3eb 100644 --- a/man2/ioprio_set.2 +++ b/man2/ioprio_set.2 @@ -370,7 +370,7 @@ Suitable definitions can be found in .I Documentation/block/ioprio.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ipc.2 b/man2/ipc.2 index 6c16cbc95..f2c5bf63d 100644 --- a/man2/ipc.2 +++ b/man2/ipc.2 @@ -69,7 +69,7 @@ and so on really are implemented as separate system calls. .BR shmget (2), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 64fdc056d..6128e7bf8 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -25,7 +25,7 @@ .\" .\" Kernel commit d97b46a64674a267bc41c9e16132ee2a98c3347d .\" -.TH KCMP 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH KCMP 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME kcmp \- compare two processes to determine if they share a kernel resource .SH SYNOPSIS @@ -260,10 +260,20 @@ or .I fd2 is not an open file descriptor. .TP +.B EFAULT +The epoll slot addressed by +.I idx2 +is outside of the user's address space. +.TP .B EINVAL .I type is invalid. .TP +.B ENOENT +The target file is not present in +.BR epoll (7) +instance. +.TP .B EPERM Insufficient permission to inspect process resources. The @@ -285,16 +295,6 @@ Process or .I pid2 does not exist. -.TP -.B EFAULT -The epoll slot addressed by -.I idx2 -is outside of the user's address space. -.TP -.B ENOENT -The target file is not present in -.BR epoll (7) -instance. .SH VERSIONS The .BR kcmp () @@ -429,7 +429,7 @@ main(int argc, char *argv[]) .BR clone (2), .BR unshare (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kexec_load.2 b/man2/kexec_load.2 index 8df128738..c7d0beede 100644 --- a/man2/kexec_load.2 +++ b/man2/kexec_load.2 @@ -348,7 +348,7 @@ The kernel source files and .IR Documentation/admin-guide/kernel-parameters.txt .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/keyctl.2 b/man2/keyctl.2 index a55b6ff35..b6071a951 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -2284,7 +2284,7 @@ The kernel source files under (or, before Linux 4.13, in the file .IR Documentation/security/keys.txt ). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kill.2 b/man2/kill.2 index 61777f5f7..a1118c072 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -41,7 +41,7 @@ .\" Modified 2004-06-24 by aeb .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr .\" -.TH KILL 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH KILL 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME kill \- send signal to a process .SH SYNOPSIS @@ -107,11 +107,11 @@ is set appropriately. An invalid signal was specified. .TP .B EPERM -The process does not have permission to send the signal +The calling process does not have permission to send the signal to any of the target processes. .TP .B ESRCH -The process or process group does not exist. +The target process or process group does not exist. Note that an existing process might be a zombie, a process that has terminated execution, but has not yet been @@ -170,6 +170,7 @@ to all of the processes for which the caller had permission to signal. .SH SEE ALSO .BR kill (1), .BR _exit (2), +.BR pidfd_send_signal (2), .BR signal (2), .BR tkill (2), .BR exit (3), @@ -179,7 +180,7 @@ to all of the processes for which the caller had permission to signal. .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/link.2 b/man2/link.2 index 60f896777..1b1c889b8 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -431,7 +431,7 @@ to find out if the link got created. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listen.2 b/man2/listen.2 index e421c95f1..2ab3da08a 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -184,7 +184,7 @@ See .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listxattr.2 b/man2/listxattr.2 index 699c23ae9..7a1fe68b8 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/llseek.2 b/man2/llseek.2 index 028789b08..6f85b8c0c 100644 --- a/man2/llseek.2 +++ b/man2/llseek.2 @@ -96,7 +96,7 @@ wrapper function instead. .BR open (2), .BR lseek64 (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/lookup_dcookie.2 b/man2/lookup_dcookie.2 index 78a75aa75..70aba97f6 100644 --- a/man2/lookup_dcookie.2 +++ b/man2/lookup_dcookie.2 @@ -90,7 +90,7 @@ entry has been removed. .SH SEE ALSO .BR oprofile (1) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/lseek.2 b/man2/lseek.2 index f683b120e..b71f5fba3 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -268,7 +268,7 @@ on a terminal device fails with the error .BR lseek64 (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/madvise.2 b/man2/madvise.2 index 66835280c..3ceb985db 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -577,7 +577,7 @@ from the system call, as it should). .BR posix_madvise (3), .BR core (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mbind.2 b/man2/mbind.2 index ce307472d..dd6338da2 100644 --- a/man2/mbind.2 +++ b/man2/mbind.2 @@ -490,7 +490,7 @@ are available only on Linux 2.6.16 and later. .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/membarrier.2 b/man2/membarrier.2 index 22478a631..e4ea1cf6c 100644 --- a/man2/membarrier.2 +++ b/man2/membarrier.2 @@ -414,7 +414,7 @@ main(int argc, char **argv) .EE .in .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/memfd_create.2 b/man2/memfd_create.2 index 7499ef8ff..6bb899d58 100644 --- a/man2/memfd_create.2 +++ b/man2/memfd_create.2 @@ -535,7 +535,7 @@ main(int argc, char *argv[]) .BR shmget (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/migrate_pages.2 b/man2/migrate_pages.2 index 58b89922b..c9a149d0e 100644 --- a/man2/migrate_pages.2 +++ b/man2/migrate_pages.2 @@ -183,7 +183,7 @@ or a similar package. .IR Documentation/vm/page_migration.rst in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mincore.2 b/man2/mincore.2 index 5ba13bfa6..529e41256 100644 --- a/man2/mincore.2 +++ b/man2/mincore.2 @@ -174,7 +174,7 @@ mappings, or for nonlinear mappings (established using .BR posix_fadvise (2), .BR posix_madvise (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 5ad1a3ed7..0ccd98422 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -252,7 +252,7 @@ argument. .BR acl (5) .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mknod.2 b/man2/mknod.2 index 59c9d53b6..84275b3e2 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -301,7 +301,7 @@ and .BR acl (5) .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mlock.2 b/man2/mlock.2 index ac5bcf776..1f08d521f 100644 --- a/man2/mlock.2 +++ b/man2/mlock.2 @@ -498,7 +498,7 @@ resource limit is encountered. .BR proc (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap.2 b/man2/mmap.2 index f2907e643..12ef134dc 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -37,7 +37,7 @@ .\" 2007-07-10, mtk, Added an example program. .\" 2008-11-18, mtk, document MAP_STACK .\" -.TH MMAP 2 2019-02-27 "Linux" "Linux Programmer's Manual" +.TH MMAP 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME mmap, munmap \- map or unmap files or devices into memory .SH SYNOPSIS @@ -565,11 +565,11 @@ was 0. .TP .B EINVAL .I flags -contained neither -.B MAP_PRIVATE +contained none of +.BR MAP_PRIVATE , +.B MAP_SHARED or -.BR MAP_SHARED , -or contained both of these values. +.BR MAP_SHARED_VALIDATE . .TP .B ENFILE .\" This is for shared anonymous segments @@ -1007,7 +1007,7 @@ B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128\(en129 and 389\(en391. .\" Repeat after me: private read-only mappings are 100% equivalent to .\" shared read-only mappings. No ifs, buts, or maybes. -- Linus .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap2.2 b/man2/mmap2.2 index 92f2dfec7..4d3b6a183 100644 --- a/man2/mmap2.2 +++ b/man2/mmap2.2 @@ -99,7 +99,7 @@ is actually the system page size, rather than 4096 bytes. .BR msync (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/modify_ldt.2 b/man2/modify_ldt.2 index 80dbd9a17..018f717bd 100644 --- a/man2/modify_ldt.2 +++ b/man2/modify_ldt.2 @@ -209,7 +209,7 @@ will still notice the bit even when set in a 32-bit process. .BR set_thread_area (2), .BR vm86 (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mount.2 b/man2/mount.2 index 161d17980..8eacddbb1 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -305,7 +305,7 @@ The following flags are per-superblock: .BR MS_DIRSYNC , .BR MS_LAZYTIME , .BR MS_MANDLOCK , -.BR MS_MS_SILENT , +.BR MS_SILENT , and .BR MS_SYNCHRONOUS . .\" And MS_I_VERSION? @@ -849,12 +849,11 @@ Since Linux 2.4 the set-user-ID and set-group-ID bits are just silently ignored in this case. .\" The change is in patch-2.4.0-prerelease. .\" -.SS Per-process namespaces -Starting with kernel 2.4.19, Linux provides -per-process mount namespaces. +.SS Mount namespaces +Starting with kernel 2.4.19, Linux provides mount namespaces. A mount namespace is the set of filesystem mounts that are visible to a process. -Mount-point namespaces can be (and usually are) +Mount namespaces can be (and usually are) shared between multiple processes, and changes to the namespace (i.e., mounts and unmounts) by one process are visible to all other processes sharing the same namespace. @@ -887,6 +886,27 @@ so that future mounts and unmounts by the caller are invisible to other processes (except child processes that the caller subsequently creates) and vice versa. .PP +For further details on mount namespaces, see +.BR mount_namespaces (7). +.\" +.SS Parental relationship between mount points +Each mount point has a parent mount point. +The overall parental relationship of all mount points defines +the single directory hierarchy seen by the processes within a mount namespace. +.PP +The parent of a new mount point is defined when the mount point is created. +In the usual case, +the parent of a new mount is the mount point of the filesystem +containing the directory or file at which the new mount is attached. +In the case where a new mount is stacked on top of an existing mount, +the parent of the new mount is the previous mount that was stacked +at that location. +.PP +The parental relationship between mount points can be discovered via the +.I /proc/[pid]/mountinfo +file (see below). +.\" +.SS /proc/[pid]/mounts and /proc/[pid]/mountinfo The Linux-specific .I /proc/[pid]/mounts file exposes the list of mount points in the mount @@ -900,7 +920,7 @@ See .BR proc (5) and .BR mount_namespaces (7) -for details of these files. +for details of this file. .SH SEE ALSO .BR mountpoint (1), .BR chroot (2), @@ -914,7 +934,7 @@ for details of these files. .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/move_pages.2 b/man2/move_pages.2 index a74de3b44..fc4a45738 100644 --- a/man2/move_pages.2 +++ b/man2/move_pages.2 @@ -17,7 +17,7 @@ .\" (e.g., compare with recommendation in mbind(2)). .\" Does this page need to give advice on this topic? .\" -.TH MOVE_PAGES 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MOVE_PAGES 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME move_pages \- move individual pages of a process to another node .SH SYNOPSIS @@ -169,6 +169,9 @@ to indicate the error. .TP .B E2BIG Too many pages to move. +Since Linux 2.6.29, +.\" commit 3140a2273009c01c27d316f35ab76a37e105fdd8 +the kernel no longer generates this error. .TP .B EACCES .\" FIXME Clarify "current cpuset" in the description of the EACCES error. @@ -251,7 +254,7 @@ or a similar package. .BR migratepages (8), .BR numastat (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mprotect.2 b/man2/mprotect.2 index 97632f7cb..6841d2720 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -271,7 +271,7 @@ is used with .IR prot set to .B PROT_EXEC -a pkey is may be allocated and set on the memory implicitly +a pkey may be allocated and set on the memory implicitly by the kernel, but only when the pkey was 0 previously. .PP On systems that do not support protection keys in hardware, @@ -374,7 +374,7 @@ main(int argc, char *argv[]) .BR sysconf (3), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mq_getsetattr.2 b/man2/mq_getsetattr.2 index a0391e737..0e9e8d3ee 100644 --- a/man2/mq_getsetattr.2 +++ b/man2/mq_getsetattr.2 @@ -57,7 +57,7 @@ Glibc does not provide a wrapper for this system call; call it using .BR mq_getattr (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mremap.2 b/man2/mremap.2 index dfe66da71..81e64933b 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -275,7 +275,7 @@ for more information on paged memory \fIInside Linux\fP by Randolf Bentson, \fIThe Design of the UNIX Operating System\fP by Maurice J.\& Bach) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgctl.2 b/man2/msgctl.2 index ffd32721d..58059d936 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -390,7 +390,7 @@ flag in .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgget.2 b/man2/msgget.2 index a4df1bd73..8439e9208 100644 --- a/man2/msgget.2 +++ b/man2/msgget.2 @@ -248,7 +248,7 @@ would more clearly show its function. .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgop.2 b/man2/msgop.2 index f58475514..7c6abdb5f 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -714,7 +714,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msync.2 b/man2/msync.2 index 181e804ed..63d5b0f5a 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -152,7 +152,7 @@ in .PP B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128\(en129 and 389\(en391. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index 0a4f598ba..b1b2bedbd 100644 --- a/man2/nanosleep.2 +++ b/man2/nanosleep.2 @@ -236,7 +236,7 @@ This problem is fixed in Linux 2.6.0 and later kernels. .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nfsservctl.2 b/man2/nfsservctl.2 index 925724840..d703ea17a 100644 --- a/man2/nfsservctl.2 +++ b/man2/nfsservctl.2 @@ -64,7 +64,7 @@ Library support was removed from glibc in version 2.28. .SH CONFORMING TO This call is Linux-specific. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nice.2 b/man2/nice.2 index 2f099c6f8..87a4d86c0 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -130,7 +130,7 @@ to obtain the new nice value, which is then returned to the caller. .BR capabilities (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/open.2 b/man2/open.2 index b40074404..26582ff68 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -563,7 +563,7 @@ Neither the nor any subsequent I/O operations on the file descriptor which is returned will cause the calling process to wait. .IP -Note that ithe setting of this flag has no effect on the operation of +Note that the setting of this flag has no effect on the operation of .BR poll (2), .BR select (2), .BR epoll (7), @@ -1792,7 +1792,7 @@ is ignored). .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/open_by_handle_at.2 b/man2/open_by_handle_at.2 index c36db7e2a..2e295fbda 100644 --- a/man2/open_by_handle_at.2 +++ b/man2/open_by_handle_at.2 @@ -765,7 +765,7 @@ release at .UR https://www.kernel.org/pub/linux/utils/util\-linux/ .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/outb.2 b/man2/outb.2 index ab3d2aceb..7f5e364da 100644 --- a/man2/outb.2 +++ b/man2/outb.2 @@ -97,7 +97,7 @@ which is the opposite order from most DOS implementations. .BR ioperm (2), .BR iopl (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pause.2 b/man2/pause.2 index 5f6376012..250d23026 100644 --- a/man2/pause.2 +++ b/man2/pause.2 @@ -62,7 +62,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .BR signal (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pciconfig_read.2 b/man2/pciconfig_read.2 index e787b7778..9d769ef5d 100644 --- a/man2/pciconfig_read.2 +++ b/man2/pciconfig_read.2 @@ -114,7 +114,7 @@ These calls are Linux-specific, available since Linux 2.0.26/2.1.11. .SH SEE ALSO .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index c533954d0..e0063360b 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -24,7 +24,7 @@ .\" This document is based on the perf_event.h header file, the .\" tools/perf/design.txt file, and a lot of bitter experience. .\" -.TH PERF_EVENT_OPEN 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PERF_EVENT_OPEN 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME perf_event_open \- set up performance monitoring .SH SYNOPSIS @@ -3452,8 +3452,11 @@ main(int argc, char **argv) .BR open (2), .BR prctl (2), .BR read (2) +.PP +.IR Documentation/admin-guide/perf-security.rst +in the kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2 index 3ea2ff754..4473d2da4 100644 --- a/man2/perfmonctl.2 +++ b/man2/perfmonctl.2 @@ -207,7 +207,7 @@ Glibc does not provide a wrapper for this system call; call it using .PP The perfmon2 interface specification .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/personality.2 b/man2/personality.2 index 1f59ae309..cbfb879fd 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -270,7 +270,7 @@ be portable. .SH SEE ALSO .BR setarch (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pidfd_open.2 b/man2/pidfd_open.2 new file mode 100644 index 000000000..efc7e87c0 --- /dev/null +++ b/man2/pidfd_open.2 @@ -0,0 +1,256 @@ +.\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com> +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.TH PIDFD_OPEN 2 2019-09-19 "Linux" "Linux Programmer's Manual" +.SH NAME +pidfd_open \- obtain a file descriptor that refers to a process +.SH SYNOPSIS +.nf +.B #include <sys/types.h> +.PP +.BI "int pidfd_open(pid_t " pid ", unsigned int " flags ); +.fi +.SH DESCRIPTION +The +.BR pidfd_open () +system call creates a file descriptor that refers to +the process whose PID is specified in +.IR pid . +The file descriptor is returned as the function result; +the close-on-exec flag is set on the file descriptor. +.PP +The +.I flags +argument is reserved for future use; +currently, this argument must be specified as 0. +.SH RETURN VALUE +On success, +.BR pidfd_open () +returns a nonnegative file descriptor. +On error, \-1 is returned and +.I errno +is set to indicate the cause of the error. +.SH ERRORS +.TP +.B EINVAL +.I flags +is not 0. +.TP +.B EINVAL +.I pid +is not valid. +.TP +.B EMFILE +The per-process limit on the number of open file descriptors has been reached +(see the description of +.BR RLIMIT_NOFILE +in +.BR getrlimit (2)). +.TP +.B ENFILE +The system-wide limit on the total number of open files has been reached. +.TP +.B ENODEV +The anonymous inode filesystem is not available in this kernel. +.TP +.B ENOMEM +Insufficient kernel memory was available. +.TP +.B ESRCH +The process specified by +.I pid +does not exist. +.SH VERSIONS +.BR pidfd_open () +first appeared in Linux 5.3. +.SH CONFORMING TO +.BR pidfd_open () +is Linux specific. +.SH NOTES +Currently, there is no glibc wrapper for this system call; call it using +.BR syscall (2). +.PP +The following code sequence can be used to obtain a file descriptor +for the child of +.BR fork (2): +.PP +.in +4n +.EX +pid = fork(); +if (pid > 0) { /* If parent */ + pidfd = pidfd_open(pid, 0); + ... +} +.EE +.in +.PP +Even if the child has already terminated by the time of the +.BR pidfd_open () +call, its PID will not have been recycled and the returned +file descriptor will refer to the resulting zombie process. +Note, however, that this is guaranteed only if the following +conditions hold true: +.IP * 3 +the disposition of +.BR SIGCHLD +has not been explicitly set to +.BR SIG_IGN +(see +.BR sigaction (2)); +.IP * +the +.BR SA_NOCLDSTOP +flag was not specified while establishing a handler for +.BR SIGCHLD +or while setting the disposition of that signal to +.BR SIG_DFL +(see +.BR sigaction (2)); +and +.IP * +the zombie process was not reaped elsewhere in the program +(e.g., either by an asynchronously executed signal handler or by +.BR wait (2) +or similar in another thread). +.PP +If any of these conditions does not hold, +then the child process should instead be created using +.BR clone (2) +with the +.BR CLONE_PIDFD +flag. +.PP +The +.BR pidfd_send_signal (2) +system call can be used to send a signal to the process referred to by +a PID file descriptor. +.PP +A PID file descriptor can be monitored using +.BR poll (2), +.BR select (2), +and +.BR epoll (7). +When the process that it refers to terminates, +these interfaces indicate the file descriptor as readable. +Note, however, that in the current implementation, +nothing can be read from the file descriptor +.RB ( read (2) +on the file descriptor fails with the error +.BR EINVAL ). +.PP +The +.BR pidfd_open () +system call is the preferred way of obtaining a PID file descriptor. +The alternative is to obtain a file descriptor by opening a +.I /proc/[pid] +directory. +However, the latter technique is possible only if the +.BR proc (5) +file system is mounted; +furthermore, the file descriptor obtained in this way is +.I not +pollable. +.PP +See also the discussion of the +.BR CLONE_PIDFD +flag in +.BR clone (2). +.SH EXAMPLE +The program below opens a PID file descriptor for the +process whose PID is specified as its command-line argument. +It then uses +.BR poll (2) +to monitor the file descriptor for process exit, as indicated by an +.BR EPOLLIN +event. +.\" +.SS Program source +\& +.nf +#define _GNU_SOURCE +#include <sys/types.h> +#include <sys/syscall.h> +#include <unistd.h> +#include <poll.h> +#include <stdlib.h> +#include <stdio.h> + +#ifndef __NR_pidfd_open +#define __NR_pidfd_open 434 /* System call # on most architectures */ +#endif + +static int +pidfd_open(pid_t pid, unsigned int flags) +{ + return syscall(__NR_pidfd_open, pid, flags); +} + +int +main(int argc, char *argv[]) +{ + struct pollfd pollfd; + int pidfd, ready; + + if (argc != 2) { + fprintf(stderr, "Usage: %s <pid>\en", argv[0]); + exit(EXIT_SUCCESS); + } + + pidfd = pidfd_open(atoi(argv[1]), 0); + if (pidfd == \-1) { + perror("pidfd_open"); + exit(EXIT_FAILURE); + } + + pollfd.fd = pidfd; + pollfd.events = POLLIN; + + ready = poll(&pollfd, 1, \-1); + if (ready == \-1) { + perror("poll"); + exit(EXIT_FAILURE); + } + + printf("Events (0x%x): POLLIN is %sset\en", pollfd.revents, + (pollfd.revents & POLLIN) ? "" : "not "); + + exit(EXIT_SUCCESS); +} +.fi +.SH SEE ALSO +.BR clone (2), +.BR kill (2), +.BR pidfd_send_signal (2), +.BR poll (2), +.BR select (2), +.BR epoll (7) +.SH COLOPHON +This page is part of release 5.03 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff --git a/man2/pidfd_send_signal.2 b/man2/pidfd_send_signal.2 new file mode 100644 index 000000000..3d4025320 --- /dev/null +++ b/man2/pidfd_send_signal.2 @@ -0,0 +1,264 @@ +.\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com> +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.TH PIDFD_SEND_SIGNAL 2 2019-09-19 "Linux" "Linux Programmer's Manual" +.SH NAME +pidfd_send_signal \- send a signal to a process specified by a file descriptor +.SH SYNOPSIS +.nf +.B "#include <signal.h>" +.PP +.BI "int pidfd_send_signal(int " pidfd ", int " sig ", siginfo_t *" info , +.BI " unsigned int " flags ); +.fi +.SH DESCRIPTION +The +.BR pidfd_send_signal () +system call sends the signal +.I sig +to the target process referred to by +.IR pidfd , +a PID file descriptor that refers to a process. +.\" See the very detailed commit message for kernel commit +.\" 3eb39f47934f9d5a3027fe00d906a45fe3a15fad +.PP +If the +.I info +argument points to a +.I siginfo_t +buffer, that buffer should be populated as described in +.BR rt_sigqueueinfo (2). +.PP +If the +.I info +argument is a NULL pointer, +this is equivalent to specifying a pointer to a +.I siginfo_t +buffer whose fields match the values that are +implicitly supplied when a signal is sent using +.BR kill (2): +.PP +.PD 0 +.IP * 3 +.I si_signo +is set to the signal number; +.IP * +.I si_errno +is set to 0; +.IP * +.I si_code +is set to +.BR SI_USER; +.IP * +.I si_pid +is set to the caller's PID; and +.IP * +.I si_uid +is set to the caller's real user ID. +.PD +.PP +The calling process must either be in the same PID namespace as the +process referred to by +.IR pidfd , +or be in an ancestor of that namespace. +.PP +The +.I flags +argument is reserved for future use; +currently, this argument must be specified as 0. +.SH RETURN VALUE +On success, +.BR pidfd_send_signal () +returns 0. +On error, \-1 is returned and +.I errno +is set to indicate the cause of the error. +.SH ERRORS +.TP +.B EBADF +.I pidfd +is not a valid PID file descriptor. +.TP +.B EINVAL +.I sig +is not a valid signal. +.TP +.B EINVAL +The calling process is not in a PID namespace from which it can +send a signal to the target process. +.TP +.B EINVAL +.I flags +is not 0. +.TP +.B EPERM +The calling process does not have permission to send the signal +to the target process. +.TP +.B EPERM +.I pidfd +doesn't refer to the calling process, and +.IR info.si_code +is invalid (see +.BR rt_sigqueueinfo (2)). +.TP +.B ESRCH +The target process does not exist +(i.e., it has terminated and been waited on). +.SH VERSIONS +.BR pidfd_send_signal () +first appeared in Linux 5.1. +.SH CONFORMING TO +.BR pidfd_send_signal () +is Linux specific. +.SH NOTES +Currently, there is no glibc wrapper for this system call; call it using +.BR syscall (2). +.\" +.SS PID file descriptors +The +.I pidfd +argument is a PID file descriptor, +a file descriptor that refers to process. +Such a file descriptor can be obtained in any of the following ways: +.IP * 3 +by opening a +.IR /proc/[pid] +directory; +.IP * +using +.BR pidfd_open (2); +or +.IP * +via the PID file descriptor that is returned by a call to +.BR clone (2) +or +.BR clone3 (2) +that specifies the +.BR CLONE_PIDFD +flag. +.PP +The +.BR pidfd_send_signal () +system call allows the avoidance of race conditions that occur +when using traditional interfaces (such as +.BR kill (2)) +to signal a process. +The problem is that the traditional interfaces specify the target process +via a process ID (PID), +with the result that the sender may accidentally send a signal to +the wrong process if the originally intended target process +has terminated and its PID has been recycled for another process. +By contrast, +a PID file descriptor is a stable reference to a specific process; +if that process terminates, +.BR pidfd_send_signal () +fails with the error +.BR ESRCH . +.SH EXAMPLE +.nf +#define _GNU_SOURCE +#include <limits.h> +#include <signal.h> +#include <fcntl.h> +#include <stdio.h> +#include <string.h> +#include <stdlib.h> +#include <unistd.h> +#include <sys/syscall.h> + +#ifndef __NR_pidfd_send_signal +#define __NR_pidfd_send_signal 424 +#endif + +static int +pidfd_send_signal(int pidfd, int sig, siginfo_t *info, + unsigned int flags) +{ + return syscall(__NR_pidfd_send_signal, pidfd, sig, info, flags); +} + +int +main(int argc, char *argv[]) +{ + siginfo_t info; + char path[PATH_MAX]; + int pidfd, sig; + + if (argc != 3) { + fprintf(stderr, "Usage: %s <pid> <signal>\en", argv[0]); + exit(EXIT_FAILURE); + } + + sig = atoi(argv[2]); + + /* Obtain a PID file descriptor by opening the /proc/PID directory + of the target process */ + + snprintf(path, sizeof(path), "/proc/%s", argv[1]); + + pidfd = open(path, O_RDONLY); + if (pidfd == \-1) { + perror("open"); + exit(EXIT_FAILURE); + } + + /* Populate a \(aqsiginfo_t\(aq structure for use with + pidfd_send_signal() */ + + memset(&info, 0, sizeof(info)); + info.si_code = SI_QUEUE; + info.si_signo = sig; + info.si_errno = 0; + info.si_uid = getuid(); + info.si_pid = getpid(); + info.si_value.sival_int = 1234; + + /* Send the signal */ + + if (pidfd_send_signal(pidfd, sig, &info, 0) == \-1) { + perror("pidfd_send_signal"); + exit(EXIT_FAILURE); + } + + exit(EXIT_SUCCESS); +} +.fi +.SH SEE ALSO +.BR clone (2), +.BR kill (2), +.BR pidfd_open (2), +.BR rt_sigqueueinfo (2), +.BR sigaction (2), +.BR pid_namespaces (7), +.BR signal (7) +.SH COLOPHON +This page is part of release 5.03 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff --git a/man2/pipe.2 b/man2/pipe.2 index 300adf066..68ca558a3 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -294,7 +294,7 @@ main(int argc, char *argv[]) .BR popen (3), .BR pipe (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index fbb144a18..2152f6d9a 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -1,15 +1,32 @@ -.\" Copyright (C) 2000 by Werner Almesberger +.\" Copyright (C) 2019 Michael Kerrisk <mtk.manpages@gmail.com> +.\" A very few fragments remain from an earlier page written by +.\" Werner Almesberger in 2000 .\" -.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) -.\" May be distributed under GPL -.\" %%%LICENSE_END +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. .\" -.\" Written 2000-02-23 by Werner Almesberger -.\" Modified 2004-06-17 Michael Kerrisk <mtk.manpages@gmail.com> +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .TH PIVOT_ROOT 2 2019-08-02 "Linux" "Linux Programmer's Manual" .SH NAME -pivot_root \- change the root filesystem +pivot_root \- change the root mount .SH SYNOPSIS .BI "int pivot_root(const char *" new_root ", const char *" put_old ); .PP @@ -17,117 +34,111 @@ pivot_root \- change the root filesystem There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION .BR pivot_root () -moves the root filesystem of the calling process to the -directory \fIput_old\fP and makes \fInew_root\fP the new root filesystem -of the calling process. -.\" -.\" The -.\" .B CAP_SYS_ADMIN -.\" capability is required. -.PP -The typical use of -.BR pivot_root () -is during system startup, when the -system mounts a temporary root filesystem (e.g., an \fBinitrd\fP), then -mounts the real root filesystem, and eventually turns the latter into -the current root of all relevant processes or threads. -.PP -.BR pivot_root () -may or may not change the current root and the current -working directory of any processes or threads which use the old -root directory. -The caller of -.BR pivot_root () -must ensure that processes with root or current working directory -at the old root operate correctly in either case. -An easy way to ensure this is to change their -root and current working directory to \fInew_root\fP before invoking -.BR pivot_root (). +changes the root mount in the mount namespace of the calling process. +More precisely, it moves the root mount to the +directory \fIput_old\fP and makes \fInew_root\fP the new root mount. +The calling process must have the +.B CAP_SYS_ADMIN +capability in the user namespace that owns the caller's mount namespace. .PP -The paragraph above is intentionally vague because the implementation of .BR pivot_root () -may change in the future. -At the time of writing, -.BR pivot_root () -changes root and current working directory of each process or -thread to \fInew_root\fP if they point to the old root directory. -This is necessary in order to prevent kernel threads from keeping the old -root directory busy with their root and current working directory, -even if they never access -the filesystem in any way. -In the future, there may be a mechanism for -kernel threads to explicitly relinquish any access to the filesystem, -such that this fairly intrusive mechanism can be removed from -.BR pivot_root (). -.PP -Note that this also applies to the calling process: +changes the root directory and the current working directory +of each process or thread in the same mount namespace to +.I new_root +if they point to the old root directory. +(See also NOTES.) +On the other hand, .BR pivot_root () -may or may not affect its current working directory. -It is therefore recommended to call -\fBchdir("/")\fP immediately after -.BR pivot_root (). +does not change the caller's current working directory +(unless it is on the old root directory), +and thus it should be followed by a +\fBchdir("/")\fP call. .PP -The following restrictions apply to \fInew_root\fP and \fIput_old\fP: -.IP \- 3 -They must be directories. -.IP \- 3 -\fInew_root\fP and \fIput_old\fP must not be on the same filesystem as -the current root. -.IP \- 3 -\fIput_old\fP must be underneath \fInew_root\fP, that is, adding a nonzero -number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield -the same directory as \fInew_root\fP. +The following restrictions apply: .IP \- 3 -No other filesystem may be mounted on \fIput_old\fP. -.PP -See also -.BR pivot_root (8) -for additional usage examples. -.PP -If the current root is not a mount point (e.g., after -.BR chroot (2) -or -.BR pivot_root (), -see also below), not the old root directory, but the -mount point of that filesystem is mounted on \fIput_old\fP. -.PP -.I new_root -must be a mount point. -(If it is not otherwise a mount point, it suffices to bind mount +.IR new_root +and +.IR put_old +must be directories. +.IP \- .I new_root -on top of itself.) -.PP -The propagation type of +and +.I put_old +must not be on the same mount as the current root. +.IP \- +\fIput_old\fP must be at or underneath \fInew_root\fP; +that is, adding some nonnegative +number of "\fI/..\fP" prefixes to the pathname pointed to by +.I put_old +must yield the same directory as \fInew_root\fP. +.IP \- .I new_root -and its parent mount must not be +must be a path to a mount point, but can't be +.IR """/""" . +A path that is not already a mount point can be converted into one by +bind mounting the path onto itself. +.IP \- +The propagation type of the parent mount of +.IR new_root +and the parent mount of the current root directory must not be .BR MS_SHARED ; similarly, if .I put_old is an existing mount point, its propagation type must not be .BR MS_SHARED . +These restrictions ensure that +.BR pivot_root () +never propagates any changes to another mount namespace. +.IP \- +The current root directory must be a mount point. .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and \fIerrno\fP is set appropriately. .SH ERRORS .BR pivot_root () -may return (in \fIerrno\fP) any of the errors returned by +may fail with any of the same errors as .BR stat (2). -Additionally, it may return: +Additionally, it may fail with the following errors: .TP .B EBUSY -\fInew_root\fP or \fIput_old\fP are on the current root filesystem, -or a filesystem is already mounted on \fIput_old\fP. +.\" Reconfirmed that the following error occurs on Linux 5.0 by +.\" specifying 'new_root' as "/rootfs" and 'put_old' as +.\" "/rootfs/oldrootfs", and *not* bind mounting "/rootfs" on top of +.\" itself. Of course, this is an odd situation, since a later check +.\" in the kernel code will in any case yield EINVAL if 'new_root' is +.\" not a mount point. However, when the system call was first added, +.\" 'new_root' was not required to be a mount point. So, this +.\" error is nowadays probably just the result of crufty accumulation. +.\" This error can also occur if we bind mount "/" on top of itself +.\" and try to specify "/" as the 'new' (again, an odd situation). So, +.\" the EBUSY check in the kernel does still seem necessary to prevent +.\" that case. Furthermore, the "or put_old" piece is probably +.\" redundant text (although the check is in the kernel), since, +.\" in another check, 'put_old' is required to be under 'new_root'. +.I new_root +or +.I put_old +is on the current root mount. +(This error covers the pathological case where +.I new_root +is +.IR """/""" .) .TP .B EINVAL .I new_root is not a mount point. .TP .B EINVAL -\fIput_old\fP is not underneath \fInew_root\fP. +\fIput_old\fP is not at or underneath \fInew_root\fP. +.TP +.B EINVAL +The current root directory is not a mount point +(because of an earlier +.BR chroot (2)). .TP .B EINVAL -The current root is on the rootfs (initial ramfs) filesystem. +The current root is on the rootfs (initial ramfs) mount; see NOTES. .TP .B EINVAL Either the mount point at @@ -158,6 +169,38 @@ is Linux-specific and hence is not portable. Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). .PP +A command-line interface for this system call is provided by +.BR pivot_root (8). +.PP +.BR pivot_root () +allows the caller to switch to a new root filesystem while at the same time +placing the old root mount at a location under +.I new_root +from where it can subsequently be unmounted. +(The fact that it moves all processes that have a root directory +or current working directory on the old root directory to the +new root frees the old root directory of users, +allowing the old root mount to be unmounted more easily.) +.PP +One use of +.BR pivot_root () +is during system startup, when the +system mounts a temporary root filesystem (e.g., an +.BR initrd (4)), +then mounts the real root filesystem, and eventually turns the latter into +the root directory of all relevant processes and threads. +A modern use is to set up a root filesystem during +the creation of a container. +.PP +The fact that +.BR pivot_root () +modifies process root and current working directories in the +manner noted in DESCRIPTION +is necessary in order to prevent kernel threads from keeping the old +root mount busy with their root and current working directories, +even if they never access +the filesystem in any way. +.PP The rootfs (initial ramfs) cannot be .BR pivot_root ()ed. The recommended method of changing the root filesystem in this case is @@ -169,25 +212,213 @@ and exec the new .BR init (1). Helper programs for this process exist; see .BR switch_root (8). -.SH BUGS +.\" +.SS pivot_root(\(dq.\(dq, \(dq.\(dq) +.PP +.I new_root +and +.I put_old +may be the same directory. +In particular, the following sequence allows a pivot-root operation +without needing to create and remove a temporary directory: +.PP +.in +4n +.EX +chdir(new_root); +pivot_root(".", "."); +umount2(".", MNT_DETACH); +.EE +.in +.PP +This sequence succeeds because the +.BR pivot_root () +call stacks the old root mount point +on top of the new root mount point at +.IR / . +At that point, the calling process's root directory and current +working directory refer to the new root mount point +.RI ( new_root ). +During the subsequent +.BR umount () +call, resolution of +.IR """.""" +starts with +.I new_root +and then moves up the list of mounts stacked at +.IR / , +with the result that old root mount point is unmounted. +.\" +.SS Historical notes +For many years, this manual page carried the following text: +.RS +.PP +.BR pivot_root () +may or may not change the current root and the current +working directory of any processes or threads which use the old +root directory. +The caller of .BR pivot_root () -should not have to change root and current working directory of all other -processes in the system. +must ensure that processes with root or current working directory +at the old root operate correctly in either case. +An easy way to ensure this is to change their +root and current working directory to \fInew_root\fP before invoking +.BR pivot_root (). +.RE +.PP +This text, written before the system call implementation was +even finalized in the kernel, was probably intended to warn users +at that time that the implementation might change before final release. +However, the behavior stated in DESCRIPTION +has remained consistent since this system call +was first implemented and will not change now. +.SH EXAMPLE +.\" FIXME +.\" Would it be better, because simpler, to use unshare(2) +.\" rather than clone(2) in the example below? .PP -Some of the more obscure uses of +The program below demonstrates the use of .BR pivot_root () -may quickly lead to -insanity. +inside a mount namespace that is created using +.BR clone (2). +After pivoting to the root directory named in the program's +first command-line argument, the child created by +.BR clone (2) +then executes the program named in the remaining command-line arguments. +.PP +We demonstrate the program by creating a directory that will serve as +the new root filesystem and placing a copy of the (statically linked) +.BR busybox (1) +executable in that directory. +.PP +.in +4n +.EX +$ \fBmkdir /tmp/rootfs\fP +$ \fBls \-id /tmp/rootfs\fP # Show inode number of new root directory +319459 /tmp/rootfs +$ \fBcp $(which busybox) /tmp/rootfs\fP +$ \fBPS1='bbsh$ ' sudo ./pivot_root_demo /tmp/rootfs /busybox sh\fP +bbsh$ \fBPATH=/\fP +bbsh$ \fBbusybox ln busybox ln\fP +bbsh$ \fBln busybox echo\fP +bbsh$ \fBln busybox ls\fP +bbsh$ \fBls\fP +busybox echo ln ls +bbsh$ \fBls \-id /\fP # Compare with inode number above +319459 / +bbsh$ \fBecho \(aqhello world\(aq\fP +hello world +.EE +.in +.SS Program source +\& +.PP +.EX +/* pivot_root_demo.c */ + +#define _GNU_SOURCE +#include <sched.h> +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <sys/wait.h> +#include <sys/syscall.h> +#include <sys/mount.h> +#include <sys/stat.h> +#include <limits.h> + +#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \e + } while (0) + +static int +pivot_root(const char *new_root, const char *put_old) +{ + return syscall(SYS_pivot_root, new_root, put_old); +} + +#define STACK_SIZE (1024 * 1024) + +static int /* Startup function for cloned child */ +child(void *arg) +{ + char **args = arg; + char *new_root = args[0]; + const char *put_old = "/oldrootfs"; + char path[PATH_MAX]; + + /* Ensure that \(aqnew_root\(aq and its parent mount don\(aqt have + shared propagation (which would cause pivot_root() to + return an error), and prevent propagation of mount + events to the initial mount namespace */ + + if (mount(NULL, "/", NULL, MS_REC | MS_PRIVATE, NULL) == 1) + errExit("mount\-MS_PRIVATE"); + + /* Ensure that \(aqnew_root\(aq is a mount point */ + + if (mount(new_root, new_root, NULL, MS_BIND, NULL) == \-1) + errExit("mount\-MS_BIND"); + + /* Create directory to which old root will be pivoted */ + + snprintf(path, sizeof(path), "%s/%s", new_root, put_old); + if (mkdir(path, 0777) == \-1) + errExit("mkdir"); + + /* And pivot the root filesystem */ + + if (pivot_root(new_root, path) == \-1) + errExit("pivot_root"); + + /* Switch the current working directory to "/" */ + + if (chdir("/") == \-1) + errExit("chdir"); + + /* Unmount old root and remove mount point */ + + if (umount2(put_old, MNT_DETACH) == \-1) + perror("umount2"); + if (rmdir(put_old) == \-1) + perror("rmdir"); + + /* Execute the command specified in argv[1]... */ + + execv(args[1], &args[1]); + errExit("execv"); +} + +int +main(int argc, char *argv[]) +{ + /* Create a child process in a new mount namespace */ + + char *stack = malloc(STACK_SIZE); + if (stack == NULL) + errExit("malloc"); + + if (clone(child, stack + STACK_SIZE, + CLONE_NEWNS | SIGCHLD, &argv[1]) == \-1) + errExit("clone"); + + /* Parent falls through to here; wait for child */ + + if (wait(NULL) == \-1) + errExit("wait"); + + exit(EXIT_SUCCESS); +} +.EE .SH SEE ALSO .BR chdir (2), .BR chroot (2), .BR mount (2), .BR stat (2), .BR initrd (4), +.BR mount_namespaces (7), .BR pivot_root (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pkey_alloc.2 b/man2/pkey_alloc.2 index 5900ed8d3..323d93b92 100644 --- a/man2/pkey_alloc.2 +++ b/man2/pkey_alloc.2 @@ -138,7 +138,7 @@ See .BR pkey_mprotect (2), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/poll.2 b/man2/poll.2 index f8b450cd9..aebe6279e 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -473,7 +473,7 @@ BUGS section of .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/posix_fadvise.2 b/man2/posix_fadvise.2 index 22014d499..775ff241f 100644 --- a/man2/posix_fadvise.2 +++ b/man2/posix_fadvise.2 @@ -241,7 +241,7 @@ rather than as meaning "all bytes through to the end of the file". .BR posix_fallocate (3), .BR posix_madvise (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/prctl.2 b/man2/prctl.2 index a158934cb..214587adc 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -184,7 +184,7 @@ A subreaper fulfills the role of .BR init (1) for its descendant processes. When a process becomes orphaned -(i.e., its immediate parent terminates) +(i.e., its immediate parent terminates), then that process will be reparented to the nearest still living ancestor subreaper. Subsequently, calls to @@ -418,7 +418,8 @@ and are ignored. .TP .BR PR_GET_FP_MODE " (since Linux 4.0, only on MIPS)" -Get the current floating-point mode (see the description of +Return (as the function result) +the current floating-point mode (see the description of .B PR_SET_FP_MODE for details). .IP @@ -524,7 +525,8 @@ The remaining unused arguments must be zero for future compatibility. .TP .BR PR_MCE_KILL_GET " (since Linux 2.6.32)" -Return the current per-process machine check kill policy. +Return (as the function result) +the current per-process machine check kill policy. All unused .BR prctl () arguments must be zero. @@ -1062,7 +1064,8 @@ See .BR capabilities (7). .TP .BR PR_GET_SPECULATION_CTRL " (since Linux 4.17)" -Returns the state of the speculation misfeature specified in +Return (as the function result) +the state of the speculation misfeature specified in .IR arg2 . Currently, the only permitted value for this argument is .BR PR_SPEC_STORE_BYPASS @@ -1155,7 +1158,7 @@ The speculation feature can also be controlled by the .B spec_store_bypass_disable boot parameter. This parameter may enforce a read-only policy which will result in the -.BR prctl (2) +.BR prctl () call failing with the error .BR ENXIO . For further details, see the kernel source file @@ -1208,13 +1211,13 @@ in Linux 2.6.32. .\" .TP .BR PR_GET_THP_DISABLE " (since Linux 3.15)" -Return (via the function result) the current setting of the "THP disable" +Return (as the function result) the current setting of the "THP disable" flag for the calling thread: either 1, if the flag is set, or 0, if it is not. .TP .BR PR_GET_TID_ADDRESS " (since Linux 3.5)" .\" commit 300f786b2683f8bb1ec0afb6e1851183a479c86d -Retrieve the +Return the .I clear_child_tid address set by .BR set_tid_address (2) @@ -1373,14 +1376,15 @@ operation of the system call on Tru64). .TP .B PR_GET_UNALIGN -(see +(See .B PR_SET_UNALIGN -for information on versions and architectures) +for information on versions and architectures.) Return unaligned access control bits, in the location pointed to by .IR "(unsigned int\ *) arg2" . .SH RETURN VALUE On success, .BR PR_GET_DUMPABLE , +.BR PR_GET_FP_MODE , .BR PR_GET_KEEPCAPS , .BR PR_GET_NO_NEW_PRIVS , .BR PR_GET_THP_DISABLE , @@ -1388,6 +1392,7 @@ On success, .BR PR_GET_TIMING , .BR PR_GET_TIMERSLACK , .BR PR_GET_SECUREBITS , +.BR PR_GET_SPECULATION_CTRL , .BR PR_MCE_KILL_GET , .BR PR_CAP_AMBIENT + PR_CAP_AMBIENT_IS_SET , and (if it returns) @@ -1659,6 +1664,16 @@ and .IR arg3 does not specify a valid capability. .TP +.B EINVAL +.I option +was +.BR PR_GET_SPECULATION_CTRL +or +.BR PR_SET_SPECULATION_CTRL +and unused arguments to +.BR prctl () +are not 0. +.TP .B ENODEV .I option was @@ -1763,16 +1778,6 @@ is neither .BR PR_SPEC_DISABLE , nor .BR PR_SPEC_FORCE_DISABLE . -.TP -.B EINVAL -.I option -was -.BR PR_GET_SPECULATION_CTRL -or -.BR PR_SET_SPECULATION_CTRL -and unused arguments to -.BR prctl () -are not 0. .SH VERSIONS The .BR prctl () @@ -1800,7 +1805,7 @@ get or set the maximum stack size, and so on. .BR signal (2), .BR core (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pread.2 b/man2/pread.2 index 9ecb823b0..5163c064f 100644 --- a/man2/pread.2 +++ b/man2/pread.2 @@ -170,7 +170,7 @@ appends data to the end of the file, regardless of the value of .BR readv (2), .BR write (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/process_vm_readv.2 b/man2/process_vm_readv.2 index 376d85553..02cd5b7a9 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -339,7 +339,7 @@ main(void) .BR readv (2), .BR writev (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ptrace.2 b/man2/ptrace.2 index 6e5aeb004..ff0b571b7 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -102,7 +102,7 @@ .\" .\" and others that can be found in the arch/*/include/uapi/asm/ptrace files .\" -.TH PTRACE 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH PTRACE 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME ptrace \- process trace .SH SYNOPSIS @@ -1005,6 +1005,105 @@ of the .IR "struct user_desc" is ignored; in other words, this ptrace operation can't be used to allocate a free TLS entry.) +.TP +.BR PTRACE_GET_SYSCALL_INFO " (since Linux 5.3)" +.\" commit 201766a20e30f982ccfe36bebfad9602c3ff574a +Retrieve information about the system call that caused the stop. +The information is placed into the buffer pointed by the +.I data +argument, which should be a pointer to a buffer of type +.IR "struct ptrace_syscall_info" . +The +.I addr +argument contains the size of the buffer pointed to +by the +.I data +argument (i.e., +.IR "sizeof(struct ptrace_syscall_info)" ). +The return value contains the number of bytes available +to be written by the kernel. +If the size of the data to be written by the kernel exceeds the size +specified by the +.I addr +argument, the output data is truncated. +.IP +The +.I ptrace_syscall_info +structure contains the following fields: +.IP +.in +2n +.EX +struct ptrace_syscall_info { + __u8 op; /* Type of system call stop */ + __u32 arch; /* AUDIT_ARCH_* value; see seccomp(2) */ + __u64 instruction_pointer; /* CPU instruction pointer */ + __u64 stack_pointer; /* CPU stack pointer */ + union { + struct { /* op == PTRACE_SYSCALL_INFO_ENTRY */ + __u64 nr; /* System call number */ + __u64 args[6]; /* System call arguments */ + } entry; + struct { /* op == PTRACE_SYSCALL_INFO_EXIT */ + __s64 rval; /* System call return value */ + __u8 is_error; /* System call error flag; + Boolean: does rval contain + an error value (\-ERRCODE) or + a nonerror return value? */ + } exit; + struct { /* op == PTRACE_SYSCALL_INFO_SECCOMP */ + __u64 nr; /* System call number */ + __u64 args[6]; /* System call arguments */ + __u32 ret_data; /* SECCOMP_RET_DATA portion + of SECCOMP_RET_TRACE + return value */ + } seccomp; + }; +}; +.EE +.in +.IP +The +.IR op , +.IR arch , +.IR instruction_pointer , +and +.I stack_pointer +fields are defined for all kinds of ptrace system call stops. +The rest of the structure is a union; one should read only those fields +that are meaningful for the kind of system call stop specified by the +.IR op +field. +.IP +The +.I op +field has one of the following values (defined in +.IR <linux/ptrace.h>) +indicating what type of stop occurred and +which part of the union is filled: +.RS +.TP +.BR PTRACE_SYSCALL_INFO_ENTRY +The +.I entry +component of the union contains information relating to a +system call entry stop. +.TP +.BR PTRACE_SYSCALL_INFO_EXIT +The +.I exit +component of the union contains information relating to a +system call exit stop. +.TP +.BR PTRACE_SYSCALL_INFO_SECCOMP +The +.I exit +component of the union contains information relating to a +.B PTRACE_EVENT_SECCOMP +stop. +.TP +.BR PTRACE_SYSCALL_INFO_NONE +No component of the union contains relevant information. +.RE .\" .SS Death under ptrace When a (possibly multithreaded) process receives a killing signal @@ -2799,7 +2898,7 @@ to zero. .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/query_module.2 b/man2/query_module.2 index 497d0a24e..c6eca2a25 100644 --- a/man2/query_module.2 +++ b/man2/query_module.2 @@ -198,7 +198,7 @@ alternatively, you can invoke the system call using .BR lsmod (8), .BR modinfo (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/quotactl.2 b/man2/quotactl.2 index 46f34d0df..9bd920313 100644 --- a/man2/quotactl.2 +++ b/man2/quotactl.2 @@ -797,7 +797,7 @@ prefix. .BR quotacheck (8), .BR quotaon (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/read.2 b/man2/read.2 index e9c17c79b..ff36afd29 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -265,7 +265,7 @@ This problem was fixed in Linux 3.14. .BR write (2), .BR fread (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readahead.2 b/man2/readahead.2 index de47ef5a8..479e1bd51 100644 --- a/man2/readahead.2 +++ b/man2/readahead.2 @@ -111,7 +111,7 @@ been read. .BR posix_fadvise (2), .BR read (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readdir.2 b/man2/readdir.2 index 4f5e3a3a5..71af88682 100644 --- a/man2/readdir.2 +++ b/man2/readdir.2 @@ -130,7 +130,7 @@ This system call does not exist on x86-64. .BR getdents (2), .BR readdir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readlink.2 b/man2/readlink.2 index 4fea15053..7dfb780c0 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -356,7 +356,7 @@ main(int argc, char *argv[]) .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readv.2 b/man2/readv.2 index 94860ffe7..cccfa8abd 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -432,7 +432,7 @@ nwritten = writev(STDOUT_FILENO, iov, 2); .BR read (2), .BR write (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/reboot.2 b/man2/reboot.2 index 014971189..d57fa520c 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -252,7 +252,7 @@ and should not be used in programs intended to be portable. .BR halt (8), .BR shutdown (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recv.2 b/man2/recv.2 index 9130d0eab..43ced1945 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -567,7 +567,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recvmmsg.2 b/man2/recvmmsg.2 index c89942215..84050358d 100644 --- a/man2/recvmmsg.2 +++ b/man2/recvmmsg.2 @@ -292,7 +292,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/remap_file_pages.2 b/man2/remap_file_pages.2 index bc8715203..c5bfc8d45 100644 --- a/man2/remap_file_pages.2 +++ b/man2/remap_file_pages.2 @@ -189,7 +189,7 @@ to adjust which parts of the file are mapped to which addresses. .BR mremap (2), .BR msync (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/removexattr.2 b/man2/removexattr.2 index 7340e647b..b0e3eba15 100644 --- a/man2/removexattr.2 +++ b/man2/removexattr.2 @@ -118,7 +118,7 @@ These system calls are Linux-specific. .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rename.2 b/man2/rename.2 index 25174a8f3..ce75bd16c 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -568,7 +568,7 @@ for a similar problem. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/request_key.2 b/man2/request_key.2 index cc5fdbe20..b31ae2b36 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -571,7 +571,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/restart_syscall.2 b/man2/restart_syscall.2 index 0836b8345..4f35a0f17 100644 --- a/man2/restart_syscall.2 +++ b/man2/restart_syscall.2 @@ -142,7 +142,7 @@ returned in the usual fashion. .\" spent suspended is *not* deducted when the select() is restarted. .\" FIXME . check whether recvmmsg() handles stop-sig+SIGCONT properly. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 659cd8eee..aec48fda4 100644 --- a/man2/rmdir.2 +++ b/man2/rmdir.2 @@ -140,7 +140,7 @@ disappearance of directories which are still being used. .BR unlink (2), .BR unlinkat (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rt_sigqueueinfo.2 b/man2/rt_sigqueueinfo.2 index 14ecfb61f..51fb5160d 100644 --- a/man2/rt_sigqueueinfo.2 +++ b/man2/rt_sigqueueinfo.2 @@ -22,15 +22,15 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH RT_SIGQUEUEINFO 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH RT_SIGQUEUEINFO 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME rt_sigqueueinfo, rt_tgsigqueueinfo \- queue a signal and data .SH SYNOPSIS .nf -.BI "int rt_sigqueueinfo(pid_t " tgid ", int " sig ", siginfo_t *" uinfo ); +.BI "int rt_sigqueueinfo(pid_t " tgid ", int " sig ", siginfo_t *" info ); .PP .BI "int rt_tgsigqueueinfo(pid_t " tgid ", pid_t " tid ", int " sig , -.BI " siginfo_t *" uinfo ); +.BI " siginfo_t *" info ); .fi .PP .IR Note : @@ -67,7 +67,7 @@ The signal will be delivered to an arbitrary member of the thread group (i.e., one of the threads that is not currently blocking the signal). .PP The -.I uinfo +.I info argument specifies the data to accompany the signal. This argument is a pointer to a structure of type .IR siginfo_t , @@ -78,20 +78,29 @@ described in The caller should set the following fields in this structure: .TP .I si_code -This must be one of the +This should be one of the .B SI_* codes in the Linux kernel source file -.IR include/asm-generic/siginfo.h , -with the restriction that the code must be negative -(i.e., cannot be +.IR include/asm-generic/siginfo.h . +If the signal is being sent to any process other than the caller itself, +the following restrictions apply: +.RS +.IP * 3 +The code can't be a value greater than or equal to zero. +In particular, it can't be .BR SI_USER , which is used by the kernel to indicate a signal sent by -.BR kill (2)) -and cannot (since Linux 2.6.39) be -.BR SI_TKILL -(which is used by the kernel to indicate a signal sent using +.BR kill (2), +and nor can it be +.BR SI_KERNEL , +which is used to indicate a signal generated by the kernel. +.IP * +The code can't (since Linux 2.6.39) be +.BR SI_TKILL , +which is used by the kernel to indicate a signal sent using .\" tkill(2) or -.BR tgkill (2)). +.BR tgkill (2). +.RE .TP .I si_pid This should be set to a process ID, @@ -150,8 +159,11 @@ was invalid. The caller does not have permission to send the signal to the target. For the required permissions, see .BR kill (2). -Or: -.I uinfo->si_code +.TP +.B EPERM +.I tgid +specifies a process other than the caller and +.I info->si_code is invalid. .TP .B ESRCH @@ -187,6 +199,7 @@ the null signal (0) can be used to check if the specified process or thread exists. .SH SEE ALSO .BR kill (2), +.BR pidfd_send_signal (2), .BR sigaction (2), .BR sigprocmask (2), .BR tgkill (2), @@ -194,7 +207,7 @@ or thread exists. .BR sigqueue (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2 index 5fa36ab28..a1cc1872b 100644 --- a/man2/s390_guarded_storage.2 +++ b/man2/s390_guarded_storage.2 @@ -174,7 +174,7 @@ header. .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/s390_pci_mmio_write.2 b/man2/s390_pci_mmio_write.2 index 3008d0f5b..397568570 100644 --- a/man2/s390_pci_mmio_write.2 +++ b/man2/s390_pci_mmio_write.2 @@ -106,7 +106,7 @@ to call it. .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/s390_runtime_instr.2 b/man2/s390_runtime_instr.2 index 8900ca08f..436309490 100644 --- a/man2/s390_runtime_instr.2 +++ b/man2/s390_runtime_instr.2 @@ -95,7 +95,7 @@ since Linux 4.16. .BR syscall (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/s390_sthyi.2 b/man2/s390_sthyi.2 index aa6f77c85..26fd916d3 100644 --- a/man2/s390_sthyi.2 +++ b/man2/s390_sthyi.2 @@ -141,7 +141,7 @@ Subsequent system call invocations may return the cached response. .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_get_priority_max.2 b/man2/sched_get_priority_max.2 index 71f8b4f37..581973e8b 100644 --- a/man2/sched_get_priority_max.2 +++ b/man2/sched_get_priority_max.2 @@ -124,7 +124,7 @@ POSIX.1-2001, POSIX.1-2008. .BR sched_setscheduler (2), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_rr_get_interval.2 b/man2/sched_rr_get_interval.2 index 82a686b87..43ee49d16 100644 --- a/man2/sched_rr_get_interval.2 +++ b/man2/sched_rr_get_interval.2 @@ -132,7 +132,7 @@ Writing 0 to this file resets the quantum to the default value. .SH SEE ALSO .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_setaffinity.2 b/man2/sched_setaffinity.2 index de4783f4a..5695c7f3a 100644 --- a/man2/sched_setaffinity.2 +++ b/man2/sched_setaffinity.2 @@ -31,7 +31,7 @@ .\" 2008-11-12, mtk, removed CPU_*() macro descriptions to a .\" separate CPU_SET(3) page. .\" -.TH SCHED_SETAFFINITY 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETAFFINITY 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME sched_setaffinity, sched_getaffinity \- \ set and get a thread's CPU affinity mask @@ -109,7 +109,10 @@ On success, .BR sched_setaffinity () and .BR sched_getaffinity () -return 0. +return 0 (but see "C library/kernel differences" below, +which notes that the underlying +.BR sched_getaffinity () +differs in its return value). On error, \-1 is returned, and .I errno is set appropriately. @@ -435,7 +438,7 @@ main(int argc, char *argv[]) .BR sched (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_setattr.2 b/man2/sched_setattr.2 index 08b7cbb2c..4b2970068 100644 --- a/man2/sched_setattr.2 +++ b/man2/sched_setattr.2 @@ -444,7 +444,7 @@ for the case described in ERRORS. .BR sched (7) .ad .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_setparam.2 b/man2/sched_setparam.2 index 65f7a18ca..f06517277 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.2 @@ -27,7 +27,7 @@ .\" revision .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH SCHED_SETPARAM 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETPARAM 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME sched_setparam, sched_getparam \- set and get scheduling parameters .SH SYNOPSIS @@ -121,8 +121,8 @@ POSIX.1-2001, POSIX.1-2008. .SH SEE ALSO .ad l .nh -.BR gettid (2), .BR getpriority (2), +.BR gettid (2), .BR nice (2), .BR sched_get_priority_max (2), .BR sched_get_priority_min (2), @@ -135,7 +135,7 @@ POSIX.1-2001, POSIX.1-2008. .BR capabilities (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_setscheduler.2 b/man2/sched_setscheduler.2 index 7ddf5893e..796e8dad2 100644 --- a/man2/sched_setscheduler.2 +++ b/man2/sched_setscheduler.2 @@ -243,7 +243,7 @@ since it always returns 0 on success. .BR sched (7) .ad .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sched_yield.2 b/man2/sched_yield.2 index a1752ad54..b941d9abf 100644 --- a/man2/sched_yield.2 +++ b/man2/sched_yield.2 @@ -90,7 +90,7 @@ is unspecified and very likely means your application design is broken. .SH SEE ALSO .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seccomp.2 b/man2/seccomp.2 index e82041872..d4738006c 100644 --- a/man2/seccomp.2 +++ b/man2/seccomp.2 @@ -1145,7 +1145,7 @@ Proceedings of the USENIX Winter 1993 Conference .UR http://www.tcpdump.org/papers/bpf\-usenix93.pdf .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/select.2 b/man2/select.2 index fdc852d9d..f651da049 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -725,7 +725,7 @@ main(void) For a tutorial with discussion and examples, see .BR select_tut (2). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/select_tut.2 b/man2/select_tut.2 index 63b1509ff..0bd079147 100644 --- a/man2/select_tut.2 +++ b/man2/select_tut.2 @@ -836,7 +836,7 @@ connections cause the current connection to be dropped. .\" .SH AUTHORS .\" This man page was written by Paul Sheer. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semctl.2 b/man2/semctl.2 index e87a525c5..a6ec520fa 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -604,7 +604,7 @@ in Linux 4.6. .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semget.2 b/man2/semget.2 index 2fb56992e..0a26c67f8 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -320,7 +320,7 @@ would more clearly show its function. .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semop.2 b/man2/semop.2 index c07439178..5debc9956 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -554,7 +554,7 @@ if (semop(semid, sops, 2) == \-1) { .BR sysvipc (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/send.2 b/man2/send.2 index 754e0824c..6cefcf130 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -481,7 +481,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendfile.2 b/man2/sendfile.2 index 61fa901d5..b91546812 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -243,7 +243,7 @@ provided one (or both) of them is a pipe. .BR socket (2), .BR splice (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendmmsg.2 b/man2/sendmmsg.2 index cfa530644..603f6af80 100644 --- a/man2/sendmmsg.2 +++ b/man2/sendmmsg.2 @@ -248,7 +248,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/set_mempolicy.2 b/man2/set_mempolicy.2 index 6dfc6b2c4..361b1cf37 100644 --- a/man2/set_mempolicy.2 +++ b/man2/set_mempolicy.2 @@ -321,7 +321,7 @@ For information on library support, see .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/set_thread_area.2 b/man2/set_thread_area.2 index bd916892d..345043381 100644 --- a/man2/set_thread_area.2 +++ b/man2/set_thread_area.2 @@ -229,7 +229,7 @@ TLS entries. .BR ptrace (2) .RB ( PTRACE_GET_THREAD_AREA " and " PTRACE_SET_THREAD_AREA ) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/set_tid_address.2 b/man2/set_tid_address.2 index d26ac018c..42ab1445c 100644 --- a/man2/set_tid_address.2 +++ b/man2/set_tid_address.2 @@ -107,7 +107,7 @@ Glibc does not provide a wrapper for this system call; call it using .BR futex (2), .BR gettid (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 991d83c6a..a589b9dd5 100644 --- a/man2/seteuid.2 +++ b/man2/seteuid.2 @@ -151,7 +151,7 @@ and .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsgid.2 b/man2/setfsgid.2 index ebea6fa91..3643cf78a 100644 --- a/man2/setfsgid.2 +++ b/man2/setfsgid.2 @@ -125,7 +125,7 @@ capability). .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsuid.2 b/man2/setfsuid.2 index b8a609d52..8770b1d55 100644 --- a/man2/setfsuid.2 +++ b/man2/setfsuid.2 @@ -143,7 +143,7 @@ capability). .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setgid.2 b/man2/setgid.2 index 6b14a0c44..ac8949cce 100644 --- a/man2/setgid.2 +++ b/man2/setgid.2 @@ -106,7 +106,7 @@ For details, see .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setns.2 b/man2/setns.2 index a6747d362..5ff2c091e 100644 --- a/man2/setns.2 +++ b/man2/setns.2 @@ -5,7 +5,7 @@ .\" Licensed under the GPLv2 .\" %%%LICENSE_END .\" -.TH SETNS 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SETNS 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME setns \- reassociate thread with a namespace .SH SYNOPSIS @@ -131,8 +131,12 @@ capabilities in its own user namespace and .BR CAP_SYS_ADMIN in the user namespace that owns the target mount namespace. .IP -A process may not be reassociated with a new mount namespace if it is -multithreaded. +A process can't join a new mount namespace if it is sharing +filesystem-related attributes +(the attributes whose sharing is controlled by the +.BR clone (2) +.B CLONE_FS +flag) with another process. .\" Above check is in fs/namespace.c:mntns_install() [3.8 source] .IP See @@ -341,7 +345,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 138b2bfd8..46e6c46b0 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -338,7 +338,7 @@ in a different session (see also .BR termios (3), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 8ff5022e4..228d40381 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -166,7 +166,7 @@ For details, see .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setreuid.2 b/man2/setreuid.2 index b64156a7a..709fd23fe 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -222,7 +222,7 @@ For details, see .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setsid.2 b/man2/setsid.2 index 369f8e75d..cbf3293f5 100644 --- a/man2/setsid.2 +++ b/man2/setsid.2 @@ -116,7 +116,7 @@ process group of the controlling terminal. .BR credentials (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setuid.2 b/man2/setuid.2 index 504771acf..ef95806b2 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -169,7 +169,7 @@ For details, see .BR credentials (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setup.2 b/man2/setup.2 index be8cb7617..c66d6d5d7 100644 --- a/man2/setup.2 +++ b/man2/setup.2 @@ -70,7 +70,7 @@ has had a single argument and at other times a single argument .IR "int magic" . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setxattr.2 b/man2/setxattr.2 index a7acdfefc..ba80101eb 100644 --- a/man2/setxattr.2 +++ b/man2/setxattr.2 @@ -178,7 +178,7 @@ These system calls are Linux-specific. .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sgetmask.2 b/man2/sgetmask.2 index 61bb0b467..7921b2dec 100644 --- a/man2/sgetmask.2 +++ b/man2/sgetmask.2 @@ -90,7 +90,7 @@ or .BR sigprocmask (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 023e53954..db7f420e1 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -449,7 +449,7 @@ flag in .BR capabilities (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmget.2 b/man2/shmget.2 index 0af9da347..6eb2fd050 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -421,7 +421,7 @@ would more clearly show its function. .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmop.2 b/man2/shmop.2 index 2c29153d6..861f1a552 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -301,7 +301,7 @@ number of shared memory segments .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shutdown.2 b/man2/shutdown.2 index 42d256e74..091987b13 100644 --- a/man2/shutdown.2 +++ b/man2/shutdown.2 @@ -119,7 +119,7 @@ in Linux 3.7. .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaction.2 b/man2/sigaction.2 index 66d3ab9cb..65253807e 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -46,7 +46,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH SIGACTION 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SIGACTION 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH SYNOPSIS @@ -1035,6 +1035,7 @@ See .BR kill (1), .BR kill (2), .BR pause (2), +.BR pidfd_send_signal (2) .BR restart_syscall (2), .BR seccomp (2) .BR sigaltstack (2), @@ -1054,7 +1055,7 @@ See .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index 626d442a4..c755b913c 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -368,7 +368,7 @@ is specified in .BR sigsetjmp (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signal.2 b/man2/signal.2 index cb2e567fd..7433b206d 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -287,7 +287,7 @@ provides System\ V semantics. .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signalfd.2 b/man2/signalfd.2 index ea132d9f7..be4177a29 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -17,7 +17,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH SIGNALFD 2 2019-03-06 Linux "Linux Programmer's Manual" +.TH SIGNALFD 2 2019-10-10 Linux "Linux Programmer's Manual" .SH NAME signalfd \- create a file descriptor for accepting signals .SH SYNOPSIS @@ -261,6 +261,33 @@ itself and the signals that are directed to the process (i.e., the entire thread group). (A thread will not be able to read signals that are directed to other threads in the process.) +.\" +.SS epoll(7) semantics +If a process adds (via +.BR epoll_ctl (2)) +a signalfd file descriptor to an +.BR epoll (7) +instance, then +.BR epoll_wait (2) +returns events only for signals sent to that process. +In particular, if the process then uses +.BR fork () +to create a child process, then the child will be able to +.BR read (2) +signals that are sent to it using the signalfd file descriptor, but +.BR epoll_wait (2) +will +.B not +indicate that the signalfd file descriptor is ready. +In this scenario, a possible workaround is that after the +.BR fork (2), +the child process can close the signalfd file descriptor that it inherited +from the parent process and then create another signalfd file descriptor +and add it to the epoll instance. +Alternatively, the parent and the child could delay creating their +(separate) signalfd file descriptors and adding them to the +epoll instance until after the call to +.BR fork (2). .SH RETURN VALUE On success, .BR signalfd () @@ -381,7 +408,7 @@ handler that writes to a file descriptor monitored by .BR select (2), .BR poll (2), or -.BR epoll (7), +.BR epoll (7). .\" .SS C library/kernel differences The underlying Linux system call requires an additional argument, @@ -504,7 +531,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigpending.2 b/man2/sigpending.2 index 132d11a86..d2d6ffcd7 100644 --- a/man2/sigpending.2 +++ b/man2/sigpending.2 @@ -125,7 +125,7 @@ is not correctly returned. .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2 index 833b7fac8..206e9b380 100644 --- a/man2/sigprocmask.2 +++ b/man2/sigprocmask.2 @@ -231,7 +231,7 @@ when the kernel provides it. .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 index 4508ec0fa..e91b8a800 100644 --- a/man2/sigreturn.2 +++ b/man2/sigreturn.2 @@ -163,7 +163,7 @@ when the kernel provides it. .BR signal (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2 index 8fa82218d..589681ba9 100644 --- a/man2/sigsuspend.2 +++ b/man2/sigsuspend.2 @@ -145,7 +145,7 @@ when the kernel provides it. .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2 index bcbb2c76e..40ea91415 100644 --- a/man2/sigwaitinfo.2 +++ b/man2/sigwaitinfo.2 @@ -248,7 +248,7 @@ when the kernel provides it. .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socket.2 b/man2/socket.2 index ec2e60262..a1f9edd56 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -151,7 +151,7 @@ T} T{ .B AF_PPPOX T}:T{ -Generic PPP transport layer, for setting up up L2 tunnels +Generic PPP transport layer, for setting up L2 tunnels (L2TP and PPPoE) T} T{ @@ -522,7 +522,7 @@ and reprinted in .I UNIX Programmer's Supplementary Documents Volume 1. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketcall.2 b/man2/socketcall.2 index a52231e9f..a4f851d11 100644 --- a/man2/socketcall.2 +++ b/man2/socketcall.2 @@ -190,7 +190,7 @@ and also provides a (very) small performance improvement. .BR socket (2), .BR socketpair (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketpair.2 b/man2/socketpair.2 index 52008e388..013c2bea7 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -143,7 +143,7 @@ file, and portable applications are probably wise to include it. .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/splice.2 b/man2/splice.2 index bd90e5799..7e4b6ced7 100644 --- a/man2/splice.2 +++ b/man2/splice.2 @@ -271,7 +271,7 @@ See .BR vmsplice (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/spu_create.2 b/man2/spu_create.2 index 4f6c0234e..fd21cb6b7 100644 --- a/man2/spu_create.2 +++ b/man2/spu_create.2 @@ -273,7 +273,7 @@ for an example of the use of .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/spu_run.2 b/man2/spu_run.2 index 767c14eb0..ffafd6560 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -267,7 +267,7 @@ int main(void) .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stat.2 b/man2/stat.2 index 181dd9a98..267661484 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -716,7 +716,7 @@ main(int argc, char *argv[]) .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statfs.2 b/man2/statfs.2 index 1cfc378ab..f8957762c 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -390,7 +390,7 @@ for file descriptors created by .BR statvfs (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statx.2 b/man2/statx.2 index d8bc07e9f..555511666 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -28,7 +28,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH STATX 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH STATX 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME statx \- get file status (extended) .SH SYNOPSIS @@ -265,11 +265,14 @@ STATX_ALL [All currently available fields] .TE .in .PP -Note that the kernel does +Note that, in general, the kernel does .I not reject values in .I mask other than the above. +(For an exception, see +.B EINVAL +in errors.) Instead, it simply informs the caller which values are supported by this kernel and filesystem via the .I statx.stx_mask @@ -490,6 +493,9 @@ Invalid flag specified in .B EINVAL Reserved flag specified in .IR mask . +(Currently, there is one such flag, designated by the constant +.BR STATX__RESERVED , +with the value 0x80000000U.) .TP .B ELOOP Too many symbolic links encountered while traversing the pathname. @@ -538,7 +544,7 @@ is Linux-specific. .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stime.2 b/man2/stime.2 index 266a49ff0..98ceb13f3 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -75,7 +75,7 @@ SVr4. .BR settimeofday (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/subpage_prot.2 b/man2/subpage_prot.2 index 8584c64f0..df1f6db87 100644 --- a/man2/subpage_prot.2 +++ b/man2/subpage_prot.2 @@ -132,7 +132,7 @@ hardware pages (on machines with hardware 64-kB page support). .IR Documentation/admin-guide/mm/hugetlbpage.rst in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/swapon.2 b/man2/swapon.2 index 1a12b5355..ee5c10b07 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -207,7 +207,7 @@ is called, even if that flag bit is not set. .BR swapoff (8), .BR swapon (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/symlink.2 b/man2/symlink.2 index 738d8cf24..1a13c80eb 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -273,7 +273,7 @@ argument. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sync.2 b/man2/sync.2 index 3f953e65a..a619afc42 100644 --- a/man2/sync.2 +++ b/man2/sync.2 @@ -129,7 +129,7 @@ before returning. .BR fdatasync (2), .BR fsync (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sync_file_range.2 b/man2/sync_file_range.2 index 0b79e29f4..caf8589b4 100644 --- a/man2/sync_file_range.2 +++ b/man2/sync_file_range.2 @@ -222,7 +222,7 @@ under the name .BR msync (2), .BR sync (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscall.2 b/man2/syscall.2 index 4db1cc5be..b6eb38c31 100644 --- a/man2/syscall.2 +++ b/man2/syscall.2 @@ -39,7 +39,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added mips and arm64. .\" -.TH SYSCALL 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH SYSCALL 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME syscall \- indirect system call .SH SYNOPSIS @@ -196,7 +196,8 @@ mips syscall v0 v0 v1 a3 1, 6 nios2 trap r2 r2 - r7 parisc ble 0x100(%sr2, %r0) r20 r28 - - powerpc sc r0 r3 - r0 1 -riscv scall a7 a0 a1 - +powerpc64 sc r0 r3 - cr0.SO 1 +riscv ecall a7 a0 a1 - s390 svc 0 r1 r2 r3 - 3 s390x svc 0 r1 r2 r3 - 3 superh trap #0x17 r3 r0 r1 - 4, 6 @@ -220,6 +221,11 @@ On sparc, the carry bit in the processor status register .RI ( psr ) is used instead of a full register. +On powerpc64, the summary overflow bit +.RI ( SO ) +in field 0 of the condition register +.RI ( cr0 ) +is used. .IP [2] .I NR is the system call number. @@ -322,6 +328,7 @@ mips/n32,64 a0 a1 a2 a3 a4 a5 - nios2 r4 r5 r6 r7 r8 r9 - parisc r26 r25 r24 r23 r22 r21 - powerpc r3 r4 r5 r6 r7 r8 r9 +powerpc64 r3 r4 r5 r6 r7 r8 - riscv a0 a1 a2 a3 a4 a5 - s390 r2 r3 r4 r5 r6 r7 - s390x r2 r3 r4 r5 r6 r7 - @@ -369,7 +376,7 @@ main(int argc, char *argv[]) .BR errno (3), .BR vdso (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscalls.2 b/man2/syscalls.2 index f4de1f103..2a9e8bbdd 100644 --- a/man2/syscalls.2 +++ b/man2/syscalls.2 @@ -28,7 +28,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SYSCALLS 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SYSCALLS 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME syscalls \- Linux system calls .SH SYNOPSIS @@ -217,6 +217,7 @@ T} \fBclock_settime\fP(2) 2.6 \fBclone2\fP(2) 2.4 IA-64 only \fBclone\fP(2) 1.0 +\fBclone3\fP(2) 5.3 \fBclose\fP(2) 1.0 .\" .\" dcef1f634657dabe7905af3ccda12cf7f0b6fcc1 .\" .\" cc20d42986d5807cbe4f5c7c8e3dab2e59ea0db3 @@ -293,7 +294,11 @@ T} \fBfork\fP(2) 1.0 \fBfree_hugepages\fP(2) 2.5.36 Removed in 2.5.44 \fBfremovexattr\fP(2) 2.6; 2.4.18 +\fBfsconfig\fP(2) 5.2 \fBfsetxattr\fP(2) 2.6; 2.4.18 +\fBfsmount\fP(2) 5.2 +\fBfsopen\fP(2) 5.2 +\fBfspick\fP(2) 5.2 \fBfstat\fP(2) 1.0 \fBfstat64\fP(2) 2.4 \fBfstatat64\fP(2) 2.6.16 @@ -385,6 +390,9 @@ T} \fBio_pgetevents\fP(2) 4.18 \fBio_setup\fP(2) 2.6 \fBio_submit\fP(2) 2.6 +\fBio_uring_enter\fP(2) 5.1 +\fBio_uring_register\fP(2) 5.1 +\fBio_uring_setup\fP(2) 5.1 \fBioctl\fP(2) 1.0 \fBioperm\fP(2) 1.0 \fBiopl\fP(2) 1.0 @@ -460,6 +468,7 @@ T} \fBmmap2\fP(2) 2.4 \fBmodify_ldt\fP(2) 1.0 \fBmount\fP(2) 1.0 +\fBmove_mount\fP(2) 5.2 \fBmove_pages\fP(2) 2.6.18 \fBmprotect\fP(2) 1.0 \fBmq_getsetattr\fP(2) 2.6.6 @@ -506,6 +515,7 @@ T} \fBolduname\fP(2) 1.0 \fBopen\fP(2) 1.0 \fBopen_by_handle_at\fP(2) 2.6.39 +\fBopen_tree\fP(2) 5.2 \fBopenat\fP(2) 2.6.16 .\" 9d02a4283e9ce4e9ca11ff00615bdacdb0515a1a \fBor1k_atomic\fP(2) 3.1 OpenRISC 1000 only @@ -525,6 +535,8 @@ T} \fBperfctr\fP(2) 2.2 SPARC only; removed in 2.6.34 .\" commit c7d5a0050773e98d1094eaa9f2a1a793fafac300 removed perfctr() \fBperfmonctl\fP(2) 2.4 IA-64 only +\fBpidfd_send_signal\fP(2) 5.1 +\fBpidfd_open\fP(2) 5.3 \fBpipe\fP(2) 1.0 \fBpipe2\fP(2) 2.6.27 \fBpivot_root\fP(2) 2.4 @@ -1094,7 +1106,7 @@ low-cost Alphas in order to access address space beyond first 27 bits. .BR libc (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysctl.2 b/man2/sysctl.2 index d26456bc9..609bdfb26 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -180,7 +180,7 @@ main(void) .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysfs.2 b/man2/sysfs.2 index 7ff8cadac..d71cc7e77 100644 --- a/man2/sysfs.2 +++ b/man2/sysfs.2 @@ -111,7 +111,7 @@ use that interface instead. There is no libc or glibc support. There is no way to guess how large \fIbuf\fP should be. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index f038a3f3f..d1e6d8f8e 100644 --- a/man2/sysinfo.2 +++ b/man2/sysinfo.2 @@ -122,7 +122,7 @@ and .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syslog.2 b/man2/syslog.2 index f27319a32..37b20d15f 100644 --- a/man2/syslog.2 +++ b/man2/syslog.2 @@ -388,7 +388,7 @@ different animals. .BR syslog (3), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tee.2 b/man2/tee.2 index 47f3a5fee..500a93dfb 100644 --- a/man2/tee.2 +++ b/man2/tee.2 @@ -216,7 +216,7 @@ main(int argc, char *argv[]) .BR vmsplice (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/time.2 b/man2/time.2 index 841ff0145..703b4a9cf 100644 --- a/man2/time.2 +++ b/man2/time.2 @@ -130,7 +130,7 @@ is provided in the .BR time (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/timer_create.2 b/man2/timer_create.2 index 3daef7ec7..8185bdb9b 100644 --- a/man2/timer_create.2 +++ b/man2/timer_create.2 @@ -478,7 +478,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/timer_delete.2 b/man2/timer_delete.2 index 46af9c47e..c416fab80 100644 --- a/man2/timer_delete.2 +++ b/man2/timer_delete.2 @@ -73,7 +73,7 @@ POSIX.1-2001, POSIX.1-2008. .BR timer_settime (2), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/timer_getoverrun.2 b/man2/timer_getoverrun.2 index 4a5d2800e..de48668cb 100644 --- a/man2/timer_getoverrun.2 +++ b/man2/timer_getoverrun.2 @@ -139,7 +139,7 @@ See .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/timer_settime.2 b/man2/timer_settime.2 index c78967d56..106177152 100644 --- a/man2/timer_settime.2 +++ b/man2/timer_settime.2 @@ -214,7 +214,7 @@ See .BR timer_getoverrun (2), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 index 47f391cbf..1a4277c40 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -648,7 +648,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/times.2 b/man2/times.2 index 765c1be3c..08417c707 100644 --- a/man2/times.2 +++ b/man2/times.2 @@ -216,7 +216,7 @@ the maximum value that can be stored in .BR sysconf (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tkill.2 b/man2/tkill.2 index 2183f55fd..d0eaccf9d 100644 --- a/man2/tkill.2 +++ b/man2/tkill.2 @@ -95,17 +95,6 @@ On error, \-1 is returned, and \fIerrno\fP is set appropriately. .SH ERRORS .TP -.B EINVAL -An invalid thread ID, thread group ID, or signal was specified. -.TP -.B EPERM -Permission denied. -For the required permissions, see -.BR kill (2). -.TP -.B ESRCH -No process with the specified thread ID (and thread group ID) exists. -.TP .B EAGAIN The .B RLIMIT_SIGPENDING @@ -117,6 +106,17 @@ is a real-time signal. Insufficient kernel memory was available and .I sig is a real-time signal. +.TP +.B EINVAL +An invalid thread ID, thread group ID, or signal was specified. +.TP +.B EPERM +Permission denied. +For the required permissions, see +.BR kill (2). +.TP +.B ESRCH +No process with the specified thread ID (and thread group ID) exists. .SH VERSIONS .BR tkill () is supported since Linux 2.4.19 / 2.5.4. @@ -151,7 +151,7 @@ Before glibc 2.30, there was also no wrapper function for .BR kill (2), .BR rt_sigqueueinfo (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/truncate.2 b/man2/truncate.2 index 0190d6c94..53c6a0919 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -277,7 +277,7 @@ This has been fixed in later glibc versions. .BR stat (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umask.2 b/man2/umask.2 index ae67bd292..573e7b5af 100644 --- a/man2/umask.2 +++ b/man2/umask.2 @@ -159,7 +159,7 @@ to System\ V IPC objects created by the process (using .BR stat (2), .BR acl (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umount.2 b/man2/umount.2 index 324884c69..d29777ffb 100644 --- a/man2/umount.2 +++ b/man2/umount.2 @@ -227,7 +227,7 @@ in more than one place, so specifying the device does not suffice). .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uname.2 b/man2/uname.2 index 744414237..5a03bdbfb 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -24,7 +24,7 @@ .\" .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH UNAME 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH UNAME 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME uname \- get name and information about current kernel .SH SYNOPSIS @@ -168,9 +168,9 @@ invoking the most recent version of the system call provided by the kernel. .BR uname (1), .BR getdomainname (2), .BR gethostname (2), -.BR namespaces (7) +.BR uts_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unimplemented.2 b/man2/unimplemented.2 index 4927ef5b9..3a38c36ac 100644 --- a/man2/unimplemented.2 +++ b/man2/unimplemented.2 @@ -64,7 +64,7 @@ exist only when the Linux kernel was built with support for them. .SH SEE ALSO .BR syscalls (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unlink.2 b/man2/unlink.2 index b6f4579ae..a4584d40a 100644 --- a/man2/unlink.2 +++ b/man2/unlink.2 @@ -316,7 +316,7 @@ disappearance of files which are still being used. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unshare.2 b/man2/unshare.2 index 70e2ae1c6..ad322e4fe 100644 --- a/man2/unshare.2 +++ b/man2/unshare.2 @@ -547,7 +547,7 @@ in the Linux kernel source tree .I Documentation/unshare.txt before Linux 4.12) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uselib.2 b/man2/uselib.2 index 02fe3d768..1527da733 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -128,7 +128,7 @@ option. .BR capabilities (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 2f23fa127..4601da91c 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -760,7 +760,7 @@ main(int argc, char *argv[]) in the Linux kernel source tree .PP .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ustat.2 b/man2/ustat.2 index b80e5c442..1ac9d26d1 100644 --- a/man2/ustat.2 +++ b/man2/ustat.2 @@ -119,7 +119,7 @@ Such filesystems will return the current number of free inodes. .BR stat (2), .BR statfs (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utime.2 b/man2/utime.2 index 519cc797f..f1718a9b5 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -191,7 +191,7 @@ on an append-only file. .BR futimes (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utimensat.2 b/man2/utimensat.2 index 01a185534..76d9bae09 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -645,7 +645,7 @@ instead checks whether the .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vfork.2 b/man2/vfork.2 index 38058e23d..43d09f4dd 100644 --- a/man2/vfork.2 +++ b/man2/vfork.2 @@ -336,7 +336,7 @@ are allowed and input attempts result in an end-of-file indication." .BR unshare (2), .BR wait (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vhangup.2 b/man2/vhangup.2 index a3e8097d6..64ac8348f 100644 --- a/man2/vhangup.2 +++ b/man2/vhangup.2 @@ -75,7 +75,7 @@ intended to be portable. .BR init (1), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vm86.2 b/man2/vm86.2 index 8c0cd51ae..b0ce11432 100644 --- a/man2/vm86.2 +++ b/man2/vm86.2 @@ -74,7 +74,7 @@ stack should exist only within vm86 mode itself.) This call is specific to Linux on 32-bit Intel processors, and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vmsplice.2 b/man2/vmsplice.2 index a489724e1..c81610d47 100644 --- a/man2/vmsplice.2 +++ b/man2/vmsplice.2 @@ -190,7 +190,7 @@ with room for future improvement in performance. .BR tee (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait.2 b/man2/wait.2 index fdfe1c6b4..fcefe5164 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -701,7 +701,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait4.2 b/man2/wait4.2 index f2454a16c..c5d2e47e3 100644 --- a/man2/wait4.2 +++ b/man2/wait4.2 @@ -180,7 +180,7 @@ system call. .BR wait (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man2/write.2 b/man2/write.2 index 557d1ead6..96e9af43b 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -36,7 +36,7 @@ .\" gave some examples of why this might occur. .\" Noted what happens if write() is interrupted by a signal. .\" -.TH WRITE 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH WRITE 2 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME write \- write to a file descriptor .SH SYNOPSIS @@ -195,20 +195,20 @@ or the file offset is not suitably aligned. .B EIO A low-level I/O error occurred while modifying the inode. This error may relate to the write-back of data written by an earlier -.BR write (2), +.BR write (), which may have been issued to a different file descriptor on the same file. Since Linux 4.13, errors from write-back come with a promise that they .I may be reported by subsequent. -.BR write (2) +.BR write () requests, and .I will be reported by a subsequent .BR fsync (2) (whether or not they were also reported by -.BR write (2)). +.BR write ()). .\" commit 088737f44bbf6378745f5b57b035e57ee3dc4750 An alternate cause of .B EIO @@ -264,7 +264,7 @@ On some filesystems, including NFS, it does not even guarantee that space has successfully been reserved for the data. In this case, some errors might be delayed until a future -.BR write (2), +.BR write (), .BR fsync (2), or even .BR close (2). @@ -347,7 +347,7 @@ This problem was fixed in Linux 3.14. .BR writev (2), .BR fwrite (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/CPU_SET.3 b/man3/CPU_SET.3 index 501b4320e..f6fb1f5ba 100644 --- a/man3/CPU_SET.3 +++ b/man3/CPU_SET.3 @@ -362,7 +362,7 @@ main(int argc, char *argv[]) .BR pthread_setaffinity_np (3), .BR cpuset (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/INFINITY.3 b/man3/INFINITY.3 index edffd519f..b7a8da479 100644 --- a/man3/INFINITY.3 +++ b/man3/INFINITY.3 @@ -99,7 +99,7 @@ and has a value not less than 199901L. .BR fpclassify (3), .BR math_error (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/MB_CUR_MAX.3 b/man3/MB_CUR_MAX.3 index 32c3d767c..9f99ce367 100644 --- a/man3/MB_CUR_MAX.3 +++ b/man3/MB_CUR_MAX.3 @@ -42,7 +42,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/MB_LEN_MAX.3 b/man3/MB_LEN_MAX.3 index 8754e2c54..d87065f04 100644 --- a/man3/MB_LEN_MAX.3 +++ b/man3/MB_LEN_MAX.3 @@ -50,7 +50,7 @@ is 4. .SH SEE ALSO .BR MB_CUR_MAX (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__ppc_get_timebase.3 b/man3/__ppc_get_timebase.3 index 978289370..850658437 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -111,7 +111,7 @@ main(void) .BR time (2), .BR usleep (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__ppc_set_ppr_med.3 b/man3/__ppc_set_ppr_med.3 index c8653bd16..ec7e70159 100644 --- a/man3/__ppc_set_ppr_med.3 +++ b/man3/__ppc_set_ppr_med.3 @@ -132,7 +132,7 @@ Availability of these functions can be tested using .PP .IR "Power ISA, Book\ II - Section\ 3.1 (Program Priority Registers)" .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__ppc_yield.3 b/man3/__ppc_yield.3 index 16e22e44f..02e55b4f4 100644 --- a/man3/__ppc_yield.3 +++ b/man3/__ppc_yield.3 @@ -83,7 +83,7 @@ These functions are nonstandard GNU extensions. .PP .IR "Power ISA, Book\ II - Section\ 3.2 (""or"" architecture)" .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index a347fa86f..4d3d694d1 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -63,7 +63,7 @@ Set FPU control word on the i386 architecture to .PP .I <fpu_control.h> .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/a64l.3 b/man3/a64l.3 index c033d70d3..c24fb19de 100644 --- a/man3/a64l.3 +++ b/man3/a64l.3 @@ -104,7 +104,7 @@ This is not the encoding used by .\" .BR itoa (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abort.3 b/man3/abort.3 index baf07b0e4..55ff523a8 100644 --- a/man3/abort.3 +++ b/man3/abort.3 @@ -104,7 +104,7 @@ SVr4, POSIX.1-2001, POSIX.1-2008, 4.3BSD, C89, C99. .BR longjmp (3), .BR raise (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abs.3 b/man3/abs.3 index edec3cc20..360be42d9 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -139,7 +139,7 @@ as built-in functions. .BR floor (3), .BR rint (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acos.3 b/man3/acos.3 index fe8a0f66a..7aa5404f8 100644 --- a/man3/acos.3 +++ b/man3/acos.3 @@ -136,7 +136,7 @@ SVr4, 4.3BSD, C89. .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acosh.3 b/man3/acosh.3 index c96177774..1729ab102 100644 --- a/man3/acosh.3 +++ b/man3/acosh.3 @@ -139,7 +139,7 @@ SVr4, 4.3BSD. .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/addseverity.3 b/man3/addseverity.3 index a8de331f3..dd9a7972d 100644 --- a/man3/addseverity.3 +++ b/man3/addseverity.3 @@ -85,7 +85,7 @@ New severity classes can also be added by setting the environment variable .SH SEE ALSO .BR fmtmsg (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/adjtime.3 b/man3/adjtime.3 index eea198b8b..8b6bdc917 100644 --- a/man3/adjtime.3 +++ b/man3/adjtime.3 @@ -161,7 +161,7 @@ Linux kernel 2.6.26 or later. .BR gettimeofday (2), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_cancel.3 b/man3/aio_cancel.3 index e1e67fce4..66647a079 100644 --- a/man3/aio_cancel.3 +++ b/man3/aio_cancel.3 @@ -138,7 +138,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_error.3 b/man3/aio_error.3 index 24fd87fde..263e7e84d 100644 --- a/man3/aio_error.3 +++ b/man3/aio_error.3 @@ -106,7 +106,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_fsync.3 b/man3/aio_fsync.3 index 2fc164ec6..8cbb2b248 100644 --- a/man3/aio_fsync.3 +++ b/man3/aio_fsync.3 @@ -125,7 +125,7 @@ POSIX.1-2001, POSIX.1-2008. .BR aio (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_init.3 b/man3/aio_init.3 index 320559024..a4d5eea89 100644 --- a/man3/aio_init.3 +++ b/man3/aio_init.3 @@ -99,7 +99,7 @@ This function is a GNU extension. .SH SEE ALSO .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_read.3 b/man3/aio_read.3 index febcfb693..894068e07 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -168,7 +168,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_return.3 b/man3/aio_return.3 index 8903757c6..fa831249d 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -102,7 +102,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_suspend.3 b/man3/aio_suspend.3 index bddcdc150..733a9d71e 100644 --- a/man3/aio_suspend.3 +++ b/man3/aio_suspend.3 @@ -154,7 +154,7 @@ in violation of the requirements of POSIX.1. .BR aio (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/aio_write.3 b/man3/aio_write.3 index f77b09282..4af3a2a9f 100644 --- a/man3/aio_write.3 +++ b/man3/aio_write.3 @@ -170,7 +170,7 @@ structure produce undefined results. .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/alloca.3 b/man3/alloca.3 index c20603207..61d39600a 100644 --- a/man3/alloca.3 +++ b/man3/alloca.3 @@ -176,7 +176,7 @@ function arguments. .BR longjmp (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/argz_add.3 b/man3/argz_add.3 index 89afdf4a7..241823f7e 100644 --- a/man3/argz_add.3 +++ b/man3/argz_add.3 @@ -233,7 +233,7 @@ Segmentation Faults. .SH SEE ALSO .BR envz_add (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asin.3 b/man3/asin.3 index bbda29760..3526948bb 100644 --- a/man3/asin.3 +++ b/man3/asin.3 @@ -132,7 +132,7 @@ SVr4, 4.3BSD, C89. .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asinh.3 b/man3/asinh.3 index 78be89356..edd4d824c 100644 --- a/man3/asinh.3 +++ b/man3/asinh.3 @@ -124,7 +124,7 @@ SVr4, 4.3BSD. .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asprintf.3 b/man3/asprintf.3 index 7faf8f0f4..819854d38 100644 --- a/man3/asprintf.3 +++ b/man3/asprintf.3 @@ -83,7 +83,7 @@ to NULL on error. .BR malloc (3), .BR printf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/assert.3 b/man3/assert.3 index 1074fb375..3a5040e3d 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -103,7 +103,7 @@ is turned on. .BR assert_perror (3), .BR exit (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/assert_perror.3 b/man3/assert_perror.3 index 4fd9b1a10..7754b0700 100644 --- a/man3/assert_perror.3 +++ b/man3/assert_perror.3 @@ -87,7 +87,7 @@ Never use this macro. .BR exit (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan.3 b/man3/atan.3 index 5db24b57b..8488c6424 100644 --- a/man3/atan.3 +++ b/man3/atan.3 @@ -118,7 +118,7 @@ SVr4, 4.3BSD, C89. .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan2.3 b/man3/atan2.3 index 1f026175e..6a7145cd1 100644 --- a/man3/atan2.3 +++ b/man3/atan2.3 @@ -189,7 +189,7 @@ SVr4, 4.3BSD, C89. .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atanh.3 b/man3/atanh.3 index c9b7105ea..243c78451 100644 --- a/man3/atanh.3 +++ b/man3/atanh.3 @@ -169,7 +169,7 @@ Since version 2.10, glibc does the right thing. .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atexit.3 b/man3/atexit.3 index 9f188e761..97dd9245e 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -179,7 +179,7 @@ main(void) .BR exit (3), .BR on_exit (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atof.3 b/man3/atof.3 index ab0bd2fb3..deb75ac2f 100644 --- a/man3/atof.3 +++ b/man3/atof.3 @@ -78,7 +78,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atoi.3 b/man3/atoi.3 index f10474b05..90e525c92 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -121,7 +121,7 @@ is not provided by glibc. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 8110bc159..ecad0d263 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -289,7 +289,7 @@ main(int argc, char *argv[]) .BR dlopen (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/basename.3 b/man3/basename.3 index 36fa88443..64fd71578 100644 --- a/man3/basename.3 +++ b/man3/basename.3 @@ -199,7 +199,7 @@ printf("dirname=%s, basename=%s\en", dname, bname); .BR basename (1), .BR dirname (1) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcmp.3 b/man3/bcmp.3 index aa85dc307..485de2d15 100644 --- a/man3/bcmp.3 +++ b/man3/bcmp.3 @@ -86,7 +86,7 @@ POSIX.1-2008 removes the specification of .BR strncasecmp (3), .BR strncmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcopy.3 b/man3/bcopy.3 index e05199bde..e390a2f92 100644 --- a/man3/bcopy.3 +++ b/man3/bcopy.3 @@ -85,7 +85,7 @@ POSIX.1-2008 removes the specification of .BR strcpy (3), .BR strncpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bindresvport.3 b/man3/bindresvport.3 index d30b5d623..cae1e0fd7 100644 --- a/man3/bindresvport.3 +++ b/man3/bindresvport.3 @@ -128,7 +128,7 @@ the glibc implementation ignores any value that the caller supplies in .BR bind (2), .BR getsockname (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bsd_signal.3 b/man3/bsd_signal.3 index 005229388..ec50e2c25 100644 --- a/man3/bsd_signal.3 +++ b/man3/bsd_signal.3 @@ -125,7 +125,7 @@ feature test macro is defined. .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bsearch.3 b/man3/bsearch.3 index 9b77aa137..5ef7364e1 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -145,7 +145,7 @@ main(int argc, char **argv) .BR qsort (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bstring.3 b/man3/bstring.3 index 24cc66567..69f486fd4 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -92,7 +92,7 @@ instead. .BR memmove (3), .BR memset (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bswap.3 b/man3/bswap.3 index 863e25bd8..5bd52d15d 100644 --- a/man3/bswap.3 +++ b/man3/bswap.3 @@ -82,7 +82,7 @@ main(int argc, char *argv[]) .BR byteorder (3), .BR endian (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btowc.3 b/man3/btowc.3 index d19017fbc..02a481fc6 100644 --- a/man3/btowc.3 +++ b/man3/btowc.3 @@ -82,7 +82,7 @@ instead. .BR mbtowc (3), .BR wctob (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btree.3 b/man3/btree.3 index 02cf0a971..037dbc31e 100644 --- a/man3/btree.3 +++ b/man3/btree.3 @@ -253,7 +253,7 @@ Bayer and Unterauer, ACM Transactions on Database Systems, Vol. 2, 1 .IR "The Art of Computer Programming Vol. 3: Sorting and Searching" , D.E. Knuth, 1968, pp 471-480. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/byteorder.3 b/man3/byteorder.3 index 3b9cb21e0..43af86631 100644 --- a/man3/byteorder.3 +++ b/man3/byteorder.3 @@ -101,7 +101,7 @@ instead of .BR gethostbyname (3), .BR getservent (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bzero.3 b/man3/bzero.3 index ee8eac426..1fd090638 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -174,7 +174,7 @@ including copies in registers or in "scratch" stack areas. .BR memset (3), .BR swab (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cabs.3 b/man3/cabs.3 index da879fc1e..3b5293dfc 100644 --- a/man3/cabs.3 +++ b/man3/cabs.3 @@ -50,7 +50,7 @@ The function is actually an alias for .BR hypot (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacos.3 b/man3/cacos.3 index 917b92717..fe3ec9e66 100644 --- a/man3/cacos.3 +++ b/man3/cacos.3 @@ -87,7 +87,7 @@ main(int argc, char *argv[]) .BR clog (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacosh.3 b/man3/cacosh.3 index 19b2213c1..016aa32a7 100644 --- a/man3/cacosh.3 +++ b/man3/cacosh.3 @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/canonicalize_file_name.3 b/man3/canonicalize_file_name.3 index 5d21b0630..ca558eb95 100644 --- a/man3/canonicalize_file_name.3 +++ b/man3/canonicalize_file_name.3 @@ -88,7 +88,7 @@ This function is a GNU extension. .BR readlink (2), .BR realpath (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/carg.3 b/man3/carg.3 index 5f70404de..b190e4fca 100644 --- a/man3/carg.3 +++ b/man3/carg.3 @@ -78,7 +78,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casin.3 b/man3/casin.3 index cf211446e..237ce16b3 100644 --- a/man3/casin.3 +++ b/man3/casin.3 @@ -53,7 +53,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR csin (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casinh.3 b/man3/casinh.3 index 15a3bf44f..8505cc38f 100644 --- a/man3/casinh.3 +++ b/man3/casinh.3 @@ -55,7 +55,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR csinh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catan.3 b/man3/catan.3 index 3e0716f12..f0724b01e 100644 --- a/man3/catan.3 +++ b/man3/catan.3 @@ -84,7 +84,7 @@ main(int argc, char *argv[]) .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catanh.3 b/man3/catanh.3 index 80ce36ff6..fb4c26700 100644 --- a/man3/catanh.3 +++ b/man3/catanh.3 @@ -86,7 +86,7 @@ main(int argc, char *argv[]) .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catgets.3 b/man3/catgets.3 index 2d2cfe817..11f84dac2 100644 --- a/man3/catgets.3 +++ b/man3/catgets.3 @@ -99,7 +99,7 @@ in favor of always returning .BR catopen (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catopen.3 b/man3/catopen.3 index 2a2dbf1b3..73fb8a3d3 100644 --- a/man3/catopen.3 +++ b/man3/catopen.3 @@ -207,7 +207,7 @@ The default path varies, but usually looks at a number of places below .BR catgets (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cbrt.3 b/man3/cbrt.3 index f45b8de58..490c027fd 100644 --- a/man3/cbrt.3 +++ b/man3/cbrt.3 @@ -102,7 +102,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR pow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccos.3 b/man3/ccos.3 index bebf2a79f..f6b47af44 100644 --- a/man3/ccos.3 +++ b/man3/ccos.3 @@ -52,7 +52,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccosh.3 b/man3/ccosh.3 index 4343994d2..28929ce7b 100644 --- a/man3/ccosh.3 +++ b/man3/ccosh.3 @@ -37,7 +37,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ceil.3 b/man3/ceil.3 index e8efa8e4e..bc3581897 100644 --- a/man3/ceil.3 +++ b/man3/ceil.3 @@ -128,7 +128,7 @@ before assigning it to an integer type. .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp.3 b/man3/cexp.3 index f569c4305..96592f1ad 100644 --- a/man3/cexp.3 +++ b/man3/cexp.3 @@ -53,7 +53,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR cpow (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp2.3 b/man3/cexp2.3 index 5f593775a..d33ea84d3 100644 --- a/man3/cexp2.3 +++ b/man3/cexp2.3 @@ -31,7 +31,7 @@ Not yet in glibc, as at version 2.19. .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cfree.3 b/man3/cfree.3 index b7a6f8427..aaf6d8867 100644 --- a/man3/cfree.3 +++ b/man3/cfree.3 @@ -141,7 +141,7 @@ Intel386 Binary Compatibility Specification, Edition 2. .SH SEE ALSO .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cimag.3 b/man3/cimag.3 index 3b9c1a99a..277282136 100644 --- a/man3/cimag.3 +++ b/man3/cimag.3 @@ -52,7 +52,7 @@ That is a GNU extension. .BR creal (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clearenv.3 b/man3/clearenv.3 index 2a15b48bf..d957e1b91 100644 --- a/man3/clearenv.3 +++ b/man3/clearenv.3 @@ -136,7 +136,7 @@ will return an error and the process environment will remain unchanged. .BR unsetenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clock.3 b/man3/clock.3 index 9939be231..2c1ed50b2 100644 --- a/man3/clock.3 +++ b/man3/clock.3 @@ -112,7 +112,7 @@ clock). .BR getrusage (2), .BR times (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clock_getcpuclockid.3 b/man3/clock_getcpuclockid.3 index 498526c26..af833688d 100644 --- a/man3/clock_getcpuclockid.3 +++ b/man3/clock_getcpuclockid.3 @@ -164,7 +164,7 @@ main(int argc, char *argv[]) .BR pthread_getcpuclockid (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog.3 b/man3/clog.3 index e04d02ad8..de6ad3f3b 100644 --- a/man3/clog.3 +++ b/man3/clog.3 @@ -65,7 +65,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR clog2 (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog10.3 b/man3/clog10.3 index 4f284f262..8d5cd46b2 100644 --- a/man3/clog10.3 +++ b/man3/clog10.3 @@ -64,7 +64,7 @@ The identifiers are reserved for future use in C99 and C11. .BR clog2 (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog2.3 b/man3/clog2.3 index 27331253c..5dd4c47bd 100644 --- a/man3/clog2.3 +++ b/man3/clog2.3 @@ -43,7 +43,7 @@ Not yet in glibc, as at version 2.19. .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/closedir.3 b/man3/closedir.3 index 8fb203732..4b46f6b28 100644 --- a/man3/closedir.3 +++ b/man3/closedir.3 @@ -87,7 +87,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cmsg.3 b/man3/cmsg.3 index 9e8bbc52b..a19479024 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -236,7 +236,7 @@ memcpy(CMSG_DATA(cmsg), myfds, NUM_FD * sizeof(int)); .PP RFC\ 2292 .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/confstr.3 b/man3/confstr.3 index aaeb7b9c5..fd7de7e06 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -165,7 +165,7 @@ confstr(_CS_PATH, pathbuf, n); .BR sysconf (3), .BR system (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/conj.3 b/man3/conj.3 index 7ea2efe5e..983585092 100644 --- a/man3/conj.3 +++ b/man3/conj.3 @@ -50,7 +50,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR csqrt (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/copysign.3 b/man3/copysign.3 index 5b52fea73..5be019fc1 100644 --- a/man3/copysign.3 +++ b/man3/copysign.3 @@ -108,7 +108,7 @@ functions may treat a negative zero as positive. .SH SEE ALSO .BR signbit (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cos.3 b/man3/cos.3 index e3c0252ee..dbee26ffb 100644 --- a/man3/cos.3 +++ b/man3/cos.3 @@ -133,7 +133,7 @@ when a domain error occurred. .BR sincos (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cosh.3 b/man3/cosh.3 index c242ea7c0..61aec2788 100644 --- a/man3/cosh.3 +++ b/man3/cosh.3 @@ -143,7 +143,7 @@ exception is not raised when an overflow occurs. .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cpow.3 b/man3/cpow.3 index ecbd09fbf..792685761 100644 --- a/man3/cpow.3 +++ b/man3/cpow.3 @@ -49,7 +49,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR pow (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cproj.3 b/man3/cproj.3 index f3adec9ee..5e37e7d28 100644 --- a/man3/cproj.3 +++ b/man3/cproj.3 @@ -55,7 +55,7 @@ projection onto a Riemann Sphere). .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/creal.3 b/man3/creal.3 index fb7996324..45128d00e 100644 --- a/man3/creal.3 +++ b/man3/creal.3 @@ -52,7 +52,7 @@ That is a GNU extension. .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/crypt.3 b/man3/crypt.3 index 3c302350e..f2ecbb84f 100644 --- a/man3/crypt.3 +++ b/man3/crypt.3 @@ -304,7 +304,7 @@ otherwise. .BR getpass (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csin.3 b/man3/csin.3 index 759be1d74..bde37329f 100644 --- a/man3/csin.3 +++ b/man3/csin.3 @@ -52,7 +52,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csinh.3 b/man3/csinh.3 index 2bbd39468..37316f5f2 100644 --- a/man3/csinh.3 +++ b/man3/csinh.3 @@ -52,7 +52,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csqrt.3 b/man3/csqrt.3 index b604600bb..ab2944392 100644 --- a/man3/csqrt.3 +++ b/man3/csqrt.3 @@ -48,7 +48,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR cexp (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctan.3 b/man3/ctan.3 index 782730fcb..58013a080 100644 --- a/man3/ctan.3 +++ b/man3/ctan.3 @@ -52,7 +52,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR csin (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctanh.3 b/man3/ctanh.3 index 855b32d9b..93ea5eca7 100644 --- a/man3/ctanh.3 +++ b/man3/ctanh.3 @@ -53,7 +53,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR csinh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctermid.3 b/man3/ctermid.3 index 17700776d..2f3a9db4f 100644 --- a/man3/ctermid.3 +++ b/man3/ctermid.3 @@ -82,7 +82,7 @@ It is not assured that the program can open the terminal. .SH SEE ALSO .BR ttyname (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctime.3 b/man3/ctime.3 index eeb32727b..ae0c85ebf 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -444,7 +444,7 @@ should be called before .BR tzset (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/daemon.3 b/man3/daemon.3 index 7e0bc8fcc..9288a8f5b 100644 --- a/man3/daemon.3 +++ b/man3/daemon.3 @@ -148,7 +148,7 @@ the controlling terminal for the daemon. .BR daemon (7), .BR logrotate (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dbopen.3 b/man3/dbopen.3 index ae74852a5..33ce0f61a 100644 --- a/man3/dbopen.3 +++ b/man3/dbopen.3 @@ -560,7 +560,7 @@ locking, or transactions. .IR "LIBTP: Portable, Modular Transactions for UNIX" , Margo Seltzer, Michael Olson, USENIX proceedings, Winter 1992. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/des_crypt.3 b/man3/des_crypt.3 index 85964d55c..7aedb0d28 100644 --- a/man3/des_crypt.3 +++ b/man3/des_crypt.3 @@ -164,7 +164,7 @@ Not in POSIX.1. .BR crypt (3), .BR xcrypt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/difftime.3 b/man3/difftime.3 index 17e6c78c3..6afc80441 100644 --- a/man3/difftime.3 +++ b/man3/difftime.3 @@ -80,7 +80,7 @@ when the possible overflow in the subtraction is not a concern. .BR gmtime (3), .BR localtime (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dirfd.3 b/man3/dirfd.3 index 208ca5d72..80722fedb 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -106,7 +106,7 @@ This function was a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD. .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/div.3 b/man3/div.3 index 235f24f60..a3187890c 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -118,7 +118,7 @@ the values \fIq.quot\fP and \fIq.rem\fP are \-1 and \-2, respectively. .BR abs (3), .BR remainder (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index 3017f825d..e48788034 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -359,7 +359,7 @@ main(int argc, char *argv[]) .IR "Executable and Linking Format Specification" , available at various locations online. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dladdr.3 b/man3/dladdr.3 index d3de5ed81..d925bbd1b 100644 --- a/man3/dladdr.3 +++ b/man3/dladdr.3 @@ -289,7 +289,7 @@ will generate code that just loads the final symbol address from the .BR dlsym (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlerror.3 b/man3/dlerror.3 index d01f816c9..d53c4f441 100644 --- a/man3/dlerror.3 +++ b/man3/dlerror.3 @@ -90,7 +90,7 @@ See .BR dlopen (3), .BR dlsym (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index bd2db5573..003f77cc2 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -334,7 +334,7 @@ main(int argc, char *argv[]) .BR dlsym (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlopen.3 b/man3/dlopen.3 index e40d0dd69..896cb4484 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -627,7 +627,7 @@ main(void) .PP gcc info pages, ld info pages .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlsym.3 b/man3/dlsym.3 index f71ab0af5..c1c6a6c64 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -171,7 +171,7 @@ See .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/drand48.3 b/man3/drand48.3 index 767f69d21..88256713e 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -278,7 +278,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4. .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/drand48_r.3 b/man3/drand48_r.3 index 385bb64f8..d30c5497a 100644 --- a/man3/drand48_r.3 +++ b/man3/drand48_r.3 @@ -120,7 +120,7 @@ These functions are GNU extensions and are not portable. .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 150de186a..b36a1cf6c 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -186,7 +186,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dysize.3 b/man3/dysize.3 index 1923c67d5..4fccf7a52 100644 --- a/man3/dysize.3 +++ b/man3/dysize.3 @@ -76,7 +76,7 @@ Don't use it in new programs. .SH SEE ALSO .BR strftime (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ecvt.3 b/man3/ecvt.3 index 394d91a9f..0621074d0 100644 --- a/man3/ecvt.3 +++ b/man3/ecvt.3 @@ -146,7 +146,7 @@ Not all locales use a point as the radix character ("decimal point"). .BR setlocale (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ecvt_r.3 b/man3/ecvt_r.3 index 27f18a5f5..bec87ef86 100644 --- a/man3/ecvt_r.3 +++ b/man3/ecvt_r.3 @@ -114,7 +114,7 @@ is recommended. .BR qecvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/encrypt.3 b/man3/encrypt.3 index 9be0dbe93..74b1b8891 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -218,7 +218,7 @@ main(void) .BR ecb_crypt (3), .\" .BR fcrypt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/end.3 b/man3/end.3 index f8e3bd50c..3e75c0f2a 100644 --- a/man3/end.3 +++ b/man3/end.3 @@ -111,7 +111,7 @@ main(int argc, char *argv[]) .BR sbrk (2), .BR elf (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/endian.3 b/man3/endian.3 index 50da4db06..ba2486511 100644 --- a/man3/endian.3 +++ b/man3/endian.3 @@ -175,7 +175,7 @@ main(int argc, char *argv[]) .BR bswap (3), .BR byteorder (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/envz_add.3 b/man3/envz_add.3 index 996e1a096..074facb62 100644 --- a/man3/envz_add.3 +++ b/man3/envz_add.3 @@ -163,7 +163,7 @@ main(int argc, char *argv[], char *envp[]) .SH SEE ALSO .BR argz_add (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erf.3 b/man3/erf.3 index bd02aad13..de5e6b688 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -142,7 +142,7 @@ SVr4, 4.3BSD. .BR erfc (3), .BR exp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erfc.3 b/man3/erfc.3 index 8a73a15ed..cb21b61bb 100644 --- a/man3/erfc.3 +++ b/man3/erfc.3 @@ -149,7 +149,7 @@ would occur for the calculation 1-erf(x) for large values of .BR erf (3), .BR exp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/err.3 b/man3/err.3 index e3199f592..e4e7ef10a 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -183,7 +183,7 @@ if (fd == \-1) .BR printf (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/errno.3 b/man3/errno.3 index 51108c772..f4e1f8ce0 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -28,7 +28,7 @@ .\" 2006-02-09 Kurt Wall, mtk .\" Added non-POSIX errors .\" -.TH ERRNO 3 2019-03-06 "" "Linux Programmer's Manual" +.TH ERRNO 3 2019-10-10 "" "Linux Programmer's Manual" .SH NAME errno \- number of last error .SH SYNOPSIS @@ -95,6 +95,7 @@ must have distinct values, with the exception of and .BR EWOULDBLOCK , which may be the same. +On Linux, these two have the same value on all architectures. .PP The error numbers that correspond to each symbolic name vary across UNIX systems, @@ -240,8 +241,10 @@ Connection reset (POSIX.1-2001). Resource deadlock avoided (POSIX.1-2001). .TP .B EDEADLOCK -Synonym for +On most architectures, a synonym for .BR EDEADLK . +On some architectures (e.g., Linux MIPS, PowerPC, SPARC), +it is a separate error code "File locking deadlock error". .TP .B EDESTADDRREQ Destination address required (POSIX.1-2001). @@ -646,7 +649,7 @@ and it will cause problems with modern versions of the C library. .BR perror (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/error.3 b/man3/error.3 index 668b151d0..c8307fd9c 100644 --- a/man3/error.3 +++ b/man3/error.3 @@ -164,7 +164,7 @@ used in programs intended to be portable. .BR program_invocation_name (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ether_aton.3 b/man3/ether_aton.3 index 444180de0..878a314de 100644 --- a/man3/ether_aton.3 +++ b/man3/ether_aton.3 @@ -157,7 +157,7 @@ is broken. .SH SEE ALSO .BR ethers (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index c14272427..690a033a8 100644 --- a/man3/euidaccess.3 +++ b/man3/euidaccess.3 @@ -116,7 +116,7 @@ and .BR credentials (7), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exec.3 b/man3/exec.3 index 761137860..75c801ca3 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -301,7 +301,7 @@ wrapper function on those architectures. .BR system (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exit.3 b/man3/exit.3 index da7bcc912..441abecb8 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -214,7 +214,7 @@ operation to arrange that it receives a signal if its parent terminates. .BR on_exit (3), .BR tmpfile (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp.3 b/man3/exp.3 index f2b20ee8b..43f8c4aeb 100644 --- a/man3/exp.3 +++ b/man3/exp.3 @@ -148,7 +148,7 @@ SVr4, 4.3BSD, C89. .BR expm1 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp10.3 b/man3/exp10.3 index 0bee590ef..ebd1c04dc 100644 --- a/man3/exp10.3 +++ b/man3/exp10.3 @@ -97,7 +97,7 @@ when an underflow error occurred. .BR log10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp2.3 b/man3/exp2.3 index 0fbd74804..a8abd3cce 100644 --- a/man3/exp2.3 +++ b/man3/exp2.3 @@ -108,7 +108,7 @@ SVr4, 4.3BSD. .BR exp10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/expm1.3 b/man3/expm1.3 index c6b3a19dd..d186684bf 100644 --- a/man3/expm1.3 +++ b/man3/expm1.3 @@ -179,7 +179,7 @@ when a range error occurred. .BR log (3), .BR log1p (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fabs.3 b/man3/fabs.3 index da3125871..0e6561765 100644 --- a/man3/fabs.3 +++ b/man3/fabs.3 @@ -107,7 +107,7 @@ SVr4, 4.3BSD, C89. .BR labs (3), .BR rint (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fclose.3 b/man3/fclose.3 index 881adf923..62564d2db 100644 --- a/man3/fclose.3 +++ b/man3/fclose.3 @@ -119,7 +119,7 @@ or .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fcloseall.3 b/man3/fcloseall.3 index 15a03816e..10d3a24f6 100644 --- a/man3/fcloseall.3 +++ b/man3/fcloseall.3 @@ -77,7 +77,7 @@ This function is a GNU extension. .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fdim.3 b/man3/fdim.3 index a726180db..bc8e4cfc3 100644 --- a/man3/fdim.3 +++ b/man3/fdim.3 @@ -93,7 +93,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fenv.3 b/man3/fenv.3 index 31c1f2f9f..eb6049eee 100644 --- a/man3/fenv.3 +++ b/man3/fenv.3 @@ -342,7 +342,7 @@ always has the value 1. .SH SEE ALSO .BR math_error (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ferror.3 b/man3/ferror.3 index 25dc25723..672ae58a3 100644 --- a/man3/ferror.3 +++ b/man3/ferror.3 @@ -144,7 +144,7 @@ conforms to POSIX.1-2001 and POSIX.1-2008. .BR stdio (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 71a04b714..15021d396 100644 --- a/man3/fexecve.3 +++ b/man3/fexecve.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FEXECVE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH FEXECVE 3 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME fexecve \- execute program specified via file descriptor .SH SYNOPSIS @@ -86,8 +86,18 @@ is NULL, or .I envp is NULL. .TP +.B ENOENT +The close-on-exec flag is set on +.IR fd , +and +.I fd +refers to a script. +See BUGS. +.TP .B ENOSYS -The +The kernel does not provide the +.BR execveat (2) +system call, and the .I /proc filesystem could not be accessed. .SH VERSIONS @@ -186,7 +196,7 @@ if it refers to a script, leading to the problems described in NOTES. .BR execve (2), .BR execveat (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fflush.3 b/man3/fflush.3 index 3258f9f5d..e676e9294 100644 --- a/man3/fflush.3 +++ b/man3/fflush.3 @@ -131,7 +131,7 @@ or .BR setbuf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ffs.3 b/man3/ffs.3 index bde79c8ac..5bdd01938 100644 --- a/man3/ffs.3 +++ b/man3/ffs.3 @@ -127,7 +127,7 @@ BSD systems have a prototype in .SH SEE ALSO .BR memchr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetc.3 b/man3/fgetc.3 index f51fbc11a..e6d1668d6 100644 --- a/man3/fgetc.3 +++ b/man3/fgetc.3 @@ -166,7 +166,7 @@ will be undefined and very probably not what you want. .BR unlocked_stdio (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 913f8b542..8f298e7e5 100644 --- a/man3/fgetgrent.3 +++ b/man3/fgetgrent.3 @@ -127,7 +127,7 @@ SVr4. .BR setgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index ae53b4aec..36204e0c6 100644 --- a/man3/fgetpwent.3 +++ b/man3/fgetpwent.3 @@ -136,7 +136,7 @@ SVr4. .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetwc.3 b/man3/fgetwc.3 index 94fae347f..531be515e 100644 --- a/man3/fgetwc.3 +++ b/man3/fgetwc.3 @@ -102,7 +102,7 @@ from the stream and then convert it to a wide character. .BR ungetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetws.3 b/man3/fgetws.3 index 908830a92..f1d37fa02 100644 --- a/man3/fgetws.3 +++ b/man3/fgetws.3 @@ -86,7 +86,7 @@ null wide characters that may be present in the input. .BR fgetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/finite.3 b/man3/finite.3 index f0cb15c3f..4de05bd77 100644 --- a/man3/finite.3 +++ b/man3/finite.3 @@ -159,7 +159,7 @@ See .SH SEE ALSO .BR fpclassify (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/flockfile.3 b/man3/flockfile.3 index 343b2cc85..25d7206e2 100644 --- a/man3/flockfile.3 +++ b/man3/flockfile.3 @@ -146,7 +146,7 @@ is defined. .SH SEE ALSO .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/floor.3 b/man3/floor.3 index 303754111..a22b20b46 100644 --- a/man3/floor.3 +++ b/man3/floor.3 @@ -118,7 +118,7 @@ and the number of mantissa bits is 24 (respectively, 53).) .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fma.3 b/man3/fma.3 index eca4f77be..05d0201b7 100644 --- a/man3/fma.3 +++ b/man3/fma.3 @@ -165,7 +165,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR remainder (3), .BR remquo (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmax.3 b/man3/fmax.3 index e65635683..c75a651e1 100644 --- a/man3/fmax.3 +++ b/man3/fmax.3 @@ -69,7 +69,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR fdim (3), .BR fmin (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index 1f45fd318..0f2157ef5 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -351,7 +351,7 @@ main(int argc, char *argv[]) .BR fopencookie (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmin.3 b/man3/fmin.3 index a5025dccb..88e79f702 100644 --- a/man3/fmin.3 +++ b/man3/fmin.3 @@ -71,7 +71,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR fdim (3), .BR fmax (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmod.3 b/man3/fmod.3 index b94fb0c19..02b026e42 100644 --- a/man3/fmod.3 +++ b/man3/fmod.3 @@ -169,7 +169,7 @@ when a domain error occurred for an infinite .SH SEE ALSO .BR remainder (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index 690cb49da..eb16d1a2c 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -330,7 +330,7 @@ TO FIX: See mount(8). .BR addseverity (3), .BR perror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index a46fe2bb8..de8ce0c7b 100644 --- a/man3/fnmatch.3 +++ b/man3/fnmatch.3 @@ -144,7 +144,7 @@ flags are GNU extensions. .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopen.3 b/man3/fopen.3 index 500be9dde..4638f728e 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -412,7 +412,7 @@ parses at most 5 characters in .BR fopencookie (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 2775c0c20..bc0bb7672 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -452,7 +452,7 @@ main(int argc, char *argv[]) .BR fopen (3), .BR fseek (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index 5b1c96b2e..139ff7ae8 100644 --- a/man3/fpathconf.3 +++ b/man3/fpathconf.3 @@ -284,7 +284,7 @@ memory. .BR confstr (3), .BR sysconf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpclassify.3 b/man3/fpclassify.3 index 1d606d71a..7dff4dc24 100644 --- a/man3/fpclassify.3 +++ b/man3/fpclassify.3 @@ -146,7 +146,7 @@ is positive infinity or negative infinity. .BR isgreater (3), .BR signbit (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpurge.3 b/man3/fpurge.3 index 87116f7e2..9cdf703aa 100644 --- a/man3/fpurge.3 +++ b/man3/fpurge.3 @@ -95,7 +95,7 @@ Usually it is a mistake to want to discard input buffers. .BR setbuf (3), .BR stdio_ext (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputwc.3 b/man3/fputwc.3 index 89f2d52c1..0e2439bcb 100644 --- a/man3/fputwc.3 +++ b/man3/fputwc.3 @@ -100,7 +100,7 @@ sequence corresponding to the wide character \fIwc\fP. .BR fputws (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputws.3 b/man3/fputws.3 index 825a46a82..248a76cc2 100644 --- a/man3/fputws.3 +++ b/man3/fputws.3 @@ -74,7 +74,7 @@ string corresponding to the wide-character string \fIws\fP. .BR fputwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fread.3 b/man3/fread.3 index fbf740e3d..fdc0e6bd0 100644 --- a/man3/fread.3 +++ b/man3/fread.3 @@ -120,7 +120,7 @@ POSIX.1-2001, POSIX.1-2008, C89. .BR ferror (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/frexp.3 b/man3/frexp.3 index 88ffc36a6..f05932134 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -155,7 +155,7 @@ main(int argc, char *argv[]) .BR ldexp (3), .BR modf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseek.3 b/man3/fseek.3 index a5c872161..6c967a09b 100644 --- a/man3/fseek.3 +++ b/man3/fseek.3 @@ -190,7 +190,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99. .BR lseek (2), .BR fseeko (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseeko.3 b/man3/fseeko.3 index 4cbcd70a5..fde70d93c 100644 --- a/man3/fseeko.3 +++ b/man3/fseeko.3 @@ -116,7 +116,7 @@ POSIX.1-2001, POSIX.1-2008, SUSv2. .SH SEE ALSO .BR fseek (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftime.3 b/man3/ftime.3 index b750cb431..1e2da2f4d 100644 --- a/man3/ftime.3 +++ b/man3/ftime.3 @@ -108,7 +108,7 @@ glibc 2.1.1 is correct again. .BR gettimeofday (2), .BR time (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftok.3 b/man3/ftok.3 index 7a4312e86..1486d438b 100644 --- a/man3/ftok.3 +++ b/man3/ftok.3 @@ -119,7 +119,7 @@ and files on .BR stat (2), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fts.3 b/man3/fts.3 index 9ac4903ac..057ac96f9 100644 --- a/man3/fts.3 +++ b/man3/fts.3 @@ -838,7 +838,7 @@ a program using the LFS APIs (e.g., when compiling with .BR ftw (3), .BR qsort (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftw.3 b/man3/ftw.3 index cbab7989c..b09eb2e96 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -520,7 +520,7 @@ main(int argc, char *argv[]) .BR fts (3), .BR readdir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/futimes.3 b/man3/futimes.3 index 9e572dec9..2eec0b15f 100644 --- a/man3/futimes.3 +++ b/man3/futimes.3 @@ -114,7 +114,7 @@ Other than Linux, they are available only on the BSDs. .BR utimensat (2), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fwide.3 b/man3/fwide.3 index 5135d4e8d..483ffbb0e 100644 --- a/man3/fwide.3 +++ b/man3/fwide.3 @@ -94,7 +94,7 @@ directives. .BR fprintf (3), .BR fwprintf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gamma.3 b/man3/gamma.3 index 142e0c47b..2f1eac360 100644 --- a/man3/gamma.3 +++ b/man3/gamma.3 @@ -117,7 +117,7 @@ the "true gamma" function. .BR signgam (3), .BR tgamma (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gcvt.3 b/man3/gcvt.3 index ec441adc9..a27f1afed 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -100,7 +100,7 @@ may be preferable). .BR fcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3 index 45a6c6cd4..802e7d7c7 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -105,7 +105,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR nproc (1) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/get_phys_pages.3 b/man3/get_phys_pages.3 index ddf83d6c1..765471fbb 100644 --- a/man3/get_phys_pages.3 +++ b/man3/get_phys_pages.3 @@ -100,7 +100,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR sysconf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 0afe5569b..adb142f08 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -853,7 +853,7 @@ main(int argc, char *argv[]) .BR hostname (7), .BR ip (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getaddrinfo_a.3 b/man3/getaddrinfo_a.3 index a168ea4c9..cf50a4f3b 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -622,7 +622,7 @@ main(int argc, char *argv[]) .BR ip (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getauxval.3 b/man3/getauxval.3 index 5ee1fbd5a..8bf1f0389 100644 --- a/man3/getauxval.3 +++ b/man3/getauxval.3 @@ -24,7 +24,7 @@ .\" .\" See also https://lwn.net/Articles/519085/ .\" -.TH GETAUXVAL 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH GETAUXVAL 3 2019-10-10 "GNU" "Linux Programmer's Manual" .SH NAME getauxval \- retrieve a value from the auxiliary vector .SH SYNOPSIS @@ -123,6 +123,37 @@ The instruction cache block size. .\" .TP .\" .BR AT_NOTELF .TP +.\" Kernel commit 98a5f361b8625c6f4841d6ba013bbf0e80d08147 +.BR AT_L1D_CACHEGEOMETRY +Geometry of the L1 data cache, encoded with the cache line size in bytes +in the bottom 16 bits and the cache associativity in the next 16 bits. +The associativity is such that if N is the 16-bit value, +the cache is N-way set associative. +.TP +.BR AT_L1D_CACHESIZE +The L1 data cache size. +.TP +.BR AT_L1I_CACHEGEOMETRY +Geometry of the L1 instruction cache, encoded as for +.BR AT_L1D_CACHEGEOMETRY . +.TP +.BR AT_L1I_CACHESIZE +The L1 instruction cache size. +.TP +.BR AT_L2_CACHEGEOMETRY +Geometry of the L2 cache, encoded as for +.BR AT_L1D_CACHEGEOMETRY . +.TP +.BR AT_L2_CACHESIZE +The L2 cache size. +.TP +.BR AT_L3_CACHEGEOMETRY +Geometry of the L3 cache, encoded as for +.BR AT_L1D_CACHEGEOMETRY . +.TP +.BR AT_L3_CACHESIZE +The L3 cache size. +.TP .BR AT_PAGESZ The system page size (the same value returned by .IR sysconf(_SC_PAGESIZE) ). @@ -252,7 +283,7 @@ was zero. .BR vdso (7), .BR ld-linux.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcontext.3 b/man3/getcontext.3 index 213ab43af..e278f2a39 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -205,7 +205,7 @@ instead. .BR makecontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcwd.3 b/man3/getcwd.3 index ec3911ff6..58833fffa 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -322,7 +322,7 @@ from such a pathname will now result in failure with .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdate.3 b/man3/getdate.3 index e60ac38b4..ebf40d43f 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -323,7 +323,7 @@ main(int argc, char *argv[]) .BR strftime (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index b8d684e75..227d647d7 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -88,7 +88,7 @@ instead. .BR lseek (2), .BR open (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdtablesize.3 b/man3/getdtablesize.3 index 89557c2d2..43b3bc482 100644 --- a/man3/getdtablesize.3 +++ b/man3/getdtablesize.3 @@ -106,7 +106,7 @@ when that fails. .BR getrlimit (2), .BR open (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getentropy.3 b/man3/getentropy.3 index ad6784bc9..d09fc2968 100644 --- a/man3/getentropy.3 +++ b/man3/getentropy.3 @@ -122,7 +122,7 @@ and will return only once the entropy pool has been initialized. .BR urandom (4), .BR random (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getenv.3 b/man3/getenv.3 index fd1a66d61..e11bd2455 100644 --- a/man3/getenv.3 +++ b/man3/getenv.3 @@ -148,7 +148,7 @@ flag contained in the auxiliary vector passed from the kernel to user space. .BR capabilities (7), .BR environ (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getfsent.3 b/man3/getfsent.3 index 89da3a7c0..9ff254b4a 100644 --- a/man3/getfsent.3 +++ b/man3/getfsent.3 @@ -161,7 +161,7 @@ for use under Linux. .BR getmntent (3), .BR fstab (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 0c13ccbec..0ab03f68e 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -215,7 +215,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrent_r.3 b/man3/getgrent_r.3 index 78a210204..1a9822544 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -218,7 +218,7 @@ main(void) .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index e9bda74e3..3ebfb919c 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -257,7 +257,7 @@ situation: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM, and probably others. .BR setgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index c5a25dc0f..b81c18114 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -209,7 +209,7 @@ main(int argc, char *argv[]) .BR group (5), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 99ae6c08d..e1219aa40 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -549,7 +549,7 @@ that are expressed in hexadecimal. .BR named (8) .\" .BR resolv+ (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostid.3 b/man3/gethostid.3 index ee770fdf5..6b668ac96 100644 --- a/man3/gethostid.3 +++ b/man3/gethostid.3 @@ -148,7 +148,7 @@ It is impossible to ensure that the identifier is globally unique. .BR hostid (1), .BR gethostbyname (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 3d9515571..49d1e7368 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -327,7 +327,7 @@ int main(int argc, char *argv[]) .BR packet (7), .BR ifconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index 4a5ed518b..ec6516b40 100644 --- a/man3/getipnodebyname.3 +++ b/man3/getipnodebyname.3 @@ -269,7 +269,7 @@ call them deprecated. .BR inet_ntop (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getline.3 b/man3/getline.3 index 4088109f9..70528f5af 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -200,7 +200,7 @@ main(int argc, char *argv[]) .BR fread (3), .BR scanf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getloadavg.3 b/man3/getloadavg.3 index 351cf4d79..cef8b4a3e 100644 --- a/man3/getloadavg.3 +++ b/man3/getloadavg.3 @@ -94,7 +94,7 @@ Present on the BSDs and Solaris. .BR uptime (1), .BR proc (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getlogin.3 b/man3/getlogin.3 index f1ee58e41..a0c911d04 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -108,7 +108,7 @@ set to indicate the cause of the error. .BR getlogin_r () returns 0 when successful, and nonzero on failure. .SH ERRORS -POSIX specifies +POSIX specifies: .TP .B EMFILE The per-process limit on the number of open file descriptors has been reached. @@ -125,7 +125,7 @@ The length of the username, including the terminating null byte (\(aq\e0\(aq), is larger than .IR bufsize . .PP -Linux/glibc also has +Linux/glibc also has: .TP .B ENOENT There was no corresponding entry in the utmp-file. @@ -248,7 +248,7 @@ what you meant. .BR getuid (2), .BR utmp (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 612de26ae..d14062e6c 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -258,7 +258,7 @@ a wrapper around the system call .BR fstab (5), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index 3482e4197..f78416b1f 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -331,7 +331,7 @@ Proceedings of the freenix track: .UR http://www.usenix.org\:/publications\:/library\:/proceedings\:/usenix2000\:/freenix\:/metzprotocol.html .UE . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnetent.3 b/man3/getnetent.3 index 857fff994..c1a6cf7ae 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -210,7 +210,7 @@ was of type .br RFC\ 1101 .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnetent_r.3 b/man3/getnetent_r.3 index 368aff623..bd77d10d5 100644 --- a/man3/getnetent_r.3 +++ b/man3/getnetent_r.3 @@ -163,7 +163,7 @@ though typically with different calling signatures. .BR getnetent (3), .BR networks (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getopt.3 b/man3/getopt.3 index 41a8ab0cb..7295e5597 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -537,7 +537,7 @@ main(int argc, char **argv) .BR getopt (1), .BR getsubopt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpass.3 b/man3/getpass.3 index 1f5752b16..30b16f7e3 100644 --- a/man3/getpass.3 +++ b/man3/getpass.3 @@ -165,7 +165,7 @@ leaving the cleartext password visible in the process's address space. .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index 1f659d639..98cc3d851 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -196,7 +196,7 @@ POSIX.1-2001, POSIX.1-2008, 4.3BSD. .BR getservent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getprotoent_r.3 b/man3/getprotoent_r.3 index efbae45ab..5bdf7d5a4 100644 --- a/man3/getprotoent_r.3 +++ b/man3/getprotoent_r.3 @@ -256,7 +256,7 @@ main(int argc, char *argv[]) .BR getprotoent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpt.3 b/man3/getpt.3 index d0ba65f99..621ec0cd9 100644 --- a/man3/getpt.3 +++ b/man3/getpt.3 @@ -67,7 +67,7 @@ instead. .BR ptmx (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpw.3 b/man3/getpw.3 index fa63778d3..34f749464 100644 --- a/man3/getpw.3 +++ b/man3/getpw.3 @@ -137,7 +137,7 @@ It is obsoleted by .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwent.3 b/man3/getpwent.3 index 5e3d4c69f..fdee98f21 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -199,7 +199,7 @@ field is not specified in POSIX, but is present on most implementations. .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index 34d400e2e..1ce682171 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -218,7 +218,7 @@ main(void) .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 651327751..d741adb78 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index e73ba9ef4..a807db9db 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -133,7 +133,7 @@ to be saved. .BR rpcinfo (8), .BR ypserv (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcent_r.3 b/man3/getrpcent_r.3 index cef1e0150..cfeed2e74 100644 --- a/man3/getrpcent_r.3 +++ b/man3/getrpcent_r.3 @@ -152,7 +152,7 @@ though typically with different calling signatures. .BR getrpcent (3), .BR rpc (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcport.3 b/man3/getrpcport.3 index d4ae9f813..8bbbcd621 100644 --- a/man3/getrpcport.3 +++ b/man3/getrpcport.3 @@ -52,7 +52,7 @@ T} Thread safety MT-Safe env locale Not in POSIX.1. Present on the BSDs, Solaris, and many other systems. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gets.3 b/man3/gets.3 index b234e10b4..4dbf14dee 100644 --- a/man3/gets.3 +++ b/man3/gets.3 @@ -119,7 +119,7 @@ http://cwe.mitre.org/data/definitions/242.html .BR unlocked_stdio (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getservent.3 b/man3/getservent.3 index 60b5ab28c..a39aa5758 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -213,7 +213,7 @@ POSIX.1-2001, POSIX.1-2008, 4.3BSD. .BR getservent_r (3), .BR services (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getservent_r.3 b/man3/getservent_r.3 index 2001a26a8..eb81b28d6 100644 --- a/man3/getservent_r.3 +++ b/man3/getservent_r.3 @@ -259,7 +259,7 @@ main(int argc, char *argv[]) .BR getservent (3), .BR services (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 7dd922690..9afa171c0 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -314,7 +314,7 @@ However, many other systems provide a similar API. .BR getpwnam_r (3), .BR shadow (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getsubopt.3 b/man3/getsubopt.3 index 2e9ed5758..cbeffc204 100644 --- a/man3/getsubopt.3 +++ b/man3/getsubopt.3 @@ -241,7 +241,7 @@ main(int argc, char **argv) .SH SEE ALSO .BR getopt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getttyent.3 b/man3/getttyent.3 index 7795e685f..631d2c7c7 100644 --- a/man3/getttyent.3 +++ b/man3/getttyent.3 @@ -96,7 +96,7 @@ and the functions described above, are not used. .BR ttyname (3), .BR ttyslot (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getumask.3 b/man3/getumask.3 index dc7a00709..3e7ea6e85 100644 --- a/man3/getumask.3 +++ b/man3/getumask.3 @@ -66,7 +66,7 @@ for a thread-safe method of discovering a process's umask.) .SH SEE ALSO .BR umask (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getusershell.3 b/man3/getusershell.3 index 0385819a7..cb958b971 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -116,7 +116,7 @@ T} Thread safety MT-Unsafe .SH SEE ALSO .BR shells (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutent.3 b/man3/getutent.3 index ef0268862..2ff4fa799 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -362,7 +362,7 @@ main(int argc, char *argv[]) .BR getutmp (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutmp.3 b/man3/getutmp.3 index deeb6ea54..5aa912b5b 100644 --- a/man3/getutmp.3 +++ b/man3/getutmp.3 @@ -84,7 +84,7 @@ and the fields have the same sizes. .BR getutent (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getw.3 b/man3/getw.3 index 154afb80e..4a20c951d 100644 --- a/man3/getw.3 +++ b/man3/getw.3 @@ -103,7 +103,7 @@ can be used to distinguish between the two cases. .BR getc (3), .BR putc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getwchar.3 b/man3/getwchar.3 index 815698532..a9058fc5e 100644 --- a/man3/getwchar.3 +++ b/man3/getwchar.3 @@ -84,7 +84,7 @@ convert it to a wide character. .BR fgetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/glob.3 b/man3/glob.3 index a5fd322d3..ea6e64b2d 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -360,7 +360,7 @@ execvp("ls", &globbuf.gl_pathv[0]); .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gnu_get_libc_version.3 b/man3/gnu_get_libc_version.3 index 22efb1878..766c206bb 100644 --- a/man3/gnu_get_libc_version.3 +++ b/man3/gnu_get_libc_version.3 @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR confstr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/grantpt.3 b/man3/grantpt.3 index e253b48a6..bd4402af5 100644 --- a/man3/grantpt.3 +++ b/man3/grantpt.3 @@ -105,7 +105,7 @@ glibc build that is typical on many systems). .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/group_member.3 b/man3/group_member.3 index 4a9463e1a..655ca5cef 100644 --- a/man3/group_member.3 +++ b/man3/group_member.3 @@ -60,7 +60,7 @@ This function is a nonstandard GNU extension. .BR getgrouplist (3), .BR group (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gsignal.3 b/man3/gsignal.3 index 181e54850..c8015118d 100644 --- a/man3/gsignal.3 +++ b/man3/gsignal.3 @@ -124,7 +124,7 @@ and .BR signal (2), .BR raise (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hash.3 b/man3/hash.3 index 7c9f5892f..7a21d1e76 100644 --- a/man3/hash.3 +++ b/man3/hash.3 @@ -169,7 +169,7 @@ Per-Ake Larson, Communications of the ACM, April 1988. .IR "A New Hash Package for UNIX" , Margo Seltzer, USENIX Proceedings, Winter 1991. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hsearch.3 b/man3/hsearch.3 index 699d3b043..32c84f012 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -353,7 +353,7 @@ main(void) .BR malloc (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hypot.3 b/man3/hypot.3 index 6c42ef706..0944c1928 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -174,7 +174,7 @@ SVr4, 4.3BSD. .BR cabs (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iconv.3 b/man3/iconv.3 index fdf41ec4f..fa25cb484 100644 --- a/man3/iconv.3 +++ b/man3/iconv.3 @@ -189,7 +189,7 @@ tight restrictions on alignment. .BR iconv_open (3), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iconv_close.3 b/man3/iconv_close.3 index 2897bc067..b6f77df24 100644 --- a/man3/iconv_close.3 +++ b/man3/iconv_close.3 @@ -55,7 +55,7 @@ POSIX.1-2001, POSIX.1-2008, SUSv2. .BR iconv (3), .BR iconv_open (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iconv_open.3 b/man3/iconv_open.3 index 304733f79..d2455878d 100644 --- a/man3/iconv_open.3 +++ b/man3/iconv_open.3 @@ -122,7 +122,7 @@ POSIX.1-2001, POSIX.1-2008, SUSv2. .BR iconv (3), .BR iconv_close (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/if_nameindex.3 b/man3/if_nameindex.3 index 2fac52773..9f8090b0f 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -167,7 +167,7 @@ main(int argc, char *argv[]) .BR if_nametoindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/if_nametoindex.3 b/man3/if_nametoindex.3 index 22b6827e9..a27acff0f 100644 --- a/man3/if_nametoindex.3 +++ b/man3/if_nametoindex.3 @@ -112,7 +112,7 @@ This function first appeared in BSDi. .BR if_nameindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ilogb.3 b/man3/ilogb.3 index 5d8346ad8..123264bbc 100644 --- a/man3/ilogb.3 +++ b/man3/ilogb.3 @@ -166,7 +166,7 @@ to be set or raise a floating-point exception. .BR logb (3), .BR significand (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/index.3 b/man3/index.3 index 7a61b389a..410f6adde 100644 --- a/man3/index.3 +++ b/man3/index.3 @@ -94,7 +94,7 @@ instead. .BR strstr (3), .BR strtok (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet.3 b/man3/inet.3 index 9892ac882..9d2f50ad9 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -340,7 +340,7 @@ main(int argc, char *argv[]) .BR hosts (5), .BR networks (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet_net_pton.3 b/man3/inet_net_pton.3 index 95084350f..0b5a4e67a 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -391,7 +391,7 @@ main(int argc, char *argv[]) .BR inet (3), .BR networks (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet_ntop.3 b/man3/inet_ntop.3 index 73b62be8a..bd8f8f35d 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -133,7 +133,7 @@ See .BR inet (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index 361da813f..53e639476 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -231,7 +231,7 @@ main(int argc, char *argv[]) .BR inet (3), .BR inet_ntop (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/initgroups.3 b/man3/initgroups.3 index c622b1183..134ad8b13 100644 --- a/man3/initgroups.3 +++ b/man3/initgroups.3 @@ -108,7 +108,7 @@ SVr4, 4.3BSD. .BR setgroups (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/insque.3 b/man3/insque.3 index e56f957b9..47e826f97 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -261,7 +261,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR queue (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/intro.3 b/man3/intro.3 index d849fa53c..fd4eb42e6 100644 --- a/man3/intro.3 +++ b/man3/intro.3 @@ -108,7 +108,7 @@ Note that these can be different from page to page! .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isalpha.3 b/man3/isalpha.3 index 9c0e60a9f..5c4334798 100644 --- a/man3/isalpha.3 +++ b/man3/isalpha.3 @@ -373,7 +373,7 @@ locale. .BR ascii (7), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isatty.3 b/man3/isatty.3 index 55161c7af..56ac3e07e 100644 --- a/man3/isatty.3 +++ b/man3/isatty.3 @@ -79,7 +79,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .BR fstat (2), .BR ttyname (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isfdtype.3 b/man3/isfdtype.3 index 9fb36bfab..db561384a 100644 --- a/man3/isfdtype.3 +++ b/man3/isfdtype.3 @@ -102,7 +102,7 @@ instead. .SH SEE ALSO .BR fstat (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isgreater.3 b/man3/isgreater.3 index b10ac84b0..9ae34b782 100644 --- a/man3/isgreater.3 +++ b/man3/isgreater.3 @@ -148,7 +148,7 @@ Don't use these functions if NaN is of no concern for you. .BR fpclassify (3), .BR isnan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalnum.3 b/man3/iswalnum.3 index 0117227e0..2347c22d3 100644 --- a/man3/iswalnum.3 +++ b/man3/iswalnum.3 @@ -88,7 +88,7 @@ current locale. .BR isalnum (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalpha.3 b/man3/iswalpha.3 index eab42c1d9..c2672aad2 100644 --- a/man3/iswalpha.3 +++ b/man3/iswalpha.3 @@ -92,7 +92,7 @@ current locale. .BR isalpha (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswblank.3 b/man3/iswblank.3 index 8444b90ce..4c43b1aa3 100644 --- a/man3/iswblank.3 +++ b/man3/iswblank.3 @@ -87,7 +87,7 @@ current locale. .BR isblank (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswcntrl.3 b/man3/iswcntrl.3 index 9c7284759..b8c5fc841 100644 --- a/man3/iswcntrl.3 +++ b/man3/iswcntrl.3 @@ -76,7 +76,7 @@ current locale. .BR iscntrl (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswctype.3 b/man3/iswctype.3 index 6e28bb89b..bca9aa366 100644 --- a/man3/iswctype.3 +++ b/man3/iswctype.3 @@ -90,7 +90,7 @@ current locale. .BR iswxdigit (3), .BR wctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswdigit.3 b/man3/iswdigit.3 index 3cb6600e8..4447bcbe8 100644 --- a/man3/iswdigit.3 +++ b/man3/iswdigit.3 @@ -91,7 +91,7 @@ current locale. .BR isdigit (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswgraph.3 b/man3/iswgraph.3 index 64e6dd7c7..92bae0fef 100644 --- a/man3/iswgraph.3 +++ b/man3/iswgraph.3 @@ -84,7 +84,7 @@ current locale. .BR isgraph (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswlower.3 b/man3/iswlower.3 index 7c634acb6..6a41e686c 100644 --- a/man3/iswlower.3 +++ b/man3/iswlower.3 @@ -102,7 +102,7 @@ because Unicode knows about three cases: upper, lower and title case. .BR iswctype (3), .BR towlower (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswprint.3 b/man3/iswprint.3 index a538a5829..b3cc26b6c 100644 --- a/man3/iswprint.3 +++ b/man3/iswprint.3 @@ -70,7 +70,7 @@ current locale. .BR isprint (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswpunct.3 b/man3/iswpunct.3 index 4c1f39d21..92a278971 100644 --- a/man3/iswpunct.3 +++ b/man3/iswpunct.3 @@ -86,7 +86,7 @@ and symbol (math, currency, etc.) characters. .BR ispunct (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswspace.3 b/man3/iswspace.3 index cbde59d1a..f8797b943 100644 --- a/man3/iswspace.3 +++ b/man3/iswspace.3 @@ -78,7 +78,7 @@ current locale. .BR isspace (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswupper.3 b/man3/iswupper.3 index 8f86e35f1..46344d595 100644 --- a/man3/iswupper.3 +++ b/man3/iswupper.3 @@ -96,7 +96,7 @@ because Unicode knows about three cases: upper, lower and title case. .BR iswctype (3), .BR towupper (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswxdigit.3 b/man3/iswxdigit.3 index 4b7d06c7e..5cfb4b093 100644 --- a/man3/iswxdigit.3 +++ b/man3/iswxdigit.3 @@ -83,7 +83,7 @@ current locale. .BR iswctype (3), .BR isxdigit (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -194,7 +194,7 @@ between \-8 and 8. .SH SEE ALSO .BR y0 (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/key_setsecret.3 b/man3/key_setsecret.3 index 9faf0bcb1..08299fb7b 100644 --- a/man3/key_setsecret.3 +++ b/man3/key_setsecret.3 @@ -89,7 +89,7 @@ These routines were part of the Linux/Doors-project, abandoned by now. .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/killpg.3 b/man3/killpg.3 index f2074fc91..d7108f82c 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -134,7 +134,7 @@ is implemented as a library function that makes the call .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ldexp.3 b/man3/ldexp.3 index 57019c193..fbc6e30b3 100644 --- a/man3/ldexp.3 +++ b/man3/ldexp.3 @@ -146,7 +146,7 @@ SVr4, 4.3BSD, C89. .BR modf (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lgamma.3 b/man3/lgamma.3 index cd0f3fe52..933b81beb 100644 --- a/man3/lgamma.3 +++ b/man3/lgamma.3 @@ -175,7 +175,7 @@ Since version 2.10, glibc does the right thing. .SH SEE ALSO .BR tgamma (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lio_listio.3 b/man3/lio_listio.3 index c1ab31aba..71c38a8e5 100644 --- a/man3/lio_listio.3 +++ b/man3/lio_listio.3 @@ -239,7 +239,7 @@ structure produce undefined results. .BR aio_write (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/localeconv.3 b/man3/localeconv.3 index a12bd0bc7..e0c7595a6 100644 --- a/man3/localeconv.3 +++ b/man3/localeconv.3 @@ -90,7 +90,7 @@ family of functions may or may not honor the current locale. .BR strftime (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lockf.3 b/man3/lockf.3 index b3a937006..401913ec0 100644 --- a/man3/lockf.3 +++ b/man3/lockf.3 @@ -188,7 +188,7 @@ directory, and is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log.3 b/man3/log.3 index 2b80bac18..88b4e3997 100644 --- a/man3/log.3 +++ b/man3/log.3 @@ -155,7 +155,7 @@ exception. .BR log2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log10.3 b/man3/log10.3 index 5cc40bde8..12cfb3bd4 100644 --- a/man3/log10.3 +++ b/man3/log10.3 @@ -109,7 +109,7 @@ SVr4, 4.3BSD, C89. .BR log2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log1p.3 b/man3/log1p.3 index c0eab7205..8d53f8144 100644 --- a/man3/log1p.3 +++ b/man3/log1p.3 @@ -165,7 +165,7 @@ when a range error occurred. .BR expm1 (3), .BR log (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log2.3 b/man3/log2.3 index 1b56e4baf..8076b5129 100644 --- a/man3/log2.3 +++ b/man3/log2.3 @@ -109,7 +109,7 @@ SVr4, 4.3BSD. .BR log10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/logb.3 b/man3/logb.3 index 0a518c5fc..54daa2e13 100644 --- a/man3/logb.3 +++ b/man3/logb.3 @@ -157,7 +157,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR ilogb (3), .BR log (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/login.3 b/man3/login.3 index cae71590b..7e09bf1b3 100644 --- a/man3/login.3 +++ b/man3/login.3 @@ -166,7 +166,7 @@ in .BR getutent (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lrint.3 b/man3/lrint.3 index c7140e0c5..9fbb61dd7 100644 --- a/man3/lrint.3 +++ b/man3/lrint.3 @@ -127,7 +127,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lround.3 b/man3/lround.3 index 0b0965768..71fd16f6c 100644 --- a/man3/lround.3 +++ b/man3/lround.3 @@ -130,7 +130,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lsearch.3 b/man3/lsearch.3 index 060797299..d1b93efff 100644 --- a/man3/lsearch.3 +++ b/man3/lsearch.3 @@ -101,7 +101,7 @@ The naming is unfortunate. .BR hsearch (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lseek64.3 b/man3/lseek64.3 index 7696361cf..e77471c3f 100644 --- a/man3/lseek64.3 +++ b/man3/lseek64.3 @@ -177,7 +177,7 @@ T} Thread safety MT-Safe .BR llseek (2), .BR lseek (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makecontext.3 b/man3/makecontext.3 index 8be2d40f3..ac92a55ad 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -239,7 +239,7 @@ main(int argc, char *argv[]) .BR getcontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makedev.3 b/man3/makedev.3 index 8844de91a..ace6dac9a 100644 --- a/man3/makedev.3 +++ b/man3/makedev.3 @@ -108,7 +108,7 @@ no longer provides these definitions. .BR mknod (2), .BR stat (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index d7b280166..115fde038 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -317,7 +317,7 @@ main(int argc, char *argv[]) .BR malloc_trim (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc.3 b/man3/malloc.3 index ccf4dbcda..c284c27d1 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -395,7 +395,7 @@ For details of the GNU C library implementation, see .UR https://sourceware.org/glibc/wiki/MallocInternals .UE . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc_get_state.3 b/man3/malloc_get_state.3 index 5f299c906..c3d80624b 100644 --- a/man3/malloc_get_state.3 +++ b/man3/malloc_get_state.3 @@ -129,7 +129,7 @@ then the hooks are reset to 0. .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc_hook.3 b/man3/malloc_hook.3 index e9597a277..8d2f36e23 100644 --- a/man3/malloc_hook.3 +++ b/man3/malloc_hook.3 @@ -145,7 +145,7 @@ my_malloc_hook(size_t size, const void *caller) .BR mcheck (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc_info.3 b/man3/malloc_info.3 index 49587b2d4..df0b47daf 100644 --- a/man3/malloc_info.3 +++ b/man3/malloc_info.3 @@ -272,7 +272,7 @@ main(int argc, char *argv[]) .BR mallopt (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc_stats.3 b/man3/malloc_stats.3 index e27e52503..783024327 100644 --- a/man3/malloc_stats.3 +++ b/man3/malloc_stats.3 @@ -78,7 +78,7 @@ can be obtained using .BR malloc_info (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc_trim.3 b/man3/malloc_trim.3 index 66d840780..b022bfd8c 100644 --- a/man3/malloc_trim.3 +++ b/man3/malloc_trim.3 @@ -103,7 +103,7 @@ top of the heap in the main arena. .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc_usable_size.3 b/man3/malloc_usable_size.3 index 65dd8b7f7..fa70213f7 100644 --- a/man3/malloc_usable_size.3 +++ b/man3/malloc_usable_size.3 @@ -74,7 +74,7 @@ The main use of this function is for debugging and introspection. .SH SEE ALSO .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallopt.3 b/man3/mallopt.3 index 9b2bbcdd5..3b7736928 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -626,7 +626,7 @@ main(int argc, char *argv[]) .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/matherr.3 b/man3/matherr.3 index 602d1f422..aa1fc08b2 100644 --- a/man3/matherr.3 +++ b/man3/matherr.3 @@ -441,7 +441,7 @@ main(int argc, char *argv[]) .BR math_error (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mblen.3 b/man3/mblen.3 index 567a1ed84..4d8296601 100644 --- a/man3/mblen.3 +++ b/man3/mblen.3 @@ -113,7 +113,7 @@ functionality. .SH SEE ALSO .BR mbrlen (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index e5e346390..18c43adc1 100644 --- a/man3/mbrlen.3 +++ b/man3/mbrlen.3 @@ -125,7 +125,7 @@ current locale. .SH SEE ALSO .BR mbrtowc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrtowc.3 b/man3/mbrtowc.3 index 5d5c514d2..e545dda8f 100644 --- a/man3/mbrtowc.3 +++ b/man3/mbrtowc.3 @@ -197,7 +197,7 @@ current locale. .BR mbsinit (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index 60e04de14..eac7dcf35 100644 --- a/man3/mbsinit.3 +++ b/man3/mbsinit.3 @@ -113,7 +113,7 @@ current locale. .BR wcrtomb (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index f0bd13992..b80283e91 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -199,7 +199,7 @@ is not multithread safe. .BR mbsinit (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index f6315e68c..3fec068d4 100644 --- a/man3/mbsrtowcs.3 +++ b/man3/mbsrtowcs.3 @@ -156,7 +156,7 @@ is not multithread safe. .BR mbsnrtowcs (3), .BR mbstowcs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index 5fa551cd7..0d93c9fe9 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -235,7 +235,7 @@ main(int argc, char *argv[]) .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index f1bcc6d84..bf5ae0c38 100644 --- a/man3/mbtowc.3 +++ b/man3/mbtowc.3 @@ -145,7 +145,7 @@ a better interface to the same functionality. .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mcheck.3 b/man3/mcheck.3 index 930fdad4b..03fdf80ea 100644 --- a/man3/mcheck.3 +++ b/man3/mcheck.3 @@ -227,7 +227,7 @@ main(int argc, char *argv[]) .BR mallopt (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memccpy.3 b/man3/memccpy.3 index e8e2905d9..6e41be810 100644 --- a/man3/memccpy.3 +++ b/man3/memccpy.3 @@ -89,7 +89,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .BR strcpy (3), .BR strncpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memchr.3 b/man3/memchr.3 index 08b8fcc8a..189212f65 100644 --- a/man3/memchr.3 +++ b/man3/memchr.3 @@ -160,7 +160,7 @@ function is a GNU extension, available since glibc 2.1. .BR strstr (3), .BR wmemchr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcmp.3 b/man3/memcmp.3 index 7e6fceb1e..16ea43661 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -96,7 +96,7 @@ On Linux, it may be necessary to implement such a function oneself. .BR strncmp (3), .BR wmemcmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcpy.3 b/man3/memcpy.3 index ded29c774..6608d3124 100644 --- a/man3/memcpy.3 +++ b/man3/memcpy.3 @@ -116,7 +116,7 @@ implementation that was aliased to .BR strncpy (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 1faf0019b..541ceed27 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -76,7 +76,7 @@ GNU C Library. .BR bstring (3), .BR strfry (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmem.3 b/man3/memmem.3 index 93bf353aa..e36244e5d 100644 --- a/man3/memmem.3 +++ b/man3/memmem.3 @@ -100,7 +100,7 @@ This is fixed in glibc 2.1. .BR bstring (3), .BR strstr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmove.3 b/man3/memmove.3 index 82f13721e..990ec678d 100644 --- a/man3/memmove.3 +++ b/man3/memmove.3 @@ -82,7 +82,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR strncpy (3), .BR wmemmove (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 85963dada..f739dab37 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -87,7 +87,7 @@ combine(void *o1, size_t s1, void *o2, size_t s2) .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memset.3 b/man3/memset.3 index bc390bd03..3c7a3f532 100644 --- a/man3/memset.3 +++ b/man3/memset.3 @@ -71,7 +71,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR swab (3), .BR wmemset (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index b8dd2e0bd..4808316f8 100644 --- a/man3/mkdtemp.3 +++ b/man3/mkdtemp.3 @@ -109,7 +109,7 @@ This function is present on the BSDs. .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index a68d894e1..1c1c9403b 100644 --- a/man3/mkfifo.3 +++ b/man3/mkfifo.3 @@ -210,7 +210,7 @@ POSIX.1-2008. .BR write (2), .BR fifo (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index ef9c00ffc..17f2e1c21 100644 --- a/man3/mkstemp.3 +++ b/man3/mkstemp.3 @@ -254,7 +254,7 @@ is set appropriately before calling .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mktemp.3 b/man3/mktemp.3 index a5484330f..aa4247e5f 100644 --- a/man3/mktemp.3 +++ b/man3/mktemp.3 @@ -136,7 +136,7 @@ and .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/modf.3 b/man3/modf.3 index af2fabe56..27ae469ed 100644 --- a/man3/modf.3 +++ b/man3/modf.3 @@ -109,7 +109,7 @@ SVr4, 4.3BSD, C89. .BR frexp (3), .BR ldexp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mpool.3 b/man3/mpool.3 index 1f14abeb2..2dc4a62ea 100644 --- a/man3/mpool.3 +++ b/man3/mpool.3 @@ -233,7 +233,7 @@ Present on the BSDs. .BR hash (3), .BR recno (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_close.3 b/man3/mq_close.3 index af8929376..9bc3c6254 100644 --- a/man3/mq_close.3 +++ b/man3/mq_close.3 @@ -84,7 +84,7 @@ or upon .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_getattr.3 b/man3/mq_getattr.3 index 8c9e0c9b6..8d27e365d 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -242,7 +242,7 @@ main(int argc, char *argv[]) .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_notify.3 b/man3/mq_notify.3 index 5d1fdc883..7818d3f2b 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -285,7 +285,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_open.3 b/man3/mq_open.3 index 7ebbd0379..ec0fd7ce7 100644 --- a/man3/mq_open.3 +++ b/man3/mq_open.3 @@ -313,7 +313,7 @@ the process umask was not applied to the permissions specified in .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_receive.3 b/man3/mq_receive.3 index aa17b74af..dfbb754fd 100644 --- a/man3/mq_receive.3 +++ b/man3/mq_receive.3 @@ -183,7 +183,7 @@ is a library function layered on top of that system call. .BR mq_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_send.3 b/man3/mq_send.3 index 7777c2561..a5a780063 100644 --- a/man3/mq_send.3 +++ b/man3/mq_send.3 @@ -191,7 +191,7 @@ is a library function layered on top of that system call. .BR mq_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mq_unlink.3 b/man3/mq_unlink.3 index 1c8dcfa4f..762f8b875 100644 --- a/man3/mq_unlink.3 +++ b/man3/mq_unlink.3 @@ -82,7 +82,7 @@ POSIX.1-2001, POSIX.1-2008. .BR mq_send (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mtrace.3 b/man3/mtrace.3 index 0b928abfc..235aa104f 100644 --- a/man3/mtrace.3 +++ b/man3/mtrace.3 @@ -192,7 +192,7 @@ The final message corresponds to the call to .BR malloc_hook (3), .BR mcheck (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nan.3 b/man3/nan.3 index 3a98ac922..a7c453b43 100644 --- a/man3/nan.3 +++ b/man3/nan.3 @@ -93,7 +93,7 @@ recommended functions in IEEE 754/IEEE 854. .BR strtod (3), .BR math_error (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/netlink.3 b/man3/netlink.3 index 9dcff51e9..b1f121f9a 100644 --- a/man3/netlink.3 +++ b/man3/netlink.3 @@ -85,7 +85,7 @@ than via the low-level kernel interface. .BR libnetlink (3), .BR netlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/newlocale.3 b/man3/newlocale.3 index aa768a41d..654ed5244 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -379,7 +379,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextafter.3 b/man3/nextafter.3 index 9b7603ccc..2cdb856dc 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -200,7 +200,7 @@ exception when an underflow occurs. .SH SEE ALSO .BR nearbyint (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextup.3 b/man3/nextup.3 index e9ad3dbb1..95870c756 100644 --- a/man3/nextup.3 +++ b/man3/nextup.3 @@ -110,7 +110,7 @@ and .BR nearbyint (3), .BR nextafter (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3 index 28a4419fd..7f8c80be2 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -221,7 +221,7 @@ main(int argc, char *argv[]) .PP The GNU C Library Reference Manual .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ntp_gettime.3 b/man3/ntp_gettime.3 index 1300a9e3a..2f6a70837 100644 --- a/man3/ntp_gettime.3 +++ b/man3/ntp_gettime.3 @@ -148,7 +148,7 @@ is a GNU extension. NTP "Kernel Application Program Interface" .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/offsetof.3 b/man3/offsetof.3 index 6ebf97eec..c35023d7c 100644 --- a/man3/offsetof.3 +++ b/man3/offsetof.3 @@ -102,7 +102,7 @@ main(void) } .EE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/on_exit.3 b/man3/on_exit.3 index d141602e8..231fa20b7 100644 --- a/man3/on_exit.3 +++ b/man3/on_exit.3 @@ -115,7 +115,7 @@ it may however be a pointer to a heap variable or a global variable. .BR atexit (3), .BR exit (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/open_memstream.3 b/man3/open_memstream.3 index b8be12610..a13ff553a 100644 --- a/man3/open_memstream.3 +++ b/man3/open_memstream.3 @@ -144,7 +144,7 @@ See .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/opendir.3 b/man3/opendir.3 index 83be48ec5..b499061df 100644 --- a/man3/opendir.3 +++ b/man3/opendir.3 @@ -162,7 +162,7 @@ will set the close-on-exec flag for the file descriptor, .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/openpty.3 b/man3/openpty.3 index 14c549c2a..a9bbbc5d3 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -198,7 +198,7 @@ may not be secure. .BR ttyname (3), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/perror.3 b/man3/perror.3 index 2fdfcd218..d3b4eab04 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -155,7 +155,7 @@ are defined by glibc, but in .BR error (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/popen.3 b/man3/popen.3 index 862a97601..7e37be386 100644 --- a/man3/popen.3 +++ b/man3/popen.3 @@ -232,7 +232,7 @@ The only hint is an exit status of 127. .BR stdio (3), .BR system (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/posix_fallocate.3 b/man3/posix_fallocate.3 index f3bf5f5c5..94ee83ca1 100644 --- a/man3/posix_fallocate.3 +++ b/man3/posix_fallocate.3 @@ -184,7 +184,7 @@ fallback with all the same problems as the emulation provided by glibc. .BR lseek (2), .BR posix_fadvise (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/posix_madvise.3 b/man3/posix_madvise.3 index c4b57e83c..6a3958ee8 100644 --- a/man3/posix_madvise.3 +++ b/man3/posix_madvise.3 @@ -127,7 +127,7 @@ has destructive semantics. .BR madvise (2), .BR posix_fadvise (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index 0dfa6ef78..823c78e96 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -304,7 +304,7 @@ needed only if you require larger alignment values. .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/posix_openpt.3 b/man3/posix_openpt.3 index d50810acd..1c8aa0248 100644 --- a/man3/posix_openpt.3 +++ b/man3/posix_openpt.3 @@ -122,7 +122,7 @@ The slave device pathname exists only as long as the master device is open. .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/posix_spawn.3 b/man3/posix_spawn.3 index ac347e8c8..3642ff8ed 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -807,7 +807,7 @@ main(int argc, char *argv[]) Base Definitions volume of POSIX.1-2001, .I http://www.opengroup.org/unix/online.html .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow.3 b/man3/pow.3 index 9566529da..744929777 100644 --- a/man3/pow.3 +++ b/man3/pow.3 @@ -389,7 +389,7 @@ in addition to the overflow or underflow exception. .BR cpow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow10.3 b/man3/pow10.3 index 367d7c98b..6de40b36e 100644 --- a/man3/pow10.3 +++ b/man3/pow10.3 @@ -72,7 +72,7 @@ This functions are nonstandard GNU extensions. .BR exp10 (3), .BR pow (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/printf.3 b/man3/printf.3 index b121f0094..13625a793 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -31,7 +31,7 @@ .\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes .\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes .\" -.TH PRINTF 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH PRINTF 3 2019-10-10 "GNU" "Linux Programmer's Manual" .SH NAME printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf, vsnprintf \- formatted output conversion @@ -658,7 +658,8 @@ The .I double argument is rounded and converted in the style .RB [\-]d \&. ddd e \(+-dd -where there is one digit before the decimal-point character and the number +where there is one digit (which is nonzero if the argument is nonzero) +before the decimal-point character and the number of digits after it is equal to the precision; if the precision is missing, it is taken as 6; if the precision is zero, no decimal-point character appears. @@ -1175,7 +1176,7 @@ error instead of being handled gracefully. .BR wprintf (3), .BR locale (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/profil.3 b/man3/profil.3 index d78d2ee39..713f9e272 100644 --- a/man3/profil.3 +++ b/man3/profil.3 @@ -106,7 +106,7 @@ Libc 4.4 contained a kernel patch providing a system call profil. .BR sigaction (2), .BR signal (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/program_invocation_name.3 b/man3/program_invocation_name.3 index 3320a3a98..d2bd5032e 100644 --- a/man3/program_invocation_name.3 +++ b/man3/program_invocation_name.3 @@ -63,7 +63,7 @@ file provides access to similar information. .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/psignal.3 b/man3/psignal.3 index 8ca715151..2d3a9d2b8 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -136,7 +136,7 @@ Additional details are not displayed for real-time signals. .BR strsignal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_atfork.3 b/man3/pthread_atfork.3 index 3d0c2ea04..a24b82144 100644 --- a/man3/pthread_atfork.3 +++ b/man3/pthread_atfork.3 @@ -126,7 +126,7 @@ shall not fail with the error .BR atexit (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_init.3 b/man3/pthread_attr_init.3 index dec064f93..28eb5a029 100644 --- a/man3/pthread_attr_init.3 +++ b/man3/pthread_attr_init.3 @@ -327,7 +327,7 @@ main(int argc, char *argv[]) .BR pthread_setattr_default_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setaffinity_np.3 b/man3/pthread_attr_setaffinity_np.3 index cdbc646fb..f958fdbc3 100644 --- a/man3/pthread_attr_setaffinity_np.3 +++ b/man3/pthread_attr_setaffinity_np.3 @@ -136,7 +136,7 @@ Instead the CPU set size given to the underlying system calls was always .BR cpuset (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setdetachstate.3 b/man3/pthread_attr_setdetachstate.3 index 91214d4bc..3637c3997 100644 --- a/man3/pthread_attr_setdetachstate.3 +++ b/man3/pthread_attr_setdetachstate.3 @@ -128,7 +128,7 @@ See .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setguardsize.3 b/man3/pthread_attr_setguardsize.3 index 8c6cd403c..04f03cc21 100644 --- a/man3/pthread_attr_setguardsize.3 +++ b/man3/pthread_attr_setguardsize.3 @@ -177,7 +177,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setinheritsched.3 b/man3/pthread_attr_setinheritsched.3 index 601fd0d5b..f3f36f3d5 100644 --- a/man3/pthread_attr_setinheritsched.3 +++ b/man3/pthread_attr_setinheritsched.3 @@ -154,7 +154,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setschedparam.3 b/man3/pthread_attr_setschedparam.3 index a1586c558..384c89503 100644 --- a/man3/pthread_attr_setschedparam.3 +++ b/man3/pthread_attr_setschedparam.3 @@ -139,7 +139,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setschedpolicy.3 b/man3/pthread_attr_setschedpolicy.3 index bce9a864a..f025069b5 100644 --- a/man3/pthread_attr_setschedpolicy.3 +++ b/man3/pthread_attr_setschedpolicy.3 @@ -127,7 +127,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setscope.3 b/man3/pthread_attr_setscope.3 index fe5ecdf86..c000a6f2f 100644 --- a/man3/pthread_attr_setscope.3 +++ b/man3/pthread_attr_setscope.3 @@ -153,7 +153,7 @@ implementation-defined. .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setstack.3 b/man3/pthread_attr_setstack.3 index 4182998ec..aec8c10a9 100644 --- a/man3/pthread_attr_setstack.3 +++ b/man3/pthread_attr_setstack.3 @@ -178,7 +178,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setstackaddr.3 b/man3/pthread_attr_setstackaddr.3 index a94da7241..ddfa378bb 100644 --- a/man3/pthread_attr_setstackaddr.3 +++ b/man3/pthread_attr_setstackaddr.3 @@ -127,7 +127,7 @@ argument specifies the range of the stack). .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setstacksize.3 b/man3/pthread_attr_setstacksize.3 index 0227752d2..07ee1abd4 100644 --- a/man3/pthread_attr_setstacksize.3 +++ b/man3/pthread_attr_setstacksize.3 @@ -129,7 +129,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_cancel.3 b/man3/pthread_cancel.3 index 11acfd9a1..e13dca66d 100644 --- a/man3/pthread_cancel.3 +++ b/man3/pthread_cancel.3 @@ -249,7 +249,7 @@ main(void) .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_cleanup_push.3 b/man3/pthread_cleanup_push.3 index 7932caca4..6e2c535b3 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -333,7 +333,7 @@ main(int argc, char *argv[]) .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_cleanup_push_defer_np.3 b/man3/pthread_cleanup_push_defer_np.3 index c894aea2e..38f9568be 100644 --- a/man3/pthread_cleanup_push_defer_np.3 +++ b/man3/pthread_cleanup_push_defer_np.3 @@ -121,7 +121,7 @@ hence the suffix "_np" (nonportable) in the names. .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_create.3 b/man3/pthread_create.3 index 266babde7..7a6aa32c7 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -418,7 +418,7 @@ main(int argc, char *argv[]) .BR pthread_setattr_default_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_detach.3 b/man3/pthread_detach.3 index aff63ade9..713221b7f 100644 --- a/man3/pthread_detach.3 +++ b/man3/pthread_detach.3 @@ -115,7 +115,7 @@ The following statement detaches the calling thread: .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_equal.3 b/man3/pthread_equal.3 index a7190fc91..0656dcd0e 100644 --- a/man3/pthread_equal.3 +++ b/man3/pthread_equal.3 @@ -70,7 +70,7 @@ values. .BR pthread_self (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_exit.3 b/man3/pthread_exit.3 index f5d419bc8..c4d2e9e0c 100644 --- a/man3/pthread_exit.3 +++ b/man3/pthread_exit.3 @@ -119,7 +119,7 @@ sent to a foreground process whose thread group leader has already called .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_getattr_default_np.3 b/man3/pthread_getattr_default_np.3 index 5b0aeefd4..4cede430e 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -211,7 +211,7 @@ main(int argc, char *argv[]) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_getattr_np.3 b/man3/pthread_getattr_np.3 index 45cb8ab88..942fb955c 100644 --- a/man3/pthread_getattr_np.3 +++ b/man3/pthread_getattr_np.3 @@ -373,7 +373,7 @@ main(int argc, char *argv[]) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_getcpuclockid.3 b/man3/pthread_getcpuclockid.3 index f916c8ab8..c12452a03 100644 --- a/man3/pthread_getcpuclockid.3 +++ b/man3/pthread_getcpuclockid.3 @@ -188,7 +188,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_join.3 b/man3/pthread_join.3 index 6ae077a34..e428cb9de 100644 --- a/man3/pthread_join.3 +++ b/man3/pthread_join.3 @@ -148,7 +148,7 @@ See .BR pthread_tryjoin_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_kill.3 b/man3/pthread_kill.3 index 6348ffaa4..d86e56c07 100644 --- a/man3/pthread_kill.3 +++ b/man3/pthread_kill.3 @@ -123,7 +123,7 @@ can, for example, cause a segmentation fault. .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_kill_other_threads_np.3 b/man3/pthread_kill_other_threads_np.3 index 35d7f8ef0..97d76089a 100644 --- a/man3/pthread_kill_other_threads_np.3 +++ b/man3/pthread_kill_other_threads_np.3 @@ -82,7 +82,7 @@ because the implementation does the right thing during an .BR pthread_setcanceltype (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_mutex_consistent.3 b/man3/pthread_mutex_consistent.3 index 5920747c0..a979938da 100644 --- a/man3/pthread_mutex_consistent.3 +++ b/man3/pthread_mutex_consistent.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_MUTEX_CONSISTENT 3 2017-08-20 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_MUTEX_CONSISTENT 3 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME pthread_mutex_consistent \- make a robust mutex consistent .SH SYNOPSIS @@ -101,11 +101,11 @@ See .nh .BR pthread_mutexattr_init (3), .BR pthread_mutex_lock (3), -.BR pthread_mutexattr_setrobust (3), .BR pthread_mutexattr_getrobust (3), +.BR pthread_mutexattr_setrobust (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_mutexattr_getpshared.3 b/man3/pthread_mutexattr_getpshared.3 index 4af05da20..aaf79e148 100644 --- a/man3/pthread_mutexattr_getpshared.3 +++ b/man3/pthread_mutexattr_getpshared.3 @@ -97,7 +97,7 @@ POSIX.1-2001, POSIX.1-2008. .BR pthread_mutexattr_init (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_mutexattr_init.3 b/man3/pthread_mutexattr_init.3 index 243ad6935..1fff701ba 100644 --- a/man3/pthread_mutexattr_init.3 +++ b/man3/pthread_mutexattr_init.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_MUTEXATTR_INIT 3 2017-08-20 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_MUTEXATTR_INIT 3 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME pthread_mutexattr_init, pthread_mutexattr_destroy \- initialize and destroy a mutex attributes object @@ -65,11 +65,11 @@ have already been initialized using that object. .ad l .nh .BR pthread_mutex_init (3), -.BR pthread_mutexattr_getrobust (3), .BR pthread_mutexattr_getpshared (3), +.BR pthread_mutexattr_getrobust (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_mutexattr_setrobust.3 b/man3/pthread_mutexattr_setrobust.3 index bf3ecc3e7..f1b4da26d 100644 --- a/man3/pthread_mutexattr_setrobust.3 +++ b/man3/pthread_mutexattr_setrobust.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_MUTEXATTR_SETROBUST 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_MUTEXATTR_SETROBUST 3 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME pthread_mutexattr_getrobust, pthread_mutexattr_setrobust \- get and set the robustness attribute of a mutex attributes object @@ -279,12 +279,12 @@ main(int argc, char *argv[]) .nh .BR get_robust_list (2), .BR set_robust_list (2), -.BR pthread_mutex_init (3), .BR pthread_mutex_consistent (3), +.BR pthread_mutex_init (3), .BR pthread_mutex_lock (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_rwlockattr_setkind_np.3 b/man3/pthread_rwlockattr_setkind_np.3 index e880e36b9..0275fb84c 100644 --- a/man3/pthread_rwlockattr_setkind_np.3 +++ b/man3/pthread_rwlockattr_setkind_np.3 @@ -142,7 +142,7 @@ hence the suffix "_np" (nonportable) in the names. .SH SEE ALSO .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_self.3 b/man3/pthread_self.3 index adf7ef475..5a605e1f4 100644 --- a/man3/pthread_self.3 +++ b/man3/pthread_self.3 @@ -90,7 +90,7 @@ is not the same thing as the kernel thread ID returned by a call to .BR pthread_equal (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_setaffinity_np.3 b/man3/pthread_setaffinity_np.3 index e73de1576..208f7387e 100644 --- a/man3/pthread_setaffinity_np.3 +++ b/man3/pthread_setaffinity_np.3 @@ -222,7 +222,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_setcancelstate.3 b/man3/pthread_setcancelstate.3 index 3cb4933eb..c36f8a74f 100644 --- a/man3/pthread_setcancelstate.3 +++ b/man3/pthread_setcancelstate.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SETCANCELSTATE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SETCANCELSTATE 3 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME pthread_setcancelstate, pthread_setcanceltype \- set cancelability state and type @@ -79,6 +79,11 @@ a function that is a cancellation point (see .BR pthreads (7)). This is the default cancelability type in all new threads, including the initial thread. +.IP +Even with deferred cancellation, a +cancellation point in an asynchronous signal handler may still +be acted upon and the effect is as if it was an asynchronous +cancellation. .TP .B PTHREAD_CANCEL_ASYNCHRONOUS The thread can be canceled at any time. @@ -206,7 +211,7 @@ See .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_setconcurrency.3 b/man3/pthread_setconcurrency.3 index e3ca75f77..380e25953 100644 --- a/man3/pthread_setconcurrency.3 +++ b/man3/pthread_setconcurrency.3 @@ -114,7 +114,7 @@ and they have no effect on the execution of a program. .BR pthread_attr_setscope (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_setname_np.3 b/man3/pthread_setname_np.3 index fe9d2cfb0..4fc90bd27 100644 --- a/man3/pthread_setname_np.3 +++ b/man3/pthread_setname_np.3 @@ -219,7 +219,7 @@ main(int argc, char **argv) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_setschedparam.3 b/man3/pthread_setschedparam.3 index 9e96b407c..e6a684e94 100644 --- a/man3/pthread_setschedparam.3 +++ b/man3/pthread_setschedparam.3 @@ -458,7 +458,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_setschedprio.3 b/man3/pthread_setschedprio.3 index 5078d986a..5ab36bf32 100644 --- a/man3/pthread_setschedprio.3 +++ b/man3/pthread_setschedprio.3 @@ -115,7 +115,7 @@ in each scheduling policy, see .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_sigmask.3 b/man3/pthread_sigmask.3 index 3bac1b83e..038cd3011 100644 --- a/man3/pthread_sigmask.3 +++ b/man3/pthread_sigmask.3 @@ -174,7 +174,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_sigqueue.3 b/man3/pthread_sigqueue.3 index a78dbf254..83ee8ea1c 100644 --- a/man3/pthread_sigqueue.3 +++ b/man3/pthread_sigqueue.3 @@ -124,7 +124,7 @@ for details. .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_spin_init.3 b/man3/pthread_spin_init.3 index 9779951cc..16d22ee86 100644 --- a/man3/pthread_spin_init.3 +++ b/man3/pthread_spin_init.3 @@ -168,7 +168,7 @@ thread placement, and priority assignment. .BR pthread_spin_unlock (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_spin_lock.3 b/man3/pthread_spin_lock.3 index 9f9889524..6c2ec50f6 100644 --- a/man3/pthread_spin_lock.3 +++ b/man3/pthread_spin_lock.3 @@ -122,7 +122,7 @@ Carefully read NOTES in .BR pthread_spin_init (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_testcancel.3 b/man3/pthread_testcancel.3 index 635e0cb94..dab76cf97 100644 --- a/man3/pthread_testcancel.3 +++ b/man3/pthread_testcancel.3 @@ -78,7 +78,7 @@ See .BR pthread_setcancelstate (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_tryjoin_np.3 b/man3/pthread_tryjoin_np.3 index f3b8514bb..f5480b267 100644 --- a/man3/pthread_tryjoin_np.3 +++ b/man3/pthread_tryjoin_np.3 @@ -163,7 +163,7 @@ if (s != 0) { .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_yield.3 b/man3/pthread_yield.3 index 6002d870f..51686f2a8 100644 --- a/man3/pthread_yield.3 +++ b/man3/pthread_yield.3 @@ -88,7 +88,7 @@ is unspecified and very likely means your application design is broken. .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ptsname.3 b/man3/ptsname.3 index f41bb6d3e..d155a65cb 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -134,7 +134,7 @@ Avoid using this function in portable programs. .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putenv.3 b/man3/putenv.3 index d49e3755b..e247dfcfd 100644 --- a/man3/putenv.3 +++ b/man3/putenv.3 @@ -149,7 +149,7 @@ then the named variable is removed from the caller's environment. .BR unsetenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putgrent.3 b/man3/putgrent.3 index f8ff52a09..2e9525aef 100644 --- a/man3/putgrent.3 +++ b/man3/putgrent.3 @@ -60,7 +60,7 @@ This function is a GNU extension. .BR getgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putpwent.3 b/man3/putpwent.3 index b2951b03c..80cd23e78 100644 --- a/man3/putpwent.3 +++ b/man3/putpwent.3 @@ -106,7 +106,7 @@ SVr4. .BR getpwuid (3), .BR setpwent (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/puts.3 b/man3/puts.3 index c85179b91..cac118aea 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -138,7 +138,7 @@ will be undefined and very probably not what you want. .BR scanf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putwchar.3 b/man3/putwchar.3 index cec06e285..de2db3432 100644 --- a/man3/putwchar.3 +++ b/man3/putwchar.3 @@ -88,7 +88,7 @@ the multibyte sequence corresponding to the wide character .BR fputwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qecvt.3 b/man3/qecvt.3 index ce2e14d30..c77d2af2b 100644 --- a/man3/qecvt.3 +++ b/man3/qecvt.3 @@ -117,7 +117,7 @@ is recommended. .BR gcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qsort.3 b/man3/qsort.3 index 61f681f00..898a5e90e 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -163,7 +163,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR versionsort (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/queue.3 b/man3/queue.3 index 8d40475d1..0c372595f 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -1242,7 +1242,7 @@ functions first appeared in .Xr insque 3 .\" .Xr tree 3 .Sh COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .Em man-pages project. A description of the project, diff --git a/man3/raise.3 b/man3/raise.3 index d3b697a8b..512538e78 100644 --- a/man3/raise.3 +++ b/man3/raise.3 @@ -94,7 +94,7 @@ using .BR pthread_kill (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rand.3 b/man3/rand.3 index 266ffed08..d9e8fc868 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -238,7 +238,7 @@ main(int argc, char *argv[]) .BR drand48 (3), .BR random (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/random.3 b/man3/random.3 index 1bd35c30a..310995f30 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -209,7 +209,7 @@ is (as specified) set on error, but the function does not return NULL. .BR random_r (3), .BR srand (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/random_r.3 b/man3/random_r.3 index 34978e7d1..f9eb4c7c5 100644 --- a/man3/random_r.3 +++ b/man3/random_r.3 @@ -191,7 +191,7 @@ field to NULL or zero out the entire structure before the call. .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rcmd.3 b/man3/rcmd.3 index 70e2ddae3..4fb6f3ec7 100644 --- a/man3/rcmd.3 +++ b/man3/rcmd.3 @@ -321,7 +321,7 @@ are declared in glibc headers only since version 2.12. .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/re_comp.3 b/man3/re_comp.3 index 1a09d4f8c..1bc6cffcb 100644 --- a/man3/re_comp.3 +++ b/man3/re_comp.3 @@ -87,7 +87,7 @@ should be used instead. .BR regex (7), GNU regex manual .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/readdir.3 b/man3/readdir.3 index 67ffc6f32..12bc01986 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -312,7 +312,7 @@ structure shown above. .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/readdir_r.3 b/man3/readdir_r.3 index 7d1adc895..ffd82eb0a 100644 --- a/man3/readdir_r.3 +++ b/man3/readdir_r.3 @@ -157,7 +157,7 @@ POSIX.1-2001, POSIX.1-2008. .SH SEE ALSO .BR readdir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/realpath.3 b/man3/realpath.3 index 8beb33cfa..0fe5418d6 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -246,7 +246,7 @@ but standardized in POSIX.1-2008, allows this design problem to be avoided. .BR pathconf (3), .BR sysconf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/recno.3 b/man3/recno.3 index 407828e45..8ad127b7e 100644 --- a/man3/recno.3 +++ b/man3/recno.3 @@ -231,7 +231,7 @@ Only big and little endian byte order is supported. Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/regex.3 b/man3/regex.3 index 99c720beb..4013cdfb3 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -27,7 +27,7 @@ .\" Modified 8 May 1998 by Joseph S. Myers (jsm28@cam.ac.uk) .\" .\" show the synopsis section nicely -.TH REGEX 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH REGEX 3 2019-10-10 "GNU" "Linux Programmer's Manual" .SH NAME regcomp, regexec, regerror, regfree \- POSIX regex functions .SH SYNOPSIS @@ -157,6 +157,26 @@ The match-end-of-line operator always fails to match (but see the compilation flag .B REG_NEWLINE above). +.TP +.B REG_STARTEND +Use +.I pmatch[0] +on the input string, starting at byte +.I pmatch[0].rm_so +and ending before byte +.IR pmatch[0].rm_eo . +This allows matching embedded NUL bytes +and avoids a +.BR strlen (3) +on large strings. +It does not use +.I nmatch +on input, and does not change +.B REG_NOTBOL +or +.B REG_NEWLINE +processing. +This flag is a BSD extension, not present in POSIX. .SS Byte offsets Unless .B REG_NOSUB @@ -329,7 +349,7 @@ POSIX.1-2001, POSIX.1-2008. The glibc manual section, .I "Regular Expressions" .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remainder.3 b/man3/remainder.3 index a4bfc70a8..5f26a503f 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -241,7 +241,7 @@ The call "remainder(29.0, 3.0)" returns \-1. .BR fmod (3), .BR remquo (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remove.3 b/man3/remove.3 index 82e567e2b..46a0599f8 100644 --- a/man3/remove.3 +++ b/man3/remove.3 @@ -102,7 +102,7 @@ disappearance of files which are still being used. .BR mkfifo (3), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remquo.3 b/man3/remquo.3 index a5c819435..9f252aa06 100644 --- a/man3/remquo.3 +++ b/man3/remquo.3 @@ -136,7 +136,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR logb (3), .BR remainder (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/res_nclose.3 b/man3/res_nclose.3 new file mode 100644 index 000000000..87a6d0e83 --- /dev/null +++ b/man3/res_nclose.3 @@ -0,0 +1 @@ +.so man3/resolver.3 diff --git a/man3/resolver.3 b/man3/resolver.3 index f65c81652..27358b6dc 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -519,7 +519,7 @@ T} Thread safety MT-Safe The GNU C library source file .IR resolv/README . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index 43dba0248..2ee06a019 100644 --- a/man3/rewinddir.3 +++ b/man3/rewinddir.3 @@ -72,7 +72,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rexec.3 b/man3/rexec.3 index 3092e24dc..4c56031ec 100644 --- a/man3/rexec.3 +++ b/man3/rexec.3 @@ -182,7 +182,7 @@ for explanations. .BR rcmd (3), .BR rexecd (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rint.3 b/man3/rint.3 index 4a83a6d45..e96de2977 100644 --- a/man3/rint.3 +++ b/man3/rint.3 @@ -160,7 +160,7 @@ instead. .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/round.3 b/man3/round.3 index 25b8ac246..20adee360 100644 --- a/man3/round.3 +++ b/man3/round.3 @@ -124,7 +124,7 @@ instead. .BR rint (3), .BR trunc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpc.3 b/man3/rpc.3 index 7798c6218..1f84a610f 100644 --- a/man3/rpc.3 +++ b/man3/rpc.3 @@ -1230,7 +1230,7 @@ rpcgen Programming Guide RFC\ 1050, Sun Microsystems, Inc., USC-ISI. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index a14780727..68426fe15 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -164,7 +164,7 @@ main(int argc, char *argv[]) .BR regcomp (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtime.3 b/man3/rtime.3 index f388bcd36..6beb47f93 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -143,7 +143,7 @@ main(void) .\" .BR rdate (1), .BR inetd (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index 4f8dbf7ef..77eda693d 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -126,7 +126,7 @@ send(rtnetlink_sk, &req, req.nh.nlmsg_len, 0); .BR netlink (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalb.3 b/man3/scalb.3 index 8db3261dd..192aab93f 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -219,7 +219,7 @@ is nevertheless present on several other systems .BR ldexp (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalbln.3 b/man3/scalbln.3 index 3ec9d3b04..a066cba19 100644 --- a/man3/scalbln.3 +++ b/man3/scalbln.3 @@ -192,7 +192,7 @@ is equivalent to .BR ldexp (3), .BR scalb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scandir.3 b/man3/scandir.3 index 74d6b7c20..2968ad1e3 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -332,7 +332,7 @@ main(void) .BR strverscmp (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scanf.3 b/man3/scanf.3 index 1332f32a2..928748d7f 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -768,7 +768,7 @@ call successfully read a string. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sched_getcpu.3 b/man3/sched_getcpu.3 index 684bd2b9c..c89d887f9 100644 --- a/man3/sched_getcpu.3 +++ b/man3/sched_getcpu.3 @@ -108,7 +108,7 @@ cpu = (s == \-1) ? s : c; .BR getcpu (2), .BR sched (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 83ad95f92..1c15867fc 100644 --- a/man3/seekdir.3 +++ b/man3/seekdir.3 @@ -98,7 +98,7 @@ assumptions about the value in this argument. .BR scandir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_close.3 b/man3/sem_close.3 index 1846152a2..bda22e2a2 100644 --- a/man3/sem_close.3 +++ b/man3/sem_close.3 @@ -78,7 +78,7 @@ termination, or upon .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_destroy.3 b/man3/sem_destroy.3 index 0f02ef4c8..b5cd47ad9 100644 --- a/man3/sem_destroy.3 +++ b/man3/sem_destroy.3 @@ -89,7 +89,7 @@ Failure to do this can result in resource leaks on some implementations. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_getvalue.3 b/man3/sem_getvalue.3 index e0f3e404a..b4d83a15d 100644 --- a/man3/sem_getvalue.3 +++ b/man3/sem_getvalue.3 @@ -85,7 +85,7 @@ returns. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_init.3 b/man3/sem_init.3 index 03df5c6f0..9b504fb59 100644 --- a/man3/sem_init.3 +++ b/man3/sem_init.3 @@ -117,7 +117,7 @@ POSIX.1-2008 rectifies this, specifying the zero return on success. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_open.3 b/man3/sem_open.3 index 16869f0fb..b7f0c7f36 100644 --- a/man3/sem_open.3 +++ b/man3/sem_open.3 @@ -190,7 +190,7 @@ POSIX.1-2001, POSIX.1-2008. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_post.3 b/man3/sem_post.3 index 8370156d1..57328c3bc 100644 --- a/man3/sem_post.3 +++ b/man3/sem_post.3 @@ -85,7 +85,7 @@ See .BR sem_overview (7), .BR signal-safety (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_unlink.3 b/man3/sem_unlink.3 index bcf7a7d7a..0110bdae1 100644 --- a/man3/sem_unlink.3 +++ b/man3/sem_unlink.3 @@ -80,7 +80,7 @@ POSIX.1-2001, POSIX.1-2008. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sem_wait.3 b/man3/sem_wait.3 index 114ab0ea1..6eb946c0c 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -272,7 +272,7 @@ main(int argc, char *argv[]) .BR sem_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index 2604b95e1..07484d024 100644 --- a/man3/setaliasent.3 +++ b/man3/setaliasent.3 @@ -173,7 +173,7 @@ main(void) .\" Yellow Pages .\" newaliases, postalias .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setbuf.3 b/man3/setbuf.3 index 8697958a7..ea1446f84 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -224,7 +224,7 @@ main(void) .BR printf (3), .BR puts (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setenv.3 b/man3/setenv.3 index 46d5f862e..1a08ee2a1 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -172,7 +172,7 @@ however, versions of glibc before 2.3.4 allowed an \(aq=\(aq sign in .BR putenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setjmp.3 b/man3/setjmp.3 index cec3001bf..449cba15a 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -328,7 +328,7 @@ returning from the initial call to .BR signal (7), .BR signal-safety (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlocale.3 b/man3/setlocale.3 index c1eb7f28e..d98d7d242 100644 --- a/man3/setlocale.3 +++ b/man3/setlocale.3 @@ -212,7 +212,7 @@ The remaining categories are GNU extensions. .BR charsets (7), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index c1c95ce73..92a951b7e 100644 --- a/man3/setlogmask.3 +++ b/man3/setlogmask.3 @@ -93,7 +93,7 @@ POSIX.1-2001, POSIX.1-2008. .BR openlog (3), .BR syslog (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 4ffb44191..6bd6e7478 100644 --- a/man3/setnetgrent.3 +++ b/man3/setnetgrent.3 @@ -156,7 +156,7 @@ returns void. .BR setprotoent (3), .BR setservent (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/shm_open.3 b/man3/shm_open.3 index 619c10197..2548bdab3 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -299,7 +299,7 @@ filesystem that is normally mounted under .BR umask (2), .BR shm_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index aa52f21a9..45ae3c2b6 100644 --- a/man3/siginterrupt.3 +++ b/man3/siginterrupt.3 @@ -108,7 +108,7 @@ flag instead. .SH SEE ALSO .BR signal (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/signbit.3 b/man3/signbit.3 index 21736e5ff..d6dd18eca 100644 --- a/man3/signbit.3 +++ b/man3/signbit.3 @@ -73,7 +73,7 @@ recommended functions in IEEE 754/IEEE 854). .SH SEE ALSO .BR copysign (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/significand.3 b/man3/significand.3 index 25199894c..4a7fe6e44 100644 --- a/man3/significand.3 +++ b/man3/significand.3 @@ -76,7 +76,7 @@ version is available on a number of other systems. .BR ilogb (3), .BR scalb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigpause.3 b/man3/sigpause.3 index 67c25cf6f..4f01a55af 100644 --- a/man3/sigpause.3 +++ b/man3/sigpause.3 @@ -139,7 +139,7 @@ should be amended to use .BR sigvec (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigqueue.3 b/man3/sigqueue.3 index d7dde72b2..e0b523193 100644 --- a/man3/sigqueue.3 +++ b/man3/sigqueue.3 @@ -172,7 +172,7 @@ uinfo.si_value = val; /* Argument supplied to sigqueue() */ .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigset.3 b/man3/sigset.3 index 6be67daa0..d06bdc01f 100644 --- a/man3/sigset.3 +++ b/man3/sigset.3 @@ -290,7 +290,7 @@ These problems have been fixed since glibc 2.5. .BR sigvec (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigsetops.3 b/man3/sigsetops.3 index 9dfb293ad..aefb1cec9 100644 --- a/man3/sigsetops.3 +++ b/man3/sigsetops.3 @@ -206,7 +206,7 @@ functions) and their use should be avoided in portable applications. .BR sigprocmask (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigvec.3 b/man3/sigvec.3 index cbd987357..53377bc9f 100644 --- a/man3/sigvec.3 +++ b/man3/sigvec.3 @@ -288,7 +288,7 @@ for details. .BR sigset (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigwait.3 b/man3/sigwait.3 index c28196672..32dc262e2 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -121,7 +121,7 @@ See .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sin.3 b/man3/sin.3 index be4ced782..5a9927c4b 100644 --- a/man3/sin.3 +++ b/man3/sin.3 @@ -137,7 +137,7 @@ when a domain error occurred. .BR sincos (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sincos.3 b/man3/sincos.3 index 257ed56d7..08a67a93d 100644 --- a/man3/sincos.3 +++ b/man3/sincos.3 @@ -108,7 +108,7 @@ cc -O \-lm \-fno\-builtin prog.c .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sinh.3 b/man3/sinh.3 index 68b0471c1..0a67d9182 100644 --- a/man3/sinh.3 +++ b/man3/sinh.3 @@ -144,7 +144,7 @@ SVr4, 4.3BSD, C89. .BR csinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sleep.3 b/man3/sleep.3 index b1188c328..b82661be5 100644 --- a/man3/sleep.3 +++ b/man3/sleep.3 @@ -91,7 +91,7 @@ while sleeping will cause undefined results. .BR signal (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index 0104f5be4..823a76cc2 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -149,7 +149,7 @@ and then read the byte of data at the mark: .BR send (2), .BR tcp (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sqrt.3 b/man3/sqrt.3 index a1b69fef0..bf96b080d 100644 --- a/man3/sqrt.3 +++ b/man3/sqrt.3 @@ -124,7 +124,7 @@ SVr4, 4.3BSD, C89. .BR csqrt (3), .BR hypot (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/statvfs.3 b/man3/statvfs.3 index e7facfbc4..a146a0efa 100644 --- a/man3/statvfs.3 +++ b/man3/statvfs.3 @@ -257,7 +257,7 @@ with the argument .SH SEE ALSO .BR statfs (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdarg.3 b/man3/stdarg.3 index d0cae2c2e..146d03796 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -309,7 +309,7 @@ foo(char *fmt, ...) /* '...' is C syntax for a variadic function */ } .EE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdin.3 b/man3/stdin.3 index 10825a23a..89980c139 100644 --- a/man3/stdin.3 +++ b/man3/stdin.3 @@ -158,7 +158,7 @@ and .BR fopen (3), .BR stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdio.3 b/man3/stdio.3 index 70f3d990e..e7e97eeb1 100644 --- a/man3/stdio.3 +++ b/man3/stdio.3 @@ -254,7 +254,7 @@ library conforms to C89. .BR stdout (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdio_ext.3 b/man3/stdio_ext.3 index 2f54949e4..6c5f3dbb0 100644 --- a/man3/stdio_ext.3 +++ b/man3/stdio_ext.3 @@ -151,7 +151,7 @@ T} Thread safety MT-Safe .BR flockfile (3), .BR fpurge (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index ab4d383fd..6bfe1f710 100644 --- a/man3/stpcpy.3 +++ b/man3/stpcpy.3 @@ -129,7 +129,7 @@ main(void) .BR string (3), .BR wcpcpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpncpy.3 b/man3/stpncpy.3 index be87e43f3..4a73fa6fe 100644 --- a/man3/stpncpy.3 +++ b/man3/stpncpy.3 @@ -108,7 +108,7 @@ It first appeared in version 1.07 of the GNU C library in 1993. .BR strncpy (3), .BR wcpncpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index 4ccf7840b..1363a7583 100644 --- a/man3/strcasecmp.3 +++ b/man3/strcasecmp.3 @@ -124,7 +124,7 @@ Otherwise, the results are unspecified. .BR wcscasecmp (3), .BR wcsncasecmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcat.3 b/man3/strcat.3 index 30767e313..cda04c8b3 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -233,7 +233,7 @@ main(int argc, char *argv[]) .BR wcscat (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strchr.3 b/man3/strchr.3 index 9b592e6dd..5fff107ae 100644 --- a/man3/strchr.3 +++ b/man3/strchr.3 @@ -137,7 +137,7 @@ is a GNU extension. .BR wcschr (3), .BR wcsrchr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcmp.3 b/man3/strcmp.3 index eccdd3306..dad97e1f9 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -104,7 +104,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR wcscmp (3), .BR wcsncmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcoll.3 b/man3/strcoll.3 index 01fe4817d..2b89a0da9 100644 --- a/man3/strcoll.3 +++ b/man3/strcoll.3 @@ -99,7 +99,7 @@ is equivalent to .BR string (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcpy.3 b/man3/strcpy.3 index a43d4188b..5cfc67a83 100644 --- a/man3/strcpy.3 +++ b/man3/strcpy.3 @@ -242,7 +242,7 @@ in ways that may make the impossible possible. .BR wcscpy (3), .BR wcsncpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strdup.3 b/man3/strdup.3 index eac1d5c54..9cda7388f 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -154,7 +154,7 @@ are GNU extensions. .BR string (3), .BR wcsdup (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strerror.3 b/man3/strerror.3 index c064647fc..aa93711e9 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -271,7 +271,7 @@ error when calling .BR strsignal (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfmon.3 b/man3/strfmon.3 index 248135965..f0dbda818 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -218,7 +218,7 @@ locales yield .BR sprintf (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfromd.3 b/man3/strfromd.3 index ecd569eb0..594d420e3 100644 --- a/man3/strfromd.3 +++ b/man3/strfromd.3 @@ -250,7 +250,7 @@ strfromd(s, ssize, "%.E", 12.345e19); .BR snprintf (3), .BR strtod (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfry.3 b/man3/strfry.3 index da022849c..072f9b6f4 100644 --- a/man3/strfry.3 +++ b/man3/strfry.3 @@ -71,7 +71,7 @@ GNU C Library. .BR memfrob (3), .BR string (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strftime.3 b/man3/strftime.3 index bb1df7615..cdd2fa9f0 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -655,7 +655,7 @@ main(int argc, char *argv[]) .BR sprintf (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/string.3 b/man3/string.3 index 49d6c9cfe..ee2a6a56d 100644 --- a/man3/string.3 +++ b/man3/string.3 @@ -231,7 +231,7 @@ See the individual man pages for descriptions of each function. .BR strtok (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strlen.3 b/man3/strlen.3 index ff517b94f..74ddb7cb0 100644 --- a/man3/strlen.3 +++ b/man3/strlen.3 @@ -67,7 +67,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, C11, SVr4, 4.3BSD. .BR wcslen (3), .BR wcsnlen (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strnlen.3 b/man3/strnlen.3 index 3650fae9e..5db52d06f 100644 --- a/man3/strnlen.3 +++ b/man3/strnlen.3 @@ -85,7 +85,7 @@ POSIX.1-2008. .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index f1149631c..afef24db5 100644 --- a/man3/strpbrk.3 +++ b/man3/strpbrk.3 @@ -79,7 +79,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR strtok (3), .BR wcspbrk (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strptime.3 b/man3/strptime.3 index c51096c70..1c1142bf5 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -444,7 +444,7 @@ main(void) .BR setlocale (3), .BR strftime (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsep.3 b/man3/strsep.3 index 3c124aea9..9e8b3731d 100644 --- a/man3/strsep.3 +++ b/man3/strsep.3 @@ -122,7 +122,7 @@ The identity of the delimiting character is lost. .BR strstr (3), .BR strtok (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsignal.3 b/man3/strsignal.3 index fc00d0cfa..cbdeb9822 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -101,7 +101,7 @@ Present on Solaris and the BSDs. .BR psignal (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strspn.3 b/man3/strspn.3 index 86ccd9e4f..d552e1e28 100644 --- a/man3/strspn.3 +++ b/man3/strspn.3 @@ -99,7 +99,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR wcscspn (3), .BR wcsspn (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strstr.3 b/man3/strstr.3 index b652ad974..01e40980f 100644 --- a/man3/strstr.3 +++ b/man3/strstr.3 @@ -110,7 +110,7 @@ function is a nonstandard extension. .BR strtok (3), .BR wcsstr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtod.3 b/man3/strtod.3 index 646c4bef6..f09c4baf6 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -213,7 +213,7 @@ the use of the functions described in this manual page is similar. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoimax.3 b/man3/strtoimax.3 index cd1566be0..c4cc69373 100644 --- a/man3/strtoimax.3 +++ b/man3/strtoimax.3 @@ -76,7 +76,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR strtoul (3), .BR wcstoimax (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtok.3 b/man3/strtok.3 index 012d180e0..f86bc9d6b 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -29,7 +29,7 @@ .\" 2005-11-17, mtk: Substantial parts rewritten .\" 2013-05-19, mtk: added much further detail on the operation of strtok() .\" -.TH STRTOK 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH STRTOK 3 2019-10-10 "GNU" "Linux Programmer's Manual" .SH NAME strtok, strtok_r \- extract tokens from strings .SH SYNOPSIS @@ -146,12 +146,13 @@ On the first call to .BR strtok_r (), .I str should point to the string to be parsed, and the value of -.I saveptr -is ignored. +.I *saveptr +is ignored (but see NOTES). In subsequent calls, .I str should be NULL, and .I saveptr +(and the buffer that it points to) should be unchanged since the previous call. .PP Different strings may be parsed concurrently using sequences of calls to @@ -188,6 +189,14 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .TP .BR strtok_r () POSIX.1-2001, POSIX.1-2008. +.SH NOTES +On some implementations, +.\" Tru64, according to its manual page +.I *saveptr +is required to be NULL on the first call to +.BR strtok_r () +that is being used to parse +.IR str . .SH BUGS Be cautious when using these functions. If you do use them, note that: @@ -283,7 +292,7 @@ can be found in .BR strstr (3), .BR wcstok (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtol.3 b/man3/strtol.3 index 792efb55c..1990db646 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:53:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Added correction due to nsd@bbc.com (Nick Duffek) - aeb, 950610 -.TH STRTOL 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH STRTOL 3 2019-10-10 "GNU" "Linux Programmer's Manual" .SH NAME strtol, strtoll, strtoq \- convert a string to a long integer .SH SYNOPSIS @@ -299,10 +299,10 @@ main(int argc, char *argv[]) .BR atoi (3), .BR atol (3), .BR strtod (3), -.BR strtoul (3), .BR strtoimax (3) +.BR strtoul (3), .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 0203b11c4..b6fbadcee 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -231,7 +231,7 @@ the use of the functions described in this manual page is similar. .BR strtol (3), .BR strtoumax (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index dfc5d4dd4..02053d07f 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -157,7 +157,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR strcoll (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index 0919896a0..ca94d5561 100644 --- a/man3/strxfrm.3 +++ b/man3/strxfrm.3 @@ -96,7 +96,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .BR strcoll (3), .BR string (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/swab.3 b/man3/swab.3 index 9ac4efe54..35d75eebe 100644 --- a/man3/swab.3 +++ b/man3/swab.3 @@ -86,7 +86,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .SH SEE ALSO .BR bstring (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sysconf.3 b/man3/sysconf.3 index 8645e4b00..5d917b1c6 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -401,7 +401,7 @@ memory. .BR pathconf (3), .BR posixoptions (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/syslog.3 b/man3/syslog.3 index 81dfb1f16..6f44c3e02 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -363,7 +363,7 @@ syslog(priority, "%s", string); .BR syslog.conf (5), .BR syslogd (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/system.3 b/man3/system.3 index 360ea3d8d..71af35b19 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -261,7 +261,7 @@ from a privileged program. .BR exec (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sysv_signal.3 b/man3/sysv_signal.3 index 9c5332c64..2fecf36c1 100644 --- a/man3/sysv_signal.3 +++ b/man3/sysv_signal.3 @@ -102,7 +102,7 @@ feature test macro is defined. .BR bsd_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tan.3 b/man3/tan.3 index 1186b28db..9b66babfc 100644 --- a/man3/tan.3 +++ b/man3/tan.3 @@ -161,7 +161,7 @@ when a domain error occurred. .BR ctan (3), .BR sin (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tanh.3 b/man3/tanh.3 index b0e346454..3fdecde3a 100644 --- a/man3/tanh.3 +++ b/man3/tanh.3 @@ -120,7 +120,7 @@ SVr4, 4.3BSD, C89. .BR ctanh (3), .BR sinh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetpgrp.3 b/man3/tcgetpgrp.3 index f31ebaad3..60811ff5f 100644 --- a/man3/tcgetpgrp.3 +++ b/man3/tcgetpgrp.3 @@ -135,7 +135,7 @@ The functions are POSIX inventions. .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index 0734d149a..280b3c820 100644 --- a/man3/tcgetsid.3 +++ b/man3/tcgetsid.3 @@ -85,7 +85,7 @@ since Linux 2.1.71. .SH SEE ALSO .BR getsid (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/telldir.3 b/man3/telldir.3 index 92766b006..4e291d1b3 100644 --- a/man3/telldir.3 +++ b/man3/telldir.3 @@ -109,7 +109,7 @@ assumptions about its contents. .BR scandir (3), .BR seekdir (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tempnam.3 b/man3/tempnam.3 index d112ba8f7..9658cfcbc 100644 --- a/man3/tempnam.3 +++ b/man3/tempnam.3 @@ -186,7 +186,7 @@ it is unspecified how accessibility of a directory is determined. .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/termios.3 b/man3/termios.3 index 0c14bf450..3e70fb338 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -1112,7 +1112,7 @@ mask). .BR ioctl_tty (2), .BR setserial (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tgamma.3 b/man3/tgamma.3 index a308dfa4b..36f62efdd 100644 --- a/man3/tgamma.3 +++ b/man3/tgamma.3 @@ -216,7 +216,7 @@ exception raised), rather than a pole error. .BR gamma (3), .BR lgamma (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timegm.3 b/man3/timegm.3 index 6d4ab0492..0ba867d43 100644 --- a/man3/timegm.3 +++ b/man3/timegm.3 @@ -104,7 +104,7 @@ There is no reason to ever use it. .BR mktime (3), .BR tzset (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timeradd.3 b/man3/timeradd.3 index 1cf28471a..29145e8e3 100644 --- a/man3/timeradd.3 +++ b/man3/timeradd.3 @@ -154,7 +154,7 @@ Present on most BSD derivatives. .BR gettimeofday (2), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index 590c97533..6991c4ca0 100644 --- a/man3/tmpfile.3 +++ b/man3/tmpfile.3 @@ -114,7 +114,7 @@ and if that fails the directory .BR tempnam (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index c3f72613e..4396f0079 100644 --- a/man3/tmpnam.3 +++ b/man3/tmpnam.3 @@ -181,7 +181,7 @@ instead. .BR tempnam (3), .BR tmpfile (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toascii.3 b/man3/toascii.3 index 35dc213ba..b54bd19b2 100644 --- a/man3/toascii.3 +++ b/man3/toascii.3 @@ -79,7 +79,7 @@ This function will convert accented letters into random characters. .BR tolower (3), .BR toupper (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toupper.3 b/man3/toupper.3 index f3338ef84..dd987e41c 100644 --- a/man3/toupper.3 +++ b/man3/toupper.3 @@ -189,7 +189,7 @@ the German sharp s is one example. .BR uselocale (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towctrans.3 b/man3/towctrans.3 index 86d7c6638..469ab6e58 100644 --- a/man3/towctrans.3 +++ b/man3/towctrans.3 @@ -78,7 +78,7 @@ current locale. .BR towupper (3), .BR wctrans (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towlower.3 b/man3/towlower.3 index 66be724f6..a7d451a70 100644 --- a/man3/towlower.3 +++ b/man3/towlower.3 @@ -127,7 +127,7 @@ because Unicode knows about three cases: upper, lower and title case. .BR towupper (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towupper.3 b/man3/towupper.3 index 07a2822e5..5a10ee92b 100644 --- a/man3/towupper.3 +++ b/man3/towupper.3 @@ -127,7 +127,7 @@ because Unicode knows about three cases: upper, lower and title case. .BR towlower (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/trunc.3 b/man3/trunc.3 index 67b88dc1f..84f0d0241 100644 --- a/man3/trunc.3 +++ b/man3/trunc.3 @@ -99,7 +99,7 @@ before assigning it to an integer type. .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tsearch.3 b/man3/tsearch.3 index 76c21aec4..4d84ae9a5 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -346,7 +346,7 @@ main(void) .BR lsearch (3), .BR qsort (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyname.3 b/man3/ttyname.3 index 33bb19f2f..786ee3b82 100644 --- a/man3/ttyname.3 +++ b/man3/ttyname.3 @@ -24,7 +24,7 @@ .\" Modified 2001-12-13, Martin Schulze <joey@infodrom.org> .\" Added ttyname_r, aeb, 2002-07-20 .\" -.TH TTYNAME 3 2017-05-03 "Linux" "Linux Programmer's Manual" +.TH TTYNAME 3 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME ttyname, ttyname_r \- return name of a terminal .SH SYNOPSIS @@ -64,6 +64,11 @@ returns 0 on success, and an error number upon error. .B EBADF Bad file descriptor. .TP +.\" glibc commit 15e9a4f378c8607c2ae1aa465436af4321db0e23 +.B ENODEV +File descriptor refers to a slave pseudoterminal device +but the corresponding pathname could not be found (see NOTES). +.TP .B ENOTTY File descriptor does not refer to a terminal device. .TP @@ -71,11 +76,6 @@ File descriptor does not refer to a terminal device. .RB ( ttyname_r ()) .I buflen was too small to allow storing the pathname. -.TP -.\" glibc commit 15e9a4f378c8607c2ae1aa465436af4321db0e23 -.B ENODEV -File descriptor refers to a slave pseudoterminal device -but the corresponding pathname could not be found (see NOTES). .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -118,7 +118,7 @@ to .BR isatty (3), .BR pts (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index f282448c1..41e10e8c9 100644 --- a/man3/ttyslot.3 +++ b/man3/ttyslot.3 @@ -184,7 +184,7 @@ Minix also has .BR ttyname (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tzset.3 b/man3/tzset.3 index d8883cf01..cb3530849 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -249,7 +249,7 @@ otherwise the daylight saving time version. .BR getenv (3), .BR tzfile (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ualarm.3 b/man3/ualarm.3 index 19cb79986..f11088a8c 100644 --- a/man3/ualarm.3 +++ b/man3/ualarm.3 @@ -160,7 +160,7 @@ instead. .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ulimit.3 b/man3/ulimit.3 index bc6bb1df0..3319c9cd1 100644 --- a/man3/ulimit.3 +++ b/man3/ulimit.3 @@ -99,7 +99,7 @@ as obsolete. .BR setrlimit (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/undocumented.3 b/man3/undocumented.3 index 5d3cc9044..7b4be8dda 100644 --- a/man3/undocumented.3 +++ b/man3/undocumented.3 @@ -177,7 +177,7 @@ for inclusion in the next man page release. .BR yp_unbind (3), .BR yp_update (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ungetwc.3 b/man3/ungetwc.3 index 3f86aca85..2924f5f95 100644 --- a/man3/ungetwc.3 +++ b/man3/ungetwc.3 @@ -98,7 +98,7 @@ current locale. .SH SEE ALSO .BR fgetwc (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index 9936f5cf3..2770b2551 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -181,7 +181,7 @@ They should probably not be used. .BR flockfile (3), .BR stdio (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index 78a2dedfe..285993be9 100644 --- a/man3/unlockpt.3 +++ b/man3/unlockpt.3 @@ -80,7 +80,7 @@ POSIX.1-2001, POSIX.1-2008. .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/updwtmp.3 b/man3/updwtmp.3 index 3abe73547..4351f3006 100644 --- a/man3/updwtmp.3 +++ b/man3/updwtmp.3 @@ -97,7 +97,7 @@ structure as its last argument. .BR getutxent (3), .BR wtmp (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/uselocale.3 b/man3/uselocale.3 index a743c3927..2fe9f5170 100644 --- a/man3/uselocale.3 +++ b/man3/uselocale.3 @@ -124,7 +124,7 @@ and .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/usleep.3 b/man3/usleep.3 index d1f79e28c..ba856ce4e 100644 --- a/man3/usleep.3 +++ b/man3/usleep.3 @@ -160,7 +160,7 @@ is unspecified. .BR ualarm (3), .BR time (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpcpy.3 b/man3/wcpcpy.3 index 966ea4c77..7228a8e72 100644 --- a/man3/wcpcpy.3 +++ b/man3/wcpcpy.3 @@ -82,7 +82,7 @@ POSIX.1-2008. .BR strcpy (3), .BR wcscpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpncpy.3 b/man3/wcpncpy.3 index d7e4fbb26..9aca8f29a 100644 --- a/man3/wcpncpy.3 +++ b/man3/wcpncpy.3 @@ -108,7 +108,7 @@ POSIX.1-2008. .BR stpncpy (3), .BR wcsncpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index c90a7785b..5e595e5a0 100644 --- a/man3/wcrtomb.3 +++ b/man3/wcrtomb.3 @@ -136,7 +136,7 @@ is not multithread safe. .BR mbsinit (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscasecmp.3 b/man3/wcscasecmp.3 index e7c166230..84b5733fe 100644 --- a/man3/wcscasecmp.3 +++ b/man3/wcscasecmp.3 @@ -107,7 +107,7 @@ current locale. .BR strcasecmp (3), .BR wcscmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscat.3 b/man3/wcscat.3 index f55f2a94f..43c320a92 100644 --- a/man3/wcscat.3 +++ b/man3/wcscat.3 @@ -65,7 +65,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcscpy (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcschr.3 b/man3/wcschr.3 index 4dd62489a..39b74cecd 100644 --- a/man3/wcschr.3 +++ b/man3/wcschr.3 @@ -65,7 +65,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcsstr (3), .BR wmemchr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscmp.3 b/man3/wcscmp.3 index 2e04c2471..cb5babf8d 100644 --- a/man3/wcscmp.3 +++ b/man3/wcscmp.3 @@ -75,7 +75,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcscasecmp (3), .BR wmemcmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscpy.3 b/man3/wcscpy.3 index 719f5a723..7326c11b8 100644 --- a/man3/wcscpy.3 +++ b/man3/wcscpy.3 @@ -67,7 +67,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcsdup (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscspn.3 b/man3/wcscspn.3 index ccdd9ae20..74c6920c3 100644 --- a/man3/wcscspn.3 +++ b/man3/wcscspn.3 @@ -77,7 +77,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcspbrk (3), .BR wcsspn (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsdup.3 b/man3/wcsdup.3 index 75d974973..3ddae9fb9 100644 --- a/man3/wcsdup.3 +++ b/man3/wcsdup.3 @@ -89,7 +89,7 @@ and is not widely available on other systems. .BR strdup (3), .BR wcscpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcslen.3 b/man3/wcslen.3 index bddd96e55..327b8d841 100644 --- a/man3/wcslen.3 +++ b/man3/wcslen.3 @@ -56,7 +56,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3 index 5661596c2..dc6418487 100644 --- a/man3/wcsncasecmp.3 +++ b/man3/wcsncasecmp.3 @@ -112,7 +112,7 @@ current locale. .BR strncasecmp (3), .BR wcsncmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncat.3 b/man3/wcsncat.3 index fc8a833c5..d3ac39314 100644 --- a/man3/wcsncat.3 +++ b/man3/wcsncat.3 @@ -66,7 +66,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR strncat (3), .BR wcscat (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncmp.3 b/man3/wcsncmp.3 index 504e529f2..f4bb45e4e 100644 --- a/man3/wcsncmp.3 +++ b/man3/wcsncmp.3 @@ -88,7 +88,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR strncmp (3), .BR wcsncasecmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3 index 223b011dd..7106bf328 100644 --- a/man3/wcsncpy.3 +++ b/man3/wcsncpy.3 @@ -83,7 +83,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .SH SEE ALSO .BR strncpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index 948f3b623..98e0114c3 100644 --- a/man3/wcsnlen.3 +++ b/man3/wcsnlen.3 @@ -97,7 +97,7 @@ POSIX.1-2008. .BR strnlen (3), .BR wcslen (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index a140bec15..9ee61cc03 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -188,7 +188,7 @@ is not multithread safe. .BR mbsinit (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcspbrk.3 b/man3/wcspbrk.3 index 932ef1011..05ffe2399 100644 --- a/man3/wcspbrk.3 +++ b/man3/wcspbrk.3 @@ -65,7 +65,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcschr (3), .BR wcscspn (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrchr.3 b/man3/wcsrchr.3 index ec45a2d56..21e8f35ed 100644 --- a/man3/wcsrchr.3 +++ b/man3/wcsrchr.3 @@ -62,7 +62,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR strrchr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index 5946711d1..7909205ae 100644 --- a/man3/wcsrtombs.3 +++ b/man3/wcsrtombs.3 @@ -156,7 +156,7 @@ is not multithread safe. .BR wcsnrtombs (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsspn.3 b/man3/wcsspn.3 index cc0bc64f1..172418861 100644 --- a/man3/wcsspn.3 +++ b/man3/wcsspn.3 @@ -75,7 +75,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR strspn (3), .BR wcscspn (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsstr.3 b/man3/wcsstr.3 index 6d44e10f1..d910ffd14 100644 --- a/man3/wcsstr.3 +++ b/man3/wcsstr.3 @@ -71,7 +71,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR strstr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstoimax.3 b/man3/wcstoimax.3 index 8753db896..5db95424a 100644 --- a/man3/wcstoimax.3 +++ b/man3/wcstoimax.3 @@ -68,7 +68,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wcstol (3), .BR wcstoul (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstok.3 b/man3/wcstok.3 index bf27541b3..50f87cb00 100644 --- a/man3/wcstok.3 +++ b/man3/wcstok.3 @@ -112,7 +112,7 @@ for (token = wcstok(wcs, " \et\en", &state); .BR strtok (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index de1b9a84c..221ab281d 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -120,7 +120,7 @@ provides a better interface to the same functionality. .BR wcsrtombs (3) .BR wctomb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcswidth.3 b/man3/wcswidth.3 index 2deceb774..f81c3c8a6 100644 --- a/man3/wcswidth.3 +++ b/man3/wcswidth.3 @@ -69,7 +69,7 @@ current locale. .BR iswprint (3), .BR wcwidth (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctob.3 b/man3/wctob.3 index 4f9ac006b..bd80ac240 100644 --- a/man3/wctob.3 +++ b/man3/wctob.3 @@ -83,7 +83,7 @@ instead. .BR wcrtomb (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctomb.3 b/man3/wctomb.3 index 30129081f..e24f6736f 100644 --- a/man3/wctomb.3 +++ b/man3/wctomb.3 @@ -115,7 +115,7 @@ a better interface to the same functionality. .BR wcrtomb (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctrans.3 b/man3/wctrans.3 index 78ae5a404..18465dfcd 100644 --- a/man3/wctrans.3 +++ b/man3/wctrans.3 @@ -84,7 +84,7 @@ current locale. .SH SEE ALSO .BR towctrans (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctype.3 b/man3/wctype.3 index d05969f7b..293ec439d 100644 --- a/man3/wctype.3 +++ b/man3/wctype.3 @@ -96,7 +96,7 @@ current locale. .SH SEE ALSO .BR iswctype (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcwidth.3 b/man3/wcwidth.3 index 60ef4d564..5c9762941 100644 --- a/man3/wcwidth.3 +++ b/man3/wcwidth.3 @@ -73,7 +73,7 @@ current locale. .BR iswprint (3), .BR wcswidth (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemchr.3 b/man3/wmemchr.3 index 6edc6dfb3..102ee785b 100644 --- a/man3/wmemchr.3 +++ b/man3/wmemchr.3 @@ -66,7 +66,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR memchr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcmp.3 b/man3/wmemcmp.3 index 70e112eeb..d2f802956 100644 --- a/man3/wmemcmp.3 +++ b/man3/wmemcmp.3 @@ -85,7 +85,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR memcmp (3), .BR wcscmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcpy.3 b/man3/wmemcpy.3 index cd46ae6c4..ab76c31cb 100644 --- a/man3/wmemcpy.3 +++ b/man3/wmemcpy.3 @@ -69,7 +69,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR wmemmove (3), .BR wmempcpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemmove.3 b/man3/wmemmove.3 index 82d59a08f..fc0d91ae4 100644 --- a/man3/wmemmove.3 +++ b/man3/wmemmove.3 @@ -65,7 +65,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemset.3 b/man3/wmemset.3 index a87fd0508..6c5ec77d4 100644 --- a/man3/wmemset.3 +++ b/man3/wmemset.3 @@ -57,7 +57,7 @@ POSIX.1-2001, POSIX.1-2008, C99. .SH SEE ALSO .BR memset (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 464cba53a..d86611f3a 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -248,7 +248,7 @@ main(int argc, char **argv) .BR fnmatch (3), .BR glob (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 1759d5df9..1c07a17fb 100644 --- a/man3/wprintf.3 +++ b/man3/wprintf.3 @@ -273,7 +273,7 @@ followed by .BR snprintf (3) .\" .BR wscanf (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xcrypt.3 b/man3/xcrypt.3 index d95634854..59b0fb8e9 100644 --- a/man3/xcrypt.3 +++ b/man3/xcrypt.3 @@ -90,7 +90,7 @@ The prototypes are missing from the abovementioned include file. .SH SEE ALSO .BR cbc_crypt (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xdr.3 b/man3/xdr.3 index b601fd698..ec2921ab0 100644 --- a/man3/xdr.3 +++ b/man3/xdr.3 @@ -621,7 +621,7 @@ RFC\ 1014, Sun Microsystems, Inc., USC-ISI. .RE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -275,7 +275,7 @@ when a domain error occurs. .SH SEE ALSO .BR j0 (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cciss.4 b/man4/cciss.4 index d7ad67964..6b65fcbac 100644 --- a/man4/cciss.4 +++ b/man4/cciss.4 @@ -380,7 +380,7 @@ in the Linux kernel source tree .\" Charles White, Francis Wiran .\" and probably some other people. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/console_codes.4 b/man4/console_codes.4 index 78a4c2ee0..4373b154a 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -652,7 +652,7 @@ It is ignored. .BR ioctl_console (2), .BR charsets (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cpuid.4 b/man4/cpuid.4 index 8eeb0c5f4..f4941bb81 100644 --- a/man4/cpuid.4 +++ b/man4/cpuid.4 @@ -100,7 +100,7 @@ Instruction Set Reference, A-M, 3-180 CPUID reference. Intel Corporation, Intel Processor Identification and the CPUID Instruction, Application note 485. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/dsp56k.4 b/man4/dsp56k.4 index d46dc3ca9..7ca14fd7b 100644 --- a/man4/dsp56k.4 +++ b/man4/dsp56k.4 @@ -119,7 +119,7 @@ user-defined command handled by the program running in the DSP56001. .UE , DSP56000/DSP56001 Digital Signal Processor User's Manual .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -232,7 +232,7 @@ This used to be common with older 8-inch floppies. .BR mount (8), .BR setfdprm (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/full.4 b/man4/full.4 index e481e78af..85cfc1369 100644 --- a/man4/full.4 +++ b/man4/full.4 @@ -65,7 +65,7 @@ will always succeed. .BR null (4), .BR zero (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/fuse.4 b/man4/fuse.4 index 329451dca..3b0bace4f 100644 --- a/man4/fuse.4 +++ b/man4/fuse.4 @@ -559,7 +559,7 @@ The following messages are not yet documented in this manual page: .BR fusermount (1), .BR mount.fuse (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -100,7 +100,7 @@ chown root:disk /dev/hd* .BR sd (4), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/hpsa.4 b/man4/hpsa.4 index 850a7e0a1..bd294e882 100644 --- a/man4/hpsa.4 +++ b/man4/hpsa.4 @@ -235,7 +235,7 @@ in the Linux kernel source tree .\" Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel .\" and probably some other people. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/initrd.4 b/man4/initrd.4 index d1228ebc5..ffef90419 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -498,7 +498,7 @@ before Linux 4.10) in the Linux kernel source tree, the LILO documentation, the LOADLIN documentation, the SYSLINUX documentation .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/intro.4 b/man4/intro.4 index 84da91bf7..cb9dbe323 100644 --- a/man4/intro.4 +++ b/man4/intro.4 @@ -40,7 +40,7 @@ Note that these can be different from page to page! .BR mknod (2), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/lirc.4 b/man4/lirc.4 index 8412b7a8a..7b13cdcd6 100644 --- a/man4/lirc.4 +++ b/man4/lirc.4 @@ -445,7 +445,7 @@ Users of older kernels could use the file bundled in .PP https://www.kernel.org/doc/html/latest/media/uapi/rc/lirc-dev.html .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/loop.4 b/man4/loop.4 index bae5fe174..3494a6a79 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -295,7 +295,7 @@ main(int argc, char *argv[]) .BR losetup (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -140,7 +140,7 @@ No argument is used. .BR lpcntl (8), .BR tunelp (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mem.4 b/man4/mem.4 index bb0256b69..aa5b48bb4 100644 --- a/man4/mem.4 +++ b/man4/mem.4 @@ -99,7 +99,7 @@ chown root:kmem /dev/port .BR mknod (1), .BR ioperm (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mouse.4 b/man4/mouse.4 index dd07d3512..6e85a6050 100644 --- a/man4/mouse.4 +++ b/man4/mouse.4 @@ -190,7 +190,7 @@ A commonly used symbolic link pointing to a mouse device. .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/msr.4 b/man4/msr.4 index 186dce7fc..911410cac 100644 --- a/man4/msr.4 +++ b/man4/msr.4 @@ -62,7 +62,7 @@ Intel Corporation Intel 64 and IA-32 Architectures Software Developer's Manual Volume 3B Appendix B, for an overview of the Intel CPU MSRs. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/null.4 b/man4/null.4 index 14593b1c7..5ff56659d 100644 --- a/man4/null.4 +++ b/man4/null.4 @@ -70,7 +70,7 @@ are interruptible by signals. .BR mknod (1), .BR full (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/pts.4 b/man4/pts.4 index ef82c0fbe..1d652694c 100644 --- a/man4/pts.4 +++ b/man4/pts.4 @@ -78,7 +78,7 @@ and one needed lots of preallocated device nodes. .BR unlockpt (3), .BR pty (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ram.4 b/man4/ram.4 index e655a8d5e..48e0462a0 100644 --- a/man4/ram.4 +++ b/man4/ram.4 @@ -46,7 +46,7 @@ chown root:disk /dev/ram .BR mknod (1), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/random.4 b/man4/random.4 index b09ee5a9e..eaa02a5c0 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -342,7 +342,7 @@ may return data prior to the entropy pool being initialized. .PP RFC\ 1750, "Randomness Recommendations for Security" .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/rtc.4 b/man4/rtc.4 index f5b9fb776..59951b166 100644 --- a/man4/rtc.4 +++ b/man4/rtc.4 @@ -341,7 +341,7 @@ capabilities that are not currently exposed by this API. .I Documentation/rtc.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -136,7 +136,7 @@ individual block partitions .\".SH SEE ALSO .\".BR scsi (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index 3146d764d..fd1c771fe 100644 --- a/man4/sk98lin.4 +++ b/man4/sk98lin.4 @@ -587,7 +587,7 @@ Report any bugs to linux@syskonnect.de .BR insmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/smartpqi.4 b/man4/smartpqi.4 index f2b7bf160..2a941a340 100644 --- a/man4/smartpqi.4 +++ b/man4/smartpqi.4 @@ -1,11 +1,12 @@ -.\" Copyright (C) 2016-2017, Microsemi Corporation +.\" Copyright (C) 2019, Microchip Technology Inc. and its subsidiaries +.\" Copyright (C) 2016-2018, Microsemi Corporation .\" Copyright (C) 2016, PMC-Sierra, Inc. .\" Written by Kevin Barnett <kevin.barnett@microsemi.com> .\" .\" %%%LICENSE_START(GPLv2_ONELINE) .\" Licensed under GNU General Public License version 2 (GPLv2) .\" %%%LICENSE_END -.TH SMARTPQI 4 2017-10-19 "Linux" "Linux Programmer's Manual" +.TH SMARTPQI 4 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME smartpqi \- Microsemi Smart Family SCSI driver .SH SYNOPSIS @@ -14,6 +15,8 @@ smartpqi \- Microsemi Smart Family SCSI driver .RB [ disable_heartbeat= { 0 | 1 }] .RB [ disable_ctrl_shutdown= { 0 | 1 }] .RB [ lockup_action= { none | reboot | panic }] +.RB [ expose_ld_first= { 0 | 1 }] +.RB [ hide_vsep= { 0 | 1 }] .YS .SH DESCRIPTION .B smartpqi @@ -90,6 +93,16 @@ parameter action \fBreboot\fP reboot the system \fBpanic\fP panic the system .TE +.TP +.BR expose_ld_first= { 0 | 1 } +This option enables support for exposing logical devices to +the operating system before physical devices. +The default value is 0. +.TP +.BR hide_vsep= { 0 | 1 } +This option enables disabling exposure of the virtual SEP to the host. +This is usually associated with direct attached drives. +The default value is 0. .SH FILES .SS Device nodes Logical drives are accessed via the SCSI disk driver @@ -149,6 +162,86 @@ above for an explanation of the .I lockup_action values. +.TP +.IR /sys/class/scsi_host/host*/driver_version +The +.I driver_version +attribute is read-only. +This attribute contains the smartpqi driver version. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_host/host1/driver_version +1.1.2-126 +.EE +.in +.TP +.IR /sys/class/scsi_host/host*/firmware_version +The +.I firmware_version +attribute is read-only. +This attribute contains the controller firmware version. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_host/host1/firmware_version +1.29-112 +.EE +.in +.TP +.IR /sys/class/scsi_host/host*/model +The +.I model +attribute is read-only. +This attribute contains the product identification string of the controller. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_host/host1/model +1100-16i +.EE +.in +.TP +.IR /sys/class/scsi_host/host*/serial_number +The +.I serial_number +attribute is read-only. +This attribute contains the unique identification number of the controller. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_host/host1/serial_number +6A316373777 +.EE +.in +.TP +.IR /sys/class/scsi_host/host*/vendor +The +.I vendor +attribute is read-only. +This attribute contains the vendor identification string of the controller. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_host/host1/vendor +Adaptec +.EE +.in .SS SmartPQI-specific disk attribute files in \f[BI]/sys\fP In the file specifications below, .I c @@ -206,7 +299,7 @@ Contains 1 if ioaccel is enabled for the volume and 0 otherwise. .IP For example: .IP -.in +2n +.in +4n .EX $ \c .B cat /sys/class/scsi_disk/1:0:3:0/device/ssd_smart_path_enabled @@ -215,7 +308,7 @@ $ \c .in .SH VERSIONS The -.B smarpqi +.B smartpqi driver was added in Linux 4.9. .SH NOTES .SS Configuration @@ -233,7 +326,7 @@ which can be found by searching for the specific controller at .I Documentation/ABI/testing/sysfs\-bus\-pci\-devices\-cciss in the Linux kernel source tree. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -959,7 +959,7 @@ or the most recent information about the driver and its configuration possibilities .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/tty.4 b/man4/tty.4 index 64a46f6ce..a454b22cc 100644 --- a/man4/tty.4 +++ b/man4/tty.4 @@ -85,7 +85,7 @@ to detach itself. .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ttyS.4 b/man4/ttyS.4 index c4a11e2e1..7c0d16f55 100644 --- a/man4/ttyS.4 +++ b/man4/ttyS.4 @@ -51,7 +51,7 @@ chown root:tty /dev/ttyS[0\-3] .BR mingetty (8), .BR setserial (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/vcs.4 b/man4/vcs.4 index 85052a8e8..4c83540b6 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -190,7 +190,7 @@ main(void) .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/veth.4 b/man4/veth.4 index 998fdb45e..a6c79b0c1 100644 --- a/man4/veth.4 +++ b/man4/veth.4 @@ -25,7 +25,7 @@ .\" %%%LICENSE_END .\" .\" -.TH veth 4 2018-02-02 "Linux" "Linux Programmer's Manual" +.TH VETH 4 2018-02-02 "Linux" "Linux Programmer's Manual" .SH NAME veth \- Virtual Ethernet Device .SH DESCRIPTION @@ -96,7 +96,7 @@ NIC statistics: .BR ip-link (8), .BR ip-netns (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man4/wavelan.4 b/man4/wavelan.4 index e77c0d86f..632ffd9cb 100644 --- a/man4/wavelan.4 +++ b/man4/wavelan.4 @@ -143,7 +143,7 @@ them by changing flags in the driver header and recompile. .BR iwpriv (8), .BR iwspy (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/acct.5 b/man5/acct.5 index 04767d986..767286547 100644 --- a/man5/acct.5 +++ b/man5/acct.5 @@ -177,7 +177,7 @@ when disk space runs low. .BR accton (8), .BR sa (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/charmap.5 b/man5/charmap.5 index d29ab8dd2..7df8c56f1 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -118,7 +118,7 @@ charmap: .BR locale (5), .BR charsets (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/core.5 b/man5/core.5 index 579bb6bb9..1f6c51a7c 100644 --- a/man5/core.5 +++ b/man5/core.5 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CORE 5 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH CORE 5 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME core \- core dump file .SH DESCRIPTION @@ -267,6 +267,26 @@ file. If the first character of this file is a pipe symbol (\fB|\fP), then the remainder of the line is interpreted as the command-line for a user-space program (or script) that is to be executed. +.PP +Since kernel 5.3.0, +.\" commit 315c69261dd3fa12dbc830d4fa00d1fad98d3b03 +the pipe template is split on spaces into an argument list +.I before +the template parameters are expanded. +In earlier kernels, the template parameters are expanded first and +the resulting string is split on spaces into an argument list. +This means that in earlier kernels executable names added by the +.I %e +and +.I %E +template parameters could get split into multiple arguments. +So the core dump handler needs to put the executable names as the last +argument and ensure it joins all parts of the executable name using spaces. +Executable names with multiple spaces in them are not correctly represented +in earlier kernels, +meaning that the core dump handler needs to use mechanisms to find +the executable name. +.PP Instead of being written to a disk file, the core dump is given as standard input to the program. Note the following points: @@ -657,7 +677,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR systemd\-coredump (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/dir_colors.5 b/man5/dir_colors.5 index b0b5028cf..898aa9d65 100644 --- a/man5/dir_colors.5 +++ b/man5/dir_colors.5 @@ -409,7 +409,7 @@ is undefined. .BR stty (1), .BR xterm (1) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/elf.5 b/man5/elf.5 index 61ac8a379..245354dcb 100644 --- a/man5/elf.5 +++ b/man5/elf.5 @@ -2192,7 +2192,7 @@ AMD64 ABI Draft, .IR "System V Application Binary Interface AMD64 Architecture Processor Supplement" . .PP .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/filesystems.5 b/man5/filesystems.5 index 4d5cd872b..4b25f09fc 100644 --- a/man5/filesystems.5 +++ b/man5/filesystems.5 @@ -237,7 +237,7 @@ It was removed from the kernel in 2.1.21. .BR mkfs (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ftpusers.5 b/man5/ftpusers.5 index dfbbc5dd8..7671b6ffc 100644 --- a/man5/ftpusers.5 +++ b/man5/ftpusers.5 @@ -55,7 +55,7 @@ Lines starting with a # are ignored. .BR proftpd (8), .BR wuftpd (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/gai.conf.5 b/man5/gai.conf.5 index fc7e4d9b4..f179b01ba 100644 --- a/man5/gai.conf.5 +++ b/man5/gai.conf.5 @@ -101,7 +101,7 @@ precedence ::ffff:0:0/96 10 .BR getaddrinfo (3), RFC\ 3484 .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/group.5 b/man5/group.5 index 30f6c7a71..f54538d50 100644 --- a/man5/group.5 +++ b/man5/group.5 @@ -73,7 +73,7 @@ up-to-date. .BR passwd (5), .BR vigr (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/host.conf.5 b/man5/host.conf.5 index 7c2cd81fc..10c47eff0 100644 --- a/man5/host.conf.5 +++ b/man5/host.conf.5 @@ -217,7 +217,7 @@ Valid values are .BR hostname (7), .BR named (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/hosts.5 b/man5/hosts.5 index bc19bf2ca..b4d467823 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -135,7 +135,7 @@ Internet RFC\ 952 .\" This manual page was written by Manoj Srivastava <srivasta@debian.org>, .\" for the Debian GNU/Linux system. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/hosts.equiv.5 b/man5/hosts.equiv.5 index cd70f7625..88904706b 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -172,7 +172,7 @@ the file is processed sequentially until the first matching rule is found. .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/intro.5 b/man5/intro.5 index 972cb891f..4add818f2 100644 --- a/man5/intro.5 +++ b/man5/intro.5 @@ -41,7 +41,7 @@ Note that these can be different from page to page! .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/issue.5 b/man5/issue.5 index 0648035bd..e58b1392a 100644 --- a/man5/issue.5 +++ b/man5/issue.5 @@ -42,7 +42,7 @@ program employed on the system. .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/locale.5 b/man5/locale.5 index 2ae743fbb..c74d5f768 100644 --- a/man5/locale.5 +++ b/man5/locale.5 @@ -1332,7 +1332,7 @@ Monday for the locale. .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/motd.5 b/man5/motd.5 index a4219e6c4..867d4268f 100644 --- a/man5/motd.5 +++ b/man5/motd.5 @@ -43,7 +43,7 @@ space than mail to all users). .BR login (1), .BR issue (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/networks.5 b/man5/networks.5 index 9680a4e95..f8f7cf846 100644 --- a/man5/networks.5 +++ b/man5/networks.5 @@ -78,7 +78,7 @@ The networks definition file. .BR netstat (8), .BR route (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nologin.5 b/man5/nologin.5 index 501c31b1a..a218211c4 100644 --- a/man5/nologin.5 +++ b/man5/nologin.5 @@ -40,7 +40,7 @@ This provides a simple way of temporarily disabling all unprivileged logins. .BR login (1), .BR shutdown (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nscd.conf.5 b/man5/nscd.conf.5 index 42880238e..f8a02b021 100644 --- a/man5/nscd.conf.5 +++ b/man5/nscd.conf.5 @@ -242,7 +242,7 @@ your distribution might differ. .\" .B nscd .\" was written by Thorsten Kukuk and Ulrich Drepper. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nss.5 b/man5/nss.5 index 31528af06..58466d81e 100644 --- a/man5/nss.5 +++ b/man5/nss.5 @@ -113,7 +113,7 @@ SETENT_BATCH_READ=FALSE .SH SEE ALSO \fInsswitch.conf\fR .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nsswitch.conf.5 b/man5/nsswitch.conf.5 index 07da29349..b7869a47d 100644 --- a/man5/nsswitch.conf.5 +++ b/man5/nsswitch.conf.5 @@ -433,7 +433,7 @@ introduced a cleaner solution to the problem. .BR getent (1), .BR nss (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/passwd.5 b/man5/passwd.5 index 7fe47d77c..95a012ad4 100644 --- a/man5/passwd.5 +++ b/man5/passwd.5 @@ -174,7 +174,7 @@ shell field yields the same result and additionally allows the use of .BR shadow (5), .BR vipw (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/proc.5 b/man5/proc.5 index 99021c947..2eb642c48 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -2641,19 +2641,19 @@ in .BR getrlimit (2)). .IP * .IR SigPnd ", " ShdPnd : - Mask (expressed in hexadecimal) +Mask (expressed in hexadecimal) of signals pending for thread and for process as a whole (see .BR pthreads (7) and .BR signal (7)). .IP * .IR SigBlk ", " SigIgn ", " SigCgt : -Masks (expressed in hexadeximal) +Masks (expressed in hexadecimal) indicating signals being blocked, ignored, and caught (see .BR signal (7)). .IP * .IR CapInh ", " CapPrm ", " CapEff : -Masks (expressed in hexadeximal) +Masks (expressed in hexadecimal) of capabilities enabled in inheritable, permitted, and effective sets (see .BR capabilities (7)). @@ -6701,7 +6701,7 @@ The Linux kernel source files: and .IR Documentation/sysctl/vm.txt . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/protocols.5 b/man5/protocols.5 index d57968dbd..aa60ba102 100644 --- a/man5/protocols.5 +++ b/man5/protocols.5 @@ -84,7 +84,7 @@ The protocols definition file. .UR http://www.iana.org\:/assignments\:/protocol\-numbers .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/repertoiremap.5 b/man5/repertoiremap.5 index c22bd28a2..3ffd7e594 100644 --- a/man5/repertoiremap.5 +++ b/man5/repertoiremap.5 @@ -77,7 +77,7 @@ A mnemonic for the Euro sign can be defined as follows: .BR charmap (5), .BR locale (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5 index 3ed4b378a..995d6a0fd 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -20,7 +20,7 @@ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" -.TH RESOLV.CONF 5 2019-03-06 "" "Linux Programmer's Manual" +.TH RESOLV.CONF 5 2019-10-10 "" "Linux Programmer's Manual" .UC 4 .SH NAME resolv.conf \- resolver configuration file @@ -104,8 +104,11 @@ traffic if the servers for the listed domains are not local, and that queries will time out if no server is available for one of the domains. .IP -The search list is currently limited to six domains +In glibc 2.25 and earlier, the search list is limited to six domains with a total of 256 characters. +Since glibc 2.26, +.\" glibc commit 3f853f22c87f0b671c0366eb290919719fa56c0e +the search list is unlimited. .TP \fBsortlist\fP This option allows addresses returned by @@ -347,7 +350,7 @@ in the first column are treated as comments. .PP Name Server Operations Guide for BIND .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/rpc.5 b/man5/rpc.5 index 33f775140..9a118cff8 100644 --- a/man5/rpc.5 +++ b/man5/rpc.5 @@ -80,7 +80,7 @@ RPC program number data base .SH SEE ALSO .BR getrpcent (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/securetty.5 b/man5/securetty.5 index 991f49ce0..8ade41ef6 100644 --- a/man5/securetty.5 +++ b/man5/securetty.5 @@ -53,7 +53,7 @@ to restrict the terminals on which empty passwords are accepted. .BR login.defs (5), .BR pam_securetty (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/services.5 b/man5/services.5 index 7a24a42fb..737375b08 100644 --- a/man5/services.5 +++ b/man5/services.5 @@ -218,7 +218,7 @@ Definition of .PP Assigned Numbers RFC, most recently RFC\ 1700, (AKA STD0002). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/shells.5 b/man5/shells.5 index 89dd834b3..dc146d989 100644 --- a/man5/shells.5 +++ b/man5/shells.5 @@ -58,7 +58,7 @@ may contain the following paths: .BR getusershell (3), .BR pam_shells (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/slabinfo.5 b/man5/slabinfo.5 index 831486832..cea05b1e6 100644 --- a/man5/slabinfo.5 +++ b/man5/slabinfo.5 @@ -239,7 +239,7 @@ The kernel source file and .IR tools/vm/slabinfo.c . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/sysfs.5 b/man5/sysfs.5 index 4babf7986..781fc371e 100644 --- a/man5/sysfs.5 +++ b/man5/sysfs.5 @@ -298,7 +298,7 @@ and various other files in and .IR Documentation/*/sysfs.txt .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/termcap.5 b/man5/termcap.5 index db7dd2712..3565fc61d 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -473,7 +473,7 @@ library, if the capabilities are missing. .BR termcap (3), .BR terminfo (5) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tmpfs.5 b/man5/tmpfs.5 index 77d84fe5d..72f28de84 100644 --- a/man5/tmpfs.5 +++ b/man5/tmpfs.5 @@ -286,7 +286,7 @@ The kernel source files and .IR Documentation/admin-guide/mm/transhuge.rst . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ttytype.5 b/man5/ttytype.5 index a2676ee0e..3f2f2e2d5 100644 --- a/man5/ttytype.5 +++ b/man5/ttytype.5 @@ -71,7 +71,7 @@ vt320 ttys0 .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tzfile.5 b/man5/tzfile.5 index a139f291c..f65809602 100644 --- a/man5/tzfile.5 +++ b/man5/tzfile.5 @@ -203,7 +203,7 @@ Future changes to the format may append more data. .\" This file is in the public domain, so clarified as of .\" 1996-06-05 by Arthur David Olson. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man5/utmp.5 b/man5/utmp.5 index b31e9bae2..ddedbb937 100644 --- a/man5/utmp.5 +++ b/man5/utmp.5 @@ -353,7 +353,7 @@ ut.ut_tv.tv_usec = tv.tv_usec; .BR logwtmp (3), .BR updwtmp (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man6/intro.6 b/man6/intro.6 index 774f38555..edbedd513 100644 --- a/man6/intro.6 +++ b/man6/intro.6 @@ -35,7 +35,7 @@ Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/address_families.7 b/man7/address_families.7 index 1d8b6ab6c..0e08ce601 100644 --- a/man7/address_families.7 +++ b/man7/address_families.7 @@ -409,7 +409,7 @@ in the Linux kernel source tree for details. .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/aio.7 b/man7/aio.7 index 2cd7ab28e..01833f221 100644 --- a/man7/aio.7 +++ b/man7/aio.7 @@ -469,7 +469,7 @@ Proceedings of the Linux Symposium, 2003, .UR https://www.kernel.org/doc/ols/2003/ols2003\-pages\-351\-366.pdf .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/armscii-8.7 b/man7/armscii-8.7 index 62418d6c0..c5cc552f7 100644 --- a/man7/armscii-8.7 +++ b/man7/armscii-8.7 @@ -138,7 +138,7 @@ _ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/arp.7 b/man7/arp.7 index 18b8ea02b..8fa692766 100644 --- a/man7/arp.7 +++ b/man7/arp.7 @@ -309,7 +309,7 @@ RFC\ 2461 for a description of IPv6 neighbor discovery and the base algorithms used. Linux 2.2+ IPv4 ARP uses the IPv6 algorithms when applicable. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ascii.7 b/man7/ascii.7 index 82a1e98b6..a6359184d 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -201,7 +201,7 @@ Standards Institute (USASI) in 1968. .BR iso_8859-9 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/attributes.7 b/man7/attributes.7 index 1db46350f..125e7d2d9 100644 --- a/man7/attributes.7 +++ b/man7/attributes.7 @@ -882,7 +882,7 @@ then the function can be regarded as safe. .SH SEE ALSO .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/boot.7 b/man7/boot.7 index e0e39c640..73de9af11 100644 --- a/man7/boot.7 +++ b/man7/boot.7 @@ -228,7 +228,7 @@ the variable values. .BR runlevel (8), .BR shutdown (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/bootparam.7 b/man7/bootparam.7 index ddc1bdb48..8f9c06268 100644 --- a/man7/bootparam.7 +++ b/man7/bootparam.7 @@ -680,7 +680,7 @@ lp=0. For up-to-date information, see the kernel source file .IR Documentation/admin-guide/kernel-parameters.txt . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/bpf-helpers.7 b/man7/bpf-helpers.7 index df48d15fa..09ea90181 100644 --- a/man7/bpf-helpers.7 +++ b/man7/bpf-helpers.7 @@ -2528,7 +2528,7 @@ pointers for network processing are listed in function \fBtc\-bpf\fP(8) .\" Generated by docutils manpage writer. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/capabilities.7 b/man7/capabilities.7 index 21ad9c1c1..b8dc7c4df 100644 --- a/man7/capabilities.7 +++ b/man7/capabilities.7 @@ -482,6 +482,11 @@ operation to suspend the tracee's seccomp protections (i.e., the flag); .IP * perform administrative operations on many device drivers. +.IP * +Modify autogroup nice values by writing to +.IR /proc/[pid]/autogroup +(see +.BR sched (7)). .RE .PD .TP @@ -1773,7 +1778,7 @@ created on the system. .I include/linux/capability.h in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cgroup_namespaces.7 b/man7/cgroup_namespaces.7 index aeaa0b2f5..7485fcc51 100644 --- a/man7/cgroup_namespaces.7 +++ b/man7/cgroup_namespaces.7 @@ -267,7 +267,7 @@ from escaping the limits imposed by ancestor cgroups. .BR namespaces (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cgroups.7 b/man7/cgroups.7 index 6648258d5..f93d67647 100644 --- a/man7/cgroups.7 +++ b/man7/cgroups.7 @@ -919,7 +919,7 @@ Changing the ownership of this file means that the delegatee can move processes into the root of the delegated subtree. .TP .IR /dlgt_grp/cgroup.subtree_control " (cgroups v2 only)" -Changing the ownership of this file means that that the delegatee +Changing the ownership of this file means that the delegatee can enable controllers (that are present in .IR /dlgt_grp/cgroup.controllers ) in order to further redistribute resources at lower levels in the subtree. @@ -1776,7 +1776,7 @@ mount option. .BR sched (7), .BR user_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/charsets.7 b/man7/charsets.7 index 4aa3901c2..420c6b0e6 100644 --- a/man7/charsets.7 +++ b/man7/charsets.7 @@ -334,7 +334,7 @@ Korean, but it is enough for most other purposes. .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/complex.7 b/man7/complex.7 index 4609198ae..cddd4957c 100644 --- a/man7/complex.7 +++ b/man7/complex.7 @@ -80,7 +80,7 @@ main(void) .BR ctan (3), .BR ctanh (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1251.7 b/man7/cp1251.7 index 473ee240a..580dbf792 100644 --- a/man7/cp1251.7 +++ b/man7/cp1251.7 @@ -184,7 +184,7 @@ CP\ 1251 is also known as Windows Cyrillic. .BR koi8-u (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1252.7 b/man7/cp1252.7 index 6a6301912..a64edb89a 100644 --- a/man7/cp1252.7 +++ b/man7/cp1252.7 @@ -174,7 +174,7 @@ CP\ 1252 is also known as Windows-1252. .BR iso_8859-15 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cpuset.7 b/man7/cpuset.7 index 2f7facdfc..01164bf27 100644 --- a/man7/cpuset.7 +++ b/man7/cpuset.7 @@ -1510,7 +1510,7 @@ in the Linux kernel source tree .IR Documentation/cpusets.txt before Linux 2.6.29) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/credentials.7 b/man7/credentials.7 index 0d4f81c60..dc04adb08 100644 --- a/man7/credentials.7 +++ b/man7/credentials.7 @@ -363,7 +363,7 @@ for further details. .BR user_namespaces (7), .BR sudo (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ddp.7 b/man7/ddp.7 index ae39ca646..348dbce9e 100644 --- a/man7/ddp.7 +++ b/man7/ddp.7 @@ -249,7 +249,7 @@ AARP tables, and other devices are not yet described. .BR capabilities (7), .BR socket (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/environ.7 b/man7/environ.7 index bdc299a52..f7fd266bc 100644 --- a/man7/environ.7 +++ b/man7/environ.7 @@ -297,7 +297,7 @@ should consider renaming their option to .BR ld.so (8), .BR pam_env (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/epoll.7 b/man7/epoll.7 index b679bf978..4b3ab51cc 100644 --- a/man7/epoll.7 +++ b/man7/epoll.7 @@ -626,7 +626,7 @@ is present in an epoll instance. .BR poll (2), .BR select (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fanotify.7 b/man7/fanotify.7 index 57e699fd7..3c97880b5 100644 --- a/man7/fanotify.7 +++ b/man7/fanotify.7 @@ -927,7 +927,7 @@ and waits until an event of type .B FAN_CREATE has occurred. The event mask indicates which type of filesystem object\(emeither -a file or a directory\(emwas created". +a file or a directory\(emwas created. Once all events have been read from the buffer and processed accordingly, the program simply terminates. .PP @@ -1008,7 +1008,7 @@ main(int argc, char **argv) struct fanotify_event_info_fid *fid; if (argc != 2) { - fprintf(stderr, "Invalid number of command line arguments.\e\n"); + fprintf(stderr, "Invalid number of command line arguments.\en"); exit(EXIT_FAILURE); } @@ -1031,7 +1031,7 @@ main(int argc, char **argv) exit(EXIT_FAILURE); } - printf("Listening for events.\e\n"); + printf("Listening for events.\en"); /* Read events from the event queue into a buffer */ @@ -1047,22 +1047,22 @@ main(int argc, char **argv) FAN_EVENT_OK(metadata, len); metadata = FAN_EVENT_NEXT(metadata, len)) { fid = (struct fanotify_event_info_fid *) (metadata + 1); - file_handle = (struct file_handle *) fid->handle; + file_handle = (struct file_handle *) fid\->handle; /* Ensure that the event info is of the correct type */ - if (fid->hdr.info_type != FAN_EVENT_INFO_TYPE_FID) { - fprintf(stderr, "Received unexpected event info type.\e\n"); + if (fid\->hdr.info_type != FAN_EVENT_INFO_TYPE_FID) { + fprintf(stderr, "Received unexpected event info type.\en"); exit(EXIT_FAILURE); } - if (metadata->mask == FAN_CREATE) + if (metadata\->mask == FAN_CREATE) printf("FAN_CREATE (file created):"); - if (metadata->mask == FAN_CREATE | FAN_ONDIR) + if (metadata\->mask == FAN_CREATE | FAN_ONDIR) printf("FAN_CREATE | FAN_ONDIR (subdirectory created):"); - /* metadata->fd is set to FAN_NOFD when FAN_REPORT_FID is enabled. + /* metadata\->fd is set to FAN_NOFD when FAN_REPORT_FID is enabled. To obtain a file descriptor for the file object corresponding to an event you can use the struct file_handle that\(aqs provided within the fanotify_event_info_fid in conjunction with the @@ -1074,7 +1074,7 @@ main(int argc, char **argv) if (ret == \-1) { if (errno == ESTALE) { printf("File handle is no longer valid. " - "File has been deleted\e\n"); + "File has been deleted\en"); continue; } else { perror("open_by_handle_at"); @@ -1093,15 +1093,15 @@ main(int argc, char **argv) exit(EXIT_FAILURE); } - path[path_len] = \(aq\e\0\(aq; - printf("\etDirectory \(aq%s\(aq has been modified.\e\n", path); + path[path_len] = \(aq\e0\(aq; + printf("\etDirectory \(aq%s\(aq has been modified.\en", path); /* Close associated file descriptor for this event */ close(event_fd); } - printf("All events processed successfully. Program exiting.\e\n"); + printf("All events processed successfully. Program exiting.\en"); exit(EXIT_SUCCESS); } .EE @@ -1111,7 +1111,7 @@ main(int argc, char **argv) .BR fanotify_mark (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/feature_test_macros.7 b/man7/feature_test_macros.7 index 1fd65feb8..3a628251c 100644 --- a/man7/feature_test_macros.7 +++ b/man7/feature_test_macros.7 @@ -911,7 +911,7 @@ The section "Feature Test Macros" under .PP .I /usr/include/features.h .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fifo.7 b/man7/fifo.7 index eef04e12a..27360d159 100644 --- a/man7/fifo.7 +++ b/man7/fifo.7 @@ -74,7 +74,7 @@ with the file type \(aqp\(aq. .BR mkfifo (3), .BR pipe (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/futex.7 b/man7/futex.7 index 985d1ebe1..4e9cb50f2 100644 --- a/man7/futex.7 +++ b/man7/futex.7 @@ -126,7 +126,7 @@ futex example library, futex-*.tar.bz2 .UR ftp://ftp.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/ .UE . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/glob.7 b/man7/glob.7 index d195e0665..1c886b211 100644 --- a/man7/glob.7 +++ b/man7/glob.7 @@ -212,7 +212,7 @@ to "\fI[a[.a-acute.][.a-grave.][.a-umlaut.][.a-circumflex.]]\fP". .BR locale (7), .BR regex (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hier.7 b/man7/hier.7 index 07c18d718..41653f873 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -650,7 +650,7 @@ differently. .PP The Filesystem Hierarchy Standard .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hostname.7 b/man7/hostname.7 index 4c43e42db..9a3e04ef7 100644 --- a/man7/hostname.7 +++ b/man7/hostname.7 @@ -124,7 +124,7 @@ IETF RFC\ 1178 .\" Hostname appeared in .\" 4.2BSD. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/icmp.7 b/man7/icmp.7 index 78c8456f6..2f34dcdca 100644 --- a/man7/icmp.7 +++ b/man7/icmp.7 @@ -199,7 +199,7 @@ output with a zero inode. .PP RFC\ 792 for a description of the ICMP protocol. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inode.7 b/man7/inode.7 index f0afbe283..3288ea8eb 100644 --- a/man7/inode.7 +++ b/man7/inode.7 @@ -480,7 +480,7 @@ if it is to be interpreted as a string). .BR statx (2), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inotify.7 b/man7/inotify.7 index 6b885e9b2..255a61213 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -1121,7 +1121,7 @@ main(int argc, char* argv[]) .IR Documentation/filesystems/inotify.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/intro.7 b/man7/intro.7 index 03772d662..aa223b4e6 100644 --- a/man7/intro.7 +++ b/man7/intro.7 @@ -41,7 +41,7 @@ Note that these can be different from page to page! .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, @@ -1337,7 +1337,7 @@ RFC\ 791 for the original IP specification. RFC\ 1122 for the IPv4 host requirements. RFC\ 1812 for the IPv4 router requirements. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ipc_namespaces.7 b/man7/ipc_namespaces.7 new file mode 100644 index 000000000..3d3034071 --- /dev/null +++ b/man7/ipc_namespaces.7 @@ -0,0 +1,95 @@ +.\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com> +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" +.TH IPC_NAMESPACES 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.SH NAME +namespaces \- overview of Linux IPC namespaces +.SH DESCRIPTION +IPC namespaces isolate certain IPC resources, +namely, System V IPC objects (see +.BR sysvipc (7)) +and (since Linux 2.6.30) +.\" commit 7eafd7c74c3f2e67c27621b987b28397110d643f +.\" https://lwn.net/Articles/312232/ +POSIX message queues (see +.BR mq_overview (7)). +The common characteristic of these IPC mechanisms is that IPC +objects are identified by mechanisms other than filesystem +pathnames. +.PP +Each IPC namespace has its own set of System V IPC identifiers and +its own POSIX message queue filesystem. +Objects created in an IPC namespace are visible to all other processes +that are members of that namespace, +but are not visible to processes in other IPC namespaces. +.PP +The following +.I /proc +interfaces are distinct in each IPC namespace: +.IP * 3 +The POSIX message queue interfaces in +.IR /proc/sys/fs/mqueue . +.IP * +The System V IPC interfaces in +.IR /proc/sys/kernel , +namely: +.IR msgmax , +.IR msgmnb , +.IR msgmni , +.IR sem , +.IR shmall , +.IR shmmax , +.IR shmmni , +and +.IR shm_rmid_forced . +.IP * +The System V IPC interfaces in +.IR /proc/sysvipc . +.PP +When an IPC namespace is destroyed +(i.e., when the last process that is a member of the namespace terminates), +all IPC objects in the namespace are automatically destroyed. +.PP +Use of IPC namespaces requires a kernel that is configured with the +.B CONFIG_IPC_NS +option. +.SH SEE ALSO +.BR nsenter (1), +.BR unshare (1), +.BR clone (2), +.BR setns (2), +.BR unshare (2), +.BR mq_overview (7), +.BR namespaces (7), +.BR sysvipc (7) +.SH COLOPHON +This page is part of release 5.03 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff --git a/man7/ipv6.7 b/man7/ipv6.7 index 4dbab30d5..118d373df 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -422,7 +422,7 @@ RFC\ 2553: IPv6 BASIC API; Linux tries to be compliant to this. RFC\ 2460: IPv6 specification. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-1.7 b/man7/iso_8859-1.7 index 30d8fb05c..c622f551e 100644 --- a/man7/iso_8859-1.7 +++ b/man7/iso_8859-1.7 @@ -168,7 +168,7 @@ ISO 8859-1 is also known as Latin-1. .BR iso_8859-15 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-10.7 b/man7/iso_8859-10.7 index 9dfbd8da7..60b1650aa 100644 --- a/man7/iso_8859-10.7 +++ b/man7/iso_8859-10.7 @@ -164,7 +164,7 @@ ISO 8859-10 is also known as Latin-6. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-11.7 b/man7/iso_8859-11.7 index f9948a050..59dc66fb6 100644 --- a/man7/iso_8859-11.7 +++ b/man7/iso_8859-11.7 @@ -161,7 +161,7 @@ while TIS-620 leaves it undefined. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-13.7 b/man7/iso_8859-13.7 index a93bdbc7a..2aa1a3ecc 100644 --- a/man7/iso_8859-13.7 +++ b/man7/iso_8859-13.7 @@ -164,7 +164,7 @@ ISO 8859-13 is also known as Latin-7. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-14.7 b/man7/iso_8859-14.7 index 3998b7617..809fb2bdc 100644 --- a/man7/iso_8859-14.7 +++ b/man7/iso_8859-14.7 @@ -164,7 +164,7 @@ ISO 8859-14 is also known as Latin-8. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-15.7 b/man7/iso_8859-15.7 index afa87995c..4a21f350c 100644 --- a/man7/iso_8859-15.7 +++ b/man7/iso_8859-15.7 @@ -167,7 +167,7 @@ ISO 8859-15 is also known as Latin-9 (or sometimes as Latin-0). .BR iso_8859-1 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-16.7 b/man7/iso_8859-16.7 index 3399950e7..cf3a7298f 100644 --- a/man7/iso_8859-16.7 +++ b/man7/iso_8859-16.7 @@ -165,7 +165,7 @@ ISO 8859-16 is also known as Latin-10. .BR iso_8859-3 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-2.7 b/man7/iso_8859-2.7 index fe02af2a2..acf5433d0 100644 --- a/man7/iso_8859-2.7 +++ b/man7/iso_8859-2.7 @@ -169,7 +169,7 @@ ISO 8859-2 is also known as Latin-2. .BR iso_8859-16 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-3.7 b/man7/iso_8859-3.7 index 1fe8fe2e5..f9a37f39a 100644 --- a/man7/iso_8859-3.7 +++ b/man7/iso_8859-3.7 @@ -157,7 +157,7 @@ ISO 8859-3 is also known as Latin-3. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-4.7 b/man7/iso_8859-4.7 index 55faa25dc..439557c40 100644 --- a/man7/iso_8859-4.7 +++ b/man7/iso_8859-4.7 @@ -164,7 +164,7 @@ ISO 8859-4 is also known as Latin-4. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-5.7 b/man7/iso_8859-5.7 index b814f4057..e359a330b 100644 --- a/man7/iso_8859-5.7 +++ b/man7/iso_8859-5.7 @@ -169,7 +169,7 @@ T} .BR koi8-u (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-6.7 b/man7/iso_8859-6.7 index c9adede42..e7e4c6c93 100644 --- a/man7/iso_8859-6.7 +++ b/man7/iso_8859-6.7 @@ -120,7 +120,7 @@ such as Urdu and Persian (Farsi). .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-7.7 b/man7/iso_8859-7.7 index acf70b4e7..a4c735883 100644 --- a/man7/iso_8859-7.7 +++ b/man7/iso_8859-7.7 @@ -168,7 +168,7 @@ ISO 8859-7 was formerly known as ELOT-928 or ECMA-118:1986. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-8.7 b/man7/iso_8859-8.7 index 6b187888d..91097441f 100644 --- a/man7/iso_8859-8.7 +++ b/man7/iso_8859-8.7 @@ -132,7 +132,7 @@ and Yiddish is not provided for. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/iso_8859-9.7 b/man7/iso_8859-9.7 index d12430ec4..de688580e 100644 --- a/man7/iso_8859-9.7 +++ b/man7/iso_8859-9.7 @@ -164,7 +164,7 @@ ISO 8859-9 is also known as Latin-5. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/keyrings.7 b/man7/keyrings.7 index 2a976bca7..421394d79 100644 --- a/man7/keyrings.7 +++ b/man7/keyrings.7 @@ -884,7 +884,7 @@ and under (or, before Linux 4.13, in the file .IR Documentation/security/keys.txt ). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/koi8-r.7 b/man7/koi8-r.7 index bad4709b5..638675e91 100644 --- a/man7/koi8-r.7 +++ b/man7/koi8-r.7 @@ -187,7 +187,7 @@ A4, A6, A7, AD, B4, B6, B7, and BD. .BR koi8-u (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/koi8-u.7 b/man7/koi8-u.7 index a9c8a060b..9698dad55 100644 --- a/man7/koi8-u.7 +++ b/man7/koi8-u.7 @@ -193,7 +193,7 @@ A4, A6, A7, AD, B4, B6, B7, and BD. .BR koi8-r (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/libc.7 b/man7/libc.7 index 3fb54f43a..7a69222e4 100644 --- a/man7/libc.7 +++ b/man7/libc.7 @@ -121,7 +121,7 @@ project, where they are known. .BR standards (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/locale.7 b/man7/locale.7 index c48f3f48a..6ee7e636f 100644 --- a/man7/locale.7 +++ b/man7/locale.7 @@ -399,7 +399,7 @@ POSIX.1-2001. .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/mailaddr.7 b/man7/mailaddr.7 index 01b63502e..8f0641b8e 100644 --- a/man7/mailaddr.7 +++ b/man7/mailaddr.7 @@ -121,7 +121,7 @@ The "postmaster" address is not case sensitive. IETF RFC\ 5322 .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/man-pages.7 b/man7/man-pages.7 index 095ab8d95..49b086167 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -27,7 +27,7 @@ .\" 2007-05-30 created by mtk, using text from old man.7 plus .\" rewrites and additional text. .\" -.TH MAN-PAGES 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MAN-PAGES 7 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME man-pages \- conventions for writing Linux man pages .SH SYNOPSIS @@ -102,10 +102,6 @@ Please limit source code line length to no more than about 75 characters wherever possible. This helps avoid line-wrapping in some mail clients when patches are submitted inline. -.PP -New sentences should be started on new lines. -This makes it easier to see the effect of patches, -which often operate at the level of individual sentences. .SS Title line The first command in a man page should be a .B TH @@ -527,7 +523,26 @@ The preferred way to write this in the source file is: (Using this format, rather than the use of "\efB...\efP()" makes it easier to write tools that parse man page source files.) .\" +.SS Use semantic newlines +In the source of a manual page, +new sentences should be started on new lines, +and long sentences should split into lines at clause breaks +(commas, semicolons, colons, and so on). +This convention, sometimes known as "semantic newlines", +makes it easier to see the effect of patches, +which often operate at the level of individual sentences or sentence clauses. +.\" .SS Formatting conventions (general) +.PP +Paragraphs should be separated by suitable markers (usually either +.I .PP +or +.IR .IP ). +Do +.I not +separate paragraphs using blank lines, as this results in poor rendering +in some output formats (such as PostScript and PDF). +.PP Filenames (whether pathnames, or references to header files) are always in italics (e.g., .IR <stdio.h> ), @@ -975,7 +990,7 @@ and .BR man (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/man.7 b/man7/man.7 index 69039804a..0e03a0e20 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -523,7 +523,7 @@ is not implemented. .BR man-pages (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/math_error.7 b/man7/math_error.7 index 5737166d7..7f21b9074 100644 --- a/man7/math_error.7 +++ b/man7/math_error.7 @@ -265,7 +265,7 @@ An error can still be tested for using .PP .I "info libc" .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/mount_namespaces.7 b/man7/mount_namespaces.7 index ae1ca8d81..4549eea43 100644 --- a/man7/mount_namespaces.7 +++ b/man7/mount_namespaces.7 @@ -48,15 +48,26 @@ resides. (All of the processes that reside in the same mount namespace will see the same view in these files.) .PP -When a process creates a new mount namespace using +A new mount namespace is created using either .BR clone (2) or .BR unshare (2) with the .BR CLONE_NEWNS -flag, the mount point list for the new namespace is a -.I copy -of the caller's mount point list. +flag. +When a new mount namespace is created, +its mount point list is initialized as follows: +.IP * 3 +If the namespace is created using +.BR clone (2), +the mount point list of the child's namespace is a copy +of the mount point list in the parent's namespace. +.IP * +If the namespace is created using +.BR unshare (2), +the mount point list of the new namespace is a copy of +the mount point list in the caller's previous mount namespace. +.PP Subsequent modifications to the mount point list .RB ( mount (2) and @@ -70,10 +81,14 @@ mount point list seen in the other namespace .SS Restrictions on mount namespaces Note the following points with respect to mount namespaces: .IP * 3 -A mount namespace has an owner user namespace. -A mount namespace whose owner user namespace is different from -the owner user namespace of its parent mount namespace is -considered a less privileged mount namespace. +Each mount namespace has an owner user namespace. +As explained above, when a new mount namespace is created, +its mount point list is initialized as a copy of the mount point list +of another mount namespace. +If the new namespace and the namespace from which the mount point list +was copied are owned by different user namespaces, +then the new mount namespace is considered +.IR "less privileged" . .IP * When creating a less privileged mount namespace, shared mounts are reduced to slave mounts. @@ -1077,12 +1092,35 @@ To prevent this, one can use the option to .BR unshare (1). .PP +An application that creates a new mount namespace directly using +.BR clone (2) +or +.BR unshare (2) +may desire to prevent propagation of mount events to other mount namespaces +(as is is done by +.BR unshare (1)). +This can be done by changing the propagation type of +mount points in the new namespace to either +.BR MS_SLAVE +or +.BR MS_PRIVATE . +using a call such as the following: +.IP +.in +4n +.EX +mount(NULL, "/", MS_SLAVE | MS_REC, NULL); +.EE +.in +.PP For a discussion of propagation types when moving mounts .RB ( MS_MOVE ) and creating bind mounts .RB ( MS_BIND ), see .IR Documentation/filesystems/sharedsubtree.txt . +.SH EXAMPLE +See +.BR pivot_root (2). .SH SEE ALSO .BR unshare (1), .BR clone (2), @@ -1100,7 +1138,7 @@ see .IR Documentation/filesystems/sharedsubtree.txt in the kernel source tree. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/mq_overview.7 b/man7/mq_overview.7 index 085cbcae3..eb76c23df 100644 --- a/man7/mq_overview.7 +++ b/man7/mq_overview.7 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_OVERVIEW 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MQ_OVERVIEW 7 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME mq_overview \- overview of POSIX message queues .SH DESCRIPTION @@ -351,9 +351,9 @@ The close-on-exec flag (see is automatically set on the file descriptor returned by .BR mq_open (2). .SS IPC namespaces -For a discussion of the interaction of System V IPC objects and +For a discussion of the interaction of POSIX message queue objects and IPC namespaces, see -.BR namespaces (7). +.BR ipc_namespaces (7). .SH NOTES System V message queues .RB ( msgget (2), @@ -408,7 +408,7 @@ An example of the use of various message queue functions is shown in .BR epoll (7), .BR namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/namespaces.7 b/man7/namespaces.7 index 21112ccff..606fbd947 100644 --- a/man7/namespaces.7 +++ b/man7/namespaces.7 @@ -35,24 +35,45 @@ Changes to the global resource are visible to other processes that are members of the namespace, but are invisible to other processes. One use of namespaces is to implement containers. .PP -Linux provides the following namespaces: -.TS -lB lB lB -l lB l. -Namespace Constant Isolates -Cgroup CLONE_NEWCGROUP Cgroup root directory -IPC CLONE_NEWIPC System V IPC, POSIX message queues -Network CLONE_NEWNET Network devices, stacks, ports, etc. -Mount CLONE_NEWNS Mount points -PID CLONE_NEWPID Process IDs -User CLONE_NEWUSER User and group IDs -UTS CLONE_NEWUTS Hostname and NIS domain name -.TE -.PP -This page describes the various namespaces and the associated +This page provides pointers to information on the various namespace types, +describes the associated .I /proc files, and summarizes the APIs for working with namespaces. .\" +.SS Namespace types +.PP +The following table shows the namespace types available on Linux. +The second column of the table shows the flag value that is used to specify +the namespace type in various APIs. +The third column identifies the manual page that provides details +on the namespace type. +The last column is a summary of the resources that are isolated by +the namespace type. +.TS +lB lB lB lB +l1 lB1 l1 l. +Namespace Flag Page Isolates +Cgroup CLONE_NEWCGROUP \fBcgroup_namespaces\fP(7) Cgroup root directory +IPC CLONE_NEWIPC \fBipc_namespaces\fP(7) T{ +System V IPC, +.br +POSIX message queues +T} +Network CLONE_NEWNET \fBnetwork_namespaces\fP(7) T{ +Network devices, +.br +stacks, ports, etc. +T} +Mount CLONE_NEWNS \fBmount_namespaces\fP(7) Mount points +PID CLONE_NEWPID \fBpid_namespaces\fP(7) Process IDs +User CLONE_NEWUSER \fBuser_namespaces\fP(7) User and group IDs +UTS CLONE_NEWUTS \fButs_namespaces\fP(7) T{ +Hostname and NIS +.br +domain name +T} +.TE +.\" .\" ==================== The namespaces API ==================== .\" .SS The namespaces API @@ -319,118 +340,6 @@ for the creator UID in the ancestor namespace is not exceeded. The aforementioned point ensures that creating a new user namespace cannot be used as a means to escape the limits in force in the current user namespace. -.RE -.\" -.\" ==================== Cgroup namespaces ==================== -.\" -.SS Cgroup namespaces (CLONE_NEWCGROUP) -See -.BR cgroup_namespaces (7). -.\" -.\" ==================== IPC namespaces ==================== -.\" -.SS IPC namespaces (CLONE_NEWIPC) -IPC namespaces isolate certain IPC resources, -namely, System V IPC objects (see -.BR sysvipc (7)) -and (since Linux 2.6.30) -.\" commit 7eafd7c74c3f2e67c27621b987b28397110d643f -.\" https://lwn.net/Articles/312232/ -POSIX message queues (see -.BR mq_overview (7)). -The common characteristic of these IPC mechanisms is that IPC -objects are identified by mechanisms other than filesystem -pathnames. -.PP -Each IPC namespace has its own set of System V IPC identifiers and -its own POSIX message queue filesystem. -Objects created in an IPC namespace are visible to all other processes -that are members of that namespace, -but are not visible to processes in other IPC namespaces. -.PP -The following -.I /proc -interfaces are distinct in each IPC namespace: -.IP * 3 -The POSIX message queue interfaces in -.IR /proc/sys/fs/mqueue . -.IP * -The System V IPC interfaces in -.IR /proc/sys/kernel , -namely: -.IR msgmax , -.IR msgmnb , -.IR msgmni , -.IR sem , -.IR shmall , -.IR shmmax , -.IR shmmni , -and -.IR shm_rmid_forced . -.IP * -The System V IPC interfaces in -.IR /proc/sysvipc . -.PP -When an IPC namespace is destroyed -(i.e., when the last process that is a member of the namespace terminates), -all IPC objects in the namespace are automatically destroyed. -.PP -Use of IPC namespaces requires a kernel that is configured with the -.B CONFIG_IPC_NS -option. -.\" -.\" ==================== Network namespaces ==================== -.\" -.SS Network namespaces (CLONE_NEWNET) -See -.BR network_namespaces (7). -.\" -.\" ==================== Mount namespaces ==================== -.\" -.SS Mount namespaces (CLONE_NEWNS) -See -.BR mount_namespaces (7). -.\" -.\" ==================== PID namespaces ==================== -.\" -.SS PID namespaces (CLONE_NEWPID) -See -.BR pid_namespaces (7). -.\" -.\" ==================== User namespaces ==================== -.\" -.SS User namespaces (CLONE_NEWUSER) -See -.BR user_namespaces (7). -.\" -.\" ==================== UTS namespaces ==================== -.\" -.SS UTS namespaces (CLONE_NEWUTS) -UTS namespaces provide isolation of two system identifiers: -the hostname and the NIS domain name. -These identifiers are set using -.BR sethostname (2) -and -.BR setdomainname (2), -and can be retrieved using -.BR uname (2), -.BR gethostname (2), -and -.BR getdomainname (2). -.PP -.PP -When a process creates a new UTS namespace using -.BR clone (2) -or -.BR unshare (2) -with the -.BR CLONE_NEWUTS -flag, the hostname and domain of the new UTS namespace are copied -from the corresponding values in the caller's UTS namespace. -.PP -Use of UTS namespaces requires a kernel that is configured with the -.B CONFIG_UTS_NS -option. .\" .SS Namespace lifetime Absent any other factors, @@ -481,14 +390,16 @@ and .BR cgroup_namespaces (7), .BR cgroups (7), .BR credentials (7), +.BR ipc_namespaces (7), .BR network_namespaces (7), .BR pid_namespaces (7), .BR user_namespaces (7), +.BR uts_namespaces (7), .BR lsns (8), .BR pam_namespace (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netdevice.7 b/man7/netdevice.7 index ca07ecece..7c443bc92 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -376,7 +376,7 @@ Add the following to your program as a workaround: .BR ip (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netlink.7 b/man7/netlink.7 index ed2cddf7e..2a9cb7762 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -575,7 +575,7 @@ information about libnl .PP RFC 3549 "Linux Netlink as an IP Services Protocol" .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/network_namespaces.7 b/man7/network_namespaces.7 index 64ec52ff1..82d9d1afe 100644 --- a/man7/network_namespaces.7 +++ b/man7/network_namespaces.7 @@ -80,7 +80,7 @@ option. .BR iptables (8), .BR ovs-vsctl (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/nptl.7 b/man7/nptl.7 index d55b13677..5d4adba7d 100644 --- a/man7/nptl.7 +++ b/man7/nptl.7 @@ -131,7 +131,7 @@ meaning that 32-bit and 64-bit binaries can't share mutexes on x86-64 systems. .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/numa.7 b/man7/numa.7 index 5167d9c84..33265da62 100644 --- a/man7/numa.7 +++ b/man7/numa.7 @@ -189,7 +189,7 @@ package. .BR cpuset (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/operator.7 b/man7/operator.7 index c84d26890..16c440730 100644 --- a/man7/operator.7 +++ b/man7/operator.7 @@ -37,18 +37,18 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH OPERATOR 7 2011-09-09 "Linux" "Linux Programmer's Manual" +.TH OPERATOR 7 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME operator \- C operator precedence and order of evaluation .SH DESCRIPTION This manual page lists C operators and their precedence in evaluation. .PP .TS -lb lb -l l. -Operator Associativity -() [] \-> . left to right -! ~ ++ \-\- + \- (type) * & sizeof right to left +lb lb lb +l l l. +Operator Associativity Notes +() [] \-> . ++ \-\- left to right [1] +! ~ ++ \-\- + \- (type) * & sizeof right to left [2] * / % left to right + \- left to right << >> left to right @@ -63,8 +63,19 @@ Operator Associativity = += \-= *= /= %= <<= >>= &= ^= |= right to left , left to right .TE +.PP +The following notes provide further information to the above table: +.PP +.PD 0 +.IP [1] 4 +The ++ and \-\- operators at this precedence level are +the postfix flavors of the operators. +.IP [2] +The ++ and \-\- operators at this precedence level are +the prefix flavors of the operators. +.PD .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/packet.7 b/man7/packet.7 index bc4fad9ff..aed8dee34 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -654,7 +654,7 @@ contains example source code for all available versions of and .BR PACKET_TX_RING . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/path_resolution.7 b/man7/path_resolution.7 index 33a9b5fbc..29c80bea3 100644 --- a/man7/path_resolution.7 +++ b/man7/path_resolution.7 @@ -257,7 +257,7 @@ on directories, and read permission on ordinary files. .BR credentials (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/persistent-keyring.7 b/man7/persistent-keyring.7 index 1e85802ad..3eec10302 100644 --- a/man7/persistent-keyring.7 +++ b/man7/persistent-keyring.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "PERSISTENT-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH PERSISTENT-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" .SH NAME persistent-keyring \- per-user persistent keyring .SH DESCRIPTION @@ -125,7 +125,7 @@ creates the key if it does not exist, and links it into the keyring. .BR user\-keyring (7), .BR user\-session\-keyring (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pid_namespaces.7 b/man7/pid_namespaces.7 index 46daa565b..984de0105 100644 --- a/man7/pid_namespaces.7 +++ b/man7/pid_namespaces.7 @@ -403,7 +403,7 @@ See .BR user_namespaces (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pipe.7 b/man7/pipe.7 index efa3f6e4a..76d6623d4 100644 --- a/man7/pipe.7 +++ b/man7/pipe.7 @@ -418,7 +418,7 @@ and when opening a previously unopened FIFO. .BR epoll (7), .BR fifo (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pkeys.7 b/man7/pkeys.7 index 354a9f0c6..2afc3900e 100644 --- a/man7/pkeys.7 +++ b/man7/pkeys.7 @@ -295,7 +295,7 @@ main(void) .BR pkey_mprotect (2), .BR sigaction (2) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index bc4ffc77d..3e9c4c51d 100644 --- a/man7/posixoptions.7 +++ b/man7/posixoptions.7 @@ -1032,7 +1032,7 @@ This option may imply the following options from the XSI option groups: .BR sysconf (3), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/process-keyring.7 b/man7/process-keyring.7 index 4602fb9f8..606cce97c 100644 --- a/man7/process-keyring.7 +++ b/man7/process-keyring.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "PROCESS-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH PROCESS-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" .SH NAME process-keyring \- per-process shared keyring .SH DESCRIPTION @@ -60,7 +60,7 @@ results. .BR user\-keyring (7), .BR user\-session\-keyring (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pthreads.7 b/man7/pthreads.7 index 196bef004..e68dad657 100644 --- a/man7/pthreads.7 +++ b/man7/pthreads.7 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREADS 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREADS 7 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME pthreads \- POSIX threads .SH DESCRIPTION @@ -564,6 +564,16 @@ not specified in the standard as cancellation points. In particular, an implementation is likely to mark any nonstandard function that may block as a cancellation point. (This includes most functions that can touch files.) +.PP +It should be noted that even if an application is not using +asynchronous cancellation, that calling a function from the above list +from an asynchronous signal handler may cause the equivalent of +asynchronous cancellation. +The underlying user code may not expect +asynchronous cancellation and the state of the user data may become +inconsistent. +Therefore signals should be used with caution when +entering a region of deferred cancellation. .\" So, scanning "cancellation point" comments in the glibc 2.8 header .\" files, it looks as though at least the following nonstandard .\" functions are cancellation points: @@ -939,7 +949,7 @@ Various Pthreads manual pages, for example: and .BR pthread_testcancel (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pty.7 b/man7/pty.7 index 3cd108829..9cf4c539e 100644 --- a/man7/pty.7 +++ b/man7/pty.7 @@ -170,7 +170,7 @@ have not been implemented under Linux. .BR pts (4), .BR tty (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/random.7 b/man7/random.7 index 5c15ad0fc..ecad7456e 100644 --- a/man7/random.7 +++ b/man7/random.7 @@ -231,7 +231,7 @@ skillfully implemented. .BR urandom (4), .BR signal (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/raw.7 b/man7/raw.7 index 7698bea8a..63ae4253b 100644 --- a/man7/raw.7 +++ b/man7/raw.7 @@ -286,7 +286,7 @@ and the .I <linux/ip.h> header file for the IP protocol. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/regex.7 b/man7/regex.7 index da76efb77..0c5178f85 100644 --- a/man7/regex.7 +++ b/man7/regex.7 @@ -290,7 +290,7 @@ This page was taken from Henry Spencer's regex package. .PP POSIX.2, section 2.8 (Regular Expression Notation). .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/rtld-audit.7 b/man7/rtld-audit.7 index e7bfc33ef..8fc13a326 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -606,7 +606,7 @@ la_i86_gnu_pltenter(Elf32_Sym *sym, unsigned int ndx, .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index b0e4d6eee..c964152de 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -463,7 +463,7 @@ This manual page is incomplete. .BR ip (7), .BR netlink (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sched.7 b/man7/sched.7 index 862ffc353..01ff32747 100644 --- a/man7/sched.7 +++ b/man7/sched.7 @@ -989,8 +989,8 @@ was not possible up to kernel version 2.6.17. .BR sched_setscheduler (2), .BR sched_yield (2), .BR setpriority (2), -.BR pthread_getschedparam (3), .BR pthread_getaffinity_np (3), +.BR pthread_getschedparam (3), .BR pthread_setaffinity_np (3), .BR sched_getcpu (3), .BR capabilities (7), @@ -1007,7 +1007,7 @@ The Linux kernel source files and .IR Documentation/scheduler/sched-nice-design.txt .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sem_overview.7 b/man7/sem_overview.7 index cef582689..2995c4597 100644 --- a/man7/sem_overview.7 +++ b/man7/sem_overview.7 @@ -159,7 +159,7 @@ An example of the use of various POSIX semaphore functions is shown in .BR pthreads (7), .BR shm_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/session-keyring.7 b/man7/session-keyring.7 index cd2c2b6b1..20a963851 100644 --- a/man7/session-keyring.7 +++ b/man7/session-keyring.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "SESSION-KEYRING" 7 2017-09-15 Linux "Linux Programmer's Manual" +.TH SESSION-KEYRING 7 2017-09-15 Linux "Linux Programmer's Manual" .SH NAME session-keyring \- session shared process keyring .SH DESCRIPTION @@ -115,7 +115,7 @@ keyctl new_session .BR user\-session\-keyring (7), .BR pam_keyinit (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/shm_overview.7 b/man7/shm_overview.7 index 6350a3202..d4cdd9f92 100644 --- a/man7/shm_overview.7 +++ b/man7/shm_overview.7 @@ -123,7 +123,7 @@ on the other hand POSIX shared memory is somewhat less widely available .BR shm_unlink (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sigevent.7 b/man7/sigevent.7 index 0eb23e32d..8770056c4 100644 --- a/man7/sigevent.7 +++ b/man7/sigevent.7 @@ -139,7 +139,7 @@ Currently used only by POSIX timers; see .BR aio (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/signal-safety.7 b/man7/signal-safety.7 index 8040a910a..b42d52f04 100644 --- a/man7/signal-safety.7 +++ b/man7/signal-safety.7 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGNAL-SAFETY 7 2017-03-13 "Linux" "Linux Programmer's Manual" +.TH SIGNAL-SAFETY 7 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME signal-safety \- async-signal-safe functions .SH DESCRIPTION @@ -314,6 +314,11 @@ is likely to remove .BR fork (2) from the list of async-signal-safe functions. .\" +.IP * 3 +Asynchronous signal handlers that call functions which are cancellation +points and nest over regions of deferred cancellation may trigger +cancellation whose behavior is as if asynchronous cancellation had +occurred and may cause application state to become inconsistent. .SS Deviations in the GNU C library The following known deviations from the standard occur in the GNU C library: @@ -339,7 +344,7 @@ internally. .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/signal.7 b/man7/signal.7 index 7ef55445b..8816d66b2 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -191,18 +191,29 @@ inherits a copy of its parent's signal mask; the signal mask is preserved across .BR execve (2). .PP -A signal may be generated (and thus pending) -for a process as a whole (e.g., when sent using -.BR kill (2)) -or for a specific thread (e.g., certain signals, -such as +A signal may be process-directed or thread-directed. +A process-directed signal is one that is targeted at (and thus pending for) +the process as a whole. +A signal may be process-directed +because it was generated by the kernel for reasons +other than a hardware exception, or because it was sent using +.BR kill (2) +or +.BR sigqueue (3). +A thread-directed signal is one that is targeted at a specific thread. +A signal may be thread-directed because it was generated as a consequence +of executing a specific machine-language instruction +that triggered a hardware exception (e.g., .B SIGSEGV -and -.BR SIGFPE , -generated as a -consequence of executing a specific machine-language instruction -are thread directed, as are signals targeted at a specific thread using -.BR pthread_kill (3)). +for an invalid memory access, or +.B SIGFPE +for a math error), or because it was it was +targeted at a specific thread using +interfaces such as +.BR tgkill (2) +or +.BR pthread_kill (3). +.PP A process-directed signal may be delivered to any one of the threads that does not currently have the signal blocked. If more than one of the threads has the signal unblocked, then the @@ -828,6 +839,7 @@ for further details. .BR kill (2), .BR restart_syscall (2), .BR rt_sigqueueinfo (2), +.BR pidfd_send_signal (2), .BR setitimer (2), .BR setrlimit (2), .BR sgetmask (2), @@ -859,7 +871,7 @@ for further details. .BR pthreads (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sock_diag.7 b/man7/sock_diag.7 index 50520dc63..c9b96da39 100644 --- a/man7/sock_diag.7 +++ b/man7/sock_diag.7 @@ -841,7 +841,7 @@ main(void) .BR netlink (7), .BR tcp (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/socket.7 b/man7/socket.7 index 2307670f9..48dd62d78 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -1162,7 +1162,7 @@ program is designed to always set this option. .BR unix (7), .BR tcpdump (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/spufs.7 b/man7/spufs.7 index 8c6f287cd..fd7588f61 100644 --- a/man7/spufs.7 +++ b/man7/spufs.7 @@ -771,7 +771,7 @@ none /spu spufs gid=spu 0 0 .PP .I The Cell Broadband Engine Architecture (CBEA) specification .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/standards.7 b/man7/standards.7 index ee2e910d6..eaeb76ef0 100644 --- a/man7/standards.7 +++ b/man7/standards.7 @@ -288,7 +288,7 @@ Further information can be found on the Austin Group web site, .BR libc (7), .BR posixoptions (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/suffixes.7 b/man7/suffixes.7 index 12b5f7450..956d8d491 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -281,7 +281,7 @@ This list is not exhaustive. .BR file (1), .BR make (1) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/symlink.7 b/man7/symlink.7 index 443782dee..698e0a751 100644 --- a/man7/symlink.7 +++ b/man7/symlink.7 @@ -533,7 +533,7 @@ whether specified on the command line or encountered in the tree walk. .BR lutimes (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sysvipc.7 b/man7/sysvipc.7 index 3a5fc720e..c7ec1377c 100644 --- a/man7/sysvipc.7 +++ b/man7/sysvipc.7 @@ -37,7 +37,7 @@ .\" * The only part that uniquely belongs in sysvipc(7) is perhaps .\" the discussion of ipc_perm. .\" -.TH SVIPC 7 2016-03-15 "Linux" "Linux Programmer's Manual" +.TH SVIPC 7 2019-10-10 "Linux" "Linux Programmer's Manual" .SH NAME sysvipc \- System V interprocess communication mechanisms .SH SYNOPSIS @@ -329,7 +329,7 @@ system call that changed .SS IPC namespaces For a discussion of the interaction of System V IPC objects and IPC namespaces, see -.BR namespaces (7). +.BR ipc_namespaces (7). .SH SEE ALSO .BR ipcmk (1), .BR ipcrm (1), @@ -348,9 +348,9 @@ IPC namespaces, see .BR shmdt (2), .BR shmget (2), .BR ftok (3), -.BR namespaces (7) +.BR ipc_namespaces (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/tcp.7 b/man7/tcp.7 index 7093986d7..f46a3f758 100644 --- a/man7/tcp.7 +++ b/man7/tcp.7 @@ -1380,7 +1380,7 @@ RFC\ 2581 for TCP congestion control algorithms. .br RFC\ 2018 and RFC\ 2883 for SACK and extensions to SACK. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/termio.7 b/man7/termio.7 index beeca0c58..a47d3f296 100644 --- a/man7/termio.7 +++ b/man7/termio.7 @@ -64,7 +64,7 @@ or .BR termios (3), .BR tty (4) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/thread-keyring.7 b/man7/thread-keyring.7 index 1f31c48b6..b5ae4e1f8 100644 --- a/man7/thread-keyring.7 +++ b/man7/thread-keyring.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "THREAD-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH THREAD-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" .SH NAME thread-keyring \- per-thread keyring .SH DESCRIPTION @@ -55,7 +55,7 @@ otherwise the operation fails with the error .BR user\-keyring (7), .BR user\-session\-keyring (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/time.7 b/man7/time.7 index d50338fd3..aed546844 100644 --- a/man7/time.7 +++ b/man7/time.7 @@ -224,7 +224,7 @@ in .BR rtc (4), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udp.7 b/man7/udp.7 index 2da7e0dc9..1a3d94c66 100644 --- a/man7/udp.7 +++ b/man7/udp.7 @@ -270,7 +270,7 @@ RFC\ 1122 for the host requirements. .br RFC\ 1191 for a description of path MTU discovery. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udplite.7 b/man7/udplite.7 index c16d86509..43e0725e4 100644 --- a/man7/udplite.7 +++ b/man7/udplite.7 @@ -155,7 +155,7 @@ RFC\ 3828 for the Lightweight User Datagram Protocol (UDP-Lite). .I Documentation/networking/udplite.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unicode.7 b/man7/unicode.7 index a3e822b19..869645aa6 100644 --- a/man7/unicode.7 +++ b/man7/unicode.7 @@ -265,7 +265,7 @@ Bruno Haible: Unicode HOWTO. .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/units.7 b/man7/units.7 index 64e7e01af..6d81b7910 100644 --- a/man7/units.7 +++ b/man7/units.7 @@ -128,7 +128,7 @@ hda: 120064896 sectors (61473 MB) w/2048KiB Cache .PP the MB are megabytes and the KiB are kibibytes. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unix.7 b/man7/unix.7 index 72bc2e1c9..04d605b0d 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -1153,7 +1153,7 @@ see .BR socket (7), .BR udp (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/uri.7 b/man7/uri.7 index e358de3cd..f7043243c 100644 --- a/man7/uri.7 +++ b/man7/uri.7 @@ -713,7 +713,7 @@ tools) and invokes the right tool for any URI. IETF RFC\ 2255 .UE .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/user-keyring.7 b/man7/user-keyring.7 index e528cc912..b09c8fca6 100644 --- a/man7/user-keyring.7 +++ b/man7/user-keyring.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "USER-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH USER-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" .SH NAME user-keyring \- per-user keyring .SH DESCRIPTION @@ -86,7 +86,7 @@ If a user keyring does not exist when it is accessed, it will be created. .BR user\-session\-keyring (7), .BR pam_keyinit (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/user-session-keyring.7 b/man7/user-session-keyring.7 index baa740adb..ad64e4292 100644 --- a/man7/user-session-keyring.7 +++ b/man7/user-session-keyring.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "USER-SESSION-KEYRING" 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH USER-SESSION-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" .SH NAME user-session-keyring \- per-user default session keyring .SH DESCRIPTION @@ -97,7 +97,7 @@ In such a scenario, the user session keyring acts as a substitute for the .BR thread\-keyring (7), .BR user\-keyring (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7 index ca2b8be3e..7c2d0078b 100644 --- a/man7/user_namespaces.7 +++ b/man7/user_namespaces.7 @@ -310,8 +310,9 @@ capability in the caller's user namespace. When a nonuser namespace is created, it is owned by the user namespace in which the creating process was a member at the time of the creation of the namespace. -Actions on the nonuser namespace -require capabilities in the corresponding user namespace. +Privileged operations on resources governed by the nonuser namespace +require that the process has the necessary capabilities +in the user namespace that owns the nonuser namespace. .PP If .BR CLONE_NEWUSER @@ -717,7 +718,7 @@ paragraph is that it is permitted to write to only so long as calling .BR setgroups (2) is disallowed because -.I /proc/[pid]gid_map +.I /proc/[pid]/gid_map has not been set. This ensures that a process cannot transition from a state where .BR setgroups (2) @@ -1379,7 +1380,7 @@ main(int argc, char *argv[]) The kernel source file .IR Documentation/namespaces/resource-control.txt . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/utf-8.7 b/man7/utf-8.7 index 89e992311..d93ec52b8 100644 --- a/man7/utf-8.7 +++ b/man7/utf-8.7 @@ -229,7 +229,7 @@ ISO/IEC 10646-1:2000, Unicode 3.1, RFC\ 3629, Plan 9. .BR charsets (7), .BR unicode (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/uts_namespaces.7 b/man7/uts_namespaces.7 new file mode 100644 index 000000000..2fd72f886 --- /dev/null +++ b/man7/uts_namespaces.7 @@ -0,0 +1,73 @@ +.\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com> +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" +.TH UTS_NAMESPACES 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.SH NAME +namespaces \- overview of Linux UTS namespaces +.SH DESCRIPTION +UTS namespaces provide isolation of two system identifiers: +the hostname and the NIS domain name. +These identifiers are set using +.BR sethostname (2) +and +.BR setdomainname (2), +and can be retrieved using +.BR uname (2), +.BR gethostname (2), +and +.BR getdomainname (2). +.PP +.PP +When a process creates a new UTS namespace using +.BR clone (2) +or +.BR unshare (2) +with the +.BR CLONE_NEWUTS +flag, the hostname and domain of the new UTS namespace are copied +from the corresponding values in the caller's UTS namespace. +.PP +Use of UTS namespaces requires a kernel that is configured with the +.B CONFIG_UTS_NS +option. +.SH SEE ALSO +.BR nsenter (1), +.BR unshare (1), +.BR clone (2), +.BR getdomainname (2), +.BR gethostname (2), +.BR setns (2), +.BR uname (2), +.BR unshare (2), +.BR namespaces (7) +.SH COLOPHON +This page is part of release 5.03 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%https://www.kernel.org/doc/man\-pages/. diff --git a/man7/vdso.7 b/man7/vdso.7 index 7467a859f..a9ad91ae2 100644 --- a/man7/vdso.7 +++ b/man7/vdso.7 @@ -596,7 +596,7 @@ find arch/ \-iname \(aq*vdso*\(aq \-o \-iname \(aq*gate*\(aq .EE .in .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vsock.7 b/man7/vsock.7 index 022c136ef..576d7269d 100644 --- a/man7/vsock.7 +++ b/man7/vsock.7 @@ -224,7 +224,7 @@ Hyper-V is supported since Linux 4.14. .BR socket (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/x25.7 b/man7/x25.7 index 847a30c2b..a3676b517 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -125,7 +125,7 @@ The URL is .UR ftp://ftp.pspt.fi\:/pub\:/ham\:/linux\:/ax25\:/x25doc.tgz .UE . .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man7/xattr.7 b/man7/xattr.7 index 9625afae7..e6a5dd7e2 100644 --- a/man7/xattr.7 +++ b/man7/xattr.7 @@ -197,7 +197,7 @@ This page was formerly named .BR capabilities (7) .BR selinux (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8 index 0babd82d1..99826bbdb 100644 --- a/man8/iconvconfig.8 +++ b/man8/iconvconfig.8 @@ -102,7 +102,7 @@ Usual system gconv module configuration cache. .BR iconv (1), .BR iconv (3) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/intro.8 b/man8/intro.8 index 33dc47205..042e8c973 100644 --- a/man8/intro.8 +++ b/man8/intro.8 @@ -47,7 +47,7 @@ Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/ld.so.8 b/man8/ld.so.8 index 8f88a6fc9..2196c4f09 100644 --- a/man8/ld.so.8 +++ b/man8/ld.so.8 @@ -428,7 +428,7 @@ loading a new shared object, resolving a symbol, or calling a symbol from another shared object\(emby calling an appropriate function within the audit shared object. For details, see -.BR rtld-audit (7). +.BR rtld\-audit (7). The auditing interface is largely compatible with that provided on Solaris, as described in its .IR "Linker and Libraries Guide" , @@ -783,7 +783,7 @@ mtrr, pat, pbe, pge, pn, pse36, sep, ss, sse, sse2, tm .BR getauxval (3), .BR elf (5), .BR capabilities (7), -.BR rtld-audit (7), +.BR rtld\-audit (7), .BR ldconfig (8), .BR sln (8) .\" .SH AUTHORS @@ -793,7 +793,7 @@ mtrr, pat, pbe, pge, pn, pse36, sep, ss, sse, sse2, tm .\" .\" In the above, (libc5) stands for David Engel's ld.so/ld\-linux.so. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/ldconfig.8 b/man8/ldconfig.8 index d3603556b..d7c613a6b 100644 --- a/man8/ldconfig.8 +++ b/man8/ldconfig.8 @@ -188,7 +188,7 @@ as well as those found in the trusted directories. .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/nscd.8 b/man8/nscd.8 index 0ca8aafc1..b2463667c 100644 --- a/man8/nscd.8 +++ b/man8/nscd.8 @@ -97,7 +97,7 @@ $ \fBnscd -i\fP \fI<database>\fP .\" .B nscd .\" was written by Thorsten Kukuk and Ulrich Drepper. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/sln.8 b/man8/sln.8 index a566cd0e9..a069089dc 100644 --- a/man8/sln.8 +++ b/man8/sln.8 @@ -62,7 +62,7 @@ program supports no command-line options. .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/tzselect.8 b/man8/tzselect.8 index f3cd9e1ad..6f43eff5c 100644 --- a/man8/tzselect.8 +++ b/man8/tzselect.8 @@ -50,7 +50,7 @@ Timezone data file for timezone .BR zic (8) .\" @(#)tzselect.8 1.3 .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zdump.8 b/man8/zdump.8 index 08285338d..0cf4ab92e 100644 --- a/man8/zdump.8 +++ b/man8/zdump.8 @@ -230,7 +230,7 @@ introduction of UTC is problematic. .\" This file is in the public domain, so clarified as of .\" 2009-05-17 by Arthur David Olson. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zic.8 b/man8/zic.8 index 6803bc9ad..fc38fde29 100644 --- a/man8/zic.8 +++ b/man8/zic.8 @@ -606,7 +606,7 @@ specifying transition instants using universal time. .\" This file is in the public domain, so clarified as of .\" 2009-05-17 by Arthur David Olson. .SH COLOPHON -This page is part of release 5.02 of the Linux +This page is part of release 5.03 of the Linux .I man-pages project. A description of the project, diff --git a/proj.man-pages.desc b/proj.man-pages.desc index 3742a5ea7..a34b0faf6 100644 --- a/proj.man-pages.desc +++ b/proj.man-pages.desc @@ -1 +1 @@ -man-pages|Linux kernel and C library user-space interface documentation|https://www.kernel.org/doc/man-pages/|REPO|Git|https://www.kernel.org/doc/man-pages/index.html|https://www.kernel.org/doc/man-pages/reporting_bugs.html|2019-08-02 +man-pages|Linux kernel and C library user-space interface documentation|https://www.kernel.org/doc/man-pages/|REPO|Git|https://www.kernel.org/doc/man-pages/index.html|https://www.kernel.org/doc/man-pages/reporting_bugs.html|2019-10-11 diff --git a/proj.man-pages.pages b/proj.man-pages.pages index 107a7b454..442fce4c3 100644 --- a/proj.man-pages.pages +++ b/proj.man-pages.pages @@ -83,6 +83,7 @@ man2/times.2 man2/setgid32.2 man2/setpgrp.2 man2/fchdir.2 +man2/pidfd_send_signal.2 man2/rmdir.2 man2/setsockopt.2 man2/umount.2 @@ -208,6 +209,7 @@ man2/kill.2 man2/preadv2.2 man2/shmctl.2 man2/io_submit.2 +man2/pidfd_open.2 man2/getuid.2 man2/getitimer.2 man2/set_tid_address.2 @@ -1888,6 +1890,7 @@ man3/pthread_cleanup_pop_restore_np.3 man3/random_r.3 man3/fegetexcept.3 man3/bswap_32.3 +man3/res_nclose.3 man3/pthread_attr_setstackaddr.3 man3/acos.3 man3/freeifaddrs.3 @@ -2278,6 +2281,7 @@ man7/session-keyring.7 man7/futex.7 man7/iso-8859-13.7 man7/charsets.7 +man7/uts_namespaces.7 man7/x25.7 man7/mount_namespaces.7 man7/iso_8859-7.7 @@ -2370,6 +2374,7 @@ man7/bootparam.7 man7/latin2.7 man7/iso-8859-16.7 man7/iso_8859_16.7 +man7/ipc_namespaces.7 man7/iso_8859_6.7 man7/namespaces.7 man7/udplite.7 |