original/Changes

   1 ==================== Changes in man-pages-3.51 ====================
   2
   3 Released: 2013-04-17, 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 Jaeger <aj@suse.de>
  14 Andrew Clayton <andrew@digital-domain.net>
  15 Brian M. Carlson <sandals@crustytoothpaste.net>
  16 Changhee Han <ch0.han@lge.com>
  17 Cyril Hrubis <chrubis@suse.cz>
  18 Damien Grassart <damien@grassart.com>
  19 David Prévot <taffit@debian.org>
  20 Denis Barbier <bouzim@gmail.com>
  21 Jeff Moyer <jmoyer@redhat.com>
  22 Krzysztof Konopko <krzysztof.konopko@gmail.com>
  23 Kyle McMartin <kyle@mcmartin.ca>
  24 Mark H Weaver <mhw@netris.org>
  25 Michael Kerrisk <mtk.manpages@gmail.com>
  26 Mike Frysinger <vapier@gentoo.org>
  27 Nicolas Hillegeer <nicolas@hillegeer.com>
  28 Pavel Emelyanov <xemul@parallels.com>
  29 Peter Schiffer <pschiffe@redhat.com>
  30 Radek Pazdera <rpazdera@redhat.com>
  31 Ralph Loader <suckfish@ihug.co.nz>
  32 Simon Paillard <spaillard@debian.org>
  33 The Wanderer <wanderer@fastmail.fm>
  34
  35 Apologies if I missed anyone!
  36
  37
  38 Newly documented interfaces in existing pages
  39 ---------------------------------------------
  40
  41 sched_rr_get_interval.2
  42     Michael Kerrisk
  43         Document /proc/sys/kernel/sched_rr_timeslice_ms
  44
  45 proc.5
  46     Pavel Emelyanov
  47         Document /proc/[pid]/map_files directory
  48             This directory was added in Linux v3.3 and provides info about
  49             files being mmap-ed in a way very similar to how /proc/[pid]/fd
  50             works.
  51
  52             v2: Added examples of how links look like and noted dependency
  53             on kernel config option CONFIG_CHECKPOINT_RESTORE.
  54     Michael Kerrisk
  55         Document /proc/sys/kernel/shm_rmid_forced
  56
  57 capabilities.7
  58     Michael Kerrisk
  59         Document /proc/sys/kernel/cap_last_cap
  60
  61
  62 Global changes
  63 --------------
  64
  65 Various pages
  66     Michael Kerrisk
  67         Global fix: fix placement of word "only"
  68
  69 Various pages
  70     Simon Paillard
  71         License headers: consistent format
  72
  73 Various pages
  74     Michael Kerrisk
  75         Global fix: s/since kernel/since Linux/
  76
  77 Various System V IPC pages in Section 2
  78     Michael Kerrisk
  79         Add "System V" to .TH line and text
  80             Make it clear that these pages relate to System V IPC,
  81             not POSIX IPC.
  82
  83
  84 Changes to individual pages
  85 ---------------------------
  86
  87 access.2
  88     Michael Kerrisk  [The Wanderer]
  89         Clarify RETURN VALUE for F_OK
  90             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
  91
  92 alarm.2
  93     Michael Kerrisk
  94         Correct the description of behavior when 'seconds' is 0
  95
  96 clone.2
  97     Michael Kerrisk  [Peter Schiffer]
  98         Add prototype for syscall to SYNOPSIS
  99             And further clarify the distinction between the system call
 100             and the wrapper function in the introductory text.
 101     Michael Kerrisk
 102         Update feature test macro requirements
 103             The requirements quietly changed changed in glibc 2.14
 104
 105             See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
 106     Michael Kerrisk  [Mike Frysinger]
 107         Clarify differences between clone2() syscall and wrapper function
 108     Michael Kerrisk  [Mike Frysinger]
 109         Note those architectures where the sys_clone argument order differs
 110     Michael Kerrisk  [Mike Frysinger]
 111         Add short subsection noting that blackfin, m68k, and sparc are different
 112     Michael Kerrisk
 113         Move clone2() text to subsection in description
 114             The description of ia64 clone2() should follow the discussion
 115             of the raw system call interface.
 116     Michael Kerrisk
 117         Change subhead for ia64 discussion
 118
 119 getcpu.2
 120     Michael Kerrisk
 121         Recommend that 'tcache' should be specified as NULL nowadays
 122
 123 io_cancel.2
 124     Jeff Moyer, Michael Kerrisk  [Cyril Hrubis]
 125         Improve description
 126
 127 io_destroy.2
 128     Jeff Moyer
 129         Improve description
 130             The description was rather vague, citing a "list of I/O contexts"
 131             and stating that it "can" cancel outstanding requests.  This
 132             update makes things more concrete so that the reader knows exactly
 133             what's going on.
 134
 135 io_getevents.2
 136     Jeff Moyer
 137         The 'timeout' argument is not updated
 138             I looked back through the kernel code, and the timeout was
 139             never updated in any case.  I've submitted a patch upstream
 140             to change the comment above io_getevents.
 141
 142 io_setup.2
 143     Jeff Moyer
 144         Clarify nr_events
 145             nr_events is technically the number of completion events that can
 146             be stored in the completion ring.  The wording of the man page:
 147             "capable of receiving at least nr_events" seems dubious to me,
 148             only because I worry that folks might interpret that to mean
 149             'nr_events' total, instead of 'nr_events' concurrently.
 150
 151             Further, I've added information on where to find the per-user
 152             limit on 'nr_events', /proc/sys/fs/aio-max-nr.  Let me know if
 153             you think that is not relevant.
 154
 155 listxattr.2
 156     Michael Kerrisk
 157         Explain use of 'size' argument
 158
 159 lseek.2
 160     Michael Kerrisk  [Andreas Jaeger]
 161         _GNU_SOURCE must be defined to get SEEK_DATE and SEEK_HOLE definitions
 162             See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
 163
 164 mmap.2
 165     Michael Kerrisk
 166         Add pointers to relevant /proc files described in proc(5)
 167
 168 posix_fadvise.2
 169 pread.2
 170 readahead.2
 171 sync_file_range.2
 172 truncate.2
 173     Michael Kerrisk
 174         Refer to syscall(2) for ABI semantics on certain 32-bit architectures
 175             Also: in sync_file_range.2 and posix_fadvise.2 remove description
 176             of conventional calling signature as flawed, and in
 177             posix_fadvise.2, de-emphasize focus on ARM, and rather phrase
 178             as a more general discussion of certain architectures.
 179
 180 readdir.2
 181     Michael Kerrisk
 182         readdir(2) doesn't exist on x86-64
 183
 184 semop.2
 185     Michael Kerrisk
 186         Clarify the discussion of 'semadj'
 187
 188 shmctl.2
 189     Michael Kerrisk
 190         Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
 191
 192 syscall.2
 193     Changhee Han
 194         Add notes that caution users when passing arguments to syscall()
 195             For example, passing 'long long' on ARM-32 requires special
 196             treatment.
 197     Mike Frysinger [Michael Kerrisk]
 198         Document the exact calling convention for architecture system calls
 199     Mike Frysinger  [Kyle McMartin]
 200         Add PA-RISC details under calling conventions
 201     Michael Kerrisk  [Mike Frysinger]
 202         Refine discussion of ARM and other ABIs
 203
 204 syscalls.2
 205     Michael Kerrisk
 206         Update kernel version number at start of list
 207
 208 umask.2
 209     Michael Kerrisk
 210         SEE ALSO: add acl(5)
 211
 212 unshare.2
 213     Michael Kerrisk
 214         Update feature test macro requirements
 215             The requirements quietly changed changed in glibc 2.14
 216
 217             See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
 218
 219 fopencookie.3
 220     Michael Kerrisk  [Ralph Loader]
 221         Correct definition of cookie_io_functions_t
 222
 223 pthread_setname_np.3
 224     Andrew Clayton
 225         The thread argument is passed in by value
 226
 227 readir.3
 228 seekdir.3
 229 telldir.3
 230     Michael Kerrisk
 231         Eliminate the implication that these functions deal with "offsets"
 232             The directory position dealt with by the readdir() and
 233             friends is not a simple file offset in modern file systems.
 234             Typically, it is some kind of cookie value. Add text and
 235             make other changes to these pages to eliminate the
 236             implication that this is an offset, and warn the reader
 237             that directory positions should be treated strictly as
 238             opaque values.
 239
 240             In the process, rename the 'offset' argument of seekdir(3)
 241             to 'loc', and add some text to readdir(3) to note that
 242             the 'd_off' field is the same value returned by telldir(3)
 243             at the current directory position.
 244
 245             See also https://lwn.net/Articles/544298/
 246
 247 scalb.3
 248     Mark H Weaver
 249         Fix prototypes for scalbf() and scalbl()
 250
 251 sched_getcpu.3
 252     Michael Kerrisk
 253         Update feature test macro requirements
 254             The requirements quietly changed changed in glibc 2.14
 255
 256             See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
 257
 258 ualarm.3
 259     Michael Kerrisk  [Nicolas Hillegeer]
 260         Add note on the behavior when 'usecs' is zero
 261             POSIX.1-2001 does not specify the behavior in this case
 262             and no other system that I checked documented the behavior.
 263             Probably, most or all systems do what Linux does in this
 264             case: cancel any pending alarm, just as alarm(0) does.
 265             Add that info in NOTES.
 266
 267 elf.5
 268     Mike Frysinger
 269         Add byte positions for all EI_xxx fields
 270             When describing e_ident, most of the EI_xxx defines mention the
 271             exact byte number.  This is useful when manually hacking an ELF
 272             with a hex editor.  However, the last few fields don't do this,
 273             which means you have to count things up yourself.
 274             Add a single word to each so you don't have to do that.
 275
 276 proc.5
 277     Michael Kerrisk
 278         Refer to sched_rr_get_interval(2) for info on sched_rr_timeslice_ms
 279             Since Linux 3.9, /proc/sys/kernel/sched_rr_timeslice_ms can
 280             be used to change the SCHED_RR quantum.
 281     Michael Kerrisk
 282         SEE ALSO: Add sysctl(8)
 283     Krzysztof Konopko
 284         Simplify the example of printing out environ
 285             The binutils package contains a very handy utility to
 286             print out null-byte delimited strings from a file.  This
 287             can replace a rather complex expression with cat(1)
 288             provided as an example for printing out /proc/[pid]/environ.
 289     Michael Kerrisk
 290         Update /proc/PID/maps example
 291             Update to 64-bit example that includes "[heap]", "[stack],
 292             and "[vdso]"
 293     Michael Kerrisk
 294         Formatting fixes for /proc/PID/maps
 295     Mike Frysinger
 296         Document the "pathname" field of /proc/PID/maps
 297     Michael Kerrisk
 298         Add reference to capabilities(7) for /proc/sys/kernel/cap_last_cap
 299     Michael Kerrisk
 300         /proc/PID/maps: add a reference to mmap(2)
 301
 302 ip.7
 303     Radek Pazdera
 304         Document IP_MULTICAST_ALL
 305             This commit adds documentation for the IP_MULTICAST_ALL socket
 306             option.
 307
 308             The option was added to the Linux kernel in 2.6.31:
 309
 310                 Author Nivedita Singhvi <niv@us.ibm.com>
 311                 Commit f771bef98004d9d141b085d987a77d06669d4f4f
 312
 313             The description is based on a previous one [3] posted by the
 314             original author of the code -- Nivedita, but it is slightly
 315             re-worded.
 316
 317             I tested it myself and it works as described.
 318
 319             References:
 320                 [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
 321                 [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
 322                 [3] http://patchwork.ozlabs.org/patch/28902/
 323
 324 units.7
 325     Brian M. Carlson
 326         units should use an actual µ
 327             The units(7) man page uses an ASCII u in place of the actual Greek
 328             letter mu.  Since we're in the twenty-first century, with
 329             UTF-8-compatible terminals and terminal emulators, we should use
 330             the actual letter µ instead of an ASCII approximation.
 331
 332             See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787