← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/hwloc/oneiric

« back to all changes in this revision

Viewing changes to doc/doxygen-doc/html/a00006.html

  • Committer: Bazaar Package Importer
  • Author(s): Samuel Thibault
  • Date: 2011-03-03 15:06:51 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20110303150651-pflw8qd8ir0mgstt
Tags: 1.1.2-1
http://bugs.debian.org/616253
* New upstream release.
* debian/control: Replace doxygen+texlive* build dependency with
  doxygen-latex (Closes: Bug#616253).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/doxygen-doc/html/a00006.html
7
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
8
8
</head>
9
9
<body>
10
 
<!-- Generated by Doxygen 1.7.2 -->
11
 
<div class="navigation" id="top">
12
 
  <div class="tabs">
 
10
<!-- Generated by Doxygen 1.7.3 -->
 
11
<div id="top">
 
12
<div id="titlearea">
 
13
<table cellspacing="0" cellpadding="0">
 
14
 <tbody>
 
15
 <tr style="height: 56px;">
 
16
  <td style="padding-left: 0.5em;">
 
17
   <div id="projectname">Hardware Locality (hwloc)&#160;<span id="projectnumber">1.1.2</span></div>
 
18
  </td>
 
19
 </tr>
 
20
 </tbody>
 
21
</table>
 
22
</div>
 
23
  <div id="navrow1" class="tabs">
13
24
    <ul class="tablist">
14
25
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
15
26
      <li class="current"><a href="pages.html"><span>Related&#160;Pages</span></a></li>
24
35
<h1>Thread Safety </h1>  </div>
25
36
</div>
26
37
<div class="contents">
27
 
<p>Like most libraries that mainly fill data structures, hwloc is not thread safe but rather reentrant: all state is held in a <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instance without mutex protection. That means, for example, that two threads can safely operate on and modify two different <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instances, but they should not simultaneously invoke functions that modify the <em>same</em> instance. Similarly, one thread should not modify a <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instance while another thread is reading or traversing it. However, two threads can safely read or traverse the same <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instance concurrently.</p>
 
38
<div class="textblock"><p>Like most libraries that mainly fill data structures, hwloc is not thread safe but rather reentrant: all state is held in a <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instance without mutex protection. That means, for example, that two threads can safely operate on and modify two different <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instances, but they should not simultaneously invoke functions that modify the <em>same</em> instance. Similarly, one thread should not modify a <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instance while another thread is reading or traversing it. However, two threads can safely read or traverse the same <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> instance concurrently.</p>
28
39
<p>When running in multiprocessor environments, be aware that proper thread synchronization and/or memory coherency protection is needed to pass hwloc data (such as <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> pointers) from one processor to another (e.g., a mutex, semaphore, or a memory barrier). Note that this is not a hwloc-specific requirement, but it is worth mentioning.</p>
29
40
<p>For reference, <a class="el" href="a00033.html#ga9d1e76ee15a7dee158b786c30b6a6e38">hwloc_topology_t</a> modification operations include (but may not be limited to):</p>
30
41
<dl>
44
55
<p class="enddd"></p>
45
56
</dd>
46
57
</dl>
47
 
</div>
48
 
<hr class="footer"/><address class="footer"><small>Generated on Mon Jan 24 2011 17:12:07 for Hardware Locality (hwloc) by&#160;
 
58
</div></div>
 
59
<hr class="footer"/><address class="footer"><small>Generated on Wed Apr 6 2011 17:31:40 for Hardware Locality (hwloc) by&#160;
49
60
<a href="http://www.doxygen.org/index.html">
50
 
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.2 </small></address>
 
61
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
51
62
</body>
52
63
</html>