mirror of https://github.com/mkerrisk/man-pages
454 lines
15 KiB
Plaintext
454 lines
15 KiB
Plaintext
==================== Changes in man-pages-3.76 ====================
|
|
|
|
Released: 2014-12-31, Munich
|
|
|
|
|
|
Contributors
|
|
------------
|
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
|
in the changelog below) reports, notes, and ideas that have been
|
|
incorporated in changes in this release:
|
|
|
|
Adam Jiang <jiang.adam@gmail.com>
|
|
Andrea Balboni <andrea.balboni@unimore.it>
|
|
Andreas Schwab <schwab@suse.de>
|
|
Bernhard Walle <bernhard@bwalle.de>
|
|
Carlos O'Donell <carlos@redhat.com>
|
|
David Wragg <david@wragg.org>
|
|
Florian Westphal <fw@strlen.de>
|
|
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
|
Huxiaoxiang <huxiaoxiang@huawei.com>
|
|
Jan Chaloupka <jchaloup@redhat.com>
|
|
Jonathan Wakely <jwakely@redhat.com>
|
|
Jonny Grant <jg@jguk.org>
|
|
Josh Triplett <josh@joshtriplett.org>
|
|
Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
|
|
Laurent Georget <laurent.georget@supelec.fr>
|
|
Manuel López-Ibáñez <lopezibanez@gmail.com>
|
|
Marko Myllynen <myllynen@redhat.com>
|
|
Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
|
|
Mel Gorman <mgorman@suse.de>
|
|
Michael Gehring <mg@ebfe.org>
|
|
Michael Haardt <michael@moria.de>
|
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
Mike Frysinger <vapier@gentoo.org>
|
|
Rasmus Villemoes <rv@rasmusvillemoes.dk>
|
|
Richard Weinberger <richard@nod.at>
|
|
Rich Felker <dalias@libc.org>
|
|
Scott Harvey <scott.harvey@stonybrook.edu>
|
|
Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
|
|
Simon Newton <nomis52@gmail.com>
|
|
Simon Paillard <spaillard@debian.org>
|
|
Sven Hoexter <sven@stormbind.net>
|
|
Tobias Werth <werth@cs.fau.de>
|
|
Weijie Yang <weijie.yang.kh@gmail.com>
|
|
Will Newton <will.newton@linaro.org>
|
|
Yuri Kozlov <yuray@komyakino.ru>
|
|
刘湃 <liupai_work@163.com>
|
|
尹杰 <writalnaie@gmail.com>
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
New and rewritten pages
|
|
-----------------------
|
|
|
|
adjtimex.2
|
|
Laurent Georget
|
|
Add fields in struct timex description
|
|
This patch updates the man page with the new fields added in
|
|
struct timex since last edition of the man page.
|
|
Laurent Georget [Michael Kerrisk]
|
|
Document ADJ_TAI
|
|
Michael Kerrisk
|
|
Improve description of ADJ_OFFSET_SINGLESHOT
|
|
Michael Kerrisk
|
|
Add brief documentation of ADJ_MICRO and ADJ_NANO
|
|
Michael Kerrisk
|
|
Reformat return value list
|
|
And remove numeric values, since they're not needed
|
|
Michael Kerrisk
|
|
Other 'modes' bits are ignored on ADJ_OFFSET_*
|
|
Other bits in 'modes' are ignored if modes contains
|
|
ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
|
|
Michael Kerrisk
|
|
Add nanosecond details
|
|
Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
|
|
Michael Kerrisk
|
|
Document ADJ_OFFSET_SS_READ
|
|
Michael Kerrisk
|
|
Reformat 'times' flags as list
|
|
And remove numeric values, since they're not needed.
|
|
Michael Kerrisk
|
|
Note effect of ADJ_NANO for ADJ_SETOFFSET
|
|
Michael Kerrisk
|
|
Add comment noting that timex structure contains padding bytes
|
|
Michael Kerrisk
|
|
Add more details to description of 'tai' field
|
|
Michael Kerrisk
|
|
Note meaning of "PLL" abbreviation
|
|
Michael Kerrisk
|
|
Clarify which 'timex' field is used by each 'modes' bit
|
|
Michael Kerrisk
|
|
Document timex 'status' bits
|
|
Michael Kerrisk
|
|
Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
|
|
Michael Kerrisk
|
|
Update RFC number: RFC 5905 obsoletes RFC 1305
|
|
Michael Kerrisk
|
|
Briefly document ADJ_SETOFFSET
|
|
Michael Kerrisk
|
|
Note PPS (pulse per second) fields in timex structure
|
|
|
|
sigreturn.2
|
|
Michael Kerrisk
|
|
Add (a lot) more detail on the signal trampoline
|
|
And rewrite much of the page.
|
|
|
|
|
|
Newly documented interfaces in existing pages
|
|
---------------------------------------------
|
|
|
|
proc.5
|
|
Bernhard Walle
|
|
Document /proc/thread-self
|
|
/proc/thread-self has been introduced in Linux 3.17 with
|
|
commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
|
|
Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
|
|
Document "VmSwap" field of /proc/[pid]/status
|
|
Florian Westphal
|
|
Document /proc/net/netfilter/nfnetlink_queue
|
|
|
|
|
|
Changes to individual pages
|
|
---------------------------
|
|
|
|
localedef.1
|
|
Marko Myllynen
|
|
Mention default path for compiled files
|
|
|
|
clock_nanosleep.2
|
|
Michael Kerrisk
|
|
Note that 'clock_id' can also be a CPU clock ID
|
|
|
|
epoll_ctl.2
|
|
Michael Kerrisk
|
|
Regular files and directories can't be monitored with epoll_ctl()
|
|
|
|
ioctl.2
|
|
Heinrich Schuchardt
|
|
Rename 'd' argument to 'fd' in text
|
|
In most other manpages file descriptors are called 'fd'.
|
|
This patches renames attribute 'd' to 'fd'.
|
|
|
|
madvise.2
|
|
Michael Kerrisk
|
|
VERSIONS: Support for madvise() is now configurable
|
|
Support for this system call now depends on the
|
|
CONFIG_ADVISE_SYSCALLS configuration option.
|
|
|
|
open.2
|
|
Michael Kerrisk
|
|
Enhance rationale discussion for openat() and friends
|
|
|
|
posix_fadvise.2
|
|
Mel Gorman
|
|
Document the behavior of partial page discard requests
|
|
It is not obvious from the interface that partial page discard'
|
|
requests are ignored. It should be spelled out.
|
|
Michael Kerrisk [Weijie Yang]
|
|
ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
|
|
Michael Kerrisk
|
|
Support for fadvise64() is now configurable
|
|
Support for this system call now depends on the
|
|
CONFIG_ADVISE_SYSCALLS configuration option.
|
|
|
|
prctl.2
|
|
Andreas Schwab
|
|
Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
|
|
The size of the process name has always been at most 16 byte
|
|
_including_ the null terminator. This also means that the
|
|
name returned by PR_GET_NAME is always null-terminated.
|
|
Michael Kerrisk
|
|
PR_SET_NAME silently truncates strings that exceed 16 bytes
|
|
|
|
restart_syscall.2
|
|
Michael Kerrisk
|
|
Add some text explaining why restart_syscall() exists
|
|
|
|
sched_setaffinity.2
|
|
Michael Kerrisk
|
|
NOTES: Add paragraph on how to discover set of CPUs available on system
|
|
Michael Kerrisk
|
|
SEE ALSO: add nproc(1) and lscpu(1)
|
|
|
|
select.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add restart_syscall(2)
|
|
|
|
semop.2
|
|
Michael Kerrisk
|
|
Add note that interrupted semtimedop() returns 'timeout' unchanged
|
|
Michael Kerrisk
|
|
Remove information about semtimedop() EAGAIN that is repeated elsewhere
|
|
Michael Kerrisk
|
|
Add subsection head for semtimedop()
|
|
|
|
setsid.2
|
|
Michael Kerrisk
|
|
Rewrite some pieces and add some details
|
|
Among other changes, add an explanation of why setsid() can't
|
|
be called from a process group leader
|
|
|
|
sgetmask.2
|
|
Michael Kerrisk
|
|
Since 3.16, support for these system call is configurable
|
|
Support for these calls is now dependent on the setting of the
|
|
CONFIG_SGETMASK_SYSCALL option.
|
|
|
|
sigaction.2
|
|
Michael Kerrisk
|
|
Document SA_RESTORER
|
|
Michael Kerrisk
|
|
Add some detail on the sa_restorer field
|
|
Michael Kerrisk
|
|
SEE ALSO: add sigreturn(2)
|
|
|
|
splice.2
|
|
Michael Kerrisk
|
|
Reformat description of 'fd_in' and 'off_in' to improve readability
|
|
|
|
syscall.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add errno(3)
|
|
|
|
syscalls.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add errno(3)
|
|
Michael Kerrisk
|
|
3.19 adds execveat()
|
|
Michael Kerrisk
|
|
Add bpf(2) to list
|
|
|
|
tee.2
|
|
Michael Kerrisk
|
|
Add shell session demonstrating use of the example program
|
|
|
|
tkill.2
|
|
Michael Kerrisk [Rich Felker]
|
|
Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
|
|
|
|
abort.3
|
|
Michael Kerrisk
|
|
Note that SIGABRT is raised as though raise(3) is called
|
|
Also note that abort is POSIX.1-2008 compliant.
|
|
|
|
cmsg.3
|
|
David Wragg
|
|
ensure buf is suitably aligned in sending example
|
|
Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
|
|
the suggested definition in RFC3542) shows that it yields the
|
|
msg_control field. So when sending, the pointer placed in
|
|
msg_control should be suitably aligned as a struct cmsghdr.
|
|
In the sending example, buf was declared as a bare char array,
|
|
and so is not necessarily suitably aligned.
|
|
|
|
The solution here involves placing buf inside a union, and is
|
|
based on the sockets/scm_rights_send.c sample from The Linux
|
|
Programming Interface "dist" source code collection.
|
|
|
|
exp10.3
|
|
Michael Kerrisk
|
|
Before glibc 2.19, exp() did not give ERANGE error on underflow
|
|
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
|
|
|
|
ftw.3
|
|
Michael Kerrisk
|
|
FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
|
|
|
|
getopt.3
|
|
Michael Kerrisk [Jonny Grant]
|
|
Ensure that 'nsecs' is used
|
|
|
|
ilogb.3
|
|
Michael Kerrisk [Will Newton]
|
|
Since glibc 2.16, ilogb() does correctly diagnore domain errors
|
|
|
|
memcmp.3
|
|
Michael Haardt
|
|
Document return value for n==0 case
|
|
Michael Haardt
|
|
Warn against use of memcmp() for comparing security-critical data
|
|
|
|
mq_open.3
|
|
Michael Kerrisk
|
|
Document the O_CLOEXEC flag
|
|
Michael Kerrisk
|
|
Place 'flags' constants in alphabetical order
|
|
|
|
pow.3
|
|
Manuel López-Ibáñez
|
|
Add note on performance characteristics of pow()
|
|
|
|
pthread_setschedparam.3
|
|
Simon Newton
|
|
Fix logic error in example program
|
|
The example program will crash if -A is used, since 'attr'
|
|
is uninitialized.
|
|
|
|
$ ./a.out -A
|
|
*** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
|
|
Aborted (core dumped)
|
|
刘湃
|
|
Small fixes to example program
|
|
|
|
sigvec.3
|
|
Michael Kerrisk
|
|
Starting with version 2.21, glibc no longer exports sigvec()
|
|
|
|
sysconf.3
|
|
Josh Triplett
|
|
Document _SC_NGROUPS_MAX
|
|
Already documented in getgroups(2), but not in sysconf(3).
|
|
|
|
termios.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add tset(1)
|
|
|
|
tgamma.3
|
|
Michael Kerrisk
|
|
Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
|
|
|
|
wordexp.3
|
|
Carlos O'Donell
|
|
Make it clear that WRDE_NOCMD prevents command substitution
|
|
The use of WRDE_NOCMD prevents command substitution. If the flag
|
|
WRDE_NOCMD is set then no command substitution shall occur and
|
|
the error WRDE_CMDSUB will be returned if such substitution is
|
|
requested when processing the words.
|
|
|
|
The manual page as-is makes it seem like the command substitution
|
|
occurs, and an error is returned *after* the substitution.
|
|
This patch clarifies that.
|
|
|
|
locale.5
|
|
Marko Myllynen
|
|
Describe the formats of values
|
|
locale(5) describes what a locale should define but doesn't
|
|
spell out how (in what format). The patch attempts to address
|
|
this, it also has few trivial additional enhancements.
|
|
|
|
* Reference to locale(7) for category descriptions.
|
|
* Clarify first_workday in NOTES a bit.
|
|
* Add upstream BZ reference for two missing LC_ADDRESS fields.
|
|
Marko Myllynen
|
|
Fix miscoded character
|
|
|
|
resolv.conf.5
|
|
Jan Chaloupka
|
|
Add missing no-tld-query option
|
|
Based on commit [1], ithe no-tld-query option exists for
|
|
resolv.conf configuration file. Description of this option
|
|
is provided in [2]. This patch just copies this option
|
|
into resolv.conf.5 man page. Plus changes 'a' member
|
|
into 'an' before 'unqualified name as if it ...'
|
|
on the third line of [2]. Based on [3], this option
|
|
was added in glibc 2.14 as solving [4] bug.
|
|
|
|
[1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
|
|
[2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
|
|
[3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
|
|
[4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
|
|
|
|
credentials.7
|
|
Josh Triplett
|
|
Cross-reference getgroups(2)
|
|
Since credentials.7 discusses supplementary GIDs, it should
|
|
reference getgroups(2).
|
|
|
|
fanotify.7
|
|
Heinrich Schuchardt
|
|
Allow relative paths in example
|
|
The current example code requires passing an absolute
|
|
path to the mount to be watched.
|
|
|
|
By passing AT_FDCWD to fanotify_mark it can use both
|
|
absolute and relative paths.
|
|
Heinrich Schuchardt
|
|
fallocate(2) creates no events
|
|
fallocate(2) should create FAN_MODIFY events but does not.
|
|
Heinrich Schuchardt [Michael Kerrisk]
|
|
fanotify notifies only events generated on the same mount
|
|
Unfortunately, fanotify does not inform listeners for all paths
|
|
under which a touched filesystem object is visible, but only the
|
|
listener using the same path as the process touching the
|
|
filesystem object.
|
|
Heinrich Schuchardt
|
|
Update BUGS to note bugs still not fixed in 3.17
|
|
I bumped the Linux version number in the BUGS section to 3.17.
|
|
|
|
inotify.7
|
|
Heinrich Schuchardt
|
|
fallocate(2) does not trigger inotify events
|
|
Calling fallocate(2) does not result in inotify events.
|
|
|
|
locale.7
|
|
Marko Myllynen
|
|
Improve LOCPATH description
|
|
LOCPATH is ignored by privileged programs.
|
|
|
|
Add locale archive references.
|
|
|
|
Add FILES section.
|
|
|
|
man-pages.7
|
|
Michael Kerrisk [Laurent Georget]
|
|
Clarify that SEE ALSO entries may refer to pages from other projects
|
|
|
|
signal.7
|
|
Michael Kerrisk
|
|
Mention other "slow devices"
|
|
Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
|
|
and fanotify(7) file descriptors are also slow operations
|
|
that are restartable.
|
|
Michael Kerrisk
|
|
Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
|
|
Michael Kerrisk
|
|
Since Linux 3.8, reads on inotify(7) file descriptors are restartable
|
|
Michael Kerrisk
|
|
inotify(7) reads no longer show the odd EINTR error after SIGCONT
|
|
Since kernel 3.7, reads from inotify(7) file descriptors no longer
|
|
show the (Linux oddity) behavior of failing with EINTR when the
|
|
process resumes after a stop signal + SIGCONT.
|
|
Michael Kerrisk
|
|
SEE ALSO: add sigreturn(2)
|
|
|
|
unix.7
|
|
Michael Kerrisk [Scott Harvey]
|
|
Fix buglet in code snippet in BUGS section
|
|
|
|
ld.so.8
|
|
Carlos O'Donell
|
|
Add --inhibit-cache option
|
|
The dynamic loader has 6 options, only 5 are documented.
|
|
This patch documents the sixth option i.e. `--inhibit-cache`.
|
|
Jonathan Wakely [Siddhesh Poyarekar]
|
|
Correct documentation of $ORIGIN
|
|
As noted by Siddhesh:
|
|
|
|
The ld.so man page says:
|
|
|
|
$ORIGIN (or equivalently ${ORIGIN})
|
|
This expands to the directory containing the
|
|
application executable. Thus, an application located
|
|
in somedir/app could be compiled with
|
|
|
|
This is incorrect since it expands to the directory containing
|
|
the DSO and not the application executable. This seems like
|
|
deliberate behaviour in dl-object.c, so it needs to be fixed in
|
|
the man page.
|
|
|
|
See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
|
|
|