Adminsitracion

nvidia−smi(1)

NVIDIA

nvidia−smi(1)

NAME
nvidia−smi − NVIDIA System Management Interface program

SYNOPSIS
nvidia-smi [OPTION1 [ARG1]] [OPTION2 [ARG2]] ...

DESCRIPTION
NVSMI provides monitoring information for each of NVIDIA's Tesla devices and each of its high-end
Fermi-based and Kepler-based Quadro devices. It provides very limited information for other types of
NVIDIAdevices. See NVML documentation at http://developer.nvidia.com/nvidia-management-librarynvml for what features are supported on a particular device. The data is presented in either plain text or
XML format, via stdout or a file. NVSMI also provides several management operations for changing
device state.
Note that the functionality of NVSMI is exposed through the NVML C-based library. See the NVIDIAdeveloper website for more information about NVML. Python and Perl wrappers to NVML are also available. The output of NVSMI is not guaranteed to be backwards compatible; NVML and the bindings are
backwards compatible.
http://developer.nvidia.com/nvidia-management-library-nvml/
http://pypi.python.org/pypi/nvidia-ml-py/
http://search.cpan.org/search?query=nvidia%3A%3Aml

OPTIONS
GENERALOPTIONS
−h, −−help
Print usage information and exit.
SUMMARY OPTIONS
−L, −−list−gpus
List each of the NVIDIA GPUs in the system, along with their serial numbers or UUIDs. Tesla and Quadro
GPUs from the Fermi and Kepler family report serial numbers, which match the ids physically printed on
each board. GT200 Tesla products only support UUIDs, which are also unique but do not correspond to
anyidentifier on the board. All other products report N/A.
QUERY OPTIONS
−q, −−query
Display GPU or Unit info. Displayed info includes all data listed in the (GPU ATTRIBUTES) or (UNIT
ATTRIBUTES) sections of this document. Some devices and/or environments don't support all possible
information. Any unsupported data is indicated by a "N/A" in the output. By default information for all
available GPUsor Units is displayed. Use the −i option to restrict the output to a single GPU or Unit.
[plus optional]
−u, −−unit
Display Unit data instead of GPU data. Unit data is only available for NVIDIA S−class Tesla enclosures.
−i, −−id=ID
Display data for a single specified GPU or Unit. The specified id may be the GPU/Unit's 0−based index in
the natural enumeration returned by the driver, the GPU'sboard serial number, the GPU's UUID, or the

nvidia−smi 4.304

2011−08−29

1

nvidia−smi(1)

NVIDIA

nvidia−smi(1)

GPU's PCI bus ID (as domain:bus:device.function in hex). It is recommended that users desiring consistency use either UUID or PCI bus ID, since device enumeration ordering is not guaranteed to be consistent
between reboots and board serial number might be sharedbetween multiple GPUs on the same board.
−f FILE, −−filename=FILE
Redirect query output to the specified file in place of the default stdout. The specified file will be overwritten.
−x, −−xml−format
Produce XML output in place of the default human−readable format. Both GPU and Unit query outputs
conform to corresponding DTDs. These are available via the −−dtd flag.
−−dtd
Use with −x. Embed the DTD inthe XML output.
−d, −−display
Display only selected information: MEMORY, UTILIZATION, ECC, TEMPERATURE, POWER,
CLOCK, COMPUTE, PIDS, PERFORMANCE. Flags can be combined with comma e.g. "MEMORY,ECC". Doesn't work with -u/--unit or -x/--xml-format flags.
−l SEC, −−loop=SEC
Continuously report query data at the specified interval, rather than the default of just once. The application will sleepin−between queries. Note that on Linux ECC error or XID error events will print out during
the sleep period if the -x flag was not specified. Pressing Ctrl+C at any time will abort the loop, which will
otherwise run indefinitely. If no argument is specified for the −l form a default interval of 5 seconds is
used.
DEVICE MODIFICATION OPTIONS
[any one of]
−pm, −−persistence−mode=MODE
Set the...