2
\begin{DoxyDescription}
3
\item[Object ]Interesting kind of part of the system, such as a Core, a Cache, a Memory node, etc. The different types detected by hwloc are detailed in the hwloc\_\-obj\_\-type\_\-e enumeration.
5
They are topologically sorted by CPU set into a tree whose root is the System object which always exists.
8
\item[CPU set ]The set of logical processors logically included in an object, if any
11
\item[Father object ]The object logically containing the current object, for instance because its CPU set includes the CPU set of the current object.
14
\item[Children objects ]The object contained in the current object because their CPU set is included in the CPU set of the current object.
17
\item[Arity ]The number of children of an object
20
\item[Sibling objects ]Objects of the same type which have the same father
23
\item[Sibling rank ]Index to uniquely identify objecst of the same type which have the same father, numbered from 0 to the arity of the father minus one.
26
\item[Cousin objects ]Objects of the same type as the current object
29
\item[Level ]Set of objects of the same type
32
\item[OS index ]The index that the OS uses to identify the object. This may sometimes be completely arbitrary or depend on the BIOS configuration.
35
\item[Depth ]Nesting level in the object tree, starting from the System object.
38
\item[Logical index ]Index to uniquely identify objects of the same type. This index is always linear from 0 to the number of objects of the level for that type, to express proximity. It could also be called cousin rank.
43
The following diagram can help to understand the vocabulary of the relationships by showing the example of a machine with two dual core non-\/SMT sockets, thus a topology with 4 levels.
46
\begin{DoxyImageNoCaption}
47
\mbox{\includegraphics[width=\textwidth]{diagram}}
48
\end{DoxyImageNoCaption}
51
It should be noted that for Processor objects, the logical index, computed linearly by hwloc, is not the same as the OS index.
b'\\ No newline at end of file'