==================== 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 Li Zefan Mike Bianchi Sam Varshavchik Venkatesh Srinivas Vijay Kumar 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.