blob: 987143eb4845e58eed2c9b0cf4a7045345334f36 [file] [log] [blame]
==================== Changes in man-pages-3.83 ====================
Released: 2015-04-19, Munich
Contributors
------------
The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
Andreas Baak <andreas.baak@gmail.com>
Andreas Dilger <adilger@dilger.ca>
cdlscpmv <cdlscpmv@gmail.com>
Cyrill Gorcunov <gorcunov@openvz.org>
Darrick J. Wong <darrick.wong@oracle.com>
David Rientjes <rientjes@google.com>
Dima Tisnek <dimaqq@gmail.com>
Eric Sandeen <sandeen@redhat.com>
Fabien Pichot <fpichot@bouledef.eu>
Felix Sedlmeier <sedlmeier@gmx.de>
Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
Heinrich Schuchardt <xypron.glpk@gmx.de>
Jann Horn <jann@thejh.net>
Jon Grant <jg@jguk.org>
Jonny Grant <jg@jguk.org>
Kees Cook <keescook@chromium.org>
Masanari Iida <standby24x7@gmail.com>
Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Nikos Mavrogiannopoulos <nmav@gnutls.org>
Omar Sandoval <osandov@osandov.com>
Pierre Chifflier <pollux@debian.org>
Robin H. Johnson <robbat2@gentoo.org>
Rob Landley <rob@landley.net>
Theodore Ts'o <tytso@mit.edu>
Vlastimil Babka <vbabka@suse.cz>
Walter Harms <wharms@bfs.de>
William Woodruff <william@tuffbizz.com>
YOSHIFUJI Hideaki <hideaki.yoshifuji@miraclelinux.com>
Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
posix_madvise.3
Michael Kerrisk
New page documenting posix_madvise(3)
ftw.3
Michael Kerrisk
Reorganize the page to give primacy to nftw()
nftw() is the better API, and POSIX.1-2008 marks ftw() obsolete.
Newly documented interfaces in existing pages
---------------------------------------------
getdents.2
Michael Kerrisk
Document getdents64()
mount.2
Michael Kerrisk, Theodore Ts'o [Eric Sandeen, Andreas Dilger,
Omar Sandoval, Darrick J. Wong]
Document MS_LAZYTIME
Based on Ted T'so's commit message 0ae45f63d4e
proc.5
Michael Kerrisk
Document /proc/sys/kernel/randomize_va_space
Michael Kerrisk
Document /proc/PID/fdinfo epoll format
Michael Kerrisk
Describe /proc/PID/fdinfo eventfd format
Michael Kerrisk
Document /proc/PID/fdinfo signalfd format
New and changed links
---------------------
newfstatat.2
Michael Kerrisk
New link to fstatat64.2
prlimit64.2
Michael Kerrisk
New link to getrlimit.2
Global changes
--------------
Various secion 3 math pages
Michael Kerrisk
Note that these functions are also in POSIX.1-2001 and POSIX.1-2008
Changes to individual pages
---------------------------
getent.1
Robin H. Johnson
Document options
The options to getent are now documented, after being around for
nearly a decade without changes.
Michael Kerrisk
Document help and version options
fallocate.2
Michael Kerrisk
Fix kernel version number for FALLOC_FL_ZERO_RANGE
FALLOC_FL_ZERO_RANGE as added in 3.15, not 3.14.
Michael Kerrisk
Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17
getdents.2
Michael Kerrisk [Dima Tisnek]
Update timestamp
Really just a marker to record the reporters of bugs
that stemmed from the fact that the page did not
document getdents64(). I'll fix things up in the changelog.
See https://bugzilla.kernel.org/show_bug.cgi?id=14795
getrlimit.2
Michael Kerrisk
Note that the underlying system call for prlimit() is prlimit64()
Michael Kerrisk
Remove "_FILE_OFFSET_BITS == 64" from prlimit() FTM requirements
"_FILE_OFFSET_BITS == 64" is not needed to get the prlimit()
declaration.
ioctl_list.2
Nikos Mavrogiannopoulos
SIOCADDRT accepts in6_rtmsg in INET6 protocol
Heinrich Schuchardt
TFD_IOC_SET_TICKS
timerfd_create.2 mentions TFD_IOC_SET_TICKS. We should add it to
ioctl_list.2, too.
llseek.2
Michael Kerrisk
Advise reader to use lseek(2) instead
Michael Kerrisk
llseek() exists on 32-bit platforms to support seeking to large offsets
madvise.2
David Rientjes
Specify MADV_REMOVE returns EINVAL for hugetlbfs
madvise(2) actually returns with error EINVAL for MADV_REMOVE
when used for hugetlb VMAs, not EOPNOTSUPP, and this has been
the case since MADV_REMOVE was introduced in commit f6b3ec238d12
("madvise(MADV_REMOVE): remove pages from tmpfs shm backing
store"). Specify the exact behavior.
Michael Kerrisk
SEE ALSO: add posix_madvise(2)
poll.2
Michael Kerrisk [Andreas Baak]
SEE ALSO: add epoll(7)
posix_fadvise.2
Michael Kerrisk
Add "C library/kernel ABI differences" subsection
pread.2
Michael Kerrisk
Add "C library/kernel ABI differences" subsection
seccomp.2
Michael Kerrisk [Pierre Chifflier, Kees Cook]
Note that seccomp_data is read-only
stat.2
Michael Kerrisk
Add some details on various "stat" versions
Three versions of "stat" appeared on 32-bit systems,
dealing with structures of different (increasing) sizes.
Explain some of the details, and also note that the
situation is simpler on modern 64-bit architectures.
Michael Kerrisk
Add a little more detail on history of three versions of *stat()
Michael Kerrisk
Add mention of newfstatat()
The underlying system call for fstatat() is newfstatat()
on some architectures.
symlink.2
Michael Kerrisk [Jonny Grant]
ERRORS: add linkpath=="" case for ENOENT
syscalls.2
Michael Kerrisk
Remove prlimit()
There really is only the prlimit64() system call.
See also commit 7b08c45b7df.
Michael Kerrisk
Add some details about the "multiple versions of system calls"
The multiple-system-call-version phenomenon is particular a
feature of older 32-bit platforms. Hint at that fact in the text.
timerfd_create.2
Cyrill Gorcunov [Michael Kerrisk]
Document TFD_IOC_SET_TICKS ioctl() operation
Michael Kerrisk
Add some details to C library/kernel ABI differences
unshare.2
Michael Kerrisk [Fabien Pichot]
Remove mention of "System V" from discussion of CLONE_NEWIPC
These days, CLONE_NEWIPC also affects POSIX message queues.
asprintf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
carg.3
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
ccos.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
ccosh.3
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
cexp.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
clock.3
Ma Shimiao
ATTRIBUTES: Note functions that is thread-safe
clog.3
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
csin.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
csinh.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
csqrt.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Simplify description of what these functions calculate
ctan.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
ctanh.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate
ctime.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
exec.3
Michael Kerrisk
SYNOPSIS: Clarify calling signature for execl() and execlp()
Michael Kerrisk [Andreas Baak]
Correct prototype for execle()
Make the prototype shown into correct C.
ftw.3
Michael Kerrisk [Felix Sedlmeier]
ftw() and nftw() differ for the non-stat-able symlink case
The POSIX specification of ftw() says that an un-stat-able
symlink may yield either FTW_NS or FTW_SL. The specification
of nftw() does not carry this statement.
Michael Kerrisk
CONFORMING TO: add POSIX.1-2008
Michael Kerrisk
Update POSIX version references in NOTES
getcwd.3
Jann Horn [Michael Kerrisk]
Note behavior for unreachable current working directory
Michael Kerrisk
Add ENOMEM error
gethostbyname.3
Michael Kerrisk [Jonny Grant]
Clarify that NO_ADDRESS and NO_DATA are synonyms
Michael Kerrisk
Add some detail for NO_DATA
Text consistent with POSIX and FreeBSD's gethostbyname() man page.
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
getnetent.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
get_nprocs_conf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
getutent.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
glob.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
insque.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
login.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
lseek64.3
Michael Kerrisk
Clarify details with respect to 32-bit and 64-bit systems
malloc.3
Michael Kerrisk
Add ENOMEM error
mbsnrtowcs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe
mbsrtowcs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe
mq_notify.3
Michael Kerrisk
Add "C library/kernel ABI differences" subsection
mq_open.3
Michael Kerrisk [Fabien Pichot]
NOTES: explain differences from the underlying system call
The check for the slash at the start of a pathname is done in glibc
openpty.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
perror.3
Zeng Linggang
ATTRIBUTES: Note function that is thread-safe
posix_memalign.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
printf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
Walter Harms [Michael Kerrisk]
Simplify the example code
qsort.3
Michael Kerrisk [Rob Landley]
alphasort() and versionsort() are not suitable for 'compar'
In glibc 2.10, the prototypes of alphasort() and versionsort()
were changed so that the arguments switched from 'const void *' to
'const struct dirent **', to match the POSIX.1-2008 specification
of alphasort(). As such, compiler warnings will result if
these functions are used as the arguments of qsort().
warning: passing argument 4 of 'qsort' from incompatible
pointer type
expected '__compar_fn_t' but argument is of type
'int (*)(const struct dirent **, const struct dirent **)'
Therefore, remove the ancient NOTES text suggesting that
alphasort() and versionsort() can be used as suitable
'compar' arguments for qsort().
realpath.3
Michael Kerrisk [Jon Grant]
Add ENOMEM error
scandir.3
Michael Kerrisk
glibc 2.10 changed the argument types for alphasort() and versionsort()
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
scanf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
setnetgrent.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
significand.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
strcasecmp.3
Michael Kerrisk [Jonny Grant]
Clarify that strcasecmp() does a byte-wise comparison
Michael Kerrisk
CONFORMING TO: add POSIX.1-2008
unlocked_stdio.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
updwtmp.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
wcrtomb.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe
wcsnrtombs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe
wcsrtombs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe
wordexp.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe
wprintf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
proc.5
Michael Kerrisk
Describe "mnt_id" field of /proc/PID/fdinfo
Michael Kerrisk
Note that abstract sockets are included in /proc/net/unix
Michael Kerrisk
Update description /proc/sys/unix 'Type' field
The existing text was very crufty. UNIX domain sockets
support more than SOCK_STREAM for a _very_ long time now.
Michael Kerrisk
Add some detail to /proc/PID/timers
Michael Kerrisk [Vlastimil Babka]
Enhance discussion of /proc/PID/status 'VmSwap' field
Based on https://lwn.net/Articles/634978/
epoll.7
Michael Kerrisk
SEE ALSO: add poll(2) and select(2)
icmp.7
YOSHIFUJI Hideaki/吉藤英明
Document net.ipv4.ping_group_range knob
nptl.7
Michael Kerrisk
Add reference to timer_create(2)