c) I have information (possibly inaccurate) that you are the maintainer of a translation of the manual pages, or are the maintainer of the manual pages set in a particular distribution, or have expressed interest in helping with man-pages maintenance, or have otherwise expressed interest in being notified about man-pages releases. If you don't want to receive such messages from me, or you know of some other translator or maintainer who may want to receive such notifications, send me a message.

Cheers,

Michael

(*) [email protected] is the man pages discussion list. Subscribe by sending a message to [email protected], with the body:

subscribe linux-man

==================== Changes in man-pages-3.08 ====================

Released: 2008-08-27, Zurich

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

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

Gerrit Renker <[email protected]> Li Zefan <[email protected]> Mike Bianchi <[email protected]> Sam Varshavchik <[email protected]> Venkatesh Srinivas <[email protected]> Vijay Kumar <[email protected]>

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

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html