This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
man-pages-4.05 released
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: linux-man <linux-man at vger dot kernel dot org>, libc-alpha <libc-alpha at sourceware dot org>
- Cc: mtk dot manpages at gmail dot com
- Date: Tue, 15 Mar 2016 21:15:30 +1300
- Subject: man-pages-4.05 released
- Authentication-results: sourceware.org; auth=none
Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-4.05 - man pages for Linux
This release includes input and contributions from
nearly 70 people. Over 400 pages saw changes, ranging
from typo fixes through to page rewrites and newly
created pages.
Tarball download:
http://www.kernel.org/doc/man-pages/download.html
Git repository:
https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
http://man7.org/linux/man-pages/changelog.html#release_4.05
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2016/03/man-pages-405-is-released.html
The current version of the pages is browsable at:
http://man7.org/linux/man-pages/
You are receiving this message either because:
a) You contributed to the content of this release.
b) You are subscribed to linux-man@vger.kernel.org or
libc-alpha@sourceware.org.
c) I have information (possibly inaccurate) that you are the maintainer
of a translation of the manual pages, or are the maintainer of the
manual pages set in a particular distribution, or have expressed
interest in helping with man-pages maintenance, or have otherwise
expressed interest in being notified about man-pages releases.
If you don't want to receive such messages from me, or you know of
some other translator or maintainer who may want to receive such
notifications, send me a message.
Cheers,
Michael
==================== 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