original/Changes

   1 ==================== Changes in man-pages-3.64 ====================
   2
   3 Released: 2014-04-06, 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 Abhay Sachan <sachan.abhay@gmail.com>
  14 Alexey Samsonov <samsonov@google.com>
  15 Andrey Vagin <avagin@openvz.org>
  16 Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
  17 Christoph Hellwig <hch@infradead.org>
  18 David Prévot <taffit@debian.org>
  19 Eric Dumazet <edumazet@google.com>
  20 Eric W. Biederman <ebiederm@xmission.com>
  21 Jan Kara <jack@suse.cz>
  22 Kir Kolyshkin <kir@openvz.org>
  23 Michael Kerrisk <mtk.manpages@gmail.com>
  24 Mike Frysinger <vapier@gentoo.org>
  25 NeilBrown <neilb@suse.de>
  26 Peng Haitao <penght@cn.fujitsu.com>
  27 Peter Hurley <peter@hurleysoftware.com>
  28 Petr Gajdos <pgajdos@suse.cz>
  29 Robert P. J. Day <rpjday@crashcourse.ca>
  30 Vince Weaver <vincent.weaver@maine.edu>
  31 Yuri Kozlov <yuray@komyakino.ru>
  32
  33 Apologies if I missed anyone!
  34
  35
  36 New and rewritten pages
  37 -----------------------
  38
  39 open_by_handle_at.2
  40     Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
  41     Christoph Hellwig]
  42         New page describing name_to_handle_at(2) and open_by_handle_at(2)
  43
  44 inotify.7
  45     Michael Kerrisk
  46         Rewrite introductory section
  47         Reorganize "Limitations and caveats" subsection
  48     Michael Kerrisk
  49         Further describe the race when adding a watch to a new subtree
  50     Michael Kerrisk
  51         Directory renames may invalidate multiple paths cached by application
  52     Michael Kerrisk
  53         Add paragraph on cache consistency checking
  54     Michael Kerrisk
  55         Mention cache rebuilding to handle overflow events
  56     Michael Kerrisk
  57         Moving an object to another filesystem generates IN_DELETE_SELF
  58     Michael Kerrisk [Jan Kara]
  59         Add text on dealing with rename() events
  60     Michael Kerrisk
  61         Note rationale and consequences of event coalescing
  62     Michael Kerrisk  [Eric W. Biederman]
  63         Inotify doesn't work for remote and pseudo filesystems
  64     Michael Kerrisk
  65         Add some examples of events generated by various system calls
  66     Michael Kerrisk
  67         BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
  68             A silent change as a result of the fanotify work in kernel 2.6.36.
  69     Michael Kerrisk
  70         Note that IN_DELETE_SELF will be followed by IN_IGNORED
  71     Michael Kerrisk
  72         Note that IN_UNMOUNT will be followed by an IN_IGNORED event
  73     Michael Kerrisk
  74         Inotify does not report events for mmap(2) and msync(2)
  75     Michael Kerrisk
  76         Add examples of syscalls that trigger IN_ATTRIB
  77     Michael Kerrisk
  78         Add some examples of syscalls that trigger IN_MODIFY
  79     Michael Kerrisk
  80         execve(2) also generates IN_ACCESS
  81     Michael Kerrisk
  82         Add examples of syscalls that trigger IN_CREATE
  83
  84
  85 Newly documented interfaces in existing pages
  86 ---------------------------------------------
  87
  88 perf_event_open.2
  89     Vince Weaver [Michael Kerrisk]
  90         Document the PERF_FLAG_FD_CLOEXEC flag
  91             The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
  92             flag.
  93
  94 feature_test_macros.7
  95     Michael Kerrisk
  96         Document _LARGEFILE_SOURCE
  97
  98
  99 New and changed links
 100 ---------------------
 101
 102 name_to_handle_at.2
 103     Michael Kerrisk
 104         New link to new open_by_name_at(2) page
 105
 106
 107 Global changes
 108 --------------
 109
 110 fmemopen.3
 111 getaddrinfo.3
 112 mq_notify.3
 113 offsetof.3
 114 aio.7
 115     Michael Kerrisk
 116         Print size_t/ssize_t values using %z printf() modifier
 117             There are fewer and fewer systems these days that don't
 118             support the %z specifier mandated in C99.  So replace the
 119             use of %ld/%lu + (long) cast with %zd/%zu.
 120
 121
 122 Changes to individual pages
 123 ---------------------------
 124
 125 bdflush.2
 126 fsync.2
 127 sync.2
 128     Kir Kolyshkin
 129         SEE ALSO: remove update(8) reference
 130             Remove reference to update(8) man page, since there is no such
 131             page. This is an ancient BSD leftover I believe.
 132
 133 chown.2
 134     Michael Kerrisk
 135         Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
 136
 137 getxattr.2
 138     Abhay Sachan
 139         Fix REURN VALUE description
 140             A EA can have length zero.
 141
 142 inotify_add_watch.2
 143     Michael Kerrisk
 144         ERRORS: add ENAMETOOLONG
 145
 146 inotify_init.2
 147     Michael Kerrisk
 148         Add pointer to inotify(7)
 149
 150 link.2
 151     Michael Kerrisk
 152         When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
 153         directory
 154
 155 mmap.2
 156     Andrey Vagin
 157         The file descriptor for a file mapping must be readable
 158             There is no difference between MAP_SHARED and MAP_PRIVATE.
 159
 160 open.2
 161     Michael Kerrisk
 162         SEE ALSO: add open_by_name_at(2)
 163
 164             Various clean-ups and bug fixes after review by Mike Frysinger.
 165
 166 perf_event_open.2
 167     Vince Weaver
 168         Document PERF_EVENT_IOC_PERIOD behavior change
 169             Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
 170             changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
 171             on all architectures to update immediately, to match the behavior
 172             found on ARM.
 173
 174 stat.2
 175     Michael Kerrisk
 176         Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
 177
 178 syscalls.2
 179     Michael Kerrisk
 180         Add sched_getattr() and sched_setattr()
 181             And update kernel version to 3.14
 182
 183 abort.3
 184     Peng Haitao
 185         ATTRIBUTES: Note function that is thread-safe
 186             The function abort() is thread safe.
 187
 188 confstr.3
 189     Michael Kerrisk
 190         SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
 191
 192 exit.3
 193     Peng Haitao
 194         ATTRIBUTES: Note function that is not thread-safe
 195             The function exit() is not thread safe.
 196
 197 fenv.3
 198     Peng Haitao
 199         ATTRIBUTES: Note functions that are thread-safe
 200             The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
 201             fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
 202             fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
 203             feenableexcept(), fedisableexcept() and fegetexcept() are thread
 204             safe.
 205
 206 fpathconf.3
 207     Michael Kerrisk
 208         SEE ALSO: add confstr(3)
 209
 210 fseek.3
 211     Michael Kerrisk  [Petr Gajdos]
 212         Document EINVAL error for negative file offset
 213
 214 fseeko.3
 215     Michael Kerrisk
 216         Add feature test macro requirements
 217
 218 fts.3
 219     Michael Kerrisk  [Mike Frysinger]
 220         Remove mention of "32-bit systems" in BUGS
 221
 222 fwide.3
 223 wprintf.3
 224     Michael Kerrisk  [Robert P. J. Day]
 225         Remove mention of bogus _ISOC95_SOURCE feature test macro
 226
 227 getline.3
 228     Alexey Samsonov
 229         Caller should free the allocated buffer even if getline() failed
 230             Relevant discussion in glibc bugzilla:
 231             https://sourceware.org/bugzilla/show_bug.cgi?id=5666
 232
 233 getloadavg.3
 234     Peng Haitao
 235         ATTRIBUTES: Note function that is thread-safe
 236             The function getloadavg() is thread safe.
 237
 238 getpt.3
 239     Peng Haitao
 240         ATTRIBUTES: Note function that is thread-safe
 241             The function getpt() is thread safe.
 242
 243 if_nametoindex.3
 244     Peng Haitao
 245         ATTRIBUTES: Note functions that are thread-safe
 246             The functions if_nametoindex() and if_indextoname() are thread safe.
 247
 248 index.3
 249     Peng Haitao
 250         ATTRIBUTES: Note functions that are thread-safe
 251             The functions index() and rindex() are thread safe.
 252
 253 mkfifo.3
 254     Peng Haitao
 255         ATTRIBUTES: Note functions that are thread-safe
 256             The functions mkfifo() and mkfifoat() are thread safe.
 257
 258 netlink.3
 259     Michael Kerrisk
 260         SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
 261
 262 random.3
 263     Peng Haitao
 264         ATTRIBUTES: Note functions that are thread-safe
 265             The functions random(), srandom(), initstate() and setstate()
 266             are thread safe.
 267
 268 random_r.3
 269     Peng Haitao
 270         ATTRIBUTES: Note functions that are thread-safe
 271             The functions random_r(), srandom_r(), initstate_r() and
 272             setstate_r() are thread safe.
 273
 274 sigvec.3
 275     Peng Haitao
 276         ATTRIBUTES: Note functions that are thread-safe
 277             The functions sigvec(), sigblock(), sigsetmask() and
 278             siggetmask() are thread safe.
 279
 280             The macro sigmask() is thread safe.
 281
 282 sysconf.3
 283     Michael Kerrisk
 284         SEE ALSO: add confstr(3)
 285
 286 termios.3
 287     Michael Kerrisk  [Peter Hurley]
 288         Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
 289             As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
 290
 291                 read() may unblock when MIN bytes are available but return
 292                 up to the 'count' parameter if more input arrives in between
 293                 waking and copying into the user buffer.
 294                 ...
 295                 read() may also _not_ return until MIN bytes have been
 296                 received, even if 'count' bytes have been received.
 297     Michael Kerrisk
 298         Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
 299             POSIX leaves the behavior open.
 300     Michael Kerrisk
 301         Clarify termination conditions for MIN > 0, TIME > 0
 302     Michael Kerrisk
 303         Clarify behavior if data is available before noncanonical read()
 304     Michael Kerrisk
 305         Add descriptive titles to noncanonical read() cases
 306
 307 symlink.7
 308     Michael Kerrisk
 309         Add subsection on opening a symbolic link with O_PATH
 310     Michael Kerrisk
 311         name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
 312     Michael Kerrisk
 313         Mention use of readlink(2) to read contents of a symlink
 314
 315 tcp.7
 316     Michael Kerrisk  [Eric Dumazet]
 317         Document /proc/sys/net/ipv4/tcp_autocorking
 318             Text heavily based on Documentation/networking/ip-sysctl.txt