doc/html/ref/posix-thread-specific-data.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Thread-Specific Data [POSIX Section 17]</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="POSIX Standard Support"
  23 HREF="posix-standard-support.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Thread Management [POSIX Section 16]"
  26 HREF="posix-thread-management.html"><LINK
  27 REL="NEXT"
  28 TITLE="Thread Cancellation [POSIX Section 18]"
  29 HREF="posix-thread-cancellation.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="posix-thread-management.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 31. POSIX Standard Support</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="posix-thread-cancellation.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="POSIX-THREAD-SPECIFIC-DATA">Thread-Specific Data &#0091;POSIX Section 17&#0093;</H1
  86 ><DIV
  87 CLASS="SECT2"
  88 ><H2
  89 CLASS="SECT2"
  90 ><A
  91 NAME="AEN13287">Functions Implemented</H2
  92 ><TABLE
  93 BORDER="5"
  94 BGCOLOR="#E0E0F0"
  95 WIDTH="70%"
  96 ><TR
  97 ><TD
  98 ><PRE
  99 CLASS="SCREEN"
 100 >int pthread&#0095;key&#0095;create(pthread&#0095;key&#0095;t &#0042;key,
 101                        void (&#0042;destructor)(void &#0042;));
 102 int pthread&#0095;setspecific(pthread&#0095;key&#0095;t key, const void &#0042;pointer);
 103 void &#0042;pthread&#0095;getspecific(pthread&#0095;key&#0095;t key);
 104 int pthread&#0095;key&#0095;delete(pthread&#0095;key&#0095;t key);</PRE
 105 ></TD
 106 ></TR
 107 ></TABLE
 108 ></DIV
 109 ><DIV
 110 CLASS="SECT2"
 111 ><H2
 112 CLASS="SECT2"
 113 ><A
 114 NAME="AEN13290">Functions Omitted</H2
 115 ><P
 116 >&lt;none&gt;</P
 117 ></DIV
 118 ><DIV
 119 CLASS="SECT2"
 120 ><H2
 121 CLASS="SECT2"
 122 ><A
 123 NAME="AEN13293">Notes</H2
 124 ><P
 125 ></P
 126 ><UL
 127 ><LI
 128 ><P
 129 >    The value of PTHREAD&#0095;DESTRUCTOR&#0095;ITERATIONS is
 130     provided by the
 131     CYGNUM&#0095;POSIX&#0095;PTHREAD&#0095;DESTRUCTOR&#0095;ITERATIONS
 132     option. This controls the number of times that a key destructor
 133     will be called while the data item remains non-NULL.
 134     </P
 135 ></LI
 136 ><LI
 137 ><P
 138 >    The value of PTHREAD&#0095;KEYS&#0095;MAX is provided
 139     by the CYGNUM&#0095;POSIX&#0095;PTHREAD&#0095;KEYS&#0095;MAX
 140     option. This defines the maximum number of per-thread data items
 141     supported. The POSIX standard calls for this to be a minimum of
 142     128, which is rather large for an embedded system. The default
 143     value for this option is set to 128 for compatibility but it
 144     should be reduced to a more usable value.
 145     </P
 146 ></LI
 147 ></UL
 148 ></DIV
 149 ></DIV
 150 ><DIV
 151 CLASS="NAVFOOTER"
 152 ><HR
 153 ALIGN="LEFT"
 154 WIDTH="100%"><TABLE
 155 SUMMARY="Footer navigation table"
 156 WIDTH="100%"
 157 BORDER="0"
 158 CELLPADDING="0"
 159 CELLSPACING="0"
 160 ><TR
 161 ><TD
 162 WIDTH="33%"
 163 ALIGN="left"
 164 VALIGN="top"
 165 ><A
 166 HREF="posix-thread-management.html"
 167 ACCESSKEY="P"
 168 >Prev</A
 169 ></TD
 170 ><TD
 171 WIDTH="34%"
 172 ALIGN="center"
 173 VALIGN="top"
 174 ><A
 175 HREF="ecos-ref.html"
 176 ACCESSKEY="H"
 177 >Home</A
 178 ></TD
 179 ><TD
 180 WIDTH="33%"
 181 ALIGN="right"
 182 VALIGN="top"
 183 ><A
 184 HREF="posix-thread-cancellation.html"
 185 ACCESSKEY="N"
 186 >Next</A
 187 ></TD
 188 ></TR
 189 ><TR
 190 ><TD
 191 WIDTH="33%"
 192 ALIGN="left"
 193 VALIGN="top"
 194 >Thread Management &#0091;POSIX Section 16&#0093;</TD
 195 ><TD
 196 WIDTH="34%"
 197 ALIGN="center"
 198 VALIGN="top"
 199 ><A
 200 HREF="posix-standard-support.html"
 201 ACCESSKEY="U"
 202 >Up</A
 203 ></TD
 204 ><TD
 205 WIDTH="33%"
 206 ALIGN="right"
 207 VALIGN="top"
 208 >Thread Cancellation &#0091;POSIX Section 18&#0093;</TD
 209 ></TR
 210 ></TABLE
 211 ></DIV
 212 ></BODY
 213 ></HTML
 214 >