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

-2, --json-v2

Emit JSON output only using version 2 attribute names

-j, --json-output

Emit JSON output with v2 and legacy attribute names (deprecated)

-m, --multi-devices

Include MultiIPU devices in output

-h, --help

Produce help message

--version

Version number