9. gc-inventory
This tool lists device IDs, physical parameters and firmware version numbers of the IPUs present in the system.
Unlike gc-info, this command will not attempt to lock access to any IPUs. This means that it can be used to gather information about a system even if some of the IPUs are in use. However, this also means that it is not able to provide as much information as gc-info.
The output will be similar to this:
{
"devices": [
{
"id": "0",
"target": "Fabric",
"Attached": "0",
"Config Domain": "94891151096224",
"Driver version": "1.0.50",
"Fabric Reconfigurable": "true",
"Firmware Major Version": "2",
"Firmware Minor Version": "1",
"Firmware Patch Version": "3",
"IPU": "1",
"IPU sync utilisation": "0.00%",
"IPU version": "ipu2",
"In use": "0",
"Location": "10.1.5.12",
"Num Replicas": "1",
"PCI Id": "3",
"PCI slot": "3",
"Partition ID": "pa12_ipuof",
"Routing Id": "0",
"Routing Type": "DNC",
"Server version": "1.5.4",
"Sync Type": "c2-compatible",
"clock": "1330MHz",
"gateway software version": "2.0.10",
"graph streaming": "true",
"hexoatt total size": "16911433728",
"hexoatt used size": "0",
"hexopt total size": "268435456",
"hexopt used size": "0",
"link correctable error count": "0",
"link speed": "16 GT\/s",
"link width": "8",
"remote buffers": "1",
"serial number": "0024.0002.8203321",
"type": "M2000"
},
...
]
}
If the IPU is in use, the output will contain some additional fields relating to the attached process:
{
"devices": [
{
"id": "0",
"target": "Fabric",
"Attached": "0",
"Config Domain": "94615721195936",
"Driver version": "1.0.50",
"Fabric Reconfigurable": "true",
"Firmware Major Version": "2",
"Firmware Minor Version": "1",
"Firmware Patch Version": "3",
"IPU": "1",
"IPU sync utilisation": "0.00%",
"IPU version": "ipu2",
"In use": "0",
"Location": "10.1.5.12",
"Num Replicas": "1",
"PCI Id": "3",
"PCI slot": "3",
"Partition ID": "pa12_ipuof",
"Routing Id": "0",
"Routing Type": "DNC",
"Server version": "1.5.4",
"Sync Type": "c2-compatible",
"average board temp": "N\/A",
"average die temp": "N\/A",
"clock": "1330MHz",
"gateway software version": "2.0.10",
"graph streaming": "true",
"hexoatt total size": "16911433728",
"hexoatt used size": "0",
"hexopt total size": "268435456",
"hexopt used size": "0",
"link correctable error count": "462807",
"link speed": "16 GT\/s",
"link width": "8",
"process start time": "20210415T171938Z",
"remote buffers": "1",
"serial number": "0024.0002.8203321",
"total board power": "N\/A",
"type": "M2000",
"user executable": "gc-powertest",
"user name": "emmaf",
"user process id": "17870"
},
...
]
}
9.1. Usage
9.1.1. Allowed options
|
Emit JSON output only using version 2 attribute names |
|
Emit JSON output with v2 and legacy attribute names (deprecated) |
|
Include MultiIPU devices in output |
|
Produce help message |
|
Version number |