-==================== Changes in man-pages-5.10 ====================
+==================== Changes in man-pages-5.11 ====================
-Released: 2020-12-21, Munich
+Released: ????-??-??, Munich
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
-Alejandro Colomar <alx.manpages@gmail.com>
-Amir Goldstein <amir73il@gmail.com>
-Arusekk <arek_koz@o2.pl>
-Baruch Siach <baruch@tkos.co.il>
-Bill Allombert <ballombe@debian.org>
-Colin Ian King <colin.king@canonical.com>
-Dave Martin <Dave.Martin@arm.com>
-Davide Giorgio <davide@giorgiodavide.it>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-Jan Kara <jack@suse.cz>
-Jing Peng <pj.hades@gmail.com>
-John A. Leuenhagen <john@zlima12.com>
-Mathias Rav <m@git.strova.dk>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Mike Crowe <mac@mcrowe.com>
-Namhyung Kim <namhyung@gmail.com>
-Peter Oskolkov <posk@google.com>
-Philip Rowlands <linux-kernel@dimebar.com>
-Rob Landley <rob@landley.net>
-Ross Zwisler <zwisler@chromium.org>
-Sebastian Kirmayer <sebastian@kirmayer.de>
-наб <nabijaczleweli@nabijaczleweli.xyz>
Apologies if I missed anyone!
-Newly documented interfaces in existing pages
----------------------------------------------
+New and rewritten pages
+-----------------------
-access.2
- Michael Kerrisk
- Document faccessat2()
- faccessat2() was added in Linux 5.8 and enables a fix to
- longstanding bugs in the faccessat() wrapper function.
-membarrier.2
- Peter Oskolkov [Alejandro Colomar]
- Update for Linux 5.10
- Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840
- (part of 5.10 release) changed sys_membarrier prototype/parameters
- and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ
- and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ].
+Newly documented interfaces in existing pages
+---------------------------------------------
New and changed links
---------------------
-faccessat2.2
- Michael Kerrisk
- New link to access.2
-
-CIRCLEQ_EMPTY.3
-CIRCLEQ_FIRST.3
-CIRCLEQ_FOREACH.3
-CIRCLEQ_FOREACH_REVERSE.3
-CIRCLEQ_HEAD_INITIALIZER.3
-CIRCLEQ_LAST.3
-CIRCLEQ_LOOP_NEXT.3
-CIRCLEQ_LOOP_PREV.3
-CIRCLEQ_NEXT.3
-CIRCLEQ_PREV.3
- Michael Kerrisk
- Add missing links to circleq.3
-
-pthread_attr_getsigmask_np.3
- Michael Kerrisk
- New link to pthread_attr_setsigmask_np.3
-
Global changes
--------------
-Various pages
- Alejandro Colomar
- Use Oxford comma
-
Changes to individual pages
---------------------------
-access.2
- Michael Kerrisk
- BUGS: note that faccessat() wrapper function emulation ignores ACLs
-
-bpf.2
- Michael Kerrisk
- Place EXAMPLES section in correct location
-
-cacheflush.2
- Alejandro Colomar
- Document Architecture-specific variants
- Alejandro Colomar [Heinrich Schuchardt]
- Document __builtin___clear_cache() as a more portable alternative
-
-chroot.2
-memfd_create.2
-tailq.3
- Michael Kerrisk [Alejandro Colomar]
- Fix unbalanced .nf/.fi
-
-clock_getres.2
- Michael Kerrisk
- Place ERRORS in alphabetical order
-
-clone.2
-sigaltstack.2
- Michael Kerrisk
- clone(CLONE_VM) disables the alternate signal stack
-
-getrlimit.2
- Michael Kerrisk
- State more precisely the range of kernel versions that had RLIMIT_LOCKS
-
-getrusage.2
- Michael Kerrisk
- Note that the 'vtimes' symbol exists only up to glibc 2.32
-
-io_cancel.2
-io_destroy.2
-io_getevents.2
-io_setup.2
-io_submit.2
- Alejandro Colomar
- SYNOPSIS: s/io_context_t/aio_context_t/
- Linux uses aio_context_t for these syscalls,
- and it's the type provided by <linux/aio_abi.h>.
- Use it in the SYNOPSIS.
-
- libaio uses 'io_context_t', but that difference is already noted
- in NOTES.
-
-io_setup.2
- Alejandro Colomar
- SYNOPSIS: return long
-
-link.2
- Mathias Rav
- ERRORS: add ENOENT when target is deleted
- Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part
- of kernel release v2.6.39) added a check to disallow creating a
- hard link to an unlinked file.
-
-llseek.2
- Michael Kerrisk
- Note size of 'loff_t' type
- Michael Kerrisk
- Point the reader to lseek64(3) for info about llseek(3)
- Michael Kerrisk
- Some mild rewriting to ease reading of the info in this page
-
-mmap.2
- Michael Kerrisk
- Clarify SIGBUS text and treatment of partial page at end of a mapping
-
-mount.2
-statfs.2
- Ross Zwisler
- Add NOSYMFOLLOW flags to mount(2) and statfs(2)
-
-msgctl.2
- Michael Kerrisk
- Make comments in 'msqid_ds' definition more compact
- Michael Kerrisk
- Place list of field descriptions in same order as structure definition
- Michael Kerrisk
- Use field name "msg_cbytes" rather than "__msg_cbytes"
- Michael Kerrisk
- Add description of 'msg_cbytes' field
-
-openat.2
- Colin Ian King
- Fix include path, should be linux/openat2.h
-
-perf_event_open.2
- Namhyung Kim [Alejandro Colomar]
- Update man page with recent kernel changes
- Alejandro Colomar
- Assign calculated value explicitly to 'config'
-
-restart_syscall.2
- Alejandro Colomar
- SYNOPSIS: Fix restart_syscall() return type
-
-set_tid_address.2
- Alejandro Colomar
- SYNOPSIS: Fix set_tid_address() return type
-
-shmctl.2
- Michael Kerrisk
- Place list of field descriptions in same order as structure definition
-
-sigaction.2
- Michael Kerrisk
- Clarify description of SA_NODEFER
- Clarify description of SA_NODEFER, and note interaction with
- act.sa_mask.
- Michael Kerrisk
- Add a cross-reference to signal(7) for further info on 'ucontext_t'
-
-sigaltstack.2
- Michael Kerrisk
- Clarify that the alternate signal stack is per-thread
- Clarify that the alternate signal stack is per-thread (rather
- than process-wide).
-
-spu_create.2
- Michael Kerrisk
- Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM
- Michael Kerrisk
- Relocate paragraph on 'mode' argument
- Michael Kerrisk [Alejandro Colomar]
- Clarify that spu_create() now has 4 arguments but once had only 3
-
-subpage_prot.2
- Alejandro Colomar
- SYNOPSIS: Fix return type: s/long/int/
-
-syscalls.2
- Michael Kerrisk
- Add process_madvise()
- Michael Kerrisk
- Note that sysctl() was removed in Linux 5.5
-
-timer_getoverrun.2
- Michael Kerrisk
- timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX
- See https://bugzilla.kernel.org/show_bug.cgi?id=12665.
-
-uselib.2
-posix_memalign.3
-profil.3
-rtime.3
- Michael Kerrisk
- Remove some text about libc/libc5
- With this change, there remain almost no vestiges of information
- about the long defunct Linux libc.
-
-errno.3
- Michael Kerrisk
- Note another possible cause of the EMFILE error
-
-getcontext.3
- Michael Kerrisk
- Mention SA_SIGINFO flag when talking about 3-argument signal handler
- Michael Kerrisk
- SEE ALSO: add signal(7)
-
-list.3
- Michael Kerrisk
- NAME: remove LIST_PREV, which is not documented in this page
-
-lseek64.3
- Michael Kerrisk
- Remove section numbers from interface list
- Michael Kerrisk
- Remove sentence saying lseek64() is an alias for llseek()
- Michael Kerrisk
- NOTES: describe the origin of lseek64() in LFS
-
-nextafter.3
- Michael Kerrisk
- Remove duplicate "BUGS" section heading
-
-pthread_tryjoin_np.3
- Michael Kerrisk [Mike Crowe]
- Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug
-
-rcmd.3
- Michael Kerrisk
- SEE ALSO: remove intro(2)
-
-strnlen.3
- Michael Kerrisk [Heinrich Schuchardt]
- Fix a small inconsistency in the text
-
-elf.5
- Michael Kerrisk
- SEE ALSO: add objcopy(1)
-
-filesystems.5
- Ahelenia Ziemiańska [Alejandro Colomar]
- Fix link to user space tooling for ncpfs
- Ahelenia Ziemiańska [Alejandro Colomar]
- Note ncpfs removal from kernel
-
-attributes.7
- Michael Kerrisk
- SEE ALSO: add signal-safety(7)
-
-fanotify.7
- Amir Goldstein [Jan Kara]
- fix outdated description
-
-kernel_lockdown.7
- Michael Kerrisk
- Remove unneeded quotes
-
-packet.7
- Baruch Siach [Alejandro Colomar]
- Update references to kernel documentation
-
-pthreads.7
- Michael Kerrisk
- Rephrase function list in terms of POSIX rather than SUS
- The list was using an inconsistent mixture of "POSIX" and "SUS".
-
-signal.7
- Michael Kerrisk [Heinrich Schuchardt, Dave Martin]
- Add some details on the execution of signal handlers
- Add a "big picture" of what happens when a signal handler
- is invoked.
- Michael Kerrisk
- Add pidfd_send_signal() to list of APIs for sending signals
- Michael Kerrisk
- Mention 'ucontext_t' in the discussion of signal handler execution
- Michael Kerrisk
- SEE ALSO: add swapcontext(3)
-
-signal-safety.7
- Michael Kerrisk
- Note async-signal-safety details for errno
-
-standards.7
- Michael Kerrisk
- Add URL for POSIX.1-2008/SUSv4
- Michael Kerrisk
- Add LFS (Large File Summit)
- Michael Kerrisk [Rob Landley]
- Fix some URLs for locations of the standards
- Michael Kerrisk
- Relocate the discussion on POSIX manual pages
-
-tcp.7
- Alejandro Colomar [Philip Rowlands]
- tcp_syncookies: It is now an integer [0, 2]
- Since Linux kernel 3.12, tcp_syncookies can have the value 2,
- which sends out cookies unconditionally.
socket.7
Michael Kerrisk
SEE ALSO: add ipv6(7)
+
+
+==================== Changes in man-pages-5.10 ====================
+
+Released: 2020-12-21, 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:
+
+Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
+Alejandro Colomar <alx.manpages@gmail.com>
+Amir Goldstein <amir73il@gmail.com>
+Arusekk <arek_koz@o2.pl>
+Baruch Siach <baruch@tkos.co.il>
+Bill Allombert <ballombe@debian.org>
+Colin Ian King <colin.king@canonical.com>
+Dave Martin <Dave.Martin@arm.com>
+Davide Giorgio <davide@giorgiodavide.it>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Jan Kara <jack@suse.cz>
+Jing Peng <pj.hades@gmail.com>
+John A. Leuenhagen <john@zlima12.com>
+Mathias Rav <m@git.strova.dk>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Crowe <mac@mcrowe.com>
+Namhyung Kim <namhyung@gmail.com>
+Peter Oskolkov <posk@google.com>
+Philip Rowlands <linux-kernel@dimebar.com>
+Rob Landley <rob@landley.net>
+Ross Zwisler <zwisler@chromium.org>
+Sebastian Kirmayer <sebastian@kirmayer.de>
+наб <nabijaczleweli@nabijaczleweli.xyz>
+
+Apologies if I missed anyone!
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+access.2
+ Michael Kerrisk
+ Document faccessat2()
+ faccessat2() was added in Linux 5.8 and enables a fix to
+ longstanding bugs in the faccessat() wrapper function.
+
+membarrier.2
+ Peter Oskolkov [Alejandro Colomar]
+ Update for Linux 5.10
+ Linux kernel commit 2a36ab717e8fe678d98f81c14a0b124712719840
+ (part of 5.10 release) changed sys_membarrier prototype/parameters
+ and added two new commands [MEMBARRIER_CMD_PRIVATE_EXPEDITED_RSEQ
+ and MEMBARRIER_CMD_REGISTER_PRIVATE_EXPEDITED_RSEQ].
+
+
+New and changed links
+---------------------
+
+faccessat2.2
+ Michael Kerrisk
+ New link to access.2
+
+CIRCLEQ_EMPTY.3
+CIRCLEQ_FIRST.3
+CIRCLEQ_FOREACH.3
+CIRCLEQ_FOREACH_REVERSE.3
+CIRCLEQ_HEAD_INITIALIZER.3
+CIRCLEQ_LAST.3
+CIRCLEQ_LOOP_NEXT.3
+CIRCLEQ_LOOP_PREV.3
+CIRCLEQ_NEXT.3
+CIRCLEQ_PREV.3
+ Michael Kerrisk
+ Add missing links to circleq.3
+
+pthread_attr_getsigmask_np.3
+ Michael Kerrisk
+ New link to pthread_attr_setsigmask_np.3
+
+
+Global changes
+--------------
+
+Various pages
+ Alejandro Colomar
+ Use Oxford comma
+
+
+Changes to individual pages
+---------------------------
+
+access.2
+ Michael Kerrisk
+ BUGS: note that faccessat() wrapper function emulation ignores ACLs
+
+bpf.2
+ Michael Kerrisk
+ Place EXAMPLES section in correct location
+
+cacheflush.2
+ Alejandro Colomar
+ Document Architecture-specific variants
+ Alejandro Colomar [Heinrich Schuchardt]
+ Document __builtin___clear_cache() as a more portable alternative
+
+chroot.2
+memfd_create.2
+tailq.3
+ Michael Kerrisk [Alejandro Colomar]
+ Fix unbalanced .nf/.fi
+
+clock_getres.2
+ Michael Kerrisk
+ Place ERRORS in alphabetical order
+
+clone.2
+sigaltstack.2
+ Michael Kerrisk
+ clone(CLONE_VM) disables the alternate signal stack
+
+getrlimit.2
+ Michael Kerrisk
+ State more precisely the range of kernel versions that had RLIMIT_LOCKS
+
+getrusage.2
+ Michael Kerrisk
+ Note that the 'vtimes' symbol exists only up to glibc 2.32
+
+io_cancel.2
+io_destroy.2
+io_getevents.2
+io_setup.2
+io_submit.2
+ Alejandro Colomar
+ SYNOPSIS: s/io_context_t/aio_context_t/
+ Linux uses aio_context_t for these syscalls,
+ and it's the type provided by <linux/aio_abi.h>.
+ Use it in the SYNOPSIS.
+
+ libaio uses 'io_context_t', but that difference is already noted
+ in NOTES.
+
+io_setup.2
+ Alejandro Colomar
+ SYNOPSIS: return long
+
+link.2
+ Mathias Rav
+ ERRORS: add ENOENT when target is deleted
+ Linux kernel commit aae8a97d3ec30788790d1720b71d76fd8eb44b73 (part
+ of kernel release v2.6.39) added a check to disallow creating a
+ hard link to an unlinked file.
+
+llseek.2
+ Michael Kerrisk
+ Note size of 'loff_t' type
+ Michael Kerrisk
+ Point the reader to lseek64(3) for info about llseek(3)
+ Michael Kerrisk
+ Some mild rewriting to ease reading of the info in this page
+
+mmap.2
+ Michael Kerrisk
+ Clarify SIGBUS text and treatment of partial page at end of a mapping
+
+mount.2
+statfs.2
+ Ross Zwisler
+ Add NOSYMFOLLOW flags to mount(2) and statfs(2)
+
+msgctl.2
+ Michael Kerrisk
+ Make comments in 'msqid_ds' definition more compact
+ Michael Kerrisk
+ Place list of field descriptions in same order as structure definition
+ Michael Kerrisk
+ Use field name "msg_cbytes" rather than "__msg_cbytes"
+ Michael Kerrisk
+ Add description of 'msg_cbytes' field
+
+openat.2
+ Colin Ian King
+ Fix include path, should be linux/openat2.h
+
+perf_event_open.2
+ Namhyung Kim [Alejandro Colomar]
+ Update man page with recent kernel changes
+ Alejandro Colomar
+ Assign calculated value explicitly to 'config'
+
+restart_syscall.2
+ Alejandro Colomar
+ SYNOPSIS: Fix restart_syscall() return type
+
+set_tid_address.2
+ Alejandro Colomar
+ SYNOPSIS: Fix set_tid_address() return type
+
+shmctl.2
+ Michael Kerrisk
+ Place list of field descriptions in same order as structure definition
+
+sigaction.2
+ Michael Kerrisk
+ Clarify description of SA_NODEFER
+ Clarify description of SA_NODEFER, and note interaction with
+ act.sa_mask.
+ Michael Kerrisk
+ Add a cross-reference to signal(7) for further info on 'ucontext_t'
+
+sigaltstack.2
+ Michael Kerrisk
+ Clarify that the alternate signal stack is per-thread
+ Clarify that the alternate signal stack is per-thread (rather
+ than process-wide).
+
+spu_create.2
+ Michael Kerrisk
+ Add kernel version numbers for SPU_CREATE_AFFINITY_SPU/_MEM
+ Michael Kerrisk
+ Relocate paragraph on 'mode' argument
+ Michael Kerrisk [Alejandro Colomar]
+ Clarify that spu_create() now has 4 arguments but once had only 3
+
+subpage_prot.2
+ Alejandro Colomar
+ SYNOPSIS: Fix return type: s/long/int/
+
+syscalls.2
+ Michael Kerrisk
+ Add process_madvise()
+ Michael Kerrisk
+ Note that sysctl() was removed in Linux 5.5
+
+timer_getoverrun.2
+ Michael Kerrisk
+ timer_getoverrun() now clamps the overrun count to DELAYTIMER_MAX
+ See https://bugzilla.kernel.org/show_bug.cgi?id=12665.
+
+uselib.2
+posix_memalign.3
+profil.3
+rtime.3
+ Michael Kerrisk
+ Remove some text about libc/libc5
+ With this change, there remain almost no vestiges of information
+ about the long defunct Linux libc.
+
+errno.3
+ Michael Kerrisk
+ Note another possible cause of the EMFILE error
+
+getcontext.3
+ Michael Kerrisk
+ Mention SA_SIGINFO flag when talking about 3-argument signal handler
+ Michael Kerrisk
+ SEE ALSO: add signal(7)
+
+list.3
+ Michael Kerrisk
+ NAME: remove LIST_PREV, which is not documented in this page
+
+lseek64.3
+ Michael Kerrisk
+ Remove section numbers from interface list
+ Michael Kerrisk
+ Remove sentence saying lseek64() is an alias for llseek()
+ Michael Kerrisk
+ NOTES: describe the origin of lseek64() in LFS
+
+nextafter.3
+ Michael Kerrisk
+ Remove duplicate "BUGS" section heading
+
+pthread_tryjoin_np.3
+ Michael Kerrisk [Mike Crowe]
+ Note that pthread_timedjoin_np() uses CLOCK_REALTIME, but there's a bug
+
+rcmd.3
+ Michael Kerrisk
+ SEE ALSO: remove intro(2)
+
+strnlen.3
+ Michael Kerrisk [Heinrich Schuchardt]
+ Fix a small inconsistency in the text
+
+elf.5
+ Michael Kerrisk
+ SEE ALSO: add objcopy(1)
+
+filesystems.5
+ Ahelenia Ziemiańska [Alejandro Colomar]
+ Fix link to user space tooling for ncpfs
+ Ahelenia Ziemiańska [Alejandro Colomar]
+ Note ncpfs removal from kernel
+
+attributes.7
+ Michael Kerrisk
+ SEE ALSO: add signal-safety(7)
+
+fanotify.7
+ Amir Goldstein [Jan Kara]
+ fix outdated description
+
+kernel_lockdown.7
+ Michael Kerrisk
+ Remove unneeded quotes
+
+packet.7
+ Baruch Siach [Alejandro Colomar]
+ Update references to kernel documentation
+
+pthreads.7
+ Michael Kerrisk
+ Rephrase function list in terms of POSIX rather than SUS
+ The list was using an inconsistent mixture of "POSIX" and "SUS".
+
+signal.7
+ Michael Kerrisk [Heinrich Schuchardt, Dave Martin]
+ Add some details on the execution of signal handlers
+ Add a "big picture" of what happens when a signal handler
+ is invoked.
+ Michael Kerrisk
+ Add pidfd_send_signal() to list of APIs for sending signals
+ Michael Kerrisk
+ Mention 'ucontext_t' in the discussion of signal handler execution
+ Michael Kerrisk
+ SEE ALSO: add swapcontext(3)
+
+signal-safety.7
+ Michael Kerrisk
+ Note async-signal-safety details for errno
+
+standards.7
+ Michael Kerrisk
+ Add URL for POSIX.1-2008/SUSv4
+ Michael Kerrisk
+ Add LFS (Large File Summit)
+ Michael Kerrisk [Rob Landley]
+ Fix some URLs for locations of the standards
+ Michael Kerrisk
+ Relocate the discussion on POSIX manual pages
+
+tcp.7
+ Alejandro Colomar [Philip Rowlands]
+ tcp_syncookies: It is now an integer [0, 2]
+ Since Linux kernel 3.12, tcp_syncookies can have the value 2,
+ which sends out cookies unconditionally.
projects / thirdparty / man-pages.git / commitdiff
