From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michael Kerrisk Subject: man-pages-3.13 released Date: Tue, 11 Nov 2008 14:16:14 -0500 Message-ID: <4919D9FE.8010809@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: Bert Wesarg , Karsten Weiss , Lefteris Dimitroulakis , Olaf van der Spek , Sam Varshavchik Cc: base-system-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org, Christophe-MeO/4o4RY/8dnm+yROfE0A@public.gmane.org, Ivana Varekova , Eduardo Madeira Fleury , manpages-fr maintainer , =?ISO-8859-1?Q?Giulio_Daprel=E0?= , "Martin (Joey) Schulze" , Thorsten Kukuk , Mohsen Pahlevanzadeh , Alain Portal , Subrata Modak , ro-l3A5Bk7waGM@public.gmane.org, Aleksandr Blokhin , Senthil Kumar , Stefan Puiu , Andries Brouwer , Kaveh Mousavi , Rob Landley , Stepan Kasal , Elisa , "Michael Kerrisk (gmail)" , Jim Zemlin , Ron Hale-Evans Theodore T'so List-Id: linux-man@vger.kernel.org Gidday, The Linux man-pages maintainer proudly announces: man-pages-3.13.tar.gz - man pages for Linux 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/2008/11/man-pages-313-is-released.h= tml) 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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org (*). 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 interes= t 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 wh= o may want to receive such notifications, send me a message. Cheers, Michael (*) linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org is the man pages discussion list. Subscr= ibe by sending a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, with the body: subscribe linux-man =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Changes in= man-pages-3.13 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D Released: 2008-11-07, Bucaramanga Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Bert Wesarg Karsten Weiss Lefteris Dimitroulakis Olaf van der Spek Sam Varshavchik T=F6r=F6k Edwin Ulrich Mueller Valdis Kletnieks Apologies if I missed anyone! New and rewritten pages ----------------------- pthread_attr_setaffinity_np.3 Michael Kerrisk New page for pthread_attr_setaffinity_np(3) and pthread_attr_getaffinity_np(3) pthread_attr_setschedparam.3 Michael Kerrisk New page for pthread_attr_setschedparam(3) and pthread_attr_getschedparam(3) pthread_attr_setschedpolicy.3 Michael Kerrisk New page for pthread_attr_setschedpolicy(3) and pthread_attr_getschedpolicy(3) pthread_setaffinity_np.3 Michael Kerrisk New page for pthread_setaffinity_np(3) and pthread_getaffinity= _np(3) pthread_setschedparam.3 Michael Kerrisk New page for pthread_setschedparam(3) and pthread_getschedpara= m(3) pthread_setschedprio.3 Michael Kerrisk New page for pthread_setschedprio(3) New and changed links --------------------- pthread_attr_getaffinity_np.3 Michael Kerrisk New link to new pthread_attr_setaffinity_np.3 pthread_attr_getschedparam.3 Michael Kerrisk New link to new pthread_attr_setschedparam.3 pthread_attr_getschedpolicy.3 Michael Kerrisk New link to new pthread_attr_setschedpolicy.3 pthread_getaffinity_np.3 Michael Kerrisk New link to new pthread_setaffinity_np.3 pthread_getschedparam.3 Michael Kerrisk New link to new pthread_setschedparam.3 Global changes -------------- pthread_attr_setaffinity_np.3 pthread_getattr_np.3 pthread_setaffinity_np.3 pthread_tryjoin_np.3 Michael Kerrisk Explain _np suffix Add text to CONFORMING TO explaining that the "_np" suffix is because these functions are non-portable. Changes to individual pages --------------------------- sched_setaffinity.2 Michael Kerrisk SEE ALSO: add sched_getcpu(3) sched_setaffinity.2 Michael Kerrisk SEE ALSO: Add pthread_setaffinity_np(3) sched_setaffinity.2 Michael Kerrisk Clarify EINVAL error for cpusetsize < kernel mask size For sched_setaffinity(), the EINVAL error that occurs if 'cpusetsize' is smaller than the kernel CPU set size on= ly occurs with kernels before 2.6.9. vfork.2 Michael Kerrisk Child holds parent's memory until execve() or *termination* The page was phrased in a few places to describe the child= as holding the parent's memory until the child does an execve= (2) or an _exit(2). The latter case should really be the more general process termination (i.e., either _exit(2) or abno= rmal termination). clock_getres.3 Michael Kerrisk CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not setab= ble According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID an= d CLOCK_THREAD_CPUTIME_ID clocks should be settable, but currently they are not. pthread_attr_setstacksize.3 Michael Kerrisk, after a report by Karsten Weiss EINVAL occurs on some systems if stacksize !=3D page-size On MacOS X at least, pthread_attr_setstacksize(3) can fail with EINVAL if 'stacksize' is not a multiple of the system page size. Best to mention this so as to aid people writi= ng portable programs. pthread_create.3 Karsten Weiss Fix bug in EXAMPLE program The calloc() line should read like this instead: tinfo =3D calloc(num_threads, sizeof(struct thread_inf= o)); pthread_exit.3 Michael Kerrisk BUGS: thread group with a dead leader and stop signals Document the bug that can occur when a stop signal is sent to a thread group whose leader has terminated. http://thread.gmane.org/gmane.linux.kernel/611611 http://marc.info/?l=3Dlinux-kernel&m=3D122525468300823&w=3D= 2 resolver.3 Michael Kerrisk Fix prototype of dn_expand() The 4th argument is "char *", not "unsigned char *". http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=3D504708 epoll.7 Michael Kerrisk Fix error handling after accept() in example code Simply continuing after an error is in most cases wrong, and can lead to infinite loops (e.g., for EMFILE). So handle an error by terminating. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=3D504202 epoll.7 Michael Kerrisk Add error handling for epoll_wait() call in example code epoll.7 Michael Kerrisk Improve example code Fill in some gaps in example code (variable declarations, adding listening socket to epoll set). Give variables more meaningful names. Other minor changes. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=3D504202 iso_8859-7.7 Lefteris Dimitroulakis Add characters for Drachma and Greek Ypogegrammeni Lines for these two characters were added in the previous = patch, but the actual characters were not included in the 4th col= umn of the table. This fixes that. pthreads.7 Michael Kerrisk Add a section describing thread IDs In particular, note that in each pthreads function that ta= kes a thread ID argument, that ID by definition refers to a th= read in the same process as the caller. --=20 Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html =46ound a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html