Gidday, The Linux man-pages maintainer proudly announces the release of man-pages-3.29. This release is now available for download at: http://www.kernel.org/pub/linux/docs/man-pages or ftp://ftp.kernel.org/pub/linux/docs/man-pages The online changelog is available at http://www.kernel.org/doc/man-pages/changelog.html (blogged at http://linux-man-pages.blogspot.com/2010/10/man-pages-329-is-released.html ) and the current version of the pages is browsable at http://www.kernel.org/doc/man-pages/ You are receiving this message either because: a) You contributed to the content of this release. b) You are subscribed to linux-man@xxxxxxxxxxxxxxx (*). 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 ==================== Changes in man-pages-3.29 ==================== Released: 2010-10-19, Detroit Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Balazs Scheidler <bazsi@xxxxxxxxxx> David Prevot <davidp@xxxxxxxxxx> Denis Barbier <bouzim@xxxxxxxxx> Guillem Jover <guillem@xxxxxxxxxxx> Ivana Varekova <varekova@xxxxxxxxxx> Lennart Poettering <mzxreary@xxxxxxxxxxx> Michael Kerrisk <mtk.manpages@xxxxxxxxx> Sam Varshavchik <mrsam@xxxxxxxxxxxxxxx> Simon Paillard <simon.paillard@xxxxxxxxxxxxxxxxxxxxxx> Stephan Mueller <stephan.mueller@xxxxxxxxx> Thomas Jarosch <thomas.jarosch@xxxxxxxxxxxxx> Yuri Kozlov <yuray@xxxxxxxxxxxx> Apologies if I missed anyone! New and rewritten pages ----------------------- subpage_prot.2 Michael Kerrisk New page documenting the PowerPC-specific subpage_prot(2) aio_init.3 Michael Kerrisk New page documenting aio_init(3) Newly documented interfaces in existing pages --------------------------------------------- posix_fadvise.2 Michael Kerrisk Document the architecture-specific arm_fadvise64_64() system call This ARM-specific system call fixes the argument ordering for that architecture. Since Linux 2.6.14. sync_file_range.2 Michael Kerrisk Document the architecture-specific sync_file_range2() system call As described in commit edd5cd4a9424f22b0fa08bef5e299d41befd5622, the sync_file_range() argument order is broken for some architectures (PowerPC, ARM, tile). The remedy was a different system call using the right argument order on those architectures. psignal.3 Guillem Jover Document psiginfo() psiginfo() was added to glibc in version 2.10. Michael Kerrisk Add details, VERSIONS, and BUGS for psiginfo() ip.7 Balazs Scheidler Document IP_RECVORIGDSTADDR Document IP_TRANSPARENT Michael Kerrisk Document IP_FREEBIND Text based on input from Lennart Poettering and Balazs Scheidler. See https://bugzilla.kernel.org/show_bug.cgi?id=20082 New and changed links --------------------- arm_fadvise64_64.2 Michael Kerrisk New link to posix_fadvise.2 arm_sync_file_range.2, sync_file_range2.2 Michael Kerrisk New links to sync_file_range.2 arrm_fadvise.2 Michael Kerrisk New link to posix_fadvise.2 psiginfo.3 Guillem Jover New link to psignal.3 Global changes -------------- Many pages Michael Kerrisk global fix: s/Unix/UNIX/ The man pages were rather inconsistent in the use of "Unix" versus "UNIX". Let's go with the trademark usage. Various pages Michael Kerrisk Global fix: s/pseudo-terminal/pseudoterminal/ grantpt.3, ptsname.3, unlockpt.3, pts.4 Michael Kerrisk Global fix: s/pty/pseudoterminal/ recv.2, cmsg.3, unix.7 Michael Kerrisk global fix: s/UNIX socket/UNIX domain socket/ fmtmsg.3, gethostbyname.3, termios.3 Michael Kerrisk Global fix: s/Unixware/UnixWare/ Changes to individual pages --------------------------- inotify_rm_watch.2 Michael Kerrisk SYNOPSIS: fix type of 'wd' argument posix_fadvise.2 Michael Kerrisk Rewrite VERSIONS, noting that the system call is fadvise64() syscalls.2 Michael Kerrisk Add the PowerPC-specific subpage_prot() system call Add sync_file_range2() truncate.2 Michael Kerrisk Fix feature test macros aio_cancel.3 aio_error.3 aio_fsync.3 aio_read.3 aio_return.3 aio_suspend.3 aio_write.3 Michael Kerrisk SEE ALSO: Add lio_listio(3) gai_cancel.3 gai_error.3 gai_suspend.3 Michael Kerrisk Make these into links In the previous release, these files were accidentally made copies of getaddrinfo_a.3, instead of being made as link files. getifaddrs.3 Thomas Jarosch Prevent possible NULL pointer access in example program malloc.3 Michael Kerrisk Emphasize that malloc() and realloc() do not initialize allocated memory malloc_hook.3 Ivana Varekova Warn that these functions are deprecated strcpy.3 Michael Kerrisk Formatting fixes in strncpy() example implementation code ip.7 Michael Kerrisk Reword NOTES on Linux-specific options sigevent.7 Michael Kerrisk SEE ALSO: Add aio_read(3), aio_write(3), and lio_listio(3) unix.7 Michael Kerrisk Document the autobind feature Michael Kerrisk Fix description of abstract socket names As reported by Lennart Poettering: The part about "abstract" sockets is misleading as it suggests that the sockaddr returned by getsockname() would necessarily have the size of sizeof(struct sockaddr), which however is not the case: getsockname() returns exactly the sockaddr size that was passed in on bind(). In particular, two sockets that are bound to the same sockaddr but different sizes are completely independent. See https://bugzilla.kernel.org/show_bug.cgi?id=19812 Michael Kerrisk Fix description of "pathname" sockets As reported by Lennart Poettering: The part about "pathname" sockets suggests usage of sizeof(sa_family_t) + strlen(sun_path) + 1 for calculating the sockaddr size. Due to alignment/padding this is probably not a good idea. Instead, one should use offsetof(struct sockaddr_un, sun_path) + strlen() + 1 or something like that. See https://bugzilla.kernel.org/show_bug.cgi?id=19812 -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
