diff options
| author | Dr. Tobias Quathamer <toddy@debian.org> | 2020-08-22 16:39:01 +0200 |
|---|---|---|
| committer | Dr. Tobias Quathamer <toddy@debian.org> | 2020-08-22 16:39:01 +0200 |
| commit | 2b10524de3cc00c706e2472f01356cde7de45e9e (patch) | |
| tree | 27b703a8fd1578d7206b44ec6ae7d122e6ac3b93 | |
| parent | 88ecfe9f207b5ac0e0483340a34153b84c23c731 (diff) | |
New upstream version 5.08
1074 files changed, 4049 insertions, 3124 deletions
@@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.07 ==================== +==================== Changes in man-pages-5.08 ==================== -Released: 2020-06-09, Munich +Released: 2020-08-13, Munich Contributors @@ -10,807 +10,329 @@ 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: -Achilles Gaikwad <agaikwad@redhat.com> -Adhemerval Zanella <adhemerval.zanella@linaro.org> +Alejandro Colomar <colomar.6.4.3@gmail.com> Aleksa Sarai <cyphar@cyphar.com> -Alexander Monakov <amonakov@ispras.ru> -Alexander Morozov <alexandermv@gmail.com> -Alexopo Seid <alexopo.ceid@gmail.com> -Amir Goldstein <amir73il@gmail.com> -Andi Kleen <andi@firstfloor.org> -Andrea Galbusera <gizero@gmail.com> -Arnd Bergmann <arnd@arndb.de> -Branden Robinson <g.branden.robinson@gmail.com> -Brian Geffon <bgeffon@google.com> +Alyssa Ross <hi@alyssa.is> +Andrew Price <anprice@redhat.com> +Andy Lutomirski <luto@kernel.org> +Arkadiusz Drabczyk <arkadiusz@drabczyk.org> +Benjamin Peterson <benjamin@python.org> +Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Bruno Haible <bruno@clisp.org> -Chris Lamb <lamby@debian.org> -Christian Brauner <christian.brauner@ubuntu.com> -Dave Hansen <dave.hansen@linux.intel.com> +Carlos O'Donell <carlos@redhat.com> +Catalin Marinas <catalin.marinas@arm.com> +Dan Kenigsberg <danken@redhat.com> Dave Martin <Dave.Martin@arm.com> -David Adam <zanchey@ucc.gu.uwa.edu.au> -Devin J. Pohly <djpohly@gmail.com> -Dmitry V. Levin <ldv@altlinux.org> -Eric Hopper <hopper@omnifarious.org> -Eric Sandeen <sandeen@redhat.com> -Eugene Syromyatnikov <evgsyr@gmail.com> -Fabien Siron <fabien.siron@epita.fr> +Diogo Miguel Ferreira Rodrigues <dmfrodrigues2000@gmail.com> Florian Weimer <fweimer@redhat.com> -Gary Perkins <glperkins@lit.edu> +G. Branden Robinson <g.branden.robinson@gmail.com> Geoff Clare <gwc@opengroup.org> -Goldwyn Rodrigues <rgoldwyn@suse.com> -Heiko Carstens <heiko.carstens@de.ibm.com> -Heinrich Schuchardt <xypron.glpk@gmx.de> Helge Kreutzmann <debian@helgefjell.de> -Ian Rogers <irogers@google.com> -Idan Katz <idanski1@gmail.com> Jakub Wilk <jwilk@jwilk.net> -Jan Kara <jack@suse.cz> -Jan Moskyto Matejka <mq@ucw.cz> -Jason Etherton <jason@ethertonltd.co.uk> -Jeff Moyer <jmoyer@redhat.com> -John Marshall <John.W.Marshall@glasgow.ac.uk> -Jonny Grant <jg@jguk.org> -Joseph C. Sible <josephcsible@gmail.com> -Jürgen Sauermann <mail@juergen-sauermann.de> -Kai Mäkisara <kai.makisara@kolumbus.fi> -Keno Fischer <keno@juliacomputing.com> -Kirill A. Shutemov <kirill@shutemov.name> -Kirill Smelkov <kirr@nexedi.com> -Kir Kolyshkin <kolyshkin@gmail.com> -Léo Stefanesco <leo.lveb@gmail.com> -Li Xinhai <lixinhai.lxh@gmail.com> -Lokesh Gidra <lokeshgidra@google.com> -Lukas Czerner <lczerner@redhat.com> -Manfred Spraul <manfred@colorfullife.com> -Marco Curreli <marcocurreli@tiscali.it> -Marcus Gelderie <redmnic@gmail.com> -Martin Doucha <mdoucha@suse.cz> -Matthew Bobrowski <mbobrowski@mbobrowski.org> +Jeff Layton <jlayton@kernel.org> +John Scott <jscott@posteo.net> +Kumar Kartikeya Dwivedi <memxor@gmail.com> Michael Kerrisk <mtk.manpages@gmail.com> -Michal Hocko <mhocko@suse.com> -Nikola Forró <nforro@redhat.com> -Olivier Gayot <olivier.gayot@sigexec.com> -Ondrej Slamecka <ondrej@slamecka.cz> -Paul Eggert <eggert@cs.ucla.edu> -Peter Schiffer <pschiffe@redhat.com> -Peter Wu <peter@lekensteyn.nl> -Petr Vorel <pvorel@suse.cz> -Piotr Caban <piotr@codeweavers.com> -Ricardo Castano <ricardo.castano.salinas@gmail.com> -Richard Cochran <richardcochran@gmail.com> -Richard Palethorpe <rpalethorpe@suse.com> -Russell King <rmk+kernel@armlinux.org.uk> -Stefan Puiu <stefan.puiu@gmail.com> -Thierry Lelegard <thierry.lelegard@canal-plus.fr> +Mike Frysinger <vapier@gentoo.org> +Oleksandr Kravchuk <open.source@oleksandr-kravchuk.com> +Philip Adams <mail@philipadams.org> +Rich Felker <dalias@libc.org> +Saikiran Madugula <hummerbliss@gmail.com> +Stephen Hemminger <stephen@networkplumber.org> +Sven Hoexter <sven@stormbind.net> +Thomas Bartelsmeier <t.bartelsmeier@gmail.com> Thomas Piekarski <t.piekarski@deloquencia.de> -Tobias Stoeckmann <tobias@stoeckmann.org> -Urs Thuermann <urs@isnogud.escape.de> -Vincent Lefèvre <vincent-srcware@vinc17.net> -Vlad <cvazir@gmail.com> -vrafaeli@msn.com -walter harms <wharms@bfs.de> -Will Deacon <will@kernel.org> -Yang Shi <yang.shi@linux.alibaba.com> -YunQiang Su <syq@debian.org> +victorm007@yahoo.com Apologies if I missed anyone! -New and rewritten pages ------------------------ - -ioctl_fslabel.2 - Eric Sandeen - New page documenting filesystem get/set label ioctl(2) operations - - -Removed pages -------------- - -ioctl_list.2 - Michael Kerrisk [Heinrich Schuchardt, Eugene Syromyatnikov] - This page was first added more than 20 years ago. Since - that time it has seen hardly any update, and is by now - very much out of date, as reported by Heinrich Schuchardt - and confirmed by Eugene Syromyatnikov. - - As Heinrich says: - - Man-pages like netdevices.7 or ioctl_fat.2 are what is - needed to help a user who does not want to read through the - kernel code. - - If ioctl_list.2 has not been reasonably maintained since - Linux 1.3.27 and hence is not a reliable source of - information, shouldn't it be dropped? - - My answer is, yes (but let's move a little info into ioctl(2)). - - Newly documented interfaces in existing pages --------------------------------------------- -adjtimex.2 - Arnd Bergmann [Richard Cochran, Michael Kerrisk] - Document clock_adjtime(2) - -clock_getres.2 - Richard Cochran [Michael Kerrisk] - Explain dynamic clocks - -clone.2 - Christian Brauner, Michael Kerrisk - Document the clone3() CLONE_INTO_CGROUP flag - -mremap.2 - Brian Geffon, Michael Kerrisk [Lokesh Gidra] - Document MREMAP_DONTUNMAP - -open.2 - Joseph C. Sible [Michael Kerrisk] - Document fs.protected_fifos and fs.protected_regular - prctl.2 Dave Martin - Add PR_SPEC_INDIRECT_BRANCH for SPECULATION_CTRL prctls - Dave Martin - Add PR_SPEC_DISABLE_NOEXEC for SPECULATION_CTRL prctls - Dave Martin - Add PR_PAC_RESET_KEYS (arm64) - -ptrace.2 - Joseph C. Sible - Document PTRACE_SET_SYSCALL + Add SVE prctls (arm64) + Add documentation for the the PR_SVE_SET_VL and PR_SVE_GET_VL + prctls added in Linux 4.15 for arm64. + Dave Martin [Catalin Marinas] + Add tagged address ABI control prctls (arm64) + Add documentation for the the PR_SET_TAGGED_ADDR_CTRL and + PR_GET_TAGGED_ADDR_CTRL prctls added in Linux 5.4 for arm64. -proc.5 +setns.2 Michael Kerrisk - Document /proc/sys/fs/protected_regular + Document the use of PID file descriptors with setns() + Starting with Linux 5.8, setns() can take a PID file descriptor as + an argument, and move the caller into or more of the namespaces of + the thread referred to by that descriptor. + +capabilities.7 Michael Kerrisk - Document /proc/sys/fs/protected_fifos + Document CAP_BPF Michael Kerrisk - Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nr - -New and changed links ---------------------- + Add CAP_PERFMON -clock_adjtime.2 - Arnd Bergmann - New link to adjtimex(2) +symlink.7 + Aleksa Sarai + Document magic links more completely Global changes -------------- -Various pages +A few pages Michael Kerrisk - Retitle EXAMPLE section heading to EXAMPLES - EXAMPLES appears to be the wider majority usage across various - projects' manual pages, and is also what is used in the POSIX - manual pages. + Use \` rather than ` + \` produces better rendering in PDF. Various pages - Michael Kerrisk - Correct bogus POSIX.1 standards names - POSIX.1-2003 ==> POSIX.1-2001 TC1 - POSIX.1-2004 ==> POSIX.1-2001 TC2 - POSIX.1-2013 ==> POSIX.1-2008 TC1 - POSIX.1-2016 ==> POSIX.1-2008 TC2 + Michael Kerrisk [Geoff Clare] + Use "\(ti" instead of "~" + A naked tilde ("~") renders poorly in PDF. Instead use "\(ti", + which renders better in a PDF, and produces the same glyph + when rendering on a terminal. Various pages - Michael Kerrisk - Add section number in page cross-reference. + Michael Kerrisk [Geoff Clare] + Use "\(ha" rather than "^" in code + This renders better in PDF. Various pages - Kir Kolyshkin - Add missing commas in SEE ALSO + Mike Frysinger + Drop "coding: UTF-8" header + This header is used inconsistently -- man pages are UTF-8 encoded + but not setting this marker. It's only respected by the man-db + package, and seems a bit anachronistic at this point when UTF-8 + is the standard default nowadays. Various pages - Michael Kerrisk - Remove AVAILABILITY section heading - In the few pages where this heading (which is "nonstandard" within - man-pages) is used, it always immediately follows CONFORMING TO - and generally contains information related to standards. Remove - the section heading, thus incorporating AVAILABILITY into - CONFORMING TO. + Mike Frysinger + Trim leading blank comment line + Very few pages do this, so trim them. Various pages - Michael Kerrisk - Remove section number in page self-references + Mike Frysinger + Use standard .\" comment style + The \" comment produces blank lines. Use the .\" that the vast + majority of the codebase uses instead. Various pages - Michael Kerrisk - Put SEE ALSO entries in alphabetical order + Mike Frysinger [G. Branden Robinson] + Various pages: Drop t comment header + Historically, a comment of the following form at the top of a + manual page was used to indicate too man(1) that the use of tbl(1) + was required in order to process tables: -Various pages - Michael Kerrisk - Place SH sections in standard order - Fix various pages that deviated from the norm described in - man-pages(7). + '\" t -Various "aio" pages - Michael Kerrisk [Andi Kleen, Jeff Moyer] - Change uses of aio_context_t to io_context_t + However, at least as far back as 2001 (according to Branden), + man-db's man(1) automatically uses tbl(1) as needed, rendering + this comment unnecessary. And indeed many existing pages in + man-pages that have tables don't have this comment at the top of + the file. So, drop the comment from those files where it is + present. Changes to individual pages --------------------------- -bpf.2 - Peter Wu - Update enum bpf_map_type and enum bpf_prog_type - Richard Palethorpe - Change note on unprivileged access - The kernel now allows calls to bpf() without CAP_SYS_ADMIN - under some circumstances. - -clone.2 - Michael Kerrisk - Add kernel version numbers for clone_args fields - Michael Kerrisk - Combine separate NOTES sections - -close.2 - Michael Kerrisk [Lukas Czerner, Peter Schiffer, Thierry Lelegard] - Note behavior when close() happens in a parallel thread - If one thread is blocked in an I/O system call on a file descriptor - that is closed in another thread, then the blocking system call - does not return immediately, but rather when the I/O operation - completes. This surprises some people, but is longstanding - behavior. - -connect.2 - Stefan Puiu - Can return EACCES because of SELinux - -execve.2 - Michael Kerrisk [Eric Hopper] - Changes to the "dumpable" flag may change ownership of /proc/PID files - Michael Kerrisk - Improve/correct discussion of changes to dumpable flag during execve(2) - The details were not quite accurate. Defer to prctl(2) - for the more complete picture. - Nikola Forró - Clarify signal sent to the process on late failure - Michael Kerrisk - SEE ALSO: add capabilities(7) - -fanotify_init.2 - Amir Goldstein [Matthew Bobrowski] - Move out of place entry FAN_REPORT_FID - It was inserted in the middle of the FAN_CLASS_ multi flags bit - and broke the multi flag documentation. - Michael Kerrisk [Alexander Morozov, Amir Goldstein, Jan Kara] - Remove mention of FAN_Q_OVERFLOW as an input value in 'mask' - See https://bugzilla.kernel.org/show_bug.cgi?id=198569. - Amir Goldstein [Jan Kara, Matthew Bobrowski] - Clarification about FAN_EVENT_ON_CHILD and new events - Amir Goldstein [Jan Kara, Matthew Bobrowski] - Clarification about FAN_MARK_MOUNT and FAN_REPORT_FID - -getdents.2 - Petr Vorel [Michael Kerrisk] - Mention glibc support for getdents64() - Support was added in glibc 2.30. - Chris Lamb - Correct linux_dirent definition in example code - It is "unsigned long" earlier up in the file - -gettid.2 - Michael Kerrisk [Joseph C. Sible] - Document header file and feature test macro requirements for gettid() - -ioctl.2 - Michael Kerrisk - SEE ALSO: add ioctl_fslabel(2) - Michael Kerrisk - Remove mentions of ioctl_list(2) - Michael Kerrisk - Move subsection on "ioctl structure" from ioctl_list(2) to ioctl(2) - -io_setup.2 +ioctl_tty.2 Michael Kerrisk - Tweak description of /proc/sys/fs/aio-max-nr - -mbind.2 - Li Xinhai [Michael Kerrisk] - Remove note about MPOL_MF_STRICT been ignored + Fix a confusing wording error in description of TIOCSPTLCK -mmap.2 - Michael Kerrisk [Heinrich Schuchardt] - Don't mark MAP_ANON as deprecated +iopl.2 + Thomas Piekarski [victorm007@yahoo.com] + Updating description of permissions and disabling interrupts + Update description of permissions for port-mapped I/O set + per-thread and not per-process. Mention that iopl() can not + disable interrupts since Linux 5.5 anymore and is in general + deprecated and only provided for legacy X servers. -move_pages.2 - Yang Shi [Michal Hocko] - Returning positive value is a new error case + See https://bugzilla.kernel.org/show_bug.cgi?id=205317 -mremap.2 - Michael Kerrisk - Remove mention of "Segmentation fault" in EFAULT text - "Segmentation fault" (SIGSEGV) is not exactly the same thing as - EFAULT. - Michael Kerrisk - Reorder some paragraphs in NOTES - Michael Kerrisk - Move a paragraph from DESCRIPTION to NOTES +keyctl.2 + Oleksandr Kravchuk + Declare auth_key to fix a compilation error in example code -msgctl.2 - Michael Kerrisk - Correct description of 'msg_ctime' field - Verified by inspecting kernel source. +lseek.2 + Andrew Price + List gfs2 support for SEEK_HOLE/SEEK_DATA -nfsservctl.2 +mount.2 Michael Kerrisk - SEE ALSO: add nfsd(7) + ERRORS: add EINVAL for bind mount of mount namespace inode open.2 Michael Kerrisk - Some '*at' APIs have functionality that isn't in conventional APIs - Note that another reason to use the *at() APIs is to access - 'flags' functionality that is not available in the corresponding - conventional APIs. - Michael Kerrisk - Add a few more APIs to list in "Rationale for openat()..." - There have been a few more dirfd APIs added in recent times. - Michael Kerrisk - Explain ways in which a 'directory file descriptor' can be obtained - Michael Kerrisk - Add openat2() to list of APIs that take a 'dirfd' argument - -openat2.2 - Michael Kerrisk [Aleksa Sarai] - Various changes after feedback from Aleksa Sarai - -poll.2 - Michael Kerrisk - Add license to example program - -prctl.2 - Dave Martin - Sort prctls into alphabetical order - Dave Martin - Clarify that prctl can apply to threads - The current synopsis for prctl(2) misleadingly claims that prctl - operates on a process. Rather, some (in fact, most) prctls operate - Dave Martin [Dave Hansen] - Document removal of Intel MPX prctls - Dave Martin - Fix mis-description of thread ID values in procfs - Dave Martin - Work around bogus constant "maxsig" in PR_SET_PDEATHSIG - Michael Kerrisk - Add reference to proc(5) for /proc/self/task/[tid]/comm - Dave Martin [Michael Kerrisk] - Add health warning - Dave Martin - Clarify the unsupported hardware case of EINVAL - -rename.2 - Michael Kerrisk - SEE ALSO: add rename(1) - -s390_runtime_instr.2 - Heiko Carstens [Eugene Syromyatnikov, Michael Kerrisk] - Document signum argument behavior change - Document that the signum argument is ignored in newer kernels, but - that user space should pass a valid real-time signal number for - backwards compatibility. - -semctl.2 - Michael Kerrisk [Manfred Spraul] - Correct description of sem_ctime field + Say a bit more about what happens when 'mode' is wrongly omitted -semget.2 +pidfd_open.2 Michael Kerrisk - Add license to example program - -shmctl.2 + Add the setns(2) use case for PID file descriptors Michael Kerrisk - Correct 'shm_ctime' description + Close the pidfd in EXAMPLE + Close the PID file descriptor in the example program, to hint to + the reader that like every other kind of file descriptor, a PID FD + should be closed. -shmop.2 - Michael Kerrisk - Add license to example programs - -statfs.2 - Michael Kerrisk [David Adam] - Add SMB2 constant to filesystem types list - -syscall.2 - Dave Martin [Will Deacon] - arm64: Fix syscall number register size - Dave Martin [Russell King] - arm: Use real register names for arm/OABI - -sysfs.2 - Michael Kerrisk - SEE ALSO: add proc(5) and sysfs(5) - -utimensat.2 - Goldwyn Rodrigues - Immutable flag returns EPERM - Linux kernel commit 337684a1746f "fs: return EPERM on immutable - inode" changed the return value of the utimensat(2) from -EACCES - to -EPERM in case of an immutable flag. - -wait4.2 - Michael Kerrisk - Update wait3() feature test macro requirements for changes in glibc 2.26 - -cexp2.3 - Michael Kerrisk - Still not present in glibc 2.31 - -cmsg.3 - Michael Kerrisk - CONFORMING TO: note which CMSG_* APIs are in current and upcoming POSIX - -dirfd.3 +prctl.2 Michael Kerrisk - SEE ALSO: add openat(2) + The parent death signal is cleared on some credential changes + See kernel/cred.c::commit_creds() in the Linux 5.6 source code. -dlsym.3 - Alexander Monakov - Extend discussion of NULL symbol values - Avoid implying that use of IFUNC is the only way to produce a - symbol with NULL value. Give more scenarios how a symbol may get - NULL value, but explain that in those scenarios dlsym() will fail - with Glibc's ld.so due to an implementation inconsistency. +seccomp.2 + Andy Lutomirski + Improve x32 and nr truncation notes -err.3 - Michael Kerrisk - EXAMPLES: use EXIT_FAILURE rather than 1 as exit status +send.2 +recv.2 + Alyssa Ross + Add msg_iovlen POSIX note + msg_iovlen is incorrectly typed (according to POSIX) in addition + to msg_controllen, but unlike msg_controllen, this wasn't + mentioned for msg_iovlen. -expm1.3 +setns.2 Michael Kerrisk - The expm1() bogus underflow floating-point exception has been fixed - See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6778 + EXAMPLE: use O_CLOEXEC when opening namespace file descriptor Michael Kerrisk - The bogus invalid floating-point exception bug has been fixed - https://www.sourceware.org/bugzilla/show_bug.cgi?id=6814. + It is possible to setns() to the caller's current PID namespace + The page currently incorrectly says that 'fd' must refer to + a descendant PID namespace. However, 'fd' can also refer to + the caller's current PID namespace. Verified by experiment, + and also comments in kernel/pid_namespace.c (Linux 5.8-rc1). -fdim.3 - Michael Kerrisk - BUGS: these functions did not set errno on some architectures - https://www.sourceware.org/bugzilla/show_bug.cgi?id=6796 +sync.2 + Jeff Layton + syncfs() now returns errors if writeback fails + A patch has been merged for v5.8 that changes how syncfs() reports + errors. Change the sync() manpage accordingly. -ftw.3 +syscalls.2 Michael Kerrisk - glibc eventually fixed a regression in FTW_SLN behavior - For details, see: - https://bugzilla.redhat.com/show_bug.cgi?id=1422736 - http://austingroupbugs.net/view.php?id=1121 - https://bugzilla.redhat.com/show_bug.cgi?id=1422736 - -getauxval.3 - YunQiang Su - MIPS, AT_BASE_PLATFORM passes ISA level + Add faccessat2(), added in Linux 5.8 -getdtablesize.3 +sysctl.2 Michael Kerrisk - Remove redundant statement that getdtablesize() is a library function + glibc removed support for sysctl() starting in version 2.32 -gethostbyname.3 - Michael Kerrisk [Helge Kreutzmann] - -malloc.3 +atoi.3 + Arkadiusz Drabczyk + Explain disadvantages of atoi() Michael Kerrisk - Add 'reallocarray' in NAME + Relocate BUGS section Michael Kerrisk - Add VERSIONS section noting when reallocarray() was added to glibc + Add NOTES section explaining 0 return value on error + And note that this is not specified by POSIX. -newlocale.3 - Michael Kerrisk [Piotr Caban] - Fix a valgrind issue in example program - See https://bugzilla.kernel.org/show_bug.cgi?id=202977. +fread.3 + Arkadiusz Drabczyk + Add example + Arkadiusz Drabczyk + Explain that file position is moved after calling fread()/fwrite() + Corresponding manpage on FreeBSD already contains that + information. -nextafter.3 - Michael Kerrisk - Since glibc 2.23, these functions do set errno - See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799. - -posix_spawn.3 - Olivier Gayot [Adhemerval Zanella] - Clarify by using name of steps rather than syscalls - Olivier Gayot [Adhemerval Zanella] - Document implementation using clone() since glibc 2.24 - Olivier Gayot [Adhemerval Zanella] - Document POSIX_SPAWN_USEVFORK - Added a few lines about POSIX_SPAWN_USEVFORK so that it appears - clearly that since glibc 2.24, the flag has no effect. - Olivier Gayot [Adhemerval Zanella] - Document the POSIX_SPAWN_SETSID attribute - -pow.3 +getpt.3 +posix_openpt.3 +pts.4 Michael Kerrisk - BUGS: pow() performance problem for some (rare) inputs has been fixed - See https://sourceware.org/bugzilla/show_bug.cgi?id=13932 - Michael Kerrisk - Several bugs in glibc's pow() implementation were fixed in glibc 2.16 - See https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866. - Michael Kerrisk - Add a subheading to mark off historical bugs that are now fixed - -printf.3 - Tobias Stoeckmann - Prevent signed integer overflow in example + Use the term "pseudoterminal multiplexor device" for /dev/ptmx + Let's use some consistent terminology for this device. -ptsname.3 +posix_memalign.3 Bruno Haible - Fix description of failure behaviour of ptsname_r() - -random.3 - John Marshall - Change "RAND_MAX" tp "2^31-1" - -scalb.3 - Michael Kerrisk - These functions now correctly set errno for the EDOM and ERANGE cases - See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 - and https://www.sourceware.org/bugzilla/show_bug.cgi?id=6804 - -scalbln.3 - Michael Kerrisk - These functions now correctly set errno for the ERANGE case - See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 - -scanf.3 - Michael Kerrisk [Jürgen Sauermann] - Clarify that 'x' specifier allows a 0x/0X prefix in input string + Clarify how to free the result of posix_memalign -sem_getvalue.3 - Michael Kerrisk [Andrea Galbusera] - Note that glibc's sem_getvalue() doesn't return EINVAL errors - See https://bugzilla.kernel.org/show_bug.cgi?id=204273 +pthread_rwlockattr_setkind_np.3 + Carlos O'Donell [Kumar Kartikeya Dwivedi] + Clarify a PTHREAD_RWLOCK_PREFER_WRITER_NP detail -setlogmask.3 - Michael Kerrisk - Note that LOG_UPTO() is included in the next POSIX release - -shm_open.3 - Michael Kerrisk - Add license to example programs - -sincos.3 - Michael Kerrisk - The glibc implementation does now give EDOM for a domain error - See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467 +queue.3 + Alejandro Colomar + Remove wrong code from example + Alejandro Colomar + Comment out text for functions not in glibc (related: 6559169cac) -stdarg.3 +pts.4 Michael Kerrisk - SEE ALSO: add vprintf(3), vscanf(3), vsyslog(3) + Remove NOTES on BSD pseudoterminals + This information is already covered better in pty(7). No need to + mention it again here. -strcmp.3 - Michael Kerrisk - Add license to example programs - -strftime.3 - Urs Thuermann - ISO week number can be 52, add example - -y0.3 - Michael Kerrisk - These functions now correctly diagnose a pole error - https://sourceware.org/bugzilla/show_bug.cgi?id=6807 - Michael Kerrisk - errno is now correctly set to ERANGE on underflow - https://www.sourceware.org/bugzilla/show_bug.cgi?id=6808 - -loop.4 - Michael Kerrisk [Vlad] - 'lo_flags' is nowadays "r/w" - See https://bugzilla.kernel.org/show_bug.cgi?id=203417 - -veth.4 - Devin J. Pohly - Add a more direct example - iproute2 allows you to specify the netns for either side of a veth - interface at creation time. Add an example of this to veth(4) so - it doesn't sound like you have to move the interfaces in a - separate step. - -core.5 - Michael Kerrisk [Jonny Grant] - Mention 'sysctl -w' as a way of changing core_pattern setting - Michael Kerrisk [Jonny Grant] - Note that not dumping core of an unreadable binary is a security measure - Michael Kerrisk [Jonny Grant] - Explain that core_pattern %e is process/thread 'comm' value - The 'comm' value is typically the same as the (possibly - truncated) executable name, but may be something different. - -filesystems.5 - Michael Kerrisk - SEE ALSO: add sysfs(5) and xfs(5) - -locale.5 - Michael Kerrisk [Helge Kreutzmann] - Improve description of 'first_weekday' +hosts.5 + Thomas Bartelsmeier + Clarify capability for IPv6 outside of examples + Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279 proc.5 - Michael Kerrisk - Note kernel version for /proc/PID/smaps VmFlags "wf" flag - Michael Kerrisk - Add "um" and "uw" to VmFlags in /proc/[pid]/smaps - Added in kernel commit 16ba6f811dfe44bc14f7946a4b257b85476fc16e. - Text taken from comments in include/linux/mm.h. - Michael Kerrisk - Add "mp" to VmFlags in /proc/[pid]/smaps - Added in kernel commit 4aae7e436fa51faf4bf5d11b175aea82cfe8224a. - Michael Kerrisk - Note kernel version that removed /proc/PID/smaps VmFlags "nl" flag - Kernel commit 1da4b35b001481df99a6dcab12d5d39a876f7056 - Ian Rogers - Add "wf" to VmFlags in /proc/[pid]/smaps - Michael Kerrisk - Note kernel version for /proc/PID/smaps VmFlags "dd" flag - Kernel commit ec8e41aec13005fed0dbee002fb8c99b4e001d50 - Michael Kerrisk - Add "sf" to VmFlags in /proc/[pid]/smaps - Added in kernel commit b6fb293f2497a9841d94f6b57bd2bb2cd222da43 - Text from comment in include/uapi/asm-generic/mman.h. - Michael Kerrisk [Kirill A. Shutemov] - Remove "mp" under VmFlags in /proc/[pid]/smaps - Michael Kerrisk [Eric Hopper] - Alert the reader that UID/GID changes can reset the "dumpable" attribute - Keno Fischer - Fix an outdated note about map_files - The restriction to CAP_SYS_ADMIN was removed from map_files in 2015. + Jakub Wilk + Use "pwd -P" for printing cwd + "/bin/pwd" happens to work with the GNU coreutils implementation, + which has -P as the default, contrary to POSIX requirements. + + Use "pwd -P" instead, which is shorter, easier to type, and should + work everywhere. + Arkadiusz Drabczyk + Inform that comm in /proc/pid/{stat,status} might also be truncated + pgrep for example searches for a process name in /proc/pid/status + +resolv.conf.5 Michael Kerrisk [Helge Kreutzmann] - Better explanation of some /proc/ide fields - Michael Kerrisk - TASK_COMM_LEN limit includes the terminating '\0' - Clarify this detail in the discussion of /proc/[pid]/comm. - Michael Kerrisk - Add a detail to /proc/[pid]/comm - Note the connection to the "%e" specifier in - /proc/sys/kernel/core_pattern. + Clarify that ip6-bytestring was removed in 2.25 -securetty.5 - Michael Kerrisk [Helge Kreutzmann] - Improve wording of .SH one-line description - -tzfile.5 - Michael Kerrisk - Sync to 2020a tzdb release - From https://www.iana.org/time-zones, version 2020a. +capabilities.7 + Dan Kenigsberg + Clarify that CAP_SYS_NICE relates to *lowering* the nice value + Saikiran Madugula + CAP_SYS_RESOURCE: add two more items for POSIX message queues + CAP_SYS_RESOURCE also allows overriding /proc/sys/fs/mqueue/msg_max + and /proc/sys/fs/mqueue/msgsize_max. + Michael Kerrisk [Dan Kenigsberg] + Clarify wording around increasing process nice value Michael Kerrisk - Explain UT abbreviation - -ascii.7 - Michael Kerrisk [Helge Kreutzmann] - SEE ALSO: fix sort order in entries - -bpf-helpers.7 - Michael Kerrisk - Resync against kernel 5.7 + SEE ALSO: add getpcaps(8) cgroups.7 - Marcus Gelderie - Mention cgroup.sane_behavior file - The cgroup.sane_behavior file returns the hard-coded value "0" and - is kept for legacy purposes. Mention this in the man-page. - Michael Kerrisk - Note the existence of the clone3() CLONE_INTO_CGROUP flag - -credentials.7 - Michael Kerrisk - Alert reader that UID/GID changes can affect process capabilities - Michael Kerrisk - Changes to process UIDs/GIDs can effect the "dumpable" attribute - Michael Kerrisk - Add a list of the APIs that change a process's credentials - -fanotify.7 - Amir Goldstein [Jan Kara, Matthew Bobrowski] - Fix fanotify_fid.c example - Michael Kerrisk - Wrap some long lines in example program - -fanotify.7 -fanotify_mark.2 - Amir Goldstein [Matthew Bobrowski] - Clarify FAN_ONDIR in output mask - FAN_ONDIR was an input only flag before introducing - FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can - also be in output mask. - -hier.7 - Thomas Piekarski [Gary Perkins] - Updating from FHS 2.3 to 3.0 - See https://bugzilla.kernel.org/show_bug.cgi?id=206693 - -inotify.7 - Michael Kerrisk [Jason Etherton] - Add missing #include in example program +cpuset.7 + Sven Hoexter + Update kernel cgroup documentation references + cgroups-v1/v2 documentation got moved to the "admin-guide" subfolder + and converted from .txt files to .rst ip.7 - Michael Kerrisk [Martin Doucha] - Note a few more valid 'protocol' values - See https://bugzilla.kernel.org/show_bug.cgi?id=204981 - Michael Kerrisk - SEE ALSO: add netdevice(7) + Michael Kerrisk [Stephen Hemminger] + Remove mention of ipfw(4) which was in long obsolete ipchains project man-pages.7 Michael Kerrisk - Rename EXAMPLE to EXAMPLES - Michael Kerrisk - Describe COPYRIGHT section - man-pages doesn't use COPYRIGHT sections in manual pages, but - various projects do. Make some recommendations about placement - of the section. - Michael Kerrisk - Add REPORTING BUGS section - man-pages doesn't have a REPORTING BUGS section in manual pages, - but many other projects do. Make some recommendations about - placement of that section. - Michael Kerrisk - Mention AUTHORS in summary section list - Although man-pages doesn't use AUTHORS sections, many projects do - use an AUTHORS section in their manual pages, so mention it in - man-pages to suggest some guidance on the position at which - to place that section. - -mount_namespaces.7 - Michael Kerrisk - SEE ALSO: add mount(8), umount(8) - -namespaces.7 - Michael Kerrisk - Document /proc/sys/user/max_time_namespaces - -netlink.7 - Michael Kerrisk [Idan Katz] - Update path for NETLINK_CONNECTOR docs in kernel source tree - Michael Kerrisk [Fabien Siron] - Note that NETLINK_SOCK_DIAG is preferred over NETLINK_INET_DIAG + Add some notes on generating optimal glyphs + Getting nice renderings of ^ ` and ~ requires special + steps in the page source. -pid_namespaces.7 +pty.7 Michael Kerrisk - Note that /proc/sys/kernel/ns_last_pid is virtualized per PID NS + Explicitly mention CONFIG_LEGACY_PTYS + Explicitly mention CONFIG_LEGACY_PTYS, and note that it is disabled + by default since Linux 2.6.30. Michael Kerrisk - Correct capability requirements for write to /proc/sys/kernel/ns_last_pid - CAP_SYS_ADMIN is needed in the user NS that owns the PID NS. - -rtnetlink.7 - Jan Moskyto Matejka [Michael Kerrisk] - Add missing RTA_* attributes - Used Bird's source code, kernel source code, iproute2 source code - and iproute2 manpages to find meanings of these new attributes. + Relocate a paragraph to NOTES standards.7 - Michael Kerrisk [Geoff Clare] - Add some more standards - Add: SUSv4 2016 edition, POSIX.1-2017, and SUSv4 2018 edition Michael Kerrisk - Remove mention of bogus "POSIX" names - The terms POSIX.1-{2003,2004,2013,2016} were inventions of - my imagination, as confirmed by consulting Geoff Clare of - The Open Group. Remove these names. + Add an entry for POSIX.1-1988 + Michael Kerrisk [Geoff Clare] + Correct various details in the explanation of XPG/POSIX/SUS -symlink.7 +ld.so.8 + Florian Weimer [Michael Kerrisk] + List more places in which dynamic string tokens are expanded + This happens for more than just DT_RPATH/DT_RUNPATH. + Arkadiusz Drabczyk + Explain that empty entry in LD_LIBRARY_PATH means cwd + +zic.8 Michael Kerrisk - Describe differences in the treatment of symlinks in the dirname - Describe differences in the treatment of symlinks in the dirname - part of pathname. - -tcp.7 - Michael Kerrisk [vrafaeli@msn.com] - Update info on tcp_syn_retries default value - See https://bugzilla.kernel.org/show_bug.cgi?id=202885. - -user_namespaces.7 - Michael Kerrisk [Léo Stefanesco] - Clarify that "system time" means "calendar time" - -xattr.7 - Achilles Gaikwad - Add attr(1) as relevant page to SEE ALSO - -ldconfig.8 - Florian Weimer - Mention new default for --format in glibc 2.32 - -zdump.8 - Michael Kerrisk [Marco Curreli, Paul Eggert] - Update to latest upstream tz release - Look under "Latest version", which is 2020a. + Sync to 2020a tzdb release + From https://www.iana.org/time-zones, version 2020a. diff --git a/Changes.old b/Changes.old index 8f58543dd..0e67fe3c8 100644 --- a/Changes.old +++ b/Changes.old @@ -41677,7 +41677,7 @@ core.5 locale.5 Marko Myllynen Adjust LC_IDENTIFICATION / abbreviation - Tiny tweak to locale.5 based on the on ISO/IEC TR 14652: + Tiny tweak to locale.5 based on ISO/IEC TR 14652: http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf Marko Myllynen @@ -51061,3 +51061,809 @@ unix.7 vsock.7 Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi] Add VMADDR_CID_LOCAL description + + +==================== Changes in man-pages-5.07 ==================== + +Released: 2020-06-09, 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: + +Achilles Gaikwad <agaikwad@redhat.com> +Adhemerval Zanella <adhemerval.zanella@linaro.org> +Aleksa Sarai <cyphar@cyphar.com> +Alexander Monakov <amonakov@ispras.ru> +Alexander Morozov <alexandermv@gmail.com> +Alexopo Seid <alexopo.ceid@gmail.com> +Amir Goldstein <amir73il@gmail.com> +Andi Kleen <andi@firstfloor.org> +Andrea Galbusera <gizero@gmail.com> +Arnd Bergmann <arnd@arndb.de> +Branden Robinson <g.branden.robinson@gmail.com> +Brian Geffon <bgeffon@google.com> +Bruno Haible <bruno@clisp.org> +Chris Lamb <lamby@debian.org> +Christian Brauner <christian.brauner@ubuntu.com> +Dave Hansen <dave.hansen@linux.intel.com> +Dave Martin <Dave.Martin@arm.com> +David Adam <zanchey@ucc.gu.uwa.edu.au> +Devin J. Pohly <djpohly@gmail.com> +Dmitry V. Levin <ldv@altlinux.org> +Eric Hopper <hopper@omnifarious.org> +Eric Sandeen <sandeen@redhat.com> +Eugene Syromyatnikov <evgsyr@gmail.com> +Fabien Siron <fabien.siron@epita.fr> +Florian Weimer <fweimer@redhat.com> +Gary Perkins <glperkins@lit.edu> +Geoff Clare <gwc@opengroup.org> +Goldwyn Rodrigues <rgoldwyn@suse.com> +Heiko Carstens <heiko.carstens@de.ibm.com> +Heinrich Schuchardt <xypron.glpk@gmx.de> +Helge Kreutzmann <debian@helgefjell.de> +Ian Rogers <irogers@google.com> +Idan Katz <idanski1@gmail.com> +Jakub Wilk <jwilk@jwilk.net> +Jan Kara <jack@suse.cz> +Jan Moskyto Matejka <mq@ucw.cz> +Jason Etherton <jason@ethertonltd.co.uk> +Jeff Moyer <jmoyer@redhat.com> +John Marshall <John.W.Marshall@glasgow.ac.uk> +Jonny Grant <jg@jguk.org> +Joseph C. Sible <josephcsible@gmail.com> +Jürgen Sauermann <mail@juergen-sauermann.de> +Kai Mäkisara <kai.makisara@kolumbus.fi> +Keno Fischer <keno@juliacomputing.com> +Kirill A. Shutemov <kirill@shutemov.name> +Kirill Smelkov <kirr@nexedi.com> +Kir Kolyshkin <kolyshkin@gmail.com> +Léo Stefanesco <leo.lveb@gmail.com> +Li Xinhai <lixinhai.lxh@gmail.com> +Lokesh Gidra <lokeshgidra@google.com> +Lukas Czerner <lczerner@redhat.com> +Manfred Spraul <manfred@colorfullife.com> +Marco Curreli <marcocurreli@tiscali.it> +Marcus Gelderie <redmnic@gmail.com> +Martin Doucha <mdoucha@suse.cz> +Matthew Bobrowski <mbobrowski@mbobrowski.org> +Michael Kerrisk <mtk.manpages@gmail.com> +Michal Hocko <mhocko@suse.com> +Nikola Forró <nforro@redhat.com> +Olivier Gayot <olivier.gayot@sigexec.com> +Ondrej Slamecka <ondrej@slamecka.cz> +Paul Eggert <eggert@cs.ucla.edu> +Peter Schiffer <pschiffe@redhat.com> +Peter Wu <peter@lekensteyn.nl> +Petr Vorel <pvorel@suse.cz> +Piotr Caban <piotr@codeweavers.com> +Ricardo Castano <ricardo.castano.salinas@gmail.com> +Richard Cochran <richardcochran@gmail.com> +Richard Palethorpe <rpalethorpe@suse.com> +Russell King <rmk+kernel@armlinux.org.uk> +Stefan Puiu <stefan.puiu@gmail.com> +Thierry Lelegard <thierry.lelegard@canal-plus.fr> +Thomas Piekarski <t.piekarski@deloquencia.de> +Tobias Stoeckmann <tobias@stoeckmann.org> +Urs Thuermann <urs@isnogud.escape.de> +Vincent Lefèvre <vincent-srcware@vinc17.net> +Vlad <cvazir@gmail.com> +vrafaeli@msn.com +walter harms <wharms@bfs.de> +Will Deacon <will@kernel.org> +Yang Shi <yang.shi@linux.alibaba.com> +YunQiang Su <syq@debian.org> + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +ioctl_fslabel.2 + Eric Sandeen + New page documenting filesystem get/set label ioctl(2) operations + + +Removed pages +------------- + +ioctl_list.2 + Michael Kerrisk [Heinrich Schuchardt, Eugene Syromyatnikov] + This page was first added more than 20 years ago. Since + that time it has seen hardly any update, and is by now + very much out of date, as reported by Heinrich Schuchardt + and confirmed by Eugene Syromyatnikov. + + As Heinrich says: + + Man-pages like netdevices.7 or ioctl_fat.2 are what is + needed to help a user who does not want to read through the + kernel code. + + If ioctl_list.2 has not been reasonably maintained since + Linux 1.3.27 and hence is not a reliable source of + information, shouldn't it be dropped? + + My answer is, yes (but let's move a little info into ioctl(2)). + + +Newly documented interfaces in existing pages +--------------------------------------------- + +adjtimex.2 + Arnd Bergmann [Richard Cochran, Michael Kerrisk] + Document clock_adjtime(2) + +clock_getres.2 + Richard Cochran [Michael Kerrisk] + Explain dynamic clocks + +clone.2 + Christian Brauner, Michael Kerrisk + Document the clone3() CLONE_INTO_CGROUP flag + +mremap.2 + Brian Geffon, Michael Kerrisk [Lokesh Gidra] + Document MREMAP_DONTUNMAP + +open.2 + Joseph C. Sible [Michael Kerrisk] + Document fs.protected_fifos and fs.protected_regular + +prctl.2 + Dave Martin + Add PR_SPEC_INDIRECT_BRANCH for SPECULATION_CTRL prctls + Dave Martin + Add PR_SPEC_DISABLE_NOEXEC for SPECULATION_CTRL prctls + Dave Martin + Add PR_PAC_RESET_KEYS (arm64) + +ptrace.2 + Joseph C. Sible + Document PTRACE_SET_SYSCALL + +proc.5 + Michael Kerrisk + Document /proc/sys/fs/protected_regular + Michael Kerrisk + Document /proc/sys/fs/protected_fifos + Michael Kerrisk + Document /proc/sys/fs/aio-max-nr and /proc/sys/fs/aio-nr + +New and changed links +--------------------- + +clock_adjtime.2 + Arnd Bergmann + New link to adjtimex(2) + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Retitle EXAMPLE section heading to EXAMPLES + EXAMPLES appears to be the wider majority usage across various + projects' manual pages, and is also what is used in the POSIX + manual pages. + +Various pages + Michael Kerrisk + Correct bogus POSIX.1 standards names + POSIX.1-2003 ==> POSIX.1-2001 TC1 + POSIX.1-2004 ==> POSIX.1-2001 TC2 + POSIX.1-2013 ==> POSIX.1-2008 TC1 + POSIX.1-2016 ==> POSIX.1-2008 TC2 + +Various pages + Michael Kerrisk + Add section number in page cross-reference. + +Various pages + Kir Kolyshkin + Add missing commas in SEE ALSO + +Various pages + Michael Kerrisk + Remove AVAILABILITY section heading + In the few pages where this heading (which is "nonstandard" within + man-pages) is used, it always immediately follows CONFORMING TO + and generally contains information related to standards. Remove + the section heading, thus incorporating AVAILABILITY into + CONFORMING TO. + +Various pages + Michael Kerrisk + Remove section number in page self-references + +Various pages + Michael Kerrisk + Put SEE ALSO entries in alphabetical order + +Various pages + Michael Kerrisk + Place SH sections in standard order + Fix various pages that deviated from the norm described in + man-pages(7). + +Various "aio" pages + Michael Kerrisk [Andi Kleen, Jeff Moyer] + Change uses of aio_context_t to io_context_t + + +Changes to individual pages +--------------------------- + +bpf.2 + Peter Wu + Update enum bpf_map_type and enum bpf_prog_type + Richard Palethorpe + Change note on unprivileged access + The kernel now allows calls to bpf() without CAP_SYS_ADMIN + under some circumstances. + +clone.2 + Michael Kerrisk + Add kernel version numbers for clone_args fields + Michael Kerrisk + Combine separate NOTES sections + +close.2 + Michael Kerrisk [Lukas Czerner, Peter Schiffer, Thierry Lelegard] + Note behavior when close() happens in a parallel thread + If one thread is blocked in an I/O system call on a file descriptor + that is closed in another thread, then the blocking system call + does not return immediately, but rather when the I/O operation + completes. This surprises some people, but is longstanding + behavior. + +connect.2 + Stefan Puiu + Can return EACCES because of SELinux + +execve.2 + Michael Kerrisk [Eric Hopper] + Changes to the "dumpable" flag may change ownership of /proc/PID files + Michael Kerrisk + Improve/correct discussion of changes to dumpable flag during execve(2) + The details were not quite accurate. Defer to prctl(2) + for the more complete picture. + Nikola Forró + Clarify signal sent to the process on late failure + Michael Kerrisk + SEE ALSO: add capabilities(7) + +fanotify_init.2 + Amir Goldstein [Matthew Bobrowski] + Move out of place entry FAN_REPORT_FID + It was inserted in the middle of the FAN_CLASS_ multi flags bit + and broke the multi flag documentation. + Michael Kerrisk [Alexander Morozov, Amir Goldstein, Jan Kara] + Remove mention of FAN_Q_OVERFLOW as an input value in 'mask' + See https://bugzilla.kernel.org/show_bug.cgi?id=198569. + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Clarification about FAN_EVENT_ON_CHILD and new events + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Clarification about FAN_MARK_MOUNT and FAN_REPORT_FID + +getdents.2 + Petr Vorel [Michael Kerrisk] + Mention glibc support for getdents64() + Support was added in glibc 2.30. + Chris Lamb + Correct linux_dirent definition in example code + It is "unsigned long" earlier up in the file + +gettid.2 + Michael Kerrisk [Joseph C. Sible] + Document header file and feature test macro requirements for gettid() + +ioctl.2 + Michael Kerrisk + SEE ALSO: add ioctl_fslabel(2) + Michael Kerrisk + Remove mentions of ioctl_list(2) + Michael Kerrisk + Move subsection on "ioctl structure" from ioctl_list(2) to ioctl(2) + +io_setup.2 + Michael Kerrisk + Tweak description of /proc/sys/fs/aio-max-nr + +mbind.2 + Li Xinhai [Michael Kerrisk] + Remove note about MPOL_MF_STRICT been ignored + +mmap.2 + Michael Kerrisk [Heinrich Schuchardt] + Don't mark MAP_ANON as deprecated + +move_pages.2 + Yang Shi [Michal Hocko] + Returning positive value is a new error case + +mremap.2 + Michael Kerrisk + Remove mention of "Segmentation fault" in EFAULT text + "Segmentation fault" (SIGSEGV) is not exactly the same thing as + EFAULT. + Michael Kerrisk + Reorder some paragraphs in NOTES + Michael Kerrisk + Move a paragraph from DESCRIPTION to NOTES + +msgctl.2 + Michael Kerrisk + Correct description of 'msg_ctime' field + Verified by inspecting kernel source. + +nfsservctl.2 + Michael Kerrisk + SEE ALSO: add nfsd(7) + +open.2 + Michael Kerrisk + Some '*at' APIs have functionality that isn't in conventional APIs + Note that another reason to use the *at() APIs is to access + 'flags' functionality that is not available in the corresponding + conventional APIs. + Michael Kerrisk + Add a few more APIs to list in "Rationale for openat()..." + There have been a few more dirfd APIs added in recent times. + Michael Kerrisk + Explain ways in which a 'directory file descriptor' can be obtained + Michael Kerrisk + Add openat2() to list of APIs that take a 'dirfd' argument + +openat2.2 + Michael Kerrisk [Aleksa Sarai] + Various changes after feedback from Aleksa Sarai + +poll.2 + Michael Kerrisk + Add license to example program + +prctl.2 + Dave Martin + Sort prctls into alphabetical order + Dave Martin + Clarify that prctl can apply to threads + The current synopsis for prctl(2) misleadingly claims that prctl + operates on a process. Rather, some (in fact, most) prctls operate + Dave Martin [Dave Hansen] + Document removal of Intel MPX prctls + Dave Martin + Fix mis-description of thread ID values in procfs + Dave Martin + Work around bogus constant "maxsig" in PR_SET_PDEATHSIG + Michael Kerrisk + Add reference to proc(5) for /proc/self/task/[tid]/comm + Dave Martin [Michael Kerrisk] + Add health warning + Dave Martin + Clarify the unsupported hardware case of EINVAL + +rename.2 + Michael Kerrisk + SEE ALSO: add rename(1) + +s390_runtime_instr.2 + Heiko Carstens [Eugene Syromyatnikov, Michael Kerrisk] + Document signum argument behavior change + Document that the signum argument is ignored in newer kernels, but + that user space should pass a valid real-time signal number for + backwards compatibility. + +semctl.2 + Michael Kerrisk [Manfred Spraul] + Correct description of sem_ctime field + +semget.2 + Michael Kerrisk + Add license to example program + +shmctl.2 + Michael Kerrisk + Correct 'shm_ctime' description + +shmop.2 + Michael Kerrisk + Add license to example programs + +statfs.2 + Michael Kerrisk [David Adam] + Add SMB2 constant to filesystem types list + +syscall.2 + Dave Martin [Will Deacon] + arm64: Fix syscall number register size + Dave Martin [Russell King] + arm: Use real register names for arm/OABI + +sysfs.2 + Michael Kerrisk + SEE ALSO: add proc(5) and sysfs(5) + +utimensat.2 + Goldwyn Rodrigues + Immutable flag returns EPERM + Linux kernel commit 337684a1746f "fs: return EPERM on immutable + inode" changed the return value of the utimensat(2) from -EACCES + to -EPERM in case of an immutable flag. + +wait4.2 + Michael Kerrisk + Update wait3() feature test macro requirements for changes in glibc 2.26 + +cexp2.3 + Michael Kerrisk + Still not present in glibc 2.31 + +cmsg.3 + Michael Kerrisk + CONFORMING TO: note which CMSG_* APIs are in current and upcoming POSIX + +dirfd.3 + Michael Kerrisk + SEE ALSO: add openat(2) + +dlsym.3 + Alexander Monakov + Extend discussion of NULL symbol values + Avoid implying that use of IFUNC is the only way to produce a + symbol with NULL value. Give more scenarios how a symbol may get + NULL value, but explain that in those scenarios dlsym() will fail + with Glibc's ld.so due to an implementation inconsistency. + +err.3 + Michael Kerrisk + EXAMPLES: use EXIT_FAILURE rather than 1 as exit status + +expm1.3 + Michael Kerrisk + The expm1() bogus underflow floating-point exception has been fixed + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6778 + Michael Kerrisk + The bogus invalid floating-point exception bug has been fixed + https://www.sourceware.org/bugzilla/show_bug.cgi?id=6814. + +fdim.3 + Michael Kerrisk + BUGS: these functions did not set errno on some architectures + https://www.sourceware.org/bugzilla/show_bug.cgi?id=6796 + +ftw.3 + Michael Kerrisk + glibc eventually fixed a regression in FTW_SLN behavior + For details, see: + https://bugzilla.redhat.com/show_bug.cgi?id=1422736 + http://austingroupbugs.net/view.php?id=1121 + https://bugzilla.redhat.com/show_bug.cgi?id=1422736 + +getauxval.3 + YunQiang Su + MIPS, AT_BASE_PLATFORM passes ISA level + +getdtablesize.3 + Michael Kerrisk + Remove redundant statement that getdtablesize() is a library function + +malloc.3 + Michael Kerrisk + Add 'reallocarray' in NAME + Michael Kerrisk + Add VERSIONS section noting when reallocarray() was added to glibc + +newlocale.3 + Michael Kerrisk [Piotr Caban] + Fix a valgrind issue in example program + See https://bugzilla.kernel.org/show_bug.cgi?id=202977. + +nextafter.3 + Michael Kerrisk + Since glibc 2.23, these functions do set errno + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6799. + +posix_spawn.3 + Olivier Gayot [Adhemerval Zanella] + Clarify by using name of steps rather than syscalls + Olivier Gayot [Adhemerval Zanella] + Document implementation using clone() since glibc 2.24 + Olivier Gayot [Adhemerval Zanella] + Document POSIX_SPAWN_USEVFORK + Added a few lines about POSIX_SPAWN_USEVFORK so that it appears + clearly that since glibc 2.24, the flag has no effect. + Olivier Gayot [Adhemerval Zanella] + Document the POSIX_SPAWN_SETSID attribute + +pow.3 + Michael Kerrisk + BUGS: pow() performance problem for some (rare) inputs has been fixed + See https://sourceware.org/bugzilla/show_bug.cgi?id=13932 + Michael Kerrisk + Several bugs in glibc's pow() implementation were fixed in glibc 2.16 + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=3866. + Michael Kerrisk + Add a subheading to mark off historical bugs that are now fixed + +printf.3 + Tobias Stoeckmann + Prevent signed integer overflow in example + +ptsname.3 + Bruno Haible + Fix description of failure behaviour of ptsname_r() + +random.3 + John Marshall + Change "RAND_MAX" tp "2^31-1" + +scalb.3 + Michael Kerrisk + These functions now correctly set errno for the EDOM and ERANGE cases + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 + and https://www.sourceware.org/bugzilla/show_bug.cgi?id=6804 + +scalbln.3 + Michael Kerrisk + These functions now correctly set errno for the ERANGE case + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 + +scanf.3 + Michael Kerrisk [Jürgen Sauermann] + Clarify that 'x' specifier allows a 0x/0X prefix in input string + +sem_getvalue.3 + Michael Kerrisk [Andrea Galbusera] + Note that glibc's sem_getvalue() doesn't return EINVAL errors + See https://bugzilla.kernel.org/show_bug.cgi?id=204273 + +setlogmask.3 + Michael Kerrisk + Note that LOG_UPTO() is included in the next POSIX release + +shm_open.3 + Michael Kerrisk + Add license to example programs + +sincos.3 + Michael Kerrisk + The glibc implementation does now give EDOM for a domain error + See https://www.sourceware.org/bugzilla/show_bug.cgi?id=15467 + +stdarg.3 + Michael Kerrisk + SEE ALSO: add vprintf(3), vscanf(3), vsyslog(3) + +strcmp.3 + Michael Kerrisk + Add license to example programs + +strftime.3 + Urs Thuermann + ISO week number can be 52, add example + +y0.3 + Michael Kerrisk + These functions now correctly diagnose a pole error + https://sourceware.org/bugzilla/show_bug.cgi?id=6807 + Michael Kerrisk + errno is now correctly set to ERANGE on underflow + https://www.sourceware.org/bugzilla/show_bug.cgi?id=6808 + +loop.4 + Michael Kerrisk [Vlad] + 'lo_flags' is nowadays "r/w" + See https://bugzilla.kernel.org/show_bug.cgi?id=203417 + +veth.4 + Devin J. Pohly + Add a more direct example + iproute2 allows you to specify the netns for either side of a veth + interface at creation time. Add an example of this to veth(4) so + it doesn't sound like you have to move the interfaces in a + separate step. + +core.5 + Michael Kerrisk [Jonny Grant] + Mention 'sysctl -w' as a way of changing core_pattern setting + Michael Kerrisk [Jonny Grant] + Note that not dumping core of an unreadable binary is a security measure + Michael Kerrisk [Jonny Grant] + Explain that core_pattern %e is process/thread 'comm' value + The 'comm' value is typically the same as the (possibly + truncated) executable name, but may be something different. + +filesystems.5 + Michael Kerrisk + SEE ALSO: add sysfs(5) and xfs(5) + +locale.5 + Michael Kerrisk [Helge Kreutzmann] + Improve description of 'first_weekday' + +proc.5 + Michael Kerrisk + Note kernel version for /proc/PID/smaps VmFlags "wf" flag + Michael Kerrisk + Add "um" and "uw" to VmFlags in /proc/[pid]/smaps + Michael Kerrisk + Add "mp" to VmFlags in /proc/[pid]/smaps + Michael Kerrisk + Note kernel version that removed /proc/PID/smaps VmFlags "nl" flag + Ian Rogers + Add "wf" to VmFlags in /proc/[pid]/smaps + Michael Kerrisk + Note kernel version for /proc/PID/smaps VmFlags "dd" flag + Michael Kerrisk + Add "sf" to VmFlags in /proc/[pid]/smaps + Michael Kerrisk [Kirill A. Shutemov] + Remove "mp" under VmFlags in /proc/[pid]/smaps + Michael Kerrisk [Eric Hopper] + Alert the reader that UID/GID changes can reset the "dumpable" attribute + Keno Fischer + Fix an outdated note about map_files + The restriction to CAP_SYS_ADMIN was removed from map_files in 2015. + Michael Kerrisk [Helge Kreutzmann] + Better explanation of some /proc/ide fields + Michael Kerrisk + TASK_COMM_LEN limit includes the terminating '\0' + Clarify this detail in the discussion of /proc/[pid]/comm. + Michael Kerrisk + Add a detail to /proc/[pid]/comm + Note the connection to the "%e" specifier in + /proc/sys/kernel/core_pattern. + +securetty.5 + Michael Kerrisk [Helge Kreutzmann] + Improve wording of .SH one-line description + +tzfile.5 + Michael Kerrisk + Sync to 2020a tzdb release + From https://www.iana.org/time-zones, version 2020a. + Michael Kerrisk + Explain UT abbreviation + +ascii.7 + Michael Kerrisk [Helge Kreutzmann] + SEE ALSO: fix sort order in entries + +bpf-helpers.7 + Michael Kerrisk + Resync against kernel 5.7 + +cgroups.7 + Marcus Gelderie + Mention cgroup.sane_behavior file + The cgroup.sane_behavior file returns the hard-coded value "0" and + is kept for legacy purposes. Mention this in the man-page. + Michael Kerrisk + Note the existence of the clone3() CLONE_INTO_CGROUP flag + +credentials.7 + Michael Kerrisk + Alert reader that UID/GID changes can affect process capabilities + Michael Kerrisk + Changes to process UIDs/GIDs can effect the "dumpable" attribute + Michael Kerrisk + Add a list of the APIs that change a process's credentials + +fanotify.7 + Amir Goldstein [Jan Kara, Matthew Bobrowski] + Fix fanotify_fid.c example + Michael Kerrisk + Wrap some long lines in example program + +fanotify.7 +fanotify_mark.2 + Amir Goldstein [Matthew Bobrowski] + Clarify FAN_ONDIR in output mask + FAN_ONDIR was an input only flag before introducing + FAN_REPORT_FID. Since the introduction of FAN_REPORT_FID, it can + also be in output mask. + +hier.7 + Thomas Piekarski [Gary Perkins] + Updating from FHS 2.3 to 3.0 + See https://bugzilla.kernel.org/show_bug.cgi?id=206693 + +inotify.7 + Michael Kerrisk [Jason Etherton] + Add missing #include in example program + +ip.7 + Michael Kerrisk [Martin Doucha] + Note a few more valid 'protocol' values + See https://bugzilla.kernel.org/show_bug.cgi?id=204981 + Michael Kerrisk + SEE ALSO: add netdevice(7) + +man-pages.7 + Michael Kerrisk + Rename EXAMPLE to EXAMPLES + Michael Kerrisk + Describe COPYRIGHT section + man-pages doesn't use COPYRIGHT sections in manual pages, but + various projects do. Make some recommendations about placement + of the section. + Michael Kerrisk + Add REPORTING BUGS section + man-pages doesn't have a REPORTING BUGS section in manual pages, + but many other projects do. Make some recommendations about + placement of that section. + Michael Kerrisk + Mention AUTHORS in summary section list + Although man-pages doesn't use AUTHORS sections, many projects do + use an AUTHORS section in their manual pages, so mention it in + man-pages to suggest some guidance on the position at which + to place that section. + +mount_namespaces.7 + Michael Kerrisk + SEE ALSO: add mount(8), umount(8) + +namespaces.7 + Michael Kerrisk + Document /proc/sys/user/max_time_namespaces + +netlink.7 + Michael Kerrisk [Idan Katz] + Update path for NETLINK_CONNECTOR docs in kernel source tree + Michael Kerrisk [Fabien Siron] + Note that NETLINK_SOCK_DIAG is preferred over NETLINK_INET_DIAG + +pid_namespaces.7 + Michael Kerrisk + Note that /proc/sys/kernel/ns_last_pid is virtualized per PID NS + Michael Kerrisk + Correct capability requirements for write to /proc/sys/kernel/ns_last_pid + CAP_SYS_ADMIN is needed in the user NS that owns the PID NS. + +rtnetlink.7 + Jan Moskyto Matejka [Michael Kerrisk] + Add missing RTA_* attributes + +standards.7 + Michael Kerrisk [Geoff Clare] + Add some more standards + Add: SUSv4 2016 edition, POSIX.1-2017, and SUSv4 2018 edition + Michael Kerrisk + Remove mention of bogus "POSIX" names + The terms POSIX.1-{2003,2004,2013,2016} were inventions of + my imagination, as confirmed by consulting Geoff Clare of + The Open Group. Remove these names. + +symlink.7 + Michael Kerrisk + Describe differences in the treatment of symlinks in the dirname + Describe differences in the treatment of symlinks in the dirname + part of pathname. + +tcp.7 + Michael Kerrisk [vrafaeli@msn.com] + Update info on tcp_syn_retries default value + See https://bugzilla.kernel.org/show_bug.cgi?id=202885. + +user_namespaces.7 + Michael Kerrisk [Léo Stefanesco] + Clarify that "system time" means "calendar time" + +xattr.7 + Achilles Gaikwad + Add attr(1) as relevant page to SEE ALSO + +ldconfig.8 + Florian Weimer + Mention new default for --format in glibc 2.32 + +zdump.8 + Michael Kerrisk [Marco Curreli, Paul Eggert] + Update to latest upstream tz release + Look under "Latest version", which is 2020a. diff --git a/man-pages-5.07.Announce b/man-pages-5.08.Announce index 111eaef08..9bb99ab4f 100644 --- a/man-pages-5.07.Announce +++ b/man-pages-5.08.Announce @@ -1,7 +1,7 @@ RELEASE The Linux man page maintainer proudly announces. . . - man-pages-5.07.tar.gz - man pages for Linux + man-pages-5.08.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.07.lsm b/man-pages-5.08.lsm index afeef0ebb..f412c35e9 100644 --- a/man-pages-5.07.lsm +++ b/man-pages-5.08.lsm @@ -1,13 +1,13 @@ Begin3 Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 5.07 -Entered-date: 2020-06-09 +Version: 5.08 +Entered-date: 2020-08-13 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 - 2708k man-pages-5.07.tar.gz + 2715k man-pages-5.08.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 64bd2ee10..f2bd845ed 100644 --- a/man1/getent.1 +++ b/man1/getent.1 @@ -398,7 +398,7 @@ Enumeration not supported on this .SH SEE ALSO .BR nsswitch.conf (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/iconv.1 b/man1/iconv.1 index 029c2d063..26aea3cc2 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -1,5 +1,3 @@ -'\" t -*- coding: UTF-8 -*- -.\" .\" Copyright (C) 2014 Marko Myllynen <myllynen@redhat.com> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -204,7 +202,7 @@ abc ss ? EUR abc .BR charsets (7), .BR iconvconfig (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/intro.1 b/man1/intro.1 index 2f37e12e3..e3ab1de73 100644 --- a/man1/intro.1 +++ b/man1/intro.1 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INTRO 1 2015-07-23 "Linux" "Linux User's Manual" +.TH INTRO 1 2020-08-13 "Linux" "Linux User's Manual" .SH NAME intro \- introduction to user commands .SH DESCRIPTION @@ -220,7 +220,7 @@ and .I pwd commands and explore .I cd -usage: "cd", "cd .", "cd ..", "cd /" and "cd ~". +usage: "cd", "cd .", "cd ..", "cd /" and "cd \(ti". .SS Directories The command .I mkdir @@ -321,10 +321,10 @@ and use a browser if you find HTML files there. .BR zsh (1), .BR wait (2), .BR stdout (3), -.BR man-pages (7), +.BR man\-pages (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/ldd.1 b/man1/ldd.1 index 159cbebfc..507290630 100644 --- a/man1/ldd.1 +++ b/man1/ldd.1 @@ -171,7 +171,7 @@ on one of these programs, the program will attempt to run with .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/locale.1 b/man1/locale.1 index 7eda90a30..e7ea297df 100644 --- a/man1/locale.1 +++ b/man1/locale.1 @@ -58,7 +58,7 @@ the behavior is as follows: .BR \-a ", " \-\-all\-locales Display a list of all available locales. The -.B -v +.B \-v option causes the .B LC_IDENTIFICATION metadata about each locale to be included in the output. @@ -66,7 +66,7 @@ metadata about each locale to be included in the output. .BR \-m ", " \-\-charmaps Display the available charmaps (character set description files). To display the current character set for the locale, use -\fBlocale -c charmap\fR. +\fBlocale \-c charmap\fR. .PP The .B locale @@ -195,8 +195,8 @@ in the shell profile file so that the custom locale will be used in the subsequent user sessions: .PP .EX -$ \fBmkdir -p $HOME/.locale\fP -$ \fBI18NPATH=./wrk/ localedef -f UTF-8 -i fi_SE $HOME/.locale/fi_SE.UTF-8\fP +$ \fBmkdir \-p $HOME/.locale\fP +$ \fBI18NPATH=./wrk/ localedef \-f UTF-8 \-i fi_SE $HOME/.locale/fi_SE.UTF-8\fP $ \fBLOCPATH=$HOME/.locale LC_ALL=fi_SE.UTF-8 date\fP $ \fBecho "export LOCPATH=\e$HOME/.locale" >> $HOME/.bashrc\fP $ \fBecho "export LANG=fi_SE.UTF-8" >> $HOME/.bashrc\fP @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/localedef.1 b/man1/localedef.1 index b241fba09..c0eb4c83d 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -187,7 +187,7 @@ are also searched after the current directory. The default directory for locale definition files is printed by .BR "localedef \-\-help" . .TP -.BI \-u " repertoirefile" "\fR, \fP\-\-repertoire-map=" repertoirefile +.BI \-u " repertoirefile" "\fR, \fP\-\-repertoire\-map=" repertoirefile Read mappings from symbolic names to Unicode code points from .IR repertoirefile . If @@ -404,7 +404,7 @@ localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8 .BR repertoiremap (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusage.1 b/man1/memusage.1 index 8dffeb377..f22f2e741 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -55,7 +55,7 @@ can also be intercepted. can output the collected data in textual form, or it can use .BR memusagestat (1) (see the -.B -p +.B \-p option, below) to create a PNG file containing graphical representation of the collected data. @@ -152,7 +152,7 @@ Collect .I size entries before writing them out. .TP -.B \fB\-\-no-timer +.B \-\-no\-timer Disable timer-based .RB ( SIGPROF ) sampling of stack pointer value. @@ -272,7 +272,7 @@ main(int argc, char *argv[]) .BR mtrace (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/memusagestat.1 b/man1/memusagestat.1 index 822b18147..3da9143f6 100644 --- a/man1/memusagestat.1 +++ b/man1/memusagestat.1 @@ -31,9 +31,9 @@ creates a PNG file containing a graphical representation of the memory profiling data in the file .IR datafile ; that file is generated via the -.I -d +.I \-d (or -.IR --data ) +.IR \-\-data ) option of .BR memusage (1). .PP @@ -41,7 +41,7 @@ The red line in the graph shows the heap usage (allocated memory) and the green line shows the stack usage. The x-scale is either the number of memory-handling function calls or (if the -.I -t +.I \-t option is specified) time. .SH OPTIONS @@ -60,7 +60,7 @@ Use time (rather than number of function calls) as the scale for the X axis. .B \-T\fR,\ \fB\-\-total Also draw a graph of total memory consumption. .TP -.BI \-x\ size \fR,\ \fB\-\-x-size= size +.BI \-x\ size \fR,\ \fB\-\-x\-size= size Make the output graph .I size pixels wide. @@ -89,7 +89,7 @@ See .BR memusage (1), .BR mtrace (1) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/mtrace.1 b/man1/mtrace.1 index 2b261344c..c7692f56c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/pldd.1 b/man1/pldd.1 index 257c44398..40008f973 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -93,7 +93,7 @@ using a command such as the following .in +4n .EX $ \fBgdb \-ex "set confirm off" \-ex "set height 0" \-ex "info shared" \e\fP - \fB\-ex "quit" \-p $pid | grep '^0x.*0x'\fP + \fB\-ex "quit" \-p $pid | grep '\(ha0x.*0x'\fP .EE .in .SH BUGS @@ -122,7 +122,7 @@ linux\-vdso.so.1 .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/sprof.1 b/man1/sprof.1 index 43abc20f9..5db22a873 100644 --- a/man1/sprof.1 +++ b/man1/sprof.1 @@ -301,7 +301,7 @@ x2 consumeCpu2 1000 .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man1/time.1 b/man1/time.1 index 5a76143b6..5b806c6b2 100644 --- a/man1/time.1 +++ b/man1/time.1 @@ -10,7 +10,8 @@ .SH NAME time \- time a simple command or give resource usage .SH SYNOPSIS -.BI "time [" options "] " command " [" arguments... "] " +.B time \c +.RI [ options ] " command " [ arguments... ] .SH DESCRIPTION The .B time @@ -330,7 +331,7 @@ and C compiler you used. .BR times (2), .BR wait3 (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_exit.2 b/man2/_exit.2 index 14e44aedd..83ee13b71 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/_syscall.2 b/man2/_syscall.2 index c2827ecbf..d66e261b7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/accept.2 b/man2/accept.2 index 7dbedd713..d005ba416 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/access.2 b/man2/access.2 index aaaa8501a..c34a388f8 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -280,7 +280,6 @@ SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008. .BR faccessat (): POSIX.1-2008. .SH NOTES -.PP .BR Warning : Using these calls to check if a user is authorized to, for example, open a file before actually doing so using @@ -413,7 +412,7 @@ flag is honored. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/acct.2 b/man2/acct.2 index 69faab00b..7d95ae1ba 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.07 of the Linux +This page is part of release 5.08 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 fed09fef6..83547121c 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -294,7 +294,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 index 638a17307..00cb71953 100644 --- a/man2/adjtimex.2 +++ b/man2/adjtimex.2 @@ -182,7 +182,6 @@ while (buf.time.tv_usec < 0) { } .EE .in -.PP .TP .BR ADJ_MICRO " (since Linux 2.6.26)" .\" commit eea83d896e318bda54be2d2770d2c5d6668d11db @@ -609,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/alarm.2 b/man2/alarm.2 index 8d12237e4..029525c7d 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.07 of the Linux +This page is part of release 5.08 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 41725ece2..dba5a65c5 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -143,13 +143,13 @@ to map files in this virtual filesystem. The maximal number of huge pages can be specified using the .B hugepages= boot parameter. -.PP +.\".PP .\" requires CONFIG_HUGETLB_PAGE (under "Processor type and features") .\" and CONFIG_HUGETLBFS (under "Filesystems"). -.\" mount -t hugetlbfs hugetlbfs /huge +.\" mount \-t hugetlbfs hugetlbfs /huge .\" SHM_HUGETLB .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 c1eceea57..b712a2975 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -192,7 +192,7 @@ directly are very likely to crash. .PP AMD X86-64 Programmer's manual .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bdflush.2 b/man2/bdflush.2 index 74bdff7ce..9b5df7658 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bind.2 b/man2/bind.2 index de95519f8..45197850e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/bpf.2 b/man2/bpf.2 index 6e3ffcdf3..5fd39140e 100644 --- a/man2/bpf.2 +++ b/man2/bpf.2 @@ -84,7 +84,7 @@ below for further details. Generally, eBPF programs are loaded by the user process and automatically unloaded when the process exits. In some cases, for example, -.BR tc-bpf (8), +.BR tc\-bpf (8), the program will continue to stay alive inside the kernel even after the process that loaded the program exits. In that case, @@ -121,7 +121,7 @@ eBPF programs can access the same map: .EX tracing tracing tracing packet packet packet event A event B event C on eth0 on eth1 on eth2 - | | | | | ^ + | | | | | \(ha | | | | v | --> tracing <-- tracing socket tc ingress tc egress prog_1 prog_2 prog_3 classifier action @@ -314,9 +314,11 @@ bpf_map_lookup_elem(map_fd, fp - 4) the program will be rejected, since the in-kernel helper function .IP +.in +4n .EX - bpf_map_lookup_elem(map_fd, void *key) +bpf_map_lookup_elem(map_fd, void *key) .EE +.in .IP expects to read 8 bytes from the location pointed to by .IR key , @@ -1270,15 +1272,15 @@ riscv (since Linux 5.1). .PD .SH SEE ALSO .BR seccomp (2), -.BR bpf-helpers (7), +.BR bpf\-helpers (7), .BR socket (7), .BR tc (8), -.BR tc-bpf (8) +.BR tc\-bpf (8) .PP 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/brk.2 b/man2/brk.2 index 147d12609..53ee5e63c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index e25267a30..8811c1d5d 100644 --- a/man2/cacheflush.2 +++ b/man2/cacheflush.2 @@ -102,7 +102,7 @@ argument and does not do any error checking on the .I cache argument. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/capget.2 b/man2/capget.2 index 112115c6b..06275f8a0 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -247,7 +247,7 @@ library and is available here: .BR gettid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chdir.2 b/man2/chdir.2 index 2650a0a7c..d8c75073e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chmod.2 b/man2/chmod.2 index e7e28f501..40ee8597c 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -387,7 +387,7 @@ argument. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chown.2 b/man2/chown.2 index 8b66d979f..57149aa6a 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -447,7 +447,6 @@ has got the same syscall number, and .BR chown () got the newly introduced number. .SH EXAMPLES -.PP The following program changes the ownership of the file named in its second command-line argument to the value specified in its first command-line argument. @@ -502,7 +501,7 @@ main(int argc, char *argv[]) .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/chroot.2 b/man2/chroot.2 index dbe8a75f3..e267cac6b 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -54,7 +54,6 @@ _XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L) || /* Since glibc 2.20: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE .TP 4 -.fi Before glibc 2.2.2: none .PD .RE @@ -185,7 +184,7 @@ system call. .BR path_resolution (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 0b6b4eb98..8b91754d4 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-04-11 "" "Linux Programmer's Manual" +.TH CLOCK_GETRES 2 2020-08-13 "" "Linux Programmer's Manual" .SH NAME clock_getres, clock_gettime, clock_settime \- clock and time functions .SH SYNOPSIS @@ -248,8 +248,8 @@ dynamic clock ID. .in +4n .EX #define CLOCKFD 3 -#define FD_TO_CLOCKID(fd) ((~(clockid_t) (fd) << 3) | CLOCKFD) -#define CLOCKID_TO_FD(clk) ((unsigned int) ~((clk) >> 3)) +#define FD_TO_CLOCKID(fd) ((\(ti(clockid_t) (fd) << 3) | CLOCKFD) +#define CLOCKID_TO_FD(clk) ((unsigned int) \(ti((clk) >> 3)) struct timeval tv; clockid_t clkid; @@ -537,7 +537,7 @@ main(int argc, char *argv[]) .BR vdso (7), .BR hwclock (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 1701904da..18af99a72 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/clone.2 b/man2/clone.2 index 2658b16c5..33a458a1d 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -50,7 +50,7 @@ clone, __clone2, clone3 \- create a child process .B #include <sched.h> .PP .BI "int clone(int (*" "fn" ")(void *), void *" stack \ -", int " flags ", void *" "arg" ", ... " +", int " flags ", void *" "arg" ", ..." .BI " /* pid_t *" parent_tid ", void *" tls \ ", pid_t *" child_tid " */ );" .PP @@ -104,7 +104,6 @@ In the remainder of this page, the terminology "the clone call" is used when noting details that apply to all of these interfaces, .\" .SS The clone() wrapper function -.PP When the child process is created with the .BR clone () wrapper function, @@ -156,7 +155,6 @@ The remaining arguments to are discussed below. .\" .SS clone3() -.PP The .BR clone3 () system call provides a superset of the functionality of the older @@ -235,7 +233,6 @@ The remaining fields in the argument are discussed below. .\" .SS Equivalence between clone() and clone3() arguments -.PP Unlike the older .BR clone () interface, where arguments are passed individually, in the newer @@ -260,7 +257,7 @@ l l l li li l. clone() clone3() Notes \fIcl_args\fP field -flags & ~0xff flags For most flags; details below +flags & \(ti0xff flags For most flags; details below parent_tid pidfd See CLONE_PIDFD child_tid child_tid See CLONE_CHILD_SETTID parent_tid parent_tid See CLONE_PARENT_SETTID @@ -275,7 +272,6 @@ tls tls See CLONE_SETTLS .RE .\" .SS The child termination signal -.PP When the child process terminates, a signal may be sent to the parent. The termination signal is specified in the low byte of .I flags @@ -295,7 +291,6 @@ If no signal (i.e., zero) is specified, then the parent process is not signaled when the child terminates. .\" .SS The set_tid array -.PP By default, the kernel chooses the next sequential PID for the new process in each of the PID namespaces where it is present. When creating a process with @@ -380,7 +375,6 @@ Otherwise the PID entry for this PID namespace must be 1. .\" .SS The flags mask -.PP Both .BR clone () and @@ -1447,7 +1441,7 @@ to be exceeded. For further details, see .BR namespaces (7). .TP -.BR EOPNOTSUP " (" clone3 "() only)" +.BR EOPNOTSUPP " (" clone3 "() only)" .B CLONE_INTO_CGROUP was specified in .IR cl_args.flags , @@ -1527,7 +1521,6 @@ These system calls are Linux-specific and should not be used in programs intended to be portable. .SH NOTES -.PP One use of these systems calls is to implement threads: multiple flows of control in a program that run concurrently in a shared address space. @@ -1559,7 +1552,6 @@ system call can be used to test whether two processes share various resources such as a file descriptor table, System V semaphore undo operations, or a virtual address space. .PP -.PP Handlers registered using .BR pthread_atfork (3) are not executed during a clone call. @@ -1682,9 +1674,9 @@ On ia64, a different interface is used: .PP .in +4 .EX -.BI "int __clone2(int (*" "fn" ")(void *), " +.BI "int __clone2(int (*" "fn" ")(void *)," .BI " void *" stack_base ", size_t " stack_size , -.BI " int " flags ", void *" "arg" ", ... " +.BI " int " flags ", void *" "arg" ", ..." .BI " /* pid_t *" parent_tid ", struct user_desc *" tls , .BI " pid_t *" child_tid " */ );" .EE @@ -1911,7 +1903,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/close.2 b/man2/close.2 index c920b2457..b8bb8d21a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/connect.2 b/man2/connect.2 index 6cb2a8105..382d5360a 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -130,7 +130,7 @@ may dissolve the association by connecting to an address with the member of .I sockaddr set to -.BR AF_UNSPEC; +.BR AF_UNSPEC ; thereafter, the socket can be connected to another address. .RB ( AF_UNSPEC is supported on Linux since kernel 2.2.) @@ -307,7 +307,7 @@ is shown in .BR path_resolution (7), .BR selinux (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 04302dfae..b5256eb9a 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.07 of the Linux +This page is part of release 5.08 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 d6fc158b9..94564a99f 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.07 of the Linux +This page is part of release 5.08 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 a734c10f8..6e378a6b1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/dup.2 b/man2/dup.2 index 93a82b52c..78c777979 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -45,7 +45,7 @@ dup, dup2, dup3 \- duplicate a file descriptor .BI "int dup2(int " oldfd ", int " newfd ); .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.BR "#include <fcntl.h>" " /* Obtain O_* constant definitions */ +.BR "#include <fcntl.h>" " /* Obtain O_* constant definitions */" .B #include <unistd.h> .PP .BI "int dup3(int " oldfd ", int " newfd ", int " flags ); @@ -247,38 +247,40 @@ before calling because of the race condition described above. Instead, code something like the following could be used: .PP +.in +4n .EX - /* Obtain a duplicate of 'newfd' that can subsequently - be used to check for close() errors; an EBADF error - means that 'newfd' was not open. */ +/* Obtain a duplicate of 'newfd' that can subsequently + be used to check for close() errors; an EBADF error + means that 'newfd' was not open. */ - tmpfd = dup(newfd); - if (tmpfd == \-1 && errno != EBADF) { - /* Handle unexpected dup() error */ - } +tmpfd = dup(newfd); +if (tmpfd == \-1 && errno != EBADF) { + /* Handle unexpected dup() error */ +} - /* Atomically duplicate 'oldfd' on 'newfd' */ +/* Atomically duplicate 'oldfd' on 'newfd' */ - if (dup2(oldfd, newfd) == \-1) { - /* Handle dup2() error */ - } +if (dup2(oldfd, newfd) == \-1) { + /* Handle dup2() error */ +} - /* Now check for close() errors on the file originally - referred to by 'newfd' */ +/* Now check for close() errors on the file originally + referred to by 'newfd' */ - if (tmpfd != \-1) { - if (close(tmpfd) == \-1) { - /* Handle errors from close */ - } +if (tmpfd != \-1) { + if (close(tmpfd) == \-1) { + /* Handle errors from close */ } +} .EE +.in .SH SEE ALSO .BR close (2), .BR fcntl (2), .BR open (2), .BR pidfd_getfd (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 95e77f380..a01411c8f 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.07 of the Linux +This page is part of release 5.08 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 c8572e375..3b778ca54 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -478,7 +478,7 @@ flag. .BR poll (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 6e25edf89..c47b299e0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/eventfd.2 b/man2/eventfd.2 index 8f4a41b97..97bb09132 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -358,7 +358,6 @@ eventfd file descriptor, returning 0 if the correct number of bytes was transferred, or \-1 otherwise. .SH EXAMPLES -.PP The following program creates an eventfd file descriptor and then forks to create a child process. While the parent briefly sleeps, @@ -452,7 +451,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execve.2 b/man2/execve.2 index 8a60dc526..92b37b96e 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -34,13 +34,13 @@ .\" 2007-09-14 Ollie Wild <aaw@google.com>, mtk .\" Add text describing limits on command-line arguments + environment .\" -.TH EXECVE 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH EXECVE 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME execve \- execute program .SH SYNOPSIS .B #include <unistd.h> .PP -.BI "int execve(const char *" pathname ", char *const " argv "[], " +.BI "int execve(const char *" pathname ", char *const " argv [], .br .BI " char *const " envp []); .SH DESCRIPTION @@ -68,7 +68,7 @@ By convention, the first of these strings (i.e., should contain the filename associated with the file being executed. The .I argv -array must be terminated by a NULL pointer +array must be terminated by a NULL pointer. (Thus, in the new program, .IR argv[argc] will be NULL.) @@ -77,7 +77,7 @@ will be NULL.) \fBkey=value\fP, which are passed as the environment of the new program. The .I envp -array must be terminated by a NULL pointer +array must be terminated by a NULL pointer. .PP The argument vector and environment can be accessed by the new program's main function, when it is defined as: @@ -158,7 +158,7 @@ shared objects. This interpreter is typically .I /lib/ld-linux.so.2 for binaries linked with glibc (see -.BR ld-linux.so (8)). +.BR ld\-linux.so (8)). .\" .SS Effect on process attributes All process attributes are preserved during an @@ -857,8 +857,8 @@ program: .in +4n .EX .RB "$" " cat > script" -.B #!./myecho script-arg -.B ^D +.B #!./myecho script\-arg +.B \(haD .RB "$" " chmod +x script" .EE .in @@ -869,7 +869,7 @@ We can then use our program to exec the script: .EX .RB "$" " ./execve ./script" argv[0]: ./myecho -argv[1]: script-arg +argv[1]: script\-arg argv[2]: ./script argv[3]: hello argv[4]: world @@ -891,7 +891,7 @@ argv[4]: world .BR path_resolution (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/execveat.2 b/man2/execveat.2 index 6bf7e564e..07f66949a 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.07 of the Linux +This page is part of release 5.08 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 6aa6f0688..e086511fc 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fallocate.2 b/man2/fallocate.2 index 7f5c2ca90..6eab733a9 100644 --- a/man2/fallocate.2 +++ b/man2/fallocate.2 @@ -17,7 +17,7 @@ fallocate \- manipulate file space .B #include <fcntl.h> .PP .BI "int fallocate(int " fd ", int " mode ", off_t " offset \ -", off_t " len "); +", off_t " len ");" .fi .SH DESCRIPTION This is a nonportable, Linux-specific system call. @@ -481,7 +481,7 @@ is Linux-specific. .BR posix_fadvise (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 394ac7a40..4408aa384 100644 --- a/man2/fanotify_init.2 +++ b/man2/fanotify_init.2 @@ -308,7 +308,7 @@ returned when reading from the fanotify file descriptor. .BR fanotify_mark (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 45e914b66..8428841a4 100644 --- a/man2/fanotify_mark.2 +++ b/man2/fanotify_mark.2 @@ -553,7 +553,7 @@ is not checked for invalid values. .BR fanotify_init (2), .BR fanotify (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 1f8d901ef..b251276cc 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -1,4 +1,3 @@ -'\" t .\" This manpage is Copyright (C) 1992 Drew Eckhardt; .\" and Copyright (C) 1993 Michael Haardt, Ian Jackson; .\" and Copyright (C) 1998 Jamie Lokier; @@ -65,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-02-09 "Linux" "Linux Programmer's Manual" +.TH FCNTL 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME fcntl \- manipulate file descriptor .SH SYNOPSIS @@ -2127,7 +2126,7 @@ directory, and is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/flock.2 b/man2/flock.2 index 04620dcfc..e59d63bda 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fork.2 b/man2/fork.2 index 4f1a8625e..13ec83649 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -177,7 +177,7 @@ After a .BR fork () in a multithreaded program, the child can safely call only async-signal-safe functions (see -.BR signal-safety (7)) +.BR signal\-safety (7)) until such time as it calls .BR execve (2). .IP * @@ -279,7 +279,6 @@ System call was interrupted by a signal and will be restarted. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .SH NOTES -.PP Under Linux, .BR fork () is implemented using copy-on-write pages, so the only penalty that it incurs @@ -327,7 +326,7 @@ and .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/fstatvfs.2 b/man2/fstatvfs.2 deleted file mode 100644 index adec9ddea..000000000 --- a/man2/fstatvfs.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/statvfs.3 diff --git a/man2/fsync.2 b/man2/fsync.2 index 6dedf301f..25d0cd0b3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futex.2 b/man2/futex.2 index 36d54f295..fc223cc40 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -30,14 +30,13 @@ futex \- fast user-space locking .PP .BI "int futex(int *" uaddr ", int " futex_op ", int " val , .BI " const struct timespec *" timeout , \ -" \fR /* or: \fBuint32_t \fIval2\fP */ +" \fR /* or: \fBuint32_t \fIval2\fP */" .BI " int *" uaddr2 ", int " val3 ); .fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION -.PP The .BR futex () system call provides a method for waiting until a certain condition becomes @@ -663,8 +662,8 @@ component has one of the following values: FUTEX_OP_SET 0 /* uaddr2 = oparg; */ FUTEX_OP_ADD 1 /* uaddr2 += oparg; */ FUTEX_OP_OR 2 /* uaddr2 |= oparg; */ -FUTEX_OP_ANDN 3 /* uaddr2 &= ~oparg; */ -FUTEX_OP_XOR 4 /* uaddr2 ^= oparg; */ +FUTEX_OP_ANDN 3 /* uaddr2 &= \(tioparg; */ +FUTEX_OP_XOR 4 /* uaddr2 \(ha= oparg; */ .EE .in .IP @@ -726,7 +725,6 @@ If .I timeout is NULL, the operation can block indefinitely. .IP -.IP The .I uaddr2 argument is ignored. @@ -1017,7 +1015,7 @@ user space atomically by setting the futex value to 0. .\" .\" lock(kernel_lock); .\" retry: -.\" +.\" .\" /* .\" * Owner might have unlocked in userspace before we .\" * were able to set the waiter bit. @@ -1315,7 +1313,6 @@ operation. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" .SH RETURN VALUE -.PP In the event of an error (and assuming that .BR futex () was invoked via @@ -1685,7 +1682,6 @@ and the timeout expired before the operation completed. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" .SH VERSIONS -.PP Futexes were first made available in a stable kernel release with Linux 2.6.0. .PP @@ -1935,7 +1931,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/futimesat.2 b/man2/futimesat.2 index 972e6c35a..62e23247d 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.07 of the Linux +This page is part of release 5.08 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 f1bb48b13..413d7f4d3 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.07 of the Linux +This page is part of release 5.08 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 b8971294e..3cf154535 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.07 of the Linux +This page is part of release 5.08 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 816de1860..c75aedb92 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getcontext.2 b/man2/getcontext.2 deleted file mode 100644 index b01818d4f..000000000 --- a/man2/getcontext.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/getcontext.3 diff --git a/man2/getcpu.2 b/man2/getcpu.2 index 8824e3ccc..3fa21d899 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getcwd.2 b/man2/getcwd.2 deleted file mode 100644 index f73c1579c..000000000 --- a/man2/getcwd.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/getcwd.3 diff --git a/man2/getdents.2 b/man2/getdents.2 index 628b55720..e6df3ae57 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -167,8 +167,8 @@ system call is like except that its second argument is a pointer to a buffer containing structures of the following type: .PP -.EX .in +4n +.EX struct linux_dirent64 { ino64_t d_ino; /* 64-bit inode number */ off64_t d_off; /* 64-bit offset to next structure */ @@ -322,7 +322,7 @@ main(int argc, char *argv[]) .BR readdir (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index 6d6484364..10c8885d4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getdtablesize.2 b/man2/getdtablesize.2 deleted file mode 100644 index 68c2fd8af..000000000 --- a/man2/getdtablesize.2 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/getdtablesize.3 -.\" Created 2013-02-05; will eventually be removed diff --git a/man2/getgid.2 b/man2/getgid.2 index e79369728..f923c11b9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 9699754e0..a83adf5c6 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -54,7 +54,6 @@ Feature Test Macro Requirements for glibc (see Glibc 2.19 and earlier: _BSD_SOURCE .SH DESCRIPTION -.PP .BR getgroups () returns the supplementary group IDs of the calling process in .IR list . @@ -226,7 +225,7 @@ For details, see .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gethostid.2 b/man2/gethostid.2 deleted file mode 100644 index 3210db030..000000000 --- a/man2/gethostid.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/gethostid.3 diff --git a/man2/gethostname.2 b/man2/gethostname.2 index 67960072c..8984f9107 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 0c82cb56c..89983a2e9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index a9e6422d5..5c76f0c7e 100644 --- a/man2/getpagesize.2 +++ b/man2/getpagesize.2 @@ -43,13 +43,13 @@ Feature Test Macro Requirements for glibc (see Since glibc 2.19: .nf _DEFAULT_SOURCE || ! (_POSIX_C_SOURCE\ >=\ 200112L) -.TP 4 .fi +.TP 4 From glibc 2.12 to 2.19: .nf _BSD_SOURCE || ! (_POSIX_C_SOURCE\ >=\ 200112L) -.TP 4 .fi +.TP 4 Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpeername.2 b/man2/getpeername.2 index b50afc8fc..9edc6b5bb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpid.2 b/man2/getpid.2 index 43c848cc6..4c8e143f3 100644 --- a/man2/getpid.2 +++ b/man2/getpid.2 @@ -165,7 +165,7 @@ for details regarding register mapping. .BR credentials (7), .BR pid_namespaces (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getpriority.2 b/man2/getpriority.2 index 70840ac0d..370159ed2 100644 --- a/man2/getpriority.2 +++ b/man2/getpriority.2 @@ -251,7 +251,7 @@ which may be made standards conformant in the future. .I Documentation/scheduler/sched-nice-design.txt in the Linux kernel source tree (since Linux 2.6.23) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrandom.2 b/man2/getrandom.2 index 3faf9a059..0459ca436 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getresuid.2 b/man2/getresuid.2 index be54e8d4a..d08b64e33 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 425be975b..5fda72cdc 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -853,7 +853,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getrusage.2 b/man2/getrusage.2 index 5334d7228..344988f6d 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -46,7 +46,6 @@ getrusage \- get resource usage .PP .BI "int getrusage(int " who ", struct rusage *" usage ); .SH DESCRIPTION -.PP .BR getrusage () returns resource usage measures for .IR who , @@ -184,7 +183,6 @@ completed (usually to await availability of a resource). The number of times a context switch resulted due to a higher priority process becoming runnable or because the current process exceeded its time slice. -.PP .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and @@ -271,7 +269,7 @@ in .BR wait4 (2), .BR clock (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsid.2 b/man2/getsid.2 index efb1d19d5..9253eb262 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -45,7 +45,6 @@ Feature Test Macro Requirements for glibc (see .RS 4 _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L .RE .PD @@ -96,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockname.2 b/man2/getsockname.2 index cf08504a4..3304f6105 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index 619363b27..444488f0c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettid.2 b/man2/gettid.2 index 407e5f4aa..7115ab8f7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index ac71b663c..1a49c45da 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getuid.2 b/man2/getuid.2 index e3088b70a..25a275178 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getunwind.2 b/man2/getunwind.2 index f5f9a4693..4a2603c93 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/getxattr.2 b/man2/getxattr.2 index f7bfa687f..ee9801a02 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/idle.2 b/man2/idle.2 index 4e2151921..c9311d90b 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.07 of the Linux +This page is part of release 5.08 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 b86a23c19..6f7e02a21 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -287,7 +287,6 @@ See the Linux kernel source file .I include/linux/module.h for some useful background information. .SS Linux 2.4 and earlier -.PP In Linux 2.4 and earlier, the .BR init_module () system call was rather different: @@ -358,7 +357,7 @@ the rest of the module. .BR lsmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 de82d9481..fcfc77af6 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.07 of the Linux +This page is part of release 5.08 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 f7c8655c7..84e2b795e 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.07 of the Linux +This page is part of release 5.08 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 ad06422a3..24ed37a09 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/intro.2 b/man2/intro.2 index 15cc58284..9afe91dc1 100644 --- a/man2/intro.2 +++ b/man2/intro.2 @@ -133,7 +133,7 @@ Note that these can be different from page to page! .BR sysvipc (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 0a390f2d0..d54d71790 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -18,7 +18,6 @@ io_cancel \- cancel an outstanding asynchronous I/O operation .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION -.PP The .BR io_cancel () system call @@ -54,10 +53,8 @@ The AIO context specified by \fIctx_id\fP is invalid. .BR io_cancel () is not implemented on this architecture. .SH VERSIONS -.PP The asynchronous I/O system calls first appeared in Linux 2.5. .SH CONFORMING TO -.PP .BR io_cancel () is Linux-specific and should not be used in programs that are intended to be portable. @@ -100,7 +97,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 9c35d836a..38c59c71e 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -17,7 +17,6 @@ io_destroy \- destroy an asynchronous I/O context .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION -.PP The .BR io_destroy () system call @@ -43,10 +42,8 @@ The AIO context specified by \fIctx_id\fP is invalid. .BR io_destroy () is not implemented on this architecture. .SH VERSIONS -.PP The asynchronous I/O system calls first appeared in Linux 2.5. .SH CONFORMING TO -.PP .BR io_destroy () is Linux-specific and should not be used in programs that are intended to be portable. @@ -89,7 +86,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 a679fa02e..d9db7e847 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -20,7 +20,6 @@ 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 -.PP The .BR io_getevents () system call @@ -80,10 +79,8 @@ out of range. .BR io_getevents () is not implemented on this architecture. .SH VERSIONS -.PP The asynchronous I/O system calls first appeared in Linux 2.5. .SH CONFORMING TO -.PP .BR io_getevents () is Linux-specific and should not be used in programs that are intended to be portable. @@ -123,7 +120,6 @@ An invalid may cause a segmentation fault instead of generating the error .BR EINVAL . .SH SEE ALSO -.PP .BR io_cancel (2), .BR io_destroy (2), .BR io_setup (2), @@ -133,7 +129,7 @@ may cause a segmentation fault instead of generating the error .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 8d2c7d36d..0e8a4e4df 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -17,7 +17,6 @@ io_setup \- create an asynchronous I/O context .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION -.PP The .BR io_setup () system call @@ -58,10 +57,8 @@ Insufficient kernel resources are available. .BR io_setup () is not implemented on this architecture. .SH VERSIONS -.PP The asynchronous I/O system calls first appeared in Linux 2.5. .SH CONFORMING TO -.PP .BR io_setup () is Linux-specific and should not be used in programs that are intended to be portable. @@ -104,7 +101,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 1a1958c6e..853198dd3 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -19,7 +19,6 @@ io_submit \- submit asynchronous I/O blocks for processing .IR Note : There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION -.PP The .BR io_submit () system call @@ -233,10 +232,8 @@ but the submitting context does not have the .B CAP_SYS_ADMIN capability. .SH VERSIONS -.PP The asynchronous I/O system calls first appeared in Linux 2.5. .SH CONFORMING TO -.PP .BR io_submit () is Linux-specific and should not be used in programs that are intended to be portable. @@ -279,7 +276,7 @@ set to a (positive) value that indicates the error. .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioctl.2 b/man2/ioctl.2 index e0533cf55..4ae05d50d 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.07 of the Linux +This page is part of release 5.08 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 dcb350986..89ba73b53 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.07 of the Linux +This page is part of release 5.08 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 57f7809ed..2ddda0628 100644 --- a/man2/ioctl_fat.2 +++ b/man2/ioctl_fat.2 @@ -32,9 +32,9 @@ ioctl_fat \- manipulating the FAT filesystem .BI "int ioctl(int " fd ", FAT_IOCTL_GET_ATTRIBUTES, uint32_t *" attr ); .BI "int ioctl(int " fd ", FAT_IOCTL_SET_ATTRIBUTES, uint32_t *" attr ); .BI "int ioctl(int " fd ", FAT_IOCTL_GET_VOLUME_ID, uint32_t *" id ); -.BI "int ioctl(int " fd ", VFAT_IOCTL_READDIR_BOTH, +.BI "int ioctl(int " fd ", VFAT_IOCTL_READDIR_BOTH," .BI " struct __fat_dirent[2] " entry ); -.BI "int ioctl(int " fd ", VFAT_IOCTL_READDIR_SHORT, +.BI "int ioctl(int " fd ", VFAT_IOCTL_READDIR_SHORT," .BI " struct __fat_dirent[2] " entry ); .fi .SH DESCRIPTION @@ -114,7 +114,7 @@ Typically the volume ID is displayed to the user as a group of two printf("Volume ID %04x-%04x\en", id >> 16, id & 0xFFFF); .EE .in -.SS Reading short file names of a directory +.SS Reading short filenames of a directory A file or directory on a FAT filesystem always has a short filename consisting of up to 8 capital letters, optionally followed by a period and up to 3 capital letters for the file extension. @@ -325,7 +325,7 @@ main(int argc, char *argv[]) * Invert archive attribute. */ printf("Toggling archive flag\en"); - attr ^= ATTR_ARCH; + attr \(ha= ATTR_ARCH; /* * Write the changed FAT file attributes. @@ -424,7 +424,7 @@ The following was recorded when applying the program to the directory $ \fB./fat_dir /mnt/user\fP \[char46] -> '' \[char46]. -> '' -ALONGF~1.TXT -> 'a long filename.txt' +ALONGF\(ti1.TXT -> 'a long filename.txt' UPPER.TXT -> '' LOWER.TXT -> 'lower.txt' .EE @@ -501,7 +501,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 c7473268f..237939814 100644 --- a/man2/ioctl_ficlonerange.2 +++ b/man2/ioctl_ficlonerange.2 @@ -24,7 +24,6 @@ .SH NAME ioctl_ficlonerange, ioctl_ficlone \- share some the data of one file with another file .SH SYNOPSIS -.br .B #include <sys/ioctl.h> .br .B #include <linux/fs.h> @@ -57,7 +56,7 @@ at offset into the file .IR dest_fd at offset -.IR dest_offset ", +.IR dest_offset , provided that both are files. If .IR src_length @@ -86,7 +85,6 @@ ioctl clones entire files. On error, \-1 is returned, and .I errno is set to indicate the error. -.PP .SH ERRORS Error codes can be one of, but are not limited to, the following: .TP @@ -144,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.07 of the Linux +This page is part of release 5.08 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 d9e915ac5..f8a22819c 100644 --- a/man2/ioctl_fideduperange.2 +++ b/man2/ioctl_fideduperange.2 @@ -24,7 +24,6 @@ .SH NAME ioctl_fideduperange \- share some the data of one file with another file .SH SYNOPSIS -.br .B #include <sys/ioctl.h> .br .B #include <linux/fs.h> @@ -53,7 +52,7 @@ This ioctl performs the "compare and share if identical" operation on up to bytes from file descriptor .IR src_fd at offset -.IR src_offset ". +.IR src_offset . This information is conveyed in a structure of the following form: .PP .in +4n @@ -79,7 +78,7 @@ must be zero. Destinations for the deduplication operation are conveyed in the array at the end of the structure. The number of destinations is given in -.IR dest_count ", +.IR dest_count , and the destination information is conveyed in the following form: .PP .in +4n @@ -99,7 +98,7 @@ Each deduplication operation targets bytes in file descriptor .IR dest_fd at offset -.IR dest_offset ". +.IR dest_offset . The field .IR reserved must be zero. @@ -129,7 +128,7 @@ Upon successful completion of this ioctl, the number of bytes successfully deduplicated is returned in .IR bytes_deduped and a status code for the deduplication operation is returned in -.IR status ". +.IR status . If even a single byte in the range does not match, the deduplication request will be ignored and .IR status @@ -142,12 +141,10 @@ code is set to for success, a negative error code in case of error, or .B FILE_DEDUPE_RANGE_DIFFERS if the data did not match. -.PP .SH RETURN VALUE On error, \-1 is returned, and .I errno is set to indicate the error. -.PP .SH ERRORS Error codes can be one of, but are not limited to, the following: .TP @@ -213,7 +210,7 @@ single call. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 e6c35c66d..d905c5f3f 100644 --- a/man2/ioctl_fslabel.2 +++ b/man2/ioctl_fslabel.2 @@ -24,7 +24,6 @@ .SH NAME ioctl_fslabel \- get or set a filesystem label .SH SYNOPSIS -.br .B #include <sys/ioctl.h> .br .B #include <linux/fs.h> @@ -47,7 +46,6 @@ operation requires privilege On success zero is returned. On error, \-1 is returned, and .I errno is set to indicate the error. -.PP .SH ERRORS Error can include (but are not limited to) the following: .TP @@ -88,7 +86,7 @@ will always be null-terminated. .BR ioctl (2), .BR blkid (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 efc1b6fc5..528d4ce53 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -24,7 +24,6 @@ .SH NAME ioctl_getfsmap \- retrieve the physical layout of the filesystem .SH SYNOPSIS -.br .B #include <sys/ioctl.h> .br .B #include <linux/fs.h> @@ -83,7 +82,6 @@ Filesystem mappings are copied into the array, which immediately follows the header data. .\" .SS Fields of struct fsmap_head -.PP The .I fmh_iflags field is a bit mask passed to the kernel to alter the output. @@ -121,7 +119,6 @@ The fields must be set to zero. .\" .SS Keys -.PP The two key records in .I fsmap_head.fmh_keys specify the lowest and highest extent records in the keyspace that the caller @@ -161,7 +158,6 @@ The function provides this functionality. .\" .SS Fields of struct fsmap -.PP The .I fmr_device field uniquely identifies the underlying storage device. @@ -326,7 +322,6 @@ Inode bit map. On error, \-1 is returned, and .I errno is set to indicate the error. -.PP .SH ERRORS The error placed in .I errno @@ -372,7 +367,7 @@ distribution for a sample program. .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 23f3f3ac6..dacde6f45 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.07 of the Linux +This page is part of release 5.08 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 0ea9ab05d..b4cecbb22 100644 --- a/man2/ioctl_ns.2 +++ b/man2/ioctl_ns.2 @@ -215,7 +215,7 @@ $ \fBunshare \-Uu sleep 1000 &\fP [1] 23235 $ \fB./ns_show /proc/23235/ns/uts u\fP Device/Inode of owning user namespace is: [0,3] / 4026532448 -$ \fBreadlink /proc/23235/ns/user \fP +$ \fBreadlink /proc/23235/ns/user\fP user:[4026532448] .EE .in @@ -361,7 +361,7 @@ main(int argc, char *argv[]) .BR proc (5), .BR namespaces (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 d9708fd08..811b3a771 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -32,26 +32,26 @@ whenever possible. .BI "TCGETS struct termios *" argp Equivalent to .IR "tcgetattr(fd, argp)" . -.br +.IP Get the current serial port settings. .TP .BI "TCSETS const struct termios *" argp Equivalent to .IR "tcsetattr(fd, TCSANOW, argp)" . -.br +.IP Set the current serial port settings. .TP .BI "TCSETSW const struct termios *" argp Equivalent to .IR "tcsetattr(fd, TCSADRAIN, argp)" . -.br +.IP Allow the output buffer to drain, and set the current serial port settings. .TP .BI "TCSETSF const struct termios *" argp Equivalent to .IR "tcsetattr(fd, TCSAFLUSH, argp)" . -.br +.IP Allow the output buffer to drain, discard pending input, and set the current serial port settings. .PP @@ -130,7 +130,7 @@ foreground process group. .BI "TCSBRK int " arg Equivalent to .IR "tcsendbreak(fd, arg)" . -.br +.IP If the terminal is using asynchronous serial data transmission, and .I arg is zero, then send a break (a stream of zero bits) for between @@ -165,7 +165,7 @@ So-called "POSIX version" of .BR TCSBRK . It treats nonzero .I arg -as a timeinterval measured in deciseconds, and does nothing +as a time interval measured in deciseconds, and does nothing when the driver does not support breaks. .TP .B "TIOCSBRK void" @@ -178,7 +178,7 @@ Turn break off, that is, stop sending zero bits. .BI "TCXONC int " arg Equivalent to .IR "tcflow(fd, arg)" . -.br +.IP See .BR tcflow (3) for the argument values @@ -201,7 +201,7 @@ Get the number of bytes in the output buffer. .BI "TCFLSH int " arg Equivalent to .IR "tcflush(fd, arg)" . -.br +.IP See .BR tcflush (3) for the argument values @@ -226,7 +226,7 @@ anybody can do this as long as the output was not redirected yet; since version 2.6.10, only a process with the .BR CAP_SYS_ADMIN capability may do this. -If output was redirected already +If output was redirected already, then .B EBUSY is returned, but redirection can be stopped by using this ioctl with @@ -270,13 +270,13 @@ and all processes in the current session lose their controlling terminal. .BI "TIOCGPGRP pid_t *" argp When successful, equivalent to .IR "*argp = tcgetpgrp(fd)" . -.br +.IP Get the process group ID of the foreground process group on this terminal. .TP .BI "TIOCSPGRP const pid_t *" argp Equivalent to .IR "tcsetpgrp(fd, *argp)" . -.br +.IP Set the foreground process group ID of this terminal. .TP .BI "TIOCGSID pid_t *" argp @@ -328,7 +328,7 @@ otherwise). In packet mode, each subsequent .BR read (2) will return a packet that either contains a single nonzero control byte, -or has a single byte containing zero (\(aq\0\(aq) followed by data +or has a single byte containing zero (\(aq\e0\(aq) followed by data written on the slave side of the pseudoterminal. If the first byte is not .B TIOCPKT_DATA @@ -340,18 +340,18 @@ 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^S\fP/\fB^Q\fP. -TIOCPKT_NOSTOP The start and stop characters are not \fB^S\fP/\fB^Q\fP. +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 .IP -While this mode is in use, the presence +While packet mode is in use, the presence of control status information to be read from the master side may be detected by a .BR select (2) for exceptional conditions or a .BR poll (2) for the -.I POLLPRI +.B POLLPRI event. .IP This mode is used by @@ -359,7 +359,7 @@ This mode is used by and .BR rlogind (8) to implement a remote-echoed, -locally \fB^S\fP/\fB^Q\fP flow-controlled remote login. +locally \fB\(haS\fP/\fB\(haQ\fP flow-controlled remote login. .TP .BI "TIOCGPKT const int *" argp (since Linux 3.8) @@ -371,7 +371,7 @@ Set (if .IR *argp is nonzero) or remove (if .IR *argp -is zero) the pseudoterminal slave device. +is zero) the lock on the pseudoterminal slave device. (See also .BR unlockpt (3).) .TP @@ -592,7 +592,7 @@ main(void) .\" TIOCSERSETMULTI const struct serial_multiport_struct * .\" TIOCGSERIAL, TIOCSSERIAL (see above) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 35e660379..4bdc73bfb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 8068095be..38d4dcbd1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/iopl.2 b/man2/iopl.2 index 97de1e454..a919a87f3 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -30,7 +30,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH IOPL 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH IOPL 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iopl \- change I/O privilege level .SH SYNOPSIS @@ -39,29 +39,18 @@ iopl \- change I/O privilege level .BI "int iopl(int " level ); .SH DESCRIPTION .BR iopl () -changes the I/O privilege level of the calling process, +changes the I/O privilege level of the calling thread, as specified by the two least significant bits in .IR level . .PP -This call is necessary to allow 8514-compatible X servers to run under -Linux. -Since these X servers require access to all 65536 I/O ports, the -.BR ioperm (2) -call is not sufficient. +The I/O privilege level for a normal thread is 0. +Permissions are inherited from parents to children. .PP -In addition to granting unrestricted I/O port access, running at a higher -I/O privilege level also allows the process to disable interrupts. -This will probably crash the system, and is not recommended. -.PP -Permissions are not inherited by the child process created by -.BR fork (2) -and are not preserved across -.BR execve (2) -(but see NOTES). -.PP -The I/O privilege level for a normal process is 0. -.PP -This call is mostly for the i386 architecture. +This call is deprecated, is significantly slower than +.BR ioperm (2), +and is only provided for older X servers which require +access to all 65536 I/O ports. +It is mostly for the i386 architecture. On many other architectures it does not exist or will always return an error. .SH RETURN VALUE @@ -79,7 +68,7 @@ is greater than 3. This call is unimplemented. .TP .B EPERM -The calling process has insufficient privilege to call +The calling thread has insufficient privilege to call .BR iopl (); the .B CAP_SYS_RAWIO @@ -99,6 +88,12 @@ and in .IR <sys/perm.h> . Avoid the latter, it is available on i386 only. .PP +Prior to Linux 5.5 +.BR iopl () +allowed the thread to disable interrupts while running +at a higher I/O privilege level. +This will probably crash the system, and is not recommended. +.PP Prior to Linux 3.7, on some architectures (such as i386), permissions .I were @@ -113,7 +108,7 @@ and won't be reinstated. .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 6b81bb1a3..d8de47b39 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ipc.2 b/man2/ipc.2 index 29b26237f..0407c75a9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 1f6a1d1f6..7d4b2ed40 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -429,7 +429,7 @@ main(int argc, char *argv[]) .BR clone (2), .BR unshare (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 26224537d..4fcf14f5c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/keyctl.2 b/man2/keyctl.2 index 29117351d..a68e9d437 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -82,27 +82,27 @@ The following values may be specified in .B KEY_SPEC_THREAD_KEYRING This specifies the calling thread's thread-specific keyring. See -.BR thread-keyring (7). +.BR thread\-keyring (7). .TP .B KEY_SPEC_PROCESS_KEYRING This specifies the caller's process-specific keyring. See -.BR process-keyring (7). +.BR process\-keyring (7). .TP .B KEY_SPEC_SESSION_KEYRING This specifies the caller's session-specific keyring. See -.BR session-keyring (7). +.BR session\-keyring (7). .TP .B KEY_SPEC_USER_KEYRING This specifies the caller's UID-specific keyring. See -.BR user-keyring (7). +.BR user\-keyring (7). .TP .B KEY_SPEC_USER_SESSION_KEYRING This specifies the caller's UID-session keyring. See -.BR user-session-keyring (7). +.BR user\-session\-keyring (7). .TP .BR KEY_SPEC_REQKEY_AUTH_KEY " (since Linux 2.6.16)" .\" commit b5f545c880a2a47947ba2118b2509644ab7a2969 @@ -110,7 +110,7 @@ This specifies the authorization key created by .BR request_key (2) and passed to the process it spawns to generate a key. This key is available only in a -.BR request-key (8)-style +.BR request\-key (8)-style program that was passed an authorization key by the kernel and ceases to be available once the requested key has been instantiated; see .BR request_key (2). @@ -121,7 +121,7 @@ This specifies the key ID for the .BR request_key (2) destination keyring. This keyring is available only in a -.BR request-key (8)-style +.BR request\-key (8)-style program that was passed an authorization key by the kernel and ceases to be available once the requested key has been instantiated; see .BR request_key (2). @@ -592,9 +592,9 @@ Writing to the buffer is attempted only when is non-NULL and the specified buffer size is large enough to accept the descriptive string (including the terminating null byte). -'\" Function commentary says it copies up to buflen bytes, but see the -'\" (buffer && buflen >= ret) condition in keyctl_describe_key() in -'\" security/keyctl.c +.\" Function commentary says it copies up to buflen bytes, but see the +.\" (buffer && buflen >= ret) condition in keyctl_describe_key() in +.\" security/keyctl.c In order to determine whether the buffer size was too small, check to see if the return value of the operation is greater than .IR arg4 . @@ -875,7 +875,7 @@ The caller must have the appropriate authorization key, and once the uninstantiated key has been instantiated, the authorization key is revoked. In other words, this operation is available only from a -.BR request-key (8)-style +.BR request\-key (8)-style program. See .BR request_key (2) @@ -963,7 +963,7 @@ Use the UID-specific session keyring as the new default keyring. .TP .BR KEY_REQKEY_DEFL_REQUESTOR_KEYRING " (since Linux 2.6.29)" -'\" 8bbf4976b59fc9fc2861e79cab7beb3f6d647640 +.\" 8bbf4976b59fc9fc2861e79cab7beb3f6d647640 Use the requestor keyring. .\" FIXME The preceding explanation needs to be expanded. .\" Is the following correct: @@ -1070,7 +1070,7 @@ associated with the specified key. (In other words, the .BR KEYCTL_ASSUME_AUTHORITY operation is available only from a -.BR request-key (8)-style +.BR request\-key (8)-style program; see .BR request_key (2) for an explanation of how this operation is used.) @@ -1093,7 +1093,7 @@ and the value 0 is returned. The .BR KEYCTL_ASSUME_AUTHORITY mechanism allows a program such as -.BR request-key (8) +.BR request\-key (8) to assume the necessary authority to instantiate a new uninstantiated key that was created as a consequence of a call to .BR request_key (2). @@ -1249,7 +1249,7 @@ whose ID is specified in .IP The caller must have the appropriate authorization key. In other words, this operation is available only from a -.BR request-key (8)-style +.BR request\-key (8)-style program. See .BR request_key (2). @@ -1258,7 +1258,7 @@ The caller must have the appropriate authorization key, and once the uninstantiated key has been instantiated, the authorization key is revoked. In other words, this operation is available only from a -.BR request-key (8)-style +.BR request\-key (8)-style program. See .BR request_key (2) @@ -1445,7 +1445,7 @@ permission. The payloads of these keys are used to calculate the Diffie-Hellman result as: .IP - base ^ private mod prime + base \(ha private mod prime .IP If the base is the shared generator, the result is the local public key. If the base is the remote public key, the result is the shared secret. @@ -1963,7 +1963,7 @@ you probably want to use the various library functions mentioned in the descriptions of individual operations above. .SH EXAMPLES The program below provide subset of the functionality of the -.BR request-key (8) +.BR request\-key (8) program provided by the .I keyutils package. @@ -1973,7 +1973,7 @@ the program records various information in a log file. As described in .BR request_key (2), the -.BR request-key (8) +.BR request\-key (8) program is invoked with command-line arguments that describe a key that is to be instantiated. The example program fetches and logs these arguments. @@ -1983,10 +1983,10 @@ and then instantiates that key. The following shell session demonstrates the use of this program. In the session, we compile the program and then use it to temporarily replace the standard -.BR request-key (8) +.BR request\-key (8) program. (Note that temporarily disabling the standard -.BR request-key (8) +.BR request\-key (8) program may not be safe on some systems.) While our example program is installed, we use the example program shown in @@ -2009,7 +2009,7 @@ we can see the command-line arguments supplied to our example program: .PP .in +4n .EX -$ \fBcat /tmp/key_instantiate.log \fP +$ \fBcat /tmp/key_instantiate.log\fP Time: Mon Nov 7 13:06:47 2016 Command line arguments: @@ -2103,6 +2103,7 @@ main(int argc, char *argv[]) char dbuf[256]; char auth_key_payload[256]; int akp_size; /* Size of auth_key_payload */ + int auth_key; fp = fopen("/tmp/key_instantiate.log", "w"); if (fp == NULL) @@ -2284,7 +2285,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/kill.2 b/man2/kill.2 index 8eef7adf9..fc76b831c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/killpg.2 b/man2/killpg.2 deleted file mode 100644 index 0ced86260..000000000 --- a/man2/killpg.2 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/killpg.3 -.\" Eventually, this link will be removed. Added in Nov 2016 diff --git a/man2/link.2 b/man2/link.2 index 967f47091..7a90eb59b 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -431,7 +431,7 @@ to find out if the link got created. .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listen.2 b/man2/listen.2 index 2aed34004..5c5013fca 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/listxattr.2 b/man2/listxattr.2 index bfa530e02..6cba358d4 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -203,9 +203,9 @@ and then listing the attributes with the example program. .in +4n .EX $ \fBtouch /tmp/foo\fP -$ \fBsetfattr -n user.fred -v chocolate /tmp/foo\fP -$ \fBsetfattr -n user.frieda -v bar /tmp/foo\fP -$ \fBsetfattr -n user.empty /tmp/foo\fP +$ \fBsetfattr \-n user.fred \-v chocolate /tmp/foo\fP +$ \fBsetfattr \-n user.frieda \-v bar /tmp/foo\fP +$ \fBsetfattr \-n user.empty /tmp/foo\fP $ \fB./listxattr /tmp/foo\fP user.fred: chocolate user.frieda: bar @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR symlink (7), .BR xattr (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/llseek.2 b/man2/llseek.2 index c08391255..0277cea31 100644 --- a/man2/llseek.2 +++ b/man2/llseek.2 @@ -96,7 +96,7 @@ wrapper function instead. .BR open (2), .BR lseek64 (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 6b26b9d09..576cae8a7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/lseek.2 b/man2/lseek.2 index d748c60d4..8ceb6ab9e 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1980, 1991 Regents of the University of California. .\" and Copyright (c) 2011, Michael Kerrisk <mtk.manpages@gmail.com> .\" All rights reserved. @@ -44,7 +43,7 @@ .\" Modified 2003-08-21 by Andries Brouwer <aeb@cwi.nl> .\" 2011-09-18, mtk, Added SEEK_DATA + SEEK_HOLE .\" -.TH LSEEK 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH LSEEK 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME lseek \- reposition read/write file offset .SH SYNOPSIS @@ -182,6 +181,9 @@ NFS (since Linux 3.18) .IP * FUSE (since Linux 4.5) .\" commit 0b5da8db145bfd44266ac964a2636a0cf8d7c286 +.IP * +GFS2 (since Linux 4.15) +.\" commit 3a27411cb4bc3ce31db228e3569ad01b462a4310 .SH RETURN VALUE Upon successful completion, .BR lseek () @@ -276,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/madvise.2 b/man2/madvise.2 index 43487a1fc..c960ef53a 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -241,7 +241,7 @@ Undo the effect of restoring the default behavior, whereby a mapping is inherited across .BR fork (2). .TP -.BR MADV_HWPOISON " (since Linux 2.6.32) +.BR MADV_HWPOISON " (since Linux 2.6.32)" .\" commit 9893e49d64a4874ea67849ee2cfbf3f3d6817573 Poison the pages in the range specified by .I addr @@ -297,7 +297,7 @@ KSM unmerges whatever pages it had merged in the address range specified by and .IR length . .TP -.BR MADV_SOFT_OFFLINE " (since Linux 2.6.33) +.BR MADV_SOFT_OFFLINE " (since Linux 2.6.33)" .\" commit afcf938ee0aac4ef95b1a23bac704c6fbeb26de6 Soft offline the pages in the range specified by .I addr @@ -348,7 +348,7 @@ behavior by default, and thus .BR MADV_HUGEPAGE is normally not necessary. It is mostly intended for embedded systems, where -.BR MADV_HUGEPAGE -stye +.BR MADV_HUGEPAGE -style behavior may not be enabled by default in the kernel. On such systems, this flag can be used in order to selectively enable THP. @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mbind.2 b/man2/mbind.2 index 16b82baa5..f2fd0933e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/membarrier.2 b/man2/membarrier.2 index c6b89755c..929c9db0e 100644 --- a/man2/membarrier.2 +++ b/man2/membarrier.2 @@ -28,7 +28,7 @@ membarrier \- issue memory barriers on a set of threads .SH SYNOPSIS .B #include <linux/membarrier.h> .PP -.BI "int membarrier(int " cmd ", int " flags "); +.BI "int membarrier(int " cmd ", int " flags ");" .SH DESCRIPTION The .BR membarrier () @@ -414,7 +414,7 @@ main(int argc, char **argv) .EE .in .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 3b34c67d1..523beeeca 100644 --- a/man2/memfd_create.2 +++ b/man2/memfd_create.2 @@ -205,7 +205,6 @@ The .BR memfd_create () system call is Linux-specific. .SH NOTES -.PP .\" See also http://lwn.net/Articles/593918/ .\" and http://lwn.net/Articles/594919/ and http://lwn.net/Articles/591108/ The @@ -549,7 +548,7 @@ main(int argc, char *argv[]) .BR shmget (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 7b77a9549..3c80f9bdb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mincore.2 b/man2/mincore.2 index 3ace64af7..39c6165a8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 19da0330b..ccf6b0bd6 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -56,7 +56,7 @@ It is modified by the process's .I umask in the usual way: in the absence of a default ACL, the mode of the created directory is -.RI ( mode " & ~" umask " & 0777)." +.RI ( mode " & \(ti" umask " & 0777)." Whether other .I mode bits are honored for the created directory depends on the operating system. @@ -66,9 +66,9 @@ The newly created directory will be owned by the effective user ID of the process. If the directory containing the file has the set-group-ID bit set, or if the filesystem is mounted with BSD group semantics -.RI ( "mount -o bsdgroups" +.RI ( "mount \-o bsdgroups" or, synonymously -.IR "mount -o grpid" ), +.IR "mount \-o grpid" ), the new directory will inherit the group ownership from its parent; otherwise it will be owned by the effective group ID of the process. .PP @@ -252,7 +252,7 @@ argument. .BR acl (5), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mknod.2 b/man2/mknod.2 index dca0589cf..6817269b0 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -12,7 +12,7 @@ .\" Modified 2003-04-23 by Michael Kerrisk .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH MKNOD 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MKNOD 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mknod, mknodat \- create a special or ordinary file .SH SYNOPSIS @@ -68,7 +68,7 @@ The file mode is modified by the process's .I umask in the usual way: in the absence of a default ACL, the permissions of the created node are -.RI ( mode " & ~" umask ). +.RI ( mode " & \(ti" umask ). .PP The file type must be one of .BR S_IFREG , @@ -301,7 +301,7 @@ and .BR acl (5), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mlock.2 b/man2/mlock.2 index 1aa17b0d3..0340966a6 100644 --- a/man2/mlock.2 +++ b/man2/mlock.2 @@ -89,7 +89,6 @@ Lock pages that are currently resident and mark the entire range so that the remaining nonresident pages are locked when they are populated by a page fault. .PP -.PP If .I flags is 0, @@ -498,7 +497,7 @@ resource limit is encountered. .BR proc (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap.2 b/man2/mmap.2 index 491869741..b1fb9f031 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-04-11 "Linux" "Linux Programmer's Manual" +.TH MMAP 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mmap, munmap \- map or unmap files or devices into memory .SH SYNOPSIS @@ -226,7 +226,7 @@ This flag is ignored. .\" Introduced in 1.1.36, removed in 1.3.24. (Long ago\(emLinux 2.0 and earlier\(emit signaled that attempts to write to the underlying file should fail with -.BR ETXTBUSY . +.BR ETXTBSY . But this was a source of denial-of-service attacks.) .TP .B MAP_EXECUTABLE @@ -670,7 +670,6 @@ is defined in \fI<unistd.h>\fP to a value greater than 0. .\" -1: unavailable, 0: ask using sysconf(). .\" glibc defines it to 1. .SH NOTES -.PP Memory mapped by .BR mmap () is preserved across @@ -765,7 +764,7 @@ making it easy for a multithreaded process to corrupt its own address space. .PP For example, suppose that thread A looks through .I /proc/<pid>/maps -and in order to locate an unused address range that it can map using +in order to locate an unused address range that it can map using .BR MAP_FIXED , while thread B simultaneously acquires part or all of that same address range. @@ -907,7 +906,6 @@ however, this doesn't work on .SH EXAMPLES .\" FIXME . Add an example here that uses an anonymous shared region for .\" IPC between parent and child. -.PP The following program prints part of the file specified in its first command-line argument to standard output. The range of bytes to be printed is specified via offset and length @@ -951,7 +949,7 @@ main(int argc, char *argv[]) handle_error("fstat"); offset = atoi(argv[2]); - pa_offset = offset & ~(sysconf(_SC_PAGE_SIZE) \- 1); + pa_offset = offset & \(ti(sysconf(_SC_PAGE_SIZE) \- 1); /* offset for mmap() must be page aligned */ if (offset >= sb.st_size) { @@ -1018,7 +1016,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mmap2.2 b/man2/mmap2.2 index 89df50fde..81d0f1a45 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.07 of the Linux +This page is part of release 5.08 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 624cd9d7e..6983dc8b5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mount.2 b/man2/mount.2 index 7ff16557f..d347ede95 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 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH MOUNT 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mount \- mount filesystem .SH SYNOPSIS @@ -709,6 +709,22 @@ was attempted, but was not a mount point, or was \(aq/\(aq. .TP .B EINVAL +A bind operation +.RB ( MS_BIND ) +was requested where +.I source +referred a mount namespace magic link (i.e., a +.I /proc/[pid]/ns/mnt +magic link or a bind mount to such a link) +and the propagation type of the parent mount of +.I target +was +.BR MS_SHARED , +.\" See commit 8823c079ba7136dc1948d6f6dcb5f8022bde438e +but propagation of the requested bind mount could lead to a circular +dependency that might prevent the mount namespace from ever being freed. +.TP +.B EINVAL .I mountflags includes more than one of .BR MS_SHARED , @@ -934,7 +950,7 @@ for details of this file. .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 f6133a183..47cbffaf7 100644 --- a/man2/move_pages.2 +++ b/man2/move_pages.2 @@ -128,36 +128,36 @@ array. .B 0..MAX_NUMNODES Identifies the node on which the page resides. .TP -.B -EACCES +.B \-EACCES The page is mapped by multiple processes and can be moved only if .B MPOL_MF_MOVE_ALL is specified. .TP -.B -EBUSY +.B \-EBUSY The page is currently busy and cannot be moved. Try again later. This occurs if a page is undergoing I/O or another kernel subsystem is holding a reference to the page. .TP -.B -EFAULT +.B \-EFAULT This is a zero page or the memory area is not mapped by the process. .TP -.B -EIO +.B \-EIO Unable to write back a page. The page has to be written back in order to move it since the page is dirty and the filesystem does not provide a migration function that would allow the move of dirty pages. .TP -.B -EINVAL +.B \-EINVAL A dirty page cannot be moved. The filesystem does not provide a migration function and has no ability to write back pages. .TP -.B -ENOENT +.B \-ENOENT The page is not present. .TP -.B -ENOMEM +.B \-ENOMEM Unable to allocate memory on target node. .SH RETURN VALUE On success @@ -258,7 +258,7 @@ or a similar package. .BR migratepages (8), .BR numastat (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mprotect.2 b/man2/mprotect.2 index c43f3e00d..aba6dbb99 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -42,7 +42,7 @@ mprotect, pkey_mprotect \- set protection on a region of memory .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <sys/mman.h> .PP -.BI "int pkey_mprotect(void *" addr ", size_t " len ", int " prot ", int " pkey "); +.BI "int pkey_mprotect(void *" addr ", size_t " len ", int " prot ", int " pkey ");" .fi .SH DESCRIPTION .BR mprotect () @@ -285,7 +285,6 @@ is equivalent to .BR mprotect (). .SH EXAMPLES .\" sigaction.2 refers to this example -.PP The program below demonstrates the use of .BR mprotect (). The program allocates four pages of memory, makes the third @@ -374,7 +373,7 @@ main(int argc, char *argv[]) .BR sysconf (3), .BR pkeys (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 887a3e09b..96626362d 100644 --- a/man2/mq_getsetattr.2 +++ b/man2/mq_getsetattr.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_GETSETATTR 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MQ_GETSETATTR 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mq_getsetattr \- get/set message queue attributes .SH SYNOPSIS @@ -57,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/mq_notify.2 b/man2/mq_notify.2 deleted file mode 100644 index fda80ff9b..000000000 --- a/man2/mq_notify.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/mq_notify.3 diff --git a/man2/mq_open.2 b/man2/mq_open.2 deleted file mode 100644 index 54b476688..000000000 --- a/man2/mq_open.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/mq_open.3 diff --git a/man2/mq_timedreceive.2 b/man2/mq_timedreceive.2 deleted file mode 100644 index 9fed5f293..000000000 --- a/man2/mq_timedreceive.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/mq_receive.3 diff --git a/man2/mq_timedsend.2 b/man2/mq_timedsend.2 deleted file mode 100644 index 28b1eff0a..000000000 --- a/man2/mq_timedsend.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/mq_send.3 diff --git a/man2/mq_unlink.2 b/man2/mq_unlink.2 deleted file mode 100644 index 4e72f110b..000000000 --- a/man2/mq_unlink.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/mq_unlink.3 diff --git a/man2/mremap.2 b/man2/mremap.2 index bcd7246f7..4edac2390 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -265,7 +265,6 @@ intended to be portable. .\" .BR mremap (2) .\" call with completely different semantics. .SH NOTES -.PP .BR mremap () changes the mapping between virtual addresses and memory pages. @@ -365,10 +364,10 @@ in this scenario. Your favorite text book on operating systems for more information on paged memory (e.g., \fIModern Operating Systems\fP by Andrew S.\& Tanenbaum, -\fIInside Linux\fP by Randolf Bentson, +\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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgctl.2 b/man2/msgctl.2 index bb0d46de8..b2538e1a9 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -452,7 +452,7 @@ flag in .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgget.2 b/man2/msgget.2 index a9feaa76b..1511c6c34 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msgop.2 b/man2/msgop.2 index 40f20effb..9a8a2937c 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -715,7 +715,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/msync.2 b/man2/msync.2 index dc375d6da..5b5f96a54 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index 329688f05..9fe5ecc3e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nfsservctl.2 b/man2/nfsservctl.2 index 37a44c74e..5f8e199ab 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/nice.2 b/man2/nice.2 index e2202533b..6f4be0d4a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/open.2 b/man2/open.2 index 4224f2c86..fc3a5c96f 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -68,7 +68,7 @@ open, openat, creat \- open and possibly create a file .PP /* Documented separately, in \fBopenat2\fP(2): */ .BI "int openat2(int " dirfd ", const char *" pathname , -.BI " const struct open_how *" how ", size_t " size "); +.BI " const struct open_how *" how ", size_t " size ");" .fi .PP .in -4n @@ -286,37 +286,49 @@ mount options described in .BR mount (8). .\" As at 2.6.25, bsdgroups is supported by ext2, ext3, ext4, and .\" XFS (since 2.6.14). -.RS -.PP +.IP The .I mode -argument specifies the file mode bits be applied when a new file is created. -This argument must be supplied when +argument specifies the file mode bits to be applied when a new file is created. +If neither .B O_CREAT -or +nor .B O_TMPFILE is specified in -.IR flags ; -if neither +.IR flags , +then +.I mode +is ignored (and can thus be specified as 0, or simply omitted). +The +.I mode +argument +.B must +be supplied if .B O_CREAT -nor +or .B O_TMPFILE -is specified, then -.I mode -is ignored. +is specified in +.IR flags ; +if it is not supplied, +some arbitrary bytes from the stack will be applied as the file mode. +.IP The effective mode is modified by the process's .I umask in the usual way: in the absence of a default ACL, the mode of the created file is -.IR "(mode\ &\ ~umask)" . -Note that this mode applies only to future accesses of the +.IR "(mode\ &\ \(tiumask)" . +.IP +Note that +.I mode +applies only to future accesses of the newly created file; the .BR open () call that creates a read-only file may well return a read/write file descriptor. -.PP +.IP The following symbolic constants are provided for .IR mode : +.RS .TP 9 .B S_IRWXU 00700 user (file owner) has read, write, and execute permission @@ -1192,7 +1204,7 @@ does not support refers to a regular file that is too large to be opened. The usual scenario here is that an application compiled on a 32-bit platform without -.I -D_FILE_OFFSET_BITS=64 +.I \-D_FILE_OFFSET_BITS=64 tried to open a file whose size exceeds .I (1<<31)-1 bytes; @@ -1236,7 +1248,7 @@ flag was specified. .TP .B ETXTBSY .I pathname -refers to a file that is currently being read by the kernel (e.g. for +refers to a file that is currently being read by the kernel (e.g., for module/firmware loading), and write access was requested. .TP .B EWOULDBLOCK @@ -1687,7 +1699,7 @@ When these APIs are given a argument of .BR AT_FDCWD or the specified pathname is absolute, -then they handle their pathname argument in the same was as +then they handle their pathname argument in the same way as the corresponding conventional APIs. However, in this case, several of the APIs have a .I flags @@ -1696,7 +1708,6 @@ the corresponding conventional APIs. .\" .\" .SS O_DIRECT -.PP The .B O_DIRECT flag may impose alignment restrictions on the length and address @@ -1723,9 +1734,11 @@ The logical block size can be determined using the .B BLKSSZGET operation or from the shell using the command: .PP +.in +4n .EX - blockdev \-\-getss +blockdev \-\-getss .EE +.in .PP .B O_DIRECT I/Os should never be run concurrently with the @@ -1878,7 +1891,7 @@ is ignored). .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 03a0956bb..2bb819f03 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/openat2.2 b/man2/openat2.2 index 415a4f70d..be2f574a9 100644 --- a/man2/openat2.2 +++ b/man2/openat2.2 @@ -32,7 +32,7 @@ openat2 \- open and possibly create a file (extended) .B #include <openat2.h> .PP .BI "int openat2(int " dirfd ", const char *" pathname , -.BI " struct open_how *" how ", size_t " size "); +.BI " struct open_how *" how ", size_t " size ");" .fi .PP .IR Note : @@ -72,7 +72,7 @@ is an absolute pathname, then is ignored (unless .I how.resolve contains -.BR RESOLVE_IN_ROOT, +.BR RESOLVE_IN_ROOT , in which case .I pathname is resolved relative to @@ -223,11 +223,11 @@ If a prefix component of equates to .IR dirfd , then an immediately following -.IR .. +.IR ..\& component likewise equates to .IR dirfd (just as -.I /.. +.I /..\& is traditionally equivalent to .IR / ). If @@ -320,7 +320,7 @@ This option implies If the trailing component (i.e., basename) of .I pathname is a symbolic link, -.I how.resolve +.I how.resolve contains .BR RESOLVE_NO_SYMLINKS , and @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/outb.2 b/man2/outb.2 index 5f98ab65f..617d90579 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pause.2 b/man2/pause.2 index ce187865f..3f89449fa 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.07 of the Linux +This page is part of release 5.08 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 15d9ffd59..0399fe483 100644 --- a/man2/pciconfig_read.2 +++ b/man2/pciconfig_read.2 @@ -20,7 +20,6 @@ pciconfig_read, pciconfig_write, pciconfig_iobase \- pci device information hand .BI " unsigned long " devfn ); .fi .SH DESCRIPTION -.PP Most of the interaction with PCI devices is already handled by the kernel PCI layer, and thus these calls should not normally need to be accessed from user space. @@ -114,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.07 of the Linux +This page is part of release 5.08 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 f28391850..b72a2b6ed 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -74,7 +74,6 @@ event periodically writes measurements to a buffer that can then be accessed via .BR mmap (2). .SS Arguments -.PP The .I pid and @@ -1759,7 +1758,7 @@ where perf sample data begins. Contains the size of the perf sample region within the mmap buffer. .TP -.IR aux_head ", " aux_tail ", " aux_offset ", " aux_size " (since Linux 4.1) +.IR aux_head ", " aux_tail ", " aux_offset ", " aux_size " (since Linux 4.1)" .\" commit 45bfb2e50471abbbfd83d40d28c986078b0d24ff The AUX region allows mmaping a separate sample buffer for high-bandwidth data streams (separate from the main perf sample buffer). @@ -2275,7 +2274,7 @@ 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 ", " PERF_SAMPLE_REGS_ABI_32 " or" .BR PERF_SAMPLE_REGS_ABI_64 . .IP The @@ -2602,7 +2601,7 @@ is a string describing the backing of the allocated memory. .RE .TP .BR PERF_RECORD_AUX " (since Linux 4.1)" -\" commit 68db7e98c3a6ebe7284b6cf14906ed7c55f3f7f0 +.\" commit 68db7e98c3a6ebe7284b6cf14906ed7c55f3f7f0 This record reports that new data is available in the separate AUX buffer region. .IP @@ -2639,7 +2638,7 @@ if set, then the data returned has overwritten previous data. .RE .TP .BR PERF_RECORD_ITRACE_START " (since Linux 4.1)" -\" ec0d7729bbaed4b9d2d3fada693278e13a3d1368 +.\" ec0d7729bbaed4b9d2d3fada693278e13a3d1368 This record indicates which process has initiated an instruction trace event, allowing tools to properly correlate the instruction addresses in the AUX buffer with the proper executable. @@ -2662,7 +2661,7 @@ thread ID of the thread starting an instruction trace. .RE .TP .BR PERF_RECORD_LOST_SAMPLES " (since Linux 4.2)" -\" f38b0dbb491a6987e198aa6b428db8692a6480f8 +.\" f38b0dbb491a6987e198aa6b428db8692a6480f8 When using hardware sampling (such as Intel PEBS) this record indicates some number of samples that may have been lost. .IP @@ -2681,7 +2680,7 @@ the number of potentially lost samples. .RE .TP .BR PERF_RECORD_SWITCH " (since Linux 4.3)" -\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 +.\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 This record indicates a context switch has happened. The .B PERF_RECORD_MISC_SWITCH_OUT @@ -2699,7 +2698,7 @@ struct { .EE .TP .BR PERF_RECORD_SWITCH_CPU_WIDE " (since Linux 4.3)" -\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 +.\" commit 45ac1403f564f411c6a383a2448688ba8dd705a4 As with .B PERF_RECORD_SWITCH this record indicates a context switch has happened, @@ -2813,7 +2812,6 @@ in a process's context. To restore the old behavior, write the value 2 to .IR /sys/devices/cpu/rdpmc . .SS perf_event ioctl calls -.PP Various ioctls act on .BR perf_event_open () file descriptors: @@ -3008,7 +3006,6 @@ to the calling process or inherited events from a parent process. Only group leaders are enabled and disabled, not any other members of the groups. .SS perf_event related configuration files -.PP Files in .I /proc/sys/kernel/ .RS 4 @@ -3460,7 +3457,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2 index 30c6bcd57..c095f8b22 100644 --- a/man2/perfmonctl.2 +++ b/man2/perfmonctl.2 @@ -32,7 +32,7 @@ perfmonctl \- interface to IA-64 performance monitoring unit .B #include <syscall.h> .B #include <perfmon.h> .PP -.BI "long perfmonctl(int " fd ", int " cmd ", void *" arg ", int " narg "); +.BI "long perfmonctl(int " fd ", int " cmd ", void *" arg ", int " narg ");" .fi .IR Note : There is no glibc wrapper for this system call; see NOTES. @@ -61,7 +61,7 @@ are: .TP .B PFM_CREATE_CONTEXT .nf -.BI "perfmonctl(int " fd ", PFM_CREATE_CONTEXT, pfarg_context_t *" ctxt ", 1); +.BI "perfmonctl(int " fd ", PFM_CREATE_CONTEXT, pfarg_context_t *" ctxt ", 1);" .fi Set up a context. .IP @@ -91,13 +91,13 @@ on the file descriptor. .B PFM_WRITE_PMCS .\" pfm_write_pmcs() .nf -.BI "perfmonctl(int " fd ", PFM_WRITE_PMCS, pfarg_reg_t *" pmcs ", n); +.BI "perfmonctl(int " fd ", PFM_WRITE_PMCS, pfarg_reg_t *" pmcs ", n);" .fi Set PMC registers. .TP .B PFM_WRITE_PMDS .nf -.BI "perfmonctl(int " fd ", PFM_WRITE_PMDS, pfarg_reg_t *" pmds ", n); +.BI "perfmonctl(int " fd ", PFM_WRITE_PMDS, pfarg_reg_t *" pmds ", n);" .fi .\" pfm_write_pmds() Set PMD registers. @@ -105,7 +105,7 @@ Set PMD registers. .B PFM_READ_PMDS .\" pfm_read_pmds() .nf -.BI "perfmonctl(int " fd ", PFM_READ_PMDS, pfarg_reg_t *" pmds ", n); +.BI "perfmonctl(int " fd ", PFM_READ_PMDS, pfarg_reg_t *" pmds ", n);" .fi Read PMD registers. .TP @@ -113,48 +113,48 @@ Read PMD registers. .\" pfm_start() .nf .\" .BI "perfmonctl(int " fd ", PFM_START, arg, 1); -.BI "perfmonctl(int " fd ", PFM_START, NULL, 0); +.BI "perfmonctl(int " fd ", PFM_START, NULL, 0);" .fi Start monitoring. .TP .B PFM_STOP .\" pfm_stop() .nf -.BI "perfmonctl(int " fd ", PFM_STOP, NULL, 0); +.BI "perfmonctl(int " fd ", PFM_STOP, NULL, 0);" .fi Stop monitoring. .TP .B PFM_LOAD_CONTEXT .\" pfm_context_load() .nf -.BI "perfmonctl(int " fd ", PFM_LOAD_CONTEXT, pfarg_load_t *" largs ", 1); +.BI "perfmonctl(int " fd ", PFM_LOAD_CONTEXT, pfarg_load_t *" largs ", 1);" .fi Attach the context to a thread. .TP .B PFM_UNLOAD_CONTEXT .\" pfm_context_unload() .nf -.BI "perfmonctl(int " fd ", PFM_UNLOAD_CONTEXT, NULL, 0); +.BI "perfmonctl(int " fd ", PFM_UNLOAD_CONTEXT, NULL, 0);" .fi Detach the context from a thread. .TP .B PFM_RESTART .\" pfm_restart() .nf -.BI "perfmonctl(int " fd ", PFM_RESTART, NULL, 0); +.BI "perfmonctl(int " fd ", PFM_RESTART, NULL, 0);" .fi Restart monitoring after receiving an overflow notification. .TP .B PFM_GET_FEATURES .\" pfm_get_features() .nf -.BI "perfmonctl(int " fd ", PFM_GET_FEATURES, pfarg_features_t *" arg ", 1); +.BI "perfmonctl(int " fd ", PFM_GET_FEATURES, pfarg_features_t *" arg ", 1);" .fi .TP .B PFM_DEBUG .\" pfm_debug() .nf -.BI "perfmonctl(int " fd ", PFM_DEBUG, " val ", 0); +.BI "perfmonctl(int " fd ", PFM_DEBUG, " val ", 0);" .fi If .I val @@ -163,7 +163,7 @@ is nonzero, enable debugging mode, otherwise disable. .B PFM_GET_PMC_RESET_VAL .\" pfm_get_pmc_reset() .nf -.BI "perfmonctl(int " fd ", PFM_GET_PMC_RESET_VAL, pfarg_reg_t *" req ", n); +.BI "perfmonctl(int " fd ", PFM_GET_PMC_RESET_VAL, pfarg_reg_t *" req ", n);" .fi Reset PMC registers to default values. .\" @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/personality.2 b/man2/personality.2 index 2070e6a2e..9ae2688c8 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.07 of the Linux +This page is part of release 5.08 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 fa851600d..56d78113a 100644 --- a/man2/pidfd_getfd.2 +++ b/man2/pidfd_getfd.2 @@ -82,7 +82,6 @@ is not a valid PID file descriptor. .I targetfd is not an open file descriptor in the process referred to by .IR pidfd . -.BR .TP .B EINVAL .I flags @@ -156,7 +155,7 @@ ptrace access mode check. .BR kcmp (2), .BR pidfd_open (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 c4fe787d9..dde17d70d 100644 --- a/man2/pidfd_open.2 +++ b/man2/pidfd_open.2 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PIDFD_OPEN 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH PIDFD_OPEN 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME pidfd_open \- obtain a file descriptor that refers to a process .SH SYNOPSIS @@ -111,14 +111,14 @@ call, its PID will not have been recycled and the returned file descriptor will refer to the resulting zombie process. Note, however, that this is guaranteed only if the following conditions hold true: -.IP * 3 +.IP \(bu 2 the disposition of .BR SIGCHLD has not been explicitly set to .BR SIG_IGN (see .BR sigaction (2)); -.IP * +.IP \(bu the .BR SA_NOCLDWAIT flag was not specified while establishing a handler for @@ -128,7 +128,7 @@ or while setting the disposition of that signal to (see .BR sigaction (2)); and -.IP * +.IP \(bu the zombie process was not reaped elsewhere in the program (e.g., either by an asynchronously executed signal handler or by .BR wait (2) @@ -143,7 +143,6 @@ with the flag. .\" .SS Use cases for PID file descriptors -.PP A PID file descriptor returned by .BR pidfd_open () (or by @@ -151,12 +150,12 @@ A PID file descriptor returned by with the .BR CLONE_PID flag) can be used for the following purposes: -.IP * 3 +.IP \(bu 2 The .BR pidfd_send_signal (2) system call can be used to send a signal to the process referred to by a PID file descriptor. -.IP * +.IP \(bu A PID file descriptor can be monitored using .BR poll (2), .BR select (2), @@ -169,15 +168,20 @@ nothing can be read from the file descriptor .RB ( read (2) on the file descriptor fails with the error .BR EINVAL ). -.IP * +.IP \(bu If the PID file descriptor refers to a child of the calling process, then it can be waited on using .BR waitid (2). -.IP * +.IP \(bu The .BR pidfd_getfd (2) system call can be used to obtain a duplicate of a file descriptor of another process referred to by a PID file descriptor. +.IP \(bu +A PID file descriptor can be used as the argument of +.BR setns (2) +in order to move into one or more of the same namespaces as the process +referred to by the file descriptor. .PP The .BR pidfd_open () @@ -252,6 +256,7 @@ main(int argc, char *argv[]) printf("Events (0x%x): POLLIN is %sset\en", pollfd.revents, (pollfd.revents & POLLIN) ? "" : "not "); + close(pidfd); exit(EXIT_SUCCESS); } .fi @@ -262,10 +267,11 @@ main(int argc, char *argv[]) .BR pidfd_send_signal (2), .BR poll (2), .BR select (2), +.BR setns (2), .BR waitid (2), .BR epoll (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 29e8271f6..4d2e50692 100644 --- a/man2/pidfd_send_signal.2 +++ b/man2/pidfd_send_signal.2 @@ -69,7 +69,7 @@ is set to 0; .IP * .I si_code is set to -.BR SI_USER; +.BR SI_USER ; .IP * .I si_pid is set to the caller's PID; and @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pipe.2 b/man2/pipe.2 index d5c56495e..90418cdc5 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -50,7 +50,7 @@ pipe, pipe2 \- create pipe .BI "int pipe(int " pipefd "[2]);" .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.BR "#include <fcntl.h>" " /* Obtain O_* constant definitions */ +.BR "#include <fcntl.h>" " /* Obtain O_* constant definitions */" .B #include <unistd.h> .PP .BI "int pipe2(int " pipefd "[2], int " flags ); @@ -294,7 +294,7 @@ main(int argc, char *argv[]) .BR popen (3), .BR pipe (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 ce154a6f7..4bf110faa 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -214,7 +214,6 @@ Helper programs for this process exist; see .BR switch_root (8). .\" .SS pivot_root(\(dq.\(dq, \(dq.\(dq) -.PP .I new_root and .I put_old @@ -275,7 +274,6 @@ was first implemented and will not change now. .\" FIXME .\" Would it be better, because simpler, to use unshare(2) .\" rather than clone(2) in the example below? -.PP The program below demonstrates the use of .BR pivot_root () inside a mount namespace that is created using @@ -420,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.07 of the Linux +This page is part of release 5.08 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 fbf5d9566..0a68c98ba 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/poll.2 b/man2/poll.2 index 515ffe43b..07f13079d 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -40,7 +40,7 @@ poll, ppoll \- wait for some event on a file descriptor .B #include <signal.h> .B #include <poll.h> .PP -.BI "int ppoll(struct pollfd *" fds ", nfds_t " nfds ", " +.BI "int ppoll(struct pollfd *" fds ", nfds_t " nfds , .BI " const struct timespec *" tmo_p ", const sigset_t *" sigmask ); .fi .SH DESCRIPTION @@ -183,7 +183,7 @@ file has been modified (see .RE .TP .B POLLOUT -Writing is now possible, though a write larger that the available space +Writing is now possible, though a write larger than the available space in a socket or pipe will still block (unless .B O_NONBLOCK is set). @@ -663,7 +663,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 47f726782..3815c7821 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/prctl.2 b/man2/prctl.2 index c98e13acf..eb3e0fcd9 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -1,7 +1,12 @@ .\" Copyright (C) 1998 Andries Brouwer (aeb@cwi.nl) -.\" and Copyright (C) 2002, 2006, 2008, 2012, 2013 Michael Kerrisk <mtk.manpages@gmail.com> +.\" and Copyright (C) 2002, 2006, 2008, 2012, 2013, 2015 Michael Kerrisk <mtk.manpages@gmail.com> .\" and Copyright Guillem Jover <guillem@hadrons.org> +.\" and Copyright (C) 2010 Andi Kleen <andi@firstfloor.org> +.\" and Copyright (C) 2012 Cyrill Gorcunov <gorcunov@openvz.org> .\" and Copyright (C) 2014 Dave Hansen / Intel +.\" and Copyright (c) 2016 Eugene Syromyatnikov <evgsyr@gmail.com> +.\" and Copyright (c) 2018 Konrad Rzeszutek Wilk <konrad.wilk@oracle.com> +.\" and Copyright (c) 2020 Dave Martin <Dave.Martin@arm.com> .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this @@ -51,7 +56,7 @@ .\" 2014-11-10 Dave Hansen, document PR_MPX_{EN,DIS}ABLE_MANAGEMENT .\" .\" -.TH PRCTL 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH PRCTL 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME prctl \- operations on a process or thread .SH SYNOPSIS @@ -377,7 +382,6 @@ Note that modern MIPS implementations (MIPS R6 and newer) support .B FR=1 mode only. .IP -.IP Applications that use the O32 FP32 ABI can operate only when this bit is .I unset .RB ( FR=0 ; @@ -784,7 +788,7 @@ option enabled. .RE .\" prctl PR_MPX_ENABLE_MANAGEMENT .TP -.BR PR_MPX_ENABLE_MANAGEMENT ", " PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19, removed in Linux 5.4; only on x86) " +.BR PR_MPX_ENABLE_MANAGEMENT ", " PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19, removed in Linux 5.4; only on x86)" .\" commit fe3d197f84319d3bce379a9c0dc17b1f48ad358c .\" See also http://lwn.net/Articles/582712/ .\" See also https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler @@ -1012,6 +1016,7 @@ then the call fails with error Because the compiler or run-time environment may be using some or all of the keys, a successful +.B PR_PAC_RESET_KEYS may crash the calling process. The conditions for using it safely are complex and system-dependent. Don't use it unless you know what you are doing. @@ -1022,7 +1027,6 @@ For more information, see the kernel source file (or .I Documentation/arm64/pointer\-authentication.txt before Linux 5.3). -.B PR_PAC_RESET_KEYS .\" prctl PR_SET_PDEATHSIG .TP .BR PR_SET_PDEATHSIG " (since Linux 2.1.57)" @@ -1075,6 +1079,12 @@ or a binary that has associated capabilities (see .BR capabilities (7)); otherwise, this value is preserved across .BR execve (2). +The parent-death signal setting is also cleared upon changes to +any of the following thread credentials: +.\" FIXME capability changes can also trigger this; see +.\" kernel/cred.c::commit_creds in the Linux 5.6 source. +effective user ID, effective group ID, filesystem user ID, +or filesystem group ID. .\" prctl PR_GET_PDEATHSIG .TP .BR PR_GET_PDEATHSIG " (since Linux 2.3.15)" @@ -1371,6 +1381,300 @@ call failing with the error .BR ENXIO . For further details, see the kernel source file .IR Documentation/admin\-guide/kernel\-parameters.txt . +.\" prctl PR_SVE_SET_VL +.\" commit 2d2123bc7c7f843aa9db87720de159a049839862 +.\" linux-5.6/Documentation/arm64/sve.rst +.TP +.BR PR_SVE_SET_VL " (since Linux 4.15, only on arm64)" +Configure the thread's SVE vector length, +as specified by +.IR "(int) arg2" . +Arguments +.IR arg3 ", " arg4 ", and " arg5 +are ignored. +.IP +The bits of +.I arg2 +corresponding to +.B PR_SVE_VL_LEN_MASK +must be set to the desired vector length in bytes. +This is interpreted as an upper bound: +the kernel will select the greatest available vector length +that does not exceed the value specified. +In particular, specifying +.B SVE_VL_MAX +(defined in +.I <asm/sigcontext.h>) +for the +.B PR_SVE_VL_LEN_MASK +bits requests the maximum supported vector length. +.IP +In addition, the other bits of +.I arg2 +must be set to one of the following combinations of flags: +.RS +.TP +.B 0 +Perform the change immediately. +At the next +.BR execve (2) +in the thread, +the vector length will be reset to the value configured in +.IR /proc/sys/abi/sve_default_vector_length . +.TP +.B PR_SVE_VL_INHERIT +Perform the change immediately. +Subsequent +.BR execve (2) +calls will preserve the new vector length. +.TP +.B PR_SVE_SET_VL_ONEXEC +Defer the change, so that it is performed at the next +.BR execve (2) +in the thread. +Further +.BR execve (2) +calls will reset the vector length to the value configured in +.IR /proc/sys/abi/sve_default_vector_length . +.TP +.B "PR_SVE_SET_VL_ONEXEC | PR_SVE_VL_INHERIT" +Defer the change, so that it is performed at the next +.BR execve (2) +in the thread. +Further +.BR execve (2) +calls will preserve the new vector length. +.RE +.IP +In all cases, +any previously pending deferred change is canceled. +.IP +The call fails with error +.B EINVAL +if SVE is not supported on the platform, if +.I arg2 +is unrecognized or invalid, or the value in the bits of +.I arg2 +corresponding to +.B PR_SVE_VL_LEN_MASK +is outside the range +.BR SVE_VL_MIN .. SVE_VL_MAX +or is not a multiple of 16. +.IP +On success, +a nonnegative value is returned that describes the +.I selected +configuration. +If +.B PR_SVE_SET_VL_ONEXEC +was included in +.IR arg2 , +then the configuration described by the return value +will take effect at the next +.BR execve (). +Otherwise, the configuration is already in effect when the +.B PR_SVE_SET_VL +call returns. +In either case, the value is encoded in the same way as the return value of +.BR PR_SVE_GET_VL . +Note that there is no explicit flag in the return value +corresponding to +.BR PR_SVE_SET_VL_ONEXEC . +.IP +The configuration (including any pending deferred change) +is inherited across +.BR fork (2) +and +.BR clone (2). +.IP +For more information, see the kernel source file +.I Documentation/arm64/sve.rst +.\"commit b693d0b372afb39432e1c49ad7b3454855bc6bed +(or +.I Documentation/arm64/sve.txt +before Linux 5.3). +.IP +.B Warning: +Because the compiler or run-time environment +may be using SVE, using this call without the +.B PR_SVE_SET_VL_ONEXEC +flag may crash the calling process. +The conditions for using it safely are complex and system-dependent. +Don't use it unless you really know what you are doing. +.\" prctl PR_SVE_GET_VL +.TP +.BR PR_SVE_GET_VL " (since Linux 4.15, only on arm64)" +Get the thread's current SVE vector length configuration. +.IP +Arguments +.IR arg2 ", " arg3 ", " arg4 ", and " arg5 +are ignored. +.IP +Provided that the kernel and platform support SVE, +this operation always succeeds, +returning a nonnegative value that describes the +.I current +configuration. +The bits corresponding to +.B PR_SVE_VL_LEN_MASK +contain the currently configured vector length in bytes. +The bit corresponding to +.B PR_SVE_VL_INHERIT +indicates whether the vector length will be inherited +across +.BR execve (2). +.IP +Note that there is no way to determine whether there is +a pending vector length change that has not yet taken effect. +.IP +For more information, see the kernel source file +.I Documentation/arm64/sve.rst +.\"commit b693d0b372afb39432e1c49ad7b3454855bc6bed +(or +.I Documentation/arm64/sve.txt +before Linux 5.3). +.\" prctl PR_SET_TAGGED_ADDR_CTRL +.\" commit 63f0c60379650d82250f22e4cf4137ef3dc4f43d +.TP +.BR PR_SET_TAGGED_ADDR_CTRL " (since Linux 5.4, only on arm64)" +Controls support for passing tagged user-space addresses to the kernel +(i.e., addresses where bits 56\(em63 are not all zero). +.IP +The level of support is selected by +.IR "arg2" , +which can be one of the following: +.RS +.TP +.B 0 +Addresses that are passed +for the purpose of being dereferenced by the kernel +must be untagged. +.TP +.B PR_TAGGED_ADDR_ENABLE +Addresses that are passed +for the purpose of being dereferenced by the kernel +may be tagged, with the exceptions summarized below. +.RE +.IP +The remaining arguments +.IR arg3 ", " arg4 ", and " arg5 +must all be zero. +.\" Enforcement added in +.\" commit 3e91ec89f527b9870fe42dcbdb74fd389d123a95 +.IP +On success, the mode specified in +.I arg2 +is set for the calling thread and the return value is 0. +If the arguments are invalid, +the mode specified in +.I arg2 +is unrecognized, +or if this feature is unsupported by the kernel +or disabled via +.IR /proc/sys/abi/tagged_addr_disabled , +the call fails with the error +.BR EINVAL . +.IP +In particular, if +.BR prctl ( PR_SET_TAGGED_ADDR_CTRL , +0, 0, 0, 0) +fails with +.BR EINVAL , +then all addresses passed to the kernel must be untagged. +.IP +Irrespective of which mode is set, +addresses passed to certain interfaces +must always be untagged: +.RS +.IP \(bu 2 +.BR brk (2), +.BR mmap (2), +.BR shmat (2), +.BR shmdt (2), +and the +.I new_address +argument of +.BR mremap (2). +.IP +(Prior to Linux 5.6 these accepted tagged addresses, +but the behaviour may not be what you expect. +Don't rely on it.) +.IP \(bu +\(oqpolymorphic\(cq interfaces +that accept pointers to arbitrary types cast to a +.I void * +or other generic type, specifically +.BR prctl (2), +.BR ioctl (2), +and in general +.BR setsockopt (2) +(only certain specific +.BR setsockopt (2) +options allow tagged addresses). +.RE +.IP +This list of exclusions may shrink +when moving from one kernel version to a later kernel version. +While the kernel may make some guarantees +for backwards compatibility reasons, +for the purposes of new software +the effect of passing tagged addresses to these interfaces +is unspecified. +.IP +The mode set by this call is inherited across +.BR fork (2) +and +.BR clone (2). +The mode is reset by +.BR execve (2) +to 0 +(i.e., tagged addresses not permitted in the user/kernel ABI). +.IP +For more information, see the kernel source file +.IR Documentation/arm64/tagged\-address\-abi.rst . +.IP +.B Warning: +This call is primarily intended for use by the run-time environment. +A successful +.B PR_SET_TAGGED_ADDR_CTRL +call elsewhere may crash the calling process. +The conditions for using it safely are complex and system-dependent. +Don't use it unless you know what you are doing. +.\" prctl PR_GET_TAGGED_ADDR_CTRL +.\" commit 63f0c60379650d82250f22e4cf4137ef3dc4f43d +.TP +.BR PR_GET_TAGGED_ADDR_CTRL " (since Linux 5.4, only on arm64)" +Returns the current tagged address mode +for the calling thread. +.IP +Arguments +.IR arg2 ", " arg3 ", " arg4 ", and " arg5 +must all be zero. +.IP +If the arguments are invalid +or this feature is disabled or unsupported by the kernel, +the call fails with +.BR EINVAL . +In particular, if +.BR prctl ( PR_GET_TAGGED_ADDR_CTRL , +0, 0, 0, 0) +fails with +.BR EINVAL , +then this feature is definitely either unsupported, +or disabled via +.IR /proc/sys/abi/tagged_addr_disabled . +In this case, +all addresses passed to the kernel must be untagged. +.IP +Otherwise, the call returns a nonnegative value +describing the current tagged address mode, +encoded in the same way as the +.I arg2 +argument of +.BR PR_SET_TAGGED_ADDR_CTRL . +.IP +For more information, see the kernel source file +.IR Documentation/arm64/tagged\-address\-abi.rst . .\" .\" prctl PR_TASK_PERF_EVENTS_DISABLE .TP @@ -1614,6 +1918,9 @@ On success, .BR PR_GET_NO_NEW_PRIVS , .BR PR_GET_SECUREBITS , .BR PR_GET_SPECULATION_CTRL , +.BR PR_SVE_GET_VL , +.BR PR_SVE_SET_VL , +.BR PR_GET_TAGGED_ADDR_CTRL , .BR PR_GET_THP_DISABLE , .BR PR_GET_TIMING , .BR PR_GET_TIMERSLACK , @@ -1905,6 +2212,40 @@ See the description of .B PR_PAC_RESET_KEYS above for details. .TP +.B EINVAL +.I option +is +.B PR_SVE_SET_VL +and the arguments are invalid or unsupported, +or SVE is not available on this platform. +See the description of +.B PR_SVE_SET_VL +above for details. +.TP +.B EINVAL +.I option +is +.B PR_SVE_GET_VL +and SVE is not available on this platform. +.TP +.B EINVAL +.I option +is +.BR PR_SET_TAGGED_ADDR_CTRL +and the arguments are invalid or unsupported. +See the description of +.B PR_SET_TAGGED_ADDR_CTRL +above for details. +.TP +.B EINVAL +.I option +is +.BR PR_GET_TAGGED_ADDR_CTRL +and the arguments are invalid or unsupported. +See the description of +.B PR_GET_TAGGED_ADDR_CTRL +above for details. +.TP .B ENODEV .I option was @@ -2037,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/pread.2 b/man2/pread.2 index 3327f1c60..567eef97f 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.07 of the Linux +This page is part of release 5.08 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 92810994e..161a4e2b6 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -25,7 +25,7 @@ .\" %%%LICENSE_END .\" .\" Commit fcf634098c00dd9cd247447368495f0b79be12d1 -.\" +.\" .TH PROCESS_VM_READV 2 2020-06-09 "Linux" "Linux Programmer's Manual" .SH NAME process_vm_readv, process_vm_writev \- transfer data between process address spaces @@ -339,7 +339,7 @@ main(void) .BR readv (2), .BR writev (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ptrace.2 b/man2/ptrace.2 index f3a7f5bd2..83b3b0c52 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -109,7 +109,7 @@ ptrace \- process trace .nf .B #include <sys/ptrace.h> .PP -.BI "long ptrace(enum __ptrace_request " request ", pid_t " pid ", " +.BI "long ptrace(enum __ptrace_request " request ", pid_t " pid , .BI " void *" addr ", void *" data ); .fi .SH DESCRIPTION @@ -421,7 +421,6 @@ for dumping signals from the process-wide signal queue. If this flag is not set, signals are read from the per-thread queue of the specified thread. .in -.PP .TP .BR PTRACE_GETSIGMASK " (since Linux 3.11)" .\" commit 29000caecbe87b6b66f144f72111f0d02fbbf0c1 @@ -1720,7 +1719,7 @@ no syscall-exit-stop occurs. Note that all mentions .BR PTRACE_SYSEMU apply equally to -.BR PTRACE_SYSEMU_SINGLESTEP. +.BR PTRACE_SYSEMU_SINGLESTEP . .PP However, even if the tracee was continued using .BR PTRACE_SYSCALL , @@ -2271,7 +2270,7 @@ to the tracee after returns. This is an ordinary signal (similar to one which can be generated by -.IR "kill -TRAP" ), +.IR "kill \-TRAP" ), not a special kind of ptrace-stop. Employing .B PTRACE_GETSIGINFO @@ -2680,7 +2679,6 @@ check\(emfor example, .BR ptrace () .BR PTRACE_ATTACH . (See the "Ptrace access mode checking" discussion above.) -.IP .IP * .BR ptrace () .BR PTRACE_TRACEME . @@ -2921,7 +2919,7 @@ to zero. .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 a65e04535..ecfcbc395 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/quotactl.2 b/man2/quotactl.2 index f85e25dfc..598d1bf5c 100644 --- a/man2/quotactl.2 +++ b/man2/quotactl.2 @@ -36,7 +36,6 @@ quotactl \- manipulate disk quotas ", caddr_t " addr ); .fi .SH DESCRIPTION -.PP The quota system can be used to set per-user, per-group, and per-project limits on the amount of disk space used on a filesystem. For each user and/or group, @@ -688,7 +687,6 @@ The .IR special ", " id " and " addr arguments are ignored. .SH RETURN VALUE -.PP On success, .BR quotactl () returns 0; on error \-1 @@ -822,7 +820,7 @@ prefix. .BR quotacheck (8), .BR quotaon (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/read.2 b/man2/read.2 index e558a6977..e1e13bbcc 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readahead.2 b/man2/readahead.2 index c93659314..2fc48bcfc 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readdir.2 b/man2/readdir.2 index 25e61f8ea..aa915bceb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readlink.2 b/man2/readlink.2 index aff9f734c..f0fea5dcd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/readv.2 b/man2/readv.2 index 5356c1d39..0dbd35db5 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -184,7 +184,6 @@ The file referred to by .I fd must be capable of seeking. .SS preadv2() and pwritev2() -.PP These system calls are similar to .BR preadv () and @@ -432,7 +431,7 @@ nwritten = writev(STDOUT_FILENO, iov, 2); .BR read (2), .BR write (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/reboot.2 b/man2/reboot.2 index 20e3b04de..99d50beec 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recv.2 b/man2/recv.2 index a2c5429c6..9e271939b 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -533,13 +533,18 @@ field of the .I msghdr structure should be typed as .IR socklen_t , -but glibc currently types it as +and the +.I msg_iovlen +field should be typed as +.IR int , +but glibc currently types both as .IR size_t . -.\" glibc bug raised 12 Mar 2006 +.\" glibc bug for msg_controllen raised 12 Mar 2006 .\" http://sourceware.org/bugzilla/show_bug.cgi?id=2448 .\" The problem is an underlying kernel issue: the size of the -.\" __kernel_size_t type used to type this field varies -.\" across architectures, but socklen_t is always 32 bits. +.\" __kernel_size_t type used to type these fields varies +.\" across architectures, but socklen_t is always 32 bits, +.\" as (at least with GCC) is int. .PP See .BR recvmmsg (2) @@ -567,7 +572,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/recvmmsg.2 b/man2/recvmmsg.2 index 460641127..d50084f12 100644 --- a/man2/recvmmsg.2 +++ b/man2/recvmmsg.2 @@ -190,7 +190,6 @@ In the current implementation, however, the error code can be overwritten in the meantime by an unrelated network event on a socket, for example an incoming ICMP packet. .SH EXAMPLES -.PP The following program uses .BR recvmmsg () to receive multiple messages on a socket and stores @@ -203,7 +202,7 @@ containing a random number: .PP .in +4n .EX -.RB "$" " while true; do echo $RANDOM > /dev/udp/127.0.0.1/1234; " +.RB "$" " while true; do echo $RANDOM > /dev/udp/127.0.0.1/1234;" .B " sleep 0.25; done" .EE .in @@ -292,7 +291,7 @@ main(void) .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 a7a4be856..d6618be00 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/removexattr.2 b/man2/removexattr.2 index 9047a3589..848510d9b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rename.2 b/man2/rename.2 index 74dc45bd6..df02e63ec 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.07 of the Linux +This page is part of release 5.08 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 dbb1a56fa..f79d5c3e9 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -82,23 +82,23 @@ permission, or it may be one of the following special keyring IDs: .TP .B KEY_SPEC_THREAD_KEYRING This specifies the caller's thread-specific keyring (see -.BR thread-keyring (7)). +.BR thread\-keyring (7)). .TP .B KEY_SPEC_PROCESS_KEYRING This specifies the caller's process-specific keyring (see -.BR process-keyring (7)). +.BR process\-keyring (7)). .TP .B KEY_SPEC_SESSION_KEYRING This specifies the caller's session-specific keyring (see -.BR session-keyring (7)). +.BR session\-keyring (7)). .TP .B KEY_SPEC_USER_KEYRING This specifies the caller's UID-specific keyring (see -.BR user-keyring (7)). +.BR user\-keyring (7)). .TP .B KEY_SPEC_USER_SESSION_KEYRING This specifies the caller's UID-session keyring (see -.BR user-session-keyring (7)). +.BR user\-session\-keyring (7)). .PP When the .I dest_keyring @@ -132,28 +132,28 @@ since Linux 2.6.29). The thread-specific keyring .RB ( KEY_REQKEY_DEFL_THREAD_KEYRING ; see -.BR thread-keyring (7)). +.BR thread\-keyring (7)). .IP \(bu The process-specific keyring .RB ( KEY_REQKEY_DEFL_PROCESS_KEYRING ; see -.BR process-keyring (7)). +.BR process\-keyring (7)). .IP \(bu The session-specific keyring .RB ( KEY_REQKEY_DEFL_SESSION_KEYRING ; see -.BR session-keyring (7)). +.BR session\-keyring (7)). .IP \(bu The session keyring for the process's user ID .RB ( KEY_REQKEY_DEFL_USER_SESSION_KEYRING ; see -.BR user-session-keyring (7)). +.BR user\-session\-keyring (7)). This keyring is expected to always exist. .IP \(bu The UID-specific keyring .RB ( KEY_REQKEY_DEFL_USER_KEYRING ; see -.BR user-keyring (7)). +.BR user\-keyring (7)). This keyring is also expected to always exist. .\" mtk: Are there circumstances where the user sessions and UID-specific .\" keyrings do not exist? @@ -258,9 +258,9 @@ Internally, the kernel also records the PID of the process that called .RE .IP c) The kernel creates a process that executes a user-space service such as -.BR request-key (8) +.BR request\-key (8) with a new session keyring that contains a link to the authorization key, V. -.\" The request-key(8) program can be invoked in circumstances *other* than +.\" The request\-key(8) program can be invoked in circumstances *other* than .\" when triggered by request_key(2). For example, upcalls from places such .\" as the DNS resolver. .IP @@ -268,7 +268,7 @@ This program is supplied with the following command-line arguments: .RS .IP [0] 4 The string -.IR """/sbin/request-key""" . +.IR """/sbin/request\-key""" . .IP [1] The string .I """create""" @@ -356,7 +356,7 @@ to fail until it does. The purpose of this negatively instantiated key is to prevent (possibly different) processes making repeated requests (that require expensive -.BR request-key (8) +.BR request\-key (8) upcalls) for a key that can't (at the moment) be positively instantiated. .PP Once the key has been instantiated, the authorization key @@ -364,7 +364,7 @@ Once the key has been instantiated, the authorization key is revoked, and the destination keyring .RB ( KEY_SPEC_REQUESTOR_KEYRING ) is no longer accessible from the -.BR request-key (8) +.BR request\-key (8) program. .PP If a key is created, then\(emregardless of whether it is a valid key or @@ -458,13 +458,13 @@ The call specifies the session keyring as the target keyring. .PP In order to demonstrate this program, we first create a suitable entry in the file -.IR /etc/request-key.conf . +.IR /etc/request\-key.conf . .PP .in +4n .EX $ sudo sh # \fBecho 'create user mtk:* * /bin/keyctl instantiate %k %c %S' \e\fP - \fB> /etc/request-key.conf\fP + \fB> /etc/request\-key.conf\fP # \fBexit\fP .EE .in @@ -489,7 +489,7 @@ and the session keyring of the requestor (i.e., the caller of .BR request_key ()). See -.BR request-key.conf (5) +.BR request\-key.conf (5) for details of these .I % specifiers. @@ -502,7 +502,7 @@ to verify that the requested key has been instantiated: .EX $ \fB./t_request_key user mtk:key1 "Payload data"\fP $ \fBgrep \(aq2dddaf50\(aq /proc/keys\fP -2dddaf50 I--Q--- 1 perm 3f010000 1000 1000 user mtk:key1: 12 +2dddaf50 I\-\-Q\-\-\- 1 perm 3f010000 1000 1000 user mtk:key1: 12 .EE .in .PP @@ -571,7 +571,7 @@ and .\" commit 3db38ed76890565772fcca3279cc8d454ea6176b .IR Documentation/security/keys\-request\-key.txt ). .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 8242a50f8..63dcacf54 100644 --- a/man2/restart_syscall.2 +++ b/man2/restart_syscall.2 @@ -142,7 +142,7 @@ returned in the usual fashion. .\" spent suspended is *not* deducted when the select() is restarted. .\" FIXME . check whether recvmmsg() handles stop-sig+SIGCONT properly. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 04f9196c7..e6faaa35c 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.07 of the Linux +This page is part of release 5.08 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 e555abc23..881a707a6 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.07 of the Linux +This page is part of release 5.08 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 61f2774c8..a789f20f0 100644 --- a/man2/s390_guarded_storage.2 +++ b/man2/s390_guarded_storage.2 @@ -170,11 +170,10 @@ header. .\" .UR https://developer.ibm.com/javasdk/2017/09/25/concurrent-scavenge-using-guarded-storage-facility-works/ .\" the article with the description of its usage in the Java Garbage Collection .\" .UE -.PP .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 a15b4ea1e..73414a6bb 100644 --- a/man2/s390_pci_mmio_write.2 +++ b/man2/s390_pci_mmio_write.2 @@ -30,10 +30,10 @@ MMIO memory page .nf .B #include <asm/unistd.h> .PP -.BI "int s390_pci_mmio_write(unsigned long " mmio_addr ", -.BI " void *" user_buffer ", size_t " length "); -.BI "int s390_pci_mmio_read(unsigned long " mmio_addr ", -.BI " void *" user_buffer ", size_t " length "); +.BI "int s390_pci_mmio_write(unsigned long " mmio_addr "," +.BI " void *" user_buffer ", size_t " length ");" +.BI "int s390_pci_mmio_read(unsigned long " mmio_addr "," +.BI " void *" user_buffer ", size_t " length ");" .fi .SH DESCRIPTION The @@ -106,7 +106,7 @@ to call it. .SH SEE ALSO .BR syscall (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 253083354..598da21c8 100644 --- a/man2/s390_runtime_instr.2 +++ b/man2/s390_runtime_instr.2 @@ -29,7 +29,7 @@ s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation .nf .B #include <asm/runtime_instr.h> .PP -.BI "int s390_runtime_instr(int " command ", int " signum "); +.BI "int s390_runtime_instr(int " command ", int " signum ");" .fi .SH DESCRIPTION The @@ -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.07 of the Linux +This page is part of release 5.08 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 fb20a5364..95686610e 100644 --- a/man2/s390_sthyi.2 +++ b/man2/s390_sthyi.2 @@ -29,8 +29,8 @@ s390_sthyi \- emulate STHYI instruction .nf .B #include <asm/unistd.h> .PP -.BI "int s390_sthyi(unsigned long " function_code ", void *" resp_buffer ", -.BI " uint64_t *" return_code ", unsigned long " flags "); +.BI "int s390_sthyi(unsigned long " function_code ", void *" resp_buffer "," +.BI " uint64_t *" return_code ", unsigned long " flags ");" .fi .SH DESCRIPTION The @@ -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.07 of the Linux +This page is part of release 5.08 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 0780e09bb..1ca33c742 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.07 of the Linux +This page is part of release 5.08 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 987928709..661a41d66 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.07 of the Linux +This page is part of release 5.08 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 4f13861ab..878621227 100644 --- a/man2/sched_setaffinity.2 +++ b/man2/sched_setaffinity.2 @@ -324,7 +324,7 @@ system has two cores, each with two CPUs: .PP .in +4n .EX -$ \fBlscpu | egrep -i 'core.*:|socket'\fP +$ \fBlscpu | egrep \-i 'core.*:|socket'\fP Thread(s) per core: 2 Core(s) per socket: 2 Socket(s): 1 @@ -438,7 +438,7 @@ main(int argc, char *argv[]) .BR sched (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 7dfd839ae..422a643d1 100644 --- a/man2/sched_setattr.2 +++ b/man2/sched_setattr.2 @@ -446,7 +446,7 @@ for the case described in ERRORS. .BR sched (7) .ad .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 21b4b20fc..38ad641f9 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.07 of the Linux +This page is part of release 5.08 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 4b1b92414..4c1db7284 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.07 of the Linux +This page is part of release 5.08 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 d66747741..92f2936d2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/seccomp.2 b/man2/seccomp.2 index 3d277299f..c9deeeb04 100644 --- a/man2/seccomp.2 +++ b/man2/seccomp.2 @@ -342,16 +342,41 @@ is used on the system call number to tell the two ABIs apart. .\" an extra instruction in system_call to mask off the extra bit, .\" so that the syscall table indexing still works. .PP -This means that in order to create a seccomp-based -deny-list for system calls performed through the x86-64 ABI, -it is necessary to not only check that -.IR arch -equals -.BR AUDIT_ARCH_X86_64 , -but also to explicitly reject all system calls that contain +This means that a policy must either deny all syscalls with .BR __X32_SYSCALL_BIT -in -.IR nr . +or it must recognize syscalls with and without +.BR __X32_SYSCALL_BIT +set. +A list of system calls to be denied based on +.IR nr +that does not also contain +.IR nr +values with +.BR __X32_SYSCALL_BIT +set can be bypassed by a malicious program that sets +.BR __X32_SYSCALL_BIT . +.PP +Additionally, kernels prior to Linux 5.4 incorrectly permitted +.IR nr +in the ranges 512-547 as well as the corresponding non-x32 syscalls ORed +with +.BR __X32_SYSCALL_BIT . +For example, +.IR nr +== 521 and +.IR nr +== (101 | +.BR __X32_SYSCALL_BIT ) +would result in invocations of +.BR ptrace (2) +with potentially confused x32-vs-x86_64 semantics in the kernel. +Policies intended to work on kernels before Linux 5.4 must ensure that they +deny or otherwise correctly handle these system calls. +On Linux 5.4 and newer, +.\" commit 6365b842aae4490ebfafadfc6bb27a6d3cc54757 +such system calls will fail with the error +.BR ENOSYS , +without doing anything. .PP The .I instruction_pointer @@ -368,8 +393,8 @@ and system calls to prevent the program from subverting such checks.) .PP When checking values from -.IR args -against a deny-list, keep in mind that arguments are often +.IR args, +keep in mind that arguments are often silently truncated before being processed, but after the seccomp check. For example, this happens if the i386 ABI is used on an x86-64 kernel: although the kernel will normally not look beyond @@ -940,7 +965,7 @@ numbers on this architecture: .PP .in +4n .EX -$ \fBuname -m\fP +$ \fBuname \-m\fP x86_64 $ \fBsyscall_nr() { cat /usr/src/linux/arch/x86/syscalls/syscall_64.tbl | \e @@ -1145,7 +1170,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/select.2 b/man2/select.2 index fcf8e3631..921f1d3cb 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -237,7 +237,6 @@ is specified as NULL, blocks indefinitely waiting for a file descriptor to become ready. .\" .SS pselect() -.PP The .BR pselect () system call allows an application to safely wait until either @@ -316,7 +315,6 @@ pthread_sigmask(SIG_SETMASK, &origmask, NULL); .EE .in .PP -.PP The reason that .BR pselect () is needed is that if one wants to wait for either a signal @@ -512,7 +510,6 @@ or reading from a pipe that may be empty, nonblocking I/O is used when reading from and writing to the pipe.) .\" .SS Emulating usleep(3) -.PP Before the advent of .BR usleep (3), some code employed a call to @@ -622,7 +619,6 @@ for a discussion of the difference between the kernel and libc notion of the signal set. .\" .SS Historical glibc details -.PP Glibc 2.0 provided an incorrect version of .BR pselect () that did not take a @@ -763,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.07 of the Linux +This page is part of release 5.08 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 be3eac07e..44ad0c303 100644 --- a/man2/select_tut.2 +++ b/man2/select_tut.2 @@ -33,7 +33,6 @@ .SH NAME select, pselect \- synchronous I/O multiplexing .SH SYNOPSIS -.PP See .BR select (2) .SH DESCRIPTION @@ -54,7 +53,6 @@ and .BR pselect (), see .BR select (2). -.PP .\" .SS Combining signal and data events .BR pselect () @@ -652,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semctl.2 b/man2/semctl.2 index 312687135..a97ac32f3 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -115,7 +115,7 @@ Time of creation of semaphore set or time of last .BR IPCSET , .BR SETVAL , or -.BR SETVALL +.BR SETALL operation. .TP .I sem_nsems @@ -650,7 +650,7 @@ See .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semget.2 b/man2/semget.2 index 90876a9c5..835156985 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -395,7 +395,6 @@ $ \fB./t_semget link p 1\fP # Generates same key as \(aqmykey\(aq ID = 9 .EE .in -.PP .SS Program source \& .nf @@ -466,7 +465,7 @@ main(int argc, char *argv[]) .BR sem_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/semop.2 b/man2/semop.2 index 95f7d422e..4616ba620 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/send.2 b/man2/send.2 index 571512c58..e891c95a9 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -441,13 +441,18 @@ field of the .I msghdr structure should be typed as .IR socklen_t , -but glibc currently types it as +and the +.I msg_iovlen +field should be typed as +.IR int , +but glibc currently types both as .IR size_t . -.\" glibc bug raised 12 Mar 2006 +.\" glibc bug for msg_controllen raised 12 Mar 2006 .\" http://sourceware.org/bugzilla/show_bug.cgi?id=2448 .\" The problem is an underlying kernel issue: the size of the -.\" __kernel_size_t type used to type this field varies -.\" across architectures, but socklen_t is always 32 bits. +.\" __kernel_size_t type used to type these fields varies +.\" across architectures, but socklen_t is always 32 bits, +.\" as (at least with GCC) is int. .PP See .BR sendmmsg (2) @@ -481,7 +486,7 @@ is shown in .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendfile.2 b/man2/sendfile.2 index 4aa171946..88c8e6a3c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sendmmsg.2 b/man2/sendmmsg.2 index 5f9506bfa..70f7552ce 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.07 of the Linux +This page is part of release 5.08 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 81b7f297a..2b66a2ed7 100644 --- a/man2/set_mempolicy.2 +++ b/man2/set_mempolicy.2 @@ -184,7 +184,6 @@ node ID specified in and so forth, until none of the specified nodes contain free memory. Pages will not be allocated from any node not specified in the .IR nodemask . -.IP .TP .B MPOL_INTERLEAVE This mode interleaves page allocations across the nodes specified in @@ -321,7 +320,7 @@ For information on library support, see .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 b379c7580..02cfb4c02 100644 --- a/man2/set_thread_area.2 +++ b/man2/set_thread_area.2 @@ -21,7 +21,7 @@ get_thread_area, set_thread_area \- manipulate thread-local storage information .PP .B #elif defined __m68k__ .PP -.B "int get_thread_area(void); +.B "int get_thread_area(void);" .BI "int set_thread_area(unsigned long " tp ); .PP .B #elif defined __mips__ @@ -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.07 of the Linux +This page is part of release 5.08 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 06cab4b5b..f52df8d8d 100644 --- a/man2/set_tid_address.2 +++ b/man2/set_tid_address.2 @@ -107,7 +107,7 @@ Glibc does not provide a wrapper for this system call; call it using .BR futex (2), .BR gettid (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setcontext.2 b/man2/setcontext.2 deleted file mode 100644 index b01818d4f..000000000 --- a/man2/setcontext.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/getcontext.3 diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 0a7d3c1b3..8adfcfc7b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsgid.2 b/man2/setfsgid.2 index 54461f2d6..3390d9282 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setfsuid.2 b/man2/setfsuid.2 index b547acd8f..b656a24d8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setgid.2 b/man2/setgid.2 index 5e36ebbf2..66652be7d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sethostid.2 b/man2/sethostid.2 deleted file mode 100644 index 3210db030..000000000 --- a/man2/sethostid.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/gethostid.3 diff --git a/man2/setns.2 b/man2/setns.2 index 45b384506..094f083c8 100644 --- a/man2/setns.2 +++ b/man2/setns.2 @@ -5,7 +5,7 @@ .\" Licensed under the GPLv2 .\" %%%LICENSE_END .\" -.TH SETNS 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SETNS 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME setns \- reassociate thread with a namespace .SH SYNOPSIS @@ -16,27 +16,46 @@ setns \- reassociate thread with a namespace .BI "int setns(int " fd ", int " nstype ); .fi .SH DESCRIPTION -Given a file descriptor referring to a namespace, -reassociate the calling thread with that namespace. +The +.BR setns () +system call allows the calling thread to move into different namespaces. +The +.I fd +argument is one of the following: +.IP \(bu 2 +a file descriptor referring to one of the magic links in a +.I /proc/[pid]/ns/ +directory (or a bind mount to such a link); +.IP \(bu +a PID file descriptor (see +.BR pidfd_open (2)). .PP The +.I nstype +argument is interpreted differently in each case. +.\" +.SS fd refers to a /proc/[pid]/ns/ link +If .I fd -argument is a file descriptor referring to one of the namespace entries in a +refers to a .I /proc/[pid]/ns/ -directory; see -.BR namespaces (7) -for further information on -.IR /proc/[pid]/ns/ . -The calling thread will be reassociated with the corresponding namespace, +link, then +.BR setns () +reassociates the calling thread with the namespace associated with that link, subject to any constraints imposed by the .I nstype argument. +In this usage, each call to +.BR setns () +changes just one of the caller's namespace memberships. .PP The .I nstype argument specifies which type of namespace the calling thread may be reassociated with. -This argument can have one of the following values: +This argument can have +.I one +of the following values: .TP .BR 0 Allow any type of namespace to be joined. @@ -88,6 +107,42 @@ and wants to ensure that the namespace is of a particular type. if the file descriptor was opened by another process and, for example, passed to the caller via a UNIX domain socket.) .\" +.SS fd is a PID file descriptor +Since Linux 5.8, +.I fd +may refer to a PID file descriptor obtained from +.BR pidfd_open (2) +or +.BR clone (3). +In this usage, +.BR setns (2) +atomically moves the calling thread into one or more of the same namespaces +as the thread referred to by +.IR fd . +.PP +The +.IR nstype +argument is a bit mask specified by ORing together +.I "one or more" +of the +.BR CLONE_NEW* +namespace constants listed above. +The caller is moved into each of the target thread's namespaces +that is specified in +.IR nstype ; +the caller's memberships in the remaining namespaces are left unchanged. +.PP +For example, the following code would move the caller into the +same user, network, and UTS namespaces as PID 1234, +but would leave the caller's other namespace memberships unchanged: +.PP +.in +4n +.EX +int fd = pidfd_open(1234, 0); +setns(fd, CLONE_NEWUSER | CLONE_NEWNET | CLONE_NEWUTS); +.EE +.in +.\" .SS Details for specific namespace types Note the following details and restrictions when reassociating with specific namespace types: @@ -154,20 +209,16 @@ the caller must have the capability both in its own user namespace and in the user namespace that owns the target PID namespace. .IP -If -.I fd -refers to a PID namespace, the semantics are somewhat different -from other namespace types: -reassociating the calling thread with a PID namespace changes only +Reassociating the PID namespace has somewhat different +from other namespace types. +Reassociating the calling thread with a PID namespace changes only the PID namespace that subsequently created child processes of the caller will be placed in; it does not change the PID namespace of the caller itself. .IP -Reassociating with a PID namespace is allowed only if the -PID namespace specified by -.IR fd -is a descendant (child, grandchild, etc.) -of the PID namespace of the caller. +Reassociating with a PID namespace is allowed only if the target +PID namespace is a descendant (child, grandchild, etc.) +of, or is the same as, the current PID namespace of the caller. .IP For further details on PID namespaces, see .BR pid_namespaces (7). @@ -232,12 +283,23 @@ with other processes and tried to join a new user namespace. .\" See kernel/user_namespace.c::userns_install() [kernel 3.15 sources] The caller is multithreaded and tried to join a new user namespace. .TP +.B EINVAL +.I fd +is a PID file descriptor and +.I nstype +is invalid (e.g., it is 0). +.TP .B ENOMEM Cannot allocate sufficient memory to change the specified namespace. .TP .B EPERM The calling thread did not have the required capability for this operation. +.TP +.B ESRCH +.I fd +is a PID file descriptor but the process it refers to no longer exists +(i.e., it has terminated and been waited on). .SH VERSIONS The .BR setns () @@ -248,6 +310,11 @@ The .BR setns () system call is Linux-specific. .SH NOTES +For further information on the +.IR /proc/[pid]/ns/ +magic links, see +.BR namespaces (7). +.PP Not all of the attributes that can be shared when a new thread is created using .BR clone (2) @@ -329,7 +396,11 @@ main(int argc, char *argv[]) exit(EXIT_FAILURE); } - fd = open(argv[1], O_RDONLY); /* Get file descriptor for namespace */ + /* 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) errExit("open"); @@ -349,7 +420,7 @@ main(int argc, char *argv[]) .BR namespaces (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setpgid.2 b/man2/setpgid.2 index c985c65e5..d634ad3c5 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -75,7 +75,6 @@ Feature Test Macro Requirements for glibc (see .RS 4 _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L .RE .PP @@ -336,7 +335,7 @@ in a different session (see also .BR termios (3), .BR credentials (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setresuid.2 b/man2/setresuid.2 index f98078c86..762d81c1d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setreuid.2 b/man2/setreuid.2 index ed284bf3f..436ec9b2d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setsid.2 b/man2/setsid.2 index f5888e62c..c8158c273 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setuid.2 b/man2/setuid.2 index bf13d265c..79d91aa71 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setup.2 b/man2/setup.2 index effd7b3b8..bc4cb9d5e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/setxattr.2 b/man2/setxattr.2 index ab339b471..6758543c2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sgetmask.2 b/man2/sgetmask.2 index 4f92e6e16..0a5d3cd6f 100644 --- a/man2/sgetmask.2 +++ b/man2/sgetmask.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2007 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SGETMASK 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SGETMASK 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sgetmask, ssetmask \- manipulation of signal mask (obsolete) .SH SYNOPSIS @@ -90,7 +89,7 @@ or .BR sigprocmask (2), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 193bfea3f..2060474d1 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -516,7 +516,7 @@ flag in .BR capabilities (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmget.2 b/man2/shmget.2 index 6c7da310c..123fc52f6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shmop.2 b/man2/shmop.2 index 926690dcb..12e361db4 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -240,7 +240,6 @@ from into .IR "void\ *" . .SH NOTES -.PP After a .BR fork (2), the child inherits the attached shared memory segments. @@ -292,7 +291,6 @@ The implementation places no intrinsic per-process limit on the number of shared memory segments .RB ( SHMSEG ). .SH EXAMPLES -.PP The two programs shown below exchange a string using a shared memory segment. Further details about the programs are given below. First, we show a shell session demonstrating their use. @@ -304,7 +302,7 @@ and then waits for the semaphore to change value. .PP .in +4n .EX -$ \fB./svshm_string_read \fP +$ \fB./svshm_string_read\fP shmid = 1114194; semid = 15 .EE .in @@ -332,7 +330,6 @@ shared memory segment by the writer: Hello, world .EE .in -.PP .\" .SS Program source: svshm_string.h The following header file is included by the "reader" and "writer" programs. @@ -487,7 +484,7 @@ main(int argc, char *argv[]) memcpy(addr, argv[3], len); - /* Decrement semaphore t0 0 */ + /* Decrement semaphore to 0 */ sop.sem_num = 0; sop.sem_op = \-1; @@ -509,7 +506,7 @@ main(int argc, char *argv[]) .BR shm_overview (7), .BR sysvipc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/shutdown.2 b/man2/shutdown.2 index 5dc6e8ef7..2a59d4f53 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaction.2 b/man2/sigaction.2 index 954fe5a1d..e0aaa787e 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1994,1995 Mike Battersby <mib@deakin.edu.au> .\" and Copyright 2004, 2005 Michael Kerrisk <mtk.manpages@gmail.com> .\" based on work by faith@cs.unc.edu @@ -46,7 +45,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH SIGACTION 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SIGACTION 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH SYNOPSIS @@ -168,7 +167,7 @@ is .BR SIGCHLD , do not receive notification when child processes stop (i.e., when they receive one of -.BR SIGSTOP ", " SIGTSTP ", " SIGTTIN ", " +.BR SIGSTOP ", " SIGTSTP ", " SIGTTIN , or .BR SIGTTOU ) or resume (i.e., they receive @@ -849,7 +848,7 @@ points to memory which is not a valid part of the process address space. An invalid signal was specified. This will also be generated if an attempt is made to change the action for -.BR SIGKILL " or " SIGSTOP ", " +.BR SIGKILL " or " SIGSTOP , which cannot be caught or ignored. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SVr4. @@ -945,7 +944,7 @@ See for details on manipulating signal sets. .PP See -.BR signal-safety (7) +.BR signal\-safety (7) for a list of the async-signal-safe functions that can be safely called inside from inside a signal handler. .\" @@ -1062,7 +1061,7 @@ See .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index d105df668..232700712 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2001, 2017 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -368,7 +367,7 @@ if (sigaction(SIGSEGV, &sa, NULL) == -1) { .BR sigsetjmp (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signal.2 b/man2/signal.2 index 5589d2a40..a5ab11b00 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -140,7 +140,7 @@ is set to .BR SIG_IGN . .PP See -.BR signal-safety (7) +.BR signal\-safety (7) for a list of the async-signal-safe functions that can be safely called from inside a signal handler. .PP @@ -198,9 +198,11 @@ This is equivalent to calling .BR sigaction (2) with the following flags: .PP +.in +4n .EX - sa.sa_flags = SA_RESETHAND | SA_NODEFER; +sa.sa_flags = SA_RESETHAND | SA_NODEFER; .EE +.in .PP System\ V also provides these semantics for .BR signal (). @@ -224,9 +226,11 @@ The BSD semantics are equivalent to calling .BR sigaction (2) with the following flags: .PP +.in +4n .EX - sa.sa_flags = SA_RESTART; +sa.sa_flags = SA_RESTART; .EE +.in .PP The situation on Linux is as follows: .IP * 2 @@ -287,7 +291,7 @@ provides System\ V semantics. .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/signalfd.2 b/man2/signalfd.2 index 9f45bfdcf..d38bc005f 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -458,11 +458,11 @@ The following shell session demonstrates the use of the program: .in +4n .EX .RB "$" " ./signalfd_demo" -.BR "^C" " # Control\-C generates SIGINT" +.BR "\(haC" " # Control\-C generates SIGINT" Got SIGINT -.B ^C +.B \(haC Got SIGINT -\fB^\e\fP # Control\-\e generates SIGQUIT +\fB\(ha\e\fP # Control\-\e generates SIGQUIT Got SIGQUIT $ .EE @@ -531,7 +531,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigpending.2 b/man2/sigpending.2 index 007c55edf..45b2fcd5f 100644 --- a/man2/sigpending.2 +++ b/man2/sigpending.2 @@ -44,7 +44,6 @@ Feature Test Macro Requirements for glibc (see _POSIX_C_SOURCE .ad b .SH DESCRIPTION -.PP .BR sigpending () returns the set of signals that are pending for delivery to the calling thread (i.e., the signals which have been raised while blocked). @@ -125,7 +124,7 @@ is not correctly returned. .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2 index cfa74875a..a3befd5eb 100644 --- a/man2/sigprocmask.2 +++ b/man2/sigprocmask.2 @@ -42,7 +42,7 @@ sigprocmask, rt_sigprocmask \- examine and change blocked signals .PP /* Prototype for the legacy system call (deprecated) */ .BI "int sigprocmask(int " how ", const old_kernel_sigset_t *" set , -.BI " old_kernel_sigset_t *" oldset ); " +.BI " old_kernel_sigset_t *" oldset ); .fi .PP .in -4n @@ -165,7 +165,6 @@ and as NULL. .\" .SS C library/kernel differences -.PP The kernel's definition of .IR sigset_t differs in size from that used @@ -231,7 +230,7 @@ when the kernel provides it. .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigqueue.2 b/man2/sigqueue.2 deleted file mode 100644 index fee2bfb02..000000000 --- a/man2/sigqueue.2 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/sigqueue.3 -.\" FIXME . this link will eventually be removed (created Sep 2011) diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 index d6c4d1e29..5c2038cb3 100644 --- a/man2/sigreturn.2 +++ b/man2/sigreturn.2 @@ -54,7 +54,7 @@ This .BR sigreturn () call undoes everything that was done\(emchanging the process's signal mask, switching signal stacks (see -.BR sigaltstack "(2))\(emin " +.BR sigaltstack "(2))\(emin" order to invoke the signal handler. Using the information that was earlier saved on the user-space stack .BR sigreturn () @@ -163,7 +163,7 @@ when the kernel provides it. .BR signal (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2 index fe3dbdd26..70fb79823 100644 --- a/man2/sigsuspend.2 +++ b/man2/sigsuspend.2 @@ -85,7 +85,6 @@ The call was interrupted by a signal; .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES -.PP Normally, .BR sigsuspend () is used in conjunction with @@ -145,7 +144,7 @@ when the kernel provides it. .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2 index c63baff06..9e7734691 100644 --- a/man2/sigwaitinfo.2 +++ b/man2/sigwaitinfo.2 @@ -32,7 +32,7 @@ for queued signals .PP .BI "int sigwaitinfo(const sigset_t *" set ", siginfo_t *" info ");" .PP -.BI "int sigtimedwait(const sigset_t *" set ", siginfo_t *" info ", " +.BI "int sigtimedwait(const sigset_t *" set ", siginfo_t *" info , .BI " const struct timespec *" timeout ");" .fi .PP @@ -248,7 +248,7 @@ when the kernel provides it. .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socket.2 b/man2/socket.2 index 07f4b3267..2b58880ea 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1983, 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -146,7 +145,7 @@ T}:T{ .\" rds-tools: https://github.com/oracle/rds-tools/blob/master/rds-rdma.7 .BR rds (7) .br -.BR rds-rdma (7) +.BR rds\-rdma (7) T} T{ .B AF_PPPOX @@ -209,7 +208,7 @@ T{ .B AF_KCM T}:T{ .\" commit: 03c8efc1ffeb6b82a22c1af8dd908af349563314 -KCM (kernel connection multiplexor) interface +KCM (kernel connection multiplexer) interface T} T{ .B AF_XDP @@ -522,7 +521,7 @@ and reprinted in .I UNIX Programmer's Supplementary Documents Volume 1. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketcall.2 b/man2/socketcall.2 index afdcb6703..c6762eecb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/socketpair.2 b/man2/socketpair.2 index e351108a0..47084cd06 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -143,7 +143,7 @@ file, and portable applications are probably wise to include it. .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/splice.2 b/man2/splice.2 index ffc61acb8..1cfd48387 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.07 of the Linux +This page is part of release 5.08 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 3c41eab55..5031f7b51 100644 --- a/man2/spu_create.2 +++ b/man2/spu_create.2 @@ -273,7 +273,7 @@ for an example of the use of .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 6c133d3af..db9dd4f61 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -267,7 +267,7 @@ int main(void) .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stat.2 b/man2/stat.2 index 77a4d5b6a..d182ec663 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992 .\" Parts Copyright (c) 1995 Nicolai Langfeldt (janl@ifi.uio.no), 1/1/95 .\" and Copyright (c) 2006, 2007, 2014 Michael Kerrisk <mtk.manpages@gmail.com> @@ -37,7 +36,7 @@ .\" 2007-06-08 mtk: Added example program .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH STAT 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH STAT 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME stat, fstat, lstat, fstatat \- get file status .SH SYNOPSIS @@ -67,12 +66,9 @@ Feature Test Macro Requirements for glibc (see .BR lstat (): .RS 4 /* glibc 2.19 and earlier */ _BSD_SOURCE -.br || /* Since glibc 2.20 */ _DEFAULT_SOURCE -.br || _XOPEN_SOURCE\ >=\ 500 .\" _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br || /* Since glibc 2.10: */ _POSIX_C_SOURCE\ >=\ 200112L .RE .PP @@ -90,7 +86,6 @@ _ATFILE_SOURCE .PD .ad .SH DESCRIPTION -.PP These functions return information about a file, in the buffer pointed to by .IR statbuf . No permissions are required on the file itself, but\(emin the case of @@ -356,7 +351,6 @@ The can be used in tools that scan directories to prevent mass-automounting of a directory of automount points. .IP -.IP This flag is Linux-specific; define .B _GNU_SOURCE .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed @@ -437,7 +431,7 @@ or .IR blkcnt_t . This error can occur when, for example, an application compiled on a 32-bit platform without -.I -D_FILE_OFFSET_BITS=64 +.I \-D_FILE_OFFSET_BITS=64 calls .BR stat () on a file whose size exceeds @@ -722,7 +716,7 @@ main(int argc, char *argv[]) .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statfs.2 b/man2/statfs.2 index b8787cbf3..9f9214c28 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -391,7 +391,7 @@ for file descriptors created by .BR statvfs (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/statvfs.2 b/man2/statvfs.2 deleted file mode 100644 index adec9ddea..000000000 --- a/man2/statvfs.2 +++ /dev/null @@ -1 +0,0 @@ -.so man3/statvfs.3 diff --git a/man2/statx.2 b/man2/statx.2 index 72564f702..c893fd0a6 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2017 David Howells <dhowells@redhat.com> .\" .\" Derived from the stat.2 manual page: @@ -28,7 +27,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH STATX 2 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH STATX 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME statx \- get file status (extended) .SH SYNOPSIS @@ -41,9 +40,7 @@ statx \- get file status (extended) .BI "int statx(int " dirfd ", const char *" pathname ", int " flags "," .BI " unsigned int " mask ", struct statx *" statxbuf ); .fi -.PP .SH DESCRIPTION -.PP This function returns information about a file, storing it in the buffer pointed to by .IR statxbuf . @@ -100,7 +97,6 @@ struct statx_timestamp { (Note that reserved space and padding is omitted.) .SS Invoking \fBstatx\fR(): -.PP To access a file's status, no permissions are required on the file itself, but in the case of .BR statx () @@ -249,7 +245,7 @@ is an ORed combination of the following constants: .TS lB l. STATX_TYPE Want stx_mode & S_IFMT -STATX_MODE Want stx_mode & ~S_IFMT +STATX_MODE Want stx_mode & \(tiS_IFMT STATX_NLINK Want stx_nlink STATX_UID Want stx_uid STATX_GID Want stx_gid @@ -288,7 +284,6 @@ as one or more bits may, in the future, be used to specify an extension to the buffer. .SS The returned information -.PP The status information for the target file is returned in the .I statx structure pointed to by @@ -420,7 +415,6 @@ For further information on the above fields, see .BR inode (7). .\" .SS File attributes -.PP The .I stx_attributes field contains a set of ORed flags that indicate additional attributes @@ -551,7 +545,7 @@ is Linux-specific. .BR inode (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/stime.2 b/man2/stime.2 index b66afd831..d21f4eff1 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.07 of the Linux +This page is part of release 5.08 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 b6d4572c5..85a0be837 100644 --- a/man2/subpage_prot.2 +++ b/man2/subpage_prot.2 @@ -33,7 +33,7 @@ subpage_prot \- define a subpage protection for an address range .SH SYNOPSIS .nf .BI "long subpage_prot(unsigned long " addr ", unsigned long " len , -.BI " uint32_t *" map "); +.BI " uint32_t *" map ); .fi .PP .IR Note : @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/swapon.2 b/man2/swapon.2 index e375f4eb5..45d008a12 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/symlink.2 b/man2/symlink.2 index 00fd3bd18..ee26629ac 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sync.2 b/man2/sync.2 index 9af820fa4..272901820 100644 --- a/man2/sync.2 +++ b/man2/sync.2 @@ -33,7 +33,7 @@ .\" Modified 2001-10-10 by aeb, following Michael Kerrisk. .\" 2011-09-07, mtk, Added syncfs() documentation, .\" -.TH SYNC 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SYNC 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sync, syncfs \- commit filesystem caches to disk .SH SYNOPSIS @@ -86,11 +86,26 @@ to indicate the error. is always successful. .PP .BR syncfs () -can fail for at least the following reason: +can fail for at least the following reasons: .TP .B EBADF .I fd is not a valid file descriptor. +.TP +.B EIO +An error occurred during synchronization. +This error may relate to data written to any file on the filesystem, or on +metadata related to the filesystem itself. +.TP +.B ENOSPC +Disk space was exhausted while synchronizing. +.TP +.BR ENOSPC ", " EDQUOT +Data was written to a files on NFS or another filesystem which does not +allocate space at the time of a +.BR write (2) +system call, and some previous write failed due to insufficient +storage space. .SH VERSIONS .BR syncfs () first appeared in Linux 2.6.39; @@ -114,13 +129,28 @@ always returned 0. According to the standard specification (e.g., POSIX.1-2001), .BR sync () schedules the writes, but may return before the actual -writing is done. However Linux waits for I/O completions, +writing is done. +However Linux waits for I/O completions, and thus .BR sync () or .BR syncfs () -provide the same guarantees as fsync called on every file in +provide the same guarantees as +.BR fsync () +called on every file in the system or filesystem respectively. +.PP +In mainline kernel versions prior to 5.8, +.BR syncfs () +will fail only when passed a bad file descriptor +.RB ( EBADF ). +Since Linux 5.8, +.\" commit 735e4ae5ba28c886d249ad04d3c8cc097dad6336 +.BR syncfs () +will also report an error if one or more inodes failed +to be written back since the last +.BR syncfs () +call. .SH BUGS Before version 1.3.20 Linux did not wait for I/O to complete before returning. @@ -129,7 +159,7 @@ before returning. .BR fdatasync (2), .BR fsync (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 e5aa3c466..da0bb81ec 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscall.2 b/man2/syscall.2 index bbe62f7f7..181e463db 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syscalls.2 b/man2/syscalls.2 index 51d166acb..139822676 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-04-11 "Linux" "Linux Programmer's Manual" +.TH SYSCALLS 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME syscalls \- Linux system calls .SH SYNOPSIS @@ -271,6 +271,7 @@ T} \fBexit\fP(2) 1.0 \fBexit_group\fP(2) 2.6 \fBfaccessat\fP(2) 2.6.16 +\fBfaccessat2\fP(2) 5.8 \fBfadvise64\fP(2) 2.6 .\" Implements \fBposix_fadvise\fP(2) \fBfadvise64_64\fP(2) 2.6 @@ -903,7 +904,6 @@ There was briefly added in Linux 2.6.13, and removed in 2.6.16; this system call was never available to user space. .SH NOTES -.PP Roughly speaking, the code belonging to the system call with number __NR_xxx defined in .I /usr/include/asm/unistd.h @@ -1116,7 +1116,7 @@ low-cost Alphas in order to access address space beyond first 27 bits. .BR libc (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysctl.2 b/man2/sysctl.2 index c37dfe949..0b3c2ff33 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -95,7 +95,7 @@ non-NULL, but allowed zero room in was not found. .SH VERSIONS This system call first appeared in Linux 1.3.57. -It was removed in Linux 5.5. +It was removed in Linux 5.5; glibc support was removed in version 2.32. .SH CONFORMING TO This call is Linux-specific, and should not be used in programs intended to be portable. @@ -124,7 +124,6 @@ Furthermore, glibc does not provide a wrapper for this system call, necessitating the use of .BR syscall (2). -.PP .SH BUGS The object names vary between kernel versions, making this system call worthless for applications. @@ -174,7 +173,7 @@ main(void) .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysfs.2 b/man2/sysfs.2 index f4244685d..565a6b0ae 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index 4c032bb8f..bded2ebf1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/syslog.2 b/man2/syslog.2 index f63faf25c..f30e2552e 100644 --- a/man2/syslog.2 +++ b/man2/syslog.2 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl) .\" and Copyright (C) 2012, 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" @@ -30,7 +29,7 @@ .\" 2008-02-15, Michael Kerrisk <mtk.manpages@gmail.com> .\" Update LOG_BUF_LEN details; update RETURN VALUE section. .\" -.TH SYSLOG 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SYSLOG 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME syslog, klogctl \- read and/or clear kernel message ring buffer; set console_loglevel @@ -254,7 +253,7 @@ be printed to the console. The default value for this field is .B DEFAULT_CONSOLE_LOGLEVEL (7), but it is set to -4 if the kernel command line contains the word "quiet", \" since Linux 2.4 +4 if the kernel command line contains the word "quiet",\" since Linux 2.4 10 if the kernel command line contains the word "debug", and to 15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent to 8). @@ -388,7 +387,7 @@ different animals. .BR syslog (3), .BR capabilities (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tee.2 b/man2/tee.2 index 385149f09..ec885db93 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/time.2 b/man2/time.2 index 2f427a03f..9096c3855 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.07 of the Linux +This page is part of release 5.08 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 9d3ee2b0a..3495109f4 100644 --- a/man2/timer_create.2 +++ b/man2/timer_create.2 @@ -233,7 +233,7 @@ The kernel does not support creating a timer against this was .BR CLOCK_REALTIME_ALARM or -,BR CLOCK_BOOTTIME_ALARM +.BR CLOCK_BOOTTIME_ALARM but the caller did not have the .BR CAP_WAKE_ALARM capability. @@ -499,7 +499,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 0d28e5867..1e01c51e5 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.07 of the Linux +This page is part of release 5.08 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 f99f13870..977b76452 100644 --- a/man2/timer_getoverrun.2 +++ b/man2/timer_getoverrun.2 @@ -140,7 +140,7 @@ See .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 6586677ef..dd368b582 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.07 of the Linux +This page is part of release 5.08 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 5b7358a61..70be76618 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -16,7 +16,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH TIMERFD_CREATE 2 2020-04-11 Linux "Linux Programmer's Manual" +.TH TIMERFD_CREATE 2 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME timerfd_create, timerfd_settime, timerfd_gettime \- timers that notify via file descriptors @@ -453,7 +453,7 @@ There was insufficient kernel memory to create the timer. was .BR CLOCK_REALTIME_ALARM or -,BR CLOCK_BOOTTIME_ALARM +.BR CLOCK_BOOTTIME_ALARM but the caller did not have the .BR CAP_WAKE_ALARM capability. @@ -516,7 +516,7 @@ and .BR TFD_TIMER_CANCEL_ON_SET flags; .IP (b) -A discontinuous change (e.g. +A discontinuous change (e.g., .BR settimeofday (2)) is subsequently made to the .BR CLOCK_REALTIME @@ -570,14 +570,14 @@ The following shell session demonstrates the use of the program: 0.000: timer started 3.000: read: 1; total=1 4.000: read: 1; total=2 -.BR "^Z " " # type control-Z to suspend the program" +.BR "\(haZ " " # type control-Z to suspend the program" [1]+ Stopped ./timerfd3_demo 3 1 100 .RB "$ " "fg" " # Resume execution after a few seconds" a.out 3 1 100 9.660: read: 5; total=7 10.000: read: 1; total=8 11.000: read: 1; total=9 -.BR "^C " " # type control-C to suspend the program" +.BR "\(haC " " # type control-C to suspend the program" .EE .in .SS Program source @@ -727,7 +727,7 @@ main(int argc, char *argv[]) .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/times.2 b/man2/times.2 index 799f161eb..8601ccfd2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/tkill.2 b/man2/tkill.2 index c949ae1df..3ada1af53 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/truncate.2 b/man2/truncate.2 index f3a616b31..b39ae495b 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -62,7 +62,6 @@ Feature Test Macro Requirements for glibc (see .RS 4 _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE @@ -222,7 +221,7 @@ POSIX.1-2001, POSIX.1-2008, .SH NOTES .BR ftruncate () can also be used to set the size of a POSIX shared memory object; see -.BR shm_open (7). +.BR shm_open (3). .PP The details in DESCRIPTION are for XSI-compliant systems. For non-XSI-compliant systems, the POSIX standard allows @@ -277,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umask.2 b/man2/umask.2 index 35775cbed..cfa954b21 100644 --- a/man2/umask.2 +++ b/man2/umask.2 @@ -31,7 +31,7 @@ .\" <nick@debian.com> with Lars Wirzenius <liw@iki.fi> suggestion .\" 2006-05-13, mtk, substantial rewrite of description of 'mask' .\" 2008-01-09, mtk, a few rewrites and additions. -.TH UMASK 2 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH UMASK 2 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME umask \- set file mode creation mask .SH SYNOPSIS @@ -108,7 +108,7 @@ S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH .EE .in .PP -(because 0666 & ~022 = 0644; i.e., rw\-r\-\-r\-\-). +(because 0666 & \(ti022 = 0644; i.e., rw\-r\-\-r\-\-). .SH RETURN VALUE This system call always succeeds and the previous value of the mask is returned. @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/umount.2 b/man2/umount.2 index 8386bd1c7..94e93563c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uname.2 b/man2/uname.2 index cf46531fd..765daae42 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -136,7 +136,6 @@ Part of the utsname information is also accessible via .IR version , .IR domainname }. .SS C library/kernel differences -.PP Over time, increases in the size of the .I utsname structure have led to three successive versions of @@ -170,7 +169,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unimplemented.2 b/man2/unimplemented.2 index e0439ec41..142e8a395 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unlink.2 b/man2/unlink.2 index f50a9e329..743d4c11f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/unshare.2 b/man2/unshare.2 index d80b9be90..fcbb44f3e 100644 --- a/man2/unshare.2 +++ b/man2/unshare.2 @@ -230,7 +230,7 @@ requires the .BR CAP_SYS_ADMIN capability. .TP -.BR CLONE_SYSVSEM " (since Linux 2.6.26) +.BR CLONE_SYSVSEM " (since Linux 2.6.26)" .\" commit 9edff4ab1f8d82675277a04e359d0ed8bf14a7b7 This flag reverses the effect of the .BR clone (2) @@ -474,7 +474,7 @@ new shell are in separate mount namespaces: .EX $ \fBreadlink /proc/$$/ns/mnt\fP mnt:[4026531840] -$ \fBsudo ./unshare -m /bin/bash\fP +$ \fBsudo ./unshare \-m /bin/bash\fP # \fBreadlink /proc/$$/ns/mnt\fP mnt:[4026532325] .EE @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/uselib.2 b/man2/uselib.2 index 1f8da2eb2..74f2fd41d 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -128,7 +128,7 @@ option. .BR capabilities (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 3ee2ca005..8c9499a62 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -131,7 +131,7 @@ single threaded non-cooperative userfaultfd manager implementations. .\" problematic for multi-threaded monitor. I even suspect that it would be .\" impossible to ensure synchronization between page faults and non-page .\" fault events in multi-threaded monitor. -.PP +.\" .PP .\" FIXME elaborate about non-cooperating mode, describe its limitations .\" for kernels before 4.11, features added in 4.11 .\" and limitations remaining in 4.11 @@ -666,7 +666,7 @@ fault_handler_thread(void *arg) So, round faulting address down to page boundary */ uffdio_copy.dst = (unsigned long) msg.arg.pagefault.address & - ~(page_size \- 1); + \(ti(page_size \- 1); uffdio_copy.len = page_size; uffdio_copy.mode = 0; uffdio_copy.copy = 0; @@ -766,9 +766,8 @@ main(int argc, char *argv[]) .PP .IR Documentation/admin-guide/mm/userfaultfd.rst in the Linux kernel source tree -.PP .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/ustat.2 b/man2/ustat.2 index 1b91a8188..defdeb37b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utime.2 b/man2/utime.2 index f401ac9fd..2fc0984aa 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -191,7 +191,7 @@ on an append-only file. .BR futimes (3), .BR inode (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/utimensat.2 b/man2/utimensat.2 index cfef8e342..b6826d2f2 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -269,7 +269,6 @@ capability). .\" .I fd .\" refers do not allow searches. .\" EXT2_IMMUTABLE_FL and similar flags for other filesystems. -.RE .TP .B EBADF .RB ( futimens ()) @@ -639,7 +638,7 @@ instead checks whether the .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vfork.2 b/man2/vfork.2 index 457dbfd5e..e84e24662 100644 --- a/man2/vfork.2 +++ b/man2/vfork.2 @@ -51,8 +51,8 @@ Since glibc 2.12: (_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) || /* Since glibc 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE -.TP 4 .fi +.TP 4 Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED @@ -175,7 +175,6 @@ remaining blocked until the child either terminates or calls and cannot rely on any specific behavior with respect to shared memory. .\" In AIXv3.1 vfork is equivalent to fork. .SH NOTES -.PP Some consider the semantics of .BR vfork () to be an architectural blemish, and the 4.2BSD man page stated: @@ -308,7 +307,6 @@ Since 2.2.0-pre9 (on i386, somewhat later on other architectures) it is an independent system call. Support was added in glibc 2.0.112. .SH BUGS -.PP Details of the signal handling are obscure and differ between systems. The BSD man page states: "To avoid a possible deadlock situation, processes that are children @@ -336,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vhangup.2 b/man2/vhangup.2 index 1176d5f11..6ae25a054 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vm86.2 b/man2/vm86.2 index dc7261274..56653a0e7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/vmsplice.2 b/man2/vmsplice.2 index 86b1582fe..6e821d589 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait.2 b/man2/wait.2 index 50fc57ce9..8a2ab2c8c 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -715,7 +715,7 @@ main(int argc, char *argv[]) .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/wait4.2 b/man2/wait4.2 index cb194d086..7aa8b2306 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man2/write.2 b/man2/write.2 index 2d941d394..d0c1c9700 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/CPU_SET.3 b/man3/CPU_SET.3 index 2bd0c38f7..5bbc830fc 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/INFINITY.3 b/man3/INFINITY.3 index cc6c680c3..d787c3141 100644 --- a/man3/INFINITY.3 +++ b/man3/INFINITY.3 @@ -99,7 +99,7 @@ and has a value not less than 199901L. .BR fpclassify (3), .BR math_error (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 b1c7d699b..8d5328fb4 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.07 of the Linux +This page is part of release 5.08 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 d3e17e946..88ac96ec5 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.07 of the Linux +This page is part of release 5.08 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 e39a937c9..62977705f 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -76,7 +76,7 @@ between two calls to #include <stdlib.h> #include <sys/platform/ppc.h> -/* Maximum value of the Time Base Register: 2^60 \- 1. +/* Maximum value of the Time Base Register: 2\(ha60 \- 1. Source: POWER ISA. */ #define MAX_TB 0xFFFFFFFFFFFFFFF @@ -111,7 +111,7 @@ main(void) .BR time (2), .BR usleep (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 8baf4cf61..25a2a81fa 100644 --- a/man3/__ppc_set_ppr_med.3 +++ b/man3/__ppc_set_ppr_med.3 @@ -132,7 +132,7 @@ Availability of these functions can be tested using .PP .IR "Power ISA, Book\ II - Section\ 3.1 (Program Priority Registers)" .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 411a41083..74996ecc0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index 431f8346b..8e8ca532a 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -52,18 +52,15 @@ can be used. .B __setfpucw(0x1372) .PP Set FPU control word on the i386 architecture to -.br \- extended precision -.br \- rounding to nearest -.br \- exceptions on overflow, zero divide and NaN .SH SEE ALSO .BR feclearexcept (3) .PP .I <fpu_control.h> .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/a64l.3 b/man3/a64l.3 index bb1bc3848..5cd919971 100644 --- a/man3/a64l.3 +++ b/man3/a64l.3 @@ -7,7 +7,7 @@ .\" .\" Corrected, aeb, 2002-05-30 .\" -.TH A64L 3 2016-03-15 "" "Linux Programmer's Manual" +.TH A64L 3 2020-08-13 "" "Linux Programmer's Manual" .SH NAME a64l, l64a \- convert between long and base-64 .SH SYNOPSIS @@ -61,7 +61,7 @@ a-z represent 38-63 .fi .RE .PP -So 123 = 59*64^0 + 1*64^1 = "v/". +So 123 = 59*64\(ha0 + 1*64\(ha1 = "v/". .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abort.3 b/man3/abort.3 index 473f9061b..5ff86fd38 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/abs.3 b/man3/abs.3 index 74b6a8754..3a2d61245 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -139,7 +139,7 @@ as built-in functions. .BR floor (3), .BR rint (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acos.3 b/man3/acos.3 index 03aa8f6bb..e30723b8d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/acosh.3 b/man3/acosh.3 index 92a0c2a64..e771cccc1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/addseverity.3 b/man3/addseverity.3 index 388eb3848..91bac5a24 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/adjtime.3 b/man3/adjtime.3 index 4459fb840..04b47bd3a 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.07 of the Linux +This page is part of release 5.08 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 018b0a6c2..86ced4cb0 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.07 of the Linux +This page is part of release 5.08 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 6e5613da5..77f2aefd2 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.07 of the Linux +This page is part of release 5.08 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 f3f338249..85f81e9be 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.07 of the Linux +This page is part of release 5.08 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 faad842b7..52bb08e7a 100644 --- a/man3/aio_init.3 +++ b/man3/aio_init.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2010 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH AIO_INIT 3 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH AIO_INIT 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME aio_init \- asynchronous I/O initialization .SH SYNOPSIS @@ -99,7 +98,7 @@ This function is a GNU extension. .SH SEE ALSO .BR aio (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 00446b42b..6ce37a5e2 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.07 of the Linux +This page is part of release 5.08 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 6a443cb17..50cbc0e59 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.07 of the Linux +This page is part of release 5.08 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 f9e9d2948..e71dfbc41 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.07 of the Linux +This page is part of release 5.08 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 a7eb9f82c..3f890eba8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/alloca.3 b/man3/alloca.3 index 588b3b98e..84493ae4d 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.07 of the Linux +This page is part of release 5.08 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 df7bb4d6a..c952353ee 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asin.3 b/man3/asin.3 index 4d67c16de..7dc4b76d4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asinh.3 b/man3/asinh.3 index 6a7445c73..ce1f3ebdd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/asprintf.3 b/man3/asprintf.3 index 9ee4356c7..cfb0131e4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/assert.3 b/man3/assert.3 index caad0a337..b7c7c6e09 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -51,7 +51,11 @@ The error message includes the name of the file and function containing the call, the source code line number of the call, and the text of the argument; something like: .PP - prog: some_file.c:16: some_func: Assertion `val == 0' failed. +.in +4n +.EX +prog: some_file.c:16: some_func: Assertion \`val == 0\(aq failed. +.EE +.in .PP If the macro .B NDEBUG @@ -103,7 +107,7 @@ is turned on. .BR assert_perror (3), .BR exit (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 4c971c071..f01a82448 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan.3 b/man3/atan.3 index 19129a1cd..51f204fed 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atan2.3 b/man3/atan2.3 index f00893c78..aad7c9808 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atanh.3 b/man3/atanh.3 index 634ff2ead..68d96f334 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atexit.3 b/man3/atexit.3 index 851e3e80b..e297d6427 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atof.3 b/man3/atof.3 index 5c630ed84..92aeded47 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/atoi.3 b/man3/atoi.3 index ee7300803..46c158608 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -30,7 +30,7 @@ .\" Modified Sat Jul 24 21:38:42 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sun Dec 17 18:35:06 2000, Joseph S. Myers .\" -.TH ATOI 3 2020-04-11 "GNU" "Linux Programmer's Manual" +.TH ATOI 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME atoi, atol, atoll \- convert a string to an integer .SH SYNOPSIS @@ -81,7 +81,7 @@ functions behave the same as except that they convert the initial portion of the string to their return type of \fIlong\fP or \fIlong long\fP. .SH RETURN VALUE -The converted value. +The converted value or 0 on error. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -115,13 +115,29 @@ only. .\" .BR atoll () .\" function is present in glibc 2 since version 2.0.2, but .\" not in libc4 or libc5. +.SH NOTES +POSIX.1 leaves the return value of +.BR atoi () +on error unspecified. +On glibc, musl libc, and uClibc, 0 is returned on error. +.SH BUGS +.I errno +is not set on error so there is no way to distinguish between 0 as an +error and as the converted value. +No checks for overflow or underflow are done. +Only base-10 input can be converted. +It is recommended to instead use the +.BR strtol () +and +.BR strtoul () +family of functions in new programs. .SH SEE ALSO .BR atof (3), .BR strtod (3), .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/backtrace.3 b/man3/backtrace.3 index d0aa3f201..f40a99758 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/basename.3 b/man3/basename.3 index 0b047a913..977c20bd2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcmp.3 b/man3/bcmp.3 index bd9cded82..4683e74e4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 68a09ac33..2a1391b91 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bindresvport.3 b/man3/bindresvport.3 index 5c0b07b8e..6999b0c72 100644 --- a/man3/bindresvport.3 +++ b/man3/bindresvport.3 @@ -38,7 +38,6 @@ bindresvport \- bind a socket to a privileged IP port .BI "int bindresvport(int " sockfd ", struct sockaddr_in *" sin ); .fi .SH DESCRIPTION -.PP .BR bindresvport () is used to bind the socket referred to by the file descriptor @@ -128,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.07 of the Linux +This page is part of release 5.08 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 70b5bbb50..de92f5f62 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bsearch.3 b/man3/bsearch.3 index c0dfbb06a..d8e29900d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bstring.3 b/man3/bstring.3 index 1339fa78f..6e54a1426 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -92,7 +92,7 @@ instead. .BR memmove (3), .BR memset (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bswap.3 b/man3/bswap.3 index 2dc532db5..f5c9b4217 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btowc.3 b/man3/btowc.3 index de914a35c..735e123e8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/btree.3 b/man3/btree.3 index 9ab7accdb..2a4637fb8 100644 --- a/man3/btree.3 +++ b/man3/btree.3 @@ -253,7 +253,7 @@ Bayer and Unterauer, ACM Transactions on Database Systems, Vol. 2, 1 .IR "The Art of Computer Programming Vol. 3: Sorting and Searching" , D.E. Knuth, 1968, pp 471-480. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/byteorder.3 b/man3/byteorder.3 index 18d3fb6b1..e7a40d010 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/bzero.3 b/man3/bzero.3 index 5750a44f3..7b587f779 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cabs.3 b/man3/cabs.3 index 506f0cea1..499b1f28f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacos.3 b/man3/cacos.3 index bc99e9200..7de572ef6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cacosh.3 b/man3/cacosh.3 index 240fc74f2..1f3832cc7 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.07 of the Linux +This page is part of release 5.08 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 e806bbe13..c870bcbb4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/carg.3 b/man3/carg.3 index c1962dd1a..9088a807f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casin.3 b/man3/casin.3 index 8524c25a4..04017ea4a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/casinh.3 b/man3/casinh.3 index 40044c953..d94660059 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catan.3 b/man3/catan.3 index cb4db44a2..18eed23b1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catanh.3 b/man3/catanh.3 index 7758a40da..da2a3ffea 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catgets.3 b/man3/catgets.3 index a3da7c850..3aed5f0ff 100644 --- a/man3/catgets.3 +++ b/man3/catgets.3 @@ -57,7 +57,6 @@ the application if it is to be saved or modified. The return string is always terminated with a null byte (\(aq\e0\(aq). .SH RETURN VALUE -.PP On success, .BR catgets () returns a pointer to an internal buffer area @@ -99,7 +98,7 @@ in favor of always returning .BR catopen (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/catopen.3 b/man3/catopen.3 index a9d344b0b..1684b225e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cbrt.3 b/man3/cbrt.3 index ff802b3cd..12c2d8a39 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccos.3 b/man3/ccos.3 index b9b53d40b..e585aae3a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ccosh.3 b/man3/ccosh.3 index dad316e96..9c691ad99 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ceil.3 b/man3/ceil.3 index 14b284a47..4dff3cd2a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp.3 b/man3/cexp.3 index d7bca8562..c71c69775 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cexp2.3 b/man3/cexp2.3 index a8a8fae23..53db0d4ef 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cfree.3 b/man3/cfree.3 index a67c1d4b0..82d0d865d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cimag.3 b/man3/cimag.3 index 8e876d4c8..2d973e17b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clearenv.3 b/man3/clearenv.3 index 238d24c63..b058ddb05 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clock.3 b/man3/clock.3 index e101e59e6..a5524857f 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.07 of the Linux +This page is part of release 5.08 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 8058a6ac1..d86899bf7 100644 --- a/man3/clock_getcpuclockid.3 +++ b/man3/clock_getcpuclockid.3 @@ -164,7 +164,7 @@ main(int argc, char *argv[]) .BR pthread_getcpuclockid (3), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clock_getres.3 b/man3/clock_getres.3 deleted file mode 100644 index 5b1488396..000000000 --- a/man3/clock_getres.3 +++ /dev/null @@ -1,3 +0,0 @@ -.so man2/clock_getres.2 -.\" This link provided in Section 3 because, by historical accident, -.\" the page was originally in Section 3 -- mtk, Feb 2009 diff --git a/man3/clock_gettime.3 b/man3/clock_gettime.3 deleted file mode 100644 index 5b1488396..000000000 --- a/man3/clock_gettime.3 +++ /dev/null @@ -1,3 +0,0 @@ -.so man2/clock_getres.2 -.\" This link provided in Section 3 because, by historical accident, -.\" the page was originally in Section 3 -- mtk, Feb 2009 diff --git a/man3/clock_settime.3 b/man3/clock_settime.3 deleted file mode 100644 index 5b1488396..000000000 --- a/man3/clock_settime.3 +++ /dev/null @@ -1,3 +0,0 @@ -.so man2/clock_getres.2 -.\" This link provided in Section 3 because, by historical accident, -.\" the page was originally in Section 3 -- mtk, Feb 2009 diff --git a/man3/clog.3 b/man3/clog.3 index 9491aa50d..46f89fb81 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog10.3 b/man3/clog10.3 index 9d691b2d3..e99b4f31f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/clog2.3 b/man3/clog2.3 index aaae9f9d5..b30601bc4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/closedir.3 b/man3/closedir.3 index 2d0119218..60ae0dc3c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cmsg.3 b/man3/cmsg.3 index 4a6d4b2c0..ee82b210b 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -15,7 +15,7 @@ CMSG_ALIGN, CMSG_SPACE, CMSG_NXTHDR, CMSG_FIRSTHDR \- access ancillary data .nf .B #include <sys/socket.h> .BI "struct cmsghdr *CMSG_FIRSTHDR(struct msghdr *" msgh ); -.BI "struct cmsghdr *CMSG_NXTHDR(struct msghdr *" msgh " , +.BI "struct cmsghdr *CMSG_NXTHDR(struct msghdr *" msgh , .BR " struct cmsghdr *" cmsg ); .BI "size_t CMSG_ALIGN(size_t " length ); .BI "size_t CMSG_SPACE(size_t " length ); @@ -251,7 +251,7 @@ memcpy(CMSG_DATA(cmsg), myfds, NUM_FD * sizeof(int)); .PP RFC\ 2292 .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/confstr.3 b/man3/confstr.3 index 00545c6fe..29b0c91d0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/conj.3 b/man3/conj.3 index 053c7ff63..59542977d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/copysign.3 b/man3/copysign.3 index bbad3406f..8ee6eb40f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cos.3 b/man3/cos.3 index 5dbb48a16..1adb9d358 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cosh.3 b/man3/cosh.3 index 6b4739d10..15b80b953 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cpow.3 b/man3/cpow.3 index 65331ac87..b9efff51e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/cproj.3 b/man3/cproj.3 index d7a940384..0753f4650 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/creal.3 b/man3/creal.3 index 2e2f3185e..44a9a1276 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/crypt.3 b/man3/crypt.3 index 1c04c63c5..d2bf4f464 100644 --- a/man3/crypt.3 +++ b/man3/crypt.3 @@ -225,8 +225,8 @@ then the result has the form: .RS .PP $\fIid\fP$\fIsalt\fP$\fIencrypted\fP -.PP .RE +.PP .I id identifies the encryption method used instead of DES and this then determines how the rest of the password string is interpreted. @@ -285,8 +285,8 @@ result has the form .RS .PP $\fIid\fP$\fIrounds=yyy\fP$\fIsalt\fP$\fIencrypted\fP -.PP .RE +.PP where \fIyyy\fP is the number of hashing rounds actually used. The number of rounds actually used is 1000 if .I xxx @@ -304,7 +304,7 @@ otherwise. .BR getpass (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csin.3 b/man3/csin.3 index 86d39716f..64e93524f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csinh.3 b/man3/csinh.3 index e9b79937f..a7d4d9b99 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/csqrt.3 b/man3/csqrt.3 index e9a2b0f66..d72482e16 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctan.3 b/man3/ctan.3 index 2becc72e1..c1c324b96 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctanh.3 b/man3/ctanh.3 index e32c6fda4..8306addc4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctermid.3 b/man3/ctermid.3 index 03b268ba5..2202306ec 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ctime.3 b/man3/ctime.3 index f47d0587e..dfb726cd8 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -444,7 +444,7 @@ should be called before .BR tzset (3), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/daemon.3 b/man3/daemon.3 index cc11871d9..173d6c0b8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dbopen.3 b/man3/dbopen.3 index 54dfe66bc..1567bc90e 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.07 of the Linux +This page is part of release 5.08 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 6358c6455..ba27f6529 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/difftime.3 b/man3/difftime.3 index 224f81d20..15c9784d2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dirfd.3 b/man3/dirfd.3 index dce72e60b..2224a1fa9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/div.3 b/man3/div.3 index 09d985018..b77aa47ec 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.07 of the Linux +This page is part of release 5.08 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 e92dae9d8..b35f4a4cb 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -295,7 +295,6 @@ Name: "/lib64/ld-linux-x86-64.so.2" (7 segments) 6: [0x7f55718afba0; memsz: 460] flags: 0x4; PT_GNU_RELRO .EE .in -.PP .SS Program source \& .EX @@ -359,7 +358,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dladdr.3 b/man3/dladdr.3 index 866ea6175..cdd435f38 100644 --- a/man3/dladdr.3 +++ b/man3/dladdr.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2015 Michael Kerrisk <mtk.manpages@gmail.com> .\" and Copyright (C) 2008 Petr Baudis <pasky@suse.cz> (dladdr caveat) .\" @@ -24,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DLADDR 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH DLADDR 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME dladdr, dladdr1 \- translate address to symbolic information .SH SYNOPSIS @@ -169,7 +168,7 @@ STT_NOTYPE Symbol type is unspecified STT_OBJECT Symbol is a data object STT_FUNC Symbol is a code object STT_SECTION Symbol associated with a section -STT_FILE Symbol's name is file name +STT_FILE Symbol's name is filename STT_COMMON Symbol is a common data object STT_TLS Symbol is thread-local data object STT_GNU_IFUNC Symbol is indirect code object @@ -289,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlerror.3 b/man3/dlerror.3 index 0d1f25fe4..3bccfb417 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index 51638e332..283225308 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2015 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -148,7 +147,6 @@ fields of the buffer allocated in the previous step. Use a .B RTLD_DI_SERINFO to obtain the library search paths. -.IP .RE .IP The @@ -334,7 +332,7 @@ main(int argc, char *argv[]) .BR dlsym (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 22dd4e23f..f6ebef5b3 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -596,7 +596,7 @@ main(void) The 2013 Technical Corrigendum 1 to POSIX.1-2008 improved matters by requiring that conforming implementations support casting 'void *' to a function pointer. Nevertheless, some compilers - (e.g., gcc with the '-pedantic' option) may complain about the + (e.g., gcc with the '\-pedantic' option) may complain about the cast used in this program. */ .\" http://pubs.opengroup.org/onlinepubs/009695399/functions/dlsym.html#tag_03_112_08 .\" http://pubs.opengroup.org/onlinepubs/9699919799/functions/dlsym.html#tag_16_96_07 @@ -622,13 +622,13 @@ main(void) .BR dlerror (3), .BR dlinfo (3), .BR dlsym (3), -.BR rtld-audit (7), +.BR rtld\-audit (7), .BR ld.so (8), .BR ldconfig (8) .PP gcc info pages, ld info pages .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dlsym.3 b/man3/dlsym.3 index cdd736cf5..213302cc9 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -105,7 +105,6 @@ and from .IR <dlfcn.h> . .PP -.PP The function .BR dlvsym () does the same as @@ -146,7 +145,7 @@ function is a GNU extension. There are several scenarios when the address of a global symbol is NULL. For example, a symbol can be placed at zero address by the linker, via a linker script or with -.I --defsym +.I \-\-defsym command-line option. Undefined weak symbols also have NULL value. Finally, the symbol value may be the result of a GNU indirect function (IFUNC) resolver function that returns @@ -177,7 +176,7 @@ See .BR dlopen (3), .BR ld.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/drand48.3 b/man3/drand48.3 index 5c1097732..29b2f2581 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -278,7 +278,7 @@ POSIX.1-2001, POSIX.1-2008, SVr4. .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 891708cea..7bcb69e7a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 14c870db4..e49e9c276 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -186,7 +185,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/dysize.3 b/man3/dysize.3 index 1d8e0d0a8..a5ce033c0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ecvt.3 b/man3/ecvt.3 index 5d5f5c490..56cc20ea4 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.07 of the Linux +This page is part of release 5.08 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 93e282c39..dae8d73f1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/encrypt.3 b/man3/encrypt.3 index b95c5a96d..206a2cf7f 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -218,7 +218,7 @@ main(void) .BR ecb_crypt (3), .\" .BR fcrypt (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/end.3 b/man3/end.3 index 4e23d1e9a..814d92b4a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/endian.3 b/man3/endian.3 index 80810f0d9..91f91bbd4 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.07 of the Linux +This page is part of release 5.08 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 7d04f478e..7b96f984e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erf.3 b/man3/erf.3 index 127a37b4a..5b6b179c3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/erfc.3 b/man3/erfc.3 index 2f9520f56..729085974 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/err.3 b/man3/err.3 index c72a6b166..92192fc50 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/errno.3 b/man3/errno.3 index d740cf6d4..f308d7afb 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -145,7 +145,7 @@ $ \fBerrno \-s permission\fP EACCES 13 Permission denied .EE .in -.PP +.\".PP .\" POSIX.1 (2001 edition) lists the following symbolic error names. Of .\" these, \fBEDOM\fP and \fBERANGE\fP are in the ISO C standard. ISO C .\" Amendment 1 defines the additional error number \fBEILSEQ\fP for @@ -650,7 +650,7 @@ and it will cause problems with modern versions of the C library. .BR perror (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/error.3 b/man3/error.3 index 1c8f5f147..394739ec9 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.07 of the Linux +This page is part of release 5.08 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 19816119e..8ec12df0c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index e92abed3a..930c5d3e5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exec.3 b/man3/exec.3 index 6ea7b5edd..8eb4a8568 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -83,7 +83,6 @@ to be executed. The functions can be grouped based on the letters following the "exec" prefix. .\" .SS l - execl(), execlp(), execle() -.PP The .I "const char\ *arg" and subsequent ellipses can be thought of as @@ -105,7 +104,6 @@ By contrast with the 'l' functions, the 'v' functions (below) specify the command-line arguments of the executed program as a vector. .\" .SS v - execv(), execvp(), execvpe() -.PP The .I "char\ *const argv[]" argument is an array of pointers to null-terminated strings that @@ -116,7 +114,6 @@ The array of pointers .I must be terminated by a null pointer. .SS e - execle(), execvpe() -.PP The environment of the caller is specified via the argument .IR envp . The @@ -133,7 +130,6 @@ image from the external variable .I environ in the calling process. .SS p - execlp(), execvp(), execvpe() -.PP These functions duplicate the actions of the shell in searching for an executable file if the specified filename does not contain a slash (/) character. @@ -301,7 +297,7 @@ wrapper function on those architectures. .BR system (3), .BR environ (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exit.3 b/man3/exit.3 index c4bb8d4f2..42ef15ba0 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -107,7 +107,6 @@ so it is not thread-safe. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .SH NOTES -.PP The behavior is undefined if one of the functions registered using .BR atexit (3) and @@ -214,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp.3 b/man3/exp.3 index fc41f5dc9..c954ebf55 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp10.3 b/man3/exp10.3 index 3d3195ec9..66c794af0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/exp2.3 b/man3/exp2.3 index eb17b8729..4a3f2de73 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/expm1.3 b/man3/expm1.3 index f1d102627..2b1288775 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fabs.3 b/man3/fabs.3 index 323f47e14..50792c042 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fclose.3 b/man3/fclose.3 index 04a96a637..12c5a5cee 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fcloseall.3 b/man3/fcloseall.3 index 51f4aea14..b5723c0e4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fdim.3 b/man3/fdim.3 index 16fe0070a..9dbe6c683 100644 --- a/man3/fdim.3 +++ b/man3/fdim.3 @@ -67,7 +67,6 @@ is set to An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. -.PP .SH VERSIONS These functions first appeared in glibc in version 2.1. .SH ATTRIBUTES @@ -95,7 +94,7 @@ these functions did not set .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fenv.3 b/man3/fenv.3 index 365ad62e4..312f96ada 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ferror.3 b/man3/ferror.3 index f75938350..edb678676 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 385a142f9..8030daf96 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fflush.3 b/man3/fflush.3 index 74cbc997e..084a51ff7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ffs.3 b/man3/ffs.3 index 9b36c8e52..2b9ca9c34 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetc.3 b/man3/fgetc.3 index 0e94e812a..84cbbea29 100644 --- a/man3/fgetc.3 +++ b/man3/fgetc.3 @@ -166,7 +166,7 @@ will be undefined and very probably not what you want. .BR unlocked_stdio (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 7c4e0a9d2..12c41d13d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index 2f75254bf..7f2bcf2cf 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetwc.3 b/man3/fgetwc.3 index f0fe55c74..6b5d3a633 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fgetws.3 b/man3/fgetws.3 index 187fe4c93..608d71eed 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/finite.3 b/man3/finite.3 index 5feea42b4..8e7197e71 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/flockfile.3 b/man3/flockfile.3 index 5641003a0..9bd170882 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/floor.3 b/man3/floor.3 index 260a1610e..8bc0c6daf 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fma.3 b/man3/fma.3 index 0dc472691..7f92c69eb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmax.3 b/man3/fmax.3 index 98d1bfc52..57b9c6ec4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index d0d414d30..8cb81a0b0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmin.3 b/man3/fmin.3 index 8cf3947a7..e513edc58 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmod.3 b/man3/fmod.3 index 250866f5a..c52f19837 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index b058050f9..69d37282c 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -325,12 +325,11 @@ unknown mount option TO FIX: See mount(8). .EE .in -.PP .SH SEE ALSO .BR addseverity (3), .BR perror (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 3b9d96691..257a75db6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopen.3 b/man3/fopen.3 index 65531e644..e57d7fc39 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -412,7 +412,7 @@ parses at most 5 characters in .BR fopencookie (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 85c3c5e32..e74d4d9a4 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -452,7 +452,7 @@ main(int argc, char *argv[]) .BR fopen (3), .BR fseek (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index e13e05f20..2028cdb63 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpclassify.3 b/man3/fpclassify.3 index 46ed38435..772066420 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fpurge.3 b/man3/fpurge.3 index fd563c279..24f26ab7c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputwc.3 b/man3/fputwc.3 index 93df42bc1..bc0c3d650 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fputws.3 b/man3/fputws.3 index 252c77676..1d087b519 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fread.3 b/man3/fread.3 index 49eb1f346..91abfbf41 100644 --- a/man3/fread.3 +++ b/man3/fread.3 @@ -1,4 +1,5 @@ .\" Copyright (c) 1990, 1991 The Regents of the University of California. +.\" and Copyright (c) 2020 Arkadiusz Drabczyk <arkadiusz@drabczyk.org> .\" All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by @@ -42,7 +43,7 @@ .\" Modified Thu Apr 20 20:43:53 1995 by Jim Van Zandt <jrv@vanzandt.mv.com> .\" Modified Fri May 17 10:21:51 1996 by Martin Schulze <joey@infodrom.north.de> .\" -.TH FREAD 3 2015-07-23 "GNU" "Linux Programmer's Manual" +.TH FREAD 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME fread, fwrite \- binary stream input/output .SH SYNOPSIS @@ -92,6 +93,9 @@ is 1. If an error occurs, or the end of the file is reached, the return value is a short item count (or zero). .PP +The file position indicator for the stream is advanced by the number +of bytes successfully read or written. +.PP .BR fread () does not distinguish between end-of-file and error, and callers must use .BR feof (3) @@ -113,6 +117,60 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89. +.SH EXAMPLES +The program below demonstrates the use of +.BR fread () +by parsing /bin/sh ELF executable in binary mode and printing its +magic and class: +.PP +.in +4n +.EX +$ \fB./a.out\fP +ELF magic: 0x7f454c46 +Class: 0x02 +.EE +.in +.SS Program source +\& +.EX +#include <stdio.h> +#include <stdlib.h> + +int +main(void) +{ + FILE *fp = fopen("/bin/sh", "rb"); + if (!fp) { + perror("fopen"); + return EXIT_FAILURE; + } + + unsigned char buffer[4]; + + size_t ret = + fread(buffer, sizeof(buffer) / sizeof(*buffer), sizeof(*buffer), + fp); + if (ret != sizeof(*buffer)) { + fprintf(stderr, "fread() failed: %zu\en", ret); + exit(EXIT_FAILURE); + } + + printf("ELF magic: %#04x%02x%02x%02x\en", buffer[0], buffer[1], + buffer[2], buffer[3]); + + ret = fread(buffer, 1, 1, fp); + if (ret != 1) { + fprintf(stderr, "fread() failed: %zu\en", ret); + exit(EXIT_FAILURE); + } + + printf("Class: %#04x\en", buffer[0]); + + fclose(fp); + + exit(EXIT_SUCCESS); +} +.EE .SH SEE ALSO .BR read (2), .BR write (2), @@ -120,7 +178,7 @@ POSIX.1-2001, POSIX.1-2008, C89. .BR ferror (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/frexp.3 b/man3/frexp.3 index 91edbf899..bbef76079 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -124,9 +124,9 @@ The program below produces results such as the following: .in +4n .EX .RB "$" " ./a.out 2560" -frexp(2560, &e) = 0.625: 0.625 * 2^12 = 2560 +frexp(2560, &e) = 0.625: 0.625 * 2\(ha12 = 2560 .RB "$" " ./a.out \-4" -frexp(\-4, &e) = \-0.5: \-0.5 * 2^3 = \-4 +frexp(\-4, &e) = \-0.5: \-0.5 * 2\(ha3 = \-4 .EE .in .SS Program source @@ -146,7 +146,7 @@ main(int argc, char *argv[]) x = strtod(argv[1], NULL); r = frexp(x, &exp); - printf("frexp(%g, &e) = %g: %g * %d^%d = %g\en", + printf("frexp(%g, &e) = %g: %g * %d\(ha%d = %g\en", x, r, r, FLT_RADIX, exp, x); exit(EXIT_SUCCESS); } @@ -155,7 +155,7 @@ main(int argc, char *argv[]) .BR ldexp (3), .BR modf (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseek.3 b/man3/fseek.3 index e0df7e744..bc3112e10 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fseeko.3 b/man3/fseeko.3 index 436d9cd46..60d492067 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftime.3 b/man3/ftime.3 index 438b9bdd1..5649da754 100644 --- a/man3/ftime.3 +++ b/man3/ftime.3 @@ -102,7 +102,6 @@ gives microseconds; .BR clock_gettime (2) gives nanoseconds but is not as widely available. .SH BUGS -.PP Early glibc2 is buggy and returns 0 in the .I millitm field; @@ -115,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftok.3 b/man3/ftok.3 index 44f336219..0ef700bd5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fts.3 b/man3/fts.3 index 4b43f96a0..2f86b326b 100644 --- a/man3/fts.3 +++ b/man3/fts.3 @@ -47,7 +47,7 @@ traverse a file hierarchy .B #include <sys/stat.h> .B #include <fts.h> .PP -.BI "FTS *fts_open(char * const *" path_argv ", int " options ", " +.BI "FTS *fts_open(char * const *" path_argv ", int " options , .BI " int (*" compar ")(const FTSENT **, const FTSENT **));" .PP .BI "FTSENT *fts_read(FTS *" ftsp ); @@ -822,7 +822,7 @@ In versions of glibc before 2.23, .\" https://sourceware.org/bugzilla/show_bug.cgi?id=11460 all of the APIs described in this man page are not safe when compiling a program using the LFS APIs (e.g., when compiling with -.IR -D_FILE_OFFSET_BITS=64 ). +.IR \-D_FILE_OFFSET_BITS=64 ). .\" .\" The following statement is years old, and seems no closer to .\" being true -- mtk @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ftw.3 b/man3/ftw.3 index 11819feb4..86ebc9af1 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -441,7 +441,8 @@ is passed in This regression was eventually fixed in glibc 2.30, .\" https://bugzilla.redhat.com/show_bug.cgi?id=1422736 .\" http://austingroupbugs.net/view.php?id=1121 -.\" https://bugzilla.redhat.com/show_bug.cgi?id=1422736 +.\" glibc commit 6ba205b2c35e3e024c8c12d2ee1b73363e84da87 +.\" https://sourceware.org/bugzilla/show_bug.cgi?id=23501 so that the glibc implementation (once more) follows the POSIX specification. .SH EXAMPLES The following program traverses the directory tree under the path named @@ -508,7 +509,7 @@ main(int argc, char *argv[]) .BR fts (3), .BR readdir (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/futimes.3 b/man3/futimes.3 index d109fa51d..685f6312d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/fwide.3 b/man3/fwide.3 index 0961bd021..750b2ef92 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gamma.3 b/man3/gamma.3 index a763d1e1b..585d3f64e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gcvt.3 b/man3/gcvt.3 index c17d5d94e..82c93b9e2 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.07 of the Linux +This page is part of release 5.08 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 325d7bc56..e4774fe1f 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.07 of the Linux +This page is part of release 5.08 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 e5f6d4183..6747cb7e7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 8e377d5d7..98204077d 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -424,7 +424,6 @@ function frees the memory that was allocated for the dynamically allocated linked list .IR res . .SS Extensions to getaddrinfo() for Internationalized Domain Names -.PP Starting with glibc 2.3.4, .BR getaddrinfo () has been extended to selectively allow the incoming and outgoing @@ -853,7 +852,7 @@ main(int argc, char *argv[]) .BR hostname (7), .BR ip (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 bbd61357d..e674d5493 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getauxval.3 b/man3/getauxval.3 index 8649ab875..fbe8a7ee9 100644 --- a/man3/getauxval.3 +++ b/man3/getauxval.3 @@ -192,7 +192,7 @@ Alternatively, a nonzero value may be triggered by a Linux Security Module. When this value is nonzero, the dynamic linker disables the use of certain environment variables (see -.BR ld-linux.so (8)) +.BR ld\-linux.so (8)) and glibc changes other aspects of its behavior. (See also .BR secure_getenv (3).) @@ -247,7 +247,7 @@ This function is a nonstandard glibc extension. .SH NOTES The primary consumer of the information in the auxiliary vector is the dynamic linker, -.BR ld-linux.so (8). +.BR ld\-linux.so (8). The auxiliary vector is a convenient and efficient shortcut that allows the kernel to communicate a certain set of standard information that the dynamic linker usually or always needs. @@ -284,9 +284,9 @@ was zero. .SH SEE ALSO .BR secure_getenv (3), .BR vdso (7), -.BR ld-linux.so (8) +.BR ld\-linux.so (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcontext.3 b/man3/getcontext.3 index 6de05e73f..36edf9fc2 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -205,7 +205,7 @@ instead. .BR makecontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getcwd.3 b/man3/getcwd.3 index 3a1569478..4a51dcd9a 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -63,8 +63,8 @@ Since glibc 2.12: (_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) || /* Glibc since 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE -.TP 4 .fi +.TP 4 Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdate.3 b/man3/getdate.3 index a6fd71e3b..d51206c0b 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -323,7 +323,7 @@ main(int argc, char *argv[]) .BR strftime (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 329f4ae2f..ec81ab7bb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getdtablesize.3 b/man3/getdtablesize.3 index 1566d2780..bbe86b429 100644 --- a/man3/getdtablesize.3 +++ b/man3/getdtablesize.3 @@ -47,8 +47,8 @@ Since glibc 2.12: /* Glibc since 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE || ! (_POSIX_C_SOURCE\ >=\ 200112L) -.TP 4 .fi +.TP 4 Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED @@ -106,7 +106,7 @@ when that fails. .BR getrlimit (2), .BR open (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getentropy.3 b/man3/getentropy.3 index 8db75537b..61f1a4dcf 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getenv.3 b/man3/getenv.3 index 0d5e522e0..383ceee72 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getfsent.3 b/man3/getfsent.3 index b23e00820..8f71c82b0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 34caa0114..59d5266df 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.07 of the Linux +This page is part of release 5.08 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 a54551766..308062352 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -218,7 +218,7 @@ main(void) .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index 09f6d0730..b92262a8b 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -172,7 +172,7 @@ In case of error, an error number is returned, and NULL is stored in .IR *result . .SH ERRORS .TP -.BR 0 " or " ENOENT " or " ESRCH " or " EBADF " or " EPERM " or ... " +.BR 0 " or " ENOENT " or " ESRCH " or " EBADF " or " EPERM " or ..." The given .I name or @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index 9d5e0cc90..3f8897e3b 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -122,7 +122,6 @@ in the array even when the number of groups exceeds .IR *ngroups . .SH EXAMPLES -.PP The program below displays the group list for the user named in its first command-line argument. The second command-line argument specifies the @@ -209,7 +208,7 @@ main(int argc, char *argv[]) .BR group (5), .BR passwd (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index a32d0211a..f9c5ade23 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -254,7 +254,6 @@ keyword was used to control the order of host lookups as defined in .IR /etc/host.conf .RB ( host.conf (5)). .PP -.PP The \fIhostent\fP structure is defined in \fI<netdb.h>\fP as follows: .PP .in +4n @@ -549,7 +548,7 @@ that are expressed in hexadecimal. .BR named (8) .\" .BR resolv+ (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gethostid.3 b/man3/gethostid.3 index 18b72fb93..11eab1dc5 100644 --- a/man3/gethostid.3 +++ b/man3/gethostid.3 @@ -42,7 +42,6 @@ Feature Test Macro Requirements for glibc (see .in .PP .ad l -.br .BR gethostid (): .RS 4 _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 @@ -64,7 +63,7 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 and .BR sethostid () respectively get or set a unique 32-bit identifier for the current machine. -The 32-bit identifier is intended to be unique among all UNIX systems in +The 32-bit identifier was intended to be unique among all UNIX systems in existence. This normally resembles the Internet address for the local machine, as returned by @@ -148,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index c639be436..f07732ba0 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -327,7 +327,7 @@ int main(int argc, char *argv[]) .BR packet (7), .BR ifconfig (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index b39202f69..fc3b6f9f2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getline.3 b/man3/getline.3 index 02d743657..e2456d6f1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getloadavg.3 b/man3/getloadavg.3 index 4b52fcfb7..8dab26adb 100644 --- a/man3/getloadavg.3 +++ b/man3/getloadavg.3 @@ -94,7 +94,7 @@ Present on the BSDs and Solaris. .BR uptime (1), .BR proc (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getlogin.3 b/man3/getlogin.3 index 03814eab9..3105900d9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getmntent.3 b/man3/getmntent.3 index f5b999b92..b902e9083 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index f92a659d9..8ecd0c9b0 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -116,7 +116,6 @@ If set, then the numeric form of the service address is returned. (When not set, this will still happen in case the service's name cannot be determined.) .SS Extensions to getnameinfo() for Internationalized Domain Names -.PP Starting with glibc 2.3.4, .BR getnameinfo () has been extended to selectively allow @@ -331,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getnetent.3 b/man3/getnetent.3 index 970c6eeef..6805c3c20 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -210,7 +210,7 @@ was of type .br RFC\ 1101 .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 4898d286b..9a38e35fd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getopt.3 b/man3/getopt.3 index 8bdf1359a..50ea6b3ec 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpass.3 b/man3/getpass.3 index f93dfcadd..e40365f35 100644 --- a/man3/getpass.3 +++ b/man3/getpass.3 @@ -128,7 +128,7 @@ Removed in POSIX.1-2001. .\" are transmitted as part of the password. .\" Since libc 5.4.19 also line editing is disabled, so that also .\" backspace and the like will be seen as part of the password. -.PP +. In the GNU C library implementation, if .I /dev/tty cannot be opened, the prompt is written to @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index 7d906d2a8..7a0045b0e 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -196,7 +196,7 @@ POSIX.1-2001, POSIX.1-2008, 4.3BSD. .BR getservent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 1d3cb4270..934ff5296 100644 --- a/man3/getprotoent_r.3 +++ b/man3/getprotoent_r.3 @@ -256,7 +256,7 @@ main(int argc, char *argv[]) .BR getprotoent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpt.3 b/man3/getpt.3 index 6d55eb9ca..065595f29 100644 --- a/man3/getpt.3 +++ b/man3/getpt.3 @@ -4,9 +4,9 @@ .\" Redistribute and modify at will. .\" %%%LICENSE_END .\" -.TH GETPT 3 2020-02-09 "GNU" "Linux Programmer's Manual" +.TH GETPT 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME -getpt \- open the pseudoterminal master (PTM) +getpt \- open a new pseudoterminal master .SH SYNOPSIS .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" @@ -16,8 +16,9 @@ getpt \- open the pseudoterminal master (PTM) .fi .SH DESCRIPTION .BR getpt () -opens a pseudoterminal master and returns its file descriptor. -It is equivalent to +opens a new pseudoterminal device and returns a file descriptor +that refers to that device. +It is equivalent to opening the pseudoterminal multiplexor device .PP .in +4n .EX @@ -25,8 +26,8 @@ open("/dev/ptmx", O_RDWR); .EE .in .PP -on Linux systems, though the pseudoterminal master is located -elsewhere on some systems that use GNU Libc. +on Linux systems, though the pseudoterminal multiplexor device is located +elsewhere on some systems that use the GNU C library. .SH RETURN VALUE .BR getpt () returns an open file descriptor upon successful completion. @@ -67,7 +68,7 @@ instead. .BR ptmx (4), .BR pty (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpw.3 b/man3/getpw.3 index f8b6242b5..39e5c3a2a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwent.3 b/man3/getpwent.3 index 47d9b5ab5..b89c08f8f 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.07 of the Linux +This page is part of release 5.08 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 fcc17101c..ed51cb429 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -218,7 +218,7 @@ main(void) .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 94a41ff4e..c02bf316b 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -178,7 +178,7 @@ In case of error, an error number is returned, and NULL is stored in .IR *result . .SH ERRORS .TP -.BR 0 " or " ENOENT " or " ESRCH " or " EBADF " or " EPERM " or ... " +.BR 0 " or " ENOENT " or " ESRCH " or " EBADF " or " EPERM " or ..." The given .I name or @@ -338,7 +338,7 @@ main(int argc, char *argv[]) .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index 3444d1146..476535084 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -24,7 +24,6 @@ RPC entry .BI "void endrpcent(void);" .fi .SH DESCRIPTION -.PP The .BR getrpcent (), .BR getrpcbyname (), @@ -131,7 +130,7 @@ to be saved. .BR rpcinfo (8), .BR ypserv (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 435a249a9..ee47cad52 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getrpcport.3 b/man3/getrpcport.3 index d4300612b..0bfec9af6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gets.3 b/man3/gets.3 index f3152e770..2daddecd7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getservent.3 b/man3/getservent.3 index aa74cdd7c..d2b372415 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -213,7 +213,7 @@ POSIX.1-2001, POSIX.1-2008, 4.3BSD. .BR getservent_r (3), .BR services (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 1bb424fb8..2ad159f72 100644 --- a/man3/getservent_r.3 +++ b/man3/getservent_r.3 @@ -259,7 +259,7 @@ main(int argc, char *argv[]) .BR getservent (3), .BR services (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getspnam.3 b/man3/getspnam.3 index c69299b5c..5e49a64b3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getsubopt.3 b/man3/getsubopt.3 index cf1f2caea..3464c7cdc 100644 --- a/man3/getsubopt.3 +++ b/man3/getsubopt.3 @@ -42,7 +42,6 @@ Feature Test Macro Requirements for glibc (see .PD 0 _XOPEN_SOURCE\ >= 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED -.br || /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L .PD .RE @@ -54,7 +53,7 @@ parses the list of comma-separated suboptions provided in (Such a suboption list is typically produced when .BR getopt (3) is used to parse a command line; -see for example the \fI-o\fP option of +see for example the \fI\-o\fP option of .BR mount (8).) Each suboption may include an associated value, which is separated from the suboption name by an equal sign. @@ -143,7 +142,6 @@ T} Thread safety MT-Safe .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES -.PP Since .BR getsubopt () overwrites any commas it finds in the string @@ -241,7 +239,7 @@ main(int argc, char **argv) .SH SEE ALSO .BR getopt (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getttyent.3 b/man3/getttyent.3 index 119954e22..e4a610082 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getumask.3 b/man3/getumask.3 index e263c9c00..933eb8baf 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getusershell.3 b/man3/getusershell.3 index ea3e2dd98..6d40e1151 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -93,9 +93,7 @@ The .BR getusershell () function returns NULL on end-of-file. .SH FILES -.nf -/etc/shells -.fi +.I /etc/shells .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). @@ -116,7 +114,7 @@ T} Thread safety MT-Unsafe .SH SEE ALSO .BR shells (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutent.3 b/man3/getutent.3 index 143a991b8..e155c11c6 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -362,7 +362,7 @@ main(int argc, char *argv[]) .BR getutmp (3), .BR utmp (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getutmp.3 b/man3/getutmp.3 index 7e3b40881..c38c3ff65 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getw.3 b/man3/getw.3 index bd7462380..945f2fdc0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/getwchar.3 b/man3/getwchar.3 index 4e533bf91..10af0d7d0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/glob.3 b/man3/glob.3 index 7678a4574..060f6f9e6 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -175,11 +175,11 @@ even if there is no file with that name. .TP .B GLOB_TILDE Carry out tilde expansion. -If a tilde (\(aq~\(aq) is the only character in the pattern, +If a tilde (\(aq\(ti\(aq) is the only character in the pattern, or an initial tilde is followed immediately by a slash (\(aq/\(aq), then the home directory of the caller is substituted for the tilde. -If an initial tilde is followed by a username (e.g., "~andrea/bin"), +If an initial tilde is followed by a username (e.g., "\(tiandrea/bin"), then the tilde and username are substituted by the home directory of that user. If the username is invalid, or the home directory cannot be @@ -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.07 of the Linux +This page is part of release 5.08 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 1ffb8aa68..3eff43f50 100644 --- a/man3/gnu_get_libc_version.3 +++ b/man3/gnu_get_libc_version.3 @@ -28,7 +28,7 @@ gnu_get_libc_version, gnu_get_libc_release \- get glibc version and release .SH SYNOPSIS .nf -.B #include <gnu/libc-version.h> +.B #include <gnu/libc\-version.h> .PP .B const char *gnu_get_libc_version(void); .B const char *gnu_get_libc_release(void); @@ -89,7 +89,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR confstr (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/grantpt.3 b/man3/grantpt.3 index 9a0a0ff47..d31e2c53c 100644 --- a/man3/grantpt.3 +++ b/man3/grantpt.3 @@ -31,7 +31,7 @@ Glibc 2.23 and earlier: The .BR grantpt () function changes the mode and owner of the slave pseudoterminal device -corresponding to the master pseudoterminal referred to by +corresponding to the master pseudoterminal referred to by the file descriptor .IR fd . The user ID of the slave is set to the real UID of the calling process. The group ID is set to an unspecified value (e.g., @@ -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.07 of the Linux +This page is part of release 5.08 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 95a7fd1b3..16c10d517 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/gsignal.3 b/man3/gsignal.3 index 33e7707e5..a93a234c0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hash.3 b/man3/hash.3 index 7503626e0..aa4d1e927 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hsearch.3 b/man3/hsearch.3 index c50ee404d..bb4f7dd17 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -193,7 +193,6 @@ In the event of an error, these two functions set .I errno to indicate the cause of the error. .SH ERRORS -.PP .BR hcreate_r () and .BR hdestroy_r () @@ -298,7 +297,6 @@ updating the \fIdata\fP for the given \fIkey\fP in this case. .PP Individual hash table entries can be added, but not deleted. .SH EXAMPLES -.PP The following program inserts 24 items into a hash table, then prints some of them. .PP @@ -353,7 +351,7 @@ main(void) .BR malloc (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/hypot.3 b/man3/hypot.3 index 4ffd819bf..7014c7c44 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iconv.3 b/man3/iconv.3 index 9f4fa29be..c9186eaae 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.07 of the Linux +This page is part of release 5.08 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 6543ee93f..70059c712 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.07 of the Linux +This page is part of release 5.08 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 b67481da2..f10a6e424 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.07 of the Linux +This page is part of release 5.08 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 a00031b8e..8876841d5 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -30,7 +30,7 @@ if_nameindex, if_freenameindex \- get network interface names and indexes .nf .B #include <net/if.h> .PP -.BI "struct if_nameindex *if_nameindex(void); +.BI "struct if_nameindex *if_nameindex(" void ); .BI "void if_freenameindex(struct if_nameindex *" "ptr" ); .fi .SH DESCRIPTION @@ -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.07 of the Linux +This page is part of release 5.08 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 698c4a9da..e2e269445 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ilogb.3 b/man3/ilogb.3 index 8b541a479..2cd38670e 100644 --- a/man3/ilogb.3 +++ b/man3/ilogb.3 @@ -119,7 +119,6 @@ is raised, and is set to .BR EDOM (but see BUGS). -.IP .TP Domain error: \fIx\fP is an infinity An invalid floating-point exception @@ -166,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/index.3 b/man3/index.3 index 5a5b8b567..479d180ff 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/inet.3 b/man3/inet.3 index 3fa0cfec1..c348f263a 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -340,7 +340,7 @@ main(int argc, char *argv[]) .BR hosts (5), .BR networks (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 d22017028..8c23109d6 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -391,7 +390,7 @@ main(int argc, char *argv[]) .BR inet (3), .BR networks (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 82351d00b..2eb628710 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.07 of the Linux +This page is part of release 5.08 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 8c9ce8665..99841f2bd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/initgroups.3 b/man3/initgroups.3 index 59208054c..dd69b6cc3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/insque.3 b/man3/insque.3 index 3a8cad64d..56a625115 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -155,7 +155,7 @@ Here is an example run of the program: .PP .in +4n .EX -.RB "$ " "./a.out -c a b c" +.RB "$ " "./a.out \-c a b c" Traversing completed list: a b @@ -261,7 +261,7 @@ main(int argc, char *argv[]) .SH SEE ALSO .BR queue (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/intro.3 b/man3/intro.3 index 8f17312f0..097168a6a 100644 --- a/man3/intro.3 +++ b/man3/intro.3 @@ -108,7 +108,7 @@ Note that these can be different from page to page! .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isalpha.3 b/man3/isalpha.3 index 42c3342af..19811080a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isatty.3 b/man3/isatty.3 index 38b5ce719..343385553 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isfdtype.3 b/man3/isfdtype.3 index 1a32d8f33..d7a4076b4 100644 --- a/man3/isfdtype.3 +++ b/man3/isfdtype.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH ISFDTYPE 3 2014-03-13 "Linux" "Linux Programmer's Manual" +.TH ISFDTYPE 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME isfdtype \- test file type of a file descriptor .SH SYNOPSIS @@ -102,7 +101,7 @@ instead. .SH SEE ALSO .BR fstat (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/isgreater.3 b/man3/isgreater.3 index 26c613908..f1f7cb890 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalnum.3 b/man3/iswalnum.3 index e7d84ed42..e6ddb1724 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswalpha.3 b/man3/iswalpha.3 index ab023848f..9e553c107 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswblank.3 b/man3/iswblank.3 index f9ecd3226..d7152a9e9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswcntrl.3 b/man3/iswcntrl.3 index 3590e08e7..471e1e25a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswctype.3 b/man3/iswctype.3 index 0037a9b33..db5bf4f71 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswdigit.3 b/man3/iswdigit.3 index a33a5f5cd..dac80a023 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswgraph.3 b/man3/iswgraph.3 index b6b87ed65..b43da996b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswlower.3 b/man3/iswlower.3 index 9174e8e2c..7ce7c9f0d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswprint.3 b/man3/iswprint.3 index cb9b35bf5..89540e998 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswpunct.3 b/man3/iswpunct.3 index 21c85e322..eaada332a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswspace.3 b/man3/iswspace.3 index c4569ebbf..e7b9d7b52 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswupper.3 b/man3/iswupper.3 index e3330b662..475cbc82a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/iswxdigit.3 b/man3/iswxdigit.3 index d3c537fca..032fff9ac 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, @@ -191,7 +191,7 @@ between \-8 and 8. .SH SEE ALSO .BR y0 (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 b93c36663..38698e157 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/killpg.3 b/man3/killpg.3 index fb439c212..ca9de81c5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ldexp.3 b/man3/ldexp.3 index 9f1e233ab..05b0fe987 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lgamma.3 b/man3/lgamma.3 index e5412c38a..615be4aee 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.07 of the Linux +This page is part of release 5.08 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 43a9d6224..c33164a94 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/localeconv.3 b/man3/localeconv.3 index 73a0dd3ca..c5c604e57 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lockf.3 b/man3/lockf.3 index eae52bc37..70fe56e54 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log.3 b/man3/log.3 index e43ae0099..fd5bf2b50 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log10.3 b/man3/log10.3 index 918b49d87..e5f83d9a5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log1p.3 b/man3/log1p.3 index 541456922..c61c46ba9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/log2.3 b/man3/log2.3 index c74a56e42..07fd8f8c3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/logb.3 b/man3/logb.3 index 645335b87..fa8cb11e3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/login.3 b/man3/login.3 index 6c6281ca6..a6c145b86 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lrint.3 b/man3/lrint.3 index 1b2add14c..46ec072b5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lround.3 b/man3/lround.3 index 7a8c21abe..7f2d99f10 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lsearch.3 b/man3/lsearch.3 index 19e51d273..9fcbe6b43 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/lseek64.3 b/man3/lseek64.3 index 3203098e4..09ac0cb32 100644 --- a/man3/lseek64.3 +++ b/man3/lseek64.3 @@ -177,7 +177,7 @@ T} Thread safety MT-Safe .BR llseek (2), .BR lseek (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makecontext.3 b/man3/makecontext.3 index f53d3b095..28986364b 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -1,4 +1,4 @@ -\" Copyright (C) 2001 Andries Brouwer (aeb@cwi.nl) +.\" Copyright (C) 2001 Andries Brouwer (aeb@cwi.nl) .\" and Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -150,7 +150,6 @@ Nevertheless, starting with version 2.8, glibc makes some changes to .BR makecontext (), to permit this on some 64-bit architectures (e.g., x86-64). .SH EXAMPLES -.PP The example program below demonstrates the use of .BR getcontext (3), .BR makecontext (), @@ -239,7 +238,7 @@ main(int argc, char *argv[]) .BR getcontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/makedev.3 b/man3/makedev.3 index a9c91bb3a..1a506f5f0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index 08e509ac6..ac3521c79 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2012 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -317,7 +316,7 @@ main(int argc, char *argv[]) .BR malloc_trim (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/malloc.3 b/man3/malloc.3 index 287fbdeaa..44b069ae7 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -58,7 +58,6 @@ Feature Test Macro Requirements for glibc (see _GNU_SOURCE .ad .SH DESCRIPTION -.PP The .BR malloc () function allocates @@ -402,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.07 of the Linux +This page is part of release 5.08 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 e69af48f4..e71d190c3 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.07 of the Linux +This page is part of release 5.08 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 c5341017d..161480dfd 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.07 of the Linux +This page is part of release 5.08 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 43b709beb..281ed7c27 100644 --- a/man3/malloc_info.3 +++ b/man3/malloc_info.3 @@ -272,7 +272,7 @@ main(int argc, char *argv[]) .BR mallopt (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 bd88f1d94..2a6dfcc1e 100644 --- a/man3/malloc_stats.3 +++ b/man3/malloc_stats.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2012 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MALLOC_STATS 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MALLOC_STATS 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME malloc_stats \- print memory allocation statistics .SH SYNOPSIS @@ -78,7 +77,7 @@ can be obtained using .BR malloc_info (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 045105593..c76164f25 100644 --- a/man3/malloc_trim.3 +++ b/man3/malloc_trim.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2012 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MALLOC_TRIM 3 2019-05-09 "Linux" "Linux Programmer's Manual" +.TH MALLOC_TRIM 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME malloc_trim \- release free memory from the heap .SH SYNOPSIS @@ -103,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.07 of the Linux +This page is part of release 5.08 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 61612da28..82e606e43 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mallopt.3 b/man3/mallopt.3 index a2959bb77..eec46e8f3 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2012 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -626,7 +625,7 @@ main(int argc, char *argv[]) .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/matherr.3 b/man3/matherr.3 index dbe23be47..bd21910f9 100644 --- a/man3/matherr.3 +++ b/man3/matherr.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk .\" <mtk.manpages@gmail.com> .\" @@ -441,7 +440,7 @@ main(int argc, char *argv[]) .BR math_error (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mblen.3 b/man3/mblen.3 index 3cae2fe88..9b8f8979b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index 43e8e4483..fd1b38c44 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbrtowc.3 b/man3/mbrtowc.3 index 1ceb7e468..7d257cc0a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index f71ab9c4d..eb9ad42f2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index 6d70cde60..9820aaf19 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index 39ed91899..b8cb37f3c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index ecec640b9..f78f2962d 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright (c) Bruno Haible <haible@clisp.cons.org> .\" and Copyright 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" @@ -235,7 +234,7 @@ main(int argc, char *argv[]) .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index fff276b87..ff742d492 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mcheck.3 b/man3/mcheck.3 index 79dcd81c8..777b956ea 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memccpy.3 b/man3/memccpy.3 index 9a3b343c1..0dc6a7079 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memchr.3 b/man3/memchr.3 index 5cebed56b..bde9b2842 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcmp.3 b/man3/memcmp.3 index 237fe15f6..bbbc1ed3d 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -76,7 +76,6 @@ T} Thread safety MT-Safe .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. .SH NOTES -.PP Do not use .BR memcmp () to compare security critical data, such as cryptographic secrets, @@ -96,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memcpy.3 b/man3/memcpy.3 index 482b9bdb6..262bf7419 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 7d9a85424..98f26cb05 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmem.3 b/man3/memmem.3 index 697bfaf82..6261d203c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memmove.3 b/man3/memmove.3 index fd19f9a22..6e2223163 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 06b1fcebc..09cbcaa26 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/memset.3 b/man3/memset.3 index 1795f5afc..adb8a60c3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index 06b079bf5..38b0dab94 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index a6113cc9b..59a33396c 100644 --- a/man3/mkfifo.3 +++ b/man3/mkfifo.3 @@ -25,7 +25,7 @@ .\" .\" changed section from 2 to 3, aeb, 950919 .\" -.TH MKFIFO 3 2017-09-15 "GNU" "Linux Programmer's Manual" +.TH MKFIFO 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME mkfifo, mkfifoat \- make a FIFO special file (a named pipe) .SH SYNOPSIS @@ -65,7 +65,7 @@ makes a FIFO special file with name \fIpathname\fP. \fImode\fP specifies the FIFO's permissions. It is modified by the process's \fBumask\fP in the usual way: the permissions of the created -file are \fB(\fP\fImode\fP\fB & ~umask)\fP. +file are \fB(\fP\fImode\fP\fB & \(tiumask)\fP. .PP A FIFO special file is similar to a pipe, except that it is created in a different way. @@ -210,7 +210,7 @@ POSIX.1-2008. .BR write (2), .BR fifo (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index a9cc5fbcd..409f9ecdd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mktemp.3 b/man3/mktemp.3 index 0dbb8a146..e386037c7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/modf.3 b/man3/modf.3 index 018f8e646..f21bc4caf 100644 --- a/man3/modf.3 +++ b/man3/modf.3 @@ -109,7 +109,7 @@ SVr4, 4.3BSD, C89. .BR frexp (3), .BR ldexp (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mpool.3 b/man3/mpool.3 index c6c72f45a..7bc9a6623 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.07 of the Linux +This page is part of release 5.08 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 56b32eab2..c6aa4ace1 100644 --- a/man3/mq_close.3 +++ b/man3/mq_close.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_CLOSE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MQ_CLOSE 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mq_close \- close a message queue descriptor .SH SYNOPSIS @@ -84,7 +83,7 @@ or upon .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 0da535045..9a4555366 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -185,7 +184,7 @@ can be used to control the defaults: .PP .in +4n .EX -$ \fBuname -sr\fP +$ \fBuname \-sr\fP Linux 3.8.0 $ \fBcat /proc/sys/fs/mqueue/msg_default\fP 10 @@ -242,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.07 of the Linux +This page is part of release 5.08 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 1e41fb316..b1a702278 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -285,7 +284,7 @@ main(int argc, char *argv[]) .BR mq_overview (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 808e3b182..d49281f26 100644 --- a/man3/mq_open.3 +++ b/man3/mq_open.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_OPEN 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MQ_OPEN 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mq_open \- open a message queue .SH SYNOPSIS @@ -126,7 +125,6 @@ specify the maximum number of messages and the maximum size of messages that the queue will allow. This structure is defined as follows: .PP -.PP .in +4n .EX struct mq_attr { @@ -313,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.07 of the Linux +This page is part of release 5.08 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 5827e8a5e..c8d18b4c6 100644 --- a/man3/mq_receive.3 +++ b/man3/mq_receive.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_RECEIVE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MQ_RECEIVE 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mq_receive, mq_timedreceive \- receive a message from a message queue .SH SYNOPSIS @@ -183,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.07 of the Linux +This page is part of release 5.08 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 dc928f639..b5e326d2b 100644 --- a/man3/mq_send.3 +++ b/man3/mq_send.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_SEND 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH MQ_SEND 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mq_send, mq_timedsend \- send a message to a message queue .SH SYNOPSIS @@ -191,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.07 of the Linux +This page is part of release 5.08 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 34e0dedbc..85b16efca 100644 --- a/man3/mq_unlink.3 +++ b/man3/mq_unlink.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH MQ_UNLINK 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH MQ_UNLINK 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mq_unlink \- remove a message queue .SH SYNOPSIS @@ -82,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/mtrace.3 b/man3/mtrace.3 index eb0d7274e..6cec03f6e 100644 --- a/man3/mtrace.3 +++ b/man3/mtrace.3 @@ -192,7 +192,7 @@ The final message corresponds to the call to .BR malloc_hook (3), .BR mcheck (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nan.3 b/man3/nan.3 index 3f5887f62..fcf15fe13 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/netlink.3 b/man3/netlink.3 index 24ee637da..b43f9f505 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/newlocale.3 b/man3/newlocale.3 index 0d0789b5b..1a63eb0d2 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -30,7 +29,7 @@ newlocale, freelocale \- create, modify, and free a locale object .nf .B #include <locale.h> .PP -.BI "locale_t newlocale(int " category_mask ", const char *" locale ", +.BI "locale_t newlocale(int " category_mask ", const char *" locale , .BI " locale_t " base ); .PP .BI "void freelocale(locale_t " locobj ); @@ -380,7 +379,7 @@ main(int argc, char *argv[]) .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextafter.3 b/man3/nextafter.3 index c07262dae..23e2daa05 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -200,7 +200,7 @@ these functions did not set .SH SEE ALSO .BR nearbyint (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/nextup.3 b/man3/nextup.3 index 515671fa4..b4d513a3c 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.07 of the Linux +This page is part of release 5.08 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 0536d3467..a9fa38ad3 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.07 of the Linux +This page is part of release 5.08 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 8f7f37339..8a8b454fa 100644 --- a/man3/ntp_gettime.3 +++ b/man3/ntp_gettime.3 @@ -66,7 +66,6 @@ struct timeval { }; .EE .in -.IP .TP .I maxerror Maximum error, in microseconds. @@ -148,7 +147,7 @@ is a GNU extension. NTP "Kernel Application Program Interface" .UE .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/offsetof.3 b/man3/offsetof.3 index 6f6469bd6..a6bd38d1a 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.07 of the Linux +This page is part of release 5.08 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 440956fbd..b832c6eef 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.07 of the Linux +This page is part of release 5.08 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 e8f525d23..9dc6694d0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/opendir.3 b/man3/opendir.3 index 96713d8c3..b4ef54cea 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/openpty.3 b/man3/openpty.3 index 0c62126ff..f48ef8979 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -77,6 +77,7 @@ is not NULL, the window size of the slave will be set to the values in The .BR login_tty () function prepares for a login on the terminal +referred to by the file descriptor .I fd (which may be a real terminal device, or the slave of a pseudoterminal as returned by @@ -97,8 +98,8 @@ function combines and .BR login_tty () to create a new process operating in a pseudoterminal. -The file -descriptor of the master side of the pseudoterminal is returned in +A file descriptor referring to +master side of the pseudoterminal is returned in .IR amaster . If .I name @@ -198,7 +199,7 @@ may not be secure. .BR ttyname (3), .BR pty (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/perror.3 b/man3/perror.3 index 14fa870b6..042d701e7 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -155,7 +155,7 @@ are defined by glibc, but in .BR error (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/popen.3 b/man3/popen.3 index 8fba12ee6..95ec08680 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.07 of the Linux +This page is part of release 5.08 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 0245b1a15..a6a77063c 100644 --- a/man3/posix_fallocate.3 +++ b/man3/posix_fallocate.3 @@ -184,7 +184,7 @@ fallback with all the same problems as the emulation provided by glibc. .BR lseek (2), .BR posix_fadvise (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 6639c7f7b..6db3c2394 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.07 of the Linux +This page is part of release 5.08 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 636748017..2242fbbdb 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-04-11 "GNU" "Linux Programmer's Manual" +.TH POSIX_MEMALIGN 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME posix_memalign, aligned_alloc, memalign, valloc, pvalloc \- allocate aligned memory .SH SYNOPSIS @@ -91,15 +91,16 @@ The address of the allocated memory will be a multiple of .IR "alignment" , which must be a power of two and a multiple of .IR "sizeof(void\ *)" . +This address can later be successfully passed to +.BR free (3). If .I size is 0, then the value placed in .IR "*memptr" -is either NULL, +is either NULL .\" glibc does this: -or a unique pointer value that can later be successfully passed to -.BR free (3). +or a unique pointer value. .PP The obsolete function .BR memalign () @@ -304,7 +305,7 @@ needed only if you require larger alignment values. .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 9f7821208..d035fb745 100644 --- a/man3/posix_openpt.3 +++ b/man3/posix_openpt.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH POSIX_OPENPT 3 2020-04-11 "" "Linux Programmer's Manual" +.TH POSIX_OPENPT 3 2020-08-13 "" "Linux Programmer's Manual" .SH NAME posix_openpt \- open a pseudoterminal device .SH SYNOPSIS @@ -95,7 +95,7 @@ is part of the UNIX 98 pseudoterminal support (see .SH NOTES Some older UNIX implementations that support System V (aka UNIX 98) pseudoterminals don't have this function, but it -is easy to implement: +can be easily implemented by opening the pseudoterminal multiplexor device: .PP .in +4n .EX @@ -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.07 of the Linux +This page is part of release 5.08 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 691ce223a..6c35b7779 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -430,7 +430,7 @@ If .I file_actions is NULL, then no special action is taken, and standard .BR exec (3) -semantics apply--file descriptors open before the exec +semantics apply\(emfile descriptors open before the exec remain open in the new process, except those for which the .B FD_CLOEXEC @@ -536,7 +536,6 @@ and .BR posix_spawnp () functions are available since glibc 2.2. .SH CONFORMING TO -.PP POSIX.1-2001, POSIX.1-2008. .\" FIXME . This piece belongs in spawnattr_setflags(3) .\" The @@ -633,7 +632,7 @@ fails when trying to perform output and exits with a status of 1. .PP .in +4 .EX -$ \fB./a.out -c date\fP +$ \fB./a.out \-c date\fP PID of child: 7636 date: write error: Bad file descriptor Child status: exited, status=1 @@ -657,14 +656,14 @@ can't be blocked). .PP .in +4 .EX -$ \fB./a.out -s sleep 60 &\fP +$ \fB./a.out \-s sleep 60 &\fP [1] 7637 $ PID of child: 7638 $ \fBkill 7638\fP -$ \fBkill -KILL 7638\fP +$ \fBkill \-KILL 7638\fP $ Child status: killed by signal 9 -[1]+ Done ./a.out -s sleep 60 +[1]+ Done ./a.out \-s sleep 60 .EE .in .PP @@ -844,7 +843,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow.3 b/man3/pow.3 index 62342fb02..42dfd7bb6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pow10.3 b/man3/pow10.3 index 28a4c86c7..29495287f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/printf.3 b/man3/printf.3 index ee049abf0..d6a279b23 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -251,7 +251,7 @@ Thus, .PP .in +4n .EX - printf("%\(aq.2f", 1234567.89); +printf("%\(aq.2f", 1234567.89); .EE .in .PP @@ -1179,7 +1179,7 @@ error instead of being handled gracefully. .BR wprintf (3), .BR locale (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/profil.3 b/man3/profil.3 index 5aea3971c..da8627a3e 100644 --- a/man3/profil.3 +++ b/man3/profil.3 @@ -106,7 +106,7 @@ Libc 4.4 contained a kernel patch providing a system call profil. .BR sigaction (2), .BR signal (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 bf53d886c..e820943f7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/psignal.3 b/man3/psignal.3 index b3ac0cbdb..eb863e5a6 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -136,7 +136,7 @@ Additional details are not displayed for real-time signals. .BR strsignal (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 21132b068..d8bb24e75 100644 --- a/man3/pthread_atfork.3 +++ b/man3/pthread_atfork.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2017 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_ATFORK 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTHREAD_ATFORK 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME pthread_atfork \- register fork handlers .SH SYNOPSIS @@ -65,7 +64,6 @@ Any of the three arguments may be NULL if no handler is needed in the corresponding phase of .BR fork (2) processing. -.PP .SH RETURN VALUE On success, .BR pthread_atfork () @@ -112,7 +110,7 @@ After a .BR fork (2) in a multithreaded process returns in the child, the child should call only async-signal-safe functions (see -.BR signal-safety (7)) +.BR signal\-safety (7)) until such time as it calls .BR execve (2) to execute a new program. @@ -126,7 +124,7 @@ shall not fail with the error .BR atexit (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/pthread_attr_init.3 b/man3/pthread_attr_init.3 index 6294a038c..5899f8815 100644 --- a/man3/pthread_attr_init.3 +++ b/man3/pthread_attr_init.3 @@ -327,7 +327,7 @@ main(int argc, char *argv[]) .BR pthread_setattr_default_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 41dcf4543..fb8568761 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.07 of the Linux +This page is part of release 5.08 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 9122e0541..5955add86 100644 --- a/man3/pthread_attr_setdetachstate.3 +++ b/man3/pthread_attr_setdetachstate.3 @@ -128,7 +128,7 @@ See .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 eb3bf3648..40bc22299 100644 --- a/man3/pthread_attr_setguardsize.3 +++ b/man3/pthread_attr_setguardsize.3 @@ -177,7 +177,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 382cce86a..99c32156c 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.07 of the Linux +This page is part of release 5.08 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 61bb91876..912032360 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.07 of the Linux +This page is part of release 5.08 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 4c70feb8a..a3e8042cf 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.07 of the Linux +This page is part of release 5.08 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 7be765c83..bbc5759ec 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.07 of the Linux +This page is part of release 5.08 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 10f266f62..7d15ddf53 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.07 of the Linux +This page is part of release 5.08 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 e3f70864d..da9bdea31 100644 --- a/man3/pthread_attr_setstackaddr.3 +++ b/man3/pthread_attr_setstackaddr.3 @@ -127,7 +127,7 @@ argument specifies the range of the stack). .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 4420b6386..3acbb1b40 100644 --- a/man3/pthread_attr_setstacksize.3 +++ b/man3/pthread_attr_setstacksize.3 @@ -129,7 +129,7 @@ See .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 b0e486119..644ea9c56 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.07 of the Linux +This page is part of release 5.08 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 a9db0d1a0..c09a9b024 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.07 of the Linux +This page is part of release 5.08 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 4641d3af4..625f56067 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.07 of the Linux +This page is part of release 5.08 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 9ed18213f..0b2933cfe 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -418,7 +418,7 @@ main(int argc, char *argv[]) .BR pthread_setattr_default_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 b4b1253a2..b2f182f5b 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.07 of the Linux +This page is part of release 5.08 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 dbde56e2e..154c7b7ff 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.07 of the Linux +This page is part of release 5.08 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 aa303faaa..629ff8adb 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.07 of the Linux +This page is part of release 5.08 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 f4728849f..999f26827 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -114,7 +114,6 @@ Detach state: JOINABLE Inherit scheduler: INHERIT .EE .in -.PP .SS Program source \& .EX @@ -211,7 +210,7 @@ main(int argc, char *argv[]) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 0a2be34f3..1ebeb27a4 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.07 of the Linux +This page is part of release 5.08 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 e58a0e06e..93ec57fb0 100644 --- a/man3/pthread_getcpuclockid.3 +++ b/man3/pthread_getcpuclockid.3 @@ -191,7 +191,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 4133833c9..667e905e1 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.07 of the Linux +This page is part of release 5.08 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 fdf04bf91..dc8e5d3f6 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.07 of the Linux +This page is part of release 5.08 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 4b143ad26..4d507667a 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.07 of the Linux +This page is part of release 5.08 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 73bc8731a..10d374d68 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.07 of the Linux +This page is part of release 5.08 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 3dbca5754..8d99f985c 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.07 of the Linux +This page is part of release 5.08 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 27527d906..16910e265 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.07 of the Linux +This page is part of release 5.08 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 456f50287..af656c901 100644 --- a/man3/pthread_mutexattr_setrobust.3 +++ b/man3/pthread_mutexattr_setrobust.3 @@ -186,7 +186,6 @@ were also defined. These GNU-specific APIs, which first appeared in glibc 2.4, are nowadays obsolete and should not be used in new programs. .SH EXAMPLES -.PP The program below demonstrates the use of the robustness attribute of a mutex attributes object. In this program, a thread holding the mutex @@ -284,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.07 of the Linux +This page is part of release 5.08 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 15f82c911..ce5d6403d 100644 --- a/man3/pthread_rwlockattr_setkind_np.3 +++ b/man3/pthread_rwlockattr_setkind_np.3 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREAD_RWLOCKATTR_SETKIND_NP 3 2019-03-06 "Linux Programmer's Manual" +.TH PTHREAD_RWLOCKATTR_SETKIND_NP 3 2020-08-13 "Linux Programmer's Manual" .SH NAME pthread_rwlockattr_setkind_np, pthread_rwlockattr_getkind_np \- set/get the read-write lock kind of the thread read-write lock attribute object @@ -80,7 +80,7 @@ starved. This is intended as the write lock analog of .BR PTHREAD_RWLOCK_PREFER_READER_NP . This is ignored by glibc because the POSIX requirement to support -recursive writer locks would cause this option to create trivial +recursive read locks would cause this option to create trivial deadlocks; instead use .B PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP which ensures the application developer will not take recursive @@ -102,7 +102,8 @@ read locks thus avoiding deadlocks. .\" the writers to acquire and release the lock, and the writers will be .\" suspended waiting for every existing read lock to be released. .\" --- -.\" http://sources.redhat.com/ml/libc-alpha/2000-01/msg00055.html +.\" https://pubs.opengroup.org/onlinepubs/9699919799/functions/pthread_rwlock_rdlock.html +.\" https://sourceware.org/legacy-ml/libc-alpha/2000-01/msg00055.html .\" https://sourceware.org/bugzilla/show_bug.cgi?id=7057 .TP .B PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP @@ -142,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.07 of the Linux +This page is part of release 5.08 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 71cd9f395..b8495984f 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.07 of the Linux +This page is part of release 5.08 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 006b2535c..bb1e44608 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.07 of the Linux +This page is part of release 5.08 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 700d85af5..a08ce6b96 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.07 of the Linux +This page is part of release 5.08 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 455185410..14af6fc2f 100644 --- a/man3/pthread_setconcurrency.3 +++ b/man3/pthread_setconcurrency.3 @@ -31,7 +31,7 @@ the concurrency level .B #include <pthread.h> .PP .BI "int pthread_setconcurrency(int " new_level ); -.BI "int pthread_getconcurrency(void); +.BI "int pthread_getconcurrency(" void ); .PP Compile and link with \fI\-pthread\fP. .fi @@ -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.07 of the Linux +This page is part of release 5.08 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 9c5f53c17..ec295790b 100644 --- a/man3/pthread_setname_np.3 +++ b/man3/pthread_setname_np.3 @@ -30,7 +30,7 @@ pthread_setname_np, pthread_getname_np \- set/get the name of a thread .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <pthread.h> -.BI "int pthread_setname_np(pthread_t " thread ", const char *" name "); +.BI "int pthread_setname_np(pthread_t " thread ", const char *" name ); .BI "int pthread_getname_np(pthread_t " thread , .BI " char *" name ", size_t " len ); .fi @@ -127,7 +127,6 @@ filesystem: .BR pthread_getname_np () retrieves it from the same location. .SH EXAMPLES -.PP The program below demonstrates the use of .BR pthread_setname_np () and @@ -140,9 +139,9 @@ The following shell session shows a sample run of the program: .RB "$" " ./a.out" Created a thread. Default name is: a.out The thread name after setting it is THREADFOO. -\fB^Z\fP # Suspend the program +\fB\(haZ\fP # Suspend the program [1]+ Stopped ./a.out -.RB "$ " "ps H -C a.out -o 'pid tid cmd comm'" +.RB "$ " "ps H \-C a.out \-o 'pid tid cmd comm'" PID TID CMD COMMAND 5990 5990 ./a.out a.out 5990 5991 ./a.out THREADFOO @@ -219,7 +218,7 @@ main(int argc, char **argv) .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 53b2329c5..5493eed7f 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.07 of the Linux +This page is part of release 5.08 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 10c68a73a..ae9220b28 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.07 of the Linux +This page is part of release 5.08 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 817d7d999..9e5a2a918 100644 --- a/man3/pthread_sigmask.3 +++ b/man3/pthread_sigmask.3 @@ -174,7 +174,7 @@ main(int argc, char *argv[]) .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 d8c7e35d8..f3d722c0f 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.07 of the Linux +This page is part of release 5.08 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 35f1dc38b..4e71ebbed 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.07 of the Linux +This page is part of release 5.08 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 5453d741f..888af0d21 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.07 of the Linux +This page is part of release 5.08 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 1f75211ac..184a0ecdb 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.07 of the Linux +This page is part of release 5.08 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 943a53596..235201509 100644 --- a/man3/pthread_tryjoin_np.3 +++ b/man3/pthread_tryjoin_np.3 @@ -163,7 +163,7 @@ if (s != 0) { .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 ee524152a..5e7d42b9f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ptsname.3 b/man3/ptsname.3 index 68cb419bb..e5b91a555 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -38,7 +38,7 @@ Glibc 2.23 and earlier: The .BR ptsname () function returns the name of the slave pseudoterminal device -corresponding to the master referred to by +corresponding to the master referred to by the file descriptor .IR fd . .PP The @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putenv.3 b/man3/putenv.3 index 74fb9e77f..f7c280d3c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putgrent.3 b/man3/putgrent.3 index aed557839..599c41921 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putpwent.3 b/man3/putpwent.3 index a9b41dd50..83ed6ffbd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/puts.3 b/man3/puts.3 index 0d753168f..abbc57817 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -138,7 +138,7 @@ will be undefined and very probably not what you want. .BR scanf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/putwchar.3 b/man3/putwchar.3 index 51c5dad09..b3b362f2f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qecvt.3 b/man3/qecvt.3 index 13a2b1702..83ea7fcff 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/qsort.3 b/man3/qsort.3 index 645814e04..439ec7c78 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -163,7 +163,7 @@ main(int argc, char *argv[]) .BR strcmp (3), .BR versionsort (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/queue.3 b/man3/queue.3 index 6acc7c614..85ef54d76 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -110,8 +110,8 @@ .Nm TAILQ_LAST , .Nm TAILQ_NEXT , .Nm TAILQ_PREV , -.Nm TAILQ_REMOVE , -.Nm TAILQ_SWAP +.Nm TAILQ_REMOVE +.\" .Nm TAILQ_SWAP .Nd implementations of singly-linked lists, singly-linked tail queues, lists and tail queues .Sh SYNOPSIS @@ -172,7 +172,7 @@ lists and tail queues .Fn LIST_NEXT "TYPE *elm" "LIST_ENTRY NAME" .\" .Fn LIST_PREV "TYPE *elm" "LIST_HEAD *head" "TYPE" "LIST_ENTRY NAME" .Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME" +.\" .Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME" .\" .Fn TAILQ_CONCAT "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TAILQ_ENTRY NAME" .Fn TAILQ_EMPTY "TAILQ_HEAD *head" @@ -197,7 +197,7 @@ lists and tail queues .Fn TAILQ_NEXT "TYPE *elm" "TAILQ_ENTRY NAME" .Fn TAILQ_PREV "TYPE *elm" "HEADNAME" "TAILQ_ENTRY NAME" .Fn TAILQ_REMOVE "TAILQ_HEAD *head" "TYPE *elm" "TAILQ_ENTRY NAME" -.Fn TAILQ_SWAP "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TYPE" "TAILQ_ENTRY NAME" +.\" .Fn TAILQ_SWAP "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TYPE" "TAILQ_ENTRY NAME" .\" .Sh DESCRIPTION These macros define and operate on four types of data structures: @@ -213,8 +213,8 @@ Insertion of a new entry after any element in the list. O(1) removal of an entry from the head of the list. .It Forward traversal through the list. -.It -Swapping the contents of two lists. +.\" .It +.\" Swapping the contents of two lists. .El .Pp Singly-linked lists are the simplest of the four data structures @@ -1157,13 +1157,13 @@ The macro removes the element .Fa elm from the tail queue. -.Pp -The macro -.Nm TAILQ_SWAP -swaps the contents of -.Fa head1 -and -.Fa head2 . +.\" .Pp +.\" The macro +.\" .Nm TAILQ_SWAP +.\" swaps the contents of +.\" .Fa head1 +.\" and +.\" .Fa head2 . .Ss Tail queue example .Bd -literal TAILQ_HEAD(tailhead, entry) head = @@ -1219,18 +1219,6 @@ while (n1 != NULL) { } TAILQ_INIT(&head); -n2 = malloc(sizeof(struct entry)); /* Insert before. */ -CIRCLEQ_INSERT_BEFORE(&head, n1, n2, entries); - /* Forward traversal. */ -for (np = head.cqh_first; np != (void *)&head; - np = np\->entries.cqe_next) - np\-> ... - /* Reverse traversal. */ -for (np = head.cqh_last; np != (void *)&head; np = np\->entries.cqe_prev) - np\-> ... - /* Delete. */ -while (head.cqh_first != (void *)&head) - CIRCLEQ_REMOVE(&head, head.cqh_first, entries); .Ed .Sh CONFORMING TO Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. @@ -1242,7 +1230,7 @@ functions first appeared in .Xr insque 3 .\" .Xr tree 3 .Sh COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .Em man-pages project. A description of the project, diff --git a/man3/raise.3 b/man3/raise.3 index 8cc4b8ec6..4f5ff8769 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rand.3 b/man3/rand.3 index 7ee66977b..ce5ef8683 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/random.3 b/man3/random.3 index d8188226f..ca1e9164d 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.07 of the Linux +This page is part of release 5.08 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 91769a526..438086155 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rcmd.3 b/man3/rcmd.3 index 6984369c8..c458cd9a7 100644 --- a/man3/rcmd.3 +++ b/man3/rcmd.3 @@ -49,28 +49,28 @@ stream to a remote command .nf .B #include <netdb.h> \ \ \fP/* Or <unistd.h> on some systems */ .PP -.BI "int rcmd(char **" ahost ", unsigned short " inport ", const char *" locuser ", " +.BI "int rcmd(char **" ahost ", unsigned short " inport ", const char *" locuser , .BI " const char *" remuser ", const char *" cmd ", int *" fd2p ); .PP .BI "int rresvport(int *" port ); .PP -.BI "int iruserok(uint32_t " raddr ", int " superuser ", " +.BI "int iruserok(uint32_t " raddr ", int " superuser , .BI " const char *" ruser ", const char *" luser ); .PP -.BI "int ruserok(const char *" rhost ", int " superuser ", " +.BI "int ruserok(const char *" rhost ", int " superuser , .BI " const char *" ruser ", const char *" luser ); .PP -.BI "int rcmd_af(char **" ahost ", unsigned short " inport ", const char *" locuser ", " +.BI "int rcmd_af(char **" ahost ", unsigned short " inport ", const char *" locuser , .BI " const char *" remuser ", const char *" cmd ", int *" fd2p , .BI " sa_family_t " af ); .PP .BI "int rresvport_af(int *" port ", sa_family_t " af ); .PP -.BI "int iruserok_af(const void *" raddr ", int " superuser ", " +.BI "int iruserok_af(const void *" raddr ", int " superuser , .BI " const char *" ruser ", const char *" luser \ ", sa_family_t " af ); .PP -.BI "int ruserok_af(const char *" rhost ", int " superuser ", " +.BI "int ruserok_af(const char *" rhost ", int " superuser , .BI " const char *" ruser ", const char *" luser \ ", sa_family_t " af ); .fi @@ -114,7 +114,6 @@ All four functions are used by the .BR rshd (8) server (among others). .SS rcmd() -.PP The .BR rcmd () function @@ -162,7 +161,6 @@ although you may be able to get its attention by using out-of-band data. The protocol is described in detail in .BR rshd (8). .SS rresvport() -.PP The .BR rresvport () function is used to obtain a socket with a privileged @@ -186,7 +184,6 @@ for a circular search of the port range; on (successful) return, it contains the port number that was bound to. .\" .SS iruserok() and ruserok() -.PP The .BR iruserok () and @@ -321,7 +318,7 @@ are declared in glibc headers only since version 2.12. .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 d515cf385..0610b7a69 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/readdir.3 b/man3/readdir.3 index a5aa461de..1e1e6631f 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.07 of the Linux +This page is part of release 5.08 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 f888eb05c..35b204313 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/realpath.3 b/man3/realpath.3 index ce6a624c5..69851df8a 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -182,7 +182,7 @@ A typical source fragment would be .in .PP (But see the BUGS section.) -.PP +.\".PP .\" 2012-05-05, According to Casper Dik, the statement about .\" Solaris was not true at least as far back as 1997, and .\" may never have been true. @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/recno.3 b/man3/recno.3 index ca2fb95fa..4963d4a50 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/regex.3 b/man3/regex.3 index b5276f589..255615ad2 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -27,7 +27,7 @@ .\" Modified 8 May 1998 by Joseph S. Myers (jsm28@cam.ac.uk) .\" .\" show the synopsis section nicely -.TH REGEX 3 2019-10-10 "GNU" "Linux Programmer's Manual" +.TH REGEX 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME regcomp, regexec, regerror, regfree \- POSIX regex functions .SH SYNOPSIS @@ -104,11 +104,11 @@ are ignored if the pattern buffer supplied was compiled with this flag set. Match-any-character operators don't match a newline. .IP A nonmatching list -.RB ( [^...] ) +.RB ( [\(ha...] ) not containing a newline does not match a newline. .IP Match-beginning-of-line operator -.RB ( ^ ) +.RB ( \(ha ) matches the empty string immediately after a newline, regardless of whether .IR eflags , @@ -349,7 +349,7 @@ POSIX.1-2001, POSIX.1-2008. The glibc manual section, .I "Regular Expressions" .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remainder.3 b/man3/remainder.3 index c9edeaed1..4a1dfd59b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remove.3 b/man3/remove.3 index 6099bfe7f..d1ae05a57 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/remquo.3 b/man3/remquo.3 index 54dbf57f5..9a8a8a667 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/resolver.3 b/man3/resolver.3 index 244550cc1..f0bf8a5db 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -192,7 +192,7 @@ functions make a query using on the concatenation of \fIname\fP and \fIdomain\fP. .PP The following functions are lower-level routines used by -.BR res_query ()/ res_query (). +.BR res_nquery ()/ res_query (). .PP The .BR res_nmkquery () @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index 232032481..4cb061e96 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rexec.3 b/man3/rexec.3 index f4cba9d3e..2c2248221 100644 --- a/man3/rexec.3 +++ b/man3/rexec.3 @@ -45,10 +45,10 @@ rexec, rexec_af \- return stream to a remote command .nf .B #include <netdb.h> .PP -.BI "int rexec(char **" ahost ", int " inport ", const char *" user ", " +.BI "int rexec(char **" ahost ", int " inport ", const char *" user , .BI " const char *" passwd ", const char *" cmd ", int *" fd2p ); .PP -.BI "int rexec_af(char **" ahost ", int " inport ", const char *" user ", " +.BI "int rexec_af(char **" ahost ", int " inport ", const char *" user , .BI " const char *" passwd ", const char *" cmd ", int *" fd2p , .BI " sa_family_t " af ); .fi @@ -182,7 +182,7 @@ for explanations. .BR rcmd (3), .BR rexecd (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rint.3 b/man3/rint.3 index 9b8954f4b..2c08ed3a5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/round.3 b/man3/round.3 index 8e7b11902..9700c082f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpc.3 b/man3/rpc.3 index eba726369..3ecacaabe 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index 7c1508b29..e0d9be2c4 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -69,9 +69,9 @@ if the program has called to effect their changes. .PP Regardless of the locale, responses matching -.B ^[Yy] +.B \(ha[Yy] are always accepted as affirmative, and those matching -.B ^[Nn] +.B \(ha[Nn] are always accepted as negative. .SH RETURN VALUE After examining @@ -129,9 +129,9 @@ It would be preferable to accept input strings much more strictly, for example (using the extended regular expression notation described in .BR regex (7)): -.B ^([yY]|yes|YES)$ +.B \(ha([yY]|yes|YES)$ and -.BR ^([nN]|no|NO)$ . +.BR \(ha([nN]|no|NO)$ . .SH EXAMPLES The following program displays the results when .BR rpmatch () @@ -164,7 +164,7 @@ main(int argc, char *argv[]) .BR regcomp (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtime.3 b/man3/rtime.3 index e9b0b26cb..277e53043 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -143,7 +143,7 @@ main(void) .\" .BR rdate (1), .BR inetd (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index b9542c43a..c8c15a2d1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalb.3 b/man3/scalb.3 index 8df3ecf00..e18302f07 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scalbln.3 b/man3/scalbln.3 index 1953fd26f..d03ed12c4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scandir.3 b/man3/scandir.3 index 6ada5156b..780ddf88b 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -332,7 +332,7 @@ main(void) .BR strverscmp (3), .BR telldir (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/scanf.3 b/man3/scanf.3 index b81eda7b7..4094ed163 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -49,7 +49,7 @@ .\" Add ERRORS section. .\" Document the 'a' and 'm' modifiers for dynamic string allocation. .\" -.TH SCANF 3 2020-04-11 "GNU" "Linux Programmer's Manual" +.TH SCANF 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion .SH SYNOPSIS @@ -496,7 +496,7 @@ The set .I excludes those characters if the first character after the open bracket is a circumflex -.RB ( ^ ). +.RB ( \(ha ). To include a close bracket in the set, make it the first character after the open bracket or the circumflex; any other position will end the set. The hyphen character @@ -506,7 +506,7 @@ intervening characters to the set. To include a hyphen, make it the last character before the final close bracket. For instance, -.B [^]0\-9\-] +.B [\(ha]0\-9\-] means the set "everything except close bracket, zero through nine, and hyphen". The string ends with the appearance of a character not in the (or, with a @@ -773,7 +773,7 @@ call successfully read a string. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 70a8ee307..0bcd0b5b0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 1c0a7bc6a..615dd7e8a 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.07 of the Linux +This page is part of release 5.08 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 40bf296d4..7ad049f39 100644 --- a/man3/sem_close.3 +++ b/man3/sem_close.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_CLOSE 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SEM_CLOSE 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sem_close \- close a named semaphore .SH SYNOPSIS @@ -78,7 +77,7 @@ termination, or upon .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 238e24732..8c61aafde 100644 --- a/man3/sem_destroy.3 +++ b/man3/sem_destroy.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_DESTROY 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SEM_DESTROY 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sem_destroy \- destroy an unnamed semaphore .SH SYNOPSIS @@ -89,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.07 of the Linux +This page is part of release 5.08 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 ef449386c..6cdec7e25 100644 --- a/man3/sem_getvalue.3 +++ b/man3/sem_getvalue.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -88,7 +87,7 @@ returns. .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 8d78f30ce..7f5893db5 100644 --- a/man3/sem_init.3 +++ b/man3/sem_init.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_INIT 3 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SEM_INIT 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sem_init \- initialize an unnamed semaphore .SH SYNOPSIS @@ -122,7 +121,7 @@ and .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 4de677e40..7cfcffcb6 100644 --- a/man3/sem_open.3 +++ b/man3/sem_open.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_OPEN 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SEM_OPEN 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sem_open \- initialize and open a named semaphore .SH SYNOPSIS @@ -33,7 +32,7 @@ sem_open \- initialize and open a named semaphore .B #include <semaphore.h> .PP .BI "sem_t *sem_open(const char *" name ", int " oflag ); -.BI "sem_t *sem_open(const char *" name ", int " oflag ", " +.BI "sem_t *sem_open(const char *" name ", int " oflag , .BI " mode_t " mode ", unsigned int " value ); .fi .PP @@ -190,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.07 of the Linux +This page is part of release 5.08 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 86cad591f..3e57b1fca 100644 --- a/man3/sem_post.3 +++ b/man3/sem_post.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_POST 3 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SEM_POST 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sem_post \- unlock a semaphore .SH SYNOPSIS @@ -85,9 +84,9 @@ and .BR sem_getvalue (3), .BR sem_wait (3), .BR sem_overview (7), -.BR signal-safety (7) +.BR signal\-safety (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 323b0170c..9cd4a0cc9 100644 --- a/man3/sem_unlink.3 +++ b/man3/sem_unlink.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SEM_UNLINK 3 2015-08-08 "Linux" "Linux Programmer's Manual" +.TH SEM_UNLINK 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sem_unlink \- remove a named semaphore .SH SYNOPSIS @@ -80,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.07 of the Linux +This page is part of release 5.08 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 5294520a7..df742333f 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -157,7 +156,6 @@ T} Thread safety MT-Safe .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH EXAMPLES -.PP The (somewhat trivial) program shown below operates on an unnamed semaphore. The program expects two command-line arguments. @@ -272,7 +270,7 @@ main(int argc, char *argv[]) .BR sem_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index 98a513541..3cfc5a02b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setbuf.3 b/man3/setbuf.3 index 50340d11d..021d0f990 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -194,7 +194,7 @@ functions conform to C89 and C99. .\" On 4.2BSD and 4.3BSD systems, .\" .BR setbuf () .\" always uses a suboptimal buffer size and should be avoided. -.PP +.\".PP You must make sure that the space that .I buf points to still exists by the time @@ -224,7 +224,7 @@ main(void) .BR printf (3), .BR puts (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setenv.3 b/man3/setenv.3 index 2ccb3b673..2be091f7a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setjmp.3 b/man3/setjmp.3 index fbac49b0a..59a985481 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -96,7 +96,6 @@ call because the "fake" return returns the value provided in If the programmer mistakenly passes the value 0 in .IR val , the "fake" return will instead return 1. -.PP .SS sigsetjmp() and siglongjmp() .BR sigsetjmp () and @@ -149,7 +148,6 @@ T{ .BR siglongjmp () T} Thread safety MT-Safe .TE -.PP .SH CONFORMING TO .BR setjmp (), .BR longjmp (): @@ -326,9 +324,9 @@ returning from the initial call to .IR main (). .SH SEE ALSO .BR signal (7), -.BR signal-safety (7) +.BR signal\-safety (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 0eb5a3722..cb2915570 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index 2b89400b8..4bcd292f5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 875085b9f..226a7410e 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.07 of the Linux +This page is part of release 5.08 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 410a19821..6387ba29d 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -271,7 +271,6 @@ may be set to either the calling process's effective group ID or, if the object is visible in the filesystem, the group ID of the parent directory. .SH NOTES -.PP POSIX leaves the behavior of the combination of .B O_RDONLY and @@ -336,10 +335,8 @@ struct shmbuf { }; .EE .in -.PP .\" .SS Program source: pshm_ucase_bounce.c -.PP The "bounce" program creates a new shared memory object with the name given in its command-line argument and sizes the object to match the size of the @@ -425,10 +422,8 @@ main(int argc, char *argv[]) } .EE .in -.PP .\" .SS Program source: pshm_ucase_send.c -.PP The "send" program takes two command-line arguments: the pathname of a shared memory object previously created by the "bounce" program and a string that is to be copied into that object. @@ -507,7 +502,6 @@ main(int argc, char *argv[]) } .EE .in -.PP .SH SEE ALSO .BR close (2), .BR fchmod (2), @@ -521,7 +515,7 @@ main(int argc, char *argv[]) .BR umask (2), .BR shm_overview (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index 42459826a..f7ae926eb 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/signbit.3 b/man3/signbit.3 index 8a2c88d2e..d632fb1fc 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/significand.3 b/man3/significand.3 index d6ddd5f60..121c94fde 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigpause.3 b/man3/sigpause.3 index c68409c15..e05ac71ac 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigqueue.3 b/man3/sigqueue.3 index 573063e73..be545be2d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigset.3 b/man3/sigset.3 index a3e0d3e80..961430bce 100644 --- a/man3/sigset.3 +++ b/man3/sigset.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2005 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGSET 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SIGSET 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sigset, sighold, sigrelse, sigignore \- System V signal API .SH SYNOPSIS @@ -290,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigsetops.3 b/man3/sigsetops.3 index 17d7007e9..a8b93613f 100644 --- a/man3/sigsetops.3 +++ b/man3/sigsetops.3 @@ -206,7 +206,7 @@ functions) and their use should be avoided in portable applications. .BR sigprocmask (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigvec.3 b/man3/sigvec.3 index 7a8f979a9..d304ef08d 100644 --- a/man3/sigvec.3 +++ b/man3/sigvec.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2005 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGVEC 3 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SIGVEC 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sigvec, sigblock, sigsetmask, siggetmask, sigmask \- BSD signal API .SH SYNOPSIS @@ -288,7 +287,7 @@ for details. .BR sigset (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 4daf97a2f..3ec659a7f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sin.3 b/man3/sin.3 index 2099f48c7..b4801946c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sincos.3 b/man3/sincos.3 index afd7e9fc5..a592be018 100644 --- a/man3/sincos.3 +++ b/man3/sincos.3 @@ -94,7 +94,7 @@ built-in optimizations, using flags such as: .PP .in +4n .EX -cc -O \-lm \-fno\-builtin prog.c +cc \-O \-lm \-fno\-builtin prog.c .EE .in .SH BUGS @@ -109,7 +109,7 @@ when a domain error occurred. .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sinh.3 b/man3/sinh.3 index 94dc5aec9..d05deacc4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sleep.3 b/man3/sleep.3 index 6c384317c..dc5cce5f2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index 9eba41460..909a4aa71 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sqrt.3 b/man3/sqrt.3 index b62fdc51c..0de9e7116 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/statvfs.3 b/man3/statvfs.3 index 3a0a7d7a1..148bebbfa 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdarg.3 b/man3/stdarg.3 index 6cbd4a4ab..3c7eeec96 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -313,7 +313,7 @@ foo(char *fmt, ...) /* '...' is C syntax for a variadic function */ .BR vscanf (3), .BR vsyslog (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdin.3 b/man3/stdin.3 index 5e3c43c9a..797b46c03 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stdio.3 b/man3/stdio.3 index a0131f1b2..91f6e922e 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.07 of the Linux +This page is part of release 5.08 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 375817c82..980897924 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index 739c154b1..a9ff36b57 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/stpncpy.3 b/man3/stpncpy.3 index f16145125..79adf8985 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index 0a9681bd5..3f95f2413 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcat.3 b/man3/strcat.3 index d612122ca..660fd3f86 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strchr.3 b/man3/strchr.3 index 1be26d53b..39cfbea68 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 991010a35..c0b5680a2 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -69,7 +69,7 @@ is less than a positive value if .I s1 is greater than -.IR s2 ; +.IR s2 . .PP The .BR strncmp () @@ -196,7 +196,7 @@ main(int argc, char *argv[]) if (res == 0) { printf("<str1> and <str2> are equal"); if (argc > 3) - printf(" in the first %d characters\en", atoi(argv[3])); + printf(" in the first %d bytes\en", atoi(argv[3])); printf("\en"); } else if (res < 0) { printf("<str1> is less than <str2> (%d)\en", res); @@ -219,7 +219,7 @@ main(int argc, char *argv[]) .BR wcsncmp (3), .BR ascii (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcoll.3 b/man3/strcoll.3 index 0e6188728..ef8513d58 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strcpy.3 b/man3/strcpy.3 index 610704b3c..661050396 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strdup.3 b/man3/strdup.3 index c473b78a3..f474408c4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strerror.3 b/man3/strerror.3 index 0bb514b6b..2f059047c 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -271,7 +271,7 @@ error when calling .BR strsignal (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfmon.3 b/man3/strfmon.3 index 3fac48cd0..4885d8b68 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -28,11 +28,10 @@ strfmon, strfmon_l \- convert monetary value to a string .nf .B #include <monetary.h> .PP -.BI "ssize_t strfmon(char *" s ", size_t " max ", const char *" format , -.B "...);" +.BI "ssize_t strfmon(char *" s ", size_t " max ", const char *" format ", ...);" .PP -.BI "ssize_t strfmon_l(char *" s ", size_t " max ", locale_t " locale ", -.B const char *" format , "...);" +.BI "ssize_t strfmon_l(char *" s ", size_t " max ", locale_t " locale , +.BI " const char *" format ", ...);" .fi .SH DESCRIPTION The @@ -80,7 +79,7 @@ is used as the numeric fill character (to be used with a left precision, see below). When not specified, the space character is used. .TP -.B ^ +.B \(ha Do not use any grouping characters that might be defined for the current locale. By default, grouping is enabled. @@ -180,7 +179,7 @@ The call .PP .in +4n .EX -strfmon(buf, sizeof(buf), "[%^=*#6n] [%=*#6i]", +strfmon(buf, sizeof(buf), "[%\(ha=*#6n] [%=*#6i]", 1234.567, 1234.567); .EE .in @@ -218,7 +217,7 @@ locales yield .BR sprintf (3), .BR locale (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfromd.3 b/man3/strfromd.3 index 2c1200c89..ae80ade66 100644 --- a/man3/strfromd.3 +++ b/man3/strfromd.3 @@ -37,11 +37,11 @@ a string .nf .B #include <stdlib.h> .PP -.BI "int strfromd(char *restrict " str ", size_t " n ", +.BI "int strfromd(char *restrict " str ", size_t " n , .BI " const char *restrict " format ", double " fp ");" -.BI "int strfromf(char *restrict " str ", size_t " n ", +.BI "int strfromf(char *restrict " str ", size_t " n , .BI " const char *restrict " format ", float "fp ");" -.BI "int strfroml(char *restrict " str ", size_t " n ", +.BI "int strfroml(char *restrict " str ", size_t " n , .BI " const char *restrict " format ", long double " fp ");" .fi .PP @@ -71,7 +71,7 @@ At most characters are stored into .IR str . .PP -The terminating null character ('\e0') is written if and only if +The terminating null byte ('\e0') is written if and only if .I n is sufficiently large, otherwise the written string is truncated at .I n @@ -127,13 +127,13 @@ infinity values: .RS If .I fp -is a NaN, +NaN, or -NaN, and +is a NaN, +NaN, or \-NaN, and .BR f (or .BR a , .BR e , .BR g ) -is the conversion specifier, the conversion is to "nan", "nan", or "-nan", +is the conversion specifier, the conversion is to "nan", "nan", or "\-nan", respectively. If .B F @@ -141,11 +141,11 @@ If .BR A , .BR E , .BR G ) -is the conversion specifier, the conversion is to "NAN" or "-NAN". +is the conversion specifier, the conversion is to "NAN" or "\-NAN". .PP Likewise if .I fp -is infinity, it is converted to [-]inf or [-]INF. +is infinity, it is converted to [\-]inf or [\-]INF. .RE .PP A malformed @@ -162,7 +162,7 @@ functions return the number of characters that would have been written in if .I n had enough space, -not counting the terminating null character. +not counting the terminating null byte. Thus, a return value of .I n or greater means that the output was truncated. @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strfry.3 b/man3/strfry.3 index 7b3cb760e..1966cadca 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strftime.3 b/man3/strftime.3 index a1fcb0e76..880c089c8 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -34,7 +34,7 @@ .\" 2005-11-22 mtk, added Glibc Notes covering optional 'flag' and .\" 'width' components of conversion specifications. .\" -.TH STRFTIME 3 2020-04-11 "GNU" "Linux Programmer's Manual" +.TH STRFTIME 3 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME strftime \- format date and time .SH SYNOPSIS @@ -177,7 +177,7 @@ Modifier: use alternative ("era-based") format, see below. (SU) .TP .B %F Equivalent to -.B %Y-%m-%d +.B %Y\-%m\-%d (the ISO\ 8601 date format). (C99) .TP .B %G @@ -424,7 +424,7 @@ conversion specification corresponds to the full alternative year representation The .I +hhmm or -.I -hhmm +.I \-hhmm numeric timezone (that is, the hour and minute offset from UTC). (SU) .TP .B %Z @@ -618,7 +618,7 @@ Do not pad a numeric result string. Pad a numeric result string with zeros even if the conversion specifier character uses space-padding by default. .TP -.B ^ +.B \(ha Convert alphabetic characters in result string to uppercase. .TP .B # @@ -653,7 +653,7 @@ Some buggy versions of .BR gcc (1) complain about the use of .BR %c : -.IR "warning: `%c' yields only last 2 digits of year in some locales" . +.IR "warning: \`%c\(aq yields only last 2 digits of year in some locales" . Of course programmers are encouraged to use .BR %c , as it gives the preferred date and time representation. @@ -750,7 +750,7 @@ main(int argc, char *argv[]) .BR sprintf (3), .BR strptime (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/string.3 b/man3/string.3 index 58164faec..9d8c9f429 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strlen.3 b/man3/strlen.3 index 7d6622566..4423cbfd7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strnlen.3 b/man3/strnlen.3 index ba58abbf4..8ea4ebadf 100644 --- a/man3/strnlen.3 +++ b/man3/strnlen.3 @@ -85,7 +85,7 @@ POSIX.1-2008. .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index 2a38ba5b3..61ec1e7ea 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strptime.3 b/man3/strptime.3 index 6fec9881c..4b9e991e6 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -313,7 +313,6 @@ T} Thread safety MT-Safe env locale .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SUSv2. .SH NOTES -.PP In principle, this function does not initialize .I tm but @@ -444,7 +443,7 @@ main(void) .BR setlocale (3), .BR strftime (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsep.3 b/man3/strsep.3 index 697ac8772..b9455f1b8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 4fb64260c..19b320179 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -101,7 +101,7 @@ Present on Solaris and the BSDs. .BR psignal (3), .BR strerror (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strspn.3 b/man3/strspn.3 index 57aba525f..080aaf244 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strstr.3 b/man3/strstr.3 index e8a5f43da..31ddd8dbf 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtod.3 b/man3/strtod.3 index ff4870bfd..bf079b305 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -213,7 +213,7 @@ the use of the functions described in this manual page is similar. .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoimax.3 b/man3/strtoimax.3 index b9e012c56..30959ce55 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtok.3 b/man3/strtok.3 index 41d295ca8..f52f211d8 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -292,7 +292,7 @@ can be found in .BR strstr (3), .BR wcstok (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtol.3 b/man3/strtol.3 index b6247dfab..2b1265d4c 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -302,7 +302,7 @@ main(int argc, char *argv[]) .BR strtoimax (3), .BR strtoul (3), .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 856611458..a7ef22854 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index 48e3d5798..65d19872a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index e62a50623..34fd6aa11 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/swab.3 b/man3/swab.3 index bd083eacb..7f6265781 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/sysconf.3 b/man3/sysconf.3 index 211c3759d..00b2a1787 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/syslog.3 b/man3/syslog.3 index 18574f9a2..9e7ae8de5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/system.3 b/man3/system.3 index 7a29bdda4..3792458bb 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -50,7 +50,7 @@ as follows: .PP .in +4n .EX -execl("/bin/sh", "sh", "-c", command, (char *) NULL); +execl("/bin/sh", "sh", "\-c", command, (char *) NULL); .EE .in .PP @@ -211,7 +211,6 @@ return value that is indistinguishable from the case where a shell could not be executed in the child process. .\" .SS Caveats -.PP Do not use .BR system () from a privileged program @@ -261,7 +260,7 @@ from a privileged program. .BR exec (3), .BR signal (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 5f697ba30..bc831816c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tan.3 b/man3/tan.3 index ef2b06d95..bfc28caec 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tanh.3 b/man3/tanh.3 index b9ecdf414..45d20797d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetpgrp.3 b/man3/tcgetpgrp.3 index 2e264ec34..2f945d7c9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index a84d5e581..64d6260e4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/telldir.3 b/man3/telldir.3 index bb64e6311..ed4575134 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tempnam.3 b/man3/tempnam.3 index 721c4061d..55c857c52 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/termios.3 b/man3/termios.3 index d8f721294..fc88696df 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -37,7 +37,7 @@ .\" Enhanced the discussion of "raw" mode for cfmakeraw(). .\" Document CMSPAR. .\" -.TH TERMIOS 3 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH TERMIOS 3 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed, cfsetspeed \- @@ -88,7 +88,6 @@ Feature Test Macro Requirements for glibc (see The termios functions describe a general terminal interface that is provided to control asynchronous communications ports. .SS The termios structure -.PP Many of the functions described here have a \fItermios_p\fP argument that is a pointer to a \fItermios\fP structure. This structure contains at least the following members: @@ -418,11 +417,11 @@ If \fBICANON\fP is also set, echo the NL character even if ECHO is not set. .B ECHOCTL (not in POSIX) If \fBECHO\fP is also set, terminal special characters other than -TAB, NL, START, and STOP are echoed as \fB^X\fP, +TAB, NL, START, and STOP are echoed as \fB\(haX\fP, where X is the character with ASCII code 0x40 greater than the special character. For example, character -0x08 (BS) is echoed as \fB^H\fP. +0x08 (BS) is echoed as \fB\(haH\fP. [requires .B _BSD_SOURCE or @@ -670,7 +669,6 @@ and see the description of noncanonical mode below. .SS Retrieving and changing terminal settings -.PP .BR tcgetattr () gets the parameters associated with the object referred by \fIfd\fP and stores them in the \fItermios\fP structure referenced by @@ -837,7 +835,6 @@ in noncanonical mode to return either 0, or \-1 with set to .BR EAGAIN . .SS Raw mode -.PP .BR cfmakeraw () sets the terminal to something like the "raw" mode of the old Version 7 terminal driver: @@ -848,23 +845,22 @@ The terminal attributes are set as follows: .PP .in +4n .EX -termios_p\->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP +termios_p\->c_iflag &= \(ti(IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL | IXON); -termios_p\->c_oflag &= ~OPOST; -termios_p\->c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN); -termios_p\->c_cflag &= ~(CSIZE | PARENB); +termios_p\->c_oflag &= \(tiOPOST; +termios_p\->c_lflag &= \(ti(ECHO | ECHONL | ICANON | ISIG | IEXTEN); +termios_p\->c_cflag &= \(ti(CSIZE | PARENB); termios_p\->c_cflag |= CS8; .EE .in .\" .SS Line control -.PP .BR tcsendbreak () transmits a continuous stream of zero-valued bits for a specific duration, if the terminal is using asynchronous serial data transmission. If \fIduration\fP is zero, it transmits zero-valued bits -for at least 0.25 seconds, and not more that 0.5 seconds. +for at least 0.25 seconds, and not more than 0.5 seconds. If \fIduration\fP is not zero, it sends zero-valued bits for some implementation-defined length of time. .PP @@ -982,7 +978,6 @@ It takes the same arguments as .BR cfsetispeed (), and sets both input and output speed. .SH RETURN VALUE -.PP .BR cfgetispeed () returns the input baud rate stored in the \fItermios\fP @@ -1112,7 +1107,7 @@ mask). .BR ioctl_tty (2), .BR setserial (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tgamma.3 b/man3/tgamma.3 index 9171997a8..2e0d10a69 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timegm.3 b/man3/timegm.3 index d5272d994..92d92b85b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/timeradd.3 b/man3/timeradd.3 index e29289634..1200760c9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index adbdefad1..7ce9e079e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index 7a64d6cbb..3dae2073b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toascii.3 b/man3/toascii.3 index c6eca2bf4..fe9a90d2f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/toupper.3 b/man3/toupper.3 index d26d2b595..a7ce82d5d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towctrans.3 b/man3/towctrans.3 index 541977446..9a9094a96 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towlower.3 b/man3/towlower.3 index 3fa376fec..1a5ee8e29 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/towupper.3 b/man3/towupper.3 index 2e8411e2d..a2b5c2091 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/trunc.3 b/man3/trunc.3 index 732f76c74..930b49b31 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tsearch.3 b/man3/tsearch.3 index be2625f67..515e1b58a 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -49,7 +49,7 @@ tsearch, tfind, tdelete, twalk, tdestroy \- manage a binary search tree .PP .BI "void twalk_r(const void *" root , .BI " void (*" action ")(const void *" nodep ", VISIT " which , -.BI " void *" closure "), +.BI " void *" closure ), .BI " void *" closure ); .PP .BI "void tdestroy(void *" root ", void (*" free_node ")(void *" nodep )); @@ -346,7 +346,7 @@ main(void) .BR lsearch (3), .BR qsort (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyname.3 b/man3/ttyname.3 index ea14ab9df..6a84966cd 100644 --- a/man3/ttyname.3 +++ b/man3/ttyname.3 @@ -66,11 +66,13 @@ Bad file descriptor. .TP .\" glibc commit 15e9a4f378c8607c2ae1aa465436af4321db0e23 .B ENODEV -File descriptor refers to a slave pseudoterminal device +.I fd +refers to a slave pseudoterminal device but the corresponding pathname could not be found (see NOTES). .TP .B ENOTTY -File descriptor does not refer to a terminal device. +.I fd +does not refer to a terminal device. .TP .B ERANGE .RB ( ttyname_r ()) @@ -118,7 +120,7 @@ to .BR isatty (3), .BR pts (4) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index f690a6e0e..5e2c8de79 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/tzset.3 b/man3/tzset.3 index 2105ccaf6..3c3ac903a 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -234,7 +234,6 @@ T} Thread safety MT-Safe env locale .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. .SH NOTES -.PP 4.3BSD had a function .BI "char *timezone(" zone ", " dst ) that returned the @@ -250,7 +249,7 @@ otherwise the daylight saving time version. .BR getenv (3), .BR tzfile (5) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ualarm.3 b/man3/ualarm.3 index 4519c5d7b..e6ab36ab2 100644 --- a/man3/ualarm.3 +++ b/man3/ualarm.3 @@ -46,8 +46,8 @@ Since glibc 2.12: (_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) || /* Glibc since 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE -.TP 4 .fi +.TP 4 Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED @@ -160,7 +160,7 @@ instead. .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ulimit.3 b/man3/ulimit.3 index 2ce858e35..3c1efce92 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/undocumented.3 b/man3/undocumented.3 index df69677b1..35c67ff19 100644 --- a/man3/undocumented.3 +++ b/man3/undocumented.3 @@ -42,7 +42,6 @@ similar to that of the other Linux section 3 man pages), and send it to .B mtk.manpages@gmail.com for inclusion in the next man page release. .SS The list -.PP .BR authdes_create (3), .BR authdes_getucred (3), .BR authdes_pk_create (3), @@ -177,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/ungetwc.3 b/man3/ungetwc.3 index 79c29567c..45f587dc5 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.07 of the Linux +This page is part of release 5.08 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 d29a65866..0b2ebdd50 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index cf26702bc..8f87fd3cf 100644 --- a/man3/unlockpt.3 +++ b/man3/unlockpt.3 @@ -33,7 +33,7 @@ Glibc 2.23 and earlier: The .BR unlockpt () function unlocks the slave pseudoterminal device -corresponding to the master pseudoterminal referred to by +corresponding to the master pseudoterminal referred to by the file descriptor .IR fd . .PP .BR unlockpt () @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/updwtmp.3 b/man3/updwtmp.3 index 7570e0927..b440c919c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/uselocale.3 b/man3/uselocale.3 index 85efab7c4..9dcf9aa43 100644 --- a/man3/uselocale.3 +++ b/man3/uselocale.3 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -124,7 +123,7 @@ and .BR locale (5), .BR locale (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/usleep.3 b/man3/usleep.3 index b4a839be5..0635acaff 100644 --- a/man3/usleep.3 +++ b/man3/usleep.3 @@ -55,8 +55,8 @@ Since glibc 2.12: (_XOPEN_SOURCE\ >=\ 500) && ! (_POSIX_C_SOURCE\ >=\ 200809L) || /* Glibc since 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE -.TP 4 .fi +.TP 4 Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED @@ -160,7 +160,7 @@ is unspecified. .BR ualarm (3), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpcpy.3 b/man3/wcpcpy.3 index 23955ea64..05bf48611 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcpncpy.3 b/man3/wcpncpy.3 index b96f6deb1..fa9b19b6c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index c34fb431c..78e471a74 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscasecmp.3 b/man3/wcscasecmp.3 index a4e06a29e..46885fab8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscat.3 b/man3/wcscat.3 index 31bffb4b5..856fa34f8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcschr.3 b/man3/wcschr.3 index 4fd5e2864..3c25d444a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscmp.3 b/man3/wcscmp.3 index 1982e5c1a..1388e91f6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscpy.3 b/man3/wcscpy.3 index a0a28987c..55ccd10b6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcscspn.3 b/man3/wcscspn.3 index 33ea692e9..e1cfdc6a0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsdup.3 b/man3/wcsdup.3 index ecdd5183b..d7a19f8da 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcslen.3 b/man3/wcslen.3 index 9ad95f21d..83603da29 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3 index 1a88260d3..17cb63326 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncat.3 b/man3/wcsncat.3 index 585d97ea7..9902a2db1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncmp.3 b/man3/wcsncmp.3 index 464073560..34b04b6c4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3 index fc42dac3c..3bd9f434d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index eaea99836..19449f38b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index aca4dad89..844331836 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcspbrk.3 b/man3/wcspbrk.3 index 5c328d9ad..1ead07aad 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrchr.3 b/man3/wcsrchr.3 index 6277bbb57..8488d04a3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index 7ac4cc5a1..ea2bf0a31 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsspn.3 b/man3/wcsspn.3 index de9377270..a618d35f6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcsstr.3 b/man3/wcsstr.3 index 416a9597b..440a783fd 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstoimax.3 b/man3/wcstoimax.3 index bfa6d1c02..ae50f63e5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstok.3 b/man3/wcstok.3 index e492116be..5ae7ff713 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 6c2f0363d..ccb397fb6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcswidth.3 b/man3/wcswidth.3 index 83ca641db..f7fd24bc2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctob.3 b/man3/wctob.3 index 92ce72c8e..56acd11cf 100644 --- a/man3/wctob.3 +++ b/man3/wctob.3 @@ -44,7 +44,7 @@ The .BR wctob () function returns the single-byte representation of .IR c , -if it exists, of +if it exists, or .B EOF otherwise. .SH ATTRIBUTES @@ -83,7 +83,7 @@ instead. .BR wcrtomb (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctomb.3 b/man3/wctomb.3 index 2193eaf5f..fcf0774f6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctrans.3 b/man3/wctrans.3 index d47e4d090..c79eb39f9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wctype.3 b/man3/wctype.3 index 080ca6d06..ed49983d8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wcwidth.3 b/man3/wcwidth.3 index 34c21eb63..abad8509a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemchr.3 b/man3/wmemchr.3 index c9eb8934d..a36b88364 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcmp.3 b/man3/wmemcmp.3 index 4b66d69a1..10b3430f3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemcpy.3 b/man3/wmemcpy.3 index aebbbfb51..b9e164dda 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemmove.3 b/man3/wmemmove.3 index ea4a35ce0..a496b105f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wmemset.3 b/man3/wmemset.3 index 6756baf7b..2a08117f1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 0d5d167c4..8c52ea0ce 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -99,7 +99,7 @@ then it is unspecified whether that word and all following words are ignored, or the # is treated as a non-comment character. .SS The expansion The expansion done consists of the following stages: -tilde expansion (replacing ~user by user's home directory), +tilde expansion (replacing \(tiuser by user's home directory), variable substitution (replacing $FOO by the value of the environment variable FOO), command substitution (replacing $(command) or \`command\` by the output of command), arithmetic expansion, field splitting, @@ -248,7 +248,7 @@ main(int argc, char **argv) .BR fnmatch (3), .BR glob (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 1dfa6101e..159506a1c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xcrypt.3 b/man3/xcrypt.3 index 1ec637945..fbc3b5759 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man3/xdr.3 b/man3/xdr.3 index 299664118..3f9b3ddaf 100644 --- a/man3/xdr.3 +++ b/man3/xdr.3 @@ -12,7 +12,6 @@ .SH NAME xdr \- library routines for external data representation .SH SYNOPSIS AND DESCRIPTION -.PP These routines allow C programmers to describe arbitrary data structures in a machine-independent fashion. Data for remote procedure calls are transmitted using these @@ -621,7 +620,7 @@ RFC\ 1014, Sun Microsystems, Inc., USC-ISI. .RE .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, @@ -85,7 +85,6 @@ _XOPEN_SOURCE \ >=\ 600 .RE .ad b .SH DESCRIPTION -.PP The .BR y0 () and @@ -273,7 +272,7 @@ when a domain error occurs. .SH SEE ALSO .BR j0 (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cciss.4 b/man4/cciss.4 index 17dff2924..1fedade23 100644 --- a/man4/cciss.4 +++ b/man4/cciss.4 @@ -140,7 +140,7 @@ For example: .in +4n .EX $ \fBcd /proc/driver/cciss\fP -$ \fBls -l\fP +$ \fBls \-l\fP total 0 -rw-r--r-- 1 root root 0 2010\-09\-10 10:38 cciss0 -rw-r--r-- 1 root root 0 2010\-09\-10 10:38 cciss1 @@ -284,7 +284,7 @@ This causes the driver to: .RS .IP 1. 3 query the adapter about changes to the -physical SCSI buses and/or fibre channel arbitrated loop, and +physical SCSI buses and/or fiber channel arbitrated loop, and .IP 2. make note of any new or removed sequential access devices or medium changers. @@ -360,7 +360,7 @@ successfully reset or the tardy command is successfully aborted, the tape drive may still not allow I/O to continue until some command is issued that positions the tape to a known position. Typically you must rewind the tape (by issuing -.I "mt -f /dev/st0 rewind" +.I "mt \-f /dev/st0 rewind" for example) before I/O can proceed again to a tape drive that was reset. .SH SEE ALSO .BR hpsa (4), @@ -380,7 +380,7 @@ in the Linux kernel source tree .\" Charles White, Francis Wiran .\" and probably some other people. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 231c13e8f..9c1bb0c3a 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1996 Andries Brouwer <aeb@cwi.nl>, Mon Oct 31 22:13:04 1996 .\" .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) @@ -20,7 +19,7 @@ .\" .\" 2006-05-27, Several corrections - Thomas E. Dickey .\" -.TH CONSOLE_CODES 4 2020-02-09 "Linux" "Linux Programmer's Manual" +.TH CONSOLE_CODES 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME console_codes \- Linux console escape and control sequences .SH DESCRIPTION @@ -93,27 +92,27 @@ The recognized control characters are BEL, BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI. They do what one would expect: .HP -BEL (0x07, \fB^G\fP) beeps; +BEL (0x07, \fB\(haG\fP) beeps; .HP -BS (0x08, \fB^H\fP) backspaces one column +BS (0x08, \fB\(haH\fP) backspaces one column (but not past the beginning of the line); .HP -HT (0x09, \fB^I\fP) goes to the next tab stop or to the end of the line +HT (0x09, \fB\(haI\fP) goes to the next tab stop or to the end of the line if there is no earlier tab stop; .HP -LF (0x0A, \fB^J\fP), VT (0x0B, \fB^K\fP) and -FF (0x0C, \fB^L\fP) all give a linefeed, +LF (0x0A, \fB\(haJ\fP), VT (0x0B, \fB\(haK\fP) and +FF (0x0C, \fB\(haL\fP) all give a linefeed, and if LF/NL (new-line mode) is set also a carriage return; .HP -CR (0x0D, \fB^M\fP) gives a carriage return; +CR (0x0D, \fB\(haM\fP) gives a carriage return; .HP -SO (0x0E, \fB^N\fP) activates the G1 character set; +SO (0x0E, \fB\(haN\fP) activates the G1 character set; .HP -SI (0x0F, \fB^O\fP) activates the G0 character set; +SI (0x0F, \fB\(haO\fP) activates the G0 character set; .HP -CAN (0x18, \fB^X\fP) and SUB (0x1A, \fB^Z\fP) abort escape sequences; +CAN (0x18, \fB\(haX\fP) and SUB (0x1A, \fB\(haZ\fP) abort escape sequences; .HP -ESC (0x1B, \fB^[\fP) starts an escape sequence; +ESC (0x1B, \fB\(ha[\fP) starts an escape sequence; .HP DEL (0x7F) is ignored; .HP @@ -397,11 +396,11 @@ ESC [ 11 ; \fIn\fP ] Set bell duration in msec. ESC [ 12 ; \fIn\fP ] Bring specified console to the front. ESC [ 13 ] Unblank the screen. ESC [ 14 ; \fIn\fP ] Set the VESA powerdown interval in minutes. -ESC [ 15 ] T{ +ESC [ 15 ] T{ Bring the previous console to the front (since Linux 2.6.0). T} -ESC [ 16 ; \fIn\fP ] T{ +ESC [ 16 ; \fIn\fP ] T{ Set the cursor blink interval in milliseconds (since Linux 4.2). T} @@ -416,8 +415,8 @@ b) VT100 graphics \-> PC, c) PC \-> PC, d) user-defined. There are two character sets, called G0 and G1, and one of them is the current character set. (Initially G0.) -Typing \fB^N\fP causes G1 to become current, -\fB^O\fP causes G0 to become current. +Typing \fB\(haN\fP causes G1 to become current, +\fB\(haO\fP causes G0 to become current. .PP These variables G0 and G1 point at a translation table, and can be changed by the user. @@ -429,11 +428,11 @@ point at translation table a), b), c) and d), respectively. .PP The sequence ESC c causes a terminal reset, which is what you want if the screen is all garbled. -The oft-advised "echo ^V^O" will make only G0 current, +The oft-advised "echo \(haV\(haO" will make only G0 current, but there is no guarantee that G0 points at table a). In some distributions there is a program .BR reset (1) -that just does "echo ^[c". +that just does "echo \(ha[c". If your terminfo entry for the console is correct (and has an entry rs1=\eEc), then "tput reset" will also work. .PP @@ -503,9 +502,9 @@ NUL (0x00) was ignored; .HP ENQ (0x05) triggered an answerback message; .HP -DC1 (0x11, \fB^Q\fP, XON) resumed transmission; +DC1 (0x11, \fB\(haQ\fP, XON) resumed transmission; .HP -DC3 (0x13, \fB^S\fP, XOFF) caused VT100 to ignore (and stop transmitting) +DC3 (0x13, \fB\(haS\fP, XOFF) caused VT100 to ignore (and stop transmitting) all codes except XOFF and XON. .PP VT100-like DC1/DC3 processing may be enabled by the terminal driver. @@ -527,7 +526,7 @@ ESC O SS3 Single shift 3. (Select G3 character set for the next character only.) ESC P DCS Device control string (ended by ESC \e) ESC X SOS Start of string. -ESC ^ PM Privacy message (ended by ESC \e) +ESC \(ha PM Privacy message (ended by ESC \e) ESC \e ST String terminator ESC * ... Designate G2 character set ESC + ... Designate G3 character set @@ -539,7 +538,7 @@ The program ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \e, ESC Z (it answers ESC [ ? 1 ; 2 c, "I am a VT100 with advanced video option") -and ESC ^ ... ESC \e with the same meanings as indicated above. +and ESC \(ha ... ESC \e with the same meanings as indicated above. It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC special character and line drawing set, UK, and US-ASCII, respectively. @@ -584,7 +583,7 @@ ESC n LS2 Invoke the G2 character set. ESC o LS3 Invoke the G3 character set. ESC | LS3R Invoke the G3 character set as GR. ESC } LS2R Invoke the G2 character set as GR. -ESC ~ LS1R Invoke the G1 character set as GR. +ESC \(ti LS1R Invoke the G1 character set as GR. .TE .PP It also recognizes ESC % and provides a more complete UTF-8 @@ -676,7 +675,7 @@ It is ignored. .BR ioctl_console (2), .BR charsets (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/cpuid.4 b/man4/cpuid.4 index 70f06a3f6..95e441030 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/dsp56k.4 b/man4/dsp56k.4 index b549f4eb0..a9bcea173 100644 --- a/man4/dsp56k.4 +++ b/man4/dsp56k.4 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2000 lars brinkhoff <lars@nocrew.org> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -24,7 +23,7 @@ .\" .\" Modified, Thu Jan 27 19:16:19 CET 2000, lars@nocrew.org .\" -.TH DSP56K 4 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH DSP56K 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME dsp56k \- DSP56001 interface device .SH SYNOPSIS @@ -41,7 +40,9 @@ dsp56k \- DSP56001 interface device .BI "int ioctl(int " fd ", DSP56K_HOST_CMD, int " cmd ); .fi .SH CONFIGURATION -The dsp56k device is a character device with major number 55 and minor +The +.B dsp56k +device is a character device with major number 55 and minor number 0. .SH DESCRIPTION The Motorola DSP56001 is a fully programmable 24-bit digital signal @@ -108,7 +109,7 @@ sends a host command. Allowed values are in the range 0 to 31, and is a user-defined command handled by the program running in the DSP56001. .SH FILES -/dev/dsp56k +.I /dev/dsp56k .\" .SH AUTHORS .\" Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>, .\" Tomas Berndtsson <tomas@nocrew.org>. @@ -119,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1993 Michael Haardt (michael@cantor.informatik.rwth-aachen.de) .\" and 1994,1995 Alain Knaff (Alain.Knaff@imag.fr) .\" @@ -25,7 +24,7 @@ .\" .\" Modified, Sun Feb 26 15:00:02 1995, faith@cs.unc.edu .\" -.TH FD 4 2014-05-10 "Linux" "Linux Programmer's Manual" +.TH FD 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME fd \- floppy disk device .SH CONFIGURATION @@ -232,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/full.4 b/man4/full.4 index 42f04e083..15e0dbe36 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/fuse.4 b/man4/fuse.4 index 79031ce59..58c4c8a24 100644 --- a/man4/fuse.4 +++ b/man4/fuse.4 @@ -559,7 +559,7 @@ The following messages are not yet documented in this manual page: .BR fusermount (1), .BR mount.fuse (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/hpsa.4 b/man4/hpsa.4 index 396d61395..6bbc4f32d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/initrd.4 b/man4/initrd.4 index 827659d77..e8fa0b873 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -75,7 +75,7 @@ is a read-only block device. This device is a RAM disk that is initialized (e.g., loaded) by the boot loader before the kernel is started. The kernel then can use -.IR /dev/initrd "'s " +.IR /dev/initrd "'s" contents for a two-phase system boot-up. .PP In the first boot-up phase, the kernel starts up @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/intro.4 b/man4/intro.4 index 3fe7ea8fa..5c35d50c0 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/lirc.4 b/man4/lirc.4 index 8b39c7aac..7c789f650 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/loop.4 b/man4/loop.4 index fa0c19275..1a1d9fe15 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -42,8 +42,8 @@ You could do .in +4n .EX $ \fBdd if=/dev/zero of=file.img bs=1MiB count=10\fP -$ \fBsudo losetup /dev/loop4 file.img \fP -$ \fBsudo mkfs -t ext4 /dev/loop4\fP +$ \fBsudo losetup /dev/loop4 file.img\fP +$ \fBsudo mkfs \-t ext4 /dev/loop4\fP $ \fBsudo mkdir /myloopdev\fP $ \fBsudo mount /dev/loop4 /myloopdev\fP .EE @@ -318,7 +318,7 @@ main(int argc, char *argv[]) .BR losetup (8), .BR mount (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) Michael Haardt (michael@cantor.informatik.rwth-aachen.de), .\" Sun Jan 15 19:16:33 1995 .\" @@ -24,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" Modified, Sun Feb 26 15:02:58 1995, faith@cs.unc.edu -.TH LP 4 1995-01-15 "Linux" "Linux Programmer's Manual" +.TH LP 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME lp \- line printer devices .SH SYNOPSIS @@ -143,7 +142,7 @@ No argument is used. .BR lpcntl (8), .BR tunelp (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mem.4 b/man4/mem.4 index 115a12f9b..26c839205 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/mouse.4 b/man4/mouse.4 index 9aaa7d5fa..4e8a9c872 100644 --- a/man4/mouse.4 +++ b/man4/mouse.4 @@ -1,4 +1,3 @@ -'\" t .\" This manpage is Copyright (C) 1996 Michael Haardt. .\" Updates Nov 1998, Andries Brouwer .\" @@ -23,7 +22,7 @@ .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.TH MOUSE 4 2016-10-08 "Linux" "Linux Programmer's Manual" +.TH MOUSE 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME mouse \- serial mouse interface .SH CONFIGURATION @@ -190,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/msr.4 b/man4/msr.4 index 04409086d..cb2e71e4b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/null.4 b/man4/null.4 index dde33c38b..edffe9610 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/pts.4 b/man4/pts.4 index 6408f99b4..1dc2c2937 100644 --- a/man4/pts.4 +++ b/man4/pts.4 @@ -5,12 +5,13 @@ .\" Redistribute and revise at will. .\" %%%LICENSE_END .\" -.TH PTS 4 2016-03-15 "Linux" "Linux Programmer's Manual" +.TH PTS 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME ptmx, pts \- pseudoterminal master and slave .SH DESCRIPTION The file .I /dev/ptmx +(the pseudoterminal multiplexor device) is a character file with major number 5 and minor number 2, usually with mode 0666 and ownership root:root. It is used to create a pseudoterminal master and slave pair. @@ -18,13 +19,14 @@ It is used to create a pseudoterminal master and slave pair. When a process opens .IR /dev/ptmx , it gets a file -descriptor for a pseudoterminal master (PTM), -and a pseudoterminal slave (PTS) device is created in the +descriptor for a pseudoterminal master +and a pseudoterminal slave device is created in the .I /dev/pts directory. Each file descriptor obtained by opening .IR /dev/ptmx -is an independent PTM with its own associated PTS, whose path can +is an independent pseudoterminal master with its own associated slave, +whose path can be found by passing the file descriptor to .BR ptsname (3). .PP @@ -63,14 +65,8 @@ and The Linux support for the above (known as UNIX 98 pseudoterminal naming) is done using the .I devpts -filesystem, that should be mounted on +filesystem, which should be mounted on .IR /dev/pts . -.PP -Before this UNIX 98 scheme, master pseudoterminals were called -.IR /dev/ptyp0 ", ..." -and slave pseudoterminals -.IR /dev/ttyp0 ", ..." -and one needed lots of preallocated device nodes. .SH SEE ALSO .BR getpt (3), .BR grantpt (3), @@ -78,7 +74,7 @@ and one needed lots of preallocated device nodes. .BR unlockpt (3), .BR pty (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ram.4 b/man4/ram.4 index 7454b7b50..808f2271b 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/random.4 b/man4/random.4 index 197408b54..2c53bfde7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/rtc.4 b/man4/rtc.4 index 24c396d6c..09971d160 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.07 of the Linux +This page is part of release 5.08 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index fc78a9d92..fcb98e035 100644 --- a/man4/sk98lin.4 +++ b/man4/sk98lin.4 @@ -24,7 +24,7 @@ .\" .\" This manpage can be viewed using `groff -Tascii -man sk98lin.4 | less` .\" -.TH SK98LIN 4 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SK98LIN 4 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME sk98lin \- Marvell/SysKonnect Gigabit Ethernet driver v6.21 .SH SYNOPSIS @@ -156,13 +156,13 @@ which can be found on the Internet: .PP .IR VLAN \c : -.UR http://www.candelatech.com\:/~greear\:/vlan.html +.UR http://www.candelatech.com\:/\(tigreear\:/vlan.html .UE .br .I Link .IR Aggregation \c : -.UR http://www.st.rim.or.jp\:/~yumo +.UR http://www.st.rim.or.jp\:/\(tiyumo .UE .PP Note that Marvell/SysKonnect does not offer any support for these @@ -587,7 +587,7 @@ Report any bugs to linux@syskonnect.de .BR insmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/smartpqi.4 b/man4/smartpqi.4 index 4fa693c80..6c9f8d5d2 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.07 of the Linux +This page is part of release 5.08 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/tty.4 b/man4/tty.4 index 84333817b..1983761e1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/ttyS.4 b/man4/ttyS.4 index dcb9a1fd4..472a42ae5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/vcs.4 b/man4/vcs.4 index 7b6debb9c..772725788 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -176,9 +176,9 @@ main(void) ch = s & 0xff; if (s & mask) ch |= 0x100; - attrib = ((s & ~mask) >> 8); + attrib = ((s & \(timask) >> 8); printf("ch=0x%03x attrib=0x%02x\en", ch, attrib); - s ^= 0x1000; + s \(ha= 0x1000; (void) lseek(fd, \-2, SEEK_CUR); (void) write(fd, &s, 2); exit(EXIT_SUCCESS); @@ -190,7 +190,7 @@ main(void) .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/veth.4 b/man4/veth.4 index 269acd931..3f61e1e3c 100644 --- a/man4/veth.4 +++ b/man4/veth.4 @@ -91,10 +91,10 @@ network interface, using commands something like: .in +4n .EX # \fBip link add ve_A type veth peer name ve_B\fP # Create veth pair -# \fBethtool -S ve_A\fP # Discover interface index of peer +# \fBethtool \-S ve_A\fP # Discover interface index of peer NIC statistics: peer_ifindex: 16 -# \fBip link | grep '^16:'\fP # Look up interface +# \fBip link | grep '\(ha16:'\fP # Look up interface 16: ve_B@ve_A: <BROADCAST,MULTICAST,M-DOWN> mtu 1500 qdisc ... .EE .in @@ -103,10 +103,10 @@ NIC statistics: .BR clone (2), .BR network_namespaces (7), .BR ip (8), -.BR ip-link (8), -.BR ip-netns (8) +.BR ip\-link (8), +.BR ip\-netns (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man4/wavelan.4 b/man4/wavelan.4 index 80e389f63..22c5b3a50 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/acct.5 b/man5/acct.5 index c85300665..ac78c5fde 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/attr.5 b/man5/attr.5 deleted file mode 100644 index e9799711a..000000000 --- a/man5/attr.5 +++ /dev/null @@ -1,2 +0,0 @@ -.so man7/xattr.7 -.\" Page was imported from 'attr' project which had it in Section 5 diff --git a/man5/charmap.5 b/man5/charmap.5 index 06a4736fe..101cf8245 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/core.5 b/man5/core.5 index 6f242501d..b52082beb 100644 --- a/man5/core.5 +++ b/man5/core.5 @@ -624,7 +624,7 @@ UID=%u GID=%g sig=%s\(dq > \e" .B " /proc/sys/kernel/core_pattern" .RB "#" " exit" .RB "$" " sleep 100" -.BR "^\e" " # type control-backslash" +.BR "\(ha\e" " # type control-backslash" Quit (core dumped) .RB "$" " cat core.info" argc=5 @@ -704,7 +704,7 @@ main(int argc, char *argv[]) .BR signal (7), .BR systemd\-coredump (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 ccdaab0dd..13bec7eed 100644 --- a/man5/dir_colors.5 +++ b/man5/dir_colors.5 @@ -9,7 +9,7 @@ .\" .\" Modified Sat Dec 22 22:25:33 2001 by Martin Schulze <joey@infodrom.org> .\" -.TH DIR_COLORS 5 2013-08-09 "GNU" "Linux User Manual" +.TH DIR_COLORS 5 2020-08-13 "GNU" "Linux User Manual" .SH NAME dir_colors \- configuration file for dircolors(1) .SH DESCRIPTION @@ -226,7 +226,7 @@ ends in .\fIextension\fR. Note that the period is included in the extension, which makes it impossible to specify an extension not starting with a period, such as -.B ~ +.B \(ti for .B emacs backup files. @@ -347,7 +347,7 @@ can, however, be specified, which would have the same effect. To specify control- or blank characters in the color sequences or filename extensions, either C-style \e-escaped notation or .BR stty \-style -^-notation can be used. +\(ha-notation can be used. The C-style notation includes the following characters: .RS @@ -366,7 +366,7 @@ lb l. \ex\fInnn Any character (hexadecimal notation) \e_ Space \e\e Backslash (\e) -\e^ Caret (^) +\e\(ha Caret (\(ha) \e# Hash mark (#) .TE .RE @@ -379,7 +379,7 @@ hash mark as the first character. .I /etc/DIR_COLORS System-wide configuration file. .TP -.I ~/.dir_colors +.I \(ti/.dir_colors Per-user configuration file. .PP This page describes the @@ -409,7 +409,7 @@ is undefined. .BR stty (1), .BR xterm (1) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/elf.5 b/man5/elf.5 index 79e62f600..7da35b552 100644 --- a/man5/elf.5 +++ b/man5/elf.5 @@ -2192,7 +2192,7 @@ AMD64 ABI Draft, .IR "System V Application Binary Interface AMD64 Architecture Processor Supplement" . .PP .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/filesystems.5 b/man5/filesystems.5 index c16097fd8..c485baa9d 100644 --- a/man5/filesystems.5 +++ b/man5/filesystems.5 @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ftpusers.5 b/man5/ftpusers.5 index 60331b79b..98e5099c5 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.07 of the Linux +This page is part of release 5.08 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 f13765da5..eda0bf90a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/group.5 b/man5/group.5 index 493edf312..38bee6f83 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.07 of the Linux +This page is part of release 5.08 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 0cfe018eb..be7993631 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/hosts.5 b/man5/hosts.5 index cbbb5c7e4..47ee6a66b 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -42,6 +42,7 @@ line should be present with the following information: IP_address canonical_hostname [aliases...] .RE .PP +The IP address can conform to either IPv4 or IPv6. Fields of the entry are separated by any number of blanks and/or tab characters. Text from a "#" character until the end of the line is @@ -53,6 +54,8 @@ alphabetic character and end with an alphanumeric character. Optional aliases provide for name changes, alternate spellings, shorter hostnames, or generic hostnames (for example, .IR localhost ). +If required, a host may have two separate entries in this file; +one for each version of the Internet Protocol (IPv4 and IPv6). .PP The Berkeley Internet Name Domain (BIND) Server implements the Internet name server for UNIX systems. @@ -135,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.07 of the Linux +This page is part of release 5.08 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 f18d7e4a2..989947a88 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -85,7 +85,7 @@ the particular service Below are some example .I /etc/host.equiv or -.I ~/.rhosts +.I \(ti/.rhosts files. .PP Allow any user to log in from any host: @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/intro.5 b/man5/intro.5 index 32a097fd5..23710182f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/issue.5 b/man5/issue.5 index 52e4e7703..7aafbe71f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/locale.5 b/man5/locale.5 index 9a8043304..4bab77b40 100644 --- a/man5/locale.5 +++ b/man5/locale.5 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright (C) 1994 Jochen Hein (Hein@Student.TU-Clausthal.de) .\" Copyright (C) 2008 Petr Baudis (pasky@suse.cz) .\" Copyright (C) 2014 Michael Kerrisk <mtk@manpages@gmail.com> @@ -104,7 +103,6 @@ the GNU C library supports the following nonstandard categories: See .BR locale (7) for a more detailed description of each category. -.PP .SS LC_ADDRESS The definition starts with the string .I LC_ADDRESS @@ -201,7 +199,7 @@ followed by the three-letter abbreviation of the country (ISO 3166). followed by the numeric country code (ISO 3166). .TP .I country_car -followed by the international licence plate country code. +followed by the international license plate country code. .TP .I country_isbn followed by the ISBN code (for books). @@ -1125,7 +1123,6 @@ Each string has the following format: .IR direction ":" offset ":" start_date ":" end_date ":" era_name ":" era_format .PP The fields are to be defined as follows: -.PP .TP 4 .I direction Either @@ -1330,9 +1327,9 @@ Monday for the locale. .BR charsets (7), .BR locale (7), .BR unicode (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/motd.5 b/man5/motd.5 index 1027c0b6a..a0f048c08 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/networks.5 b/man5/networks.5 index b2d340d56..29a54bbd9 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nologin.5 b/man5/nologin.5 index 690ff9dab..927ab5b1c 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.07 of the Linux +This page is part of release 5.08 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 3210335e4..f3e049443 100644 --- a/man5/nscd.conf.5 +++ b/man5/nscd.conf.5 @@ -43,7 +43,7 @@ or \fInetgroup\fP. Specifies name of the file to which debug info should be written. .RE .PP -.B debug-level +.B debug\-level .I value .RS Sets the desired debug level. @@ -58,14 +58,14 @@ requests. At least five threads will always be created. .RE .PP -.B max-threads +.B max\-threads .I number .RS Specifies the maximum number of threads. The default is 32. .RE .PP -.B server-user +.B server\-user .I user .RS If this option is set, nscd will run as this user and not as root. @@ -73,13 +73,13 @@ If a separate cache for every user is used (\-S parameter), this option is ignored. .RE .PP -.B stat-user +.B stat\-user .I user .RS Specifies the user who is allowed to request statistics. .RE .PP -.B reload-count +.B reload\-count unlimited | .I number .RS @@ -95,7 +95,7 @@ Enabling paranoia mode causes nscd to restart itself periodically. The default is no. .RE .PP -.B restart-interval +.B restart\-interval .I time .RS Sets the restart interval to @@ -107,7 +107,7 @@ mode. The default is 3600. .RE .PP -.B enable-cache +.B enable\-cache .I service .I <yes|no> .RS @@ -117,7 +117,7 @@ cache. The default is no. .RE .PP -.B positive-time-to-live +.B positive\-time\-to\-live .I service .I value .RS @@ -130,7 +130,7 @@ Larger values increase cache hit rates and reduce mean response times, but increase problems with cache coherence. .RE .PP -.B negative-time-to-live +.B negative\-time\-to\-live .I service .I value .RS @@ -145,7 +145,7 @@ example untarring the Linux kernel sources as root); should be kept small to reduce cache coherency problems. .RE .PP -.B suggested-size +.B suggested\-size .I service .I value .RS @@ -155,7 +155,7 @@ should remain a prime number for optimum efficiency. The default is 211. .RE .PP -.B check-files +.B check\-files .I service .I <yes|no> .RS @@ -196,7 +196,7 @@ daemon over the socket each time a lookup is performed. The default is no. .RE .PP -.B max-db-size +.B max\-db\-size .I service .I bytes .RS @@ -205,7 +205,7 @@ The maximum allowable size, in bytes, of the database files for the The default is 33554432. .RE .PP -.B auto-propagate +.B auto\-propagate .I service .I <yes|no> .RS @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/nss.5 b/man5/nss.5 index e821536a7..4c583d41c 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.07 of the Linux +This page is part of release 5.08 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 1f324d45d..f719a6a3a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/numa_maps.5 b/man5/numa_maps.5 deleted file mode 100644 index de68c0b7f..000000000 --- a/man5/numa_maps.5 +++ /dev/null @@ -1,5 +0,0 @@ -.so man7/numa.7 -.\" As part of the numactl() package, the /proc/PID/numa_maps -.\" documentation was in a numa_maps.5 page; this link -.\" ensures that "man 5 numa_maps" still works. -.\" Eventually, we may want to remove it -- mtk, Aug 2008 diff --git a/man5/passwd.5 b/man5/passwd.5 index 4028d3097..efa336326 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/proc.5 b/man5/proc.5 index 992ae9930..0b85e02d3 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-04-11 "Linux" "Linux Programmer's Manual" +.TH PROC 5 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME proc \- process information pseudo-filesystem .SH DESCRIPTION @@ -570,7 +570,7 @@ The value in this file is used for the specifier in .IR /proc/sys/kernel/core_pattern ; see -.BR proc (5). +.BR core (5). .TP .IR /proc/[pid]/coredump_filter " (since Linux 2.6.23)" See @@ -588,19 +588,10 @@ for instance, you can do this: .IP .in +4n .EX -.RB "$" " cd /proc/20/cwd; /bin/pwd" +.RB "$" " cd /proc/20/cwd; pwd \-P" .EE .in .IP -Note that the -.I pwd -command is often a shell built-in, and might -not work properly. -In -.BR bash (1), -you may use -.IR "pwd\ \-P" . -.IP .\" The following was still true as at kernel 2.6.13 In a multithreaded process, the contents of this symbolic link are not available if the main thread has already terminated @@ -1222,7 +1213,7 @@ this file is readable by all users on the system. .\" Added in 2.6.11; updating requires CAP_AUDIT_CONTROL .\" CONFIG_AUDITSYSCALL .TP -.IR /proc/[pid]/map_files/ " (since kernel 3.3) +.IR /proc/[pid]/map_files/ " (since kernel 3.3)" .\" commit 640708a2cff7f81e246243b0073c66e6ece7e53e This subdirectory contains entries corresponding to memory-mapped files (see @@ -1288,7 +1279,7 @@ check; see .IP The format of the file is: .IP -.in 4n +.in +4n .EX .I "address perms offset dev inode pathname" 00400000\-00452000 r\-xp 00000000 08:02 173521 /usr/bin/dbus\-daemon @@ -1395,7 +1386,7 @@ is shown unescaped except for newline characters, which are replaced with an octal escape sequence. As a result, it is not possible to determine whether the original pathname contained a newline character or the literal -.I \ee012 +.I \e012 character sequence. .IP If the mapping is file-backed and the file has been deleted, the string @@ -1436,8 +1427,8 @@ The file contains lines of the form: .EX 36 35 98:0 /mnt1 /mnt2 rw,noatime master:1 \- ext3 /dev/root rw,errors=continue (1)(2)(3) (4) (5) (6) (7) (8) (9) (10) (11) -.in .EE +.in .IP The numbers in parentheses are labels for the descriptions below: .RS 7 @@ -2080,7 +2071,6 @@ check (refer to .BR ptrace (2)). If the check denies access, then the field value is displayed as 0. The affected fields are indicated with the marking [PT]. -.IP .RS .TP 10 (1) \fIpid\fP \ %d @@ -2089,6 +2079,9 @@ The process ID. .TP (2) \fIcomm\fP \ %s The filename of the executable, in parentheses. +Strings longer than +.B TASK_COMM_LEN +(16) characters (including the terminating null byte) are silently truncated. This is visible whether or not the executable is swapped out. .TP (3) \fIstate\fP \ %c @@ -2504,6 +2497,9 @@ The fields are as follows: .IP * 2 .IR Name : Command run by this process. +Strings longer than +.B TASK_COMM_LEN +(16) characters (including the terminating null byte) are silently truncated. .IP * .IR Umask : Process umask, expressed in octal with a leading zero; see @@ -2820,7 +2816,6 @@ In a multithreaded process, the contents of the directory are not available if the main thread has already terminated (typically by calling .BR pthread_exit (3)). -.IP .TP .IR /proc/[pid]/task/[tid]/children " (since Linux 3.5)" .\" commit 818411616baf46ceba0cff6f05af3a9b294734f7 @@ -3549,17 +3544,17 @@ It is more eligible to be reclaimed for other purposes. .IR HighTotal " %lu" (Starting with Linux 2.6.19, \fBCONFIG_HIGHMEM\fP is required.) Total amount of highmem. -Highmem is all memory above ~860 MB of physical memory. +Highmem is all memory above \(ti860 MB of physical memory. Highmem areas are for use by user-space programs, or for the page cache. The kernel must use tricks to access this memory, making it slower to access than lowmem. .TP -.IR HighFree " %lu +.IR HighFree " %lu" (Starting with Linux 2.6.19, \fBCONFIG_HIGHMEM\fP is required.) Amount of free highmem. .TP -.IR LowTotal " %lu +.IR LowTotal " %lu" (Starting with Linux 2.6.19, \fBCONFIG_HIGHMEM\fP is required.) Total amount of lowmem. Lowmem is memory which can be used for everything that @@ -3571,7 +3566,7 @@ it is where everything from is allocated. Bad things happen when you're out of lowmem. .TP -.IR LowFree " %lu +.IR LowFree " %lu" (Starting with Linux 2.6.19, \fBCONFIG_HIGHMEM\fP is required.) Amount of free lowmem. .TP @@ -3978,7 +3973,6 @@ sl local_address rem_address st tx_queue rx_queue tr rexmits tm\->when uid 1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0 .EE .in -.IP .TP .I /proc/net/unix Lists the UNIX domain sockets present within the system and their @@ -4344,7 +4338,7 @@ system call. String values may be terminated by either \(aq\e0\(aq or \(aq\en\(aq. .IP Integer and long values may be written either in decimal or in -hexadecimal notation (e.g. 0x3FFF). +hexadecimal notation (e.g., 0x3FFF). When writing multiple integer or long values, these may be separated by any of the following whitespace characters: \(aq\ \(aq, \(aq\et\(aq, or \(aq\en\(aq. @@ -4401,7 +4395,7 @@ on older kernels). This file contains information about the status of the directory cache (dcache). The file contains six numbers, -.IR nr_dentry ", " nr_unused ", " age_limit " (age in seconds), " +.IR nr_dentry ", " nr_unused ", " age_limit " (age in seconds)," .I want_pages (pages requested by system) and two dummy values. .RS @@ -4579,7 +4573,7 @@ See .BR mq_overview (7) for details. .TP -.IR /proc/sys/fs/nr_open " (since Linux 2.6.25) +.IR /proc/sys/fs/nr_open " (since Linux 2.6.25)" .\" commit 9cfe015aa424b3c003baba3841a60dd9b5ad319b This file imposes a ceiling on the value to which the .BR RLIMIT_NOFILE @@ -4623,7 +4617,7 @@ Writing to FIFOs is unrestricted. 1 Don't allow .B O_CREAT -.BR open (2) +.BR open (2) on FIFOs that the caller doesn't own in world-writable sticky directories, unless the FIFO is owned by the owner of the directory. .TP @@ -4696,7 +4690,7 @@ Writing to regular files is unrestricted. 1 Don't allow .B O_CREAT -.BR open (2) +.BR open (2) on regular files that the caller doesn't own in world-writable sticky directories, unless the regular file is owned by the owner of the directory. @@ -5197,7 +5191,7 @@ This file is documented in the Linux kernel source file .I Documentation/initrd.txt before Linux 4.10). .TP -.IR /proc/sys/kernel/reboot\-cmd " (Sparc only) " +.IR /proc/sys/kernel/reboot\-cmd " (Sparc only)" This file seems to be a way to give an argument to the SPARC ROM/Flash boot loader. Maybe to tell it what to do after @@ -5479,7 +5473,7 @@ is reduced accordingly. See .BR ptrace (2). .TP -.IR /proc/sys/kernel/zero\-paged " (PowerPC only) " +.IR /proc/sys/kernel/zero\-paged " (PowerPC only)" This file contains a flag. When enabled (nonzero), Linux-PPC will pre-zero pages in @@ -6815,7 +6809,7 @@ The Linux kernel source files: and .IR Documentation/sysctl/vm.txt . .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/protocols.5 b/man5/protocols.5 index 23fc32830..5f645c867 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/repertoiremap.5 b/man5/repertoiremap.5 index 47242cdb9..0b137bd37 100644 --- a/man5/repertoiremap.5 +++ b/man5/repertoiremap.5 @@ -1,4 +1,3 @@ -.\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as @@ -77,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.07 of the Linux +This page is part of release 5.08 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 a3df37ff4..2b7f40bbd 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -20,7 +20,7 @@ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" -.TH RESOLV.CONF 5 2019-10-10 "" "Linux Programmer's Manual" +.TH RESOLV.CONF 5 2020-08-13 "" "Linux Programmer's Manual" .UC 4 .SH NAME resolv.conf \- resolver configuration file @@ -223,7 +223,7 @@ this option is deprecated; applications should use rather than .BR gethostbyname (3). .TP -.BR ip6\-bytestring " (since glibc 2.3.4)" +.BR ip6\-bytestring " (since glibc 2.3.4 to 2.24)" Sets .BR RES_USEBSTRING in @@ -251,7 +251,7 @@ reverse IPv6 lookups are made in the .I ip6.arpa zone by default. These options are available in glibc versions up to 2.24, where -.BR no-ip6-dotint +.BR no\-ip6\-dotint is the default. Since .BR ip6\-dotint @@ -350,7 +350,7 @@ in the first column are treated as comments. .PP Name Server Operations Guide for BIND .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/rpc.5 b/man5/rpc.5 index 96ebe10b3..f0605e549 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/securetty.5 b/man5/securetty.5 index aa77870ff..089275b09 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/services.5 b/man5/services.5 index f5fdca0fb..21afcb0d8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/shells.5 b/man5/shells.5 index 8b5b25cce..228660ae8 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/slabinfo.5 b/man5/slabinfo.5 index ac09b0a71..0f97133ad 100644 --- a/man5/slabinfo.5 +++ b/man5/slabinfo.5 @@ -239,7 +239,7 @@ The kernel source file and .IR tools/vm/slabinfo.c . .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/sysfs.5 b/man5/sysfs.5 index 01413d255..f25ad4fa7 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/termcap.5 b/man5/termcap.5 index f43397f34..64baf918d 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -28,7 +28,7 @@ .\" If mistakes in the capabilities are found, please send a bug report to: .\" michael@moria.de .\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond (esr@thyrsus.com) -.TH TERMCAP 5 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH TERMCAP 5 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME termcap \- terminal capability database .SH DESCRIPTION @@ -117,7 +117,7 @@ NR ti does not reverse te nx No padding, must use XON/XOFF os Terminal can overstrike ul Terminal underlines although it can not overstrike -xb Beehive glitch, f1 sends ESCAPE, f2 sends \fB^C\fP +xb Beehive glitch, f1 sends ESCAPE, f2 sends \fB\(haC\fP xn Newline/wraparound glitch xo Terminal uses xon/xoff protocol xs Text typed over standout text will be displayed in standout @@ -209,7 +209,7 @@ AL Insert %1 lines ac Pairs of block graphic characters to map alternate character set ae End alternative character set as Start alternative character set for block graphic characters -bc Backspace, if not \fB^H\fP +bc Backspace, if not \fB\(haH\fP bl Audio bell bt Move to previous tab stop cb Clear from beginning of line to cursor @@ -375,15 +375,15 @@ ve Normal cursor visible vi Cursor invisible vs Standout cursor wi Set window from line %1 to %2 and column %3 to %4 -XF XOFF character if not \fB^S\fP +XF XOFF character if not \fB\(haS\fP .fi .PP There are several ways of defining the control codes for string capabilities: .PP Every normal character represents itself, -except \(aq^\(aq, \(aq\e\(aq, and \(aq%\(aq. +except \(aq\(ha\(aq, \(aq\e\(aq, and \(aq%\(aq. .PP -A \fB^x\fP means Control-x. +A \fB\(hax\fP means Control-x. Control-A equals 1 decimal. .PP \ex means a special code. @@ -443,7 +443,7 @@ The following names are available: \&. down arrow (v) 0 full square (#) I lantern (#) -- upper arrow (^) +- upper arrow (\(ha) \&' rhombus (+) a chess board (:) f degree (') @@ -462,7 +462,7 @@ u right tee (+) v bottom tee (+) w normal tee (+) x vertical line (|) -~ paragraph (???) +\(ti paragraph (???) .fi .PP The values in parentheses are suggested defaults which are used by the @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tmpfs.5 b/man5/tmpfs.5 index 563a1522e..b10376cd7 100644 --- a/man5/tmpfs.5 +++ b/man5/tmpfs.5 @@ -40,7 +40,7 @@ via a command such as the following: .PP .in +4n .EX -$ sudo mount \-t tmpfs -o size=10M tmpfs /mnt/mytmpfs +$ sudo mount \-t tmpfs \-o size=10M tmpfs /mnt/mytmpfs .EE .in .PP @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/ttytype.5 b/man5/ttytype.5 index cb8c2de23..cf7b0a417 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/tzfile.5 b/man5/tzfile.5 index 1611cea16..762f05624 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man5/utmp.5 b/man5/utmp.5 index b6bbd3e12..2364310d9 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 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH UTMP 5 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME utmp, wtmp \- login records .SH SYNOPSIS @@ -204,7 +204,7 @@ The \fIwtmp\fP file records all logins and logouts. Its format is exactly like \fIutmp\fP except that a null username indicates a logout on the associated terminal. -Furthermore, the terminal name \fB~\fP +Furthermore, the terminal name \fB\(ti\fP with username \fBshutdown\fP or \fBreboot\fP indicates a system shutdown or reboot and the pair of terminal names \fB|\fP/\fB}\fP logs the old/new system time when @@ -353,7 +353,7 @@ ut.ut_tv.tv_usec = tv.tv_usec; .BR logwtmp (3), .BR updwtmp (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man6/intro.6 b/man6/intro.6 index 5524c957f..51006fc82 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.07 of the Linux +This page is part of release 5.08 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 7bd52d503..daa4d489d 100644 --- a/man7/address_families.7 +++ b/man7/address_families.7 @@ -194,7 +194,7 @@ For further information see .\" rds-tools: https://github.com/oracle/rds-tools/blob/master/rds.7 .\" rds-tools: https://github.com/oracle/rds-tools/blob/master/rds-rdma.7 .BR rds (7), -.BR rds-rdma (7), +.BR rds\-rdma (7), and .I Documentation/networking/rds.txt in the Linux kernel source tree. @@ -301,7 +301,6 @@ See .I IUCV protocol overview .UE for details. -.TQ .TP .B AF_RXRPC .\" commit: 17926a79320afa9b95df6b977b40cca6d8713cea @@ -369,7 +368,7 @@ For further information, see .TP .B AF_KCM .\" commit: 03c8efc1ffeb6b82a22c1af8dd908af349563314 -KCM (kernel connection multiplexor) interface (since Linux 4.6). +KCM (kernel connection multiplexer) interface (since Linux 4.6). See .I Documentation/networking/kcm.txt in the Linux kernel source tree for details. @@ -409,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/aio.7 b/man7/aio.7 index fa5440b2f..fb3ea7d72 100644 --- a/man7/aio.7 +++ b/man7/aio.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2010 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH AIO 7 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH AIO 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME aio \- POSIX asynchronous I/O overview .SH DESCRIPTION @@ -469,7 +468,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.07 of the Linux +This page is part of release 5.08 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 0e2bc176c..b7917be46 100644 --- a/man7/armscii-8.7 +++ b/man7/armscii-8.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis <edimitro at tee.gr> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ARMSCII-8 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ARMSCII-8 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME armscii-8 \- Armenian character set encoded in octal, decimal, and hexadecimal @@ -136,9 +135,9 @@ _ .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/arp.7 b/man7/arp.7 index 64a8ead8b..a10980570 100644 --- a/man7/arp.7 +++ b/man7/arp.7 @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (C) 1999 Matthew Wilcox <willy@bofh.ai>. .\" %%%LICENSE_START(VERBATIM_ONE_PARA) .\" Permission is granted to distribute possibly modified copies @@ -10,7 +9,7 @@ .\" Modified June 1999 Andi Kleen .\" $Id: arp.7,v 1.10 2000/04/27 19:31:38 ak Exp $ .\" -.TH ARP 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH ARP 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME arp \- Linux ARP kernel module. .SH DESCRIPTION @@ -309,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ascii.7 b/man7/ascii.7 index 804e522ff..fcbfa54ed 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 1993 Michael Haardt (michael@moria.de) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -82,7 +81,7 @@ _ 033 27 1B ESC (escape) 133 91 5B [ 034 28 1C FS (file separator) 134 92 5C \e \(aq\e\e\(aq 035 29 1D GS (group separator) 135 93 5D ] -036 30 1E RS (record separator) 136 94 5E ^ +036 30 1E RS (record separator) 136 94 5E \(ha 037 31 1F US (unit separator) 137 95 5F \&_ 040 32 20 SPACE 140 96 60 \` 041 33 21 ! 141 97 61 a @@ -114,7 +113,7 @@ _ 073 59 3B ; 173 123 7B { 074 60 3C < 174 124 7C | 075 61 3D = 175 125 7D } -076 62 3E > 176 126 7E ~ +076 62 3E > 176 126 7E \(ti 077 63 3F ? 177 127 7F DEL .TE .if t \{\ @@ -135,9 +134,9 @@ For convenience, below are more compact tables in hex and decimal. 1: ! 1 A Q a q 1: ) 3 = G Q [ e o y 2: " 2 B R b r 2: * 4 > H R \e f p z 3: # 3 C S c s 3: ! + 5 ? I S ] g q { -4: $ 4 D T d t 4: " , 6 @ J T ^ h r | +4: $ 4 D T d t 4: " , 6 @ J T \(ha h r | 5: % 5 E U e u 5: # \- 7 A K U _ i s } -6: & 6 F V f v 6: $ . 8 B L V \` j t ~ +6: & 6 F V f v 6: $ . 8 B L V \` j t \(ti 7: \(aq 7 G W g w 7: % / 9 C M W a k u DEL 8: ( 8 H X h x 8: & 0 : D N X b l v 9: ) 9 I Y i y 9: \(aq 1 ; E O Y c m w @@ -145,7 +144,7 @@ A: * : J Z j z B: + ; K [ k { C: , < L \e l | D: \- = M ] m } -E: . > N ^ n ~ +E: . > N \(ha n \(ti F: / ? O _ o DEL .if t \{\ .in @@ -184,24 +183,24 @@ Standards Institute (USASI) in 1968. .\" .SH SEE ALSO .BR charsets (7), -.BR iso_8859-1 (7), -.BR iso_8859-2 (7), -.BR iso_8859-3 (7), -.BR iso_8859-4 (7), -.BR iso_8859-5 (7), -.BR iso_8859-6 (7), -.BR iso_8859-7 (7), -.BR iso_8859-8 (7), -.BR iso_8859-9 (7), -.BR iso_8859-10 (7), -.BR iso_8859-11 (7), -.BR iso_8859-13 (7), -.BR iso_8859-14 (7), -.BR iso_8859-15 (7), -.BR iso_8859-16 (7), -.BR utf-8 (7) +.BR iso_8859\-1 (7), +.BR iso_8859\-2 (7), +.BR iso_8859\-3 (7), +.BR iso_8859\-4 (7), +.BR iso_8859\-5 (7), +.BR iso_8859\-6 (7), +.BR iso_8859\-7 (7), +.BR iso_8859\-8 (7), +.BR iso_8859\-9 (7), +.BR iso_8859\-10 (7), +.BR iso_8859\-11 (7), +.BR iso_8859\-13 (7), +.BR iso_8859\-14 (7), +.BR iso_8859\-15 (7), +.BR iso_8859\-16 (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/attributes.7 b/man7/attributes.7 index ca8fa21ea..238ba0b79 100644 --- a/man7/attributes.7 +++ b/man7/attributes.7 @@ -507,13 +507,13 @@ synchronization. Unlike .IR race , which causes both readers and -writers of internal objects to be regarded as MT-Unsafe, \" and AS-Unsafe, +writers of internal objects to be regarded as MT-Unsafe,\" and AS-Unsafe, this mark is applied to writers only. -Writers remain \" equally -MT-Unsafe \" and AS-Unsafe +Writers remain\" equally +MT-Unsafe\" and AS-Unsafe to call, but the then-mandatory constness of objects they -modify enables readers to be regarded as MT-Safe \" and AS-Safe +modify enables readers to be regarded as MT-Safe\" and AS-Safe (as long as no other reasons for them to be unsafe remain), since the lack of synchronization is not a problem when the objects are effectively constant. @@ -646,7 +646,7 @@ called concurrently with locale changes may behave in ways that do not correspond to any of the locales active during their execution, but an unpredictable mix thereof. .IP -We do not mark these functions as MT-Unsafe, \" or AS-Unsafe, +We do not mark these functions as MT-Unsafe,\" or AS-Unsafe, however, because functions that modify the locale object are marked with .I const:locale @@ -678,7 +678,7 @@ environment with or similar, without any guards to ensure safety in the presence of concurrent modifications. .IP -We do not mark these functions as MT-Unsafe, \" or AS-Unsafe, +We do not mark these functions as MT-Unsafe,\" or AS-Unsafe, however, because functions that modify the environment are all marked with .I const:env @@ -717,7 +717,7 @@ GNU C Library internal data structure without any guards to ensure safety in the presence of concurrent modifications. .IP -We do not mark these functions as MT-Unsafe, \" or AS-Unsafe, +We do not mark these functions as MT-Unsafe,\" or AS-Unsafe, however, because functions that modify this data structure are all marked with .I const:sigintr @@ -882,7 +882,7 @@ then the function can be regarded as safe. .SH SEE ALSO .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/boot.7 b/man7/boot.7 index 6d35c5c35..132b2be8c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/bootparam.7 b/man7/bootparam.7 index 72f4262c3..070ce4fea 100644 --- a/man7/bootparam.7 +++ b/man7/bootparam.7 @@ -138,7 +138,7 @@ A symbolic specification has the form .IR /dev/XXYN , where XX designates the device type (e.g., 'hd' for ST-506 compatible hard disk, with Y in -\&'a'-'d'; 'sd' for SCSI compatible disk, with Y in 'a'-'e'), +\&'a'\(en'd'; 'sd' for SCSI compatible disk, with Y in 'a'\(en'e'), Y the driver letter or number, and N the number (in decimal) of the partition on this device. .IP @@ -485,7 +485,7 @@ for older kernels) in the Linux kernel source. .B "IDE Disk/CD-ROM Driver Parameters" The IDE driver accepts a number of parameters, which range from disk geometry specifications, to support for broken controller chips. -Drive-specific options are specified by using 'hdX=' with X in 'a'-'h'. +Drive-specific options are specified by using 'hdX=' with X in 'a'\(en'h'. .IP Non-drive-specific options are specified with the prefix 'hd='. Note that using a drive-specific prefix for a non-drive-specific option @@ -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.07 of the Linux +This page is part of release 5.08 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 85c26feda..a274812c1 100644 --- a/man7/bpf-helpers.7 +++ b/man7/bpf-helpers.7 @@ -32,17 +32,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .. .\" Copyright (C) All BPF authors and contributors from 2014 to present. .\" See git log include/uapi/linux/bpf.h in kernel tree for details. -.\" +.\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. -.\" +.\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. -.\" +.\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from @@ -50,11 +50,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. -.\" +.\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END -.\" +.\" .\" Please do not edit this file. It was generated from the documentation .\" located in file include/uapi/linux/bpf.h of the Linux kernel sources .\" (helpers description), and from scripts/bpf_helpers_doc.py in the same @@ -1674,7 +1674,7 @@ callback: .INDENT 7.0 .TP .B \fBbpf_sock_ops_cb_flags_set(bpf_sock,\fP -\fBbpf_sock\->bpf_sock_ops_cb_flags & ~BPF_SOCK_OPS_RTO_CB_FLAG)\fP +\fBbpf_sock\->bpf_sock_ops_cb_flags & \(tiBPF_SOCK_OPS_RTO_CB_FLAG)\fP .UNINDENT .sp Here are some examples of where one could call such eBPF @@ -3523,7 +3523,7 @@ pointers for network processing are listed in function .\" Generated by docutils manpage writer. . .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/capabilities.7 b/man7/capabilities.7 index 4a8e8a5ac..0feba1622 100644 --- a/man7/capabilities.7 +++ b/man7/capabilities.7 @@ -45,7 +45,7 @@ .\" other capabilities where the permitted or inheritable bit is set. .\" 2011-09-07, mtk/Serge hallyn: Add CAP_SYSLOG .\" -.TH CAPABILITIES 7 2019-08-02 "Linux" "Linux Programmer's Manual" +.TH CAPABILITIES 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME capabilities \- overview of Linux capabilities .SH DESCRIPTION @@ -90,6 +90,17 @@ Employ features that can block system suspend .BR EPOLLWAKEUP , .IR /proc/sys/wake_lock ). .TP +.BR CAP_BPF " (since Linux 5.8)" +Employ privileged BPF operations; see +.BR bpf (2) +and +.BR bpf\-helpers (7). +.IP +This capability was added in Linux 5.8 to separate out +BPF functionality from the overloaded +.BR CAP_SYS_ADMIN +capability. +.TP .B CAP_CHOWN Make arbitrary changes to file UIDs and GIDs (see .BR chown (2)). @@ -265,6 +276,23 @@ bind to any address for transparent proxying. .PD .\" Also various IP options and setsockopt(SO_BINDTODEVICE) .TP +.BR CAP_PERFMON " (since Linux 5.8)" +Employ various performance-monitoring mechanisms, including: +.PD 0 +.RS +.IP *2 +call +.BR perf_event_open (2); +.IP * +employ various BPF operations that have performance implications. +.RE +.PD +.IP +This capability was added in Linux 5.8 to separate out +performance monitoring functionality from the overloaded +.BR CAP_SYS_ADMIN +capability. +.TP .B CAP_SETGID .RS .PD 0 @@ -399,8 +427,8 @@ and (but, since Linux 3.8, creating user namespaces does not require any capability); .IP * -call -.BR perf_event_open (2); +employ various performance monitoring mechanisms (as for +.BR CAP_PERFMON ); .IP * access privileged .I perf @@ -417,8 +445,9 @@ namespace); call .BR fanotify_init (2); .IP * -call -.BR bpf (2); +perform various BPF operations; +see +.BR CAP_BPF ; .IP * perform privileged .B KEYCTL_CHOWN @@ -527,7 +556,7 @@ drop capabilities from the system-wide capability bounding set. .PD 0 .RS .IP * 2 -Raise process nice value +Lower the process nice value .RB ( nice (2), .BR setpriority (2)) and change the nice value for arbitrary processes; @@ -693,8 +722,11 @@ to increase the capacity of a pipe above the limit specified by .IR /proc/sys/fs/pipe-max-size ; .IP * override -.I /proc/sys/fs/mqueue/queues_max -limit when creating POSIX message queues (see +.I /proc/sys/fs/mqueue/queues_max, +.I /proc/sys/fs/mqueue/msg_max, +and +.I /proc/sys/fs/mqueue/msgsize_max +limits when creating POSIX message queues (see .BR mq_overview (7)); .IP * employ the @@ -865,7 +897,6 @@ Since Linux 2.6.25, this is a per-thread capability set. In older kernels, the capability bounding set was a system wide attribute shared by all threads on the system. .IP -.IP For more details on the capability bounding set, see below. .TP .IR Ambient " (since Linux 4.3)" @@ -1097,7 +1128,6 @@ according to the circumstances in which the extended attribute is created or modified. .\" .SS Transformation of capabilities during execve() -.PP During an .BR execve (2), the kernel calculates the new capabilities of @@ -1671,7 +1701,6 @@ For further information on the interaction of capabilities and user namespaces, see .BR user_namespaces (7). .SH CONFORMING TO -.PP No standards govern capabilities, but the Linux capability implementation is based on the withdrawn POSIX.1e draft standard; see .UR https://archive.org\:/details\:/posix_1003.1e-990310 @@ -1777,6 +1806,7 @@ created on the system. .BR captest (8), \" from libcap-ng .BR filecap (8), \" from libcap-ng .BR getcap (8), +.BR getpcaps (8), .BR netcap (8), \" from libcap-ng .BR pscap (8), \" from libcap-ng .BR setcap (8) @@ -1784,7 +1814,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.07 of the Linux +This page is part of release 5.08 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 b65a0b4ad..212b43733 100644 --- a/man7/cgroup_namespaces.7 +++ b/man7/cgroup_namespaces.7 @@ -102,11 +102,11 @@ Next, we use .BR unshare (1) to create a process running a new shell in new cgroup and mount namespaces: .PP -.EX .in +4n +.EX # \fBPS1="sh2# " unshare \-Cm bash\fP -.in .EE +.in .PP From the new shell started by .BR unshare (1), @@ -118,16 +118,16 @@ a process that is in the initial cgroup namespace with PID 1), and the process in the sibling cgroup .RI ( sub2 ): .PP -.EX .in +4n +.EX sh2# \fBcat /proc/self/cgroup | grep freezer\fP 7:freezer:/ sh2# \fBcat /proc/1/cgroup | grep freezer\fP 7:freezer:/.. sh2# \fBcat /proc/20124/cgroup | grep freezer\fP 7:freezer:/../sub2 -.in .EE +.in .PP From the output of the first command, we see that the freezer cgroup membership of the new shell @@ -147,12 +147,12 @@ However, when we look in .IR /proc/self/mountinfo we see the following anomaly: .PP -.EX .in +4n +.EX sh2# \fBcat /proc/self/mountinfo | grep freezer\fP 155 145 0:32 /.. /sys/fs/cgroup/freezer ... -.in .EE +.in .PP The fourth field of this line .RI ( /.. ) @@ -169,16 +169,16 @@ To fix this problem, we must remount the freezer cgroup filesystem from the new shell (i.e., perform the mount from a process that is in the new cgroup namespace), after which we see the expected results: .PP -.EX .in +4n +.EX sh2# \fBmount \-\-make\-rslave /\fP # Don't propagate mount events # to other namespaces sh2# \fBumount /sys/fs/cgroup/freezer\fP sh2# \fBmount \-t cgroup \-o freezer freezer /sys/fs/cgroup/freezer\fP sh2# \fBcat /proc/self/mountinfo | grep freezer\fP 155 145 0:32 / /sys/fs/cgroup/freezer rw,relatime ... -.in .EE +.in .\" .SH CONFORMING TO Namespaces are a Linux-specific feature. @@ -235,7 +235,7 @@ In the absence of cgroup namespacing, because the cgroup directory .IR /cg/1 is owned (and writable) by UID 9000 and process .I X -is also owned by user ID 9000, then process +is also owned by user ID 9000, process .I X would be able to modify the contents of cgroups files (i.e., change cgroup settings) not only in @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cgroups.7 b/man7/cgroups.7 index 25653cd85..70c8b80d4 100644 --- a/man7/cgroups.7 +++ b/man7/cgroups.7 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CGROUPS 7 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH CGROUPS 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME cgroups \- Linux control groups .SH DESCRIPTION @@ -74,9 +74,12 @@ to allow the management of various types of resources. However, the development of these controllers was largely uncoordinated, with the result that many inconsistencies arose between controllers and management of the cgroup hierarchies became rather complex. -(A longer description of these problems can be found in -the kernel source file -.IR Documentation/cgroup\-v2.txt .) +A longer description of these problems can be found in the kernel +source file +.IR Documentation/admin\-guide/cgroup\-v2.rst +(or +.IR Documentation/cgroup\-v2.txt +in Linux 4.17 and earlier). .PP Because of the problems with the initial cgroups implementation (cgroups version 1), @@ -264,7 +267,10 @@ Cgroups can be guaranteed a minimum number of "CPU shares" when a system is busy. This does not limit a cgroup's CPU usage if the CPUs are not busy. For further information, see -.IR Documentation/scheduler/sched-design-CFS.txt . +.IR Documentation/scheduler/sched\-design\-CFS.rst +(or +.IR Documentation/scheduler/sched\-design\-CFS.txt +in Linux 5.2 and earlier). .IP In Linux 3.2, this controller was extended to provide CPU "bandwidth" control. @@ -275,27 +281,40 @@ then within each scheduling period an upper limit on the CPU time allocated to the processes in a cgroup. This upper limit applies even if there is no other competition for the CPU. Further information can be found in the kernel source file -.IR Documentation/scheduler/sched\-bwc.txt . +.IR Documentation/scheduler/sched\-bwc.rst +(or +.IR Documentation/scheduler/sched\-bwc.txt +in Linux 5.2 and earlier). .TP .IR cpuacct " (since Linux 2.6.24; " \fBCONFIG_CGROUP_CPUACCT\fP ) This provides accounting for CPU usage by groups of processes. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup\-v1/cpuacct.txt . +.IR Documentation/admin\-guide/cgroup\-v1/cpuacct.rst +(or +.IR Documentation/cgroup\-v1/cpuacct.txt +in Linux 5.2 and earlier). .TP .IR cpuset " (since Linux 2.6.24; " \fBCONFIG_CPUSETS\fP ) This cgroup can be used to bind the processes in a cgroup to a specified set of CPUs and NUMA nodes. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup\-v1/cpusets.txt . +.IR Documentation/admin\-guide/cgroup\-v1/cpusets.rst +(or +.IR Documentation/cgroup\-v1/cpusets.txt +in Linux 5.2 and earlier). +. .TP .IR memory " (since Linux 2.6.25; " \fBCONFIG_MEMCG\fP ) The memory controller supports reporting and limiting of process memory, kernel memory, and swap used by cgroups. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup\-v1/memory.txt . +.IR Documentation/admin\-guide/cgroup\-v1/memory.rst +(or +.IR Documentation/cgroup\-v1/memory.txt +in Linux 5.2 and earlier). .TP .IR devices " (since Linux 2.6.26; " \fBCONFIG_CGROUP_DEVICE\fP ) This supports controlling which processes may create (mknod) devices as @@ -305,7 +324,10 @@ Hierarchy is enforced, so new rules must not violate existing rules for the target or ancestor cgroups. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/devices.txt . +.IR Documentation/admin\-guide/cgroup\-v1/devices.rst +(or +.IR Documentation/cgroup\-v1/devices.txt +in Linux 5.2 and earlier). .TP .IR freezer " (since Linux 2.6.28; " \fBCONFIG_CGROUP_FREEZER\fP ) The @@ -318,7 +340,10 @@ also causes its children, for example, processes in to be frozen. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/freezer-subsystem.txt . +.IR Documentation/admin\-guide/cgroup\-v1/freezer\-subsystem.rst +(or +.IR Documentation/cgroup\-v1/freezer\-subsystem.txt +in Linux 5.2 and earlier). .TP .IR net_cls " (since Linux 2.6.29; " \fBCONFIG_CGROUP_NET_CLASSID\fP ) This places a classid, specified for the cgroup, on network packets @@ -330,7 +355,10 @@ This applies only to packets leaving the cgroup, not to traffic arriving at the cgroup. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/net_cls.txt . +.IR Documentation/admin\-guide/cgroup\-v1/net_cls.rst +(or +.IR Documentation/cgroup\-v1/net_cls.txt +in Linux 5.2 and earlier). .TP .IR blkio " (since Linux 2.6.33; " \fBCONFIG_BLK_CGROUP\fP ) The @@ -347,41 +375,55 @@ The second is a throttling policy which specifies upper I/O rate limits on a device. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/blkio-controller.txt . +.IR Documentation/admin\-guide/cgroup\-v1/blkio\-controller.rst +(or +.IR Documentation/cgroup\-v1/blkio\-controller.txt +in Linux 5.2 and earlier). .TP .IR perf_event " (since Linux 2.6.39; " \fBCONFIG_CGROUP_PERF\fP ) This controller allows .I perf monitoring of the set of processes grouped in a cgroup. .IP -Further information can be found in the kernel source file -.IR tools/perf/Documentation/perf-record.txt . +Further information can be found in the kernel source files .TP .IR net_prio " (since Linux 3.3; " \fBCONFIG_CGROUP_NET_PRIO\fP ) This allows priorities to be specified, per network interface, for cgroups. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/net_prio.txt . +.IR Documentation/admin\-guide/cgroup\-v1/net_prio.rst +(or +.IR Documentation/cgroup\-v1/net_prio.txt +in Linux 5.2 and earlier). .TP .IR hugetlb " (since Linux 3.5; " \fBCONFIG_CGROUP_HUGETLB\fP ) This supports limiting the use of huge pages by cgroups. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/hugetlb.txt . +.IR Documentation/admin\-guide/cgroup\-v1/hugetlb.rst +(or +.IR Documentation/cgroup\-v1/hugetlb.txt +in Linux 5.2 and earlier). .TP .IR pids " (since Linux 4.3; " \fBCONFIG_CGROUP_PIDS\fP ) This controller permits limiting the number of process that may be created in a cgroup (and its descendants). .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/pids.txt . +.IR Documentation/admin\-guide/cgroup\-v1/pids.rst +(or +.IR Documentation/cgroup\-v1/pids.txt +in Linux 5.2 and earlier). .TP .IR rdma " (since Linux 4.11; " \fBCONFIG_CGROUP_RDMA\fP ) The RDMA controller permits limiting the use of RDMA/IB-specific resources per cgroup. .IP Further information can be found in the kernel source file -.IR Documentation/cgroup-v1/rdma.txt . +.IR Documentation/admin\-guide/cgroup\-v1/rdma.rst +(or +.IR Documentation/cgroup\-v1/rdma.txt +in Linux 5.2 and earlier). .\" .SS Creating cgroups and moving processes A cgroup filesystem initially contains a single root cgroup, '/', @@ -480,7 +522,7 @@ cgroup filesystem is mounted: .PP .in +4n .EX -mount -o release_agent=pathname ... +mount \-o release_agent=pathname ... .EE .in .PP @@ -507,7 +549,7 @@ it is possible to mount a cgroup hierarchy that has no attached controllers: .PP .in +4n .EX -mount -t cgroup -o none,name=somename none /some/mount/point +mount \-t cgroup \-o none,name=somename none /some/mount/point .EE .in .PP @@ -566,8 +608,12 @@ An improved mechanism for notification of empty cgroups is provided by the file. .PP For more changes, see the -.I Documentation/cgroup-v2.txt -file in the kernel source. +.IR Documentation/admin\-guide/cgroup\-v2.rst +file in the kernel source +(or +.IR Documentation/cgroup\-v2.txt +in Linux 4.17 and earlier). +. .PP Some of the new behaviors listed above saw subsequent modification with the addition in Linux 4.14 of "thread mode" (described below). @@ -587,7 +633,7 @@ when mounting the cgroup v2 filesystem using a command such as the following: .PP .in +4n .EX -mount -t cgroup2 none /mnt/cgroup2 +mount \-t cgroup2 none /mnt/cgroup2 .EE .in .PP @@ -624,7 +670,7 @@ during the boot process. .\" .SS Cgroups v2 mount options The following options -.RI ( "mount -o" ) +.RI ( "mount \-o" ) can be specified when mounting the group v2 filesystem: .TP .IR nsdelegate " (since Linux 4.15)" @@ -648,7 +694,10 @@ it is silently ignored in noninitial namespaces. .\" .SS Cgroups v2 controllers The following controllers, documented in the kernel source file -.IR Documentation/cgroup-v2.txt , +.IR Documentation/admin\-guide/cgroup\-v2.rst +(or +.IR Documentation/cgroup\-v2.txt +in Linux 4.17 and earlier), are supported in cgroups version 2: .TP .IR cpu " (since Linux 4.15)" @@ -742,7 +791,7 @@ or '\-' (to disable a controller), as in the following example: .IP .in +4n .EX -echo '+pids -memory' > x/y/cgroup.subtree_control +echo '+pids \-memory' > x/y/cgroup.subtree_control .EE .in .IP @@ -1071,7 +1120,7 @@ option as follows: .PP .in +4n .EX -mount -t cgroup2 -o remount,nsdelegate \e +mount \-t cgroup2 \-o remount,nsdelegate \e none /sys/fs/cgroup/unified .EE .in @@ -1823,14 +1872,14 @@ and this file provides a way for the kernel to inform user-space applications of which files must be delegated. As at Linux 4.15, one sees the following when inspecting this file: .IP -.EX .in +4n +.EX $ \fBcat /sys/kernel/cgroup/delegate\fP cgroup.procs cgroup.subtree_control cgroup.threads -.in .EE +.in .TP .IR /sys/kernel/cgroup/features " (since Linux 4.15)" .\" commit 5f2e673405b742be64e7c3604ed4ed3ac14f35ce @@ -1865,8 +1914,8 @@ mount option. .SH SEE ALSO .BR prlimit (1), .BR systemd (1), -.BR systemd-cgls (1), -.BR systemd-cgtop (1), +.BR systemd\-cgls (1), +.BR systemd\-cgtop (1), .BR clone (2), .BR ioprio_set (2), .BR perf_event_open (2), @@ -1878,9 +1927,9 @@ mount option. .BR user_namespaces (7) .PP The kernel source file -.IR Documentation/admin-guide/cgroup-v2.rst . +.IR Documentation/admin\-guide/cgroup\-v2.rst . .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/charsets.7 b/man7/charsets.7 index 980dad98f..81323c3c5 100644 --- a/man7/charsets.7 +++ b/man7/charsets.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright (c) 1996 Eric S. Raymond <esr@thyrsus.com> .\" and Copyright (c) Andries Brouwer <aeb@cwi.nl> .\" @@ -14,7 +13,7 @@ .\" .\" Changes also by David Starner <dstarner98@aasaa.ofe.org>. .\" -.TH CHARSETS 7 2019-03-06 "Linux" "Linux Programmer's Manual" +.TH CHARSETS 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME charsets \- character set standards and internationalization .SH DESCRIPTION @@ -216,8 +215,8 @@ It uses codes either G0 always has size 94 and uses codes 041\(en0176. .PP Switching between character sets is done using the shift functions -\fB^N\fP (SO or LS1), \fB^O\fP (SI or LS0), ESC n (LS2), ESC o (LS3), -ESC N (SS2), ESC O (SS3), ESC ~ (LS1R), ESC } (LS2R), ESC | (LS3R). +\fB\(haN\fP (SO or LS1), \fB\(haO\fP (SI or LS0), ESC n (LS2), ESC o (LS3), +ESC N (SS2), ESC O (SS3), ESC \(ti (LS1R), ESC } (LS2R), ESC | (LS3R). The function LS\fIn\fP makes character set G\fIn\fP the current one for codes with high bit zero. The function LS\fIn\fPR makes character set G\fIn\fP the current one @@ -253,7 +252,7 @@ recent version selected by ESC & @ ESC $ B. ISO 4873 stipulates a narrower use of character sets, where G0 is fixed (always ASCII), so that G1, G2 and G3 can be invoked only for codes with the high order bit set. -In particular, \fB^N\fP and \fB^O\fP are not used anymore, ESC ( xx +In particular, \fB\(haN\fP and \fB\(haO\fP are not used anymore, ESC ( xx can be used only with xx=B, and ESC ) xx, ESC * xx, ESC + xx are equivalent to ESC \- xx, ESC . xx, ESC / xx, respectively. .SS TIS-620 @@ -330,11 +329,11 @@ Korean, but it is enough for most other purposes. .SH SEE ALSO .BR iconv (1), .BR ascii (7), -.BR iso_8859-1 (7), +.BR iso_8859\-1 (7), .BR unicode (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/complex.7 b/man7/complex.7 index 02a09427c..2e1bea52e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1251.7 b/man7/cp1251.7 index 6af5b82d5..324dd0293 100644 --- a/man7/cp1251.7 +++ b/man7/cp1251.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH CP1251 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH CP1251 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME cp1251 \- CP\ 1251 character set encoded in octal, decimal, and hexadecimal @@ -179,12 +178,12 @@ CP\ 1251 is also known as Windows Cyrillic. .BR ascii (7), .BR charsets (7), .BR cp1252 (7), -.BR iso_8859-5 (7), -.BR koi8-r (7), -.BR koi8-u (7), -.BR utf-8 (7) +.BR iso_8859\-5 (7), +.BR koi8\-r (7), +.BR koi8\-u (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cp1252.7 b/man7/cp1252.7 index b494502e6..2ea3a03eb 100644 --- a/man7/cp1252.7 +++ b/man7/cp1252.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2014 (C) Marko Myllynen <myllynen@redhat.com> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH CP1252 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH CP1252 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME cp1252 \- CP\ 1252 character set encoded in octal, decimal, and hexadecimal @@ -170,11 +169,11 @@ CP\ 1252 is also known as Windows-1252. .BR ascii (7), .BR charsets (7), .BR cp1251 (7), -.BR iso_8859-1 (7), -.BR iso_8859-15 (7), -.BR utf-8 (7) +.BR iso_8859\-1 (7), +.BR iso_8859\-15 (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/cpuset.7 b/man7/cpuset.7 index 0705bf755..c289e5a22 100644 --- a/man7/cpuset.7 +++ b/man7/cpuset.7 @@ -1503,14 +1503,16 @@ syntax that works on any shell, but alas more obscurely, by using the .BR migratepages (8), .BR numactl (8) .PP -.IR Documentation/cgroup\-v1/cpusets.txt +.IR Documentation/admin\-guide/cgroup\-v1/cpusets.rst in the Linux kernel source tree .\" commit 45ce80fb6b6f9594d1396d44dd7e7c02d596fef8 (or +.IR Documentation/cgroup\-v1/cpusets.txt +before Linux 4.18, and .IR Documentation/cpusets.txt before Linux 2.6.29) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/credentials.7 b/man7/credentials.7 index 0e888d1fb..8419569a9 100644 --- a/man7/credentials.7 +++ b/man7/credentials.7 @@ -397,7 +397,7 @@ for further details. .BR user_namespaces (7), .BR sudo (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ddp.7 b/man7/ddp.7 index 9c7b09a41..610d9681a 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/environ.7 b/man7/environ.7 index 06ddbeff7..bab859dd1 100644 --- a/man7/environ.7 +++ b/man7/environ.7 @@ -31,7 +31,7 @@ .\" Modified Wed Jan 24 06:37:24 2001 by Eric S. Raymond (esr@thyrsus.com) .\" Modified Thu Dec 13 23:53:27 2001 by Martin Schulze <joey@infodrom.org> .\" -.TH ENVIRON 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH ENVIRON 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME environ \- user environment .SH SYNOPSIS @@ -126,7 +126,7 @@ The user's preferred utility to edit text files. .\" .TP .\" .B BROWSER .\" The user's preferred utility to browse URLs. Sequence of colon-separated -.\" browser commands. See http://www.catb.org/~esr/BROWSER/ . +.\" browser commands. See http://www.catb.org/\(tiesr/BROWSER/ . .PP Names may be placed in the shell's environment by the .I export @@ -175,8 +175,8 @@ influenced by the presence or value of certain environment variables. Examples include the following: .IP * 3 The variables -.BR LANG ", " LANGUAGE ", " NLSPATH ", " LOCPATH ", " -.BR LC_ALL ", " LC_MESSAGES ", " +.BR LANG ", " LANGUAGE ", " NLSPATH ", " LOCPATH , +.BR LC_ALL ", " LC_MESSAGES , and so on influence locale handling; see .BR catopen (3), .BR gettext (3), @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/epoll.7 b/man7/epoll.7 index dd2b3a8d6..abfa72a2c 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fanotify.7 b/man7/fanotify.7 index dbdaee6bf..9bc09978a 100644 --- a/man7/fanotify.7 +++ b/man7/fanotify.7 @@ -1134,7 +1134,7 @@ main(int argc, char **argv) .BR fanotify_mark (2), .BR inotify (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 bb160d72b..2e462b3cf 100644 --- a/man7/feature_test_macros.7 +++ b/man7/feature_test_macros.7 @@ -220,9 +220,9 @@ ISO Standard C. This macro is implicitly defined by .BR gcc (1) when invoked with, for example, the -.I -std=c99 +.I \-std=c99 or -.I -ansi +.I \-ansi flag. .TP .B _POSIX_C_SOURCE @@ -911,7 +911,7 @@ The section "Feature Test Macros" under .PP .I /usr/include/features.h .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/fifo.7 b/man7/fifo.7 index 824bd883f..e9f605b51 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/futex.7 b/man7/futex.7 index 5eb9cf09d..2481be233 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/glob.7 b/man7/glob.7 index c5e392d00..eac3ae21f 100644 --- a/man7/glob.7 +++ b/man7/glob.7 @@ -23,7 +23,7 @@ .\" .\" 2003-08-24 fix for / by John Kristoff + joey .\" -.TH GLOB 7 2016-10-08 "Linux" "Linux Programmer's Manual" +.TH GLOB 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME glob \- globbing pathnames .SH DESCRIPTION @@ -127,13 +127,13 @@ one can force the classical behavior using this command: For example, where old scripts have .PP .nf - rm \`find . \-name "*~"\` + rm \`find . \-name "*\(ti"\` .fi .PP new scripts require .PP .nf - rm \-f nosuchfile \`find . \-name "*~"\` + rm \-f nosuchfile \`find . \-name "*\(ti"\` .fi .PP to avoid error messages from @@ -149,8 +149,8 @@ are not the same: for example, in a regular expression \(aq*\(aq means zero or more copies of the preceding thing. .PP Now that regular expressions have bracket expressions where -the negation is indicated by a \(aq^\(aq, POSIX has declared the -effect of a wildcard pattern "\fI[^...]\fP" to be undefined. +the negation is indicated by a \(aq\(ha\(aq, POSIX has declared the +effect of a wildcard pattern "\fI[\(ha...]\fP" to be undefined. .SS Character classes and internationalization Of course ranges were originally meant to be ASCII ranges, so that "\fI[\ \-%]\fP" stands for "\fI[\ !"#$%]\fP" and "\fI[a\-z]\fP" stands @@ -203,7 +203,7 @@ where the string between "\fI[=\fP" and "\fI=]\fP" is any collating element from its equivalence class, as defined for the current locale. For example, "\fI[[=a=]]\fP" might be equivalent -to "\fI[a\('a\(`a\(:a\(^a]\fP", that is, +to "\fI[a\('a\(\`a\(:a\(^a]\fP", that is, to "\fI[a[.a-acute.][.a-grave.][.a-umlaut.][.a-circumflex.]]\fP". .SH SEE ALSO .BR sh (1), @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hier.7 b/man7/hier.7 index c687ff488..3b3bfd6be 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/hostname.7 b/man7/hostname.7 index 59b6e1543..4f5f97717 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/icmp.7 b/man7/icmp.7 index b49d9638e..866f9c7f4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inode.7 b/man7/inode.7 index d91687def..97000f982 100644 --- a/man7/inode.7 +++ b/man7/inode.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2017 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INODE 7 2019-05-09 "Linux" "Linux Programmer's Manual" +.TH INODE 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME inode \- file inode information .SH DESCRIPTION @@ -480,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/inotify.7 b/man7/inotify.7 index 57e0acc38..6ab8b1c27 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006, 2014 Michael Kerrisk <mtk.manpages@gmail.com> .\" Copyright (C) 2014 Heinrich Schuchardt <xypron.glpk@gmx.de> .\" @@ -1122,7 +1121,7 @@ main(int argc, char* argv[]) .IR Documentation/filesystems/inotify.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/intro.7 b/man7/intro.7 index ef420594b..4b6e169e1 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>. .\" .\" %%%LICENSE_START(VERBATIM_ONE_PARA) @@ -817,7 +816,7 @@ address is .B AF_UNSPEC when the source was unknown. When the error originated from the network, all IP options -.RB ( IP_OPTIONS ", " IP_TTL ", " +.RB ( IP_OPTIONS ", " IP_TTL , etc.) enabled on the socket and contained in the error packet are passed as control messages. The payload of the packet causing the error is returned as normal payload. @@ -1134,14 +1133,6 @@ All ioctls described in .BR socket (7) apply to .BR ip . -.\" 2006-04-02, mtk -.\" commented out the following because ipchains is obsolete -.\" .PP -.\" The ioctls to configure firewalling are documented in -.\" .BR ipfw (4) -.\" from the -.\" .B ipchains -.\" package. .PP Ioctls to configure generic device parameters are described in .BR netdevice (7). @@ -1338,7 +1329,6 @@ does not work in some 2.2 kernels. .BR recvmsg (2), .BR sendmsg (2), .BR byteorder (3), -.BR ipfw (4), .BR capabilities (7), .BR icmp (7), .BR ipv6 (7), @@ -1357,7 +1347,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.07 of the Linux +This page is part of release 5.08 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 b2a249597..4bd3240a3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/ipv6.7 b/man7/ipv6.7 index cdd673f36..a2f66b3ea 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -422,7 +422,7 @@ RFC\ 2553: IPv6 BASIC API; Linux tries to be compliant to this. RFC\ 2460: IPv6 specification. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 2e2eed146..39b7edcae 100644 --- a/man7/iso_8859-1.7 +++ b/man7/iso_8859-1.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 1993-1995 Daniel Quinlan (quinlan@yggdrasil.com) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -24,7 +23,7 @@ .\" .\" Slightly rearranged, aeb, 950713 .\" Updated, dpo, 990531 -.TH ISO_8859-1 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-1 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-1 \- ISO 8859-1 character set encoded in octal, decimal, and hexadecimal @@ -165,10 +164,10 @@ ISO 8859-1 is also known as Latin-1. .BR ascii (7), .BR charsets (7), .BR cp1252 (7), -.BR iso_8859-15 (7), -.BR utf-8 (7) +.BR iso_8859\-15 (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 427870cc2..9f94dbedb 100644 --- a/man7/iso_8859-10.7 +++ b/man7/iso_8859-10.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-10 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-10 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-10 \- ISO 8859-10 character set encoded in octal, decimal, and hexadecimal @@ -162,9 +161,9 @@ ISO 8859-10 is also known as Latin-6. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 e6db8c9f5..a719ba804 100644 --- a/man7/iso_8859-11.7 +++ b/man7/iso_8859-11.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis <edimitro at tee.gr> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -24,7 +23,7 @@ .\" .\"Thanomsub Noppaburana <donga.nb@gmail.com> made valuable suggestions. .\" -.TH ISO_8859-11 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-11 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-11 \- ISO 8859-11 character set encoded in octal, decimal, and hexadecimal @@ -159,9 +158,9 @@ while TIS-620 leaves it undefined. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 3167447e9..2f8147f5f 100644 --- a/man7/iso_8859-13.7 +++ b/man7/iso_8859-13.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-13 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-13 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-13 \- ISO 8859-13 character set encoded in octal, decimal, and hexadecimal @@ -162,9 +161,9 @@ ISO 8859-13 is also known as Latin-7. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 681255f0f..45e0ed579 100644 --- a/man7/iso_8859-14.7 +++ b/man7/iso_8859-14.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-14 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-14 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-14 \- ISO 8859-14 character set encoded in octal, decimal, and hexadecimal @@ -162,9 +161,9 @@ ISO 8859-14 is also known as Latin-8. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 986c9655d..385f79101 100644 --- a/man7/iso_8859-15.7 +++ b/man7/iso_8859-15.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 1993-1995 Daniel Quinlan (quinlan@yggdrasil.com) .\" Copyright 1999 Dimitri Papadopoulos (dpo@club-internet.fr) .\" @@ -23,7 +22,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-15 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-15 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-15 \- ISO 8859-15 character set encoded in octal, decimal, and hexadecimal @@ -164,10 +163,10 @@ ISO 8859-15 is also known as Latin-9 (or sometimes as Latin-0). .BR ascii (7), .BR charsets (7), .BR cp1252 (7), -.BR iso_8859-1 (7), -.BR utf-8 (7) +.BR iso_8859\-1 (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 1be8c6236..b0fff68c3 100644 --- a/man7/iso_8859-16.7 +++ b/man7/iso_8859-16.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2002 Ionel Mugurel Ciobîcă (IMCiobica@netscape.net) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-16 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-16 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-16 \- ISO 8859-16 character set encoded in octal, decimal, and hexadecimal @@ -162,10 +161,10 @@ ISO 8859-16 is also known as Latin-10. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR iso_8859-3 (7), -.BR utf-8 (7) +.BR iso_8859\-3 (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 3a0c54c60..44b91ff16 100644 --- a/man7/iso_8859-2.7 +++ b/man7/iso_8859-2.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 1999 Roman Maurer (roman.maurer@hermes.si) .\" Copyright 1993-1995 Daniel Quinlan (quinlan@yggdrasil.com) .\" @@ -25,7 +24,7 @@ .\" .\" Slightly rearranged, aeb, 950713 .\" Updated, dpo, 990531 -.TH ISO_8859-2 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-2 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-2 \- ISO 8859-2 character set encoded in octal, decimal, and hexadecimal @@ -165,11 +164,11 @@ ISO 8859-2 is also known as Latin-2. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR iso_8859-1 (7), -.BR iso_8859-16 (7), -.BR utf-8 (7) +.BR iso_8859\-1 (7), +.BR iso_8859\-16 (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 42ad8f7d6..e407d392f 100644 --- a/man7/iso_8859-3.7 +++ b/man7/iso_8859-3.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-3 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-3 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-3 \- ISO 8859-3 character set encoded in octal, decimal, and hexadecimal @@ -155,9 +154,9 @@ ISO 8859-3 is also known as Latin-3. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 531cf4333..0ef886c89 100644 --- a/man7/iso_8859-4.7 +++ b/man7/iso_8859-4.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-4 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-4 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-4 \- ISO 8859-4 character set encoded in octal, decimal, and hexadecimal @@ -162,9 +161,9 @@ ISO 8859-4 is also known as Latin-4. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 f72de9b05..ffa1e4a8d 100644 --- a/man7/iso_8859-5.7 +++ b/man7/iso_8859-5.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-5 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-5 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-5 \- ISO 8859-5 character set encoded in octal, decimal, and hexadecimal @@ -165,11 +164,11 @@ T} .BR ascii (7), .BR charsets (7), .BR cp1251 (7), -.BR koi8-r (7), -.BR koi8-u (7), -.BR utf-8 (7) +.BR koi8\-r (7), +.BR koi8\-u (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 fc7c72b52..ad55e0d4e 100644 --- a/man7/iso_8859-6.7 +++ b/man7/iso_8859-6.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-6 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-6 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-6 \- ISO 8859-6 character set encoded in octal, decimal, and hexadecimal @@ -118,9 +117,9 @@ such as Urdu and Persian (Farsi). .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 9bce9408f..174d236dd 100644 --- a/man7/iso_8859-7.7 +++ b/man7/iso_8859-7.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 1999 Dimitri Papadopoulos (dpo@club-internet.fr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-7 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-7 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-7 \- ISO 8859-7 character set encoded in octal, decimal, and hexadecimal @@ -166,9 +165,9 @@ ISO 8859-7 was formerly known as ELOT-928 or ECMA-118:1986. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 cf2ff3cb9..2e04af9cb 100644 --- a/man7/iso_8859-8.7 +++ b/man7/iso_8859-8.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis (edimitro@tee.gr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -24,7 +23,7 @@ .\" .\" Eli Zaretskii <eliz@gnu.org> made valuable suggestions .\" -.TH ISO_8859-8 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-8 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-8 \- ISO 8859-8 character set encoded in octal, decimal, and hexadecimal @@ -130,9 +129,9 @@ and Yiddish is not provided for. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 18814412d..a8dc16dff 100644 --- a/man7/iso_8859-9.7 +++ b/man7/iso_8859-9.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2002 Dimitri Papadopoulos (dpo@club-internet.fr) .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ISO_8859-9 7 2014-10-02 "Linux" "Linux Programmer's Manual" +.TH ISO_8859-9 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME iso_8859-9 \- ISO 8859-9 character set encoded in octal, decimal, and hexadecimal @@ -162,9 +161,9 @@ ISO 8859-9 is also known as Latin-5. .SH SEE ALSO .BR ascii (7), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/keyrings.7 b/man7/keyrings.7 index d7e172a7c..a84928782 100644 --- a/man7/keyrings.7 +++ b/man7/keyrings.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" and Copyright (C) 2016 Michael Kerrisk <mtk.manpages@gmail.com> @@ -10,7 +9,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH KEYRINGS 7 2020-04-11 Linux "Linux Programmer's Manual" +.TH KEYRINGS 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME keyrings \- in-kernel key management and retention facility .SH DESCRIPTION @@ -105,9 +104,9 @@ the key is scheduled for garbage collection. The kernel provides several basic types of key: .TP .I """keyring""" -'\" Note that keyrings use different fields in struct key in order to store -'\" their data - index_key instead of type/description and name_link/keys -'\" instead of payload. +.\" Note that keyrings use different fields in struct key in order to store +.\" their data - index_key instead of type/description and name_link/keys +.\" instead of payload. Keyrings are special keys which store a set of links to other keys (including other keyrings), analogous to a directory holding links to files. @@ -235,13 +234,13 @@ which is usually as long as the process exists. .IP There are three keyrings with different inheritance/sharing rules: the -.BR session-keyring (7) +.BR session\-keyring (7) (inherited and shared by all child processes), the -.BR process-keyring (7) +.BR process\-keyring (7) (shared by all threads in a process) and the -.BR thread-keyring (7) +.BR thread\-keyring (7) (specific to a particular thread). .IP As an alternative to using the actual keyring IDs, @@ -259,9 +258,9 @@ can be used to refer to the caller's own instances of these keyrings. .TP User keyrings Each UID known to the kernel has a record that contains two keyrings: the -.BR user-keyring (7) +.BR user\-keyring (7) and the -.BR user-session-keyring (7). +.BR user\-session\-keyring (7). These exist for as long as the UID record in the kernel exists. .IP As an alternative to using the actual keyring IDs, @@ -282,7 +281,7 @@ when a new login session is initiated. .TP Persistent keyrings There is a -.BR persistent-keyring (7) +.BR persistent\-keyring (7) available to each UID known to the system. It may persist beyond the life of the UID record previously mentioned, but has an expiration time set such that it is automatically cleaned up @@ -321,10 +320,10 @@ Any key or keyring that does not grant permission to the caller is ignored in all the following rules. .IP (2) A thread possesses its -.BR session-keyring (7), -.BR process-keyring (7), +.BR session\-keyring (7), +.BR process\-keyring (7), and -.BR thread-keyring (7) +.BR thread\-keyring (7) directly because those keyrings are referred to by its credentials. .IP (3) If a keyring is possessed, then any key it links to is also possessed. @@ -349,7 +348,7 @@ on the basis of UID and GID matches. When it creates the session keyring, .BR pam_keyinit (8) adds a link to the -.BR user-keyring (7), +.BR user\-keyring (7), thus making the user keyring and anything it contains possessed by default. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SS Access rights @@ -448,13 +447,13 @@ for use by internal components that make use of keys.) The search algorithm works as follows: .IP (1) 4 The process keyrings are searched in the following order: the thread -.BR thread-keyring (7) +.BR thread\-keyring (7) if it exists, the -.BR process-keyring (7) +.BR process\-keyring (7) if it exists, and then either the -.BR session-keyring (7) +.BR session\-keyring (7) if it exists or the -.BR user-session-keyring (7) +.BR user\-session\-keyring (7) if that exists. .IP (2) If the caller was a process that was invoked by the @@ -498,7 +497,7 @@ This allows keys to be created on an as-needed basis. .PP Typically, this will involve the kernel creating a new process that executes the -.BR request-key (8) +.BR request\-key (8) program, which will then execute the appropriate handler based on its configuration. .PP @@ -513,9 +512,9 @@ See .BR keyctl_instantiate (3), .BR keyctl_negate (3), .BR keyctl_reject (3), -.BR request-key (8), +.BR request\-key (8), and -.BR request-key.conf (5) +.BR request\-key.conf (5) for more information. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SS /proc files @@ -592,7 +591,7 @@ The key contributes to the user's quota. .\" KEY_FLAG_USER_CONSTRUCT The key is under construction via a callback to user space; see -.BR request-key (2). +.BR request\-key (2). .IP N .\" KEY_FLAG_NEGATIVE The key is negatively instantiated. @@ -875,7 +874,7 @@ scripts can use them. .BR user\-keyring (7), .BR user\-session\-keyring (7), .BR pam_keyinit (8), -.BR request-key (8) +.BR request\-key (8) .PP The kernel source files .IR Documentation/crypto/asymmetric-keys.txt @@ -884,7 +883,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.07 of the Linux +This page is part of release 5.08 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 09960d649..5fc931a56 100644 --- a/man7/koi8-r.7 +++ b/man7/koi8-r.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2001 Alexey Mahotkin <alexm@hsys.msk.ru> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -22,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH KOI8-R 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH KOI8-R 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME koi8-r \- Russian character set encoded in octal, decimal, and hexadecimal @@ -183,11 +182,11 @@ A4, A6, A7, AD, B4, B6, B7, and BD. .BR ascii (7), .BR charsets (7), .BR cp1251 (7), -.BR iso_8859-5 (7), -.BR koi8-u (7), -.BR utf-8 (7) +.BR iso_8859\-5 (7), +.BR koi8\-u (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 716ec39dd..a77669ce4 100644 --- a/man7/koi8-u.7 +++ b/man7/koi8-u.7 @@ -1,4 +1,3 @@ -'\" t -*- coding: UTF-8 -*- .\" Copyright 2009 Lefteris Dimitroulakis <edimitro at tee.gr> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -24,7 +23,7 @@ .\" .\" 2009-01-15, mtk, Some edits .\" -.TH KOI8-U 7 2016-07-17 "Linux" "Linux Programmer's Manual" +.TH KOI8-U 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME koi8-u \- Ukrainian character set encoded in octal, decimal, and hexadecimal @@ -189,11 +188,11 @@ A4, A6, A7, AD, B4, B6, B7, and BD. .BR ascii (7), .BR charsets (7), .BR cp1251 (7), -.BR iso_8859-5 (7), -.BR koi8-r (7), -.BR utf-8 (7) +.BR iso_8859\-5 (7), +.BR koi8\-r (7), +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/libc.7 b/man7/libc.7 index 1f3fbf98c..98d662f7b 100644 --- a/man7/libc.7 +++ b/man7/libc.7 @@ -117,11 +117,11 @@ project, where they are known. .BR getauxval (3), .BR proc (5), .BR feature_test_macros (7), -.BR man-pages (7), +.BR man\-pages (7), .BR standards (7), .BR vdso (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/locale.7 b/man7/locale.7 index 2070647a6..63a8c9074 100644 --- a/man7/locale.7 +++ b/man7/locale.7 @@ -397,9 +397,9 @@ POSIX.1-2001. .BR locale (5), .BR charsets (7), .BR unicode (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/mailaddr.7 b/man7/mailaddr.7 index 30b0073e3..d3e0aed60 100644 --- a/man7/mailaddr.7 +++ b/man7/mailaddr.7 @@ -24,7 +24,7 @@ .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" %%%LICENSE_END .\" -.TH MAILADDR 7 2017-05-03 "Linux" "Linux User's Manual" +.TH MAILADDR 7 2020-08-13 "Linux" "Linux User's Manual" .UC 5 .SH NAME mailaddr \- mail addressing description @@ -110,7 +110,7 @@ The "postmaster" address is not case sensitive. .SH FILES .I /etc/aliases .br -.I ~/.forward +.I \(ti/.forward .SH SEE ALSO .BR mail (1), .BR aliases (5), @@ -121,7 +121,7 @@ The "postmaster" address is not case sensitive. IETF RFC\ 5322 .UE .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 e24187578..5db781aa3 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -27,7 +27,7 @@ .\" 2007-05-30 created by mtk, using text from old man.7 plus .\" rewrites and additional text. .\" -.TH MAN-PAGES 7 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH MAN-PAGES 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME man-pages \- conventions for writing Linux man pages .SH SYNOPSIS @@ -46,7 +46,6 @@ of the man pages on a Linux system. The conventions described on this page may also be useful for authors writing man pages for other projects. .SS Sections of the manual pages -.PP The manual Sections are traditionally defined as follows: .TP .B 1 User commands (Programs) @@ -112,9 +111,8 @@ command: .I "title section date source manual" .RE .PP -where: -.RS -.TP 10 +The arguments of the command are as follows: +.TP .I title The title of the man page, written in all caps (e.g., .IR MAN-PAGES ). @@ -162,7 +160,7 @@ In cases of doubt, just write The title of the manual (e.g., for Section 2 and 3 pages in the \fIman-pages\fP package, use .IR "Linux Programmer's Manual" ). -.RE +.\" .SS Sections within a manual page The list below shows conventional or suggested sections. Most manual pages should include at least the @@ -277,7 +275,7 @@ that introduced the change. The preferred method of noting this information for flags is as part of a .B .TP list, in the following form (here, for a new system call flag): -.RS 22 +.RS 16 .TP .BR XYZ_FLAG " (since Linux 3.7)" Description of flag... @@ -508,7 +506,6 @@ Use of "they" ("them", "themself", "their") as a gender-neutral singular pronoun is acceptable. .\" .SS Formatting conventions for manual pages describing commands -.PP For manual pages that describe a command (typically in Sections 1 and 8), the arguments are always specified using italics, .IR "even in the SYNOPSIS section" . @@ -552,7 +549,6 @@ makes it easier to see the effect of patches, which often operate at the level of individual sentences or sentence clauses. .\" .SS Formatting conventions (general) -.PP Paragraphs should be separated by suitable markers (usually either .I .PP or @@ -613,7 +609,6 @@ Thu Jul 7 13:01:27 CEST 2016 .EE .in .PP -.PP Any reference to another man page should be written with the name in bold, .I always @@ -633,7 +628,7 @@ create properly hyperlinked pages.) .PP Control characters should be written in bold face, with no quotes; for example, -.BR ^X . +.BR \(haX . .SS Spelling Starting with release 2.59, .I man-pages @@ -837,7 +832,7 @@ when rendering a page with, say: In general, the use of abbreviations such as "e.g.", "i.e.", "etc.", "cf.", and "a.k.a." should be avoided, in favor of suitable full wordings -("for example", "that is", "compare to", "and so on", "also known as"). +("for example", "that is", "and so on", "compare to", "also known as"). .PP The only place where such abbreviations may be acceptable is in .I short @@ -902,7 +897,8 @@ Some examples: .PP Finally, note that "re-create" and "recreate" are two different verbs, and the former is probably what you want. -.SS Real minus character +.\" +.SS Generating optimal glyphs Where a real minus character is required (e.g., for numbers such as \-1, for man page cross references such as .BR utf\-8 (7), @@ -913,9 +909,9 @@ use the following form in the man page source: \e\- .PP This guideline applies also to code examples. -.SS Character constants -To produce single quotes that render well in both ASCII and UTF-8, -use the following form for character constants in the man page source: +.PP +To produce unslanted single quotes that render well in ASCII, UTF-8, and PDF, +use "\e(aq" ("apostrophe quote"); for example .PP \e(aqC\e(aq .PP @@ -923,6 +919,17 @@ where .I C is the quoted character. This guideline applies also to character constants used in code examples. +.PP +Where a proper caret (\(ha) that renders well in both a terminal and PDF +is required, use "\\(ha". +This is especially necessary in code samples, +to get a nicely rendered caret when rendering to PDF. +.PP +Using a naked "\(ti" character results in a poor rendering in PDF. +Instead use "\\(ti". +This is especially necessary in code samples, +to get a nicely rendered tilde when rendering to PDF. +.\" .SS Example programs and shell sessions Manual pages may include example programs demonstrating how to use a system call or library function. @@ -1009,7 +1016,7 @@ and .BR man (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/man.7 b/man7/man.7 index c87ad698d..3abf64053 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -74,7 +74,7 @@ macro package is in use. .PP For conventions that should be employed when writing man pages for the Linux \fIman-pages\fP package, see -.BR man-pages (7). +.BR man\-pages (7). .SS Title line The first command in a man page (after comment lines, that is, lines that start with \fB.\e"\fP) should be @@ -87,7 +87,7 @@ that is, lines that start with \fB.\e"\fP) should be For details of the arguments that should be supplied to the .B TH command, see -.BR man-pages (7). +.BR man\-pages (7). .PP Note that BSD mdoc-formatted pages begin with the .B Dd @@ -127,7 +127,7 @@ commands. for further details on the syntax of the NAME section.) .PP For a list of other sections that might appear in a manual page, see -.BR man-pages (7). +.BR man\-pages (7). .SS Fonts The commands to select the type face are: .TP 4 @@ -278,7 +278,7 @@ macro, with the optional (if present, usually a closing parenthesis and/or end-of-sentence punctuation) immediately following. For non-HTML output devices (e.g., -.BR "man -Tutf8" ), +.BR "man \-Tutf8" ), the link text is followed by the URL in angle brackets; if there is no link text, the URL is printed as its own link text, surrounded by angle brackets. @@ -520,10 +520,10 @@ is not implemented. .BR whatis (1), .BR groff_man (7), .BR groff_www (7), -.BR man-pages (7), +.BR man\-pages (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 fbc6cb209..be5542c5c 100644 --- a/man7/math_error.7 +++ b/man7/math_error.7 @@ -171,7 +171,7 @@ positive number in the specified type"). .I errno may be set to .BR ERANGE , -and an "overflow" +and an "underflow" .RB ( FE_UNDERFLOW ) floating-point exception may be raised. .PP @@ -193,7 +193,7 @@ This identifier is supposed to indicate which of the two error-notification mechanisms .RI ( errno , exceptions retrievable via -.BR fettestexcept (3)) +.BR fetestexcept (3)) is in use. The standards require that at least one be in use, but permit both to be available. @@ -240,7 +240,7 @@ and POSIX.1. .PP The .BR gcc (1) -.I "-fno-math-errno" +.I "\-fno-math-errno" option causes the executable to employ implementations of some mathematical functions that are faster than the standard implementations, but do not set @@ -248,9 +248,9 @@ implementations, but do not set on error. (The .BR gcc (1) -.I "-ffast-math" +.I "\-ffast-math" option also enables -.IR "-fno-math-errno" .) +.IR "\-fno-math-errno" .) An error can still be tested for using .BR fetestexcept (3). .SH SEE ALSO @@ -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.07 of the Linux +This page is part of release 5.08 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 796b954ba..a55619648 100644 --- a/man7/mount_namespaces.7 +++ b/man7/mount_namespaces.7 @@ -1138,7 +1138,7 @@ See .IR Documentation/filesystems/sharedsubtree.txt in the kernel source tree. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 4c88ddfa8..f9ca06c15 100644 --- a/man7/mq_overview.7 +++ b/man7/mq_overview.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -408,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/namespaces.7 b/man7/namespaces.7 index bb34696c9..631849c96 100644 --- a/man7/namespaces.7 +++ b/man7/namespaces.7 @@ -432,7 +432,7 @@ and .BR pam_namespace (8), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netdevice.7 b/man7/netdevice.7 index 379dfa1d4..829bfb564 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>. .\" .\" %%%LICENSE_START(VERBATIM_ONE_PARA) @@ -15,7 +14,7 @@ .\" Modified, 2011-11-02, <bidulock@openss7.org>, added many basic .\" but missing ioctls, such as SIOCGIFADDR. .\" -.TH NETDEVICE 7 2019-11-19 "Linux" "Linux Programmer's Manual" +.TH NETDEVICE 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME netdevice \- low-level access to Linux network devices .SH SYNOPSIS @@ -375,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/netlink.7 b/man7/netlink.7 index 4abf78762..95d1f6b55 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (c) 1998 by Andi Kleen. .\" .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE) @@ -574,13 +573,13 @@ for (nh = (struct nlmsghdr *) buf; NLMSG_OK (nh, len); information about libnetlink .UE .PP -.UR http://www.infradead.org\:/~tgr\:/libnl/ +.UR http://www.infradead.org\:/\(titgr\:/libnl/ information about libnl .UE .PP RFC 3549 "Linux Netlink as an IP Services Protocol" .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 280a96f61..60ee7a5a6 100644 --- a/man7/network_namespaces.7 +++ b/man7/network_namespaces.7 @@ -74,13 +74,13 @@ option. .BR user_namespaces (7), .BR brctl (8), .BR ip (8), -.BR ip-address (8), -.BR ip-link (8), -.BR ip-netns (8), +.BR ip\-address (8), +.BR ip\-link (8), +.BR ip\-netns (8), .BR iptables (8), -.BR ovs-vsctl (8) +.BR ovs\-vsctl (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/nptl.7 b/man7/nptl.7 index ff61f710e..dbe06edd2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/numa.7 b/man7/numa.7 index 3c5deee23..8e3041c64 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/operator.7 b/man7/operator.7 index fc9f6369c..c5f79c872 100644 --- a/man7/operator.7 +++ b/man7/operator.7 @@ -37,7 +37,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH OPERATOR 7 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH OPERATOR 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME operator \- C operator precedence and order of evaluation .SH DESCRIPTION @@ -48,19 +48,19 @@ lb lb lb l l l. Operator Associativity Notes () [] \-> . ++ \-\- left to right [1] -! ~ ++ \-\- + \- (type) * & sizeof right to left [2] +! \(ti ++ \-\- + \- (type) * & sizeof right to left [2] * / % left to right + \- left to right << >> left to right < <= > >= left to right == != left to right & left to right -^ left to right +\(ha left to right | left to right && left to right || left to right ?: right to left -= += \-= *= /= %= <<= >>= &= ^= |= right to left += += \-= *= /= %= <<= >>= &= \(ha= |= right to left , left to right .TE .PP @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/packet.7 b/man7/packet.7 index 831b7644b..896640c55 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -656,7 +656,7 @@ contains example source code for all available versions of and .BR PACKET_TX_RING . .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 78357f27f..74442f668 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.07 of the Linux +This page is part of release 5.08 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 f596e5b3f..73b2ddc5c 100644 --- a/man7/persistent-keyring.7 +++ b/man7/persistent-keyring.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" @@ -9,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH PERSISTENT-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH PERSISTENT-KEYRING 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME persistent-keyring \- per-user persistent keyring .SH DESCRIPTION @@ -67,9 +66,9 @@ at which point it is garbage collected. This allows the persistent keyring to carry keys beyond the life of the kernel's record of the corresponding UID (the destruction of which results in the destruction of the -.BR user-keyring (7) +.BR user\-keyring (7) and the -.BR user-session-keyring (7)). +.BR user\-session\-keyring (7)). The persistent keyring can thus be used to hold authentication tokens for processes that run without user interaction, such as programs started by @@ -125,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.07 of the Linux +This page is part of release 5.08 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 47f54474e..147e904b9 100644 --- a/man7/pid_namespaces.7 +++ b/man7/pid_namespaces.7 @@ -262,7 +262,7 @@ namespace that is the .I parent of the child's PID namespace, rather than the "init" process in the child's own PID namespace. -\" Furthermore, by definition, the parent of the "init" process +.\" Furthermore, by definition, the parent of the "init" process .\" of a PID namespace resides in the parent PID namespace. .\" .\" ============================================================ @@ -343,7 +343,7 @@ is: .PP .in +4n .EX -$ mount -t proc proc /proc +$ mount \-t proc proc /proc .EE .in .PP @@ -405,7 +405,7 @@ See .BR user_namespaces (7), .BR switch_root (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pipe.7 b/man7/pipe.7 index 91c70f669..2d74a4af4 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pkeys.7 b/man7/pkeys.7 index c7278ebbd..333fecbc6 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index 6292fb381..97c0b317e 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.07 of the Linux +This page is part of release 5.08 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 5a30d1796..59706eb37 100644 --- a/man7/process-keyring.7 +++ b/man7/process-keyring.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" @@ -9,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH PROCESS-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH PROCESS-KEYRING 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME process-keyring \- per-process shared keyring .SH DESCRIPTION @@ -60,7 +59,7 @@ results. .BR user\-keyring (7), .BR user\-session\-keyring (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pthreads.7 b/man7/pthreads.7 index 8f39afa05..9b82857e3 100644 --- a/man7/pthreads.7 +++ b/man7/pthreads.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (c) 2005 by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTHREADS 7 2019-10-10 "Linux" "Linux Programmer's Manual" +.TH PTHREADS 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME pthreads \- POSIX threads .SH DESCRIPTION @@ -856,7 +855,7 @@ is set to a value other than then this value defines the default stack size for new threads. To be effective, this limit must be set before the program is executed, perhaps using the -.I ulimit -s +.I ulimit \-s shell built-in command .RI ( "limit stacksize" in the C shell). @@ -949,7 +948,7 @@ Various Pthreads manual pages, for example: and .BR pthread_testcancel (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/pty.7 b/man7/pty.7 index 3e5694b88..0b26fb54f 100644 --- a/man7/pty.7 +++ b/man7/pty.7 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH PTY 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH PTY 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME pty \- pseudoterminal interfaces .SH DESCRIPTION @@ -33,6 +33,7 @@ One end of the channel is called the .IR master ; the other end is called the .IR slave . +.PP The slave end of the pseudoterminal provides an interface that behaves exactly like a classical terminal. A process that expects to be connected to a terminal, @@ -48,16 +49,6 @@ that is connected to the slave. Conversely, anything that is written to the slave end of the pseudoterminal can be read by the process that is connected to the master end. -Pseudoterminals are used by applications such as network login services -.RB ( ssh "(1), " rlogin "(1), " telnet (1)), -terminal emulators such as -.BR xterm (1), -.BR script (1), -.BR screen (1), -.BR tmux (1), -.BR unbuffer (1), -and -.BR expect (1). .PP Data flow between master and slave is handled asynchronously, much like data flow with a physical terminal. @@ -75,8 +66,13 @@ Linux provides both BSD-style and (standardized) System V-style pseudoterminals. System V-style terminals are commonly called UNIX 98 pseudoterminals on Linux systems. -Since kernel 2.6.4, BSD-style pseudoterminals are considered deprecated -(they can be disabled when configuring the kernel); +.PP +Since kernel 2.6.4, BSD-style pseudoterminals are considered deprecated: +support can be disabled when building the kernel by disabling the +.B CONFIG_LEGACY_PTYS +option. +(Starting with Linux 2.6.30, +that option is disabled by default in the mainline kernel.) UNIX 98 pseudoterminals should be used in new applications. .SS UNIX 98 pseudoterminals An unused UNIX 98 pseudoterminal master is opened by calling @@ -145,6 +141,17 @@ BSD master devices .I /dev/tty[p\-za\-e][0\-9a\-f] BSD slave devices .SH NOTES +Pseudoterminals are used by applications such as network login services +.RB ( ssh "(1), " rlogin "(1), " telnet (1)), +terminal emulators such as +.BR xterm (1), +.BR script (1), +.BR screen (1), +.BR tmux (1), +.BR unbuffer (1), +and +.BR expect (1). +.PP A description of the .B TIOCPKT .BR ioctl (2), @@ -170,7 +177,7 @@ have not been implemented under Linux. .BR pts (4), .BR tty (4) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/random.7 b/man7/random.7 index 0b625f592..80e78efda 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/raw.7 b/man7/raw.7 index aa6bca81d..7b2151aa1 100644 --- a/man7/raw.7 +++ b/man7/raw.7 @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>. .\" .\" %%%LICENSE_START(VERBATIM_ONE_PARA) @@ -10,7 +9,7 @@ .\" .\" $Id: raw.7,v 1.6 1999/06/05 10:32:08 freitag Exp $ .\" -.TH RAW 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH RAW 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME raw \- Linux IPv4 raw sockets .SH SYNOPSIS @@ -286,7 +285,7 @@ and the .I <linux/ip.h> header file for the IP protocol. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/regex.7 b/man7/regex.7 index a66fa9c3f..f2074c38b 100644 --- a/man7/regex.7 +++ b/man7/regex.7 @@ -34,7 +34,7 @@ .\" .ie t .ds dg \(dg .el .ds dg (!) -.TH REGEX 7 2009-01-12 "" "Linux Programmer's Manual" +.TH REGEX 7 2020-08-13 "" "Linux Programmer's Manual" .SH NAME regex \- POSIX.2 regular expressions .SH DESCRIPTION @@ -91,10 +91,10 @@ An atom is a regular expression enclosed in "\fI()\fP" (matching a match for the regular expression), an empty set of "\fI()\fP" (matching the null string)\*(dg, a \fIbracket expression\fR (see below), \(aq.\(aq -(matching any single character), \(aq^\(aq (matching the null string at the +(matching any single character), \(aq\(ha\(aq (matching the null string at the beginning of a line), \(aq$\(aq (matching the null string at the end of a line), a \(aq\e\(aq followed by one of the characters -"\fI^.[$()|*+?{\e\fP" +"\fI\(ha.[$()|*+?{\e\fP" (matching that character taken as an ordinary character), a \(aq\e\(aq followed by any other character\*(dg (matching that character taken as an ordinary character, @@ -106,7 +106,7 @@ It is illegal to end an RE with \(aq\e\(aq. .PP A \fIbracket expression\fR is a list of characters enclosed in "\fI[]\fP". It normally matches any single character from the list (but see below). -If the list begins with \(aq^\(aq, +If the list begins with \(aq\(ha\(aq, it matches any single character (but see below) \fInot\fR from the rest of the list. If two characters in the list are separated by \(aq\-\(aq, this is shorthand @@ -119,7 +119,7 @@ Ranges are very collating-sequence-dependent, and portable programs should avoid relying on them. .PP To include a literal \(aq]\(aq in the list, make it the first character -(following a possible \(aq^\(aq). +(following a possible \(aq\(ha\(aq). To include a literal \(aq\-\(aq, make it the first or last character, or the second endpoint of a range. To use a literal \(aq\-\(aq as the first endpoint of a range, @@ -147,9 +147,9 @@ of all collating elements equivalent to that one, including itself. (If there are no other equivalent collating elements, the treatment is as if the enclosing delimiters were "\fI[.\fP" and "\fI.]\fP".) -For example, if o and \o'o^' are the members of an equivalence class, -then "\fI[[=o=]]\fP", "\fI[[=\o'o^'=]]\fP", -and "\fI[o\o'o^']\fP" are all synonymous. +For example, if o and \o'o\(ha' are the members of an equivalence class, +then "\fI[[=o=]]\fP", "\fI[[=\o'o\(ha'=]]\fP", +and "\fI[o\o'o\(ha']\fP" are all synonymous. An equivalence class may not\*(dg be an endpoint of a range. .PP @@ -226,7 +226,7 @@ transformed into a bracket expression containing both cases, for example, \(aqx\(aq becomes "\fI[xX]\fP". When it appears inside a bracket expression, all case counterparts of it are added to the bracket expression, so that, for example, "\fI[x]\fP" -becomes "\fI[xX]\fP" and "\fI[^x]\fP" becomes "\fI[^xX]\fP". +becomes "\fI[xX]\fP" and "\fI[\(hax]\fP" becomes "\fI[\(haxX]\fP". .PP No particular limit is imposed on the length of REs\*(dg. Programs intended to be portable should not employ REs longer @@ -242,13 +242,13 @@ The delimiters for bounds are "\fI\e{\fP" and "\fI\e}\fP", with \(aq{\(aq and \(aq}\(aq by themselves ordinary characters. The parentheses for nested subexpressions are "\fI\e(\fP" and "\fI\e)\fP", with \(aq(\(aq and \(aq)\(aq by themselves ordinary characters. -\(aq^\(aq is an ordinary character except at the beginning of the +\(aq\(ha\(aq is an ordinary character except at the beginning of the RE or\*(dg the beginning of a parenthesized subexpression, \(aq$\(aq is an ordinary character except at the end of the RE or\*(dg the end of a parenthesized subexpression, and \(aq*\(aq is an ordinary character if it appears at the beginning of the RE or the beginning of a parenthesized subexpression -(after a possible leading \(aq^\(aq). +(after a possible leading \(aq\(ha\(aq). .PP Finally, there is one new type of atom, a \fIback reference\fR: \(aq\e\(aq followed by a nonzero decimal digit \fId\fR @@ -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.07 of the Linux +This page is part of release 5.08 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 a49b7c571..144dbf23f 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -606,7 +606,7 @@ la_i86_gnu_pltenter(Elf32_Sym *sym, unsigned int ndx, .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index cea40e00f..4c3db4320 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>. .\" .\" %%%LICENSE_START(VERBATIM_ONE_PARA) @@ -384,7 +383,6 @@ struct rtnexthop { There exist a bunch of RTNH_* macros similar to RTA_* and NLHDR_* macros useful to handle these structures. .PP -.nf .in +4n .EX struct rtvia { @@ -546,7 +544,7 @@ This manual page is incomplete. .BR ip (7), .BR netlink (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sched.7 b/man7/sched.7 index b5ef76898..a2747b317 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.07 of the Linux +This page is part of release 5.08 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 f4ae63455..277b6b2d3 100644 --- a/man7/sem_overview.7 +++ b/man7/sem_overview.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" %%%LICENSE_START(VERBATIM) @@ -159,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.07 of the Linux +This page is part of release 5.08 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 a1f227dec..7679e213c 100644 --- a/man7/session-keyring.7 +++ b/man7/session-keyring.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" @@ -9,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH SESSION-KEYRING 7 2017-09-15 Linux "Linux Programmer's Manual" +.TH SESSION-KEYRING 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME session-keyring \- session shared process keyring .SH DESCRIPTION @@ -17,7 +16,7 @@ The session keyring is a keyring used to anchor keys on behalf of a process. It is typically created by .BR pam_keyinit (8) when a user logs in and a link will be added that refers to the -.BR user-keyring (7). +.BR user\-keyring (7). Optionally, PAM may revoke the session keyring on logout. (In typical configurations, PAM does do this revocation.) The session keyring has the name (description) @@ -47,11 +46,11 @@ refers to it exits. .PP If a process doesn't have a session keyring when it is accessed, then, under certain circumstances, the -.BR user-session-keyring (7) +.BR user\-session\-keyring (7) will be attached as the session keyring and under others a new session keyring will be created. (See -.BR user-session-keyring (7) +.BR user\-session\-keyring (7) for further details.) .SS Special operations The @@ -115,7 +114,7 @@ keyctl new_session .BR user\-session\-keyring (7), .BR pam_keyinit (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 ea99cffab..564b3a521 100644 --- a/man7/shm_overview.7 +++ b/man7/shm_overview.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2008, Linux Foundation, written by Michael Kerrisk .\" <mtk.manpages@gmail.com> .\" @@ -24,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SHM_OVERVIEW 7 2016-12-12 "Linux" "Linux Programmer's Manual" +.TH SHM_OVERVIEW 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME shm_overview \- overview of POSIX shared memory .SH DESCRIPTION @@ -123,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sigevent.7 b/man7/sigevent.7 index 601b4a4e8..4875f3850 100644 --- a/man7/sigevent.7 +++ b/man7/sigevent.7 @@ -139,7 +139,7 @@ Currently used only by POSIX timers; see .BR aio (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 824842c78..046fc1aec 100644 --- a/man7/signal-safety.7 +++ b/man7/signal-safety.7 @@ -345,7 +345,7 @@ internally. .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/signal.7 b/man7/signal.7 index 3f488a3b2..a8c4bc895 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -1,4 +1,3 @@ -'\" t .\" 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) 2008 Linux Foundation, written by Michael Kerrisk @@ -43,7 +42,7 @@ .\" Added section on stop/cont signals interrupting syscalls. .\" 2008-10-05, mtk: various additions .\" -.TH SIGNAL 7 2020-04-11 "Linux" "Linux Programmer's Manual" +.TH SIGNAL 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME signal \- overview of signals .SH DESCRIPTION @@ -313,7 +312,7 @@ and cannot be caught, blocked, or ignored. .PP Up to and including Linux 2.2, the default behavior for -.BR SIGSYS ", " SIGXCPU ", " SIGXFSZ ", " +.BR SIGSYS ", " SIGXCPU ", " SIGXFSZ , and (on architectures other than SPARC and MIPS) .B SIGBUS was to terminate the process (without a core dump). @@ -816,7 +815,7 @@ Linux 2.4 and earlier: POSIX.1, except as noted. .SH NOTES For a discussion of async-signal-safe functions, see -.BR signal-safety (7). +.BR signal\-safety (7). .PP The .I /proc/[pid]/task/[tid]/status @@ -909,7 +908,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.07 of the Linux +This page is part of release 5.08 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 d333cabb0..546064052 100644 --- a/man7/sock_diag.7 +++ b/man7/sock_diag.7 @@ -841,7 +841,7 @@ main(void) .BR netlink (7), .BR tcp (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/socket.7 b/man7/socket.7 index d778fafa2..5b701a239 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -1,4 +1,3 @@ -'\" t .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>. .\" and copyright (c) 1999 Matthew Wilcox. .\" @@ -52,7 +51,7 @@ .\" commit ea02f9411d9faa3553ed09ce0ec9f00ceae9885e .\" Author: Michal Sekletar <msekleta@redhat.com> .\" -.TH SOCKET 7 2020-04-11 Linux "Linux Programmer's Manual" +.TH SOCKET 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME socket \- Linux socket interface .SH SYNOPSIS @@ -978,7 +977,7 @@ for details on control messages. A socket cannot mix .B SO_TIMESTAMP and -.BR SO_TIMESTAMPNS: +.BR SO_TIMESTAMPNS : the two modes are mutually exclusive. .TP .B SO_TYPE @@ -1233,7 +1232,7 @@ program is designed to always set this option. .BR unix (7), .BR tcpdump (8) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/spufs.7 b/man7/spufs.7 index 1f1d9d343..ba3397fc9 100644 --- a/man7/spufs.7 +++ b/man7/spufs.7 @@ -771,7 +771,7 @@ none /spu spufs gid=spu 0 0 .PP .I The Cell Broadband Engine Architecture (CBEA) specification .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/standards.7 b/man7/standards.7 index 2bb98970d..57e9fd5e5 100644 --- a/man7/standards.7 +++ b/man7/standards.7 @@ -121,11 +121,16 @@ Available online at This revision of the C language standard was ratified by ISO in 2011 .RI ( "ISO/IEC 9899:2011" ). .TP +.B POSIX.1-1988 +This was the first POSIX standard, +ratified by IEEE as IEEE Std 1003.1-1988, +and subsequently adopted (with minor revisions) as an ISO standard in 1990. +The term "POSIX" was coined by Richard Stallman. +.TP .B POSIX.1-1990 "Portable Operating System Interface for Computing Environments". IEEE 1003.1-1990 part 1, ratified by ISO in 1990 .RI ( "ISO/IEC 9945-1:1990" ). -The term "POSIX" was coined by Richard Stallman. .TP .B POSIX.2 IEEE Std 1003.2-1992, @@ -138,10 +143,10 @@ describing real-time facilities for portable operating systems, ratified by ISO in 1996 .RI ( "ISO/IEC 9945-1:1996" ). .TP -.B POSIX.1c +.B POSIX.1c " (formerly known as \fIPOSIX.4a\fP)" IEEE Std 1003.1c-1995, which describes the POSIX threads interfaces. .TP -.B POSIX.1d +.BR POSIX.1d IEEE Std 1003.1c-1999, which describes additional real-time extensions. .TP .B POSIX.1g @@ -154,14 +159,14 @@ IEEE Std 1003.1j-2000, which describes advanced real-time extensions. A 1996 revision of POSIX.1 which incorporated POSIX.1b and POSIX.1c. .TP .B XPG3 -Released in 1989, this was the first significant release of the -.IR "X/Open Portability Guide" , -produced by the -X/Open Company, a multivendor consortium. -This multivolume guide was based on the POSIX standards. +Released in 1989, this was the first release of the X/Open +Portability Guide to be based on a POSIX standard (POSIX.1-1988). +This multivolume guide was developed by the X/Open Group, +a multivendor consortium. .TP .B XPG4 A revision of the X/Open Portability Guide, released in 1992. +This revision incorporated POSIX.2. .TP .B XPG4v2 A 1994 revision of XPG4. @@ -180,7 +185,7 @@ Systems conforming to this standard can be branded .TP .B SUSv2 Single UNIX Specification version 2. -Sometimes also referred to as +Sometimes also referred to (incorrectly) as .IR XPG5 . This standard appeared in 1997. Systems conforming to this standard can be branded @@ -210,9 +215,6 @@ which additionally mandates a set of interfaces (the "XSI extension") which are only optional for POSIX conformance. XSI-conformant systems can be branded .IR "UNIX 03" . -(XSI conformance constitutes the -.I "Single UNIX Specification version 3" -.RI ( SUSv3 ).) .IP The POSIX.1-2001 document is broken into four parts: .IP @@ -234,6 +236,11 @@ POSIX.1-2001 is aligned with C99, so that all of the library functions standardized in C99 are also standardized in POSIX.1-2001. .IP +The Single UNIX Specification version 3 (SUSv3) comprises the +Base Specifications containing XBD, XSH, XCU, and XRAT as above, +plus X/Open Curses Issue 4 version 2 as an extra volume that is +not in POSIX.1-2001. +.IP Two Technical Corrigenda (minor fixes and improvements) of the original 2001 standard have occurred: TC1 in 2003 @@ -252,8 +259,13 @@ POSIX.1-2001 become mandatory in the 2008 revision of the standard. A few interfaces that are present in POSIX.1-2001 are marked as obsolete in POSIX.1-2008, or removed from the standard altogether. .IP -The revised standard is broken into the same four parts as POSIX.1-2001, -and again there are two levels of conformance: the baseline +The revised standard is structured in the same way as its predecessor. +The Single UNIX Specification version 4 (SUSv4) comprises the +Base Specifications containing XBD, XSH, XCU, and XRAT, +plus X/Open Curses Issue 7 as an extra volume that is +not in POSIX.1-2008. +.IP +Again there are two levels of conformance: the baseline .IR "POSIX Conformance" , and .IR "XSI Conformance" , @@ -294,7 +306,7 @@ the XCurses specification. .BR libc (7), .BR posixoptions (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/suffixes.7 b/man7/suffixes.7 index a9852ca9e..772e6f66d 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -36,7 +36,7 @@ .\" "nroff" ("man") (or "tbl") needs a long page to avoid warnings .\" from "grotty" (at imagined page breaks). Bug in grotty? .if n .pl 1000v -.TH SUFFIXES 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH SUFFIXES 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME suffixes \- list of file suffixes .SH DESCRIPTION @@ -270,7 +270,7 @@ Suffix File type .z File compressed using \fBpack\fP(1) (or an old \fBgzip\fP(1)) .zip \fBzip\fP(1) archive .zoo \fBzoo\fP(1) archive - ~ Emacs or \fBpatch\fP(1) backup file + \(ti Emacs or \fBpatch\fP(1) backup file rc startup (`run control') file, e.g., \fI.newsrc\fP .TE .SH CONFORMING TO @@ -281,7 +281,7 @@ This list is not exhaustive. .BR file (1), .BR make (1) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/symlink.7 b/man7/symlink.7 index 8dac14ed0..acc23f84e 100644 --- a/man7/symlink.7 +++ b/man7/symlink.7 @@ -84,6 +84,26 @@ as they are implemented on Linux and other systems, are outlined here. It is important that site-local applications also conform to these rules, so that the user interface can be as consistent as possible. +.\" +.SS Magic links +There is a special class of symbolic-link-like objects +known as "magic links", which +can be found in certain pseudofilesystems such as +.BR proc (5) +(examples include +.IR /proc/[pid]/exe " and " /proc/[pid]/fd/* ). +Unlike normal symbolic links, magic links are not resolved through +pathname-expansion, but instead act as direct references to the kernel's own +representation of a file handle. +As such, these magic links allow users to +access files which cannot be referenced with normal paths (such as unlinked +files still referenced by a running program ). +.PP +Because they can bypass ordinary +.BR mount_namespaces (7)-based +restrictions, +magic links have been used as attack vectors in various exploits. +.\" .SS Symbolic link ownership, permissions, and timestamps The owner and group of an existing symbolic link can be changed using @@ -99,16 +119,15 @@ of a symbolic link can be changed using or .BR lutimes (3). .PP -On Linux, the permissions of a symbolic link are not used -in any operations; the permissions are always -0777 (read, write, and execute for all user categories), .\" Linux does not currently implement an lchmod(2). -and can't be changed. -(Note that there are some "magic" symbolic links in the -.I /proc -directory tree\(emfor example, the -.IR /proc/[pid]/fd/* -files\(emthat have different permissions.) +On Linux, the permissions of an ordinary symbolic link are not used in any +operations; the permissions are always 0777 (read, write, and execute for all +user categories), and can't be changed. +.PP +However, magic links do not follow this rule. +They can have a non-0777 mode, +though this mode is not currently used in any permission checks. + .\" .\" The .\" 4.4BSD @@ -563,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/sysvipc.7 b/man7/sysvipc.7 index 00309487c..6b17fd136 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/tcp.7 b/man7/tcp.7 index 3da8e45e9..456b2f598 100644 --- a/man7/tcp.7 +++ b/man7/tcp.7 @@ -371,7 +371,7 @@ A value of 0 implies that no amount is reserved. .\" .\" The following is from 2.6.28-rc4: Documentation/networking/ip-sysctl.txt .TP -.IR tcp_base_mss " (Integer; default: 512; since Linux 2.6.17) +.IR tcp_base_mss " (Integer; default: 512; since Linux 2.6.17)" The initial value of .I search_low to be used by the packetization layer Path MTU discovery (MTU probing). @@ -580,7 +580,7 @@ the orphaned connection is reset and a warning is printed. This limit exists only to prevent simple denial-of-service attacks. Lowering this limit is not recommended. Network conditions might require you to increase the number of -orphans allowed, but note that each orphan can eat up to ~64\ kB +orphans allowed, but note that each orphan can eat up to \(ti64\ kB of unswappable memory. The default initial value is set equal to the kernel parameter NR_FILE. This initial default is adjusted depending on the memory in the system. @@ -630,7 +630,7 @@ attempting to automatically size the buffer (no greater than .IR tcp_rmem[2] ) to match the size required by the path for full throughput. .TP -.IR tcp_mem " (since Linux 2.4) +.IR tcp_mem " (since Linux 2.4)" .\" Since 2.4.0-test7 This is a vector of 3 integers: [low, pressure, high]. These bounds, measured in units of the system page size, @@ -1393,7 +1393,7 @@ RFC\ 2581 for TCP congestion control algorithms. .br RFC\ 2018 and RFC\ 2883 for SACK and extensions to SACK. .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/termio.7 b/man7/termio.7 index 8824a4df0..182dbb139 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.07 of the Linux +This page is part of release 5.08 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 49a4bbefb..cea938ff5 100644 --- a/man7/thread-keyring.7 +++ b/man7/thread-keyring.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" @@ -9,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH THREAD-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH THREAD-KEYRING 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME thread-keyring \- per-thread keyring .SH DESCRIPTION @@ -55,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/time.7 b/man7/time.7 index 5f7ce9ed5..1c9b2d0ec 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.07 of the Linux +This page is part of release 5.08 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 5ec54c912..6e582caba 100644 --- a/man7/time_namespaces.7 +++ b/man7/time_namespaces.7 @@ -368,7 +368,7 @@ CLOCK_BOOTTIME : 76633.544 (21h 19m 23s) .BR namespaces (7), .BR time (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udp.7 b/man7/udp.7 index b07aa4f21..6278bb8e5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/udplite.7 b/man7/udplite.7 index 1d07d6aa2..317fc5d3d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unicode.7 b/man7/unicode.7 index 2631c38e6..73977045f 100644 --- a/man7/unicode.7 +++ b/man7/unicode.7 @@ -26,7 +26,7 @@ .\" 2001-05-11 Markus Kuhn <mgk25@cl.cam.ac.uk> .\" Update .\" -.TH UNICODE 7 2019-03-06 "GNU" "Linux Programmer's Manual" +.TH UNICODE 7 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME unicode \- universal character set .SH DESCRIPTION @@ -248,7 +248,7 @@ Unicode Technical Reports. .IP * Markus Kuhn: UTF-8 and Unicode FAQ for UNIX/Linux. .RS -.UR http://www.cl.cam.ac.uk\:/~mgk25\:/unicode.html +.UR http://www.cl.cam.ac.uk\:/\(timgk25\:/unicode.html .UE .RE .IP * @@ -263,9 +263,9 @@ Bruno Haible: Unicode HOWTO. .BR locale (1), .BR setlocale (3), .BR charsets (7), -.BR utf-8 (7) +.BR utf\-8 (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/units.7 b/man7/units.7 index 180dac83f..54f0a87e8 100644 --- a/man7/units.7 +++ b/man7/units.7 @@ -1,4 +1,3 @@ -'\" t .\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl> .\" .\" %%%LICENSE_START(VERBATIM) @@ -23,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH UNITS 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH UNITS 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME units \- decimal and binary prefixes .SH DESCRIPTION @@ -128,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/unix.7 b/man7/unix.7 index 4b008cd8e..acce8c9ca 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -1152,7 +1152,7 @@ see .BR socket (7), .BR udp (7) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/uri.7 b/man7/uri.7 index f056b5d9d..bf13a1e52 100644 --- a/man7/uri.7 +++ b/man7/uri.7 @@ -45,7 +45,7 @@ .\" Modified Fri Aug 21 23:00:00 1999 by David A. Wheeler (dwheeler@dwheeler.com) .\" Modified Tue Mar 14 2000 by David A. Wheeler (dwheeler@dwheeler.com) .\" -.TH URI 7 2017-09-15 "Linux" "Linux Programmer's Manual" +.TH URI 7 2020-08-13 "Linux" "Linux Programmer's Manual" .SH NAME uri, url, urn \- uniform resource identifier (URI), including a URL or URN .SH SYNOPSIS @@ -503,7 +503,7 @@ include uppercase and lowercase English letters, decimal digits, and the following limited set of punctuation marks and symbols: .IP - \- _ . ! ~ * ' ( ) + \- _ . ! \(ti * ' ( ) .PP All other characters must be escaped. An escaped octet is encoded as a character triplet, consisting of the @@ -523,7 +523,7 @@ A URI is always shown in its "escaped" form. Unreserved characters can be escaped without changing the semantics of the URI, but this should not be done unless the URI is being used in a context that does not allow the unescaped character to appear. -For example, "%7e" is sometimes used instead of "~" in an HTTP URL +For example, "%7e" is sometimes used instead of "\(ti" in an HTTP URL path, but the two are equivalent for an HTTP URL. .PP For URIs which must handle characters outside the US ASCII character set, @@ -531,7 +531,7 @@ the HTML 4.01 specification (section B.2) and IETF RFC\ 2718 (section 2.2.5) recommend the following approach: .IP 1. 4 translate the character sequences into UTF-8 (IETF RFC\ 2279)\(emsee -.BR utf-8 (7)\(emand +.BR utf\-8 (7)\(emand then .IP 2. use the URI escaping mechanism, that is, @@ -554,7 +554,7 @@ This latter system, called the 'new' or 'logical' quoting system by is preferred practice in Great Britain and hackers worldwide (see the Jargon File's section on Hacker Writing Style, -.UR http://www.fwi.uva.nl\:/~mes\:/jargon\:/h\:/HackerWritingStyle.html +.UR http://www.fwi.uva.nl\:/\(times\:/jargon\:/h\:/HackerWritingStyle.html .UE , for more information). Older documents suggested inserting the prefix "URL:" @@ -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.07 of the Linux +This page is part of release 5.08 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 96b21bc14..c26385147 100644 --- a/man7/user-keyring.7 +++ b/man7/user-keyring.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" @@ -9,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH USER-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH USER-KEYRING 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME user-keyring \- per-user keyring .SH DESCRIPTION @@ -26,9 +25,9 @@ The user keyring is associated with the record that the kernel maintains for the UID. It comes into existence upon the first attempt to access either the user keyring, the -.BR user-session-keyring (7), +.BR user\-session\-keyring (7), or the -.BR session-keyring (7). +.BR session\-keyring (7). The keyring remains pinned in existence so long as there are processes running with that real UID or files opened by those processes remain open. (The keyring can also be pinned indefinitely by linking it @@ -69,7 +68,7 @@ If it is necessary for a key associated with a user to exist beyond the UID record being garbage collected\(emfor example, for use by a .BR cron (8) script\(emthen the -.BR persistent-keyring (7) +.BR persistent\-keyring (7) should be used instead. .PP If a user keyring does not exist when it is accessed, it will be created. @@ -86,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.07 of the Linux +This page is part of release 5.08 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 681fc4280..285209f36 100644 --- a/man7/user-session-keyring.7 +++ b/man7/user-session-keyring.7 @@ -1,4 +1,3 @@ -.\" .\" Copyright (C) 2014 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" @@ -9,7 +8,7 @@ .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" -.TH USER-SESSION-KEYRING 7 2017-03-13 Linux "Linux Programmer's Manual" +.TH USER-SESSION-KEYRING 7 2020-08-13 Linux "Linux Programmer's Manual" .SH NAME user-session-keyring \- per-user default session keyring .SH DESCRIPTION @@ -26,9 +25,9 @@ The user session keyring is associated with the record that the kernel maintains for the UID. It comes into existence upon the first attempt to access either the user session keyring, the -.BR user-keyring (7), +.BR user\-keyring (7), or the -.BR session-keyring (7). +.BR session\-keyring (7). .\" Davis Howells: the user and user-session keyrings are managed as a pair. The keyring remains pinned in existence so long as there are processes running with that real UID or files opened by those processes remain open. @@ -37,7 +36,7 @@ into another keyring.) .PP The user session keyring is created on demand when a thread requests it or when a thread asks for its -.BR session-keyring (7) +.BR session\-keyring (7) and that keyring doesn't exist. In the latter case, a user session keyring will be created and, if the session keyring wasn't to be created, @@ -74,7 +73,7 @@ it will be created. Rather than relying on the user session keyring, it is strongly recommended\(emespecially if the process is running as root\(emthat a -.BR session-keyring (7) +.BR session\-keyring (7) be set explicitly, for example by .BR pam_keyinit (8). .SH NOTES @@ -84,7 +83,7 @@ perhaps because it was created via a pathway that didn't involve PAM (e.g., perhaps it was a daemon started by .BR inetd (8)). In such a scenario, the user session keyring acts as a substitute for the -.BR session-keyring (7). +.BR session\-keyring (7). .SH SEE ALSO .ad l .nh @@ -97,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.07 of the Linux +This page is part of release 5.08 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 0eeb40d35..d59b6deba 100644 --- a/man7/user_namespaces.7 +++ b/man7/user_namespaces.7 @@ -1053,10 +1053,10 @@ and a full set of permitted and effective capabilities: .PP .in +4n .EX -bash$ \fBcat /proc/$$/status | egrep '^[UG]id'\fP +bash$ \fBcat /proc/$$/status | egrep '\(ha[UG]id'\fP Uid: 0 0 0 0 Gid: 0 0 0 0 -bash$ \fBcat /proc/$$/status | egrep '^Cap(Prm|Inh|Eff)'\fP +bash$ \fBcat /proc/$$/status | egrep '\(haCap(Prm|Inh|Eff)'\fP CapInh: 0000000000000000 CapPrm: 0000001fffffffff CapEff: 0000001fffffffff @@ -1383,7 +1383,7 @@ main(int argc, char *argv[]) The kernel source file .IR Documentation/namespaces/resource-control.txt . .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 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 2b03cf278..013c1e43b 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.07 of the Linux +This page is part of release 5.08 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 3133e4226..6bac8f509 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vdso.7 b/man7/vdso.7 index 8dea90095..cd14bc110 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/vsock.7 b/man7/vsock.7 index 3b0d90a9c..610639a0d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/x25.7 b/man7/x25.7 index 938113ae8..c4d45ca0e 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man7/xattr.7 b/man7/xattr.7 index 5fbe59197..b207721e3 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8 index 0e6f08467..e1aa2df69 100644 --- a/man8/iconvconfig.8 +++ b/man8/iconvconfig.8 @@ -1,5 +1,3 @@ -'\" t -*- coding: UTF-8 -*- -.\" .\" Copyright (C) 2014 Marko Myllynen <myllynen@redhat.com> .\" .\" %%%LICENSE_START(GPLv2+_DOC_FULL) @@ -23,7 +21,7 @@ .\" <http://www.gnu.org/licenses/>. .\" %%%LICENSE_END .\" -.TH ICONVCONFIG 8 2018-02-02 "GNU" "Linux System Administration" +.TH ICONVCONFIG 8 2020-08-13 "GNU" "Linux System Administration" .SH NAME iconvconfig \- create iconv module configuration cache .SH SYNOPSIS @@ -102,7 +100,7 @@ Usual system gconv module configuration cache. .BR iconv (1), .BR iconv (3) .SH COLOPHON -This page is part of release 5.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/intro.8 b/man8/intro.8 index 1689c8260..810944dbe 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.07 of the Linux +This page is part of release 5.08 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 eb9676a1d..f012b38cf 100644 --- a/man8/ld.so.8 +++ b/man8/ld.so.8 @@ -2,7 +2,7 @@ .\" This is in the public domain .\" %%%LICENSE_END .\" -.TH LD.SO 8 2019-08-02 "GNU" "Linux Programmer's Manual" +.TH LD.SO 8 2020-08-13 "GNU" "Linux Programmer's Manual" .SH NAME ld.so, ld\-linux.so \- dynamic linker/loader .SH SYNOPSIS @@ -97,12 +97,41 @@ and then If the binary was linked with the .B \-z nodeflib linker option, this step is skipped. -.SS Rpath token expansion +.SS Dynamic string tokens .PP -The dynamic linker -understands certain token strings in an rpath specification -(DT_RPATH or DT_RUNPATH). -Those strings are substituted as follows: +In several places, the dynamic linker expands dynamic string tokens: +.IP o 3 +In the environment variables +.BR LD_LIBRARY_PATH , +.BR LD_PRELOAD , +and +.BR LD_AUDIT , +.IP o 3 +inside the values of the dynamic section tags +.BR DT_NEEDED , +.BR DT_RPATH , +.BR DT_RUNPATH , +.BR DT_AUDIT , +and +.BR DT_DEPAUDIT +of ELF binaries, +.IP o 3 +in the arguments to the +.B ld.so +command line options +.BR \-\-audit , +.BR \-\-library-path , +and +.B \-\-preload +(see below), and +.IP o 3 +in the filename arguments to the +.BR dlopen (3) +and +.BR dlmopen (3) +functions. +.PP +The substituted tokens are as follows: .TP .IR $ORIGIN " (or equivalently " ${ORIGIN} ) This expands to @@ -156,6 +185,10 @@ value in the auxiliary vector (see .\" .\" ld.so lets names be abbreviated, so $O will work for $ORIGIN; .\" Don't do this!! +.PP +Note that the dynamic string tokens have to be quoted properly when +set from a shell, +to prevent their expansion as shell or environment variables. .SH OPTIONS .TP .BI \-\-audit " list" @@ -319,6 +352,7 @@ A list of directories in which to search for ELF libraries at execution time. The items in the list are separated by either colons or semicolons, and there is no support for escaping either separator. +A zero-length directory name indicates the current working directory. .IP This variable is ignored in secure-execution mode. .IP @@ -331,7 +365,7 @@ and .IR $PLATFORM (or the versions using curly braces around the names) as described above in -.IR "Rpath token expansion" . +.IR "Dynamic string tokens" . Thus, for example, the following would cause a library to be searched for in either the .I lib @@ -378,7 +412,7 @@ and .IR $PLATFORM (or the versions using curly braces around the names) as described above in -.IR "Rpath token expansion" . +.IR "Dynamic string tokens" . (See also the discussion of quoting under the description of .BR LD_LIBRARY_PATH .) .\" Tested with the following: @@ -448,7 +482,7 @@ and .IR $PLATFORM (or the versions using curly braces around the names) as described above in -.IR "Rpath token expansion" . +.IR "Dynamic string tokens" . (See also the discussion of quoting under the description of .BR LD_LIBRARY_PATH .) .IP @@ -682,7 +716,7 @@ program if the .B LD_TRACE_LOADED_OBJECTS environment variable has been set. .TP -.BR LD_WARN " (since glibc 2.1.3) +.BR LD_WARN " (since glibc 2.1.3)" If set to a nonempty string, warn about unresolved symbols. .TP .BR LD_PREFER_MAP_32BIT_EXEC " (x86-64 only; since glibc 2.23)" @@ -795,7 +829,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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/ldconfig.8 b/man8/ldconfig.8 index 836621731..fa29e8e7d 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/nscd.8 b/man8/nscd.8 index d71e3af48..a2612318a 100644 --- a/man8/nscd.8 +++ b/man8/nscd.8 @@ -87,7 +87,7 @@ invalidates its cache: .PP .in +4n .EX -$ \fBnscd -i\fP \fI<database>\fP +$ \fBnscd \-i\fP \fI<database>\fP .EE .in .SH SEE ALSO @@ -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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/sln.8 b/man8/sln.8 index c39f37aac..83f7885f5 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/tzselect.8 b/man8/tzselect.8 index e6da967b4..783e52e2f 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zdump.8 b/man8/zdump.8 index 56b6939c9..7b4334ae2 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.07 of the Linux +This page is part of release 5.08 of the Linux .I man-pages project. A description of the project, diff --git a/man8/zic.8 b/man8/zic.8 index d90a03829..0bfa5d689 100644 --- a/man8/zic.8 +++ b/man8/zic.8 @@ -2,7 +2,7 @@ .\" This page is in the public domain .\" %%%LICENSE_END .\" -.TH ZIC 8 2019-03-06 "" "Linux System Administration" +.TH ZIC 8 2020-08-13 "" "Linux System Administration" .SH NAME zic \- timezone compiler .SH SYNOPSIS @@ -49,6 +49,32 @@ Output version information and exit. .B \*-\*-help Output short usage message and exit. .TP +.BI "\*-b " bloat +Output backward-compatibility data as specified by +.IR bloat . +If +.I bloat +is +.BR fat , +generate additional data entries that work around potential bugs or +incompatibilities in older software, such as software that mishandles +the 64-bit generated data. +If +.I bloat +is +.BR slim , +keep the output files small; this can help check for the bugs +and incompatibilities. +Although the default is currently +.BR fat , +this is intended to change in future +.B zic +versions, as software that mishandles the 64-bit data typically +mishandles timestamps after the year 2038 anyway. +Also see the +.B \*-r +option for another way to shrink output size. +.TP .BI "\*-d " directory Create time conversion information files in the named directory rather than in the standard directory named below. @@ -61,23 +87,63 @@ as local time. will act as if the input contained a link line of the form .sp .ti +.5i +.ta \w'Link\0\0'u +\w'\fItimezone\fP\0\0'u Link \fItimezone\fP localtime .TP +.BI "\*-L " leapsecondfilename +Read leap second information from the file with the given name. +If this option is not used, +no leap second information appears in output files. +.TP .BI "\*-p " timezone Use .IR timezone 's -rules when handling POSIX-format -timezone environment variables. +rules when handling nonstandard +TZ strings like "EET\*-2EEST" that lack transition rules. .B zic will act as if the input contained a link line of the form .sp .ti +.5i Link \fItimezone\fP posixrules +.sp +This feature is obsolete and poorly supported. +Among other things it should not be used for timestamps after the year 2037, +and it should not be combined with +.B "\*-b slim" +if +.IR timezone 's +transitions are at standard time or Universal Time (UT) instead of local time. .TP -.BI "\*-L " leapsecondfilename -Read leap second information from the file with the given name. -If this option is not used, -no leap second information appears in output files. +.BR "\*-r " "[\fB@\fP\fIlo\fP][\fB/@\fP\fIhi\fP]" +Reduce the size of output files by limiting their applicability +to timestamps in the range from +.I lo +(inclusive) to +.I hi +(exclusive), where +.I lo +and +.I hi +are possibly-signed decimal counts of seconds since the Epoch +(1970-01-01 00:00:00 UTC). +Omitted counts default to extreme values. +For example, +.q "zic \*-r @0" +omits data intended for negative timestamps (i.e., before the Epoch), and +.q "zic \*-r @0/@2147483648" +outputs data intended only for nonnegative timestamps that fit into +31-bit signed integers. +On platforms with GNU +.BR date , +.q "zic \-r @$(date +%s)" +omits data intended for past timestamps. +Also see the +.B "\*-b slim" +option for another way to shrink output size. +.TP +.BI "\*-t " file +When creating local time information, put the configuration link in +the named file rather than in the standard location. .TP .B \*-v Be more verbose, and complain about the following situations: @@ -86,9 +152,7 @@ Be more verbose, and complain about the following situations: The input specifies a link to a link. .PP A year that appears in a data file is outside the range -of years representable by -.BR time (2) -values. +of representable years. .PP A time of 24:00 or more appears in the input. Pre-1998 versions of @@ -100,9 +164,39 @@ Pre-2004 versions of .B zic prohibit this. .PP +A time zone abbreviation uses a +.B %z +format. +Pre-2015 versions of +.B zic +do not support this. +.PP +A timestamp contains fractional seconds. +Pre-2018 versions of +.B zic +do not support this. +.PP +The input contains abbreviations that are mishandled by pre-2018 versions of +.B zic +due to a longstanding coding bug. +These abbreviations include +.q L +for +.q Link , +.q mi +for +.q min , +.q Sa +for +.q Sat , +and +.q Su +for +.q Sun . +.PP The output file does not contain all the information about the long-term future of a timezone, because the future cannot be summarized as -an extended POSIX TZ string. For example, as of 2013 this problem +an extended POSIX TZ string. For example, as of 2019 this problem occurs for Iran's daylight-saving rules for the predicted future, as these rules are based on the Iranian calendar, which cannot be represented. @@ -113,8 +207,15 @@ code designed for older output formats. These compatibility issues affect only timestamps before 1970 or after the start of 2038. .PP -A time zone abbreviation has fewer than 3 characters. -POSIX requires at least 3. +The output file contains more than 1200 transitions, +which may be mishandled by some clients. +The current reference client supports at most 2000 transitions; +pre-2014 versions of the reference client support at most 1200 +transitions. +.PP +A time zone abbreviation has fewer than 3 or more than 6 characters. +POSIX requires at least 3, and requires implementations to support +at least 6. .PP An output file name contains a byte that is not an ASCII letter, .q "\*-" , @@ -125,11 +226,10 @@ or it contains a file name component that contains more than 14 bytes or that starts with .q "\*-" . .RE -.TP -.B \*-s -Limit time values stored in output files to values that are the same -whether they're taken to be signed or unsigned. -You can use this option to generate SVVS-compatible files. +.SH FILES +Input files use the format described in this section; output files use +.BR tzfile (5) +format. .PP Input files should be text files, that is, they should be a series of zero or more lines, each ending in a newline byte and containing at @@ -179,7 +279,7 @@ Rule NAME FROM TO TYPE IN ON AT SAVE LETTER/S For example: .ti +.5i .sp -Rule US 1967 1973 \*- Apr lastSun 2:00w 1:00 D +Rule US 1967 1973 \*- Apr lastSun 2:00w 1:00d D .sp .fi The fields that make up a rule line are: @@ -193,7 +293,7 @@ nor .q + . To allow for future extensions, an unquoted name should not contain characters from the set -.q !$%&'()*,/:;<=>?@[\e]^`{|}~ . +.q !$%&'()*,/:;<=>?@[\e]\(ha\`{|}\(ti . .TP .B FROM Gives the first year in which the rule applies. @@ -256,12 +356,22 @@ or a weekday name preceded by (e.g., .BR "lastSunday" ) may be abbreviated or spelled out in full. -Note that there must be no spaces within the +There must be no white space characters within the .B ON field. +The +.q <= +and +.q >= +constructs can result in a day in the neighboring month; +for example, the IN-ON combination +.q "Oct Sun>=31" +stands for the first Sunday on or after October 31, +even if that Sunday occurs in November. .TP .B AT -Gives the time of day at which the rule takes effect. +Gives the time of day at which the rule takes effect, +relative to 00:00, the start of a calendar day. Recognized forms include: .nf .in +.5i @@ -270,24 +380,30 @@ Recognized forms include: 2 time in hours 2:00 time in hours and minutes 01:28:14 time in hours, minutes, and seconds -15:00 24-hour format time (for times after noon) +00:19:32.13 time with fractional seconds +12:00 midday, 12 hours after 00:00 +15:00 3 PM, 15 hours after 00:00 +24:00 end of day, 24 hours after 00:00 260:00 260 hours after 00:00 \*-2:30 2.5 hours before 00:00 \*- equivalent to 0 .fi .in -.5i .sp -where hour 0 is midnight at the start of the day, -and hour 24 is midnight at the end of the day. +Although +.B zic +rounds times to the nearest integer second +(breaking ties to the even integer), the fractions may be useful +to other applications requiring greater precision. +The source format does not specify any maximum precision. Any of these forms may be followed by the letter .B w -if the given time is local +if the given time is local or .q "wall clock" time, .B s -if the given time is local -.q "standard" -time, or +if the given time is standard time without any adjustment for daylight saving, +or .B u (or .B g @@ -295,7 +411,11 @@ or .BR z ) if the given time is universal time; in the absence of an indicator, -wall clock time is assumed. +local (wall clock) time is assumed. +These forms ignore leap seconds; for example, +if a leap second occurs at 00:59:60 local time, +.q "1:00" +stands for 3601 seconds after local midnight instead of the usual 3600 seconds. The intent is that a rule line describes the instants when a clock/calendar set to the type of time specified in the .B AT @@ -303,15 +423,20 @@ field would show the specified date and time of day. .TP .B SAVE Gives the amount of time to be added to local standard time when the rule is in -effect. +effect, and whether the resulting time is standard or daylight saving. This field has the same format as the .B AT field -(although, of course, the -.B w -and +except with a different set of suffix letters: .B s -suffixes are not used). +for standard time and +.B d +for daylight saving time. +The suffix letter is typically omitted, and defaults to +.B s +if the offset is zero and to +.B d +otherwise. Negative offsets are allowed; in Ireland, for example, daylight saving time is observed in winter and has a negative offset relative to Irish Standard Time. @@ -342,8 +467,8 @@ A zone line has the form .sp .nf .ti +.5i -.ta \w'Zone\0\0'u +\w'Asia/Amman\0\0'u +\w'UTOFF\0\0'u +\w'Jordan\0\0'u +\w'FORMAT\0\0'u -Zone NAME UTOFF RULES FORMAT [UNTIL] +.ta \w'Zone\0\0'u +\w'Asia/Amman\0\0'u +\w'STDOFF\0\0'u +\w'Jordan\0\0'u +\w'FORMAT\0\0'u +Zone NAME STDOFF RULES FORMAT [UNTIL] .sp For example: .sp @@ -352,7 +477,7 @@ Zone Asia/Amman 2:00 Jordan EE%sT 2017 Oct 27 01:00 .sp .fi The fields that make up a zone line are: -.TP "\w'UTOFF'u" +.TP "\w'STDOFF'u" .B NAME The name of the timezone. This is the name used in creating the time conversion information file for the @@ -364,8 +489,9 @@ or a file name component is a maximal substring that does not contain .q "/" . .TP -.B UTOFF -The amount of time to add to UT to get standard time. +.B STDOFF +The amount of time to add to UT to get standard time, +without any adjustment for daylight saving. This field has the same format as the .B AT and @@ -415,7 +541,7 @@ and .TP .B UNTIL The time at which the UT offset or the rule(s) change for a location. -It takes the form of YEAR [MONTH [DAY [TIME]]]. +It takes the form of one to four fields YEAR [MONTH [DAY [TIME]]]. If this is specified, the time zone information is generated from the given UT offset and rule change until the time specified, which is interpreted using @@ -440,6 +566,16 @@ continuation. .PP If a zone changes at the same instant that a rule would otherwise take effect in the earlier zone or continuation line, the rule is ignored. +A zone or continuation line +.I L +with a named rule set starts with standard time by default: +that is, any of +.IR L 's +timestamps preceding +.IR L 's +earliest rule use the rule in effect after +.IR L 's +first transition into standard time. In a single zone it is an error if two rules take effect at the same instant, or if two zone changes take effect at the same instant. .PP @@ -474,7 +610,9 @@ However, the behavior is unspecified if multiple zone or link lines define the same name, or if the source of one link line is the target of another. .PP -Lines in the file that describes leap seconds have the following form: +The file that describes leap seconds can have leap lines and an +expiration line. +Leap lines have the following form: .nf .ti +.5i .ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u @@ -513,7 +651,44 @@ or (an abbreviation of) .q "Rolling" if the leap second time given by the other fields should be interpreted as -local wall clock time. +local (wall clock) time. +.PP +The expiration line, if present, has the form: +.nf +.ti +.5i +.ta \w'Expires\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +.sp +Expires YEAR MONTH DAY HH:MM:SS +.sp +For example: +.ti +.5i +.sp +Expires 2020 Dec 28 00:00:00 +.sp +.fi +The +.BR YEAR , +.BR MONTH , +.BR DAY , +and +.B HH:MM:SS +fields give the expiration timestamp in UTC for the leap second table; +.B zic +outputs this expiration timestamp by truncating the end of the output +file to the timestamp. +If there is no expiration line, +.B zic +also accepts a comment +.q "#expires \fIE\fP ...\&" +where +.I E +is the expiration timestamp as a decimal integer count of seconds +since the Epoch, not counting leap seconds. +However, the +.q "#expires" +comment is an obsolescent feature, +and the leap second file should use an expiration line +instead of relying on a comment. .SH "EXTENDED EXAMPLE" Here is an extended example of .B zic @@ -537,10 +712,10 @@ Rule EU 1979 1995 \*- Sep lastSun 1:00u 0 \*- Rule EU 1981 max \*- Mar lastSun 1:00u 1:00 S Rule EU 1996 max \*- Oct lastSun 1:00u 0 \*- .sp -.ta \w'# Zone\0\0'u +\w'Europe/Zurich\0\0'u +\w'0:34:08\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u -# Zone NAME UTOFF RULES FORMAT [UNTIL] +.ta \w'# Zone\0\0'u +\w'Europe/Zurich\0\0'u +\w'0:29:45.50\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u +# Zone NAME STDOFF RULES FORMAT [UNTIL] Zone Europe/Zurich 0:34:08 \*- LMT 1853 Jul 16 - 0:29:46 \*- BMT 1894 Jun + 0:29:45.50 \*- BMT 1894 Jun 1:00 Swiss CE%sT 1981 1:00 EU CE%sT .sp @@ -551,9 +726,14 @@ Link Europe/Zurich Europe/Vaduz In this example, the timezone is named Europe/Zurich but it has an alias as Europe/Vaduz. This example says that Zurich was 34 minutes and 8 seconds east of UT until 1853-07-16 at 00:00, when the legal offset -was changed to 7\(de\|26\(fm\|22.50\(sd; although this works out to -0:29:45.50, the input format cannot represent fractional seconds so it -is rounded here. After 1894-06-01 at 00:00 the UT offset became one hour +was changed to +.ds o 7 degrees 26 minutes 22.50 seconds +.if \n(.g .if c \(de .if c \(fm .if c \(sd .ds o 7\(de\|26\(fm\|22.50\(sd +\*o, +which works out to 0:29:45.50; +.B zic +treats this by rounding it to 0:29:46. +After 1894-06-01 at 00:00 the UT offset became one hour and Swiss daylight saving rules (defined with lines beginning with .q "Rule Swiss") apply. From 1981 to the present, EU daylight saving rules have @@ -596,7 +776,7 @@ coincides with and is equal to a clock retreat caused by a change in UT offset, .B zic produces a single transition to daylight saving at the new UT offset -(without any change in wall clock time). +without any change in local (wall clock) time. To get separate transitions use multiple zone continuation lines specifying transition instants using universal time. @@ -606,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.07 of the Linux +This page is part of release 5.08 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 96d70a3b3..d6114112d 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-06-09 +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-08-13 diff --git a/proj.man-pages.pages b/proj.man-pages.pages index b5628e038..8cd21d5d6 100644 --- a/proj.man-pages.pages +++ b/proj.man-pages.pages @@ -59,7 +59,6 @@ man2/ioperm.2 man2/munmap.2 man2/getpmsg.2 man2/unlinkat.2 -man2/mq_unlink.2 man2/readlinkat.2 man2/signalfd4.2 man2/readv.2 @@ -106,7 +105,6 @@ man2/poll.2 man2/setreuid.2 man2/getunwind.2 man2/inw.2 -man2/mq_timedsend.2 man2/fallocate.2 man2/fchdir.2 man2/ioctl_userfaultfd.2 @@ -162,7 +160,6 @@ man2/recvmmsg.2 man2/setrlimit.2 man2/sgetmask.2 man2/oldfstat.2 -man2/mq_notify.2 man2/vm86.2 man2/epoll_create1.2 man2/subpage_prot.2 @@ -236,8 +233,6 @@ man2/recvfrom.2 man2/mlockall.2 man2/pwritev2.2 man2/munlockall.2 -man2/killpg.2 -man2/statvfs.2 man2/ftruncate64.2 man2/wait.2 man2/writev.2 @@ -279,7 +274,6 @@ man2/keyctl.2 man2/s390_runtime_instr.2 man2/newfstatat.2 man2/settimeofday.2 -man2/sethostid.2 man2/llistxattr.2 man2/pwritev.2 man2/msgsnd.2 @@ -313,11 +307,9 @@ man2/mq_getsetattr.2 man2/gettimeofday.2 man2/setns.2 man2/wait4.2 -man2/getcontext.2 man2/rt_sigqueueinfo.2 man2/utime.2 man2/getrlimit.2 -man2/fstatvfs.2 man2/kcmp.2 man2/reboot.2 man2/eventfd.2 @@ -344,12 +336,10 @@ man2/waitid.2 man2/inw_p.2 man2/_Exit.2 man2/rt_sigpending.2 -man2/mq_open.2 man2/fattach.2 man2/chdir.2 man2/userfaultfd.2 man2/faccessat.2 -man2/getdtablesize.2 man2/restart_syscall.2 man2/setreuid32.2 man2/getegid.2 @@ -365,7 +355,6 @@ man2/bdflush.2 man2/clock_getres.2 man2/fgetxattr.2 man2/posix_fadvise.2 -man2/getcwd.2 man2/geteuid.2 man2/getmsg.2 man2/fremovexattr.2 @@ -387,12 +376,10 @@ man2/stat64.2 man2/tee.2 man2/syslog.2 man2/tuxcall.2 -man2/mq_timedreceive.2 man2/_llseek.2 man2/ioctl_fslabel.2 man2/gettid.2 man2/fstatat64.2 -man2/gethostid.2 man2/ptrace.2 man2/getxattr.2 man2/quotactl.2 @@ -416,7 +403,6 @@ man2/exit_group.2 man2/ugetrlimit.2 man2/insb.2 man2/process_vm_readv.2 -man2/setcontext.2 man2/capget.2 man2/getrusage.2 man2/setgid32.2 @@ -457,7 +443,6 @@ man2/request_key.2 man2/inotify_add_watch.2 man2/sigtimedwait.2 man2/pidfd_getfd.2 -man2/sigqueue.2 man2/capset.2 man2/llseek.2 man2/arm_fadvise.2 @@ -960,7 +945,6 @@ man3/getopt_long.3 man3/optind.3 man3/fgetspent.3 man3/strncpy.3 -man3/clock_gettime.3 man3/mallinfo.3 man3/ruserok_af.3 man3/llroundl.3 @@ -1817,7 +1801,6 @@ man3/erf.3 man3/setmntent.3 man3/pthread_cleanup_push_defer_np.3 man3/reallocarray.3 -man3/clock_settime.3 man3/clnt_freeres.3 man3/memset.3 man3/xdr_u_long.3 @@ -2131,7 +2114,6 @@ man3/xdr_bytes.3 man3/csinhf.3 man3/ether_ntoa.3 man3/endusershell.3 -man3/clock_getres.3 man3/initstate.3 man3/fsetpos.3 man3/rewind.3 @@ -2203,10 +2185,8 @@ man5/shells.5 man5/protocols.5 man5/host.conf.5 man5/charmap.5 -man5/numa_maps.5 man5/issue.5 man5/resolver.5 -man5/attr.5 man5/networks.5 man5/filesystems.5 man5/hosts.5 diff --git a/scripts/convert_to_utf_8.sh b/scripts/convert_to_utf_8.sh index b8a5e83ba..28f5a72cf 100755 --- a/scripts/convert_to_utf_8.sh +++ b/scripts/convert_to_utf_8.sh @@ -33,7 +33,7 @@ fi out_dir="$1" shift -enc_line="'\\\" t -*- coding: UTF-8 -*-" +enc_line="" for f in "$@"; do enc=$(file -bi "$f" | cut -d = -f 2) |