-==================== Changes in man-pages-4.09 ====================
+==================== Changes in man-pages-4.12 ====================
-Released: ????-??-??, Munich
+Released: 2017-07-13, London
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Afzal Mohammed <afzal.mohd.ma@gmail.com>
-Andrew Clayton <andrew@digital-domain.net>
+Alex Henrie <alexhenrie24@gmail.com>
+Andi Kleen <andi-bz.firstfloor.org>
+Arjun Shankar <arjun.is@lostca.se>
+Brad Bendily <bendily@gmail.com>
+Cameron Wright <wright18@uw.edu>
Carlos O'Donell <carlos@redhat.com>
-Christoph Lameter <cl@linux.com>
-Daniel Baluta <daniel.baluta@gmail.com>
-Daniel Berrange <berrange@redhat.com>
-Daniel Wagner <wagi@monom.org>
Darrick J. Wong <darrick.wong@oracle.com>
-Dave Hansen <dave.hansen@intel.com>
-Dmitry V. Levin <ldv@altlinux.org>
+David Lewis <davlewi3@cisco.com>
+DJ Delorie <dj@delorie.com>
+Douglas Caetano dos Santos <douglascs@taghos.com.br>
Dr. Tobias Quathamer <toddy@debian.org>
-Elliott Hughes <enh@google.com>
-Eric W. Biederman <ebiederm@xmission.com>
-Eugene Syromyatnikov <evgsyr@gmail.com>
-Florian Weimer <fweimer@redhat.com>
+Eric Biggers <ebiggers@google.com>
+Ferdinand Thiessen <f.thiessen@gmx.de>
+G. Branden Robinson <g.branden.robinson@gmail.com>
Heinrich Schuchardt <xypron.glpk@gmx.de>
-Igor Liferenko <igor.liferenko@gmail.com>
+Henry Bent <henry.r.bent@gmail.com>
Jakub Wilk <jwilk@jwilk.net>
-Jann Horn <jann@thejh.net>
-Jeremy Harris <jgh@redhat.com>
-Kees Cook <keescook@chromium.org>
-Keno Fischer <keno@juliacomputing.com>
-Laurent Georget <laurent.georget@supelec.fr>
-Laurent Georget <laurent@lgeorget.eu>
-Marcos Mello <marcosfrm@gmail.com>
-Michael Hausenblas <michael.hausenblas@gmail.com>
+Janne Snabb <snabb@epipe.com>
+Joe Brown <joe.brown.89@outlook.com>
+Jorge Nerin <jnerin@gmail.com>
+Kirill Tkhai <ktkhai@virtuozzo.com>
+lilydjwg <lilydjwg@gmail.com>
+Long Wang <w@laoqinren.net>
Michael Kerrisk <mtk.manpages@gmail.com>
-Mike Frysinger <vapier@gentoo.org>
-Mike Galbraith <efault@gmx.de>
-Miroslav Koskar <mk@mkoskar.com>
-Nikos Mavrogiannopoulos <nmav@redhat.com>
-Omar Sandoval <osandov@fb.com>
-Pavel Emelyanov <xemul@virtuozzo.com>
-Piotr Kwapulinski <kwapulinski.piotr@gmail.com>
-Siddhesh Poyarekar <siddhesh@sourceware.org>
-Theodore Ts'o <tytso@mit.edu>
-Vegard Nossum <vegard.nossum@oracle.com>
-Vincent Lefevre <vincent@vinc17.net>
-Vince Weaver <vincent.weaver@maine.edu>
-Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
-Wang Long <long.wanglong@huawei.com>
-Willy Tarreau <w@1wt.eu>
-Zack Weinberg <zackw@panix.com>
+Mike Frysinger <vapier@chromium.org>
+Nadav Har'El <nyh@math.technion.ac.il>
+NeilBrown <neilb@suse.com>
+Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
+Quentin Rameau <quinq@fifth.space>
+Ruben Kerkhof <ruben@rubenkerkhof.com>
+sulit <sulitsrc@foxmail.com>
+石井大貴 <hiroki.ishii@miraclelinux.com>
Apologies if I missed anyone!
-New and rewritten pages
------------------------
-
-pkey_alloc.2
- Dave Hansen [Michael Kerrisk]
- New page documenting pkey_alloc(2) and pkey_free(2)
-
-pthread_getattr_default_np.3
- Michael Kerrisk
- New page documenting pthread_getattr_default_np(3) and pthread_setattr_default_np(3)
-
-strfromd.3
- Wainer dos Santos Moschetta
- New page documenting strfromd(3), strfromf(3), and strfroml(3)
- The ISO/IEC TS 18661-1 specifies the strfrom() class
- of functions that convert a float-point value to string.
-
-fuse.4
- Keno Fischer [Michael Kerrisk]
- New page describing /dev/fuse
- This is my writeup of a basic description of /dev/fuse after
- playing with it for a few hours today. It is of course woefully
- incomplete, and since I neither have a use case nor am working
- on this code, I will not be in a position to expand it in the
- near future. However, I'm hoping this could still serve as a
- handy reference for others looking at this interface.
-
- [mtk: Notwithstanding the incompleteness of this page,
- it's a good base for future extension.]
-
-tmpfs.5
- Michael Kerrisk
- New page documenting the tmpfs filesystem
-
-pkeys.7
- Dave Hansen [Michael Kerrisk]
- New page with overview of Memory Protection Keys
-
-random.7
- Michael Kerrisk [Theodore Ts'o, Nikos Mavrogiannopoulos, Laurent Georget]
- New page providing an overview of interfaces for obtaining randomness
- Contains material extracted from getrandom(2) and random(4),
- as well as new material.
-
-sock_diag.7
- Pavel Emelyanov, Dmitry V. Levin
- New page documenting NETLINK_SOCK_DIAG interface
-
-close.2
-getpriority.2
-nice.2
-timer_create.2
-timerfd_create.2
-random.4
-elf.5
-proc.5
-sched.7
- Various authors
- These pages also saw substantial updates, as described under
- "Changes to individual pages".
-
-
Newly documented interfaces in existing pages
---------------------------------------------
-mmap.2
- Michael Kerrisk
- Add (much) more detail on MAP_GROWSDOWN
-
-mprotect.2
- Dave Hansen
- Document the new pkey_mprotect() system call
- Eugene Syromyatnikov
- Document PROT_SEM, PROT_SAO, PROT_GROWSUP, and PROT_GROWSDOWN
-
-prctl.2
- Eugene Syromyatnikov
- Document PR_SET_FP_MODE and PR_GET_FP_MODE
-
-perf_event_open.2
- Vince Weaver
- PERF_RECORD_SWITCH support
- Linux 4.3 introduced two new record types for recording context
- switches: PERF_RECORD_SWITCH and PERF_RECORD_SWITCH_CPU_WIDE.
- Vince Weaver
- Add PERF_SAMPLE_BRANCH_CALL branch sample type
- Vince Weaver
- PERF_SAMPLE_BRANCH_IND_JUMP branch_sample_type
- Linux 4.2 added a new branch_sample_type: PERF_SAMPLE_BRANCH_IND_JUMP
- Vince Weaver
- Document PERF_RECORD_MISC_PROC_MAP_PARSE_TIMEOUT
- Vince Weaver
- Document sample_max_stack and /proc/sys/kernel/perf_event_max_stack
- Linux 4.8 added a new sample_max_stack parameter, as well as
- /proc/sys/kernel/perf_event_max_stack which limits it and a new
- EOVERFLOW error return.
- Dave Hansen
- PERF_RECORD_LOST_SAMPLES record type
- Linux 4.2 added a new record type: PERF_RECORD_LOST_SAMPLES
- It is generated when hardware samples (currently only Intel PEBS)
- are lost.
-
-ptrace.2
- Michael Kerrisk
- Document PTRACE_SECCOMP_GET_FILTER
- Michael Kerrisk
- Document PTRACE_GET_THREAD_AREA and PTRACE_SET_THREAD_AREA
-
namespaces.7
- Michael Kerrisk [Eric W. Biederman]
- Document the NS_GET_USERNS and NS_GET_PARENT ioctl() operations
-
-sched.7
- Michael Kerrisk [Mike Galbraith]
- Document the autogroup feature
- Includes documenting autogroup nice value
- Michael Kerrisk
- Autogrouping breaks traditional semantics of nice in many cases
- When autogrouping is enabled (the default in many distros)
- there are many traditional use cases where the nice value
- ceases to have any effect.
- Michael Kerrisk
- Add a subsection on nice value and group scheduling
-
-
-New and changed links
----------------------
+ Kirill Tkhai [Michael Kerrisk]
+ Document the /proc/[pid]/ns/pid_for_children file
-killpg.2
- Michael Kerrisk
- New link to relocated killpg(3) page
-
-pkey_free.2
- Michael Kerrisk
- New link to new pkey_alloc(2) page
-pkey_mprotect.2
- Michael Kerrisk
- New link to mprotect(2)
+Changes to individual pages
+---------------------------
-pthread_setattr_default_np.3
+ldd.1
Michael Kerrisk
- New link to new pthread_getattr_default_np.3
-
-strfromf.3
- Wainer dos Santos Moschetta
- New link to strfromd(3)
-
-strfroml.3
- Wainer dos Santos Moschetta
- New link to strfromd(3)
+ 'objdump -p prog | grep NEEDED' doesn't give quite same info as 'ldd'
-
-Global changes
---------------
-
-Various pages
- Michael kerrisk
- Remove ancient libc4 and libc5 details
- It's nearly 20 years now since Linux libc went away.
- Remove some ancient details from the pages.
-
-Various pages
+chmod.2
Michael Kerrisk
- Add cross references to new tmpfs(5) page
-
-Various pages
+ Put fchmod() feature test macro requirements in a more readable format
Michael Kerrisk
- Change section number from 2 to 3 in killpg() references
+ Note glibc 2.24 feature test macro requirements changes for fchmod()
-
-Changes to individual pages
----------------------------
-
-accept.2
+chown.2
Michael Kerrisk
- Remove editorializing comments about 'socklen_t'
+ When file owner or group is changed, file capabilities are cleared
Michael Kerrisk
- Simplify the discussion of 'socklen_t'
- We don't really need to list the old OSes in this discussion.
+ Changes to file owner by root also clear set-UID and set-GID bits
-adjtimex.2
-clock_getres.2
-gettimeofday.2
+clone.2
Michael Kerrisk
- SEE ALSO: add hwclock(8)
+ Update BUGS to reflect fact that PID caching was removed in glibc 2.25
-bind.2
-connect.2
-getpeername.2
-getsockname.2
-getsockopt.2
+epoll_wait.2
Michael Kerrisk
- Replace discussion of 'socklen_t' with reference to accept(2)
- The discussion of 'socklen_t' editorializes and is repeated
- across several pages. Replace it with a reference to accept(2),
- where some details about this type are provided.
+ Clarify semantics of returned 'data' field
+ The returned 'data' is the 'data' most recently set via
+ epoll_ctl().
-chmod.2
- Michael Kerrisk
- SEE ALSO: add chmod(1)
+get_mempolicy.2
+ Michael Kerrisk [Nadav Har'El, Andi Kleen]
+ SYNOPSIS: fix return type of get_mempolicy()
+ See https://bugzilla.kernel.org/show_bug.cgi?id=97051
-chown.2
- Michael Kerrisk
- SEE ALSO: add chgrp(1) and chown(1)
+getpid.2
+ Carlos O'Donell, Michael Kerrisk
+ Note that PID caching is removed as of glibc 2.25
+ Since glibc 2.25 the PID cache is removed.
-chroot.2
- Michael Kerrisk
- SEE ALSO: add chroot(1)
+ Rationale given in the release notes:
+ https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal
-clone.2
+ioctl.2
Michael Kerrisk
- The CLONE_*_SETTID operations store TID before return to user space
- CLONE_PARENT_SETTID and CLONE_CHILD_SETTID store the new
- TID before clone() returns to user space
+ SEE ALSO: add ioctl_getfsmap(2)
-close.2
- Michael Kerrisk [Daniel Wagner]
- Rework and greatly extend discussion of error handling
- Further clarify that an error return should be used only
- for diagnostic or remedial purposes.
- Michael Kerrisk
- Other UNIX implementations also close the FD, even if reporting an error
- Looking at some historical source code suggests
- that the "close() always closes regardless of error return"
- behavior has a long history, predating even POSIX.1-1990.
+ioctl_getfsmap.2
Michael Kerrisk
- Note that future POSIX plans to require that the FD is closed on error
- See http://austingroupbugs.net/view.php?id=529#c1200.
+ Fix ordering of sections
Michael Kerrisk
- Clarify the variation in EINTR behavior per POSIX and other systems
+ Add VERSIONS section
-fallocate.2
+ioctl_getfsmap.2
Darrick J. Wong
- Document behavior with shared blocks
- Note that FALLOC_FL_UNSHARE may use CoW to unshare blocks to
- guarantee that a disk write won't fail with ENOSPC.
-
-fanotify_mark.2
- Heinrich Schuchardt
- Mention FAN_Q_OVERFLOW
- To receive overflow events it is necessary to set this bit
- in fanotify_mark().
-
-fcntl.2
- Michael Kerrisk
- F_GETPIPE_SZ allocates next power-of-2 multiple of requested size
- Add some detail about current implementation, since this helps
- the user understand the effect of the user pipe limits added in
- Linux 4.5 (described in pipe(7)).
+ Document the GETFSMAP ioctl
+ Document the new GETFSMAP ioctl that returns the physical layout of a
+ (disk-based) filesystem.
Michael Kerrisk
- Add EPERM that occurs for F_SETPIPE_SZ when user pipe limit is reached
-
-fideduperange.2
- Darrick J. Wong [Omar Sandoval]
- Fix the discussion of maximum sizes
- Fix the discussion of the limitations on the dest_count and
- src_length parameters to the fideduperange ioctl() to reflect
- what's actually in the kernel.
+ ERRORS: order alphabetically
-fsync.2
+madvise.2
Michael Kerrisk
- SEE ALSO: add fileno(3)
- fileno(3) is useful if one is combining fflush(3)/fclose(3)
- and fsync(2).
+ Remove bogus text re POSIX_MADV_NOREUSE
+ There is a POSIX_FADV_NOREUSE for posix_fadvise(),
+ but no POSIX_MADV_NOREUSE for any API in POSIX.
+
+membarrier.2
Michael Kerrisk
- SEE ALSO: add fflush(3)
+ Add ENOSYS error for 'nohz_full' CPU setting
-getgroups.2
- Andrew Clayton
- FTM requirements fix for setgroups(2)
+mount.2
+ NeilBrown
+ Revise description of MS_REMOUNT | MS_BIND
+ MS_REMOUNT|MS_BIND affects all per-mount-point
+ flag. MS_RDONLY is only special because it,
+ uniquely, is both a per-mount-point flag *and* a
+ per-filesystem flag.
-gethostname.2
- Michael Kerrisk
- SEE ALSO: add hostname(1)
+ So the sections of per-mount-point flags and
+ MS_REMOUNT can usefully be clarified.
-get_mempolicy.2
+open.2
Michael Kerrisk
- Note that 'addr' must be NULL when 'flags' is 0
+ Note some further advantages of the *at() APIs
-getpriority.2
- Michael Kerrisk
- Warn that autogrouping voids the effect of 'nice' in many cases
- Refer the reader to sched(7) for the details.
- Michael Kerrisk
- Expand discussion of getpriority() return value
- Michael Kerrisk
- The nice value supplied to setpriority() is clamped
- Note that the nice value supplied to setpriority() is clamped
- to the permitted range.
+pipe.2
Michael Kerrisk
- Improve description of setpriority() return value
+ SEE ALSO: add tee(2) and vmsplice(2)
-getpriority.2
-sched.7
+readv.2
Michael Kerrisk
- Move nice value details from getpriority(2) to sched(7)
- Centralizing these details in sched(7) is more logical.
+ glibc 2.26 adds library support for preadv2() and pwritev2()
-getrandom.2
-random.4
+sched_setaffinity.2
Michael Kerrisk
- Consolidate and improve discussion on usage of randomness
- Currently, recommendations on how to consume randomness are
- spread across both getrandom(2) and random(4) and the general
- opinion seems to be that the text in getrandom(2) does a
- somewhat better job. Consolidate the discussion to a single
- page (getrandom(2)) and address some of the concerns
- expressed about the existing text in random(4).
- [Some of this text ultimately made its way into the new
- random(7) page.]
+ Mention cpuset cgroups as a cause of EINVAL error
-getrandom.2
- Michael Kerrisk
- Remove material incorporated into random(7)
- Michael Kerrisk
- Note advantages of fact that getrandom() doesn't use file descriptors
- Michael Kerrisk
- Clarify that getrandom() is not "reading" from /dev/{random,urandom}
+seccomp.2
+ Mike Frysinger
+ Expand SECCOMP_RET_KILL documentation
-getrlimit.2
- Michael Kerrisk
- Refer to sched(7) in discussion of RLIMIT_RTPRIO and RLIMIT_RTTIME
+sigaction.2
Michael Kerrisk
- Describe the range of the RLIMIT_NICE limit
+ Note feature test macro requirements for 'si_code' constants
Michael Kerrisk
- Refer to sched(7) in the discussion of RLIMIT_NICE
+ Add a subheading for the description of 'si_code'
Michael Kerrisk
- SEE ALSO: add credentials(7)
-
-ioctl_ficlonerange.2
-ioctl_fideduperange.2
- Darrick J. Wong
- Clarify the behavior of the FIDEDUPERANGE ioctl
+ TRAP_BRANCH and TRAP_HWBKPT are present only on IA64
-kill.2
+sigaltstack.2
Michael Kerrisk
- SEE ALSO: add kill(1)
-
-mbind.2
- Michael Kerrisk [Christoph Lameter]
- Memory policy is a per-thread attribute, not a per-process attribute
-
-mbind.2
-set_mempolicy.2
- Piotr Kwapulinski [Christoph Lameter, Michael Kerrisk]
- Add MPOL_LOCAL NUMA memory policy documentation
+ Note that specifying SS_ONSTACK in ss.ss_flags decreases portability
+ In the Illumos source (which presumably mirrors its Solaris
+ ancestry), there is this check in the sigaltstack()
+ implementation:
-mount.2
- Michael Kerrisk
- SEE ALSO: add mountpoint(1)
+ if (ss.ss_flags & ~SS_DISABLE)
+ return (set_errno(EINVAL));
-mprotect.2
- Michael Kerrisk
- CONFORMING TO: note that pkey_mprotect() is Linux-specific
+ And in the FreeBSD source we find similar:
-nice.2
- Michael Kerrisk
- Warn that autogrouping voids the effect of 'nice' in many cases
- Michael Kerrisk
- CONFORMING TO: Remove an ancient SVr4 detail on errno values
- Michael Kerrisk
- Rework discussion of nice() return value and standards conformance
- Make the text a little clearer. In particular, clarify that the
- raw system call (still) returns 0 on success.
- Michael Kerrisk
- Clarify the range of the nice value, and note that it is clamped
+ if ((ss->ss_flags & ~SS_DISABLE) != 0)
+ return (EINVAL);
Michael Kerrisk
- Add mention of RLIMIT_NICE
+ Note buggy addition of ss.ss_flags==SS_ONSTACK
+ Note buggy addition of ss.ss_flags==SS_ONSTACK as a synonym
+ for ss_flags==0. No other implemenation does this, AFAIK.
+ And it was not needed :-(.
Michael Kerrisk
- Move discussion of handling the -1 success return to RETURN VALUE
- This detail was rather hidden in NOTES. Also, rework the text
- a little.
+ Specifying 'ss' returns the current settings without changing them
Michael Kerrisk
- Clarify that nice() changes the nice value of the calling *thread*
+ Give 'oss' argument a more meaningful name: 'old_ss'
Michael Kerrisk
- Add "C library/kernel differences" subsection heading
+ Some minor reworking of the text
Michael Kerrisk
- Add reference to sched(7) for further details on the nice value
+ ERRORS: update description of EINVAL error
-open.2
- Michael Kerrisk
- ubifs supports O_TMPFILE starting with Linux 4.9
+splice.2
+tee.2
+vmsplice.2
Michael Kerrisk
- Document ENOMEM that occurs when opening FIFO because of pipe hard limit
+ SEE ALSO: add pipe(7)
-perf_event_open.2
- Vince Weaver
- Add cycles field in LBR records
- Linux 4.3 added a cycles field to the PERF_SAMPLE_BRANCH_STACK
- last branch records.
- Vince Weaver
- Update time_shift sample code
- Linux 4.3 improved the accuracy of the clock/ns conversion routines.
+splice.2
Michael Kerrisk
- Clarify the use of signals for capturing overflow events
-
-pipe.2
+ ERRORS: split EINVAL error cases
Michael Kerrisk
- Add ENFILE error for user pipe hard limit reached
+ ERRORS: add EINVAL for case where both descriptors refer to same pipe
-prctl.2
- Eugene Syromyatnikov
- Some additional details regarding the PR_GET_UNALIGNED operation
- Eugene Syromyatnikov
- Note the output buffer size for PR_GET_TID_ADDRESS operation on x32/n32
+timer_create.2
Michael Kerrisk
- Remove numeric definitions of PR_FP_MODE_FR and PR_FP_MODE_FRE bits
-
-ptrace.2
- Keno Fischer
- Document the behavior of PTRACE_SYSEMU stops
- Keno Fischer
- Expand documentation PTRACE_EVENT_SECCOMP traps
- In Linux 4.8, the order of PTRACE_EVENT_SECCOMP and
- syscall-entry-stops was reversed. Document both behaviors and
- their interaction with the various forms of restart.
+ Document the CONFIG_POSIX_TIMERS option added in Linux 4.10
-quotactl.2
- Eugene Syromyatnikov
- Describe Q_XQUOTASYNC, which is present but no-op in recent kernels
-
-reboot.2
- Wang Long
- Note errors for invalid commands inside a PID namespace
-
-sched_setattr.2
+wait.2
Michael Kerrisk
- Fix cross reference for further info on the nice value
- The information moved from getpriority(2) to sched(7).
+ Note glibc 2.26 changes to feature test macro requirements for waitid()
-sched_setscheduler.2
- Michael Kerrisk [Daniel Berrange]
- Mention SCHED_DEADLINE
- Give the reader a clue that there is another policy
- available that can't be set via sched_setscheduler(2).
+acosh.3
+asinh.3
+atanh.3
+ Alex Henrie
+ Remove C89 designation.
+ See https://bugzilla.kernel.org/show_bug.cgi?id=196319
-seccomp.2
- Jann Horn
- Document changed interaction with ptrace
- Before kernel 4.8, the seccomp check will not be run again
- after the tracer is notified. Fixed in kernel 4.9.
- Michael Kerrisk
- NOTES: mention ptrace(PTRACE_SECCOMP_GET_FILTER) to dump seccomp filters
+ [mtk: confirmed from review of draft of C90 standard]
-set_mempolicy.2
+bsd_signal.3
Michael Kerrisk
- Reformat list of modes
+ Note feature test macro requirements changes for glibc 2.26
-setsid.2
+dl_iterate_phdr.3
Michael Kerrisk
- Improve wording of text on calling setsid() after fork()+_exit()
+ dl_iterate_phdr() shows the order in which objects were loaded
+ dl_iterate_phdr() tells us not just which objects are
+ loaded, but also the order in which they are loaded
+ (the "link-map order"). Since the order is relevant for
+ understanding symbol resolution, give the reader this clue.
Michael Kerrisk
- SEE ALSO: add sched(7)
- List sched(7), because setsid(2) is part of the machinery
- of autogrouping.
-
-sigaction.2
- Dave Hansen
- Further documentation of SEGV_PKUERR
-
-signalfd.2
- Michael Kerrisk
- Document ssi_addr_lsb field of signalfd_siginfo
-
-symlink.2
+ Expand the code example, and show sample output
Michael Kerrisk
- SEE ALSO: add namei(1)
+ List values for the 'p_type' field
-sync_file_range.2
+dlsym.3
Michael Kerrisk
- Fix description for ESPIPE error
- A file descriptor can't refer to a symbolic link.
+ _GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
-syscalls.2
- Michael Kerrisk
- Add pkey_alloc(), pkey_free(), and pkey_mprotect()
- New system calls in Linux 4.9.
- Michael Kerrisk
- Add ppc_swapcontext(2)
-
-timer_create.2
- Michael Kerrisk
- Document CLOCK_BOOTTIME
+flockfile.3
Michael Kerrisk
- Document CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
+ Note glibc 2.24 feature test macro requirement changes
-timerfd_create.2
+fpathconf.3
Michael Kerrisk
- Document CLOCK_BOOTTIME, CLOCK_REALTIME_ALARM, and CLOCK_BOOTTIME_ALARM
+ Rework RETURN VALUE description to add more detail
Michael Kerrisk
- Document TFD_TIMER_CANCEL_ON_SET
+ Add an errors section
Michael Kerrisk
- Rework discussion on relative and absolute timers
-
-unlink.2
+ Largely rewrite the description of _PC_CHOWN_RESTRICTED
Michael Kerrisk
- SEE ALSO: add unlink(2)
+ Rewrite description of _PC_PIPE_BUF
+ The existing description was not accurate, and lacked details.
-utime.2
-utimensat.2
+ftw.3
Michael Kerrisk
- SEE ALSO: add touch(1)
+ BUGS: document a probable glibc regression in FTW_SLN case
+ See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+ and http://austingroupbugs.net/view.php?id=1121.
-wait.2
- Michael Kerrisk
- On some architectures, waitpid() is a wrapper that calls wait4().
+getaddrinfo.3
+ Quentin Rameau
+ Fix _POSIX_C_SOURCE value for getaddrinfo()
+ The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.
-atof.3
- Wainer dos Santos Moschetta
- SEE ALSO: add strfromd(3)
+getcontext.3
+ Carlos O'Donell
+ Exemplar structure should use 'ucontext_t'.
+ In glibc we just finished a round of purging 'struct ucontext'
+ which is not in the POSIX reserved namespace of *_t tags. This has
+ some consequences to applications using the non-standard struct
+ ucontext:
+ https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
+ but it also fixes a namespace conformance issue which is always a
+ longterm pain for large portable programs.
-ctime.3
- Michael Kerrisk
- Add ERRORS section
- Michael Kerrisk
- RETURN VALUE: describe return values more explicitly
+ It was noted by Peter Maydell
+ (https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
+ linux man pages still had references to 'struct ucontext' but only
+ in the form of an exemplar structure.
-errno.3
- Michael Kerrisk [Igor Liferenko]
- Add glibc error text for EILSEQ
+ The patch fixes the exemplar to match what is in glibc
+ and therefore it won't ever suggest users can use 'struct
+ ucontext'.
-fclose.3
-fflush.3
+getgrent.3
Michael Kerrisk
- SEE ALSO: add fileno(2)
+ Note glibc 2.22 changes for feature test macro requirements
-getlogin.3
- Michael Kerrisk
- Remove deprecated _REENTRANT from FTM requirements for getlogin_r()
- Michael Kerrisk
- SEE ALSO: add logname(1)
+grantpt.3
+ptsname.3
+unlockpt.3
+ Ferdinand Thiessen [Michael Kerrisk]
+ Update feature test macro-requirements for glibc 2.24
-isalpha.3
- Michael Kerrisk
- Note circumstances where 'c' must be cast to 'unsigned char'
+if_nametoindex.3
+ Douglas Caetano dos Santos
+ Add ENODEV error for if_nametoindex()
+ Checked against glibc and kernel code: when given name isn't
+ a valid interface, kernel returns ENODEV and glibc just
+ forwards it.
-killpg.3
+malloc.3
Michael Kerrisk
- Move killpg.2 from section to to section 3
+ Document the reallocarray() added in glibc 2.26
-mallopt.3
- Michael Kerrisk [Siddhesh Poyarekar]
- Document 0 as default value of M_ARENA_MAX and explain its meaning
- Michael Kerrisk
- Improve description of M_ARENA_TEST
+nl_langinfo.3
Michael Kerrisk
- Document default value for M_ARENA_TEST
- Michael Kerrisk
- Note default value of M_PERTURB
+ Note feature test macro requirements for nl_langinfo_l()
-mbsnrtowcs.3
- Michael Kerrisk [Igor Liferenko]
- Note behavior of mbsnrtowcs() for an incomplete character
- Note the behavior of mbsnrtowcs() when an incomplete character
- is found at end of the input buffer.
+posix_madvise.3
+ Dr. Tobias Quathamer
+ Remove paragraph about POSIX_FADV_NOREUSE
+ POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
+ corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.
-mbstowcs.3
-wcstombs.3
- Michael Kerrisk [Igor Liferenko]
- Improve language relating to "initial state"
- See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=839705
+ Thanks to Marc Lehmann <debian-reportbug@plan9.de>
+ See https://bugs.debian.org/865699
-mbstowcs.3
- Michael Kerrisk [Igor Liferenko]
- Add missing include to example program
- See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=845172
+ptsname.3
+ Michael Kerrisk [Arjun Shankar]
+ Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
-mq_close.3
+rand.3
Michael Kerrisk
- DESCRIPTION: add reference to mq_notify(3)
-
-mq_open.3
- Eugene Syromyatnikov
- Clarification regarding usage of mq_flags attribute in mq_open()
-
-mq_receive.3
-mq_send.3
- Eugene Syromyatnikov
- Clarification regarding reasons behind EBADF
-
-printf.3
- Wainer dos Santos Moschetta
- SEE ALSO: add strfromd(3)
+ Note glibc 2.24 feature test macro requirement changes for rand_r()
-pthread_attr_init.3
+resolver.3
Michael Kerrisk
- SEE ALSO: add pthread_setattr_default_np(3)
+ Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
-pthread_create.3
+sigpause.3
Michael Kerrisk
- SEE ALSO: add pthread_setattr_default_np(3)
+ Note glibc 2.26 changes to feature test macro requirements
-ptsname.3
- Michael Kerrisk
- Note that ptsname_r() is proposed for future inclusion in POSIX.1
+sigwait.3
Michael Kerrisk
- CONFORMING TO:: clarify that only ptsname() is standardized (so far)
+ Note glibc 2.26 feature test macro changes
-remainder.3
- Michael Kerrisk
- Note fix to remainder(nan(""), 0) handling
- The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6779
- has been fixed in glibc 2.15.
- Michael Kerrisk
- Document fixes for EDOM handling for range errors
- The bug http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783
- was fixed in glibc 2.15.
+strtol.3
+ Heinrich Schuchardt
+ Mention 0X prefix
+ The prefix 0x may be capitalized as 0X.
-setjmp.3
- Michael Kerrisk
- _BSD_SOURCE must be *explicitly* defined to get BSD setjmp() semantics
+ See ISO/IEC 9899:1999.
-strtod.3
- Wainer dos Santos Moschetta
- SEE ALSO: add strfromd(3)
+sysconf.3
+ Michael Kerrisk [Pavel Tikhomirov]
+ Rework RETURN VALUE description to add more detail
+ Make the discussion clearer, and add a few details.
+ Also, fix the problem report from Pavel Tikhomirov
+ who noted that the man page falsely said that errno
+ is not changed on a successful return.
-tgamma.3
- Michael Kerrisk
- Document fixes to give ERANGE for underflow range error
- The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6810
- was fixed in glibc 2.19.
+ Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955
-timegm.3
+sysconf.3
Michael Kerrisk
Add ERRORS section
- Michael Kerrisk [Vincent Lefevre]
- Add RETURN VALUE section
-tmpnam.3
+ttyslot.3
Michael Kerrisk
- Properly document tmpnam_r(3)
-
-toupper.3
+ Fix error in feature test macro requirements
Michael Kerrisk
- Note circumstances where 'c' must be cast to 'unsigned char'
-
-ttyname.3
+ Note feature test macro requirements changes in glibc 2.24
Michael Kerrisk
- SEE ALSO: add tty(1)
+ Clarify details of use of <stdlib.h> file
-console_ioctl.4
+unlocked_stdio.3
Michael Kerrisk
- Add brief descriptive text for KDGKBMODE modes
- Miroslav Koskar
- Add K_OFF keyboard mode
-
-random.4
- Michael Kerrisk
- Add reference to new random(7) page
- Michael Kerrisk
- Rework formatting of /proc interfaces
- Make the information easier to parse by formatting the file
- descriptions as hanging lists. No significant content changes.
- Nikos Mavrogiannopoulos [Laurent Georget]
- Provide a more accurate description of /dev/urandom
- This documents the "property" of /dev/urandom of being able to
- serve numbers prior to pool being initialized, and removes any
- suggested usages of /dev/random which are disputable
- (i.e., one-time pad). Document the fact /dev/random is only
- suitable for applications which can afford indeterminate delays
- since very few applications can do so. Smooth the alarming
- language about a theoretical attack, and mention that its
- security depends on the cryptographic primitives used by the
- kernel, as well as the total entropy gathered.
- Michael Kerrisk [Laurent Georget, Theodore Ts'o]
- Improve discussion of /dev/urandom, blocking reads, and signals
- The text currently states that O_NONBLOCK has no effect for
- /dev/urandom, which is true. It also says that reads from
- /dev/urandom are nonblocking. This is at the least confusing.
- If one attempts large reads (say 10MB) from /dev/urandom
- there is an appreciable delay, and interruption by a signal
- handler will result in a short read. Amend the text to
- reflect this.
+ Note glibc 2.24 feature test macro requirement changes
elf.5
- Mike Frysinger
- Add subsection headers at major points
- The current pages dumps all the content into one big DESCRIPTION
- with no real visual break up between logically independent
- sections. Add some subsection headers to make it easier to
- read and scan.
- Mike Frysinger
- Document notes
- Document the Elf{32,64}_Nhdr structure, the sections/segments that
- contain notes, and how to interpret them. I've been lazy and only
- included the GNU extensions here, especially as others are not
- defined in the elf.h header file as shipped by glibc.
-
-filesystems.5
Michael Kerrisk
- SEE ALSO: add fuse(4)
+ SEE ALSO: add dl_iterate_phdr(3)
-proc.5
- Dave Hansen
- Describe new ProtectionKey 'smaps' field
- Michael Kerrisk
- Add example ProtectionKey output for 'smaps' file
- Michael Kerrisk
- Add pointers to sched(7) for autogroup files
- sched(7) describes /proc/sys/kernel/sched_autogroup_enabled
- and /proc/PID/autogroup.
- Michael Kerrisk
- Add /proc/sys/fs/pipe-user-pages-{hard,soft} entries
- Michael Kerrisk
- Improve description of the KernelPageSize and MMUPageSize 'smaps' fields
- Michael Kerrisk
- Rework 'smaps' ProtectionKey text and add some details
- Michael Kerrisk
- Mention lslocks(8) in discussion of /proc/locks
- Michael Kerrisk
- Describe Shmem field of /proc/meinfo
- Michael Kerrisk
- Rework 'smaps' VmFlags text, and add kernel version and example output
+nsswitch.conf.5
+ DJ Delorie
+ Clarify group merge rules
+ This minor patch clarifies when merging is not done,
+ and how duplicate entries are merged.
+
+ Found while extending glibc's NSS test suite, discussed with glibc
+ team and Stephen Gallagher.
proc.5
-pipe.7
Michael Kerrisk
- Move /proc/sys/fs/pipe-max-size content from proc(5) to pipe(7)
+ Document that 'iowait' field of /proc/stat is unreliable
+ Text taken from Chao Fan's kernel commit 9c240d757658a3ae996.
-resolv.conf.5
- Carlos O'Donell [Florian Weimer]
- Timeout does not map to resolver API calls
+slabinfo.5
+ Michael Kerrisk [Jorge Nerin]
+ SEE ALSO: add some references to relevant kernel source files
-utmp.5
+tmpfs.5
Michael Kerrisk
- SEE ALSO: add users(1)
+ SEE ALSO: add memfd_create(2), mmap(2), shm_open(3)
capabilities.7
Michael Kerrisk
- CAP_SYS_ADMIN governs ptrace(2) PTRACE_SECCOMP_GET_FILTER
+ Clarify the effect on process capabilities when UID 0 does execve(2)
Michael Kerrisk
- CAP_SYS_ADMIN allows privileged ioctl() operations on /dev/random
-
-cgroups.7
+ Note effect on capabilities when a process with UID != 0 does execve(2)
+ Michael Kerrisk [David Lewis]
+ Fix reversed descriptions of CAP_MAC_OVERRIDE and CAP_MAC_ADMIN
Michael Kerrisk
- Add details on 'cpu' CFS bandwidth control
+ SEE ALSO: add filecap(8), netcap(8), pscap(8)
-credentials.7
+cgroup_namespaces.7
Michael Kerrisk
- SEE ALSO: add setpriv(1)
+ Add some further explanation of the example shell session
Michael Kerrisk
- SEE ALSO: add shadow(5)
-
-feature_test_macros.7
- Michael Kerrisk [Zack Weinberg]
- Note that _REENTRANT and _THREAD_SAFE are now deprecated
+ Fix a bug in shell session example
Michael Kerrisk
- Note that "cc -pthread" defines _REENTRANT
+ Some minor wording fixes and clarifications
-inotify.7
+inode.7
Michael Kerrisk
- Note a subtlety of event generation when monitoring a directory
+ Note glibc 2.24 feature test macro changes for S_IFSOCK and S_ISSOCK()
-libc.7
- Michael Kerrisk
- Add a note on why glibc 2.x uses the soname libc.so.6
- Michael Kerrisk
- Add a few historical details on Linux libc4 and libc5
- Just for historical interest. Details taken from
- http://www.linux-m68k.org/faq/glibcinfo.html.
+man.7
+ G. Branden Robinson
+ Undocument "URL" macro in man(7) in favor .UR+.UE
-mdoc.7
+pid_namespaces.7
Michael Kerrisk
- Add a cross-reference to groff_mdoc(7)
+ Mention /proc/[pid]/ns/pid_for_children
-mount_namespaces.7
+pipe.7
Michael Kerrisk
- SEE ALSO: add user_namespaces(7)
+ SEE ALSO: add tee(2) and vmsplice(2)
-mount_namespaces.7
-user_namespaces.7
+sigevent.7
Michael Kerrisk
- Migrate subsection on mount restrictions to mount_namespaces(7)
- This section material in the user_namespaces(7) page was written
- before the creation of the mount_namespaces(7) manual page.
- Nowadays, this material properly belongs in the newer page.
-
-netlink.7
- Dmitry V. Levin
- Document NETLINK_INET_DIAG rename to NETLINK_SOCK_DIAG
- Dmitry V. Levin
- Add references to sock_diag(7)
+ Mention signal.h header file
-pid_namespaces.7
+signal.7
+ Michael Kerrisk [lilydjwg]
+ Since Linux 3.8, read(2) on an inotify FD is restartable with SA_RESTART
+ See https://bugzilla.kernel.org/show_bug.cgi?id=195711
Michael Kerrisk
- Refer to namespaces(7) for information about NS_GET_PARENT
+ read() from an inotify FD is no longer interrupted by a stop signal
+ (Change was in Linux 3.8.)
-pipe.7
- Michael Kerrisk, Vegard Nossum [Vegard Nossum]
- Document /proc files controlling memory usage by pipes
- Document /proc/sys/fs/pipe-max-size and
- /proc/sys/fs/pipe-user-pages-{soft,hard}.
+tcp.7
Michael Kerrisk
- Document pre-Linux 4.9 bugs in pipe limit checking
+ Document value '2' for tcp_timestamps
+ Since Linux 4.10, the value '2' is meaningful for tcp_timestamps
+ Ruben Kerkhof
+ Change default value of tcp_frto
+ The default changed in c96fd3d461fa495400df24be3b3b66f0e0b152f9
+ (Linux 2.6.24).
-sched.7
+ld.so.8
Michael Kerrisk
- Add a new introductory paragraph describing the nice value
- Michael Kerrisk
- Add more precise details on CFS's treatment of the nice value
- Michael Kerrisk
- Mention RLIMIT_NICE in the discussion of the nice value
- Michael Kerrisk
- NOTES: mention cgroups CPU controller
- Michael Kerrisk
- Add introductory sentence mentioning CFS scheduler
+ Greatly expand the explanation of LD_DYNAMIC_WEAK
+ Carlos O'Donell
+ Expand DT_RUNPATH details.
+ ld.so.8: Expand DT_RUNPATH details.
+
+ Every 3 years we get asked why DT_RUNPATH doesn't work like DT_RPATH.
+ The most recent question was here:
+ https://www.sourceware.org/ml/libc-help/2017-06/msg00013.html
+
+ We need to expand the description of DT_RUNPATH to cover this
+ situation and explain that the DT_RUNPATH entries apply only to the
+ immediate DT_NEEDED, not that of another, say dlopen'd child object.
Michael Kerrisk
- Add nice(2), getpriority(2), and setpriority(2) to API list
+ Since glibc 2.2.5, LD_PROFILE is ignored in secure-execution mode
Michael Kerrisk
- Make it clearer that SCHED_OTHER is always scheduled below real-time
+ Make notes on secure-execute mode more prominent
+ Place each note on secure-execution mode in a separate
+ paragraph, to make it more obvious.
Michael Kerrisk
- Give the page a more generic NAME
- The page isn't just about APIs.
-
-standards.7
+ Note that libraries in standard directories are not normally set-UID
+ In secure mode, LD_PRELOAD loads only libraries from standard
+ directories that are marked set-UID. Note that it is unusual for
+ a library to be marked in this way.
Michael Kerrisk
- POSIX.1-2016 (POSIX.1-2008 TC2) has now been released
-
-symlink.7
+ SEE ALSO: add elf(5)
Michael Kerrisk
- SEE ALSO: add namei(1)
-
-uri.7
- Jakub Wilk
- Use "example.com" as example domain
-
-user_namespaces.7
+ Note version where secure-execution started ignoring LD_USE_LOAD_BIAS
Michael Kerrisk
- Add reference to namespaces(7) for NS_GET_USERNS operation
+ Correct glibc version that ignores LD_SHOW_AUXV in secure-execution mode
+ Ignored since 2.3.4 (not 2.3.5).
Michael Kerrisk
- Add reference to namespaces(7) for NS_GET_PARENT operation
+ Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended