mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-5.05: updating Changes and Changes.old
This commit is contained in:
parent
ab272193ef
commit
c3e1c677fa
175
Changes
175
Changes
|
@ -1,6 +1,6 @@
|
||||||
==================== Changes in man-pages-5.04 ====================
|
==================== Changes in man-pages-5.05 ====================
|
||||||
|
|
||||||
Released: 2019-11-19, Munich
|
Released: ????-??-??, Munich
|
||||||
|
|
||||||
|
|
||||||
Contributors
|
Contributors
|
||||||
|
@ -10,183 +10,26 @@ The following people contributed patches/fixes or (noted in brackets
|
||||||
in the changelog below) reports, notes, and ideas that have been
|
in the changelog below) reports, notes, and ideas that have been
|
||||||
incorporated in changes in this release:
|
incorporated in changes in this release:
|
||||||
|
|
||||||
Andrew Price <anprice@redhat.com>
|
|
||||||
Christian Brauner <christian.brauner@ubuntu.com>
|
|
||||||
Florian Weimer <fweimer@redhat.com>
|
|
||||||
Jakub Wilk <jwilk@jwilk.net>
|
|
||||||
Jan Kara <jack@suse.cz>
|
|
||||||
Jann Horn <jannh@google.com>
|
|
||||||
Kenigbolo Meya Stephen <kenigbol@ut.ee>
|
|
||||||
Marko Myllynen <myllynen@redhat.com>
|
|
||||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
||||||
Mikael Magnusson <mikachu@gmail.com>
|
|
||||||
Robert Edmonds <edmonds@debian.org>
|
|
||||||
Silviu Popescu <silviupopescu1990@gmail.com>
|
|
||||||
Torin Carey <torin@tcarey.uk>
|
|
||||||
Witold Baryluk <witold.baryluk@gmail.com>
|
|
||||||
Yang Xu <xuyang2018.jy@cn.fujitsu.com>
|
|
||||||
|
|
||||||
Apologies if I missed anyone!
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
|
||||||
|
New and rewritten pages
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
|
||||||
Newly documented interfaces in existing pages
|
Newly documented interfaces in existing pages
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
clone.2
|
|
||||||
Michael Kerrisk [Christian Brauner, Jakub Wilk]
|
|
||||||
Document clone3()
|
|
||||||
|
|
||||||
wait.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Add P_PIDFD for waiting on a child referred to by a PID file descriptor
|
|
||||||
|
|
||||||
bpf-helpers.7
|
|
||||||
Michael Kerrisk
|
|
||||||
Refresh against kernel v5.4-rc7
|
|
||||||
|
|
||||||
|
|
||||||
New and changed links
|
New and changed links
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
clone3.2
|
|
||||||
Michael Kerrisk
|
Global changes
|
||||||
New link to clone(2)
|
--------------
|
||||||
|
|
||||||
|
|
||||||
Changes to individual pages
|
Changes to individual pages
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
||||||
clone.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Rename arguments for consistency with clone3()
|
|
||||||
Make the names of the clone() arguments the same as the fields
|
|
||||||
in the clone3() 'args' struct:
|
|
||||||
|
|
||||||
ctid ==> child_pid
|
|
||||||
ptid ==> parent_tid
|
|
||||||
newtls ==> tld
|
|
||||||
child_stack ==> stack
|
|
||||||
Michael Kerrisk
|
|
||||||
Consistently order paragraphs for CLONE_NEW* flags
|
|
||||||
Sometimes the descriptions of these flags mentioned the
|
|
||||||
corresponding section 7 namespace manual page and then the
|
|
||||||
required capabilities, and sometimes the order was the was
|
|
||||||
the reverse. Make it consistent.
|
|
||||||
Michael Kerrisk [Christian Brauner, Jann Horn]
|
|
||||||
EXAMPLE: Allocate child's stack using mmap(2) rather than malloc(3)
|
|
||||||
Christian Brauner suggested mmap(MAP_STACK), rather than
|
|
||||||
malloc(), as the canonical way of allocating a stack for the
|
|
||||||
child of clone(), and Jann Horn noted some reasons why
|
|
||||||
(MAP_STACK exists elsewhere, and mmap() returns a page-aligned
|
|
||||||
block of memory, which is useful if we want to set up a guard
|
|
||||||
page at the end of the stack).
|
|
||||||
Michael Kerrisk [Christian Brauner]
|
|
||||||
Tidy up the description of CLONE_DETACHED
|
|
||||||
The obsolete CLONE_DETACHED flag has never been properly
|
|
||||||
documented, but now the discussion CLONE_PIDFD also requires
|
|
||||||
mention of CLONE_DETACHED. So, properly document CLONE_DETACHED,
|
|
||||||
and mention its interactions with CLONE_PIDFD.
|
|
||||||
Michael Kerrisk [Christian Brauner]
|
|
||||||
Give the introductory paragraph a new coat of paint
|
|
||||||
Change the text in the introductory paragraph (which was written
|
|
||||||
20 years ago) to reflect the fact that clone*() does more things
|
|
||||||
nowadays.
|
|
||||||
Michael Kerrisk
|
|
||||||
Remove wording that suggests CLONE_NEW* flags are for containers
|
|
||||||
These flags are used for implementing many other interesting
|
|
||||||
things by now.
|
|
||||||
Michael Kerrisk
|
|
||||||
Remove various details that are already covered in namespaces pages
|
|
||||||
Remove details of UTS, IPC, and network namespaces that are
|
|
||||||
already covered in the corresponding namespaces pages in section 7.
|
|
||||||
|
|
||||||
clone.2
|
|
||||||
proc.5
|
|
||||||
Michael Kerrisk
|
|
||||||
Adjust references to namespaces(7)
|
|
||||||
Adjust references to namespaces(7) to be references to pages
|
|
||||||
describing specific namespace types.
|
|
||||||
|
|
||||||
fallocate.2
|
|
||||||
Andrew Price
|
|
||||||
Add gfs2 to the list of punch hole-capable filesystems
|
|
||||||
|
|
||||||
ioctl_iflags.2
|
|
||||||
Michael Kerrisk [Robert Edmonds]
|
|
||||||
Emphasize that FS_IOC_GETFLAGS and FS_IOC_SETFLAGS argument is 'int *'
|
|
||||||
|
|
||||||
ioctl_list.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Add reference to ioctl(2) SEE ALSO section
|
|
||||||
The referenced section lists various pages that document ioctls.
|
|
||||||
|
|
||||||
mmap.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Note that MAP_STACK exists on some other systems
|
|
||||||
Michael Kerrisk
|
|
||||||
Some rewording of the description of MAP_STACK
|
|
||||||
Reword a little to allow for the fact that there are now
|
|
||||||
*two* reasons to consider using this flag.
|
|
||||||
|
|
||||||
pidfd_open.2
|
|
||||||
Michael Kerrisk
|
|
||||||
Note the waitid() use case for PID file descriptors
|
|
||||||
Michael Kerrisk
|
|
||||||
Add a subsection header "Use cases for PID file descriptors"
|
|
||||||
Michael Kerrisk
|
|
||||||
Make it a little more explicit the CLONE_PIDFD returns a PID FD
|
|
||||||
|
|
||||||
pivot_root.2
|
|
||||||
Michael Kerrisk
|
|
||||||
EXAMPLE: allocate stack using mmap() MAP_STACK rather than malloc()
|
|
||||||
|
|
||||||
quotactl.2
|
|
||||||
Yang Xu [Jan Kara]
|
|
||||||
Add some details about Q_QUOTAON
|
|
||||||
|
|
||||||
seccomp.2
|
|
||||||
cgroups.7
|
|
||||||
Michael Kerrisk
|
|
||||||
Switch to "considerate language"
|
|
||||||
|
|
||||||
select.2
|
|
||||||
Michael Kerrisk
|
|
||||||
POLLIN_SET/POLLOUT_SET/POLLEX_SET are now defined in terms of EPOLL*
|
|
||||||
Since kernel commit a9a08845e9acbd224e4ee466f5c1275ed50054e8, the
|
|
||||||
equivalence between select() and poll()/epoll is defined in terms
|
|
||||||
of the EPOLL* constants, rather than the POLL* constants.
|
|
||||||
|
|
||||||
wait.2
|
|
||||||
Michael Kerrisk
|
|
||||||
waitid() can be used to wait on children in same process group as caller
|
|
||||||
Since Linux 5.4, idtype == P_PGID && id == 0 can be used to wait
|
|
||||||
on children in same process group as caller.
|
|
||||||
Michael Kerrisk
|
|
||||||
Clarify semantics of waitpid(0, ...)
|
|
||||||
As noted in kernel commit 821cc7b0b205c0df64cce59aacc330af251fa8f7,
|
|
||||||
threads create an ambiguity: what if the calling process's PGID
|
|
||||||
is changed by another thread while waitpid(0, ...) is blocked?
|
|
||||||
So, clarify that waitpid(0, ...) means wait for children whose
|
|
||||||
PGID matches the caller's PGID at the time of the call to
|
|
||||||
waitpid().
|
|
||||||
|
|
||||||
getauxval.3
|
|
||||||
Michael Kerrisk [Witold Baryluk]
|
|
||||||
Clarify that AT_BASE_PLATFORM and AT_EXECFN return pointers to strings
|
|
||||||
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=942207
|
|
||||||
|
|
||||||
resolv.conf.5
|
|
||||||
Florian Weimer
|
|
||||||
Attempt clarify domain/search interaction
|
|
||||||
The domain directive is historic at this point; it should not
|
|
||||||
be used.
|
|
||||||
|
|
||||||
netdevice.7
|
|
||||||
Michael Kerrisk [Silviu Popescu]
|
|
||||||
Small wording fix in description of SIOCGIFCONF
|
|
||||||
SIOCGIFCONF returns "network layer" addresses (not "transport
|
|
||||||
layer").
|
|
||||||
|
|
||||||
uts_namespaces.7
|
|
||||||
Michael Kerrisk
|
|
||||||
Add a little more detail on scope of UTS namespaces
|
|
||||||
|
|
194
Changes.old
194
Changes.old
|
@ -50111,3 +50111,197 @@ signal.7
|
||||||
user_namespaces.7
|
user_namespaces.7
|
||||||
Michael Kerrisk
|
Michael Kerrisk
|
||||||
Improve explanation of meaning of ownership of nonuser namespaces
|
Improve explanation of meaning of ownership of nonuser namespaces
|
||||||
|
|
||||||
|
|
||||||
|
==================== Changes in man-pages-5.04 ====================
|
||||||
|
|
||||||
|
Released: 2019-11-19, 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:
|
||||||
|
|
||||||
|
Andrew Price <anprice@redhat.com>
|
||||||
|
Christian Brauner <christian.brauner@ubuntu.com>
|
||||||
|
Florian Weimer <fweimer@redhat.com>
|
||||||
|
Jakub Wilk <jwilk@jwilk.net>
|
||||||
|
Jan Kara <jack@suse.cz>
|
||||||
|
Jann Horn <jannh@google.com>
|
||||||
|
Kenigbolo Meya Stephen <kenigbol@ut.ee>
|
||||||
|
Marko Myllynen <myllynen@redhat.com>
|
||||||
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||||
|
Mikael Magnusson <mikachu@gmail.com>
|
||||||
|
Robert Edmonds <edmonds@debian.org>
|
||||||
|
Silviu Popescu <silviupopescu1990@gmail.com>
|
||||||
|
Torin Carey <torin@tcarey.uk>
|
||||||
|
Witold Baryluk <witold.baryluk@gmail.com>
|
||||||
|
Yang Xu <xuyang2018.jy@cn.fujitsu.com>
|
||||||
|
|
||||||
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
|
||||||
|
Newly documented interfaces in existing pages
|
||||||
|
---------------------------------------------
|
||||||
|
|
||||||
|
clone.2
|
||||||
|
Michael Kerrisk [Christian Brauner, Jakub Wilk]
|
||||||
|
Document clone3()
|
||||||
|
|
||||||
|
wait.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Add P_PIDFD for waiting on a child referred to by a PID file descriptor
|
||||||
|
|
||||||
|
bpf-helpers.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Refresh against kernel v5.4-rc7
|
||||||
|
|
||||||
|
|
||||||
|
New and changed links
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
clone3.2
|
||||||
|
Michael Kerrisk
|
||||||
|
New link to clone(2)
|
||||||
|
|
||||||
|
|
||||||
|
Changes to individual pages
|
||||||
|
---------------------------
|
||||||
|
|
||||||
|
clone.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Rename arguments for consistency with clone3()
|
||||||
|
Make the names of the clone() arguments the same as the fields
|
||||||
|
in the clone3() 'args' struct:
|
||||||
|
|
||||||
|
ctid ==> child_pid
|
||||||
|
ptid ==> parent_tid
|
||||||
|
newtls ==> tld
|
||||||
|
child_stack ==> stack
|
||||||
|
Michael Kerrisk
|
||||||
|
Consistently order paragraphs for CLONE_NEW* flags
|
||||||
|
Sometimes the descriptions of these flags mentioned the
|
||||||
|
corresponding section 7 namespace manual page and then the
|
||||||
|
required capabilities, and sometimes the order was the was
|
||||||
|
the reverse. Make it consistent.
|
||||||
|
Michael Kerrisk [Christian Brauner, Jann Horn]
|
||||||
|
EXAMPLE: Allocate child's stack using mmap(2) rather than malloc(3)
|
||||||
|
Christian Brauner suggested mmap(MAP_STACK), rather than
|
||||||
|
malloc(), as the canonical way of allocating a stack for the
|
||||||
|
child of clone(), and Jann Horn noted some reasons why
|
||||||
|
(MAP_STACK exists elsewhere, and mmap() returns a page-aligned
|
||||||
|
block of memory, which is useful if we want to set up a guard
|
||||||
|
page at the end of the stack).
|
||||||
|
Michael Kerrisk [Christian Brauner]
|
||||||
|
Tidy up the description of CLONE_DETACHED
|
||||||
|
The obsolete CLONE_DETACHED flag has never been properly
|
||||||
|
documented, but now the discussion CLONE_PIDFD also requires
|
||||||
|
mention of CLONE_DETACHED. So, properly document CLONE_DETACHED,
|
||||||
|
and mention its interactions with CLONE_PIDFD.
|
||||||
|
Michael Kerrisk [Christian Brauner]
|
||||||
|
Give the introductory paragraph a new coat of paint
|
||||||
|
Change the text in the introductory paragraph (which was written
|
||||||
|
20 years ago) to reflect the fact that clone*() does more things
|
||||||
|
nowadays.
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove wording that suggests CLONE_NEW* flags are for containers
|
||||||
|
These flags are used for implementing many other interesting
|
||||||
|
things by now.
|
||||||
|
Michael Kerrisk
|
||||||
|
Remove various details that are already covered in namespaces pages
|
||||||
|
Remove details of UTS, IPC, and network namespaces that are
|
||||||
|
already covered in the corresponding namespaces pages in section 7.
|
||||||
|
|
||||||
|
clone.2
|
||||||
|
proc.5
|
||||||
|
Michael Kerrisk
|
||||||
|
Adjust references to namespaces(7)
|
||||||
|
Adjust references to namespaces(7) to be references to pages
|
||||||
|
describing specific namespace types.
|
||||||
|
|
||||||
|
fallocate.2
|
||||||
|
Andrew Price
|
||||||
|
Add gfs2 to the list of punch hole-capable filesystems
|
||||||
|
|
||||||
|
ioctl_iflags.2
|
||||||
|
Michael Kerrisk [Robert Edmonds]
|
||||||
|
Emphasize that FS_IOC_GETFLAGS and FS_IOC_SETFLAGS argument is 'int *'
|
||||||
|
|
||||||
|
ioctl_list.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Add reference to ioctl(2) SEE ALSO section
|
||||||
|
The referenced section lists various pages that document ioctls.
|
||||||
|
|
||||||
|
mmap.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Note that MAP_STACK exists on some other systems
|
||||||
|
Michael Kerrisk
|
||||||
|
Some rewording of the description of MAP_STACK
|
||||||
|
Reword a little to allow for the fact that there are now
|
||||||
|
*two* reasons to consider using this flag.
|
||||||
|
|
||||||
|
pidfd_open.2
|
||||||
|
Michael Kerrisk
|
||||||
|
Note the waitid() use case for PID file descriptors
|
||||||
|
Michael Kerrisk
|
||||||
|
Add a subsection header "Use cases for PID file descriptors"
|
||||||
|
Michael Kerrisk
|
||||||
|
Make it a little more explicit the CLONE_PIDFD returns a PID FD
|
||||||
|
|
||||||
|
pivot_root.2
|
||||||
|
Michael Kerrisk
|
||||||
|
EXAMPLE: allocate stack using mmap() MAP_STACK rather than malloc()
|
||||||
|
|
||||||
|
quotactl.2
|
||||||
|
Yang Xu [Jan Kara]
|
||||||
|
Add some details about Q_QUOTAON
|
||||||
|
|
||||||
|
seccomp.2
|
||||||
|
cgroups.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Switch to "considerate language"
|
||||||
|
|
||||||
|
select.2
|
||||||
|
Michael Kerrisk
|
||||||
|
POLLIN_SET/POLLOUT_SET/POLLEX_SET are now defined in terms of EPOLL*
|
||||||
|
Since kernel commit a9a08845e9acbd224e4ee466f5c1275ed50054e8, the
|
||||||
|
equivalence between select() and poll()/epoll is defined in terms
|
||||||
|
of the EPOLL* constants, rather than the POLL* constants.
|
||||||
|
|
||||||
|
wait.2
|
||||||
|
Michael Kerrisk
|
||||||
|
waitid() can be used to wait on children in same process group as caller
|
||||||
|
Since Linux 5.4, idtype == P_PGID && id == 0 can be used to wait
|
||||||
|
on children in same process group as caller.
|
||||||
|
Michael Kerrisk
|
||||||
|
Clarify semantics of waitpid(0, ...)
|
||||||
|
As noted in kernel commit 821cc7b0b205c0df64cce59aacc330af251fa8f7,
|
||||||
|
threads create an ambiguity: what if the calling process's PGID
|
||||||
|
is changed by another thread while waitpid(0, ...) is blocked?
|
||||||
|
So, clarify that waitpid(0, ...) means wait for children whose
|
||||||
|
PGID matches the caller's PGID at the time of the call to
|
||||||
|
waitpid().
|
||||||
|
|
||||||
|
getauxval.3
|
||||||
|
Michael Kerrisk [Witold Baryluk]
|
||||||
|
Clarify that AT_BASE_PLATFORM and AT_EXECFN return pointers to strings
|
||||||
|
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=942207
|
||||||
|
|
||||||
|
resolv.conf.5
|
||||||
|
Florian Weimer
|
||||||
|
Attempt clarify domain/search interaction
|
||||||
|
The domain directive is historic at this point; it should not
|
||||||
|
be used.
|
||||||
|
|
||||||
|
netdevice.7
|
||||||
|
Michael Kerrisk [Silviu Popescu]
|
||||||
|
Small wording fix in description of SIOCGIFCONF
|
||||||
|
SIOCGIFCONF returns "network layer" addresses (not "transport
|
||||||
|
layer").
|
||||||
|
|
||||||
|
uts_namespaces.7
|
||||||
|
Michael Kerrisk
|
||||||
|
Add a little more detail on scope of UTS namespaces
|
||||||
|
|
Loading…
Reference in New Issue