@@ -3004,11 +3004,14 @@ objects.
3004
3004
Depending on the topology configuration, some components will be used
3005
3005
(once enabled, they create a <b>backend</b>),
3006
3006
some will be ignored.
3007
+
3007
3008
The usual default is to enable the native operating system component,
3008
3009
(e.g. <tt>linux</tt> or <tt>solaris</tt>) and the
3009
- <tt>pci</tt> miscellaneous component .
3010
+ <tt>pci</tt> one .
3010
3011
If available, an architecture-specific component (such as <tt>x86</tt>)
3011
3012
may also improve the topology detection.
3013
+ Finally, some hardware-specific components (such as <tt>cuda</tt> or <tt>rsmi</tt>)
3014
+ may add information about GPUs, accelerators, etc.
3012
3015
3013
3016
If a XML topology is loaded, the <tt>xml</tt> discovery component
3014
3017
will be used instead of all other components.
@@ -3058,13 +3061,13 @@ priorities) that does not conflict.
3058
3061
Certain components that manage a virtual topology, for instance XML
3059
3062
topology import or synthetic topology description,
3060
3063
conflict with all other components.
3061
- Therefore, one of them may only be loaded
3064
+ Therefore, they may only be loaded
3062
3065
(e.g. with <tt>hwloc_topology_set_xml()</tt>)
3063
3066
if no other component is enabled.
3064
3067
3065
3068
The environment variable <tt>HWLOC_COMPONENTS_VERBOSE</tt>
3066
- may be set to get verbose messages about component registration
3067
- (including their priority) and enabling.
3069
+ may be set to get verbose messages about available components
3070
+ (including their priority) and enabling as backends .
3068
3071
3069
3072
3070
3073
\htmlonly
@@ -3098,13 +3101,14 @@ name with <tt>-</tt> in the list. For instance <tt>x86,-pci</tt> will load the
3098
3101
<tt>x86</tt> component, then let hwloc load all the usual components except
3099
3102
<tt>pci</tt>.
3100
3103
A single component phase may also be blacklisted, for instance with <tt>-linux:io</tt>.
3101
- hwloc_topology_set_components() may also be used inside the program
3102
- to prevent the loading of a specific component (or phases) for the target topology.
3103
3104
3104
3105
It is possible to prevent all remaining components from being loaded
3105
3106
by placing <tt>stop</tt> in the environment variable.
3106
3107
Only the components listed before this keyword will be enabled.
3107
3108
3109
+ hwloc_topology_set_components() may also be used inside the program
3110
+ to prevent the loading of a specific component (or phases) for the target topology.
3111
+
3108
3112
3109
3113
\htmlonly
3110
3114
</div><div class="section" id="plugins_load">
@@ -3176,7 +3180,7 @@ environment variable (see \ref envvar).
3176
3180
</dd>
3177
3181
<dt>pci</dt>
3178
3182
<dd>
3179
- PCI object discovery uses the external pciaccess library (aka libpciaccess) ;
3183
+ PCI object discovery uses the external libpciaccess library;
3180
3184
see \ref iodevices. It may also annotate existing PCI devices with vendor
3181
3185
and device names.
3182
3186
<b>It may be built as a plugin</b>.
0 commit comments