mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-4.11: updating Changes and Changes.old
This commit is contained in:
parent
cc7e159e94
commit
aa322fd8b3
885
Changes
885
Changes
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-4.10 ====================
|
||||
==================== Changes in man-pages-4.11 ====================
|
||||
|
||||
Released: 2017-03-13, Paris
|
||||
Released: ????-??-??, Munich
|
||||
|
||||
|
||||
Contributors
|
||||
|
@ -10,49 +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:
|
||||
|
||||
Adam Martindale <adam.john.martindale@gmail.com>
|
||||
Alex <psybin@riseup.net>
|
||||
Anders Thulin <anders@thulin.name>
|
||||
Andreas Gruenbacher <agruenba@redhat.com>
|
||||
Brian Masney <masneyb@onstation.org>
|
||||
Casey Schaufler <casey@schaufler-ca.com>
|
||||
David Howells <dhowells@redhat.com>
|
||||
Erik Kline <ekline@gmail.com>
|
||||
Erik Roland van der Meer <ervdmeer@gmail.com>
|
||||
Eugene Syromyatnikov <evgsyr@gmail.com>
|
||||
Fabjan Sukalia <fsukalia@gmail.com>
|
||||
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
||||
Helmut Eller <eller.helmut@gmail.com>
|
||||
Hugo Guiroux <hugo.guiroux@gmail.com>
|
||||
Ian Jackson <ijackson@chiark.greenend.org.uk>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jann Horn <jannh@google.com>
|
||||
Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
|
||||
John Wiersba <jrw32982@yahoo.com>
|
||||
Jon Jensen <jon@endpoint.com>
|
||||
Kai NODA <nodakai@gmail.com>
|
||||
KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
|
||||
Keno Fischer <keno@juliacomputing.com>
|
||||
Kent Fredic <kentfredric@gmail.com>
|
||||
Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
|
||||
Maik Zumstrull <maik@zumstrull.net>
|
||||
Mat Martineau <mathew.j.martineau@linux.intel.com>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Mike Frysinger <vapier@chromium.org>
|
||||
Nadav Har'El <nyh@math.technion.ac.il>
|
||||
Namhyung Kim <namhyung@gmail.com>
|
||||
Nicolas Biscos <nicolas.biscos+man7@gmail.com>
|
||||
Omar Sandoval <osandov@osandov.com>
|
||||
Paul Fee <paul.f.fee@gmail.com>
|
||||
Reverend Homer <mk.43.ecko@gmail.com>
|
||||
Rob Landley <rob@landley.net>
|
||||
Sergey Polovko <sergey@polovko.me>
|
||||
Steven Luo <steven@steven676.net>
|
||||
Tadeusz Struk <tadeusz.struk@intel.com>
|
||||
Vincent Bernat <vincent@bernat.im>
|
||||
Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
|
||||
Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
|
||||
Willy Tarreau <w@1wt.eu>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
@ -60,851 +17,19 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
add_key.2
|
||||
Michael Kerrisk [Eugene Syromyatnikov, David Howells]
|
||||
Major improvements and additions
|
||||
The page has doubled in length.
|
||||
|
||||
ioctl_iflags.2
|
||||
Michael Kerrisk
|
||||
New page describing inode flags and ioctl() operations
|
||||
|
||||
ioctl_ns.2
|
||||
Michael Kerrisk
|
||||
New page created by splitting ioctl(2) operations out of namespaces(7)
|
||||
|
||||
keyctl.2
|
||||
Michael Kerrisk, Eugene Syromyatnikov [David Howells, Mat Martineau]
|
||||
A vast number of additions and improvements
|
||||
The page has gone from somewhat over 100 lines to well over
|
||||
1000 lines and now more or less documents the complete interface
|
||||
provided by this system call.
|
||||
|
||||
getentropy.3
|
||||
Michael Kerrisk
|
||||
New page documenting getentropy(3)
|
||||
getentropy(3) is added to glibc in version 2.25.
|
||||
|
||||
keyrings.7
|
||||
David Howells
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk [Eugene Syromyatnikov, David Howells]
|
||||
Very many additions and improvements
|
||||
Michael Kerrisk
|
||||
Document /proc/keys
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/keys/persistent_keyring_expiry
|
||||
Michael Kerrisk
|
||||
Document /proc/key-users
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/keys/gc_delay
|
||||
Michael Kerrisk
|
||||
Document /proc files that define key quotas
|
||||
|
||||
persistent-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various clean-ups and additions
|
||||
|
||||
process-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various additions and improvements
|
||||
|
||||
request_key.2
|
||||
Michael Kerrisk, Eugene Syromyatnikov [David Howells]
|
||||
Very many additions and improvements
|
||||
The page is now three times its former length.
|
||||
|
||||
session-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various reworking and additions
|
||||
|
||||
signal-safety.7
|
||||
Michael Kerrisk
|
||||
New page created by migrating the signal-safety discussion from
|
||||
signal(7). Along the way some more details got added.
|
||||
Michael Kerrisk [KASAKI Motohiro]
|
||||
Note async-signal-safety problems caused by pthread_atfork()
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=25292
|
||||
Michael Kerrisk [KASAKI Motohiro]
|
||||
Note glibc deviations from POSIX requirements
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=25292
|
||||
|
||||
thread-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various rewordings and additions
|
||||
|
||||
user-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various reworking and improvements
|
||||
|
||||
user-session-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various rewordings and additions
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
bzero.3
|
||||
Michael Kerrisk
|
||||
Document explicit_bzero() (new in glibc 2.25)
|
||||
Also, reword the description of bzero somewhat.
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/vm/user_reserve_kbytes
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/vm/admin_reserve_kbytes
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/fs/mount-max
|
||||
Michael Kerrisk
|
||||
Document /proc/PID/status 'NoNewPrivs' field
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
explicit_bzero.3
|
||||
Michael Kerrisk
|
||||
New link to bzero.3
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
chmod.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM error for immutable/append-only file
|
||||
|
||||
chown.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM error for immutable/append-only file
|
||||
|
||||
chroot.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add switch_root(8)
|
||||
|
||||
clock_getres.2
|
||||
Michael Kerrisk
|
||||
Note POSIX.1 requirements re relative time services and CLOCK_REALTIME
|
||||
|
||||
clone.2
|
||||
Michael Kerrisk
|
||||
clone() does not execute fork handlers
|
||||
|
||||
execve.2
|
||||
Michael Kerrisk
|
||||
Rework text describing when effective IDs aren't transformed by execve()
|
||||
Michael Kerrisk
|
||||
File capabilities can be ignored for the same reasons as set-UID/set-GID
|
||||
Michael Kerrisk
|
||||
The 'no_new_privs' bit inhibits transformations of the effective IDs
|
||||
|
||||
fork.2
|
||||
Michael Kerrisk
|
||||
cgroup PIDs controller may also be trigger for EAGAIN error
|
||||
|
||||
fsync.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add posix_fadvise(2)
|
||||
|
||||
getrandom.2
|
||||
Michael Kerrisk
|
||||
Remove getentropy(3) details and defer to new getentropy(3) page
|
||||
Michael Kerrisk
|
||||
Starting with glibc 2.25, getrandom() is now declared in <sys/random.h>
|
||||
Michael Kerrisk
|
||||
glibc support was added in version 2.25
|
||||
|
||||
getrlimit.2
|
||||
Michael Kerrisk
|
||||
Document role of RLIMIT_NOFILE for FD passing over UNIX sockets
|
||||
|
||||
getxattr.2
|
||||
listxattr.2
|
||||
Andreas Gruenbacher
|
||||
Document E2BIG errors
|
||||
|
||||
inotify_add_watch.2
|
||||
Michael Kerrisk
|
||||
Note "inode" as a synonym for "filesystem object"
|
||||
Consistent with clarifications just made in inotify(7).
|
||||
|
||||
ioctl.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ioctl_ns(2), ioctl_iflags(2)
|
||||
|
||||
ioctl_fat.2
|
||||
Brian Masney
|
||||
Correctly reference volume ID instead of volume label
|
||||
|
||||
kcmp.2
|
||||
Michael Kerrisk
|
||||
Mention the clone(2) flags relating to various kcmp() 'type' values
|
||||
Michael Kerrisk
|
||||
KCMP_FILE: note reasons why FDs may refer to same open file description
|
||||
|
||||
link.2
|
||||
Michael Kerrisk
|
||||
When using linkat() AT_EMPTY_PATH, 'olddirfd' must not be a directory
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM for immutable/append-only files
|
||||
Michael Kerrisk
|
||||
Note limits where EMLINK is encountered on ext4 and Btrfs
|
||||
|
||||
listxattr.2
|
||||
Michael Kerrisk
|
||||
Eliminate extra E2BIG error text
|
||||
Andreas' patch added a second description of E2BIG that
|
||||
was (mostly) more detailed than the existing text. Combine
|
||||
the two texts.
|
||||
|
||||
lseek.2
|
||||
Michael Kerrisk
|
||||
O_APPEND overrides the effect of lseek() when doing file writes
|
||||
Michael Kerrisk
|
||||
Remove ancient info about whence values and return values on old systems
|
||||
Michael Kerrisk
|
||||
Remove slightly bogus advice about race conditions
|
||||
The page already (by now) contains a reference to open(2)
|
||||
for a discussion of open file descriptions. Leave it at that,
|
||||
since the reader can then deduce how things work.
|
||||
|
||||
madvise.2
|
||||
Michael Kerrisk
|
||||
Note that madvise() is generally about improving performance
|
||||
|
||||
mbind.2
|
||||
Krzysztof Kulakowski [Michael Kerrisk]
|
||||
Update MPOL_BIND description
|
||||
Behavior of MPOL_BIND Linux 2.6.26.
|
||||
|
||||
mincore.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add madvise(2), posix_fadvise(2), posix_madvise(3)
|
||||
|
||||
mlock.2
|
||||
Michael Kerrisk
|
||||
Note pre-4.9 bug in RLIMIT_MEMLOCK accounting for overlapping locks
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add mincore(2)
|
||||
|
||||
mmap.2
|
||||
Michael Kerrisk
|
||||
mincore(2) can be used to discover which pages of a mapping are resident
|
||||
|
||||
mount.2
|
||||
Michael Kerrisk [Rob Landley]
|
||||
Refer to mount_namespaces(7) for details of default propagation type
|
||||
|
||||
nanosleep.2
|
||||
Michael Kerrisk
|
||||
Describe "creeping sleep" problem
|
||||
nanosleep() has a problem if used in a program that catches
|
||||
signals and those signals are delivered at a very high rate.
|
||||
Describe the problem, and note that clock_nanosleep(2)
|
||||
provides a solution.
|
||||
Michael Kerrisk
|
||||
BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Make it clear that O_APPEND implies atomicity
|
||||
Michael Kerrisk
|
||||
Clarify distinction between file creation flags and file status flags
|
||||
Michael Kerrisk
|
||||
Note ambiguity of ELOOP error when using O_NOFOLLOW
|
||||
Michael Kerrisk
|
||||
Restructure O_NOFOLLOW text for easier parsing
|
||||
Michael Kerrisk
|
||||
Clarify that O_NOFOLLOW is now in POSIX
|
||||
|
||||
poll.2
|
||||
select.2
|
||||
Nicolas Biscos
|
||||
Add a reference to the sigset discussion in sigprocmask(2)
|
||||
A little while back, I added a note to sigprocmask.2 that
|
||||
discussed the difference between the libc's and the kernel's
|
||||
sigset_t structures. I added that note, because I saw this being
|
||||
done wrong in a tool tracing system calls (causing subtle bugs).
|
||||
As it turns out, the same bugs existed for ppoll and pselect, for
|
||||
the same reason. I'm hoping by adding the reference here, future
|
||||
writers of similar tools will find that discussion and not make
|
||||
the same mistake.
|
||||
|
||||
posix_fadvise.2
|
||||
Michael Kerrisk
|
||||
Mention /proc/sys/vm/drop_caches
|
||||
It may be helpful for the reader of this page to know about
|
||||
/proc/sys/vm/drop_caches.
|
||||
Michael Kerrisk
|
||||
Reorganize some text
|
||||
Details for various flags were hidden under NOTES.
|
||||
Move them to DESCRIPTION, to make the details more
|
||||
obvious.
|
||||
Michael Kerrisk
|
||||
One can use open(2) + mmap(2) + mincore(2) as a 'fincore'
|
||||
Note that open(2) + mmap(2) + mincore(2) to get a view of which
|
||||
pages of a file are currently cached.
|
||||
Michael Kerrisk [Maik Zumstrull]
|
||||
Note that POSIX_FADV_DONTNEED *may* try to write back dirty pages
|
||||
Michael Kerrisk
|
||||
SEE ALSO: mincore(2)
|
||||
|
||||
prctl.2
|
||||
Michael Kerrisk
|
||||
Clarify that the ambient capability set is per-thread
|
||||
Keno Fischer
|
||||
Be more precise in what causes dumpable to reset
|
||||
Michael Kerrisk
|
||||
The no_new_privs setting is per-thread (not per-process)
|
||||
Michael Kerrisk
|
||||
Mention /proc/PID/status 'NoNewPrivs' field
|
||||
Michael Kerrisk
|
||||
Add reference to seccomp(2) in discussion of PR_SET_NO_NEW_PRIVS
|
||||
|
||||
ptrace.2
|
||||
Omar Sandoval
|
||||
Clarify description of PTRACE_O_EXITKILL
|
||||
|
||||
read.2
|
||||
Michael Kerrisk [Kai NODA]
|
||||
Rework text in DESCRIPTION that talks about limits for 'count'
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=86061
|
||||
Michael Kerrisk [Steven Luo]
|
||||
Remove crufty text about EINTR and partial read
|
||||
Remove bogus text saying that POSIX permits partial read
|
||||
to return -1/EINTR on interrupt by a signal handler.
|
||||
That statement already ceased to be true in SUSv1 (1995)!
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=193111
|
||||
|
||||
readv.2
|
||||
Michael Kerrisk
|
||||
Remove generic advice about mixing stdio and syscalls on same file
|
||||
There is nothing specific to readv()/writev() about this advice.
|
||||
|
||||
recv.2
|
||||
Michael Kerrisk [Vincent Bernat]
|
||||
Remove duplicate paragraph
|
||||
man-pages-1.34 included changes that duplicated an existing
|
||||
paragraph. Remove that duplicate.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip(7), ipv6(7), tcp(7), udp(7), unix(7)
|
||||
|
||||
remap_file_pages.2
|
||||
Michael Kerrisk
|
||||
remap_file_pages() has been replaced by a slower in-kernel emulation
|
||||
|
||||
send.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ipv6(7), socket(7), unix(7)
|
||||
|
||||
setxattr.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM for immutable/append-only files
|
||||
|
||||
signalfd.2
|
||||
Michael Kerrisk
|
||||
signalfd() doesn't play well with helper programs spawned by libraries
|
||||
See https://lwn.net/Articles/415684/.
|
||||
Michael Kerrisk
|
||||
signalfd can't be used to receive synchronously generated signals
|
||||
Signals such as the SIGSEGV that results from an invalid
|
||||
memory access can be caught only with a handler.
|
||||
|
||||
stat.2
|
||||
Michael Kerrisk
|
||||
EXAMPLE: extend program to also show ID of the containing device
|
||||
Michael Kerrisk
|
||||
NOTES: mention fstatat() AT_NO_AUTOMOUNT in discussion of automounting
|
||||
|
||||
statfs.2
|
||||
Namhyung Kim
|
||||
Add more filesystem types
|
||||
Add missing magic numbers from /usr/include/linux/magic.h
|
||||
|
||||
syscall.2
|
||||
Mike Frysinger
|
||||
Add endian details with 64-bit splitting
|
||||
Architectures that split 64-bit values across register pairs
|
||||
usually do so according to their C ABI calling convention (which
|
||||
means endianness). Add some notes to that effect, and change the
|
||||
readahead example to show a little endian example (since that is
|
||||
way more common than big endian).
|
||||
|
||||
Also start a new list of syscalls that this issue does not apply
|
||||
to.
|
||||
Mike Frysinger
|
||||
Note parisc handling of aligned register pairs
|
||||
While parisc would normally have the same behavior as ARM/PowerPC,
|
||||
they decide to write shim syscall stubs to unpack/realign rather
|
||||
than expose the padding to userspace.
|
||||
|
||||
tkill.2
|
||||
Jann Horn
|
||||
Document EAGAIN error for real-time signals
|
||||
|
||||
truncate.2
|
||||
Michael Kerrisk
|
||||
Note use of ftruncate() for POSIX shared memory objects
|
||||
|
||||
unlink.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM error for immutable/read-only files
|
||||
|
||||
vfork.2
|
||||
Michael Kerrisk
|
||||
Explain why the child should not call exit(3)
|
||||
Michael Kerrisk
|
||||
Another reason to use vfork() is to avoid overcommitting memory
|
||||
Michael Kerrisk
|
||||
Note some caveats re the use of vfork()
|
||||
Inspired by Rich Felker's post at http://ewontfix.com/7/.
|
||||
See also https://sourceware.org/bugzilla/show_bug.cgi?id=14749 and
|
||||
See also https://sourceware.org/bugzilla/show_bug.cgi?id=14750.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add _exit(2)
|
||||
|
||||
write.2
|
||||
Michael Kerrisk [Kai NODA]
|
||||
Alert the reader that there is a limit on 'count'
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=86061
|
||||
|
||||
aio_suspend.3
|
||||
Michael Kerrisk
|
||||
Note that the glibc implementation is not async-signal-safe
|
||||
See https://sourceware.org/bugzilla/show_bug.cgi?id=13172
|
||||
|
||||
backtrace.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add addr2line(1) and gdb(1)
|
||||
|
||||
bcmp.3
|
||||
bcopy.3
|
||||
bzero.3
|
||||
memccpy.3
|
||||
memchr.3
|
||||
memcmp.3
|
||||
memcpy.3
|
||||
memfrob.3
|
||||
memmem.3
|
||||
memmove.3
|
||||
memset.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add bstring(3)
|
||||
|
||||
exec.3
|
||||
Michael Kerrisk
|
||||
execl() and execle() were not async-signal-safe before glibc 2.24
|
||||
|
||||
fopen.3
|
||||
Michael Kerrisk [Helmut Eller]
|
||||
Describe freopen() behavior for NULL pathname argument
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=191261
|
||||
Michael Kerrisk
|
||||
Note the open(2) flags that correspond to the 'mode' argument
|
||||
Michael Kerrisk
|
||||
Change argument name: 'path' to 'pathname'
|
||||
For consistency with open(2).
|
||||
Michael Kerrisk
|
||||
Add subsection headings for each function
|
||||
|
||||
fts.3
|
||||
Michael Kerrisk
|
||||
Use better argument name for fts_children() and fts_set()
|
||||
Michael Kerrisk
|
||||
Fix minor error in FTSENT structure definition
|
||||
Michael Kerrisk
|
||||
Improve explanation of 'fts_errno'
|
||||
Michael Kerrisk
|
||||
Give a hint that there are further fields in the FTSENT structure
|
||||
Michael Kerrisk
|
||||
Clarify meaning of zero as 'instr' value for fts_set()
|
||||
|
||||
ftw.3
|
||||
Michael Kerrisk
|
||||
Correctly handle use of stat info for FTW_NS in example program
|
||||
Michael Kerrisk
|
||||
Clarify that stat buffer is undefined for FTW_NS
|
||||
|
||||
getline.3
|
||||
Michael Kerrisk
|
||||
EXAMPLE: better error handling
|
||||
Michael Kerrisk [Kent Fredic]
|
||||
EXAMPLE: handle null bytes in input
|
||||
Jann Horn
|
||||
Document ENOMEM error case
|
||||
see the error handling in libio/iogetdelim.c
|
||||
Michael Kerrisk
|
||||
EXAMPLE: specify file to be opened as command-line argument
|
||||
Michael Kerrisk
|
||||
Use better variable name in example program
|
||||
|
||||
getmntent.3
|
||||
Michael Kerrisk [Anders Thulin]
|
||||
Prefer '\\' as the escape to get a backslash
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=191611
|
||||
|
||||
getopt.3
|
||||
Michael Kerrisk
|
||||
Reword discussion of error handling and reporting
|
||||
The existing description was hard to understand. Break
|
||||
it into a bullet list that separates out the details
|
||||
in a manner that is easier to parse.
|
||||
Michael Kerrisk
|
||||
Correct details of use of <stdio.h> to get getopt() declaration
|
||||
Michael Kerrisk [John Wiersba]
|
||||
Remove some redundant text
|
||||
|
||||
mq_open.3
|
||||
Michael Kerrisk [Adam Martindale]
|
||||
Include definition of the 'mq_attr' structure in this man page
|
||||
Make the reader's life a little easier by saving them from
|
||||
having to refer to mq_getattr(3).
|
||||
|
||||
mq_send.3
|
||||
Michael Kerrisk [Adam Martindale]
|
||||
Refer to mq_overview(7) for details on range of message priority
|
||||
|
||||
__ppc_set_ppr_med.3
|
||||
Wainer dos Santos Moschetta
|
||||
Note need for _ARCH_PWR8 macro
|
||||
The _ARCH_PWR8 macro must be defined to get the
|
||||
__ppc_set_ppr_very_low() and __ppc_set_ppr_med_high()
|
||||
definitions.
|
||||
|
||||
printf.3
|
||||
Michael Kerrisk
|
||||
Document nonstandard 'Z' modifier
|
||||
Michael Kerrisk
|
||||
Document 'q' length modifier
|
||||
Michael Kerrisk [Erik Roland van der Meer]
|
||||
Fix a small bug in example code
|
||||
Move the second call to va_end(ap) to above the if-block that
|
||||
precedes it, so that the va_list 'ap' will be cleaned up in
|
||||
all cases.
|
||||
Michael Kerrisk [Nadav Har'El]
|
||||
As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=190341.
|
||||
Michael Kerrisk
|
||||
Add references to setlocale(3) in discussions of locales
|
||||
Michael Kerrisk
|
||||
SEE ALSO: remove bogus self reference (dprintf(3))
|
||||
|
||||
random.3
|
||||
Michael Kerrisk
|
||||
Relocate information of "optimal" value of initstate() 'n' argument
|
||||
The information was a bit hidden in NOTES.
|
||||
|
||||
random_r.3
|
||||
Michael Kerrisk [Jan Ziak]
|
||||
'buf.state' must be initialized to NULL before calling initstate_r()
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=192801.
|
||||
Michael Kerrisk
|
||||
Add some usage notes for setstate_r()
|
||||
Michael Kerrisk
|
||||
Note that 'buf' records a pointer to 'statebuf'
|
||||
See https://sourceware.org/bugzilla/show_bug.cgi?id=3662.
|
||||
Michael Kerrisk
|
||||
Add BUGS section pointing out the weirdness of the initstate_r() API
|
||||
|
||||
resolver.3
|
||||
Michael Kerrisk
|
||||
RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated
|
||||
These options were never implemented; since glibc 2.25, they
|
||||
are deprecated.
|
||||
Michael Kerrisk
|
||||
The RES_NOIP6DOTINT is removed in glibc 2.25
|
||||
Michael Kerrisk
|
||||
Note that RES_BLAST was unimplemented and is now deprecated
|
||||
Michael Kerrisk
|
||||
RES_USE_INET6 is deprecated since glibc 2.25
|
||||
Michael Kerrisk
|
||||
RES_USEBSTRING was removed in glibc 2.25
|
||||
|
||||
resolver.3
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Note that RES_USEBSTRING defaults to off
|
||||
|
||||
scandir.3
|
||||
Michael Kerrisk [Ian Jackson]
|
||||
Fix errors in example program
|
||||
See http://bugs.debian.org/848231.
|
||||
Michael Kerrisk
|
||||
Improve logic of the example program
|
||||
|
||||
scanf.3
|
||||
Michael Kerrisk
|
||||
Document the quote (') modifier for decimal conversions
|
||||
|
||||
sem_post.3
|
||||
setjmp.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add signal-safety(7)
|
||||
|
||||
sem_wait.3
|
||||
Michael Kerrisk [Fabjan Sukalia]
|
||||
Remove statement that SA_RESTART does not cause restarting
|
||||
This has not been true since Linux 2.6.22. The description
|
||||
of EINTR maintains a reference to signal(7), which explains
|
||||
the historical details.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=192071
|
||||
|
||||
sleep.3
|
||||
Michael Kerrisk [Mike Frysiner]
|
||||
Note that sleep() is implemented via nanosleep(2)
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
|
||||
Michael Kerrisk [Mike Frysinger]
|
||||
Note that sleep() sleeps for a real-time number of seconds
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
|
||||
Michael Kerrisk
|
||||
Convert BUGS text to "Portability notes" subsection
|
||||
The existing text is not a bug, as such.
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: minor reworking
|
||||
|
||||
strerror.3
|
||||
Heinrich Schuchardt
|
||||
Indicate reasonable buffer size for strerror_r() and strerror_l()
|
||||
Add a hint which buffer size is needed for
|
||||
strerror_r() and strerror_l().
|
||||
|
||||
strverscmp.3
|
||||
Michael Kerrisk [Vivenzio Pagliari]
|
||||
Fix comparison error in example program
|
||||
|
||||
system.3
|
||||
Michael Kerrisk
|
||||
In the glibc implementation, fork handlers are not executed by system()
|
||||
|
||||
random.4
|
||||
Michael Kerrisk [Jon Jensen]
|
||||
Note that entropY-avail will be a number in the range 0..4096
|
||||
|
||||
core.5
|
||||
Michael Kerrisk
|
||||
Clarify that dumping program's initial CWD is root directory
|
||||
Michael Kerrisk
|
||||
The target of core dump piping can also be a script
|
||||
|
||||
filesystems.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add btrfs(5), nfs(5), tmpfs(5)
|
||||
|
||||
intro.5
|
||||
Michael Kerrisk
|
||||
Document the reality that by now Section 5 also covers filesystems
|
||||
There are by now, from various filesystem projects, various
|
||||
pages in Section 5 that document different filesystems.
|
||||
Change intro(5) to reflect that.
|
||||
|
||||
Documented after following: http://bugs.debian.org/847998
|
||||
|
||||
proc.5
|
||||
Mike Frysinger [Michael Kerrisk]
|
||||
Clarify /proc/pid/environ behavior
|
||||
/proc/pid/environ reflects process environment at
|
||||
*start* of program execution; it is set at time of execve(2)
|
||||
Michael Kerrisk
|
||||
Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field
|
||||
Michael Kerrisk
|
||||
Add entries for "keys" files that refer reader to keyrings(7)
|
||||
Michael Kerrisk
|
||||
Remove duplicate /proc/[pid]/seccomp entry
|
||||
Michael Kerrisk
|
||||
Mention other system calls that create 'anon_inode' file descriptors
|
||||
Mention a few other system calls that create file descriptors
|
||||
that display an 'anon_inode' symlink in /proc/PID/fd
|
||||
Michael Kerrisk
|
||||
Add some detail on overcommit_memory value 1
|
||||
Michael Kerrisk
|
||||
Add reference to vdso(7) in discussion of /proc/PID/maps
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
ip6-bytestring was removed in glibc 2.25
|
||||
Michael Kerrisk
|
||||
The ipc-dotint and no-ip6-dotint options were removed in glibc 2.25
|
||||
Michael Kerrisk
|
||||
The 'inet6' option is deprecated since glibc 2.25
|
||||
|
||||
slabinfo.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add slabtop(1)
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk [Casey Schaufler]
|
||||
Add subsection with notes to kernel developers
|
||||
Provide some notes to kernel developers considering how to choose
|
||||
which capability should govern a new kernel feature.
|
||||
Michael Kerrisk
|
||||
Further enhance the recommendation against new uses of CAP_SYS_ADMIN
|
||||
Michael Kerrisk
|
||||
Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers"
|
||||
Michael Kerrisk
|
||||
Add another case for CAP_DAC_READ_SEARCH
|
||||
Michael Kerrisk
|
||||
Refer to execve(2) for the reasons that file capabilities may be ignored
|
||||
Michael Kerrisk
|
||||
Document a new use of CAP_SYS_RESOURCE
|
||||
Michael Kerrisk
|
||||
Add some more operations governed by CAP_SYS_ADMIN
|
||||
Michael Kerrisk
|
||||
Adjust references to chattr(1) to point to ioctl_iflags(2)
|
||||
|
||||
environ.7
|
||||
Michael Kerrisk
|
||||
Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk
|
||||
Point out that inotify monitoring is inode based
|
||||
|
||||
ip.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip(8)
|
||||
|
||||
man.7
|
||||
uri.7
|
||||
Jakub Wilk
|
||||
Use "www.kernel.org" in example URLs
|
||||
Apparently www.kernelnotes.org is now a spam site.
|
||||
|
||||
mount_namespaces.7
|
||||
Michael Kerrisk [Rob Landley]
|
||||
Rework the discussion of defaults for mount propagation types
|
||||
Add rather more detail. In particular, note the cases where the
|
||||
default propagation type is MS_PRIVATE vs MS_SHARED.
|
||||
|
||||
namespaces.7
|
||||
Michael Kerrisk
|
||||
EXAMPLE: fix an error in shell session
|
||||
Michael Kerrisk
|
||||
EXAMPLE: rename the example program
|
||||
Use a more generic name, since this program may be expanded
|
||||
in various ways in the future.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip-netns(8)
|
||||
Michael Kerrisk
|
||||
Remove content split out into ioctl_ns(2)
|
||||
|
||||
netlink.7
|
||||
Michael Kerrisk
|
||||
NETLINK_IP6_FW went away in Linux 3.5
|
||||
Michael Kerrisk
|
||||
NETLINK_W1 went away in Linux 2.6.18
|
||||
Michael Kerrisk
|
||||
Add NETLINK_SCSITRANSPORT to list
|
||||
Michael Kerrisk
|
||||
Add NETLINK_RDMA to list
|
||||
Michael Kerrisk
|
||||
NETLINK_FIREWALL was removed in Linux 3.5
|
||||
Michael Kerrisk
|
||||
NETLINK_NFLOG was removed in Linux 3.17
|
||||
Jakub Wilk
|
||||
Update libnl homepage URL
|
||||
The original URL is 404.
|
||||
|
||||
pid_namespaces.7
|
||||
user_namespaces.7
|
||||
Michael Kerrisk
|
||||
Adjust references to namespaces(7) to ioctl_ns(2)
|
||||
|
||||
pid_namespaces.7
|
||||
Keno Fischer
|
||||
CLONE_SIGHAND|CLONE_VM|CLONE_NEWPID is no longer disallowed
|
||||
|
||||
pipe.7
|
||||
Michael Kerrisk
|
||||
Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity
|
||||
Michael Kerrisk
|
||||
Clarify that default pipe capacity is 16 pages
|
||||
The statement that the default pipe capacity is 65536 bytes
|
||||
is accurate only on systems where the page size is 4096B.
|
||||
See the use of PIPE_DEF_BUFFERS in the kernel source.
|
||||
|
||||
random.7
|
||||
Michael Kerrisk
|
||||
Mention getentropy(3)
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add getentropy(3)
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add getauxval(3)
|
||||
A small hint to the reader that some random bytes arrive
|
||||
in the auxiliary vector.
|
||||
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
SIGSYS: add reference to seccomp(2)
|
||||
Michael Kerrisk
|
||||
Change description of SIGSYS to "Bad system call"
|
||||
This is the more typical definition.
|
||||
Michael Kerrisk
|
||||
SIGPIPE: add reference to pipe(7)
|
||||
Michael Kerrisk
|
||||
SIGXFSZ: add reference to setrlimit(2)
|
||||
Michael Kerrisk
|
||||
Add a name for SIGEMT
|
||||
Michael Kerrisk
|
||||
SIGXCPU: add reference to setrlimit(2)
|
||||
Michael Kerrisk
|
||||
Migrated signal-safety discussion to new signal-safet(7) page
|
||||
|
||||
unix.7
|
||||
Michael Kerrisk [Sergey Polovko]
|
||||
Since Linux 3.4, UNIX domain sockets support MSG_TRUNC
|
||||
This was correctly noted in recv(2), but the unix(7) page
|
||||
was not correspondingly updated for the Linux 3.4 change.
|
||||
Michael Kerrisk [Willy Tarreau]
|
||||
Document ETOOMANYREFS for SCM_RIGHTS send exceeding RLIMIT_NOFILE limit
|
||||
|
||||
user_namespaces.7
|
||||
Michael Kerrisk
|
||||
Change page cross reference: keyctl(2) ==> keyrings(7)
|
||||
|
||||
ld.so.8
|
||||
Michael Kerrisk
|
||||
LD_BIND_NOT has effect only for function symbols
|
||||
Michael Kerrisk
|
||||
Describe use of LD_DEBUG with LD_BIND_NOT
|
||||
Michael Kerrisk
|
||||
In secure mode, LD_AUDIT restricts the libraries that it will load
|
||||
Michael Kerrisk
|
||||
LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
|
||||
|
||||
|
|
912
Changes.old
912
Changes.old
|
@ -43931,3 +43931,915 @@ user_namespaces.7
|
|||
Add reference to namespaces(7) for NS_GET_USERNS operation
|
||||
Michael Kerrisk
|
||||
Add reference to namespaces(7) for NS_GET_PARENT operation
|
||||
|
||||
|
||||
==================== Changes in man-pages-4.10 ====================
|
||||
|
||||
Released: 2017-03-13, Paris
|
||||
|
||||
|
||||
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:
|
||||
|
||||
Adam Martindale <adam.john.martindale@gmail.com>
|
||||
Alex <psybin@riseup.net>
|
||||
Anders Thulin <anders@thulin.name>
|
||||
Andreas Gruenbacher <agruenba@redhat.com>
|
||||
Brian Masney <masneyb@onstation.org>
|
||||
Casey Schaufler <casey@schaufler-ca.com>
|
||||
David Howells <dhowells@redhat.com>
|
||||
Erik Kline <ekline@gmail.com>
|
||||
Erik Roland van der Meer <ervdmeer@gmail.com>
|
||||
Eugene Syromyatnikov <evgsyr@gmail.com>
|
||||
Fabjan Sukalia <fsukalia@gmail.com>
|
||||
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
||||
Helmut Eller <eller.helmut@gmail.com>
|
||||
Hugo Guiroux <hugo.guiroux@gmail.com>
|
||||
Ian Jackson <ijackson@chiark.greenend.org.uk>
|
||||
Jakub Wilk <jwilk@jwilk.net>
|
||||
Jann Horn <jannh@google.com>
|
||||
Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
|
||||
John Wiersba <jrw32982@yahoo.com>
|
||||
Jon Jensen <jon@endpoint.com>
|
||||
Kai NODA <nodakai@gmail.com>
|
||||
KASAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
|
||||
Keno Fischer <keno@juliacomputing.com>
|
||||
Kent Fredic <kentfredric@gmail.com>
|
||||
Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
|
||||
Maik Zumstrull <maik@zumstrull.net>
|
||||
Mat Martineau <mathew.j.martineau@linux.intel.com>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Mike Frysinger <vapier@chromium.org>
|
||||
Nadav Har'El <nyh@math.technion.ac.il>
|
||||
Namhyung Kim <namhyung@gmail.com>
|
||||
Nicolas Biscos <nicolas.biscos+man7@gmail.com>
|
||||
Omar Sandoval <osandov@osandov.com>
|
||||
Paul Fee <paul.f.fee@gmail.com>
|
||||
Reverend Homer <mk.43.ecko@gmail.com>
|
||||
Rob Landley <rob@landley.net>
|
||||
Sergey Polovko <sergey@polovko.me>
|
||||
Steven Luo <steven@steven676.net>
|
||||
Tadeusz Struk <tadeusz.struk@intel.com>
|
||||
Vincent Bernat <vincent@bernat.im>
|
||||
Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
|
||||
Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
|
||||
Willy Tarreau <w@1wt.eu>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
||||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
add_key.2
|
||||
Michael Kerrisk [Eugene Syromyatnikov, David Howells]
|
||||
Major improvements and additions
|
||||
The page has doubled in length.
|
||||
|
||||
ioctl_iflags.2
|
||||
Michael Kerrisk
|
||||
New page describing inode flags and ioctl() operations
|
||||
|
||||
ioctl_ns.2
|
||||
Michael Kerrisk
|
||||
New page created by splitting ioctl(2) operations out of namespaces(7)
|
||||
|
||||
keyctl.2
|
||||
Michael Kerrisk, Eugene Syromyatnikov [David Howells, Mat Martineau]
|
||||
A vast number of additions and improvements
|
||||
The page has gone from somewhat over 100 lines to well over
|
||||
1000 lines and now more or less documents the complete interface
|
||||
provided by this system call.
|
||||
|
||||
getentropy.3
|
||||
Michael Kerrisk
|
||||
New page documenting getentropy(3)
|
||||
getentropy(3) is added to glibc in version 2.25.
|
||||
|
||||
keyrings.7
|
||||
David Howells
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk [Eugene Syromyatnikov, David Howells]
|
||||
Very many additions and improvements
|
||||
Michael Kerrisk
|
||||
Document /proc/keys
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/keys/persistent_keyring_expiry
|
||||
Michael Kerrisk
|
||||
Document /proc/key-users
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/kernel/keys/gc_delay
|
||||
Michael Kerrisk
|
||||
Document /proc files that define key quotas
|
||||
|
||||
persistent-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various clean-ups and additions
|
||||
|
||||
process-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various additions and improvements
|
||||
|
||||
request_key.2
|
||||
Michael Kerrisk, Eugene Syromyatnikov [David Howells]
|
||||
Very many additions and improvements
|
||||
The page is now three times its former length.
|
||||
|
||||
session-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various reworking and additions
|
||||
|
||||
signal-safety.7
|
||||
Michael Kerrisk
|
||||
New page created by migrating the signal-safety discussion from
|
||||
signal(7). Along the way some more details got added.
|
||||
Michael Kerrisk [KASAKI Motohiro]
|
||||
Note async-signal-safety problems caused by pthread_atfork()
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=25292
|
||||
Michael Kerrisk [KASAKI Motohiro]
|
||||
Note glibc deviations from POSIX requirements
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=25292
|
||||
|
||||
thread-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various rewordings and additions
|
||||
|
||||
user-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various reworking and improvements
|
||||
|
||||
user-session-keyring.7
|
||||
Michael Kerrisk
|
||||
New page (written by David Howells) adopted from keyutils
|
||||
Since this page documents kernel-user-space interfaces,
|
||||
it makes sense to have it as part of man-pages, rather
|
||||
than the keyutils package.
|
||||
Michael Kerrisk
|
||||
Various rewordings and additions
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
bzero.3
|
||||
Michael Kerrisk
|
||||
Document explicit_bzero() (new in glibc 2.25)
|
||||
Also, reword the description of bzero somewhat.
|
||||
|
||||
proc.5
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/vm/user_reserve_kbytes
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/vm/admin_reserve_kbytes
|
||||
Michael Kerrisk
|
||||
Document /proc/sys/fs/mount-max
|
||||
Michael Kerrisk
|
||||
Document /proc/PID/status 'NoNewPrivs' field
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
explicit_bzero.3
|
||||
Michael Kerrisk
|
||||
New link to bzero.3
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
chmod.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM error for immutable/append-only file
|
||||
|
||||
chown.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM error for immutable/append-only file
|
||||
|
||||
chroot.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add switch_root(8)
|
||||
|
||||
clock_getres.2
|
||||
Michael Kerrisk
|
||||
Note POSIX.1 requirements re relative time services and CLOCK_REALTIME
|
||||
|
||||
clone.2
|
||||
Michael Kerrisk
|
||||
clone() does not execute fork handlers
|
||||
|
||||
execve.2
|
||||
Michael Kerrisk
|
||||
Rework text describing when effective IDs aren't transformed by execve()
|
||||
Michael Kerrisk
|
||||
File capabilities can be ignored for the same reasons as set-UID/set-GID
|
||||
Michael Kerrisk
|
||||
The 'no_new_privs' bit inhibits transformations of the effective IDs
|
||||
|
||||
fork.2
|
||||
Michael Kerrisk
|
||||
cgroup PIDs controller may also be trigger for EAGAIN error
|
||||
|
||||
fsync.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add posix_fadvise(2)
|
||||
|
||||
getrandom.2
|
||||
Michael Kerrisk
|
||||
Remove getentropy(3) details and defer to new getentropy(3) page
|
||||
Michael Kerrisk
|
||||
Starting with glibc 2.25, getrandom() is now declared in <sys/random.h>
|
||||
Michael Kerrisk
|
||||
glibc support was added in version 2.25
|
||||
|
||||
getrlimit.2
|
||||
Michael Kerrisk
|
||||
Document role of RLIMIT_NOFILE for FD passing over UNIX sockets
|
||||
|
||||
getxattr.2
|
||||
listxattr.2
|
||||
Andreas Gruenbacher
|
||||
Document E2BIG errors
|
||||
|
||||
inotify_add_watch.2
|
||||
Michael Kerrisk
|
||||
Note "inode" as a synonym for "filesystem object"
|
||||
Consistent with clarifications just made in inotify(7).
|
||||
|
||||
ioctl.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ioctl_ns(2), ioctl_iflags(2)
|
||||
|
||||
ioctl_fat.2
|
||||
Brian Masney
|
||||
Correctly reference volume ID instead of volume label
|
||||
|
||||
kcmp.2
|
||||
Michael Kerrisk
|
||||
Mention the clone(2) flags relating to various kcmp() 'type' values
|
||||
Michael Kerrisk
|
||||
KCMP_FILE: note reasons why FDs may refer to same open file description
|
||||
|
||||
link.2
|
||||
Michael Kerrisk
|
||||
When using linkat() AT_EMPTY_PATH, 'olddirfd' must not be a directory
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM for immutable/append-only files
|
||||
Michael Kerrisk
|
||||
Note limits where EMLINK is encountered on ext4 and Btrfs
|
||||
|
||||
listxattr.2
|
||||
Michael Kerrisk
|
||||
Eliminate extra E2BIG error text
|
||||
Andreas' patch added a second description of E2BIG that
|
||||
was (mostly) more detailed than the existing text. Combine
|
||||
the two texts.
|
||||
|
||||
lseek.2
|
||||
Michael Kerrisk
|
||||
O_APPEND overrides the effect of lseek() when doing file writes
|
||||
Michael Kerrisk
|
||||
Remove ancient info about whence values and return values on old systems
|
||||
Michael Kerrisk
|
||||
Remove slightly bogus advice about race conditions
|
||||
The page already (by now) contains a reference to open(2)
|
||||
for a discussion of open file descriptions. Leave it at that,
|
||||
since the reader can then deduce how things work.
|
||||
|
||||
madvise.2
|
||||
Michael Kerrisk
|
||||
Note that madvise() is generally about improving performance
|
||||
|
||||
mbind.2
|
||||
Krzysztof Kulakowski [Michael Kerrisk]
|
||||
Update MPOL_BIND description
|
||||
Behavior of MPOL_BIND Linux 2.6.26.
|
||||
|
||||
mincore.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add madvise(2), posix_fadvise(2), posix_madvise(3)
|
||||
|
||||
mlock.2
|
||||
Michael Kerrisk
|
||||
Note pre-4.9 bug in RLIMIT_MEMLOCK accounting for overlapping locks
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add mincore(2)
|
||||
|
||||
mmap.2
|
||||
Michael Kerrisk
|
||||
mincore(2) can be used to discover which pages of a mapping are resident
|
||||
|
||||
mount.2
|
||||
Michael Kerrisk [Rob Landley]
|
||||
Refer to mount_namespaces(7) for details of default propagation type
|
||||
|
||||
nanosleep.2
|
||||
Michael Kerrisk
|
||||
Describe "creeping sleep" problem
|
||||
nanosleep() has a problem if used in a program that catches
|
||||
signals and those signals are delivered at a very high rate.
|
||||
Describe the problem, and note that clock_nanosleep(2)
|
||||
provides a solution.
|
||||
Michael Kerrisk
|
||||
BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6
|
||||
|
||||
open.2
|
||||
Michael Kerrisk
|
||||
Make it clear that O_APPEND implies atomicity
|
||||
Michael Kerrisk
|
||||
Clarify distinction between file creation flags and file status flags
|
||||
Michael Kerrisk
|
||||
Note ambiguity of ELOOP error when using O_NOFOLLOW
|
||||
Michael Kerrisk
|
||||
Restructure O_NOFOLLOW text for easier parsing
|
||||
Michael Kerrisk
|
||||
Clarify that O_NOFOLLOW is now in POSIX
|
||||
|
||||
poll.2
|
||||
select.2
|
||||
Nicolas Biscos
|
||||
Add a reference to the sigset discussion in sigprocmask(2)
|
||||
A little while back, I added a note to sigprocmask.2 that
|
||||
discussed the difference between the libc's and the kernel's
|
||||
sigset_t structures. I added that note, because I saw this being
|
||||
done wrong in a tool tracing system calls (causing subtle bugs).
|
||||
As it turns out, the same bugs existed for ppoll and pselect, for
|
||||
the same reason. I'm hoping by adding the reference here, future
|
||||
writers of similar tools will find that discussion and not make
|
||||
the same mistake.
|
||||
|
||||
posix_fadvise.2
|
||||
Michael Kerrisk
|
||||
Mention /proc/sys/vm/drop_caches
|
||||
It may be helpful for the reader of this page to know about
|
||||
/proc/sys/vm/drop_caches.
|
||||
Michael Kerrisk
|
||||
Reorganize some text
|
||||
Details for various flags were hidden under NOTES.
|
||||
Move them to DESCRIPTION, to make the details more
|
||||
obvious.
|
||||
Michael Kerrisk
|
||||
One can use open(2) + mmap(2) + mincore(2) as a 'fincore'
|
||||
Note that open(2) + mmap(2) + mincore(2) to get a view of which
|
||||
pages of a file are currently cached.
|
||||
Michael Kerrisk [Maik Zumstrull]
|
||||
Note that POSIX_FADV_DONTNEED *may* try to write back dirty pages
|
||||
Michael Kerrisk
|
||||
SEE ALSO: mincore(2)
|
||||
|
||||
prctl.2
|
||||
Michael Kerrisk
|
||||
Clarify that the ambient capability set is per-thread
|
||||
Keno Fischer
|
||||
Be more precise in what causes dumpable to reset
|
||||
Michael Kerrisk
|
||||
The no_new_privs setting is per-thread (not per-process)
|
||||
Michael Kerrisk
|
||||
Mention /proc/PID/status 'NoNewPrivs' field
|
||||
Michael Kerrisk
|
||||
Add reference to seccomp(2) in discussion of PR_SET_NO_NEW_PRIVS
|
||||
|
||||
ptrace.2
|
||||
Omar Sandoval
|
||||
Clarify description of PTRACE_O_EXITKILL
|
||||
|
||||
read.2
|
||||
Michael Kerrisk [Kai NODA]
|
||||
Rework text in DESCRIPTION that talks about limits for 'count'
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=86061
|
||||
Michael Kerrisk [Steven Luo]
|
||||
Remove crufty text about EINTR and partial read
|
||||
Remove bogus text saying that POSIX permits partial read
|
||||
to return -1/EINTR on interrupt by a signal handler.
|
||||
That statement already ceased to be true in SUSv1 (1995)!
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=193111
|
||||
|
||||
readv.2
|
||||
Michael Kerrisk
|
||||
Remove generic advice about mixing stdio and syscalls on same file
|
||||
There is nothing specific to readv()/writev() about this advice.
|
||||
|
||||
recv.2
|
||||
Michael Kerrisk [Vincent Bernat]
|
||||
Remove duplicate paragraph
|
||||
man-pages-1.34 included changes that duplicated an existing
|
||||
paragraph. Remove that duplicate.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip(7), ipv6(7), tcp(7), udp(7), unix(7)
|
||||
|
||||
remap_file_pages.2
|
||||
Michael Kerrisk
|
||||
remap_file_pages() has been replaced by a slower in-kernel emulation
|
||||
|
||||
send.2
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ipv6(7), socket(7), unix(7)
|
||||
|
||||
setxattr.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM for immutable/append-only files
|
||||
|
||||
signalfd.2
|
||||
Michael Kerrisk
|
||||
signalfd() doesn't play well with helper programs spawned by libraries
|
||||
See https://lwn.net/Articles/415684/.
|
||||
Michael Kerrisk
|
||||
signalfd can't be used to receive synchronously generated signals
|
||||
Signals such as the SIGSEGV that results from an invalid
|
||||
memory access can be caught only with a handler.
|
||||
|
||||
stat.2
|
||||
Michael Kerrisk
|
||||
EXAMPLE: extend program to also show ID of the containing device
|
||||
Michael Kerrisk
|
||||
NOTES: mention fstatat() AT_NO_AUTOMOUNT in discussion of automounting
|
||||
|
||||
statfs.2
|
||||
Namhyung Kim
|
||||
Add more filesystem types
|
||||
Add missing magic numbers from /usr/include/linux/magic.h
|
||||
|
||||
syscall.2
|
||||
Mike Frysinger
|
||||
Add endian details with 64-bit splitting
|
||||
Architectures that split 64-bit values across register pairs
|
||||
usually do so according to their C ABI calling convention (which
|
||||
means endianness). Add some notes to that effect, and change the
|
||||
readahead example to show a little endian example (since that is
|
||||
way more common than big endian).
|
||||
|
||||
Also start a new list of syscalls that this issue does not apply
|
||||
to.
|
||||
Mike Frysinger
|
||||
Note parisc handling of aligned register pairs
|
||||
While parisc would normally have the same behavior as ARM/PowerPC,
|
||||
they decide to write shim syscall stubs to unpack/realign rather
|
||||
than expose the padding to userspace.
|
||||
|
||||
tkill.2
|
||||
Jann Horn
|
||||
Document EAGAIN error for real-time signals
|
||||
|
||||
truncate.2
|
||||
Michael Kerrisk
|
||||
Note use of ftruncate() for POSIX shared memory objects
|
||||
|
||||
unlink.2
|
||||
Michael Kerrisk
|
||||
ERRORS: add EPERM error for immutable/read-only files
|
||||
|
||||
vfork.2
|
||||
Michael Kerrisk
|
||||
Explain why the child should not call exit(3)
|
||||
Michael Kerrisk
|
||||
Another reason to use vfork() is to avoid overcommitting memory
|
||||
Michael Kerrisk
|
||||
Note some caveats re the use of vfork()
|
||||
Inspired by Rich Felker's post at http://ewontfix.com/7/.
|
||||
See also https://sourceware.org/bugzilla/show_bug.cgi?id=14749 and
|
||||
See also https://sourceware.org/bugzilla/show_bug.cgi?id=14750.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add _exit(2)
|
||||
|
||||
write.2
|
||||
Michael Kerrisk [Kai NODA]
|
||||
Alert the reader that there is a limit on 'count'
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=86061
|
||||
|
||||
aio_suspend.3
|
||||
Michael Kerrisk
|
||||
Note that the glibc implementation is not async-signal-safe
|
||||
See https://sourceware.org/bugzilla/show_bug.cgi?id=13172
|
||||
|
||||
backtrace.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add addr2line(1) and gdb(1)
|
||||
|
||||
bcmp.3
|
||||
bcopy.3
|
||||
bzero.3
|
||||
memccpy.3
|
||||
memchr.3
|
||||
memcmp.3
|
||||
memcpy.3
|
||||
memfrob.3
|
||||
memmem.3
|
||||
memmove.3
|
||||
memset.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add bstring(3)
|
||||
|
||||
exec.3
|
||||
Michael Kerrisk
|
||||
execl() and execle() were not async-signal-safe before glibc 2.24
|
||||
|
||||
fopen.3
|
||||
Michael Kerrisk [Helmut Eller]
|
||||
Describe freopen() behavior for NULL pathname argument
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=191261
|
||||
Michael Kerrisk
|
||||
Note the open(2) flags that correspond to the 'mode' argument
|
||||
Michael Kerrisk
|
||||
Change argument name: 'path' to 'pathname'
|
||||
For consistency with open(2).
|
||||
Michael Kerrisk
|
||||
Add subsection headings for each function
|
||||
|
||||
fts.3
|
||||
Michael Kerrisk
|
||||
Use better argument name for fts_children() and fts_set()
|
||||
Michael Kerrisk
|
||||
Fix minor error in FTSENT structure definition
|
||||
Michael Kerrisk
|
||||
Improve explanation of 'fts_errno'
|
||||
Michael Kerrisk
|
||||
Give a hint that there are further fields in the FTSENT structure
|
||||
Michael Kerrisk
|
||||
Clarify meaning of zero as 'instr' value for fts_set()
|
||||
|
||||
ftw.3
|
||||
Michael Kerrisk
|
||||
Correctly handle use of stat info for FTW_NS in example program
|
||||
Michael Kerrisk
|
||||
Clarify that stat buffer is undefined for FTW_NS
|
||||
|
||||
getline.3
|
||||
Michael Kerrisk
|
||||
EXAMPLE: better error handling
|
||||
Michael Kerrisk [Kent Fredic]
|
||||
EXAMPLE: handle null bytes in input
|
||||
Jann Horn
|
||||
Document ENOMEM error case
|
||||
see the error handling in libio/iogetdelim.c
|
||||
Michael Kerrisk
|
||||
EXAMPLE: specify file to be opened as command-line argument
|
||||
Michael Kerrisk
|
||||
Use better variable name in example program
|
||||
|
||||
getmntent.3
|
||||
Michael Kerrisk [Anders Thulin]
|
||||
Prefer '\\' as the escape to get a backslash
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=191611
|
||||
|
||||
getopt.3
|
||||
Michael Kerrisk
|
||||
Reword discussion of error handling and reporting
|
||||
The existing description was hard to understand. Break
|
||||
it into a bullet list that separates out the details
|
||||
in a manner that is easier to parse.
|
||||
Michael Kerrisk
|
||||
Correct details of use of <stdio.h> to get getopt() declaration
|
||||
Michael Kerrisk [John Wiersba]
|
||||
Remove some redundant text
|
||||
|
||||
mq_open.3
|
||||
Michael Kerrisk [Adam Martindale]
|
||||
Include definition of the 'mq_attr' structure in this man page
|
||||
Make the reader's life a little easier by saving them from
|
||||
having to refer to mq_getattr(3).
|
||||
|
||||
mq_send.3
|
||||
Michael Kerrisk [Adam Martindale]
|
||||
Refer to mq_overview(7) for details on range of message priority
|
||||
|
||||
__ppc_set_ppr_med.3
|
||||
Wainer dos Santos Moschetta
|
||||
Note need for _ARCH_PWR8 macro
|
||||
The _ARCH_PWR8 macro must be defined to get the
|
||||
__ppc_set_ppr_very_low() and __ppc_set_ppr_med_high()
|
||||
definitions.
|
||||
|
||||
printf.3
|
||||
Michael Kerrisk
|
||||
Document nonstandard 'Z' modifier
|
||||
Michael Kerrisk
|
||||
Document 'q' length modifier
|
||||
Michael Kerrisk [Erik Roland van der Meer]
|
||||
Fix a small bug in example code
|
||||
Move the second call to va_end(ap) to above the if-block that
|
||||
precedes it, so that the va_list 'ap' will be cleaned up in
|
||||
all cases.
|
||||
Michael Kerrisk [Nadav Har'El]
|
||||
As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=190341.
|
||||
Michael Kerrisk
|
||||
Add references to setlocale(3) in discussions of locales
|
||||
Michael Kerrisk
|
||||
SEE ALSO: remove bogus self reference (dprintf(3))
|
||||
|
||||
random.3
|
||||
Michael Kerrisk
|
||||
Relocate information of "optimal" value of initstate() 'n' argument
|
||||
The information was a bit hidden in NOTES.
|
||||
|
||||
random_r.3
|
||||
Michael Kerrisk [Jan Ziak]
|
||||
'buf.state' must be initialized to NULL before calling initstate_r()
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=192801.
|
||||
Michael Kerrisk
|
||||
Add some usage notes for setstate_r()
|
||||
Michael Kerrisk
|
||||
Note that 'buf' records a pointer to 'statebuf'
|
||||
See https://sourceware.org/bugzilla/show_bug.cgi?id=3662.
|
||||
Michael Kerrisk
|
||||
Add BUGS section pointing out the weirdness of the initstate_r() API
|
||||
|
||||
resolver.3
|
||||
Michael Kerrisk
|
||||
RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated
|
||||
These options were never implemented; since glibc 2.25, they
|
||||
are deprecated.
|
||||
Michael Kerrisk
|
||||
The RES_NOIP6DOTINT is removed in glibc 2.25
|
||||
Michael Kerrisk
|
||||
Note that RES_BLAST was unimplemented and is now deprecated
|
||||
Michael Kerrisk
|
||||
RES_USE_INET6 is deprecated since glibc 2.25
|
||||
Michael Kerrisk
|
||||
RES_USEBSTRING was removed in glibc 2.25
|
||||
|
||||
resolver.3
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
Note that RES_USEBSTRING defaults to off
|
||||
|
||||
scandir.3
|
||||
Michael Kerrisk [Ian Jackson]
|
||||
Fix errors in example program
|
||||
See http://bugs.debian.org/848231.
|
||||
Michael Kerrisk
|
||||
Improve logic of the example program
|
||||
|
||||
scanf.3
|
||||
Michael Kerrisk
|
||||
Document the quote (') modifier for decimal conversions
|
||||
|
||||
sem_post.3
|
||||
setjmp.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add signal-safety(7)
|
||||
|
||||
sem_wait.3
|
||||
Michael Kerrisk [Fabjan Sukalia]
|
||||
Remove statement that SA_RESTART does not cause restarting
|
||||
This has not been true since Linux 2.6.22. The description
|
||||
of EINTR maintains a reference to signal(7), which explains
|
||||
the historical details.
|
||||
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=192071
|
||||
|
||||
sleep.3
|
||||
Michael Kerrisk [Mike Frysiner]
|
||||
Note that sleep() is implemented via nanosleep(2)
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
|
||||
Michael Kerrisk [Mike Frysinger]
|
||||
Note that sleep() sleeps for a real-time number of seconds
|
||||
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.
|
||||
Michael Kerrisk
|
||||
Convert BUGS text to "Portability notes" subsection
|
||||
The existing text is not a bug, as such.
|
||||
Michael Kerrisk
|
||||
DESCRIPTION: minor reworking
|
||||
|
||||
strerror.3
|
||||
Heinrich Schuchardt
|
||||
Indicate reasonable buffer size for strerror_r() and strerror_l()
|
||||
Add a hint which buffer size is needed for
|
||||
strerror_r() and strerror_l().
|
||||
|
||||
strverscmp.3
|
||||
Michael Kerrisk [Vivenzio Pagliari]
|
||||
Fix comparison error in example program
|
||||
|
||||
system.3
|
||||
Michael Kerrisk
|
||||
In the glibc implementation, fork handlers are not executed by system()
|
||||
|
||||
random.4
|
||||
Michael Kerrisk [Jon Jensen]
|
||||
Note that entropY-avail will be a number in the range 0..4096
|
||||
|
||||
core.5
|
||||
Michael Kerrisk
|
||||
Clarify that dumping program's initial CWD is root directory
|
||||
Michael Kerrisk
|
||||
The target of core dump piping can also be a script
|
||||
|
||||
filesystems.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add btrfs(5), nfs(5), tmpfs(5)
|
||||
|
||||
intro.5
|
||||
Michael Kerrisk
|
||||
Document the reality that by now Section 5 also covers filesystems
|
||||
There are by now, from various filesystem projects, various
|
||||
pages in Section 5 that document different filesystems.
|
||||
Change intro(5) to reflect that.
|
||||
|
||||
Documented after following: http://bugs.debian.org/847998
|
||||
|
||||
proc.5
|
||||
Mike Frysinger [Michael Kerrisk]
|
||||
Clarify /proc/pid/environ behavior
|
||||
/proc/pid/environ reflects process environment at
|
||||
*start* of program execution; it is set at time of execve(2)
|
||||
Michael Kerrisk
|
||||
Add reference to slabinfo(5) in discussion of /proc/meminfo 'Slab' field
|
||||
Michael Kerrisk
|
||||
Add entries for "keys" files that refer reader to keyrings(7)
|
||||
Michael Kerrisk
|
||||
Remove duplicate /proc/[pid]/seccomp entry
|
||||
Michael Kerrisk
|
||||
Mention other system calls that create 'anon_inode' file descriptors
|
||||
Mention a few other system calls that create file descriptors
|
||||
that display an 'anon_inode' symlink in /proc/PID/fd
|
||||
Michael Kerrisk
|
||||
Add some detail on overcommit_memory value 1
|
||||
Michael Kerrisk
|
||||
Add reference to vdso(7) in discussion of /proc/PID/maps
|
||||
|
||||
resolv.conf.5
|
||||
Michael Kerrisk
|
||||
ip6-bytestring was removed in glibc 2.25
|
||||
Michael Kerrisk
|
||||
The ipc-dotint and no-ip6-dotint options were removed in glibc 2.25
|
||||
Michael Kerrisk
|
||||
The 'inet6' option is deprecated since glibc 2.25
|
||||
|
||||
slabinfo.5
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add slabtop(1)
|
||||
|
||||
capabilities.7
|
||||
Michael Kerrisk [Casey Schaufler]
|
||||
Add subsection with notes to kernel developers
|
||||
Provide some notes to kernel developers considering how to choose
|
||||
which capability should govern a new kernel feature.
|
||||
Michael Kerrisk
|
||||
Further enhance the recommendation against new uses of CAP_SYS_ADMIN
|
||||
Michael Kerrisk
|
||||
Explicitly point from CAP_SYS_ADMIN to "Notes for kernel developers"
|
||||
Michael Kerrisk
|
||||
Add another case for CAP_DAC_READ_SEARCH
|
||||
Michael Kerrisk
|
||||
Refer to execve(2) for the reasons that file capabilities may be ignored
|
||||
Michael Kerrisk
|
||||
Document a new use of CAP_SYS_RESOURCE
|
||||
Michael Kerrisk
|
||||
Add some more operations governed by CAP_SYS_ADMIN
|
||||
Michael Kerrisk
|
||||
Adjust references to chattr(1) to point to ioctl_iflags(2)
|
||||
|
||||
environ.7
|
||||
Michael Kerrisk
|
||||
Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations
|
||||
|
||||
inotify.7
|
||||
Michael Kerrisk
|
||||
Point out that inotify monitoring is inode based
|
||||
|
||||
ip.7
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip(8)
|
||||
|
||||
man.7
|
||||
uri.7
|
||||
Jakub Wilk
|
||||
Use "www.kernel.org" in example URLs
|
||||
Apparently www.kernelnotes.org is now a spam site.
|
||||
|
||||
mount_namespaces.7
|
||||
Michael Kerrisk [Rob Landley]
|
||||
Rework the discussion of defaults for mount propagation types
|
||||
Add rather more detail. In particular, note the cases where the
|
||||
default propagation type is MS_PRIVATE vs MS_SHARED.
|
||||
|
||||
namespaces.7
|
||||
Michael Kerrisk
|
||||
EXAMPLE: fix an error in shell session
|
||||
Michael Kerrisk
|
||||
EXAMPLE: rename the example program
|
||||
Use a more generic name, since this program may be expanded
|
||||
in various ways in the future.
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add ip-netns(8)
|
||||
Michael Kerrisk
|
||||
Remove content split out into ioctl_ns(2)
|
||||
|
||||
netlink.7
|
||||
Michael Kerrisk
|
||||
NETLINK_IP6_FW went away in Linux 3.5
|
||||
Michael Kerrisk
|
||||
NETLINK_W1 went away in Linux 2.6.18
|
||||
Michael Kerrisk
|
||||
Add NETLINK_SCSITRANSPORT to list
|
||||
Michael Kerrisk
|
||||
Add NETLINK_RDMA to list
|
||||
Michael Kerrisk
|
||||
NETLINK_FIREWALL was removed in Linux 3.5
|
||||
Michael Kerrisk
|
||||
NETLINK_NFLOG was removed in Linux 3.17
|
||||
Jakub Wilk
|
||||
Update libnl homepage URL
|
||||
The original URL is 404.
|
||||
|
||||
pid_namespaces.7
|
||||
user_namespaces.7
|
||||
Michael Kerrisk
|
||||
Adjust references to namespaces(7) to ioctl_ns(2)
|
||||
|
||||
pid_namespaces.7
|
||||
Keno Fischer
|
||||
CLONE_SIGHAND|CLONE_VM|CLONE_NEWPID is no longer disallowed
|
||||
|
||||
pipe.7
|
||||
Michael Kerrisk
|
||||
Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity
|
||||
Michael Kerrisk
|
||||
Clarify that default pipe capacity is 16 pages
|
||||
The statement that the default pipe capacity is 65536 bytes
|
||||
is accurate only on systems where the page size is 4096B.
|
||||
See the use of PIPE_DEF_BUFFERS in the kernel source.
|
||||
|
||||
random.7
|
||||
Michael Kerrisk
|
||||
Mention getentropy(3)
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add getentropy(3)
|
||||
Michael Kerrisk
|
||||
SEE ALSO: add getauxval(3)
|
||||
A small hint to the reader that some random bytes arrive
|
||||
in the auxiliary vector.
|
||||
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
SIGSYS: add reference to seccomp(2)
|
||||
Michael Kerrisk
|
||||
Change description of SIGSYS to "Bad system call"
|
||||
This is the more typical definition.
|
||||
Michael Kerrisk
|
||||
SIGPIPE: add reference to pipe(7)
|
||||
Michael Kerrisk
|
||||
SIGXFSZ: add reference to setrlimit(2)
|
||||
Michael Kerrisk
|
||||
Add a name for SIGEMT
|
||||
Michael Kerrisk
|
||||
SIGXCPU: add reference to setrlimit(2)
|
||||
Michael Kerrisk
|
||||
Migrated signal-safety discussion to new signal-safet(7) page
|
||||
|
||||
unix.7
|
||||
Michael Kerrisk [Sergey Polovko]
|
||||
Since Linux 3.4, UNIX domain sockets support MSG_TRUNC
|
||||
This was correctly noted in recv(2), but the unix(7) page
|
||||
was not correspondingly updated for the Linux 3.4 change.
|
||||
Michael Kerrisk [Willy Tarreau]
|
||||
Document ETOOMANYREFS for SCM_RIGHTS send exceeding RLIMIT_NOFILE limit
|
||||
|
||||
user_namespaces.7
|
||||
Michael Kerrisk
|
||||
Change page cross reference: keyctl(2) ==> keyrings(7)
|
||||
|
||||
ld.so.8
|
||||
Michael Kerrisk
|
||||
LD_BIND_NOT has effect only for function symbols
|
||||
Michael Kerrisk
|
||||
Describe use of LD_DEBUG with LD_BIND_NOT
|
||||
Michael Kerrisk
|
||||
In secure mode, LD_AUDIT restricts the libraries that it will load
|
||||
Michael Kerrisk
|
||||
LD_AUDIT understands $ORIGIN, $LIB, and $PLATFORM
|
||||
|
||||
|
|
Loading…
Reference in New Issue