nvidia-smi

Section: (1)
Updated: 2010-11-12
Index Return to Main Contents
 

NAME

nvidia-smi - NVIDIA System Management Interface program  

SYNOPSIS

nvidia-smi [options]

Options: [-h, --help] [-x, --xml-format]
[-f filename, --filename=filename]
[-l, --loop-continuously] [-i sec, --interval=sec]
[-t unit-number, --toggle-led=unit-number]
[-a, --all-gpus ] [-d, --discrete-gpus ]
[-L, --list-gpus ] [-g gpu-id, --gpu=gpu-id]
[-c ruleset, --compute-mode-rules=ruleset]
[-s, --show-compute-mode-rules ] [-e, --ecc-config=config]
[-r, --report-ecc-config ] [-q, --query-gpu-info]
[-p, --reset-aggregate-ecc-error-counts]
[-v, --reset-volatile-ecc-error-counts]
[-F filename, --fault-log=filename]

 

DESCRIPTION

The NVIDIA System Management Interface (nvidia-smi) program provides system state and diagnostic information for the NVIDIA Tesla Visual Computing Systems. It provides these data in either plain text or XML format, printed to stdout or optionally written to a user specified file.  

OPTIONS

-h, --help
Print usage information and exit.
-x, --xml-format
Produce XML output. Unless an output file is specified using the -f option, all data are output to stdout.
-f filename
--filename=filename
Log to the named file filename, rather than to stdout.
-l, --loop-continuously
Probe continuously, outputting to stdout unless an output file is specified using the -f option. If an output file is specified, it is updated on each loop iteration.
-i sec
--interval=sec
Probe once every sec seconds when probing continuously. The default and minimum interval is 1 second.
-t unit-number
--toggle-led=unit-number
Toggle the LED state (ON -> OFF or OFF -> ON) for unit unit-number. The unit number of an NVIDIA Tesla Visual Computing System can be found in the log file. Each NVIDIA Tesla Visual Computing System unit attached to a given system has a unique unit number within that system.
-a, --all-gpus
Include discrete GPUs when listings and consider them for GPU specific options if no GPU is specified using the -g option. Discrete GPUs are GPUs not installed in QuadroPlex and/or Tesla computing systems.
-d, --discrete-gpus
Include only discrete GPUs in listings and consider them exclusively for GPU specific options if no GPU is specified using the -g option.
-L, --list-gpus
Print a list of installed GPUs and exit. By default, discrete GPUs are not listed. This behavior can be changed with the -a and -d options.
-g gpu-id
--gpu=gpu-id
Specify the GPU to be targeted when specifying GPU specific options, such as --show-compute-mode-rules. The appropriate gpu-id identifier can be obtained using the -L option.
-q, --query-gpu-info
Print information about a given GPU or set of GPUs, including the product name, PCI ID, temperature, and ECC error counts. No information about any Visial Computing Systems attached to the host is listed. Unless the -g option is used to select a specific GPU, information for a set of GPUs is reported. By default, this set only includes GPUs installed in QuadroPlex and/or Tesla Visual Computing Systems. The -a and -d options can be used to change the set.
-c ruleset
--compute-mode-rules=ruleset
Set the compute mode rules to ruleset for the GPU specified using the -g option.

ruleset may be one of the following:
      0 - Normal mode
      1 - COMPUTE exclusive mode (only one COMPUTE context is allowed to run on the GPU)
      2 - COMPUTE prohibited mode (no COMPUTE contexts are allowed to run on the GPU)

-s, --show-compute-mode-rules
Display the current compute mode ruleset for the GPU specified using the -g option. If no GPU is chosen with the -g option, the rules for all GPUs are shown.
-e config
--ecc-config=config
Set the ECC configuration to config for the GPU specified using the -g option. Changes take effect with the next system boot. The -q option reports ECC error statistics if ECC is supported and enabled.

config may be one of the following:
      0 - Disabled
      1 - Enabled (ECC will be used for video memory and some engines)

-r, --report-ecc-config
Report both the current and future (after reboot) ECC configurations for the GPU specified using the -g option. If no GPU is chosen with the -g option, the configuration for all GPUs is reported.
-p, --reset-aggregate-ecc-error-counts
Reset aggregate ECC error counts (those that are remembered across reboots). If no GPU is chosen with the -g option, the counts for all GPUs are reset.
-v, --reset-volatile-ecc-error-counts
Reset volatile ECC error counts (those that are cleared to 0 on each boot). If no GPU is chosen with the -g option, the counts for all GPUs are reset.
-F filename
--fault-log=filename
Read fault records, log them to the file named filename and clear the fault records.

 

EXAMPLES

nvidia-smi
Probe once and log all relevant data to stdout.
nvidia-smi -l
Probe continuously and log to stdout.
nvidia-smi -x -f newfile
Probe once and log to the file newfile in XML format.
nvidia-smi -g 0 -s
Report the current COMPUTE ruleset for GPU 0.
 

AUTHOR

Andrew Iles
NVIDIA Corporation  

COPYRIGHT

Copyright © 2010 NVIDIA Corporation.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
AUTHOR
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 19:49:13 GMT, April 27, 2011