-==================== Changes in man-pages-4.05 ====================
+==================== Changes in man-pages-5.01 ====================
Released: ????-??-??, Munich
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