From 364d1652dcb7ea4d1ff26c4e79e11c47c23ff0b5 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 13 Jan 2009 10:40:27 +1300 Subject: [PATCH] Start of man-pages-3.17: updating Changes and Changes.old --- Changes | 131 +---------------------------------------- Changes.old | 163 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 165 insertions(+), 129 deletions(-) diff --git a/Changes b/Changes index 8cda84159..e276215c6 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.16 ==================== +==================== Changes in man-pages-3.17 ==================== -Released: 2009-01-13, Christchurch +Released: ????-??-??, Christchurch Contributors @@ -9,9 +9,6 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: -Colin Watson -Florentin Duneau -Petr Baudis Apologies if I missed anyone! @@ -19,143 +16,19 @@ 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 - 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. diff --git a/Changes.old b/Changes.old index bd3332fba..a0ac8fd24 100644 --- a/Changes.old +++ b/Changes.old @@ -17143,3 +17143,166 @@ unix.7 Retitled subsection "(Un)supported features" to "Sockets API" This is consistent with the recent change in tcp(7). + + +==================== 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 +Florentin Duneau +Petr Baudis + +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 + 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.