diff --git a/Changes b/Changes index 96d145a42..51c88c2ef 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-4.02 ==================== +==================== Changes in man-pages-4.03 ==================== -Released: 2015-08-08, Munich +Released: ????-??-??, Munich Contributors @@ -10,23 +10,6 @@ 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! @@ -34,332 +17,19 @@ 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. diff --git a/Changes.old b/Changes.old index deae8eb9f..82918ee33 100644 --- a/Changes.old +++ b/Changes.old @@ -39498,3 +39498,370 @@ vdso.7 Accepted kernel submission: http://lists.infradead.org/pipermail/linux-arm-kernel/2015-March/332573.html + + +==================== 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.