msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2012-05-28 07:16+0900\n"
+"POT-Creation-Date: 2013-03-22 01:06+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: TH
-#: build/C/man2/getcontext.2:23
+#: build/C/man3/getcontext.3:25
#, no-wrap
msgid "GETCONTEXT"
msgstr ""
#. type: TH
-#: build/C/man2/getcontext.2:23
+#: build/C/man3/getcontext.3:25
#, no-wrap
msgid "2009-03-15"
msgstr ""
#. type: TH
-#: build/C/man2/getcontext.2:23 build/C/man3/pthread_attr_init.3:24 build/C/man3/pthread_attr_setaffinity_np.3:24 build/C/man3/pthread_attr_setdetachstate.3:24 build/C/man3/pthread_attr_setguardsize.3:24 build/C/man3/pthread_attr_setinheritsched.3:24 build/C/man3/pthread_attr_setschedparam.3:24 build/C/man3/pthread_attr_setschedpolicy.3:24 build/C/man3/pthread_attr_setscope.3:24 build/C/man3/pthread_attr_setstack.3:24 build/C/man3/pthread_attr_setstackaddr.3:24 build/C/man3/pthread_attr_setstacksize.3:24 build/C/man3/pthread_cancel.3:24 build/C/man3/pthread_cleanup_push.3:24 build/C/man3/pthread_cleanup_push_defer_np.3:24 build/C/man3/pthread_create.3:24 build/C/man3/pthread_detach.3:24 build/C/man3/pthread_equal.3:24 build/C/man3/pthread_exit.3:24 build/C/man3/pthread_getattr_np.3:24 build/C/man3/pthread_getcpuclockid.3:24 build/C/man3/pthread_join.3:24 build/C/man3/pthread_kill.3:24 build/C/man3/pthread_kill_other_threads_np.3:24 build/C/man3/pthread_self.3:24 build/C/man3/pthread_setaffinity_np.3:24 build/C/man3/pthread_setcancelstate.3:24 build/C/man3/pthread_setconcurrency.3:23 build/C/man3/pthread_setschedparam.3:24 build/C/man3/pthread_setschedprio.3:24 build/C/man3/pthread_sigmask.3:24 build/C/man3/pthread_sigqueue.3:23 build/C/man3/pthread_testcancel.3:24 build/C/man3/pthread_tryjoin_np.3:24 build/C/man3/pthread_yield.3:23 build/C/man7/pthreads.7:24
+#: build/C/man3/getcontext.3:25 build/C/man3/pthread_attr_init.3:26 build/C/man3/pthread_attr_setaffinity_np.3:26 build/C/man3/pthread_attr_setdetachstate.3:26 build/C/man3/pthread_attr_setguardsize.3:26 build/C/man3/pthread_attr_setinheritsched.3:26 build/C/man3/pthread_attr_setschedparam.3:26 build/C/man3/pthread_attr_setschedpolicy.3:26 build/C/man3/pthread_attr_setscope.3:26 build/C/man3/pthread_attr_setstack.3:26 build/C/man3/pthread_attr_setstackaddr.3:26 build/C/man3/pthread_attr_setstacksize.3:26 build/C/man3/pthread_cancel.3:26 build/C/man3/pthread_cleanup_push.3:26 build/C/man3/pthread_cleanup_push_defer_np.3:26 build/C/man3/pthread_create.3:26 build/C/man3/pthread_detach.3:26 build/C/man3/pthread_equal.3:26 build/C/man3/pthread_exit.3:26 build/C/man3/pthread_getattr_np.3:26 build/C/man3/pthread_getcpuclockid.3:26 build/C/man3/pthread_join.3:26 build/C/man3/pthread_kill.3:26 build/C/man3/pthread_kill_other_threads_np.3:26 build/C/man3/pthread_self.3:26 build/C/man3/pthread_setaffinity_np.3:26 build/C/man3/pthread_setcancelstate.3:26 build/C/man3/pthread_setconcurrency.3:25 build/C/man3/pthread_setname_np.3:26 build/C/man3/pthread_setschedparam.3:26 build/C/man3/pthread_setschedprio.3:26 build/C/man3/pthread_sigmask.3:26 build/C/man3/pthread_sigqueue.3:25 build/C/man3/pthread_testcancel.3:26 build/C/man3/pthread_tryjoin_np.3:26 build/C/man3/pthread_yield.3:25 build/C/man7/pthreads.7:26
#, no-wrap
msgid "Linux"
msgstr ""
#. type: TH
-#: build/C/man2/getcontext.2:23 build/C/man3/makecontext.3:25 build/C/man3/pthread_attr_init.3:24 build/C/man3/pthread_attr_setaffinity_np.3:24 build/C/man3/pthread_attr_setdetachstate.3:24 build/C/man3/pthread_attr_setguardsize.3:24 build/C/man3/pthread_attr_setinheritsched.3:24 build/C/man3/pthread_attr_setschedparam.3:24 build/C/man3/pthread_attr_setschedpolicy.3:24 build/C/man3/pthread_attr_setscope.3:24 build/C/man3/pthread_attr_setstack.3:24 build/C/man3/pthread_attr_setstackaddr.3:24 build/C/man3/pthread_attr_setstacksize.3:24 build/C/man3/pthread_cancel.3:24 build/C/man3/pthread_cleanup_push.3:24 build/C/man3/pthread_cleanup_push_defer_np.3:24 build/C/man3/pthread_create.3:24 build/C/man3/pthread_detach.3:24 build/C/man3/pthread_equal.3:24 build/C/man3/pthread_exit.3:24 build/C/man3/pthread_getattr_np.3:24 build/C/man3/pthread_getcpuclockid.3:24 build/C/man3/pthread_join.3:24 build/C/man3/pthread_kill.3:24 build/C/man3/pthread_kill_other_threads_np.3:24 build/C/man3/pthread_self.3:24 build/C/man3/pthread_setaffinity_np.3:24 build/C/man3/pthread_setcancelstate.3:24 build/C/man3/pthread_setconcurrency.3:23 build/C/man3/pthread_setschedparam.3:24 build/C/man3/pthread_setschedprio.3:24 build/C/man3/pthread_sigmask.3:24 build/C/man3/pthread_sigqueue.3:23 build/C/man3/pthread_testcancel.3:24 build/C/man3/pthread_tryjoin_np.3:24 build/C/man3/pthread_yield.3:23 build/C/man7/pthreads.7:24
+#: build/C/man3/getcontext.3:25 build/C/man3/makecontext.3:28 build/C/man3/pthread_attr_init.3:26 build/C/man3/pthread_attr_setaffinity_np.3:26 build/C/man3/pthread_attr_setdetachstate.3:26 build/C/man3/pthread_attr_setguardsize.3:26 build/C/man3/pthread_attr_setinheritsched.3:26 build/C/man3/pthread_attr_setschedparam.3:26 build/C/man3/pthread_attr_setschedpolicy.3:26 build/C/man3/pthread_attr_setscope.3:26 build/C/man3/pthread_attr_setstack.3:26 build/C/man3/pthread_attr_setstackaddr.3:26 build/C/man3/pthread_attr_setstacksize.3:26 build/C/man3/pthread_cancel.3:26 build/C/man3/pthread_cleanup_push.3:26 build/C/man3/pthread_cleanup_push_defer_np.3:26 build/C/man3/pthread_create.3:26 build/C/man3/pthread_detach.3:26 build/C/man3/pthread_equal.3:26 build/C/man3/pthread_exit.3:26 build/C/man3/pthread_getattr_np.3:26 build/C/man3/pthread_getcpuclockid.3:26 build/C/man3/pthread_join.3:26 build/C/man3/pthread_kill.3:26 build/C/man3/pthread_kill_other_threads_np.3:26 build/C/man3/pthread_self.3:26 build/C/man3/pthread_setaffinity_np.3:26 build/C/man3/pthread_setcancelstate.3:26 build/C/man3/pthread_setconcurrency.3:25 build/C/man3/pthread_setname_np.3:26 build/C/man3/pthread_setschedparam.3:26 build/C/man3/pthread_setschedprio.3:26 build/C/man3/pthread_sigmask.3:26 build/C/man3/pthread_sigqueue.3:25 build/C/man3/pthread_testcancel.3:26 build/C/man3/pthread_tryjoin_np.3:26 build/C/man3/pthread_yield.3:25 build/C/man7/pthreads.7:26
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:24 build/C/man3/makecontext.3:26 build/C/man3/pthread_attr_init.3:25 build/C/man3/pthread_attr_setaffinity_np.3:25 build/C/man3/pthread_attr_setdetachstate.3:25 build/C/man3/pthread_attr_setguardsize.3:25 build/C/man3/pthread_attr_setinheritsched.3:25 build/C/man3/pthread_attr_setschedparam.3:25 build/C/man3/pthread_attr_setschedpolicy.3:25 build/C/man3/pthread_attr_setscope.3:25 build/C/man3/pthread_attr_setstack.3:25 build/C/man3/pthread_attr_setstackaddr.3:25 build/C/man3/pthread_attr_setstacksize.3:25 build/C/man3/pthread_cancel.3:25 build/C/man3/pthread_cleanup_push.3:25 build/C/man3/pthread_cleanup_push_defer_np.3:25 build/C/man3/pthread_create.3:25 build/C/man3/pthread_detach.3:25 build/C/man3/pthread_equal.3:25 build/C/man3/pthread_exit.3:25 build/C/man3/pthread_getattr_np.3:25 build/C/man3/pthread_getcpuclockid.3:25 build/C/man3/pthread_join.3:25 build/C/man3/pthread_kill.3:25 build/C/man3/pthread_kill_other_threads_np.3:25 build/C/man3/pthread_self.3:25 build/C/man3/pthread_setaffinity_np.3:25 build/C/man3/pthread_setcancelstate.3:25 build/C/man3/pthread_setconcurrency.3:24 build/C/man3/pthread_setschedparam.3:25 build/C/man3/pthread_setschedprio.3:25 build/C/man3/pthread_sigmask.3:25 build/C/man3/pthread_sigqueue.3:24 build/C/man3/pthread_testcancel.3:25 build/C/man3/pthread_tryjoin_np.3:25 build/C/man3/pthread_yield.3:24 build/C/man7/pthreads.7:25
+#: build/C/man3/getcontext.3:26 build/C/man3/makecontext.3:29 build/C/man3/pthread_attr_init.3:27 build/C/man3/pthread_attr_setaffinity_np.3:27 build/C/man3/pthread_attr_setdetachstate.3:27 build/C/man3/pthread_attr_setguardsize.3:27 build/C/man3/pthread_attr_setinheritsched.3:27 build/C/man3/pthread_attr_setschedparam.3:27 build/C/man3/pthread_attr_setschedpolicy.3:27 build/C/man3/pthread_attr_setscope.3:27 build/C/man3/pthread_attr_setstack.3:27 build/C/man3/pthread_attr_setstackaddr.3:27 build/C/man3/pthread_attr_setstacksize.3:27 build/C/man3/pthread_cancel.3:27 build/C/man3/pthread_cleanup_push.3:27 build/C/man3/pthread_cleanup_push_defer_np.3:27 build/C/man3/pthread_create.3:27 build/C/man3/pthread_detach.3:27 build/C/man3/pthread_equal.3:27 build/C/man3/pthread_exit.3:27 build/C/man3/pthread_getattr_np.3:27 build/C/man3/pthread_getcpuclockid.3:27 build/C/man3/pthread_join.3:27 build/C/man3/pthread_kill.3:27 build/C/man3/pthread_kill_other_threads_np.3:27 build/C/man3/pthread_self.3:27 build/C/man3/pthread_setaffinity_np.3:27 build/C/man3/pthread_setcancelstate.3:27 build/C/man3/pthread_setconcurrency.3:26 build/C/man3/pthread_setname_np.3:27 build/C/man3/pthread_setschedparam.3:27 build/C/man3/pthread_setschedprio.3:27 build/C/man3/pthread_sigmask.3:27 build/C/man3/pthread_sigqueue.3:26 build/C/man3/pthread_testcancel.3:27 build/C/man3/pthread_tryjoin_np.3:27 build/C/man3/pthread_yield.3:26 build/C/man7/pthreads.7:27
#, no-wrap
msgid "NAME"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:26
+#: build/C/man3/getcontext.3:28
msgid "getcontext, setcontext - get or set the user context"
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:26 build/C/man3/makecontext.3:28 build/C/man3/pthread_attr_init.3:28 build/C/man3/pthread_attr_setaffinity_np.3:28 build/C/man3/pthread_attr_setdetachstate.3:28 build/C/man3/pthread_attr_setguardsize.3:28 build/C/man3/pthread_attr_setinheritsched.3:28 build/C/man3/pthread_attr_setschedparam.3:28 build/C/man3/pthread_attr_setschedpolicy.3:28 build/C/man3/pthread_attr_setscope.3:28 build/C/man3/pthread_attr_setstack.3:28 build/C/man3/pthread_attr_setstackaddr.3:28 build/C/man3/pthread_attr_setstacksize.3:28 build/C/man3/pthread_cancel.3:27 build/C/man3/pthread_cleanup_push.3:28 build/C/man3/pthread_cleanup_push_defer_np.3:28 build/C/man3/pthread_create.3:27 build/C/man3/pthread_detach.3:27 build/C/man3/pthread_equal.3:27 build/C/man3/pthread_exit.3:27 build/C/man3/pthread_getattr_np.3:27 build/C/man3/pthread_getcpuclockid.3:27 build/C/man3/pthread_join.3:27 build/C/man3/pthread_kill.3:27 build/C/man3/pthread_kill_other_threads_np.3:27 build/C/man3/pthread_self.3:27 build/C/man3/pthread_setaffinity_np.3:28 build/C/man3/pthread_setcancelstate.3:28 build/C/man3/pthread_setconcurrency.3:27 build/C/man3/pthread_setschedparam.3:28 build/C/man3/pthread_setschedprio.3:27 build/C/man3/pthread_sigmask.3:27 build/C/man3/pthread_sigqueue.3:26 build/C/man3/pthread_testcancel.3:27 build/C/man3/pthread_tryjoin_np.3:28 build/C/man3/pthread_yield.3:26
+#: build/C/man3/getcontext.3:28 build/C/man3/makecontext.3:31 build/C/man3/pthread_attr_init.3:30 build/C/man3/pthread_attr_setaffinity_np.3:30 build/C/man3/pthread_attr_setdetachstate.3:30 build/C/man3/pthread_attr_setguardsize.3:30 build/C/man3/pthread_attr_setinheritsched.3:30 build/C/man3/pthread_attr_setschedparam.3:30 build/C/man3/pthread_attr_setschedpolicy.3:30 build/C/man3/pthread_attr_setscope.3:30 build/C/man3/pthread_attr_setstack.3:30 build/C/man3/pthread_attr_setstackaddr.3:30 build/C/man3/pthread_attr_setstacksize.3:30 build/C/man3/pthread_cancel.3:29 build/C/man3/pthread_cleanup_push.3:30 build/C/man3/pthread_cleanup_push_defer_np.3:30 build/C/man3/pthread_create.3:29 build/C/man3/pthread_detach.3:29 build/C/man3/pthread_equal.3:29 build/C/man3/pthread_exit.3:29 build/C/man3/pthread_getattr_np.3:29 build/C/man3/pthread_getcpuclockid.3:29 build/C/man3/pthread_join.3:29 build/C/man3/pthread_kill.3:29 build/C/man3/pthread_kill_other_threads_np.3:29 build/C/man3/pthread_self.3:29 build/C/man3/pthread_setaffinity_np.3:30 build/C/man3/pthread_setcancelstate.3:30 build/C/man3/pthread_setconcurrency.3:29 build/C/man3/pthread_setname_np.3:29 build/C/man3/pthread_setschedparam.3:30 build/C/man3/pthread_setschedprio.3:29 build/C/man3/pthread_sigmask.3:29 build/C/man3/pthread_sigqueue.3:28 build/C/man3/pthread_testcancel.3:29 build/C/man3/pthread_tryjoin_np.3:30 build/C/man3/pthread_yield.3:28
#, no-wrap
msgid "SYNOPSIS"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:28 build/C/man3/makecontext.3:30
+#: build/C/man3/getcontext.3:30 build/C/man3/makecontext.3:33
msgid "B<#include E<lt>ucontext.hE<gt>>"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:30
+#: build/C/man3/getcontext.3:32
msgid "B<int getcontext(ucontext_t *>I<ucp>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:32
+#: build/C/man3/getcontext.3:34
msgid "B<int setcontext(const ucontext_t *>I<ucp>B<);>"
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:32 build/C/man3/makecontext.3:35 build/C/man3/pthread_attr_init.3:37 build/C/man3/pthread_attr_setaffinity_np.3:40 build/C/man3/pthread_attr_setdetachstate.3:39 build/C/man3/pthread_attr_setguardsize.3:39 build/C/man3/pthread_attr_setinheritsched.3:39 build/C/man3/pthread_attr_setschedparam.3:39 build/C/man3/pthread_attr_setschedpolicy.3:39 build/C/man3/pthread_attr_setscope.3:39 build/C/man3/pthread_attr_setstack.3:52 build/C/man3/pthread_attr_setstackaddr.3:39 build/C/man3/pthread_attr_setstacksize.3:39 build/C/man3/pthread_cancel.3:35 build/C/man3/pthread_cleanup_push.3:38 build/C/man3/pthread_cleanup_push_defer_np.3:38 build/C/man3/pthread_create.3:36 build/C/man3/pthread_detach.3:35 build/C/man3/pthread_equal.3:35 build/C/man3/pthread_exit.3:35 build/C/man3/pthread_getattr_np.3:36 build/C/man3/pthread_getcpuclockid.3:36 build/C/man3/pthread_join.3:35 build/C/man3/pthread_kill.3:35 build/C/man3/pthread_kill_other_threads_np.3:33 build/C/man3/pthread_self.3:35 build/C/man3/pthread_setaffinity_np.3:40 build/C/man3/pthread_setcancelstate.3:37 build/C/man3/pthread_setconcurrency.3:36 build/C/man3/pthread_setschedparam.3:39 build/C/man3/pthread_setschedprio.3:35 build/C/man3/pthread_sigmask.3:36 build/C/man3/pthread_sigqueue.3:43 build/C/man3/pthread_testcancel.3:35 build/C/man3/pthread_tryjoin_np.3:40 build/C/man3/pthread_yield.3:34 build/C/man7/pthreads.7:27
+#: build/C/man3/getcontext.3:34 build/C/man3/makecontext.3:38 build/C/man3/pthread_attr_init.3:39 build/C/man3/pthread_attr_setaffinity_np.3:42 build/C/man3/pthread_attr_setdetachstate.3:41 build/C/man3/pthread_attr_setguardsize.3:41 build/C/man3/pthread_attr_setinheritsched.3:41 build/C/man3/pthread_attr_setschedparam.3:41 build/C/man3/pthread_attr_setschedpolicy.3:41 build/C/man3/pthread_attr_setscope.3:41 build/C/man3/pthread_attr_setstack.3:54 build/C/man3/pthread_attr_setstackaddr.3:41 build/C/man3/pthread_attr_setstacksize.3:41 build/C/man3/pthread_cancel.3:37 build/C/man3/pthread_cleanup_push.3:40 build/C/man3/pthread_cleanup_push_defer_np.3:40 build/C/man3/pthread_create.3:38 build/C/man3/pthread_detach.3:37 build/C/man3/pthread_equal.3:37 build/C/man3/pthread_exit.3:37 build/C/man3/pthread_getattr_np.3:38 build/C/man3/pthread_getcpuclockid.3:38 build/C/man3/pthread_join.3:37 build/C/man3/pthread_kill.3:37 build/C/man3/pthread_kill_other_threads_np.3:35 build/C/man3/pthread_self.3:37 build/C/man3/pthread_setaffinity_np.3:42 build/C/man3/pthread_setcancelstate.3:39 build/C/man3/pthread_setconcurrency.3:38 build/C/man3/pthread_setname_np.3:39 build/C/man3/pthread_setschedparam.3:41 build/C/man3/pthread_setschedprio.3:37 build/C/man3/pthread_sigmask.3:38 build/C/man3/pthread_sigqueue.3:45 build/C/man3/pthread_testcancel.3:37 build/C/man3/pthread_tryjoin_np.3:42 build/C/man3/pthread_yield.3:37 build/C/man7/pthreads.7:29
#, no-wrap
msgid "DESCRIPTION"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:44
+#: build/C/man3/getcontext.3:46
msgid ""
"In a System V-like environment, one has the two types I<mcontext_t> and "
"I<ucontext_t> defined in I<E<lt>ucontext.hE<gt>> and the four functions "
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:48
+#: build/C/man3/getcontext.3:50
msgid ""
"The I<mcontext_t> type is machine-dependent and opaque. The I<ucontext_t> "
"type is a structure that has at least the following fields:"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:58
+#: build/C/man3/getcontext.3:60
#, no-wrap
msgid ""
"typedef struct ucontext {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:75
+#: build/C/man3/getcontext.3:77
msgid ""
"with I<sigset_t> and I<stack_t> defined in I<E<lt>signal.hE<gt>>. Here "
"I<uc_link> points to the context that will be resumed when the current "
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:80
+#: build/C/man3/getcontext.3:82
msgid ""
"The function B<getcontext>() initializes the structure pointed at by I<ucp> "
"to the currently active context."
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:92
+#: build/C/man3/getcontext.3:94
msgid ""
"The function B<setcontext>() restores the user context pointed at by "
"I<ucp>. A successful call does not return. The context should have been "
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:96
+#: build/C/man3/getcontext.3:98
msgid ""
"If the context was obtained by a call of B<getcontext>(), program execution "
"continues as if this call just returned."
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:107
+#: build/C/man3/getcontext.3:109
msgid ""
"If the context was obtained by a call of B<makecontext>(3), program "
"execution continues by a call to the function I<func> specified as the "
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:114
+#: build/C/man3/getcontext.3:116
msgid ""
"If the context was obtained by a call to a signal handler, then old standard "
"text says that \"program execution continues with the program instruction "
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:114 build/C/man3/makecontext.3:81 build/C/man3/pthread_attr_init.3:66 build/C/man3/pthread_attr_setaffinity_np.3:74 build/C/man3/pthread_attr_setdetachstate.3:75 build/C/man3/pthread_attr_setguardsize.3:88 build/C/man3/pthread_attr_setinheritsched.3:82 build/C/man3/pthread_attr_setschedparam.3:72 build/C/man3/pthread_attr_setschedpolicy.3:70 build/C/man3/pthread_attr_setscope.3:89 build/C/man3/pthread_attr_setstack.3:83 build/C/man3/pthread_attr_setstackaddr.3:72 build/C/man3/pthread_attr_setstacksize.3:59 build/C/man3/pthread_cancel.3:107 build/C/man3/pthread_cleanup_push.3:117 build/C/man3/pthread_create.3:113 build/C/man3/pthread_detach.3:47 build/C/man3/pthread_equal.3:39 build/C/man3/pthread_exit.3:69 build/C/man3/pthread_getattr_np.3:71 build/C/man3/pthread_getcpuclockid.3:44 build/C/man3/pthread_join.3:68 build/C/man3/pthread_kill.3:50 build/C/man3/pthread_self.3:44 build/C/man3/pthread_setaffinity_np.3:75 build/C/man3/pthread_setcancelstate.3:90 build/C/man3/pthread_setconcurrency.3:54 build/C/man3/pthread_setschedparam.3:102 build/C/man3/pthread_setschedprio.3:51 build/C/man3/pthread_sigmask.3:47 build/C/man3/pthread_sigqueue.3:63 build/C/man3/pthread_testcancel.3:48 build/C/man3/pthread_tryjoin_np.3:83 build/C/man3/pthread_yield.3:41
+#: build/C/man3/getcontext.3:116 build/C/man3/makecontext.3:84 build/C/man3/pthread_attr_init.3:68 build/C/man3/pthread_attr_setaffinity_np.3:76 build/C/man3/pthread_attr_setdetachstate.3:77 build/C/man3/pthread_attr_setguardsize.3:90 build/C/man3/pthread_attr_setinheritsched.3:84 build/C/man3/pthread_attr_setschedparam.3:74 build/C/man3/pthread_attr_setschedpolicy.3:72 build/C/man3/pthread_attr_setscope.3:91 build/C/man3/pthread_attr_setstack.3:85 build/C/man3/pthread_attr_setstackaddr.3:74 build/C/man3/pthread_attr_setstacksize.3:61 build/C/man3/pthread_cancel.3:109 build/C/man3/pthread_cleanup_push.3:119 build/C/man3/pthread_create.3:115 build/C/man3/pthread_detach.3:49 build/C/man3/pthread_equal.3:41 build/C/man3/pthread_exit.3:71 build/C/man3/pthread_getattr_np.3:73 build/C/man3/pthread_getcpuclockid.3:46 build/C/man3/pthread_join.3:70 build/C/man3/pthread_kill.3:52 build/C/man3/pthread_self.3:46 build/C/man3/pthread_setaffinity_np.3:77 build/C/man3/pthread_setcancelstate.3:92 build/C/man3/pthread_setconcurrency.3:56 build/C/man3/pthread_setname_np.3:72 build/C/man3/pthread_setschedparam.3:104 build/C/man3/pthread_setschedprio.3:53 build/C/man3/pthread_sigmask.3:49 build/C/man3/pthread_sigqueue.3:65 build/C/man3/pthread_testcancel.3:50 build/C/man3/pthread_tryjoin_np.3:85 build/C/man3/pthread_yield.3:44
#, no-wrap
msgid "RETURN VALUE"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:122
+#: build/C/man3/getcontext.3:124
msgid ""
"When successful, B<getcontext>() returns 0 and B<setcontext>() does not "
"return. On error, both return -1 and set I<errno> appropriately."
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:122 build/C/man3/makecontext.3:93 build/C/man3/pthread_attr_init.3:69 build/C/man3/pthread_attr_setaffinity_np.3:77 build/C/man3/pthread_attr_setdetachstate.3:78 build/C/man3/pthread_attr_setguardsize.3:91 build/C/man3/pthread_attr_setinheritsched.3:85 build/C/man3/pthread_attr_setschedparam.3:75 build/C/man3/pthread_attr_setschedpolicy.3:73 build/C/man3/pthread_attr_setscope.3:92 build/C/man3/pthread_attr_setstack.3:86 build/C/man3/pthread_attr_setstackaddr.3:75 build/C/man3/pthread_attr_setstacksize.3:62 build/C/man3/pthread_cancel.3:112 build/C/man3/pthread_cleanup_push.3:119 build/C/man3/pthread_create.3:120 build/C/man3/pthread_detach.3:52 build/C/man3/pthread_equal.3:43 build/C/man3/pthread_exit.3:71 build/C/man3/pthread_getattr_np.3:74 build/C/man3/pthread_getcpuclockid.3:47 build/C/man3/pthread_join.3:73 build/C/man3/pthread_kill.3:55 build/C/man3/pthread_self.3:46 build/C/man3/pthread_setaffinity_np.3:78 build/C/man3/pthread_setcancelstate.3:93 build/C/man3/pthread_setconcurrency.3:66 build/C/man3/pthread_setschedparam.3:110 build/C/man3/pthread_setschedprio.3:59 build/C/man3/pthread_sigmask.3:52 build/C/man3/pthread_sigqueue.3:68 build/C/man3/pthread_testcancel.3:52 build/C/man3/pthread_tryjoin_np.3:87 build/C/man3/pthread_yield.3:46
+#: build/C/man3/getcontext.3:124 build/C/man3/makecontext.3:96 build/C/man3/pthread_attr_init.3:71 build/C/man3/pthread_attr_setaffinity_np.3:79 build/C/man3/pthread_attr_setdetachstate.3:80 build/C/man3/pthread_attr_setguardsize.3:93 build/C/man3/pthread_attr_setinheritsched.3:87 build/C/man3/pthread_attr_setschedparam.3:77 build/C/man3/pthread_attr_setschedpolicy.3:75 build/C/man3/pthread_attr_setscope.3:94 build/C/man3/pthread_attr_setstack.3:88 build/C/man3/pthread_attr_setstackaddr.3:77 build/C/man3/pthread_attr_setstacksize.3:64 build/C/man3/pthread_cancel.3:114 build/C/man3/pthread_cleanup_push.3:121 build/C/man3/pthread_create.3:122 build/C/man3/pthread_detach.3:54 build/C/man3/pthread_equal.3:45 build/C/man3/pthread_exit.3:73 build/C/man3/pthread_getattr_np.3:76 build/C/man3/pthread_getcpuclockid.3:49 build/C/man3/pthread_join.3:75 build/C/man3/pthread_kill.3:57 build/C/man3/pthread_self.3:48 build/C/man3/pthread_setaffinity_np.3:80 build/C/man3/pthread_setcancelstate.3:95 build/C/man3/pthread_setconcurrency.3:68 build/C/man3/pthread_setname_np.3:75 build/C/man3/pthread_setschedparam.3:112 build/C/man3/pthread_setschedprio.3:61 build/C/man3/pthread_sigmask.3:54 build/C/man3/pthread_sigqueue.3:70 build/C/man3/pthread_testcancel.3:54 build/C/man3/pthread_tryjoin_np.3:89 build/C/man3/pthread_yield.3:49
#, no-wrap
msgid "ERRORS"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:124
+#: build/C/man3/getcontext.3:126
msgid "None defined."
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:124 build/C/man3/makecontext.3:102 build/C/man3/pthread_attr_init.3:77 build/C/man3/pthread_attr_setaffinity_np.3:106 build/C/man3/pthread_attr_setdetachstate.3:85 build/C/man3/pthread_attr_setguardsize.3:104 build/C/man3/pthread_attr_setinheritsched.3:99 build/C/man3/pthread_attr_setschedparam.3:87 build/C/man3/pthread_attr_setschedpolicy.3:87 build/C/man3/pthread_attr_setscope.3:105 build/C/man3/pthread_attr_setstack.3:110 build/C/man3/pthread_attr_setstackaddr.3:81 build/C/man3/pthread_attr_setstacksize.3:81 build/C/man3/pthread_cancel.3:120 build/C/man3/pthread_cleanup_push.3:123 build/C/man3/pthread_cleanup_push_defer_np.3:99 build/C/man3/pthread_create.3:144 build/C/man3/pthread_detach.3:62 build/C/man3/pthread_equal.3:45 build/C/man3/pthread_exit.3:73 build/C/man3/pthread_getattr_np.3:96 build/C/man3/pthread_getcpuclockid.3:63 build/C/man3/pthread_join.3:96 build/C/man3/pthread_kill.3:64 build/C/man3/pthread_kill_other_threads_np.3:45 build/C/man3/pthread_self.3:48 build/C/man3/pthread_setaffinity_np.3:119 build/C/man3/pthread_setcancelstate.3:111 build/C/man3/pthread_setconcurrency.3:81 build/C/man3/pthread_setschedparam.3:139 build/C/man3/pthread_setschedprio.3:81 build/C/man3/pthread_sigmask.3:55 build/C/man3/pthread_sigqueue.3:91 build/C/man3/pthread_testcancel.3:56 build/C/man3/pthread_tryjoin_np.3:110 build/C/man3/pthread_yield.3:50
+#: build/C/man3/getcontext.3:126 build/C/man3/makecontext.3:105 build/C/man3/pthread_attr_init.3:79 build/C/man3/pthread_attr_setaffinity_np.3:108 build/C/man3/pthread_attr_setdetachstate.3:87 build/C/man3/pthread_attr_setguardsize.3:106 build/C/man3/pthread_attr_setinheritsched.3:101 build/C/man3/pthread_attr_setschedparam.3:89 build/C/man3/pthread_attr_setschedpolicy.3:89 build/C/man3/pthread_attr_setscope.3:107 build/C/man3/pthread_attr_setstack.3:112 build/C/man3/pthread_attr_setstackaddr.3:83 build/C/man3/pthread_attr_setstacksize.3:83 build/C/man3/pthread_cancel.3:122 build/C/man3/pthread_cleanup_push.3:125 build/C/man3/pthread_cleanup_push_defer_np.3:101 build/C/man3/pthread_create.3:146 build/C/man3/pthread_detach.3:64 build/C/man3/pthread_equal.3:47 build/C/man3/pthread_exit.3:75 build/C/man3/pthread_getattr_np.3:98 build/C/man3/pthread_getcpuclockid.3:65 build/C/man3/pthread_join.3:98 build/C/man3/pthread_kill.3:66 build/C/man3/pthread_kill_other_threads_np.3:47 build/C/man3/pthread_self.3:50 build/C/man3/pthread_setaffinity_np.3:121 build/C/man3/pthread_setcancelstate.3:113 build/C/man3/pthread_setconcurrency.3:83 build/C/man3/pthread_setname_np.3:102 build/C/man3/pthread_setschedparam.3:141 build/C/man3/pthread_setschedprio.3:83 build/C/man3/pthread_sigmask.3:57 build/C/man3/pthread_sigqueue.3:93 build/C/man3/pthread_testcancel.3:58 build/C/man3/pthread_tryjoin_np.3:112 build/C/man3/pthread_yield.3:53
#, no-wrap
msgid "CONFORMING TO"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:130
+#: build/C/man3/getcontext.3:132
msgid ""
"SUSv2, POSIX.1-2001. POSIX.1-2008 removes the specification of "
"B<getcontext>(), citing portability issues, and recommending that "
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:130 build/C/man3/makecontext.3:110 build/C/man3/pthread_attr_init.3:79 build/C/man3/pthread_attr_setaffinity_np.3:109 build/C/man3/pthread_attr_setdetachstate.3:87 build/C/man3/pthread_attr_setguardsize.3:106 build/C/man3/pthread_attr_setschedparam.3:89 build/C/man3/pthread_attr_setscope.3:107 build/C/man3/pthread_attr_setstack.3:112 build/C/man3/pthread_attr_setstackaddr.3:84 build/C/man3/pthread_attr_setstacksize.3:83 build/C/man3/pthread_cancel.3:122 build/C/man3/pthread_cleanup_push.3:125 build/C/man3/pthread_create.3:146 build/C/man3/pthread_detach.3:64 build/C/man3/pthread_equal.3:47 build/C/man3/pthread_exit.3:75 build/C/man3/pthread_getcpuclockid.3:65 build/C/man3/pthread_join.3:98 build/C/man3/pthread_kill.3:66 build/C/man3/pthread_kill_other_threads_np.3:48 build/C/man3/pthread_self.3:50 build/C/man3/pthread_setaffinity_np.3:122 build/C/man3/pthread_setcancelstate.3:113 build/C/man3/pthread_setconcurrency.3:83 build/C/man3/pthread_setschedparam.3:141 build/C/man3/pthread_setschedprio.3:83 build/C/man3/pthread_sigmask.3:57 build/C/man3/pthread_yield.3:56
+#: build/C/man3/getcontext.3:132 build/C/man3/makecontext.3:113 build/C/man3/pthread_attr_init.3:81 build/C/man3/pthread_attr_setaffinity_np.3:111 build/C/man3/pthread_attr_setdetachstate.3:89 build/C/man3/pthread_attr_setguardsize.3:108 build/C/man3/pthread_attr_setschedparam.3:91 build/C/man3/pthread_attr_setscope.3:109 build/C/man3/pthread_attr_setstack.3:114 build/C/man3/pthread_attr_setstackaddr.3:86 build/C/man3/pthread_attr_setstacksize.3:85 build/C/man3/pthread_cancel.3:124 build/C/man3/pthread_cleanup_push.3:127 build/C/man3/pthread_create.3:148 build/C/man3/pthread_detach.3:66 build/C/man3/pthread_equal.3:49 build/C/man3/pthread_exit.3:77 build/C/man3/pthread_getcpuclockid.3:67 build/C/man3/pthread_join.3:100 build/C/man3/pthread_kill.3:68 build/C/man3/pthread_kill_other_threads_np.3:50 build/C/man3/pthread_self.3:52 build/C/man3/pthread_setaffinity_np.3:124 build/C/man3/pthread_setcancelstate.3:115 build/C/man3/pthread_setconcurrency.3:85 build/C/man3/pthread_setname_np.3:104 build/C/man3/pthread_setschedparam.3:143 build/C/man3/pthread_setschedprio.3:85 build/C/man3/pthread_sigmask.3:59 build/C/man3/pthread_yield.3:59
#, no-wrap
msgid "NOTES"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:147
+#: build/C/man3/getcontext.3:149
msgid ""
"The earliest incarnation of this mechanism was the "
"B<setjmp>(3)/B<longjmp>(3) mechanism. Since that does not define the "
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:158
+#: build/C/man3/getcontext.3:160
msgid ""
"When a signal occurs, the current user context is saved and a new context is "
"created by the kernel for the signal handler. Do not leave the handler "
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:158 build/C/man3/makecontext.3:217 build/C/man3/pthread_attr_init.3:295 build/C/man3/pthread_attr_setaffinity_np.3:116 build/C/man3/pthread_attr_setdetachstate.3:109 build/C/man3/pthread_attr_setguardsize.3:156 build/C/man3/pthread_attr_setinheritsched.3:120 build/C/man3/pthread_attr_setschedparam.3:96 build/C/man3/pthread_attr_setschedpolicy.3:92 build/C/man3/pthread_attr_setscope.3:118 build/C/man3/pthread_attr_setstack.3:154 build/C/man3/pthread_attr_setstackaddr.3:108 build/C/man3/pthread_attr_setstacksize.3:109 build/C/man3/pthread_cancel.3:221 build/C/man3/pthread_cleanup_push.3:309 build/C/man3/pthread_cleanup_push_defer_np.3:102 build/C/man3/pthread_create.3:367 build/C/man3/pthread_detach.3:95 build/C/man3/pthread_equal.3:54 build/C/man3/pthread_exit.3:103 build/C/man3/pthread_getattr_np.3:343 build/C/man3/pthread_getcpuclockid.3:167 build/C/man3/pthread_join.3:125 build/C/man3/pthread_kill.3:73 build/C/man3/pthread_kill_other_threads_np.3:64 build/C/man3/pthread_self.3:74 build/C/man3/pthread_setaffinity_np.3:204 build/C/man3/pthread_setcancelstate.3:175 build/C/man3/pthread_setconcurrency.3:98 build/C/man3/pthread_setschedparam.3:429 build/C/man3/pthread_setschedprio.3:89 build/C/man3/pthread_sigmask.3:133 build/C/man3/pthread_sigqueue.3:93 build/C/man3/pthread_testcancel.3:61 build/C/man3/pthread_tryjoin_np.3:133 build/C/man3/pthread_yield.3:59 build/C/man7/pthreads.7:893
+#: build/C/man3/getcontext.3:160 build/C/man3/makecontext.3:220 build/C/man3/pthread_attr_init.3:297 build/C/man3/pthread_attr_setaffinity_np.3:118 build/C/man3/pthread_attr_setdetachstate.3:111 build/C/man3/pthread_attr_setguardsize.3:158 build/C/man3/pthread_attr_setinheritsched.3:122 build/C/man3/pthread_attr_setschedparam.3:98 build/C/man3/pthread_attr_setschedpolicy.3:94 build/C/man3/pthread_attr_setscope.3:120 build/C/man3/pthread_attr_setstack.3:156 build/C/man3/pthread_attr_setstackaddr.3:110 build/C/man3/pthread_attr_setstacksize.3:111 build/C/man3/pthread_cancel.3:223 build/C/man3/pthread_cleanup_push.3:311 build/C/man3/pthread_cleanup_push_defer_np.3:104 build/C/man3/pthread_create.3:369 build/C/man3/pthread_detach.3:97 build/C/man3/pthread_equal.3:56 build/C/man3/pthread_exit.3:105 build/C/man3/pthread_getattr_np.3:345 build/C/man3/pthread_getcpuclockid.3:169 build/C/man3/pthread_join.3:127 build/C/man3/pthread_kill.3:75 build/C/man3/pthread_kill_other_threads_np.3:66 build/C/man3/pthread_self.3:76 build/C/man3/pthread_setaffinity_np.3:206 build/C/man3/pthread_setcancelstate.3:177 build/C/man3/pthread_setconcurrency.3:100 build/C/man3/pthread_setname_np.3:198 build/C/man3/pthread_setschedparam.3:431 build/C/man3/pthread_setschedprio.3:91 build/C/man3/pthread_sigmask.3:135 build/C/man3/pthread_sigqueue.3:95 build/C/man3/pthread_testcancel.3:63 build/C/man3/pthread_tryjoin_np.3:135 build/C/man3/pthread_yield.3:62 build/C/man7/pthreads.7:895
#, no-wrap
msgid "SEE ALSO"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:165
+#: build/C/man3/getcontext.3:167
msgid ""
"B<sigaction>(2), B<sigaltstack>(2), B<sigprocmask>(2), B<longjmp>(3), "
"B<makecontext>(3), B<sigsetjmp>(3)"
msgstr ""
#. type: SH
-#: build/C/man2/getcontext.2:165 build/C/man3/makecontext.3:223 build/C/man3/pthread_attr_init.3:309 build/C/man3/pthread_attr_setaffinity_np.3:122 build/C/man3/pthread_attr_setdetachstate.3:115 build/C/man3/pthread_attr_setguardsize.3:164 build/C/man3/pthread_attr_setinheritsched.3:129 build/C/man3/pthread_attr_setschedparam.3:106 build/C/man3/pthread_attr_setschedpolicy.3:101 build/C/man3/pthread_attr_setscope.3:126 build/C/man3/pthread_attr_setstack.3:164 build/C/man3/pthread_attr_setstackaddr.3:114 build/C/man3/pthread_attr_setstacksize.3:116 build/C/man3/pthread_cancel.3:231 build/C/man3/pthread_cleanup_push.3:315 build/C/man3/pthread_cleanup_push_defer_np.3:108 build/C/man3/pthread_create.3:378 build/C/man3/pthread_detach.3:102 build/C/man3/pthread_equal.3:58 build/C/man3/pthread_exit.3:107 build/C/man3/pthread_getattr_np.3:357 build/C/man3/pthread_getcpuclockid.3:175 build/C/man3/pthread_join.3:132 build/C/man3/pthread_kill.3:82 build/C/man3/pthread_kill_other_threads_np.3:70 build/C/man3/pthread_self.3:78 build/C/man3/pthread_setaffinity_np.3:212 build/C/man3/pthread_setcancelstate.3:180 build/C/man3/pthread_setconcurrency.3:101 build/C/man3/pthread_setschedparam.3:441 build/C/man3/pthread_setschedprio.3:101 build/C/man3/pthread_sigmask.3:142 build/C/man3/pthread_sigqueue.3:101 build/C/man3/pthread_testcancel.3:66 build/C/man3/pthread_tryjoin_np.3:138 build/C/man3/pthread_yield.3:63 build/C/man7/pthreads.7:927
+#: build/C/man3/getcontext.3:167 build/C/man3/makecontext.3:226 build/C/man3/pthread_attr_init.3:313 build/C/man3/pthread_attr_setaffinity_np.3:124 build/C/man3/pthread_attr_setdetachstate.3:117 build/C/man3/pthread_attr_setguardsize.3:166 build/C/man3/pthread_attr_setinheritsched.3:133 build/C/man3/pthread_attr_setschedparam.3:110 build/C/man3/pthread_attr_setschedpolicy.3:105 build/C/man3/pthread_attr_setscope.3:130 build/C/man3/pthread_attr_setstack.3:168 build/C/man3/pthread_attr_setstackaddr.3:116 build/C/man3/pthread_attr_setstacksize.3:118 build/C/man3/pthread_cancel.3:235 build/C/man3/pthread_cleanup_push.3:317 build/C/man3/pthread_cleanup_push_defer_np.3:110 build/C/man3/pthread_create.3:382 build/C/man3/pthread_detach.3:104 build/C/man3/pthread_equal.3:60 build/C/man3/pthread_exit.3:109 build/C/man3/pthread_getattr_np.3:361 build/C/man3/pthread_getcpuclockid.3:177 build/C/man3/pthread_join.3:134 build/C/man3/pthread_kill.3:84 build/C/man3/pthread_kill_other_threads_np.3:72 build/C/man3/pthread_self.3:80 build/C/man3/pthread_setaffinity_np.3:214 build/C/man3/pthread_setcancelstate.3:182 build/C/man3/pthread_setconcurrency.3:103 build/C/man3/pthread_setname_np.3:204 build/C/man3/pthread_setschedparam.3:445 build/C/man3/pthread_setschedprio.3:105 build/C/man3/pthread_sigmask.3:144 build/C/man3/pthread_sigqueue.3:103 build/C/man3/pthread_testcancel.3:68 build/C/man3/pthread_tryjoin_np.3:140 build/C/man3/pthread_yield.3:66 build/C/man7/pthreads.7:929
#, no-wrap
msgid "COLOPHON"
msgstr ""
#. type: Plain text
-#: build/C/man2/getcontext.2:172 build/C/man3/makecontext.3:230 build/C/man3/pthread_attr_init.3:316 build/C/man3/pthread_attr_setaffinity_np.3:129 build/C/man3/pthread_attr_setdetachstate.3:122 build/C/man3/pthread_attr_setguardsize.3:171 build/C/man3/pthread_attr_setinheritsched.3:136 build/C/man3/pthread_attr_setschedparam.3:113 build/C/man3/pthread_attr_setschedpolicy.3:108 build/C/man3/pthread_attr_setscope.3:133 build/C/man3/pthread_attr_setstack.3:171 build/C/man3/pthread_attr_setstackaddr.3:121 build/C/man3/pthread_attr_setstacksize.3:123 build/C/man3/pthread_cancel.3:238 build/C/man3/pthread_cleanup_push.3:322 build/C/man3/pthread_cleanup_push_defer_np.3:115 build/C/man3/pthread_create.3:385 build/C/man3/pthread_detach.3:109 build/C/man3/pthread_equal.3:65 build/C/man3/pthread_exit.3:114 build/C/man3/pthread_getattr_np.3:364 build/C/man3/pthread_getcpuclockid.3:182 build/C/man3/pthread_join.3:139 build/C/man3/pthread_kill.3:89 build/C/man3/pthread_kill_other_threads_np.3:77 build/C/man3/pthread_self.3:85 build/C/man3/pthread_setaffinity_np.3:219 build/C/man3/pthread_setcancelstate.3:187 build/C/man3/pthread_setconcurrency.3:108 build/C/man3/pthread_setschedparam.3:448 build/C/man3/pthread_setschedprio.3:108 build/C/man3/pthread_sigmask.3:149 build/C/man3/pthread_sigqueue.3:108 build/C/man3/pthread_testcancel.3:73 build/C/man3/pthread_tryjoin_np.3:145 build/C/man3/pthread_yield.3:70 build/C/man7/pthreads.7:934
+#: build/C/man3/getcontext.3:174 build/C/man3/makecontext.3:233 build/C/man3/pthread_attr_init.3:320 build/C/man3/pthread_attr_setaffinity_np.3:131 build/C/man3/pthread_attr_setdetachstate.3:124 build/C/man3/pthread_attr_setguardsize.3:173 build/C/man3/pthread_attr_setinheritsched.3:140 build/C/man3/pthread_attr_setschedparam.3:117 build/C/man3/pthread_attr_setschedpolicy.3:112 build/C/man3/pthread_attr_setscope.3:137 build/C/man3/pthread_attr_setstack.3:175 build/C/man3/pthread_attr_setstackaddr.3:123 build/C/man3/pthread_attr_setstacksize.3:125 build/C/man3/pthread_cancel.3:242 build/C/man3/pthread_cleanup_push.3:324 build/C/man3/pthread_cleanup_push_defer_np.3:117 build/C/man3/pthread_create.3:389 build/C/man3/pthread_detach.3:111 build/C/man3/pthread_equal.3:67 build/C/man3/pthread_exit.3:116 build/C/man3/pthread_getattr_np.3:368 build/C/man3/pthread_getcpuclockid.3:184 build/C/man3/pthread_join.3:141 build/C/man3/pthread_kill.3:91 build/C/man3/pthread_kill_other_threads_np.3:79 build/C/man3/pthread_self.3:87 build/C/man3/pthread_setaffinity_np.3:221 build/C/man3/pthread_setcancelstate.3:189 build/C/man3/pthread_setconcurrency.3:110 build/C/man3/pthread_setname_np.3:211 build/C/man3/pthread_setschedparam.3:452 build/C/man3/pthread_setschedprio.3:112 build/C/man3/pthread_sigmask.3:151 build/C/man3/pthread_sigqueue.3:110 build/C/man3/pthread_testcancel.3:75 build/C/man3/pthread_tryjoin_np.3:147 build/C/man3/pthread_yield.3:73 build/C/man7/pthreads.7:936
msgid ""
-"This page is part of release 3.41 of the Linux I<man-pages> project. A "
+"This page is part of release 3.50 of the Linux I<man-pages> project. A "
"description of the project, and information about reporting bugs, can be "
"found at http://www.kernel.org/doc/man-pages/."
msgstr ""
#. type: TH
-#: build/C/man3/makecontext.3:25
+#: build/C/man3/makecontext.3:28
#, no-wrap
msgid "MAKECONTEXT"
msgstr ""
#. type: TH
-#: build/C/man3/makecontext.3:25
+#: build/C/man3/makecontext.3:28
#, no-wrap
-msgid "2009-03-31"
+msgid "2013-02-12"
msgstr ""
#. type: TH
-#: build/C/man3/makecontext.3:25
+#: build/C/man3/makecontext.3:28
#, no-wrap
msgid "GNU"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:28
+#: build/C/man3/makecontext.3:31
msgid "makecontext, swapcontext - manipulate user context"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:33
+#: build/C/man3/makecontext.3:36
msgid ""
"B<void makecontext(ucontext_t *>I<ucp>B<, void (*>I<func>B<)(),> B<int "
">I<argc>B<, ...);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:35
+#: build/C/man3/makecontext.3:38
msgid "B<int swapcontext(ucontext_t *>I<oucp>B<, ucontext_t *>I<ucp>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:46
+#: build/C/man3/makecontext.3:49
msgid ""
"In a System V-like environment, one has the type I<ucontext_t> defined in "
-"I<E<lt>ucontext.hE<gt>> and the four functions B<getcontext>(2), "
-"B<setcontext>(2), B<makecontext>() and B<swapcontext>() that allow "
+"I<E<lt>ucontext.hE<gt>> and the four functions B<getcontext>(3), "
+"B<setcontext>(3), B<makecontext>() and B<swapcontext>() that allow "
"user-level context switching between multiple threads of control within a "
"process."
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:49
-msgid "For the type and the first two functions, see B<getcontext>(2)."
+#: build/C/man3/makecontext.3:52
+msgid "For the type and the first two functions, see B<getcontext>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:61
+#: build/C/man3/makecontext.3:64
msgid ""
"The B<makecontext>() function modifies the context pointed to by I<ucp> "
-"(which was obtained from a call to B<getcontext>(2)). Before invoking "
+"(which was obtained from a call to B<getcontext>(3)). Before invoking "
"B<makecontext>(), the caller must allocate a new stack for this context and "
"assign its address to I<ucp-E<gt>uc_stack>, and define a successor context "
"and assign its address to I<ucp-E<gt>uc_link>."
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:75
+#: build/C/man3/makecontext.3:78
msgid ""
-"When this context is later activated (using B<setcontext>(2) or "
+"When this context is later activated (using B<setcontext>(3) or "
"B<swapcontext>()) the function I<func> is called, and passed the series of "
"integer (I<int>) arguments that follow I<argc>; the caller must specify the "
"number of these arguments in I<argc>. When this function returns, the "
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:81
+#: build/C/man3/makecontext.3:84
msgid ""
"The B<swapcontext>() function saves the current context in the structure "
"pointed to by I<oucp>, and then activates the context pointed to by I<ucp>."
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:93
+#: build/C/man3/makecontext.3:96
msgid ""
"When successful, B<swapcontext>() does not return. (But we may return "
"later, in case I<oucp> is activated, in which case it looks like "
msgstr ""
#. type: TP
-#: build/C/man3/makecontext.3:94 build/C/man3/pthread_attr_setaffinity_np.3:100 build/C/man3/pthread_getattr_np.3:75
+#: build/C/man3/makecontext.3:97 build/C/man3/pthread_attr_setaffinity_np.3:102 build/C/man3/pthread_getattr_np.3:77
#, no-wrap
msgid "B<ENOMEM>"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:97
+#: build/C/man3/makecontext.3:100
msgid "Insufficient stack space left."
msgstr ""
#. type: SH
-#: build/C/man3/makecontext.3:97 build/C/man3/pthread_attr_setaffinity_np.3:104 build/C/man3/pthread_attr_setguardsize.3:102 build/C/man3/pthread_attr_setstack.3:108 build/C/man3/pthread_attr_setstackaddr.3:79 build/C/man3/pthread_attr_setstacksize.3:79 build/C/man3/pthread_getattr_np.3:94 build/C/man3/pthread_getcpuclockid.3:61 build/C/man3/pthread_setaffinity_np.3:117 build/C/man3/pthread_setconcurrency.3:79 build/C/man3/pthread_setschedprio.3:79 build/C/man3/pthread_sigqueue.3:87 build/C/man3/pthread_tryjoin_np.3:108
+#: build/C/man3/makecontext.3:100 build/C/man3/pthread_attr_setaffinity_np.3:106 build/C/man3/pthread_attr_setguardsize.3:104 build/C/man3/pthread_attr_setstack.3:110 build/C/man3/pthread_attr_setstackaddr.3:81 build/C/man3/pthread_attr_setstacksize.3:81 build/C/man3/pthread_getattr_np.3:96 build/C/man3/pthread_getcpuclockid.3:63 build/C/man3/pthread_setaffinity_np.3:119 build/C/man3/pthread_setconcurrency.3:81 build/C/man3/pthread_setname_np.3:100 build/C/man3/pthread_setschedprio.3:81 build/C/man3/pthread_sigqueue.3:89 build/C/man3/pthread_tryjoin_np.3:110
#, no-wrap
msgid "VERSIONS"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:102
+#: build/C/man3/makecontext.3:105
msgid ""
"B<makecontext>() and B<swapcontext>() are provided in glibc since version "
"2.1."
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:110
+#: build/C/man3/makecontext.3:113
msgid ""
"SUSv2, POSIX.1-2001. POSIX.1-2008 removes the specifications of "
"B<makecontext>() and B<swapcontext>(), citing portability issues, and "
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:118
+#: build/C/man3/makecontext.3:121
msgid ""
"The interpretation of I<ucp-E<gt>uc_stack> is just as in B<sigaltstack>(2), "
"namely, this struct contains the start and length of a memory area to be "
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:134
+#: build/C/man3/makecontext.3:137
msgid ""
"On architectures where I<int> and pointer types are the same size (e.g., "
"x86-32, where both types are 32 bits), you may be able to get away with "
msgstr ""
#. type: SH
-#: build/C/man3/makecontext.3:134 build/C/man3/pthread_attr_init.3:85 build/C/man3/pthread_attr_setdetachstate.3:106 build/C/man3/pthread_attr_setguardsize.3:153 build/C/man3/pthread_attr_setinheritsched.3:117 build/C/man3/pthread_attr_setschedparam.3:93 build/C/man3/pthread_attr_setschedpolicy.3:89 build/C/man3/pthread_attr_setstack.3:151 build/C/man3/pthread_attr_setstacksize.3:106 build/C/man3/pthread_cancel.3:130 build/C/man3/pthread_cleanup_push.3:149 build/C/man3/pthread_create.3:200 build/C/man3/pthread_detach.3:91 build/C/man3/pthread_getattr_np.3:99 build/C/man3/pthread_getcpuclockid.3:76 build/C/man3/pthread_join.3:122 build/C/man3/pthread_setaffinity_np.3:152 build/C/man3/pthread_setcancelstate.3:172 build/C/man3/pthread_setschedparam.3:147 build/C/man3/pthread_sigmask.3:59 build/C/man3/pthread_testcancel.3:58 build/C/man3/pthread_tryjoin_np.3:113
+#: build/C/man3/makecontext.3:137 build/C/man3/pthread_attr_init.3:87 build/C/man3/pthread_attr_setdetachstate.3:108 build/C/man3/pthread_attr_setguardsize.3:155 build/C/man3/pthread_attr_setinheritsched.3:119 build/C/man3/pthread_attr_setschedparam.3:95 build/C/man3/pthread_attr_setschedpolicy.3:91 build/C/man3/pthread_attr_setstack.3:153 build/C/man3/pthread_attr_setstacksize.3:108 build/C/man3/pthread_cancel.3:132 build/C/man3/pthread_cleanup_push.3:151 build/C/man3/pthread_create.3:202 build/C/man3/pthread_detach.3:93 build/C/man3/pthread_getattr_np.3:101 build/C/man3/pthread_getcpuclockid.3:78 build/C/man3/pthread_join.3:124 build/C/man3/pthread_setaffinity_np.3:154 build/C/man3/pthread_setcancelstate.3:174 build/C/man3/pthread_setname_np.3:112 build/C/man3/pthread_setschedparam.3:149 build/C/man3/pthread_sigmask.3:61 build/C/man3/pthread_testcancel.3:60 build/C/man3/pthread_tryjoin_np.3:115
#, no-wrap
msgid "EXAMPLE"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:142
+#: build/C/man3/makecontext.3:145
msgid ""
-"The example program below demonstrates the use of B<getcontext>(2), "
+"The example program below demonstrates the use of B<getcontext>(3), "
"B<makecontext>(), and B<swapcontext>(). Running the program produces the "
"following output:"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:154
+#: build/C/man3/makecontext.3:157
#, no-wrap
msgid ""
"$B< ./a.out>\n"
msgstr ""
#. type: SS
-#: build/C/man3/makecontext.3:156 build/C/man3/pthread_attr_init.3:146 build/C/man3/pthread_cancel.3:146 build/C/man3/pthread_cleanup_push.3:225 build/C/man3/pthread_create.3:239 build/C/man3/pthread_getattr_np.3:177 build/C/man3/pthread_getcpuclockid.3:93 build/C/man3/pthread_setschedparam.3:222 build/C/man3/pthread_sigmask.3:77
+#: build/C/man3/makecontext.3:159 build/C/man3/pthread_attr_init.3:148 build/C/man3/pthread_cancel.3:148 build/C/man3/pthread_cleanup_push.3:227 build/C/man3/pthread_create.3:241 build/C/man3/pthread_getattr_np.3:179 build/C/man3/pthread_getcpuclockid.3:95 build/C/man3/pthread_setname_np.3:138 build/C/man3/pthread_setschedparam.3:224 build/C/man3/pthread_sigmask.3:79
#, no-wrap
msgid "Program source"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:162
+#: build/C/man3/makecontext.3:165
#, no-wrap
msgid ""
"#include E<lt>ucontext.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:164
+#: build/C/man3/makecontext.3:167
#, no-wrap
msgid "static ucontext_t uctx_main, uctx_func1, uctx_func2;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:167
+#: build/C/man3/makecontext.3:170
#, no-wrap
msgid ""
"#define handle_error(msg) \\e\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:177
+#: build/C/man3/makecontext.3:180
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:187
+#: build/C/man3/makecontext.3:190
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:193
+#: build/C/man3/makecontext.3:196
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:200
+#: build/C/man3/makecontext.3:203
#, no-wrap
msgid ""
" if (getcontext(&uctx_func1) == -1)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:208
+#: build/C/man3/makecontext.3:211
#, no-wrap
msgid ""
" if (getcontext(&uctx_func2) == -1)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:212
+#: build/C/man3/makecontext.3:215
#, no-wrap
msgid ""
" printf(\"main: swapcontext(&uctx_main, &uctx_func2)\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:216
+#: build/C/man3/makecontext.3:219
#, no-wrap
msgid ""
" printf(\"main: exiting\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/makecontext.3:223
+#: build/C/man3/makecontext.3:226
msgid ""
-"B<getcontext>(2), B<sigaction>(2), B<sigaltstack>(2), B<sigprocmask>(2), "
+"B<sigaction>(2), B<sigaltstack>(2), B<sigprocmask>(2), B<getcontext>(3), "
"B<sigsetjmp>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_init.3:24
+#: build/C/man3/pthread_attr_init.3:26
#, no-wrap
msgid "PTHREAD_ATTR_INIT"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_init.3:24
+#: build/C/man3/pthread_attr_init.3:26
#, no-wrap
msgid "2008-11-11"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:28
+#: build/C/man3/pthread_attr_init.3:30
msgid ""
"pthread_attr_init, pthread_attr_destroy - initialize and destroy thread "
"attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:31 build/C/man3/pthread_attr_setdetachstate.3:31 build/C/man3/pthread_attr_setguardsize.3:31 build/C/man3/pthread_attr_setinheritsched.3:31 build/C/man3/pthread_attr_setschedparam.3:31 build/C/man3/pthread_attr_setschedpolicy.3:31 build/C/man3/pthread_attr_setscope.3:31 build/C/man3/pthread_attr_setstack.3:31 build/C/man3/pthread_attr_setstackaddr.3:31 build/C/man3/pthread_attr_setstacksize.3:31 build/C/man3/pthread_cancel.3:30 build/C/man3/pthread_cleanup_push.3:31 build/C/man3/pthread_cleanup_push_defer_np.3:31 build/C/man3/pthread_create.3:30 build/C/man3/pthread_detach.3:30 build/C/man3/pthread_equal.3:30 build/C/man3/pthread_exit.3:30 build/C/man3/pthread_join.3:30 build/C/man3/pthread_kill_other_threads_np.3:30 build/C/man3/pthread_self.3:30 build/C/man3/pthread_setcancelstate.3:31 build/C/man3/pthread_setconcurrency.3:30 build/C/man3/pthread_setschedparam.3:31 build/C/man3/pthread_setschedprio.3:30 build/C/man3/pthread_sigqueue.3:29 build/C/man3/pthread_testcancel.3:30 build/C/man3/pthread_yield.3:29
+#: build/C/man3/pthread_attr_init.3:33 build/C/man3/pthread_attr_setdetachstate.3:33 build/C/man3/pthread_attr_setguardsize.3:33 build/C/man3/pthread_attr_setinheritsched.3:33 build/C/man3/pthread_attr_setschedparam.3:33 build/C/man3/pthread_attr_setschedpolicy.3:33 build/C/man3/pthread_attr_setscope.3:33 build/C/man3/pthread_attr_setstack.3:33 build/C/man3/pthread_attr_setstackaddr.3:33 build/C/man3/pthread_attr_setstacksize.3:33 build/C/man3/pthread_cancel.3:32 build/C/man3/pthread_cleanup_push.3:33 build/C/man3/pthread_cleanup_push_defer_np.3:33 build/C/man3/pthread_create.3:32 build/C/man3/pthread_detach.3:32 build/C/man3/pthread_equal.3:32 build/C/man3/pthread_exit.3:32 build/C/man3/pthread_join.3:32 build/C/man3/pthread_kill_other_threads_np.3:32 build/C/man3/pthread_self.3:32 build/C/man3/pthread_setcancelstate.3:33 build/C/man3/pthread_setconcurrency.3:32 build/C/man3/pthread_setschedparam.3:33 build/C/man3/pthread_setschedprio.3:32 build/C/man3/pthread_sigqueue.3:31 build/C/man3/pthread_testcancel.3:32
#, no-wrap
msgid "B<#include E<lt>pthread.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:34
+#: build/C/man3/pthread_attr_init.3:36
#, no-wrap
msgid ""
"B<int pthread_attr_init(pthread_attr_t *>I<attr>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:36 build/C/man3/pthread_attr_setaffinity_np.3:39 build/C/man3/pthread_attr_setdetachstate.3:38 build/C/man3/pthread_attr_setguardsize.3:38 build/C/man3/pthread_attr_setinheritsched.3:38 build/C/man3/pthread_attr_setschedparam.3:38 build/C/man3/pthread_attr_setschedpolicy.3:38 build/C/man3/pthread_attr_setscope.3:38 build/C/man3/pthread_attr_setstack.3:38 build/C/man3/pthread_attr_setstackaddr.3:38 build/C/man3/pthread_attr_setstacksize.3:38 build/C/man3/pthread_cancel.3:34 build/C/man3/pthread_cleanup_push.3:37 build/C/man3/pthread_equal.3:34 build/C/man3/pthread_exit.3:34 build/C/man3/pthread_getattr_np.3:35 build/C/man3/pthread_getcpuclockid.3:35 build/C/man3/pthread_self.3:34 build/C/man3/pthread_setaffinity_np.3:39 build/C/man3/pthread_setcancelstate.3:36 build/C/man3/pthread_setconcurrency.3:35 build/C/man3/pthread_setschedparam.3:38 build/C/man3/pthread_setschedprio.3:34 build/C/man3/pthread_testcancel.3:34
+#: build/C/man3/pthread_attr_init.3:38 build/C/man3/pthread_attr_setaffinity_np.3:41 build/C/man3/pthread_attr_setdetachstate.3:40 build/C/man3/pthread_attr_setguardsize.3:40 build/C/man3/pthread_attr_setinheritsched.3:40 build/C/man3/pthread_attr_setschedparam.3:40 build/C/man3/pthread_attr_setschedpolicy.3:40 build/C/man3/pthread_attr_setscope.3:40 build/C/man3/pthread_attr_setstack.3:40 build/C/man3/pthread_attr_setstackaddr.3:40 build/C/man3/pthread_attr_setstacksize.3:40 build/C/man3/pthread_cancel.3:36 build/C/man3/pthread_cleanup_push.3:39 build/C/man3/pthread_equal.3:36 build/C/man3/pthread_exit.3:36 build/C/man3/pthread_getattr_np.3:37 build/C/man3/pthread_getcpuclockid.3:37 build/C/man3/pthread_self.3:36 build/C/man3/pthread_setaffinity_np.3:41 build/C/man3/pthread_setcancelstate.3:38 build/C/man3/pthread_setconcurrency.3:37 build/C/man3/pthread_setschedparam.3:40 build/C/man3/pthread_setschedprio.3:36 build/C/man3/pthread_testcancel.3:36
#, no-wrap
msgid "Compile and link with I<-pthread>.\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:48
+#: build/C/man3/pthread_attr_init.3:50
msgid ""
"The B<pthread_attr_init>() function initializes the thread attributes "
"object pointed to by I<attr> with default attribute values. After this "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:53
+#: build/C/man3/pthread_attr_init.3:55
msgid ""
"Calling B<pthread_attr_init>() on a thread attributes object that has "
"already been initialized results in undefined behavior."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:60
+#: build/C/man3/pthread_attr_init.3:62
msgid ""
"When a thread attributes object is no longer required, it should be "
"destroyed using the B<pthread_attr_destroy>() function. Destroying a "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:66
+#: build/C/man3/pthread_attr_init.3:68
msgid ""
"Once a thread attributes object has been destroyed, it can be reinitialized "
"using B<pthread_attr_init>(). Any other use of a destroyed thread "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:69 build/C/man3/pthread_attr_setaffinity_np.3:77 build/C/man3/pthread_attr_setdetachstate.3:78 build/C/man3/pthread_attr_setguardsize.3:91 build/C/man3/pthread_attr_setinheritsched.3:85 build/C/man3/pthread_attr_setschedparam.3:75 build/C/man3/pthread_attr_setschedpolicy.3:73 build/C/man3/pthread_attr_setscope.3:92 build/C/man3/pthread_attr_setstack.3:86 build/C/man3/pthread_attr_setstackaddr.3:75 build/C/man3/pthread_attr_setstacksize.3:62 build/C/man3/pthread_setaffinity_np.3:78 build/C/man3/pthread_setcancelstate.3:93
+#: build/C/man3/pthread_attr_init.3:71 build/C/man3/pthread_attr_setaffinity_np.3:79 build/C/man3/pthread_attr_setdetachstate.3:80 build/C/man3/pthread_attr_setguardsize.3:93 build/C/man3/pthread_attr_setinheritsched.3:87 build/C/man3/pthread_attr_setschedparam.3:77 build/C/man3/pthread_attr_setschedpolicy.3:75 build/C/man3/pthread_attr_setscope.3:94 build/C/man3/pthread_attr_setstack.3:88 build/C/man3/pthread_attr_setstackaddr.3:77 build/C/man3/pthread_attr_setstacksize.3:64 build/C/man3/pthread_setaffinity_np.3:80 build/C/man3/pthread_setcancelstate.3:95 build/C/man3/pthread_setname_np.3:75
msgid ""
"On success, these functions return 0; on error, they return a nonzero error "
"number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:77
+#: build/C/man3/pthread_attr_init.3:79
msgid ""
"POSIX.1-2001 documents an B<ENOMEM> error for B<pthread_attr_init>(); on "
"Linux these functions always succeed (but portable and future-proof "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:79 build/C/man3/pthread_attr_setdetachstate.3:87 build/C/man3/pthread_attr_setguardsize.3:106 build/C/man3/pthread_attr_setinheritsched.3:101 build/C/man3/pthread_attr_setschedparam.3:89 build/C/man3/pthread_attr_setschedpolicy.3:89 build/C/man3/pthread_attr_setscope.3:107 build/C/man3/pthread_attr_setstack.3:112 build/C/man3/pthread_attr_setstacksize.3:83 build/C/man3/pthread_cancel.3:122 build/C/man3/pthread_cleanup_push.3:125 build/C/man3/pthread_create.3:146 build/C/man3/pthread_detach.3:64 build/C/man3/pthread_equal.3:47 build/C/man3/pthread_exit.3:75 build/C/man3/pthread_getcpuclockid.3:65 build/C/man3/pthread_join.3:98 build/C/man3/pthread_kill.3:66 build/C/man3/pthread_self.3:50 build/C/man3/pthread_setcancelstate.3:113 build/C/man3/pthread_setconcurrency.3:83 build/C/man3/pthread_setschedparam.3:141 build/C/man3/pthread_setschedprio.3:83 build/C/man3/pthread_sigmask.3:57 build/C/man3/pthread_testcancel.3:58
+#: build/C/man3/pthread_attr_init.3:81 build/C/man3/pthread_attr_setdetachstate.3:89 build/C/man3/pthread_attr_setguardsize.3:108 build/C/man3/pthread_attr_setinheritsched.3:103 build/C/man3/pthread_attr_setschedparam.3:91 build/C/man3/pthread_attr_setschedpolicy.3:91 build/C/man3/pthread_attr_setscope.3:109 build/C/man3/pthread_attr_setstack.3:114 build/C/man3/pthread_attr_setstacksize.3:85 build/C/man3/pthread_cancel.3:124 build/C/man3/pthread_cleanup_push.3:127 build/C/man3/pthread_create.3:148 build/C/man3/pthread_detach.3:66 build/C/man3/pthread_equal.3:49 build/C/man3/pthread_exit.3:77 build/C/man3/pthread_getcpuclockid.3:67 build/C/man3/pthread_join.3:100 build/C/man3/pthread_kill.3:68 build/C/man3/pthread_self.3:52 build/C/man3/pthread_setcancelstate.3:115 build/C/man3/pthread_setconcurrency.3:85 build/C/man3/pthread_setschedparam.3:143 build/C/man3/pthread_setschedprio.3:85 build/C/man3/pthread_sigmask.3:59 build/C/man3/pthread_testcancel.3:60
msgid "POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:85
+#: build/C/man3/pthread_attr_init.3:87
msgid ""
"The I<pthread_attr_t> type should be treated as opaque: any access to the "
"object other than via pthreads functions is nonportable and produces "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:94
+#: build/C/man3/pthread_attr_init.3:96
msgid ""
"The program below optionally makes use of B<pthread_attr_init>() and "
"various related functions to initialize a thread attributes object that is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:103
+#: build/C/man3/pthread_attr_init.3:105
msgid ""
"If the program is run with no command-line argument, then it passes NULL as "
"the I<attr> argument of B<pthread_create>(3), so that the thread is created "
#. Results from glibc 2.8, SUSE 11.0; Oct 2008
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:119
+#: build/C/man3/pthread_attr_init.3:121
#, no-wrap
msgid ""
"$B< ulimit -s> # No stack imit ==E<gt> default stack size is 2MB\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:129
+#: build/C/man3/pthread_attr_init.3:131
msgid ""
"When we supply a stack size as a command-line argument, the program "
"initializes a thread attributes object, sets various attributes in that "
#. Results from glibc 2.8, SUSE 11.0; Oct 2008
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:144
+#: build/C/man3/pthread_attr_init.3:146
#, no-wrap
msgid ""
"$B< ./a.out 0x3000000>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:155 build/C/man3/pthread_getattr_np.3:186
+#: build/C/man3/pthread_attr_init.3:157 build/C/man3/pthread_getattr_np.3:188
#, no-wrap
msgid ""
"#define _GNU_SOURCE /* To get pthread_getattr_np() declaration */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:158 build/C/man3/pthread_cancel.3:157 build/C/man3/pthread_cleanup_push.3:237 build/C/man3/pthread_create.3:252 build/C/man3/pthread_getattr_np.3:189 build/C/man3/pthread_getcpuclockid.3:111 build/C/man3/pthread_setaffinity_np.3:170 build/C/man3/pthread_setschedparam.3:235 build/C/man3/pthread_sigmask.3:91
+#: build/C/man3/pthread_attr_init.3:160 build/C/man3/pthread_cancel.3:159 build/C/man3/pthread_cleanup_push.3:239 build/C/man3/pthread_create.3:254 build/C/man3/pthread_getattr_np.3:191 build/C/man3/pthread_getcpuclockid.3:113 build/C/man3/pthread_setaffinity_np.3:172 build/C/man3/pthread_setschedparam.3:237 build/C/man3/pthread_sigmask.3:93
#, no-wrap
msgid ""
"#define handle_error_en(en, msg) \\e\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:166
+#: build/C/man3/pthread_attr_init.3:168
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:174
+#: build/C/man3/pthread_attr_init.3:176
#, no-wrap
msgid ""
" s = pthread_attr_getdetachstate(attr, &i);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:182
+#: build/C/man3/pthread_attr_init.3:184
#, no-wrap
msgid ""
" s = pthread_attr_getscope(attr, &i);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:190
+#: build/C/man3/pthread_attr_init.3:192
#, no-wrap
msgid ""
" s = pthread_attr_getinheritsched(attr, &i);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:199
+#: build/C/man3/pthread_attr_init.3:201
#, no-wrap
msgid ""
" s = pthread_attr_getschedpolicy(attr, &i);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:204
+#: build/C/man3/pthread_attr_init.3:206
#, no-wrap
msgid ""
" s = pthread_attr_getschedparam(attr, &sp);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:209
+#: build/C/man3/pthread_attr_init.3:211
#, no-wrap
msgid ""
" s = pthread_attr_getguardsize(attr, &v);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:216
+#: build/C/man3/pthread_attr_init.3:218
#, no-wrap
msgid ""
" s = pthread_attr_getstack(attr, &stkaddr, &v);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:222
+#: build/C/man3/pthread_attr_init.3:224
#, no-wrap
msgid ""
"static void *\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:226
+#: build/C/man3/pthread_attr_init.3:228
#, no-wrap
msgid ""
" /* pthread_getattr_np() is a non-standard GNU extension that\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:230
+#: build/C/man3/pthread_attr_init.3:232
#, no-wrap
msgid ""
" s = pthread_getattr_np(pthread_self(), &gattr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:233
+#: build/C/man3/pthread_attr_init.3:235
#, no-wrap
msgid ""
" printf(\"Thread attributes:\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:236 build/C/man3/pthread_getattr_np.3:238
+#: build/C/man3/pthread_attr_init.3:238 build/C/man3/pthread_getattr_np.3:240
#, no-wrap
msgid ""
" exit(EXIT_SUCCESS); /* Terminate all threads */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:244
+#: build/C/man3/pthread_attr_init.3:246
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:246 build/C/man3/pthread_setschedparam.3:353
+#: build/C/man3/pthread_attr_init.3:248 build/C/man3/pthread_setschedparam.3:355
#, no-wrap
msgid " attrp = NULL;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:250
+#: build/C/man3/pthread_attr_init.3:252
#, no-wrap
msgid ""
" /* If a command-line argument was supplied, use it to set the\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:254
+#: build/C/man3/pthread_attr_init.3:256
#, no-wrap
msgid ""
" if (argc E<gt> 1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:256
+#: build/C/man3/pthread_attr_init.3:258
#, no-wrap
msgid " attrp = &attr;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:260
+#: build/C/man3/pthread_attr_init.3:262
#, no-wrap
msgid ""
" s = pthread_attr_init(&attr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:264
+#: build/C/man3/pthread_attr_init.3:266
#, no-wrap
msgid ""
" s = pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:268
+#: build/C/man3/pthread_attr_init.3:270
#, no-wrap
msgid ""
" s = pthread_attr_setinheritsched(&attr, PTHREAD_EXPLICIT_SCHED);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:270
+#: build/C/man3/pthread_attr_init.3:272
#, no-wrap
msgid " stack_size = strtoul(argv[1], NULL, 0);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:274
+#: build/C/man3/pthread_attr_init.3:276
#, no-wrap
msgid ""
" s = posix_memalign(&sp, sysconf(_SC_PAGESIZE), stack_size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:276
+#: build/C/man3/pthread_attr_init.3:278
#, no-wrap
msgid " printf(\"posix_memalign() allocated at %p\\en\", sp);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:281
+#: build/C/man3/pthread_attr_init.3:283
#, no-wrap
msgid ""
" s = pthread_attr_setstack(&attr, sp, stack_size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:285 build/C/man3/pthread_getattr_np.3:333
+#: build/C/man3/pthread_attr_init.3:287 build/C/man3/pthread_getattr_np.3:335
#, no-wrap
msgid ""
" s = pthread_create(&thr, attrp, &thread_start, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:291 build/C/man3/pthread_getattr_np.3:339
+#: build/C/man3/pthread_attr_init.3:293 build/C/man3/pthread_getattr_np.3:341
#, no-wrap
msgid ""
" if (attrp != NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:294 build/C/man3/pthread_getattr_np.3:342
+#: build/C/man3/pthread_attr_init.3:296 build/C/man3/pthread_getattr_np.3:344
#, no-wrap
msgid ""
" pause(); /* Terminates when other thread calls exit() */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_init.3:309
+#: build/C/man3/pthread_attr_init.3:313
msgid ""
"B<pthread_attr_setaffinity_np>(3), B<pthread_attr_setdetachstate>(3), "
"B<pthread_attr_setguardsize>(3), B<pthread_attr_setinheritsched>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setaffinity_np.3:24
+#: build/C/man3/pthread_attr_setaffinity_np.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETAFFINITY_NP"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setaffinity_np.3:24 build/C/man3/pthread_getattr_np.3:24 build/C/man3/pthread_setaffinity_np.3:24 build/C/man3/pthread_tryjoin_np.3:24
+#: build/C/man3/pthread_attr_setaffinity_np.3:26 build/C/man3/pthread_getattr_np.3:26 build/C/man3/pthread_setaffinity_np.3:26 build/C/man3/pthread_tryjoin_np.3:26
#, no-wrap
msgid "2010-09-10"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:28
+#: build/C/man3/pthread_attr_setaffinity_np.3:30
msgid ""
"pthread_attr_setaffinity_np, pthread_attr_getaffinity_np - set/get CPU "
"affinity attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:32 build/C/man3/pthread_getattr_np.3:31 build/C/man3/pthread_setaffinity_np.3:32 build/C/man3/pthread_tryjoin_np.3:32
+#: build/C/man3/pthread_attr_setaffinity_np.3:34 build/C/man3/pthread_getattr_np.3:33 build/C/man3/pthread_setaffinity_np.3:34 build/C/man3/pthread_tryjoin_np.3:34 build/C/man3/pthread_yield.3:32
#, no-wrap
msgid ""
"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:37
+#: build/C/man3/pthread_attr_setaffinity_np.3:39
#, no-wrap
msgid ""
"B<int pthread_attr_setaffinity_np(pthread_attr_t *>I<attr>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:52
+#: build/C/man3/pthread_attr_setaffinity_np.3:54
msgid ""
"The B<pthread_attr_setaffinity_np>() function sets the CPU affinity mask "
"attribute of the thread attributes object referred to by I<attr> to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:61
+#: build/C/man3/pthread_attr_setaffinity_np.3:63
msgid ""
"The B<pthread_attr_getaffinity_np>() function returns the CPU affinity mask "
"attribute of the thread attributes object referred to by I<attr> in the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:68
+#: build/C/man3/pthread_attr_setaffinity_np.3:70
msgid ""
"The argument I<cpusetsize> is the length (in bytes) of the buffer pointed to "
"by I<cpuset>. Typically, this argument would be specified as "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:74 build/C/man3/pthread_setaffinity_np.3:65
+#: build/C/man3/pthread_attr_setaffinity_np.3:76 build/C/man3/pthread_setaffinity_np.3:67
msgid ""
"For more details on CPU affinity masks, see B<sched_setaffinity>(2). For a "
"description of a set of macros that can be used to manipulate and inspect "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setaffinity_np.3:78 build/C/man3/pthread_attr_setaffinity_np.3:90 build/C/man3/pthread_attr_setdetachstate.3:81 build/C/man3/pthread_attr_setinheritsched.3:88 build/C/man3/pthread_attr_setschedpolicy.3:76 build/C/man3/pthread_attr_setscope.3:95 build/C/man3/pthread_attr_setstack.3:89 build/C/man3/pthread_attr_setstacksize.3:65 build/C/man3/pthread_create.3:135 build/C/man3/pthread_detach.3:53 build/C/man3/pthread_join.3:83 build/C/man3/pthread_join.3:87 build/C/man3/pthread_kill.3:56 build/C/man3/pthread_setaffinity_np.3:82 build/C/man3/pthread_setaffinity_np.3:91 build/C/man3/pthread_setaffinity_np.3:107 build/C/man3/pthread_setcancelstate.3:97 build/C/man3/pthread_setcancelstate.3:105 build/C/man3/pthread_setconcurrency.3:69 build/C/man3/pthread_setschedparam.3:120 build/C/man3/pthread_setschedprio.3:60 build/C/man3/pthread_sigqueue.3:75
+#: build/C/man3/pthread_attr_setaffinity_np.3:80 build/C/man3/pthread_attr_setaffinity_np.3:92 build/C/man3/pthread_attr_setdetachstate.3:83 build/C/man3/pthread_attr_setinheritsched.3:90 build/C/man3/pthread_attr_setschedpolicy.3:78 build/C/man3/pthread_attr_setscope.3:97 build/C/man3/pthread_attr_setstack.3:91 build/C/man3/pthread_attr_setstacksize.3:67 build/C/man3/pthread_create.3:137 build/C/man3/pthread_detach.3:55 build/C/man3/pthread_join.3:85 build/C/man3/pthread_join.3:89 build/C/man3/pthread_kill.3:58 build/C/man3/pthread_setaffinity_np.3:84 build/C/man3/pthread_setaffinity_np.3:93 build/C/man3/pthread_setaffinity_np.3:109 build/C/man3/pthread_setcancelstate.3:99 build/C/man3/pthread_setcancelstate.3:107 build/C/man3/pthread_setconcurrency.3:71 build/C/man3/pthread_setschedparam.3:122 build/C/man3/pthread_setschedprio.3:62 build/C/man3/pthread_sigqueue.3:77
#, no-wrap
msgid "B<EINVAL>"
msgstr ""
#. The raw sched_getaffinity() system call returns the size (in bytes)
#. of the cpumask_t type.
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:90
+#: build/C/man3/pthread_attr_setaffinity_np.3:92
msgid ""
"(B<pthread_attr_setaffinity_np>()) I<cpuset> specified a CPU that was "
"outside the set supported by the kernel. (The kernel configuration option "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:100
+#: build/C/man3/pthread_attr_setaffinity_np.3:102
msgid ""
"(B<pthread_attr_getaffinity_np>()) A CPU in the affinity mask of the thread "
"attributes object referred to by I<attr> lies outside the range specified by "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:104
+#: build/C/man3/pthread_attr_setaffinity_np.3:106
msgid "(B<pthread_attr_setaffinity_np>()) Could not allocate memory."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:106 build/C/man3/pthread_setaffinity_np.3:119
+#: build/C/man3/pthread_attr_setaffinity_np.3:108 build/C/man3/pthread_setaffinity_np.3:121
msgid "These functions are provided by glibc since version 2.3.4."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:109 build/C/man3/pthread_cleanup_push_defer_np.3:102 build/C/man3/pthread_setaffinity_np.3:122 build/C/man3/pthread_tryjoin_np.3:113
+#: build/C/man3/pthread_attr_setaffinity_np.3:111 build/C/man3/pthread_cleanup_push_defer_np.3:104 build/C/man3/pthread_setaffinity_np.3:124 build/C/man3/pthread_tryjoin_np.3:115
msgid ""
"These functions are nonstandard GNU extensions; hence the suffix \"_np\" "
"(nonportable) in the names."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:116 build/C/man3/pthread_setaffinity_np.3:148
+#: build/C/man3/pthread_attr_setaffinity_np.3:118 build/C/man3/pthread_setaffinity_np.3:150
msgid ""
"In glibc 2.3.3 only, versions of these functions were provided that did not "
"have a I<cpusetsize> argument. Instead the CPU set size given to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setaffinity_np.3:122
+#: build/C/man3/pthread_attr_setaffinity_np.3:124
msgid ""
"B<sched_setaffinity>(2), B<pthread_attr_init>(3), "
"B<pthread_setaffinity_np>(3), B<cpuset>(7), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setdetachstate.3:24
+#: build/C/man3/pthread_attr_setdetachstate.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETDETACHSTATE"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setdetachstate.3:24 build/C/man3/pthread_attr_setschedpolicy.3:24
+#: build/C/man3/pthread_attr_setdetachstate.3:26 build/C/man3/pthread_attr_setschedpolicy.3:26
#, no-wrap
msgid "2010-02-03"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:28
+#: build/C/man3/pthread_attr_setdetachstate.3:30
msgid ""
"pthread_attr_setdetachstate, pthread_attr_getdetachstate - set/get detach "
"state attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:36
+#: build/C/man3/pthread_attr_setdetachstate.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setdetachstate(pthread_attr_t *>I<attr>B<, int "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:51
+#: build/C/man3/pthread_attr_setdetachstate.3:53
msgid ""
"The B<pthread_attr_setdetachstate>() function sets the detach state "
"attribute of the thread attributes object referred to by I<attr> to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:54
+#: build/C/man3/pthread_attr_setdetachstate.3:56
msgid "The following values may be specified in I<detachstate>:"
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setdetachstate.3:54
+#: build/C/man3/pthread_attr_setdetachstate.3:56
#, no-wrap
msgid "B<PTHREAD_CREATE_DETACHED>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:59
+#: build/C/man3/pthread_attr_setdetachstate.3:61
msgid "Threads that are created using I<attr> will be created in a detached state."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setdetachstate.3:59
+#: build/C/man3/pthread_attr_setdetachstate.3:61
#, no-wrap
msgid "B<PTHREAD_CREATE_JOINABLE>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:64
+#: build/C/man3/pthread_attr_setdetachstate.3:66
msgid "Threads that are created using I<attr> will be created in a joinable state."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:68
+#: build/C/man3/pthread_attr_setdetachstate.3:70
msgid ""
"The default setting of the detach state attribute in a newly initialized "
"thread attributes object is B<PTHREAD_CREATE_JOINABLE>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:75
+#: build/C/man3/pthread_attr_setdetachstate.3:77
msgid ""
"The B<pthread_attr_getdetachstate>() returns the detach state attribute of "
"the thread attributes object I<attr> in the buffer pointed to by "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:81
+#: build/C/man3/pthread_attr_setdetachstate.3:83
msgid "B<pthread_attr_setdetachstate>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:85
+#: build/C/man3/pthread_attr_setdetachstate.3:87
msgid "An invalid value was specified in I<detachstate>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:91
+#: build/C/man3/pthread_attr_setdetachstate.3:93
msgid "See B<pthread_create>(3) for more details on detached and joinable threads."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:99
+#: build/C/man3/pthread_attr_setdetachstate.3:101
msgid ""
"A thread that is created in a joinable state should eventually either be "
"joined using B<pthread_join>(3) or detached using B<pthread_detach>(3); see "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:106
+#: build/C/man3/pthread_attr_setdetachstate.3:108
msgid ""
"It is an error to specify the thread ID of a thread that was created in a "
"detached state in a later call to B<pthread_detach>(3) or "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:109 build/C/man3/pthread_attr_setstack.3:154
+#: build/C/man3/pthread_attr_setdetachstate.3:111 build/C/man3/pthread_attr_setstack.3:156
msgid "See B<pthread_attr_init>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setdetachstate.3:115
+#: build/C/man3/pthread_attr_setdetachstate.3:117
msgid ""
"B<pthread_attr_init>(3), B<pthread_create>(3), B<pthread_detach>(3), "
"B<pthread_join>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setguardsize.3:24
+#: build/C/man3/pthread_attr_setguardsize.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETGUARDSIZE"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setguardsize.3:24 build/C/man3/pthread_attr_setscope.3:24 build/C/man3/pthread_attr_setstack.3:24 build/C/man3/pthread_attr_setstackaddr.3:24 build/C/man3/pthread_self.3:24
+#: build/C/man3/pthread_attr_setguardsize.3:26 build/C/man3/pthread_attr_setscope.3:26 build/C/man3/pthread_attr_setstack.3:26 build/C/man3/pthread_attr_setstackaddr.3:26 build/C/man3/pthread_self.3:26
#, no-wrap
msgid "2008-10-24"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:28
+#: build/C/man3/pthread_attr_setguardsize.3:30
msgid ""
"pthread_attr_setguardsize, pthread_attr_getguardsize - set/get guard size "
"attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:36
+#: build/C/man3/pthread_attr_setguardsize.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setguardsize(pthread_attr_t *>I<attr>B<, size_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:47
+#: build/C/man3/pthread_attr_setguardsize.3:49
msgid ""
"The B<pthread_attr_setguardsize>() function sets the guard size attribute "
"of the thread attributes object referred to by I<attr> to the value "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:57
+#: build/C/man3/pthread_attr_setguardsize.3:59
msgid ""
"If I<guardsize> is greater than 0, then for each new thread created using "
"I<attr> the system allocates an additional region of at least I<guardsize> "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:63
+#: build/C/man3/pthread_attr_setguardsize.3:65
msgid ""
"If I<guardsize> is 0, then new threads created with I<attr> will not have a "
"guard area."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:65
+#: build/C/man3/pthread_attr_setguardsize.3:67
msgid "The default guard size is the same as the system page size."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:80
+#: build/C/man3/pthread_attr_setguardsize.3:82
msgid ""
"If the stack address attribute has been set in I<attr> (using "
"B<pthread_attr_setstack>(3) or B<pthread_attr_setstackaddr>(3)), meaning "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:88
+#: build/C/man3/pthread_attr_setguardsize.3:90
msgid ""
"The B<pthread_attr_getguardsize>() function returns the guard size "
"attribute of the thread attributes object referred to by I<attr> in the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:102
+#: build/C/man3/pthread_attr_setguardsize.3:104
msgid ""
"POSIX.1-2001 documents an B<EINVAL> error if I<attr> or I<guardsize> is "
"invalid. On Linux these functions always succeed (but portable and "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:104 build/C/man3/pthread_attr_setstackaddr.3:81 build/C/man3/pthread_attr_setstacksize.3:81
+#: build/C/man3/pthread_attr_setguardsize.3:106 build/C/man3/pthread_attr_setstackaddr.3:83 build/C/man3/pthread_attr_setstacksize.3:83
msgid "These functions are provided by glibc since version 2.1."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:120
+#: build/C/man3/pthread_attr_setguardsize.3:122
msgid ""
"A guard area consists of virtual memory pages that are protected to prevent "
"read and write access. If a thread overflows its stack into the guard area, "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:124
+#: build/C/man3/pthread_attr_setguardsize.3:126
msgid ""
"Setting a guard size of 0 may be useful to save memory in an application "
"that creates many threads and knows that stack overflow can never occur."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:128
+#: build/C/man3/pthread_attr_setguardsize.3:130
msgid ""
"Choosing a guard size larger than the default size may be necessary for "
"detecting stack overflows if a thread allocates large data structures on the "
msgstr ""
#. type: SH
-#: build/C/man3/pthread_attr_setguardsize.3:128 build/C/man3/pthread_attr_setinheritsched.3:101 build/C/man3/pthread_attr_setstacksize.3:94 build/C/man3/pthread_create.3:194 build/C/man3/pthread_exit.3:91
+#: build/C/man3/pthread_attr_setguardsize.3:130 build/C/man3/pthread_attr_setinheritsched.3:103 build/C/man3/pthread_attr_setstacksize.3:96 build/C/man3/pthread_create.3:196 build/C/man3/pthread_exit.3:93
#, no-wrap
msgid "BUGS"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:139
+#: build/C/man3/pthread_attr_setguardsize.3:141
msgid ""
"As at glibc 2.8, the NPTL threading implementation includes the guard area "
"within the stack size allocation, rather than allocating extra space at the "
#. extra space at the end of the stack:
#. http://sourceware.org/ml/libc-alpha/2008-05/msg00086.html
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:153
+#: build/C/man3/pthread_attr_setguardsize.3:155
msgid ""
"The obsolete LinuxThreads implementation did the right thing, allocating "
"extra space at the end of the stack for the guard area."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:156
+#: build/C/man3/pthread_attr_setguardsize.3:158
msgid "See B<pthread_getattr_np>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setguardsize.3:164
+#: build/C/man3/pthread_attr_setguardsize.3:166
msgid ""
"B<mmap>(2), B<mprotect>(2), B<pthread_attr_init>(3), "
"B<pthread_attr_setstack>(3), B<pthread_attr_setstacksize>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setinheritsched.3:24
+#: build/C/man3/pthread_attr_setinheritsched.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETINHERITSCHED"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setinheritsched.3:24 build/C/man3/pthread_attr_setschedparam.3:24 build/C/man3/pthread_attr_setstacksize.3:24 build/C/man3/pthread_create.3:24
+#: build/C/man3/pthread_attr_setinheritsched.3:26 build/C/man3/pthread_attr_setschedparam.3:26 build/C/man3/pthread_attr_setstacksize.3:26
#, no-wrap
msgid "2012-03-15"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:28
+#: build/C/man3/pthread_attr_setinheritsched.3:30
msgid ""
"pthread_attr_setinheritsched, pthread_attr_getinheritsched - set/get inherit "
"scheduler attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:36
+#: build/C/man3/pthread_attr_setinheritsched.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setinheritsched(pthread_attr_t *>I<attr>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:53
+#: build/C/man3/pthread_attr_setinheritsched.3:55
msgid ""
"The B<pthread_attr_setinheritsched>() function sets the inherit scheduler "
"attribute of the thread attributes object referred to by I<attr> to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:56
+#: build/C/man3/pthread_attr_setinheritsched.3:58
msgid "The following values may be specified in I<inheritsched>:"
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setinheritsched.3:56
+#: build/C/man3/pthread_attr_setinheritsched.3:58
#, no-wrap
msgid "B<PTHREAD_INHERIT_SCHED>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:64
+#: build/C/man3/pthread_attr_setinheritsched.3:66
msgid ""
"Threads that are created using I<attr> inherit scheduling attributes from "
"the creating thread; the scheduling attributes in I<attr> are ignored."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setinheritsched.3:64
+#: build/C/man3/pthread_attr_setinheritsched.3:66
#, no-wrap
msgid "B<PTHREAD_EXPLICIT_SCHED>"
msgstr ""
#. FIXME what are the defaults for scheduler settings?
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:71
+#: build/C/man3/pthread_attr_setinheritsched.3:73
msgid ""
"Threads that are created using I<attr> take their scheduling attributes from "
"the values specified by the attributes object."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:75
+#: build/C/man3/pthread_attr_setinheritsched.3:77
msgid ""
"The default setting of the inherit scheduler attribute in a newly "
"initialized thread attributes object is B<PTHREAD_INHERIT_SCHED>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:82
+#: build/C/man3/pthread_attr_setinheritsched.3:84
msgid ""
"The B<pthread_attr_getinheritsched>() returns the inherit scheduler "
"attribute of the thread attributes object I<attr> in the buffer pointed to "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:88
+#: build/C/man3/pthread_attr_setinheritsched.3:90
msgid "B<pthread_attr_setinheritsched>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:92
+#: build/C/man3/pthread_attr_setinheritsched.3:94
msgid "Invalid value in I<inheritsched>."
msgstr ""
#. .SH VERSIONS
#. Available since glibc 2.0.
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:99
+#: build/C/man3/pthread_attr_setinheritsched.3:101
msgid ""
"POSIX.1-2001 also documents an optional B<ENOTSUP> error (\"attempt was made "
"to set the attribute to an unsupported value\") for "
#. FIXME . Track status of the following bug:
#. http://sourceware.org/bugzilla/show_bug.cgi?id=7007
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:117
+#: build/C/man3/pthread_attr_setinheritsched.3:119
msgid ""
"As at glibc 2.8, if a thread attributes object is initialized using "
"B<pthread_attr_init>(3), then the scheduling policy of the attributes object "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:120 build/C/man3/pthread_attr_setschedparam.3:96 build/C/man3/pthread_attr_setschedpolicy.3:92
+#: build/C/man3/pthread_attr_setinheritsched.3:122 build/C/man3/pthread_attr_setschedparam.3:98 build/C/man3/pthread_attr_setschedpolicy.3:94
msgid "See B<pthread_setschedparam>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setinheritsched.3:129
+#: build/C/man3/pthread_attr_setinheritsched.3:133
msgid ""
"B<sched_setscheduler>(2), B<pthread_attr_init>(3), "
"B<pthread_attr_setschedparam>(3), B<pthread_attr_setschedpolicy>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setschedparam.3:24
+#: build/C/man3/pthread_attr_setschedparam.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETSCHEDPARAM"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:28
+#: build/C/man3/pthread_attr_setschedparam.3:30
msgid ""
"pthread_attr_setschedparam, pthread_attr_getschedparam - set/get scheduling "
"parameter attributes in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:36
+#: build/C/man3/pthread_attr_setschedparam.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setschedparam(pthread_attr_t *>I<attr>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:50
+#: build/C/man3/pthread_attr_setschedparam.3:52
msgid ""
"The B<pthread_attr_setschedparam>() function sets the scheduling parameter "
"attributes of the thread attributes object referred to by I<attr> to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:57
+#: build/C/man3/pthread_attr_setschedparam.3:59
msgid ""
"The B<pthread_attr_getschedparam>() returns the scheduling parameter "
"attributes of the thread attributes object I<attr> in the buffer pointed to "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:59
+#: build/C/man3/pthread_attr_setschedparam.3:61
msgid "Scheduling parameters are maintained in the following structure:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:65 build/C/man3/pthread_setschedparam.3:67
+#: build/C/man3/pthread_attr_setschedparam.3:67 build/C/man3/pthread_setschedparam.3:69
#, no-wrap
msgid ""
"struct sched_param {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:72 build/C/man3/pthread_setschedparam.3:74
+#: build/C/man3/pthread_attr_setschedparam.3:74 build/C/man3/pthread_setschedparam.3:76
msgid ""
"As can be seen, only one scheduling parameter is supported. For details of "
"the permitted ranges for scheduling priorities in each scheduling policy, "
#. .SH VERSIONS
#. Available since glibc 2.0.
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:87
+#: build/C/man3/pthread_attr_setschedparam.3:89
msgid ""
"POSIX.1 documents B<EINVAL> and B<ENOTSUP> errors for "
"B<pthread_attr_setschedparam>(). On Linux these functions always succeed "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:93
+#: build/C/man3/pthread_attr_setschedparam.3:95
msgid ""
"See B<pthread_attr_setschedpolicy>(3) for a list of the thread scheduling "
"policies supported on Linux."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedparam.3:106
+#: build/C/man3/pthread_attr_setschedparam.3:110
msgid ""
"B<sched_get_priority_min>(2), B<sched_setscheduler>(2), "
"B<pthread_attr_init>(3), B<pthread_attr_setinheritsched>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setschedpolicy.3:24
+#: build/C/man3/pthread_attr_setschedpolicy.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETSCHEDPOLICY"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:28
+#: build/C/man3/pthread_attr_setschedpolicy.3:30
msgid ""
"pthread_attr_setschedpolicy, pthread_attr_getschedpolicy - set/get "
"scheduling policy attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:36
+#: build/C/man3/pthread_attr_setschedpolicy.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setschedpolicy(pthread_attr_t *>I<attr>B<, int "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:50
+#: build/C/man3/pthread_attr_setschedpolicy.3:52
msgid ""
"The B<pthread_attr_setschedpolicy>() function sets the scheduling policy "
"attribute of the thread attributes object referred to by I<attr> to the "
#. but pthread_attr_setschedpolicy() restricts policy to RR/FIFO/OTHER
#. http://sourceware.org/bugzilla/show_bug.cgi?id=7013
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:63
+#: build/C/man3/pthread_attr_setschedpolicy.3:65
msgid ""
"The supported values for I<policy> are B<SCHED_FIFO>, B<SCHED_RR>, and "
"B<SCHED_OTHER>, with the semantics described in B<sched_setscheduler>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:70
+#: build/C/man3/pthread_attr_setschedpolicy.3:72
msgid ""
"The B<pthread_attr_getschedpolicy>() returns the scheduling policy "
"attribute of the thread attributes object I<attr> in the buffer pointed to "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:76
+#: build/C/man3/pthread_attr_setschedpolicy.3:78
msgid "B<pthread_attr_setschedpolicy>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:80
+#: build/C/man3/pthread_attr_setschedpolicy.3:82
msgid "Invalid value in I<policy>."
msgstr ""
#. .SH VERSIONS
#. Available since glibc 2.0.
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:87
+#: build/C/man3/pthread_attr_setschedpolicy.3:89
msgid ""
"POSIX.1-2001 also documents an optional B<ENOTSUP> error (\"attempt was made "
"to set the attribute to an unsupported value\") for "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setschedpolicy.3:101
+#: build/C/man3/pthread_attr_setschedpolicy.3:105
msgid ""
"B<sched_setscheduler>(2), B<pthread_attr_init>(3), "
"B<pthread_attr_setinheritsched>(3), B<pthread_attr_setschedparam>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setscope.3:24
+#: build/C/man3/pthread_attr_setscope.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETSCOPE"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:28
+#: build/C/man3/pthread_attr_setscope.3:30
msgid ""
"pthread_attr_setscope, pthread_attr_getscope - set/get contention scope "
"attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:36
+#: build/C/man3/pthread_attr_setscope.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setscope(pthread_attr_t *>I<attr>B<, int >I<scope>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:51
+#: build/C/man3/pthread_attr_setscope.3:53
msgid ""
"The B<pthread_attr_setscope>() function sets the contention scope attribute "
"of the thread attributes object referred to by I<attr> to the value "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setscope.3:51
+#: build/C/man3/pthread_attr_setscope.3:53
#, no-wrap
msgid "B<PTHREAD_SCOPE_SYSTEM>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:59
+#: build/C/man3/pthread_attr_setscope.3:61
msgid ""
"The thread competes for resources with all other threads in all processes on "
"the system that are in the same scheduling allocation domain (a group of one "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setscope.3:59
+#: build/C/man3/pthread_attr_setscope.3:61
#, no-wrap
msgid "B<PTHREAD_SCOPE_PROCESS>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:74
+#: build/C/man3/pthread_attr_setscope.3:76
msgid ""
"The thread competes for resources with all other threads in the same process "
"that were also created with the B<PTHREAD_SCOPE_PROCESS> contention scope. "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:81
+#: build/C/man3/pthread_attr_setscope.3:83
msgid ""
"POSIX.1-2001 only requires that an implementation support one of these "
"contention scopes, but permits both to be supported. Linux supports "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:89
+#: build/C/man3/pthread_attr_setscope.3:91
msgid ""
"The B<pthread_attr_getscope>() function returns the contention scope "
"attribute of the thread attributes object referred to by I<attr> in the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:95
+#: build/C/man3/pthread_attr_setscope.3:97
msgid "B<pthread_attr_setscope>() can fail with the following errors:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:99
+#: build/C/man3/pthread_attr_setscope.3:101
msgid "An invalid value was specified in I<scope>."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_attr_setscope.3:99
+#: build/C/man3/pthread_attr_setscope.3:101
#, no-wrap
msgid "B<ENOTSUP>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:105
+#: build/C/man3/pthread_attr_setscope.3:107
msgid ""
"I<scope> specified the value B<PTHREAD_SCOPE_PROCESS>, which is not "
"supported on Linux."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:115
+#: build/C/man3/pthread_attr_setscope.3:117
msgid ""
"The B<PTHREAD_SCOPE_SYSTEM> contention scope typically indicates that a "
-"userspace thread is bound directly to a single kernel-scheduling entity. "
+"user-space thread is bound directly to a single kernel-scheduling entity. "
"This is the case on Linux for the obsolete LinuxThreads implementation and "
"the modern NPTL implementation, which are both 1:1 threading "
"implementations."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:118
+#: build/C/man3/pthread_attr_setscope.3:120
msgid ""
"POSIX.1-2001 specifies that the default contention scope is "
"implementation-defined."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setscope.3:126
+#: build/C/man3/pthread_attr_setscope.3:130
msgid ""
"B<pthread_attr_init>(3), B<pthread_attr_setaffinity_np>(3), "
"B<pthread_attr_setinheritsched>(3), B<pthread_attr_setschedparam>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setstack.3:24
+#: build/C/man3/pthread_attr_setstack.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETSTACK"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:28
+#: build/C/man3/pthread_attr_setstack.3:30
msgid ""
"pthread_attr_setstack, pthread_attr_getstack - set/get stack attributes in "
"thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:36
+#: build/C/man3/pthread_attr_setstack.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setstack(pthread_attr_t *>I<attr>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:43 build/C/man3/pthread_sigqueue.3:39
+#: build/C/man3/pthread_attr_setstack.3:45 build/C/man3/pthread_sigqueue.3:41
msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:48
+#: build/C/man3/pthread_attr_setstack.3:50
msgid "B<pthread_attr_getstack>(), B<pthread_attr_setstack>():"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:50
+#: build/C/man3/pthread_attr_setstack.3:52
msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:66
+#: build/C/man3/pthread_attr_setstack.3:68
msgid ""
"The B<pthread_attr_setstack>() function sets the stack address and stack "
"size attributes of the thread attributes object referred to by I<attr> to "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:72
+#: build/C/man3/pthread_attr_setstack.3:74
msgid ""
"I<stackaddr> should point to the lowest addressable byte of a buffer of "
"I<stacksize> bytes that was allocated by the caller. The pages of the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:83
+#: build/C/man3/pthread_attr_setstack.3:85
msgid ""
"The B<pthread_attr_getstack>() function returns the stack address and stack "
"size attributes of the thread attributes object referred to by I<attr> in "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:89
+#: build/C/man3/pthread_attr_setstack.3:91
msgid "B<pthread_attr_setstack>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:100
+#: build/C/man3/pthread_attr_setstack.3:102
msgid ""
"I<stacksize> is less than B<PTHREAD_STACK_MIN> (16384) bytes. On some "
"systems, this error may also occur if I<stackaddr> or I<stackaddr\\ +\\ "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:108
+#: build/C/man3/pthread_attr_setstack.3:110
msgid ""
"POSIX.1-2001 also documents an B<EACCES> error if the stack area described "
"by I<stackaddr> and I<stacksize> is not both readable and writable by the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:110
+#: build/C/man3/pthread_attr_setstack.3:112
msgid "These functions are provided by glibc since version 2.2."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:120
+#: build/C/man3/pthread_attr_setstack.3:122
msgid ""
"These functions are provided for applications that must ensure that a "
"thread's stack is placed in a particular location. For most applications, "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:131
+#: build/C/man3/pthread_attr_setstack.3:133
msgid ""
"When an application employs B<pthread_attr_setstack>(), it takes over the "
"responsibility of allocating the stack. Any guard size value that was set "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:142
+#: build/C/man3/pthread_attr_setstack.3:144
msgid ""
"The address specified in I<stackaddr> should be suitably aligned: for full "
"portability, align it on a page boundary (I<sysconf(_SC_PAGESIZE)>). "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:151
+#: build/C/man3/pthread_attr_setstack.3:153
msgid ""
"If I<attr> is used to create multiple threads, then the caller must change "
"the stack address attribute between calls to B<pthread_create>(3); "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstack.3:164
+#: build/C/man3/pthread_attr_setstack.3:168
msgid ""
"B<mmap>(2), B<mprotect>(2), B<posix_memalign>(3), B<pthread_attr_init>(3), "
"B<pthread_attr_setguardsize>(3), B<pthread_attr_setstackaddr>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setstackaddr.3:24
+#: build/C/man3/pthread_attr_setstackaddr.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETSTACKADDR"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:28
+#: build/C/man3/pthread_attr_setstackaddr.3:30
msgid ""
"pthread_attr_setstackaddr, pthread_attr_getstackaddr - set/get stack address "
"attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:36
+#: build/C/man3/pthread_attr_setstackaddr.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setstackaddr(pthread_attr_t *>I<attr>B<, void "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:47
+#: build/C/man3/pthread_attr_setstackaddr.3:49
msgid ""
"These functions are obsolete: B<do not use them.> Use "
"B<pthread_attr_setstack>(3) and B<pthread_attr_getstack>(3) instead."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:58
+#: build/C/man3/pthread_attr_setstackaddr.3:60
msgid ""
"The B<pthread_attr_setstackaddr>() function sets the stack address "
"attribute of the thread attributes object referred to by I<attr> to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:64
+#: build/C/man3/pthread_attr_setstackaddr.3:66
msgid ""
"I<stackaddr> should point to a buffer of at least B<PTHREAD_STACK_MIN> bytes "
"that was allocated by the caller. The pages of the allocated buffer should "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:72
+#: build/C/man3/pthread_attr_setstackaddr.3:74
msgid ""
"The B<pthread_attr_getstackaddr>() function returns the stack address "
"attribute of the thread attributes object referred to by I<attr> in the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:79
+#: build/C/man3/pthread_attr_setstackaddr.3:81
msgid ""
"No errors are defined (but applications should nevertheless handle a "
"possible error return)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:84
+#: build/C/man3/pthread_attr_setstackaddr.3:86
msgid ""
"POSIX.1-2001 specifies these functions but marks them as obsolete. "
"POSIX.1-2008 removes the specification of these functions."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:108
+#: build/C/man3/pthread_attr_setstackaddr.3:110
msgid ""
"I<Do not use these functions!> They cannot be portably used, since they "
"provide no way of specifying the direction of growth or the range of the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstackaddr.3:114
+#: build/C/man3/pthread_attr_setstackaddr.3:116
msgid ""
"B<pthread_attr_init>(3), B<pthread_attr_setstack>(3), "
"B<pthread_attr_setstacksize>(3), B<pthread_create>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_attr_setstacksize.3:24
+#: build/C/man3/pthread_attr_setstacksize.3:26
#, no-wrap
msgid "PTHREAD_ATTR_SETSTACKSIZE"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:28
+#: build/C/man3/pthread_attr_setstacksize.3:30
msgid ""
"pthread_attr_setstacksize, pthread_attr_getstacksize - set/get stack size "
"attribute in thread attributes object"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:36
+#: build/C/man3/pthread_attr_setstacksize.3:38
#, no-wrap
msgid ""
"B<int pthread_attr_setstacksize(pthread_attr_t *>I<attr>B<, size_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:47
+#: build/C/man3/pthread_attr_setstacksize.3:49
msgid ""
"The B<pthread_attr_setstacksize>() function sets the stack size attribute "
"of the thread attributes object referred to by I<attr> to the value "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:51
+#: build/C/man3/pthread_attr_setstacksize.3:53
msgid ""
"The stack size attribute determines the minimum size (in bytes) that will be "
"allocated for threads created using the thread attributes object I<attr>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:59
+#: build/C/man3/pthread_attr_setstacksize.3:61
msgid ""
"The B<pthread_attr_getstacksize>() function returns the stack size "
"attribute of the thread attributes object referred to by I<attr> in the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:65
+#: build/C/man3/pthread_attr_setstacksize.3:67
msgid "B<pthread_attr_setstacksize>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:70
+#: build/C/man3/pthread_attr_setstacksize.3:72
msgid "The stack size is less than B<PTHREAD_STACK_MIN> (16384) bytes."
msgstr ""
#. e.g., MacOS
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:79
+#: build/C/man3/pthread_attr_setstacksize.3:81
msgid ""
"On some systems, B<pthread_attr_setstacksize>() can fail with the error "
"B<EINVAL> if I<stacksize> is not a multiple of the system page size."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:86
+#: build/C/man3/pthread_attr_setstacksize.3:88
msgid ""
"For details on the default stack size of new threads, see "
"B<pthread_create>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:89
+#: build/C/man3/pthread_attr_setstacksize.3:91
msgid ""
"A thread's stack size is fixed at the time of thread creation. Only the "
"main thread can dynamically grow its stack."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:94
+#: build/C/man3/pthread_attr_setstacksize.3:96
msgid ""
"The B<pthread_attr_setstack>(3) function allows an application to set both "
"the size and location of a caller-allocated stack that is to be used by a "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:106
+#: build/C/man3/pthread_attr_setstacksize.3:108
msgid ""
"As at glibc 2.8, if the specified I<stacksize> is not a multiple of "
"B<STACK_ALIGN> (16 bytes on most architectures), it may be rounded "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:109 build/C/man3/pthread_join.3:125
+#: build/C/man3/pthread_attr_setstacksize.3:111 build/C/man3/pthread_join.3:127
msgid "See B<pthread_create>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_attr_setstacksize.3:116
+#: build/C/man3/pthread_attr_setstacksize.3:118
msgid ""
"B<getrlimit>(2), B<pthread_attr_init>(3), B<pthread_attr_setguardsize>(3), "
"B<pthread_attr_setstack>(3), B<pthread_create>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_cancel.3:24
+#: build/C/man3/pthread_cancel.3:26
#, no-wrap
msgid "PTHREAD_CANCEL"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_cancel.3:24 build/C/man3/pthread_setschedparam.3:24
+#: build/C/man3/pthread_cancel.3:26 build/C/man3/pthread_setschedparam.3:26
#, no-wrap
msgid "2008-11-17"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:27
+#: build/C/man3/pthread_cancel.3:29
msgid "pthread_cancel - send a cancellation request to a thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:32
+#: build/C/man3/pthread_cancel.3:34
#, no-wrap
msgid "B<int pthread_cancel(pthread_t >I<thread>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:44
+#: build/C/man3/pthread_cancel.3:46
msgid ""
"The B<pthread_cancel>() function sends a cancellation request to the thread "
"I<thread>. Whether and when the target thread reacts to the cancellation "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:56
+#: build/C/man3/pthread_cancel.3:58
msgid ""
"A thread's cancelability state, determined by B<pthread_setcancelstate>(3), "
"can be I<enabled> (the default for new threads) or I<disabled>. If a thread "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:72
+#: build/C/man3/pthread_cancel.3:74
msgid ""
"A thread's cancellation type, determined by B<pthread_setcanceltype>(3), may "
"be either I<asynchronous> or I<deferred> (the default for new threads). "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:76
+#: build/C/man3/pthread_cancel.3:78
msgid ""
"When a cancellation requested is acted on, the following steps occur for "
"I<thread> (in this order):"
msgstr ""
#. type: IP
-#: build/C/man3/pthread_cancel.3:76 build/C/man3/pthread_cleanup_push.3:67
+#: build/C/man3/pthread_cancel.3:78 build/C/man3/pthread_cleanup_push.3:69
#, no-wrap
msgid "1."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:81
+#: build/C/man3/pthread_cancel.3:83
msgid ""
"Cancellation clean-up handlers are popped (in the reverse of the order in "
"which they were pushed) and called. (See B<pthread_cleanup_push>(3).)"
msgstr ""
#. type: IP
-#: build/C/man3/pthread_cancel.3:81 build/C/man3/pthread_cleanup_push.3:71
+#: build/C/man3/pthread_cancel.3:83 build/C/man3/pthread_cleanup_push.3:73
#, no-wrap
msgid "2."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:86
+#: build/C/man3/pthread_cancel.3:88
msgid ""
"Thread-specific data destructors are called, in an unspecified order. (See "
"B<pthread_key_create>(3).)"
msgstr ""
#. type: IP
-#: build/C/man3/pthread_cancel.3:86 build/C/man3/pthread_cleanup_push.3:79
+#: build/C/man3/pthread_cancel.3:88 build/C/man3/pthread_cleanup_push.3:81
#, no-wrap
msgid "3."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:90
+#: build/C/man3/pthread_cancel.3:92
msgid "The thread is terminated. (See B<pthread_exit>(3).)"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:98
+#: build/C/man3/pthread_cancel.3:100
msgid ""
"The above steps happen asynchronously with respect to the "
"B<pthread_cancel>() call; the return status of B<pthread_cancel>() merely "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:107
+#: build/C/man3/pthread_cancel.3:109
msgid ""
"After a canceled thread has terminated, a join with that thread using "
"B<pthread_join>(3) obtains B<PTHREAD_CANCELED> as the thread's exit "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:112
+#: build/C/man3/pthread_cancel.3:114
msgid ""
"On success, B<pthread_cancel>() returns 0; on error, it returns a nonzero "
"error number."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_cancel.3:113 build/C/man3/pthread_detach.3:57 build/C/man3/pthread_getcpuclockid.3:56 build/C/man3/pthread_join.3:91 build/C/man3/pthread_kill.3:59 build/C/man3/pthread_setaffinity_np.3:112 build/C/man3/pthread_setschedparam.3:112 build/C/man3/pthread_setschedprio.3:68 build/C/man3/pthread_sigqueue.3:83
+#: build/C/man3/pthread_cancel.3:115 build/C/man3/pthread_detach.3:59 build/C/man3/pthread_getcpuclockid.3:58 build/C/man3/pthread_join.3:93 build/C/man3/pthread_kill.3:61 build/C/man3/pthread_setaffinity_np.3:114 build/C/man3/pthread_setschedparam.3:114 build/C/man3/pthread_setschedprio.3:70 build/C/man3/pthread_sigqueue.3:85
#, no-wrap
msgid "B<ESRCH>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:120 build/C/man3/pthread_detach.3:62 build/C/man3/pthread_getcpuclockid.3:61 build/C/man3/pthread_join.3:96 build/C/man3/pthread_kill.3:64 build/C/man3/pthread_setaffinity_np.3:117 build/C/man3/pthread_setschedparam.3:117 build/C/man3/pthread_setschedprio.3:73
+#: build/C/man3/pthread_cancel.3:122 build/C/man3/pthread_detach.3:64 build/C/man3/pthread_getcpuclockid.3:63 build/C/man3/pthread_join.3:98 build/C/man3/pthread_kill.3:66 build/C/man3/pthread_setaffinity_np.3:119 build/C/man3/pthread_setschedparam.3:119 build/C/man3/pthread_setschedprio.3:75
msgid "No thread with the ID I<thread> could be found."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:130
+#: build/C/man3/pthread_cancel.3:132
msgid ""
"On Linux, cancellation is implemented using signals. Under the NPTL "
"threading implementation, the first real-time signal (i.e., signal 32) is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:136
+#: build/C/man3/pthread_cancel.3:138
msgid ""
"The program below creates a thread and then cancels it. The main thread "
"joins with the canceled thread to check that its exit status was "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:144
+#: build/C/man3/pthread_cancel.3:146
#, no-wrap
msgid ""
"$ ./a.out\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:154
+#: build/C/man3/pthread_cancel.3:156
#, no-wrap
msgid ""
"#include E<lt>pthread.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:162
+#: build/C/man3/pthread_cancel.3:164
#, no-wrap
msgid ""
"static void *\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:165
+#: build/C/man3/pthread_cancel.3:167
#, no-wrap
msgid ""
" /* Disable cancellation for a while, so that we don\\(aqt\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:169
+#: build/C/man3/pthread_cancel.3:171
#, no-wrap
msgid ""
" s = pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:173
+#: build/C/man3/pthread_cancel.3:175
#, no-wrap
msgid ""
" printf(\"thread_func(): started; cancellation disabled\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:177
+#: build/C/man3/pthread_cancel.3:179
#, no-wrap
msgid ""
" s = pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:179
+#: build/C/man3/pthread_cancel.3:181
#, no-wrap
msgid " /* sleep() is a cancellation point */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:181
+#: build/C/man3/pthread_cancel.3:183
#, no-wrap
msgid " sleep(1000); /* Should get canceled while we sleep */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:183
+#: build/C/man3/pthread_cancel.3:185
#, no-wrap
msgid " /* Should never get here */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:187
+#: build/C/man3/pthread_cancel.3:189
#, no-wrap
msgid ""
" printf(\"thread_func(): not canceled!\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:194
+#: build/C/man3/pthread_cancel.3:196
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:196
+#: build/C/man3/pthread_cancel.3:198
#, no-wrap
msgid " /* Start a thread and then send it a cancellation request */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:200
+#: build/C/man3/pthread_cancel.3:202
#, no-wrap
msgid ""
" s = pthread_create(&thr, NULL, &thread_func, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:202
+#: build/C/man3/pthread_cancel.3:204
#, no-wrap
msgid " sleep(2); /* Give thread a chance to get started */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:207
+#: build/C/man3/pthread_cancel.3:209
#, no-wrap
msgid ""
" printf(\"main(): sending cancellation request\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:209
+#: build/C/man3/pthread_cancel.3:211
#, no-wrap
msgid " /* Join with thread to see what its exit status was */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:213 build/C/man3/pthread_cleanup_push.3:301
+#: build/C/man3/pthread_cancel.3:215 build/C/man3/pthread_cleanup_push.3:303
#, no-wrap
msgid ""
" s = pthread_join(thr, &res);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:220
+#: build/C/man3/pthread_cancel.3:222
#, no-wrap
msgid ""
" if (res == PTHREAD_CANCELED)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cancel.3:231
+#: build/C/man3/pthread_cancel.3:235
msgid ""
"B<pthread_cleanup_push>(3), B<pthread_create>(3), B<pthread_exit>(3), "
"B<pthread_join>(3), B<pthread_key_create>(3), B<pthread_setcancelstate>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_cleanup_push.3:24
+#: build/C/man3/pthread_cleanup_push.3:26
#, no-wrap
msgid "PTHREAD_CLEANUP_PUSH"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_cleanup_push.3:24 build/C/man3/pthread_setcancelstate.3:24
+#: build/C/man3/pthread_cleanup_push.3:26 build/C/man3/pthread_setcancelstate.3:26
#, no-wrap
msgid "2008-11-24"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:28
+#: build/C/man3/pthread_cleanup_push.3:30
msgid ""
"pthread_cleanup_push, pthread_cleanup_pop - push and pop thread cancellation "
"clean-up handlers"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:35
+#: build/C/man3/pthread_cleanup_push.3:37
#, no-wrap
msgid ""
"B<void pthread_cleanup_push(void (*>I<routine>B<)(void *),>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:46
+#: build/C/man3/pthread_cleanup_push.3:48
msgid ""
"These functions manipulate the calling thread's stack of thread-cancellation "
"clean-up handlers. A clean-up handler is a function that is automatically "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:57
+#: build/C/man3/pthread_cleanup_push.3:59
msgid ""
"The B<pthread_cleanup_push>() function pushes I<routine> onto the top of "
"the stack of clean-up handlers. When I<routine> is later invoked, it will "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:64
+#: build/C/man3/pthread_cleanup_push.3:66
msgid ""
"The B<pthread_cleanup_pop>() function removes the routine at the top of the "
"stack of clean-up handlers, and optionally executes it if I<execute> is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:67
+#: build/C/man3/pthread_cleanup_push.3:69
msgid ""
"A cancellation clean-up handler is popped from the stack and executed in the "
"following circumstances:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:71
+#: build/C/man3/pthread_cleanup_push.3:73
msgid ""
"When a thread is canceled, all of the stacked clean-up handlers are popped "
"and executed in the reverse of the order in which they were pushed onto the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:79
+#: build/C/man3/pthread_cleanup_push.3:81
msgid ""
"When a thread terminates by calling B<pthread_exit>(3), all clean-up "
"handlers are executed as described in the preceding point. (Clean-up "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:85
+#: build/C/man3/pthread_cleanup_push.3:87
msgid ""
"When a thread calls B<pthread_cleanup_pop>() with a nonzero I<execute> "
"argument, the top-most clean-up handler is popped and executed."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:97
+#: build/C/man3/pthread_cleanup_push.3:99
msgid ""
"POSIX.1 permits B<pthread_cleanup_push>() and B<pthread_cleanup_pop>() to "
"be implemented as macros that expand to text containing \\(aqB<{>\\(aq and "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:117
+#: build/C/man3/pthread_cleanup_push.3:119
msgid ""
"Calling B<longjmp>(3) (B<siglongjmp>(3)) produces undefined results if any "
"call has been made to B<pthread_cleanup_push>() or B<pthread_cleanup_pop>() "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:119
+#: build/C/man3/pthread_cleanup_push.3:121
msgid "These functions do not return a value."
msgstr ""
#. SH VERSIONS
#. Available since glibc 2.0
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:123
+#: build/C/man3/pthread_cleanup_push.3:125
msgid "There are no errors."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:134
+#: build/C/man3/pthread_cleanup_push.3:136
msgid ""
"On Linux, the B<pthread_cleanup_push>() and B<pthread_cleanup_pop>() "
"functions I<are> implemented as macros that expand to text containing "
#. The text was actually added in the 2004 TC2
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:149
+#: build/C/man3/pthread_cleanup_push.3:151
msgid ""
"POSIX.1 says that the effect of using I<return>, I<break>, I<continue>, or "
"I<goto> to prematurely leave a block bracketed B<pthread_cleanup_push>() "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:164
+#: build/C/man3/pthread_cleanup_push.3:166
msgid ""
"The program below provides a simple example of the use of the functions "
"described in this page. The program creates a thread that executes a loop "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:167
+#: build/C/man3/pthread_cleanup_push.3:169
msgid ""
"In the following shell session, the main thread sends a cancellation request "
"to the other thread:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:177
+#: build/C/man3/pthread_cleanup_push.3:179
#, no-wrap
msgid ""
"$ B<./a.out>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:185
+#: build/C/man3/pthread_cleanup_push.3:187
msgid ""
"From the above, we see that the thread was canceled, and that the "
"cancellation clean-up handler was called and it reset the value of the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:188
+#: build/C/man3/pthread_cleanup_push.3:190
msgid ""
"In the next run, the main program sets a global variable that causes other "
"thread to terminate normally:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:196
+#: build/C/man3/pthread_cleanup_push.3:198
#, no-wrap
msgid ""
"$ B<./a.out x>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:204
+#: build/C/man3/pthread_cleanup_push.3:206
msgid ""
"From the above, we see that the clean-up handler was not executed (because "
"I<cleanup_pop_arg> was 0), and therefore the value of I<cnt> was not reset."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:209
+#: build/C/man3/pthread_cleanup_push.3:211
msgid ""
"In the next run, the main program sets a global variable that causes the "
"other thread to terminate normally, and supplies a nonzero value for "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:218
+#: build/C/man3/pthread_cleanup_push.3:220
#, no-wrap
msgid ""
"$ B<./a.out x 1>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:225
+#: build/C/man3/pthread_cleanup_push.3:227
msgid ""
"In the above, we see that although the thread was not canceled, the clean-up "
"handler was executed, because the argument given to B<pthread_cleanup_pop>() "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:234
+#: build/C/man3/pthread_cleanup_push.3:236
#, no-wrap
msgid ""
"#include E<lt>pthread.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:241
+#: build/C/man3/pthread_cleanup_push.3:243
#, no-wrap
msgid ""
"static int done = 0;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:248
+#: build/C/man3/pthread_cleanup_push.3:250
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:253
+#: build/C/man3/pthread_cleanup_push.3:255
#, no-wrap
msgid ""
"static void *\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:255
+#: build/C/man3/pthread_cleanup_push.3:257
#, no-wrap
msgid " printf(\"New thread started\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:257
+#: build/C/man3/pthread_cleanup_push.3:259
#, no-wrap
msgid " pthread_cleanup_push(cleanup_handler, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:259
+#: build/C/man3/pthread_cleanup_push.3:261
#, no-wrap
msgid " curr = start = time(NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:268
+#: build/C/man3/pthread_cleanup_push.3:270
#, no-wrap
msgid ""
" while (!done) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:272
+#: build/C/man3/pthread_cleanup_push.3:274
#, no-wrap
msgid ""
" pthread_cleanup_pop(cleanup_pop_arg);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:279
+#: build/C/man3/pthread_cleanup_push.3:281
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:283
+#: build/C/man3/pthread_cleanup_push.3:285
#, no-wrap
msgid ""
" s = pthread_create(&thr, NULL, thread_start, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:285
+#: build/C/man3/pthread_cleanup_push.3:287
#, no-wrap
msgid " sleep(2); /* Allow new thread to run a while */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:290
+#: build/C/man3/pthread_cleanup_push.3:292
#, no-wrap
msgid ""
" if (argc E<gt> 1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:297
+#: build/C/man3/pthread_cleanup_push.3:299
#, no-wrap
msgid ""
" } else {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:308
+#: build/C/man3/pthread_cleanup_push.3:310
#, no-wrap
msgid ""
" if (res == PTHREAD_CANCELED)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push.3:315
+#: build/C/man3/pthread_cleanup_push.3:317
msgid ""
"B<pthread_cancel>(3), B<pthread_cleanup_push_defer_np>(3), "
"B<pthread_setcancelstate>(3), B<pthread_testcancel>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_cleanup_push_defer_np.3:24
+#: build/C/man3/pthread_cleanup_push_defer_np.3:26
#, no-wrap
msgid "PTHREAD_CLEANUP_PUSH_DEFER_NP"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_cleanup_push_defer_np.3:24
+#: build/C/man3/pthread_cleanup_push_defer_np.3:26
#, no-wrap
msgid "2008-12-04"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:28
+#: build/C/man3/pthread_cleanup_push_defer_np.3:30
msgid ""
"pthread_cleanup_push_defer_np, pthread_cleanup_pop_restore_np - push and pop "
"thread cancellation clean-up handlers while saving cancelability type"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:35
+#: build/C/man3/pthread_cleanup_push_defer_np.3:37
#, no-wrap
msgid ""
"B<void pthread_cleanup_push_defer_np(void (*>I<routine>B<)(void *),>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:38 build/C/man3/pthread_create.3:36 build/C/man3/pthread_detach.3:35 build/C/man3/pthread_join.3:35 build/C/man3/pthread_kill.3:35 build/C/man3/pthread_sigmask.3:36 build/C/man3/pthread_sigqueue.3:35 build/C/man3/pthread_tryjoin_np.3:40 build/C/man3/pthread_yield.3:34
+#: build/C/man3/pthread_cleanup_push_defer_np.3:40 build/C/man3/pthread_create.3:38 build/C/man3/pthread_detach.3:37 build/C/man3/pthread_join.3:37 build/C/man3/pthread_kill.3:37 build/C/man3/pthread_setname_np.3:39 build/C/man3/pthread_sigmask.3:38 build/C/man3/pthread_sigqueue.3:37 build/C/man3/pthread_tryjoin_np.3:42 build/C/man3/pthread_yield.3:37
msgid "Compile and link with I<-pthread>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:44
+#: build/C/man3/pthread_cleanup_push_defer_np.3:46
msgid ""
"These functions are the same as B<pthread_cleanup_push>(3) and "
"B<pthread_cleanup_pop>(3), except for the differences noted on this page."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:57
+#: build/C/man3/pthread_cleanup_push_defer_np.3:59
msgid ""
"Like B<pthread_cleanup_push>(3), B<pthread_cleanup_push_defer_np>() pushes "
"I<routine> onto the thread's stack of cancellation clean-up handlers. In "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:66
+#: build/C/man3/pthread_cleanup_push_defer_np.3:68
msgid ""
"Like B<pthread_cleanup_pop>(3), B<pthread_cleanup_pop_restore_np>() pops "
"the top-most clean-up handler from the thread's stack of cancellation "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:72
+#: build/C/man3/pthread_cleanup_push_defer_np.3:74
msgid ""
"The caller must ensure that calls to these functions are paired within the "
"same function, and at the same lexical nesting level. Other restrictions "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:74
+#: build/C/man3/pthread_cleanup_push_defer_np.3:76
msgid "This sequence of calls:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:79
+#: build/C/man3/pthread_cleanup_push_defer_np.3:81
#, no-wrap
msgid ""
"pthread_cleanup_push_defer_np(routine, arg);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:83
+#: build/C/man3/pthread_cleanup_push_defer_np.3:85
msgid "is equivalent to (but shorter and more efficient than):"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:89
+#: build/C/man3/pthread_cleanup_push_defer_np.3:91
#, no-wrap
msgid "int oldtype;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:95
+#: build/C/man3/pthread_cleanup_push_defer_np.3:97
#, no-wrap
msgid ""
"pthread_cleanup_push(routine, arg);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_cleanup_push_defer_np.3:108
+#: build/C/man3/pthread_cleanup_push_defer_np.3:110
msgid ""
"B<pthread_cancel>(3), B<pthread_cleanup_push>(3), "
"B<pthread_setcancelstate>(3), B<pthread_testcancel>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_create.3:24
+#: build/C/man3/pthread_create.3:26
#, no-wrap
msgid "PTHREAD_CREATE"
msgstr ""
+#. type: TH
+#: build/C/man3/pthread_create.3:26 build/C/man3/pthread_sigmask.3:26
+#, no-wrap
+msgid "2012-08-03"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/pthread_create.3:27
+#: build/C/man3/pthread_create.3:29
msgid "pthread_create - create a new thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:33
+#: build/C/man3/pthread_create.3:35
#, no-wrap
msgid ""
"B<int pthread_create(pthread_t *>I<thread>B<, const pthread_attr_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:45
+#: build/C/man3/pthread_create.3:47
msgid ""
"The B<pthread_create>() function starts a new thread in the calling "
"process. The new thread starts execution by invoking I<start_routine>(); "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:47
+#: build/C/man3/pthread_create.3:49
msgid "The new thread terminates in one of the following ways:"
msgstr ""
#. type: IP
-#: build/C/man3/pthread_create.3:47 build/C/man3/pthread_create.3:53 build/C/man3/pthread_create.3:61 build/C/man3/pthread_create.3:64 build/C/man3/pthread_getattr_np.3:50 build/C/man3/pthread_getattr_np.3:53 build/C/man3/pthread_getattr_np.3:56
+#: build/C/man3/pthread_create.3:49 build/C/man3/pthread_create.3:55 build/C/man3/pthread_create.3:63 build/C/man3/pthread_create.3:66 build/C/man3/pthread_getattr_np.3:52 build/C/man3/pthread_getattr_np.3:55 build/C/man3/pthread_getattr_np.3:58
#, no-wrap
msgid "*"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:53
+#: build/C/man3/pthread_create.3:55
msgid ""
"It calls B<pthread_exit>(3), specifying an exit status value that is "
"available to another thread in the same process that calls "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:61
+#: build/C/man3/pthread_create.3:63
msgid ""
"It returns from I<start_routine>(). This is equivalent to calling "
"B<pthread_exit>(3) with the value supplied in the I<return> statement."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:64
+#: build/C/man3/pthread_create.3:66
msgid "It is canceled (see B<pthread_cancel>(3))."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:70
+#: build/C/man3/pthread_create.3:72
msgid ""
"Any of the threads in the process calls B<exit>(3), or the main thread "
"performs a return from I<main>(). This causes the termination of all "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:84
+#: build/C/man3/pthread_create.3:86
msgid ""
"The I<attr> argument points to a I<pthread_attr_t> structure whose contents "
"are used at thread creation time to determine attributes for the new thread; "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:91
+#: build/C/man3/pthread_create.3:93
msgid ""
"Before returning, a successful call to B<pthread_create>() stores the ID of "
"the new thread in the buffer pointed to by I<thread>; this identifier is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:99
+#: build/C/man3/pthread_create.3:101
msgid ""
"The new thread inherits a copy of the creating thread's signal mask "
"(B<pthread_sigmask>(3)). The set of pending signals for the new thread is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:102
+#: build/C/man3/pthread_create.3:104
msgid ""
"The new thread inherits the calling thread's floating-point environment "
"(B<fenv>(3))."
#. CLOCK_THREAD_CPUTIME_ID in clock_gettime(2)
#. type: Plain text
-#: build/C/man3/pthread_create.3:107
+#: build/C/man3/pthread_create.3:109
msgid ""
"The initial value of the new thread's CPU-time clock is 0 (see "
"B<pthread_getcpuclockid>(3))."
msgstr ""
#. type: SS
-#: build/C/man3/pthread_create.3:107
+#: build/C/man3/pthread_create.3:109
#, no-wrap
msgid "Linux-specific details"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:113
+#: build/C/man3/pthread_create.3:115
msgid ""
"The new thread inherits copies of the calling thread's capability sets (see "
"B<capabilities>(7)) and CPU affinity mask (see B<sched_setaffinity>(2))."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:120
+#: build/C/man3/pthread_create.3:122
msgid ""
"On success, B<pthread_create>() returns 0; on error, it returns an error "
"number, and the contents of I<*thread> are undefined."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_create.3:121 build/C/man3/pthread_sigqueue.3:69
+#: build/C/man3/pthread_create.3:123 build/C/man3/pthread_sigqueue.3:71
#, no-wrap
msgid "B<EAGAIN>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:135
+#: build/C/man3/pthread_create.3:137
msgid ""
"Insufficient resources to create another thread, or a system-imposed limit "
"on the number of threads was encountered. The latter case may occur in two "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:139
+#: build/C/man3/pthread_create.3:141
msgid "Invalid settings in I<attr>."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_create.3:139 build/C/man3/pthread_setschedparam.3:127 build/C/man3/pthread_setschedprio.3:64
+#: build/C/man3/pthread_create.3:141 build/C/man3/pthread_setschedparam.3:129 build/C/man3/pthread_setschedprio.3:66
#, no-wrap
msgid "B<EPERM>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:144
+#: build/C/man3/pthread_create.3:146
msgid ""
"No permission to set the scheduling policy and parameters specified in "
"I<attr>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:158
+#: build/C/man3/pthread_create.3:160
msgid ""
"See B<pthread_self>(3) for further information on the thread ID returned in "
"I<*thread> by B<pthread_create>(). Unless real-time scheduling policies are "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:178
+#: build/C/man3/pthread_create.3:180
msgid ""
"A thread may either be I<joinable> or I<detached>. If a thread is joinable, "
"then another thread can call B<pthread_join>(3) to wait for the thread to "
#. FIXME . Perhaps some of the following detail should be in
#. a future pthread_attr_setstacksize(3) page.
#. type: Plain text
-#: build/C/man3/pthread_create.3:194
+#: build/C/man3/pthread_create.3:196
msgid ""
"On Linux/x86-32, the default stack size for a new thread is 2 megabytes. "
"Under the NPTL threading implementation, if the B<RLIMIT_STACK> soft "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:200
+#: build/C/man3/pthread_create.3:202
msgid ""
"In the obsolete LinuxThreads implementation, each of the threads in a "
"process has a different process ID. This is in violation of the POSIX "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:204
+#: build/C/man3/pthread_create.3:206
msgid ""
"The program below demonstrates the use of B<pthread_create>(), as well as a "
"number of other functions in the pthreads API."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:209
+#: build/C/man3/pthread_create.3:211
msgid ""
"In the following run, on a system providing the NPTL threading "
"implementation, the stack size defaults to the value given by the \"stack "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:221
+#: build/C/man3/pthread_create.3:223
#, no-wrap
msgid ""
"$B< ulimit -s>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:227
+#: build/C/man3/pthread_create.3:229
msgid ""
"In the next run, the program explicitly sets a stack size of 1MB (using "
"B<pthread_attr_setstacksize>(3)) for the created threads:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:237
+#: build/C/man3/pthread_create.3:239
#, no-wrap
msgid ""
"$B< ./a.out -s 0x100000 hola salut servus>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:249
+#: build/C/man3/pthread_create.3:251
#, no-wrap
msgid ""
"#include E<lt>pthread.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:255 build/C/man3/pthread_getcpuclockid.3:108
+#: build/C/man3/pthread_create.3:257 build/C/man3/pthread_getcpuclockid.3:110
#, no-wrap
msgid ""
"#define handle_error(msg) \\e\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:261
+#: build/C/man3/pthread_create.3:263
#, no-wrap
msgid ""
"struct thread_info { /* Used as argument to thread_start() */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:264
+#: build/C/man3/pthread_create.3:266
#, no-wrap
msgid ""
"/* Thread start function: display address near top of our stack,\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:270
+#: build/C/man3/pthread_create.3:272
#, no-wrap
msgid ""
"static void *\n"
"thread_start(void *arg)\n"
"{\n"
-" struct thread_info *tinfo = (struct thread_info *) arg;\n"
+" struct thread_info *tinfo = arg;\n"
" char *uargv, *p;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:273
+#: build/C/man3/pthread_create.3:275
#, no-wrap
msgid ""
" printf(\"Thread %d: top of stack near %p; argv_string=%s\\en\",\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:277
+#: build/C/man3/pthread_create.3:279
#, no-wrap
msgid ""
" uargv = strdup(tinfo-E<gt>argv_string);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:280
+#: build/C/man3/pthread_create.3:282
#, no-wrap
msgid ""
" for (p = uargv; *p != \\(aq\\e0\\(aq; p++)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:283
+#: build/C/man3/pthread_create.3:285
#, no-wrap
msgid ""
" return uargv;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:292
+#: build/C/man3/pthread_create.3:294
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:294
+#: build/C/man3/pthread_create.3:296
#, no-wrap
msgid " /* The \"-s\" option specifies a stack size for our threads */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:301
+#: build/C/man3/pthread_create.3:303
#, no-wrap
msgid ""
" stack_size = -1;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:308
+#: build/C/man3/pthread_create.3:310
#, no-wrap
msgid ""
" default:\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:310
+#: build/C/man3/pthread_create.3:312
#, no-wrap
msgid " num_threads = argc - optind;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:312
+#: build/C/man3/pthread_create.3:314
#, no-wrap
msgid " /* Initialize thread creation attributes */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:316
+#: build/C/man3/pthread_create.3:318
#, no-wrap
msgid ""
" s = pthread_attr_init(&attr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:322
+#: build/C/man3/pthread_create.3:324
#, no-wrap
msgid ""
" if (stack_size E<gt> 0) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:324
+#: build/C/man3/pthread_create.3:326
#, no-wrap
msgid " /* Allocate memory for pthread_create() arguments */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:328
+#: build/C/man3/pthread_create.3:330
#, no-wrap
msgid ""
" tinfo = calloc(num_threads, sizeof(struct thread_info));\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:330
+#: build/C/man3/pthread_create.3:332
#, no-wrap
msgid " /* Create one thread for each command-line argument */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:334
+#: build/C/man3/pthread_create.3:336
#, no-wrap
msgid ""
" for (tnum = 0; tnum E<lt> num_threads; tnum++) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:337
+#: build/C/man3/pthread_create.3:339
#, no-wrap
msgid ""
" /* The pthread_create() call stores the thread ID into\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:343
+#: build/C/man3/pthread_create.3:345
#, no-wrap
msgid ""
" s = pthread_create(&tinfo[tnum].thread_id, &attr,\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:346
+#: build/C/man3/pthread_create.3:348
#, no-wrap
msgid ""
" /* Destroy the thread attributes object, since it is no\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:350 build/C/man3/pthread_setschedparam.3:421
+#: build/C/man3/pthread_create.3:352 build/C/man3/pthread_setschedparam.3:423
#, no-wrap
msgid ""
" s = pthread_attr_destroy(&attr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:352
+#: build/C/man3/pthread_create.3:354
#, no-wrap
msgid " /* Now join with each thread, and display its returned value */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:357
+#: build/C/man3/pthread_create.3:359
#, no-wrap
msgid ""
" for (tnum = 0; tnum E<lt> num_threads; tnum++) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:362
+#: build/C/man3/pthread_create.3:364
#, no-wrap
msgid ""
" printf(\"Joined with thread %d; returned value was %s\\en\",\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:366
+#: build/C/man3/pthread_create.3:368
#, no-wrap
msgid ""
" free(tinfo);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_create.3:378
+#: build/C/man3/pthread_create.3:382
msgid ""
"B<getrlimit>(2), B<pthread_attr_init>(3), B<pthread_cancel>(3), "
"B<pthread_detach>(3), B<pthread_equal>(3), B<pthread_exit>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_detach.3:24
+#: build/C/man3/pthread_detach.3:26
#, no-wrap
msgid "PTHREAD_DETACH"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_detach.3:24 build/C/man3/pthread_join.3:24
+#: build/C/man3/pthread_detach.3:26 build/C/man3/pthread_join.3:26
#, no-wrap
msgid "2008-11-27"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:27
+#: build/C/man3/pthread_detach.3:29
msgid "pthread_detach - detach a thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:32
+#: build/C/man3/pthread_detach.3:34
#, no-wrap
msgid "B<int pthread_detach(pthread_t >I<thread>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:44
+#: build/C/man3/pthread_detach.3:46
msgid ""
"The B<pthread_detach>() function marks the thread identified by I<thread> "
"as detached. When a detached thread terminates, its resources are "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:47
+#: build/C/man3/pthread_detach.3:49
msgid ""
"Attempting to detach an already detached thread results in unspecified "
"behavior."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:52
+#: build/C/man3/pthread_detach.3:54
msgid ""
"On success, B<pthread_detach>() returns 0; on error, it returns an error "
"number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:57 build/C/man3/pthread_join.3:87
+#: build/C/man3/pthread_detach.3:59 build/C/man3/pthread_join.3:89
msgid "I<thread> is not a joinable thread."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:68
+#: build/C/man3/pthread_detach.3:70
msgid ""
"Once a thread has been detached, it can't be joined with B<pthread_join>(3) "
"or be made joinable again."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:75
+#: build/C/man3/pthread_detach.3:77
msgid ""
"A new thread can be created in a detached state using "
"B<pthread_attr_setdetachstate>(3) to set the detached attribute of the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:82
+#: build/C/man3/pthread_detach.3:84
msgid ""
"The detached attribute merely determines the behavior of the system when the "
"thread terminates; it does not prevent the thread from being terminated if "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:91
+#: build/C/man3/pthread_detach.3:93
msgid ""
"Either B<pthread_join>(3) or B<pthread_detach>() should be called for each "
"thread that an application creates, so that system resources for the thread "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:93
+#: build/C/man3/pthread_detach.3:95
msgid "The following statement detaches the calling thread:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:95
+#: build/C/man3/pthread_detach.3:97
#, no-wrap
msgid " pthread_detach(pthread_self());\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_detach.3:102
+#: build/C/man3/pthread_detach.3:104
msgid ""
"B<pthread_attr_setdetachstate>(3), B<pthread_cancel>(3), "
"B<pthread_create>(3), B<pthread_exit>(3), B<pthread_join>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_equal.3:24
+#: build/C/man3/pthread_equal.3:26
#, no-wrap
msgid "PTHREAD_EQUAL"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_equal.3:24 build/C/man3/pthread_exit.3:24
+#: build/C/man3/pthread_equal.3:26 build/C/man3/pthread_exit.3:26
#, no-wrap
msgid "2009-03-30"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_equal.3:27
+#: build/C/man3/pthread_equal.3:29
msgid "pthread_equal - compare thread IDs"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_equal.3:32
+#: build/C/man3/pthread_equal.3:34
#, no-wrap
msgid "B<int pthread_equal(pthread_t >I<t1>B<, pthread_t >I<t2>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_equal.3:39
+#: build/C/man3/pthread_equal.3:41
msgid "The B<pthread_equal>() function compares two thread identifiers."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_equal.3:43
+#: build/C/man3/pthread_equal.3:45
msgid ""
"If the two thread IDs are equal, B<pthread_equal>() returns a nonzero "
"value; otherwise, it returns 0."
#. SH VERSIONS
#. Available since glibc 2.0
#. type: Plain text
-#: build/C/man3/pthread_equal.3:45 build/C/man3/pthread_exit.3:73 build/C/man3/pthread_self.3:48 build/C/man3/pthread_testcancel.3:56
+#: build/C/man3/pthread_equal.3:47 build/C/man3/pthread_exit.3:75 build/C/man3/pthread_self.3:50 build/C/man3/pthread_testcancel.3:58
msgid "This function always succeeds."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_equal.3:54
+#: build/C/man3/pthread_equal.3:56
msgid ""
"The B<pthread_equal>() function is necessary because thread IDs should be "
"considered opaque: there is no portable way for applications to directly "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_equal.3:58
+#: build/C/man3/pthread_equal.3:60
msgid "B<pthread_create>(3), B<pthread_self>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_exit.3:24
+#: build/C/man3/pthread_exit.3:26
#, no-wrap
msgid "PTHREAD_EXIT"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:27
+#: build/C/man3/pthread_exit.3:29
msgid "pthread_exit - terminate calling thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:32
+#: build/C/man3/pthread_exit.3:34
#, no-wrap
msgid "B<void pthread_exit(void *>I<retval>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:43
+#: build/C/man3/pthread_exit.3:45
msgid ""
"The B<pthread_exit>() function terminates the calling thread and returns a "
"value via I<retval> that (if the thread is joinable) is available to "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:53
+#: build/C/man3/pthread_exit.3:55
msgid ""
"Any clean-up handlers established by B<pthread_cleanup_push>(3) that have "
"not yet been popped, are popped (in the reverse of the order in which they "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:60
+#: build/C/man3/pthread_exit.3:62
msgid ""
"When a thread terminates, process-shared resources (e.g., mutexes, condition "
"variables, semaphores, and file descriptors) are not released, and functions "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:69
+#: build/C/man3/pthread_exit.3:71
msgid ""
"After the last thread in a process terminates, the process terminates as by "
"calling B<exit>(3) with an exit status of zero; thus, process-shared "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:71
+#: build/C/man3/pthread_exit.3:73
msgid "This function does not return to the caller."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:80
+#: build/C/man3/pthread_exit.3:82
msgid ""
"Performing a return from the start function of any thread other than the "
"main thread results in an implicit call to B<pthread_exit>(), using the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:86
+#: build/C/man3/pthread_exit.3:88
msgid ""
"To allow other threads to continue execution, the main thread should "
"terminate by calling B<pthread_exit>() rather than B<exit>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:91
+#: build/C/man3/pthread_exit.3:93
msgid ""
"The value pointed to by I<retval> should not be located on the calling "
"thread's stack, since the contents of that stack are undefined after the "
#. http://thread.gmane.org/gmane.linux.kernel/611611
#. http://marc.info/?l=linux-kernel&m=122525468300823&w=2
#. type: Plain text
-#: build/C/man3/pthread_exit.3:103
+#: build/C/man3/pthread_exit.3:105
msgid ""
"Currently, there are limitations in the kernel implementation logic for "
"B<wait>(2)ing on a stopped thread group with a dead thread group leader. "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_exit.3:107
+#: build/C/man3/pthread_exit.3:109
msgid "B<pthread_create>(3), B<pthread_join>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_getattr_np.3:24
+#: build/C/man3/pthread_getattr_np.3:26
#, no-wrap
msgid "PTHREAD_GETATTR_NP"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:27
+#: build/C/man3/pthread_getattr_np.3:29
msgid "pthread_getattr_np - get attributes of created thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:33
+#: build/C/man3/pthread_getattr_np.3:35
#, no-wrap
msgid ""
"B<int pthread_getattr_np(pthread_t >I<thread>B<, pthread_attr_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:43
+#: build/C/man3/pthread_getattr_np.3:45
msgid ""
"The B<pthread_getattr_np>() function initializes the thread attributes "
"object referred to by I<attr> so that it contains actual attribute values "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:50
+#: build/C/man3/pthread_getattr_np.3:52
msgid ""
"The returned attribute values may differ from the corresponding attribute "
"values passed in the I<attr> object that was used to create the thread using "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:53
+#: build/C/man3/pthread_getattr_np.3:55
msgid ""
"the detach state, since a joinable thread may have detached itself after "
"creation;"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:56
+#: build/C/man3/pthread_getattr_np.3:58
msgid "the stack size, which the implementation may align to a suitable boundary."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:61
+#: build/C/man3/pthread_getattr_np.3:63
msgid ""
"and the guard size, which the implementation may round upward to a multiple "
"of the page size, or ignore (i.e., treat as 0), if the application is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:66
+#: build/C/man3/pthread_getattr_np.3:68
msgid ""
"Furthermore, if the stack address attribute was not set in the thread "
"attributes object used to create the thread, then the returned thread "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:71
+#: build/C/man3/pthread_getattr_np.3:73
msgid ""
"When the thread attributes object returned by B<pthread_getattr_np>() is no "
"longer required, it should be destroyed using B<pthread_attr_destroy>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:74 build/C/man3/pthread_getcpuclockid.3:47
+#: build/C/man3/pthread_getattr_np.3:76 build/C/man3/pthread_getcpuclockid.3:49
msgid ""
"On success, this function returns 0; on error, it returns a nonzero error "
"number."
#. Can happen (but unlikely) while trying to allocate memory for cpuset
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:79
+#: build/C/man3/pthread_getattr_np.3:81
msgid "Insufficient memory."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:94
+#: build/C/man3/pthread_getattr_np.3:96
msgid ""
"In addition, if I<thread> refers to the main thread, then "
"B<pthread_getattr_np>() can fail because of errors from various underlying "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:96
+#: build/C/man3/pthread_getattr_np.3:98
msgid "This function is available in glibc since version 2.2.3."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:99 build/C/man3/pthread_kill_other_threads_np.3:48
+#: build/C/man3/pthread_getattr_np.3:101 build/C/man3/pthread_kill_other_threads_np.3:50
msgid ""
"This function is a nonstandard GNU extension; hence the suffix \"_np\" "
"(nonportable) in the name."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:109
+#: build/C/man3/pthread_getattr_np.3:111
msgid ""
"The program below demonstrates the use of B<pthread_getattr_np>(). The "
"program creates a thread that then uses B<pthread_getattr_np>() to retrieve "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:112
+#: build/C/man3/pthread_getattr_np.3:114
msgid ""
"In the first run, on an x86-32 system, a thread is created using default "
"attributes:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:122
+#: build/C/man3/pthread_getattr_np.3:124
#, no-wrap
msgid ""
"$B< ulimit -s> # No stack limit ==E<gt> default stack size is 2MB\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:128
+#: build/C/man3/pthread_getattr_np.3:130
msgid ""
"In the following run, we see that if a guard size is specified, it is "
"rounded up to the next multiple of the system page size (4096 bytes on "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:136
+#: build/C/man3/pthread_getattr_np.3:138
#, no-wrap
msgid ""
"$B< ./a.out -g 4097>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:141
+#: build/C/man3/pthread_getattr_np.3:143
#, no-wrap
msgid ""
"Attributes of created thread:\n"
#. .fi
#. .in
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:160
+#: build/C/man3/pthread_getattr_np.3:162
msgid ""
"In the last run, the program manually allocates a stack for the thread. In "
"this case, the guard size attribute is ignored."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:165
+#: build/C/man3/pthread_getattr_np.3:167
#, no-wrap
msgid ""
"$B< ./a.out -g 4096 -s 0x8000 -a>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:170
+#: build/C/man3/pthread_getattr_np.3:172
#, no-wrap
msgid ""
"Thread attributes object after initializations:\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:175
+#: build/C/man3/pthread_getattr_np.3:177
#, no-wrap
msgid ""
"Attributes of created thread:\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:196
+#: build/C/man3/pthread_getattr_np.3:198
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:201
+#: build/C/man3/pthread_getattr_np.3:203
#, no-wrap
msgid ""
" s = pthread_attr_getguardsize(attr, &guard_size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:212
+#: build/C/man3/pthread_getattr_np.3:214
#, no-wrap
msgid ""
" s = pthread_attr_getstack(attr, &stack_addr, &stack_size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:218
+#: build/C/man3/pthread_getattr_np.3:220
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:222
+#: build/C/man3/pthread_getattr_np.3:224
#, no-wrap
msgid ""
" s = pthread_getattr_np(thread, &attr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:224
+#: build/C/man3/pthread_getattr_np.3:226
#, no-wrap
msgid " display_stack_related_attributes(&attr, prefix);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:229
+#: build/C/man3/pthread_getattr_np.3:231
#, no-wrap
msgid ""
" s = pthread_attr_destroy(&attr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:235
+#: build/C/man3/pthread_getattr_np.3:237
#, no-wrap
msgid ""
"static void * /* Start function for thread we create */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:249
+#: build/C/man3/pthread_getattr_np.3:251
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:262
+#: build/C/man3/pthread_getattr_np.3:264
#, no-wrap
msgid ""
"static pthread_attr_t * /* Get thread attributes from command line */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:271
+#: build/C/man3/pthread_getattr_np.3:273
#, no-wrap
msgid ""
" while ((opt = getopt(argc, argv, \"ag:s:\")) != -1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:274
+#: build/C/man3/pthread_getattr_np.3:276
#, no-wrap
msgid ""
" if (allocate_stack && stack_size == -1)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:277
+#: build/C/man3/pthread_getattr_np.3:279
#, no-wrap
msgid ""
" if (argc E<gt> optind)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:280
+#: build/C/man3/pthread_getattr_np.3:282
#, no-wrap
msgid ""
" if (stack_size E<gt>= 0 || guard_size E<gt> 0) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:285
+#: build/C/man3/pthread_getattr_np.3:287
#, no-wrap
msgid ""
" s = pthread_attr_init(attrp);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:297
+#: build/C/man3/pthread_getattr_np.3:299
#, no-wrap
msgid ""
" if (stack_size E<gt>= 0) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:303
+#: build/C/man3/pthread_getattr_np.3:305
#, no-wrap
msgid ""
" s = pthread_attr_setstack(attrp, stack_addr, stack_size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:309
+#: build/C/man3/pthread_getattr_np.3:311
#, no-wrap
msgid ""
" if (guard_size E<gt>= 0) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:312
+#: build/C/man3/pthread_getattr_np.3:314
#, no-wrap
msgid ""
" return ret_attrp;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:321
+#: build/C/man3/pthread_getattr_np.3:323
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:323
+#: build/C/man3/pthread_getattr_np.3:325
#, no-wrap
msgid " attrp = get_thread_attributes_from_cl(argc, argv, &attr);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:329
+#: build/C/man3/pthread_getattr_np.3:331
#, no-wrap
msgid ""
" if (attrp != NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getattr_np.3:357
+#: build/C/man3/pthread_getattr_np.3:361
msgid ""
"B<pthread_attr_getaffinity_np>(3), B<pthread_attr_getdetachstate>(3), "
"B<pthread_attr_getguardsize>(3), B<pthread_attr_getinheritsched>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_getcpuclockid.3:24
+#: build/C/man3/pthread_getcpuclockid.3:26
#, no-wrap
msgid "PTHREAD_GETCPUCLOCKID"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_getcpuclockid.3:24
+#: build/C/man3/pthread_getcpuclockid.3:26
#, no-wrap
msgid "2009-02-08"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:27
+#: build/C/man3/pthread_getcpuclockid.3:29
msgid "pthread_getcpuclockid - retrieve ID of a thread's CPU time clock"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:31
+#: build/C/man3/pthread_getcpuclockid.3:33
#, no-wrap
msgid ""
"B<#include E<lt>pthread.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:33
+#: build/C/man3/pthread_getcpuclockid.3:35
#, no-wrap
msgid ""
"B<int pthread_getcpuclockid(pthread_t >I<thread>B<, clockid_t "
#. *clockid = CLOCK_THREAD_CPUTIME_ID | (pd->tid << CLOCK_IDFIELD_SIZE)
#. where CLOCK_IDFIELD_SIZE is 3.
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:44
+#: build/C/man3/pthread_getcpuclockid.3:46
msgid ""
"The B<pthread_getcpuclockid>() function returns the clock ID for the CPU "
"time clock of the thread I<thread>."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_getcpuclockid.3:48
+#: build/C/man3/pthread_getcpuclockid.3:50
#, no-wrap
msgid "B<ENOENT>"
msgstr ""
#. be possible if kernel thread IDs took more than 29 bits (which
#. they currently cannot).
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:56
+#: build/C/man3/pthread_getcpuclockid.3:58
msgid "Per-thread CPU time clocks are not supported by the system."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:63
+#: build/C/man3/pthread_getcpuclockid.3:65
msgid "This function is available in glibc since version 2.2."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:76
+#: build/C/man3/pthread_getcpuclockid.3:78
msgid ""
"When I<thread> refers to the calling thread, this function returns an "
"identifier that refers to the same clock manipulated by B<clock_gettime>(2) "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:82
+#: build/C/man3/pthread_getcpuclockid.3:84
msgid ""
"The program below creates a thread and then uses B<clock_gettime>(2) to "
"retrieve the total process CPU time, and the per-thread CPU time consumed by "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:91
+#: build/C/man3/pthread_getcpuclockid.3:93
#, no-wrap
msgid ""
"$ B<./a.out>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:97
+#: build/C/man3/pthread_getcpuclockid.3:99
#, no-wrap
msgid "/* Link with \"-lrt\" */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:105
+#: build/C/man3/pthread_getcpuclockid.3:107
#, no-wrap
msgid ""
"#include E<lt>time.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:119
+#: build/C/man3/pthread_getcpuclockid.3:121
#, no-wrap
msgid ""
"static void *\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:124
+#: build/C/man3/pthread_getcpuclockid.3:126
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:130
+#: build/C/man3/pthread_getcpuclockid.3:132
#, no-wrap
msgid ""
" printf(\"%s\", msg);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:137
+#: build/C/man3/pthread_getcpuclockid.3:139
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:141
+#: build/C/man3/pthread_getcpuclockid.3:143
#, no-wrap
msgid ""
" s = pthread_create(&thread, NULL, thread_start, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:144
+#: build/C/man3/pthread_getcpuclockid.3:146
#, no-wrap
msgid ""
" printf(\"Main thread sleeping\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:148
+#: build/C/man3/pthread_getcpuclockid.3:150
#, no-wrap
msgid ""
" printf(\"Main thread consuming some CPU time...\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:150
+#: build/C/man3/pthread_getcpuclockid.3:152
#, no-wrap
msgid " pclock(\"Process total CPU time: \", CLOCK_PROCESS_CPUTIME_ID);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:155
+#: build/C/man3/pthread_getcpuclockid.3:157
#, no-wrap
msgid ""
" s = pthread_getcpuclockid(pthread_self(), &cid);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:158
+#: build/C/man3/pthread_getcpuclockid.3:160
#, no-wrap
msgid ""
" /* The preceding 4 lines of code could have been replaced by:\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:163
+#: build/C/man3/pthread_getcpuclockid.3:165
#, no-wrap
msgid ""
" s = pthread_getcpuclockid(thread, &cid);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:166
+#: build/C/man3/pthread_getcpuclockid.3:168
#, no-wrap
msgid ""
" exit(EXIT_SUCCESS); /* Terminates both threads */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_getcpuclockid.3:175
+#: build/C/man3/pthread_getcpuclockid.3:177
msgid ""
"B<clock_gettime>(2), B<clock_settime>(2), B<timer_create>(2), "
"B<clock_getcpuclockid>(3), B<pthread_self>(3), B<pthreads>(7), B<time>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_join.3:24
+#: build/C/man3/pthread_join.3:26
#, no-wrap
msgid "PTHREAD_JOIN"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:27
+#: build/C/man3/pthread_join.3:29
msgid "pthread_join - join with a terminated thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:32
+#: build/C/man3/pthread_join.3:34
#, no-wrap
msgid "B<int pthread_join(pthread_t >I<thread>B<, void **>I<retval>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:47
+#: build/C/man3/pthread_join.3:49
msgid ""
"The B<pthread_join>() function waits for the thread specified by I<thread> "
"to terminate. If that thread has already terminated, then B<pthread_join>() "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:61
+#: build/C/man3/pthread_join.3:63
msgid ""
"If I<retval> is not NULL, then B<pthread_join>() copies the exit status of "
"the target thread (i.e., the value that the target thread supplied to "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:68
+#: build/C/man3/pthread_join.3:70
msgid ""
"If multiple threads simultaneously try to join with the same thread, the "
"results are undefined. If the thread calling B<pthread_join>() is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:73
+#: build/C/man3/pthread_join.3:75
msgid ""
"On success, B<pthread_join>() returns 0; on error, it returns an error "
"number."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_join.3:74
+#: build/C/man3/pthread_join.3:76
#, no-wrap
msgid "B<EDEADLK>"
msgstr ""
#. The following verified by testing on glibc 2.8/NPTL:
#. The following verified by testing on glibc 2.8/NPTL:
#. type: Plain text
-#: build/C/man3/pthread_join.3:83
+#: build/C/man3/pthread_join.3:85
msgid ""
"A deadlock was detected (e.g., two threads tried to join with each other); "
"or I<thread> specifies the calling thread."
#. POSIX.1-2001 does not specify this error case.
#. type: Plain text
-#: build/C/man3/pthread_join.3:91
+#: build/C/man3/pthread_join.3:93
msgid "Another thread is already waiting to join with this thread."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:102
+#: build/C/man3/pthread_join.3:104
msgid ""
"After a successful call to B<pthread_join>(), the caller is guaranteed that "
"the target thread has terminated."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:105
+#: build/C/man3/pthread_join.3:107
msgid ""
"Joining with a thread that has previously been joined results in undefined "
"behavior."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:113
+#: build/C/man3/pthread_join.3:115
msgid ""
"Failure to join with a thread that is joinable (i.e., one that is not "
"detached), produces a \"zombie thread\". Avoid doing this, since each "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:119
+#: build/C/man3/pthread_join.3:121
msgid ""
"There is no pthreads analog of I<waitpid(-1,\\ &status,\\ 0)>, that is, "
"\"join with any terminated thread\". If you believe you need this "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:122
+#: build/C/man3/pthread_join.3:124
msgid ""
"All of the threads in a process are peers: any thread can join with any "
"other thread in the process."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_join.3:132
+#: build/C/man3/pthread_join.3:134
msgid ""
"B<pthread_cancel>(3), B<pthread_create>(3), B<pthread_detach>(3), "
"B<pthread_exit>(3), B<pthread_tryjoin_np>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_kill.3:24
+#: build/C/man3/pthread_kill.3:26
#, no-wrap
msgid "PTHREAD_KILL"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_kill.3:24
+#: build/C/man3/pthread_kill.3:26 build/C/man3/pthread_sigqueue.3:25
#, no-wrap
-msgid "2009-01-28"
+msgid "2012-08-19"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:27
+#: build/C/man3/pthread_kill.3:29
msgid "pthread_kill - send a signal to a thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:30 build/C/man3/pthread_sigmask.3:30
+#: build/C/man3/pthread_kill.3:32 build/C/man3/pthread_sigmask.3:32
#, no-wrap
msgid "B<#include E<lt>signal.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:32
+#: build/C/man3/pthread_kill.3:34
#, no-wrap
msgid "B<int pthread_kill(pthread_t >I<thread>B<, int >I<sig>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:45
+#: build/C/man3/pthread_kill.3:47
msgid ""
-"The B<pthread_kill>() function sends the signal I<sig> to I<thread>, "
-"another thread in the same process as the caller. The signal is "
-"asynchronously directed to I<thread>."
+"The B<pthread_kill>() function sends the signal I<sig> to I<thread>, a "
+"thread in the same process as the caller. The signal is asynchronously "
+"directed to I<thread>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:50
+#: build/C/man3/pthread_kill.3:52
msgid ""
"If I<sig> is 0, then no signal is sent, but error checking is still "
"performed; this can be used to check for the existence of a thread ID."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:55
+#: build/C/man3/pthread_kill.3:57
msgid ""
"On success, B<pthread_kill>() returns 0; on error, it returns an error "
"number, and no signal is sent."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:59
+#: build/C/man3/pthread_kill.3:61
msgid "An invalid signal was specified."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:73
+#: build/C/man3/pthread_kill.3:75
msgid ""
"Signal dispositions are process-wide: if a signal handler is installed, the "
"handler will be invoked in the thread I<thread>, but if the disposition of "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill.3:82
+#: build/C/man3/pthread_kill.3:84
msgid ""
-"B<kill>(2) B<sigaction>(2), B<sigpending>(2), B<pthread_self>(3), "
+"B<kill>(2), B<sigaction>(2), B<sigpending>(2), B<pthread_self>(3), "
"B<pthread_sigmask>(3), B<raise>(3), B<pthreads>(7), B<signal>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_kill_other_threads_np.3:24
+#: build/C/man3/pthread_kill_other_threads_np.3:26
#, no-wrap
msgid "PTHREAD_KILL_OTHER_THREADS_NP"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_kill_other_threads_np.3:24
+#: build/C/man3/pthread_kill_other_threads_np.3:26
#, no-wrap
msgid "2010-09-09"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill_other_threads_np.3:27
+#: build/C/man3/pthread_kill_other_threads_np.3:29
msgid "pthread_kill_other_threads_np - terminate all other threads in process"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill_other_threads_np.3:32
+#: build/C/man3/pthread_kill_other_threads_np.3:34
#, no-wrap
msgid "B<void pthread_kill_other_threads_np(void);>\n"
msgstr ""
#. .SH VERSIONS
#. Available since glibc 2.0
#. type: Plain text
-#: build/C/man3/pthread_kill_other_threads_np.3:45
+#: build/C/man3/pthread_kill_other_threads_np.3:47
msgid ""
"B<pthread_kill_other_threads_np>() only has an effect in the LinuxThreads "
"threading implementation. On that implementation, calling this function "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill_other_threads_np.3:57
+#: build/C/man3/pthread_kill_other_threads_np.3:59
msgid ""
"B<pthread_kill_other_threads_np>() is intended to be called just before a "
"thread calls B<execve>(2) or a similar function. This function is designed "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill_other_threads_np.3:64
+#: build/C/man3/pthread_kill_other_threads_np.3:66
msgid ""
"In the NPTL threading implementation, B<pthread_kill_other_threads_np>() "
"exists, but does nothing. (Nothing needs to be done, because the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_kill_other_threads_np.3:70
+#: build/C/man3/pthread_kill_other_threads_np.3:72
msgid ""
"B<execve>(2), B<pthread_cancel>(3), B<pthread_setcancelstate>(3), "
"B<pthread_setcanceltype>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_self.3:24
+#: build/C/man3/pthread_self.3:26
#, no-wrap
msgid "PTHREAD_SELF"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:27
+#: build/C/man3/pthread_self.3:29
msgid "pthread_self - obtain ID of the calling thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:32
+#: build/C/man3/pthread_self.3:34
#, no-wrap
msgid "B<pthread_t pthread_self(void);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:44
+#: build/C/man3/pthread_self.3:46
msgid ""
"The B<pthread_self>() function returns the ID of the calling thread. This "
"is the same value that is returned in I<*thread> in the B<pthread_create>(3) "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:46
+#: build/C/man3/pthread_self.3:48
msgid "This function always succeeds, returning the calling thread's ID."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:61
+#: build/C/man3/pthread_self.3:63
msgid ""
"POSIX.1 allows an implementation wide freedom in choosing the type used to "
"represent a thread ID; for example, representation using either an "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:65
+#: build/C/man3/pthread_self.3:67
msgid ""
"Thread identifiers should be considered opaque: any attempt to use a thread "
"ID other than in pthreads calls is nonportable and can lead to unspecified "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:69
+#: build/C/man3/pthread_self.3:71
msgid ""
"Thread IDs are only guaranteed to be unique within a process. A thread ID "
"may be reused after a terminated thread has been joined, or a detached "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:74
+#: build/C/man3/pthread_self.3:76
msgid ""
"The thread ID returned by B<pthread_self>() is not the same thing as the "
"kernel thread ID returned by a call to B<gettid>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_self.3:78
+#: build/C/man3/pthread_self.3:80
msgid "B<pthread_create>(3), B<pthread_equal>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setaffinity_np.3:24
+#: build/C/man3/pthread_setaffinity_np.3:26
#, no-wrap
msgid "PTHREAD_SETAFFINITY_NP"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:28
+#: build/C/man3/pthread_setaffinity_np.3:30
msgid ""
"pthread_setaffinity_np, pthread_getaffinity_np - set/get CPU affinity of a "
"thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:37
+#: build/C/man3/pthread_setaffinity_np.3:39
#, no-wrap
msgid ""
"B<int pthread_setaffinity_np(pthread_t >I<thread>B<, size_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:52
+#: build/C/man3/pthread_setaffinity_np.3:54
msgid ""
"The B<pthread_setaffinity_np>() function sets the CPU affinity mask of the "
"thread I<thread> to the CPU set pointed to by I<cpuset>. If the call is "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:59
+#: build/C/man3/pthread_setaffinity_np.3:61
msgid ""
"The B<pthread_getaffinity_np>() function returns the CPU affinity mask of "
"the thread I<thread> in the buffer pointed to by I<cpuset>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:75
+#: build/C/man3/pthread_setaffinity_np.3:77
msgid ""
"The argument I<cpusetsize> is the length (in bytes) of the buffer pointed to "
"by I<cpuset>. Typically, this argument would be specified as "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_setaffinity_np.3:79
+#: build/C/man3/pthread_setaffinity_np.3:81
#, no-wrap
msgid "B<EFAULT>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:82
+#: build/C/man3/pthread_setaffinity_np.3:84
msgid "A supplied memory address was invalid."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:91
+#: build/C/man3/pthread_setaffinity_np.3:93
msgid ""
"(B<pthread_setaffinity_np>()) The affinity bit mask I<mask> contains no "
"processors that are currently physically on the system and permitted to the "
#. The raw sched_getaffinity() system call returns the size (in bytes)
#. of the cpumask_t type.
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:107
+#: build/C/man3/pthread_setaffinity_np.3:109
msgid ""
"(B<pthread_setaffinity_np>()) I<cpuset> specified a CPU that was outside "
"the set supported by the kernel. (The kernel configuration option "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:112
+#: build/C/man3/pthread_setaffinity_np.3:114
msgid ""
"(B<pthread_getaffinity_np>()) I<cpusetsize> is smaller than the size of the "
"affinity mask used by the kernel."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:135
+#: build/C/man3/pthread_setaffinity_np.3:137
msgid ""
"After a call to B<pthread_setaffinity_np>(), the set of CPUs on which the "
"thread will actually run is the intersection of the set specified in the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:141
+#: build/C/man3/pthread_setaffinity_np.3:143
msgid ""
"These functions are implemented on top of the B<sched_setaffinity>(2) and "
"B<sched_getaffinity>(2) system calls."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:152
+#: build/C/man3/pthread_setaffinity_np.3:154
msgid ""
"A new thread created by B<pthread_create>(3) inherits a copy of its "
"creator's CPU affinity mask."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:160
+#: build/C/man3/pthread_setaffinity_np.3:162
msgid ""
"In the following program, the main thread uses B<pthread_setaffinity_np>() "
"to set its CPU affinity mask to include CPUs 0 to 7 (which may not all be "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:167
+#: build/C/man3/pthread_setaffinity_np.3:169
#, no-wrap
msgid ""
"#define _GNU_SOURCE\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:177
+#: build/C/man3/pthread_setaffinity_np.3:179
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:179
+#: build/C/man3/pthread_setaffinity_np.3:181
#, no-wrap
msgid " thread = pthread_self();\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:181
+#: build/C/man3/pthread_setaffinity_np.3:183
#, no-wrap
msgid " /* Set affinity mask to include CPUs 0 to 7 */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:185
+#: build/C/man3/pthread_setaffinity_np.3:187
#, no-wrap
msgid ""
" CPU_ZERO(&cpuset);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:189
+#: build/C/man3/pthread_setaffinity_np.3:191
#, no-wrap
msgid ""
" s = pthread_setaffinity_np(thread, sizeof(cpu_set_t), &cpuset);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:191
+#: build/C/man3/pthread_setaffinity_np.3:193
#, no-wrap
msgid " /* Check the actual affinity mask assigned to the thread */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:195
+#: build/C/man3/pthread_setaffinity_np.3:197
#, no-wrap
msgid ""
" s = pthread_getaffinity_np(thread, sizeof(cpu_set_t), &cpuset);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:200
+#: build/C/man3/pthread_setaffinity_np.3:202
#, no-wrap
msgid ""
" printf(\"Set returned by pthread_getaffinity_np() contained:\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:203 build/C/man3/pthread_setschedparam.3:428
+#: build/C/man3/pthread_setaffinity_np.3:205 build/C/man3/pthread_setschedparam.3:430
#, no-wrap
msgid ""
" exit(EXIT_SUCCESS);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setaffinity_np.3:212
+#: build/C/man3/pthread_setaffinity_np.3:214
msgid ""
"B<sched_setaffinity>(2), B<sched_setscheduler>(2), "
"B<pthread_attr_setaffinity_np>(3), B<pthread_self>(3), B<sched_getcpu>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setcancelstate.3:24
+#: build/C/man3/pthread_setcancelstate.3:26
#, no-wrap
msgid "PTHREAD_SETCANCELSTATE"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:28
+#: build/C/man3/pthread_setcancelstate.3:30
msgid ""
"pthread_setcancelstate, pthread_setcanceltype - set cancelability state and "
"type"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:34
+#: build/C/man3/pthread_setcancelstate.3:36
#, no-wrap
msgid ""
"B<int pthread_setcancelstate(int >I<state>B<, int *>I<oldstate>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:49
+#: build/C/man3/pthread_setcancelstate.3:51
msgid ""
"The B<pthread_setcancelstate>() sets the cancelability state of the calling "
"thread to the value given in I<state>. The previous cancelability state of "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_setcancelstate.3:49
+#: build/C/man3/pthread_setcancelstate.3:51
#, no-wrap
msgid "B<PTHREAD_CANCEL_ENABLE>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:56
+#: build/C/man3/pthread_setcancelstate.3:58
msgid ""
"The thread is cancelable. This is the default cancelability state in all "
"new threads, including the initial thread. The thread's cancelability type "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_setcancelstate.3:56
+#: build/C/man3/pthread_setcancelstate.3:58
#, no-wrap
msgid "B<PTHREAD_CANCEL_DISABLE>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:61
+#: build/C/man3/pthread_setcancelstate.3:63
msgid ""
"The thread is not cancelable. If a cancellation request is received, it is "
"blocked until cancelability is enabled."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:73
+#: build/C/man3/pthread_setcancelstate.3:75
msgid ""
"The B<pthread_setcanceltype>() sets the cancelability type of the calling "
"thread to the value given in I<type>. The previous cancelability type of "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_setcancelstate.3:73
+#: build/C/man3/pthread_setcancelstate.3:75
#, no-wrap
msgid "B<PTHREAD_CANCEL_DEFERRED>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:80
+#: build/C/man3/pthread_setcancelstate.3:82
msgid ""
"A cancellation request is deferred until the thread next calls a function "
"that is a cancellation point (see B<pthreads>(7)). This is the default "
msgstr ""
#. type: TP
-#: build/C/man3/pthread_setcancelstate.3:80
+#: build/C/man3/pthread_setcancelstate.3:82
#, no-wrap
msgid "B<PTHREAD_CANCEL_ASYNCHRONOUS>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:86
+#: build/C/man3/pthread_setcancelstate.3:88
msgid ""
"The thread can be canceled at any time. (Typically, it will be canceled "
"immediately upon receiving a cancellation request, but the system doesn't "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:90
+#: build/C/man3/pthread_setcancelstate.3:92
msgid ""
"The set-and-get operation performed by each of these functions is atomic "
"with respect to other threads in the process calling the same function."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:97
+#: build/C/man3/pthread_setcancelstate.3:99
msgid "The B<pthread_setcancelstate>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:101
+#: build/C/man3/pthread_setcancelstate.3:103
msgid "Invalid value for I<state>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:105
+#: build/C/man3/pthread_setcancelstate.3:107
msgid "The B<pthread_setcanceltype>() can fail with the following error:"
msgstr ""
#. .SH VERSIONS
#. Available since glibc 2.0
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:111
+#: build/C/man3/pthread_setcancelstate.3:113
msgid "Invalid value for I<type>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:116
+#: build/C/man3/pthread_setcancelstate.3:118
msgid ""
"For details of what happens when a thread is canceled, see "
"B<pthread_cancel>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:123
+#: build/C/man3/pthread_setcancelstate.3:125
msgid ""
"Briefly disabling cancelability is useful if a thread performs some critical "
"action that must not be interrupted by a cancellation request. Beware of "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:154
+#: build/C/man3/pthread_setcancelstate.3:156
msgid ""
"Setting the cancelability type to B<PTHREAD_CANCEL_ASYNCHRONOUS> is rarely "
"useful. Since the thread could be canceled at I<any> time, it cannot safely "
#. It looks like at least Solaris, FreeBSD and Tru64 support this.
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:172
+#: build/C/man3/pthread_setcancelstate.3:174
msgid ""
"The Linux threading implementations permit the I<oldstate> argument of "
"B<pthread_setcancelstate>() to be NULL, in which case the information about "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:175
+#: build/C/man3/pthread_setcancelstate.3:177
msgid "See B<pthread_cancel>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setcancelstate.3:180
+#: build/C/man3/pthread_setcancelstate.3:182
msgid ""
"B<pthread_cancel>(3), B<pthread_cleanup_push>(3), B<pthread_testcancel>(3), "
"B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setconcurrency.3:23
+#: build/C/man3/pthread_setconcurrency.3:25
#, no-wrap
msgid "PTHREAD_SETCONCURRENCY"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setconcurrency.3:23 build/C/man3/pthread_yield.3:23
+#: build/C/man3/pthread_setconcurrency.3:25
#, no-wrap
msgid "2009-04-10"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:27
+#: build/C/man3/pthread_setconcurrency.3:29
msgid ""
"pthread_setconcurrency, pthread_getconcurrency - set/get the concurrency "
"level"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:33
+#: build/C/man3/pthread_setconcurrency.3:35
#, no-wrap
msgid ""
"B<int pthread_setconcurrency(int >I<new_level>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:46
+#: build/C/man3/pthread_setconcurrency.3:48
msgid ""
"The B<pthread_setconcurrency>() function informs the implementation of the "
"application's desired concurrency level, specified in I<new_level>. The "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:51
+#: build/C/man3/pthread_setconcurrency.3:53
msgid ""
"Specifying I<new_level> as 0 instructs the implementation to manage the "
"concurrency level as it deems appropriate."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:54
+#: build/C/man3/pthread_setconcurrency.3:56
msgid ""
"B<pthread_getconcurrency>() returns the current value of the concurrency "
"level for this process."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:59
+#: build/C/man3/pthread_setconcurrency.3:61
msgid ""
"On success, B<pthread_setconcurrency>() returns 0; on error, it returns a "
"nonzero error number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:66
+#: build/C/man3/pthread_setconcurrency.3:68
msgid ""
"B<pthread_getconcurrency>() always succeeds, returning the concurrency "
"level set by a previous call to B<pthread_setconcurrency>(), or 0, if "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:69
+#: build/C/man3/pthread_setconcurrency.3:71
msgid "B<pthread_setconcurrency>() can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:73
+#: build/C/man3/pthread_setconcurrency.3:75
msgid "I<new_level> is negative."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:79
+#: build/C/man3/pthread_setconcurrency.3:81
msgid ""
"POSIX.1-2001 also documents an B<EAGAIN> error (\"the value specified by "
"I<new_level> would cause a system resource to be exceeded\")."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:81
+#: build/C/man3/pthread_setconcurrency.3:83
msgid "These functions are available in glibc since version 2.1."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:85
+#: build/C/man3/pthread_setconcurrency.3:87
msgid "The default concurrency level is 0."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:92
+#: build/C/man3/pthread_setconcurrency.3:94
msgid ""
"Concurrency levels are only meaningful for M:N threading implementations, "
"where at any moment a subset of a process's set of user-level threads may be "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:98
+#: build/C/man3/pthread_setconcurrency.3:100
msgid ""
"Both LinuxThreads and NPTL are 1:1 threading implementations, so setting the "
"concurrency level has no meaning. In other words, on Linux these functions "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setconcurrency.3:101
+#: build/C/man3/pthread_setconcurrency.3:103
msgid "B<pthread_attr_setscope>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setschedparam.3:24
+#: build/C/man3/pthread_setname_np.3:26
+#, no-wrap
+msgid "PTHREAD_SETNAME_NP"
+msgstr ""
+
+#. type: TH
+#: build/C/man3/pthread_setname_np.3:26
+#, no-wrap
+msgid "2013-02-04"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:29
+msgid "pthread_setname_np, pthread_getname_np - set/get the name of a thread"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:36
+#, no-wrap
+msgid ""
+"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
+"B<#include E<lt>pthread.hE<gt>>\n"
+"B<int pthread_setname_np(pthread_t *>I<thread>B<, const char "
+"*>I<name>B<);>\n"
+"B<int pthread_getname_np(pthread_t *>I<thread>B<,>\n"
+"B< const char *>I<name>B<, size_t >I<len>B<);>\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:55
+msgid ""
+"By default, all the threads created using B<pthread_create>() inherit the "
+"program name. The B<pthread_setname_np>() function can be used to set a "
+"unique name for a thread, which can be useful for debugging multithreaded "
+"applications. The thread name is a meaningful C language string, whose "
+"length is restricted to 16 characters, including the terminating null byte. "
+"The I<thread> argument specifies the thread whose name is to be changed; "
+"I<name> specifies the new name."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:72
+msgid ""
+"The B<pthread_getname_np>() function can be used to retrieve the name of "
+"the thread. The I<thread> argument specifies the thread whose name is to be "
+"retrieved. The buffer I<name> is used to return the thread name; I<len> "
+"specifies the number of bytes available in I<name>. The buffer specified by "
+"I<name> should be at least 16 characters in length. The returned thread "
+"name in the output buffer will be null terminated."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:79
+msgid "The B<pthread_setname_np>() function can fail with the following error:"
+msgstr ""
+
+#. type: TP
+#: build/C/man3/pthread_setname_np.3:79 build/C/man3/pthread_setname_np.3:88
+#, no-wrap
+msgid "B<ERANGE>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:84
+msgid ""
+"The length of the string specified pointed to by I<name> exceeds the allowed "
+"limit."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:88
+msgid "The B<pthread_getname_np>() function can fail with the following error:"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:95
+msgid ""
+"The buffer specified by I<name> and I<len> is too small to hold the thread "
+"name."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:100
+msgid ""
+"If either of these functions fails to open I</proc/self/task/[tid]/comm>, "
+"then the call may fail with one of the errors described in B<open>(2)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:102
+msgid "These functions first appeared in glibc in version 2.12."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:104
+msgid "These functions are nonstandard GNU extensions."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:112
+msgid ""
+"B<pthread_setname_np>() internally writes to the thread specific comm file "
+"under I</proc> filesystem: I</proc/self/task/[tid]/comm>. "
+"B<pthread_getname_np>() retrieves it from the same location."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:118
+msgid ""
+"The program below demonstrates the use of B<pthread_setname_np>() and "
+"B<pthread_getname_np>()."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:120
+msgid "The following shell session shows a sample run of the program:"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:136
+#, no-wrap
+msgid ""
+"$B< ./a.out>\n"
+"Created a thread. Default name is: a.out\n"
+"The thread name after setting it is THREADFOO.\n"
+"B<^Z> # Suspend the program\n"
+"[1]+ Stopped ./a.out\n"
+"$ B<ps H -C a.out -o 'pid tid cmd comm'>\n"
+" PID TID CMD COMMAND\n"
+" 5990 5990 ./a.out a.out\n"
+" 5990 5991 ./a.out THREADFOO\n"
+"$ B<cat /proc/5990/task/5990/comm>\n"
+"a.out\n"
+"$ B<cat /proc/5990/task/5991/comm>\n"
+"THREADFOO\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:148
+#, no-wrap
+msgid ""
+"#define _GNU_SOURCE\n"
+"#include E<lt>pthread.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+"#include E<lt>unistd.hE<gt>\n"
+"#include E<lt>errno.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:150
+#, no-wrap
+msgid "#define NAMELEN 16\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:154
+#, no-wrap
+msgid ""
+"#define errExitEN(en, msg) \\e\n"
+" do { errno = en; perror(msg); exit(EXIT_FAILURE); \\e\n"
+" } while (0)\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:161
+#, no-wrap
+msgid ""
+"static void *\n"
+"threadfunc(void *parm)\n"
+"{\n"
+" sleep(5); // allow main program to set the thread name\n"
+" return NULL;\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:168
+#, no-wrap
+msgid ""
+"int\n"
+"main(int argc, char **argv)\n"
+"{\n"
+" pthread_t thread;\n"
+" int rc;\n"
+" char thread_name[NAMELEN];\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:172
+#, no-wrap
+msgid ""
+" rc = pthread_create(&thread, NULL, threadfunc, NULL);\n"
+" if (rc != 0)\n"
+" errExitEN(rc, \"pthread_create\");\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:176
+#, no-wrap
+msgid ""
+" rc = pthread_getname_np(thread, thread_name, NAMELEN);\n"
+" if (rc != 0)\n"
+" errExitEN(rc, \"pthread_getname_np\");\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:181
+#, no-wrap
+msgid ""
+" printf(\"Created a thread. Default name is: %s\\en\", thread_name);\n"
+" rc = pthread_setname_np(thread, (argc E<gt> 1) ? argv[1] : "
+"\"THREADFOO\");\n"
+" if (rc != 0)\n"
+" errExitEN(rc, \"pthread_setname_np\");\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:183
+#, no-wrap
+msgid " sleep(2);\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:189
+#, no-wrap
+msgid ""
+" rc = pthread_getname_np(thread, thread_name,\n"
+" (argc E<gt> 2) ? atoi(argv[1]) : NAMELEN);\n"
+" if (rc != 0)\n"
+" errExitEN(rc, \"pthread_getname_np\");\n"
+" printf(\"The thread name after setting it is %s.\\en\", thread_name);\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:193
+#, no-wrap
+msgid ""
+" rc = pthread_join(thread, NULL);\n"
+" if (rc != 0)\n"
+" errExitEN(rc, \"pthread_join\");\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:197
+#, no-wrap
+msgid ""
+" printf(\"Done\\en\");\n"
+" exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/pthread_setname_np.3:204
+msgid "B<prctl>(2), B<pthread_create>(3), B<pthreads>(7)"
+msgstr ""
+
+#. type: TH
+#: build/C/man3/pthread_setschedparam.3:26
#, no-wrap
msgid "PTHREAD_SETSCHEDPARAM"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:28
+#: build/C/man3/pthread_setschedparam.3:30
msgid ""
"pthread_setschedparam, pthread_getschedparam - set/get scheduling policy and "
"parameters of a thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:36
+#: build/C/man3/pthread_setschedparam.3:38
#, no-wrap
msgid ""
"B<pthread_setschedparam(pthread_t >I<thread>B<, int >I<policy>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:44
+#: build/C/man3/pthread_setschedparam.3:46
msgid ""
"The B<pthread_setschedparam>() function sets the scheduling policy and "
"parameters of the thread I<thread>."
#. but pthread_attr_setschedpolicy() restricts policy to RR/FIFO/OTHER
#. http://sourceware.org/bugzilla/show_bug.cgi?id=7013
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:55
+#: build/C/man3/pthread_setschedparam.3:57
msgid ""
"I<policy> specifies the new scheduling policy for I<thread>. The supported "
"values for I<policy>, and their semantics, are described in "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:61
+#: build/C/man3/pthread_setschedparam.3:63
msgid ""
"The structure pointed to by I<param> specifies the new scheduling parameters "
"for I<thread>. Scheduling parameters are maintained in the following "
#. Eventually (perhaps after writing the mutexattr pages), we
#. may want to add something on the topic to this page.
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:102
+#: build/C/man3/pthread_setschedparam.3:104
msgid ""
"The B<pthread_getschedparam>() function returns the scheduling policy and "
"parameters of the thread I<thread>, in the buffers pointed to by I<policy> "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:110
+#: build/C/man3/pthread_setschedparam.3:112
msgid ""
"On success, these functions return 0; on error, they return a nonzero error "
"number. If B<pthread_setschedparam>() fails, the scheduling policy and "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:112
+#: build/C/man3/pthread_setschedparam.3:114
msgid "Both of these functions can fail with the following error:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:120
+#: build/C/man3/pthread_setschedparam.3:122
msgid "B<pthread_setschedparam>() may additionally fail with the following errors:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:127
+#: build/C/man3/pthread_setschedparam.3:129
msgid ""
"I<policy> is not a recognized policy, or I<param> does not make sense for "
"the I<policy>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:131
+#: build/C/man3/pthread_setschedparam.3:133
msgid ""
"The caller does not have appropriate privileges to set the specified "
"scheduling policy and parameters."
#. .SH VERSIONS
#. Available since glibc 2.0
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:139
+#: build/C/man3/pthread_setschedparam.3:141
msgid ""
"POSIX.1-2001 also documents an B<ENOTSUP> (\"attempt was made to set the "
"policy or scheduling parameters to an unsupported value\") error for "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:147
+#: build/C/man3/pthread_setschedparam.3:149
msgid ""
"For a description of the permissions required to, and the effect of, "
"changing a thread's scheduling policy and priority, and details of the "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:154
+#: build/C/man3/pthread_setschedparam.3:156
msgid ""
"The program below demonstrates the use of B<pthread_setschedparam>() and "
"B<pthread_getschedparam>(), as well as the use of a number of other "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:170
+#: build/C/man3/pthread_setschedparam.3:172
msgid ""
"In the following run, the main thread sets its scheduling policy to "
"B<SCHED_FIFO> with a priority of 10, and initializes a thread attributes "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:178
+#: build/C/man3/pthread_setschedparam.3:180
#, no-wrap
msgid ""
"$ B<su> # Need privilege to set real-time scheduling policies\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:182
+#: build/C/man3/pthread_setschedparam.3:184
#, no-wrap
msgid ""
"Scheduler settings in \\(aqattr\\(aq\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:185
+#: build/C/man3/pthread_setschedparam.3:187
#, no-wrap
msgid ""
"Scheduler attributes of new thread\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:190
+#: build/C/man3/pthread_setschedparam.3:192
msgid ""
"In the above output, one can see that the scheduling policy and priority "
"were taken from the values specified in the thread attributes object."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:197
+#: build/C/man3/pthread_setschedparam.3:199
msgid ""
"The next run is the same as the previous, except that the inherit scheduler "
"attribute is set to B<PTHREAD_INHERIT_SCHED>, meaning that threads created "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:203
+#: build/C/man3/pthread_setschedparam.3:205
#, no-wrap
msgid ""
"# B<./a.out -mf10 -ar20 -i i>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:207
+#: build/C/man3/pthread_setschedparam.3:209
#, no-wrap
msgid ""
"Scheduler settings in \\(aqattr\\(aq\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:210
+#: build/C/man3/pthread_setschedparam.3:212
#, no-wrap
msgid ""
"Scheduler attributes of new thread\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:216
+#: build/C/man3/pthread_setschedparam.3:218
msgid ""
"In the above output, one can see that the scheduling policy and priority "
"were taken from the creating thread, rather than the thread attributes "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:222
+#: build/C/man3/pthread_setschedparam.3:224
msgid ""
"Note that if we had omitted the I<-i\\ i> option, the output would have been "
"the same, since B<PTHREAD_INHERIT_SCHED> is the default for the inherit "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:226
+#: build/C/man3/pthread_setschedparam.3:228
#, no-wrap
msgid "/* pthreads_sched_test.c */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:232
+#: build/C/man3/pthread_setschedparam.3:234
#, no-wrap
msgid ""
"#include E<lt>pthread.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:241
+#: build/C/man3/pthread_setschedparam.3:243
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:258
+#: build/C/man3/pthread_setschedparam.3:260
#, no-wrap
msgid ""
" fprintf(stderr, \"Usage: %s [options]\\en\", prog_name);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:269
+#: build/C/man3/pthread_setschedparam.3:271
#, no-wrap
msgid ""
"static int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:280
+#: build/C/man3/pthread_setschedparam.3:282
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:286
+#: build/C/man3/pthread_setschedparam.3:288
#, no-wrap
msgid ""
"static void\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:290
+#: build/C/man3/pthread_setschedparam.3:292
#, no-wrap
msgid ""
" s = pthread_getschedparam(pthread_self(), &policy, ¶m);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:294
+#: build/C/man3/pthread_setschedparam.3:296
#, no-wrap
msgid ""
" printf(\"%s\\en\", msg);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:299
+#: build/C/man3/pthread_setschedparam.3:301
#, no-wrap
msgid ""
"static void *\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:302
+#: build/C/man3/pthread_setschedparam.3:304
#, no-wrap
msgid ""
" return NULL;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:312
+#: build/C/man3/pthread_setschedparam.3:314
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:314
+#: build/C/man3/pthread_setschedparam.3:316
#, no-wrap
msgid " /* Process command-line options */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:319
+#: build/C/man3/pthread_setschedparam.3:321
#, no-wrap
msgid ""
" use_null_attrib = 0;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:329
+#: build/C/man3/pthread_setschedparam.3:331
#, no-wrap
msgid ""
" while ((opt = getopt(argc, argv, \"a:Ai:m:\")) != -1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:333
+#: build/C/man3/pthread_setschedparam.3:335
#, no-wrap
msgid ""
" if (use_null_attrib &&\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:336
+#: build/C/man3/pthread_setschedparam.3:338
#, no-wrap
msgid ""
" /* Optionally set scheduling attributes of main thread,\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:341
+#: build/C/man3/pthread_setschedparam.3:343
#, no-wrap
msgid ""
" if (main_sched_str != NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:346
+#: build/C/man3/pthread_setschedparam.3:348
#, no-wrap
msgid ""
" s = pthread_setschedparam(pthread_self(), policy, ¶m);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:349
+#: build/C/man3/pthread_setschedparam.3:351
#, no-wrap
msgid ""
" display_thread_sched_attr(\"Scheduler settings of main thread\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:351
+#: build/C/man3/pthread_setschedparam.3:353
#, no-wrap
msgid " /* Initialize thread attributes object according to options */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:360
+#: build/C/man3/pthread_setschedparam.3:362
#, no-wrap
msgid ""
" if (!use_null_attrib) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:368
+#: build/C/man3/pthread_setschedparam.3:370
#, no-wrap
msgid ""
" if (inheritsched_str != NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:373
+#: build/C/man3/pthread_setschedparam.3:375
#, no-wrap
msgid ""
" s = pthread_attr_setinheritsched(&attr, inheritsched);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:379
+#: build/C/man3/pthread_setschedparam.3:381
#, no-wrap
msgid ""
" if (attr_sched_str != NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:387
+#: build/C/man3/pthread_setschedparam.3:389
#, no-wrap
msgid ""
" s = pthread_attr_setschedpolicy(&attr, policy);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:390
+#: build/C/man3/pthread_setschedparam.3:392
#, no-wrap
msgid ""
" /* If we initialized a thread attributes object, display\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:398
+#: build/C/man3/pthread_setschedparam.3:400
#, no-wrap
msgid ""
" if (attrp != NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:401
+#: build/C/man3/pthread_setschedparam.3:403
#, no-wrap
msgid ""
" printf(\"Scheduler settings in \\(aqattr\\(aq\\en\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:409
+#: build/C/man3/pthread_setschedparam.3:411
#, no-wrap
msgid ""
" s = pthread_attr_getinheritsched(&attr, &inheritsched);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:411
+#: build/C/man3/pthread_setschedparam.3:413
#, no-wrap
msgid " /* Create a thread that will display its scheduling attributes */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:415
+#: build/C/man3/pthread_setschedparam.3:417
#, no-wrap
msgid ""
" s = pthread_create(&thread, attrp, &thread_start, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:417
+#: build/C/man3/pthread_setschedparam.3:419
#, no-wrap
msgid " /* Destroy unneeded thread attributes object */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:425
+#: build/C/man3/pthread_setschedparam.3:427
#, no-wrap
msgid ""
" s = pthread_join(thread, NULL);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedparam.3:441
+#: build/C/man3/pthread_setschedparam.3:445
msgid ""
"B<getrlimit>(2), B<sched_get_priority_min>(2), B<sched_setscheduler>(2), "
"B<pthread_attr_init>(3), B<pthread_attr_setinheritsched>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setschedprio.3:24
+#: build/C/man3/pthread_setschedprio.3:26
#, no-wrap
msgid "PTHREAD_SETSCHEDPRIO"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_setschedprio.3:24
+#: build/C/man3/pthread_setschedprio.3:26
#, no-wrap
msgid "2008-11-06"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:27
+#: build/C/man3/pthread_setschedprio.3:29
msgid "pthread_setschedprio - set scheduling priority of a thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:32
+#: build/C/man3/pthread_setschedprio.3:34
#, no-wrap
msgid "B<pthread_setschedprio(pthread_t >I<thread>B<, int >I<prio>B<);>\n"
msgstr ""
#. may want to add something on the topic to this page.
#. nptl/pthread_setschedparam.c has a similar case.
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:51
+#: build/C/man3/pthread_setschedprio.3:53
msgid ""
"The B<pthread_setschedprio>() function sets the scheduling priority of the "
"thread I<thread> to the value specified in I<prio>. (By contrast "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:59
+#: build/C/man3/pthread_setschedprio.3:61
msgid ""
"On success, this function returns 0; on error, it returns a nonzero error "
"number. If B<pthread_setschedprio>() fails, the scheduling priority of "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:64
+#: build/C/man3/pthread_setschedprio.3:66
msgid "I<prio> is not valid for the scheduling policy of the specified thread."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:68
+#: build/C/man3/pthread_setschedprio.3:70
msgid ""
"The caller does not have appropriate privileges to set the specified "
"priority."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:79
+#: build/C/man3/pthread_setschedprio.3:81
msgid ""
"POSIX.1-2001 also documents an B<ENOTSUP> (\"attempt was made to set the "
"priority to an unsupported value\") error for B<pthread_setschedparam>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:81
+#: build/C/man3/pthread_setschedprio.3:83
msgid "This function is available in glibc since version 2.3.4."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:89
+#: build/C/man3/pthread_setschedprio.3:91
msgid ""
"For a description of the permissions required to, and the effect of, "
"changing a thread's scheduling priority, and details of the permitted ranges "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_setschedprio.3:101
+#: build/C/man3/pthread_setschedprio.3:105
msgid ""
"B<getrlimit>(2), B<sched_get_priority_min>(2), B<sched_setscheduler>(2), "
"B<pthread_attr_init>(3), B<pthread_attr_setinheritsched>(3), "
msgstr ""
#. type: TH
-#: build/C/man3/pthread_sigmask.3:24
+#: build/C/man3/pthread_sigmask.3:26
#, no-wrap
msgid "PTHREAD_SIGMASK"
msgstr ""
-#. type: TH
-#: build/C/man3/pthread_sigmask.3:24
-#, no-wrap
-msgid "2011-10-16"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:27
+#: build/C/man3/pthread_sigmask.3:29
msgid "pthread_sigmask - examine and change mask of blocked signals"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:33
+#: build/C/man3/pthread_sigmask.3:35
#, no-wrap
msgid ""
"B<int pthread_sigmask(int >I<how>B<, const sigset_t *>I<set>B<, sigset_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:44
+#: build/C/man3/pthread_sigmask.3:46
msgid ""
"The B<pthread_sigmask>() function is just like B<sigprocmask>(2), with the "
"difference that its use in multithreaded programs is explicitly specified by "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:47
+#: build/C/man3/pthread_sigmask.3:49
msgid ""
"For a description of the arguments and operation of this function, see "
"B<sigprocmask>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:52
+#: build/C/man3/pthread_sigmask.3:54
msgid ""
"On success, B<pthread_sigmask>() returns 0; on error, it returns an error "
"number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:55
+#: build/C/man3/pthread_sigmask.3:57
msgid "See B<sigprocmask>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:59
+#: build/C/man3/pthread_sigmask.3:61
msgid "A new thread inherits a copy of its creator's signal mask."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:64
+#: build/C/man3/pthread_sigmask.3:66
msgid ""
"The program below blocks some signals in the main thread, and then creates a "
"dedicated thread to fetch those signals via B<sigwait>(3). The following "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:75
+#: build/C/man3/pthread_sigmask.3:77
#, no-wrap
msgid ""
"$B< ./a.out &>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:86
+#: build/C/man3/pthread_sigmask.3:88
#, no-wrap
msgid ""
"#include E<lt>pthread.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:88
+#: build/C/man3/pthread_sigmask.3:90
#, no-wrap
msgid "/* Simple error handling functions */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:97
+#: build/C/man3/pthread_sigmask.3:99
#, no-wrap
msgid ""
"static void *\n"
"sig_thread(void *arg)\n"
"{\n"
-" sigset_t *set = (sigset_t *) arg;\n"
+" sigset_t *set = arg;\n"
" int s, sig;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:105
+#: build/C/man3/pthread_sigmask.3:107
#, no-wrap
msgid ""
" for (;;) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:112
+#: build/C/man3/pthread_sigmask.3:114
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:115
+#: build/C/man3/pthread_sigmask.3:117
#, no-wrap
msgid ""
" /* Block SIGQUIT and SIGUSR1; other threads created by main()\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:122
+#: build/C/man3/pthread_sigmask.3:124
#, no-wrap
msgid ""
" sigemptyset(&set);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:126
+#: build/C/man3/pthread_sigmask.3:128
#, no-wrap
msgid ""
" s = pthread_create(&thread, NULL, &sig_thread, (void *) &set);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:129
+#: build/C/man3/pthread_sigmask.3:131
#, no-wrap
msgid ""
" /* Main thread carries on to create other threads and/or do\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:132
+#: build/C/man3/pthread_sigmask.3:134
#, no-wrap
msgid ""
" pause(); /* Dummy pause so we can test program */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigmask.3:142
+#: build/C/man3/pthread_sigmask.3:144
msgid ""
-"B<sigaction>(2), B<sigpending>(2), B<sigprocmask>(2) B<pthread_create>(3), "
+"B<sigaction>(2), B<sigpending>(2), B<sigprocmask>(2), B<pthread_create>(3), "
"B<pthread_kill>(3), B<sigsetops>(3), B<pthreads>(7), B<signal>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_sigqueue.3:23
+#: build/C/man3/pthread_sigqueue.3:25
#, no-wrap
msgid "PTHREAD_SIGQUEUE"
msgstr ""
-#. type: TH
-#: build/C/man3/pthread_sigqueue.3:23
-#, no-wrap
-msgid "2011-09-23"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:26
+#: build/C/man3/pthread_sigqueue.3:28
msgid "pthread_sigqueue - queue a signal and data to a thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:32
+#: build/C/man3/pthread_sigqueue.3:34
#, no-wrap
msgid ""
"B<int pthread_sigqueue(pthread_t *>I<thread>B<, int >I<sig>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:43
+#: build/C/man3/pthread_sigqueue.3:45
msgid "B<pthread_sigqueue>(): _GNU_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:51
+#: build/C/man3/pthread_sigqueue.3:53
msgid ""
"The B<pthread_sigqueue>() function performs a similar task to "
-"B<sigqueue>(3), but, rather than sending a signal to another process, it "
-"sends a signal to another thread in the same process as the calling thread."
+"B<sigqueue>(3), but, rather than sending a signal to a process, it sends a "
+"signal to a thread in the same process as the calling thread."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:63
+#: build/C/man3/pthread_sigqueue.3:65
msgid ""
-"The I<thread> argument is the ID of another thread in the same process as "
-"the caller. The I<sig> argument specifies the signal to be sent. The "
-"I<value> argument specifies data to accompany the signal; see B<sigqueue>(3) "
-"for details."
+"The I<thread> argument is the ID of a thread in the same process as the "
+"caller. The I<sig> argument specifies the signal to be sent. The I<value> "
+"argument specifies data to accompany the signal; see B<sigqueue>(3) for "
+"details."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:68
+#: build/C/man3/pthread_sigqueue.3:70
msgid ""
"On success, B<pthread_sigqueue>() returns 0; on error, it returns an error "
"number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:75
+#: build/C/man3/pthread_sigqueue.3:77
msgid ""
"The limit of signals which may be queued has been reached. (See "
"B<signal>(7) for further information.)"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:79
+#: build/C/man3/pthread_sigqueue.3:81
msgid "I<sig> was invalid."
msgstr ""
#. type: TP
-#: build/C/man3/pthread_sigqueue.3:79
+#: build/C/man3/pthread_sigqueue.3:81
#, no-wrap
msgid "B<ENOSYS>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:83
+#: build/C/man3/pthread_sigqueue.3:85
msgid "B<pthread_sigqueue>() is not supported on this system."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:87
+#: build/C/man3/pthread_sigqueue.3:89
msgid "I<thread> is not valid."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:91
+#: build/C/man3/pthread_sigqueue.3:93
msgid "The B<pthread_sigqueue>() function first appeared in glibc 2.11."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:93
+#: build/C/man3/pthread_sigqueue.3:95
msgid "This function is a GNU extension."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_sigqueue.3:101
+#: build/C/man3/pthread_sigqueue.3:103
msgid ""
"B<rt_tgsigqueueinfo>(2), B<sigaction>(2), B<pthread_sigmask>(3), "
"B<sigqueue>(3), B<sigwait>(3), B<pthreads>(7), B<signal>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_testcancel.3:24
+#: build/C/man3/pthread_testcancel.3:26
#, no-wrap
msgid "PTHREAD_TESTCANCEL"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_testcancel.3:24
+#: build/C/man3/pthread_testcancel.3:26
#, no-wrap
msgid "2012-04-14"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:27
+#: build/C/man3/pthread_testcancel.3:29
msgid "pthread_testcancel - request delivery of any pending cancellation request"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:32
+#: build/C/man3/pthread_testcancel.3:34
#, no-wrap
msgid "B<void pthread_testcancel(void);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:41
+#: build/C/man3/pthread_testcancel.3:43
msgid ""
"Calling B<pthread_testcancel>() creates a cancellation point within the "
"calling thread, so that a thread that is otherwise executing code that "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:48
+#: build/C/man3/pthread_testcancel.3:50
msgid ""
"If cancelability is disabled (using B<pthread_setcancelstate>(3)), or no "
-"cancellation request is pending, then a call to B<pthread_testcancel>(3) "
-"has no effect."
+"cancellation request is pending, then a call to B<pthread_testcancel>() has "
+"no effect."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:52
+#: build/C/man3/pthread_testcancel.3:54
msgid ""
"This function does not return a value. If the calling thread is canceled as "
"a consequence of a call to this function, then the function does not return."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:61
+#: build/C/man3/pthread_testcancel.3:63
msgid "See B<pthread_cleanup_push>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_testcancel.3:66
+#: build/C/man3/pthread_testcancel.3:68
msgid ""
"B<pthread_cancel>(3), B<pthread_cleanup_push>(3), "
"B<pthread_setcancelstate>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_tryjoin_np.3:24
+#: build/C/man3/pthread_tryjoin_np.3:26
#, no-wrap
msgid "PTHREAD_TRYJOIN_NP"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:28
+#: build/C/man3/pthread_tryjoin_np.3:30
msgid ""
"pthread_tryjoin_np, pthread_timedjoin_np - try to join with a terminated "
"thread"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:34
+#: build/C/man3/pthread_tryjoin_np.3:36
#, no-wrap
msgid "B<int pthread_tryjoin_np(pthread_t >I<thread>B<, void **>I<retval>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:37
+#: build/C/man3/pthread_tryjoin_np.3:39
#, no-wrap
msgid ""
"B<int pthread_timedjoin_np(pthread_t >I<thread>B<, void **>I<retval>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:44
+#: build/C/man3/pthread_tryjoin_np.3:46
msgid ""
"These functions operate in the same way as B<pthread_join>(3), except for "
"the differences described on this page."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:56
+#: build/C/man3/pthread_tryjoin_np.3:58
msgid ""
"The B<pthread_tryjoin_np>() function performs a nonblocking join with the "
"thread I<thread>, returning the exit status of the thread in I<*retval>. If "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:74
+#: build/C/man3/pthread_tryjoin_np.3:76
msgid ""
"The B<pthread_timedjoin_np>() function performs a join-with-timeout. If "
"I<thread> has not yet terminated, then the call blocks until a maximum time, "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:81
+#: build/C/man3/pthread_tryjoin_np.3:83
#, no-wrap
msgid ""
"struct timespec {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:87
+#: build/C/man3/pthread_tryjoin_np.3:89
msgid "On success, these functions return 0; on error, they return an error number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:92
+#: build/C/man3/pthread_tryjoin_np.3:94
msgid ""
"These functions can fail with the same errors as B<pthread_join>(3). "
"B<pthread_tryjoin_np>() can in addition fail with the following error:"
msgstr ""
#. type: TP
-#: build/C/man3/pthread_tryjoin_np.3:92
+#: build/C/man3/pthread_tryjoin_np.3:94
#, no-wrap
msgid "B<EBUSY>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:96
+#: build/C/man3/pthread_tryjoin_np.3:98
msgid "I<thread> had not yet terminated at the time of the call."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:99
+#: build/C/man3/pthread_tryjoin_np.3:101
msgid "B<pthread_timedjoin_np>() can in addition fail with the following error:"
msgstr ""
#. type: TP
-#: build/C/man3/pthread_tryjoin_np.3:99
+#: build/C/man3/pthread_tryjoin_np.3:101
#, no-wrap
msgid "B<ETIMEDOUT>"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:104
+#: build/C/man3/pthread_tryjoin_np.3:106
msgid "The call timed out before I<thread> terminated."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:108
+#: build/C/man3/pthread_tryjoin_np.3:110
msgid "B<pthread_timedjoin_np>() never returns the error B<EINTR>."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:110
+#: build/C/man3/pthread_tryjoin_np.3:112
msgid "These functions first appeared in glibc in version 2.3.3."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:115
+#: build/C/man3/pthread_tryjoin_np.3:117
msgid "The following code waits to join for up to 5 seconds:"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:119
+#: build/C/man3/pthread_tryjoin_np.3:121
#, no-wrap
msgid ""
" struct timespec ts;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:121
+#: build/C/man3/pthread_tryjoin_np.3:123
#, no-wrap
msgid " ...\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:125
+#: build/C/man3/pthread_tryjoin_np.3:127
#, no-wrap
msgid ""
" if (clock_gettime(CLOCK_REALTIME, &ts) == -1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:127
+#: build/C/man3/pthread_tryjoin_np.3:129
#, no-wrap
msgid " ts.tv_sec += 5;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:132
+#: build/C/man3/pthread_tryjoin_np.3:134
#, no-wrap
msgid ""
" s = pthread_timedjoin_np(thread, NULL, &ts);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_tryjoin_np.3:138
+#: build/C/man3/pthread_tryjoin_np.3:140
msgid "B<clock_gettime>(2), B<pthread_exit>(3), B<pthread_join>(3), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/pthread_yield.3:23
+#: build/C/man3/pthread_yield.3:25
#, no-wrap
msgid "PTHREAD_YIELD"
msgstr ""
+#. type: TH
+#: build/C/man3/pthread_yield.3:25
+#, no-wrap
+msgid "2013-03-05"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/pthread_yield.3:26
+#: build/C/man3/pthread_yield.3:28
msgid "pthread_yield - yield the processor"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_yield.3:31
+#: build/C/man3/pthread_yield.3:34
#, no-wrap
msgid "B<int pthread_yield(void);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_yield.3:41
+#: build/C/man3/pthread_yield.3:44
msgid ""
"B<pthread_yield>() causes the calling thread to relinquish the CPU. The "
"thread is placed at the end of the run queue for its static priority and "
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_yield.3:46
+#: build/C/man3/pthread_yield.3:49
msgid ""
"On success, B<pthread_yield>() returns 0; on error, it returns an error "
"number."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_yield.3:50
+#: build/C/man3/pthread_yield.3:53
msgid ""
"On Linux, this call always succeeds (but portable and future-proof "
"applications should nevertheless handle a possible error return)."
#. e.g., the BSDs, Tru64, AIX, and Irix.
#. type: Plain text
-#: build/C/man3/pthread_yield.3:56
+#: build/C/man3/pthread_yield.3:59
msgid ""
"This call is nonstandard, but present on several other systems. Use the "
"standardized B<sched_yield>(2) instead."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_yield.3:59
+#: build/C/man3/pthread_yield.3:62
msgid "On Linux, this function is implemented as a call to B<sched_yield>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/pthread_yield.3:63
-msgid "B<sched_setscheduler>(2), B<sched_yield>(2) B<pthreads>(7)"
+#: build/C/man3/pthread_yield.3:66
+msgid "B<sched_setscheduler>(2), B<sched_yield>(2), B<pthreads>(7)"
msgstr ""
#. type: TH
-#: build/C/man7/pthreads.7:24
+#: build/C/man7/pthreads.7:26
#, no-wrap
msgid "PTHREADS"
msgstr ""
#. type: TH
-#: build/C/man7/pthreads.7:24
+#: build/C/man7/pthreads.7:26
#, no-wrap
msgid "2010-11-14"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:27
+#: build/C/man7/pthreads.7:29
msgid "pthreads - POSIX threads"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:34
+#: build/C/man7/pthreads.7:36
msgid ""
"POSIX.1 specifies a set of interfaces (functions, header files) for threaded "
"programming commonly known as POSIX threads, or Pthreads. A single process "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:37
+#: build/C/man7/pthreads.7:39
msgid ""
"POSIX.1 also requires that threads share a range of other attributes (i.e., "
"these attributes are process-wide rather than per-thread):"
msgstr ""
#. type: IP
-#: build/C/man7/pthreads.7:37 build/C/man7/pthreads.7:39 build/C/man7/pthreads.7:41 build/C/man7/pthreads.7:43 build/C/man7/pthreads.7:45 build/C/man7/pthreads.7:47 build/C/man7/pthreads.7:49 build/C/man7/pthreads.7:52 build/C/man7/pthreads.7:54 build/C/man7/pthreads.7:57 build/C/man7/pthreads.7:63 build/C/man7/pthreads.7:68 build/C/man7/pthreads.7:71 build/C/man7/pthreads.7:74 build/C/man7/pthreads.7:82 build/C/man7/pthreads.7:86 build/C/man7/pthreads.7:89 build/C/man7/pthreads.7:93 build/C/man7/pthreads.7:96 build/C/man7/pthreads.7:103 build/C/man7/pthreads.7:106 build/C/man7/pthreads.7:683 build/C/man7/pthreads.7:690 build/C/man7/pthreads.7:702 build/C/man7/pthreads.7:712 build/C/man7/pthreads.7:716 build/C/man7/pthreads.7:725 build/C/man7/pthreads.7:735 build/C/man7/pthreads.7:742 build/C/man7/pthreads.7:749 build/C/man7/pthreads.7:751 build/C/man7/pthreads.7:754 build/C/man7/pthreads.7:760 build/C/man7/pthreads.7:763 build/C/man7/pthreads.7:765 build/C/man7/pthreads.7:767 build/C/man7/pthreads.7:777 build/C/man7/pthreads.7:797 build/C/man7/pthreads.7:806 build/C/man7/pthreads.7:812 build/C/man7/pthreads.7:814 build/C/man7/pthreads.7:816 build/C/man7/pthreads.7:820 build/C/man7/pthreads.7:825 build/C/man7/pthreads.7:833
+#: build/C/man7/pthreads.7:39 build/C/man7/pthreads.7:41 build/C/man7/pthreads.7:43 build/C/man7/pthreads.7:45 build/C/man7/pthreads.7:47 build/C/man7/pthreads.7:49 build/C/man7/pthreads.7:51 build/C/man7/pthreads.7:54 build/C/man7/pthreads.7:56 build/C/man7/pthreads.7:59 build/C/man7/pthreads.7:65 build/C/man7/pthreads.7:70 build/C/man7/pthreads.7:73 build/C/man7/pthreads.7:76 build/C/man7/pthreads.7:84 build/C/man7/pthreads.7:88 build/C/man7/pthreads.7:91 build/C/man7/pthreads.7:95 build/C/man7/pthreads.7:98 build/C/man7/pthreads.7:105 build/C/man7/pthreads.7:108 build/C/man7/pthreads.7:685 build/C/man7/pthreads.7:692 build/C/man7/pthreads.7:704 build/C/man7/pthreads.7:714 build/C/man7/pthreads.7:718 build/C/man7/pthreads.7:727 build/C/man7/pthreads.7:737 build/C/man7/pthreads.7:744 build/C/man7/pthreads.7:751 build/C/man7/pthreads.7:753 build/C/man7/pthreads.7:756 build/C/man7/pthreads.7:762 build/C/man7/pthreads.7:765 build/C/man7/pthreads.7:767 build/C/man7/pthreads.7:769 build/C/man7/pthreads.7:779 build/C/man7/pthreads.7:799 build/C/man7/pthreads.7:808 build/C/man7/pthreads.7:814 build/C/man7/pthreads.7:816 build/C/man7/pthreads.7:818 build/C/man7/pthreads.7:822 build/C/man7/pthreads.7:827 build/C/man7/pthreads.7:835
#, no-wrap
msgid "-"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:39
+#: build/C/man7/pthreads.7:41
msgid "process ID"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:41
+#: build/C/man7/pthreads.7:43
msgid "parent process ID"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:43
+#: build/C/man7/pthreads.7:45
msgid "process group ID and session ID"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:45
+#: build/C/man7/pthreads.7:47
msgid "controlling terminal"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:47
+#: build/C/man7/pthreads.7:49
msgid "user and group IDs"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:49
+#: build/C/man7/pthreads.7:51
msgid "open file descriptors"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:52
+#: build/C/man7/pthreads.7:54
msgid "record locks (see B<fcntl>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:54
+#: build/C/man7/pthreads.7:56
msgid "signal dispositions"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:57
+#: build/C/man7/pthreads.7:59
msgid "file mode creation mask (B<umask>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:63
+#: build/C/man7/pthreads.7:65
msgid "current directory (B<chdir>(2)) and root directory (B<chroot>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:68
+#: build/C/man7/pthreads.7:70
msgid "interval timers (B<setitimer>(2)) and POSIX timers (B<timer_create>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:71
+#: build/C/man7/pthreads.7:73
msgid "nice value (B<setpriority>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:74
+#: build/C/man7/pthreads.7:76
msgid "resource limits (B<setrlimit>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:79
+#: build/C/man7/pthreads.7:81
msgid ""
"measurements of the consumption of CPU time (B<times>(2)) and resources "
"(B<getrusage>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:82
+#: build/C/man7/pthreads.7:84
msgid ""
"As well as the stack, POSIX.1 specifies that various other attributes are "
"distinct for each thread, including:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:86
+#: build/C/man7/pthreads.7:88
msgid "thread ID (the I<pthread_t> data type)"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:89
+#: build/C/man7/pthreads.7:91
msgid "signal mask (B<pthread_sigmask>(3))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:93
+#: build/C/man7/pthreads.7:95
msgid "the I<errno> variable"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:96
+#: build/C/man7/pthreads.7:98
msgid "alternate signal stack (B<sigaltstack>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:101
+#: build/C/man7/pthreads.7:103
msgid ""
"real-time scheduling policy and priority (B<sched_setscheduler>(2) and "
"B<sched_setparam>(2))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:103
+#: build/C/man7/pthreads.7:105
msgid "The following Linux-specific features are also per-thread:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:106
+#: build/C/man7/pthreads.7:108
msgid "capabilities (see B<capabilities>(7))"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:109
+#: build/C/man7/pthreads.7:111
msgid "CPU affinity (B<sched_setaffinity>(2))"
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:109
+#: build/C/man7/pthreads.7:111
#, no-wrap
msgid "Pthreads function return values"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:116
+#: build/C/man7/pthreads.7:118
msgid ""
"Most pthreads functions return 0 on success, and an error number of "
"failure. Note that the pthreads functions do not set I<errno>. For each of "
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:116
+#: build/C/man7/pthreads.7:118
#, no-wrap
msgid "Thread IDs"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:130
+#: build/C/man7/pthreads.7:132
msgid ""
"Each of the threads in a process has a unique thread identifier (stored in "
"the type I<pthread_t>). This identifier is returned to the caller of "
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:130
+#: build/C/man7/pthreads.7:132
#, no-wrap
msgid "Thread-safe functions"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:134
+#: build/C/man7/pthreads.7:136
msgid ""
"A thread-safe function is one that can be safely (i.e., it will deliver the "
"same results regardless of whether it is) called from multiple threads at "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:138
+#: build/C/man7/pthreads.7:140
msgid ""
"POSIX.1-2001 and POSIX.1-2008 require that all functions specified in the "
"standard shall be thread-safe, except for the following functions:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:232
+#: build/C/man7/pthreads.7:234
#, no-wrap
msgid ""
"asctime()\n"
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:234
+#: build/C/man7/pthreads.7:236
#, no-wrap
msgid "Async-cancel-safe functions"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:238
+#: build/C/man7/pthreads.7:240
msgid ""
"An async-cancel-safe function is one that can be safely called in an "
"application where asynchronous cancelability is enabled (see "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:241
+#: build/C/man7/pthreads.7:243
msgid ""
"Only the following functions are required to be async-cancel-safe by "
"POSIX.1-2001 and POSIX.1-2008:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:247
+#: build/C/man7/pthreads.7:249
#, no-wrap
msgid ""
"pthread_cancel()\n"
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:249
+#: build/C/man7/pthreads.7:251
#, no-wrap
-msgid "Cancellation Points"
+msgid "Cancellation points"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:256
+#: build/C/man7/pthreads.7:258
msgid ""
"POSIX.1 specifies that certain functions must, and certain other functions "
"may, be cancellation points. If a thread is cancelable, its cancelability "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:259
+#: build/C/man7/pthreads.7:261
msgid ""
"The following functions are required to be cancellation points by "
"POSIX.1-2001 and/or POSIX.1-2008:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:322
+#: build/C/man7/pthreads.7:324
#, no-wrap
msgid ""
"accept()\n"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:327
+#: build/C/man7/pthreads.7:329
msgid ""
"The following functions may be cancellation points according to POSIX.1-2001 "
"and/or POSIX.1-2008:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:555
+#: build/C/man7/pthreads.7:557
#, no-wrap
msgid ""
"access()\n"
#. vsyslog
#. vwscanf
#. type: Plain text
-#: build/C/man7/pthreads.7:653
+#: build/C/man7/pthreads.7:655
msgid ""
"An implementation may also mark other functions not specified in the "
"standard as cancellation points. In particular, an implementation is likely "
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:653
+#: build/C/man7/pthreads.7:655
#, no-wrap
msgid "Compiling on Linux"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:656
+#: build/C/man7/pthreads.7:658
msgid ""
"On Linux, programs that use the Pthreads API should be compiled using I<cc "
"-pthread>."
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:656
+#: build/C/man7/pthreads.7:658
#, no-wrap
-msgid "Linux Implementations of POSIX Threads"
+msgid "Linux implementations of POSIX threads"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:659
+#: build/C/man7/pthreads.7:661
msgid ""
"Over time, two threading implementations have been provided by the GNU C "
"library on Linux:"
msgstr ""
#. type: TP
-#: build/C/man7/pthreads.7:659
+#: build/C/man7/pthreads.7:661
#, no-wrap
msgid "B<LinuxThreads>"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:663
+#: build/C/man7/pthreads.7:665
msgid ""
"This is the original Pthreads implementation. Since glibc 2.4, this "
"implementation is no longer supported."
msgstr ""
#. type: TP
-#: build/C/man7/pthreads.7:663
+#: build/C/man7/pthreads.7:665
#, no-wrap
msgid "B<NPTL> (Native POSIX Threads Library)"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:671
+#: build/C/man7/pthreads.7:673
msgid ""
"This is the modern Pthreads implementation. By comparison with "
"LinuxThreads, NPTL provides closer conformance to the requirements of the "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:681
+#: build/C/man7/pthreads.7:683
msgid ""
"Both of these are so-called 1:1 implementations, meaning that each thread "
"maps to a kernel scheduling entity. Both threading implementations employ "
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:681
+#: build/C/man7/pthreads.7:683
#, no-wrap
msgid "LinuxThreads"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:683
+#: build/C/man7/pthreads.7:685
msgid "The notable features of this implementation are the following:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:690
+#: build/C/man7/pthreads.7:692
msgid ""
"In addition to the main (initial) thread, and the threads that the program "
"creates using B<pthread_create>(3), the implementation creates a \"manager\" "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:702
+#: build/C/man7/pthreads.7:704
msgid ""
"Signals are used internally by the implementation. On Linux 2.2 and later, "
"the first three real-time signals are used (see also B<signal>(7)). On "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:709
+#: build/C/man7/pthreads.7:711
msgid ""
"Threads do not share process IDs. (In effect, LinuxThreads threads are "
"implemented as processes which share more information than usual, but which "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:712
+#: build/C/man7/pthreads.7:714
msgid ""
"The LinuxThreads implementation deviates from the POSIX.1 specification in a "
"number of ways, including the following:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:716
+#: build/C/man7/pthreads.7:718
msgid "Calls to B<getpid>(2) return a different value in each thread."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:725
+#: build/C/man7/pthreads.7:727
msgid ""
"Calls to B<getppid>(2) in threads other than the main thread return the "
"process ID of the manager thread; instead B<getppid>(2) in these threads "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:735
+#: build/C/man7/pthreads.7:737
msgid ""
"When one thread creates a new child process using B<fork>(2), any thread "
"should be able to B<wait>(2) on the child. However, the implementation "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:742
+#: build/C/man7/pthreads.7:744
msgid ""
"When a thread calls B<execve>(2), all other threads are terminated (as "
"required by POSIX.1). However, the resulting process has the same PID as "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:749
+#: build/C/man7/pthreads.7:751
msgid ""
"Threads do not share user and group IDs. This can cause complications with "
"set-user-ID programs and can cause failures in Pthreads functions if an "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:751
+#: build/C/man7/pthreads.7:753
msgid "Threads do not share a common session ID and process group ID."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:754
+#: build/C/man7/pthreads.7:756
msgid "Threads do not share record locks created using B<fcntl>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:760
+#: build/C/man7/pthreads.7:762
msgid ""
"The information returned by B<times>(2) and B<getrusage>(2) is per-thread "
"rather than process-wide."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:763
+#: build/C/man7/pthreads.7:765
msgid "Threads do not share semaphore undo values (see B<semop>(2))."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:765
+#: build/C/man7/pthreads.7:767
msgid "Threads do not share interval timers."
msgstr ""
#. "make setpriority POSIX compliant; introduce PRIO_THREAD extension"
#. Monitor this to see if it makes it into mainline.
#. type: Plain text
-#: build/C/man7/pthreads.7:767 build/C/man7/pthreads.7:804
+#: build/C/man7/pthreads.7:769 build/C/man7/pthreads.7:806
msgid "Threads do not share a common nice value."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:777
+#: build/C/man7/pthreads.7:779
msgid ""
"POSIX.1 distinguishes the notions of signals that are directed to the "
"process as a whole and signals that are directed to individual threads. "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:786
+#: build/C/man7/pthreads.7:788
msgid ""
"Threads have distinct alternate signal stack settings. However, a new "
"thread's alternate signal stack settings are copied from the thread that "
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:786
+#: build/C/man7/pthreads.7:788
#, no-wrap
msgid "NPTL"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:795
+#: build/C/man7/pthreads.7:797
msgid ""
"With NPTL, all of the threads in a process are placed in the same thread "
"group; all members of a thread group share the same PID. NPTL does not "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:797
+#: build/C/man7/pthreads.7:799
msgid "NPTL still has at least one nonconformance with POSIX.1:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:806
+#: build/C/man7/pthreads.7:808
msgid "Some NPTL nonconformances only occur with older kernels:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:812
+#: build/C/man7/pthreads.7:814
msgid ""
"The information returned by B<times>(2) and B<getrusage>(2) is per-thread "
"rather than process-wide (fixed in kernel 2.6.9)."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:814
+#: build/C/man7/pthreads.7:816
msgid "Threads do not share resource limits (fixed in kernel 2.6.10)."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:816
+#: build/C/man7/pthreads.7:818
msgid "Threads do not share interval timers (fixed in kernel 2.6.12)."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:820
+#: build/C/man7/pthreads.7:822
msgid ""
"Only the main thread is permitted to start a new session using B<setsid>(2) "
"(fixed in kernel 2.6.16)."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:825
+#: build/C/man7/pthreads.7:827
msgid ""
"Only the main thread is permitted to make the process into a process group "
"leader using B<setpgid>(2) (fixed in kernel 2.6.16)."
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:831
+#: build/C/man7/pthreads.7:833
msgid ""
"Threads have distinct alternate signal stack settings. However, a new "
"thread's alternate signal stack settings are copied from the thread that "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:833
+#: build/C/man7/pthreads.7:835
msgid "Note the following further points about the NPTL implementation:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:847
+#: build/C/man7/pthreads.7:849
msgid ""
"If the stack size soft resource limit (see the description of "
"B<RLIMIT_STACK> in B<setrlimit>(2)) is set to a value other than "
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:847
+#: build/C/man7/pthreads.7:849
#, no-wrap
-msgid "Determining the Threading Implementation"
+msgid "Determining the threading implementation"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:852
+#: build/C/man7/pthreads.7:854
msgid ""
"Since glibc 2.3.2, the B<getconf>(1) command can be used to determine the "
"system's threading implementation, for example:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:857
+#: build/C/man7/pthreads.7:859
#, no-wrap
msgid ""
"bash$ getconf GNU_LIBPTHREAD_VERSION\n"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:862
+#: build/C/man7/pthreads.7:864
msgid ""
"With older glibc versions, a command such as the following should be "
"sufficient to determine the default threading implementation:"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:868
+#: build/C/man7/pthreads.7:870
#, no-wrap
msgid ""
"bash$ $( ldd /bin/ls | grep libc.so | awk \\(aq{print $3}\\(aq ) | \\e\n"
msgstr ""
#. type: SS
-#: build/C/man7/pthreads.7:870
+#: build/C/man7/pthreads.7:872
#, no-wrap
-msgid "Selecting the Threading Implementation: LD_ASSUME_KERNEL"
+msgid "Selecting the threading implementation: LD_ASSUME_KERNEL"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:885
+#: build/C/man7/pthreads.7:887
msgid ""
"On systems with a glibc that supports both LinuxThreads and NPTL (i.e., "
"glibc 2.3.I<x>), the B<LD_ASSUME_KERNEL> environment variable can be used to "
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:891
+#: build/C/man7/pthreads.7:893
#, no-wrap
msgid ""
"bash$ $( LD_ASSUME_KERNEL=2.2.5 ldd /bin/ls | grep libc.so | \\e\n"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:903
+#: build/C/man7/pthreads.7:905
msgid ""
"B<clone>(2), B<futex>(2), B<gettid>(2), B<proc>(5), B<futex>(7), "
"B<sigevent>(7), B<signal>(7),"
msgstr ""
#. type: Plain text
-#: build/C/man7/pthreads.7:927
+#: build/C/man7/pthreads.7:929
msgid ""
-"and various Pthreads manual pages, for example: B<pthread_attr_init>(3), "
+"Various Pthreads manual pages, for example: B<pthread_attr_init>(3), "
"B<pthread_atfork>(3), B<pthread_cancel>(3), B<pthread_cleanup_push>(3), "
"B<pthread_cond_signal>(3), B<pthread_cond_wait>(3), B<pthread_create>(3), "
"B<pthread_detach>(3), B<pthread_equal>(3), B<pthread_exit>(3), "