mirror of https://github.com/mkerrisk/man-pages
366 lines
11 KiB
Plaintext
366 lines
11 KiB
Plaintext
==================== Changes in man-pages-4.02 ====================
|
|
|
|
Released: 2015-08-08, Munich
|
|
|
|
|
|
Contributors
|
|
------------
|
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
|
in the changelog below) reports, notes, and ideas that have been
|
|
incorporated in changes in this release:
|
|
|
|
Carlos O'Donell <carlos@redhat.com>
|
|
Daniel Borkmann <daniel@iogearbox.net>
|
|
David Rientjes <rientjes@google.com>
|
|
Dilyan Palauzov <dilyan.palauzov@aegee.org>
|
|
Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
|
|
Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
|
|
Goswin von Brederlow <goswin-v-b@web.de>
|
|
Heinrich Schuchardt <xypron.glpk@gmx.de>
|
|
Jonathan David Amery <jdamery@ysolde.ucam.org>
|
|
Michael Kerrisk <mtk.manpages@gmail.com>
|
|
Mike Frysinger <vapier@gentoo.org>
|
|
Mike Kravetz <mike.kravetz@oracle.com>
|
|
Nicholas Miell <nmiell@gmail.com>
|
|
Nikola Forró <nforro@redhat.com>
|
|
Sam Varshavchik <mrsam@courier-mta.com>
|
|
Yaarit <yaarit@gmail.com>
|
|
Zeng Linggang <zenglg.jy@cn.fujitsu.com>
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
New and rewritten pages
|
|
-----------------------
|
|
|
|
dladdr.3
|
|
Michael Kerrisk
|
|
New page documenting dladdr() and dladdr1()
|
|
Relocate/rewrite dladdr() text formerly contained in dlopen(3).
|
|
|
|
Add documentation of dladdr1().
|
|
Zeng Linggang
|
|
ATTRIBUTES: Note functions that are thread-safe
|
|
|
|
dlerror.3
|
|
Michael Kerrisk
|
|
Migrate dlerror(3) to new separate man page
|
|
Michael Kerrisk
|
|
Note that the returned message may be in a statically allocated buffer
|
|
Michael Kerrisk
|
|
Note that the returned string does not include a trailing newline
|
|
Zeng Linggang
|
|
ATTRIBUTES: Note function that is thread-safe
|
|
|
|
dlinfo.3
|
|
Michael Kerrisk
|
|
New page describing dlinfo(3)
|
|
Zeng Linggang
|
|
ATTRIBUTES: Note function that is thread-safe
|
|
|
|
dlopen.3
|
|
Michael Kerrisk
|
|
This page was substantially rewritten and enhanced. Notably:
|
|
* the dladdr(), dlsym, dlvsym(), and dlerror() content were moved
|
|
to separate new pages;
|
|
* documentation for dlmopen was added;
|
|
* and other changes as noted below.
|
|
Zeng Linggang
|
|
ATTRIBUTES: Note functions that are thread-safe
|
|
Michael Kerrisk
|
|
Move atexit() discussion under "Initialization and Finalization"
|
|
Michael Kerrisk
|
|
Move discussion of _init() and _fini() to NOTES
|
|
Michael Kerrisk
|
|
Rework the discussion of initialization and finalization functions
|
|
Deemphasize the obsolete _init/_fini and give more prominence
|
|
to gcc constructors/destructors.
|
|
Michael Kerrisk
|
|
dlclose() will unload the object when all references have been released
|
|
Michael Kerrisk
|
|
EXAMPLE: Remove mention of "-rdynamic"
|
|
That option isn't needed for compiling and running this program.
|
|
Michael Kerrisk
|
|
Remove reference to ld.so info page
|
|
The command "info ld.so" simply shows the man page...
|
|
Michael Kerrisk
|
|
Add VERSIONS section
|
|
Michael Kerrisk
|
|
Reorganize conformance information for 'flags'
|
|
|
|
dlsysm.3
|
|
Michael Kerrisk
|
|
Move dlsym() and dlvsym() content to new separate page
|
|
Zeng Linggang
|
|
ATTRIBUTES: Note functions that are thread-safe
|
|
|
|
|
|
Newly documented interfaces in existing pages
|
|
---------------------------------------------
|
|
|
|
dlopen.3
|
|
Michael Kerrisk, Carlos O'Donell
|
|
Document dlmopen(3)
|
|
|
|
nl_langinfo.3
|
|
Sam Varshavchik, Michael Kerrisk
|
|
Add documentation for nl_langinfo_l(3)
|
|
|
|
__ppc_set_ppr_med.3
|
|
Gabriel F. T. Gomes
|
|
Document PPC functions providing access to PPR
|
|
GNU C Library 2.18 adds functions (__ppc_set_ppr_low(3),
|
|
__ppc_set_ppr_med(3), __ppc_set_ppr_med_low(3)) that provide
|
|
access to the Program Priority Register (PPR).
|
|
|
|
__ppc_yield.3
|
|
Gabriel F. T. Gomes
|
|
Document PPC performance-hint functions
|
|
GNU C Library 2.18 adds functions __ppc_yield(3), __ppc_mdoio(3),
|
|
and __ppc_mdoom(3) that can be used provide a hint that
|
|
performance could be improved if shared resources are released
|
|
for use by other processors.
|
|
|
|
|
|
New and changed links
|
|
---------------------
|
|
|
|
dladdr1.3
|
|
Michael Kerrisk
|
|
New link to (new) dladdr(3) page
|
|
|
|
dlmopen.3
|
|
Michael Kerrisk
|
|
New link to dlopen.3
|
|
|
|
dlvsym.3
|
|
Michael Kerrisk
|
|
Adjust link to point to new self-contained dlsym(3) page
|
|
|
|
nl_langinfo_l.3
|
|
Michael Kerrisk
|
|
New link to nl_langinfo.3
|
|
|
|
__ppc_mdoio.3
|
|
Gabriel F. T. Gomes
|
|
New link to __ppc_yield.3
|
|
|
|
__ppc_mdoom.3
|
|
Gabriel F. T. Gomes
|
|
New link to __ppc_yield.3
|
|
|
|
__ppc_set_ppr_low.3
|
|
Gabriel F. T. Gomes
|
|
New link to __ppc_set_ppr_med.3
|
|
|
|
__ppc_set_ppr_med_low.3
|
|
Gabriel F. T. Gomes
|
|
New link to __ppc_set_ppr_med.3
|
|
|
|
|
|
Global changes
|
|
--------------
|
|
|
|
Very many pages
|
|
Michael Kerrisk
|
|
Update CONFORMING TO section to reflect POSIX.1-2001 and POSIX.1-2008
|
|
details. (By now, I believe all pages should be up to date with
|
|
respect to appropriately mentioning POSIX.1-2001 and POSIX.1-2008.)
|
|
|
|
ldd.1
|
|
sprof.1
|
|
execve.2
|
|
dlopen.3
|
|
ld.so.8
|
|
Michael Kerrisk
|
|
Prefer "shared object" over "shared library"
|
|
The man pages variously use "shared library" or "shared object".
|
|
Try to more consistently use one term ("shared object"), while
|
|
also pointing out on a few pages that the terms are synonymous.
|
|
|
|
|
|
Changes to individual pages
|
|
---------------------------
|
|
|
|
accept.2
|
|
Michael Kerrisk
|
|
Add mention of POSIX.1-2008 regarding EAGAIN vs EWOULDBLOCK
|
|
|
|
bpf.2
|
|
Daniel Borkmann
|
|
Various updates/follow-ups to address some fixmes
|
|
A couple of follow-ups to the bpf(2) man-page, besides others:
|
|
|
|
* Description of map data types
|
|
* Explanation on eBPF tail calls and program arrays
|
|
* Paragraph on tc holding ref of the eBPF program in the kernel
|
|
* Updated ASCII image with tc ingress and egress invocations
|
|
* __sync_fetch_and_add() and example usage mentioned on arrays
|
|
* minor reword on the licensing and other minor fixups
|
|
|
|
execve.2
|
|
Michael Kerrisk
|
|
Reword text on POSIX and #!
|
|
|
|
io_getevents.2
|
|
Michael Kerrisk
|
|
Note return value on interruption by a signal handler
|
|
Michael Kerrisk
|
|
Clarify details of return value for timeout-expired case
|
|
Michael Kerrisk
|
|
Clarify and extend discussion of 'timeout' argument
|
|
|
|
mmap.2
|
|
Michael Kerrisk
|
|
Note that 'length' need not be a page-size multiple for munmap()
|
|
Michael Kerrisk [David Rientjes, David Rientjes, Mike Kravetz]
|
|
Describe mmap()/munmap() argument requirements for huge-page mappings
|
|
Michael Kerrisk
|
|
Move discussion of timestamps to NOTES
|
|
A straight move; no changes to the content.
|
|
This content is better placed in NOTES.
|
|
|
|
seccomp.2
|
|
Michael Kerrisk
|
|
SEE ALSO: mention libseccomp pages
|
|
SEE ALSO: add scmp_sys_resolver(1)
|
|
|
|
sigaction.2
|
|
Michael Kerrisk
|
|
Correct the list of flags that were added in POSIX.1-2001
|
|
|
|
socketpair.2
|
|
Michael Kerrisk [Goswin von Brederlow]
|
|
Clarify use of SOCK_* flags in 'type' argument
|
|
See http://bugs.debian.org/794217
|
|
|
|
atexit.3
|
|
Michael Kerrisk
|
|
SEE ALSO: add dlopen(3)
|
|
|
|
clock_getcpuclockid.3
|
|
Michael Kerrisk
|
|
Improve wording of EPERM error
|
|
It's imprecise to say that this is an "optional" error
|
|
in POSIX.1.
|
|
|
|
dl_iterate_phdr.3
|
|
Michael Kerrisk
|
|
Note that 'size' allows callback() to discover structure extensions
|
|
Michael Kerrisk
|
|
SEE ALSO: add dladdr(3)
|
|
Michael Kerrisk
|
|
CONFORMING TO: note that this function appears on some other systems
|
|
|
|
fseeko.3
|
|
Michael Kerrisk
|
|
Remove crufty NOTES section
|
|
This ancient System V detail is unneeded.
|
|
|
|
getutent.3
|
|
Michael Kerrisk
|
|
Mention POSIX.1-2008 for the "utmpx" functions
|
|
|
|
iconv_close.3
|
|
iconv_open.3
|
|
Michael Kerrisk
|
|
CONFORMING TO: change "UNIX98" to "SUSv2"
|
|
|
|
malloc.3
|
|
Michael Kerrisk
|
|
Change "UNIX 9*" to "SUSv2"
|
|
|
|
mktemp.3
|
|
Gleb Fotengauer-Malinovskiy
|
|
Reference mkdtemp(3) in addition to mkstemp(3)
|
|
Mention mkdtemp(3) as another secure alternative to mktemp(3).
|
|
|
|
See also https://sourceware.org/bugzilla/show_bug.cgi?id=2898.
|
|
|
|
mq_receive.3
|
|
mq_send.3
|
|
Michael Kerrisk
|
|
Clarify discussion of 'timeout'
|
|
In particular, remove the word 'ceiling', which falsely
|
|
suggests that the call might return prematurely.
|
|
|
|
nl_langinfo.3
|
|
Michael Kerrisk
|
|
Explicitly describe the return value on success
|
|
Michael Kerrisk
|
|
POSIX specifies that the caller may not modify the returned string
|
|
Michael Kerrisk
|
|
Enhance RETURN VALUE description
|
|
Note some further cases where returned string may be
|
|
invalidated or overwritten.
|
|
|
|
perror.3
|
|
Michael Kerrisk
|
|
Reformat CONFORMING to information
|
|
Michael Kerrisk
|
|
Note that 'sys_errlist' and 'sys_nerr' are not in POSIX.1
|
|
|
|
posix_openpt.3
|
|
Michael Kerrisk
|
|
Reword text regarding systems that don't have posix_openpt()
|
|
|
|
printf.3
|
|
Michael Kerrisk
|
|
CONFORMING TO: update details for dprintf() and vdprintf()
|
|
|
|
setlogmask.3
|
|
Michael Kerrisk
|
|
Remove useless statement in CONFORMING TO
|
|
Saying that the description in PSOX.1-2001 is flawed,
|
|
without saying what the fla is, is not helpful.
|
|
(And no, I don't know what the flaw is.)
|
|
|
|
shm_open.3
|
|
Michael Kerrisk
|
|
Add POSIX.1-2008 details regarding group ID of new shared memory object
|
|
|
|
strfmon.3
|
|
Michael Kerrisk
|
|
Fix erroneous CONFORMING to
|
|
strfmon() is in POSIX.1.
|
|
|
|
fanotify.7
|
|
Heinrich Schuchardt
|
|
Clarify effects of file moves
|
|
If files or directories are moved to other mounts, the inode is
|
|
deleted. Fanotify marks are lost.
|
|
|
|
mq_overview.7
|
|
Michael Kerrisk
|
|
Remove unneeded CONFORMING TO section
|
|
|
|
nptl.7
|
|
Michael Kerrisk [Nicholas Miell]
|
|
Note that i386 and x86-64 binaries can't share mutexes
|
|
|
|
sched.7
|
|
Nikola Forró
|
|
Fix descriptions of sched_get_priority_max() / sched_get_priority_min()
|
|
|
|
sem_overview.7
|
|
Michael Kerrisk
|
|
Remove unneeded CONFORMING TO section
|
|
|
|
shm_overview.7
|
|
Michael Kerrisk
|
|
Remove unneeded CONFORMING TO section
|
|
|
|
sigevent.7
|
|
Michael Kerrisk
|
|
Remove unneeded CONFORMING TO section
|
|
|
|
symlink.7
|
|
Michael Kerrisk
|
|
Update with POSIX.1-2008 details for link(2)
|
|
|
|
ld.so.8
|
|
Michael Kerrisk [Jonathan David Amery]
|
|
Items in LD_LIBRARY_PATH can also be delimited by semicolons
|
|
See http://bugs.debian.org/794559.
|