diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-06-22 13:04:07 +1200 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-06-22 13:04:07 +1200 |
commit | 33248cfe50ebb8762208e7ef3264676dad71b016 (patch) | |
tree | eb793a1f8cb1def496ac27c3e4486e98955b60ff /Changes | |
parent | d49f2ba7853c588eccce94c28659389e77a01819 (diff) |
Start of man-pages-5.13: updating Changes and Changes.old
Diffstat (limited to 'Changes')
-rw-r--r-- | Changes | 359 |
1 files changed, 2 insertions, 357 deletions
@@ -1,6 +1,6 @@ -==================== Changes in man-pages-5.12 ==================== +==================== Changes in man-pages-5.13 ==================== -Released: 2021-06-20, Christchurch +Released: ????-??-??, Munich Contributors @@ -10,45 +10,6 @@ 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> -Akihiro Motoki <amotoki@gmail.com> -Alejandro Colomar <alx.manpages@gmail.com> -Alyssa Ross <hi@alyssa.is> -Aurelien Aptel <aaptel@suse.com> -Borislav Petkov <bp@suse.de> -Bruce Merry <bmerry@ska.ac.za> -Chris Keilbart <keilbartchris@gmail.com> -Christian Brauner <christian@brauner.io> -Christoph Anton Mitterer <calestyo@scientia.net> -dann frazier <dann.frazier@canonical.com> -Dmitry V. Levin <ldv@altlinux.org> -Florian Weimer <fw@deneb.enyo.de> -Huang Ying <ying.huang@intel.com> -Jakub Wilk <jwilk@jwilk.net> -James O. D. Hunt <jamesodhunt@gmail.com> -Jann Horn <jannh@google.com> -Johannes Berg <johannes@sipsolutions.net> -Jon Murphy <jonmurphy1618@gmail.com> -Josh Triplett <josh@joshtriplett.org> -Katsuhiro Numata <byakkomon@gmail.com> -Kees Cook <keescook@chromium.org> -Mark Kettenis <kettenis@openbsd.org> -Mathieu Desnoyers <mathieu.desnoyers@efficios.com> -Michael Kerrisk <mtk.manpages@gmail.com> -Mike Rapoport <rppt@linux.vnet.ibm.com> -Peter Xu <peterx@redhat.com> -Sargun Dhillon <sargun@sargun.me> -Stefan Puiu <stefan.puiu@gmail.com> -Štěpán Němec <stepnem@gmail.com> -thomasavoss <thomasavoss@protonmail.com> -Topi Miettinen <toiwoton@gmail.com> -Tycho Andersen <tycho@tycho.pizza> -Utkarsh Singh <utkarsh190601@gmail.com> -Vishwajith K <vishuvikas1996@gmail.com> -Walter Harms <wharms@bfs.de> -Yang Xu <xuyang2018.jy@fujitsu.com> -Zhiheng Li <phoenix_lzh@sina.com> -наб <nabijaczleweli@nabijaczleweli.xyz> Apologies if I missed anyone! @@ -56,335 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -seccomp_unotify.2 - Michael Kerrisk [Tycho Andersen, Jann Horn, Kees Cook, Christian Brauner - Sargun Dhillon] - New page documenting the seccomp user-space notification mechanism - -MAX.3 - Alejandro Colomar - New page to document MAX() and MIN() - Newly documented interfaces in existing pages --------------------------------------------- -seccomp.2 - Tycho Andersen [MichaelKerrisk] - Document SECCOMP_GET_NOTIF_SIZES - Tycho Andersen - Document SECCOMP_FILTER_FLAG_NEW_LISTENER [Michael Kerrisk] - Tycho Andersen - Document SECCOMP_RET_USER_NOTIF [Michael Kerrisk] - -set_mempolicy.2 - Huang Ying [Alejandro Colomar, "Huang, Ying"] - Add mode flag MPOL_F_NUMA_BALANCING - -userfaultfd.2 - Peter Xu [Alejandro Colomar, Mike Rapoport] - Add UFFD_FEATURE_THREAD_ID docs - Peter Xu [Alejandro Colomar, Mike Rapoport] - Add write-protect mode docs - -proc.5 - Michael Kerrisk - Document /proc/sys/vm/sysctl_hugetlb_shm_group - -system_data_types.7 - Alejandro Colomar - Add 'blksize_t' - Alejandro Colomar - Add 'blkcnt_t' - Alejandro Colomar - Add 'mode_t' - Alejandro Colomar - Add 'struct sockaddr' - Alejandro Colomar - Add 'cc_t' - Alejandro Colomar - Add 'socklen_t' - New and changed links --------------------- -blkcnt_t.3 - Alejandro Colomar - New link to system_data_types(7) - -blksize_t.3 - Alejandro Colomar - New link to system_data_types(7) - -cc_t.3 - Alejandro Colomar - New link to system_data_types(7) - -MIN.3 - Michael Kerrisk - New link to MIN.3 - -mode_t.3 - Alejandro Colomar - New link to system_data_types(7) - -sockaddr.3 - Alejandro Colomar - New link to system_data_types(7) - -socklen_t.3 - Alejandro Colomar - New link to system_data_types(7) - Global changes -------------- -Many pages - Alejandro Colomar - SYNOPSIS: Use syscall(SYS_...); for system calls without a wrapper - -Many pages - Alejandro Colomar - SYNOPSIS: Document why each header is required - -Many pages - Alejandro Colomar - SYNOPSIS: Remove unused includes - -Various pages - Alejandro Colomar - Add note about the use of syscall(2) - -Various pages - Alejandro Colomar - SYNOPSIS: Miscellaneous fixes to includes - -A few pages - Alejandro Colomar - SYNOPSIS: Add missing 'const' - Changes to individual pages --------------------------- -dup.2 - Michael Kerrisk - Rewrite the description of dup() somewhat - As can be seen by any number of StackOverflow questions, people - persistently misunderstand what dup() does, and the existing manual - page text, which talks of "copying" a file descriptor doesn't help. - Rewrite the text a little to try to prevent some of these - misunderstandings, in particular noting at the start that dup() - allocates a new file descriptor. - Michael Kerrisk - Clarify what silent closing means - Alejandro Colomar - SYNOPSIS: Use consistent comments through pages - -epoll_wait.2 - Alejandro Colomar - Move misplaced subsection to NOTES from BUGS - -execveat.2 - Michael Kerrisk - Library support has been added in glibc 2.34 - -_exit.2 - Michael Kerrisk - Add a little more detail on the raw _exit() system cal - -exit_group.2 - Alejandro Colomar - Use 'noreturn' in prototypes - -flock.2 - Aurelien Aptel [Alejandro Colomar] - Add CIFS details - CIFS flock() locks behave differently than the standard. - Give an overview of those differences. - -ioperm.2 - Alejandro Colomar - Remove obvious comment - -memfd_create.2 -mmap.2 -shmget.2 - Michael Kerrisk [Yang Xu] - Document the EPERM error for huge page allocations - This error can occur if the caller is does not have CAP_IPC_LOCK - and is not a member of the sysctl_hugetlb_shm_group. - -mmap.2 - Bruce Merry - Clarify that MAP_POPULATE is best-effort - -mount.2 - Topi Miettinen - Document SELinux use of MS_NOSUID mount flag - -open.2 - Alejandro Colomar [Walter Harms] - Fix bug in linkat(2) call example - AT_EMPTY_PATH works with empty strings (""), but not with NULL - (or at least it's not obvious). - Michael Kerrisk - Make it clearer that an FD is an index into the process's FD table - Sometimes people are confused, thinking a file descriptor is just a - number.... - -perfmonctl.2 - Michael Kerrisk - This system call was removed in Linux 5.10 - -pipe.2 - Alejandro Colomar - SYNOPSIS: Fix incorrect prototype - Michael Kerrisk - Rearrange SYNOPSIS so that minority version pipe() is at end - -ptrace.2 - Dmitry V. Levin [Alejandro Colomar, Mathieu Desnoyers] - Mention PTRACE_GET_SYSCALL_INFO in RETURN VALUE section - -seccomp.2 - Michael Kerrisk - Reorder list of SECCOMP_SET_MODE_FILTER flags alphabetically - (No content changes.) - Michael Kerrisk - SEE ALSO: add seccomp_unotify(2) - -select.2 - Michael Kerrisk - Strengthen the warning regarding the low value of FD_SETSIZE - All modern code should avoid select(2) in favor of poll(2) - or epoll(7). - Michael Kerrisk - Relocate sentence about the fd_set value-result arguments to BUGS - -syscalls.2 - Michael Kerrisk - perfmonctl(2) was removed in Linux 5.10 - -bswap.3 - Alejandro Colomar - bswap_*() are implemented using functions - Even though it's true that they are macros, - it's transparent to the user. - - The user will see their results casted to unsigned types - after the conversion due to the underlying functions, - so it's better to document these as the underlying functions, - specifying the types. - -cmsg.3 -unix.7 - Michael Kerrisk - Refer to seccomp_unotify(2) for an example of SCM_RIGHTS usage - -cpow.3 - Alejandro Colomar - Use 'complex' after the type consistently - -ctime.3 - Michael Kerrisk [Katsuhiro Numata] - Restore documentation of 'tm_gmtoff' field - -errno.3 - Alejandro Colomar [Florian Weimer, Mark Kettenis] - Fix ENODATA text - ENODATA is an XSI STREAMS extension (not base POSIX). - -exec.3 - Josh Triplett [Alejandro Colomar] - Clarify that execvpe() uses PATH from the caller, not envp - Josh Triplett [Alejandro Colomar] - Fix description of 'e' variants - The envp argument specifies the environment of the new process - image, not "the environment of the caller". - -fflush.3 - Alejandro Colomar - SEE ALSO: Add fpurge(3) - -getline.3 - наб [Ahelenia Ziemiańska, Alejandro Colomar] - !*lineptr is sufficient - No implementation or spec requires *n to be 0 to allocate - a new buffer. - -getopt.3 - James O. D. Hunt [Alejandro Colomar] - Clarify behaviour - -printf.3 - Utkarsh Singh [Alejandro Colomar] - Add overall structure of format string - -pthread_attr_setinheritsched.3 -pthread_attr_setschedparam.3 - Alejandro Colomar - SYNOPSIS: Use 'restrict' in prototypes - -pthread_mutexattr_setrobust.3 - Michael Kerrisk - Note that the *_np() APIs are deprecated since glibc 2.34 - Alejandro Colomar - SYNOPSIS: Remove incorrect 'const' - -pthread_mutex_consistent.3 - Michael Kerrisk - Note that pthread_mutexattr_setrobust() is now deprecated - -pthread_yield.3 - Michael Kerrisk - Note that this function is deprecated since glibc 2.34 - -rpc.3 - Alejandro Colomar - SYNOPSIS: Fix prototypes (misc.) - -scanf.3 - Alyssa Ross [Alejandro Colomar] - Clarify that %n supports type modifiers - -xdr.3 - Alejandro Colomar - SYNOPSIS: Fix prototype types - Use the same types glibc uses, and add a missing 'const'. - -capabilities.7 - Michael Kerrisk - CAP_IPC_LOCK also governs memory allocation using huge pages - -environ.7 - Josh Triplett [Alejandro Colomar] - Remove obsolete admonishment of the GZIP environment variable - -kernel_lockdown.7 - dann frazier [Alejandro Colomar] - Remove description of lifting via SysRq (not upstream) - The patch that implemented lockdown lifting via SysRq ended up - getting dropped[*] before the feature was merged upstream. Having - the feature documented but unsupported has caused some confusion - for our users. - -mount_namespaces.7 -namespaces.7 - Michael Kerrisk - Relocate reference to pam_namespace(8) from namespaces.7 to - mount_namespaces.7. - -signal.7 - Michael Kerrisk - Add reference to seccomp_unotify(2) - The seccomp user-space notification feature can cause changes in - the semantics of SA_RESTART with respect to system calls that - would never normally be restarted. Point the reader to the page - that provide further details. - -vsock.7 - Alyssa Ross - ioctls are on /dev/vsock, not sockets |