man-pages/Changes

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

Released: 2008-??-??, Zurich


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>
Sam Varshavchik <mrsam@courier-mta.com>
Venkatesh Srinivas <me@acm.jhu.edu>
Vijay Kumar <vijaykumar@bravegnu.org>

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.


New and changed links
---------------------

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


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

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.

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.

socket.2
    mtk
        s/d/domain/ for name of argument.
	Add reference to socket(2) for further information on
	domain, type, and protocol arguments.

exec.3
    mtk
        Small rewording: "s/returned/failed with/ [an error]".

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.

mq_notify.3
    Venkatesh Srinivas
        s/sigev_notify_function/sigev_thread_function/
        as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=494956.

proc.5
    mtk
        Remove /proc/PID/numa_maps material (it is now in numa(7)).

cpuset.7
    mtk
        SEE ALSO: Add numa(7).