Changes

   1 ==================== Changes in man-pages-3.76 ====================
   2
   3 Released: ????-??-??, Munich
   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 Adam Jiang <jiang.adam@gmail.com>
  14 Andrea Balboni <andrea.balboni@unimore.it>
  15 Andreas Schwab <schwab@suse.de>
  16 Bernhard Walle <bernhard@bwalle.de>
  17 Carlos O'Donell <carlos@redhat.com>
  18 David Wragg <david@wragg.org>
  19 Florian Westphal <fw@strlen.de>
  20 Heinrich Schuchardt <xypron.glpk@gmx.de>
  21 Huxiaoxiang <huxiaoxiang@huawei.com>
  22 Jan Chaloupka <jchaloup@redhat.com>
  23 Jonathan Wakely <jwakely@redhat.com>
  24 Jonny Grant <jg@jguk.org>
  25 Josh Triplett <josh@joshtriplett.org>
  26 Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
  27 Laurent Georget <laurent.georget@supelec.fr>
  28 Manuel López-Ibáñez <lopezibanez@gmail.com>
  29 Marko Myllynen <myllynen@redhat.com>
  30 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
  31 Mel Gorman <mgorman@suse.de>
  32 Michael Gehring <mg@ebfe.org>
  33 Michael Haardt <michael@moria.de>
  34 Michael Kerrisk <mtk.manpages@gmail.com>
  35 Mike Frysinger <vapier@gentoo.org>
  36 Rasmus Villemoes <rv@rasmusvillemoes.dk>
  37 Richard Weinberger <richard@nod.at>
  38 Rich Felker <dalias@libc.org>
  39 Scott Harvey <scott.harvey@stonybrook.edu>
  40 Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
  41 Simon Newton <nomis52@gmail.com>
  42 Simon Paillard <spaillard@debian.org>
  43 Sven Hoexter <sven@stormbind.net>
  44 Tobias Werth <werth@cs.fau.de>
  45 Weijie Yang <weijie.yang.kh@gmail.com>
  46 Will Newton <will.newton@linaro.org>
  47 Yuri Kozlov <yuray@komyakino.ru>
  48 刘湃 <liupai_work@163.com>
  49 尹杰 <writalnaie@gmail.com>
  50
  51 Apologies if I missed anyone!
  52
  53
  54 New and rewritten pages
  55 -----------------------
  56
  57 adjtimex.2
  58     Laurent Georget
  59         Add fields in struct timex description
  60             This patch updates the man page with the new fields added in
  61             struct timex since last edition of the man page.
  62     Laurent Georget [Michael Kerrisk]
  63         Document ADJ_TAI
  64     Michael Kerrisk
  65         Improve description of ADJ_OFFSET_SINGLESHOT
  66     Michael Kerrisk
  67         Add brief documentation of ADJ_MICRO and ADJ_NANO
  68     Michael Kerrisk
  69         Reformat return value list
  70             And remove numeric values, since they're not needed
  71     Michael Kerrisk
  72         Other 'modes' bits are ignored on ADJ_OFFSET_*
  73             Other bits in 'modes' are ignored if modes contains
  74             ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
  75     Michael Kerrisk
  76         Add nanosecond details
  77             Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
  78     Michael Kerrisk
  79         Document ADJ_OFFSET_SS_READ
  80     Michael Kerrisk
  81         Reformat 'times' flags as list
  82             And remove numeric values, since they're not needed.
  83     Michael Kerrisk
  84         Note effect of ADJ_NANO for ADJ_SETOFFSET
  85     Michael Kerrisk
  86         Add comment noting that timex structure contains padding bytes
  87     Michael Kerrisk
  88         Add more details to description of 'tai' field
  89     Michael Kerrisk
  90         Note meaning of "PLL" abbreviation
  91     Michael Kerrisk
  92         Clarify which 'timex' field is used by each 'modes' bit
  93     Michael Kerrisk
  94         Document timex 'status' bits
  95     Michael Kerrisk
  96         Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
  97     Michael Kerrisk
  98         Update RFC number: RFC 5905 obsoletes RFC 1305
  99     Michael Kerrisk
 100         Briefly document ADJ_SETOFFSET
 101     Michael Kerrisk
 102         Note PPS (pulse per second) fields in timex structure
 103
 104 sigreturn.2
 105     Michael Kerrisk
 106         Add (a lot) more detail on the signal trampoline
 107             And rewrite much of the page.
 108
 109
 110 Newly documented interfaces in existing pages
 111 ---------------------------------------------
 112
 113 proc.5
 114     Bernhard Walle
 115         Document /proc/thread-self
 116             /proc/thread-self has been introduced in Linux 3.17 with
 117             commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
 118     Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
 119         Document "VmSwap" field of /proc/[pid]/status
 120     Florian Westphal
 121         Document /proc/net/netfilter/nfnetlink_queue
 122
 123
 124 Changes to individual pages
 125 ---------------------------
 126
 127 localedef.1
 128     Marko Myllynen
 129         Mention default path for compiled files
 130
 131 clock_nanosleep.2
 132     Michael Kerrisk
 133         Note that 'clock_id' can also be a CPU clock ID
 134
 135 epoll_ctl.2
 136     Michael Kerrisk
 137         Regular files and directories can't be monitored with epoll_ctl()
 138
 139 ioctl.2
 140     Heinrich Schuchardt
 141         Rename 'd' argument to 'fd' in text
 142             In most other manpages file descriptors are called 'fd'.
 143             This patches renames attribute 'd' to 'fd'.
 144
 145 madvise.2
 146     Michael Kerrisk
 147         VERSIONS: Support for madvise() is now configurable
 148             Support for this system call now depends on the
 149             CONFIG_ADVISE_SYSCALLS configuration option.
 150
 151 open.2
 152     Michael Kerrisk
 153         Enhance rationale discussion for openat() and friends
 154
 155 posix_fadvise.2
 156     Mel Gorman
 157         Document the behavior of partial page discard requests
 158             It is not obvious from the interface that partial page discard'
 159             requests are ignored. It should be spelled out.
 160     Michael Kerrisk  [Weijie Yang]
 161         ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
 162     Michael Kerrisk
 163         Support for fadvise64() is now configurable
 164             Support for this system call now depends on the
 165             CONFIG_ADVISE_SYSCALLS configuration option.
 166
 167 prctl.2
 168     Andreas Schwab
 169         Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
 170             The size of the process name has always been at most 16 byte
 171             _including_ the null terminator.  This also means that the
 172             name returned by PR_GET_NAME is always null-terminated.
 173     Michael Kerrisk
 174         PR_SET_NAME silently truncates strings that exceed 16 bytes
 175
 176 restart_syscall.2
 177     Michael Kerrisk
 178         Add some text explaining why restart_syscall() exists
 179
 180 sched_setaffinity.2
 181     Michael Kerrisk
 182         NOTES: Add paragraph on how to discover set of CPUs available on system
 183     Michael Kerrisk
 184         SEE ALSO: add nproc(1) and lscpu(1)
 185
 186 select.2
 187     Michael Kerrisk
 188         SEE ALSO: add restart_syscall(2)
 189
 190 semop.2
 191     Michael Kerrisk
 192         Add note that interrupted semtimedop() returns 'timeout' unchanged
 193     Michael Kerrisk
 194         Remove information about semtimedop() EAGAIN that is repeated elsewhere
 195     Michael Kerrisk
 196         Add subsection head for semtimedop()
 197
 198 setsid.2
 199     Michael Kerrisk
 200         Rewrite some pieces and add some details
 201             Among other changes, add an explanation of why setsid() can't
 202             be called from a process group leader
 203
 204 sgetmask.2
 205     Michael Kerrisk
 206         Since 3.16, support for these system call is configurable
 207             Support for these calls is now dependent on the setting of the
 208             CONFIG_SGETMASK_SYSCALL option.
 209
 210 sigaction.2
 211     Michael Kerrisk
 212         Document SA_RESTORER
 213     Michael Kerrisk
 214         Add some detail on the sa_restorer field
 215     Michael Kerrisk
 216         SEE ALSO: add sigreturn(2)
 217
 218 splice.2
 219     Michael Kerrisk
 220         Reformat description of 'fd_in' and 'off_in' to improve readability
 221
 222 syscall.2
 223     Michael Kerrisk
 224         SEE ALSO: add errno(3)
 225
 226 syscalls.2
 227     Michael Kerrisk
 228         SEE ALSO: add errno(3)
 229     Michael Kerrisk
 230         3.19 adds execveat()
 231     Michael Kerrisk
 232         Add bpf(2) to list
 233
 234 tee.2
 235     Michael Kerrisk
 236         Add shell session demonstrating use of the example program
 237
 238 tkill.2
 239     Michael Kerrisk  [Rich Felker]
 240         Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
 241
 242 abort.3
 243     Michael Kerrisk
 244         Note that SIGABRT is raised as though raise(3) is called
 245             Also note that abort is POSIX.1-2008 compliant.
 246
 247 cmsg.3
 248     David Wragg
 249         ensure buf is suitably aligned in sending example
 250             Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
 251             the suggested definition in RFC3542) shows that it yields the
 252             msg_control field.  So when sending, the pointer placed in
 253             msg_control should be suitably aligned as a struct cmsghdr.
 254             In the sending example, buf was declared as a bare char array,
 255             and so is not necessarily suitably aligned.
 256
 257             The solution here involves placing buf inside a union, and is
 258             based on the sockets/scm_rights_send.c sample from The Linux
 259             Programming Interface "dist" source code collection.
 260
 261 exp10.3
 262     Michael Kerrisk
 263         Before glibc 2.19, exp() did not give ERANGE error on underflow
 264             http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
 265
 266 ftw.3
 267     Michael Kerrisk
 268         FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
 269
 270 getopt.3
 271     Michael Kerrisk  [Jonny Grant]
 272         Ensure that 'nsecs' is used
 273
 274 ilogb.3
 275     Michael Kerrisk  [Will Newton]
 276         Since glibc 2.16, ilogb() does correctly diagnose domain errors
 277
 278 memcmp.3
 279     Michael Haardt
 280         Document return value for n==0 case
 281     Michael Haardt
 282         Warn against use of memcmp() for comparing security-critical data
 283
 284 mq_open.3
 285     Michael Kerrisk
 286         Document the O_CLOEXEC flag
 287     Michael Kerrisk
 288         Place 'flags' constants in alphabetical order
 289
 290 pow.3
 291     Manuel López-Ibáñez
 292         Add note on performance characteristics of pow()
 293
 294 pthread_setschedparam.3
 295     Simon Newton
 296         Fix logic error in example program
 297             The example program will crash if -A is used, since 'attr'
 298             is uninitialized.
 299
 300                 $ ./a.out  -A
 301                 *** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
 302                 Aborted (core dumped)
 303     刘湃
 304         Small fixes to example program
 305
 306 sigvec.3
 307     Michael Kerrisk
 308         Starting with version 2.21, glibc no longer exports sigvec()
 309
 310 sysconf.3
 311     Josh Triplett
 312         Document _SC_NGROUPS_MAX
 313             Already documented in getgroups(2), but not in sysconf(3).
 314
 315 termios.3
 316     Michael Kerrisk
 317         SEE ALSO: add tset(1)
 318
 319 tgamma.3
 320     Michael Kerrisk
 321         Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
 322
 323 wordexp.3
 324     Carlos O'Donell
 325         Make it clear that WRDE_NOCMD prevents command substitution
 326             The use of WRDE_NOCMD prevents command substitution. If the flag
 327             WRDE_NOCMD is set then no command substitution shall occur and
 328             the error WRDE_CMDSUB will be returned if such substitution is
 329             requested when processing the words.
 330
 331             The manual page as-is makes it seem like the command substitution
 332             occurs, and an error is returned *after* the substitution.
 333             This patch clarifies that.
 334
 335 locale.5
 336     Marko Myllynen
 337         Describe the formats of values
 338             locale(5) describes what a locale should define but doesn't
 339             spell out how (in what format). The patch attempts to address
 340             this, it also has few trivial additional enhancements.
 341
 342             * Reference to locale(7) for category descriptions.
 343             * Clarify first_workday in NOTES a bit.
 344             * Add upstream BZ reference for two missing LC_ADDRESS fields.
 345     Marko Myllynen
 346         Fix miscoded character
 347
 348 resolv.conf.5
 349     Jan Chaloupka
 350         Add missing no-tld-query option
 351             Based on commit [1], the no-tld-query option exists for
 352             resolv.conf configuration file.  Description of this option
 353             is provided in [2]. This patch just copies this option
 354             into resolv.conf.5 man page. Plus changes 'a' member
 355             into 'an' before 'unqualified name as if it ...'
 356             on the third line of [2]. Based on [3], this option
 357             was added in glibc 2.14 as solving [4] bug.
 358
 359             [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
 360             [2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
 361             [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
 362             [4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
 363
 364 credentials.7
 365     Josh Triplett
 366         Cross-reference getgroups(2)
 367             Since credentials.7 discusses supplementary GIDs, it should
 368             reference getgroups(2).
 369
 370 fanotify.7
 371     Heinrich Schuchardt
 372         Allow relative paths in example
 373             The current example code requires passing an absolute
 374             path to the mount to be watched.
 375
 376             By passing AT_FDCWD to fanotify_mark it can use both
 377             absolute and relative paths.
 378     Heinrich Schuchardt
 379         fallocate(2) creates no events
 380             fallocate(2) should create FAN_MODIFY events but does not.
 381     Heinrich Schuchardt [Michael Kerrisk]
 382         fanotify notifies only events generated on the same mount
 383             Unfortunately, fanotify does not inform listeners for all paths
 384             under which a touched filesystem object is visible, but only the
 385             listener using the same path as the process touching the
 386             filesystem object.
 387     Heinrich Schuchardt
 388         Update BUGS to note bugs still not fixed in 3.17
 389             I bumped the Linux version number in the BUGS section to 3.17.
 390
 391 inotify.7
 392     Heinrich Schuchardt
 393         fallocate(2) does not trigger inotify events
 394             Calling fallocate(2) does not result in inotify events.
 395
 396 locale.7
 397     Marko Myllynen
 398         Improve LOCPATH description
 399             LOCPATH is ignored by privileged programs.
 400
 401             Add locale archive references.
 402
 403             Add FILES section.
 404
 405 man-pages.7
 406     Michael Kerrisk  [Laurent Georget]
 407         Clarify that SEE ALSO entries may refer to pages from other projects
 408
 409 signal.7
 410     Michael Kerrisk
 411         Mention other "slow devices"
 412             Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
 413             and fanotify(7) file descriptors are also slow operations
 414             that are restartable.
 415     Michael Kerrisk
 416         Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
 417     Michael Kerrisk
 418         Since Linux 3.8, reads on inotify(7) file descriptors are restartable
 419     Michael Kerrisk
 420         inotify(7) reads no longer show the odd EINTR error after SIGCONT
 421             Since kernel 3.7, reads from inotify(7) file descriptors no longer
 422             show the (Linux oddity) behavior of failing with EINTR when the
 423             process resumes after a stop signal + SIGCONT.
 424     Michael Kerrisk
 425         SEE ALSO: add sigreturn(2)
 426
 427 unix.7
 428     Michael Kerrisk  [Scott Harvey]
 429         Fix buglet in code snippet in BUGS section
 430
 431 ld.so.8
 432     Carlos O'Donell
 433         Add --inhibit-cache option
 434             The dynamic loader has 6 options, only 5 are documented.
 435             This patch documents the sixth option i.e. `--inhibit-cache`.
 436     Jonathan Wakely  [Siddhesh Poyarekar]
 437         Correct documentation of $ORIGIN
 438             As noted by Siddhesh:
 439
 440                 The ld.so man page says:
 441
 442                     $ORIGIN (or equivalently ${ORIGIN})
 443                         This expands to the directory containing the
 444                         application executable.  Thus, an application located
 445                         in somedir/app could be compiled with
 446
 447                 This is incorrect since it expands to the directory containing
 448                 the DSO and not the application executable.  This seems like
 449                 deliberate behaviour in dl-object.c, so it needs to be fixed in
 450                 the man page.
 451
 452             See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
 453