==================== 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 Daniel Borkmann David Rientjes Dilyan Palauzov Gabriel F. T. Gomes Gleb Fotengauer-Malinovskiy Goswin von Brederlow Heinrich Schuchardt Jonathan David Amery Michael Kerrisk Mike Frysinger Mike Kravetz Nicholas Miell Nikola Forró Sam Varshavchik Yaarit Zeng Linggang 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.