mirror of https://github.com/mkerrisk/man-pages
1046 lines
33 KiB
Plaintext
1046 lines
33 KiB
Plaintext
==================== Changes in man-pages-4.05 ====================
|
|
|
|
Released: 2016-03-15, Christchurch
|
|
|
|
|
|
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:
|
|
|
|
Adhemerval Zanella <adhemerval.zanella@linaro.org>
|
|
Akihiro Suda <suda.kyoto@gmail.com>
|
|
Alan Aversa <alan.aversa@cox.net>
|
|
Alan Cox <etchedpixels@gmail.com>
|
|
Alec Leamas <leamas.alec@gmail.com>
|
|
Alex Henrie <alexhenrie24@gmail.com>
|
|
Alexander Miller <alex.miller@gmx.de>
|
|
Andreas Gruenbacher <agruenba@redhat.com>
|
|
Andreas Schwab <schwab@suse.de>
|
|
Anna Schumaker <Anna.Schumaker@Netapp.com>
|
|
Askar Safin <safinaskar@mail.ru>
|
|
Bill O. Gallmeister <bgallmeister@gmail.com>
|
|
Carlos O'Donell <carlos@redhat.com>
|
|
Chris Pick <kernel@chrispick.com>
|
|
Christoph Hellwig <hch@infradead.org>
|
|
Craig Gallek <kraig@google.com>
|
|
Darrick J. Wong <darrick.wong@oracle.com>
|
|
Davidlohr Bueso <dave@stgolabs.net>
|
|
Dmitry V. Levin <ldv@altlinux.org>
|
|
Dr. Tobias Quathamer <toddy@debian.org>
|
|
Eric Blake <eblake@redhat.com>
|
|
Eric Dumazet <edumazet@google.com>
|
|
Florian Weimer <fweimer@redhat.com>
|
|
Gabriel Corona <gabriel.corona@enst-bretagne.fr>
|
|
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
|
Ivan Shapovalov <intelfx@intelfx.name>
|
|
Jakub Wilk <jwilk@jwilk.net>
|
|
Jason Baron <jbaron@akamai.com>
|
|
Jason Vas Dias <jason.vas.dias@gmail.com>
|
|
Jérémie Galarneau <jeremie.galarneau@efficios.com>
|
|
Jeremy Harris <jeharris@redhat.com>
|
|
Joachim Wuttke <j.wuttke@fz-juelich.de>
|
|
Joe Stein <joeaarons@gmail.com>
|
|
John Stultz <john.stultz@linaro.org>
|
|
Josh Triplett <josh@joshtriplett.org>
|
|
Kondo, Naoya <kondo-naoya@jp.fujitsu.com>
|
|
Krzysztof Adamski <k@japko.eu>
|
|
Manfred Spraul <manfred@colorfullife.com>
|
|
Marianne CHEVROT <blackmoor@openmailbox.org>
|
|
Marko Myllynen <myllynen@redhat.com>
|
|
Mark Post <mpost@suse.com>
|
|
Martin Gebert <Murphy.Gebert@gmx.de>
|
|
Mats Wichmann <mats@linuxfoundation.org>
|
|
Matt Zimmerman <mdz@debian.org>
|
|
Michael Kerrisk <mtk.manpages@gmail.com>`
|
|
Mike Frysinger <vapier@gentoo.org>
|
|
Minchan Kim <minchan@kernel.org>
|
|
Naoya Kondo <kondo-naoya@jp.fujitsu.com>
|
|
Naresh Kamboju <naresh.kernel@gmail.com>
|
|
Nikola Forró <nforro@redhat.com>
|
|
Nikos Mavrogiannopoulos <nmav@gnutls.org>
|
|
Orion Poplawski <orion@cora.nwra.com>
|
|
Pakin Yury <zxwarior@yandex.ru>
|
|
Patrick Donnelly <batrick@batbytes.com>
|
|
Paul Eggert <eggert@cs.ucla.edu>
|
|
Paul Pluzhnikov <ppluzhnikov@google.com>
|
|
Peter Hurley <peter@hurleysoftware.com>
|
|
Peter Wu <peter@lekensteyn.nl>
|
|
Petr Gajdos <pgajdos@suse.cz>
|
|
Philip Semanchuk <linux_kernel.20.ick@spamgourmet.com>
|
|
Rasmus Villemoes <Rasmus.Villemoes@decode.is>
|
|
Rich Felker <dalias@aerifal.cx>
|
|
Simon Que <sque@chromium.org>
|
|
Stephan Bergmann <sbergman@redhat.com>
|
|
Stéphane Aulery <lkppo@free.fr>
|
|
Stephen Hurd <shurd@sasktel.net>
|
|
Vincent Bernat <bernat@luffy.cx>
|
|
William Preston <wpreston@suse.de>
|
|
Yuri Kozlov <yuray@komyakino.ru>
|
|
Zefram <zefram@fysh.org>
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
New and rewritten pages
|
|
-----------------------
|
|
|
|
copy_file_range.2
|
|
Anna Schumaker [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk]
|
|
New page documenting copy_file_range()
|
|
copy_file_range() is a new system call for copying ranges of data
|
|
completely in the kernel. This gives filesystems an opportunity to
|
|
implement some kind of "copy acceleration", such as reflinks or
|
|
server-side-copy (in the case of NFS).
|
|
|
|
personality.2
|
|
Michael Kerrisk
|
|
This page has been greatly expanded, to add descriptions of
|
|
personality domains.
|
|
|
|
fmemopen.3
|
|
Michael Kerrisk [Adhemerval Zanella]
|
|
Significant reworking of this page:
|
|
* Rework discussion of the (obsolete) binary mode
|
|
* Split open_memstream(3) description into a separate page.
|
|
* Note various fmemopen() bugs that were fixed in glibc 2.22
|
|
* Greatly expand description of 'mode' argument
|
|
* Rework description of 'buf' and 'len' arguments
|
|
* Expand discussion of "current position" for fmemopen() stream
|
|
|
|
ntp_gettime.3
|
|
Michael Kerrisk
|
|
New page describing ntp_gettime(3) and ntp_gettimex(3)
|
|
|
|
open_memstream.3
|
|
Michael Kerrisk
|
|
New page created by split of fmemopen(3).
|
|
At the same time, add and rework a few details in the text.
|
|
|
|
posix_spawn.3
|
|
Bill O. Gallmeister, Michael Kerrisk
|
|
New man page documenting posix_spawn(3) and posix_spawnp(3)
|
|
|
|
readdir.3
|
|
Michael Kerrisk [Florian Weimer]
|
|
Split readdir_r() content into separate page
|
|
As suggested by Florian Weimer:
|
|
|
|
It may make sense to move this documentation to a separate
|
|
manual page, specific to readdir_r. This will keep the
|
|
readdir() documentation nice and crisp. Most programmers
|
|
will never have to consult all these details.
|
|
Michael Kerrisk
|
|
Near complete restructuring of the page and add some further details
|
|
Michael Kerrisk [Florian Weimer, Rich Felker, Paul Eggert]
|
|
Add a lot more detail on portable use of the 'd_name' field
|
|
|
|
readdir_r.3
|
|
Michael Kerrisk [Florian Weimer]
|
|
New page created after split of readdir(3).
|
|
Michael Kerrisk [Florian Weimer]
|
|
Explain why readdir_r() is deprecated and readdir() is preferred
|
|
Michael Kerrisk [Florian Weimer]
|
|
Remove misleading code example using pathconf()
|
|
|
|
lirc.4
|
|
Alec Leamas
|
|
New page documenting lirc device driver
|
|
|
|
|
|
Newly documented interfaces in existing pages
|
|
---------------------------------------------
|
|
|
|
adjtimex.2
|
|
Michael Kerrisk
|
|
Document ntp_adjtime(3)
|
|
|
|
epoll_ctl.2
|
|
Michael Kerrisk [Jason Baron]
|
|
Document EPOLLEXCLUSIVE
|
|
|
|
madvise.2
|
|
Minchan Kim [Michael Kerrisk]
|
|
Document MADV_FREE
|
|
Document the MADV_FREE flag added to madvise() in Linux 4.5.
|
|
|
|
proc.5
|
|
Michael Kerrisk
|
|
Document CmaTotal and CmaFree fields of /proc/meminfo
|
|
Michael Kerrisk
|
|
Document additional /proc/meminfo fields
|
|
Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G
|
|
Michael Kerrisk
|
|
Document MemAvailable /proc/meminfo field
|
|
Michael Kerrisk
|
|
Document inotify /proc/PID/fdinfo entries
|
|
Michael Kerrisk
|
|
Document fanotify /proc/PID/fdinfo entries
|
|
Michael Kerrisk
|
|
Add some kernel version numbers for /proc/PID/fdinfo entries
|
|
Michael Kerrisk [Patrick Donnelly]
|
|
/proc/PID/fdinfo displays the setting of the close-on-exec flag
|
|
Note also the pre-3.1 bug in the display of this info.
|
|
|
|
socket.7
|
|
Craig Gallek [Michael Kerrisk, Vincent Bernat]
|
|
Document some BPF-related socket options
|
|
Document the behavior and the first kernel version for each of the
|
|
following socket options:
|
|
|
|
SO_ATTACH_FILTER
|
|
SO_ATTACH_BPF
|
|
SO_ATTACH_REUSEPORT_CBPF
|
|
SO_ATTACH_REUSEPORT_EBPF
|
|
SO_DETACH_FILTER
|
|
SO_DETACH_BPF
|
|
SO_LOCK_FILTER
|
|
|
|
|
|
New and changed links
|
|
---------------------
|
|
|
|
isalpha_l.3
|
|
Michael Kerrisk
|
|
New link to isalpha.3
|
|
|
|
longjmp.3
|
|
Michael Kerrisk
|
|
Replace page with link to setjmp(3), which now incorporates longjmp()
|
|
|
|
ntp_adjtime.3
|
|
Michael Kerrisk
|
|
New link to adjtimex(2)
|
|
|
|
ntp_gettimex.3
|
|
Michael Kerrisk
|
|
New link to ntp_gettime.3
|
|
|
|
open_wmemstream.3
|
|
Michael Kerrisk
|
|
Update link to point to new open_memstream(2) page
|
|
|
|
posix_spawnp.3
|
|
Michael Kerrisk
|
|
New link to new posix_spawn.3 page
|
|
|
|
siglongjmp.3
|
|
Michael Kerrisk
|
|
Rewire link to point to setjmp(3)
|
|
|
|
strerror_l.3
|
|
Michael Kerrisk
|
|
New link to strerror.3
|
|
Fix missing link
|
|
|
|
|
|
Global changes
|
|
--------------
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Update FTM requirements (_DEFAULT_SOURCE)
|
|
Michael Kerrisk
|
|
Update feature test macro requirements
|
|
Update to use _DEFAULT_SOURCE, and also changes brought by
|
|
glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Simplify FTM requirements
|
|
Looking at <features.h> (or feature_test_macros(7)), one can
|
|
see that when _XOPEN_SOURCE is defined with the value 700
|
|
(or greater), then _POSIX_C_SOURCE is defined with the value
|
|
200809L (or greater). Therefore, terms in the man pages such as
|
|
|
|
_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
|
|
|
|
can be simplified to:
|
|
|
|
_POSIX_C_SOURCE\ >=\ 200809L
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Simplify FTM requirements
|
|
Looking at <features.h> (or feature_test_macros(7)), one can
|
|
see that when _XOPEN_SOURCE is defined with the value 600
|
|
(or greater), then _POSIX_C_SOURCE is defined with the value
|
|
200112L (or greater). Therefore, terms in the man pages such as
|
|
|
|
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
|
|
|
|
can be simplified to:
|
|
|
|
_POSIX_C_SOURCE\ >=\ 200112L
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Simplify FTM requirements
|
|
_XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
|
|
requirements in various pages.
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Remove "or 'cc -std=c99'" from SYNOPSIS
|
|
Under the FTM requirements all of these pages document the
|
|
requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
|
|
documents that "cc -std=c99" produces the same effect as defining
|
|
_ISOC99_SOURCE. So, all of these pages don't additionally need
|
|
to specify "or 'cc -std=c99'" under the FTM requirements
|
|
in the SYNOPSIS. Removing that redundant text also simplifies
|
|
the SYNOPSIS a little.
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Simplify FTM requirements
|
|
Looking at <features.h> (or feature_test_macros(7)), one can
|
|
see that when _XOPEN_SOURCE is defined with the value 600
|
|
(or greater), then _POSIX_C_SOURCE is defined with the value
|
|
200112L (or greater). Therefore, terms in the man pages such as
|
|
|
|
_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
|
|
|
|
can be simplified to:
|
|
|
|
_POSIX_C_SOURCE\ >=\ 200112L
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
|
|
_XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
|
|
subsequent standards). _XOPEN_SOURCE >= 500 produces the same
|
|
effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
|
|
the SYNOPSIS of various ages that contain:
|
|
|
|
_XOPEN_SOURCE\ >=\ 500 ||
|
|
_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
|
|
|
|
to just:
|
|
|
|
_XOPEN_SOURCE\ >=\ 500
|
|
|
|
This has the following benefits:
|
|
|
|
a) Simplifying the SYNOPSIS by removing ancient
|
|
historical information.
|
|
|
|
b) Preventing users from being misled into using
|
|
_XOPEN_SOURCE_EXTENDED in new source code.
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
|
|
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
|
|
obsolete bu _POSIX_C_SOURCE. Retaining mention of it
|
|
in the feature test macro requirements section of the
|
|
SYNOPSIS doesn't contain important information, and may
|
|
mislead readers into actually trying to use this macro.
|
|
A few mentions of it are maintained in a some pages where
|
|
defining _POSIX_SOURCE inhibits some behavior.
|
|
|
|
Various sockets-related pages
|
|
Michael Kerrisk [Carlos O'Donell]
|
|
Use consistent argument/variable names for socket addresses and lengths
|
|
As noted by Carlos, there's quite a bit of inconsistency across
|
|
pages. Use 'addr' and 'addrlen' consistently in variables and
|
|
function arguments.
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Wording fix: "current file offset" ==> "file offset"
|
|
"File offset" is the preferred POSIX terminology.
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
Word "descriptor" more precisely
|
|
Use either "file descriptor" or message queue descriptor".
|
|
|
|
Various pages
|
|
Michael Kerrisk
|
|
ERRORS: add reference to signal(7) in description of EINTR
|
|
|
|
|
|
Changes to individual pages
|
|
---------------------------
|
|
|
|
locale.1
|
|
Marko Myllynen
|
|
Add "locale -c charmap" as an example
|
|
Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511.
|
|
|
|
localedef.1
|
|
Marko Myllynen
|
|
Add hint on purpose of --no-archive
|
|
Indicate why using --no-archive might be a good idea. The issue
|
|
is that if you create a custom locale with localedef(1) and put
|
|
it to the locale archive then during the next glibc upgrade the
|
|
locale archive is updated as well and your custom locale is gone.)
|
|
|
|
accept.2
|
|
Michael Kerrisk
|
|
ERRORS: improve description for EBADF
|
|
|
|
adjtimex.2
|
|
Michael Kerrisk [John Stultz]
|
|
Various improvements after feedback from John Stultz
|
|
Michael Kerrisk
|
|
Remove FTM requirements
|
|
It seems that adjtimex() never needed _BSD_SOURCE (and my
|
|
earlier commit 5918743bc8b02b was simply a blunder).
|
|
Michael Kerrisk
|
|
Split EINVAL error cases
|
|
Michael Kerrisk
|
|
Note treatment of out-of-range buf.offset
|
|
Michael Kerrisk
|
|
Don't refer reader to adjtime(3)
|
|
Probably, it's not wise to suggest adjtime(3) as the more
|
|
portable API. Rather, ntp_adjtime(3) should be used.
|
|
Michael Kerrisk [Naresh Kamboju]
|
|
Update details of buf.offset EINVAL error
|
|
Michael Kerrisk
|
|
SEE ALSO: add ntp_gettime(3)
|
|
Michael Kerrisk
|
|
Improve description of some PPS timex fields
|
|
Michael Kerrisk
|
|
Add ATTRIBUTES section
|
|
William Preston [Petr Gajdos]
|
|
Update a detail in adjtimex return value description
|
|
Michael Kerrisk
|
|
Note range constraints and clamping for ADJ_FREQUENCY
|
|
|
|
bdflush.2
|
|
Michael Kerrisk
|
|
Note that glibc support for this system call went away in version 2.23
|
|
|
|
bind.2
|
|
Michael Kerrisk
|
|
Improve description of ENOENT error
|
|
|
|
bpf.2
|
|
Michael Kerrisk
|
|
Document close-on-exec semantics
|
|
The close-on-exec file descriptor flag is automatically enabled
|
|
for FDs returned by bpf().
|
|
|
|
chmod.2
|
|
Michael Kerrisk
|
|
Clarify terminology (file mode versus file permission bits)
|
|
|
|
chown.2
|
|
Michael Kerrisk
|
|
ERRORS: improve EBADF description
|
|
|
|
clone.2
|
|
unshare.2
|
|
Michael Kerrisk
|
|
Remove mention of _BSD_SOURCE and _SVID_SOURCE
|
|
The right way to expose declarations for these Linux-specific
|
|
system calls was always _GNU_SOURCE. Mentioning the historical
|
|
use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue.
|
|
|
|
connect.2
|
|
Michael Kerrisk
|
|
ERRORS: improve EBADF description
|
|
|
|
create_module.2
|
|
Michael Kerrisk
|
|
Glibc 2.23 removed last vestiges of support for this system call
|
|
|
|
delete_module.2
|
|
Michael Kerrisk
|
|
Glibc 2.23 removed last vestiges of support for this system call
|
|
|
|
epoll_ctl.2
|
|
Michael Kerrisk
|
|
Document ELOOP error for circular monitoring loops
|
|
|
|
eventfd.2
|
|
Michael Kerrisk
|
|
Note that eventfd info is available in /proc/PID/fdinfo
|
|
|
|
execve.2
|
|
Michael Kerrisk [Krzysztof Adamski]
|
|
Add EPERM error for capabilities check of capability-dumb binaries
|
|
Michael Kerrisk
|
|
Add reference to ld-linux.so(8)
|
|
Michael Kerrisk
|
|
SEE ALSO: add system(3)
|
|
|
|
fanotify_init.2
|
|
Michael Kerrisk
|
|
Note kernel version that allowed O_CLOEXEC for event_f_flags
|
|
|
|
fcntl.2
|
|
flock.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add lslocks(8)
|
|
|
|
fcntl.2
|
|
Michael Kerrisk [Jason Vas Dias]
|
|
Rework description of F_SETOWN
|
|
As suggested by Jason, make it clearer that I/O signalling
|
|
requires the use of both F_SETOWN and O_ASYNC. While we're at,
|
|
make a few other cleanups to the text.
|
|
Michael Kerrisk
|
|
Remove mention of _BSD_SOURCE to get definition of F_SETOWN/F_GETOWN
|
|
This usage went away in glibc 2.20, and the simplest remedy
|
|
is just to omit mention of it.
|
|
|
|
futex.2
|
|
Michael Kerrisk
|
|
FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT
|
|
|
|
get_kernel_syms.2
|
|
Michael Kerrisk
|
|
Note that glibc des not support this system call
|
|
|
|
init_module.2
|
|
Michael Kerrisk
|
|
Glibc 2.23 removed last vestiges of support for this system call
|
|
|
|
ioctl_list.2
|
|
Heinrich Schuchardt
|
|
Include uapi/linux/wireless.h
|
|
Add the list of wireless IOCTLs.
|
|
Heinrich Schuchardt
|
|
Path to sockios.h
|
|
sockios.h is now in include/uapi
|
|
Heinrich Schuchardt
|
|
Add reference to netdevice.7
|
|
netdevice.7 describes most of the IOCTLs of sockios.h
|
|
Heinrich Schuchardt
|
|
Transfer structure (wireless.h IOCTLs)
|
|
The sole parameter to be passed to the wireless.h IOCTLs is
|
|
of type struct iwreq *.
|
|
|
|
ioperm.2
|
|
Michael Kerrisk [Alex Henrie]
|
|
ioperm.2: Permissions are inherited across fork(2)
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=99911
|
|
|
|
iopl.2
|
|
Michael Kerrisk [Alex Henrie]
|
|
Permissions are not inherited across fork(2) or preserved on execve(2)
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=99901
|
|
|
|
lseek.2
|
|
Michael Kerrisk
|
|
FUSE now supports SEEK_HOLE and SEEK_DATA
|
|
Michael Kerrisk
|
|
NFS supports SEEK_HOLE and SEEK_DATA
|
|
|
|
Michael Kerrisk
|
|
SEE ALSO: add open(2)
|
|
|
|
madvise.2
|
|
Michael Kerrisk
|
|
Clarify MADV_HWPOISON wording to say that it applies to a page range
|
|
|
|
mknod.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add mknod(1)
|
|
|
|
mount.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add findmnt(8)
|
|
|
|
open.2
|
|
Michael Kerrisk
|
|
NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
|
|
Mark Post [Petr Gajdos]
|
|
O_TMPFILE support is now provided bt Btrfs
|
|
|
|
pipe.2
|
|
Michael Kerrisk [Eric Blake]
|
|
Note treatment of 'pipefd' on error
|
|
|
|
poll.2
|
|
Michael Kerrisk [Josh Triplett]
|
|
Document spurious EAGAIN error that can occur on other systems
|
|
Light reworking of text proposed by Josh Triplett.
|
|
|
|
readlink.2
|
|
Michael Kerrisk
|
|
Clarify EINVAL error description
|
|
|
|
recv.2
|
|
Heinrich Schuchardt
|
|
Equivalence to read()
|
|
Describe the recv(2)-read(2) and the recvfrom(2)-recv(2)
|
|
equivalences for zero-valued arguments.
|
|
Michael Kerrisk
|
|
MSG_WAITALL has no effect for datagram sockets
|
|
|
|
recv.2
|
|
cmsg.3
|
|
Nikola Forró
|
|
Fix type of cmsg_len member of cmsghdr structure
|
|
The type shown for cmsg_len member of cmsghdr structure is socklen_t,
|
|
but the actual type used by glibc and the kernel is size_t.
|
|
The information was obtained from glibc source code:
|
|
http://bit.ly/21m1RMp
|
|
Michael Kerrisk
|
|
Note that cmsg_len is typed as socklen_t in POSIX.1
|
|
|
|
|
|
sched_setaffinity.2
|
|
Michael Kerrisk [Florian Weimer, Florian Weimer]
|
|
Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
|
|
Michael Kerrisk [Florian Weimer]
|
|
Add reference to CPU_ALLOC(3)
|
|
|
|
sched_setattr.2
|
|
Michael Kerrisk [Akihiro Suda]
|
|
EPERM depends on affinity mask of target thread, not calling thread
|
|
|
|
select.2
|
|
Michael Kerrisk [Josh Triplett]
|
|
Document spurious EAGAIN error that can occur on other systems
|
|
Light reworking of text proposed by Josh Triplett.
|
|
Nikos Mavrogiannopoulos
|
|
Mention the 'fd_set' size limitation early and refer to poll(2)
|
|
Change this because of the serious limitation of select()
|
|
imposing a limit on the range of file descriptors that can
|
|
be monitored. This is currently mentioned too late in the
|
|
documentation (in the NOTES section). The man page should
|
|
warn early and refer to poll(2) as soon as possible.
|
|
Michael Kerrisk
|
|
Add details on the glibc fixed-size fd_set limitation
|
|
No modern application should use select() on Linux.
|
|
|
|
select_tut.2
|
|
Michael Kerrisk
|
|
Some readability fixes to example program
|
|
Michael Kerrisk
|
|
Better variable names in example program
|
|
Michael Kerrisk
|
|
Simplify 'if' logic in in example program
|
|
Michael Kerrisk
|
|
Use correct type (socklen_t) for addrlen
|
|
|
|
semctl.2
|
|
Michael Kerrisk [Davidlohr Bueso, Manfred Spraul, Philip Semanchuk]
|
|
NOTES: note when 'sempid' is set on various implementations
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and
|
|
http://thread.gmane.org/gmane.linux.kernel/2162754/
|
|
Subject: [PATCH] Don't set sempid in semctl syscall.
|
|
Date: 2016-02-26 12:21:38 GMT
|
|
|
|
semop.2
|
|
Michael Kerrisk
|
|
Tweak comment describing 'sempid'
|
|
|
|
sendfile.2
|
|
Askar Safin
|
|
Fix incorrect description in text referring to splice(2)
|
|
Michael Kerrisk
|
|
SEE ALSO: add copy_file_range(2)
|
|
|
|
setpgid.2
|
|
Michael Kerrisk
|
|
Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()
|
|
|
|
signalfd.2
|
|
Michael Kerrisk
|
|
Note that signalfd info is available in /proc/PID/fdinfo
|
|
|
|
sigprocmask.2
|
|
Michael Kerrisk [Mike Frysinger]
|
|
Explicitly refer the reader to sigsetops(3)
|
|
This man page did not make it obvious which functions
|
|
should be used for manipulating signals sets, nor where
|
|
those functions were documented.
|
|
|
|
socketpair.2
|
|
Michael Kerrisk [Eric Blake]
|
|
Note treatment of 'sv' on error
|
|
|
|
splice.2
|
|
Askar Safin
|
|
Improve description of 0 return value.
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=90911
|
|
|
|
statfs.2
|
|
Michael Kerrisk [Jakub Wilk]
|
|
Use consistent case for hex constants
|
|
|
|
sync.2
|
|
Christoph Hellwig
|
|
Clarify description and document the Linux data integrity guarantees
|
|
|
|
syscall.2
|
|
Mike Frysinger
|
|
Add more architectures and improve error documentation
|
|
Move the error register documentation into the main table rather
|
|
than listing them in sentences after the fact.
|
|
|
|
Add sparc error return details.
|
|
|
|
Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
|
|
tile/xtensa.
|
|
|
|
syscalls.2
|
|
Michael Kerrisk
|
|
Add copy_file_range(2)
|
|
|
|
times.2
|
|
Kondo, Naoya
|
|
Fix an incorrect description in NOTES
|
|
The text has an incorrect description in NOTES, it says
|
|
that (2^32/HZ) - 300 is about 429 million. It is correct
|
|
only if HZ=10 which does not look common today. So just
|
|
removing "(i.e., about 429 million)" is good enough.
|
|
|
|
truncate.2
|
|
Michael Kerrisk
|
|
SEE ALSO: add truncate(1)
|
|
|
|
uselib.2
|
|
Michael Kerrisk
|
|
Mention CONFIG_USELIB
|
|
Michael Kerrisk
|
|
Note that glibc does not support this (obsolete) system call
|
|
|
|
wait.2
|
|
wait4.2
|
|
Michael Kerrisk
|
|
Rename the "status" argument to "wstatus"
|
|
The fact that exit(3)/_exit(2) has an argument called
|
|
"status" and the same name is used in the arguments to the
|
|
wait*() calls can a little too easily lead the user into
|
|
thinking that the two arguments hold the same information,
|
|
when of course they don't. So, use a different name
|
|
for the argument of the wait*() functions, to reduce
|
|
the chances of such confusion.
|
|
|
|
backtrace.3
|
|
Michael Kerrisk [Martin Gebert]
|
|
Small fixes to example program
|
|
|
|
clearenv.3
|
|
Michael Kerrisk [Matt Zimmerman]
|
|
Clarify the use and effect of clearenv()
|
|
See http://bugs.debian.org/679323
|
|
Michael Kerrisk
|
|
Variables can be added to the environment after calling clearenv()
|
|
|
|
clog10.3
|
|
Michael Kerrisk
|
|
Show an alternative equivalence for clog10()
|
|
Michael Kerrisk
|
|
Update CONFORMING TO
|
|
Fix grammar error and add C11.
|
|
|
|
dl_iterate_phdr.3
|
|
Michael Kerrisk [Paul Pluzhnikov]
|
|
Describe 'struct dl_phdr_info' fields added in glibc 2.4
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=103011
|
|
Michael Kerrisk [Simon Que]
|
|
Note that first object visited by 'callback' is the main program
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=94141
|
|
|
|
errno.3
|
|
Michael Kerrisk
|
|
Add some explanation of ENOENT error
|
|
|
|
exec.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add system(3)
|
|
|
|
exp.3
|
|
Michael Kerrisk [Joachim Wuttke]
|
|
SEE ALSO: add expm1(3)
|
|
|
|
fopen.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add open_memstream(3)
|
|
|
|
fts.3
|
|
Michael Kerrisk
|
|
BUGS: glibc-2.23 now has LFS support for the fts functions
|
|
|
|
gamma.3
|
|
Michael Kerrisk [Alan Cox]
|
|
gamma() was documented in SVID 2
|
|
|
|
getaddrinfo.3
|
|
Michael Kerrisk [Andreas Schwab, Orion Poplawski]
|
|
Update FTM requirements for glibc 2.22
|
|
Since glibc 2.22 getaddrinfo() etc. are only declared for
|
|
POSIX.1-2001 or later.
|
|
|
|
getcwd.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add pwd(1)
|
|
|
|
opendir.3
|
|
Michael Kerrisk
|
|
Help the reader by explicitly mentioning the use of readdir(3)
|
|
|
|
perror.3
|
|
Michael Kerrisk
|
|
Suggest use of strerror(3) in place of deprecated 'sys_errlist'
|
|
|
|
posix_fallocate.3
|
|
Jérémie Galarneau
|
|
ERRORS: add EINTR
|
|
The glibc implementation of posix_fallocate(), which calls
|
|
fallocate(), may be interrupted. The fallocate() emulation
|
|
also makes use of pread()/pwrite(), which may also be
|
|
interrupted.
|
|
|
|
posix_memalign.3
|
|
Michael Kerrisk [Eric Blake]
|
|
Note posix_memalign()'s treatment of 'memptr' on error
|
|
|
|
pthread_setaffinity_np.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add CPU_SET(3)
|
|
|
|
queue.3
|
|
Dr. Tobias Quathamer
|
|
Remove double CONFORMING TO section
|
|
|
|
rcmd.3
|
|
Nikola Forró
|
|
Add missing condition concerning .rhosts file
|
|
The list of conditions determining if iruserok() and ruserok()
|
|
functions automatically fail is incomplete. According to glibc
|
|
source code, the functions also fail if the .rhosts file
|
|
is hard linked anywhere.
|
|
|
|
setbuf.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add stdbuf(1)
|
|
|
|
setjmp.3
|
|
Michael Kerrisk
|
|
Rewrite and merge longjmp()/siglongjmp() discussion into this page
|
|
The discussion of nonlocal gotos is much easier to read if
|
|
setjmp() and longjmp() are discussed in the same page. While
|
|
we're at it, rework almost the entire text and add several
|
|
more details.
|
|
Michael Kerrisk
|
|
Note the interactions of longjmp() and non-async-signal-safe functions
|
|
POSIX.1-2008 TC2 adds explicit text on this point.
|
|
See http://austingroupbugs.net/view.php?id=516#c1195
|
|
Michael Kerrisk
|
|
Explain why nonlocal gotos make code harder to maintain
|
|
Michael Kerrisk
|
|
Reword warning on longjmp() to function that has already returned
|
|
Michael Kerrisk
|
|
Remove reference to obsolete _XOPEN_SOURCE_EXTENDED
|
|
|
|
sleep.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add sleep(1)
|
|
|
|
strftime.3
|
|
Michael Kerrisk [Jeremy Harris]
|
|
Note which 'tm' fields are used to calculate each output string
|
|
See https://bugzilla.redhat.com/show_bug.cgi?id=1162218
|
|
|
|
strlen.3
|
|
Michael Kerrisk [Alan Aversa]
|
|
CONFORMING TO: add C11
|
|
|
|
system.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add execve(2)
|
|
|
|
termios.3
|
|
Dr. Tobias Quathamer
|
|
Document line length in canonical mode
|
|
See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
|
|
See https://bugs.debian.org/797479
|
|
Michael Kerrisk
|
|
SEE ALSO: add tty(1)
|
|
Michael Kerrisk [Peter Hurley]
|
|
Further improvements to recent tweaks of canonical mode 4096 char limit
|
|
|
|
timegm.3
|
|
Michael Kerrisk [Stephen Hurd, Mats Wichmann]
|
|
Remove sample implementation of timegm()
|
|
Stephen and Mats both question the wisdom of showing a portable
|
|
*non-thread-safe* implementation of timegm(), and I find it
|
|
hard to disagree. So, remove this code.
|
|
|
|
See https://bugzilla.kernel.org/show_bug.cgi?id=103701
|
|
Michael Kerrisk
|
|
Expand DESCRIPTION a little
|
|
|
|
st4.4
|
|
Dr. Tobias Quathamer
|
|
Remove spurious copyright section
|
|
|
|
tty_ioctl.4
|
|
Michael Kerrisk
|
|
SEE ALSO: add ldattach(1)
|
|
|
|
elf.5
|
|
Michael Kerrisk [Gabriel Corona, Mike Frysinger]
|
|
Fix description of STV_PROTECTED
|
|
Michael Kerrisk
|
|
Improve description of STV_DEFAULT
|
|
Michael Kerrisk
|
|
Improve description of STV_HIDDEN
|
|
Chris Pick
|
|
Remove erroneous, duplicate SHN_* section
|
|
Michael Kerrisk [Chris Pick]
|
|
Reword discussion of range values a little
|
|
|
|
gai.conf.5
|
|
Michael Kerrisk
|
|
Add VERSIONS section
|
|
|
|
group.5
|
|
Michael Kerrisk
|
|
SEE ALSO: add groups(2)
|
|
SEE ALSO: add gpasswd(1)
|
|
SEE ALSO: add sg(1)
|
|
SE ALSO: add gshadow(5)
|
|
SEE ALSO: add chgrp(1)
|
|
|
|
locale.5
|
|
Marko Myllynen [Mike Frysinger]
|
|
tel + fax are deprecated
|
|
|
|
nsswitch.conf.5
|
|
Nikola Forró
|
|
Update NSS compatibility mode description
|
|
|
|
utmp.5
|
|
Michael Kerrisk
|
|
SEE ALSO: add lslogins(1)
|
|
|
|
aio.7
|
|
Andreas Gruenbacher
|
|
Improve example
|
|
When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal
|
|
handlers called for asynchronous I/O operations will have
|
|
si->si_code set to SI_ASYNCIO. Check to make sure that
|
|
si->si_value.sival_ptr is defined.
|
|
|
|
capabilities.7
|
|
Michael Kerrisk
|
|
Explain safety check for capability-dumb binaries
|
|
Michael Kerrisk
|
|
SEE ALSO: add sg(1), su(1)
|
|
SEE ALSO: add id(1), group(5), passwd(5)
|
|
|
|
credentials.7
|
|
Michael Kerrisk
|
|
SEE ALSO: add groups(2)
|
|
|
|
environ.7
|
|
Michael Kerrisk
|
|
Describe the Bourne "NAME=value command" syntax
|
|
Michael Kerrisk
|
|
Add some details describing hos shell's environment is initialized
|
|
Michael Kerrisk
|
|
Note that child of fork(2) inherits copy of parent's environment
|
|
Michael Kerrisk
|
|
SEE ALSO: add pam_env(3)
|
|
|
|
epoll.7
|
|
Michael Kerrisk
|
|
Mention that epoll info is available via /proc/PID/fdinfo
|
|
|
|
fanotify.7
|
|
Michael Kerrisk
|
|
Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries
|
|
|
|
|
|
feature_test_macros.7
|
|
Michael Kerrisk
|
|
Add a summary of some FTM key points
|
|
Michael Kerrisk
|
|
Give an early hint about some macros being defined by default
|
|
Michael Kerrisk
|
|
Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
|
|
Emphasize that defining _XOPEN_SOURCE >=500 produces same
|
|
effects as defining _XOPEN_SOURCE_EXTENDED.
|
|
Michael Kerrisk
|
|
Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
|
|
As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
|
|
has generally been removed from the man pages.
|
|
Michael Kerrisk
|
|
Note effects of "cc -std=c99" and "cc -std=c11"
|
|
Michael Kerrisk
|
|
Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
|
|
Michael Kerrisk
|
|
Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
|
|
Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
|
|
in the standard.
|
|
|
|
inotify.7
|
|
Michael Kerrisk
|
|
Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries
|
|
|
|
ip.7
|
|
Eric Dumazet
|
|
Document IP_BIND_ADDRESS_NO_PORT socket option
|
|
|
|
mq_overview.7
|
|
Michael Kerrisk
|
|
Note that the close-on-exec flag is automatically set on MQ descriptors
|
|
|
|
namespaces.7
|
|
Michael Kerrisk
|
|
SEE ALSO: add lsns(1)
|
|
lsns(1) was recently added in util-linux, probably to appear
|
|
in next release (2.28?).
|
|
|
|
pipe.7
|
|
Michael Kerrisk [Jason Vas Dias]
|
|
Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC
|
|
Michael Kerrisk
|
|
SEE ALSO: add mkfifo(1)
|
|
|
|
signal.7
|
|
Michael Kerrisk
|
|
Note the interactions of longjmp() and non-async-signal-safe functions
|
|
See http://austingroupbugs.net/view.php?id=516#c1195.
|
|
|
|
socket.7
|
|
Michael Kerrisk
|
|
SEE ALSO: add pcap(3)
|
|
SEE ALSO: add wireshark(1) and tcpdump(8)
|
|
|
|
standards.7
|
|
Michael Kerrisk
|
|
Add POSIX.1-2008 TC2 (POSIX.1-2016)
|
|
|
|
svipc.7
|
|
Michael Kerrisk
|
|
Tweak description of 'sempid'
|
|
Michael Kerrisk
|
|
SEE ALSO: add lsipc(1)
|
|
|
|
symlink.7
|
|
Michael Kerrisk [Zefram]
|
|
Some "magic" symlinks have permissions other than 0777
|
|
See https://bugs.debian.org/743525
|
|
|
|
time.7
|
|
Michael Kerrisk
|
|
SEE ALSO: add timeout(1)
|
|
SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3)
|
|
|
|
unicode.7
|
|
Dr. Tobias Quathamer
|
|
Document private use areas
|
|
See https://bugs.debian.org/285444
|
|
|
|
unix.7
|
|
Heinrich Schuchardt
|
|
Add example
|
|
A complete example demonstrating the usage of sockets for local
|
|
interprocess communication is added.
|
|
Michael Kerrisk
|
|
Introduce term "sequenced-packet" for SOCK_SEQPACKET
|
|
Michael Kerrisk
|
|
Some wording improvements
|