==================== Changes in man-pages-3.16 ====================

Released: 2009-01-13, Christchurch


Contributors
------------

The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:

Colin Watson <cjwatson@ubuntu.com>
Florentin Duneau <fduneau@gmail.com>
Petr Baudis <pasky@suse.cz>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

pthread_getcpuclockid.3
    Michael Kerrisk
        New page documenting pthread_getcpuclockid(3)

libc.7
    Michael Kerrisk
        New page giving brief overview of C libraries on Linux

rtld-audit.7
    Michael Kerrisk
        New page documenting dynamic linker audting API


Newly documented interfaces in existing pages
---------------------------------------------

ld.so.8
    Petr Baudis
        Document LD_AUDIT
    Petr Baudis
        Document LD_POINTER_GUARD


New and changed links
---------------------

gethostid.2
    Michael Kerrisk
        New link to new page location in Section 3

sethostid.2
    Michael Kerrisk
        Change link to point to new page location in Section 3

sethostid.3
    Michael Kerrisk
        New link to relocated page in Section 3

glibc.7
    Michael Kerrisk
        New link to new libc.7


Global changes
--------------

syscalls.2
feature_test_macros.7
standards.7
    Michael Kerrisk
        SEE ALSO: add libc(7)

dlopen.3
ld.so.8
    Michael Kerrisk
        SEE ALSO: add rtld-audit(7)


Changes to individual pages
---------------------------

gethostid.2
    Michael Kerrisk
        Move to Section 3
            The interfaces documented in this page are purely glibc.

syscalls.2
    Michael Kerrisk
        Kernel 2.6.28 adds accept4()

clock_getres.3
    Michael Kerrisk
        SEE ALSO: Add pthread_getcpuclockid(3)

fmemopen.3
    Michael Kerrisk
        Fix VERSIONS information

gethostid.3
    Michael Kerrisk
        Before version 2.2, glibc stored the host ID in /var/adm/hostid
            Also: rewrite some text describing the /etc/hostid file, so that
            this location is referred to just once on the page.
    Michael Kerrisk
        RETURN VALUE: describe return value of sethostid()
    Michael Kerrisk
        Added BUGS section noting that ID can't be guaranteed to be unique
    Michael Kerrisk
        Added ERRORS section describing errors for sethostid()
    Michael Kerrisk
        Update section number to reflect relocation into Section 3

printf.3
    Michael Kerrisk
        Source and destination buffers may not overlap for *s*printf()
            http://sourceware.org/bugzilla/show_bug.cgi?id=7075

            Some existing code relies on techniques like the following to
            append text to a buffer:

                $ cat s.c
                #include <stdio.h>
                char buf[80] = "not ";
                main()
                {
                    sprintf(buf, "%sfail", buf);
                puts(buf);
                return 0;
                }

                $ cc s.c
                $ ./a.out
                not fail

            However, the standards say the results are undefined if source
            and destination buffers overlap, and with suitable compiler
            options, recent changes can cause unexpected results:

                $ cc -v 2>&1 | grep gcc
                gcc version 4.3.1 20080507 (prerelease) [gcc-4_3-branch revision 135036] (SUSE Linux)
                $ cc -D_FORTIFY_SOURCE -O2 s.c
                $ ./a.out
                fail

readdir.3
    Michael Kerrisk
        Rewrite text describing 'dirent' fields standardized in POSIX.1
    Michael Kerrisk
        Clarify text for return value/errno setting for end-of-stream case

nscd.8
    Petr Baudis
        Correct NOTES section on reloading configuration files
            It behaved this way at least since
            "Sun Oct 18 15:02:11 1998 +0000",
            some four months after including the nscd implementation
            in glibc. But there does seem to be a short window between
            glibc-2.1 and glibc-2.1.3 when nscd -i was not available,
            I don't think it's worth muddling the point of the page
            with that, though.
