mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-5.07: updating Changes and Changes.old
This commit is contained in:
parent
2beaf2a279
commit
ed6c998bdf
463
Changes
463
Changes
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-5.06 ====================
|
||||
==================== Changes in man-pages-5.07 ====================
|
||||
|
||||
Released: 2020-04-11, Munich
|
||||
Released: ????-??-??, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
|
@ -10,44 +10,6 @@ The following people contributed patches/fixes or (noted in brackets
|
|||
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!
|
||||
|
||||
|
@ -55,436 +17,19 @@ 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
|
||||
|
|
492
Changes.old
492
Changes.old
|
@ -50568,3 +50568,495 @@ vsock.7
|
|||
ldconfig.8
|
||||
DJ Delorie
|
||||
Document file filter and symlink pattern expectations
|
||||
|
||||
|
||||
==================== Changes in man-pages-5.06 ====================
|
||||
|
||||
Released: 2020-04-11, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
The following people contributed patches/fixes or (noted in brackets
|
||||
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
|
||||
|
||||
|
||||
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
|
||||
|
|
Loading…
Reference in New Issue