Changes

   1 ==================== Changes in man-pages-5.13 ====================
   2
   3 Released: ????-??-??, Christchurch
   4
   5 Ahelenia Ziemiańska (наб) <nabijaczleweli@nabijaczleweli.xyz>
   6 Alan Peakall <Alan.Peakall@helpsystems.com>
   7 Alejandro Colomar <alx.manpages@gmail.com>
   8 Alexis Wilke <alexis@m2osw.com>
   9 Askar Safin <safinaskar@mail.ru>
  10 Christian Brauner <christian.brauner@ubuntu.com>
  11 Christophe Leroy <christophe.leroy@csgroup.eu>
  12 Christopher Yeleighton <giecrilj@stegny.2a.pl>
  13 Cristian Morales Vega <christian.morales.vega@gmail.com>
  14 Dan Robertson <dan@dlrobertson.com>
  15 Darrick J. Wong <djwong@kernel.org>
  16 Dominique Brazziel <dbrazziel@snet.net>
  17 EmanueleTorre <torreemanuele6@gmail.com>
  18 Eric W. Biederman <ebiederm@xmission.com>
  19 G. Branden Robinson <g.branden.robinson@gmail.com>
  20 Helge Kreutzmann <debian@helgefjell.de>
  21 Jakub Wilk <jwilk@jwilk.net>
  22 James O. D. Hunt <jamesodhunt@gmail.com>
  23 Jonny Grant <jg@jguk.org>
  24 Kees Cook <keescook@chromium.org>
  25 Kir Kolyshkin <kolyshkin@gmail.com>
  26 Kurt Kanzenbach <kurt@linutronix.de>
  27 kXuan <kxuanobj@gmail.com>
  28 Michael Kerrisk <mtk.manpages@gmail.com>
  29 Michael Weiß <michael.weiss@aisec.fraunhofer.de>
  30 NeilBrown <neilb@suse.de>
  31 Nora Platiel <nplatiel@gmx.us>
  32 Pali Rohár <pali@kernel.org>
  33 Peter Collingbourne <pcc@google.com>
  34 Richard Palethorpe <rpalethorpe@suse.com>
  35 Rodrigo Campos <rodrigo@kinvolk.io>
  36 Sagar Patel <sagarmp@cs.unc.edu>
  37 Serge E. Hallyn <serge@hallyn.com>
  38 Sergey Petrakov <kr@spmail.info>
  39 Stefan Kanthak <stefan.kanthak@nexgo.de>
  40 Štěpán Němec <stepnem@gmail.com>
  41 Thomas Gleixner <tglx@linutronix.de>
  42 Thomas Voss <thomasavoss@protonmail.com>
  43 Viet Than <thanhoangviet@gmail.com>
  44 Will Manley <will@williammanley.net>
  45
  46 Contributors
  47 ------------
  48
  49 The following people contributed patches/fixes or (noted in brackets
  50 in the changelog below) reports, notes, and ideas that have been
  51 incorporated in changes in this release:
  52
  53
  54 Apologies if I missed anyone!
  55
  56
  57 New and rewritten pages
  58 -----------------------
  59
  60 mount_setattr.2
  61     Christian Brauner  [Alejandro Colomar, Michael Kerrisk]
  62         New manual page documenting the mount_setattr() system call
  63
  64
  65 Newly documented interfaces in existing pages
  66 ---------------------------------------------
  67
  68 futex.2
  69     Kurt Kanzenbach  [Alejandro Colomar, Thomas Gleixner, Michael Kerrisk]
  70         Document FUTEX_LOCK_PI2
  71
  72 ioctl_tty.2
  73     Pali Rohár  [Alejandro Colomar, Michael kerrisk]
  74         Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2
  75
  76 pidfd_open.2
  77     Michael Kerrisk
  78         Document PIDFD_NONBLOCK
  79
  80 seccomp_unotify.2
  81     Rodrigo Campos  [Alejandro Colomar]
  82         Document SECCOMP_ADDFD_FLAG_SEND
  83
  84 sigaction.2
  85     Peter Collingbourne  [Alejandro Colomar, Michael Kerrisk]
  86         Document SA_EXPOSE_TAGBITS and the flag support detection protocol
  87
  88 statx.2
  89     NeilBrown
  90         Document STATX_MNT_ID
  91 capabilities.7
  92 user_namespaces.7
  93     Michael Kerrisk, Kir Kolyshkin  [Alejandro Colomar]
  94         Describe CAP_SETFCAP for mapping UID 0
  95
  96 mount_namespaces.7
  97     Michael Kerrisk  [Christian Brauner, Eric W. Biederman]
  98         More clearly explain the notion of locked mounts
  99             For a long time, this manual page has had a brief discussion of
 100             "locked" mounts, without clearly saying what this concept is, or
 101             why it exists. Expand the discussion with an explanation of what
 102             locked mounts are, why mounts are locked, and some examples of the
 103             effect of locking.
 104 user_namespaces.7
 105     Michael Kerrisk
 106         Document /proc/PID/projid_map
 107
 108 ld.so.8
 109     Michael Kerrisk
 110         Document --list-tunables option added in glibc 2.33
 111
 112
 113 Global changes
 114 --------------
 115
 116 A few pages
 117     Michael Kerrisk
 118         ERRORS: correct alphabetic order
 119
 120 A few pages
 121     Michael Kerrisk
 122         Place SEE ALSO entries in correct order
 123
 124 A few pages
 125     Michael Kerrisk
 126         Arrange .SH sections in correct order
 127
 128 Various pages
 129     Michael Kerrisk
 130         Fix EBADF error description
 131             Make the description of the EBADF error for invalid 'dirfd' more
 132             uniform. In particular, note that the error only occurs when the
 133             pathname is relative, and that it occurs when the 'dirfd' is
 134             neither valid *nor* has the value AT_FDCWD.
 135
 136 Various pages
 137     Michael Kerrisk
 138         ERRORS: combine errors into a single alphabetic list
 139             These pages split out extra errors for some APIs into a separate
 140             list.  Probably, the pages are easier to ready if all errors are
 141             combined into a single list.
 142
 143             Note that there still remain a few pages where the errors are
 144             listed separately for different APIs. For the moment, it seems
 145             best to leave those pages as is, since the error lists are
 146             largely distinct in those pages.
 147
 148 VArious pages
 149     Michael Kerrisk
 150         Terminology clean-up: "mount point" ==> "mount"
 151             Many times, these pages use the terminology "mount point", where
 152             "mount" would be better. A "mount point" is the location at which
 153             a mount is attached. A "mount" is an association between a
 154             filesystem and a mount point.
 155
 156 accept.2
 157 access.2
 158 getpriority.2
 159 mlock.2
 160     Michael Kerrisk
 161         ERRORS: combine errors into a single list
 162             These pages split out errors into separate lists (perhaps per API,
 163             perhaps "may" vs "shall", perhaps "Linux-specific" vs
 164             standard(??)), but there's no good reason to do this.  It makes
 165             the error list harder to read, and is inconsistent with other
 166             pages. So, combine the errors into a single list.
 167
 168 fanotify_mark.2
 169 futimesat.2
 170 mount_setattr.2
 171 statx.2
 172 symlink.2
 173 mkfifo.3
 174     Michael Kerrisk
 175         Refer the reader to openat(2) for explanation of why 'dirfd' is useful
 176
 177 Various pages
 178     Thomas Voss  [Alejandro Colomar]
 179         Consistently use '*argv[]'
 180
 181
 182 Changes to individual pages
 183 ---------------------------
 184
 185 iconv.1
 186 iconvconfig.8
 187     Michael Kerrisk  [Christopher Yeleighton]
 188         FILES: note that files may be under /usr/lib64 rather than /lib/64
 189             See https://bugzilla.kernel.org/show_bug.cgi?id=214163
 190
 191 ldd.1
 192     Alejandro Colomar  [EmanueleTorre]
 193         Fix example command
 194
 195 add_key.2
 196 keyctl.2
 197 request_key.2
 198     Michael Kerrisk  [Dominique Brazziel]
 199         Note that the "libkeyutils" package provides <keyutils.h>
 200             See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992377
 201
 202 close_range.2
 203     Michael Kerrisk, Alejandro Colomar
 204         Glibc 2.34 has added a close_range() wrapper
 205
 206 execve.2
 207     Michael Kerrisk  [Nora Platiel]
 208         The pathname given to interpreter is not necessarily absolute
 209     Michael Kerrisk
 210         SEE ALSO: getauxval(3)
 211             getauxval(3) is useful background regarding execve(2).
 212
 213 fanotify_mark.2
 214     Michael Kerrisk
 215         ERRORS: add missing EBADF error for invalid 'dirfd'
 216
 217 ioctl_tty.2
 218     Pali Rohár  [Alejandro Colomar]
 219         Update DTR example
 220             Do not include unused (and incompatible) header file termios.h and
 221             include required header files for puts() and close() functions.
 222
 223 mount.2
 224     Michael Kerrisk
 225         ERRORS: add EPERM error for case where a mount is locked
 226             Refer the reader to mount_namespaces(7) for details.
 227     Michael Kerrisk
 228         SEE  ALSO: add mount_setattr(2)
 229
 230 open.2
 231     Michael Kerrisk
 232         Explicitly describe the EBADF error that can occur with openat()
 233             In particular, specifying an invalid file descriptor number
 234             in 'dirfd' can be used as a check that 'pathname' is absolute.
 235     Michael Kerrisk
 236         Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH
 237     Michael Kerrisk
 238         Add mount_setattr(2) to list of 'dirfd' APIs
 239
 240 open_by_handle_at.2
 241     Michael Kerrisk
 242         ERRORS: add missing EBADF error for invalid 'dirfd'
 243
 244 readv2.2
 245     Will Manley  [Alejandro Colomar]
 246         Note preadv2(..., RWF_NOWAIT) bug in BUGS section
 247
 248 readv.2
 249 pipe.7
 250     Michael Kerrisk  [наб]
 251         Make text on pipe writes more general to avoid a confusion in writev(2)
 252
 253 seccomp.2
 254     Eric W. Biederman  [Kees Cook]
 255         Clarify that bad system calls kill the thread (not the process)
 256
 257 syscalls.2
 258     Michael Kerrisk
 259         Add quotactl_fd(); remove quotactl_path()
 260             quotactl_path() was never wired up in Linux 5.13.
 261             It was replaced instead by quotactl_fd(),
 262     Michael Kerrisk
 263         Add system calls that are new in 5.13
 264
 265 umount.2
 266     Michael Kerrisk
 267         ERRORS: add EINVAL for case where mount is locked
 268
 269 wait.2
 270     Richard Palethorpe  [Alejandro Colomar]
 271         Add ESRCH for when pid == INT_MIN
 272     Michael Kerrisk
 273         ERRORS: document EAGAIN for waitid() on a PID file descriptor
 274
 275 getaddrinfo.3
 276     Alejandro Colomar  [Cristian Morales Vega]
 277         Note that 'errno' is set in parallel with EAI_SYSTEM
 278
 279 getauxval.3
 280     Michael Kerrisk
 281         SEE ALSO: add execve(2)
 282
 283 getopt.3
 284     James O. D. Hunt  [Alejandro Colomar]
 285         Further clarification of 'optstring'
 286
 287 pthread_setname_np.3
 288     Michael Kerrisk  [Alexis Wilke]
 289         EXAMPLES: remove a bug by simplifying the code
 290
 291 strlen.3
 292 wcslen.3
 293     Michael Kerrisk  [Alejandro Colomar, Jonny Grant]
 294         Recommend alternatives where input buffer might not be null-terminated
 295
 296 strstr.3
 297     Alejandro Colomar  [Stefan Kanthak]
 298         Document special case for empty needle
 299
 300 termios.3
 301     Pali Rohár  [Alejandro Colomar]
 302         SPARC architecture has 4 different Bnnn constants
 303     Pali Rohár  [Alejandro Colomar]
 304         Add information how to set baud rate to any other value
 305     Pali Rohár  [Alejandro Colomar]
 306         Use bold style for Bnn and EXTn macro constants
 307     Pali Rohár  [Alejandro Colomar]
 308         Document missing baud-rate constants
 309
 310 tsearch.3
 311     Michael Kerrisk
 312         NAME: add twalk_r
 313
 314 wcstok.3
 315     Jakub Wilk
 316         Fix type mismatch in the example
 317
 318 proc.5
 319     Michael Kerrisk
 320         Add /proc/PID/projid_map, referring reader to user_namespaces(7)
 321     Michael Kerrisk
 322         Remove duplicated /proc/[pid]/gid_map entry
 323
 324 mount_namespaces.7
 325     Michael Kerrisk
 326         Terminology clean-up: "mount point" ==> "mount"
 327             Many times, this page uses the terminology "mount point", where
 328             "mount" would be better. A "mount point" is the location at which
 329             a mount is attached. A "mount" is an association between a
 330             filesystem and a mount point.
 331     Michael Kerrisk
 332         SEE ALSO: add mount_setattr(2)
 333
 334 namespaces.7
 335     Štěpán Němec  [Alejandro Colomar]
 336         Fix confusion caused by text reorganization
 337
 338 path_resolution.7
 339     Michael Kerrisk  [Askar Safin]
 340         Improve description of trailing slashes
 341             See https://bugzilla.kernel.org/show_bug.cgi?id=212385
 342
 343 posixoptions.7
 344     Alejandro Colomar  [Alan Peakall]
 345         Fix legacy functions list (s/getcwd/getwd/)
 346
 347 user_namespaces.7
 348     Kir Kolyshkin  [Alejandro Colomar]
 349         Fix a reference to a kernel document
 350     Michael Kerrisk  [Eric W. Biederman]
 351         Add a definition of "global root"
 352
 353 vdso.7
 354     Michael Kerrisk  [Christophe Leroy]
 355         Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc
 356     Alejandro Colomar  [Christophe Leroy]
 357         Add y2038 compliant gettime for ppc/32