/usr/share/doc/libucommon-dev/a00208.html is in libucommon-doc 3.2.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>UCommon: ucommon/thread.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.3 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="main.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>ucommon/thread.h File Reference</h1>
<p>Thread classes and sychronization objects.
<a href="#_details">More...</a></p>
<code>#include <<a class="el" href="a00201_source.html">ucommon/platform.h</a>></code><br/>
<code>#include <<a class="el" href="a00185_source.html">ucommon/access.h</a>></code><br/>
<code>#include <<a class="el" href="a00209_source.html">ucommon/timers.h</a>></code><br/>
<code>#include <<a class="el" href="a00197_source.html">ucommon/memory.h</a>></code><br/>
<div class="dynheader">
Include dependency graph for thread.h:</div>
<div class="dynsection">
<div class="center"><img src="a00271.png" border="0" usemap="#ucommon_2thread_8h_map" alt=""/></div>
<map name="ucommon_2thread_8h_map" id="ucommon_2thread_8h">
<area shape="rect" id="node3" href="a00201.html" title="Various miscelanous platform specific headers and defines." alt="" coords="840,315,997,344"/><area shape="rect" id="node28" href="a00185.html" title="Locking classes for member function automatic operations." alt="" coords="357,237,504,267"/><area shape="rect" id="node48" href="a00209.html" title="Realtime timers and timer queues." alt="" coords="603,83,747,112"/><area shape="rect" id="node61" href="a00197.html" title="Private heaps, pools, and associations." alt="" coords="771,83,925,112"/><area shape="rect" id="node50" href="a00195.html" title="Linked objects, lists, templates, and containers." alt="" coords="772,160,911,189"/><area shape="rect" id="node53" href="a00199.html" title="A common object base class with auto-pointer support." alt="" coords="740,237,881,267"/></map>
</div>
<div class="dynheader">
This graph shows which files directly or indirectly include this file:</div>
<div class="dynsection">
<div class="center"><img src="a00272.png" border="0" usemap="#ucommon_2thread_8hdep_map" alt=""/></div>
<map name="ucommon_2thread_8hdep_map" id="ucommon_2thread_8hdep">
<area shape="rect" id="node3" href="a00187.html" title="This is the GNU telephonic audio library for the GNU uCommon C++ framework." alt="" coords="5,315,144,344"/><area shape="rect" id="node6" href="a00193.html" title="Thread-aware file system manipulation class." alt="" coords="237,83,365,112"/><area shape="rect" id="node15" href="a00210.html" title="Top level include file for the GNU uCommon C++ core library." alt="" coords="329,315,497,344"/><area shape="rect" id="node22" href="a00206.html" title="Any ucommon streaming classes that are built from std::streamio facilities and that..." alt="" coords="339,160,488,189"/><area shape="rect" id="node26" href="a00196.html" title="Support for memory mapped objects." alt="" coords="501,237,656,267"/><area shape="rect" id="node31" href="a00212.html" title="Basic array and reusable object factory heap support." alt="" coords="619,83,760,112"/><area shape="rect" id="node9" href="a00189.html" title="A common buffered I/O class is used to stream character data without need for stdlib..." alt="" coords="125,160,264,189"/><area shape="rect" id="node12" href="a00204.html" title="Generic shell parsing and application services." alt="" coords="137,237,268,267"/><area shape="rect" id="node17" href="a00202.html" title="This library holds the ucommon scripting engine code." alt="" coords="260,392,399,421"/><area shape="rect" id="node19" href="a00203.html" title="This library holds basic crytographic functions and secure socket support for use..." alt="" coords="423,392,569,421"/></map>
</div>
<p><a href="a00208_source.html">Go to the source code of this file.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00030.html">ucc::auto_protect</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A mutex locked object smart pointer helper class. <a href="a00030.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00032.html">ucc::barrier</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A portable implimentation of "barrier" thread sychronization. <a href="a00032.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00034.html">ucc::Buffer</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A thread-safe buffer for serializing and streaming class data. <a href="a00034.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00035.html">ucc::bufferof< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A templated typed class for buffering of objects. <a href="a00035.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00040.html">ucc::Conditional</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The conditional is a common base for other thread synchronizing classes. <a href="a00040.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00041.html">ucc::ConditionalAccess</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The conditional rw seperates scheduling for optizming behavior or rw locks. <a href="a00041.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00042.html">ucc::ConditionalLock</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">An optimized and convertable shared lock. <a href="a00042.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00049.html">ucc::DetachedThread</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A detached thread object that is stand-alone. <a href="a00049.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00058.html">ucc::JoinableThread</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A child thread object that may be joined by parent. <a href="a00058.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00071.html">ucc::locked_instance< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A templated smart pointer instance for lock protected objects. <a href="a00071.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00072.html">ucc::locked_pointer< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Templated locked pointer for referencing locked objects of specific type. <a href="a00072.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00073.html">ucc::locked_release</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Auto-pointer support class for locked objects. <a href="a00073.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00074.html">ucc::LockedPointer</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">An object pointer that uses mutex to assure thread-safe singleton use. <a href="a00074.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00086.html">ucc::mutex</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Generic non-recursive exclusive lock class. <a href="a00086.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00087.html">ucc::mutex::gaurd</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gaurd class to apply scope based mutex locking to objects. <a href="a00087.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00088.html">ucc::mutex_pointer< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Typed smart locked pointer class. <a href="a00088.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00109.html">ucc::queue</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Manage a thread-safe queue of objects through reference pointers. <a href="a00109.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00110.html">ucc::queueof< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A templated typed class for thread-safe queue of object pointers. <a href="a00110.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00112.html">ucc::ReusableAllocator</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Class for resource bound memory pools between threads. <a href="a00112.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00114.html">ucc::rexlock</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Portable recursive exclusive lock. <a href="a00114.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00115.html">ucc::rwlock</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A generic and portable implimentation of Read/Write locking. <a href="a00115.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00116.html">ucc::rwlock::gaurd_reader</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gaurd class to apply scope based access locking to objects. <a href="a00116.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00117.html">ucc::rwlock::gaurd_writer</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gaurd class to apply scope based exclusive locking to objects. <a href="a00117.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00132.html">ucc::semaphore</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A portable counting semaphore class. <a href="a00132.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00136.html">ucc::shared_instance< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A templated smart pointer instance for shared singleton typed objects. <a href="a00136.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00138.html">ucc::shared_pointer< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Templated shared pointer for singleton shared objects of specific type. <a href="a00138.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00139.html">ucc::shared_release</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Auto-pointer support class for shared singleton objects. <a href="a00139.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00140.html">ucc::SharedObject</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="a00135.html" title="An exclusive locking protocol interface base.">Shared</a> singleton object. <a href="a00140.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00141.html">ucc::SharedPointer</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The shared pointer is used to manage a singleton instance of shared object. <a href="a00141.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00155.html">ucc::stack</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Manage a thread-safe stack of objects through reference pointers. <a href="a00155.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00156.html">ucc::stackof< T ></a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A templated typed class for thread-safe stack of object pointers. <a href="a00156.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00166.html">ucc::Thread</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">An abstract class for defining classes that operate as a thread. <a href="a00166.html#_details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="a00168.html">ucc::TimedEvent</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Event notification to manage scheduled realtime threads. <a href="a00168.html#_details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2>Namespaces</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">namespace </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html">ucc</a></td></tr>
<p><tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Common namespace for all ucommon objects. </p>
<br/></td></tr>
</p>
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><b>ENTER_EXCLUSIVE</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a8952f3c34bdc70488c3176af1041104f"></a><!-- doxytag: member="thread.h::LEAVE_EXCLUSIVE" ref="a8952f3c34bdc70488c3176af1041104f" args="" -->
#define </td><td class="memItemRight" valign="bottom"><b>LEAVE_EXCLUSIVE</b> pthread_mutex_unlock(&__sync__);} while(0);</td></tr>
<tr><td colspan="2"><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a4dba2c7011bd293efa067298b792c856"></a><!-- doxytag: member="thread.h::accesslock_t" ref="a4dba2c7011bd293efa067298b792c856" args="" -->
typedef ConditionalAccess </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a4dba2c7011bd293efa067298b792c856">ucc::accesslock_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for scheduling access. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="abe594a4773fadb944829bf49f2923b32"></a><!-- doxytag: member="thread.h::barrier_t" ref="abe594a4773fadb944829bf49f2923b32" args="" -->
typedef barrier </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#abe594a4773fadb944829bf49f2923b32">ucc::barrier_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using thread barriers. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a162095e89e159ae6c5b2e393f1ab0d9e"></a><!-- doxytag: member="thread.h::condlock_t" ref="a162095e89e159ae6c5b2e393f1ab0d9e" args="" -->
typedef ConditionalLock </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a162095e89e159ae6c5b2e393f1ab0d9e">ucc::condlock_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using conditional locks. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a977375bd8010286297245e8afd94387f"></a><!-- doxytag: member="thread.h::fifo_t" ref="a977375bd8010286297245e8afd94387f" args="" -->
typedef queue </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a977375bd8010286297245e8afd94387f">ucc::fifo_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using thread-safe object fifo (queue). <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa44b45d6be929c62dfec7abf182b1500"></a><!-- doxytag: member="thread.h::Mutex" ref="aa44b45d6be929c62dfec7abf182b1500" args="" -->
typedef mutex </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#aa44b45d6be929c62dfec7abf182b1500">ucc::Mutex</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using exclusive mutex on systems which define "mutex" (solaris) already to avoid type confusion. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acd902aea7dfbb5ee63938d71fb32016a"></a><!-- doxytag: member="thread.h::mutex_t" ref="acd902aea7dfbb5ee63938d71fb32016a" args="" -->
typedef mutex </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#acd902aea7dfbb5ee63938d71fb32016a">ucc::mutex_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using exclusive mutex locks. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab5bc49b731794e82329972cbaa7201b2"></a><!-- doxytag: member="thread.h::rexlock_t" ref="ab5bc49b731794e82329972cbaa7201b2" args="" -->
typedef rexlock </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#ab5bc49b731794e82329972cbaa7201b2">ucc::rexlock_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using recursive exclusive locks. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab4852a3bcef9e36c1e6ded4e6393579a"></a><!-- doxytag: member="thread.h::rwlock_t" ref="ab4852a3bcef9e36c1e6ded4e6393579a" args="" -->
typedef rwlock </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#ab4852a3bcef9e36c1e6ded4e6393579a">ucc::rwlock_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using read/write locks. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7e4ed1f363077c0500a3c535d9e65505"></a><!-- doxytag: member="thread.h::semaphore_t" ref="a7e4ed1f363077c0500a3c535d9e65505" args="" -->
typedef semaphore </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a7e4ed1f363077c0500a3c535d9e65505">ucc::semaphore_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using counting semaphores. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6f2ceb9e4fddf29387cb639eeb790198"></a><!-- doxytag: member="thread.h::stack_t" ref="a6f2ceb9e4fddf29387cb639eeb790198" args="" -->
typedef stack </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a6f2ceb9e4fddf29387cb639eeb790198">ucc::stack_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using thread-safe object stacks. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6cd8b424e576c988a4d8af19510fa261"></a><!-- doxytag: member="thread.h::timedevent_t" ref="a6cd8b424e576c988a4d8af19510fa261" args="" -->
typedef TimedEvent </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a6cd8b424e576c988a4d8af19510fa261">ucc::timedevent_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience type for using timed events. <br/></td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a60d71d32eb6178eba56d0af5c3e763e9">ucc::access</a> (condlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function for shared access to a conditional lock. <a href="#a60d71d32eb6178eba56d0af5c3e763e9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a7234a724934e8756876c755084c53642">ucc::access</a> (accesslock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to shared read schedule conditional access. <a href="#a7234a724934e8756876c755084c53642"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a4ad966e53a1365b019692202af34e353">ucc::acquire</a> (mutex_t &mutex)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to acquire a mutex. <a href="#a4ad966e53a1365b019692202af34e353"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a50c03aabe0615bf7c278d57d78fced85">ucc::commit</a> (condlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to commit and release an exclusively locked conditional lock. <a href="#a50c03aabe0615bf7c278d57d78fced85"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a3209b5b6b32540b77d86a74f8eee58a9">ucc::commit</a> (accesslock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to commit an exclusive access lock. <a href="#a3209b5b6b32540b77d86a74f8eee58a9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a1617d41148acbdce311148585c8cd3c3">ucc::exclusive</a> (rwlock_t &lock, <a class="el" href="a00201.html#af412159e5cef839836a5e7b19ee75d1c">timeout_t</a> timeout=Timer::inf)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function for exclusive write access to a read/write lock. <a href="#a1617d41148acbdce311148585c8cd3c3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#ae2eb7f2e9a826ec2cafa18b072e080ee">ucc::exclusive</a> (condlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to exclusively lock shared conditional lock. <a href="#ae2eb7f2e9a826ec2cafa18b072e080ee"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#ad9b6d3c149c88c9ccd974ea52d71aee9">ucc::lock</a> (rexlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to lock a shared recursive mutex lock. <a href="#ad9b6d3c149c88c9ccd974ea52d71aee9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a12570b6a5b5e22baa931dfcf1880575d">ucc::modify</a> (condlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to exclusively aquire a conditional lock. <a href="#a12570b6a5b5e22baa931dfcf1880575d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#afbca012752e5f641c92e06645f0c06dc">ucc::modify</a> (accesslock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to exclusively schedule conditional access. <a href="#afbca012752e5f641c92e06645f0c06dc"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Object * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a30ede98ed10a116709158a7e2fb8d7be">ucc::pull</a> (fifo_t &fifo, <a class="el" href="a00201.html#af412159e5cef839836a5e7b19ee75d1c">timeout_t</a> timeout=Timer::inf)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to pull an object from a fifo. <a href="#a30ede98ed10a116709158a7e2fb8d7be"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Object * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a211aa5e16c312bf683d7dc1fe3fc4379">ucc::pull</a> (stack_t &stack, <a class="el" href="a00201.html#af412159e5cef839836a5e7b19ee75d1c">timeout_t</a> timeout=Timer::inf)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to pull an object from a stack. <a href="#a211aa5e16c312bf683d7dc1fe3fc4379"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a76919e8ecf147f1860f85f211a4a0f1a">ucc::push</a> (fifo_t &fifo, Object *object)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to push an object onto a fifo. <a href="#a76919e8ecf147f1860f85f211a4a0f1a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#ab446852e83e4377964e674e5a1bee082">ucc::push</a> (stack_t &stack, Object *object)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to push an object onto a stack. <a href="#ab446852e83e4377964e674e5a1bee082"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a5f8b2156fb5370b02142706ed0f886ce">ucc::release</a> (rexlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to release a shared recursive mutex lock. <a href="#a5f8b2156fb5370b02142706ed0f886ce"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a644ccd5401b431d846a3bb6a573fc17f">ucc::release</a> (rwlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to release a shared lock. <a href="#a644ccd5401b431d846a3bb6a573fc17f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a803685bd0fb1485f48e90c3bda34785f">ucc::release</a> (condlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to release shared access to a conditional lock. <a href="#a803685bd0fb1485f48e90c3bda34785f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a70b7605daf7a471c105832a2fcc91ff6">ucc::release</a> (accesslock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to release an access lock. <a href="#a70b7605daf7a471c105832a2fcc91ff6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a9dbb5718ac41e634f6ee834d670cbf15">ucc::release</a> (mutex_t &mutex)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to release a mutex. <a href="#a9dbb5718ac41e634f6ee834d670cbf15"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a1309e595528dfc88c7600c18ec070062">ucc::release</a> (semaphore_t &semaphore)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to release a semaphore. <a href="#a1309e595528dfc88c7600c18ec070062"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#ab706487a8728a23560650f7c20c3a6e8">ucc::remove</a> (fifo_t &fifo, Object *object)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to remove an object from a fifo. <a href="#ab706487a8728a23560650f7c20c3a6e8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a284595fb28be69136211845567e6eeec">ucc::remove</a> (stack_t &stack, Object *object)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to remove an object from a stack. <a href="#a284595fb28be69136211845567e6eeec"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a439333d599b1359a968a66826a5b4aa0">ucc::share</a> (rwlock_t &lock, <a class="el" href="a00201.html#af412159e5cef839836a5e7b19ee75d1c">timeout_t</a> timeout=Timer::inf)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function for shared read access to a read/write lock. <a href="#a439333d599b1359a968a66826a5b4aa0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a14fdb52b75a1d4336c9b962ba70aba75">ucc::share</a> (condlock_t &lock)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to restore shared access on a conditional lock. <a href="#a14fdb52b75a1d4336c9b962ba70aba75"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a436bda4e7f1c9f6d4fab744e1d5f623d">ucc::start</a> (DetachedThread *thread, int priority=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to start a detached thread. <a href="#a436bda4e7f1c9f6d4fab744e1d5f623d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a190c5597b1e578ec9c7b85e0b6705e48">ucc::start</a> (JoinableThread *thread, int priority=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to start a joinable thread. <a href="#a190c5597b1e578ec9c7b85e0b6705e48"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a9a03cfa0cc7feea8d0b3c40dff579c94">ucc::wait</a> (semaphore_t &semaphore, <a class="el" href="a00201.html#af412159e5cef839836a5e7b19ee75d1c">timeout_t</a> timeout=Timer::inf)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to wait on a semaphore. <a href="#a9a03cfa0cc7feea8d0b3c40dff579c94"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00214.html#a2f0fa9cbff7791a5006406a3066d4dc5">ucc::wait</a> (barrier_t &barrier)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convenience function to wait on a barrier. <a href="#a2f0fa9cbff7791a5006406a3066d4dc5"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Thread classes and sychronization objects. </p>
<p>The theory behind ucommon thread classes is that they would be used to create derived classes where thread-specific data can be stored as member data of the derived class. The run method is called when the context is executed. Since we use a pthread foundation, we support both detached threads and joinable threads. Objects based on detached threads should be created with new, and will automatically delete when the thread context exits. Joinable threads will be joined with deleted.</p>
<p>The theory behind ucommon sychronization objects is that all upper level sychronization objects can be formed directly from a mutex and conditional. This includes semaphores, barriers, rwlock, our own specialized conditional lock, resource-bound locking, and recurive exclusive locks. Using only conditionals means we are not dependent on platform specific pthread implimentations that may not impliment some of these, and hence improves portability and consistency. Given that our rwlocks are recursive access locks, one can safely create read/write threading pairs where the read threads need not worry about deadlocks and the writers need not either if they only write-lock one instance at a time to change state. </p>
<p>Definition in file <a class="el" href="a00208_source.html">thread.h</a>.</p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="ab3af63951c15aa174c0a64da351d7a0c"></a><!-- doxytag: member="thread.h::ENTER_EXCLUSIVE" ref="ab3af63951c15aa174c0a64da351d7a0c" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define ENTER_EXCLUSIVE</td>
</tr>
</table>
</div>
<div class="memdoc">
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">do</span> { <span class="keyword">static</span> pthread_mutex_t __sync__ = PTHREAD_MUTEX_INITIALIZER; \
pthread_mutex_lock(&__sync__);
</pre></div>
<p>Definition at line <a class="el" href="a00208_source.html#l02798">2798</a> of file <a class="el" href="a00208_source.html">thread.h</a>.</p>
</div>
</div>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Tue Jul 6 08:22:15 2010 for UCommon by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>
|