gc-info

This tool list detailed information about the IPU present in the hardware platform. To extract some of the information, gc-info will need to lock access to IPUs. Therefore it cannot be used for IPUs that are already in use.

Sub-commands

A number of sub-commands are available as command line options to gc-info. The most useful are listed below.

List devices

The --list-devices and --list-all-devices command options will list the IPUs in the system.

Register dump

The --tile-status command dumps the register state from the individual tiles in the IPU. There are lots of options to control what it dumps. This is useful for low-level debugging of an application or IPU fault.

Some examples:

$ gc-info --device-id 0 --tile-status 0  # dumps out all tile registers on device 0
$ gc-info --device-id 0 --tile-status 0 --context SU # dumps out all tile registers on device 0 for the supervisor context
$ gc-info --device-id 0 --tile-status 0 --context SU --register PC # dumps out the PC for the supervisor context on tile 0
$ gc-info --device-id 0 --tile-status - # dumps out the tile status for all tiles.
$ gc-info --device-id 0 --tile-status - -c SU -r PC # Dumps out the PC for the supervisor context from every tile

There are also commands to display various SoC registers for low-level debugging; for example, --xb-status, --gsp-status, --gsp-status.

Dump tile memory

The --dump-mem command displays the contents of memory on the specified tile.

For example, the following command dumps 16 bytes of memory from address 0x42000 on tile 0:

$ gc-info --device-id 0 --dump-mem 0 0x42000 16