3. Command line tools

The Poplar SDK includes a number of software tools that provide information on the current status of the connected hardware. The full list of these tools and how to use them is described in the Graphcore Command Line Tools document.

Note

On the following systems you must explicitly enable Poplar before you can use these command line tools:

• Graphcloud

• Pod system

Other cloud systems have Poplar automatically enabled as part of the login process.

Some of the tools are:

• gc-info: displays various kinds of information about the available IPUs. Requires a command parameter, for example:

  • gc-info --list-devices displays a list of all devices in the system

  • gc-info -d 0 --device-info displays the attributes of device 0.

  Refer to the gc-info documentation for more command parameters.

• gc-monitor: passively monitors IPU activity and telemetry such as power draw, temperature and clock speed. Refer to the gc-monitor documentation for information on how to use the command and the information that is output.

• gc-reset: resets one or more IPU devices. Refer to the gc-reset documentation for more options.