Changes

   1 ==================== Changes in man-pages-5.02 ====================
   2
   3 Released: 2019-08-02, 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 Alan Stern <stern@rowland.harvard.edu>
  14 Alexey Izbyshev <izbyshev@ispras.ru>
  15 Amir Goldstein <amir73il@gmail.com>
  16 Cyrill Gorcunov <gorcunov@gmail.com>
  17 Eric Sanchis <eric.sanchis@iut-rodez.fr>
  18 Eugene Syromyatnikov <evgsyr@gmail.com>
  19 Finn O'Leary <finnoleary@inventati.org>
  20 Florian Weimer <fweimer@redhat.com>
  21 G. Branden Robinson <g.branden.robinson@gmail.com>
  22 Guillaume Laporte <guillaume.laporte.adm@gmail.com>
  23 Jakub Wilk <jwilk@jwilk.net>
  24 Jan Kara <jack@suse.cz>
  25 Kumar Chaudhary, Naveen <naveen.kumar.chaudhary@intel.com>
  26 Mark Wielaard <mark@klomp.org>
  27 Matthew Bobrowski <mbobrowski@mbobrowski.org>
  28 Matthew Kenigsberg <matthewkenigsberg@gmail.com>
  29 Matthias Hertel <Matthias.Hertel@rohde-schwarz.com>
  30 Michael Kerrisk <mtk.manpages@gmail.com>
  31 Michal Sekletar <msekleta@redhat.com>
  32 Oleg Nesterov <oleg@redhat.com>
  33 Palmer Dabbelt <palmer@sifive.com>
  34 Petr Vaněk <arkamar@atlas.cz>
  35 Sami Kerola <kerolasa@iki.fi>
  36 Shawn Landden <shawn@git.icu>
  37 Thorsten Glaser <tg@mirbsd.de>
  38 Tobias Klauser <tklauser@distanz.ch>
  39 Tomas Skäre <tomas.skare@gmail.com>
  40 Yang Xu <xuyang2018.jy@cn.fujitsu.com>
  41
  42 Apologies if I missed anyone!
  43
  44
  45 Newly documented interfaces in existing pages
  46 ---------------------------------------------
  47
  48 fanotify.7
  49 fanotify_init.2
  50 fanotify_mark.2
  51     Matthew Bobrowski  [Amir Goldstein, Jan Kara]
  52         Document FAN_REPORT_FID and directory modification events
  53
  54 vdso.7
  55     Tobias Klauser  [Palmer Dabbelt]
  56         Document vDSO for RISCV
  57
  58 Renamed pages
  59 -------------
  60
  61 sysvipc.7
  62     svipc(7) is renamed to sysvipc(7).
  63         The name sysvipc is a bit more natural, and is the name used in
  64         /proc/sysvipc.
  65
  66 New and changed links
  67 ---------------------
  68
  69 svipc.7
  70     Michael Kerrisk
  71         Add old name of sysvipc(7) page as a link
  72
  73
  74 Global changes
  75 --------------
  76
  77 Various pages
  78     Michael Kerrisk
  79         Change reference to svipc(7) to sysvipc(7)
  80
  81
  82 Changes to individual pages
  83 ---------------------------
  84
  85 pldd.1
  86     G. Branden Robinson  [Michael Kerrisk]
  87         Document glibc's unbreakage of tool
  88             After a longstanding breakage, pldd now works again (glibc 2.30).
  89
  90 bpf.2
  91     Michael Kerrisk
  92         Correct kernel version for JIT support on s390
  93
  94 chdir.2
  95     Michael Kerrisk
  96         Add ENOTDIR error for fchdir()
  97
  98 execve.2
  99     Michael Kerrisk  [Eugene Syromyatnikov]
 100         Since Linux 5.1, the limit on the #! line is 255 chars (rather than 127)
 101     Shawn Landden  [Michael Kerrisk]
 102         Add more detail about Shebangs
 103     Michael Kerrisk
 104         Linux is not alone in ignoring the set-UID and set-GID bits for scripts
 105
 106 mount.2
 107     Michael Kerrisk
 108         ERRORS: Add a couple of EINVAL errors for MS_MOVE
 109     Michael Kerrisk
 110         SEE ALSO: add chroot(2) and pivot_root(2)
 111
 112 mprotect.2
 113     Mark Wielaard
 114         pkey_mprotect() acts like mprotect() if pkey is set to -1, not 0
 115
 116 mprotect.2
 117 pkey_alloc.2
 118     Mark Wielaard  [Florian Weimer]
 119         _GNU_SOURCE is required for the pkey functions.
 120
 121 pivot_root.2
 122     Michael Kerrisk
 123         ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation
 124     Michael Kerrisk
 125         'new_root' must be a mount point
 126             It appears that 'new_root' may not have needed to be a mount
 127             point on ancient kernels, but already in Linux 2.4.5 this changed.
 128     Michael Kerrisk
 129         'put_old' can't be a mount point with MS_SHARED propagation
 130     Michael Kerrisk
 131         SEE ALSO: add mount(2)
 132
 133 poll.2
 134     Michael Kerrisk  [Alan Stern]
 135         Note that poll() equivalent code for ppoll() is not quite equivalent
 136
 137 prctl.2
 138     Yang Xu  [Cyrill Gorcunov]
 139         Correct some details for PR_SET_TIMERSLACK
 140
 141 setxattr.2
 142     Finn O'Leary  [Michael Kerrisk]
 143         Add ERANGE to 'ERRORS' section
 144
 145 tkill.2
 146     Michael Kerrisk
 147         glibc 2.30 provides a wrapper for tgkill()
 148
 149 dlopen.3
 150     Michael Kerrisk
 151         Clarify the rules for symbol resolution in a dlopen'ed object
 152             The existing text wrongly implied that symbol look up first
 153             occurred in the object and then in main, and did not mention
 154             whether dependencies of main where used for symbol resolution.
 155     Michael Kerrisk
 156         Clarify when an executable's symbols can be used for symbol resolution
 157             The --export-dynamic linker option is not the only way that main's
 158             global symbols may end up in the dynamic symbol table and thus be
 159             used to satisfy symbol reference in a shared object. A symbol
 160             may also be placed into the dynamic symbol table if ld(1)
 161             notices a dependency in another object during the static link.
 162     Michael Kerrisk
 163         An object opened with RTLD_LOCAL can be promoted to RTLD_GLOBAL
 164     Michael Kerrisk
 165         Note that symbol use might keep a dlclose'd object in memory
 166             My earlier commit was in error:
 167     Michael Kerrisk
 168         On dlclose(), destructors are called when reference count falls to 0
 169     Michael Kerrisk
 170         Make it clear that RTLD_NODELETE also affects global variables
 171     Michael Kerrisk
 172         Clarify that constructors are called only when library is first loaded
 173
 174 exec.3
 175     Matthew Kenigsberg
 176         Explain function groupings
 177             I've found the exec man page quite difficult to read when trying
 178             to find the behavior for a specific function. Since the names of
 179             the functions are inline and the order of the descriptions isn't
 180             clear, it's hard to find which paragraphs apply to each function.
 181             I thought it would be much easier to read if the grouping based on
 182             letters is stated.
 183
 184 getutent.3
 185     Michael Kerrisk  [Thorsten Glaser]
 186         Fix missing include file in EXAMPLE
 187             See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=932382
 188
 189 on_exit.3
 190     Michael Kerrisk  [Sami Kerola]
 191         Stack variables may be out of scope when exit handler is invoked
 192
 193 strcat.3
 194     Michael Kerrisk  [Eric Sanchis]
 195         Fix off-by-one error in example code
 196
 197 cpuid.4
 198     Michael Kerrisk
 199         SEE ALSO: add cpuid(1)
 200
 201 elf.5
 202     Michael Kerrisk
 203         SEE ALSO: add ld.so(8)
 204
 205 proc.5
 206     Michael Kerrisk
 207         Correct description of /proc/PID/status 'ShdPnd' and 'SigPnd' fields
 208             These fields are signal masks, not counters.
 209     Michael Kerrisk
 210         Clarify that various mask fields in /proc/PID/status are in hexadecimal
 211
 212 capabilities.7
 213     Michael Kerrisk
 214         Add a note about using strace on binaries that have capabilities
 215     Michael Kerrisk
 216         Add pivot_root(2) to CAP_SYS_ADMIN list
 217     Michael Kerrisk
 218         CAP_FOWNER also allows modifying user xattrs on sticky directories
 219
 220 cgroup_namespaces.7
 221     Michael Kerrisk
 222         Some wording fixes to improve clarity
 223     Michael Kerrisk
 224         In the example shell session, give second shell a different prompt
 225
 226 credentials.7
 227     Michael Kerrisk
 228         Note that /proc/PID/status shows a process's credentials
 229     Michael Kerrisk
 230         SEE ALSO: add tcgetsid(3)
 231
 232 fanotify.7
 233     Matthew Bobrowski
 234         Reword FAN_REPORT_FID data structure inclusion semantics
 235     Michael Kerrisk
 236         Clarify logic in ESTALE check
 237     Michael Kerrisk
 238         Reorder text in EXAMPLE
 239     Michael Kerrisk
 240         Reformat program output to fit in 80 columns
 241
 242 mount_namespaces.7
 243     Michael Kerrisk
 244         Clarify implications for other NS if mount point is removed in one NS
 245             If a mount point is deleted or renamed or removed in one mount
 246             namespace, this will cause an object that is mounted at that
 247             location in another mount namespace to be unmounted (as verified
 248             by experiment). This was implied by the existing text, but it is
 249             better to make this detail explicit.
 250     Michael Kerrisk
 251         SEE ALSO: add pivot_root(2), pivot_root(8)
 252
 253 namespaces.7
 254     Michael Kerrisk
 255         Note initial values of hostname and domainname in a new UTS namespace
 256
 257 sched.7
 258     Michael Kerrisk
 259         SEE ALSO: add pthread_getschedparam(3)
 260
 261 signal.7
 262     Michal Sekletar  [Oleg Nesterov, Michael Kerrisk]
 263         Clarify that siginfo_t isn't changed on coalescing
 264     Michael Kerrisk
 265         Various fields in /proc/PID/status show signal-related information
 266     Michael Kerrisk
 267         Add subsection on queuing and delivery semantics for standard signals
 268
 269 socket.7
 270     Michael Kerrisk
 271         select()/poll()/epoll honor SO_RCVLOWAT since Linux 2.6.28
 272
 273 unix.7
 274     Michael Kerrisk
 275         Note SCM_RIGHTS interaction with RLIMIT_NOFILE
 276             If the file descriptors received in SCM_RIGHTS would cause
 277             the process to its exceed RLIMIT_NOFILE limit, the excess
 278             FDs are discarded.
 279
 280 user_namespaces.7
 281     Michael Kerrisk
 282         Describe the effect of file-related capabilities inside use namespaces
 283     Michael Kerrisk
 284         Describe how kernel treats UIDs/GIDs when a process accesses files
 285
 286 vdso.7
 287     Tobias Klauser
 288         Mention removal of Blackfin port in Linux 4.17
 289
 290 ld.so.8
 291     Michael Kerrisk  [Matthias Hertel]
 292         Note some further details of secure-execution mode
 293             Note some further details of the treatment of environment
 294             variables in secure execution mode. In particular (as noted by
 295             Matthias Hertel), note that ignored environment variables are also
 296             stripped from the environment. Furthermore, there are some other
 297             variables, not used by the dynamic linker itself, that are also
 298             treated in this way (see the glibc source file
 299             sysdeps/generic/unsecvars.h).