Submit
Path:
~
/
/
proc
/
self
/
root
/
proc
/
self
/
root
/
opt
/
alt
/
libxml2
/
usr
/
share
/
gtk-doc
/
html
/
libxml2
/
File Content:
libxml2-threads.html
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>threads: interfaces for thread handling</title> <meta name="generator" content="Libxml2 devhelp stylesheet"> <link rel="start" href="index.html" title="libxml2 Reference Manual"> <link rel="up" href="general.html" title="API"> <link rel="stylesheet" href="style.css" type="text/css"> <link rel="chapter" href="general.html" title="API"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> <td><a accesskey="p" href="libxml2-schematron.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> <td><a accesskey="u" href="general.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> <td><a accesskey="n" href="libxml2-tree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> <th width="100%" align="center">libxml2 Reference Manual</th> </tr></table> <h2><span class="refentrytitle">threads</span></h2> <p>threads - interfaces for thread handling</p> <p>set of generic threading related routines should work with pthreads, Windows native or TLS threads </p> <p>Author(s): Daniel Veillard </p> <div class="refsynopsisdiv"> <h2>Synopsis</h2> <pre class="synopsis">typedef struct _xmlMutex <a href="#xmlMutex">xmlMutex</a>; typedef <a href="libxml2-threads.html#xmlMutex">xmlMutex</a> * <a href="#xmlMutexPtr">xmlMutexPtr</a>; typedef struct _xmlRMutex <a href="#xmlRMutex">xmlRMutex</a>; typedef <a href="libxml2-threads.html#xmlRMutex">xmlRMutex</a> * <a href="#xmlRMutexPtr">xmlRMutexPtr</a>; void <a href="#xmlCleanupThreads">xmlCleanupThreads</a> (void); int <a href="#xmlDllMain">xmlDllMain</a> (void * hinstDLL, <br> unsigned long fdwReason, <br> void * lpvReserved); void <a href="#xmlFreeMutex">xmlFreeMutex</a> (<a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok); void <a href="#xmlFreeRMutex">xmlFreeRMutex</a> (<a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok); <a href="libxml2-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a> <a href="#xmlGetGlobalState">xmlGetGlobalState</a> (void); int <a href="#xmlGetThreadId">xmlGetThreadId</a> (void); void <a href="#xmlInitThreads">xmlInitThreads</a> (void); int <a href="#xmlIsMainThread">xmlIsMainThread</a> (void); void <a href="#xmlLockLibrary">xmlLockLibrary</a> (void); void <a href="#xmlMutexLock">xmlMutexLock</a> (<a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok); void <a href="#xmlMutexUnlock">xmlMutexUnlock</a> (<a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok); <a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> <a href="#xmlNewMutex">xmlNewMutex</a> (void); <a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> <a href="#xmlNewRMutex">xmlNewRMutex</a> (void); void <a href="#xmlRMutexLock">xmlRMutexLock</a> (<a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok); void <a href="#xmlRMutexUnlock">xmlRMutexUnlock</a> (<a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok); void <a href="#xmlUnlockLibrary">xmlUnlockLibrary</a> (void); </pre> </div> <div class="refsect1" lang="en"><h2>Description</h2></div> <div class="refsect1" lang="en"> <h2>Details</h2> <div class="refsect2" lang="en"> <div class="refsect2" lang="en"> <h3> <a name="xmlMutex">Structure </a>xmlMutex</h3> <pre class="programlisting">struct _xmlMutex { The content of this structure is not made public by the API. } xmlMutex; </pre> <p></p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlMutexPtr">Typedef </a>xmlMutexPtr</h3> <pre class="programlisting"><a href="libxml2-threads.html#xmlMutex">xmlMutex</a> * xmlMutexPtr; </pre> <p></p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlRMutex">Structure </a>xmlRMutex</h3> <pre class="programlisting">struct _xmlRMutex { The content of this structure is not made public by the API. } xmlRMutex; </pre> <p></p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlRMutexPtr">Typedef </a>xmlRMutexPtr</h3> <pre class="programlisting"><a href="libxml2-threads.html#xmlRMutex">xmlRMutex</a> * xmlRMutexPtr; </pre> <p></p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlCleanupThreads"></a>xmlCleanupThreads ()</h3> <pre class="programlisting">void xmlCleanupThreads (void)<br> </pre> <p>DEPRECATED: This function will be made private. Call <a href="libxml2-parser.html#xmlCleanupParser">xmlCleanupParser</a> to free global state but see the warnings there. <a href="libxml2-parser.html#xmlCleanupParser">xmlCleanupParser</a> should be only called once at program exit. In most cases, you don't have call cleanup functions at all. xmlCleanupThreads() is used to to cleanup all the thread related data of the libxml2 library once processing has ended. WARNING: if your application is multithreaded or has plugin support calling this may crash the application if another thread or a plugin is still using libxml2. It's sometimes very hard to guess if libxml2 is in use in the application, some libraries or plugins may use it without notice. In case of doubt abstain from calling this function or do it just before calling exit() to avoid leak reports from valgrind !</p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDllMain"></a>xmlDllMain ()</h3> <pre class="programlisting">int xmlDllMain (void * hinstDLL, <br> unsigned long fdwReason, <br> void * lpvReserved)<br> </pre> <p></p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>hinstDLL</tt></i>:</span></td> <td></td> </tr> <tr> <td><span class="term"><i><tt>fdwReason</tt></i>:</span></td> <td></td> </tr> <tr> <td><span class="term"><i><tt>lpvReserved</tt></i>:</span></td> <td></td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td></td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlFreeMutex"></a>xmlFreeMutex ()</h3> <pre class="programlisting">void xmlFreeMutex (<a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok)<br> </pre> <p>xmlFreeMutex() is used to reclaim resources associated with a libxml2 token struct.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>tok</tt></i>:</span></td> <td>the simple mutex</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlFreeRMutex"></a>xmlFreeRMutex ()</h3> <pre class="programlisting">void xmlFreeRMutex (<a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok)<br> </pre> <p>xmlRFreeMutex() is used to reclaim resources associated with a reentrant mutex.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>tok</tt></i>:</span></td> <td>the reentrant mutex</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlGetGlobalState"></a>xmlGetGlobalState ()</h3> <pre class="programlisting"><a href="libxml2-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a> xmlGetGlobalState (void)<br> </pre> <p>xmlGetGlobalState() is called to retrieve the global state for a thread.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the thread global state or NULL in case of error</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlGetThreadId"></a>xmlGetThreadId ()</h3> <pre class="programlisting">int xmlGetThreadId (void)<br> </pre> <p>xmlGetThreadId() find the current thread ID number Note that this is likely to be broken on some platforms using pthreads as the specification doesn't mandate pthread_t to be an integer type</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the current thread ID number</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlInitThreads"></a>xmlInitThreads ()</h3> <pre class="programlisting">void xmlInitThreads (void)<br> </pre> <p>DEPRECATED: This function will be made private. Call <a href="libxml2-parser.html#xmlInitParser">xmlInitParser</a> to initialize the library. xmlInitThreads() is used to to initialize all the thread related data of the libxml2 library.</p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlIsMainThread"></a>xmlIsMainThread ()</h3> <pre class="programlisting">int xmlIsMainThread (void)<br> </pre> <p>xmlIsMainThread() check whether the current thread is the main thread.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>1 if the current thread is the main thread, 0 otherwise</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlLockLibrary"></a>xmlLockLibrary ()</h3> <pre class="programlisting">void xmlLockLibrary (void)<br> </pre> <p>xmlLockLibrary() is used to take out a re-entrant lock on the libxml2 library.</p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlMutexLock"></a>xmlMutexLock ()</h3> <pre class="programlisting">void xmlMutexLock (<a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok)<br> </pre> <p>xmlMutexLock() is used to lock a libxml2 token.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>tok</tt></i>:</span></td> <td>the simple mutex</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlMutexUnlock"></a>xmlMutexUnlock ()</h3> <pre class="programlisting">void xmlMutexUnlock (<a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok)<br> </pre> <p>xmlMutexUnlock() is used to unlock a libxml2 token.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>tok</tt></i>:</span></td> <td>the simple mutex</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlNewMutex"></a>xmlNewMutex ()</h3> <pre class="programlisting"><a href="libxml2-threads.html#xmlMutexPtr">xmlMutexPtr</a> xmlNewMutex (void)<br> </pre> <p>xmlNewMutex() is used to allocate a libxml2 token struct for use in synchronizing access to data.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>a new simple mutex pointer or NULL in case of error</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlNewRMutex"></a>xmlNewRMutex ()</h3> <pre class="programlisting"><a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> xmlNewRMutex (void)<br> </pre> <p>xmlRNewMutex() is used to allocate a reentrant mutex for use in synchronizing access to data. token_r is a re-entrant lock and thus useful for synchronizing access to data structures that may be manipulated in a recursive fashion.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the new reentrant mutex pointer or NULL in case of error</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlRMutexLock"></a>xmlRMutexLock ()</h3> <pre class="programlisting">void xmlRMutexLock (<a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok)<br> </pre> <p>xmlRMutexLock() is used to lock a libxml2 token_r.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>tok</tt></i>:</span></td> <td>the reentrant mutex</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlRMutexUnlock"></a>xmlRMutexUnlock ()</h3> <pre class="programlisting">void xmlRMutexUnlock (<a href="libxml2-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok)<br> </pre> <p>xmlRMutexUnlock() is used to unlock a libxml2 token_r.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>tok</tt></i>:</span></td> <td>the reentrant mutex</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlUnlockLibrary"></a>xmlUnlockLibrary ()</h3> <pre class="programlisting">void xmlUnlockLibrary (void)<br> </pre> <p>xmlUnlockLibrary() is used to release a re-entrant lock on the libxml2 library.</p> </div> <hr> </div> </div> </body> </html>
Submit
FILE
FOLDER
Name
Size
Permission
Action
general.html
5052 bytes
0644
home.png
654 bytes
0644
index.html
3640 bytes
0644
left.png
459 bytes
0644
libxml2-HTMLparser.html
57665 bytes
0644
libxml2-HTMLtree.html
24035 bytes
0644
libxml2-SAX.html
37758 bytes
0644
libxml2-SAX2.html
38547 bytes
0644
libxml2-c14n.html
13177 bytes
0644
libxml2-catalog.html
36071 bytes
0644
libxml2-chvalid.html
19205 bytes
0644
libxml2-debugXML.html
32958 bytes
0644
libxml2-dict.html
13586 bytes
0644
libxml2-encoding.html
29137 bytes
0644
libxml2-entities.html
22702 bytes
0644
libxml2-globals.html
35326 bytes
0644
libxml2-hash.html
42578 bytes
0644
libxml2-list.html
25092 bytes
0644
libxml2-nanoftp.html
22108 bytes
0644
libxml2-nanohttp.html
16220 bytes
0644
libxml2-parser.html
137574 bytes
0644
libxml2-parserInternals.html
124759 bytes
0644
libxml2-pattern.html
18919 bytes
0644
libxml2-relaxng.html
35104 bytes
0644
libxml2-schemasInternals.html
63322 bytes
0644
libxml2-schematron.html
16624 bytes
0644
libxml2-threads.html
12853 bytes
0644
libxml2-tree.html
235392 bytes
0644
libxml2-uri.html
18019 bytes
0644
libxml2-valid.html
98409 bytes
0644
libxml2-xinclude.html
15376 bytes
0644
libxml2-xlink.html
16863 bytes
0644
libxml2-xmlIO.html
57808 bytes
0644
libxml2-xmlautomata.html
34843 bytes
0644
libxml2-xmlerror.html
84419 bytes
0644
libxml2-xmlexports.html
3335 bytes
0644
libxml2-xmlmemory.html
24090 bytes
0644
libxml2-xmlmodule.html
6937 bytes
0644
libxml2-xmlreader.html
107935 bytes
0644
libxml2-xmlregexp.html
41564 bytes
0644
libxml2-xmlsave.html
14399 bytes
0644
libxml2-xmlschemas.html
42062 bytes
0644
libxml2-xmlschemastypes.html
44451 bytes
0644
libxml2-xmlstring.html
34633 bytes
0644
libxml2-xmlunicode.html
106353 bytes
0644
libxml2-xmlversion.html
18450 bytes
0644
libxml2-xmlwriter.html
112111 bytes
0644
libxml2-xpath.html
62301 bytes
0644
libxml2-xpathInternals.html
144503 bytes
0644
libxml2-xpointer.html
25209 bytes
0644
libxml2.devhelp2
388591 bytes
0644
right.png
472 bytes
0644
style.css
820 bytes
0644
up.png
406 bytes
0644
N4ST4R_ID | Naxtarrr
