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
|
<!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.12"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<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 id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Hardware Locality (hwloc)
 <span id="projectnumber">1.11.5</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.12 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></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="a00164.html">Object Structure and Attributes</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p><code>#include <<a class="el" href="a00113_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="a00256.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="a00256.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="a00256.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="a00256.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="a00256.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), see below.</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 id="a0f70f48d1bfb18e5e2008825da2967c9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a0f70f48d1bfb18e5e2008825da2967c9">§ </a></span>latency</h2>
<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. </p>
<p>Unless defined by the user, this currently contains latencies between NUMA nodes (as reported in the System Locality Distance Information Table (SLIT) in the ACPI specification), which may or may not be accurate. It corresponds to the latency for accessing the memory of one node from a core in another node.</p>
<p>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 id="a204416418049a272bfb51602fc676342"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a204416418049a272bfb51602fc676342">§ </a></span>latency_base</h2>
<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 id="aab61bd1d1ae2e121bfe793c973ec829e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aab61bd1d1ae2e121bfe793c973ec829e">§ </a></span>latency_max</h2>
<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 id="a4ca2af858cebbce7324ec49903d09474"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a4ca2af858cebbce7324ec49903d09474">§ </a></span>nbobjs</h2>
<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 <a class="el" href="a00176.html#ga8874c24e73ba2b04c76ec8b9e54f49f8" title="Return the number of objects at depth depth included in CPU set set. ">hwloc_get_nbobjs_inside_cpuset_by_depth()</a>. </p>
</div>
</div>
<a id="a6fe066eaf62ee448aa05bab8e7217ff7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6fe066eaf62ee448aa05bab8e7217ff7">§ </a></span>relative_depth</h2>
<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="a00113_source.html">hwloc.h</a></li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</body>
</html>
|
