mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-4.12: updating Changes and Changes.old
This commit is contained in:
parent
bdf756a2f6
commit
8b894afd0d
526
Changes
526
Changes
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-4.11 ====================
|
||||
==================== Changes in man-pages-4.12 ====================
|
||||
|
||||
Released: 2017-05-03, Baden, Switzerland
|
||||
Released: ????-??-??, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
|
@ -10,41 +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:
|
||||
|
||||
Alexander Alemayhu <alexander@alemayhu.com>
|
||||
Alexander Miller <alex.miller@gmx.de>
|
||||
Andrea Arcangeli <aarcange@redhat.com>
|
||||
Andreas Dilger <adilger@dilger.ca>
|
||||
Andrew Clayton <andrew@digital-domain.net>
|
||||
Arnd Bergmann <arnd@arndb.de>
|
||||
Ben Dog <wsy2220@gmail.com>
|
||||
Carlos O'Donell <carlos@redhat.com>
|
||||
Chema Gonzalez <chema@google.com>
|
||||
Christian Brauner <christian.brauner@ubuntu.com>
|
||||
Cyril Hrubis <chrubis@suse.cz>
|
||||
David Howells <dhowells@redhat.com>
|
||||
Dmitry V. Levin <ldv@altlinux.org>
|
||||
Florian Weimer <fweimer@redhat.com>
|
||||
Francois Saint-Jacques <fsaintjacques@gmail.com>
|
||||
Frank Theile
|
||||
Georg Sauthoff <mail@georg.so>
|
||||
Ian Abbott <abbotti@mev.co.uk>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jan Heberer <jangc@t-online.de>
|
||||
Marcin Ślusarz <marcin.slusarz@gmail.com>
|
||||
Marko Myllynen <myllynen@redhat.com>
|
||||
Matthew Wilcox <willy@infradead.org>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Mike Rapoport <rppt@linux.vnet.ibm.com>
|
||||
Nicolas Biscos <nicolas.biscos+man7@gmail.com>
|
||||
Nicolas Iooss <Nicolas.Iooss@ssi.gouv.fr>
|
||||
Nikos Mavrogiannopoulos <nmav@redhat.com>
|
||||
Nominal Animal <question@nominal-animal.net>
|
||||
Silvan Jegen <s.jegen@gmail.com>
|
||||
Stephan Bergmann <sbergman@redhat.com>
|
||||
Walter Harms <wharms@bfs.de>
|
||||
Zack Weinberg <zackw@panix.com>
|
||||
丁贵强<dingguiqiang@foxmail.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
@ -52,506 +17,19 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
ioctl_userfaultfd.2
|
||||
Michael Kerrisk, Mike Rapoport
|
||||
New page describing ioctl(2) operations for userfaultfd
|
||||
|
||||
statx.2
|
||||
David Howells, Michael Kerrisk [Andreas Dilger]
|
||||
New page describing statx(2) system call added in Linux 4.11
|
||||
|
||||
userfaultfd.2
|
||||
Mike Rapoport, Michael Kerrisk [Andrea Arcangeli]
|
||||
New page describing userfaultfd(2) system call.
|
||||
|
||||
pthread_atfork.3
|
||||
Michael Kerrisk
|
||||
New page describing pthread_atfork(3)
|
||||
|
||||
slabinfo.5
|
||||
Michael Kerrisk
|
||||
Rewrite to try to bring the content close to current reality
|
||||
There's still gaps to fill in, but the existing page
|
||||
was in any case hugely out of date.
|
||||
|
||||
inode.7
|
||||
Michael Kerrisk
|
||||
New page with information about inodes
|
||||
David Howells provided a statx(2) page that duplicated much of
|
||||
the information from form stat(2). Avoid such duplication
|
||||
by moving the common information in stat(2) and statx(2)
|
||||
to a new page.
|
||||
|
||||
|
||||
Renamed pages
|
||||
--------------
|
||||
|
||||
ioctl_console.2
|
||||
Michael Kerrisk
|
||||
Renamed from console_ioctl.4
|
||||
Most ioctl() man pages are in section 2, so move this one there
|
||||
for consistency.
|
||||
Michael Kerrisk
|
||||
Note type of 'argp' for a various operations
|
||||
For some commands, there was no clear statement about the type
|
||||
of the 'argp' argument.
|
||||
|
||||
ioctl_tty.2
|
||||
Michael Kerrisk
|
||||
Renamed from tty_ioctl(4)
|
||||
All other ioctl(2) pages are in section 2. Make this
|
||||
page consistent.
|
||||
Michael Kerrisk
|
||||
Packet mode state change events give POLLPRI events for poll(2)
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
ioctl_ns.2
|
||||
Michael Kerrisk
|
||||
Document the NS_GET_NSTYPE operation added in Linux 4.11
|
||||
Michael Kerrisk
|
||||
Document the NS_GET_OWNER_UID operation added in Linux 4.11
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/sched_child_runs_first
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
console_ioctl.4
|
||||
Michael Kerrisk
|
||||
Link for old name of ioctl_console(2) page
|
||||
|
||||
tty_ioctl.4
|
||||
Michael Kerrisk
|
||||
Link for old name of ioctl_tty(2) page
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
Various pages
|
||||
Michael Kerrisk
|
||||
Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
|
||||
Michael Kerrisk
|
||||
Change page cross-references for console_ioctl(4) to ioctl_console(2)
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
alarm.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add timer_create(2) and timerfd_create(2)
|
||||
|
||||
chmod.2
|
||||
fsync.2
|
||||
mkdir.2
|
||||
mknod.2
|
||||
open.2
|
||||
truncate.2
|
||||
umask.2
|
||||
utime.2
|
||||
utimensat.2
|
||||
Michael Kerrisk
|
||||
Add/replace references to inode(7)
|
||||
|
||||
clone.2
|
||||
Michael Kerrisk
|
||||
CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error
|
||||
|
||||
clone.2
|
||||
unshare.2
|
||||
Michael Kerrisk
|
||||
Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC
|
||||
Michael Kerrisk
|
||||
CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached
|
||||
Michael Kerrisk
|
||||
Exceeding the maximum nested user namespace limit now gives ENOSPC
|
||||
Formerly, if the limit of 32 nested user namespaces was exceeded,
|
||||
the error EUSERS resulted. Starting with Linux 4.9, the error
|
||||
is ENOSPC.
|
||||
|
||||
epoll_ctl.2
|
||||
Michael Kerrisk
|
||||
Defer to poll(2) for an explanation of EPOLLIN
|
||||
Michael Kerrisk [Nicolas Biscos]
|
||||
EPOLLERR is also set on write end of a pipe when the read end is closed
|
||||
Michael Kerrisk [Nicolas Biscos]
|
||||
Give the reader a clue that the 'events' field can be zero
|
||||
'events' specified as zero still allows EPOLLHUP and
|
||||
EPOLLERR to be reported.
|
||||
|
||||
_exit.2
|
||||
Michael Kerrisk
|
||||
On exit, child processes may be inherited by a "subreaper"
|
||||
It is no longer necessarily true that orphaned processes
|
||||
are inherited by PID 1.
|
||||
Michael Kerrisk
|
||||
Only the least significant byte of exit status is passed to the parent
|
||||
|
||||
fcntl.2
|
||||
Michael Kerrisk
|
||||
Mention memfd_create() in the discussion of file seals
|
||||
Give the reader a clue about what kinds of objects can
|
||||
be employed with file seals.
|
||||
Michael Kerrisk
|
||||
File seals are not generally applicable to tmpfs(5) files
|
||||
As far as I can see, file seals can be applied only to
|
||||
memfd_create(2) file descriptors. This was checked by experiment
|
||||
and by reading mm/shmem.c::shmem_get_inode((), where one finds
|
||||
the following line that applies to all new shmem files:
|
||||
|
||||
info->seals = F_SEAL_SEAL;
|
||||
|
||||
Only in the code of the memfd_create() system call is this
|
||||
setting reversed (in mm/shmem.c::memfd_create):
|
||||
|
||||
if (flags & MFD_ALLOW_SEALING)
|
||||
info->seals &= ~F_SEAL_SEAL;
|
||||
|
||||
fork.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add pthread_atfork(3)
|
||||
|
||||
getdents.2
|
||||
open.2
|
||||
stat.2
|
||||
statx.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add inode(7)
|
||||
|
||||
getdtablesize.2
|
||||
attr.5
|
||||
Alexander Miller
|
||||
Move .so directive to first line
|
||||
Improves compatibility with the man and other dumb tools
|
||||
that process man page files.
|
||||
|
||||
getpid.2
|
||||
Michael Kerrisk
|
||||
Mention init(1) and "subreapers" in discussion of parent PID
|
||||
|
||||
ioctl_list.2
|
||||
Cyril Hrubis [Arnd Bergmann]
|
||||
BLKRASET/BLKRAGET take unsigned long
|
||||
|
||||
ioctl_ns.2
|
||||
Michael Kerrisk
|
||||
ERRORS: document ENOTTY
|
||||
|
||||
kexec_load.2
|
||||
sched_setaffinity.2
|
||||
bootparam.7
|
||||
Michael Kerrisk
|
||||
Documentation/kernel-parameters.txt is now in Documentation/admin-guide/
|
||||
|
||||
lseek.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add fallocate(2)
|
||||
Both of these pages discuss file holes.
|
||||
|
||||
mincore.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add fincore(1)
|
||||
|
||||
mmap.2
|
||||
Michael Kerrisk
|
||||
Remove ancient reference to flags that appear on some other systems
|
||||
MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have
|
||||
appeared on some systems many years ago, but the discussion here
|
||||
mentions no details and the systems and flags probably ceased to
|
||||
be relevant long ago. So, remove this text.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add userfaultfd(2)
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Add statx() to list of "at" calls in rationale discussion
|
||||
|
||||
poll.2
|
||||
Michael Kerrisk
|
||||
Expand discussion of POLLPRI
|
||||
Michael Kerrisk [Nicolas Biscos]
|
||||
POLLERR is also set on write end of a pipe when the read end is closed
|
||||
|
||||
posix_fadvise.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add fincore(1)
|
||||
|
||||
prctl.2
|
||||
Mike Frysinger
|
||||
PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement
|
||||
The Linux 3.10 release dropped the c/r requirement and opened it
|
||||
up to all users.
|
||||
Mike Frysinger
|
||||
PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers
|
||||
Mike Frysinger
|
||||
PR_SET_MM: Document arg4/arg5 zero behavior
|
||||
The kernel will immediately reject calls where arg4/arg5 are not
|
||||
zero. See kernel/sys.c:prctl_set_mm().
|
||||
Michael Kerrisk
|
||||
Explain rationale for use of subreaper processes
|
||||
Michael Kerrisk
|
||||
Note semantics of child_subreaper setting on fork() and exec()
|
||||
Michael Kerrisk
|
||||
Improve description of PR_SET_CHILD_SUBREAPER
|
||||
|
||||
rename.2
|
||||
Michael Kerrisk [Georg Sauthoff]
|
||||
Note that there is no glibc wrapper for renameat2()
|
||||
|
||||
sched_setaffinity.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add get_nprocs(3)
|
||||
|
||||
select.2
|
||||
Michael Kerrisk [Matthew Wilcox, Carlos O'Donell]
|
||||
Linux select() is buggy wrt POSIX in its check for EBADF errors
|
||||
Michael Kerrisk
|
||||
Show correspondence between select() and poll() readiness notifications
|
||||
Michael Kerrisk
|
||||
Give a hint that sets must be reinitialized if using select() in a loop
|
||||
Michael Kerrisk
|
||||
Refer to POLLPRI in poll(2) for info on exceptional conditions
|
||||
Michael Kerrisk
|
||||
Move mislocated text describing the self-pipe text from BUGS to NOTES
|
||||
|
||||
sigaction.2
|
||||
Michael Kerrisk
|
||||
Show the prototype of an SA_SIGINFO signal handler
|
||||
|
||||
signalfd.2
|
||||
Michael Kerrisk
|
||||
SIGKILL and SIGSTOP are silently ignored in 'mask'
|
||||
|
||||
sigprocmask.2
|
||||
Dmitry V. Levin
|
||||
Do not specify an exact value of rt_sigprocmask's 4th argument
|
||||
As sizeof(kernel_sigset_t) is not the same for all architectures,
|
||||
it would be better not to mention any numbers as its value.
|
||||
Michael Kerrisk
|
||||
'set' and 'oldset' can both be NULL
|
||||
|
||||
sigwaitinfo.2
|
||||
Michael Kerrisk
|
||||
sigwaitinfo() can't be used to accept synchronous signals
|
||||
|
||||
socketcall.2
|
||||
Mike Frysinger
|
||||
Document call argument
|
||||
|
||||
stat.2
|
||||
Michael Kerrisk
|
||||
Remove information migrated to inode(7) page
|
||||
Michael Kerrisk
|
||||
Restructure field descriptions as a hanging list
|
||||
Michael Kerrisk
|
||||
Remove "Other systems" subsection
|
||||
These details about other systems were added in 1999,
|
||||
and were probably of limited use then, and even less today.
|
||||
However, they do clutter the page, so remove them.
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: add list entries for 'st_uid' and 'st_gid'
|
||||
Michael Kerrisk
|
||||
Add some subsection headings to ease readability
|
||||
David Howells
|
||||
ERRORS: correct description of ENOENT
|
||||
Michael Kerrisk
|
||||
Give 'struct stat' argument a more meaningful name ('statbuf')
|
||||
Marcin Ślusarz
|
||||
Tweak description of AT_EMPTY_PATH
|
||||
Currently it says when dirfd is AT_FDCWD it can be something
|
||||
other than directory, which doesn't make much sense. Just swap
|
||||
the order of sentences.
|
||||
Michael Kerrisk
|
||||
Add slightly expanded description oif 'st_ino' field
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: add a list entry for 'st_ino'
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: add a list entry for 'st_nlinks' field
|
||||
|
||||
syscalls.2
|
||||
Michael Kerrisk
|
||||
Add membarrier(2)
|
||||
Michael Kerrisk
|
||||
Fix kernel version for userfaultfd(2)
|
||||
Michael Kerrisk
|
||||
Linux 4.11 added statx()
|
||||
Michael Kerrisk
|
||||
Include deprecated getunwind(2) in list
|
||||
|
||||
wait.2
|
||||
Michael Kerrisk
|
||||
Orphaned children may be adopted by a "subreaper", rather by than PD 1
|
||||
|
||||
bzero.3
|
||||
Michael Kerrisk [Zack Weinberg]
|
||||
Add correct header file for exlicit_bzero()
|
||||
|
||||
cfree.3
|
||||
Michael Kerrisk
|
||||
cfree() is removed from glibc in version 2.26
|
||||
|
||||
exit.3
|
||||
Michael Kerrisk
|
||||
Improve discussion of zombie processes
|
||||
|
||||
getentropy.3
|
||||
Nikos Mavrogiannopoulos [Michael Kerrisk, Florian Weimer]
|
||||
Correct header file
|
||||
Michael Kerrisk [Frank Theile]
|
||||
SYNOPSIS: add missing return type for getentropy() declaration
|
||||
|
||||
grantpt.3
|
||||
Michael Kerrisk
|
||||
Tell a more nuanced story about what grantpt() does or does not do
|
||||
|
||||
insque.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add queue(3)
|
||||
|
||||
queue.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add insque(3)
|
||||
|
||||
shm_open.3
|
||||
Michael Kerrisk
|
||||
Clarify that POSIX shared memory uses tmpfs(5)
|
||||
|
||||
syslog.3
|
||||
Michael Kerrisk [Ian Abbott, Walter Harms]
|
||||
Reorganize page text for easier parsing and better readability
|
||||
Michael Kerrisk
|
||||
Various rewordings and improvements
|
||||
Michael Kerrisk
|
||||
Note default value for 'facility' when calling openlog()
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add journalctl(1)
|
||||
|
||||
ttyname.3
|
||||
Dmitry V. Levin
|
||||
Document ENODEV error code
|
||||
Christian Brauner
|
||||
NOTES: warn about a confusing case that may occur with mount namespaces
|
||||
|
||||
|
||||
wcsdup.3
|
||||
Jan Heberer
|
||||
RETURN VALUE: fix error in return value description
|
||||
Return value for failure was accidentally changed from NULL to
|
||||
-1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a.
|
||||
|
||||
elf.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1)
|
||||
|
||||
nsswitch.conf.5
|
||||
Florian Weimer
|
||||
Mention sudoers
|
||||
It turns out that sudo drops things into nsswitch.conf, too.
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Refer to namespaces(7) for discussion of /proc/sys/user/* files
|
||||
Michael Kerrisk
|
||||
Simplify /proc/slabinfo entry
|
||||
Don't repeat (out-of-date) info from slabinfo(5); just defer to
|
||||
that page.
|
||||
|
||||
tmpfs.5
|
||||
Michael Kerrisk
|
||||
tmpfs supports extended attributes, but not 'user' extended attributes
|
||||
|
||||
environ.7
|
||||
Jakub Wilk
|
||||
Fix name of function that honors TMPDIR
|
||||
tempnam() takes the TMPDIR environment variable into account, unlike
|
||||
tmpnam(), which always creates pathnames within /tmp.
|
||||
|
||||
hostname.7
|
||||
Marko Myllynen
|
||||
Use lower case for hostname example
|
||||
Marko Myllynen
|
||||
Use generic names in examples
|
||||
Marko Myllynen
|
||||
Describe accepted characters for hostname
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk [Nicolas Iooss]
|
||||
Mounting a filesystem on top of a monitored directory causes no event
|
||||
|
||||
man-pages.7
|
||||
Michael Kerrisk
|
||||
Note preferred approach for 'duplicate' errors
|
||||
|
||||
namespaces.7
|
||||
Michael Kerrisk
|
||||
Document the /proc/sys/user/* files added in Linux 4.9
|
||||
|
||||
pid_namespaces.7
|
||||
Michael Kerrisk
|
||||
The maximum nesting depth for PID namespaces is 32
|
||||
|
||||
user_namespaces.7: Fixes to example
|
||||
Stephan Bergmann
|
||||
While toying around with the userns_child_exec example program on the
|
||||
user_namespaces(7) man page, I noticed two things:
|
||||
|
||||
* In the EXAMPLE section, we need to mount the new /proc before
|
||||
looking at /proc/$$/status, otherwise the latter will print
|
||||
information about the outer namespace's PID 1 (i.e., the real
|
||||
init). So the two paragraphs need to be swapped.
|
||||
|
||||
* In the program source, make sure to close pipe_fd[0] in the
|
||||
child before exec'ing.
|
||||
|
||||
pthreads.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add pthread_rwlockattr_setkind_np(3)
|
||||
|
||||
pty.7
|
||||
Michael Kerrisk
|
||||
Mention a couple of other applications of pseudoterminals
|
||||
|
||||
sem_overview.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add shm_overview(7)
|
||||
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add sigreturn(2)
|
||||
|
||||
socket.7
|
||||
Michael Kerrisk
|
||||
Enhance the description of SO_INCOMING_CPU
|
||||
Francois Saint-Jacques
|
||||
Document SO_INCOMING_CPU
|
||||
|
||||
tcp.7
|
||||
Michael Kerrisk
|
||||
Note indications for OOB data given by select(2) and poll(2)
|
||||
Chema Gonzalez
|
||||
tcp_abc was removed in 3.9
|
||||
|
||||
xattr.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ioctl_iflags(2)
|
||||
People sometimes confuse xattrs and inode flags. Provide a link
|
||||
to the page that describes inode flags to give them a tip.
|
||||
|
||||
ld.so.8
|
||||
Michael Kerrisk
|
||||
Mention quoting when using "Rpath tokens" in LD_AUDIT and LD_PRELOAD
|
||||
Michael Kerrisk
|
||||
Expand description of /etc/ld.so.preload
|
||||
Michael Kerrisk
|
||||
Mention ldconfig(8) in discussion of /etc/ld.so.cache
|
||||
|
||||
zdump.8
|
||||
Jakub Wilk
|
||||
Add OPTIONS section heading
|
||||
|
|
559
Changes.old
559
Changes.old
|
@ -44843,3 +44843,562 @@ ld.so.8
|
|||
Michael Kerrisk
|
||||
LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
|
||||
|
||||
|
||||
|
||||
==================== Changes in man-pages-4.11 ====================
|
||||
|
||||
Released: 2017-05-03, Baden, Switzerland
|
||||
|
||||
|
||||
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:
|
||||
|
||||
Alexander Alemayhu <alexander@alemayhu.com>
|
||||
Alexander Miller <alex.miller@gmx.de>
|
||||
Andrea Arcangeli <aarcange@redhat.com>
|
||||
Andreas Dilger <adilger@dilger.ca>
|
||||
Andrew Clayton <andrew@digital-domain.net>
|
||||
Arnd Bergmann <arnd@arndb.de>
|
||||
Ben Dog <wsy2220@gmail.com>
|
||||
Carlos O'Donell <carlos@redhat.com>
|
||||
Chema Gonzalez <chema@google.com>
|
||||
Christian Brauner <christian.brauner@ubuntu.com>
|
||||
Cyril Hrubis <chrubis@suse.cz>
|
||||
David Howells <dhowells@redhat.com>
|
||||
Dmitry V. Levin <ldv@altlinux.org>
|
||||
Florian Weimer <fweimer@redhat.com>
|
||||
Francois Saint-Jacques <fsaintjacques@gmail.com>
|
||||
Frank Theile
|
||||
Georg Sauthoff <mail@georg.so>
|
||||
Ian Abbott <abbotti@mev.co.uk>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jan Heberer <jangc@t-online.de>
|
||||
Marcin Ślusarz <marcin.slusarz@gmail.com>
|
||||
Marko Myllynen <myllynen@redhat.com>
|
||||
Matthew Wilcox <willy@infradead.org>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Mike Frysinger <vapier@gentoo.org>
|
||||
Mike Rapoport <rppt@linux.vnet.ibm.com>
|
||||
Nicolas Biscos <nicolas.biscos+man7@gmail.com>
|
||||
Nicolas Iooss <Nicolas.Iooss@ssi.gouv.fr>
|
||||
Nikos Mavrogiannopoulos <nmav@redhat.com>
|
||||
Nominal Animal <question@nominal-animal.net>
|
||||
Silvan Jegen <s.jegen@gmail.com>
|
||||
Stephan Bergmann <sbergman@redhat.com>
|
||||
Walter Harms <wharms@bfs.de>
|
||||
Zack Weinberg <zackw@panix.com>
|
||||
丁贵强<dingguiqiang@foxmail.com>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
ioctl_userfaultfd.2
|
||||
Michael Kerrisk, Mike Rapoport
|
||||
New page describing ioctl(2) operations for userfaultfd
|
||||
|
||||
statx.2
|
||||
David Howells, Michael Kerrisk [Andreas Dilger]
|
||||
New page describing statx(2) system call added in Linux 4.11
|
||||
|
||||
userfaultfd.2
|
||||
Mike Rapoport, Michael Kerrisk [Andrea Arcangeli]
|
||||
New page describing userfaultfd(2) system call.
|
||||
|
||||
pthread_atfork.3
|
||||
Michael Kerrisk
|
||||
New page describing pthread_atfork(3)
|
||||
|
||||
slabinfo.5
|
||||
Michael Kerrisk
|
||||
Rewrite to try to bring the content close to current reality
|
||||
There's still gaps to fill in, but the existing page
|
||||
was in any case hugely out of date.
|
||||
|
||||
inode.7
|
||||
Michael Kerrisk
|
||||
New page with information about inodes
|
||||
David Howells provided a statx(2) page that duplicated much of
|
||||
the information from form stat(2). Avoid such duplication
|
||||
by moving the common information in stat(2) and statx(2)
|
||||
to a new page.
|
||||
|
||||
|
||||
Renamed pages
|
||||
--------------
|
||||
|
||||
ioctl_console.2
|
||||
Michael Kerrisk
|
||||
Renamed from console_ioctl.4
|
||||
Most ioctl() man pages are in section 2, so move this one there
|
||||
for consistency.
|
||||
Michael Kerrisk
|
||||
Note type of 'argp' for a various operations
|
||||
For some commands, there was no clear statement about the type
|
||||
of the 'argp' argument.
|
||||
|
||||
ioctl_tty.2
|
||||
Michael Kerrisk
|
||||
Renamed from tty_ioctl(4)
|
||||
All other ioctl(2) pages are in section 2. Make this
|
||||
page consistent.
|
||||
Michael Kerrisk
|
||||
Packet mode state change events give POLLPRI events for poll(2)
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
ioctl_ns.2
|
||||
Michael Kerrisk
|
||||
Document the NS_GET_NSTYPE operation added in Linux 4.11
|
||||
Michael Kerrisk
|
||||
Document the NS_GET_OWNER_UID operation added in Linux 4.11
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/sched_child_runs_first
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
console_ioctl.4
|
||||
Michael Kerrisk
|
||||
Link for old name of ioctl_console(2) page
|
||||
|
||||
tty_ioctl.4
|
||||
Michael Kerrisk
|
||||
Link for old name of ioctl_tty(2) page
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
Various pages
|
||||
Michael Kerrisk
|
||||
Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
|
||||
Michael Kerrisk
|
||||
Change page cross-references for console_ioctl(4) to ioctl_console(2)
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
alarm.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add timer_create(2) and timerfd_create(2)
|
||||
|
||||
chmod.2
|
||||
fsync.2
|
||||
mkdir.2
|
||||
mknod.2
|
||||
open.2
|
||||
truncate.2
|
||||
umask.2
|
||||
utime.2
|
||||
utimensat.2
|
||||
Michael Kerrisk
|
||||
Add/replace references to inode(7)
|
||||
|
||||
clone.2
|
||||
Michael Kerrisk
|
||||
CLONE_NEWCGROUP by an unprivileged process also causes an EPERM error
|
||||
|
||||
clone.2
|
||||
unshare.2
|
||||
Michael Kerrisk
|
||||
Exceeding one of the limits in /proc/sys/user/* can cause ENOSPC
|
||||
Michael Kerrisk
|
||||
CLONE_NEWPID yields ENOSPC if nesting limit of PID namespaces is reached
|
||||
Michael Kerrisk
|
||||
Exceeding the maximum nested user namespace limit now gives ENOSPC
|
||||
Formerly, if the limit of 32 nested user namespaces was exceeded,
|
||||
the error EUSERS resulted. Starting with Linux 4.9, the error
|
||||
is ENOSPC.
|
||||
|
||||
epoll_ctl.2
|
||||
Michael Kerrisk
|
||||
Defer to poll(2) for an explanation of EPOLLIN
|
||||
Michael Kerrisk [Nicolas Biscos]
|
||||
EPOLLERR is also set on write end of a pipe when the read end is closed
|
||||
Michael Kerrisk [Nicolas Biscos]
|
||||
Give the reader a clue that the 'events' field can be zero
|
||||
'events' specified as zero still allows EPOLLHUP and
|
||||
EPOLLERR to be reported.
|
||||
|
||||
_exit.2
|
||||
Michael Kerrisk
|
||||
On exit, child processes may be inherited by a "subreaper"
|
||||
It is no longer necessarily true that orphaned processes
|
||||
are inherited by PID 1.
|
||||
Michael Kerrisk
|
||||
Only the least significant byte of exit status is passed to the parent
|
||||
|
||||
fcntl.2
|
||||
Michael Kerrisk
|
||||
Mention memfd_create() in the discussion of file seals
|
||||
Give the reader a clue about what kinds of objects can
|
||||
be employed with file seals.
|
||||
Michael Kerrisk
|
||||
File seals are not generally applicable to tmpfs(5) files
|
||||
As far as I can see, file seals can be applied only to
|
||||
memfd_create(2) file descriptors. This was checked by experiment
|
||||
and by reading mm/shmem.c::shmem_get_inode((), where one finds
|
||||
the following line that applies to all new shmem files:
|
||||
|
||||
info->seals = F_SEAL_SEAL;
|
||||
|
||||
Only in the code of the memfd_create() system call is this
|
||||
setting reversed (in mm/shmem.c::memfd_create):
|
||||
|
||||
if (flags & MFD_ALLOW_SEALING)
|
||||
info->seals &= ~F_SEAL_SEAL;
|
||||
|
||||
fork.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add pthread_atfork(3)
|
||||
|
||||
getdents.2
|
||||
open.2
|
||||
stat.2
|
||||
statx.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add inode(7)
|
||||
|
||||
getdtablesize.2
|
||||
attr.5
|
||||
Alexander Miller
|
||||
Move .so directive to first line
|
||||
Improves compatibility with the man and other dumb tools
|
||||
that process man page files.
|
||||
|
||||
getpid.2
|
||||
Michael Kerrisk
|
||||
Mention init(1) and "subreapers" in discussion of parent PID
|
||||
|
||||
ioctl_list.2
|
||||
Cyril Hrubis [Arnd Bergmann]
|
||||
BLKRASET/BLKRAGET take unsigned long
|
||||
|
||||
ioctl_ns.2
|
||||
Michael Kerrisk
|
||||
ERRORS: document ENOTTY
|
||||
|
||||
kexec_load.2
|
||||
sched_setaffinity.2
|
||||
bootparam.7
|
||||
Michael Kerrisk
|
||||
Documentation/kernel-parameters.txt is now in Documentation/admin-guide/
|
||||
|
||||
lseek.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add fallocate(2)
|
||||
Both of these pages discuss file holes.
|
||||
|
||||
mincore.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add fincore(1)
|
||||
|
||||
mmap.2
|
||||
Michael Kerrisk
|
||||
Remove ancient reference to flags that appear on some other systems
|
||||
MAP_AUTOGROW, MAP_AUTORESRV, MAP_COPY, and MAP_LOCAL may have
|
||||
appeared on some systems many years ago, but the discussion here
|
||||
mentions no details and the systems and flags probably ceased to
|
||||
be relevant long ago. So, remove this text.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add userfaultfd(2)
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Add statx() to list of "at" calls in rationale discussion
|
||||
|
||||
poll.2
|
||||
Michael Kerrisk
|
||||
Expand discussion of POLLPRI
|
||||
Michael Kerrisk [Nicolas Biscos]
|
||||
POLLERR is also set on write end of a pipe when the read end is closed
|
||||
|
||||
posix_fadvise.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add fincore(1)
|
||||
|
||||
prctl.2
|
||||
Mike Frysinger
|
||||
PR_SET_MM: Refine CONFIG_CHECKPOINT_RESTORE requirement
|
||||
The Linux 3.10 release dropped the c/r requirement and opened it
|
||||
up to all users.
|
||||
Mike Frysinger
|
||||
PR_SET_MM: Document new PR_SET_MM_MAP{,_SIZE} helpers
|
||||
Mike Frysinger
|
||||
PR_SET_MM: Document arg4/arg5 zero behavior
|
||||
The kernel will immediately reject calls where arg4/arg5 are not
|
||||
zero. See kernel/sys.c:prctl_set_mm().
|
||||
Michael Kerrisk
|
||||
Explain rationale for use of subreaper processes
|
||||
Michael Kerrisk
|
||||
Note semantics of child_subreaper setting on fork() and exec()
|
||||
Michael Kerrisk
|
||||
Improve description of PR_SET_CHILD_SUBREAPER
|
||||
|
||||
rename.2
|
||||
Michael Kerrisk [Georg Sauthoff]
|
||||
Note that there is no glibc wrapper for renameat2()
|
||||
|
||||
sched_setaffinity.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add get_nprocs(3)
|
||||
|
||||
select.2
|
||||
Michael Kerrisk [Matthew Wilcox, Carlos O'Donell]
|
||||
Linux select() is buggy wrt POSIX in its check for EBADF errors
|
||||
Michael Kerrisk
|
||||
Show correspondence between select() and poll() readiness notifications
|
||||
Michael Kerrisk
|
||||
Give a hint that sets must be reinitialized if using select() in a loop
|
||||
Michael Kerrisk
|
||||
Refer to POLLPRI in poll(2) for info on exceptional conditions
|
||||
Michael Kerrisk
|
||||
Move mislocated text describing the self-pipe text from BUGS to NOTES
|
||||
|
||||
sigaction.2
|
||||
Michael Kerrisk
|
||||
Show the prototype of an SA_SIGINFO signal handler
|
||||
|
||||
signalfd.2
|
||||
Michael Kerrisk
|
||||
SIGKILL and SIGSTOP are silently ignored in 'mask'
|
||||
|
||||
sigprocmask.2
|
||||
Dmitry V. Levin
|
||||
Do not specify an exact value of rt_sigprocmask's 4th argument
|
||||
As sizeof(kernel_sigset_t) is not the same for all architectures,
|
||||
it would be better not to mention any numbers as its value.
|
||||
Michael Kerrisk
|
||||
'set' and 'oldset' can both be NULL
|
||||
|
||||
sigwaitinfo.2
|
||||
Michael Kerrisk
|
||||
sigwaitinfo() can't be used to accept synchronous signals
|
||||
|
||||
socketcall.2
|
||||
Mike Frysinger
|
||||
Document call argument
|
||||
|
||||
stat.2
|
||||
Michael Kerrisk
|
||||
Remove information migrated to inode(7) page
|
||||
Michael Kerrisk
|
||||
Restructure field descriptions as a hanging list
|
||||
Michael Kerrisk
|
||||
Remove "Other systems" subsection
|
||||
These details about other systems were added in 1999,
|
||||
and were probably of limited use then, and even less today.
|
||||
However, they do clutter the page, so remove them.
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: add list entries for 'st_uid' and 'st_gid'
|
||||
Michael Kerrisk
|
||||
Add some subsection headings to ease readability
|
||||
David Howells
|
||||
ERRORS: correct description of ENOENT
|
||||
Michael Kerrisk
|
||||
Give 'struct stat' argument a more meaningful name ('statbuf')
|
||||
Marcin Ślusarz
|
||||
Tweak description of AT_EMPTY_PATH
|
||||
Currently it says when dirfd is AT_FDCWD it can be something
|
||||
other than directory, which doesn't make much sense. Just swap
|
||||
the order of sentences.
|
||||
Michael Kerrisk
|
||||
Add slightly expanded description oif 'st_ino' field
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: add a list entry for 'st_ino'
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: add a list entry for 'st_nlinks' field
|
||||
|
||||
syscalls.2
|
||||
Michael Kerrisk
|
||||
Add membarrier(2)
|
||||
Michael Kerrisk
|
||||
Fix kernel version for userfaultfd(2)
|
||||
Michael Kerrisk
|
||||
Linux 4.11 added statx()
|
||||
Michael Kerrisk
|
||||
Include deprecated getunwind(2) in list
|
||||
|
||||
wait.2
|
||||
Michael Kerrisk
|
||||
Orphaned children may be adopted by a "subreaper", rather by than PD 1
|
||||
|
||||
bzero.3
|
||||
Michael Kerrisk [Zack Weinberg]
|
||||
Add correct header file for exlicit_bzero()
|
||||
|
||||
cfree.3
|
||||
Michael Kerrisk
|
||||
cfree() is removed from glibc in version 2.26
|
||||
|
||||
exit.3
|
||||
Michael Kerrisk
|
||||
Improve discussion of zombie processes
|
||||
|
||||
getentropy.3
|
||||
Nikos Mavrogiannopoulos [Michael Kerrisk, Florian Weimer]
|
||||
Correct header file
|
||||
Michael Kerrisk [Frank Theile]
|
||||
SYNOPSIS: add missing return type for getentropy() declaration
|
||||
|
||||
grantpt.3
|
||||
Michael Kerrisk
|
||||
Tell a more nuanced story about what grantpt() does or does not do
|
||||
|
||||
insque.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add queue(3)
|
||||
|
||||
queue.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add insque(3)
|
||||
|
||||
shm_open.3
|
||||
Michael Kerrisk
|
||||
Clarify that POSIX shared memory uses tmpfs(5)
|
||||
|
||||
syslog.3
|
||||
Michael Kerrisk [Ian Abbott, Walter Harms]
|
||||
Reorganize page text for easier parsing and better readability
|
||||
Michael Kerrisk
|
||||
Various rewordings and improvements
|
||||
Michael Kerrisk
|
||||
Note default value for 'facility' when calling openlog()
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add journalctl(1)
|
||||
|
||||
ttyname.3
|
||||
Dmitry V. Levin
|
||||
Document ENODEV error code
|
||||
Christian Brauner
|
||||
NOTES: warn about a confusing case that may occur with mount namespaces
|
||||
|
||||
|
||||
wcsdup.3
|
||||
Jan Heberer
|
||||
RETURN VALUE: fix error in return value description
|
||||
Return value for failure was accidentally changed from NULL to
|
||||
-1 in man-pages commit 572acb41c48b6b8e690d50edff367d8b8b01702a.
|
||||
|
||||
elf.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1)
|
||||
|
||||
nsswitch.conf.5
|
||||
Florian Weimer
|
||||
Mention sudoers
|
||||
It turns out that sudo drops things into nsswitch.conf, too.
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Refer to namespaces(7) for discussion of /proc/sys/user/* files
|
||||
Michael Kerrisk
|
||||
Simplify /proc/slabinfo entry
|
||||
Don't repeat (out-of-date) info from slabinfo(5); just defer to
|
||||
that page.
|
||||
|
||||
tmpfs.5
|
||||
Michael Kerrisk
|
||||
tmpfs supports extended attributes, but not 'user' extended attributes
|
||||
|
||||
environ.7
|
||||
Jakub Wilk
|
||||
Fix name of function that honors TMPDIR
|
||||
tempnam() takes the TMPDIR environment variable into account, unlike
|
||||
tmpnam(), which always creates pathnames within /tmp.
|
||||
|
||||
hostname.7
|
||||
Marko Myllynen
|
||||
Use lower case for hostname example
|
||||
Marko Myllynen
|
||||
Use generic names in examples
|
||||
Marko Myllynen
|
||||
Describe accepted characters for hostname
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk [Nicolas Iooss]
|
||||
Mounting a filesystem on top of a monitored directory causes no event
|
||||
|
||||
man-pages.7
|
||||
Michael Kerrisk
|
||||
Note preferred approach for 'duplicate' errors
|
||||
|
||||
namespaces.7
|
||||
Michael Kerrisk
|
||||
Document the /proc/sys/user/* files added in Linux 4.9
|
||||
|
||||
pid_namespaces.7
|
||||
Michael Kerrisk
|
||||
The maximum nesting depth for PID namespaces is 32
|
||||
|
||||
user_namespaces.7: Fixes to example
|
||||
Stephan Bergmann
|
||||
While toying around with the userns_child_exec example program on the
|
||||
user_namespaces(7) man page, I noticed two things:
|
||||
|
||||
* In the EXAMPLE section, we need to mount the new /proc before
|
||||
looking at /proc/$$/status, otherwise the latter will print
|
||||
information about the outer namespace's PID 1 (i.e., the real
|
||||
init). So the two paragraphs need to be swapped.
|
||||
|
||||
* In the program source, make sure to close pipe_fd[0] in the
|
||||
child before exec'ing.
|
||||
|
||||
pthreads.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add pthread_rwlockattr_setkind_np(3)
|
||||
|
||||
pty.7
|
||||
Michael Kerrisk
|
||||
Mention a couple of other applications of pseudoterminals
|
||||
|
||||
sem_overview.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add shm_overview(7)
|
||||
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add sigreturn(2)
|
||||
|
||||
socket.7
|
||||
Michael Kerrisk
|
||||
Enhance the description of SO_INCOMING_CPU
|
||||
Francois Saint-Jacques
|
||||
Document SO_INCOMING_CPU
|
||||
|
||||
tcp.7
|
||||
Michael Kerrisk
|
||||
Note indications for OOB data given by select(2) and poll(2)
|
||||
Chema Gonzalez
|
||||
tcp_abc was removed in 3.9
|
||||
|
||||
xattr.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ioctl_iflags(2)
|
||||
People sometimes confuse xattrs and inode flags. Provide a link
|
||||
to the page that describes inode flags to give them a tip.
|
||||
|
||||
ld.so.8
|
||||
Michael Kerrisk
|
||||
Mention quoting when using "Rpath tokens" in LD_AUDIT and LD_PRELOAD
|
||||
Michael Kerrisk
|
||||
Expand description of /etc/ld.so.preload
|
||||
Michael Kerrisk
|
||||
Mention ldconfig(8) in discussion of /etc/ld.so.cache
|
||||
|
||||
zdump.8
|
||||
Jakub Wilk
|
||||
Add OPTIONS section heading
|
||||
|
|
Loading…
Reference in New Issue