doc/html/ref/posix-thread-cancellation.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 Cancellation [POSIX Section 18]</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-Specific Data [POSIX Section 17]"
  26 HREF="posix-thread-specific-data.html"><LINK
  27 REL="NEXT"
  28 TITLE="Non-POSIX Functions"
  29 HREF="posix-non-posix-functions.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-specific-data.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-non-posix-functions.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-CANCELLATION">Thread Cancellation &#0091;POSIX Section 18&#0093;</H1
  86 ><DIV
  87 CLASS="SECT2"
  88 ><H2
  89 CLASS="SECT2"
  90 ><A
  91 NAME="AEN13302">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;cancel(pthread&#0095;t thread);
 101 int pthread&#0095;setcancelstate(int state, int &#0042;oldstate);
 102 int pthread&#0095;setcanceltype(int type, int &#0042;oldtype);
 103 void pthread&#0095;testcancel(void);
 104 void pthread&#0095;cleanup&#0095;push( void (&#0042;routine)(void &#0042;),
 105                            void &#0042;arg);
 106 void pthread&#0095;cleanup&#0095;pop( int execute);</PRE
 107 ></TD
 108 ></TR
 109 ></TABLE
 110 ></DIV
 111 ><DIV
 112 CLASS="SECT2"
 113 ><H2
 114 CLASS="SECT2"
 115 ><A
 116 NAME="AEN13305">Functions Omitted</H2
 117 ><P
 118 >&lt;none&gt;</P
 119 ></DIV
 120 ><DIV
 121 CLASS="SECT2"
 122 ><H2
 123 CLASS="SECT2"
 124 ><A
 125 NAME="AEN13308">Notes</H2
 126 ><P
 127 >Asynchronous cancellation is only partially implemented.  In
 128 particular, cancellation may occur in unexpected places in some
 129 functions. It is strongly recommended that only synchronous
 130 cancellation be used. </P
 131 ></DIV
 132 ></DIV
 133 ><DIV
 134 CLASS="NAVFOOTER"
 135 ><HR
 136 ALIGN="LEFT"
 137 WIDTH="100%"><TABLE
 138 SUMMARY="Footer navigation table"
 139 WIDTH="100%"
 140 BORDER="0"
 141 CELLPADDING="0"
 142 CELLSPACING="0"
 143 ><TR
 144 ><TD
 145 WIDTH="33%"
 146 ALIGN="left"
 147 VALIGN="top"
 148 ><A
 149 HREF="posix-thread-specific-data.html"
 150 ACCESSKEY="P"
 151 >Prev</A
 152 ></TD
 153 ><TD
 154 WIDTH="34%"
 155 ALIGN="center"
 156 VALIGN="top"
 157 ><A
 158 HREF="ecos-ref.html"
 159 ACCESSKEY="H"
 160 >Home</A
 161 ></TD
 162 ><TD
 163 WIDTH="33%"
 164 ALIGN="right"
 165 VALIGN="top"
 166 ><A
 167 HREF="posix-non-posix-functions.html"
 168 ACCESSKEY="N"
 169 >Next</A
 170 ></TD
 171 ></TR
 172 ><TR
 173 ><TD
 174 WIDTH="33%"
 175 ALIGN="left"
 176 VALIGN="top"
 177 >Thread-Specific Data &#0091;POSIX Section 17&#0093;</TD
 178 ><TD
 179 WIDTH="34%"
 180 ALIGN="center"
 181 VALIGN="top"
 182 ><A
 183 HREF="posix-standard-support.html"
 184 ACCESSKEY="U"
 185 >Up</A
 186 ></TD
 187 ><TD
 188 WIDTH="33%"
 189 ALIGN="right"
 190 VALIGN="top"
 191 >Non-POSIX Functions</TD
 192 ></TR
 193 ></TABLE
 194 ></DIV
 195 ></BODY
 196 ></HTML
 197 >