Changes

   1 ==================== Changes in man-pages-4.12 ====================
   2
   3 Released: 2017-07-13, London
   4
   5
   6 Contributors
   7 ------------
   8
   9 The following people contributed patches/fixes or (noted in brackets
  10 in the changelog below) reports, notes, and ideas that have been
  11 incorporated in changes in this release:
  12
  13 Alex Henrie <alexhenrie24@gmail.com>
  14 Andi Kleen <andi-bz.firstfloor.org>
  15 Arjun Shankar <arjun.is@lostca.se>
  16 Brad Bendily <bendily@gmail.com>
  17 Cameron Wright <wright18@uw.edu>
  18 Carlos O'Donell <carlos@redhat.com>
  19 Darrick J. Wong <darrick.wong@oracle.com>
  20 David Lewis <davlewi3@cisco.com>
  21 DJ Delorie <dj@delorie.com>
  22 Douglas Caetano dos Santos <douglascs@taghos.com.br>
  23 Dr. Tobias Quathamer <toddy@debian.org>
  24 Eric Biggers <ebiggers@google.com>
  25 Ferdinand Thiessen <f.thiessen@gmx.de>
  26 G. Branden Robinson <g.branden.robinson@gmail.com>
  27 Heinrich Schuchardt <xypron.glpk@gmx.de>
  28 Henry Bent <henry.r.bent@gmail.com>
  29 Jakub Wilk <jwilk@jwilk.net>
  30 Janne Snabb <snabb@epipe.com>
  31 Joe Brown <joe.brown.89@outlook.com>
  32 Jorge Nerin <jnerin@gmail.com>
  33 Kirill Tkhai <ktkhai@virtuozzo.com>
  34 lilydjwg <lilydjwg@gmail.com>
  35 Long Wang <w@laoqinren.net>
  36 Michael Kerrisk <mtk.manpages@gmail.com>
  37 Mike Frysinger <vapier@chromium.org>
  38 Nadav Har'El <nyh@math.technion.ac.il>
  39 NeilBrown <neilb@suse.com>
  40 Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
  41 Quentin Rameau <quinq@fifth.space>
  42 Ruben Kerkhof <ruben@rubenkerkhof.com>
  43 sulit <sulitsrc@foxmail.com>
  44 石井大貴 <hiroki.ishii@miraclelinux.com>
  45
  46 Apologies if I missed anyone!
  47
  48
  49 Newly documented interfaces in existing pages
  50 ---------------------------------------------
  51
  52 namespaces.7
  53     Kirill Tkhai  [Michael Kerrisk]
  54         Document the /proc/[pid]/ns/pid_for_children file
  55
  56
  57 Changes to individual pages
  58 ---------------------------
  59
  60 ldd.1
  61     Michael Kerrisk
  62         'objdump -p prog | grep NEEDED' doesn't give quite same info as 'ldd'
  63
  64 chmod.2
  65     Michael Kerrisk
  66         Put fchmod() feature test macro requirements in a more readable format
  67     Michael Kerrisk
  68         Note glibc 2.24 feature test macro requirements changes for fchmod()
  69
  70 chown.2
  71     Michael Kerrisk
  72         When file owner or group is changed, file capabilities are cleared
  73     Michael Kerrisk
  74         Changes to file owner by root also clear set-UID and set-GID bits
  75
  76 clone.2
  77     Michael Kerrisk
  78         Update BUGS to reflect fact that PID caching was removed in glibc 2.25
  79
  80 epoll_wait.2
  81     Michael Kerrisk
  82         Clarify semantics of returned 'data' field
  83             The returned 'data' is the 'data' most recently set via
  84             epoll_ctl().
  85
  86 get_mempolicy.2
  87     Michael Kerrisk  [Nadav Har'El, Andi Kleen]
  88         SYNOPSIS: fix return type of get_mempolicy()
  89             See https://bugzilla.kernel.org/show_bug.cgi?id=97051
  90
  91 getpid.2
  92     Carlos O'Donell, Michael Kerrisk
  93         Note that PID caching is removed as of glibc 2.25
  94             Since glibc 2.25 the PID cache is removed.
  95
  96             Rationale given in the release notes:
  97             https://sourceware.org/glibc/wiki/Release/2.25#pid_cache_removal
  98
  99 ioctl.2
 100     Michael Kerrisk
 101         SEE ALSO: add ioctl_getfsmap(2)
 102
 103 ioctl_getfsmap.2
 104     Michael Kerrisk
 105         Fix ordering of sections
 106     Michael Kerrisk
 107         Add VERSIONS section
 108
 109 ioctl_getfsmap.2
 110     Darrick J. Wong
 111         Document the GETFSMAP ioctl
 112             Document the new GETFSMAP ioctl that returns the physical layout of a
 113             (disk-based) filesystem.
 114     Michael Kerrisk
 115         ERRORS: order alphabetically
 116
 117 madvise.2
 118     Michael Kerrisk
 119         Remove bogus text re POSIX_MADV_NOREUSE
 120             There is a POSIX_FADV_NOREUSE for posix_fadvise(),
 121             but no POSIX_MADV_NOREUSE for any API in POSIX.
 122
 123 membarrier.2
 124     Michael Kerrisk
 125         Add ENOSYS error for 'nohz_full' CPU setting
 126
 127 mount.2
 128     NeilBrown
 129         Revise description of MS_REMOUNT | MS_BIND
 130             MS_REMOUNT|MS_BIND affects all per-mount-point
 131             flag.  MS_RDONLY is only special because it,
 132             uniquely, is both a per-mount-point flag *and* a
 133             per-filesystem flag.
 134
 135             So the sections of per-mount-point flags and
 136             MS_REMOUNT can usefully be clarified.
 137
 138 open.2
 139     Michael Kerrisk
 140         Note some further advantages of the *at() APIs
 141
 142 pipe.2
 143     Michael Kerrisk
 144         SEE ALSO: add tee(2) and vmsplice(2)
 145
 146 readv.2
 147     Michael Kerrisk
 148         glibc 2.26 adds library support for preadv2() and pwritev2()
 149
 150 sched_setaffinity.2
 151     Michael Kerrisk
 152         Mention cpuset cgroups as a cause of EINVAL error
 153
 154 seccomp.2
 155     Mike Frysinger
 156         Expand SECCOMP_RET_KILL documentation
 157
 158 sigaction.2
 159     Michael Kerrisk
 160         Note feature test macro requirements for 'si_code' constants
 161     Michael Kerrisk
 162         Add a subheading for the description of 'si_code'
 163     Michael Kerrisk
 164         TRAP_BRANCH and TRAP_HWBKPT are present only on IA64
 165
 166 sigaltstack.2
 167     Michael Kerrisk
 168         Note that specifying SS_ONSTACK in ss.ss_flags decreases portability
 169             In the Illumos source (which presumably mirrors its Solaris
 170             ancestry), there is this check in the sigaltstack()
 171             implementation:
 172
 173                            if (ss.ss_flags & ~SS_DISABLE)
 174                                     return (set_errno(EINVAL));
 175
 176             And in the FreeBSD source we find similar:
 177
 178                             if ((ss->ss_flags & ~SS_DISABLE) != 0)
 179                                     return (EINVAL);
 180     Michael Kerrisk
 181         Note buggy addition of ss.ss_flags==SS_ONSTACK
 182             Note buggy addition of ss.ss_flags==SS_ONSTACK as a synonym
 183             for ss_flags==0. No other implemenation does this, AFAIK.
 184             And it was not needed :-(.
 185     Michael Kerrisk
 186         Specifying 'ss' returns the current settings without changing them
 187     Michael Kerrisk
 188         Give 'oss' argument a more meaningful name: 'old_ss'
 189     Michael Kerrisk
 190         Some minor reworking of the text
 191     Michael Kerrisk
 192         ERRORS: update description of EINVAL error
 193
 194 splice.2
 195 tee.2
 196 vmsplice.2
 197     Michael Kerrisk
 198         SEE ALSO: add pipe(7)
 199
 200 splice.2
 201     Michael Kerrisk
 202         ERRORS: split EINVAL error cases
 203     Michael Kerrisk
 204         ERRORS: add EINVAL for case where both descriptors refer to same pipe
 205
 206 timer_create.2
 207     Michael Kerrisk
 208         Document the CONFIG_POSIX_TIMERS option added in Linux 4.10
 209
 210 wait.2
 211     Michael Kerrisk
 212         Note glibc 2.26 changes to feature test macro requirements for waitid()
 213
 214 acosh.3
 215 asinh.3
 216 atanh.3
 217     Alex Henrie
 218         Remove C89 designation.
 219             See https://bugzilla.kernel.org/show_bug.cgi?id=196319
 220
 221             [mtk: confirmed from review of draft of C90 standard]
 222
 223 bsd_signal.3
 224     Michael Kerrisk
 225         Note feature test macro requirements changes for glibc 2.26
 226
 227 dl_iterate_phdr.3
 228     Michael Kerrisk
 229         dl_iterate_phdr() shows the order in which objects were loaded
 230             dl_iterate_phdr() tells us not just which objects are
 231             loaded, but also the order in which they are loaded
 232             (the "link-map order"). Since the order is relevant for
 233             understanding symbol resolution, give the reader this clue.
 234     Michael Kerrisk
 235         Expand the code example, and show sample output
 236     Michael Kerrisk
 237         List values for the 'p_type' field
 238
 239 dlsym.3
 240     Michael Kerrisk
 241         _GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
 242
 243 flockfile.3
 244     Michael Kerrisk
 245         Note glibc 2.24 feature test macro requirement changes
 246
 247 fpathconf.3
 248     Michael Kerrisk
 249         Rework RETURN VALUE description to add more detail
 250     Michael Kerrisk
 251         Add an errors section
 252     Michael Kerrisk
 253         Largely rewrite the description of _PC_CHOWN_RESTRICTED
 254     Michael Kerrisk
 255         Rewrite description of _PC_PIPE_BUF
 256             The existing description was not accurate, and lacked details.
 257
 258 ftw.3
 259     Michael Kerrisk
 260         BUGS: document a probable glibc regression in FTW_SLN case
 261             See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
 262             and http://austingroupbugs.net/view.php?id=1121.
 263
 264 getaddrinfo.3
 265     Quentin Rameau
 266         Fix _POSIX_C_SOURCE value for getaddrinfo()
 267             The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.
 268
 269 getcontext.3
 270     Carlos O'Donell
 271         Exemplar structure should use 'ucontext_t'.
 272             In glibc we just finished a round of purging 'struct ucontext'
 273             which is not in the POSIX reserved namespace of *_t tags. This has
 274             some consequences to applications using the non-standard struct
 275             ucontext:
 276             https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
 277             but it also fixes a namespace conformance issue which is always a
 278             longterm pain for large portable programs.
 279
 280             It was noted by Peter Maydell
 281             (https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
 282             linux man pages still had references to 'struct ucontext' but only
 283             in the form of an exemplar structure.
 284
 285             The patch fixes the exemplar to match what is in glibc
 286             and therefore it won't ever suggest users can use 'struct
 287             ucontext'.
 288
 289 getgrent.3
 290     Michael Kerrisk
 291         Note glibc 2.22 changes for feature test macro requirements
 292
 293 grantpt.3
 294 ptsname.3
 295 unlockpt.3
 296     Ferdinand Thiessen  [Michael Kerrisk]
 297         Update feature test macro-requirements for glibc 2.24
 298
 299 if_nametoindex.3
 300     Douglas Caetano dos Santos
 301         Add ENODEV error for if_nametoindex()
 302             Checked against glibc and kernel code: when given name isn't
 303             a valid interface, kernel returns ENODEV and glibc just
 304             forwards it.
 305
 306 malloc.3
 307     Michael Kerrisk
 308         Document the reallocarray() added in glibc 2.26
 309
 310 nl_langinfo.3
 311     Michael Kerrisk
 312         Note feature test macro requirements for nl_langinfo_l()
 313
 314 posix_madvise.3
 315     Dr. Tobias Quathamer
 316         Remove paragraph about POSIX_FADV_NOREUSE
 317             POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
 318             corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.
 319
 320             Thanks to Marc Lehmann <debian-reportbug@plan9.de>
 321             See https://bugs.debian.org/865699
 322
 323 ptsname.3
 324     Michael Kerrisk  [Arjun Shankar]
 325         Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
 326
 327 rand.3
 328     Michael Kerrisk
 329         Note glibc 2.24 feature test macro requirement changes for rand_r()
 330
 331 resolver.3
 332     Michael Kerrisk
 333         Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
 334
 335 sigpause.3
 336     Michael Kerrisk
 337         Note glibc 2.26 changes to feature test macro requirements
 338
 339 sigwait.3
 340     Michael Kerrisk
 341         Note glibc 2.26 feature test macro changes
 342
 343 strtol.3
 344     Heinrich Schuchardt
 345         Mention 0X prefix
 346             The prefix 0x may be capitalized as 0X.
 347
 348             See ISO/IEC 9899:1999.
 349
 350 sysconf.3
 351     Michael Kerrisk  [Pavel Tikhomirov]
 352         Rework RETURN VALUE description to add more detail
 353             Make the discussion clearer, and add a few details.
 354             Also, fix the problem report from Pavel Tikhomirov
 355             who noted that the man page falsely said that errno
 356             is not changed on a successful return.
 357
 358             Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955
 359
 360 sysconf.3
 361     Michael Kerrisk
 362         Add ERRORS section
 363
 364 ttyslot.3
 365     Michael Kerrisk
 366         Fix error in feature test macro requirements
 367     Michael Kerrisk
 368         Note feature test macro requirements changes in glibc 2.24
 369     Michael Kerrisk
 370         Clarify details of use of <stdlib.h> file
 371
 372 unlocked_stdio.3
 373     Michael Kerrisk
 374         Note glibc 2.24 feature test macro requirement changes
 375
 376 elf.5
 377     Michael Kerrisk
 378         SEE ALSO: add dl_iterate_phdr(3)
 379
 380 nsswitch.conf.5
 381     DJ Delorie
 382         Clarify group merge rules
 383             This minor patch clarifies when merging is not done,
 384             and how duplicate entries are merged.
 385
 386             Found while extending glibc's NSS test suite, discussed with glibc
 387             team and Stephen Gallagher.
 388
 389 proc.5
 390     Michael Kerrisk
 391         Document that 'iowait' field of /proc/stat is unreliable
 392             Text taken from Chao Fan's kernel commit 9c240d757658a3ae996.
 393
 394 slabinfo.5
 395     Michael Kerrisk  [Jorge Nerin]
 396         SEE ALSO: add some references to relevant kernel source files
 397
 398 tmpfs.5
 399     Michael Kerrisk
 400         SEE ALSO: add memfd_create(2), mmap(2), shm_open(3)
 401
 402 capabilities.7
 403     Michael Kerrisk
 404         Clarify the effect on process capabilities when UID 0 does execve(2)
 405     Michael Kerrisk
 406         Note effect on capabilities when a process with UID != 0 does execve(2)
 407     Michael Kerrisk  [David Lewis]
 408         Fix reversed descriptions of CAP_MAC_OVERRIDE and CAP_MAC_ADMIN
 409     Michael Kerrisk
 410         SEE ALSO: add filecap(8), netcap(8), pscap(8)
 411
 412 cgroup_namespaces.7
 413     Michael Kerrisk
 414         Add some further explanation of the example shell session
 415     Michael Kerrisk
 416         Fix a bug in shell session example
 417     Michael Kerrisk
 418         Some minor wording fixes and clarifications
 419
 420 inode.7
 421     Michael Kerrisk
 422         Note glibc 2.24 feature test macro changes for S_IFSOCK and S_ISSOCK()
 423
 424 man.7
 425     G. Branden Robinson
 426         Undocument "URL" macro in man(7) in favor .UR+.UE
 427
 428 pid_namespaces.7
 429     Michael Kerrisk
 430         Mention /proc/[pid]/ns/pid_for_children
 431
 432 pipe.7
 433     Michael Kerrisk
 434         SEE ALSO: add tee(2) and vmsplice(2)
 435
 436 sigevent.7
 437     Michael Kerrisk
 438         Mention signal.h header file
 439
 440 signal.7
 441     Michael Kerrisk  [lilydjwg]
 442         Since Linux 3.8, read(2) on an inotify FD is restartable with SA_RESTART
 443             See https://bugzilla.kernel.org/show_bug.cgi?id=195711
 444     Michael Kerrisk
 445         read() from an inotify FD is no longer interrupted by a stop signal
 446             (Change was in Linux 3.8.)
 447
 448 tcp.7
 449     Michael Kerrisk
 450         Document value '2' for tcp_timestamps
 451             Since Linux 4.10, the value '2' is meaningful for tcp_timestamps
 452     Ruben Kerkhof
 453         Change default value of tcp_frto
 454             The default changed in c96fd3d461fa495400df24be3b3b66f0e0b152f9
 455             (Linux 2.6.24).
 456
 457 ld.so.8
 458     Michael Kerrisk
 459         Greatly expand the explanation of LD_DYNAMIC_WEAK
 460     Carlos O'Donell
 461         Expand DT_RUNPATH details.
 462             ld.so.8: Expand DT_RUNPATH details.
 463
 464             Every 3 years we get asked why DT_RUNPATH doesn't work like DT_RPATH.
 465             The most recent question was here:
 466             https://www.sourceware.org/ml/libc-help/2017-06/msg00013.html
 467
 468             We need to expand the description of DT_RUNPATH to cover this
 469             situation and explain that the DT_RUNPATH entries apply only to the
 470             immediate DT_NEEDED, not that of another, say dlopen'd child object.
 471     Michael Kerrisk
 472         Since glibc 2.2.5, LD_PROFILE is ignored in secure-execution mode
 473     Michael Kerrisk
 474         Make notes on secure-execute mode more prominent
 475             Place each note on secure-execution mode in a separate
 476             paragraph, to make it more obvious.
 477     Michael Kerrisk
 478         Note that libraries in standard directories are not normally set-UID
 479             In secure mode, LD_PRELOAD loads only libraries from standard
 480             directories that are marked set-UID. Note that it is unusual for
 481             a library to be marked in this way.
 482     Michael Kerrisk
 483         SEE ALSO: add elf(5)
 484     Michael Kerrisk
 485         Note version where secure-execution started ignoring LD_USE_LOAD_BIAS
 486     Michael Kerrisk
 487         Correct glibc version that ignores LD_SHOW_AUXV in secure-execution mode
 488             Ignored since 2.3.4 (not 2.3.5).
 489     Michael Kerrisk
 490         Rewrite LD_DEBUG_OUTPUT description and note that .PID is appended