Changes

   1 ==================== Changes in man-pages-3.83 ====================
   2
   3 Released: 2015-04-19, 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 Andreas Baak <andreas.baak@gmail.com>
  14 Andreas Dilger <adilger@dilger.ca>
  15 cdlscpmv <cdlscpmv@gmail.com>
  16 Cyrill Gorcunov <gorcunov@openvz.org>
  17 Darrick J. Wong <darrick.wong@oracle.com>
  18 David Rientjes <rientjes@google.com>
  19 Dima Tisnek <dimaqq@gmail.com>
  20 Eric Sandeen <sandeen@redhat.com>
  21 Fabien Pichot <fpichot@bouledef.eu>
  22 Felix Sedlmeier <sedlmeier@gmx.de>
  23 Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
  24 Heinrich Schuchardt <xypron.glpk@gmx.de>
  25 Jann Horn <jann@thejh.net>
  26 Jon Grant <jg@jguk.org>
  27 Jonny Grant <jg@jguk.org>
  28 Kees Cook <keescook@chromium.org>
  29 Masanari Iida <standby24x7@gmail.com>
  30 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
  31 Michael Kerrisk <mtk.manpages@gmail.com>
  32 Nikos Mavrogiannopoulos <nmav@gnutls.org>
  33 Omar Sandoval <osandov@osandov.com>
  34 Pierre Chifflier <pollux@debian.org>
  35 Robin H. Johnson <robbat2@gentoo.org>
  36 Rob Landley <rob@landley.net>
  37 Theodore Ts'o <tytso@mit.edu>
  38 Vlastimil Babka <vbabka@suse.cz>
  39 Walter Harms <wharms@bfs.de>
  40 William Woodruff <william@tuffbizz.com>
  41 YOSHIFUJI Hideaki <hideaki.yoshifuji@miraclelinux.com>
  42 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
  43
  44 Apologies if I missed anyone!
  45
  46
  47 New and rewritten pages
  48 -----------------------
  49
  50 posix_madvise.3
  51     Michael Kerrisk
  52         New page documenting posix_madvise(3)
  53
  54 ftw.3
  55     Michael Kerrisk
  56         Reorganize the page to give primacy to nftw()
  57             nftw() is the better API, and POSIX.1-2008 marks ftw() obsolete.
  58
  59 Newly documented interfaces in existing pages
  60 ---------------------------------------------
  61
  62 getdents.2
  63     Michael Kerrisk
  64         Document getdents64()
  65
  66 mount.2
  67     Michael Kerrisk, Theodore Ts'o  [Eric Sandeen, Andreas Dilger,
  68     Omar Sandoval, Darrick J. Wong]
  69         Document MS_LAZYTIME
  70             Based on Ted T'so's commit message 0ae45f63d4e
  71
  72 proc.5
  73     Michael Kerrisk
  74         Document /proc/sys/kernel/randomize_va_space
  75     Michael Kerrisk
  76         Document /proc/PID/fdinfo epoll format
  77     Michael Kerrisk
  78         Describe /proc/PID/fdinfo eventfd format
  79     Michael Kerrisk
  80         Document /proc/PID/fdinfo signalfd format
  81
  82
  83 New and changed links
  84 ---------------------
  85
  86 newfstatat.2
  87     Michael Kerrisk
  88         New link to fstatat64.2
  89
  90 prlimit64.2
  91     Michael Kerrisk
  92         New link to getrlimit.2
  93
  94
  95 Global changes
  96 --------------
  97
  98 Various secion 3 math pages
  99     Michael Kerrisk
 100         Note that these functions are also in POSIX.1-2001 and POSIX.1-2008
 101
 102
 103 Changes to individual pages
 104 ---------------------------
 105
 106 getent.1
 107     Robin H. Johnson
 108         Document options
 109             The options to getent are now documented, after being around for
 110             nearly a decade without changes.
 111     Michael Kerrisk
 112         Document help and version options
 113
 114 fallocate.2
 115     Michael Kerrisk
 116         Fix kernel version number for FALLOC_FL_ZERO_RANGE
 117             FALLOC_FL_ZERO_RANGE as added in 3.15, not 3.14.
 118     Michael Kerrisk
 119         Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17
 120
 121 getdents.2
 122     Michael Kerrisk  [Dima Tisnek]
 123         Update timestamp
 124             Really just a marker to record the reporters of bugs
 125             that stemmed from the fact that the page did not
 126             document getdents64(). I'll fix things up in the changelog.
 127
 128             See https://bugzilla.kernel.org/show_bug.cgi?id=14795
 129
 130 getrlimit.2
 131     Michael Kerrisk
 132         Note that the underlying system call for prlimit() is prlimit64()
 133     Michael Kerrisk
 134         Remove "_FILE_OFFSET_BITS == 64" from prlimit() FTM requirements
 135             "_FILE_OFFSET_BITS == 64" is not needed to get the prlimit()
 136             declaration.
 137
 138 ioctl_list.2
 139     Nikos Mavrogiannopoulos
 140         SIOCADDRT accepts in6_rtmsg in INET6 protocol
 141     Heinrich Schuchardt
 142         TFD_IOC_SET_TICKS
 143             timerfd_create.2 mentions TFD_IOC_SET_TICKS. We should add it to
 144             ioctl_list.2, too.
 145
 146 llseek.2
 147     Michael Kerrisk
 148         Advise reader to use lseek(2) instead
 149     Michael Kerrisk
 150         llseek() exists on 32-bit platforms to support seeking to large offsets
 151
 152 madvise.2
 153     David Rientjes
 154         Specify MADV_REMOVE returns EINVAL for hugetlbfs
 155             madvise(2) actually returns with error EINVAL for MADV_REMOVE
 156             when used for hugetlb VMAs, not EOPNOTSUPP, and this has been
 157             the case since MADV_REMOVE was introduced in commit f6b3ec238d12
 158             ("madvise(MADV_REMOVE): remove pages from tmpfs shm backing
 159             store"). Specify the exact behavior.
 160     Michael Kerrisk
 161         SEE ALSO: add posix_madvise(2)
 162
 163 poll.2
 164     Michael Kerrisk  [Andreas Baak]
 165         SEE ALSO: add epoll(7)
 166
 167 posix_fadvise.2
 168     Michael Kerrisk
 169         Add "C library/kernel ABI differences" subsection
 170
 171 pread.2
 172     Michael Kerrisk
 173         Add "C library/kernel ABI differences" subsection
 174
 175 seccomp.2
 176     Michael Kerrisk  [Pierre Chifflier, Kees Cook]
 177         Note that seccomp_data is read-only
 178
 179 stat.2
 180     Michael Kerrisk
 181         Add some details on various "stat" versions
 182             Three versions of "stat" appeared on 32-bit systems,
 183             dealing with structures of different (increasing) sizes.
 184             Explain some of the details, and also note that the
 185             situation is simpler on modern 64-bit architectures.
 186     Michael Kerrisk
 187         Add a little more detail on history of three versions of *stat()
 188     Michael Kerrisk
 189         Add mention of newfstatat()
 190             The underlying system call for fstatat() is newfstatat()
 191             on some architectures.
 192
 193 symlink.2
 194     Michael Kerrisk  [Jonny Grant]
 195         ERRORS: add linkpath=="" case for ENOENT
 196
 197 syscalls.2
 198     Michael Kerrisk
 199         Remove prlimit()
 200             There really is only the prlimit64() system call.
 201             See also commit 7b08c45b7df.
 202     Michael Kerrisk
 203         Add some details about the "multiple versions of system calls"
 204             The multiple-system-call-version phenomenon is particular a
 205             feature of older 32-bit platforms. Hint at that fact in the text.
 206
 207 timerfd_create.2
 208     Cyrill Gorcunov  [Michael Kerrisk]
 209         Document TFD_IOC_SET_TICKS ioctl() operation
 210     Michael Kerrisk
 211         Add some details to C library/kernel ABI differences
 212
 213 unshare.2
 214     Michael Kerrisk  [Fabien Pichot]
 215         Remove mention of "System V" from discussion of CLONE_NEWIPC
 216             These days, CLONE_NEWIPC also affects POSIX message queues.
 217
 218 asprintf.3
 219     Zeng Linggang
 220         ATTRIBUTES: Note functions that are thread-safe
 221
 222 carg.3
 223     Michael Kerrisk
 224         Add introductory sentence explaining what these functions calculate
 225
 226 ccos.3
 227     Ma Shimiao
 228         ATTRIBUTES: Note functions that are thread-safe
 229     Michael Kerrisk
 230         Add introductory sentence explaining what these functions calculate
 231
 232 ccosh.3
 233     Michael Kerrisk
 234         Add introductory sentence explaining what these functions calculate
 235
 236 cexp.3
 237     Ma Shimiao
 238         ATTRIBUTES: Note functions that are thread-safe
 239
 240 clock.3
 241     Ma Shimiao
 242         ATTRIBUTES: Note functions that is thread-safe
 243
 244 clog.3
 245     Michael Kerrisk
 246         Add introductory sentence explaining what these functions calculate
 247
 248 csin.3
 249     Ma Shimiao
 250         ATTRIBUTES: Note functions that are thread-safe
 251     Michael Kerrisk
 252         Add introductory sentence explaining what these functions calculate
 253
 254 csinh.3
 255     Ma Shimiao
 256         ATTRIBUTES: Note functions that are thread-safe
 257     Michael Kerrisk
 258         Add introductory sentence explaining what these functions calculate
 259
 260 csqrt.3
 261     Ma Shimiao
 262         ATTRIBUTES: Note functions that are thread-safe
 263     Michael Kerrisk
 264         Simplify description of what  these functions calculate
 265
 266 ctan.3
 267     Ma Shimiao
 268         ATTRIBUTES: Note functions that are thread-safe
 269     Michael Kerrisk
 270         Add introductory sentence explaining what these functions calculate
 271
 272 ctanh.3
 273     Ma Shimiao
 274         ATTRIBUTES: Note functions that are thread-safe
 275     Michael Kerrisk
 276         Add introductory sentence explaining what these functions calculate
 277
 278 ctime.3
 279     Zeng Linggang
 280         ATTRIBUTES: Note functions that aren't thread-safe
 281
 282 exec.3
 283     Michael Kerrisk
 284         SYNOPSIS: Clarify calling signature for execl() and execlp()
 285     Michael Kerrisk  [Andreas Baak]
 286         Correct prototype for execle()
 287             Make the prototype shown into correct C.
 288
 289 ftw.3
 290     Michael Kerrisk  [Felix Sedlmeier]
 291         ftw() and nftw() differ for the non-stat-able symlink case
 292             The POSIX specification of ftw() says that an un-stat-able
 293             symlink may yield either FTW_NS or FTW_SL. The specification
 294             of nftw() does not carry this statement.
 295     Michael Kerrisk
 296         CONFORMING TO: add POSIX.1-2008
 297     Michael Kerrisk
 298         Update POSIX version references in NOTES
 299
 300 getcwd.3
 301     Jann Horn  [Michael Kerrisk]
 302         Note behavior for unreachable current working directory
 303     Michael Kerrisk
 304         Add ENOMEM error
 305
 306 gethostbyname.3
 307     Michael Kerrisk  [Jonny Grant]
 308         Clarify that NO_ADDRESS and NO_DATA are synonyms
 309     Michael Kerrisk
 310         Add some detail for NO_DATA
 311             Text consistent with POSIX and FreeBSD's gethostbyname() man page.
 312     Zeng Linggang
 313         ATTRIBUTES: Note functions that aren't thread-safe
 314
 315 getnetent.3
 316     Zeng Linggang
 317         ATTRIBUTES: Note functions that aren't thread-safe
 318
 319 get_nprocs_conf.3
 320     Zeng Linggang
 321         ATTRIBUTES: Note functions that are thread-safe
 322
 323 getutent.3
 324     Zeng Linggang
 325         ATTRIBUTES: Note functions that aren't thread-safe
 326
 327 glob.3
 328     Zeng Linggang
 329         ATTRIBUTES: Note functions that aren't thread-safe
 330
 331 insque.3
 332     Ma Shimiao
 333         ATTRIBUTES: Note functions that are thread-safe
 334
 335 login.3
 336     Zeng Linggang
 337         ATTRIBUTES: Note functions that aren't thread-safe
 338
 339 lseek64.3
 340     Michael Kerrisk
 341         Clarify details with respect to 32-bit and 64-bit systems
 342
 343 malloc.3
 344     Michael Kerrisk
 345         Add ENOMEM error
 346
 347 mbsnrtowcs.3
 348     Zeng Linggang
 349         ATTRIBUTES: Note function that isn't thread-safe
 350
 351 mbsrtowcs.3
 352     Zeng Linggang
 353         ATTRIBUTES: Note function that isn't thread-safe
 354
 355 mq_notify.3
 356     Michael Kerrisk
 357         Add "C library/kernel ABI differences" subsection
 358
 359 mq_open.3
 360     Michael Kerrisk  [Fabien Pichot]
 361         NOTES: explain differences from the underlying system call
 362             The check for the slash at the start of a pathname is done in glibc
 363
 364 openpty.3
 365     Zeng Linggang
 366         ATTRIBUTES: Note functions that aren't thread-safe
 367
 368 perror.3
 369     Zeng Linggang
 370         ATTRIBUTES: Note function that is thread-safe
 371
 372 posix_memalign.3
 373     Zeng Linggang
 374         ATTRIBUTES: Note functions that aren't thread-safe
 375
 376 printf.3
 377     Zeng Linggang
 378         ATTRIBUTES: Note functions that are thread-safe
 379     Walter Harms  [Michael Kerrisk]
 380         Simplify the example code
 381
 382 qsort.3
 383     Michael Kerrisk  [Rob Landley]
 384         alphasort() and versionsort() are not suitable for 'compar'
 385             In glibc 2.10, the prototypes of alphasort() and versionsort()
 386             were changed so that the arguments switched from 'const void *' to
 387             'const struct dirent **', to match the POSIX.1-2008 specification
 388             of alphasort(). As such, compiler warnings will result if
 389             these functions are used as the arguments of qsort().
 390
 391                 warning: passing argument 4 of 'qsort' from incompatible
 392                 pointer type
 393                 expected '__compar_fn_t' but argument is of type
 394                 'int (*)(const struct dirent **, const struct dirent **)'
 395
 396             Therefore, remove the ancient NOTES text suggesting that
 397             alphasort() and versionsort() can be used as suitable
 398             'compar' arguments for qsort().
 399
 400 realpath.3
 401     Michael Kerrisk  [Jon Grant]
 402         Add ENOMEM error
 403
 404 scandir.3
 405     Michael Kerrisk
 406         glibc 2.10 changed the argument types for alphasort() and versionsort()
 407     Zeng Linggang
 408         ATTRIBUTES: Note functions that are thread-safe
 409
 410 scanf.3
 411     Zeng Linggang
 412         ATTRIBUTES: Note functions that are thread-safe
 413
 414 setnetgrent.3
 415     Zeng Linggang
 416         ATTRIBUTES: Note functions that aren't thread-safe
 417
 418 significand.3
 419     Ma Shimiao
 420         ATTRIBUTES: Note functions that are thread-safe
 421
 422 strcasecmp.3
 423     Michael Kerrisk  [Jonny Grant]
 424         Clarify that strcasecmp() does a byte-wise comparison
 425     Michael Kerrisk
 426         CONFORMING TO: add POSIX.1-2008
 427
 428 unlocked_stdio.3
 429     Zeng Linggang
 430         ATTRIBUTES: Note functions that aren't thread-safe
 431
 432 updwtmp.3
 433     Zeng Linggang
 434         ATTRIBUTES: Note functions that aren't thread-safe
 435
 436 wcrtomb.3
 437     Zeng Linggang
 438         ATTRIBUTES: Note function that isn't thread-safe
 439
 440 wcsnrtombs.3
 441     Zeng Linggang
 442         ATTRIBUTES: Note function that isn't thread-safe
 443
 444 wcsrtombs.3
 445     Zeng Linggang
 446         ATTRIBUTES: Note function that isn't thread-safe
 447
 448 wordexp.3
 449     Zeng Linggang
 450         ATTRIBUTES: Note functions that aren't thread-safe
 451
 452 wprintf.3
 453     Zeng Linggang
 454         ATTRIBUTES: Note functions that are thread-safe
 455
 456 proc.5
 457     Michael Kerrisk
 458         Describe "mnt_id" field of /proc/PID/fdinfo
 459     Michael Kerrisk
 460         Note that abstract sockets are included in /proc/net/unix
 461     Michael Kerrisk
 462         Update description /proc/sys/unix 'Type' field
 463             The existing text was very crufty. UNIX domain sockets
 464             support more than SOCK_STREAM for a _very_ long time now.
 465     Michael Kerrisk
 466         Add some detail to /proc/PID/timers
 467     Michael Kerrisk  [Vlastimil Babka]
 468         Enhance discussion of /proc/PID/status 'VmSwap' field
 469             Based on https://lwn.net/Articles/634978/
 470
 471 epoll.7
 472     Michael Kerrisk
 473         SEE ALSO: add poll(2) and select(2)
 474
 475 icmp.7
 476     YOSHIFUJI Hideaki/吉藤英明
 477         Document net.ipv4.ping_group_range knob
 478
 479 nptl.7
 480     Michael Kerrisk
 481         Add reference to timer_create(2)