draft/man2/get_thread_area.2

   1 .\" Copyright (C) 2003 Free Software Foundation, Inc.
   2 .\" This file is distributed according to the GNU General Public License.
   3 .\" See the file COPYING in the top level source directory for details.
   4 .\"
   5 .\" Written by Kent Yoder.
   6 .\"
   7 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   8 .\"         all rights reserved.
   9 .\" Translated Tue Jul  8 03:28:55 JST 2003
  10 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  11 .\"
  12 .\"WORD:        Thread Local Storage    ¥¹¥ì¥Ã¥É¶É½êµ²±
  13 .\"
  14 .TH GET_THREAD_AREA 2 2008-11-27 "Linux" "Linux Programmer's Manual"
  15 .\"O .SH NAME
  16 .\"O get_thread_area \- Get a Thread Local Storage (TLS) area
  17 .SH Ì¾Á°
  18 get_thread_area \- ¥¹¥ì¥Ã¥É¶É½êµ²± (TLS) ÎÎ°è¤ò¼è¤ê½Ð¤¹
  19 .\"O .SH "SYNOPSIS"
  20 .SH ½ñ¼°
  21 .B #include <linux/unistd.h>
  22 .br
  23 .B #include <asm/ldt.h>
  24 .sp
  25 .BI "int get_thread_area(struct user_desc *" u_info );
  26 .\"O .SH "DESCRIPTION"
  27 .SH ÀâÌÀ
  28 .\"O .BR get_thread_area ()
  29 .\"O returns an entry in the current thread's Thread Local Storage (TLS) array.
  30 .\"O The index of the entry corresponds to the value
  31 .\"O of \fIu_info\->entry_number\fP, passed in by the user.
  32 .\"O If the value is in bounds,
  33 .\"O .BR get_thread_info ()
  34 .\"O copies the corresponding
  35 .\"O TLS entry into the area pointed to by \fIu_info\fP.
  36 .BR get_thread_area ()
  37 ¤Ï¡¢¥«¥ì¥ó¥È¡¦¥¹¥ì¥Ã¥É¤Î¥¹¥ì¥Ã¥É¶É½êµ²±
  38 (Thread Local Storage; TLS) ÇÛÎó¤ÎÃæ¤Î¥¨¥ó¥È¥ê¤òÊÖ¤¹¡£
  39 ¥¨¥ó¥È¥ê¤Î¥¤¥ó¥Ç¥Ã¥¯¥¹¤Ï¡¢¥æ¡¼¥¶¤«¤é°ú¤¿ô¤È¤·¤ÆÅÏ¤µ¤ì¤ë
  40 \fIu_info\->entry_number\fP ¤ÎÃÍ¤ËÂÐ±þ¤·¤Æ¤¤¤ë¡£
  41 ÃÍ¤¬ÈÏ°ÏÆâ¤Ë¤¢¤ë¾ì¹ç¡¢
  42 .BR get_thread_info ()
  43 ¤ÏÂÐ±þ¤¹¤ë TLS ¥¨¥ó¥È¥ê¤ò
  44 \fIu_info\fP ¤Ç»Ø¤µ¤ì¤¿ÎÎ°è¤Ë¥³¥Ô¡¼¤¹¤ë¡£
  45 .\"O .SH "RETURN VALUE"
  46 .SH ÊÖ¤êÃÍ
  47 .\"O .BR get_thread_area ()
  48 .\"O returns 0 on success.
  49 .\"O Otherwise, it returns \-1 and sets
  50 .\"O .I errno
  51 .\"O appropriately.
  52 À®¸ù¤·¤¿¾ì¹ç¡¢
  53 .BR get_thread_area ()
  54 ¤Ï 0 ¤òÊÖ¤¹¡£
  55 ¤½¤¦¤Ç¤Ê¤¤¾ì¹ç¡¢ \-1 ¤òÊÖ¤·¡¢
  56 .I errno
  57 ¤ËÅ¬ÀÚ¤ÊÃÍ¤ò¥»¥Ã¥È¤¹¤ë¡£
  58 .\"O .SH "ERRORS"
  59 .SH ¥¨¥é¡¼
  60 .TP
  61 .B EFAULT
  62 .\"O \fIu_info\fP is an invalid pointer.
  63 \fIu_info\fP ¤¬ÉÔÀµ¤Ê¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£
  64 .TP
  65 .B EINVAL
  66 .\"O \fIu_info\->entry_number\fP is out of bounds.
  67 \fIu_info\->entry_number\fP ¤¬ÈÏ°Ï³°¤Ç¤¢¤ë¡£
  68 .\"O .SH VERSIONS
  69 .SH ¥Ð¡¼¥¸¥ç¥ó
  70 .\"O A version of
  71 .\"O .BR get_thread_area ()
  72 .\"O first appeared in Linux 2.5.32.
  73 .BR get_thread_area ()
  74 ¤Ï Linux 2.5.32 ¤Ç½é¤á¤ÆÅÐ¾ì¤·¤¿¡£
  75 .\"O .SH "CONFORMING TO"
  76 .SH ½àµò
  77 .\"O .BR get_thread_area ()
  78 .\"O is Linux-specific and should not be used in programs
  79 .\"O that are intended to be portable.
  80 .BR get_thread_area ()
  81 ¤Ï Linux ÆÈ¼«¤Î´Ø¿ô¤Ç¤¢¤ê¡¢
  82 °Ü¿¢¤ò°Õ¿Þ¤·¤¿¥×¥í¥°¥é¥à¤Ç¤Ï»ÈÍÑ¤¹¤Ù¤¤Ç¤Ï¤Ê¤¤¡£
  83 .\"O .SH NOTES
  84 .SH Ãí°Õ
  85 .\"O Glibc does not provide a wrapper for this system call;
  86 .\"O call it using
  87 .\"O .BR syscall (2).
  88 glibc ¤Ï¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÂÐ¤¹¤ë¥é¥Ã¥Ñ¡¼´Ø¿ô¤òÄó¶¡¤·¤Æ¤¤¤Ê¤¤¡£
  89 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¸Æ¤Ó½Ð¤¹¤Ë¤Ï
  90 .BR syscall (2)
  91 ¤ò»È¤¦¤³¤È¡£
  92 .\"O .SH "SEE ALSO"
  93 .SH ´ØÏ¢¹àÌÜ
  94 .BR modify_ldt (2),
  95 .BR set_thread_area (2)