mirror of https://github.com/mkerrisk/man-pages
911 lines
30 KiB
Plaintext
911 lines
30 KiB
Plaintext
==================== 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
|
|
|