mirror of https://github.com/mkerrisk/man-pages
Start of man-pages-3.17: updating Changes and Changes.old
This commit is contained in:
parent
3f4ccc7aba
commit
364d1652dc
131
Changes
131
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
|
Contributors
|
||||||
|
@ -9,9 +9,6 @@ Contributors
|
||||||
The following people contributed notes, ideas, or patches that have
|
The following people contributed notes, ideas, or patches that have
|
||||||
been incorporated in changes in this release:
|
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!
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
@ -19,143 +16,19 @@ Apologies if I missed anyone!
|
||||||
New and rewritten pages
|
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
|
Newly documented interfaces in existing pages
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
ld.so.8
|
|
||||||
Petr Baudis
|
|
||||||
Document LD_AUDIT
|
|
||||||
Petr Baudis
|
|
||||||
Document LD_POINTER_GUARD
|
|
||||||
|
|
||||||
|
|
||||||
New and changed links
|
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
|
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
|
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.
|
|
||||||
|
|
163
Changes.old
163
Changes.old
|
@ -17143,3 +17143,166 @@ unix.7
|
||||||
Retitled subsection "(Un)supported features" to "Sockets API"
|
Retitled subsection "(Un)supported features" to "Sockets API"
|
||||||
This is consistent with the recent change in tcp(7).
|
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.
|
||||||
|
|
Loading…
Reference in New Issue