11. gc-inventory

This tool lists the device attributes of all IPUs present in the system.

By default the results are output in a flat “key: value” layout. To get JSON-formatted output, specify the -j2 flag.

$ gc-inventory -j2
{
    "devices": [
        {
            "id": "0",
            "target": "PCIe",
            "average board temp": "26.6 C",
            "average die temp": "20.1 C",
            "board ipu index": "0",
            "board serial number": "0057.0063.822351",
            "board type": "C600",
            "board variant": "C600",
            "clock": "20MHz",
            "driver version": "1.3.0",
            "firmware major version": "2",
            "firmware minor version": "6",
            "firmware patch version": "7",
            "firmware version": "2.6.7",
            "hexoatt active size (bytes)": "0",
            "hexoatt total size (bytes)": "16911433728",
            "hexopt active size (bytes)": "0",
            "hexopt total size (bytes)": "268435456",
            "icu bootloader version": "2.6.0",
            "ipu architecture": "ipu21",
            "ipu error state": "no errors",
            "ipu power": "N\/A",
            "ipu utilisation": "0.00%",
            "ipu utilisation (session)": "0.00%",
            "link correctable error count": "0",
            "link correctable error count (session)": "0",
            "link speed": "8.0 GT\/s",
            "link width": "8",
            "numa node": "0",
            "parity error count threshold": "4",
            "parity error threshold interval": "7776000 seconds",
            "parity initialised": "1",
            "pci id": "0000:1b:00.0",
            "pcie physical slot": "PCIe Slot 10",
            "remote buffers supported": "1",
            "sysfs file id": "0",
            "total board power": "12.4 W"
        },
        {
            "id": "1",
            "target": "PCIe",
        ...
    ]
}

gc-inventory does not require exclusive access to devices, so can be used while IPUs are in use.

By default, gc-inventory only displays information about IPUs in the current active partition. To see the IPUs in other partitions, use the --all-partitions command line option.

11.1. Usage

11.1.1. Allowed options

--all-partitions

List devices in all partitions

-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