diff options
| author | Dr. Tobias Quathamer <toddy@debian.org> | 2020-12-22 14:17:52 +0100 |
|---|---|---|
| committer | Dr. Tobias Quathamer <toddy@debian.org> | 2020-12-22 14:17:52 +0100 |
| commit | 60e0e5507b2654323e8d44ce7131d967dfe62196 (patch) | |
| tree | 02062415e97250d5afeada9dbb99541131d0b07e | |
| parent | 212b080c7adfb336df87c83c15576334889b035e (diff) | |
| parent | 8af13bf9131922f57e856889122d5e5b29eef83c (diff) | |
Update upstream source from tag 'upstream/5.10'
Update to upstream version '5.10'
with Debian dir aa9a811c31617ac7f9d678983053cac816cc00a8
1076 files changed, 3697 insertions, 2365 deletions
@@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.09 ==================== +==================== Changes in man-pages-5.10 ==================== -Released: 2020-11-01, Munich +Released: 2020-12-21, Munich Contributors @@ -10,321 +10,74 @@ 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> -Alexey Budankov <alexey.budankov@linux.intel.com> +Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> +Alejandro Colomar <alx.manpages@gmail.com> Amir Goldstein <amir73il@gmail.com> -Carlos O'Donell <carlos@redhat.com> +Arusekk <arek_koz@o2.pl> +Baruch Siach <baruch@tkos.co.il> +Bill Allombert <ballombe@debian.org> +Colin Ian King <colin.king@canonical.com> Dave Martin <Dave.Martin@arm.com> -David Howells <dhowells@redhat.com> -David Laight <David.Laight@ACULAB.COM> -Dmitry V. Levin <ldv@altlinux.org> -Érico Rolim <erico.erc@gmail.com> -Florian Weimer <fweimer@redhat.com> -G. Branden Robinson <g.branden.robinson@gmail.com> -Hauke Fath <hf@spg.tu-darmstadt.de> +Davide Giorgio <davide@giorgiodavide.it> Heinrich Schuchardt <xypron.glpk@gmx.de> -henrik@optoscale.no -Ira Weiny <ira.weiny@intel.com> -Jakub Wilk <jwilk@jwilk.net> Jan Kara <jack@suse.cz> -Jann Horn <jannh@google.com> Jing Peng <pj.hades@gmail.com> -Jonathan Wakely <jwakely@redhat.com> -Jonny Grant <jg@jguk.org> -Konstantin Bukin <kbukin@gmail.com> -Mark Mossberg <mark.mossberg@gmail.com> -Marko Hrastovec <marko.hrastovec@gmail.com> -Matthew Bobrowski <mbobrowski@mbobrowski.org> +John A. Leuenhagen <john@zlima12.com> +Mathias Rav <m@git.strova.dk> Michael Kerrisk <mtk.manpages@gmail.com> -Mike Frysinger <vapier@gentoo.org> -Paul Eggert <eggert@cs.ucla.edu> -Paul Moore <paul@paul-moore.com> -Rich Felker <dalias@libc.org> -Samanta Navarro <ferivoz@riseup.net> -Serge Hallyn <serge@hallyn.com> -Simon McVittie <smcv@collabora.com> -Sridhar Samudrala <sridhar.samudrala@intel.com> -Stephen Smalley <stephen.smalley.work@gmail.com> -Steve Hilder <stevehilder@yahoo.co.uk> -Thomas Piekarski <t.piekarski@deloquencia.de> -Tony May <tony.may@mediakind.com> -Tycho Andersen <tycho@tycho.ws> -Yang Xu <xuyang2018.jy@cn.fujitsu.com> +Mike Crowe <mac@mcrowe.com> +Namhyung Kim <namhyung@gmail.com> +Peter Oskolkov <posk@google.com> +Philip Rowlands <linux-kernel@dimebar.com> +Rob Landley <rob@landley.net> +Ross Zwisler <zwisler@chromium.org> +Sebastian Kirmayer <sebastian@kirmayer.de> +наб <nabijaczleweli@nabijaczleweli.xyz> Apologies if I missed anyone! -New and rewritten pages ------------------------ - -circleq.3 - Alejandro Colomar - New page with 'circleq' content extracted from queue(3) - -list.3 - Alejandro Colomar - New page with 'list' content extracted from queue(3) - - -pthread_attr_setsigmask_np.3 - Michael Kerrisk - New page for pthread_attr_setsigmask_np() + pthread_attr_getsigmask_np() - Add a page documenting the pthread_attr_setsigmask_np(3) and - pthread_attr_getsigmask_np(3) functions added in glibc 2.32. - -slist.3 - Alejandro Colomar - New page with 'slist' content extracted from queue(3) - -stailq.3 - Alejandro Colomar - New page with 'stailq' content extracted from queue(3) - -tailq.3 - Alejandro Colomar - New page with 'tailq' content extracted from queue(3) - -system_data_types.7 - Alejandro Colomar, Michael - A new page documenting a wide range of system data types. - -kernel_lockdown.7 - David Howells, Heinrich Schuchardt [Michael Kerrisk] - New page documenting the Kernel Lockdown feature - -queue.7 - Alejandro Colomar - Create summary page for 'queue' APIs - The former queue(3) page was rather unwieldy, as it attempted to - describe too many APIs. After splitting that content out into a - number of smaller pages ( circleq.3, list.3, slist.3, stailq.3, - and tailq.3) move the much-reduced queue(3) page, which is now - essentially a summary of those APIs, from Section 3 to Section 7. - - Newly documented interfaces in existing pages --------------------------------------------- -fanotify_init.2 -fanotify.7 - Amir Goldstein [Jan Kara, Matthew Bobrowski] - Document FAN_REPORT_DIR_FID - -fanotify_init.2 -fanotify.7 - Amir Goldstein [Jan Kara, Matthew Bobrowski] - Document FAN_REPORT_NAME - -statx.2 - Ira Weiny - Add STATX_ATTR_DAX - -strerror.3 - Michael Kerrisk - Document strerrorname_np() and strerrordesc_np() - strerrorname_np() and strerrordesc_np() were added in glibc 2.32. - -strsignal.3 +access.2 Michael Kerrisk - Document sigabbrev_np() and sigdescr_np(). - sigabbrev_np() and sigdescr_np() were added in glibc 2.32. + Document faccessat2() + faccessat2() was added in Linux 5.8 and enables a fix to + longstanding bugs in the faccessat() wrapper function. -loop.4 - Yang Xu - Document LOOP_CONFIGURE ioctl - Yang Xu - Document LO_FLAGS_DIRECT_IO flag - -capabilities.7 - Michael Kerrisk - Document the CAP_CHECKPOINT_RESTORE capability added in Linux 5.9 - -ip.7 - Stephen Smalley [Paul Moore] - Document IP_PASSSEC for UDP sockets - -ip.7 -socket.7 - Stephen Smalley - Document SO_PEERSEC for AF_INET sockets - Sridhar Samudrala - Document SO_INCOMING_NAPI_ID - -socket.7 -unix.7 - Stephen Smalley [Serge Hallyn, Simon McVittie] - Add initial description for SO_PEERSEC +membarrier.2 + Peter Oskolkov [Alejandro Colomar] + Update for Linux 5.10 + Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840 + (part of 5.10 release) changed sys_membarrier prototype/parameters + and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ + and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ]. New and changed links --------------------- -aiocb.3 -clock_t.3 -clockid_t.3 -dev_t.3 -div_t.3 -double_t.3 -fenv_t.3 -fexcept_t.3 -FILE.3 -float_t.3 -gid_t.3 -id_t.3 -imaxdiv_t.3 -int8_t.3 -int16_t.3 -int32_t.3 -int64_t.3 -intN_t.3 -intmax_t.3 -intptr_t.3 -lconv.3 -ldiv_t.3 -lldiv_t.3 -off_t.3 -pid_t.3 -ptrdiff_t.3 -regex_t.3 -regmatch_t.3 -regoff_t.3 -siginfo_t.3 -sigset_t.3 -sigval.3 -size_t.3 -ssize_t.3 -suseconds_t.3 -time_t.3 -timer_t.3 -timespec.3 -timeval.3 -uid_t.3 -uint8_t.3 -uint16_t.3 -uint32_t.3 -uint64_t.3 -uintN_t.3 -uintptr_t.3 -va_list.3 -void.3 - Alejandro Colomar, Michael kerrisk - New links to system_data_types(7) - -CIRCLEQ_ENTRY.3 -CIRCLEQ_HEAD.3 -CIRCLEQ_INIT.3 -CIRCLEQ_INSERT_AFTER.3 -CIRCLEQ_INSERT_BEFORE.3 -CIRCLEQ_INSERT_HEAD.3 -CIRCLEQ_INSERT_TAIL.3 -CIRCLEQ_REMOVE.3 - Alejandro Colomar - Link to the new circleq(3) page instead of queue(3) - -LIST_EMPTY.3 -LIST_ENTRY.3 -LIST_FIRST.3 -LIST_FOREACH.3 -LIST_HEAD.3 -LIST_HEAD_INITIALIZER.3 -LIST_INIT.3 -LIST_INSERT_AFTER.3 -LIST_INSERT_BEFORE.3 -LIST_INSERT_HEAD.3 -LIST_NEXT.3 -LIST_REMOVE.3 - Alejandro Colomar - Link to the new list.3 page instead of queue.3 - -SLIST_EMPTY.3 -SLIST_ENTRY.3 -SLIST_FIRST.3 -SLIST_FOREACH.3 -SLIST_HEAD.3 -SLIST_HEAD_INITIALIZER.3 -SLIST_INIT.3 -SLIST_INSERT_AFTER.3 -SLIST_INSERT_HEAD.3 -SLIST_NEXT.3 -SLIST_REMOVE.3 -SLIST_REMOVE_HEAD.3 - Alejandro Colomar - Link to the new slist(3) page instead of queue(3) - -STAILQ_CONCAT.3 -STAILQ_EMPTY.3 -STAILQ_ENTRY.3 -STAILQ_FIRST.3 -STAILQ_FOREACH.3 -STAILQ_HEAD.3 -STAILQ_HEAD_INITIALIZER.3 -STAILQ_INIT.3 -STAILQ_INSERT_AFTER.3 -STAILQ_INSERT_HEAD.3 -STAILQ_INSERT_TAIL.3 -STAILQ_NEXT.3 -STAILQ_REMOVE.3 -STAILQ_REMOVE_HEAD.3 - Alejandro Colomar - Link to the new stailq(3) page instead of queue(3) - -TAILQ_CONCAT.3 -TAILQ_EMPTY.3 -TAILQ_ENTRY.3 -TAILQ_FIRST.3 -TAILQ_FOREACH.3 -TAILQ_FOREACH_REVERSE.3 -TAILQ_HEAD.3 -TAILQ_HEAD_INITIALIZER.3 -TAILQ_INIT.3 -TAILQ_INSERT_AFTER.3 -TAILQ_INSERT_BEFORE.3 -TAILQ_INSERT_HEAD.3 -TAILQ_INSERT_TAIL.3 -TAILQ_LAST.3 -TAILQ_NEXT.3 -TAILQ_PREV.3 -TAILQ_REMOVE.3 -TAILQ_SWAP.3 - Alejandro Colomar - Link to the new tailq(3) page instead of queue(3) - -getcwd.2 -mq_notify.2 -mq_open.2 -mq_timedreceive.2 -mq_timedsend.2 -mq_unlink.2 +faccessat2.2 Michael Kerrisk - Reinstate links to section 3 pages that document system calls - Some of the links removed in commit 247c654385128fd0748 should - have been kept, because in some cases there are real system - calls whose wrapper functions are documented in Section 3. + New link to access.2 -queue.3 - Alejandro Colomar - Link to queue(7) - -sigabbrev_np.3 +CIRCLEQ_EMPTY.3 +CIRCLEQ_FIRST.3 +CIRCLEQ_FOREACH.3 +CIRCLEQ_FOREACH_REVERSE.3 +CIRCLEQ_HEAD_INITIALIZER.3 +CIRCLEQ_LAST.3 +CIRCLEQ_LOOP_NEXT.3 +CIRCLEQ_LOOP_PREV.3 +CIRCLEQ_NEXT.3 +CIRCLEQ_PREV.3 Michael Kerrisk - New link to strsignal.3 + Add missing links to circleq.3 -sigdescr_np.3 +pthread_attr_getsigmask_np.3 Michael Kerrisk - New link to strsignal.3 - -strerrordesc_np.3 - Michael Kerrisk - New link to strerror(3) - -strerrorname_np.3 - Michael Kerrisk - New link to strerror(3) - -sys_siglist.3 - Michael Kerrisk - New link to strsignal(3) + New link to pthread_attr_setsigmask_np.3 Global changes @@ -332,447 +85,266 @@ Global changes Various pages Alejandro Colomar - Use ``sizeof`` consistently through all the examples in the - following way: + Use Oxford comma - - Use the name of the variable instead of its type as argument for - ``sizeof``. -Various pages - Alejandro Colomar - Use sizeof() to get buffer size (instead of hardcoding macro name) +Changes to individual pages +--------------------------- -Various pages +access.2 Michael Kerrisk - Use \(aq instead of ' inside monospace fonts - Use \(aq to get an unslanted single quote inside monospace code - blocks. Using a simple ' results in a slanted quote inside PDFs. - -Various pages - Michael Kerrisk, Alejandro Colomar - Use C99 style to declare loop counter variables - Rather than: - - sometype x; - - for (x = ....; ...) + BUGS: note that faccessat() wrapper function emulation ignores ACLs - use - - for (sometype x = ...; ...) - - This brings the declaration and use closer together (thus aiding - readability) and also clearly indicates the scope of the loop - counter variable. - -Various pages - Alejandro Colomar - Switch printf() casts to use [u]intmax_t + %ju / %jd - Let's move to the 21st century. Instead of casting system data - types to long/long long/etc. in printf() calls, instead cast to - intmax_t or uintmax_t, the largest available signed/unsigned - integer types. - -Various pages - Alejandro Colomar - Omit 'int' keyword for 'short', 'long' and 'long long' types - -Various pages - Alejandro Colomar - Remove unneeded casts - -Various pages - Alejandro Colomar - In printf(): s/0x%/%#/ except when followed by X instead of x - Use printf()'s '#' flag character to prepend the string "0x". - - However, when the number is printed in uppercase, and the prefix - is in lowercase, the string "0x" needs to be manually written. - -Various pages +bpf.2 Michael Kerrisk - Use C99-style declarations for readability - Rather than writing things such as: - - struct sometype *x; - ... - x = malloc(sizeof(*x)); - - let's use C99 style so that the type info is in the same line as - the allocation: - - struct sometype *x = malloc(sizeof(*x)); - -Various pages - Alejandro Colomar - Cast to 'unsigned long' rather than 'long' when printing with "%lx" + Place EXAMPLES section in correct location -stdarg.3 +cacheflush.2 Alejandro Colomar - Declare variables with different types in different lines - In particular, don's mix a variable and a pointer declaration - on the same line: TYPE x, *p; - - -Changes to individual pages ---------------------------- + Document Architecture-specific variants + Alejandro Colomar [Heinrich Schuchardt] + Document __builtin___clear_cache() as a more portable alternative -memusage.1 - Michael Kerrisk - EXAMPLES: remove doubled calculations - The same calculations are repeated in malloc() and printf() calls. - For better readability, do the calculations once. - Michael Kerrisk - Use %zu rather than %zd when printing 'size_t' values +chroot.2 +memfd_create.2 +tailq.3 + Michael Kerrisk [Alejandro Colomar] + Fix unbalanced .nf/.fi clock_getres.2 - Alejandro Colomar - EXAMPLES: use 'const' when appropriate - Alejandro Colomar [Jakub Wilk] - Cast 'time_t' to 'int' for printf() and fix the length modifiers - Michael Kerrisk [Tony May] - Fix type and variable name in dynamic clock code example + Michael Kerrisk + Place ERRORS in alphabetical order clone.2 +sigaltstack.2 Michael Kerrisk - CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid' + clone(CLONE_VM) disables the alternate signal stack -epoll_ctl.2 +getrlimit.2 Michael Kerrisk - epoll instances can be nested to a maximum depth of 5 - This limit appears to be an off-by-one count against - EP_MAX_NESTS (4). + State more precisely the range of kernel versions that had RLIMIT_LOCKS + +getrusage.2 Michael Kerrisk - Move some version info from CONFORMING TO to VERSIONS + Note that the 'vtimes' symbol exists only up to glibc 2.32 -eventfd.2 +io_cancel.2 +io_destroy.2 +io_getevents.2 +io_setup.2 +io_submit.2 Alejandro Colomar - Use 'PRIxN' macros when printing C99 fixed-width integer types + SYNOPSIS: s/io_context_t/aio_context_t/ + Linux uses aio_context_t for these syscalls, + and it's the type provided by <linux/aio_abi.h>. + Use it in the SYNOPSIS. -futex.2 - Alejandro Colomar - Use appropriate types + libaio uses 'io_context_t', but that difference is already noted + in NOTES. -getdents.2 +io_setup.2 Alejandro Colomar - SYNOPSIS: add missing header and feature test macro - -intro.2 -intro.3 -credentials.7 -feature_test_macros.7 -standards.7 - Michael Kerrisk - SEE ALSO: add system_data_types(7) - -ioctl_ns.2 -stat.2 - Alejandro Colomar [Konstantin Bukin] - Fix signedness of printf specifiers + SYNOPSIS: return long -membarrier.2 - Alejandro Colomar - Note that glibc does not provide a wrapper +link.2 + Mathias Rav + ERRORS: add ENOENT when target is deleted + Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part + of kernel release v2.6.39) added a check to disallow creating a + hard link to an unlinked file. -mprotect.2 - Alejandro Colomar - Use "%p" rather than casting to 'long' when printing pointer values +llseek.2 + Michael Kerrisk + Note size of 'loff_t' type + Michael Kerrisk + Point the reader to lseek64(3) for info about llseek(3) + Michael Kerrisk + Some mild rewriting to ease reading of the info in this page -mq_getsetattr.2 - Alejandro Colomar - Use 'const' when appropriate +mmap.2 + Michael Kerrisk + Clarify SIGBUS text and treatment of partial page at end of a mapping -msgop.2 - Yang Xu - Add restriction on ENOSYS error +mount.2 +statfs.2 + Ross Zwisler + Add NOSYMFOLLOW flags to mount(2) and statfs(2) -open.2 - Michael Kerrisk [henrik@optoscale.no] - ERRORS: add EBUSY +msgctl.2 + Michael Kerrisk + Make comments in 'msqid_ds' definition more compact + Michael Kerrisk + Place list of field descriptions in same order as structure definition + Michael Kerrisk + Use field name "msg_cbytes" rather than "__msg_cbytes" + Michael Kerrisk + Add description of 'msg_cbytes' field openat.2 + Colin Ian King + Fix include path, should be linux/openat2.h + +perf_event_open.2 + Namhyung Kim [Alejandro Colomar] + Update man page with recent kernel changes Alejandro Colomar - SYNOPSIS: return long - The Linux kernel uses long as the return type for this syscall. - As glibc provides no wrapper, use the same type the kernel uses. + Assign calculated value explicitly to 'config' -open_by_handle_at.2 +restart_syscall.2 Alejandro Colomar - Use "%u" rather than "%d" when printing 'unsigned int' values + SYNOPSIS: Fix restart_syscall() return type -perf_event_open.2 - Alexey Budankov - Update the man page with CAP_PERFMON related information - -recv.2 -send.2 - Michael Kerrisk - Add cross references to pages with further info about ancillary data - -sched_getattr.2 - Aleksa Sarai - Update to include changed size semantics - -seccomp.2 - Michael Kerrisk [Jann Horn] - Warn reader that SECCOMP_RET_TRACE can be overridden - Highlight to the reader that if another filter returns a - higher-precedence action value, then the ptracer will not - be notified. - Michael Kerrisk [Rich Felker] - Warn against the use of SECCOMP_RET_KILL_THREAD - Killing a thread with SECCOMP_RET_KILL_THREAD is very likely - to leave the rest of the process in a broken state. - Michael Kerrisk [Rich Felker] - EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILL +set_tid_address.2 Alejandro Colomar - Use ARRAY_SIZE() macro instead of raw sizeof division + SYNOPSIS: Fix set_tid_address() return type -setns.2 +shmctl.2 Michael Kerrisk - Correct the version for time namespace support + Place list of field descriptions in same order as structure definition sigaction.2 - Michael Kerrisk [Alejandro Colomar] - Use correct POSIX type for siginfo_t.si_value - -syscalls.2 Michael Kerrisk - Move system calls from discontinued ports out of main syscall list - Various ports that had their own indigenous system calls have - been discontinued. Remove those system calls (none of which had - manual pages!) to a separate part of the page, to avoid - cluttering the main list of system calls. + Clarify description of SA_NODEFER + Clarify description of SA_NODEFER, and note interaction with + act.sa_mask. Michael Kerrisk - Add close_range (Linux 5.9) + Add a cross-reference to signal(7) for further info on 'ucontext_t' -timerfd_create.2 - Alejandro Colomar - Use 'PRIxN' macros when printing C99 fixed-width integer types - -userfaultfd.2 +sigaltstack.2 Michael Kerrisk - Use a better type (uint64_t) for 'len' in EXAMPLES - Alejandro Colomar - Use 'PRIx64' rather than "%llx" when printing 64-bit fixed-width types + Clarify that the alternate signal stack is per-thread + Clarify that the alternate signal stack is per-thread (rather + than process-wide). -argz_add.3 -envz_add.3 - Michael Kerrisk [Jonny Grant] - Point out that 'error_t' is an integer type - -bsearch.3 - Alejandro Colomar - Fix intermediate type and remove unneeded casts - -bswap.3 - Jakub Wilk - Use strtoull() for parsing 64-bit numbers - -dlopen.3 +spu_create.2 Michael Kerrisk - Clarify DT_RUNPATH/DT_RPATH details - It is the DT_RUNPATH/DT_RPATH of the calling object (not the - executable) that is relevant for the library search. Verified - by experiment. - -errno.3 + Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM + Michael Kerrisk + Relocate paragraph on 'mode' argument Michael Kerrisk [Alejandro Colomar] - Note that the pthreads APIs do not set errno - -fopencookie.3 - Alejandro Colomar - printf()'s .* expects an int; cast accordingly - Alejandro Colomar - Fix bugs in example + Clarify that spu_create() now has 4 arguments but once had only 3 -fread.3 +subpage_prot.2 Alejandro Colomar - Move ARRAY_SIZE logic into macro - -freeaddrinfo.3 - Marko Hrastovec - Fix memory leaks in freeaddrinfo() examples + SYNOPSIS: Fix return type: s/long/int/ -getline.3 - Alejandro Colomar - Use %zd rather than %zu when printing 'ssize_t' values - -lseek64.3 +syscalls.2 Michael Kerrisk - Since glibc 2.28. the 'llseek' symbol is no longer available - -mallinfo.3 + Add process_madvise() Michael Kerrisk - The 'usmblks' field is nowadays always 0 + Note that sysctl() was removed in Linux 5.5 -offsetof.3 - Alejandro Colomar - Use "%zu" rather than "%zd" when printing 'size_t' values - -perror.3 +timer_getoverrun.2 Michael Kerrisk - sys_errlist and sys_nerr are no longer exposed by <stdio.h> - The change came with the release of glibc 2.32. - -posix_fallocate.3 - Érico Rolim - Add EOPNOTSUPP error code. + timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX + See https://bugzilla.kernel.org/show_bug.cgi?id=12665. -psignal.3 -strsignal.3 +uselib.2 +posix_memalign.3 +profil.3 +rtime.3 Michael Kerrisk - Consolidate information on 'sys_siglist' in one page (strsignal(3)) + Remove some text about libc/libc5 + With this change, there remain almost no vestiges of information + about the long defunct Linux libc. -pthread_attr_init.3 +errno.3 Michael Kerrisk - SEE ALSO: add pthread_attr_init(3) + Note another possible cause of the EMFILE error -pthread_attr_init.3 -pthread_create.3 -pthread_getattr_np.3 +getcontext.3 Michael Kerrisk - Use correct type (size_t) for some variables - -pthread_getattr_np.3 - Alejandro Colomar - Use "%zu" and "%zx" when printing 'size_t' values - -pthread_sigmask.3 + Mention SA_SIGINFO flag when talking about 3-argument signal handler Michael Kerrisk - SEE ALSO: add pthread_attr_setsigmask_np(3) + SEE ALSO: add signal(7) -qsort.3 - Alejandro Colomar - Fix casts - Alejandro Colomar - SYNOPSIS: move code from queue.3 to stailq.3 - -regex.3 - Alejandro Colomar - Add example program - Alejandro Colomar - Remove unnecessary include +list.3 + Michael Kerrisk + NAME: remove LIST_PREV, which is not documented in this page -strsignal.3 - Michael Kerrisk [Hauke Fath] - Note that starting with v2.32, glibc no longer exports 'sys_siglist' +lseek64.3 Michael Kerrisk - Further addition on version range for sys_siglist + Remove section numbers from interface list Michael Kerrisk - Note that 'sys_siglist' is nonstandard - -strtod.3 - Jonathan Wakely - Fix return value for underflow - -strtol.3 - Alejandro Colomar - EXAMPLES: simplify errno checking - Alejandro Colomar - EXAMPLES: as the default base, use special value 0 - Alejandro Colomar - EXAMPLES: delimit output string using "" - -tsearch.3 - Alejandro Colomar - Simplify type usage and remove unneeded casts - Alejandro Colomar - Use size_t for malloc() argument - -loop.4 - Yang Xu - Add some details about lo_flags + Remove sentence saying lseek64() is an alias for llseek() + Michael Kerrisk + NOTES: describe the origin of lseek64() in LFS -core.5 - Alejandro Colomar - Use adequate type +nextafter.3 + Michael Kerrisk + Remove duplicate "BUGS" section heading -locale.5 - Florian Weimer - Decimal points, thousands separators must be one character +pthread_tryjoin_np.3 + Michael Kerrisk [Mike Crowe] + Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug -proc.5 +rcmd.3 Michael Kerrisk - Update capability requirements for accessing /proc/[pid]/map_files - Jann Horn [Mark Mossberg] - Document inaccurate RSS due to SPLIT_RSS_COUNTING - Michael Kerrisk - Note "open file description" as (better) synonym for "file handle" + SEE ALSO: remove intro(2) -resolv.5 - Florian Weimer - Document the trust-ad option +strnlen.3 + Michael Kerrisk [Heinrich Schuchardt] + Fix a small inconsistency in the text -aio.7 - Alejandro Colomar - Use perror() directly +elf.5 + Michael Kerrisk + SEE ALSO: add objcopy(1) -bpf-helpers.7 - Michael Kerrisk [Jakub Wilk] - Resync with current kernel source +filesystems.5 + Ahelenia Ziemiańska [Alejandro Colomar] + Fix link to user space tooling for ncpfs + Ahelenia Ziemiańska [Alejandro Colomar] + Note ncpfs removal from kernel -capabilities.7 +attributes.7 Michael Kerrisk - Under CAP_SYS_ADMIN, group "sub-capabilities" together - CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been - added to split out the power of CAP_SYS_ADMIN into weaker pieces. - Group all of these capabilities together in the list under - CAP_SYS_ADMIN, to make it clear that there is a pattern to these - capabilities. - Michael Kerrisk - CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTORE - But the latter, weaker capability is preferred. - Michael Kerrisk - Add kernel doc reference for CAP_PERFMON + SEE ALSO: add signal-safety(7) fanotify.7 - Alejandro Colomar - Pass array to read(2) directly instead of a pointer to it + Amir Goldstein [Jan Kara] + fix outdated description -fanotify.7 -fanotify_mark.2 - Amir Goldstein [Jan Kara, Matthew Bobrowski] - Generalize documentation of FAN_REPORT_FID +kernel_lockdown.7 + Michael Kerrisk + Remove unneeded quotes -feature_test_macros.7 - Jakub Wilk - Update list of macros that inhibit default definitions +packet.7 + Baruch Siach [Alejandro Colomar] + Update references to kernel documentation -man.7 - Michael Kerrisk [G. Branden Robinson] - Clarify that alternating typeface macros print arguments without spaces +pthreads.7 + Michael Kerrisk + Rephrase function list in terms of POSIX rather than SUS + The list was using an inconsistent mixture of "POSIX" and "SUS". -man-pages.7 +signal.7 + Michael Kerrisk [Heinrich Schuchardt, Dave Martin] + Add some details on the execution of signal handlers + Add a "big picture" of what happens when a signal handler + is invoked. Michael Kerrisk - Add some more requests re code examples + Add pidfd_send_signal() to list of APIs for sending signals Michael Kerrisk - Soften the statement that ideal programs should be short - -namespaces.7 + Mention 'ucontext_t' in the discussion of signal handler execution Michael Kerrisk - A 'time_for_children' symlink can also pin a namespace + SEE ALSO: add swapcontext(3) -pid_namespaces.7 +signal-safety.7 Michael Kerrisk - Update capability requirements for /proc/sys/kernel/ns_last_pid + Note async-signal-safety details for errno -pthreads.7 +standards.7 Michael Kerrisk - Explicitly note that pthreads APIs return an errno-style value on error - -rtld-audit.7 - Florian Weimer [Carlos O'Donell] - Clarify la_version handshake - Returning its argument without further checks is almost always - wrong for la_version. - Alejandro Colomar - Use "%u" rather than "%d" when printing 'unsigned int' values - -sigevent.7 + Add URL for POSIX.1-2008/SUSv4 Michael Kerrisk - Note that 'sigev_notify_thread_id' is Linux-specific - -socket.7 + Add LFS (Large File Summit) + Michael Kerrisk [Rob Landley] + Fix some URLs for locations of the standards Michael Kerrisk - SEE ALSO: add ipv6(7) + Relocate the discussion on POSIX manual pages + +tcp.7 + Alejandro Colomar [Philip Rowlands] + tcp_syncookies: It is now an integer [0, 2] + Since Linux kernel 3.12, tcp_syncookies can have the value 2, + which sends out cookies unconditionally. diff --git a/Changes.old b/Changes.old index 23df1cd06..16c84b4e3 100644 --- a/Changes.old +++ b/Changes.old @@ -52207,3 +52207,783 @@ zic.8 Michael Kerrisk Sync to 2020a tzdb release From https://www.iana.org/time-zones, version 2020a. + + +==================== Changes in man-pages-5.09 ==================== + +Released: 2020-11-01, 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> +Alexey Budankov <alexey.budankov@linux.intel.com> +Amir Goldstein <amir73il@gmail.com> +Carlos O'Donell <carlos@redhat.com> +Dave Martin <Dave.Martin@arm.com> +David Howells <dhowells@redhat.com> +David Laight <David.Laight@ACULAB.COM> +Dmitry V. Levin <ldv@altlinux.org> +Érico Rolim <erico.erc@gmail.com> +Florian Weimer <fweimer@redhat.com> +G. Branden Robinson <g.branden.robinson@gmail.com> +Hauke Fath <hf@spg.tu-darmstadt.de> +Heinrich Schuchardt <xypron.glpk@gmx.de> +henrik@optoscale.no +Ira Weiny <ira.weiny@intel.com> +Jakub Wilk <jwilk@jwilk.net> +Jan Kara <jack@suse.cz> +Jann Horn <jannh@google.com> +Jing Peng <pj.hades@gmail.com> +Jonathan Wakely <jwakely@redhat.com> +Jonny Grant <jg@jguk.org> +Konstantin Bukin <kbukin@gmail.com> +Mark Mossberg <mark.mossberg@gmail.com> +Marko Hrastovec <marko.hrastovec@gmail.com> +Matthew Bobrowski <mbobrowski@mbobrowski.org> +Michael Kerrisk <mtk.manpages@gmail.com> +Mike Frysinger <vapier@gentoo.org> +Paul Eggert <eggert@cs.ucla.edu> +Paul Moore <paul@paul-moore.com> +Rich Felker <dalias@libc.org> +Samanta Navarro <ferivoz@riseup.net> +Serge Hallyn <serge@hallyn.com> +Simon McVittie <smcv@collabora.com> +Sridhar Samudrala <sridhar.samudrala@intel.com> +Stephen Smalley <stephen.smalley.work@gmail.com> +Steve Hilder <stevehilder@yahoo.co.uk> +Thomas Piekarski <t.piekarski@deloquencia.de> +Tony May <tony.may@mediakind.com> +Tycho Andersen <tycho@tycho.ws> +Yang Xu <xuyang2018.jy@cn.fujitsu.com> + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +circleq.3 + Alejandro Colomar + New page with 'circleq' content extracted from queue(3) + +list.3 + Alejandro Colomar + New page with 'list' content extracted from queue(3) + + +pthread_attr_setsigmask_np.3 + Michael Kerrisk + New page for pthread_attr_setsigmask_np() + pthread_attr_getsigmask_np() + Add a page documenting the pthread_attr_setsigmask_np(3) and + pthread_attr_getsigmask_np(3) functions added in glibc 2.32. + +slist.3 + Alejandro Colomar + New page with 'slist' content extracted from queue(3) + +stailq.3 + Alejandro Colomar + New page with 'stailq' content extracted from queue(3) + +tailq.3 + Alejandro Colomar + New page with 'tailq' content extracted from queue(3) + +system_data_types.7 + Alejandro Colomar, Michael Kerrisk + A new page documenting a wide range of system data types. + +kernel_lockdown.7 + David Howells, Heinrich Schuchardt [Michael Kerrisk] + New page documenting the Kernel Lockdown feature + +queue.7 + Alejandro Colomar + Create summary page for 'queue' APIs + The former queue(3) page was rather unwieldy, as it attempted to + describe too many APIs. After splitting that content out into a + number of smaller pages ( circleq.3, list.3, slist.3, stailq.3, + and tailq.3) move the much-reduced queue(3) page, which is now + essentially a summary of those APIs, from Section 3 to Section 7. + + +Newly documented interfaces in existing pages +--------------------------------------------- + +fanotify_init.2 +fanotify.7 + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Document FAN_REPORT_DIR_FID + +fanotify_init.2 +fanotify.7 + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Document FAN_REPORT_NAME + +statx.2 + Ira Weiny + Add STATX_ATTR_DAX + +strerror.3 + Michael Kerrisk + Document strerrorname_np() and strerrordesc_np() + strerrorname_np() and strerrordesc_np() were added in glibc 2.32. + +strsignal.3 + Michael Kerrisk + Document sigabbrev_np() and sigdescr_np(). + sigabbrev_np() and sigdescr_np() were added in glibc 2.32. + +loop.4 + Yang Xu + Document LOOP_CONFIGURE ioctl + Yang Xu + Document LO_FLAGS_DIRECT_IO flag + +capabilities.7 + Michael Kerrisk + Document the CAP_CHECKPOINT_RESTORE capability added in Linux 5.9 + +ip.7 + Stephen Smalley [Paul Moore] + Document IP_PASSSEC for UDP sockets + +ip.7 +socket.7 + Stephen Smalley + Document SO_PEERSEC for AF_INET sockets + Sridhar Samudrala + Document SO_INCOMING_NAPI_ID + +socket.7 +unix.7 + Stephen Smalley [Serge Hallyn, Simon McVittie] + Add initial description for SO_PEERSEC + + +New and changed links +--------------------- + +aiocb.3 +clock_t.3 +clockid_t.3 +dev_t.3 +div_t.3 +double_t.3 +fenv_t.3 +fexcept_t.3 +FILE.3 +float_t.3 +gid_t.3 +id_t.3 +imaxdiv_t.3 +int8_t.3 +int16_t.3 +int32_t.3 +int64_t.3 +intN_t.3 +intmax_t.3 +intptr_t.3 +lconv.3 +ldiv_t.3 +lldiv_t.3 +off_t.3 +pid_t.3 +ptrdiff_t.3 +regex_t.3 +regmatch_t.3 +regoff_t.3 +siginfo_t.3 +sigset_t.3 +sigval.3 +size_t.3 +ssize_t.3 +suseconds_t.3 +time_t.3 +timer_t.3 +timespec.3 +timeval.3 +uid_t.3 +uint8_t.3 +uint16_t.3 +uint32_t.3 +uint64_t.3 +uintN_t.3 +uintptr_t.3 +va_list.3 +void.3 + Alejandro Colomar, Michael kerrisk + New links to system_data_types(7) + +CIRCLEQ_ENTRY.3 +CIRCLEQ_HEAD.3 +CIRCLEQ_INIT.3 +CIRCLEQ_INSERT_AFTER.3 +CIRCLEQ_INSERT_BEFORE.3 +CIRCLEQ_INSERT_HEAD.3 +CIRCLEQ_INSERT_TAIL.3 +CIRCLEQ_REMOVE.3 + Alejandro Colomar + Link to the new circleq(3) page instead of queue(3) + +LIST_EMPTY.3 +LIST_ENTRY.3 +LIST_FIRST.3 +LIST_FOREACH.3 +LIST_HEAD.3 +LIST_HEAD_INITIALIZER.3 +LIST_INIT.3 +LIST_INSERT_AFTER.3 +LIST_INSERT_BEFORE.3 +LIST_INSERT_HEAD.3 +LIST_NEXT.3 +LIST_REMOVE.3 + Alejandro Colomar + Link to the new list.3 page instead of queue.3 + +SLIST_EMPTY.3 +SLIST_ENTRY.3 +SLIST_FIRST.3 +SLIST_FOREACH.3 +SLIST_HEAD.3 +SLIST_HEAD_INITIALIZER.3 +SLIST_INIT.3 +SLIST_INSERT_AFTER.3 +SLIST_INSERT_HEAD.3 +SLIST_NEXT.3 +SLIST_REMOVE.3 +SLIST_REMOVE_HEAD.3 + Alejandro Colomar + Link to the new slist(3) page instead of queue(3) + +STAILQ_CONCAT.3 +STAILQ_EMPTY.3 +STAILQ_ENTRY.3 +STAILQ_FIRST.3 +STAILQ_FOREACH.3 +STAILQ_HEAD.3 +STAILQ_HEAD_INITIALIZER.3 +STAILQ_INIT.3 +STAILQ_INSERT_AFTER.3 +STAILQ_INSERT_HEAD.3 +STAILQ_INSERT_TAIL.3 +STAILQ_NEXT.3 +STAILQ_REMOVE.3 +STAILQ_REMOVE_HEAD.3 + Alejandro Colomar + Link to the new stailq(3) page instead of queue(3) + +TAILQ_CONCAT.3 +TAILQ_EMPTY.3 +TAILQ_ENTRY.3 +TAILQ_FIRST.3 +TAILQ_FOREACH.3 +TAILQ_FOREACH_REVERSE.3 +TAILQ_HEAD.3 +TAILQ_HEAD_INITIALIZER.3 +TAILQ_INIT.3 +TAILQ_INSERT_AFTER.3 +TAILQ_INSERT_BEFORE.3 +TAILQ_INSERT_HEAD.3 +TAILQ_INSERT_TAIL.3 +TAILQ_LAST.3 +TAILQ_NEXT.3 +TAILQ_PREV.3 +TAILQ_REMOVE.3 +TAILQ_SWAP.3 + Alejandro Colomar + Link to the new tailq(3) page instead of queue(3) + +getcwd.2 +mq_notify.2 +mq_open.2 +mq_timedreceive.2 +mq_timedsend.2 +mq_unlink.2 + Michael Kerrisk + Reinstate links to section 3 pages that document system calls + Some of the links removed in commit 247c654385128fd0748 should + have been kept, because in some cases there are real system + calls whose wrapper functions are documented in Section 3. + +queue.3 + Alejandro Colomar + Link to queue(7) + +sigabbrev_np.3 + Michael Kerrisk + New link to strsignal.3 + +sigdescr_np.3 + Michael Kerrisk + New link to strsignal.3 + +strerrordesc_np.3 + Michael Kerrisk + New link to strerror(3) + +strerrorname_np.3 + Michael Kerrisk + New link to strerror(3) + +sys_siglist.3 + Michael Kerrisk + New link to strsignal(3) + + +Global changes +-------------- + +Various pages + Alejandro Colomar + Use ``sizeof`` consistently through all the examples in the + following way: + + - Use the name of the variable instead of its type as argument for + ``sizeof``. + +Various pages + Alejandro Colomar + Use sizeof() to get buffer size (instead of hardcoding macro name) + +Various pages + Michael Kerrisk + Use \(aq instead of ' inside monospace fonts + Use \(aq to get an unslanted single quote inside monospace code + blocks. Using a simple ' results in a slanted quote inside PDFs. + +Various pages + Michael Kerrisk, Alejandro Colomar + Use C99 style to declare loop counter variables + Rather than: + + sometype x; + + for (x = ....; ...) + + use + + for (sometype x = ...; ...) + + This brings the declaration and use closer together (thus aiding + readability) and also clearly indicates the scope of the loop + counter variable. + +Various pages + Alejandro Colomar + Switch printf() casts to use [u]intmax_t + %ju / %jd + Let's move to the 21st century. Instead of casting system data + types to long/long long/etc. in printf() calls, instead cast to + intmax_t or uintmax_t, the largest available signed/unsigned + integer types. + +Various pages + Alejandro Colomar + Omit 'int' keyword for 'short', 'long' and 'long long' types + +Various pages + Alejandro Colomar + Remove unneeded casts + +Various pages + Alejandro Colomar + In printf(): s/0x%/%#/ except when followed by X instead of x + Use printf()'s '#' flag character to prepend the string "0x". + + However, when the number is printed in uppercase, and the prefix + is in lowercase, the string "0x" needs to be manually written. + +Various pages + Michael Kerrisk + Use C99-style declarations for readability + Rather than writing things such as: + + struct sometype *x; + ... + x = malloc(sizeof(*x)); + + let's use C99 style so that the type info is in the same line as + the allocation: + + struct sometype *x = malloc(sizeof(*x)); + +Various pages + Alejandro Colomar + Cast to 'unsigned long' rather than 'long' when printing with "%lx" + +stdarg.3 + Alejandro Colomar + Declare variables with different types in different lines + In particular, don's mix a variable and a pointer declaration + on the same line: TYPE x, *p; + + +Changes to individual pages +--------------------------- + +memusage.1 + Michael Kerrisk + EXAMPLES: remove doubled calculations + The same calculations are repeated in malloc() and printf() calls. + For better readability, do the calculations once. + Michael Kerrisk + Use %zu rather than %zd when printing 'size_t' values + +clock_getres.2 + Alejandro Colomar + EXAMPLES: use 'const' when appropriate + Alejandro Colomar [Jakub Wilk] + Cast 'time_t' to 'int' for printf() and fix the length modifiers + Michael Kerrisk [Tony May] + Fix type and variable name in dynamic clock code example + +clone.2 + Michael Kerrisk + CAP_CHECKPOINT_RESTORE can now be used to employ 'set_tid' + +epoll_ctl.2 + Michael Kerrisk + epoll instances can be nested to a maximum depth of 5 + This limit appears to be an off-by-one count against + EP_MAX_NESTS (4). + Michael Kerrisk + Move some version info from CONFORMING TO to VERSIONS + +eventfd.2 + Alejandro Colomar + Use 'PRIxN' macros when printing C99 fixed-width integer types + +futex.2 + Alejandro Colomar + Use appropriate types + +getdents.2 + Alejandro Colomar + SYNOPSIS: add missing header and feature test macro + +intro.2 +intro.3 +credentials.7 +feature_test_macros.7 +standards.7 + Michael Kerrisk + SEE ALSO: add system_data_types(7) + +ioctl_ns.2 +stat.2 + Alejandro Colomar [Konstantin Bukin] + Fix signedness of printf specifiers + +membarrier.2 + Alejandro Colomar + Note that glibc does not provide a wrapper + +mprotect.2 + Alejandro Colomar + Use "%p" rather than casting to 'long' when printing pointer values + +mq_getsetattr.2 + Alejandro Colomar + Use 'const' when appropriate + +msgop.2 + Yang Xu + Add restriction on ENOSYS error + +open.2 + Michael Kerrisk [henrik@optoscale.no] + ERRORS: add EBUSY + +openat.2 + Alejandro Colomar + SYNOPSIS: return long + The Linux kernel uses long as the return type for this syscall. + As glibc provides no wrapper, use the same type the kernel uses. + +open_by_handle_at.2 + Alejandro Colomar + Use "%u" rather than "%d" when printing 'unsigned int' values + +perf_event_open.2 + Alexey Budankov + Update the man page with CAP_PERFMON related information + +recv.2 +send.2 + Michael Kerrisk + Add cross references to pages with further info about ancillary data + +sched_getattr.2 + Aleksa Sarai + Update to include changed size semantics + +seccomp.2 + Michael Kerrisk [Jann Horn] + Warn reader that SECCOMP_RET_TRACE can be overridden + Highlight to the reader that if another filter returns a + higher-precedence action value, then the ptracer will not + be notified. + Michael Kerrisk [Rich Felker] + Warn against the use of SECCOMP_RET_KILL_THREAD + Killing a thread with SECCOMP_RET_KILL_THREAD is very likely + to leave the rest of the process in a broken state. + Michael Kerrisk [Rich Felker] + EXAMPLES: use SECCOMP_RET_KILL_PROCESS rather than SECCOMP_RET_KILL + Alejandro Colomar + Use ARRAY_SIZE() macro instead of raw sizeof division + +setns.2 + Michael Kerrisk + Correct the version for time namespace support + +sigaction.2 + Michael Kerrisk [Alejandro Colomar] + Use correct POSIX type for siginfo_t.si_value + +syscalls.2 + Michael Kerrisk + Move system calls from discontinued ports out of main syscall list + Various ports that had their own indigenous system calls have + been discontinued. Remove those system calls (none of which had + manual pages!) to a separate part of the page, to avoid + cluttering the main list of system calls. + Michael Kerrisk + Add close_range (Linux 5.9) + +timerfd_create.2 + Alejandro Colomar + Use 'PRIxN' macros when printing C99 fixed-width integer types + +userfaultfd.2 + Michael Kerrisk + Use a better type (uint64_t) for 'len' in EXAMPLES + Alejandro Colomar + Use 'PRIx64' rather than "%llx" when printing 64-bit fixed-width types + +argz_add.3 +envz_add.3 + Michael Kerrisk [Jonny Grant] + Point out that 'error_t' is an integer type + +bsearch.3 + Alejandro Colomar + Fix intermediate type and remove unneeded casts + +bswap.3 + Jakub Wilk + Use strtoull() for parsing 64-bit numbers + +dlopen.3 + Michael Kerrisk + Clarify DT_RUNPATH/DT_RPATH details + It is the DT_RUNPATH/DT_RPATH of the calling object (not the + executable) that is relevant for the library search. Verified + by experiment. + +errno.3 + Michael Kerrisk [Alejandro Colomar] + Note that the pthreads APIs do not set errno + +fopencookie.3 + Alejandro Colomar + printf()'s .* expects an int; cast accordingly + Alejandro Colomar + Fix bugs in example + +fread.3 + Alejandro Colomar + Move ARRAY_SIZE logic into macro + +freeaddrinfo.3 + Marko Hrastovec + Fix memory leaks in freeaddrinfo() examples + +getline.3 + Alejandro Colomar + Use %zd rather than %zu when printing 'ssize_t' values + +lseek64.3 + Michael Kerrisk + Since glibc 2.28. the 'llseek' symbol is no longer available + +mallinfo.3 + Michael Kerrisk + The 'usmblks' field is nowadays always 0 + +offsetof.3 + Alejandro Colomar + Use "%zu" rather than "%zd" when printing 'size_t' values + +perror.3 + Michael Kerrisk + sys_errlist and sys_nerr are no longer exposed by <stdio.h> + The change came with the release of glibc 2.32. + +posix_fallocate.3 + Érico Rolim + Add EOPNOTSUPP error code. + +psignal.3 +strsignal.3 + Michael Kerrisk + Consolidate information on 'sys_siglist' in one page (strsignal(3)) + +pthread_attr_init.3 + Michael Kerrisk + SEE ALSO: add pthread_attr_init(3) + +pthread_attr_init.3 +pthread_create.3 +pthread_getattr_np.3 + Michael Kerrisk + Use correct type (size_t) for some variables + +pthread_getattr_np.3 + Alejandro Colomar + Use "%zu" and "%zx" when printing 'size_t' values + +pthread_sigmask.3 + Michael Kerrisk + SEE ALSO: add pthread_attr_setsigmask_np(3) + +qsort.3 + Alejandro Colomar + Fix casts + Alejandro Colomar + SYNOPSIS: move code from queue.3 to stailq.3 + +regex.3 + Alejandro Colomar + Add example program + Alejandro Colomar + Remove unnecessary include + +strsignal.3 + Michael Kerrisk [Hauke Fath] + Note that starting with v2.32, glibc no longer exports 'sys_siglist' + Michael Kerrisk + Further addition on version range for sys_siglist + Michael Kerrisk + Note that 'sys_siglist' is nonstandard + +strtod.3 + Jonathan Wakely + Fix return value for underflow + +strtol.3 + Alejandro Colomar + EXAMPLES: simplify errno checking + Alejandro Colomar + EXAMPLES: as the default base, use special value 0 + Alejandro Colomar + EXAMPLES: delimit output string using "" + +tsearch.3 + Alejandro Colomar + Simplify type usage and remove unneeded casts + Alejandro Colomar + Use size_t for malloc() argument + +loop.4 + Yang Xu + Add some details about lo_flags + +core.5 + Alejandro Colomar + Use adequate type + +locale.5 + Florian Weimer + Decimal points, thousands separators must be one character + +proc.5 + Michael Kerrisk + Update capability requirements for accessing /proc/[pid]/map_files + Jann Horn [Mark Mossberg] + Document inaccurate RSS due to SPLIT_RSS_COUNTING + Michael Kerrisk + Note "open file description" as (better) synonym for "file handle" + +resolv.5 + Florian Weimer + Document the trust-ad option + +aio.7 + Alejandro Colomar + Use perror() directly + +bpf-helpers.7 + Michael Kerrisk [Jakub Wilk] + Resync with current kernel source + +capabilities.7 + Michael Kerrisk + Under CAP_SYS_ADMIN, group "sub-capabilities" together + CAP_BPF, CAP_PERFMON, and CAP_CHECKPOINT_RESTORE have all been + added to split out the power of CAP_SYS_ADMIN into weaker pieces. + Group all of these capabilities together in the list under + CAP_SYS_ADMIN, to make it clear that there is a pattern to these + capabilities. + Michael Kerrisk + CAP_SYS_ADMIN implies CAP_CHECKPOINT_RESTORE + But the latter, weaker capability is preferred. + Michael Kerrisk + Add kernel doc reference for CAP_PERFMON + +fanotify.7 + Alejandro Colomar + Pass array to read(2) directly instead of a pointer to it + +fanotify.7 +fanotify_mark.2 + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Generalize documentation of FAN_REPORT_FID + +feature_test_macros.7 + Jakub Wilk + Update list of macros that inhibit default definitions + +man.7 + Michael Kerrisk [G. Branden Robinson] + Clarify that alternating typeface macros print arguments without spaces + +man-pages.7 + Michael Kerrisk + Add some more requests re code examples + Michael Kerrisk + Soften the statement that ideal programs should be short + +namespaces.7 + Michael Kerrisk + A 'time_for_children' symlink can also pin a namespace + +pid_namespaces.7 + Michael Kerrisk + Update capability requirements for /proc/sys/kernel/ns_last_pid + +pthreads.7 + Michael Kerrisk + Explicitly note that pthreads APIs return an errno-style value on error + +rtld-audit.7 + Florian Weimer [Carlos O'Donell] + Clarify la_version handshake + Returning its argument without further checks is almost always + wrong for la_version. + Alejandro Colomar + Use "%u" rather than "%d" when printing 'unsigned int' values + +sigevent.7 + Michael Kerrisk + Note that 'sigev_notify_thread_id' is Linux-specific + +socket.7 + Michael Kerrisk + SEE ALSO: add ipv6(7) diff --git a/MAINTAINER_NOTES b/MAINTAINER_NOTES new file mode 100644 index 000000000..056d02774 --- /dev/null +++ b/MAINTAINER_NOTES @@ -0,0 +1,12 @@ +Externally generated pages +========================== + +A few pages come from external sources. Fixes to the pages should really +go to the upstream source. + +tzfile(5), zdump(8), and zic(8) come from the tz project +(https://www.iana.org/time-zones). + +bpf-helpers(7) is autogenerated from the kernel sources using scripts. +See man-pagfes commit 53666f6c30451cde022f65d35a8d448f5a7132ba dir +details. diff --git a/man-pages-5.09.Announce b/man-pages-5.10.Announce index 2d238fc4d..d67053992 100644 --- a/man-pages-5.09.Announce +++ b/man-pages-5.10.Announce @@ -1,7 +1,7 @@ RELEASE The Linux man page maintainer proudly announces. . . - man-pages-5.09.tar.gz - man pages for Linux + man-pages-5.10.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.09.lsm b/man-pages-5.10.lsm index 3f7987947..0288f855b 100644 --- a/man-pages-5.09.lsm +++ b/man-pages-5.10.lsm @@ -1,13 +1,13 @@ Begin3 Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 5.09 -Entered-date: 2020-11-01 +Version: 5.10 +Entered-date: 2020-12-21 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 - 2752k man-pages-5.09.tar.gz + 2764k man-pages-5.10.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 869510526..36fbf2cfe 100644 --- a/man1/getent.1 +++ b/man1/getent.1 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH GETENT 1 2020-04-11 "Linux" "User Commands" +.TH GETENT 1 2020-12-21 "Linux" "User Commands" .SH NAME getent \- get entries from Name Service Switch libraries .SH SYNOPSIS @@ -209,7 +209,7 @@ Alternatively, three .I keys may be provided, which are interpreted as the .IR hostname , -.I username +.IR username , and .I domainname to match to a netgroup name via @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/iconv.1 b/man1/iconv.1 index cff0e53d0..47c1a0724 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -202,7 +202,7 @@ abc ss ? EUR abc .BR charsets (7), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/intro.1 b/man1/intro.1 index 6500d0a49..7a318a28c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/ldd.1 b/man1/ldd.1 index df0eed7b9..d329be3c1 100644 --- a/man1/ldd.1 +++ b/man1/ldd.1 @@ -175,7 +175,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/locale.1 b/man1/locale.1 index ca86ab61d..f2dcf94b6 100644 --- a/man1/locale.1 +++ b/man1/locale.1 @@ -207,7 +207,7 @@ $ \fBecho "export LANG=fi_SE.UTF-8" >> $HOME/.bashrc\fP .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/localedef.1 b/man1/localedef.1 index 0e35ae800..9cbaadde5 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -289,7 +289,6 @@ Print the version number, license, and disclaimer of warranty for .SH EXIT STATUS One of the following exit values can be returned by .BR localedef : -.RS 3 .TP .B 0 Command completed successfully. @@ -299,7 +298,6 @@ Warnings or errors occurred, output files were written. .TP .B 4 Errors encountered, no output created. -.RE .SH ENVIRONMENT .TP .B POSIXLY_CORRECT @@ -404,7 +402,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusage.1 b/man1/memusage.1 index acdffaed9..8c1098b68 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -276,7 +276,7 @@ main(int argc, char *argv[]) .BR mtrace (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusagestat.1 b/man1/memusagestat.1 index da06d0474..57324b63b 100644 --- a/man1/memusagestat.1 +++ b/man1/memusagestat.1 @@ -89,7 +89,7 @@ See .BR memusage (1), .BR mtrace (1) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/mtrace.1 b/man1/mtrace.1 index 4218d647d..0563be850 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/pldd.1 b/man1/pldd.1 index b2c116a03..c1f5b6aeb 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -122,7 +122,7 @@ linux\-vdso.so.1 .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/sprof.1 b/man1/sprof.1 index 19019e781..bc1a3c286 100644 --- a/man1/sprof.1 +++ b/man1/sprof.1 @@ -293,7 +293,7 @@ x2 consumeCpu2 1000 .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man1/time.1 b/man1/time.1 index 8b24cb08c..ef299f51a 100644 --- a/man1/time.1 +++ b/man1/time.1 @@ -331,7 +331,7 @@ and C compiler you used. .BR times (2), .BR wait3 (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_exit.2 b/man2/_exit.2 index 1d33861b4..440b3c673 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_syscall.2 b/man2/_syscall.2 index fb4448fc1..b2f4f3f60 100644 --- a/man2/_syscall.2 +++ b/man2/_syscall.2 @@ -185,7 +185,7 @@ Number of processes = 40 .BR syscall (2), .BR errno (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/accept.2 b/man2/accept.2 index 32c6e2454..681505377 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -378,7 +378,7 @@ See .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/access.2 b/man2/access.2 index cea2784eb..af7a35249 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -40,9 +40,9 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-06-10, mtk, various parts rewritten, and added BUGS section. .\" -.TH ACCESS 2 2016-03-15 "Linux" "Linux Programmer's Manual" +.TH ACCESS 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME -access, faccessat \- check user's permissions for a file +access, faccessat, faccessat2 \- check user's permissions for a file .SH SYNOPSIS .nf .B #include <unistd.h> @@ -54,6 +54,10 @@ access, faccessat \- check user's permissions for a file .PP .BI "int faccessat(int " dirfd ", const char *" pathname ", int " \ mode ", int " flags ); + /* But see C library/kernel differences, below */ + +.BI "int faccessat2(int " dirfd ", const char *" pathname ", int " \ +mode ", int " flags ); .fi .PP .RS -4 @@ -126,9 +130,8 @@ then an check is successful for a regular file if execute permission is enabled for any of the file owner, group, or other. .SS faccessat() -The .BR faccessat () -system call operates in exactly the same way as +operates in exactly the same way as .BR access (), except for the differences described here. .PP @@ -180,6 +183,25 @@ See .BR openat (2) for an explanation of the need for .BR faccessat (). +.\" +.SS faccessat2() +The description of +.BR faccessat () +given above corresponds to POSIX.1 and +to the implementation provided by glibc. +However, the glibc implementation was an imperfect emulation (see BUGS) +that papered over the fact that the raw Linux +.BR faccessat () +system call does not have a +.I flags +argument. +To allow for a proper implementation, Linux 5.8 added the +.BR faccessat2 () +system call, which supports the +.I flags +argument and allows a correct implementation of the +.BR faccessat () +wrapper function. .SH RETURN VALUE On success (all requested permissions granted, or .I mode @@ -273,12 +295,18 @@ is a file descriptor referring to a file other than a directory. .BR faccessat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. +.PP +.BR faccessat2 () +was added to Linux in version 5.8. .SH CONFORMING TO .BR access (): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008. .PP .BR faccessat (): POSIX.1-2008. +.PP +.BR faccessat2 (): +Linux-specific. .SH NOTES .BR Warning : Using these calls to check if a user is authorized to, for example, @@ -348,7 +376,8 @@ flags are actually implemented within the glibc wrapper function for .BR faccessat (). If either of these flags is specified, then the wrapper function employs .BR fstatat (2) -to determine access permissions. +to determine access permissions, but see BUGS. +.\" .SS Glibc notes On older kernels where .BR faccessat () @@ -368,6 +397,24 @@ that corresponds to the .IR dirfd argument. .SH BUGS +Because the Linux kernel's +.BR faccessat () +system call does not support a +.I flags +argument, the glibc +.BR faccessat () +wrapper function provided in glibc 2.32 and earlier +emulates the required functionality using +a combination of the +.BR faccessat () +system call and +.BR fstatat (2). +However, this emulation does not take ACLs into account. +Starting with glibc 2.33, the wrapper function avoids this bug +by making use of the +.BR faccessat2 () +system call where it is provided by the underlying kernel. +.PP In kernel 2.4 (and earlier) there is some strangeness in the handling of .B X_OK tests for superuser. @@ -412,7 +459,7 @@ flag is honored. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/acct.2 b/man2/acct.2 index 3a7fd2349..00d5756b7 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.09 of the Linux +This page is part of release 5.10 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 aec827686..084b1bf38 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -295,7 +295,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 index f64d796e2..7173e1a44 100644 --- a/man2/adjtimex.2 +++ b/man2/adjtimex.2 @@ -608,7 +608,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/alarm.2 b/man2/alarm.2 index 803c00d6e..c64419018 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.09 of the Linux +This page is part of release 5.10 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 35273d0c9..e4cb3326c 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.09 of the Linux +This page is part of release 5.10 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 66fc99e30..3112e33fc 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -58,7 +58,7 @@ or disable .RI ( "addr == 0" ) the .I cpuid -instruction for the current thread. +instruction for the calling thread. The instruction is enabled by default. If disabled, any execution of a .I cpuid @@ -99,7 +99,7 @@ register to .B ARCH_GET_FS Return the 64-bit base value for the .I FS -register of the current thread in the +register of the calling thread in the .I unsigned long pointed to by .IR addr . @@ -113,7 +113,7 @@ register to .B ARCH_GET_GS Return the 64-bit base value for the .I GS -register of the current thread in the +register of the calling thread in the .I unsigned long pointed to by .IR addr . @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bdflush.2 b/man2/bdflush.2 index 3936d3611..b286a1220 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bind.2 b/man2/bind.2 index 3b89af89b..3b94f1a61 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -335,7 +335,7 @@ main(int argc, char *argv[]) .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bpf.2 b/man2/bpf.2 index f031a441a..a51e6599a 100644 --- a/man2/bpf.2 +++ b/man2/bpf.2 @@ -971,75 +971,6 @@ ioctl(event_fd, PERF_EVENT_IOC_SET_BPF, prog_fd); .in .\" .\" -.SH EXAMPLES -.EX -/* bpf+sockets example: - * 1. create array map of 256 elements - * 2. load program that counts number of packets received - * r0 = skb->data[ETH_HLEN + offsetof(struct iphdr, protocol)] - * map[r0]++ - * 3. attach prog_fd to raw socket via setsockopt() - * 4. print number of received TCP/UDP packets every second - */ -int -main(int argc, char **argv) -{ - int sock, map_fd, prog_fd, key; - long long value = 0, tcp_cnt, udp_cnt; - - map_fd = bpf_create_map(BPF_MAP_TYPE_ARRAY, sizeof(key), - sizeof(value), 256); - if (map_fd < 0) { - printf("failed to create map \(aq%s\(aq\en", strerror(errno)); - /* likely not run as root */ - return 1; - } - - struct bpf_insn prog[] = { - BPF_MOV64_REG(BPF_REG_6, BPF_REG_1), /* r6 = r1 */ - BPF_LD_ABS(BPF_B, ETH_HLEN + offsetof(struct iphdr, protocol)), - /* r0 = ip->proto */ - BPF_STX_MEM(BPF_W, BPF_REG_10, BPF_REG_0, -4), - /* *(u32 *)(fp - 4) = r0 */ - BPF_MOV64_REG(BPF_REG_2, BPF_REG_10), /* r2 = fp */ - BPF_ALU64_IMM(BPF_ADD, BPF_REG_2, -4), /* r2 = r2 - 4 */ - BPF_LD_MAP_FD(BPF_REG_1, map_fd), /* r1 = map_fd */ - BPF_CALL_FUNC(BPF_FUNC_map_lookup_elem), - /* r0 = map_lookup(r1, r2) */ - BPF_JMP_IMM(BPF_JEQ, BPF_REG_0, 0, 2), - /* if (r0 == 0) goto pc+2 */ - BPF_MOV64_IMM(BPF_REG_1, 1), /* r1 = 1 */ - BPF_XADD(BPF_DW, BPF_REG_0, BPF_REG_1, 0, 0), - /* lock *(u64 *) r0 += r1 */ -.\" == atomic64_add - BPF_MOV64_IMM(BPF_REG_0, 0), /* r0 = 0 */ - BPF_EXIT_INSN(), /* return r0 */ - }; - - prog_fd = bpf_prog_load(BPF_PROG_TYPE_SOCKET_FILTER, prog, - sizeof(prog) / sizeof(prog[0]), "GPL"); - - sock = open_raw_sock("lo"); - - assert(setsockopt(sock, SOL_SOCKET, SO_ATTACH_BPF, &prog_fd, - sizeof(prog_fd)) == 0); - - for (;;) { - key = IPPROTO_TCP; - assert(bpf_lookup_elem(map_fd, &key, &tcp_cnt) == 0); - key = IPPROTO_UDP; - assert(bpf_lookup_elem(map_fd, &key, &udp_cnt) == 0); - printf("TCP %lld UDP %lld packets\en", tcp_cnt, udp_cnt); - sleep(1); - } - - return 0; -} -.EE -.PP -Some complete working code can be found in the -.I samples/bpf -directory in the kernel source tree. .SH RETURN VALUE For a successful call, the return value depends on the operation: .TP @@ -1174,7 +1105,7 @@ tail_call ktime_get_ns .PD 1 .PP -Unprivileged access may be blocked by setting the sysctl +Unprivileged access may be blocked by writing the value 1 to the file .IR /proc/sys/kernel/unprivileged_bpf_disabled . .PP eBPF objects (maps and programs) can be shared between processes. @@ -1270,6 +1201,75 @@ MIPS 64 (since Linux 4.18; cBPF since Linux 3.16); riscv (since Linux 5.1). .\" commit 2353ecc6f91fd15b893fa01bf85a1c7a823ee4f2 .PD +.SH EXAMPLES +.EX +/* bpf+sockets example: + * 1. create array map of 256 elements + * 2. load program that counts number of packets received + * r0 = skb->data[ETH_HLEN + offsetof(struct iphdr, protocol)] + * map[r0]++ + * 3. attach prog_fd to raw socket via setsockopt() + * 4. print number of received TCP/UDP packets every second + */ +int +main(int argc, char **argv) +{ + int sock, map_fd, prog_fd, key; + long long value = 0, tcp_cnt, udp_cnt; + + map_fd = bpf_create_map(BPF_MAP_TYPE_ARRAY, sizeof(key), + sizeof(value), 256); + if (map_fd < 0) { + printf("failed to create map \(aq%s\(aq\en", strerror(errno)); + /* likely not run as root */ + return 1; + } + + struct bpf_insn prog[] = { + BPF_MOV64_REG(BPF_REG_6, BPF_REG_1), /* r6 = r1 */ + BPF_LD_ABS(BPF_B, ETH_HLEN + offsetof(struct iphdr, protocol)), + /* r0 = ip->proto */ + BPF_STX_MEM(BPF_W, BPF_REG_10, BPF_REG_0, -4), + /* *(u32 *)(fp - 4) = r0 */ + BPF_MOV64_REG(BPF_REG_2, BPF_REG_10), /* r2 = fp */ + BPF_ALU64_IMM(BPF_ADD, BPF_REG_2, -4), /* r2 = r2 - 4 */ + BPF_LD_MAP_FD(BPF_REG_1, map_fd), /* r1 = map_fd */ + BPF_CALL_FUNC(BPF_FUNC_map_lookup_elem), + /* r0 = map_lookup(r1, r2) */ + BPF_JMP_IMM(BPF_JEQ, BPF_REG_0, 0, 2), + /* if (r0 == 0) goto pc+2 */ + BPF_MOV64_IMM(BPF_REG_1, 1), /* r1 = 1 */ + BPF_XADD(BPF_DW, BPF_REG_0, BPF_REG_1, 0, 0), + /* lock *(u64 *) r0 += r1 */ +.\" == atomic64_add + BPF_MOV64_IMM(BPF_REG_0, 0), /* r0 = 0 */ + BPF_EXIT_INSN(), /* return r0 */ + }; + + prog_fd = bpf_prog_load(BPF_PROG_TYPE_SOCKET_FILTER, prog, + sizeof(prog) / sizeof(prog[0]), "GPL"); + + sock = open_raw_sock("lo"); + + assert(setsockopt(sock, SOL_SOCKET, SO_ATTACH_BPF, &prog_fd, + sizeof(prog_fd)) == 0); + + for (;;) { + key = IPPROTO_TCP; + assert(bpf_lookup_elem(map_fd, &key, &tcp_cnt) == 0); + key = IPPROTO_UDP; + assert(bpf_lookup_elem(map_fd, &key, &udp_cnt) == 0); + printf("TCP %lld UDP %lld packets\en", tcp_cnt, udp_cnt); + sleep(1); + } + + return 0; +} +.EE +.PP +Some complete working code can be found in the +.I samples/bpf +directory in the kernel source tree. .SH SEE ALSO .BR seccomp (2), .BR bpf\-helpers (7), @@ -1280,7 +1280,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/brk.2 b/man2/brk.2 index 1626394f6..35ae3d547 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index c687db242..d445befd8 100644 --- a/man2/cacheflush.2 +++ b/man2/cacheflush.2 @@ -22,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH CACHEFLUSH 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH CACHEFLUSH 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME cacheflush \- flush contents of instruction and/or data cache .SH SYNOPSIS @@ -31,6 +31,10 @@ cacheflush \- flush contents of instruction and/or data cache .PP .BI "int cacheflush(char *" addr ", int "nbytes ", int "cache ); .fi +.PP +.IR Note : +On some architectures, +there is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION .BR cacheflush () flushes the contents of the indicated cache(s) for the @@ -86,6 +90,59 @@ On Linux, this call first appeared on the MIPS architecture, but nowadays, Linux provides a .BR cacheflush () system call on some other architectures, but with different arguments. +.SH NOTES +.SS Architecture-specific variants +Glibc provides a wrapper for this system call, +with the prototype shown in SYNOPSIS, +for the following architectures: +ARC, CSKY, MIPS, and NIOS2. +.PP +On some other architectures, +Linux provides this system call, with different arguments: +.TP +M68K: +.nf +.BI "int cacheflush(unsigned long " addr ", int " scope ", int " cache , +.BI " unsigned long " len ); +.fi +.TP +SH: +.nf +.BI "int cacheflush(unsigned long " addr ", unsigned long " len ", int " op ); +.fi +.TP +NDS32: +.nf +.BI "int cacheflush(unsigned int " start ", unsigned int " end ", int " cache ); +.fi +.PP +On the above architectures, +glibc does not provide a wrapper for this system call; call it using +.BR syscall (2). +.SS GCC alternative +Unless you need the finer grained control that this system call provides, +you probably want to use the GCC built-in function +.BR __builtin___clear_cache (), +which provides a portable interface +across platforms supported by GCC and compatible compilers: +.PP +.in +4n +.EX +.BI "void __builtin___clear_cache(void *" begin ", void *" end ); +.EE +.in +.PP +On platforms that don't require instruction cache flushes, +.BR __builtin___clear_cache () +has no effect. +.PP +.IR Note : +On some GCC-compatible compilers, +the prototype for this built-in function uses +.I char * +instead of +.I void * +for the parameters. .SH BUGS Linux kernels older than version 2.6.11 ignore the .I addr @@ -102,7 +159,7 @@ argument and does not do any error checking on the .I cache argument. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/capget.2 b/man2/capget.2 index 6e4049e28..32273cff4 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -98,11 +98,11 @@ There was, however, an API glitch, and Linux 2.6.26 added to fix the problem. .PP Note that 64-bit capabilities use -.IR datap [0] +.I datap[0] and -.IR datap [1], +.IR datap[1] , whereas 32-bit capabilities use only -.IR datap [0]. +.IR datap[0] . .PP On kernels that support file capabilities (VFS capabilities support), these system calls behave slightly differently. @@ -247,7 +247,7 @@ library and is available here: .BR gettid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chdir.2 b/man2/chdir.2 index 74d24f9ae..d8842ab11 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chmod.2 b/man2/chmod.2 index 01ad7ed99..e676a1593 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -386,7 +386,7 @@ argument. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chown.2 b/man2/chown.2 index bf4cb19e7..dfb2dd7ca 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -501,7 +501,7 @@ main(int argc, char *argv[]) .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chroot.2 b/man2/chroot.2 index bf53bad64..65627da8a 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -30,7 +30,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers <jsm28@cam.ac.uk> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH CHROOT 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH CHROOT 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME chroot \- change root directory .SH SYNOPSIS @@ -53,6 +53,7 @@ Since glibc 2.2.2: _XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) || /* Since glibc 2.20: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE +.fi .TP 4 Before glibc 2.2.2: none .PD @@ -184,7 +185,7 @@ system call. .BR path_resolution (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index e849183f0..35412aa7b 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -28,7 +28,7 @@ .\" 2003-08-24 aeb, large parts rewritten .\" 2004-08-06 Christoph Lameter <clameter@sgi.com>, SMP note .\" -.TH CLOCK_GETRES 2 2020-08-13 "" "Linux Programmer's Manual" +.TH CLOCK_GETRES 2 2020-12-21 "" "Linux Programmer's Manual" .SH NAME clock_getres, clock_gettime, clock_settime \- clock and time functions .SH SYNOPSIS @@ -270,6 +270,11 @@ return 0 for success, or \-1 for failure (in which case is set appropriately). .SH ERRORS .TP +.B EACCES +.BR clock_settime () +does not have write permission for the dynamic POSIX +clock device indicated. +.TP .B EFAULT .I tp points outside the accessible address space. @@ -299,10 +304,6 @@ specified in a call to .BR clock_settime () is not a settable clock. .TP -.B ENOTSUP -The operation is not supported by the dynamic POSIX clock device -specified. -.TP .BR EINVAL " (since Linux 4.3)" .\" commit e1d7ba8735551ed79c7a0463a042353574b96da3 A call to @@ -322,14 +323,13 @@ dynamic .I clk_id has disappeared after its character device was opened. .TP +.B ENOTSUP +The operation is not supported by the dynamic POSIX clock device +specified. +.TP .B EPERM .BR clock_settime () does not have permission to set the clock indicated. -.TP -.B EACCES -.BR clock_settime () -does not have write permission for the dynamic POSIX -clock device indicated. .SH VERSIONS These system calls first appeared in Linux 2.6. .SH ATTRIBUTES @@ -540,7 +540,7 @@ main(int argc, char *argv[]) .BR vdso (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 3904954fe..8aa3eab0c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clone.2 b/man2/clone.2 index 5a0afa5c2..6b744f6c9 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -1181,6 +1181,15 @@ 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). +.IP +If the +.BR CLONE_VM +flag is specified and the +.BR CLONE_VM +flag is not specified, +then any alternate signal stack that was established by +.BR sigaltstack (2) +is cleared in the child process. .SH RETURN VALUE .\" gettid(2) returns current->pid; .\" getpid(2) returns current->tgid; @@ -1909,7 +1918,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/close.2 b/man2/close.2 index 23c7b3a86..d16817d42 100644 --- a/man2/close.2 +++ b/man2/close.2 @@ -279,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/connect.2 b/man2/connect.2 index f5e48bf7b..244e89b24 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -306,7 +306,7 @@ is shown in .BR path_resolution (7), .BR selinux (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2508dea7b..a1a374348 100644 --- a/man2/copy_file_range.2 +++ b/man2/copy_file_range.2 @@ -298,7 +298,7 @@ main(int argc, char **argv) .BR sendfile (2), .BR splice (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 8476ba75b..3a2ded763 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.09 of the Linux +This page is part of release 5.10 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 3a45d116c..10482390f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/dup.2 b/man2/dup.2 index f8b142b8a..195b30a7c 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -280,7 +280,7 @@ if (tmpfd != \-1) { .BR open (2), .BR pidfd_getfd (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 0c40f60cd..61e3c91fe 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.09 of the Linux +This page is part of release 5.10 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 d6940487d..929b15565 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -479,7 +479,7 @@ flag. .BR poll (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 5ef3590b3..db2667610 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/eventfd.2 b/man2/eventfd.2 index 6bbddb6f5..2db2f0553 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -451,7 +451,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execve.2 b/man2/execve.2 index 2343d7214..b3808d141 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -354,7 +354,7 @@ is the series of words pointed to by the argument of .BR execve (), starting at -.IR argv [1]. +.IR argv[1] . Note that there is no way to get the .IR argv[0] that was passed to the @@ -889,7 +889,7 @@ argv[4]: world .BR path_resolution (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execveat.2 b/man2/execveat.2 index e1c86072e..b766116b6 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.09 of the Linux +This page is part of release 5.10 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 773085e1a..d5a2f1306 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/faccessat2.2 b/man2/faccessat2.2 new file mode 100644 index 000000000..9d4f76e5b --- /dev/null +++ b/man2/faccessat2.2 @@ -0,0 +1 @@ +.so man2/access.2 diff --git a/man2/fallocate.2 b/man2/fallocate.2 index 7e9e016fc..571f3c955 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.09 of the Linux +This page is part of release 5.10 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 2cbd86a87..6217183aa 100644 --- a/man2/fanotify_init.2 +++ b/man2/fanotify_init.2 @@ -402,7 +402,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.09 of the Linux +This page is part of release 5.10 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 187ff16de..a843fe075 100644 --- a/man2/fanotify_mark.2 +++ b/man2/fanotify_mark.2 @@ -511,7 +511,7 @@ If .I flags contains .BR FAN_MARK_FLUSH , -.I dirfd +.IR dirfd , and .I pathname must specify a valid filesystem object, even though this object is not used. @@ -533,7 +533,7 @@ is not checked for invalid values. .BR fanotify_init (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 7f53a6107..9af4a4286 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -64,7 +64,7 @@ .\" 2017-06-26, Jens Axboe <axboe@kernel.dk> .\" Document F_{GET,SET}_RW_HINT and F_{GET,SET}_FILE_RW_HINT .\" -.TH FCNTL 2 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH FCNTL 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME fcntl \- manipulate file descriptor .SH SYNOPSIS @@ -700,7 +700,7 @@ asynchronous notification of lost locks. .BR F_SETOWN , .BR F_GETOWN_EX , .BR F_SETOWN_EX , -.BR F_GETSIG +.BR F_GETSIG , and .B F_SETSIG are used to manage I/O availability signals: @@ -2126,7 +2126,7 @@ directory, and is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/flock.2 b/man2/flock.2 index bf4e85d6f..b43f01d58 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fork.2 b/man2/fork.2 index f35179b7a..749dc36c0 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -326,7 +326,7 @@ and .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fsync.2 b/man2/fsync.2 index ee35b088a..ebab7fcc6 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -199,7 +199,7 @@ to guarantee safe operation. .BR hdparm (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futex.2 b/man2/futex.2 index d86771b8f..afd502233 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -417,7 +417,7 @@ the caller will receive the signal number that was passed in .IP The arguments .IR timeout , -.I uaddr2 +.IR uaddr2 , and .I val3 are ignored. @@ -1809,7 +1809,7 @@ fwait(uint32_t *futexp) /* Release the futex pointed to by \(aqfutexp\(aq: if the futex currently has the value 0, set its value to 1 and the wake any futex waiters, - so that if the peer is blocked in fpost(), it can proceed. */ + so that if the peer is blocked in fwait(), it can proceed. */ static void fpost(uint32_t *futexp) @@ -1934,7 +1934,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futimesat.2 b/man2/futimesat.2 index f5f407e4e..9333c23f1 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.09 of the Linux +This page is part of release 5.10 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 09a11b7d2..126a9409c 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.09 of the Linux +This page is part of release 5.10 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 bc0efe4fd..7a9d5db4b 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.09 of the Linux +This page is part of release 5.10 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 dcc38771d..a6266c831 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getcpu.2 b/man2/getcpu.2 index c89f8b025..a5c9604d8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdents.2 b/man2/getdents.2 index 3b1fe12a8..ef73dc51d 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -326,7 +326,7 @@ main(int argc, char *argv[]) .BR readdir (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index 4776f446f..9fc2f2a82 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgid.2 b/man2/getgid.2 index f58742dc2..b294435a2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 578c47abe..73034c447 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -225,7 +225,7 @@ For details, see .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gethostname.2 b/man2/gethostname.2 index 82652bd18..3949668f3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 8421836c2..38185f442 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index be58aa7da..def7c4d4e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 9fe094e4d..64d158764 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpid.2 b/man2/getpid.2 index f985559fe..5f6a52372 100644 --- a/man2/getpid.2 +++ b/man2/getpid.2 @@ -166,7 +166,7 @@ for details regarding register mapping. .BR credentials (7), .BR pid_namespaces (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpriority.2 b/man2/getpriority.2 index 94b16d1dd..400a7b59c 100644 --- a/man2/getpriority.2 +++ b/man2/getpriority.2 @@ -124,13 +124,16 @@ returns the calling thread's nice value, which may be a negative number. On error, it returns \-1 and sets .I errno to indicate the cause of the error. +.PP Since a successful call to .BR getpriority () can legitimately return the value \-1, it is necessary to clear the external variable .I errno prior to the -call, then check it afterward to determine +call, then check +.I errno +afterward to determine if \-1 is an error or a legitimate value. .PP .BR setpriority () @@ -251,7 +254,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrandom.2 b/man2/getrandom.2 index 6a01625e5..f860728ad 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getresuid.2 b/man2/getresuid.2 index e8a9c90c1..0f200a18b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index b1282902d..4f45df40e 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -207,7 +207,7 @@ catch this signal instead, in which case the relevant system call (e.g., fails with the error .BR EFBIG . .TP -.BR RLIMIT_LOCKS " (early Linux 2.4 only)" +.BR RLIMIT_LOCKS " (Linux 2.4.0 to 2.4.24)" .\" to be precise: Linux 2.4.0-test9; no longer in 2.4.25 / 2.5.65 This is a limit on the combined number of .BR flock (2) @@ -854,7 +854,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrusage.2 b/man2/getrusage.2 index bc53b4489..5fd970f37 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -36,7 +36,7 @@ .\" document ru_maxrss .\" 2010-05-24, mtk, enhanced description of various fields .\" -.TH GETRUSAGE 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH GETRUSAGE 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME getrusage \- get resource usage .SH SYNOPSIS @@ -252,7 +252,7 @@ Ancient systems provided a .BR vtimes () function with a similar purpose to .BR getrusage (). -For backward compatibility, glibc also provides +For backward compatibility, glibc (up until version 2.32) also provides .BR vtimes (). All new applications should be written using .BR getrusage (). @@ -269,7 +269,7 @@ in .BR wait4 (2), .BR clock (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsid.2 b/man2/getsid.2 index 2da6aa4e0..2dd38ddc4 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -95,7 +95,7 @@ for a description of sessions and session IDs. .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockname.2 b/man2/getsockname.2 index 7c4e9194f..d88ae215a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index 2bf4d8271..b6a68ad8c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettid.2 b/man2/gettid.2 index f6cd99ffc..60a1539fd 100644 --- a/man2/gettid.2 +++ b/man2/gettid.2 @@ -98,7 +98,7 @@ is the same as its thread ID (the value returned by .BR tgkill (2), .BR timer_create (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index bf51cb2d8..6bab89123 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getuid.2 b/man2/getuid.2 index 473da6fb7..24e13a26b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getunwind.2 b/man2/getunwind.2 index ff326880a..d8f04e293 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getxattr.2 b/man2/getxattr.2 index ec57c09bc..94a5f90ae 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -162,7 +162,7 @@ See .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/idle.2 b/man2/idle.2 index 5e14bc1da..4ead2f1d6 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.09 of the Linux +This page is part of release 5.10 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 5576d5208..833c9557c 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -357,7 +357,7 @@ the rest of the module. .BR lsmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 993401ec1..3783fc067 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -148,7 +148,7 @@ See .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 05a31262a..ba341d700 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.09 of the Linux +This page is part of release 5.10 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 603b62e25..3344ed63a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/intro.2 b/man2/intro.2 index 3ec87d2ed..db9e88763 100644 --- a/man2/intro.2 +++ b/man2/intro.2 @@ -134,7 +134,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.09 of the Linux +This page is part of release 5.10 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 203eab168..ee9ba218c 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -4,20 +4,29 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_CANCEL 2 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH IO_CANCEL 2 2020-12-21 "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(io_context_t " ctx_id ", struct iocb *" iocb , +.BI "int io_cancel(aio_context_t " ctx_id ", struct iocb *" iocb , .BI " struct io_event *" result ); .fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION +.IR Note : +this page describes the raw Linux system call interface. +The wrapper function provided by +.I libaio +uses a different type for the +.I ctx_id +argument. +See NOTES. +.PP The .BR io_cancel () system call @@ -97,7 +106,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 09b734e71..5c55a58da 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -4,19 +4,28 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_DESTROY 2 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH IO_DESTROY 2 2020-12-21 "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(io_context_t " ctx_id ); +.BI "int io_destroy(aio_context_t " ctx_id ); .fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION +.IR Note : +this page describes the raw Linux system call interface. +The wrapper function provided by +.I libaio +uses a different type for the +.I ctx_id +argument. +See NOTES. +.PP The .BR io_destroy () system call @@ -86,7 +95,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 49e26ce09..3ac179f5b 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 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH IO_GETEVENTS 2 2020-12-21 "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(io_context_t " ctx_id ", long " min_nr ", long " nr , +.BI "int io_getevents(aio_context_t " ctx_id ", long " min_nr ", long " nr , .BI " struct io_event *" events \ ", struct timespec *" timeout ); .fi @@ -20,6 +20,15 @@ io_getevents \- read asynchronous I/O events from the completion queue .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION +.IR Note : +this page describes the raw Linux system call interface. +The wrapper function provided by +.I libaio +uses a different type for the +.I ctx_id +argument. +See NOTES. +.PP The .BR io_getevents () system call @@ -129,7 +138,7 @@ may cause a segmentation fault instead of generating the error .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 8caa8a745..e180d5e8d 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -4,19 +4,28 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_SETUP 2 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH IO_SETUP 2 2020-12-21 "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 ", io_context_t *" ctx_idp ); +.BI "long io_setup(unsigned " nr_events ", aio_context_t *" ctx_idp ); .fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION +.IR Note : +this page describes the raw Linux system call interface. +The wrapper function provided by +.I libaio +uses a different type for the +.I ctx_idp +argument. +See NOTES. +.PP The .BR io_setup () system call @@ -101,7 +110,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 dba7308da..f1c23bea6 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -5,20 +5,29 @@ .\" This file is distributed according to the GNU General Public License. .\" %%%LICENSE_END .\" -.TH IO_SUBMIT 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH IO_SUBMIT 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME io_submit \- submit asynchronous I/O blocks for processing .SH SYNOPSIS .nf .BR "#include <linux/aio_abi.h>" " /* Defines needed types */" .PP -.BI "int io_submit(io_context_t " ctx_id ", long " nr \ +.BI "int io_submit(aio_context_t " ctx_id ", long " nr \ ", struct iocb **" iocbpp ); .fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION +.IR Note : +this page describes the raw Linux system call interface. +The wrapper function provided by +.I libaio +uses a different type for the +.I ctx_id +argument. +See NOTES. +.PP The .BR io_submit () system call @@ -276,7 +285,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl.2 b/man2/ioctl.2 index 5e2833c74..3dfc559ee 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -207,7 +207,7 @@ for the various architectures. .BR sd (4), .BR tty (4) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 8ced4b524..54f5b5c16 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.09 of the Linux +This page is part of release 5.10 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 5ea9f4f1a..5bbc75205 100644 --- a/man2/ioctl_fat.2 +++ b/man2/ioctl_fat.2 @@ -501,7 +501,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d7e4ea390..ffc9f6666 100644 --- a/man2/ioctl_ficlonerange.2 +++ b/man2/ioctl_ficlonerange.2 @@ -142,7 +142,7 @@ not fail because of lack of disk space. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 75e16d8a2..8262171ae 100644 --- a/man2/ioctl_fideduperange.2 +++ b/man2/ioctl_fideduperange.2 @@ -210,7 +210,7 @@ single call. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_fslabel.2 b/man2/ioctl_fslabel.2 index b108252ef..82141fd20 100644 --- a/man2/ioctl_fslabel.2 +++ b/man2/ioctl_fslabel.2 @@ -86,7 +86,7 @@ will always be null-terminated. .BR ioctl (2), .BR blkid (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_getfsmap.2 b/man2/ioctl_getfsmap.2 index 58062b547..c0852e77d 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -367,7 +367,7 @@ distribution for a sample program. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d1a1c5ef9..a08d53861 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl_ns.2 b/man2/ioctl_ns.2 index 2bb19ae87..1a1fba6d9 100644 --- a/man2/ioctl_ns.2 +++ b/man2/ioctl_ns.2 @@ -364,7 +364,7 @@ main(int argc, char *argv[]) .BR proc (5), .BR namespaces (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 3eb4ab0f2..5e06bd88e 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -335,14 +335,15 @@ If the first byte is not (0), it is an OR of one or more of the following bits: .IP -.nf -TIOCPKT_FLUSHREAD The read queue for the terminal is flushed. -TIOCPKT_FLUSHWRITE The write queue for the terminal is flushed. -TIOCPKT_STOP Output to the terminal is stopped. -TIOCPKT_START Output to the terminal is restarted. -TIOCPKT_DOSTOP The start and stop characters are \fB\(haS\fP/\fB\(haQ\fP. -TIOCPKT_NOSTOP The start and stop characters are not \fB\(haS\fP/\fB\(haQ\fP. -.fi +.TS +lb l. +TIOCPKT_FLUSHREAD The read queue for the terminal is flushed. +TIOCPKT_FLUSHWRITE The write queue for the terminal is flushed. +TIOCPKT_STOP Output to the terminal is stopped. +TIOCPKT_START Output to the terminal is restarted. +TIOCPKT_DOSTOP The start and stop characters are \fB\(haS\fP/\fB\(haQ\fP. +TIOCPKT_NOSTOP The start and stop characters are not \fB\(haS\fP/\fB\(haQ\fP. +.TE .IP While packet mode is in use, the presence of control status information to be read @@ -429,19 +430,20 @@ Set the indicated modem bits. .PP The following bits are used by the above ioctls: .PP -.nf -TIOCM_LE DSR (data set ready/line enable) -TIOCM_DTR DTR (data terminal ready) -TIOCM_RTS RTS (request to send) -TIOCM_ST Secondary TXD (transmit) -TIOCM_SR Secondary RXD (receive) -TIOCM_CTS CTS (clear to send) -TIOCM_CAR DCD (data carrier detect) -TIOCM_CD see TIOCM_CAR -TIOCM_RNG RNG (ring) -TIOCM_RI see TIOCM_RNG -TIOCM_DSR DSR (data set ready) -.fi +.TS +lb l. +TIOCM_LE DSR (data set ready/line enable) +TIOCM_DTR DTR (data terminal ready) +TIOCM_RTS RTS (request to send) +TIOCM_ST Secondary TXD (transmit) +TIOCM_SR Secondary RXD (receive) +TIOCM_CTS CTS (clear to send) +TIOCM_CAR DCD (data carrier detect) +TIOCM_CD see TIOCM_CAR +TIOCM_RNG RNG (ring) +TIOCM_RI see TIOCM_RNG +TIOCM_DSR DSR (data set ready) +.TE .TP .BI "TIOCMIWAIT int " arg Wait for any of the 4 modem bits (DCD, RI, DSR, CTS) to change. @@ -592,7 +594,7 @@ main(void) .\" TIOCSERSETMULTI const struct serial_multiport_struct * .\" TIOCGSERIAL, TIOCSSERIAL (see above) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 9f570794b..487a7a54b 100644 --- a/man2/ioctl_userfaultfd.2 +++ b/man2/ioctl_userfaultfd.2 @@ -690,7 +690,7 @@ See .IR Documentation/admin-guide/mm/userfaultfd.rst in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 23deb3d34..f64c6c40c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/iopl.2 b/man2/iopl.2 index 2ec2f3b58..2f0b8f6eb 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -108,7 +108,7 @@ and won't be reinstated. .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 e1ae5e56a..ce0ce2a9a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ipc.2 b/man2/ipc.2 index 57f94be47..29f972788 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 0ae60ca46..5f80469ca 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -430,7 +430,7 @@ main(int argc, char *argv[]) .BR clone (2), .BR unshare (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 bfea3584a..478ddbdd4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/keyctl.2 b/man2/keyctl.2 index c938487bd..27657092f 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -33,7 +33,7 @@ keyctl \- manipulate the kernel's key management facility .B #include <sys/types.h> .B #include <keyutils.h> .PP -.BI "long keyctl(int " operation ", ...)" +.BI "long keyctl(int " operation ", ...);" .B "/* For direct call via syscall(2): */" .B #include <asm/unistd.h> @@ -2289,7 +2289,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kill.2 b/man2/kill.2 index 507906634..4a6fc004c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/link.2 b/man2/link.2 index d63d18b65..992bba6f2 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -29,7 +29,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2005-04-04, as per suggestion by Michael Hardt for rename.2 .\" -.TH LINK 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH LINK 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME link, linkat \- make a new name for a file .SH SYNOPSIS @@ -320,6 +320,11 @@ See .BR open (2). .TP .B ENOENT +An attempt was made to link to a +.I /proc/self/fd/NN +file corresponding to a file that has been deleted. +.TP +.B ENOENT .I oldpath is a relative pathname and .I olddirfd @@ -435,7 +440,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listen.2 b/man2/listen.2 index b570c0d65..50932f86e 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -185,7 +185,7 @@ See .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listxattr.2 b/man2/listxattr.2 index 805749aec..6b46520f7 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/llseek.2 b/man2/llseek.2 index d9cd6fe0d..3f43b0147 100644 --- a/man2/llseek.2 +++ b/man2/llseek.2 @@ -1,5 +1,6 @@ .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl) .\" Written 10 June 1995 by Andries Brouwer <aeb@cwi.nl> +.\" and Copyright (C) 2007, 2015, 2020, Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this @@ -25,7 +26,7 @@ .\" .\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH LLSEEK 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH LLSEEK 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME _llseek \- reposition read/write file offset .SH SYNOPSIS @@ -41,14 +42,22 @@ _llseek \- reposition read/write file offset .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION +Note: for information about the +.BR llseek (3) +library function, see +.BR lseek64 (3). +.PP The .BR _llseek () system call repositions the offset of the open file description associated with the file descriptor .I fd -to -.I (offset_high<<32) | offset_low -bytes relative to the beginning of the file, the current file offset, +to the value +.IP +(offset_high << 32) | offset_low +.PP +This new offset is a byte offset +relative to the beginning of the file, the current file offset, or the end of the file, depending on whether .I whence is @@ -57,8 +66,12 @@ is or .BR SEEK_END , respectively. -It returns the resulting file position in the argument +.PP +The new file offset is returned in the argument .IR result . +The type +.I loff_t +is a 64-bit signed type. .PP This system call exists on various 32-bit platforms to support seeking to large file offsets. @@ -96,7 +109,7 @@ wrapper function instead. .BR open (2), .BR lseek64 (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 1f021b484..681489503 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/lseek.2 b/man2/lseek.2 index 5d14c3069..20b0d5a31 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -278,7 +278,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/madvise.2 b/man2/madvise.2 index ae282a824..ecfd62cab 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mbind.2 b/man2/mbind.2 index dd649f754..87fde69f3 100644 --- a/man2/mbind.2 +++ b/man2/mbind.2 @@ -492,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/membarrier.2 b/man2/membarrier.2 index e38650c05..a0e67edc8 100644 --- a/man2/membarrier.2 +++ b/man2/membarrier.2 @@ -30,7 +30,7 @@ membarrier \- issue memory barriers on a set of threads .PP .B #include <linux/membarrier.h> .PP -.BI "int membarrier(int " cmd ", int " flags ");" +.BI "int membarrier(int " cmd ", unsigned int " flags ", int " cpu_id ); .fi .PP .IR Note : @@ -165,6 +165,29 @@ core command prior to using it. Register the process's intent to use .BR MEMBARRIER_CMD_PRIVATE_EXPEDITED_SYNC_CORE . .TP +.BR MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ " (since Linux 5.10)" +Ensure the caller thread, upon return from system call, that all its +running thread siblings have any currently running rseq critical sections +restarted if +.I flags +parameter is 0; if +.I flags +parameter is +.BR MEMBARRIER_CMD_FLAG_CPU , +then this operation is performed only on CPU indicated by +.IR cpu_id . +This guarantee is provided only for threads in +the same process as the calling thread. +.IP +RSEQ membarrier is only available in the "private expedited" form. +.IP +A process must register its intent to use the private expedited rseq +command prior to using it. +.TP +.BR MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ " (since Linux 5.10)" +Register the process's intent to use +.BR MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ . +.TP .BR MEMBARRIER_CMD_SHARED " (since Linux 4.3)" This is an alias for .BR MEMBARRIER_CMD_GLOBAL @@ -172,7 +195,21 @@ that exists for header backward compatibility. .PP The .I flags -argument is currently unused and must be specified as 0. +argument must be specified as 0 unless the command is +.BR MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ , +in which case +.I flags +can be either 0 or +.BR MEMBARRIER_CMD_FLAG_CPU . +.PP +The +.I cpu_id +argument is ignored unless +.I flags +is +.BR MEMBARRIER_CMD_FLAG_CPU , +in which case it must specify the CPU targeted by this membarrier +command. .PP All memory accesses performed in program order from each targeted thread are guaranteed to be ordered with respect to @@ -187,7 +224,7 @@ to represent explicit memory barriers forcing full memory ordering across the barrier, we have the following ordering table for each pairing of .IR barrier() , -.BR membarrier () +.BR membarrier (), and .IR smp_mb() . The pair ordering is detailed as (O: ordered, X: not ordered): @@ -251,7 +288,16 @@ commands. The .BR membarrier () system call was added in Linux 4.3. -.\" +.PP +Before Linux 5.10, the prototype for +.BR membarrier () +was: +.PP +.in +4n +.EX +.BI "int membarrier(int " cmd ", int " flags ); +.EE +.in .SH CONFORMING TO .BR membarrier () is Linux-specific. @@ -350,9 +396,9 @@ becomes: static volatile int a, b; static int -membarrier(int cmd, int flags) +membarrier(int cmd, unsigned int flags, int cpu_id) { - return syscall(__NR_membarrier, cmd, flags); + return syscall(__NR_membarrier, cmd, flags, cpu_id); } static int @@ -362,7 +408,7 @@ init_membarrier(void) /* Check that membarrier() is supported. */ - ret = membarrier(MEMBARRIER_CMD_QUERY, 0); + ret = membarrier(MEMBARRIER_CMD_QUERY, 0, 0); if (ret < 0) { perror("membarrier"); return \-1; @@ -389,7 +435,7 @@ static void slow_path(int *read_a) { b = 1; - membarrier(MEMBARRIER_CMD_GLOBAL, 0); + membarrier(MEMBARRIER_CMD_GLOBAL, 0, 0); *read_a = a; } @@ -423,7 +469,7 @@ main(int argc, char **argv) .EE .in .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 742ee5bf9..d1473bc7b 100644 --- a/man2/memfd_create.2 +++ b/man2/memfd_create.2 @@ -27,6 +27,7 @@ memfd_create \- create an anonymous file .B #include <sys/mman.h> .PP .BI "int memfd_create(const char *" name ", unsigned int " flags ");" +.fi .SH DESCRIPTION .BR memfd_create () creates an anonymous file and returns a file descriptor that refers to it. @@ -549,7 +550,7 @@ main(int argc, char *argv[]) .BR shmget (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 3c5f10f4a..ad7cdbfed 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mincore.2 b/man2/mincore.2 index c26d9a51c..a34711768 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 9f50d7232..0763f628f 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -252,7 +252,7 @@ argument. .BR acl (5), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mknod.2 b/man2/mknod.2 index 92deb8798..db1415c5f 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -301,7 +301,7 @@ and .BR acl (5), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mlock.2 b/man2/mlock.2 index 9b816f2ef..44fd6f582 100644 --- a/man2/mlock.2 +++ b/man2/mlock.2 @@ -497,7 +497,7 @@ resource limit is encountered. .BR proc (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap.2 b/man2/mmap.2 index 136b45876..d9a6e5813 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -37,7 +37,7 @@ .\" 2007-07-10, mtk, Added an example program. .\" 2008-11-18, mtk, document MAP_STACK .\" -.TH MMAP 2 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH MMAP 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME mmap, munmap \- map or unmap files or devices into memory .SH SYNOPSIS @@ -635,9 +635,11 @@ Use of a mapped region can result in these signals: Attempted write into a region mapped as read-only. .TP .B SIGBUS -Attempted access to a portion of the buffer that does not correspond -to the file (for example, beyond the end of the file, including the -case where another process has truncated the file). +Attempted access to a page of the buffer that lies beyond the +end of the mapped file. +For an explanation of the treatment of the bytes in the page that +corresponds to the end of a mapped file that is not a multiple +of the page size, see NOTES. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -678,8 +680,10 @@ with the same attributes. .PP A file is mapped in multiples of the page size. For a file that is not -a multiple of the page size, the remaining memory is zeroed when mapped, -and writes to that region are not written out to the file. +a multiple of the page size, +the remaining bytes in the partial page at the end of the mapping +are zeroed when mapped, +and modifications to that region are not written out to the file. The effect of changing the size of the underlying file of a mapping on the pages that correspond to added or removed regions of the file is unspecified. @@ -839,7 +843,7 @@ to be a multiple of the underlying huge page size. .PP For .BR munmap (), -.I addr +.IR addr , and .I length must both be a multiple of the underlying huge page size. @@ -1016,7 +1020,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap2.2 b/man2/mmap2.2 index ca74ea7a3..4ef1152f6 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.09 of the Linux +This page is part of release 5.10 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 1d8054994..5f273a2bc 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mount.2 b/man2/mount.2 index 6f1c92375..82d3e9640 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -37,7 +37,7 @@ .\" 2008-10-06, mtk: move umount*() material into separate umount.2 page. .\" 2008-10-06, mtk: Add discussion of namespaces. .\" -.TH MOUNT 2 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH MOUNT 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME mount \- mount filesystem .SH SYNOPSIS @@ -280,6 +280,18 @@ the flag to .BR open (2) was specified for all file opens to this filesystem). +.TP +.BR MS_NOSYMFOLLOW " (since Linux 5.10)" +.\" dab741e0e02bd3c4f5e2e97be74b39df2523fc6e +Do not follow symbolic links when resolving paths. +Symbolic links can still be created, +and +.BR readlink (1), +.BR readlink (2), +.BR realpath (1), +and +.BR realpath (3) +all still work properly. .PP From Linux 2.4 onward, some of the above flags are settable on a per-mount basis, @@ -950,7 +962,7 @@ for details of this file. .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d071bba3b..611905f78 100644 --- a/man2/move_pages.2 +++ b/man2/move_pages.2 @@ -258,7 +258,7 @@ or a similar package. .BR migratepages (8), .BR numastat (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mprotect.2 b/man2/mprotect.2 index 243f0eb62..e7a1e2a8a 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -371,7 +371,7 @@ main(int argc, char *argv[]) .BR sysconf (3), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 556c3be9f..e11c2018f 100644 --- a/man2/mq_getsetattr.2 +++ b/man2/mq_getsetattr.2 @@ -56,7 +56,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mremap.2 b/man2/mremap.2 index f80f5f0a1..8f296ba8d 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -367,7 +367,7 @@ for more information on paged memory \fIInside Linux\fP by Randolph Bentson, \fIThe Design of the UNIX Operating System\fP by Maurice J.\& Bach) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgctl.2 b/man2/msgctl.2 index bfdc7f25d..432ecd7a9 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -60,19 +60,16 @@ data structure is defined in \fI<sys/msg.h>\fP as follows: .in +4n .EX 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; /* 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 - in queue */ - msglen_t msg_qbytes; /* Maximum number of bytes - allowed in queue */ - pid_t msg_lspid; /* PID of last msgsnd(2) */ - pid_t msg_lrpid; /* PID of last msgrcv(2) */ + 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 creation or last + modification by msgctl() */ + unsigned long msg_cbytes; /* # of bytes in queue */ + msgqnum_t msg_qnum; /* # number of messages in queue */ + msglen_t msg_qbytes; /* Maximum # of bytes in queue */ + pid_t msg_lspid; /* PID of last msgsnd(2) */ + pid_t msg_lrpid; /* PID of last msgrcv(2) */ }; .EE .in @@ -87,6 +84,26 @@ This is an structure (see below) that specifies the access permissions on the message queue. .TP +.I msg_stime +Time of the last +.BR msgsnd (2) +system call. +.TP +.I msg_rtime +Time of the last +.BR msgrcv (2) +system call. +.TP +.I msg_ctime +Time of creation of queue or time of last +.BR msgctl () +.BR IPC_SET +operation. +.TP +.I msg_cbytes +Number of bytes in all messages currently on the message queue. +This is a nonstandard Linux extension that is not specified in POSIX. +.TP .I msg_qnum Number of messages currently on the message queue. .TP @@ -103,22 +120,6 @@ system call. ID of the process that performed the last .BR msgrcv (2) system call. -.TP -.I msg_stime -Time of the last -.BR msgsnd (2) -system call. -.TP -.I msg_rtime -Time of the last -.BR msgrcv (2) -system call. -.TP -.I msg_ctime -Time of creation of queue or time of last -.BR msgctl () -.BR IPC_SET -operation. .PP The .I ipc_perm @@ -180,12 +181,14 @@ to the kernel data structure associated with this message queue, updating also its .I msg_ctime member. +.IP The following members of the structure are updated: .IR msg_qbytes , .IR msg_perm.uid , .IR msg_perm.gid , and (the least significant 9 bits of) .IR msg_perm.mode . +.IP The effective UID of the calling process must match the owner .RI ( msg_perm.uid ) or creator @@ -421,7 +424,7 @@ to include these header files. .PP The .BR IPC_INFO , -.B MSG_STAT +.BR MSG_STAT , and .B MSG_INFO operations are used by the @@ -452,7 +455,7 @@ flag in .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgget.2 b/man2/msgget.2 index a2577e4bb..215593b29 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgop.2 b/man2/msgop.2 index 874dd2fa1..2c63e2a62 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -718,7 +718,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msync.2 b/man2/msync.2 index 9fdd0a26a..28f105c5b 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -152,7 +152,7 @@ in .PP B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128\(en129 and 389\(en391. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index 5f9ac7892..64fd2aed8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nfsservctl.2 b/man2/nfsservctl.2 index a090becfa..95948749b 100644 --- a/man2/nfsservctl.2 +++ b/man2/nfsservctl.2 @@ -66,7 +66,7 @@ This call is Linux-specific. .SH SEE ALSO .BR nfsd (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nice.2 b/man2/nice.2 index e3382545e..d6204d7ce 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -130,7 +130,7 @@ to obtain the new nice value, which is then returned to the caller. .BR capabilities (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/open.2 b/man2/open.2 index 5a4a464b7..6ee5909ab 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -1899,7 +1899,7 @@ is ignored). .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 abd8b3b3d..a0cdefe80 100644 --- a/man2/open_by_handle_at.2 +++ b/man2/open_by_handle_at.2 @@ -765,7 +765,7 @@ release at .UR https://www.kernel.org/pub/linux/utils/util\-linux/ .UE .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/openat2.2 b/man2/openat2.2 index 3601c4d99..cdfd281c6 100644 --- a/man2/openat2.2 +++ b/man2/openat2.2 @@ -29,7 +29,7 @@ openat2 \- open and possibly create a file (extended) .B #include <sys/types.h> .B #include <sys/stat.h> .B #include <fcntl.h> -.B #include <openat2.h> +.B #include <linux/openat2.h> .PP .BI "long openat2(int " dirfd ", const char *" pathname , .BI " struct open_how *" how ", size_t " size ); @@ -582,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/outb.2 b/man2/outb.2 index 59f12b66c..f4ffd353a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pause.2 b/man2/pause.2 index 8f97fb4b4..3a557e48e 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.09 of the Linux +This page is part of release 5.10 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 5803b5d6a..7e0926373 100644 --- a/man2/pciconfig_read.2 +++ b/man2/pciconfig_read.2 @@ -113,7 +113,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.09 of the Linux +This page is part of release 5.10 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 8a8102db0..dcd3ea996 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -126,7 +126,7 @@ The leader is created first, with The rest of the group members are created with subsequent .BR perf_event_open () calls with -.IR group_fd +.I group_fd being set to the file descriptor of the group leader. (A single event on its own is created with .IR group_fd " = \-1" @@ -162,7 +162,7 @@ then .TP .BR PERF_FLAG_FD_NO_GROUP This flag tells the event to ignore the -.IR group_fd +.I group_fd parameter except for the purpose of setting up output redirection using the .B PERF_FLAG_FD_OUTPUT @@ -247,8 +247,17 @@ struct perf_event_attr { due to exec */ use_clockid : 1, /* use clockid for time fields */ context_switch : 1, /* context switch data */ + write_backward : 1, /* Write ring buffer from end + to beginning */ + namespaces : 1, /* include namespaces data */ + ksymbol : 1, /* include ksymbol events */ + bpf_event : 1, /* include bpf events */ + aux_output : 1, /* generate AUX records + instead of events */ + cgroup : 1, /* include cgroup events */ + text_poke : 1, /* include text poke events */ - __reserved_1 : 37; + __reserved_1 : 30; union { __u32 wakeup_events; /* wakeup every n events */ @@ -352,7 +361,11 @@ These two dynamic PMUs create a kprobe/uprobe and attach it to the file descriptor generated by perf_event_open. The kprobe/uprobe will be destroyed on the destruction of the file descriptor. See fields -.IR kprobe_func ", " uprobe_path ", " kprobe_addr ", and " probe_offset +.IR kprobe_func , +.IR uprobe_path , +.IR kprobe_addr , +and +.I probe_offset for more details. .RE .TP @@ -401,7 +414,9 @@ the .I type field. The -.IR config1 " and " config2 +.I config1 +and +.I config2 fields are also taken into account in cases where 64 bits is not enough to fully specify the event. The encoding of these fields are event dependent. @@ -557,13 +572,16 @@ is then we are measuring a hardware CPU cache event. To calculate the appropriate .I config -value use the following equation: -.PP +value, use the following equation: .RS 4 -.nf - (perf_hw_cache_id) | (perf_hw_cache_op_id << 8) | - (perf_hw_cache_op_result_id << 16) -.fi +.PP +.in +4n +.EX +config = (perf_hw_cache_id) | + (perf_hw_cache_op_id << 8) | + (perf_hw_cache_op_result_id << 16); +.EE +.in .PP where .I perf_hw_cache_id @@ -649,24 +667,28 @@ Its parameters are set in other places. If .I type is -.BR kprobe +.B kprobe or .BR uprobe , set -.IR retprobe +.I retprobe (bit 0 of .IR config , see .IR /sys/bus/event_source/devices/[k,u]probe/format/retprobe ) for kretprobe/uretprobe. See fields -.IR kprobe_func ", " uprobe_path ", " kprobe_addr ", and " probe_offset +.IR kprobe_func , +.IR uprobe_path , +.IR kprobe_addr , +and +.I probe_offset for more details. .RE .TP .IR kprobe_func ", " uprobe_path ", " kprobe_addr ", and " probe_offset These fields describe the kprobe/uprobe for dynamic PMUs -.BR kprobe +.B kprobe and .BR uprobe . For @@ -709,7 +731,7 @@ to try and achieve the desired rate. The rate of adjustment is a timer tick. .TP -.I "sample_type" +.I sample_type The various bits in this field specify which values to include in the sample. They will be recorded in a ring-buffer, @@ -854,9 +876,23 @@ is set higher than zero then the register values returned are those captured by hardware at the time of the sampled instruction's retirement. +.TP +.BR PERF_SAMPLE_PHYS_ADDR " (since Linux 4.13)" +.\" commit fc7ce9c74c3ad232b084d80148654f926d01ece7 +Records physical address of data like in +.BR PERF_SAMPLE_ADDR . +.TP +.BR PERF_SAMPLE_CGROUP " (since Linux 5.7)" +.\" commit 96aaab686505c449e24d76e76507290dcc30e008 +Records (perf_event) cgroup ID of the process. +This corresponds to the +.I id +field in the +.B PERF_RECORD_CGROUP +event. .RE .TP -.IR "read_format" +.I read_format This field specifies the format of the data returned by .BR read (2) on a @@ -885,7 +921,7 @@ Adds a 64-bit unique value that corresponds to the event group. Allows all counter values in an event group to be read with one read. .RE .TP -.IR "disabled" +.I disabled The .I disabled bit specifies whether the counter starts out disabled or enabled. @@ -906,7 +942,7 @@ Despite being 0, the child events will not start until the group leader is enabled. .TP -.IR "inherit" +.I inherit The .I inherit bit specifies that this counter should count events of child @@ -920,7 +956,7 @@ Inherit does not work for some combinations of values, such as .BR PERF_FORMAT_GROUP . .TP -.IR "pinned" +.I pinned The .I pinned bit specifies that the counter should always be on the CPU if at all @@ -933,7 +969,7 @@ return end-of-file (i.e., .BR read (2) returns 0) until the counter is subsequently enabled or disabled. .TP -.IR "exclusive" +.I exclusive The .I exclusive bit specifies that when this counter's group is on the CPU, @@ -949,13 +985,13 @@ This includes any users running a system-wide measurement as well as any kernel use of the performance counters (including the commonly enabled NMI Watchdog Timer interface). .TP -.IR "exclude_user" +.I exclude_user If this bit is set, the count excludes events that happen in user space. .TP -.IR "exclude_kernel" +.I exclude_kernel If this bit is set, the count excludes events that happen in kernel space. .TP -.IR "exclude_hv" +.I exclude_hv If this bit is set, the count excludes events that happen in the hypervisor. This is mainly for PMUs that have built-in support for handling this @@ -963,12 +999,12 @@ This is mainly for PMUs that have built-in support for handling this Extra support is needed for handling hypervisor measurements on most machines. .TP -.IR "exclude_idle" +.I exclude_idle If set, don't count when the CPU is running the idle task. While you can currently enable this for any event type, it is ignored for all but software events. .TP -.IR "mmap" +.I mmap The .I mmap bit enables generation of @@ -982,7 +1018,7 @@ This allows tools to notice new executable code being mapped into a program (dynamic shared libraries for example) so that addresses can be mapped back to the original code. .TP -.IR "comm" +.I comm The .I comm bit enables tracking of process command name as modified by the @@ -1001,30 +1037,30 @@ can be used to differentiate the .BR exec (2) case from the others. .TP -.IR "freq" +.I freq If this bit is set, then .I sample_frequency not .I sample_period is used when setting up the sampling interval. .TP -.IR "inherit_stat" +.I inherit_stat This bit enables saving of event counts on context switch for inherited tasks. This is meaningful only if the .I inherit field is set. .TP -.IR "enable_on_exec" +.I enable_on_exec If this bit is set, a counter is automatically enabled after a call to .BR exec (2). .TP -.IR "task" +.I task If this bit is set, then fork/exit notifications are included in the ring buffer. .TP -.IR "watermark" +.I watermark If set, have an overflow notification happen when we cross the .I wakeup_watermark boundary. @@ -1032,7 +1068,7 @@ Otherwise, overflow notifications happen after .I wakeup_events samples. .TP -.IR "precise_ip" " (since Linux 2.6.35)" +.IR precise_ip " (since Linux 2.6.35)" .\" commit ab608344bcbde4f55ec4cd911b686b0ce3eae076 This controls the amount of skid. Skid is how many instructions @@ -1061,7 +1097,7 @@ See also the description of .BR PERF_RECORD_MISC_EXACT_IP . .RE .TP -.IR "mmap_data" " (since Linux 2.6.36)" +.IR mmap_data " (since Linux 2.6.36)" .\" commit 3af9e859281bda7eb7c20b51879cf43aa788ac2e This is the counterpart of the .I mmap @@ -1074,7 +1110,7 @@ calls that do not have .B PROT_EXEC set (for example data and SysV shared memory). .TP -.IR "sample_id_all" " (since Linux 2.6.38)" +.IR sample_id_all " (since Linux 2.6.38)" .\" commit c980d1091810df13f21aabbce545fd98f545bbf7 If set, then TID, TIME, ID, STREAM_ID, and CPU can additionally be included in @@ -1106,7 +1142,7 @@ struct sample_id { .EE .in .TP -.IR "exclude_host" " (since Linux 3.2)" +.IR exclude_host " (since Linux 3.2)" .\" commit a240f76165e6255384d4bdb8139895fac7988799 When conducting measurements that include processes running VM instances (i.e., have executed a @@ -1117,7 +1153,7 @@ This is only meaningful outside the guests; this setting does not change counts gathered inside of a guest. Currently, this functionality is x86 only. .TP -.IR "exclude_guest" " (since Linux 3.2)" +.IR exclude_guest " (since Linux 3.2)" .\" commit a240f76165e6255384d4bdb8139895fac7988799 When conducting measurements that include processes running VM instances (i.e., have executed a @@ -1128,15 +1164,15 @@ This is only meaningful outside the guests; this setting does not change counts gathered inside of a guest. Currently, this functionality is x86 only. .TP -.IR "exclude_callchain_kernel" " (since Linux 3.7)" +.IR exclude_callchain_kernel " (since Linux 3.7)" .\" commit d077526485d5c9b12fe85d0b2b3b7041e6bc5f91 Do not include kernel callchains. .TP -.IR "exclude_callchain_user" " (since Linux 3.7)" +.IR exclude_callchain_user " (since Linux 3.7)" .\" commit d077526485d5c9b12fe85d0b2b3b7041e6bc5f91 Do not include user callchains. .TP -.IR "mmap2" " (since Linux 3.16)" +.IR mmap2 " (since Linux 3.16)" .\" commit 13d7a2410fa637f450a29ecb515ac318ee40c741 .\" This is tricky; was committed during 3.12 development .\" but right before release was disabled. @@ -1149,7 +1185,7 @@ The .I mmap flag must also be set for this to work. .TP -.IR "comm_exec" " (since Linux 3.16)" +.IR comm_exec " (since Linux 3.16)" .\" commit 82b897782d10fcc4930c9d4a15b175348fdd2871 This is purely a feature-detection flag, it does not change kernel behavior. @@ -1165,7 +1201,7 @@ reported was caused by a call to This allows tools to distinguish between the various types of process renaming. .TP -.IR "use_clockid" " (since Linux 4.1)" +.IR use_clockid " (since Linux 4.1)" .\" commit 34f439278cef7b1177f8ce24f9fc81dfc6221d3b This allows selecting which internal Linux clock to use when generating timestamps via the @@ -1174,7 +1210,7 @@ field. This can make it easier to correlate perf sample times with timestamps generated by other tools. .TP -.IR "context_switch" " (since Linux 4.3)" +.IR context_switch " (since Linux 4.3)" .\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 This enables the generation of .B PERF_RECORD_SWITCH @@ -1189,7 +1225,50 @@ information even with strict .I perf_event_paranoid settings. .TP -.IR "wakeup_events" ", " "wakeup_watermark" +.IR write_backward " (since Linux 4.6)" +.\" commit 9ecda41acb971ebd07c8fb35faf24005c0baea12 +This causes the ring buffer to be written from the end to the beginning. +This is to support reading from overwritable ring buffer. +.TP +.IR namespaces " (since Linux 4.11)" +.\" commit e422267322cd319e2695a535e47c5b1feeac45eb +This enables the generation of +.B PERF_RECORD_NAMESPACES +records when a task enters a new namespace. +Each namespace has a combination of device and inode numbers. +.TP +.IR ksymbol " (since Linux 5.0)" +.\" commit 76193a94522f1d4edf2447a536f3f796ce56343b +This enables the generation of +.B PERF_RECORD_KSYMBOL +records when new kernel symbols are registered or unregistered. +This is analyzing dynamic kernel functions like eBPF. +.TP +.IR bpf_event " (since Linux 5.0)" +.\" commit 6ee52e2a3fe4ea35520720736e6791df1fb67106 +This enables the generation of +.B PERF_RECORD_BPF_EVENT +records when an eBPF program is loaded or unloaded. +.TP +.IR auxevent " (since Linux 5.4)" +.\" commit ab43762ef010967e4ccd53627f70a2eecbeafefb +This allows normal (non-AUX) events to generate data for AUX events +if the hardware supports it. +.TP +.IR cgroup " (since Linux 5.7)" +.\" commit 96aaab686505c449e24d76e76507290dcc30e008 +This enables the generation of +.B PERF_RECORD_CGROUP +records when a new cgroup is created (and activated). +.TP +.IR text_poke " (since Linux 5.8)" +.\" commit e17d43b93e544f5016c0251d2074c15568d5d963 +This enables the generation of +.B PERF_RECORD_TEXT_POKE +records when there's a changes to the kernel text +(i.e., self-modifying code). +.TP +.IR wakeup_events ", " wakeup_watermark This union sets how many samples .RI ( wakeup_events ) or bytes @@ -1215,25 +1294,25 @@ Prior to Linux 3.0, setting to 0 resulted in no overflow notifications; more recent kernels treat 0 the same as 1. .TP -.IR "bp_type" " (since Linux 2.6.33)" +.IR bp_type " (since Linux 2.6.33)" .\" commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e This chooses the breakpoint type. It is one of: .RS .TP -.BR HW_BREAKPOINT_EMPTY +.B HW_BREAKPOINT_EMPTY No breakpoint. .TP -.BR HW_BREAKPOINT_R +.B HW_BREAKPOINT_R Count when we read the memory location. .TP -.BR HW_BREAKPOINT_W +.B HW_BREAKPOINT_W Count when we write the memory location. .TP -.BR HW_BREAKPOINT_RW +.B HW_BREAKPOINT_RW Count when we read or write the memory location. .TP -.BR HW_BREAKPOINT_X +.B HW_BREAKPOINT_X Count when we execute code at the memory location. .PP The values can be combined via a bitwise or, but the @@ -1246,14 +1325,14 @@ with is not allowed. .RE .TP -.IR "bp_addr" " (since Linux 2.6.33)" +.IR bp_addr " (since Linux 2.6.33)" .\" commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e This is the address of the breakpoint. For execution breakpoints, this is the memory address of the instruction of interest; for read and write breakpoints, it is the memory address of the memory location of interest. .TP -.IR "config1" " (since Linux 2.6.39)" +.IR config1 " (since Linux 2.6.39)" .\" commit a7e3ed1e470116c9d12c2f778431a481a6be8ab6 .I config1 is used for setting events that need an extra register or otherwise @@ -1261,7 +1340,7 @@ do not fit in the regular config field. Raw OFFCORE_EVENTS on Nehalem/Westmere/SandyBridge use this field on Linux 3.3 and later kernels. .TP -.IR "bp_len" " (since Linux 2.6.33)" +.IR bp_len " (since Linux 2.6.33)" .\" commit 24f1e32c60c45c89a997c73395b69c8af6f0a84e .I bp_len is the length of the breakpoint being measured if @@ -1277,14 +1356,14 @@ and For an execution breakpoint, set this to .IR sizeof(long) . .TP -.IR "config2" " (since Linux 2.6.39)" +.IR config2 " (since Linux 2.6.39)" .\" commit a7e3ed1e470116c9d12c2f778431a481a6be8ab6 .I config2 is a further extension of the .I config1 field. .TP -.IR "branch_sample_type" " (since Linux 3.4)" +.IR branch_sample_type " (since Linux 3.4)" .\" commit bce38cd53e5ddba9cb6d708c4ef3d04a4016ec7e If .B PERF_SAMPLE_BRANCH_STACK @@ -1355,20 +1434,20 @@ This requires hardware support, currently only found on Intel x86 Haswell or newer. .RE .TP -.IR "sample_regs_user" " (since Linux 3.7)" +.IR sample_regs_user " (since Linux 3.7)" .\" commit 4018994f3d8785275ef0e7391b75c3462c029e56 This bit mask defines the set of user CPU registers to dump on samples. The layout of the register mask is architecture-specific and is described in the kernel header file .IR arch/ARCH/include/uapi/asm/perf_regs.h . .TP -.IR "sample_stack_user" " (since Linux 3.7)" +.IR sample_stack_user " (since Linux 3.7)" .\" commit c5ebcedb566ef17bda7b02686e0d658a7bb42ee7 This defines the size of the user stack to dump if .B PERF_SAMPLE_STACK_USER is specified. .TP -.IR "clockid" " (since Linux 4.1)" +.IR clockid " (since Linux 4.1)" .\" commit 34f439278cef7b1177f8ce24f9fc81dfc6221d3b If .I use_clockid @@ -1385,13 +1464,13 @@ and .B CLOCK_TAI currently supported. .TP -.IR "aux_watermark" " (since Linux 4.1)" +.IR aux_watermark " (since Linux 4.1)" .\" commit 1a5941312414c71dece6717da9a0fa1303127afa This specifies how much data is required to trigger a .B PERF_RECORD_AUX sample. .TP -.IR "sample_max_stack" " (since Linux 4.8)" +.IR sample_max_stack " (since Linux 4.8)" .\" commit 97c79a38cd454602645f0470ffb444b3b75ce574 When .I sample_type @@ -1679,34 +1758,39 @@ delta since .I time_enabled (in nanoseconds) using rdtsc or similar. .IP -.nf - u64 quot, rem; - u64 delta; - quot = (cyc >> time_shift); - rem = cyc & (((u64)1 << time_shift) \- 1); - delta = time_offset + quot * time_mult + - ((rem * time_mult) >> time_shift); -.fi +.in +4n +.EX +u64 quot, rem; +u64 delta; + +quot = cyc >> time_shift; +rem = cyc & (((u64)1 << time_shift) \- 1); +delta = time_offset + quot * time_mult + + ((rem * time_mult) >> time_shift); +.EE +.in .IP Where .IR time_offset , .IR time_mult , .IR time_shift , and -.IR cyc +.I cyc are read in the seqcount loop described above. This delta can then be added to enabled and possible running (if idx), improving the scaling: .IP -.nf - enabled += delta; - if (idx) - running += delta; - quot = count / running; - rem = count % running; - count = quot * enabled + (rem * enabled) / running; -.fi +.in +4n +.EX +enabled += delta; +if (idx) + running += delta; +quot = count / running; +rem = count % running; +count = quot * enabled + (rem * enabled) / running; +.EE +.in .TP .IR time_zero " (since Linux 3.12)" .\" commit fa7315871046b9a4c48627905691dbde57e51033 @@ -1715,23 +1799,31 @@ If .I cap_usr_time_zero is set, then the hardware clock (the TSC timestamp counter on x86) can be calculated from the -.IR time_zero ", " time_mult ", and " time_shift " values:" +.IR time_zero , +.IR time_mult , +and +.I time_shift +values: .IP -.nf - time = timestamp - time_zero; - quot = time / time_mult; - rem = time % time_mult; - cyc = (quot << time_shift) + (rem << time_shift) / time_mult; -.fi +.in +4n +.EX +time = timestamp - time_zero; +quot = time / time_mult; +rem = time % time_mult; +cyc = (quot << time_shift) + (rem << time_shift) / time_mult; +.EE +.in .IP And vice versa: .IP -.nf - quot = cyc >> time_shift; - rem = cyc & (((u64)1 << time_shift) - 1); - timestamp = time_zero + quot * time_mult + - ((rem * time_mult) >> time_shift); -.fi +.in +4n +.EX +quot = cyc >> time_shift; +rem = cyc & (((u64)1 << time_shift) - 1); +timestamp = time_zero + quot * time_mult + + ((rem * time_mult) >> time_shift); +.EE +.in .TP .I data_head This points to the head of the data section. @@ -1782,7 +1874,7 @@ The desired offset and size must be page aligned, and the size must be a power of two. These values are then passed to mmap in order to map the AUX buffer. Pages in the AUX buffer are included as part of the -.BR RLIMIT_MEMLOCK +.B RLIMIT_MEMLOCK resource limit (see .BR setrlimit (2)), and also as part of the @@ -1799,10 +1891,14 @@ new data began, and it is the consumer's job to disable measurement while reading to avoid possible data races. .IP The -.IR aux_head " and " aux_tail +.I aux_head +and +.I aux_tail ring buffer pointers have the same behavior and ordering rules as the previous described -.IR data_head " and " data_tail . +.I data_head +and +.IR data_tail . .PP The following 2^n ring-buffer pages have the layout described below. .PP @@ -1894,9 +1990,9 @@ system call. .BR PERF_RECORD_MISC_SWITCH_OUT " (since Linux 4.3)" .\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 When a -.BR PERF_RECORD_SWITCH +.B PERF_RECORD_SWITCH or -.BR PERF_RECORD_SWITCH_CPU_WIDE +.B PERF_RECORD_SWITCH_CPU_WIDE record is generated, this bit indicates that the context switch is away from the current process (instead of into the current process). @@ -2101,7 +2197,7 @@ struct { u64 nr; /* if PERF_SAMPLE_CALLCHAIN */ u64 ips[nr]; /* if PERF_SAMPLE_CALLCHAIN */ u32 size; /* if PERF_SAMPLE_RAW */ - char data[size]; /* if PERF_SAMPLE_RAW */ + char data[size]; /* if PERF_SAMPLE_RAW */ u64 bnr; /* if PERF_SAMPLE_BRANCH_STACK */ struct perf_branch_entry lbr[bnr]; /* if PERF_SAMPLE_BRANCH_STACK */ @@ -2118,6 +2214,8 @@ struct { u64 abi; /* if PERF_SAMPLE_REGS_INTR */ u64 regs[weight(mask)]; /* if PERF_SAMPLE_REGS_INTR */ + u64 phys_addr; /* if PERF_SAMPLE_PHYS_ADDR */ + u64 cgroup; /* if PERF_SAMPLE_CGROUP */ }; .EE .in @@ -2264,7 +2362,7 @@ Support for .IR mispred , .IR predicted , and -.IR cycles +.I cycles is optional; if not supported, those values will be 0. .PP @@ -2281,7 +2379,9 @@ is enabled, then the user CPU registers are recorded. The .I abi field is one of -.BR PERF_SAMPLE_REGS_ABI_NONE ", " PERF_SAMPLE_REGS_ABI_32 " or" +.BR PERF_SAMPLE_REGS_ABI_NONE , +.BR PERF_SAMPLE_REGS_ABI_32 , +or .BR PERF_SAMPLE_REGS_ABI_64 . .IP The @@ -2538,6 +2638,19 @@ attr field. The number of values is the number of bits set in the .I sample_regs_intr bit mask. +.TP +.I phys_addr +If the +.B PERF_SAMPLE_PHYS_ADDR +flag is set, then the 64-bit physical address is recorded. +.TP +.I cgroup +If the +.B PERF_SAMPLE_CGROUP +flag is set, +then the 64-bit cgroup ID (for the perf_event subsystem) is recorded. +To get the pathname of the cgroup, the ID should match to one in a +.B PERF_RECORD_CGROUP . .RE .TP .B PERF_RECORD_MMAP2 @@ -2744,6 +2857,202 @@ or next (if switching out) process on the CPU. The thread ID of the previous (if switching in) or next (if switching out) thread on the CPU. .RE +.TP +.BR PERF_RECORD_NAMESPACES " (since Linux 4.11)" +.\" commit e422267322cd319e2695a535e47c5b1feeac45eb +This record includes various namespace information of a process. +.IP +.in +4n +.EX +struct { + struct perf_event_header header; + u32 pid; + u32 tid; + u64 nr_namespaces; + struct { u64 dev, inode } [nr_namespaces]; + struct sample_id sample_id; +}; +.EE +.in +.RS +.TP +.I pid +is the process ID +.TP +.I tid +is the thread ID +.TP +.I nr_namespace +is the number of namespaces in this record +.RE +.IP +Each namespace has +.I dev +and +.I inode +fields and is recorded in the +fixed position like below: +.RS +.TP +.BR NET_NS_INDEX = 0 +Network namespace +.TP +.BR UTS_NS_INDEX = 1 +UTS namespace +.TP +.BR IPC_NS_INDEX = 2 +IPC namespace +.TP +.BR PID_NS_INDEX = 3 +PID namespace +.TP +.BR USER_NS_INDEX = 4 +User namespace +.TP +.BR MNT_NS_INDEX = 5 +Mount namespace +.TP +.BR CGROUP_NS_INDEX = 6 +Cgroup namespace +.RE +.TP +.BR PERF_RECORD_KSYMBOL " (since Linux 5.0)" +.\" commit 76193a94522f1d4edf2447a536f3f796ce56343b +This record indicates kernel symbol register/unregister events. +.IP +.in +4n +.EX +struct { + struct perf_event_header header; + u64 addr; + u32 len; + u16 ksym_type; + u16 flags; + char name[]; + struct sample_id sample_id; +}; +.EE +.in +.RS +.TP +.I addr +is the address of the kernel symbol. +.TP +.I len +is the length of the kernel symbol. +.TP +.I ksym_type +is the type of the kernel symbol. +Currently the following types are available: +.RS +.TP +.B PERF_RECORD_KSYMBOL_TYPE_BPF +The kernel symbol is a BPF function. +.RE +.TP +.I flags +If the +.B PERF_RECORD_KSYMBOL_FLAGS_UNREGISTER +is set, then this event is for unregistering the kernel symbol. +.RE +.TP +.BR PERF_RECORD_BPF_EVENT " (since Linux 5.0)" +.\" commit 6ee52e2a3fe4ea35520720736e6791df1fb67106 +This record indicates BPF program is loaded or unloaded. +.IP +.in +4n +.EX +struct { + struct perf_event_header header; + u16 type; + u16 flags; + u32 id; + u8 tag[BPF_TAG_SIZE]; + struct sample_id sample_id; +}; +.EE +.in +.RS +.TP +.I type +is one of the following values: +.RS +.TP +.B PERF_BPF_EVENT_PROG_LOAD +A BPF program is loaded +.TP +.B PERF_BPF_EVENT_PROG_UNLOAD +A BPF program is unloaded +.RE +.TP +.I id +is the ID of the BPF program. +.TP +.I tag +is the tag of the BPF program. +Currently, +.B BPF_TAG_SIZE +is defined as 8. +.RE +.TP +.BR PERF_RECORD_CGROUP " (since Linux 5.7)" +.\" commit 96aaab686505c449e24d76e76507290dcc30e008 +This record indicates a new cgroup is created and activated. +.IP +.in +4n +.EX +struct { + struct perf_event_header header; + u64 id; + char path[]; + struct sample_id sample_id; +}; +.EE +.in +.RS +.TP +.I id +is the cgroup identifier. +This can be also retrieved by +.BR name_to_handle_at (2) +on the cgroup path (as a file handle). +.TP +.I path +is the path of the cgroup from the root. +.RE +.TP +.BR PERF_RECORD_TEXT_POKE " (since Linux 5.8)" +.\" commit e17d43b93e544f5016c0251d2074c15568d5d963 +This record indicates a change in the kernel text. +This includes addition and removal of the text +and the corresponding length is zero in this case. +.IP +.in +4n +.EX +struct { + struct perf_event_header header; + u64 addr; + u16 old_len; + u16 new_len; + u8 bytes[]; + struct sample_id sample_id; +}; +.EE +.in +.RS +.TP +.I addr +is the address of the change +.TP +.I old_len +is the old length +.TP +.I new_len +is the new length +.TP +.I bytes +contains old bytes immediately followed by new bytes. +.RE .RE .SS Overflow handling Events can be set to notify when a threshold is crossed, @@ -2972,7 +3281,7 @@ This allows querying which Berkeley Packet Filter (BPF) programs are attached to an existing kprobe tracepoint. You can only attach one BPF program per event, but you can have multiple events attached to a tracepoint. -Querying this value on one tracepoint event returns the id +Querying this value on one tracepoint event returns the ID of all BPF programs in all events attached to the tracepoint. You need .B CAP_PERFMON @@ -3002,7 +3311,7 @@ value is filled in by the kernel with the number of attached BPF programs. The .I ids -array is filled with the id of each attached BPF program. +array is filled with the ID of each attached BPF program. If there are more programs than will fit in the array, then the kernel will return .B ENOSPC @@ -3495,7 +3804,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2 index b514bb52e..dcfd58e86 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/personality.2 b/man2/personality.2 index 19d1bfb75..68195995e 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -270,7 +270,7 @@ be portable. .SH SEE ALSO .BR setarch (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 a12e4a10c..88ef939d6 100644 --- a/man2/pidfd_getfd.2 +++ b/man2/pidfd_getfd.2 @@ -155,7 +155,7 @@ ptrace access mode check. .BR kcmp (2), .BR pidfd_open (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 b14d31294..3e965d430 100644 --- a/man2/pidfd_open.2 +++ b/man2/pidfd_open.2 @@ -208,7 +208,7 @@ event. .\" .SS Program source \& -.nf +.EX #define _GNU_SOURCE #include <sys/types.h> #include <sys/syscall.h> @@ -259,7 +259,7 @@ main(int argc, char *argv[]) close(pidfd); exit(EXIT_SUCCESS); } -.fi +.EE .SH SEE ALSO .BR clone (2), .BR kill (2), @@ -271,7 +271,7 @@ main(int argc, char *argv[]) .BR waitid (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c44cf25ef..3898eef9e 100644 --- a/man2/pidfd_send_signal.2 +++ b/man2/pidfd_send_signal.2 @@ -177,7 +177,7 @@ if that process terminates, fails with the error .BR ESRCH . .SH EXAMPLES -.nf +.EX #define _GNU_SOURCE #include <limits.h> #include <signal.h> @@ -244,7 +244,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } -.fi +.EE .SH SEE ALSO .BR clone (2), .BR kill (2), @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pipe.2 b/man2/pipe.2 index 6aa18b212..13ae2bd1a 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -294,7 +294,7 @@ main(int argc, char *argv[]) .BR popen (3), .BR pipe (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 925294740..0df3b91dd 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -349,7 +349,7 @@ child(void *arg) return an error), and prevent propagation of mount events to the initial mount namespace */ - if (mount(NULL, "/", NULL, MS_REC | MS_PRIVATE, NULL) == 1) + if (mount(NULL, "/", NULL, MS_REC | MS_PRIVATE, NULL) == \-1) errExit("mount\-MS_PRIVATE"); /* Ensure that \(aqnew_root\(aq is a mount point */ @@ -418,7 +418,7 @@ main(int argc, char *argv[]) .BR pivot_root (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 4e7f6d20f..b7b88dd38 100644 --- a/man2/pkey_alloc.2 +++ b/man2/pkey_alloc.2 @@ -138,7 +138,7 @@ See .BR pkey_mprotect (2), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/poll.2 b/man2/poll.2 index 2bb631419..8fc5dc155 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -569,7 +569,7 @@ at which point the file descriptor was closed and the program terminated. .\" .SS Program source \& -.nf +.EX /* poll_input.c Licensed under GNU General Public License v2 or later. @@ -655,7 +655,7 @@ main(int argc, char *argv[]) printf("All file descriptors closed; bye\en"); exit(EXIT_SUCCESS); } -.fi +.EE .SH SEE ALSO .BR restart_syscall (2), .BR select (2), @@ -663,7 +663,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 75835b0df..6669e7398 100644 --- a/man2/posix_fadvise.2 +++ b/man2/posix_fadvise.2 @@ -241,7 +241,7 @@ rather than as meaning "all bytes through to the end of the file". .BR posix_fallocate (3), .BR posix_madvise (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/prctl.2 b/man2/prctl.2 index a595830a7..48738e4ee 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -1604,7 +1604,7 @@ Don't rely on it.) that accept pointers to arbitrary types cast to a .I void * or other generic type, specifically -.BR prctl (2), +.BR prctl (), .BR ioctl (2), and in general .BR setsockopt (2) @@ -2378,7 +2378,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pread.2 b/man2/pread.2 index 4233a403c..dbeb42f26 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.09 of the Linux +This page is part of release 5.10 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 2e1271d49..b1a9fc997 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -339,7 +339,7 @@ main(void) .BR readv (2), .BR writev (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ptrace.2 b/man2/ptrace.2 index 5f0e23e20..ef4fd40b5 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -2919,7 +2919,7 @@ to zero. .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 982a6262a..89f90ed8d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/quotactl.2 b/man2/quotactl.2 index 9f27597a3..e1c45710f 100644 --- a/man2/quotactl.2 +++ b/man2/quotactl.2 @@ -820,7 +820,7 @@ prefix. .BR quotacheck (8), .BR quotaon (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/read.2 b/man2/read.2 index a447da1bd..c5c1bdfd4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readahead.2 b/man2/readahead.2 index 073c20624..6adf44080 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readdir.2 b/man2/readdir.2 index da619f6f4..15417a390 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readlink.2 b/man2/readlink.2 index 7b187ca8d..e70310dd6 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -356,7 +356,7 @@ main(int argc, char *argv[]) .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readv.2 b/man2/readv.2 index b6a7a0171..edbca60a0 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 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH READV 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME readv, writev, preadv, pwritev, preadv2, pwritev2 \- read or write data into multiple buffers .SH SYNOPSIS @@ -119,9 +119,9 @@ Buffers are processed in array order. This means that .BR readv () completely fills -.IR iov [0] +.I iov[0] before proceeding to -.IR iov [1], +.IR iov[1] , and so on. (If there is insufficient data, then not all buffers pointed to by .I iov @@ -129,9 +129,9 @@ may be filled.) Similarly, .BR writev () writes out the entire contents of -.IR iov [0] +.I iov[0] before proceeding to -.IR iov [1], +.IR iov[1] , and so on. .PP The data transfers performed by @@ -267,12 +267,12 @@ argument is \-1, the current file offset is updated. .SH RETURN VALUE On success, .BR readv (), -.BR preadv () +.BR preadv (), and .BR preadv2 () return the number of bytes read; .BR writev (), -.BR pwritev () +.BR pwritev (), and .BR pwritev2 () return the number of bytes written. @@ -431,7 +431,7 @@ nwritten = writev(STDOUT_FILENO, iov, 2); .BR read (2), .BR write (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/reboot.2 b/man2/reboot.2 index 4c36cd1f3..b3a64a4f4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recv.2 b/man2/recv.2 index f28a46b55..ba606c5aa 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -576,7 +576,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recvmmsg.2 b/man2/recvmmsg.2 index 8bf56615e..2ea3b7e30 100644 --- a/man2/recvmmsg.2 +++ b/man2/recvmmsg.2 @@ -291,7 +291,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 dc5f0fc8d..ac0676cb8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/removexattr.2 b/man2/removexattr.2 index f5f98c4c0..3df9bd7dc 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rename.2 b/man2/rename.2 index 941e8f67e..b33716c1c 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -569,7 +569,7 @@ for a similar problem. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 823e9b0db..effcd710e 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -572,7 +572,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 fa2422339..3522957ea 100644 --- a/man2/restart_syscall.2 +++ b/man2/restart_syscall.2 @@ -30,11 +30,11 @@ .\" .\" See also Section 11.3.3 of Understanding the Linux Kernel, 3rd edition .\" -.TH RESTART_SYSCALL 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH RESTART_SYSCALL 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME restart_syscall \- restart a system call after interruption by a stop signal .SH SYNOPSIS -.B int restart_syscall(void); +.B long restart_syscall(void); .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 6739a0457..3bc65ff2d 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.09 of the Linux +This page is part of release 5.10 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 9050b3cfd..f0723a570 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.09 of the Linux +This page is part of release 5.10 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 f16c04ac8..33f3448b8 100644 --- a/man2/s390_guarded_storage.2 +++ b/man2/s390_guarded_storage.2 @@ -173,7 +173,7 @@ header. .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 059eac8f3..88ce226dc 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.09 of the Linux +This page is part of release 5.10 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 decacc4d2..be5920dfb 100644 --- a/man2/s390_runtime_instr.2 +++ b/man2/s390_runtime_instr.2 @@ -116,7 +116,7 @@ and install a handler for that signal. .BR syscall (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c2bfa95ab..63136ed5b 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.09 of the Linux +This page is part of release 5.10 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 b4dff5aaf..80b65a2ae 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.09 of the Linux +This page is part of release 5.10 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 12588ceb4..9f45e9ea2 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.09 of the Linux +This page is part of release 5.10 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 2e34dc1c6..f7b75d872 100644 --- a/man2/sched_setaffinity.2 +++ b/man2/sched_setaffinity.2 @@ -438,7 +438,7 @@ main(int argc, char *argv[]) .BR sched (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 008a965b6..14cfbdb84 100644 --- a/man2/sched_setattr.2 +++ b/man2/sched_setattr.2 @@ -454,7 +454,7 @@ passed by user space. .BR sched (7) .ad .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 9fee19785..178d4a28f 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.09 of the Linux +This page is part of release 5.10 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 75f2d0557..83567f277 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.09 of the Linux +This page is part of release 5.10 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 23ab999a6..ae697b796 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seccomp.2 b/man2/seccomp.2 index aef57dea6..2c490b1bd 100644 --- a/man2/seccomp.2 +++ b/man2/seccomp.2 @@ -1181,7 +1181,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/select.2 b/man2/select.2 index 1917e93dd..8bb2fd885 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -759,7 +759,7 @@ main(void) For a tutorial with discussion and examples, see .BR select_tut (2). .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 a347f69b9..36e35ee9c 100644 --- a/man2/select_tut.2 +++ b/man2/select_tut.2 @@ -650,7 +650,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semctl.2 b/man2/semctl.2 index 9504bd45b..d40195007 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -39,7 +39,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, SEM_INFO, SEM_STAT descriptions. .\" 2018-03-20, dbueso: Added SEM_STAT_ANY description. .\" -.TH SEMCTL 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SEMCTL 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME semctl \- System V semaphore control operations .SH SYNOPSIS @@ -94,6 +94,7 @@ struct semid_ds { }; .EE .in +.PP The fields of the .I semid_ds structure are as follows: @@ -190,11 +191,13 @@ to the kernel data structure associated with this semaphore set, updating also its .I sem_ctime member. +.IP The following members of the structure are updated: .IR sem_perm.uid , .IR sem_perm.gid , and (the least significant 9 bits of) .IR sem_perm.mode . +.IP The effective UID of the calling process must match the owner .RI ( sem_perm.uid ) or creator @@ -551,7 +554,7 @@ to include these header files. .PP The .BR IPC_INFO , -.B SEM_STAT +.BR SEM_STAT , and .B SEM_INFO operations are used by the @@ -650,7 +653,7 @@ See .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semget.2 b/man2/semget.2 index 8526ea699..470a18ced 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -397,7 +397,7 @@ ID = 9 .in .SS Program source \& -.nf +.EX /* t_semget.c Licensed under GNU General Public License v2 or later. @@ -456,7 +456,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } -.fi +.EE .SH SEE ALSO .BR semctl (2), .BR semop (2), @@ -465,7 +465,7 @@ main(int argc, char *argv[]) .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semop.2 b/man2/semop.2 index e2fab343f..5586ccfda 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -559,7 +559,7 @@ can be found in .BR sysvipc (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/send.2 b/man2/send.2 index c3d0e9743..c5962b130 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -491,7 +491,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendfile.2 b/man2/sendfile.2 index f4828abb9..ac32f353b 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -242,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendmmsg.2 b/man2/sendmmsg.2 index 11b0ef1bd..eb77d0345 100644 --- a/man2/sendmmsg.2 +++ b/man2/sendmmsg.2 @@ -248,7 +248,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 7fb009160..e3b7b96cc 100644 --- a/man2/set_mempolicy.2 +++ b/man2/set_mempolicy.2 @@ -24,7 +24,7 @@ .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com> .\" more precise specification of behavior. .\" -.TH SET_MEMPOLICY 2 2017-09-15 Linux "Linux Programmer's Manual" +.TH SET_MEMPOLICY 2 2020-12-21 Linux "Linux Programmer's Manual" .SH NAME set_mempolicy \- set default NUMA memory policy for a thread and its children .SH SYNOPSIS @@ -42,7 +42,7 @@ sets the NUMA memory policy of the calling thread, which consists of a policy mode and zero or more nodes, to the values specified by the .IR mode , -.I nodemask +.IR nodemask , and .I maxnode arguments. @@ -320,7 +320,7 @@ For information on library support, see .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 6a0e60578..46160d20f 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.09 of the Linux +This page is part of release 5.10 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 a4a687cfa..5c13b911d 100644 --- a/man2/set_tid_address.2 +++ b/man2/set_tid_address.2 @@ -22,14 +22,14 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SET_TID_ADDRESS 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SET_TID_ADDRESS 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME set_tid_address \- set pointer to thread ID .SH SYNOPSIS .nf .B #include <linux/unistd.h> .PP -.BI "long set_tid_address(int *" tidptr ); +.BI "pid_t set_tid_address(int *" tidptr ); .fi .PP .IR Note : @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 170fb7ef0..63d60ec3d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsgid.2 b/man2/setfsgid.2 index 2c96f3d6f..e6e2a2125 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsuid.2 b/man2/setfsuid.2 index a0b6cd0e7..0fe499dd9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setgid.2 b/man2/setgid.2 index 7ac5347d5..6a8088df8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setns.2 b/man2/setns.2 index 2cc7b4c93..6c5f67e0c 100644 --- a/man2/setns.2 +++ b/man2/setns.2 @@ -116,7 +116,7 @@ may refer to a PID file descriptor obtained from or .BR clone (3). In this usage, -.BR setns (2) +.BR setns () atomically moves the calling thread into one or more of the same namespaces as the thread referred to by .IR fd . @@ -397,9 +397,9 @@ main(int argc, char *argv[]) exit(EXIT_FAILURE); } - /* Get file descriptor for namespace; the file descriptor is opened with - O_CLOEXEC so as to ensure that it is not inherited by the program that - is later executed. */ + /* Get file descriptor for namespace; the file descriptor is opened + with O_CLOEXEC so as to ensure that it is not inherited by the + program that is later executed. */ fd = open(argv[1], O_RDONLY | O_CLOEXEC); if (fd == \-1) @@ -421,7 +421,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 19947f42b..605614421 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -335,7 +335,7 @@ in a different session (see also .BR termios (3), .BR credentials (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setresuid.2 b/man2/setresuid.2 index e920fa5cd..533f610bc 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setreuid.2 b/man2/setreuid.2 index d60f806ce..5d8cd7563 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setsid.2 b/man2/setsid.2 index 4b735c205..dd8db2510 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setuid.2 b/man2/setuid.2 index 0a522228a..1e4e10358 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setup.2 b/man2/setup.2 index b98363c5e..9dc5a14ae 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setxattr.2 b/man2/setxattr.2 index dce6e6eaf..b9ebe95da 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sgetmask.2 b/man2/sgetmask.2 index abd133661..4a22cb48a 100644 --- a/man2/sgetmask.2 +++ b/man2/sgetmask.2 @@ -89,7 +89,7 @@ or .BR sigprocmask (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmctl.2 b/man2/shmctl.2 index a108e14c8..0e8d27153 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -43,7 +43,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, SHM_INFO, SHM_STAT descriptions. .\" 2018-03-20, dbueso: Added SHM_STAT_ANY description. .\" -.TH SHMCTL 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SHMCTL 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME shmctl \- System V shared memory control .SH SYNOPSIS @@ -96,19 +96,6 @@ on the shared memory segment. .I shm_segsz Size in bytes of the shared memory segment. .TP -.I shm_cpid -ID of the process that created the shared memory segment. -.TP -.I shm_lpid -ID of the last process that executed a -.BR shmat (2) -or -.BR shmdt (2) -system call on this segment. -.TP -.I shm_nattch -Number of processes that have this segment attached. -.TP .I shm_atime Time of the last .BR shmat (2) @@ -124,6 +111,19 @@ Time of creation of segment or time of the last .BR shmctl () .BR IPC_SET operation. +.TP +.I shm_cpid +ID of the process that created the shared memory segment. +.TP +.I shm_lpid +ID of the last process that executed a +.BR shmat (2) +or +.BR shmdt (2) +system call on this segment. +.TP +.I shm_nattch +Number of processes that have this segment attached. .PP The .I ipc_perm @@ -192,9 +192,11 @@ to the kernel data structure associated with this shared memory segment, updating also its .I shm_ctime member. -The following fields can be changed: +.IP +The following fields are updated: \fIshm_perm.uid\fP, \fIshm_perm.gid\fP, and (the least significant 9 bits of) \fIshm_perm.mode\fP. +.IP The effective UID of the calling process must match the owner .RI ( shm_perm.uid ) or creator @@ -478,7 +480,7 @@ to include these header files. .PP The .BR IPC_INFO , -.B SHM_STAT +.BR SHM_STAT , and .B SHM_INFO operations are used by the @@ -516,7 +518,7 @@ flag in .BR capabilities (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmget.2 b/man2/shmget.2 index 90e95db8f..7d35ea3ee 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -424,7 +424,7 @@ See .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmop.2 b/man2/shmop.2 index c7704f37e..4264ee741 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -506,7 +506,7 @@ main(int argc, char *argv[]) .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shutdown.2 b/man2/shutdown.2 index c71c4e495..5a13de9e3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaction.2 b/man2/sigaction.2 index 2abe30ccc..5ea62ebb5 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -45,7 +45,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH SIGACTION 2 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH SIGACTION 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH SYNOPSIS @@ -127,11 +127,15 @@ Some further details of the purpose of this field can be found in .I sa_handler specifies the action to be associated with .I signum -and may be +and is be one of the following: +.IP * 2 .B SIG_DFL -for the default action, +for the default action. +.IP * .B SIG_IGN -to ignore this signal, or a pointer to a signal handling function. +to ignore this signal. +.IP * +A pointer to a signal handling function. This function receives the signal number as its only argument. .PP If @@ -204,9 +208,13 @@ signal is generated in this case; on some other implementations, it is not. .TP .B SA_NODEFER -Do not prevent the signal from being received from within its own signal -handler. +Do not add the signal to the thread's signal mask while the +handler is executing, unless the signal is specified in +.IR act.sa_mask . +Consequently, a further instance of the signal may be delivered +to the thread while it is executing the handler. This flag is meaningful only when establishing a signal handler. +.IP .B SA_NOMASK is an obsolete, nonstandard synonym for this flag. .TP @@ -219,6 +227,7 @@ This flag is meaningful only when establishing a signal handler. .BR SA_RESETHAND Restore the signal action to the default upon entry to the signal handler. This flag is meaningful only when establishing a signal handler. +.IP .B SA_ONESHOT is an obsolete, nonstandard synonym for this flag. .TP @@ -292,7 +301,9 @@ on the user-space stack by the kernel; for details, see Further information about the .IR ucontext_t structure can be found in -.BR getcontext (3). +.BR getcontext (3) +and +.BR signal (7). Commonly, the handler function doesn't make any use of the third argument. .PP The @@ -762,10 +773,10 @@ Process breakpoint. .B TRAP_TRACE Process trace trap. .TP -.BR TRAP_BRANCH " (since Linux 2.4, IA64 only))" +.BR TRAP_BRANCH " (since Linux 2.4, IA64 only)" Process taken branch trap. .TP -.BR TRAP_HWBKPT " (since Linux 2.4, IA64 only))" +.BR TRAP_HWBKPT " (since Linux 2.4, IA64 only)" Hardware breakpoint/watchpoint. .RE .PP @@ -920,7 +931,7 @@ flag is compatible with the SVr4 flag of the same name. The .B SA_NODEFER flag is compatible with the SVr4 flag of the same name under kernels -1.3.9 and newer. +1.3.9 and later. On older kernels the Linux implementation allowed the receipt of any signal, not just the one we are installing (effectively overriding any @@ -1034,6 +1045,7 @@ 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. +.\" commit 69be8f189653cd81aae5a74e26615b12871bb72e .SH EXAMPLES See .BR mprotect (2). @@ -1061,7 +1073,7 @@ See .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index cc7b45357..01872edbe 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" aeb, various minor fixes -.TH SIGALTSTACK 2 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH SIGALTSTACK 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME sigaltstack \- set and/or get signal stack context .SH SYNOPSIS @@ -49,7 +49,7 @@ _XOPEN_SOURCE\ >=\ 500 .ad .SH DESCRIPTION .BR sigaltstack () -allows a process to define a new alternate +allows a thread to define a new alternate signal stack and/or retrieve the state of an existing alternate signal stack. An alternate signal stack is used during the @@ -153,15 +153,15 @@ address and size of that stack. The \fIold_ss.ss_flags\fP may return either of the following values: .TP .B SS_ONSTACK -The process is currently executing on the alternate signal stack. +The thread is currently executing on the alternate signal stack. (Note that it is not possible -to change the alternate signal stack if the process is +to change the alternate signal stack if the thread is currently executing on it.) .TP .B SS_DISABLE The alternate signal stack is currently disabled. .IP -Alternatively, this value is returned if the process is currently +Alternatively, this value is returned if the thread is currently executing on an alternate signal stack that was established using the .B SS_AUTODISARM flag. @@ -208,7 +208,7 @@ was less than .TP .B EPERM An attempt was made to change the alternate signal stack while -it was active (i.e., the process was already executing +it was active (i.e., the thread was already executing on the current alternate signal stack). .SH ATTRIBUTES For an explanation of the terms used in this section, see @@ -232,18 +232,18 @@ flag is a Linux extension. The most common usage of an alternate signal stack is to handle the .B SIGSEGV signal that is generated if the space available for the -normal process stack is exhausted: in this case, a signal handler for +standard stack is exhausted: in this case, a signal handler for .B SIGSEGV -cannot be invoked on the process stack; if we wish to handle it, +cannot be invoked on the standard stack; if we wish to handle it, we must use an alternate signal stack. .PP -Establishing an alternate signal stack is useful if a process +Establishing an alternate signal stack is useful if a thread expects that it may exhaust its standard stack. This may occur, for example, because the stack grows so large that it encounters the upwardly growing heap, or it reaches a limit established by a call to \fBsetrlimit(RLIMIT_STACK, &rlim)\fP. If the standard stack is exhausted, the kernel sends -the process a \fBSIGSEGV\fP signal. +the thread a \fBSIGSEGV\fP signal. In these circumstances the only way to catch this signal is on an alternate signal stack. .PP @@ -256,7 +256,7 @@ of the direction of stack growth. Functions called from a signal handler executing on an alternate signal stack will also use the alternate signal stack. (This also applies to any handlers invoked for other signals while -the process is executing on the alternate signal stack.) +the thread is executing on the alternate signal stack.) Unlike the standard stack, the system does not automatically extend the alternate signal stack. Exceeding the allocated size of the alternate signal stack will @@ -269,6 +269,14 @@ signal stack. A child process created via .BR fork (2) inherits a copy of its parent's alternate signal stack settings. +The same is also true for a child process created using +.BR clone (2), +unless the clone flags include +.BR CLONE_VM +and do not include +.BR CLONE_VFORK , +in which case any alternate signal stack that was established in the parent +is disabled in the child process. .PP .BR sigaltstack () supersedes the older @@ -367,7 +375,7 @@ if (sigaction(SIGSEGV, &sa, NULL) == -1) { .BR sigsetjmp (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signal.2 b/man2/signal.2 index 99c42f368..73a45e34b 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -43,7 +43,8 @@ signal \- ANSI C signal handling .PP .BI "sighandler_t signal(int " signum ", sighandler_t " handler ); .SH DESCRIPTION -The behavior of +.BR WARNING : + the behavior of .BR signal () varies across UNIX versions, and has also varied historically across different versions of Linux. @@ -291,7 +292,7 @@ provides System\ V semantics. .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signalfd.2 b/man2/signalfd.2 index 275e8828d..3eaba99c7 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -531,7 +531,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigpending.2 b/man2/sigpending.2 index ce1f19945..001305e52 100644 --- a/man2/sigpending.2 +++ b/man2/sigpending.2 @@ -124,7 +124,7 @@ is not correctly returned. .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2 index 89ed450dc..0be7d7557 100644 --- a/man2/sigprocmask.2 +++ b/man2/sigprocmask.2 @@ -230,7 +230,7 @@ when the kernel provides it. .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 index 795d186c2..dfaebb626 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2 index 76456a6fa..5a7822058 100644 --- a/man2/sigsuspend.2 +++ b/man2/sigsuspend.2 @@ -144,7 +144,7 @@ when the kernel provides it. .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2 index e38e883b4..ad0da0e42 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socket.2 b/man2/socket.2 index 80f277791..69fa357a6 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -521,7 +521,7 @@ and reprinted in .I UNIX Programmer's Supplementary Documents Volume 1. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketcall.2 b/man2/socketcall.2 index 6a789a2a6..988a6abf2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketpair.2 b/man2/socketpair.2 index 5d75ddba8..f7cbb3b17 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -62,9 +62,9 @@ For further details of these arguments, see .BR socket (2). .PP The file descriptors used in referencing the new sockets are returned in -.IR sv [0] +.I sv[0] and -.IR sv [1]. +.IR sv[1] . The two sockets are indistinguishable. .SH RETURN VALUE On success, zero is returned. @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/splice.2 b/man2/splice.2 index 4f93eb534..1e3814f55 100644 --- a/man2/splice.2 +++ b/man2/splice.2 @@ -271,7 +271,7 @@ See .BR vmsplice (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2196e9111..83a497f93 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 2020-06-09 Linux "Linux Programmer's Manual" +.TH SPU_CREATE 2 2020-12-21 Linux "Linux Programmer's Manual" .SH NAME spu_create \- create a new spu context .SH SYNOPSIS @@ -30,7 +30,6 @@ spu_create \- create a new spu context .B #include <sys/types.h> .B #include <sys/spu.h> .PP -.BI "int spu_create(const char *" pathname ", int " flags ", mode_t " mode ");" .BI "int spu_create(const char *" pathname ", int " flags ", mode_t " mode "," .BI " int " neighbor_fd ");" .fi @@ -77,6 +76,24 @@ this usually occurs when the file descriptor returned by is closed. .PP The +.I mode +argument (minus any bits set in the process's +.BR umask (2)) +specifies the permissions used for creating the new directory in +.BR spufs . +See +.BR stat (2) +for a full list of the possible +.I mode +values. +.PP +The +.I neighbor_fd +is used only when the +.B SPU_CREATE_AFFINITY_SPU +flag is specified; see below. +.PP +The .I flags argument can be zero or any bitwise OR-ed combination of the following constants: @@ -138,7 +155,8 @@ contexts also requires the .B SPU_CREATE_NOSCHED flag. .TP -.B SPU_CREATE_AFFINITY_SPU +.BR SPU_CREATE_AFFINITY_SPU " (since Linux 2.6.23)" +.\" commit 8e68e2f248332a9c3fd4f08258f488c209bd3e0c Create a context with affinity to another SPU context. This affinity information is used within the SPU scheduling algorithm. Using this flag requires that a file descriptor referring to @@ -146,22 +164,11 @@ the other SPU context be passed in the .I neighbor_fd argument. .TP -.B SPU_CREATE_AFFINITY_MEM +.BR SPU_CREATE_AFFINITY_MEM " (since Linux 2.6.23)" +.\" commit 8e68e2f248332a9c3fd4f08258f488c209bd3e0c Create a context with affinity to system memory. This affinity information is used within the SPU scheduling algorithm. -.PP -The -.I mode -argument (minus any bits set in the process's -.BR umask (2)) -specifies the permissions used for creating the new directory in -.BR spufs . -See -.BR stat (2) -for a full list of the possible -.I mode -values. .SH RETURN VALUE On success, .BR spu_create () @@ -262,6 +269,14 @@ See .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/ .UE for the recommended libraries. +.PP +Prior to the addition of the +.B SPU_CREATE_AFFINITY_SPU +flag in Linux 2.6.23, the +.BR spu_create () +system call took only three arguments (i.e., there was no +.I neighbor_fd +argument). .SH EXAMPLES See .BR spu_run (2) @@ -273,7 +288,7 @@ for an example of the use of .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c736925dc..c691a802d 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -87,6 +87,8 @@ A DMA alignment error occurred. .TP .B SPE_EVENT_INVALID_DMA An invalid MFC DMA command was attempted. +.\" SPE_EVENT_SPE_DATA_SEGMENT is defined, but does not seem to be generated +.\" at any point (in Linux 5.9 sources). .TP .B SPE_EVENT_SPE_DATA_STORAGE A DMA storage error occurred. @@ -267,7 +269,7 @@ int main(void) .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stat.2 b/man2/stat.2 index a59b6e903..ace613a13 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -718,7 +718,7 @@ main(int argc, char *argv[]) .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statfs.2 b/man2/statfs.2 index f71de8e04..6784d049d 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 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH STATFS 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME statfs, fstatfs \- get filesystem statistics .SH SYNOPSIS @@ -206,6 +206,11 @@ Writes are synched to the filesystem immediately (see the description of .B O_SYNC in .BR open (2)). +.TP +.BR ST_NOSYMFOLLOW " (since Linux 5.10)" +.\" dab741e0e02bd3c4f5e2e97be74b39df2523fc6e +Symbolic links are not followed when resolving paths; see +.BR mount (2). .PP Nobody knows what .I f_fsid @@ -391,7 +396,7 @@ for file descriptors created by .BR statvfs (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statx.2 b/man2/statx.2 index 94e9eb4c5..62ef7a133 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -575,7 +575,7 @@ is Linux-specific. .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stime.2 b/man2/stime.2 index d72dcb895..55f8d7e41 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.09 of the Linux +This page is part of release 5.10 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 8be1e6fc8..823fe4857 100644 --- a/man2/subpage_prot.2 +++ b/man2/subpage_prot.2 @@ -27,12 +27,12 @@ .\" in kernel commit fa28237cfcc5827553044cbd6ee52e33692b0faa .\" both written by Paul Mackerras <paulus@samba.org> .\" -.TH SUBPAGE_PROT 2 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH SUBPAGE_PROT 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME subpage_prot \- define a subpage protection for an address range .SH SYNOPSIS .nf -.BI "long subpage_prot(unsigned long " addr ", unsigned long " len , +.BI "int subpage_prot(unsigned long " addr ", unsigned long " len , .BI " uint32_t *" map ); .fi .PP @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/swapon.2 b/man2/swapon.2 index 82041eabe..831e5ac2a 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -207,7 +207,7 @@ is called, even if that flag bit is not set. .BR swapoff (8), .BR swapon (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/symlink.2 b/man2/symlink.2 index ddc365048..b823c726a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sync.2 b/man2/sync.2 index 642a8c943..5268a26de 100644 --- a/man2/sync.2 +++ b/man2/sync.2 @@ -159,7 +159,7 @@ before returning. .BR fdatasync (2), .BR fsync (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 310b4f696..544b0f0d3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscall.2 b/man2/syscall.2 index e7fd13d98..be4003a2d 100644 --- a/man2/syscall.2 +++ b/man2/syscall.2 @@ -392,7 +392,7 @@ main(int argc, char *argv[]) .BR errno (3), .BR vdso (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscalls.2 b/man2/syscalls.2 index 5eda88641..b6cc57637 100644 --- a/man2/syscalls.2 +++ b/man2/syscalls.2 @@ -28,7 +28,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SYSCALLS 2 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH SYSCALLS 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME syscalls \- Linux system calls .SH SYNOPSIS @@ -147,7 +147,7 @@ into a 2.4.x release after 2.4.15. When this is so, the version where the system call appeared in both of the major kernel series is listed. .PP -The list of system calls that are available as at kernel 5.9 +The list of system calls that are available as at kernel 5.10 (or in a few cases only on older kernels) is as follows: .\" .\" Looking at scripts/checksyscalls.sh in the kernel source is @@ -162,7 +162,7 @@ l l l. \fB_llseek\fP(2) 1.2 \fB_newselect\fP(2) 2.0 -\fB_sysctl\fP(2) 2.0 +\fB_sysctl\fP(2) 2.0 Removed in 5.5 \fBaccept\fP(2) 2.0 See notes on \fBsocketcall\fP(2) \fBaccept4\fP(2) 2.6.28 \fBaccess\fP(2) 1.0 @@ -525,6 +525,7 @@ T} \fBpreadv\fP(2) 2.6.30 \fBpreadv2\fP(2) 4.6 \fBprlimit64\fP(2) 2.6.36 +\fBprocess_madvise\fP(2) 5.10 \fBprocess_vm_readv\fP(2) 3.2 \fBprocess_vm_writev\fP(2) 3.2 \fBpselect6\fP(2) 2.6.16 @@ -965,7 +966,7 @@ and .I __NR_uname refer to the routines .IR sys_olduname (), -.IR sys_uname () +.IR sys_uname (), and .IR sys_newuname (). .IP * @@ -1116,7 +1117,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysctl.2 b/man2/sysctl.2 index 9f0fdfcd6..b00742e70 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -173,7 +173,7 @@ main(void) .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysfs.2 b/man2/sysfs.2 index 0f9d8ec27..c1e0a690d 100644 --- a/man2/sysfs.2 +++ b/man2/sysfs.2 @@ -114,7 +114,7 @@ There is no way to guess how large \fIbuf\fP should be. .BR proc (5), .BR sysfs (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index d7e632b99..5d8620fc7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syslog.2 b/man2/syslog.2 index 29b54fc46..6ba2866c6 100644 --- a/man2/syslog.2 +++ b/man2/syslog.2 @@ -387,7 +387,7 @@ different animals. .BR syslog (3), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tee.2 b/man2/tee.2 index 50355f797..56cd84c0d 100644 --- a/man2/tee.2 +++ b/man2/tee.2 @@ -216,7 +216,7 @@ main(int argc, char *argv[]) .BR vmsplice (2), .BR pipe (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/time.2 b/man2/time.2 index e738c0e98..acc428ff1 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.09 of the Linux +This page is part of release 5.10 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 f343f0c46..8c01461bf 100644 --- a/man2/timer_create.2 +++ b/man2/timer_create.2 @@ -500,7 +500,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 17a1df06d..30795109d 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.09 of the Linux +This page is part of release 5.10 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 a0a3e50fc..f3e1d7782 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 2020-06-09 Linux "Linux Programmer's Manual" +.TH TIMER_GETOVERRUN 2 2020-12-21 Linux "Linux Programmer's Manual" .SH NAME timer_getoverrun \- get overrun count for a POSIX per-process timer .SH SYNOPSIS @@ -121,11 +121,20 @@ then .BR timer_getoverrun () should return .BR DELAYTIMER_MAX . -However, Linux does not implement this feature: instead, +However, before Linux 4.19, +.\" http://bugzilla.kernel.org/show_bug.cgi?id=12665 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/ +Since Linux 4.19, +.\" commit 78c9c4dfbf8c04883941445a195276bb4bb92c76 +.BR timer_getoverrun () +returns +.B DELAYTIMER_MAX +(defined as +.B INT_MAX +in +.IR <limits.h> ) +in this case (and the overrun value is reset to 0). .SH EXAMPLES See .BR timer_create (2). @@ -140,7 +149,7 @@ See .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 835ef5bc7..6b4d952e5 100644 --- a/man2/timer_settime.2 +++ b/man2/timer_settime.2 @@ -214,7 +214,7 @@ See .BR timer_getoverrun (2), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 f57c121e6..e7365b7e3 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -726,7 +726,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/times.2 b/man2/times.2 index c74623e77..1d3b3e653 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tkill.2 b/man2/tkill.2 index 970856eb0..c3d78ca53 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/truncate.2 b/man2/truncate.2 index 83351df5d..2b5f3d252 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -276,7 +276,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umask.2 b/man2/umask.2 index 7dc49e1d0..786bfdda2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umount.2 b/man2/umount.2 index eb6d2b82e..1cef33c89 100644 --- a/man2/umount.2 +++ b/man2/umount.2 @@ -227,7 +227,7 @@ in more than one place, so specifying the device does not suffice). .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uname.2 b/man2/uname.2 index 9a4bad88c..80528f25f 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -46,7 +46,8 @@ struct utsname { char sysname[]; /* Operating system name (e.g., "Linux") */ char nodename[]; /* Name within "some implementation-defined network" */ - char release[]; /* Operating system release (e.g., "2.6.28") */ + char release[]; /* Operating system release + (e.g., "2.6.28") */ char version[]; /* Operating system version */ char machine[]; /* Hardware identifier */ #ifdef _GNU_SOURCE @@ -169,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unimplemented.2 b/man2/unimplemented.2 index 5183a413c..6963b17b9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unlink.2 b/man2/unlink.2 index 90ddcaa0f..d525815ce 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unshare.2 b/man2/unshare.2 index 436a87ace..3a0fc7c6b 100644 --- a/man2/unshare.2 +++ b/man2/unshare.2 @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uselib.2 b/man2/uselib.2 index 1da0a3b6a..5f2ecd24b 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -28,7 +28,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2005-01-09 by aeb .\" -.TH USELIB 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH USELIB 2 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME uselib \- load shared library .SH SYNOPSIS @@ -89,28 +89,28 @@ it was sufficient to manually declare the interface in your code; alternatively, you could invoke the system call using .BR syscall (2). .PP -In ancient libc versions, +In ancient libc versions (before glibc 2.0), .BR uselib () was used to load the shared libraries with names found in an array of names in the binary. -.PP -.\" libc 4.3.1f - changelog 1993-03-02 -Since libc 4.3.2, startup code tries to prefix these names -with "/usr/lib", "/lib" and "" before giving up. -.\" libc 4.3.4 - changelog 1993-04-21 -In libc 4.3.4 and later these names are looked for in the directories -found in -.BR LD_LIBRARY_PATH , -and if not found there, -prefixes "/usr/lib", "/lib" and "/" are tried. -.PP -From libc 4.4.4 on only the library "/lib/ld.so" is loaded, -so that this dynamic library can load the remaining libraries needed -(again using this call). -This is also the state of affairs in libc5. -.PP -glibc2 does not use this call. +.\" .PP +.\" .\" libc 4.3.1f - changelog 1993-03-02 +.\" Since libc 4.3.2, startup code tries to prefix these names +.\" with "/usr/lib", "/lib" and "" before giving up. +.\" .\" libc 4.3.4 - changelog 1993-04-21 +.\" In libc 4.3.4 and later these names are looked for in the directories +.\" found in +.\" .BR LD_LIBRARY_PATH , +.\" and if not found there, +.\" prefixes "/usr/lib", "/lib" and "/" are tried. +.\" .PP +.\" From libc 4.4.4 on only the library "/lib/ld.so" is loaded, +.\" so that this dynamic library can load the remaining libraries needed +.\" (again using this call). +.\" This is also the state of affairs in libc5. +.\" .PP +.\" glibc2 does not use this call. .PP Since Linux 3.15, .\" commit 69369a7003735d0d8ef22097e27a55a8bad9557a @@ -128,7 +128,7 @@ option. .BR capabilities (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 74bfa5042..123275172 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -768,7 +768,7 @@ main(int argc, char *argv[]) .IR Documentation/admin-guide/mm/userfaultfd.rst in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ustat.2 b/man2/ustat.2 index 5a5504afb..8b8d8cb8f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utime.2 b/man2/utime.2 index 55c40d92b..df39d2a54 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -110,9 +110,9 @@ struct timeval { .EE .in .PP -.IR times [0] +.I times[0] specifies the new access time, and -.IR times [1] +.I times[1] specifies the new modification time. If .I times @@ -191,7 +191,7 @@ on an append-only file. .BR futimes (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utimensat.2 b/man2/utimensat.2 index b9c92d84e..ebe0e65fe 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -89,9 +89,9 @@ an open file descriptor, .PP For both calls, the new file timestamps are specified in the array .IR times : -.IR times [0] +.I times[0] specifies the new "last access time" (\fIatime\fP); -.IR times [1] +.I times[1] specifies the new "last modification time" (\fImtime\fP). Each of the elements of .I times @@ -638,7 +638,7 @@ instead checks whether the .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vfork.2 b/man2/vfork.2 index 5215afa12..08683683c 100644 --- a/man2/vfork.2 +++ b/man2/vfork.2 @@ -334,7 +334,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vhangup.2 b/man2/vhangup.2 index 9d93e25ca..cbac75051 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vm86.2 b/man2/vm86.2 index 610ade72b..4165ac2cf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vmsplice.2 b/man2/vmsplice.2 index cb974326d..84b44e412 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait.2 b/man2/wait.2 index fbe97357f..5d002ad88 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -716,7 +716,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait4.2 b/man2/wait4.2 index d1d9ccdc7..4f8d54404 100644 --- a/man2/wait4.2 +++ b/man2/wait4.2 @@ -184,7 +184,7 @@ system call. .BR wait (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man2/write.2 b/man2/write.2 index 2ae1abb3f..7716ab5f8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/CIRCLEQ_EMPTY.3 b/man3/CIRCLEQ_EMPTY.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_EMPTY.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_FIRST.3 b/man3/CIRCLEQ_FIRST.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_FIRST.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_FOREACH.3 b/man3/CIRCLEQ_FOREACH.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_FOREACH.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_FOREACH_REVERSE.3 b/man3/CIRCLEQ_FOREACH_REVERSE.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_FOREACH_REVERSE.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_HEAD_INITIALIZER.3 b/man3/CIRCLEQ_HEAD_INITIALIZER.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_HEAD_INITIALIZER.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_LAST.3 b/man3/CIRCLEQ_LAST.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_LAST.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_LOOP_NEXT.3 b/man3/CIRCLEQ_LOOP_NEXT.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_LOOP_NEXT.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_LOOP_PREV.3 b/man3/CIRCLEQ_LOOP_PREV.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_LOOP_PREV.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_NEXT.3 b/man3/CIRCLEQ_NEXT.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_NEXT.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CIRCLEQ_PREV.3 b/man3/CIRCLEQ_PREV.3 new file mode 100644 index 000000000..ed0fc9a3b --- /dev/null +++ b/man3/CIRCLEQ_PREV.3 @@ -0,0 +1 @@ +.so man3/circleq.3 diff --git a/man3/CPU_SET.3 b/man3/CPU_SET.3 index 6d7c229f6..f9d547a10 100644 --- a/man3/CPU_SET.3 +++ b/man3/CPU_SET.3 @@ -362,7 +362,7 @@ main(int argc, char *argv[]) .BR pthread_setaffinity_np (3), .BR cpuset (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/INFINITY.3 b/man3/INFINITY.3 index d5b557c27..0f556ada6 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 2020-06-09 "" "Linux Programmer's Manual" +.TH INFINITY 3 2020-12-21 "" "Linux Programmer's Manual" .SH NAME INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL \- floating-point constants .SH SYNOPSIS @@ -66,7 +66,7 @@ The macros .B HUGE_VALL expand to constants of types .IR double , -.I float +.IR float , and .IR "long double" , respectively, @@ -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.09 of the Linux +This page is part of release 5.10 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 77935667e..8d3664557 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.09 of the Linux +This page is part of release 5.10 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 3bdf369b1..64daa4f47 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.09 of the Linux +This page is part of release 5.10 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 d72861d3b..2c38e8026 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -111,7 +111,7 @@ main(void) .BR time (2), .BR usleep (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d35dc11bc..4ef29c10c 100644 --- a/man3/__ppc_set_ppr_med.3 +++ b/man3/__ppc_set_ppr_med.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH __PPC_SET_PPR_MED 3 2017-09-15 "GNU C Library" "Linux\ +.TH __PPC_SET_PPR_MED 3 2020-12-21 "GNU C Library" "Linux\ Programmer's Manual" .SH NAME __ppc_set_ppr_med, __ppc_set_ppr_very_low, __ppc_set_ppr_low, __ppc_set_ppr_med_low, __ppc_set_ppr_med_high \- @@ -82,7 +82,7 @@ priority is set to medium. .SH VERSIONS The functions .BR __ppc_set_ppr_med (), -.BR __ppc_set_ppr_low () +.BR __ppc_set_ppr_low (), and .BR __ppc_set_ppr_med_low () are provided by glibc since version 2.18. @@ -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.09 of the Linux +This page is part of release 5.10 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 16df16c4a..866fe9696 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index df2486f8c..5be268557 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -60,7 +60,7 @@ Set FPU control word on the i386 architecture to .PP .I <fpu_control.h> .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/a64l.3 b/man3/a64l.3 index 3d9d9cff8..5007fbc3e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abort.3 b/man3/abort.3 index ba019fdce..a43841377 100644 --- a/man3/abort.3 +++ b/man3/abort.3 @@ -104,7 +104,7 @@ POSIX.1 permits either possible behavior, saying that .BR longjmp (3), .BR raise (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abs.3 b/man3/abs.3 index 9d3d3c1d9..5da1a055a 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -65,7 +65,7 @@ function computes the absolute value of the integer argument \fIj\fP. The .BR labs (), -.BR llabs () +.BR llabs (), and .BR imaxabs () functions compute the absolute value of the argument \fIj\fP of the @@ -139,7 +139,7 @@ as built-in functions. .BR floor (3), .BR rint (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acos.3 b/man3/acos.3 index 5277bc40d..7f3beaed9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acosh.3 b/man3/acosh.3 index 183479736..011526df3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/addseverity.3 b/man3/addseverity.3 index aa160211d..58c2d2f35 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/adjtime.3 b/man3/adjtime.3 index 2e7200b97..c6ec00fc7 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.09 of the Linux +This page is part of release 5.10 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 821697a02..743605346 100644 --- a/man3/aio_cancel.3 +++ b/man3/aio_cancel.3 @@ -138,7 +138,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 b4e5de318..0529de3f1 100644 --- a/man3/aio_error.3 +++ b/man3/aio_error.3 @@ -106,7 +106,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 b780e2e34..abf095709 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.09 of the Linux +This page is part of release 5.10 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 22012dfc6..db3f4f6d8 100644 --- a/man3/aio_init.3 +++ b/man3/aio_init.3 @@ -98,7 +98,7 @@ This function is a GNU extension. .SH SEE ALSO .BR aio (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 0d4eb186b..50cda2f50 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -168,7 +168,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 1f6f8b695..9bc9d410c 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -102,7 +102,7 @@ See .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 7830c0f32..941993da9 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.09 of the Linux +This page is part of release 5.10 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 7867f2133..1a4c4ea83 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/alloca.3 b/man3/alloca.3 index 9caf25cf1..f37d2b9d2 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.09 of the Linux +This page is part of release 5.10 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 d186cc000..8d91642dd 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asin.3 b/man3/asin.3 index 94dbf8865..cfd6da63b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asinh.3 b/man3/asinh.3 index fca8ad1df..06f57f8ba 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asprintf.3 b/man3/asprintf.3 index 097f7d86c..1c721588c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/assert.3 b/man3/assert.3 index 654e98aa8..5763dafad 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -107,7 +107,7 @@ is turned on. .BR assert_perror (3), .BR exit (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d54f9b260..a3412d75e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan.3 b/man3/atan.3 index 9685f10c2..ed161211a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan2.3 b/man3/atan2.3 index 493b7bb47..2b6767c0e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atanh.3 b/man3/atanh.3 index 7a15a3fda..7479b64a2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atexit.3 b/man3/atexit.3 index 3081e97eb..2144a573e 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -179,7 +179,7 @@ main(void) .BR exit (3), .BR on_exit (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atof.3 b/man3/atof.3 index 9d96ddbf2..ca176d558 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atoi.3 b/man3/atoi.3 index 0fb111b13..c4b265f02 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -137,7 +137,7 @@ family of functions in new programs. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 957fc9f00..98b98e99f 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -289,7 +289,7 @@ main(int argc, char *argv[]) .BR dlopen (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/basename.3 b/man3/basename.3 index 849b7c101..010436263 100644 --- a/man3/basename.3 +++ b/man3/basename.3 @@ -199,7 +199,7 @@ printf("dirname=%s, basename=%s\en", dname, bname); .BR basename (1), .BR dirname (1) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcmp.3 b/man3/bcmp.3 index 3bb1e3957..b11309942 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 7d9addaea..608970c02 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bindresvport.3 b/man3/bindresvport.3 index 2f7e72a2d..9d07bb069 100644 --- a/man3/bindresvport.3 +++ b/man3/bindresvport.3 @@ -127,7 +127,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.09 of the Linux +This page is part of release 5.10 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 eb41e26e8..51f4413bd 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bsearch.3 b/man3/bsearch.3 index 925391ce6..dd92ed2e2 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -145,7 +145,7 @@ main(int argc, char **argv) .BR qsort (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bstring.3 b/man3/bstring.3 index dedce33ff..cec24b9c3 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -29,7 +29,7 @@ .\" Modified 1993-04-12, David Metcalfe .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-01-20, Walter Harms -.TH BSTRING 3 2019-03-06 "" "Linux Programmer's Manual" +.TH BSTRING 3 2020-12-21 "" "Linux Programmer's Manual" .SH NAME bcmp, bcopy, bzero, memccpy, memchr, memcmp, memcpy, memfrob, memmem, memmove, memset \- byte string operations @@ -68,13 +68,13 @@ for descriptions of each function. .SH NOTES The functions .BR bcmp (), -.BR bcopy () +.BR bcopy (), and .BR bzero () are obsolete. Use .BR memcmp (), -.BR memcpy () +.BR memcpy (), and .BR memset () instead. @@ -92,7 +92,7 @@ instead. .BR memmove (3), .BR memset (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bswap.3 b/man3/bswap.3 index ea5e029ea..1f34f6dce 100644 --- a/man3/bswap.3 +++ b/man3/bswap.3 @@ -82,7 +82,7 @@ main(int argc, char *argv[]) .BR byteorder (3), .BR endian (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btowc.3 b/man3/btowc.3 index e20b65832..3b4dfbb0d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btree.3 b/man3/btree.3 index c6e88f855..587074d4f 100644 --- a/man3/btree.3 +++ b/man3/btree.3 @@ -33,7 +33,7 @@ .\" .\" @(#)btree.3 8.4 (Berkeley) 8/18/94 .\" -.TH BTREE 3 2017-09-15 "" "Linux Programmer's Manual" +.TH BTREE 3 2020-12-21 "" "Linux Programmer's Manual" .\".UC 7 .SH NAME btree \- btree database access method @@ -209,7 +209,7 @@ If the file already exists (and the flag is not specified), the values specified for the arguments .IR flags , -.I lorder +.IR lorder , and .I psize are ignored @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/byteorder.3 b/man3/byteorder.3 index 5cd08e2ad..a45b9ba71 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bzero.3 b/man3/bzero.3 index fcfea078e..8a52cbb24 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cabs.3 b/man3/cabs.3 index 38e13e21d..e58c8d60d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacos.3 b/man3/cacos.3 index dd85f440f..7ed59bc0c 100644 --- a/man3/cacos.3 +++ b/man3/cacos.3 @@ -87,7 +87,7 @@ main(int argc, char *argv[]) .BR clog (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacosh.3 b/man3/cacosh.3 index 7d80f6729..7ef116817 100644 --- a/man3/cacosh.3 +++ b/man3/cacosh.3 @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 106b500af..2f20c6b40 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/carg.3 b/man3/carg.3 index 8dcb39d43..a170565e0 100644 --- a/man3/carg.3 +++ b/man3/carg.3 @@ -78,7 +78,7 @@ C99, POSIX.1-2001, POSIX.1-2008. .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casin.3 b/man3/casin.3 index d157d155b..e3b62c53b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casinh.3 b/man3/casinh.3 index fcb18d5a7..149a5de76 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catan.3 b/man3/catan.3 index 68dc90dd6..c909fd34d 100644 --- a/man3/catan.3 +++ b/man3/catan.3 @@ -84,7 +84,7 @@ main(int argc, char *argv[]) .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catanh.3 b/man3/catanh.3 index cb5467edd..0b228b8e5 100644 --- a/man3/catanh.3 +++ b/man3/catanh.3 @@ -86,7 +86,7 @@ main(int argc, char *argv[]) .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catgets.3 b/man3/catgets.3 index c9a4b138d..277475836 100644 --- a/man3/catgets.3 +++ b/man3/catgets.3 @@ -98,7 +98,7 @@ in favor of always returning .BR catopen (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catopen.3 b/man3/catopen.3 index 96cc7ab41..1bdca12a9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cbrt.3 b/man3/cbrt.3 index 46719158f..bf3db4c87 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccos.3 b/man3/ccos.3 index a6c078fa9..3a030c1fe 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccosh.3 b/man3/ccosh.3 index 55df65290..152ee6324 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ceil.3 b/man3/ceil.3 index 252bf2e3c..253b43b94 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp.3 b/man3/cexp.3 index 2c017dada..8a4db263e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp2.3 b/man3/cexp2.3 index 93e3ea671..6209b5808 100644 --- a/man3/cexp2.3 +++ b/man3/cexp2.3 @@ -31,7 +31,7 @@ As at version 2.31, these functions are not provided in glibc. .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cfree.3 b/man3/cfree.3 index 42773c3c0..d5e9b327b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cimag.3 b/man3/cimag.3 index b90298136..17bc5f388 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/circleq.3 b/man3/circleq.3 index 626809c23..f2f7a7bbc 100644 --- a/man3/circleq.3 +++ b/man3/circleq.3 @@ -356,7 +356,7 @@ main(void) .BR insque (3), .BR queue (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clearenv.3 b/man3/clearenv.3 index baad89c34..7e52b481d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clock.3 b/man3/clock.3 index bd34e2910..28a593d39 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.09 of the Linux +This page is part of release 5.10 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 a585faa74..386c7eecc 100644 --- a/man3/clock_getcpuclockid.3 +++ b/man3/clock_getcpuclockid.3 @@ -165,7 +165,7 @@ main(int argc, char *argv[]) .BR pthread_getcpuclockid (3), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog.3 b/man3/clog.3 index b479a5ba8..c3c7e357f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog10.3 b/man3/clog10.3 index e1592f9f6..8f4645223 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog2.3 b/man3/clog2.3 index 3b9a6b856..69b30fbe2 100644 --- a/man3/clog2.3 +++ b/man3/clog2.3 @@ -43,7 +43,7 @@ Not yet in glibc, as at version 2.19. .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/closedir.3 b/man3/closedir.3 index 4a15c8741..95996841c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cmsg.3 b/man3/cmsg.3 index d4995c129..793c1a669 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -251,7 +251,7 @@ memcpy(CMSG_DATA(cmsg), myfds, sizeof(myfds)); .PP RFC\ 2292 .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/confstr.3 b/man3/confstr.3 index 779fe32da..7b56d23d4 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -165,7 +165,7 @@ confstr(_CS_PATH, pathbuf, n); .BR sysconf (3), .BR system (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/conj.3 b/man3/conj.3 index bf693666d..bafed6b37 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/copysign.3 b/man3/copysign.3 index f9aa9a8a0..2fb0b826c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cos.3 b/man3/cos.3 index 6dcc1f0d2..95046d52d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cosh.3 b/man3/cosh.3 index 9d731c6d2..ceb764634 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cpow.3 b/man3/cpow.3 index b13ba97b2..08dbd6071 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cproj.3 b/man3/cproj.3 index 9ece52dbb..21ed32cd0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/creal.3 b/man3/creal.3 index 87787f49a..0d4b8b323 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/crypt.3 b/man3/crypt.3 index 40ee05d98..cf648f075 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csin.3 b/man3/csin.3 index be1cc69fb..7dc56ffd0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csinh.3 b/man3/csinh.3 index 2ed2104b7..f61b56be6 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csqrt.3 b/man3/csqrt.3 index a8f050636..fa58f2bf7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctan.3 b/man3/ctan.3 index d8495548f..ef56836fe 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctanh.3 b/man3/ctanh.3 index ce3ae341a..6011f8764 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctermid.3 b/man3/ctermid.3 index 480240359..61493bdbe 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctime.3 b/man3/ctime.3 index 3c6b115dc..f6bed41cc 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -32,7 +32,7 @@ .\" Modified 2001-12-13, joey, aeb .\" Modified 2004-11-16, mtk .\" -.TH CTIME 3 2019-03-06 "" "Linux Programmer's Manual" +.TH CTIME 3 2020-12-21 "" "Linux Programmer's Manual" .SH NAME asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r, localtime_r \- transform date and time to broken-down time or ASCII @@ -73,7 +73,7 @@ _POSIX_C_SOURCE .SH DESCRIPTION The .BR ctime (), -.BR gmtime () +.BR gmtime (), and .BR localtime () functions all take @@ -375,14 +375,14 @@ instead. The four functions .BR asctime (), .BR ctime (), -.BR gmtime () +.BR gmtime (), and .BR localtime () return a pointer to static data and hence are not thread-safe. The thread-safe versions, .BR asctime_r (), .BR ctime_r (), -.BR gmtime_r () +.BR gmtime_r (), and .BR localtime_r (), are specified by SUSv2. @@ -444,7 +444,7 @@ should be called before .BR tzset (3), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/daemon.3 b/man3/daemon.3 index d1b6bd773..93f0eee0f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dbopen.3 b/man3/dbopen.3 index 5523fb23c..c9cd7471a 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.09 of the Linux +This page is part of release 5.10 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 7f6ebd300..e49b30e56 100644 --- a/man3/des_crypt.3 +++ b/man3/des_crypt.3 @@ -161,7 +161,7 @@ Not in POSIX.1. .BR crypt (3), .BR xcrypt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/difftime.3 b/man3/difftime.3 index 42d0a9653..9b69e15e8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dirfd.3 b/man3/dirfd.3 index fcb702c58..19c83ec1d 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -109,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/div.3 b/man3/div.3 index b260118d3..d97ef6456 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -118,7 +118,7 @@ the values \fIq.quot\fP and \fIq.rem\fP are \-1 and \-2, respectively. .BR abs (3), .BR remainder (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 da1c1d9b3..4d8103da3 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -359,7 +359,7 @@ main(int argc, char *argv[]) .IR "Executable and Linking Format Specification" , available at various locations online. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dladdr.3 b/man3/dladdr.3 index 6debdba3c..519c32a97 100644 --- a/man3/dladdr.3 +++ b/man3/dladdr.3 @@ -288,7 +288,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlerror.3 b/man3/dlerror.3 index 70cce3cc3..71b0c0c4c 100644 --- a/man3/dlerror.3 +++ b/man3/dlerror.3 @@ -90,7 +90,7 @@ See .BR dlopen (3), .BR dlsym (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index b54a23211..f4f1edcc2 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -331,7 +331,7 @@ main(int argc, char *argv[]) .BR dlsym (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlopen.3 b/man3/dlopen.3 index c47038ced..9dca1a900 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -631,7 +631,7 @@ main(void) .PP gcc info pages, ld info pages .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlsym.3 b/man3/dlsym.3 index 411b0734b..9a24773a7 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -176,7 +176,7 @@ See .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/drand48.3 b/man3/drand48.3 index 48b82da2e..08249d174 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -102,7 +102,7 @@ integers uniformly distributed over the interval [\-2^31,\ 2^31). .PP The .BR srand48 (), -.BR seed48 () +.BR seed48 (), and .BR lcong48 () functions are @@ -113,7 +113,7 @@ or .BR mrand48 (). The functions .BR erand48 (), -.BR nrand48 () +.BR nrand48 (), and .BR jrand48 () do not require @@ -167,7 +167,7 @@ into the returned value. .PP The functions .BR drand48 (), -.BR lrand48 () +.BR lrand48 (), and .BR mrand48 () store @@ -176,7 +176,7 @@ the last 48-bit generated in an internal buffer. The functions .BR erand48 (), -.BR nrand48 () +.BR nrand48 (), and .BR jrand48 () require the calling @@ -219,7 +219,7 @@ The initialization function allows the user to specify initial values for .IR Xi , -.I a +.IR a , and .IR c . Array argument @@ -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.09 of the Linux +This page is part of release 5.10 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 936ffdbeb..069c7b416 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 65292285f..e8f6354e9 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -184,7 +184,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dysize.3 b/man3/dysize.3 index b3ece4f4a..582a9f09c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ecvt.3 b/man3/ecvt.3 index a0aaeca56..888013d0c 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.09 of the Linux +This page is part of release 5.10 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 22e33e379..741ee8d37 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/encrypt.3 b/man3/encrypt.3 index cd9a2c9d6..01b4199a2 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -217,7 +217,7 @@ main(void) .BR ecb_crypt (3), .\" .BR fcrypt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/end.3 b/man3/end.3 index 1e8db25e2..1f4edc9bc 100644 --- a/man3/end.3 +++ b/man3/end.3 @@ -111,7 +111,7 @@ main(int argc, char *argv[]) .BR sbrk (2), .BR elf (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/endian.3 b/man3/endian.3 index 7fb9f4e8f..249164129 100644 --- a/man3/endian.3 +++ b/man3/endian.3 @@ -175,7 +175,7 @@ main(int argc, char *argv[]) .BR bswap (3), .BR byteorder (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 058e29a98..230098cbd 100644 --- a/man3/envz_add.3 +++ b/man3/envz_add.3 @@ -163,7 +163,7 @@ main(int argc, char *argv[], char *envp[]) .SH SEE ALSO .BR argz_add (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erf.3 b/man3/erf.3 index a5a61952e..2e9cf7322 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -142,7 +142,7 @@ SVr4, 4.3BSD. .BR erfc (3), .BR exp (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erfc.3 b/man3/erfc.3 index f58cd5044..14395ae2c 100644 --- a/man3/erfc.3 +++ b/man3/erfc.3 @@ -149,7 +149,7 @@ would occur for the calculation 1-erf(x) for large values of .BR erf (3), .BR exp (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/err.3 b/man3/err.3 index 9de1cdc77..507b9f4f0 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -184,7 +184,7 @@ if (fd == \-1) .BR printf (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/errno.3 b/man3/errno.3 index 524c839dd..c91f7b803 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -359,6 +359,8 @@ Commonly caused by exceeding the .BR RLIMIT_NOFILE resource limit described in .BR getrlimit (2). +Can also be caused by exceeding the limit specified in +.IR /proc/sys/fs/nr_open . .TP .B EMLINK Too many links (POSIX.1-2001). @@ -660,7 +662,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/error.3 b/man3/error.3 index 83efc5261..1419143ef 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.09 of the Linux +This page is part of release 5.10 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 2a93d5366..f3d2efa81 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index 097bd4be5..d5db9a23d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exec.3 b/man3/exec.3 index 14a7e2921..d6f3c7c75 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -297,7 +297,7 @@ wrapper function on those architectures. .BR system (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exit.3 b/man3/exit.3 index 47c748d1c..e30b6cbd5 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -213,7 +213,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp.3 b/man3/exp.3 index 7e1394597..871ae3fc1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp10.3 b/man3/exp10.3 index 22451560a..93085ccc3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp2.3 b/man3/exp2.3 index fd59158ba..dbdcbf1ae 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/expm1.3 b/man3/expm1.3 index 08718bbcd..8dea57264 100644 --- a/man3/expm1.3 +++ b/man3/expm1.3 @@ -180,7 +180,7 @@ when a range error occurred. .BR log (3), .BR log1p (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fabs.3 b/man3/fabs.3 index dbca3be3c..12406e9ae 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fclose.3 b/man3/fclose.3 index 37c118d8e..970771f53 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fcloseall.3 b/man3/fcloseall.3 index 98d230ab5..4c91a00bc 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fdim.3 b/man3/fdim.3 index a654eed25..e8dd593fd 100644 --- a/man3/fdim.3 +++ b/man3/fdim.3 @@ -94,7 +94,7 @@ these functions did not set .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fenv.3 b/man3/fenv.3 index 03c49e366..60572798e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ferror.3 b/man3/ferror.3 index 363013923..32b028be1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 2e98bf623..889e5614f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fflush.3 b/man3/fflush.3 index ff6b2b150..db34aa8da 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ffs.3 b/man3/ffs.3 index 2bb6fc698..e51ea8a83 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetc.3 b/man3/fgetc.3 index 0d76f0ef7..7fbe41dff 100644 --- a/man3/fgetc.3 +++ b/man3/fgetc.3 @@ -24,7 +24,7 @@ .\" .\" Modified Wed Jul 28 11:12:07 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Sep 8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl) -.TH FGETC 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH FGETC 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME fgetc, fgets, getc, getchar, ungetc \- input of characters and strings .SH SYNOPSIS @@ -98,7 +98,7 @@ For nonlocking counterparts, see .BR unlocked_stdio (3). .SH RETURN VALUE .BR fgetc (), -.BR getc () +.BR getc (), and .BR getchar () return the character read as an @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 0d216256c..372df1ec5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index 893652341..41e97bccf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetwc.3 b/man3/fgetwc.3 index 67b105671..906d0f4b7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetws.3 b/man3/fgetws.3 index cfeffecb1..eec4cc990 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/finite.3 b/man3/finite.3 index 01f7191fb..878f99022 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/flockfile.3 b/man3/flockfile.3 index d72fd96e4..36354164f 100644 --- a/man3/flockfile.3 +++ b/man3/flockfile.3 @@ -146,7 +146,7 @@ is defined. .SH SEE ALSO .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/floor.3 b/man3/floor.3 index d5e6c9533..b04601535 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fma.3 b/man3/fma.3 index 5cae401de..29f7d8a71 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmax.3 b/man3/fmax.3 index 1b147f357..0b46845a2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index 71f3f4c8e..12e6cfeba 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -351,7 +351,7 @@ main(int argc, char *argv[]) .BR fopencookie (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmin.3 b/man3/fmin.3 index 3c2cd2ace..720c5302f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmod.3 b/man3/fmod.3 index a23365958..9a522c83b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index 068995a66..99e641c2b 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -329,7 +329,7 @@ TO FIX: See mount(8). .BR addseverity (3), .BR perror (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 97b0d2ca4..3833e196f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopen.3 b/man3/fopen.3 index a21524e9a..d21c19868 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -41,7 +41,7 @@ .\" Modified, aeb, 960421, 970806 .\" Modified, joey, aeb, 2002-01-03 .\" -.TH FOPEN 3 2019-05-09 "GNU" "Linux Programmer's Manual" +.TH FOPEN 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME fopen, fdopen, freopen \- stream open functions .SH SYNOPSIS @@ -236,7 +236,7 @@ function is to change the file associated with a standard text stream .SH RETURN VALUE Upon successful completion .BR fopen (), -.BR fdopen () +.BR fdopen (), and .BR freopen () return a @@ -259,7 +259,7 @@ was invalid. .PP The .BR fopen (), -.BR fdopen () +.BR fdopen (), and .BR freopen () functions may also fail and set @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 76878e80a..7f7bdd89f 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -450,7 +450,7 @@ main(int argc, char *argv[]) .BR fopen (3), .BR fseek (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index 93f7a0520..4d044b113 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpclassify.3 b/man3/fpclassify.3 index a3e357f43..211258074 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpurge.3 b/man3/fpurge.3 index a3cca1efe..c6806d7ce 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputwc.3 b/man3/fputwc.3 index bc7c0abee..1a3320b43 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputws.3 b/man3/fputws.3 index 301356baa..4ac6c757f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fread.3 b/man3/fread.3 index 90e446f1c..56b72edc0 100644 --- a/man3/fread.3 +++ b/man3/fread.3 @@ -178,7 +178,7 @@ main(void) .BR ferror (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/frexp.3 b/man3/frexp.3 index 8a304e94c..19ff82a3a 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -155,7 +155,7 @@ main(int argc, char *argv[]) .BR ldexp (3), .BR modf (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseek.3 b/man3/fseek.3 index 8f984f1e7..2ae6b23ae 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseeko.3 b/man3/fseeko.3 index c7a66e129..4c1b3fab6 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftime.3 b/man3/ftime.3 index 3de8d9582..b458f9b2f 100644 --- a/man3/ftime.3 +++ b/man3/ftime.3 @@ -114,7 +114,7 @@ glibc 2.1.1 is correct again. .BR gettimeofday (2), .BR time (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftok.3 b/man3/ftok.3 index 0baa573ea..af469b5d0 100644 --- a/man3/ftok.3 +++ b/man3/ftok.3 @@ -122,7 +122,7 @@ See .BR stat (2), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fts.3 b/man3/fts.3 index bb7b4c3be..f0b36a50a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftw.3 b/man3/ftw.3 index e914d84a7..dcc056141 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -509,7 +509,7 @@ main(int argc, char *argv[]) .BR fts (3), .BR readdir (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/futimes.3 b/man3/futimes.3 index fddddd137..0d4435e4d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fwide.3 b/man3/fwide.3 index c2f80ffcd..cd2cbaae7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gamma.3 b/man3/gamma.3 index 68d8c6f9b..484ad1b20 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gcvt.3 b/man3/gcvt.3 index add07f16d..979180ecd 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -100,7 +100,7 @@ may be preferable). .BR fcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 97c06880e..25539fae3 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -105,7 +105,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR nproc (1) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 b99bd9645..970c58a7d 100644 --- a/man3/get_phys_pages.3 +++ b/man3/get_phys_pages.3 @@ -100,7 +100,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR sysconf (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 7c2037161..8634900bc 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -852,7 +852,7 @@ main(int argc, char *argv[]) .BR hostname (7), .BR ip (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c04143c66..daef4fd72 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -622,7 +622,7 @@ main(int argc, char *argv[]) .BR ip (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getauxval.3 b/man3/getauxval.3 index 0cb67d8be..88c66bcf3 100644 --- a/man3/getauxval.3 +++ b/man3/getauxval.3 @@ -286,7 +286,7 @@ was zero. .BR vdso (7), .BR ld\-linux.so (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcontext.3 b/man3/getcontext.3 index 754f425ec..217f34ed1 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH GETCONTEXT 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH GETCONTEXT 3 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME getcontext, setcontext \- get or set the user context .SH SYNOPSIS @@ -95,22 +95,25 @@ that includes the calling thread's machine registers. The function .BR getcontext () initializes the structure -pointed at by +pointed to by .I ucp to the currently active context. .PP The function .BR setcontext () restores the user context -pointed at by +pointed to by .IR ucp . A successful call does not return. The context should have been obtained by a call of .BR getcontext (), or .BR makecontext (3), -or passed as third argument to a signal -handler. +or received as the third argument to a signal +handler (see the discussion of the +.BR SA_SIGINFO +flag in +.BR sigaction (2)). .PP If the context was obtained by a call of .BR getcontext (), @@ -203,9 +206,10 @@ instead. .BR sigprocmask (2), .BR longjmp (3), .BR makecontext (3), -.BR sigsetjmp (3) +.BR sigsetjmp (3), +.BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcwd.3 b/man3/getcwd.3 index 67ce2a781..b926c5c58 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdate.3 b/man3/getdate.3 index a1c5e09c3..81effdde4 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -322,7 +322,7 @@ main(int argc, char *argv[]) .BR strftime (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index cc4243bd1..14315f723 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdtablesize.3 b/man3/getdtablesize.3 index d2d7e7e03..9e1ee5e96 100644 --- a/man3/getdtablesize.3 +++ b/man3/getdtablesize.3 @@ -106,7 +106,7 @@ when that fails. .BR getrlimit (2), .BR open (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getentropy.3 b/man3/getentropy.3 index c1d1937be..3ccbe88ba 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getenv.3 b/man3/getenv.3 index 0327b89dd..249c9bb23 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getfsent.3 b/man3/getfsent.3 index fb452ad7f..a8b101734 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 88d03c20a..0a466a2ed 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.09 of the Linux +This page is part of release 5.10 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 94e7b2dae..5b4636338 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -220,7 +220,7 @@ main(void) .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index e29c47647..309f5bb48 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index 6f5cf6874..0f4acc5ab 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -207,7 +207,7 @@ main(int argc, char *argv[]) .BR group (5), .BR passwd (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 685d283b8..9d01024d3 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 2020-06-09 "" "Linux Programmer's Manual" +.TH GETHOSTBYNAME 3 2020-12-21 "" "Linux Programmer's Manual" .SH NAME gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, @@ -498,7 +498,7 @@ but permits to specify the address family to which the address must belong. Glibc2 also has reentrant versions .BR gethostent_r (), .BR gethostbyaddr_r (), -.BR gethostbyname_r () +.BR gethostbyname_r (), and .BR gethostbyname2_r (). The caller supplies a @@ -548,7 +548,7 @@ that are expressed in hexadecimal. .BR named (8) .\" .BR resolv+ (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostid.3 b/man3/gethostid.3 index 2dc92ab8e..d5bd286d6 100644 --- a/man3/gethostid.3 +++ b/man3/gethostid.3 @@ -147,7 +147,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 197c005f0..68407d816 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -328,7 +328,7 @@ int main(int argc, char *argv[]) .BR packet (7), .BR ifconfig (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index e4b92eae4..9c8ba666e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getline.3 b/man3/getline.3 index f4c50b89b..bc19941bb 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -200,7 +200,7 @@ main(int argc, char *argv[]) .BR fread (3), .BR scanf (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getloadavg.3 b/man3/getloadavg.3 index 89f18d797..1e3afe4d1 100644 --- a/man3/getloadavg.3 +++ b/man3/getloadavg.3 @@ -61,7 +61,7 @@ averaged over various periods of time. Up to .I nelem samples are retrieved and assigned to successive elements of -.IR loadavg []. +.IR loadavg[] . The system imposes a maximum of 3 samples, representing averages over the last 1, 5, and 15 minutes, respectively. .SH RETURN VALUE @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getlogin.3 b/man3/getlogin.3 index e111082b5..73f860059 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 455f1646a..b9658d294 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -259,7 +259,7 @@ a wrapper around the system call .BR fstab (5), .BR mount (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index 8328a9218..abf7f4a53 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -27,7 +27,7 @@ Feature Test Macro Requirements for glibc (see .RE .PP .BR getnameinfo (): - Since glibc 2.22: _POSIX_C_SOURCE >= 201112L + Since glibc 2.22: _POSIX_C_SOURCE >= 200112L Glibc 2.21 and earlier: _POSIX_C_SOURCE .ad b .SH DESCRIPTION @@ -330,7 +330,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnetent.3 b/man3/getnetent.3 index bf556a54b..2efb7b424 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 21:48:06 1993 by Rik Faith (faith@cs.unc.edu) -.TH GETNETENT 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH GETNETENT 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- get network entry @@ -130,7 +130,7 @@ The network number in host byte order. .SH RETURN VALUE The .BR getnetent (), -.BR getnetbyname () +.BR getnetbyname (), and .BR getnetbyaddr () functions return a pointer to a @@ -210,7 +210,7 @@ was of type .br RFC\ 1101 .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 92041fd9c..723e4d4c9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getopt.3 b/man3/getopt.3 index a14854e21..24277442c 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -538,7 +538,7 @@ main(int argc, char **argv) .BR getopt (1), .BR getsubopt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpass.3 b/man3/getpass.3 index 3df7d9d2b..71beae528 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index 97286d443..15ba5951e 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:26:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH GETPROTOENT 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH GETPROTOENT 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent \- get protocol entry @@ -123,7 +123,7 @@ The protocol number. .SH RETURN VALUE The .BR getprotoent (), -.BR getprotobyname () +.BR getprotobyname (), and .BR getprotobynumber () functions return a pointer to a @@ -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.09 of the Linux +This page is part of release 5.10 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 975d53afd..0115126a6 100644 --- a/man3/getprotoent_r.3 +++ b/man3/getprotoent_r.3 @@ -255,7 +255,7 @@ main(int argc, char *argv[]) .BR getprotoent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpt.3 b/man3/getpt.3 index 03e8897c1..33e3f6006 100644 --- a/man3/getpt.3 +++ b/man3/getpt.3 @@ -68,7 +68,7 @@ instead. .BR ptmx (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpw.3 b/man3/getpw.3 index 401f6c50c..ba35247d1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwent.3 b/man3/getpwent.3 index 68b21a4da..0e3ff6362 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.09 of the Linux +This page is part of release 5.10 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 c959a4b1b..416e6eba8 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -220,7 +220,7 @@ main(void) .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 119576c6e..4212e66fa 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -340,7 +340,7 @@ main(int argc, char *argv[]) .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index 8c3fbbea6..b9beb217e 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -130,7 +130,7 @@ to be saved. .BR rpcinfo (8), .BR ypserv (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 32ef1e138..6542bdc00 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcport.3 b/man3/getrpcport.3 index a53f65732..bf5480619 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gets.3 b/man3/gets.3 index 5169d3d4c..d8cda1cc6 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getservent.3 b/man3/getservent.3 index e2ffe5de7..c8203f16a 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -31,7 +31,7 @@ .\" Modified Mon Apr 22 01:50:54 1996 by Martin Schulze <joey@infodrom.north.de> .\" 2001-07-25 added a clause about NULL proto (Martin Michlmayr or David N. Welton) .\" -.TH GETSERVENT 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH GETSERVENT 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME getservent, getservbyname, getservbyport, setservent, endservent \- get service entry @@ -142,7 +142,7 @@ The name of the protocol to use with this service. .SH RETURN VALUE The .BR getservent (), -.BR getservbyname () +.BR getservbyname (), and .BR getservbyport () functions return a pointer to a @@ -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.09 of the Linux +This page is part of release 5.10 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 eaaaf1d3d..e9e41e0f7 100644 --- a/man3/getservent_r.3 +++ b/man3/getservent_r.3 @@ -258,7 +258,7 @@ main(int argc, char *argv[]) .BR getservent (3), .BR services (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 3d01eee27..3c18b0f37 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getsubopt.3 b/man3/getsubopt.3 index c101e65ab..69bf4376f 100644 --- a/man3/getsubopt.3 +++ b/man3/getsubopt.3 @@ -239,7 +239,7 @@ main(int argc, char **argv) .SH SEE ALSO .BR getopt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getttyent.3 b/man3/getttyent.3 index dc34a298e..9fdad7627 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getumask.3 b/man3/getumask.3 index 2c672b8d7..5520f5661 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getusershell.3 b/man3/getusershell.3 index be26195ab..f44ef398c 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -114,7 +114,7 @@ T} Thread safety MT-Unsafe .SH SEE ALSO .BR shells (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutent.3 b/man3/getutent.3 index fb62994c4..fe046282d 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -279,7 +279,6 @@ Glibc adds reentrant versions .BI " struct utmp *" ubuf ", struct utmp **" ubufp ); .BI "int getutline_r(struct utmp *" ut , .BI " struct utmp *" ubuf ", struct utmp **" ubufp ); -.EE .fi .PP Feature Test Macro Requirements for glibc (see @@ -359,7 +358,7 @@ main(int argc, char *argv[]) .BR getutmp (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutmp.3 b/man3/getutmp.3 index a249d07eb..02576f1ca 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getw.3 b/man3/getw.3 index c90f753d0..472a8553a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getwchar.3 b/man3/getwchar.3 index b5e40d886..d5543077d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/glob.3 b/man3/glob.3 index 375d2b5c2..f73cd1b5d 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -360,7 +360,7 @@ execvp("ls", &globbuf.gl_pathv[0]); .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2af90c001..73db6513c 100644 --- a/man3/gnu_get_libc_version.3 +++ b/man3/gnu_get_libc_version.3 @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR confstr (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/grantpt.3 b/man3/grantpt.3 index 952148d79..47be4bf01 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.09 of the Linux +This page is part of release 5.10 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 bf2878755..e97b50757 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gsignal.3 b/man3/gsignal.3 index 298153362..71b928078 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hash.3 b/man3/hash.3 index bc0deab4c..f09fa6f7a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hsearch.3 b/man3/hsearch.3 index 7bb52f41b..9a4df5b49 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -351,7 +351,7 @@ main(void) .BR malloc (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hypot.3 b/man3/hypot.3 index dde84b1ec..2b6575698 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -171,7 +171,7 @@ SVr4, 4.3BSD. .BR cabs (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iconv.3 b/man3/iconv.3 index 7dcab4eed..3f57c54fe 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.09 of the Linux +This page is part of release 5.10 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 3b827beeb..e73cef529 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.09 of the Linux +This page is part of release 5.10 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 23d584e4f..e673d6f1c 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.09 of the Linux +This page is part of release 5.10 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 6071ef663..e76ab37bd 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -167,7 +167,7 @@ main(int argc, char *argv[]) .BR if_nametoindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 89ee0865b..57dd502f8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ilogb.3 b/man3/ilogb.3 index ee0cff18c..0ba098bae 100644 --- a/man3/ilogb.3 +++ b/man3/ilogb.3 @@ -165,7 +165,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/index.3 b/man3/index.3 index 37b95ed4f..42a8075a4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet.3 b/man3/inet.3 index c6b47858d..288387e66 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 2020-06-09 "GNU" "Linux Programmer's Manual" +.TH INET 3 2020-12-21 "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 @@ -204,7 +204,7 @@ host byte order. The structure \fIin_addr\fP as used in .BR inet_ntoa (), .BR inet_makeaddr (), -.BR inet_lnaof () +.BR inet_lnaof (), and .BR inet_netof () is defined in @@ -340,7 +340,7 @@ main(int argc, char *argv[]) .BR hosts (5), .BR networks (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 14f094ef6..a630370cb 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -390,7 +390,7 @@ main(int argc, char *argv[]) .BR inet (3), .BR networks (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 14ec53c50..b97f71f9a 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -133,7 +133,7 @@ See .BR inet (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 4955c2cc1..3b747d957 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -231,7 +231,7 @@ main(int argc, char *argv[]) .BR inet (3), .BR inet_ntop (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/initgroups.3 b/man3/initgroups.3 index 9fd238532..435676ab8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/insque.3 b/man3/insque.3 index 435be8c9c..da522d4e8 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -259,7 +259,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR queue (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/intro.3 b/man3/intro.3 index 1f39d9a40..477092fe7 100644 --- a/man3/intro.3 +++ b/man3/intro.3 @@ -109,7 +109,7 @@ Note that these can be different from page to page! .BR standards (7), .BR system_data_types (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isalpha.3 b/man3/isalpha.3 index 1feb39235..932fb38c4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isatty.3 b/man3/isatty.3 index 2f468653a..c2b76b7d2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isfdtype.3 b/man3/isfdtype.3 index 1ef93b49f..82364b906 100644 --- a/man3/isfdtype.3 +++ b/man3/isfdtype.3 @@ -101,7 +101,7 @@ instead. .SH SEE ALSO .BR fstat (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isgreater.3 b/man3/isgreater.3 index 5d95c97c1..35a490996 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalnum.3 b/man3/iswalnum.3 index d4ec99ae0..6c4a157a7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalpha.3 b/man3/iswalpha.3 index ff9903b91..5ec7c4440 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswblank.3 b/man3/iswblank.3 index 463da2249..a4a990ccf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswcntrl.3 b/man3/iswcntrl.3 index d8d6b4869..46c7d8705 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswctype.3 b/man3/iswctype.3 index 9b8faf45a..bdd3178ee 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswdigit.3 b/man3/iswdigit.3 index ef89f350f..c701735b9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswgraph.3 b/man3/iswgraph.3 index 5c84b957c..32d31e540 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswlower.3 b/man3/iswlower.3 index 20fb3d60f..3607f9689 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswprint.3 b/man3/iswprint.3 index 0ee6453b7..44a7c7c80 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswpunct.3 b/man3/iswpunct.3 index d2cbf4022..d5d913b9c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswspace.3 b/man3/iswspace.3 index be5b18e71..b57672f34 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswupper.3 b/man3/iswupper.3 index 5684a6d93..3f99e53fa 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswxdigit.3 b/man3/iswxdigit.3 index 7e09d67fe..55c10aa92 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.09 of the Linux +This page is part of release 5.10 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, moved yxx() material into separate y0.3 page .\" -.TH J0 3 2017-09-15 "" "Linux Programmer's Manual" +.TH J0 3 2020-12-21 "" "Linux Programmer's Manual" .SH NAME j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl \- Bessel functions of the first kind @@ -182,7 +182,7 @@ The others are nonstandard functions that also exist on the BSDs. .SH BUGS There are errors of up to 2e\-16 in the values returned by .BR j0 (), -.BR j1 () +.BR j1 (), and .BR jn () for values of @@ -191,7 +191,7 @@ between \-8 and 8. .SH SEE ALSO .BR y0 (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 441a6ebc8..9746f112e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/killpg.3 b/man3/killpg.3 index 725eff497..b52d531bb 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -134,7 +134,7 @@ is implemented as a library function that makes the call .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ldexp.3 b/man3/ldexp.3 index 88fdc541e..c1d56375a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lgamma.3 b/man3/lgamma.3 index ea4b24cab..9d2369a49 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.09 of the Linux +This page is part of release 5.10 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 51343d01f..70c51a13d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/list.3 b/man3/list.3 index 42ce76916..c2f1d8668 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -29,7 +29,7 @@ .\" %%%LICENSE_END .\" .\" -.TH LIST 3 2020-10-19 "GNU" "Linux Programmer's Manual" +.TH LIST 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME LIST_EMPTY, LIST_ENTRY, @@ -45,7 +45,7 @@ LIST_INSERT_AFTER, LIST_INSERT_BEFORE, LIST_INSERT_HEAD, LIST_NEXT, -LIST_PREV, +.\"LIST_PREV, LIST_REMOVE .\"LIST_SWAP \- implementation of a doubly linked list @@ -348,7 +348,7 @@ main(void) .BR insque (3), .BR queue (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/localeconv.3 b/man3/localeconv.3 index a94cda7a1..76d32e9e4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lockf.3 b/man3/lockf.3 index 5b4bbf901..9a5b5128b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log.3 b/man3/log.3 index e8b34154a..630390aa0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log10.3 b/man3/log10.3 index a56aa46e3..d5613200f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log1p.3 b/man3/log1p.3 index f6538f2ae..5ca479d1b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log2.3 b/man3/log2.3 index 1f061ed14..10200f5a0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/logb.3 b/man3/logb.3 index 52f5b8878..9b4b296cf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/login.3 b/man3/login.3 index a4a6d9fb0..01f272ffa 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lrint.3 b/man3/lrint.3 index 6a022ecc8..d385a2770 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lround.3 b/man3/lround.3 index a7684182d..c6c51db59 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lsearch.3 b/man3/lsearch.3 index abdbe3ed2..1f9a0f4b0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lseek64.3 b/man3/lseek64.3 index 043a3f7f9..47f425b55 100644 --- a/man3/lseek64.3 +++ b/man3/lseek64.3 @@ -1,4 +1,5 @@ .\" Copyright 2004 Andries Brouwer <aeb@cwi.nl>. +.\" and Copyright (c) 2020 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this @@ -35,7 +36,7 @@ lseek64 \- reposition 64-bit read/write file offset .BI "off64_t lseek64(int " fd ", off64_t " offset ", int " whence ); .SH DESCRIPTION The -.BR lseek (2) +.BR lseek () family of functions reposition the offset of the open file associated with the file descriptor .I fd @@ -55,11 +56,15 @@ For more details, return value, and errors, see .BR lseek (2). .PP Four interfaces are available: -.BR lseek (2), +.BR lseek (), .BR lseek64 (), -.BR llseek (2), +.BR llseek (), and -.BR _llseek (2). +.BR _llseek (). +.\" +.\" For some background details, see: +.\" https://lore.kernel.org/linux-man/CAKgNAkhNSWR3uYhYYaxx74fZfJ3JrpfAAPVrK0AFk_cAOUsbDg@mail.gmail.com/ +.\" .SS lseek() Prototype: .PP @@ -69,8 +74,9 @@ Prototype: .EE .in .PP -.BR lseek (2) -uses the type +The C library's +.BR lseek () +wrapper function uses the type .IR off_t . This is a 32-bit signed type on 32-bit architectures, unless one compiles with @@ -91,9 +97,9 @@ Prototype: .EE .in .PP -The library routine +The .BR lseek64 () -uses a 64-bit type even when +library function uses a 64-bit type even when .I off_t is a 32-bit type. Its prototype (and the type @@ -109,8 +115,8 @@ is available only when one compiles with The function .BR lseek64 () .\" in glibc 2.0.94, not in 2.0.6 -is available since glibc 2.1, and is defined to be an alias for -.BR llseek (). +is available since glibc 2.1. +.\" .SS llseek() Prototype: .PP @@ -123,10 +129,9 @@ Prototype: The type .I loff_t is a 64-bit signed type. -The library routine +The .BR llseek () -.\" in libc 5.0.9, not in 4.7.6 -is available in glibc and works without special defines. +library function is available in glibc and works without special defines. However, the glibc headers do not provide a prototype. Users should add the above prototype, or something equivalent, to their own source. @@ -140,13 +145,15 @@ glibc 2.1.3 added the link-time warning .PP This makes this function unusable if one desires a warning-free compilation. +.PP Since glibc 2.28, .\" glibc commit 5c5c0dd747070db624c8e2c43691cec854f114ef this function symbol is no longer available to newly linked applications. .\" .SS _llseek() On 32-bit architectures, -this is the system call that is used to implement all of the above functions. +this is the system call that is used (by the C library wrapper functions) +to implement all of the above functions. The prototype is: .PP .in +4n @@ -165,6 +172,18 @@ system call. Instead, they have an .BR lseek (2) system call that supports 64-bit file offsets. +.\" In arch/x86/entry/syscalls/syscall_32.tbl, +.\" we see the following line: +.\" +.\" 140 i386 _llseek sys_llseek +.\" +.\" This is essentially telling us that 'sys_llseek' (the name generated +.\" by SYSCALL_DEFINE5(llseek...)) is exposed to user-space as system call +.\" number 140, and that system call number will (IIUC) be exposed in +.\" autogenerated headers with the name "__NR__llseek" (i.e., "_llseek"). +.\" The "i386" is telling us that this happens in i386 (32-bit Intel). +.\" There is nothing equivalent on x86-64, because 64 bit systems don't +.\" need an _llseek system call. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -177,11 +196,30 @@ T{ .BR lseek64 () T} Thread safety MT-Safe .TE +.SH NOTES +.BR lseek64 () +is one of the functions that was specified in the Large File Summit (LFS) +specification that was completed in 1996. +The purpose of the specification was to provide transitional support +that allowed applications on 32-bit systems to access +files whose size exceeds that which can be represented with a 32-bit +.IR off_t +type. +As noted above, this symbol is exposed by header files if the +.B _LARGEFILE64_SOURCE +feature test macro is defined. +ALternatively, on a 32-bit system, the symbol +.I lseek +is aliased to +.I lseek64 +if the macro +.B _FILE_OFFSET_BITS +is defined with the value 64. .SH SEE ALSO .BR llseek (2), .BR lseek (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makecontext.3 b/man3/makecontext.3 index 6f6dc6cf6..f1e2a5282 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -25,7 +25,7 @@ .\" .\" 2006-08-02, mtk, Added example program .\" -.TH MAKECONTEXT 3 2020-06-09 "GNU" "Linux Programmer's Manual" +.TH MAKECONTEXT 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME makecontext, swapcontext \- manipulate user context .SH SYNOPSIS @@ -36,20 +36,21 @@ makecontext, swapcontext \- manipulate user context .PP .BI "int swapcontext(ucontext_t *" oucp ", const ucontext_t *" ucp ); .SH DESCRIPTION -In a System V-like environment, one has the type \fIucontext_t\fP defined in +In a System V-like environment, one has the type +.I ucontext_t +(defined in .I <ucontext.h> +and described in +.BR getcontext (3)) and the four functions .BR getcontext (3), .BR setcontext (3), -.BR makecontext () +.BR makecontext (), and .BR swapcontext () that allow user-level context switching between multiple threads of control within a process. .PP -For the type and the first two functions, see -.BR getcontext (3). -.PP The .BR makecontext () function modifies the context pointed to @@ -238,7 +239,7 @@ main(int argc, char *argv[]) .BR getcontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makedev.3 b/man3/makedev.3 index 6901f8ca3..732ac9dd0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index dbee8b87c..5b6d5f17c 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -322,7 +322,7 @@ main(int argc, char *argv[]) .BR malloc_trim (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc.3 b/man3/malloc.3 index 9e27e3f3e..53f2f7388 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -401,7 +401,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.09 of the Linux +This page is part of release 5.10 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 82b0e5440..551cb6a53 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.09 of the Linux +This page is part of release 5.10 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 29e07a239..26dae259b 100644 --- a/man3/malloc_hook.3 +++ b/man3/malloc_hook.3 @@ -145,7 +145,7 @@ my_malloc_hook(size_t size, const void *caller) .BR mcheck (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 a3333a85a..8c157fb8d 100644 --- a/man3/malloc_info.3 +++ b/man3/malloc_info.3 @@ -270,7 +270,7 @@ main(int argc, char *argv[]) .BR mallopt (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d454d922f..dfd4d6da8 100644 --- a/man3/malloc_stats.3 +++ b/man3/malloc_stats.3 @@ -77,7 +77,7 @@ can be obtained using .BR malloc_info (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 450af3a12..66e1854d7 100644 --- a/man3/malloc_trim.3 +++ b/man3/malloc_trim.3 @@ -102,7 +102,7 @@ top of the heap in the main arena. .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 9e90c858e..787d3a0c3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallopt.3 b/man3/mallopt.3 index e36715e87..d7ca24ba6 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -625,7 +625,7 @@ main(int argc, char *argv[]) .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/matherr.3 b/man3/matherr.3 index 056cd64a2..a2f0c3150 100644 --- a/man3/matherr.3 +++ b/man3/matherr.3 @@ -197,7 +197,8 @@ then the system prints an error message on standard error. The table uses the following notations and abbreviations: .PP .RS -.nf +.TS +l l. x first argument to function y second argument to function fin finite value for argument @@ -207,7 +208,7 @@ o/f result overflowed u/f result underflowed |x| absolute value of x X_TLOSS is a constant defined in \fI<math.h>\fP -.fi +.TE .RE .\" Details below from glibc 2.8's sysdeps/ieee754/k_standard.c .\" A subset of cases were test by experimental programs. @@ -440,7 +441,7 @@ main(int argc, char *argv[]) .BR math_error (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mblen.3 b/man3/mblen.3 index 136cc1e35..ecf42d7c1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index c7e1f15db..cdf2b61a2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrtowc.3 b/man3/mbrtowc.3 index 8fa827869..4a0469acf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index ad9422483..3bceae7da 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index c4d1c8e51..d0f61b313 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -199,7 +199,7 @@ is not multithread safe. .BR mbsinit (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index af2814d76..bf77ef584 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index ff4dabdd9..dee5d315c 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -233,7 +233,7 @@ main(int argc, char *argv[]) .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index 2fe68d85d..f554adff1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mcheck.3 b/man3/mcheck.3 index 9c2948628..259b6dc25 100644 --- a/man3/mcheck.3 +++ b/man3/mcheck.3 @@ -227,7 +227,7 @@ main(int argc, char *argv[]) .BR mallopt (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memccpy.3 b/man3/memccpy.3 index 2ac55e55c..c001c3361 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memchr.3 b/man3/memchr.3 index 9ebb068a3..d287e53cf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcmp.3 b/man3/memcmp.3 index 3e2f096dd..ad350d4aa 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -95,7 +95,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcpy.3 b/man3/memcpy.3 index 02850af42..26cb57445 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 8d73fcd08..99677e1a7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmem.3 b/man3/memmem.3 index 505083ede..ffe7a0f13 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmove.3 b/man3/memmove.3 index efb97cd6f..daf5612ee 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 7e90a31a1..2d572c2fa 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -87,7 +87,7 @@ combine(void *o1, size_t s1, void *o2, size_t s2) .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memset.3 b/man3/memset.3 index 66deee2a4..a500d4fe2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index 1cda4d9e0..c733771b8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index 647258355..b998a26ef 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index 54896222a..76223dcd7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mktemp.3 b/man3/mktemp.3 index 3054bbed7..b4004435c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/modf.3 b/man3/modf.3 index 5717ef039..289c972b1 100644 --- a/man3/modf.3 +++ b/man3/modf.3 @@ -51,7 +51,7 @@ Feature Test Macro Requirements for glibc (see .RE .PP .ad l -.BR modf (), +.BR modff (), .BR modfl (): .RS 4 _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L @@ -109,7 +109,7 @@ SVr4, 4.3BSD, C89. .BR frexp (3), .BR ldexp (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mpool.3 b/man3/mpool.3 index ac5b85f8f..0eec0ec13 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.09 of the Linux +This page is part of release 5.10 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 de80aab03..7a0f80da6 100644 --- a/man3/mq_close.3 +++ b/man3/mq_close.3 @@ -83,7 +83,7 @@ or upon .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 45e8f1662..d240e14d3 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -241,7 +241,7 @@ main(int argc, char *argv[]) .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2b7df7187..a338a7240 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -284,7 +284,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 0daef1d43..a5d900974 100644 --- a/man3/mq_open.3 +++ b/man3/mq_open.3 @@ -311,7 +311,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.09 of the Linux +This page is part of release 5.10 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 28377cf6b..6288fb989 100644 --- a/man3/mq_receive.3 +++ b/man3/mq_receive.3 @@ -182,7 +182,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.09 of the Linux +This page is part of release 5.10 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 0cc614b1d..a6c5fc6b6 100644 --- a/man3/mq_send.3 +++ b/man3/mq_send.3 @@ -190,7 +190,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.09 of the Linux +This page is part of release 5.10 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 f41d16253..67c4aae13 100644 --- a/man3/mq_unlink.3 +++ b/man3/mq_unlink.3 @@ -81,7 +81,7 @@ POSIX.1-2001, POSIX.1-2008. .BR mq_send (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mtrace.3 b/man3/mtrace.3 index a711cacbf..db6780cc5 100644 --- a/man3/mtrace.3 +++ b/man3/mtrace.3 @@ -190,7 +190,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nan.3 b/man3/nan.3 index b7c4e388b..25759453d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/netlink.3 b/man3/netlink.3 index 13e4b8243..abf9a3d56 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/newlocale.3 b/man3/newlocale.3 index d7d45a244..46a2a1be7 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -379,7 +379,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextafter.3 b/man3/nextafter.3 index 22e36e4d4..52baef3a5 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -8,7 +8,7 @@ .\" .\" Based on glibc infopages .\" -.TH NEXTAFTER 3 2020-06-09 "GNU" "Linux Programmer's Manual" +.TH NEXTAFTER 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating-point number manipulation @@ -192,7 +192,7 @@ 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 +.PP Before glibc version 2.23 .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799 these functions did not set @@ -200,7 +200,7 @@ these functions did not set .SH SEE ALSO .BR nearbyint (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextup.3 b/man3/nextup.3 index 913e2d546..0a01bd8c6 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.09 of the Linux +This page is part of release 5.10 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 0fa5649da..21cbacdb0 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -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.09 of the Linux +This page is part of release 5.10 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 1c5a66b24..9d4b8e77c 100644 --- a/man3/ntp_gettime.3 +++ b/man3/ntp_gettime.3 @@ -147,7 +147,7 @@ is a GNU extension. NTP "Kernel Application Program Interface" .UE .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/offsetof.3 b/man3/offsetof.3 index 030305739..2d18f5ceb 100644 --- a/man3/offsetof.3 +++ b/man3/offsetof.3 @@ -102,7 +102,7 @@ main(void) } .EE .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 31b678881..d13aa5878 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.09 of the Linux +This page is part of release 5.10 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 5445fe02d..d59136fef 100644 --- a/man3/open_memstream.3 +++ b/man3/open_memstream.3 @@ -144,7 +144,7 @@ See .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/opendir.3 b/man3/opendir.3 index ec06399d2..886ae1558 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/openpty.3 b/man3/openpty.3 index 918b83db7..2c667b0c6 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -199,7 +199,7 @@ may not be secure. .BR ttyname (3), .BR pty (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/perror.3 b/man3/perror.3 index e67029616..fe924194f 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -162,7 +162,7 @@ are defined by glibc, but in .BR error (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/popen.3 b/man3/popen.3 index e32f83a9d..eff3ec2b4 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.09 of the Linux +This page is part of release 5.10 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 bb158cfdb..678f96741 100644 --- a/man3/posix_fallocate.3 +++ b/man3/posix_fallocate.3 @@ -191,7 +191,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.09 of the Linux +This page is part of release 5.10 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 1537fc894..f6c2cf228 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.09 of the Linux +This page is part of release 5.10 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 49225ed71..e5bb580d8 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -26,7 +26,7 @@ .\" 2001-10-11, 2003-08-22, aeb, added some details .\" 2012-03-23, Michael Kerrisk <mtk.manpages@mail.com> .\" Document pvalloc() and aligned_alloc() -.TH POSIX_MEMALIGN 3 2020-08-13 "GNU" "Linux Programmer's Manual" +.TH POSIX_MEMALIGN 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME posix_memalign, aligned_alloc, memalign, valloc, pvalloc \- allocate aligned memory .SH SYNOPSIS @@ -245,7 +245,8 @@ is declared in \fI<stdlib.h>\fP instead of \fI<malloc.h>\fP. According to SUSv2, .BR valloc () is declared in \fI<stdlib.h>\fP. -Libc4,5 and glibc declare it in \fI<malloc.h>\fP, and also in +.\" Libc4,5 and +Glibc declares it in \fI<malloc.h>\fP, and also in \fI<stdlib.h>\fP if suitable feature test macros are defined (see above). .SH NOTES @@ -305,7 +306,7 @@ needed only if you require larger alignment values. .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2cb04e2e5..fac657aae 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.09 of the Linux +This page is part of release 5.10 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 b58dbbca8..55b7e8fdc 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -844,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow.3 b/man3/pow.3 index b8006de34..ff970f335 100644 --- a/man3/pow.3 +++ b/man3/pow.3 @@ -379,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow10.3 b/man3/pow10.3 index 5a682a94f..69888c16d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/printf.3 b/man3/printf.3 index 1a4e21159..e2cbdb174 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -101,7 +101,7 @@ write output to the given output .IR stream ; .BR sprintf (), .BR snprintf (), -.BR vsprintf () +.BR vsprintf (), and .BR vsnprintf () write to the character string @@ -1181,7 +1181,7 @@ error instead of being handled gracefully. .BR wprintf (3), .BR locale (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/profil.3 b/man3/profil.3 index b1a009246..9a20fb842 100644 --- a/man3/profil.3 +++ b/man3/profil.3 @@ -25,7 +25,7 @@ .\" Modified Fri Jun 23 01:35:19 1995 Andries Brouwer <aeb@cwi.nl> .\" (prompted by Bas V. de Bakker <bas@phys.uva.nl>) .\" Corrected (and moved to man3), 980612, aeb -.TH PROFIL 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PROFIL 3 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME profil \- execution time profile .SH SYNOPSIS @@ -98,7 +98,7 @@ interval timers (see .BR setitimer (2)). .PP True kernel profiling provides more accurate results. -Libc 4.4 contained a kernel patch providing a system call profil. +.\" Libc 4.4 contained a kernel patch providing a system call profil. .SH SEE ALSO .BR gprof (1), .BR sprof (1), @@ -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.09 of the Linux +This page is part of release 5.10 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 4f6f39983..80e56ca3c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/psignal.3 b/man3/psignal.3 index 58d75d998..fff259b60 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -125,7 +125,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.09 of the Linux +This page is part of release 5.10 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 306474a1b..b36d7be30 100644 --- a/man3/pthread_atfork.3 +++ b/man3/pthread_atfork.3 @@ -124,7 +124,7 @@ shall not fail with the error .BR atexit (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_getsigmask_np.3 b/man3/pthread_attr_getsigmask_np.3 new file mode 100644 index 000000000..92b55d302 --- /dev/null +++ b/man3/pthread_attr_getsigmask_np.3 @@ -0,0 +1 @@ +.so man3/pthread_attr_setsigmask_np.3 diff --git a/man3/pthread_attr_init.3 b/man3/pthread_attr_init.3 index 656201cea..3b435f0ea 100644 --- a/man3/pthread_attr_init.3 +++ b/man3/pthread_attr_init.3 @@ -328,7 +328,7 @@ main(int argc, char *argv[]) .BR pthread_setattr_default_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 b7801b5a5..5ef80c30d 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.09 of the Linux +This page is part of release 5.10 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 5bc302801..33e5573d6 100644 --- a/man3/pthread_attr_setdetachstate.3 +++ b/man3/pthread_attr_setdetachstate.3 @@ -33,8 +33,8 @@ set/get detach state attribute in thread attributes object .PP .BI "int pthread_attr_setdetachstate(pthread_attr_t *" attr \ ", int " detachstate ); -.BI "int pthread_attr_getdetachstate(const pthread_attr_t *" attr \ -", int *" detachstate ); +.BI "int pthread_attr_getdetachstate(const pthread_attr_t *" attr , +.BI " int *" detachstate ); .PP Compile and link with \fI\-pthread\fP. .fi @@ -128,7 +128,7 @@ See .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 e9635b12f..f9725c8ba 100644 --- a/man3/pthread_attr_setguardsize.3 +++ b/man3/pthread_attr_setguardsize.3 @@ -33,8 +33,8 @@ attribute in thread attributes object .PP .BI "int pthread_attr_setguardsize(pthread_attr_t *" attr \ ", size_t " guardsize ); -.BI "int pthread_attr_getguardsize(const pthread_attr_t *" attr \ -", size_t *" guardsize ); +.BI "int pthread_attr_getguardsize(const pthread_attr_t *" attr , +.BI " size_t *" guardsize ); .PP Compile and link with \fI\-pthread\fP. .fi @@ -177,7 +177,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 3c939eac0..bb91c743e 100644 --- a/man3/pthread_attr_setinheritsched.3 +++ b/man3/pthread_attr_setinheritsched.3 @@ -154,7 +154,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 00a0ea9b3..60a08f1f9 100644 --- a/man3/pthread_attr_setschedparam.3 +++ b/man3/pthread_attr_setschedparam.3 @@ -139,7 +139,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 51807bc07..a0482ac7d 100644 --- a/man3/pthread_attr_setschedpolicy.3 +++ b/man3/pthread_attr_setschedpolicy.3 @@ -127,7 +127,7 @@ See .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 b00a9eb90..97716a7a2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_setsigmask_np.3 b/man3/pthread_attr_setsigmask_np.3 index 26a90f80a..3018c1923 100644 --- a/man3/pthread_attr_setsigmask_np.3 +++ b/man3/pthread_attr_setsigmask_np.3 @@ -146,7 +146,7 @@ before it has adjusted its signal mask to the desired value. .BR pthreads (7), .BR signals (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 8cd2b9c25..6ce8fd48a 100644 --- a/man3/pthread_attr_setstack.3 +++ b/man3/pthread_attr_setstack.3 @@ -178,7 +178,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 7f4837f81..0d7a0c194 100644 --- a/man3/pthread_attr_setstackaddr.3 +++ b/man3/pthread_attr_setstackaddr.3 @@ -33,8 +33,8 @@ set/get stack address attribute in thread attributes object .PP .BI "int pthread_attr_setstackaddr(pthread_attr_t *" attr \ ", void *" stackaddr ); -.BI "int pthread_attr_getstackaddr(const pthread_attr_t *" attr \ -", void **" stackaddr ); +.BI "int pthread_attr_getstackaddr(const pthread_attr_t *" attr , +.BI " void **" stackaddr ); .PP Compile and link with \fI\-pthread\fP. .fi @@ -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.09 of the Linux +This page is part of release 5.10 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 59a2363a0..c144fb25f 100644 --- a/man3/pthread_attr_setstacksize.3 +++ b/man3/pthread_attr_setstacksize.3 @@ -33,8 +33,8 @@ attribute in thread attributes object .PP .BI "int pthread_attr_setstacksize(pthread_attr_t *" attr \ ", size_t " stacksize ); -.BI "int pthread_attr_getstacksize(const pthread_attr_t *" attr \ -", size_t *" stacksize ); +.BI "int pthread_attr_getstacksize(const pthread_attr_t *" attr , +.BI " size_t *" stacksize ); .PP Compile and link with \fI\-pthread\fP. .fi @@ -129,7 +129,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 0b9452f3a..01ff1ed15 100644 --- a/man3/pthread_cancel.3 +++ b/man3/pthread_cancel.3 @@ -249,7 +249,7 @@ main(void) .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 56385dde8..2d0042a79 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -333,7 +333,7 @@ main(int argc, char *argv[]) .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2a4c2c546..d82d1b195 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.09 of the Linux +This page is part of release 5.10 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 05e31bdd3..f5bf71761 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -417,7 +417,7 @@ main(int argc, char *argv[]) .BR pthread_setattr_default_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 7d4c1f475..8120c9b2f 100644 --- a/man3/pthread_detach.3 +++ b/man3/pthread_detach.3 @@ -115,7 +115,7 @@ The following statement detaches the calling thread: .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d6544f6b2..777a740c2 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.09 of the Linux +This page is part of release 5.10 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 97bc1a5c8..6fe4a18f0 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.09 of the Linux +This page is part of release 5.10 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 1e956f922..b7e6b641c 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -210,7 +210,7 @@ main(int argc, char *argv[]) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 86245a752..c68f39951 100644 --- a/man3/pthread_getattr_np.3 +++ b/man3/pthread_getattr_np.3 @@ -373,7 +373,7 @@ main(int argc, char *argv[]) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c104c5128..1a2532c3a 100644 --- a/man3/pthread_getcpuclockid.3 +++ b/man3/pthread_getcpuclockid.3 @@ -192,7 +192,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 cf6d30988..52c2ceb8f 100644 --- a/man3/pthread_join.3 +++ b/man3/pthread_join.3 @@ -148,7 +148,7 @@ See .BR pthread_tryjoin_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 53bba6e35..e9881f1c4 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.09 of the Linux +This page is part of release 5.10 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 3d9fe79ef..02b424f4a 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.09 of the Linux +This page is part of release 5.10 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 eed8dd616..d9e8e6b05 100644 --- a/man3/pthread_mutex_consistent.3 +++ b/man3/pthread_mutex_consistent.3 @@ -105,7 +105,7 @@ See .BR pthread_mutexattr_setrobust (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 0e0decc5f..62cbbf1b4 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.09 of the Linux +This page is part of release 5.10 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 b49c3b06e..a5466a0a5 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.09 of the Linux +This page is part of release 5.10 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 0e020cb67..67f4d4dcf 100644 --- a/man3/pthread_mutexattr_setrobust.3 +++ b/man3/pthread_mutexattr_setrobust.3 @@ -202,10 +202,10 @@ The following shell session shows what we see when running this program: $ \fB./a.out\fP [original owner] Setting lock... [original owner] Locked. Now exiting without unlocking. -[main thread] Attempting to lock the robust mutex. -[main thread] pthread_mutex_lock() returned EOWNERDEAD -[main thread] Now make the mutex consistent -[main thread] Mutex is now consistent; unlocking +[main] Attempting to lock the robust mutex. +[main] pthread_mutex_lock() returned EOWNERDEAD +[main] Now make the mutex consistent +[main] Mutex is now consistent; unlocking .EE .in .SS Program source @@ -217,7 +217,7 @@ $ \fB./a.out\fP #include <errno.h> #define handle_error_en(en, msg) \e - do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0) + do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0) static pthread_mutex_t mtx; @@ -250,25 +250,25 @@ main(int argc, char *argv[]) /* "original_owner_thread" should have exited by now */ - printf("[main thread] Attempting to lock the robust mutex.\en"); + printf("[main] Attempting to lock the robust mutex.\en"); s = pthread_mutex_lock(&mtx); if (s == EOWNERDEAD) { - printf("[main thread] pthread_mutex_lock() returned EOWNERDEAD\en"); - printf("[main thread] Now make the mutex consistent\en"); + printf("[main] pthread_mutex_lock() returned EOWNERDEAD\en"); + printf("[main] Now make the mutex consistent\en"); s = pthread_mutex_consistent(&mtx); if (s != 0) handle_error_en(s, "pthread_mutex_consistent"); - printf("[main thread] Mutex is now consistent; unlocking\en"); + printf("[main] Mutex is now consistent; unlocking\en"); s = pthread_mutex_unlock(&mtx); if (s != 0) handle_error_en(s, "pthread_mutex_unlock"); exit(EXIT_SUCCESS); } else if (s == 0) { - printf("[main thread] pthread_mutex_lock() unexpectedly succeeded\en"); + printf("[main] pthread_mutex_lock() unexpectedly succeeded\en"); exit(EXIT_FAILURE); } else { - printf("[main thread] pthread_mutex_lock() unexpectedly failed\en"); + printf("[main] pthread_mutex_lock() unexpectedly failed\en"); handle_error_en(s, "pthread_mutex_lock"); } } @@ -283,7 +283,7 @@ main(int argc, char *argv[]) .BR pthread_mutex_lock (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 14b2e06ab..1388ea6bd 100644 --- a/man3/pthread_rwlockattr_setkind_np.3 +++ b/man3/pthread_rwlockattr_setkind_np.3 @@ -143,7 +143,7 @@ hence the suffix "_np" (nonportable) in the names. .SH SEE ALSO .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 eb439f53f..4fe15c7ad 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.09 of the Linux +This page is part of release 5.10 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 a06dd6229..22838b05b 100644 --- a/man3/pthread_setaffinity_np.3 +++ b/man3/pthread_setaffinity_np.3 @@ -222,7 +222,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 0b68ab1e8..8583a2338 100644 --- a/man3/pthread_setcancelstate.3 +++ b/man3/pthread_setcancelstate.3 @@ -211,7 +211,7 @@ See .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c003120bb..6c370151b 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.09 of the Linux +This page is part of release 5.10 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 2fd7ed2f7..d86fa2bef 100644 --- a/man3/pthread_setname_np.3 +++ b/man3/pthread_setname_np.3 @@ -218,7 +218,7 @@ main(int argc, char **argv) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 40d4c3ece..0d503fdce 100644 --- a/man3/pthread_setschedparam.3 +++ b/man3/pthread_setschedparam.3 @@ -458,7 +458,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR sched (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 ebd6678e4..820228865 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.09 of the Linux +This page is part of release 5.10 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 a60e32739..cbc0379e3 100644 --- a/man3/pthread_sigmask.3 +++ b/man3/pthread_sigmask.3 @@ -175,7 +175,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 72a36cfe9..59d35a04b 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.09 of the Linux +This page is part of release 5.10 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 8b120dae3..e5ca3430c 100644 --- a/man3/pthread_spin_init.3 +++ b/man3/pthread_spin_init.3 @@ -168,7 +168,7 @@ thread placement, and priority assignment. .BR pthread_spin_unlock (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 382e68f9f..cb2c6bed2 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.09 of the Linux +This page is part of release 5.10 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 a51a93613..5f11b2d22 100644 --- a/man3/pthread_testcancel.3 +++ b/man3/pthread_testcancel.3 @@ -78,7 +78,7 @@ See .BR pthread_setcancelstate (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d7bdf4f2b..89de89693 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 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_TRYJOIN_NP 3 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME pthread_tryjoin_np, pthread_timedjoin_np \- try to join with a terminated thread @@ -63,7 +63,10 @@ If .I thread has not yet terminated, then the call blocks until a maximum time, specified in -.IR abstime . +.IR abstime , +measured against the +.BR CLOCK_REALTIME +clock. If the timeout expires before .I thread terminates, @@ -157,13 +160,25 @@ if (s != 0) { } .EE .in +.SH BUGS +The +.BR pthread_timedjoin_np () +function measures time by internally calculating a relative sleep interval +that is then measured against the +.BR CLOCK_MONOTONIC +clock instead of the +.BR CLOCK_REALTIME +clock. +Consequently, the timeout is unaffected by discontinuous changes to the +.BR CLOCK_REALTIME +clock. .SH SEE ALSO .BR clock_gettime (2), .BR pthread_exit (3), .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c4377fff1..69472e773 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ptsname.3 b/man3/ptsname.3 index 84233951c..da3e80460 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -131,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putenv.3 b/man3/putenv.3 index cdedeb4a2..60de0e3d5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putgrent.3 b/man3/putgrent.3 index 4b76b6e8f..c026bcd47 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putpwent.3 b/man3/putpwent.3 index fca46fc2d..5b8c9d54d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/puts.3 b/man3/puts.3 index 6e1b8ed40..c308b278c 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu) -.TH PUTS 3 2018-04-30 "GNU" "Linux Programmer's Manual" +.TH PUTS 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME fputc, fputs, putc, putchar, puts \- output of characters and strings .SH SYNOPSIS @@ -83,7 +83,7 @@ For nonlocking counterparts, see .BR unlocked_stdio (3). .SH RETURN VALUE .BR fputc (), -.BR putc () +.BR putc (), and .BR putchar () return the character written as an @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putwchar.3 b/man3/putwchar.3 index 4b8b3e05a..266550fd2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qecvt.3 b/man3/qecvt.3 index f8fbd284b..a3e7e3a58 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qsort.3 b/man3/qsort.3 index a39c76213..c5a7c0811 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -161,7 +161,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR versionsort (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/raise.3 b/man3/raise.3 index f7dad1dae..8e9c82840 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rand.3 b/man3/rand.3 index 693d5d236..e41000831 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -238,7 +238,7 @@ main(int argc, char *argv[]) .BR drand48 (3), .BR random (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/random.3 b/man3/random.3 index d7940f4aa..4b9fde419 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -209,7 +209,7 @@ is (as specified) set on error, but the function does not return NULL. .BR random_r (3), .BR srand (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 c4fa2e40f..23413aac7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rcmd.3 b/man3/rcmd.3 index 4807f8c65..2e587deb7 100644 --- a/man3/rcmd.3 +++ b/man3/rcmd.3 @@ -40,7 +40,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH RCMD 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH RCMD 3 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME rcmd, rresvport, iruserok, ruserok, rcmd_af, rresvport_af, iruserok_af, ruserok_af \- routines for returning a @@ -312,13 +312,12 @@ are declared in glibc headers only since version 2.12. .SH SEE ALSO .BR rlogin (1), .BR rsh (1), -.BR intro (2), .BR rexec (3), .BR rexecd (8), .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 156611b8e..f2c4fb18d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/readdir.3 b/man3/readdir.3 index 94cb969a0..f4178ab33 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -312,7 +312,7 @@ structure shown above. .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 e7435a4b8..0058ced99 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/realpath.3 b/man3/realpath.3 index 82a11a97f..6120645a8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/recno.3 b/man3/recno.3 index 3b924fcd3..62199d9ec 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/regex.3 b/man3/regex.3 index 995aa3b0e..3848606dd 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -370,7 +370,8 @@ int main(void) off = pmatch[0].rm_so + (s \- str); len = pmatch[0].rm_eo \- pmatch[0].rm_so; printf("#%d:\en", i); - printf("offset = %jd; length = %jd\en", (intmax_t) off, (intmax_t) len); + printf("offset = %jd; length = %jd\en", (intmax_t) off, + (intmax_t) len); printf("substring = \e"%.*s\e"\en", len, s + pmatch[0].rm_so); s += pmatch[0].rm_eo; @@ -386,7 +387,7 @@ int main(void) The glibc manual section, .I "Regular Expressions" .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remainder.3 b/man3/remainder.3 index 0b6f56fb1..59e6306da 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -241,7 +241,7 @@ The call "remainder(29.0, 3.0)" returns \-1. .BR fmod (3), .BR remquo (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remove.3 b/man3/remove.3 index 8d214b603..6843a6901 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remquo.3 b/man3/remquo.3 index c037bc8f4..73ced813c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/resolver.3 b/man3/resolver.3 index 6cf743acd..ac42838e0 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -30,7 +30,7 @@ .\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" -.TH RESOLVER 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH RESOLVER 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME res_ninit, res_nclose, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend, res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, @@ -428,7 +428,7 @@ Do not look up unqualified name as a top-level domain (TLD). Default option which implies: .BR RES_RECURSE , .BR RES_DEFNAMES , -.BR RES_DNSRCH +.BR RES_DNSRCH , and .BR RES_NOIP6DOTINT . .\" @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index d3370dee2..df96942a7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rexec.3 b/man3/rexec.3 index c60f7acb0..298b3cb4e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rint.3 b/man3/rint.3 index 20db5fdd5..48560c19e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/round.3 b/man3/round.3 index 3289fe072..e4ee53e34 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpc.3 b/man3/rpc.3 index 8dd3915a2..ed5dc6763 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index 337f64240..6c776705a 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -164,7 +164,7 @@ main(int argc, char *argv[]) .BR regcomp (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtime.3 b/man3/rtime.3 index 521f97024..d7df2eb14 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -9,7 +9,7 @@ .\" .\" Slightly polished, aeb, 2003-04-06 .\" -.TH RTIME 3 2020-06-09 "GNU" "Linux Programmer's Manual" +.TH RTIME 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME rtime \- get time from a remote machine .SH SYNOPSIS @@ -75,17 +75,17 @@ versions support only TCP. Try the example program with .I use_tcp set to 1. -.PP -Libc5 uses the prototype -.PP -.nf - int rtime(struct sockaddr_in *, struct timeval *, struct timeval *); -.fi -.PP -and requires -.I <sys/time.h> -instead of -.IR <rpc/auth_des.h> . +.\" .PP +.\" Libc5 uses the prototype +.\" .PP +.\" .nf +.\" int rtime(struct sockaddr_in *, struct timeval *, struct timeval *); +.\" .fi +.\" .PP +.\" and requires +.\" .I <sys/time.h> +.\" instead of +.\" .IR <rpc/auth_des.h> . .SH BUGS .BR rtime () in glibc 2.2.5 and earlier does not work properly on 64-bit machines. @@ -143,7 +143,7 @@ main(void) .\" .BR rdate (1), .BR inetd (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index effa79004..244ca2d92 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -126,7 +126,7 @@ send(rtnetlink_sk, &req, req.nh.nlmsg_len, 0); .BR netlink (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalb.3 b/man3/scalb.3 index a70ba15de..1c9fa4772 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -220,7 +220,7 @@ for domain and range errors. .BR ldexp (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalbln.3 b/man3/scalbln.3 index d9447326d..33cb02c35 100644 --- a/man3/scalbln.3 +++ b/man3/scalbln.3 @@ -193,7 +193,7 @@ for range errors. .BR ldexp (3), .BR scalb (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scandir.3 b/man3/scandir.3 index 4299013d6..22c412471 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -80,10 +80,8 @@ a directory for matching entries .BR "#include <fcntl.h>" " /* Definition of AT_* constants */" .B #include <dirent.h> .PP -.fi .BI "int scandirat(int " dirfd ", const char *" dirp "," .BI "struct dirent ***" namelist , -.nf .RS .BI "int (*" filter ")(const struct dirent *)," .BI "int (*" compar ")(const struct dirent **, const struct dirent **));" @@ -332,7 +330,7 @@ main(void) .BR strverscmp (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scanf.3 b/man3/scanf.3 index df493d1d9..47811d103 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -773,7 +773,7 @@ call successfully read a string. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 ba875d0be..72cf891b3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 17e2c3f84..a7a47cf36 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.09 of the Linux +This page is part of release 5.10 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 82d2acee7..2f451d4a2 100644 --- a/man3/sem_close.3 +++ b/man3/sem_close.3 @@ -77,7 +77,7 @@ termination, or upon .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 809402fb4..ebb072695 100644 --- a/man3/sem_destroy.3 +++ b/man3/sem_destroy.3 @@ -88,7 +88,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.09 of the Linux +This page is part of release 5.10 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 063ae5f1e..2303ad9c2 100644 --- a/man3/sem_getvalue.3 +++ b/man3/sem_getvalue.3 @@ -87,7 +87,7 @@ returns. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 8b043247a..8373e0649 100644 --- a/man3/sem_init.3 +++ b/man3/sem_init.3 @@ -121,7 +121,7 @@ and .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 9f5536a02..15e0e0545 100644 --- a/man3/sem_open.3 +++ b/man3/sem_open.3 @@ -189,7 +189,7 @@ POSIX.1-2001, POSIX.1-2008. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 3aa1f563f..cf266ae98 100644 --- a/man3/sem_post.3 +++ b/man3/sem_post.3 @@ -86,7 +86,7 @@ and .BR sem_overview (7), .BR signal\-safety (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 6a0e64431..66ecff5d2 100644 --- a/man3/sem_unlink.3 +++ b/man3/sem_unlink.3 @@ -79,7 +79,7 @@ POSIX.1-2001, POSIX.1-2008. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 80caecc3d..d41276ea2 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -270,7 +270,7 @@ main(int argc, char *argv[]) .BR sem_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index 7ee3926a6..600ec5692 100644 --- a/man3/setaliasent.3 +++ b/man3/setaliasent.3 @@ -173,7 +173,7 @@ main(void) .\" Yellow Pages .\" newaliases, postalias .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setbuf.3 b/man3/setbuf.3 index 52c5a4389..7c9dec312 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setenv.3 b/man3/setenv.3 index 978790bc1..92ee1fed3 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -166,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setjmp.3 b/man3/setjmp.3 index ee6b42725..112607a65 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -326,7 +326,7 @@ returning from the initial call to .BR signal (7), .BR signal\-safety (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 90bdc720b..3bddffa2c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index 84c036b83..4ef898f6a 100644 --- a/man3/setlogmask.3 +++ b/man3/setlogmask.3 @@ -97,7 +97,7 @@ will be included in the next release of the POSIX specification (Issue 8). .BR openlog (3), .BR syslog (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 1c27079d6..b61f517dd 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.09 of the Linux +This page is part of release 5.10 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 995d87069..31557fea6 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -515,7 +515,7 @@ main(int argc, char *argv[]) .BR umask (2), .BR shm_overview (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index a598be215..f4269e76c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/signbit.3 b/man3/signbit.3 index 39450918c..94d61acf4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/significand.3 b/man3/significand.3 index 6f38c9bb7..4774642c2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigpause.3 b/man3/sigpause.3 index fcb97adde..61cb71122 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigqueue.3 b/man3/sigqueue.3 index 05f196598..0647c18c4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigset.3 b/man3/sigset.3 index caca3edb8..89c980268 100644 --- a/man3/sigset.3 +++ b/man3/sigset.3 @@ -289,7 +289,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigsetops.3 b/man3/sigsetops.3 index dab8f243b..41c692f05 100644 --- a/man3/sigsetops.3 +++ b/man3/sigsetops.3 @@ -28,7 +28,7 @@ .\" 2007-10-26 mdw added wording that a sigset_t must be initialized .\" prior to use .\" -.TH SIGSETOPS 3 2016-03-15 "Linux" "Linux Programmer's Manual" +.TH SIGSETOPS 3 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX signal set operations @@ -95,7 +95,7 @@ or .BR sigfillset () before being passed to the functions .BR sigaddset (), -.BR sigdelset () +.BR sigdelset (), and .BR sigismember () or the additional glibc functions described below @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigvec.3 b/man3/sigvec.3 index 257da1397..91ed6911a 100644 --- a/man3/sigvec.3 +++ b/man3/sigvec.3 @@ -287,7 +287,7 @@ for details. .BR sigset (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 5d05fc073..9439822b9 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -121,7 +121,7 @@ See .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sin.3 b/man3/sin.3 index 7a35782d9..88539c5eb 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sincos.3 b/man3/sincos.3 index 1d87973b0..c7eea606b 100644 --- a/man3/sincos.3 +++ b/man3/sincos.3 @@ -109,7 +109,7 @@ when a domain error occurred. .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sinh.3 b/man3/sinh.3 index 2cb7b8397..777738db2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sleep.3 b/man3/sleep.3 index 01776948e..2901acfd0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/slist.3 b/man3/slist.3 index b0c397df5..840d01dc1 100644 --- a/man3/slist.3 +++ b/man3/slist.3 @@ -356,7 +356,7 @@ main(void) .BR insque (3), .BR queue (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index 3e771fce7..0a27f0274 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -149,7 +149,7 @@ and then read the byte of data at the mark: .BR send (2), .BR tcp (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sqrt.3 b/man3/sqrt.3 index 839c3be79..9aa6eab34 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stailq.3 b/man3/stailq.3 index d31eb62c8..35d4b42b8 100644 --- a/man3/stailq.3 +++ b/man3/stailq.3 @@ -394,7 +394,7 @@ main(void) .BR insque (3), .BR queue (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/statvfs.3 b/man3/statvfs.3 index c3d1573bb..d55af2a78 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdarg.3 b/man3/stdarg.3 index f56d7bc54..35c3d7a71 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -314,7 +314,7 @@ foo(char *fmt, ...) /* \(aq...\(aq is C syntax for a variadic function */ .BR vscanf (3), .BR vsyslog (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdin.3 b/man3/stdin.3 index 657cb5c70..5e2482308 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdio.3 b/man3/stdio.3 index 25e3d4030..56f02cc7f 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.09 of the Linux +This page is part of release 5.10 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 dd1786f81..7fb1dcfd6 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index 8e973de8b..43c4a725d 100644 --- a/man3/stpcpy.3 +++ b/man3/stpcpy.3 @@ -129,7 +129,7 @@ main(void) .BR string (3), .BR wcpcpy (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpncpy.3 b/man3/stpncpy.3 index 584384b96..ed30278d9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index 7a5ea6948..e5f585dc8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcat.3 b/man3/strcat.3 index 8dc08dfba..780f505fb 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -233,7 +233,7 @@ main(int argc, char *argv[]) .BR wcscat (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strchr.3 b/man3/strchr.3 index f5d853224..7aeda8245 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 5466a8217..253396082 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -219,7 +219,7 @@ main(int argc, char *argv[]) .BR wcsncmp (3), .BR ascii (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcoll.3 b/man3/strcoll.3 index 6c66a73aa..e322adc34 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcpy.3 b/man3/strcpy.3 index 4dce2a919..be042899c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strdup.3 b/man3/strdup.3 index 303ba1393..cb0bf405b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strerror.3 b/man3/strerror.3 index 5b5055c35..a70c4a33a 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -252,7 +252,7 @@ T{ T} Thread safety MT-Unsafe race:strerror T{ .BR strerrorname_np (), -.BR strerrordesc () +.BR strerrordesc_np () T} Thread safety MT-Safe T{ .BR strerror_r (), @@ -319,7 +319,7 @@ are thread-safe and async-signal-safe. .BR strsignal (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfmon.3 b/man3/strfmon.3 index 26d7dedb1..a8ec3a31f 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -217,7 +217,7 @@ locales yield .BR sprintf (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfromd.3 b/man3/strfromd.3 index 98e0d3909..7c80abe2c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfry.3 b/man3/strfry.3 index 08326018c..aa3f14242 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strftime.3 b/man3/strftime.3 index 3fe80d9d4..2fb0348e2 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -756,7 +756,7 @@ main(int argc, char *argv[]) .BR sprintf (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/string.3 b/man3/string.3 index f814c0c05..1181044e1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strlen.3 b/man3/strlen.3 index 012b17719..1d81df5ee 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strnlen.3 b/man3/strnlen.3 index 5a3cea3d9..cf0aba31b 100644 --- a/man3/strnlen.3 +++ b/man3/strnlen.3 @@ -10,7 +10,7 @@ .\" References consulted: .\" GNU glibc-2 source code and manual .\" -.TH STRNLEN 3 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH STRNLEN 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME strnlen \- determine the length of a fixed-size string .SH SYNOPSIS @@ -54,7 +54,7 @@ looks only at the first characters in the string pointed to by .I s and never beyond -.IR s+maxlen . +.IR s[maxlen\-1] . .SH RETURN VALUE The .BR strnlen () @@ -85,7 +85,7 @@ POSIX.1-2008. .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index 074921d3a..943f940dd 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strptime.3 b/man3/strptime.3 index 2b907a508..face02368 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -443,7 +443,7 @@ main(void) .BR setlocale (3), .BR strftime (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsep.3 b/man3/strsep.3 index 091451f95..dc37ce949 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 7ee02d0a2..a94e1807f 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -178,7 +178,7 @@ are thread-safe and async-signal-safe. .BR psignal (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strspn.3 b/man3/strspn.3 index e61aaeca0..b87d914fc 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strstr.3 b/man3/strstr.3 index c57ae9b49..78b06f6b3 100644 --- a/man3/strstr.3 +++ b/man3/strstr.3 @@ -98,7 +98,7 @@ function is a nonstandard extension. .BR strtok (3), .BR wcsstr (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtod.3 b/man3/strtod.3 index 3bb588d2d..a5c9a0f90 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -221,7 +221,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoimax.3 b/man3/strtoimax.3 index 3ed3053e3..793e01a32 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtok.3 b/man3/strtok.3 index 2b1af5829..86a28c4e8 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -291,7 +291,7 @@ can be found in .BR strstr (3), .BR wcstok (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtol.3 b/man3/strtol.3 index a31ef87d6..53e8c7dc3 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -198,7 +198,7 @@ and then determine if an error occurred by checking whether has a nonzero value after the call. .PP According to POSIX.1, -in locales other than the "C" and "POSIX", +in locales other than "C" and "POSIX", these functions may accept other, implementation-defined numeric strings. .PP @@ -304,7 +304,7 @@ main(int argc, char *argv[]) .BR strtoimax (3), .BR strtoul (3), .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 86799c6e7..6ac494177 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -231,7 +231,7 @@ the use of the functions described in this manual page is similar. .BR strtol (3), .BR strtoumax (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index dc7762b53..4b480dbcb 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -157,7 +157,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR strcoll (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index b37ea3c97..c0bfaf0ee 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/swab.3 b/man3/swab.3 index 1b1468277..52dfb9612 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sysconf.3 b/man3/sysconf.3 index f4d88de86..53620c975 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -401,7 +401,7 @@ memory. .BR pathconf (3), .BR posixoptions (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/syslog.3 b/man3/syslog.3 index d020f5a24..80c3bfac7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/system.3 b/man3/system.3 index e1ad74b11..3258faf55 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -260,7 +260,7 @@ from a privileged program. .BR exec (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 ea3e2aa4a..dae290933 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tailq.3 b/man3/tailq.3 index d9bf4765f..73294a895 100644 --- a/man3/tailq.3 +++ b/man3/tailq.3 @@ -29,7 +29,7 @@ .\" %%%LICENSE_END .\" .\" -.TH TAILQ 3 2020-10-21 "GNU" "Linux Programmer's Manual" +.TH TAILQ 3 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME TAILQ_CONCAT, TAILQ_EMPTY, @@ -113,6 +113,7 @@ TAILQ_REMOVE .BI "void TAILQ_REMOVE(TAILQ_HEAD *" head ", struct TYPE *" elm ", TAILQ_ENTRY " NAME ");" .\" .PP .\" .BI "void TAILQ_SWAP(TAILQ_HEAD *" head1 ", TAILQ_HEAD *" head2 ", TYPE, TAILQ_ENTRY " NAME ");" +.fi .SH DESCRIPTION These macros define and operate on doubly linked tail queues. .PP @@ -439,7 +440,7 @@ main(void) .BR insque (3), .BR queue (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tan.3 b/man3/tan.3 index 970dd8249..9f3499a56 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tanh.3 b/man3/tanh.3 index fa57b3d81..1a010c3c0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetpgrp.3 b/man3/tcgetpgrp.3 index 46c793492..45846f697 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index 3d29c7181..d69752bb7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/telldir.3 b/man3/telldir.3 index daab3f49d..9779df936 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tempnam.3 b/man3/tempnam.3 index 6e5495354..dc26bc5bb 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/termios.3 b/man3/termios.3 index ee6008481..2571c7dd9 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -1107,7 +1107,7 @@ mask). .BR ioctl_tty (2), .BR setserial (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tgamma.3 b/man3/tgamma.3 index be4cfc770..1b449c268 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timegm.3 b/man3/timegm.3 index 80db49486..461e04eb5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timeradd.3 b/man3/timeradd.3 index ecf201b95..ae4ee053d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index d63ac71c9..5a2eb3697 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index 576ec576a..c8bb18e65 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toascii.3 b/man3/toascii.3 index 61398fd75..c699c7554 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toupper.3 b/man3/toupper.3 index 88679822f..829e62011 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towctrans.3 b/man3/towctrans.3 index 174a4288e..bdfccc424 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towlower.3 b/man3/towlower.3 index 072a7b9c0..04873a378 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towupper.3 b/man3/towupper.3 index 834c3c3ea..ece3c786c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/trunc.3 b/man3/trunc.3 index 8fe1438da..4f7f27b38 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tsearch.3 b/man3/tsearch.3 index 45a3ecc43..75bc574dc 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -346,7 +346,7 @@ main(void) .BR lsearch (3), .BR qsort (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyname.3 b/man3/ttyname.3 index 83118cb4e..5bab645ca 100644 --- a/man3/ttyname.3 +++ b/man3/ttyname.3 @@ -120,7 +120,7 @@ to .BR isatty (3), .BR pts (4) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index 3709494d5..3947f517c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tzset.3 b/man3/tzset.3 index 3d863b2e2..3af53103c 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -249,7 +249,7 @@ otherwise the daylight saving time version. .BR getenv (3), .BR tzfile (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ualarm.3 b/man3/ualarm.3 index b96ada0d8..c23a47d68 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ulimit.3 b/man3/ulimit.3 index e92d46bf7..3ca7d4d2d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/undocumented.3 b/man3/undocumented.3 index 0d95e70c0..c7aa8570c 100644 --- a/man3/undocumented.3 +++ b/man3/undocumented.3 @@ -176,7 +176,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ungetwc.3 b/man3/ungetwc.3 index 2d4d9a832..edcb199c7 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.09 of the Linux +This page is part of release 5.10 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 a6e30236c..83f50212b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index 9cf90d02c..68c907fc4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/updwtmp.3 b/man3/updwtmp.3 index 61d0a1300..55594642d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/uselocale.3 b/man3/uselocale.3 index 3b12735e1..ffa6b9c62 100644 --- a/man3/uselocale.3 +++ b/man3/uselocale.3 @@ -123,7 +123,7 @@ and .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/usleep.3 b/man3/usleep.3 index 626538c8f..64b6c75c4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpcpy.3 b/man3/wcpcpy.3 index f23799227..368628f5e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpncpy.3 b/man3/wcpncpy.3 index f3d199288..0f8c83141 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index 119fe2ed3..5ea2d29b5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscasecmp.3 b/man3/wcscasecmp.3 index 65655ac28..30ea8f23e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscat.3 b/man3/wcscat.3 index 78a602637..b21e3654a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcschr.3 b/man3/wcschr.3 index 05c47941a..6c84e1610 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscmp.3 b/man3/wcscmp.3 index a85bef53f..db2af1f0e 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscpy.3 b/man3/wcscpy.3 index 2b5fecea2..70e14603f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscspn.3 b/man3/wcscspn.3 index ede6e0ffa..dc879e135 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsdup.3 b/man3/wcsdup.3 index dac76a426..b80452e6d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcslen.3 b/man3/wcslen.3 index 4966cf391..17b64f472 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3 index bfb75a78b..393a8493a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncat.3 b/man3/wcsncat.3 index 35acf4ae8..f337ba277 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncmp.3 b/man3/wcsncmp.3 index 06440ffad..192d8215b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3 index 6362457f8..45bd34484 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index 3ae96e634..e667b98e2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index e6739dbb4..73ce84352 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcspbrk.3 b/man3/wcspbrk.3 index efd50dd52..bb79f7d75 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrchr.3 b/man3/wcsrchr.3 index 830a459c4..bdae4c188 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index c0b7619c9..2e1ba5381 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsspn.3 b/man3/wcsspn.3 index f46778f11..35917c507 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsstr.3 b/man3/wcsstr.3 index ad3a25ccb..f5120b0e0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstoimax.3 b/man3/wcstoimax.3 index 7cc82e217..c06982293 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstok.3 b/man3/wcstok.3 index 2f28b525b..8a7815d0a 100644 --- a/man3/wcstok.3 +++ b/man3/wcstok.3 @@ -112,7 +112,7 @@ for (token = wcstok(wcs, " \et\en", &state); .BR strtok (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 975f0afc2..2a0c28c00 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -120,7 +120,7 @@ provides a better interface to the same functionality. .BR wcsrtombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcswidth.3 b/man3/wcswidth.3 index ce86674e8..fff30247c 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctob.3 b/man3/wctob.3 index 8ef0e4066..204ad9986 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctomb.3 b/man3/wctomb.3 index be908eb50..0d4b38f14 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctrans.3 b/man3/wctrans.3 index 62817c43f..4c6dc6ea5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctype.3 b/man3/wctype.3 index b7f0e76b2..6541490b0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcwidth.3 b/man3/wcwidth.3 index 7a355b359..180a2a9c1 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemchr.3 b/man3/wmemchr.3 index 947ee3a8a..a6dd8197d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcmp.3 b/man3/wmemcmp.3 index 10d017bee..b1a79d699 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcpy.3 b/man3/wmemcpy.3 index 8605e927d..c24d5734f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemmove.3 b/man3/wmemmove.3 index 7d7fa3679..59e4e3acc 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemset.3 b/man3/wmemset.3 index 8654cd70c..b1757e2c5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 0e6ca07f7..b615d9740 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -247,7 +247,7 @@ main(int argc, char **argv) .BR fnmatch (3), .BR glob (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 06452ad81..9eac6a781 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xcrypt.3 b/man3/xcrypt.3 index 8a9de74a1..f23a7587f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xdr.3 b/man3/xdr.3 index 2138b4fbf..216ba5767 100644 --- a/man3/xdr.3 +++ b/man3/xdr.3 @@ -620,7 +620,7 @@ RFC\ 1014, Sun Microsystems, Inc., USC-ISI. .RE .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, @@ -272,7 +272,7 @@ when a domain error occurs. .SH SEE ALSO .BR j0 (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cciss.4 b/man4/cciss.4 index 00cfb4426..9e16a8afc 100644 --- a/man4/cciss.4 +++ b/man4/cciss.4 @@ -97,7 +97,6 @@ run from the Smart Array's option ROM at boot time. .SS Device nodes The device naming scheme is as follows: .PP -.nf Major numbers: .PP 104 cciss0 @@ -111,25 +110,28 @@ Major numbers: .PP Minor numbers: .PP +.EX b7 b6 b5 b4 b3 b2 b1 b0 |----+----| |----+----| | | | +-------- Partition ID (0=wholedev, 1\-15 partition) | +-------------------- Logical Volume number +.EE .PP The device naming scheme is: -.PP - /dev/cciss/c0d0 Controller 0, disk 0, whole device - /dev/cciss/c0d0p1 Controller 0, disk 0, partition 1 - /dev/cciss/c0d0p2 Controller 0, disk 0, partition 2 - /dev/cciss/c0d0p3 Controller 0, disk 0, partition 3 -.PP - /dev/cciss/c1d1 Controller 1, disk 1, whole device - /dev/cciss/c1d1p1 Controller 1, disk 1, partition 1 - /dev/cciss/c1d1p2 Controller 1, disk 1, partition 2 - /dev/cciss/c1d1p3 Controller 1, disk 1, partition 3 -.fi +.TS +li l. +/dev/cciss/c0d0 Controller 0, disk 0, whole device +/dev/cciss/c0d0p1 Controller 0, disk 0, partition 1 +/dev/cciss/c0d0p2 Controller 0, disk 0, partition 2 +/dev/cciss/c0d0p3 Controller 0, disk 0, partition 3 + +/dev/cciss/c1d1 Controller 1, disk 1, whole device +/dev/cciss/c1d1p1 Controller 1, disk 1, partition 1 +/dev/cciss/c1d1p2 Controller 1, disk 1, partition 2 +/dev/cciss/c1d1p3 Controller 1, disk 1, partition 3 +.TE .SS Files in /proc The files .I /proc/driver/cciss/cciss[0\-9]+ @@ -380,7 +382,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.09 of the Linux +This page is part of release 5.10 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 e4ccd8746..58812c976 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -675,7 +675,7 @@ It is ignored. .BR ioctl_console (2), .BR charsets (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cpuid.4 b/man4/cpuid.4 index 3d9976e60..90b489efe 100644 --- a/man4/cpuid.4 +++ b/man4/cpuid.4 @@ -100,7 +100,7 @@ Instruction Set Reference, A-M, 3-180 CPUID reference. Intel Corporation, Intel Processor Identification and the CPUID Instruction, Application note 485. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/dsp56k.4 b/man4/dsp56k.4 index 7bb99350d..3e3793d52 100644 --- a/man4/dsp56k.4 +++ b/man4/dsp56k.4 @@ -120,7 +120,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, @@ -231,7 +231,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/full.4 b/man4/full.4 index ef8932604..edfd3cfd8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/fuse.4 b/man4/fuse.4 index fa0f3399b..70a97771e 100644 --- a/man4/fuse.4 +++ b/man4/fuse.4 @@ -554,7 +554,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.09 of the Linux +This page is part of release 5.10 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/hpsa.4 b/man4/hpsa.4 index 5b7974930..a2e83e1dd 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/initrd.4 b/man4/initrd.4 index 10309ff57..e3ea1ae40 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -498,7 +498,7 @@ before Linux 4.10) in the Linux kernel source tree, the LILO documentation, the LOADLIN documentation, the SYSLINUX documentation .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/intro.4 b/man4/intro.4 index 62d16ce4d..bb0c1926b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/lirc.4 b/man4/lirc.4 index a8eedc24e..89180b76f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/loop.4 b/man4/loop.4 index 19dfd3b49..cfbde31ab 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -376,7 +376,7 @@ main(int argc, char *argv[]) .BR losetup (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, @@ -142,7 +142,7 @@ No argument is used. .BR lpcntl (8), .BR tunelp (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mem.4 b/man4/mem.4 index 1093dc1d4..59f00fc25 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mouse.4 b/man4/mouse.4 index 1988b68d3..1ff0655f2 100644 --- a/man4/mouse.4 +++ b/man4/mouse.4 @@ -189,7 +189,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/msr.4 b/man4/msr.4 index d403ad922..cad11f580 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/null.4 b/man4/null.4 index 48e95dc7d..2175e7325 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/pts.4 b/man4/pts.4 index 57abbe34b..96c525b01 100644 --- a/man4/pts.4 +++ b/man4/pts.4 @@ -74,7 +74,7 @@ filesystem, which should be mounted on .BR unlockpt (3), .BR pty (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ram.4 b/man4/ram.4 index 4aa23624e..c5c24a576 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/random.4 b/man4/random.4 index 085624994..70c5edde7 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -344,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/rtc.4 b/man4/rtc.4 index 68eccde48..4cf3c627c 100644 --- a/man4/rtc.4 +++ b/man4/rtc.4 @@ -343,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.09 of the Linux +This page is part of release 5.10 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index 26abb129a..ed039b7b7 100644 --- a/man4/sk98lin.4 +++ b/man4/sk98lin.4 @@ -398,15 +398,16 @@ The different values of this variable reflect the most meaningful combinations of port parameters. Possible values and their corresponding combination of per-port parameters: .IP -.nf -ConType | DupCap AutoNeg FlowCtrl Role Speed ---------+------------------------------------------- -\fIAuto\fP | Both On SymOrRem Auto Auto -\fI100FD\fP | Full Off None Auto 100 -\fI100HD\fP | Half Off None Auto 100 -\fI10FD\fP | Full Off None Auto 10 -\fI10HD\fP | Half Off None Auto 10 -.fi +.TS +lb lb lb lb lb lb +l l l l l l. +ConType DupCap AutoNeg FlowCtrl Role Speed +\fIAuto\fP Both On SymOrRem Auto Auto +\fI100FD\fP Full Off None Auto 100 +\fI100HD\fP Half Off None Auto 100 +\fI10FD\fP Full Off None Auto 10 +\fI10HD\fP Half Off None Auto 10 +.TE .IP Stating any other port parameter together with this .I ConType @@ -587,7 +588,7 @@ Report any bugs to linux@syskonnect.de .BR insmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/smartpqi.4 b/man4/smartpqi.4 index c7892fb71..afd6e0d25 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/tty.4 b/man4/tty.4 index c2adc4ba4..c01f013f9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ttyS.4 b/man4/ttyS.4 index 11e424cdf..9dcf1a404 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/vcs.4 b/man4/vcs.4 index e8b6d1f8d..60764dba9 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -190,7 +190,7 @@ main(void) .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/veth.4 b/man4/veth.4 index 969829f8b..c4a9381b5 100644 --- a/man4/veth.4 +++ b/man4/veth.4 @@ -106,7 +106,7 @@ NIC statistics: .BR ip\-link (8), .BR ip\-netns (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man4/wavelan.4 b/man4/wavelan.4 index f5eaec55f..20e759aa4 100644 --- a/man4/wavelan.4 +++ b/man4/wavelan.4 @@ -143,7 +143,7 @@ them by changing flags in the driver header and recompile. .BR iwpriv (8), .BR iwspy (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/acct.5 b/man5/acct.5 index 71f461f2a..f94b83d18 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/charmap.5 b/man5/charmap.5 index 930e73e95..619ddc22b 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -118,7 +118,7 @@ charmap: .BR locale (5), .BR charsets (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/core.5 b/man5/core.5 index a2224f9fd..4bdf659c7 100644 --- a/man5/core.5 +++ b/man5/core.5 @@ -700,7 +700,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR systemd\-coredump (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 4e6b16c01..057436c31 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/elf.5 b/man5/elf.5 index 91eb8226d..7695e38a3 100644 --- a/man5/elf.5 +++ b/man5/elf.5 @@ -32,7 +32,7 @@ .\" 2007-10-11, Mike Frysinger <vapier@gentoo.org>, various fixes .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH ELF 5 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH ELF 5 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME elf \- format of Executable and Linking Format (ELF) files .SH SYNOPSIS @@ -561,7 +561,6 @@ This is defined as 0xffff, the largest number can have, specifying where the actual number of program headers is assigned. .PD .RE -.IP .TP .IR e_shentsize This member holds a sections header's size in bytes. @@ -835,7 +834,7 @@ and .BR SHN_HIRESERVE . The initial entry is used in ELF extensions for .IR e_phnum , -.IR e_shnum +.IR e_shnum , and .IR e_shstrndx ; in other cases, each field in the initial entry is set to zero. @@ -2120,7 +2119,7 @@ These are used when the namespace is the default (i.e., .I n_namesz will be set to 0), or a fallback when the namespace is unknown. .RS -.TP 21 +.TP 12 .PD 0 .B NT_VERSION A version string of some sort. @@ -2129,7 +2128,6 @@ A version string of some sort. Architecture information. .PD .RE -.PP .RE .SH NOTES .\" OpenBSD @@ -2143,7 +2141,7 @@ The ELF format is an adopted standard. .PP The extensions for .IR e_phnum , -.IR e_shnum +.IR e_shnum , and .IR e_shstrndx respectively are @@ -2164,6 +2162,7 @@ look under SEE ALSO. .BR gdb (1), .BR ld (1), .BR nm (1), +.BR objcopy (1), .BR objdump (1), .BR patchelf (1), .BR readelf (1), @@ -2190,9 +2189,8 @@ Sun Microsystems, .PP AMD64 ABI Draft, .IR "System V Application Binary Interface AMD64 Architecture Processor Supplement" . -.PP .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/filesystems.5 b/man5/filesystems.5 index db3fe770f..d7183728f 100644 --- a/man5/filesystems.5 +++ b/man5/filesystems.5 @@ -23,7 +23,7 @@ .\" .\" 2007-12-14 mtk Added Reiserfs, XFS, JFS. .\" -.TH FILESYSTEMS 5 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH FILESYSTEMS 5 2020-12-21 "Linux" "Linux Programmer's Manual" .nh .SH NAME filesystems \- Linux filesystem types: ext, ext2, ext3, ext4, hpfs, iso9660, @@ -152,22 +152,22 @@ filenames can be no longer than 8 characters, followed by an optional period and 3 character extension. .TP .B ncpfs -is a network filesystem that supports the NCP protocol, used by -Novell NetWare. +is a network filesystem that supports the NCP protocol, +used by Novell NetWare. +It was was removed from the kernel in 4.17. .IP To use .BR ncpfs , you need special programs, which can be found at -.UR ftp://linux01.gwdg.de\:/pub\:/ncpfs +.UR ftp://ftp.gwdg.de\:/pub\:/linux\:/misc\:/ncpfs .UE . .TP .B nfs is the network filesystem used to access disks located on remote computers. .TP .B ntfs -replaces Microsoft Window's FAT filesystems (VFAT, FAT32). -It has reliability, performance, and space-utilization enhancements -plus features like ACLs, journaling, encryption, and so on. +is the filesystem native to Microsoft Windows NT, +supporting features like ACLs, journaling, encryption, and so on. .TP .B proc is a pseudo filesystem which is used as an interface to kernel data @@ -239,7 +239,7 @@ It was removed from the kernel in 2.1.21. .BR mkfs (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ftpusers.5 b/man5/ftpusers.5 index 4e8220849..5ed076871 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.09 of the Linux +This page is part of release 5.10 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 3ac74d7a5..f7709387a 100644 --- a/man5/gai.conf.5 +++ b/man5/gai.conf.5 @@ -101,7 +101,7 @@ precedence ::ffff:0:0/96 10 .BR getaddrinfo (3), RFC\ 3484 .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/group.5 b/man5/group.5 index 6df6d7ef7..93d1f7019 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.09 of the Linux +This page is part of release 5.10 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 c8c9b7aff..625076db6 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/hosts.5 b/man5/hosts.5 index 06acb66a6..44b9d8416 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -138,7 +138,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.09 of the Linux +This page is part of release 5.10 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 b475d3569..016e64cd5 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -172,7 +172,7 @@ the file is processed sequentially until the first matching rule is found. .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/intro.5 b/man5/intro.5 index 4a03e0950..711ab9f5f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/issue.5 b/man5/issue.5 index ba254e5b2..735d16c64 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/locale.5 b/man5/locale.5 index 080c1b2fd..c44b8d4b8 100644 --- a/man5/locale.5 +++ b/man5/locale.5 @@ -620,7 +620,7 @@ a string that identifies this locale category definition, a semicolon, and .IP * one of the -.BI LC_ * +.B LC_* identifiers. .PP The @@ -1329,7 +1329,7 @@ Monday for the locale. .BR unicode (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/motd.5 b/man5/motd.5 index 959fc8197..ca5f8e8e3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/networks.5 b/man5/networks.5 index a02d3d8db..67de8408f 100644 --- a/man5/networks.5 +++ b/man5/networks.5 @@ -78,7 +78,7 @@ The networks definition file. .BR netstat (8), .BR route (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nologin.5 b/man5/nologin.5 index fdc7e884d..21876d376 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.09 of the Linux +This page is part of release 5.10 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 5fe7c5a08..20f9af72f 100644 --- a/man5/nscd.conf.5 +++ b/man5/nscd.conf.5 @@ -17,7 +17,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH NSCD.CONF 5 2014-02-07 "GNU" "Linux Programmer's Manual" +.TH NSCD.CONF 5 2020-12-21 "GNU" "Linux Programmer's Manual" .SH NAME nscd.conf \- name service cache daemon configuration file .SH DESCRIPTION @@ -166,7 +166,7 @@ The files are .IR /etc/passwd , .IR /etc/group , .IR /etc/hosts , -.I /etc/services +.IR /etc/services , and .IR /etc/netgroup . The default is yes. @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nss.5 b/man5/nss.5 index cc4f1473b..cd4cec72a 100644 --- a/man5/nss.5 +++ b/man5/nss.5 @@ -113,7 +113,7 @@ SETENT_BATCH_READ=FALSE .SH SEE ALSO \fInsswitch.conf\fR .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 fb6be875f..f2eeb2462 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/passwd.5 b/man5/passwd.5 index ce37ec8ab..a61f2fc85 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/proc.5 b/man5/proc.5 index 6c04d4a26..5af6043e5 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -52,7 +52,7 @@ .\" to see what information could be imported from that file .\" into this file. .\" -.TH PROC 5 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH PROC 5 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME proc \- process information pseudo-filesystem .SH DESCRIPTION @@ -4354,7 +4354,7 @@ See also .I /proc/sys This directory (present since 1.3.57) contains a number of files and subdirectories corresponding to kernel variables. -These variables can be read and sometimes modified using +These variables can be read and in some cases modified using the \fI/proc\fP filesystem, and the (deprecated) .BR sysctl (2) system call. @@ -6068,7 +6068,7 @@ in the idle process. This string identifies the kernel version that is currently running. It includes the contents of .IR /proc/sys/kernel/ostype , -.I /proc/sys/kernel/osrelease +.IR /proc/sys/kernel/osrelease , and .IR /proc/sys/kernel/version . For example: @@ -6835,7 +6835,7 @@ The Linux kernel source files: and .IR Documentation/sysctl/vm.txt . .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/protocols.5 b/man5/protocols.5 index 96923de5f..4a02178de 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/repertoiremap.5 b/man5/repertoiremap.5 index 89f3746f4..5252ae37f 100644 --- a/man5/repertoiremap.5 +++ b/man5/repertoiremap.5 @@ -76,7 +76,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.09 of the Linux +This page is part of release 5.10 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 b758c748d..b64b053f5 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -380,7 +380,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/rpc.5 b/man5/rpc.5 index a16be697c..7ddc8a62b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/securetty.5 b/man5/securetty.5 index d56aaf818..b5d5d6b07 100644 --- a/man5/securetty.5 +++ b/man5/securetty.5 @@ -53,7 +53,7 @@ to restrict the terminals on which empty passwords are accepted. .BR login.defs (5), .BR pam_securetty (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/services.5 b/man5/services.5 index e2d630deb..5f0476dcb 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/shells.5 b/man5/shells.5 index c9d0a12e2..d22e73292 100644 --- a/man5/shells.5 +++ b/man5/shells.5 @@ -58,7 +58,7 @@ may contain the following paths: .BR getusershell (3), .BR pam_shells (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/slabinfo.5 b/man5/slabinfo.5 index 7c0b8d1ca..2424d52aa 100644 --- a/man5/slabinfo.5 +++ b/man5/slabinfo.5 @@ -237,7 +237,7 @@ The kernel source file and .IR tools/vm/slabinfo.c . .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/sysfs.5 b/man5/sysfs.5 index 11a5e855b..15023676f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/termcap.5 b/man5/termcap.5 index c1fb2d18a..74093ba13 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -473,7 +473,7 @@ library, if the capabilities are missing. .BR termcap (3), .BR terminfo (5) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tmpfs.5 b/man5/tmpfs.5 index 19d376e0d..c39dcddf8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ttytype.5 b/man5/ttytype.5 index 3611db984..1c206c361 100644 --- a/man5/ttytype.5 +++ b/man5/ttytype.5 @@ -71,7 +71,7 @@ vt320 ttys0 .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tzfile.5 b/man5/tzfile.5 index 8f7290dd3..48f6cad44 100644 --- a/man5/tzfile.5 +++ b/man5/tzfile.5 @@ -426,7 +426,7 @@ doi:10.17487/RFC8536 .\" 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man5/utmp.5 b/man5/utmp.5 index 9b12f5d5d..532776fe4 100644 --- a/man5/utmp.5 +++ b/man5/utmp.5 @@ -27,7 +27,7 @@ .\" Modified 1996-07-20 by Michael Haardt .\" Modified 1997-07-02 by Nicolás Lichtmaier <nick@debian.org> .\" Modified 2004-10-31 by aeb, following Gwenole Beauchesne -.TH UTMP 5 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH UTMP 5 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME utmp, wtmp \- login records .SH SYNOPSIS @@ -176,9 +176,18 @@ records may be located by .PP When .BR init (1) -finds that a process has exited, it locates its utmp -entry by \fIut_pid\fP, sets \fIut_type\fP to \fBDEAD_PROCESS\fP, and -clears \fIut_user\fP, \fIut_host\fP and \fIut_time\fP with null bytes. +finds that a process has exited, it locates its utmp entry by +.IR ut_pid , +sets +.I ut_type +to +.BR DEAD_PROCESS , +and clears +.IR ut_user , +.IR ut_host , +and +.I ut_time +with null bytes. .PP .BR xterm (1) and other terminal emulators directly create a @@ -353,7 +362,7 @@ ut.ut_tv.tv_usec = tv.tv_usec; .BR logwtmp (3), .BR updwtmp (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man6/intro.6 b/man6/intro.6 index 54f6298bc..070357b38 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.09 of the Linux +This page is part of release 5.10 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 46884c0d1..990bf0b05 100644 --- a/man7/address_families.7 +++ b/man7/address_families.7 @@ -408,7 +408,7 @@ in the Linux kernel source tree for details. .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/aio.7 b/man7/aio.7 index aa1ac4913..82df7f4be 100644 --- a/man7/aio.7 +++ b/man7/aio.7 @@ -464,7 +464,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.09 of the Linux +This page is part of release 5.10 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 00f7a8334..8097506fc 100644 --- a/man7/armscii-8.7 +++ b/man7/armscii-8.7 @@ -137,7 +137,7 @@ _ .BR charsets (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/arp.7 b/man7/arp.7 index a7fc22393..d649423a7 100644 --- a/man7/arp.7 +++ b/man7/arp.7 @@ -308,7 +308,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ascii.7 b/man7/ascii.7 index d69250a85..01e12fb64 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -200,7 +200,7 @@ Standards Institute (USASI) in 1968. .BR iso_8859\-16 (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/attributes.7 b/man7/attributes.7 index 1374b520c..19f419423 100644 --- a/man7/attributes.7 +++ b/man7/attributes.7 @@ -21,7 +21,7 @@ .\" License along with this manual; if not, see .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END -.TH ATTRIBUTES 7 2015-03-02 "Linux" "Linux Programmer's Manual" +.TH ATTRIBUTES 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME attributes \- POSIX safety concepts .SH DESCRIPTION @@ -880,9 +880,10 @@ adorned with such conditions, and none of the named conditions hold, then the function can be regarded as safe. .SH SEE ALSO -.BR pthreads (7) +.BR pthreads (7), +.BR signal-safety (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/boot.7 b/man7/boot.7 index 3cac547a4..83c17b1b9 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/bootparam.7 b/man7/bootparam.7 index 0f7fa1ada..b6ded6553 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.09 of the Linux +This page is part of release 5.10 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 fd41fc3dd..40199f296 100644 --- a/man7/bpf-helpers.7 +++ b/man7/bpf-helpers.7 @@ -34,7 +34,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .\" See git log include/uapi/linux/bpf.h in kernel tree for details. . -.\" +.\" . .\" %%%LICENSE_START(VERBATIM) . @@ -44,7 +44,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .\" preserved on all copies. . -.\" +.\" . .\" Permission is granted to copy and distribute modified versions of this . @@ -54,7 +54,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .\" permission notice identical to this one. . -.\" +.\" . .\" Since the Linux kernel and libraries are constantly changing, this . @@ -70,7 +70,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .\" professionally. . -.\" +.\" . .\" Formatted or processed versions of this manual, if unaccompanied by . @@ -78,7 +78,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .\" %%%LICENSE_END . -.\" +.\" . .\" Please do not edit this file. It was generated from the documentation . @@ -3702,7 +3702,7 @@ pointers for network processing are listed in function .\" Generated by docutils manpage writer. . .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/capabilities.7 b/man7/capabilities.7 index a52f067ef..f5e613021 100644 --- a/man7/capabilities.7 +++ b/man7/capabilities.7 @@ -1853,7 +1853,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.09 of the Linux +This page is part of release 5.10 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 4d3be25eb..658cc1bc3 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cgroups.7 b/man7/cgroups.7 index e22d0cbb4..edbf41b37 100644 --- a/man7/cgroups.7 +++ b/man7/cgroups.7 @@ -1928,7 +1928,7 @@ mount option. The kernel source file .IR Documentation/admin\-guide/cgroup\-v2.rst . .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/charsets.7 b/man7/charsets.7 index bd294a07b..29d97c2ef 100644 --- a/man7/charsets.7 +++ b/man7/charsets.7 @@ -333,7 +333,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/complex.7 b/man7/complex.7 index c97493821..5ed326c9d 100644 --- a/man7/complex.7 +++ b/man7/complex.7 @@ -80,7 +80,7 @@ main(void) .BR ctan (3), .BR ctanh (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1251.7 b/man7/cp1251.7 index 50978bbfc..64db1be7c 100644 --- a/man7/cp1251.7 +++ b/man7/cp1251.7 @@ -183,7 +183,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1252.7 b/man7/cp1252.7 index 172c8de67..59e273229 100644 --- a/man7/cp1252.7 +++ b/man7/cp1252.7 @@ -173,7 +173,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cpuset.7 b/man7/cpuset.7 index 73c544a6e..8ae8263c7 100644 --- a/man7/cpuset.7 +++ b/man7/cpuset.7 @@ -1512,7 +1512,7 @@ before Linux 4.18, and .IR Documentation/cpusets.txt before Linux 2.6.29) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/credentials.7 b/man7/credentials.7 index 6ff6fe6ba..06236e345 100644 --- a/man7/credentials.7 +++ b/man7/credentials.7 @@ -398,7 +398,7 @@ for further details. .BR user_namespaces (7), .BR sudo (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ddp.7 b/man7/ddp.7 index c8c7a9fb3..50a472f80 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/environ.7 b/man7/environ.7 index a033a14da..a8606d0f0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/epoll.7 b/man7/epoll.7 index 14e218694..789739318 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fanotify.7 b/man7/fanotify.7 index aa853ad1f..aaf973108 100644 --- a/man7/fanotify.7 +++ b/man7/fanotify.7 @@ -29,11 +29,12 @@ fanotify \- monitoring filesystem events The fanotify API provides notification and interception of filesystem events. Use cases include virus scanning and hierarchical storage management. -Currently, only a limited set of events is supported. -In particular, there is no support for create, delete, and move events. +In the original fanotify API, only a limited set of events was supported. +In particular, there was no support for create, delete, and move events. +The support for those events was added in Linux 5.1. (See .BR inotify (7) -for details of an API that does notify those events.) +for details of an API that did notify those events pre Linux 5.1.) .PP Additional capabilities compared to the .BR inotify (7) @@ -1211,7 +1212,7 @@ main(int argc, char **argv) .BR fanotify_mark (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 5951cd49c..fb3d282fc 100644 --- a/man7/feature_test_macros.7 +++ b/man7/feature_test_macros.7 @@ -50,7 +50,7 @@ itself includes .EX #include <abc.h> #define _GNU_SOURCE -#include <xys.h> +#include <xyz.h> .EE .in .PP @@ -77,7 +77,7 @@ the manual page SYNOPSIS typically includes a note of the following form .BR acct (2) manual page): .PP -.RS 8 +.RS .B #include <unistd.h> .PP .BI "int acct(const char *" filename ); @@ -87,7 +87,7 @@ manual page): Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .EE -.RS +.RE .PP .BR acct (): _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) @@ -916,7 +916,7 @@ The section "Feature Test Macros" under .PP .I /usr/include/features.h .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fifo.7 b/man7/fifo.7 index e4c06b879..9dfc904a0 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/futex.7 b/man7/futex.7 index bdf5504ab..fc42ec552 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/glob.7 b/man7/glob.7 index 64b1b39c8..2c6f4e9bf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hier.7 b/man7/hier.7 index 341c018d4..e93afe3f5 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -671,7 +671,7 @@ differently. .PP The Filesystem Hierarchy Standard .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hostname.7 b/man7/hostname.7 index de7194e46..1d9e25d8d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/icmp.7 b/man7/icmp.7 index 63fdcad35..1a9fa4215 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inode.7 b/man7/inode.7 index 0b037f81b..c9d64d6cb 100644 --- a/man7/inode.7 +++ b/man7/inode.7 @@ -479,7 +479,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inotify.7 b/man7/inotify.7 index e97a58191..f09b7f799 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -881,7 +881,7 @@ 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 .BR IN_OPEN , -.BR IN_CLOSE_NOWRITE +.BR IN_CLOSE_NOWRITE , and .BR IN_CLOSE_WRITE . .PP @@ -1119,7 +1119,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/intro.7 b/man7/intro.7 index 247543c2d..f41145e98 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, @@ -1438,7 +1438,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.09 of the Linux +This page is part of release 5.10 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 344416e37..f9db114e8 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ipv6.7 b/man7/ipv6.7 index df1374d01..a898ab8cb 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -83,7 +83,7 @@ .\" commit c4062dfc425e94290ac427a98d6b4721dd2bc91f .\" Author: Erich E. Hoover <ehoover@mines.edu> .\" -.TH IPV6 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IPV6 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME ipv6 \- Linux IPv6 protocol implementation .SH SYNOPSIS @@ -396,11 +396,11 @@ for that instead. .PP .BR SOL_IP , .BR SOL_IPV6 , -.B SOL_ICMPV6 +.BR SOL_ICMPV6 , and other -.BR SOL_ * +.B SOL_* socket options are nonportable variants of -.BR IPPROTO_ * . +.BR IPPROTO_* . See also .BR ip (7). .SH BUGS @@ -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.09 of the Linux +This page is part of release 5.10 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 ab12c4574..f6f2bf641 100644 --- a/man7/iso_8859-1.7 +++ b/man7/iso_8859-1.7 @@ -167,7 +167,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.09 of the Linux +This page is part of release 5.10 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 a87eb1cc5..77c73f0fc 100644 --- a/man7/iso_8859-10.7 +++ b/man7/iso_8859-10.7 @@ -163,7 +163,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.09 of the Linux +This page is part of release 5.10 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 8ee0c7adb..94e18a9d4 100644 --- a/man7/iso_8859-11.7 +++ b/man7/iso_8859-11.7 @@ -160,7 +160,7 @@ while TIS-620 leaves it undefined. .BR charsets (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 652195912..5c0dd7979 100644 --- a/man7/iso_8859-13.7 +++ b/man7/iso_8859-13.7 @@ -163,7 +163,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.09 of the Linux +This page is part of release 5.10 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 a7d6b1a4b..36ec58620 100644 --- a/man7/iso_8859-14.7 +++ b/man7/iso_8859-14.7 @@ -163,7 +163,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.09 of the Linux +This page is part of release 5.10 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 3b9981258..f7ee4973a 100644 --- a/man7/iso_8859-15.7 +++ b/man7/iso_8859-15.7 @@ -166,7 +166,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.09 of the Linux +This page is part of release 5.10 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 511f83a39..b0fc9d318 100644 --- a/man7/iso_8859-16.7 +++ b/man7/iso_8859-16.7 @@ -164,7 +164,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.09 of the Linux +This page is part of release 5.10 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 a7ae0b400..a7f70a3e9 100644 --- a/man7/iso_8859-2.7 +++ b/man7/iso_8859-2.7 @@ -168,7 +168,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.09 of the Linux +This page is part of release 5.10 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 459b47a39..836b653b3 100644 --- a/man7/iso_8859-3.7 +++ b/man7/iso_8859-3.7 @@ -156,7 +156,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.09 of the Linux +This page is part of release 5.10 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 70dadeb5b..2c82d9f4e 100644 --- a/man7/iso_8859-4.7 +++ b/man7/iso_8859-4.7 @@ -163,7 +163,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.09 of the Linux +This page is part of release 5.10 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 c562bb227..c6fa00308 100644 --- a/man7/iso_8859-5.7 +++ b/man7/iso_8859-5.7 @@ -168,7 +168,7 @@ T} .BR koi8\-u (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 69d3b82b0..14097394b 100644 --- a/man7/iso_8859-6.7 +++ b/man7/iso_8859-6.7 @@ -119,7 +119,7 @@ such as Urdu and Persian (Farsi). .BR charsets (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 30e6d5274..8b73504b4 100644 --- a/man7/iso_8859-7.7 +++ b/man7/iso_8859-7.7 @@ -167,7 +167,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.09 of the Linux +This page is part of release 5.10 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 856df96d4..fc72f1691 100644 --- a/man7/iso_8859-8.7 +++ b/man7/iso_8859-8.7 @@ -131,7 +131,7 @@ and Yiddish is not provided for. .BR charsets (7), .BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 7dec0b734..f415b139c 100644 --- a/man7/iso_8859-9.7 +++ b/man7/iso_8859-9.7 @@ -163,7 +163,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/kernel_lockdown.7 b/man7/kernel_lockdown.7 index d80e30e41..1e14aa609 100644 --- a/man7/kernel_lockdown.7 +++ b/man7/kernel_lockdown.7 @@ -9,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH "KERNEL_LOCKDOWN" 7 2020-11-01 Linux "Linux Programmer's Manual" +.TH KERNEL_LOCKDOWN 7 2020-11-01 Linux "Linux Programmer's Manual" .SH NAME kernel_lockdown \- kernel image access prevention feature .SH DESCRIPTION @@ -119,7 +119,7 @@ the initialization falls back to the value of the deprecated command line parameter and further to the value of CONFIG_LSM. .\" commit 000d388ed3bbed745f366ce71b2bb7c2ee70f449 .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/keyrings.7 b/man7/keyrings.7 index 3009e898e..b8b53a874 100644 --- a/man7/keyrings.7 +++ b/man7/keyrings.7 @@ -881,7 +881,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.09 of the Linux +This page is part of release 5.10 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 499520656..a1a02d086 100644 --- a/man7/koi8-r.7 +++ b/man7/koi8-r.7 @@ -186,7 +186,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.09 of the Linux +This page is part of release 5.10 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 abf50eec8..f1b3cd1b9 100644 --- a/man7/koi8-u.7 +++ b/man7/koi8-u.7 @@ -192,7 +192,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/libc.7 b/man7/libc.7 index dfccc99eb..97d23f5bf 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/locale.7 b/man7/locale.7 index 293e6d402..0e43503d5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/mailaddr.7 b/man7/mailaddr.7 index 48381af0d..d00e2b6cb 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.09 of the Linux +This page is part of release 5.10 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 a967fe93d..8eb8daff3 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -169,18 +169,19 @@ sections. Arrange a new manual page so that sections are placed in the order shown in the list. .PP -.in +4n -.nf +.RS +.TS +l l. \fBNAME\fP \fBSYNOPSIS\fP -CONFIGURATION [Normally only in Section 4] +CONFIGURATION [Normally only in Section 4] \fBDESCRIPTION\fP -OPTIONS [Normally only in Sections 1, 8] -EXIT STATUS [Normally only in Sections 1, 8] -RETURN VALUE [Normally only in Sections 2, 3] +OPTIONS [Normally only in Sections 1, 8] +EXIT STATUS [Normally only in Sections 1, 8] +RETURN VALUE [Normally only in Sections 2, 3] .\" May 07: Few current man pages have an ERROR HANDLING section,,, .\" ERROR HANDLING, -ERRORS [Typically only in Sections 2, 3] +ERRORS [Typically only in Sections 2, 3] .\" May 07: Almost no current man pages have a USAGE section,,, .\" USAGE, .\" DIAGNOSTICS, @@ -188,19 +189,19 @@ ERRORS [Typically only in Sections 2, 3] .\" SECURITY, ENVIRONMENT FILES -VERSIONS [Normally only in Sections 2, 3] -ATTRIBUTES [Normally only in Sections 2, 3] +VERSIONS [Normally only in Sections 2, 3] +ATTRIBUTES [Normally only in Sections 2, 3] CONFORMING TO NOTES BUGS EXAMPLES .\" AUTHORS sections are discouraged -AUTHORS [Discouraged] -REPORTING BUGS [Not used in man-pages] -COPYRIGHT [Not used in man-pages] +AUTHORS [Discouraged] +REPORTING BUGS [Not used in man-pages] +COPYRIGHT [Not used in man-pages] \fBSEE ALSO\fP -.fi -.in +.TE +.RE .PP .IR "Where a traditional heading would apply" ", " "please use it" ; this kind of consistency can make the information easier to understand. @@ -1020,7 +1021,7 @@ and .BR man (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/man.7 b/man7/man.7 index ed1e9b44e..7e698c6be 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -521,7 +521,7 @@ is not implemented. .BR man\-pages (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 e25727f6e..e0109bd57 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.09 of the Linux +This page is part of release 5.10 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 18432d4b0..8d9b8de1e 100644 --- a/man7/mount_namespaces.7 +++ b/man7/mount_namespaces.7 @@ -716,8 +716,9 @@ For reasons of space, "private" is abbreviated as "priv" and "unbindable" as "unbind". .TS lb2 lb2 lb2 lb2 lb1 -lb l l l l l. +lb | l l l l l. make-shared make-slave make-priv make-unbind +_ shared shared slave/priv [1] priv unbind slave slave+shared slave [2] priv unbind slave+shared slave+shared slave priv unbind @@ -764,12 +765,12 @@ and is summarized in the following table. .TS lb2 lb1 lb2 lb2 lb2 lb0 lb2 lb1 lb2 lb2 lb2 lb0 -lb lb l l l l l. +lb lb | l l l l l. source(A) shared private slave unbind _ -dest(B) shared | shared shared slave+shared invalid - nonshared | shared private slave invalid +dest(B) shared shared shared slave+shared invalid + nonshared shared private slave invalid .TE .sp 1 Note that a recursive bind of a subtree follows the same semantics @@ -808,12 +809,12 @@ and is summarized in the following table. .TS lb2 lb1 lb2 lb2 lb2 lb0 lb2 lb1 lb2 lb2 lb2 lb0 -lb lb l l l l l. +lb lb | l l l l l. source(A) shared private slave unbind _ -dest(B) shared | shared shared slave+shared invalid - nonshared | shared private slave unbindable +dest(B) shared shared shared slave+shared invalid + nonshared shared private slave unbindable .TE .sp 1 Note: moving a mount that resides under a shared mount is invalid. @@ -1138,7 +1139,7 @@ See .IR Documentation/filesystems/sharedsubtree.txt in the kernel source tree. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 a1a28330e..ed0c8ebe6 100644 --- a/man7/mq_overview.7 +++ b/man7/mq_overview.7 @@ -407,7 +407,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/namespaces.7 b/man7/namespaces.7 index 2f8bb1161..aa1375371 100644 --- a/man7/namespaces.7 +++ b/man7/namespaces.7 @@ -436,7 +436,7 @@ and .BR pam_namespace (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netdevice.7 b/man7/netdevice.7 index 8f4820bb9..b76858542 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -374,7 +374,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netlink.7 b/man7/netlink.7 index f7785b0cc..e08d712f7 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -579,7 +579,7 @@ information about libnl .PP RFC 3549 "Linux Netlink as an IP Services Protocol" .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 4d418fffb..25ec598b6 100644 --- a/man7/network_namespaces.7 +++ b/man7/network_namespaces.7 @@ -80,7 +80,7 @@ option. .BR iptables (8), .BR ovs\-vsctl (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/nptl.7 b/man7/nptl.7 index ae5f8639f..d2fe0dbfd 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/numa.7 b/man7/numa.7 index 2f435e25e..5c489d9d2 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/operator.7 b/man7/operator.7 index c542a09ce..ac3252b4b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/packet.7 b/man7/packet.7 index 55ab9a0d4..55321e5d5 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -9,7 +9,7 @@ .\" .\" $Id: packet.7,v 1.13 2000/08/14 08:03:45 ak Exp $ .\" -.TH PACKET 7 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH PACKET 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME packet \- packet interface on device level .SH SYNOPSIS @@ -405,7 +405,7 @@ equal to .IP Packet sockets implement multiple variants of the packet ring. The implementation details are described in -.IR Documentation/networking/packet_mmap.txt +.IR Documentation/networking/packet_mmap.rst in the Linux kernel source tree. .TP .BR PACKET_STATISTICS @@ -431,7 +431,7 @@ By default, this is a software generated timestamp generated when the packet is copied into the ring. This integer option selects the type of timestamp. Besides the default, it support the two hardware formats described in -.IR Documentation/networking/timestamping.txt +.IR Documentation/networking/timestamping.rst in the Linux kernel source tree. .TP .BR PACKET_TX_RING " (since Linux 2.6.31)" @@ -648,15 +648,15 @@ The include file for physical-layer protocols. .PP The Linux kernel source tree. -.IR /Documentation/networking/filter.txt +.IR Documentation/networking/filter.rst describes how to apply Berkeley Packet Filters to packet sockets. -.IR /tools/testing/selftests/net/psock_tpacket.c +.IR tools/testing/selftests/net/psock_tpacket.c contains example source code for all available versions of .BR PACKET_RX_RING and .BR PACKET_TX_RING . .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 2ed13b8d2..0ce46c166 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.09 of the Linux +This page is part of release 5.10 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 b83b301cb..dd303e6ec 100644 --- a/man7/persistent-keyring.7 +++ b/man7/persistent-keyring.7 @@ -124,7 +124,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.09 of the Linux +This page is part of release 5.10 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 2970b9fbe..1bb87c62f 100644 --- a/man7/pid_namespaces.7 +++ b/man7/pid_namespaces.7 @@ -407,7 +407,7 @@ See .BR user_namespaces (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pipe.7 b/man7/pipe.7 index 2bb70c320..1f4bd729b 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pkeys.7 b/man7/pkeys.7 index c847fc7a7..4c1da1f24 100644 --- a/man7/pkeys.7 +++ b/man7/pkeys.7 @@ -295,7 +295,7 @@ main(void) .BR pkey_mprotect (2), .BR sigaction (2) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index 70fb433a0..27adb1fee 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.09 of the Linux +This page is part of release 5.10 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 78d1b51b1..a038e6e97 100644 --- a/man7/process-keyring.7 +++ b/man7/process-keyring.7 @@ -59,7 +59,7 @@ results. .BR user\-keyring (7), .BR user\-session\-keyring (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pthreads.7 b/man7/pthreads.7 index 4f1eec643..5237f6940 100644 --- a/man7/pthreads.7 +++ b/man7/pthreads.7 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREADS 7 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH PTHREADS 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME pthreads \- POSIX threads .SH DESCRIPTION @@ -178,8 +178,10 @@ getenv() getgrent() getgrgid() getgrnam() -gethostbyaddr() [POSIX.1-2001 only (function removed in POSIX.1-2008)] -gethostbyname() [POSIX.1-2001 only (function removed in POSIX.1-2008)] +gethostbyaddr() [POSIX.1-2001 only (function removed in + POSIX.1-2008)] +gethostbyname() [POSIX.1-2001 only (function removed in + POSIX.1-2008)] gethostent() getlogin() getnetbyaddr() @@ -412,8 +414,10 @@ getgrgid() getgrgid_r() getgrnam() getgrnam_r() -gethostbyaddr() [SUSv3 only (function removed in POSIX.1-2008)] -gethostbyname() [SUSv3 only (function removed in POSIX.1-2008)] +gethostbyaddr() [POSIX.1-2001 only (function removed in + POSIX.1-2008)] +gethostbyname() [POSIX.1-2001 only (function removed in + POSIX.1-2008)] gethostent() gethostid() gethostname() @@ -442,7 +446,7 @@ getutxid() getutxline() getwc() getwchar() -getwd() [SUSv3 only (function removed in POSIX.1-2008)] +getwd() [POSIX.1-2001 only (function removed in POSIX.1-2008)] glob() iconv_close() iconv_open() @@ -952,7 +956,7 @@ Various Pthreads manual pages, for example: and .BR pthread_testcancel (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pty.7 b/man7/pty.7 index 3e68b206b..2e84da71d 100644 --- a/man7/pty.7 +++ b/man7/pty.7 @@ -177,7 +177,7 @@ have not been implemented under Linux. .BR pts (4), .BR tty (4) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/queue.7 b/man7/queue.7 index 8e04c75df..e527b9a8e 100644 --- a/man7/queue.7 +++ b/man7/queue.7 @@ -29,7 +29,7 @@ .\" %%%LICENSE_END .\" .\" -.TH QUEUE 7 2015-02-7 "GNU" "Linux Programmer's Manual" +.TH QUEUE 7 2020-11-16 "GNU" "Linux Programmer's Manual" .SH NAME queue \- implementations of linked lists and queues .SH DESCRIPTION @@ -147,7 +147,7 @@ macros first appeared in 4.4BSD. .BR tailq (3) .\" .BR tree (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/random.7 b/man7/random.7 index e2949dcea..dacbf932f 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/raw.7 b/man7/raw.7 index 88918839f..b76eeb6a6 100644 --- a/man7/raw.7 +++ b/man7/raw.7 @@ -285,7 +285,7 @@ and the .I <linux/ip.h> header file for the IP protocol. .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/regex.7 b/man7/regex.7 index ee509f9ec..569e66494 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.09 of the Linux +This page is part of release 5.10 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 1040ec49a..1d21bd403 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -623,7 +623,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index e69802090..41c614326 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -559,7 +559,7 @@ This manual page is incomplete. .BR ip (7), .BR netlink (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sched.7 b/man7/sched.7 index ba727532f..b78424371 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.09 of the Linux +This page is part of release 5.10 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 872c8daa3..81383fd14 100644 --- a/man7/sem_overview.7 +++ b/man7/sem_overview.7 @@ -158,7 +158,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.09 of the Linux +This page is part of release 5.10 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 f25ba9e44..13ab7503a 100644 --- a/man7/session-keyring.7 +++ b/man7/session-keyring.7 @@ -114,7 +114,7 @@ keyctl new_session .BR user\-session\-keyring (7), .BR pam_keyinit (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 37411e518..5803046e9 100644 --- a/man7/shm_overview.7 +++ b/man7/shm_overview.7 @@ -122,7 +122,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sigevent.7 b/man7/sigevent.7 index 0174bcec5..7b7cb6ca1 100644 --- a/man7/sigevent.7 +++ b/man7/sigevent.7 @@ -140,7 +140,7 @@ Currently used only by POSIX timers; see .BR aio (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 85071f526..91fc6c854 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 2020-06-09 "Linux" "Linux Programmer's Manual" +.TH SIGNAL-SAFETY 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME signal-safety \- async-signal-safe functions .SH DESCRIPTION @@ -285,7 +285,7 @@ Function Notes \fBwmemset\fP(3) Added in POSIX.1-2008 TC2 \fBwrite\fP(2) .TE -.sp 1 +.PP Notes: .IP * 3 POSIX.1-2001 and POSIX.1-2001 TC2 required the functions @@ -320,6 +320,14 @@ Asynchronous signal handlers that call functions which are cancellation points and nest over regions of deferred cancellation may trigger cancellation whose behavior is as if asynchronous cancellation had occurred and may cause application state to become inconsistent. +.\" +.SS errno +Fetching and setting the value of +.I errno +is async-signal-safe provided that the signal handler saves +.I errno +on entry and restores its value before returning. +.\" .SS Deviations in the GNU C library The following known deviations from the standard occur in the GNU C library: @@ -345,7 +353,7 @@ internally. .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/signal.7 b/man7/signal.7 index 8296e5ab5..ecb2a7fd0 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -1,5 +1,5 @@ .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) -.\" and Copyright (c) 2002, 2006 by Michael Kerrisk <mtk.manpages@gmail.com> +.\" and Copyright (c) 2002, 2006, 2020 by Michael Kerrisk <mtk.manpages@gmail.com> .\" and Copyright (c) 2008 Linux Foundation, written by Michael Kerrisk .\" <mtk.manpages@gmail.com> .\" @@ -42,7 +42,7 @@ .\" Added section on stop/cont signals interrupting syscalls. .\" 2008-10-05, mtk: various additions .\" -.TH SIGNAL 7 2020-08-13 "Linux" "Linux Programmer's Manual" +.TH SIGNAL 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME signal \- overview of signals .SH DESCRIPTION @@ -105,7 +105,7 @@ the dispositions of ignored signals are left unchanged. .SS Sending a signal The following system calls and library functions allow the caller to send a signal: -.TP 16 +.TP .BR raise (3) Sends a signal to the calling thread. .TP @@ -114,6 +114,9 @@ Sends a signal to a specified process, to all members of a specified process group, or to all processes on the system. .TP +.BR pidfd_send_signal (2) +Sends a signal to a process identified by a PID file descriptor. +.TP .BR killpg (3) Sends a signal to all of the members of a specified process group. .TP @@ -132,13 +135,14 @@ Sends a real-time signal with accompanying data to a specified process. The following system calls suspend execution of the calling thread until a signal is caught (or an unhandled signal terminates the process): -.TP 16 +.TP .BR pause (2) Suspends execution until any signal is caught. .TP .BR sigsuspend (2) Temporarily changes the signal mask (see below) and suspends execution until one of the unmasked signals is caught. +.\" .SS Synchronously accepting a signal Rather than asynchronously catching a signal via a signal handler, it is possible to synchronously accept the signal, that is, @@ -248,6 +252,117 @@ A child created via initially has an empty pending signal set; the pending signal set is preserved across an .BR execve (2). +.\" +.SS Execution of signal handlers +Whenever there is a transition from kernel-mode to user-mode execution +(e.g., on return from a system call or scheduling of a thread onto the CPU), +the kernel checks whether there is a pending unblocked signal +for which the process has established a signal handler. +If there is such a pending signal, the following steps occur: +.IP 1. 3 +The kernel performs the necessary preparatory steps for execution of +the signal handler: +.RS +.IP a) 3 +The signal is removed from the set of pending signals. +.IP b) +If the signal handler was installed by a call to +.BR sigaction (2) +that specified the +.BR SA_ONSTACK +flag and the thread has defined an alternate signal stack (using +.BR sigaltstack (2)), +then that stack is installed. +.IP c) +Various pieces of signal-related context are saved +into a special frame that is created on the stack. +The saved information includes: +.RS +.IP + 2 +the program counter register +(i.e., the address of the next instruction in the main program that +should be executed when the signal handler returns); +.IP + +architecture-specific register state required for resuming the +interrupted program; +.IP + +the thread's current signal mask; +.IP + +the thread's alternate signal stack settings. +.RE +.IP +(If the signal handler was installed using the +.BR sigaction (2) +.B SA_SIGINFO +flag, then the above information is accessible via the +.I ucontext_t +object that is pointed to by the third argument of the signal handler.) +.IP d) +Any signals specified in +.I act\->sa_mask +when registering the handler with +.BR sigprocmask (2) +are added to the thread's signal mask. +The signal being delivered is also +added to the signal mask, unless +.B SA_NODEFER +was specified when registering the handler. +These signals are thus blocked while the handler executes. +.RE +.IP 2. +The kernel constructs a frame for the signal handler on the stack. +The kernel sets the program counter for the thread to point to the first +instruction of the signal handler function, +and configures the return address for that function to point to a piece +of user-space code known as the signal trampoline (described in +.BR sigreturn (2)). +.IP 3. +The kernel passes control back to user-space, where execution +commences at the start of the signal handler function. +.IP 4. +When the signal handler returns, control passes to the signal trampoline code. +.IP 5. +The signal trampoline calls +.BR sigreturn (2), +a system call that uses the information in the stack frame created in step 1 +to restore the thread to its state before the signal handler was +called. +The thread's signal mask and alternate signal stack settings +are restored as part of this procedure. +Upon completion of the call to +.BR sigreturn (2), +the kernel transfers control back to user space, +and the thread recommences execution at the point where it was +interrupted by the signal handler. +.PP +Note that if the signal handler does not return +(e.g., control is transferred out of the handler using +.BR siglongjmp (3), +or the handler executes a new program with +.BR execve (2)), +then the final step is not performed. +In particular, in such scenarios it is the programmer's responsibility +to restore the state of the signal mask (using +.BR sigprocmask (2)), +if it is desired to unblock the signals that were blocked on entry +to the signal handler. +(Note that +.BR siglongjmp (3) +may or may not restore the signal mask, depending on the +.I savesigs +value that was specified in the corresponding call to +.BR sigsetjmp (3).) +.PP +From the kernel's point of view, +execution of the signal handler code is exactly the same as the execution +of any other user-space code. +That is to say, the kernel does not record any special state information +indicating that the thread is currently excuting inside a signal handler. +All necessary state information is maintained in user-space registers +and the user-space stack. +The depth to which nested signal handlers may be invoked is thus +limited only by the user-space stack (and sensible software design!). +.\" .SS Standard signals Linux supports the standard signals listed below. The second column of the table indicates which standard (if any) @@ -900,6 +1015,7 @@ because of how the CPU reports the forbidden operation to the kernel. .BR sigvec (3), .BR sigwait (3), .BR strsignal (3), +.BR swapcontext (3), .BR sysv_signal (3), .BR core (5), .BR proc (5), @@ -907,7 +1023,7 @@ because of how the CPU reports the forbidden operation to the kernel. .BR pthreads (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 218ad1892..67bc9c99b 100644 --- a/man7/sock_diag.7 +++ b/man7/sock_diag.7 @@ -840,7 +840,7 @@ main(void) .BR netlink (7), .BR tcp (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/socket.7 b/man7/socket.7 index 76108f9b8..e13e94310 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -489,7 +489,8 @@ Expects an integer flag. .in +4n .EX int cpu = 1; -setsockopt(fd, SOL_SOCKET, SO_INCOMING_CPU, &cpu, sizeof(cpu)); +setsockopt(fd, SOL_SOCKET, SO_INCOMING_CPU, &cpu, + sizeof(cpu)); .EE .in .IP @@ -521,7 +522,7 @@ This provides optimal NUMA behavior and keeps CPU caches hot. .TP .BR SO_INCOMING_NAPI_ID " (gettable since Linux 4.12)" .\" getsockopt 6d4339028b350efbf87c61e6d9e113e5373545c9 -Returns a system level unique ID called NAPI ID that is associated +Returns a system-level unique ID called NAPI ID that is associated with a RX queue on which the last packet associated with that socket is received. .IP @@ -1256,7 +1257,7 @@ program is designed to always set this option. .BR unix (7), .BR tcpdump (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/spufs.7 b/man7/spufs.7 index 8e67a779a..23dd7857d 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 2020-06-09 Linux "Linux Programmer's Manual" +.TH SPUFS 7 2020-12-21 Linux "Linux Programmer's Manual" .SH NAME spufs \- SPU filesystem .SH DESCRIPTION @@ -550,7 +550,7 @@ If no message has been written to these mailboxes, then contents of these files is undefined. The .IR mbox_stat , -.I ibox_stat +.IR ibox_stat , and .I wbox_stat files contain the available message count. @@ -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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/standards.7 b/man7/standards.7 index 31b7de6ea..06637eedc 100644 --- a/man7/standards.7 +++ b/man7/standards.7 @@ -120,6 +120,14 @@ Available online at .B C11 This revision of the C language standard was ratified by ISO in 2011 .RI ( "ISO/IEC 9899:2011" ). +.IP +.B LFS +The Large File Summit specification, completed in 1996. +This specification defined mechanisms that allowed 32-bit systems +to support the use of large files (i.e., 64-bit file offsets). +See +.UR https://www.opengroup.org\:/platform\:/lfs.html +.UE . .TP .B POSIX.1-1988 This was the first POSIX standard, @@ -191,7 +199,7 @@ This standard appeared in 1997. Systems conforming to this standard can be branded .IR "UNIX 98" . See also -.UR http://www.UNIX\-systems.org\:/version2/ +.UR http://www.unix.org\:/version2/ .UE .) .TP .B POSIX.1-2001, SUSv3 @@ -201,10 +209,8 @@ conducted under the auspices of the Austin Group .UR http://www.opengroup.org\:/austin/ .UE . The standard is available online at -.UR http://www.unix\-systems.org\:/version3/ -.UE , -and the interfaces that it describes are also available in the Linux -manual pages package under sections 1p and 3p (e.g., "man 3p open"). +.UR http://www.unix.org\:/version3/ +.UE . .IP The standard defines two levels of conformance: .IR "POSIX conformance" , @@ -249,6 +255,9 @@ and TC2 in 2004. .B POSIX.1-2008, SUSv4 Work on the next revision of POSIX.1/SUS was completed and ratified in 2008. +The standard is available online at +.UR http://www.unix.org\:/version4/ +.UE . .IP The changes in this revision are not as large as those that occurred for POSIX.1-2001/SUSv3, @@ -296,6 +305,11 @@ Technical Corrigenda 1 and 2 applied. .B SUSv4 2018 edition This is equivalent to POSIX.1-2017, with the addition of the XCurses specification. +.PP +The interfaces documented in POSIX.1/SUS are available as +manual pages under sections 0p (header files), 1p (commands), +and 3p (functions); +thus one can write "man 3p open". .SH SEE ALSO .BR getconf (1), .BR confstr (3), @@ -307,7 +321,7 @@ the XCurses specification. .BR posixoptions (7), .BR system_data_types (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/suffixes.7 b/man7/suffixes.7 index c746a3c98..01b5d18b3 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -281,7 +281,7 @@ This list is not exhaustive. .BR file (1), .BR make (1) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/symlink.7 b/man7/symlink.7 index 1062d057e..c56d69bcf 100644 --- a/man7/symlink.7 +++ b/man7/symlink.7 @@ -582,7 +582,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index 6726bff21..3d5dc5990 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -24,7 +24,7 @@ .\" %%%LICENSE_END .\" .\" -.TH SYSTEM_DATA_TYPES 7 2020-09-13 "Linux" "Linux Programmer's Manual" +.TH SYSTEM_DATA_TYPES 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME system_data_types \- overview of system data types .SH DESCRIPTION @@ -1638,7 +1638,7 @@ family of functions is expanded by the macros .BR SCNuPTR, .BR SCNoPTR, -.B SCNxPTR +.BR SCNxPTR , and .B SCNXPTR (defined in @@ -1678,7 +1678,7 @@ The function must declare an object of type which is used by the macros .BR va_start (3), .BR va_arg (3), -.BR va_copy (3) +.BR va_copy (3), and .BR va_end (3) to traverse the list of arguments. @@ -1862,7 +1862,7 @@ main (void) .BR feature_test_macros (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sysvipc.7 b/man7/sysvipc.7 index 4ed4ffc39..893da1cf7 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/tcp.7 b/man7/tcp.7 index e28d088f4..221b20627 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-06-09 "Linux" "Linux Programmer's Manual" +.TH TCP 7 2020-12-21 "Linux" "Linux Programmer's Manual" .SH NAME tcp \- TCP protocol .SH SYNOPSIS @@ -830,12 +830,11 @@ The maximum number of times a SYN/ACK segment for a passive TCP connection will be retransmitted. This number should not be higher than 255. .TP -.IR tcp_syncookies " (Boolean; since Linux 2.2)" +.IR tcp_syncookies " (integer; default: 1; since Linux 2.2)" .\" Since 2.1.43 Enable TCP syncookies. The kernel must be compiled with .BR CONFIG_SYN_COOKIES . -Send out syncookies when the syn backlog queue of a socket overflows. The syncookies feature attempts to protect a socket from a SYN flood attack. This should be used as a last resort, if at all. @@ -849,6 +848,18 @@ For recommended alternatives see .IR tcp_synack_retries , and .IR tcp_abort_on_overflow . +Set to one of the following values: +.RS +.IP 0 3 +Disable TCP syncookies. +.IP 1 +Send out syncookies when the syn backlog queue of a socket overflows. +.IP 2 +(since Linux 3.12) +.\" commit 5ad37d5deee1ff7150a2d0602370101de158ad86 +Send out syncookies unconditionally. +This can be useful for network testing. +.RE .TP .IR tcp_timestamps " (integer; default: 1; since Linux 2.2)" .\" Since 2.1.36 @@ -1393,7 +1404,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/termio.7 b/man7/termio.7 index d5601e903..cf10860a9 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.09 of the Linux +This page is part of release 5.10 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 36ceb0b2d..2fb295b8f 100644 --- a/man7/thread-keyring.7 +++ b/man7/thread-keyring.7 @@ -54,7 +54,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/time.7 b/man7/time.7 index 3cc923cf3..c4a04efc9 100644 --- a/man7/time.7 +++ b/man7/time.7 @@ -235,7 +235,7 @@ in .BR time_namespaces (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 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 d1a435635..3cde8845c 100644 --- a/man7/time_namespaces.7 +++ b/man7/time_namespaces.7 @@ -367,7 +367,7 @@ CLOCK_BOOTTIME : 76633.544 (21h 19m 23s) .BR namespaces (7), .BR time (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udp.7 b/man7/udp.7 index 6d2f3e310..9fd76d761 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udplite.7 b/man7/udplite.7 index 7ca8ca752..92ccbea8a 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unicode.7 b/man7/unicode.7 index 8fd848fc6..5f1b83990 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/units.7 b/man7/units.7 index af0f8ede0..543bcb6ed 100644 --- a/man7/units.7 +++ b/man7/units.7 @@ -127,7 +127,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unix.7 b/man7/unix.7 index 3e5eace28..f1bc7f9ef 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -1195,7 +1195,7 @@ see .BR socket (7), .BR udp (7) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/uri.7 b/man7/uri.7 index 5c2ef5c41..75b433913 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.09 of the Linux +This page is part of release 5.10 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 e23400817..b096f1f16 100644 --- a/man7/user-keyring.7 +++ b/man7/user-keyring.7 @@ -85,7 +85,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.09 of the Linux +This page is part of release 5.10 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 e6f0878ee..5e4d3e51c 100644 --- a/man7/user-session-keyring.7 +++ b/man7/user-session-keyring.7 @@ -96,7 +96,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.09 of the Linux +This page is part of release 5.10 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 42dd77401..5a3715c22 100644 --- a/man7/user_namespaces.7 +++ b/man7/user_namespaces.7 @@ -1386,7 +1386,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.09 of the Linux +This page is part of release 5.10 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 479d1ba5f..b72d68df1 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.09 of the Linux +This page is part of release 5.10 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 b2cfbe161..a0ba0683d 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vdso.7 b/man7/vdso.7 index 8a28ff53c..55048de71 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vsock.7 b/man7/vsock.7 index 18bab315c..6e65adea4 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/x25.7 b/man7/x25.7 index d06df5df2..06f4e22c1 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -125,7 +125,7 @@ The URL is .UR ftp://ftp.pspt.fi\:/pub\:/ham\:/linux\:/ax25\:/x25doc.tgz .UE . .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man7/xattr.7 b/man7/xattr.7 index 30ba552a8..812a547b5 100644 --- a/man7/xattr.7 +++ b/man7/xattr.7 @@ -198,7 +198,7 @@ This page was formerly named .BR capabilities (7), .BR selinux (8) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8 index 27707bb1d..cc2c5d7fd 100644 --- a/man8/iconvconfig.8 +++ b/man8/iconvconfig.8 @@ -100,7 +100,7 @@ Usual system gconv module configuration cache. .BR iconv (1), .BR iconv (3) .SH COLOPHON -This page is part of release 5.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/intro.8 b/man8/intro.8 index c1baed830..c0ed73d1b 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.09 of the Linux +This page is part of release 5.10 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 bbfdc3542..322ff33b1 100644 --- a/man8/ld.so.8 +++ b/man8/ld.so.8 @@ -831,7 +831,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/ldconfig.8 b/man8/ldconfig.8 index 64edd1dff..2e83ba141 100644 --- a/man8/ldconfig.8 +++ b/man8/ldconfig.8 @@ -216,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/nscd.8 b/man8/nscd.8 index 7b51cde74..fe2261292 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/sln.8 b/man8/sln.8 index 693561b32..6be55cf90 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/tzselect.8 b/man8/tzselect.8 index 631c19ef4..0ea425ad5 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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zdump.8 b/man8/zdump.8 index 517b3eb1e..1856782b1 100644 --- a/man8/zdump.8 +++ b/man8/zdump.8 @@ -231,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.09 of the Linux +This page is part of release 5.10 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zic.8 b/man8/zic.8 index 61c72af76..03c801df4 100644 --- a/man8/zic.8 +++ b/man8/zic.8 @@ -786,7 +786,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.09 of the Linux +This page is part of release 5.10 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 0ce5cfad8..00310f91b 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-11-01 +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-12-21 diff --git a/proj.man-pages.pages b/proj.man-pages.pages index b94f19b6d..85db47ca5 100644 --- a/proj.man-pages.pages +++ b/proj.man-pages.pages @@ -169,6 +169,7 @@ man2/subpage_prot.2 man2/s390_pci_mmio_read.2 man2/timer_gettime.2 man2/getresuid32.2 +man2/faccessat2.2 man2/fsync.2 man2/iopl.2 man2/semop.2 @@ -569,9 +570,11 @@ man3/sinhl.3 man3/scalblnf.3 man3/coshf.3 man3/setnetgrent.3 +man3/CIRCLEQ_HEAD_INITIALIZER.3 man3/siglongjmp.3 man3/isless.3 man3/clnt_sperrno.3 +man3/CIRCLEQ_PREV.3 man3/j0l.3 man3/aio_suspend.3 man3/l64a.3 @@ -690,6 +693,7 @@ man3/pthread_kill_other_threads_np.3 man3/rand.3 man3/getservent_r.3 man3/CMSG_SPACE.3 +man3/CIRCLEQ_FOREACH_REVERSE.3 man3/pthread_mutexattr_setrobust.3 man3/mq_send.3 man3/setbuffer.3 @@ -710,6 +714,7 @@ man3/xdrrec_skiprecord.3 man3/clnt_perror.3 man3/mbsnrtowcs.3 man3/isupper_l.3 +man3/CIRCLEQ_FIRST.3 man3/STAILQ_INIT.3 man3/xdr_reference.3 man3/wctrans.3 @@ -726,12 +731,14 @@ man3/setlocale.3 man3/opendir.3 man3/be64toh.3 man3/isprint.3 +man3/CIRCLEQ_LOOP_NEXT.3 man3/dlopen.3 man3/malloc_hook.3 man3/isprint_l.3 man3/ntohl.3 man3/getw.3 man3/aiocb.3 +man3/CIRCLEQ_LOOP_PREV.3 man3/y0f.3 man3/imaxdiv.3 man3/ceil.3 @@ -1124,6 +1131,7 @@ man3/envz_merge.3 man3/argz_next.3 man3/__freadable.3 man3/strcspn.3 +man3/CIRCLEQ_FOREACH.3 man3/be32toh.3 man3/pthread_yield.3 man3/cuserid.3 @@ -1227,6 +1235,7 @@ man3/CPU_ZERO_S.3 man3/lgammaf.3 man3/gnu_dev_major.3 man3/dirfd.3 +man3/CIRCLEQ_LAST.3 man3/bsd_signal.3 man3/powl.3 man3/fdim.3 @@ -1707,6 +1716,7 @@ man3/getservent.3 man3/sqrtf.3 man3/getgrent.3 man3/svc_destroy.3 +man3/CIRCLEQ_NEXT.3 man3/rtnetlink.3 man3/wcrtomb.3 man3/llrint.3 @@ -1986,6 +1996,7 @@ man3/ungetc.3 man3/gethostbyaddr.3 man3/pthread_kill.3 man3/wcsncmp.3 +man3/pthread_attr_getsigmask_np.3 man3/sem_open.3 man3/inet_pton.3 man3/svc_getreq.3 @@ -2069,6 +2080,7 @@ man3/getutent_r.3 man3/isgreaterequal.3 man3/floor.3 man3/svc_getcaller.3 +man3/CIRCLEQ_EMPTY.3 man3/setjmp.3 man3/regfree.3 man3/dprintf.3 diff --git a/scripts/check_unbalanced_macros.sh b/scripts/check_unbalanced_macros.sh new file mode 100755 index 000000000..cd547e120 --- /dev/null +++ b/scripts/check_unbalanced_macros.sh @@ -0,0 +1,68 @@ +#!/bin/bash +# +# check_unbalanced_macros.sh +# +# Dec 2007, Michael Kerrisk +# +# Look for unbalanced pairs of macros in man page source files, with +# $1 and $2 specifying the macro pair. These arguments should +# _not_ include the leading dot (.) in the macro. +# As output, the program prints the line numbers containing each macro, +# and if an unbalanced macro is detected, the string "UNBALANCED!" +# is printed. +# +# Example usage: +# +# sh check_unbalanced_macros.sh nf fi */*.[1-8] +# sh check_unbalanced_macros.sh RS RE */*.[1-8] +# sh check_unbalanced_macros.sh EX EE */*.[1-8] +# +###################################################################### +# +# (C) Copyright 2020, Michael Kerrisk +# This program is free software; 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. +# +# This program 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 +# (http://www.gnu.org/licenses/gpl-2.0.html). +# + +if test $# -lt 4; then + echo "Usage: $0 opener closer pages..." + exit 1 +fi + +opener="$1" +closer="$2" +shift 2 + +for f in $@; do + if egrep "^\.($opener|$closer)" $f > /dev/null; then + echo "================== $f" + + nl -ba $f | + awk 'BEGIN { level = 0 } + + $2 == "'".$opener"'" { level++ } + + $2 == "'".$opener"'" || $2 == "'".$closer"'" { + printf "%s %s %d", $1, $2, level + if (level == 0) + print " UNBALANCED!" + else + print "" + } + + $2 == "'".$closer"'" { level-- } + + END { + if (level != 0) + print "UNBALANCED!" + }' + fi +done diff --git a/scripts/modified_pages.sh b/scripts/modified_pages.sh new file mode 100755 index 000000000..f6c4a6cea --- /dev/null +++ b/scripts/modified_pages.sh @@ -0,0 +1,34 @@ +#!/bin/bash + +## SPDX-License-Identifier: GPL-2.0-only +######################################################################## +## +## (C) Copyright 2020, Alejandro Colomar +## This program is free software; you can redistribute it and/or +## modify it under the terms of the GNU General Public License +## as published by the Free Software Foundation; version 2. +## +## This program 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 +## (http://www.gnu.org/licenses/gpl-2.0.html). +## +######################################################################## +## +## The output of this script is a +## list of all files with changes staged for commit +## (basename only if the files are within "man?/"), +## separated by ", ". +## Usage: +## git commit -m "$(./scripts/modified_pages.sh): Short message here" +## + + +git status \ +|sed "/Changes not staged for commit:/q" \ +|grep -E "^\s*(modified|deleted|new file):" \ +|sed "s/^.*:\s*/, /" \ +|sed "s%man[1-9]/%%" \ +|tr -d '\n' \ +|sed "s/^, //" |