po4a/pthread/po/pthread.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2013-09-28 04:06+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=CHARSET\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man3/getcontext.3:25
  21 #, no-wrap
  22 msgid "GETCONTEXT"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/getcontext.3:25
  27 #, no-wrap
  28 msgid "2009-03-15"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: 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
  33 #, no-wrap
  34 msgid "Linux"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: 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
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: 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
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/getcontext.3:28
  51 msgid "getcontext, setcontext - get or set the user context"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: 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
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/getcontext.3:30 build/C/man3/makecontext.3:33
  62 msgid "B<#include E<lt>ucontext.hE<gt>>"
  63 msgstr ""
  64
  65 #. type: Plain text
  66 #: build/C/man3/getcontext.3:32
  67 msgid "B<int getcontext(ucontext_t *>I<ucp>B<);>"
  68 msgstr ""
  69
  70 #. type: Plain text
  71 #: build/C/man3/getcontext.3:34
  72 msgid "B<int setcontext(const ucontext_t *>I<ucp>B<);>"
  73 msgstr ""
  74
  75 #. type: SH
  76 #: 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
  77 #, no-wrap
  78 msgid "DESCRIPTION"
  79 msgstr ""
  80
  81 #. type: Plain text
  82 #: build/C/man3/getcontext.3:49
  83 msgid ""
  84 "In a System V-like environment, one has the two types I<mcontext_t> and "
  85 "I<ucontext_t> defined in I<E<lt>ucontext.hE<gt>> and the four functions "
  86 "B<getcontext>(), B<setcontext>(), B<makecontext>(3)  and B<swapcontext>(3)  "
  87 "that allow user-level context switching between multiple threads of control "
  88 "within a process."
  89 msgstr ""
  90
  91 #. type: Plain text
  92 #: build/C/man3/getcontext.3:57
  93 msgid ""
  94 "The I<mcontext_t> type is machine-dependent and opaque.  The I<ucontext_t> "
  95 "type is a structure that has at least the following fields:"
  96 msgstr ""
  97
  98 #. type: Plain text
  99 #: build/C/man3/getcontext.3:67
 100 #, no-wrap
 101 msgid ""
 102 "typedef struct ucontext {\n"
 103 "    struct ucontext *uc_link;\n"
 104 "    sigset_t         uc_sigmask;\n"
 105 "    stack_t          uc_stack;\n"
 106 "    mcontext_t       uc_mcontext;\n"
 107 "    ...\n"
 108 "} ucontext_t;\n"
 109 msgstr ""
 110
 111 #. type: Plain text
 112 #: build/C/man3/getcontext.3:94
 113 msgid ""
 114 "with I<sigset_t> and I<stack_t> defined in I<E<lt>signal.hE<gt>>.  Here "
 115 "I<uc_link> points to the context that will be resumed when the current "
 116 "context terminates (in case the current context was created using "
 117 "B<makecontext>(3)), I<uc_sigmask> is the set of signals blocked in this "
 118 "context (see B<sigprocmask>(2)), I<uc_stack> is the stack used by this "
 119 "context (see B<sigaltstack>(2)), and I<uc_mcontext> is the machine-specific "
 120 "representation of the saved context, that includes the calling thread's "
 121 "machine registers."
 122 msgstr ""
 123
 124 #. type: Plain text
 125 #: build/C/man3/getcontext.3:101
 126 msgid ""
 127 "The function B<getcontext>()  initializes the structure pointed at by I<ucp> "
 128 "to the currently active context."
 129 msgstr ""
 130
 131 #. type: Plain text
 132 #: build/C/man3/getcontext.3:114
 133 msgid ""
 134 "The function B<setcontext>()  restores the user context pointed at by "
 135 "I<ucp>.  A successful call does not return.  The context should have been "
 136 "obtained by a call of B<getcontext>(), or B<makecontext>(3), or passed as "
 137 "third argument to a signal handler."
 138 msgstr ""
 139
 140 #. type: Plain text
 141 #: build/C/man3/getcontext.3:118
 142 msgid ""
 143 "If the context was obtained by a call of B<getcontext>(), program execution "
 144 "continues as if this call just returned."
 145 msgstr ""
 146
 147 #. type: Plain text
 148 #: build/C/man3/getcontext.3:135
 149 msgid ""
 150 "If the context was obtained by a call of B<makecontext>(3), program "
 151 "execution continues by a call to the function I<func> specified as the "
 152 "second argument of that call to B<makecontext>(3).  When the function "
 153 "I<func> returns, we continue with the I<uc_link> member of the structure "
 154 "I<ucp> specified as the first argument of that call to B<makecontext>(3).  "
 155 "When this member is NULL, the thread exits."
 156 msgstr ""
 157
 158 #. type: Plain text
 159 #: build/C/man3/getcontext.3:142
 160 msgid ""
 161 "If the context was obtained by a call to a signal handler, then old standard "
 162 "text says that \"program execution continues with the program instruction "
 163 "following the instruction interrupted by the signal\".  However, this "
 164 "sentence was removed in SUSv2, and the present verdict is \"the result is "
 165 "unspecified\"."
 166 msgstr ""
 167
 168 #. type: SH
 169 #: build/C/man3/getcontext.3:142 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:93 build/C/man3/pthread_attr_setschedparam.3:85 build/C/man3/pthread_attr_setschedpolicy.3:83 build/C/man3/pthread_attr_setscope.3:103 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:112 build/C/man3/pthread_cleanup_push.3:121 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
 170 #, no-wrap
 171 msgid "RETURN VALUE"
 172 msgstr ""
 173
 174 #. type: Plain text
 175 #: build/C/man3/getcontext.3:151
 176 msgid ""
 177 "When successful, B<getcontext>()  returns 0 and B<setcontext>()  does not "
 178 "return.  On error, both return -1 and set I<errno> appropriately."
 179 msgstr ""
 180
 181 #. type: SH
 182 #: build/C/man3/getcontext.3:151 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:96 build/C/man3/pthread_attr_setschedparam.3:88 build/C/man3/pthread_attr_setschedpolicy.3:86 build/C/man3/pthread_attr_setscope.3:106 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:117 build/C/man3/pthread_cleanup_push.3:123 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
 183 #, no-wrap
 184 msgid "ERRORS"
 185 msgstr ""
 186
 187 #. type: Plain text
 188 #: build/C/man3/getcontext.3:153
 189 msgid "None defined."
 190 msgstr ""
 191
 192 #. type: SH
 193 #: build/C/man3/getcontext.3:153 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:110 build/C/man3/pthread_attr_setschedparam.3:100 build/C/man3/pthread_attr_setschedpolicy.3:100 build/C/man3/pthread_attr_setscope.3:119 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:125 build/C/man3/pthread_cleanup_push.3:127 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
 194 #, no-wrap
 195 msgid "CONFORMING TO"
 196 msgstr ""
 197
 198 #. type: Plain text
 199 #: build/C/man3/getcontext.3:159
 200 msgid ""
 201 "SUSv2, POSIX.1-2001.  POSIX.1-2008 removes the specification of "
 202 "B<getcontext>(), citing portability issues, and recommending that "
 203 "applications be rewritten to use POSIX threads instead."
 204 msgstr ""
 205
 206 #. type: SH
 207 #: build/C/man3/getcontext.3:159 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:102 build/C/man3/pthread_attr_setscope.3:121 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:127 build/C/man3/pthread_cleanup_push.3:129 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
 208 #, no-wrap
 209 msgid "NOTES"
 210 msgstr ""
 211
 212 #. type: Plain text
 213 #: build/C/man3/getcontext.3:176
 214 msgid ""
 215 "The earliest incarnation of this mechanism was the "
 216 "B<setjmp>(3)/B<longjmp>(3)  mechanism.  Since that does not define the "
 217 "handling of the signal context, the next stage was the "
 218 "B<sigsetjmp>(3)/B<siglongjmp>(3)  pair.  The present mechanism gives much "
 219 "more control.  On the other hand, there is no easy way to detect whether a "
 220 "return from B<getcontext>()  is from the first call, or via a "
 221 "B<setcontext>()  call.  The user has to invent her own bookkeeping device, "
 222 "and a register variable won't do since registers are restored."
 223 msgstr ""
 224
 225 #. type: Plain text
 226 #: build/C/man3/getcontext.3:187
 227 msgid ""
 228 "When a signal occurs, the current user context is saved and a new context is "
 229 "created by the kernel for the signal handler.  Do not leave the handler "
 230 "using B<longjmp>(3): it is undefined what would happen with contexts.  Use "
 231 "B<siglongjmp>(3)  or B<setcontext>()  instead."
 232 msgstr ""
 233
 234 #. type: SH
 235 #: build/C/man3/getcontext.3:187 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:131 build/C/man3/pthread_attr_setschedparam.3:109 build/C/man3/pthread_attr_setschedpolicy.3:105 build/C/man3/pthread_attr_setscope.3:132 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:226 build/C/man3/pthread_cleanup_push.3:315 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
 236 #, no-wrap
 237 msgid "SEE ALSO"
 238 msgstr ""
 239
 240 #. type: Plain text
 241 #: build/C/man3/getcontext.3:194
 242 msgid ""
 243 "B<sigaction>(2), B<sigaltstack>(2), B<sigprocmask>(2), B<longjmp>(3), "
 244 "B<makecontext>(3), B<sigsetjmp>(3)"
 245 msgstr ""
 246
 247 #. type: SH
 248 #: build/C/man3/getcontext.3:194 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:143 build/C/man3/pthread_attr_setschedparam.3:121 build/C/man3/pthread_attr_setschedpolicy.3:116 build/C/man3/pthread_attr_setscope.3:142 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:238 build/C/man3/pthread_cleanup_push.3:321 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
 249 #, no-wrap
 250 msgid "COLOPHON"
 251 msgstr ""
 252
 253 #. type: Plain text
 254 #: build/C/man3/getcontext.3:201 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:150 build/C/man3/pthread_attr_setschedparam.3:128 build/C/man3/pthread_attr_setschedpolicy.3:123 build/C/man3/pthread_attr_setscope.3:149 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:245 build/C/man3/pthread_cleanup_push.3:328 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
 255 msgid ""
 256 "This page is part of release 3.54 of the Linux I<man-pages> project.  A "
 257 "description of the project, and information about reporting bugs, can be "
 258 "found at \\%http://www.kernel.org/doc/man-pages/."
 259 msgstr ""
 260
 261 #. type: TH
 262 #: build/C/man3/makecontext.3:28
 263 #, no-wrap
 264 msgid "MAKECONTEXT"
 265 msgstr ""
 266
 267 #. type: TH
 268 #: build/C/man3/makecontext.3:28
 269 #, no-wrap
 270 msgid "2013-02-12"
 271 msgstr ""
 272
 273 #. type: TH
 274 #: build/C/man3/makecontext.3:28
 275 #, no-wrap
 276 msgid "GNU"
 277 msgstr ""
 278
 279 #. type: Plain text
 280 #: build/C/man3/makecontext.3:31
 281 msgid "makecontext, swapcontext - manipulate user context"
 282 msgstr ""
 283
 284 #. type: Plain text
 285 #: build/C/man3/makecontext.3:36
 286 msgid ""
 287 "B<void makecontext(ucontext_t *>I<ucp>B<, void (*>I<func>B<)(),> B<int "
 288 ">I<argc>B<, ...);>"
 289 msgstr ""
 290
 291 #. type: Plain text
 292 #: build/C/man3/makecontext.3:38
 293 msgid "B<int swapcontext(ucontext_t *>I<oucp>B<, ucontext_t *>I<ucp>B<);>"
 294 msgstr ""
 295
 296 #. type: Plain text
 297 #: build/C/man3/makecontext.3:49
 298 msgid ""
 299 "In a System V-like environment, one has the type I<ucontext_t> defined in "
 300 "I<E<lt>ucontext.hE<gt>> and the four functions B<getcontext>(3), "
 301 "B<setcontext>(3), B<makecontext>()  and B<swapcontext>()  that allow "
 302 "user-level context switching between multiple threads of control within a "
 303 "process."
 304 msgstr ""
 305
 306 #. type: Plain text
 307 #: build/C/man3/makecontext.3:52
 308 msgid "For the type and the first two functions, see B<getcontext>(3)."
 309 msgstr ""
 310
 311 #. type: Plain text
 312 #: build/C/man3/makecontext.3:64
 313 msgid ""
 314 "The B<makecontext>()  function modifies the context pointed to by I<ucp> "
 315 "(which was obtained from a call to B<getcontext>(3)).  Before invoking "
 316 "B<makecontext>(), the caller must allocate a new stack for this context and "
 317 "assign its address to I<ucp-E<gt>uc_stack>, and define a successor context "
 318 "and assign its address to I<ucp-E<gt>uc_link>."
 319 msgstr ""
 320
 321 #. type: Plain text
 322 #: build/C/man3/makecontext.3:78
 323 msgid ""
 324 "When this context is later activated (using B<setcontext>(3)  or "
 325 "B<swapcontext>())  the function I<func> is called, and passed the series of "
 326 "integer (I<int>)  arguments that follow I<argc>; the caller must specify the "
 327 "number of these arguments in I<argc>.  When this function returns, the "
 328 "successor context is activated.  If the successor context pointer is NULL, "
 329 "the thread exits."
 330 msgstr ""
 331
 332 #. type: Plain text
 333 #: build/C/man3/makecontext.3:84
 334 msgid ""
 335 "The B<swapcontext>()  function saves the current context in the structure "
 336 "pointed to by I<oucp>, and then activates the context pointed to by I<ucp>."
 337 msgstr ""
 338
 339 #. type: Plain text
 340 #: build/C/man3/makecontext.3:96
 341 msgid ""
 342 "When successful, B<swapcontext>()  does not return.  (But we may return "
 343 "later, in case I<oucp> is activated, in which case it looks like "
 344 "B<swapcontext>()  returns 0.)  On error, B<swapcontext>()  returns -1 and "
 345 "sets I<errno> appropriately."
 346 msgstr ""
 347
 348 #. type: TP
 349 #: build/C/man3/makecontext.3:97 build/C/man3/pthread_attr_setaffinity_np.3:102 build/C/man3/pthread_getattr_np.3:77
 350 #, no-wrap
 351 msgid "B<ENOMEM>"
 352 msgstr ""
 353
 354 #. type: Plain text
 355 #: build/C/man3/makecontext.3:100
 356 msgid "Insufficient stack space left."
 357 msgstr ""
 358
 359 #. type: SH
 360 #: 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
 361 #, no-wrap
 362 msgid "VERSIONS"
 363 msgstr ""
 364
 365 #. type: Plain text
 366 #: build/C/man3/makecontext.3:105
 367 msgid ""
 368 "B<makecontext>()  and B<swapcontext>()  are provided in glibc since version "
 369 "2.1."
 370 msgstr ""
 371
 372 #. type: Plain text
 373 #: build/C/man3/makecontext.3:113
 374 msgid ""
 375 "SUSv2, POSIX.1-2001.  POSIX.1-2008 removes the specifications of "
 376 "B<makecontext>()  and B<swapcontext>(), citing portability issues, and "
 377 "recommending that applications be rewritten to use POSIX threads instead."
 378 msgstr ""
 379
 380 #. type: Plain text
 381 #: build/C/man3/makecontext.3:121
 382 msgid ""
 383 "The interpretation of I<ucp-E<gt>uc_stack> is just as in B<sigaltstack>(2), "
 384 "namely, this struct contains the start and length of a memory area to be "
 385 "used as the stack, regardless of the direction of growth of the stack.  "
 386 "Thus, it is not necessary for the user program to worry about this "
 387 "direction."
 388 msgstr ""
 389
 390 #. type: Plain text
 391 #: build/C/man3/makecontext.3:137
 392 msgid ""
 393 "On architectures where I<int> and pointer types are the same size (e.g., "
 394 "x86-32, where both types are 32 bits), you may be able to get away with "
 395 "passing pointers as arguments to B<makecontext>()  following I<argc>.  "
 396 "However, doing this is not guaranteed to be portable, is undefined according "
 397 "to the standards, and won't work on architectures where pointers are larger "
 398 "than I<int>s.  Nevertheless, starting with version 2.8, glibc makes some "
 399 "changes to B<makecontext>(), to permit this on some 64-bit architectures "
 400 "(e.g., x86-64)."
 401 msgstr ""
 402
 403 #. type: SH
 404 #: 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:128 build/C/man3/pthread_attr_setschedparam.3:106 build/C/man3/pthread_attr_setschedpolicy.3:102 build/C/man3/pthread_attr_setstack.3:153 build/C/man3/pthread_attr_setstacksize.3:108 build/C/man3/pthread_cancel.3:135 build/C/man3/pthread_cleanup_push.3:155 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
 405 #, no-wrap
 406 msgid "EXAMPLE"
 407 msgstr ""
 408
 409 #. type: Plain text
 410 #: build/C/man3/makecontext.3:145
 411 msgid ""
 412 "The example program below demonstrates the use of B<getcontext>(3), "
 413 "B<makecontext>(), and B<swapcontext>().  Running the program produces the "
 414 "following output:"
 415 msgstr ""
 416
 417 #. type: Plain text
 418 #: build/C/man3/makecontext.3:157
 419 #, no-wrap
 420 msgid ""
 421 "$B< ./a.out>\n"
 422 "main: swapcontext(&uctx_main, &uctx_func2)\n"
 423 "func2: started\n"
 424 "func2: swapcontext(&uctx_func2, &uctx_func1)\n"
 425 "func1: started\n"
 426 "func1: swapcontext(&uctx_func1, &uctx_func2)\n"
 427 "func2: returning\n"
 428 "func1: returning\n"
 429 "main: exiting\n"
 430 msgstr ""
 431
 432 #. type: SS
 433 #: build/C/man3/makecontext.3:159 build/C/man3/pthread_attr_init.3:148 build/C/man3/pthread_cancel.3:151 build/C/man3/pthread_cleanup_push.3:231 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
 434 #, no-wrap
 435 msgid "Program source"
 436 msgstr ""
 437
 438 #. type: Plain text
 439 #: build/C/man3/makecontext.3:165
 440 #, no-wrap
 441 msgid ""
 442 "#include E<lt>ucontext.hE<gt>\n"
 443 "#include E<lt>stdio.hE<gt>\n"
 444 "#include E<lt>stdlib.hE<gt>\n"
 445 msgstr ""
 446
 447 #. type: Plain text
 448 #: build/C/man3/makecontext.3:167
 449 #, no-wrap
 450 msgid "static ucontext_t uctx_main, uctx_func1, uctx_func2;\n"
 451 msgstr ""
 452
 453 #. type: Plain text
 454 #: build/C/man3/makecontext.3:170
 455 #, no-wrap
 456 msgid ""
 457 "#define handle_error(msg) \\e\n"
 458 "    do { perror(msg); exit(EXIT_FAILURE); } while (0)\n"
 459 msgstr ""
 460
 461 #. type: Plain text
 462 #: build/C/man3/makecontext.3:180
 463 #, no-wrap
 464 msgid ""
 465 "static void\n"
 466 "func1(void)\n"
 467 "{\n"
 468 "    printf(\"func1: started\\en\");\n"
 469 "    printf(\"func1: swapcontext(&uctx_func1, &uctx_func2)\\en\");\n"
 470 "    if (swapcontext(&uctx_func1, &uctx_func2) == -1)\n"
 471 "        handle_error(\"swapcontext\");\n"
 472 "    printf(\"func1: returning\\en\");\n"
 473 "}\n"
 474 msgstr ""
 475
 476 #. type: Plain text
 477 #: build/C/man3/makecontext.3:190
 478 #, no-wrap
 479 msgid ""
 480 "static void\n"
 481 "func2(void)\n"
 482 "{\n"
 483 "    printf(\"func2: started\\en\");\n"
 484 "    printf(\"func2: swapcontext(&uctx_func2, &uctx_func1)\\en\");\n"
 485 "    if (swapcontext(&uctx_func2, &uctx_func1) == -1)\n"
 486 "        handle_error(\"swapcontext\");\n"
 487 "    printf(\"func2: returning\\en\");\n"
 488 "}\n"
 489 msgstr ""
 490
 491 #. type: Plain text
 492 #: build/C/man3/makecontext.3:196
 493 #, no-wrap
 494 msgid ""
 495 "int\n"
 496 "main(int argc, char *argv[])\n"
 497 "{\n"
 498 "    char func1_stack[16384];\n"
 499 "    char func2_stack[16384];\n"
 500 msgstr ""
 501
 502 #. type: Plain text
 503 #: build/C/man3/makecontext.3:203
 504 #, no-wrap
 505 msgid ""
 506 "    if (getcontext(&uctx_func1) == -1)\n"
 507 "        handle_error(\"getcontext\");\n"
 508 "    uctx_func1.uc_stack.ss_sp = func1_stack;\n"
 509 "    uctx_func1.uc_stack.ss_size = sizeof(func1_stack);\n"
 510 "    uctx_func1.uc_link = &uctx_main;\n"
 511 "    makecontext(&uctx_func1, func1, 0);\n"
 512 msgstr ""
 513
 514 #. type: Plain text
 515 #: build/C/man3/makecontext.3:211
 516 #, no-wrap
 517 msgid ""
 518 "    if (getcontext(&uctx_func2) == -1)\n"
 519 "        handle_error(\"getcontext\");\n"
 520 "    uctx_func2.uc_stack.ss_sp = func2_stack;\n"
 521 "    uctx_func2.uc_stack.ss_size = sizeof(func2_stack);\n"
 522 "    /* Successor context is f1(), unless argc E<gt> 1 */\n"
 523 "    uctx_func2.uc_link = (argc E<gt> 1) ? NULL : &uctx_func1;\n"
 524 "    makecontext(&uctx_func2, func2, 0);\n"
 525 msgstr ""
 526
 527 #. type: Plain text
 528 #: build/C/man3/makecontext.3:215
 529 #, no-wrap
 530 msgid ""
 531 "    printf(\"main: swapcontext(&uctx_main, &uctx_func2)\\en\");\n"
 532 "    if (swapcontext(&uctx_main, &uctx_func2) == -1)\n"
 533 "        handle_error(\"swapcontext\");\n"
 534 msgstr ""
 535
 536 #. type: Plain text
 537 #: build/C/man3/makecontext.3:219
 538 #, no-wrap
 539 msgid ""
 540 "    printf(\"main: exiting\\en\");\n"
 541 "    exit(EXIT_SUCCESS);\n"
 542 "}\n"
 543 msgstr ""
 544
 545 #. type: Plain text
 546 #: build/C/man3/makecontext.3:226
 547 msgid ""
 548 "B<sigaction>(2), B<sigaltstack>(2), B<sigprocmask>(2), B<getcontext>(3), "
 549 "B<sigsetjmp>(3)"
 550 msgstr ""
 551
 552 #. type: TH
 553 #: build/C/man3/pthread_attr_init.3:26
 554 #, no-wrap
 555 msgid "PTHREAD_ATTR_INIT"
 556 msgstr ""
 557
 558 #. type: TH
 559 #: build/C/man3/pthread_attr_init.3:26
 560 #, no-wrap
 561 msgid "2008-11-11"
 562 msgstr ""
 563
 564 #. type: Plain text
 565 #: build/C/man3/pthread_attr_init.3:30
 566 msgid ""
 567 "pthread_attr_init, pthread_attr_destroy - initialize and destroy thread "
 568 "attributes object"
 569 msgstr ""
 570
 571 #. type: Plain text
 572 #: 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
 573 #, no-wrap
 574 msgid "B<#include E<lt>pthread.hE<gt>>\n"
 575 msgstr ""
 576
 577 #. type: Plain text
 578 #: build/C/man3/pthread_attr_init.3:36
 579 #, no-wrap
 580 msgid ""
 581 "B<int pthread_attr_init(pthread_attr_t *>I<attr>B<);>\n"
 582 "B<int pthread_attr_destroy(pthread_attr_t *>I<attr>B<);>\n"
 583 msgstr ""
 584
 585 #. type: Plain text
 586 #: 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
 587 #, no-wrap
 588 msgid "Compile and link with I<-pthread>.\n"
 589 msgstr ""
 590
 591 #. type: Plain text
 592 #: build/C/man3/pthread_attr_init.3:50
 593 msgid ""
 594 "The B<pthread_attr_init>()  function initializes the thread attributes "
 595 "object pointed to by I<attr> with default attribute values.  After this "
 596 "call, individual attributes of the object can be set using various related "
 597 "functions (listed under SEE ALSO), and then the object can be used in one or "
 598 "more B<pthread_create>(3)  calls that create threads."
 599 msgstr ""
 600
 601 #. type: Plain text
 602 #: build/C/man3/pthread_attr_init.3:55
 603 msgid ""
 604 "Calling B<pthread_attr_init>()  on a thread attributes object that has "
 605 "already been initialized results in undefined behavior."
 606 msgstr ""
 607
 608 #. type: Plain text
 609 #: build/C/man3/pthread_attr_init.3:62
 610 msgid ""
 611 "When a thread attributes object is no longer required, it should be "
 612 "destroyed using the B<pthread_attr_destroy>()  function.  Destroying a "
 613 "thread attributes object has no effect on threads that were created using "
 614 "that object."
 615 msgstr ""
 616
 617 #. type: Plain text
 618 #: build/C/man3/pthread_attr_init.3:68
 619 msgid ""
 620 "Once a thread attributes object has been destroyed, it can be reinitialized "
 621 "using B<pthread_attr_init>().  Any other use of a destroyed thread "
 622 "attributes object has undefined results."
 623 msgstr ""
 624
 625 #. type: Plain text
 626 #: 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:96 build/C/man3/pthread_attr_setschedparam.3:88 build/C/man3/pthread_attr_setschedpolicy.3:86 build/C/man3/pthread_attr_setscope.3:106 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
 627 msgid ""
 628 "On success, these functions return 0; on error, they return a nonzero error "
 629 "number."
 630 msgstr ""
 631
 632 #. type: Plain text
 633 #: build/C/man3/pthread_attr_init.3:79
 634 msgid ""
 635 "POSIX.1-2001 documents an B<ENOMEM> error for B<pthread_attr_init>(); on "
 636 "Linux these functions always succeed (but portable and future-proof "
 637 "applications should nevertheless handle a possible error return)."
 638 msgstr ""
 639
 640 #. type: Plain text
 641 #: 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:112 build/C/man3/pthread_attr_setschedparam.3:102 build/C/man3/pthread_attr_setschedpolicy.3:102 build/C/man3/pthread_attr_setscope.3:121 build/C/man3/pthread_attr_setstack.3:114 build/C/man3/pthread_attr_setstacksize.3:85 build/C/man3/pthread_cancel.3:127 build/C/man3/pthread_cleanup_push.3:129 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
 642 msgid "POSIX.1-2001."
 643 msgstr ""
 644
 645 #. type: Plain text
 646 #: build/C/man3/pthread_attr_init.3:87
 647 msgid ""
 648 "The I<pthread_attr_t> type should be treated as opaque: any access to the "
 649 "object other than via pthreads functions is nonportable and produces "
 650 "undefined results."
 651 msgstr ""
 652
 653 #. type: Plain text
 654 #: build/C/man3/pthread_attr_init.3:96
 655 msgid ""
 656 "The program below optionally makes use of B<pthread_attr_init>()  and "
 657 "various related functions to initialize a thread attributes object that is "
 658 "used to create a single thread.  Once created, the thread uses the "
 659 "B<pthread_getattr_np>(3)  function (a nonstandard GNU extension) to retrieve "
 660 "the thread's attributes, and then displays those attributes."
 661 msgstr ""
 662
 663 #. type: Plain text
 664 #: build/C/man3/pthread_attr_init.3:105
 665 msgid ""
 666 "If the program is run with no command-line argument, then it passes NULL as "
 667 "the I<attr> argument of B<pthread_create>(3), so that the thread is created "
 668 "with default attributes.  Running the program on Linux/x86-32 with the NPTL "
 669 "threading implementation, we see the following:"
 670 msgstr ""
 671
 672 #.  Results from glibc 2.8, SUSE 11.0; Oct 2008
 673 #. type: Plain text
 674 #: build/C/man3/pthread_attr_init.3:121
 675 #, no-wrap
 676 msgid ""
 677 "$B< ulimit -s>       # No stack imit ==E<gt> default stack size is 2MB\n"
 678 "unlimited\n"
 679 "$B< ./a.out>\n"
 680 "Thread attributes:\n"
 681 "        Detach state        = PTHREAD_CREATE_JOINABLE\n"
 682 "        Scope               = PTHREAD_SCOPE_SYSTEM\n"
 683 "        Inherit scheduler   = PTHREAD_INHERIT_SCHED\n"
 684 "        Scheduling policy   = SCHED_OTHER\n"
 685 "        Scheduling priority = 0\n"
 686 "        Guard size          = 4096 bytes\n"
 687 "        Stack address       = 0x40196000\n"
 688 "        Stack size          = 0x201000 bytes\n"
 689 msgstr ""
 690
 691 #. type: Plain text
 692 #: build/C/man3/pthread_attr_init.3:131
 693 msgid ""
 694 "When we supply a stack size as a command-line argument, the program "
 695 "initializes a thread attributes object, sets various attributes in that "
 696 "object, and passes a pointer to the object in the call to "
 697 "B<pthread_create>(3).  Running the program on Linux/x86-32 with the NPTL "
 698 "threading implementation, we see the following:"
 699 msgstr ""
 700
 701 #.  Results from glibc 2.8, SUSE 11.0; Oct 2008
 702 #. type: Plain text
 703 #: build/C/man3/pthread_attr_init.3:146
 704 #, no-wrap
 705 msgid ""
 706 "$B< ./a.out 0x3000000>\n"
 707 "posix_memalign() allocated at 0x40197000\n"
 708 "Thread attributes:\n"
 709 "        Detach state        = PTHREAD_CREATE_DETACHED\n"
 710 "        Scope               = PTHREAD_SCOPE_SYSTEM\n"
 711 "        Inherit scheduler   = PTHREAD_EXPLICIT_SCHED\n"
 712 "        Scheduling policy   = SCHED_OTHER\n"
 713 "        Scheduling priority = 0\n"
 714 "        Guard size          = 0 bytes\n"
 715 "        Stack address       = 0x40197000\n"
 716 "        Stack size          = 0x3000000 bytes\n"
 717 msgstr ""
 718
 719 #. type: Plain text
 720 #: build/C/man3/pthread_attr_init.3:157 build/C/man3/pthread_getattr_np.3:188
 721 #, no-wrap
 722 msgid ""
 723 "#define _GNU_SOURCE     /* To get pthread_getattr_np() declaration */\n"
 724 "#include E<lt>pthread.hE<gt>\n"
 725 "#include E<lt>stdio.hE<gt>\n"
 726 "#include E<lt>stdlib.hE<gt>\n"
 727 "#include E<lt>unistd.hE<gt>\n"
 728 "#include E<lt>errno.hE<gt>\n"
 729 msgstr ""
 730
 731 #. type: Plain text
 732 #: build/C/man3/pthread_attr_init.3:160 build/C/man3/pthread_cancel.3:162 build/C/man3/pthread_cleanup_push.3:243 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
 733 #, no-wrap
 734 msgid ""
 735 "#define handle_error_en(en, msg) \\e\n"
 736 "        do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0)\n"
 737 msgstr ""
 738
 739 #. type: Plain text
 740 #: build/C/man3/pthread_attr_init.3:168
 741 #, no-wrap
 742 msgid ""
 743 "static void\n"
 744 "display_pthread_attr(pthread_attr_t *attr, char *prefix)\n"
 745 "{\n"
 746 "    int s, i;\n"
 747 "    size_t v;\n"
 748 "    void *stkaddr;\n"
 749 "    struct sched_param sp;\n"
 750 msgstr ""
 751
 752 #. type: Plain text
 753 #: build/C/man3/pthread_attr_init.3:176
 754 #, no-wrap
 755 msgid ""
 756 "    s = pthread_attr_getdetachstate(attr, &i);\n"
 757 "    if (s != 0)\n"
 758 "        handle_error_en(s, \"pthread_attr_getdetachstate\");\n"
 759 "    printf(\"%sDetach state        = %s\\en\", prefix,\n"
 760 "            (i == PTHREAD_CREATE_DETACHED) ? \"PTHREAD_CREATE_DETACHED\" :\n"
 761 "            (i == PTHREAD_CREATE_JOINABLE) ? \"PTHREAD_CREATE_JOINABLE\" :\n"
 762 "            \"???\");\n"
 763 msgstr ""
 764
 765 #. type: Plain text
 766 #: build/C/man3/pthread_attr_init.3:184
 767 #, no-wrap
 768 msgid ""
 769 "    s = pthread_attr_getscope(attr, &i);\n"
 770 "    if (s != 0)\n"
 771 "        handle_error_en(s, \"pthread_attr_getscope\");\n"
 772 "    printf(\"%sScope               = %s\\en\", prefix,\n"
 773 "            (i == PTHREAD_SCOPE_SYSTEM)  ? \"PTHREAD_SCOPE_SYSTEM\" :\n"
 774 "            (i == PTHREAD_SCOPE_PROCESS) ? \"PTHREAD_SCOPE_PROCESS\" :\n"
 775 "            \"???\");\n"
 776 msgstr ""
 777
 778 #. type: Plain text
 779 #: build/C/man3/pthread_attr_init.3:192
 780 #, no-wrap
 781 msgid ""
 782 "    s = pthread_attr_getinheritsched(attr, &i);\n"
 783 "    if (s != 0)\n"
 784 "        handle_error_en(s, \"pthread_attr_getinheritsched\");\n"
 785 "    printf(\"%sInherit scheduler   = %s\\en\", prefix,\n"
 786 "            (i == PTHREAD_INHERIT_SCHED)  ? \"PTHREAD_INHERIT_SCHED\" :\n"
 787 "            (i == PTHREAD_EXPLICIT_SCHED) ? \"PTHREAD_EXPLICIT_SCHED\" :\n"
 788 "            \"???\");\n"
 789 msgstr ""
 790
 791 #. type: Plain text
 792 #: build/C/man3/pthread_attr_init.3:201
 793 #, no-wrap
 794 msgid ""
 795 "    s = pthread_attr_getschedpolicy(attr, &i);\n"
 796 "    if (s != 0)\n"
 797 "        handle_error_en(s, \"pthread_attr_getschedpolicy\");\n"
 798 "    printf(\"%sScheduling policy   = %s\\en\", prefix,\n"
 799 "            (i == SCHED_OTHER) ? \"SCHED_OTHER\" :\n"
 800 "            (i == SCHED_FIFO)  ? \"SCHED_FIFO\" :\n"
 801 "            (i == SCHED_RR)    ? \"SCHED_RR\" :\n"
 802 "            \"???\");\n"
 803 msgstr ""
 804
 805 #. type: Plain text
 806 #: build/C/man3/pthread_attr_init.3:206
 807 #, no-wrap
 808 msgid ""
 809 "    s = pthread_attr_getschedparam(attr, &sp);\n"
 810 "    if (s != 0)\n"
 811 "        handle_error_en(s, \"pthread_attr_getschedparam\");\n"
 812 "    printf(\"%sScheduling priority = %d\\en\", prefix, sp.sched_priority);\n"
 813 msgstr ""
 814
 815 #. type: Plain text
 816 #: build/C/man3/pthread_attr_init.3:211
 817 #, no-wrap
 818 msgid ""
 819 "    s = pthread_attr_getguardsize(attr, &v);\n"
 820 "    if (s != 0)\n"
 821 "        handle_error_en(s, \"pthread_attr_getguardsize\");\n"
 822 "    printf(\"%sGuard size          = %d bytes\\en\", prefix, v);\n"
 823 msgstr ""
 824
 825 #. type: Plain text
 826 #: build/C/man3/pthread_attr_init.3:218
 827 #, no-wrap
 828 msgid ""
 829 "    s = pthread_attr_getstack(attr, &stkaddr, &v);\n"
 830 "    if (s != 0)\n"
 831 "        handle_error_en(s, \"pthread_attr_getstack\");\n"
 832 "    printf(\"%sStack address       = %p\\en\", prefix, stkaddr);\n"
 833 "    printf(\"%sStack size          = 0x%x bytes\\en\", prefix, v);\n"
 834 "}\n"
 835 msgstr ""
 836
 837 #. type: Plain text
 838 #: build/C/man3/pthread_attr_init.3:224
 839 #, no-wrap
 840 msgid ""
 841 "static void *\n"
 842 "thread_start(void *arg)\n"
 843 "{\n"
 844 "    int s;\n"
 845 "    pthread_attr_t gattr;\n"
 846 msgstr ""
 847
 848 #. type: Plain text
 849 #: build/C/man3/pthread_attr_init.3:228
 850 #, no-wrap
 851 msgid ""
 852 "    /* pthread_getattr_np() is a non-standard GNU extension that\n"
 853 "       retrieves the attributes of the thread specified in its\n"
 854 "       first argument */\n"
 855 msgstr ""
 856
 857 #. type: Plain text
 858 #: build/C/man3/pthread_attr_init.3:232
 859 #, no-wrap
 860 msgid ""
 861 "    s = pthread_getattr_np(pthread_self(), &gattr);\n"
 862 "    if (s != 0)\n"
 863 "        handle_error_en(s, \"pthread_getattr_np\");\n"
 864 msgstr ""
 865
 866 #. type: Plain text
 867 #: build/C/man3/pthread_attr_init.3:235
 868 #, no-wrap
 869 msgid ""
 870 "    printf(\"Thread attributes:\\en\");\n"
 871 "    display_pthread_attr(&gattr, \"\\et\");\n"
 872 msgstr ""
 873
 874 #. type: Plain text
 875 #: build/C/man3/pthread_attr_init.3:238 build/C/man3/pthread_getattr_np.3:240
 876 #, no-wrap
 877 msgid ""
 878 "    exit(EXIT_SUCCESS);         /* Terminate all threads */\n"
 879 "}\n"
 880 msgstr ""
 881
 882 #. type: Plain text
 883 #: build/C/man3/pthread_attr_init.3:246
 884 #, no-wrap
 885 msgid ""
 886 "int\n"
 887 "main(int argc, char *argv[])\n"
 888 "{\n"
 889 "    pthread_t thr;\n"
 890 "    pthread_attr_t attr;\n"
 891 "    pthread_attr_t *attrp;      /* NULL or &attr */\n"
 892 "    int s;\n"
 893 msgstr ""
 894
 895 #. type: Plain text
 896 #: build/C/man3/pthread_attr_init.3:248 build/C/man3/pthread_setschedparam.3:355
 897 #, no-wrap
 898 msgid "    attrp = NULL;\n"
 899 msgstr ""
 900
 901 #. type: Plain text
 902 #: build/C/man3/pthread_attr_init.3:252
 903 #, no-wrap
 904 msgid ""
 905 "    /* If a command-line argument was supplied, use it to set the\n"
 906 "       stack-size attribute and set a few other thread attributes,\n"
 907 "       and set attrp pointing to thread attributes object */\n"
 908 msgstr ""
 909
 910 #. type: Plain text
 911 #: build/C/man3/pthread_attr_init.3:256
 912 #, no-wrap
 913 msgid ""
 914 "    if (argc E<gt> 1) {\n"
 915 "        int stack_size;\n"
 916 "        void *sp;\n"
 917 msgstr ""
 918
 919 #. type: Plain text
 920 #: build/C/man3/pthread_attr_init.3:258
 921 #, no-wrap
 922 msgid "        attrp = &attr;\n"
 923 msgstr ""
 924
 925 #. type: Plain text
 926 #: build/C/man3/pthread_attr_init.3:262
 927 #, no-wrap
 928 msgid ""
 929 "        s = pthread_attr_init(&attr);\n"
 930 "        if (s != 0)\n"
 931 "            handle_error_en(s, \"pthread_attr_init\");\n"
 932 msgstr ""
 933
 934 #. type: Plain text
 935 #: build/C/man3/pthread_attr_init.3:266
 936 #, no-wrap
 937 msgid ""
 938 "        s = pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);\n"
 939 "        if (s != 0)\n"
 940 "            handle_error_en(s, \"pthread_attr_setdetachstate\");\n"
 941 msgstr ""
 942
 943 #. type: Plain text
 944 #: build/C/man3/pthread_attr_init.3:270
 945 #, no-wrap
 946 msgid ""
 947 "        s = pthread_attr_setinheritsched(&attr, PTHREAD_EXPLICIT_SCHED);\n"
 948 "        if (s != 0)\n"
 949 "            handle_error_en(s, \"pthread_attr_setinheritsched\");\n"
 950 msgstr ""
 951
 952 #. type: Plain text
 953 #: build/C/man3/pthread_attr_init.3:272
 954 #, no-wrap
 955 msgid "        stack_size = strtoul(argv[1], NULL, 0);\n"
 956 msgstr ""
 957
 958 #. type: Plain text
 959 #: build/C/man3/pthread_attr_init.3:276
 960 #, no-wrap
 961 msgid ""
 962 "        s = posix_memalign(&sp, sysconf(_SC_PAGESIZE), stack_size);\n"
 963 "        if (s != 0)\n"
 964 "            handle_error_en(s, \"posix_memalign\");\n"
 965 msgstr ""
 966
 967 #. type: Plain text
 968 #: build/C/man3/pthread_attr_init.3:278
 969 #, no-wrap
 970 msgid "        printf(\"posix_memalign() allocated at %p\\en\", sp);\n"
 971 msgstr ""
 972
 973 #. type: Plain text
 974 #: build/C/man3/pthread_attr_init.3:283
 975 #, no-wrap
 976 msgid ""
 977 "        s = pthread_attr_setstack(&attr, sp, stack_size);\n"
 978 "        if (s != 0)\n"
 979 "            handle_error_en(s, \"pthread_attr_setstack\");\n"
 980 "    }\n"
 981 msgstr ""
 982
 983 #. type: Plain text
 984 #: build/C/man3/pthread_attr_init.3:287 build/C/man3/pthread_getattr_np.3:335
 985 #, no-wrap
 986 msgid ""
 987 "    s = pthread_create(&thr, attrp, &thread_start, NULL);\n"
 988 "    if (s != 0)\n"
 989 "        handle_error_en(s, \"pthread_create\");\n"
 990 msgstr ""
 991
 992 #. type: Plain text
 993 #: build/C/man3/pthread_attr_init.3:293 build/C/man3/pthread_getattr_np.3:341
 994 #, no-wrap
 995 msgid ""
 996 "    if (attrp != NULL) {\n"
 997 "        s = pthread_attr_destroy(attrp);\n"
 998 "        if (s != 0)\n"
 999 "            handle_error_en(s, \"pthread_attr_destroy\");\n"
1000 "    }\n"
1001 msgstr ""
1002
1003 #. type: Plain text
1004 #: build/C/man3/pthread_attr_init.3:296 build/C/man3/pthread_getattr_np.3:344
1005 #, no-wrap
1006 msgid ""
1007 "    pause();    /* Terminates when other thread calls exit() */\n"
1008 "}\n"
1009 msgstr ""
1010
1011 #. type: Plain text
1012 #: build/C/man3/pthread_attr_init.3:313
1013 msgid ""
1014 "B<pthread_attr_setaffinity_np>(3), B<pthread_attr_setdetachstate>(3), "
1015 "B<pthread_attr_setguardsize>(3), B<pthread_attr_setinheritsched>(3), "
1016 "B<pthread_attr_setschedparam>(3), B<pthread_attr_setschedpolicy>(3), "
1017 "B<pthread_attr_setscope>(3), B<pthread_attr_setstack>(3), "
1018 "B<pthread_attr_setstackaddr>(3), B<pthread_attr_setstacksize>(3), "
1019 "B<pthread_create>(3), B<pthread_getattr_np>(3), B<pthreads>(7)"
1020 msgstr ""
1021
1022 #. type: TH
1023 #: build/C/man3/pthread_attr_setaffinity_np.3:26
1024 #, no-wrap
1025 msgid "PTHREAD_ATTR_SETAFFINITY_NP"
1026 msgstr ""
1027
1028 #. type: TH
1029 #: 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
1030 #, no-wrap
1031 msgid "2010-09-10"
1032 msgstr ""
1033
1034 #. type: Plain text
1035 #: build/C/man3/pthread_attr_setaffinity_np.3:30
1036 msgid ""
1037 "pthread_attr_setaffinity_np, pthread_attr_getaffinity_np - set/get CPU "
1038 "affinity attribute in thread attributes object"
1039 msgstr ""
1040
1041 #. type: Plain text
1042 #: 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
1043 #, no-wrap
1044 msgid ""
1045 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
1046 "B<#include E<lt>pthread.hE<gt>>\n"
1047 msgstr ""
1048
1049 #. type: Plain text
1050 #: build/C/man3/pthread_attr_setaffinity_np.3:39
1051 #, no-wrap
1052 msgid ""
1053 "B<int pthread_attr_setaffinity_np(pthread_attr_t *>I<attr>B<,>\n"
1054 "B<                   size_t >I<cpusetsize>B<, const cpu_set_t "
1055 "*>I<cpuset>B<);>\n"
1056 "B<int pthread_attr_getaffinity_np(pthread_attr_t *>I<attr>B<,>\n"
1057 "B<                   size_t >I<cpusetsize>B<, cpu_set_t *>I<cpuset>B<);>\n"
1058 msgstr ""
1059
1060 #. type: Plain text
1061 #: build/C/man3/pthread_attr_setaffinity_np.3:54
1062 msgid ""
1063 "The B<pthread_attr_setaffinity_np>()  function sets the CPU affinity mask "
1064 "attribute of the thread attributes object referred to by I<attr> to the "
1065 "value specified in I<cpuset>.  This attribute determines the CPU affinity "
1066 "mask of a thread created using the thread attributes object I<attr>."
1067 msgstr ""
1068
1069 #. type: Plain text
1070 #: build/C/man3/pthread_attr_setaffinity_np.3:63
1071 msgid ""
1072 "The B<pthread_attr_getaffinity_np>()  function returns the CPU affinity mask "
1073 "attribute of the thread attributes object referred to by I<attr> in the "
1074 "buffer pointed to by I<cpuset>."
1075 msgstr ""
1076
1077 #. type: Plain text
1078 #: build/C/man3/pthread_attr_setaffinity_np.3:70
1079 msgid ""
1080 "The argument I<cpusetsize> is the length (in bytes) of the buffer pointed to "
1081 "by I<cpuset>.  Typically, this argument would be specified as "
1082 "I<sizeof(cpu_set_t)>."
1083 msgstr ""
1084
1085 #. type: Plain text
1086 #: build/C/man3/pthread_attr_setaffinity_np.3:76 build/C/man3/pthread_setaffinity_np.3:67
1087 msgid ""
1088 "For more details on CPU affinity masks, see B<sched_setaffinity>(2).  For a "
1089 "description of a set of macros that can be used to manipulate and inspect "
1090 "CPU sets, see B<CPU_SET>(3)."
1091 msgstr ""
1092
1093 #. type: TP
1094 #: 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:99 build/C/man3/pthread_attr_setschedpolicy.3:89 build/C/man3/pthread_attr_setscope.3:109 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
1095 #, no-wrap
1096 msgid "B<EINVAL>"
1097 msgstr ""
1098
1099 #.  cpumask_t
1100 #.  The raw sched_getaffinity() system call returns the size (in bytes)
1101 #.  of the cpumask_t type.
1102 #. type: Plain text
1103 #: build/C/man3/pthread_attr_setaffinity_np.3:92
1104 msgid ""
1105 "(B<pthread_attr_setaffinity_np>())  I<cpuset> specified a CPU that was "
1106 "outside the set supported by the kernel.  (The kernel configuration option "
1107 "B<CONFIG_NR_CPUS> defines the range of the set supported by the kernel data "
1108 "type used to represent CPU sets.)"
1109 msgstr ""
1110
1111 #. type: Plain text
1112 #: build/C/man3/pthread_attr_setaffinity_np.3:102
1113 msgid ""
1114 "(B<pthread_attr_getaffinity_np>())  A CPU in the affinity mask of the thread "
1115 "attributes object referred to by I<attr> lies outside the range specified by "
1116 "I<cpusetsize> (i.e., I<cpuset>/I<cpusetsize> is too small)."
1117 msgstr ""
1118
1119 #. type: Plain text
1120 #: build/C/man3/pthread_attr_setaffinity_np.3:106
1121 msgid "(B<pthread_attr_setaffinity_np>())  Could not allocate memory."
1122 msgstr ""
1123
1124 #. type: Plain text
1125 #: build/C/man3/pthread_attr_setaffinity_np.3:108 build/C/man3/pthread_setaffinity_np.3:121
1126 msgid "These functions are provided by glibc since version 2.3.4."
1127 msgstr ""
1128
1129 #. type: Plain text
1130 #: 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
1131 msgid ""
1132 "These functions are nonstandard GNU extensions; hence the suffix \"_np\" "
1133 "(nonportable) in the names."
1134 msgstr ""
1135
1136 #. type: Plain text
1137 #: build/C/man3/pthread_attr_setaffinity_np.3:118 build/C/man3/pthread_setaffinity_np.3:150
1138 msgid ""
1139 "In glibc 2.3.3 only, versions of these functions were provided that did not "
1140 "have a I<cpusetsize> argument.  Instead the CPU set size given to the "
1141 "underlying system calls was always I<sizeof(cpu_set_t)>."
1142 msgstr ""
1143
1144 #. type: Plain text
1145 #: build/C/man3/pthread_attr_setaffinity_np.3:124
1146 msgid ""
1147 "B<sched_setaffinity>(2), B<pthread_attr_init>(3), "
1148 "B<pthread_setaffinity_np>(3), B<cpuset>(7), B<pthreads>(7)"
1149 msgstr ""
1150
1151 #. type: TH
1152 #: build/C/man3/pthread_attr_setdetachstate.3:26
1153 #, no-wrap
1154 msgid "PTHREAD_ATTR_SETDETACHSTATE"
1155 msgstr ""
1156
1157 #. type: TH
1158 #: build/C/man3/pthread_attr_setdetachstate.3:26
1159 #, no-wrap
1160 msgid "2010-02-03"
1161 msgstr ""
1162
1163 #. type: Plain text
1164 #: build/C/man3/pthread_attr_setdetachstate.3:30
1165 msgid ""
1166 "pthread_attr_setdetachstate, pthread_attr_getdetachstate - set/get detach "
1167 "state attribute in thread attributes object"
1168 msgstr ""
1169
1170 #. type: Plain text
1171 #: build/C/man3/pthread_attr_setdetachstate.3:38
1172 #, no-wrap
1173 msgid ""
1174 "B<int pthread_attr_setdetachstate(pthread_attr_t *>I<attr>B<, int "
1175 ">I<detachstate>B<);>\n"
1176 "B<int pthread_attr_getdetachstate(pthread_attr_t *>I<attr>B<, int "
1177 "*>I<detachstate>B<);>\n"
1178 msgstr ""
1179
1180 #. type: Plain text
1181 #: build/C/man3/pthread_attr_setdetachstate.3:53
1182 msgid ""
1183 "The B<pthread_attr_setdetachstate>()  function sets the detach state "
1184 "attribute of the thread attributes object referred to by I<attr> to the "
1185 "value specified in I<detachstate>.  The detach state attribute determines "
1186 "whether a thread created using the thread attributes object I<attr> will be "
1187 "created in a joinable or a detached state."
1188 msgstr ""
1189
1190 #. type: Plain text
1191 #: build/C/man3/pthread_attr_setdetachstate.3:56
1192 msgid "The following values may be specified in I<detachstate>:"
1193 msgstr ""
1194
1195 #. type: TP
1196 #: build/C/man3/pthread_attr_setdetachstate.3:56
1197 #, no-wrap
1198 msgid "B<PTHREAD_CREATE_DETACHED>"
1199 msgstr ""
1200
1201 #. type: Plain text
1202 #: build/C/man3/pthread_attr_setdetachstate.3:61
1203 msgid "Threads that are created using I<attr> will be created in a detached state."
1204 msgstr ""
1205
1206 #. type: TP
1207 #: build/C/man3/pthread_attr_setdetachstate.3:61
1208 #, no-wrap
1209 msgid "B<PTHREAD_CREATE_JOINABLE>"
1210 msgstr ""
1211
1212 #. type: Plain text
1213 #: build/C/man3/pthread_attr_setdetachstate.3:66
1214 msgid "Threads that are created using I<attr> will be created in a joinable state."
1215 msgstr ""
1216
1217 #. type: Plain text
1218 #: build/C/man3/pthread_attr_setdetachstate.3:70
1219 msgid ""
1220 "The default setting of the detach state attribute in a newly initialized "
1221 "thread attributes object is B<PTHREAD_CREATE_JOINABLE>."
1222 msgstr ""
1223
1224 #. type: Plain text
1225 #: build/C/man3/pthread_attr_setdetachstate.3:77
1226 msgid ""
1227 "The B<pthread_attr_getdetachstate>()  returns the detach state attribute of "
1228 "the thread attributes object I<attr> in the buffer pointed to by "
1229 "I<detachstate>."
1230 msgstr ""
1231
1232 #. type: Plain text
1233 #: build/C/man3/pthread_attr_setdetachstate.3:83
1234 msgid "B<pthread_attr_setdetachstate>()  can fail with the following error:"
1235 msgstr ""
1236
1237 #. type: Plain text
1238 #: build/C/man3/pthread_attr_setdetachstate.3:87
1239 msgid "An invalid value was specified in I<detachstate>."
1240 msgstr ""
1241
1242 #. type: Plain text
1243 #: build/C/man3/pthread_attr_setdetachstate.3:93
1244 msgid "See B<pthread_create>(3)  for more details on detached and joinable threads."
1245 msgstr ""
1246
1247 #. type: Plain text
1248 #: build/C/man3/pthread_attr_setdetachstate.3:101
1249 msgid ""
1250 "A thread that is created in a joinable state should eventually either be "
1251 "joined using B<pthread_join>(3)  or detached using B<pthread_detach>(3); see "
1252 "B<pthread_create>(3)."
1253 msgstr ""
1254
1255 #. type: Plain text
1256 #: build/C/man3/pthread_attr_setdetachstate.3:108
1257 msgid ""
1258 "It is an error to specify the thread ID of a thread that was created in a "
1259 "detached state in a later call to B<pthread_detach>(3)  or "
1260 "B<pthread_join>(3)."
1261 msgstr ""
1262
1263 #. type: Plain text
1264 #: build/C/man3/pthread_attr_setdetachstate.3:111 build/C/man3/pthread_attr_setstack.3:156
1265 msgid "See B<pthread_attr_init>(3)."
1266 msgstr ""
1267
1268 #. type: Plain text
1269 #: build/C/man3/pthread_attr_setdetachstate.3:117
1270 msgid ""
1271 "B<pthread_attr_init>(3), B<pthread_create>(3), B<pthread_detach>(3), "
1272 "B<pthread_join>(3), B<pthreads>(7)"
1273 msgstr ""
1274
1275 #. type: TH
1276 #: build/C/man3/pthread_attr_setguardsize.3:26
1277 #, no-wrap
1278 msgid "PTHREAD_ATTR_SETGUARDSIZE"
1279 msgstr ""
1280
1281 #. type: TH
1282 #: build/C/man3/pthread_attr_setguardsize.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
1283 #, no-wrap
1284 msgid "2008-10-24"
1285 msgstr ""
1286
1287 #. type: Plain text
1288 #: build/C/man3/pthread_attr_setguardsize.3:30
1289 msgid ""
1290 "pthread_attr_setguardsize, pthread_attr_getguardsize - set/get guard size "
1291 "attribute in thread attributes object"
1292 msgstr ""
1293
1294 #. type: Plain text
1295 #: build/C/man3/pthread_attr_setguardsize.3:38
1296 #, no-wrap
1297 msgid ""
1298 "B<int pthread_attr_setguardsize(pthread_attr_t *>I<attr>B<, size_t "
1299 ">I<guardsize>B<);>\n"
1300 "B<int pthread_attr_getguardsize(pthread_attr_t *>I<attr>B<, size_t "
1301 "*>I<guardsize>B<);>\n"
1302 msgstr ""
1303
1304 #. type: Plain text
1305 #: build/C/man3/pthread_attr_setguardsize.3:49
1306 msgid ""
1307 "The B<pthread_attr_setguardsize>()  function sets the guard size attribute "
1308 "of the thread attributes object referred to by I<attr> to the value "
1309 "specified in I<guardsize>."
1310 msgstr ""
1311
1312 #. type: Plain text
1313 #: build/C/man3/pthread_attr_setguardsize.3:59
1314 msgid ""
1315 "If I<guardsize> is greater than 0, then for each new thread created using "
1316 "I<attr> the system allocates an additional region of at least I<guardsize> "
1317 "bytes at the end of the thread's stack to act as the guard area for the "
1318 "stack (but see BUGS)."
1319 msgstr ""
1320
1321 #. type: Plain text
1322 #: build/C/man3/pthread_attr_setguardsize.3:65
1323 msgid ""
1324 "If I<guardsize> is 0, then new threads created with I<attr> will not have a "
1325 "guard area."
1326 msgstr ""
1327
1328 #. type: Plain text
1329 #: build/C/man3/pthread_attr_setguardsize.3:67
1330 msgid "The default guard size is the same as the system page size."
1331 msgstr ""
1332
1333 #. type: Plain text
1334 #: build/C/man3/pthread_attr_setguardsize.3:82
1335 msgid ""
1336 "If the stack address attribute has been set in I<attr> (using "
1337 "B<pthread_attr_setstack>(3)  or B<pthread_attr_setstackaddr>(3)), meaning "
1338 "that the caller is allocating the thread's stack, then the guard size "
1339 "attribute is ignored (i.e., no guard area is created by the system): it is "
1340 "the application's responsibility to handle stack overflow (perhaps by using "
1341 "B<mprotect>(2)  to manually define a guard area at the end of the stack that "
1342 "it has allocated)."
1343 msgstr ""
1344
1345 #. type: Plain text
1346 #: build/C/man3/pthread_attr_setguardsize.3:90
1347 msgid ""
1348 "The B<pthread_attr_getguardsize>()  function returns the guard size "
1349 "attribute of the thread attributes object referred to by I<attr> in the "
1350 "buffer pointed to by I<guardsize>."
1351 msgstr ""
1352
1353 #. type: Plain text
1354 #: build/C/man3/pthread_attr_setguardsize.3:104
1355 msgid ""
1356 "POSIX.1-2001 documents an B<EINVAL> error if I<attr> or I<guardsize> is "
1357 "invalid.  On Linux these functions always succeed (but portable and "
1358 "future-proof applications should nevertheless handle a possible error "
1359 "return)."
1360 msgstr ""
1361
1362 #. type: Plain text
1363 #: build/C/man3/pthread_attr_setguardsize.3:106 build/C/man3/pthread_attr_setstackaddr.3:83 build/C/man3/pthread_attr_setstacksize.3:83
1364 msgid "These functions are provided by glibc since version 2.1."
1365 msgstr ""
1366
1367 #. type: Plain text
1368 #: build/C/man3/pthread_attr_setguardsize.3:122
1369 msgid ""
1370 "A guard area consists of virtual memory pages that are protected to prevent "
1371 "read and write access.  If a thread overflows its stack into the guard area, "
1372 "then, on most hard architectures, it receives a B<SIGSEGV> signal, thus "
1373 "notifying it of the overflow.  Guard areas start on page boundaries, and the "
1374 "guard size is internally rounded up to the system page size when creating a "
1375 "thread.  (Nevertheless, B<pthread_attr_getguardsize>()  returns the guard "
1376 "size that was set by B<pthread_attr_setguardsize>().)"
1377 msgstr ""
1378
1379 #. type: Plain text
1380 #: build/C/man3/pthread_attr_setguardsize.3:126
1381 msgid ""
1382 "Setting a guard size of 0 may be useful to save memory in an application "
1383 "that creates many threads and knows that stack overflow can never occur."
1384 msgstr ""
1385
1386 #. type: Plain text
1387 #: build/C/man3/pthread_attr_setguardsize.3:130
1388 msgid ""
1389 "Choosing a guard size larger than the default size may be necessary for "
1390 "detecting stack overflows if a thread allocates large data structures on the "
1391 "stack."
1392 msgstr ""
1393
1394 #. type: SH
1395 #: build/C/man3/pthread_attr_setguardsize.3:130 build/C/man3/pthread_attr_setinheritsched.3:112 build/C/man3/pthread_attr_setstacksize.3:96 build/C/man3/pthread_create.3:196 build/C/man3/pthread_exit.3:93
1396 #, no-wrap
1397 msgid "BUGS"
1398 msgstr ""
1399
1400 #. type: Plain text
1401 #: build/C/man3/pthread_attr_setguardsize.3:141
1402 msgid ""
1403 "As at glibc 2.8, the NPTL threading implementation includes the guard area "
1404 "within the stack size allocation, rather than allocating extra space at the "
1405 "end of the stack, as POSIX.1 requires.  (This can result in an B<EINVAL> "
1406 "error from B<pthread_create>(3)  if the guard size value is too large, "
1407 "leaving no space for the actual stack.)"
1408 msgstr ""
1409
1410 #.  glibc includes the guardsize within the allocated stack size,
1411 #.  which looks pretty clearly to be in violation of POSIX.
1412 #
1413 #.  Filed bug, 22 Oct 2008:
1414 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=6973
1415 #
1416 #.  Older reports:
1417 #.  https//bugzilla.redhat.com/show_bug.cgi?id=435337
1418 #.  Reportedly, LinuxThreads did the right thing, allocating
1419 #.  extra space at the end of the stack:
1420 #.  http://sourceware.org/ml/libc-alpha/2008-05/msg00086.html
1421 #. type: Plain text
1422 #: build/C/man3/pthread_attr_setguardsize.3:155
1423 msgid ""
1424 "The obsolete LinuxThreads implementation did the right thing, allocating "
1425 "extra space at the end of the stack for the guard area."
1426 msgstr ""
1427
1428 #. type: Plain text
1429 #: build/C/man3/pthread_attr_setguardsize.3:158
1430 msgid "See B<pthread_getattr_np>(3)."
1431 msgstr ""
1432
1433 #. type: Plain text
1434 #: build/C/man3/pthread_attr_setguardsize.3:166
1435 msgid ""
1436 "B<mmap>(2), B<mprotect>(2), B<pthread_attr_init>(3), "
1437 "B<pthread_attr_setstack>(3), B<pthread_attr_setstacksize>(3), "
1438 "B<pthread_create>(3), B<pthreads>(7)"
1439 msgstr ""
1440
1441 #. type: TH
1442 #: build/C/man3/pthread_attr_setinheritsched.3:26
1443 #, no-wrap
1444 msgid "PTHREAD_ATTR_SETINHERITSCHED"
1445 msgstr ""
1446
1447 #. type: TH
1448 #: build/C/man3/pthread_attr_setinheritsched.3:26 build/C/man3/pthread_attr_setscope.3:26
1449 #, no-wrap
1450 msgid "2013-04-19"
1451 msgstr ""
1452
1453 #. type: Plain text
1454 #: build/C/man3/pthread_attr_setinheritsched.3:30
1455 msgid ""
1456 "pthread_attr_setinheritsched, pthread_attr_getinheritsched - set/get "
1457 "inherit-scheduler attribute in thread attributes object"
1458 msgstr ""
1459
1460 #. type: Plain text
1461 #: build/C/man3/pthread_attr_setinheritsched.3:38
1462 #, no-wrap
1463 msgid ""
1464 "B<int pthread_attr_setinheritsched(pthread_attr_t *>I<attr>B<,>\n"
1465 "B<                                 int >I<inheritsched>B<);>\n"
1466 "B<int pthread_attr_getinheritsched(pthread_attr_t *>I<attr>B<,>\n"
1467 "B<                                 int *>I<inheritsched>B<);>\n"
1468 msgstr ""
1469
1470 #. type: Plain text
1471 #: build/C/man3/pthread_attr_setinheritsched.3:55
1472 msgid ""
1473 "The B<pthread_attr_setinheritsched>()  function sets the inherit-scheduler "
1474 "attribute of the thread attributes object referred to by I<attr> to the "
1475 "value specified in I<inheritsched>.  The inherit-scheduler attribute "
1476 "determines whether a thread created using the thread attributes object "
1477 "I<attr> will inherit its scheduling attributes from the calling thread or "
1478 "whether it will take them from I<attr>."
1479 msgstr ""
1480
1481 #. type: Plain text
1482 #: build/C/man3/pthread_attr_setinheritsched.3:64
1483 msgid ""
1484 "The following scheduling attributes are affected by the inherit-scheduler "
1485 "attribute: scheduling policy (B<pthread_attr_setschedpolicy>(3)), scheduling "
1486 "priority (B<pthread_attr_setschedparam>(3)), and contention scope "
1487 "(B<pthread_attr_setscope>(3))."
1488 msgstr ""
1489
1490 #. type: Plain text
1491 #: build/C/man3/pthread_attr_setinheritsched.3:67
1492 msgid "The following values may be specified in I<inheritsched>:"
1493 msgstr ""
1494
1495 #. type: TP
1496 #: build/C/man3/pthread_attr_setinheritsched.3:67
1497 #, no-wrap
1498 msgid "B<PTHREAD_INHERIT_SCHED>"
1499 msgstr ""
1500
1501 #. type: Plain text
1502 #: build/C/man3/pthread_attr_setinheritsched.3:75
1503 msgid ""
1504 "Threads that are created using I<attr> inherit scheduling attributes from "
1505 "the creating thread; the scheduling attributes in I<attr> are ignored."
1506 msgstr ""
1507
1508 #. type: TP
1509 #: build/C/man3/pthread_attr_setinheritsched.3:75
1510 #, no-wrap
1511 msgid "B<PTHREAD_EXPLICIT_SCHED>"
1512 msgstr ""
1513
1514 #.  FIXME what are the defaults for scheduler settings?
1515 #. type: Plain text
1516 #: build/C/man3/pthread_attr_setinheritsched.3:82
1517 msgid ""
1518 "Threads that are created using I<attr> take their scheduling attributes from "
1519 "the values specified by the attributes object."
1520 msgstr ""
1521
1522 #. type: Plain text
1523 #: build/C/man3/pthread_attr_setinheritsched.3:86
1524 msgid ""
1525 "The default setting of the inherit-scheduler attribute in a newly "
1526 "initialized thread attributes object is B<PTHREAD_INHERIT_SCHED>."
1527 msgstr ""
1528
1529 #. type: Plain text
1530 #: build/C/man3/pthread_attr_setinheritsched.3:93
1531 msgid ""
1532 "The B<pthread_attr_getinheritsched>()  returns the inherit-scheduler "
1533 "attribute of the thread attributes object I<attr> in the buffer pointed to "
1534 "by I<inheritsched>."
1535 msgstr ""
1536
1537 #. type: Plain text
1538 #: build/C/man3/pthread_attr_setinheritsched.3:99
1539 msgid "B<pthread_attr_setinheritsched>()  can fail with the following error:"
1540 msgstr ""
1541
1542 #. type: Plain text
1543 #: build/C/man3/pthread_attr_setinheritsched.3:103
1544 msgid "Invalid value in I<inheritsched>."
1545 msgstr ""
1546
1547 #.  .SH VERSIONS
1548 #.  Available since glibc 2.0.
1549 #. type: Plain text
1550 #: build/C/man3/pthread_attr_setinheritsched.3:110
1551 msgid ""
1552 "POSIX.1-2001 also documents an optional B<ENOTSUP> error (\"attempt was made "
1553 "to set the attribute to an unsupported value\") for "
1554 "B<pthread_attr_setinheritsched>()."
1555 msgstr ""
1556
1557 #.  FIXME . Track status of the following bug:
1558 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=7007
1559 #. type: Plain text
1560 #: build/C/man3/pthread_attr_setinheritsched.3:128
1561 msgid ""
1562 "As at glibc 2.8, if a thread attributes object is initialized using "
1563 "B<pthread_attr_init>(3), then the scheduling policy of the attributes object "
1564 "is set to B<SCHED_OTHER> and the scheduling priority is set to 0.  However, "
1565 "if the inherit-scheduler attribute is then set to B<PTHREAD_EXPLICIT_SCHED>, "
1566 "then a thread created using the attribute object wrongly inherits its "
1567 "scheduling attributes from the creating thread.  This bug does not occur if "
1568 "either the scheduling policy or scheduling priority attribute is explicitly "
1569 "set in the thread attributes object before calling B<pthread_create>(3)."
1570 msgstr ""
1571
1572 #. type: Plain text
1573 #: build/C/man3/pthread_attr_setinheritsched.3:131 build/C/man3/pthread_attr_setschedparam.3:109 build/C/man3/pthread_attr_setschedpolicy.3:105
1574 msgid "See B<pthread_setschedparam>(3)."
1575 msgstr ""
1576
1577 #. type: Plain text
1578 #: build/C/man3/pthread_attr_setinheritsched.3:143
1579 msgid ""
1580 "B<sched_setscheduler>(2), B<pthread_attr_init>(3), "
1581 "B<pthread_attr_setschedparam>(3), B<pthread_attr_setschedpolicy>(3), "
1582 "B<pthread_attr_setscope>(3), B<pthread_create>(3), "
1583 "B<pthread_setschedparam>(3), B<pthread_setschedprio>(3), B<pthreads>(7)"
1584 msgstr ""
1585
1586 #. type: TH
1587 #: build/C/man3/pthread_attr_setschedparam.3:26
1588 #, no-wrap
1589 msgid "PTHREAD_ATTR_SETSCHEDPARAM"
1590 msgstr ""
1591
1592 #. type: TH
1593 #: build/C/man3/pthread_attr_setschedparam.3:26 build/C/man3/pthread_attr_setschedpolicy.3:26 build/C/man3/pthread_setname_np.3:26
1594 #, no-wrap
1595 msgid "2013-06-21"
1596 msgstr ""
1597
1598 #. type: Plain text
1599 #: build/C/man3/pthread_attr_setschedparam.3:30
1600 msgid ""
1601 "pthread_attr_setschedparam, pthread_attr_getschedparam - set/get scheduling "
1602 "parameter attributes in thread attributes object"
1603 msgstr ""
1604
1605 #. type: Plain text
1606 #: build/C/man3/pthread_attr_setschedparam.3:38
1607 #, no-wrap
1608 msgid ""
1609 "B<int pthread_attr_setschedparam(pthread_attr_t *>I<attr>B<,>\n"
1610 "B<                               const struct sched_param *>I<param>B<);>\n"
1611 "B<int pthread_attr_getschedparam(pthread_attr_t *>I<attr>B<,>\n"
1612 "B<                               struct sched_param *>I<param>B<);>\n"
1613 msgstr ""
1614
1615 #. type: Plain text
1616 #: build/C/man3/pthread_attr_setschedparam.3:52
1617 msgid ""
1618 "The B<pthread_attr_setschedparam>()  function sets the scheduling parameter "
1619 "attributes of the thread attributes object referred to by I<attr> to the "
1620 "values specified in the buffer pointed to by I<param>.  These attributes "
1621 "determine the scheduling parameters of a thread created using the thread "
1622 "attributes object I<attr>."
1623 msgstr ""
1624
1625 #. type: Plain text
1626 #: build/C/man3/pthread_attr_setschedparam.3:59
1627 msgid ""
1628 "The B<pthread_attr_getschedparam>()  returns the scheduling parameter "
1629 "attributes of the thread attributes object I<attr> in the buffer pointed to "
1630 "by I<param>."
1631 msgstr ""
1632
1633 #. type: Plain text
1634 #: build/C/man3/pthread_attr_setschedparam.3:61
1635 msgid "Scheduling parameters are maintained in the following structure:"
1636 msgstr ""
1637
1638 #. type: Plain text
1639 #: build/C/man3/pthread_attr_setschedparam.3:67 build/C/man3/pthread_setschedparam.3:69
1640 #, no-wrap
1641 msgid ""
1642 "struct sched_param {\n"
1643 "    int sched_priority;     /* Scheduling priority */\n"
1644 "};\n"
1645 msgstr ""
1646
1647 #. type: Plain text
1648 #: build/C/man3/pthread_attr_setschedparam.3:74 build/C/man3/pthread_setschedparam.3:76
1649 msgid ""
1650 "As can be seen, only one scheduling parameter is supported.  For details of "
1651 "the permitted ranges for scheduling priorities in each scheduling policy, "
1652 "see B<sched_setscheduler>(2)."
1653 msgstr ""
1654
1655 #. type: Plain text
1656 #: build/C/man3/pthread_attr_setschedparam.3:85
1657 msgid ""
1658 "In order for the parameter setting made by B<pthread_attr_setschedparam>()  "
1659 "to have effect when calling B<pthread_create>(3), the caller must use "
1660 "B<pthread_attr_setinheritsched>(3)  to set the inherit-scheduler attribute "
1661 "of the attributes object I<attr> to B<PTHREAD_EXPLICIT_SCHED>."
1662 msgstr ""
1663
1664 #.  .SH VERSIONS
1665 #.  Available since glibc 2.0.
1666 #. type: Plain text
1667 #: build/C/man3/pthread_attr_setschedparam.3:100
1668 msgid ""
1669 "POSIX.1 documents B<EINVAL> and B<ENOTSUP> errors for "
1670 "B<pthread_attr_setschedparam>().  On Linux these functions always succeed "
1671 "(but portable and future-proof applications should nevertheless handle a "
1672 "possible error return)."
1673 msgstr ""
1674
1675 #. type: Plain text
1676 #: build/C/man3/pthread_attr_setschedparam.3:106
1677 msgid ""
1678 "See B<pthread_attr_setschedpolicy>(3)  for a list of the thread scheduling "
1679 "policies supported on Linux."
1680 msgstr ""
1681
1682 #. type: Plain text
1683 #: build/C/man3/pthread_attr_setschedparam.3:121
1684 msgid ""
1685 "B<sched_get_priority_min>(2), B<sched_setscheduler>(2), "
1686 "B<pthread_attr_init>(3), B<pthread_attr_setinheritsched>(3), "
1687 "B<pthread_attr_setschedpolicy>(3), B<pthread_create>(3), "
1688 "B<pthread_setschedparam>(3), B<pthread_setschedprio>(3), B<pthreads>(7)"
1689 msgstr ""
1690
1691 #. type: TH
1692 #: build/C/man3/pthread_attr_setschedpolicy.3:26
1693 #, no-wrap
1694 msgid "PTHREAD_ATTR_SETSCHEDPOLICY"
1695 msgstr ""
1696
1697 #. type: Plain text
1698 #: build/C/man3/pthread_attr_setschedpolicy.3:30
1699 msgid ""
1700 "pthread_attr_setschedpolicy, pthread_attr_getschedpolicy - set/get "
1701 "scheduling policy attribute in thread attributes object"
1702 msgstr ""
1703
1704 #. type: Plain text
1705 #: build/C/man3/pthread_attr_setschedpolicy.3:38
1706 #, no-wrap
1707 msgid ""
1708 "B<int pthread_attr_setschedpolicy(pthread_attr_t *>I<attr>B<, int "
1709 ">I<policy>B<);>\n"
1710 "B<int pthread_attr_getschedpolicy(pthread_attr_t *>I<attr>B<, int "
1711 ">I<*policy>B<);>\n"
1712 msgstr ""
1713
1714 #. type: Plain text
1715 #: build/C/man3/pthread_attr_setschedpolicy.3:52
1716 msgid ""
1717 "The B<pthread_attr_setschedpolicy>()  function sets the scheduling policy "
1718 "attribute of the thread attributes object referred to by I<attr> to the "
1719 "value specified in I<policy>.  This attribute determines the scheduling "
1720 "policy of a thread created using the thread attributes object I<attr>."
1721 msgstr ""
1722
1723 #.  FIXME . pthread_setschedparam() places no restriction on the policy,
1724 #.  but pthread_attr_setschedpolicy() restricts policy to RR/FIFO/OTHER
1725 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=7013
1726 #. type: Plain text
1727 #: build/C/man3/pthread_attr_setschedpolicy.3:65
1728 msgid ""
1729 "The supported values for I<policy> are B<SCHED_FIFO>, B<SCHED_RR>, and "
1730 "B<SCHED_OTHER>, with the semantics described in B<sched_setscheduler>(2)."
1731 msgstr ""
1732
1733 #. type: Plain text
1734 #: build/C/man3/pthread_attr_setschedpolicy.3:72
1735 msgid ""
1736 "The B<pthread_attr_getschedpolicy>()  returns the scheduling policy "
1737 "attribute of the thread attributes object I<attr> in the buffer pointed to "
1738 "by I<policy>."
1739 msgstr ""
1740
1741 #. type: Plain text
1742 #: build/C/man3/pthread_attr_setschedpolicy.3:83
1743 msgid ""
1744 "In order for the policy setting made by B<pthread_attr_setschedpolicy>()  to "
1745 "have effect when calling B<pthread_create>(3), the caller must use "
1746 "B<pthread_attr_setinheritsched>(3)  to set the inherit-scheduler attribute "
1747 "of the attributes object I<attr> to B<PTHREAD_EXPLICIT_SCHED>."
1748 msgstr ""
1749
1750 #. type: Plain text
1751 #: build/C/man3/pthread_attr_setschedpolicy.3:89
1752 msgid "B<pthread_attr_setschedpolicy>()  can fail with the following error:"
1753 msgstr ""
1754
1755 #. type: Plain text
1756 #: build/C/man3/pthread_attr_setschedpolicy.3:93
1757 msgid "Invalid value in I<policy>."
1758 msgstr ""
1759
1760 #.  .SH VERSIONS
1761 #.  Available since glibc 2.0.
1762 #. type: Plain text
1763 #: build/C/man3/pthread_attr_setschedpolicy.3:100
1764 msgid ""
1765 "POSIX.1-2001 also documents an optional B<ENOTSUP> error (\"attempt was made "
1766 "to set the attribute to an unsupported value\") for "
1767 "B<pthread_attr_setschedpolicy>()."
1768 msgstr ""
1769
1770 #. type: Plain text
1771 #: build/C/man3/pthread_attr_setschedpolicy.3:116
1772 msgid ""
1773 "B<sched_setscheduler>(2), B<pthread_attr_init>(3), "
1774 "B<pthread_attr_setinheritsched>(3), B<pthread_attr_setschedparam>(3), "
1775 "B<pthread_create>(3), B<pthread_setschedparam>(3), "
1776 "B<pthread_setschedprio>(3), B<pthreads>(7)"
1777 msgstr ""
1778
1779 #. type: TH
1780 #: build/C/man3/pthread_attr_setscope.3:26
1781 #, no-wrap
1782 msgid "PTHREAD_ATTR_SETSCOPE"
1783 msgstr ""
1784
1785 #. type: Plain text
1786 #: build/C/man3/pthread_attr_setscope.3:30
1787 msgid ""
1788 "pthread_attr_setscope, pthread_attr_getscope - set/get contention scope "
1789 "attribute in thread attributes object"
1790 msgstr ""
1791
1792 #. type: Plain text
1793 #: build/C/man3/pthread_attr_setscope.3:38
1794 #, no-wrap
1795 msgid ""
1796 "B<int pthread_attr_setscope(pthread_attr_t *>I<attr>B<, int >I<scope>B<);>\n"
1797 "B<int pthread_attr_getscope(pthread_attr_t *>I<attr>B<, int "
1798 "*>I<scope>B<);>\n"
1799 msgstr ""
1800
1801 #. type: Plain text
1802 #: build/C/man3/pthread_attr_setscope.3:53
1803 msgid ""
1804 "The B<pthread_attr_setscope>()  function sets the contention scope attribute "
1805 "of the thread attributes object referred to by I<attr> to the value "
1806 "specified in I<scope>.  The contention scope attribute defines the set of "
1807 "threads against which a thread competes for resources such as the CPU.  "
1808 "POSIX.1-2001 specifies two possible values for I<scope>:"
1809 msgstr ""
1810
1811 #. type: TP
1812 #: build/C/man3/pthread_attr_setscope.3:53
1813 #, no-wrap
1814 msgid "B<PTHREAD_SCOPE_SYSTEM>"
1815 msgstr ""
1816
1817 #. type: Plain text
1818 #: build/C/man3/pthread_attr_setscope.3:61
1819 msgid ""
1820 "The thread competes for resources with all other threads in all processes on "
1821 "the system that are in the same scheduling allocation domain (a group of one "
1822 "or more processors).  B<PTHREAD_SCOPE_SYSTEM> threads are scheduled relative "
1823 "to one another according to their scheduling policy and priority."
1824 msgstr ""
1825
1826 #. type: TP
1827 #: build/C/man3/pthread_attr_setscope.3:61
1828 #, no-wrap
1829 msgid "B<PTHREAD_SCOPE_PROCESS>"
1830 msgstr ""
1831
1832 #. type: Plain text
1833 #: build/C/man3/pthread_attr_setscope.3:76
1834 msgid ""
1835 "The thread competes for resources with all other threads in the same process "
1836 "that were also created with the B<PTHREAD_SCOPE_PROCESS> contention scope.  "
1837 "B<PTHREAD_SCOPE_PROCESS> threads are scheduled relative to other threads in "
1838 "the process according to their scheduling policy and priority.  POSIX.1-2001 "
1839 "leaves it unspecified how these threads contend with other threads in other "
1840 "process on the system or with other threads in the same process that were "
1841 "created with the B<PTHREAD_SCOPE_SYSTEM> contention scope."
1842 msgstr ""
1843
1844 #. type: Plain text
1845 #: build/C/man3/pthread_attr_setscope.3:83
1846 msgid ""
1847 "POSIX.1-2001 requires that an implementation support at least one of these "
1848 "contention scopes.  Linux supports B<PTHREAD_SCOPE_SYSTEM>, but not "
1849 "B<PTHREAD_SCOPE_PROCESS>."
1850 msgstr ""
1851
1852 #. type: Plain text
1853 #: build/C/man3/pthread_attr_setscope.3:95
1854 msgid ""
1855 "On systems that support multiple contention scopes, then, in order for the "
1856 "parameter setting made by B<pthread_attr_setscope>()  to have effect when "
1857 "calling B<pthread_create>(3), the caller must use "
1858 "B<pthread_attr_setinheritsched>(3)  to set the inherit-scheduler attribute "
1859 "of the attributes object I<attr> to B<PTHREAD_EXPLICIT_SCHED>."
1860 msgstr ""
1861
1862 #. type: Plain text
1863 #: build/C/man3/pthread_attr_setscope.3:103
1864 msgid ""
1865 "The B<pthread_attr_getscope>()  function returns the contention scope "
1866 "attribute of the thread attributes object referred to by I<attr> in the "
1867 "buffer pointed to by I<scope>."
1868 msgstr ""
1869
1870 #. type: Plain text
1871 #: build/C/man3/pthread_attr_setscope.3:109
1872 msgid "B<pthread_attr_setscope>()  can fail with the following errors:"
1873 msgstr ""
1874
1875 #. type: Plain text
1876 #: build/C/man3/pthread_attr_setscope.3:113
1877 msgid "An invalid value was specified in I<scope>."
1878 msgstr ""
1879
1880 #. type: TP
1881 #: build/C/man3/pthread_attr_setscope.3:113
1882 #, no-wrap
1883 msgid "B<ENOTSUP>"
1884 msgstr ""
1885
1886 #. type: Plain text
1887 #: build/C/man3/pthread_attr_setscope.3:119
1888 msgid ""
1889 "I<scope> specified the value B<PTHREAD_SCOPE_PROCESS>, which is not "
1890 "supported on Linux."
1891 msgstr ""
1892
1893 #. type: Plain text
1894 #: build/C/man3/pthread_attr_setscope.3:129
1895 msgid ""
1896 "The B<PTHREAD_SCOPE_SYSTEM> contention scope typically indicates that a "
1897 "user-space thread is bound directly to a single kernel-scheduling entity.  "
1898 "This is the case on Linux for the obsolete LinuxThreads implementation and "
1899 "the modern NPTL implementation, which are both 1:1 threading "
1900 "implementations."
1901 msgstr ""
1902
1903 #. type: Plain text
1904 #: build/C/man3/pthread_attr_setscope.3:132
1905 msgid ""
1906 "POSIX.1-2001 specifies that the default contention scope is "
1907 "implementation-defined."
1908 msgstr ""
1909
1910 #. type: Plain text
1911 #: build/C/man3/pthread_attr_setscope.3:142
1912 msgid ""
1913 "B<pthread_attr_init>(3), B<pthread_attr_setaffinity_np>(3), "
1914 "B<pthread_attr_setinheritsched>(3), B<pthread_attr_setschedparam>(3), "
1915 "B<pthread_attr_setschedpolicy>(3), B<pthread_create>(3), B<pthreads>(7)"
1916 msgstr ""
1917
1918 #. type: TH
1919 #: build/C/man3/pthread_attr_setstack.3:26
1920 #, no-wrap
1921 msgid "PTHREAD_ATTR_SETSTACK"
1922 msgstr ""
1923
1924 #. type: Plain text
1925 #: build/C/man3/pthread_attr_setstack.3:30
1926 msgid ""
1927 "pthread_attr_setstack, pthread_attr_getstack - set/get stack attributes in "
1928 "thread attributes object"
1929 msgstr ""
1930
1931 #. type: Plain text
1932 #: build/C/man3/pthread_attr_setstack.3:38
1933 #, no-wrap
1934 msgid ""
1935 "B<int pthread_attr_setstack(pthread_attr_t *>I<attr>B<,>\n"
1936 "B<                          void *>I<stackaddr>B<, size_t "
1937 ">I<stacksize>B<);>\n"
1938 "B<int pthread_attr_getstack(pthread_attr_t *>I<attr>B<,>\n"
1939 "B<                          void **>I<stackaddr>B<, size_t "
1940 "*>I<stacksize>B<);>\n"
1941 msgstr ""
1942
1943 #. type: Plain text
1944 #: build/C/man3/pthread_attr_setstack.3:45 build/C/man3/pthread_sigqueue.3:41
1945 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
1946 msgstr ""
1947
1948 #. type: Plain text
1949 #: build/C/man3/pthread_attr_setstack.3:50
1950 msgid "B<pthread_attr_getstack>(), B<pthread_attr_setstack>():"
1951 msgstr ""
1952
1953 #. type: Plain text
1954 #: build/C/man3/pthread_attr_setstack.3:52
1955 msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600"
1956 msgstr ""
1957
1958 #. type: Plain text
1959 #: build/C/man3/pthread_attr_setstack.3:68
1960 msgid ""
1961 "The B<pthread_attr_setstack>()  function sets the stack address and stack "
1962 "size attributes of the thread attributes object referred to by I<attr> to "
1963 "the values specified in I<stackaddr> and I<stacksize>, respectively.  These "
1964 "attributes specify the location and size of the stack that should be used by "
1965 "a thread that is created using the thread attributes object I<attr>."
1966 msgstr ""
1967
1968 #. type: Plain text
1969 #: build/C/man3/pthread_attr_setstack.3:74
1970 msgid ""
1971 "I<stackaddr> should point to the lowest addressable byte of a buffer of "
1972 "I<stacksize> bytes that was allocated by the caller.  The pages of the "
1973 "allocated buffer should be both readable and writable."
1974 msgstr ""
1975
1976 #. type: Plain text
1977 #: build/C/man3/pthread_attr_setstack.3:85
1978 msgid ""
1979 "The B<pthread_attr_getstack>()  function returns the stack address and stack "
1980 "size attributes of the thread attributes object referred to by I<attr> in "
1981 "the buffers pointed to by I<stackaddr> and I<stacksize>, respectively."
1982 msgstr ""
1983
1984 #. type: Plain text
1985 #: build/C/man3/pthread_attr_setstack.3:91
1986 msgid "B<pthread_attr_setstack>()  can fail with the following error:"
1987 msgstr ""
1988
1989 #. type: Plain text
1990 #: build/C/man3/pthread_attr_setstack.3:102
1991 msgid ""
1992 "I<stacksize> is less than B<PTHREAD_STACK_MIN> (16384) bytes.  On some "
1993 "systems, this error may also occur if I<stackaddr> or I<stackaddr\\ +\\ "
1994 "stacksize> is not suitably aligned."
1995 msgstr ""
1996
1997 #. type: Plain text
1998 #: build/C/man3/pthread_attr_setstack.3:110
1999 msgid ""
2000 "POSIX.1-2001 also documents an B<EACCES> error if the stack area described "
2001 "by I<stackaddr> and I<stacksize> is not both readable and writable by the "
2002 "caller."
2003 msgstr ""
2004
2005 #. type: Plain text
2006 #: build/C/man3/pthread_attr_setstack.3:112
2007 msgid "These functions are provided by glibc since version 2.2."
2008 msgstr ""
2009
2010 #. type: Plain text
2011 #: build/C/man3/pthread_attr_setstack.3:122
2012 msgid ""
2013 "These functions are provided for applications that must ensure that a "
2014 "thread's stack is placed in a particular location.  For most applications, "
2015 "this is not necessary, and the use of these functions should be avoided.  "
2016 "(Use B<pthread_attr_setstacksize>(3)  if an application simply requires a "
2017 "stack size other than the default.)"
2018 msgstr ""
2019
2020 #. type: Plain text
2021 #: build/C/man3/pthread_attr_setstack.3:133
2022 msgid ""
2023 "When an application employs B<pthread_attr_setstack>(), it takes over the "
2024 "responsibility of allocating the stack.  Any guard size value that was set "
2025 "using B<pthread_attr_setguardsize>(3)  is ignored.  If deemed necessary, it "
2026 "is the application's responsibility to allocate a guard area (one or more "
2027 "pages protected against reading and writing)  to handle the possibility of "
2028 "stack overflow."
2029 msgstr ""
2030
2031 #. type: Plain text
2032 #: build/C/man3/pthread_attr_setstack.3:144
2033 msgid ""
2034 "The address specified in I<stackaddr> should be suitably aligned: for full "
2035 "portability, align it on a page boundary (I<sysconf(_SC_PAGESIZE)>).  "
2036 "B<posix_memalign>(3)  may be useful for allocation.  Probably, I<stacksize> "
2037 "should also be a multiple of the system page size."
2038 msgstr ""
2039
2040 #. type: Plain text
2041 #: build/C/man3/pthread_attr_setstack.3:153
2042 msgid ""
2043 "If I<attr> is used to create multiple threads, then the caller must change "
2044 "the stack address attribute between calls to B<pthread_create>(3); "
2045 "otherwise, the threads will attempt to use the same memory area for their "
2046 "stacks, and chaos will ensue."
2047 msgstr ""
2048
2049 #. type: Plain text
2050 #: build/C/man3/pthread_attr_setstack.3:168
2051 msgid ""
2052 "B<mmap>(2), B<mprotect>(2), B<posix_memalign>(3), B<pthread_attr_init>(3), "
2053 "B<pthread_attr_setguardsize>(3), B<pthread_attr_setstackaddr>(3), "
2054 "B<pthread_attr_setstacksize>(3), B<pthread_create>(3), B<pthreads>(7)"
2055 msgstr ""
2056
2057 #. type: TH
2058 #: build/C/man3/pthread_attr_setstackaddr.3:26
2059 #, no-wrap
2060 msgid "PTHREAD_ATTR_SETSTACKADDR"
2061 msgstr ""
2062
2063 #. type: Plain text
2064 #: build/C/man3/pthread_attr_setstackaddr.3:30
2065 msgid ""
2066 "pthread_attr_setstackaddr, pthread_attr_getstackaddr - set/get stack address "
2067 "attribute in thread attributes object"
2068 msgstr ""
2069
2070 #. type: Plain text
2071 #: build/C/man3/pthread_attr_setstackaddr.3:38
2072 #, no-wrap
2073 msgid ""
2074 "B<int pthread_attr_setstackaddr(pthread_attr_t *>I<attr>B<, void "
2075 "*>I<stackaddr>B<);>\n"
2076 "B<int pthread_attr_getstackaddr(pthread_attr_t *>I<attr>B<, void "
2077 "**>I<stackaddr>B<);>\n"
2078 msgstr ""
2079
2080 #. type: Plain text
2081 #: build/C/man3/pthread_attr_setstackaddr.3:49
2082 msgid ""
2083 "These functions are obsolete: B<do not use them.> Use "
2084 "B<pthread_attr_setstack>(3)  and B<pthread_attr_getstack>(3)  instead."
2085 msgstr ""
2086
2087 #. type: Plain text
2088 #: build/C/man3/pthread_attr_setstackaddr.3:60
2089 msgid ""
2090 "The B<pthread_attr_setstackaddr>()  function sets the stack address "
2091 "attribute of the thread attributes object referred to by I<attr> to the "
2092 "value specified in I<stackaddr>.  This attribute specifies the location of "
2093 "the stack that should be used by a thread that is created using the thread "
2094 "attributes object I<attr>."
2095 msgstr ""
2096
2097 #. type: Plain text
2098 #: build/C/man3/pthread_attr_setstackaddr.3:66
2099 msgid ""
2100 "I<stackaddr> should point to a buffer of at least B<PTHREAD_STACK_MIN> bytes "
2101 "that was allocated by the caller.  The pages of the allocated buffer should "
2102 "be both readable and writable."
2103 msgstr ""
2104
2105 #. type: Plain text
2106 #: build/C/man3/pthread_attr_setstackaddr.3:74
2107 msgid ""
2108 "The B<pthread_attr_getstackaddr>()  function returns the stack address "
2109 "attribute of the thread attributes object referred to by I<attr> in the "
2110 "buffer pointed to by I<stackaddr>."
2111 msgstr ""
2112
2113 #. type: Plain text
2114 #: build/C/man3/pthread_attr_setstackaddr.3:81
2115 msgid ""
2116 "No errors are defined (but applications should nevertheless handle a "
2117 "possible error return)."
2118 msgstr ""
2119
2120 #. type: Plain text
2121 #: build/C/man3/pthread_attr_setstackaddr.3:86
2122 msgid ""
2123 "POSIX.1-2001 specifies these functions but marks them as obsolete.  "
2124 "POSIX.1-2008 removes the specification of these functions."
2125 msgstr ""
2126
2127 #. type: Plain text
2128 #: build/C/man3/pthread_attr_setstackaddr.3:110
2129 msgid ""
2130 "I<Do not use these functions!> They cannot be portably used, since they "
2131 "provide no way of specifying the direction of growth or the range of the "
2132 "stack.  For example, on architectures with a stack that grows downward, "
2133 "I<stackaddr> specifies the next address past the I<highest> address of the "
2134 "allocated stack area.  However, on architectures with a stack that grows "
2135 "upward, I<stackaddr> specifies the I<lowest> address in the allocated stack "
2136 "area.  By contrast, the I<stackaddr> used by B<pthread_attr_setstack>(3)  "
2137 "and B<pthread_attr_getstack>(3), is always a pointer to the lowest address "
2138 "in the allocated stack area (and the I<stacksize> argument specifies the "
2139 "range of the stack)."
2140 msgstr ""
2141
2142 #. type: Plain text
2143 #: build/C/man3/pthread_attr_setstackaddr.3:116
2144 msgid ""
2145 "B<pthread_attr_init>(3), B<pthread_attr_setstack>(3), "
2146 "B<pthread_attr_setstacksize>(3), B<pthread_create>(3), B<pthreads>(7)"
2147 msgstr ""
2148
2149 #. type: TH
2150 #: build/C/man3/pthread_attr_setstacksize.3:26
2151 #, no-wrap
2152 msgid "PTHREAD_ATTR_SETSTACKSIZE"
2153 msgstr ""
2154
2155 #. type: TH
2156 #: build/C/man3/pthread_attr_setstacksize.3:26
2157 #, no-wrap
2158 msgid "2012-03-15"
2159 msgstr ""
2160
2161 #. type: Plain text
2162 #: build/C/man3/pthread_attr_setstacksize.3:30
2163 msgid ""
2164 "pthread_attr_setstacksize, pthread_attr_getstacksize - set/get stack size "
2165 "attribute in thread attributes object"
2166 msgstr ""
2167
2168 #. type: Plain text
2169 #: build/C/man3/pthread_attr_setstacksize.3:38
2170 #, no-wrap
2171 msgid ""
2172 "B<int pthread_attr_setstacksize(pthread_attr_t *>I<attr>B<, size_t "
2173 ">I<stacksize>B<);>\n"
2174 "B<int pthread_attr_getstacksize(pthread_attr_t *>I<attr>B<, size_t "
2175 "*>I<stacksize>B<);>\n"
2176 msgstr ""
2177
2178 #. type: Plain text
2179 #: build/C/man3/pthread_attr_setstacksize.3:49
2180 msgid ""
2181 "The B<pthread_attr_setstacksize>()  function sets the stack size attribute "
2182 "of the thread attributes object referred to by I<attr> to the value "
2183 "specified in I<stacksize>."
2184 msgstr ""
2185
2186 #. type: Plain text
2187 #: build/C/man3/pthread_attr_setstacksize.3:53
2188 msgid ""
2189 "The stack size attribute determines the minimum size (in bytes) that will be "
2190 "allocated for threads created using the thread attributes object I<attr>."
2191 msgstr ""
2192
2193 #. type: Plain text
2194 #: build/C/man3/pthread_attr_setstacksize.3:61
2195 msgid ""
2196 "The B<pthread_attr_getstacksize>()  function returns the stack size "
2197 "attribute of the thread attributes object referred to by I<attr> in the "
2198 "buffer pointed to by I<stacksize>."
2199 msgstr ""
2200
2201 #. type: Plain text
2202 #: build/C/man3/pthread_attr_setstacksize.3:67
2203 msgid "B<pthread_attr_setstacksize>()  can fail with the following error:"
2204 msgstr ""
2205
2206 #. type: Plain text
2207 #: build/C/man3/pthread_attr_setstacksize.3:72
2208 msgid "The stack size is less than B<PTHREAD_STACK_MIN> (16384) bytes."
2209 msgstr ""
2210
2211 #.  e.g., MacOS
2212 #. type: Plain text
2213 #: build/C/man3/pthread_attr_setstacksize.3:81
2214 msgid ""
2215 "On some systems, B<pthread_attr_setstacksize>()  can fail with the error "
2216 "B<EINVAL> if I<stacksize> is not a multiple of the system page size."
2217 msgstr ""
2218
2219 #. type: Plain text
2220 #: build/C/man3/pthread_attr_setstacksize.3:88
2221 msgid ""
2222 "For details on the default stack size of new threads, see "
2223 "B<pthread_create>(3)."
2224 msgstr ""
2225
2226 #. type: Plain text
2227 #: build/C/man3/pthread_attr_setstacksize.3:91
2228 msgid ""
2229 "A thread's stack size is fixed at the time of thread creation.  Only the "
2230 "main thread can dynamically grow its stack."
2231 msgstr ""
2232
2233 #. type: Plain text
2234 #: build/C/man3/pthread_attr_setstacksize.3:96
2235 msgid ""
2236 "The B<pthread_attr_setstack>(3)  function allows an application to set both "
2237 "the size and location of a caller-allocated stack that is to be used by a "
2238 "thread."
2239 msgstr ""
2240
2241 #. type: Plain text
2242 #: build/C/man3/pthread_attr_setstacksize.3:108
2243 msgid ""
2244 "As at glibc 2.8, if the specified I<stacksize> is not a multiple of "
2245 "B<STACK_ALIGN> (16 bytes on most architectures), it may be rounded "
2246 "I<downward>, in violation of POSIX.1-2001, which says that the allocated "
2247 "stack will be at least I<stacksize> bytes."
2248 msgstr ""
2249
2250 #. type: Plain text
2251 #: build/C/man3/pthread_attr_setstacksize.3:111 build/C/man3/pthread_join.3:127
2252 msgid "See B<pthread_create>(3)."
2253 msgstr ""
2254
2255 #. type: Plain text
2256 #: build/C/man3/pthread_attr_setstacksize.3:118
2257 msgid ""
2258 "B<getrlimit>(2), B<pthread_attr_init>(3), B<pthread_attr_setguardsize>(3), "
2259 "B<pthread_attr_setstack>(3), B<pthread_create>(3), B<pthreads>(7)"
2260 msgstr ""
2261
2262 #. type: TH
2263 #: build/C/man3/pthread_cancel.3:26
2264 #, no-wrap
2265 msgid "PTHREAD_CANCEL"
2266 msgstr ""
2267
2268 #. type: TH
2269 #: build/C/man3/pthread_cancel.3:26 build/C/man3/pthread_setschedparam.3:26
2270 #, no-wrap
2271 msgid "2008-11-17"
2272 msgstr ""
2273
2274 #. type: Plain text
2275 #: build/C/man3/pthread_cancel.3:29
2276 msgid "pthread_cancel - send a cancellation request to a thread"
2277 msgstr ""
2278
2279 #. type: Plain text
2280 #: build/C/man3/pthread_cancel.3:34
2281 #, no-wrap
2282 msgid "B<int pthread_cancel(pthread_t >I<thread>B<);>\n"
2283 msgstr ""
2284
2285 #. type: Plain text
2286 #: build/C/man3/pthread_cancel.3:49
2287 msgid ""
2288 "The B<pthread_cancel>()  function sends a cancellation request to the thread "
2289 "I<thread>.  Whether and when the target thread reacts to the cancellation "
2290 "request depends on two attributes that are under the control of that thread: "
2291 "its cancelability I<state> and I<type>."
2292 msgstr ""
2293
2294 #. type: Plain text
2295 #: build/C/man3/pthread_cancel.3:61
2296 msgid ""
2297 "A thread's cancelability state, determined by B<pthread_setcancelstate>(3), "
2298 "can be I<enabled> (the default for new threads) or I<disabled>.  If a thread "
2299 "has disabled cancellation, then a cancellation request remains queued until "
2300 "the thread enables cancellation.  If a thread has enabled cancellation, then "
2301 "its cancelability type determines when cancellation occurs."
2302 msgstr ""
2303
2304 #. type: Plain text
2305 #: build/C/man3/pthread_cancel.3:77
2306 msgid ""
2307 "A thread's cancellation type, determined by B<pthread_setcanceltype>(3), may "
2308 "be either I<asynchronous> or I<deferred> (the default for new threads).  "
2309 "Asynchronous cancelability means that the thread can be canceled at any time "
2310 "(usually immediately, but the system does not guarantee this).  Deferred "
2311 "cancelability means that cancellation will be delayed until the thread next "
2312 "calls a function that is a I<cancellation point>.  A list of functions that "
2313 "are or may be cancellation points is provided in I<pthreads>(7)."
2314 msgstr ""
2315
2316 #. type: Plain text
2317 #: build/C/man3/pthread_cancel.3:81
2318 msgid ""
2319 "When a cancellation requested is acted on, the following steps occur for "
2320 "I<thread> (in this order):"
2321 msgstr ""
2322
2323 #. type: IP
2324 #: build/C/man3/pthread_cancel.3:81 build/C/man3/pthread_cleanup_push.3:69
2325 #, no-wrap
2326 msgid "1."
2327 msgstr ""
2328
2329 #. type: Plain text
2330 #: build/C/man3/pthread_cancel.3:86
2331 msgid ""
2332 "Cancellation clean-up handlers are popped (in the reverse of the order in "
2333 "which they were pushed) and called.  (See B<pthread_cleanup_push>(3).)"
2334 msgstr ""
2335
2336 #. type: IP
2337 #: build/C/man3/pthread_cancel.3:86 build/C/man3/pthread_cleanup_push.3:73
2338 #, no-wrap
2339 msgid "2."
2340 msgstr ""
2341
2342 #. type: Plain text
2343 #: build/C/man3/pthread_cancel.3:91
2344 msgid ""
2345 "Thread-specific data destructors are called, in an unspecified order.  (See "
2346 "B<pthread_key_create>(3).)"
2347 msgstr ""
2348
2349 #. type: IP
2350 #: build/C/man3/pthread_cancel.3:91 build/C/man3/pthread_cleanup_push.3:83
2351 #, no-wrap
2352 msgid "3."
2353 msgstr ""
2354
2355 #. type: Plain text
2356 #: build/C/man3/pthread_cancel.3:95
2357 msgid "The thread is terminated.  (See B<pthread_exit>(3).)"
2358 msgstr ""
2359
2360 #. type: Plain text
2361 #: build/C/man3/pthread_cancel.3:103
2362 msgid ""
2363 "The above steps happen asynchronously with respect to the "
2364 "B<pthread_cancel>()  call; the return status of B<pthread_cancel>()  merely "
2365 "informs the caller whether the cancellation request was successfully queued."
2366 msgstr ""
2367
2368 #. type: Plain text
2369 #: build/C/man3/pthread_cancel.3:112
2370 msgid ""
2371 "After a canceled thread has terminated, a join with that thread using "
2372 "B<pthread_join>(3)  obtains B<PTHREAD_CANCELED> as the thread's exit "
2373 "status.  (Joining with a thread is the only way to know that cancellation "
2374 "has completed.)"
2375 msgstr ""
2376
2377 #. type: Plain text
2378 #: build/C/man3/pthread_cancel.3:117
2379 msgid ""
2380 "On success, B<pthread_cancel>()  returns 0; on error, it returns a nonzero "
2381 "error number."
2382 msgstr ""
2383
2384 #. type: TP
2385 #: build/C/man3/pthread_cancel.3:118 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
2386 #, no-wrap
2387 msgid "B<ESRCH>"
2388 msgstr ""
2389
2390 #. type: Plain text
2391 #: build/C/man3/pthread_cancel.3:125 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
2392 msgid "No thread with the ID I<thread> could be found."
2393 msgstr ""
2394
2395 #. type: Plain text
2396 #: build/C/man3/pthread_cancel.3:135
2397 msgid ""
2398 "On Linux, cancellation is implemented using signals.  Under the NPTL "
2399 "threading implementation, the first real-time signal (i.e., signal 32) is "
2400 "used for this purpose.  On LinuxThreads, the second real-time signal is "
2401 "used, if real-time signals are available, otherwise B<SIGUSR2> is used."
2402 msgstr ""
2403
2404 #. type: Plain text
2405 #: build/C/man3/pthread_cancel.3:141
2406 msgid ""
2407 "The program below creates a thread and then cancels it.  The main thread "
2408 "joins with the canceled thread to check that its exit status was "
2409 "B<PTHREAD_CANCELED>.  The following shell session shows what happens when we "
2410 "run the program:"
2411 msgstr ""
2412
2413 #. type: Plain text
2414 #: build/C/man3/pthread_cancel.3:149
2415 #, no-wrap
2416 msgid ""
2417 "$ ./a.out\n"
2418 "thread_func(): started; cancellation disabled\n"
2419 "main(): sending cancellation request\n"
2420 "thread_func(): about to enable cancellation\n"
2421 "main(): thread was canceled\n"
2422 msgstr ""
2423
2424 #. type: Plain text
2425 #: build/C/man3/pthread_cancel.3:159
2426 #, no-wrap
2427 msgid ""
2428 "#include E<lt>pthread.hE<gt>\n"
2429 "#include E<lt>stdio.hE<gt>\n"
2430 "#include E<lt>errno.hE<gt>\n"
2431 "#include E<lt>stdlib.hE<gt>\n"
2432 "#include E<lt>unistd.hE<gt>\n"
2433 msgstr ""
2434
2435 #. type: Plain text
2436 #: build/C/man3/pthread_cancel.3:167
2437 #, no-wrap
2438 msgid ""
2439 "static void *\n"
2440 "thread_func(void *ignored_argument)\n"
2441 "{\n"
2442 "    int s;\n"
2443 msgstr ""
2444
2445 #. type: Plain text
2446 #: build/C/man3/pthread_cancel.3:170
2447 #, no-wrap
2448 msgid ""
2449 "    /* Disable cancellation for a while, so that we don\\(aqt\n"
2450 "       immediately react to a cancellation request */\n"
2451 msgstr ""
2452
2453 #. type: Plain text
2454 #: build/C/man3/pthread_cancel.3:174
2455 #, no-wrap
2456 msgid ""
2457 "    s = pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, NULL);\n"
2458 "    if (s != 0)\n"
2459 "        handle_error_en(s, \"pthread_setcancelstate\");\n"
2460 msgstr ""
2461
2462 #. type: Plain text
2463 #: build/C/man3/pthread_cancel.3:178
2464 #, no-wrap
2465 msgid ""
2466 "    printf(\"thread_func(): started; cancellation disabled\\en\");\n"
2467 "    sleep(5);\n"
2468 "    printf(\"thread_func(): about to enable cancellation\\en\");\n"
2469 msgstr ""
2470
2471 #. type: Plain text
2472 #: build/C/man3/pthread_cancel.3:182
2473 #, no-wrap
2474 msgid ""
2475 "    s = pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL);\n"
2476 "    if (s != 0)\n"
2477 "        handle_error_en(s, \"pthread_setcancelstate\");\n"
2478 msgstr ""
2479
2480 #. type: Plain text
2481 #: build/C/man3/pthread_cancel.3:184
2482 #, no-wrap
2483 msgid "    /* sleep() is a cancellation point */\n"
2484 msgstr ""
2485
2486 #. type: Plain text
2487 #: build/C/man3/pthread_cancel.3:186
2488 #, no-wrap
2489 msgid "    sleep(1000);        /* Should get canceled while we sleep */\n"
2490 msgstr ""
2491
2492 #. type: Plain text
2493 #: build/C/man3/pthread_cancel.3:188
2494 #, no-wrap
2495 msgid "    /* Should never get here */\n"
2496 msgstr ""
2497
2498 #. type: Plain text
2499 #: build/C/man3/pthread_cancel.3:192
2500 #, no-wrap
2501 msgid ""
2502 "    printf(\"thread_func(): not canceled!\\en\");\n"
2503 "    return NULL;\n"
2504 "}\n"
2505 msgstr ""
2506
2507 #. type: Plain text
2508 #: build/C/man3/pthread_cancel.3:199
2509 #, no-wrap
2510 msgid ""
2511 "int\n"
2512 "main(void)\n"
2513 "{\n"
2514 "    pthread_t thr;\n"
2515 "    void *res;\n"
2516 "    int s;\n"
2517 msgstr ""
2518
2519 #. type: Plain text
2520 #: build/C/man3/pthread_cancel.3:201
2521 #, no-wrap
2522 msgid "    /* Start a thread and then send it a cancellation request */\n"
2523 msgstr ""
2524
2525 #. type: Plain text
2526 #: build/C/man3/pthread_cancel.3:205
2527 #, no-wrap
2528 msgid ""
2529 "    s = pthread_create(&thr, NULL, &thread_func, NULL);\n"
2530 "    if (s != 0)\n"
2531 "        handle_error_en(s, \"pthread_create\");\n"
2532 msgstr ""
2533
2534 #. type: Plain text
2535 #: build/C/man3/pthread_cancel.3:207
2536 #, no-wrap
2537 msgid "    sleep(2);           /* Give thread a chance to get started */\n"
2538 msgstr ""
2539
2540 #. type: Plain text
2541 #: build/C/man3/pthread_cancel.3:212
2542 #, no-wrap
2543 msgid ""
2544 "    printf(\"main(): sending cancellation request\\en\");\n"
2545 "    s = pthread_cancel(thr);\n"
2546 "    if (s != 0)\n"
2547 "        handle_error_en(s, \"pthread_cancel\");\n"
2548 msgstr ""
2549
2550 #. type: Plain text
2551 #: build/C/man3/pthread_cancel.3:214
2552 #, no-wrap
2553 msgid "    /* Join with thread to see what its exit status was */\n"
2554 msgstr ""
2555
2556 #. type: Plain text
2557 #: build/C/man3/pthread_cancel.3:218 build/C/man3/pthread_cleanup_push.3:307
2558 #, no-wrap
2559 msgid ""
2560 "    s = pthread_join(thr, &res);\n"
2561 "    if (s != 0)\n"
2562 "        handle_error_en(s, \"pthread_join\");\n"
2563 msgstr ""
2564
2565 #. type: Plain text
2566 #: build/C/man3/pthread_cancel.3:225
2567 #, no-wrap
2568 msgid ""
2569 "    if (res == PTHREAD_CANCELED)\n"
2570 "        printf(\"main(): thread was canceled\\en\");\n"
2571 "    else\n"
2572 "        printf(\"main(): thread wasn\\(aqt canceled (shouldn\\(aqt "
2573 "happen!)\\en\");\n"
2574 "    exit(EXIT_SUCCESS);\n"
2575 "}\n"
2576 msgstr ""
2577
2578 #. type: Plain text
2579 #: build/C/man3/pthread_cancel.3:238
2580 msgid ""
2581 "B<pthread_cleanup_push>(3), B<pthread_create>(3), B<pthread_exit>(3), "
2582 "B<pthread_join>(3), B<pthread_key_create>(3), B<pthread_setcancelstate>(3), "
2583 "B<pthread_setcanceltype>(3), B<pthread_testcancel>(3), B<pthreads>(7)"
2584 msgstr ""
2585
2586 #. type: TH
2587 #: build/C/man3/pthread_cleanup_push.3:26
2588 #, no-wrap
2589 msgid "PTHREAD_CLEANUP_PUSH"
2590 msgstr ""
2591
2592 #. type: TH
2593 #: build/C/man3/pthread_cleanup_push.3:26 build/C/man3/pthread_setcancelstate.3:26
2594 #, no-wrap
2595 msgid "2008-11-24"
2596 msgstr ""
2597
2598 #. type: Plain text
2599 #: build/C/man3/pthread_cleanup_push.3:30
2600 msgid ""
2601 "pthread_cleanup_push, pthread_cleanup_pop - push and pop thread cancellation "
2602 "clean-up handlers"
2603 msgstr ""
2604
2605 #. type: Plain text
2606 #: build/C/man3/pthread_cleanup_push.3:37
2607 #, no-wrap
2608 msgid ""
2609 "B<void pthread_cleanup_push(void (*>I<routine>B<)(void *),>\n"
2610 "B<                          void *>I<arg>B<);>\n"
2611 "B<void pthread_cleanup_pop(int >I<execute>B<);>\n"
2612 msgstr ""
2613
2614 #. type: Plain text
2615 #: build/C/man3/pthread_cleanup_push.3:48
2616 msgid ""
2617 "These functions manipulate the calling thread's stack of thread-cancellation "
2618 "clean-up handlers.  A clean-up handler is a function that is automatically "
2619 "executed when a thread is canceled (or in various other circumstances "
2620 "described below); it might, for example, unlock a mutex so that it becomes "
2621 "available to other threads in the process."
2622 msgstr ""
2623
2624 #. type: Plain text
2625 #: build/C/man3/pthread_cleanup_push.3:59
2626 msgid ""
2627 "The B<pthread_cleanup_push>()  function pushes I<routine> onto the top of "
2628 "the stack of clean-up handlers.  When I<routine> is later invoked, it will "
2629 "be given I<arg> as its argument."
2630 msgstr ""
2631
2632 #. type: Plain text
2633 #: build/C/man3/pthread_cleanup_push.3:66
2634 msgid ""
2635 "The B<pthread_cleanup_pop>()  function removes the routine at the top of the "
2636 "stack of clean-up handlers, and optionally executes it if I<execute> is "
2637 "nonzero."
2638 msgstr ""
2639
2640 #. type: Plain text
2641 #: build/C/man3/pthread_cleanup_push.3:69
2642 msgid ""
2643 "A cancellation clean-up handler is popped from the stack and executed in the "
2644 "following circumstances:"
2645 msgstr ""
2646
2647 #. type: Plain text
2648 #: build/C/man3/pthread_cleanup_push.3:73
2649 msgid ""
2650 "When a thread is canceled, all of the stacked clean-up handlers are popped "
2651 "and executed in the reverse of the order in which they were pushed onto the "
2652 "stack."
2653 msgstr ""
2654
2655 #. type: Plain text
2656 #: build/C/man3/pthread_cleanup_push.3:83
2657 msgid ""
2658 "When a thread terminates by calling B<pthread_exit>(3), all clean-up "
2659 "handlers are executed as described in the preceding point.  (Clean-up "
2660 "handlers are I<not> called if the thread terminates by performing a "
2661 "I<return> from the thread start function.)"
2662 msgstr ""
2663
2664 #. type: Plain text
2665 #: build/C/man3/pthread_cleanup_push.3:89
2666 msgid ""
2667 "When a thread calls B<pthread_cleanup_pop>()  with a nonzero I<execute> "
2668 "argument, the top-most clean-up handler is popped and executed."
2669 msgstr ""
2670
2671 #. type: Plain text
2672 #: build/C/man3/pthread_cleanup_push.3:101
2673 msgid ""
2674 "POSIX.1 permits B<pthread_cleanup_push>()  and B<pthread_cleanup_pop>()  to "
2675 "be implemented as macros that expand to text containing \\(aqB<{>\\(aq and "
2676 "\\(aqB<}>\\(aq, respectively.  For this reason, the caller must ensure that "
2677 "calls to these functions are paired within the same function, and at the "
2678 "same lexical nesting level.  (In other words, a clean-up handler is "
2679 "established only during the execution of a specified section of code.)"
2680 msgstr ""
2681
2682 #. type: Plain text
2683 #: build/C/man3/pthread_cleanup_push.3:121
2684 msgid ""
2685 "Calling B<longjmp>(3)  (B<siglongjmp>(3))  produces undefined results if any "
2686 "call has been made to B<pthread_cleanup_push>()  or B<pthread_cleanup_pop>()  "
2687 "without the matching call of the pair since the jump buffer was filled by "
2688 "B<setjmp>(3)  (B<sigsetjmp>(3)).  Likewise, calling B<longjmp>(3)  "
2689 "(B<siglongjmp>(3))  from inside a clean-up handler produces undefined "
2690 "results unless the jump buffer was also filled by B<setjmp>(3)  "
2691 "(B<sigsetjmp>(3))  inside the handler."
2692 msgstr ""
2693
2694 #. type: Plain text
2695 #: build/C/man3/pthread_cleanup_push.3:123
2696 msgid "These functions do not return a value."
2697 msgstr ""
2698
2699 #.  SH VERSIONS
2700 #.  Available since glibc 2.0
2701 #. type: Plain text
2702 #: build/C/man3/pthread_cleanup_push.3:127
2703 msgid "There are no errors."
2704 msgstr ""
2705
2706 #. type: Plain text
2707 #: build/C/man3/pthread_cleanup_push.3:140
2708 msgid ""
2709 "On Linux, the B<pthread_cleanup_push>()  and B<pthread_cleanup_pop>()  "
2710 "functions I<are> implemented as macros that expand to text containing "
2711 "\\(aqB<{>\\(aq and \\(aqB<}>\\(aq, respectively.  This means that variables "
2712 "declared within the scope of paired calls to these functions will be visible "
2713 "within only that scope."
2714 msgstr ""
2715
2716 #.  The text was actually added in the 2004 TC2
2717 #. type: Plain text
2718 #: build/C/man3/pthread_cleanup_push.3:155
2719 msgid ""
2720 "POSIX.1 says that the effect of using I<return>, I<break>, I<continue>, or "
2721 "I<goto> to prematurely leave a block bracketed B<pthread_cleanup_push>()  "
2722 "and B<pthread_cleanup_pop>()  is undefined.  Portable applications should "
2723 "avoid doing this."
2724 msgstr ""
2725
2726 #. type: Plain text
2727 #: build/C/man3/pthread_cleanup_push.3:170
2728 msgid ""
2729 "The program below provides a simple example of the use of the functions "
2730 "described in this page.  The program creates a thread that executes a loop "
2731 "bracketed by B<pthread_cleanup_push>()  and B<pthread_cleanup_pop>().  This "
2732 "loop increments a global variable, I<cnt>, once each second.  Depending on "
2733 "what command-line arguments are supplied, the main thread sends the other "
2734 "thread a cancellation request, or sets a global variable that causes the "
2735 "other thread to exit its loop and terminate normally (by doing a I<return>)."
2736 msgstr ""
2737
2738 #. type: Plain text
2739 #: build/C/man3/pthread_cleanup_push.3:173
2740 msgid ""
2741 "In the following shell session, the main thread sends a cancellation request "
2742 "to the other thread:"
2743 msgstr ""
2744
2745 #. type: Plain text
2746 #: build/C/man3/pthread_cleanup_push.3:183
2747 #, no-wrap
2748 msgid ""
2749 "$ B<./a.out>\n"
2750 "New thread started\n"
2751 "cnt = 0\n"
2752 "cnt = 1\n"
2753 "Canceling thread\n"
2754 "Called clean-up handler\n"
2755 "Thread was canceled; cnt = 0\n"
2756 msgstr ""
2757
2758 #. type: Plain text
2759 #: build/C/man3/pthread_cleanup_push.3:191
2760 msgid ""
2761 "From the above, we see that the thread was canceled, and that the "
2762 "cancellation clean-up handler was called and it reset the value of the "
2763 "global variable I<cnt> to 0."
2764 msgstr ""
2765
2766 #. type: Plain text
2767 #: build/C/man3/pthread_cleanup_push.3:194
2768 msgid ""
2769 "In the next run, the main program sets a global variable that causes other "
2770 "thread to terminate normally:"
2771 msgstr ""
2772
2773 #. type: Plain text
2774 #: build/C/man3/pthread_cleanup_push.3:202
2775 #, no-wrap
2776 msgid ""
2777 "$ B<./a.out x>\n"
2778 "New thread started\n"
2779 "cnt = 0\n"
2780 "cnt = 1\n"
2781 "Thread terminated normally; cnt = 2\n"
2782 msgstr ""
2783
2784 #. type: Plain text
2785 #: build/C/man3/pthread_cleanup_push.3:210
2786 msgid ""
2787 "From the above, we see that the clean-up handler was not executed (because "
2788 "I<cleanup_pop_arg> was 0), and therefore the value of I<cnt> was not reset."
2789 msgstr ""
2790
2791 #. type: Plain text
2792 #: build/C/man3/pthread_cleanup_push.3:215
2793 msgid ""
2794 "In the next run, the main program sets a global variable that causes the "
2795 "other thread to terminate normally, and supplies a nonzero value for "
2796 "I<cleanup_pop_arg>:"
2797 msgstr ""
2798
2799 #. type: Plain text
2800 #: build/C/man3/pthread_cleanup_push.3:224
2801 #, no-wrap
2802 msgid ""
2803 "$ B<./a.out x 1>\n"
2804 "New thread started\n"
2805 "cnt = 0\n"
2806 "cnt = 1\n"
2807 "Called clean-up handler\n"
2808 "Thread terminated normally; cnt = 0\n"
2809 msgstr ""
2810
2811 #. type: Plain text
2812 #: build/C/man3/pthread_cleanup_push.3:231
2813 msgid ""
2814 "In the above, we see that although the thread was not canceled, the clean-up "
2815 "handler was executed, because the argument given to B<pthread_cleanup_pop>()  "
2816 "was nonzero."
2817 msgstr ""
2818
2819 #. type: Plain text
2820 #: build/C/man3/pthread_cleanup_push.3:240
2821 #, no-wrap
2822 msgid ""
2823 "#include E<lt>pthread.hE<gt>\n"
2824 "#include E<lt>sys/types.hE<gt>\n"
2825 "#include E<lt>stdio.hE<gt>\n"
2826 "#include E<lt>stdlib.hE<gt>\n"
2827 "#include E<lt>unistd.hE<gt>\n"
2828 "#include E<lt>errno.hE<gt>\n"
2829 msgstr ""
2830
2831 #. type: Plain text
2832 #: build/C/man3/pthread_cleanup_push.3:247
2833 #, no-wrap
2834 msgid ""
2835 "static int done = 0;\n"
2836 "static int cleanup_pop_arg = 0;\n"
2837 "static int cnt = 0;\n"
2838 msgstr ""
2839
2840 #. type: Plain text
2841 #: build/C/man3/pthread_cleanup_push.3:254
2842 #, no-wrap
2843 msgid ""
2844 "static void\n"
2845 "cleanup_handler(void *arg)\n"
2846 "{\n"
2847 "    printf(\"Called clean-up handler\\en\");\n"
2848 "    cnt = 0;\n"
2849 "}\n"
2850 msgstr ""
2851
2852 #. type: Plain text
2853 #: build/C/man3/pthread_cleanup_push.3:259
2854 #, no-wrap
2855 msgid ""
2856 "static void *\n"
2857 "thread_start(void *arg)\n"
2858 "{\n"
2859 "    time_t start, curr;\n"
2860 msgstr ""
2861
2862 #. type: Plain text
2863 #: build/C/man3/pthread_cleanup_push.3:261
2864 #, no-wrap
2865 msgid "    printf(\"New thread started\\en\");\n"
2866 msgstr ""
2867
2868 #. type: Plain text
2869 #: build/C/man3/pthread_cleanup_push.3:263
2870 #, no-wrap
2871 msgid "    pthread_cleanup_push(cleanup_handler, NULL);\n"
2872 msgstr ""
2873
2874 #. type: Plain text
2875 #: build/C/man3/pthread_cleanup_push.3:265
2876 #, no-wrap
2877 msgid "    curr = start = time(NULL);\n"
2878 msgstr ""
2879
2880 #. type: Plain text
2881 #: build/C/man3/pthread_cleanup_push.3:274
2882 #, no-wrap
2883 msgid ""
2884 "    while (!done) {\n"
2885 "        pthread_testcancel();           /* A cancellation point */\n"
2886 "        if (curr E<lt> time(NULL)) {\n"
2887 "            curr = time(NULL);\n"
2888 "            printf(\"cnt = %d\\en\", cnt);  /* A cancellation point */\n"
2889 "            cnt++;\n"
2890 "        }\n"
2891 "    }\n"
2892 msgstr ""
2893
2894 #. type: Plain text
2895 #: build/C/man3/pthread_cleanup_push.3:278
2896 #, no-wrap
2897 msgid ""
2898 "    pthread_cleanup_pop(cleanup_pop_arg);\n"
2899 "    return NULL;\n"
2900 "}\n"
2901 msgstr ""
2902
2903 #. type: Plain text
2904 #: build/C/man3/pthread_cleanup_push.3:285
2905 #, no-wrap
2906 msgid ""
2907 "int\n"
2908 "main(int argc, char *argv[])\n"
2909 "{\n"
2910 "    pthread_t thr;\n"
2911 "    int s;\n"
2912 "    void *res;\n"
2913 msgstr ""
2914
2915 #. type: Plain text
2916 #: build/C/man3/pthread_cleanup_push.3:289
2917 #, no-wrap
2918 msgid ""
2919 "    s = pthread_create(&thr, NULL, thread_start, NULL);\n"
2920 "    if (s != 0)\n"
2921 "        handle_error_en(s, \"pthread_create\");\n"
2922 msgstr ""
2923
2924 #. type: Plain text
2925 #: build/C/man3/pthread_cleanup_push.3:291
2926 #, no-wrap
2927 msgid "    sleep(2);           /* Allow new thread to run a while */\n"
2928 msgstr ""
2929
2930 #. type: Plain text
2931 #: build/C/man3/pthread_cleanup_push.3:296
2932 #, no-wrap
2933 msgid ""
2934 "    if (argc E<gt> 1) {\n"
2935 "        if (argc E<gt> 2)\n"
2936 "            cleanup_pop_arg = atoi(argv[2]);\n"
2937 "        done = 1;\n"
2938 msgstr ""
2939
2940 #. type: Plain text
2941 #: build/C/man3/pthread_cleanup_push.3:303
2942 #, no-wrap
2943 msgid ""
2944 "    } else {\n"
2945 "        printf(\"Canceling thread\\en\");\n"
2946 "        s = pthread_cancel(thr);\n"
2947 "        if (s != 0)\n"
2948 "            handle_error_en(s, \"pthread_cancel\");\n"
2949 "    }\n"
2950 msgstr ""
2951
2952 #. type: Plain text
2953 #: build/C/man3/pthread_cleanup_push.3:314
2954 #, no-wrap
2955 msgid ""
2956 "    if (res == PTHREAD_CANCELED)\n"
2957 "        printf(\"Thread was canceled; cnt = %d\\en\", cnt);\n"
2958 "    else\n"
2959 "        printf(\"Thread terminated normally; cnt = %d\\en\", cnt);\n"
2960 "    exit(EXIT_SUCCESS);\n"
2961 "}\n"
2962 msgstr ""
2963
2964 #. type: Plain text
2965 #: build/C/man3/pthread_cleanup_push.3:321
2966 msgid ""
2967 "B<pthread_cancel>(3), B<pthread_cleanup_push_defer_np>(3), "
2968 "B<pthread_setcancelstate>(3), B<pthread_testcancel>(3), B<pthreads>(7)"
2969 msgstr ""
2970
2971 #. type: TH
2972 #: build/C/man3/pthread_cleanup_push_defer_np.3:26
2973 #, no-wrap
2974 msgid "PTHREAD_CLEANUP_PUSH_DEFER_NP"
2975 msgstr ""
2976
2977 #. type: TH
2978 #: build/C/man3/pthread_cleanup_push_defer_np.3:26
2979 #, no-wrap
2980 msgid "2008-12-04"
2981 msgstr ""
2982
2983 #. type: Plain text
2984 #: build/C/man3/pthread_cleanup_push_defer_np.3:30
2985 msgid ""
2986 "pthread_cleanup_push_defer_np, pthread_cleanup_pop_restore_np - push and pop "
2987 "thread cancellation clean-up handlers while saving cancelability type"
2988 msgstr ""
2989
2990 #. type: Plain text
2991 #: build/C/man3/pthread_cleanup_push_defer_np.3:37
2992 #, no-wrap
2993 msgid ""
2994 "B<void pthread_cleanup_push_defer_np(void (*>I<routine>B<)(void *),>\n"
2995 "B<                                   void *>I<arg>B<);>\n"
2996 "B<void pthread_cleanup_pop_restore_np(int >I<execute>B<);>\n"
2997 msgstr ""
2998
2999 #. type: Plain text
3000 #: 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
3001 msgid "Compile and link with I<-pthread>."
3002 msgstr ""
3003
3004 #. type: Plain text
3005 #: build/C/man3/pthread_cleanup_push_defer_np.3:46
3006 msgid ""
3007 "These functions are the same as B<pthread_cleanup_push>(3)  and "
3008 "B<pthread_cleanup_pop>(3), except for the differences noted on this page."
3009 msgstr ""
3010
3011 #. type: Plain text
3012 #: build/C/man3/pthread_cleanup_push_defer_np.3:59
3013 msgid ""
3014 "Like B<pthread_cleanup_push>(3), B<pthread_cleanup_push_defer_np>()  pushes "
3015 "I<routine> onto the thread's stack of cancellation clean-up handlers.  In "
3016 "addition, it also saves the thread's current cancelability type, and sets "
3017 "the cancelability type to \"deferred\" (see B<pthread_setcanceltype>(3)); "
3018 "this ensures that cancellation clean-up will occur even if the thread's "
3019 "cancelability type was \"asynchronous\" before the call."
3020 msgstr ""
3021
3022 #. type: Plain text
3023 #: build/C/man3/pthread_cleanup_push_defer_np.3:68
3024 msgid ""
3025 "Like B<pthread_cleanup_pop>(3), B<pthread_cleanup_pop_restore_np>()  pops "
3026 "the top-most clean-up handler from the thread's stack of cancellation "
3027 "clean-up handlers.  In addition, it restores the thread's cancelability type "
3028 "to its value at the time of the matching B<pthread_cleanup_push_defer_np>()."
3029 msgstr ""
3030
3031 #. type: Plain text
3032 #: build/C/man3/pthread_cleanup_push_defer_np.3:74
3033 msgid ""
3034 "The caller must ensure that calls to these functions are paired within the "
3035 "same function, and at the same lexical nesting level.  Other restrictions "
3036 "apply, as described in B<pthread_cleanup_push>(3)."
3037 msgstr ""
3038
3039 #. type: Plain text
3040 #: build/C/man3/pthread_cleanup_push_defer_np.3:76
3041 msgid "This sequence of calls:"
3042 msgstr ""
3043
3044 #. type: Plain text
3045 #: build/C/man3/pthread_cleanup_push_defer_np.3:81
3046 #, no-wrap
3047 msgid ""
3048 "pthread_cleanup_push_defer_np(routine, arg);\n"
3049 "pthread_cleanup_pop_restore_np(execute);\n"
3050 msgstr ""
3051
3052 #. type: Plain text
3053 #: build/C/man3/pthread_cleanup_push_defer_np.3:85
3054 msgid "is equivalent to (but shorter and more efficient than):"
3055 msgstr ""
3056
3057 #. type: Plain text
3058 #: build/C/man3/pthread_cleanup_push_defer_np.3:91
3059 #, no-wrap
3060 msgid "int oldtype;\n"
3061 msgstr ""
3062
3063 #. type: Plain text
3064 #: build/C/man3/pthread_cleanup_push_defer_np.3:97
3065 #, no-wrap
3066 msgid ""
3067 "pthread_cleanup_push(routine, arg);\n"
3068 "pthread_setcanceltype(PTHREAD_CANCEL_DEFERRED, &oldtype);\n"
3069 "\\&...\n"
3070 "pthread_setcanceltype(oldtype, NULL);\n"
3071 "pthread_cleanup_pop(execute);\n"
3072 msgstr ""
3073
3074 #. type: Plain text
3075 #: build/C/man3/pthread_cleanup_push_defer_np.3:110
3076 msgid ""
3077 "B<pthread_cancel>(3), B<pthread_cleanup_push>(3), "
3078 "B<pthread_setcancelstate>(3), B<pthread_testcancel>(3), B<pthreads>(7)"
3079 msgstr ""
3080
3081 #. type: TH
3082 #: build/C/man3/pthread_create.3:26
3083 #, no-wrap
3084 msgid "PTHREAD_CREATE"
3085 msgstr ""
3086
3087 #. type: TH
3088 #: build/C/man3/pthread_create.3:26 build/C/man3/pthread_sigmask.3:26
3089 #, no-wrap
3090 msgid "2012-08-03"
3091 msgstr ""
3092
3093 #. type: Plain text
3094 #: build/C/man3/pthread_create.3:29
3095 msgid "pthread_create - create a new thread"
3096 msgstr ""
3097
3098 #. type: Plain text
3099 #: build/C/man3/pthread_create.3:35
3100 #, no-wrap
3101 msgid ""
3102 "B<int pthread_create(pthread_t *>I<thread>B<, const pthread_attr_t "
3103 "*>I<attr>B<,>\n"
3104 "B<                   void *(*>I<start_routine>B<) (void *), void "
3105 "*>I<arg>B<);>\n"
3106 msgstr ""
3107
3108 #. type: Plain text
3109 #: build/C/man3/pthread_create.3:47
3110 msgid ""
3111 "The B<pthread_create>()  function starts a new thread in the calling "
3112 "process.  The new thread starts execution by invoking I<start_routine>(); "
3113 "I<arg> is passed as the sole argument of I<start_routine>()."
3114 msgstr ""
3115
3116 #. type: Plain text
3117 #: build/C/man3/pthread_create.3:49
3118 msgid "The new thread terminates in one of the following ways:"
3119 msgstr ""
3120
3121 #. type: IP
3122 #: 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
3123 #, no-wrap
3124 msgid "*"
3125 msgstr ""
3126
3127 #. type: Plain text
3128 #: build/C/man3/pthread_create.3:55
3129 msgid ""
3130 "It calls B<pthread_exit>(3), specifying an exit status value that is "
3131 "available to another thread in the same process that calls "
3132 "B<pthread_join>(3)."
3133 msgstr ""
3134
3135 #. type: Plain text
3136 #: build/C/man3/pthread_create.3:63
3137 msgid ""
3138 "It returns from I<start_routine>().  This is equivalent to calling "
3139 "B<pthread_exit>(3)  with the value supplied in the I<return> statement."
3140 msgstr ""
3141
3142 #. type: Plain text
3143 #: build/C/man3/pthread_create.3:66
3144 msgid "It is canceled (see B<pthread_cancel>(3))."
3145 msgstr ""
3146
3147 #. type: Plain text
3148 #: build/C/man3/pthread_create.3:72
3149 msgid ""
3150 "Any of the threads in the process calls B<exit>(3), or the main thread "
3151 "performs a return from I<main>().  This causes the termination of all "
3152 "threads in the process."
3153 msgstr ""
3154
3155 #. type: Plain text
3156 #: build/C/man3/pthread_create.3:86
3157 msgid ""
3158 "The I<attr> argument points to a I<pthread_attr_t> structure whose contents "
3159 "are used at thread creation time to determine attributes for the new thread; "
3160 "this structure is initialized using B<pthread_attr_init>(3)  and related "
3161 "functions.  If I<attr> is NULL, then the thread is created with default "
3162 "attributes."
3163 msgstr ""
3164
3165 #. type: Plain text
3166 #: build/C/man3/pthread_create.3:93
3167 msgid ""
3168 "Before returning, a successful call to B<pthread_create>()  stores the ID of "
3169 "the new thread in the buffer pointed to by I<thread>; this identifier is "
3170 "used to refer to the thread in subsequent calls to other pthreads functions."
3171 msgstr ""
3172
3173 #. type: Plain text
3174 #: build/C/man3/pthread_create.3:101
3175 msgid ""
3176 "The new thread inherits a copy of the creating thread's signal mask "
3177 "(B<pthread_sigmask>(3)).  The set of pending signals for the new thread is "
3178 "empty (B<sigpending>(2)).  The new thread does not inherit the creating "
3179 "thread's alternate signal stack (B<sigaltstack>(2))."
3180 msgstr ""
3181
3182 #. type: Plain text
3183 #: build/C/man3/pthread_create.3:104
3184 msgid ""
3185 "The new thread inherits the calling thread's floating-point environment "
3186 "(B<fenv>(3))."
3187 msgstr ""
3188
3189 #.  CLOCK_THREAD_CPUTIME_ID in clock_gettime(2)
3190 #. type: Plain text
3191 #: build/C/man3/pthread_create.3:109
3192 msgid ""
3193 "The initial value of the new thread's CPU-time clock is 0 (see "
3194 "B<pthread_getcpuclockid>(3))."
3195 msgstr ""
3196
3197 #. type: SS
3198 #: build/C/man3/pthread_create.3:109
3199 #, no-wrap
3200 msgid "Linux-specific details"
3201 msgstr ""
3202
3203 #. type: Plain text
3204 #: build/C/man3/pthread_create.3:115
3205 msgid ""
3206 "The new thread inherits copies of the calling thread's capability sets (see "
3207 "B<capabilities>(7))  and CPU affinity mask (see B<sched_setaffinity>(2))."
3208 msgstr ""
3209
3210 #. type: Plain text
3211 #: build/C/man3/pthread_create.3:122
3212 msgid ""
3213 "On success, B<pthread_create>()  returns 0; on error, it returns an error "
3214 "number, and the contents of I<*thread> are undefined."
3215 msgstr ""
3216
3217 #. type: TP
3218 #: build/C/man3/pthread_create.3:123 build/C/man3/pthread_sigqueue.3:71
3219 #, no-wrap
3220 msgid "B<EAGAIN>"
3221 msgstr ""
3222
3223 #. type: Plain text
3224 #: build/C/man3/pthread_create.3:137
3225 msgid ""
3226 "Insufficient resources to create another thread, or a system-imposed limit "
3227 "on the number of threads was encountered.  The latter case may occur in two "
3228 "ways: the B<RLIMIT_NPROC> soft resource limit (set via B<setrlimit>(2)), "
3229 "which limits the number of process for a real user ID, was reached; or the "
3230 "kernel's system-wide limit on the number of threads, "
3231 "I</proc/sys/kernel/threads-max>, was reached."
3232 msgstr ""
3233
3234 #. type: Plain text
3235 #: build/C/man3/pthread_create.3:141
3236 msgid "Invalid settings in I<attr>."
3237 msgstr ""
3238
3239 #. type: TP
3240 #: build/C/man3/pthread_create.3:141 build/C/man3/pthread_setschedparam.3:129 build/C/man3/pthread_setschedprio.3:66
3241 #, no-wrap
3242 msgid "B<EPERM>"
3243 msgstr ""
3244
3245 #. type: Plain text
3246 #: build/C/man3/pthread_create.3:146
3247 msgid ""
3248 "No permission to set the scheduling policy and parameters specified in "
3249 "I<attr>."
3250 msgstr ""
3251
3252 #. type: Plain text
3253 #: build/C/man3/pthread_create.3:160
3254 msgid ""
3255 "See B<pthread_self>(3)  for further information on the thread ID returned in "
3256 "I<*thread> by B<pthread_create>().  Unless real-time scheduling policies are "
3257 "being employed, after a call to B<pthread_create>(), it is indeterminate "
3258 "which thread\\(emthe caller or the new thread\\(emwill next execute."
3259 msgstr ""
3260
3261 #. type: Plain text
3262 #: build/C/man3/pthread_create.3:180
3263 msgid ""
3264 "A thread may either be I<joinable> or I<detached>.  If a thread is joinable, "
3265 "then another thread can call B<pthread_join>(3)  to wait for the thread to "
3266 "terminate and fetch its exit status.  Only when a terminated joinable thread "
3267 "has been joined are the last of its resources released back to the system.  "
3268 "When a detached thread terminates, its resources are automatically released "
3269 "back to the system: it is not possible to join with the thread in order to "
3270 "obtain its exit status.  Making a thread detached is useful for some types "
3271 "of daemon threads whose exit status the application does not need to care "
3272 "about.  By default, a new thread is created in a joinable state, unless "
3273 "I<attr> was set to create the thread in a detached state (using "
3274 "B<pthread_attr_setdetachstate>(3))."
3275 msgstr ""
3276
3277 #.  FIXME . Perhaps some of the following detail should be in
3278 #.  a future pthread_attr_setstacksize(3) page.
3279 #. type: Plain text
3280 #: build/C/man3/pthread_create.3:196
3281 msgid ""
3282 "On Linux/x86-32, the default stack size for a new thread is 2 megabytes.  "
3283 "Under the NPTL threading implementation, if the B<RLIMIT_STACK> soft "
3284 "resource limit I<at the time the program started> has any value other than "
3285 "\"unlimited\", then it determines the default stack size of new threads.  "
3286 "Using B<pthread_attr_setstacksize>(3), the stack size attribute can be "
3287 "explicitly set in the I<attr> argument used to create a thread, in order to "
3288 "obtain a stack size other than the default."
3289 msgstr ""
3290
3291 #. type: Plain text
3292 #: build/C/man3/pthread_create.3:202
3293 msgid ""
3294 "In the obsolete LinuxThreads implementation, each of the threads in a "
3295 "process has a different process ID.  This is in violation of the POSIX "
3296 "threads specification, and is the source of many other nonconformances to "
3297 "the standard; see B<pthreads>(7)."
3298 msgstr ""
3299
3300 #. type: Plain text
3301 #: build/C/man3/pthread_create.3:206
3302 msgid ""
3303 "The program below demonstrates the use of B<pthread_create>(), as well as a "
3304 "number of other functions in the pthreads API."
3305 msgstr ""
3306
3307 #. type: Plain text
3308 #: build/C/man3/pthread_create.3:211
3309 msgid ""
3310 "In the following run, on a system providing the NPTL threading "
3311 "implementation, the stack size defaults to the value given by the \"stack "
3312 "size\" resource limit:"
3313 msgstr ""
3314
3315 #. type: Plain text
3316 #: build/C/man3/pthread_create.3:223
3317 #, no-wrap
3318 msgid ""
3319 "$B< ulimit -s>\n"
3320 "8192            # The stack size limit is 8 MB (0x800000 bytes)\n"
3321 "$B< ./a.out hola salut servus>\n"
3322 "Thread 1: top of stack near 0xb7dd03b8; argv_string=hola\n"
3323 "Thread 2: top of stack near 0xb75cf3b8; argv_string=salut\n"
3324 "Thread 3: top of stack near 0xb6dce3b8; argv_string=servus\n"
3325 "Joined with thread 1; returned value was HOLA\n"
3326 "Joined with thread 2; returned value was SALUT\n"
3327 "Joined with thread 3; returned value was SERVUS\n"
3328 msgstr ""
3329
3330 #. type: Plain text
3331 #: build/C/man3/pthread_create.3:229
3332 msgid ""
3333 "In the next run, the program explicitly sets a stack size of 1MB (using "
3334 "B<pthread_attr_setstacksize>(3))  for the created threads:"
3335 msgstr ""
3336
3337 #. type: Plain text
3338 #: build/C/man3/pthread_create.3:239
3339 #, no-wrap
3340 msgid ""
3341 "$B< ./a.out -s 0x100000 hola salut servus>\n"
3342 "Thread 1: top of stack near 0xb7d723b8; argv_string=hola\n"
3343 "Thread 2: top of stack near 0xb7c713b8; argv_string=salut\n"
3344 "Thread 3: top of stack near 0xb7b703b8; argv_string=servus\n"
3345 "Joined with thread 1; returned value was HOLA\n"
3346 "Joined with thread 2; returned value was SALUT\n"
3347 "Joined with thread 3; returned value was SERVUS\n"
3348 msgstr ""
3349
3350 #. type: Plain text
3351 #: build/C/man3/pthread_create.3:251
3352 #, no-wrap
3353 msgid ""
3354 "#include E<lt>pthread.hE<gt>\n"
3355 "#include E<lt>string.hE<gt>\n"
3356 "#include E<lt>stdio.hE<gt>\n"
3357 "#include E<lt>stdlib.hE<gt>\n"
3358 "#include E<lt>unistd.hE<gt>\n"
3359 "#include E<lt>errno.hE<gt>\n"
3360 "#include E<lt>ctype.hE<gt>\n"
3361 msgstr ""
3362
3363 #. type: Plain text
3364 #: build/C/man3/pthread_create.3:257 build/C/man3/pthread_getcpuclockid.3:110
3365 #, no-wrap
3366 msgid ""
3367 "#define handle_error(msg) \\e\n"
3368 "        do { perror(msg); exit(EXIT_FAILURE); } while (0)\n"
3369 msgstr ""
3370
3371 #. type: Plain text
3372 #: build/C/man3/pthread_create.3:263
3373 #, no-wrap
3374 msgid ""
3375 "struct thread_info {    /* Used as argument to thread_start() */\n"
3376 "    pthread_t thread_id;        /* ID returned by pthread_create() */\n"
3377 "    int       thread_num;       /* Application-defined thread # */\n"
3378 "    char     *argv_string;      /* From command-line argument */\n"
3379 "};\n"
3380 msgstr ""
3381
3382 #. type: Plain text
3383 #: build/C/man3/pthread_create.3:266
3384 #, no-wrap
3385 msgid ""
3386 "/* Thread start function: display address near top of our stack,\n"
3387 "   and return upper-cased copy of argv_string */\n"
3388 msgstr ""
3389
3390 #. type: Plain text
3391 #: build/C/man3/pthread_create.3:272
3392 #, no-wrap
3393 msgid ""
3394 "static void *\n"
3395 "thread_start(void *arg)\n"
3396 "{\n"
3397 "    struct thread_info *tinfo = arg;\n"
3398 "    char *uargv, *p;\n"
3399 msgstr ""
3400
3401 #. type: Plain text
3402 #: build/C/man3/pthread_create.3:275
3403 #, no-wrap
3404 msgid ""
3405 "    printf(\"Thread %d: top of stack near %p; argv_string=%s\\en\",\n"
3406 "            tinfo-E<gt>thread_num, &p, tinfo-E<gt>argv_string);\n"
3407 msgstr ""
3408
3409 #. type: Plain text
3410 #: build/C/man3/pthread_create.3:279
3411 #, no-wrap
3412 msgid ""
3413 "    uargv = strdup(tinfo-E<gt>argv_string);\n"
3414 "    if (uargv == NULL)\n"
3415 "        handle_error(\"strdup\");\n"
3416 msgstr ""
3417
3418 #. type: Plain text
3419 #: build/C/man3/pthread_create.3:282
3420 #, no-wrap
3421 msgid ""
3422 "    for (p = uargv; *p != \\(aq\\e0\\(aq; p++)\n"
3423 "        *p = toupper(*p);\n"
3424 msgstr ""
3425
3426 #. type: Plain text
3427 #: build/C/man3/pthread_create.3:285
3428 #, no-wrap
3429 msgid ""
3430 "    return uargv;\n"
3431 "}\n"
3432 msgstr ""
3433
3434 #. type: Plain text
3435 #: build/C/man3/pthread_create.3:294
3436 #, no-wrap
3437 msgid ""
3438 "int\n"
3439 "main(int argc, char *argv[])\n"
3440 "{\n"
3441 "    int s, tnum, opt, num_threads;\n"
3442 "    struct thread_info *tinfo;\n"
3443 "    pthread_attr_t attr;\n"
3444 "    int stack_size;\n"
3445 "    void *res;\n"
3446 msgstr ""
3447
3448 #. type: Plain text
3449 #: build/C/man3/pthread_create.3:296
3450 #, no-wrap
3451 msgid "    /* The \"-s\" option specifies a stack size for our threads */\n"
3452 msgstr ""
3453
3454 #. type: Plain text
3455 #: build/C/man3/pthread_create.3:303
3456 #, no-wrap
3457 msgid ""
3458 "    stack_size = -1;\n"
3459 "    while ((opt = getopt(argc, argv, \"s:\")) != -1) {\n"
3460 "        switch (opt) {\n"
3461 "        case \\(aqs\\(aq:\n"
3462 "            stack_size = strtoul(optarg, NULL, 0);\n"
3463 "            break;\n"
3464 msgstr ""
3465
3466 #. type: Plain text
3467 #: build/C/man3/pthread_create.3:310
3468 #, no-wrap
3469 msgid ""
3470 "        default:\n"
3471 "            fprintf(stderr, \"Usage: %s [-s stack-size] arg...\\en\",\n"
3472 "                    argv[0]);\n"
3473 "            exit(EXIT_FAILURE);\n"
3474 "        }\n"
3475 "    }\n"
3476 msgstr ""
3477
3478 #. type: Plain text
3479 #: build/C/man3/pthread_create.3:312
3480 #, no-wrap
3481 msgid "    num_threads = argc - optind;\n"
3482 msgstr ""
3483
3484 #. type: Plain text
3485 #: build/C/man3/pthread_create.3:314
3486 #, no-wrap
3487 msgid "    /* Initialize thread creation attributes */\n"
3488 msgstr ""
3489
3490 #. type: Plain text
3491 #: build/C/man3/pthread_create.3:318
3492 #, no-wrap
3493 msgid ""
3494 "    s = pthread_attr_init(&attr);\n"
3495 "    if (s != 0)\n"
3496 "        handle_error_en(s, \"pthread_attr_init\");\n"
3497 msgstr ""
3498
3499 #. type: Plain text
3500 #: build/C/man3/pthread_create.3:324
3501 #, no-wrap
3502 msgid ""
3503 "    if (stack_size E<gt> 0) {\n"
3504 "        s = pthread_attr_setstacksize(&attr, stack_size);\n"
3505 "        if (s != 0)\n"
3506 "            handle_error_en(s, \"pthread_attr_setstacksize\");\n"
3507 "    }\n"
3508 msgstr ""
3509
3510 #. type: Plain text
3511 #: build/C/man3/pthread_create.3:326
3512 #, no-wrap
3513 msgid "    /* Allocate memory for pthread_create() arguments */\n"
3514 msgstr ""
3515
3516 #. type: Plain text
3517 #: build/C/man3/pthread_create.3:330
3518 #, no-wrap
3519 msgid ""
3520 "    tinfo = calloc(num_threads, sizeof(struct thread_info));\n"
3521 "    if (tinfo == NULL)\n"
3522 "        handle_error(\"calloc\");\n"
3523 msgstr ""
3524
3525 #. type: Plain text
3526 #: build/C/man3/pthread_create.3:332
3527 #, no-wrap
3528 msgid "    /* Create one thread for each command-line argument */\n"
3529 msgstr ""
3530
3531 #. type: Plain text
3532 #: build/C/man3/pthread_create.3:336
3533 #, no-wrap
3534 msgid ""
3535 "    for (tnum = 0; tnum E<lt> num_threads; tnum++) {\n"
3536 "        tinfo[tnum].thread_num = tnum + 1;\n"
3537 "        tinfo[tnum].argv_string = argv[optind + tnum];\n"
3538 msgstr ""
3539
3540 #. type: Plain text
3541 #: build/C/man3/pthread_create.3:339
3542 #, no-wrap
3543 msgid ""
3544 "        /* The pthread_create() call stores the thread ID into\n"
3545 "           corresponding element of tinfo[] */\n"
3546 msgstr ""
3547
3548 #. type: Plain text
3549 #: build/C/man3/pthread_create.3:345
3550 #, no-wrap
3551 msgid ""
3552 "        s = pthread_create(&tinfo[tnum].thread_id, &attr,\n"
3553 "                           &thread_start, &tinfo[tnum]);\n"
3554 "        if (s != 0)\n"
3555 "            handle_error_en(s, \"pthread_create\");\n"
3556 "    }\n"
3557 msgstr ""
3558
3559 #. type: Plain text
3560 #: build/C/man3/pthread_create.3:348
3561 #, no-wrap
3562 msgid ""
3563 "    /* Destroy the thread attributes object, since it is no\n"
3564 "       longer needed */\n"
3565 msgstr ""
3566
3567 #. type: Plain text
3568 #: build/C/man3/pthread_create.3:352 build/C/man3/pthread_setschedparam.3:423
3569 #, no-wrap
3570 msgid ""
3571 "    s = pthread_attr_destroy(&attr);\n"
3572 "    if (s != 0)\n"
3573 "        handle_error_en(s, \"pthread_attr_destroy\");\n"
3574 msgstr ""
3575
3576 #. type: Plain text
3577 #: build/C/man3/pthread_create.3:354
3578 #, no-wrap
3579 msgid "    /* Now join with each thread, and display its returned value */\n"
3580 msgstr ""
3581
3582 #. type: Plain text
3583 #: build/C/man3/pthread_create.3:359
3584 #, no-wrap
3585 msgid ""
3586 "    for (tnum = 0; tnum E<lt> num_threads; tnum++) {\n"
3587 "        s = pthread_join(tinfo[tnum].thread_id, &res);\n"
3588 "        if (s != 0)\n"
3589 "            handle_error_en(s, \"pthread_join\");\n"
3590 msgstr ""
3591
3592 #. type: Plain text
3593 #: build/C/man3/pthread_create.3:364
3594 #, no-wrap
3595 msgid ""
3596 "        printf(\"Joined with thread %d; returned value was %s\\en\",\n"
3597 "                tinfo[tnum].thread_num, (char *) res);\n"
3598 "        free(res);      /* Free memory allocated by thread */\n"
3599 "    }\n"
3600 msgstr ""
3601
3602 #. type: Plain text
3603 #: build/C/man3/pthread_create.3:368
3604 #, no-wrap
3605 msgid ""
3606 "    free(tinfo);\n"
3607 "    exit(EXIT_SUCCESS);\n"
3608 "}\n"
3609 msgstr ""
3610
3611 #. type: Plain text
3612 #: build/C/man3/pthread_create.3:382
3613 msgid ""
3614 "B<getrlimit>(2), B<pthread_attr_init>(3), B<pthread_cancel>(3), "
3615 "B<pthread_detach>(3), B<pthread_equal>(3), B<pthread_exit>(3), "
3616 "B<pthread_getattr_np>(3), B<pthread_join>(3), B<pthread_self>(3), "
3617 "B<pthreads>(7)"
3618 msgstr ""
3619
3620 #. type: TH
3621 #: build/C/man3/pthread_detach.3:26
3622 #, no-wrap
3623 msgid "PTHREAD_DETACH"
3624 msgstr ""
3625
3626 #. type: TH
3627 #: build/C/man3/pthread_detach.3:26 build/C/man3/pthread_join.3:26
3628 #, no-wrap
3629 msgid "2008-11-27"
3630 msgstr ""
3631
3632 #. type: Plain text
3633 #: build/C/man3/pthread_detach.3:29
3634 msgid "pthread_detach - detach a thread"
3635 msgstr ""
3636
3637 #. type: Plain text
3638 #: build/C/man3/pthread_detach.3:34
3639 #, no-wrap
3640 msgid "B<int pthread_detach(pthread_t >I<thread>B<);>\n"
3641 msgstr ""
3642
3643 #. type: Plain text
3644 #: build/C/man3/pthread_detach.3:46
3645 msgid ""
3646 "The B<pthread_detach>()  function marks the thread identified by I<thread> "
3647 "as detached.  When a detached thread terminates, its resources are "
3648 "automatically released back to the system without the need for another "
3649 "thread to join with the terminated thread."
3650 msgstr ""
3651
3652 #. type: Plain text
3653 #: build/C/man3/pthread_detach.3:49
3654 msgid ""
3655 "Attempting to detach an already detached thread results in unspecified "
3656 "behavior."
3657 msgstr ""
3658
3659 #. type: Plain text
3660 #: build/C/man3/pthread_detach.3:54
3661 msgid ""
3662 "On success, B<pthread_detach>()  returns 0; on error, it returns an error "
3663 "number."
3664 msgstr ""
3665
3666 #. type: Plain text
3667 #: build/C/man3/pthread_detach.3:59 build/C/man3/pthread_join.3:89
3668 msgid "I<thread> is not a joinable thread."
3669 msgstr ""
3670
3671 #. type: Plain text
3672 #: build/C/man3/pthread_detach.3:70
3673 msgid ""
3674 "Once a thread has been detached, it can't be joined with B<pthread_join>(3)  "
3675 "or be made joinable again."
3676 msgstr ""
3677
3678 #. type: Plain text
3679 #: build/C/man3/pthread_detach.3:77
3680 msgid ""
3681 "A new thread can be created in a detached state using "
3682 "B<pthread_attr_setdetachstate>(3)  to set the detached attribute of the "
3683 "I<attr> argument of B<pthread_create>(3)."
3684 msgstr ""
3685
3686 #. type: Plain text
3687 #: build/C/man3/pthread_detach.3:84
3688 msgid ""
3689 "The detached attribute merely determines the behavior of the system when the "
3690 "thread terminates; it does not prevent the thread from being terminated if "
3691 "the process terminates using B<exit>(3)  (or equivalently, if the main "
3692 "thread returns)."
3693 msgstr ""
3694
3695 #. type: Plain text
3696 #: build/C/man3/pthread_detach.3:93
3697 msgid ""
3698 "Either B<pthread_join>(3)  or B<pthread_detach>()  should be called for each "
3699 "thread that an application creates, so that system resources for the thread "
3700 "can be released.  (But note that the resources of all threads are freed when "
3701 "the process terminates.)"
3702 msgstr ""
3703
3704 #. type: Plain text
3705 #: build/C/man3/pthread_detach.3:95
3706 msgid "The following statement detaches the calling thread:"
3707 msgstr ""
3708
3709 #. type: Plain text
3710 #: build/C/man3/pthread_detach.3:97
3711 #, no-wrap
3712 msgid "    pthread_detach(pthread_self());\n"
3713 msgstr ""
3714
3715 #. type: Plain text
3716 #: build/C/man3/pthread_detach.3:104
3717 msgid ""
3718 "B<pthread_attr_setdetachstate>(3), B<pthread_cancel>(3), "
3719 "B<pthread_create>(3), B<pthread_exit>(3), B<pthread_join>(3), B<pthreads>(7)"
3720 msgstr ""
3721
3722 #. type: TH
3723 #: build/C/man3/pthread_equal.3:26
3724 #, no-wrap
3725 msgid "PTHREAD_EQUAL"
3726 msgstr ""
3727
3728 #. type: TH
3729 #: build/C/man3/pthread_equal.3:26 build/C/man3/pthread_exit.3:26
3730 #, no-wrap
3731 msgid "2009-03-30"
3732 msgstr ""
3733
3734 #. type: Plain text
3735 #: build/C/man3/pthread_equal.3:29
3736 msgid "pthread_equal - compare thread IDs"
3737 msgstr ""
3738
3739 #. type: Plain text
3740 #: build/C/man3/pthread_equal.3:34
3741 #, no-wrap
3742 msgid "B<int pthread_equal(pthread_t >I<t1>B<, pthread_t >I<t2>B<);>\n"
3743 msgstr ""
3744
3745 #. type: Plain text
3746 #: build/C/man3/pthread_equal.3:41
3747 msgid "The B<pthread_equal>()  function compares two thread identifiers."
3748 msgstr ""
3749
3750 #. type: Plain text
3751 #: build/C/man3/pthread_equal.3:45
3752 msgid ""
3753 "If the two thread IDs are equal, B<pthread_equal>()  returns a nonzero "
3754 "value; otherwise, it returns 0."
3755 msgstr ""
3756
3757 #.  SH VERSIONS
3758 #.  Available since glibc 2.0
3759 #. type: Plain text
3760 #: 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
3761 msgid "This function always succeeds."
3762 msgstr ""
3763
3764 #. type: Plain text
3765 #: build/C/man3/pthread_equal.3:56
3766 msgid ""
3767 "The B<pthread_equal>()  function is necessary because thread IDs should be "
3768 "considered opaque: there is no portable way for applications to directly "
3769 "compare two I<pthread_t> values."
3770 msgstr ""
3771
3772 #. type: Plain text
3773 #: build/C/man3/pthread_equal.3:60
3774 msgid "B<pthread_create>(3), B<pthread_self>(3), B<pthreads>(7)"
3775 msgstr ""
3776
3777 #. type: TH
3778 #: build/C/man3/pthread_exit.3:26
3779 #, no-wrap
3780 msgid "PTHREAD_EXIT"
3781 msgstr ""
3782
3783 #. type: Plain text
3784 #: build/C/man3/pthread_exit.3:29
3785 msgid "pthread_exit - terminate calling thread"
3786 msgstr ""
3787
3788 #. type: Plain text
3789 #: build/C/man3/pthread_exit.3:34
3790 #, no-wrap
3791 msgid "B<void pthread_exit(void *>I<retval>B<);>\n"
3792 msgstr ""
3793
3794 #. type: Plain text
3795 #: build/C/man3/pthread_exit.3:45
3796 msgid ""
3797 "The B<pthread_exit>()  function terminates the calling thread and returns a "
3798 "value via I<retval> that (if the thread is joinable)  is available to "
3799 "another thread in the same process that calls B<pthread_join>(3)."
3800 msgstr ""
3801
3802 #. type: Plain text
3803 #: build/C/man3/pthread_exit.3:55
3804 msgid ""
3805 "Any clean-up handlers established by B<pthread_cleanup_push>(3)  that have "
3806 "not yet been popped, are popped (in the reverse of the order in which they "
3807 "were pushed)  and executed.  If the thread has any thread-specific data, "
3808 "then, after the clean-up handlers have been executed, the corresponding "
3809 "destructor functions are called, in an unspecified order."
3810 msgstr ""
3811
3812 #. type: Plain text
3813 #: build/C/man3/pthread_exit.3:62
3814 msgid ""
3815 "When a thread terminates, process-shared resources (e.g., mutexes, condition "
3816 "variables, semaphores, and file descriptors) are not released, and functions "
3817 "registered using B<atexit>(3)  are not called."
3818 msgstr ""
3819
3820 #. type: Plain text
3821 #: build/C/man3/pthread_exit.3:71
3822 msgid ""
3823 "After the last thread in a process terminates, the process terminates as by "
3824 "calling B<exit>(3)  with an exit status of zero; thus, process-shared "
3825 "resources are released and functions registered using B<atexit>(3)  are "
3826 "called."
3827 msgstr ""
3828
3829 #. type: Plain text
3830 #: build/C/man3/pthread_exit.3:73
3831 msgid "This function does not return to the caller."
3832 msgstr ""
3833
3834 #. type: Plain text
3835 #: build/C/man3/pthread_exit.3:82
3836 msgid ""
3837 "Performing a return from the start function of any thread other than the "
3838 "main thread results in an implicit call to B<pthread_exit>(), using the "
3839 "function's return value as the thread's exit status."
3840 msgstr ""
3841
3842 #. type: Plain text
3843 #: build/C/man3/pthread_exit.3:88
3844 msgid ""
3845 "To allow other threads to continue execution, the main thread should "
3846 "terminate by calling B<pthread_exit>()  rather than B<exit>(3)."
3847 msgstr ""
3848
3849 #. type: Plain text
3850 #: build/C/man3/pthread_exit.3:93
3851 msgid ""
3852 "The value pointed to by I<retval> should not be located on the calling "
3853 "thread's stack, since the contents of that stack are undefined after the "
3854 "thread terminates."
3855 msgstr ""
3856
3857 #.  Linux 2.6.27
3858 #.  FIXME . review a later kernel to see if this gets fixed
3859 #.  http://thread.gmane.org/gmane.linux.kernel/611611
3860 #.  http://marc.info/?l=linux-kernel&m=122525468300823&w=2
3861 #. type: Plain text
3862 #: build/C/man3/pthread_exit.3:105
3863 msgid ""
3864 "Currently, there are limitations in the kernel implementation logic for "
3865 "B<wait>(2)ing on a stopped thread group with a dead thread group leader.  "
3866 "This can manifest in problems such as a locked terminal if a stop signal is "
3867 "sent to a foreground process whose thread group leader has already called "
3868 "B<pthread_exit>()."
3869 msgstr ""
3870
3871 #. type: Plain text
3872 #: build/C/man3/pthread_exit.3:109
3873 msgid "B<pthread_create>(3), B<pthread_join>(3), B<pthreads>(7)"
3874 msgstr ""
3875
3876 #. type: TH
3877 #: build/C/man3/pthread_getattr_np.3:26
3878 #, no-wrap
3879 msgid "PTHREAD_GETATTR_NP"
3880 msgstr ""
3881
3882 #. type: Plain text
3883 #: build/C/man3/pthread_getattr_np.3:29
3884 msgid "pthread_getattr_np - get attributes of created thread"
3885 msgstr ""
3886
3887 #. type: Plain text
3888 #: build/C/man3/pthread_getattr_np.3:35
3889 #, no-wrap
3890 msgid ""
3891 "B<int pthread_getattr_np(pthread_t >I<thread>B<, pthread_attr_t "
3892 "*>I<attr>B<);>\n"
3893 msgstr ""
3894
3895 #. type: Plain text
3896 #: build/C/man3/pthread_getattr_np.3:45
3897 msgid ""
3898 "The B<pthread_getattr_np>()  function initializes the thread attributes "
3899 "object referred to by I<attr> so that it contains actual attribute values "
3900 "describing the running thread I<thread>."
3901 msgstr ""
3902
3903 #. type: Plain text
3904 #: build/C/man3/pthread_getattr_np.3:52
3905 msgid ""
3906 "The returned attribute values may differ from the corresponding attribute "
3907 "values passed in the I<attr> object that was used to create the thread using "
3908 "B<pthread_create>(3).  In particular, the following attributes may differ:"
3909 msgstr ""
3910
3911 #. type: Plain text
3912 #: build/C/man3/pthread_getattr_np.3:55
3913 msgid ""
3914 "the detach state, since a joinable thread may have detached itself after "
3915 "creation;"
3916 msgstr ""
3917
3918 #. type: Plain text
3919 #: build/C/man3/pthread_getattr_np.3:58
3920 msgid "the stack size, which the implementation may align to a suitable boundary."
3921 msgstr ""
3922
3923 #. type: Plain text
3924 #: build/C/man3/pthread_getattr_np.3:63
3925 msgid ""
3926 "and the guard size, which the implementation may round upward to a multiple "
3927 "of the page size, or ignore (i.e., treat as 0), if the application is "
3928 "allocating its own stack."
3929 msgstr ""
3930
3931 #. type: Plain text
3932 #: build/C/man3/pthread_getattr_np.3:68
3933 msgid ""
3934 "Furthermore, if the stack address attribute was not set in the thread "
3935 "attributes object used to create the thread, then the returned thread "
3936 "attributes object will report the actual stack address that the "
3937 "implementation selected for the thread."
3938 msgstr ""
3939
3940 #. type: Plain text
3941 #: build/C/man3/pthread_getattr_np.3:73
3942 msgid ""
3943 "When the thread attributes object returned by B<pthread_getattr_np>()  is no "
3944 "longer required, it should be destroyed using B<pthread_attr_destroy>(3)."
3945 msgstr ""
3946
3947 #. type: Plain text
3948 #: build/C/man3/pthread_getattr_np.3:76 build/C/man3/pthread_getcpuclockid.3:49
3949 msgid ""
3950 "On success, this function returns 0; on error, it returns a nonzero error "
3951 "number."
3952 msgstr ""
3953
3954 #.  Can happen (but unlikely) while trying to allocate memory for cpuset
3955 #. type: Plain text
3956 #: build/C/man3/pthread_getattr_np.3:81
3957 msgid "Insufficient memory."
3958 msgstr ""
3959
3960 #. type: Plain text
3961 #: build/C/man3/pthread_getattr_np.3:96
3962 msgid ""
3963 "In addition, if I<thread> refers to the main thread, then "
3964 "B<pthread_getattr_np>()  can fail because of errors from various underlying "
3965 "calls: B<fopen>(3), if I</proc/self/maps> can't be opened; and "
3966 "B<getrlimit>(2), if the B<RLIMIT_STACK> resource limit is not supported."
3967 msgstr ""
3968
3969 #. type: Plain text
3970 #: build/C/man3/pthread_getattr_np.3:98
3971 msgid "This function is available in glibc since version 2.2.3."
3972 msgstr ""
3973
3974 #. type: Plain text
3975 #: build/C/man3/pthread_getattr_np.3:101 build/C/man3/pthread_kill_other_threads_np.3:50
3976 msgid ""
3977 "This function is a nonstandard GNU extension; hence the suffix \"_np\" "
3978 "(nonportable) in the name."
3979 msgstr ""
3980
3981 #. type: Plain text
3982 #: build/C/man3/pthread_getattr_np.3:111
3983 msgid ""
3984 "The program below demonstrates the use of B<pthread_getattr_np>().  The "
3985 "program creates a thread that then uses B<pthread_getattr_np>()  to retrieve "
3986 "and display its guard size, stack address, and stack size attributes.  "
3987 "Command-line arguments can be used to set these attributes to values other "
3988 "than the default when creating the thread.  The shell sessions below "
3989 "demonstrate the use of the program."
3990 msgstr ""
3991
3992 #. type: Plain text
3993 #: build/C/man3/pthread_getattr_np.3:114
3994 msgid ""
3995 "In the first run, on an x86-32 system, a thread is created using default "
3996 "attributes:"
3997 msgstr ""
3998
3999 #. type: Plain text
4000 #: build/C/man3/pthread_getattr_np.3:124
4001 #, no-wrap
4002 msgid ""
4003 "$B< ulimit -s>      # No stack limit ==E<gt> default stack size is 2MB\n"
4004 "unlimited\n"
4005 "$B< ./a.out>\n"
4006 "Attributes of created thread:\n"
4007 "        Guard size          = 4096 bytes\n"
4008 "        Stack address       = 0x40196000 (EOS = 0x40397000)\n"
4009 "        Stack size          = 0x201000 (2101248) bytes\n"
4010 msgstr ""
4011
4012 #. type: Plain text
4013 #: build/C/man3/pthread_getattr_np.3:130
4014 msgid ""
4015 "In the following run, we see that if a guard size is specified, it is "
4016 "rounded up to the next multiple of the system page size (4096 bytes on "
4017 "x86-32):"
4018 msgstr ""
4019
4020 #. type: Plain text
4021 #: build/C/man3/pthread_getattr_np.3:138
4022 #, no-wrap
4023 msgid ""
4024 "$B< ./a.out -g 4097>\n"
4025 "Thread attributes object after initializations:\n"
4026 "        Guard size          = 4097 bytes\n"
4027 "        Stack address       = (nil)\n"
4028 "        Stack size          = 0x0 (0) bytes\n"
4029 msgstr ""
4030
4031 #. type: Plain text
4032 #: build/C/man3/pthread_getattr_np.3:143
4033 #, no-wrap
4034 msgid ""
4035 "Attributes of created thread:\n"
4036 "        Guard size          = 8192 bytes\n"
4037 "        Stack address       = 0x40196000 (EOS = 0x40397000)\n"
4038 "        Stack size          = 0x201000 (2101248) bytes\n"
4039 msgstr ""
4040
4041 #. .in +4n
4042 #. .nf
4043 #. $ ./a.out \-s 0x8000
4044 #. Thread attributes object after initializations:
4045 #.         Guard size          = 4096 bytes
4046 #.         Stack address       = 0xffff8000 (EOS = (nil))
4047 #.         Stack size          = 0x8000 (32768) bytes
4048 #
4049 #. Attributes of created thread:
4050 #.         Guard size          = 4096 bytes
4051 #.         Stack address       = 0x4001e000 (EOS = 0x40026000)
4052 #.         Stack size          = 0x8000 (32768) bytes
4053 #. .fi
4054 #. .in
4055 #. type: Plain text
4056 #: build/C/man3/pthread_getattr_np.3:162
4057 msgid ""
4058 "In the last run, the program manually allocates a stack for the thread.  In "
4059 "this case, the guard size attribute is ignored."
4060 msgstr ""
4061
4062 #. type: Plain text
4063 #: build/C/man3/pthread_getattr_np.3:167
4064 #, no-wrap
4065 msgid ""
4066 "$B< ./a.out -g 4096 -s 0x8000 -a>\n"
4067 "Allocated thread stack at 0x804d000\n"
4068 msgstr ""
4069
4070 #. type: Plain text
4071 #: build/C/man3/pthread_getattr_np.3:172
4072 #, no-wrap
4073 msgid ""
4074 "Thread attributes object after initializations:\n"
4075 "        Guard size          = 4096 bytes\n"
4076 "        Stack address       = 0x804d000 (EOS = 0x8055000)\n"
4077 "        Stack size          = 0x8000 (32768) bytes\n"
4078 msgstr ""
4079
4080 #. type: Plain text
4081 #: build/C/man3/pthread_getattr_np.3:177
4082 #, no-wrap
4083 msgid ""
4084 "Attributes of created thread:\n"
4085 "        Guard size          = 0 bytes\n"
4086 "        Stack address       = 0x804d000 (EOS = 0x8055000)\n"
4087 "        Stack size          = 0x8000 (32768) bytes\n"
4088 msgstr ""
4089
4090 #. type: Plain text
4091 #: build/C/man3/pthread_getattr_np.3:198
4092 #, no-wrap
4093 msgid ""
4094 "static void\n"
4095 "display_stack_related_attributes(pthread_attr_t *attr, char *prefix)\n"
4096 "{\n"
4097 "    int s;\n"
4098 "    size_t stack_size, guard_size;\n"
4099 "    void *stack_addr;\n"
4100 msgstr ""
4101
4102 #. type: Plain text
4103 #: build/C/man3/pthread_getattr_np.3:203
4104 #, no-wrap
4105 msgid ""
4106 "    s = pthread_attr_getguardsize(attr, &guard_size);\n"
4107 "    if (s != 0)\n"
4108 "        handle_error_en(s, \"pthread_attr_getguardsize\");\n"
4109 "    printf(\"%sGuard size          = %d bytes\\en\", prefix, guard_size);\n"
4110 msgstr ""
4111
4112 #. type: Plain text
4113 #: build/C/man3/pthread_getattr_np.3:214
4114 #, no-wrap
4115 msgid ""
4116 "    s = pthread_attr_getstack(attr, &stack_addr, &stack_size);\n"
4117 "    if (s != 0)\n"
4118 "        handle_error_en(s, \"pthread_attr_getstack\");\n"
4119 "    printf(\"%sStack address       = %p\", prefix, stack_addr);\n"
4120 "    if (stack_size E<gt> 0)\n"
4121 "        printf(\" (EOS = %p)\", (char *) stack_addr + stack_size);\n"
4122 "    printf(\"\\en\");\n"
4123 "    printf(\"%sStack size          = 0x%x (%d) bytes\\en\",\n"
4124 "            prefix, stack_size, stack_size);\n"
4125 "}\n"
4126 msgstr ""
4127
4128 #. type: Plain text
4129 #: build/C/man3/pthread_getattr_np.3:220
4130 #, no-wrap
4131 msgid ""
4132 "static void\n"
4133 "display_thread_attributes(pthread_t thread, char *prefix)\n"
4134 "{\n"
4135 "    int s;\n"
4136 "    pthread_attr_t attr;\n"
4137 msgstr ""
4138
4139 #. type: Plain text
4140 #: build/C/man3/pthread_getattr_np.3:224
4141 #, no-wrap
4142 msgid ""
4143 "    s = pthread_getattr_np(thread, &attr);\n"
4144 "    if (s != 0)\n"
4145 "        handle_error_en(s, \"pthread_getattr_np\");\n"
4146 msgstr ""
4147
4148 #. type: Plain text
4149 #: build/C/man3/pthread_getattr_np.3:226
4150 #, no-wrap
4151 msgid "    display_stack_related_attributes(&attr, prefix);\n"
4152 msgstr ""
4153
4154 #. type: Plain text
4155 #: build/C/man3/pthread_getattr_np.3:231
4156 #, no-wrap
4157 msgid ""
4158 "    s = pthread_attr_destroy(&attr);\n"
4159 "    if (s != 0)\n"
4160 "        handle_error_en(s, \"pthread_attr_destroy\");\n"
4161 "}\n"
4162 msgstr ""
4163
4164 #. type: Plain text
4165 #: build/C/man3/pthread_getattr_np.3:237
4166 #, no-wrap
4167 msgid ""
4168 "static void *           /* Start function for thread we create */\n"
4169 "thread_start(void *arg)\n"
4170 "{\n"
4171 "    printf(\"Attributes of created thread:\\en\");\n"
4172 "    display_thread_attributes(pthread_self(), \"\\et\");\n"
4173 msgstr ""
4174
4175 #. type: Plain text
4176 #: build/C/man3/pthread_getattr_np.3:251
4177 #, no-wrap
4178 msgid ""
4179 "static void\n"
4180 "usage(char *pname, char *msg)\n"
4181 "{\n"
4182 "    if (msg != NULL)\n"
4183 "        fputs(msg, stderr);\n"
4184 "    fprintf(stderr, \"Usage: %s [-s stack-size [-a]]\"\n"
4185 "            \" [-g guard-size]\\en\", pname);\n"
4186 "    fprintf(stderr, \"\\et\\et-a means program should allocate "
4187 "stack\\en\");\n"
4188 "    exit(EXIT_FAILURE);\n"
4189 "}\n"
4190 msgstr ""
4191
4192 #. type: Plain text
4193 #: build/C/man3/pthread_getattr_np.3:264
4194 #, no-wrap
4195 msgid ""
4196 "static pthread_attr_t *   /* Get thread attributes from command line */\n"
4197 "get_thread_attributes_from_cl(int argc, char *argv[],\n"
4198 "                              pthread_attr_t *attrp)\n"
4199 "{\n"
4200 "    int s, opt, allocate_stack;\n"
4201 "    long stack_size, guard_size;\n"
4202 "            void *stack_addr;\n"
4203 "    pthread_attr_t *ret_attrp = NULL;   /* Set to attrp if we initialize\n"
4204 "                                           a thread attributes object */\n"
4205 "    allocate_stack = 0;\n"
4206 "    stack_size = -1;\n"
4207 "    guard_size = -1;\n"
4208 msgstr ""
4209
4210 #. type: Plain text
4211 #: build/C/man3/pthread_getattr_np.3:273
4212 #, no-wrap
4213 msgid ""
4214 "    while ((opt = getopt(argc, argv, \"ag:s:\")) != -1) {\n"
4215 "        switch (opt) {\n"
4216 "        case \\(aqa\\(aq:   allocate_stack = 1;                     break;\n"
4217 "        case \\(aqg\\(aq:   guard_size = strtoul(optarg, NULL, 0);  break;\n"
4218 "        case \\(aqs\\(aq:   stack_size = strtoul(optarg, NULL, 0);  break;\n"
4219 "        default:    usage(argv[0], NULL);\n"
4220 "        }\n"
4221 "    }\n"
4222 msgstr ""
4223
4224 #. type: Plain text
4225 #: build/C/man3/pthread_getattr_np.3:276
4226 #, no-wrap
4227 msgid ""
4228 "    if (allocate_stack && stack_size == -1)\n"
4229 "        usage(argv[0], \"Specifying -a without -s makes no sense\\en\");\n"
4230 msgstr ""
4231
4232 #. type: Plain text
4233 #: build/C/man3/pthread_getattr_np.3:279
4234 #, no-wrap
4235 msgid ""
4236 "    if (argc E<gt> optind)\n"
4237 "        usage(argv[0], \"Extraneous command-line arguments\\en\");\n"
4238 msgstr ""
4239
4240 #. type: Plain text
4241 #: build/C/man3/pthread_getattr_np.3:282
4242 #, no-wrap
4243 msgid ""
4244 "    if (stack_size E<gt>= 0 || guard_size E<gt> 0) {\n"
4245 "        ret_attrp = attrp;\n"
4246 msgstr ""
4247
4248 #. type: Plain text
4249 #: build/C/man3/pthread_getattr_np.3:287
4250 #, no-wrap
4251 msgid ""
4252 "        s = pthread_attr_init(attrp);\n"
4253 "        if (s != 0)\n"
4254 "            handle_error_en(s, \"pthread_attr_init\");\n"
4255 "    }\n"
4256 msgstr ""
4257
4258 #. type: Plain text
4259 #: build/C/man3/pthread_getattr_np.3:299
4260 #, no-wrap
4261 msgid ""
4262 "    if (stack_size E<gt>= 0) {\n"
4263 "        if (!allocate_stack) {\n"
4264 "            s = pthread_attr_setstacksize(attrp, stack_size);\n"
4265 "            if (s != 0)\n"
4266 "                handle_error_en(s, \"pthread_attr_setstacksize\");\n"
4267 "        } else {\n"
4268 "            s = posix_memalign(&stack_addr, sysconf(_SC_PAGESIZE),\n"
4269 "                               stack_size);\n"
4270 "            if (s != 0)\n"
4271 "                handle_error_en(s, \"posix_memalign\");\n"
4272 "            printf(\"Allocated thread stack at %p\\en\\en\", stack_addr);\n"
4273 msgstr ""
4274
4275 #. type: Plain text
4276 #: build/C/man3/pthread_getattr_np.3:305
4277 #, no-wrap
4278 msgid ""
4279 "            s = pthread_attr_setstack(attrp, stack_addr, stack_size);\n"
4280 "            if (s != 0)\n"
4281 "                handle_error_en(s, \"pthread_attr_setstacksize\");\n"
4282 "        }\n"
4283 "    }\n"
4284 msgstr ""
4285
4286 #. type: Plain text
4287 #: build/C/man3/pthread_getattr_np.3:311
4288 #, no-wrap
4289 msgid ""
4290 "    if (guard_size E<gt>= 0) {\n"
4291 "        s = pthread_attr_setguardsize(attrp, guard_size);\n"
4292 "        if (s != 0)\n"
4293 "            handle_error_en(s, \"pthread_attr_setstacksize\");\n"
4294 "    }\n"
4295 msgstr ""
4296
4297 #. type: Plain text
4298 #: build/C/man3/pthread_getattr_np.3:314
4299 #, no-wrap
4300 msgid ""
4301 "    return ret_attrp;\n"
4302 "}\n"
4303 msgstr ""
4304
4305 #. type: Plain text
4306 #: build/C/man3/pthread_getattr_np.3:323
4307 #, no-wrap
4308 msgid ""
4309 "int\n"
4310 "main(int argc, char *argv[])\n"
4311 "{\n"
4312 "    int s;\n"
4313 "    pthread_t thr;\n"
4314 "    pthread_attr_t attr;\n"
4315 "    pthread_attr_t *attrp = NULL;    /* Set to &attr if we initialize\n"
4316 "                                        a thread attributes object */\n"
4317 msgstr ""
4318
4319 #. type: Plain text
4320 #: build/C/man3/pthread_getattr_np.3:325
4321 #, no-wrap
4322 msgid "    attrp = get_thread_attributes_from_cl(argc, argv, &attr);\n"
4323 msgstr ""
4324
4325 #. type: Plain text
4326 #: build/C/man3/pthread_getattr_np.3:331
4327 #, no-wrap
4328 msgid ""
4329 "    if (attrp != NULL) {\n"
4330 "        printf(\"Thread attributes object after initializations:\\en\");\n"
4331 "        display_stack_related_attributes(attrp, \"\\et\");\n"
4332 "        printf(\"\\en\");\n"
4333 "    }\n"
4334 msgstr ""
4335
4336 #. type: Plain text
4337 #: build/C/man3/pthread_getattr_np.3:361
4338 msgid ""
4339 "B<pthread_attr_getaffinity_np>(3), B<pthread_attr_getdetachstate>(3), "
4340 "B<pthread_attr_getguardsize>(3), B<pthread_attr_getinheritsched>(3), "
4341 "B<pthread_attr_getschedparam>(3), B<pthread_attr_getschedpolicy>(3), "
4342 "B<pthread_attr_getscope>(3), B<pthread_attr_getstack>(3), "
4343 "B<pthread_attr_getstackaddr>(3), B<pthread_attr_getstacksize>(3), "
4344 "B<pthread_attr_init>(3), B<pthread_create>(3), B<pthreads>(7)"
4345 msgstr ""
4346
4347 #. type: TH
4348 #: build/C/man3/pthread_getcpuclockid.3:26
4349 #, no-wrap
4350 msgid "PTHREAD_GETCPUCLOCKID"
4351 msgstr ""
4352
4353 #. type: TH
4354 #: build/C/man3/pthread_getcpuclockid.3:26
4355 #, no-wrap
4356 msgid "2009-02-08"
4357 msgstr ""
4358
4359 #. type: Plain text
4360 #: build/C/man3/pthread_getcpuclockid.3:29
4361 msgid "pthread_getcpuclockid - retrieve ID of a thread's CPU time clock"
4362 msgstr ""
4363
4364 #. type: Plain text
4365 #: build/C/man3/pthread_getcpuclockid.3:33
4366 #, no-wrap
4367 msgid ""
4368 "B<#include E<lt>pthread.hE<gt>>\n"
4369 "B<#include E<lt>time.hE<gt>>\n"
4370 msgstr ""
4371
4372 #. type: Plain text
4373 #: build/C/man3/pthread_getcpuclockid.3:35
4374 #, no-wrap
4375 msgid ""
4376 "B<int pthread_getcpuclockid(pthread_t >I<thread>B<, clockid_t "
4377 "*>I<clock_id);>\n"
4378 msgstr ""
4379
4380 #.  The clockid is constructed as follows:
4381 #.  *clockid = CLOCK_THREAD_CPUTIME_ID | (pd->tid << CLOCK_IDFIELD_SIZE)
4382 #.  where CLOCK_IDFIELD_SIZE is 3.
4383 #. type: Plain text
4384 #: build/C/man3/pthread_getcpuclockid.3:46
4385 msgid ""
4386 "The B<pthread_getcpuclockid>()  function returns the clock ID for the CPU "
4387 "time clock of the thread I<thread>."
4388 msgstr ""
4389
4390 #. type: TP
4391 #: build/C/man3/pthread_getcpuclockid.3:50
4392 #, no-wrap
4393 msgid "B<ENOENT>"
4394 msgstr ""
4395
4396 #.  CLOCK_THREAD_CPUTIME_ID not defined
4397 #
4398 #.  Looking at nptl/pthread_getcpuclockid.c an ERANGE error would
4399 #.  be possible if kernel thread IDs took more than 29 bits (which
4400 #.  they currently cannot).
4401 #. type: Plain text
4402 #: build/C/man3/pthread_getcpuclockid.3:58
4403 msgid "Per-thread CPU time clocks are not supported by the system."
4404 msgstr ""
4405
4406 #. type: Plain text
4407 #: build/C/man3/pthread_getcpuclockid.3:65
4408 msgid "This function is available in glibc since version 2.2."
4409 msgstr ""
4410
4411 #. type: Plain text
4412 #: build/C/man3/pthread_getcpuclockid.3:78
4413 msgid ""
4414 "When I<thread> refers to the calling thread, this function returns an "
4415 "identifier that refers to the same clock manipulated by B<clock_gettime>(2)  "
4416 "and B<clock_settime>(2)  when given the clock ID B<CLOCK_THREAD_CPUTIME_ID>."
4417 msgstr ""
4418
4419 #. type: Plain text
4420 #: build/C/man3/pthread_getcpuclockid.3:84
4421 msgid ""
4422 "The program below creates a thread and then uses B<clock_gettime>(2)  to "
4423 "retrieve the total process CPU time, and the per-thread CPU time consumed by "
4424 "the two threads.  The following shell session shows an example run:"
4425 msgstr ""
4426
4427 #. type: Plain text
4428 #: build/C/man3/pthread_getcpuclockid.3:93
4429 #, no-wrap
4430 msgid ""
4431 "$ B<./a.out>\n"
4432 "Main thread sleeping\n"
4433 "Subthread starting infinite loop\n"
4434 "Main thread consuming some CPU time...\n"
4435 "Process total CPU time:    1.368\n"
4436 "Main thread CPU time:      0.376\n"
4437 "Subthread CPU time:        0.992\n"
4438 msgstr ""
4439
4440 #. type: Plain text
4441 #: build/C/man3/pthread_getcpuclockid.3:99
4442 #, no-wrap
4443 msgid "/* Link with \"-lrt\" */\n"
4444 msgstr ""
4445
4446 #. type: Plain text
4447 #: build/C/man3/pthread_getcpuclockid.3:107
4448 #, no-wrap
4449 msgid ""
4450 "#include E<lt>time.hE<gt>\n"
4451 "#include E<lt>stdio.hE<gt>\n"
4452 "#include E<lt>stdlib.hE<gt>\n"
4453 "#include E<lt>unistd.hE<gt>\n"
4454 "#include E<lt>pthread.hE<gt>\n"
4455 "#include E<lt>string.hE<gt>\n"
4456 "#include E<lt>errno.hE<gt>\n"
4457 msgstr ""
4458
4459 #. type: Plain text
4460 #: build/C/man3/pthread_getcpuclockid.3:121
4461 #, no-wrap
4462 msgid ""
4463 "static void *\n"
4464 "thread_start(void *arg)\n"
4465 "{\n"
4466 "    printf(\"Subthread starting infinite loop\\en\");\n"
4467 "    for (;;)\n"
4468 "        continue;\n"
4469 "}\n"
4470 msgstr ""
4471
4472 #. type: Plain text
4473 #: build/C/man3/pthread_getcpuclockid.3:126
4474 #, no-wrap
4475 msgid ""
4476 "static void\n"
4477 "pclock(char *msg, clockid_t cid)\n"
4478 "{\n"
4479 "    struct timespec ts;\n"
4480 msgstr ""
4481
4482 #. type: Plain text
4483 #: build/C/man3/pthread_getcpuclockid.3:132
4484 #, no-wrap
4485 msgid ""
4486 "    printf(\"%s\", msg);\n"
4487 "    if (clock_gettime(cid, &ts) == -1)\n"
4488 "        handle_error(\"clock_gettime\");\n"
4489 "    printf(\"%4ld.%03ld\\en\", ts.tv_sec, ts.tv_nsec / 1000000);\n"
4490 "}\n"
4491 msgstr ""
4492
4493 #. type: Plain text
4494 #: build/C/man3/pthread_getcpuclockid.3:139
4495 #, no-wrap
4496 msgid ""
4497 "int\n"
4498 "main(int argc, char *argv[])\n"
4499 "{\n"
4500 "    pthread_t thread;\n"
4501 "    clockid_t cid;\n"
4502 "    int j, s;\n"
4503 msgstr ""
4504
4505 #. type: Plain text
4506 #: build/C/man3/pthread_getcpuclockid.3:143
4507 #, no-wrap
4508 msgid ""
4509 "    s = pthread_create(&thread, NULL, thread_start, NULL);\n"
4510 "    if (s != 0)\n"
4511 "        handle_error_en(s, \"pthread_create\");\n"
4512 msgstr ""
4513
4514 #. type: Plain text
4515 #: build/C/man3/pthread_getcpuclockid.3:146
4516 #, no-wrap
4517 msgid ""
4518 "    printf(\"Main thread sleeping\\en\");\n"
4519 "    sleep(1);\n"
4520 msgstr ""
4521
4522 #. type: Plain text
4523 #: build/C/man3/pthread_getcpuclockid.3:150
4524 #, no-wrap
4525 msgid ""
4526 "    printf(\"Main thread consuming some CPU time...\\en\");\n"
4527 "    for (j = 0; j E<lt> 2000000; j++)\n"
4528 "        getppid();\n"
4529 msgstr ""
4530
4531 #. type: Plain text
4532 #: build/C/man3/pthread_getcpuclockid.3:152
4533 #, no-wrap
4534 msgid "    pclock(\"Process total CPU time: \", CLOCK_PROCESS_CPUTIME_ID);\n"
4535 msgstr ""
4536
4537 #. type: Plain text
4538 #: build/C/man3/pthread_getcpuclockid.3:157
4539 #, no-wrap
4540 msgid ""
4541 "    s = pthread_getcpuclockid(pthread_self(), &cid);\n"
4542 "    if (s != 0)\n"
4543 "        handle_error_en(s, \"pthread_getcpuclockid\");\n"
4544 "    pclock(\"Main thread CPU time:   \", cid);\n"
4545 msgstr ""
4546
4547 #. type: Plain text
4548 #: build/C/man3/pthread_getcpuclockid.3:160
4549 #, no-wrap
4550 msgid ""
4551 "    /* The preceding 4 lines of code could have been replaced by:\n"
4552 "       pclock(\"Main thread CPU time:   \", CLOCK_THREAD_CPUTIME_ID); */\n"
4553 msgstr ""
4554
4555 #. type: Plain text
4556 #: build/C/man3/pthread_getcpuclockid.3:165
4557 #, no-wrap
4558 msgid ""
4559 "    s = pthread_getcpuclockid(thread, &cid);\n"
4560 "    if (s != 0)\n"
4561 "        handle_error_en(s, \"pthread_getcpuclockid\");\n"
4562 "    pclock(\"Subthread CPU time: 1    \", cid);\n"
4563 msgstr ""
4564
4565 #. type: Plain text
4566 #: build/C/man3/pthread_getcpuclockid.3:168
4567 #, no-wrap
4568 msgid ""
4569 "    exit(EXIT_SUCCESS);         /* Terminates both threads */\n"
4570 "}\n"
4571 msgstr ""
4572
4573 #. type: Plain text
4574 #: build/C/man3/pthread_getcpuclockid.3:177
4575 msgid ""
4576 "B<clock_gettime>(2), B<clock_settime>(2), B<timer_create>(2), "
4577 "B<clock_getcpuclockid>(3), B<pthread_self>(3), B<pthreads>(7), B<time>(7)"
4578 msgstr ""
4579
4580 #. type: TH
4581 #: build/C/man3/pthread_join.3:26
4582 #, no-wrap
4583 msgid "PTHREAD_JOIN"
4584 msgstr ""
4585
4586 #. type: Plain text
4587 #: build/C/man3/pthread_join.3:29
4588 msgid "pthread_join - join with a terminated thread"
4589 msgstr ""
4590
4591 #. type: Plain text
4592 #: build/C/man3/pthread_join.3:34
4593 #, no-wrap
4594 msgid "B<int pthread_join(pthread_t >I<thread>B<, void **>I<retval>B<);>\n"
4595 msgstr ""
4596
4597 #. type: Plain text
4598 #: build/C/man3/pthread_join.3:49
4599 msgid ""
4600 "The B<pthread_join>()  function waits for the thread specified by I<thread> "
4601 "to terminate.  If that thread has already terminated, then B<pthread_join>()  "
4602 "returns immediately.  The thread specified by I<thread> must be joinable."
4603 msgstr ""
4604
4605 #. type: Plain text
4606 #: build/C/man3/pthread_join.3:63
4607 msgid ""
4608 "If I<retval> is not NULL, then B<pthread_join>()  copies the exit status of "
4609 "the target thread (i.e., the value that the target thread supplied to "
4610 "B<pthread_exit>(3))  into the location pointed to by I<*retval>.  If the "
4611 "target thread was canceled, then B<PTHREAD_CANCELED> is placed in "
4612 "I<*retval>."
4613 msgstr ""
4614
4615 #. type: Plain text
4616 #: build/C/man3/pthread_join.3:70
4617 msgid ""
4618 "If multiple threads simultaneously try to join with the same thread, the "
4619 "results are undefined.  If the thread calling B<pthread_join>()  is "
4620 "canceled, then the target thread will remain joinable (i.e., it will not be "
4621 "detached)."
4622 msgstr ""
4623
4624 #. type: Plain text
4625 #: build/C/man3/pthread_join.3:75
4626 msgid ""
4627 "On success, B<pthread_join>()  returns 0; on error, it returns an error "
4628 "number."
4629 msgstr ""
4630
4631 #. type: TP
4632 #: build/C/man3/pthread_join.3:76
4633 #, no-wrap
4634 msgid "B<EDEADLK>"
4635 msgstr ""
4636
4637 #.  The following verified by testing on glibc 2.8/NPTL:
4638 #.  The following verified by testing on glibc 2.8/NPTL:
4639 #. type: Plain text
4640 #: build/C/man3/pthread_join.3:85
4641 msgid ""
4642 "A deadlock was detected (e.g., two threads tried to join with each other); "
4643 "or I<thread> specifies the calling thread."
4644 msgstr ""
4645
4646 #.  POSIX.1-2001 does not specify this error case.
4647 #. type: Plain text
4648 #: build/C/man3/pthread_join.3:93
4649 msgid "Another thread is already waiting to join with this thread."
4650 msgstr ""
4651
4652 #. type: Plain text
4653 #: build/C/man3/pthread_join.3:104
4654 msgid ""
4655 "After a successful call to B<pthread_join>(), the caller is guaranteed that "
4656 "the target thread has terminated."
4657 msgstr ""
4658
4659 #. type: Plain text
4660 #: build/C/man3/pthread_join.3:107
4661 msgid ""
4662 "Joining with a thread that has previously been joined results in undefined "
4663 "behavior."
4664 msgstr ""
4665
4666 #. type: Plain text
4667 #: build/C/man3/pthread_join.3:115
4668 msgid ""
4669 "Failure to join with a thread that is joinable (i.e., one that is not "
4670 "detached), produces a \"zombie thread\".  Avoid doing this, since each "
4671 "zombie thread consumes some system resources, and when enough zombie threads "
4672 "have accumulated, it will no longer be possible to create new threads (or "
4673 "processes)."
4674 msgstr ""
4675
4676 #. type: Plain text
4677 #: build/C/man3/pthread_join.3:121
4678 msgid ""
4679 "There is no pthreads analog of I<waitpid(-1,\\ &status,\\ 0)>, that is, "
4680 "\"join with any terminated thread\".  If you believe you need this "
4681 "functionality, you probably need to rethink your application design."
4682 msgstr ""
4683
4684 #. type: Plain text
4685 #: build/C/man3/pthread_join.3:124
4686 msgid ""
4687 "All of the threads in a process are peers: any thread can join with any "
4688 "other thread in the process."
4689 msgstr ""
4690
4691 #. type: Plain text
4692 #: build/C/man3/pthread_join.3:134
4693 msgid ""
4694 "B<pthread_cancel>(3), B<pthread_create>(3), B<pthread_detach>(3), "
4695 "B<pthread_exit>(3), B<pthread_tryjoin_np>(3), B<pthreads>(7)"
4696 msgstr ""
4697
4698 #. type: TH
4699 #: build/C/man3/pthread_kill.3:26
4700 #, no-wrap
4701 msgid "PTHREAD_KILL"
4702 msgstr ""
4703
4704 #. type: TH
4705 #: build/C/man3/pthread_kill.3:26 build/C/man3/pthread_sigqueue.3:25
4706 #, no-wrap
4707 msgid "2012-08-19"
4708 msgstr ""
4709
4710 #. type: Plain text
4711 #: build/C/man3/pthread_kill.3:29
4712 msgid "pthread_kill - send a signal to a thread"
4713 msgstr ""
4714
4715 #. type: Plain text
4716 #: build/C/man3/pthread_kill.3:32 build/C/man3/pthread_sigmask.3:32
4717 #, no-wrap
4718 msgid "B<#include E<lt>signal.hE<gt>>\n"
4719 msgstr ""
4720
4721 #. type: Plain text
4722 #: build/C/man3/pthread_kill.3:34
4723 #, no-wrap
4724 msgid "B<int pthread_kill(pthread_t >I<thread>B<, int >I<sig>B<);>\n"
4725 msgstr ""
4726
4727 #. type: Plain text
4728 #: build/C/man3/pthread_kill.3:47
4729 msgid ""
4730 "The B<pthread_kill>()  function sends the signal I<sig> to I<thread>, a "
4731 "thread in the same process as the caller.  The signal is asynchronously "
4732 "directed to I<thread>."
4733 msgstr ""
4734
4735 #. type: Plain text
4736 #: build/C/man3/pthread_kill.3:52
4737 msgid ""
4738 "If I<sig> is 0, then no signal is sent, but error checking is still "
4739 "performed; this can be used to check for the existence of a thread ID."
4740 msgstr ""
4741
4742 #. type: Plain text
4743 #: build/C/man3/pthread_kill.3:57
4744 msgid ""
4745 "On success, B<pthread_kill>()  returns 0; on error, it returns an error "
4746 "number, and no signal is sent."
4747 msgstr ""
4748
4749 #. type: Plain text
4750 #: build/C/man3/pthread_kill.3:61
4751 msgid "An invalid signal was specified."
4752 msgstr ""
4753
4754 #. type: Plain text
4755 #: build/C/man3/pthread_kill.3:75
4756 msgid ""
4757 "Signal dispositions are process-wide: if a signal handler is installed, the "
4758 "handler will be invoked in the thread I<thread>, but if the disposition of "
4759 "the signal is \"stop\", \"continue\", or \"terminate\", this action will "
4760 "affect the whole process."
4761 msgstr ""
4762
4763 #. type: Plain text
4764 #: build/C/man3/pthread_kill.3:84
4765 msgid ""
4766 "B<kill>(2), B<sigaction>(2), B<sigpending>(2), B<pthread_self>(3), "
4767 "B<pthread_sigmask>(3), B<raise>(3), B<pthreads>(7), B<signal>(7)"
4768 msgstr ""
4769
4770 #. type: TH
4771 #: build/C/man3/pthread_kill_other_threads_np.3:26
4772 #, no-wrap
4773 msgid "PTHREAD_KILL_OTHER_THREADS_NP"
4774 msgstr ""
4775
4776 #. type: TH
4777 #: build/C/man3/pthread_kill_other_threads_np.3:26
4778 #, no-wrap
4779 msgid "2010-09-09"
4780 msgstr ""
4781
4782 #. type: Plain text
4783 #: build/C/man3/pthread_kill_other_threads_np.3:29
4784 msgid "pthread_kill_other_threads_np - terminate all other threads in process"
4785 msgstr ""
4786
4787 #. type: Plain text
4788 #: build/C/man3/pthread_kill_other_threads_np.3:34
4789 #, no-wrap
4790 msgid "B<void pthread_kill_other_threads_np(void);>\n"
4791 msgstr ""
4792
4793 #.  .SH VERSIONS
4794 #.  Available since glibc 2.0
4795 #. type: Plain text
4796 #: build/C/man3/pthread_kill_other_threads_np.3:47
4797 msgid ""
4798 "B<pthread_kill_other_threads_np>()  has an effect only in the LinuxThreads "
4799 "threading implementation.  On that implementation, calling this function "
4800 "causes the immediate termination of all threads in the application, except "
4801 "the calling thread.  The cancellation state and cancellation type of the "
4802 "to-be-terminated threads are ignored, and the cleanup handlers are not "
4803 "called in those threads."
4804 msgstr ""
4805
4806 #. type: Plain text
4807 #: build/C/man3/pthread_kill_other_threads_np.3:59
4808 msgid ""
4809 "B<pthread_kill_other_threads_np>()  is intended to be called just before a "
4810 "thread calls B<execve>(2)  or a similar function.  This function is designed "
4811 "to address a limitation in the obsolete LinuxThreads implementation whereby "
4812 "the other threads of an application are not automatically terminated (as "
4813 "POSIX.1-2001 requires) during B<execve>(2)."
4814 msgstr ""
4815
4816 #. type: Plain text
4817 #: build/C/man3/pthread_kill_other_threads_np.3:66
4818 msgid ""
4819 "In the NPTL threading implementation, B<pthread_kill_other_threads_np>()  "
4820 "exists, but does nothing.  (Nothing needs to be done, because the "
4821 "implementation does the right thing during an B<execve>(2).)"
4822 msgstr ""
4823
4824 #. type: Plain text
4825 #: build/C/man3/pthread_kill_other_threads_np.3:72
4826 msgid ""
4827 "B<execve>(2), B<pthread_cancel>(3), B<pthread_setcancelstate>(3), "
4828 "B<pthread_setcanceltype>(3), B<pthreads>(7)"
4829 msgstr ""
4830
4831 #. type: TH
4832 #: build/C/man3/pthread_self.3:26
4833 #, no-wrap
4834 msgid "PTHREAD_SELF"
4835 msgstr ""
4836
4837 #. type: Plain text
4838 #: build/C/man3/pthread_self.3:29
4839 msgid "pthread_self - obtain ID of the calling thread"
4840 msgstr ""
4841
4842 #. type: Plain text
4843 #: build/C/man3/pthread_self.3:34
4844 #, no-wrap
4845 msgid "B<pthread_t pthread_self(void);>\n"
4846 msgstr ""
4847
4848 #. type: Plain text
4849 #: build/C/man3/pthread_self.3:46
4850 msgid ""
4851 "The B<pthread_self>()  function returns the ID of the calling thread.  This "
4852 "is the same value that is returned in I<*thread> in the B<pthread_create>(3)  "
4853 "call that created this thread."
4854 msgstr ""
4855
4856 #. type: Plain text
4857 #: build/C/man3/pthread_self.3:48
4858 msgid "This function always succeeds, returning the calling thread's ID."
4859 msgstr ""
4860
4861 #. type: Plain text
4862 #: build/C/man3/pthread_self.3:63
4863 msgid ""
4864 "POSIX.1 allows an implementation wide freedom in choosing the type used to "
4865 "represent a thread ID; for example, representation using either an "
4866 "arithmetic type or a structure is permitted.  Therefore, variables of type "
4867 "I<pthread_t> can't portably be compared using the C equality operator "
4868 "(B<==>); use B<pthread_equal>(3)  instead."
4869 msgstr ""
4870
4871 #. type: Plain text
4872 #: build/C/man3/pthread_self.3:67
4873 msgid ""
4874 "Thread identifiers should be considered opaque: any attempt to use a thread "
4875 "ID other than in pthreads calls is nonportable and can lead to unspecified "
4876 "results."
4877 msgstr ""
4878
4879 #. type: Plain text
4880 #: build/C/man3/pthread_self.3:71
4881 msgid ""
4882 "Thread IDs are guaranteed to be unique only within a process.  A thread ID "
4883 "may be reused after a terminated thread has been joined, or a detached "
4884 "thread has terminated."
4885 msgstr ""
4886
4887 #. type: Plain text
4888 #: build/C/man3/pthread_self.3:76
4889 msgid ""
4890 "The thread ID returned by B<pthread_self>()  is not the same thing as the "
4891 "kernel thread ID returned by a call to B<gettid>(2)."
4892 msgstr ""
4893
4894 #. type: Plain text
4895 #: build/C/man3/pthread_self.3:80
4896 msgid "B<pthread_create>(3), B<pthread_equal>(3), B<pthreads>(7)"
4897 msgstr ""
4898
4899 #. type: TH
4900 #: build/C/man3/pthread_setaffinity_np.3:26
4901 #, no-wrap
4902 msgid "PTHREAD_SETAFFINITY_NP"
4903 msgstr ""
4904
4905 #. type: Plain text
4906 #: build/C/man3/pthread_setaffinity_np.3:30
4907 msgid ""
4908 "pthread_setaffinity_np, pthread_getaffinity_np - set/get CPU affinity of a "
4909 "thread"
4910 msgstr ""
4911
4912 #. type: Plain text
4913 #: build/C/man3/pthread_setaffinity_np.3:39
4914 #, no-wrap
4915 msgid ""
4916 "B<int pthread_setaffinity_np(pthread_t >I<thread>B<, size_t "
4917 ">I<cpusetsize>B<,>\n"
4918 "B<                           const cpu_set_t *>I<cpuset>B<);>\n"
4919 "B<int pthread_getaffinity_np(pthread_t >I<thread>B<, size_t "
4920 ">I<cpusetsize>B<,>\n"
4921 "B<                           cpu_set_t *>I<cpuset>B<);>\n"
4922 msgstr ""
4923
4924 #. type: Plain text
4925 #: build/C/man3/pthread_setaffinity_np.3:54
4926 msgid ""
4927 "The B<pthread_setaffinity_np>()  function sets the CPU affinity mask of the "
4928 "thread I<thread> to the CPU set pointed to by I<cpuset>.  If the call is "
4929 "successful, and the thread is not currently running on one of the CPUs in "
4930 "I<cpuset>, then it is migrated to one of those CPUs."
4931 msgstr ""
4932
4933 #. type: Plain text
4934 #: build/C/man3/pthread_setaffinity_np.3:61
4935 msgid ""
4936 "The B<pthread_getaffinity_np>()  function returns the CPU affinity mask of "
4937 "the thread I<thread> in the buffer pointed to by I<cpuset>."
4938 msgstr ""
4939
4940 #. type: Plain text
4941 #: build/C/man3/pthread_setaffinity_np.3:77
4942 msgid ""
4943 "The argument I<cpusetsize> is the length (in bytes) of the buffer pointed to "
4944 "by I<cpuset>.  Typically, this argument would be specified as "
4945 "I<sizeof(cpu_set_t)>.  (It may be some other value, if using the macros "
4946 "described in B<CPU_SET>(3)  for dynamically allocating a CPU set.)"
4947 msgstr ""
4948
4949 #. type: TP
4950 #: build/C/man3/pthread_setaffinity_np.3:81
4951 #, no-wrap
4952 msgid "B<EFAULT>"
4953 msgstr ""
4954
4955 #. type: Plain text
4956 #: build/C/man3/pthread_setaffinity_np.3:84
4957 msgid "A supplied memory address was invalid."
4958 msgstr ""
4959
4960 #. type: Plain text
4961 #: build/C/man3/pthread_setaffinity_np.3:93
4962 msgid ""
4963 "(B<pthread_setaffinity_np>())  The affinity bit mask I<mask> contains no "
4964 "processors that are currently physically on the system and permitted to the "
4965 "thread according to any restrictions that may be imposed by the \"cpuset\" "
4966 "mechanism described in B<cpuset>(7)."
4967 msgstr ""
4968
4969 #.  FIXME . ?
4970 #.  Loic Domaigne commented: it seems that in the future the
4971 #.  kernel developers want to make cpumask_t dynamic, so
4972 #.  CONFIG_NR_CPUS might become obsolete in the future.
4973 #.  cpumask_t
4974 #.  The raw sched_getaffinity() system call returns the size (in bytes)
4975 #.  of the cpumask_t type.
4976 #. type: Plain text
4977 #: build/C/man3/pthread_setaffinity_np.3:109
4978 msgid ""
4979 "(B<pthread_setaffinity_np>())  I<cpuset> specified a CPU that was outside "
4980 "the set supported by the kernel.  (The kernel configuration option "
4981 "B<CONFIG_NR_CPUS> defines the range of the set supported by the kernel data "
4982 "type used to represent CPU sets.)"
4983 msgstr ""
4984
4985 #. type: Plain text
4986 #: build/C/man3/pthread_setaffinity_np.3:114
4987 msgid ""
4988 "(B<pthread_getaffinity_np>())  I<cpusetsize> is smaller than the size of the "
4989 "affinity mask used by the kernel."
4990 msgstr ""
4991
4992 #. type: Plain text
4993 #: build/C/man3/pthread_setaffinity_np.3:137
4994 msgid ""
4995 "After a call to B<pthread_setaffinity_np>(), the set of CPUs on which the "
4996 "thread will actually run is the intersection of the set specified in the "
4997 "I<cpuset> argument and the set of CPUs actually present on the system.  The "
4998 "system may further restrict the set of CPUs on which the thread runs if the "
4999 "\"cpuset\" mechanism described in B<cpuset>(7)  is being used.  These "
5000 "restrictions on the actual set of CPUs on which the thread will run are "
5001 "silently imposed by the kernel."
5002 msgstr ""
5003
5004 #. type: Plain text
5005 #: build/C/man3/pthread_setaffinity_np.3:143
5006 msgid ""
5007 "These functions are implemented on top of the B<sched_setaffinity>(2)  and "
5008 "B<sched_getaffinity>(2)  system calls."
5009 msgstr ""
5010
5011 #. type: Plain text
5012 #: build/C/man3/pthread_setaffinity_np.3:154
5013 msgid ""
5014 "A new thread created by B<pthread_create>(3)  inherits a copy of its "
5015 "creator's CPU affinity mask."
5016 msgstr ""
5017
5018 #. type: Plain text
5019 #: build/C/man3/pthread_setaffinity_np.3:162
5020 msgid ""
5021 "In the following program, the main thread uses B<pthread_setaffinity_np>()  "
5022 "to set its CPU affinity mask to include CPUs 0 to 7 (which may not all be "
5023 "available on the system), and then calls B<pthread_getaffinity_np>()  to "
5024 "check the resulting CPU affinity mask of the thread."
5025 msgstr ""
5026
5027 #. type: Plain text
5028 #: build/C/man3/pthread_setaffinity_np.3:169
5029 #, no-wrap
5030 msgid ""
5031 "#define _GNU_SOURCE\n"
5032 "#include E<lt>pthread.hE<gt>\n"
5033 "#include E<lt>stdio.hE<gt>\n"
5034 "#include E<lt>stdlib.hE<gt>\n"
5035 "#include E<lt>errno.hE<gt>\n"
5036 msgstr ""
5037
5038 #. type: Plain text
5039 #: build/C/man3/pthread_setaffinity_np.3:179
5040 #, no-wrap
5041 msgid ""
5042 "int\n"
5043 "main(int argc, char *argv[])\n"
5044 "{\n"
5045 "    int s, j;\n"
5046 "    cpu_set_t cpuset;\n"
5047 "    pthread_t thread;\n"
5048 msgstr ""
5049
5050 #. type: Plain text
5051 #: build/C/man3/pthread_setaffinity_np.3:181
5052 #, no-wrap
5053 msgid "    thread = pthread_self();\n"
5054 msgstr ""
5055
5056 #. type: Plain text
5057 #: build/C/man3/pthread_setaffinity_np.3:183
5058 #, no-wrap
5059 msgid "    /* Set affinity mask to include CPUs 0 to 7 */\n"
5060 msgstr ""
5061
5062 #. type: Plain text
5063 #: build/C/man3/pthread_setaffinity_np.3:187
5064 #, no-wrap
5065 msgid ""
5066 "    CPU_ZERO(&cpuset);\n"
5067 "    for (j = 0; j E<lt> 8; j++)\n"
5068 "        CPU_SET(j, &cpuset);\n"
5069 msgstr ""
5070
5071 #. type: Plain text
5072 #: build/C/man3/pthread_setaffinity_np.3:191
5073 #, no-wrap
5074 msgid ""
5075 "    s = pthread_setaffinity_np(thread, sizeof(cpu_set_t), &cpuset);\n"
5076 "    if (s != 0)\n"
5077 "        handle_error_en(s, \"pthread_setaffinity_np\");\n"
5078 msgstr ""
5079
5080 #. type: Plain text
5081 #: build/C/man3/pthread_setaffinity_np.3:193
5082 #, no-wrap
5083 msgid "    /* Check the actual affinity mask assigned to the thread */\n"
5084 msgstr ""
5085
5086 #. type: Plain text
5087 #: build/C/man3/pthread_setaffinity_np.3:197
5088 #, no-wrap
5089 msgid ""
5090 "    s = pthread_getaffinity_np(thread, sizeof(cpu_set_t), &cpuset);\n"
5091 "    if (s != 0)\n"
5092 "        handle_error_en(s, \"pthread_getaffinity_np\");\n"
5093 msgstr ""
5094
5095 #. type: Plain text
5096 #: build/C/man3/pthread_setaffinity_np.3:202
5097 #, no-wrap
5098 msgid ""
5099 "    printf(\"Set returned by pthread_getaffinity_np() contained:\\en\");\n"
5100 "    for (j = 0; j E<lt> CPU_SETSIZE; j++)\n"
5101 "        if (CPU_ISSET(j, &cpuset))\n"
5102 "            printf(\"    CPU %d\\en\", j);\n"
5103 msgstr ""
5104
5105 #. type: Plain text
5106 #: build/C/man3/pthread_setaffinity_np.3:205 build/C/man3/pthread_setschedparam.3:430
5107 #, no-wrap
5108 msgid ""
5109 "    exit(EXIT_SUCCESS);\n"
5110 "}\n"
5111 msgstr ""
5112
5113 #. type: Plain text
5114 #: build/C/man3/pthread_setaffinity_np.3:214
5115 msgid ""
5116 "B<sched_setaffinity>(2), B<sched_setscheduler>(2), "
5117 "B<pthread_attr_setaffinity_np>(3), B<pthread_self>(3), B<sched_getcpu>(3), "
5118 "B<cpuset>(7), B<pthreads>(7)"
5119 msgstr ""
5120
5121 #. type: TH
5122 #: build/C/man3/pthread_setcancelstate.3:26
5123 #, no-wrap
5124 msgid "PTHREAD_SETCANCELSTATE"
5125 msgstr ""
5126
5127 #. type: Plain text
5128 #: build/C/man3/pthread_setcancelstate.3:30
5129 msgid ""
5130 "pthread_setcancelstate, pthread_setcanceltype - set cancelability state and "
5131 "type"
5132 msgstr ""
5133
5134 #. type: Plain text
5135 #: build/C/man3/pthread_setcancelstate.3:36
5136 #, no-wrap
5137 msgid ""
5138 "B<int pthread_setcancelstate(int >I<state>B<, int *>I<oldstate>B<);>\n"
5139 "B<int pthread_setcanceltype(int >I<type>B<, int *>I<oldtype>B<);>\n"
5140 msgstr ""
5141
5142 #. type: Plain text
5143 #: build/C/man3/pthread_setcancelstate.3:51
5144 msgid ""
5145 "The B<pthread_setcancelstate>()  sets the cancelability state of the calling "
5146 "thread to the value given in I<state>.  The previous cancelability state of "
5147 "the thread is returned in the buffer pointed to by I<oldstate>.  The "
5148 "I<state> argument must have one of the following values:"
5149 msgstr ""
5150
5151 #. type: TP
5152 #: build/C/man3/pthread_setcancelstate.3:51
5153 #, no-wrap
5154 msgid "B<PTHREAD_CANCEL_ENABLE>"
5155 msgstr ""
5156
5157 #. type: Plain text
5158 #: build/C/man3/pthread_setcancelstate.3:58
5159 msgid ""
5160 "The thread is cancelable.  This is the default cancelability state in all "
5161 "new threads, including the initial thread.  The thread's cancelability type "
5162 "determines when a cancelable thread will respond to a cancellation request."
5163 msgstr ""
5164
5165 #. type: TP
5166 #: build/C/man3/pthread_setcancelstate.3:58
5167 #, no-wrap
5168 msgid "B<PTHREAD_CANCEL_DISABLE>"
5169 msgstr ""
5170
5171 #. type: Plain text
5172 #: build/C/man3/pthread_setcancelstate.3:63
5173 msgid ""
5174 "The thread is not cancelable.  If a cancellation request is received, it is "
5175 "blocked until cancelability is enabled."
5176 msgstr ""
5177
5178 #. type: Plain text
5179 #: build/C/man3/pthread_setcancelstate.3:75
5180 msgid ""
5181 "The B<pthread_setcanceltype>()  sets the cancelability type of the calling "
5182 "thread to the value given in I<type>.  The previous cancelability type of "
5183 "the thread is returned in the buffer pointed to by I<oldtype>.  The I<type> "
5184 "argument must have one of the following values:"
5185 msgstr ""
5186
5187 #. type: TP
5188 #: build/C/man3/pthread_setcancelstate.3:75
5189 #, no-wrap
5190 msgid "B<PTHREAD_CANCEL_DEFERRED>"
5191 msgstr ""
5192
5193 #. type: Plain text
5194 #: build/C/man3/pthread_setcancelstate.3:82
5195 msgid ""
5196 "A cancellation request is deferred until the thread next calls a function "
5197 "that is a cancellation point (see B<pthreads>(7)).  This is the default "
5198 "cancelability type in all new threads, including the initial thread."
5199 msgstr ""
5200
5201 #. type: TP
5202 #: build/C/man3/pthread_setcancelstate.3:82
5203 #, no-wrap
5204 msgid "B<PTHREAD_CANCEL_ASYNCHRONOUS>"
5205 msgstr ""
5206
5207 #. type: Plain text
5208 #: build/C/man3/pthread_setcancelstate.3:88
5209 msgid ""
5210 "The thread can be canceled at any time.  (Typically, it will be canceled "
5211 "immediately upon receiving a cancellation request, but the system doesn't "
5212 "guarantee this.)"
5213 msgstr ""
5214
5215 #. type: Plain text
5216 #: build/C/man3/pthread_setcancelstate.3:92
5217 msgid ""
5218 "The set-and-get operation performed by each of these functions is atomic "
5219 "with respect to other threads in the process calling the same function."
5220 msgstr ""
5221
5222 #. type: Plain text
5223 #: build/C/man3/pthread_setcancelstate.3:99
5224 msgid "The B<pthread_setcancelstate>()  can fail with the following error:"
5225 msgstr ""
5226
5227 #. type: Plain text
5228 #: build/C/man3/pthread_setcancelstate.3:103
5229 msgid "Invalid value for I<state>."
5230 msgstr ""
5231
5232 #. type: Plain text
5233 #: build/C/man3/pthread_setcancelstate.3:107
5234 msgid "The B<pthread_setcanceltype>()  can fail with the following error:"
5235 msgstr ""
5236
5237 #.  .SH VERSIONS
5238 #.  Available since glibc 2.0
5239 #. type: Plain text
5240 #: build/C/man3/pthread_setcancelstate.3:113
5241 msgid "Invalid value for I<type>."
5242 msgstr ""
5243
5244 #. type: Plain text
5245 #: build/C/man3/pthread_setcancelstate.3:118
5246 msgid ""
5247 "For details of what happens when a thread is canceled, see "
5248 "B<pthread_cancel>(3)."
5249 msgstr ""
5250
5251 #. type: Plain text
5252 #: build/C/man3/pthread_setcancelstate.3:125
5253 msgid ""
5254 "Briefly disabling cancelability is useful if a thread performs some critical "
5255 "action that must not be interrupted by a cancellation request.  Beware of "
5256 "disabling cancelability for long periods, or around operations that may "
5257 "block for long periods, since that will render the thread unresponsive to "
5258 "cancellation requests."
5259 msgstr ""
5260
5261 #. type: Plain text
5262 #: build/C/man3/pthread_setcancelstate.3:156
5263 msgid ""
5264 "Setting the cancelability type to B<PTHREAD_CANCEL_ASYNCHRONOUS> is rarely "
5265 "useful.  Since the thread could be canceled at I<any> time, it cannot safely "
5266 "reserve resources (e.g., allocating memory with B<malloc>(3)), acquire "
5267 "mutexes, semaphores, or locks, and so on.  Reserving resources is unsafe "
5268 "because the application has no way of knowing what the state of these "
5269 "resources is when the thread is canceled; that is, did cancellation occur "
5270 "before the resources were reserved, while they were reserved, or after they "
5271 "were released? Furthermore, some internal data structures (e.g., the linked "
5272 "list of free blocks managed by the B<malloc>(3)  family of functions) may be "
5273 "left in an inconsistent state if cancellation occurs in the middle of the "
5274 "function call.  Consequently, clean-up handlers cease to be useful.  "
5275 "Functions that can be safely asynchronously canceled are called "
5276 "I<async-cancel-safe functions>.  POSIX.1-2001 requires only that "
5277 "B<pthread_cancel>(3), B<pthread_setcancelstate>(), and "
5278 "B<pthread_setcanceltype>()  be async-cancel-safe.  In general, other library "
5279 "functions can't be safely called from an asynchronously cancelable thread.  "
5280 "One of the few circumstances in which asynchronous cancelability is useful "
5281 "is for cancellation of a thread that is in a pure compute-bound loop."
5282 msgstr ""
5283
5284 #.  It looks like at least Solaris, FreeBSD and Tru64 support this.
5285 #. type: Plain text
5286 #: build/C/man3/pthread_setcancelstate.3:174
5287 msgid ""
5288 "The Linux threading implementations permit the I<oldstate> argument of "
5289 "B<pthread_setcancelstate>()  to be NULL, in which case the information about "
5290 "the previous cancelability state is not returned to the caller.  Many other "
5291 "implementations also permit a NULL I<oldstat> argument, but POSIX.1-2001 "
5292 "does not specify this point, so portable applications should always specify "
5293 "a non-NULL value in I<oldstate>.  A precisely analogous set of statements "
5294 "applies for the I<oldtype> argument of B<pthread_setcanceltype>()."
5295 msgstr ""
5296
5297 #. type: Plain text
5298 #: build/C/man3/pthread_setcancelstate.3:177
5299 msgid "See B<pthread_cancel>(3)."
5300 msgstr ""
5301
5302 #. type: Plain text
5303 #: build/C/man3/pthread_setcancelstate.3:182
5304 msgid ""
5305 "B<pthread_cancel>(3), B<pthread_cleanup_push>(3), B<pthread_testcancel>(3), "
5306 "B<pthreads>(7)"
5307 msgstr ""
5308
5309 #. type: TH
5310 #: build/C/man3/pthread_setconcurrency.3:25
5311 #, no-wrap
5312 msgid "PTHREAD_SETCONCURRENCY"
5313 msgstr ""
5314
5315 #. type: TH
5316 #: build/C/man3/pthread_setconcurrency.3:25
5317 #, no-wrap
5318 msgid "2009-04-10"
5319 msgstr ""
5320
5321 #. type: Plain text
5322 #: build/C/man3/pthread_setconcurrency.3:29
5323 msgid ""
5324 "pthread_setconcurrency, pthread_getconcurrency - set/get the concurrency "
5325 "level"
5326 msgstr ""
5327
5328 #. type: Plain text
5329 #: build/C/man3/pthread_setconcurrency.3:35
5330 #, no-wrap
5331 msgid ""
5332 "B<int pthread_setconcurrency(int >I<new_level>B<);>\n"
5333 "B<int pthread_getconcurrency(void);>\n"
5334 msgstr ""
5335
5336 #. type: Plain text
5337 #: build/C/man3/pthread_setconcurrency.3:48
5338 msgid ""
5339 "The B<pthread_setconcurrency>()  function informs the implementation of the "
5340 "application's desired concurrency level, specified in I<new_level>.  The "
5341 "implementation takes this only as a hint: POSIX.1 does not specify the level "
5342 "of concurrency that should be provided as a result of calling "
5343 "B<pthread_setconcurrency>()."
5344 msgstr ""
5345
5346 #. type: Plain text
5347 #: build/C/man3/pthread_setconcurrency.3:53
5348 msgid ""
5349 "Specifying I<new_level> as 0 instructs the implementation to manage the "
5350 "concurrency level as it deems appropriate."
5351 msgstr ""
5352
5353 #. type: Plain text
5354 #: build/C/man3/pthread_setconcurrency.3:56
5355 msgid ""
5356 "B<pthread_getconcurrency>()  returns the current value of the concurrency "
5357 "level for this process."
5358 msgstr ""
5359
5360 #. type: Plain text
5361 #: build/C/man3/pthread_setconcurrency.3:61
5362 msgid ""
5363 "On success, B<pthread_setconcurrency>()  returns 0; on error, it returns a "
5364 "nonzero error number."
5365 msgstr ""
5366
5367 #. type: Plain text
5368 #: build/C/man3/pthread_setconcurrency.3:68
5369 msgid ""
5370 "B<pthread_getconcurrency>()  always succeeds, returning the concurrency "
5371 "level set by a previous call to B<pthread_setconcurrency>(), or 0, if "
5372 "B<pthread_setconcurrency>()  has not previously been called."
5373 msgstr ""
5374
5375 #. type: Plain text
5376 #: build/C/man3/pthread_setconcurrency.3:71
5377 msgid "B<pthread_setconcurrency>()  can fail with the following error:"
5378 msgstr ""
5379
5380 #. type: Plain text
5381 #: build/C/man3/pthread_setconcurrency.3:75
5382 msgid "I<new_level> is negative."
5383 msgstr ""
5384
5385 #. type: Plain text
5386 #: build/C/man3/pthread_setconcurrency.3:81
5387 msgid ""
5388 "POSIX.1-2001 also documents an B<EAGAIN> error (\"the value specified by "
5389 "I<new_level> would cause a system resource to be exceeded\")."
5390 msgstr ""
5391
5392 #. type: Plain text
5393 #: build/C/man3/pthread_setconcurrency.3:83
5394 msgid "These functions are available in glibc since version 2.1."
5395 msgstr ""
5396
5397 #. type: Plain text
5398 #: build/C/man3/pthread_setconcurrency.3:87
5399 msgid "The default concurrency level is 0."
5400 msgstr ""
5401
5402 #. type: Plain text
5403 #: build/C/man3/pthread_setconcurrency.3:94
5404 msgid ""
5405 "Concurrency levels are meaningful only for M:N threading implementations, "
5406 "where at any moment a subset of a process's set of user-level threads may be "
5407 "bound to a smaller number of kernel-scheduling entities.  Setting the "
5408 "concurrency level allows the application to give the system a hint as to the "
5409 "number of kernel-scheduling entities that should be provided for efficient "
5410 "execution of the application."
5411 msgstr ""
5412
5413 #. type: Plain text
5414 #: build/C/man3/pthread_setconcurrency.3:100
5415 msgid ""
5416 "Both LinuxThreads and NPTL are 1:1 threading implementations, so setting the "
5417 "concurrency level has no meaning.  In other words, on Linux these functions "
5418 "merely exist for compatibility with other systems, and they have no effect "
5419 "on the execution of a program."
5420 msgstr ""
5421
5422 #. type: Plain text
5423 #: build/C/man3/pthread_setconcurrency.3:103
5424 msgid "B<pthread_attr_setscope>(3), B<pthreads>(7)"
5425 msgstr ""
5426
5427 #. type: TH
5428 #: build/C/man3/pthread_setname_np.3:26
5429 #, no-wrap
5430 msgid "PTHREAD_SETNAME_NP"
5431 msgstr ""
5432
5433 #. type: Plain text
5434 #: build/C/man3/pthread_setname_np.3:29
5435 msgid "pthread_setname_np, pthread_getname_np - set/get the name of a thread"
5436 msgstr ""
5437
5438 #. type: Plain text
5439 #: build/C/man3/pthread_setname_np.3:36
5440 #, no-wrap
5441 msgid ""
5442 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
5443 "B<#include E<lt>pthread.hE<gt>>\n"
5444 "B<int pthread_setname_np(pthread_t >I<thread>B<, const char *>I<name>B<);>\n"
5445 "B<int pthread_getname_np(pthread_t >I<thread>B<,>\n"
5446 "B<                       const char *>I<name>B<, size_t >I<len>B<);>\n"
5447 msgstr ""
5448
5449 #. type: Plain text
5450 #: build/C/man3/pthread_setname_np.3:55
5451 msgid ""
5452 "By default, all the threads created using B<pthread_create>()  inherit the "
5453 "program name.  The B<pthread_setname_np>()  function can be used to set a "
5454 "unique name for a thread, which can be useful for debugging multithreaded "
5455 "applications.  The thread name is a meaningful C language string, whose "
5456 "length is restricted to 16 characters, including the terminating null byte "
5457 "(\\(aq\\e0\\(aq).  The I<thread> argument specifies the thread whose name is "
5458 "to be changed; I<name> specifies the new name."
5459 msgstr ""
5460
5461 #. type: Plain text
5462 #: build/C/man3/pthread_setname_np.3:72
5463 msgid ""
5464 "The B<pthread_getname_np>()  function can be used to retrieve the name of "
5465 "the thread.  The I<thread> argument specifies the thread whose name is to be "
5466 "retrieved.  The buffer I<name> is used to return the thread name; I<len> "
5467 "specifies the number of bytes available in I<name>.  The buffer specified by "
5468 "I<name> should be at least 16 characters in length.  The returned thread "
5469 "name in the output buffer will be null terminated."
5470 msgstr ""
5471
5472 #. type: Plain text
5473 #: build/C/man3/pthread_setname_np.3:79
5474 msgid "The B<pthread_setname_np>()  function can fail with the following error:"
5475 msgstr ""
5476
5477 #. type: TP
5478 #: build/C/man3/pthread_setname_np.3:79 build/C/man3/pthread_setname_np.3:88
5479 #, no-wrap
5480 msgid "B<ERANGE>"
5481 msgstr ""
5482
5483 #. type: Plain text
5484 #: build/C/man3/pthread_setname_np.3:84
5485 msgid ""
5486 "The length of the string specified pointed to by I<name> exceeds the allowed "
5487 "limit."
5488 msgstr ""
5489
5490 #. type: Plain text
5491 #: build/C/man3/pthread_setname_np.3:88
5492 msgid "The B<pthread_getname_np>()  function can fail with the following error:"
5493 msgstr ""
5494
5495 #. type: Plain text
5496 #: build/C/man3/pthread_setname_np.3:95
5497 msgid ""
5498 "The buffer specified by I<name> and I<len> is too small to hold the thread "
5499 "name."
5500 msgstr ""
5501
5502 #. type: Plain text
5503 #: build/C/man3/pthread_setname_np.3:100
5504 msgid ""
5505 "If either of these functions fails to open I</proc/self/task/[tid]/comm>, "
5506 "then the call may fail with one of the errors described in B<open>(2)."
5507 msgstr ""
5508
5509 #. type: Plain text
5510 #: build/C/man3/pthread_setname_np.3:102
5511 msgid "These functions first appeared in glibc in version 2.12."
5512 msgstr ""
5513
5514 #. type: Plain text
5515 #: build/C/man3/pthread_setname_np.3:104
5516 msgid "These functions are nonstandard GNU extensions."
5517 msgstr ""
5518
5519 #. type: Plain text
5520 #: build/C/man3/pthread_setname_np.3:112
5521 msgid ""
5522 "B<pthread_setname_np>()  internally writes to the thread specific comm file "
5523 "under I</proc> filesystem: I</proc/self/task/[tid]/comm>.  "
5524 "B<pthread_getname_np>()  retrieves it from the same location."
5525 msgstr ""
5526
5527 #. type: Plain text
5528 #: build/C/man3/pthread_setname_np.3:118
5529 msgid ""
5530 "The program below demonstrates the use of B<pthread_setname_np>()  and "
5531 "B<pthread_getname_np>()."
5532 msgstr ""
5533
5534 #. type: Plain text
5535 #: build/C/man3/pthread_setname_np.3:120
5536 msgid "The following shell session shows a sample run of the program:"
5537 msgstr ""
5538
5539 #. type: Plain text
5540 #: build/C/man3/pthread_setname_np.3:136
5541 #, no-wrap
5542 msgid ""
5543 "$B< ./a.out>\n"
5544 "Created a thread. Default name is: a.out\n"
5545 "The thread name after setting it is THREADFOO.\n"
5546 "B<^Z>                           # Suspend the program\n"
5547 "[1]+  Stopped           ./a.out\n"
5548 "$ B<ps H -C a.out -o 'pid tid cmd comm'>\n"
5549 "  PID   TID CMD                         COMMAND\n"
5550 " 5990  5990 ./a.out                     a.out\n"
5551 " 5990  5991 ./a.out                     THREADFOO\n"
5552 "$ B<cat /proc/5990/task/5990/comm>\n"
5553 "a.out\n"
5554 "$ B<cat /proc/5990/task/5991/comm>\n"
5555 "THREADFOO\n"
5556 msgstr ""
5557
5558 #. type: Plain text
5559 #: build/C/man3/pthread_setname_np.3:148
5560 #, no-wrap
5561 msgid ""
5562 "#define _GNU_SOURCE\n"
5563 "#include E<lt>pthread.hE<gt>\n"
5564 "#include E<lt>stdio.hE<gt>\n"
5565 "#include E<lt>string.hE<gt>\n"
5566 "#include E<lt>unistd.hE<gt>\n"
5567 "#include E<lt>errno.hE<gt>\n"
5568 "#include E<lt>stdlib.hE<gt>\n"
5569 msgstr ""
5570
5571 #. type: Plain text
5572 #: build/C/man3/pthread_setname_np.3:150
5573 #, no-wrap
5574 msgid "#define NAMELEN 16\n"
5575 msgstr ""
5576
5577 #. type: Plain text
5578 #: build/C/man3/pthread_setname_np.3:154
5579 #, no-wrap
5580 msgid ""
5581 "#define errExitEN(en, msg) \\e\n"
5582 "            do { errno = en; perror(msg); exit(EXIT_FAILURE); \\e\n"
5583 "        } while (0)\n"
5584 msgstr ""
5585
5586 #. type: Plain text
5587 #: build/C/man3/pthread_setname_np.3:161
5588 #, no-wrap
5589 msgid ""
5590 "static void *\n"
5591 "threadfunc(void *parm)\n"
5592 "{\n"
5593 "    sleep(5);          // allow main program to set the thread name\n"
5594 "    return NULL;\n"
5595 "}\n"
5596 msgstr ""
5597
5598 #. type: Plain text
5599 #: build/C/man3/pthread_setname_np.3:168
5600 #, no-wrap
5601 msgid ""
5602 "int\n"
5603 "main(int argc, char **argv)\n"
5604 "{\n"
5605 "    pthread_t thread;\n"
5606 "    int rc;\n"
5607 "    char thread_name[NAMELEN];\n"
5608 msgstr ""
5609
5610 #. type: Plain text
5611 #: build/C/man3/pthread_setname_np.3:172
5612 #, no-wrap
5613 msgid ""
5614 "    rc = pthread_create(&thread, NULL, threadfunc, NULL);\n"
5615 "    if (rc != 0)\n"
5616 "        errExitEN(rc, \"pthread_create\");\n"
5617 msgstr ""
5618
5619 #. type: Plain text
5620 #: build/C/man3/pthread_setname_np.3:176
5621 #, no-wrap
5622 msgid ""
5623 "    rc = pthread_getname_np(thread, thread_name, NAMELEN);\n"
5624 "    if (rc != 0)\n"
5625 "        errExitEN(rc, \"pthread_getname_np\");\n"
5626 msgstr ""
5627
5628 #. type: Plain text
5629 #: build/C/man3/pthread_setname_np.3:181
5630 #, no-wrap
5631 msgid ""
5632 "    printf(\"Created a thread. Default name is: %s\\en\", thread_name);\n"
5633 "    rc = pthread_setname_np(thread, (argc E<gt> 1) ? argv[1] : "
5634 "\"THREADFOO\");\n"
5635 "    if (rc != 0)\n"
5636 "        errExitEN(rc, \"pthread_setname_np\");\n"
5637 msgstr ""
5638
5639 #. type: Plain text
5640 #: build/C/man3/pthread_setname_np.3:183
5641 #, no-wrap
5642 msgid "    sleep(2);\n"
5643 msgstr ""
5644
5645 #. type: Plain text
5646 #: build/C/man3/pthread_setname_np.3:189
5647 #, no-wrap
5648 msgid ""
5649 "    rc = pthread_getname_np(thread, thread_name,\n"
5650 "                            (argc E<gt> 2) ? atoi(argv[1]) : NAMELEN);\n"
5651 "    if (rc != 0)\n"
5652 "        errExitEN(rc, \"pthread_getname_np\");\n"
5653 "    printf(\"The thread name after setting it is %s.\\en\", thread_name);\n"
5654 msgstr ""
5655
5656 #. type: Plain text
5657 #: build/C/man3/pthread_setname_np.3:193
5658 #, no-wrap
5659 msgid ""
5660 "    rc = pthread_join(thread, NULL);\n"
5661 "    if (rc != 0)\n"
5662 "        errExitEN(rc, \"pthread_join\");\n"
5663 msgstr ""
5664
5665 #. type: Plain text
5666 #: build/C/man3/pthread_setname_np.3:197
5667 #, no-wrap
5668 msgid ""
5669 "    printf(\"Done\\en\");\n"
5670 "    exit(EXIT_SUCCESS);\n"
5671 "}\n"
5672 msgstr ""
5673
5674 #. type: Plain text
5675 #: build/C/man3/pthread_setname_np.3:204
5676 msgid "B<prctl>(2), B<pthread_create>(3), B<pthreads>(7)"
5677 msgstr ""
5678
5679 #. type: TH
5680 #: build/C/man3/pthread_setschedparam.3:26
5681 #, no-wrap
5682 msgid "PTHREAD_SETSCHEDPARAM"
5683 msgstr ""
5684
5685 #. type: Plain text
5686 #: build/C/man3/pthread_setschedparam.3:30
5687 msgid ""
5688 "pthread_setschedparam, pthread_getschedparam - set/get scheduling policy and "
5689 "parameters of a thread"
5690 msgstr ""
5691
5692 #. type: Plain text
5693 #: build/C/man3/pthread_setschedparam.3:38
5694 #, no-wrap
5695 msgid ""
5696 "B<pthread_setschedparam(pthread_t >I<thread>B<, int >I<policy>B<,>\n"
5697 "B<                      const struct sched_param *>I<param>B<);>\n"
5698 "B<pthread_getschedparam(pthread_t >I<thread>B<, int *>I<policy>B<,>\n"
5699 "B<                      struct sched_param *>I<param>B<);>\n"
5700 msgstr ""
5701
5702 #. type: Plain text
5703 #: build/C/man3/pthread_setschedparam.3:46
5704 msgid ""
5705 "The B<pthread_setschedparam>()  function sets the scheduling policy and "
5706 "parameters of the thread I<thread>."
5707 msgstr ""
5708
5709 #.  FIXME . pthread_setschedparam() places no restriction on the policy,
5710 #.  but pthread_attr_setschedpolicy() restricts policy to RR/FIFO/OTHER
5711 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=7013
5712 #. type: Plain text
5713 #: build/C/man3/pthread_setschedparam.3:57
5714 msgid ""
5715 "I<policy> specifies the new scheduling policy for I<thread>.  The supported "
5716 "values for I<policy>, and their semantics, are described in "
5717 "B<sched_setscheduler>(2)."
5718 msgstr ""
5719
5720 #. type: Plain text
5721 #: build/C/man3/pthread_setschedparam.3:63
5722 msgid ""
5723 "The structure pointed to by I<param> specifies the new scheduling parameters "
5724 "for I<thread>.  Scheduling parameters are maintained in the following "
5725 "structure:"
5726 msgstr ""
5727
5728 #.  FIXME . nptl/pthread_setschedparam.c has the following
5729 #.    /* If the thread should have higher priority because of some
5730 #.       PTHREAD_PRIO_PROTECT mutexes it holds, adjust the priority. */
5731 #.  Eventually (perhaps after writing the mutexattr pages), we
5732 #.  may want to add something on the topic to this page.
5733 #. type: Plain text
5734 #: build/C/man3/pthread_setschedparam.3:104
5735 msgid ""
5736 "The B<pthread_getschedparam>()  function returns the scheduling policy and "
5737 "parameters of the thread I<thread>, in the buffers pointed to by I<policy> "
5738 "and I<param>, respectively.  The returned priority value is that set by the "
5739 "most recent B<pthread_setschedparam>(), B<pthread_setschedprio>(3), or "
5740 "B<pthread_create>(3)  call that affected I<thread>.  The returned priority "
5741 "does not reflect any temporary priority adjustments as a result of calls to "
5742 "any priority inheritance or priority ceiling functions (see, for example, "
5743 "B<pthread_mutexattr_setprioceiling>(3)  and "
5744 "B<pthread_mutexattr_setprotocol>(3))."
5745 msgstr ""
5746
5747 #. type: Plain text
5748 #: build/C/man3/pthread_setschedparam.3:112
5749 msgid ""
5750 "On success, these functions return 0; on error, they return a nonzero error "
5751 "number.  If B<pthread_setschedparam>()  fails, the scheduling policy and "
5752 "parameters of I<thread> are not changed."
5753 msgstr ""
5754
5755 #. type: Plain text
5756 #: build/C/man3/pthread_setschedparam.3:114
5757 msgid "Both of these functions can fail with the following error:"
5758 msgstr ""
5759
5760 #. type: Plain text
5761 #: build/C/man3/pthread_setschedparam.3:122
5762 msgid "B<pthread_setschedparam>()  may additionally fail with the following errors:"
5763 msgstr ""
5764
5765 #. type: Plain text
5766 #: build/C/man3/pthread_setschedparam.3:129
5767 msgid ""
5768 "I<policy> is not a recognized policy, or I<param> does not make sense for "
5769 "the I<policy>."
5770 msgstr ""
5771
5772 #. type: Plain text
5773 #: build/C/man3/pthread_setschedparam.3:133
5774 msgid ""
5775 "The caller does not have appropriate privileges to set the specified "
5776 "scheduling policy and parameters."
5777 msgstr ""
5778
5779 #.  .SH VERSIONS
5780 #.  Available since glibc 2.0
5781 #. type: Plain text
5782 #: build/C/man3/pthread_setschedparam.3:141
5783 msgid ""
5784 "POSIX.1-2001 also documents an B<ENOTSUP> (\"attempt was made to set the "
5785 "policy or scheduling parameters to an unsupported value\") error for "
5786 "B<pthread_setschedparam>()."
5787 msgstr ""
5788
5789 #. type: Plain text
5790 #: build/C/man3/pthread_setschedparam.3:149
5791 msgid ""
5792 "For a description of the permissions required to, and the effect of, "
5793 "changing a thread's scheduling policy and priority, and details of the "
5794 "permitted ranges for priorities in each scheduling policy, see "
5795 "B<sched_setscheduler>(2)."
5796 msgstr ""
5797
5798 #. type: Plain text
5799 #: build/C/man3/pthread_setschedparam.3:156
5800 msgid ""
5801 "The program below demonstrates the use of B<pthread_setschedparam>()  and "
5802 "B<pthread_getschedparam>(), as well as the use of a number of other "
5803 "scheduling-related pthreads functions."
5804 msgstr ""
5805
5806 #. type: Plain text
5807 #: build/C/man3/pthread_setschedparam.3:172
5808 msgid ""
5809 "In the following run, the main thread sets its scheduling policy to "
5810 "B<SCHED_FIFO> with a priority of 10, and initializes a thread attributes "
5811 "object with a scheduling policy attribute of B<SCHED_RR> and a scheduling "
5812 "priority attribute of 20.  The program then sets (using "
5813 "B<pthread_attr_setinheritsched>(3))  the inherit scheduler attribute of the "
5814 "thread attributes object to B<PTHREAD_EXPLICIT_SCHED>, meaning that threads "
5815 "created using this attributes object should take their scheduling attributes "
5816 "from the thread attributes object.  The program then creates a thread using "
5817 "the thread attributes object, and that thread displays its scheduling policy "
5818 "and priority."
5819 msgstr ""
5820
5821 #. type: Plain text
5822 #: build/C/man3/pthread_setschedparam.3:180
5823 #, no-wrap
5824 msgid ""
5825 "$ B<su>      # Need privilege to set real-time scheduling policies\n"
5826 "Password:\n"
5827 "# B<./a.out -mf10 -ar20 -i e>\n"
5828 "Scheduler settings of main thread\n"
5829 "    policy=SCHED_FIFO, priority=10\n"
5830 msgstr ""
5831
5832 #. type: Plain text
5833 #: build/C/man3/pthread_setschedparam.3:184
5834 #, no-wrap
5835 msgid ""
5836 "Scheduler settings in \\(aqattr\\(aq\n"
5837 "    policy=SCHED_RR, priority=20\n"
5838 "    inheritsched is EXPLICIT\n"
5839 msgstr ""
5840
5841 #. type: Plain text
5842 #: build/C/man3/pthread_setschedparam.3:187
5843 #, no-wrap
5844 msgid ""
5845 "Scheduler attributes of new thread\n"
5846 "    policy=SCHED_RR, priority=20\n"
5847 msgstr ""
5848
5849 #. type: Plain text
5850 #: build/C/man3/pthread_setschedparam.3:192
5851 msgid ""
5852 "In the above output, one can see that the scheduling policy and priority "
5853 "were taken from the values specified in the thread attributes object."
5854 msgstr ""
5855
5856 #. type: Plain text
5857 #: build/C/man3/pthread_setschedparam.3:199
5858 msgid ""
5859 "The next run is the same as the previous, except that the inherit scheduler "
5860 "attribute is set to B<PTHREAD_INHERIT_SCHED>, meaning that threads created "
5861 "using the thread attributes object should ignore the scheduling attributes "
5862 "specified in the attributes object and instead take their scheduling "
5863 "attributes from the creating thread."
5864 msgstr ""
5865
5866 #. type: Plain text
5867 #: build/C/man3/pthread_setschedparam.3:205
5868 #, no-wrap
5869 msgid ""
5870 "# B<./a.out -mf10 -ar20 -i i>\n"
5871 "Scheduler settings of main thread\n"
5872 "    policy=SCHED_FIFO, priority=10\n"
5873 msgstr ""
5874
5875 #. type: Plain text
5876 #: build/C/man3/pthread_setschedparam.3:209
5877 #, no-wrap
5878 msgid ""
5879 "Scheduler settings in \\(aqattr\\(aq\n"
5880 "    policy=SCHED_RR, priority=20\n"
5881 "    inheritsched is INHERIT\n"
5882 msgstr ""
5883
5884 #. type: Plain text
5885 #: build/C/man3/pthread_setschedparam.3:212
5886 #, no-wrap
5887 msgid ""
5888 "Scheduler attributes of new thread\n"
5889 "    policy=SCHED_FIFO, priority=10\n"
5890 msgstr ""
5891
5892 #. type: Plain text
5893 #: build/C/man3/pthread_setschedparam.3:218
5894 msgid ""
5895 "In the above output, one can see that the scheduling policy and priority "
5896 "were taken from the creating thread, rather than the thread attributes "
5897 "object."
5898 msgstr ""
5899
5900 #. type: Plain text
5901 #: build/C/man3/pthread_setschedparam.3:224
5902 msgid ""
5903 "Note that if we had omitted the I<-i\\ i> option, the output would have been "
5904 "the same, since B<PTHREAD_INHERIT_SCHED> is the default for the inherit "
5905 "scheduler attribute."
5906 msgstr ""
5907
5908 #. type: Plain text
5909 #: build/C/man3/pthread_setschedparam.3:228
5910 #, no-wrap
5911 msgid "/* pthreads_sched_test.c */\n"
5912 msgstr ""
5913
5914 #. type: Plain text
5915 #: build/C/man3/pthread_setschedparam.3:234
5916 #, no-wrap
5917 msgid ""
5918 "#include E<lt>pthread.hE<gt>\n"
5919 "#include E<lt>stdio.hE<gt>\n"
5920 "#include E<lt>stdlib.hE<gt>\n"
5921 "#include E<lt>unistd.hE<gt>\n"
5922 "#include E<lt>errno.hE<gt>\n"
5923 msgstr ""
5924
5925 #. type: Plain text
5926 #: build/C/man3/pthread_setschedparam.3:243
5927 #, no-wrap
5928 msgid ""
5929 "static void\n"
5930 "usage(char *prog_name, char *msg)\n"
5931 "{\n"
5932 "    if (msg != NULL)\n"
5933 "        fputs(msg, stderr);\n"
5934 msgstr ""
5935
5936 #. type: Plain text
5937 #: build/C/man3/pthread_setschedparam.3:260
5938 #, no-wrap
5939 msgid ""
5940 "    fprintf(stderr, \"Usage: %s [options]\\en\", prog_name);\n"
5941 "    fprintf(stderr, \"Options are:\\en\");\n"
5942 "#define fpe(msg) fprintf(stderr, \"\\et%s\", msg);          /* Shorter */\n"
5943 "    fpe(\"-aE<lt>policyE<gt>E<lt>prioE<gt> Set scheduling policy and "
5944 "priority in\\en\");\n"
5945 "    fpe(\"                 thread attributes object\\en\");\n"
5946 "    fpe(\"                 E<lt>policyE<gt> can be\\en\");\n"
5947 "    fpe(\"                     f  SCHED_FIFO\\en\");\n"
5948 "    fpe(\"                     r  SCHED_RR\\en\");\n"
5949 "    fpe(\"                     o  SCHED_OTHER\\en\");\n"
5950 "    fpe(\"-A               Use default thread attributes object\\en\");\n"
5951 "    fpe(\"-i {e|s}         Set inherit scheduler attribute to\\en\");\n"
5952 "    fpe(\"                 \\(aqexplicit\\(aq or \\(aqinherit\\(aq\\en\");\n"
5953 "    fpe(\"-mE<lt>policyE<gt>E<lt>prioE<gt> Set scheduling policy and "
5954 "priority on\\en\");\n"
5955 "    fpe(\"                 main thread before pthread_create() "
5956 "call\\en\");\n"
5957 "    exit(EXIT_FAILURE);\n"
5958 "}\n"
5959 msgstr ""
5960
5961 #. type: Plain text
5962 #: build/C/man3/pthread_setschedparam.3:271
5963 #, no-wrap
5964 msgid ""
5965 "static int\n"
5966 "get_policy(char p, int *policy)\n"
5967 "{\n"
5968 "    switch (p) {\n"
5969 "    case \\(aqf\\(aq: *policy = SCHED_FIFO;     return 1;\n"
5970 "    case \\(aqr\\(aq: *policy = SCHED_RR;       return 1;\n"
5971 "    case \\(aqo\\(aq: *policy = SCHED_OTHER;    return 1;\n"
5972 "    default:  return 0;\n"
5973 "    }\n"
5974 "}\n"
5975 msgstr ""
5976
5977 #. type: Plain text
5978 #: build/C/man3/pthread_setschedparam.3:282
5979 #, no-wrap
5980 msgid ""
5981 "static void\n"
5982 "display_sched_attr(int policy, struct sched_param *param)\n"
5983 "{\n"
5984 "    printf(\"    policy=%s, priority=%d\\en\",\n"
5985 "            (policy == SCHED_FIFO)  ? \"SCHED_FIFO\" :\n"
5986 "            (policy == SCHED_RR)    ? \"SCHED_RR\" :\n"
5987 "            (policy == SCHED_OTHER) ? \"SCHED_OTHER\" :\n"
5988 "            \"???\",\n"
5989 "            param-E<gt>sched_priority);\n"
5990 "}\n"
5991 msgstr ""
5992
5993 #. type: Plain text
5994 #: build/C/man3/pthread_setschedparam.3:288
5995 #, no-wrap
5996 msgid ""
5997 "static void\n"
5998 "display_thread_sched_attr(char *msg)\n"
5999 "{\n"
6000 "    int policy, s;\n"
6001 "    struct sched_param param;\n"
6002 msgstr ""
6003
6004 #. type: Plain text
6005 #: build/C/man3/pthread_setschedparam.3:292
6006 #, no-wrap
6007 msgid ""
6008 "    s = pthread_getschedparam(pthread_self(), &policy, &param);\n"
6009 "    if (s != 0)\n"
6010 "        handle_error_en(s, \"pthread_getschedparam\");\n"
6011 msgstr ""
6012
6013 #. type: Plain text
6014 #: build/C/man3/pthread_setschedparam.3:296
6015 #, no-wrap
6016 msgid ""
6017 "    printf(\"%s\\en\", msg);\n"
6018 "    display_sched_attr(policy, &param);\n"
6019 "}\n"
6020 msgstr ""
6021
6022 #. type: Plain text
6023 #: build/C/man3/pthread_setschedparam.3:301
6024 #, no-wrap
6025 msgid ""
6026 "static void *\n"
6027 "thread_start(void *arg)\n"
6028 "{\n"
6029 "    display_thread_sched_attr(\"Scheduler attributes of new thread\");\n"
6030 msgstr ""
6031
6032 #. type: Plain text
6033 #: build/C/man3/pthread_setschedparam.3:304
6034 #, no-wrap
6035 msgid ""
6036 "    return NULL;\n"
6037 "}\n"
6038 msgstr ""
6039
6040 #. type: Plain text
6041 #: build/C/man3/pthread_setschedparam.3:314
6042 #, no-wrap
6043 msgid ""
6044 "int\n"
6045 "main(int argc, char *argv[])\n"
6046 "{\n"
6047 "    int s, opt, inheritsched, use_null_attrib, policy;\n"
6048 "    pthread_t thread;\n"
6049 "    pthread_attr_t attr;\n"
6050 "    pthread_attr_t *attrp;\n"
6051 "    char *attr_sched_str, *main_sched_str, *inheritsched_str;\n"
6052 "    struct sched_param param;\n"
6053 msgstr ""
6054
6055 #. type: Plain text
6056 #: build/C/man3/pthread_setschedparam.3:316
6057 #, no-wrap
6058 msgid "    /* Process command-line options */\n"
6059 msgstr ""
6060
6061 #. type: Plain text
6062 #: build/C/man3/pthread_setschedparam.3:321
6063 #, no-wrap
6064 msgid ""
6065 "    use_null_attrib = 0;\n"
6066 "    attr_sched_str = NULL;\n"
6067 "    main_sched_str = NULL;\n"
6068 "    inheritsched_str = NULL;\n"
6069 msgstr ""
6070
6071 #. type: Plain text
6072 #: build/C/man3/pthread_setschedparam.3:331
6073 #, no-wrap
6074 msgid ""
6075 "    while ((opt = getopt(argc, argv, \"a:Ai:m:\")) != -1) {\n"
6076 "        switch (opt) {\n"
6077 "        case \\(aqa\\(aq: attr_sched_str = optarg;      break;\n"
6078 "        case \\(aqA\\(aq: use_null_attrib = 1;          break;\n"
6079 "        case \\(aqi\\(aq: inheritsched_str = optarg;    break;\n"
6080 "        case \\(aqm\\(aq: main_sched_str = optarg;      break;\n"
6081 "        default:  usage(argv[0], \"Unrecognized option\\en\");\n"
6082 "        }\n"
6083 "    }\n"
6084 msgstr ""
6085
6086 #. type: Plain text
6087 #: build/C/man3/pthread_setschedparam.3:335
6088 #, no-wrap
6089 msgid ""
6090 "    if (use_null_attrib &&\n"
6091 "            (inheritsched_str != NULL || attr_sched_str != NULL))\n"
6092 "        usage(argv[0], \"Can\\(aqt specify -A with -i or -a\\en\");\n"
6093 msgstr ""
6094
6095 #. type: Plain text
6096 #: build/C/man3/pthread_setschedparam.3:338
6097 #, no-wrap
6098 msgid ""
6099 "    /* Optionally set scheduling attributes of main thread,\n"
6100 "       and display the attributes */\n"
6101 msgstr ""
6102
6103 #. type: Plain text
6104 #: build/C/man3/pthread_setschedparam.3:343
6105 #, no-wrap
6106 msgid ""
6107 "    if (main_sched_str != NULL) {\n"
6108 "        if (!get_policy(main_sched_str[0], &policy))\n"
6109 "            usage(argv[0], \"Bad policy for main thread (-s)\\en\");\n"
6110 "        param.sched_priority = strtol(&main_sched_str[1], NULL, 0);\n"
6111 msgstr ""
6112
6113 #. type: Plain text
6114 #: build/C/man3/pthread_setschedparam.3:348
6115 #, no-wrap
6116 msgid ""
6117 "        s = pthread_setschedparam(pthread_self(), policy, &param);\n"
6118 "        if (s != 0)\n"
6119 "            handle_error_en(s, \"pthread_setschedparam\");\n"
6120 "    }\n"
6121 msgstr ""
6122
6123 #. type: Plain text
6124 #: build/C/man3/pthread_setschedparam.3:351
6125 #, no-wrap
6126 msgid ""
6127 "    display_thread_sched_attr(\"Scheduler settings of main thread\");\n"
6128 "    printf(\"\\en\");\n"
6129 msgstr ""
6130
6131 #. type: Plain text
6132 #: build/C/man3/pthread_setschedparam.3:353
6133 #, no-wrap
6134 msgid "    /* Initialize thread attributes object according to options */\n"
6135 msgstr ""
6136
6137 #. type: Plain text
6138 #: build/C/man3/pthread_setschedparam.3:362
6139 #, no-wrap
6140 msgid ""
6141 "    if (!use_null_attrib) {\n"
6142 "        s = pthread_attr_init(&attr);\n"
6143 "        if (s != 0)\n"
6144 "            handle_error_en(s, \"pthread_attr_init\");\n"
6145 "        attrp = &attr;\n"
6146 "    }\n"
6147 msgstr ""
6148
6149 #. type: Plain text
6150 #: build/C/man3/pthread_setschedparam.3:370
6151 #, no-wrap
6152 msgid ""
6153 "    if (inheritsched_str != NULL) {\n"
6154 "        if (inheritsched_str[0] == \\(aqe\\(aq)\n"
6155 "            inheritsched = PTHREAD_EXPLICIT_SCHED;\n"
6156 "        else if (inheritsched_str[0] == \\(aqi\\(aq)\n"
6157 "            inheritsched = PTHREAD_INHERIT_SCHED;\n"
6158 "        else\n"
6159 "            usage(argv[0], \"Value for -i must be \\(aqe\\(aq or "
6160 "\\(aqi\\(aq\\en\");\n"
6161 msgstr ""
6162
6163 #. type: Plain text
6164 #: build/C/man3/pthread_setschedparam.3:375
6165 #, no-wrap
6166 msgid ""
6167 "        s = pthread_attr_setinheritsched(&attr, inheritsched);\n"
6168 "        if (s != 0)\n"
6169 "            handle_error_en(s, \"pthread_attr_setinheritsched\");\n"
6170 "    }\n"
6171 msgstr ""
6172
6173 #. type: Plain text
6174 #: build/C/man3/pthread_setschedparam.3:381
6175 #, no-wrap
6176 msgid ""
6177 "    if (attr_sched_str != NULL) {\n"
6178 "        if (!get_policy(attr_sched_str[0], &policy))\n"
6179 "            usage(argv[0],\n"
6180 "                    \"Bad policy for \\(aqattr\\(aq (-a)\\en\");\n"
6181 "        param.sched_priority = strtol(&attr_sched_str[1], NULL, 0);\n"
6182 msgstr ""
6183
6184 #. type: Plain text
6185 #: build/C/man3/pthread_setschedparam.3:389
6186 #, no-wrap
6187 msgid ""
6188 "        s = pthread_attr_setschedpolicy(&attr, policy);\n"
6189 "        if (s != 0)\n"
6190 "            handle_error_en(s, \"pthread_attr_setschedpolicy\");\n"
6191 "        s = pthread_attr_setschedparam(&attr, &param);\n"
6192 "        if (s != 0)\n"
6193 "            handle_error_en(s, \"pthread_attr_setschedparam\");\n"
6194 "    }\n"
6195 msgstr ""
6196
6197 #. type: Plain text
6198 #: build/C/man3/pthread_setschedparam.3:392
6199 #, no-wrap
6200 msgid ""
6201 "    /* If we initialized a thread attributes object, display\n"
6202 "       the scheduling attributes that were set in the object */\n"
6203 msgstr ""
6204
6205 #. type: Plain text
6206 #: build/C/man3/pthread_setschedparam.3:400
6207 #, no-wrap
6208 msgid ""
6209 "    if (attrp != NULL) {\n"
6210 "        s = pthread_attr_getschedparam(&attr, &param);\n"
6211 "        if (s != 0)\n"
6212 "            handle_error_en(s, \"pthread_attr_getschedparam\");\n"
6213 "        s = pthread_attr_getschedpolicy(&attr, &policy);\n"
6214 "        if (s != 0)\n"
6215 "            handle_error_en(s, \"pthread_attr_getschedpolicy\");\n"
6216 msgstr ""
6217
6218 #. type: Plain text
6219 #: build/C/man3/pthread_setschedparam.3:403
6220 #, no-wrap
6221 msgid ""
6222 "        printf(\"Scheduler settings in \\(aqattr\\(aq\\en\");\n"
6223 "        display_sched_attr(policy, &param);\n"
6224 msgstr ""
6225
6226 #. type: Plain text
6227 #: build/C/man3/pthread_setschedparam.3:411
6228 #, no-wrap
6229 msgid ""
6230 "        s = pthread_attr_getinheritsched(&attr, &inheritsched);\n"
6231 "        printf(\"    inheritsched is %s\\en\",\n"
6232 "                (inheritsched == PTHREAD_INHERIT_SCHED)  ? \"INHERIT\" :\n"
6233 "                (inheritsched == PTHREAD_EXPLICIT_SCHED) ? \"EXPLICIT\" :\n"
6234 "                \"???\");\n"
6235 "        printf(\"\\en\");\n"
6236 "    }\n"
6237 msgstr ""
6238
6239 #. type: Plain text
6240 #: build/C/man3/pthread_setschedparam.3:413
6241 #, no-wrap
6242 msgid "    /* Create a thread that will display its scheduling attributes */\n"
6243 msgstr ""
6244
6245 #. type: Plain text
6246 #: build/C/man3/pthread_setschedparam.3:417
6247 #, no-wrap
6248 msgid ""
6249 "    s = pthread_create(&thread, attrp, &thread_start, NULL);\n"
6250 "    if (s != 0)\n"
6251 "        handle_error_en(s, \"pthread_create\");\n"
6252 msgstr ""
6253
6254 #. type: Plain text
6255 #: build/C/man3/pthread_setschedparam.3:419
6256 #, no-wrap
6257 msgid "    /* Destroy unneeded thread attributes object */\n"
6258 msgstr ""
6259
6260 #. type: Plain text
6261 #: build/C/man3/pthread_setschedparam.3:427
6262 #, no-wrap
6263 msgid ""
6264 "    s = pthread_join(thread, NULL);\n"
6265 "    if (s != 0)\n"
6266 "        handle_error_en(s, \"pthread_join\");\n"
6267 msgstr ""
6268
6269 #. type: Plain text
6270 #: build/C/man3/pthread_setschedparam.3:445
6271 msgid ""
6272 "B<getrlimit>(2), B<sched_get_priority_min>(2), B<sched_setscheduler>(2), "
6273 "B<pthread_attr_init>(3), B<pthread_attr_setinheritsched>(3), "
6274 "B<pthread_attr_setschedparam>(3), B<pthread_attr_setschedpolicy>(3), "
6275 "B<pthread_create>(3), B<pthread_self>(3), B<pthread_setschedprio>(3), "
6276 "B<pthreads>(7)"
6277 msgstr ""
6278
6279 #. type: TH
6280 #: build/C/man3/pthread_setschedprio.3:26
6281 #, no-wrap
6282 msgid "PTHREAD_SETSCHEDPRIO"
6283 msgstr ""
6284
6285 #. type: TH
6286 #: build/C/man3/pthread_setschedprio.3:26
6287 #, no-wrap
6288 msgid "2008-11-06"
6289 msgstr ""
6290
6291 #. type: Plain text
6292 #: build/C/man3/pthread_setschedprio.3:29
6293 msgid "pthread_setschedprio - set scheduling priority of a thread"
6294 msgstr ""
6295
6296 #. type: Plain text
6297 #: build/C/man3/pthread_setschedprio.3:34
6298 #, no-wrap
6299 msgid "B<pthread_setschedprio(pthread_t >I<thread>B<, int >I<prio>B<);>\n"
6300 msgstr ""
6301
6302 #.  FIXME . nptl/pthread_setschedprio.c has the following
6303 #.    /* If the thread should have higher priority because of some
6304 #.       PTHREAD_PRIO_PROTECT mutexes it holds, adjust the priority. */
6305 #.  Eventually (perhaps after writing the mutexattr pages), we
6306 #.  may want to add something on the topic to this page.
6307 #.  nptl/pthread_setschedparam.c has a similar case.
6308 #. type: Plain text
6309 #: build/C/man3/pthread_setschedprio.3:53
6310 msgid ""
6311 "The B<pthread_setschedprio>()  function sets the scheduling priority of the "
6312 "thread I<thread> to the value specified in I<prio>.  (By contrast "
6313 "B<pthread_setschedparam>(3)  changes both the scheduling policy and priority "
6314 "of a thread.)"
6315 msgstr ""
6316
6317 #. type: Plain text
6318 #: build/C/man3/pthread_setschedprio.3:61
6319 msgid ""
6320 "On success, this function returns 0; on error, it returns a nonzero error "
6321 "number.  If B<pthread_setschedprio>()  fails, the scheduling priority of "
6322 "I<thread> is not changed."
6323 msgstr ""
6324
6325 #. type: Plain text
6326 #: build/C/man3/pthread_setschedprio.3:66
6327 msgid "I<prio> is not valid for the scheduling policy of the specified thread."
6328 msgstr ""
6329
6330 #. type: Plain text
6331 #: build/C/man3/pthread_setschedprio.3:70
6332 msgid ""
6333 "The caller does not have appropriate privileges to set the specified "
6334 "priority."
6335 msgstr ""
6336
6337 #. type: Plain text
6338 #: build/C/man3/pthread_setschedprio.3:81
6339 msgid ""
6340 "POSIX.1-2001 also documents an B<ENOTSUP> (\"attempt was made to set the "
6341 "priority to an unsupported value\") error for B<pthread_setschedparam>(3)."
6342 msgstr ""
6343
6344 #. type: Plain text
6345 #: build/C/man3/pthread_setschedprio.3:83
6346 msgid "This function is available in glibc since version 2.3.4."
6347 msgstr ""
6348
6349 #. type: Plain text
6350 #: build/C/man3/pthread_setschedprio.3:91
6351 msgid ""
6352 "For a description of the permissions required to, and the effect of, "
6353 "changing a thread's scheduling priority, and details of the permitted ranges "
6354 "for priorities in each scheduling policy, see B<sched_setscheduler>(2)."
6355 msgstr ""
6356
6357 #. type: Plain text
6358 #: build/C/man3/pthread_setschedprio.3:105
6359 msgid ""
6360 "B<getrlimit>(2), B<sched_get_priority_min>(2), B<sched_setscheduler>(2), "
6361 "B<pthread_attr_init>(3), B<pthread_attr_setinheritsched>(3), "
6362 "B<pthread_attr_setschedparam>(3), B<pthread_attr_setschedpolicy>(3), "
6363 "B<pthread_create>(3), B<pthread_self>(3), B<pthread_setschedparam>(3), "
6364 "B<pthreads>(7)"
6365 msgstr ""
6366
6367 #. type: TH
6368 #: build/C/man3/pthread_sigmask.3:26
6369 #, no-wrap
6370 msgid "PTHREAD_SIGMASK"
6371 msgstr ""
6372
6373 #. type: Plain text
6374 #: build/C/man3/pthread_sigmask.3:29
6375 msgid "pthread_sigmask - examine and change mask of blocked signals"
6376 msgstr ""
6377
6378 #. type: Plain text
6379 #: build/C/man3/pthread_sigmask.3:35
6380 #, no-wrap
6381 msgid ""
6382 "B<int pthread_sigmask(int >I<how>B<, const sigset_t *>I<set>B<, sigset_t "
6383 "*>I<oldset>B<);>\n"
6384 msgstr ""
6385
6386 #. type: Plain text
6387 #: build/C/man3/pthread_sigmask.3:46
6388 msgid ""
6389 "The B<pthread_sigmask>()  function is just like B<sigprocmask>(2), with the "
6390 "difference that its use in multithreaded programs is explicitly specified by "
6391 "POSIX.1-2001.  Other differences are noted in this page."
6392 msgstr ""
6393
6394 #. type: Plain text
6395 #: build/C/man3/pthread_sigmask.3:49
6396 msgid ""
6397 "For a description of the arguments and operation of this function, see "
6398 "B<sigprocmask>(2)."
6399 msgstr ""
6400
6401 #. type: Plain text
6402 #: build/C/man3/pthread_sigmask.3:54
6403 msgid ""
6404 "On success, B<pthread_sigmask>()  returns 0; on error, it returns an error "
6405 "number."
6406 msgstr ""
6407
6408 #. type: Plain text
6409 #: build/C/man3/pthread_sigmask.3:57
6410 msgid "See B<sigprocmask>(2)."
6411 msgstr ""
6412
6413 #. type: Plain text
6414 #: build/C/man3/pthread_sigmask.3:61
6415 msgid "A new thread inherits a copy of its creator's signal mask."
6416 msgstr ""
6417
6418 #. type: Plain text
6419 #: build/C/man3/pthread_sigmask.3:66
6420 msgid ""
6421 "The program below blocks some signals in the main thread, and then creates a "
6422 "dedicated thread to fetch those signals via B<sigwait>(3).  The following "
6423 "shell session demonstrates its use:"
6424 msgstr ""
6425
6426 #. type: Plain text
6427 #: build/C/man3/pthread_sigmask.3:77
6428 #, no-wrap
6429 msgid ""
6430 "$B< ./a.out &>\n"
6431 "[1] 5423\n"
6432 "$B< kill -QUIT %1>\n"
6433 "Signal handling thread got signal 3\n"
6434 "$B< kill -USR1 %1>\n"
6435 "Signal handling thread got signal 10\n"
6436 "$B< kill -TERM %1>\n"
6437 "[1]+  Terminated              ./a.out\n"
6438 msgstr ""
6439
6440 #. type: Plain text
6441 #: build/C/man3/pthread_sigmask.3:88
6442 #, no-wrap
6443 msgid ""
6444 "#include E<lt>pthread.hE<gt>\n"
6445 "#include E<lt>stdio.hE<gt>\n"
6446 "#include E<lt>stdlib.hE<gt>\n"
6447 "#include E<lt>unistd.hE<gt>\n"
6448 "#include E<lt>signal.hE<gt>\n"
6449 "#include E<lt>errno.hE<gt>\n"
6450 msgstr ""
6451
6452 #. type: Plain text
6453 #: build/C/man3/pthread_sigmask.3:90
6454 #, no-wrap
6455 msgid "/* Simple error handling functions */\n"
6456 msgstr ""
6457
6458 #. type: Plain text
6459 #: build/C/man3/pthread_sigmask.3:99
6460 #, no-wrap
6461 msgid ""
6462 "static void *\n"
6463 "sig_thread(void *arg)\n"
6464 "{\n"
6465 "    sigset_t *set = arg;\n"
6466 "    int s, sig;\n"
6467 msgstr ""
6468
6469 #. type: Plain text
6470 #: build/C/man3/pthread_sigmask.3:107
6471 #, no-wrap
6472 msgid ""
6473 "    for (;;) {\n"
6474 "        s = sigwait(set, &sig);\n"
6475 "        if (s != 0)\n"
6476 "            handle_error_en(s, \"sigwait\");\n"
6477 "        printf(\"Signal handling thread got signal %d\\en\", sig);\n"
6478 "    }\n"
6479 "}\n"
6480 msgstr ""
6481
6482 #. type: Plain text
6483 #: build/C/man3/pthread_sigmask.3:114
6484 #, no-wrap
6485 msgid ""
6486 "int\n"
6487 "main(int argc, char *argv[])\n"
6488 "{\n"
6489 "    pthread_t thread;\n"
6490 "    sigset_t set;\n"
6491 "    int s;\n"
6492 msgstr ""
6493
6494 #. type: Plain text
6495 #: build/C/man3/pthread_sigmask.3:117
6496 #, no-wrap
6497 msgid ""
6498 "    /* Block SIGQUIT and SIGUSR1; other threads created by main()\n"
6499 "       will inherit a copy of the signal mask. */\n"
6500 msgstr ""
6501
6502 #. type: Plain text
6503 #: build/C/man3/pthread_sigmask.3:124
6504 #, no-wrap
6505 msgid ""
6506 "    sigemptyset(&set);\n"
6507 "    sigaddset(&set, SIGQUIT);\n"
6508 "    sigaddset(&set, SIGUSR1);\n"
6509 "    s = pthread_sigmask(SIG_BLOCK, &set, NULL);\n"
6510 "    if (s != 0)\n"
6511 "        handle_error_en(s, \"pthread_sigmask\");\n"
6512 msgstr ""
6513
6514 #. type: Plain text
6515 #: build/C/man3/pthread_sigmask.3:128
6516 #, no-wrap
6517 msgid ""
6518 "    s = pthread_create(&thread, NULL, &sig_thread, (void *) &set);\n"
6519 "    if (s != 0)\n"
6520 "        handle_error_en(s, \"pthread_create\");\n"
6521 msgstr ""
6522
6523 #. type: Plain text
6524 #: build/C/man3/pthread_sigmask.3:131
6525 #, no-wrap
6526 msgid ""
6527 "    /* Main thread carries on to create other threads and/or do\n"
6528 "       other work */\n"
6529 msgstr ""
6530
6531 #. type: Plain text
6532 #: build/C/man3/pthread_sigmask.3:134
6533 #, no-wrap
6534 msgid ""
6535 "    pause();            /* Dummy pause so we can test program */\n"
6536 "}\n"
6537 msgstr ""
6538
6539 #. type: Plain text
6540 #: build/C/man3/pthread_sigmask.3:144
6541 msgid ""
6542 "B<sigaction>(2), B<sigpending>(2), B<sigprocmask>(2), B<pthread_create>(3), "
6543 "B<pthread_kill>(3), B<sigsetops>(3), B<pthreads>(7), B<signal>(7)"
6544 msgstr ""
6545
6546 #. type: TH
6547 #: build/C/man3/pthread_sigqueue.3:25
6548 #, no-wrap
6549 msgid "PTHREAD_SIGQUEUE"
6550 msgstr ""
6551
6552 #. type: Plain text
6553 #: build/C/man3/pthread_sigqueue.3:28
6554 msgid "pthread_sigqueue - queue a signal and data to a thread"
6555 msgstr ""
6556
6557 #. type: Plain text
6558 #: build/C/man3/pthread_sigqueue.3:34
6559 #, no-wrap
6560 msgid ""
6561 "B<int pthread_sigqueue(pthread_t >I<thread>B<, int >I<sig>B<,>\n"
6562 "B<                     const union sigval >I<value>B<);>\n"
6563 msgstr ""
6564
6565 #. type: Plain text
6566 #: build/C/man3/pthread_sigqueue.3:45
6567 msgid "B<pthread_sigqueue>(): _GNU_SOURCE"
6568 msgstr ""
6569
6570 #. type: Plain text
6571 #: build/C/man3/pthread_sigqueue.3:53
6572 msgid ""
6573 "The B<pthread_sigqueue>()  function performs a similar task to "
6574 "B<sigqueue>(3), but, rather than sending a signal to a process, it sends a "
6575 "signal to a thread in the same process as the calling thread."
6576 msgstr ""
6577
6578 #. type: Plain text
6579 #: build/C/man3/pthread_sigqueue.3:65
6580 msgid ""
6581 "The I<thread> argument is the ID of a thread in the same process as the "
6582 "caller.  The I<sig> argument specifies the signal to be sent.  The I<value> "
6583 "argument specifies data to accompany the signal; see B<sigqueue>(3)  for "
6584 "details."
6585 msgstr ""
6586
6587 #. type: Plain text
6588 #: build/C/man3/pthread_sigqueue.3:70
6589 msgid ""
6590 "On success, B<pthread_sigqueue>()  returns 0; on error, it returns an error "
6591 "number."
6592 msgstr ""
6593
6594 #. type: Plain text
6595 #: build/C/man3/pthread_sigqueue.3:77
6596 msgid ""
6597 "The limit of signals which may be queued has been reached.  (See "
6598 "B<signal>(7)  for further information.)"
6599 msgstr ""
6600
6601 #. type: Plain text
6602 #: build/C/man3/pthread_sigqueue.3:81
6603 msgid "I<sig> was invalid."
6604 msgstr ""
6605
6606 #. type: TP
6607 #: build/C/man3/pthread_sigqueue.3:81
6608 #, no-wrap
6609 msgid "B<ENOSYS>"
6610 msgstr ""
6611
6612 #. type: Plain text
6613 #: build/C/man3/pthread_sigqueue.3:85
6614 msgid "B<pthread_sigqueue>()  is not supported on this system."
6615 msgstr ""
6616
6617 #. type: Plain text
6618 #: build/C/man3/pthread_sigqueue.3:89
6619 msgid "I<thread> is not valid."
6620 msgstr ""
6621
6622 #. type: Plain text
6623 #: build/C/man3/pthread_sigqueue.3:93
6624 msgid "The B<pthread_sigqueue>()  function first appeared in glibc 2.11."
6625 msgstr ""
6626
6627 #. type: Plain text
6628 #: build/C/man3/pthread_sigqueue.3:95
6629 msgid "This function is a GNU extension."
6630 msgstr ""
6631
6632 #. type: Plain text
6633 #: build/C/man3/pthread_sigqueue.3:103
6634 msgid ""
6635 "B<rt_tgsigqueueinfo>(2), B<sigaction>(2), B<pthread_sigmask>(3), "
6636 "B<sigqueue>(3), B<sigwait>(3), B<pthreads>(7), B<signal>(7)"
6637 msgstr ""
6638
6639 #. type: TH
6640 #: build/C/man3/pthread_testcancel.3:26
6641 #, no-wrap
6642 msgid "PTHREAD_TESTCANCEL"
6643 msgstr ""
6644
6645 #. type: TH
6646 #: build/C/man3/pthread_testcancel.3:26
6647 #, no-wrap
6648 msgid "2012-04-14"
6649 msgstr ""
6650
6651 #. type: Plain text
6652 #: build/C/man3/pthread_testcancel.3:29
6653 msgid "pthread_testcancel - request delivery of any pending cancellation request"
6654 msgstr ""
6655
6656 #. type: Plain text
6657 #: build/C/man3/pthread_testcancel.3:34
6658 #, no-wrap
6659 msgid "B<void pthread_testcancel(void);>\n"
6660 msgstr ""
6661
6662 #. type: Plain text
6663 #: build/C/man3/pthread_testcancel.3:43
6664 msgid ""
6665 "Calling B<pthread_testcancel>()  creates a cancellation point within the "
6666 "calling thread, so that a thread that is otherwise executing code that "
6667 "contains no cancellation points will respond to a cancellation request."
6668 msgstr ""
6669
6670 #. type: Plain text
6671 #: build/C/man3/pthread_testcancel.3:50
6672 msgid ""
6673 "If cancelability is disabled (using B<pthread_setcancelstate>(3)), or no "
6674 "cancellation request is pending, then a call to B<pthread_testcancel>()  has "
6675 "no effect."
6676 msgstr ""
6677
6678 #. type: Plain text
6679 #: build/C/man3/pthread_testcancel.3:54
6680 msgid ""
6681 "This function does not return a value.  If the calling thread is canceled as "
6682 "a consequence of a call to this function, then the function does not return."
6683 msgstr ""
6684
6685 #. type: Plain text
6686 #: build/C/man3/pthread_testcancel.3:63
6687 msgid "See B<pthread_cleanup_push>(3)."
6688 msgstr ""
6689
6690 #. type: Plain text
6691 #: build/C/man3/pthread_testcancel.3:68
6692 msgid ""
6693 "B<pthread_cancel>(3), B<pthread_cleanup_push>(3), "
6694 "B<pthread_setcancelstate>(3), B<pthreads>(7)"
6695 msgstr ""
6696
6697 #. type: TH
6698 #: build/C/man3/pthread_tryjoin_np.3:26
6699 #, no-wrap
6700 msgid "PTHREAD_TRYJOIN_NP"
6701 msgstr ""
6702
6703 #. type: Plain text
6704 #: build/C/man3/pthread_tryjoin_np.3:30
6705 msgid ""
6706 "pthread_tryjoin_np, pthread_timedjoin_np - try to join with a terminated "
6707 "thread"
6708 msgstr ""
6709
6710 #. type: Plain text
6711 #: build/C/man3/pthread_tryjoin_np.3:36
6712 #, no-wrap
6713 msgid "B<int pthread_tryjoin_np(pthread_t >I<thread>B<, void **>I<retval>B<);>\n"
6714 msgstr ""
6715
6716 #. type: Plain text
6717 #: build/C/man3/pthread_tryjoin_np.3:39
6718 #, no-wrap
6719 msgid ""
6720 "B<int pthread_timedjoin_np(pthread_t >I<thread>B<, void **>I<retval>B<,>\n"
6721 "B<                         const struct timespec *>I<abstime>B<);>\n"
6722 msgstr ""
6723
6724 #. type: Plain text
6725 #: build/C/man3/pthread_tryjoin_np.3:46
6726 msgid ""
6727 "These functions operate in the same way as B<pthread_join>(3), except for "
6728 "the differences described on this page."
6729 msgstr ""
6730
6731 #. type: Plain text
6732 #: build/C/man3/pthread_tryjoin_np.3:58
6733 msgid ""
6734 "The B<pthread_tryjoin_np>()  function performs a nonblocking join with the "
6735 "thread I<thread>, returning the exit status of the thread in I<*retval>.  If "
6736 "I<thread> has not yet terminated, then instead of blocking, as is done by "
6737 "B<pthread_join>(3), the call returns an error."
6738 msgstr ""
6739
6740 #. type: Plain text
6741 #: build/C/man3/pthread_tryjoin_np.3:76
6742 msgid ""
6743 "The B<pthread_timedjoin_np>()  function performs a join-with-timeout.  If "
6744 "I<thread> has not yet terminated, then the call blocks until a maximum time, "
6745 "specified in I<abstime>.  If the timeout expires before I<thread> "
6746 "terminates, the call returns an error.  The I<abstime> argument is a "
6747 "structure of the following form, specifying an absolute time measured since "
6748 "the Epoch (see B<time>(2)):"
6749 msgstr ""
6750
6751 #. type: Plain text
6752 #: build/C/man3/pthread_tryjoin_np.3:83
6753 #, no-wrap
6754 msgid ""
6755 "struct timespec {\n"
6756 "    time_t tv_sec;     /* seconds */\n"
6757 "    long   tv_nsec;    /* nanoseconds */\n"
6758 "};\n"
6759 msgstr ""
6760
6761 #. type: Plain text
6762 #: build/C/man3/pthread_tryjoin_np.3:89
6763 msgid "On success, these functions return 0; on error, they return an error number."
6764 msgstr ""
6765
6766 #. type: Plain text
6767 #: build/C/man3/pthread_tryjoin_np.3:94
6768 msgid ""
6769 "These functions can fail with the same errors as B<pthread_join>(3).  "
6770 "B<pthread_tryjoin_np>()  can in addition fail with the following error:"
6771 msgstr ""
6772
6773 #. type: TP
6774 #: build/C/man3/pthread_tryjoin_np.3:94
6775 #, no-wrap
6776 msgid "B<EBUSY>"
6777 msgstr ""
6778
6779 #. type: Plain text
6780 #: build/C/man3/pthread_tryjoin_np.3:98
6781 msgid "I<thread> had not yet terminated at the time of the call."
6782 msgstr ""
6783
6784 #. type: Plain text
6785 #: build/C/man3/pthread_tryjoin_np.3:101
6786 msgid "B<pthread_timedjoin_np>()  can in addition fail with the following error:"
6787 msgstr ""
6788
6789 #. type: TP
6790 #: build/C/man3/pthread_tryjoin_np.3:101
6791 #, no-wrap
6792 msgid "B<ETIMEDOUT>"
6793 msgstr ""
6794
6795 #. type: Plain text
6796 #: build/C/man3/pthread_tryjoin_np.3:106
6797 msgid "The call timed out before I<thread> terminated."
6798 msgstr ""
6799
6800 #. type: Plain text
6801 #: build/C/man3/pthread_tryjoin_np.3:110
6802 msgid "B<pthread_timedjoin_np>()  never returns the error B<EINTR>."
6803 msgstr ""
6804
6805 #. type: Plain text
6806 #: build/C/man3/pthread_tryjoin_np.3:112
6807 msgid "These functions first appeared in glibc in version 2.3.3."
6808 msgstr ""
6809
6810 #. type: Plain text
6811 #: build/C/man3/pthread_tryjoin_np.3:117
6812 msgid "The following code waits to join for up to 5 seconds:"
6813 msgstr ""
6814
6815 #. type: Plain text
6816 #: build/C/man3/pthread_tryjoin_np.3:121
6817 #, no-wrap
6818 msgid ""
6819 "    struct timespec ts;\n"
6820 "    int s;\n"
6821 msgstr ""
6822
6823 #. type: Plain text
6824 #: build/C/man3/pthread_tryjoin_np.3:123
6825 #, no-wrap
6826 msgid "    ...\n"
6827 msgstr ""
6828
6829 #. type: Plain text
6830 #: build/C/man3/pthread_tryjoin_np.3:127
6831 #, no-wrap
6832 msgid ""
6833 "    if (clock_gettime(CLOCK_REALTIME, &ts) == -1) {\n"
6834 "\t/* Handle error */\n"
6835 "    }\n"
6836 msgstr ""
6837
6838 #. type: Plain text
6839 #: build/C/man3/pthread_tryjoin_np.3:129
6840 #, no-wrap
6841 msgid "    ts.tv_sec += 5;\n"
6842 msgstr ""
6843
6844 #. type: Plain text
6845 #: build/C/man3/pthread_tryjoin_np.3:134
6846 #, no-wrap
6847 msgid ""
6848 "    s = pthread_timedjoin_np(thread, NULL, &ts);\n"
6849 "    if (s != 0) {\n"
6850 "        /* Handle error */\n"
6851 "    }\n"
6852 msgstr ""
6853
6854 #. type: Plain text
6855 #: build/C/man3/pthread_tryjoin_np.3:140
6856 msgid "B<clock_gettime>(2), B<pthread_exit>(3), B<pthread_join>(3), B<pthreads>(7)"
6857 msgstr ""
6858
6859 #. type: TH
6860 #: build/C/man3/pthread_yield.3:25
6861 #, no-wrap
6862 msgid "PTHREAD_YIELD"
6863 msgstr ""
6864
6865 #. type: TH
6866 #: build/C/man3/pthread_yield.3:25
6867 #, no-wrap
6868 msgid "2013-03-05"
6869 msgstr ""
6870
6871 #. type: Plain text
6872 #: build/C/man3/pthread_yield.3:28
6873 msgid "pthread_yield - yield the processor"
6874 msgstr ""
6875
6876 #. type: Plain text
6877 #: build/C/man3/pthread_yield.3:34
6878 #, no-wrap
6879 msgid "B<int pthread_yield(void);>\n"
6880 msgstr ""
6881
6882 #. type: Plain text
6883 #: build/C/man3/pthread_yield.3:44
6884 msgid ""
6885 "B<pthread_yield>()  causes the calling thread to relinquish the CPU.  The "
6886 "thread is placed at the end of the run queue for its static priority and "
6887 "another thread is scheduled to run.  For further details, see "
6888 "B<sched_yield>(2)"
6889 msgstr ""
6890
6891 #. type: Plain text
6892 #: build/C/man3/pthread_yield.3:49
6893 msgid ""
6894 "On success, B<pthread_yield>()  returns 0; on error, it returns an error "
6895 "number."
6896 msgstr ""
6897
6898 #. type: Plain text
6899 #: build/C/man3/pthread_yield.3:53
6900 msgid ""
6901 "On Linux, this call always succeeds (but portable and future-proof "
6902 "applications should nevertheless handle a possible error return)."
6903 msgstr ""
6904
6905 #.  e.g., the BSDs, Tru64, AIX, and Irix.
6906 #. type: Plain text
6907 #: build/C/man3/pthread_yield.3:59
6908 msgid ""
6909 "This call is nonstandard, but present on several other systems.  Use the "
6910 "standardized B<sched_yield>(2)  instead."
6911 msgstr ""
6912
6913 #. type: Plain text
6914 #: build/C/man3/pthread_yield.3:62
6915 msgid "On Linux, this function is implemented as a call to B<sched_yield>(2)."
6916 msgstr ""
6917
6918 #. type: Plain text
6919 #: build/C/man3/pthread_yield.3:66
6920 msgid "B<sched_setscheduler>(2), B<sched_yield>(2), B<pthreads>(7)"
6921 msgstr ""
6922
6923 #. type: TH
6924 #: build/C/man7/pthreads.7:26
6925 #, no-wrap
6926 msgid "PTHREADS"
6927 msgstr ""
6928
6929 #. type: TH
6930 #: build/C/man7/pthreads.7:26
6931 #, no-wrap
6932 msgid "2010-11-14"
6933 msgstr ""
6934
6935 #. type: Plain text
6936 #: build/C/man7/pthreads.7:29
6937 msgid "pthreads - POSIX threads"
6938 msgstr ""
6939
6940 #. type: Plain text
6941 #: build/C/man7/pthreads.7:36
6942 msgid ""
6943 "POSIX.1 specifies a set of interfaces (functions, header files) for threaded "
6944 "programming commonly known as POSIX threads, or Pthreads.  A single process "
6945 "can contain multiple threads, all of which are executing the same program.  "
6946 "These threads share the same global memory (data and heap segments), but "
6947 "each thread has its own stack (automatic variables)."
6948 msgstr ""
6949
6950 #. type: Plain text
6951 #: build/C/man7/pthreads.7:39
6952 msgid ""
6953 "POSIX.1 also requires that threads share a range of other attributes (i.e., "
6954 "these attributes are process-wide rather than per-thread):"
6955 msgstr ""
6956
6957 #. type: IP
6958 #: 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
6959 #, no-wrap
6960 msgid "-"
6961 msgstr ""
6962
6963 #. type: Plain text
6964 #: build/C/man7/pthreads.7:41
6965 msgid "process ID"
6966 msgstr ""
6967
6968 #. type: Plain text
6969 #: build/C/man7/pthreads.7:43
6970 msgid "parent process ID"
6971 msgstr ""
6972
6973 #. type: Plain text
6974 #: build/C/man7/pthreads.7:45
6975 msgid "process group ID and session ID"
6976 msgstr ""
6977
6978 #. type: Plain text
6979 #: build/C/man7/pthreads.7:47
6980 msgid "controlling terminal"
6981 msgstr ""
6982
6983 #. type: Plain text
6984 #: build/C/man7/pthreads.7:49
6985 msgid "user and group IDs"
6986 msgstr ""
6987
6988 #. type: Plain text
6989 #: build/C/man7/pthreads.7:51
6990 msgid "open file descriptors"
6991 msgstr ""
6992
6993 #. type: Plain text
6994 #: build/C/man7/pthreads.7:54
6995 msgid "record locks (see B<fcntl>(2))"
6996 msgstr ""
6997
6998 #. type: Plain text
6999 #: build/C/man7/pthreads.7:56
7000 msgid "signal dispositions"
7001 msgstr ""
7002
7003 #. type: Plain text
7004 #: build/C/man7/pthreads.7:59
7005 msgid "file mode creation mask (B<umask>(2))"
7006 msgstr ""
7007
7008 #. type: Plain text
7009 #: build/C/man7/pthreads.7:65
7010 msgid "current directory (B<chdir>(2))  and root directory (B<chroot>(2))"
7011 msgstr ""
7012
7013 #. type: Plain text
7014 #: build/C/man7/pthreads.7:70
7015 msgid "interval timers (B<setitimer>(2))  and POSIX timers (B<timer_create>(2))"
7016 msgstr ""
7017
7018 #. type: Plain text
7019 #: build/C/man7/pthreads.7:73
7020 msgid "nice value (B<setpriority>(2))"
7021 msgstr ""
7022
7023 #. type: Plain text
7024 #: build/C/man7/pthreads.7:76
7025 msgid "resource limits (B<setrlimit>(2))"
7026 msgstr ""
7027
7028 #. type: Plain text
7029 #: build/C/man7/pthreads.7:81
7030 msgid ""
7031 "measurements of the consumption of CPU time (B<times>(2))  and resources "
7032 "(B<getrusage>(2))"
7033 msgstr ""
7034
7035 #. type: Plain text
7036 #: build/C/man7/pthreads.7:84
7037 msgid ""
7038 "As well as the stack, POSIX.1 specifies that various other attributes are "
7039 "distinct for each thread, including:"
7040 msgstr ""
7041
7042 #. type: Plain text
7043 #: build/C/man7/pthreads.7:88
7044 msgid "thread ID (the I<pthread_t> data type)"
7045 msgstr ""
7046
7047 #. type: Plain text
7048 #: build/C/man7/pthreads.7:91
7049 msgid "signal mask (B<pthread_sigmask>(3))"
7050 msgstr ""
7051
7052 #. type: Plain text
7053 #: build/C/man7/pthreads.7:95
7054 msgid "the I<errno> variable"
7055 msgstr ""
7056
7057 #. type: Plain text
7058 #: build/C/man7/pthreads.7:98
7059 msgid "alternate signal stack (B<sigaltstack>(2))"
7060 msgstr ""
7061
7062 #. type: Plain text
7063 #: build/C/man7/pthreads.7:103
7064 msgid ""
7065 "real-time scheduling policy and priority (B<sched_setscheduler>(2)  and "
7066 "B<sched_setparam>(2))"
7067 msgstr ""
7068
7069 #. type: Plain text
7070 #: build/C/man7/pthreads.7:105
7071 msgid "The following Linux-specific features are also per-thread:"
7072 msgstr ""
7073
7074 #. type: Plain text
7075 #: build/C/man7/pthreads.7:108
7076 msgid "capabilities (see B<capabilities>(7))"
7077 msgstr ""
7078
7079 #. type: Plain text
7080 #: build/C/man7/pthreads.7:111
7081 msgid "CPU affinity (B<sched_setaffinity>(2))"
7082 msgstr ""
7083
7084 #. type: SS
7085 #: build/C/man7/pthreads.7:111
7086 #, no-wrap
7087 msgid "Pthreads function return values"
7088 msgstr ""
7089
7090 #. type: Plain text
7091 #: build/C/man7/pthreads.7:118
7092 msgid ""
7093 "Most pthreads functions return 0 on success, and an error number of "
7094 "failure.  Note that the pthreads functions do not set I<errno>.  For each of "
7095 "the pthreads functions that can return an error, POSIX.1-2001 specifies that "
7096 "the function can never fail with the error B<EINTR>."
7097 msgstr ""
7098
7099 #. type: SS
7100 #: build/C/man7/pthreads.7:118
7101 #, no-wrap
7102 msgid "Thread IDs"
7103 msgstr ""
7104
7105 #. type: Plain text
7106 #: build/C/man7/pthreads.7:132
7107 msgid ""
7108 "Each of the threads in a process has a unique thread identifier (stored in "
7109 "the type I<pthread_t>).  This identifier is returned to the caller of "
7110 "B<pthread_create>(3), and a thread can obtain its own thread identifier "
7111 "using B<pthread_self>(3).  Thread IDs are guaranteed to be unique only "
7112 "within a process.  A thread ID may be reused after a terminated thread has "
7113 "been joined, or a detached thread has terminated.  In all pthreads functions "
7114 "that accept a thread ID as an argument, that ID by definition refers to a "
7115 "thread in the same process as the caller."
7116 msgstr ""
7117
7118 #. type: SS
7119 #: build/C/man7/pthreads.7:132
7120 #, no-wrap
7121 msgid "Thread-safe functions"
7122 msgstr ""
7123
7124 #. type: Plain text
7125 #: build/C/man7/pthreads.7:136
7126 msgid ""
7127 "A thread-safe function is one that can be safely (i.e., it will deliver the "
7128 "same results regardless of whether it is)  called from multiple threads at "
7129 "the same time."
7130 msgstr ""
7131
7132 #. type: Plain text
7133 #: build/C/man7/pthreads.7:140
7134 msgid ""
7135 "POSIX.1-2001 and POSIX.1-2008 require that all functions specified in the "
7136 "standard shall be thread-safe, except for the following functions:"
7137 msgstr ""
7138
7139 #. type: Plain text
7140 #: build/C/man7/pthreads.7:234
7141 #, no-wrap
7142 msgid ""
7143 "asctime()\n"
7144 "basename()\n"
7145 "catgets()\n"
7146 "crypt()\n"
7147 "ctermid() if passed a non-NULL argument\n"
7148 "ctime()\n"
7149 "dbm_clearerr()\n"
7150 "dbm_close()\n"
7151 "dbm_delete()\n"
7152 "dbm_error()\n"
7153 "dbm_fetch()\n"
7154 "dbm_firstkey()\n"
7155 "dbm_nextkey()\n"
7156 "dbm_open()\n"
7157 "dbm_store()\n"
7158 "dirname()\n"
7159 "dlerror()\n"
7160 "drand48()\n"
7161 "ecvt() [POSIX.1-2001 only (function removed in POSIX.1-2008)]\n"
7162 "encrypt()\n"
7163 "endgrent()\n"
7164 "endpwent()\n"
7165 "endutxent()\n"
7166 "fcvt() [POSIX.1-2001 only (function removed in POSIX.1-2008)]\n"
7167 "ftw()\n"
7168 "gcvt() [POSIX.1-2001 only (function removed in POSIX.1-2008)]\n"
7169 "getc_unlocked()\n"
7170 "getchar_unlocked()\n"
7171 "getdate()\n"
7172 "getenv()\n"
7173 "getgrent()\n"
7174 "getgrgid()\n"
7175 "getgrnam()\n"
7176 "gethostbyaddr() [POSIX.1-2001 only (function removed in POSIX.1-2008)]\n"
7177 "gethostbyname() [POSIX.1-2001 only (function removed in POSIX.1-2008)]\n"
7178 "gethostent()\n"
7179 "getlogin()\n"
7180 "getnetbyaddr()\n"
7181 "getnetbyname()\n"
7182 "getnetent()\n"
7183 "getopt()\n"
7184 "getprotobyname()\n"
7185 "getprotobynumber()\n"
7186 "getprotoent()\n"
7187 "getpwent()\n"
7188 "getpwnam()\n"
7189 "getpwuid()\n"
7190 "getservbyname()\n"
7191 "getservbyport()\n"
7192 "getservent()\n"
7193 "getutxent()\n"
7194 "getutxid()\n"
7195 "getutxline()\n"
7196 "gmtime()\n"
7197 "hcreate()\n"
7198 "hdestroy()\n"
7199 "hsearch()\n"
7200 "inet_ntoa()\n"
7201 "l64a()\n"
7202 "lgamma()\n"
7203 "lgammaf()\n"
7204 "lgammal()\n"
7205 "localeconv()\n"
7206 "localtime()\n"
7207 "lrand48()\n"
7208 "mrand48()\n"
7209 "nftw()\n"
7210 "nl_langinfo()\n"
7211 "ptsname()\n"
7212 "putc_unlocked()\n"
7213 "putchar_unlocked()\n"
7214 "putenv()\n"
7215 "pututxline()\n"
7216 "rand()\n"
7217 "readdir()\n"
7218 "setenv()\n"
7219 "setgrent()\n"
7220 "setkey()\n"
7221 "setpwent()\n"
7222 "setutxent()\n"
7223 "strerror()\n"
7224 "strsignal() [Added in POSIX.1-2008]\n"
7225 "strtok()\n"
7226 "system() [Added in POSIX.1-2008]\n"
7227 "tmpnam() if passed a non-NULL argument\n"
7228 "ttyname()\n"
7229 "unsetenv()\n"
7230 "wcrtomb() if its final argument is NULL\n"
7231 "wcsrtombs() if its final argument is NULL\n"
7232 "wcstombs()\n"
7233 "wctomb()\n"
7234 msgstr ""
7235
7236 #. type: SS
7237 #: build/C/man7/pthreads.7:236
7238 #, no-wrap
7239 msgid "Async-cancel-safe functions"
7240 msgstr ""
7241
7242 #. type: Plain text
7243 #: build/C/man7/pthreads.7:240
7244 msgid ""
7245 "An async-cancel-safe function is one that can be safely called in an "
7246 "application where asynchronous cancelability is enabled (see "
7247 "B<pthread_setcancelstate>(3))."
7248 msgstr ""
7249
7250 #. type: Plain text
7251 #: build/C/man7/pthreads.7:243
7252 msgid ""
7253 "Only the following functions are required to be async-cancel-safe by "
7254 "POSIX.1-2001 and POSIX.1-2008:"
7255 msgstr ""
7256
7257 #. type: Plain text
7258 #: build/C/man7/pthreads.7:249
7259 #, no-wrap
7260 msgid ""
7261 "pthread_cancel()\n"
7262 "pthread_setcancelstate()\n"
7263 "pthread_setcanceltype()\n"
7264 msgstr ""
7265
7266 #. type: SS
7267 #: build/C/man7/pthreads.7:251
7268 #, no-wrap
7269 msgid "Cancellation points"
7270 msgstr ""
7271
7272 #. type: Plain text
7273 #: build/C/man7/pthreads.7:258
7274 msgid ""
7275 "POSIX.1 specifies that certain functions must, and certain other functions "
7276 "may, be cancellation points.  If a thread is cancelable, its cancelability "
7277 "type is deferred, and a cancellation request is pending for the thread, then "
7278 "the thread is canceled when it calls a function that is a cancellation "
7279 "point."
7280 msgstr ""
7281
7282 #. type: Plain text
7283 #: build/C/man7/pthreads.7:261
7284 msgid ""
7285 "The following functions are required to be cancellation points by "
7286 "POSIX.1-2001 and/or POSIX.1-2008:"
7287 msgstr ""
7288
7289 #. type: Plain text
7290 #: build/C/man7/pthreads.7:324
7291 #, no-wrap
7292 msgid ""
7293 "accept()\n"
7294 "aio_suspend()\n"
7295 "clock_nanosleep()\n"
7296 "close()\n"
7297 "connect()\n"
7298 "creat()\n"
7299 "fcntl() F_SETLKW\n"
7300 "fdatasync()\n"
7301 "fsync()\n"
7302 "getmsg()\n"
7303 "getpmsg()\n"
7304 "lockf() F_LOCK\n"
7305 "mq_receive()\n"
7306 "mq_send()\n"
7307 "mq_timedreceive()\n"
7308 "mq_timedsend()\n"
7309 "msgrcv()\n"
7310 "msgsnd()\n"
7311 "msync()\n"
7312 "nanosleep()\n"
7313 "open()\n"
7314 "openat() [Added in POSIX.1-2008]\n"
7315 "pause()\n"
7316 "poll()\n"
7317 "pread()\n"
7318 "pselect()\n"
7319 "pthread_cond_timedwait()\n"
7320 "pthread_cond_wait()\n"
7321 "pthread_join()\n"
7322 "pthread_testcancel()\n"
7323 "putmsg()\n"
7324 "putpmsg()\n"
7325 "pwrite()\n"
7326 "read()\n"
7327 "readv()\n"
7328 "recv()\n"
7329 "recvfrom()\n"
7330 "recvmsg()\n"
7331 "select()\n"
7332 "sem_timedwait()\n"
7333 "sem_wait()\n"
7334 "send()\n"
7335 "sendmsg()\n"
7336 "sendto()\n"
7337 "sigpause() [POSIX.1-2001 only (moves to \"may\" list in POSIX.1-2008)]\n"
7338 "sigsuspend()\n"
7339 "sigtimedwait()\n"
7340 "sigwait()\n"
7341 "sigwaitinfo()\n"
7342 "sleep()\n"
7343 "system()\n"
7344 "tcdrain()\n"
7345 "usleep() [POSIX.1-2001 only (function removed in POSIX.1-2008)]\n"
7346 "wait()\n"
7347 "waitid()\n"
7348 "waitpid()\n"
7349 "write()\n"
7350 "writev()\n"
7351 msgstr ""
7352
7353 #. type: Plain text
7354 #: build/C/man7/pthreads.7:329
7355 msgid ""
7356 "The following functions may be cancellation points according to POSIX.1-2001 "
7357 "and/or POSIX.1-2008:"
7358 msgstr ""
7359
7360 #. type: Plain text
7361 #: build/C/man7/pthreads.7:557
7362 #, no-wrap
7363 msgid ""
7364 "access()\n"
7365 "asctime()\n"
7366 "asctime_r()\n"
7367 "catclose()\n"
7368 "catgets()\n"
7369 "catopen()\n"
7370 "chmod() [Added in POSIX.1-2008]\n"
7371 "chown() [Added in POSIX.1-2008]\n"
7372 "closedir()\n"
7373 "closelog()\n"
7374 "ctermid()\n"
7375 "ctime()\n"
7376 "ctime_r()\n"
7377 "dbm_close()\n"
7378 "dbm_delete()\n"
7379 "dbm_fetch()\n"
7380 "dbm_nextkey()\n"
7381 "dbm_open()\n"
7382 "dbm_store()\n"
7383 "dlclose()\n"
7384 "dlopen()\n"
7385 "dprintf() [Added in POSIX.1-2008]\n"
7386 "endgrent()\n"
7387 "endhostent()\n"
7388 "endnetent()\n"
7389 "endprotoent()\n"
7390 "endpwent()\n"
7391 "endservent()\n"
7392 "endutxent()\n"
7393 "faccessat() [Added in POSIX.1-2008]\n"
7394 "fchmod() [Added in POSIX.1-2008]\n"
7395 "fchmodat() [Added in POSIX.1-2008]\n"
7396 "fchown() [Added in POSIX.1-2008]\n"
7397 "fchownat() [Added in POSIX.1-2008]\n"
7398 "fclose()\n"
7399 "fcntl() (for any value of cmd argument)\n"
7400 "fflush()\n"
7401 "fgetc()\n"
7402 "fgetpos()\n"
7403 "fgets()\n"
7404 "fgetwc()\n"
7405 "fgetws()\n"
7406 "fmtmsg()\n"
7407 "fopen()\n"
7408 "fpathconf()\n"
7409 "fprintf()\n"
7410 "fputc()\n"
7411 "fputs()\n"
7412 "fputwc()\n"
7413 "fputws()\n"
7414 "fread()\n"
7415 "freopen()\n"
7416 "fscanf()\n"
7417 "fseek()\n"
7418 "fseeko()\n"
7419 "fsetpos()\n"
7420 "fstat()\n"
7421 "fstatat() [Added in POSIX.1-2008]\n"
7422 "ftell()\n"
7423 "ftello()\n"
7424 "ftw()\n"
7425 "futimens() [Added in POSIX.1-2008]\n"
7426 "fwprintf()\n"
7427 "fwrite()\n"
7428 "fwscanf()\n"
7429 "getaddrinfo()\n"
7430 "getc()\n"
7431 "getc_unlocked()\n"
7432 "getchar()\n"
7433 "getchar_unlocked()\n"
7434 "getcwd()\n"
7435 "getdate()\n"
7436 "getdelim() [Added in POSIX.1-2008]\n"
7437 "getgrent()\n"
7438 "getgrgid()\n"
7439 "getgrgid_r()\n"
7440 "getgrnam()\n"
7441 "getgrnam_r()\n"
7442 "gethostbyaddr() [SUSv3 only (function removed in POSIX.1-2008)]\n"
7443 "gethostbyname() [SUSv3 only (function removed in POSIX.1-2008)]\n"
7444 "gethostent()\n"
7445 "gethostid()\n"
7446 "gethostname()\n"
7447 "getline() [Added in POSIX.1-2008]\n"
7448 "getlogin()\n"
7449 "getlogin_r()\n"
7450 "getnameinfo()\n"
7451 "getnetbyaddr()\n"
7452 "getnetbyname()\n"
7453 "getnetent()\n"
7454 "getopt() (if opterr is nonzero)\n"
7455 "getprotobyname()\n"
7456 "getprotobynumber()\n"
7457 "getprotoent()\n"
7458 "getpwent()\n"
7459 "getpwnam()\n"
7460 "getpwnam_r()\n"
7461 "getpwuid()\n"
7462 "getpwuid_r()\n"
7463 "gets()\n"
7464 "getservbyname()\n"
7465 "getservbyport()\n"
7466 "getservent()\n"
7467 "getutxent()\n"
7468 "getutxid()\n"
7469 "getutxline()\n"
7470 "getwc()\n"
7471 "getwchar()\n"
7472 "getwd() [SUSv3 only (function removed in POSIX.1-2008)]\n"
7473 "glob()\n"
7474 "iconv_close()\n"
7475 "iconv_open()\n"
7476 "ioctl()\n"
7477 "link()\n"
7478 "linkat() [Added in POSIX.1-2008]\n"
7479 "lio_listio() [Added in POSIX.1-2008]\n"
7480 "localtime()\n"
7481 "localtime_r()\n"
7482 "lockf() [Added in POSIX.1-2008]\n"
7483 "lseek()\n"
7484 "lstat()\n"
7485 "mkdir() [Added in POSIX.1-2008]\n"
7486 "mkdirat() [Added in POSIX.1-2008]\n"
7487 "mkdtemp() [Added in POSIX.1-2008]\n"
7488 "mkfifo() [Added in POSIX.1-2008]\n"
7489 "mkfifoat() [Added in POSIX.1-2008]\n"
7490 "mknod() [Added in POSIX.1-2008]\n"
7491 "mknodat() [Added in POSIX.1-2008]\n"
7492 "mkstemp()\n"
7493 "mktime()\n"
7494 "nftw()\n"
7495 "opendir()\n"
7496 "openlog()\n"
7497 "pathconf()\n"
7498 "pclose()\n"
7499 "perror()\n"
7500 "popen()\n"
7501 "posix_fadvise()\n"
7502 "posix_fallocate()\n"
7503 "posix_madvise()\n"
7504 "posix_openpt()\n"
7505 "posix_spawn()\n"
7506 "posix_spawnp()\n"
7507 "posix_trace_clear()\n"
7508 "posix_trace_close()\n"
7509 "posix_trace_create()\n"
7510 "posix_trace_create_withlog()\n"
7511 "posix_trace_eventtypelist_getnext_id()\n"
7512 "posix_trace_eventtypelist_rewind()\n"
7513 "posix_trace_flush()\n"
7514 "posix_trace_get_attr()\n"
7515 "posix_trace_get_filter()\n"
7516 "posix_trace_get_status()\n"
7517 "posix_trace_getnext_event()\n"
7518 "posix_trace_open()\n"
7519 "posix_trace_rewind()\n"
7520 "posix_trace_set_filter()\n"
7521 "posix_trace_shutdown()\n"
7522 "posix_trace_timedgetnext_event()\n"
7523 "posix_typed_mem_open()\n"
7524 "printf()\n"
7525 "psiginfo() [Added in POSIX.1-2008]\n"
7526 "psignal() [Added in POSIX.1-2008]\n"
7527 "pthread_rwlock_rdlock()\n"
7528 "pthread_rwlock_timedrdlock()\n"
7529 "pthread_rwlock_timedwrlock()\n"
7530 "pthread_rwlock_wrlock()\n"
7531 "putc()\n"
7532 "putc_unlocked()\n"
7533 "putchar()\n"
7534 "putchar_unlocked()\n"
7535 "puts()\n"
7536 "pututxline()\n"
7537 "putwc()\n"
7538 "putwchar()\n"
7539 "readdir()\n"
7540 "readdir_r()\n"
7541 "readlink() [Added in POSIX.1-2008]\n"
7542 "readlinkat() [Added in POSIX.1-2008]\n"
7543 "remove()\n"
7544 "rename()\n"
7545 "renameat() [Added in POSIX.1-2008]\n"
7546 "rewind()\n"
7547 "rewinddir()\n"
7548 "scandir() [Added in POSIX.1-2008]\n"
7549 "scanf()\n"
7550 "seekdir()\n"
7551 "semop()\n"
7552 "setgrent()\n"
7553 "sethostent()\n"
7554 "setnetent()\n"
7555 "setprotoent()\n"
7556 "setpwent()\n"
7557 "setservent()\n"
7558 "setutxent()\n"
7559 "sigpause() [Added in POSIX.1-2008]\n"
7560 "stat()\n"
7561 "strerror()\n"
7562 "strerror_r()\n"
7563 "strftime()\n"
7564 "symlink()\n"
7565 "symlinkat() [Added in POSIX.1-2008]\n"
7566 "sync()\n"
7567 "syslog()\n"
7568 "tmpfile()\n"
7569 "tmpnam()\n"
7570 "ttyname()\n"
7571 "ttyname_r()\n"
7572 "tzset()\n"
7573 "ungetc()\n"
7574 "ungetwc()\n"
7575 "unlink()\n"
7576 "unlinkat() [Added in POSIX.1-2008]\n"
7577 "utime() [Added in POSIX.1-2008]\n"
7578 "utimensat() [Added in POSIX.1-2008]\n"
7579 "utimes() [Added in POSIX.1-2008]\n"
7580 "vdprintf() [Added in POSIX.1-2008]\n"
7581 "vfprintf()\n"
7582 "vfwprintf()\n"
7583 "vprintf()\n"
7584 "vwprintf()\n"
7585 "wcsftime()\n"
7586 "wordexp()\n"
7587 "wprintf()\n"
7588 "wscanf()\n"
7589 msgstr ""
7590
7591 #.  So, scanning "cancellation point" comments in the glibc 2.8 header
7592 #.  files, it looks as though at least the following nonstandard
7593 #.  functions are cancellation points:
7594 #.  endnetgrent
7595 #.  endspent
7596 #.  epoll_pwait
7597 #.  epoll_wait
7598 #.  fcloseall
7599 #.  fdopendir
7600 #.  fflush_unlocked
7601 #.  fgetc_unlocked
7602 #.  fgetgrent
7603 #.  fgetgrent_r
7604 #.  fgetpwent
7605 #.  fgetpwent_r
7606 #.  fgets_unlocked
7607 #.  fgetspent
7608 #.  fgetspent_r
7609 #.  fgetwc_unlocked
7610 #.  fgetws_unlocked
7611 #.  fputc_unlocked
7612 #.  fputs_unlocked
7613 #.  fputwc_unlocked
7614 #.  fputws_unlocked
7615 #.  fread_unlocked
7616 #.  fwrite_unlocked
7617 #.  gai_suspend
7618 #.  getaddrinfo_a
7619 #.  getdate_r
7620 #.  getgrent_r
7621 #.  getgrouplist
7622 #.  gethostbyaddr_r
7623 #.  gethostbyname2
7624 #.  gethostbyname2_r
7625 #.  gethostbyname_r
7626 #.  gethostent_r
7627 #.  getnetbyaddr_r
7628 #.  getnetbyname_r
7629 #.  getnetent_r
7630 #.  getnetgrent
7631 #.  getnetgrent_r
7632 #.  getprotobyname_r
7633 #.  getprotobynumber_r
7634 #.  getprotoent_r
7635 #.  getpw
7636 #.  getpwent_r
7637 #.  getservbyname_r
7638 #.  getservbyport_r
7639 #.  getservent_r
7640 #.  getspent
7641 #.  getspent_r
7642 #.  getspnam
7643 #.  getspnam_r
7644 #.  getutmp
7645 #.  getutmpx
7646 #.  getw
7647 #.  getwc_unlocked
7648 #.  getwchar_unlocked
7649 #.  initgroups
7650 #.  innetgr
7651 #.  mkostemp
7652 #.  mkostemp64
7653 #.  mkstemp64
7654 #.  ppoll
7655 #.  pthread_timedjoin_np
7656 #.  putgrent
7657 #.  putpwent
7658 #.  putspent
7659 #.  putw
7660 #.  putwc_unlocked
7661 #.  putwchar_unlocked
7662 #.  rcmd
7663 #.  rcmd_af
7664 #.  rexec
7665 #.  rexec_af
7666 #.  rresvport
7667 #.  rresvport_af
7668 #.  ruserok
7669 #.  ruserok_af
7670 #.  setnetgrent
7671 #.  setspent
7672 #.  sgetspent
7673 #.  sgetspent_r
7674 #.  updwtmpx
7675 #.  utmpxname
7676 #.  vfscanf
7677 #.  vfwscanf
7678 #.  vscanf
7679 #.  vsyslog
7680 #.  vwscanf
7681 #. type: Plain text
7682 #: build/C/man7/pthreads.7:655
7683 msgid ""
7684 "An implementation may also mark other functions not specified in the "
7685 "standard as cancellation points.  In particular, an implementation is likely "
7686 "to mark any nonstandard function that may block as a cancellation point.  "
7687 "(This includes most functions that can touch files.)"
7688 msgstr ""
7689
7690 #. type: SS
7691 #: build/C/man7/pthreads.7:655
7692 #, no-wrap
7693 msgid "Compiling on Linux"
7694 msgstr ""
7695
7696 #. type: Plain text
7697 #: build/C/man7/pthreads.7:658
7698 msgid ""
7699 "On Linux, programs that use the Pthreads API should be compiled using I<cc "
7700 "-pthread>."
7701 msgstr ""
7702
7703 #. type: SS
7704 #: build/C/man7/pthreads.7:658
7705 #, no-wrap
7706 msgid "Linux implementations of POSIX threads"
7707 msgstr ""
7708
7709 #. type: Plain text
7710 #: build/C/man7/pthreads.7:661
7711 msgid ""
7712 "Over time, two threading implementations have been provided by the GNU C "
7713 "library on Linux:"
7714 msgstr ""
7715
7716 #. type: TP
7717 #: build/C/man7/pthreads.7:661
7718 #, no-wrap
7719 msgid "B<LinuxThreads>"
7720 msgstr ""
7721
7722 #. type: Plain text
7723 #: build/C/man7/pthreads.7:665
7724 msgid ""
7725 "This is the original Pthreads implementation.  Since glibc 2.4, this "
7726 "implementation is no longer supported."
7727 msgstr ""
7728
7729 #. type: TP
7730 #: build/C/man7/pthreads.7:665
7731 #, no-wrap
7732 msgid "B<NPTL> (Native POSIX Threads Library)"
7733 msgstr ""
7734
7735 #. type: Plain text
7736 #: build/C/man7/pthreads.7:673
7737 msgid ""
7738 "This is the modern Pthreads implementation.  By comparison with "
7739 "LinuxThreads, NPTL provides closer conformance to the requirements of the "
7740 "POSIX.1 specification and better performance when creating large numbers of "
7741 "threads.  NPTL is available since glibc 2.3.2, and requires features that "
7742 "are present in the Linux 2.6 kernel."
7743 msgstr ""
7744
7745 #. type: Plain text
7746 #: build/C/man7/pthreads.7:683
7747 msgid ""
7748 "Both of these are so-called 1:1 implementations, meaning that each thread "
7749 "maps to a kernel scheduling entity.  Both threading implementations employ "
7750 "the Linux B<clone>(2)  system call.  In NPTL, thread synchronization "
7751 "primitives (mutexes, thread joining, and so on) are implemented using the "
7752 "Linux B<futex>(2)  system call."
7753 msgstr ""
7754
7755 #. type: SS
7756 #: build/C/man7/pthreads.7:683
7757 #, no-wrap
7758 msgid "LinuxThreads"
7759 msgstr ""
7760
7761 #. type: Plain text
7762 #: build/C/man7/pthreads.7:685
7763 msgid "The notable features of this implementation are the following:"
7764 msgstr ""
7765
7766 #. type: Plain text
7767 #: build/C/man7/pthreads.7:692
7768 msgid ""
7769 "In addition to the main (initial) thread, and the threads that the program "
7770 "creates using B<pthread_create>(3), the implementation creates a \"manager\" "
7771 "thread.  This thread handles thread creation and termination.  (Problems can "
7772 "result if this thread is inadvertently killed.)"
7773 msgstr ""
7774
7775 #. type: Plain text
7776 #: build/C/man7/pthreads.7:704
7777 msgid ""
7778 "Signals are used internally by the implementation.  On Linux 2.2 and later, "
7779 "the first three real-time signals are used (see also B<signal>(7)).  On "
7780 "older Linux kernels, B<SIGUSR1> and B<SIGUSR2> are used.  Applications must "
7781 "avoid the use of whichever set of signals is employed by the implementation."
7782 msgstr ""
7783
7784 #. type: Plain text
7785 #: build/C/man7/pthreads.7:711
7786 msgid ""
7787 "Threads do not share process IDs.  (In effect, LinuxThreads threads are "
7788 "implemented as processes which share more information than usual, but which "
7789 "do not share a common process ID.)  LinuxThreads threads (including the "
7790 "manager thread)  are visible as separate processes using B<ps>(1)."
7791 msgstr ""
7792
7793 #. type: Plain text
7794 #: build/C/man7/pthreads.7:714
7795 msgid ""
7796 "The LinuxThreads implementation deviates from the POSIX.1 specification in a "
7797 "number of ways, including the following:"
7798 msgstr ""
7799
7800 #. type: Plain text
7801 #: build/C/man7/pthreads.7:718
7802 msgid "Calls to B<getpid>(2)  return a different value in each thread."
7803 msgstr ""
7804
7805 #. type: Plain text
7806 #: build/C/man7/pthreads.7:727
7807 msgid ""
7808 "Calls to B<getppid>(2)  in threads other than the main thread return the "
7809 "process ID of the manager thread; instead B<getppid>(2)  in these threads "
7810 "should return the same value as B<getppid>(2)  in the main thread."
7811 msgstr ""
7812
7813 #. type: Plain text
7814 #: build/C/man7/pthreads.7:737
7815 msgid ""
7816 "When one thread creates a new child process using B<fork>(2), any thread "
7817 "should be able to B<wait>(2)  on the child.  However, the implementation "
7818 "only allows the thread that created the child to B<wait>(2)  on it."
7819 msgstr ""
7820
7821 #. type: Plain text
7822 #: build/C/man7/pthreads.7:744
7823 msgid ""
7824 "When a thread calls B<execve>(2), all other threads are terminated (as "
7825 "required by POSIX.1).  However, the resulting process has the same PID as "
7826 "the thread that called B<execve>(2): it should have the same PID as the main "
7827 "thread."
7828 msgstr ""
7829
7830 #. type: Plain text
7831 #: build/C/man7/pthreads.7:751
7832 msgid ""
7833 "Threads do not share user and group IDs.  This can cause complications with "
7834 "set-user-ID programs and can cause failures in Pthreads functions if an "
7835 "application changes its credentials using B<seteuid>(2)  or similar."
7836 msgstr ""
7837
7838 #. type: Plain text
7839 #: build/C/man7/pthreads.7:753
7840 msgid "Threads do not share a common session ID and process group ID."
7841 msgstr ""
7842
7843 #. type: Plain text
7844 #: build/C/man7/pthreads.7:756
7845 msgid "Threads do not share record locks created using B<fcntl>(2)."
7846 msgstr ""
7847
7848 #. type: Plain text
7849 #: build/C/man7/pthreads.7:762
7850 msgid ""
7851 "The information returned by B<times>(2)  and B<getrusage>(2)  is per-thread "
7852 "rather than process-wide."
7853 msgstr ""
7854
7855 #. type: Plain text
7856 #: build/C/man7/pthreads.7:765
7857 msgid "Threads do not share semaphore undo values (see B<semop>(2))."
7858 msgstr ""
7859
7860 #. type: Plain text
7861 #: build/C/man7/pthreads.7:767
7862 msgid "Threads do not share interval timers."
7863 msgstr ""
7864
7865 #.  FIXME . bug report filed for NPTL nice nonconformance
7866 #.  http://bugzilla.kernel.org/show_bug.cgi?id=6258
7867 #.  Sep 08: there is a patch by Denys Vlasenko to address this
7868 #.  "make setpriority POSIX compliant; introduce PRIO_THREAD extension"
7869 #.  Monitor this to see if it makes it into mainline.
7870 #. type: Plain text
7871 #: build/C/man7/pthreads.7:769 build/C/man7/pthreads.7:806
7872 msgid "Threads do not share a common nice value."
7873 msgstr ""
7874
7875 #. type: Plain text
7876 #: build/C/man7/pthreads.7:779
7877 msgid ""
7878 "POSIX.1 distinguishes the notions of signals that are directed to the "
7879 "process as a whole and signals that are directed to individual threads.  "
7880 "According to POSIX.1, a process-directed signal (sent using B<kill>(2), for "
7881 "example) should be handled by a single, arbitrarily selected thread within "
7882 "the process.  LinuxThreads does not support the notion of process-directed "
7883 "signals: signals may be sent only to specific threads."
7884 msgstr ""
7885
7886 #. type: Plain text
7887 #: build/C/man7/pthreads.7:788
7888 msgid ""
7889 "Threads have distinct alternate signal stack settings.  However, a new "
7890 "thread's alternate signal stack settings are copied from the thread that "
7891 "created it, so that the threads initially share an alternate signal stack.  "
7892 "(A new thread should start with no alternate signal stack defined.  If two "
7893 "threads handle signals on their shared alternate signal stack at the same "
7894 "time, unpredictable program failures are likely to occur.)"
7895 msgstr ""
7896
7897 #. type: SS
7898 #: build/C/man7/pthreads.7:788
7899 #, no-wrap
7900 msgid "NPTL"
7901 msgstr ""
7902
7903 #. type: Plain text
7904 #: build/C/man7/pthreads.7:797
7905 msgid ""
7906 "With NPTL, all of the threads in a process are placed in the same thread "
7907 "group; all members of a thread group share the same PID.  NPTL does not "
7908 "employ a manager thread.  NPTL makes internal use of the first two real-time "
7909 "signals (see also B<signal>(7)); these signals cannot be used in "
7910 "applications."
7911 msgstr ""
7912
7913 #. type: Plain text
7914 #: build/C/man7/pthreads.7:799
7915 msgid "NPTL still has at least one nonconformance with POSIX.1:"
7916 msgstr ""
7917
7918 #. type: Plain text
7919 #: build/C/man7/pthreads.7:808
7920 msgid "Some NPTL nonconformances occur only with older kernels:"
7921 msgstr ""
7922
7923 #. type: Plain text
7924 #: build/C/man7/pthreads.7:814
7925 msgid ""
7926 "The information returned by B<times>(2)  and B<getrusage>(2)  is per-thread "
7927 "rather than process-wide (fixed in kernel 2.6.9)."
7928 msgstr ""
7929
7930 #. type: Plain text
7931 #: build/C/man7/pthreads.7:816
7932 msgid "Threads do not share resource limits (fixed in kernel 2.6.10)."
7933 msgstr ""
7934
7935 #. type: Plain text
7936 #: build/C/man7/pthreads.7:818
7937 msgid "Threads do not share interval timers (fixed in kernel 2.6.12)."
7938 msgstr ""
7939
7940 #. type: Plain text
7941 #: build/C/man7/pthreads.7:822
7942 msgid ""
7943 "Only the main thread is permitted to start a new session using B<setsid>(2)  "
7944 "(fixed in kernel 2.6.16)."
7945 msgstr ""
7946
7947 #. type: Plain text
7948 #: build/C/man7/pthreads.7:827
7949 msgid ""
7950 "Only the main thread is permitted to make the process into a process group "
7951 "leader using B<setpgid>(2)  (fixed in kernel 2.6.16)."
7952 msgstr ""
7953
7954 #. type: Plain text
7955 #: build/C/man7/pthreads.7:833
7956 msgid ""
7957 "Threads have distinct alternate signal stack settings.  However, a new "
7958 "thread's alternate signal stack settings are copied from the thread that "
7959 "created it, so that the threads initially share an alternate signal stack "
7960 "(fixed in kernel 2.6.16)."
7961 msgstr ""
7962
7963 #. type: Plain text
7964 #: build/C/man7/pthreads.7:835
7965 msgid "Note the following further points about the NPTL implementation:"
7966 msgstr ""
7967
7968 #. type: Plain text
7969 #: build/C/man7/pthreads.7:849
7970 msgid ""
7971 "If the stack size soft resource limit (see the description of "
7972 "B<RLIMIT_STACK> in B<setrlimit>(2))  is set to a value other than "
7973 "I<unlimited>, then this value defines the default stack size for new "
7974 "threads.  To be effective, this limit must be set before the program is "
7975 "executed, perhaps using the I<ulimit -s> shell built-in command (I<limit "
7976 "stacksize> in the C shell)."
7977 msgstr ""
7978
7979 #. type: SS
7980 #: build/C/man7/pthreads.7:849
7981 #, no-wrap
7982 msgid "Determining the threading implementation"
7983 msgstr ""
7984
7985 #. type: Plain text
7986 #: build/C/man7/pthreads.7:854
7987 msgid ""
7988 "Since glibc 2.3.2, the B<getconf>(1)  command can be used to determine the "
7989 "system's threading implementation, for example:"
7990 msgstr ""
7991
7992 #. type: Plain text
7993 #: build/C/man7/pthreads.7:859
7994 #, no-wrap
7995 msgid ""
7996 "bash$ getconf GNU_LIBPTHREAD_VERSION\n"
7997 "NPTL 2.3.4\n"
7998 msgstr ""
7999
8000 #. type: Plain text
8001 #: build/C/man7/pthreads.7:864
8002 msgid ""
8003 "With older glibc versions, a command such as the following should be "
8004 "sufficient to determine the default threading implementation:"
8005 msgstr ""
8006
8007 #. type: Plain text
8008 #: build/C/man7/pthreads.7:870
8009 #, no-wrap
8010 msgid ""
8011 "bash$ $( ldd /bin/ls | grep libc.so | awk \\(aq{print $3}\\(aq ) | \\e\n"
8012 "                egrep -i \\(aqthreads|nptl\\(aq\n"
8013 "        Native POSIX Threads Library by Ulrich Drepper et al\n"
8014 msgstr ""
8015
8016 #. type: SS
8017 #: build/C/man7/pthreads.7:872
8018 #, no-wrap
8019 msgid "Selecting the threading implementation: LD_ASSUME_KERNEL"
8020 msgstr ""
8021
8022 #. type: Plain text
8023 #: build/C/man7/pthreads.7:887
8024 msgid ""
8025 "On systems with a glibc that supports both LinuxThreads and NPTL (i.e., "
8026 "glibc 2.3.I<x>), the B<LD_ASSUME_KERNEL> environment variable can be used to "
8027 "override the dynamic linker's default choice of threading implementation.  "
8028 "This variable tells the dynamic linker to assume that it is running on top "
8029 "of a particular kernel version.  By specifying a kernel version that does "
8030 "not provide the support required by NPTL, we can force the use of "
8031 "LinuxThreads.  (The most likely reason for doing this is to run a (broken) "
8032 "application that depends on some nonconformant behavior in LinuxThreads.)  "
8033 "For example:"
8034 msgstr ""
8035
8036 #. type: Plain text
8037 #: build/C/man7/pthreads.7:893
8038 #, no-wrap
8039 msgid ""
8040 "bash$ $( LD_ASSUME_KERNEL=2.2.5 ldd /bin/ls | grep libc.so | \\e\n"
8041 "                awk \\(aq{print $3}\\(aq ) | egrep -i "
8042 "\\(aqthreads|ntpl\\(aq\n"
8043 "        linuxthreads-0.10 by Xavier Leroy\n"
8044 msgstr ""
8045
8046 #. type: Plain text
8047 #: build/C/man7/pthreads.7:905
8048 msgid ""
8049 "B<clone>(2), B<futex>(2), B<gettid>(2), B<proc>(5), B<futex>(7), "
8050 "B<sigevent>(7), B<signal>(7),"
8051 msgstr ""
8052
8053 #. type: Plain text
8054 #: build/C/man7/pthreads.7:929
8055 msgid ""
8056 "Various Pthreads manual pages, for example: B<pthread_attr_init>(3), "
8057 "B<pthread_atfork>(3), B<pthread_cancel>(3), B<pthread_cleanup_push>(3), "
8058 "B<pthread_cond_signal>(3), B<pthread_cond_wait>(3), B<pthread_create>(3), "
8059 "B<pthread_detach>(3), B<pthread_equal>(3), B<pthread_exit>(3), "
8060 "B<pthread_key_create>(3), B<pthread_kill>(3), B<pthread_mutex_lock>(3), "
8061 "B<pthread_mutex_unlock>(3), B<pthread_once>(3), "
8062 "B<pthread_setcancelstate>(3), B<pthread_setcanceltype>(3), "
8063 "B<pthread_setspecific>(3), B<pthread_sigmask>(3), B<pthread_sigqueue>(3), "
8064 "and B<pthread_testcancel>(3)"
8065 msgstr ""