release/man2/set_thread_area.2

   1 .\" Copyright (C) 2003 Free Software Foundation, Inc.
   2 .\" Author: Kent Yoder
   3 .\"
   4 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   5 .\" This file is distributed according to the GNU General Public License.
   6 .\" %%%LICENSE_END
   7 .\"
   8 .\"*******************************************************************
   9 .\"
  10 .\" This file was generated with po4a. Translate the source file.
  11 .\"
  12 .\"*******************************************************************
  13 .TH SET_THREAD_AREA 2 2012\-07\-13 Linux "Linux Programmer's Manual"
  14 .SH 名前
  15 set_thread_area \- スレッド局所記憶 (TLS) 領域を設定する
  16 .SH 書式
  17 \fB#include <linux/unistd.h>\fP
  18 .br
  19 \fB#include <asm/ldt.h>\fP
  20 .sp
  21 \fBint set_thread_area(struct user_desc *\fP\fIu_info\fP\fB);\fP
  22
  23 \fI注\fP: このシステムコールには、glibc のラッパー関数が提供されていない。「注意」の節を参照。
  24 .SH 説明
  25 \fBset_thread_area\fP()  sets an entry in the current thread's thread\-local
  26 storage (TLS) array.  The TLS array entry set by \fBset_thread_area\fP()
  27 corresponds to the value of \fIu_info\->entry_number\fP passed in by the
  28 user.  If this value is in bounds, \fBset_thread_area\fP()  copies the TLS
  29 descriptor pointed to by \fIu_info\fP into the thread's TLS array.
  30 .PP
  31 \fIentry_number\fP として \-1 が渡された場合、 \fBset_thread_area\fP()  は未使用 (free) の TLS
  32 エントリを使用する。 未使用の TLS エントリがあった場合、どのエントリが変更されたかが分かる ように終了時に
  33 \fIu_info\->entry_number\fP の値が変更される。
  34 .SH 返り値
  35 \fBset_thread_area\fP()  は成功した場合 0 を返す。失敗した場合は \-1 を返し、 \fIerrno\fP を適切に設定する。
  36 .SH エラー
  37 .TP
  38 \fBEINVAL\fP
  39 \fIu_info\->entry_number\fP が範囲外である。
  40 .TP
  41 \fBEFAULT\fP
  42 \fIu_info\fP が不正なポインタである。
  43 .TP
  44 \fBESRCH\fP
  45 未使用の TLS エントリが見つからなかった。
  46 .SH バージョン
  47 \fBset_thread_area\fP()  は Linux 2.5.29 で初めて登場した。
  48 .SH 準拠
  49 \fBset_thread_area\fP()  は Linux 独自であり、移植を意図したプログラムでは使用すべきではない。
  50 .SH 注意
  51 Glibc does not provide a wrapper for this system call, since it is generally
  52 intended only for use by threading libraries.  In the unlikely event that
  53 you want to call it directly, use \fBsyscall\fP(2).
  54 .SH 関連項目
  55 \fBget_thread_area\fP(2)
  56 .SH この文書について
  57 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
  58 である。プロジェクトの説明とバグ報告に関する情報は
  59 http://www.kernel.org/doc/man\-pages/ に書かれている。