Start of 3.09

This commit is contained in:
Michael Kerrisk 2008-08-27 13:36:21 +00:00
parent c624eb7d35
commit 6d37b461a7
1 changed files with 1 additions and 281 deletions

282
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.08 ====================
Released: 2008-08-27, Zurich
Released: 2008-??-??, ????
Contributors
@ -9,12 +9,6 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Gerrit Renker <gerrit@erg.abdn.ac.uk>
Li Zefan <lizf@cn.fujitsu.com>
Mike Bianchi <MBianchi@foveal.com>
Sam Varshavchik <mrsam@courier-mta.com>
Venkatesh Srinivas <me@acm.jhu.edu>
Vijay Kumar <vijaykumar@bravegnu.org>
Apologies if I missed anyone!
@ -22,296 +16,22 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
getnetent_r.3
mtk
Documents getnetent_r(), getnetbyname_r(),
and getnetbyaddr_r(), the reentrant equivalents of
getnetent(), getnetbyname(), and getnetbyaddr().
getprotoent_r.3
mtk
Documents getprotoent_r(), getprotobyname_r(), and
getprotobynumber_r(), the reentrant equivalents of
getprotoent(), getprotobyname(), and getprotobynumber().
getrpcent_r.3
mtk
Documents getrpcent_r(), getrpcbyname_r(), and
getrpcbynumber_r(), the reentrant equivalents of
getrpcent(), getrpcbyname(), and getrpcbynumber().
getservent_r.3
mtk
Documents getservent_r(), getservbyname_r(), and
getservbyport_r(), the reentrant equivalents of
getservent(), getservbyname(), and getservbyport().
numa.7
mtk
A new page giving overview details for the Linux NUMA interfaces.
Incorporates some material from mbind.2, and the description
of /proc/PID/numa_maps from proc.5.
Newly documented interfaces in existing pages
---------------------------------------------
crypt.3
mtk
Add description of crypt_r().
New and changed links
---------------------
crypt.3
mtk
New link to crypt.3.
getnetbyname_r.3
getnetbyaddr_r.3
mtk
New links to new getnetent_r.3.
getprotobyname_r.3
getprotobynumber_r.3
mtk
New links to new getprotoent_r.3.
getrpcbyname_r.3
getrpcbynumber_r.3
mtk
New links to new getrpcent_r.3.
getservbyname_r.3
getservbyport_r.3
mtk
New links to new getservent_r.3.
numa_maps.5
mtk
Link to new numa(7) page, which incorporates the
/proc/PID/numa_maps description.
As part of the numactl() package, the /proc/PID/numa_maps
documentation was in a numa_maps.5 page; this link
ensures that "man 5 numa_maps" still works.
(Eventually, we may want to remove this link.)
Global changes
--------------
get_mempolicy.2
mbind.2
move_pages.2
set_mempolicy.2
mtk
Add reference to numa(7) for information on library support.
Added a VERSIONS section.
SEE ALSO: Add numa(7).
faccessat.2
fchmodat.2
fchownat.2
fstatat.2
mkdirat.2
mknodat.2
linkat.2
openat.2
readlinkat.2
renameat.2
symlinkat.2
unlinkat.2
mkfifoat.3
psignal.3
strsignal.3
mtk
These interfaces are specified in POSIX.1-2008.
Changes to individual pages
---------------------------
eventfd.2
Vijay Kumar
When an eventfd overflows, select() indicates the file as both
readable and writable (not as having an exceptional condition).
fcntl.2
mtk
F_DUPFD_CLOEXEC is specified in POSIX.1-2008.
getrlimit.2
mtk
NOTES: Add text mention the shell 'ulimit' (or 'limit')
built-in command for setting resource limits.
gettimeofday.2
mtk
CONFORMING TO: POSIX.1-2008 marks gettimeofday() as obsolete.
link.2
mtk
Note kernel version where Linux stopped following symbolic
links in 'oldpath'; see also http://lwn.net/Articles/294667.
POSIX.1-2008 makes it implementation-dependent whether or not
'oldpath' is dereferenced if it is a symbolic link.
Add a reference to linkat(2) for an interface that allows
precise control of the treatment of symbolic links.
mbind.2
mtk
Remove material on library support and numactl; that material
is now in numactl.7.
mmap.2
mtk
Add kernel version numbers for MAP_32BIT.
Add some details on MAP_32BIT (see http://lwn.net/Articles/294642).
move_pages.2
mtk
Added VERSIONS (from kernel 2.6.18) and CONFORMING TO sections.
open.2
mtk
O_CLOEXEC is specified in POSIX.1-2008.
socket.2
mtk
s/d/domain/ for name of argument.
Add reference to socket(2) for further information on
domain, type, and protocol arguments.
utimensat.2
mtk
CONFORMING TO: POSIX.1-2008 specifies utimensat() and futimens().
dirfd.3
mtk
CONFORMING TO: Add POSIX.1-2008; other minor changes.
exec.3
mtk
Small rewording: "s/returned/failed with/ [an error]".
fmemopen.3
mtk
Since glibc 2.7, it is possible to seek past the end of
a stream created by open_memstream(). Add a BUGS section
describing the bug in earlier glibc versions.
gethostbyname.3
mtk
Clarify exactly which functions are obsoleted by getnameinfo()
and getaddrinfo().
getnetent.3
mtk
Rephrase description in terms of a database, rather than a file.
Note that each of the get*() functions opens a connection to
the database if necessary.
The database connection is held open between get*() calls if
'stayopen' is non-zero (not necessarily 1).
s/zero terminated list/NULL-terminated list/
mtk
In glibc 2.2, the type of the 'net' argument for getnetbyaddr()
changed from 'long' to 'uint32_t'.
mtk
Note that the gethostbyaddr() 'net" argument is in host byte order.
mtk
RETURN VALUE: emphasize that returned pointer points to a
statically allocated structure.
SEE ALSO: add getnetent_r.3.
getprotoent.3
mtk
Rephrase description in terms of a database, rather than a file.
Note that each of the get*() functions opens a connection to
the database if necessary.
The database connection is held open between get*() calls if
'stayopen' is non-zero (not necessarily 1).
s/zero terminated list/NULL-terminated list/
mtk
RETURN VALUE: emphasize that returned pointer points to a
statically allocated structure.
SEE ALSO: add getprotoent_r.3.
getrpcent.3
mtk
s/rpc/RPC/.
Rephrase description in terms of a database, rather than a file.
Note that each of the get*() functions opens a connection to
the database if necessary.
s/zero terminated list/NULL-terminated list/
mtk
RETURN VALUE: emphasize that returned pointer points to a
statically allocated structure.
SEE ALSO: add getrpcent_r.3.
getservent.3
mtk
Rephrase description in terms of a database, rather than a file.
Note that each of the get*() functions opens a connection to
the database if necessary.
The database connection is held open between get*() calls if
'stayopen' is non-zero (not necessarily 1).
s/zero terminated list/NULL-terminated list/
mtk
RETURN VALUE: emphasize that returned pointer points to a
statically allocated structure.
SEE ALSO: add getservent_r.3.
mkdtemp.3
mtk
CONFORMING TO: this function is specified in POSIX.1-2008.
mq_notify.3
Venkatesh Srinivas
s/sigev_notify_function/sigev_thread_function/
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=494956.
realpath.3
mtk
Relocate text for resolved_path==NULL case to DESCRIPTION.
POSIX.1-2001 leaves the resolved_path==NULL case as
implementation-defined; POSIX.1-2008 specifies the behavior
described in this man page.
sem_init.3
mtk
POSIX.1-2008 rectifies the POSIX.1-2001 omission, specifying
that zero is returned by a successful sem_init() call.
core.5
Mike Bianchi / mtk
Make the page more helpful to non-programmers by referencing
the documentation of the shell's 'ulimit' command in the
discussion of RLIMIT_CORE and RLIMIT_FSIZE.
SEE ALSO: Add bash(1).
mtk
Note that a core dump file can be used in a debugger.
proc.5
mtk
Remove /proc/PID/numa_maps material (it is now in numa(7)).
cpuset.7
mtk
SEE ALSO: Add numa(7).
inotify.7
mtk / Li Zefan
Explain bug that occurred in coalescing identical events in
kernels before 2.6.25.
(See commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
"A potential bug in inotify_user.c" in the 2.6.25 Changelog.)
pthreads.7
mtk
Update thread-safe functions list with changes in POSIX.1-2008.
SEE ALSO: add proc(5).
signal.7
mtk
Update list of async-sygnal-safe functions for POSIX.1-2008.