diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2016-10-08 13:33:57 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2016-10-08 14:08:24 +0200 |
| commit | 604313328302a5735ee0ec61b7e46ceb25005147 (patch) | |
| tree | 8e7f903a71e365b283824c8f8916cb682d17d0d6 | |
| parent | 1a4ae43232624543c1958d26a040544edab916af (diff) | |
| download | man-pages-604313328302a5735ee0ec61b7e46ceb25005147.tar.gz | |
Start of man-pages-4.09: updating Changes and Changes.old
| -rw-r--r-- | Changes | 554 | ||||
| -rw-r--r-- | Changes.old | 587 |
2 files changed, 589 insertions, 552 deletions
@@ -1,6 +1,6 @@ -==================== Changes in man-pages-4.08 ==================== +==================== Changes in man-pages-4.09 ==================== -Released: 2016-10-08, Munich +Released: ????-??-??, Munich Contributors @@ -10,46 +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: -Arnaud Gaillard <arnaud.mgaillard@gmail.com> -Bill Pemberton <wfp5p@worldbroken.com> -Carlos O'Donell <carlos@redhat.com> -Christoph Hellwig <hch@lst.de> -David Turner <novalis@novalis.org> -Dr. Tobias Quathamer <toddy@debian.org> -Elliott Hughes <enh@google.com> -Eugene Syromyatnikov <evgsyr@gmail.com> -Heinrich Schuchardt <xypron.glpk@gmx.de> -Hu Keping <hukeping@huawei.com> -Igor Liferenko <igor.liferenko@gmail.com> -Ivan Kharpalev <ivan.kharpalev@gmail.com> -Jakub Wilk <jwilk@jwilk.net> -Jann Horn <jann@thejh.net> -Josh Triplett <josh@joshtriplett.org> -Keno Fischer <keno@juliacomputing.com> -Laurent Georget <laurent.georget@supelec.fr> -Local Lembke <logan@blackhillsinfosec.com> -Mats Wichmann <mats@wichmann.us> -Michael Kerrisk <mtk.manpages@gmail.com> -Mike Crowe <mac@mcrowe.com> -Mike Frysinger <vapier@gentoo.org> -Namhyung Kim <namhyung@gmail.com> -Nikola Forró <nforro@redhat.com> -Patrick McLean <patrickm@gaikai.com> -Peter Wu <peter@lekensteyn.nl> -Petr Cermak <petrcermak@chromium.org> -Quentin Rameau <quinq@fifth.space> -Ray Bellis <ray@isc.org> -Rich Felker <dalias@libc.org> -Ruben Kerkhof <ruben@rubenkerkhof.com> -Sam Varshavchik <mrsam@courier-mta.com> -Sebastian Andrzej Siewior <bigeasy@linutronix.de> -Siward de Groot <siward@wanadoo.nl> -Sloane Bernstein <sloane@cpanel.net> -Stefan Tauner <tauner@technikum-wien.at> -Tim Savannah <kata198@gmail.com> -Ursache Vladimir <f35f22fan@gmail.com> -Zefram <zefram@fysh.org> -王守堰 <wangshouyan@gmail.com> Apologies if I missed anyone! @@ -57,529 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -quotactl.2 - Eugene Syromyatnikov [Michael Kerrisk] - Updated information regarding disk quota flags - Added information regarding DQF_SYS_FILE flag; updated definition - of V1_DQF_RSQUASH, which has been defined privately and defined - publicly as DQF_ROOT_SQUASH. - Eugene Syromyatnikov - Updated information regarding XFS-specific quotactl subcommands - Added information regarding structure definitions used for - XFS-specific subcommands, updated flag constants, added - information regarding ignored syscall arguments, added notes on - usage of kernel UAPI header. - Eugene Syromyatnikov - Additions regarding project quotas - Added information regarding presence of project quotas. - -bswap.3 - Michael Kerrisk - New page documenting bswap_16(), bswap_32(), and bswap_64() - -cgroups.7 - Michael Kerrisk - Substantial rewrites, additions, and corrections. - Newly documented interfaces in existing pages --------------------------------------------- -readv.2 - Michael Kerrisk - Document the pwritev2() RWF_SYNC and RWF_DSYNC flags - -proc.5 - Michael Kerrisk - Document /proc/PID/seccomp - Jann Horn - Document /proc/[pid]/task/[tid]/children - Document the /proc/[pid]/task/[tid]/children interface from - CRIU, and more importantly, document why it's usually not - a good interface. - New and changed links --------------------- -bswap_16.3 -bswap_32.3 -bswap_64.3 - New link to new bswap.3 - Global changes -------------- -Various pages - Michael Kerrisk - Fix section ordering - Various pages had sections in an order different from - that prescribed in man-pages(7). - -Various pages - Michael Kerrisk [Mike Frysinger] - Consistently use /proc/[pid] (not /proc/PID) - -Various pages - Michael Kerrisk - Fix order of SEE ALSO entries - Entries should be ordered first by section, and then alphabetically - within the section. - -Various pages - Michael Kerrisk - Order ERRORS alphabetically - -Various pages - Michael Kerrisk - Remove section number from page self reference - Fix places where pages refer to the function that they describe - and include a section number in that reference. Such references - cause some HTML-rendering tools to create self-references in the - page. - -A few pages - Michael Kerrisk - Eliminate groff "cannot adjust line" warnings - Changes to individual pages --------------------------- -pldd.1 - Michael Kerrisk [Carlos O'Donell] - Note gdb(1) command that can be used as a replacement for pldd - Taken from Carlos O'Donnell's suggestion in - https://sourceware.org/bugzilla/show_bug.cgi?id=18035#c2 - Michael Kerrisk - BUGS: pldd has not worked since glibc 2.19 - -accept.2 - Michael Kerrisk - Mention epoll(7) alongside poll()/select() - Michael Kerrisk - Demote discussion of DECNet to NOTES - DECNet ceased to be important long ago... - -adjtimex.2 - Nikola Forró - Fix kernel version references - -chroot.2 - Michael Kerrisk - Note user namespace requirements for CAP_SYS_CHROOT - -clone.2 - Keno Fischer [Josh Triplett] - Adjust syscall prototype and expand CLONE_SETTLS description - Michael Kerrisk [Josh Triplett, Josh Triplett] - Document raw syscall interfaces on various other architectures - Michael Kerrisk - Change types for 'ptid' and 'ctid' in syscall prototypes - These types changed from 'void *' to 'int *' back in Linux 3.8. - Michael Kerrisk - EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack' - Clarify that this error is produced by the wrapper function, not - the underlying system call. In particular, the point is that the - raw system call can accommodate a NULL pointer for 'child_stack'. - Michael Kerrisk [Elliott Hughes] - Make the implications of CLONE_FILES more explicit - If CLONE_FILES is not set, the duplicated FDs nevertheless share - file offset and status flags via the open file description. - Michael Kerrisk - Mention kcmp() under notes - -close.2 - Michael Kerrisk - Add mention of the close-on-exec flag - Michael Kerrisk - Clarify discussion noting that close() does not flush buffer cache - -epoll_wait.2 - Mike Crowe - Clarify that the timeout is measured against CLOCK_MONOTONIC - -execve.2 - Michael Kerrisk - Mention use of 'environ' to access environment list - Michael Kerrisk - Note that real UID, real GID, and supplementary GIDs are unchanged - -fanotify_init.2 - Heinrich Schuchardt - Update BUGS information - -fcntl.2 - Michael Kerrisk - Note an important detail of F_SETOWN permission rules for signals - F_SETOWN records the caller's credentials at the time of - the fcntl() call, and it is these saved credentials that - are used for subsequent permission checks. - Michael Kerrisk - Make the description of the effect of close-on-exec a little clearer - Michael Kerrisk - Clarify that F_GETFD and F_GETFL return flags via the function result - -fork.2 - Michael Kerrisk - PID of new process also does not match any existing session ID - -fsync.2 - Michael Kerrisk - SEE ALSO: add pwritev(2) - Since Linux 4.7, pwritev() has flags related to I/O - integrity completion. - -getdomainname.2 - Michael Kerrisk - Note user namespace requirements for CAP_SYS_ADMIN - -getgroups.2 - Michael Kerrisk - Note user namespace requirements for CAP_SETGID - -gethostname.2 - Michael Kerrisk - Note user namespace requirements for CAP_SYS_ADMIN - -getrlimit.2 - Michael Kerrisk - Note user namespace semantics for CAP_SYS_RESOURCE - -getsid.2 - Michael Kerrisk - Rework description to be somewhat clearer - Michael Kerrisk - Correct the definition of "session ID" - -getunwind.2 - Michael Kerrisk - Simplify text referring to vdso(7) - The detail given here is redundant, since this info is also - in vdso(7). - -kcmp.2 - Michael Kerrisk - Add an example program - -kill.2 - Michael Kerrisk - Note the user namespace requirement for CAP_KILL - -killpg.2 - Michael Kerrisk - Refer reader to kill(2) for signal permission rules - -mlock.2 - Sebastian Andrzej Siewior - Document that fork() after mlock() may be a bad idea in a RT process - -mmap.2 - Jann Horn - Describe treatment of 'offset' for MAP_ANONYMOUS - Michael Kerrisk [Siward de Groot] - Small improvement to description of MAP_SHARED - See https://sourceware.org/bugzilla/show_bug.cgi?id=6887 - -msgctl.2 -msgget.2 -msgop.2 -semctl.2 -semget.2 -semop.2 -shmctl.2 -shmget.2 -shmop.2 - Michael Kerrisk - Note the user namespace requirements for CAP_IPC_OWNER - -open.2 - Michael Kerrisk - Clarify user namespace capability requirements for O_NOATIME - Michael Kerrisk - NOTES: kcmp() can be used to test if two FDs refer to the same OFD - Michael Kerrisk - F2FS support for O_TMPFILE was added in Linux 3.16 - Michael Kerrisk - Clarify the rules about how the group ID of a new file is determined - -prctl.2 - Michael Kerrisk - Refer to proc(5) for effects of dumpability on ownership of /proc/PID/* - Michael Kerrisk - ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER - Michael Kerrisk - Simplify list of cases where "dumpable" attribute is reset - Michael Kerrisk - Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP - -readlink.2 - Michael Kerrisk [Ursache Vladimir] - Make example program handle links that report a size of zero - Some "magic" symlinks created by the kernel (e.g., those under - /proc and /sys) report 'st_size' as zero. Modify the example - program to handle that possibility. - Michael Kerrisk - Emphasize that truncation of returned buffer generates no error - -readv.2 - Michael Kerrisk [Christoph Hellwig] - Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written - Michael Kerrisk - Add preadv2() and pwritev2() to NAME line - -reboot.2 - Michael Kerrisk - Note user namespace requirements around CAP_SYS_BOOT - -rename.2 - Michael Kerrisk [Tim Savannah] - Clarify that ERRORS may cause rename to fail (not to be nonatomic) - -sched_setaffinity.2 - Michael Kerrisk - Note user namespace requirements for CAP_SYS_NICE - -seccomp.2 - Michael Kerrisk - CAP_SYS_ADMIN is required only in caller's user namespace - -select_tut.2 - Peter Wu - Fix various issues in example program - -seteuid.2 - Michael Kerrisk - Note user namespace requirements for CAP_SETUID and CAP_SETGID - -setgid.2 - Michael Kerrisk - Note user namespace requirements for CAP_SETGID - -setpgid.2 - Michael Kerrisk - Add a reference to credentials(7) - -setpgid.2 -setsid.2 - Michael Kerrisk - Relocate some text on sessions and sessions leaders - Some text that was in setpgid(2) is better placed in setsid(2). - -setresuid.2 - Michael Kerrisk - Note user namespace requirements for CAP_SETUID - -setreuid.2 - Michael Kerrisk - Note user namespace requirements for CAP_SETUID and CAP_SETGID - -setsid.2 - Michael Kerrisk - Refer to credentials(7) for details for details on controlling terminal - Refer to credentials(7) for details of how a session obtains - a controlling terminal. - -set_thread_area.2 - Michael Kerrisk - Add get_thread_area() to NAME - -setuid.2 - Michael Kerrisk - Note user namespace requirements for CAP_SETUID - -sigprocmask.2 - Keno Fischer - Expand/clarify libc/kernel sigset_t difference - -stat.2 - Michael Kerrisk [Ursache Vladimir, Mats Wichmann] - Improve discussion of 'st_size' for /proc and /sys files - Michael Kerrisk - _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps - -umask.2 - Michael Kerrisk - Provide a rationale for the existence of /proc/PID/status 'Umask' field - -wait.2 - Michael Kerrisk - Remove erroneous statement that waitpid() is implemented via wait4() - There is a fallback to wait4(), but only if the kernel does - not provide a waitpid() system call. - -bindresvport.3 -rcmd.3 -ip.7 - Michael Kerrisk - Note user namespace requirements for CAP_NET_BIND_SERVICE - -byteorder.3 - Michael Kerrisk - SEE ALSO: add bswap(3) - -dlopen.3 - Michael Kerrisk - dlmopen() is still broken in glibc 2.24 - -endian.3 - Michael Kerrisk - SEE ALSO: add bswap(3) - -ffs.3 - Michael Kerrisk [Stefan Tauner] - Correct feature test macro requirements - -fmemopen.3 - Michael Kerrisk [Rich Felker] - Remove bogus suggestion to use setbuffer() - -getlogin.3 - Michael Kerrisk - Update feature test macro requirements for cuserid() - -getumask.3 - Michael Kerrisk - Note that getumask() is still unavailable in glibc 2.24 - Michael Kerrisk - Point to umask(2) for a thread-safe way to discover process's umask - -mkstemp.3 - Quentin Rameau - Fix _POSIX_C_SOURCE value for mkstemp() - The correct _POSIX_C_SOURCE value has always been 200809L, - not 200112L. - -pthread_join.3 - Michael Kerrisk [Mats Wichmann] - Note that the caller might do clean up after joining with a thread - Michael Kerrisk [王守堰] - Clarify use of 'retval' pointer - -resolver.3 - Ray Bellis - Correct arguments to res_ninit(res_state statep) - -strverscmp.3 - Michael Kerrisk - Add an example program - -wcstombs.3 - Michael Kerrisk [Igor Liferenko] - wcsrtombs() does not provide thread-safe interface to same functionality - See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360 - -core.5 - Mike Frysinger [Michael Kerrisk] - Add more details for output paths and the crash handler - People sometimes assume that the crash handler runs in the same - context as the crashing process. They would be incorrect :). - -proc.5 - Mike Frysinger - Clarify the root symlink and mount namespaces - If the target process is in a different mount namespace, the root - symlink actually shows that view of the filesystem. - Michael Kerrisk [Mike Frysinger] - Expand discussion of /proc/[pid]/root - Add a shell example showing that /proc/[pid]/root is more - than a symlink. Based on an example provided by Mike Frysinger - in an earlier commit message. - Michael Kerrisk - Explain rules determining ownership of /proc/PID/* files - Describe the effect of the "dumpable" attribute on ownership - of /proc/PID files. - Michael Kerrisk - Note effect of 'suid_dumpable' on ownership of /proc/PID files - Michael Kerrisk - Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability - Michael Kerrisk - Add reference to core(5) in discussion of 'suid_dumpable' - Michael Kerrisk - Note that 'suid_dumpable' mode 1 is insecure - Michael Kerrisk - Document /proc/meminfo '+ShmemHugePages' and 'ShmemPmdMapped' fields - Michael Kerrisk - Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields - Michael Kerrisk - Document /proc/PID/status 'HugetlbPages' field - Michael Kerrisk [Zefram] - Clarify that /proc/PID/statm 'shared' field counts *resident* pages - See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360 - Michael Kerrisk - Add reference to umask(2) in discussion of /proc/PID/status 'Umask' - Michael Kerrisk - Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks - Michael Kerrisk - Note changes to config option governing /proc/[pid]/task/[tid]/children - Michael Kerrisk - Clarify description of /proc/PID/statm 'lib' and 'dt' fields - These fields are always zero since Linux 2.6. - Namhyung Kim [Petr Cermak] - Add description of CLEAR_REFS_MM_HIWATER_RSS - Michael Kerrisk - Update example VM values in /proc/PID/status - -capabilities.7 - Michael Kerrisk - Add note about nosuid to file capabilities section - Michael Kerrisk - SEE ALSO: add proc(5) - Michael Kerrisk - SEE ALSO: add setsid(2) and setpgid(2) - -glob.7 - Michael Kerrisk [Arnaud Gaillard] - Clarify that syntactically incorrect patterns are left unchanged - -packet.7 - Michael Kerrisk - Clarify user namespace requirements for CAP_NET_RAW - -pipe.7 - Michael Kerrisk [Patrick McLean] - Document FIONREAD - -raw.7 - Michael Kerrisk - Clarify user namespace requirements for CAP_NET_RAW - Also remove mention of UID 0 as a method or creating - a raw socket. As far as I can tell from reading the - kernel source (net/ipv4/af_inet.c), this is not true. - -socket.7 - Michael Kerrisk - SIOCSPGRP: refer to fcntl(2) F_SETOWN for correct permission rules - The permission rules described for SIOCCPGRP are wrong. Rather - than repeat the rules here, just refer the reader to fcntl(2), - where the rules are described for F_SETOWN. - -unix.7 - Michael Kerrisk [Laurent Georget, Ivan Kharpalev] - Remove mention of recvmsg() from discussion of EPIPE error - See https://bugzilla.kernel.org/show_bug.cgi?id=137351 - -ld.so.8 - Michael Kerrisk - Expand description of LD_DEBUG - Provide a list of the categories, and note that multiple - categories can be specified. - Michael Kerrisk - Add glibc version for LD_USE_LOAD_BIAS - Michael Kerrisk - Clarify text describing whether secure-mode programs preload libraries - Michael Kerrisk - Remove discussion of environment variables understood by libc5 - libc5 disappeared long ago, so cease cluttering up this page - with those ancient details. Thus, remove discussion of the - following environment variables: LD_AOUT_LIBRARY_PATH, - LD_AOUT_PRELOAD, LD_KEEPDIR, LD_NOWARN, and LDD_ARGV0. - Michael Kerrisk - Remove text with ancient libc4 and Linux libc details - Michael Kerrisk - Remove mention of "ELF only" - Drawing a distinction between ELF-only features versus a,out - ceased to be relevant long ago, so cluttering the page - with "ELF-only" serves no purpose. - diff --git a/Changes.old b/Changes.old index effe65b93b..b5bfff9690 100644 --- a/Changes.old +++ b/Changes.old @@ -42451,3 +42451,590 @@ utf-8.7: Include RFC 3629 and clarify endianness which is left ambiguous The endianness is suggested by the order the bytes are displayed, but the text is ambiguous. + + +==================== Changes in man-pages-4.08 ==================== + +Released: 2016-10-08, 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: + +Arnaud Gaillard <arnaud.mgaillard@gmail.com> +Bill Pemberton <wfp5p@worldbroken.com> +Carlos O'Donell <carlos@redhat.com> +Christoph Hellwig <hch@lst.de> +David Turner <novalis@novalis.org> +Dr. Tobias Quathamer <toddy@debian.org> +Elliott Hughes <enh@google.com> +Eugene Syromyatnikov <evgsyr@gmail.com> +Heinrich Schuchardt <xypron.glpk@gmx.de> +Hu Keping <hukeping@huawei.com> +Igor Liferenko <igor.liferenko@gmail.com> +Ivan Kharpalev <ivan.kharpalev@gmail.com> +Jakub Wilk <jwilk@jwilk.net> +Jann Horn <jann@thejh.net> +Josh Triplett <josh@joshtriplett.org> +Keno Fischer <keno@juliacomputing.com> +Laurent Georget <laurent.georget@supelec.fr> +Local Lembke <logan@blackhillsinfosec.com> +Mats Wichmann <mats@wichmann.us> +Michael Kerrisk <mtk.manpages@gmail.com> +Mike Crowe <mac@mcrowe.com> +Mike Frysinger <vapier@gentoo.org> +Namhyung Kim <namhyung@gmail.com> +Nikola Forró <nforro@redhat.com> +Patrick McLean <patrickm@gaikai.com> +Peter Wu <peter@lekensteyn.nl> +Petr Cermak <petrcermak@chromium.org> +Quentin Rameau <quinq@fifth.space> +Ray Bellis <ray@isc.org> +Rich Felker <dalias@libc.org> +Ruben Kerkhof <ruben@rubenkerkhof.com> +Sam Varshavchik <mrsam@courier-mta.com> +Sebastian Andrzej Siewior <bigeasy@linutronix.de> +Siward de Groot <siward@wanadoo.nl> +Sloane Bernstein <sloane@cpanel.net> +Stefan Tauner <tauner@technikum-wien.at> +Tim Savannah <kata198@gmail.com> +Ursache Vladimir <f35f22fan@gmail.com> +Zefram <zefram@fysh.org> +王守堰 <wangshouyan@gmail.com> + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +quotactl.2 + Eugene Syromyatnikov [Michael Kerrisk] + Updated information regarding disk quota flags + Added information regarding DQF_SYS_FILE flag; updated definition + of V1_DQF_RSQUASH, which has been defined privately and defined + publicly as DQF_ROOT_SQUASH. + Eugene Syromyatnikov + Updated information regarding XFS-specific quotactl subcommands + Added information regarding structure definitions used for + XFS-specific subcommands, updated flag constants, added + information regarding ignored syscall arguments, added notes on + usage of kernel UAPI header. + Eugene Syromyatnikov + Additions regarding project quotas + Added information regarding presence of project quotas. + +bswap.3 + Michael Kerrisk + New page documenting bswap_16(), bswap_32(), and bswap_64() + +cgroups.7 + Michael Kerrisk + Substantial rewrites, additions, and corrections. + + +Newly documented interfaces in existing pages +--------------------------------------------- + +readv.2 + Michael Kerrisk + Document the pwritev2() RWF_SYNC and RWF_DSYNC flags + +proc.5 + Michael Kerrisk + Document /proc/PID/seccomp + Jann Horn + Document /proc/[pid]/task/[tid]/children + Document the /proc/[pid]/task/[tid]/children interface from + CRIU, and more importantly, document why it's usually not + a good interface. + + +New and changed links +--------------------- + +bswap_16.3 +bswap_32.3 +bswap_64.3 + New link to new bswap.3 + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Fix section ordering + Various pages had sections in an order different from + that prescribed in man-pages(7). + +Various pages + Michael Kerrisk [Mike Frysinger] + Consistently use /proc/[pid] (not /proc/PID) + +Various pages + Michael Kerrisk + Fix order of SEE ALSO entries + Entries should be ordered first by section, and then alphabetically + within the section. + +Various pages + Michael Kerrisk + Order ERRORS alphabetically + +Various pages + Michael Kerrisk + Remove section number from page self reference + Fix places where pages refer to the function that they describe + and include a section number in that reference. Such references + cause some HTML-rendering tools to create self-references in the + page. + +A few pages + Michael Kerrisk + Eliminate groff "cannot adjust line" warnings + + +Changes to individual pages +--------------------------- + +pldd.1 + Michael Kerrisk [Carlos O'Donell] + Note gdb(1) command that can be used as a replacement for pldd + Taken from Carlos O'Donnell's suggestion in + https://sourceware.org/bugzilla/show_bug.cgi?id=18035#c2 + Michael Kerrisk + BUGS: pldd has not worked since glibc 2.19 + +accept.2 + Michael Kerrisk + Mention epoll(7) alongside poll()/select() + Michael Kerrisk + Demote discussion of DECNet to NOTES + DECNet ceased to be important long ago... + +adjtimex.2 + Nikola Forró + Fix kernel version references + +chroot.2 + Michael Kerrisk + Note user namespace requirements for CAP_SYS_CHROOT + +clone.2 + Keno Fischer [Josh Triplett] + Adjust syscall prototype and expand CLONE_SETTLS description + Michael Kerrisk [Josh Triplett, Josh Triplett] + Document raw syscall interfaces on various other architectures + Michael Kerrisk + Change types for 'ptid' and 'ctid' in syscall prototypes + These types changed from 'void *' to 'int *' back in Linux 3.8. + Michael Kerrisk + EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack' + Clarify that this error is produced by the wrapper function, not + the underlying system call. In particular, the point is that the + raw system call can accommodate a NULL pointer for 'child_stack'. + Michael Kerrisk [Elliott Hughes] + Make the implications of CLONE_FILES more explicit + If CLONE_FILES is not set, the duplicated FDs nevertheless share + file offset and status flags via the open file description. + Michael Kerrisk + Mention kcmp() under notes + +close.2 + Michael Kerrisk + Add mention of the close-on-exec flag + Michael Kerrisk + Clarify discussion noting that close() does not flush buffer cache + +epoll_wait.2 + Mike Crowe + Clarify that the timeout is measured against CLOCK_MONOTONIC + +execve.2 + Michael Kerrisk + Mention use of 'environ' to access environment list + Michael Kerrisk + Note that real UID, real GID, and supplementary GIDs are unchanged + +fanotify_init.2 + Heinrich Schuchardt + Update BUGS information + +fcntl.2 + Michael Kerrisk + Note an important detail of F_SETOWN permission rules for signals + F_SETOWN records the caller's credentials at the time of + the fcntl() call, and it is these saved credentials that + are used for subsequent permission checks. + Michael Kerrisk + Make the description of the effect of close-on-exec a little clearer + Michael Kerrisk + Clarify that F_GETFD and F_GETFL return flags via the function result + +fork.2 + Michael Kerrisk + PID of new process also does not match any existing session ID + +fsync.2 + Michael Kerrisk + SEE ALSO: add pwritev(2) + Since Linux 4.7, pwritev() has flags related to I/O + integrity completion. + +getdomainname.2 + Michael Kerrisk + Note user namespace requirements for CAP_SYS_ADMIN + +getgroups.2 + Michael Kerrisk + Note user namespace requirements for CAP_SETGID + +gethostname.2 + Michael Kerrisk + Note user namespace requirements for CAP_SYS_ADMIN + +getrlimit.2 + Michael Kerrisk + Note user namespace semantics for CAP_SYS_RESOURCE + +getsid.2 + Michael Kerrisk + Rework description to be somewhat clearer + Michael Kerrisk + Correct the definition of "session ID" + +getunwind.2 + Michael Kerrisk + Simplify text referring to vdso(7) + The detail given here is redundant, since this info is also + in vdso(7). + +kcmp.2 + Michael Kerrisk + Add an example program + +kill.2 + Michael Kerrisk + Note the user namespace requirement for CAP_KILL + +killpg.2 + Michael Kerrisk + Refer reader to kill(2) for signal permission rules + +mlock.2 + Sebastian Andrzej Siewior + Document that fork() after mlock() may be a bad idea in a RT process + +mmap.2 + Jann Horn + Describe treatment of 'offset' for MAP_ANONYMOUS + Michael Kerrisk [Siward de Groot] + Small improvement to description of MAP_SHARED + See https://sourceware.org/bugzilla/show_bug.cgi?id=6887 + +msgctl.2 +msgget.2 +msgop.2 +semctl.2 +semget.2 +semop.2 +shmctl.2 +shmget.2 +shmop.2 + Michael Kerrisk + Note the user namespace requirements for CAP_IPC_OWNER + +open.2 + Michael Kerrisk + Clarify user namespace capability requirements for O_NOATIME + Michael Kerrisk + NOTES: kcmp() can be used to test if two FDs refer to the same OFD + Michael Kerrisk + F2FS support for O_TMPFILE was added in Linux 3.16 + Michael Kerrisk + Clarify the rules about how the group ID of a new file is determined + +prctl.2 + Michael Kerrisk + Refer to proc(5) for effects of dumpability on ownership of /proc/PID/* + Michael Kerrisk + ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER + Michael Kerrisk + Simplify list of cases where "dumpable" attribute is reset + Michael Kerrisk + Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP + +readlink.2 + Michael Kerrisk [Ursache Vladimir] + Make example program handle links that report a size of zero + Some "magic" symlinks created by the kernel (e.g., those under + /proc and /sys) report 'st_size' as zero. Modify the example + program to handle that possibility. + Michael Kerrisk + Emphasize that truncation of returned buffer generates no error + +readv.2 + Michael Kerrisk [Christoph Hellwig] + Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written + Michael Kerrisk + Add preadv2() and pwritev2() to NAME line + +reboot.2 + Michael Kerrisk + Note user namespace requirements around CAP_SYS_BOOT + +rename.2 + Michael Kerrisk [Tim Savannah] + Clarify that ERRORS may cause rename to fail (not to be nonatomic) + +sched_setaffinity.2 + Michael Kerrisk + Note user namespace requirements for CAP_SYS_NICE + +seccomp.2 + Michael Kerrisk + CAP_SYS_ADMIN is required only in caller's user namespace + +select_tut.2 + Peter Wu + Fix various issues in example program + +seteuid.2 + Michael Kerrisk + Note user namespace requirements for CAP_SETUID and CAP_SETGID + +setgid.2 + Michael Kerrisk + Note user namespace requirements for CAP_SETGID + +setpgid.2 + Michael Kerrisk + Add a reference to credentials(7) + +setpgid.2 +setsid.2 + Michael Kerrisk + Relocate some text on sessions and sessions leaders + Some text that was in setpgid(2) is better placed in setsid(2). + +setresuid.2 + Michael Kerrisk + Note user namespace requirements for CAP_SETUID + +setreuid.2 + Michael Kerrisk + Note user namespace requirements for CAP_SETUID and CAP_SETGID + +setsid.2 + Michael Kerrisk + Refer to credentials(7) for details for details on controlling terminal + Refer to credentials(7) for details of how a session obtains + a controlling terminal. + +set_thread_area.2 + Michael Kerrisk + Add get_thread_area() to NAME + +setuid.2 + Michael Kerrisk + Note user namespace requirements for CAP_SETUID + +sigprocmask.2 + Keno Fischer + Expand/clarify libc/kernel sigset_t difference + +stat.2 + Michael Kerrisk [Ursache Vladimir, Mats Wichmann] + Improve discussion of 'st_size' for /proc and /sys files + Michael Kerrisk + _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps + +umask.2 + Michael Kerrisk + Provide a rationale for the existence of /proc/PID/status 'Umask' field + +wait.2 + Michael Kerrisk + Remove erroneous statement that waitpid() is implemented via wait4() + There is a fallback to wait4(), but only if the kernel does + not provide a waitpid() system call. + +bindresvport.3 +rcmd.3 +ip.7 + Michael Kerrisk + Note user namespace requirements for CAP_NET_BIND_SERVICE + +byteorder.3 + Michael Kerrisk + SEE ALSO: add bswap(3) + +dlopen.3 + Michael Kerrisk + dlmopen() is still broken in glibc 2.24 + +endian.3 + Michael Kerrisk + SEE ALSO: add bswap(3) + +ffs.3 + Michael Kerrisk [Stefan Tauner] + Correct feature test macro requirements + +fmemopen.3 + Michael Kerrisk [Rich Felker] + Remove bogus suggestion to use setbuffer() + +getlogin.3 + Michael Kerrisk + Update feature test macro requirements for cuserid() + +getumask.3 + Michael Kerrisk + Note that getumask() is still unavailable in glibc 2.24 + Michael Kerrisk + Point to umask(2) for a thread-safe way to discover process's umask + +mkstemp.3 + Quentin Rameau + Fix _POSIX_C_SOURCE value for mkstemp() + The correct _POSIX_C_SOURCE value has always been 200809L, + not 200112L. + +pthread_join.3 + Michael Kerrisk [Mats Wichmann] + Note that the caller might do clean up after joining with a thread + Michael Kerrisk [王守堰] + Clarify use of 'retval' pointer + +resolver.3 + Ray Bellis + Correct arguments to res_ninit(res_state statep) + +strverscmp.3 + Michael Kerrisk + Add an example program + +wcstombs.3 + Michael Kerrisk [Igor Liferenko] + wcsrtombs() does not provide thread-safe interface to same functionality + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360 + +core.5 + Mike Frysinger [Michael Kerrisk] + Add more details for output paths and the crash handler + People sometimes assume that the crash handler runs in the same + context as the crashing process. They would be incorrect :). + +proc.5 + Mike Frysinger + Clarify the root symlink and mount namespaces + If the target process is in a different mount namespace, the root + symlink actually shows that view of the filesystem. + Michael Kerrisk [Mike Frysinger] + Expand discussion of /proc/[pid]/root + Add a shell example showing that /proc/[pid]/root is more + than a symlink. Based on an example provided by Mike Frysinger + in an earlier commit message. + Michael Kerrisk + Explain rules determining ownership of /proc/PID/* files + Describe the effect of the "dumpable" attribute on ownership + of /proc/PID files. + Michael Kerrisk + Note effect of 'suid_dumpable' on ownership of /proc/PID files + Michael Kerrisk + Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability + Michael Kerrisk + Add reference to core(5) in discussion of 'suid_dumpable' + Michael Kerrisk + Note that 'suid_dumpable' mode 1 is insecure + Michael Kerrisk + Document /proc/meminfo '+ShmemHugePages' and 'ShmemPmdMapped' fields + Michael Kerrisk + Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields + Michael Kerrisk + Document /proc/PID/status 'HugetlbPages' field + Michael Kerrisk [Zefram] + Clarify that /proc/PID/statm 'shared' field counts *resident* pages + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360 + Michael Kerrisk + Add reference to umask(2) in discussion of /proc/PID/status 'Umask' + Michael Kerrisk + Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks + Michael Kerrisk + Note changes to config option governing /proc/[pid]/task/[tid]/children + Michael Kerrisk + Clarify description of /proc/PID/statm 'lib' and 'dt' fields + These fields are always zero since Linux 2.6. + Namhyung Kim [Petr Cermak] + Add description of CLEAR_REFS_MM_HIWATER_RSS + Michael Kerrisk + Update example VM values in /proc/PID/status + +capabilities.7 + Michael Kerrisk + Add note about nosuid to file capabilities section + Michael Kerrisk + SEE ALSO: add proc(5) + Michael Kerrisk + SEE ALSO: add setsid(2) and setpgid(2) + +glob.7 + Michael Kerrisk [Arnaud Gaillard] + Clarify that syntactically incorrect patterns are left unchanged + +packet.7 + Michael Kerrisk + Clarify user namespace requirements for CAP_NET_RAW + +pipe.7 + Michael Kerrisk [Patrick McLean] + Document FIONREAD + +raw.7 + Michael Kerrisk + Clarify user namespace requirements for CAP_NET_RAW + Also remove mention of UID 0 as a method or creating + a raw socket. As far as I can tell from reading the + kernel source (net/ipv4/af_inet.c), this is not true. + +socket.7 + Michael Kerrisk + SIOCSPGRP: refer to fcntl(2) F_SETOWN for correct permission rules + The permission rules described for SIOCCPGRP are wrong. Rather + than repeat the rules here, just refer the reader to fcntl(2), + where the rules are described for F_SETOWN. + +unix.7 + Michael Kerrisk [Laurent Georget, Ivan Kharpalev] + Remove mention of recvmsg() from discussion of EPIPE error + See https://bugzilla.kernel.org/show_bug.cgi?id=137351 + +ld.so.8 + Michael Kerrisk + Expand description of LD_DEBUG + Provide a list of the categories, and note that multiple + categories can be specified. + Michael Kerrisk + Add glibc version for LD_USE_LOAD_BIAS + Michael Kerrisk + Clarify text describing whether secure-mode programs preload libraries + Michael Kerrisk + Remove discussion of environment variables understood by libc5 + libc5 disappeared long ago, so cease cluttering up this page + with those ancient details. Thus, remove discussion of the + following environment variables: LD_AOUT_LIBRARY_PATH, + LD_AOUT_PRELOAD, LD_KEEPDIR, LD_NOWARN, and LDD_ARGV0. + Michael Kerrisk + Remove text with ancient libc4 and Linux libc details + Michael Kerrisk + Remove mention of "ELF only" + Drawing a distinction between ELF-only features versus a,out + ceased to be relevant long ago, so cluttering the page + with "ELF-only" serves no purpose. + |