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
|
<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.8"/>
<title>Hardware Locality (hwloc): hwloc_distances_s Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Hardware Locality (hwloc)
 <span id="projectnumber">1.10.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.8 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-attribs">Data Fields</a> </div>
<div class="headertitle">
<div class="title">hwloc_distances_s Struct Reference<div class="ingroups"><a class="el" href="a00075.html">Object Structure and Attributes</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p><code>#include <<a class="el" href="a00063_source.html">hwloc.h</a>></code></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr class="memitem:a6fe066eaf62ee448aa05bab8e7217ff7"><td class="memItemLeft" align="right" valign="top">unsigned </td><td class="memItemRight" valign="bottom"><a class="el" href="a00034.html#a6fe066eaf62ee448aa05bab8e7217ff7">relative_depth</a></td></tr>
<tr class="separator:a6fe066eaf62ee448aa05bab8e7217ff7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a4ca2af858cebbce7324ec49903d09474"><td class="memItemLeft" align="right" valign="top">unsigned </td><td class="memItemRight" valign="bottom"><a class="el" href="a00034.html#a4ca2af858cebbce7324ec49903d09474">nbobjs</a></td></tr>
<tr class="separator:a4ca2af858cebbce7324ec49903d09474"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0f70f48d1bfb18e5e2008825da2967c9"><td class="memItemLeft" align="right" valign="top">float * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00034.html#a0f70f48d1bfb18e5e2008825da2967c9">latency</a></td></tr>
<tr class="separator:a0f70f48d1bfb18e5e2008825da2967c9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aab61bd1d1ae2e121bfe793c973ec829e"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="a00034.html#aab61bd1d1ae2e121bfe793c973ec829e">latency_max</a></td></tr>
<tr class="separator:aab61bd1d1ae2e121bfe793c973ec829e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a204416418049a272bfb51602fc676342"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="a00034.html#a204416418049a272bfb51602fc676342">latency_base</a></td></tr>
<tr class="separator:a204416418049a272bfb51602fc676342"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Distances between objects. </p>
<p>One object may contain a distance structure describing distances between all its descendants at a given relative depth. If the containing object is the root object of the topology, then the distances are available for all objects in the machine.</p>
<p>If the <code>latency</code> pointer is not <code>NULL</code>, the pointed array contains memory latencies (non-zero values), as defined by the ACPI SLIT specification.</p>
<p>In the future, some other types of distances may be considered. In these cases, <code>latency</code> may be <code>NULL</code>. </p>
</div><h2 class="groupheader">Field Documentation</h2>
<a class="anchor" id="a0f70f48d1bfb18e5e2008825da2967c9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float* hwloc_distances_s::latency</td>
</tr>
</table>
</div><div class="memdoc">
<p>Matrix of latencies between objects, stored as a one-dimension array. May be <code>NULL</code> if the distances considered here are not latencies. Values are normalized to get 1.0 as the minimal value in the matrix. Latency from i-th to j-th object is stored in slot i*nbobjs+j. </p>
</div>
</div>
<a class="anchor" id="a204416418049a272bfb51602fc676342"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float hwloc_distances_s::latency_base</td>
</tr>
</table>
</div><div class="memdoc">
<p>The multiplier that should be applied to latency matrix to retrieve the original OS-provided latencies. Usually 10 on Linux since ACPI SLIT uses 10 for local latency. </p>
</div>
</div>
<a class="anchor" id="aab61bd1d1ae2e121bfe793c973ec829e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float hwloc_distances_s::latency_max</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximal value in the latency matrix. </p>
</div>
</div>
<a class="anchor" id="a4ca2af858cebbce7324ec49903d09474"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned hwloc_distances_s::nbobjs</td>
</tr>
</table>
</div><div class="memdoc">
<p>Number of objects considered in the matrix. It is the number of descendant objects at <code>relative_depth</code> below the containing object. It corresponds to the result of hwloc_get_nbobjs_inside_cpuset_by_depth. </p>
</div>
</div>
<a class="anchor" id="a6fe066eaf62ee448aa05bab8e7217ff7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned hwloc_distances_s::relative_depth</td>
</tr>
</table>
</div><div class="memdoc">
<p>Relative depth of the considered objects below the object containing this distance information. </p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="a00063_source.html">hwloc.h</a></li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Tue Oct 7 2014 11:56:52 for Hardware Locality (hwloc) by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.8
</small></address>
</body>
</html>
|
