| 1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 2 |
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US"> |
| 3 |
<head> |
| 4 |
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> |
| 5 |
<meta http-equiv="X-UA-Compatible" content="IE=11"/> |
| 6 |
<meta name="generator" content="Doxygen 1.15.0"/> |
| 7 |
<meta name="viewport" content="width=device-width, initial-scale=1"/> |
| 8 |
<title>Hardware Locality (hwloc): Object attributes</title> |
| 9 |
<link href="tabs.css" rel="stylesheet" type="text/css"/> |
| 10 |
<script type="text/javascript" src="jquery.js"></script> |
| 11 |
<script type="text/javascript" src="dynsections.js"></script> |
| 12 |
<script type="text/javascript" src="clipboard.js"></script> |
| 13 |
<link href="doxygen.css" rel="stylesheet" type="text/css" /> |
| 14 |
</head> |
| 15 |
<body> |
| 16 |
<div id="top"><!-- do not remove this div, it is closed by doxygen! --> |
| 17 |
<div id="titlearea"> |
| 18 |
<table cellspacing="0" cellpadding="0"> |
| 19 |
<tbody> |
| 20 |
<tr id="projectrow"> |
| 21 |
<td id="projectalign"> |
| 22 |
<div id="projectname">Hardware Locality (hwloc)<span id="projectnumber"> 2.14.0</span> |
| 23 |
</div> |
| 24 |
</td> |
| 25 |
</tr> |
| 26 |
</tbody> |
| 27 |
</table> |
| 28 |
</div> |
| 29 |
<!-- end header part --> |
| 30 |
<!-- Generated by Doxygen 1.15.0 --> |
| 31 |
<script type="text/javascript"> |
| 32 |
$(function() { codefold.init(); }); |
| 33 |
</script> |
| 34 |
<script type="text/javascript" src="menudata.js"></script> |
| 35 |
<script type="text/javascript" src="menu.js"></script> |
| 36 |
<script type="text/javascript"> |
| 37 |
$(function() { |
| 38 |
initMenu('',false,false,'search.php','Search',false); |
| 39 |
}); |
| 40 |
</script> |
| 41 |
<div id="main-nav"></div> |
| 42 |
</div><!-- top --> |
| 43 |
<div id="doc-content"> |
| 44 |
<div><div class="header"> |
| 45 |
<div class="headertitle"><div class="title">Object attributes </div></div> |
| 46 |
</div><!--header--> |
| 47 |
<div class="contents"> |
| 48 |
<div class="textblock"><h1 class="doxsection"><a class="anchor" id="attributes_normal"></a> |
| 49 |
Normal attributes</h1> |
| 50 |
<p>hwloc objects have many generic attributes in the <a class="el" href="a00224.html" title="Structure of a topology object.">hwloc_obj</a> structure, for instance their <span class="tt">logical_index</span> or <span class="tt">os_index</span> (see <a class="el" href="a00386.html#faq_indexes">Should I use logical or physical/OS indexes? and how?</a>), <span class="tt">depth</span> or <span class="tt">name</span>.</p> |
| 51 |
<p>The kind of object is first described by the <span class="tt">obj->type</span> generic attribute (an integer). OS devices also have a specific <span class="tt">obj->attr->osdev.type</span> integer for distinguishing between NICs, GPUs, etc.</p> |
| 52 |
<p>Objects may also have an optional <span class="tt">obj->subtype</span> pointing to a better description string (displayed by lstopo either in place or after the main <span class="tt">obj->type</span> attribute): </p><ul> |
| 53 |
<li> |
| 54 |
NUMA nodes: subtype <span class="tt">DRAM</span> (for usual main memory), <span class="tt">HBM</span> (high-bandwidth memory), <span class="tt">SPM</span> (specific-purpose memory, usually reserved for some custom applications), <span class="tt">NVM</span> (non-volatile memory when used as main memory), <span class="tt">MCDRAM</span> (on KNL), <span class="tt">GPUMemory</span> (NVIDIA GPU memory shared over NVLink on POWER, over NVLink-C2C on Grace Hopper, etc.), <span class="tt">CXL-DRAM</span> or <span class="tt">CXL-NVM</span> for CXL DRAM or non-volatile memory. Note that some of these subtypes are guessed by the library, they might be missing or slightly wrong in some corner cases. See <a class="el" href="a00379.html">Heterogeneous Memory</a> for details, and HWLOC_MEMTIERS and HWLOC_MEMTIERS_GUESS in <a class="el" href="a00373.html#envvar_heuristics">Environment variables for tweaking hwloc heuristics</a> for tuning these. </li> |
| 55 |
<li> |
| 56 |
Groups: subtype <span class="tt">Cluster</span>, <span class="tt">Module</span>, <span class="tt">Tile</span>, <span class="tt">Compute Unit</span>, <span class="tt">Book</span> or <span class="tt">Drawer</span> for different architecture-specific groups of CPUs (see also <a class="el" href="a00386.html#faq_groups">What are these Group objects in my topology?</a>). </li> |
| 57 |
<li> |
| 58 |
OS devices (see also <a class="el" href="a00375.html#iodevices_osdev">OS devices</a>): <ul> |
| 59 |
<li> |
| 60 |
Co-processor: subtype <span class="tt">OpenCL</span>, <span class="tt">LevelZero</span>, <span class="tt">CUDA</span>, or <span class="tt">VectorEngine</span>. </li> |
| 61 |
<li> |
| 62 |
GPU: subtype <span class="tt">RSMI</span> (AMD GPU) or <span class="tt">NVML</span> (NVIDIA GPU). </li> |
| 63 |
<li> |
| 64 |
OpenFabrics: subtype <span class="tt">BXI</span> (Bull/Atos BXI HCA). </li> |
| 65 |
<li> |
| 66 |
Network: subtype <span class="tt">Slingshot</span> (HPE Cray Slingshot Cassini HSN). </li> |
| 67 |
<li> |
| 68 |
Block: subtype <span class="tt">Disk</span>, <span class="tt">NVM</span> (non-volatile memory), <span class="tt">SPM</span> (specific-purpose memory), <span class="tt">CXLMem</span> (CXL volatile ou persistent memory), <span class="tt">Tape</span>, or <span class="tt">Removable Media Device</span>. </li> |
| 69 |
</ul> |
| 70 |
</li> |
| 71 |
<li> |
| 72 |
L3 Caches: subtype <span class="tt">MemorySideCache</span> when hwloc is configured to expose the KNL MCDRAM in Cache mode as a L3. </li> |
| 73 |
<li> |
| 74 |
PCI devices: subtype <span class="tt">NVSwitch</span> for NVLink switches (see also NVLinkBandwidth in <a class="el" href="a00378.html#topoattrs_distances">Distances</a>). </li> |
| 75 |
<li> |
| 76 |
Misc devices: subtype <span class="tt">MemoryModule</span> (see also <a class="el" href="a00376.html#miscobjs_auto">Misc objects added by hwloc</a>) </li> |
| 77 |
</ul> |
| 78 |
<p>Each object also contains an <span class="tt">attr</span> field that, if non NULL, points to a union <a class="el" href="a00228.html" title="Object type-specific Attributes.">hwloc_obj_attr_u</a> of type-specific attribute structures. For instance, a L2Cache object <span class="tt">obj</span> contains cache-specific information in <span class="tt">obj->attr->cache</span>, such as its size and associativity, cache type. See <a class="el" href="a00228.html" title="Object type-specific Attributes.">hwloc_obj_attr_u</a> for details.</p> |
| 79 |
<h1 class="doxsection"><a class="anchor" id="attributes_info"></a> |
| 80 |
Custom string infos</h1> |
| 81 |
<p>Aside of these generic attribute fields, hwloc annotates many objects with info attributes made of name and value strings. Each object contains a list of such pairs that may be consulted manually (looking at the object <span class="tt">infos</span> array field) or using the <a class="el" href="a00172.html#ga840c03c835d41cd6f4d91625c25a238d" title="Search the given name in object infos and return the corresponding value.">hwloc_obj_get_info_by_name()</a>. The user may additionally add new name-value pairs to any object using <a class="el" href="a00172.html#gace7654bb8a9002caae1a4b8a59e7452e" title="Add the given name and value pair to the given object info attributes.">hwloc_obj_add_info()</a> or the <a class="el" href="a00372.html#cli_hwloc_annotate">hwloc-annotate</a> program.</p> |
| 82 |
<p><br /> |
| 83 |
</p> |
| 84 |
<p>Here is a list of attributes that may be automatically added by hwloc. A description is given for each pair name (or group of related pairs), and examples of values are also provided.</p> |
| 85 |
<p>Note that these attributes heavily depend on the ability of the operating system to report them. Many of them will therefore be missing on some OS.</p> |
| 86 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_os"></a> |
| 87 |
Operating System Information</h2> |
| 88 |
<p>These info attributes are attached to the root object (Machine).</p> |
| 89 |
<dl> |
| 90 |
<dt>OSName=Linux </dt> |
| 91 |
<dd></dd> |
| 92 |
<dt>OSRelease=5.14.0-427.76.1.el9_4.x86_64 </dt> |
| 93 |
<dd></dd> |
| 94 |
<dt>OSVersion=#1 SMP PREEMPT_DYNAMIC Fri Jun 27 09:53:45 EDT 2025 </dt> |
| 95 |
<dd></dd> |
| 96 |
<dt>HostName=adastra6 </dt> |
| 97 |
<dd></dd> |
| 98 |
<dt>Architecture=x86_64 </dt> |
| 99 |
<dd>The operating system name, release, version, the hostname and the architecture name, as reported by the Unix <span class="tt">uname</span> command. </dd> |
| 100 |
<dt>LinuxCgroup=/slurm/uid_10102/job_4229632/step_extern </dt> |
| 101 |
<dd>The name the Linux control group where the calling process is placed. </dd> |
| 102 |
<dt>WindowsBuildEnvironment=Cygwin </dt> |
| 103 |
<dd>Either <span class="tt">MinGW</span> or <span class="tt">Cygwin</span> when one of these environments was used during build. </dd> |
| 104 |
</dl> |
| 105 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_hwloc"></a> |
| 106 |
hwloc Information</h2> |
| 107 |
<p>These info attributes are attached to the root object (Machine).</p> |
| 108 |
<dl> |
| 109 |
<dt>MemoryTiersNr=2 </dt> |
| 110 |
<dd>The number of different memory tiers in the topology, if any. See <a class="el" href="a00379.html">Heterogeneous Memory</a>. </dd> |
| 111 |
<dt>Backend=Linux (topology root, or specific object added by that backend) </dt> |
| 112 |
<dd>The name of the hwloc backend/component that filled the topology. If several components were combined, multiple Backend pairs may exist, with different values, for instance <span class="tt">x86</span> and <span class="tt">Linux</span> in the root object and <span class="tt">CUDA</span> in CUDA OS device objects. Topologies build from synthetic strings also get a <span class="tt">Synthetic</span> Backend info in the root object. </dd> |
| 113 |
<dt>SyntheticDescription=Pack:1 [NUMA(memory=16GiB)] L2:6(size=1MiB) L1d:1(size=48kiB) Core:1 PU:2 </dt> |
| 114 |
<dd>The description string that was given to hwloc to build this synthetic topology. See <a class="el" href="a00381.html">Synthetic topologies</a> </dd> |
| 115 |
<dt>hwlocVersion=2.13.0 </dt> |
| 116 |
<dd>The version number of the hwloc library that was used to generate the topology. If the topology was loaded from XML, this is not the hwloc version that loaded it, but rather the first hwloc instance that exported the topology to XML earlier. </dd> |
| 117 |
<dt>ProcessName=myprogram </dt> |
| 118 |
<dd>The name of the process that contains the hwloc library that was used to generate the topology. If the topology was from XML, this is not the hwloc process that loaded it, but rather the first process that exported the topology to XML earlier. </dd> |
| 119 |
</dl> |
| 120 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_platform"></a> |
| 121 |
Hardware Platform Information</h2> |
| 122 |
<p>These info attributes are attached to the root object (Machine).</p> |
| 123 |
<dl> |
| 124 |
<dt>DMIBIOSVersion=V70 Ver. 01.08.00 </dt> |
| 125 |
<dd></dd> |
| 126 |
<dt>DMIBoardVendor=HP </dt> |
| 127 |
<dd></dd> |
| 128 |
<dt>DMIChassisType=10 </dt> |
| 129 |
<dd></dd> |
| 130 |
<dt>DMIProductName=HP EliteBook 840 14 inch G10 Notebook PC </dt> |
| 131 |
<dd>These keys (and several others) provide the name, serial number, version, etc. of the hardware product, chassis, motherboard and BIOS, as reported by DMI when supported on Linux (under <span class="tt">/sys/class/dmi/id/</span>). </dd> |
| 132 |
<dt>HardwareName=Marvell Armada-370 </dt> |
| 133 |
<dd></dd> |
| 134 |
<dt>HardwareRevision=0001 </dt> |
| 135 |
<dd></dd> |
| 136 |
<dt>HardwareSerial=000abc123 </dt> |
| 137 |
<dd>The name, revision and serial number of the platform, currently available only on some Linux/ARM platforms. </dd> |
| 138 |
<dt>PlatformName=PowerNV </dt> |
| 139 |
<dd></dd> |
| 140 |
<dt>PlatformModel=C1P9S01 REV 1.01 </dt> |
| 141 |
<dd></dd> |
| 142 |
<dt>PlatformVendor=Eyetech Ltd. </dt> |
| 143 |
<dd></dd> |
| 144 |
<dt>PlatformBoardID=0x22c </dt> |
| 145 |
<dd></dd> |
| 146 |
<dt>PlatformRevision=3 </dt> |
| 147 |
<dd></dd> |
| 148 |
<dt>SystemVersionRegister=0x3456 </dt> |
| 149 |
<dd>All these keys describe POWER/PowerPC platforms. Currently only available on some Linux platforms. </dd> |
| 150 |
<dt>SoC0ID=25 </dt> |
| 151 |
<dd></dd> |
| 152 |
<dt>SoC2Family=Tegra </dt> |
| 153 |
<dd></dd> |
| 154 |
<dt>SoC1Revision=0x00000102 </dt> |
| 155 |
<dd>These keys provide the ID, family and revision of the first system-on-chip (<span class="tt">SoC0</span>), second (<span class="tt">SoC1</span>), etc. Currently only available on Linux on some platforms. </dd> |
| 156 |
<dt>MemoryMode, ClusterMode </dt> |
| 157 |
<dd><p class="startdd">Intel Xeon Phi processor configuration modes. Available if hwloc-dump-hwdata was used (see <a class="el" href="a00386.html#faq_knl_dump">Why do I need hwloc-dump-hwdata for memory on Intel Xeon Phi processor?</a>) or if hwloc managed to guess them from the NUMA configuration.</p> |
| 158 |
<p class="enddd">The memory mode may be <em>Cache</em>, <em>Flat</em>, <em>Hybrid50</em> (half the MCDRAM is used as a cache) or <em>Hybrid25</em> (25% of MCDRAM as cache). The cluster mode may be <em>Quadrant</em>, <em>Hemisphere</em>, <em>All2All</em>, <em>SNC2</em> or <em>SNC4</em>. See doc/examples/get-knl-modes.c in the source directory for an example of retrieving these attributes. </p> |
| 159 |
</dd> |
| 160 |
</dl> |
| 161 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_cpu"></a> |
| 162 |
CPU Information</h2> |
| 163 |
<p>These info attributes are attached to Package objects, or to the root object (Machine) if package locality information is missing.</p> |
| 164 |
<dl> |
| 165 |
<dt>CPUModel=AMD EPYC 7A53 64-Core Processor </dt> |
| 166 |
<dd>The processor model name, available on most platforms and operating systems. </dd> |
| 167 |
<dt>CPUVendor=AuthenticAMD </dt> |
| 168 |
<dd>The processor vendor name, usually available when running on x86 hardware and/or Linux platforms. </dd> |
| 169 |
<dt>CPUModelNumber=48 </dt> |
| 170 |
<dd></dd> |
| 171 |
<dt>CPUFamilyNumber=25 </dt> |
| 172 |
<dd></dd> |
| 173 |
<dt>CPUStepping=1 </dt> |
| 174 |
<dd>x86-specific processor model, family, and stepping numbers. </dd> |
| 175 |
<dt>CPUImplementer=0x48 </dt> |
| 176 |
<dd></dd> |
| 177 |
<dt>CPUArchitecture=8 </dt> |
| 178 |
<dd></dd> |
| 179 |
<dt>CPUVariant=0x1 </dt> |
| 180 |
<dd></dd> |
| 181 |
<dt>CPUPart=0xd01 </dt> |
| 182 |
<dd><p class="startdd">ARM-specific CPU information about the implementer, the sub-architecture, the variant and the part number, currently only available on Linux on most ARM platforms.</p> |
| 183 |
<p class="enddd">Some attributes such as <span class="tt">CPUPart</span> may rather appear in cpukind infos if the CPU is hybrid, see <a class="el" href="a00378.html#topoattrs_cpukinds">CPU Kinds</a>. </p> |
| 184 |
</dd> |
| 185 |
<dt>CPUFamily=Loongson-64bit </dt> |
| 186 |
<dd>The family of the CPU, currently only available on Linux on LoongArch platforms. </dd> |
| 187 |
<dt>CPURevision=0x11 </dt> |
| 188 |
<dd>Processor revision number, currently only available on Linux on ARM, LoongArch and on some POWER/PowerPC platforms. </dd> |
| 189 |
<dt>ProcessorVersionRegister=0x123 </dt> |
| 190 |
<dd>POWER/PowerPC-specific processor version register (PVR), currently only available on Linux on some platforms. </dd> |
| 191 |
<dt>CPUType=sparcv9 </dt> |
| 192 |
<dd>A Solaris-specific general processor type name, such as <span class="tt">i86pc</span> or <span class="tt">sparcv9</span>, as reported by PICL. </dd> |
| 193 |
</dl> |
| 194 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_osdev"></a> |
| 195 |
OS Device Information</h2> |
| 196 |
<h3 class="doxsection"><a class="anchor" id="attributes_info_osdev_gpu_coproc"></a> |
| 197 |
GPU and Coprocessor OS Device Information</h3> |
| 198 |
<p>These info attributes are attached to OS device objects specified in parentheses.</p> |
| 199 |
<dl> |
| 200 |
<dt>GPUVendor=NVIDIA Corporation </dt> |
| 201 |
<dd>GPUModel=Tesla V100-SXM3-32GB-H (GPU or Co-Processor OS devices) </dd> |
| 202 |
<dd>The vendor and model names of the GPU device. </dd> |
| 203 |
<dt>OpenCLDeviceType=GPU </dt> |
| 204 |
<dd></dd> |
| 205 |
<dt>OpenCLPlatformIndex=0 </dt> |
| 206 |
<dd></dd> |
| 207 |
<dt>OpenCLPlatformName=AMD Accelerated Parallel Processing </dt> |
| 208 |
<dd></dd> |
| 209 |
<dt>OpenCLPlatformDeviceIndex=1 (OpenCL OS devices) </dt> |
| 210 |
<dd>The type of OpenCL device, the OpenCL platform index and name, and the index of the device within the platform. </dd> |
| 211 |
<dt>OpenCLComputeUnits=110 </dt> |
| 212 |
<dd></dd> |
| 213 |
<dt>OpenCLGlobalMemorySize=67092480 (OpenCL OS devices) </dt> |
| 214 |
<dd>The number of compute units and global memory size of an OpenCL device. Sizes are in KiB (1024 bytes). </dd> |
| 215 |
<dt>LevelZeroVendor=Intel(R) Corporation </dt> |
| 216 |
<dd></dd> |
| 217 |
<dt>LevelZeroModel=Intel(R) Data Center GPU Max 1550 </dt> |
| 218 |
<dd></dd> |
| 219 |
<dt>LevelZeroBrand=Intel(R) Corporation </dt> |
| 220 |
<dd></dd> |
| 221 |
<dt>LevelZeroSerialNumber=0x180e7227b70f4a0d </dt> |
| 222 |
<dd></dd> |
| 223 |
<dt>LevelZeroBoardNumber=0 (LevelZero OS devices) </dt> |
| 224 |
<dd>The name of the vendor, device model, brand of a Level Zero device, and its serial and board numbers. </dd> |
| 225 |
<dt>LevelZeroDriverIndex=0 </dt> |
| 226 |
<dd></dd> |
| 227 |
<dt>LevelZeroDriverDeviceIndex=0 (LevelZero OS devices) </dt> |
| 228 |
<dd>The index of the Level Zero driver within the list of drivers, and the index of the device within the list of devices managed by this driver. </dd> |
| 229 |
<dt>LevelZeroUUID=27a77ad2b8419be80000000000000000 (LevelZero OS devices or subdevices) </dt> |
| 230 |
<dd>The UUID of the device or subdevice. </dd> |
| 231 |
<dt>LevelZeroSubdevices=2 (LevelZero OS devices) </dt> |
| 232 |
<dd>The number of subdevices below this OS device. </dd> |
| 233 |
<dt>LevelZeroSubdeviceID=1 (LevelZero OS subdevices) </dt> |
| 234 |
<dd>The index of this subdevice within its parent. </dd> |
| 235 |
<dt>LevelZeroDeviceType=GPU (LevelZero OS devices or subdevices) </dt> |
| 236 |
<dd>A string describing the type of device, for instance "GPU", "CPU", "FPGA", etc. </dd> |
| 237 |
<dt>LevelZeroNumSlices=2 </dt> |
| 238 |
<dd></dd> |
| 239 |
<dt>LevelZeroNumSubslicesPerSlice=56 </dt> |
| 240 |
<dd></dd> |
| 241 |
<dt>LevelZeroNumEUsPerSubslice=8 </dt> |
| 242 |
<dd></dd> |
| 243 |
<dt>LevelZeroNumThreadsPerEU=8 (LevelZero OS devices or subdevices) </dt> |
| 244 |
<dd>The number of slices in the device, of subslices per slice, of execution units (EU) per subslice, and of threads per EU. </dd> |
| 245 |
<dt>LevelZeroHBMSize=134217728 </dt> |
| 246 |
<dd></dd> |
| 247 |
<dt>LevelZeroDDRSize=16777216 </dt> |
| 248 |
<dd></dd> |
| 249 |
<dt>LevelZeroMemorySize=16777216 (LevelZero OS devices or subdevices) </dt> |
| 250 |
<dd>The amount of HBM or DDR memory of a LevelZero device or subdevice. Sizes are in KiB (1024 bytes). If the type of memory could not be determined, the generic name LevelZeroMemorySize is used. For devices that contain subdevices, the amount reported in the root device includes the memories of all its subdevices. </dd> |
| 251 |
<dt>LevelZeroCQGroup=3s </dt> |
| 252 |
<dd></dd> |
| 253 |
<dt>LevelZeroCQGroup2=7*0x2 (LevelZero OS devices or subdevices) </dt> |
| 254 |
<dd>The number of completion queue groups, and the description of the third group (as <span class="tt">N*0xX</span> where <span class="tt">N</span> is the number of queues in the group, and <span class="tt">0xX</span> is the hexadecimal bitmask of <span class="tt">ze_command_queue_group_property_flag_t</span> listing properties of those queues). </dd> |
| 255 |
<dt>AMDUUID=e36ac86da8af0f71 </dt> |
| 256 |
<dd></dd> |
| 257 |
<dt>AMDSerial=692224001590 (RSMI GPU OS devices) </dt> |
| 258 |
<dd>The UUID and serial number of AMD GPUs. </dd> |
| 259 |
<dt>RSMIVRAMSize=67092480 </dt> |
| 260 |
<dd></dd> |
| 261 |
<dt>RSMIVisibleVRAMSize=67092480 </dt> |
| 262 |
<dd></dd> |
| 263 |
<dt>RSMIGTTSize=262899364 (RSMI GPU OS devices) </dt> |
| 264 |
<dd>The amount of GPU memory (VRAM), of GPU memory that is visible from the host (Visible VRAM), and of system memory that is usable by the GPU (Graphics Translation Table). Sizes are in KiB (1024 bytes). </dd> |
| 265 |
<dt>XGMIHiveID=bac53b896800dc20 (RSMI GPU OS devices) </dt> |
| 266 |
<dd>The ID of the group of GPUs (Hive) interconnected by XGMI links </dd> |
| 267 |
<dt>XGMIPeers="rsmi0 rsmi1" (RSMI GPU OS devices) </dt> |
| 268 |
<dd>The list of RSMI OS devices that are directly connected to the current device through XGMI links. They are given as a space-separated list of object names, for instance <em>rsmi2 rsmi3</em>. </dd> |
| 269 |
<dt>NVIDIAUUID=GPU-06162e6e-80e9-16e9-357e-ac30a929731c </dt> |
| 270 |
<dd></dd> |
| 271 |
<dt>NVIDIASerial=0322716102756 (NVML GPU OS devices) </dt> |
| 272 |
<dd>The UUID and serial number of NVIDIA GPUs. </dd> |
| 273 |
<dt>CUDAMultiProcessors=56 </dt> |
| 274 |
<dd></dd> |
| 275 |
<dt>CUDACoresPerMP=64 </dt> |
| 276 |
<dd></dd> |
| 277 |
<dt>CUDAGlobalMemorySize=16671616 </dt> |
| 278 |
<dd></dd> |
| 279 |
<dt>CUDAL2CacheSize=4096 </dt> |
| 280 |
<dd></dd> |
| 281 |
<dt>CUDASharedMemorySizePerMP=48 (CUDA OS devices) </dt> |
| 282 |
<dd>The number of shared multiprocessors, the number of (FP32) cores per multiprocessor, the global memory size, the (global) L2 cache size, and size of the shared memory in each multiprocessor of a CUDA device. Sizes are in KiB (1024 bytes). </dd> |
| 283 |
<dt>VectorEngineModel=1 </dt> |
| 284 |
<dd></dd> |
| 285 |
<dt>VectorEngineSerialNumber=32424a3233303034390000000000000 (VectorEngine OS devices) </dt> |
| 286 |
<dd>The model and serial number of a VectorEngine device. </dd> |
| 287 |
<dt>VectorEngineCores=8 </dt> |
| 288 |
<dd></dd> |
| 289 |
<dt>VectorEngineMemorySize=50331648 </dt> |
| 290 |
<dd></dd> |
| 291 |
<dt>VectorEngineLLCSize=16384 </dt> |
| 292 |
<dd></dd> |
| 293 |
<dt>VectorEngineL2Size=256 </dt> |
| 294 |
<dd></dd> |
| 295 |
<dt>VectorEngineL1dSize=32 </dt> |
| 296 |
<dd></dd> |
| 297 |
<dt>VectorEngineL1iSize=32 (VectorEngine OS devices) </dt> |
| 298 |
<dd>The number of cores, memory size, and the sizes of the (global) last level cache and of L2, L1d and L1i caches of a VectorEngine device. Sizes are in KiB (1024 bytes). </dd> |
| 299 |
<dt>VectorEngineNUMAPartitioned=1 (VectorEngine OS devices) </dt> |
| 300 |
<dd>If this attribute exists, the VectorEngine device is configured in partitioned mode with multiple NUMA nodes. </dd> |
| 301 |
</dl> |
| 302 |
<h3 class="doxsection"><a class="anchor" id="attributes_info_osdev_other"></a> |
| 303 |
Other OS Device Information</h3> |
| 304 |
<p>These info attributes are attached to OS device objects specified in parentheses.</p> |
| 305 |
<dl> |
| 306 |
<dt>Vendor=SK hynix </dt> |
| 307 |
<dd></dd> |
| 308 |
<dt>Model=PC801 HFS001TEJ9X101N </dt> |
| 309 |
<dd></dd> |
| 310 |
<dt>Revision=HPS1 </dt> |
| 311 |
<dd></dd> |
| 312 |
<dt>Size=1000204632 </dt> |
| 313 |
<dd></dd> |
| 314 |
<dt>SectorSize=512 (Block OS devices) </dt> |
| 315 |
<dd>The vendor and model names, revision, size (in KiB = 1024 bytes) and SectorSize (in bytes). </dd> |
| 316 |
<dt>LinuxDeviceID=259:0 (Block OS devices) </dt> |
| 317 |
<dd>The major/minor device number such as 8:0 of Linux device. </dd> |
| 318 |
<dt>CXLRAMSize=16777216 </dt> |
| 319 |
<dd></dd> |
| 320 |
<dt>CXLPMEMSize=1073741824 (CXL Memory Block OS devices) </dt> |
| 321 |
<dd>The size of the volatile (RAM) or persistent (PMEM) memory in a CXL Type-3 device. Sizes are in KiB (1024 bytes). </dd> |
| 322 |
<dt>Address=40:5b:7f:97:a0:b8 </dt> |
| 323 |
<dd></dd> |
| 324 |
<dt>Port=1 (Network interface OS devices) </dt> |
| 325 |
<dd>The MAC address and the port number of a software network interface, such as <span class="tt">eth4</span> on Linux. </dd> |
| 326 |
<dt>NodeGUID=9c63:c003:00fb:7458 </dt> |
| 327 |
<dd></dd> |
| 328 |
<dt>SysImageGUID=9c63:c003:00fb:7458 </dt> |
| 329 |
<dd></dd> |
| 330 |
<dt>Port1State=4 </dt> |
| 331 |
<dd></dd> |
| 332 |
<dt>Port2LID=0x2 </dt> |
| 333 |
<dd></dd> |
| 334 |
<dt>Port2LMC=0 </dt> |
| 335 |
<dd></dd> |
| 336 |
<dt>Port3GID1=fe80:0000:0000:0009:9c63:c003:00fb:7458 (OpenFabrics OS devices) </dt> |
| 337 |
<dd>The node GUID and GUID mask, the state of a port #1 (value is 4 when active), the LID and LID mask count of port #2, and GID #1 of port #3. </dd> |
| 338 |
<dt>CassiniVersion=1.1 </dt> |
| 339 |
<dd></dd> |
| 340 |
<dt>NID=0x6913 (Network Slingshot OS devices) </dt> |
| 341 |
<dd>The version of the Cassini NIC and the node ID for a Slingshot CXI interface. </dd> |
| 342 |
<dt>BXIUUID=0x720109782dfd (OpenFabrics BXI OS devices) </dt> |
| 343 |
<dd>The UUID of an Atos/Bull BXI HCA. </dd> |
| 344 |
</dl> |
| 345 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_otherobjs"></a> |
| 346 |
Other Object-specific Information</h2> |
| 347 |
<p>These info attributes are attached to objects specified in parentheses.</p> |
| 348 |
<dl> |
| 349 |
<dt>MemoryTier=1 (NUMA Nodes) </dt> |
| 350 |
<dd>The rank of the memory tier of this node. Ranks start from 0 for highest bandwidth nodes. The attribute is only set if multiple tiers are found. See <a class="el" href="a00379.html">Heterogeneous Memory</a>. </dd> |
| 351 |
<dt>CXLDevice=0003:02:01.0 (NUMA Nodes or DAX Memory OS devices) </dt> |
| 352 |
<dd>The PCI/CXL bus ID of a device whose CXL Type-3 memory is exposed here. If multiple devices are interleaved, their bus IDs are separated by commas, and the number of devices is reported in CXLDeviceInterleaveWays. </dd> |
| 353 |
<dt>CXLDeviceInterleaveWays=2 (NUMA Nodes or DAX Memory OS devices) </dt> |
| 354 |
<dd>If multiple CXL devices are interleaved, this attribute shows the number of devices (and the number of bus IDs in the CXLDevice attributes). </dd> |
| 355 |
<dt>DAXDevice=dax1.0 (NUMA Nodes) </dt> |
| 356 |
<dd>The name of the Linux DAX device that was used to expose a non-volatile memory region as a volatile NUMA node. </dd> |
| 357 |
<dt>DAXType=SPM (NUMA Nodes or DAX OS devices) </dt> |
| 358 |
<dd>The type of memory exposed in a Linux DAX device or in the corresponding NUMA node, either "NVM" (non-volatile memory) or "SPM" (specific-purpose memory). </dd> |
| 359 |
<dt>DAXParent=ACPI0017:00/root0/decoder0.1/region1/dax_region1 (NUMA Nodes or DAX OS devices) </dt> |
| 360 |
<dd>A string describing the Linux sysfs hierarchy that exposes the DAX device, for instance containing "hmem1" for specific-purpose memory or "ndbus0" for NVDIMMs. </dd> |
| 361 |
<dt>PCIBusID=0006:00:00.0 (GPUMemory NUMA Nodes) </dt> |
| 362 |
<dd>The PCI bus ID of the GPU whose memory is exposed in this NUMA node. </dd> |
| 363 |
<dt>Inclusive=1 (Caches) </dt> |
| 364 |
<dd>The inclusiveness of a cache (1 if inclusive, 0 otherwise). Currently only available on x86 processors. </dd> |
| 365 |
<dt>SolarisProcessorGroup=CPU_PM_Active_Power_Domain (Group) </dt> |
| 366 |
<dd>The Solaris kstat processor group name that was used to build this Group object. </dd> |
| 367 |
<dt>PCIVendor=Bull HN Information Systems </dt> |
| 368 |
<dd></dd> |
| 369 |
<dt>PCIDevice=BXI Host Channel Adapter v1.3 (PCI devices and bridges) </dt> |
| 370 |
<dd>The vendor and device names of the PCI device. </dd> |
| 371 |
<dt>PCISlot=2 (PCI devices or Bridges) </dt> |
| 372 |
<dd>The name/number of the physical slot where the device is plugged. If the physical device contains PCI bridges above the actual PCI device, the attribute may be attached to the highest bridge (i.e. the first object that actually appears below the physical slot). </dd> |
| 373 |
<dt>Vendor=Hynix </dt> |
| 374 |
<dd></dd> |
| 375 |
<dt>FormFactor=DIMM </dt> |
| 376 |
<dd></dd> |
| 377 |
<dt>Type=DDR5 </dt> |
| 378 |
<dd></dd> |
| 379 |
<dt>Size=16777216 </dt> |
| 380 |
<dd></dd> |
| 381 |
<dt>DeviceLocation=B6 </dt> |
| 382 |
<dd></dd> |
| 383 |
<dt>BankLocation=Controller0ChannelADimm0 </dt> |
| 384 |
<dd></dd> |
| 385 |
<dt>Rank=1 </dt> |
| 386 |
<dd></dd> |
| 387 |
<dt>AssetTag=011736A0 </dt> |
| 388 |
<dd></dd> |
| 389 |
<dt>PartNumber=HMCG78AGBRA191N (MemoryModule Misc objects) </dt> |
| 390 |
<dd>Information about memory modules (DIMMs) extracted from SMBIOS. Size is in KiB. </dd> |
| 391 |
<dt>SerialNumber=AMCAN00091340A83M (Block and CXL Block Memory OS devices, MemoryModule Misc objects) </dt> |
| 392 |
<dd>The serial number of the device. <br /> |
| 393 |
Note that some OS devices such as Co-Processors may have specific info names such as <span class="tt">LevelZeroSerialNumber</span> when formatted by dedicated APIs, see other subsections above. </dd> |
| 394 |
</dl> |
| 395 |
<h2 class="doxsection"><a class="anchor" id="attributes_info_user"></a> |
| 396 |
User-Given Information</h2> |
| 397 |
<p>Here is a non-exhaustive list of user-provided info attributes that have a special meaning: </p><dl> |
| 398 |
<dt>lstopoStyle=Background=#0000ff;Text=#ffffff </dt> |
| 399 |
<dd>Enforces the style of an object (background and text colors) in the graphical output of lstopo. See CUSTOM COLORS in the lstopo(1) manpage for details. </dd> |
| 400 |
</dl> |
| 401 |
</div></div><!-- contents --> |
| 402 |
</div><!-- PageDoc --> |
| 403 |
<!-- start footer part --> |
| 404 |
<hr class="footer"/><address class="footer"><small> |
| 405 |
Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.15.0 |
| 406 |
</small></address> |
| 407 |
</div><!-- doc-content --> |
| 408 |
</body> |
| 409 |
</html> |