Upstream update. Please signoff (any arch). -Andy ==================== Changes in man-pages-3.27 ==================== Released: 2010-09-22, Nuernberg Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: caishuxian@gmail.com Denis Barbier <bouzim@gmail.com> Denis Silakov <silakov@ispras.ru> der Mouse <mouse@rodents-montreal.org> Jan Kratochvil <jan.kratochvil@redhat.com> Jim Belton <jim.belton@gmail.com> Jiri Olsa <jolsa@redhat.com> KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com> Mark Hills <mark@pogo.org.uk> Matthew Flaschen <matthew.flaschen@gatech.edu> Michael Kerrisk <mtk.manpages@gmail.com> Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr> Petr Baudis <pasky@suse.cz> Remi Denis-Courmont <remi@remlab.net> Tanaka Akira <akr@fsij.org> Tim Stoakes <tim@stoakes.net> W. Trevor King <wking@drexel.edu> Yuri Kozlov <yuray@komyakino.ru> Apologies if I missed anyone! New and rewritten pages ----------------------- sigevent.7 Petr Baudis, Michael Kerrisk New page to centralize description of sigevent structure Several interfaces use this structure. Best to centralize the common details in one place. Content taken from the existing timerfd_create.2 and mq_open.3 pages, with additions by Petr Baudis and Michael Kerrisk. Newly documented interfaces in existing pages --------------------------------------------- Global changes -------------- _exit.2 brk.2 chdir.2 chmod.2 chown.2 chroot.2 clock_nanosleep.2 getdtablesize.2 gethostname.2 getpagesize.2 getsid.2 killpg.2 mknod.2 mknodat.2 posix_fadvise.2 pread.2 readlink.2 setpgid.2 setpgid.2 setreuid.2 sigaltstack.2 stat.2 symlink.2 sync.2 truncate.2 vfork.2 wait.2 wait4.2 a64l.3 abs.3 acos.3 acosh.3 asin.3 asinh.3 atan.3 atan2.3 atanh.3 atoi.3 cbrt.3 ceil.3 clock_getcpuclockid.3 copysign.3 cos.3 cosh.3 dirfd.3 div.3 dprintf.3 ecvt.3 erf.3 erfc.3 exp.3 exp2.3 expm1.3 fabs.3 fdim.3 fexecve.3 ffs.3 floor.3 fma.3 fmax.3 fmemopen.3 fmin.3 fmod.3 fpclassify.3 frexp.3 fwide.3 gamma.3 gcvt.3 getcwd.3 getdate.3 getgrent.3 gethostid.3 getpass.3 getpwent.3 getsubopt.3 getw.3 hypot.3 ilogb.3 insque.3 isalpha.3 isgreater.3 iswblank.3 j0.3 j0.3 ldexp.3 lockf.3 log.3 log10.3 log1p.3 log2.3 logb.3 lrint.3 lround.3 mbsnrtowcs.3 mkdtemp.3 mkstemp.3 mktemp.3 modf.3 mq_receive.3 mq_send.3 nan.3 nextafter.3 posix_fallocate.3 posix_memalign.3 pow.3 printf.3 qecvt.3 random.3 realpath.3 remainder.3 remquo.3 rint.3 rint.3 round.3 scalb.3 scalbln.3 scanf.3 siginterrupt.3 signbit.3 sigset.3 sin.3 sinh.3 sqrt.3 stpcpy.3 stpncpy.3 strdup.3 strdup.3 strnlen.3 strsignal.3 strtod.3 strtol.3 strtoul.3 tan.3 tanh.3 tgamma.3 trunc.3 ttyslot.3 ualarm.3 usleep.3 wcpcpy.3 wcpncpy.3 wcscasecmp.3 wcsdup.3 wcsncasecmp.3 wcsnlen.3 wcsnrtombs.3 wprintf.3 Michael Kerrisk Add/fix/update feature test macro requirements in SYNOPSIS Various changes to: * Update feature test requirements to note changes in recent glibc releases * Correct errors in feature test macro requirements * Add feature test macro requirements to pages where the requirements were not previously stated. accept.2 clone.2 dup.2 fallocate.2 pipe.2 readahead.2 sched_setaffinity.2 unshare.2 CPU_SET.3 endian.3 euidaccess.3 fexecve.3 getpt.3 getpw.3 getumask.3 getutmp.3 gnu_get_libc_version.3 makedev.3 matherr.3 mbsnrtowcs.3 memfrob.3 pthread_attr_setaffinity_np.3 pthread_getattr_np.3 pthread_setaffinity_np.3 pthread_tryjoin_np.3 tcgetsid.3 wcscasecmp.3 wcsncasecmp.3 wcsnlen.3 wcsnrtombs.3 wcswidth.3 rtld-audit.7 Michael Kerrisk SYNOPSIS: Add reference to feature_test_macros(7) These pages specify feature test macros in the function prototypes. Add a reference to feature_test_macros(7), so that readers are pointed to the information that feature test macros must be defined before including *any* header file. clock_nanosleep.2 clock_getcpuclockid.3 getnetent_r.3 getprotoent_r.3 getrpcent_r.3 getservent_r.3 sigwait.3 Michael Kerrisk RETURN VALUE: Note that "positive error numbers" are listed in ERRORS fcntl.2 intro.2 open.2 poll.2 ftw.3 intro.3 matherr.3 system.3 tmpnam.3 unix.7 Michael Kerrisk Note that feature test macros must be defined before *any* includes Programmers often make the mistake of including a feature test macro only after having already included some header files. This patch adds some text at opportune places to remind programmers to do things the right way. index.3 stpcpy.3 strcasecmp.3 strcat.3 strchr.3 strcmp.3 strcoll.3 strcpy.3 strdup.3 strfry.3 strpbrk.3 strsep.3 strspn.3 strstr.3 strtok.3 strxfrm.3 Michael Kerrisk SEE ALSO: Add reference to string(3) The idea here is to provide a route to discover other string functions. armscii-8.7 cp1251.7 iso_8859-3.7 iso_8859-5.7 iso_8859-6.7 iso_8859-8.7 iso_8859-10.7 iso_8859-11.7 iso_8859-13.7 iso_8859-14.7 koi8-u.7 Denis Barbier Fix decimal values in encoding tables Octal and hexadecimal values are right, but there are some off-by one errors in decimal values. Correct values are printed by this command: perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//) {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7 Changes to individual pages --------------------------- capget.2 Michael Kerrisk SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE" fcntl.2 Michael Kerrisk Add feature test macro requirements for F_GETOWN and F_SETOWN fcntl.2 Michael Kerrisk Note feature test macro requirements for F_DUPFD_CLOEXEC getrlimit.2 Michael Kerrisk Document units for RLIMIT_RTTIME limit This limit is in microseconds http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492 lseek.2 Michael Kerrisk Removed note about return type on ancient systems mount.2 Michael Kerrisk Definitions of various MS_* constants only appeared in glibc 2.12 See http://sourceware.org/bugzilla/show_bug.cgi?id=11235 stat.2 Michael Kerrisk Update information on nanosecond timestamp fields Update feature test macro requirements for exposing these fields. Note that these fields are specified in POSIX.1-2008. timer_create.2 Michael Kerrisk Factor out generic material that was moved to new sigevent(7) page aio_fsync.3 Michael Kerrisk Add reference to new sigevent(7) page atanh.3 Michael Kerrisk glibc 2.10 fixed pole error bug http://sourceware.org/bugzilla/show_bug.cgi?id=6759 was resolved. cerf.3 Michael Kerrisk Make it clearer that this function is unimplemented cos.3 Michael Kerrisk errno is now correctly set to EDOM on a domain error http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780 was (silently) resolved. expm1.3 Michael Kerrisk errno is now correctly set to ERANGE on a range error http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788 was (silently) resolved. fmod.3 Michael Kerrisk errno is now correctly set to EDOM for the x==inf domain error http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784 was (silently) resolved. insque.3 Michael Kerrisk Noted prev == NULL bug in glibc 2.4 and earlier As noted by Remi Denis-Courmont, glibc nowadays allows 'prev' to be NULL, as required by POSIX for initializing a linear list. But in glibc 2.4 and earlier, 'prev' could not be NULL. Add a BUGS section noting this. See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201 insque.3 Michael Kerrisk Added info on circular lists, and initializing circular lists Michael Kerrisk Added example program lgamma.3 Michael Kerrisk glibc 2.10 fixed pole error bug http://sourceware.org/bugzilla/show_bug.cgi?id=6777 was (silently) resolved. log2.3 Matthew Flaschen log2() function does not conform to C89 log2(), log2f(), and log2l() do not conform to C89. They are defined in C99. See http://flash-gordon.me.uk/ansi.c.txt and http://www.schweikhardt.net/identifiers.html mq_notify.3 Michael Kerrisk Factor out generic material that was moved to new sigevent(7) page pow.3 Michael Kerrisk errno is now correctly set to ERANGE on a pole error http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776 was (silently) resolved. pthread_kill_other_threads_np.3 Michael Kerrisk CONFORMING TO: Note meaning of "_np" suffix rand.3 Michael Kerrisk Clarify description of range of returned value Michael Kerrisk Add an example program Michael Kerrisk Expand description of rand_r() random.3 W. Trevor King Update initstate() return value description to match glibc readdir.3 Michael Kerrisk Clarify that "positive error numbers" are listed in ERRORS Reported-by fkater@googlemail.com rexec.3 Michael Kerrisk SYNOPSIS: Add header file and feature test macro requirements sigpause.3 Michael Kerrisk Correct discussion of when BSD vs SysV version is used in glibc sin.3 Michael Kerrisk errno is now correctly set to EDOM on a domain error http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781 was (silently) resolved. tan.3 Michael Kerrisk errno is now correctly set to EDOM on a domain error http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782 was (silently) resolved. wcscasecmp.3 wcsncasecmp.3 wcsnlen.3 Michael Kerrisk Added VERSIONS section boot.7 Yuri Kozlov Update list of major Linux distributions feature_test_macros.7 Michael Kerrisk Make text on required placement of macros more prominent Move the text that notes the requirement that feature test macros must be defined before including any header files to the top of the page, and highlight the text further, so that the reader will not miss this point. ip.7 Jiri Olsa Document IP_NODEFRAG This option is new in Linux 2.6.36 pthreads.7 signal.7 Michael Kerrisk Add SEE ALSO reference to new sigevent(7) page tcp.7 Michael Kerrisk Clarify header file details for SIOCINQ and SIOCOUTQ Also note synonymous FIONREAD and TIOCOUTQ. unix.7 Michael Kerrisk Document SIOCINQ ioctl() operation