diff options
| author | Dr. Tobias Quathamer <toddy@debian.org> | 2020-06-11 16:23:22 +0200 |
|---|---|---|
| committer | Dr. Tobias Quathamer <toddy@debian.org> | 2020-06-11 16:23:22 +0200 |
| commit | 88ecfe9f207b5ac0e0483340a34153b84c23c731 (patch) | |
| tree | 7f0659e02534bc7b538716239be9b198dcff69ed | |
| parent | da077626296927399440ee49caff0a10bcbcaac4 (diff) | |
New upstream version 5.07
1056 files changed, 8462 insertions, 6546 deletions
@@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.06 ==================== +==================== Changes in man-pages-5.07 ==================== -Released: 2020-04-11, Munich +Released: 2020-06-09, Munich Contributors @@ -10,44 +10,88 @@ 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: -Alejandro Colomar <colomar.6.4.3@gmail.com> +Achilles Gaikwad <agaikwad@redhat.com> +Adhemerval Zanella <adhemerval.zanella@linaro.org> Aleksa Sarai <cyphar@cyphar.com> -Alexander Miller <alex.miller@gmx.de> -Andrea Arcangeli <aarcange@redhat.com> -André Almeida <andrealmeid@collabora.com> -Andrei Vagin <avagin@gmail.com> -Andrew Micallef <andrew.micallef@live.com.au> -Bart Van Assche <bvanassche@acm.org> -Benjamin Peterson <benjamin@python.org> -Bjarni Ingi Gislason <bjarniig@rhi.hi.is> -Christian Brauner <christian@brauner.io> -devi R.K <devi.feb27@gmail.com> -Dmitry Safonov <dima@arista.com> -Eric Biggers <ebiggers@google.com> -Eric Dumazet <eric.dumazet@gmail.com> -Eric Rannaud <e@nanocritical.com> +Alexander Monakov <amonakov@ispras.ru> +Alexander Morozov <alexandermv@gmail.com> +Alexopo Seid <alexopo.ceid@gmail.com> +Amir Goldstein <amir73il@gmail.com> +Andi Kleen <andi@firstfloor.org> +Andrea Galbusera <gizero@gmail.com> +Arnd Bergmann <arnd@arndb.de> +Branden Robinson <g.branden.robinson@gmail.com> +Brian Geffon <bgeffon@google.com> +Bruno Haible <bruno@clisp.org> +Chris Lamb <lamby@debian.org> +Christian Brauner <christian.brauner@ubuntu.com> +Dave Hansen <dave.hansen@linux.intel.com> +Dave Martin <Dave.Martin@arm.com> +David Adam <zanchey@ucc.gu.uwa.edu.au> +Devin J. Pohly <djpohly@gmail.com> +Dmitry V. Levin <ldv@altlinux.org> +Eric Hopper <hopper@omnifarious.org> +Eric Sandeen <sandeen@redhat.com> Eugene Syromyatnikov <evgsyr@gmail.com> +Fabien Siron <fabien.siron@epita.fr> +Florian Weimer <fweimer@redhat.com> +Gary Perkins <glperkins@lit.edu> +Geoff Clare <gwc@opengroup.org> +Goldwyn Rodrigues <rgoldwyn@suse.com> +Heiko Carstens <heiko.carstens@de.ibm.com> Heinrich Schuchardt <xypron.glpk@gmx.de> -Helge Deller <deller@gmx.de> +Helge Kreutzmann <debian@helgefjell.de> +Ian Rogers <irogers@google.com> +Idan Katz <idanski1@gmail.com> Jakub Wilk <jwilk@jwilk.net> -Jorgen Hansen <jhansen@vmware.com> -Julia Suvorova <jusual@mail.ru> +Jan Kara <jack@suse.cz> +Jan Moskyto Matejka <mq@ucw.cz> +Jason Etherton <jason@ethertonltd.co.uk> +Jeff Moyer <jmoyer@redhat.com> +John Marshall <John.W.Marshall@glasgow.ac.uk> +Jonny Grant <jg@jguk.org> +Joseph C. Sible <josephcsible@gmail.com> +Jürgen Sauermann <mail@juergen-sauermann.de> +Kai Mäkisara <kai.makisara@kolumbus.fi> Keno Fischer <keno@juliacomputing.com> -Krzysztof Małysa <varqox@gmail.com> -Marc Lehmann <debian-reportbug@plan9.de> +Kirill A. Shutemov <kirill@shutemov.name> +Kirill Smelkov <kirr@nexedi.com> +Kir Kolyshkin <kolyshkin@gmail.com> +Léo Stefanesco <leo.lveb@gmail.com> +Li Xinhai <lixinhai.lxh@gmail.com> +Lokesh Gidra <lokeshgidra@google.com> +Lukas Czerner <lczerner@redhat.com> +Manfred Spraul <manfred@colorfullife.com> +Marco Curreli <marcocurreli@tiscali.it> +Marcus Gelderie <redmnic@gmail.com> +Martin Doucha <mdoucha@suse.cz> Matthew Bobrowski <mbobrowski@mbobrowski.org> -Michael Galassi <michael@galassi.us> Michael Kerrisk <mtk.manpages@gmail.com> -Michal Hocko <mhocko@kernel.org> -Mike Christie <mchristi@redhat.com> -Mike Frysinger <vapier@gentoo.org> -Pablo M. Ronchi <pmronchi@yahoo.com.ar> -Ricardo Biehl Pasquali <pasqualirb@gmail.com> -Stefan Hajnoczi <stefanha@redhat.com> -Stefano Garzarella <sgarzare@redhat.com> -Thomas Gleixner <tglx@linutronix.de> -Walter Harms <wharms@bfs.de> -Zack Weinberg <zackw@panix.com> +Michal Hocko <mhocko@suse.com> +Nikola Forró <nforro@redhat.com> +Olivier Gayot <olivier.gayot@sigexec.com> +Ondrej Slamecka <ondrej@slamecka.cz> +Paul Eggert <eggert@cs.ucla.edu> +Peter Schiffer <pschiffe@redhat.com> +Peter Wu <peter@lekensteyn.nl> +Petr Vorel <pvorel@suse.cz> +Piotr Caban <piotr@codeweavers.com> +Ricardo Castano <ricardo.castano.salinas@gmail.com> +Richard Cochran <richardcochran@gmail.com> +Richard Palethorpe <rpalethorpe@suse.com> +Russell King <rmk+kernel@armlinux.org.uk> +Stefan Puiu <stefan.puiu@gmail.com> +Thierry Lelegard <thierry.lelegard@canal-plus.fr> +Thomas Piekarski <t.piekarski@deloquencia.de> +Tobias Stoeckmann <tobias@stoeckmann.org> +Urs Thuermann <urs@isnogud.escape.de> +Vincent Lefèvre <vincent-srcware@vinc17.net> +Vlad <cvazir@gmail.com> +vrafaeli@msn.com +walter harms <wharms@bfs.de> +Will Deacon <will@kernel.org> +Yang Shi <yang.shi@linux.alibaba.com> +YunQiang Su <syq@debian.org> Apologies if I missed anyone! @@ -55,89 +99,83 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -openat2.2 - Aleksa Sarai [Michael Kerrisk] - Document new openat2(2) syscall +ioctl_fslabel.2 + Eric Sandeen + New page documenting filesystem get/set label ioctl(2) operations -pidfd_getfd.2 - Michael Kerrisk [Christian Brauner] - New manual page documenting the pidfd_getfd() system call -select.2 - Michael Kerrisk - Rewrite DESCRIPTION - Improve structure and readability, at the same time incorporating - text and details that were formerly in select_tut(2). Also - move a few details in other parts of the page into DESCRIPTION. - Michael Kerrisk - Consolidate the discussion of pselect into a headed subsection - Michael Kerrisk - Consolidate historical glibc pselect() details under one subhead - Michael Kerrisk - Consolidate info on usleep() emulation in one place - Michael Kerrisk - Place the discussion of the self-pipe technique in a headed subsection - Michael Kerrisk - Note that FD_SET() and FD_CLR() do not return errors - Michael Kerrisk - Remove details of historical #include requirements - The POSIX situation has been the norm for a long time now, - and including ancient details overcomplicates the page. - Michael Kerrisk - Remove some ancient information about pre-POSIX types for 'timeout' +Removed pages +------------- -select_tut.2 - Michael Kerrisk - Eliminate duplication of info across select_tut.2 and select2 - There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION - RETURN VALUE, and SEE ALSO. Move all of the info to one place: - the select(2) page. +ioctl_list.2 + Michael Kerrisk [Heinrich Schuchardt, Eugene Syromyatnikov] + This page was first added more than 20 years ago. Since + that time it has seen hardly any update, and is by now + very much out of date, as reported by Heinrich Schuchardt + and confirmed by Eugene Syromyatnikov. -sysvipc.7 - Michael Kerrisk - Rewrite this page as just a summary of the System V IPC APIs - All of the other details in this page have by now been moved into - the relevant *ctl(2) pages. + As Heinrich says: + + Man-pages like netdevices.7 or ioctl_fat.2 are what is + needed to help a user who does not want to read through the + kernel code. -time_namespaces.7 - Michael Kerrisk [Andrei Vagin, Dmitry Safonov, Thomas Gleixner] - New page documenting time namespaces + If ioctl_list.2 has not been reasonably maintained since + Linux 1.3.27 and hence is not a reliable source of + information, shouldn't it be dropped? + + My answer is, yes (but let's move a little info into ioctl(2)). Newly documented interfaces in existing pages --------------------------------------------- -arch_prctl.2 - Keno Fischer - Add ARCH_SET_CPUID subcommand +adjtimex.2 + Arnd Bergmann [Richard Cochran, Michael Kerrisk] + Document clock_adjtime(2) clock_getres.2 - Benjamin Peterson - Document CLOCK_TAI - Michael Kerrisk - Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM + Richard Cochran [Michael Kerrisk] + Explain dynamic clocks -prctl.2 - Mike Christie [Michal Hocko, Michael Kerrisk, Bart Van Assche] - Document PR_SETIO_FLUSHER/GET_IO_FLUSHER +clone.2 + Christian Brauner, Michael Kerrisk + Document the clone3() CLONE_INTO_CGROUP flag -setns.2 - Michael Kerrisk - Document CLONE_NEWTIME +mremap.2 + Brian Geffon, Michael Kerrisk [Lokesh Gidra] + Document MREMAP_DONTUNMAP + +open.2 + Joseph C. Sible [Michael Kerrisk] + Document fs.protected_fifos and fs.protected_regular + +prctl.2 + Dave Martin + Add PR_SPEC_INDIRECT_BRANCH for SPECULATION_CTRL prctls + Dave Martin + Add PR_SPEC_DISABLE_NOEXEC for SPECULATION_CTRL prctls + Dave Martin + Add PR_PAC_RESET_KEYS (arm64) -statx.2 - Eric Biggers - Document STATX_ATTR_VERITY +ptrace.2 + Joseph C. Sible + Document PTRACE_SET_SYSCALL -unshare.2 +proc.5 + Michael Kerrisk + Document /proc/sys/fs/protected_regular Michael Kerrisk - Document CLONE_NEWTIME + Document /proc/sys/fs/protected_fifos + Michael Kerrisk + Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nr + +New and changed links +--------------------- -socket.7 - Ricardo Biehl Pasquali, Michael Kerrisk - Add description of SO_SELECT_ERR_QUEUE - Alejandro Colomar [Michael Kerrisk] - Document SO_TIMESTAMPNS +clock_adjtime.2 + Arnd Bergmann + New link to adjtimex(2) Global changes @@ -145,346 +183,634 @@ Global changes Various pages Michael Kerrisk - Remove a few mentions of the ancient "Linux libc" + Retitle EXAMPLE section heading to EXAMPLES + EXAMPLES appears to be the wider majority usage across various + projects' manual pages, and is also what is used in the POSIX + manual pages. + +Various pages + Michael Kerrisk + Correct bogus POSIX.1 standards names + POSIX.1-2003 ==> POSIX.1-2001 TC1 + POSIX.1-2004 ==> POSIX.1-2001 TC2 + POSIX.1-2013 ==> POSIX.1-2008 TC1 + POSIX.1-2016 ==> POSIX.1-2008 TC2 Various pages Michael Kerrisk - Global formatting fix: disfavor nonstandard .TP indents - In many cases, these don't improve readability, and (when stacked) - they sometimes have the side effect of sometimes forcing text - to be justified within a narrow column range. + Add section number in page cross-reference. Various pages - Michael Kerrisk [Christian Brauner] - Fix clumsy wording around "nonnegative file descriptors" + Kir Kolyshkin + Add missing commas in SEE ALSO + +Various pages + Michael Kerrisk + Remove AVAILABILITY section heading + In the few pages where this heading (which is "nonstandard" within + man-pages) is used, it always immediately follows CONFORMING TO + and generally contains information related to standards. Remove + the section heading, thus incorporating AVAILABILITY into + CONFORMING TO. + +Various pages + Michael Kerrisk + Remove section number in page self-references + +Various pages + Michael Kerrisk + Put SEE ALSO entries in alphabetical order + +Various pages + Michael Kerrisk + Place SH sections in standard order + Fix various pages that deviated from the norm described in + man-pages(7). + +Various "aio" pages + Michael Kerrisk [Andi Kleen, Jeff Moyer] + Change uses of aio_context_t to io_context_t Changes to individual pages --------------------------- -clock_getres.2 - Helge Deller [Michael Kerrisk] - Consecutive calls for CLOCK_MONOTONIC may return same value - Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed - to return MONOTONIC values, which means that they either return - the *SAME* time value like the last call, or a later (higher) time - value. - Eric Rannaud - Dynamic POSIX clock devices can return other errors - Michael Kerrisk - Improve description of CPU-time clocks +bpf.2 + Peter Wu + Update enum bpf_map_type and enum bpf_prog_type + Richard Palethorpe + Change note on unprivileged access + The kernel now allows calls to bpf() without CAP_SYS_ADMIN + under some circumstances. + +clone.2 Michael Kerrisk - Add an example program + Add kernel version numbers for clone_args fields Michael Kerrisk - CLOCK_REALTIME_COARSE is not settable + Combine separate NOTES sections + +close.2 + Michael Kerrisk [Lukas Czerner, Peter Schiffer, Thierry Lelegard] + Note behavior when close() happens in a parallel thread + If one thread is blocked in an I/O system call on a file descriptor + that is closed in another thread, then the blocking system call + does not return immediately, but rather when the I/O operation + completes. This surprises some people, but is longstanding + behavior. + +connect.2 + Stefan Puiu + Can return EACCES because of SELinux + +execve.2 + Michael Kerrisk [Eric Hopper] + Changes to the "dumpable" flag may change ownership of /proc/PID files Michael Kerrisk - Note that CPU-time clocks are not settable. - Explicitly note that CLOCK_PROCESS_CPUTIME_ID and - CLOCK_PROCESS_CPUTIME_ID are not settable. + Improve/correct discussion of changes to dumpable flag during execve(2) + The details were not quite accurate. Defer to prctl(2) + for the more complete picture. + Nikola Forró + Clarify signal sent to the process on late failure Michael Kerrisk - Clarify that CLOCK_TAI is nonsettable + SEE ALSO: add capabilities(7) + +fanotify_init.2 + Amir Goldstein [Matthew Bobrowski] + Move out of place entry FAN_REPORT_FID + It was inserted in the middle of the FAN_CLASS_ multi flags bit + and broke the multi flag documentation. + Michael Kerrisk [Alexander Morozov, Amir Goldstein, Jan Kara] + Remove mention of FAN_Q_OVERFLOW as an input value in 'mask' + See https://bugzilla.kernel.org/show_bug.cgi?id=198569. + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Clarification about FAN_EVENT_ON_CHILD and new events + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Clarification about FAN_MARK_MOUNT and FAN_REPORT_FID + +getdents.2 + Petr Vorel [Michael Kerrisk] + Mention glibc support for getdents64() + Support was added in glibc 2.30. + Chris Lamb + Correct linux_dirent definition in example code + It is "unsigned long" earlier up in the file + +gettid.2 + Michael Kerrisk [Joseph C. Sible] + Document header file and feature test macro requirements for gettid() + +ioctl.2 Michael Kerrisk - Clarify that CLOCK_MONOTONIC is system-wide + SEE ALSO: add ioctl_fslabel(2) Michael Kerrisk - ERRORS: add EINVAL for attempt to set a nonsettable clock + Remove mentions of ioctl_list(2) Michael Kerrisk - Move text in BUGS to NOTES - The fact that CLOCK_PROCESS_CPUTIME_ID and - CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug, - since POSIX does allow the possibility that these clocks - are not settable. + Move subsection on "ioctl structure" from ioctl_list(2) to ioctl(2) + +io_setup.2 Michael Kerrisk - SEE ALSO: add time_namespaces(7) + Tweak description of /proc/sys/fs/aio-max-nr -clock_nanosleep.2 +mbind.2 + Li Xinhai [Michael Kerrisk] + Remove note about MPOL_MF_STRICT been ignored + +mmap.2 + Michael Kerrisk [Heinrich Schuchardt] + Don't mark MAP_ANON as deprecated + +move_pages.2 + Yang Shi [Michal Hocko] + Returning positive value is a new error case + +mremap.2 + Michael Kerrisk + Remove mention of "Segmentation fault" in EFAULT text + "Segmentation fault" (SIGSEGV) is not exactly the same thing as + EFAULT. Michael Kerrisk - clock_nanosleep() can also sleep against CLOCK_TAI + Reorder some paragraphs in NOTES Michael Kerrisk - clock_nanosleep() also supports CLOCK_BOOTTIME - Presumably (and from a quick glance at the source code) - since Linux 2.6.39, when CLOCK_BOOTTIME was introduced. + Move a paragraph from DESCRIPTION to NOTES -clock_nanosleep.2 -timer_create.2 -timerfd_create.2 +msgctl.2 Michael Kerrisk - Add various missing errors - Mostly verified by testing and reading the code. + Correct description of 'msg_ctime' field + Verified by inspecting kernel source. - There is unfortunately quite a bit of inconsistency across API~s: +nfsservctl.2 + Michael Kerrisk + SEE ALSO: add nfsd(7) - clock_gettime clock_settime clock_nanosleep timer_create timerfd_create +open.2 + Michael Kerrisk + Some '*at' APIs have functionality that isn't in conventional APIs + Note that another reason to use the *at() APIs is to access + 'flags' functionality that is not available in the corresponding + conventional APIs. + Michael Kerrisk + Add a few more APIs to list in "Rationale for openat()..." + There have been a few more dirfd APIs added in recent times. + Michael Kerrisk + Explain ways in which a 'directory file descriptor' can be obtained + Michael Kerrisk + Add openat2() to list of APIs that take a 'dirfd' argument - CLOCK_BOOTTIME y n (EINVAL) y y y - CLOCK_BOOTTIME_ALARM y n (EINVAL) y [1] y [1] y [1] - CLOCK_MONOTONIC y n (EINVAL) y y y - CLOCK_MONOTONIC_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL) - CLOCK_MONOTONIC_RAW y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL) - CLOCK_REALTIME y y y y y - CLOCK_REALTIME_ALARM y n (EINVAL) y [1] y [1] y [1] - CLOCK_REALTIME_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL) - CLOCK_TAI y n (EINVAL) y y n (EINVAL) - CLOCK_PROCESS_CPUTIME_ID y n (EINVAL) y y n (EINVAL) - CLOCK_THREAD_CPUTIME_ID y n (EINVAL) n (EINVAL [2]) y n (EINVAL) - pthread_getcpuclockid() y n (EINVAL) y y n (EINVAL) +openat2.2 + Michael Kerrisk [Aleksa Sarai] + Various changes after feedback from Aleksa Sarai - [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results. +poll.2 + Michael Kerrisk + Add license to example program - [2] This error is generated in the glibc wrapper. +prctl.2 + Dave Martin + Sort prctls into alphabetical order + Dave Martin + Clarify that prctl can apply to threads + The current synopsis for prctl(2) misleadingly claims that prctl + operates on a process. Rather, some (in fact, most) prctls operate + Dave Martin [Dave Hansen] + Document removal of Intel MPX prctls + Dave Martin + Fix mis-description of thread ID values in procfs + Dave Martin + Work around bogus constant "maxsig" in PR_SET_PDEATHSIG + Michael Kerrisk + Add reference to proc(5) for /proc/self/task/[tid]/comm + Dave Martin [Michael Kerrisk] + Add health warning + Dave Martin + Clarify the unsupported hardware case of EINVAL + +rename.2 + Michael Kerrisk + SEE ALSO: add rename(1) + +s390_runtime_instr.2 + Heiko Carstens [Eugene Syromyatnikov, Michael Kerrisk] + Document signum argument behavior change + Document that the signum argument is ignored in newer kernels, but + that user space should pass a valid real-time signal number for + backwards compatibility. -connect.2 - Michael Kerrisk [Eric Dumazet] - Update the details on AF_UNSPEC - Update the details on AF_UNSPEC and circumstances in which - socket can be reconnected. +semctl.2 + Michael Kerrisk [Manfred Spraul] + Correct description of sem_ctime field -dup.2 +semget.2 Michael Kerrisk - SEE ALSO: add pidfd_getfd(2) + Add license to example program -epoll_ctl.2 +shmctl.2 Michael Kerrisk - Various minor additions and clarifications + Correct 'shm_ctime' description -epoll_wait.2 +shmop.2 Michael Kerrisk - A few minor additions and rewrites + Add license to example programs -execve.2 - Michael Kerrisk - Add a subhead for the discussion of effect on process attributes - Michael Kerrisk - Explicitly note that argv[argc] == NULL in the new program - Michael Kerrisk - ERRORS: ENOENT does not occur for missing shared libraries - See http://sourceware.org/bugzilla/show_bug.cgi?id=12241. +statfs.2 + Michael Kerrisk [David Adam] + Add SMB2 constant to filesystem types list -_exit.2 - Michael Kerrisk - Clarify that raw _exit() system call terminates only the calling thread +syscall.2 + Dave Martin [Will Deacon] + arm64: Fix syscall number register size + Dave Martin [Russell King] + arm: Use real register names for arm/OABI -inotify_add_watch.2 +sysfs.2 Michael Kerrisk - EXAMPLE: add reference to example in inotify(7) + SEE ALSO: add proc(5) and sysfs(5) -io_submit.2 - Julia Suvorova - Add IOCB_CMD_POLL opcode +utimensat.2 + Goldwyn Rodrigues + Immutable flag returns EPERM + Linux kernel commit 337684a1746f "fs: return EPERM on immutable + inode" changed the return value of the utimensat(2) from -EACCES + to -EPERM in case of an immutable flag. -lseek.2 +wait4.2 Michael Kerrisk - ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file + Update wait3() feature test macro requirements for changes in glibc 2.26 -madvise.2 - Michael Kerrisk [Andrea Arcangeli] - Incorporate some (ancient) comments about MADV_HUGEPAGE - Back in 2011, a mail from Andrea Arcangeli noted some details - that I never got round to incorporating into the manual page. - -mmap.2 +cexp2.3 Michael Kerrisk - Add a subhead for the 'flags' argument + Still not present in glibc 2.31 + +cmsg.3 Michael Kerrisk - Move some text hidden at the end of DESCRIPTION to NOTES + CONFORMING TO: note which CMSG_* APIs are in current and upcoming POSIX -msgctl.2 +dirfd.3 Michael Kerrisk - Add information on permission bits (based on sysvipc(7) text) + SEE ALSO: add openat(2) + +dlsym.3 + Alexander Monakov + Extend discussion of NULL symbol values + Avoid implying that use of IFUNC is the only way to produce a + symbol with NULL value. Give more scenarios how a symbol may get + NULL value, but explain that in those scenarios dlsym() will fail + with Glibc's ld.so due to an implementation inconsistency. + +err.3 Michael Kerrisk - Copy information on 'msqid_ds' fields from sysvipc(7) + EXAMPLES: use EXIT_FAILURE rather than 1 as exit status -open.2 +expm1.3 Michael Kerrisk - Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname' - Aleksa Sarai - Add references to new openat2(2) page + The expm1() bogus underflow floating-point exception has been fixed + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6778 Michael Kerrisk - Note EINVAL error for invalid character in basename of 'pathname' + The bogus invalid floating-point exception bug has been fixed + https://www.sourceware.org/bugzilla/show_bug.cgi?id=6814. -pidfd_open.2 +fdim.3 Michael Kerrisk - Mention pidfd_getfd(2) + BUGS: these functions did not set errno on some architectures + https://www.sourceware.org/bugzilla/show_bug.cgi?id=6796 -poll.2 +ftw.3 Michael Kerrisk - Add an example program + glibc eventually fixed a regression in FTW_SLN behavior + For details, see: + https://bugzilla.redhat.com/show_bug.cgi?id=1422736 + http://austingroupbugs.net/view.php?id=1121 + https://bugzilla.redhat.com/show_bug.cgi?id=1422736 + +getauxval.3 + YunQiang Su + MIPS, AT_BASE_PLATFORM passes ISA level + +getdtablesize.3 Michael Kerrisk - Mention epoll(7) in the introductory paragraph + Remove redundant statement that getdtablesize() is a library function + +gethostbyname.3 + Michael Kerrisk [Helge Kreutzmann] + +malloc.3 Michael Kerrisk - Improve description of EFAULT error + Add 'reallocarray' in NAME Michael Kerrisk - Fix description of ENOMEM error + Add VERSIONS section noting when reallocarray() was added to glibc -select_tut.2 +newlocale.3 + Michael Kerrisk [Piotr Caban] + Fix a valgrind issue in example program + See https://bugzilla.kernel.org/show_bug.cgi?id=202977. + +nextafter.3 Michael Kerrisk - Adjust header file includes in example - Employ <sys/select.h>, rather than the historical header files. + Since glibc 2.23, these functions do set errno + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799. -semctl.2 +posix_spawn.3 + Olivier Gayot [Adhemerval Zanella] + Clarify by using name of steps rather than syscalls + Olivier Gayot [Adhemerval Zanella] + Document implementation using clone() since glibc 2.24 + Olivier Gayot [Adhemerval Zanella] + Document POSIX_SPAWN_USEVFORK + Added a few lines about POSIX_SPAWN_USEVFORK so that it appears + clearly that since glibc 2.24, the flag has no effect. + Olivier Gayot [Adhemerval Zanella] + Document the POSIX_SPAWN_SETSID attribute + +pow.3 Michael Kerrisk - Copy information on 'semid_ds' fields from sysvipc(7) + BUGS: pow() performance problem for some (rare) inputs has been fixed + See https://sourceware.org/bugzilla/show_bug.cgi?id=13932 Michael Kerrisk - Add a reference to the example in shmop(2) + Several bugs in glibc's pow() implementation were fixed in glibc 2.16 + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866. Michael Kerrisk - Add information on permission bits (based on sysvipc(7) text) + Add a subheading to mark off historical bugs that are now fixed -semget.2 +printf.3 + Tobias Stoeckmann + Prevent signed integer overflow in example + +ptsname.3 + Bruno Haible + Fix description of failure behaviour of ptsname_r() + +random.3 + John Marshall + Change "RAND_MAX" tp "2^31-1" + +scalb.3 Michael Kerrisk - EXAMPLE: add an example program + These functions now correctly set errno for the EDOM and ERANGE cases + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 + and https://www.sourceware.org/bugzilla/show_bug.cgi?id=6804 -semop.2 +scalbln.3 Michael Kerrisk - Add a reference to the semop(2) example in shmop(2) + These functions now correctly set errno for the ERANGE case + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 -shmctl.2 +scanf.3 + Michael Kerrisk [Jürgen Sauermann] + Clarify that 'x' specifier allows a 0x/0X prefix in input string + +sem_getvalue.3 + Michael Kerrisk [Andrea Galbusera] + Note that glibc's sem_getvalue() doesn't return EINVAL errors + See https://bugzilla.kernel.org/show_bug.cgi?id=204273 + +setlogmask.3 Michael Kerrisk - Add information on permission bits (based on sysvipc(7) text) + Note that LOG_UPTO() is included in the next POSIX release + +shm_open.3 Michael Kerrisk - Note that execute permission is not needed for shmat() SHM_EXEC + Add license to example programs + +sincos.3 Michael Kerrisk - Copy information on 'shmid_ds' fields from sysvipc(7) + The glibc implementation does now give EDOM for a domain error + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467 + +stdarg.3 Michael Kerrisk - Some small improvements to the description of the 'shmid_ds' structure + SEE ALSO: add vprintf(3), vscanf(3), vsyslog(3) -shmget.2 +strcmp.3 Michael Kerrisk - Add a reference to the example in shmop(2) + Add license to example programs -shmop.2 +strftime.3 + Urs Thuermann + ISO week number can be 52, add example + +y0.3 + Michael Kerrisk + These functions now correctly diagnose a pole error + https://sourceware.org/bugzilla/show_bug.cgi?id=6807 Michael Kerrisk - EXAMPLE: add a pair of example programs - Add example programs demonstrating usage of shmget(2), shmat(2), - semget(2), semctl(2), and semop(2). + errno is now correctly set to ERANGE on underflow + https://www.sourceware.org/bugzilla/show_bug.cgi?id=6808 -sigaction.2 -signal.7 - Zack Weinberg - Document kernel bugs in delivery of signals from CPU exceptions +loop.4 + Michael Kerrisk [Vlad] + 'lo_flags' is nowadays "r/w" + See https://bugzilla.kernel.org/show_bug.cgi?id=203417 -stat.2 +veth.4 + Devin J. Pohly + Add a more direct example + iproute2 allows you to specify the netns for either side of a veth + interface at creation time. Add an example of this to veth(4) so + it doesn't sound like you have to move the interfaces in a + separate step. + +core.5 + Michael Kerrisk [Jonny Grant] + Mention 'sysctl -w' as a way of changing core_pattern setting + Michael Kerrisk [Jonny Grant] + Note that not dumping core of an unreadable binary is a security measure + Michael Kerrisk [Jonny Grant] + Explain that core_pattern %e is process/thread 'comm' value + The 'comm' value is typically the same as the (possibly + truncated) executable name, but may be something different. + +filesystems.5 Michael Kerrisk - Clarify definitions of timestamp fields - In particular, make it clear that atime and mtime relate to the - file *data*. + SEE ALSO: add sysfs(5) and xfs(5) -syscalls.2 +locale.5 + Michael Kerrisk [Helge Kreutzmann] + Improve description of 'first_weekday' + +proc.5 Michael Kerrisk - Add new Linux 5.6 system calls + Note kernel version for /proc/PID/smaps VmFlags "wf" flag Michael Kerrisk - Note that the 5.x series followed 4.20 - -timer_create.2 + Add "um" and "uw" to VmFlags in /proc/[pid]/smaps + Added in kernel commit 16ba6f811dfe44bc14f7946a4b257b85476fc16e. + Text taken from comments in include/linux/mm.h. Michael Kerrisk - timer_create(2) also supports CLOCK_TAI + Add "mp" to VmFlags in /proc/[pid]/smaps + Added in kernel commit 4aae7e436fa51faf4bf5d11b175aea82cfe8224a. Michael Kerrisk - Mention clock_getres(2) for further details on the various clocks - -timerfd_create.2 - Michael Kerrisk [Thomas Gleixner] - Note a case where timerfd_settime() can fail with ECANCELED - Michael Kerrisk [devi R.K, Thomas Gleixner] - Negative changes to CLOCK_REALTIME may cause read() to return 0 + Note kernel version that removed /proc/PID/smaps VmFlags "nl" flag + Kernel commit 1da4b35b001481df99a6dcab12d5d39a876f7056 + Ian Rogers + Add "wf" to VmFlags in /proc/[pid]/smaps Michael Kerrisk - Rework text for EINVAL for invalid clock ID + Note kernel version for /proc/PID/smaps VmFlags "dd" flag + Kernel commit ec8e41aec13005fed0dbee002fb8c99b4e001d50 Michael Kerrisk - Refer reader to clock_getres(2) for further details on the clocks - -unshare.2 + Add "sf" to VmFlags in /proc/[pid]/smaps + Added in kernel commit b6fb293f2497a9841d94f6b57bd2bb2cd222da43 + Text from comment in include/uapi/asm-generic/mman.h. + Michael Kerrisk [Kirill A. Shutemov] + Remove "mp" under VmFlags in /proc/[pid]/smaps + Michael Kerrisk [Eric Hopper] + Alert the reader that UID/GID changes can reset the "dumpable" attribute + Keno Fischer + Fix an outdated note about map_files + The restriction to CAP_SYS_ADMIN was removed from map_files in 2015. + Michael Kerrisk [Helge Kreutzmann] + Better explanation of some /proc/ide fields + Michael Kerrisk + TASK_COMM_LEN limit includes the terminating '\0' + Clarify this detail in the discussion of /proc/[pid]/comm. Michael Kerrisk - Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program + Add a detail to /proc/[pid]/comm + Note the connection to the "%e" specifier in + /proc/sys/kernel/core_pattern. -exit.3 - Michael Kerrisk [Walter Harms] - Small improvement to the discussion of 'status' argument +securetty.5 + Michael Kerrisk [Helge Kreutzmann] + Improve wording of .SH one-line description -ftok.3 +tzfile.5 Michael Kerrisk - EXAMPLE: add a reference to the example in semget(2) - -getifaddrs.3 - Michael Kerrisk [Michael Galassi] - EXAMPLE: remove unneeded loop variable + Sync to 2020a tzdb release + From https://www.iana.org/time-zones, version 2020a. + Michael Kerrisk + Explain UT abbreviation -nl_langinfo.3 - Eugene Syromyatnikov - Document era-related locale elements - Eugene Syromyatnikov - Add information about AM/PM time format locale elements - Eugene Syromyatnikov - Mention the respective strftime(3) conversion specifications +ascii.7 + Michael Kerrisk [Helge Kreutzmann] + SEE ALSO: fix sort order in entries -sem_init.3 +bpf-helpers.7 Michael Kerrisk - Add references to example code in shm_open(3) and sem_wait(3) + Resync against kernel 5.7 -sem_post.3 +cgroups.7 + Marcus Gelderie + Mention cgroup.sane_behavior file + The cgroup.sane_behavior file returns the hard-coded value "0" and + is kept for legacy purposes. Mention this in the man-page. Michael Kerrisk - Add a reference to code example code in shm_open(3) + Note the existence of the clone3() CLONE_INTO_CGROUP flag -shm_open.3 +credentials.7 Michael Kerrisk - EXAMPLE: add some example programs - -strcmp.3 + Alert reader that UID/GID changes can affect process capabilities Michael Kerrisk - Add an example program - Michael Kerrisk [Andrew Micallef, Walter Harms] - Rework text describing return value to be clearer + Changes to process UIDs/GIDs can effect the "dumpable" attribute Michael Kerrisk - Note that the comparison is done using unsigned char + Add a list of the APIs that change a process's credentials + +fanotify.7 + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Fix fanotify_fid.c example Michael Kerrisk - SEE ALSO: add ascii(7) + Wrap some long lines in example program -strftime.3 - Eugene Syromyatnikov [Michael Kerrisk] - Refer to the relevant nl_langinfo(3) items - Eugene Syromyatnikov - Expand %E and %O description - Eugene Syromyatnikov - Consistently document fall-back format string +fanotify.7 +fanotify_mark.2 + Amir Goldstein [Matthew Bobrowski] + Clarify FAN_ONDIR in output mask + FAN_ONDIR was an input only flag before introducing + FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can + also be in output mask. -proc.5 - Mike Frysinger - Clarify /proc/[pid]/cmdline mutability +hier.7 + Thomas Piekarski [Gary Perkins] + Updating from FHS 2.3 to 3.0 + See https://bugzilla.kernel.org/show_bug.cgi?id=206693 -cgroups.7 +inotify.7 + Michael Kerrisk [Jason Etherton] + Add missing #include in example program + +ip.7 + Michael Kerrisk [Martin Doucha] + Note a few more valid 'protocol' values + See https://bugzilla.kernel.org/show_bug.cgi?id=204981 + Michael Kerrisk + SEE ALSO: add netdevice(7) + +man-pages.7 Michael Kerrisk - Update list of cgroups v2 controllers - Update the list of cgroups v2 controllers (several controllers - were missing). + Rename EXAMPLE to EXAMPLES Michael Kerrisk - Add a subsection on cgroup v2 mount options and include 'nsdelegate' + Describe COPYRIGHT section + man-pages doesn't use COPYRIGHT sections in manual pages, but + various projects do. Make some recommendations about placement + of the section. Michael Kerrisk - Document the cgroups v2 'memory_localevents' mount option + Add REPORTING BUGS section + man-pages doesn't have a REPORTING BUGS section in manual pages, + but many other projects do. Make some recommendations about + placement of that section. Michael Kerrisk - SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst + Mention AUTHORS in summary section list + Although man-pages doesn't use AUTHORS sections, many projects do + use an AUTHORS section in their manual pages, so mention it in + man-pages to suggest some guidance on the position at which + to place that section. -namespaces.7 +mount_namespaces.7 Michael Kerrisk - Add time namespaces information + SEE ALSO: add mount(8), umount(8) + +namespaces.7 Michael Kerrisk - Eliminate some superfluous info from display of /proc/PID/ns links + Document /proc/sys/user/max_time_namespaces -path_resolution.7 - Aleksa Sarai - Update to mention openat2(2) features +netlink.7 + Michael Kerrisk [Idan Katz] + Update path for NETLINK_CONNECTOR docs in kernel source tree + Michael Kerrisk [Fabien Siron] + Note that NETLINK_SOCK_DIAG is preferred over NETLINK_INET_DIAG -socket.7 +pid_namespaces.7 Michael Kerrisk - Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS - -tcp.7 + Note that /proc/sys/kernel/ns_last_pid is virtualized per PID NS Michael Kerrisk - SEE ALSO: mention Documentation/networking/ip-sysctl.txt + Correct capability requirements for write to /proc/sys/kernel/ns_last_pid + CAP_SYS_ADMIN is needed in the user NS that owns the PID NS. + +rtnetlink.7 + Jan Moskyto Matejka [Michael Kerrisk] + Add missing RTA_* attributes + Used Bird's source code, kernel source code, iproute2 source code + and iproute2 manpages to find meanings of these new attributes. -time.7 +standards.7 + Michael Kerrisk [Geoff Clare] + Add some more standards + Add: SUSv4 2016 edition, POSIX.1-2017, and SUSv4 2018 edition Michael Kerrisk - Add small subsection on clocks and time namespaces + Remove mention of bogus "POSIX" names + The terms POSIX.1-{2003,2004,2013,2016} were inventions of + my imagination, as confirmed by consulting Geoff Clare of + The Open Group. Remove these names. -unix.7 - Heinrich Schuchardt - Correct example +symlink.7 + Michael Kerrisk + Describe differences in the treatment of symlinks in the dirname + Describe differences in the treatment of symlinks in the dirname + part of pathname. -vsock.7 - Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi] - Add VMADDR_CID_LOCAL description +tcp.7 + Michael Kerrisk [vrafaeli@msn.com] + Update info on tcp_syn_retries default value + See https://bugzilla.kernel.org/show_bug.cgi?id=202885. + +user_namespaces.7 + Michael Kerrisk [Léo Stefanesco] + Clarify that "system time" means "calendar time" + +xattr.7 + Achilles Gaikwad + Add attr(1) as relevant page to SEE ALSO + +ldconfig.8 + Florian Weimer + Mention new default for --format in glibc 2.32 + +zdump.8 + Michael Kerrisk [Marco Curreli, Paul Eggert] + Update to latest upstream tz release + Look under "Latest version", which is 2020a. diff --git a/Changes.old b/Changes.old index 8c9d78f85..8f58543dd 100644 --- a/Changes.old +++ b/Changes.old @@ -50568,3 +50568,496 @@ vsock.7 ldconfig.8 DJ Delorie Document file filter and symlink pattern expectations + + +==================== Changes in man-pages-5.06 ==================== + +Released: 2020-04-11, 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: + +Alejandro Colomar <colomar.6.4.3@gmail.com> +Aleksa Sarai <cyphar@cyphar.com> +Alexander Miller <alex.miller@gmx.de> +Andrea Arcangeli <aarcange@redhat.com> +André Almeida <andrealmeid@collabora.com> +Andrei Vagin <avagin@gmail.com> +Andrew Micallef <andrew.micallef@live.com.au> +Bart Van Assche <bvanassche@acm.org> +Benjamin Peterson <benjamin@python.org> +Bjarni Ingi Gislason <bjarniig@rhi.hi.is> +Christian Brauner <christian@brauner.io> +devi R.K <devi.feb27@gmail.com> +Dmitry Safonov <dima@arista.com> +Eric Biggers <ebiggers@google.com> +Eric Dumazet <eric.dumazet@gmail.com> +Eric Rannaud <e@nanocritical.com> +Eugene Syromyatnikov <evgsyr@gmail.com> +Heinrich Schuchardt <xypron.glpk@gmx.de> +Helge Deller <deller@gmx.de> +Jakub Wilk <jwilk@jwilk.net> +Jorgen Hansen <jhansen@vmware.com> +Julia Suvorova <jusual@mail.ru> +Keno Fischer <keno@juliacomputing.com> +Krzysztof Małysa <varqox@gmail.com> +Marc Lehmann <debian-reportbug@plan9.de> +Matthew Bobrowski <mbobrowski@mbobrowski.org> +Matthew Wilcox <willy@infradead.org> +Michael Galassi <michael@galassi.us> +Michael Kerrisk <mtk.manpages@gmail.com> +Michal Hocko <mhocko@kernel.org> +Mike Christie <mchristi@redhat.com> +Mike Frysinger <vapier@gentoo.org> +Pablo M. Ronchi <pmronchi@yahoo.com.ar> +Ricardo Biehl Pasquali <pasqualirb@gmail.com> +Stefan Hajnoczi <stefanha@redhat.com> +Stefano Garzarella <sgarzare@redhat.com> +Thomas Gleixner <tglx@linutronix.de> +Walter Harms <wharms@bfs.de> +Zack Weinberg <zackw@panix.com> + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +openat2.2 + Aleksa Sarai [Michael Kerrisk] + Document new openat2(2) syscall + +pidfd_getfd.2 + Michael Kerrisk [Christian Brauner] + New manual page documenting the pidfd_getfd() system call + +select.2 + Michael Kerrisk + Rewrite DESCRIPTION + Improve structure and readability, at the same time incorporating + text and details that were formerly in select_tut(2). Also + move a few details in other parts of the page into DESCRIPTION. + Michael Kerrisk + Consolidate the discussion of pselect into a headed subsection + Michael Kerrisk + Consolidate historical glibc pselect() details under one subhead + Michael Kerrisk + Consolidate info on usleep() emulation in one place + Michael Kerrisk + Place the discussion of the self-pipe technique in a headed subsection + Michael Kerrisk + Note that FD_SET() and FD_CLR() do not return errors + Michael Kerrisk + Remove details of historical #include requirements + The POSIX situation has been the norm for a long time now, + and including ancient details overcomplicates the page. + Michael Kerrisk + Remove some ancient information about pre-POSIX types for 'timeout' + +select_tut.2 + Michael Kerrisk + Eliminate duplication of info across select_tut.2 and select2 + There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION + RETURN VALUE, and SEE ALSO. Move all of the info to one place: + the select(2) page. + +sysvipc.7 + Michael Kerrisk + Rewrite this page as just a summary of the System V IPC APIs + All of the other details in this page have by now been moved into + the relevant *ctl(2) pages. + +time_namespaces.7 + Michael Kerrisk [Andrei Vagin, Dmitry Safonov, Thomas Gleixner] + New page documenting time namespaces + + +Newly documented interfaces in existing pages +--------------------------------------------- + +arch_prctl.2 + Keno Fischer + Add ARCH_SET_CPUID subcommand + +clock_getres.2 + Benjamin Peterson + Document CLOCK_TAI + Michael Kerrisk + Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM + +prctl.2 + Mike Christie [Michal Hocko, Michael Kerrisk, Bart Van Assche] + Document PR_SETIO_FLUSHER/GET_IO_FLUSHER + +setns.2 + Michael Kerrisk + Document CLONE_NEWTIME + +statx.2 + Eric Biggers + Document STATX_ATTR_VERITY + +unshare.2 + Michael Kerrisk + Document CLONE_NEWTIME + +socket.7 + Ricardo Biehl Pasquali, Michael Kerrisk + Add description of SO_SELECT_ERR_QUEUE + Alejandro Colomar [Michael Kerrisk] + Document SO_TIMESTAMPNS + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Remove a few mentions of the ancient "Linux libc" + +Various pages + Michael Kerrisk + Global formatting fix: disfavor nonstandard .TP indents + In many cases, these don't improve readability, and (when stacked) + they sometimes have the side effect of sometimes forcing text + to be justified within a narrow column range. + +Various pages + Michael Kerrisk [Christian Brauner] + Fix clumsy wording around "nonnegative file descriptors" + + +Changes to individual pages +--------------------------- + +clock_getres.2 + Helge Deller [Michael Kerrisk] + Consecutive calls for CLOCK_MONOTONIC may return same value + Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed + to return MONOTONIC values, which means that they either return + the *SAME* time value like the last call, or a later (higher) time + value. + Eric Rannaud + Dynamic POSIX clock devices can return other errors + Michael Kerrisk + Improve description of CPU-time clocks + Michael Kerrisk + Add an example program + Michael Kerrisk + CLOCK_REALTIME_COARSE is not settable + Michael Kerrisk + Note that CPU-time clocks are not settable. + Explicitly note that CLOCK_PROCESS_CPUTIME_ID and + CLOCK_PROCESS_CPUTIME_ID are not settable. + Michael Kerrisk + Clarify that CLOCK_TAI is nonsettable + Michael Kerrisk + Clarify that CLOCK_MONOTONIC is system-wide + Michael Kerrisk + ERRORS: add EINVAL for attempt to set a nonsettable clock + Michael Kerrisk + Move text in BUGS to NOTES + The fact that CLOCK_PROCESS_CPUTIME_ID and + CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug, + since POSIX does allow the possibility that these clocks + are not settable. + Michael Kerrisk + SEE ALSO: add time_namespaces(7) + +clock_nanosleep.2 + Michael Kerrisk + clock_nanosleep() can also sleep against CLOCK_TAI + Michael Kerrisk + clock_nanosleep() also supports CLOCK_BOOTTIME + Presumably (and from a quick glance at the source code) + since Linux 2.6.39, when CLOCK_BOOTTIME was introduced. + +clock_nanosleep.2 +timer_create.2 +timerfd_create.2 + Michael Kerrisk + Add various missing errors + Mostly verified by testing and reading the code. + + There is unfortunately quite a bit of inconsistency across API~s: + + clock_gettime clock_settime clock_nanosleep timer_create timerfd_create + + CLOCK_BOOTTIME y n (EINVAL) y y y + CLOCK_BOOTTIME_ALARM y n (EINVAL) y [1] y [1] y [1] + CLOCK_MONOTONIC y n (EINVAL) y y y + CLOCK_MONOTONIC_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL) + CLOCK_MONOTONIC_RAW y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL) + CLOCK_REALTIME y y y y y + CLOCK_REALTIME_ALARM y n (EINVAL) y [1] y [1] y [1] + CLOCK_REALTIME_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL) + CLOCK_TAI y n (EINVAL) y y n (EINVAL) + CLOCK_PROCESS_CPUTIME_ID y n (EINVAL) y y n (EINVAL) + CLOCK_THREAD_CPUTIME_ID y n (EINVAL) n (EINVAL [2]) y n (EINVAL) + pthread_getcpuclockid() y n (EINVAL) y y n (EINVAL) + + [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results. + + [2] This error is generated in the glibc wrapper. + +connect.2 + Michael Kerrisk [Eric Dumazet] + Update the details on AF_UNSPEC + Update the details on AF_UNSPEC and circumstances in which + socket can be reconnected. + +dup.2 + Michael Kerrisk + SEE ALSO: add pidfd_getfd(2) + +epoll_ctl.2 + Michael Kerrisk + Various minor additions and clarifications + +epoll_wait.2 + Michael Kerrisk + A few minor additions and rewrites + +execve.2 + Michael Kerrisk + Add a subhead for the discussion of effect on process attributes + Michael Kerrisk + Explicitly note that argv[argc] == NULL in the new program + Michael Kerrisk + ERRORS: ENOENT does not occur for missing shared libraries + See http://sourceware.org/bugzilla/show_bug.cgi?id=12241. + +_exit.2 + Michael Kerrisk + Clarify that raw _exit() system call terminates only the calling thread + +inotify_add_watch.2 + Michael Kerrisk + EXAMPLE: add reference to example in inotify(7) + +io_submit.2 + Julia Suvorova + Add IOCB_CMD_POLL opcode + +lseek.2 + Michael Kerrisk [Matthew Wilcox] + ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file + +madvise.2 + Michael Kerrisk [Andrea Arcangeli] + Incorporate some (ancient) comments about MADV_HUGEPAGE + Back in 2011, a mail from Andrea Arcangeli noted some details + that I never got round to incorporating into the manual page. + +mmap.2 + Michael Kerrisk + Add a subhead for the 'flags' argument + Michael Kerrisk + Move some text hidden at the end of DESCRIPTION to NOTES + +msgctl.2 + Michael Kerrisk + Add information on permission bits (based on sysvipc(7) text) + Michael Kerrisk + Copy information on 'msqid_ds' fields from sysvipc(7) + +open.2 + Michael Kerrisk + Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname' + Aleksa Sarai + Add references to new openat2(2) page + Michael Kerrisk + Note EINVAL error for invalid character in basename of 'pathname' + +pidfd_open.2 + Michael Kerrisk + Mention pidfd_getfd(2) + +poll.2 + Michael Kerrisk + Add an example program + Michael Kerrisk + Mention epoll(7) in the introductory paragraph + Michael Kerrisk + Improve description of EFAULT error + Michael Kerrisk + Fix description of ENOMEM error + +select_tut.2 + Michael Kerrisk + Adjust header file includes in example + Employ <sys/select.h>, rather than the historical header files. + +semctl.2 + Michael Kerrisk + Copy information on 'semid_ds' fields from sysvipc(7) + Michael Kerrisk + Add a reference to the example in shmop(2) + Michael Kerrisk + Add information on permission bits (based on sysvipc(7) text) + +semget.2 + Michael Kerrisk + EXAMPLE: add an example program + +semop.2 + Michael Kerrisk + Add a reference to the semop(2) example in shmop(2) + +shmctl.2 + Michael Kerrisk + Add information on permission bits (based on sysvipc(7) text) + Michael Kerrisk + Note that execute permission is not needed for shmat() SHM_EXEC + Michael Kerrisk + Copy information on 'shmid_ds' fields from sysvipc(7) + Michael Kerrisk + Some small improvements to the description of the 'shmid_ds' structure + +shmget.2 + Michael Kerrisk + Add a reference to the example in shmop(2) + +shmop.2 + Michael Kerrisk + EXAMPLE: add a pair of example programs + Add example programs demonstrating usage of shmget(2), shmat(2), + semget(2), semctl(2), and semop(2). + +sigaction.2 +signal.7 + Zack Weinberg + Document kernel bugs in delivery of signals from CPU exceptions + +stat.2 + Michael Kerrisk + Clarify definitions of timestamp fields + In particular, make it clear that atime and mtime relate to the + file *data*. + +syscalls.2 + Michael Kerrisk + Add new Linux 5.6 system calls + Michael Kerrisk + Note that the 5.x series followed 4.20 + +timer_create.2 + Michael Kerrisk + timer_create(2) also supports CLOCK_TAI + Michael Kerrisk + Mention clock_getres(2) for further details on the various clocks + +timerfd_create.2 + Michael Kerrisk [Thomas Gleixner] + Note a case where timerfd_settime() can fail with ECANCELED + Michael Kerrisk [devi R.K, Thomas Gleixner] + Negative changes to CLOCK_REALTIME may cause read() to return 0 + Michael Kerrisk + Rework text for EINVAL for invalid clock ID + Michael Kerrisk + Refer reader to clock_getres(2) for further details on the clocks + +unshare.2 + Michael Kerrisk + Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program + +exit.3 + Michael Kerrisk [Walter Harms] + Small improvement to the discussion of 'status' argument + +ftok.3 + Michael Kerrisk + EXAMPLE: add a reference to the example in semget(2) + +getifaddrs.3 + Michael Kerrisk [Michael Galassi] + EXAMPLE: remove unneeded loop variable + +nl_langinfo.3 + Eugene Syromyatnikov + Document era-related locale elements + Eugene Syromyatnikov + Add information about AM/PM time format locale elements + Eugene Syromyatnikov + Mention the respective strftime(3) conversion specifications + +sem_init.3 + Michael Kerrisk + Add references to example code in shm_open(3) and sem_wait(3) + +sem_post.3 + Michael Kerrisk + Add a reference to code example code in shm_open(3) + +shm_open.3 + Michael Kerrisk + EXAMPLE: add some example programs + +strcmp.3 + Michael Kerrisk + Add an example program + Michael Kerrisk [Andrew Micallef, Walter Harms] + Rework text describing return value to be clearer + Michael Kerrisk + Note that the comparison is done using unsigned char + Michael Kerrisk + SEE ALSO: add ascii(7) + +strftime.3 + Eugene Syromyatnikov [Michael Kerrisk] + Refer to the relevant nl_langinfo(3) items + Eugene Syromyatnikov + Expand %E and %O description + Eugene Syromyatnikov + Consistently document fall-back format string + +proc.5 + Mike Frysinger + Clarify /proc/[pid]/cmdline mutability + +cgroups.7 + Michael Kerrisk + Update list of cgroups v2 controllers + Update the list of cgroups v2 controllers (several controllers + were missing). + Michael Kerrisk + Add a subsection on cgroup v2 mount options and include 'nsdelegate' + Michael Kerrisk + Document the cgroups v2 'memory_localevents' mount option + Michael Kerrisk + SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst + +namespaces.7 + Michael Kerrisk + Add time namespaces information + Michael Kerrisk + Eliminate some superfluous info from display of /proc/PID/ns links + +path_resolution.7 + Aleksa Sarai + Update to mention openat2(2) features + +socket.7 + Michael Kerrisk + Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS + +tcp.7 + Michael Kerrisk + SEE ALSO: mention Documentation/networking/ip-sysctl.txt + +time.7 + Michael Kerrisk + Add small subsection on clocks and time namespaces + +unix.7 + Heinrich Schuchardt + Correct example + +vsock.7 + Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi] + Add VMADDR_CID_LOCAL description @@ -1,6 +1,20 @@ This package contains Linux man pages for sections 1 through 8. Some more information is given in the 'man-pages-x.y.Announce' file. +Homepage +======== +For information about the Linux man-pages project, see +http://www.kernel.org/doc/man-pages/index.html. + +Bug reports and contributing +============================ +If you have corrections and additions to suggest, see +http://www.kernel.org/doc/man-pages/contributing.html +(Although there is a mirror of this repository on GitHub, +please don't report issues via the GitHub issue tracker!) + +For further information on contributing, see the CONTRIBUTING file. + Installing and uninstalling =========================== "make install" will copy these man pages to /usr/share/man/man[1-8]. @@ -15,23 +29,6 @@ use "prefix" if desired, as with the "install" target. "make" or "make all" will perform "make uninstall" followed by "make install". -Man page overlap and duplication -================================ -Note that sometimes these pages are duplicates of pages also distributed -in other packages. This has been reported about: - -man page also found in -------------------------------------- -resolver.3 bind-utils, bind9utils -resolv.conf.5 " -passwd.5 shadow, passwd -mailaddr.7 ? - Copyrights ========== See the 'man-pages-x.y.Announce' file. - -Homepage -======== -For much more about the Linux man-pages project, see -http://www.kernel.org/doc/man-pages/index.html. diff --git a/man-pages-5.06.Announce b/man-pages-5.07.Announce index 3fe33c320..111eaef08 100644 --- a/man-pages-5.06.Announce +++ b/man-pages-5.07.Announce @@ -1,7 +1,7 @@ RELEASE The Linux man page maintainer proudly announces. . . - man-pages-5.06.tar.gz - man pages for Linux + man-pages-5.07.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.06.lsm b/man-pages-5.07.lsm index 7d293696c..afeef0ebb 100644 --- a/man-pages-5.06.lsm +++ b/man-pages-5.07.lsm @@ -1,13 +1,13 @@ Begin3 Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 5.06 -Entered-date: 2020-04-11 +Version: 5.07 +Entered-date: 2020-06-09 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 - 2696k man-pages-5.06.tar.gz + 2708k man-pages-5.07.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 3c0561790..64bd2ee10 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/iconv.1 b/man1/iconv.1 index eb6e5a4d4..029c2d063 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -23,7 +23,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ICONV 1 2019-03-06 "GNU" "Linux User Manual" +.TH ICONV 1 2020-06-09 "GNU" "Linux User Manual" .SH NAME iconv \- convert text from one character encoding to another .SH SYNOPSIS @@ -178,7 +178,7 @@ Usual system default gconv module configuration file. Usual system gconv module configuration cache. .SH CONFORMING TO POSIX.1-2001. -.SH EXAMPLE +.SH EXAMPLES Convert text from the ISO 8859-15 character encoding to UTF-8: .PP .in +4n @@ -204,7 +204,7 @@ abc ss ? EUR abc .BR charsets (7), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/intro.1 b/man1/intro.1 index 4d369a341..2f37e12e3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/ldd.1 b/man1/ldd.1 index 41ac3773d..159cbebfc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/locale.1 b/man1/locale.1 index 1c144b718..7eda90a30 100644 --- a/man1/locale.1 +++ b/man1/locale.1 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LOCALE 1 2019-03-06 "Linux" "Linux User Manual" +.TH LOCALE 1 2020-06-09 "Linux" "Linux User Manual" .SH NAME locale \- get locale-specific information .SH SYNOPSIS @@ -136,7 +136,7 @@ Usual default locale archive location. Usual default path for locale definition files. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX $ \fBlocale\fP LANG=en_US.UTF\-8 @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/localedef.1 b/man1/localedef.1 index f964f83c2..b241fba09 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -220,10 +220,10 @@ file. Generate extra warnings about errors that are normally ignored. .TP .B \-\-big\-endian -Generate big-ending output. +Generate big-endian output. .TP .B \-\-little\-endian -Generate little-ending output. +Generate little-endian output. .TP .B \-\-no\-archive Do not use the locale archive file, instead create @@ -373,7 +373,7 @@ An output file that contains information about formatting of data and time values. .SH CONFORMING TO POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES Compile the locale files for Finnish in the UTF\-8 character set and add it to the default locale archive with the name .BR fi_FI.UTF\-8 : @@ -404,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusage.1 b/man1/memusage.1 index 5d4f1612b..8dffeb377 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -21,7 +21,7 @@ .\" License along with this manual; if not, see .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END -.TH MEMUSAGE 1 2019-03-06 "GNU" "Linux user manual" +.TH MEMUSAGE 1 2020-06-09 "GNU" "Linux user manual" .SH NAME memusage \- profile memory usage of a program .SH SYNOPSIS @@ -201,7 +201,7 @@ Exit status is equal to the exit status of profiled program. To report bugs, see .UR http://www.gnu.org/software/libc/bugs.html .UE -.SH EXAMPLE +.SH EXAMPLES Below is a simple program that reallocates a block of memory in cycles that rise to a peak before then cyclically reallocating the memory in smaller blocks that return to zero. @@ -269,10 +269,10 @@ main(int argc, char *argv[]) .EE .SH SEE ALSO .BR memusagestat (1), -.BR mtrace (1) +.BR mtrace (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusagestat.1 b/man1/memusagestat.1 index d16de75d5..822b18147 100644 --- a/man1/memusagestat.1 +++ b/man1/memusagestat.1 @@ -20,7 +20,7 @@ .\" License along with this manual; if not, see .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END -.TH MEMUSAGESTAT 1 2019-03-06 "GNU" "Linux programmer's manual" +.TH MEMUSAGESTAT 1 2020-06-09 "GNU" "Linux programmer's manual" .SH NAME memusagestat \- generate graphic from memory profiling data .SH SYNOPSIS @@ -82,14 +82,14 @@ Print version information and exit. To report bugs, see .UR http://www.gnu.org/software/libc/bugs.html .UE -.SH EXAMPLE +.SH EXAMPLES See .BR memusage (1). .SH SEE ALSO .BR memusage (1), .BR mtrace (1) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/mtrace.1 b/man1/mtrace.1 index 1cc8e6e80..2b261344c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/pldd.1 b/man1/pldd.1 index 86c117bd4..257c44398 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PLDD 1 2019-08-02 "GNU" "Linux User Manual" +.TH PLDD 1 2020-06-09 "GNU" "Linux User Manual" .SH NAME pldd \- display dynamic shared objects linked into a process .SH SYNOPSIS @@ -103,7 +103,7 @@ was broken: it just hung when executed. .\" glibc commit 1a4c27355e146b6d8cc6487b998462c7fdd1048f This problem was fixed in glibc 2.30, and the fix has been backported to earlier glibc versions in some distributions. -.SH EXAMPLE +.SH EXAMPLES .EX $ \fBecho $$\fP # Display PID of shell 1143 @@ -122,7 +122,7 @@ linux\-vdso.so.1 .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/sprof.1 b/man1/sprof.1 index 241714465..43abc20f9 100644 --- a/man1/sprof.1 +++ b/man1/sprof.1 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SPROF 1 2019-03-06 "Linux" "Linux User Manual" +.TH SPROF 1 2020-06-09 "Linux" "Linux User Manual" .SH NAME sprof \- read and display shared object profiling data .SH SYNOPSIS @@ -76,7 +76,7 @@ Display the program version and exit. The .B sprof command is a GNU extension, not present in POSIX.1. -.SH EXAMPLE +.SH EXAMPLES The following example demonstrates the use of .BR sprof . The example consists of a main program that calls two functions @@ -301,7 +301,7 @@ x2 consumeCpu2 1000 .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man1/time.1 b/man1/time.1 index e419c330d..5a76143b6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_exit.2 b/man2/_exit.2 index 7be2cfebf..14e44aedd 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -134,7 +134,7 @@ system call terminates only the calling thread.) .BR on_exit (3), .BR termios (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_syscall.2 b/man2/_syscall.2 index 04995d7e4..c2827ecbf 100644 --- a/man2/_syscall.2 +++ b/man2/_syscall.2 @@ -35,7 +35,7 @@ .\" 2007-10-23 mtk: created as a new page, by taking the content .\" specific to the _syscall() macros from intro(2). .\" -.TH _SYSCALL 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH _SYSCALL 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME _syscall \- invoking a system call without library support (OBSOLETE) .SH SYNOPSIS @@ -139,7 +139,7 @@ passed by-value or by-pointer (for aggregates like structs). .\" header file contains the required SYS_foo definition. .\" Otherwise, the use of a _syscall macro is required. .\" -.SH EXAMPLE +.SH EXAMPLES .EX #include <stdio.h> #include <stdlib.h> @@ -185,7 +185,7 @@ Number of processes = 40 .BR syscall (2), .BR errno (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/accept.2 b/man2/accept.2 index 161b7c9ba..7dbedd713 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -367,7 +367,7 @@ standard wanted to change it into a \fIsize_t\ *\fPC; .\" SunOS 5 has 'size_t *' later POSIX standards and glibc 2.x have .IR "socklen_t\ * ". -.SH EXAMPLE +.SH EXAMPLES See .BR bind (2). .SH SEE ALSO @@ -378,7 +378,7 @@ See .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/access.2 b/man2/access.2 index a2070b032..aaaa8501a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/acct.2 b/man2/acct.2 index 3ba0e4707..69faab00b 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.06 of the Linux +This page is part of release 5.07 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 8c0969d71..fed09fef6 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH ADD_KEY 2 2019-03-06 Linux "Linux Key Management Calls" +.TH ADD_KEY 2 2020-06-09 Linux "Linux Key Management Calls" .SH NAME add_key \- add a key to the kernel's key management facility .SH SYNOPSIS @@ -221,7 +221,7 @@ A wrapper is provided in the package. When employing the wrapper in that library, link with .IR \-lkeyutils . -.SH EXAMPLE +.SH EXAMPLES The program below creates a key with the type, description, and payload specified in its command-line arguments, and links that key into the session keyring. @@ -294,7 +294,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 index 9c2b3be92..638a17307 100644 --- a/man2/adjtimex.2 +++ b/man2/adjtimex.2 @@ -26,15 +26,17 @@ .\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl> .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH ADJTIMEX 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH ADJTIMEX 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME -adjtimex, ntp_adjtime \- tune kernel clock +adjtimex, clock_adjtime, ntp_adjtime \- tune kernel clock .SH SYNOPSIS .nf .B #include <sys/timex.h> .PP .BI "int adjtimex(struct timex *" "buf" ); .PP +.BI "int clock_adjtime(clockid_t " clk_id, " struct timex *" "buf" ); +.PP .BI "int ntp_adjtime(struct timex *" buf ); .fi .SH DESCRIPTION @@ -160,6 +162,27 @@ flag, then .I buf.time.tv_usec is interpreted as a nanosecond value; otherwise it is interpreted as microseconds. +.IP +The value of +.I buf.time +is the sum of its two fields, but the +field +.I buf.time.tv_usec +must always be nonnegative. +The following example shows how to +normalize a +.I timeval +with nanosecond resolution. +.PP +.in +12n +.EX +while (buf.time.tv_usec < 0) { + buf.time.tv_sec -= 1; + buf.time.tv_usec += 1000000000; +} +.EE +.in +.PP .TP .BR ADJ_MICRO " (since Linux 2.6.26)" .\" commit eea83d896e318bda54be2d2770d2c5d6668d11db @@ -210,7 +233,7 @@ in which case other bits should not be specified in .\" In user space, ADJ_OFFSET_SINGLESHOT is 0x8001 .\" In kernel space it is 0x0001, and must be ANDed with ADJ_ADJTIME (0x8000) Old-fashioned -.BR adjtime (): +.BR adjtime (3): (gradually) adjust time by value specified in .IR buf.offset , which specifies an adjustment in microseconds. @@ -344,6 +367,14 @@ Attempts to set read-only .I status bits are silently ignored. .\" +.SS clock_adjtime () +The +.BR clock_adjtime () +system call (added in Linux 2.6.39) behaves like +.BR adjtimex () +but takes an additional +.IR clk_id +argument to specify the particular clock on which to act. .SS ntp_adjtime () The .BR ntp_adjtime () @@ -352,7 +383,7 @@ library function is a more portable interface for performing the same task as .BR adjtimex (). Other than the following points, it is identical to -.BR adjtime (): +.BR adjtimex (): .IP * 3 The constants used in .I modes @@ -472,6 +503,20 @@ An attempt was made to set to a value other than those listed above. .TP .B EINVAL +The +.I clk_id +given to +.BR clock_adjtime () +is invalid for one of two reasons. +Either the System-V style hard-coded +positive clock ID value is out of range, or the dynamic +.I clk_id +does not refer to a valid instance of a clock object. +See +.BR clock_gettime (2) +for a discussion of dynamic clocks. +.TP +.B EINVAL An attempt was made to set .I buf.tick to a value outside the range @@ -482,6 +527,20 @@ where .B HZ is the system timer interrupt frequency. .TP +.B ENODEV +The hot-pluggable device (like USB for example) represented by a +dynamic +.I clk_id +has disappeared after its character device was opened. +See +.BR clock_gettime (2) +for a discussion of dynamic clocks. +.TP +.B EOPNOTSUPP +The given +.I clk_id +does not support adjustment. +.TP .B EPERM .I buf.modes is neither 0 nor @@ -503,10 +562,12 @@ T{ T} Thread safety MT-Safe .TE .SH CONFORMING TO -Neither of these interfaces is described in POSIX.1 +None of these interfaces is described in POSIX.1 .PP .BR adjtimex () -is Linux-specific and should not be used in programs +and +.BR clock_adjtime () +are Linux-specific and should not be used in programs intended to be portable. .PP The preferred API for the NTP daemon is @@ -533,6 +594,8 @@ is done by the kernel in timer context. Thus, it will take one tick into the second for the leap second to be inserted or deleted. .SH SEE ALSO +.BR clock_gettime (2), +.BR clock_settime (2), .BR settimeofday (2), .BR adjtime (3), .BR ntp_gettime (3), @@ -546,7 +609,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/alarm.2 b/man2/alarm.2 index 84d9264a5..8d12237e4 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.06 of the Linux +This page is part of release 5.07 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 8e104ca7f..41725ece2 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.06 of the Linux +This page is part of release 5.07 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 4a6e31468..c1eceea57 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -76,7 +76,7 @@ setting is preserved across .BR fork (2) and .BR clone (2) -but reset to default (i.e. +but reset to the default (i.e., .I cpuid enabled) on .BR execve (2). @@ -192,7 +192,7 @@ directly are very likely to crash. .PP AMD X86-64 Programmer's manual .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bdflush.2 b/man2/bdflush.2 index fbc7749b8..74bdff7ce 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bind.2 b/man2/bind.2 index 4a1b89060..de95519f8 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -66,7 +66,7 @@ .\" $Id: bind.2,v 1.3 1999/04/23 19:56:07 freitag Exp $ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH BIND 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH BIND 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME bind \- bind a name to a socket .SH SYNOPSIS @@ -256,7 +256,7 @@ type, see .SH BUGS The transparent proxy options are not described. .\" FIXME Document transparent proxy options -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR bind () with Internet domain sockets can be found in @@ -335,7 +335,7 @@ main(int argc, char *argv[]) .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bpf.2 b/man2/bpf.2 index ebcd2daee..6e3ffcdf3 100644 --- a/man2/bpf.2 +++ b/man2/bpf.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH BPF 2 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH BPF 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME bpf \- perform a command on an extended BPF map or program .SH SYNOPSIS @@ -367,6 +367,14 @@ enum bpf_map_type { BPF_MAP_TYPE_DEVMAP, BPF_MAP_TYPE_SOCKMAP, BPF_MAP_TYPE_CPUMAP, + BPF_MAP_TYPE_XSKMAP, + BPF_MAP_TYPE_SOCKHASH, + BPF_MAP_TYPE_CGROUP_STORAGE, + BPF_MAP_TYPE_REUSEPORT_SOCKARRAY, + BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE, + BPF_MAP_TYPE_QUEUE, + BPF_MAP_TYPE_STACK, + /* See /usr/include/linux/bpf.h for the full list. */ }; .EE .in @@ -756,6 +764,25 @@ enum bpf_prog_type { BPF_PROG_TYPE_KPROBE, BPF_PROG_TYPE_SCHED_CLS, BPF_PROG_TYPE_SCHED_ACT, + BPF_PROG_TYPE_TRACEPOINT, + BPF_PROG_TYPE_XDP, + BPF_PROG_TYPE_PERF_EVENT, + BPF_PROG_TYPE_CGROUP_SKB, + BPF_PROG_TYPE_CGROUP_SOCK, + BPF_PROG_TYPE_LWT_IN, + BPF_PROG_TYPE_LWT_OUT, + BPF_PROG_TYPE_LWT_XMIT, + BPF_PROG_TYPE_SOCK_OPS, + BPF_PROG_TYPE_SK_SKB, + BPF_PROG_TYPE_CGROUP_DEVICE, + BPF_PROG_TYPE_SK_MSG, + BPF_PROG_TYPE_RAW_TRACEPOINT, + BPF_PROG_TYPE_CGROUP_SOCK_ADDR, + BPF_PROG_TYPE_LWT_SEG6LOCAL, + BPF_PROG_TYPE_LIRC_MODE2, + BPF_PROG_TYPE_SK_REUSEPORT, + BPF_PROG_TYPE_FLOW_DISSECTOR, + /* See /usr/include/linux/bpf.h for the full list. */ }; .EE .in @@ -1120,11 +1147,33 @@ The .BR bpf () system call is Linux-specific. .SH NOTES -In the current implementation, all +Prior to Linux 4.4, all .BR bpf () commands require the caller to have the .B CAP_SYS_ADMIN capability. +From Linux 4.4 onwards, +.\" commit 1be7f75d1668d6296b80bf35dcf6762393530afc +an unprivileged user may create limited programs of type +.BR BPF_PROG_TYPE_SOCKET_FILTER +and associated maps. +However they may not store kernel pointers within +the maps and are presently limited to the following helper functions: +.\" [Linux 5.6] mtk: The list of available functions is, I think, governed +.\" by the check in net/core/filter.c::bpf_base_func_proto(). +.IP * 3 +get_random +.PD 0 +.IP * +get_smp_processor_id +.IP * +tail_call +.IP * +ktime_get_ns +.PD 1 +.PP +Unprivileged access may be blocked by setting the sysctl +.IR /proc/sys/kernel/unprivileged_bpf_disabled . .PP eBPF objects (maps and programs) can be shared between processes. For example, after @@ -1229,7 +1278,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/brk.2 b/man2/brk.2 index f602bc27b..147d12609 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index 9b6abd3f8..e25267a30 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/capget.2 b/man2/capget.2 index da659cf64..112115c6b 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -247,7 +247,7 @@ library and is available here: .BR gettid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chdir.2 b/man2/chdir.2 index 6e24699a8..2650a0a7c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chmod.2 b/man2/chmod.2 index 4867cc198..e7e28f501 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chown.2 b/man2/chown.2 index fc4d4c6cf..8b66d979f 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -35,7 +35,7 @@ .\" (bsdgroups versus sysvgroups, and the effect of the parent .\" directory's set-group-ID mode bit). .\" -.TH CHOWN 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH CHOWN 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME chown, fchown, lchown, fchownat \- change ownership of a file .SH SYNOPSIS @@ -446,7 +446,7 @@ as the old has got the same syscall number, and .BR chown () got the newly introduced number. -.SH EXAMPLE +.SH EXAMPLES .PP The following program changes the ownership of the file named in its second command-line argument to the value specified in its @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chroot.2 b/man2/chroot.2 index f942bf7be..dbe8a75f3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clock_adjtime.2 b/man2/clock_adjtime.2 new file mode 100644 index 000000000..b08b9c801 --- /dev/null +++ b/man2/clock_adjtime.2 @@ -0,0 +1 @@ +.so man2/adjtimex.2 diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index 5970d525f..0b6b4eb98 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -227,6 +227,39 @@ On Linux, this clock is not settable. .BR CLOCK_THREAD_CPUTIME_ID " (since Linux 2.6.12)" This is a clock that measures CPU time consumed by this thread. On Linux, this clock is not settable. +.PP +Linux also implements dynamic clock instances as described below. +.SS Dynamic clocks +In addition to the hard-coded System-V style clock IDs described above, +Linux also supports +POSIX clock operations on certain character devices. +Such devices are +called "dynamic" clocks, and are supported since Linux 2.6.39. +.PP +Using the appropriate macros, open file +descriptors may be converted into clock IDs and passed to +.BR clock_gettime (), +.BR clock_settime (), +and +.BR clock_adjtime (2). +The following example shows how to convert a file descriptor into a +dynamic clock ID. +.PP +.in +4n +.EX +#define CLOCKFD 3 +#define FD_TO_CLOCKID(fd) ((~(clockid_t) (fd) << 3) | CLOCKFD) +#define CLOCKID_TO_FD(clk) ((unsigned int) ~((clk) >> 3)) + +struct timeval tv; +clockid_t clkid; +int fd; + +fd = open("/dev/ptp0", O_RDWR); +clkid = FD_TO_CLOCKID(fd); +clock_gettime(clkid, &tv); +.EE +.in .SH RETURN VALUE .BR clock_gettime (), .BR clock_settime (), @@ -244,7 +277,10 @@ points outside the accessible address space. .B EINVAL The .I clockid -specified is not supported on this system. +specified is invalid for one of two reasons. +Either the System-V style +hard coded positive value is out of range, or the dynamic clock ID +does not refer to a valid instance of a clock object. .\" Linux also gives this error on attempts to set CLOCK_PROCESS_CPUTIME_ID .\" and CLOCK_THREAD_CPUTIME_ID, when probably the proper error should be .\" EPERM. @@ -280,6 +316,12 @@ the current value of the .B CLOCK_MONOTONIC clock. .TP +.B ENODEV +The hot-pluggable device (like USB for example) represented by a +dynamic +.I clk_id +has disappeared after its character device was opened. +.TP .B EPERM .BR clock_settime () does not have permission to set the clock indicated. @@ -307,7 +349,7 @@ T} Thread safety MT-Safe .sp 1 .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SUSv2. -.SH AVAILABILITY +.PP On POSIX systems on which these functions are available, the symbol .B _POSIX_TIMERS is defined in \fI<unistd.h>\fP to a value greater than 0. @@ -395,7 +437,7 @@ and .BR CLOCK_THREAD_CPUTIME_ID , on systems that provide such an implementation (i.e., Linux 2.6.12 and later). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR clock_gettime () and @@ -495,7 +537,7 @@ main(int argc, char *argv[]) .BR vdso (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 f2f3da357..1701904da 100644 --- a/man2/clock_nanosleep.2 +++ b/man2/clock_nanosleep.2 @@ -277,7 +277,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clone.2 b/man2/clone.2 index ac1451cff..2658b16c5 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -39,7 +39,7 @@ .\" 2008-11-19, mtk, document CLONE_NEWIPC .\" 2008-11-19, Jens Axboe, mtk, document CLONE_IO .\" -.TH CLONE 2 2019-11-19 "Linux" "Linux Programmer's Manual" +.TH CLONE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME clone, __clone2, clone3 \- create a child process .SH SYNOPSIS @@ -195,8 +195,12 @@ struct clone_args { u64 stack; /* Pointer to lowest byte of stack */ u64 stack_size; /* Size of stack */ u64 tls; /* Location of new TLS */ - u64 set_tid; /* Pointer to a \fIpid_t\fP array */ - u64 set_tid_size; /* Number of elements in \fIset_tid\fP */ + u64 set_tid; /* Pointer to a \fIpid_t\fP array + (since Linux 5.5) */ + u64 set_tid_size; /* Number of elements in \fIset_tid\fP + (since Linux 5.5) */ + u64 cgroup; /* File descriptor for target cgroup + of child (since Linux 5.7) */ }; .EE .in @@ -266,6 +270,7 @@ stack stack tls tls See CLONE_SETTLS \fP---\fP set_tid See below for details \fP---\fP set_tid_size +\fP---\fP cgroup See CLONE_INTO_CGROUP .TE .RE .\" @@ -525,6 +530,65 @@ or .BR umask (2) performed later by one of the processes do not affect the other process. .TP +.BR CLONE_INTO_CGROUP " (since Linux 5.7)" +.\" commit ef2c41cf38a7559bbf91af42d5b6a4429db8fc68 +By default, a child process is placed in the same version 2 +cgroup as its parent. +The +.B CLONE_INTO_CGROUP +flag allows the child process to be created in a different version 2 cgroup. +(Note that +.BR CLONE_INTO_CGROUP +has effect only for version 2 cgroups.) +.IP +In order to place the child process in a different cgroup, +the caller specifies +.BR CLONE_INTO_CGROUP +in +.I cl_args.flags +and passes a file descriptor that refers to a version 2 cgroup in the +.I cl_args.cgroup +field. +(This file descriptor can be obtained by opening a cgroup v2 directory +using either the +.B O_RDONLY +or the +.B O_PATH +flag.) +Note that all of the usual restrictions (described in +.BR cgroups (7)) +on placing a process into a version 2 cgroup apply. +.IP +Among the possible use cases for +.BR CLONE_INTO_CGROUP +are the following: +.RS +.IP * 3 +Spawning a process into a cgroup different from the parent's cgroup +makes it possible for a service manager to directly spawn new +services into dedicated cgroups. +This eliminates the accounting +jitter that would be caused if the child process was first created in the +same cgroup as the parent and then +moved into the target cgroup. +Furthermore, spawning the child process directly into a target cgroup +is significantly cheaper than moving the child process into +the target cgroup after it has been created. +.IP * +The +.BR CLONE_INTO_CGROUP +flag also allows the creation of +frozen child processes by spawning them into a frozen cgroup. +(See +.BR cgroups (7) +for a description of the freezer controller.) +.IP * +For threaded applications (or even thread implementations which +make use of cgroups to limit individual threads), it is possible to +establish a fixed cgroup layout before spawning each thread +directly into its target cgroup. +.RE +.TP .BR CLONE_IO " (since Linux 2.6.25)" If .B CLONE_IO @@ -1118,177 +1182,6 @@ space of the calling process at the time of the clone call. Memory writes or file mappings/unmappings performed by one of the processes do not affect the other, as with .BR fork (2). -.SH NOTES -.PP -One use of these systems calls -is to implement threads: multiple flows of control in a program that -run concurrently in a shared address space. -.PP -Glibc does not provide a wrapper for -.BR clone3 (); -call it using -.BR syscall (2). -.PP -Note that the glibc -.BR clone () -wrapper function makes some changes -in the memory pointed to by -.I stack -(changes required to set the stack up correctly for the child) -.I before -invoking the -.BR clone () -system call. -So, in cases where -.BR clone () -is used to recursively create children, -do not use the buffer employed for the parent's stack -as the stack of the child. -.\" -.SS C library/kernel differences -The raw -.BR clone () -system call corresponds more closely to -.BR fork (2) -in that execution in the child continues from the point of the -call. -As such, the -.I fn -and -.I arg -arguments of the -.BR clone () -wrapper function are omitted. -.PP -In contrast to the glibc wrapper, the raw -.BR clone () -system call accepts NULL as a -.I stack -argument (and -.BR clone3 () -likewise allows -.I cl_args.stack -to be NULL). -In this case, the child uses a duplicate of the parent's stack. -(Copy-on-write semantics ensure that the child gets separate copies -of stack pages when either process modifies the stack.) -In this case, for correct operation, the -.B CLONE_VM -option should not be specified. -(If the child -.I shares -the parent's memory because of the use of the -.BR CLONE_VM -flag, -then no copy-on-write duplication occurs and chaos is likely to result.) -.PP -The order of the arguments also differs in the raw system call, -and there are variations in the arguments across architectures, -as detailed in the following paragraphs. -.PP -The raw system call interface on x86-64 and some other architectures -(including sh, tile, and alpha) is: -.PP -.in +4 -.EX -.BI "long clone(unsigned long " flags ", void *" stack , -.BI " int *" parent_tid ", int *" child_tid , -.BI " unsigned long " tls ); -.EE -.in -.PP -On x86-32, and several other common architectures -(including score, ARM, ARM 64, PA-RISC, arc, Power PC, xtensa, -and MIPS), -.\" CONFIG_CLONE_BACKWARDS -the order of the last two arguments is reversed: -.PP -.in +4 -.EX -.BI "long clone(unsigned long " flags ", void *" stack , -.BI " int *" parent_tid ", unsigned long " tls , -.BI " int *" child_tid ); -.EE -.in -.PP -On the cris and s390 architectures, -.\" CONFIG_CLONE_BACKWARDS2 -the order of the first two arguments is reversed: -.PP -.in +4 -.EX -.BI "long clone(void *" stack ", unsigned long " flags , -.BI " int *" parent_tid ", int *" child_tid , -.BI " unsigned long " tls ); -.EE -.in -.PP -On the microblaze architecture, -.\" CONFIG_CLONE_BACKWARDS3 -an additional argument is supplied: -.PP -.in +4 -.EX -.BI "long clone(unsigned long " flags ", void *" stack , -.BI " int " stack_size , "\fR /* Size of stack */" -.BI " int *" parent_tid ", int *" child_tid , -.BI " unsigned long " tls ); -.EE -.in -.\" -.SS blackfin, m68k, and sparc -.\" Mike Frysinger noted in a 2013 mail: -.\" these arches don't define __ARCH_WANT_SYS_CLONE: -.\" blackfin ia64 m68k sparc -The argument-passing conventions on -blackfin, m68k, and sparc are different from the descriptions above. -For details, see the kernel (and glibc) source. -.SS ia64 -On ia64, a different interface is used: -.PP -.in +4 -.EX -.BI "int __clone2(int (*" "fn" ")(void *), " -.BI " void *" stack_base ", size_t " stack_size , -.BI " int " flags ", void *" "arg" ", ... " -.BI " /* pid_t *" parent_tid ", struct user_desc *" tls , -.BI " pid_t *" child_tid " */ );" -.EE -.in -.PP -The prototype shown above is for the glibc wrapper function; -for the system call itself, -the prototype can be described as follows (it is identical to the -.BR clone () -prototype on microblaze): -.PP -.in +4 -.EX -.BI "long clone2(unsigned long " flags ", void *" stack_base , -.BI " int " stack_size , "\fR /* Size of stack */" -.BI " int *" parent_tid ", int *" child_tid , -.BI " unsigned long " tls ); -.EE -.in -.PP -.BR __clone2 () -operates in the same way as -.BR clone (), -except that -.I stack_base -points to the lowest address of the child's stack area, -and -.I stack_size -specifies the size of the stack pointed to by -.IR stack_base . -.SS Linux 2.4 and earlier -In Linux 2.4 and earlier, -.BR clone () -does not take arguments -.IR parent_tid , -.IR tls , -and -.IR child_tid . .SH RETURN VALUE .\" gettid(2) returns current->pid; .\" getpid(2) returns current->tgid; @@ -1304,6 +1197,14 @@ will be set appropriately. Too many processes are already running; see .BR fork (2). .TP +.BR EBUSY " (" clone3 "() only)" +.B CLONE_INTO_CGROUP +was specified in +.IR cl_args.flags , +but the file descriptor specified in +.IR cl_args.cgroup +refers to a version 2 cgroup in which a domain controller is enabled. +.TP .BR EEXIST " (" clone3 "() only)" One (or more) of the PIDs specified in .I set_tid @@ -1501,9 +1402,9 @@ mask. is greater than the number of nested PID namespaces. .TP .BR EINVAL " (" clone3 "() only)" -If one of the PIDs specified in +One of the PIDs specified in .I set_tid -was an invalid PID. +was an invalid. .TP .BR EINVAL " (AArch64 only, Linux 4.6 and earlier)" .I stack @@ -1546,6 +1447,16 @@ to be exceeded. For further details, see .BR namespaces (7). .TP +.BR EOPNOTSUP " (" clone3 "() only)" +.B CLONE_INTO_CGROUP +was specified in +.IR cl_args.flags , +but the file descriptor specified in +.IR cl_args.cgroup +refers to a version 2 cgroup that is in the +.IR "domain invalid" +state. +.TP .B EPERM .BR CLONE_NEWCGROUP , .BR CLONE_NEWIPC , @@ -1616,6 +1527,32 @@ These system calls are Linux-specific and should not be used in programs intended to be portable. .SH NOTES +.PP +One use of these systems calls +is to implement threads: multiple flows of control in a program that +run concurrently in a shared address space. +.PP +Glibc does not provide a wrapper for +.BR clone3 (); +call it using +.BR syscall (2). +.PP +Note that the glibc +.BR clone () +wrapper function makes some changes +in the memory pointed to by +.I stack +(changes required to set the stack up correctly for the child) +.I before +invoking the +.BR clone () +system call. +So, in cases where +.BR clone () +is used to recursively create children, +do not use the buffer employed for the parent's stack +as the stack of the child. +.PP The .BR kcmp (2) system call can be used to test whether two processes share various @@ -1641,6 +1578,151 @@ On i386, .BR clone () should not be called through vsyscall, but directly through .IR "int $0x80" . +.\" +.SS C library/kernel differences +The raw +.BR clone () +system call corresponds more closely to +.BR fork (2) +in that execution in the child continues from the point of the +call. +As such, the +.I fn +and +.I arg +arguments of the +.BR clone () +wrapper function are omitted. +.PP +In contrast to the glibc wrapper, the raw +.BR clone () +system call accepts NULL as a +.I stack +argument (and +.BR clone3 () +likewise allows +.I cl_args.stack +to be NULL). +In this case, the child uses a duplicate of the parent's stack. +(Copy-on-write semantics ensure that the child gets separate copies +of stack pages when either process modifies the stack.) +In this case, for correct operation, the +.B CLONE_VM +option should not be specified. +(If the child +.I shares +the parent's memory because of the use of the +.BR CLONE_VM +flag, +then no copy-on-write duplication occurs and chaos is likely to result.) +.PP +The order of the arguments also differs in the raw system call, +and there are variations in the arguments across architectures, +as detailed in the following paragraphs. +.PP +The raw system call interface on x86-64 and some other architectures +(including sh, tile, and alpha) is: +.PP +.in +4 +.EX +.BI "long clone(unsigned long " flags ", void *" stack , +.BI " int *" parent_tid ", int *" child_tid , +.BI " unsigned long " tls ); +.EE +.in +.PP +On x86-32, and several other common architectures +(including score, ARM, ARM 64, PA-RISC, arc, Power PC, xtensa, +and MIPS), +.\" CONFIG_CLONE_BACKWARDS +the order of the last two arguments is reversed: +.PP +.in +4 +.EX +.BI "long clone(unsigned long " flags ", void *" stack , +.BI " int *" parent_tid ", unsigned long " tls , +.BI " int *" child_tid ); +.EE +.in +.PP +On the cris and s390 architectures, +.\" CONFIG_CLONE_BACKWARDS2 +the order of the first two arguments is reversed: +.PP +.in +4 +.EX +.BI "long clone(void *" stack ", unsigned long " flags , +.BI " int *" parent_tid ", int *" child_tid , +.BI " unsigned long " tls ); +.EE +.in +.PP +On the microblaze architecture, +.\" CONFIG_CLONE_BACKWARDS3 +an additional argument is supplied: +.PP +.in +4 +.EX +.BI "long clone(unsigned long " flags ", void *" stack , +.BI " int " stack_size , "\fR /* Size of stack */" +.BI " int *" parent_tid ", int *" child_tid , +.BI " unsigned long " tls ); +.EE +.in +.\" +.SS blackfin, m68k, and sparc +.\" Mike Frysinger noted in a 2013 mail: +.\" these arches don't define __ARCH_WANT_SYS_CLONE: +.\" blackfin ia64 m68k sparc +The argument-passing conventions on +blackfin, m68k, and sparc are different from the descriptions above. +For details, see the kernel (and glibc) source. +.SS ia64 +On ia64, a different interface is used: +.PP +.in +4 +.EX +.BI "int __clone2(int (*" "fn" ")(void *), " +.BI " void *" stack_base ", size_t " stack_size , +.BI " int " flags ", void *" "arg" ", ... " +.BI " /* pid_t *" parent_tid ", struct user_desc *" tls , +.BI " pid_t *" child_tid " */ );" +.EE +.in +.PP +The prototype shown above is for the glibc wrapper function; +for the system call itself, +the prototype can be described as follows (it is identical to the +.BR clone () +prototype on microblaze): +.PP +.in +4 +.EX +.BI "long clone2(unsigned long " flags ", void *" stack_base , +.BI " int " stack_size , "\fR /* Size of stack */" +.BI " int *" parent_tid ", int *" child_tid , +.BI " unsigned long " tls ); +.EE +.in +.PP +.BR __clone2 () +operates in the same way as +.BR clone (), +except that +.I stack_base +points to the lowest address of the child's stack area, +and +.I stack_size +specifies the size of the stack pointed to by +.IR stack_base . +.SS Linux 2.4 and earlier +In Linux 2.4 and earlier, +.BR clone () +does not take arguments +.IR parent_tid , +.IR tls , +and +.IR child_tid . .SH BUGS GNU C library versions 2.3.4 up to and including 2.24 contained a wrapper function for @@ -1689,7 +1771,7 @@ mypid = syscall(SYS_getpid); Because of the stale-cache problem, as well as other problems noted in .BR getpid (2), the PID caching feature was removed in glibc 2.25. -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the use of .BR clone () to create a child process that executes in a separate UTS namespace. @@ -1829,7 +1911,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/close.2 b/man2/close.2 index 907899506..c920b2457 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 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH CLOSE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME close \- close a file descriptor .SH SYNOPSIS @@ -115,7 +115,8 @@ that a file descriptor is automatically closed upon a successful see .BR fcntl (2) for details. -.PP +.\" +.SS Multithreaded processes and close() It is probably unwise to close file descriptors while they may be in use by system calls in other threads in the same process. @@ -130,6 +131,35 @@ that may cause unintended side effects. .\" call has restarted after ERESTARTSYS, the original system call will .\" later restart with the reused file descriptor. This is most likely a .\" serious programming error. +.PP +Furthermore, consider the following scenario where two threads are +performing operations on the same file descriptor: +.IP 1. 3 +One thread is blocked in an I/O system call on the file descriptor. +For example, it is trying to +.BR write (2) +to a pipe that is already full, or trying to +.BR read (2) +from a stream socket which currently has no available data. +.IP 2. +Another thread closes the file descriptor. +.PP +The behavior in this situation varies across systems. +On some systems, when the file descriptor is closed, +the blocking system call returns immediately with an error. +.PP +On Linux (and possibly some other systems), the behavior is different. +the blocking I/O system call holds a reference to the underlying +open file description, and this reference keeps the description open +until the I/O system call completes. +.\" 'struct file' in kernel-speak +(See +.BR open (2) +for a discussion of open file descriptions.) +Thus, the blocking system call in the first thread may successfully +complete after the +.BR close () +in the second thread. .\" .SS Dealing with error returns from close() A careful programmer will check the return value of @@ -194,7 +224,7 @@ The error is a somewhat special case. Regarding the .B EINTR -error, POSIX.1-2013 says: +error, POSIX.1-2008 says: .PP .RS If @@ -249,7 +279,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/connect.2 b/man2/connect.2 index 1ba7e2ee2..6cb2a8105 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -155,6 +155,13 @@ in the path prefix. The user tried to connect to a broadcast address without having the socket broadcast flag enabled or the connection request failed because of a local firewall rule. +.IP +.B EACCES +can also be returned if an SELinux policy denied a connection (for +example, if there is a policy saying that an HTTP proxy can only +connect to ports associated with HTTP servers, and the proxy tries to +connect to a different port). +dd .TP .B EADDRINUSE Local address is already in use. @@ -286,7 +293,7 @@ If fails, consider the state of the socket as unspecified. Portable applications should close the socket and create a new one for reconnecting. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR connect () is shown in @@ -297,9 +304,10 @@ is shown in .BR getsockname (2), .BR listen (2), .BR socket (2), -.BR path_resolution (7) +.BR path_resolution (7), +.BR selinux (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 e94d40611..04302dfae 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-10-10 "Linux" "Linux Programmer's Manual" +.TH COPY_FILE_RANGE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME copy_file_range \- Copy a range of data from one file to another .SH SYNOPSIS @@ -186,7 +186,7 @@ refers to an active swap file. .TP .B EXDEV The files referred to by -.IR file_in " and " file_out +.IR fd_in " and " fd_out are not on the same mounted filesystem (pre Linux 5.3). .SH VERSIONS The @@ -208,7 +208,7 @@ The system call is a nonstandard Linux and GNU extension. .SH NOTES If -.I file_in +.I fd_in is a sparse file, then .BR copy_file_range () may expand any holes existing in the requested range. @@ -226,7 +226,7 @@ gives filesystems an opportunity to implement "copy acceleration" techniques, such as the use of reflinks (i.e., two or more inodes that share pointers to the same copy-on-write disk blocks) or server-side-copy (in the case of NFS). -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include <fcntl.h> @@ -298,7 +298,7 @@ main(int argc, char **argv) .BR sendfile (2), .BR splice (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 803b8a0e2..d6fc158b9 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.06 of the Linux +This page is part of release 5.07 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 61d5757ff..a734c10f8 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/dup.2 b/man2/dup.2 index ad0b00e83..93a82b52c 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -278,7 +278,7 @@ Instead, code something like the following could be used: .BR open (2), .BR pidfd_getfd (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 03211d97e..95e77f380 100644 --- a/man2/epoll_create.2 +++ b/man2/epoll_create.2 @@ -151,7 +151,7 @@ applications are run on older kernels. .BR epoll_wait (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 4640c9814..c8572e375 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -478,7 +478,7 @@ flag. .BR poll (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 cbabe3443..6e25edf89 100644 --- a/man2/epoll_wait.2 +++ b/man2/epoll_wait.2 @@ -282,7 +282,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/eventfd.2 b/man2/eventfd.2 index a5432431b..8f4a41b97 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -19,7 +19,7 @@ .\" .\" 2008-10-10, mtk: describe eventfd2(), and EFD_NONBLOCK and EFD_CLOEXEC .\" -.TH EVENTFD 2 2019-03-06 Linux "Linux Programmer's Manual" +.TH EVENTFD 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME eventfd \- create a file descriptor for event notification .SH SYNOPSIS @@ -357,7 +357,7 @@ The functions perform the read and write operations on an eventfd file descriptor, returning 0 if the correct number of bytes was transferred, or \-1 otherwise. -.SH EXAMPLE +.SH EXAMPLES .PP The following program creates an eventfd file descriptor and then forks to create a child process. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execve.2 b/man2/execve.2 index 62dfd159d..8a60dc526 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -107,8 +107,8 @@ If the set-user-ID bit is set on the program file referred to by \fIpathname\fP, then the effective user ID of the calling process is changed to that of the owner of the program file. -Similarly, when the set-group-ID -bit of the program file is set the effective group ID of the calling +Similarly, if the set-group-ID bit is set on the program file, +then the effective group ID of the calling process is set to the group of the program file. .PP The aforementioned transformations of the effective IDs are @@ -210,12 +210,22 @@ The following Linux-specific process attributes are also not preserved during an .BR execve (): .IP * 3 -The -.BR prctl (2) -.B PR_SET_DUMPABLE -flag is set, -unless a set-user-ID or set-group ID program is being executed, -in which case it is cleared. +The process's "dumpable" attribute is set to the value 1, +unless a set-user-ID program, a set-group-ID program, +or a program with capabilities is being executed, +in which case the dumpable flag may instead be reset to the value in +.IR /proc/sys/fs/suid_dumpable , +in the circumstances described under +.BR PR_SET_DUMPABLE +in +.BR prctl (2). +Note that changes to the "dumpable" attribute may cause ownership +of files in the process's +.IR /proc/[pid] +directory to change to +.IR root:root , +as described in +.BR proc (5). .IP * The .BR prctl (2) @@ -295,7 +305,7 @@ POSIX.1 says that if file descriptors 0, 1, and 2 would otherwise be closed after a successful .BR execve (), and the process would gain privilege because the set-user-ID or -set-group_ID mode bit was set on the executed file, +set-group-ID mode bit was set on the executed file, then the system may open an unspecified file for each of these file descriptors. As a general principle, no portable program, whether privileged or not, @@ -630,7 +640,10 @@ failure may occur past the point of no return: the original executable image has been torn down, but the new image could not be completely built. In such cases, the kernel kills the process with a -.BR SIGKILL +.\" commit 19d860a140beac48a1377f179e693abe86a9dac9 +.BR SIGSEGV +.RB ( SIGKILL +until Linux 3.17) signal. .\" .SS Interpreter scripts @@ -767,7 +780,7 @@ Since UNIX\ V7, both are NULL. .\" .BR execve () .\" that could be exploited for denial of service by a suitably crafted .\" ELF binary. There are no known problems with 2.0.34 or 2.2.15. -.SH EXAMPLE +.SH EXAMPLES The following program is designed to be execed by the second program below. It just echoes its command-line arguments, one per line. .PP @@ -872,12 +885,13 @@ argv[4]: world .BR fexecve (3), .BR getopt (3), .BR system (3), +.BR capabilities (7), .BR credentials (7), .BR environ (7), .BR path_resolution (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execveat.2 b/man2/execveat.2 index 32b6eaa4b..6bf7e564e 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.06 of the Linux +This page is part of release 5.07 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 f40a1c5c7..6aa6f0688 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fallocate.2 b/man2/fallocate.2 index 3c0da659d..7f5c2ca90 100644 --- a/man2/fallocate.2 +++ b/man2/fallocate.2 @@ -481,7 +481,7 @@ is Linux-specific. .BR posix_fadvise (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 c893fcd97..394ac7a40 100644 --- a/man2/fanotify_init.2 +++ b/man2/fanotify_init.2 @@ -21,7 +21,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH FANOTIFY_INIT 2 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH FANOTIFY_INIT 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME fanotify_init \- create and initialize fanotify group .SH SYNOPSIS @@ -94,36 +94,6 @@ already contain their final content. This notification class might be used by malware detection programs, for example. .TP -.BR FAN_REPORT_FID " (since Linux 5.1)" -.\" commit a8b13aa20afb69161b5123b4f1acc7ea0a03d360 -This value allows the receipt of events which contain additional information -about the underlying filesystem object correlated to an event. -An additional structure encapsulates the information about the object and is -included alongside the generic event metadata structure. -The file descriptor that is used to represent the object correlated to an -event is instead substituted with a file handle. -It is intended for applications that may find the use of a file handle to -identify an object more suitable than a file descriptor. -Additionally, it may be used for applications that are interested in -directory entry events, such as -.BR FAN_CREATE , -.BR FAN_ATTRIB , -.BR FAN_MOVE , -and -.BR FAN_DELETE -for example. -Note that the use of directory modification events are not supported when -monitoring a mount point. -The use of -.BR FAN_CLASS_CONTENT -or -.BR FAN_CLASS_PRE_CONTENT -is not permitted with this flag and will result in the error -.BR EINVAL . -See -.BR fanotify (7) -for additional information. -.TP .B FAN_CLASS_NOTIF This is the default value. It does not need to be specified. @@ -184,6 +154,36 @@ supplied to .BR read (2) (see .BR fanotify (7)). +.TP +.BR FAN_REPORT_FID " (since Linux 5.1)" +.\" commit a8b13aa20afb69161b5123b4f1acc7ea0a03d360 +This value allows the receipt of events which contain additional information +about the underlying filesystem object correlated to an event. +An additional structure encapsulates the information about the object and is +included alongside the generic event metadata structure. +The file descriptor that is used to represent the object correlated to an +event is instead substituted with a file handle. +It is intended for applications that may find the use of a file handle to +identify an object more suitable than a file descriptor. +Additionally, it may be used for applications that are interested in +directory entry events, such as +.BR FAN_CREATE , +.BR FAN_ATTRIB , +.BR FAN_MOVE , +and +.BR FAN_DELETE +for example. +Note that the use of directory modification events are not supported when +monitoring a mount point. +The use of +.BR FAN_CLASS_CONTENT +or +.BR FAN_CLASS_PRE_CONTENT +is not permitted with this flag and will result in the error +.BR EINVAL . +See +.BR fanotify (7) +for additional information. .PP The .I event_f_flags @@ -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.06 of the Linux +This page is part of release 5.07 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 dfb273c4d..45e914b66 100644 --- a/man2/fanotify_mark.2 +++ b/man2/fanotify_mark.2 @@ -21,7 +21,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH FANOTIFY_MARK 2 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH FANOTIFY_MARK 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME fanotify_mark \- add, remove, or modify an fanotify mark on a filesystem object @@ -126,12 +126,22 @@ is not itself a mount point, the mount point containing will be marked. All directories, subdirectories, and the contained files of the mount point will be monitored. -This value cannot be used if the +The events which require the .I fanotify_fd -file descriptor has been initialized with the flag -.BR FAN_REPORT_FID -or if any of the new directory modification events are provided as a -.IR mask . +file descriptor to have been initialized with the flag +.BR FAN_REPORT_FID , +such as +.BR FAN_CREATE , +.BR FAN_ATTRIB , +.BR FAN_MOVE , +and +.BR FAN_DELETE_SELF , +cannot be provided as a +.IR mask +when +.I flags +contains +.BR FAN_MARK_MOUNT . Attempting to do so will result in the error .B EINVAL being returned. @@ -184,41 +194,55 @@ See NOTES for additional details. .BR FAN_ATTRIB " (since Linux 5.1)" .\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when the metadata for a file or directory has changed. +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .TP .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. +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .TP .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. +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .TP .BR FAN_DELETE_SELF " (since Linux 5.1)" .\" commit 235328d1fa4251c6dcb32351219bb553a58838d2 Create an event when a marked file or directory itself is deleted. +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .TP .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. +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .TP .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. +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .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 -.B FAN_UNLIMITED_QUEUE -is not set in -.BR fanotify_init (2). +An fanotify file descriptor created with +.B FAN_REPORT_FID +is required. .TP .B FAN_OPEN_PERM Create an event when a permission to open a file or directory is requested. @@ -254,37 +278,40 @@ Create events for directories\(emfor example, when (but see BUGS), and .BR closedir (3) are called. -Without this flag, only events for files are created. -The -.BR FAN_ONDIR -flag is reported in an event mask only if the -.I fanotify_fd -file descriptor has been initialized with the flag -.BR FAN_REPORT_FID . +Without this flag, events are created only for files. In the context of directory entry events, such as .BR FAN_CREATE , .BR FAN_DELETE , .BR FAN_MOVED_FROM , and -.BR FAN_MOVED_TO -for example, specifying the flag +.BR FAN_MOVED_TO , +specifying the flag .BR FAN_ONDIR is required in order to create events when subdirectory entries are modified (i.e., .BR mkdir (2)/ .BR rmdir (2)). -Subdirectory entry modification events will never be merged with -nonsubdirectory entry modification events. -This flag is never reported individually within an event and is always -supplied in conjunction with another event type. .TP .B FAN_EVENT_ON_CHILD Events for the immediate children of marked directories shall be created. The flag has no effect when marking mounts and filesystems. Note that events are not generated for children of the subdirectories of marked directories. +More specifically, the directory entry modification events +.BR FAN_CREATE , +.BR FAN_DELETE , +.BR FAN_MOVED_FROM , +and +.BR FAN_MOVED_TO +are not generated for any entry modifications performed inside subdirectories +of marked directories. +Note that the events +.BR FAN_DELETE_SELF +and +.BR FAN_MOVE_SELF +are not generated for children of marked directories. To monitor complete directory trees it is necessary to mark the relevant -mount. +mount or filesystem. .PP The following composed values are defined: .TP @@ -526,7 +553,7 @@ is not checked for invalid values. .BR fanotify_init (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fcntl.2 b/man2/fcntl.2 index d48e933f6..1f8d901ef 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -708,7 +708,7 @@ are used to manage I/O availability signals: .TP .BR F_GETOWN " (\fIvoid\fP)" Return (as the function result) -the process ID or process group currently receiving +the process ID or process group ID currently receiving .B SIGIO and .B SIGURG @@ -2127,7 +2127,7 @@ directory, and is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/flock.2 b/man2/flock.2 index b169cff68..04620dcfc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fork.2 b/man2/fork.2 index 3b3e6389a..4f1a8625e 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -36,7 +36,7 @@ .\" Greatly expanded, to describe all attributes that differ .\" parent and child. .\" -.TH FORK 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH FORK 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME fork \- create a child process .SH SYNOPSIS @@ -309,7 +309,7 @@ The glibc wrapper invokes any fork handlers that have been established using .BR pthread_atfork (3). .\" and does some magic to ensure that getpid(2) returns the right value. -.SH EXAMPLE +.SH EXAMPLES See .BR pipe (2) and @@ -327,7 +327,7 @@ and .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fsync.2 b/man2/fsync.2 index 4e6b19ad5..6dedf301f 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -35,7 +35,7 @@ .\" 2006-04-28, mtk, substantial rewrite of various parts. .\" 2012-02-27 Various changes by Christoph Hellwig <hch@lst.de> .\" -.TH FSYNC 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH FSYNC 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME fsync, fdatasync \- synchronize a file's in-core state with storage device .SH SYNOPSIS @@ -151,7 +151,7 @@ system call, and some previous write failed due to insufficient storage space. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, 4.3BSD. -.SH AVAILABILITY +.PP On POSIX systems on which .BR fdatasync () is available, @@ -199,7 +199,7 @@ to guarantee safe operation. .BR hdparm (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futex.2 b/man2/futex.2 index bba0aa15f..36d54f295 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -19,7 +19,7 @@ .\" FIXME Do we need to add some text regarding Torvald Riegel's 2015-01-24 mail .\" http://thread.gmane.org/gmane.linux.kernel/1703405/focus=1873242 .\" -.TH FUTEX 2 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH FUTEX 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME futex \- fast user-space locking .SH SYNOPSIS @@ -1711,7 +1711,7 @@ various POSIX threads synchronization mechanisms .\" .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates use of futexes in a program where a parent process and a child process use a pair of futexes located inside a shared anonymous mapping to synchronize access to a shared resource: @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futimesat.2 b/man2/futimesat.2 index d35dacc1c..972e6c35a 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.06 of the Linux +This page is part of release 5.07 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 5a90873db..f1bb48b13 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.06 of the Linux +This page is part of release 5.07 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 a1c0ffc0a..b8971294e 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.06 of the Linux +This page is part of release 5.07 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 799e88e8c..816de1860 100644 --- a/man2/get_robust_list.2 +++ b/man2/get_robust_list.2 @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getcpu.2 b/man2/getcpu.2 index d3c0bcaee..8824e3ccc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdents.2 b/man2/getdents.2 index 8678de466..628b55720 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -28,7 +28,7 @@ .\" Derived from 'readdir.2'. .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH GETDENTS 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH GETDENTS 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME getdents, getdents64 \- get directory entries .SH SYNOPSIS @@ -40,7 +40,9 @@ getdents, getdents64 \- get directory entries .fi .PP .IR Note : -There are no glibc wrappers for these system calls; see NOTES. +There is no glibc wrapper for +.BR getdents (); +see NOTES. .SH DESCRIPTION These are not the interfaces you are interested in. Look at @@ -203,20 +205,30 @@ File descriptor does not refer to a directory. SVr4. .\" SVr4 documents additional ENOLINK, EIO error conditions. .SH NOTES -Glibc does not provide a wrapper for these system calls; call them using +Library support for +.BR getdents64 () +was added in glibc 2.30; +there is no glibc wrapper for +.BR getdents (). +Calling +.BR getdents () +(or +.BR getdents64 () +on earlier glibc versions) requires the use of .BR syscall (2). -You will need to define the +In that case you will need to define the .I linux_dirent or .I linux_dirent64 structure yourself. -However, you probably want to use +.PP +Probably, you probably want to use .BR readdir (3) -instead. +instead of these system calls. .PP These calls supersede .BR readdir (2). -.SH EXAMPLE +.SH EXAMPLES .\" FIXME The example program needs to be revised, since it uses the older .\" getdents() system call and the structure with smaller field widths. The program below demonstrates the use of @@ -254,7 +266,7 @@ inode# file type d_reclen d_off d_name do { perror(msg); exit(EXIT_FAILURE); } while (0) struct linux_dirent { - long d_ino; + unsigned long d_ino; off_t d_off; unsigned short d_reclen; char d_name[]; @@ -310,7 +322,7 @@ main(int argc, char *argv[]) .BR readdir (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index 7f3877fc5..6d6484364 100644 --- a/man2/getdomainname.2 +++ b/man2/getdomainname.2 @@ -139,7 +139,7 @@ field returned from a call to .BR uname (2), .BR uts_namespaces (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgid.2 b/man2/getgid.2 index 402edbf9e..e79369728 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 2b602ed2c..9699754e0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gethostname.2 b/man2/gethostname.2 index 3d7037dd2..67960072c 100644 --- a/man2/gethostname.2 +++ b/man2/gethostname.2 @@ -188,7 +188,7 @@ set to .BR uname (2), .BR uts_namespaces (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 92f5ae242..0c82cb56c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index 681fa4318..a9e6422d5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 9d8d312f1..b50afc8fc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpid.2 b/man2/getpid.2 index 50d47b5a5..43c848cc6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpriority.2 b/man2/getpriority.2 index 3b23bf991..70840ac0d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrandom.2 b/man2/getrandom.2 index 96509d0c1..3faf9a059 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getresuid.2 b/man2/getresuid.2 index e328862ed..be54e8d4a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 2abfe436b..425be975b 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -61,7 +61,7 @@ .\" 2008-05-07, mtk / Peter Zijlstra, Added description of RLIMIT_RTTIME .\" 2010-11-06, mtk: Added documentation of prlimit() .\" -.TH GETRLIMIT 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH GETRLIMIT 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME getrlimit, setrlimit, prlimit \- get/set resource limits .SH SYNOPSIS @@ -776,7 +776,7 @@ and .BR getrlimit () as wrapper functions that call .BR prlimit (). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR prlimit (). .PP @@ -853,7 +853,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrusage.2 b/man2/getrusage.2 index 97ef696ab..5334d7228 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsid.2 b/man2/getsid.2 index 28494525a..efb1d19d5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockname.2 b/man2/getsockname.2 index b83fcac0c..cf08504a4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index cfaa935e6..619363b27 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettid.2 b/man2/gettid.2 index 08e73a48f..407e5f4aa 100644 --- a/man2/gettid.2 +++ b/man2/gettid.2 @@ -28,6 +28,8 @@ gettid \- get thread identification .SH SYNOPSIS .nf +.B #define _GNU_SOURCE +.B #include <unistd.h> .B #include <sys/types.h> .PP .B pid_t gettid(void); @@ -81,8 +83,8 @@ is the same as its thread ID (the value returned by .BR clone (2), .BR fcntl (2), .BR fork (2), -.BR getpid (2), .BR get_robust_list (2), +.BR getpid (2), .\" .BR kcmp (2), .BR ioprio_set (2), .\" .BR move_pages (2), @@ -96,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index 6124bc7c2..ac71b663c 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -291,7 +291,7 @@ has been abandoned. .BR vdso (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getuid.2 b/man2/getuid.2 index b1c9c2584..e3088b70a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getunwind.2 b/man2/getunwind.2 index 55e4498bf..f5f9a4693 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getxattr.2 b/man2/getxattr.2 index b8c5dc827..f7bfa687f 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH GETXATTR 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH GETXATTR 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value .SH SYNOPSIS @@ -148,7 +148,7 @@ These system calls are Linux-specific. .\" and the SGI XFS development team, .\" .RI < linux-xfs@oss.sgi.com >. .\" Please send any bug reports or comments to these addresses. -.SH EXAMPLE +.SH EXAMPLES See .BR listxattr (2). .SH SEE ALSO @@ -162,7 +162,7 @@ See .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/idle.2 b/man2/idle.2 index 0f5e811cf..4e2151921 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.06 of the Linux +This page is part of release 5.07 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 c554bd817..b86a23c19 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.06 of the Linux +This page is part of release 5.07 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 0712c3526..de82d9481 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -140,7 +140,7 @@ is not a directory. Inotify was merged into the 2.6.13 Linux kernel. .SH CONFORMING TO This system call is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES See .BR inotify (7). .SH SEE ALSO @@ -148,7 +148,7 @@ See .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 b954af971..f7c8655c7 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.06 of the Linux +This page is part of release 5.07 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 3f6e9d405..ad06422a3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/intro.2 b/man2/intro.2 index d94189923..15cc58284 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.06 of the Linux +This page is part of release 5.07 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 6a305a793..0a390f2d0 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -4,14 +4,14 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_CANCEL 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IO_CANCEL 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME io_cancel \- cancel an outstanding asynchronous I/O operation .SH SYNOPSIS .nf .BR "#include <linux/aio_abi.h>" " /* Defines needed types */" .PP -.BI "int io_cancel(aio_context_t " ctx_id ", struct iocb *" iocb , +.BI "int io_cancel(io_context_t " ctx_id ", struct iocb *" iocb , .BI " struct io_event *" result ); .fi .PP @@ -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.06 of the Linux +This page is part of release 5.07 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 873b54467..9c35d836a 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -4,14 +4,14 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_DESTROY 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IO_DESTROY 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME io_destroy \- destroy an asynchronous I/O context .SH SYNOPSIS .nf .BR "#include <linux/aio_abi.h>" " /* Defines needed types */" .PP -.BI "int io_destroy(aio_context_t " ctx_id ); +.BI "int io_destroy(io_context_t " ctx_id ); .fi .PP .IR Note : @@ -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.06 of the Linux +This page is part of release 5.07 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 81c041577..a679fa02e 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -4,7 +4,7 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_GETEVENTS 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IO_GETEVENTS 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME io_getevents \- read asynchronous I/O events from the completion queue .SH SYNOPSIS @@ -12,7 +12,7 @@ io_getevents \- read asynchronous I/O events from the completion queue .BR "#include <linux/aio_abi.h>" " /* Defines needed types */" .BR "#include <linux/time.h>" " /* Defines 'struct timespec' */" .PP -.BI "int io_getevents(aio_context_t " ctx_id ", long " min_nr ", long " nr , +.BI "int io_getevents(io_context_t " ctx_id ", long " min_nr ", long " nr , .BI " struct io_event *" events \ ", struct timespec *" timeout ); .fi @@ -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.06 of the Linux +This page is part of release 5.07 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 6996e7f8b..8d2c7d36d 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -4,14 +4,14 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_SETUP 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IO_SETUP 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME io_setup \- create an asynchronous I/O context .SH SYNOPSIS .nf .BR "#include <linux/aio_abi.h>" " /* Defines needed types */" .PP -.BI "int io_setup(unsigned " nr_events ", aio_context_t *" ctx_idp ); +.BI "int io_setup(unsigned " nr_events ", io_context_t *" ctx_idp ); .fi .PP .IR Note : @@ -37,9 +37,11 @@ For the failure return, see NOTES. .SH ERRORS .TP .B EAGAIN -The specified \fInr_events\fP exceeds the user's limit of available events, +The specified \fInr_events\fP exceeds the limit of available events, as defined in -.IR /proc/sys/fs/aio-max-nr . +.IR /proc/sys/fs/aio-max-nr +(see +.BR proc (5)). .TP .B EFAULT An invalid pointer is passed for \fIctx_idp\fP. @@ -102,7 +104,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 f346e53e6..1a1958c6e 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -12,7 +12,7 @@ io_submit \- submit asynchronous I/O blocks for processing .nf .BR "#include <linux/aio_abi.h>" " /* Defines needed types */" .PP -.BI "int io_submit(aio_context_t " ctx_id ", long " nr \ +.BI "int io_submit(io_context_t " ctx_id ", long " nr \ ", struct iocb **" iocbpp ); .fi .PP @@ -279,7 +279,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl.2 b/man2/ioctl.2 index d80ec21fb..e0533cf55 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -82,6 +82,7 @@ Macros and defines used in specifying an .I request are located in the file .IR <sys/ioctl.h> . +See NOTES. .SH RETURN VALUE Usually, on success zero is returned. A few @@ -123,11 +124,7 @@ Arguments, returns, and semantics of vary according to the device driver in question (the call is used as a catch-all for operations that don't cleanly fit the UNIX stream I/O model). -See -.BR ioctl_list (2) -for a list of many of the known -.BR ioctl () -calls. +.PP The .BR ioctl () system call appeared in Version 7 AT&T UNIX. @@ -139,6 +136,59 @@ call has unwanted side effects, that can be avoided under Linux by giving it the .B O_NONBLOCK flag. +.\" +.SS ioctl structure +.\" added two sections - aeb +Ioctl command values are 32-bit constants. +In principle these constants are completely arbitrary, but people have +tried to build some structure into them. +.PP +The old Linux situation was that of mostly 16-bit constants, where the +last byte is a serial number, and the preceding byte(s) give a type +indicating the driver. +Sometimes the major number was used: 0x03 +for the +.B HDIO_* +ioctls, 0x06 for the +.B LP* +ioctls. +And sometimes +one or more ASCII letters were used. +For example, +.B TCGETS +has value +0x00005401, with 0x54 = \(aqT\(aq indicating the terminal driver, and +.B CYGETTIMEOUT +has value 0x00435906, with 0x43 0x59 = \(aqC\(aq \(aqY\(aq +indicating the cyclades driver. +.PP +Later (0.98p5) some more information was built into the number. +One has 2 direction bits +(00: none, 01: write, 10: read, 11: read/write) +followed by 14 size bits (giving the size of the argument), +followed by an 8-bit type (collecting the ioctls in groups +for a common purpose or a common driver), and an 8-bit +serial number. +.PP +The macros describing this structure live in +.I <asm/ioctl.h> +and are +.B _IO(type,nr) +and +.BR "{_IOR,_IOW,_IOWR}(type,nr,size)" . +They use +.I sizeof(size) +so that size is a +misnomer here: this third argument is a data type. +.PP +Note that the size bits are very unreliable: in lots of cases +they are wrong, either because of buggy macros using +.IR sizeof(sizeof(struct)) , +or because of legacy values. +.PP +Thus, it seems that the new structure only gave disadvantages: +it does not help in checking, but it causes varying values +for the various architectures. .SH SEE ALSO .BR execve (2), .BR fcntl (2), @@ -146,9 +196,9 @@ flag. .BR ioctl_fat (2), .BR ioctl_ficlonerange (2), .BR ioctl_fideduperange (2), +.BR ioctl_fslabel (2), .BR ioctl_getfsmap (2), .BR ioctl_iflags (2), -.BR ioctl_list (2), .BR ioctl_ns (2), .BR ioctl_tty (2), .BR ioctl_userfaultfd (2), @@ -157,7 +207,7 @@ flag. .BR sd (4), .BR tty (4) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 27c98846b..dcb350986 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.06 of the Linux +This page is part of release 5.07 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 e586c2804..57f7809ed 100644 --- a/man2/ioctl_fat.2 +++ b/man2/ioctl_fat.2 @@ -21,7 +21,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH IOCTL_FAT 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH IOCTL_FAT 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_fat \- manipulating the FAT filesystem .SH SYNOPSIS @@ -243,7 +243,7 @@ was introduced in version 3.11 of the Linux kernel. .SH CONFORMING TO This API is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES .SS Toggling the archive flag The following program demonstrates the usage of .BR ioctl (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.06 of the Linux +This page is part of release 5.07 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 a3ad78fd0..c7473268f 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.06 of the Linux +This page is part of release 5.07 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 500d623bb..d9e915ac5 100644 --- a/man2/ioctl_fideduperange.2 +++ b/man2/ioctl_fideduperange.2 @@ -213,7 +213,7 @@ single call. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_fslabel.2 b/man2/ioctl_fslabel.2 new file mode 100644 index 000000000..e6c35c66d --- /dev/null +++ b/man2/ioctl_fslabel.2 @@ -0,0 +1,98 @@ +.\" Copyright (c) 2018, Red Hat, Inc. All rights reserved. +.\" +.\" %%%LICENSE_START(GPLv2+_DOC_FULL) +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, see +.\" <http://www.gnu.org/licenses/>. +.\" %%%LICENSE_END +.TH IOCTL_FSLABEL 2 2020-04-20 "Linux" "Linux Programmer's Manual" +.SH NAME +ioctl_fslabel \- get or set a filesystem label +.SH SYNOPSIS +.br +.B #include <sys/ioctl.h> +.br +.B #include <linux/fs.h> +.sp +.BI "int ioctl(int " fd ", FS_IOC_GETFSLABEL, char " label [FSLABEL_MAX]); +.br +.BI "int ioctl(int " fd ", FS_IOC_SETFSLABEL, char " label [FSLABEL_MAX]); +.SH DESCRIPTION +If a filesystem supports online label manipulation, these +.BR ioctl (2) +operations can be used to get or set the filesystem label for the filesystem +on which +.B fd +resides. +The +.B FS_IOC_SETFSLABEL +operation requires privilege +.RB ( CAP_SYS_ADMIN ). +.SH RETURN VALUE +On success zero is returned. On error, \-1 is returned, and +.I errno +is set to indicate the error. +.PP +.SH ERRORS +Error can include (but are not limited to) the following: +.TP +.B EFAULT +.I label +references an inaccessible memory area. +.TP +.B EINVAL +The specified label exceeds the maximum label length for the filesystem. +.TP +.B ENOTTY +This can appear if the filesystem does not support online label manipulation. +.TP +.B EPERM +The calling process does not have sufficient permissions to set the label. +.SH VERSIONS +These +.BR ioctl (2) +operations first appeared in Linux 4.18. +They were previously known as +.B BTRFS_IOC_GET_FSLABEL +and +.B BTRFS_IOC_SET_FSLABEL +and were private to Btrfs. +.SH CONFORMING TO +This API is Linux-specific. +.SH NOTES +The maximum string length for this interface is +.BR FSLABEL_MAX , +including the terminating null byte (\(aq\\0\(aq). +Filesystems have differing maximum label lengths, which may or +may not include the terminating null. The string provided to +.B FS_IOC_SETFSLABEL +must always be null-terminated, and the string returned by +.B FS_IOC_GETFSLABEL +will always be null-terminated. +.SH SEE ALSO +.BR ioctl (2), +.BR blkid (8) +.SH COLOPHON +This page is part of release 5.07 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/ioctl_getfsmap.2 b/man2/ioctl_getfsmap.2 index 44c717f19..efc1b6fc5 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -20,7 +20,7 @@ .\" License along with this manual; if not, see .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END -.TH IOCTL_GETFSMAP 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IOCTL_GETFSMAP 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_getfsmap \- retrieve the physical layout of the filesystem .SH SYNOPSIS @@ -363,7 +363,7 @@ operation first appeared in Linux 4.12. .SH CONFORMING TO This API is Linux-specific. Not all filesystems support it. -.SH EXAMPLE +.SH EXAMPLES See .I io/fsmap.c in the @@ -372,7 +372,7 @@ distribution for a sample program. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 db78e9612..23f3f3ac6 100644 --- a/man2/ioctl_iflags.2 +++ b/man2/ioctl_iflags.2 @@ -221,7 +221,7 @@ that the argument is .BR xattr (7), .BR mount (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_list.2 b/man2/ioctl_list.2 deleted file mode 100644 index 5e813c947..000000000 --- a/man2/ioctl_list.2 +++ /dev/null @@ -1,1055 +0,0 @@ -.\" Ioctl List 1.3.27 is copyright 1995 by Michael Elizabeth Chastain. -.\" Michael Elizabeth Chastain -.\" <mec@duracef.shout.net> -.\" -.\" %%%LICENSE_START(GPLv2_MISC) -.\" It is licensed under the GNU General Public License, Version 2. -.\" %%%LICENSE_END -.\" -.\" Ioctl List 1.3.27 -.\" Sun 17 Sep 1995 -.\" -.\" // Copyright -.\" -.\" -.\" -.\" // Change Log -.\" -.\" 1.3.27 421 ioctls. -.\" Type information for non-pointer args. -.\" SIOCDEVPRIVATE, SIOCPROTOPRIVATE ioctls. -.\" Descriptions of extended arguments. -.\" -.\" 1.2.9 365 ioctls. -.\" First public version. -.\" -.\" -.\" 2007-12-29 Alain Portal <aportal@univ-montp2.fr> and Michael Kerrisk -.\" <mtk.manpages@gmail.com>: -.\" Various formatting improvements -.\" -.TH IOCTL_LIST 2 2019-11-19 "Linux" "Linux Programmer's Manual" -.SH NAME -ioctl_list \- list of ioctl calls in Linux/i386 kernel -.SH DESCRIPTION -This is Ioctl List 1.3.27, a list of ioctl calls in Linux/i386 kernel -1.3.27. -It contains 421 ioctls from -.IR </usr/include/{asm,linux}/*.h> . -For each ioctl, its numerical value, its name, and its argument -type are given. -.PP -An argument type of -.I "const struct foo\ *" -means the argument is input to the kernel. -.I "struct foo\ *" -means the kernel outputs the argument. -If the kernel uses the argument for both input and output, this is -marked with \fI//\ I-O\fP. -.PP -Some ioctls take more arguments or return more values than a single -structure. -These are marked \fI//\ MORE\fP and documented further in a -separate section. -In addition, information about some ioctls can be found in -the pages listed under SEE ALSO in -.BR ioctl (2). -.PP -This list is very incomplete. -.SS ioctl structure -.\" added two sections - aeb -Ioctl command values are 32-bit constants. -In principle these constants are completely arbitrary, but people have -tried to build some structure into them. -.PP -The old Linux situation was that of mostly 16-bit constants, where the -last byte is a serial number, and the preceding byte(s) give a type -indicating the driver. -Sometimes the major number was used: 0x03 -for the -.B HDIO_* -ioctls, 0x06 for the -.B LP* -ioctls. -And sometimes -one or more ASCII letters were used. -For example, -.B TCGETS -has value -0x00005401, with 0x54 = \(aqT\(aq indicating the terminal driver, and -.B CYGETTIMEOUT -has value 0x00435906, with 0x43 0x59 = \(aqC\(aq \(aqY\(aq -indicating the cyclades driver. -.PP -Later (0.98p5) some more information was built into the number. -One has 2 direction bits -(00: none, 01: write, 10: read, 11: read/write) -followed by 14 size bits (giving the size of the argument), -followed by an 8-bit type (collecting the ioctls in groups -for a common purpose or a common driver), and an 8-bit -serial number. -.PP -The macros describing this structure live in -.I <asm/ioctl.h> -and are -.B _IO(type,nr) -and -.BR "{_IOR,_IOW,_IOWR}(type,nr,size)" . -They use -.I sizeof(size) -so that size is a -misnomer here: this third argument is a data type. -.PP -Note that the size bits are very unreliable: in lots of cases -they are wrong, either because of buggy macros using -.IR sizeof(sizeof(struct)) , -or because of legacy values. -.PP -Thus, it seems that the new structure only gave disadvantages: -it does not help in checking, but it causes varying values -for the various architectures. -.SH RETURN VALUE -Decent ioctls return 0 on success and \-1 on error, while -any output value is stored via the argument. -However, -quite a few ioctls in fact return an output value. -This is not yet indicated below. -.PP -// Main table. -.PP -// <include/asm-i386/socket.h> -.TS -l l l. -0x00008901 FIOSETOWN const int * -0x00008902 SIOCSPGRP const int * -0x00008903 FIOGETOWN int * -0x00008904 SIOCGPGRP int * -0x00008905 SIOCATMAR int * -0x00008906 SIOCGSTAMP timeval * -.TE -.sp 1 -// <include/asm-i386/termios.h> -.TS -l l l l. -0x00005401 TCGETS struct termios * -0x00005402 TCSETS const struct termios * -0x00005403 TCSETSW const struct termios * -0x00005404 TCSETSF const struct termios * -0x00005405 TCGETA struct termio * -0x00005406 TCSETA const struct termio * -0x00005407 TCSETAW const struct termio * -0x00005408 TCSETAF const struct termio * -0x00005409 TCSBRK int -0x0000540A TCXONC int -0x0000540B TCFLSH int -0x0000540C TIOCEXCL void -0x0000540D TIOCNXCL void -0x0000540E TIOCSCTTY int -0x0000540F TIOCGPGRP pid_t * -0x00005410 TIOCSPGRP const pid_t * -0x00005411 TIOCOUTQ int * -0x00005412 TIOCSTI const char * -0x00005413 TIOCGWINSZ struct winsize * -0x00005414 TIOCSWINSZ const struct winsize * -0x00005415 TIOCMGET int * -0x00005416 TIOCMBIS const int * -0x00005417 TIOCMBIC const int * -0x00005418 TIOCMSET const int * -0x00005419 TIOCGSOFTCAR int * -0x0000541A TIOCSSOFTCAR const int * -0x0000541B FIONREAD int * -0x0000541B TIOCINQ int * -0x0000541C TIOCLINUX const char * // MORE -0x0000541D TIOCCONS void -0x0000541E TIOCGSERIAL struct serial_struct * -0x0000541F TIOCSSERIAL const struct serial_struct * -0x00005420 TIOCPKT const int * -0x00005421 FIONBIO const int * -0x00005422 TIOCNOTTY void -0x00005423 TIOCSETD const int * -0x00005424 TIOCGETD int * -0x00005425 TCSBRKP int -0x00005426 TIOCTTYGSTRUCT struct tty_struct * -0x00005450 FIONCLEX void -0x00005451 FIOCLEX void -0x00005452 FIOASYNC const int * -0x00005453 TIOCSERCONFIG void -0x00005454 TIOCSERGWILD int * -0x00005455 TIOCSERSWILD const int * -0x00005456 TIOCGLCKTRMIOS struct termios * -0x00005457 TIOCSLCKTRMIOS const struct termios * -0x00005458 TIOCSERGSTRUCT struct async_struct * -0x00005459 TIOCSERGETLSR int * -.TE -.\" Some tables are split into two or more to avoid the warning: -.\" "table wider than line width". Some lines are to long to fit -.\" on one line on an 80 columns console -.TS -l l l. -0x0000545A TIOCSERGETMULTI struct serial_multiport_struct * -0x0000545B TIOCSERSETMULTI const struct serial_multiport_struct * -.TE -.sp 1 -// <include/linux/ax25.h> -.TS -l l l l. -0x000089E0 SIOCAX25GETUID const struct sockaddr_ax25 * -0x000089E1 SIOCAX25ADDUID const struct sockaddr_ax25 * -0x000089E2 SIOCAX25DELUID const struct sockaddr_ax25 * -0x000089E3 SIOCAX25NOUID const int * -0x000089E4 SIOCAX25DIGCTL const int * -0x000089E5 SIOCAX25GETPARMS struct ax25_parms_struct * // I-O -.TE -.TS -l l l. -0x000089E6 SIOCAX25SETPARMS const struct ax25_parms_struct * -.TE -.sp 1 -// <include/linux/cdk.h> -.TS -l l l. -0x00007314 STL_BINTR void -0x00007315 STL_BSTART void -0x00007316 STL_BSTOP void -0x00007317 STL_BRESET void -.TE -.sp 1 -// <include/linux/cdrom.h> -.TS -l l l. -0x00005301 CDROMPAUSE void -0x00005302 CDROMRESUME void -0x00005303 CDROMPLAYMSF const struct cdrom_msf * -0x00005304 CDROMPLAYTRKIND const struct cdrom_ti * -0x00005305 CDROMREADTOCHDR struct cdrom_tochdr * -.TE -.TS -l l l l. -0x00005306 CDROMREADTOCENTRY struct cdrom_tocentry * // I-O -.TE -.TS -l l l l. -0x00005307 CDROMSTOP void -0x00005308 CDROMSTART void -0x00005309 CDROMEJECT void -0x0000530A CDROMVOLCTRL const struct cdrom_volctrl * -0x0000530B CDROMSUBCHNL struct cdrom_subchnl * // I-O -0x0000530C CDROMREADMODE2 const struct cdrom_msf * // MORE -0x0000530D CDROMREADMODE1 const struct cdrom_msf * // MORE -0x0000530E CDROMREADAUDIO const struct cdrom_read_audio * // MORE -0x0000530F CDROMEJECT_SW int -.TE -.TS -l l l l. -0x00005310 CDROMMULTISESSION struct cdrom_multisession * // I-O -.TE -.TS -l l l l. -0x00005311 CDROM_GET_UPC struct { char [8]; } * -0x00005312 CDROMRESET void -0x00005313 CDROMVOLREAD struct cdrom_volctrl * -0x00005314 CDROMREADRAW const struct cdrom_msf * // MORE -0x00005315 CDROMREADCOOKED const struct cdrom_msf * // MORE -0x00005316 CDROMSEEK const struct cdrom_msf * -.TE -.sp 1 -// <include/linux/cm206.h> -.TS -l l l. -0x00002000 CM206CTL_GET_STAT int -0x00002001 CM206CTL_GET_LAST_STAT int -.TE -.sp 1 -// <include/linux/cyclades.h> -.TS -l l l. -0x00435901 CYGETMON struct cyclades_monitor * -0x00435902 CYGETTHRESH int * -0x00435903 CYSETTHRESH int -0x00435904 CYGETDEFTHRESH int * -0x00435905 CYSETDEFTHRESH int -0x00435906 CYGETTIMEOUT int * -0x00435907 CYSETTIMEOUT int -0x00435908 CYGETDEFTIMEOUT int * -0x00435909 CYSETDEFTIMEOUT int -.TE -.sp 1 -// <include/linux/fd.h> -.TS -l l l. -0x00000000 FDCLRPRM void -0x00000001 FDSETPRM const struct floppy_struct * -0x00000002 FDDEFPRM const struct floppy_struct * -0x00000003 FDGETPRM struct floppy_struct * -0x00000004 FDMSGON void -0x00000005 FDMSGOFF void -0x00000006 FDFMTBEG void -0x00000007 FDFMTTRK const struct format_descr * -0x00000008 FDFMTEND void -0x0000000A FDSETEMSGTRESH int -0x0000000B FDFLUSH void -0x0000000C FDSETMAXERRS const struct floppy_max_errors * -0x0000000E FDGETMAXERRS struct floppy_max_errors * -0x00000010 FDGETDRVTYP struct { char [16]; } * -0x00000014 FDSETDRVPRM const struct floppy_drive_params * -0x00000015 FDGETDRVPRM struct floppy_drive_params * -0x00000016 FDGETDRVSTAT struct floppy_drive_struct * -0x00000017 FDPOLLDRVSTAT struct floppy_drive_struct * -0x00000018 FDRESET int -0x00000019 FDGETFDCSTAT struct floppy_fdc_state * -0x0000001B FDWERRORCLR void -0x0000001C FDWERRORGET struct floppy_write_errors * -.TE -.TS -l l l l. -0x0000001E FDRAWCMD struct floppy_raw_cmd * // MORE // I-O -0x00000028 FDTWADDLE void -.TE -.sp 1 -// <include/linux/fs.h> -.TS -l l l l. -0x0000125D BLKROSET const int * -0x0000125E BLKROGET int * -0x0000125F BLKRRPART void -0x00001260 BLKGETSIZE unsigned long * -0x00001261 BLKFLSBUF void -0x00001262 BLKRASET unsigned long -0x00001263 BLKRAGET unsigned long * -0x00000001 FIBMAP int * // I-O -0x00000002 FIGETBSZ int * -0x80086601 FS_IOC_GETFLAGS int * -0x40086602 FS_IOC_SETFLAGS int * -0x80087601 FS_IOC_GETVERSION int * -0x40087602 FS_IOC_SETVERSION int * -0xC020660B FS_IOC_FIEMAP struct fiemap * -0x40086602 FS_IOC32_SETFLAGS int * -0x40086602 FS_IOC32_SETFLAGS int * -0x80047601 FS_IOC32_GETVERSION int * -0x40047602 FS_IOC32_SETVERSION int * -.TE -.sp 1 -// <include/linux/hdreg.h> -.TS -l l l l. -0x00000301 HDIO_GETGEO struct hd_geometry * -0x00000302 HDIO_GET_UNMASKINTR int * -0x00000304 HDIO_GET_MULTCOUNT int * -0x00000307 HDIO_GET_IDENTITY struct hd_driveid * -0x00000308 HDIO_GET_KEEPSETTINGS int * -0x00000309 HDIO_GET_CHIPSET int * -0x0000030A HDIO_GET_NOWERR int * -0x0000030B HDIO_GET_DMA int * -0x0000031F HDIO_DRIVE_CMD int * // I-O -0x00000321 HDIO_SET_MULTCOUNT int -0x00000322 HDIO_SET_UNMASKINTR int -0x00000323 HDIO_SET_KEEPSETTINGS int -0x00000324 HDIO_SET_CHIPSET int -0x00000325 HDIO_SET_NOWERR int -0x00000326 HDIO_SET_DMA int -.TE -.sp 1 -// <include/linux/if_eql.h> -.TS -l l l l. -0x000089F0 EQL_ENSLAVE struct ifreq * // MORE // I-O -0x000089F1 EQL_EMANCIPATE struct ifreq * // MORE // I-O -0x000089F2 EQL_GETSLAVECFG struct ifreq * // MORE // I-O -0x000089F3 EQL_SETSLAVECFG struct ifreq * // MORE // I-O -0x000089F4 EQL_GETMASTRCFG struct ifreq * // MORE // I-O -0x000089F5 EQL_SETMASTRCFG struct ifreq * // MORE // I-O -.TE -.sp 1 -// <include/linux/if_plip.h> -.TS -l l l l. -0x000089F0 SIOCDEVPLIP struct ifreq * // I-O -.TE -.sp 1 -// <include/linux/if_ppp.h> -.TS -l l l. -0x00005490 PPPIOCGFLAGS int * -0x00005491 PPPIOCSFLAGS const int * -0x00005492 PPPIOCGASYNCMAP int * -0x00005493 PPPIOCSASYNCMAP const int * -0x00005494 PPPIOCGUNIT int * -0x00005495 PPPIOCSINPSIG const int * -0x00005497 PPPIOCSDEBUG const int * -0x00005498 PPPIOCGDEBUG int * -0x00005499 PPPIOCGSTAT struct ppp_stats * -0x0000549A PPPIOCGTIME struct ppp_ddinfo * -0x0000549B PPPIOCGXASYNCMAP struct { int [8]; } * -0x0000549C PPPIOCSXASYNCMAP const struct { int [8]; } * -0x0000549D PPPIOCSMRU const int * -0x0000549E PPPIOCRASYNCMAP const int * -0x0000549F PPPIOCSMAXCID const int * -.TE -.sp 1 -// <include/linux/ipx.h> -.TS -l l l. -0x000089E0 SIOCAIPXITFCRT const char * -0x000089E1 SIOCAIPXPRISLT const char * -0x000089E2 SIOCIPXCFGDATA struct ipx_config_data * -.TE -.sp 1 -// <include/linux/kd.h> -.TS -l l l. -0x00004B60 GIO_FONT struct { char [8192]; } * -0x00004B61 PIO_FONT const struct { char [8192]; } * -.TE -.TS -l2 l2 l2 l. -0x00004B6B GIO_FONTX struct console_font_desc * // MORE // I-O -0x00004B6C PIO_FONTX const struct console_font_desc * //MORE -.TE -.TS -l l l. -0x00004B70 GIO_CMAP struct { char [48]; } * -0x00004B71 PIO_CMAP const struct { char [48]; } -.TE -.TS -l l l l. -0x00004B2F KIOCSOUND int -0x00004B30 KDMKTONE int -0x00004B31 KDGETLED char * -0x00004B32 KDSETLED int -0x00004B33 KDGKBTYPE char * -0x00004B34 KDADDIO int // MORE -0x00004B35 KDDELIO int // MORE -0x00004B36 KDENABIO void // MORE -0x00004B37 KDDISABIO void // MORE -0x00004B3A KDSETMODE int -0x00004B3B KDGETMODE int * -0x00004B3C KDMAPDISP void // MORE -0x00004B3D KDUNMAPDISP void // MORE -0x00004B40 GIO_SCRNMAP struct { char [E_TABSZ]; } * -.TE -.TS -l l l. -0x00004B41 PIO_SCRNMAP const struct { char [E_TABSZ]; } * -0x00004B69 GIO_UNISCRNMAP struct { short [E_TABSZ]; } * -0x00004B6A PIO_UNISCRNMAP const struct { short [E_TABSZ]; } * -.TE -.TS -l l l l. -0x00004B66 GIO_UNIMAP struct unimapdesc * // MORE // I-O -0x00004B67 PIO_UNIMAP const struct unimapdesc * // MORE -0x00004B68 PIO_UNIMAPCLR const struct unimapinit * -0x00004B44 KDGKBMODE int * -0x00004B45 KDSKBMODE int -0x00004B62 KDGKBMETA int * -0x00004B63 KDSKBMETA int -0x00004B64 KDGKBLED int * -0x00004B65 KDSKBLED int -0x00004B46 KDGKBENT struct kbentry * // I-O -0x00004B47 KDSKBENT const struct kbentry * -0x00004B48 KDGKBSENT struct kbsentry * // I-O -0x00004B49 KDSKBSENT const struct kbsentry * -0x00004B4A KDGKBDIACR struct kbdiacrs * -0x00004B4B KDSKBDIACR const struct kbdiacrs * -0x00004B4C KDGETKEYCODE struct kbkeycode * // I-O -0x00004B4D KDSETKEYCODE const struct kbkeycode * -0x00004B4E KDSIGACCEPT int -.TE -.sp 1 -// <include/linux/lp.h> -.TS -l l l. -0x00000601 LPCHAR int -0x00000602 LPTIME int -0x00000604 LPABORT int -0x00000605 LPSETIRQ int -0x00000606 LPGETIRQ int * -0x00000608 LPWAIT int -0x00000609 LPCAREFUL int -0x0000060A LPABORTOPEN int -0x0000060B LPGETSTATUS int * -0x0000060C LPRESET void -0x0000060D LPGETSTATS struct lp_stats * -.TE -.sp 1 -// <include/linux/mroute.h> -.TS -l l l l. -0x000089E0 SIOCGETVIFCNT struct sioc_vif_req * // I-O -0x000089E1 SIOCGETSGCNT struct sioc_sg_req * // I-O -.TE -.sp 1 -// <include/linux/msdos_fs.h> see -.BR ioctl_fat (2) -.TS -l l l l. -0x82307201 VFAT_IOCTL_READDIR_BOTH struct dirent [2] -0x82307202 VFAT_IOCTL_READDIR_SHORT struct dirent [2] -0x80047210 FAT_IOCTL_GET_ATTRIBUTES __u32 * -0x40047211 FAT_IOCTL_SET_ATTRIBUTES const __u32 * -0x80047213 FAT_IOCTL_GET_VOLUME_ID __u32 * -.TE -.sp 1 -// <include/linux/mtio.h> -.TS -l l l. -0x40086D01 MTIOCTOP const struct mtop * -0x801C6D02 MTIOCGET struct mtget * -0x80046D03 MTIOCPOS struct mtpos * -0x80206D04 MTIOCGETCONFIG struct mtconfiginfo * -0x40206D05 MTIOCSETCONFIG const struct mtconfiginfo * -.TE -.sp 1 -// <include/linux/netrom.h> -.TS -l l l l. -0x000089E0 SIOCNRGETPARMS struct nr_parms_struct * // I-O -0x000089E1 SIOCNRSETPARMS const struct nr_parms_struct * -0x000089E2 SIOCNRDECOBS void -0x000089E3 SIOCNRRTCTL const int * -.TE -.sp 1 -// <include/uapi/linux/wireless.h> -.br -// This API is deprecated. -.br -// It is being replaced by nl80211 and cfg80211. -See -.br -// -.I https://wireless.wiki.kernel.org/en/developers/documentation/nl80211 -.TS -l l l. -x00008b00 SIOCSIWCOMMIT struct iwreq * -x00008b01 SIOCGIWNAME struct iwreq * -x00008b02 SIOCSIWNWID struct iwreq * -x00008b03 SIOCGIWNWID struct iwreq * -x00008b04 SIOCSIWFREQ struct iwreq * -x00008b05 SIOCGIWFREQ struct iwreq * -x00008b06 SIOCSIWMODE struct iwreq * -x00008b07 SIOCGIWMODE struct iwreq * -x00008b08 SIOCSIWSENS struct iwreq * -x00008b09 SIOCGIWSENS struct iwreq * -x00008b0a SIOCSIWRANGE struct iwreq * -x00008b0b SIOCGIWRANGE struct iwreq * -x00008b0c SIOCSIWPRIV struct iwreq * -x00008b0d SIOCGIWPRIV struct iwreq * -x00008b0e SIOCSIWSTATS struct iwreq * -x00008b0f SIOCGIWSTATS struct iwreq * -x00008b10 SIOCSIWSPY struct iwreq * -x00008b11 SIOCGIWSPY struct iwreq * -x00008b12 SIOCSIWTHRSPY struct iwreq * -x00008b13 SIOCGIWTHRSPY struct iwreq * -x00008b14 SIOCSIWAP struct iwreq * -x00008b15 SIOCGIWAP struct iwreq * -x00008b17 SIOCGIWAPLIST struct iwreq * -x00008b18 SIOCSIWSCAN struct iwreq * -x00008b19 SIOCGIWSCAN struct iwreq * -x00008b1a SIOCSIWESSID struct iwreq * -x00008b1b SIOCGIWESSID struct iwreq * -x00008b1c SIOCSIWNICKN struct iwreq * -x00008b1d SIOCGIWNICKN struct iwreq * -x00008b20 SIOCSIWRATE struct iwreq * -x00008b21 SIOCGIWRATE struct iwreq * -x00008b22 SIOCSIWRTS struct iwreq * -x00008b23 SIOCGIWRTS struct iwreq * -x00008b24 SIOCSIWFRAG struct iwreq * -x00008b25 SIOCGIWFRAG struct iwreq * -x00008b26 SIOCSIWTXPOW struct iwreq * -x00008b27 SIOCGIWTXPOW struct iwreq * -x00008b28 SIOCSIWRETRY struct iwreq * -x00008b29 SIOCGIWRETRY struct iwreq * -x00008b2a SIOCSIWENCODE struct iwreq * -x00008b2b SIOCGIWENCODE struct iwreq * -x00008b2c SIOCSIWPOWER struct iwreq * -x00008b2d SIOCGIWPOWER struct iwreq * -x00008b30 SIOCSIWGENIE struct iwreq * -x00008b31 SIOCGIWGENIE struct iwreq * -x00008b16 SIOCSIWMLME struct iwreq * -x00008b32 SIOCSIWAUTH struct iwreq * -x00008b33 SIOCGIWAUTH struct iwreq * -x00008b34 SIOCSIWENCODEEXT struct iwreq * -x00008b35 SIOCGIWENCODEEXT struct iwreq * -x00008b36 SIOCSIWPMKSA struct iwreq * -.TE -.sp 1 -// <include/linux/sbpcd.h> -.TS -l l l. -0x00009000 DDIOCSDBG const int * -0x00005382 CDROMAUDIOBUFSIZ int -.TE -.sp 1 -// <include/linux/scc.h> -.TS -l l l l. -0x00005470 TIOCSCCINI void -0x00005471 TIOCCHANINI const struct scc_modem * -0x00005472 TIOCGKISS struct ioctl_command * // I-O -0x00005473 TIOCSKISS const struct ioctl_command * -0x00005474 TIOCSCCSTAT struct scc_stat * -.TE -.sp 1 -// <include/linux/scsi.h> -.TS -l l l. -0x00005382 SCSI_IOCTL_GET_IDLUN struct { int [2]; } * -0x00005383 SCSI_IOCTL_TAGGED_ENABLE void -0x00005384 SCSI_IOCTL_TAGGED_DISABLE void -.TE -.TS -l l l l. -0x00005385 SCSI_IOCTL_PROBE_HOST const int * // MORE -.TE -.sp 1 -// <include/linux/smb_fs.h> -.TS -l l l. -0x80027501 SMB_IOC_GETMOUNTUID uid_t * -.TE -.sp 1 -// <include/uapi/linux/sockios.h> see -.BR netdevice (7) -.PP -.TS -l l l l. -0x0000890B SIOCADDRT const struct rtentry * // MORE -0x0000890C SIOCDELRT const struct rtentry * // MORE -0x00008910 SIOCGIFNAME char [] -0x00008911 SIOCSIFLINK void -0x00008912 SIOCGIFCONF struct ifconf * // MORE // I-O -0x00008913 SIOCGIFFLAGS struct ifreq * // I-O -0x00008914 SIOCSIFFLAGS const struct ifreq * -0x00008915 SIOCGIFADDR struct ifreq * // I-O -0x00008916 SIOCSIFADDR const struct ifreq * -0x00008917 SIOCGIFDSTADDR struct ifreq * // I-O -0x00008918 SIOCSIFDSTADDR const struct ifreq * -0x00008919 SIOCGIFBRDADDR struct ifreq * // I-O -0x0000891A SIOCSIFBRDADDR const struct ifreq * -0x0000891B SIOCGIFNETMASK struct ifreq * // I-O -0x0000891C SIOCSIFNETMASK const struct ifreq * -0x0000891D SIOCGIFMETRIC struct ifreq * // I-O -0x0000891E SIOCSIFMETRIC const struct ifreq * -0x0000891F SIOCGIFMEM struct ifreq * // I-O -0x00008920 SIOCSIFMEM const struct ifreq * -0x00008921 SIOCGIFMTU struct ifreq * // I-O -0x00008922 SIOCSIFMTU const struct ifreq * -.TE -.TS -l l l l. -0x00008923 OLD_SIOCGIFHWADDR struct ifreq * // I-O -0x00008924 SIOCSIFHWADDR const struct ifreq * // MORE -0x00008925 SIOCGIFENCAP int * -0x00008926 SIOCSIFENCAP const int * -0x00008927 SIOCGIFHWADDR struct ifreq * // I-O -0x00008929 SIOCGIFSLAVE void -0x00008930 SIOCSIFSLAVE void -0x00008931 SIOCADDMULTI const struct ifreq * -0x00008932 SIOCDELMULTI const struct ifreq * -0x00008940 SIOCADDRTOLD void -0x00008941 SIOCDELRTOLD void -0x00008950 SIOCDARP const struct arpreq * -0x00008951 SIOCGARP struct arpreq * // I-O -0x00008952 SIOCSARP const struct arpreq * -0x00008960 SIOCDRARP const struct arpreq * -0x00008961 SIOCGRARP struct arpreq * // I-O -0x00008962 SIOCSRARP const struct arpreq * -0x00008970 SIOCGIFMAP struct ifreq * // I-O -0x00008971 SIOCSIFMAP const struct ifreq * -.TE -.sp 1 -// <include/linux/soundcard.h> -.TS -l l l. -0x00005100 SNDCTL_SEQ_RESET void -0x00005101 SNDCTL_SEQ_SYNC void -.TE -.TS -l l l l. -0xC08C5102 SNDCTL_SYNTH_INFO struct synth_info * // I-O -0xC0045103 SNDCTL_SEQ_CTRLRATE int * // I-O -0x80045104 SNDCTL_SEQ_GETOUTCOUNT int * -0x80045105 SNDCTL_SEQ_GETINCOUNT int * -0x40045106 SNDCTL_SEQ_PERCMODE void -.TE -.TS -l l l. -0x40285107 SNDCTL_FM_LOAD_INSTR const struct sbi_instrument * -.TE -.TS -l l l l. -0x40045108 SNDCTL_SEQ_TESTMIDI const int * -0x40045109 SNDCTL_SEQ_RESETSAMPLES const int * -0x8004510A SNDCTL_SEQ_NRSYNTHS int * -0x8004510B SNDCTL_SEQ_NRMIDIS int * -0xC074510C SNDCTL_MIDI_INFO struct midi_info * // I-O -0x4004510D SNDCTL_SEQ_THRESHOLD const int * -0xC004510E SNDCTL_SYNTH_MEMAVL int * // I-O -0x4004510F SNDCTL_FM_4OP_ENABLE const int * -0xCFB85110 SNDCTL_PMGR_ACCESS struct patmgr_info * // I-O -0x00005111 SNDCTL_SEQ_PANIC void -.TE -.TS -l l l. -0x40085112 SNDCTL_SEQ_OUTOFBAND const struct seq_event_rec * -.TE -.TS -l l l l. -0xC0045401 SNDCTL_TMR_TIMEBASE int * // I-O -0x00005402 SNDCTL_TMR_START void -0x00005403 SNDCTL_TMR_STOP void -0x00005404 SNDCTL_TMR_CONTINUE void -0xC0045405 SNDCTL_TMR_TEMPO int * // I-O -0xC0045406 SNDCTL_TMR_SOURCE int * // I-O -0x40045407 SNDCTL_TMR_METRONOME const int * -0x40045408 SNDCTL_TMR_SELECT int * // I-O -0xCFB85001 SNDCTL_PMGR_IFACE struct patmgr_info * // I-O -0xC0046D00 SNDCTL_MIDI_PRETIME int * // I-O -0xC0046D01 SNDCTL_MIDI_MPUMODE const int * -.TE -.TS -l l l l. -0xC0216D02 SNDCTL_MIDI_MPUCMD struct mpu_command_rec * // I-O -.TE -.TS -l l l l. -0x00005000 SNDCTL_DSP_RESET void -0x00005001 SNDCTL_DSP_SYNC void -0xC0045002 SNDCTL_DSP_SPEED int * // I-O -0xC0045003 SNDCTL_DSP_STEREO int * // I-O -0xC0045004 SNDCTL_DSP_GETBLKSIZE int * // I-O -0xC0045006 SOUND_PCM_WRITE_CHANNELS int * // I-O -0xC0045007 SOUND_PCM_WRITE_FILTER int * // I-O -0x00005008 SNDCTL_DSP_POST void -0xC0045009 SNDCTL_DSP_SUBDIVIDE int * // I-O -0xC004500A SNDCTL_DSP_SETFRAGMENT int * // I-O -0x8004500B SNDCTL_DSP_GETFMTS int * -0xC0045005 SNDCTL_DSP_SETFMT int * // I-O -.TE -.TS -l l l. -0x800C500C SNDCTL_DSP_GETOSPACE struct audio_buf_info * -0x800C500D SNDCTL_DSP_GETISPACE struct audio_buf_info * -0x0000500E SNDCTL_DSP_NONBLOCK void -0x80045002 SOUND_PCM_READ_RATE int * -0x80045006 SOUND_PCM_READ_CHANNELS int * -0x80045005 SOUND_PCM_READ_BITS int * -0x80045007 SOUND_PCM_READ_FILTER int * -0x00004300 SNDCTL_COPR_RESET void -0xCFB04301 SNDCTL_COPR_LOAD const struct copr_buffer * -.TE -.TS -l l l l. -0xC0144302 SNDCTL_COPR_RDATA struct copr_debug_buf * // I-O -0xC0144303 SNDCTL_COPR_RCODE struct copr_debug_buf * // I-O -.TE -.TS -l l l. -0x40144304 SNDCTL_COPR_WDATA const struct copr_debug_buf * -0x40144305 SNDCTL_COPR_WCODE const struct copr_debug_buf * -.TE -.TS -l l l l. -0xC0144306 SNDCTL_COPR_RUN struct copr_debug_buf * // I-O -0xC0144307 SNDCTL_COPR_HALT struct copr_debug_buf * // I-O -.TE -.TS -l l l. -0x4FA44308 SNDCTL_COPR_SENDMSG const struct copr_msg * -0x8FA44309 SNDCTL_COPR_RCVMSG struct copr_msg * -0x80044D00 SOUND_MIXER_READ_VOLUME int * -0x80044D01 SOUND_MIXER_READ_BASS int * -0x80044D02 SOUND_MIXER_READ_TREBLE int * -0x80044D03 SOUND_MIXER_READ_SYNTH int * -0x80044D04 SOUND_MIXER_READ_PCM int * -0x80044D05 SOUND_MIXER_READ_SPEAKER int * -0x80044D06 SOUND_MIXER_READ_LINE int * -0x80044D07 SOUND_MIXER_READ_MIC int * -0x80044D08 SOUND_MIXER_READ_CD int * -0x80044D09 SOUND_MIXER_READ_IMIX int * -0x80044D0A SOUND_MIXER_READ_ALTPCM int * -0x80044D0B SOUND_MIXER_READ_RECLEV int * -0x80044D0C SOUND_MIXER_READ_IGAIN int * -0x80044D0D SOUND_MIXER_READ_OGAIN int * -0x80044D0E SOUND_MIXER_READ_LINE1 int * -0x80044D0F SOUND_MIXER_READ_LINE2 int * -0x80044D10 SOUND_MIXER_READ_LINE3 int * -0x80044D1C SOUND_MIXER_READ_MUTE int * -0x80044D1D SOUND_MIXER_READ_ENHANCE int * -0x80044D1E SOUND_MIXER_READ_LOUD int * -0x80044DFF SOUND_MIXER_READ_RECSRC int * -0x80044DFE SOUND_MIXER_READ_DEVMASK int * -0x80044DFD SOUND_MIXER_READ_RECMASK int * -0x80044DFB SOUND_MIXER_READ_STEREODEVS int * -0x80044DFC SOUND_MIXER_READ_CAPS int * -.TE -.TS -l l l l. -0xC0044D00 SOUND_MIXER_WRITE_VOLUME int * // I-O -0xC0044D01 SOUND_MIXER_WRITE_BASS int * // I-O -0xC0044D02 SOUND_MIXER_WRITE_TREBLE int * // I-O -0xC0044D03 SOUND_MIXER_WRITE_SYNTH int * // I-O -0xC0044D04 SOUND_MIXER_WRITE_PCM int * // I-O -0xC0044D05 SOUND_MIXER_WRITE_SPEAKER int * // I-O -0xC0044D06 SOUND_MIXER_WRITE_LINE int * // I-O -0xC0044D07 SOUND_MIXER_WRITE_MIC int * // I-O -0xC0044D08 SOUND_MIXER_WRITE_CD int * // I-O -0xC0044D09 SOUND_MIXER_WRITE_IMIX int * // I-O -0xC0044D0A SOUND_MIXER_WRITE_ALTPCM int * // I-O -0xC0044D0B SOUND_MIXER_WRITE_RECLEV int * // I-O -0xC0044D0C SOUND_MIXER_WRITE_IGAIN int * // I-O -0xC0044D0D SOUND_MIXER_WRITE_OGAIN int * // I-O -0xC0044D0E SOUND_MIXER_WRITE_LINE1 int * // I-O -0xC0044D0F SOUND_MIXER_WRITE_LINE2 int * // I-O -0xC0044D10 SOUND_MIXER_WRITE_LINE3 int * // I-O -0xC0044D1C SOUND_MIXER_WRITE_MUTE int * // I-O -0xC0044D1D SOUND_MIXER_WRITE_ENHANCE int * // I-O -0xC0044D1E SOUND_MIXER_WRITE_LOUD int * // I-O -0xC0044DFF SOUND_MIXER_WRITE_RECSRC int * // I-O -.TE -.sp 1 -// <include/linux/timerfd.h> see -.BR timerfd_create (2) -.TS -l l l l. -0x40085400 TFD_IOC_SET_TICKS uint64_t * -.TE -.sp 1 -// <include/linux/umsdos_fs.h> -.TS -l l l l. -0x000004D2 UMSDOS_READDIR_DOS struct umsdos_ioctl * // I-O -0x000004D3 UMSDOS_UNLINK_DOS const struct umsdos_ioctl * -0x000004D4 UMSDOS_RMDIR_DOS const struct umsdos_ioctl * -0x000004D5 UMSDOS_STAT_DOS struct umsdos_ioctl * // I-O -0x000004D6 UMSDOS_CREAT_EMD const struct umsdos_ioctl * -0x000004D7 UMSDOS_UNLINK_EMD const struct umsdos_ioctl * -0x000004D8 UMSDOS_READDIR_EMD struct umsdos_ioctl * // I-O -0x000004D9 UMSDOS_GETVERSION struct umsdos_ioctl * -0x000004DA UMSDOS_INIT_EMD void -0x000004DB UMSDOS_DOS_SETUP const struct umsdos_ioctl * -0x000004DC UMSDOS_RENAME_DOS const struct umsdos_ioctl * -.TE -.sp 1 -// <include/linux/vt.h> -.TS -l l l. -0x00005600 VT_OPENQRY int * -0x00005601 VT_GETMODE struct vt_mode * -0x00005602 VT_SETMODE const struct vt_mode * -0x00005603 VT_GETSTATE struct vt_stat * -0x00005604 VT_SENDSIG void -0x00005605 VT_RELDISP int -0x00005606 VT_ACTIVATE int -0x00005607 VT_WAITACTIVE int -0x00005608 VT_DISALLOCATE int -0x00005609 VT_RESIZE const struct vt_sizes * -0x0000560A VT_RESIZEX const struct vt_consize * -.TE -.sp 1 -// More arguments. -Some ioctl's take a pointer to a structure which contains additional -pointers. -These are documented here in alphabetical order. -.PP -.B CDROMREADAUDIO -takes an input pointer -.IR "const struct cdrom_read_audio\ *" . -The -.I buf -field points to an output buffer of length -.IR "nframes\ * CD_FRAMESIZE_RAW" . -.PP -.BR CDROMREADCOOKED , -.BR CDROMREADMODE1 , -.BR CDROMREADMODE2 , -and -.B CDROMREADRAW -take an input pointer -.IR "const struct cdrom_msf\ *" . -They use the same pointer as an output pointer to -.IR "char []" . -The length varies by request. -For -.BR CDROMREADMODE1 , -most drivers use CD_FRAMESIZE, but the Optics Storage -driver uses OPT_BLOCKSIZE instead (both have the numerical value -2048). -.PP -.nf - CDROMREADCOOKED char [CD_FRAMESIZE] - CDROMREADMODE1 char [CD_FRAMESIZE or OPT_BLOCKSIZE] - CDROMREADMODE2 char [CD_FRAMESIZE_RAW0] - CDROMREADRAW char [CD_FRAMESIZE_RAW] -.fi -.PP -.BR EQL_ENSLAVE , -.BR EQL_EMANCIPATE , -.BR EQL_GETSLAVECFG , -.BR EQL_SETSLAVECFG , -.BR EQL_GETMASTERCFG , -and -.B EQL_SETMASTERCFG -take a -.IR "struct ifreq\ *" . -The -.I ifr_data -field is a pointer to another structure as follows: -.PP -.nf - EQL_ENSLAVE const struct slaving_request * - EQL_EMANCIPATE const struct slaving_request * - EQL_GETSLAVECFG struct slave_config * // I-O - EQL_SETSLAVECFG const struct slave_config * - EQL_GETMASTERCFG struct master_config * - EQL_SETMASTERCFG const struct master_config * -.fi -.PP -.B FDRAWCMD -takes a -.IR "struct floppy raw_cmd\ *" . -If -.I flags & FD_RAW_WRITE -is nonzero, then -.I data -points to an input buffer of length -.IR length . -If -.I flags & FD_RAW_READ -is nonzero, then -.I data -points to an output buffer of length -.IR length . -.PP -.B GIO_FONTX -and -.B PIO_FONTX -take a -.I struct console_font_desc\ * -or a -.IR "const struct console_font_desc\ *" , -respectively. -.I chardata -points to a buffer of -.IR "char [charcount]" . -This is an output buffer for -.B GIO_FONTX -and an input buffer for -.BR PIO_FONTX . -.PP -.B GIO_UNIMAP -and -.B PIO_UNIMAP -take a -.I "struct unimapdesc\ *" -or a -.IR "const struct unimapdesc\ *" , -respectively. -.I entries -points to a buffer of -.IR "struct unipair [entry_ct]" . -This is an output buffer for -.B GIO_UNIMAP -and an input buffer for -.BR PIO_UNIMAP . -.PP -KDADDIO, KDDELIO, KDDISABIO, and KDENABIO enable or disable access to -I/O ports. -They are essentially alternate interfaces to 'ioperm'. -.PP -.B KDMAPDISP -and -.B KDUNMAPDISP -enable or disable memory mappings or I/O port access. -They are not implemented in the kernel. -.PP -.B SCSI_IOCTL_PROBE_HOST -takes an input pointer -.IR "const int\ *" , -which is a length. -It uses the same pointer as an output pointer to a -.I char [] -buffer of this length. -.PP -.B SIOCADDRT -and -.B SIOCDELRT -take an input pointer whose type depends on -the protocol: -.PP -.nf - Most protocols const struct rtentry * - AX.25 const struct ax25_route * - NET/ROM const struct nr_route_struct * - INET6 const struct in6_rtmsg * -.fi -.PP -.B SIOCGIFCONF -takes a -.IR "struct ifconf\ *" . -The -.I ifc_buf -field points to a buffer of length -.I ifc_len -bytes, into which the kernel writes a list of type -.IR "struct ifreq []" . -.PP -.B SIOCSIFHWADDR -takes an input pointer whose type depends on the protocol: -.PP -.nf - Most protocols const struct ifreq * - AX.25 const char [AX25_ADDR_LEN] -.fi -.PP -.B TIOCLINUX -takes a -.IR "const char\ *" . -It uses this to distinguish several -independent subcases. -In the table below, -.I N + foo -means -.I foo -after an N-byte pad. -.I struct selection -is implicitly defined in -.IR drivers/char/selection.c -.PP -.nf - TIOCLINUX-2 1 + const struct selection * - TIOCLINUX-3 void - TIOCLINUX-4 void - TIOCLINUX-5 4 + const struct { long [8]; } * - TIOCLINUX-6 char * - TIOCLINUX-7 char * - TIOCLINUX-10 1 + const char * -.fi -.PP -// Duplicate ioctls -.PP -This list does not include ioctls in the range -.B SIOCDEVPRIVATE -and -.BR SIOCPROTOPRIVATE . -.TS -l l l. -0x00000001 FDSETPRM FIBMAP -0x00000002 FDDEFPRM FIGETBSZ -0x00005382 CDROMAUDIOBUFSIZ SCSI_IOCTL_GET_IDLUN -0x00005402 SNDCTL_TMR_START TCSETS -0x00005403 SNDCTL_TMR_STOP TCSETSW -0x00005404 SNDCTL_TMR_CONTINUE TCSETSF -.TE -.SH SEE ALSO -.BR ioctl (2), -.BR ioctl_fat (2), -.BR netdevice (7) -.SH COLOPHON -This page is part of release 5.06 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/ioctl_ns.2 b/man2/ioctl_ns.2 index a562a5922..0ea9ab05d 100644 --- a/man2/ioctl_ns.2 +++ b/man2/ioctl_ns.2 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" -.TH IOCTL_NS 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH IOCTL_NS 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_ns \- ioctl() operations for Linux namespaces .SH DESCRIPTION @@ -186,7 +186,7 @@ does not refer to a file. .SH CONFORMING TO Namespaces and the operations described on this page are a Linux-specific. -.SH EXAMPLE +.SH EXAMPLES The example shown below uses the .BR ioctl (2) operations described above to perform simple @@ -361,7 +361,7 @@ main(int argc, char *argv[]) .BR proc (5), .BR namespaces (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 0cd4d9bed..d9708fd08 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH IOCTL_TTY 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IOCTL_TTY 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_tty \- ioctls for terminals and serial lines .SH SYNOPSIS @@ -549,7 +549,7 @@ Inappropriate .TP .B EPERM Insufficient permission. -.SH EXAMPLE +.SH EXAMPLES Check the condition of DTR on the serial port. .PP .EX @@ -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.06 of the Linux +This page is part of release 5.07 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 49d8d6586..35e660379 100644 --- a/man2/ioctl_userfaultfd.2 +++ b/man2/ioctl_userfaultfd.2 @@ -25,7 +25,7 @@ .\" %%%LICENSE_END .\" .\" -.TH IOCTL_USERFAULTFD 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH IOCTL_USERFAULTFD 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_userfaultfd \- create a file descriptor for handling page faults in user space @@ -679,7 +679,7 @@ operation that queries features availability and reopened before the second .BR UFFDIO_API operation that actually enables the desired features. -.SH EXAMPLE +.SH EXAMPLES See .BR userfaultfd (2). .SH SEE ALSO @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 8e8175244..8068095be 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/iopl.2 b/man2/iopl.2 index 05ced4f59..97de1e454 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.06 of the Linux +This page is part of release 5.07 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 0919b640a..6b81bb1a3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ipc.2 b/man2/ipc.2 index 957c84bf2..29b26237f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 964d161c8..1f6a1d1f6 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -25,7 +25,7 @@ .\" .\" Kernel commit d97b46a64674a267bc41c9e16132ee2a98c3347d .\" -.TH KCMP 2 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH KCMP 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME kcmp \- compare two processes to determine if they share a kernel resource .SH SYNOPSIS @@ -319,7 +319,7 @@ See .BR clone (2) for some background information on the shared resources referred to on this page. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR kcmp () to test whether pairs of file descriptors refer to @@ -429,7 +429,7 @@ main(int argc, char *argv[]) .BR clone (2), .BR unshare (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 3c3b0dc17..26224537d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/keyctl.2 b/man2/keyctl.2 index 92ae2b872..29117351d 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -25,7 +25,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH KEYCTL 2 2019-03-06 Linux "Linux Key Management Calls" +.TH KEYCTL 2 2020-06-09 Linux "Linux Key Management Calls" .SH NAME keyctl \- manipulate the kernel's key management facility .SH SYNOPSIS @@ -1961,7 +1961,7 @@ When employing the wrapper in that library, link with However, rather than using this system call directly, you probably want to use the various library functions mentioned in the descriptions of individual operations above. -.SH EXAMPLE +.SH EXAMPLES The program below provide subset of the functionality of the .BR request-key (8) program provided by the @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kill.2 b/man2/kill.2 index 46ee72378..8eef7adf9 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -180,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/link.2 b/man2/link.2 index 86cd45f62..967f47091 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listen.2 b/man2/listen.2 index d46509b18..2aed34004 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -42,7 +42,7 @@ .\" Modified 11 May 2001 by Sam Varshavchik <mrsam@courier-mta.com> .\" .\" -.TH LISTEN 2 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH LISTEN 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME listen \- listen for connections on a socket .SH SYNOPSIS @@ -175,7 +175,7 @@ with the value 128. .\" The following is now rather historic information (MTK, Jun 05) .\" Don't rely on this value in portable applications since BSD .\" (and some BSD-derived systems) limit the backlog to 5. -.SH EXAMPLE +.SH EXAMPLES See .BR bind (2). .SH SEE ALSO @@ -185,7 +185,7 @@ See .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listxattr.2 b/man2/listxattr.2 index ea68e8a85..bfa530e02 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -23,7 +23,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH LISTXATTR 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH LISTXATTR 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME listxattr, llistxattr, flistxattr \- list extended attribute names .SH SYNOPSIS @@ -171,7 +171,7 @@ attribute name list returned by .BR listxattr (7). If the total size of attribute names attached to a file exceeds this limit, it is no longer possible to retrieve the list of attribute names. -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the usage of .BR listxattr () and @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/llseek.2 b/man2/llseek.2 index c4acba61a..c08391255 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.06 of the Linux +This page is part of release 5.07 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 5ecdec54c..6b26b9d09 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/lseek.2 b/man2/lseek.2 index 90c13090f..d748c60d4 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -276,7 +276,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/madvise.2 b/man2/madvise.2 index 5832e2e13..43487a1fc 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -594,7 +594,7 @@ from the system call, as it should). .BR posix_madvise (3), .BR core (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mbind.2 b/man2/mbind.2 index 070d300d7..16b82baa5 100644 --- a/man2/mbind.2 +++ b/man2/mbind.2 @@ -32,7 +32,7 @@ .\" Author: Lee Schermerhorn <lee.schermerhorn@hp.com> .\" Date: Thu Oct 25 14:16:32 2012 +0200 .\" -.TH MBIND 2 2017-09-15 Linux "Linux Programmer's Manual" +.TH MBIND 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME mbind \- set memory policy for a memory range .SH SYNOPSIS @@ -471,8 +471,10 @@ Support for huge page policy was added with 2.6.16. For interleave policy to be effective on huge page mappings the policied memory needs to be tens of megabytes or larger. .PP +Before Linux 5.7. +.\" commit dcf1763546d76c372f3136c8d6b2b6e77f140cf0 .B MPOL_MF_STRICT -is ignored on huge page mappings. +was ignored on huge page mappings. .PP .B MPOL_MF_MOVE and @@ -490,7 +492,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/membarrier.2 b/man2/membarrier.2 index c3d945531..c6b89755c 100644 --- a/man2/membarrier.2 +++ b/man2/membarrier.2 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MEMBARRIER 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH MEMBARRIER 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME membarrier \- issue memory barriers on a set of threads .SH SYNOPSIS @@ -270,7 +270,7 @@ Examples where .BR membarrier () can be useful include implementations of Read-Copy-Update libraries and garbage collectors. -.SH EXAMPLE +.SH EXAMPLES Assuming a multithreaded application where "fast_path()" is executed very frequently, and where "slow_path()" is executed infrequently, the following code (x86) can be transformed using @@ -414,7 +414,7 @@ main(int argc, char **argv) .EE .in .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 0884f8fbd..3b34c67d1 100644 --- a/man2/memfd_create.2 +++ b/man2/memfd_create.2 @@ -18,7 +18,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH MEMFD_CREATE 2 2020-02-09 Linux "Linux Programmer's Manual" +.TH MEMFD_CREATE 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME memfd_create \- create an anonymous file .SH SYNOPSIS @@ -341,7 +341,7 @@ If desired, the second process can apply further seals to impose additional restrictions (so long as the .BR F_SEAL_SEAL seal has not yet been applied). -.SH EXAMPLE +.SH EXAMPLES Below are shown two example programs that demonstrate the use of .BR memfd_create () and the file sealing API. @@ -549,7 +549,7 @@ main(int argc, char *argv[]) .BR shmget (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 1dd4eba52..7b77a9549 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mincore.2 b/man2/mincore.2 index b8c190a87..3ace64af7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 1d047fd4d..19da0330b 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -8,7 +8,7 @@ .\" Public License. It comes with NO WARRANTY. .\" %%%LICENSE_END .\" -.TH MKDIR 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MKDIR 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mkdir, mkdirat \- create a directory .SH SYNOPSIS @@ -249,10 +249,10 @@ argument. .BR stat (2), .BR umask (2), .BR unlink (2), -.BR acl (5) +.BR acl (5), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mknod.2 b/man2/mknod.2 index 23b9a6fbe..dca0589cf 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -298,10 +298,10 @@ and .BR unlink (2), .BR makedev (3), .BR mkfifo (3), -.BR acl (5) +.BR acl (5), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mlock.2 b/man2/mlock.2 index a9cb519ad..1aa17b0d3 100644 --- a/man2/mlock.2 +++ b/man2/mlock.2 @@ -275,7 +275,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4. .PP .BR mlock2 () is Linux specific. -.SH AVAILABILITY +.PP On POSIX systems on which .BR mlock () and @@ -463,7 +463,7 @@ and would fail on requests that should have succeeded. This bug was fixed .\" commit 0cf2f6f6dc605e587d2c1120f295934c77e810e8 -in Linux 4.9 +in Linux 4.9. .PP In the 2.4 series Linux kernels up to and including 2.4.17, a bug caused the @@ -498,7 +498,7 @@ resource limit is encountered. .BR proc (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap.2 b/man2/mmap.2 index 924bc825b..491869741 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -193,8 +193,8 @@ is set. .TP .B MAP_ANON Synonym for -.BR MAP_ANONYMOUS . -Deprecated. +.BR MAP_ANONYMOUS ; +provided for compatibility with other implementations. .TP .B MAP_ANONYMOUS The mapping is not backed by any file; @@ -370,7 +370,9 @@ This flag is meaningful only in conjunction with Don't perform read-ahead: create page tables entries only for pages that are already present in RAM. -Since Linux 2.6.23, this flag causes +Since Linux 2.6.23, +.\" commit 54cb8821de07f2ffcd28c380ce9b93d5784b40d7 +this flag causes .BR MAP_POPULATE to do nothing. One day, the combination of @@ -653,7 +655,7 @@ T} Thread safety MT-Safe POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD. .\" SVr4 documents additional error codes ENXIO and ENODEV. .\" SUSv2 documents additional error codes EMFILE and EOVERFLOW. -.SH AVAILABILITY +.PP On POSIX systems on which .BR mmap (), .BR msync (2), @@ -902,7 +904,7 @@ however, this doesn't work on .BR tmpfs (5) (for example, when using the POSIX shared memory interface documented in .BR shm_overview (7)). -.SH EXAMPLE +.SH EXAMPLES .\" FIXME . Add an example here that uses an anonymous shared region for .\" IPC between parent and child. .PP @@ -1016,7 +1018,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap2.2 b/man2/mmap2.2 index ab4a200f2..89df50fde 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.06 of the Linux +This page is part of release 5.07 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 156f3ef74..624cd9d7e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mount.2 b/man2/mount.2 index 0f74f6fd0..7ff16557f 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -934,7 +934,7 @@ for details of this file. .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 090c55e43..f6133a183 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 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH MOVE_PAGES 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME move_pages \- move individual pages of a process to another node .SH SYNOPSIS @@ -105,6 +105,9 @@ is an array of integers that return the status of each page. The array contains valid values only if .BR move_pages () did not return an error. +Preinitialization of the array to a value +which cannot represent a real numa node or valid error of status array +could help to identify pages that have been migrated. .PP .I flags specify what types of pages to move. @@ -165,8 +168,15 @@ returns zero. On error, it returns \-1, and sets .I errno to indicate the error. +If positive value is returned, it is the number of +nonmigrated pages. .SH ERRORS .TP +.B Positive value +The number of nonmigrated pages if they were the result of nonfatal +reasons (since +.\" commit a49bd4d7163707de377aee062f17befef6da891b +Linux 4.17). .B E2BIG Too many pages to move. Since Linux 2.6.29, @@ -248,7 +258,7 @@ or a similar package. .BR migratepages (8), .BR numastat (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mprotect.2 b/man2/mprotect.2 index 3c9c651b8..c43f3e00d 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -283,7 +283,7 @@ When called this way, the operation of .BR pkey_mprotect () is equivalent to .BR mprotect (). -.SH EXAMPLE +.SH EXAMPLES .\" sigaction.2 refers to this example .PP The program below demonstrates the use of @@ -374,7 +374,7 @@ main(int argc, char *argv[]) .BR sysconf (3), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 523234981..887a3e09b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mremap.2 b/man2/mremap.2 index 2c08f9ba0..bcd7246f7 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -27,7 +27,7 @@ .\" Update for Linux 1.3.87 and later .\" 2005-10-11 mtk: Added NOTES for MREMAP_FIXED; revised EINVAL text. .\" -.TH MREMAP 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MREMAP 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mremap \- remap a virtual memory address .SH SYNOPSIS @@ -74,27 +74,7 @@ If a new mapping is requested via this method, then the .B MREMAP_MAYMOVE flag must also be specified. .PP -In Linux the memory is divided into pages. -A user process has (one or) -several linear virtual memory segments. -Each virtual memory segment has one -or more mappings to real memory pages (in the page table). -Each virtual memory segment has its own -protection (access rights), which may cause -a segmentation violation if the memory is accessed incorrectly (e.g., -writing to a read-only segment). -Accessing virtual memory outside of the -segments will also cause a segmentation violation. -.PP -.BR mremap () -uses the Linux page table scheme. -.BR mremap () -changes the -mapping between virtual addresses and memory pages. -This can be used to implement a very efficient -.BR realloc (3). -.PP -The \fIflags\fP bit-mask argument may be 0, or include the following flag: +The \fIflags\fP bit-mask argument may be 0, or include the following flags: .TP .B MREMAP_MAYMOVE By default, if there is not sufficient space to expand a mapping @@ -124,11 +104,49 @@ Any previous mapping at the address range specified by and .I new_size is unmapped. +.IP If .B MREMAP_FIXED is specified, then .B MREMAP_MAYMOVE must also be specified. +.TP +.BR MREMAP_DONTUNMAP " (since Linux 5.7)" +.\" commit e346b3813067d4b17383f975f197a9aa28a3b077 +This flag, which must be used in conjunction with +.BR MREMAP_MAYMOVE , +remaps a mapping to a new address but does not unmap the mapping at +.IR old_address . +.IP +The +.B MREMAP_DONTUNMAP +flag can be used only with private anonymous mappings +(see the description of +.BR MAP_PRIVATE +and +.BR MAP_ANONYMOUS +in +.BR mmap (2)). +.IP +After completion, +any access to the range specified by +.IR old_address +and +.I old_size +will result in a page fault. +The page fault will be handled by a +.BR userfaultfd (2) +handler +if the address is in a range previously registered with +.BR userfaultfd (2). +Otherwise, the kernel allocates a zero-filled page to handle the fault. +.IP +The +.BR MREMAP_DONTUNMAP +flag may be used to atomically move a mapping while leaving the source +mapped. +See NOTES for some possible applications of +.BR MREMAP_DONTUNMAP . .PP If the memory segment specified by .I old_address @@ -156,7 +174,7 @@ but this was not possible without exceeding the resource limit. .TP .B EFAULT -"Segmentation fault." Some address in the range +Some address in the range \fIold_address\fP to \fIold_address\fP+\fIold_size\fP is an invalid virtual memory address for this process. You can also get @@ -176,6 +194,8 @@ a value other than .B MREMAP_MAYMOVE or .B MREMAP_FIXED +or +.B MREMAP_DONTUNMAP was specified in .IR flags ; .IP * @@ -197,9 +217,24 @@ and .IR old_size ; .IP * .B MREMAP_FIXED +or +.B MREMAP_DONTUNMAP was specified without also specifying .BR MREMAP_MAYMOVE ; .IP * +.B MREMAP_DONTUNMAP +was specified, but one or more pages in the range specified by +.IR old_address +and +.IR old_size +were not private anonymous; +.IP * +.B MREMAP_DONTUNMAP +was specified and +.IR old_size +was not equal to +.IR new_size ; +.IP * \fIold_size\fP was zero and \fIold_address\fP does not refer to a shareable mapping (but see BUGS); .IP * @@ -209,10 +244,20 @@ flag was not specified. .RE .TP .B ENOMEM +Not enough memory was available to complete the operation. +Possible causes are: +.RS +.IP * 3 The memory area cannot be expanded at the current virtual address, and the .B MREMAP_MAYMOVE flag is not set in \fIflags\fP. Or, there is not enough (virtual) memory available. +.IP * +.B MREMAP_DONTUNMAP +was used causing a new mapping to be created that would exceed the +(virtual) memory available. +Or, it would exceed the maximum number of allowed mappings. +.RE .SH CONFORMING TO This call is Linux-specific, and should not be used in programs intended to be portable. @@ -220,13 +265,26 @@ intended to be portable. .\" .BR mremap (2) .\" call with completely different semantics. .SH NOTES -Prior to version 2.4, glibc did not expose the definition of -.BR MREMAP_FIXED , -and the prototype for +.PP .BR mremap () -did not allow for the -.I new_address -argument. +changes the +mapping between virtual addresses and memory pages. +This can be used to implement a very efficient +.BR realloc (3). +.PP +In Linux, memory is divided into pages. +A process has (one or) +several linear virtual memory segments. +Each virtual memory segment has one +or more mappings to real memory pages (in the page table). +Each virtual memory segment has its own +protection (access rights), which may cause +a segmentation violation +.RB ( SIGSEGV ) +if the memory is accessed incorrectly (e.g., +writing to a read-only segment). +Accessing virtual memory outside of the +segments will also cause a segmentation violation. .PP If .BR mremap () @@ -238,6 +296,41 @@ call will make a best effort to populate the new area but will not fail with .B ENOMEM if the area cannot be populated. +.PP +Prior to version 2.4, glibc did not expose the definition of +.BR MREMAP_FIXED , +and the prototype for +.BR mremap () +did not allow for the +.I new_address +argument. +.\" +.SS MREMAP_DONTUNMAP use cases +Possible applications for +.BR MREMAP_DONTUNMAP +include: +.IP * 3 +Non-cooperative +.BR userfaultfd (2): +an application can yank out a virtual address range using +.BR MREMAP_DONTUNMAP +and then employ a +.BR userfaultfd (2) +handler to handle the page faults that subsequently occur +as other threads in the process touch pages in the yanked range. +.IP * +Garbage collection: +.BR MREMAP_DONTUNMAP +can be used in conjunction with +.BR userfaultfd (2) +to implement garbage collection algorithms (e.g., in a Java virtual machine). +Such an implementation can be cheaper (and simpler) +than conventional garbage collection techniques that involve +marking pages with protection +.BR PROT_NONE +in conjunction with the of a +.BR SIGSEGV +handler to catch accesses to those pages. .SH BUGS Before Linux 4.14, if @@ -275,7 +368,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgctl.2 b/man2/msgctl.2 index 3529abc5d..bb0d46de8 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -63,7 +63,8 @@ struct msqid_ds { struct ipc_perm msg_perm; /* Ownership and permissions */ time_t msg_stime; /* Time of last msgsnd(2) */ time_t msg_rtime; /* Time of last msgrcv(2) */ - time_t msg_ctime; /* Time of last change */ + time_t msg_ctime; /* Creation time/time of last + modification via msgctl() */ unsigned long __msg_cbytes; /* Current number of bytes in queue (nonstandard) */ msgqnum_t msg_qnum; /* Current number of messages @@ -114,10 +115,10 @@ Time of the last system call. .TP .I msg_ctime -Time of the last -system call that changed a member of the -.I msqid_ds -structure. +Time of creation of queue or time of last +.BR msgctl () +.BR IPC_SET +operation. .PP The .I ipc_perm @@ -451,7 +452,7 @@ flag in .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgget.2 b/man2/msgget.2 index 27b6f134d..a9feaa76b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgop.2 b/man2/msgop.2 index 2d30dc7a9..40f20effb 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -571,7 +571,7 @@ this error was not diagnosed by This bug is fixed .\" commit 4f87dac386cc43d5525da7a939d4b4e7edbea22c in Linux 3.14. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR msgsnd () and @@ -715,7 +715,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msync.2 b/man2/msync.2 index 896e55b71..dc375d6da 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MSYNC 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MSYNC 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME msync \- synchronize a file with a memory map .SH SYNOPSIS @@ -105,7 +105,7 @@ instead of .BR ENOMEM . In Linux 2.4.19, this was changed to the POSIX value .BR ENOMEM . -.SH AVAILABILITY +.PP On POSIX systems on which .BR msync () is available, both @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index b0f2eb9bb..329688f05 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nfsservctl.2 b/man2/nfsservctl.2 index 3db781a57..37a44c74e 100644 --- a/man2/nfsservctl.2 +++ b/man2/nfsservctl.2 @@ -2,7 +2,7 @@ .\" This text is in the public domain. .\" %%%LICENSE_END .\" -.TH NFSSERVCTL 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH NFSSERVCTL 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME nfsservctl \- syscall interface to kernel nfs daemon .SH SYNOPSIS @@ -63,8 +63,10 @@ This system call was removed from the Linux kernel in version 3.1. Library support was removed from glibc in version 2.28. .SH CONFORMING TO This call is Linux-specific. +.SH SEE ALSO +.BR nfsd (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nice.2 b/man2/nice.2 index fdd3a3f15..e2202533b 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -50,7 +50,7 @@ _XOPEN_SOURCE adds .I inc to the nice value for the calling thread. -(A higher nice value means a low priority.) +(A higher nice value means a lower priority.) .PP The range of the nice value is +19 (low priority) to \-20 (high priority). Attempts to set a nice value outside the range are clamped to the range. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/open.2 b/man2/open.2 index efd051963..4224f2c86 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -48,7 +48,7 @@ .\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and .\" O_TTYINIT. Eventually these may need to be documented. --mtk .\" -.TH OPEN 2 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH OPEN 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME open, openat, creat \- open and possibly create a file .SH SYNOPSIS @@ -283,7 +283,7 @@ For some filesystems, the behavior also depends on the and .I sysvgroups mount options described in -.BR mount (8)). +.BR mount (8). .\" As at 2.6.25, bsdgroups is supported by ext2, ext3, ext4, and .\" XFS (since 2.6.14). .RS @@ -955,7 +955,7 @@ system call is an extension of .BR openat (), and provides a superset of the features of .BR openat (). -It is separate documented, in +It is documented separately, in .BR openat2 (2). .SH RETURN VALUE .BR open (), @@ -983,6 +983,25 @@ is not allowed. (See also .BR path_resolution (7).) .TP +.B EACCES +.\" commit 30aba6656f61ed44cba445a3c0d38b296fa9e8f5 +Where +.B O_CREAT +is specified, the +.I protected_fifos +or +.I protected_regular +sysctl is enabled, the file already exists and is a FIFO or regular file, the +owner of the file is neither the current user nor the owner of the +containing directory, and the containing directory is both world- or +group-writable and sticky. +For details, see the descriptions of +.IR /proc/sys/fs/protected_fifos +and +.IR /proc/sys/fs/protected_regular +in +.BR proc (5). +.TP .B EDQUOT Where .B O_CREAT @@ -1042,7 +1061,6 @@ and the final component ("basename") of the new file's is invalid (e.g., it contains characters not permitted by the underlying filesystem). .TP - .TP .B EINVAL The final component ("basename") of .I pathname @@ -1574,12 +1592,16 @@ a directory file descriptor argument .BR fanotify_mark (2), .BR fchmodat (2), .BR fchownat (2), +.BR fspick (2), .BR fstatat (2), .BR futimesat (2), .BR linkat (2), .BR mkdirat (2), +.BR move_mount (2), .BR mknodat (2), .BR name_to_handle_at (2), +.BR open_tree (2), +.BR openat2 (2), .BR readlinkat (2), .BR renameat (2), .BR statx (2), @@ -1643,6 +1665,34 @@ directory", via file descriptor(s) maintained by the application. on the use of .IR /proc/self/fd/ dirfd, but less efficiently.) +.PP +The +.I dirfd +argument for these APIs can be obtained by using +.BR open () +or +.BR openat () +to open a directory (with either the +.BR O_RDONLY +or the +.BR O_PATH +flag). +Alternatively, such a file descriptor can be obtained by applying +.BR dirfd (3) +to a directory stream created using +.BR opendir (3). +.PP +When these APIs are given a +.I dirfd +argument of +.BR AT_FDCWD +or the specified pathname is absolute, +then they handle their pathname argument in the same was as +the corresponding conventional APIs. +However, in this case, several of the APIs have a +.I flags +argument that provides access to functionality that is not available with +the corresponding conventional APIs. .\" .\" .SS O_DIRECT @@ -1813,8 +1863,8 @@ is ignored). .BR mknod (2), .BR mmap (2), .BR mount (2), -.BR openat2 (2), .BR open_by_handle_at (2), +.BR openat2 (2), .BR read (2), .BR socket (2), .BR stat (2), @@ -1828,7 +1878,7 @@ is ignored). .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 13060548f..03a0956bb 100644 --- a/man2/open_by_handle_at.2 +++ b/man2/open_by_handle_at.2 @@ -467,7 +467,7 @@ in order to produce the .IR mount_fd argument used by .BR open_by_handle_at (). -.SH EXAMPLE +.SH EXAMPLES The two programs below demonstrate the use of .BR name_to_handle_at () and @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/openat2.2 b/man2/openat2.2 index 05c614c42..415a4f70d 100644 --- a/man2/openat2.2 +++ b/man2/openat2.2 @@ -245,16 +245,6 @@ However, unlike (which changes the filesystem root permanently for a process), .B RESOLVE_IN_ROOT allows a program to efficiently restrict path resolution on a per-open basis. -.\" FIXME The next piece is unclear (to me). What kind of ".." escape -.\" attempts does chroot() not detect that RESOLVE_IN_ROOT does? -The -.B RESOLVE_IN_ROOT -flag also has several hardening features -(such as detecting escape attempts during -.I ".." -resolution) which -.BR chroot (2) -does not. .IP Currently, this flag also disables magic-link resolution. However, this may change in the future. @@ -266,9 +256,52 @@ the caller should explicitly specify .\" commit 278121417a72d87fb29dd8c48801f80821e8f75a Disallow all magic-link resolution during path resolution. .IP +Magic links are symbolic link-like objects that are most notably found in +.BR proc (5); +examples include +.IR /proc/[pid]/exe +and +.IR /proc/[pid]/fd/* . +(See +.BR symlink (7) +for more details.) +.IP +Unknowingly opening magic links can be risky for some applications. +Examples of such risks include the following: +.RS +.IP \(bu 2 +If the process opening a pathname is a controlling process that +currently has no controlling terminal (see +.BR credentials (7)), +then opening a magic link inside +.IR /proc/[pid]/fd +that happens to refer to a terminal +would cause the process to acquire a controlling terminal. +.IP \(bu +.\" From https://lwn.net/Articles/796868/: +.\" The presence of this flag will prevent a path lookup operation +.\" from traversing through one of these magic links, thus blocking +.\" (for example) attempts to escape from a container via a /proc +.\" entry for an open file descriptor. +In a containerized environment, +a magic link inside +.I /proc +may refer to an object outside the container, +and thus may provide a means to escape from the container. +.RE +.IP +Because of such risks, +an application may prefer to disable magic link resolution using the +.BR RESOLVE_NO_MAGICLINKS +flag. +.IP If the trailing component (i.e., basename) of .I pathname -is a magic link, and +is a magic link, +.I how.resolve +contains +.BR RESOLVE_NO_MAGICLINKS , +and .I how.flags contains both .BR O_PATH @@ -277,26 +310,6 @@ and then an .B O_PATH file descriptor referencing the magic link will be returned. -.IP -Magic links are symbolic link-like objects that are most notably found in -.BR proc (5) -(examples include -.IR /proc/[pid]/exe -and -.IR /proc/[pid]/fd/* ). -Due to the potential danger of unknowingly opening these magic links, -it may be -preferable for users to disable their resolution entirely. -.\" FIXME: what specific details in symlink(7) are being referred -.\" by the following sentence? It's not clear. -.\" From https://lwn.net/Articles/796868/: -.\" The presence of this flag will prevent a path lookup operation -.\" from traversing through one of these magic links, thus blocking -.\" (for example) attempts to escape from a container via a /proc -.\" entry for an open file descriptor. -(See -.BR symlink (7) -for more details.) .TP .B RESOLVE_NO_SYMLINKS .\" commit 278121417a72d87fb29dd8c48801f80821e8f75a @@ -306,7 +319,11 @@ This option implies .IP If the trailing component (i.e., basename) of .I pathname -is a symbolic link, and +is a symbolic link, +.I how.resolve +contains +.BR RESOLVE_NO_SYMLINKS , +and .I how.flags contains both .BR O_PATH @@ -328,13 +345,19 @@ file creation flag (in which affects the handling of symbolic links only in the final component of .IR pathname . .IP -Applications that employ -this flag are encouraged to make its use configurable (unless it is -used for a specific security purpose), as symbolic links are very widely used -by end-users. -Setting this flag indiscriminately for all uses of +Applications that employ the +.BR RESOLVE_NO_SYMLINKS +flag are encouraged to make its use configurable +(unless it is used for a specific security purpose), +as symbolic links are very widely used by end-users. +Setting this flag indiscriminately\(emi.e., +for purposes not specifically related to security\(emfor all uses of .BR openat2 () may result in spurious errors on previously-functional systems. +This may occur if, for example, +a system pathname that is used by an application is modified +(e.g., in a new distribution release) +so that a pathname component (now) contains a symbolic link. .TP .B RESOLVE_NO_XDEV .\" commit 72ba29297e1439efaa54d9125b866ae9d15df339 @@ -559,7 +582,7 @@ which doesn't produce an error of .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/outb.2 b/man2/outb.2 index d6a2c99a7..5f98ab65f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pause.2 b/man2/pause.2 index 9a1cd8b1b..ce187865f 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.06 of the Linux +This page is part of release 5.07 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 9703c9783..15d9ffd59 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.06 of the Linux +This page is part of release 5.07 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 f9ef3055c..f28391850 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 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH PERF_EVENT_OPEN 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME perf_event_open \- set up performance monitoring .SH SYNOPSIS @@ -3390,7 +3390,7 @@ Various generalized events have had wrong values. For example, retired branches measured the wrong thing on AMD machines until Linux 2.6.35. .\" commit f287d332ce835f77a4f5077d2c0ef1e3f9ea42d2 -.SH EXAMPLE +.SH EXAMPLES The following is a short example that measures the total instruction count of a call to .BR printf (3). @@ -3460,7 +3460,7 @@ main(int argc, char **argv) .IR Documentation/admin-guide/perf-security.rst in the kernel source tree .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2 index 816b53530..30c6bcd57 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/personality.2 b/man2/personality.2 index 065931d13..2070e6a2e 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -64,7 +64,7 @@ The execution domain is a 32-bit value in which the top three bytes are set aside for flags that cause the kernel to modify the behavior of certain system calls so as to emulate historical or architectural quirks. -The least significant byte is value defining the personality +The least significant byte is a value defining the personality the kernel should assume. The flag values are as follows: .TP @@ -270,7 +270,7 @@ be portable. .SH SEE ALSO .BR setarch (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pidfd_getfd.2 b/man2/pidfd_getfd.2 index d67f028f1..fa851600d 100644 --- a/man2/pidfd_getfd.2 +++ b/man2/pidfd_getfd.2 @@ -82,7 +82,7 @@ is not a valid PID file descriptor. .I targetfd is not an open file descriptor in the process referred to by .IR pidfd . -.BR +.BR .TP .B EINVAL .I flags @@ -156,7 +156,7 @@ ptrace access mode check. .BR kcmp (2), .BR pidfd_open (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pidfd_open.2 b/man2/pidfd_open.2 index 84fc598a6..c4fe787d9 100644 --- a/man2/pidfd_open.2 +++ b/man2/pidfd_open.2 @@ -193,7 +193,7 @@ furthermore, the file descriptor obtained in this way is .I not pollable and can't be waited on with .BR waitid (2). -.SH EXAMPLE +.SH EXAMPLES The program below opens a PID file descriptor for the process whose PID is specified as its command-line argument. It then uses @@ -265,7 +265,7 @@ main(int argc, char *argv[]) .BR waitid (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pidfd_send_signal.2 b/man2/pidfd_send_signal.2 index 6999fb5e3..29e8271f6 100644 --- a/man2/pidfd_send_signal.2 +++ b/man2/pidfd_send_signal.2 @@ -22,7 +22,7 @@ .\" 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" +.TH PIDFD_SEND_SIGNAL 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pidfd_send_signal \- send a signal to a process specified by a file descriptor .SH SYNOPSIS @@ -176,7 +176,7 @@ if that process terminates, .BR pidfd_send_signal () fails with the error .BR ESRCH . -.SH EXAMPLE +.SH EXAMPLES .nf #define _GNU_SOURCE #include <limits.h> @@ -254,7 +254,7 @@ main(int argc, char *argv[]) .BR pid_namespaces (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pipe.2 b/man2/pipe.2 index 5ddaec81e..d5c56495e 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -33,7 +33,7 @@ .\" to EXAMPLE text. .\" 2008-10-10, mtk: add description of pipe2() .\" -.TH PIPE 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PIPE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pipe, pipe2 \- create pipe .SH SYNOPSIS @@ -159,7 +159,7 @@ On Linux (and other systems), does not modify .I pipefd on failure. -A requirement standardizing this behavior was added in POSIX.1-2016. +A requirement standardizing this behavior was added in POSIX.1-2008 TC2. .\" http://austingroupbugs.net/view.php?id=467 The Linux-specific .BR pipe2 () @@ -193,10 +193,16 @@ has been reached and the caller is not privileged; see was added to Linux in version 2.6.27; glibc support is available starting with version 2.9. +.SH CONFORMING TO +.BR pipe (): +POSIX.1-2001, POSIX.1-2008. +.PP +.BR pipe2 () +is Linux-specific. .SH NOTES .\" See http://math-atlas.sourceforge.net/devel/assembly/64.psabi.1.33.ps.Z .\" for example, section 3.2.1 "Registers and the Stack Frame". -The SystemV ABI on some architectures allows the use of more than one register +The System V ABI on some architectures allows the use of more than one register for returning multiple values; several architectures (namely, Alpha, IA-64, MIPS, SuperH, and SPARC/SPARC64) (ab)use this feature in order to implement the @@ -210,13 +216,7 @@ wrapper function transparently deals with this. See .BR syscall (2) for information regarding registers used for storing second file descriptor. -.SH CONFORMING TO -.BR pipe (): -POSIX.1-2001, POSIX.1-2008. -.PP -.BR pipe2 () -is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES .\" fork.2 refers to this example program. The following program creates a pipe, and then .BR fork (2)s @@ -294,7 +294,7 @@ main(int argc, char *argv[]) .BR popen (3), .BR pipe (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 f457c9326..ce154a6f7 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PIVOT_ROOT 2 2019-11-19 "Linux" "Linux Programmer's Manual" +.TH PIVOT_ROOT 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pivot_root \- change the root mount .SH SYNOPSIS @@ -271,7 +271,7 @@ 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 +.SH EXAMPLES .\" FIXME .\" Would it be better, because simpler, to use unshare(2) .\" rather than clone(2) in the example below? @@ -420,7 +420,7 @@ main(int argc, char *argv[]) .BR pivot_root (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 9ccd23b47..fbf5d9566 100644 --- a/man2/pkey_alloc.2 +++ b/man2/pkey_alloc.2 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and author of this work. .\" %%%LICENSE_END .\" -.TH PKEY_ALLOC 2 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH PKEY_ALLOC 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pkey_alloc, pkey_free \- allocate or free a protection key .SH SYNOPSIS @@ -131,14 +131,14 @@ or after it is freed via .BR pkey_free ()), the kernel may make arbitrary changes to the parts of the rights register affecting access to that key. -.SH EXAMPLE +.SH EXAMPLES See .BR pkeys (7). .SH SEE ALSO .BR pkey_mprotect (2), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/poll.2 b/man2/poll.2 index 77567fae5..515ffe43b 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -52,7 +52,7 @@ to perform I/O. The Linux-specific .BR epoll (7) API performs a similar task, but offers features beyond those found in -.BR poll (2). +.BR poll (). .PP The set of file descriptors to be monitored is specified in the .I fds @@ -403,6 +403,9 @@ library call was added in glibc 2.4. conforms to POSIX.1-2001 and POSIX.1-2008. .BR ppoll () is Linux-specific. +.\" FIXME . +.\" ppoll() is proposed for inclusion in POSIX: +.\" https://www.austingroupbugs.net/view.php?id=1263 .\" NetBSD 3.0 has a pollts() which is like Linux ppoll(). .SH NOTES The operation of @@ -474,7 +477,7 @@ notion of the sigset. See the discussion of spurious readiness notifications under the BUGS section of .BR select (2). -.SH EXAMPLE +.SH EXAMPLES The program below opens each of the files named in its command-line arguments and monitors the resulting file descriptors for readiness to read .RB ( POLLIN ). @@ -567,8 +570,10 @@ at which point the file descriptor was closed and the program terminated. .SS Program source \& .nf -/* poll_input.c */ +/* poll_input.c + Licensed under GNU General Public License v2 or later. +*/ #include <poll.h> #include <fcntl.h> #include <sys/types.h> @@ -658,7 +663,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 4e8a07a5c..47f726782 100644 --- a/man2/posix_fadvise.2 +++ b/man2/posix_fadvise.2 @@ -167,7 +167,7 @@ argument was changed from .I size_t to .I off_t -in POSIX.1-2003 TC1. +in POSIX.1-2001 TC1. .SH NOTES Under Linux, \fBPOSIX_FADV_NORMAL\fP sets the readahead window to the default size for the backing device; \fBPOSIX_FADV_SEQUENTIAL\fP doubles @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/prctl.2 b/man2/prctl.2 index 3f16109a7..c98e13acf 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -53,7 +53,7 @@ .\" .TH PRCTL 2 2020-04-11 "Linux" "Linux Programmer's Manual" .SH NAME -prctl \- operations on a process +prctl \- operations on a process or thread .SH SYNOPSIS .nf .B #include <sys/prctl.h> @@ -63,11 +63,21 @@ prctl \- operations on a process .fi .SH DESCRIPTION .BR prctl () +manipulates various aspects of the behavior +of the calling thread or process. +.PP +Note that careless use of some +.BR prctl () +operations can confuse the user-space run-time environment, +so these operations should be used with care. +.PP +.BR prctl () is called with a first argument describing what to do (with values defined in \fI<linux/prctl.h>\fP), and further arguments with a significance depending on the first one. The first argument can be: .\" +.\" prctl PR_CAP_AMBIENT .TP .BR PR_CAP_AMBIENT " (since Linux 4.3)" .\" commit 58319057b7847667f0c9585b9de0e8932b0fdb08 @@ -121,6 +131,7 @@ library in the form of .BR cap_set_ambient (3), and .BR cap_reset_ambient (3). +.\" prctl PR_CAPBSET_READ .TP .BR PR_CAPBSET_READ " (since Linux 2.6.25)" Return (as the function result) 1 if the capability specified in @@ -143,6 +154,7 @@ A higher-level interface layered on top of this operation is provided in the .BR libcap (3) library in the form of .BR cap_get_bound (3). +.\" prctl PR_CAPBSET_DROP .TP .BR PR_CAPBSET_DROP " (since Linux 2.6.25)" If the calling thread has the @@ -169,6 +181,7 @@ A higher-level interface layered on top of this operation is provided in the .BR libcap (3) library in the form of .BR cap_drop_bound (3). +.\" prctl PR_SET_CHILD_SUBREAPER .TP .BR PR_SET_CHILD_SUBREAPER " (since Linux 3.4)" .\" commit ebec18a6d3aa1e7d84aab16225e87fd25170ec2b @@ -188,7 +201,7 @@ When a process becomes orphaned then that process will be reparented to the nearest still living ancestor subreaper. Subsequently, calls to -.BR getppid () +.BR getppid (2) in the orphaned process will now return the PID of the subreaper process, and when the orphan terminates, it is the subreaper process that will receive a @@ -215,14 +228,16 @@ Some frameworks (e.g., .BR systemd (1)) employ a subreaper process for similar reasons. +.\" prctl PR_GET_CHILD_SUBREAPER .TP .BR PR_GET_CHILD_SUBREAPER " (since Linux 3.4)" Return the "child subreaper" setting of the caller, in the location pointed to by .IR "(int\ *) arg2" . +.\" prctl PR_SET_DUMPABLE .TP .BR PR_SET_DUMPABLE " (since Linux 2.3.20)" -Set the state of the "dumpable" flag, +Set the state of the "dumpable" attribute, which determines whether core dumps are produced for the calling process upon delivery of a signal whose default behavior is to produce a core dump. .IP @@ -248,7 +263,7 @@ for security reasons, this feature has been removed. in .BR proc (5).) .IP -Normally, this flag is set to 1. +Normally, the "dumpable" attribute is set to 1. However, it is reset to the current value contained in the file .IR /proc/sys/fs/\:suid_dumpable (which by default has the value 0), @@ -288,13 +303,15 @@ the ownership of files in the process's .IR /proc/[pid] directory is affected as described in .BR proc (5). +.\" prctl PR_GET_DUMPABLE .TP .BR PR_GET_DUMPABLE " (since Linux 2.3.20)" Return (as the function result) the current state of the calling -process's dumpable flag. +process's dumpable attribute. .\" Since Linux 2.6.13, the dumpable flag can have the value 2, .\" but in 2.6.13 PR_GET_DUMPABLE simply returns 1 if the dumpable .\" flags has a nonzero value. This was fixed in 2.6.14. +.\" prctl PR_SET_ENDIAN .TP .BR PR_SET_ENDIAN " (since Linux 2.6.18, PowerPC only)" Set the endian-ness of the calling process to the value given @@ -305,11 +322,13 @@ in \fIarg2\fP, which should be one of the following: or .B PR_ENDIAN_PPC_LITTLE (PowerPC pseudo little endian). +.\" prctl PR_GET_ENDIAN .TP .BR PR_GET_ENDIAN " (since Linux 2.6.18, PowerPC only)" Return the endian-ness of the calling process, in the location pointed to by .IR "(int\ *) arg2" . +.\" prctl PR_SET_FP_MODE .TP .BR PR_SET_FP_MODE " (since Linux 4.0, only on MIPS)" .\" commit 9791554b45a2acc28247f66a5fd5bbc212a6b8c8 @@ -416,6 +435,7 @@ The arguments and .IR arg5 are ignored. +.\" prctl PR_GET_FP_MODE .TP .BR PR_GET_FP_MODE " (since Linux 4.0, only on MIPS)" Return (as the function result) @@ -433,6 +453,7 @@ The arguments and .IR arg5 are ignored. +.\" prctl PR_SET_FPEMU .TP .BR PR_SET_FPEMU " (since Linux 2.4.18, 2.5.9, only on ia64)" Set floating-point emulation control bits to \fIarg2\fP. @@ -443,11 +464,13 @@ to silently emulate floating-point operation accesses, or to not emulate floating-point operations and send .B SIGFPE instead. +.\" prctl PR_GET_FPEMU .TP .BR PR_GET_FPEMU " (since Linux 2.4.18, 2.5.9, only on ia64)" Return floating-point emulation control bits, in the location pointed to by .IR "(int\ *) arg2" . +.\" prctl PR_SET_FPEXC .TP .BR PR_SET_FPEXC " (since Linux 2.4.21, 2.5.32, only on PowerPC)" Set floating-point exception mode to \fIarg2\fP. @@ -461,11 +484,59 @@ Pass \fBPR_FP_EXC_SW_ENABLE\fP to use FPEXC for FP exception enables, \fBPR_FP_EXC_NONRECOV\fP for async nonrecoverable exception mode, \fBPR_FP_EXC_ASYNC\fP for async recoverable exception mode, \fBPR_FP_EXC_PRECISE\fP for precise exception mode. +.\" prctl PR_GET_FPEXC .TP .BR PR_GET_FPEXC " (since Linux 2.4.21, 2.5.32, only on PowerPC)" Return floating-point exception mode, in the location pointed to by .IR "(int\ *) arg2" . +.\" prctl PR_SET_IO_FLUSHER +.TP +.BR PR_SET_IO_FLUSHER " (since Linux 5.6)" +If a user process is involved in the block layer or filesystem I/O path, +and can allocate memory while processing I/O requests it must set +\fIarg2\fP to 1. +This will put the process in the IO_FLUSHER state, +which allows it special treatment to make progress when allocating memory. +If \fIarg2\fP is 0, the process will clear the IO_FLUSHER state, and +the default behavior will be used. +.IP +The calling process must have the +.BR CAP_SYS_RESOURCE +capability. +.IP +.IR arg3 , +.IR arg4 , +and +.IR arg5 +must be zero. +.IP +The IO_FLUSHER state is inherited by a child process created via +.BR fork (2) +and is preserved across +.BR execve (2). +.IP +Examples of IO_FLUSHER applications are FUSE daemons, SCSI device +emulation daemons, and daemons that perform error handling like multipath +path recovery applications. +.\" prctl PR_GET_IO_FLUSHER +.TP +.B PR_GET_IO_FLUSHER (Since Linux 5.6) +Return (as the function result) the IO_FLUSHER state of the caller. +A value of 1 indicates that the caller is in the IO_FLUSHER state; +0 indicates that the caller is not in the IO_FLUSHER state. +.IP +The calling process must have the +.BR CAP_SYS_RESOURCE +capability. +.IP +.IR arg2 , +.IR arg3 , +.IR arg4 , +and +.IR arg5 +must be zero. +.\" prctl PR_SET_KEEPCAPS .TP .BR PR_SET_KEEPCAPS " (since Linux 2.2.18)" Set the state of the calling thread's "keep capabilities" flag. @@ -476,6 +547,7 @@ must be either 0 (clear the flag) or 1 (set the flag). The "keep capabilities" value will be reset to 0 on subsequent calls to .BR execve (2). +.\" prctl PR_GET_KEEPCAPS .TP .BR PR_GET_KEEPCAPS " (since Linux 2.2.18)" Return (as the function result) the current state of the calling thread's @@ -483,6 +555,7 @@ Return (as the function result) the current state of the calling thread's See .BR capabilities (7) for a description of this flag. +.\" prctl PR_MCE_KILL .TP .BR PR_MCE_KILL " (since Linux 2.6.32)" Set the machine check memory corruption kill policy for the calling thread. @@ -523,6 +596,7 @@ The policy is inherited by children. The remaining unused .BR prctl () arguments must be zero for future compatibility. +.\" prctl PR_MCE_KILL_GET .TP .BR PR_MCE_KILL_GET " (since Linux 2.6.32)" Return (as the function result) @@ -530,6 +604,7 @@ the current per-process machine check kill policy. All unused .BR prctl () arguments must be zero. +.\" prctl PR_SET_MM .TP .BR PR_SET_MM " (since Linux 3.3)" .\" commit 028ee4be34a09a6d48bdf30ab991ae933a7bc036 @@ -707,8 +782,9 @@ This feature is available only if the kernel is built with the .BR CONFIG_CHECKPOINT_RESTORE option enabled. .RE +.\" prctl PR_MPX_ENABLE_MANAGEMENT .TP -.BR PR_MPX_ENABLE_MANAGEMENT ", " PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19) " +.BR PR_MPX_ENABLE_MANAGEMENT ", " PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19, removed in Linux 5.4; only on x86) " .\" commit fe3d197f84319d3bce379a9c0dc17b1f48ad358c .\" See also http://lwn.net/Articles/582712/ .\" See also https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler @@ -757,12 +833,13 @@ These calls fail if the CPU or kernel does not support MPX. Kernel support for MPX is enabled via the .BR CONFIG_X86_INTEL_MPX configuration option. -You can check whether the CPU supports MPX by looking for the 'mpx' +You can check whether the CPU supports MPX by looking for the +.I mpx CPUID bit, like with the following command: .IP .in +4n .EX -cat /proc/cpuinfo | grep ' mpx ' +cat /proc/cpuinfo | grep \(aq mpx \(aq .EE .in .IP @@ -782,6 +859,13 @@ had been called. .IP For further information on Intel MPX, see the kernel source file .IR Documentation/x86/intel_mpx.txt . +.IP +.\" commit f240652b6032b48ad7fa35c5e701cc4c8d697c0b +.\" See also https://lkml.kernel.org/r/20190705175321.DB42F0AD@viggo.jf.intel.com +Due to a lack of toolchain support, +.BR PR_MPX_ENABLE_MANAGEMENT " and " PR_MPX_DISABLE_MANAGEMENT +are not supported in Linux 5.4 and later. +.\" prctl PR_SET_NAME .TP .BR PR_SET_NAME " (since Linux 2.6.9)" Set the name of the calling thread, @@ -797,10 +881,14 @@ This is the same attribute that can be set via and retrieved using .BR pthread_getname_np (3). The attribute is likewise accessible via -.IR /proc/self/task/[tid]/comm , +.IR /proc/self/task/[tid]/comm +(see +.BR proc (5)), where -.I tid -is the name of the calling thread. +.I [tid] +is the thread ID of the calling thread, as returned by +.BR gettid (2). +.\" prctl PR_GET_NAME .TP .BR PR_GET_NAME " (since Linux 2.6.11)" Return the name of the calling thread, @@ -808,6 +896,7 @@ in the buffer pointed to by .IR "(char\ *) arg2" . The buffer should allow space for up to 16 bytes; the returned string will be null-terminated. +.\" prctl PR_SET_NO_NEW_PRIVS .TP .BR PR_SET_NO_NEW_PRIVS " (since Linux 3.5)" Set the calling thread's @@ -824,7 +913,7 @@ that could not have been done without the call (for example, rendering the set-user-ID and set-group-ID mode bits, and file capabilities non-functional). -Once set, this the +Once set, the .I no_new_privs attribute cannot be unset. The setting of this attribute is inherited by children created by @@ -851,6 +940,7 @@ For more information, see the kernel source file before Linux 4.13). See also .BR seccomp (2). +.\" prctl PR_GET_NO_NEW_PRIVS .TP .BR PR_GET_NO_NEW_PRIVS " (since Linux 3.5)" Return (as the function result) the value of the @@ -862,11 +952,85 @@ behavior. A value of 1 indicates .BR execve (2) will operate in the privilege-restricting mode described above. +.\" prctl PR_PAC_RESET_KEYS +.\" commit ba830885656414101b2f8ca88786524d4bb5e8c1 +.TP +.BR PR_PAC_RESET_KEYS " (since Linux 5.0, only on arm64)" +Securely reset the thread's pointer authentication keys +to fresh random values generated by the kernel. +.IP +The set of keys to be reset is specified by +.IR arg2 , +which must be a logical OR of zero or more of the following: +.RS +.TP +.B PR_PAC_APIAKEY +instruction authentication key A +.TP +.B PR_PAC_APIBKEY +instruction authentication key B +.TP +.B PR_PAC_APDAKEY +data authentication key A +.TP +.B PR_PAC_APDBKEY +data authentication key B +.TP +.B PR_PAC_APGAKEY +generic authentication \(lqA\(rq key. +.IP +(Yes folks, there really is no generic B key.) +.RE +.IP +As a special case, if +.I arg2 +is zero, then all the keys are reset. +Since new keys could be added in future, +this is the recommended way to completely wipe the existing keys +when establishing a clean execution context. +Note that there is no need to use +.BR PR_PAC_RESET_KEYS +in preparation for calling +.BR execve (2), +since +.BR execve (2) +resets all the pointer authentication keys. +.IP +The remaining arguments +.IR arg3 ", " arg4 ", and " arg5 +must all be zero. +.IP +If the arguments are invalid, +and in particular if +.I arg2 +contains set bits that are unrecognized +or that correspond to a key not available on this platform, +then the call fails with error +.BR EINVAL . +.IP +.B Warning: +Because the compiler or run-time environment +may be using some or all of the keys, +a successful +may crash the calling process. +The conditions for using it safely are complex and system-dependent. +Don't use it unless you know what you are doing. +.IP +For more information, see the kernel source file +.I Documentation/arm64/pointer\-authentication.rst +.\"commit b693d0b372afb39432e1c49ad7b3454855bc6bed +(or +.I Documentation/arm64/pointer\-authentication.txt +before Linux 5.3). +.B PR_PAC_RESET_KEYS +.\" prctl PR_SET_PDEATHSIG .TP .BR PR_SET_PDEATHSIG " (since Linux 2.1.57)" Set the parent-death signal of the calling process to \fIarg2\fP (either a signal value -in the range 1..maxsig, or 0 to clear). +in the range 1..\c +.BR NSIG "\-1" , +or 0 to clear). This is the signal that the calling process will get when its parent dies. .IP @@ -911,11 +1075,13 @@ or a binary that has associated capabilities (see .BR capabilities (7)); otherwise, this value is preserved across .BR execve (2). +.\" prctl PR_GET_PDEATHSIG .TP .BR PR_GET_PDEATHSIG " (since Linux 2.3.15)" Return the current value of the parent process death signal, in the location pointed to by .IR "(int\ *) arg2" . +.\" prctl PR_SET_PTRACER .TP .BR PR_SET_PTRACER " (since Linux 3.4)" .\" commit 2d514487faf188938a4ee4fb3464eeecfbdcf8eb @@ -948,6 +1114,7 @@ For further information, see the kernel source file (or .IR Documentation/security/Yama.txt before Linux 4.13). +.\" prctl PR_SET_SECCOMP .TP .BR PR_SET_SECCOMP " (since Linux 2.6.23)" .\" See http://thread.gmane.org/gmane.linux.kernel/542632 @@ -1024,6 +1191,7 @@ For further information, see the kernel source file (or .IR Documentation/prctl/seccomp_filter.txt before Linux 4.13). +.\" prctl PR_GET_SECCOMP .TP .BR PR_GET_SECCOMP " (since Linux 2.6.23)" Return (as the function result) @@ -1050,18 +1218,21 @@ field of the file provides a method of obtaining the same information, without the risk that the process is killed; see .BR proc (5). +.\" prctl PR_SET_SECUREBITS .TP .BR PR_SET_SECUREBITS " (since Linux 2.6.26)" Set the "securebits" flags of the calling thread to the value supplied in .IR arg2 . See .BR capabilities (7). +.\" prctl PR_GET_SECUREBITS .TP .BR PR_GET_SECUREBITS " (since Linux 2.6.26)" Return (as the function result) the "securebits" flags of the calling thread. See .BR capabilities (7). +.\" prctl PR_GET_SPECULATION_CTRL .TP .BR PR_GET_SPECULATION_CTRL " (since Linux 4.17)" Return (as the function result) @@ -1077,18 +1248,24 @@ The return value uses bits 0-3 with the following meaning: .TP .BR PR_SPEC_PRCTL Mitigation can be controlled per thread by -.B PR_SET_SPECULATION_CTRL +.BR PR_SET_SPECULATION_CTRL . .TP .BR PR_SPEC_ENABLE The speculation feature is enabled, mitigation is disabled. .TP .BR PR_SPEC_DISABLE -The speculation feature is disabled, mitigation is enabled +The speculation feature is disabled, mitigation is enabled. .TP .BR PR_SPEC_FORCE_DISABLE Same as .B PR_SPEC_DISABLE but cannot be undone. +.TP +.BR PR_SPEC_DISABLE_NOEXEC " (since Linux 5.1)" +Same as +.BR PR_SPEC_DISABLE , +but the state will be cleared on +.BR execve (2). .RE .IP If all bits are 0, @@ -1108,17 +1285,34 @@ and .I arg5 arguments must be specified as 0; otherwise the call fails with the error .BR EINVAL . +.\" prctl PR_SET_SPECULATION_CTRL .TP .BR PR_SET_SPECULATION_CTRL " (since Linux 4.17)" .\" commit b617cfc858161140d69cc0b5cc211996b557a1c7 .\" commit 356e4bfff2c5489e016fdb925adbf12a1e3950ee Sets the state of the speculation misfeature specified in .IR arg2 . -Currently, the only permitted value for this argument is +The speculation-misfeature settings are per-thread attributes. +.IP +Currently, +.I arg2 +must be one of: +.RS +.TP .B PR_SPEC_STORE_BYPASS -(otherwise the call fails with the error -.BR ENODEV ). -This setting is a per-thread attribute. +Set the state of the speculative store bypass misfeature. +.\" commit 9137bb27e60e554dab694eafa4cca241fa3a694f +.TP +.BR PR_SPEC_INDIRECT_BRANCH " (since Linux 4.20)" +Set the state of the indirect branch speculation misfeature. +.RE +.IP +If +.I arg2 +does not have one of the above values, +then the call fails with the error +.BR ENODEV . +.IP The .IR arg3 argument is used to hand in the control value, @@ -1129,20 +1323,34 @@ which is one of the following: The speculation feature is enabled, mitigation is disabled. .TP .BR PR_SPEC_DISABLE -The speculation feature is disabled, mitigation is enabled +The speculation feature is disabled, mitigation is enabled. .TP .BR PR_SPEC_FORCE_DISABLE Same as -.B PR_SPEC_DISABLE +.BR PR_SPEC_DISABLE , but cannot be undone. A subsequent -.B -prctl(..., PR_SPEC_ENABLE) +.BR prctl (\c +.IR arg2 , +.BR PR_SPEC_ENABLE ) +with the same value for +.I arg2 will fail with the error .BR EPERM . +.\" commit 71368af9027f18fe5d1c6f372cfdff7e4bde8b48 +.TP +.BR PR_SPEC_DISABLE_NOEXEC " (since Linux 5.1)" +Same as +.BR PR_SPEC_DISABLE , +but the state will be cleared on +.BR execve (2). +Currently only supported for +.I arg2 +equal to +.B PR_SPEC_STORE_BYPASS. .RE .IP -Any other value in +Any unsupported value in .IR arg3 will result in the call failing with the error .BR ERANGE . @@ -1162,24 +1370,9 @@ This parameter may enforce a read-only policy which will result in the call failing with the error .BR ENXIO . For further details, see the kernel source file -.IR Documentation/admin-guide/kernel-parameters.txt . -.TP -.BR PR_SET_THP_DISABLE " (since Linux 3.15)" -.\" commit a0715cc22601e8830ace98366c0c2bd8da52af52 -Set the state of the "THP disable" flag for the calling thread. -If -.I arg2 -has a nonzero value, the flag is set, otherwise it is cleared. -Setting this flag provides a method -for disabling transparent huge pages -for jobs where the code cannot be modified, and using a malloc hook with -.BR madvise (2) -is not an option (i.e., statically allocated data). -The setting of the "THP disable" flag is inherited by a child created via -.BR fork (2) -and is preserved across -.BR execve (2). +.IR Documentation/admin\-guide/kernel\-parameters.txt . .\" +.\" prctl PR_TASK_PERF_EVENTS_DISABLE .TP .BR PR_TASK_PERF_EVENTS_DISABLE " (since Linux 2.6.31)" Disable all performance counters attached to the calling process, @@ -1196,6 +1389,7 @@ Originally called renamed (retaining the same numerical value) in Linux 2.6.32. .\" +.\" prctl PR_TASK_PERF_EVENTS_ENABLE .TP .BR PR_TASK_PERF_EVENTS_ENABLE " (since Linux 2.6.31)" The converse of @@ -1209,11 +1403,30 @@ renamed .\" commit cdd6c482c9ff9c55475ee7392ec8f672eddb7be6 in Linux 2.6.32. .\" +.\" prctl PR_SET_THP_DISABLE +.TP +.BR PR_SET_THP_DISABLE " (since Linux 3.15)" +.\" commit a0715cc22601e8830ace98366c0c2bd8da52af52 +Set the state of the "THP disable" flag for the calling thread. +If +.I arg2 +has a nonzero value, the flag is set, otherwise it is cleared. +Setting this flag provides a method +for disabling transparent huge pages +for jobs where the code cannot be modified, and using a malloc hook with +.BR madvise (2) +is not an option (i.e., statically allocated data). +The setting of the "THP disable" flag is inherited by a child created via +.BR fork (2) +and is preserved across +.BR execve (2). +.\" prctl PR_GET_THP_DISABLE .TP .BR PR_GET_THP_DISABLE " (since Linux 3.15)" 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. +.\" prctl PR_GET_TID_ADDRESS .TP .BR PR_GET_TID_ADDRESS " (since Linux 3.5)" .\" commit 300f786b2683f8bb1ec0afb6e1851183a479c86d @@ -1235,6 +1448,7 @@ system call does not have a compat implementation for the AMD64 x32 and MIPS n32 ABIs, and the kernel writes out a pointer using the kernel's pointer size, this operation expects a user-space buffer of 8 (not 4) bytes on these ABIs. +.\" prctl PR_SET_TIMERSLACK .TP .BR PR_SET_TIMERSLACK " (since Linux 2.6.28)" .\" See https://lwn.net/Articles/369549/ @@ -1305,10 +1519,12 @@ can be examined and changed via the file .IR /proc/[pid]/timerslack_ns . See .BR proc (5). +.\" prctl PR_GET_TIMERSLACK .TP .BR PR_GET_TIMERSLACK " (since Linux 2.6.28)" Return (as the function result) the "current" timer slack value of the calling thread. +.\" prctl PR_SET_TIMING .TP .BR PR_SET_TIMING " (since Linux 2.6.0)" .\" Precisely: Linux 2.6.0-test4 @@ -1327,11 +1543,13 @@ is not currently implemented .\" PR_TIMING_TIMESTAMP doesn't do anything in 2.6.26-rc8, .\" and looking at the patch history, it appears .\" that it never did anything. +.\" prctl PR_GET_TIMING .TP .BR PR_GET_TIMING " (since Linux 2.6.0)" .\" Precisely: Linux 2.6.0-test4 Return (as the function result) which process timing method is currently in use. +.\" prctl PR_SET_TSC .TP .BR PR_SET_TSC " (since Linux 2.6.26, x86 only)" Set the state of the flag determining whether the timestamp counter @@ -1345,12 +1563,14 @@ to allow it to be read, or to generate a .B SIGSEGV when the process tries to read the timestamp counter. +.\" prctl PR_GET_TSC .TP .BR PR_GET_TSC " (since Linux 2.6.26, x86 only)" Return the state of the flag determining whether the timestamp counter can be read, in the location pointed to by .IR "(int\ *) arg2" . +.\" prctl PR_SET_UNALIGN .TP .B PR_SET_UNALIGN (Only on: ia64, since Linux 2.3.48; parisc, since Linux 2.6.15; @@ -1374,6 +1594,7 @@ flag in operation of the .BR setsysinfo () system call on Tru64). +.\" prctl PR_GET_UNALIGN .TP .B PR_GET_UNALIGN (See @@ -1381,65 +1602,21 @@ system call on Tru64). for information on versions and architectures.) Return unaligned access control bits, in the location pointed to by .IR "(unsigned int\ *) arg2" . -.TP -.BR PR_SET_IO_FLUSHER " (since Linux 5.6)" -If a user process is involved in the block layer or filesystem I/O path, -and can allocate memory while processing I/O requests it must set -\fIarg2\fP to 1. -This will put the process in the IO_FLUSHER state, -which allows it special treatment to make progress when allocating memory. -If \fIarg2\fP is 0, the process will clear the IO_FLUSHER state, and -the default behavior will be used. -.IP -The calling process must have the -.BR CAP_SYS_RESOURCE -capability. -.IP -.IR arg3 , -.IR arg4 , -and -.IR arg5 -must be zero. -.IP -The IO_FLUSHER state is inherited by a child process created via -.BR fork (2) -and is preserved across -.BR execve (2). -.IP -Examples of IO_FLUSHER applications are FUSE daemons, SCSI device -emulation daemons, and daemons that perform error handling like multipath -path recovery applications. -.TP -.B PR_GET_IO_FLUSHER (Since Linux 5.6) -Return (as the function result) the IO_FLUSHER state of the caller. -A value of 1 indicates that the caller is in the IO_FLUSHER state; -0 indicates that the caller is not in the IO_FLUSHER state. -.IP -The calling process must have the -.BR CAP_SYS_RESOURCE -capability. -.IP -.IR arg2 , -.IR arg3 , -.IR arg4 , -and -.IR arg5 -must be zero. .SH RETURN VALUE On success, +.BR PR_CAP_AMBIENT + PR_CAP_AMBIENT_IS_SET , +.BR PR_CAPBSET_READ , .BR PR_GET_DUMPABLE , .BR PR_GET_FP_MODE , +.BR PR_GET_IO_FLUSHER , .BR PR_GET_KEEPCAPS , +.BR PR_MCE_KILL_GET , .BR PR_GET_NO_NEW_PRIVS , +.BR PR_GET_SECUREBITS , +.BR PR_GET_SPECULATION_CTRL , .BR PR_GET_THP_DISABLE , -.BR PR_CAPBSET_READ , .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 , -.BR PR_GET_IO_FLUSHER , and (if it returns) .BR PR_GET_SECCOMP return the nonnegative values described above. @@ -1519,7 +1696,8 @@ is an invalid address. .B EINVAL The value of .I option -is not recognized. +is not recognized, +or not supported on this system. .TP .B EINVAL .I option @@ -1718,6 +1896,14 @@ or and unused arguments to .BR prctl () are not 0. +.B EINVAL +.I option +is +.B PR_PAC_RESET_KEYS +and the arguments are invalid or unsupported. +See the description of +.B PR_PAC_RESET_KEYS +above for details. .TP .B ENODEV .I option @@ -1818,11 +2004,12 @@ was .BR PR_SET_SPECULATION_CTRL and .IR arg3 -is neither +is not .BR PR_SPEC_ENABLE , .BR PR_SPEC_DISABLE , +.BR PR_SPEC_FORCE_DISABLE , nor -.BR PR_SPEC_FORCE_DISABLE . +.BR PR_SPEC_DISABLE_NOEXEC . .SH VERSIONS The .BR prctl () @@ -1850,7 +2037,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pread.2 b/man2/pread.2 index 1898d9b34..3327f1c60 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.06 of the Linux +This page is part of release 5.07 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 9a5516565..92810994e 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -26,7 +26,7 @@ .\" .\" Commit fcf634098c00dd9cd247447368495f0b79be12d1 .\" -.TH PROCESS_VM_READV 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PROCESS_VM_READV 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME process_vm_readv, process_vm_writev \- transfer data between process address spaces .SH SYNOPSIS @@ -299,7 +299,7 @@ when using, for example, shared memory or pipes). .\" Original user is MPI, http://www.mcs.anl.gov/research/projects/mpi/ .\" See also some benchmarks at http://lwn.net/Articles/405284/ .\" and http://marc.info/?l=linux-mm&m=130105930902915&w=2 -.SH EXAMPLE +.SH EXAMPLES The following code sample demonstrates the use of .BR process_vm_readv (). It reads 20 bytes at the address 0x10000 from the process with PID 10 @@ -339,7 +339,7 @@ main(void) .BR readv (2), .BR writev (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ptrace.2 b/man2/ptrace.2 index ffcd779b8..f3a7f5bd2 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 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH PTRACE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ptrace \- process trace .SH SYNOPSIS @@ -733,6 +733,26 @@ argument is treated as for .RI ( addr is ignored.) .TP +.BR PTRACE_SET_SYSCALL " (since Linux 2.6.16)" +.\" commit 3f471126ee53feb5e9b210ea2f525ed3bb9b7a7f +When in syscall-enter-stop, +change the number of the system call that is about to +be executed to the number specified in the +.I data +argument. +The +.I addr +argument is ignored. +This request is currently +.\" As of 4.19-rc2 +supported only on arm (and arm64, though only for backwards compatibility), +.\" commit 27aa55c5e5123fa8b8ad0156559d34d7edff58ca +but most other architectures have other means of accomplishing this +(usually by changing the register that the userland code passed the +system call number in). +.\" see change_syscall in tools/testing/selftests/seccomp/seccomp_bpf.c +.\" and also strace's linux/*/set_scno.c files. +.TP .BR PTRACE_SYSEMU ", " PTRACE_SYSEMU_SINGLESTEP " (since Linux 2.6.14)" For .BR PTRACE_SYSEMU , @@ -2901,7 +2921,7 @@ to zero. .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 17d8a5fa4..a65e04535 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/quotactl.2 b/man2/quotactl.2 index fae18ead6..f85e25dfc 100644 --- a/man2/quotactl.2 +++ b/man2/quotactl.2 @@ -822,7 +822,7 @@ prefix. .BR quotacheck (8), .BR quotaon (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/read.2 b/man2/read.2 index c7ff70ad5..e558a6977 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -266,7 +266,7 @@ This problem was fixed in Linux 3.14. .BR write (2), .BR fread (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readahead.2 b/man2/readahead.2 index 5e056d022..c93659314 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readdir.2 b/man2/readdir.2 index 53ca11725..25e61f8ea 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readlink.2 b/man2/readlink.2 index 2429c41d2..aff9f734c 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -41,7 +41,7 @@ .\" 2011-09-20, Guillem Jover <guillem@hadrons.org>: .\" Added text on dynamically allocating buffer + example program .\" -.TH READLINK 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH READLINK 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME readlink, readlinkat \- read value of a symbolic link .SH SYNOPSIS @@ -272,7 +272,7 @@ glibc constructs a pathname based on the symbolic link in that corresponds to the .IR dirfd argument. -.SH EXAMPLE +.SH EXAMPLES The following program allocates the buffer needed by .BR readlink () dynamically from the information provided by @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readv.2 b/man2/readv.2 index d8f13dfdd..5356c1d39 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -29,7 +29,7 @@ .\" add more details. .\" 2010-11-16, mtk, Added documentation of preadv() and pwritev() .\" -.TH READV 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH READV 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME readv, writev, preadv, pwritev, preadv2, pwritev2 \- read or write data into multiple buffers .SH SYNOPSIS @@ -408,7 +408,7 @@ that the system is running a Linux kernel older than version 2.6.18 And since glibc 2.20 (which requires a minimum Linux kernel version of 2.6.32), the glibc wrapper functions always just directly invoke the system calls. -.SH EXAMPLE +.SH EXAMPLES The following code sample demonstrates the use of .BR writev (): .PP @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/reboot.2 b/man2/reboot.2 index 8e50be3ab..20e3b04de 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recv.2 b/man2/recv.2 index 6e25a3acc..a2c5429c6 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -38,7 +38,7 @@ .\" Modified 1998,1999 by Andi Kleen .\" 2001-06-19 corrected SO_EE_OFFENDER, bug report by James Hawtin .\" -.TH RECV 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH RECV 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME recv, recvfrom, recvmsg \- receive a message from a socket .SH SYNOPSIS @@ -545,7 +545,7 @@ See .BR recvmmsg (2) for information about a Linux-specific system call that can be used to receive multiple datagrams in a single call. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR recvfrom () is shown in @@ -567,7 +567,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recvmmsg.2 b/man2/recvmmsg.2 index 7ddbc24d8..460641127 100644 --- a/man2/recvmmsg.2 +++ b/man2/recvmmsg.2 @@ -28,7 +28,7 @@ .\" Author: Arnaldo Carvalho de Melo <acme@redhat.com> .\" Date: Mon Oct 12 23:40:10 2009 -0700 .\" -.TH RECVMMSG 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH RECVMMSG 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME recvmmsg \- receive multiple messages on a socket .SH SYNOPSIS @@ -189,7 +189,7 @@ The error code is expected to be returned on a subsequent call to In the current implementation, however, the error code can be overwritten in the meantime by an unrelated network event on a socket, for example an incoming ICMP packet. -.SH EXAMPLE +.SH EXAMPLES .PP The following program uses .BR recvmmsg () @@ -292,7 +292,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 1918e78e0..a7a4be856 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/removexattr.2 b/man2/removexattr.2 index 40d7ad02e..9047a3589 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rename.2 b/man2/rename.2 index a0034c18e..74dc45bd6 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -30,7 +30,7 @@ .\" Modified Thu Mar 3 09:49:35 2005 by Michael Haardt <michael@moria.de> .\" 2007-03-25, mtk, added various text to DESCRIPTION. .\" -.TH RENAME 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH RENAME 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME rename, renameat, renameat2 \- change the name or location of a file .SH SYNOPSIS @@ -228,7 +228,7 @@ xfs (Linux 4.0); .\" gfs2 in 4.2? .IP * Support for many other filesystems was added in Linux 4.9, including -etx2, minix, reiserfs, jfs, vfat, and bpf. +ext2, minix, reiserfs, jfs, vfat, and bpf. .\" Also affs, bfs, exofs, hfs, hfsplus, jffs2, logfs, msdos, .\" nilfs2, omfs, sysvfs, ubifs, udf, ufs .\" hugetlbfs, ramfs @@ -294,7 +294,7 @@ ext4 (since Linux 3.18), .\" ext4: commit cd808deced431b66b5fa4e5c193cb7ec0059eaff XFS (since Linux 4.1), .\" XFS: commit 7dcf5c3e4527cfa2807567b00387cf2ed5e07f00 -f2fs (since Linux 4.2). +f2fs (since Linux 4.2), .\" f2fs: commit 7e01e7ad746bc8198a8b46163ddc73a1c7d22339 btrfs (since Linux 4.7), .\" btrfs: commit cdd1fedf8261cd7a73c0596298902ff4f0f04492 @@ -561,6 +561,7 @@ See for a similar problem. .SH SEE ALSO .BR mv (1), +.BR rename (1), .BR chmod (2), .BR link (2), .BR symlink (2), @@ -568,7 +569,7 @@ for a similar problem. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 cb5d46deb..dbb1a56fa 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH REQUEST_KEY 2 2019-03-06 Linux "Linux Key Management Calls" +.TH REQUEST_KEY 2 2020-06-09 Linux "Linux Key Management Calls" .SH NAME request_key \- request a key from the kernel's key management facility .SH SYNOPSIS @@ -444,7 +444,7 @@ A wrapper is provided in the package. When employing the wrapper in that library, link with .IR \-lkeyutils . -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR request_key (). The @@ -571,7 +571,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 4463fc993..8242a50f8 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rmdir.2 b/man2/rmdir.2 index d0e5b37be..04f9196c7 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.06 of the Linux +This page is part of release 5.07 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 224b2b1b7..e555abc23 100644 --- a/man2/rt_sigqueueinfo.2 +++ b/man2/rt_sigqueueinfo.2 @@ -207,7 +207,7 @@ or thread exists. .BR sigqueue (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 b20501283..61f2774c8 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.06 of the Linux +This page is part of release 5.07 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 b46a90331..a15b4ea1e 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.06 of the Linux +This page is part of release 5.07 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 4fbcbdae3..253083354 100644 --- a/man2/s390_runtime_instr.2 +++ b/man2/s390_runtime_instr.2 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH S390_RUNTIME_INSTR 2 2019-03-06 "Linux Programmer's Manual" +.TH S390_RUNTIME_INSTR 2 2020-06-09 "Linux Programmer's Manual" .SH NAME s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation .SH SYNOPSIS @@ -48,9 +48,13 @@ argument controls whether run-time instrumentation is started The .IR signum argument specifies the number of a real-time signal. -The real-time signal is sent to the thread if the run-time instrumentation -buffer is full or if the run-time-instrumentation-halted interrupt -occurred. +This argument was used to specify a signal number that should be delivered +to the thread if the run-time instrumentation buffer was full or if +the run-time-instrumentation-halted interrupt had occurred. +This feature was never used, +and in Linux 4.4 support for this feature was removed; +.\" commit b38feccd663b55ab07116208b68e1ffc7c3c7e78 +thus, in current kernels, this argument is ignored. .SH RETURN VALUE On success, .BR s390_runtime_instr () @@ -67,9 +71,16 @@ is set to one of the error codes listed below. .B EINVAL The value specified in .IR command -is not a valid command or the value specified in +is not a valid command. +.TP +.B EINVAL +The value specified in .IR signum is not a real-time signal number. +From Linux 4.4 onwards, the +.IR signum +argument has no effect, +so that an invalid signal number will not result in an error. .TP .B ENOMEM Allocating memory for the run-time instrumentation control block failed. @@ -80,7 +91,8 @@ The run-time instrumentation facility is not available. This system call is available since Linux 3.7. .SH CONFORMING TO This Linux-specific system call is available only on the s390 architecture. -The run-time instrumentation facility is available beginning with System z EC12. +The run-time instrumentation facility is available +beginning with System z EC12. .SH NOTES Glibc does not provide a wrapper for this system call, use .BR syscall (2) @@ -91,11 +103,20 @@ The header file is available .\" commit df2f815a7df7edb5335a3bdeee6a8f9f6f9c35c4 since Linux 4.16. +.PP +Starting with Linux 4.4, +support for signalling was removed, as was the check whether +.IR signum +is a valid real-time signal. +For backwards compatibility with older kernels, it is recommended to pass +a valid real-time signal number in +.I signum +and install a handler for that signal. .SH SEE ALSO .BR syscall (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 364c2049d..fb20a5364 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.06 of the Linux +This page is part of release 5.07 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 c5eda7d8a..0780e09bb 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.06 of the Linux +This page is part of release 5.07 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 16f8fd793..987928709 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.06 of the Linux +This page is part of release 5.07 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 b5a38e7bf..4f13861ab 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-10-10 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETAFFINITY 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sched_setaffinity, sched_getaffinity \- \ set and get a thread's CPU affinity mask @@ -303,7 +303,7 @@ counting those which are set, and stop upon reaching the value returned by .BR CPU_COUNT (3) (rather than iterating over the number of bits requested to be allocated). -.SH EXAMPLE +.SH EXAMPLES The program below creates a child process. The parent and child then each assign themselves to a specified CPU and execute identical loops that consume some CPU time. @@ -438,7 +438,7 @@ main(int argc, char *argv[]) .BR sched (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 f9c811ab1..7dfd839ae 100644 --- a/man2/sched_setattr.2 +++ b/man2/sched_setattr.2 @@ -410,7 +410,7 @@ and (partially) In Linux versions up to .\" FIXME . patch sent to Peter Zijlstra 3.15, -.BR sched_settattr () +.BR sched_setattr () failed with the error .BR EFAULT instead of @@ -446,7 +446,7 @@ for the case described in ERRORS. .BR sched (7) .ad .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 8cf9e3337..21b4b20fc 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.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.06 of the Linux +This page is part of release 5.07 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 ff7615e6c..4b1b92414 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.06 of the Linux +This page is part of release 5.07 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 e6350af96..d66747741 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seccomp.2 b/man2/seccomp.2 index facffee6f..3d277299f 100644 --- a/man2/seccomp.2 +++ b/man2/seccomp.2 @@ -25,7 +25,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SECCOMP 2 2019-11-19 "Linux" "Linux Programmer's Manual" +.TH SECCOMP 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME seccomp \- operate on Secure Computing state of the process .SH SYNOPSIS @@ -909,7 +909,7 @@ addressing mode modifier yields an immediate mode operand whose value is the size of the .IR seccomp_data buffer. -.SH EXAMPLE +.SH EXAMPLES The program below accepts four or more arguments. The first three arguments are a system call number, a numeric architecture identifier, and an error number. @@ -1124,11 +1124,11 @@ Various pages from the .I libseccomp library, including: .BR scmp_sys_resolver (1), +.BR seccomp_export_bpf (3), .BR seccomp_init (3), .BR seccomp_load (3), -.BR seccomp_rule_add (3), and -.BR seccomp_export_bpf (3). +.BR seccomp_rule_add (3). .PP The kernel source files .IR Documentation/networking/filter.txt @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/select.2 b/man2/select.2 index 0c42bdd3e..fcf8e3631 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -202,7 +202,7 @@ The indicated file descriptors in each set are checked, up to this limit .I timeout The .I timeout -argument is a +argument is a .I timeval structure (shown below) that specifies the interval that .BR select () @@ -710,7 +710,7 @@ system call has the same behavior, but the glibc wrapper hides this behavior by internally copying the .I timeout to a local variable and passing that variable to the system call. -.SH EXAMPLE +.SH EXAMPLES .EX #include <stdio.h> #include <stdlib.h> @@ -763,7 +763,7 @@ main(void) For a tutorial with discussion and examples, see .BR select_tut (2). .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 43d9782fc..be3eac07e 100644 --- a/man2/select_tut.2 +++ b/man2/select_tut.2 @@ -346,7 +346,7 @@ API provides an interface that is more efficient than and .BR poll (2) when monitoring large numbers of file descriptors. -.SH EXAMPLE +.SH EXAMPLES Here is an example that better demonstrates the true utility of .BR select (). The listing below is a TCP forwarding program that forwards @@ -652,7 +652,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semctl.2 b/man2/semctl.2 index cc795e72a..312687135 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -88,7 +88,8 @@ data structure is defined in \fI<sys/sem.h>\fP as follows: struct semid_ds { struct ipc_perm sem_perm; /* Ownership and permissions */ time_t sem_otime; /* Last semop time */ - time_t sem_ctime; /* Last change time */ + time_t sem_ctime; /* Creation time/time of last + modification via semctl() */ unsigned long sem_nsems; /* No. of semaphores in set */ }; .EE @@ -109,10 +110,13 @@ Time of last system call. .TP .I sem_ctime -Time of last -.BR semctl (2) -system call that changed a member of the above structure or of one -semaphore belonging to the set. +Time of creation of semaphore set or time of last +.BR semctl () +.BR IPCSET , +.BR SETVAL , +or +.BR SETVALL +operation. .TP .I sem_nsems Number of semaphores in the set. @@ -635,7 +639,7 @@ operations. This was rectified .\" commit a5f4db877177d2a3d7ae62a7bac3a5a27e083d7f in Linux 4.6. -.SH EXAMPLE +.SH EXAMPLES See .BR shmop (2). .SH SEE ALSO @@ -646,7 +650,7 @@ See .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semget.2 b/man2/semget.2 index 388c024e0..90876a9c5 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -313,7 +313,7 @@ The name choice was perhaps unfortunate, .B IPC_NEW would more clearly show its function. -.SH EXAMPLE +.SH EXAMPLES The program shown below uses .BR semget () to create a new semaphore set or retrieve the ID of an existing set. @@ -365,7 +365,7 @@ key semid owner perms nsems .in .PP Next, we demonstrate that when -.BR semctl () +.BR semctl (2) is given the same .I key (as generated by the same arguments to @@ -399,6 +399,10 @@ ID = 9 .SS Program source \& .nf +/* t_semget.c + + Licensed under GNU General Public License v2 or later. +*/ #include <sys/types.h> #include <sys/ipc.h> #include <sys/sem.h> @@ -462,7 +466,7 @@ main(int argc, char *argv[]) .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semop.2 b/man2/semop.2 index e8aaced59..95f7d422e 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -517,7 +517,7 @@ This bug is fixed in kernel 2.6.11. .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2 .\" the fix: .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2 -.SH EXAMPLE +.SH EXAMPLES The following code segment uses .BR semop () to atomically wait for the value of semaphore 0 to become zero, @@ -559,7 +559,7 @@ can be found in .BR sysvipc (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/send.2 b/man2/send.2 index bc77af0e8..571512c58 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -37,7 +37,7 @@ .\" Modified Oct 2003 by aeb .\" Modified 2004-07-01 by mtk .\" -.TH SEND 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SEND 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME send, sendto, sendmsg \- send a message on a socket .SH SYNOPSIS @@ -458,7 +458,7 @@ Linux may return .B EPIPE instead of .BR ENOTCONN . -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR sendto () is shown in @@ -481,7 +481,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendfile.2 b/man2/sendfile.2 index 61801e65b..4aa171946 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -164,8 +164,7 @@ the input file or the output file. .TP .B ESPIPE .I offset -is not NULL but the input file is not -.BR seek (2)-able. +is not NULL but the input file is not seekable. .SH VERSIONS .BR sendfile () first appeared in Linux 2.2. @@ -243,7 +242,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendmmsg.2 b/man2/sendmmsg.2 index 302abd43b..5f9506bfa 100644 --- a/man2/sendmmsg.2 +++ b/man2/sendmmsg.2 @@ -25,7 +25,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SENDMMSG 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SENDMMSG 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sendmmsg \- send multiple messages on a socket .SH SYNOPSIS @@ -174,7 +174,7 @@ The caller can retry the transmission, starting at the first failed message, but there is no guarantee that, if an error is returned, it will be the same as the one that was lost on the previous call. -.SH EXAMPLE +.SH EXAMPLES The example below uses .BR sendmmsg () to send @@ -248,7 +248,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 7a2206008..81b7f297a 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.06 of the Linux +This page is part of release 5.07 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 19209fa8c..b379c7580 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.06 of the Linux +This page is part of release 5.07 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 3c3925d00..06cab4b5b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 8482614f1..0a7d3c1b3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsgid.2 b/man2/setfsgid.2 index 0a04881fc..54461f2d6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsuid.2 b/man2/setfsuid.2 index 2ebf18bf3..b547acd8f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setgid.2 b/man2/setgid.2 index dbb37a282..5e36ebbf2 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setns.2 b/man2/setns.2 index a04cfac12..45b384506 100644 --- a/man2/setns.2 +++ b/man2/setns.2 @@ -253,7 +253,7 @@ a new thread is created using .BR clone (2) can be changed using .BR setns (). -.SH EXAMPLE +.SH EXAMPLES The program below takes two or more arguments. The first argument specifies the pathname of a namespace file in an existing .I /proc/[pid]/ns/ @@ -349,7 +349,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 44f2cb392..c985c65e5 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -59,13 +59,11 @@ setpgid, getpgid, setpgrp, getpgrp \- set/get process group .PP .BR "pid_t getpgrp(void);" " /* POSIX.1 version */" .br -.BI "pid_t getpgrp(pid_t " pid ");\ \ \ \ \ \ \ \ \ \ \ " -/* BSD version */ +.BI "pid_t getpgrp(pid_t " pid ");\fR /* BSD version */" .PP .BR "int setpgrp(void);" " /* System V version */" .br -.BI "int setpgrp(pid_t " pid ", pid_t " pgid ");\ " -/* BSD version */ +.BI "int setpgrp(pid_t " pid ", pid_t " pgid ");\fR /* BSD version */" .PP .in -4n Feature Test Macro Requirements for glibc (see @@ -338,7 +336,7 @@ in a different session (see also .BR termios (3), .BR credentials (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 7c4101e58..f98078c86 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setreuid.2 b/man2/setreuid.2 index 0ba66b64f..ed284bf3f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setsid.2 b/man2/setsid.2 index 857b09a49..f5888e62c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setuid.2 b/man2/setuid.2 index b48d82893..bf13d265c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setup.2 b/man2/setup.2 index bdfae6268..effd7b3b8 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setxattr.2 b/man2/setxattr.2 index 53da50394..ab339b471 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sgetmask.2 b/man2/sgetmask.2 index 4718e55b1..4f92e6e16 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 921591812..193bfea3f 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -73,7 +73,8 @@ struct shmid_ds { size_t shm_segsz; /* Size of segment (bytes) */ time_t shm_atime; /* Last attach time */ time_t shm_dtime; /* Last detach time */ - time_t shm_ctime; /* Last change time */ + time_t shm_ctime; /* Creation time/time of last + modification via shmctl() */ pid_t shm_cpid; /* PID of creator */ pid_t shm_lpid; /* PID of last shmat(2)/shmdt(2) */ shmatt_t shm_nattch; /* No. of current attaches */ @@ -119,11 +120,10 @@ Time of the last system call that detached tgis segment. .TP .I shm_ctime -Time of the last -.BR shmctl (2) -system call that changed the -.IR shmid_ds -structure. +Time of creation of segment or time of the last +.BR shmctl () +.BR IPC_SET +operation. .PP The .I ipc_perm @@ -516,7 +516,7 @@ flag in .BR capabilities (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmget.2 b/man2/shmget.2 index 7e97c7be3..6c7da310c 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -411,7 +411,7 @@ The name choice was perhaps unfortunate, .B IPC_NEW would more clearly show its function. -.SH EXAMPLE +.SH EXAMPLES See .BR shmop (2). .SH SEE ALSO @@ -424,7 +424,7 @@ See .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmop.2 b/man2/shmop.2 index e367fad9d..926690dcb 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -291,7 +291,7 @@ is the same as the system page size.) The implementation places no intrinsic per-process limit on the number of shared memory segments .RB ( SHMSEG ). -.SH EXAMPLE +.SH EXAMPLES .PP The two programs shown below exchange a string using a shared memory segment. Further details about the programs are given below. @@ -374,6 +374,10 @@ shared memory segment by the "writer". .PP .in +4n .EX +/* svshm_string_read.c + + Licensed under GNU General Public License v2 or later. +*/ #include "svshm_string.h" int @@ -444,6 +448,10 @@ and then decrements the semaphore value to 0 in order to inform the .PP .in +4n .EX +/* svshm_string_write.c + + Licensed under GNU General Public License v2 or later. +*/ #include "svshm_string.h" int @@ -501,7 +509,7 @@ main(int argc, char *argv[]) .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shutdown.2 b/man2/shutdown.2 index 0356af5d8..5dc6e8ef7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaction.2 b/man2/sigaction.2 index dceddc6b5..954fe5a1d 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -1035,16 +1035,16 @@ prevents not only the delivered signal from being masked during execution of the handler, but also the signals specified in .IR sa_mask . This bug was fixed in kernel 2.6.14. -.SH EXAMPLE +.SH EXAMPLES See .BR mprotect (2). .SH SEE ALSO .BR kill (1), .BR kill (2), .BR pause (2), -.BR pidfd_send_signal (2) +.BR pidfd_send_signal (2), .BR restart_syscall (2), -.BR seccomp (2) +.BR seccomp (2), .BR sigaltstack (2), .BR signal (2), .BR signalfd (2), @@ -1062,7 +1062,7 @@ See .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index 312bfb5a9..d105df668 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" aeb, various minor fixes -.TH SIGALTSTACK 2 2017-11-08 "Linux" "Linux Programmer's Manual" +.TH SIGALTSTACK 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sigaltstack \- set and/or get signal stack context .SH SYNOPSIS @@ -286,42 +286,6 @@ system call. It used a slightly different struct, and had the major disadvantage that the caller had to know the direction of stack growth. -.SH EXAMPLE -The following code segment demonstrates the use of -.BR sigaltstack () -(and -.BR sigaction (2)) -to install an alternate signal stack that is employed by a handler -for the -.BR SIGSEGV -signal: -.PP -.in +4n -.EX -stack_t ss; - -ss.ss_sp = malloc(SIGSTKSZ); -if (ss.ss_sp == NULL) { - perror("malloc"); - exit(EXIT_FAILURE); -} - -ss.ss_size = SIGSTKSZ; -ss.ss_flags = 0; -if (sigaltstack(&ss, NULL) == \-1) { - perror("sigaltstack"); - exit(EXIT_FAILURE); -} - -sa.sa_flags = SA_ONSTACK; -sa.sa_handler = handler(); /* Address of a signal handler */ -sigemptyset(&sa.sa_mask); -if (sigaction(SIGSEGV, &sa, NULL) == -1) { - perror("sigaction"); - exit(EXIT_FAILURE); -} -.EE -.in .SH BUGS In Linux 2.2 and earlier, the only flag that could be specified in @@ -360,6 +324,42 @@ give an error if .B SS_ONSTACK is specified in .IR ss.ss_flags . +.SH EXAMPLES +The following code segment demonstrates the use of +.BR sigaltstack () +(and +.BR sigaction (2)) +to install an alternate signal stack that is employed by a handler +for the +.BR SIGSEGV +signal: +.PP +.in +4n +.EX +stack_t ss; + +ss.ss_sp = malloc(SIGSTKSZ); +if (ss.ss_sp == NULL) { + perror("malloc"); + exit(EXIT_FAILURE); +} + +ss.ss_size = SIGSTKSZ; +ss.ss_flags = 0; +if (sigaltstack(&ss, NULL) == \-1) { + perror("sigaltstack"); + exit(EXIT_FAILURE); +} + +sa.sa_flags = SA_ONSTACK; +sa.sa_handler = handler(); /* Address of a signal handler */ +sigemptyset(&sa.sa_mask); +if (sigaction(SIGSEGV, &sa, NULL) == -1) { + perror("sigaction"); + exit(EXIT_FAILURE); +} +.EE +.in .SH SEE ALSO .BR execve (2), .BR setrlimit (2), @@ -368,7 +368,7 @@ is specified in .BR sigsetjmp (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signal.2 b/man2/signal.2 index b6b191138..5589d2a40 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signalfd.2 b/man2/signalfd.2 index 137bdaaef..9f45bfdcf 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -17,7 +17,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH SIGNALFD 2 2019-10-10 Linux "Linux Programmer's Manual" +.TH SIGNALFD 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME signalfd \- create a file descriptor for accepting signals .SH SYNOPSIS @@ -271,7 +271,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 () +.BR fork (2) 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 @@ -444,7 +444,7 @@ and fields are not filled in with the data accompanying a signal sent by .BR sigqueue (3). .\" The fix also was put into 2.6.24.5 -.SH EXAMPLE +.SH EXAMPLES The program below accepts the signals .B SIGINT and @@ -531,7 +531,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigpending.2 b/man2/sigpending.2 index 34e1bbc51..007c55edf 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2 index e2845aeab..cfa74875a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 index 8ab895c75..d6c4d1e29 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2 index c9abf7744..fe3dbdd26 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2 index d82403f51..c63baff06 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socket.2 b/man2/socket.2 index ff562569f..07f4b3267 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -40,7 +40,7 @@ .\" Modified 2002-07-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH SOCKET 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SOCKET 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME socket \- create an endpoint for communication .SH SYNOPSIS @@ -485,7 +485,7 @@ families. However, already the BSD man page promises: "The protocol family generally is the same as the address family", and subsequent standards use AF_* everywhere. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR socket () is shown in @@ -522,7 +522,7 @@ and reprinted in .I UNIX Programmer's Supplementary Documents Volume 1. .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketcall.2 b/man2/socketcall.2 index f8993dfc8..afdcb6703 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketpair.2 b/man2/socketpair.2 index 1307f7a93..e351108a0 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -39,7 +39,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2008-10-11, mtk: Add description of SOCK_NONBLOCK and SOCK_CLOEXEC .\" -.TH SOCKETPAIR 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SOCKETPAIR 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME socketpair \- create a pair of connected sockets .SH SYNOPSIS @@ -79,7 +79,7 @@ On Linux (and other systems), does not modify .I sv on failure. -A requirement standardizing this behavior was added in POSIX.1-2016. +A requirement standardizing this behavior was added in POSIX.1-2008 TC2. .\" http://austingroupbugs.net/view.php?id=483 .SH ERRORS .TP @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/splice.2 b/man2/splice.2 index 2d4d97e35..ffc61acb8 100644 --- a/man2/splice.2 +++ b/man2/splice.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SPLICE 2 2019-05-09 "Linux" "Linux Programmer's Manual" +.TH SPLICE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME splice \- splice data to/from a pipe .SH SYNOPSIS @@ -261,7 +261,7 @@ was required to be a pipe. Since Linux 2.6.31, .\" commit 7c77f0b3f9208c339a4b40737bb2cb0f0319bb8d both arguments may refer to pipes. -.SH EXAMPLE +.SH EXAMPLES See .BR tee (2). .SH SEE ALSO @@ -271,7 +271,7 @@ See .BR vmsplice (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 92909fb1c..3c41eab55 100644 --- a/man2/spu_create.2 +++ b/man2/spu_create.2 @@ -22,7 +22,7 @@ .\" 2007-07-10, some polishing by mtk .\" 2007-09-28, updates for newer kernels by Jeremy Kerr <jk@ozlabs.org> .\" -.TH SPU_CREATE 2 2017-09-15 Linux "Linux Programmer's Manual" +.TH SPU_CREATE 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME spu_create \- create a new spu context .SH SYNOPSIS @@ -262,7 +262,7 @@ See .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/ .UE for the recommended libraries. -.SH EXAMPLE +.SH EXAMPLES See .BR spu_run (2) for an example of the use of @@ -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.06 of the Linux +This page is part of release 5.07 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 a3f3f0110..6c133d3af 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -23,7 +23,7 @@ .\" 2007-09-28, updates for newer kernels, added example .\" by Jeremy Kerr <jk@ozlabs.org> .\" -.TH SPU_RUN 2 2019-03-06 Linux "Linux Programmer's Manual" +.TH SPU_RUN 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME spu_run \- execute an SPU context .SH SYNOPSIS @@ -204,7 +204,7 @@ See .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/ .UE for the recommended libraries. -.SH EXAMPLE +.SH EXAMPLES The following is an example of running a simple, one-instruction SPU program with the .BR spu_run () @@ -267,7 +267,7 @@ int main(void) .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stat.2 b/man2/stat.2 index 0438f3260..77a4d5b6a 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -117,7 +117,7 @@ is identical to except that if .I pathname is a symbolic link, then it returns information about the link itself, -not the file that it refers to. +not the file that the link refers to. .PP .BR fstat () is identical to @@ -340,15 +340,9 @@ Since Linux 4.14, .\" commit 42f46148217865a545e129612075f3d828a2c4e4 also don't instantiate a nonexistent name in an on-demand directory such as used for automounter indirect maps. -This flag can be used in tools that scan directories -to prevent mass-automounting of a directory of automount points. -The -.B AT_NO_AUTOMOUNT +This flag has no effect if the mount point has already been mounted over. -This flag is Linux-specific; define -.B _GNU_SOURCE -.\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed -to obtain its definition. +.IP Both .BR stat () and @@ -356,6 +350,17 @@ and act as though .B AT_NO_AUTOMOUNT was set. +.IP +The +.B AT_NO_AUTOMOUNT +can be used in tools that scan directories +to prevent mass-automounting of a directory of automount points. +.IP +.IP +This flag is Linux-specific; define +.B _GNU_SOURCE +.\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed +to obtain its definition. .TP .B AT_SYMLINK_NOFOLLOW If @@ -635,7 +640,7 @@ wrapper function is actually called or, on some architectures, .\" strace(1) shows the name "newfstatat" on x86-64 .BR newfstatat (). -.SH EXAMPLE +.SH EXAMPLES The following program calls .BR lstat () and displays selected fields in the returned @@ -717,7 +722,7 @@ main(int argc, char *argv[]) .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statfs.2 b/man2/statfs.2 index 613b53f4f..b8787cbf3 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -25,7 +25,7 @@ .\" Modified 2003-08-17 by Walter Harms .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH STATFS 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH STATFS 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME statfs, fstatfs \- get filesystem statistics .SH SYNOPSIS @@ -54,8 +54,8 @@ struct statfs { fsblkcnt_t f_bfree; /* Free blocks in filesystem */ fsblkcnt_t f_bavail; /* Free blocks available to unprivileged user */ - fsfilcnt_t f_files; /* Total file nodes in filesystem */ - fsfilcnt_t f_ffree; /* Free file nodes in filesystem */ + fsfilcnt_t f_files; /* Total inodes in filesystem */ + fsfilcnt_t f_ffree; /* Free inodes in filesystem */ fsid_t f_fsid; /* Filesystem ID */ __fsword_t f_namelen; /* Maximum length of filenames */ __fsword_t f_frsize; /* Fragment size (since Linux 2.6) */ @@ -141,6 +141,7 @@ SECURITYFS_MAGIC 0x73636673 SELINUX_MAGIC 0xf97cff8c SMACK_MAGIC 0x43415d53 SMB_SUPER_MAGIC 0x517b +SMB2_MAGIC_NUMBER 0xfe534d42 SOCKFS_MAGIC 0x534f434b SQUASHFS_MAGIC 0x73717368 SYSFS_MAGIC 0x62656572 @@ -390,7 +391,7 @@ for file descriptors created by .BR statvfs (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statx.2 b/man2/statx.2 index da27dad20..72564f702 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -551,7 +551,7 @@ is Linux-specific. .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stime.2 b/man2/stime.2 index 437371564..b66afd831 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -86,7 +86,7 @@ and is no longer declared in .BR settimeofday (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 9234d01f8..b6d4572c5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/swapon.2 b/man2/swapon.2 index fb2b9d83a..e375f4eb5 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -138,7 +138,7 @@ resides on an in-memory filesystem such as .BR EINVAL " (since Linux 3.4)" .RB ( swapon ()) An invalid flag value was specified in -.IR flags . +.IR swapflags . .TP .B EINVAL .RB ( swapoff ()) @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/symlink.2 b/man2/symlink.2 index 69782201c..00fd3bd18 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sync.2 b/man2/sync.2 index b3af0490f..9af820fa4 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.06 of the Linux +This page is part of release 5.07 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 3c566478a..e5aa3c466 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscall.2 b/man2/syscall.2 index 18309da66..bbe62f7f7 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 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH SYSCALL 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME syscall \- indirect system call .SH SYNOPSIS @@ -82,9 +82,8 @@ when invoking a system call that has no wrapper function in the C library. .BR syscall () saves CPU registers before making the system call, restores the registers upon return from the system call, -and stores any error code returned by the system call in -.BR errno (3) -if an error occurs. +and stores any error returned by the system call in +.BR errno (3). .PP Symbolic constants for system call numbers can be found in the header file .IR <sys/syscall.h> . @@ -92,7 +91,7 @@ Symbolic constants for system call numbers can be found in the header file The return value is defined by the system call being invoked. In general, a 0 return value indicates success. A \-1 return value indicates an error, -and an error code is stored in +and an error number is stored in .IR errno . .SH NOTES .BR syscall () @@ -118,7 +117,7 @@ Thus, using .BR syscall () instead of the wrapper provided by glibc, the -.BR readahead () +.BR readahead (2) system call would be invoked as follows on the ARM architecture with the EABI in little endian mode: .PP @@ -201,9 +200,9 @@ Arch/ABI Instruction System Ret Ret Error Notes _ alpha callsys v0 v0 a4 a3 1, 6 arc trap0 r8 r0 - - -arm/OABI swi NR - a1 - - 2 +arm/OABI swi NR - r0 - - 2 arm/EABI swi 0x0 r7 r0 r1 - -arm64 svc #0 x8 x0 x1 - +arm64 svc #0 w8 x0 x1 - blackfin excpt 0x0 P0 R0 - - i386 int $0x80 eax eax edx - ia64 break 0x100000 r15 r8 r9 r10 1, 6 @@ -332,7 +331,7 @@ Arch/ABI arg1 arg2 arg3 arg4 arg5 arg6 arg7 Notes _ alpha a0 a1 a2 a3 a4 a5 - arc r0 r1 r2 r3 r4 r5 - -arm/OABI a1 a2 a3 a4 v1 v2 v3 +arm/OABI r0 r1 r2 r3 r4 r5 r6 arm/EABI r0 r1 r2 r3 r4 r5 r6 arm64 x0 x1 x2 x3 x4 x5 - blackfin R0 R1 R2 R3 R4 R5 - @@ -369,7 +368,7 @@ arguments 5 through 8 on the user stack. .PP Note that these tables don't cover the entire calling convention\(emsome architectures may indiscriminately clobber other registers not listed here. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include <unistd.h> @@ -393,7 +392,7 @@ main(int argc, char *argv[]) .BR errno (3), .BR vdso (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscalls.2 b/man2/syscalls.2 index cc5925ed7..51d166acb 100644 --- a/man2/syscalls.2 +++ b/man2/syscalls.2 @@ -1116,7 +1116,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysctl.2 b/man2/sysctl.2 index dd7cd31d3..c37dfe949 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -27,7 +27,7 @@ .\" Modified Tue Oct 22 22:28:41 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Mon Jan 5 20:31:04 1998 by aeb. .\" -.TH SYSCTL 2 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH SYSCTL 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sysctl \- read/write system parameters .SH SYNOPSIS @@ -133,7 +133,7 @@ Not all available objects are properly documented. .PP It is not yet possible to change operating system by writing to .IR /proc/sys/kernel/ostype . -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include <unistd.h> @@ -174,7 +174,7 @@ main(void) .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysfs.2 b/man2/sysfs.2 index d1fd42bb5..f4244685d 100644 --- a/man2/sysfs.2 +++ b/man2/sysfs.2 @@ -24,7 +24,7 @@ .\" .\" Created Wed Aug 9 1995 Thomas K. Dyas <tdyas@eden.rutgers.edu> .\" -.TH SYSFS 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SYSFS 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sysfs \- get filesystem type information .SH SYNOPSIS @@ -105,13 +105,16 @@ This System-V derived system call is obsolete; don't use it. On systems with .IR /proc , the same information can be obtained via -.IR /proc/filesystems ; +.IR /proc ; use that interface instead. .SH BUGS There is no libc or glibc support. There is no way to guess how large \fIbuf\fP should be. +.SH SEE ALSO +.BR proc (5), +.BR sysfs (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index 25d50a0e5..4c032bb8f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syslog.2 b/man2/syslog.2 index 48e015a42..f63faf25c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tee.2 b/man2/tee.2 index 4cebf71b8..385149f09 100644 --- a/man2/tee.2 +++ b/man2/tee.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TEE 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH TEE 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME tee \- duplicating pipe content .SH SYNOPSIS @@ -133,7 +133,7 @@ under the covers, .BR tee () assigns data to the output by merely grabbing a reference to the input. -.SH EXAMPLE +.SH EXAMPLES The example below implements a basic .BR tee (1) program using the @@ -216,7 +216,7 @@ main(int argc, char *argv[]) .BR vmsplice (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/time.2 b/man2/time.2 index cebe14fac..2f427a03f 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.06 of the Linux +This page is part of release 5.07 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 e48efe34a..9d3ee2b0a 100644 --- a/man2/timer_create.2 +++ b/man2/timer_create.2 @@ -335,7 +335,7 @@ and in glibc versions before 2.17, .\" glibc commit 93a78ac437ba44f493333d7e2a4b0249839ce460 the implementation falls back to this technique on systems running pre-2.6 Linux kernels. -.SH EXAMPLE +.SH EXAMPLES The program below takes two arguments: a sleep period in seconds, and a timer frequency in nanoseconds. The program establishes a handler for the signal it uses for the timer, @@ -499,7 +499,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 39034fdf9..0d28e5867 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.06 of the Linux +This page is part of release 5.07 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 fecb9689b..f99f13870 100644 --- a/man2/timer_getoverrun.2 +++ b/man2/timer_getoverrun.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TIMER_GETOVERRUN 2 2017-09-15 Linux "Linux Programmer's Manual" +.TH TIMER_GETOVERRUN 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME timer_getoverrun \- get overrun count for a POSIX per-process timer .SH SYNOPSIS @@ -126,7 +126,7 @@ if the timer overrun value exceeds the maximum representable integer, the counter cycles, starting once more from low values. .\" Bug filed: http://bugzilla.kernel.org/show_bug.cgi?id=12665 .\" http://thread.gmane.org/gmane.linux.kernel/113276/ -.SH EXAMPLE +.SH EXAMPLES See .BR timer_create (2). .SH SEE ALSO @@ -140,7 +140,7 @@ See .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 d065e245f..6586677ef 100644 --- a/man2/timer_settime.2 +++ b/man2/timer_settime.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TIMER_SETTIME 2 2017-09-15 Linux "Linux Programmer's Manual" +.TH TIMER_SETTIME 2 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME timer_settime, timer_gettime \- arm/disarm and fetch state of POSIX per-process timer @@ -206,7 +206,7 @@ is negative or greater than 999,999,999. These system calls are available since Linux 2.6. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR timer_create (2). .SH SEE ALSO @@ -214,7 +214,7 @@ See .BR timer_getoverrun (2), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 d7dc83e9d..5b7358a61 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -552,7 +552,7 @@ Currently, .BR timerfd_create () supports fewer types of clock IDs than .BR timer_create (2). -.SH EXAMPLE +.SH EXAMPLES The following program creates a timer and then monitors its progress. The program accepts up to three command-line arguments. The first argument specifies the number of seconds for @@ -727,7 +727,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/times.2 b/man2/times.2 index 4628756f1..799f161eb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tkill.2 b/man2/tkill.2 index 09b7c38d7..c949ae1df 100644 --- a/man2/tkill.2 +++ b/man2/tkill.2 @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/truncate.2 b/man2/truncate.2 index 82f090ac8..f3a616b31 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umask.2 b/man2/umask.2 index 17660fbad..35775cbed 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umount.2 b/man2/umount.2 index 53fd74cca..8386bd1c7 100644 --- a/man2/umount.2 +++ b/man2/umount.2 @@ -27,7 +27,7 @@ .\" 2008-10-06, mtk: Created this as a new page by splitting .\" umount/umount2 material out of mount.2 .\" -.TH UMOUNT 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH UMOUNT 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME umount, umount2 \- unmount filesystem .SH SYNOPSIS @@ -199,7 +199,7 @@ To ensure .BR umount () does not propagate in this fashion, the mount point may be remounted using a -.BR mount () +.BR mount (2) call with a .I mount_flags argument that includes both @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uname.2 b/man2/uname.2 index 32d01d4e4..cf46531fd 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -170,7 +170,7 @@ invoking the most recent version of the system call provided by the kernel. .BR gethostname (2), .BR uts_namespaces (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unimplemented.2 b/man2/unimplemented.2 index 7e41e0486..e0439ec41 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unlink.2 b/man2/unlink.2 index 4c9878447..f50a9e329 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unshare.2 b/man2/unshare.2 index 48cb62294..d80b9be90 100644 --- a/man2/unshare.2 +++ b/man2/unshare.2 @@ -460,7 +460,7 @@ Such functionality may be added in the future, if required. .\"be incrementally added to unshare without affecting legacy .\"applications using unshare. .\" -.SH EXAMPLE +.SH EXAMPLES The program below provides a simple implementation of the .BR unshare (1) command, which unshares one or more namespaces and executes the @@ -566,7 +566,7 @@ in the Linux kernel source tree .I Documentation/unshare.txt before Linux 4.12) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uselib.2 b/man2/uselib.2 index d1f7061d5..1f8da2eb2 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 4eff1f7b9..3ee2ca005 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH USERFAULTFD 2 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH USERFAULTFD 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME userfaultfd \- create a file descriptor for handling page faults in user space .SH SYNOPSIS @@ -483,7 +483,7 @@ might be created. In this case, a spurious .B UFFD_EVENT_FORK will be delivered to the userfaultfd monitor. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of the userfaultfd mechanism. The program creates two threads, one of which acts as the page-fault handler for the process, for the pages in a demand-page zero @@ -768,7 +768,7 @@ main(int argc, char *argv[]) in the Linux kernel source tree .PP .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ustat.2 b/man2/ustat.2 index ba8a89f0f..1b91a8188 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utime.2 b/man2/utime.2 index 8d9425243..f401ac9fd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utimensat.2 b/man2/utimensat.2 index 3a326f3f4..cfef8e342 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH UTIMENSAT 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH UTIMENSAT 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME utimensat, futimens \- change file timestamps with nanosecond precision .SH SYNOPSIS @@ -238,10 +238,7 @@ or both .I tv_nsec values are .BR UTIME_NOW , -and either: -.RS -.IP * 3 -the effective user ID of the caller does not match +and the effective user ID of the caller does not match the owner of the file, the caller does not have write access to the file, and the caller is not privileged @@ -249,7 +246,7 @@ and the caller is not privileged .B CAP_FOWNER or the .B CAP_DAC_OVERRIDE -capability); or, +capability). .\" But Linux 2.6.22 was broken here. .\" Traditionally, utime()/utimes() gives the error EACCES for the case .\" where the timestamp pointer argument is NULL (i.e., set both timestamps @@ -271,9 +268,6 @@ capability); or, .\" and the permissions of the directory to which .\" .I fd .\" refers do not allow searches. -.IP * -the file is marked immutable (see -.BR chattr (1)). .\" EXT2_IMMUTABLE_FL and similar flags for other filesystems. .RE .TP @@ -485,7 +479,7 @@ Note, however, that the glibc wrapper for disallows passing NULL as the value for .IR pathname : the wrapper function returns the error -.IR EINVAL +.BR EINVAL in this case. .SH BUGS Several bugs afflict @@ -645,7 +639,7 @@ instead checks whether the .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vfork.2 b/man2/vfork.2 index 9cffc7303..457dbfd5e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vhangup.2 b/man2/vhangup.2 index b98766691..1176d5f11 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vm86.2 b/man2/vm86.2 index 4a983ebea..dc7261274 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vmsplice.2 b/man2/vmsplice.2 index b9e6bb2e7..86b1582fe 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait.2 b/man2/wait.2 index cea5dfa28..50fc57ce9 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -618,7 +618,7 @@ is NULL, succeeds, and returns the process ID of the waited-for child. Applications should avoid relying on this inconsistent, nonstandard, and unnecessary feature. -.SH EXAMPLE +.SH EXAMPLES .\" fork.2 refers to this example program. The following program demonstrates the use of .BR fork (2) @@ -715,7 +715,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait4.2 b/man2/wait4.2 index 8977340f8..cb194d086 100644 --- a/man2/wait4.2 +++ b/man2/wait4.2 @@ -30,7 +30,7 @@ .\" Rewrote much of this page, and removed much duplicated text, .\" replacing with pointers to wait.2 .\" -.TH WAIT4 2 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH WAIT4 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME wait3, wait4 \- wait for process to change state, BSD style .SH SYNOPSIS @@ -54,7 +54,11 @@ Feature Test Macro Requirements for glibc (see .PP .ad l .BR wait3 (): - Since glibc 2.19: + Since glibc 2.26: + _DEFAULT_SOURCE || + (_XOPEN_SOURCE\ >=\ 500 && + ! (_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600)) + From glibc 2.19 to 2.25: _DEFAULT_SOURCE || _XOPEN_SOURCE\ >=\ 500 Glibc 2.19 and earlier: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 @@ -180,7 +184,7 @@ system call. .BR wait (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man2/write.2 b/man2/write.2 index d582cbc7a..2d941d394 100644 --- a/man2/write.2 +++ b/man2/write.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.06 of the Linux +This page is part of release 5.07 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 38d8f893c..2bd0c38f7 100644 --- a/man3/CPU_SET.3 +++ b/man3/CPU_SET.3 @@ -312,7 +312,7 @@ and less efficient operation of the macros that operate on dynamically allocated CPU sets. These bugs are fixed in glibc 2.9. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=7029 -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the use of some of the macros used for dynamically allocated CPU sets. .PP @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/INFINITY.3 b/man3/INFINITY.3 index da6c22871..cc6c680c3 100644 --- a/man3/INFINITY.3 +++ b/man3/INFINITY.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INFINITY 3 2017-09-15 "" "Linux Programmer's Manual" +.TH INFINITY 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL \- floating-point constants .SH SYNOPSIS @@ -73,7 +73,7 @@ respectively, that represent a large positive value, possibly positive infinity. .SH CONFORMING TO C99. -.SH AVAILABILITY +.PP On a glibc system, the macro .B HUGE_VAL is always available. @@ -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.06 of the Linux +This page is part of release 5.07 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 8cb89b57e..b1c7d699b 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.06 of the Linux +This page is part of release 5.07 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 8cca8ea18..d3e17e946 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.06 of the Linux +This page is part of release 5.07 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 3715d1537..e39a937c9 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH __PPC_GET_TIMEBASE 3 2019-03-06 "GNU C Library" "Linux Programmer's\ +.TH __PPC_GET_TIMEBASE 3 2020-06-09 "GNU C Library" "Linux Programmer's\ Manual" .SH NAME __ppc_get_timebase, __ppc_get_timebase_freq \- get the current value @@ -63,7 +63,7 @@ has been provided since version 2.16 and has been available since version 2.17. .SH CONFORMING TO Both functions are nonstandard GNU extensions. -.SH EXAMPLE +.SH EXAMPLES The following program will calculate the time, in microseconds, spent between two calls to .BR __ppc_get_timebase (). @@ -111,7 +111,7 @@ main(void) .BR time (2), .BR usleep (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 2af63edd7..8baf4cf61 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.06 of the Linux +This page is part of release 5.07 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 f618e2c16..411a41083 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index df5bf328f..431f8346b 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -5,7 +5,7 @@ .\" This page is licensed under the GNU General Public License .\" %%%LICENSE_END .\" -.TH __SETFPUCW 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH __SETFPUCW 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME __setfpucw \- set FPU control word on i386 architecture (obsolete) .SH SYNOPSIS @@ -48,7 +48,7 @@ and macros from .I <fpu_control.h> can be used. -.SH EXAMPLE +.SH EXAMPLES .B __setfpucw(0x1372) .PP Set FPU control word on the i386 architecture to @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/a64l.3 b/man3/a64l.3 index d935454d3..bb1bc3848 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abort.3 b/man3/abort.3 index f7a73b2e2..473f9061b 100644 --- a/man3/abort.3 +++ b/man3/abort.3 @@ -31,7 +31,7 @@ .\" Modified Fri Aug 4 10:51:53 2000 - patch from Joseph S. Myers .\" 2007-12-15, mtk, Mostly rewritten .\" -.TH ABORT 3 2017-11-26 "GNU" "Linux Programmer's Manual" +.TH ABORT 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME abort \- cause abnormal process termination .SH SYNOPSIS @@ -79,6 +79,8 @@ T{ .BR abort () T} Thread safety MT-Safe .TE +.SH CONFORMING TO +SVr4, POSIX.1-2001, POSIX.1-2008, 4.3BSD, C89, C99. .SH NOTES Up until glibc 2.26, if the @@ -94,8 +96,6 @@ terminates the process without flushing streams. POSIX.1 permits either possible behavior, saying that .BR abort () "may include an attempt to effect fclose() on all open streams". -.SH CONFORMING TO -SVr4, POSIX.1-2001, POSIX.1-2008, 4.3BSD, C89, C99. .SH SEE ALSO .BR gdb (1), .BR sigaction (2), @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abs.3 b/man3/abs.3 index 2157cbde4..74b6a8754 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acos.3 b/man3/acos.3 index 80746c41d..03aa8f6bb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acosh.3 b/man3/acosh.3 index bd4ee2f84..92a0c2a64 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/addseverity.3 b/man3/addseverity.3 index 82839ffe4..388eb3848 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/adjtime.3 b/man3/adjtime.3 index 7fe9d0970..4459fb840 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.06 of the Linux +This page is part of release 5.07 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 321a9300d..018b0a6c2 100644 --- a/man3/aio_cancel.3 +++ b/man3/aio_cancel.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH AIO_CANCEL 3 2015-03-02 "" "Linux Programmer's Manual" +.TH AIO_CANCEL 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME aio_cancel \- cancel an outstanding asynchronous I/O request .SH SYNOPSIS @@ -125,7 +125,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO @@ -138,7 +138,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 9de316aea..6e5613da5 100644 --- a/man3/aio_error.3 +++ b/man3/aio_error.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH AIO_ERROR 3 2015-03-02 "" "Linux Programmer's Manual" +.TH AIO_ERROR 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME aio_error \- get error status of asynchronous I/O operation .SH SYNOPSIS @@ -93,7 +93,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO @@ -106,7 +106,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 d39790b0f..f3f338249 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.06 of the Linux +This page is part of release 5.07 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 9cb621d5f..faad842b7 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.06 of the Linux +This page is part of release 5.07 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 f44fc9e71..00446b42b 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH AIO_READ 3 2017-09-15 "" "Linux Programmer's Manual" +.TH AIO_READ 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME aio_read \- asynchronous read .SH SYNOPSIS @@ -155,7 +155,7 @@ The memory areas involved must remain valid. Simultaneous I/O operations specifying the same .I aiocb structure produce undefined results. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO @@ -168,7 +168,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 12b68394b..6a443cb17 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH AIO_RETURN 3 2017-09-15 "" "Linux Programmer's Manual" +.TH AIO_RETURN 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME aio_return \- get return status of asynchronous I/O operation .SH SYNOPSIS @@ -89,7 +89,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO @@ -102,7 +102,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 cf939a071..f9e9d2948 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.06 of the Linux +This page is part of release 5.07 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 4ff0726cb..a7eb9f82c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/alloca.3 b/man3/alloca.3 index 86b5db0b6..588b3b98e 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.06 of the Linux +This page is part of release 5.07 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 43d623469..df7bb4d6a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asin.3 b/man3/asin.3 index be67759b7..4d67c16de 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asinh.3 b/man3/asinh.3 index ba4545972..6a7445c73 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asprintf.3 b/man3/asprintf.3 index 5e6d1bb5e..9ee4356c7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/assert.3 b/man3/assert.3 index b663ed3ef..caad0a337 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.06 of the Linux +This page is part of release 5.07 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 5aed63e33..4c971c071 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan.3 b/man3/atan.3 index 5b8ca6109..19129a1cd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan2.3 b/man3/atan2.3 index 4b25eb07b..f00893c78 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atanh.3 b/man3/atanh.3 index cd35d55b8..634ff2ead 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atexit.3 b/man3/atexit.3 index b31422def..851e3e80b 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -30,7 +30,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2003-10-25, Walter Harms .\" -.TH ATEXIT 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH ATEXIT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME atexit \- register a function to be called at normal process termination .SH SYNOPSIS @@ -143,7 +143,7 @@ Since glibc 2.2.3, .BR on_exit (3)) can be used within a shared library to establish functions that are called when the shared library is unloaded. -.SH EXAMPLE +.SH EXAMPLES .EX #include <stdio.h> #include <stdlib.h> @@ -179,7 +179,7 @@ main(void) .BR exit (3), .BR on_exit (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atof.3 b/man3/atof.3 index 10b429551..5c630ed84 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atoi.3 b/man3/atoi.3 index b35d7a6f8..ee7300803 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -121,7 +121,7 @@ only. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 3d9f95e77..d0aa3f201 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -24,7 +24,7 @@ .\" .\" References: .\" glibc manual and source -.TH BACKTRACE 3 2019-03-06 GNU "Linux Programmer's Manual" +.TH BACKTRACE 3 2020-06-09 GNU "Linux Programmer's Manual" .SH NAME backtrace, backtrace_symbols, backtrace_symbols_fd \- support for application self-debugging @@ -196,7 +196,7 @@ For systems using the GNU linker, it is necessary to use the linker option. Note that names of "static" functions are not exposed, and won't be available in the backtrace. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR backtrace () and @@ -289,7 +289,7 @@ main(int argc, char *argv[]) .BR dlopen (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/basename.3 b/man3/basename.3 index 7f5057057..0b047a913 100644 --- a/man3/basename.3 +++ b/man3/basename.3 @@ -24,7 +24,7 @@ .\" .\" Created, 14 Dec 2000 by Michael Kerrisk .\" -.TH BASENAME 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH BASENAME 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME basename, dirname \- parse pathname components .SH SYNOPSIS @@ -178,7 +178,7 @@ Before glibc 2.2.1, the glibc version of .BR dirname () did not correctly handle pathnames with trailing \(aq/\(aq characters, and generated a segfault if given a NULL argument. -.SH EXAMPLE +.SH EXAMPLES The following code snippet demonstrates the use of .BR basename () and @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcmp.3 b/man3/bcmp.3 index d4dd06a6f..bd9cded82 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 0b0fdfe33..68a09ac33 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bindresvport.3 b/man3/bindresvport.3 index 41dac0632..5c0b07b8e 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.06 of the Linux +This page is part of release 5.07 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 d37011f35..70b5bbb50 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bsearch.3 b/man3/bsearch.3 index e997fa29e..c0dfbb06a 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Mon Mar 29 22:41:16 1993, David Metcalfe .\" Modified Sat Jul 24 21:35:16 1993, Rik Faith (faith@cs.unc.edu) -.TH BSEARCH 3 2017-09-15 "" "Linux Programmer's Manual" +.TH BSEARCH 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME bsearch \- binary search of a sorted array .SH SYNOPSIS @@ -89,7 +89,7 @@ T} Thread safety MT-Safe .sp 1 .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. -.SH EXAMPLE +.SH EXAMPLES The example below first sorts an array of structures using .BR qsort (3), then retrieves desired elements using @@ -145,7 +145,7 @@ main(int argc, char **argv) .BR qsort (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bstring.3 b/man3/bstring.3 index 5f7ac9015..1339fa78f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bswap.3 b/man3/bswap.3 index 1bc28094f..2dc532db5 100644 --- a/man3/bswap.3 +++ b/man3/bswap.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH BSWAP 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH BSWAP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME bswap_16, bswap_32, bswap_64 \- reverse order of bytes .SH SYNOPSIS @@ -42,7 +42,7 @@ These macros return the value of their argument with the bytes reversed. These macros always succeed. .SH CONFORMING TO These macros are GNU extensions. -.SH EXAMPLE +.SH EXAMPLES The program below swaps the bytes of the 8-byte integer supplied as its command-line argument. The following shell session demonstrates the use of the program: @@ -82,7 +82,7 @@ main(int argc, char *argv[]) .BR byteorder (3), .BR endian (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btowc.3 b/man3/btowc.3 index 35ce9900a..de914a35c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btree.3 b/man3/btree.3 index c0a7980f2..9ab7accdb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/byteorder.3 b/man3/byteorder.3 index 71f736e29..18d3fb6b1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bzero.3 b/man3/bzero.3 index f483dd819..5750a44f3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cabs.3 b/man3/cabs.3 index 94a8cc3bf..506f0cea1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacos.3 b/man3/cacos.3 index 7b37d83ce..bc99e9200 100644 --- a/man3/cacos.3 +++ b/man3/cacos.3 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CACOS 3 2019-03-06 "" "Linux Programmer's Manual" +.TH CACOS 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME cacos, cacosf, cacosl \- complex arc cosine .SH SYNOPSIS @@ -49,7 +49,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ @@ -87,7 +87,7 @@ main(int argc, char *argv[]) .BR clog (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacosh.3 b/man3/cacosh.3 index 21a413cda..240fc74f2 100644 --- a/man3/cacosh.3 +++ b/man3/cacosh.3 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CACOSH 3 2019-03-06 "" "Linux Programmer's Manual" +.TH CACOSH 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME cacosh, cacoshf, cacoshl \- complex arc hyperbolic cosine .SH SYNOPSIS @@ -52,7 +52,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 d262752b7..e806bbe13 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/carg.3 b/man3/carg.3 index 41f9766aa..c1962dd1a 100644 --- a/man3/carg.3 +++ b/man3/carg.3 @@ -55,7 +55,7 @@ One has: tan(carg(z)) = cimag(z) / creal(z) .fi .SH RETURN VALUE -The return value is the range of [\-pi,pi]. +The return value is in the range of [\-pi,pi]. .SH VERSIONS These functions first appeared in glibc in version 2.1. .SH ATTRIBUTES @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casin.3 b/man3/casin.3 index 6d041993c..8524c25a4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casinh.3 b/man3/casinh.3 index ef4d27f2e..40044c953 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catan.3 b/man3/catan.3 index 555d7e550..cb4db44a2 100644 --- a/man3/catan.3 +++ b/man3/catan.3 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CATAN 3 2019-03-06 "" "Linux Programmer's Manual" +.TH CATAN 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME catan, catanf, catanl \- complex arc tangents .SH SYNOPSIS @@ -47,7 +47,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ @@ -84,7 +84,7 @@ main(int argc, char *argv[]) .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catanh.3 b/man3/catanh.3 index dd92c16fe..7758a40da 100644 --- a/man3/catanh.3 +++ b/man3/catanh.3 @@ -5,7 +5,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CATANH 3 2019-03-06 "" "Linux Programmer's Manual" +.TH CATANH 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME catanh, catanhf, catanhl \- complex arc tangents hyperbolic .SH SYNOPSIS @@ -49,7 +49,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ @@ -86,7 +86,7 @@ main(int argc, char *argv[]) .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catgets.3 b/man3/catgets.3 index c173ff2b8..a3da7c850 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catopen.3 b/man3/catopen.3 index 7e27aa304..a9d344b0b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cbrt.3 b/man3/cbrt.3 index 2ac44e045..ff802b3cd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccos.3 b/man3/ccos.3 index c0c151009..b9b53d40b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccosh.3 b/man3/ccosh.3 index 589e6e555..dad316e96 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ceil.3 b/man3/ceil.3 index c1ae8d9e2..14b284a47 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp.3 b/man3/cexp.3 index 56f53ee97..d7bca8562 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp2.3 b/man3/cexp2.3 index 4d2c1efa3..a8a8fae23 100644 --- a/man3/cexp2.3 +++ b/man3/cexp2.3 @@ -4,7 +4,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CEXP2 3 2014-08-19 "" "Linux Programmer's Manual" +.TH CEXP2 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME cexp2, cexp2f, cexp2l \- base-2 exponent of a complex number .SH SYNOPSIS @@ -22,8 +22,8 @@ The function returns 2 raised to the power of .IR z . .SH CONFORMING TO These function names are reserved for future use in C99. -.SH AVAILABILITY -Not yet in glibc, as at version 2.19. +.PP +As at version 2.31, these functions are not provided in glibc. .\" But reserved in NAMESPACE. .SH SEE ALSO .BR cabs (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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cfree.3 b/man3/cfree.3 index 15ce04a65..a67c1d4b0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cimag.3 b/man3/cimag.3 index fc99af7de..8e876d4c8 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clearenv.3 b/man3/clearenv.3 index 5fe6c669a..238d24c63 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clock.3 b/man3/clock.3 index 9761be062..e101e59e6 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.06 of the Linux +This page is part of release 5.07 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 f1b716000..8058a6ac1 100644 --- a/man3/clock_getcpuclockid.3 +++ b/man3/clock_getcpuclockid.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CLOCK_GETCPUCLOCKID 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH CLOCK_GETCPUCLOCKID 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME clock_getcpuclockid \- obtain ID of a process CPU-time clock .SH SYNOPSIS @@ -109,7 +109,7 @@ with a of 0, is the same as using the clock ID .BR CLOCK_PROCESS_CPUTIME_ID . -.SH EXAMPLE +.SH EXAMPLES The example program below obtains the CPU-time clock ID of the process whose ID is given on the command line, and then uses @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog.3 b/man3/clog.3 index fb8da1acd..9491aa50d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog10.3 b/man3/clog10.3 index 9b3665936..9d691b2d3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog2.3 b/man3/clog2.3 index 9c22388db..aaae9f9d5 100644 --- a/man3/clog2.3 +++ b/man3/clog2.3 @@ -4,7 +4,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CLOG2 3 2017-09-15 "" "Linux Programmer's Manual" +.TH CLOG2 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME clog2, clog2f, clog2l \- base-2 logarithm of a complex number .SH SYNOPSIS @@ -33,7 +33,7 @@ Note that close to zero will cause an overflow. .SH CONFORMING TO These function names are reserved for future use in C99. -.SH AVAILABILITY +.PP Not yet in glibc, as at version 2.19. .\" But reserved in NAMESPACE. .SH SEE ALSO @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/closedir.3 b/man3/closedir.3 index 4279ffd57..2d0119218 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cmsg.3 b/man3/cmsg.3 index e5506fcdb..4a6d4b2c0 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -8,7 +8,7 @@ .\" %%%LICENSE_END .\" .\" $Id: cmsg.3,v 1.8 2000/12/20 18:10:31 ak Exp $ -.TH CMSG 3 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH CMSG 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME CMSG_ALIGN, CMSG_SPACE, CMSG_NXTHDR, CMSG_FIRSTHDR \- access ancillary data .SH SYNOPSIS @@ -159,6 +159,17 @@ see .SH CONFORMING TO This ancillary data model conforms to the POSIX.1g draft, 4.4BSD-Lite, the IPv6 advanced API described in RFC\ 2292 and SUSv2. +.BR CMSG_FIRSTHDR (), +.BR CMSG_NXTHDR (), +and +.BR CMSG_DATA () +are specified in POSIX.1-2008. +.BR CMSG_SPACE () +and +.BR CMSG_LEN () +.\" https://www.austingroupbugs.net/view.php?id=978#c3242 +will be included in the next POSIX release (Issue 8). +.PP .BR CMSG_ALIGN () is a Linux extension. .SH NOTES @@ -175,7 +186,7 @@ and are constant expressions (assuming their argument is constant), meaning that these values can be used to declare the size of global variables. This may not be portable, however. -.SH EXAMPLE +.SH EXAMPLES This code looks for the .B IP_TTL option in a received ancillary buffer: @@ -240,7 +251,7 @@ memcpy(CMSG_DATA(cmsg), myfds, NUM_FD * sizeof(int)); .PP RFC\ 2292 .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/confstr.3 b/man3/confstr.3 index b42a4cb40..00545c6fe 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -30,7 +30,7 @@ .\" These should all be added to this page. .\" See also the POSIX.1-2001 specification of confstr() .\" -.TH CONFSTR 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH CONFSTR 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME confstr \- get configuration dependent string variables .SH SYNOPSIS @@ -140,7 +140,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES The following code fragment determines the path where to find the POSIX.2 system utilities: .PP @@ -165,7 +165,7 @@ confstr(_CS_PATH, pathbuf, n); .BR sysconf (3), .BR system (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/conj.3 b/man3/conj.3 index 14dbb8e8d..053c7ff63 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/copysign.3 b/man3/copysign.3 index 8eb548831..bbad3406f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cos.3 b/man3/cos.3 index 2f449af21..5dbb48a16 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cosh.3 b/man3/cosh.3 index 5b68eb274..6b4739d10 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cpow.3 b/man3/cpow.3 index 1b7379740..65331ac87 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cproj.3 b/man3/cproj.3 index c544e4496..d7a940384 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/creal.3 b/man3/creal.3 index 129fb460a..2e2f3185e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/crypt.3 b/man3/crypt.3 index 86d8cdc36..1c04c63c5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csin.3 b/man3/csin.3 index 56d2e33d8..86d39716f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csinh.3 b/man3/csinh.3 index 407309a18..e9b79937f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csqrt.3 b/man3/csqrt.3 index 13b95d577..e9a2b0f66 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctan.3 b/man3/ctan.3 index 8b46cf002..2becc72e1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctanh.3 b/man3/ctanh.3 index dec500e78..e32c6fda4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctermid.3 b/man3/ctermid.3 index 1a2e27b7d..03b268ba5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctime.3 b/man3/ctime.3 index 55d2459fc..f47d0587e 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -419,7 +419,7 @@ was set before including .IR <time.h> . This is a BSD extension, present in 4.3BSD-Reno. .PP -According to POSIX.1-2004, +According to POSIX.1-2001, .BR localtime () is required to behave as though .BR tzset (3) @@ -444,7 +444,7 @@ should be called before .BR tzset (3), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/daemon.3 b/man3/daemon.3 index 9ddaca42f..cc11871d9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dbopen.3 b/man3/dbopen.3 index 0f886231c..54dfe66bc 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.06 of the Linux +This page is part of release 5.07 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 3ad966181..6358c6455 100644 --- a/man3/des_crypt.3 +++ b/man3/des_crypt.3 @@ -127,9 +127,8 @@ is false only for the first two statuses. .\" So far the Sun page .\" Some additions - aeb .SH VERSIONS -These functions are present in -glibc 2.1 and later. -.SH VERSIONS +These functions were added to glibc in version 2.1. +.PP Because they employ the DES block cipher, which is no longer considered secure, .BR ecb_crypt (), @@ -162,7 +161,7 @@ Not in POSIX.1. .BR crypt (3), .BR xcrypt (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/difftime.3 b/man3/difftime.3 index fcf2278fc..224f81d20 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dirfd.3 b/man3/dirfd.3 index 0419fd377..dce72e60b 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -100,6 +100,7 @@ This function was a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD. .\" It is present in libc5 (since 5.1.2) and in glibc2. .SH SEE ALSO .BR open (2), +.BR openat (2), .BR closedir (3), .BR opendir (3), .BR readdir (3), @@ -108,7 +109,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/div.3 b/man3/div.3 index ef63ee82e..09d985018 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10, 2003-11-01 Walter Harms, aeb .\" -.TH DIV 3 2016-03-15 "" "Linux Programmer's Manual" +.TH DIV 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME div, ldiv, lldiv, imaxdiv \- compute quotient and remainder of an integer division @@ -104,7 +104,7 @@ The functions and .BR imaxdiv () were added in C99. -.SH EXAMPLE +.SH EXAMPLES After .PP .in +4n @@ -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.06 of the Linux +This page is part of release 5.07 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 9b461a237..e92dae9d8 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DL_ITERATE_PHDR 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH DL_ITERATE_PHDR 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME dl_iterate_phdr \- walk through list of shared objects .SH SYNOPSIS @@ -243,7 +243,7 @@ is the main program. For the main program, the .I dlpi_name field will be an empty string. -.SH EXAMPLE +.SH EXAMPLES The following program displays a list of pathnames of the shared objects it has loaded. For each shared object, the program lists some information @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dladdr.3 b/man3/dladdr.3 index e7b0cd86d..866ea6175 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlerror.3 b/man3/dlerror.3 index 49b73f22b..0d1f25fe4 100644 --- a/man3/dlerror.3 +++ b/man3/dlerror.3 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH DLERROR 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH DLERROR 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME dlerror \- obtain error diagnostic for functions in the dlopen API .SH SYNOPSIS @@ -81,7 +81,7 @@ calls. .\" .in .SS History This function is part of the dlopen API, derived from SunOS. -.SH EXAMPLE +.SH EXAMPLES See .BR dlopen (3). .SH SEE ALSO @@ -90,7 +90,7 @@ See .BR dlopen (3), .BR dlsym (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index 12cf2c37e..51638e332 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DLINFO 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH DLINFO 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME dlinfo \- obtain information about a dynamically loaded object .SH SYNOPSIS @@ -241,7 +241,7 @@ This function derives from the Solaris function of the same name and also appears on some other systems. The sets of requests supported by the various implementations overlaps only partially. -.SH EXAMPLE +.SH EXAMPLES The program below opens a shared objects using .BR dlopen (3) and then uses the @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 85a3a8ea5..22dd4e23f 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -32,7 +32,7 @@ .\" Modified by Walter Harms: dladdr, dlvsym .\" Modified by Petr Baudis <pasky@suse.cz>, 2008-12-04: dladdr caveat .\" -.TH DLOPEN 3 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH DLOPEN 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME dlclose, dlopen, dlmopen \- open and close a shared object @@ -194,7 +194,7 @@ If .I filename is NULL, then the returned handle is for the main program. When given to -.BR dlsym (), +.BR dlsym (3), this handle causes a search for a symbol in the main program, followed by all shared objects loaded at program startup, and then all shared objects loaded by @@ -541,9 +541,10 @@ when calling .BR dlopen () results in a program crash .RB ( SIGSEGV ) +.\" https://sourceware.org/bugzilla/show_bug.cgi?id=18684 if the call is made from any object loaded in a namespace other than the initial namespace. -.SH EXAMPLE +.SH EXAMPLES The program below loads the (glibc) math library, looks up the address of the .BR cos (3) @@ -584,7 +585,7 @@ main(void) /* According to the ISO C standard, casting between function pointers and 'void *', as done above, produces undefined results. - POSIX.1-2003 and POSIX.1-2008 accepted this state of affairs and + POSIX.1-2001 and POSIX.1-2008 accepted this state of affairs and proposed the following workaround: *(void **) (&cosine) = dlsym(handle, "cos"); @@ -592,11 +593,11 @@ main(void) This (clumsy) cast conforms with the ISO C standard and will avoid any compiler warnings. - The 2013 Technical Corrigendum to POSIX.1-2008 (a.k.a. - POSIX.1-2013) improved matters by requiring that conforming - implementations support casting 'void *' to a function pointer. - Nevertheless, some compilers (e.g., gcc with the '-pedantic' - option) may complain about the cast used in this program. */ + The 2013 Technical Corrigendum 1 to POSIX.1-2008 improved matters + by requiring that conforming implementations support casting + 'void *' to a function pointer. Nevertheless, some compilers + (e.g., gcc with the '-pedantic' option) may complain about the + cast used in this program. */ .\" http://pubs.opengroup.org/onlinepubs/009695399/functions/dlsym.html#tag_03_112_08 .\" http://pubs.opengroup.org/onlinepubs/9699919799/functions/dlsym.html#tag_16_96_07 .\" http://austingroupbugs.net/view.php?id=74 @@ -627,7 +628,7 @@ main(void) .PP gcc info pages, ld info pages .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlsym.3 b/man3/dlsym.3 index 35673757d..cdd736cf5 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH DLSYM 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH DLSYM 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME dlsym, dlvsym \- obtain address of a symbol in a shared object or executable .SH SYNOPSIS @@ -143,16 +143,22 @@ The .BR dlvsym () function is a GNU extension. .SH NOTES -The value of a symbol returned by +There are several scenarios when the address of a global symbol is NULL. +For example, a symbol can be placed at zero address by the linker, via +a linker script or with +.I --defsym +command-line option. Undefined weak symbols also have NULL value. +Finally, the symbol value may be the result of +a GNU indirect function (IFUNC) resolver function that returns +NULL as the resolved value. In the latter case, .BR dlsym () -will never be NULL if the shared object is the result of normal compilation, -since a global symbol is never placed at the NULL address. -There are nevertheless cases where a lookup using +also returns NULL without error. However, in the former two cases, the +behavior of GNU dynamic linker is inconsistent: relocation processing +succeeds and the symbol can be observed to have NULL value, but .BR dlsym () -may return NULL as the value of a symbol. -For example, the symbol value may be the result of -a GNU indirect function (IFUNC) resolver function that returns -NULL as the resolved value. +fails and +.BR dlerror () +indicates a lookup error. .\" .SS History The @@ -160,7 +166,7 @@ The function is part of the dlopen API, derived from SunOS. That system does not have .BR dlvsym (). -.SH EXAMPLE +.SH EXAMPLES See .BR dlopen (3). .SH SEE ALSO @@ -171,7 +177,7 @@ See .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/drand48.3 b/man3/drand48.3 index edd06d002..5c1097732 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.06 of the Linux +This page is part of release 5.07 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 0bc9db96f..891708cea 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/duplocale.3 b/man3/duplocale.3 index d1c774d69..14c870db4 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DUPLOCALE 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH DUPLOCALE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME duplocale \- duplicate a locale object .SH SYNOPSIS @@ -115,7 +115,7 @@ Each locale object created by .BR duplocale () should be deallocated using .BR freelocale (3). -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR uselocale (3) and @@ -186,7 +186,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dysize.3 b/man3/dysize.3 index c95f69cd9..1d8e0d0a8 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ecvt.3 b/man3/ecvt.3 index 237321d0e..5d5f5c490 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.06 of the Linux +This page is part of release 5.07 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 22bdcbcea..93e282c39 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/encrypt.3 b/man3/encrypt.3 index b7d73d81f..b95c5a96d 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -27,7 +27,7 @@ .\" .\" Modified 2003-04-04, aeb .\" -.TH ENCRYPT 3 2018-04-30 "" "Linux Programmer's Manual" +.TH ENCRYPT 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME encrypt, setkey, encrypt_r, setkey_r \- encrypt 64-bit messages .SH SYNOPSIS @@ -163,7 +163,7 @@ See .BR crypt (3). .SS Features in glibc In glibc 2.2, these functions use the DES algorithm. -.SH EXAMPLE +.SH EXAMPLES .EX #define _XOPEN_SOURCE #include <stdio.h> @@ -218,7 +218,7 @@ main(void) .BR ecb_crypt (3), .\" .BR fcrypt (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/end.3 b/man3/end.3 index 734e5c1d1..4e23d1e9a 100644 --- a/man3/end.3 +++ b/man3/end.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH END 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH END 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME etext, edata, end \- end of program segments .SH SYNOPSIS @@ -73,7 +73,7 @@ or Use .BR sbrk (2) with an argument of zero to find the current value of the program break. -.SH EXAMPLE +.SH EXAMPLES When run, the program below produces output such as the following: .PP .in +4n @@ -111,7 +111,7 @@ main(int argc, char *argv[]) .BR sbrk (2), .BR elf (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/endian.3 b/man3/endian.3 index de692e5be..80810f0d9 100644 --- a/man3/endian.3 +++ b/man3/endian.3 @@ -25,7 +25,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH ENDIAN 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH ENDIAN 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME htobe16, htole16, be16toh, le16toh, htobe32, htole32, be32toh, le32toh, htobe64, htole64, be64toh, le64toh \- @@ -127,7 +127,7 @@ on all UNIX systems. On the other hand, the fact that they were designed for use in the context of TCP/IP means that they lack the 64-bit and little-endian variants described in this page. -.SH EXAMPLE +.SH EXAMPLES The program below display the results of converting an integer from host byte order to both little-endian and big-endian byte order. Since host byte order is either little-endian or big-endian, @@ -175,7 +175,7 @@ main(int argc, char *argv[]) .BR bswap (3), .BR byteorder (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 0d122a213..7d04f478e 100644 --- a/man3/envz_add.3 +++ b/man3/envz_add.3 @@ -7,7 +7,7 @@ .\" based on the description in glibc source and infopages .\" .\" Corrections and additions, aeb -.TH ENVZ_ADD 3 2017-09-15 "" "Linux Programmer's Manual" +.TH ENVZ_ADD 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip \- environment string support @@ -138,7 +138,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO These functions are a GNU extension. Handle with care. -.SH EXAMPLE +.SH EXAMPLES .EX #include <stdio.h> #include <stdlib.h> @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erf.3 b/man3/erf.3 index 075e281e8..127a37b4a 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -34,7 +34,7 @@ .\" .TH ERF 3 2017-09-15 "GNU" "Linux Programmer's Manual" .SH NAME -erf, erff, erfl, \- error function +erf, erff, erfl \- error function .SH SYNOPSIS .nf .B #include <math.h> @@ -72,9 +72,9 @@ These functions return the error function of .IR x , defined as .TP - erf(x) = 2/sqrt(pi)* integral from 0 to x of exp(\-t*t) dt + erf(x) = 2/sqrt(pi) * integral from 0 to x of exp(\-t*t) dt .SH RETURN VALUE -On success, these functions return the error function of +On success, these functions return the value of the error function of .IR x , a value in the range [\-1,\ 1]. .PP @@ -114,8 +114,8 @@ is raised. .PP These functions do not set .IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 +.\" It is intentional that these functions do not set errno for this case +.\" see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -142,7 +142,7 @@ SVr4, 4.3BSD. .BR erfc (3), .BR exp (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erfc.3 b/man3/erfc.3 index 4469ff84a..2f9520f56 100644 --- a/man3/erfc.3 +++ b/man3/erfc.3 @@ -111,8 +111,8 @@ is raised. .PP These functions do not set .IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 +.\" It is intentional that these functions do not set errno for this case +.\" see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/err.3 b/man3/err.3 index 789f11ae1..c72a6b166 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -36,7 +36,7 @@ .\" .\" 2011-09-10, mtk, Converted from mdoc to man macros .\" -.TH ERR 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH ERR 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME err, verr, errx, verrx, warn, vwarn, warnx, vwarnx \- formatted error messages .SH SYNOPSIS @@ -138,7 +138,7 @@ These functions are nonstandard BSD extensions. .\" .BR warn () .\" functions first appeared in .\" 4.4BSD. -.SH EXAMPLE +.SH EXAMPLES Display the current .I errno information string and exit: @@ -147,10 +147,10 @@ information string and exit: .EX p = malloc(size); if (p == NULL) - err(1, NULL); + err(EXIT_FAILURE, NULL); fd = open(file_name, O_RDONLY, 0); if (fd == \-1) - err(1, "%s", file_name); + err(EXIT_FAILURE, "%s", file_name); .EE .in .PP @@ -159,7 +159,8 @@ Display an error message and exit: .in +4n .EX if (tm.tm_hour < START_TIME) - errx(1, "too early, wait until %s", start_time_string); + errx(EXIT_FAILURE, "too early, wait until %s", + start_time_string); .EE .in .PP @@ -173,7 +174,7 @@ if (fd == \-1) raw_device, strerror(errno)); fd = open(block_device, O_RDONLY, 0); if (fd == \-1) - err(1, "%s", block_device); + err(EXIT_FAILURE, "%s", block_device); .EE .in .SH SEE ALSO @@ -183,7 +184,7 @@ if (fd == \-1) .BR printf (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/errno.3 b/man3/errno.3 index cacec499f..d740cf6d4 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -165,6 +165,7 @@ but was not present in earlier POSIX.1 standards. .IP * .IR C99 : The name is defined by C99. +.PP Below is a list of the symbolic error names that are defined on Linux: .TP 16 .B E2BIG @@ -649,7 +650,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/error.3 b/man3/error.3 index e6f37fd33..1c8f5f147 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.06 of the Linux +This page is part of release 5.07 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 b5413f860..19816119e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index 7d80a5199..e92abed3a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exec.3 b/man3/exec.3 index a37d60dad..6ea7b5edd 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -71,7 +71,7 @@ The .BR exec () family of functions replaces the current process image with a new process image. -The functions described in this manual page are front-ends for +The functions described in this manual page are layered on top of .BR execve (2). (See the manual page for .BR execve (2) @@ -301,7 +301,7 @@ wrapper function on those architectures. .BR system (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exit.3 b/man3/exit.3 index 68e308cc5..c4bb8d4f2 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -39,7 +39,7 @@ exit \- cause normal process termination The .BR exit () function causes normal process termination and the least significant byte of -.I status +.I status (i.e., \fIstatus & 0xFF\fP) is returned to the parent (see .BR wait (2)). .PP @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp.3 b/man3/exp.3 index 181cca2e1..fc41f5dc9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp10.3 b/man3/exp10.3 index 6e36898a6..3d3195ec9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp2.3 b/man3/exp2.3 index 37f7610e0..eb17b8729 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/expm1.3 b/man3/expm1.3 index cc4c4a600..f1d102627 100644 --- a/man3/expm1.3 +++ b/man3/expm1.3 @@ -27,7 +27,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH EXPM1 3 2017-09-15 "" "Linux Programmer's Manual" +.TH EXPM1 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME expm1, expm1f, expm1l \- exponential minus 1 .SH SYNOPSIS @@ -144,24 +144,25 @@ T} Thread safety MT-Safe C99, POSIX.1-2001, POSIX.1-2008. .\" BSD. .SH BUGS -For some large negative +Before glibc 2.17, +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778 +on certain architectures (e.g., x86, but not x86_64) +.BR expm1 () +raised a bogus underflow floating-point exception +for some large negative .I x values (where the function result approaches \-1), -.BR expm1 () -raises a bogus underflow floating-point exception. -.\" FIXME . -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778 .PP -For some large positive -.I x -values, -.BR expm1 () -raises a bogus invalid floating-point exception in addition to the expected -overflow exception, and returns a NaN instead of positive infinity. -.\" FIXME . -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814 +Before approximately glibc version 2.11, +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814 .\" e.g., expm1(1e5) through expm1(1.00199970127e5), .\" but not expm1(1.00199970128e5) and beyond. +.BR expm1 () +raised a bogus invalid floating-point exception in addition to the expected +overflow exception, and returned a NaN instead of positive infinity. +for some large positive +.I x +values, .PP Before version 2.11, .\" It looks like the fix was in 2.11, or possibly 2.12. @@ -179,7 +180,7 @@ when a range error occurred. .BR log (3), .BR log1p (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fabs.3 b/man3/fabs.3 index a91c264a2..323f47e14 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fclose.3 b/man3/fclose.3 index ce3e471c9..04a96a637 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fcloseall.3 b/man3/fcloseall.3 index 03e6a1743..51f4aea14 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fdim.3 b/man3/fdim.3 index 3d961f4cc..16fe0070a 100644 --- a/man3/fdim.3 +++ b/man3/fdim.3 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FDIM 3 2017-09-15 "" "Linux Programmer's Manual" +.TH FDIM 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME fdim, fdimf, fdiml \- positive difference .SH SYNOPSIS @@ -61,17 +61,13 @@ when calling these functions. The following errors can occur: .TP Range error: result overflow -.\" .I errno -.\" is set to -.\" .BR ERANGE . +.I errno +is set to +.BR ERANGE . An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. .PP -These functions do not set -.IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796 .SH VERSIONS These functions first appeared in glibc in version 2.1. .SH ATTRIBUTES @@ -90,10 +86,16 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. +.SH BUGS +Before glibc version 2.24 +.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6796 +on certain architectures (e.g., x86, but not x86_64) +these functions did not set +.IR errno . .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fenv.3 b/man3/fenv.3 index 84eeaada8..365ad62e4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ferror.3 b/man3/ferror.3 index 47fece199..f75938350 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fexecve.3 b/man3/fexecve.3 index ef9a262de..385a142f9 100644 --- a/man3/fexecve.3 +++ b/man3/fexecve.3 @@ -196,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fflush.3 b/man3/fflush.3 index 1c8eff0b9..74cbc997e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ffs.3 b/man3/ffs.3 index b9775fd6d..9b36c8e52 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetc.3 b/man3/fgetc.3 index 394ee0ae6..0e94e812a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 7a80430d5..7c4e0a9d2 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index 0493f8549..2f75254bf 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetwc.3 b/man3/fgetwc.3 index 8737facd4..f0fe55c74 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetws.3 b/man3/fgetws.3 index c6cd09ca1..187fe4c93 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/finite.3 b/man3/finite.3 index e5007fae7..5feea42b4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/flockfile.3 b/man3/flockfile.3 index e3684bc2d..5641003a0 100644 --- a/man3/flockfile.3 +++ b/man3/flockfile.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FLOCKFILE 3 2017-07-13 "" "Linux Programmer's Manual" +.TH FLOCKFILE 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME flockfile, ftrylockfile, funlockfile \- lock FILE for stdio .SH SYNOPSIS @@ -139,14 +139,14 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH AVAILABILITY +.PP These functions are available when .B _POSIX_THREAD_SAFE_FUNCTIONS is defined. .SH SEE ALSO .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/floor.3 b/man3/floor.3 index 0cb283c25..260a1610e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fma.3 b/man3/fma.3 index c15dbb290..0dc472691 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmax.3 b/man3/fmax.3 index 036085ee1..98d1bfc52 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index ef4fbdef6..d0d414d30 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -278,7 +278,7 @@ silently changed the ABI: previously, .BR fmemopen () ignored \(aqb\(aq in .IR mode . -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR fmemopen () to open an input buffer, and @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmin.3 b/man3/fmin.3 index 87c81e4e1..8cf3947a7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmod.3 b/man3/fmod.3 index 836b16178..250866f5a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index 092e64857..b058050f9 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -10,7 +10,7 @@ .\" The function is quite complex and deserves an example .\" .\" Polished, aeb, 2003-11-01 -.TH FMTMSG 3 2017-09-15 "" "Linux Programmer's Manual" +.TH FMTMSG 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME fmtmsg \- print formatted error messages .SH SYNOPSIS @@ -266,7 +266,7 @@ are described in POSIX.1-2001 and POSIX.1-2008. System V and UnixWare man pages tell us that these functions have been replaced by "pfmt() and addsev()" or by "pfmt(), vpfmt(), lfmt(), and vlfmt()", and will be removed later. -.SH EXAMPLE +.SH EXAMPLES .EX #include <stdio.h> #include <stdlib.h> @@ -330,7 +330,7 @@ TO FIX: See mount(8). .BR addseverity (3), .BR perror (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 8ec7be50a..3b9d96691 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopen.3 b/man3/fopen.3 index c2d6ae707..65531e644 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 6c40c6bb7..85c3c5e32 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -256,7 +256,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO This function is a nonstandard GNU extension. -.SH EXAMPLE +.SH EXAMPLES The program below implements a custom stream whose functionality is similar (but not identical) to that available via .BR fmemopen (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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index 0e8e6d7ea..e13e05f20 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpclassify.3 b/man3/fpclassify.3 index b525b8589..46ed38435 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpurge.3 b/man3/fpurge.3 index e6bc9b951..fd563c279 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputwc.3 b/man3/fputwc.3 index cbbefe77a..93df42bc1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputws.3 b/man3/fputws.3 index 6b3b797b3..252c77676 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fread.3 b/man3/fread.3 index a303cdd8e..49eb1f346 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/frexp.3 b/man3/frexp.3 index 3e5800b69..91edbf899 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -30,7 +30,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH FREXP 3 2019-03-06 "" "Linux Programmer's Manual" +.TH FREXP 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME frexp, frexpf, frexpl \- convert floating-point number to fractional and integral components @@ -118,7 +118,7 @@ The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH EXAMPLE +.SH EXAMPLES The program below produces results such as the following: .PP .in +4n @@ -155,7 +155,7 @@ main(int argc, char *argv[]) .BR ldexp (3), .BR modf (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseek.3 b/man3/fseek.3 index fc7c37b45..e0df7e744 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseeko.3 b/man3/fseeko.3 index 0620d04ce..436d9cd46 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftime.3 b/man3/ftime.3 index fa705a0be..438b9bdd1 100644 --- a/man3/ftime.3 +++ b/man3/ftime.3 @@ -115,7 +115,7 @@ glibc 2.1.1 is correct again. .BR gettimeofday (2), .BR time (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftok.3 b/man3/ftok.3 index 41e555c99..44f336219 100644 --- a/man3/ftok.3 +++ b/man3/ftok.3 @@ -112,7 +112,7 @@ Collisions may easily happen, for example between files on .I /dev/hda1 and files on .IR /dev/sda1 . -.SH EXAMPLE +.SH EXAMPLES See .BR semget (2). .SH SEE ALSO @@ -122,7 +122,7 @@ See .BR stat (2), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fts.3 b/man3/fts.3 index 22fb086a3..4b43f96a0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftw.3 b/man3/ftw.3 index 628a10f9a..11819feb4 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -33,7 +33,7 @@ .\" 2006-05-24, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added an example program. .\" -.TH FTW 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH FTW 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ftw, nftw \- file tree walk .SH SYNOPSIS @@ -173,14 +173,14 @@ is a symbolic link, and \fBFTW_PHYS\fP was set in \fIflags\fP. .I fpath is a symbolic link pointing to a nonexistent file. (This occurs only if \fBFTW_PHYS\fP is not set.) -On most implementations, in this case the +In this case the .I sb argument passed to .IR fn () contains information returned by performing .BR lstat (2) -on the symbolic link. -For the details on Linux, see BUGS. +on the "dangling" symbolic link. +(But see BUGS.) .PP The fourth argument .RI ( ftwbuf ) @@ -417,45 +417,33 @@ is passed in For predictable results, use .BR nftw (). .SH BUGS -In the specification of -.BR nftw (), -POSIX.1 notes that when -.B FTW_NS -is passed as the -.I typeflag -argument of -.IR fn (), -then the contents of the buffer pointed to by the -.I sb -argument are undefined. -The standard makes no such statement for the case where -.B FTW_SLN -is passed in -.IR typeflag , -with the implication that the contents of the buffer pointed to by -.I sb -are defined. -And indeed this is the case on most implementations: the buffer pointed to by +According to POSIX.1-2008, when the +.IR typeflag +argument passed to +.IR fn () +contains +.BR FTW_SLN , +the buffer pointed to by .I sb -contains the results produced by applying +should contain information about the dangling symbolic link +(obtained by calling .BR lstat (2) -to the symbolic link. -In early glibc, the behavior was the same. -However, since glibc 2.4, the contents of the buffer pointed to by +on the link). +Early glibc versions correctly followed the POSIX specification on this point. +However, as a result of a regression introduced in glibc 2.4, +the contents of the buffer pointed to by .I sb -are undefined when +were undefined when .B FTW_SLN is passed in .IR typeflag . -This change -.I appears -to be an unintended regression, -but it is not (yet) clear if the behavior will be restored to that -provided in the original glibc implementation (and on other implementations). -.\" FIXME . +(More precisely, the contents of the buffer were left unchanged in this case.) +This regression was eventually fixed in glibc 2.30, .\" https://bugzilla.redhat.com/show_bug.cgi?id=1422736 .\" http://austingroupbugs.net/view.php?id=1121 -.SH EXAMPLE +.\" https://bugzilla.redhat.com/show_bug.cgi?id=1422736 +so that the glibc implementation (once more) follows the POSIX specification. +.SH EXAMPLES The following program traverses the directory tree under the path named in its first command-line argument, or under the current directory if no argument is supplied. @@ -520,7 +508,7 @@ main(int argc, char *argv[]) .BR fts (3), .BR readdir (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/futimes.3 b/man3/futimes.3 index b2e63a339..d109fa51d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fwide.3 b/man3/fwide.3 index d240035ec..0961bd021 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gamma.3 b/man3/gamma.3 index 578735fae..a763d1e1b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gcvt.3 b/man3/gcvt.3 index df9d5eef4..c17d5d94e 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -71,8 +71,8 @@ F format or E format. .SH RETURN VALUE The .BR gcvt () -function returns the address of the string pointed to -by \fIbuf\fP. +function returns +\fIbuf\fP. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -100,7 +100,7 @@ may be preferable). .BR fcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 75361ef06..325d7bc56 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GET_NPROCS 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GET_NPROCS 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME get_nprocs, get_nprocs_conf \- get number of processors .SH SYNOPSIS @@ -81,7 +81,7 @@ np = sysconf(_SC_NPROCESSORS_CONF); /* processors configured */ np = sysconf(_SC_NPROCESSORS_ONLN); /* processors available */ .EE .in -.SH EXAMPLE +.SH EXAMPLES The following example shows how .BR get_nprocs () and @@ -105,7 +105,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR nproc (1) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 1739018c4..e5f6d4183 100644 --- a/man3/get_phys_pages.3 +++ b/man3/get_phys_pages.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GET_PHYS_PAGES 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GET_PHYS_PAGES 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME get_phys_pages, get_avphys_pages \- get total and available physical page counts @@ -76,7 +76,7 @@ total_pages = sysconf(_SC_PHYS_PAGES); /* total pages */ avl_pages = sysconf(_SC_AVPHYS_PAGES); /* available pages */ .EE .in -.SH EXAMPLE +.SH EXAMPLES The following example shows how .BR get_phys_pages () and @@ -100,7 +100,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR sysconf (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index dfa70a06a..8e377d5d7 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -637,7 +637,7 @@ The GNU C library instead assumes a value of .BR "(AI_V4MAPPED\ |\ AI_ADDRCONFIG)" for this case, since this value is considered an improvement on the specification. -.SH EXAMPLE +.SH EXAMPLES .\" getnameinfo.3 refers to this example .\" socket.2 refers to this example .\" bind.2 refers to this example @@ -853,7 +853,7 @@ main(int argc, char *argv[]) .BR hostname (7), .BR ip (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 2be5dafdf..bbd61357d 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -27,7 +27,7 @@ .\" References: http://people.redhat.com/drepper/asynchnl.pdf, .\" http://www.imperialviolet.org/2005/06/01/asynchronous-dns-lookups-with-glibc.html .\" -.TH GETADDRINFO_A 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETADDRINFO_A 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getaddrinfo_a, gai_suspend, gai_error, gai_cancel \- asynchronous network address and service translation @@ -328,7 +328,7 @@ The interface of was modeled after the .BR lio_listio (3) interface. -.SH EXAMPLE +.SH EXAMPLES Two examples are provided: a simple example that resolves several requests in parallel synchronously, and a complex example showing some of the asynchronous capabilities. @@ -622,7 +622,7 @@ main(int argc, char *argv[]) .BR ip (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getauxval.3 b/man3/getauxval.3 index c85956718..8649ab875 100644 --- a/man3/getauxval.3 +++ b/man3/getauxval.3 @@ -24,7 +24,7 @@ .\" .\" See also https://lwn.net/Articles/519085/ .\" -.TH GETAUXVAL 3 2019-10-10 "GNU" "Linux Programmer's Manual" +.TH GETAUXVAL 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getauxval \- retrieve a value from the auxiliary vector .SH SYNOPSIS @@ -60,9 +60,12 @@ values are present on all architectures. The base address of the program interpreter (usually, the dynamic linker). .TP .BR AT_BASE_PLATFORM -A pointer to a string identifying the real platform; may differ from -.BR AT_PLATFORM -(PowerPC only). +A pointer to a string (PowerPC and MIPS only). +On PowerPC, this identifies the real platform; may differ from +.BR AT_PLATFORM "." +On MIPS, +.\" commit e585b768da111f2c2d413de6214e83bbdfee8f22 +this identifies the ISA level (since Linux 5.7). .TP .BR AT_CLKTCK The frequency with which @@ -283,7 +286,7 @@ was zero. .BR vdso (7), .BR ld-linux.so (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcontext.3 b/man3/getcontext.3 index d41f15ce4..6de05e73f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcwd.3 b/man3/getcwd.3 index d93775b45..3a1569478 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdate.3 b/man3/getdate.3 index c8a29b76d..a6fd71e3b 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -27,7 +27,7 @@ .\" Modified, 2001-12-26, aeb .\" 2008-09-07, mtk, Various rewrites; added an example program. .\" -.TH GETDATE 3 2019-03-06 "" "Linux Programmer's Manual" +.TH GETDATE 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME getdate, getdate_r \- convert a date-plus-time string to broken-down time .SH SYNOPSIS @@ -227,7 +227,7 @@ In glibc, is implemented using .BR strptime (3), so that precisely the same conversions are supported by both. -.SH EXAMPLE +.SH EXAMPLES The program below calls .BR getdate () for each of its command-line arguments, @@ -323,7 +323,7 @@ main(int argc, char *argv[]) .BR strftime (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 6d0ac0406..329f4ae2f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdtablesize.3 b/man3/getdtablesize.3 index d58d21796..1566d2780 100644 --- a/man3/getdtablesize.3 +++ b/man3/getdtablesize.3 @@ -24,7 +24,7 @@ .\" .\" Modified 2002-04-15 by Roger Luethi <rl@hellgate.ch> and aeb .\" -.TH GETDTABLESIZE 3 2016-03-15 "Linux" "Linux Programmer's Manual" +.TH GETDTABLESIZE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME getdtablesize \- get file descriptor table size .SH SYNOPSIS @@ -88,9 +88,9 @@ portable applications should employ .I sysconf(_SC_OPEN_MAX) instead of this call. .SH NOTES +The glibc version of .BR getdtablesize () -is implemented as a libc library function. -The glibc version calls +calls .BR getrlimit (2) and returns the current .B RLIMIT_NOFILE @@ -106,7 +106,7 @@ when that fails. .BR getrlimit (2), .BR open (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getentropy.3 b/man3/getentropy.3 index 9287e156f..8db75537b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getenv.3 b/man3/getenv.3 index d72da0196..0d5e522e0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getfsent.3 b/man3/getfsent.3 index 933fcf9aa..b23e00820 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 9553e13f0..34caa0114 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.06 of the Linux +This page is part of release 5.07 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 59fb90667..a54551766 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH GETGRENT_R 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH GETGRENT_R 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getgrent_r, fgetgrent_r \- get group file entry reentrantly .SH SYNOPSIS @@ -136,9 +136,9 @@ In the above table, in .I race:grent signifies that if any of the functions -.BR setgrent (), -.BR getgrent (), -.BR endgrent (), +.BR setgrent (3), +.BR getgrent (3), +.BR endgrent (3), or .BR getgrent_r () are used in parallel in different threads of a program, @@ -169,7 +169,7 @@ The function .BR getgrent_r () is not really reentrant since it shares the reading position in the stream with all other threads. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include <grp.h> @@ -218,7 +218,7 @@ main(void) .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index eda3c0e49..09f6d0730 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index 5815d347b..9d5e0cc90 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -26,7 +26,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETGROUPLIST 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETGROUPLIST 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getgrouplist \- get list of groups to which a user belongs .SH SYNOPSIS @@ -121,7 +121,7 @@ in the array .IR groups , even when the number of groups exceeds .IR *ngroups . -.SH EXAMPLE +.SH EXAMPLES .PP The program below displays the group list for the user named in its first command-line argument. @@ -209,7 +209,7 @@ main(int argc, char *argv[]) .BR group (5), .BR passwd (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 8f73ff440..a32d0211a 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -35,7 +35,7 @@ .\" Modified 2002-08-05, Michael Kerrisk .\" Modified 2004-10-31, Andries Brouwer .\" -.TH GETHOSTBYNAME 3 2017-09-15 "" "Linux Programmer's Manual" +.TH GETHOSTBYNAME 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, @@ -239,7 +239,7 @@ rely on the Name Service Switch configured sources or a local name server .RB ( named (8)). The default action is to query the Name Service Switch -.RB ( nsswitch.conf(5)) +.RB ( nsswitch.conf (5)) configured sources, failing that, a local name server .RB ( named (8)). .\" @@ -549,7 +549,7 @@ that are expressed in hexadecimal. .BR named (8) .\" .BR resolv+ (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostid.3 b/man3/gethostid.3 index 9e0aab71f..18b72fb93 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 4496d125f..c639be436 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -218,7 +218,7 @@ defined in defined in .IR <linux/netdevice.h> ), which contains various interface attributes and statistics. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR getifaddrs (), .BR freeifaddrs (), @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index 097a75db7..b39202f69 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getline.3 b/man3/getline.3 index 24ceeb84b..02d743657 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETLINE 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETLINE 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getline, getdelim \- delimited string input .SH SYNOPSIS @@ -158,7 +158,7 @@ and .BR getdelim () were originally GNU extensions. They were standardized in POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include <stdio.h> @@ -200,7 +200,7 @@ main(int argc, char *argv[]) .BR fread (3), .BR scanf (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getloadavg.3 b/man3/getloadavg.3 index fc6bb5983..4b52fcfb7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getlogin.3 b/man3/getlogin.3 index 8729f0f31..03814eab9 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -248,7 +248,7 @@ what you meant. .BR getuid (2), .BR utmp (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 7f4ae514c..f5b999b92 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -239,7 +239,8 @@ T} Thread safety MT-Safe locale The nonreentrant functions are from SunOS 4.1.3. A routine .BR getmntent_r () -was introduced in HP-UX 10, but it returns an int. +was introduced in HP-UX 10, but it returns an +.IR int . The prototype shown above is glibc-only. .SH NOTES System V also has a @@ -258,7 +259,7 @@ a wrapper around the system call .BR fstab (5), .BR mount (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index ea9acaddb..f92a659d9 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -7,7 +7,7 @@ .\" 2004-12-14, mtk, Added EAI_OVERFLOW error .\" 2004-12-14 Fixed description of error return .\" -.TH GETNAMEINFO 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETNAMEINFO 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getnameinfo \- address-to-name translation in protocol-independent manner .SH SYNOPSIS @@ -109,7 +109,7 @@ If set, then the numeric form of the hostname is returned. .\" .BR gethostbyaddr (). (When not set, this will still happen in case the node's name cannot be determined.) -.\" POSIX.1-2003 has NI_NUMERICSCOPE, but glibc doesn't have it. +.\" POSIX.1-2001 TC1 has NI_NUMERICSCOPE, but glibc doesn't have it. .TP .B NI_NUMERICSERV If set, then the numeric form of the service address is returned. @@ -258,7 +258,7 @@ and .I servlen arguments were typed as .IR size_t . -.SH EXAMPLE +.SH EXAMPLES The following code tries to get the numeric hostname and service name, for a given socket address. Note that there is no hardcoded reference to @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnetent.3 b/man3/getnetent.3 index e928e4f2e..970c6eeef 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.06 of the Linux +This page is part of release 5.07 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 58c2a6610..4898d286b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getopt.3 b/man3/getopt.3 index 71791205a..8bdf1359a 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -39,7 +39,7 @@ .\" the start of optstring .\" Modified 2006-12-15, mtk, Added getopt() example program. .\" -.TH GETOPT 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETOPT 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getopt, getopt_long, getopt_long_only, optarg, optind, opterr, optopt \- Parse command-line options @@ -350,10 +350,10 @@ provided the environment variable is set. Otherwise, the elements of \fIargv\fP aren't really .IR const , -because we permute them. -We pretend they're +because these functions permute them. +Nevertheless, .I const -in the prototype to be compatible with other systems. +is used in the prototype to be compatible with other systems. .IP The use of \(aq+\(aq and \(aq\-\(aq in .I optstring @@ -394,7 +394,7 @@ routine that rechecks .B POSIXLY_CORRECT and checks for GNU extensions in .IR optstring .) -.SH EXAMPLE +.SH EXAMPLES .SS getopt() The following trivial example program uses .BR getopt () @@ -538,7 +538,7 @@ main(int argc, char **argv) .BR getopt (1), .BR getsubopt (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpass.3 b/man3/getpass.3 index 247c07883..f93dfcadd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index 8dd653b54..7d906d2a8 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.06 of the Linux +This page is part of release 5.07 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 8d5f4f9e4..1d3cb4270 100644 --- a/man3/getprotoent_r.3 +++ b/man3/getprotoent_r.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETPROTOENT_R 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETPROTOENT_R 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getprotoent_r, getprotobyname_r, getprotobynumber_r \- get protocol entry (reentrant) @@ -150,7 +150,7 @@ T} Thread safety MT-Safe locale These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR getprotobyname_r () to retrieve the protocol record for the protocol named @@ -256,7 +256,7 @@ main(int argc, char *argv[]) .BR getprotoent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpt.3 b/man3/getpt.3 index e1c10eea5..6d55eb9ca 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpw.3 b/man3/getpw.3 index 28853b321..f8b6242b5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwent.3 b/man3/getpwent.3 index ac42d069f..47d9b5ab5 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.06 of the Linux +This page is part of release 5.07 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 62490ccc2..fcc17101c 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH GETPWENT_R 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH GETPWENT_R 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getpwent_r, fgetpwent_r \- get passwd file entry reentrantly .SH SYNOPSIS @@ -174,7 +174,7 @@ The function .BR getpwent_r () is not really reentrant since it shares the reading position in the stream with all other threads. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include <pwd.h> @@ -218,7 +218,7 @@ main(void) .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index fe8bab27b..94a41ff4e 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -34,7 +34,7 @@ .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" -.TH GETPWNAM 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETPWNAM 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH SYNOPSIS @@ -275,7 +275,7 @@ To determine the (initial) home directory of another user, it is necessary to use .I getpwnam("username")\->pw_dir or similar. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR getpwnam_r () to find the full username and user ID for the username @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index c9bc392e4..3444d1146 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -131,7 +131,7 @@ to be saved. .BR rpcinfo (8), .BR ypserv (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 7e803604f..435a249a9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcport.3 b/man3/getrpcport.3 index 82169888a..d4300612b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gets.3 b/man3/gets.3 index 215b389d2..f3152e770 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getservent.3 b/man3/getservent.3 index 78fe10988..aa74cdd7c 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.06 of the Linux +This page is part of release 5.07 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 94f889a40..1bb424fb8 100644 --- a/man3/getservent_r.3 +++ b/man3/getservent_r.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETSERVENT_R 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETSERVENT_R 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getservent_r, getservbyname_r, getservbyport_r \- get service entry (reentrant) @@ -148,7 +148,7 @@ T} Thread safety MT-Safe locale These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR getservbyport_r () to retrieve the service record for the port and protocol named @@ -259,7 +259,7 @@ main(int argc, char *argv[]) .BR getservent (3), .BR services (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getspnam.3 b/man3/getspnam.3 index b22a3d720..c69299b5c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getsubopt.3 b/man3/getsubopt.3 index b73b04d8b..cf1f2caea 100644 --- a/man3/getsubopt.3 +++ b/man3/getsubopt.3 @@ -22,7 +22,7 @@ .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" %%%LICENSE_END .\" -.TH GETSUBOPT 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GETSUBOPT 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME getsubopt \- parse suboption arguments from a string .SH SYNOPSIS @@ -149,7 +149,7 @@ Since overwrites any commas it finds in the string .IR *optionp , that string must be writable; it cannot be a string constant. -.SH EXAMPLE +.SH EXAMPLES The following program expects suboptions following a "\-o" option. .PP .EX @@ -241,7 +241,7 @@ main(int argc, char **argv) .SH SEE ALSO .BR getopt (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getttyent.3 b/man3/getttyent.3 index a87a38710..119954e22 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getumask.3 b/man3/getumask.3 index 6f430b401..e263c9c00 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getusershell.3 b/man3/getusershell.3 index c2392e624..ea3e2dd98 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutent.3 b/man3/getutent.3 index f2e231cd5..143a991b8 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -28,7 +28,7 @@ .\" Modified Thu Jul 25 14:43:46 MET DST 1996 by Michael Haardt .\" <michael@cantor.informatik.rwth-aachen.de> .\" -.TH GETUTENT 3 2019-08-02 "" "Linux Programmer's Manual" +.TH GETUTENT 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- access utmp file entries @@ -307,7 +307,7 @@ On success, they return 0, and a pointer to the result is written in On error, these functions return \-1. There are no utmpx equivalents of the above functions. (POSIX.1 does not specify such functions.) -.SH EXAMPLE +.SH EXAMPLES The following example adds and removes a utmp record, assuming it is run from within a pseudo terminal. For usage in a real application, you @@ -362,7 +362,7 @@ main(int argc, char *argv[]) .BR getutmp (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutmp.3 b/man3/getutmp.3 index ff7683e37..7e3b40881 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getw.3 b/man3/getw.3 index d38ca6f85..bd7462380 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getwchar.3 b/man3/getwchar.3 index 96fd20f0f..4e533bf91 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/glob.3 b/man3/glob.3 index a63ecc167..7678a4574 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -31,7 +31,7 @@ .\" Expanded the description of various flags .\" Various wording fixes. .\" -.TH GLOB 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH GLOB 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME glob, globfree \- find pathnames matching a pattern, free memory from glob() .SH SYNOPSIS @@ -325,7 +325,7 @@ or .BR opendir (3). These will store their error code in .IR errno . -.SH EXAMPLE +.SH EXAMPLES One example of use is the following code, which simulates typing .PP .in +4n @@ -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.06 of the Linux +This page is part of release 5.07 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 03d1530a1..1ffb8aa68 100644 --- a/man3/gnu_get_libc_version.3 +++ b/man3/gnu_get_libc_version.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GNU_GET_LIBC_VERSION 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH GNU_GET_LIBC_VERSION 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME gnu_get_libc_version, gnu_get_libc_release \- get glibc version and release .SH SYNOPSIS @@ -61,7 +61,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO These functions are glibc-specific. -.SH EXAMPLE +.SH EXAMPLES When run, the program below will produce output such as the following: .PP .in +4n @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR confstr (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/grantpt.3 b/man3/grantpt.3 index ab5d83466..9a0a0ff47 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.06 of the Linux +This page is part of release 5.07 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 696449150..95a7fd1b3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gsignal.3 b/man3/gsignal.3 index a3932153f..33e7707e5 100644 --- a/man3/gsignal.3 +++ b/man3/gsignal.3 @@ -126,7 +126,7 @@ and .BR signal (2), .BR raise (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hash.3 b/man3/hash.3 index e2d7d3309..7503626e0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hsearch.3 b/man3/hsearch.3 index b7a5efc5e..c50ee404d 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -32,7 +32,7 @@ .\" 2008-09-03, mtk, restructured somewhat, in part after suggestions from .\" Timothy S. Nelson <wayland@wayland.id.au> .\" -.TH HSEARCH 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH HSEARCH 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME hcreate, hdestroy, hsearch, hcreate_r, hdestroy_r, hsearch_r \- hash table management @@ -297,7 +297,7 @@ implementation violates the specification, updating the \fIdata\fP for the given \fIkey\fP in this case. .PP Individual hash table entries can be added, but not deleted. -.SH EXAMPLE +.SH EXAMPLES .PP The following program inserts 24 items into a hash table, then prints some of them. @@ -353,7 +353,7 @@ main(void) .BR malloc (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hypot.3 b/man3/hypot.3 index 04189edc3..4ffd819bf 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -83,7 +83,8 @@ during the intermediate steps of the calculation. .\" e.g., hypot(DBL_MIN, DBL_MIN) does the right thing, as does, say .\" hypot(DBL_MAX/2.0, DBL_MAX/2.0). .SH RETURN VALUE -On success, these functions return the length of a right-angled triangle +On success, these functions return the length of the hypotenuse of +a right-angled triangle with sides of length .I x and @@ -135,9 +136,6 @@ An overflow floating-point exception is raised. .TP Range error: result underflow -.\" .I errno -.\" is set to -.\" .BR ERANGE . An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. @@ -145,9 +143,8 @@ is raised. These functions do not set .IR errno for this case. -.\" FIXME . Is it intentional that these functions do not set errno? -.\" They do set errno for the overflow case. -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795 +.\" This is intentional; see +.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6795 .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -174,7 +171,7 @@ SVr4, 4.3BSD. .BR cabs (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iconv.3 b/man3/iconv.3 index fa0b62140..9f4fa29be 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.06 of the Linux +This page is part of release 5.07 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 f131b0e5b..6543ee93f 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.06 of the Linux +This page is part of release 5.07 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 d2614a056..b67481da2 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.06 of the Linux +This page is part of release 5.07 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 bcd936938..a00031b8e 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH IF_NAMEINDEX 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH IF_NAMEINDEX 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME if_nameindex, if_freenameindex \- get network interface names and indexes .SH SYNOPSIS @@ -120,7 +120,7 @@ T} Thread safety MT-Safe POSIX.1-2001, POSIX.1-2008, RFC\ 3493. .PP This function first appeared in BSDi. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of the functions described on this page. An example of the output this program might produce is the following: @@ -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.06 of the Linux +This page is part of release 5.07 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 ae16efca2..698c4a9da 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ilogb.3 b/man3/ilogb.3 index af035f15a..8b541a479 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/index.3 b/man3/index.3 index 3a1747e96..5a5b8b567 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet.3 b/man3/inet.3 index 99a5e88d6..3fa0cfec1 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -39,7 +39,7 @@ .\" Add discussion of Classful Addressing, noting that it is obsolete. .\" Added an EXAMPLE program. .\" -.TH INET 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH INET 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof \- Internet address manipulation routines @@ -285,7 +285,7 @@ Classful network addresses are now obsolete, having been superseded by Classless Inter-Domain Routing (CIDR), which divides addresses into network and host components at arbitrary bit (rather than byte) boundaries. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR inet_aton () and @@ -340,7 +340,7 @@ main(int argc, char *argv[]) .BR hosts (5), .BR networks (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 db2421741..d22017028 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INET_NET_PTON 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH INET_NET_PTON 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME inet_net_pton, inet_net_ntop \- Internet network number conversion .SH SYNOPSIS @@ -244,7 +244,7 @@ but the number of octets specified in the network number exceed then .I bits is set to 8 times the number of octets actually specified. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR inet_net_pton () and @@ -391,7 +391,7 @@ main(int argc, char *argv[]) .BR inet (3), .BR networks (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 3974bbccf..82351d00b 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" References: RFC 2553 -.TH INET_NTOP 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH INET_NTOP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME inet_ntop \- convert IPv4 and IPv6 addresses from binary to text form .SH SYNOPSIS @@ -125,7 +125,7 @@ but 2.2 and later have .SH BUGS .B AF_INET6 converts IPv4-mapped IPv6 addresses into an IPv6 format. -.SH EXAMPLE +.SH EXAMPLES See .BR inet_pton (3). .SH SEE ALSO @@ -133,7 +133,7 @@ See .BR inet (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 a7ac9ef9d..8c9ce8665 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" References: RFC 2553 -.TH INET_PTON 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH INET_PTON 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME inet_pton \- convert IPv4 and IPv6 addresses from text to binary form .SH SYNOPSIS @@ -167,7 +167,7 @@ does not recognize IPv4 addresses. An explicit IPv4-mapped IPv6 address must be supplied in .I src instead. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR inet_pton () and @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/initgroups.3 b/man3/initgroups.3 index ba0bfbf63..59208054c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/insque.3 b/man3/insque.3 index 598cbed33..3a8cad64d 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -33,7 +33,7 @@ .\" mtk, 2010-09-09: Noted glibc 2.4 bug, added info on circular .\" lists, added example program .\" -.TH INSQUE 3 2019-03-06 "" "Linux Programmer's Manual" +.TH INSQUE 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME insque, remque \- insert/remove an item from a queue .SH SYNOPSIS @@ -148,7 +148,7 @@ as NULL. Consequently, to build a linear list, the caller had to build a list using an initial call that contained the first two elements of the list, with the forward and backward pointers in each element suitably initialized. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR insque (). Here is an example run of the program: @@ -261,7 +261,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR queue (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/intro.3 b/man3/intro.3 index dc493e744..8f17312f0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isalpha.3 b/man3/isalpha.3 index 155d464f6..42c3342af 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isatty.3 b/man3/isatty.3 index 9f83d864c..38b5ce719 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isfdtype.3 b/man3/isfdtype.3 index 696d84a48..1a32d8f33 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isgreater.3 b/man3/isgreater.3 index 4e63bb7e3..26c613908 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalnum.3 b/man3/iswalnum.3 index 32dbfcc20..e7d84ed42 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalpha.3 b/man3/iswalpha.3 index 9b7c7527a..ab023848f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswblank.3 b/man3/iswblank.3 index a1b4165a5..f9ecd3226 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswcntrl.3 b/man3/iswcntrl.3 index 6794845d4..3590e08e7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswctype.3 b/man3/iswctype.3 index ddfdc8cf8..0037a9b33 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswdigit.3 b/man3/iswdigit.3 index 08bf9df4b..a33a5f5cd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswgraph.3 b/man3/iswgraph.3 index 176ddbd4c..b6b87ed65 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswlower.3 b/man3/iswlower.3 index daf6b72b8..9174e8e2c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswprint.3 b/man3/iswprint.3 index 704f5df58..cb9b35bf5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswpunct.3 b/man3/iswpunct.3 index 1c1519e44..21c85e322 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswspace.3 b/man3/iswspace.3 index 7e883ecc5..c4569ebbf 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswupper.3 b/man3/iswupper.3 index cfb46c57c..e3330b662 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswxdigit.3 b/man3/iswxdigit.3 index bb084eafa..d3c537fca 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, @@ -143,15 +143,12 @@ Range error: result underflow, or \fIx\fP is too large in magnitude .I errno is set to .BR ERANGE . -.\" An underflow floating-point exception -.\" .RB ( FE_UNDERFLOW ) -.\" is raised. .PP These functions do not raise exceptions for .BR fetestexcept (3). -.\" FIXME . Is it intentional that these functions do not raise exceptions? .\" e.g., j0(1.5e16) -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805 +.\" This is intentional. +.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805 .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -194,7 +191,7 @@ between \-8 and 8. .SH SEE ALSO .BR y0 (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 4d8589b02..b93c36663 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/killpg.3 b/man3/killpg.3 index 246d4ac7f..fb439c212 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -39,7 +39,7 @@ .\" Added notes on CAP_KILL .\" Modified 2004-06-21 by aeb .\" -.TH KILLPG 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH KILLPG 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME killpg \- send signal to a process group .SH SYNOPSIS @@ -112,7 +112,7 @@ first appeared in 4BSD). There are various differences between the permission checking in BSD-type systems and System\ V-type systems. See the POSIX rationale for -.BR kill (). +.BR kill (3p). A difference not mentioned by POSIX concerns the return value .BR EPERM : @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ldexp.3 b/man3/ldexp.3 index 891084e88..9f1e233ab 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lgamma.3 b/man3/lgamma.3 index 4506a2681..e5412c38a 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.06 of the Linux +This page is part of release 5.07 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 35fc374ce..43a9d6224 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/localeconv.3 b/man3/localeconv.3 index 39c8c0b7c..73a0dd3ca 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lockf.3 b/man3/lockf.3 index 3e42f5f0e..eae52bc37 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log.3 b/man3/log.3 index d515ba1e3..e43ae0099 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log10.3 b/man3/log10.3 index dea905e27..918b49d87 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log1p.3 b/man3/log1p.3 index 526b583d7..541456922 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log2.3 b/man3/log2.3 index c5c682ce0..c74a56e42 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/logb.3 b/man3/logb.3 index 7e3d01b89..645335b87 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/login.3 b/man3/login.3 index feeb22b27..6c6281ca6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lrint.3 b/man3/lrint.3 index ac0c4e1b0..1b2add14c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lround.3 b/man3/lround.3 index ca85100d1..7a8c21abe 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lsearch.3 b/man3/lsearch.3 index 9fe3fad11..19e51d273 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lseek64.3 b/man3/lseek64.3 index 995c72e17..3203098e4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makecontext.3 b/man3/makecontext.3 index b7dbcad68..f53d3b095 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -25,7 +25,7 @@ .\" .\" 2006-08-02, mtk, Added example program .\" -.TH MAKECONTEXT 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH MAKECONTEXT 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME makecontext, swapcontext \- manipulate user context .SH SYNOPSIS @@ -149,7 +149,7 @@ and won't work on architectures where pointers are larger than Nevertheless, starting with version 2.8, glibc makes some changes to .BR makecontext (), to permit this on some 64-bit architectures (e.g., x86-64). -.SH EXAMPLE +.SH EXAMPLES .PP The example program below demonstrates the use of .BR getcontext (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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makedev.3 b/man3/makedev.3 index 0a99cfa41..a9c91bb3a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index ec5447914..08e509ac6 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MALLINFO 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MALLINFO 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mallinfo \- obtain memory allocation information .SH SYNOPSIS @@ -164,7 +164,7 @@ structure are typed as However, because some internal bookkeeping values may be of type .IR long , the reported values may wrap around zero and thus be inaccurate. -.SH EXAMPLE +.SH EXAMPLES The program below employs .BR mallinfo () to retrieve memory allocation statistics before and after @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc.3 b/man3/malloc.3 index a7baba85b..287fbdeaa 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -31,9 +31,9 @@ .\" FIXME . Review http://austingroupbugs.net/view.php?id=374 .\" to see what changes are required on this page. .\" -.TH MALLOC 3 2020-02-09 "GNU" "Linux Programmer's Manual" +.TH MALLOC 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME -malloc, free, calloc, realloc \- allocate and free dynamic memory +malloc, free, calloc, realloc, reallocarray \- allocate and free dynamic memory .SH SYNOPSIS .nf .B #include <stdlib.h> @@ -254,6 +254,9 @@ or .BR RLIMIT_DATA limit described in .BR getrlimit (2). +.SH VERSIONS +.BR reallocarray () +first appeared in glibc in version 2.26. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -399,7 +402,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.06 of the Linux +This page is part of release 5.07 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 7d121ae3a..e69af48f4 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.06 of the Linux +This page is part of release 5.07 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 bfc0d73e2..c5341017d 100644 --- a/man3/malloc_hook.3 +++ b/man3/malloc_hook.3 @@ -7,7 +7,7 @@ .\" Heavily based on glibc documentation .\" Polished, added docs, removed glibc doc bug, 2002-07-20, aeb .\" -.TH MALLOC_HOOK 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH MALLOC_HOOK 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME __malloc_hook, __malloc_initialize_hook, __memalign_hook, __free_hook, __realloc_hook, @@ -91,7 +91,7 @@ variable has been removed from the API. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=9957 Programmers should instead preempt calls to the relevant functions by defining and exporting functions such as "malloc" and "free". -.SH EXAMPLE +.SH EXAMPLES Here is a short example of how to use these variables. .PP .EX @@ -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.06 of the Linux +This page is part of release 5.07 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 d98f077cb..43b709beb 100644 --- a/man3/malloc_info.3 +++ b/man3/malloc_info.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MALLOC_INFO 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH MALLOC_INFO 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME malloc_info \- export malloc state to a stream .SH SYNOPSIS @@ -94,7 +94,7 @@ function is designed to address deficiencies in .BR malloc_stats (3) and .BR mallinfo (3). -.SH EXAMPLE +.SH EXAMPLES The program below takes up to four command-line arguments, of which the first three are mandatory. The first argument specifies the number of threads that @@ -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.06 of the Linux +This page is part of release 5.07 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 d8bd09c1b..bd88f1d94 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.06 of the Linux +This page is part of release 5.07 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 c2ebe4530..045105593 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.06 of the Linux +This page is part of release 5.07 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 1cc3a0c61..61612da28 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallopt.3 b/man3/mallopt.3 index 75d263d25..a2959bb77 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MALLOPT 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MALLOPT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mallopt \- set memory allocation parameters .SH SYNOPSIS @@ -511,7 +511,7 @@ being freed by the call the block starting at .I p+sizeof(size_t) is initialized. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR M_CHECK_ACTION . If the program is supplied with an (integer) command-line argument, @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/matherr.3 b/man3/matherr.3 index 047cd8928..dbe23be47 100644 --- a/man3/matherr.3 +++ b/man3/matherr.3 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MATHERR 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MATHERR 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME matherr \- SVID math library exception handling .SH SYNOPSIS @@ -286,7 +286,7 @@ T{ .BR matherr () T} Thread safety MT-Safe .TE -.SH EXAMPLE +.SH EXAMPLES The example program demonstrates the use of .BR matherr () when calling @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mblen.3 b/man3/mblen.3 index d145e5d00..3cae2fe88 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index 988ee565c..43e8e4483 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrtowc.3 b/man3/mbrtowc.3 index ac65e0a1f..1ceb7e468 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index 1a46c5d4a..f71ab9c4d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index ddd768cbb..6d70cde60 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -12,7 +12,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH MBSNRTOWCS 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH MBSNRTOWCS 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME mbsnrtowcs \- convert a multibyte string to a wide-character string .SH SYNOPSIS @@ -195,11 +195,11 @@ Passing NULL as is not multithread safe. .SH SEE ALSO .BR iconv (3), -.BR mbrtowc (3) +.BR mbrtowc (3), .BR mbsinit (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index 5570ae68e..39ed91899 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index b8d6316cb..ecec640b9 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -15,7 +15,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH MBSTOWCS 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH MBSTOWCS 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME mbstowcs \- convert a multibyte string to a wide-character string .SH SYNOPSIS @@ -118,7 +118,7 @@ The function .BR mbsrtowcs (3) provides a better interface to the same functionality. -.SH EXAMPLE +.SH EXAMPLES The program below illustrates the use of .BR mbstowcs (), as well as some of the wide character classification functions. @@ -235,7 +235,7 @@ main(int argc, char *argv[]) .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index 817fd576c..fff276b87 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mcheck.3 b/man3/mcheck.3 index cd1655255..79dcd81c8 100644 --- a/man3/mcheck.3 +++ b/man3/mcheck.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MCHECK 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH MCHECK 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME mcheck, mcheck_check_all, mcheck_pedantic, mprobe \- heap consistency checking .SH SYNOPSIS @@ -177,7 +177,7 @@ But, using .B MALLOC_CHECK_ does not require the application to be relinked. .\" But is MALLOC_CHECK_ slower? -.SH EXAMPLE +.SH EXAMPLES The program below calls .BR mcheck () with a NULL argument and then frees the same block of memory twice. @@ -227,7 +227,7 @@ main(int argc, char *argv[]) .BR mallopt (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memccpy.3 b/man3/memccpy.3 index d68bcb671..9a3b343c1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memchr.3 b/man3/memchr.3 index e067d09bd..5cebed56b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcmp.3 b/man3/memcmp.3 index f8fb79354..237fe15f6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcpy.3 b/man3/memcpy.3 index 4dbcdab94..482b9bdb6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 630a5e984..7d9a85424 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmem.3 b/man3/memmem.3 index 30ebf8a20..697bfaf82 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmove.3 b/man3/memmove.3 index 62758694b..fd19f9a22 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 84ef053a0..06b1fcebc 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -7,7 +7,7 @@ .\" Heavily based on glibc infopages, copyright Free Software Foundation .\" .\" aeb, 2003, polished a little -.TH MEMPCPY 3 2015-03-02 "GNU" "Linux Programmer's Manual" +.TH MEMPCPY 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME mempcpy, wmempcpy \- copy memory area .SH SYNOPSIS @@ -70,7 +70,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO This function is a GNU extension. -.SH EXAMPLE +.SH EXAMPLES .EX void * combine(void *o1, size_t s1, void *o2, size_t s2) @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memset.3 b/man3/memset.3 index 7796db00c..1795f5afc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index 3e9d549b1..06b079bf5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index 33fc2c8c2..a6113cc9b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index a83a7bb77..a9cc5fbcd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mktemp.3 b/man3/mktemp.3 index 3a8427ff3..0dbb8a146 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/modf.3 b/man3/modf.3 index 5ee0815d1..018f8e646 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mpool.3 b/man3/mpool.3 index 39821a35e..c6c72f45a 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.06 of the Linux +This page is part of release 5.07 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 5374d32a0..56b32eab2 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.06 of the Linux +This page is part of release 5.07 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 0aa98b02d..0da535045 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_GETATTR 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MQ_GETATTR 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mq_getattr, mq_setattr \- get/set message queue attributes .SH SYNOPSIS @@ -157,7 +157,7 @@ and are library functions layered on top of the .BR mq_getsetattr (2) system call. -.SH EXAMPLE +.SH EXAMPLES The program below can be used to show the default .I mq_maxmsg and @@ -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.06 of the Linux +This page is part of release 5.07 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 181cbc86b..1e41fb316 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_NOTIFY 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH MQ_NOTIFY 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mq_notify \- register for notification when a message is available .SH SYNOPSIS @@ -208,7 +208,7 @@ The implementation involves the use of a raw .BR netlink (7) socket and creates a new thread for each notification that is delivered to the process. -.SH EXAMPLE +.SH EXAMPLES The following program registers a notification request for the message queue named in its command-line argument. Notification is performed by creating a thread. @@ -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.06 of the Linux +This page is part of release 5.07 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 74d3475db..808e3b182 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.06 of the Linux +This page is part of release 5.07 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 004f6772d..5827e8a5e 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.06 of the Linux +This page is part of release 5.07 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 0c4590bd2..dc928f639 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.06 of the Linux +This page is part of release 5.07 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 4e607ae5e..34e0dedbc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mtrace.3 b/man3/mtrace.3 index cc2be94c0..eb0d7274e 100644 --- a/man3/mtrace.3 +++ b/man3/mtrace.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MTRACE 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH MTRACE 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME mtrace, muntrace \- malloc tracing .SH SYNOPSIS @@ -127,7 +127,7 @@ The line-number information produced by is not always precise: the line number references may refer to the previous or following (nonblank) line of the source code. -.SH EXAMPLE +.SH EXAMPLES The shell session below demonstrates the use of the .BR mtrace () function and the @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nan.3 b/man3/nan.3 index c804cf721..3f5887f62 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/netlink.3 b/man3/netlink.3 index f9645ab4f..24ee637da 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/newlocale.3 b/man3/newlocale.3 index 94c840287..0d0789b5b 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH NEWLOCALE 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH NEWLOCALE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME newlocale, freelocale \- create, modify, and free a locale object .SH SYNOPSIS @@ -218,7 +218,7 @@ Each locale object created by .BR newlocale () should be deallocated using .BR freelocale (). -.SH EXAMPLE +.SH EXAMPLES The program below takes up to two command-line arguments, which each identify locales. The first argument is required, and is used to set the @@ -366,6 +366,7 @@ main(int argc, char *argv[]) /* Free the locale object */ + uselocale(LC_GLOBAL_HANDLE); /* So 'loc' is no longer in use */ freelocale(loc); exit(EXIT_SUCCESS); @@ -379,7 +380,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextafter.3 b/man3/nextafter.3 index 99ec32c00..c07262dae 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -8,7 +8,7 @@ .\" .\" Based on glibc infopages .\" -.TH NEXTAFTER 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH NEXTAFTER 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating-point number manipulation @@ -149,26 +149,21 @@ The following errors can occur: .TP Range error: result overflow .\" e.g., nextafter(DBL_MAX, HUGE_VAL); -.\" .I errno -.\" is set to -.\" .BR ERANGE . +.I errno +is set to +.BR ERANGE . An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. .TP Range error: result is subnormal or underflows .\" e.g., nextafter(DBL_MIN, 0.0); -.\" .I errno -.\" is set to -.\" .BR ERANGE . +.I errno +is set to +.BR ERANGE . An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. -.PP -These functions do not set -.IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799 .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -197,10 +192,15 @@ In glibc version 2.5 and earlier, these functions do not raise an underflow floating-point .RB ( FE_UNDERFLOW ) exception when an underflow occurs. +.SH BUGS +Before glibc version 2.23 +.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799 +these functions did not set +.IR errno . .SH SEE ALSO .BR nearbyint (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextup.3 b/man3/nextup.3 index dbefbb004..515671fa4 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.06 of the Linux +This page is part of release 5.07 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 f69f15353..0536d3467 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -318,7 +318,7 @@ is undefined if is the special locale object .BR LC_GLOBAL_LOCALE or is not a valid locale object handle. -.SH EXAMPLE +.SH EXAMPLES The following program sets the character type and the numeric locale according to the environment and queries the terminal character set and the radix character. @@ -350,7 +350,7 @@ main(int argc, char *argv[]) .PP The GNU C Library Reference Manual .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 186402be7..8f7f37339 100644 --- a/man3/ntp_gettime.3 +++ b/man3/ntp_gettime.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH NTP_GETTIME 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH NTP_GETTIME 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ntp_gettime, ntp_gettimex \- get time parameters (NTP daemon interface) .SH SYNOPSIS @@ -139,7 +139,7 @@ is described in the NTP Kernel Application Program Interface. .BR ntp_gettimex () is a GNU extension. .SH SEE ALSO -.BR adjtimex (2) +.BR adjtimex (2), .BR ntp_adjtime (3), .BR time (7) .PP @@ -148,7 +148,7 @@ is a GNU extension. NTP "Kernel Application Program Interface" .UE .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/offsetof.3 b/man3/offsetof.3 index 4791a470c..6f6469bd6 100644 --- a/man3/offsetof.3 +++ b/man3/offsetof.3 @@ -25,7 +25,7 @@ .\" References: .\" /usr/lib/gcc/i486-linux-gnu/4.1.1/include/stddef.h .\" glibc-doc -.TH OFFSETOF 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH OFFSETOF 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME offsetof \- offset of a structure member .SH SYNOPSIS @@ -62,7 +62,7 @@ within the given in units of bytes. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89, C99. -.SH EXAMPLE +.SH EXAMPLES On a Linux/i386 system, when compiled using the default .BR gcc (1) options, the program below produces the following output: @@ -102,7 +102,7 @@ main(void) } .EE .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 ca6f3057b..440956fbd 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.06 of the Linux +This page is part of release 5.07 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 b4b51fdd9..e8f525d23 100644 --- a/man3/open_memstream.3 +++ b/man3/open_memstream.3 @@ -6,7 +6,7 @@ .\" .\" 2008-12-04, Petr Baudis <pasky@suse.cz>: Document open_wmemstream() .\" -.TH OPEN_MEMSTREAM 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH OPEN_MEMSTREAM 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME open_memstream, open_wmemstream \- open a dynamic memory buffer stream .SH SYNOPSIS @@ -136,7 +136,7 @@ does not enlarge the buffer; instead the .BR fseek (3) call fails, returning \-1. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=1996 -.SH EXAMPLE +.SH EXAMPLES See .BR fmemopen (3). .SH SEE ALSO @@ -144,7 +144,7 @@ See .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/opendir.3 b/man3/opendir.3 index 94bb611b5..96713d8c3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/openpty.3 b/man3/openpty.3 index 3e0c489f0..0c62126ff 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/perror.3 b/man3/perror.3 index 6a65cc64b..14fa870b6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/popen.3 b/man3/popen.3 index 782e22442..8fba12ee6 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.06 of the Linux +This page is part of release 5.07 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 a5822bcb8..0245b1a15 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.06 of the Linux +This page is part of release 5.07 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 ae0259bac..6639c7f7b 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.06 of the Linux +This page is part of release 5.07 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 efdd7f079..636748017 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -159,7 +159,7 @@ On Linux (and other systems), does not modify .I memptr on failure. -A requirement standardizing this behavior was added in POSIX.1-2016. +A requirement standardizing this behavior was added in POSIX.1-2008 TC2. .\" http://austingroupbugs.net/view.php?id=520 .SH ERRORS .TP @@ -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.06 of the Linux +This page is part of release 5.07 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 bd366bdb4..9f7821208 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.06 of the Linux +This page is part of release 5.07 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 3cc98fec0..691ce223a 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -155,9 +155,16 @@ and the .BR exec () step (executed in the child). .SS fork() step -The +Since glibc 2.24, the .BR posix_spawn () function commences by calling +.BR clone (2) +with +.BR CLONE_VM +and +.BR CLONE_VFORK +flags. +Older implementations use .BR fork (2), or possibly .BR vfork (2) @@ -176,7 +183,7 @@ If the child fails in any of the housekeeping steps described below, or fails to execute the desired file, it exits with a status of 127. .PP -The child process is created using +Before glibc 2.24, the child process is created using .BR vfork (2) instead of .BR fork (2) @@ -213,10 +220,10 @@ the requested file. .PP .SS pre-exec() step: housekeeping In between the -.BR fork (2) +.BR fork() and the -.BR exec (3), -a child process may need to perform a set of housekeeping actions. +.BR exec() +steps, a child process may need to perform a set of housekeeping actions. The .BR posix_spawn () and @@ -375,6 +382,32 @@ the child's process group ID is made the same as its process ID. If the .B POSIX_SPAWN_SETPGROUP flag is not set, the child inherits the parent's process group ID. +.TP +.B POSIX_SPAWN_USEVFORK +Since glibc 2.24, this flag has no effect. +On older implementations, setting this flag forces the +.BR fork() +step to use +.BR vfork (2) +instead of +.BR fork (2). +The +.B _GNU_SOURCE +feature test macro must be defined to obtain the definition of this constant. +.TP +.BR POSIX_SPAWN_SETSID " (since glibc 2.26)" +If this flag is set, +the child process shall create a new session and become the session leader. +The child process shall also become the process group leader of the new process +group in the session (see +.BR setsid (2)). +The +.B _GNU_SOURCE +feature test macro must be defined to obtain the definition of this constant. +.\" This flag has been accepted in POSIX, see: +.\" http://austingroupbugs.net/view.php?id=1044 +.\" and has been implemented in glibc since version 2.26 +.\" commit daeb1fa2e1b33323e719015f5f546988bd4cc73b .PP If .I attrp @@ -459,8 +492,9 @@ and place the PID of the child process in .IR pid , and return 0. -If there is an error before or during the -.BR fork (2), +If there is an error during the +.BR fork() +step, then no child is created, the contents of .IR *pid @@ -480,14 +514,16 @@ The and .BR posix_spawnp () functions fail only in the case where the underlying -.BR fork (2) -or +.BR fork (2), .BR vfork (2) +or +.BR clone (2) call fails; in these cases, these functions return an error number, which will be one of the errors described for -.BR fork (2) +.BR fork (2), +.BR vfork (2) or -.BR vfork (2). +.BR clone (2). .PP In addition, these functions fail if: .TP @@ -527,13 +563,14 @@ only the POSIX-specified functions. although these objects may be implemented as structures containing fields, portable programs must avoid dependence on such implementation details.) .PP -According to POSIX, it unspecified whether fork handlers established with +According to POSIX, it is unspecified whether fork handlers established with .BR pthread_atfork (3) are called when .BR posix_spawn () is invoked. -On glibc, +Since glibc 2.24, the fork handlers are not executed in any case. .\" Tested on glibc 2.12 +On older implementations, fork handlers are called only if the child is created using .BR fork (2). .PP @@ -563,7 +600,7 @@ failed with an error if .BR POSIX_SPAWN_SETSCHEDULER was specified without also specifying .BR POSIX_SPAWN_SETSCHEDPARAM . -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of various functions in the POSIX spawn API. The program accepts command-line attributes that can be used @@ -807,7 +844,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow.3 b/man3/pow.3 index 8c53f59db..62342fb02 100644 --- a/man3/pow.3 +++ b/man3/pow.3 @@ -32,7 +32,7 @@ .\" Modified 1995-08-14 by Arnt Gulbrandsen <agulbra@troll.no> .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH POW 3 2017-09-15 "" "Linux Programmer's Manual" +.TH POW 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME pow, powf, powl \- power functions .SH SYNOPSIS @@ -329,11 +329,12 @@ The variant returning also conforms to SVr4, 4.3BSD, C89. .SH BUGS -On 64-bits, -.\" +.SS Historical bugs (now fixed) +Before glibc 2.28, .\" https://sourceware.org/bugzilla/show_bug.cgi?id=13932 +on some architectures (e.g., x86-64) .BR pow () -may be more than 10,000 times slower for some (rare) inputs +may be more than 10,000 times slower for some inputs than for other nearby inputs. This affects only .BR pow (), @@ -341,6 +342,15 @@ and not .BR powf () nor .BR powl (). +This problem was fixed +.\" commit c3d466cba1692708a19c6ff829d0386c83a0c6e5 +in glibc 2.28. +.PP +A number of bugs +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866 +in the glibc implementation of +.BR pow () +were fixed in glibc version 2.16. .PP In glibc 2.9 and earlier, .\" @@ -356,28 +366,8 @@ Since version 2.10, .\" and I don't have a 2.9 system to test glibc does the right thing. .PP -If -.I x -is negative, -then large negative or positive -.I y -values yield a NaN as the function result, with -.I errno -set to -.BR EDOM , -and an invalid -.RB ( FE_INVALID ) -floating-point exception. -For example, with -.BR pow (), -one sees this behavior when the absolute value of -.I y -is greater than about 9.223373e18. -.\" see bug http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866 -.\" and http://sources.redhat.com/bugzilla/show_bug.cgi?id=369 -.PP In version 2.3.2 and earlier, -.\" FIXME . Actually, 2.3.2 is the earliest test result I have; so yet +.\" Actually, 2.3.2 is the earliest test result I have; so yet .\" to confirm if this error occurs only in 2.3.2. when an overflow or underflow error occurs, glibc's .BR pow () @@ -389,7 +379,7 @@ in addition to the overflow or underflow exception. .BR cpow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow10.3 b/man3/pow10.3 index c262ba2e8..28a4c86c7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/printf.3 b/man3/printf.3 index ded60c46e..ee049abf0 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-10-10 "GNU" "Linux Programmer's Manual" +.TH PRINTF 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf, vsnprintf \- formatted output conversion @@ -1068,7 +1068,7 @@ call to write to memory and creating a security hole. .\" .PP .\" Some floating-point conversions under early libc4 .\" caused memory leaks. -.SH EXAMPLE +.SH EXAMPLES To print .I Pi to five decimal places: @@ -1132,29 +1132,32 @@ To allocate a sufficiently large string and print into it char * make_message(const char *fmt, ...) { - int size = 0; + int n = 0; + size_t size = 0; char *p = NULL; va_list ap; /* Determine required size */ va_start(ap, fmt); - size = vsnprintf(p, size, fmt, ap); + n = vsnprintf(p, size, fmt, ap); va_end(ap); - if (size < 0) + if (n < 0) return NULL; - size++; /* For '\e0' */ + /* One extra byte for '\e0' */ + + size = (size_t) n + 1; p = malloc(size); if (p == NULL) return NULL; va_start(ap, fmt); - size = vsnprintf(p, size, fmt, ap); + n = vsnprintf(p, size, fmt, ap); va_end(ap); - if (size < 0) { + if (n < 0) { free(p); return NULL; } @@ -1176,7 +1179,7 @@ error instead of being handled gracefully. .BR wprintf (3), .BR locale (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/profil.3 b/man3/profil.3 index 6fd09e77f..5aea3971c 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.06 of the Linux +This page is part of release 5.07 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 8f6cb0179..bf53d886c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/psignal.3 b/man3/psignal.3 index e52689ca9..b3ac0cbdb 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 18:45:17 1993 by Rik Faith (faith@cs.unc.edu) .TH PSIGNAL 3 2017-09-15 "GNU" "Linux Programmer's Manual" .SH NAME -psignal, psiginfo \- print signal message +psignal, psiginfo \- print signal description .SH SYNOPSIS .nf .B #include <signal.h> @@ -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.06 of the Linux +This page is part of release 5.07 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 0e6c23537..21132b068 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.06 of the Linux +This page is part of release 5.07 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 4cc04f225..6294a038c 100644 --- a/man3/pthread_attr_init.3 +++ b/man3/pthread_attr_init.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_INIT 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_INIT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_init, pthread_attr_destroy \- initialize and destroy thread attributes object @@ -99,7 +99,7 @@ The type should be treated as opaque: any access to the object other than via pthreads functions is nonportable and produces undefined results. -.SH EXAMPLE +.SH EXAMPLES The program below optionally makes use of .BR pthread_attr_init () and various related functions to initialize a thread attributes @@ -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.06 of the Linux +This page is part of release 5.07 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 b365e9616..41dcf4543 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.06 of the Linux +This page is part of release 5.07 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 7f4c7c2cd..9122e0541 100644 --- a/man3/pthread_attr_setdetachstate.3 +++ b/man3/pthread_attr_setdetachstate.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETDETACHSTATE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETDETACHSTATE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setdetachstate, pthread_attr_getdetachstate \- set/get detach state attribute in thread attributes object @@ -118,7 +118,7 @@ in a later call to .BR pthread_detach (3) or .BR pthread_join (3). -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_attr_init (3). .SH SEE ALSO @@ -128,7 +128,7 @@ See .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 52c7c539b..eb3bf3648 100644 --- a/man3/pthread_attr_setguardsize.3 +++ b/man3/pthread_attr_setguardsize.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETGUARDSIZE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETGUARDSIZE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setguardsize, pthread_attr_getguardsize \- set/get guard size attribute in thread attributes object @@ -165,7 +165,7 @@ allocating extra space at the end of the stack for the guard area. .\" Reportedly, LinuxThreads did the right thing, allocating .\" extra space at the end of the stack: .\" http://sourceware.org/ml/libc-alpha/2008-05/msg00086.html -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_getattr_np (3). .SH SEE ALSO @@ -177,7 +177,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 1adcf5997..382cce86a 100644 --- a/man3/pthread_attr_setinheritsched.3 +++ b/man3/pthread_attr_setinheritsched.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETINHERITSCHED 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETINHERITSCHED 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setinheritsched, pthread_attr_getinheritsched \- set/get inherit-scheduler attribute in thread attributes object @@ -138,7 +138,7 @@ in the thread attributes object before calling .BR pthread_create (3). .\" FIXME . Track status of the following bug: .\" http://sourceware.org/bugzilla/show_bug.cgi?id=7007 -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_setschedparam (3). .SH SEE ALSO @@ -154,7 +154,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 a962b4f6c..61bb91876 100644 --- a/man3/pthread_attr_setschedparam.3 +++ b/man3/pthread_attr_setschedparam.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETSCHEDPARAM 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSCHEDPARAM 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setschedparam, pthread_attr_getschedparam \- set/get scheduling parameter attributes in thread attributes object @@ -123,7 +123,7 @@ POSIX.1-2001, POSIX.1-2008. See .BR pthread_attr_setschedpolicy (3) for a list of the thread scheduling policies supported on Linux. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_setschedparam (3). .SH SEE ALSO @@ -139,7 +139,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 6cec31bda..4c70feb8a 100644 --- a/man3/pthread_attr_setschedpolicy.3 +++ b/man3/pthread_attr_setschedpolicy.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETSCHEDPOLICY 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSCHEDPOLICY 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setschedpolicy, pthread_attr_getschedpolicy \- set/get scheduling policy attribute in thread attributes object @@ -112,7 +112,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_setschedparam (3). .SH SEE ALSO @@ -127,7 +127,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 d393c0428..7be765c83 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.06 of the Linux +This page is part of release 5.07 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 02b8b8171..10f266f62 100644 --- a/man3/pthread_attr_setstack.3 +++ b/man3/pthread_attr_setstack.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETSTACK 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSTACK 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setstack, pthread_attr_getstack \- set/get stack attributes in thread attributes object @@ -162,7 +162,7 @@ stack address attribute between calls to .BR pthread_create (3); otherwise, the threads will attempt to use the same memory area for their stacks, and chaos will ensue. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_attr_init (3). .SH SEE ALSO @@ -178,7 +178,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 4b7275dea..e3f70864d 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.06 of the Linux +This page is part of release 5.07 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 6480352a1..4420b6386 100644 --- a/man3/pthread_attr_setstacksize.3 +++ b/man3/pthread_attr_setstacksize.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATTR_SETSTACKSIZE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSTACKSIZE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_attr_setstacksize, pthread_attr_getstacksize \- set/get stack size attribute in thread attributes object @@ -118,7 +118,7 @@ in violation of POSIX.1, which says that the allocated stack will be at least .I stacksize bytes. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_create (3). .SH SEE ALSO @@ -129,7 +129,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 78054ab97..b0e486119 100644 --- a/man3/pthread_cancel.3 +++ b/man3/pthread_cancel.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_CANCEL 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_CANCEL 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_cancel \- send a cancellation request to a thread .SH SYNOPSIS @@ -145,7 +145,7 @@ On LinuxThreads, the second real-time signal is used, if real-time signals are available, otherwise .B SIGUSR2 is used. -.SH EXAMPLE +.SH EXAMPLES The program below creates a thread and then cancels it. The main thread joins with the canceled thread to check that its exit status was @@ -249,7 +249,7 @@ main(void) .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 162b8cc61..a9db0d1a0 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_CLEANUP_PUSH 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_CLEANUP_PUSH 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_cleanup_push, pthread_cleanup_pop \- push and pop thread cancellation clean-up handlers @@ -166,7 +166,7 @@ and .BR pthread_cleanup_pop () is undefined. Portable applications should avoid doing this. -.SH EXAMPLE +.SH EXAMPLES The program below provides a simple example of the use of the functions described in this page. The program creates a thread that executes a loop bracketed by @@ -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.06 of the Linux +This page is part of release 5.07 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 d6eba2483..4641d3af4 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.06 of the Linux +This page is part of release 5.07 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 79eadec6e..9ed18213f 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_CREATE 3 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_CREATE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_create \- create a new thread .SH SYNOPSIS @@ -236,7 +236,7 @@ each of the threads in a process has a different process ID. This is in violation of the POSIX threads specification, and is the source of many other nonconformances to the standard; see .BR pthreads (7). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR pthread_create (), as well as a number of other functions in the pthreads API. @@ -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.06 of the Linux +This page is part of release 5.07 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 8d6f80aa4..b4b1253a2 100644 --- a/man3/pthread_detach.3 +++ b/man3/pthread_detach.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_DETACH 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_DETACH 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_detach \- detach a thread .SH SYNOPSIS @@ -103,7 +103,7 @@ should be called for each thread that an application creates, so that system resources for the thread can be released. (But note that the resources of any threads for which one of these actions has not been done will be freed when the process terminates.) -.SH EXAMPLE +.SH EXAMPLES The following statement detaches the calling thread: .PP pthread_detach(pthread_self()); @@ -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.06 of the Linux +This page is part of release 5.07 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 544c5d411..dbde56e2e 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.06 of the Linux +This page is part of release 5.07 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 90c898436..aa303faaa 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.06 of the Linux +This page is part of release 5.07 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 dd3e56636..f4728849f 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_GETATTR_DEFAULT_NP 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_GETATTR_DEFAULT_NP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_getattr_default_np, pthread_setattr_default_np, \- get or set default thread-creation attributes @@ -96,7 +96,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO These functions are nonstandard GNU extensions; hence the suffix "_np" (nonportable) in their names. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR pthread_getattr_default_np () to fetch the default thread-creation attributes and then displays @@ -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.06 of the Linux +This page is part of release 5.07 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 0793fb1f7..0a2be34f3 100644 --- a/man3/pthread_getattr_np.3 +++ b/man3/pthread_getattr_np.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_GETATTR_NP 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_GETATTR_NP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_getattr_np \- get attributes of created thread .SH SYNOPSIS @@ -112,7 +112,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO This function is a nonstandard GNU extension; hence the suffix "_np" (nonportable) in the name. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR pthread_getattr_np (). The program creates a thread that then uses @@ -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.06 of the Linux +This page is part of release 5.07 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 7dd081234..e58a0e06e 100644 --- a/man3/pthread_getcpuclockid.3 +++ b/man3/pthread_getcpuclockid.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_GETCPUCLOCKID 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_GETCPUCLOCKID 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_getcpuclockid \- retrieve ID of a thread's CPU time clock .SH SYNOPSIS @@ -90,7 +90,7 @@ and .BR clock_settime (2) when given the clock ID .BR CLOCK_THREAD_CPUTIME_ID . -.SH EXAMPLE +.SH EXAMPLES The program below creates a thread and then uses .BR clock_gettime (2) to retrieve the total process CPU time, @@ -191,7 +191,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 793908c15..4133833c9 100644 --- a/man3/pthread_join.3 +++ b/man3/pthread_join.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_JOIN 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_JOIN 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_join \- join with a terminated thread .SH SYNOPSIS @@ -137,7 +137,7 @@ you probably need to rethink your application design. .PP All of the threads in a process are peers: any thread can join with any other thread in the process. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_create (3). .SH SEE ALSO @@ -148,7 +148,7 @@ See .BR pthread_tryjoin_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 651531930..fdf04bf91 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.06 of the Linux +This page is part of release 5.07 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 acdbb25cc..4b143ad26 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.06 of the Linux +This page is part of release 5.07 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 e963c24b3..73bc8731a 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 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_MUTEX_CONSISTENT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_mutex_consistent \- make a robust mutex consistent .SH SYNOPSIS @@ -93,19 +93,19 @@ was defined: .PP This GNU-specific API, which first appeared in glibc 2.4, is nowadays obsolete and should not be used in new programs. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_mutexattr_setrobust (3). .SH SEE ALSO .ad l .nh -.BR pthread_mutexattr_init (3), .BR pthread_mutex_lock (3), +.BR pthread_mutexattr_init (3), .BR pthread_mutexattr_getrobust (3), .BR pthread_mutexattr_setrobust (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 54d5e5d2e..3dbca5754 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.06 of the Linux +This page is part of release 5.07 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 02f9c1c6f..27527d906 100644 --- a/man3/pthread_mutexattr_init.3 +++ b/man3/pthread_mutexattr_init.3 @@ -69,7 +69,7 @@ have already been initialized using that object. .BR pthread_mutexattr_getrobust (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 772be89d9..456f50287 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-10-10 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_MUTEXATTR_SETROBUST 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_mutexattr_getrobust, pthread_mutexattr_setrobust \- get and set the robustness attribute of a mutex attributes object @@ -185,7 +185,7 @@ were also defined. .PP These GNU-specific APIs, which first appeared in glibc 2.4, are nowadays obsolete and should not be used in new programs. -.SH EXAMPLE +.SH EXAMPLES .PP The program below demonstrates the use of the robustness attribute of a mutex attributes object. @@ -284,7 +284,7 @@ main(int argc, char *argv[]) .BR pthread_mutex_lock (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 385a7b597..15f82c911 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.06 of the Linux +This page is part of release 5.07 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 3a2a0426f..71cd9f395 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.06 of the Linux +This page is part of release 5.07 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 8fbf1c283..006b2535c 100644 --- a/man3/pthread_setaffinity_np.3 +++ b/man3/pthread_setaffinity_np.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SETAFFINITY_NP 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SETAFFINITY_NP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_setaffinity_np, pthread_getaffinity_np \- set/get CPU affinity of a thread @@ -160,7 +160,7 @@ Instead the CPU set size given to the underlying system calls was always A new thread created by .BR pthread_create (3) inherits a copy of its creator's CPU affinity mask. -.SH EXAMPLE +.SH EXAMPLES In the following program, the main thread uses .BR pthread_setaffinity_np () to set its CPU affinity mask to include CPUs 0 to 7 @@ -222,7 +222,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 224df9267..700d85af5 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 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SETCANCELSTATE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_setcancelstate, pthread_setcanceltype \- set cancelability state and type @@ -202,7 +202,7 @@ A precisely analogous set of statements applies for the .I oldtype argument of .BR pthread_setcanceltype (). -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_cancel (3). .SH SEE ALSO @@ -211,7 +211,7 @@ See .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 6d2632874..455185410 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.06 of the Linux +This page is part of release 5.07 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 af0d61f9d..9c5f53c17 100644 --- a/man3/pthread_setname_np.3 +++ b/man3/pthread_setname_np.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SETNAME_NP 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SETNAME_NP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_setname_np, pthread_getname_np \- set/get the name of a thread .SH SYNOPSIS @@ -126,7 +126,7 @@ filesystem: .IR /proc/self/task/[tid]/comm . .BR pthread_getname_np () retrieves it from the same location. -.SH EXAMPLE +.SH EXAMPLES .PP The program below demonstrates the use of .BR pthread_setname_np () @@ -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.06 of the Linux +This page is part of release 5.07 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 f8f35e2d4..53b2329c5 100644 --- a/man3/pthread_setschedparam.3 +++ b/man3/pthread_setschedparam.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SETSCHEDPARAM 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SETSCHEDPARAM 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_setschedparam, pthread_getschedparam \- set/get scheduling policy and parameters of a thread @@ -159,7 +159,7 @@ changing a thread's scheduling policy and priority, and details of the permitted ranges for priorities in each scheduling policy, see .BR sched (7). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR pthread_setschedparam () and @@ -458,7 +458,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 27ebb1a88..10c68a73a 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.06 of the Linux +This page is part of release 5.07 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 cba8163d8..817d7d999 100644 --- a/man3/pthread_sigmask.3 +++ b/man3/pthread_sigmask.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SIGMASK 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SIGMASK 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_sigmask \- examine and change mask of blocked signals .SH SYNOPSIS @@ -90,7 +90,7 @@ are used internally by the NPTL threading implementation. See .BR nptl (7) for details. -.SH EXAMPLE +.SH EXAMPLES The program below blocks some signals in the main thread, and then creates a dedicated thread to fetch those signals via .BR sigwait (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.06 of the Linux +This page is part of release 5.07 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 e8be86eec..d8c7e35d8 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.06 of the Linux +This page is part of release 5.07 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 3aa43ea2e..35f1dc38b 100644 --- a/man3/pthread_spin_init.3 +++ b/man3/pthread_spin_init.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_SPIN_INIT 3 2017-09-30 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_SPIN_INIT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_spin_init, pthread_spin_destroy \- initialize or destroy a spin lock .SH SYNOPSIS @@ -102,7 +102,7 @@ The result of performing operations such as .BR pthread_spin_lock (3), .BR pthread_spin_unlock (3), and -.BR pthread_spin_destroy (3) +.BR pthread_spin_destroy () on .I copies of the object referred to by @@ -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.06 of the Linux +This page is part of release 5.07 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 c87cb3c0f..5453d741f 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.06 of the Linux +This page is part of release 5.07 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 b64467395..1f75211ac 100644 --- a/man3/pthread_testcancel.3 +++ b/man3/pthread_testcancel.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_TESTCANCEL 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_TESTCANCEL 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_testcancel \- request delivery of any pending cancellation request .SH SYNOPSIS @@ -69,7 +69,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_cleanup_push (3). .SH SEE ALSO @@ -78,7 +78,7 @@ See .BR pthread_setcancelstate (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 87e69185c..943a53596 100644 --- a/man3/pthread_tryjoin_np.3 +++ b/man3/pthread_tryjoin_np.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_TRYJOIN_NP 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_TRYJOIN_NP 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pthread_tryjoin_np, pthread_timedjoin_np \- try to join with a terminated thread @@ -135,7 +135,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO These functions are nonstandard GNU extensions; hence the suffix "_np" (nonportable) in the names. -.SH EXAMPLE +.SH EXAMPLES The following code waits to join for up to 5 seconds: .PP .in +4n @@ -163,7 +163,7 @@ if (s != 0) { .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 536a07473..ee524152a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ptsname.3 b/man3/ptsname.3 index 9d86b1d79..68cb419bb 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -4,7 +4,7 @@ .\" .\" 2004-12-17, mtk, added description of ptsname_r() + ERRORS .\" -.TH PTSNAME 3 2017-09-15 "" "Linux Programmer's Manual" +.TH PTSNAME 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME ptsname, ptsname_r \- get the name of the slave pseudoterminal .SH SYNOPSIS @@ -63,12 +63,9 @@ On failure, NULL is returned. On success, .BR ptsname_r () returns 0. -On failure, a nonzero value is returned -and -.I errno -is set to indicate the error. -.\" In fact the errno value is also returned as the function -.\" result -- MTK, Dec 04 +On failure, an error number is returned to indicate the error. +.\" In glibc, the error number is not only returned as the return value +.\" but also stored in errno. But this is not true for musl libc. .SH ERRORS .TP .B EINVAL @@ -134,7 +131,7 @@ Avoid using this function in portable programs. .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putenv.3 b/man3/putenv.3 index f922eee56..74fb9e77f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putgrent.3 b/man3/putgrent.3 index 4fc758420..aed557839 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putpwent.3 b/man3/putpwent.3 index 16bd161c4..a9b41dd50 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/puts.3 b/man3/puts.3 index afd11d000..0d753168f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putwchar.3 b/man3/putwchar.3 index 25296d8ff..51c5dad09 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qecvt.3 b/man3/qecvt.3 index 67a6fa635..13a2b1702 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qsort.3 b/man3/qsort.3 index 6544f9592..645814e04 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -34,7 +34,7 @@ .\" and Ben Bacarisse <software@bsb.me.uk> .\" Document qsort_r() .\" -.TH QSORT 3 2019-03-06 "" "Linux Programmer's Manual" +.TH QSORT 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME qsort, qsort_r \- sort an array .SH SYNOPSIS @@ -118,7 +118,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. To compare C strings, the comparison function can call .BR strcmp (3), as shown in the example below. -.SH EXAMPLE +.SH EXAMPLES For one example of use, see the example under .BR bsearch (3). .PP @@ -163,7 +163,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR versionsort (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/queue.3 b/man3/queue.3 index e44d633db..6acc7c614 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.06 of the Linux +This page is part of release 5.07 of the Linux .Em man-pages project. A description of the project, diff --git a/man3/raise.3 b/man3/raise.3 index aec22a565..8cc4b8ec6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rand.3 b/man3/rand.3 index 0d985b8fb..7ee66977b 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -38,7 +38,7 @@ .\" Modified 2003-11-15, aeb, added rand_r .\" 2010-09-13, mtk, added example program .\" -.TH RAND 3 2019-03-06 "" "Linux Programmer's Manual" +.TH RAND 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME rand, rand_r, srand \- pseudo-random number generator .SH SYNOPSIS @@ -177,7 +177,7 @@ when good randomness is needed. (Use .BR random (3) instead.) -.SH EXAMPLE +.SH EXAMPLES POSIX.1-2001 gives the following example of an implementation of .BR rand () and @@ -238,7 +238,7 @@ main(int argc, char *argv[]) .BR drand48 (3), .BR random (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/random.3 b/man3/random.3 index fa3186f7c..d8188226f 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -30,7 +30,7 @@ .\" Modified Sat Jul 24 18:13:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Aug 20 21:47:07 2000, aeb .\" -.TH RANDOM 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH RANDOM 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME random, srandom, initstate, setstate \- random number generator .SH SYNOPSIS @@ -69,7 +69,7 @@ The function uses a nonlinear additive feedback random number generator employing a default table of size 31 long integers to return successive pseudo-random numbers in -the range from 0 to \fBRAND_MAX\fR. +the range from 0 to 2^31\ \-\ 1. The period of this random number generator is very large, approximately .IR "16\ *\ ((2^31)\ \-\ 1)" . .PP @@ -125,7 +125,7 @@ or be the result of a previous call of The .BR random () function returns a value between 0 and -.BR RAND_MAX . +.IR "(2^31)\ \-\ 1" . The .BR srandom () function returns no value. @@ -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.06 of the Linux +This page is part of release 5.07 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 16215cea6..91769a526 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rcmd.3 b/man3/rcmd.3 index a56fc8140..6984369c8 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.06 of the Linux +This page is part of release 5.07 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 da9904976..d515cf385 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/readdir.3 b/man3/readdir.3 index 38df5e24c..a5aa461de 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -177,7 +177,7 @@ is not changed. If an error occurs, NULL is returned and .I errno is set appropriately. -To distinguish end of stream and from an error, set +To distinguish end of stream from an error, set .I errno to zero before calling .BR readdir () @@ -312,7 +312,7 @@ structure shown above. .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 37e4b21c2..f888eb05c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/realpath.3 b/man3/realpath.3 index 6061ab6bd..ce6a624c5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/recno.3 b/man3/recno.3 index 5ea65ca57..ca2fb95fa 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/regex.3 b/man3/regex.3 index da997b491..b5276f589 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -349,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remainder.3 b/man3/remainder.3 index 96ead50d9..c9edeaed1 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -34,7 +34,7 @@ .\" (walter.harms@informatik.uni-oldenburg.de) .\" Modified 2003-11-18, 2004-10-05 aeb .\" -.TH REMAINDER 3 2017-09-15 "" "Linux Programmer's Manual" +.TH REMAINDER 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME drem, dremf, dreml, remainder, remainderf, remainderl \- \ floating-point remainder function @@ -234,14 +234,14 @@ for the domain error that occurs when is an infinity and .I y is not a NaN. -.SH EXAMPLE +.SH EXAMPLES The call "remainder(29.0, 3.0)" returns \-1. .SH SEE ALSO .BR div (3), .BR fmod (3), .BR remquo (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remove.3 b/man3/remove.3 index f84499f20..6099bfe7f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remquo.3 b/man3/remquo.3 index 6a488eda0..54dbf57f5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/resolver.3 b/man3/resolver.3 index efb949e81..244550cc1 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -377,7 +377,7 @@ Do not strip TSIG records. This option was present but unimplemented in glibc until version 2.24; since glibc 2.25, it is deprecated, and its usage produces a warning. .TP -.B RES_BLAST " (unimplemented; deprecated in glibc 2.25)" +.BR RES_BLAST " (unimplemented; deprecated in glibc 2.25)" Send each query simultaneously and recursively to all servers. This option was present but unimplemented in glibc until version 2.24; since glibc 2.25, it is deprecated, and its usage produces a warning. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index 0ed789f2e..232032481 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rexec.3 b/man3/rexec.3 index 6a8ebf58d..f4cba9d3e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rint.3 b/man3/rint.3 index d8baee8ce..9b8954f4b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/round.3 b/man3/round.3 index 51cc447c4..8e7b11902 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpc.3 b/man3/rpc.3 index 3f751e775..eba726369 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index 98b9d99a0..7c1508b29 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -26,7 +26,7 @@ .\" .\" 2006-05-19, mtk, various edits and example program .\" -.TH RPMATCH 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH RPMATCH 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME rpmatch \- determine if the answer to a question is affirmative or negative .SH SYNOPSIS @@ -132,7 +132,7 @@ expression notation described in .B ^([yY]|yes|YES)$ and .BR ^([nN]|no|NO)$ . -.SH EXAMPLE +.SH EXAMPLES The following program displays the results when .BR rpmatch () is applied to the string given in the program's command-line argument. @@ -164,7 +164,7 @@ main(int argc, char *argv[]) .BR regcomp (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtime.3 b/man3/rtime.3 index 658c8ffc7..e9b0b26cb 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -9,7 +9,7 @@ .\" .\" Slightly polished, aeb, 2003-04-06 .\" -.TH RTIME 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH RTIME 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME rtime \- get time from a remote machine .SH SYNOPSIS @@ -89,7 +89,7 @@ instead of .SH BUGS .BR rtime () in glibc 2.2.5 and earlier does not work properly on 64-bit machines. -.SH EXAMPLE +.SH EXAMPLES This example requires that port 37 is up and open. You may check that the time entry within @@ -143,7 +143,7 @@ main(void) .\" .BR rdate (1), .BR inetd (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index bc2379cbb..b9542c43a 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -9,7 +9,7 @@ .\" .\" $Id: rtnetlink.3,v 1.2 1999/05/18 10:35:10 freitag Exp $ .\" -.TH RTNETLINK 3 2014-09-06 "GNU" "Linux Programmer's Manual" +.TH RTNETLINK 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME rtnetlink \- macros to manipulate rtnetlink messages .SH SYNOPSIS @@ -83,7 +83,7 @@ bytes of data. These macros are nonstandard Linux extensions. .SH BUGS This manual page is incomplete. -.SH EXAMPLE +.SH EXAMPLES .\" FIXME . ? would be better to use libnetlink in the EXAMPLE code here Creating a rtnetlink message to set the MTU of a device: .PP @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalb.3 b/man3/scalb.3 index a682c7004..8df3ecf00 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SCALB 3 2017-09-15 "" "Linux Programmer's Manual" +.TH SCALB 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME scalb, scalbf, scalbl \- multiply floating-point number by integral power of radix (OBSOLETE) @@ -150,34 +150,28 @@ The following errors can occur: Domain error: \fIx\fP is 0, and \fIexp\fP is positive infinity, \ or \fIx\fP is positive infinity and \fIexp\fP is negative infinity \ and the other argument is not a NaN -.\" .I errno -.\" is set to -.\" .BR EDOM . +.I errno +is set to +.BR EDOM . An invalid floating-point exception .RB ( FE_INVALID ) is raised. .TP Range error, overflow -.\" .I errno -.\" is set to -.\" .BR ERANGE . +.I errno +is set to +.BR ERANGE . An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. .TP Range error, underflow -.\" .I errno -.\" is set to -.\" .BR ERANGE . +.I errno +is set to +.BR ERANGE . An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. -.PP -These functions do not set -.IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804 .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -215,11 +209,18 @@ are unstandardized; is nevertheless present on several other systems .\" Looking at header files: scalbf() is present on the .\" BSDs, Tru64, HP-UX 11, Irix 6.5; scalbl() is on HP-UX 11 and Tru64. +.SH BUGS +Before glibc 2.20, +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804 +these functions did not set +.I errno +for domain and range errors. .SH SEE ALSO .BR ldexp (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalbln.3 b/man3/scalbln.3 index cc2a6dd1e..1953fd26f 100644 --- a/man3/scalbln.3 +++ b/man3/scalbln.3 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SCALBLN 3 2017-09-15 "" "Linux Programmer's Manual" +.TH SCALBLN 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- multiply floating-point number by integral power of radix @@ -139,17 +139,12 @@ An overflow floating-point exception is raised. .TP Range error, underflow -.\" .I errno -.\" is set to -.\" .BR ERANGE . +.I errno +is set to +.BR ERANGE . An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. -.PP -These functions do not set -.IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 .SH VERSIONS These functions first appeared in glibc in version 2.1. .SH ATTRIBUTES @@ -188,11 +183,17 @@ equals 2 (which is usual), then .BR scalbn () is equivalent to .BR ldexp (3). +.SH BUGS +Before glibc 2.20, +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 +these functions did not set +.I errno +for range errors. .SH SEE ALSO .BR ldexp (3), .BR scalb (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scandir.3 b/man3/scandir.3 index f4e7a7bc5..6ada5156b 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -59,7 +59,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH SCANDIR 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH SCANDIR 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME scandir, scandirat, alphasort, versionsort \- scan a directory for matching entries @@ -287,7 +287,7 @@ and glibc 2.10 changed the definition of (and the nonstandard .BR versionsort ()) to match the standard. -.SH EXAMPLE +.SH EXAMPLES The program below prints a list of the files in the current directory in reverse order. .\" @@ -332,7 +332,7 @@ main(void) .BR strverscmp (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scanf.3 b/man3/scanf.3 index 9de888ec7..b81eda7b7 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -427,7 +427,12 @@ pointer to .IR "unsigned int" . .TP .B x -Matches an unsigned hexadecimal integer; the next pointer must +Matches an unsigned hexadecimal integer +(that may optionally begin with a prefix of +.I 0x +or +.IR 0X , +which is discarded); the next pointer must be a pointer to .IR "unsigned int" . .TP @@ -511,7 +516,7 @@ circumflex, in) set or when the field width runs out. Matches a pointer value (as printed by .B %p in -.BR printf (3); +.BR printf (3)); the next pointer must be a pointer to a pointer to .IR void . .TP @@ -726,7 +731,7 @@ The usage of is not the same as on 4.4BSD, as it may be used in float conversions equivalently to .BR L . -.SH EXAMPLE +.SH EXAMPLES To use the dynamic allocation conversion specifier, specify .B m as a length modifier (thus @@ -768,7 +773,7 @@ call successfully read a string. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 b5fc19543..70a8ee307 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 40d5c9420..1c0a7bc6a 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.06 of the Linux +This page is part of release 5.07 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 7fe9e76e1..40bf296d4 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.06 of the Linux +This page is part of release 5.07 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 14f859747..238e24732 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.06 of the Linux +This page is part of release 5.07 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 67783d4e0..ef449386c 100644 --- a/man3/sem_getvalue.3 +++ b/man3/sem_getvalue.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_GETVALUE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SEM_GETVALUE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sem_getvalue \- get the value of a semaphore .SH SYNOPSIS @@ -62,6 +62,9 @@ is set to indicate the error. .B EINVAL .I sem is not a valid semaphore. +(The glibc implementation currently does not check whether +.I sem +is valid.) .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -85,7 +88,7 @@ returns. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 dd320e846..8d78f30ce 100644 --- a/man3/sem_init.3 +++ b/man3/sem_init.3 @@ -111,7 +111,7 @@ Bizarrely, POSIX.1-2001 does not specify the value that should be returned by a successful call to .BR sem_init (). POSIX.1-2008 rectifies this, specifying the zero return on success. -.SH EXAMPLE +.SH EXAMPLES See .BR shm_open (3) and @@ -122,7 +122,7 @@ and .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 9e944d31b..4de677e40 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.06 of the Linux +This page is part of release 5.07 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 d7b39cdd9..86cad591f 100644 --- a/man3/sem_post.3 +++ b/man3/sem_post.3 @@ -76,7 +76,7 @@ POSIX.1-2001. .BR sem_post () is async-signal-safe: it may be safely called within a signal handler. -.SH EXAMPLE +.SH EXAMPLES See .BR sem_wait (3) and @@ -87,7 +87,7 @@ and .BR sem_overview (7), .BR signal-safety (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 3504d4749..323b0170c 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.06 of the Linux +This page is part of release 5.07 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 6b29d8b06..5294520a7 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_WAIT 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SEM_WAIT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sem_wait, sem_timedwait, sem_trywait \- lock a semaphore .SH SYNOPSIS @@ -156,7 +156,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .PP The (somewhat trivial) program shown below operates on an unnamed semaphore. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index fea7e0a54..98a513541 100644 --- a/man3/setaliasent.3 +++ b/man3/setaliasent.3 @@ -6,7 +6,7 @@ .\" .\" Polished a bit, added a little, aeb .\" -.TH SETALIASENT 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH SETALIASENT 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME setaliasent, endaliasent, getaliasent, getaliasent_r, getaliasbyname, getaliasbyname_r \- read an alias entry @@ -133,7 +133,7 @@ alias_ent *alias_getent(void); alias_ent *alias_getbyname(char *name); .EE .in -.SH EXAMPLE +.SH EXAMPLES The following example compiles with .IR "gcc example.c \-o example" . It will dump all names in the alias database. @@ -173,7 +173,7 @@ main(void) .\" Yellow Pages .\" newaliases, postalias .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setbuf.3 b/man3/setbuf.3 index b29093f5f..50340d11d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setenv.3 b/man3/setenv.3 index 30b04f4d3..2ccb3b673 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -104,16 +104,10 @@ If does not exist in the environment, then the function succeeds, and the environment is unchanged. .SH RETURN VALUE -The .BR setenv () -function returns zero on success, -or \-1 on error, with -.I errno -set to indicate the cause of the error. -.PP -The +and .BR unsetenv () -function returns zero on success, +functions return zero on success, or \-1 on error, with .I errno set to indicate the cause of the error. @@ -172,7 +166,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setjmp.3 b/man3/setjmp.3 index eb373a731..fbac49b0a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 6299b4023..0eb5a3722 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index 3c5694acd..2b89400b8 100644 --- a/man3/setlogmask.3 +++ b/man3/setlogmask.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SETLOGMASK 3 2017-09-15 "" "Linux Programmer's Manual" +.TH SETLOGMASK 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME setlogmask \- set log priority mask .SH SYNOPSIS @@ -88,12 +88,16 @@ T} Thread safety MT-Unsafe race:LogMask .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .\" Note that the description in POSIX.1-2001 is flawed. +.PP +.BR LOG_UPTO () +will be included in the next release of the POSIX specification (Issue 8). +.\" FIXME . https://www.austingroupbugs.net/view.php?id=1033 .SH SEE ALSO .BR closelog (3), .BR openlog (3), .BR syslog (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 397714859..875085b9f 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.06 of the Linux +This page is part of release 5.07 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 4828309d3..410a19821 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -285,7 +285,7 @@ of a dedicated .BR tmpfs (5) filesystem that is normally mounted under .IR /dev/shm . -.SH EXAMPLE +.SH EXAMPLES The programs below employ POSIX shared memory and POSIX unnamed semaphores to exchange a piece of data. The "bounce" program (which must be run first) raises the case @@ -355,6 +355,10 @@ to tell the "send" program that it may now access the shared memory. .PP .in +4n .EX +/* pshm_ucase_bounce.c + + Licensed under GNU General Public License v2 or later. +*/ #include <ctype.h> #include "pshm_ucase.h" @@ -441,6 +445,10 @@ on standard output. .PP .in +4n .EX +/* pshm_ucase_send.c + + Licensed under GNU General Public License v2 or later. +*/ #include <string.h> #include "pshm_ucase.h" @@ -513,7 +521,7 @@ main(int argc, char *argv[]) .BR umask (2), .BR shm_overview (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index dce8b540b..42459826a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/signbit.3 b/man3/signbit.3 index c594d28ef..8a2c88d2e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/significand.3 b/man3/significand.3 index d1b53db26..d6ddd5f60 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigpause.3 b/man3/sigpause.3 index b4508e279..c68409c15 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigqueue.3 b/man3/sigqueue.3 index c0be58809..573063e73 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigset.3 b/man3/sigset.3 index 8a484d0b9..a3e0d3e80 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigsetops.3 b/man3/sigsetops.3 index 9afa6abf3..17d7007e9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigvec.3 b/man3/sigvec.3 index 976f14fa6..7a8f979a9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 8cb111719..4daf97a2f 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGWAIT 3 2017-07-13 "Linux" "Linux Programmer's Manual" +.TH SIGWAIT 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sigwait \- wait for a signal .SH SYNOPSIS @@ -109,7 +109,7 @@ are used internally by the NPTL threading implementation. See .BR nptl (7) for details. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_sigmask (3). .SH SEE ALSO @@ -121,7 +121,7 @@ See .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sin.3 b/man3/sin.3 index 56dadf631..2099f48c7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sincos.3 b/man3/sincos.3 index 101f1c839..afd7e9fc5 100644 --- a/man3/sincos.3 +++ b/man3/sincos.3 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH SINCOS 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH SINCOS 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME sincos, sincosf, sincosl \- calculate sin and cos simultaneously .SH SYNOPSIS @@ -60,19 +60,13 @@ when calling these functions. The following errors can occur: .TP Domain error: \fIx\fP is an infinity -.\" .I errno -.\" is set to -.\" .BR EDOM . +.I errno +is set to +.BR EDOM +(but see BUGS). An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.PP -These functions do not set -.IR errno . -.\" FIXME . Is it intentional that these functions do not set errno? -.\" sin() and cos() also don't set errno; bugs have been raised for -.\" those functions. -.\" See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467 .SH VERSIONS These functions first appeared in glibc in version 2.1. .SH ATTRIBUTES @@ -103,12 +97,19 @@ built-in optimizations, using flags such as: cc -O \-lm \-fno\-builtin prog.c .EE .in +.SH BUGS +Before version 2.22, the glibc implementation did not set +.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467 +.I errno +to +.B EDOM +when a domain error occurred. .SH SEE ALSO .BR cos (3), .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sinh.3 b/man3/sinh.3 index ed51f0f6e..94dc5aec9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sleep.3 b/man3/sleep.3 index 88dbe77c4..6c384317c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index 213947a5f..9eba41460 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SOCKATMARK 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SOCKATMARK 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sockatmark \- determine whether socket is at out-of-band mark .SH SYNOPSIS @@ -108,7 +108,7 @@ operation. Prior to glibc 2.4, .BR sockatmark () did not work. -.SH EXAMPLE +.SH EXAMPLES The following code can be used after receipt of a .B SIGURG signal to read (and discard) all data up to the mark, @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sqrt.3 b/man3/sqrt.3 index f3a960fc5..b62fdc51c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/statvfs.3 b/man3/statvfs.3 index dcbf47d47..3a0a7d7a1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdarg.3 b/man3/stdarg.3 index 14f22fff9..6cbd4a4ab 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -40,7 +40,7 @@ .\" Converted for Linux, Mon Nov 29 15:11:11 1993, faith@cs.unc.edu .\" Additions, 2001-10-14, aeb .\" -.TH STDARG 3 2019-05-09 "" "Linux Programmer's Manual" +.TH STDARG 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME stdarg, va_start, va_arg, va_end, va_copy \- variable argument lists .SH SYNOPSIS @@ -269,7 +269,7 @@ pass all of their arguments on to a function that takes a .I va_list argument, such as .BR vfprintf (3). -.SH EXAMPLE +.SH EXAMPLES The function .I foo takes a string of format characters and prints out the argument associated @@ -308,8 +308,12 @@ foo(char *fmt, ...) /* '...' is C syntax for a variadic function */ va_end(ap); } .EE +.SH SEE ALSO +.BR vprintf (3), +.BR vscanf (3), +.BR vsyslog (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdin.3 b/man3/stdin.3 index ff5569e32..5e3c43c9a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdio.3 b/man3/stdio.3 index bfe407d63..a0131f1b2 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.06 of the Linux +This page is part of release 5.07 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 b75d25284..375817c82 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index 50b7d432f..739c154b1 100644 --- a/man3/stpcpy.3 +++ b/man3/stpcpy.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH STPCPY 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH STPCPY 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME stpcpy \- copy a string returning a pointer to its end .SH SYNOPSIS @@ -92,7 +92,7 @@ It is also present on the BSDs. .SH BUGS This function may overrun the buffer .IR dest . -.SH EXAMPLE +.SH EXAMPLES For example, this program uses .BR stpcpy () to concatenate @@ -129,7 +129,7 @@ main(void) .BR string (3), .BR wcpcpy (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpncpy.3 b/man3/stpncpy.3 index a0cba9d4e..f16145125 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index b7d0f2832..0a9681bd5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcat.3 b/man3/strcat.3 index e1ea7cc18..d612122ca 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 18:11:47 1993 by Rik Faith (faith@cs.unc.edu) .\" 2007-06-15, Marc Boyer <marc.boyer@enseeiht.fr> + mtk .\" Improve discussion of strncat(). -.TH STRCAT 3 2019-08-02 "GNU" "Linux Programmer's Manual" +.TH STRCAT 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME strcat, strncat \- concatenate two strings .SH SYNOPSIS @@ -180,7 +180,7 @@ but is available on Linux via the .IR libbsd library. .\" -.SH EXAMPLE +.SH EXAMPLES Because .BR strcat () and @@ -233,7 +233,7 @@ main(int argc, char *argv[]) .BR wcscat (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strchr.3 b/man3/strchr.3 index 408fa7c17..1be26d53b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcmp.3 b/man3/strcmp.3 index cff527749..991010a35 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -126,7 +126,7 @@ the last compared byte in from the last compared byte in .IR s1 . (If the two characters are equal, this difference is 0.) -.SH EXAMPLE +.SH EXAMPLES The program below can be used to demonstrate the operation of .BR strcmp () (when given two arguments) and @@ -170,6 +170,10 @@ $ \fB./string_comp ABC AB 2\fP .SS Program source \& .EX +/* string_comp.c + + Licensed under GNU General Public License v2 or later. +*/ #include <stdio.h> #include <stdlib.h> #include <string.h> @@ -212,10 +216,10 @@ main(int argc, char *argv[]) .BR strncasecmp (3), .BR strverscmp (3), .BR wcscmp (3), -.BR wcsncmp (3) +.BR wcsncmp (3), .BR ascii (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcoll.3 b/man3/strcoll.3 index ab9a12c95..0e6188728 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcpy.3 b/man3/strcpy.3 index dca75a5d7..610704b3c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strdup.3 b/man3/strdup.3 index 21d3be2eb..c473b78a3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strerror.3 b/man3/strerror.3 index 674499f31..0bb514b6b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfmon.3 b/man3/strfmon.3 index 766596146..3fac48cd0 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH STRFMON 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH STRFMON 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME strfmon, strfmon_l \- convert monetary value to a string .SH SYNOPSIS @@ -175,7 +175,7 @@ T} Thread safety MT-Safe .sp 1 .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES The call .PP .in +4n @@ -218,7 +218,7 @@ locales yield .BR sprintf (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfromd.3 b/man3/strfromd.3 index 1a1320aca..2c1200c89 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfry.3 b/man3/strfry.3 index d66cd6029..7b3cb760e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strftime.3 b/man3/strftime.3 index 74ff6ae93..a1fcb0e76 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -573,10 +573,10 @@ Week 1 is the first week where four or more days fall within the new year (or, synonymously, week 01 is: the first week of the year that contains a Thursday; or, the week that has 4 January in it). -When three of fewer days of the first calendar week of the new year fall +When three or fewer days of the first calendar week of the new year fall within that year, -then the ISO 8601 week-based system counts those days as part of week 53 -of the preceding year. +then the ISO 8601 week-based system counts those days as part of week 52 +or 53 of the preceding year. For example, 1 January 2010 is a Friday, meaning that just three days of that calendar week fall in 2010. Thus, the ISO\ 8601 week-based system considers these days to be part of @@ -585,6 +585,8 @@ week 53 of the year 2009 .RB ( %G ); week 01 of ISO\ 8601 year 2010 starts on Monday, 4 January 2010. +Similarly, the first two days of January 2011 are considered to be part +of week 52 of the year 2010. .SS Glibc notes Glibc provides some extensions for conversion specifications. (These extensions are not specified in POSIX.1-2001, but a few other @@ -679,7 +681,7 @@ provides the .IR \-Wno\-format\-y2k option to prevent the warning, so that the above workaround is no longer required. -.SH EXAMPLE +.SH EXAMPLES .BR "RFC\ 2822-compliant date format" (with an English locale for %a and %b) .PP @@ -748,7 +750,7 @@ main(int argc, char *argv[]) .BR sprintf (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/string.3 b/man3/string.3 index d1a8714bd..58164faec 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strlen.3 b/man3/strlen.3 index d646f81f1..7d6622566 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strnlen.3 b/man3/strnlen.3 index 6ab9e2645..ba58abbf4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index da1422000..2a38ba5b3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strptime.3 b/man3/strptime.3 index 7c0f8d9cc..6fec9881c 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -28,7 +28,7 @@ .\" Modified, aeb, 2001-08-31 .\" Modified, wharms 2001-11-12, remark on white space and example .\" -.TH STRPTIME 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH STRPTIME 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME strptime \- convert a string representation of time to a time tm structure .SH SYNOPSIS @@ -411,7 +411,7 @@ Leap seconds are not counted unless leap second support is available. .PP The glibc implementation does not require whitespace between two field descriptors. -.SH EXAMPLE +.SH EXAMPLES The following example demonstrates the use of .BR strptime () and @@ -444,7 +444,7 @@ main(void) .BR setlocale (3), .BR strftime (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsep.3 b/man3/strsep.3 index e03ee8b05..697ac8772 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 8f7ab2bb3..4fb64260c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strspn.3 b/man3/strspn.3 index 88aca264c..57aba525f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strstr.3 b/man3/strstr.3 index cd2ac1729..e8a5f43da 100644 --- a/man3/strstr.3 +++ b/man3/strstr.3 @@ -84,18 +84,6 @@ POSIX.1-2001, POSIX.1-2008, C89, C99. The .BR strcasestr () function is a nonstandard extension. -.\" .SH BUGS -.\" Early versions of Linux libc (like 4.5.26) would not allow -.\" an empty -.\" .I needle -.\" argument for -.\" .BR strstr (). -.\" Later versions (like 4.6.27) work correctly, -.\" and return -.\" .IR haystack -.\" when -.\" .I needle -.\" is empty. .SH SEE ALSO .BR index (3), .BR memchr (3), @@ -110,7 +98,7 @@ function is a nonstandard extension. .BR strtok (3), .BR wcsstr (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtod.3 b/man3/strtod.3 index 68d885229..ff4870bfd 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -42,7 +42,7 @@ .\" (michael@cantor.informatik.rwth-aachen.de) .\" Added strof, strtold, aeb, 2001-06-07 .\" -.TH STRTOD 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH STRTOD 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME strtod, strtof, strtold \- convert ASCII string to floating-point number .SH SYNOPSIS @@ -197,7 +197,7 @@ mantissa component of the returned value. .\" something similar. .\" C11 says: "An implementation may use the n-char sequence to determine .\" extra information to be represented in the NaN's significant." -.SH EXAMPLE +.SH EXAMPLES See the example on the .BR strtol (3) manual page; @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoimax.3 b/man3/strtoimax.3 index 69ec2b192..b9e012c56 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtok.3 b/man3/strtok.3 index a4ac1db6a..41d295ca8 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-10-10 "GNU" "Linux Programmer's Manual" +.TH STRTOK 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME strtok, strtok_r \- extract tokens from strings .SH SYNOPSIS @@ -213,7 +213,7 @@ function uses a static buffer while parsing, so it's not thread safe. Use .BR strtok_r () if this matters to you. -.SH EXAMPLE +.SH EXAMPLES The program below uses nested loops that employ .BR strtok_r () to break a string into a two-level hierarchy of tokens. @@ -292,7 +292,7 @@ can be found in .BR strstr (3), .BR wcstok (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtol.3 b/man3/strtol.3 index 32096cec6..b6247dfab 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-10-10 "GNU" "Linux Programmer's Manual" +.TH STRTOL 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME strtol, strtoll, strtoq \- convert a string to a long integer .SH SYNOPSIS @@ -213,7 +213,7 @@ may be equivalent to .BR strtoll () or to .BR strtol (). -.SH EXAMPLE +.SH EXAMPLES The program shown below demonstrates the use of .BR strtol (). The first command-line argument specifies a string from which @@ -299,10 +299,10 @@ main(int argc, char *argv[]) .BR atoi (3), .BR atol (3), .BR strtod (3), -.BR strtoimax (3) +.BR strtoimax (3), .BR strtoul (3), .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoul.3 b/man3/strtoul.3 index edfd6c98a..856611458 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -30,7 +30,7 @@ .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" -.TH STRTOUL 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH STRTOUL 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME strtoul, strtoull, strtouq \- convert a string to an unsigned long integer .SH SYNOPSIS @@ -217,7 +217,7 @@ Negative values are considered valid input and are silently converted to the equivalent .I "unsigned long int" value. -.SH EXAMPLE +.SH EXAMPLES See the example on the .BR strtol (3) manual page; @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index 25e2775a5..48e3d5798 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH STRVERSCMP 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH STRVERSCMP 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME strverscmp \- compare two version strings .SH SYNOPSIS @@ -111,7 +111,7 @@ T} Thread safety MT-Safe .\" problem. .SH CONFORMING TO This function is a GNU extension. -.SH EXAMPLE +.SH EXAMPLES The program below can be used to demonstrate the behavior of .BR strverscmp (). It uses @@ -157,7 +157,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR strcoll (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index 82780e8ec..e62a50623 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/swab.3 b/man3/swab.3 index cb4976ebe..bd083eacb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sysconf.3 b/man3/sysconf.3 index 95823c1bb..211c3759d 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -259,7 +259,7 @@ indicates the maximum length of a string accepted by indicates the maximum numbers of weights that can be assigned to an entry of the .B LC_COLLATE order -keyword in the locale definition file, +keyword in the locale definition file. .TP .BR EXPR_NEST_MAX " - " _SC_EXPR_NEST_MAX is the maximum number of expressions which can be nested within @@ -294,7 +294,7 @@ supported. indicates whether the POSIX.2 FORTRAN run-time utilities are supported. .TP .BR _POSIX2_LOCALEDEF " - " _SC_2_LOCALEDEF -indicates whether the POSIX.2 creation of locates via +indicates whether the POSIX.2 creation of locales via .BR localedef (1) is supported. .TP @@ -401,7 +401,7 @@ memory. .BR pathconf (3), .BR posixoptions (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/syslog.3 b/man3/syslog.3 index 18c2d4f60..18574f9a2 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/system.3 b/man3/system.3 index 8070e9bfc..7a29bdda4 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.06 of the Linux +This page is part of release 5.07 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 d727dbfb9..5f697ba30 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tan.3 b/man3/tan.3 index 5a8d334be..ef2b06d95 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tanh.3 b/man3/tanh.3 index 20f35ba50..b9ecdf414 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetpgrp.3 b/man3/tcgetpgrp.3 index 721511d9e..2e264ec34 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index 1aed66b2d..a84d5e581 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/telldir.3 b/man3/telldir.3 index 031fb871b..bb64e6311 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tempnam.3 b/man3/tempnam.3 index 9101b49c0..721c4061d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/termios.3 b/man3/termios.3 index cfaa46b48..d8f721294 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tgamma.3 b/man3/tgamma.3 index 71176cda7..9171997a8 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timegm.3 b/man3/timegm.3 index bdc911c91..d5272d994 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timeradd.3 b/man3/timeradd.3 index 03ababd5d..e29289634 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index 3b7ab63f3..adbdefad1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index ecb6e636f..7a64d6cbb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toascii.3 b/man3/toascii.3 index 564d432d9..c6eca2bf4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toupper.3 b/man3/toupper.3 index 684037d9b..d26d2b595 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towctrans.3 b/man3/towctrans.3 index 473bcd124..541977446 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towlower.3 b/man3/towlower.3 index d190f2065..3fa376fec 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towupper.3 b/man3/towupper.3 index 81fa00f46..2e8411e2d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/trunc.3 b/man3/trunc.3 index d674a28dc..732f76c74 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tsearch.3 b/man3/tsearch.3 index 425514fff..be2625f67 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH TSEARCH 3 2019-05-09 "GNU" "Linux Programmer's Manual" +.TH TSEARCH 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME tsearch, tfind, tdelete, twalk, tdestroy \- manage a binary search tree .SH SYNOPSIS @@ -263,7 +263,7 @@ further reference to a node after calling the user function with argument "endorder" or "leaf". This works with the GNU library implementation, but is not in the System V documentation. -.SH EXAMPLE +.SH EXAMPLES The following program inserts twelve random numbers into a binary tree, where duplicate numbers are collapsed, then prints the numbers in order. @@ -346,7 +346,7 @@ main(void) .BR lsearch (3), .BR qsort (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyname.3 b/man3/ttyname.3 index 944111e04..ea14ab9df 100644 --- a/man3/ttyname.3 +++ b/man3/ttyname.3 @@ -118,7 +118,7 @@ to .BR isatty (3), .BR pts (4) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index 06d40d010..f690a6e0e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tzset.3 b/man3/tzset.3 index 485f50a24..2105ccaf6 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -158,6 +158,7 @@ where the standard time (NZST) is 12 hours ahead of UTC, and daylight saving time (NZDT), 13 hours ahead of UTC, runs from the first Sunday in October to the third Sunday in March, and the changeovers happen at the default time of 02:00:00: +.PP .in +4n .EX TZ="NZST-12:00:00NZDT-13:00:00,M10.1.0,M3.3.0" @@ -249,7 +250,7 @@ otherwise the daylight saving time version. .BR getenv (3), .BR tzfile (5) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ualarm.3 b/man3/ualarm.3 index 526872008..4519c5d7b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ulimit.3 b/man3/ulimit.3 index 03c030652..2ce858e35 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/undocumented.3 b/man3/undocumented.3 index d97a9ffbd..df69677b1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ungetwc.3 b/man3/ungetwc.3 index 2c2c52fdb..79c29567c 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.06 of the Linux +This page is part of release 5.07 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 e30a58172..d29a65866 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index 518738bb4..cf26702bc 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/updwtmp.3 b/man3/updwtmp.3 index cdf3c5ca3..7570e0927 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/uselocale.3 b/man3/uselocale.3 index 0f5e3d54a..85efab7c4 100644 --- a/man3/uselocale.3 +++ b/man3/uselocale.3 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH USELOCALE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH USELOCALE 3 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME uselocale \- set/get the locale for the calling thread .SH SYNOPSIS @@ -110,7 +110,7 @@ and .BR newlocale (3) to obtain a locale object equivalent to the current locale and modify the desired categories in that object. -.SH EXAMPLE +.SH EXAMPLES See .BR newlocale (3) and @@ -124,7 +124,7 @@ and .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/usleep.3 b/man3/usleep.3 index 71a1a30bf..b4a839be5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpcpy.3 b/man3/wcpcpy.3 index cba0242d8..23955ea64 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpncpy.3 b/man3/wcpncpy.3 index 1c680dad6..b96f6deb1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index 85546b058..c34fb431c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscasecmp.3 b/man3/wcscasecmp.3 index 4e23d5ed2..a4e06a29e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscat.3 b/man3/wcscat.3 index 3123877f8..31bffb4b5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcschr.3 b/man3/wcschr.3 index 6749a3181..4fd5e2864 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscmp.3 b/man3/wcscmp.3 index 69ada1064..1982e5c1a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscpy.3 b/man3/wcscpy.3 index 3274c64fb..a0a28987c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscspn.3 b/man3/wcscspn.3 index 6a86195ae..33ea692e9 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsdup.3 b/man3/wcsdup.3 index 5d0d8ee73..ecdd5183b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcslen.3 b/man3/wcslen.3 index 7d931a438..9ad95f21d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3 index 8a5353114..1a88260d3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncat.3 b/man3/wcsncat.3 index d400f9c7a..585d97ea7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncmp.3 b/man3/wcsncmp.3 index 2fee02edb..464073560 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3 index b9833eb6d..fc42dac3c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index 6e9eae519..eaea99836 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index 06a5c649c..aca4dad89 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcspbrk.3 b/man3/wcspbrk.3 index b89785e50..5c328d9ad 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrchr.3 b/man3/wcsrchr.3 index 583e0ce74..6277bbb57 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index c390e256c..7ac4cc5a1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsspn.3 b/man3/wcsspn.3 index 13d5182c2..de9377270 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsstr.3 b/man3/wcsstr.3 index e9e966ffe..416a9597b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstoimax.3 b/man3/wcstoimax.3 index 4d8eb2601..bfa6d1c02 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstok.3 b/man3/wcstok.3 index d32af38c1..e492116be 100644 --- a/man3/wcstok.3 +++ b/man3/wcstok.3 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH WCSTOK 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH WCSTOK 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME wcstok \- split wide-character string into tokens .SH SYNOPSIS @@ -95,7 +95,7 @@ The original .I wcs wide-character string is destructively modified during the operation. -.SH EXAMPLE +.SH EXAMPLES The following code loops over the tokens contained in a wide-character string. .PP .EX @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 63b22fe13..6c2f0363d 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH WCSTOMBS 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH WCSTOMBS 3 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME wcstombs \- convert a wide-character string to a multibyte string .SH SYNOPSIS @@ -117,10 +117,10 @@ provides a better interface to the same functionality. .BR mblen (3), .BR mbstowcs (3), .BR mbtowc (3), -.BR wcsrtombs (3) +.BR wcsrtombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcswidth.3 b/man3/wcswidth.3 index b3c7c78aa..83ca641db 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctob.3 b/man3/wctob.3 index d35eafb10..92ce72c8e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctomb.3 b/man3/wctomb.3 index 1d979d95c..2193eaf5f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctrans.3 b/man3/wctrans.3 index a5db31b09..d47e4d090 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctype.3 b/man3/wctype.3 index b298f2d6d..080ca6d06 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcwidth.3 b/man3/wcwidth.3 index 863689d15..34c21eb63 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemchr.3 b/man3/wmemchr.3 index 138924ef5..c9eb8934d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcmp.3 b/man3/wmemcmp.3 index 28e56dde7..4b66d69a1 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcpy.3 b/man3/wmemcpy.3 index 7f0cc0cf8..aebbbfb51 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemmove.3 b/man3/wmemmove.3 index fbadf755f..ea4a35ce0 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemset.3 b/man3/wmemset.3 index 0939530e0..6756baf7b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 7bc66c1b6..0d5d167c4 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH WORDEXP 3 2017-09-15 "" "Linux Programmer's Manual" +.TH WORDEXP 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME wordexp, wordfree \- perform word expansion like a posix-shell .SH SYNOPSIS @@ -220,7 +220,7 @@ calls those functions, so we use race:utent to remind users. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES The output of the following example program is approximately that of "ls [a-c]*.c". .PP @@ -248,7 +248,7 @@ main(int argc, char **argv) .BR fnmatch (3), .BR glob (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wprintf.3 b/man3/wprintf.3 index dc8fe88e0..1dfa6101e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xcrypt.3 b/man3/xcrypt.3 index 3d46aa4e2..1ec637945 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xdr.3 b/man3/xdr.3 index 77102b3a5..299664118 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, @@ -33,7 +33,7 @@ .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" 2008-07-24, mtk, created this page, based on material from j0.3. .\" -.TH Y0 3 2017-09-15 "" "Linux Programmer's Manual" +.TH Y0 3 2020-06-09 "" "Linux Programmer's Manual" .SH NAME y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- Bessel functions of the second kind @@ -187,41 +187,31 @@ Pole error: \fIx\fP is 0.0 .\" as a range error. .I errno is set to -.\" FIXME . y0(0.0) gives EDOM .BR ERANGE -(but see BUGS). -No +and an .B FE_DIVBYZERO -exception is returned by -.BR fetestexcept (3) -for this case. -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808 +exception is raised +(but see BUGS). .TP Range error: result underflow .\" e.g., y0(1e33) on glibc 2.8/x86-32 .I errno is set to .BR ERANGE . -.\" An underflow floating-point exception -.\" .RB ( FE_UNDERFLOW ) -.\" is raised. -.\" FIXME . Is it intentional that these functions do not use FE_*? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806 No .B FE_UNDERFLOW exception is returned by +.\" This is intended behavior +.\" See http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806 .BR fetestexcept (3) for this case. .TP Range error: result overflow .\" e.g., yn(10, 1e-40) on glibc 2.8/x86-32 -.\" .I errno -.\" is set to -.\" .BR ERANGE . .I errno -is not set for this case. -.\" FIXME . Is it intentional that errno is not set? -.\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808 +is set to +.BR ERANGE +(but see BUGS). An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. @@ -256,18 +246,26 @@ conform to SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008. The others are nonstandard functions that also exist on the BSDs. .SH BUGS -On a pole error, these functions set +Before glibc 2.19, +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=6807 +these functions misdiagnosed pole errors: .I errno -to +was set to .BR EDOM , instead of .BR ERANGE -as POSIX.1-2004 requires. -.\" FIXME . -.\" Bug raised: http://sourceware.org/bugzilla/show_bug.cgi?id=6807 +and no +.B FE_DIVBYZERO +exception was raised. +.PP +Before glibc 2.17, +.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808 +did not set +.I errno +for "range error: result underflow". .PP In glibc version 2.3.2 and earlier, -.\" FIXME . Actually, 2.3.2 is the earliest test result I have; so yet +.\" Actually, 2.3.2 is the earliest test result I have; so yet .\" to confirm if this error occurs only in 2.3.2. these functions do not raise an invalid floating-point exception .RB ( FE_INVALID ) @@ -275,7 +273,7 @@ when a domain error occurs. .SH SEE ALSO .BR j0 (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cciss.4 b/man4/cciss.4 index 3b36104b3..17dff2924 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.06 of the Linux +This page is part of release 5.07 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 63ff85f96..231c13e8f 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -111,7 +111,7 @@ SO (0x0E, \fB^N\fP) activates the G1 character set; .HP SI (0x0F, \fB^O\fP) activates the G0 character set; .HP -CAN (0x18, \fB^X\fP) and SUB (0x1A, \fB^Z\fP) interrupt escape sequences; +CAN (0x18, \fB^X\fP) and SUB (0x1A, \fB^Z\fP) abort escape sequences; .HP ESC (0x1B, \fB^[\fP) starts an escape sequence; .HP @@ -676,7 +676,7 @@ It is ignored. .BR ioctl_console (2), .BR charsets (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cpuid.4 b/man4/cpuid.4 index d7a11d2a2..70f06a3f6 100644 --- a/man4/cpuid.4 +++ b/man4/cpuid.4 @@ -40,7 +40,7 @@ The lower 32 bits of the file position is used as the incoming .IR %eax , and the upper 32 bits of the file position as the incoming .IR %ecx , -the latter intended for "counting" +the latter is intended for "counting" .I eax levels like .IR eax=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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/dsp56k.4 b/man4/dsp56k.4 index 2d97211c4..b549f4eb0 100644 --- a/man4/dsp56k.4 +++ b/man4/dsp56k.4 @@ -29,7 +29,7 @@ dsp56k \- DSP56001 interface device .SH SYNOPSIS .nf -#include <asm/dsp56k.h> +.B #include <asm/dsp56k.h> .PP .BI "ssize_t read(int " fd ", void *" data ", size_t " length ); .BI "ssize_t write(int " fd ", void *" data ", size_t " length ); @@ -68,7 +68,7 @@ calls are used to control the resets the DSP56001 and uploads a program. The third .BR ioctl (2) -argument must be a pointer to a \fIstruct dsp56k_binary\fP with members +argument must be a pointer to a \fIstruct dsp56k_upload\fP with members \fIbin\fP pointing to a DSP56001 binary program, and \fIlen\fP set to the length of the program, counted in 24-bit words. .IP \fBDSP56K_SET_TX_WSIZE\fP @@ -76,8 +76,8 @@ sets the transmit word size. Allowed values are in the range 1 to 4, and is the number of bytes that will be sent at a time to the DSP56001. -These data quantities will either be padded with zero -bytes, or truncated to fit the native 24-bit data format of the +These data quantities will either be padded with bytes containing zero, +or truncated to fit the native 24-bit data format of the DSP56001. .IP \fBDSP56K_SET_RX_WSIZE\fP sets the receive word size. @@ -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.06 of the Linux +This page is part of release 5.07 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/full.4 b/man4/full.4 index da04afe49..42f04e083 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/fuse.4 b/man4/fuse.4 index 66a82c067..79031ce59 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.06 of the Linux +This page is part of release 5.07 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/hpsa.4 b/man4/hpsa.4 index a1d975985..396d61395 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/initrd.4 b/man4/initrd.4 index fcc850409..827659d77 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -197,7 +197,7 @@ configuration file The filename specified with this option will typically be a gzipped filesystem image. .TP -.I noinitrd +.B noinitrd This boot option disables the two-phase boot-up operation. The kernel performs the usual boot sequence as if .I /dev/initrd @@ -224,7 +224,7 @@ can be used as an option line in the .B LILO configuration file .IR /etc/lilo.config . -The device specified by the this option must be a mountable +The device specified by this option must be a mountable device having a suitable root filesystem. .\" .\" @@ -363,7 +363,7 @@ The executable .IR /linuxrc sets .IR /proc/sys/kernel/real-root-dev , -unmount +unmounts .IR /proc , the normal root filesystem and any other filesystems it has mounted, and then terminates. @@ -376,7 +376,7 @@ the boot loader can be installed. The boot loader is configured to load into .I /dev/initrd a filesystem with the set of modules that was used to bring up the system. -(e.g., Device +(e.g., device .I /dev/ram0 can be modified, then unmounted, and finally, the image is written from .I /dev/ram0 @@ -470,7 +470,7 @@ will remain in memory. .IP 3. Users of .I /dev/initrd -should not depend on the behavior give in the above notes. +should not depend on the behavior given in the above notes. The behavior may change in future versions of the Linux kernel. .\" .\" @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/intro.4 b/man4/intro.4 index 47bc5e9ca..3fe7ea8fa 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/lirc.4 b/man4/lirc.4 index d4eb8612e..8b39c7aac 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/loop.4 b/man4/loop.4 index e790582e9..fa0c19275 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -23,7 +23,7 @@ .\" USA. .\" %%%LICENSE_END .\" -.TH LOOP 4 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH LOOP 4 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME loop, loop-control \- loop devices .SH SYNOPSIS @@ -82,17 +82,18 @@ as: .in +4n .EX struct loop_info { - int lo_number; /* ioctl r/o */ - dev_t lo_device; /* ioctl r/o */ - unsigned long lo_inode; /* ioctl r/o */ - dev_t lo_rdevice; /* ioctl r/o */ + int lo_number; /* ioctl r/o */ + dev_t lo_device; /* ioctl r/o */ + unsigned long lo_inode; /* ioctl r/o */ + dev_t lo_rdevice; /* ioctl r/o */ int lo_offset; int lo_encrypt_type; int lo_encrypt_key_size; /* ioctl w/o */ - int lo_flags; /* ioctl r/o */ + int lo_flags; /* ioctl r/w (r/o before + Linux 2.6.25) */ char lo_name[LO_NAME_SIZE]; unsigned char lo_encrypt_key[LO_KEY_SIZE]; - /* ioctl w/o */ + /* ioctl w/o */ unsigned long lo_init[2]; char reserved[4]; }; @@ -189,15 +190,16 @@ which has some additional fields and a larger range for some other fields: .in +4n .EX struct loop_info64 { - uint64_t lo_device; /* ioctl r/o */ - uint64_t lo_inode; /* ioctl r/o */ - uint64_t lo_rdevice; /* ioctl r/o */ + uint64_t lo_device; /* ioctl r/o */ + uint64_t lo_inode; /* ioctl r/o */ + uint64_t lo_rdevice; /* ioctl r/o */ uint64_t lo_offset; - uint64_t lo_sizelimit;/* bytes, 0 == max available */ - uint32_t lo_number; /* ioctl r/o */ + uint64_t lo_sizelimit; /* bytes, 0 == max available */ + uint32_t lo_number; /* ioctl r/o */ uint32_t lo_encrypt_type; - uint32_t lo_encrypt_key_size; /* ioctl w/o */ - uint32_t lo_flags; /* ioctl r/o */ + uint32_t lo_encrypt_key_size; /* ioctl w/o */ + uint32_t lo_flags; i /* ioctl r/w (r/o before + Linux 2.6.25) */ uint8_t lo_file_name[LO_NAME_SIZE]; uint8_t lo_crypt_name[LO_NAME_SIZE]; uint8_t lo_encrypt_key[LO_KEY_SIZE]; /* ioctl w/o */ @@ -244,7 +246,7 @@ If the device is in use, the call fails with the error .TP .IR /dev/loop* The loop block special device files. -.SH EXAMPLE +.SH EXAMPLES The program below uses the .I /dev/loop-control device to find a free loop device, opens the loop device, @@ -316,7 +318,7 @@ main(int argc, char *argv[]) .BR losetup (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, @@ -33,8 +33,11 @@ lp \- line printer devices \fBlp\fP[0\(en2] are character devices for the parallel line printers; they have major number 6 and minor number 0\(en2. The minor numbers -correspond to the printer port base addresses 0x03bc, 0x0378 and 0x0278. -Usually they have mode 220 and are owned by root and group lp. +correspond to the printer port base addresses 0x03bc, 0x0378, and 0x0278. +Usually they have mode 220 and are owned by user +.I root +and group +.IR lp . You can use printer ports either with polling or with interrupts. Interrupts are recommended when high traffic is expected, for example, for laser printers. @@ -140,7 +143,7 @@ No argument is used. .BR lpcntl (8), .BR tunelp (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mem.4 b/man4/mem.4 index 470a1fe1c..115a12f9b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mouse.4 b/man4/mouse.4 index 834a5e65d..9aaa7d5fa 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/msr.4 b/man4/msr.4 index 45461f363..04409086d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/null.4 b/man4/null.4 index 5d5558650..dde33c38b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/pts.4 b/man4/pts.4 index 0d1f917dd..6408f99b4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ram.4 b/man4/ram.4 index 53b07ceba..7454b7b50 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/random.4 b/man4/random.4 index 0001132db..197408b54 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -136,11 +136,13 @@ these applications, must be used instead, because it will block until the entropy pool is initialized. .PP -If a seed file is saved across reboots as recommended below (all major -Linux distributions have done this since 2000 at least), the output is +If a seed file is saved across reboots as recommended below, +the output is cryptographically secure against attackers without local root access as soon as it is reloaded in the boot sequence, and perfectly adequate for network encryption session keys. +(All major Linux distributions have saved the seed file across reboots +since 2000 at least.) Since reads from .I /dev/random may block, users will usually want to open it in nonblocking mode @@ -342,7 +344,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/rtc.4 b/man4/rtc.4 index 339f5efa3..24c396d6c 100644 --- a/man4/rtc.4 +++ b/man4/rtc.4 @@ -77,7 +77,9 @@ maybe across the network or by entering that data manually. .SS RTC functionality RTCs can be read and written with .BR hwclock (8), -or directly with the ioctl requests listed below. +or directly with the +.BR ioctl (2) +requests listed below. .PP Besides tracking the date and time, many RTCs can also generate interrupts @@ -341,7 +343,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.06 of the Linux +This page is part of release 5.07 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index 58d187ecb..fc78a9d92 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/smartpqi.4 b/man4/smartpqi.4 index 652190095..4fa693c80 100644 --- a/man4/smartpqi.4 +++ b/man4/smartpqi.4 @@ -326,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, @@ -256,7 +256,7 @@ struct mtop { .EE .in .PP -Magnetic Tape operations for normal tape use: +Magnetic tape operations for normal tape use: .TP .B MTBSF Backward space over @@ -417,7 +417,7 @@ Write .I mt_count setmarks. .PP -Magnetic Tape operations for setting of device options (by the superuser): +Magnetic tape operations for setting of device options (by the superuser): .TP .B MTSETDRVBUFFER Set various drive and driver options according to bits encoded in @@ -425,7 +425,7 @@ Set various drive and driver options according to bits encoded in These consist of the drive's buffering mode, a set of Boolean driver options, the buffer write threshold, defaults for the block size and density, and timeouts (only in kernels 2.1 and later). -A single operation can affect only one item in the list above (the +A single operation can affect only one item in the list below (the Booleans counted as one item.) .IP A value having zeros in the high-order 4 bits will be used to set the @@ -551,7 +551,7 @@ is false, the driver will respond to an request by forward spacing over files. .TP .BR MT_ST_AUTO_LOCK " (Default: false)" -When this option is true, the drive door is locked when the device is +When this option is true, the drive door is locked when the device file is opened and unlocked when it is closed. .TP .BR MT_ST_DEF_WRITES " (Default: false)" @@ -614,7 +614,7 @@ There are some drives that support only the logical block addresses. .TP .BR MT_ST_SYSV " (Default: false)" -When this option is enabled, the tape devices use the SystemV +When this option is enabled, the tape devices use the System V semantics. Otherwise, the BSD semantics are used. The most important @@ -795,7 +795,7 @@ The only field defined in is the recovered error count in the low 16 bits (as defined by .BR MT_ST_SOFTERR_SHIFT and -.BR MT_ST_SOFTERR_MASK . +.BR MT_ST_SOFTERR_MASK ). Due to inconsistencies in the way drives report recovered errors, this count is often not maintained (most drives do not by default report soft errors but this can be changed with a SCSI MODE SELECT command). @@ -965,7 +965,7 @@ or the most recent information about the driver and its configuration possibilities .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/tty.4 b/man4/tty.4 index 53f9df6ac..84333817b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ttyS.4 b/man4/ttyS.4 index 5fb6d637f..dcb9a1fd4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/vcs.4 b/man4/vcs.4 index b7fdb5c1e..7b6debb9c 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -26,7 +26,7 @@ .\" 2007-12-17, Samuel Thibault <samuel.thibault@ens-lyon.org>: .\" document the VT_GETHIFONTMASK ioctl .\" " -.TH VCS 4 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH VCS 4 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME vcs, vcsa \- virtual console memory .SH DESCRIPTION @@ -100,7 +100,7 @@ requests are supported. .\" Andries Brouwer <aeb@cwi.nl> .SH VERSIONS Introduced with version 1.1.92 of the Linux kernel. -.SH EXAMPLE +.SH EXAMPLES You may do a screendump on vt3 by switching to vt1 and typing .PP .in +4n @@ -190,7 +190,7 @@ main(void) .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/veth.4 b/man4/veth.4 index c23bfdf68..269acd931 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 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME veth \- Virtual Ethernet Device .SH DESCRIPTION @@ -63,13 +63,23 @@ A particularly interesting use case is to place one end of a .B veth pair in one network namespace and the other end in another network namespace, thus allowing communication between network namespaces. -To do this, one first creates the +To do this, one can provide the +.B netns +parameter when creating the interfaces: +.PP +.in +4n +.EX +# ip link add <p1-name> netns <p1-ns> type veth peer <p2-name> netns <p2-ns> +.EE +.in +.PP +or, for an existing .B veth -device as above and then moves one side of the pair to the other namespace: +pair, move one side to the other namespace: .PP .in +4n .EX -# ip link set <p2-name> netns <p2-namespace> +# ip link set <p2-name> netns <p2-ns> .EE .in .PP @@ -96,7 +106,7 @@ NIC statistics: .BR ip-link (8), .BR ip-netns (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man4/wavelan.4 b/man4/wavelan.4 index 18f005012..80e389f63 100644 --- a/man4/wavelan.4 +++ b/man4/wavelan.4 @@ -21,7 +21,7 @@ wavelan \- AT&T GIS WaveLAN ISA device driver .I This driver is obsolete: it was removed from the kernel in version 2.6.35. .PP -.I wavelan +.B wavelan is the low-level device driver for the NCR / AT&T / Lucent .B WaveLAN ISA and Digital (DEC) @@ -37,7 +37,7 @@ This device name will be reported in the kernel log file with the MAC address, NWID and frequency used by the card. .SS Parameters -This section apply to the module form (parameters passed on the +This section applies to the module form (parameters passed on the .BR insmod (8) command line). If the driver is included in the kernel, use the @@ -45,18 +45,18 @@ If the driver is included in the kernel, use the syntax on the kernel command line. .TP .B io -Specify the list of base address where to search for wavelan cards +Specify the list of base addresses where to search for wavelan cards (setting by dip switch on the card). If you don't specify any io address, the driver will scan 0x390 and 0x3E0 addresses, which might conflict with other hardware... .TP .B irq -Set the list of irq that each wavelan card should use (the value is +Set the list of IRQs that each wavelan card should use (the value is saved in permanent storage for future use). .TP .B name -Set the list of name to be used for each wavelan cards device (name +Set the list of names to be used for each wavelan card device (name used by .BR ifconfig (8)). .SS Wireless extensions @@ -71,7 +71,7 @@ to or disable it .RI [ off ]. As the NWID is stored in the card Permanent Storage Area, it will be -reuse at any further invocation of the driver. +reused at any further invocation of the driver. .SS Frequency & channels For the 2.4\ GHz 2.00 Hardware, you are able to set the frequency by specifying one of the 10 defined channels @@ -79,7 +79,7 @@ specifying one of the 10 defined channels .I 2.422, 2.425, 2.4305, 2.432, 2.442, 2.452, 2.460, 2.462 or .IR 2.484 ) -or directly by its value. +or directly as a numeric value. The frequency is changed immediately and permanently. Frequency availability depends on the regulations... @@ -107,7 +107,7 @@ You may use .BR iwpriv (8) to manipulate private ioctls. .SS Quality and level threshold -Enable you the define the quality and level threshold used by the +Enables you to define the quality and level threshold used by the modem (packet below that level are discarded). .SS Histogram This functionality makes it possible to set a number of @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/acct.5 b/man5/acct.5 index 12f742b39..c85300665 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/charmap.5 b/man5/charmap.5 index 94dcb7a81..06a4736fe 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -16,7 +16,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH CHARMAP 5 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH CHARMAP 5 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME charmap \- character set description file .SH DESCRIPTION @@ -103,7 +103,7 @@ The width definition section ends with the string Usual default character map path. .SH CONFORMING TO POSIX.2. -.SH EXAMPLE +.SH EXAMPLES The Euro sign is defined as follows in the .I UTF\-8 charmap: @@ -118,7 +118,7 @@ charmap: .BR locale (5), .BR charsets (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/core.5 b/man5/core.5 index 04ad960dd..6f242501d 100644 --- a/man5/core.5 +++ b/man5/core.5 @@ -22,14 +22,14 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CORE 5 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH CORE 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME core \- core dump file .SH DESCRIPTION The default action of certain signals is to cause a process to terminate and produce a .IR "core dump file" , -a disk file containing an image of the process's memory at +a file containing an image of the process's memory at the time of termination. This image can be used in a debugger (e.g., .BR gdb (1)) @@ -58,7 +58,7 @@ is the ID of the process that dumped core, and is created in the current working directory. See below for details on naming.) Writing the core file fails if the directory in which -it is to be created is nonwritable, +it is to be created is not writable, or if a file with the same name exists and is not writable or is not a regular file @@ -90,6 +90,10 @@ in .IP * The binary being executed by the process does not have read permission enabled. +(This is a security measure to +ensure that an executable whose contents are not readable +does not produce a\(empossibly readable\(emcore dump containing +an image of the executable.) .IP * The process is executing a set-user-ID (set-group-ID) program that is owned by a user (group) other than the real user (group) @@ -157,61 +161,71 @@ by the following values when a core file is created: .PD 0 .TP 4 %% -a single % character +A single % character. .TP %c -core file size soft resource limit of crashing process (since Linux 2.6.24) +Core file size soft resource limit of crashing process (since Linux 2.6.24). .TP %d .\" Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1 -dump mode\(emsame as value returned by +Dump mode\(emsame as value returned by .BR prctl (2) .B PR_GET_DUMPABLE -(since Linux 3.7) +(since Linux 3.7). .TP %e -executable filename (without path prefix) +The process or thread's +.I comm +value, which typically is the same as the executable filename +(without path prefix, and truncated to a maximum of 15 characters), +but may have been modified to be something different; +see the discussion of +.I /proc/[pid]/comm +and +.I /proc/[pid]/task/[tid]/comm +in +.BR proc (5). .TP %E -pathname of executable, +Pathname of executable, with slashes (\(aq/\(aq) replaced by exclamation marks (\(aq!\(aq) (since Linux 3.0). .TP %g -(numeric) real GID of dumped process +Numeric real GID of dumped process. .TP %h -hostname (same as \fInodename\fP returned by \fBuname\fP(2)) +Hostname (same as \fInodename\fP returned by \fBuname\fP(2)). .TP %i TID of thread that triggered core dump, as seen in the PID namespace in which the thread resides .\" commit b03023ecbdb76c1dec86b41ed80b123c22783220 -(since Linux 3.18) +(since Linux 3.18). .TP %I TID of thread that triggered core dump, as seen in the initial PID namespace .\" commit b03023ecbdb76c1dec86b41ed80b123c22783220 -(since Linux 3.18) +(since Linux 3.18). .TP %p PID of dumped process, -as seen in the PID namespace in which the process resides +as seen in the PID namespace in which the process resides. .TP %P .\" Added in git commit 65aafb1e7484b7434a0c1d4c593191ebe5776a2f PID of dumped process, as seen in the initial PID namespace -(since Linux 3.12) +(since Linux 3.12). .TP %s -number of signal causing dump +Number of signal causing dump. .TP %t -time of dump, expressed as seconds since the -Epoch, 1970-01-01 00:00:00 +0000 (UTC) +Time of dump, expressed as seconds since the +Epoch, 1970-01-01 00:00:00 +0000 (UTC). .TP %u -(numeric) real UID of dumped process +Numeric real UID of dumped process. .PD .RE .PP @@ -287,7 +301,7 @@ 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 +Instead of being written to a file, the core dump is given as standard input to the program. Note the following points: .IP * 3 @@ -533,17 +547,30 @@ For more extensive details, see the .BR coredumpctl (1) manual page. .PP -To disable the +To (persistently) disable the .BR systemd (1) mechanism that archives core dumps, restoring to something more like traditional Linux behavior, one can set an override for the .BR systemd (1) mechanism, using something like: .PP -.in +2n +.in +4n +.EX +# \fBecho "kernel.core_pattern=core.%p" > \e\fP +\fB /etc/sysctl.d/50\-coredump.conf\fP +# \fB/lib/systemd/systemd\-sysctl\fP +.EE +.in +.PP +It is also possible to temporarily (i.e., until the next reboot) change the +.I core_pattern +setting using a command such as the following +(which causes the names of core dump files to include the executable name +as well as the number of the signal which triggered the core dump): +.PP +.in +4n .EX -# echo "kernel.core_pattern=core.%p" > /etc/sysctl.d/50\-coredump.conf -# /lib/systemd/systemd\-sysctl +# \fBsysctl \-w kernel.core_pattern="%e\-%s.core"\fP .EE .in .PP @@ -578,7 +605,7 @@ where each thread of a process has a different PID.) .\" LinuxThreads continue appending the PID (the kernel has no easy .\" way of telling which threading implementation the user-space .\" application is using). -- mtk, April 2006 -.SH EXAMPLE +.SH EXAMPLES The program below can be used to demonstrate the use of the pipe syntax in the .I /proc/sys/kernel/core_pattern @@ -677,7 +704,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR systemd\-coredump (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 44ae5e458..ccdaab0dd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/elf.5 b/man5/elf.5 index abdf54c3f..79e62f600 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/filesystems.5 b/man5/filesystems.5 index 6368de6dd..c16097fd8 100644 --- a/man5/filesystems.5 +++ b/man5/filesystems.5 @@ -23,12 +23,12 @@ .\" .\" 2007-12-14 mtk Added Reiserfs, XFS, JFS. .\" -.TH FILESYSTEMS 5 2018-04-30 "Linux" "Linux Programmer's Manual" +.TH FILESYSTEMS 5 2020-06-09 "Linux" "Linux Programmer's Manual" .nh .SH NAME filesystems \- Linux filesystem types: ext, ext2, ext3, ext4, hpfs, iso9660, JFS, minix, msdos, ncpfs nfs, ntfs, proc, Reiserfs, smb, sysv, umsdos, vfat, -XFS, xiafs, +XFS, xiafs .SH DESCRIPTION When, as is customary, the .B proc @@ -189,8 +189,8 @@ See .UE . .TP .B sysv -is an implementation of the SystemV/Coherent filesystem for Linux. -It implements all of Xenix FS, SystemV/386 FS, and Coherent FS. +is an implementation of the System V/Coherent filesystem for Linux. +It implements all of Xenix FS, System V/386 FS, and Coherent FS. .TP .B umsdos is an extended DOS filesystem used by Linux. @@ -232,12 +232,14 @@ It was removed from the kernel in 2.1.21. .BR ext4 (5), .BR nfs (5), .BR proc (5), +.BR sysfs (5), .BR tmpfs (5), +.BR xfs (5), .BR fsck (8), .BR mkfs (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ftpusers.5 b/man5/ftpusers.5 index 186e928d6..60331b79b 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.06 of the Linux +This page is part of release 5.07 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 6e4eb3c75..f13765da5 100644 --- a/man5/gai.conf.5 +++ b/man5/gai.conf.5 @@ -16,7 +16,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH GAI.CONF 5 2016-03-15 "Linux" "Linux Programmer's Manual" +.TH GAI.CONF 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME gai.conf \- getaddrinfo(3) configuration file .SH DESCRIPTION @@ -76,7 +76,7 @@ The .I gai.conf .\" Added in 2006 file is supported by glibc since version 2.5. -.SH EXAMPLE +.SH EXAMPLES The default table according to RFC\ 3484 would be specified with the following configuration file: .PP @@ -101,7 +101,7 @@ precedence ::ffff:0:0/96 10 .BR getaddrinfo (3), RFC\ 3484 .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/group.5 b/man5/group.5 index b76856c7c..493edf312 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.06 of the Linux +This page is part of release 5.07 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 e7cd3736c..0cfe018eb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/hosts.5 b/man5/hosts.5 index 2d0583cda..cbbb5c7e4 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -24,7 +24,7 @@ .\" Minor polishing, aeb .\" Modified, 2002-06-16, Mike Coleman .\" -.TH HOSTS 5 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH HOSTS 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME hosts \- static table lookup for hostnames .SH SYNOPSIS @@ -104,7 +104,7 @@ though looking around at the time of writing (circa 2000), there are historical hosts.txt files on the WWW. I just found three, from 92, 94, and 95. -.SH EXAMPLE +.SH EXAMPLES .EX # The following lines are desirable for IPv4 capable hosts 127.0.0.1 localhost @@ -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.06 of the Linux +This page is part of release 5.07 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 1cf48d7c1..f18d7e4a2 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -3,7 +3,7 @@ .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) .\" This file may be distributed under the GNU General Public License. .\" %%%LICENSE_END -.TH HOSTS.EQUIV 5 2015-07-23 "Linux" "Linux Programmer's Manual" +.TH HOSTS.EQUIV 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME hosts.equiv \- list of hosts and users that are granted "trusted" .B r @@ -81,7 +81,7 @@ character which means "any host" only when the word is added to the auth component line in your PAM file for the particular service .RB "(e.g., " rlogin ). -.SH EXAMPLE +.SH EXAMPLES Below are some example .I /etc/host.equiv or @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/intro.5 b/man5/intro.5 index 583d6b2d0..32a097fd5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/issue.5 b/man5/issue.5 index c6b2164f8..52e4e7703 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/locale.5 b/man5/locale.5 index 8f890b143..9a8043304 100644 --- a/man5/locale.5 +++ b/man5/locale.5 @@ -22,7 +22,7 @@ .\" 2008-06-17 Petr Baudis <pasky@suse.cz> .\" LC_TIME: Describe first_weekday and first_workday .\" -.TH LOCALE 5 2019-03-06 "Linux" "Linux User Manual" +.TH LOCALE 5 2020-06-09 "Linux" "Linux User Manual" .SH NAME locale \- describes a locale definition file .SH DESCRIPTION @@ -1215,9 +1215,9 @@ shall be used for Monday. See NOTES. .TP .IR first_weekday " (since glibc 2.2)" -followed by the number of the first day from the +followed by the number of the day from the .I day -list to be shown in calendar applications. +list to be shown as the first day of the week in calendar applications. The default value of .B 1 corresponds to either Sunday or Monday depending @@ -1332,7 +1332,7 @@ Monday for the locale. .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/motd.5 b/man5/motd.5 index 84bf34ccb..1027c0b6a 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/networks.5 b/man5/networks.5 index bf6baa561..b2d340d56 100644 --- a/man5/networks.5 +++ b/man5/networks.5 @@ -66,7 +66,7 @@ and .BR netstat (8) utilities. Only Class A, B or C networks are supported, partitioned networks -(i.e., network/26 or network/28) are not supported by this facility. +(i.e., network/26 or network/28) are not supported by this file. .SH FILES .TP .I /etc/networks @@ -78,7 +78,7 @@ The networks definition file. .BR netstat (8), .BR route (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nologin.5 b/man5/nologin.5 index eef0e83b2..690ff9dab 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.06 of the Linux +This page is part of release 5.07 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 28a2dc7e9..3210335e4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nss.5 b/man5/nss.5 index 2f94159a7..e821536a7 100644 --- a/man5/nss.5 +++ b/man5/nss.5 @@ -16,7 +16,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH NSS 5 2013-02-13 "Linux" "Linux Programmer's Manual" +.TH NSS 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME nss \- Name Service Switch configuration file .SH DESCRIPTION @@ -97,7 +97,7 @@ call might result in a network communication with the server to get the next entry. .SH FILES \fI/etc/default/nss\fR -.SH EXAMPLE +.SH EXAMPLES The default configuration corresponds to the following configuration file: .PP .in +4n @@ -113,7 +113,7 @@ SETENT_BATCH_READ=FALSE .SH SEE ALSO \fInsswitch.conf\fR .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 aa3a45db4..1f324d45d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/passwd.5 b/man5/passwd.5 index fa3a475bf..4028d3097 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/proc.5 b/man5/proc.5 index 6941965bc..992ae9930 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -278,6 +278,12 @@ The attribute was reset to the value in the file Resetting the "dumpable" attribute to 1 reverts the ownership of the .IR /proc/[pid]/* files to the process's effective UID and GID. +Note, however, that if the effective UID or GID is subsequently modified, +then the "dumpable" attribute may be reset, as described in +.BR prctl (2). +Therefore, it may be desirable to reset the "dumpable" attribute +.I after +making any desired changes to the process's effective UID or GID. .TP .I /proc/[pid]/attr .\" https://lwn.net/Articles/28222/ @@ -319,7 +325,7 @@ trusted to maintain any desired separation between the old and new security contexts. .IP Prior to Linux 2.6.28, SELinux did not allow threads within a -multi-threaded process to set their security context via this node +multithreaded process to set their security context via this node as it would yield an inconsistency among the security contexts of the threads sharing the same memory space. Since Linux 2.6.28, SELinux lifted @@ -526,8 +532,8 @@ Furthermore, a process may change the memory location that this file refers via .BR prctl (2) operations such as .BR PR_SET_MM_ARG_START . -+.IP -+Think of this file as the command line that the process wants you to see. +.IP +Think of this file as the command line that the process wants you to see. .TP .IR /proc/[pid]/comm " (since Linux 2.6.33)" .\" commit 4614a696bd1c3a9af3a08f0e5874830a85b889d4 @@ -549,7 +555,7 @@ by writing to the file .IR /proc/self/task/[tid]/comm . Strings longer than .B TASK_COMM_LEN -(16) characters are silently truncated. +(16) characters (including the terminating null byte) are silently truncated. .IP This file provides a superset of the .BR prctl (2) @@ -559,6 +565,12 @@ and operations, and is employed by .BR pthread_setname_np (3) when used to rename threads other than the caller. +The value in this file is used for the +.I %e +specifier in +.IR /proc/sys/kernel/core_pattern ; +see +.BR proc (5). .TP .IR /proc/[pid]/coredump_filter " (since Linux 2.6.23)" See @@ -1172,9 +1184,9 @@ the storage layer. .TP .IR cancelled_write_bytes : The big inaccuracy here is truncate. -If a process writes 1MB to a file and then deletes the file, +If a process writes 1 MB to a file and then deletes the file, it will in fact perform no writeout. -But it will have been accounted as having caused 1MB of write. +But it will have been accounted as having caused 1 MB of write. In other words: this field represents the number of bytes which this process caused to not happen, by truncating pagecache. A task can cause "negative" I/O too. @@ -1248,16 +1260,19 @@ lrw\-\-\-\-\-\-\-. 1 root root 64 Apr 16 21:33 .EE .in .IP -This directory appears only if the +Permission to access this file is governed by a ptrace access mode +.B PTRACE_MODE_READ_FSCREDS +check; see +.BR ptrace (2). +.IP +Until kernel version 4.3, +.\" commit bdb4d100afe9818aebd1d98ced575c5ef143456c +this directory appeared only if the .B CONFIG_CHECKPOINT_RESTORE -kernel configuration option is enabled. -Privilege +kernel configuration option was enabled. +Additionally, in those kernel versions, privilege .RB ( CAP_SYS_ADMIN ) -.\" FIXME -.\" This may change. See the mail thread -.\" "[RFC][PATCH v2] procfs: Always expose /proc/<pid>/map_files/ and make it readable" -.\" from Jan 2015 -is required to view the contents of this directory. +was required to view the contents of this directory. .TP .I /proc/[pid]/maps A file containing the currently mapped memory regions and their access @@ -1546,8 +1561,8 @@ Lines in this file have the form: .IP .in +4n .EX -device /dev/sda7 mounted on /home with fstype ext3 [statistics] -( 1 ) ( 2 ) (3 ) (4) +device /dev/sda7 mounted on /home with fstype ext3 [stats] +( 1 ) ( 2 ) (3 ) ( 4 ) .EE .in .IP @@ -1968,7 +1983,7 @@ The "KernelPageSize" line (available since Linux 2.6.29) is the page size used by the kernel to back the virtual memory area. This matches the size used by the MMU in the majority of cases. However, one counter-example occurs on PPC64 kernels -whereby a kernel using 64kB as a base page size may still use 4kB +whereby a kernel using 64 kB as a base page size may still use 4 kB pages for the MMU on older processors. To distinguish the two attributes, the "MMUPageSize" line (also available since Linux 2.6.29) @@ -2009,17 +2024,21 @@ encoded using the following two-letter codes: ac - area is accountable nr - swap space is not reserved for the area ht - area uses huge tlb pages - nl - non-linear mapping + sf - perform synchronous page faults (since Linux 4.15) + nl - non-linear mapping (removed in Linux 4.0) ar - architecture specific flag + wf - wipe on fork (since Linux 4.14) dd - do not include area into core dump - sd - soft-dirty flag + sd - soft-dirty flag (since Linux 3.13) mm - mixed map area hg - huge page advise flag nh - no-huge page advise flag mg - mergeable advise flag + um - userfaultfd missing pages tracking (since Linux 4.3) + uw - userfaultfd wprotect pages tracking (since Linux 4.3) .IP "ProtectionKey" field contains the memory protection key (see -.BR pkeys (5)) +.BR pkeys (7)) associated with the virtual memory area. Present only if the kernel was built with the .B CONFIG_X86_INTEL_MEMORY_PROTECTION_KEYS @@ -2498,7 +2517,7 @@ One of "S (sleeping)", "D (disk sleep)", "T (stopped)", -"T (tracing stop)", +"t (tracing stop)", "Z (zombie)", or "X (dead)". @@ -2979,7 +2998,7 @@ is defined at kernel compilation time. This file contains information which is used for diagnosing memory fragmentation issues. Each line starts with the identification of the node and the name -of the zone which together identify a memory region +of the zone which together identify a memory region. This is then followed by the count of available chunks of a certain order in which these zones are split. @@ -3170,8 +3189,8 @@ identify in hexadecimal media media type model manufacturer's model number settings drive settings -smart_thresholds in hexadecimal -smart_values in hexadecimal +smart_thresholds IDE disk management thresholds (in hex) +smart_values IDE disk management values (in hex) .EE .in .IP @@ -3482,7 +3501,7 @@ applications, without swapping. .TP .IR Buffers " %lu" Relatively temporary storage for raw disk blocks that -shouldn't get tremendously large (20MB or so). +shouldn't get tremendously large (20 MB or so). .TP .IR Cached " %lu" In-memory cache for files read from the disk (the page cache). @@ -3530,7 +3549,7 @@ It is more eligible to be reclaimed for other purposes. .IR HighTotal " %lu" (Starting with Linux 2.6.19, \fBCONFIG_HIGHMEM\fP is required.) Total amount of highmem. -Highmem is all memory above ~860MB of physical memory. +Highmem is all memory above ~860 MB of physical memory. Highmem areas are for use by user-space programs, or for the page cache. The kernel must use tricks to access @@ -3643,13 +3662,13 @@ The amount of memory presently allocated on the system. The committed memory is a sum of all of the memory which has been allocated by processes, even if it has not been "used" by them as of yet. -A process which allocates 1GB of memory (using +A process which allocates 1 GB of memory (using .BR malloc (3) -or similar), but touches only 300MB of that memory will show up -as using only 300MB of memory even if it has the address space -allocated for the entire 1GB. +or similar), but touches only 300 MB of that memory will show up +as using only 300 MB of memory even if it has the address space +allocated for the entire 1 GB. .IP -This 1GB is memory which has been "committed" to by the VM +This 1 GB is memory which has been "committed" to by the VM and can be used at any time by the allocating application. With strict overcommit enabled on the system (mode 2 in .IR /proc/sys/vm/overcommit_memory ), @@ -3695,7 +3714,7 @@ Non-file backed huge pages mapped into user-space page tables. (\fBCONFIG_TRANSPARENT_HUGEPAGE\fP is required.) Memory used by shared memory (shmem) and .BR tmpfs (5) -allocated with huge pages +allocated with huge pages. .TP .IR ShmemPmdMapped " %lu (since Linux 4.8)" (\fBCONFIG_TRANSPARENT_HUGEPAGE\fP is required.) @@ -3739,11 +3758,11 @@ The maximum number of surplus huge pages is controlled by The size of huge pages. .TP .IR DirectMap4k " %lu (since Linux 2.6.27)" -Number of bytes of RAM linearly mapped by kernel in 4kB pages. +Number of bytes of RAM linearly mapped by kernel in 4 kB pages. (x86.) .TP .IR DirectMap4M " %lu (since Linux 2.6.27)" -Number of bytes of RAM linearly mapped by kernel in 4MB pages. +Number of bytes of RAM linearly mapped by kernel in 4 MB pages. (x86 with .BR CONFIG_X86_64 or @@ -3751,7 +3770,7 @@ or enabled.) .TP .IR DirectMap2M " %lu (since Linux 2.6.27)" -Number of bytes of RAM linearly mapped by kernel in 2MB pages. +Number of bytes of RAM linearly mapped by kernel in 2 MB pages. (x86 with neither .BR CONFIG_X86_64 nor @@ -4243,7 +4262,7 @@ in certain conditions. .\" Precisely: Linux 2.6.0-test4 (6) Time servicing interrupts. .TP -.IR softirq " (since Linux 2.6.0" +.IR softirq " (since Linux 2.6.0)" .\" Precisely: Linux 2.6.0-test4 (7) Time servicing softirqs. .TP @@ -4352,6 +4371,24 @@ some systems, it may be empty. This directory contains the files and subdirectories for kernel variables related to filesystems. .TP +.IR /proc/sys/fs/aio-max-nr " and " /proc/sys/fs/aio-nr " (since Linux 2.6.4)" +.I aio-nr +is the running total of the number of events specified by +.BR io_setup (2) +calls for all currently active AIO contexts. +If +.I aio-nr +reaches +.IR aio-max-nr , +then +.BR io_setup (2) +will fail with the error +.BR EAGAIN . +Raising +.I aio-max-nr +does not result in the preallocation or resizing +of any kernel data structures. +.TP .I /proc/sys/fs/binfmt_misc Documentation for files in this directory can be found in the Linux kernel source in the file @@ -4544,7 +4581,7 @@ for details. .TP .IR /proc/sys/fs/nr_open " (since Linux 2.6.25) .\" commit 9cfe015aa424b3c003baba3841a60dd9b5ad319b -This file imposes ceiling on the value to which the +This file imposes a ceiling on the value to which the .BR RLIMIT_NOFILE resource limit can be raised (see .BR getrlimit (2)). @@ -4576,6 +4613,28 @@ See See .BR pipe (7). .TP +.IR /proc/sys/fs/protected_fifos " (since Linux 4.19)" +The value in this file is/can be set to one of the following: +.RS +.TP 4 +0 +Writing to FIFOs is unrestricted. +.TP +1 +Don't allow +.B O_CREAT +.BR open (2) +on FIFOs that the caller doesn't own in world-writable sticky directories, +unless the FIFO is owned by the owner of the directory. +.TP +2 +As for the value 1, +but the restriction also applies to group-writable sticky directories. +.RE +.IP +The intent of the above protections is to avoid unintentional writes to an +attacker-controlled FIFO when a program expected to create a regular file. +.TP .IR /proc/sys/fs/protected_hardlinks " (since Linux 3.6)" .\" commit 800179c9b8a1e796e441674776d11cd4c05d61d7 When the value in this file is 0, @@ -4627,6 +4686,32 @@ this stops unauthorized users from "pinning" vulnerable set-user-ID and set-group-ID files against being upgraded by the administrator, or linking to special files. .TP +.IR /proc/sys/fs/protected_regular " (since Linux 4.19)" +The value in this file is/can be set to one of the following: +.RS +.TP 4 +0 +Writing to regular files is unrestricted. +.TP +1 +Don't allow +.B O_CREAT +.BR open (2) +on regular files that the caller doesn't own in +world-writable sticky directories, +unless the regular file is owned by the owner of the directory. +.TP +2 +As for the value 1, +but the restriction also applies to group-writable sticky directories. +.RE +.IP +The intent of the above protections is similar to +.IR protected_fifos , +but allows an application to +avoid writes to an attacker-controlled regular file, +where the application expected to create one. +.TP .IR /proc/sys/fs/protected_symlinks " (since Linux 3.6)" .\" commit 800179c9b8a1e796e441674776d11cd4c05d61d7 When the value in this file is 0, @@ -5236,7 +5321,7 @@ This file can be used to query and set the run-time limit on the maximum (System V IPC) shared memory segment size that can be created. -Shared memory segments up to 1GB are now supported in the +Shared memory segments up to 1 GB are now supported in the kernel. This value defaults to .BR SHMMAX . @@ -5553,7 +5638,7 @@ Present only if the kernel was configured with .TP .IR /proc/sys/vm/memory_failure_recovery " (since Linux 2.6.32)" .\" The following is based on the text in Documentation/sysctl/vm.txt -Enable memory failure recovery (when supported by the platform) +Enable memory failure recovery (when supported by the platform). .RS .IP 1: 4 Attempt recovery. @@ -5696,12 +5781,12 @@ and is the amount of swap space. .RE .IP -For example, on a system with 16GB of physical RAM, 16GB +For example, on a system with 16 GB of physical RAM, 16 GB of swap, no space dedicated to huge pages, and an .I overcommit_ratio of 50, this formula yields a .I CommitLimit -of 24GB. +of 24 GB. .IP Since Linux 3.14, if the value in .I /proc/sys/vm/overcommit_kbytes @@ -5765,7 +5850,7 @@ The default value is 60. .TP .IR /proc/sys/vm/user_reserve_kbytes " (since Linux 3.10)" .\" commit c9b1d0981fcce3d9976d7b7a56e4e0503bc610dd -Specifies an amount of memory (in KiB) to reserve for user processes, +Specifies an amount of memory (in KiB) to reserve for user processes. This is intended to prevent a user from starting a single memory hogging process, such that they cannot recover (kill the hog). The value in this file has an effect only when @@ -6670,7 +6755,7 @@ See the kernel source file .RE .TP .IR /proc/zoneinfo " (since Linux 2.6.13)" -This file display information about memory zones. +This file displays information about memory zones. This is useful for analyzing virtual memory behavior. .\" FIXME more should be said about /proc/zoneinfo .SH NOTES @@ -6730,7 +6815,7 @@ The Linux kernel source files: and .IR Documentation/sysctl/vm.txt . .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/protocols.5 b/man5/protocols.5 index eed09f606..23fc32830 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/repertoiremap.5 b/man5/repertoiremap.5 index 5b6f7eaf2..47242cdb9 100644 --- a/man5/repertoiremap.5 +++ b/man5/repertoiremap.5 @@ -20,7 +20,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH REPERTOIREMAP 5 2019-03-06 "GNU" "Linux User Manual" +.TH REPERTOIREMAP 5 2020-06-09 "GNU" "Linux User Manual" .SH NAME repertoiremap \- map symbolic character names to Unicode code points .SH DESCRIPTION @@ -65,7 +65,7 @@ Usual default repertoire map path. POSIX.2. .SH NOTES Repertoire maps are deprecated in favor of Unicode code points. -.SH EXAMPLE +.SH EXAMPLES A mnemonic for the Euro sign can be defined as follows: .PP .nf @@ -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.06 of the Linux +This page is part of release 5.07 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 10286d487..a3df37ff4 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -350,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/rpc.5 b/man5/rpc.5 index 910dc0058..96ebe10b3 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/securetty.5 b/man5/securetty.5 index 964184461..aa77870ff 100644 --- a/man5/securetty.5 +++ b/man5/securetty.5 @@ -23,9 +23,9 @@ .\" %%%LICENSE_END .\" .\" Modified Sun Jul 25 11:06:27 1993 by Rik Faith (faith@cs.unc.edu) -.TH SECURETTY 5 2015-03-29 "Linux" "Linux Programmer's Manual" +.TH SECURETTY 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME -securetty \- file which lists terminals from which root can log in +securetty \- list of terminals on which root is allowed to login .SH DESCRIPTION The file .I /etc/securetty @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/services.5 b/man5/services.5 index 829f60947..f5fdca0fb 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/shells.5 b/man5/shells.5 index 00a7bdf6f..8b5b25cce 100644 --- a/man5/shells.5 +++ b/man5/shells.5 @@ -25,7 +25,7 @@ .\" Modified Sat Jul 24 17:11:07 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Nov 21 10:49:38 1993 by Michael Haardt .\" Modified Sun Feb 26 15:09:15 1995 by Rik Faith (faith@cs.unc.edu) -.TH SHELLS 5 2017-11-26 "" "Linux Programmer's Manual" +.TH SHELLS 5 2020-06-09 "" "Linux Programmer's Manual" .SH NAME shells \- pathnames of valid login shells .SH DESCRIPTION @@ -42,7 +42,7 @@ FTP daemons traditionally disallow access to users with shells not included in this file. .SH FILES .I /etc/shells -.SH EXAMPLE +.SH EXAMPLES .I /etc/shells may contain the following paths: .PP @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/slabinfo.5 b/man5/slabinfo.5 index 866c39aae..ac09b0a71 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/sysfs.5 b/man5/sysfs.5 index 9f3c9bd16..01413d255 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/termcap.5 b/man5/termcap.5 index 798a3bc64..f43397f34 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -34,7 +34,7 @@ termcap \- terminal capability database .SH DESCRIPTION The termcap database is an obsolete facility for describing the capabilities of character-cell terminals and printers. -It is retained only for capability with old programs; +It is retained only for compatibility with old programs; new programs should use the .BR terminfo (5) database and associated libraries. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tmpfs.5 b/man5/tmpfs.5 index 4e707567c..563a1522e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ttytype.5 b/man5/ttytype.5 index f0a56fdc7..cb8c2de23 100644 --- a/man5/ttytype.5 +++ b/man5/ttytype.5 @@ -26,7 +26,7 @@ .\" Modified Thu Oct 19 21:25:21 MET 1995 by Martin Schulze <joey@infodrom.north.de> .\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond .\" <esr@thyrsus.com>xk -.TH TTYTYPE 5 2012-12-31 "Linux" "Linux Programmer's Manual" +.TH TTYTYPE 5 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ttytype \- terminal device to default terminal type mapping .SH DESCRIPTION @@ -54,7 +54,7 @@ It is little used on modern workstation and personal UNIX systems. .TP .I /etc/ttytype the tty definitions file. -.SH EXAMPLE +.SH EXAMPLES A typical .I /etc/ttytype is: @@ -71,7 +71,7 @@ vt320 ttys0 .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tzfile.5 b/man5/tzfile.5 index 2fefab59b..1611cea16 100644 --- a/man5/tzfile.5 +++ b/man5/tzfile.5 @@ -3,7 +3,7 @@ .\" 1996-06-05 by Arthur David Olson <arthur_david_olson@nih.gov>. .\" %%%LICENSE_END .\" -.TH TZFILE 5 2019-03-06 "" "Linux Programmer's Manual" +.TH TZFILE 5 2020-04-27 "" "Linux Programmer's Manual" .SH NAME tzfile \- timezone information .SH DESCRIPTION @@ -14,11 +14,21 @@ tzfile \- timezone information .de q \\$3\*(lq\\$1\*(rq\\$2 .. +.ie \n(.g .ds - \f(CW-\fP +.el ds - \- The timezone information files used by .BR tzset (3) are typically found under a directory with a name like .IR /usr/share/zoneinfo . -These files begin with a 44-byte header containing the following fields: +These files use the format described in Internet RFC 8536. +Each file is a sequence of 8-bit bytes. +In a file, a binary integer is represented by a sequence of one or +more bytes in network order (bigendian, or high-order byte first), +with all bits significant, +a signed binary integer is represented using two's complement, +and a boolean is represented by a one-byte binary integer that is +either 0 (false) or 1 (true). +The format begins with a 44-byte header containing the following fields: .IP * 2 The magic four-byte ASCII sequence .q "TZif" @@ -32,15 +42,12 @@ or .IP * Fifteen bytes containing zeros reserved for future use. .IP * -Six four-byte integer values -written in a standard byte order -(the high-order byte of the value is written first). -These values are, -in order: +Six four-byte integer values, in the following order: .RS .TP -.I tzh_ttisgmtcnt +.I tzh_ttisutcnt The number of UT/local indicators stored in the file. +(UT is Universal Time.) .TP .I tzh_ttisstdcnt The number of standard/wall indicators stored in the file. @@ -66,7 +73,7 @@ depend on the contents of the header: .IP * 2 .I tzh_timecnt four-byte signed integer values sorted in ascending order. -These values are written in standard byte order. +These values are written in network byte order. Each is used as a transition time (as returned by .BR time (2)) at which the rules for computing local time change. @@ -89,21 +96,21 @@ entries, each defined as follows: .nf .ta .5i +\w'unsigned char\0\0'u struct ttinfo { - int32_t tt_gmtoff; + int32_t tt_utoff; unsigned char tt_isdst; - unsigned char tt_abbrind; + unsigned char tt_desigidx; }; .in -.5i .fi .sp Each structure is written as a four-byte signed integer value for -.IR tt_gmtoff , -in a standard byte order, followed by a one-byte value for +.IR tt_utoff , +in network byte order, followed by a one-byte boolean for .I tt_isdst and a one-byte value for -.IR tt_abbrind . +.IR tt_desigidx . In each structure, -.I tt_gmtoff +.I tt_utoff gives the number of seconds to be added to UT, .I tt_isdst tells whether @@ -111,19 +118,28 @@ tells whether should be set by .BR localtime (3) and -.I tt_abbrind +.I tt_desigidx serves as an index into the array of time zone abbreviation bytes that follow the .I ttinfo structure(s) in the file. +The +.I tt_utoff +value is never equal to \-2**31, to let 32-bit clients negate it without +overflow. +Also, in realistic applications +.I tt_utoff +is in the range [\-89999, 93599] (i.e., more than \-25 hours and less +than 26 hours); this allows easy support by implementations that +already support the POSIX-required range [\-24:59:59, 25:59:59]. .IP * .I tzh_leapcnt -pairs of four-byte values, written in standard byte order; +pairs of four-byte values, written in network byte order; the first value of each pair gives the nonnegative time (as returned by .BR time (2)) at which a leap second occurs; -the second gives the +the second is a signed integer specifying the .I total number of leap seconds to be applied during the time period starting at the given time. @@ -132,28 +148,38 @@ Each transition is for one leap second, either positive or negative; transitions always separated by at least 28 days minus 1 second. .IP * .I tzh_ttisstdcnt -standard/wall indicators, each stored as a one-byte value; +standard/wall indicators, each stored as a one-byte boolean; they tell whether the transition times associated with local time types -were specified as standard time or wall clock time, -and are used when a timezone file is used in handling POSIX-style -timezone environment variables. +were specified as standard time or local (wall clock) time. .IP * -.I tzh_ttisgmtcnt -UT/local indicators, each stored as a one-byte value; +.I tzh_ttisutcnt +UT/local indicators, each stored as a one-byte boolean; they tell whether the transition times associated with local time types -were specified as UT or local time, -and are used when a timezone file is used in handling POSIX-style -timezone environment variables. +were specified as UT or local time. +If a UT/local indicator is set, the corresponding standard/wall indicator +must also be set. +.PP +The standard/wall and UT/local indicators were designed for +transforming a TZif file's transition times into transitions appropriate +for another time zone specified via a POSIX-style TZ string that lacks rules. +For example, when TZ="EET\*-2EEST" and there is no TZif file "EET\*-2EEST", +the idea was to adapt the transition times from a TZif file with the +well-known name "posixrules" that is present only for this purpose and +is a copy of the file "Europe/Brussels", a file with a different UT offset. +POSIX does not specify this obsolete transformational behavior, +the default rules are installation-dependent, and no implementation +is known to support this feature for timestamps past 2037, +so users desiring (say) Greek time should instead specify +TZ="Europe/Athens" for better historical coverage, falling back on +TZ="EET\*-2EEST,M3.5.0/3,M10.5.0/4" if POSIX conformance is required +and older timestamps need not be handled accurately. .PP The .BR localtime (3) function -uses the first standard-time +normally uses the first .I ttinfo structure in the file -(or simply the first -.I ttinfo -structure in the absence of a standard-time structure) if either .I tzh_timecnt is zero or the time argument is less than the first transition time recorded @@ -191,19 +217,216 @@ from 0 through 24. Second, DST is in effect all year if it starts January 1 at 00:00 and ends December 31 at 24:00 plus the difference between daylight saving and standard time. -.PP +.SS Interoperability considerations Future changes to the format may append more data. +.PP +Version 1 files are considered a legacy format and +should be avoided, as they do not support transition +times after the year 2038. +Readers that only understand Version 1 must ignore +any data that extends beyond the calculated end of the version +1 data block. +.PP +Writers should generate a version 3 file if +TZ string extensions are necessary to accurately +model transition times. +Otherwise, version 2 files should be generated. +.PP +The sequence of time changes defined by the version 1 +header and data block should be a contiguous subsequence +of the time changes defined by the version 2+ header and data +block, and by the footer. +This guideline helps obsolescent version 1 readers +agree with current readers about timestamps within the +contiguous subsequence. It also lets writers not +supporting obsolescent readers use a +.I tzh_timecnt +of zero +in the version 1 data block to save space. +.PP +Time zone designations should consist of at least three (3) +and no more than six (6) ASCII characters from the set of +alphanumerics, +.q "\*-", +and +.q "+". +This is for compatibility with POSIX requirements for +time zone abbreviations. +.PP +When reading a version 2 or 3 file, readers +should ignore the version 1 header and data block except for +the purpose of skipping over them. +.PP +Readers should calculate the total lengths of the +headers and data blocks and check that they all fit within +the actual file size, as part of a validity check for the file. +.SS Common interoperability issues +This section documents common problems in reading or writing TZif files. +Most of these are problems in generating TZif files for use by +older readers. +The goals of this section are: +.IP * 2 +to help TZif writers output files that avoid common +pitfalls in older or buggy TZif readers, +.IP * +to help TZif readers avoid common pitfalls when reading +files generated by future TZif writers, and +.IP * +to help any future specification authors see what sort of +problems arise when the TZif format is changed. +.PP +When new versions of the TZif format have been defined, a +design goal has been that a reader can successfully use a TZif +file even if the file is of a later TZif version than what the +reader was designed for. +When complete compatibility was not achieved, an attempt was +made to limit glitches to rarely-used timestamps, and to allow +simple partial workarounds in writers designed to generate +new-version data useful even for older-version readers. +This section attempts to document these compatibility issues and +workarounds, as well as to document other common bugs in +readers. +.PP +Interoperability problems with TZif include the following: +.IP * 2 +Some readers examine only version 1 data. +As a partial workaround, a writer can output as much version 1 +data as possible. +However, a reader should ignore version 1 data, and should use +version 2+ data even if the reader's native timestamps have only +32 bits. +.IP * +Some readers designed for version 2 might mishandle +timestamps after a version 3 file's last transition, because +they cannot parse extensions to POSIX in the TZ-like string. +As a partial workaround, a writer can output more transitions +than necessary, so that only far-future timestamps are +mishandled by version 2 readers. +.IP * +Some readers designed for version 2 do not support +permanent daylight saving time, e.g., a TZ string +.q "EST5EDT,0/0,J365/25" +denoting permanent Eastern Daylight Time (\-04). +As a partial workaround, a writer can substitute standard time +for the next time zone east, e.g., +.q "AST4" +for permanent Atlantic Standard Time (\-04). +.IP * +Some readers ignore the footer, and instead predict future +timestamps from the time type of the last transition. +As a partial workaround, a writer can output more transitions +than necessary. +.IP * +Some readers do not use time type 0 for timestamps before +the first transition, in that they infer a time type using a +heuristic that does not always select time type 0. +As a partial workaround, a writer can output a dummy (no-op) +first transition at an early time. +.IP * +Some readers mishandle timestamps before the first +transition that has a timestamp not less than \-2**31. +Readers that support only 32-bit timestamps are likely to be +more prone to this problem, for example, when they process +64-bit transitions only some of which are representable in 32 +bits. +As a partial workaround, a writer can output a dummy +transition at timestamp \-2**31. +.IP * +Some readers mishandle a transition if its timestamp has +the minimum possible signed 64-bit value. +Timestamps less than \-2**59 are not recommended. +.IP * +Some readers mishandle POSIX-style TZ strings that +contain +.q "<" +or +.q ">". +As a partial workaround, a writer can avoid using +.q "<" +or +.q ">" +for time zone abbreviations containing only alphabetic +characters. +.IP * +Many readers mishandle time zone abbreviations that contain +non-ASCII characters. +These characters are not recommended. +.IP * +Some readers may mishandle time zone abbreviations that +contain fewer than 3 or more than 6 characters, or that +contain ASCII characters other than alphanumerics, +.q "\*-", +and +.q "+". +These abbreviations are not recommended. +.IP * +Some readers mishandle TZif files that specify +daylight-saving time UT offsets that are less than the UT +offsets for the corresponding standard time. +These readers do not support locations like Ireland, which +uses the equivalent of the POSIX TZ string +.q "IST\*-1GMT0,M10.5.0,M3.5.0/1", +observing standard time +(IST, +01) in summer and daylight saving time (GMT, +00) in winter. +As a partial workaround, a writer can output data for the +equivalent of the POSIX TZ string +.q "GMT0IST,M3.5.0/1,M10.5.0", +thus swapping standard and daylight saving time. +Although this workaround misidentifies which part of the year +uses daylight saving time, it records UT offsets and time zone +abbreviations correctly. +.PP +Some interoperability problems are reader bugs that +are listed here mostly as warnings to developers of readers. +.IP * 2 +Some readers do not support negative timestamps. +Developers of distributed applications should keep this +in mind if they need to deal with pre-1970 data. +.IP * +Some readers mishandle timestamps before the first +transition that has a nonnegative timestamp. +Readers that do not support negative timestamps are likely to +be more prone to this problem. +.IP * +Some readers mishandle time zone abbreviations like +.q "\*-08" +that contain +.q "+", +.q "\*-", +or digits. +.IP * +Some readers mishandle UT offsets that are out of the +traditional range of \-12 through +12 hours, and so do not +support locations like Kiritimati that are outside this +range. +.IP * +Some readers mishandle UT offsets in the range [\-3599, \-1] +seconds from UT, because they integer-divide the offset by +3600 to get 0 and then display the hour part as +.q "+00". +.IP * +Some readers mishandle UT offsets that are not a multiple +of one hour, or of 15 minutes, or of 1 minute. .SH SEE ALSO .BR time (2), .BR localtime (3), .BR tzset (3), .BR tzselect (8), .BR zdump (8), -.BR zic (8) +.BR zic (8). +.PP +Olson A, Eggert P, Murchison K. The Time Zone Information Format (TZif). +2019 Feb. +.UR https://\:www.rfc-editor.org/\:info/\:rfc8536 +Internet RFC 8536 +.UE +.UR https://\:doi.org/\:10.17487/\:RFC8536 +doi:10.17487/RFC8536 +.UE . .\" 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man5/utmp.5 b/man5/utmp.5 index 6d8581924..b6bbd3e12 100644 --- a/man5/utmp.5 +++ b/man5/utmp.5 @@ -65,13 +65,13 @@ around; details depend on the version of libc): #define EMPTY 0 /* Record does not contain valid info (formerly known as UT_UNKNOWN on Linux) */ #define RUN_LVL 1 /* Change in system run-level (see - \fBinit\fP(8)) */ + \fBinit\fP(1)) */ #define BOOT_TIME 2 /* Time of system boot (in \fIut_tv\fP) */ #define NEW_TIME 3 /* Time after system clock change (in \fIut_tv\fP) */ #define OLD_TIME 4 /* Time before system clock change (in \fIut_tv\fP) */ -#define INIT_PROCESS 5 /* Process spawned by \fBinit\fP(8) */ +#define INIT_PROCESS 5 /* Process spawned by \fBinit\fP(1) */ #define LOGIN_PROCESS 6 /* Session leader process for user login */ #define USER_PROCESS 7 /* Normal process */ #define DEAD_PROCESS 8 /* Terminated process */ @@ -98,7 +98,7 @@ struct utmp { messages */ struct exit_status ut_exit; /* Exit status of a process marked as DEAD_PROCESS; not - used by Linux init (1 */ + used by Linux init(1) */ /* The ut_session and ut_tv fields must be the same size when compiled 32- and 64-bit. This allows data files and shared memory to be shared between 32- and 64-bit applications. */ @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man6/intro.6 b/man6/intro.6 index 814d5fb07..5524c957f 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.06 of the Linux +This page is part of release 5.07 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 a5ffe008d..7bd52d503 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/aio.7 b/man7/aio.7 index 0847f6b96..fa5440b2f 100644 --- a/man7/aio.7 +++ b/man7/aio.7 @@ -193,7 +193,7 @@ reimplemented using the kernel system calls. .\" http://lse.sourceforge.net/io/aio.html .\" http://lse.sourceforge.net/io/aionotes.txt .\" http://lwn.net/Articles/148755/ -.SH EXAMPLE +.SH EXAMPLES The program below opens each of the files named in its command-line arguments and queues a request on the resulting file descriptor using .BR aio_read (3). @@ -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.06 of the Linux +This page is part of release 5.07 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 cad870cbc..0e2bc176c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/arp.7 b/man7/arp.7 index b72310e12..64a8ead8b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ascii.7 b/man7/ascii.7 index cb1419ab9..804e522ff 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -32,7 +32,7 @@ .\" Modified 1999-08-08 by Michael Haardt (michael@moria.de) .\" Modified 2004-04-01 by aeb .\" -.TH ASCII 7 2016-10-08 "Linux" "Linux Programmer's Manual" +.TH ASCII 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ascii \- ASCII character set encoded in octal, decimal, and hexadecimal @@ -185,12 +185,6 @@ Standards Institute (USASI) in 1968. .SH SEE ALSO .BR charsets (7), .BR iso_8859-1 (7), -.BR iso_8859-10 (7), -.BR iso_8859-11 (7), -.BR iso_8859-13 (7), -.BR iso_8859-14 (7), -.BR iso_8859-15 (7), -.BR iso_8859-16 (7), .BR iso_8859-2 (7), .BR iso_8859-3 (7), .BR iso_8859-4 (7), @@ -199,9 +193,15 @@ Standards Institute (USASI) in 1968. .BR iso_8859-7 (7), .BR iso_8859-8 (7), .BR iso_8859-9 (7), +.BR iso_8859-10 (7), +.BR iso_8859-11 (7), +.BR iso_8859-13 (7), +.BR iso_8859-14 (7), +.BR iso_8859-15 (7), +.BR iso_8859-16 (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/attributes.7 b/man7/attributes.7 index 8ad37cef9..ca8fa21ea 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/boot.7 b/man7/boot.7 index c9a041b56..6d35c5c35 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/bootparam.7 b/man7/bootparam.7 index 3aa090839..72f4262c3 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.06 of the Linux +This page is part of release 5.07 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 60faa4d83..85c26feda 100644 --- a/man7/bpf-helpers.7 +++ b/man7/bpf-helpers.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH BPF-HELPERS 7 2019-11-19 "Linux" "Linux Programmer's Manual" +.TH BPF-HELPERS 7 "" "" "" .SH NAME BPF-HELPERS \- list of eBPF helper functions . @@ -32,17 +32,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .. .\" Copyright (C) All BPF authors and contributors from 2014 to present. .\" See git log include/uapi/linux/bpf.h in kernel tree for details. -.\" +.\" .\" %%%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 @@ -50,11 +50,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" 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 -.\" +.\" .\" Please do not edit this file. It was generated from the documentation .\" located in file include/uapi/linux/bpf.h of the Linux kernel sources .\" (helpers description), and from scripts/bpf_helpers_doc.py in the same @@ -135,12 +135,15 @@ Delete entry with \fIkey\fP from \fImap\fP\&. 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_probe_read(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIsrc\fP\fB)\fP +.B \fBint bpf_probe_read(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP .INDENT 7.0 .TP .B Description For tracing programs, safely attempt to read \fIsize\fP bytes from -address \fIsrc\fP and store the data in \fIdst\fP\&. +kernel space address \fIunsafe_ptr\fP and store the data in \fIdst\fP\&. +.sp +Generally, use \fBbpf_probe_read_user\fP() or +\fBbpf_probe_read_kernel\fP() instead. .TP .B Return 0 on success, or a negative error in case of failure. @@ -151,6 +154,8 @@ address \fIsrc\fP and store the data in \fIdst\fP\&. .TP .B Description Return the time elapsed since system boot, in nanoseconds. +Does not include time the system was suspended. +See: \fBclock_gettime\fP(\fBCLOCK_MONOTONIC\fP) .TP .B Return Current \fIktime\fP\&. @@ -432,7 +437,7 @@ A 64\-bit integer containing the current GID and UID, and created as such: \fIcurrent_gid\fP \fB<< 32 |\fP \fIcurrent_uid\fP\&. .UNINDENT .TP -.B \fBint bpf_get_current_comm(char *\fP\fIbuf\fP\fB, u32\fP \fIsize_of_buf\fP\fB)\fP +.B \fBint bpf_get_current_comm(void *\fP\fIbuf\fP\fB, u32\fP \fIsize_of_buf\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -672,9 +677,9 @@ is present, egress path otherwise). Currently, XDP only supports redirection to the egress interface, and accepts no flag at all. .sp -The same effect can be attained with the more generic -\fBbpf_redirect_map\fP(), which requires specific maps to be -used but offers better performance. +The same effect can also be attained with the more generic +\fBbpf_redirect_map\fP(), which uses a BPF map to store the +redirect target instead of providing it directly to the helper. .TP .B Return For XDP, the helper returns \fBXDP_REDIRECT\fP on success or @@ -711,7 +716,7 @@ The realm of the route for the packet associated to \fIskb\fP, or 0 if none was found. .UNINDENT .TP -.B \fBint bpf_perf_event_output(struct pt_regs *\fP\fIctx\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u64\fP \fIflags\fP\fB, void *\fP\fIdata\fP\fB, u64\fP \fIsize\fP\fB)\fP +.B \fBint bpf_perf_event_output(void *\fP\fIctx\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u64\fP \fIflags\fP\fB, void *\fP\fIdata\fP\fB, u64\fP \fIsize\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -764,7 +769,7 @@ A combination of both. 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_skb_load_bytes(const struct sk_buff *\fP\fIskb\fP\fB, u32\fP \fIoffset\fP\fB, void *\fP\fIto\fP\fB, u32\fP \fIlen\fP\fB)\fP +.B \fBint bpf_skb_load_bytes(const void *\fP\fIskb\fP\fB, u32\fP \fIoffset\fP\fB, void *\fP\fIto\fP\fB, u32\fP \fIlen\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -785,7 +790,7 @@ at once from a packet into the eBPF stack. 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_get_stackid(struct pt_regs *\fP\fIctx\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u64\fP \fIflags\fP\fB)\fP +.B \fBint bpf_get_stackid(void *\fP\fIctx\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u64\fP \fIflags\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -876,7 +881,7 @@ The checksum result, or a negative error code in case of failure. .UNINDENT .TP -.B \fBint bpf_skb_get_tunnel_opt(struct sk_buff *\fP\fIskb\fP\fB, u8 *\fP\fIopt\fP\fB, u32\fP \fIsize\fP\fB)\fP +.B \fBint bpf_skb_get_tunnel_opt(struct sk_buff *\fP\fIskb\fP\fB, void *\fP\fIopt\fP\fB, u32\fP \fIsize\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -898,7 +903,7 @@ headers. The size of the option data retrieved. .UNINDENT .TP -.B \fBint bpf_skb_set_tunnel_opt(struct sk_buff *\fP\fIskb\fP\fB, u8 *\fP\fIopt\fP\fB, u32\fP \fIsize\fP\fB)\fP +.B \fBint bpf_skb_set_tunnel_opt(struct sk_buff *\fP\fIskb\fP\fB, void *\fP\fIopt\fP\fB, u32\fP \fIsize\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -1220,52 +1225,16 @@ direct packet access. 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_probe_read_str(void *\fP\fIdst\fP\fB, int\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP +.B \fBint bpf_probe_read_str(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP .INDENT 7.0 .TP .B Description -Copy a NUL terminated string from an unsafe address -\fIunsafe_ptr\fP to \fIdst\fP\&. The \fIsize\fP should include the -terminating NUL byte. In case the string length is smaller than -\fIsize\fP, the target is not padded with further NUL bytes. If the -string length is larger than \fIsize\fP, just \fIsize\fP\-1 bytes are -copied and the last byte is set to NUL. -.sp -On success, the length of the copied string is returned. This -makes this helper useful in tracing programs for reading -strings, and more importantly to get its length at runtime. See -the following snippet: -.INDENT 7.0 -.INDENT 3.5 +Copy a NUL terminated string from an unsafe kernel address +\fIunsafe_ptr\fP to \fIdst\fP\&. See \fBbpf_probe_read_kernel_str\fP() for +more details. .sp -.nf -.ft C -SEC("kprobe/sys_open") -void bpf_sys_open(struct pt_regs *ctx) -{ - char buf[PATHLEN]; // PATHLEN is defined to 256 - int res = bpf_probe_read_str(buf, sizeof(buf), - ctx\->di); - - // Consume buf, for example push it to - // userspace via bpf_perf_event_output(); we - // can use res (the string length) as event - // size, after checking its boundaries. -} -.ft P -.fi -.UNINDENT -.UNINDENT -.sp -In comparison, using \fBbpf_probe_read()\fP helper here instead -to read the string would require to estimate the length at -compile time, and would often result in copying more memory -than necessary. -.sp -Another useful use case is when parsing individual process -arguments or individual environment variables navigating -\fIcurrent\fP\fB\->mm\->arg_start\fP and \fIcurrent\fP\fB\->mm\->env_start\fP: using this helper and the return value, -one can quickly iterate at the right offset of the memory area. +Generally, use \fBbpf_probe_read_user_str\fP() or +\fBbpf_probe_read_kernel_str\fP() instead. .TP .B Return On success, the strictly positive length of the string, @@ -1305,7 +1274,7 @@ A 8\-byte long non\-decreasing number. .INDENT 7.0 .TP .B Description -Equivalent to bpf_get_socket_cookie() helper that accepts +Equivalent to \fBbpf_get_socket_cookie\fP() helper that accepts \fIskb\fP, but gets socket from \fBstruct bpf_sock_ops\fP context. .TP .B Return @@ -1334,7 +1303,7 @@ to value \fIhash\fP\&. 0 .UNINDENT .TP -.B \fBint bpf_setsockopt(struct bpf_sock_ops *\fP\fIbpf_socket\fP\fB, int\fP \fIlevel\fP\fB, int\fP \fIoptname\fP\fB, char *\fP\fIoptval\fP\fB, int\fP \fIoptlen\fP\fB)\fP +.B \fBint bpf_setsockopt(void *\fP\fIbpf_socket\fP\fB, int\fP \fIlevel\fP\fB, int\fP \fIoptname\fP\fB, void *\fP\fIoptval\fP\fB, int\fP \fIoptlen\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -1344,6 +1313,15 @@ which the option resides and the name \fIoptname\fP of the option must be specified, see \fBsetsockopt(2)\fP for more information. The option value of length \fIoptlen\fP is pointed by \fIoptval\fP\&. .sp +\fIbpf_socket\fP should be one of the following: +.INDENT 7.0 +.IP \(bu 2 +\fBstruct bpf_sock_ops\fP for \fBBPF_PROG_TYPE_SOCK_OPS\fP\&. +.IP \(bu 2 +\fBstruct bpf_sock_addr\fP for \fBBPF_CGROUP_INET4_CONNECT\fP +and \fBBPF_CGROUP_INET6_CONNECT\fP\&. +.UNINDENT +.sp This helper actually implements a subset of \fBsetsockopt()\fP\&. It supports the following \fIlevel\fPs: .INDENT 7.0 @@ -1372,6 +1350,15 @@ It supports the following \fIlevel\fPs: Grow or shrink the room for data in the packet associated to \fIskb\fP by \fIlen_diff\fP, and according to the selected \fImode\fP\&. .sp +By default, the helper will reset any offloaded checksum +indicator of the skb to CHECKSUM_NONE. This can be avoided +by the following flag: +.INDENT 7.0 +.IP \(bu 2 +\fBBPF_F_ADJ_ROOM_NO_CSUM_RESET\fP: Do not reset offloaded +checksum data of the skb to CHECKSUM_NONE. +.UNINDENT +.sp There are two supported modes at this time: .INDENT 7.0 .IP \(bu 2 @@ -1425,20 +1412,19 @@ support) as of this writing). .sp The lower two bits of \fIflags\fP are used as the return code if the map lookup fails. This is so that the return value can be -one of the XDP program return codes up to XDP_TX, as chosen by -the caller. Any higher bits in the \fIflags\fP argument must be +one of the XDP program return codes up to \fBXDP_TX\fP, as chosen +by the caller. Any higher bits in the \fIflags\fP argument must be unset. .sp -When used to redirect packets to net devices, this helper -provides a high performance increase over \fBbpf_redirect\fP(). -This is due to various implementation details of the underlying -mechanisms, one of which is the fact that \fBbpf_redirect_map\fP() tries to send packet as a "bulk" to the device. +See also \fBbpf_redirect\fP(), which only supports redirecting +to an ifindex, but doesn\(aqt require a map to do so. .TP .B Return -\fBXDP_REDIRECT\fP on success, or \fBXDP_ABORTED\fP on error. +\fBXDP_REDIRECT\fP on success, or the value of the two lower bits +of the \fIflags\fP argument on error. .UNINDENT .TP -.B \fBint bpf_sk_redirect_map(struct bpf_map *\fP\fImap\fP\fB, u32\fP \fIkey\fP\fB, u64\fP \fIflags\fP\fB)\fP +.B \fBint bpf_sk_redirect_map(struct sk_buff *\fP\fIskb\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u32\fP \fIkey\fP\fB, u64\fP \fIflags\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -1564,7 +1550,7 @@ Where t_enabled is the time enabled for event and t_running is the time running for event since last normalization. The enabled and running times are accumulated since the perf event open. To achieve scaling factor between two invocations of an -eBPF program, users can can use CPU id as the key (which is +eBPF program, users can use CPU id as the key (which is typical for perf array usage model) to remember the previous value and do the calculation inside the eBPF program. .TP @@ -1587,7 +1573,7 @@ more details). 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_getsockopt(struct bpf_sock_ops *\fP\fIbpf_socket\fP\fB, int\fP \fIlevel\fP\fB, int\fP \fIoptname\fP\fB, char *\fP\fIoptval\fP\fB, int\fP \fIoptlen\fP\fB)\fP +.B \fBint bpf_getsockopt(void *\fP\fIbpf_socket\fP\fB, int\fP \fIlevel\fP\fB, int\fP \fIoptname\fP\fB, void *\fP\fIoptval\fP\fB, int\fP \fIoptlen\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -1598,6 +1584,15 @@ must be specified, see \fBgetsockopt(2)\fP for more information. The retrieved value is stored in the structure pointed by \fIopval\fP and of length \fIoptlen\fP\&. .sp +\fIbpf_socket\fP should be one of the following: +.INDENT 7.0 +.IP \(bu 2 +\fBstruct bpf_sock_ops\fP for \fBBPF_PROG_TYPE_SOCK_OPS\fP\&. +.IP \(bu 2 +\fBstruct bpf_sock_addr\fP for \fBBPF_CGROUP_INET4_CONNECT\fP +and \fBBPF_CGROUP_INET6_CONNECT\fP\&. +.UNINDENT +.sp This helper actually implements a subset of \fBgetsockopt()\fP\&. It supports the following \fIlevel\fPs: .INDENT 7.0 @@ -1623,7 +1618,7 @@ the return value of the probed function, and to set it to \fIrc\fP\&. The first argument is the context \fIregs\fP on which the kprobe works. .sp -This helper works by setting setting the PC (program counter) +This helper works by setting the PC (program counter) to an override function which is run in place of the original probed function. This means the probed function is not run at all. The replacement function just returns with the required @@ -1831,10 +1826,11 @@ single IP address on a host that has multiple IP configured. .sp This helper works for IPv4 and IPv6, TCP and UDP sockets. The domain (\fIaddr\fP\fB\->sa_family\fP) must be \fBAF_INET\fP (or -\fBAF_INET6\fP). Looking for a free port to bind to can be -expensive, therefore binding to port is not permitted by the -helper: \fIaddr\fP\fB\->sin_port\fP (or \fBsin6_port\fP, respectively) -must be set to zero. +\fBAF_INET6\fP). It\(aqs advised to pass zero port (\fBsin_port\fP +or \fBsin6_port\fP) which triggers IP_BIND_ADDRESS_NO_PORT\-like +behavior and lets the kernel efficiently pick up an unused +port as long as 4\-tuple is unique. Passing non\-zero port might +lead to degraded performance. .TP .B Return 0 on success, or a negative error in case of failure. @@ -1845,8 +1841,8 @@ must be set to zero. .TP .B Description Adjust (move) \fIxdp_md\fP\fB\->data_end\fP by \fIdelta\fP bytes. It is -only possible to shrink the packet as of this writing, -therefore \fIdelta\fP must be a negative integer. +possible to both shrink and grow the packet tail. +Shrink done via \fIdelta\fP being a negative integer. .sp A call to this helper is susceptible to change the underlying packet buffer. Therefore, at load time, all checks on pointers @@ -1878,7 +1874,7 @@ This helper is available only if the kernel was compiled with 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_get_stack(struct pt_regs *\fP\fIregs\fP\fB, void *\fP\fIbuf\fP\fB, u32\fP \fIsize\fP\fB, u64\fP \fIflags\fP\fB)\fP +.B \fBint bpf_get_stack(void *\fP\fIctx\fP\fB, void *\fP\fIbuf\fP\fB, u32\fP \fIsize\fP\fB, u64\fP \fIflags\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -1924,7 +1920,7 @@ A non\-negative value equal to or less than \fIsize\fP on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_skb_load_bytes_relative(const struct sk_buff *\fP\fIskb\fP\fB, u32\fP \fIoffset\fP\fB, void *\fP\fIto\fP\fB, u32\fP \fIlen\fP\fB, u32\fP \fIstart_header\fP\fB)\fP +.B \fBint bpf_skb_load_bytes_relative(const void *\fP\fIskb\fP\fB, u32\fP \fIoffset\fP\fB, void *\fP\fIto\fP\fB, u32\fP \fIlen\fP\fB, u32\fP \fIstart_header\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -1996,7 +1992,7 @@ packet is not forwarded or needs assist from full stack .UNINDENT .UNINDENT .TP -.B \fBint bpf_sock_hash_update(struct bpf_sock_ops_kern *\fP\fIskops\fP\fB, struct bpf_map *\fP\fImap\fP\fB, void *\fP\fIkey\fP\fB, u64\fP \fIflags\fP\fB)\fP +.B \fBint bpf_sock_hash_update(struct bpf_sock_ops *\fP\fIskops\fP\fB, struct bpf_map *\fP\fImap\fP\fB, void *\fP\fIkey\fP\fB, u64\fP \fIflags\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -2455,7 +2451,7 @@ Get an element from \fImap\fP without removing it. 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_msg_push_data(struct sk_buff *\fP\fIskb\fP\fB, u32\fP \fIstart\fP\fB, u32\fP \fIlen\fP\fB, u64\fP \fIflags\fP\fB)\fP +.B \fBint bpf_msg_push_data(struct sk_msg_buff *\fP\fImsg\fP\fB, u32\fP \fIstart\fP\fB, u32\fP \fIlen\fP\fB, u64\fP \fIflags\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -2475,11 +2471,11 @@ error and BPF programs will need to handle them. 0 on success, or a negative error in case of failure. .UNINDENT .TP -.B \fBint bpf_msg_pop_data(struct sk_msg_buff *\fP\fImsg\fP\fB, u32\fP \fIstart\fP\fB, u32\fP \fIpop\fP\fB, u64\fP \fIflags\fP\fB)\fP +.B \fBint bpf_msg_pop_data(struct sk_msg_buff *\fP\fImsg\fP\fB, u32\fP \fIstart\fP\fB, u32\fP \fIlen\fP\fB, u64\fP \fIflags\fP\fB)\fP .INDENT 7.0 .TP .B Description -Will remove \fIpop\fP bytes from a \fImsg\fP starting at byte \fIstart\fP\&. +Will remove \fIlen\fP bytes from a \fImsg\fP starting at byte \fIstart\fP\&. This may result in \fBENOMEM\fP errors under certain situations if an allocation and copy are required due to a full ring buffer. However, the helper will try to avoid doing the allocation @@ -2613,7 +2609,7 @@ A \fBstruct bpf_tcp_sock\fP pointer on success, or \fBNULL\fP in case of failure. .UNINDENT .TP -.B \fBint bpf_skb_ecn_set_ce(struct sk_buf *\fP\fIskb\fP\fB)\fP +.B \fBint bpf_skb_ecn_set_ce(struct sk_buff *\fP\fIskb\fP\fB)\fP .INDENT 7.0 .TP .B Description @@ -2869,7 +2865,8 @@ Delete a bpf\-local\-storage from a \fIsk\fP\&. .INDENT 7.0 .TP .B Description -Send signal \fIsig\fP to the current task. +Send signal \fIsig\fP to the process of the current task. +The signal may be delivered to any of this process\(aqs threads. .TP .B Return 0 on success or successfully queued. @@ -2912,6 +2909,525 @@ On failure, the returned value is one of the following: .sp \fB\-EPROTONOSUPPORT\fP IP packet version is not 4 or 6 .UNINDENT +.TP +.B \fBint bpf_skb_output(void *\fP\fIctx\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u64\fP \fIflags\fP\fB, void *\fP\fIdata\fP\fB, u64\fP \fIsize\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Write raw \fIdata\fP blob into a special BPF perf event held by +\fImap\fP of type \fBBPF_MAP_TYPE_PERF_EVENT_ARRAY\fP\&. This perf +event must have the following attributes: \fBPERF_SAMPLE_RAW\fP +as \fBsample_type\fP, \fBPERF_TYPE_SOFTWARE\fP as \fBtype\fP, and +\fBPERF_COUNT_SW_BPF_OUTPUT\fP as \fBconfig\fP\&. +.sp +The \fIflags\fP are used to indicate the index in \fImap\fP for which +the value must be put, masked with \fBBPF_F_INDEX_MASK\fP\&. +Alternatively, \fIflags\fP can be set to \fBBPF_F_CURRENT_CPU\fP +to indicate that the index of the current CPU core should be +used. +.sp +The value to write, of \fIsize\fP, is passed through eBPF stack and +pointed by \fIdata\fP\&. +.sp +\fIctx\fP is a pointer to in\-kernel struct sk_buff. +.sp +This helper is similar to \fBbpf_perf_event_output\fP() but +restricted to raw_tracepoint bpf programs. +.TP +.B Return +0 on success, or a negative error in case of failure. +.UNINDENT +.TP +.B \fBint bpf_probe_read_user(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Safely attempt to read \fIsize\fP bytes from user space address +\fIunsafe_ptr\fP and store the data in \fIdst\fP\&. +.TP +.B Return +0 on success, or a negative error in case of failure. +.UNINDENT +.TP +.B \fBint bpf_probe_read_kernel(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Safely attempt to read \fIsize\fP bytes from kernel space address +\fIunsafe_ptr\fP and store the data in \fIdst\fP\&. +.TP +.B Return +0 on success, or a negative error in case of failure. +.UNINDENT +.TP +.B \fBint bpf_probe_read_user_str(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Copy a NUL terminated string from an unsafe user address +\fIunsafe_ptr\fP to \fIdst\fP\&. The \fIsize\fP should include the +terminating NUL byte. In case the string length is smaller than +\fIsize\fP, the target is not padded with further NUL bytes. If the +string length is larger than \fIsize\fP, just \fIsize\fP\-1 bytes are +copied and the last byte is set to NUL. +.sp +On success, the length of the copied string is returned. This +makes this helper useful in tracing programs for reading +strings, and more importantly to get its length at runtime. See +the following snippet: +.INDENT 7.0 +.INDENT 3.5 +.sp +.nf +.ft C +SEC("kprobe/sys_open") +void bpf_sys_open(struct pt_regs *ctx) +{ + char buf[PATHLEN]; // PATHLEN is defined to 256 + int res = bpf_probe_read_user_str(buf, sizeof(buf), + ctx\->di); + + // Consume buf, for example push it to + // userspace via bpf_perf_event_output(); we + // can use res (the string length) as event + // size, after checking its boundaries. +} +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +In comparison, using \fBbpf_probe_read_user\fP() helper here +instead to read the string would require to estimate the length +at compile time, and would often result in copying more memory +than necessary. +.sp +Another useful use case is when parsing individual process +arguments or individual environment variables navigating +\fIcurrent\fP\fB\->mm\->arg_start\fP and \fIcurrent\fP\fB\->mm\->env_start\fP: using this helper and the return value, +one can quickly iterate at the right offset of the memory area. +.TP +.B Return +On success, the strictly positive length of the string, +including the trailing NUL character. On error, a negative +value. +.UNINDENT +.TP +.B \fBint bpf_probe_read_kernel_str(void *\fP\fIdst\fP\fB, u32\fP \fIsize\fP\fB, const void *\fP\fIunsafe_ptr\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Copy a NUL terminated string from an unsafe kernel address \fIunsafe_ptr\fP +to \fIdst\fP\&. Same semantics as with \fBbpf_probe_read_user_str\fP() apply. +.TP +.B Return +On success, the strictly positive length of the string, including +the trailing NUL character. On error, a negative value. +.UNINDENT +.TP +.B \fBint bpf_tcp_send_ack(void *\fP\fItp\fP\fB, u32\fP \fIrcv_nxt\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Send out a tcp\-ack. \fItp\fP is the in\-kernel struct \fBtcp_sock\fP\&. +\fIrcv_nxt\fP is the ack_seq to be sent out. +.TP +.B Return +0 on success, or a negative error in case of failure. +.UNINDENT +.TP +.B \fBint bpf_send_signal_thread(u32\fP \fIsig\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Send signal \fIsig\fP to the thread corresponding to the current task. +.TP +.B Return +0 on success or successfully queued. +.sp +\fB\-EBUSY\fP if work queue under nmi is full. +.sp +\fB\-EINVAL\fP if \fIsig\fP is invalid. +.sp +\fB\-EPERM\fP if no permission to send the \fIsig\fP\&. +.sp +\fB\-EAGAIN\fP if bpf program can try again. +.UNINDENT +.TP +.B \fBu64 bpf_jiffies64(void)\fP +.INDENT 7.0 +.TP +.B Description +Obtain the 64bit jiffies +.TP +.B Return +The 64 bit jiffies +.UNINDENT +.TP +.B \fBint bpf_read_branch_records(struct bpf_perf_event_data *\fP\fIctx\fP\fB, void *\fP\fIbuf\fP\fB, u32\fP \fIsize\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +For an eBPF program attached to a perf event, retrieve the +branch records (\fBstruct perf_branch_entry\fP) associated to \fIctx\fP +and store it in the buffer pointed by \fIbuf\fP up to size +\fIsize\fP bytes. +.TP +.B Return +On success, number of bytes written to \fIbuf\fP\&. On error, a +negative value. +.sp +The \fIflags\fP can be set to \fBBPF_F_GET_BRANCH_RECORDS_SIZE\fP to +instead return the number of bytes required to store all the +branch entries. If this flag is set, \fIbuf\fP may be NULL. +.sp +\fB\-EINVAL\fP if arguments invalid or \fBsize\fP not a multiple +of \fBsizeof\fP(\fBstruct perf_branch_entry\fP). +.sp +\fB\-ENOENT\fP if architecture does not support branch records. +.UNINDENT +.TP +.B \fBint bpf_get_ns_current_pid_tgid(u64\fP \fIdev\fP\fB, u64\fP \fIino\fP\fB, struct bpf_pidns_info *\fP\fInsdata\fP\fB, u32\fP \fIsize\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Returns 0 on success, values for \fIpid\fP and \fItgid\fP as seen from the current +\fInamespace\fP will be returned in \fInsdata\fP\&. +.TP +.B Return +0 on success, or one of the following in case of failure: +.sp +\fB\-EINVAL\fP if dev and inum supplied don\(aqt match dev_t and inode number +with nsfs of current task, or if dev conversion to dev_t lost high bits. +.sp +\fB\-ENOENT\fP if pidns does not exists for the current task. +.UNINDENT +.TP +.B \fBint bpf_xdp_output(void *\fP\fIctx\fP\fB, struct bpf_map *\fP\fImap\fP\fB, u64\fP \fIflags\fP\fB, void *\fP\fIdata\fP\fB, u64\fP \fIsize\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Write raw \fIdata\fP blob into a special BPF perf event held by +\fImap\fP of type \fBBPF_MAP_TYPE_PERF_EVENT_ARRAY\fP\&. This perf +event must have the following attributes: \fBPERF_SAMPLE_RAW\fP +as \fBsample_type\fP, \fBPERF_TYPE_SOFTWARE\fP as \fBtype\fP, and +\fBPERF_COUNT_SW_BPF_OUTPUT\fP as \fBconfig\fP\&. +.sp +The \fIflags\fP are used to indicate the index in \fImap\fP for which +the value must be put, masked with \fBBPF_F_INDEX_MASK\fP\&. +Alternatively, \fIflags\fP can be set to \fBBPF_F_CURRENT_CPU\fP +to indicate that the index of the current CPU core should be +used. +.sp +The value to write, of \fIsize\fP, is passed through eBPF stack and +pointed by \fIdata\fP\&. +.sp +\fIctx\fP is a pointer to in\-kernel struct xdp_buff. +.sp +This helper is similar to \fBbpf_perf_eventoutput\fP() but +restricted to raw_tracepoint bpf programs. +.TP +.B Return +0 on success, or a negative error in case of failure. +.UNINDENT +.TP +.B \fBu64 bpf_get_netns_cookie(void *\fP\fIctx\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Retrieve the cookie (generated by the kernel) of the network +namespace the input \fIctx\fP is associated with. The network +namespace cookie remains stable for its lifetime and provides +a global identifier that can be assumed unique. If \fIctx\fP is +NULL, then the helper returns the cookie for the initial +network namespace. The cookie itself is very similar to that +of \fBbpf_get_socket_cookie\fP() helper, but for network +namespaces instead of sockets. +.TP +.B Return +A 8\-byte long opaque number. +.UNINDENT +.TP +.B \fBu64 bpf_get_current_ancestor_cgroup_id(int\fP \fIancestor_level\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Return id of cgroup v2 that is ancestor of the cgroup associated +with the current task at the \fIancestor_level\fP\&. The root cgroup +is at \fIancestor_level\fP zero and each step down the hierarchy +increments the level. If \fIancestor_level\fP == level of cgroup +associated with the current task, then return value will be the +same as that of \fBbpf_get_current_cgroup_id\fP(). +.sp +The helper is useful to implement policies based on cgroups +that are upper in hierarchy than immediate cgroup associated +with the current task. +.sp +The format of returned id and helper limitations are same as in +\fBbpf_get_current_cgroup_id\fP(). +.TP +.B Return +The id is returned or 0 in case the id could not be retrieved. +.UNINDENT +.TP +.B \fBint bpf_sk_assign(struct sk_buff *\fP\fIskb\fP\fB, struct bpf_sock *\fP\fIsk\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Assign the \fIsk\fP to the \fIskb\fP\&. When combined with appropriate +routing configuration to receive the packet towards the socket, +will cause \fIskb\fP to be delivered to the specified socket. +Subsequent redirection of \fIskb\fP via \fBbpf_redirect\fP(), +\fBbpf_clone_redirect\fP() or other methods outside of BPF may +interfere with successful delivery to the socket. +.sp +This operation is only valid from TC ingress path. +.sp +The \fIflags\fP argument must be zero. +.TP +.B Return +0 on success, or a negative error in case of failure: +.sp +\fB\-EINVAL\fP if specified \fIflags\fP are not supported. +.sp +\fB\-ENOENT\fP if the socket is unavailable for assignment. +.sp +\fB\-ENETUNREACH\fP if the socket is unreachable (wrong netns). +.sp +\fB\-EOPNOTSUPP\fP if the operation is not supported, for example +a call from outside of TC ingress. +.sp +\fB\-ESOCKTNOSUPPORT\fP if the socket type is not supported +(reuseport). +.UNINDENT +.TP +.B \fBu64 bpf_ktime_get_boot_ns(void)\fP +.INDENT 7.0 +.TP +.B Description +Return the time elapsed since system boot, in nanoseconds. +Does include the time the system was suspended. +See: \fBclock_gettime\fP(\fBCLOCK_BOOTTIME\fP) +.TP +.B Return +Current \fIktime\fP\&. +.UNINDENT +.TP +.B \fBint bpf_seq_printf(struct seq_file *\fP\fIm\fP\fB, const char *\fP\fIfmt\fP\fB, u32\fP \fIfmt_size\fP\fB, const void *\fP\fIdata\fP\fB, u32\fP \fIdata_len\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +\fBbpf_seq_printf\fP() uses seq_file \fBseq_printf\fP() to print +out the format string. +The \fIm\fP represents the seq_file. The \fIfmt\fP and \fIfmt_size\fP are for +the format string itself. The \fIdata\fP and \fIdata_len\fP are format string +arguments. The \fIdata\fP are a \fBu64\fP array and corresponding format string +values are stored in the array. For strings and pointers where pointees +are accessed, only the pointer values are stored in the \fIdata\fP array. +The \fIdata_len\fP is the size of \fIdata\fP in bytes. +.sp +Formats \fB%s\fP, \fB%p{i,I}{4,6}\fP requires to read kernel memory. +Reading kernel memory may fail due to either invalid address or +valid address but requiring a major memory fault. If reading kernel memory +fails, the string for \fB%s\fP will be an empty string, and the ip +address for \fB%p{i,I}{4,6}\fP will be 0. Not returning error to +bpf program is consistent with what \fBbpf_trace_printk\fP() does for now. +.TP +.B Return +0 on success, or a negative error in case of failure: +.sp +\fB\-EBUSY\fP if per\-CPU memory copy buffer is busy, can try again +by returning 1 from bpf program. +.sp +\fB\-EINVAL\fP if arguments are invalid, or if \fIfmt\fP is invalid/unsupported. +.sp +\fB\-E2BIG\fP if \fIfmt\fP contains too many format specifiers. +.sp +\fB\-EOVERFLOW\fP if an overflow happened: The same object will be tried again. +.UNINDENT +.TP +.B \fBint bpf_seq_write(struct seq_file *\fP\fIm\fP\fB, const void *\fP\fIdata\fP\fB, u32\fP \fIlen\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +\fBbpf_seq_write\fP() uses seq_file \fBseq_write\fP() to write the data. +The \fIm\fP represents the seq_file. The \fIdata\fP and \fIlen\fP represent the +data to write in bytes. +.TP +.B Return +0 on success, or a negative error in case of failure: +.sp +\fB\-EOVERFLOW\fP if an overflow happened: The same object will be tried again. +.UNINDENT +.TP +.B \fBu64 bpf_sk_cgroup_id(struct bpf_sock *\fP\fIsk\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Return the cgroup v2 id of the socket \fIsk\fP\&. +.sp +\fIsk\fP must be a non\-\fBNULL\fP pointer to a full socket, e.g. one +returned from \fBbpf_sk_lookup_xxx\fP(), +\fBbpf_sk_fullsock\fP(), etc. The format of returned id is +same as in \fBbpf_skb_cgroup_id\fP(). +.sp +This helper is available only if the kernel was compiled with +the \fBCONFIG_SOCK_CGROUP_DATA\fP configuration option. +.TP +.B Return +The id is returned or 0 in case the id could not be retrieved. +.UNINDENT +.TP +.B \fBu64 bpf_sk_ancestor_cgroup_id(struct bpf_sock *\fP\fIsk\fP\fB, int\fP \fIancestor_level\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Return id of cgroup v2 that is ancestor of cgroup associated +with the \fIsk\fP at the \fIancestor_level\fP\&. The root cgroup is at +\fIancestor_level\fP zero and each step down the hierarchy +increments the level. If \fIancestor_level\fP == level of cgroup +associated with \fIsk\fP, then return value will be same as that +of \fBbpf_sk_cgroup_id\fP(). +.sp +The helper is useful to implement policies based on cgroups +that are upper in hierarchy than immediate cgroup associated +with \fIsk\fP\&. +.sp +The format of returned id and helper limitations are same as in +\fBbpf_sk_cgroup_id\fP(). +.TP +.B Return +The id is returned or 0 in case the id could not be retrieved. +.UNINDENT +.TP +.B \fBvoid *bpf_ringbuf_output(void *\fP\fIringbuf\fP\fB, void *\fP\fIdata\fP\fB, u64\fP \fIsize\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Copy \fIsize\fP bytes from \fIdata\fP into a ring buffer \fIringbuf\fP\&. +If BPF_RB_NO_WAKEUP is specified in \fIflags\fP, no notification of +new data availability is sent. +IF BPF_RB_FORCE_WAKEUP is specified in \fIflags\fP, notification of +new data availability is sent unconditionally. +.TP +.B Return +0, on success; +< 0, on error. +.UNINDENT +.TP +.B \fBvoid *bpf_ringbuf_reserve(void *\fP\fIringbuf\fP\fB, u64\fP \fIsize\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Reserve \fIsize\fP bytes of payload in a ring buffer \fIringbuf\fP\&. +.TP +.B Return +Valid pointer with \fIsize\fP bytes of memory available; NULL, +otherwise. +.UNINDENT +.TP +.B \fBvoid bpf_ringbuf_submit(void *\fP\fIdata\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Submit reserved ring buffer sample, pointed to by \fIdata\fP\&. +If BPF_RB_NO_WAKEUP is specified in \fIflags\fP, no notification of +new data availability is sent. +IF BPF_RB_FORCE_WAKEUP is specified in \fIflags\fP, notification of +new data availability is sent unconditionally. +.TP +.B Return +Nothing. Always succeeds. +.UNINDENT +.TP +.B \fBvoid bpf_ringbuf_discard(void *\fP\fIdata\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Discard reserved ring buffer sample, pointed to by \fIdata\fP\&. +If BPF_RB_NO_WAKEUP is specified in \fIflags\fP, no notification of +new data availability is sent. +IF BPF_RB_FORCE_WAKEUP is specified in \fIflags\fP, notification of +new data availability is sent unconditionally. +.TP +.B Return +Nothing. Always succeeds. +.UNINDENT +.TP +.B \fBu64 bpf_ringbuf_query(void *\fP\fIringbuf\fP\fB, u64\fP \fIflags\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Query various characteristics of provided ring buffer. What +exactly is queries is determined by \fIflags\fP: +.IP "System Message: ERROR/3 (/tmp/bpf-helpers.rst:, line 2636)" +Unexpected indentation. +.INDENT 7.0 +.INDENT 3.5 +.INDENT 0.0 +.IP \(bu 2 +BPF_RB_AVAIL_DATA \- amount of data not yet consumed; +.IP \(bu 2 +BPF_RB_RING_SIZE \- the size of ring buffer; +.IP \(bu 2 +BPF_RB_CONS_POS \- consumer position (can wrap around); +.IP \(bu 2 +BPF_RB_PROD_POS \- producer(s) position (can wrap around); +.UNINDENT +.UNINDENT +.UNINDENT +.IP "System Message: WARNING/2 (/tmp/bpf-helpers.rst:, line 2640)" +Block quote ends without a blank line; unexpected unindent. +.sp +Data returned is just a momentary snapshots of actual values +and could be inaccurate, so this facility should be used to +power heuristics and for reporting, not to make 100% correct +calculation. +.TP +.B Return +Requested value, or 0, if flags are not recognized. +.UNINDENT +.TP +.B \fBint bpf_csum_level(struct sk_buff *\fP\fIskb\fP\fB, u64\fP \fIlevel\fP\fB)\fP +.INDENT 7.0 +.TP +.B Description +Change the skbs checksum level by one layer up or down, or +reset it entirely to none in order to have the stack perform +checksum validation. The level is applicable to the following +protocols: TCP, UDP, GRE, SCTP, FCOE. For example, a decap of +| ETH | IP | UDP | GUE | IP | TCP | into | ETH | IP | TCP | +through \fBbpf_skb_adjust_room\fP() helper with passing in +\fBBPF_F_ADJ_ROOM_NO_CSUM_RESET\fP flag would require one call +to \fBbpf_csum_level\fP() with \fBBPF_CSUM_LEVEL_DEC\fP since +the UDP header is removed. Similarly, an encap of the latter +into the former could be accompanied by a helper call to +\fBbpf_csum_level\fP() with \fBBPF_CSUM_LEVEL_INC\fP if the +skb is still intended to be processed in higher layers of the +stack instead of just egressing at tc. +.sp +There are three supported level settings at this time: +.INDENT 7.0 +.IP \(bu 2 +\fBBPF_CSUM_LEVEL_INC\fP: Increases skb\->csum_level for skbs +with CHECKSUM_UNNECESSARY. +.IP \(bu 2 +\fBBPF_CSUM_LEVEL_DEC\fP: Decreases skb\->csum_level for skbs +with CHECKSUM_UNNECESSARY. +.IP \(bu 2 +\fBBPF_CSUM_LEVEL_RESET\fP: Resets skb\->csum_level to 0 and +sets CHECKSUM_NONE to force checksum validation by the stack. +.IP \(bu 2 +\fBBPF_CSUM_LEVEL_QUERY\fP: No\-op, returns the current +skb\->csum_level. +.UNINDENT +.TP +.B Return +0 on success, or a negative error in case of failure. In the +case of \fBBPF_CSUM_LEVEL_QUERY\fP, the current skb\->csum_level +is returned or the error code \-EACCES in case the skb is not +subject to CHECKSUM_UNNECESSARY. +.UNINDENT .UNINDENT .SH EXAMPLES .sp @@ -2972,6 +3488,12 @@ of eBPF maps are used with a given helper function. .IP \(bu 2 \fIkernel/bpf/\fP directory contains other files in which additional helpers are defined (for cgroups, sockmaps, etc.). +.IP \(bu 2 +The bpftool utility can be used to probe the availability of helper functions +on the system (as well as supported program and map types, and a number of +other parameters). To do so, run \fBbpftool feature probe\fP (see +\fBbpftool\-feature\fP(8) for details). Add the \fBunprivileged\fP keyword to +list features available to unprivileged users. .UNINDENT .sp Compatibility between helper functions and program types can generally be found @@ -2991,6 +3513,7 @@ pointers for network processing are listed in function .SH SEE ALSO .sp \fBbpf\fP(2), +\fBbpftool\fP(8), \fBcgroups\fP(7), \fBip\fP(8), \fBperf_event_open\fP(2), @@ -3000,7 +3523,7 @@ pointers for network processing are listed in function .\" Generated by docutils manpage writer. . .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/capabilities.7 b/man7/capabilities.7 index ad8237dfe..4a8e8a5ac 100644 --- a/man7/capabilities.7 +++ b/man7/capabilities.7 @@ -224,7 +224,7 @@ modify routing tables; .IP * bind to any address for transparent proxying; .IP * -set type-of-service (TOS) +set type-of-service (TOS); .IP * clear driver statistics; .IP * @@ -365,7 +365,7 @@ perform operations on .I trusted and .I security -Extended Attributes (see +extended attributes (see .BR xattr (7)); .IP * use @@ -685,7 +685,7 @@ override the limit when setting the capacity of a pipe using the .B F_SETPIPE_SZ .BR fcntl (2) -command. +command; .IP * use .BR F_SETPIPE_SZ @@ -1784,7 +1784,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.06 of the Linux +This page is part of release 5.07 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 da35dca15..b65a0b4ad 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cgroups.7 b/man7/cgroups.7 index 2e2ebe170..25653cd85 100644 --- a/man7/cgroups.7 +++ b/man7/cgroups.7 @@ -87,6 +87,10 @@ Initially marked experimental, and hidden behind the mount option, the new version (cgroups version 2) was eventually made official with the release of Linux 4.5. Differences between the two versions are described in the text below. +The file +.IR cgroup.sane_behavior , +present in cgroups v1, is a relic of this mount option. The file +always reports "0" and is only retained for backward compatibility. .PP Although cgroups v2 is intended as a replacement for cgroups v1, the older system continues to exist @@ -1706,6 +1710,12 @@ A child process created via inherits its parent's cgroup memberships. A process's cgroup memberships are preserved across .BR execve (2). +.PP +The +.BR clone3 (2) +.B CLONE_INTO_CGROUP +flag can be used to create a child process that begins its life in +a different version 2 cgroup from the parent process. .\" .SS /proc files .TP @@ -1870,7 +1880,7 @@ mount option. The kernel source file .IR Documentation/admin-guide/cgroup-v2.rst . .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/charsets.7 b/man7/charsets.7 index d29ea3608..980dad98f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/complex.7 b/man7/complex.7 index c42ed866f..02a09427c 100644 --- a/man7/complex.7 +++ b/man7/complex.7 @@ -4,7 +4,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH COMPLEX 7 2019-03-06 "" "Linux Programmer's Manual" +.TH COMPLEX 7 2020-06-09 "" "Linux Programmer's Manual" .SH NAME complex \- basics of complex mathematics .SH SYNOPSIS @@ -33,7 +33,7 @@ The basic operations are defined on z = a+b*i and w = c+d*i as: .PP Nearly all math function have a complex counterpart but there are some complex-only functions. -.SH EXAMPLE +.SH EXAMPLES Your C-compiler can work with complex numbers if it supports the C99 standard. Link with \fI\-lm\fP. The imaginary unit is represented by I. @@ -80,7 +80,7 @@ main(void) .BR ctan (3), .BR ctanh (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1251.7 b/man7/cp1251.7 index 281803090..6af5b82d5 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1252.7 b/man7/cp1252.7 index 6441b7eeb..b494502e6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cpuset.7 b/man7/cpuset.7 index 2d95646d4..0705bf755 100644 --- a/man7/cpuset.7 +++ b/man7/cpuset.7 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH CPUSET 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH CPUSET 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME cpuset \- confine processes to processor and memory node subsets .SH DESCRIPTION @@ -1362,7 +1362,7 @@ and the creation and truncation options on .BR open (2) have no effect. .\" ================== EXAMPLE ================== -.SH EXAMPLE +.SH EXAMPLES The following examples demonstrate querying and setting cpuset options using shell commands. .SS Creating and attaching to a cpuset. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/credentials.7 b/man7/credentials.7 index 174fded07..0e888d1fb 100644 --- a/man7/credentials.7 +++ b/man7/credentials.7 @@ -24,7 +24,7 @@ .\" .\" 2007-06-13 Creation .\" -.TH CREDENTIALS 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH CREDENTIALS 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME credentials \- process identifiers .SH DESCRIPTION @@ -247,9 +247,7 @@ of which a process may be a member. .\" /proc/sys/kernel/ngroups_max. .\" As at 2.6.22-rc2, this file is still read-only. A process can obtain its set of supplementary group IDs using -.BR getgroups (2), -and can modify the set using -.BR setgroups (2). +.BR getgroups (2). .PP A child process created by .BR fork (2) @@ -284,6 +282,42 @@ when checking resource limits (see when checking the limit on the number of inotify instances that the process may create (see .BR inotify (7)). +.\" +.SS Modifying process user and group IDs +.PP +Subject to rules described in the relevant manual pages, +a process can use the following APIs to modify its user and group IDs: +.TP +.BR setuid "(2) (" setgid (2)) +Modify the process's real (and possibly effective and saved-set) +user (group) IDs. +.TP +.BR seteuid "(2) (" setegid (2)) +Modify the process's effective user (group) ID. +.TP +.BR setfsuid "(2) (" setfsgid (2)) +Modify the process's filesystem user (group) ID. +.TP +.BR setreuid "(2) (" setregid (2)) +Modify the process's real and effective (and possibly saved-set) +user (group) IDs. +.TP +.BR setresuid "(2) (" setresgid (2)) +Modify the process's real, effective, and saved-set user (group) IDs. +.TP +.BR setgroups (2) +Modify the process's supplementary group list. +.PP +Any changes to a process's effective user (group) ID +are automatically carried over to the process's +filesystem user (group) ID. +Changes to a process's effective user or group ID can also affect the +process "dumpable" attribute, as described in +.BR prctl (2). +.PP +Changes to process user and group IDs can affect the capabilities +of the process, as described in +.BR capabilities (7). .SH CONFORMING TO Process IDs, parent process IDs, process group IDs, and session IDs are specified in POSIX.1. @@ -363,7 +397,7 @@ for further details. .BR user_namespaces (7), .BR sudo (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ddp.7 b/man7/ddp.7 index 52a8c4730..9c7b09a41 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/environ.7 b/man7/environ.7 index dfc1a3fa6..06ddbeff7 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/epoll.7 b/man7/epoll.7 index dbbbf2a0f..dd2b3a8d6 100644 --- a/man7/epoll.7 +++ b/man7/epoll.7 @@ -623,7 +623,7 @@ is present in an epoll instance. .BR poll (2), .BR select (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fanotify.7 b/man7/fanotify.7 index 95169dde3..dbdaee6bf 100644 --- a/man7/fanotify.7 +++ b/man7/fanotify.7 @@ -22,7 +22,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH FANOTIFY 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH FANOTIFY 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME fanotify \- monitoring filesystem events .SH DESCRIPTION @@ -381,6 +381,24 @@ This is a synonym for: .IP FAN_MOVED_FROM | FAN_MOVED_TO .PP +The following bits may appear in +.I mask +only in conjunction with other event type bits: +.TP +.B FAN_ONDIR +The events described in the +.I mask +have occurred on a directory object. +Reporting events on directories requires setting this flag in the mark mask. +See +.BR fanotify_mark (2) +for additional details. +The +.BR FAN_ONDIR +flag is reported in an event mask only if the fanotify group has been +initialized with the flag +.BR FAN_REPORT_FID . +.PP The fields of the .I fanotify_event_info_fid structure are as follows: @@ -678,7 +696,7 @@ The return value will not be \-1, and .I errno will not be set. Thus, the reading application has no way to detect the error. -.SH EXAMPLE +.SH EXAMPLES The two example programs below demonstrate the usage of the fanotify API. .SS Example program: fanotify_example.c The first program is an example of fanotify being @@ -938,21 +956,20 @@ This is followed by the creation of a regular file, .IR /home/user/testfile.txt . This results in a .B FAN_CREATE -event being created and reported against the file's parent watched +event being generated and reported against the file's parent watched directory object. Program execution ends once all events captured within the buffer have been processed. -Program execution ends once all events captured within the buffer are -processed. .PP .in +4n .EX # \fB./fanotify_fid /home/user\fP Listening for events. -FAN_CREATE (file created): Directory /home/user has been modified. +FAN_CREATE (file created): + Directory /home/user has been modified. All events processed successfully. Program exiting. -$ \fBtouch /home/user/testing\fP # In another terminal +$ \fBtouch /home/user/testfile.txt\fP # In another terminal .EE .in .PP @@ -960,11 +977,11 @@ The second session shows a mark being placed on .IR /home/user . This is followed by the creation of a directory, .IR /home/user/testdir . -This specific action results in the program producing a +This specific action results in a .B FAN_CREATE -and +event being generated and is reported with the .B FAN_ONDIR -event. +flag set. .PP .in +4n .EX @@ -974,7 +991,7 @@ FAN_CREATE | FAN_ONDIR (subdirectory created): Directory /home/user has been modified. All events processed successfully. Program exiting. -$ \fBmkdir \-p /home/user/testing\fP # In another terminal +$ \fBmkdir \-p /home/user/testdir\fP # In another terminal .EE .in .SS Program source: fanotify_fid.c @@ -996,7 +1013,7 @@ $ \fBmkdir \-p /home/user/testing\fP # In another terminal int main(int argc, char **argv) { - int fd, ret, event_fd; + int fd, ret, event_fd, mount_fd; ssize_t len, path_len; char path[PATH_MAX]; char procfd_path[PATH_MAX]; @@ -1010,6 +1027,13 @@ main(int argc, char **argv) exit(EXIT_FAILURE); } + mount_fd = open(argv[1], O_DIRECTORY | O_RDONLY); + if (mount_fd == \-1) { + perror(argv[1]); + exit(EXIT_FAILURE); + } + + /* Create an fanotify file descriptor with FAN_REPORT_FID as a flag so that program can receive fid events. */ @@ -1055,21 +1079,22 @@ main(int argc, char **argv) } if (metadata\->mask == FAN_CREATE) - printf("FAN_CREATE (file created):"); - - 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. - 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 - open_by_handle_at(2) system call. A check for ESTALE is done - to accommodate for the situation where the file handle for the - object was deleted prior to this system call. */ - - event_fd = open_by_handle_at(AT_FDCWD, file_handle, O_RDONLY); - if (ret == \-1) { + printf("FAN_CREATE (file created):\en"); + + if (metadata\->mask == (FAN_CREATE | FAN_ONDIR)) + printf("FAN_CREATE | FAN_ONDIR (subdirectory created):\en"); + + /* 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 open_by_handle_at(2) system call. + A check for ESTALE is done to accommodate for the situation + where the file handle for the object was deleted prior to + this system call. */ + + event_fd = open_by_handle_at(mount_fd, file_handle, O_RDONLY); + if (event_fd == \-1) { if (errno == ESTALE) { printf("File handle is no longer valid. " "File has been deleted\en"); @@ -1077,7 +1102,7 @@ main(int argc, char **argv) } else { perror("open_by_handle_at"); exit(EXIT_FAILURE); - } + } } snprintf(procfd_path, sizeof(procfd_path), "/proc/self/fd/%d", @@ -1109,7 +1134,7 @@ main(int argc, char **argv) .BR fanotify_mark (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 78fe45f2a..bb160d72b 100644 --- a/man7/feature_test_macros.7 +++ b/man7/feature_test_macros.7 @@ -787,7 +787,7 @@ Programs should define these macros directly: instead, the appropriate feature test macro(s) from the list above should be employed. -.SH EXAMPLE +.SH EXAMPLES The program below can be used to explore how the various feature test macros are set depending on the glibc version and what feature test macros are explicitly set. @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fifo.7 b/man7/fifo.7 index f74018c84..824bd883f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/futex.7 b/man7/futex.7 index 413780e0e..5eb9cf09d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/glob.7 b/man7/glob.7 index 35c27694c..c5e392d00 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hier.7 b/man7/hier.7 index 0d2c23c1e..c687ff488 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -28,7 +28,7 @@ .\" Modified Mon Feb 6 16:41:00 1999 by Nicolás Lichtmaier <nick@debian.org> .\" Modified Tue Feb 8 16:46:45 2000 by Chris Pepper <pepper@tgg.com> .\" Modified Fri Sep 7 20:32:45 2001 by Tammy Fox <tfox@redhat.com> -.TH HIER 7 2017-11-26 "Linux" "Linux Programmer's Manual" +.TH HIER 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME hier \- description of the filesystem hierarchy .SH DESCRIPTION @@ -161,6 +161,12 @@ This pseudo-filesystem is described in more detail in .I /root This directory is usually the home directory for the root user (optional). .TP +.I /run +This directory contains information which describes the system since it was booted. +Once this purpose was served by +.IR /var/run +and programs may continue to use it. +.TP .I /sbin Like .IR /bin , @@ -186,7 +192,8 @@ It should hold only shareable, read-only data, so that it can be mounted by various machines running Linux. .TP .I /usr/X11R6 -The X\-Window system, version 11 release 6 (optional). +The X\-Window system, version 11 release 6 (present in FHS 2.3, removed +in FHS 3.0). .TP .I /usr/X11R6/bin Binaries which belong to the X\-Window system; often, there is a @@ -296,6 +303,10 @@ which usually are not invoked directly. More complicated programs may have whole subdirectories there. .TP +.I /usr/libexec +Directory contains binaries for internal use only and they are not meant +to be executed directly by users shell or scripts. +.TP .I /usr/lib<qual> These directories are variants of .I /usr/lib @@ -385,6 +396,10 @@ or or .IR /usr/man . .TP +.I /usr/share/color +Contains color management information, like International Color Consortium (ICC) +Color profiles (optional). +.TP .I /usr/share/dict Contains the word lists used by spell checkers (optional). .TP @@ -421,6 +436,9 @@ same OS. .I /usr/share/nls The message catalogs for native language support go here (optional). .TP +.I /usr/share/ppd +Postscript Printer Definition (PPD) files (optional). +.TP .I /usr/share/sgml Files for SGML (optional). .TP @@ -523,6 +541,9 @@ Variable game data (optional). .I /var/lib Variable state information for programs. .TP +.I /var/lib/color +Variable files containing color management information (optional). +.TP .I /var/lib/hwclock State directory for hwclock (optional). .TP @@ -635,11 +656,11 @@ this directory holds temporary files stored for an unspecified duration. Database files for NIS, formerly known as the Sun Yellow Pages (YP). .SH CONFORMING TO -The Filesystem Hierarchy Standard, Version 2.3 -.UR http://www.pathname.com\:/fhs/ +The Filesystem Hierarchy Standard (FHS), Version 3.0, published March 19, 2015 +.UR https://refspecs.linuxfoundation.org/fhs.shtml .UE . .SH BUGS -This list is not exhaustive; different systems may be configured +This list is not exhaustive; different distributions and systems may be configured differently. .SH SEE ALSO .BR find (1), @@ -650,7 +671,7 @@ differently. .PP The Filesystem Hierarchy Standard .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hostname.7 b/man7/hostname.7 index b8d2ec31a..59b6e1543 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/icmp.7 b/man7/icmp.7 index bcb2b490e..b49d9638e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inode.7 b/man7/inode.7 index 1690e319b..d91687def 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inotify.7 b/man7/inotify.7 index 46f944c0a..57e0acc38 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INOTIFY 7 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH INOTIFY 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME inotify \- monitoring filesystem events .SH DESCRIPTION @@ -877,7 +877,7 @@ of the bug occurring in real-world applications, as of Linux 3.15, .\" FIXME . https://bugzilla.kernel.org/show_bug.cgi?id=77111 no kernel changes have yet been made to eliminate this possible bug. -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the usage of the inotify API. It marks the directories passed as a command-line arguments and waits for events of type @@ -923,6 +923,7 @@ Listening for events stopped. #include <stdlib.h> #include <sys/inotify.h> #include <unistd.h> +#include <string.h> /* Read all available inotify events from the file descriptor 'fd'. wd is the table of watch descriptors for the directories in argv. @@ -1121,7 +1122,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/intro.7 b/man7/intro.7 index be0288223..ef420594b 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, @@ -45,7 +45,7 @@ .\" commit 76e21053b5bf33a07c76f99d27a74238310e3c71 .\" Author: Erich E. Hoover <ehoover@mines.edu> .\" -.TH IP 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH IP 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME ip \- Linux IPv4 protocol implementation .SH SYNOPSIS @@ -78,28 +78,44 @@ An IP socket is created using .PP socket(AF_INET, socket_type, protocol); .PP -Valid socket types are +Valid socket types include .B SOCK_STREAM -to open a -.BR tcp (7) -socket, +to open a stream socket, .B SOCK_DGRAM -to open a -.BR udp (7) -socket, or +to open a datagram socket, and .B SOCK_RAW to open a .BR raw (7) socket to access the IP protocol directly. +.PP .I protocol is the IP protocol in the IP header to be received or sent. -The only valid values for +Valid values for .I protocol -are 0 and +include: +.IP \(bu 2 +0 and .B IPPROTO_TCP -for TCP sockets, and 0 and +for +.BR tcp (7) +stream sockets; +.IP \(bu +0 and .B IPPROTO_UDP -for UDP sockets. +for +.BR udp (7) +datagram sockets; +.IP \(bu +.B IPPROTO_SCTP +for +.BR sctp (7) +stream sockets; and +.IP \(bu +.B IPPROTO_UDPLITE +for +.BR udplite (7) +datagram sockets. +.PP For .B SOCK_RAW you may specify a valid IANA IP protocol defined in @@ -336,7 +352,7 @@ The structure is similar to .I ip_mreqn described under -.BR IP_ADD_MEMBERSIP . +.BR IP_ADD_MEMBERSHIP . The .I imr_multiaddr field contains the address of the multicast group the application @@ -1326,6 +1342,7 @@ does not work in some 2.2 kernels. .BR capabilities (7), .BR icmp (7), .BR ipv6 (7), +.BR netdevice (7), .BR netlink (7), .BR raw (7), .BR socket (7), @@ -1340,7 +1357,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ipc_namespaces.7 b/man7/ipc_namespaces.7 index a8726ba6f..b2a249597 100644 --- a/man7/ipc_namespaces.7 +++ b/man7/ipc_namespaces.7 @@ -85,7 +85,7 @@ option. .BR namespaces (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ipv6.7 b/man7/ipv6.7 index 5240358d1..cdd673f36 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.06 of the Linux +This page is part of release 5.07 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 e5efa4cb4..2e2eed146 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.06 of the Linux +This page is part of release 5.07 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 ea453007a..427870cc2 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.06 of the Linux +This page is part of release 5.07 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 e1783e29a..e6db8c9f5 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.06 of the Linux +This page is part of release 5.07 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 0773fe61f..3167447e9 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.06 of the Linux +This page is part of release 5.07 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 1d1eda1d5..681255f0f 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.06 of the Linux +This page is part of release 5.07 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 9d11022d6..986c9655d 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.06 of the Linux +This page is part of release 5.07 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 9c27702bf..1be8c6236 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.06 of the Linux +This page is part of release 5.07 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 7e503fd54..3a0c54c60 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.06 of the Linux +This page is part of release 5.07 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 219a44745..42ad8f7d6 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.06 of the Linux +This page is part of release 5.07 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 3cf22eb35..531cf4333 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.06 of the Linux +This page is part of release 5.07 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 6cad829a2..f72de9b05 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.06 of the Linux +This page is part of release 5.07 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 b7daf4ff6..fc7c72b52 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.06 of the Linux +This page is part of release 5.07 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 91aa9a640..9bce9408f 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.06 of the Linux +This page is part of release 5.07 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 d4f83f643..cf2ff3cb9 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.06 of the Linux +This page is part of release 5.07 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 53a2e77a2..18814412d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/keyrings.7 b/man7/keyrings.7 index c1788435d..d7e172a7c 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.06 of the Linux +This page is part of release 5.07 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 c21c3ee6a..09960d649 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.06 of the Linux +This page is part of release 5.07 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 a8cce3077..716ec39dd 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/libc.7 b/man7/libc.7 index efdc6d95b..1f3fbf98c 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/locale.7 b/man7/locale.7 index 817ffa3d6..2070647a6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/mailaddr.7 b/man7/mailaddr.7 index 127a31e14..30b0073e3 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.06 of the Linux +This page is part of release 5.07 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 251a8e911..e24187578 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -50,11 +50,11 @@ for authors writing man pages for other projects. The manual Sections are traditionally defined as follows: .TP .B 1 User commands (Programs) -Those commands that can be executed by the user from within +Commands that can be executed by the user from within a shell. .TP .B 2 System calls -Those functions which wrap operations performed by the kernel. +Functions which wrap operations performed by the kernel. .TP .B 3 Library calls All library functions excluding the system call wrappers @@ -195,9 +195,11 @@ ATTRIBUTES [Normally only in Sections 2, 3] CONFORMING TO NOTES BUGS -EXAMPLE +EXAMPLES .\" AUTHORS sections are discouraged -.\" AUTHORS [Discouraged] +AUTHORS [Discouraged] +REPORTING BUGS [Not used in man-pages] +COPYRIGHT [Not used in man-pages] \fBSEE ALSO\fP .fi .in @@ -434,7 +436,7 @@ the raw system call interface provided by the kernel. A list of limitations, known defects or inconveniences, and other questionable activities. .TP -.B EXAMPLE +.B EXAMPLES One or more examples demonstrating how this function, file or command is used. .IP @@ -452,6 +454,23 @@ add a copyright notice as a comment in the source file. If you are the author of a device driver and want to include an address for reporting bugs, place this under the BUGS section. .TP +.B REPORTING BUGS +The +.IR man-pages +project doesn't use a REPORTING BUGS section in manual pages. +Information on reporting bugs is instead supplied in the +script-generated COLOPHON section. +However, various projects do use a REPORTING BUGS section. +it is recommended to place it near the foot of the page. +.TP +.B COPYRIGHT +The +.IR man-pages +project doesn't use a COPYRIGHT section in manual pages. +Copyright information is instead maintained in the page source. +In pages where this section is present, +it is recommended to place it near the foot of the page, just above SEE ALSO. +.TP .B SEE ALSO A comma-separated list of related man pages, possibly followed by other related pages or documents. @@ -974,7 +993,7 @@ For some examples of what example programs should look like, see .BR wait (2) and .BR pipe (2). -.SH EXAMPLE +.SH EXAMPLES For canonical examples of how man pages in the .I man-pages package should look, see @@ -990,7 +1009,7 @@ and .BR man (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/man.7 b/man7/man.7 index 0c43f8b9e..c87ad698d 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.06 of the Linux +This page is part of release 5.07 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 e6691e652..fbc6cb209 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.06 of the Linux +This page is part of release 5.07 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 46c7b0e2d..796b954ba 100644 --- a/man7/mount_namespaces.7 +++ b/man7/mount_namespaces.7 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" -.TH MOUNT_NAMESPACES 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH MOUNT_NAMESPACES 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mount_namespaces \- overview of Linux mount namespaces .SH DESCRIPTION @@ -97,9 +97,7 @@ This ensures that mappings performed in less privileged mount namespaces will not propagate to more privileged mount namespaces. .IP * -.\" FIXME . -.\" What does "come as a single unit from more privileged mount" mean? -Mounts that come as a single unit from more privileged mount are +Mounts that come as a single unit from a more privileged mount namespace are locked together and may not be separated in a less privileged mount namespace. (The @@ -1105,7 +1103,7 @@ mount points in the new namespace to either or .BR MS_PRIVATE . using a call such as the following: -.IP +.PP .in +4n .EX mount(NULL, "/", MS_SLAVE | MS_REC, NULL); @@ -1118,7 +1116,7 @@ and creating bind mounts .RB ( MS_BIND ), see .IR Documentation/filesystems/sharedsubtree.txt . -.SH EXAMPLE +.SH EXAMPLES See .BR pivot_root (2). .SH SEE ALSO @@ -1133,12 +1131,14 @@ See .BR namespaces (7), .BR user_namespaces (7), .BR findmnt (8), -.BR pivot_root (8) +.BR mount (8), +.BR pivot_root (8), +.BR umount (8) .PP .IR Documentation/filesystems/sharedsubtree.txt in the kernel source tree. .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 16e8511a5..4c88ddfa8 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 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH MQ_OVERVIEW 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME mq_overview \- overview of POSIX message queues .SH DESCRIPTION @@ -390,7 +390,7 @@ This behavioral regression was rectified in Linux 4.2 (and earlier stable kernel series), so that the count once more included just the bytes of user data in messages in the queue. -.SH EXAMPLE +.SH EXAMPLES An example of the use of various message queue functions is shown in .BR mq_notify (3). .SH SEE ALSO @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/namespaces.7 b/man7/namespaces.7 index 52766580c..bb34696c9 100644 --- a/man7/namespaces.7 +++ b/man7/namespaces.7 @@ -197,6 +197,11 @@ then the device IDs and inode numbers of their .IR /proc/[pid]/ns/xxx symbolic links will be the same; an application can check this using the .I stat.st_dev +.\" Eric Biederman: "I reserve the right for st_dev to be significant +.\" when comparing namespaces." +.\" https://lore.kernel.org/lkml/87poky5ca9.fsf@xmission.com/ +.\" Re: Documenting the ioctl interfaces to discover relationships... +.\" Date: Mon, 12 Dec 2016 11:30:38 +1300 and .I stat.st_ino fields returned by @@ -306,7 +311,12 @@ network namespaces that may be created in the user namespace. .TP .IR max_pid_namespaces The value in this file defines a per-user limit on the number of -pid namespaces that may be created in the user namespace. +PID namespaces that may be created in the user namespace. +.TP +.IR max_time_namespaces " (since Linux 5.7)" +.\" commit eeec26d5da8248ea4e240b8795bb4364213d3247 +The value in this file defines a per-user limit on the number of +time namespaces that may be created in the user namespace. .TP .IR max_user_namespaces The value in this file defines a per-user limit on the number of @@ -395,7 +405,7 @@ refers to this namespace. It is a PID namespace, and a corresponding mount of a .BR proc (5) filesystem refers to this namespace. -.SH EXAMPLE +.SH EXAMPLES See .BR clone (2) and @@ -422,7 +432,7 @@ and .BR pam_namespace (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netdevice.7 b/man7/netdevice.7 index c9011e3be..379dfa1d4 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -339,12 +339,11 @@ For configuring IP addresses, see In addition, some devices support private ioctls. These are not described here. .SH NOTES -Strictly speaking, .B SIOCGIFCONF and the other ioctls that accept or return only .B AF_INET -socket addresses, -are IP-specific and belong in +socket addresses +are IP-specific and perhaps should rather be documented in .BR ip (7). .PP The names of interfaces with no addresses or that don't have the @@ -376,7 +375,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netlink.7 b/man7/netlink.7 index 999fa5cd5..4abf78762 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -8,7 +8,7 @@ .\" Based on the original comments from Alexey Kuznetsov .\" Modified 2005-12-27 by Hasso Tepper <hasso@estpak.ee> .\" $Id: netlink.7,v 1.8 2000/06/22 13:23:00 ak Exp $ -.TH NETLINK 7 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH NETLINK 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME netlink \- communication between kernel and user space (AF_NETLINK) .SH SYNOPSIS @@ -68,15 +68,15 @@ feature), .BR NETLINK_FIREWALL was removed in Linux 3.5. .TP -.BR NETLINK_INET_DIAG " (since Linux 2.6.14)" +.BR NETLINK_SOCK_DIAG " (since Linux 3.3)" +.\" commit 7f1fb60c4fc9fb29fbb406ac8c4cfb4e59e168d6 Query information about sockets of various protocol families from the kernel (see .BR sock_diag (7)). .TP -.BR NETLINK_SOCK_DIAG " (since Linux 3.3)" -.\" commit 7f1fb60c4fc9fb29fbb406ac8c4cfb4e59e168d6 -A synonym for -.BR NETLINK_INET_DIAG . +.BR NETLINK_INET_DIAG " (since Linux 2.6.14)" +An obsolete synonym for +.BR NETLINK_SOCK_DIAG . .TP .BR NETLINK_NFLOG " (up to and including Linux 3.16)" Netfilter/iptables ULOG. @@ -103,7 +103,11 @@ Access to FIB lookup from user space. .BR NETLINK_CONNECTOR " (since Linux 2.6.14)" Kernel connector. See -.I Documentation/connector/* +.I Documentation/driver-api/connector.rst +(or +.IR /Documentation/connector/connector.* +.\" commit baa293e9544bea71361950d071579f0e4d5713ed +in kernel 5.2 and earlier) in the Linux kernel source tree for further information. .TP .BR NETLINK_NETFILTER " (since Linux 2.6.14)" @@ -482,7 +486,7 @@ or than via the low-level kernel interface. .SH BUGS This manual page is not complete. -.SH EXAMPLE +.SH EXAMPLES The following example creates a .B NETLINK_ROUTE netlink socket which will listen to the @@ -576,7 +580,7 @@ information about libnl .PP RFC 3549 "Linux Netlink as an IP Services Protocol" .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 79892806e..280a96f61 100644 --- a/man7/network_namespaces.7 +++ b/man7/network_namespaces.7 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" -.TH NETWORK_NAMESPACES 7 2018-02-02 "Linux" "Linux Programmer's Manual" +.TH NETWORK_NAMESPACES 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME network_namespaces \- overview of Linux network namespaces .SH DESCRIPTION @@ -62,7 +62,7 @@ devices that it contains are destroyed. Use of network namespaces requires a kernel that is configured with the .B CONFIG_NET_NS option. -.\" FIXME .SH EXAMPLE +.\" FIXME .SH EXAMPLES .SH SEE ALSO .BR nsenter (1), .BR unshare (1), @@ -80,7 +80,7 @@ option. .BR iptables (8), .BR ovs-vsctl (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/nptl.7 b/man7/nptl.7 index a71d642e9..ff61f710e 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/numa.7 b/man7/numa.7 index 3dfe086fa..3c5deee23 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/operator.7 b/man7/operator.7 index 5e4d353c0..fc9f6369c 100644 --- a/man7/operator.7 +++ b/man7/operator.7 @@ -75,7 +75,7 @@ The ++ and \-\- operators at this precedence level are the prefix flavors of the operators. .PD .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/packet.7 b/man7/packet.7 index 3a5adefc2..831b7644b 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -656,7 +656,7 @@ contains example source code for all available versions of and .BR PACKET_TX_RING . .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 a82a68fc3..78357f27f 100644 --- a/man7/path_resolution.7 +++ b/man7/path_resolution.7 @@ -278,7 +278,7 @@ on directories, and read permission on ordinary files. .BR credentials (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 1e2962c5f..f596e5b3f 100644 --- a/man7/persistent-keyring.7 +++ b/man7/persistent-keyring.7 @@ -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.06 of the Linux +This page is part of release 5.07 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 b4053845c..47f54474e 100644 --- a/man7/pid_namespaces.7 +++ b/man7/pid_namespaces.7 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" -.TH PID_NAMESPACES 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PID_NAMESPACES 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pid_namespaces \- overview of Linux PID namespaces .SH DESCRIPTION @@ -362,7 +362,9 @@ when a process wants to discover its PID in other namespaces. .TP .BR /proc/sys/kernel/ns_last_pid " (since Linux 3.3)" .\" commit b8f566b04d3cddd192cfd2418ae6d54ac6353792 -This file displays the last PID that was allocated in this PID namespace. +This file +(which is virtualized per PID namespace) +displays the last PID that was allocated in this PID namespace. When the next PID is allocated, the kernel will search for the lowest unallocated PID that is greater than this value, @@ -370,7 +372,7 @@ and when this file is subsequently read it will show that PID. .IP This file is writable by a process that has the .B CAP_SYS_ADMIN -capability inside its user namespace. +capability inside the user namespace that owns the PID namespace. .\" This ability is necessary to support checkpoint restore in user-space This makes it possible to determine the PID that is allocated to the next process that is created inside this PID namespace. @@ -387,7 +389,7 @@ it is translated into the corresponding PID value in the receiving process's PID namespace. .SH CONFORMING TO Namespaces are a Linux-specific feature. -.SH EXAMPLE +.SH EXAMPLES See .BR user_namespaces (7). .SH SEE ALSO @@ -403,7 +405,7 @@ See .BR user_namespaces (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pipe.7 b/man7/pipe.7 index 4faef526f..91c70f669 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pkeys.7 b/man7/pkeys.7 index 9b466ea1f..c7278ebbd 100644 --- a/man7/pkeys.7 +++ b/man7/pkeys.7 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PKEYS 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH PKEYS 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME pkeys \- overview of Memory Protection Keys .SH DESCRIPTION @@ -162,7 +162,7 @@ The Linux pkey system calls are available only if the kernel was configured and built with the .BR CONFIG_X86_INTEL_MEMORY_PROTECTION_KEYS option. -.SH EXAMPLE +.SH EXAMPLES .PP The program below allocates a page of memory with read and write permissions. It then writes some data to the memory and successfully reads it @@ -295,7 +295,7 @@ main(void) .BR pkey_mprotect (2), .BR sigaction (2) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index d806c98b9..6292fb381 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.06 of the Linux +This page is part of release 5.07 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 30a62a3f0..5a30d1796 100644 --- a/man7/process-keyring.7 +++ b/man7/process-keyring.7 @@ -60,7 +60,7 @@ results. .BR user\-keyring (7), .BR user\-session\-keyring (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pthreads.7 b/man7/pthreads.7 index da2ae7926..8f39afa05 100644 --- a/man7/pthreads.7 +++ b/man7/pthreads.7 @@ -949,7 +949,7 @@ Various Pthreads manual pages, for example: and .BR pthread_testcancel (3) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pty.7 b/man7/pty.7 index d0d602f46..3e5694b88 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/random.7 b/man7/random.7 index ae3156d17..0b625f592 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/raw.7 b/man7/raw.7 index ba69e85a0..aa6bca81d 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/regex.7 b/man7/regex.7 index a6d025e97..a66fa9c3f 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.06 of the Linux +This page is part of release 5.07 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 dd6af4bdd..a49b7c571 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -25,7 +25,7 @@ .\" .\" 2009-01-12, mtk, Created .\" -.TH RTLD-AUDIT 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH RTLD-AUDIT 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME rtld-audit \- auditing API for the dynamic linker .SH SYNOPSIS @@ -500,7 +500,7 @@ This is reportedly fixed in glibc 2.10. .\" My simple tests on Solaris work okay, but not on Linux -- mtk, Jan 2009 .\" glibc bug filed: http://sourceware.org/bugzilla/show_bug.cgi?id=9733 .\" Reportedly, this is fixed on 16 Mar 2009 (i.e., for glibc 2.10) -.SH EXAMPLE +.SH EXAMPLES .EX #include <link.h> #include <stdio.h> @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index f05994bcd..cea40e00f 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -12,7 +12,7 @@ .\" help from Matthew Wilcox. .\" $Id: rtnetlink.7,v 1.8 2000/01/22 01:55:04 freitag Exp $ .\" -.TH RTNETLINK 7 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH RTNETLINK 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME rtnetlink \- Linux IPv4 routing socket .SH SYNOPSIS @@ -94,18 +94,18 @@ tab(:); c s s l l l. Routing attributes -rta_type:value type:description +rta_type:Value type:Description _ -IFLA_UNSPEC:-:unspecified. +IFLA_UNSPEC:-:unspecified IFLA_ADDRESS:hardware address:interface L2 address -IFLA_BROADCAST:hardware address:L2 broadcast address. -IFLA_IFNAME:asciiz string:Device name. -IFLA_MTU:unsigned int:MTU of the device. -IFLA_LINK:int:Link type. -IFLA_QDISC:asciiz string:Queueing discipline. +IFLA_BROADCAST:hardware address:L2 broadcast address +IFLA_IFNAME:asciiz string:Device name +IFLA_MTU:unsigned int:MTU of the device +IFLA_LINK:int:Link type +IFLA_QDISC:asciiz string:Queueing discipline IFLA_STATS:T{ see below -T}:Interface Statistics. +T}:Interface Statistics .TE .PP The value type for @@ -161,15 +161,15 @@ tab(:); c s s l l l. Attributes -rta_type:value type:description +rta_type:Value type:Description _ -IFA_UNSPEC:-:unspecified. +IFA_UNSPEC:-:unspecified IFA_ADDRESS:raw protocol address:interface address IFA_LOCAL:raw protocol address:local address IFA_LABEL:asciiz string:name of the interface -IFA_BROADCAST:raw protocol address:broadcast address. +IFA_BROADCAST:raw protocol address:broadcast address IFA_ANYCAST:raw protocol address:anycast address -IFA_CACHEINFO:struct ifa_cacheinfo:Address information. +IFA_CACHEINFO:struct ifa_cacheinfo:Address information .TE .\" FIXME Document struct ifa_cacheinfo .TP @@ -199,8 +199,8 @@ struct rtmsg { unsigned char rtm_dst_len; /* Length of destination */ unsigned char rtm_src_len; /* Length of source */ unsigned char rtm_tos; /* TOS filter */ - - unsigned char rtm_table; /* Routing table ID */ + unsigned char rtm_table; /* Routing table ID; + see RTA_TABLE below */ unsigned char rtm_protocol; /* Routing protocol; see below */ unsigned char rtm_scope; /* See below */ unsigned char rtm_type; /* See below */ @@ -235,7 +235,7 @@ T} .TS tab(:); l l. -rtm_protocol:Route origin. +rtm_protocol:Route origin _ RTPROT_UNSPEC:unknown RTPROT_REDIRECT:T{ @@ -308,24 +308,107 @@ and .TS tab(:); c s s -l l l. +l2 l2 l. Attributes -rta_type:value type:description +rta_type:Value type:Description _ -RTA_UNSPEC:-:ignored. -RTA_DST:protocol address:Route destination address. -RTA_SRC:protocol address:Route source address. -RTA_IIF:int:Input interface index. -RTA_OIF:int:Output interface index. +RTA_UNSPEC:-:ignored +RTA_DST:protocol address:Route destination address +RTA_SRC:protocol address:Route source address +RTA_IIF:int:Input interface index +RTA_OIF:int:Output interface index RTA_GATEWAY:protocol address:The gateway of the route -RTA_PRIORITY:int:Priority of route. -RTA_PREFSRC:: +RTA_PRIORITY:int:Priority of route +RTA_PREFSRC:protocol address:Preferred source address RTA_METRICS:int:Route metric -RTA_MULTIPATH:: -RTA_PROTOINFO:: -RTA_FLOW:: -RTA_CACHEINFO:: +RTA_MULTIPATH::T{ +Multipath nexthop data +br +(see below). +T} +RTA_PROTOINFO::No longer used +RTA_FLOW:int:Route realm +RTA_CACHEINFO:struct rta_cacheinfo:(see linux/rtnetlink.h) +RTA_SESSION::No longer used +RTA_MP_ALGO::No longer used +RTA_TABLE:int:T{ +Routing table ID; if set, +.br +rtm_table is ignored +T} +RTA_MARK:int: +RTA_MFC_STATS:struct rta_mfc_stats:(see linux/rtnetlink.h) +RTA_VIA:struct rtvia:T{ +Gateway in different AF +(see below) +T} +RTA_NEWDST:protocol address:T{ +Change packet +destination address +T} +RTA_PREF:char:T{ +RFC4191 IPv6 router +preference (see below) +T} +RTA_ENCAP_TYPE:short:T{ +Encapsulation type for +.br +lwtunnels (see below) +T} +RTA_ENCAP::Defined by RTA_ENCAP_TYPE +RTA_EXPIRES:int:T{ +Expire time for IPv6 +routes (in seconds) +T} .TE +.PP +.I RTA_MULTIPATH +contains several packed instances of +.I struct rtnexthop +together with nested RTAs +.RB ( RTA_GATEWAY ): +.PP +.in +4n +.EX +struct rtnexthop { + unsigned short rtnh_len; /* Length of struct + length + of RTAs */ + unsigned char rtnh_flags; /* Flags (see linux/rtnetlink.h) */ + unsigned char rtnh_hops; /* Nexthop priority */ + int rtnh_ifindex; /* Interface index for this + nexthop */ +} +.EE +.in +.PP +There exist a bunch of RTNH_* macros similar to RTA_* and NLHDR_* macros +useful to handle these structures. +.PP +.nf +.in +4n +.EX +struct rtvia { + unsigned short rtvia_family; + unsigned char rtvia_addr[0]; +}; +.EE +.in +.PP +.I rtvia_addr +is the address, +.I rtvia_family +is its family type. +.PP +.I RTA_PREF +may contain values ICMPV6_ROUTER_PREF_LOW, +ICMPV6_ROUTER_PREF_MEDIUM and +ICMPV6_ROUTER_PREF_HIGH defined in <linux/icmpv6.h> +.PP +.I RTA_ENCAP_TYPE +may contain values +LWTUNNEL_ENCAP_MPLS, LWTUNNEL_ENCAP_IP, +LWTUNNEL_ENCAP_ILA or LWTUNNEL_ENCAP_IP6 +defined in <linux/lwtunnel.h>. .sp 1 .B Fill these values in! .TP @@ -391,7 +474,7 @@ l l. NDA_UNSPEC:unknown type NDA_DST:a neighbor cache n/w layer destination address NDA_LLADDR:a neighbor cache link layer address -NDA_CACHEINFO:cache statistics. +NDA_CACHEINFO:cache statistics .TE .sp 1 If the @@ -428,14 +511,14 @@ tab(:); c s s l2 l2 l. Attributes -rta_type:value type:Description +rta_type:Value type:Description _ TCA_UNSPEC:-:unspecified TCA_KIND:asciiz string:Name of queueing discipline TCA_OPTIONS:byte sequence:Qdisc-specific options follow -TCA_STATS:struct tc_stats:Qdisc statistics. -TCA_XSTATS:qdisc-specific:Module-specific statistics. -TCA_RATE:struct tc_estimator:Rate limit. +TCA_STATS:struct tc_stats:Qdisc statistics +TCA_XSTATS:qdisc-specific:Module-specific statistics +TCA_RATE:struct tc_estimator:Rate limit .TE .sp 1 In addition, various other qdisc-module-specific attributes are allowed. @@ -463,7 +546,7 @@ This manual page is incomplete. .BR ip (7), .BR netlink (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sched.7 b/man7/sched.7 index ddd65d6af..b5ef76898 100644 --- a/man7/sched.7 +++ b/man7/sched.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.06 of the Linux +This page is part of release 5.07 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 939ee3d3b..f4ae63455 100644 --- a/man7/sem_overview.7 +++ b/man7/sem_overview.7 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_OVERVIEW 7 2017-05-03 "Linux" "Linux Programmer's Manual" +.TH SEM_OVERVIEW 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sem_overview \- overview of POSIX semaphores .SH DESCRIPTION @@ -144,7 +144,7 @@ POSIX semaphores provide a simpler, and better designed interface than System V semaphores; on the other hand POSIX semaphores are less widely available (especially on older systems) than System V semaphores. -.SH EXAMPLE +.SH EXAMPLES An example of the use of various POSIX semaphore functions is shown in .BR sem_wait (3). .SH SEE ALSO @@ -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.06 of the Linux +This page is part of release 5.07 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 631a96c30..a1f227dec 100644 --- a/man7/session-keyring.7 +++ b/man7/session-keyring.7 @@ -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.06 of the Linux +This page is part of release 5.07 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 55c1dd879..ea99cffab 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sigevent.7 b/man7/sigevent.7 index 450f1fcf7..601b4a4e8 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.06 of the Linux +This page is part of release 5.07 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 bd1db7e38..824842c78 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 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH SIGNAL-SAFETY 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME signal-safety \- async-signal-safe functions .SH DESCRIPTION @@ -93,7 +93,7 @@ the table details changes in the subsequent standards. lb lb l l. Function Notes -\fBabort\fP(3) Added in POSIX.1-2003 +\fBabort\fP(3) Added in POSIX.1-2001 TC1 \fBaccept\fP(2) \fBaccess\fP(2) \fBaio_error\fP(3) @@ -121,7 +121,7 @@ Function Notes \fB_exit\fP(2) \fB_Exit\fP(2) \fBfaccessat\fP(2) Added in POSIX.1-2008 -\fBfchdir\fP(2) Added in POSIX.1-2013 +\fBfchdir\fP(2) Added in POSIX.1-2008 TC1 \fBfchmod\fP(2) \fBfchmodat\fP(2) Added in POSIX.1-2008 \fBfchown\fP(2) @@ -129,7 +129,7 @@ Function Notes \fBfcntl\fP(2) \fBfdatasync\fP(2) \fBfexecve\fP(3) Added in POSIX.1-2008 -\fBffs\fP(3) Added in POSIX.1-2016 +\fBffs\fP(3) Added in POSIX.1-2008 TC2 \fBfork\fP(2) See notes below \fBfstat\fP(2) \fBfstatat\fP(2) Added in POSIX.1-2008 @@ -147,29 +147,29 @@ Function Notes \fBgetsockname\fP(2) \fBgetsockopt\fP(2) \fBgetuid\fP(2) -\fBhtonl\fP(3) Added in POSIX.1-2016 -\fBhtons\fP(3) Added in POSIX.1-2016 +\fBhtonl\fP(3) Added in POSIX.1-2008 TC2 +\fBhtons\fP(3) Added in POSIX.1-2008 TC2 \fBkill\fP(2) \fBlink\fP(2) \fBlinkat\fP(2) Added in POSIX.1-2008 \fBlisten\fP(2) -\fBlongjmp\fP(3) Added in POSIX.1-2016; see notes below +\fBlongjmp\fP(3) Added in POSIX.1-2008 TC2; see notes below \fBlseek\fP(2) \fBlstat\fP(2) -\fBmemccpy\fP(3) Added in POSIX.1-2016 -\fBmemchr\fP(3) Added in POSIX.1-2016 -\fBmemcmp\fP(3) Added in POSIX.1-2016 -\fBmemcpy\fP(3) Added in POSIX.1-2016 -\fBmemmove\fP(3) Added in POSIX.1-2016 -\fBmemset\fP(3) Added in POSIX.1-2016 +\fBmemccpy\fP(3) Added in POSIX.1-2008 TC2 +\fBmemchr\fP(3) Added in POSIX.1-2008 TC2 +\fBmemcmp\fP(3) Added in POSIX.1-2008 TC2 +\fBmemcpy\fP(3) Added in POSIX.1-2008 TC2 +\fBmemmove\fP(3) Added in POSIX.1-2008 TC2 +\fBmemset\fP(3) Added in POSIX.1-2008 TC2 \fBmkdir\fP(2) \fBmkdirat\fP(2) Added in POSIX.1-2008 \fBmkfifo\fP(3) \fBmkfifoat\fP(3) Added in POSIX.1-2008 \fBmknod\fP(2) Added in POSIX.1-2008 \fBmknodat\fP(2) Added in POSIX.1-2008 -\fBntohl\fP(3) Added in POSIX.1-2016 -\fBntohs\fP(3) Added in POSIX.1-2016 +\fBntohl\fP(3) Added in POSIX.1-2008 TC2 +\fBntohs\fP(3) Added in POSIX.1-2008 TC2 \fBopen\fP(2) \fBopenat\fP(2) Added in POSIX.1-2008 \fBpause\fP(2) @@ -177,9 +177,9 @@ Function Notes \fBpoll\fP(2) \fBposix_trace_event\fP(3) \fBpselect\fP(2) -\fBpthread_kill\fP(3) Added in POSIX.1-2013 -\fBpthread_self\fP(3) Added in POSIX.1-2013 -\fBpthread_sigmask\fP(3) Added in POSIX.1-2013 +\fBpthread_kill\fP(3) Added in POSIX.1-2008 TC1 +\fBpthread_self\fP(3) Added in POSIX.1-2008 TC1 +\fBpthread_sigmask\fP(3) Added in POSIX.1-2008 TC1 \fBraise\fP(3) \fBread\fP(2) \fBreadlink\fP(2) @@ -207,7 +207,7 @@ Function Notes \fBsigemptyset\fP(3) \fBsigfillset\fP(3) \fBsigismember\fP(3) -\fBsiglongjmp\fP(3) Added in POSIX.1-2016; see notes below +\fBsiglongjmp\fP(3) Added in POSIX.1-2008 TC2; see notes below \fBsignal\fP(2) \fBsigpause\fP(3) \fBsigpending\fP(2) @@ -216,27 +216,27 @@ Function Notes \fBsigset\fP(3) \fBsigsuspend\fP(2) \fBsleep\fP(3) -\fBsockatmark\fP(3) Added in POSIX.1-2004 +\fBsockatmark\fP(3) Added in POSIX.1-2001 TC2 \fBsocket\fP(2) \fBsocketpair\fP(2) \fBstat\fP(2) -\fBstpcpy\fP(3) Added in POSIX.1-2016 -\fBstpncpy\fP(3) Added in POSIX.1-2016 -\fBstrcat\fP(3) Added in POSIX.1-2016 -\fBstrchr\fP(3) Added in POSIX.1-2016 -\fBstrcmp\fP(3) Added in POSIX.1-2016 -\fBstrcpy\fP(3) Added in POSIX.1-2016 -\fBstrcspn\fP(3) Added in POSIX.1-2016 -\fBstrlen\fP(3) Added in POSIX.1-2016 -\fBstrncat\fP(3) Added in POSIX.1-2016 -\fBstrncmp\fP(3) Added in POSIX.1-2016 -\fBstrncpy\fP(3) Added in POSIX.1-2016 -\fBstrnlen\fP(3) Added in POSIX.1-2016 -\fBstrpbrk\fP(3) Added in POSIX.1-2016 -\fBstrrchr\fP(3) Added in POSIX.1-2016 -\fBstrspn\fP(3) Added in POSIX.1-2016 -\fBstrstr\fP(3) Added in POSIX.1-2016 -\fBstrtok_r\fP(3) Added in POSIX.1-2016 +\fBstpcpy\fP(3) Added in POSIX.1-2008 TC2 +\fBstpncpy\fP(3) Added in POSIX.1-2008 TC2 +\fBstrcat\fP(3) Added in POSIX.1-2008 TC2 +\fBstrchr\fP(3) Added in POSIX.1-2008 TC2 +\fBstrcmp\fP(3) Added in POSIX.1-2008 TC2 +\fBstrcpy\fP(3) Added in POSIX.1-2008 TC2 +\fBstrcspn\fP(3) Added in POSIX.1-2008 TC2 +\fBstrlen\fP(3) Added in POSIX.1-2008 TC2 +\fBstrncat\fP(3) Added in POSIX.1-2008 TC2 +\fBstrncmp\fP(3) Added in POSIX.1-2008 TC2 +\fBstrncpy\fP(3) Added in POSIX.1-2008 TC2 +\fBstrnlen\fP(3) Added in POSIX.1-2008 TC2 +\fBstrpbrk\fP(3) Added in POSIX.1-2008 TC2 +\fBstrrchr\fP(3) Added in POSIX.1-2008 TC2 +\fBstrspn\fP(3) Added in POSIX.1-2008 TC2 +\fBstrstr\fP(3) Added in POSIX.1-2008 TC2 +\fBstrtok_r\fP(3) Added in POSIX.1-2008 TC2 \fBsymlink\fP(2) \fBsymlinkat\fP(2) Added in POSIX.1-2008 \fBtcdrain\fP(3) @@ -261,34 +261,34 @@ Function Notes \fButimes\fP(2) Added in POSIX.1-2008 \fBwait\fP(2) \fBwaitpid\fP(2) -\fBwcpcpy\fP(3) Added in POSIX.1-2016 -\fBwcpncpy\fP(3) Added in POSIX.1-2016 -\fBwcscat\fP(3) Added in POSIX.1-2016 -\fBwcschr\fP(3) Added in POSIX.1-2016 -\fBwcscmp\fP(3) Added in POSIX.1-2016 -\fBwcscpy\fP(3) Added in POSIX.1-2016 -\fBwcscspn\fP(3) Added in POSIX.1-2016 -\fBwcslen\fP(3) Added in POSIX.1-2016 -\fBwcsncat\fP(3) Added in POSIX.1-2016 -\fBwcsncmp\fP(3) Added in POSIX.1-2016 -\fBwcsncpy\fP(3) Added in POSIX.1-2016 -\fBwcsnlen\fP(3) Added in POSIX.1-2016 -\fBwcspbrk\fP(3) Added in POSIX.1-2016 -\fBwcsrchr\fP(3) Added in POSIX.1-2016 -\fBwcsspn\fP(3) Added in POSIX.1-2016 -\fBwcsstr\fP(3) Added in POSIX.1-2016 -\fBwcstok\fP(3) Added in POSIX.1-2016 -\fBwmemchr\fP(3) Added in POSIX.1-2016 -\fBwmemcmp\fP(3) Added in POSIX.1-2016 -\fBwmemcpy\fP(3) Added in POSIX.1-2016 -\fBwmemmove\fP(3) Added in POSIX.1-2016 -\fBwmemset\fP(3) Added in POSIX.1-2016 +\fBwcpcpy\fP(3) Added in POSIX.1-2008 TC2 +\fBwcpncpy\fP(3) Added in POSIX.1-2008 TC2 +\fBwcscat\fP(3) Added in POSIX.1-2008 TC2 +\fBwcschr\fP(3) Added in POSIX.1-2008 TC2 +\fBwcscmp\fP(3) Added in POSIX.1-2008 TC2 +\fBwcscpy\fP(3) Added in POSIX.1-2008 TC2 +\fBwcscspn\fP(3) Added in POSIX.1-2008 TC2 +\fBwcslen\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsncat\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsncmp\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsncpy\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsnlen\fP(3) Added in POSIX.1-2008 TC2 +\fBwcspbrk\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsrchr\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsspn\fP(3) Added in POSIX.1-2008 TC2 +\fBwcsstr\fP(3) Added in POSIX.1-2008 TC2 +\fBwcstok\fP(3) Added in POSIX.1-2008 TC2 +\fBwmemchr\fP(3) Added in POSIX.1-2008 TC2 +\fBwmemcmp\fP(3) Added in POSIX.1-2008 TC2 +\fBwmemcpy\fP(3) Added in POSIX.1-2008 TC2 +\fBwmemmove\fP(3) Added in POSIX.1-2008 TC2 +\fBwmemset\fP(3) Added in POSIX.1-2008 TC2 \fBwrite\fP(2) .TE .sp 1 Notes: .IP * 3 -POSIX.1-2001 and POSIX.1-2004 required the functions +POSIX.1-2001 and POSIX.1-2001 TC2 required the functions .BR fpathconf (3), .BR pathconf (3), and @@ -303,7 +303,7 @@ or and the program subsequently calls an unsafe function, then the behavior of the program is undefined. .IP * -POSIX.1-2003 clarified +POSIX.1-2001 TC1 clarified that if an application calls .BR fork (2) from a signal handler and any of the fork handlers registered by @@ -345,7 +345,7 @@ internally. .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/signal.7 b/man7/signal.7 index 89721008b..3f488a3b2 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -216,6 +216,24 @@ or .PP A process-directed signal may be delivered to any one of the threads that does not currently have the signal blocked. +.\" Joseph C. Sible notes: +.\" On Linux, if the main thread has the signal unblocked, then the kernel +.\" will always deliver the signal there, citing this kernel code +.\" +.\" Per this comment in kernel/signal.c since time immemorial: +.\" +.\" /* +.\" * Now find a thread we can wake up to take the signal off the queue. +.\" * +.\" * If the main thread wants the signal, it gets first crack. +.\" * Probably the least surprising to the average bear. +.\" */ +.\" +.\" But this does not mean the signal will be delivered only in the +.\" main thread, since if a handler is already executing in the main thread +.\" (and thus the signal is blocked in that thread), then a further +.\" might be delivered in a different thread. +.\" If more than one of the threads has the signal unblocked, then the kernel chooses an arbitrary thread to which to deliver the signal. .PP @@ -261,8 +279,8 @@ SIGKILL P1990 Term Kill signal SIGLOST \- Term File lock lost (unused) SIGPIPE P1990 Term Broken pipe: write to pipe with no readers; see \fBpipe\fP(7) -SIGPOLL P2001 Term Pollable event (Sys V). - Synonym for \fBSIGIO\fP +SIGPOLL P2001 Term Pollable event (Sys V); + synonym for \fBSIGIO\fP SIGPROF P2001 Term Profiling timer expired SIGPWR \- Term Power failure (System V) SIGQUIT P1990 Core Quit from keyboard @@ -796,6 +814,32 @@ Linux 2.4 and earlier: .BR nanosleep (2). .SH CONFORMING TO POSIX.1, except as noted. +.SH NOTES +For a discussion of async-signal-safe functions, see +.BR signal-safety (7). +.PP +The +.I /proc/[pid]/task/[tid]/status +file contains various fields that show the signals +that a thread is blocking +.RI ( SigBlk ), +catching +.RI ( SigCgt ), +or ignoring +.RI ( SigIgn ). +(The set of signals that are caught or ignored will be the same +across all threads in a process.) +Other fields show the set of pending signals that are directed to the thread +.RI ( SigPnd ) +as well as the set of pending signals that are directed +to the process as a whole +.RI ( ShdPnd ). +The corresponding fields in +.I /proc/[pid]/status +show the information for the main thread. +See +.BR proc (5) +for further details. .SH BUGS There are six signals that can be delivered as a consequence of a hardware exception: @@ -826,40 +870,14 @@ even though .B SIGILL would make more sense, because of how the CPU reports the forbidden operation to the kernel. -.SH NOTES -For a discussion of async-signal-safe functions, see -.BR signal-safety (7). -.PP -The -.I /proc/[pid]/task/[tid]/status -file contains various fields that show the signals -that a thread is blocking -.RI ( SigBlk ), -catching -.RI ( SigCgt ), -or ignoring -.RI ( SigIgn ). -(The set of signals that are caught or ignored will be the same -across all threads in a process.) -Other fields show the set of pending signals that are directed to the thread -.RI ( SigPnd ) -as well as the set of pending signals that are directed -to the process as a whole -.RI ( ShdPnd ). -The corresponding fields in -.I /proc/[pid]/status -show the information for the main thread. -See -.BR proc (5) -for further details. .SH SEE ALSO .BR kill (1), .BR clone (2), .BR getrlimit (2), .BR kill (2), +.BR pidfd_send_signal (2), .BR restart_syscall (2), .BR rt_sigqueueinfo (2), -.BR pidfd_send_signal (2), .BR setitimer (2), .BR setrlimit (2), .BR sgetmask (2), @@ -891,7 +909,7 @@ for further details. .BR pthreads (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 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 bacdfaad9..d333cabb0 100644 --- a/man7/sock_diag.7 +++ b/man7/sock_diag.7 @@ -21,7 +21,7 @@ .\" License along with this manual; if not, see .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END -.TH SOCK_DIAG 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SOCK_DIAG 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME sock_diag \- obtaining information about sockets .SH SYNOPSIS @@ -637,7 +637,7 @@ and were introduced in Linux 3.6. .SH CONFORMING TO The NETLINK_SOCK_DIAG API is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES The following example program prints inode number, peer's inode number, and name of all UNIX domain sockets in the current namespace. .PP @@ -841,7 +841,7 @@ main(void) .BR netlink (7), .BR tcp (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/socket.7 b/man7/socket.7 index cc266b825..d778fafa2 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -757,7 +757,7 @@ is changeable only since Linux 2.4. .IP Before Linux 2.6.28 -.\" commit c7004482e8dcb7c3c72666395cfa98a216a4fb70 +.\" Tested on kernel 2.6.14 -- mtk, 30 Nov 05 .BR select (2), .BR poll (2), and @@ -770,8 +770,15 @@ was available. A subsequent read from the socket would then block until .B SO_RCVLOWAT bytes are available. -.\" See http://marc.theaimsgroup.com/?l=linux-kernel&m=111049368106984&w=2 -.\" Tested on kernel 2.6.14 -- mtk, 30 Nov 05 +Since Linux 2.6.28, +.\" commit c7004482e8dcb7c3c72666395cfa98a216a4fb70 +.BR select (2), +.BR poll (2), +and +.BR epoll (7) +indicate a socket as readable only if at least +.B SO_RCVLOWAT +bytes are available. .TP .BR SO_RCVTIMEO " and " SO_SNDTIMEO .\" Not implemented in 2.0. @@ -1226,7 +1233,7 @@ program is designed to always set this option. .BR unix (7), .BR tcpdump (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/spufs.7 b/man7/spufs.7 index 26c61f8cf..1f1d9d343 100644 --- a/man7/spufs.7 +++ b/man7/spufs.7 @@ -24,7 +24,7 @@ .\" 2007-07-10, quite a lot of polishing by mtk .\" 2007-09-28, updates for newer kernels by Jeremy Kerr <jk@ozlabs.org> .\" -.TH SPUFS 7 2017-09-15 Linux "Linux Programmer's Manual" +.TH SPUFS 7 2020-06-09 Linux "Linux Programmer's Manual" .SH NAME spufs \- SPU filesystem .SH DESCRIPTION @@ -756,7 +756,7 @@ Any previous value of the object ID is overwritten. Reading this file gives an ASCII hex string representing the object ID for this SPU context. .RE -.SH EXAMPLE +.SH EXAMPLES .TP .IR /etc/fstab " entry" none /spu spufs gid=spu 0 0 @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/standards.7 b/man7/standards.7 index bbd267643..2bb98970d 100644 --- a/man7/standards.7 +++ b/man7/standards.7 @@ -21,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH STANDARDS 7 2017-11-26 "Linux" "Linux Programmer's Manual" +.TH STANDARDS 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME standards \- C and UNIX Standards .SH DESCRIPTION @@ -236,10 +236,8 @@ standardized in POSIX.1-2001. .IP Two Technical Corrigenda (minor fixes and improvements) of the original 2001 standard have occurred: -TC1 in 2003 (also known as -.IR POSIX.1-2003 ), -and TC2 in 2004 (also known as -.IR POSIX.1-2004 ). +TC1 in 2003 +and TC2 in 2004. .TP .B POSIX.1-2008, SUSv4 Work on the next revision of POSIX.1/SUS was completed and @@ -267,17 +265,25 @@ lists POSIX.1-2001, it can be assumed that the interface also conforms to POSIX.1-2008, unless otherwise noted. .IP Technical Corrigendum 1 (minor fixes and improvements) -of this standard was released in 2013 -(also known as -.IR POSIX.1-2013 ). +of this standard was released in 2013. .IP -Technical Corrigendum 2 of this standard was released in 2016 -(also known as -.IR POSIX.1-2016 ). +Technical Corrigendum 2 of this standard was released in 2016. .IP Further information can be found on the Austin Group web site, .UR http://www.opengroup.org\:/austin/ .UE . +.TP +.B SUSv4 2016 edition +This is equivalent to POSIX.1-2008, with the addition of +Technical Corrigenda 1 and 2 and the XCurses specification. +.TP +.B POSIX.1-2017 +This revision of POSIX is technically identical to POSIX.1-2008 with +Technical Corrigenda 1 and 2 applied. +.TP +.B SUSv4 2018 edition +This is equivalent to POSIX.1-2017, with the addition of +the XCurses specification. .SH SEE ALSO .BR getconf (1), .BR confstr (3), @@ -288,7 +294,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/suffixes.7 b/man7/suffixes.7 index 962366a0a..a9852ca9e 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -41,7 +41,7 @@ suffixes \- list of file suffixes .SH DESCRIPTION It is customary to indicate the contents of a file with the file suffix, -which consists of a period, followed by one or more letters. +which (typically) consists of a period, followed by one or more letters. Many standard utilities, such as compilers, use this to recognize the type of file they are dealing with. The @@ -281,7 +281,7 @@ This list is not exhaustive. .BR file (1), .BR make (1) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/symlink.7 b/man7/symlink.7 index 37ff2b21b..8dac14ed0 100644 --- a/man7/symlink.7 +++ b/man7/symlink.7 @@ -34,7 +34,7 @@ .\" 2008-06-11, mtk, Taken from FreeBSD 6.2 and heavily edited for .\" specific Linux details, improved readability, and man-pages style. .\" -.TH SYMLINK 7 2016-10-08 "Linux" "Linux Programmer's Manual" +.TH SYMLINK 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME symlink \- symbolic link handling .SH DESCRIPTION @@ -183,11 +183,39 @@ are not traversing a file tree. Symbolic links encountered by utilities that are traversing a file tree (either specified on the command line or encountered as part of the file hierarchy walk). -.SS System calls +.PP +Before describing the treatment of symbolic links by system calls and commands, +we require some terminology. +Given a pathname of the form +.IR a/b/c , +the part preceding the final slash (i.e., +.IR a/b ) +is called the +.I dirname +component, and the part following the final slash (i.e., +.IR c ) +is called the +.IR basename +component. +.\" +.SS Treatment of symbolic links in system calls The first area is symbolic links used as filename arguments for system calls. .PP -Except as noted below, all system calls follow symbolic links. +The treatment of symbolic links within a pathname passed to +a system call is as follows: +.IP 1. 3 +Within the dirname component of a pathname, +symbolic links are always followed in nearly every system call. +(This is also true for commands.) +The one exception is +.BR openat2 (2), +which provides flags that can be used to explicitly +prevent following of symbolic links in the dirname component. +.IP 2. +Except as noted below, +all system calls follow symbolic links +in the basename component of a pathname. For example, if there were a symbolic link .I slink which pointed to a file named @@ -197,8 +225,9 @@ the system call would return a file descriptor referring to the file .IR afile . .PP -Various system calls do not follow links, and operate -on the symbolic link itself. +Various system calls do not follow links in +the basename component of a pathname, +and operate on the symbolic link itself. They are: .BR lchown (2), .BR lgetxattr (2), @@ -212,7 +241,8 @@ They are: and .BR unlink (2). .PP -Certain other system calls optionally follow symbolic links. +Certain other system calls optionally follow symbolic links +in the basename component of a pathname. They are: .BR faccessat (2), .\" Maybe one day: .BR fchownat (2) @@ -277,7 +307,7 @@ link instead of following the symbolic link\(emfor example, it is desired that .I "chown slink" change the ownership of the file that .I slink -is, whether it is a symbolic link or not\(emthe +is, whether it is a symbolic link or not\(emthen the .I \-h option should be used. In the above example, @@ -533,7 +563,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sysvipc.7 b/man7/sysvipc.7 index 09f589144..00309487c 100644 --- a/man7/sysvipc.7 +++ b/man7/sysvipc.7 @@ -118,7 +118,7 @@ IPC namespaces, see .BR ftok (3), .BR ipc_namespaces (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/tcp.7 b/man7/tcp.7 index 878d38d99..3da8e45e9 100644 --- a/man7/tcp.7 +++ b/man7/tcp.7 @@ -93,7 +93,7 @@ .\" commit cd8ae85299d54155702a56811b2e035e63064d3d .\" Author: Eric Dumazet <edumazet@google.com> .\" -.TH TCP 7 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH TCP 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME tcp \- TCP protocol .SH SYNOPSIS @@ -811,12 +811,18 @@ the urgent pointer: the urgent pointer points to the first byte after the urgent data. Enabling this option may lead to interoperability problems. .TP -.IR tcp_syn_retries " (integer; default: 5; since Linux 2.2)" +.IR tcp_syn_retries " (integer; default: 6; since Linux 2.2)" .\" Since 2.1.38 The maximum number of times initial SYNs for an active TCP connection attempt will be retransmitted. This value should not be higher than 255. -The default value is 5, which corresponds to approximately 180 seconds. +The default value is 6, which corresponds to retrying for up to +approximately 127 seconds. +Before Linux 3.7, +.\" commit 6c9ff979d1921e9fd05d89e1383121c2503759b9 +the default value was 5, which +(in conjunction with calculation based on other kernel parameters) +corresponded to approximately 180 seconds. .TP .IR tcp_synack_retries " (integer; default: 5; since Linux 2.2)" .\" Since 2.1.38 @@ -1387,7 +1393,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/termio.7 b/man7/termio.7 index 9e6da7321..8824a4df0 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.06 of the Linux +This page is part of release 5.07 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 2a395b353..49a4bbefb 100644 --- a/man7/thread-keyring.7 +++ b/man7/thread-keyring.7 @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/time.7 b/man7/time.7 index 65abbca39..5f7ce9ed5 100644 --- a/man7/time.7 +++ b/man7/time.7 @@ -106,7 +106,7 @@ User-space applications can determine the value of this constant using .\" .SS System and process clocks; time namespaces The kernel supports a range of clocks that measure various kinds of -elapsed and virtual (i.e., consumed CPU) time. +elapsed and virtual (i.e., consumed CPU) time. These clocks are described in .BR clock_gettime (2). A few of the clocks are settable using @@ -235,7 +235,7 @@ in .BR time_namespaces (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/time_namespaces.7 b/man7/time_namespaces.7 index 55c16913b..5ec54c912 100644 --- a/man7/time_namespaces.7 +++ b/man7/time_namespaces.7 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" -.TH TIME_NAMESPACES 7 2020-04-01 "Linux" "Linux Programmer's Manual" +.TH TIME_NAMESPACES 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME time_namespaces \- overview of Linux time namespaces .SH DESCRIPTION @@ -37,7 +37,7 @@ and a nonsettable clock that represents monotonic time since\(emas described by POSIX\(em"some unspecified point in the past". .IP \(bu -.BR CLOCK_BOOTTIME +.BR CLOCK_BOOTTIME (and likewise .BR CLOCK_BOOTTIME_ALARM ), a nonsettable clock that is identical to @@ -206,12 +206,12 @@ instead of the symbolic names show above; i.e., 1 instead of .IR monotonic , and 7 instead of .IR boottime . -However, writing +For redability, the use of the symbolic names over the numbers is preferred. .PP The motivation for adding time namespaces was to allow the monotonic and boot-time clocks to maintain consistent values during container migration and checkpoint/restore. -.SH EXAMPLE +.SH EXAMPLES .PP The following shell session demonstrates the operation of time namespaces. We begin by displaying the inode number of the time namespace @@ -360,7 +360,7 @@ CLOCK_BOOTTIME : 76633.544 (21h 19m 23s) .SH SEE ALSO .BR nsenter (1), .BR unshare (1), -.BR clock_settime (2). +.BR clock_settime (2), .\" clone3() support for time namespaces is a work in progress .\" .BR clone3 (2), .BR setns (2), @@ -368,7 +368,7 @@ CLOCK_BOOTTIME : 76633.544 (21h 19m 23s) .BR namespaces (7), .BR time (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udp.7 b/man7/udp.7 index 73e529c66..b07aa4f21 100644 --- a/man7/udp.7 +++ b/man7/udp.7 @@ -273,7 +273,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udplite.7 b/man7/udplite.7 index 3e7ef08b5..1d07d6aa2 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unicode.7 b/man7/unicode.7 index 06353172a..2631c38e6 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/units.7 b/man7/units.7 index 62b24fe05..180dac83f 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unix.7 b/man7/unix.7 index 872193828..4b008cd8e 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -17,7 +17,7 @@ .\" address that can appear in the sockaddr_un structure: pathname, .\" unnamed, and abstract. .\" -.TH UNIX 7 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH UNIX 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME unix \- sockets for local interprocess communication .SH SYNOPSIS @@ -870,7 +870,7 @@ that the applications that .I create pathname sockets follow the rules outlined above under .IR "Pathname sockets" . -.SH EXAMPLE +.SH EXAMPLES The following code demonstrates the use of sequenced-packet sockets for local interprocess communication. It consists of two programs. @@ -1152,7 +1152,7 @@ see .BR socket (7), .BR udp (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/uri.7 b/man7/uri.7 index 4637475f3..f056b5d9d 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.06 of the Linux +This page is part of release 5.07 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 45026d7a5..96b21bc14 100644 --- a/man7/user-keyring.7 +++ b/man7/user-keyring.7 @@ -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.06 of the Linux +This page is part of release 5.07 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 42583458f..681fc4280 100644 --- a/man7/user-session-keyring.7 +++ b/man7/user-session-keyring.7 @@ -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.06 of the Linux +This page is part of release 5.07 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 61c86f70a..0eeb40d35 100644 --- a/man7/user_namespaces.7 +++ b/man7/user_namespaces.7 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" -.TH USER_NAMESPACES 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH USER_NAMESPACES 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME user_namespaces \- overview of Linux user namespaces .SH DESCRIPTION @@ -148,19 +148,22 @@ the process will lose all capabilities. See the discussion of user and group ID mappings, below. .PP A call to -.BR clone (2), -.BR unshare (2), +.BR clone (2) or -.BR setns (2) +.BR unshare (2) using the .BR CLONE_NEWUSER -flag sets the "securebits" flags +flag +or a call to +.BR setns (2) +that moves the caller into another user namespace +sets the "securebits" flags (see .BR capabilities (7)) to their default values (all flags disabled) in the child (for .BR clone (2)) or caller (for -.BR unshare (2), +.BR unshare (2) or .BR setns (2)). Note that because the caller no longer has capabilities @@ -232,7 +235,7 @@ namespaces owned by (associated with) the user namespace .PP On the other hand, there are many privileged operations that affect resources that are not associated with any namespace type, -for example, changing the system time (governed by +for example, changing the system (i.e., calendar) time (governed by .BR CAP_SYS_TIME ), loading a kernel module (governed by .BR CAP_SYS_MODULE ), @@ -978,7 +981,7 @@ Linux 3.12 added support for the last of the unsupported major filesystems, .\" commit d6970d4b726cea6d7a9bc4120814f95c09571fc3 XFS. .\" -.SH EXAMPLE +.SH EXAMPLES The program below is designed to allow experimenting with user namespaces, as well as other types of namespaces. It creates namespaces as specified by command-line options and then executes @@ -1372,7 +1375,7 @@ main(int argc, char *argv[]) .BR subgid (5), \" From the shadow package .BR subuid (5), \" From the shadow package .BR capabilities (7), -.BR cgroup_namespaces (7) +.BR cgroup_namespaces (7), .BR credentials (7), .BR namespaces (7), .BR pid_namespaces (7) @@ -1380,7 +1383,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.06 of the Linux +This page is part of release 5.07 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 6eb9b376a..2b03cf278 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/uts_namespaces.7 b/man7/uts_namespaces.7 index 3a97c89c3..3133e4226 100644 --- a/man7/uts_namespaces.7 +++ b/man7/uts_namespaces.7 @@ -66,7 +66,7 @@ option. .BR unshare (2), .BR namespaces (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vdso.7 b/man7/vdso.7 index f5463c293..8dea90095 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vsock.7 b/man7/vsock.7 index 338fde58f..3b0d90a9c 100644 --- a/man7/vsock.7 +++ b/man7/vsock.7 @@ -247,7 +247,7 @@ Previous versions supported only local communication within a guest .BR socket (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/x25.7 b/man7/x25.7 index 7e9aace7c..938113ae8 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -11,7 +11,7 @@ .\" .TH X25 7 2017-09-15 "Linux" "Linux Programmer's Manual" .SH NAME -x25 \- ITU-T X.25 / ISO-8208 protocol interface. +x25 \- ITU-T X.25 / ISO-8208 protocol interface .SH SYNOPSIS .B #include <sys/socket.h> .br @@ -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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man7/xattr.7 b/man7/xattr.7 index 8ad53f44b..5fbe59197 100644 --- a/man7/xattr.7 +++ b/man7/xattr.7 @@ -25,7 +25,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH XATTR 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH XATTR 7 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME xattr \- Extended attributes .SH DESCRIPTION @@ -186,6 +186,7 @@ This page was formerly named .\" and the SGI XFS development team, .\" .RI < linux-xfs@oss.sgi.com >. .SH SEE ALSO +.BR attr (1), .BR getfattr (1), .BR setfattr (1), .BR getxattr (2), @@ -194,10 +195,10 @@ This page was formerly named .BR removexattr (2), .BR setxattr (2), .BR acl (5), -.BR capabilities (7) +.BR capabilities (7), .BR selinux (8) .SH COLOPHON -This page is part of release 5.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8 index f10eccc66..0e6f08467 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/intro.8 b/man8/intro.8 index aa4b3281f..1689c8260 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.06 of the Linux +This page is part of release 5.07 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 3a9a7837c..eb9676a1d 100644 --- a/man8/ld.so.8 +++ b/man8/ld.so.8 @@ -111,7 +111,11 @@ Thus, an application located in .I somedir/app could be compiled with .IP - gcc \-Wl,\-rpath,\(aq$ORIGIN/../lib\(aq +.in +4n +.EX +gcc \-Wl,\-rpath,\(aq$ORIGIN/../lib\(aq +.EE +.in .IP so that it finds an associated shared object in .I somedir/lib @@ -791,7 +795,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/ldconfig.8 b/man8/ldconfig.8 index 26d410a7c..836621731 100644 --- a/man8/ldconfig.8 +++ b/man8/ldconfig.8 @@ -19,7 +19,7 @@ .\" .\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com> .\" Change listed order of /usr/lib and /lib -.TH LDCONFIG 8 2020-02-09 "GNU" "Linux Programmer's Manual" +.TH LDCONFIG 8 2020-06-09 "GNU" "Linux Programmer's Manual" .SH NAME ldconfig \- configure dynamic linker run-time bindings .SH SYNOPSIS @@ -125,8 +125,12 @@ Cache format to use: .IR old , .IR new , or -.IR compat -(default). +.IR compat . +Since glibc 2.32, the default is +.IR new . +.\" commit cad64f778aced84efdaa04ae64f8737b86f063ab +Before that, it was +.IR compat . .TP .BI "\-C " cache Use @@ -212,7 +216,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/nscd.8 b/man8/nscd.8 index 1afdfb921..d71e3af48 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/sln.8 b/man8/sln.8 index e595f5e74..c39f37aac 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/tzselect.8 b/man8/tzselect.8 index 08072d257..e6da967b4 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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zdump.8 b/man8/zdump.8 index 966d1fe5b..56b6939c9 100644 --- a/man8/zdump.8 +++ b/man8/zdump.8 @@ -2,7 +2,7 @@ .\" This page is in the public domain .\" %%%LICENSE_END .\" -.TH ZDUMP 8 2019-03-06 "" "Linux System Administration" +.TH ZDUMP 8 2020-04-27 "" "Linux System Administration" .SH NAME zdump \- timezone dumper .SH SYNOPSIS @@ -78,11 +78,11 @@ implementations with different time representations. Cut off interval output at the given year(s). Cutoff times are computed using the proleptic Gregorian calendar with year 0 and with Universal Time (UT) ignoring leap seconds. -The lower bound is exclusive and the upper is inclusive; for example, a -.I loyear -of 1970 excludes a transition occurring at 1970-01-01 00:00:00 UTC but a -.I hiyear -of 1970 includes the transition. +Cutoffs are at the start of each year, where the lower-bound +timestamp is exclusive and the upper is inclusive; for example, +.B "\*-c 1970,2070" +selects transitions after 1970-01-01 00:00:00 UTC +and on or before 2070-01-01 00:00:00 UTC. The default cutoff is .BR \*-500,2500 . .TP @@ -154,15 +154,16 @@ tabbed columns line up.) .if \n(.g .ft CW .if t .in +.5i .if n .in +2 -.nr w \w'1896-01-13 'u -.ta \nwu +\nwu +\nwu +\nwu +.nr w \w'1896-01-13 'u+\n(.i +.ta \w'1896-01-13 'u +\w'12:01:26 'u +\w'-103126 'u +\w'HWT 'u TZ="Pacific/Honolulu" -- - -10:31:26 LMT -1896-01-13 12:01:26 -10:30 HST -1933-04-30 03 -09:30 HDT 1 -1933-05-21 11 -10:30 HST -1942-02-09 03 -09:30 HDT 1 -1945-09-30 01 -10:30 HST +- - -103126 LMT +1896-01-13 12:01:26 -1030 HST +1933-04-30 03 -0930 HDT 1 +1933-05-21 11 -1030 HST +1942-02-09 03 -0930 HWT 1 +1945-08-14 13:30 -0930 HPT 1 +1945-09-30 01 -1030 HST 1947-06-08 02:30 -10 HST .in .if \n(.g .ft @@ -187,7 +188,7 @@ Here are excerpts from another example: .if t .in +.5i .if n .in +2 TZ="Europe/Astrakhan" -- - +03:12:12 LMT +- - +031212 LMT 1924-04-30 23:47:48 +03 1930-06-21 01 +04 1981-04-01 01 +05 1 @@ -230,7 +231,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.06 of the Linux +This page is part of release 5.07 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zic.8 b/man8/zic.8 index d54f4b865..d90a03829 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.06 of the Linux +This page is part of release 5.07 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 0a6ec46fd..96d70a3b3 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|2020-04-11 +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|2020-06-09 diff --git a/proj.man-pages.pages b/proj.man-pages.pages index 559ef3855..b5628e038 100644 --- a/proj.man-pages.pages +++ b/proj.man-pages.pages @@ -1,2396 +1,2397 @@ -man1/sprof.1 -man1/memusage.1 -man1/ldd.1 -man1/localedef.1 -man1/time.1 -man1/mtrace.1 +man1/memusagestat.1 man1/intro.1 man1/pldd.1 +man1/time.1 +man1/iconv.1 man1/getent.1 -man1/memusagestat.1 +man1/localedef.1 +man1/memusage.1 man1/locale.1 -man1/iconv.1 -man2/stat.2 -man2/set_robust_list.2 +man1/ldd.1 +man1/sprof.1 +man1/mtrace.1 +man2/vserver.2 +man2/rt_sigtimedwait.2 +man2/epoll_pwait.2 +man2/init_module.2 +man2/shmat.2 +man2/perf_event_open.2 +man2/get_robust_list.2 +man2/times.2 +man2/linkat.2 +man2/sched_setattr.2 +man2/sigreturn.2 +man2/perfmonctl.2 +man2/epoll_ctl.2 +man2/add_key.2 +man2/timerfd_gettime.2 +man2/fdetach.2 +man2/alloc_hugepages.2 +man2/getsid.2 +man2/getpagesize.2 +man2/isastream.2 +man2/semget.2 +man2/setfsuid.2 +man2/setuid32.2 +man2/getpgid.2 +man2/mprotect.2 +man2/sched_setaffinity.2 +man2/chroot.2 +man2/rmdir.2 +man2/pread64.2 +man2/rt_tgsigqueueinfo.2 man2/getcpu.2 -man2/vhangup.2 +man2/ioctl_fideduperange.2 +man2/lookup_dcookie.2 +man2/getdents.2 +man2/fadvise64.2 +man2/getgroups32.2 +man2/setup.2 +man2/io_getevents.2 +man2/setfsgid32.2 +man2/getpeername.2 +man2/truncate64.2 +man2/_syscall.2 +man2/break.2 +man2/sigaltstack.2 +man2/fanotify_init.2 +man2/ioperm.2 +man2/munmap.2 +man2/getpmsg.2 +man2/unlinkat.2 +man2/mq_unlink.2 +man2/readlinkat.2 +man2/signalfd4.2 +man2/readv.2 +man2/clock_adjtime.2 +man2/sbrk.2 +man2/setxattr.2 +man2/madvise1.2 +man2/getegid32.2 +man2/signalfd.2 +man2/inl.2 +man2/pciconfig_iobase.2 +man2/rt_sigsuspend.2 +man2/setgid.2 +man2/shmop.2 +man2/pidfd_send_signal.2 man2/removexattr.2 -man2/rename.2 -man2/getdomainname.2 -man2/sched_getparam.2 -man2/timerfd_gettime.2 -man2/init_module.2 -man2/gettimeofday.2 -man2/sigsuspend.2 -man2/madvise.2 -man2/ioctl_ns.2 -man2/pkey_alloc.2 -man2/timer_getoverrun.2 -man2/waitpid.2 -man2/mq_notify.2 +man2/getdents64.2 +man2/setpgrp.2 +man2/mount.2 +man2/ftruncate.2 +man2/pselect.2 +man2/mknodat.2 +man2/msgctl.2 +man2/utimes.2 +man2/free_hugepages.2 +man2/chown32.2 +man2/preadv.2 +man2/select.2 man2/pkey_free.2 -man2/setfsuid32.2 -man2/truncate.2 -man2/msync.2 -man2/setgroups32.2 -man2/adjtimex.2 -man2/sysfs.2 -man2/ssetmask.2 -man2/ftruncate64.2 -man2/setgid.2 -man2/socketcall.2 -man2/dup2.2 -man2/getsockname.2 -man2/chmod.2 -man2/eventfd.2 -man2/setgroups.2 -man2/time.2 -man2/quotactl.2 -man2/chown.2 +man2/seteuid.2 man2/pselect6.2 -man2/getegid.2 -man2/rt_sigaction.2 -man2/munmap.2 -man2/fstat64.2 -man2/utime.2 -man2/preadv.2 -man2/ptrace.2 -man2/_Exit.2 -man2/pwrite64.2 +man2/eventfd2.2 +man2/sched_getaffinity.2 man2/setresuid.2 -man2/statfs.2 -man2/faccessat.2 -man2/unshare.2 -man2/wait4.2 -man2/outl.2 -man2/symlink.2 -man2/mq_unlink.2 -man2/capset.2 -man2/pciconfig_write.2 -man2/writev.2 -man2/accept4.2 -man2/bind.2 -man2/fstatfs.2 -man2/send.2 -man2/sendto.2 -man2/renameat.2 +man2/exit.2 man2/spu_run.2 -man2/sched_getscheduler.2 -man2/vm86old.2 -man2/getdents.2 -man2/vm86.2 -man2/times.2 -man2/setgid32.2 -man2/setpgrp.2 +man2/inl_p.2 +man2/modify_ldt.2 +man2/sysctl.2 +man2/arm_sync_file_range.2 +man2/fchmod.2 +man2/msgget.2 +man2/poll.2 +man2/setreuid.2 +man2/getunwind.2 +man2/inw.2 +man2/mq_timedsend.2 +man2/fallocate.2 man2/fchdir.2 -man2/pidfd_send_signal.2 -man2/rmdir.2 -man2/setsockopt.2 -man2/umount.2 -man2/fstatat64.2 -man2/mlockall.2 -man2/write.2 -man2/mpx.2 +man2/ioctl_userfaultfd.2 +man2/set_thread_area.2 +man2/syscall.2 +man2/lchown.2 +man2/getgid.2 +man2/get_kernel_syms.2 +man2/pidfd_open.2 +man2/getresgid.2 +man2/sync.2 +man2/set_tid_address.2 +man2/timer_settime.2 +man2/pause.2 +man2/stty.2 +man2/idle.2 +man2/outb_p.2 man2/gethostname.2 -man2/kexec_load.2 +man2/readlink.2 +man2/sched_yield.2 +man2/wait3.2 +man2/accept4.2 +man2/sigpending.2 +man2/msgop.2 +man2/ioctl_ficlone.2 +man2/open_by_handle_at.2 +man2/pivot_root.2 +man2/recvmsg.2 +man2/fadvise64_64.2 +man2/query_module.2 +man2/uname.2 +man2/fork.2 +man2/recv.2 +man2/unlink.2 +man2/oldolduname.2 +man2/renameat.2 +man2/rt_sigaction.2 +man2/clock_nanosleep.2 +man2/spu_create.2 +man2/outsw.2 +man2/timer_getoverrun.2 +man2/setregid32.2 +man2/ppoll.2 +man2/move_pages.2 +man2/futimesat.2 +man2/symlinkat.2 +man2/inb.2 +man2/ioctl_ficlonerange.2 +man2/timer_create.2 +man2/process_vm_writev.2 +man2/remap_file_pages.2 +man2/recvmmsg.2 +man2/setrlimit.2 +man2/sgetmask.2 +man2/oldfstat.2 +man2/mq_notify.2 +man2/vm86.2 +man2/epoll_create1.2 +man2/subpage_prot.2 +man2/s390_pci_mmio_read.2 man2/timer_gettime.2 -man2/syncfs.2 -man2/signal.2 -man2/setuid.2 -man2/getpgrp.2 +man2/getresuid32.2 man2/fsync.2 -man2/io_setup.2 -man2/sgetmask.2 -man2/copy_file_range.2 -man2/msgrcv.2 -man2/symlinkat.2 +man2/iopl.2 man2/semop.2 -man2/mkdir.2 -man2/clock_settime.2 -man2/select.2 -man2/fchmodat.2 -man2/ioctl_list.2 -man2/getrusage.2 -man2/pciconfig_read.2 +man2/olduname.2 +man2/sched_rr_get_interval.2 man2/dup3.2 +man2/__clone2.2 +man2/flock.2 +man2/accept.2 +man2/semctl.2 +man2/signal.2 +man2/sigsuspend.2 +man2/setpgid.2 +man2/clone3.2 +man2/setresgid32.2 +man2/set_mempolicy.2 +man2/s390_guarded_storage.2 +man2/getdomainname.2 +man2/pkey_mprotect.2 +man2/io_submit.2 +man2/s390_pci_mmio_write.2 man2/putmsg.2 -man2/pidfd_getfd.2 +man2/preadv2.2 man2/outsb.2 -man2/setresuid32.2 -man2/inotify_rm_watch.2 -man2/read.2 -man2/sendmmsg.2 -man2/afs_syscall.2 -man2/ioctl.2 -man2/exit_group.2 -man2/oldolduname.2 -man2/geteuid.2 -man2/reboot.2 -man2/unimplemented.2 -man2/setns.2 -man2/getgroups32.2 -man2/_llseek.2 -man2/sendfile64.2 -man2/setegid.2 -man2/fallocate.2 -man2/utimes.2 -man2/geteuid32.2 -man2/msgget.2 -man2/shmget.2 -man2/s390_pci_mmio_write.2 -man2/timerfd_create.2 -man2/wait3.2 -man2/clock_nanosleep.2 -man2/socket.2 -man2/fchown32.2 -man2/prlimit64.2 -man2/uname.2 -man2/migrate_pages.2 -man2/setfsgid.2 -man2/setup.2 -man2/mq_open.2 -man2/query_module.2 -man2/pselect.2 -man2/mmap.2 -man2/_newselect.2 -man2/epoll_wait.2 -man2/getresgid32.2 -man2/creat.2 -man2/syscall.2 -man2/__clone2.2 -man2/pread64.2 -man2/oldfstat.2 -man2/inl.2 -man2/timer_settime.2 -man2/shmdt.2 -man2/break.2 -man2/kexec_file_load.2 -man2/tuxcall.2 -man2/arm_fadvise.2 -man2/subpage_prot.2 -man2/rt_tgsigqueueinfo.2 -man2/insw.2 -man2/exit.2 -man2/openat.2 -man2/rt_sigqueueinfo.2 -man2/getresgid.2 -man2/fstatfs64.2 -man2/unlinkat.2 -man2/getpid.2 -man2/sethostname.2 -man2/swapoff.2 -man2/futex.2 -man2/munlock.2 -man2/fchown.2 -man2/inb_p.2 -man2/fremovexattr.2 -man2/select_tut.2 -man2/fanotify_init.2 -man2/syscalls.2 -man2/fstat.2 -man2/sync_file_range.2 -man2/rt_sigtimedwait.2 -man2/fcntl.2 -man2/bdflush.2 -man2/setpriority.2 -man2/statfs64.2 -man2/move_pages.2 -man2/futimesat.2 -man2/capget.2 -man2/vmsplice.2 -man2/memfd_create.2 -man2/security.2 -man2/mknod.2 -man2/acct.2 -man2/umask.2 -man2/personality.2 -man2/ioctl_ficlonerange.2 -man2/pause.2 +man2/oldlstat.2 +man2/msync.2 +man2/symlink.2 +man2/link.2 +man2/set_robust_list.2 man2/kill.2 -man2/preadv2.2 -man2/shmctl.2 -man2/io_submit.2 -man2/pidfd_open.2 -man2/getuid.2 +man2/setsockopt.2 +man2/setpriority.2 +man2/setfsuid32.2 man2/getitimer.2 -man2/set_tid_address.2 -man2/oldlstat.2 -man2/setreuid32.2 -man2/wait.2 -man2/prctl.2 -man2/getpeername.2 -man2/llistxattr.2 -man2/getpmsg.2 -man2/ioctl_ficlone.2 -man2/bpf.2 -man2/fcntl64.2 -man2/_syscall.2 -man2/timerfd_settime.2 -man2/readdir.2 -man2/shmat.2 -man2/io_destroy.2 -man2/sysctl.2 -man2/signalfd.2 +man2/kexec_load.2 +man2/dup.2 +man2/clone2.2 +man2/get_mempolicy.2 +man2/setuid.2 +man2/setitimer.2 +man2/mpx.2 +man2/lgetxattr.2 +man2/nfsservctl.2 +man2/swapon.2 +man2/epoll_wait.2 +man2/epoll_create.2 +man2/inotify_init.2 +man2/tkill.2 +man2/setgroups32.2 +man2/sendfile64.2 +man2/ioctl_ns.2 man2/s390_sthyi.2 -man2/epoll_pwait.2 +man2/getpriority.2 +man2/ioctl.2 +man2/listen.2 +man2/cacheflush.2 +man2/lstat64.2 +man2/mincore.2 +man2/mknod.2 +man2/fcntl64.2 man2/insl.2 -man2/setfsgid32.2 -man2/epoll_ctl.2 -man2/setsid.2 -man2/getresuid.2 -man2/lookup_dcookie.2 -man2/keyctl.2 -man2/linkat.2 -man2/sched_yield.2 -man2/mkdirat.2 -man2/setregid32.2 -man2/delete_module.2 -man2/fadvise64.2 -man2/sysinfo.2 -man2/setcontext.2 -man2/setreuid.2 -man2/ugetrlimit.2 -man2/mprotect.2 -man2/restart_syscall.2 -man2/mknodat.2 -man2/sched_setscheduler.2 -man2/madvise1.2 -man2/connect.2 +man2/outw_p.2 +man2/execveat.2 +man2/recvfrom.2 +man2/mlockall.2 +man2/pwritev2.2 +man2/munlockall.2 +man2/killpg.2 +man2/statvfs.2 +man2/ftruncate64.2 +man2/wait.2 +man2/writev.2 man2/uselib.2 +man2/getsockopt.2 +man2/delete_module.2 +man2/pread.2 +man2/security.2 +man2/pkey_alloc.2 +man2/pipe2.2 +man2/clone.2 +man2/gtty.2 +man2/setresgid.2 +man2/get_thread_area.2 +man2/arch_prctl.2 +man2/socketcall.2 +man2/inb_p.2 +man2/close.2 +man2/mkdirat.2 man2/timer_delete.2 -man2/modify_ldt.2 -man2/getegid32.2 -man2/semtimedop.2 -man2/sbrk.2 -man2/iopl.2 -man2/fdetach.2 -man2/isastream.2 -man2/getpagesize.2 -man2/msgctl.2 -man2/getdtablesize.2 -man2/waitid.2 -man2/outb_p.2 -man2/sigwaitinfo.2 -man2/eventfd2.2 -man2/getgroups.2 -man2/getcwd.2 -man2/olduname.2 -man2/s390_pci_mmio_read.2 -man2/setfsuid.2 -man2/getdents64.2 -man2/unlink.2 -man2/mq_getsetattr.2 -man2/clone3.2 -man2/sync.2 -man2/open.2 -man2/name_to_handle_at.2 -man2/lsetxattr.2 -man2/get_mempolicy.2 -man2/add_key.2 -man2/mlock2.2 -man2/outsw.2 +man2/vfork.2 man2/ipc.2 -man2/setpgid.2 -man2/ioctl_fat.2 -man2/getmsg.2 -man2/remap_file_pages.2 -man2/finit_module.2 -man2/ioctl_iflags.2 -man2/signalfd4.2 -man2/tkill.2 -man2/openat2.2 -man2/clock_gettime.2 -man2/ustat.2 -man2/nanosleep.2 -man2/mremap.2 +man2/ioctl_console.2 +man2/swapoff.2 +man2/personality.2 +man2/phys.2 +man2/flistxattr.2 +man2/chmod.2 man2/lremovexattr.2 -man2/setresgid.2 +man2/setfsgid.2 +man2/putpmsg.2 +man2/fanotify_mark.2 +man2/madvise.2 +man2/prlimit64.2 +man2/statx.2 +man2/lstat.2 +man2/unshare.2 +man2/keyctl.2 man2/s390_runtime_instr.2 -man2/sigaction.2 -man2/fchmod.2 -man2/outb.2 -man2/rt_sigreturn.2 -man2/sendmsg.2 -man2/fsetxattr.2 -man2/open_by_handle_at.2 -man2/ioprio_get.2 -man2/inotify_init.2 +man2/newfstatat.2 +man2/settimeofday.2 +man2/sethostid.2 +man2/llistxattr.2 man2/pwritev.2 -man2/fanotify_mark.2 -man2/pciconfig_iobase.2 -man2/prof.2 -man2/outw_p.2 -man2/pipe2.2 -man2/swapon.2 -man2/ppoll.2 -man2/sigpending.2 -man2/mincore.2 -man2/shmop.2 -man2/get_kernel_syms.2 +man2/msgsnd.2 +man2/getrandom.2 +man2/insw.2 +man2/pciconfig_write.2 +man2/acct.2 +man2/open.2 +man2/pipe.2 +man2/alarm.2 +man2/rt_sigreturn.2 +man2/unimplemented.2 +man2/fchownat.2 +man2/mlock2.2 +man2/umask.2 +man2/fdatasync.2 +man2/inotify_rm_watch.2 +man2/syscalls.2 +man2/fchown.2 +man2/membarrier.2 +man2/stime.2 +man2/sysfs.2 +man2/outb.2 +man2/sched_getattr.2 +man2/sendto.2 +man2/sethostname.2 man2/renameat2.2 -man2/ioctl_getfsmap.2 -man2/getrlimit.2 -man2/stty.2 -man2/settimeofday.2 -man2/mbind.2 -man2/inotify_init1.2 -man2/getppid.2 -man2/fork.2 -man2/intro.2 -man2/pwritev2.2 -man2/access.2 man2/mlock.2 -man2/execveat.2 -man2/close.2 -man2/inl_p.2 -man2/sigreturn.2 -man2/free_hugepages.2 -man2/vfork.2 -man2/gettid.2 -man2/fstatvfs.2 -man2/fattach.2 -man2/getsockopt.2 -man2/msgop.2 +man2/outw.2 +man2/mq_getsetattr.2 +man2/gettimeofday.2 +man2/setns.2 +man2/wait4.2 man2/getcontext.2 -man2/cacheflush.2 -man2/nfsservctl.2 -man2/readlinkat.2 -man2/sched_setparam.2 -man2/syslog.2 -man2/ioprio_set.2 -man2/fchownat.2 -man2/inw.2 -man2/setitimer.2 -man2/arm_fadvise64_64.2 -man2/sendfile.2 -man2/recvmmsg.2 -man2/statvfs.2 -man2/pkey_mprotect.2 +man2/rt_sigqueueinfo.2 +man2/utime.2 +man2/getrlimit.2 +man2/fstatvfs.2 man2/kcmp.2 -man2/outsl.2 +man2/reboot.2 +man2/eventfd.2 +man2/clock_settime.2 +man2/waitpid.2 +man2/dup2.2 +man2/getppid.2 +man2/lsetxattr.2 +man2/clock_gettime.2 +man2/sync_file_range.2 +man2/umount2.2 +man2/shutdown.2 +man2/brk.2 +man2/openat2.2 +man2/fchmodat.2 +man2/read.2 +man2/sendmsg.2 +man2/mkdir.2 +man2/create_module.2 +man2/futex.2 +man2/getresuid.2 +man2/shmget.2 +man2/waitid.2 +man2/inw_p.2 +man2/_Exit.2 +man2/rt_sigpending.2 +man2/mq_open.2 +man2/fattach.2 +man2/chdir.2 +man2/userfaultfd.2 +man2/faccessat.2 +man2/getdtablesize.2 +man2/restart_syscall.2 +man2/setreuid32.2 +man2/getegid.2 +man2/adjtimex.2 +man2/getgroups.2 +man2/execve.2 +man2/mremap.2 +man2/tgkill.2 +man2/sigprocmask.2 +man2/memfd_create.2 +man2/rt_sigprocmask.2 +man2/bdflush.2 man2/clock_getres.2 -man2/statx.2 -man2/munlockall.2 -man2/io_cancel.2 -man2/listxattr.2 -man2/getunwind.2 -man2/lstat64.2 -man2/lchown32.2 -man2/recvmsg.2 +man2/fgetxattr.2 +man2/posix_fadvise.2 +man2/getcwd.2 +man2/geteuid.2 +man2/getmsg.2 +man2/fremovexattr.2 +man2/pwrite64.2 +man2/fstatat.2 +man2/setsid.2 +man2/readahead.2 +man2/fstat.2 +man2/afs_syscall.2 +man2/pwrite.2 +man2/timerfd_create.2 +man2/sendmmsg.2 +man2/sysinfo.2 +man2/vhangup.2 +man2/statfs.2 +man2/prof.2 +man2/fcntl.2 +man2/stat64.2 +man2/tee.2 +man2/syslog.2 +man2/tuxcall.2 man2/mq_timedreceive.2 -man2/recvfrom.2 +man2/_llseek.2 +man2/ioctl_fslabel.2 +man2/gettid.2 +man2/fstatat64.2 +man2/gethostid.2 +man2/ptrace.2 +man2/getxattr.2 +man2/quotactl.2 +man2/bpf.2 +man2/bind.2 +man2/chown.2 +man2/getsockname.2 +man2/sched_getparam.2 +man2/lseek.2 +man2/getuid32.2 +man2/pciconfig_read.2 +man2/ssetmask.2 +man2/fstatfs64.2 +man2/getresgid32.2 +man2/getpgrp.2 +man2/select_tut.2 +man2/sigwaitinfo.2 +man2/outl.2 +man2/creat.2 +man2/exit_group.2 +man2/ugetrlimit.2 man2/insb.2 -man2/arch_prctl.2 -man2/ioctl_userfaultfd.2 -man2/fdatasync.2 -man2/timer_create.2 -man2/setxattr.2 -man2/nice.2 -man2/set_thread_area.2 -man2/brk.2 -man2/truncate64.2 -man2/seteuid.2 -man2/perfmonctl.2 -man2/getrandom.2 -man2/clone.2 -man2/tee.2 -man2/ioctl_tty.2 -man2/arm_sync_file_range.2 man2/process_vm_readv.2 -man2/dup.2 +man2/setcontext.2 +man2/capget.2 +man2/getrusage.2 +man2/setgid32.2 +man2/mbind.2 +man2/ustat.2 +man2/stat.2 +man2/send.2 +man2/splice.2 +man2/lock.2 +man2/timerfd_settime.2 +man2/access.2 +man2/ioprio_set.2 +man2/openat.2 +man2/intro.2 +man2/vmsplice.2 man2/outl_p.2 -man2/sched_getattr.2 -man2/semget.2 +man2/sched_get_priority_min.2 +man2/ioctl_fat.2 +man2/lchown32.2 +man2/io_destroy.2 +man2/statfs64.2 +man2/prctl.2 +man2/socketpair.2 +man2/_newselect.2 +man2/ioprio_get.2 +man2/readdir.2 man2/_exit.2 -man2/membarrier.2 -man2/stat64.2 -man2/msgsnd.2 +man2/fchown32.2 +man2/migrate_pages.2 +man2/getpid.2 +man2/prlimit.2 man2/setdomainname.2 -man2/rt_sigpending.2 -man2/stime.2 -man2/_sysctl.2 -man2/getgid32.2 -man2/getpriority.2 -man2/flock.2 -man2/fadvise64_64.2 -man2/getuid32.2 +man2/copy_file_range.2 +man2/getuid.2 +man2/time.2 +man2/setregid.2 man2/request_key.2 -man2/pread.2 -man2/listen.2 -man2/sched_get_priority_max.2 -man2/epoll_create.2 -man2/lseek.2 -man2/create_module.2 -man2/mq_timedsend.2 -man2/getxattr.2 -man2/link.2 -man2/putpmsg.2 -man2/sched_get_priority_min.2 -man2/clone2.2 -man2/get_robust_list.2 man2/inotify_add_watch.2 -man2/getsid.2 -man2/killpg.2 -man2/rt_sigsuspend.2 -man2/recv.2 -man2/ioctl_fideduperange.2 -man2/io_getevents.2 -man2/vserver.2 -man2/splice.2 -man2/setrlimit.2 -man2/chown32.2 -man2/oldstat.2 -man2/sync_file_range2.2 -man2/alarm.2 -man2/chdir.2 -man2/setuid32.2 -man2/flistxattr.2 -man2/mount.2 -man2/perf_event_open.2 -man2/userfaultfd.2 -man2/s390_guarded_storage.2 -man2/idle.2 -man2/ioperm.2 -man2/accept.2 -man2/lgetxattr.2 -man2/lock.2 -man2/ftruncate.2 -man2/setresgid32.2 -man2/semctl.2 -man2/readahead.2 -man2/lstat.2 -man2/posix_fadvise.2 -man2/execve.2 +man2/sigtimedwait.2 +man2/pidfd_getfd.2 man2/sigqueue.2 -man2/pivot_root.2 -man2/process_vm_writev.2 -man2/gtty.2 -man2/outw.2 -man2/prlimit.2 -man2/sigprocmask.2 -man2/sigaltstack.2 -man2/spu_create.2 -man2/newfstatat.2 -man2/pipe.2 -man2/set_mempolicy.2 -man2/readv.2 -man2/get_thread_area.2 -man2/setregid.2 -man2/inb.2 -man2/sched_rr_get_interval.2 +man2/capset.2 +man2/llseek.2 +man2/arm_fadvise.2 +man2/write.2 +man2/outsl.2 +man2/munlock.2 +man2/sched_get_priority_max.2 +man2/geteuid32.2 +man2/fsetxattr.2 +man2/ioctl_tty.2 +man2/nice.2 +man2/fstat64.2 +man2/utimensat.2 +man2/listxattr.2 +man2/mmap.2 +man2/shmctl.2 +man2/vm86old.2 +man2/ioctl_getfsmap.2 +man2/shmdt.2 +man2/ioctl_iflags.2 man2/seccomp.2 -man2/socketpair.2 +man2/semtimedop.2 +man2/connect.2 +man2/io_cancel.2 +man2/setgroups.2 +man2/finit_module.2 +man2/io_setup.2 +man2/sched_setscheduler.2 +man2/rename.2 +man2/sendfile.2 man2/mmap2.2 -man2/sethostid.2 -man2/utimensat.2 -man2/gethostid.2 -man2/epoll_create1.2 -man2/llseek.2 -man2/sched_getaffinity.2 -man2/alloc_hugepages.2 -man2/sched_setattr.2 -man2/lchown.2 -man2/umount2.2 -man2/pwrite.2 -man2/sigtimedwait.2 -man2/sched_setaffinity.2 -man2/phys.2 -man2/rt_sigprocmask.2 -man2/tgkill.2 -man2/getgid.2 -man2/ioctl_console.2 -man2/chroot.2 -man2/fstatat.2 -man2/poll.2 -man2/getpgid.2 -man2/getresuid32.2 -man2/readlink.2 -man2/fgetxattr.2 -man2/inw_p.2 -man2/shutdown.2 -man3/key_setsecret.3 -man3/isatty.3 -man3/fpathconf.3 -man3/__ppc_set_ppr_med_low.3 +man2/syncfs.2 +man2/msgrcv.2 +man2/sync_file_range2.2 +man2/name_to_handle_at.2 +man2/umount.2 +man2/inotify_init1.2 +man2/sigaction.2 +man2/arm_fadvise64_64.2 +man2/_sysctl.2 +man2/nanosleep.2 +man2/sched_getscheduler.2 +man2/setegid.2 +man2/fstatfs.2 +man2/kexec_file_load.2 +man2/socket.2 +man2/getgid32.2 +man2/sched_setparam.2 +man2/truncate.2 +man2/oldstat.2 +man2/setresuid32.2 +man3/res_querydomain.3 +man3/pthread_sigqueue.3 +man3/sem_close.3 +man3/strptime.3 +man3/clnt_broadcast.3 +man3/hcreate_r.3 +man3/res_nmkquery.3 +man3/fgetws_unlocked.3 +man3/pthread_attr_setdetachstate.3 +man3/dl_iterate_phdr.3 +man3/qecvt.3 +man3/program_invocation_short_name.3 +man3/acoshf.3 +man3/sgetspent_r.3 +man3/hash.3 +man3/bswap.3 +man3/alphasort.3 +man3/xdrmem_create.3 +man3/sigwait.3 +man3/explicit_bzero.3 +man3/getgrnam.3 +man3/SLIST_FIRST.3 +man3/tcsendbreak.3 +man3/significand.3 +man3/ffs.3 +man3/realloc.3 +man3/fputs.3 +man3/dlinfo.3 +man3/clogf.3 +man3/lgamma_r.3 +man3/fread_unlocked.3 +man3/pthread_getattr_np.3 +man3/TAILQ_LAST.3 +man3/iswpunct.3 +man3/conjl.3 +man3/sys_errlist.3 +man3/nan.3 +man3/mq_open.3 +man3/errno.3 +man3/cacos.3 +man3/localeconv.3 +man3/lcong48.3 +man3/setstate_r.3 +man3/vtimes.3 +man3/execlp.3 +man3/gethostbyname2.3 +man3/pthread_attr_setstack.3 +man3/cfgetispeed.3 +man3/iswlower.3 +man3/isinff.3 +man3/getwd.3 +man3/pow.3 +man3/sigmask.3 +man3/__ppc_set_ppr_med.3 +man3/localtime.3 +man3/feof_unlocked.3 +man3/catanf.3 +man3/isascii.3 +man3/LIST_NEXT.3 +man3/getdtablesize.3 +man3/fgetc.3 +man3/xdrrec_eof.3 man3/sinhl.3 -man3/significandf.3 -man3/rint.3 -man3/fileno.3 -man3/key_gendes.3 -man3/setnetent.3 -man3/ldiv.3 -man3/mkstemp.3 +man3/scalblnf.3 +man3/coshf.3 man3/setnetgrent.3 -man3/xdr_u_long.3 -man3/vdprintf.3 -man3/memchr.3 -man3/dysize.3 -man3/end.3 -man3/ctermid.3 -man3/cabs.3 -man3/finitef.3 -man3/strfmon_l.3 -man3/sigrelse.3 -man3/getmntent_r.3 -man3/ffsll.3 -man3/getutxline.3 -man3/setlogmask.3 -man3/powf.3 -man3/CMSG_FIRSTHDR.3 -man3/sscanf.3 -man3/pthread_mutexattr_getpshared.3 -man3/addseverity.3 -man3/finitel.3 -man3/strcat.3 -man3/fputwc.3 -man3/isblank_l.3 -man3/nextafter.3 -man3/getspnam.3 -man3/llround.3 -man3/nextdown.3 -man3/getnetgrent_r.3 -man3/getlogin_r.3 -man3/getrpcbyname_r.3 -man3/xdr_destroy.3 -man3/__ppc_set_ppr_med.3 -man3/fread.3 -man3/acosh.3 -man3/newlocale.3 -man3/svc_freeargs.3 -man3/fputwc_unlocked.3 -man3/nexttowardf.3 -man3/log.3 -man3/llabs.3 -man3/htole64.3 -man3/muntrace.3 -man3/nexttoward.3 -man3/dlsym.3 -man3/FD_ISSET.3 -man3/psiginfo.3 -man3/getusershell.3 -man3/getaddrinfo_a.3 -man3/hdestroy.3 -man3/fmal.3 -man3/__ppc_set_ppr_very_low.3 -man3/pthread_getconcurrency.3 -man3/sem_getvalue.3 -man3/cbrtf.3 -man3/cpow.3 -man3/optopt.3 -man3/hstrerror.3 -man3/rpmatch.3 -man3/getpt.3 -man3/pthread_mutex_consistent_np.3 -man3/MB_CUR_MAX.3 -man3/svc_unregister.3 -man3/error_one_per_line.3 -man3/lrintf.3 -man3/ctime.3 -man3/trunc.3 -man3/sigorset.3 -man3/passwd2des.3 -man3/scanf.3 -man3/dladdr.3 -man3/bcmp.3 -man3/timerclear.3 -man3/div.3 -man3/setgrent.3 -man3/exp10f.3 -man3/qecvt_r.3 -man3/cabsl.3 -man3/auth_destroy.3 -man3/feclearexcept.3 -man3/pthread_attr_setguardsize.3 -man3/getgrent.3 -man3/isunordered.3 -man3/mq_open.3 -man3/getnetent_r.3 -man3/setttyent.3 -man3/rexec.3 +man3/siglongjmp.3 +man3/isless.3 +man3/clnt_sperrno.3 +man3/j0l.3 +man3/aio_suspend.3 +man3/l64a.3 +man3/putgrent.3 +man3/clnt_create.3 +man3/isxdigit_l.3 +man3/getcwd.3 +man3/clnt_sperror.3 +man3/fgetspent_r.3 man3/jn.3 -man3/fts_close.3 -man3/fts.3 -man3/rexec_af.3 -man3/getcontext.3 -man3/resolver.3 -man3/makedev.3 -man3/CIRCLEQ_REMOVE.3 -man3/erfc.3 -man3/cproj.3 -man3/ccoshf.3 -man3/fpclassify.3 -man3/strsep.3 -man3/cexpl.3 -man3/__flbf.3 -man3/scalblnl.3 -man3/timeradd.3 -man3/gethostid.3 -man3/drem.3 -man3/iswcntrl.3 -man3/fileno_unlocked.3 -man3/TAILQ_LAST.3 -man3/wcscpy.3 -man3/erf.3 -man3/TAILQ_FOREACH_REVERSE.3 -man3/srand.3 -man3/unsetenv.3 -man3/STAILQ_REMOVE_HEAD.3 -man3/pthread_mutexattr_setpshared.3 -man3/lseek64.3 -man3/dl_iterate_phdr.3 +man3/sscanf.3 +man3/erfcf.3 +man3/isupper.3 +man3/putchar.3 +man3/malloc_usable_size.3 +man3/CIRCLEQ_INSERT_HEAD.3 +man3/remquol.3 +man3/getrpcent_r.3 +man3/atoq.3 +man3/islessgreater.3 +man3/tcgetattr.3 +man3/toupper.3 +man3/putpwent.3 +man3/regexec.3 +man3/xdrrec_endofrecord.3 +man3/tfind.3 +man3/svctcp_create.3 +man3/argz_delete.3 +man3/nl_langinfo_l.3 +man3/tolower.3 +man3/pututline.3 +man3/feupdateenv.3 +man3/res_mkquery.3 +man3/strchr.3 +man3/fts_open.3 +man3/fdimf.3 +man3/malloc_get_state.3 +man3/remove.3 +man3/nftw.3 +man3/xdr_getpos.3 +man3/isalpha_l.3 +man3/exit.3 +man3/log2.3 +man3/ftok.3 +man3/gmtime.3 +man3/assert.3 +man3/pthread_equal.3 +man3/fmax.3 +man3/significandl.3 +man3/cbrt.3 +man3/lutimes.3 +man3/nl_langinfo.3 +man3/log1pf.3 +man3/mkostemps.3 +man3/remainder.3 +man3/sinl.3 man3/SLIST_EMPTY.3 +man3/getutxid.3 man3/CPU_FREE.3 -man3/remquo.3 -man3/res_nmkquery.3 -man3/xdr_opaque.3 -man3/clntudp_create.3 -man3/iswgraph.3 -man3/getnetbyname.3 -man3/clog.3 -man3/recno.3 -man3/tcflow.3 -man3/hsearch.3 -man3/get_nprocs.3 -man3/xdr_free.3 -man3/crypt.3 -man3/ispunct_l.3 -man3/termios.3 -man3/ntp_gettimex.3 -man3/inet_ntoa.3 -man3/gmtime.3 -man3/freelocale.3 -man3/atanl.3 -man3/strtoq.3 -man3/timercmp.3 -man3/sinhf.3 -man3/TAILQ_EMPTY.3 -man3/opterr.3 -man3/aligned_alloc.3 -man3/gammaf.3 -man3/expf.3 -man3/CPU_CLR.3 -man3/getutid.3 -man3/ctanh.3 -man3/wcsdup.3 -man3/mprobe.3 -man3/mkdtemp.3 -man3/cexp.3 -man3/isalnum_l.3 -man3/sysconf.3 -man3/stdout.3 -man3/CPU_SET_S.3 -man3/svcerr_weakauth.3 -man3/cbc_crypt.3 +man3/addseverity.3 +man3/calloc.3 +man3/fesetenv.3 +man3/endaliasent.3 +man3/malloc_trim.3 +man3/addmntent.3 +man3/bzero.3 +man3/MB_CUR_MAX.3 +man3/llrintf.3 +man3/pthread_mutexattr_setrobust_np.3 +man3/strtok_r.3 +man3/getdelim.3 +man3/llround.3 +man3/isspace.3 +man3/lgamma.3 +man3/xdr_u_char.3 +man3/res_init.3 +man3/mbtowc.3 +man3/va_copy.3 +man3/cfsetispeed.3 +man3/pthread_attr_setstackaddr.3 +man3/free.3 +man3/wctob.3 +man3/pthread_attr_getstackaddr.3 man3/malloc_stats.3 -man3/catclose.3 -man3/rtime.3 -man3/innetgr.3 -man3/erfl.3 -man3/eventfd_read.3 -man3/getprotobynumber_r.3 -man3/cfree.3 -man3/pthread_mutexattr_setrobust.3 -man3/wcsnrtombs.3 -man3/envz_get.3 -man3/memmem.3 -man3/setstate_r.3 -man3/mq_timedreceive.3 -man3/be16toh.3 -man3/STAILQ_EMPTY.3 -man3/pvalloc.3 -man3/LIST_FIRST.3 -man3/ilogbf.3 -man3/fwrite_unlocked.3 -man3/__fpurge.3 -man3/inet_pton.3 -man3/pow.3 -man3/nearbyintf.3 -man3/nrand48.3 -man3/acoshl.3 -man3/scalbnf.3 -man3/sys_errlist.3 -man3/malloc.3 -man3/getnameinfo.3 -man3/shm_unlink.3 -man3/nearbyint.3 -man3/envz_remove.3 -man3/inet_network.3 -man3/TAILQ_HEAD_INITIALIZER.3 -man3/difftime.3 -man3/argz_replace.3 -man3/getfsspec.3 -man3/stdio_ext.3 -man3/mcheck_pedantic.3 -man3/alphasort.3 -man3/STAILQ_INIT.3 -man3/edata.3 -man3/cprojl.3 -man3/fgetpwent.3 -man3/iruserok.3 -man3/logb.3 -man3/ftw.3 -man3/towlower.3 -man3/strtod.3 -man3/opendir.3 -man3/__realloc_hook.3 -man3/wmemcpy.3 -man3/strcasestr.3 -man3/clock_gettime.3 -man3/significand.3 -man3/cfgetospeed.3 -man3/tfind.3 -man3/argz_stringify.3 man3/tsearch.3 -man3/scalbln.3 -man3/clearenv.3 -man3/log10f.3 -man3/glob.3 -man3/sem_close.3 -man3/fgetspent_r.3 -man3/getttynam.3 -man3/pthread_equal.3 -man3/realloc.3 -man3/isinf.3 -man3/CPU_ZERO_S.3 -man3/atanf.3 -man3/daylight.3 -man3/__setfpucw.3 +man3/cacoshf.3 +man3/isnan.3 +man3/csinh.3 +man3/rcmd.3 +man3/clntudp_bufcreate.3 +man3/localtime_r.3 +man3/clock_getcpuclockid.3 +man3/wcscasecmp.3 +man3/timerclear.3 +man3/MB_LEN_MAX.3 +man3/clog10.3 +man3/error_at_line.3 +man3/xdr_callhdr.3 +man3/ctermid.3 +man3/__free_hook.3 +man3/iscntrl.3 +man3/wcspbrk.3 +man3/timezone.3 +man3/strcasestr.3 +man3/pthread_setconcurrency.3 +man3/basename.3 +man3/lround.3 +man3/ftime.3 +man3/fwrite.3 +man3/pthread_kill_other_threads_np.3 +man3/rand.3 +man3/getservent_r.3 +man3/CMSG_SPACE.3 +man3/pthread_mutexattr_setrobust.3 +man3/mq_send.3 man3/setbuffer.3 +man3/atanf.3 +man3/fread.3 +man3/iconv_close.3 +man3/ether_aton_r.3 +man3/htobe64.3 +man3/bcmp.3 +man3/authnone_create.3 +man3/TAILQ_FOREACH.3 man3/gnu_dev_makedev.3 -man3/xprt_unregister.3 -man3/LIST_EMPTY.3 -man3/malloc_get_state.3 -man3/openpty.3 -man3/casinl.3 -man3/vsyslog.3 -man3/wcstombs.3 -man3/vtimes.3 -man3/conjf.3 -man3/fclose.3 -man3/remque.3 -man3/isdigit_l.3 -man3/pthread_getattr_np.3 -man3/strncmp.3 -man3/sigwait.3 -man3/xdr_enum.3 -man3/getservbyport.3 -man3/xdrmem_create.3 -man3/inet_net_ntop.3 -man3/strtouq.3 -man3/fts_read.3 -man3/statvfs.3 -man3/rindex.3 -man3/optind.3 -man3/remainder.3 -man3/exp10l.3 -man3/confstr.3 -man3/stdin.3 -man3/qsort_r.3 -man3/islower.3 -man3/tcdrain.3 -man3/daemon.3 -man3/get_myaddress.3 -man3/ether_ntoa_r.3 -man3/mq_close.3 -man3/mcheck_check_all.3 -man3/TAILQ_PREV.3 -man3/clnt_sperror.3 -man3/iswprint.3 -man3/pthread_getaffinity_np.3 -man3/sem_timedwait.3 -man3/mq_timedsend.3 -man3/llrint.3 -man3/forkpty.3 -man3/undocumented.3 -man3/tgammaf.3 -man3/LIST_INIT.3 -man3/CPU_XOR_S.3 -man3/pthread_attr_setinheritsched.3 -man3/posix_memalign.3 +man3/getspnam_r.3 +man3/inet_makeaddr.3 +man3/atol.3 +man3/xdrrec_skiprecord.3 +man3/clnt_perror.3 +man3/mbsnrtowcs.3 man3/isupper_l.3 -man3/ungetc.3 -man3/fputws.3 -man3/sinl.3 -man3/log10.3 -man3/getutxent.3 -man3/pthread_attr_getstackaddr.3 -man3/__free_hook.3 -man3/pthread_setname_np.3 -man3/iswalpha.3 -man3/readdir.3 -man3/svctcp_create.3 -man3/wcscat.3 -man3/rintl.3 -man3/LIST_REMOVE.3 -man3/dlclose.3 +man3/STAILQ_INIT.3 +man3/xdr_reference.3 +man3/wctrans.3 +man3/xprt_unregister.3 +man3/key_secretkey_is_set.3 +man3/mmap64.3 +man3/wmemcmp.3 +man3/fabsf.3 +man3/ulckpwdf.3 man3/isalpha.3 -man3/xdr_authunix_parms.3 -man3/getutid_r.3 -man3/strtoimax.3 -man3/cpowf.3 -man3/argz_insert.3 -man3/feupdateenv.3 -man3/htole16.3 -man3/xdr_long.3 -man3/authunix_create.3 -man3/catan.3 -man3/strtoll.3 -man3/xdr_callhdr.3 -man3/isnormal.3 -man3/fmin.3 -man3/getwc.3 -man3/rcmd.3 -man3/l64a.3 -man3/isgreater.3 -man3/isblank.3 -man3/dlinfo.3 -man3/iconv_close.3 -man3/open_memstream.3 -man3/__ppc_get_timebase_freq.3 -man3/j0.3 -man3/clearerr.3 -man3/gethostbyname_r.3 -man3/strdupa.3 -man3/getpwnam.3 +man3/svcerr_noprog.3 +man3/setlocale.3 +man3/opendir.3 +man3/be64toh.3 +man3/isprint.3 +man3/dlopen.3 +man3/malloc_hook.3 +man3/isprint_l.3 +man3/ntohl.3 +man3/getw.3 +man3/y0f.3 +man3/imaxdiv.3 +man3/ceil.3 +man3/casin.3 +man3/dladdr1.3 +man3/mallopt.3 +man3/fwprintf.3 +man3/pthread_setschedparam.3 +man3/usleep.3 man3/ynl.3 -man3/wcswidth.3 -man3/initstate.3 -man3/pow10f.3 -man3/pthread_attr_getguardsize.3 -man3/freehostent.3 -man3/lio_listio.3 -man3/copysignf.3 -man3/cosf.3 -man3/globfree.3 -man3/mbrtowc.3 -man3/casinh.3 -man3/scalbn.3 -man3/wcscmp.3 -man3/inet_lnaof.3 -man3/isfinite.3 -man3/exp.3 -man3/getprotoent_r.3 -man3/getservent_r.3 -man3/sighold.3 -man3/drand48_r.3 -man3/isgreaterequal.3 -man3/isgraph_l.3 -man3/copysign.3 -man3/klogctl.3 -man3/strftime.3 -man3/strptime.3 -man3/getwchar.3 -man3/bstring.3 -man3/makecontext.3 -man3/fmodf.3 -man3/le64toh.3 +man3/erfcl.3 +man3/erfc.3 +man3/round.3 +man3/ccos.3 +man3/y1.3 +man3/csinl.3 +man3/ctanhf.3 +man3/strerror_l.3 +man3/argz_count.3 +man3/stdarg.3 +man3/sgetspent.3 +man3/qfcvt_r.3 +man3/cabsf.3 +man3/drem.3 +man3/svcerr_auth.3 +man3/getaliasent.3 +man3/modfl.3 +man3/mq_timedreceive.3 +man3/clearerr.3 +man3/xdr_short.3 +man3/ftrylockfile.3 +man3/fgetwc.3 +man3/strnlen.3 +man3/rewinddir.3 +man3/coshl.3 +man3/expm1f.3 +man3/sprintf.3 +man3/TAILQ_ENTRY.3 man3/re_comp.3 -man3/inet_addr.3 -man3/clog10.3 -man3/isalpha_l.3 -man3/fgetwc_unlocked.3 -man3/sigstack.3 -man3/getutent.3 -man3/matherr.3 -man3/sigsetmask.3 -man3/log10l.3 -man3/stpncpy.3 -man3/llrintf.3 -man3/vfscanf.3 -man3/nextafterf.3 -man3/getrpcport.3 -man3/__fsetlocking.3 -man3/assert_perror.3 -man3/strstr.3 +man3/nrand48_r.3 +man3/crypt.3 +man3/SLIST_HEAD.3 +man3/argz_replace.3 +man3/pthread_mutexattr_destroy.3 +man3/atoll.3 +man3/fegetenv.3 +man3/verrx.3 +man3/fts_read.3 +man3/pmap_unset.3 +man3/inet_netof.3 +man3/ptsname.3 man3/lrand48.3 -man3/atoq.3 -man3/calloc.3 -man3/isless.3 -man3/LIST_INSERT_BEFORE.3 +man3/rresvport.3 +man3/backtrace_symbols.3 +man3/endian.3 +man3/strtoq.3 +man3/fmaf.3 +man3/ether_ntohost.3 +man3/isdigit.3 +man3/llabs.3 +man3/LIST_FIRST.3 +man3/fscanf.3 +man3/htobe16.3 +man3/vdprintf.3 +man3/LIST_ENTRY.3 +man3/svc_sendreply.3 +man3/STAILQ_HEAD.3 +man3/dlsym.3 +man3/cosl.3 +man3/pthread_mutex_consistent_np.3 +man3/isfinite.3 +man3/CMSG_ALIGN.3 +man3/hasmntopt.3 +man3/acosf.3 +man3/le64toh.3 +man3/program_invocation_name.3 +man3/sigrelse.3 +man3/nextupf.3 +man3/iswxdigit.3 +man3/valloc.3 man3/wcsspn.3 -man3/clnt_spcreateerror.3 -man3/nextdownf.3 -man3/h_errno.3 -man3/wcwidth.3 -man3/CIRCLEQ_INSERT_AFTER.3 -man3/unlocked_stdio.3 -man3/frexp.3 -man3/signgam.3 -man3/warnx.3 -man3/rewinddir.3 -man3/fsetpos.3 -man3/vswprintf.3 +man3/CPU_SET_S.3 +man3/toascii.3 +man3/fmal.3 +man3/SLIST_REMOVE.3 +man3/tcdrain.3 +man3/ctime_r.3 +man3/fgetwc_unlocked.3 +man3/db.3 +man3/setspent.3 +man3/posix_fallocate.3 +man3/snprintf.3 +man3/fcvt.3 +man3/initgroups.3 +man3/mpool.3 +man3/memchr.3 +man3/casinh.3 +man3/wcschr.3 +man3/qsort_r.3 +man3/htobe32.3 +man3/strfromf.3 +man3/fmtmsg.3 +man3/log2f.3 +man3/gcvt.3 +man3/erand48.3 +man3/wcscspn.3 +man3/vsnprintf.3 +man3/fgetws.3 +man3/remquo.3 +man3/getfsfile.3 +man3/execvpe.3 +man3/catclose.3 +man3/clog2f.3 +man3/acosh.3 +man3/atof.3 +man3/strpbrk.3 +man3/iswspace.3 +man3/le16toh.3 +man3/gethostid.3 +man3/pthread_spin_trylock.3 +man3/jrand48_r.3 +man3/xdr_replymsg.3 +man3/STAILQ_INSERT_HEAD.3 +man3/strsep.3 +man3/seed48.3 +man3/STAILQ_FOREACH.3 +man3/xdr_inline.3 +man3/fdopen.3 +man3/res_query.3 +man3/if_freenameindex.3 man3/signbit.3 -man3/sigsetjmp.3 -man3/string.3 -man3/copysignl.3 -man3/cimag.3 -man3/backtrace_symbols.3 -man3/remquol.3 -man3/pthread_setschedprio.3 -man3/svc_getreq.3 -man3/cfmakeraw.3 -man3/pthread_getcpuclockid.3 -man3/putspent.3 -man3/STAILQ_INSERT_TAIL.3 -man3/pthread_detach.3 -man3/clog2.3 -man3/nextafterl.3 -man3/wmemset.3 -man3/nl_langinfo.3 -man3/mq_notify.3 -man3/gmtime_r.3 +man3/get_nprocs_conf.3 +man3/lckpwdf.3 +man3/clntudp_create.3 +man3/getc.3 +man3/pthread_cleanup_pop.3 +man3/STAILQ_INSERT_AFTER.3 +man3/svcudp_create.3 +man3/memmem.3 +man3/ftello.3 +man3/lgammal_r.3 +man3/isdigit_l.3 +man3/gamma.3 +man3/wcsncasecmp.3 +man3/xdr_opaque_auth.3 +man3/strfry.3 +man3/STAILQ_CONCAT.3 +man3/sigblock.3 +man3/fclose.3 +man3/csinf.3 +man3/TAILQ_INIT.3 +man3/fmin.3 +man3/conjf.3 +man3/getspent.3 +man3/hdestroy_r.3 +man3/getwc_unlocked.3 +man3/rexec.3 +man3/gammal.3 +man3/setttyent.3 +man3/strcasecmp.3 +man3/rpmatch.3 +man3/res_nsearch.3 +man3/srand.3 +man3/if_indextoname.3 +man3/ctanhl.3 +man3/svc_getargs.3 +man3/setkey_r.3 +man3/strdup.3 +man3/pthread_setaffinity_np.3 +man3/lrintl.3 +man3/errx.3 +man3/LIST_HEAD.3 +man3/FD_CLR.3 +man3/setcontext.3 +man3/mtrace.3 +man3/sigsetops.3 +man3/dlclose.3 +man3/fflush.3 +man3/lgammaf_r.3 +man3/wordfree.3 +man3/fgetpwent.3 +man3/__freading.3 +man3/CMSG_NXTHDR.3 +man3/malloc_set_state.3 +man3/key_decryptsession.3 man3/getnetgrent.3 -man3/vfwprintf.3 -man3/xdr_float.3 -man3/le16toh.3 -man3/isupper.3 -man3/modff.3 -man3/iscntrl.3 -man3/fts_open.3 -man3/tan.3 -man3/re_exec.3 +man3/raise.3 +man3/ccoshf.3 +man3/tzset.3 +man3/pthread_attr_setschedpolicy.3 +man3/HUGE_VAL.3 +man3/TAILQ_FIRST.3 +man3/aio_error.3 +man3/makedev.3 +man3/inet_net_ntop.3 +man3/envz_entry.3 +man3/strtold.3 +man3/pthread_rwlockattr_getkind_np.3 +man3/timelocal.3 man3/sincos.3 -man3/res_nsend.3 -man3/rand.3 -man3/yn.3 -man3/pthread_attr_setstacksize.3 -man3/syslog.3 -man3/cacos.3 -man3/getnetbyname_r.3 -man3/SLIST_INIT.3 -man3/strtok_r.3 -man3/posix_spawn.3 -man3/wcrtomb.3 -man3/ruserok.3 -man3/wcstoumax.3 -man3/svcudp_bufcreate.3 -man3/gamma.3 -man3/scalb.3 -man3/lroundf.3 -man3/strfroml.3 -man3/errno.3 -man3/endfsent.3 -man3/atexit.3 -man3/creall.3 -man3/reallocarray.3 -man3/STAILQ_ENTRY.3 +man3/gmtime_r.3 +man3/setutent.3 +man3/sysv_signal.3 man3/getgrgid_r.3 -man3/clogf.3 -man3/lsearch.3 -man3/endservent.3 -man3/dlerror.3 -man3/towctrans.3 -man3/wcsncat.3 -man3/des_setparity.3 -man3/erfcl.3 -man3/round.3 -man3/iswlower.3 -man3/lockf.3 -man3/xdecrypt.3 -man3/strndupa.3 -man3/strfromf.3 +man3/strsignal.3 +man3/rresvport_af.3 +man3/err.3 +man3/getline.3 +man3/mcheck_check_all.3 +man3/CIRCLEQ_ENTRY.3 +man3/CIRCLEQ_REMOVE.3 +man3/dn_expand.3 +man3/mq_receive.3 +man3/dlvsym.3 +man3/copysign.3 +man3/strfmon_l.3 +man3/CPU_AND_S.3 +man3/fstatvfs.3 +man3/pthread_mutexattr_getrobust.3 +man3/swprintf.3 +man3/getifaddrs.3 +man3/frexp.3 +man3/putc.3 +man3/gethostbyname2_r.3 +man3/getnetent_r.3 +man3/netlink.3 +man3/getopt_long.3 +man3/optind.3 +man3/fgetspent.3 +man3/strncpy.3 +man3/clock_gettime.3 +man3/mallinfo.3 +man3/ruserok_af.3 +man3/llroundl.3 +man3/tdelete.3 +man3/qgcvt.3 +man3/minor.3 +man3/initstate_r.3 +man3/wordexp.3 +man3/svcraw_create.3 +man3/vwarnx.3 +man3/cacosh.3 +man3/getdate_r.3 man3/_flushlbf.3 -man3/getrpcbyname.3 -man3/isalnum.3 -man3/xdr_short.3 +man3/dremf.3 +man3/y0.3 +man3/xdrrec_create.3 +man3/memfrob.3 +man3/pthread_join.3 +man3/freeaddrinfo.3 +man3/encrypt.3 +man3/LIST_INIT.3 +man3/getspent_r.3 +man3/fdiml.3 +man3/clnt_call.3 +man3/vscanf.3 +man3/mblen.3 +man3/acos.3 +man3/syslog.3 +man3/aio_cancel.3 +man3/CPU_ALLOC.3 man3/posix_madvise.3 -man3/sem_wait.3 -man3/conj.3 -man3/db.3 -man3/INFINITY.3 -man3/log1p.3 -man3/dreml.3 -man3/j1.3 -man3/fetestexcept.3 -man3/warn.3 -man3/hcreate_r.3 -man3/putpwent.3 -man3/cuserid.3 -man3/strsignal.3 -man3/clock_getres.3 -man3/iswctype.3 -man3/fabsf.3 -man3/res_nquerydomain.3 -man3/wcsncasecmp.3 -man3/ssignal.3 -man3/svc_register.3 -man3/cbrt.3 -man3/freopen.3 -man3/truncl.3 -man3/expm1.3 -man3/strchr.3 -man3/killpg.3 -man3/fdimf.3 -man3/frexpl.3 -man3/getservbyname.3 -man3/scalbl.3 -man3/argz_next.3 +man3/STAILQ_NEXT.3 +man3/euidaccess.3 +man3/fileno_unlocked.3 +man3/posix_openpt.3 +man3/nextafterl.3 +man3/vsprintf.3 +man3/backtrace_symbols_fd.3 +man3/ccosl.3 +man3/sched_getcpu.3 +man3/sinh.3 +man3/fmodf.3 +man3/nexttoward.3 +man3/svc_getreqset.3 +man3/offsetof.3 +man3/remainderl.3 +man3/tanhf.3 +man3/execle.3 +man3/strrchr.3 +man3/grantpt.3 +man3/CPU_COUNT.3 +man3/SLIST_REMOVE_HEAD.3 +man3/mktime.3 +man3/xdr_opaque.3 +man3/TAILQ_PREV.3 +man3/dysize.3 +man3/CPU_ISSET.3 +man3/__ppc_get_timebase_freq.3 +man3/key_encryptsession.3 +man3/be16toh.3 +man3/CIRCLEQ_INSERT_TAIL.3 +man3/setenv.3 +man3/inet_lnaof.3 +man3/getloadavg.3 man3/LIST_INSERT_HEAD.3 -man3/xdr_array.3 +man3/wcsncpy.3 +man3/__realloc_hook.3 +man3/mprobe.3 +man3/ntohs.3 +man3/fabsl.3 man3/cimagf.3 -man3/endrpcent.3 -man3/gnu_dev_minor.3 -man3/fscanf.3 -man3/fegetexceptflag.3 -man3/getspnam_r.3 -man3/cexp2l.3 -man3/nextdownl.3 -man3/fdim.3 -man3/sinf.3 -man3/islessgreater.3 -man3/SLIST_FOREACH.3 -man3/mkostemp.3 -man3/timersub.3 -man3/lfind.3 -man3/shm_open.3 -man3/wctype.3 -man3/closedir.3 -man3/sem_init.3 -man3/log2f.3 -man3/siglongjmp.3 -man3/acosl.3 -man3/acoshf.3 -man3/fdiml.3 -man3/nanf.3 -man3/dlopen.3 -man3/tempnam.3 -man3/memalign.3 -man3/adjtime.3 -man3/va_end.3 -man3/mbsinit.3 -man3/wcstoimax.3 -man3/roundf.3 -man3/endusershell.3 -man3/utmpxname.3 -man3/getprotobyname_r.3 -man3/y1l.3 -man3/svcerr_systemerr.3 -man3/envz_strip.3 -man3/sinh.3 -man3/dlmopen.3 -man3/cargf.3 -man3/ctanf.3 -man3/argz.3 -man3/fwprintf.3 -man3/get_phys_pages.3 -man3/putenv.3 -man3/seekdir.3 -man3/backtrace_symbols_fd.3 -man3/insque.3 -man3/sqrt.3 -man3/error_print_progname.3 +man3/CPU_CLR_S.3 +man3/clearerr_unlocked.3 +man3/modff.3 +man3/strncasecmp.3 +man3/va_start.3 +man3/pthread_setcancelstate.3 +man3/futimens.3 +man3/wcsncat.3 +man3/ether_line.3 +man3/tanh.3 man3/fdopendir.3 -man3/fmod.3 -man3/assert.3 -man3/alloca.3 -man3/btree.3 -man3/lround.3 -man3/ilogbl.3 -man3/htobe16.3 -man3/ldexpf.3 -man3/TAILQ_INSERT_AFTER.3 -man3/setjmp.3 -man3/gethostbyaddr.3 -man3/open_wmemstream.3 -man3/getaliasbyname.3 -man3/pthread_attr_getscope.3 -man3/__freading.3 -man3/key_secretkey_is_set.3 -man3/getwchar_unlocked.3 -man3/sem_unlink.3 -man3/pthread_exit.3 -man3/group_member.3 -man3/mbrlen.3 -man3/gnu_get_libc_release.3 -man3/sqrtf.3 -man3/strcoll.3 -man3/clogl.3 -man3/lldiv.3 -man3/pthread_spin_destroy.3 -man3/getc.3 -man3/tolower.3 -man3/ccoshl.3 -man3/toupper_l.3 -man3/offsetof.3 -man3/sigdelset.3 -man3/SLIST_FIRST.3 -man3/hash.3 -man3/htole32.3 -man3/crypt_r.3 -man3/endutxent.3 +man3/putw.3 +man3/j0f.3 +man3/fts_close.3 +man3/HUGE_VALL.3 +man3/fesetexceptflag.3 +man3/mcheck.3 +man3/random_r.3 +man3/exp2f.3 +man3/tcgetsid.3 +man3/execl.3 +man3/fopencookie.3 +man3/fabs.3 +man3/strtof.3 man3/tmpfile.3 -man3/exp2.3 -man3/isprint.3 -man3/llroundl.3 -man3/putgrent.3 -man3/isxdigit_l.3 -man3/pthread_atfork.3 -man3/getutxid.3 -man3/mrand48.3 +man3/sqrtl.3 +man3/psignal.3 +man3/tcsetpgrp.3 +man3/scalbl.3 +man3/pthread_setname_np.3 +man3/abs.3 +man3/sethostent.3 +man3/ecvt.3 +man3/getpw.3 +man3/fileno.3 man3/putwc_unlocked.3 -man3/rewind.3 -man3/xdr_opaque_auth.3 -man3/isxdigit.3 -man3/pthread_rwlockattr_setkind_np.3 -man3/casinf.3 -man3/svc_getargs.3 -man3/log2.3 -man3/CIRCLEQ_ENTRY.3 -man3/cosl.3 -man3/setlinebuf.3 -man3/sigemptyset.3 -man3/strspn.3 -man3/conjl.3 -man3/STAILQ_HEAD_INITIALIZER.3 -man3/lgamma.3 -man3/pow10.3 -man3/sigpause.3 -man3/dladdr1.3 -man3/y0.3 -man3/getopt.3 -man3/SLIST_HEAD_INITIALIZER.3 -man3/crealf.3 -man3/STAILQ_HEAD.3 -man3/strnlen.3 -man3/regcomp.3 -man3/error.3 -man3/feof_unlocked.3 -man3/modfl.3 -man3/isascii.3 -man3/ether_aton.3 -man3/vfprintf.3 -man3/remove.3 -man3/mq_setattr.3 -man3/fexecve.3 -man3/fseek.3 +man3/LIST_INSERT_AFTER.3 +man3/difftime.3 +man3/getfsspec.3 +man3/strftime.3 +man3/xdr_authunix_parms.3 +man3/scalbln.3 +man3/random.3 +man3/cfmakeraw.3 +man3/tgammaf.3 +man3/execvp.3 +man3/stdio.3 +man3/vsscanf.3 +man3/copysignf.3 +man3/wcsdup.3 +man3/xdr_free.3 +man3/xdr_union.3 +man3/ffsl.3 +man3/__fbufsize.3 +man3/get_avphys_pages.3 +man3/clog10l.3 +man3/passwd2des.3 +man3/xdr_setpos.3 +man3/sigandset.3 +man3/wcscat.3 +man3/__fsetlocking.3 +man3/ungetwc.3 +man3/svcerr_decode.3 +man3/argz_append.3 +man3/btree.3 +man3/DES_FAILED.3 +man3/strtod.3 man3/xdr_accepted_reply.3 -man3/hcreate.3 -man3/pthread_attr_setschedpolicy.3 -man3/getchar_unlocked.3 -man3/creal.3 -man3/pthread_mutexattr_init.3 -man3/encrypt.3 -man3/clnt_destroy.3 -man3/ccosl.3 -man3/bswap_64.3 -man3/a64l.3 -man3/tanl.3 -man3/ccosf.3 -man3/ulimit.3 -man3/fdopen.3 -man3/system.3 +man3/llroundf.3 +man3/getutmpx.3 +man3/TAILQ_INSERT_HEAD.3 +man3/execv.3 +man3/yn.3 +man3/envz_merge.3 +man3/argz_next.3 +man3/__freadable.3 +man3/strcspn.3 +man3/be32toh.3 +man3/pthread_yield.3 +man3/cuserid.3 +man3/ilogbl.3 +man3/error_message_count.3 +man3/res_nsend.3 +man3/htole64.3 +man3/re_exec.3 +man3/alloca.3 +man3/innetgr.3 +man3/sem_init.3 +man3/iconv_open.3 +man3/dladdr.3 +man3/pthread_mutexattr_setpshared.3 +man3/pthread_timedjoin_np.3 +man3/clnt_perrno.3 +man3/endttyent.3 +man3/log2l.3 +man3/wmemmove.3 +man3/atanh.3 +man3/setgrent.3 +man3/strncat.3 +man3/sincosl.3 +man3/tan.3 +man3/mq_getattr.3 +man3/siginterrupt.3 +man3/CIRCLEQ_INIT.3 +man3/tcgetpgrp.3 +man3/logbf.3 +man3/svcerr_weakauth.3 +man3/resolver.3 +man3/svcerr_noproc.3 +man3/strverscmp.3 +man3/openlog.3 +man3/assert_perror.3 +man3/xdr_array.3 +man3/vswprintf.3 +man3/CPU_ALLOC_SIZE.3 man3/CPU_EQUAL.3 -man3/tanf.3 +man3/fmod.3 +man3/lrand48_r.3 +man3/__ppc_mdoom.3 +man3/inet_ntop.3 +man3/gai_cancel.3 +man3/nearbyint.3 +man3/xdr_double.3 +man3/pathconf.3 +man3/getprotobynumber_r.3 +man3/sethostid.3 +man3/pthread_testcancel.3 +man3/isgreater.3 +man3/cpowl.3 +man3/fcvt_r.3 +man3/htole32.3 +man3/wcsstr.3 +man3/des_crypt.3 +man3/endnetent.3 +man3/uselocale.3 +man3/strchrnul.3 +man3/endrpcent.3 +man3/getwchar_unlocked.3 +man3/__memalign_hook.3 +man3/warnx.3 +man3/callrpc.3 +man3/tcflow.3 +man3/qfcvt.3 +man3/scanf.3 +man3/atanhl.3 +man3/mq_close.3 +man3/sigaddset.3 +man3/hypot.3 +man3/memmove.3 +man3/pthread_cancel.3 +man3/CPU_AND.3 +man3/lockf.3 +man3/setpwent.3 +man3/expf.3 +man3/strfmon.3 man3/clntraw_create.3 -man3/tcsetpgrp.3 -man3/pthread_attr_getschedpolicy.3 -man3/csinl.3 -man3/regexec.3 -man3/argz_extract.3 -man3/fmaxl.3 -man3/logbf.3 -man3/y0l.3 -man3/getrpcbynumber.3 -man3/frexpf.3 -man3/endhostent.3 -man3/fts_children.3 -man3/logwtmp.3 -man3/setkey_r.3 -man3/remainderl.3 -man3/ecb_crypt.3 -man3/fputc_unlocked.3 -man3/atanh.3 -man3/wcsncpy.3 -man3/clock_settime.3 -man3/wcstok.3 -man3/ftrylockfile.3 -man3/btowc.3 -man3/getutent_r.3 -man3/iswspace.3 +man3/sigsetjmp.3 +man3/bswap_32.3 +man3/eventfd_write.3 +man3/gai_strerror.3 +man3/drand48_r.3 +man3/pmap_set.3 +man3/csinhl.3 +man3/atanhf.3 +man3/getchar.3 +man3/a64l.3 +man3/tanl.3 +man3/inet_addr.3 +man3/SLIST_ENTRY.3 +man3/fputs_unlocked.3 +man3/floorf.3 +man3/timegm.3 +man3/sysconf.3 +man3/cbrtf.3 +man3/CPU_ZERO_S.3 +man3/lgammaf.3 +man3/gnu_dev_major.3 +man3/dirfd.3 +man3/bsd_signal.3 +man3/powl.3 +man3/fdim.3 +man3/undocumented.3 +man3/wcscmp.3 man3/queue.3 -man3/fgetpwent_r.3 -man3/key_decryptsession.3 -man3/STAILQ_FIRST.3 -man3/argz_create_sep.3 -man3/fabsl.3 -man3/fgetc_unlocked.3 -man3/va_copy.3 -man3/xdrrec_eof.3 -man3/key_encryptsession.3 -man3/fgetpos.3 -man3/wcsrchr.3 -man3/scalbf.3 -man3/ldexpl.3 -man3/lroundl.3 -man3/mempcpy.3 -man3/tcflush.3 -man3/fmemopen.3 +man3/gethostent_r.3 +man3/fexecve.3 +man3/auth_destroy.3 +man3/bcopy.3 +man3/bsearch.3 man3/casinhf.3 -man3/strcasecmp.3 -man3/encrypt_r.3 -man3/getw.3 -man3/setvbuf.3 -man3/major.3 -man3/__ppc_yield.3 -man3/fwide.3 -man3/inet_netof.3 -man3/FD_ZERO.3 -man3/authnone_create.3 -man3/realpath.3 -man3/TAILQ_FOREACH.3 -man3/fesetexceptflag.3 -man3/initgroups.3 -man3/catanhl.3 -man3/xdr_rejected_reply.3 -man3/getopt_long_only.3 -man3/ttyslot.3 -man3/envz_merge.3 -man3/xdr_string.3 -man3/LIST_FOREACH.3 -man3/asprintf.3 -man3/mq_send.3 -man3/sys_nerr.3 +man3/getservbyname_r.3 +man3/iruserok_af.3 +man3/__fpurge.3 +man3/bswap_64.3 +man3/LIST_EMPTY.3 +man3/getdirentries.3 +man3/if_nameindex.3 +man3/cpow.3 +man3/cacoshl.3 +man3/xdr_u_short.3 man3/getenv.3 -man3/toupper.3 -man3/stderr.3 -man3/putwc.3 -man3/ccosh.3 -man3/getprotobyname.3 -man3/pututxline.3 -man3/y1.3 -man3/sockatmark.3 -man3/setspent.3 -man3/asinf.3 -man3/cfsetispeed.3 -man3/basename.3 -man3/fprintf.3 -man3/logout.3 -man3/llroundf.3 -man3/getfsfile.3 -man3/ftime.3 -man3/ftok.3 +man3/isinf.3 +man3/group_member.3 +man3/res_search.3 +man3/aio_read.3 man3/getaddrinfo.3 -man3/pmap_getmaps.3 -man3/mkfifo.3 -man3/strtoull.3 -man3/pthread_attr_setscope.3 -man3/clearerr_unlocked.3 -man3/stdarg.3 -man3/catanf.3 -man3/isprint_l.3 -man3/tzname.3 -man3/cacosl.3 -man3/catanl.3 -man3/getaliasent_r.3 -man3/exp10.3 -man3/TAILQ_REMOVE.3 -man3/getservbyname_r.3 -man3/asctime_r.3 -man3/fwrite.3 -man3/longjmp.3 -man3/ferror_unlocked.3 -man3/addmntent.3 -man3/svcerr_auth.3 -man3/fgetc.3 -man3/CIRCLEQ_INSERT_TAIL.3 -man3/isnanf.3 -man3/lcong48.3 -man3/setpwent.3 -man3/atanhf.3 -man3/csinf.3 -man3/tmpnam.3 -man3/gethostbyname.3 -man3/inet_net_pton.3 -man3/hasmntopt.3 -man3/labs.3 -man3/setcontext.3 -man3/isspace.3 -man3/getpwuid_r.3 -man3/dirfd.3 -man3/cexp2f.3 +man3/scalbnf.3 +man3/wctype.3 +man3/freehostent.3 +man3/vprintf.3 +man3/cexp2.3 +man3/lroundl.3 +man3/on_exit.3 +man3/endmntent.3 +man3/recno.3 +man3/intro.3 +man3/putchar_unlocked.3 +man3/argz_create.3 +man3/ether_aton.3 +man3/catgets.3 man3/cos.3 -man3/tolower_l.3 +man3/nearbyintl.3 +man3/get_myaddress.3 +man3/endfsent.3 +man3/cfgetospeed.3 +man3/imaxabs.3 +man3/putwchar.3 +man3/freopen.3 +man3/cfsetspeed.3 +man3/stpncpy.3 +man3/strdupa.3 +man3/strtouq.3 +man3/sem_destroy.3 +man3/cprojf.3 +man3/memrchr.3 +man3/hsearch.3 +man3/xencrypt.3 +man3/cosf.3 +man3/getprotobynumber.3 +man3/scandirat.3 +man3/casinhl.3 +man3/getservbyname.3 +man3/truncf.3 +man3/roundf.3 +man3/clnt_spcreateerror.3 +man3/cargl.3 +man3/getrpcent.3 +man3/backtrace.3 man3/CMSG_LEN.3 -man3/CPU_OR_S.3 -man3/pthread_spin_lock.3 -man3/fmaxf.3 -man3/lckpwdf.3 -man3/sigignore.3 -man3/authunix_create_default.3 -man3/csinh.3 -man3/rcmd_af.3 -man3/getgrnam_r.3 -man3/snprintf.3 -man3/fgetws_unlocked.3 -man3/clog2l.3 -man3/ether_ntohost.3 -man3/fegetround.3 -man3/vscanf.3 -man3/pthread_attr_setstack.3 -man3/posix_openpt.3 -man3/getfsent.3 -man3/fputws_unlocked.3 -man3/sigaddset.3 man3/fputc.3 -man3/atol.3 -man3/rawmemchr.3 -man3/clnt_broadcast.3 -man3/getrpcent.3 -man3/setmntent.3 -man3/wordfree.3 -man3/login_tty.3 -man3/verr.3 -man3/va_arg.3 -man3/res_query.3 -man3/setaliasent.3 -man3/bswap.3 -man3/__ppc_set_ppr_low.3 -man3/endmntent.3 -man3/expm1l.3 +man3/finite.3 +man3/argz_insert.3 +man3/getaliasbyname_r.3 +man3/getpwnam_r.3 +man3/y1l.3 +man3/ldexp.3 +man3/logwtmp.3 +man3/envz_get.3 +man3/jnl.3 +man3/vfprintf.3 +man3/vlimit.3 +man3/envz_add.3 +man3/bstring.3 +man3/abort.3 +man3/va_end.3 +man3/timercmp.3 +man3/truncl.3 +man3/__after_morecore_hook.3 +man3/casinl.3 +man3/strcat.3 man3/envz.3 -man3/feholdexcept.3 -man3/vsnprintf.3 -man3/toascii.3 -man3/erff.3 -man3/dirname.3 -man3/execvp.3 -man3/getipnodebyaddr.3 -man3/LIST_ENTRY.3 -man3/fgets.3 -man3/hypot.3 -man3/isgraph.3 -man3/get_current_dir_name.3 -man3/htonl.3 -man3/endgrent.3 +man3/lsearch.3 man3/catanh.3 -man3/hdestroy_r.3 -man3/sprintf.3 -man3/lgamma_r.3 -man3/mbsnrtowcs.3 -man3/pthread_attr_destroy.3 +man3/key_gendes.3 +man3/tzname.3 +man3/jrand48.3 +man3/getttynam.3 +man3/fcloseall.3 +man3/login_tty.3 +man3/gammaf.3 +man3/getusershell.3 +man3/argz_stringify.3 +man3/htons.3 +man3/vsyslog.3 +man3/strerror_r.3 +man3/fmaxf.3 +man3/isascii_l.3 +man3/ldexpl.3 +man3/xdr_bool.3 +man3/getopt_long_only.3 +man3/gai_suspend.3 man3/gethostent.3 -man3/getservbyport_r.3 -man3/pthread_mutexattr_setrobust_np.3 -man3/svcerr_noprog.3 -man3/siginterrupt.3 -man3/be32toh.3 -man3/csinhl.3 -man3/ether_line.3 -man3/mktemp.3 -man3/TAILQ_INSERT_BEFORE.3 -man3/clnt_control.3 -man3/atoi.3 -man3/ctan.3 -man3/svc_destroy.3 -man3/wmemcmp.3 -man3/getservent.3 -man3/explicit_bzero.3 -man3/memcmp.3 -man3/pthread_kill.3 -man3/sysv_signal.3 -man3/endnetgrent.3 -man3/strtol.3 -man3/cpowl.3 -man3/timerisset.3 -man3/getloadavg.3 -man3/pthread_mutex_consistent.3 +man3/TAILQ_EMPTY.3 +man3/rtime.3 +man3/fegetexcept.3 +man3/LIST_HEAD_INITIALIZER.3 +man3/qecvt_r.3 +man3/feraiseexcept.3 +man3/strtoll.3 man3/rintf.3 -man3/pthread_cancel.3 -man3/atan.3 -man3/cacosh.3 -man3/getdate_err.3 -man3/mkstemps.3 +man3/CPU_CLR.3 +man3/warn.3 +man3/insque.3 +man3/drand48.3 +man3/index.3 +man3/cabs.3 +man3/asinhf.3 +man3/perror.3 +man3/ctanh.3 +man3/sem_getvalue.3 +man3/gnu_dev_minor.3 +man3/setlinebuf.3 +man3/isalnum_l.3 +man3/getnetbyaddr.3 +man3/updwtmp.3 +man3/wcstombs.3 +man3/getrpcport.3 +man3/towlower_l.3 +man3/STAILQ_HEAD_INITIALIZER.3 +man3/STAILQ_EMPTY.3 +man3/puts.3 +man3/xdr_pmap.3 +man3/le32toh.3 +man3/pthread_create.3 +man3/mkstemp.3 +man3/hdestroy.3 +man3/wcpcpy.3 +man3/fts_set.3 +man3/ferror_unlocked.3 +man3/pthread_attr_getdetachstate.3 +man3/iswgraph.3 +man3/bswap_16.3 +man3/pthread_attr_getscope.3 +man3/get_phys_pages.3 +man3/getipnodebyname.3 +man3/end.3 +man3/glob.3 +man3/expm1.3 +man3/pthread_attr_setscope.3 +man3/asprintf.3 +man3/ctime.3 +man3/scalbn.3 +man3/islower.3 +man3/sigemptyset.3 +man3/mbsinit.3 +man3/sem_unlink.3 +man3/argz_add.3 +man3/clnt_geterr.3 +man3/sem_trywait.3 +man3/TAILQ_HEAD_INITIALIZER.3 +man3/atexit.3 +man3/__ppc_set_ppr_med_low.3 +man3/strndupa.3 +man3/lrint.3 +man3/seed48_r.3 +man3/strncmp.3 +man3/sigignore.3 +man3/aio_fsync.3 +man3/iswalpha.3 +man3/sigset.3 +man3/tempnam.3 +man3/towupper_l.3 +man3/wcslen.3 +man3/readdir.3 +man3/CPU_OR.3 +man3/logb.3 +man3/cacosl.3 +man3/CIRCLEQ_INSERT_BEFORE.3 +man3/ldexpf.3 +man3/strspn.3 +man3/ttyname.3 +man3/cfree.3 man3/nexttowardl.3 -man3/memset.3 -man3/lutimes.3 -man3/pthread_sigmask.3 -man3/setservent.3 -man3/getrpcent_r.3 -man3/pthread_spin_trylock.3 -man3/getpw.3 -man3/ccos.3 -man3/asinh.3 -man3/posix_spawnp.3 +man3/CPU_ZERO.3 +man3/unsetenv.3 +man3/CPU_XOR.3 +man3/catanhl.3 +man3/getservbyport.3 +man3/xdr_enum.3 +man3/clock.3 +man3/flockfile.3 +man3/pthread_setcanceltype.3 +man3/exp10l.3 +man3/pmap_getport.3 +man3/getcontext.3 +man3/getaddrinfo_a.3 +man3/strtol.3 +man3/dreml.3 +man3/setutxent.3 +man3/endnetgrent.3 man3/res_ninit.3 -man3/clnt_pcreateerror.3 -man3/ntohl.3 -man3/fminl.3 -man3/__freadable.3 -man3/xdr_pmaplist.3 -man3/secure_getenv.3 -man3/res_search.3 -man3/TAILQ_FIRST.3 -man3/catgets.3 -man3/initstate_r.3 -man3/roundl.3 -man3/strchrnul.3 -man3/ecvt_r.3 -man3/ceill.3 -man3/setlocale.3 -man3/fgets_unlocked.3 -man3/mrand48_r.3 -man3/isascii_l.3 -man3/floor.3 -man3/__fbufsize.3 -man3/j1l.3 -man3/fgetgrent.3 -man3/usleep.3 -man3/bsd_signal.3 -man3/__ppc_mdoio.3 -man3/pthread_attr_setaffinity_np.3 -man3/malloc_trim.3 -man3/getline.3 -man3/sin.3 -man3/lrintl.3 -man3/casin.3 -man3/xdr_u_int.3 -man3/aio_suspend.3 -man3/strcpy.3 -man3/isfdtype.3 -man3/pthread_attr_setdetachstate.3 -man3/tanhl.3 -man3/wcspbrk.3 -man3/fgetspent.3 -man3/res_querydomain.3 -man3/getentropy.3 -man3/getlogin.3 -man3/atan2f.3 -man3/bindresvport.3 -man3/fmodl.3 -man3/endian.3 -man3/cexp2.3 -man3/setbuf.3 -man3/ftello.3 -man3/tcgetattr.3 -man3/SLIST_REMOVE_HEAD.3 -man3/rtnetlink.3 -man3/wcsncmp.3 -man3/__memalign_hook.3 -man3/__malloc_initialize_hook.3 -man3/fmax.3 -man3/scalbnl.3 -man3/iswupper.3 -man3/swab.3 -man3/seed48.3 -man3/fopen.3 -man3/STAILQ_CONCAT.3 man3/cacosf.3 -man3/wcschr.3 -man3/CPU_ISSET_S.3 -man3/callrpc.3 -man3/va_start.3 -man3/SLIST_HEAD.3 -man3/ruserok_af.3 -man3/etext.3 -man3/floorf.3 -man3/srand48.3 -man3/catanhf.3 -man3/pthread_attr_getinheritsched.3 -man3/logf.3 -man3/atof.3 -man3/MB_LEN_MAX.3 -man3/isspace_l.3 -man3/getutmp.3 -man3/be64toh.3 -man3/envz_entry.3 -man3/CIRCLEQ_HEAD.3 -man3/feof.3 -man3/getgrgid.3 -man3/fflush.3 -man3/SLIST_INSERT_AFTER.3 -man3/jnf.3 -man3/xdr_replymsg.3 -man3/hypotl.3 -man3/svcerr_progvers.3 -man3/strncasecmp.3 -man3/strtoumax.3 -man3/herror.3 -man3/wordexp.3 -man3/valloc.3 -man3/atanhl.3 -man3/execv.3 -man3/ceil.3 -man3/nftw.3 -man3/catopen.3 -man3/wctob.3 -man3/execl.3 -man3/sigmask.3 -man3/clntudp_bufcreate.3 -man3/xdr_pointer.3 -man3/timegm.3 -man3/TAILQ_INIT.3 -man3/CPU_SET.3 -man3/pthread_cleanup_push.3 -man3/hsearch_r.3 -man3/execlp.3 -man3/tdestroy.3 -man3/log1pl.3 -man3/netlink.3 -man3/towupper.3 man3/clnttcp_create.3 -man3/xdr_union.3 -man3/closelog.3 -man3/xdr_wrapstring.3 -man3/iconv.3 -man3/STAILQ_NEXT.3 -man3/TAILQ_INSERT_HEAD.3 -man3/pthread_mutexattr_destroy.3 -man3/pmap_rmtcall.3 -man3/xdr_callmsg.3 -man3/asctime.3 -man3/xdr_u_short.3 -man3/gai_error.3 -man3/malloc_set_state.3 -man3/clog10l.3 -man3/on_exit.3 -man3/stdio.3 -man3/setenv.3 -man3/strncat.3 -man3/nextup.3 -man3/logbl.3 -man3/xdr_double.3 -man3/ynf.3 -man3/CIRCLEQ_INSERT_HEAD.3 -man3/ttyname.3 -man3/CPU_OR.3 -man3/aio_fsync.3 +man3/fgetc_unlocked.3 +man3/getc_unlocked.3 +man3/__ppc_set_ppr_med_high.3 +man3/regcomp.3 +man3/aio_write.3 +man3/wctomb.3 +man3/tgammal.3 +man3/fmaxl.3 +man3/setservent.3 +man3/ilogb.3 +man3/error_print_progname.3 +man3/CIRCLEQ_INSERT_AFTER.3 +man3/xdr_string.3 +man3/significandf.3 +man3/strlen.3 +man3/sys_nerr.3 +man3/fgetpos.3 +man3/SLIST_FOREACH.3 +man3/atanl.3 +man3/argz_add_sep.3 +man3/rpc.3 +man3/argz_create_sep.3 man3/carg.3 -man3/wcscspn.3 -man3/drand48.3 -man3/le32toh.3 -man3/clnt_perrno.3 -man3/logl.3 -man3/csqrtl.3 -man3/tcsendbreak.3 -man3/xcrypt.3 -man3/strrchr.3 -man3/ctanhf.3 -man3/strtold.3 -man3/strcspn.3 -man3/endttyent.3 -man3/getwd.3 -man3/openlog.3 -man3/argz_create.3 -man3/ptsname_r.3 -man3/popen.3 -man3/svcfd_create.3 -man3/argz_delete.3 -man3/exp2f.3 -man3/mq_unlink.3 -man3/sigvec.3 -man3/ualarm.3 -man3/sqrtl.3 -man3/qecvt.3 -man3/log2l.3 -man3/tdelete.3 -man3/htobe32.3 -man3/cosh.3 -man3/regerror.3 -man3/coshl.3 -man3/cfgetispeed.3 -man3/abort.3 -man3/pthread_setattr_default_np.3 -man3/byteorder.3 -man3/CIRCLEQ_INSERT_BEFORE.3 -man3/llrintl.3 -man3/getnetbyaddr.3 -man3/svc_sendreply.3 -man3/getifaddrs.3 -man3/CMSG_ALIGN.3 -man3/pthread_tryjoin_np.3 -man3/verrx.3 -man3/cargl.3 -man3/wcpncpy.3 -man3/nrand48_r.3 -man3/strfmon.3 -man3/getprotoent.3 -man3/vasprintf.3 -man3/sigandset.3 -man3/powl.3 -man3/ungetwc.3 -man3/strerror_r.3 -man3/memcpy.3 -man3/argz_append.3 -man3/getipnodebyname.3 -man3/sigblock.3 -man3/srandom_r.3 -man3/memmove.3 -man3/CPU_COUNT_S.3 -man3/fcvt.3 -man3/vsscanf.3 -man3/bswap_16.3 -man3/gsignal.3 -man3/getdtablesize.3 -man3/ctanhl.3 +man3/sinf.3 man3/fflush_unlocked.3 -man3/isinff.3 -man3/mktime.3 -man3/mblen.3 -man3/__ppc_get_timebase.3 -man3/inet_aton.3 -man3/gnu_get_libc_version.3 -man3/mtrace.3 -man3/isnan.3 -man3/futimens.3 -man3/dn_comp.3 -man3/NAN.3 +man3/freelocale.3 +man3/btowc.3 +man3/fedisableexcept.3 +man3/get_nprocs.3 +man3/feclearexcept.3 +man3/svcerr_progvers.3 +man3/isgraph.3 +man3/mkdtemp.3 man3/putwchar_unlocked.3 -man3/jrand48.3 -man3/mallinfo.3 -man3/login.3 -man3/getutline_r.3 -man3/xdrrec_create.3 -man3/euidaccess.3 -man3/pthread_self.3 -man3/svcudp_create.3 -man3/y0f.3 -man3/getnetbyaddr_r.3 -man3/endprotoent.3 -man3/svcerr_noproc.3 -man3/rpc.3 +man3/acosl.3 man3/qsort.3 -man3/getwc_unlocked.3 -man3/getgrouplist.3 -man3/gethostbyaddr_r.3 -man3/xdr_char.3 -man3/memrchr.3 -man3/rand_r.3 -man3/HUGE_VALL.3 -man3/svc_run.3 -man3/acosf.3 -man3/LIST_INSERT_AFTER.3 -man3/sigisemptyset.3 -man3/cacoshf.3 -man3/clock.3 -man3/jnl.3 -man3/minor.3 +man3/twalk_r.3 +man3/iswblank.3 +man3/TAILQ_CONCAT.3 +man3/getdate.3 +man3/pvalloc.3 +man3/towlower.3 +man3/wmempcpy.3 +man3/dn_comp.3 +man3/wmemset.3 +man3/shm_open.3 +man3/ntp_adjtime.3 +man3/lrintf.3 +man3/nextdownl.3 +man3/cosh.3 +man3/mq_setattr.3 +man3/pthread_attr_getstacksize.3 +man3/wcsrtombs.3 +man3/setaliasent.3 +man3/div.3 +man3/argz_extract.3 man3/fpurge.3 -man3/if_nametoindex.3 -man3/nextupf.3 -man3/timezone.3 -man3/pathconf.3 -man3/log1pf.3 -man3/pmap_set.3 -man3/swapcontext.3 -man3/htobe64.3 -man3/sigismember.3 +man3/verr.3 +man3/nextupl.3 +man3/expl.3 +man3/fputc_unlocked.3 +man3/catan.3 +man3/hcreate.3 +man3/gets.3 +man3/pmap_rmtcall.3 +man3/res_nquery.3 +man3/fprintf.3 +man3/getprotobyname_r.3 +man3/ctanf.3 +man3/acoshl.3 +man3/xdr_char.3 +man3/ceilf.3 +man3/crealf.3 +man3/STAILQ_FIRST.3 +man3/strtoull.3 +man3/pow10l.3 +man3/des_setparity.3 +man3/nrand48.3 +man3/scalbnl.3 +man3/setbuf.3 +man3/mktemp.3 +man3/nexttowardf.3 +man3/lfind.3 +man3/rintl.3 +man3/ctanl.3 +man3/key_setsecret.3 +man3/longjmp.3 man3/setstate.3 -man3/feraiseexcept.3 -man3/gai_strerror.3 -man3/pthread_mutexattr_getrobust.3 -man3/CPU_ALLOC.3 -man3/fesetround.3 -man3/csqrt.3 -man3/endaliasent.3 +man3/SLIST_NEXT.3 +man3/iswprint.3 man3/__malloc_hook.3 -man3/cfsetospeed.3 -man3/memfrob.3 -man3/strtok.3 -man3/pthread_setcancelstate.3 -man3/mbsrtowcs.3 -man3/sincosf.3 -man3/aio_return.3 -man3/finite.3 -man3/xdr_void.3 -man3/sem_trywait.3 -man3/dremf.3 -man3/fcvt_r.3 -man3/localtime.3 -man3/j0f.3 +man3/getutxent.3 +man3/getnetbyaddr_r.3 +man3/tcsetattr.3 +man3/sigfillset.3 +man3/fopen.3 +man3/strtoumax.3 +man3/isunordered.3 +man3/sqrt.3 man3/versionsort.3 +man3/pthread_attr_setschedparam.3 +man3/pthread_attr_setstacksize.3 +man3/CPU_SET.3 +man3/gethostbyname.3 +man3/iconv.3 +man3/opterr.3 +man3/lio_listio.3 +man3/unlockpt.3 +man3/strtoul.3 +man3/logl.3 +man3/daylight.3 +man3/copysignl.3 +man3/cimag.3 +man3/rint.3 +man3/asin.3 +man3/islessequal.3 +man3/pthread_detach.3 +man3/feenableexcept.3 +man3/fmemopen.3 +man3/stderr.3 +man3/strtoimax.3 +man3/telldir.3 +man3/res_nclose.3 +man3/__setfpucw.3 +man3/getpwuid.3 +man3/login.3 man3/isnanl.3 -man3/inet.3 -man3/towupper_l.3 -man3/memccpy.3 -man3/pthread_attr_getstacksize.3 -man3/setutent.3 -man3/strtof.3 -man3/res_nquery.3 -man3/erand48.3 -man3/gammal.3 -man3/exit.3 -man3/xdr.3 -man3/strverscmp.3 -man3/getmntent.3 -man3/__ppc_set_ppr_med_high.3 -man3/posix_fallocate.3 -man3/abs.3 -man3/intro.3 -man3/strpbrk.3 -man3/argz_add_sep.3 +man3/fts.3 +man3/pthread_attr_getschedpolicy.3 +man3/__fpending.3 +man3/nextdownf.3 +man3/fgets_unlocked.3 +man3/printf.3 +man3/shm_unlink.3 +man3/readdir_r.3 +man3/endutent.3 +man3/lgammal.3 +man3/iswdigit.3 +man3/atan2f.3 +man3/optopt.3 +man3/asctime.3 +man3/nextdown.3 +man3/mbsrtowcs.3 +man3/strerror.3 +man3/gnu_get_libc_release.3 +man3/mkfifo.3 man3/pthread_spin_unlock.3 -man3/setusershell.3 -man3/gai_suspend.3 -man3/strfry.3 -man3/vprintf.3 -man3/fcloseall.3 -man3/csinhf.3 -man3/pthread_spin_init.3 -man3/pthread_sigqueue.3 -man3/STAILQ_REMOVE.3 -man3/__after_morecore_hook.3 -man3/exec.3 -man3/mcheck.3 -man3/uselocale.3 -man3/pmap_unset.3 -man3/islessequal.3 -man3/pthread_mutexattr_getrobust_np.3 -man3/remainderf.3 -man3/rresvport_af.3 -man3/getchar.3 -man3/tzset.3 -man3/wprintf.3 -man3/sincosl.3 -man3/nanl.3 -man3/wcsrtombs.3 -man3/getaliasent.3 +man3/svcerr_systemerr.3 +man3/__fwriting.3 +man3/gsignal.3 +man3/atoi.3 +man3/psiginfo.3 +man3/pthread_getname_np.3 +man3/srandom.3 +man3/labs.3 +man3/confstr.3 +man3/eventfd_read.3 +man3/getaliasent_r.3 +man3/clearenv.3 +man3/rawmemchr.3 +man3/inet_network.3 +man3/sigdelset.3 +man3/sighold.3 +man3/fnmatch.3 +man3/strcmp.3 +man3/duplocale.3 +man3/log1p.3 +man3/ntp_gettimex.3 +man3/fwide.3 +man3/htole16.3 +man3/pthread_attr_destroy.3 +man3/wcswidth.3 +man3/creall.3 +man3/sigvec.3 +man3/log10f.3 +man3/adjtime.3 +man3/wcstok.3 +man3/__ppc_get_timebase.3 +man3/getfsent.3 +man3/isgraph_l.3 +man3/setlogmask.3 +man3/pthread_exit.3 +man3/rexec_af.3 +man3/sigstack.3 +man3/popen.3 +man3/asinl.3 +man3/fegetround.3 +man3/feholdexcept.3 +man3/timerisset.3 +man3/getutxline.3 +man3/wcwidth.3 +man3/endservent.3 +man3/logout.3 +man3/ynf.3 +man3/endprotoent.3 +man3/lldiv.3 +man3/getentropy.3 +man3/CMSG_DATA.3 +man3/memcpy.3 +man3/feof.3 +man3/mrand48.3 +man3/ispunct_l.3 +man3/fesetround.3 +man3/log1pl.3 +man3/openpty.3 +man3/ispunct.3 +man3/aio_init.3 +man3/fegetexceptflag.3 +man3/cabsl.3 +man3/j1.3 +man3/catanl.3 +man3/TAILQ_REMOVE.3 +man3/CIRCLEQ_HEAD.3 +man3/casinf.3 +man3/fpclassify.3 +man3/cpowf.3 +man3/ualarm.3 +man3/inet_ntoa.3 +man3/fgetgrent_r.3 +man3/pthread_setattr_default_np.3 +man3/getutid_r.3 +man3/log10l.3 +man3/xdr_vector.3 +man3/getpwuid_r.3 +man3/getpt.3 +man3/trunc.3 +man3/stdout.3 +man3/xdr_pointer.3 +man3/sigsetmask.3 +man3/pthread_attr_getguardsize.3 +man3/sin.3 +man3/getutmp.3 man3/getauxval.3 +man3/isspace_l.3 +man3/fseeko.3 +man3/xdr_void.3 +man3/fgets.3 +man3/getutline.3 +man3/sincosf.3 +man3/iruserok.3 +man3/STAILQ_REMOVE_HEAD.3 +man3/cbc_crypt.3 +man3/FD_SET.3 +man3/pthread_getattr_default_np.3 +man3/cprojl.3 +man3/klogctl.3 +man3/CPU_XOR_S.3 +man3/TAILQ_HEAD.3 +man3/getservent.3 +man3/sqrtf.3 +man3/getgrent.3 +man3/svc_destroy.3 +man3/rtnetlink.3 +man3/wcrtomb.3 +man3/llrint.3 +man3/error_one_per_line.3 man3/xdrstdio_create.3 -man3/getsubopt.3 -man3/ulckpwdf.3 -man3/tmpnam_r.3 -man3/xdr_bool.3 -man3/flockfile.3 man3/fenv.3 -man3/significandl.3 -man3/pmap_getport.3 -man3/cfsetspeed.3 -man3/telldir.3 -man3/CPU_AND.3 -man3/xdr_pmap.3 -man3/TAILQ_HEAD.3 -man3/getprotobynumber.3 -man3/iconv_open.3 -man3/getdelim.3 -man3/pthread_getname_np.3 -man3/lgammaf.3 -man3/getutline.3 -man3/ntohs.3 -man3/islower_l.3 -man3/scandir.3 -man3/isdigit.3 -man3/malloc_hook.3 -man3/funlockfile.3 -man3/siggetmask.3 -man3/ffs.3 -man3/free.3 +man3/res_nquerydomain.3 +man3/registerrpc.3 +man3/getprotoent.3 +man3/fts_children.3 +man3/log.3 +man3/fminf.3 +man3/getopt.3 +man3/fputwc.3 +man3/isnanf.3 +man3/posix_spawn.3 +man3/wmemcpy.3 +man3/memalign.3 +man3/getnameinfo.3 +man3/scalblnl.3 +man3/getlogin.3 +man3/seekdir.3 +man3/pmap_getmaps.3 +man3/tanf.3 +man3/inet_aton.3 +man3/globfree.3 +man3/pthread_attr_getaffinity_np.3 +man3/ruserok.3 +man3/ntp_gettime.3 +man3/iswcntrl.3 +man3/malloc.3 +man3/signgam.3 +man3/LIST_INSERT_BEFORE.3 +man3/envz_remove.3 +man3/pthread_attr_setaffinity_np.3 +man3/cmsg.3 +man3/iswctype.3 +man3/clog10f.3 +man3/dlmopen.3 +man3/memcmp.3 +man3/CPU_EQUAL_S.3 +man3/strcpy.3 +man3/timeradd.3 +man3/FD_ISSET.3 +man3/putwc.3 +man3/clog.3 +man3/htonl.3 +man3/envz_strip.3 +man3/byteorder.3 +man3/asinf.3 +man3/getrpcbyname_r.3 +man3/pclose.3 +man3/fma.3 man3/getpwent_r.3 -man3/pthread_attr_setschedparam.3 -man3/wmemchr.3 -man3/SLIST_INSERT_HEAD.3 -man3/inet_makeaddr.3 -man3/getttyent.3 -man3/casinhl.3 -man3/grantpt.3 -man3/rresvport.3 -man3/expl.3 -man3/asinhl.3 -man3/STAILQ_INSERT_AFTER.3 -man3/setkey.3 -man3/HUGE_VAL.3 -man3/regfree.3 +man3/pthread_spin_lock.3 +man3/nextafterf.3 +man3/pthread_mutexattr_init.3 +man3/towctrans.3 man3/ftell.3 -man3/cacoshl.3 -man3/gcvt.3 -man3/optarg.3 -man3/pthread_join.3 -man3/atan2l.3 -man3/getdate.3 -man3/tgammal.3 -man3/putwchar.3 -man3/sethostent.3 -man3/ntp_gettime.3 -man3/pthread_attr_getstack.3 -man3/raise.3 +man3/wcstoimax.3 +man3/pthread_cleanup_pop_restore_np.3 +man3/closelog.3 +man3/sigorset.3 +man3/dirname.3 +man3/tolower_l.3 +man3/secure_getenv.3 +man3/aio_return.3 +man3/HUGE_VALF.3 +man3/SLIST_HEAD_INITIALIZER.3 +man3/ctan.3 +man3/xdecrypt.3 +man3/svc_freeargs.3 +man3/ecvt_r.3 +man3/exp2.3 +man3/cexp.3 +man3/fwrite_unlocked.3 +man3/SLIST_INSERT_AFTER.3 +man3/strfromd.3 +man3/CPU_OR_S.3 +man3/ssignal.3 +man3/sigqueue.3 +man3/vasprintf.3 +man3/getpwnam.3 +man3/setnetent.3 +man3/nanf.3 +man3/svc_run.3 +man3/ilogbf.3 +man3/clnt_destroy.3 +man3/tmpnam_r.3 +man3/csqrtl.3 +man3/lroundf.3 +man3/pthread_getcpuclockid.3 +man3/tcflush.3 +man3/towupper.3 +man3/FD_ZERO.3 +man3/isfdtype.3 +man3/iswupper.3 +man3/eaccess.3 +man3/fgetpwent_r.3 +man3/expm1l.3 +man3/pthread_atfork.3 +man3/CPU_ISSET_S.3 +man3/pthread_spin_destroy.3 +man3/srand48_r.3 +man3/pthread_getschedparam.3 +man3/scalb.3 +man3/canonicalize_file_name.3 +man3/getpwent.3 +man3/setkey.3 +man3/svcfd_create.3 +man3/__ppc_set_ppr_low.3 +man3/ttyname_r.3 +man3/pthread_mutexattr_getpshared.3 +man3/logf.3 +man3/regerror.3 +man3/putenv.3 +man3/ccosf.3 +man3/wcstoumax.3 +man3/getwc.3 +man3/endutxent.3 +man3/strtok.3 +man3/pthread_getaffinity_np.3 +man3/xdr_int.3 +man3/xdr_u_int.3 +man3/xdr_destroy.3 +man3/inet_net_pton.3 +man3/cexpf.3 +man3/vfscanf.3 +man3/ccoshl.3 +man3/finitel.3 +man3/sigpause.3 +man3/TAILQ_INSERT_AFTER.3 +man3/mbrlen.3 +man3/mkostemp.3 +man3/getlogin_r.3 +man3/frexpf.3 +man3/erf.3 +man3/setmntent.3 man3/pthread_cleanup_push_defer_np.3 +man3/reallocarray.3 +man3/clock_settime.3 +man3/clnt_freeres.3 +man3/memset.3 +man3/xdr_u_long.3 +man3/siggetmask.3 +man3/optarg.3 +man3/srand48.3 +man3/sigisemptyset.3 +man3/xprt_register.3 +man3/strcoll.3 +man3/gai_error.3 +man3/nextafter.3 +man3/setfsent.3 +man3/setprotoent.3 +man3/endhostent.3 +man3/getgrnam_r.3 +man3/wprintf.3 +man3/sinhf.3 +man3/statvfs.3 +man3/ffsll.3 +man3/pthread_spin_init.3 +man3/strstr.3 +man3/roundl.3 +man3/getmntent.3 +man3/y0l.3 +man3/wcsnlen.3 +man3/memccpy.3 +man3/xcrypt.3 +man3/LIST_FOREACH.3 +man3/mrand48_r.3 +man3/getnetgrent_r.3 +man3/mkfifoat.3 +man3/inet.3 +man3/major.3 +man3/endgrent.3 +man3/cfsetospeed.3 man3/exp2l.3 -man3/erfcf.3 -man3/modf.3 -man3/tcgetpgrp.3 +man3/scalbf.3 +man3/TAILQ_INSERT_TAIL.3 +man3/catanhf.3 +man3/dlerror.3 +man3/xdr_rejected_reply.3 +man3/getutid.3 +man3/dbopen.3 +man3/getprotobyname.3 +man3/sem_post.3 +man3/fseek.3 +man3/stdin.3 +man3/STAILQ_INSERT_TAIL.3 man3/csin.3 +man3/ttyslot.3 +man3/exp10.3 +man3/unlocked_stdio.3 +man3/__flbf.3 +man3/isxdigit.3 +man3/fetestexcept.3 +man3/getprotoent_r.3 +man3/gethostbyname_r.3 +man3/log10.3 man3/updwtmpx.3 -man3/backtrace.3 -man3/lrand48_r.3 -man3/sigsetops.3 -man3/sgetspent.3 -man3/profil.3 -man3/random.3 -man3/svcraw_create.3 -man3/imaxdiv.3 -man3/putc.3 -man3/CMSG_SPACE.3 -man3/wcsstr.3 -man3/ispunct.3 -man3/fesetenv.3 -man3/tanh.3 -man3/fgetgrent_r.3 -man3/getpass.3 -man3/get_nprocs_conf.3 -man3/svc_getcaller.3 -man3/pthread_getschedparam.3 -man3/DES_FAILED.3 -man3/eaccess.3 -man3/putchar.3 -man3/xdr_u_char.3 -man3/strlen.3 -man3/STAILQ_INSERT_HEAD.3 -man3/endpwent.3 -man3/srand48_r.3 -man3/nextupl.3 -man3/getutmpx.3 -man3/ether_ntoa.3 -man3/qfcvt.3 -man3/vwarnx.3 -man3/CPU_XOR.3 -man3/ceilf.3 -man3/pthread_setaffinity_np.3 -man3/CIRCLEQ_INIT.3 -man3/getspent_r.3 -man3/if_freenameindex.3 -man3/getdirentries.3 -man3/CPU_ALLOC_SIZE.3 -man3/xdr_bytes.3 -man3/scandirat.3 -man3/j0l.3 -man3/malloc_info.3 -man3/inet_ntop.3 -man3/clock_getcpuclockid.3 -man3/xdr_inline.3 -man3/strndup.3 -man3/pthread_cleanup_pop.3 -man3/LIST_HEAD.3 -man3/isinfl.3 -man3/xdr_setpos.3 -man3/mq_getattr.3 -man3/setprotoent.3 -man3/sem_open.3 -man3/cabsf.3 -man3/fputs.3 -man3/bsearch.3 -man3/CPU_COUNT.3 -man3/mkostemps.3 -man3/localeconv.3 -man3/expm1f.3 -man3/clnt_freeres.3 -man3/getpwnam_r.3 -man3/futimes.3 -man3/fread_unlocked.3 -man3/dlvsym.3 -man3/eventfd_write.3 -man3/seed48_r.3 -man3/fmaf.3 -man3/aio_init.3 -man3/sigfillset.3 -man3/FD_SET.3 -man3/xdr_getpos.3 -man3/clnt_call.3 -man3/xencrypt.3 -man3/gethostent_r.3 -man3/envz_add.3 -man3/CMSG_DATA.3 -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 -man3/pow10l.3 -man3/errx.3 -man3/err.3 -man3/getdate_r.3 -man3/get_avphys_pages.3 -man3/asinl.3 -man3/ferror.3 -man3/nl_langinfo_l.3 +man3/powf.3 +man3/pthread_attr_setguardsize.3 +man3/nearbyintf.3 +man3/getipnodebyaddr.3 +man3/wcsnrtombs.3 +man3/xdr_pmaplist.3 +man3/atan.3 +man3/mcheck_pedantic.3 +man3/erfl.3 +man3/isatty.3 +man3/scandir.3 +man3/remainderf.3 +man3/endspent.3 +man3/fminl.3 +man3/mq_timedsend.3 +man3/hypotl.3 +man3/open_wmemstream.3 +man3/__ppc_yield.3 +man3/asctime_r.3 +man3/ether_hostton.3 +man3/cexpl.3 +man3/fmodl.3 +man3/swab.3 +man3/vwarn.3 +man3/sem_wait.3 +man3/__ppc_set_ppr_very_low.3 man3/remquof.3 -man3/vlimit.3 -man3/wctomb.3 -man3/if_nameindex.3 +man3/muntrace.3 +man3/getrpcbynumber_r.3 +man3/bindresvport.3 +man3/j1l.3 +man3/finitef.3 +man3/STAILQ_REMOVE.3 +man3/islower_l.3 +man3/h_errno.3 +man3/tgamma.3 +man3/tmpnam.3 +man3/ccosh.3 +man3/sockatmark.3 +man3/nextup.3 +man3/setrpcent.3 +man3/fputws_unlocked.3 +man3/cimagl.3 +man3/j1f.3 +man3/get_current_dir_name.3 +man3/mq_notify.3 +man3/getgrent_r.3 +man3/cexp2l.3 +man3/ether_ntoa_r.3 man3/utmpname.3 -man3/TAILQ_NEXT.3 -man3/pthread_setcanceltype.3 +man3/pthread_attr_setinheritsched.3 +man3/malloc_info.3 +man3/getutline_r.3 +man3/getutent.3 +man3/vwprintf.3 +man3/getnetbyname.3 +man3/remque.3 +man3/exec.3 +man3/futimes.3 +man3/gethostbyaddr_r.3 +man3/timersub.3 +man3/getmntent_r.3 +man3/csqrt.3 +man3/hstrerror.3 +man3/ungetc.3 +man3/gethostbyaddr.3 +man3/pthread_kill.3 +man3/wcsncmp.3 +man3/sem_open.3 +man3/inet_pton.3 +man3/svc_getreq.3 +man3/pthread_attr_init.3 +man3/svc_register.3 +man3/pthread_attr_getinheritsched.3 +man3/res_send.3 +man3/closedir.3 +man3/asinh.3 +man3/strxfrm.3 +man3/STAILQ_ENTRY.3 +man3/getgrouplist.3 +man3/asinhl.3 +man3/termios.3 +man3/exp.3 +man3/clog2.3 +man3/CPU_COUNT_S.3 +man3/crypt_r.3 +man3/makecontext.3 +man3/posix_spawnp.3 +man3/newlocale.3 +man3/pow10.3 +man3/hsearch_r.3 +man3/strndup.3 +man3/SLIST_INIT.3 man3/cbrtl.3 +man3/fputwc_unlocked.3 +man3/xdr_wrapstring.3 +man3/funlockfile.3 +man3/fputws.3 +man3/wmemchr.3 +man3/rcmd_af.3 +man3/getwchar.3 +man3/pthread_tryjoin_np.3 +man3/mbstowcs.3 +man3/rindex.3 +man3/sigismember.3 +man3/csqrtf.3 +man3/getservbyport_r.3 +man3/isinfl.3 +man3/lseek64.3 +man3/clog2l.3 man3/sleep.3 -man3/gets.3 -man3/fmtmsg.3 -man3/if_indextoname.3 -man3/readdir_r.3 -man3/iswdigit.3 -man3/argz_add.3 -man3/vwarn.3 -man3/getgrnam.3 -man3/getrpcbynumber_r.3 -man3/pthread_attr_getdetachstate.3 -man3/CPU_ISSET.3 -man3/pthread_kill_other_threads_np.3 -man3/endutent.3 -man3/LIST_NEXT.3 -man3/xdr_reference.3 -man3/puts.3 -man3/aio_error.3 -man3/mbtowc.3 -man3/__ppc_mdoom.3 -man3/pthread_rwlockattr_getkind_np.3 -man3/mmap64.3 -man3/pthread_getattr_default_np.3 -man3/sgetspent_r.3 -man3/error_message_count.3 +man3/SLIST_INSERT_HEAD.3 +man3/endpwent.3 +man3/twalk.3 +man3/jnf.3 +man3/cexp2f.3 +man3/fgetgrent.3 +man3/logbl.3 +man3/cproj.3 +man3/getnetbyname_r.3 +man3/xdr.3 +man3/isnormal.3 +man3/mempcpy.3 man3/erand48_r.3 -man3/pthread_yield.3 -man3/error_at_line.3 -man3/gnu_dev_major.3 -man3/wcslen.3 -man3/dn_expand.3 -man3/des_crypt.3 -man3/program_invocation_short_name.3 -man3/strcmp.3 -man3/mallopt.3 -man3/fgetwc.3 -man3/sem_destroy.3 -man3/argz_count.3 -man3/pthread_create.3 -man3/getpwuid.3 -man3/pthread_attr_getaffinity_np.3 -man3/TAILQ_ENTRY.3 -man3/sigset.3 -man3/clog10f.3 -man3/qfcvt_r.3 -man3/ilogb.3 -man3/res_init.3 -man3/CPU_CLR_S.3 -man3/iswpunct.3 -man3/ether_hostton.3 -man3/timelocal.3 -man3/dbopen.3 -man3/vsprintf.3 -man3/wmemmove.3 -man3/ffsl.3 -man3/svc_getreqset.3 -man3/clnt_perror.3 -man3/unlockpt.3 -man3/setrpcent.3 +man3/stdio_ext.3 +man3/profil.3 +man3/authunix_create.3 +man3/ceill.3 +man3/getumask.3 +man3/stpcpy.3 +man3/etext.3 +man3/strfroml.3 +man3/pthread_attr_getschedparam.3 +man3/xdr_callmsg.3 +man3/catopen.3 +man3/cargf.3 +man3/__fwritable.3 +man3/if_nametoindex.3 +man3/TAILQ_NEXT.3 +man3/getrpcbynumber.3 +man3/atan2l.3 +man3/pthread_rwlockattr_setkind_np.3 +man3/getttyent.3 +man3/pthread_getconcurrency.3 +man3/frexpl.3 +man3/TAILQ_INSERT_BEFORE.3 +man3/getutent_r.3 +man3/isgreaterequal.3 +man3/floor.3 +man3/svc_getcaller.3 +man3/setjmp.3 +man3/regfree.3 man3/dprintf.3 -man3/setfsent.3 -man3/jrand48_r.3 -man3/duplocale.3 -man3/registerrpc.3 -man3/xdrrec_endofrecord.3 -man3/clnt_geterr.3 -man3/cimagl.3 -man3/ptsname.3 -man3/aio_write.3 -man3/coshf.3 -man3/strfromd.3 -man3/iswxdigit.3 -man3/sched_getcpu.3 -man3/ecvt.3 -man3/fputs_unlocked.3 -man3/res_mkquery.3 -man3/endnetent.3 -man3/xdrrec_skiprecord.3 +man3/mq_unlink.3 +man3/getchar_unlocked.3 +man3/__ppc_mdoio.3 +man3/pow10f.3 +man3/pthread_mutexattr_getrobust_np.3 man3/putc_unlocked.3 -man3/SLIST_REMOVE.3 -man3/gethostbyname2_r.3 -man3/srandom.3 -man3/ether_aton_r.3 -man3/__fpending.3 -man3/putchar_unlocked.3 -man3/localtime_r.3 -man3/lgammal.3 -man3/getaliasbyname_r.3 -man3/fopencookie.3 -man3/iruserok_af.3 -man3/bzero.3 -man3/fedisableexcept.3 -man3/stpcpy.3 -man3/imaxabs.3 -man3/HUGE_VALF.3 -man3/aio_read.3 -man3/res_nsearch.3 -man3/pthread_attr_init.3 -man3/getgrent_r.3 -man3/LIST_HEAD_INITIALIZER.3 -man3/scalblnf.3 -man3/twalk_r.3 -man3/mq_receive.3 -man3/lgammaf_r.3 -man3/execle.3 -man3/qgcvt.3 -man3/sigqueue.3 -man3/regex.3 -man3/getc_unlocked.3 -man3/gai_cancel.3 -man3/twalk.3 -man3/strxfrm.3 -man3/truncf.3 -man3/ntp_adjtime.3 -man3/fts_set.3 -man3/iscntrl_l.3 -man3/SLIST_ENTRY.3 -man3/CPU_ZERO.3 -man3/pclose.3 -man3/updwtmp.3 -man3/index.3 -man3/pthread_testcancel.3 -man3/STAILQ_FOREACH.3 -man3/wcsnlen.3 -man3/sethostid.3 -man3/lrint.3 -man3/pututline.3 -man3/wcscasecmp.3 -man3/setutxent.3 -man3/tanhf.3 -man3/strncpy.3 -man3/lcong48_r.3 -man3/nearbyintl.3 -man3/TAILQ_INSERT_TAIL.3 -man3/SLIST_NEXT.3 -man3/CMSG_NXTHDR.3 -man3/j1f.3 -man3/getopt_long.3 +man3/forkpty.3 +man3/getsubopt.3 +man3/j0.3 +man3/encrypt_r.3 man3/atan2.3 +man3/vfwprintf.3 +man3/iswalnum.3 +man3/LIST_REMOVE.3 +man3/pthread_setschedprio.3 +man3/ecb_crypt.3 +man3/getpass.3 +man3/pthread_sigmask.3 man3/getnetent.3 -man3/csqrtf.3 -man3/floorl.3 -man3/psignal.3 -man3/pthread_setschedparam.3 +man3/tdestroy.3 man3/y1f.3 -man3/feenableexcept.3 -man3/__fwriting.3 -man3/malloc_usable_size.3 -man3/fma.3 -man3/TAILQ_SWAP.3 -man3/asinhf.3 -man3/execvpe.3 -man3/gethostbyname2.3 -man3/iswalnum.3 -man3/perror.3 -man3/canonicalize_file_name.3 -man3/xdr_vector.3 -man3/cprojf.3 -man3/pthread_setconcurrency.3 -man3/freeaddrinfo.3 -man3/CPU_AND_S.3 -man3/TAILQ_CONCAT.3 -man3/clog2f.3 -man3/aio_cancel.3 -man3/__fwritable.3 -man3/tcgetsid.3 -man3/atoll.3 -man3/getumask.3 -man3/strdup.3 -man3/wmempcpy.3 -man3/xdr_int.3 -man3/endspent.3 -man3/fabs.3 -man3/pthread_attr_getschedparam.3 -man3/svcerr_decode.3 -man3/xprt_register.3 -man3/asin.3 -man3/tgamma.3 -man3/swprintf.3 -man3/towlower_l.3 -man3/strtoul.3 +man3/getrpcbyname.3 +man3/isblank_l.3 +man3/floorl.3 +man3/TAILQ_FOREACH_REVERSE.3 +man3/pthread_mutex_consistent.3 +man3/setvbuf.3 +man3/exp10f.3 +man3/getgrgid.3 +man3/wcpncpy.3 +man3/realpath.3 +man3/ferror.3 +man3/rand_r.3 +man3/herror.3 +man3/aligned_alloc.3 +man3/setusershell.3 +man3/pthread_self.3 +man3/pthread_cleanup_push.3 man3/hypotf.3 -man3/vwprintf.3 -man3/fegetenv.3 -man3/tcsetattr.3 -man3/ttyname_r.3 -man3/mpool.3 -man3/fseeko.3 -man3/wctrans.3 -man3/mkfifoat.3 -man3/pthread_timedjoin_np.3 -man3/sem_post.3 -man3/ldexp.3 -man3/bcopy.3 -man3/FD_CLR.3 -man3/program_invocation_name.3 -man3/putw.3 -man3/mbstowcs.3 -man3/strerror.3 -man3/getspent.3 -man3/htons.3 -man3/iswblank.3 -man3/clnt_sperrno.3 -man3/fnmatch.3 -man3/cmsg.3 -man3/clnt_create.3 -man3/ctanl.3 -man3/cexpf.3 -man3/lgammal_r.3 -man3/fminf.3 -man3/CPU_EQUAL_S.3 -man3/fgetws.3 -man3/getcwd.3 -man3/printf.3 -man3/fstatvfs.3 -man3/res_send.3 -man3/wcpcpy.3 -man3/ctime_r.3 -man3/strerror_l.3 -man3/nan.3 -man3/getpwent.3 -man4/hd.4 +man3/creal.3 +man3/edata.3 +man3/ptsname_r.3 +man3/pututxline.3 +man3/fpathconf.3 +man3/open_memstream.3 +man3/getdate_err.3 +man3/matherr.3 +man3/INFINITY.3 +man3/gnu_get_libc_version.3 +man3/svcudp_bufcreate.3 +man3/string.3 +man3/va_arg.3 +man3/wcsrchr.3 +man3/pthread_attr_getstack.3 +man3/xdr_long.3 +man3/svc_unregister.3 +man3/modf.3 +man3/authunix_create_default.3 +man3/daemon.3 +man3/clnt_control.3 +man3/killpg.3 +man3/mkstemps.3 +man3/nanl.3 +man3/swapcontext.3 +man3/toupper_l.3 +man3/ldiv.3 +man3/xdr_float.3 +man3/putspent.3 +man3/NAN.3 +man3/isalnum.3 +man3/srandom_r.3 +man3/iscntrl_l.3 +man3/CMSG_FIRSTHDR.3 +man3/sem_timedwait.3 +man3/lcong48_r.3 +man3/conj.3 +man3/getspnam.3 +man3/system.3 +man3/wcscpy.3 +man3/ulimit.3 +man3/posix_memalign.3 +man3/TAILQ_SWAP.3 +man3/clnt_pcreateerror.3 +man3/llrintl.3 +man3/clogl.3 +man3/erff.3 +man3/ftw.3 +man3/regex.3 +man3/mbrtowc.3 +man3/utmpxname.3 +man3/argz.3 +man3/error.3 +man3/isblank.3 +man3/tanhl.3 +man3/freeifaddrs.3 +man3/getaliasbyname.3 +man3/__malloc_initialize_hook.3 +man3/xdr_bytes.3 +man3/csinhf.3 +man3/ether_ntoa.3 +man3/endusershell.3 +man3/clock_getres.3 +man3/initstate.3 +man3/fsetpos.3 +man3/rewind.3 man4/ptmx.4 -man4/intro.4 -man4/console_codes.4 -man4/smartpqi.4 -man4/tty.4 -man4/tty_ioctl.4 -man4/fd.4 -man4/mouse.4 -man4/kmem.4 -man4/vcsa.4 +man4/ttyS.4 +man4/dsp56k.4 +man4/port.4 +man4/ram.4 man4/veth.4 +man4/st.4 man4/loop.4 -man4/null.4 -man4/vcs.4 -man4/ram.4 -man4/cpuid.4 -man4/urandom.4 -man4/fuse.4 -man4/mem.4 -man4/console_ioctl.4 -man4/cciss.4 man4/wavelan.4 +man4/sk98lin.4 +man4/loop-control.4 +man4/hd.4 man4/rtc.4 -man4/ttyS.4 +man4/random.4 +man4/mouse.4 +man4/kmem.4 +man4/console_codes.4 +man4/pts.4 +man4/vcs.4 +man4/tty_ioctl.4 +man4/fuse.4 +man4/lp.4 +man4/smartpqi.4 +man4/cpuid.4 man4/full.4 -man4/loop-control.4 -man4/lirc.4 +man4/intro.4 +man4/fd.4 man4/initrd.4 -man4/pts.4 -man4/port.4 -man4/hpsa.4 -man4/msr.4 man4/sd.4 -man4/dsp56k.4 -man4/sk98lin.4 -man4/random.4 +man4/lirc.4 +man4/cciss.4 +man4/tty.4 +man4/msr.4 man4/zero.4 -man4/st.4 -man4/lp.4 -man5/procfs.5 -man5/host.conf.5 -man5/tmpfs.5 -man5/nscd.conf.5 -man5/hosts.equiv.5 -man5/resolver.5 +man4/null.4 +man4/urandom.4 +man4/hpsa.4 +man4/vcsa.4 +man4/mem.4 +man4/console_ioctl.4 +man5/ftpusers.5 +man5/dir_colors.5 +man5/sysfs.5 +man5/securetty.5 +man5/nss.5 +man5/core.5 +man5/locale.5 +man5/motd.5 +man5/utmp.5 man5/passwd.5 -man5/hosts.5 -man5/charmap.5 -man5/ttytype.5 man5/nsswitch.conf.5 -man5/core.5 +man5/gai.conf.5 +man5/intro.5 +man5/fs.5 +man5/hosts.equiv.5 +man5/elf.5 +man5/resolv.conf.5 man5/utmpx.5 -man5/tzfile.5 -man5/attr.5 -man5/securetty.5 -man5/nologin.5 +man5/wtmp.5 +man5/nscd.conf.5 +man5/termcap.5 man5/slabinfo.5 -man5/group.5 -man5/proc.5 -man5/resolv.conf.5 -man5/dir_colors.5 -man5/utmp.5 +man5/repertoiremap.5 +man5/ttytype.5 man5/shells.5 -man5/wtmp.5 -man5/fs.5 -man5/locale.5 -man5/ftpusers.5 -man5/sysfs.5 -man5/services.5 +man5/protocols.5 +man5/host.conf.5 +man5/charmap.5 man5/numa_maps.5 man5/issue.5 -man5/rpc.5 -man5/nss.5 -man5/intro.5 -man5/elf.5 +man5/resolver.5 +man5/attr.5 man5/networks.5 -man5/protocols.5 -man5/acct.5 -man5/termcap.5 -man5/motd.5 -man5/repertoiremap.5 man5/filesystems.5 -man5/gai.conf.5 +man5/hosts.5 +man5/procfs.5 +man5/tzfile.5 +man5/group.5 +man5/rpc.5 +man5/acct.5 +man5/proc.5 +man5/tmpfs.5 +man5/nologin.5 +man5/services.5 man6/intro.6 -man7/termio.7 -man7/iso-8859-4.7 -man7/shm_overview.7 -man7/latin4.7 -man7/fanotify.7 -man7/uri.7 +man7/uts_namespaces.7 man7/user_namespaces.7 -man7/iso_8859_9.7 -man7/socket.7 -man7/iso_8859-4.7 -man7/latin5.7 -man7/sched.7 -man7/iso_8859-15.7 -man7/ip.7 -man7/latin7.7 -man7/iso-8859-2.7 -man7/armscii-8.7 -man7/iso_8859_15.7 -man7/locale.7 -man7/vdso.7 -man7/feature_test_macros.7 -man7/iso-8859-5.7 -man7/network_namespaces.7 -man7/iso_8859_4.7 -man7/man.7 -man7/persistent-keyring.7 -man7/sysvipc.7 -man7/time.7 -man7/iso_8859-9.7 -man7/sigevent.7 -man7/numa.7 -man7/iso_8859_7.7 -man7/vsock.7 -man7/url.7 -man7/tis-620.7 -man7/iso-8859-6.7 -man7/tcp.7 -man7/sock_diag.7 man7/iso_8859_1.7 -man7/pthreads.7 -man7/inode.7 -man7/intro.7 -man7/ipv6.7 -man7/iso-8859-8.7 -man7/environ.7 -man7/pkeys.7 +man7/iso_8859-14.7 +man7/iso_8859_11.7 +man7/glob.7 +man7/iso_8859-8.7 +man7/iso-8859-10.7 +man7/charsets.7 +man7/netdevice.7 man7/posixoptions.7 -man7/attributes.7 -man7/urn.7 -man7/sem_overview.7 -man7/bpf-helpers.7 -man7/precedence.7 man7/process-keyring.7 -man7/iso_8859-10.7 -man7/iso_8859_14.7 -man7/unicode.7 -man7/latin1.7 -man7/time_namespaces.7 -man7/regex.7 -man7/iso_8859_10.7 -man7/iso_8859_2.7 -man7/rtld-audit.7 +man7/suffixes.7 +man7/iso_8859_7.7 +man7/credentials.7 +man7/netlink.7 +man7/iso_8859-6.7 +man7/pipe.7 +man7/cp1252.7 +man7/latin10.7 +man7/address_families.7 +man7/latin3.7 +man7/latin5.7 +man7/latin2.7 man7/session-keyring.7 -man7/futex.7 +man7/latin8.7 +man7/socket.7 +man7/iso-8859-9.7 +man7/namespaces.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 -man7/netdevice.7 -man7/iso_8859-16.7 man7/cgroups.7 -man7/libc.7 +man7/udp.7 +man7/bpf-helpers.7 +man7/tcp.7 +man7/ipc_namespaces.7 +man7/sem_overview.7 +man7/environ.7 +man7/termio.7 +man7/url.7 +man7/iso_8859_6.7 +man7/iso_8859_10.7 +man7/armscii-8.7 +man7/sysvipc.7 +man7/aio.7 man7/hier.7 +man7/iso_8859-1.7 man7/operator.7 -man7/path_resolution.7 -man7/boot.7 -man7/iso_8859-2.7 -man7/iso_8859-6.7 -man7/xattr.7 -man7/iso-8859-1.7 -man7/iso_8859-14.7 -man7/iso-8859-14.7 -man7/math_error.7 -man7/cp1252.7 -man7/fifo.7 -man7/udp.7 -man7/cpuset.7 -man7/iso-8859-10.7 -man7/koi8-r.7 -man7/epoll.7 -man7/capabilities.7 -man7/complex.7 -man7/iso-8859-3.7 -man7/mailaddr.7 -man7/hostname.7 -man7/iso_8859-8.7 -man7/iso_8859-13.7 +man7/glibc.7 +man7/cp1251.7 +man7/vdso.7 man7/keyrings.7 -man7/packet.7 -man7/signal-safety.7 -man7/netlink.7 man7/iso_8859_3.7 -man7/raw.7 -man7/koi8-u.7 -man7/arp.7 -man7/utf-8.7 -man7/glob.7 -man7/pid_namespaces.7 -man7/spufs.7 -man7/svipc.7 -man7/inotify.7 +man7/iso-8859-2.7 man7/iso_8859_13.7 -man7/iso_8859-3.7 -man7/address_families.7 -man7/suffixes.7 +man7/packet.7 +man7/ipv6.7 +man7/regex.7 +man7/iso_8859-13.7 +man7/symlink.7 +man7/latin9.7 +man7/unicode.7 +man7/iso_8859_16.7 man7/user-session-keyring.7 -man7/pipe.7 +man7/uri.7 +man7/iso-8859-1.7 +man7/unix.7 +man7/svipc.7 +man7/mount_namespaces.7 +man7/numa.7 +man7/iso-8859-11.7 +man7/mq_overview.7 +man7/iso-8859-8.7 +man7/iso_8859_2.7 +man7/iso_8859_4.7 +man7/pthreads.7 +man7/rtld-audit.7 +man7/iso-8859-6.7 +man7/mailaddr.7 +man7/iso_8859-11.7 +man7/pkeys.7 +man7/standards.7 +man7/complex.7 +man7/intro.7 +man7/nptl.7 +man7/precedence.7 +man7/iso-8859-7.7 +man7/ddp.7 man7/ascii.7 -man7/rtnetlink.7 +man7/time_namespaces.7 +man7/epoll.7 +man7/sched.7 +man7/pid_namespaces.7 +man7/udplite.7 +man7/feature_test_macros.7 +man7/libc.7 man7/cgroup_namespaces.7 -man7/pty.7 -man7/latin9.7 -man7/nptl.7 +man7/iso_8859-9.7 +man7/iso_8859-4.7 +man7/attributes.7 +man7/iso_8859_9.7 +man7/user-keyring.7 +man7/inode.7 +man7/thread-keyring.7 +man7/x25.7 +man7/utf-8.7 +man7/rtnetlink.7 +man7/math_error.7 +man7/iso_8859_14.7 +man7/inotify.7 +man7/iso_8859-7.7 +man7/iso_8859-2.7 +man7/urn.7 +man7/arp.7 +man7/capabilities.7 +man7/time.7 +man7/iso_8859-15.7 man7/icmp.7 -man7/iso_8859-1.7 -man7/utf8.7 -man7/iso-8859-7.7 -man7/latin10.7 +man7/iso-8859-3.7 +man7/iso-8859-4.7 man7/units.7 -man7/unix.7 -man7/symlink.7 -man7/latin3.7 +man7/hostname.7 +man7/koi8-u.7 +man7/sock_diag.7 +man7/iso-8859-16.7 +man7/iso_8859-10.7 +man7/cpuset.7 +man7/iso_8859-16.7 +man7/raw.7 +man7/boot.7 +man7/xattr.7 +man7/locale.7 man7/signal.7 -man7/iso_8859-11.7 -man7/glibc.7 -man7/aio.7 +man7/iso-8859-14.7 +man7/man.7 man7/iso_8859_8.7 -man7/cp1251.7 -man7/iso_8859_5.7 -man7/thread-keyring.7 -man7/mq_overview.7 -man7/iso-8859-11.7 -man7/credentials.7 -man7/iso_8859-5.7 +man7/koi8-r.7 +man7/spufs.7 +man7/utf8.7 man7/random.7 +man7/latin1.7 +man7/signal-safety.7 +man7/path_resolution.7 man7/iso-8859-15.7 +man7/vsock.7 +man7/shm_overview.7 +man7/latin4.7 +man7/persistent-keyring.7 +man7/latin7.7 man7/latin6.7 -man7/ddp.7 -man7/standards.7 -man7/iso_8859_11.7 -man7/latin8.7 -man7/iso-8859-9.7 -man7/user-keyring.7 +man7/tis-620.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 +man7/sigevent.7 +man7/iso-8859-5.7 +man7/ip.7 +man7/iso_8859_15.7 +man7/fifo.7 +man7/pty.7 man7/man-pages.7 -man8/sln.8 -man8/ld-linux.so.8 -man8/intro.8 -man8/nscd.8 +man7/network_namespaces.7 +man7/iso_8859-3.7 +man7/fanotify.7 +man7/iso_8859_5.7 +man7/iso_8859-5.7 +man7/futex.7 man8/ld.so.8 +man8/ldconfig.8 man8/zic.8 -man8/iconvconfig.8 -man8/tzselect.8 +man8/sln.8 man8/zdump.8 -man8/ldconfig.8 +man8/nscd.8 +man8/ld-linux.so.8 man8/ld-linux.8 +man8/tzselect.8 +man8/intro.8 +man8/iconvconfig.8 |