The NVIDIA GPU Query Properties
The NVIDIA GPU Query Properties
ManufactureSetting Properties
name or gpu_name: The official product name of the GPU. This is an alphanumeric
string. For all products.
serial or gpu_serial: This number matches the serial number physically printed on each
board. It is a globally unique immutable alphanumeric value.
uuid or gpu_uuid: This value is the globally unique immutable alphanumeric identifier of
the GPU. It does not correspond to any physical label on the board.
Setup Properties
power.min_limit: The minimum value in watts that power limit can be set to.
power.max_limit: The maximum value in watts that power limit can be set to.
display_mode: A flag that indicates whether a physical display (e.g. monitor) is currently
connected to any of the GPU's connectors. "Enabled" indicates an attached display.
"Disabled" indicates otherwise.
index: Zero based index of the GPU. Can change at each boot.
display_active: A flag that indicates whether a display is initialized on the GPU's (e.g.
memory is allocated on the device for display). Display can be active even when no
monitor is physically attached. "Enabled" indicates an active display. "Disabled"
indicates otherwise.
persistence_mode: A flag that indicates whether persistence mode is enabled for the
GPU. Value is either "Enabled" or "Disabled". When persistence mode is enabled the
NVIDIA driver remains loaded even when no active clients, such as X11 or nvidia-smi,
exist. This minimizes the driver load latency associated with running dependent apps,
such as CUDA programs. Linux only.
accounting.mode: A flag that indicates whether accounting mode is enabled for the
GPU. Value is either "Enabled" or "Disabled". When accounting is enabled statistics are
calculated for each computer process running on the GPU. Statistics are available for
query after the process terminates. See --help-query-accounted-apps for more info.
accounting.buffer_size: The size of the circular buffer that holds a list of processes that
can be queried for accounting stats. This is the maximum number of processes that
accounting information will be stored for before information about oldest processes will
get overwritten by information about new processes.
inforom.img or inforom.image: Global version of the infoROM image. Image version just
like VBIOS version uniquely describes the exact version of the infoROM flashed on the
board in contrast to infoROM object version which is only an indicator of supported
features.
power.limit: The power management algorithm's power ceiling, in watts. Total board
power draw is manipulated by the power management algorithm so that it stays under
this value. On Kepler devices Power Limit can be adjusted using [-pl | --power-limit=]
switches.
Runtime Properties
timestamp: The timestamp of where the query was made in format "YYYY/MM/DD
HH:MM:SS.msec".
pcie.link.gen.current: The current PCI-E link generation. These may be reduced when the
GPU is not in use.
pcie.link.width.current: The current PCI-E link width. These may be reduced when the
GPU is not in use.
fan.speed: The fan speed value is the percent of maximum speed that the device's fan is
currently intended to run at. It ranges from 0 to 100 %. Note: The reported speed is the
intended fan speed. If the fan is physically blocked and unable to spin, this output will
not match the actual fan speed. Many parts do not report fan speeds because they rely
on cooling via fans in the surrounding enclosure.
pstate: The current performance state for the GPU. States range from P0 (maximum
performance) to P12 (minimum performance).
utilization.gpu: Percent of time over the past second during which one or more kernels
was executing on the GPU.
utilization.memory: Percent of time over the past second during which global (device)
memory was being read or written.
power.draw: The last measured power draw for the entire board, in watts. Only available
if power management is supported. This reading is accurate to within +/- 5 watts.
ecc.mode.current: The Error Correcting Code (ECC) mode that the GPU is currently
operating under.
ecc.mode.pending: The ECC mode that the GPU will operate under after the next reboot.
retired_pages.pending: Checks if any GPU device memory pages are pending retirement
on the next reboot. Pages that are pending retirement can still be allocated, and may
cause further reliability issues.
driver_model.pending: The driver model that will be used on the next reboot. Always
"N/A" on Linux.