-==================== Changes in man-pages-4.02 ====================
+==================== Changes in man-pages-5.02 ====================
Released: ????-??-??, Munich
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.