Start of man-pages-3.17: updating Changes and Changes.old

This commit is contained in:
Michael Kerrisk 2009-01-13 10:40:27 +13:00
parent 3f4ccc7aba
commit 364d1652dc
2 changed files with 165 additions and 129 deletions

131
Changes
View File

@ -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 <cjwatson@ubuntu.com>
Florentin Duneau <fduneau@gmail.com>
Petr Baudis <pasky@suse.cz>
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 <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.

View File

@ -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 <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.