release/man7/pthreads.7

   1 .\" t
   2 .\" Copyright (c) 2005 by Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\"
   4 .\" %%%LICENSE_START(VERBATIM)
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one.
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\" %%%LICENSE_END
  25 .\"
  26 .\"*******************************************************************
  27 .\"
  28 .\" This file was generated with po4a. Translate the source file.
  29 .\"
  30 .\"*******************************************************************
  31 .TH PTHREADS 7 2010\-11\-14 Linux "Linux Programmer's Manual"
  32 .SH 名前
  33 pthreads \- POSIX スレッド
  34 .SH 説明
  35 POSIX.1 は、一般に POSIX スレッドや Pthreads として知られる スレッド・プログラミングのインタフェース群
  36 (関数、ヘッダファイル)  を規定している。一つのプロセスは複数のスレッドを持つことができ、 全てのスレッドは同じプログラムを実行する。
  37 これらのスレッドは同じ大域メモリ (データとヒープ領域) を共有するが、 各スレッドは自分専用のスタック (自動変数) を持つ。
  38
  39 POSIX.1 はスレッド間でどのような属性を共有するかについても定めている (つまり、これらの属性はスレッド単位ではなくプロセス全体で共通である):
  40 .IP \- 3
  41 プロセス ID
  42 .IP \- 3
  43 親プロセス ID
  44 .IP \- 3
  45 プロセスグループ ID とセッション ID
  46 .IP \- 3
  47 制御端末
  48 .IP \- 3
  49 ユーザ ID とグループ ID
  50 .IP \- 3
  51 オープンするファイルディスクリプタ
  52 .IP \- 3
  53 レコードのロック (\fBfcntl\fP(3)  参照)
  54 .IP \- 3
  55 シグナルの配置
  56 .IP \- 3
  57 ファイルモード作成マスク (\fBumask\fP(2))
  58 .IP \- 3
  59 カレント・ディレクトリ (\fBchdir\fP(2))  とルート・ディレクトリ (\fBchroot\fP(2))
  60 .IP \- 3
  61 インターバル・タイマ (\fBsetitimer\fP(2))  と POSIX タイマ (\fBtimer_create\fP(2))
  62 .IP \- 3
  63 nice 値 (\fBsetpriority\fP(2))
  64 .IP \- 3
  65 リソース制限 (\fBsetrlimit\fP(2))
  66 .IP \- 3
  67 CPU 時間 (\fBtimes\fP(2))  とリソース (\fBgetrusage\fP(2))  の消費状況の計測
  68 .PP
  69 スタックについても、POSIX.1 はどのような属性が 個々のスレッドで独立に管理されるかを規定している:
  70 .IP \- 3
  71 スレッド ID (\fBpthread_t\fP データ型)
  72 .IP \- 3
  73 シグナルマスク (\fBpthread_sigmask\fP(3))
  74 .IP \- 3
  75 \fIerrno\fP 変数
  76 .IP \- 3
  77 代替シグナルスタック (\fBsigaltstack\fP(2))
  78 .IP \- 3
  79 リアルタイム・スケジューリングのポリシーと優先度 (\fBsched_setscheduler\fP(2)  と \fBsched_setparam\fP(2))
  80 .PP
  81 以下の Linux 特有の機能もスレッド単位である:
  82 .IP \- 3
  83 ケーパビリティ (\fBcapabilities\fP(7)  参照)
  84 .IP \- 3
  85 CPU affinity (親和度)  (\fBsched_setaffinity\fP(2))
  86 .SS "pthreads 関数の返り値"
  87 ほとんどの pthreads 関数は成功すると 0 を返し、 失敗した場合エラー番号を返す。 pthreads 関数は \fIerrno\fP
  88 をセットしない点に注意すること。 POSIX.1\-2001 では、 エラーを返す可能性のある pthreads 関数がエラー \fBEINTR\fP
  89 で失敗することは決してないと規定している。
  90 .SS "スレッド ID"
  91 あるプロセス内の各スレッドは (\fIpthread_t\fP 型の) 一意なスレッド識別子を持つ。 この識別子は、 \fBpthread_create\fP(3)
  92 の呼び出し元に返される。また、スレッドは自身のスレッド識別子を \fBpthread_self\fP(3)  を使って取得できる。 スレッド ID
  93 の一意性が保証されるのは、一つのプロセス内においてのみである。 終了したスレッドが join された後では、スレッド ID は再利用される可能性がある。
  94 スレッド ID を引き数に取る全てのスレッド関数において、 その ID は呼び出し元と同じプロセス内の一つのスレッドを参照する。
  95 .SS スレッドセーフな関数
  96 スレッドセーフな関数は、複数のスレッドから同時に呼び出しても安全な (すなわち、同時に呼び出されたかに関わらず、同じ結果を返す) 関数のことである。
  97
  98 POSIX.1\-2001 と POSIX.1\-2008では、一部の例外を除き、 標準で規定されている全ての関数がスレッドセーフであることを要求している。
  99 以下の関数が例外である。
 100 .in +4n
 101 .nf
 102
 103 asctime()
 104 basename()
 105 catgets()
 106 crypt()
 107 ctermid() (NULL でない引き数を渡された場合)
 108 ctime()
 109 dbm_clearerr()
 110 dbm_close()
 111 dbm_delete()
 112 dbm_error()
 113 dbm_fetch()
 114 dbm_firstkey()
 115 dbm_nextkey()
 116 dbm_open()
 117 dbm_store()
 118 dirname()
 119 dlerror()
 120 drand48()
 121 ecvt() [POSIX.1\-2001 のみ (POSIX.1\-2008 で削除された)]
 122 encrypt()
 123 endgrent()
 124 endpwent()
 125 endutxent()
 126 fcvt() [POSIX.1\-2001 のみ (POSIX.1\-2008 で削除された)]
 127 ftw()
 128 gcvt() [POSIX.1\-2001 のみ (POSIX.1\-2008 で削除された)]
 129 getc_unlocked()
 130 getchar_unlocked()
 131 getdate()
 132 getenv()
 133 getgrent()
 134 getgrgid()
 135 getgrnam()
 136 gethostbyaddr() [POSIX.1\-2001 のみ (POSIX.1\-2008 で削除された)]
 137 gethostbyname() [POSIX.1\-2001 のみ (POSIX.1\-2008 で削除された)]
 138 gethostent()
 139 getlogin()
 140 getnetbyaddr()
 141 getnetbyname()
 142 getnetent()
 143 getopt()
 144 getprotobyname()
 145 getprotobynumber()
 146 getprotoent()
 147 getpwent()
 148 getpwnam()
 149 getpwuid()
 150 getservbyname()
 151 getservbyport()
 152 getservent()
 153 getutxent()
 154 getutxid()
 155 getutxline()
 156 gmtime()
 157 hcreate()
 158 hdestroy()
 159 hsearch()
 160 inet_ntoa()
 161 l64a()
 162 lgamma()
 163 lgammaf()
 164 lgammal()
 165 localeconv()
 166 localtime()
 167 lrand48()
 168 mrand48()
 169 nftw()
 170 nl_langinfo()
 171 ptsname()
 172 putc_unlocked()
 173 putchar_unlocked()
 174 putenv()
 175 pututxline()
 176 rand()
 177 readdir()
 178 setenv()
 179 setgrent()
 180 setkey()
 181 setpwent()
 182 setutxent()
 183 strerror()
 184 strsignal() [POSIX.1\-2008 で追加された]
 185 strtok()
 186 system() [POSIX.1\-2008 で追加された]
 187 tmpnam() (NULL でない引き数を渡された場合)
 188 ttyname()
 189 unsetenv()
 190 wcrtomb() (最後の引き数が NULL の場合)
 191 wcsrtombs() (最後の引き数が NULL の場合)
 192 wcstombs()
 193 wctomb()
 194 .fi
 195 .in
 196 .SS "async\-cancel\-safe 関数"
 197 async\-cancel\-safe 関数は、
 198 非同期キャンセル機能が有効になっているアプリケーションで
 199 安全に呼び出すことができる関数のことである
 200 (\fBpthread_setcancelstate\fP(3) を参照)。
 201
 202 以下の関数だけが、POSIX.1\-2001 と POSIX.1\-2008 で async\-cancel\-safe で
 203 なければならないとされている。
 204 .in +4n
 205 .nf
 206
 207 pthread_cancel()
 208 pthread_setcancelstate()
 209 pthread_setcanceltype()
 210 .fi
 211 .in
 212 .SS "取り消しポイント (cancellation points)"
 213 POSIX.1 の規定では、特定の関数は取り消しポイントでなければならず、 他の特定の関数は取り消しポイントであってもよいとされている。
 214 あるスレッドが取り消し可能で、その取り消し種別 (cancelability type)  が延期 (deferred)
 215 で、そのスレッドに対する取り消し要求が処理待ちの場合、 取り消しポイントである関数を呼び出した時点で、そのスレッドのキャンセルが 行われる。
 216
 217 POSIX.1\-2001 と POSIX.1\-2008 の両方、もしくはいずれか一方では、 以下の関数は、取り消しポイント (cancellation
 218 points) で あることが必須となっている。
 219
 220 .\" FIXME
 221 .\" Document the list of all functions that are cancellation points in glibc
 222 .in +4n
 223 .nf
 224 accept()
 225 aio_suspend()
 226 clock_nanosleep()
 227 close()
 228 connect()
 229 creat()
 230 fcntl() F_SETLKW
 231 fdatasync()
 232 fsync()
 233 getmsg()
 234 getpmsg()
 235 lockf() F_LOCK
 236 mq_receive()
 237 mq_send()
 238 mq_timedreceive()
 239 mq_timedsend()
 240 msgrcv()
 241 msgsnd()
 242 msync()
 243 nanosleep()
 244 open()
 245 openat() [POSIX.1\-2008 で追加された]
 246 pause()
 247 poll()
 248 pread()
 249 pselect()
 250 pthread_cond_timedwait()
 251 pthread_cond_wait()
 252 pthread_join()
 253 pthread_testcancel()
 254 putmsg()
 255 putpmsg()
 256 pwrite()
 257 read()
 258 readv()
 259 recv()
 260 recvfrom()
 261 recvmsg()
 262 select()
 263 sem_timedwait()
 264 sem_wait()
 265 send()
 266 sendmsg()
 267 sendto()
 268 sigpause() [POSIX.1\-2001 only (moves to "may" list in POSIX.1\-2008)]
 269 sigsuspend()
 270 sigtimedwait()
 271 sigwait()
 272 sigwaitinfo()
 273 sleep()
 274 system()
 275 tcdrain()
 276 usleep() [POSIX.1\-2001 のみ (POSIX.1\-2008 で削除された)]
 277 wait()
 278 waitid()
 279 waitpid()
 280 write()
 281 writev()
 282 .fi
 283 .in
 284
 285 POSIX.1\-2001 と POSIX.1\-2008 の両方、もしくはいずれか一方では、 以下の関数は、取り消しポイント (cancellation
 286 points) で あってもよいことになっている。
 287
 288 .in +4n
 289 .nf
 290 access()
 291 asctime()
 292 asctime_r()
 293 catclose()
 294 catgets()
 295 catopen()
 296 chmod() [POSIX.1\-2008 で追加された]
 297 chown() [POSIX.1\-2008 で追加された]
 298 closedir()
 299 closelog()
 300 ctermid()
 301 ctime()
 302 ctime_r()
 303 dbm_close()
 304 dbm_delete()
 305 dbm_fetch()
 306 dbm_nextkey()
 307 dbm_open()
 308 dbm_store()
 309 dlclose()
 310 dlopen()
 311 dprintf() [POSIX.1\-2008 で追加された]
 312 endgrent()
 313 endhostent()
 314 endnetent()
 315 endprotoent()
 316 endpwent()
 317 endservent()
 318 endutxent()
 319 faccessat() [POSIX.1\-2008 で追加された]
 320 fchmod() [POSIX.1\-2008 で追加された]
 321 fchmodat() [POSIX.1\-2008 で追加された]
 322 fchown() [POSIX.1\-2008 で追加された]
 323 fchownat() [POSIX.1\-2008 で追加された]
 324 fclose()
 325 fcntl() (cmd 引き数が何であっても)
 326 fflush()
 327 fgetc()
 328 fgetpos()
 329 fgets()
 330 fgetwc()
 331 fgetws()
 332 fmtmsg()
 333 fopen()
 334 fpathconf()
 335 fprintf()
 336 fputc()
 337 fputs()
 338 fputwc()
 339 fputws()
 340 fread()
 341 freopen()
 342 fscanf()
 343 fseek()
 344 fseeko()
 345 fsetpos()
 346 fstat()
 347 fstatat() [POSIX.1\-2008 で追加された]
 348 ftell()
 349 ftello()
 350 ftw()
 351 futimens() [POSIX.1\-2008 で追加された]
 352 fwprintf()
 353 fwrite()
 354 fwscanf()
 355 getaddrinfo()
 356 getc()
 357 getc_unlocked()
 358 getchar()
 359 getchar_unlocked()
 360 getcwd()
 361 getdate()
 362 getdelim() [POSIX.1\-2008 で追加された]
 363 getgrent()
 364 getgrgid()
 365 getgrgid_r()
 366 getgrnam()
 367 getgrnam_r()
 368 gethostbyaddr() [SUSv3 のみ (この関数は POSIX.1\-2008 で削除されている)]
 369 gethostbyname() [SUSv3 のみ (この関数は POSIX.1\-2008 で削除されている)]
 370 gethostent()
 371 gethostid()
 372 gethostname()
 373 getline() [POSIX.1\-2008 で追加された]
 374 getlogin()
 375 getlogin_r()
 376 getnameinfo()
 377 getnetbyaddr()
 378 getnetbyname()
 379 getnetent()
 380 getopt() (opterr が 0 以外の場合)
 381 getprotobyname()
 382 getprotobynumber()
 383 getprotoent()
 384 getpwent()
 385 getpwnam()
 386 getpwnam_r()
 387 getpwuid()
 388 getpwuid_r()
 389 gets()
 390 getservbyname()
 391 getservbyport()
 392 getservent()
 393 getutxent()
 394 getutxid()
 395 getutxline()
 396 getwc()
 397 getwchar()
 398 getwd() [SUSv3 のみ (この関数は POSIX.1\-2008 で削除されている)]
 399 glob()
 400 iconv_close()
 401 iconv_open()
 402 ioctl()
 403 link()
 404 linkat() [POSIX.1\-2008 で追加された]
 405 lio_listio() [POSIX.1\-2008 で追加された]
 406 localtime()
 407 localtime_r()
 408 lockf() [POSIX.1\-2008 で追加された]
 409 lseek()
 410 lstat()
 411 mkdir() [POSIX.1\-2008 で追加された]
 412 mkdirat() [POSIX.1\-2008 で追加された]
 413 mkdtemp() [POSIX.1\-2008 で追加された]
 414 mkfifo() [POSIX.1\-2008 で追加された]
 415 mkfifoat() [POSIX.1\-2008 で追加された]
 416 mknod() [POSIX.1\-2008 で追加された]
 417 mknodat() [POSIX.1\-2008 で追加された]
 418 mkstemp()
 419 mktime()
 420 nftw()
 421 opendir()
 422 openlog()
 423 pathconf()
 424 pclose()
 425 perror()
 426 popen()
 427 posix_fadvise()
 428 posix_fallocate()
 429 posix_madvise()
 430 posix_openpt()
 431 posix_spawn()
 432 posix_spawnp()
 433 posix_trace_clear()
 434 posix_trace_close()
 435 posix_trace_create()
 436 posix_trace_create_withlog()
 437 posix_trace_eventtypelist_getnext_id()
 438 posix_trace_eventtypelist_rewind()
 439 posix_trace_flush()
 440 posix_trace_get_attr()
 441 posix_trace_get_filter()
 442 posix_trace_get_status()
 443 posix_trace_getnext_event()
 444 posix_trace_open()
 445 posix_trace_rewind()
 446 posix_trace_set_filter()
 447 posix_trace_shutdown()
 448 posix_trace_timedgetnext_event()
 449 posix_typed_mem_open()
 450 printf()
 451 psiginfo() [POSIX.1\-2008 で追加された]
 452 psignal() [POSIX.1\-2008 で追加された]
 453 pthread_rwlock_rdlock()
 454 pthread_rwlock_timedrdlock()
 455 pthread_rwlock_timedwrlock()
 456 pthread_rwlock_wrlock()
 457 putc()
 458 putc_unlocked()
 459 putchar()
 460 putchar_unlocked()
 461 puts()
 462 pututxline()
 463 putwc()
 464 putwchar()
 465 readdir()
 466 readdir_r()
 467 readlink() [POSIX.1\-2008 で追加された]
 468 readlinkat() [POSIX.1\-2008 で追加された]
 469 remove()
 470 rename()
 471 renameat() [POSIX.1\-2008 で追加された]
 472 rewind()
 473 rewinddir()
 474 scandir() [POSIX.1\-2008 で追加された]
 475 scanf()
 476 seekdir()
 477 semop()
 478 setgrent()
 479 sethostent()
 480 setnetent()
 481 setprotoent()
 482 setpwent()
 483 setservent()
 484 setutxent()
 485 sigpause() [POSIX.1\-2008 で追加された]
 486 stat()
 487 strerror()
 488 strerror_r()
 489 strftime()
 490 symlink()
 491 symlinkat() [POSIX.1\-2008 で追加された]
 492 sync()
 493 syslog()
 494 tmpfile()
 495 tmpnam()
 496 ttyname()
 497 ttyname_r()
 498 tzset()
 499 ungetc()
 500 ungetwc()
 501 unlink()
 502 unlinkat() [POSIX.1\-2008 で追加された]
 503 utime() [POSIX.1\-2008 で追加された]
 504 utimensat() [POSIX.1\-2008 で追加された]
 505 utimes() [POSIX.1\-2008 で追加された]
 506 vdprintf() [POSIX.1\-2008 で追加された]
 507 vfprintf()
 508 vfwprintf()
 509 vprintf()
 510 vwprintf()
 511 wcsftime()
 512 wordexp()
 513 wprintf()
 514 wscanf()
 515 .fi
 516 .in
 517
 518 .\" So, scanning "cancellation point" comments in the glibc 2.8 header
 519 .\" files, it looks as though at least the following nonstandard
 520 .\" functions are cancellation points:
 521 .\" endnetgrent
 522 .\" endspent
 523 .\" epoll_pwait
 524 .\" epoll_wait
 525 .\" fcloseall
 526 .\" fdopendir
 527 .\" fflush_unlocked
 528 .\" fgetc_unlocked
 529 .\" fgetgrent
 530 .\" fgetgrent_r
 531 .\" fgetpwent
 532 .\" fgetpwent_r
 533 .\" fgets_unlocked
 534 .\" fgetspent
 535 .\" fgetspent_r
 536 .\" fgetwc_unlocked
 537 .\" fgetws_unlocked
 538 .\" fputc_unlocked
 539 .\" fputs_unlocked
 540 .\" fputwc_unlocked
 541 .\" fputws_unlocked
 542 .\" fread_unlocked
 543 .\" fwrite_unlocked
 544 .\" gai_suspend
 545 .\" getaddrinfo_a
 546 .\" getdate_r
 547 .\" getgrent_r
 548 .\" getgrouplist
 549 .\" gethostbyaddr_r
 550 .\" gethostbyname2
 551 .\" gethostbyname2_r
 552 .\" gethostbyname_r
 553 .\" gethostent_r
 554 .\" getnetbyaddr_r
 555 .\" getnetbyname_r
 556 .\" getnetent_r
 557 .\" getnetgrent
 558 .\" getnetgrent_r
 559 .\" getprotobyname_r
 560 .\" getprotobynumber_r
 561 .\" getprotoent_r
 562 .\" getpw
 563 .\" getpwent_r
 564 .\" getservbyname_r
 565 .\" getservbyport_r
 566 .\" getservent_r
 567 .\" getspent
 568 .\" getspent_r
 569 .\" getspnam
 570 .\" getspnam_r
 571 .\" getutmp
 572 .\" getutmpx
 573 .\" getw
 574 .\" getwc_unlocked
 575 .\" getwchar_unlocked
 576 .\" initgroups
 577 .\" innetgr
 578 .\" mkostemp
 579 .\" mkostemp64
 580 .\" mkstemp64
 581 .\" ppoll
 582 .\" pthread_timedjoin_np
 583 .\" putgrent
 584 .\" putpwent
 585 .\" putspent
 586 .\" putw
 587 .\" putwc_unlocked
 588 .\" putwchar_unlocked
 589 .\" rcmd
 590 .\" rcmd_af
 591 .\" rexec
 592 .\" rexec_af
 593 .\" rresvport
 594 .\" rresvport_af
 595 .\" ruserok
 596 .\" ruserok_af
 597 .\" setnetgrent
 598 .\" setspent
 599 .\" sgetspent
 600 .\" sgetspent_r
 601 .\" updwtmpx
 602 .\" utmpxname
 603 .\" vfscanf
 604 .\" vfwscanf
 605 .\" vscanf
 606 .\" vsyslog
 607 .\" vwscanf
 608 実装時に、標準規格で規定されていないその他の関数を取り消しポイント とすることも認められている。 特に、停止 (block)
 609 する可能性がある非標準の関数を取り消しポイントと する実装はあり得ることだろう (ファイルを扱う可能性のあるほとんどの関数がこれに含まれる)。
 610 .SS "Linux でのコンパイル"
 611 Linux では、Pthreads API を用いたプログラムは \fIcc \-pthread\fP でコンパイルすべきである。
 612 .SS "POSIX スレッドの Linux での実装"
 613 これまで、2つのスレッドの実装が Linux の GNU C ライブラリにより 提供されてきた。
 614 .TP
 615 \fBLinuxThreads\fP
 616 最初の Pthreads の実装。
 617 glibc 2.4 以降は、この実装はもはやサポートされていない。
 618 .TP
 619 \fBNPTL\fP (Native POSIX Threads Library)
 620 新しい Pthreads の実装。LinuxThreads と比べると、 NPTL は POSIX.1 の要求仕様への準拠の度合いが高く、
 621 多数のスレッドを作成した際の性能も高い。 NPTL は glibc 2.3.2 以降で利用可能である。 NPTL を利用するには Linux 2.6
 622 カーネルに実装されている機能が必要である。
 623 .PP
 624 どちらの実装もいわゆる 1:1 実装、すなわち個々のスレッドが カーネルのスケジューリング実体にマッピングされる。 どちらのスレッドの実装も Linux
 625 の \fBclone\fP(2)  システムコールを利用している。 NPTL では、スレッド同期の基本機構 (mutex や スレッドの join 等) は
 626 Linux の \fBfutex\fP(2)  システムコールを使って実装されている。
 627 .SS LinuxThreads
 628 この実装の大きな特徴は以下の通りである:
 629 .IP \- 3
 630 メインスレッド (最初のスレッド) とプログラムが \fBpthread_create\fP(3)  を使って作成したスレッドに加え、 この実装では「管理
 631 (manager)」スレッドが作成される。 管理スレッドはスレッドの作成と終了を取り扱う (このスレッドがうっかり kill
 632 されると、問題が起こることがある)。
 633 .IP \- 3
 634 この実装では内部でシグナルを使用している。 Linux 2.2 以降では、リアルタイムシグナルのうち最初の 3つが使われる (\fBsignal\fP(7)
 635 参照)。 それ以前のカーネルでは \fBSIGUSR1\fP と \fBSIGUSR2\fP が使われる。
 636 アプリケーションは、スレッド実装で利用されているシグナルを どれも使わないようにしなければならない。
 637 .IP \- 3
 638 スレッド間でプロセス ID を共有しない (実際には LinuxThreads のスレッドは通常よりは情報を共有するプロセスとして
 639 実装されているが、一つの共通のプロセス ID を共有してはいない)。 (管理スレッドを含む) LinuxThreads スレッドは \fBps\fP(1)
 640 を使うと別のプロセスのように見える。
 641 .PP
 642 LinuxThreads の実装では POSIX.1 仕様から逸脱している点が いくつかある。以下に示すような点がある:
 643 .IP \- 3
 644 \fBgetpid\fP(2)  を呼び出したときに、スレッド毎に異なる値が返される。
 645 .IP \- 3
 646 メインスレッド以外のスレッドで \fBgetppid\fP(2)  を呼び出すと、管理スレッドのプロセス ID が返される。 本当は、これらのスレッドで
 647 \fBgetppid\fP(2)  を呼んだ場合にはメインスレッドでの \fBgetppid\fP(2)  と同じ値が返るべきである。
 648 .IP \- 3
 649 あるスレッドが \fBfork\fP(2)  を使って新しい子プロセスを作成した場合、 どのスレッドでもこの子プロセスを \fBwait\fP(2)
 650 できるべきである。しかしながら、この実装では子プロセスを作成した スレッドだけがこの子プロセスを \fBwait\fP(2)  できる。
 651 .IP \- 3
 652 あるスレッドが \fBexecve\fP(2)  を呼び出した場合、他のスレッドは全て終了される (POSIX.1 の仕様通り)。
 653 しかしながら、新しいプロセスは \fBexecve\fP(2)  を呼んだスレッドと同じ PID を持つ。正しくは メインスレッドと同じ PID
 654 を持つべきである。
 655 .IP \- 3
 656 スレッド間でユーザ ID とグループ ID が共有されない このことは、set\-user\-ID プログラムで面倒な事態を招いたり、 アプリケーションが
 657 \fBseteuid\fP(2)  などを使って信用情報 (credentials) を変更した場合に Pthreads 関数が失敗する原因となる。
 658 .IP \- 3
 659 スレッド間で共通のセッション ID やプロセスグループ ID を共有しない。
 660 .IP \- 3
 661 スレッド間で \fBfcntl\fP(2)  を使って作成されるレコード・ロックを共有しない。
 662 .IP \- 3
 663 \fBtimes\fP(2)  と \fBgetrusage\fP(2)  が返す情報がプロセス全体の情報でなくスレッド単位の情報である。
 664 .IP \- 3
 665 スレッド間でセマフォのアンドゥ値 (\fBsemop\fP(2)  参照) を共有しない。
 666 .IP \- 3
 667 スレッド間でインターバル・タイマを共有しない。
 668 .IP \- 3
 669 スレッドは共通の nice 値を共有しない。
 670 .IP \- 3
 671 POSXI.1 では、全体としてのプロセスに送られるシグナルと、 個別のスレッドに送られるシグナルを区別して考えている。 POSIX.1
 672 によると、プロセスに送られたシグナル (例えば \fBkill\fP(2)  を使って送る) は、そのプロセスに属すスレッドのうち 勝手に
 673 (arbitrarily) に選択された一つのスレッドにより処理される ことになっている。LinuxThreads はプロセスに送られるシグナルの
 674 概念に対応しておらず、シグナルは特定のスレッドにだけ送ることができる。
 675 .IP \- 3
 676 スレッドはそれぞれの独自の代替シグナルスタックの設定を持つ。 しかし、新しいスレッドの代替シグナルスタックの設定は
 677 そのスレッドを作成したスレッドからコピーされ、そのため スレッドは最初は一つの代替シグナルスタックを共有する。
 678 (仕様では、新しいスレッドは代替シグナルスタックが定義されていない状態 で開始されるべきとされている。
 679 2つのスレッドが共有されている代替シグナルスタック上で同時に シグナルの処理を行った場合、予測不可能なプログラムのエラーが 起こり得る。)
 680 .SS NPTL
 681 NPTL では、一つのプロセスの全てのスレッドは同じスレッド・グループ に属する; スレッド・グループの全メンバーは同じ PID を共有する。 NPTL
 682 は管理スレッド (manager thread) を利用しない。 NPTL は内部でリアルタイムシグナルのうち最初の 2つの番号を使用しており
 683 (\fBsignal\fP(7)  参照)、これらのシグナルはアプリケーションでは使用できない。
 684
 685 NPTL にも POSIX.1 に準拠していない点が少なくとも一つある:
 686 .IP \- 3
 687 .\" FIXME . bug report filed for NPTL nice nonconformance
 688 .\" http://bugzilla.kernel.org/show_bug.cgi?id=6258
 689 .\" Sep 08: there is a patch by Denys Vlasenko to address this
 690 .\" "make setpriority POSIX compliant; introduce PRIO_THREAD extension"
 691 .\" Monitor this to see if it makes it into mainline.
 692 スレッドは共通の nice 値を共有しない。
 693 .PP
 694 NPTL の標準非準拠な点のうちいくつかは以前のカーネルでのみ発生する:
 695 .IP \- 3
 696 \fBtimes\fP(2)  と \fBgetrusage\fP(2)  が返す情報がプロセス全体の情報でなくスレッド単位の情報である (カーネル 2.6.9
 697 で修正された)。
 698 .IP \- 3
 699 スレッド間でリソース制限を共有しない (カーネル 2.6.10 で修正された)。
 700 .IP \- 3
 701 スレッド間でインターバル・タイマを共有しない (カーネル 2.6.12 で修正された)。
 702 .IP \- 3
 703 メインスレッドだけが \fBsetsid\fP(2)  を使って新しいセッションを開始することができる (カーネル 2.6.16 で修正された)。
 704 .IP \- 3
 705 メインスレッドだけが \fBsetpgid\fP(2)  を使ってそのプロセスをプロセス・グループ・リーダーにすることができる (カーネル 2.6.16
 706 で修正された)。
 707 .IP \- 3
 708 スレッドはそれぞれの独自の代替シグナルスタックの設定を持つ。 しかし、新しいスレッドの代替シグナルスタックの設定は
 709 そのスレッドを作成したスレッドからコピーされ、そのため スレッドは最初は一つの代替シグナルスタックを共有する (カーネル 2.6.16 で修正された)。
 710 .PP
 711 NPTL の実装では以下の点についても注意すること:
 712 .IP \- 3
 713 スタックサイズのリソースのソフト・リミット (\fBsetrlimit\fP(2)  の \fBRLIMIT_STACK\fP の説明を参照) が
 714 \fIunlimited\fP 以外の値に設定されている場合、ソフト・リミットの値が 新しいスレッドのデフォルトのスタックサイズとなる。
 715 設定を有効にするためには、プログラムを実行する前にリミット値を 設定しておかなければならない。たいていは、シェルの組み込みコマンドの \fIulimit
 716 \-s\fP (C シェルでは \fIlimit stacksize\fP)  を使って設定する。
 717 .SS スレッド実装の判定
 718 glibc 2.3.2 以降では、 \fBgetconf\fP(1)  コマンドを使って、 システムのスレッド実装を判定することができる。 以下に例を示す:
 719 .nf
 720 .in +4n
 721
 722 bash$ getconf GNU_LIBPTHREAD_VERSION
 723 NPTL 2.3.4
 724 .in
 725 .fi
 726 .PP
 727 ぞれ以前の glibc のバージョンでは、以下のようなコマンドで デフォルトのスレッド実装を判定することができる。
 728 .nf
 729 .in +4n
 730
 731 bash$ $( ldd /bin/ls | grep libc.so | awk \(aq{print $3}\(aq ) | \e
 732                 egrep \-i \(aqthreads|ntpl\(aq
 733         Native POSIX Threads Library by Ulrich Drepper et al
 734 .in
 735 .fi
 736 .SS "スレッドの実装の選択: LD_ASSUME_KERNEL"
 737 LinuxThreads と NPTL の両方をサポートしている glibc (glibc 2.3.\fIx\fP) があるシステムでは、
 738 \fBLD_ASSUME_KERNEL\fP 環境変数を使うことで、動的リンカがデフォルトで 選択するスレッド実装を上書きすることができる。
 739 この変数により、動的リンカが特定のバージョンのカーネル上で 動作していると仮定するように指定する。 NPTL
 740 が必要とするサポート機能を提供していないカーネルバージョンを 指定することで、強制的に LinuxThreads を使うことができる
 741 (このようなことをする最もありそうな場面は、 LinuxThreads の標準非準拠な振舞いに依存する (壊れた) アプリケーション
 742 を動作させる場合だろう)。 以下に例を示す:
 743 .nf
 744 .in +4n
 745
 746 bash$ $( LD_ASSUME_KERNEL=2.2.5 ldd /bin/ls | grep libc.so | \e
 747                 awk \(aq{print $3}\(aq ) | egrep \-i \(aqthreads|ntpl\(aq
 748         linuxthreads\-0.10 by Xavier Leroy
 749 .in
 750 .fi
 751 .SH 関連項目
 752 .ad l
 753 .nh
 754 \fBclone\fP(2), \fBfutex\fP(2), \fBgettid\fP(2), \fBfutex\fP(7), \fBsigevent\fP(7),
 755 \fBsignal\fP(7),
 756
 757 pthreads の各種マニュアルページ、例えば: \fBpthread_attr_init\fP(3),
 758 \fBpthread_atfork\fP(3), \fBpthread_cancel\fP(3), \fBpthread_cleanup_push\fP(3),
 759 \fBpthread_cond_signal\fP(3), \fBpthread_cond_wait\fP(3), \fBpthread_create\fP(3),
 760 \fBpthread_detach\fP(3), \fBpthread_equal\fP(3), \fBpthread_exit\fP(3),
 761 \fBpthread_key_create\fP(3), \fBpthread_kill\fP(3), \fBpthread_mutex_lock\fP(3),
 762 \fBpthread_mutex_unlock\fP(3), \fBpthread_once\fP(3),
 763 \fBpthread_setcancelstate\fP(3), \fBpthread_setcanceltype\fP(3),
 764 \fBpthread_setspecific\fP(3), \fBpthread_sigmask\fP(3), \fBpthread_sigqueue\fP(3),
 765 and \fBpthread_testcancel\fP(3)
 766 .SH この文書について
 767 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 768 である。プロジェクトの説明とバグ報告に関する情報は
 769 http://www.kernel.org/doc/man\-pages/ に書かれている。