-==================== Changes in man-pages-5.06 ====================
+==================== Changes in man-pages-5.07 ====================
Released: ????-??-??, Munich
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Alejandro Colomar <colomar.6.4.3@gmail.com>
-Aleksa Sarai <cyphar@cyphar.com>
-Alexander Miller <alex.miller@gmx.de>
-Andrea Arcangeli <aarcange@redhat.com>
-André Almeida <andrealmeid@collabora.com>
-Andrei Vagin <avagin@gmail.com>
-Andrew Micallef <andrew.micallef@live.com.au>
-Bart Van Assche <bvanassche@acm.org>
-Benjamin Peterson <benjamin@python.org>
-Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
-Christian Brauner <christian@brauner.io>
-devi R.K <devi.feb27@gmail.com>
-Dmitry Safonov <dima@arista.com>
-Eric Biggers <ebiggers@google.com>
-Eric Dumazet <eric.dumazet@gmail.com>
-Eric Rannaud <e@nanocritical.com>
-Eugene Syromyatnikov <evgsyr@gmail.com>
-Heinrich Schuchardt <xypron.glpk@gmx.de>
-Helge Deller <deller@gmx.de>
-Jakub Wilk <jwilk@jwilk.net>
-Jorgen Hansen <jhansen@vmware.com>
-Julia Suvorova <jusual@mail.ru>
-Keno Fischer <keno@juliacomputing.com>
-Krzysztof Małysa <varqox@gmail.com>
-Marc Lehmann <debian-reportbug@plan9.de>
-Matthew Bobrowski <mbobrowski@mbobrowski.org>
-Michael Galassi <michael@galassi.us>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Michal Hocko <mhocko@kernel.org>
-Mike Christie <mchristi@redhat.com>
-Mike Frysinger <vapier@gentoo.org>
-Pablo M. Ronchi <pmronchi@yahoo.com.ar>
-Ricardo Biehl Pasquali <pasqualirb@gmail.com>
-Stefan Hajnoczi <stefanha@redhat.com>
-Stefano Garzarella <sgarzare@redhat.com>
-Thomas Gleixner <tglx@linutronix.de>
-Walter Harms <wharms@bfs.de>
-Zack Weinberg <zackw@panix.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-openat2.2
- Aleksa Sarai [Michael Kerrisk]
- Document new openat2(2) syscall
-
-pidfd_getfd.2
- Michael Kerrisk [Christian Brauner]
- New manual page documenting the pidfd_getfd() system call
-
-select.2
- Michael Kerrisk
- Rewrite DESCRIPTION
- Improve structure and readability, at the same time incorporating
- text and details that were formerly in select_tut(2). Also
- move a few details in other parts of the page into DESCRIPTION.
- Michael Kerrisk
- Consolidate the discussion of pselect into a headed subsection
- Michael Kerrisk
- Consolidate historical glibc pselect() details under one subhead
- Michael Kerrisk
- Consolidate info on usleep() emulation in one place
- Michael Kerrisk
- Place the discussion of the self-pipe technique in a headed subsection
- Michael Kerrisk
- Note that FD_SET() and FD_CLR() do not return errors
- Michael Kerrisk
- Remove details of historical #include requirements
- The POSIX situation has been the norm for a long time now,
- and including ancient details overcomplicates the page.
- Michael Kerrisk
- Remove some ancient information about pre-POSIX types for 'timeout'
-
-select_tut.2
- Michael Kerrisk
- Eliminate duplication of info across select_tut.2 and select2
- There was a lot of a duplication of info in SYNOPSIS, DESCRIPTION
- RETURN VALUE, and SEE ALSO. Move all of the info to one place:
- the select(2) page.
-
-sysvipc.7
- Michael Kerrisk
- Rewrite this page as just a summary of the System V IPC APIs
- All of the other details in this page have by now been moved into
- the relevant *ctl(2) pages.
-
-time_namespaces.7
- Michael Kerrisk [Andrei Vagin, Dmitry Safonov, Thomas Gleixner]
- New page documenting time namespaces
-
Newly documented interfaces in existing pages
---------------------------------------------
-arch_prctl.2
- Keno Fischer
- Add ARCH_SET_CPUID subcommand
-
-clock_getres.2
- Benjamin Peterson
- Document CLOCK_TAI
- Michael Kerrisk
- Add CLOCK_REALTIME_ALARM and CLOCK_BOOTTIME_ALARM
-
-prctl.2
- Mike Christie [Michal Hocko, Michael Kerrisk, Bart Van Assche]
- Document PR_SETIO_FLUSHER/GET_IO_FLUSHER
-
-setns.2
- Michael Kerrisk
- Document CLONE_NEWTIME
-statx.2
- Eric Biggers
- Document STATX_ATTR_VERITY
-
-unshare.2
- Michael Kerrisk
- Document CLONE_NEWTIME
-
-socket.7
- Ricardo Biehl Pasquali, Michael Kerrisk
- Add description of SO_SELECT_ERR_QUEUE
- Alejandro Colomar [Michael Kerrisk]
- Document SO_TIMESTAMPNS
+New and changed links
+---------------------
Global changes
--------------
-Various pages
- Michael Kerrisk
- Remove a few mentions of the ancient "Linux libc"
-
-Various pages
- Michael Kerrisk
- Global formatting fix: disfavor nonstandard .TP indents
- In many cases, these don't improve readability, and (when stacked)
- they sometimes have the side effect of sometimes forcing text
- to be justified within a narrow column range.
-
-Various pages
- Michael Kerrisk [Christian Brauner]
- Fix clumsy wording around "nonnegative file descriptors"
-
Changes to individual pages
---------------------------
-clock_getres.2
- Helge Deller [Michael Kerrisk]
- Consecutive calls for CLOCK_MONOTONIC may return same value
- Consecutive calls to clock_gettime(CLOCK_MONOTONIC) are guaranteed
- to return MONOTONIC values, which means that they either return
- the *SAME* time value like the last call, or a later (higher) time
- value.
- Eric Rannaud
- Dynamic POSIX clock devices can return other errors
- Michael Kerrisk
- Improve description of CPU-time clocks
- Michael Kerrisk
- Add an example program
- Michael Kerrisk
- CLOCK_REALTIME_COARSE is not settable
- Michael Kerrisk
- Note that CPU-time clocks are not settable.
- Explicitly note that CLOCK_PROCESS_CPUTIME_ID and
- CLOCK_PROCESS_CPUTIME_ID are not settable.
- Michael Kerrisk
- Clarify that CLOCK_TAI is nonsettable
- Michael Kerrisk
- Clarify that CLOCK_MONOTONIC is system-wide
- Michael Kerrisk
- ERRORS: add EINVAL for attempt to set a nonsettable clock
- Michael Kerrisk
- Move text in BUGS to NOTES
- The fact that CLOCK_PROCESS_CPUTIME_ID and
- CLOCK_PROCESS_CPUTIME_ID are not settable isn't a bug,
- since POSIX does allow the possibility that these clocks
- are not settable.
- Michael Kerrisk
- SEE ALSO: add time_namespaces(7)
-
-clock_nanosleep.2
- Michael Kerrisk
- clock_nanosleep() can also sleep against CLOCK_TAI
- Michael Kerrisk
- clock_nanosleep() also supports CLOCK_BOOTTIME
- Presumably (and from a quick glance at the source code)
- since Linux 2.6.39, when CLOCK_BOOTTIME was introduced.
-
-clock_nanosleep.2
-timer_create.2
-timerfd_create.2
- Michael Kerrisk
- Add various missing errors
- Mostly verified by testing and reading the code.
-
- There is unfortunately quite a bit of inconsistency across API~s:
-
- clock_gettime clock_settime clock_nanosleep timer_create timerfd_create
-
- CLOCK_BOOTTIME y n (EINVAL) y y y
- CLOCK_BOOTTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
- CLOCK_MONOTONIC y n (EINVAL) y y y
- CLOCK_MONOTONIC_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
- CLOCK_MONOTONIC_RAW y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
- CLOCK_REALTIME y y y y y
- CLOCK_REALTIME_ALARM y n (EINVAL) y [1] y [1] y [1]
- CLOCK_REALTIME_COARSE y n (EINVAL) n (ENOTSUP) n (ENOTSUP) n (EINVAL)
- CLOCK_TAI y n (EINVAL) y y n (EINVAL)
- CLOCK_PROCESS_CPUTIME_ID y n (EINVAL) y y n (EINVAL)
- CLOCK_THREAD_CPUTIME_ID y n (EINVAL) n (EINVAL [2]) y n (EINVAL)
- pthread_getcpuclockid() y n (EINVAL) y y n (EINVAL)
-
- [1] The caller must have CAP_WAKE_ALARM, or the error EPERM results.
-
- [2] This error is generated in the glibc wrapper.
-
-connect.2
- Michael Kerrisk [Eric Dumazet]
- Update the details on AF_UNSPEC
- Update the details on AF_UNSPEC and circumstances in which
- socket can be reconnected.
-
-dup.2
- Michael Kerrisk
- SEE ALSO: add pidfd_getfd(2)
-
-epoll_ctl.2
- Michael Kerrisk
- Various minor additions and clarifications
-
-epoll_wait.2
- Michael Kerrisk
- A few minor additions and rewrites
-
-execve.2
- Michael Kerrisk
- Add a subhead for the discussion of effect on process attributes
- Michael Kerrisk
- Explicitly note that argv[argc] == NULL in the new program
- Michael Kerrisk
- ERRORS: ENOENT does not occur for missing shared libraries
- See http://sourceware.org/bugzilla/show_bug.cgi?id=12241.
-
-_exit.2
- Michael Kerrisk
- Clarify that raw _exit() system call terminates only the calling thread
-
-inotify_add_watch.2
- Michael Kerrisk
- EXAMPLE: add reference to example in inotify(7)
-
-io_submit.2
- Julia Suvorova
- Add IOCB_CMD_POLL opcode
-
-lseek.2
- Michael Kerrisk
- ERRORS: ENXIO can also occur SEEK_DATA in middle of hole at end of file
-
-madvise.2
- Michael Kerrisk [Andrea Arcangeli]
- Incorporate some (ancient) comments about MADV_HUGEPAGE
- Back in 2011, a mail from Andrea Arcangeli noted some details
- that I never got round to incorporating into the manual page.
-
-mmap.2
- Michael Kerrisk
- Add a subhead for the 'flags' argument
- Michael Kerrisk
- Move some text hidden at the end of DESCRIPTION to NOTES
-
-msgctl.2
- Michael Kerrisk
- Add information on permission bits (based on sysvipc(7) text)
- Michael Kerrisk
- Copy information on 'msqid_ds' fields from sysvipc(7)
-
-open.2
- Michael Kerrisk
- Clarify that O_NOFOLLOW is relevant (only) for basename of 'pathname'
- Aleksa Sarai
- Add references to new openat2(2) page
- Michael Kerrisk
- Note EINVAL error for invalid character in basename of 'pathname'
-
-pidfd_open.2
- Michael Kerrisk
- Mention pidfd_getfd(2)
-
-poll.2
- Michael Kerrisk
- Add an example program
- Michael Kerrisk
- Mention epoll(7) in the introductory paragraph
- Michael Kerrisk
- Improve description of EFAULT error
- Michael Kerrisk
- Fix description of ENOMEM error
-
-select_tut.2
- Michael Kerrisk
- Adjust header file includes in example
- Employ <sys/select.h>, rather than the historical header files.
-
-semctl.2
- Michael Kerrisk
- Copy information on 'semid_ds' fields from sysvipc(7)
- Michael Kerrisk
- Add a reference to the example in shmop(2)
- Michael Kerrisk
- Add information on permission bits (based on sysvipc(7) text)
-
-semget.2
- Michael Kerrisk
- EXAMPLE: add an example program
-
-semop.2
- Michael Kerrisk
- Add a reference to the semop(2) example in shmop(2)
-
-shmctl.2
- Michael Kerrisk
- Add information on permission bits (based on sysvipc(7) text)
- Michael Kerrisk
- Note that execute permission is not needed for shmat() SHM_EXEC
- Michael Kerrisk
- Copy information on 'shmid_ds' fields from sysvipc(7)
- Michael Kerrisk
- Some small improvements to the description of the 'shmid_ds' structure
-
-shmget.2
- Michael Kerrisk
- Add a reference to the example in shmop(2)
-
-shmop.2
- Michael Kerrisk
- EXAMPLE: add a pair of example programs
- Add example programs demonstrating usage of shmget(2), shmat(2),
- semget(2), semctl(2), and semop(2).
-
-sigaction.2
-signal.7
- Zack Weinberg
- Document kernel bugs in delivery of signals from CPU exceptions
-
-stat.2
- Michael Kerrisk
- Clarify definitions of timestamp fields
- In particular, make it clear that atime and mtime relate to the
- file *data*.
-
-syscalls.2
- Michael Kerrisk
- Add new Linux 5.6 system calls
- Michael Kerrisk
- Note that the 5.x series followed 4.20
-
-timer_create.2
- Michael Kerrisk
- timer_create(2) also supports CLOCK_TAI
- Michael Kerrisk
- Mention clock_getres(2) for further details on the various clocks
-
-timerfd_create.2
- Michael Kerrisk [Thomas Gleixner]
- Note a case where timerfd_settime() can fail with ECANCELED
- Michael Kerrisk [devi R.K, Thomas Gleixner]
- Negative changes to CLOCK_REALTIME may cause read() to return 0
- Michael Kerrisk
- Rework text for EINVAL for invalid clock ID
- Michael Kerrisk
- Refer reader to clock_getres(2) for further details on the clocks
-
-unshare.2
- Michael Kerrisk
- Add CLONE_NEWCGROUP and CLONE_NEWTIME to example program
-
-exit.3
- Michael Kerrisk [Walter Harms]
- Small improvement to the discussion of 'status' argument
-
-ftok.3
- Michael Kerrisk
- EXAMPLE: add a reference to the example in semget(2)
-
-getifaddrs.3
- Michael Kerrisk [Michael Galassi]
- EXAMPLE: remove unneeded loop variable
-
-nl_langinfo.3
- Eugene Syromyatnikov
- Document era-related locale elements
- Eugene Syromyatnikov
- Add information about AM/PM time format locale elements
- Eugene Syromyatnikov
- Mention the respective strftime(3) conversion specifications
-
-sem_init.3
- Michael Kerrisk
- Add references to example code in shm_open(3) and sem_wait(3)
-
-sem_post.3
- Michael Kerrisk
- Add a reference to code example code in shm_open(3)
-
-shm_open.3
- Michael Kerrisk
- EXAMPLE: add some example programs
-
-strcmp.3
- Michael Kerrisk
- Add an example program
- Michael Kerrisk [Andrew Micallef, Walter Harms]
- Rework text describing return value to be clearer
- Michael Kerrisk
- Note that the comparison is done using unsigned char
- Michael Kerrisk
- SEE ALSO: add ascii(7)
-
-strftime.3
- Eugene Syromyatnikov [Michael Kerrisk]
- Refer to the relevant nl_langinfo(3) items
- Eugene Syromyatnikov
- Expand %E and %O description
- Eugene Syromyatnikov
- Consistently document fall-back format string
-
-proc.5
- Mike Frysinger
- Clarify /proc/[pid]/cmdline mutability
-
-cgroups.7
- Michael Kerrisk
- Update list of cgroups v2 controllers
- Update the list of cgroups v2 controllers (several controllers
- were missing).
- Michael Kerrisk
- Add a subsection on cgroup v2 mount options and include 'nsdelegate'
- Michael Kerrisk
- Document the cgroups v2 'memory_localevents' mount option
- Michael Kerrisk
- SEE ALSO: add Documentation/admin-guide/cgroup-v2.rst
-
-namespaces.7
- Michael Kerrisk
- Add time namespaces information
- Michael Kerrisk
- Eliminate some superfluous info from display of /proc/PID/ns links
-
-path_resolution.7
- Aleksa Sarai
- Update to mention openat2(2) features
-
-socket.7
- Michael Kerrisk
- Note SCM message types for SO_TIMESTAMP and SO_TIMESTAMPNS
-
-tcp.7
- Michael Kerrisk
- SEE ALSO: mention Documentation/networking/ip-sysctl.txt
-
-time.7
- Michael Kerrisk
- Add small subsection on clocks and time namespaces
-
-unix.7
- Heinrich Schuchardt
- Correct example
-
-vsock.7
- Stefano Garzarella [Jorgen Hansen, Stefan Hajnoczi]
- Add VMADDR_CID_LOCAL description
projects / thirdparty / man-pages.git / blobdiff