windows的NVSMI包

操作系统

1.3MB

23 需要积分: 1

立即下载

资源介绍:

windows的NVSMI包

nvidia−smi(1) NVIDIA nvidia−smi(1)

NAME

nvidia−smi − NVIDIA System Management Interface program

SYNOPSIS

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

DESCRIPTION

nvidia-smi (also NVSMI) provides monitoring and management capabilities for each of NVIDIA's Tesla,

Quadro, GRID and GeForce devices from Fermi and higher architecture families. GeForce Titan series

devices are supported for most functions with very limited information provided for the remainder of the

Geforce brand. NVSMI is a cross platform tool that supports all standard NVIDIA driver-supported Linux

distros, as well as 64bit versions of Windows starting with Windows Server 2008 R2. Metrics can be con-

sumed directly by users via stdout, or provided by ﬁle via CSV and XML formats for scripting purposes.

Note that much of the functionality of NVSMI is provided by the underlying NVML C-based library.See

the NVIDIA developer website link belowfor more information about NVML. NVML-based python bind-

ings are also available.

The output of NVSMI is not guaranteed to be backwards compatible. However, both NVML and the

Python bindings are backwards compatible, and should be the ﬁrst choice when writing anytools that must

be maintained across NVIDIA driverreleases.

NVML SDK: http://developer.nvidia.com/nvidia-management-library-nvml/

Python bindings: http://pypi.python.org/pypi/nvidia-ml-py/

OPTIONS

GENERAL OPTIONS

−h, −−help

Print usage information and exit.

SUMMARYOPTIONS

−L, −−list−gpus

List each of the NVIDIA GPUs in the system, along with their UUIDs.

QUERYOPTIONS

−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. Anyunsupported data is indicated by a "N/A" in the output. By default information for all

available GPUs or 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 speciﬁed GPU or Unit. The speciﬁed id may be the GPU/Unit's 0−based indexin

the natural enumeration returned by the driver, the GPU's board serial number,the GPU's UUID, or the

GPU's PCI bus ID (as domain:bus:device.function in hex). It is recommended that users desiring consis-

tencyuse either UUID or PCI bus ID, since device enumeration ordering is not guaranteed to be consistent

between reboots and board serial number might be shared between multiple GPUs on the same board.

nvidia−smi 387.12 2017/10/3 1

nvidia−smi(1) NVIDIA nvidia−smi(1)

−f FILE, −−ﬁlename=FILE

Redirect query output to the speciﬁed ﬁle in place of the default stdout. The speciﬁed ﬁle will be overwrit-

ten.

−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 ﬂag.

−−dtd

Use with −x.Embed the DTD in the XML output.

−−debug=FILE

Produces an encrypted debug log for use in submission of bugs back to NVIDIA.

−d TYPE, −−display=TYPE

Display only selected information: MEMORY, U TILIZATION, ECC, TEMPERATURE, POWER,

CLOCK, COMPUTE, PIDS, PERFORMANCE, SUPPORTED_CLOCKS, PAGE_RETIREMENT,

ACCOUNTING Flags can be combined with comma e.g. "MEMORY, ECC". Sampling data with max,

min and avg is also returned for POWER, UTILIZATION and CLOCK display types. Doesn't work with

-u/--unit or -x/--xml-format ﬂags.

−l SEC, −−loop=SEC

Continuously report query data at the speciﬁed interval, rather than the default of just once. The applica-

tion will sleep in−between queries. Note that on Linux ECC error or XID error events will print out during

the sleep period if the -x ﬂag was not speciﬁed. Pressing Ctrl+C at anytime will abort the loop, which will

otherwise run indeﬁnitely.Ifnoargument is speciﬁed for the −l form a default interval of 5 seconds is

used.

SELECTIVE QUERYOPTIONS

Allows the caller to pass an explicit list of properties to query.

[one of]

−−query−gpu=

Information about GPU. Pass comma separated list of properties you want to query.e.g.

−−query−gpu=pci.bus_id,persistence_mode. Call −−help−query−gpu for more info.

−−query−supported−clocks=

List of supported clocks. Call −−help−query−supported−clocks for more info.

−−query−compute−apps=

List of currently active compute processes. Call −−help−query−compute−apps for more info.

−−query−accounted−apps=

List of accounted compute processes. Call −−help−query−accounted−apps for more info.

−−query−retired−pages=

List of GPU device memory pages that have been retired. Call −−help−query−retired−pages for more info.

nvidia−smi 387.12 2017/10/3 2

nvidia−smi(1) NVIDIA nvidia−smi(1)

[mandatory]

−−format=

Comma separated list of format options:

• csv - comma separated values (MANDAT O RY)

• noheader - skip ﬁrst line with column headers

• nounits - don’tprint units for numerical values

[plus any of]

−i, −−id=ID

Display data for a single speciﬁed GPU. The speciﬁed id may be the GPU's 0−based indexinthe natural

enumeration returned by the driver, the GPU's board serial number,the GPU's UUID, or the GPU's PCI bus

ID (as domain:bus:device.function in hex). It is recommended that users desiring consistencyuse either

UUID or PCI bus ID, since device enumeration ordering is not guaranteed to be consistent between reboots

and board serial number might be shared between multiple GPUs on the same board.

−f FILE, −−ﬁlename=FILE

Redirect query output to the speciﬁed ﬁle in place of the default stdout. The speciﬁed ﬁle will be overwrit-

ten.

−l SEC, −−loop=SEC

Continuously report query data at the speciﬁed interval, rather than the default of just once. The applica-

tion will sleep in−between queries. Note that on Linux ECC error or XID error events will print out during

the sleep period if the -x ﬂag was not speciﬁed. Pressing Ctrl+C at anytime will abort the loop, which will

otherwise run indeﬁnitely.Ifnoargument is speciﬁed for the −l form a default interval of 5 seconds is

used.

−lms ms, −−loop−ms=ms

Same as −l,−−loop but in milliseconds.

DEVICE MODIFICATION OPTIONS

[any one of]

−pm, −−persistence−mode=MODE

Set the persistence mode for the target GPUs. See the (GPU ATTRIBUTES)section for a description of

persistence mode. Requires root. Will impact all GPUs unless a single GPU is speciﬁed using the −i argu-

ment. The effect of this operation is immediate. However, itdoes not persist across reboots. After each

reboot persistence mode will default to "Disabled". Av a ilable on Linux only.

−e, −−ecc−conﬁg=CONFIG

Set the ECC mode for the target GPUs. See the (GPU ATTRIBUTES)section for a description of ECC

mode. Requires root. Will impact all GPUs unless a single GPU is speciﬁed using the −i argument. This

setting takes effect after the next reboot and is persistent.

−p, −−reset−ecc−errors=TYPE

Reset the ECC error counters for the target GPUs. See the (GPU ATTRIBUTES)section for a description

of ECC error counter types. Av a ilable arguments are 0|VOLATILE or 1|AGGREGATE. Requires root.

Will impact all GPUs unless a single GPU is speciﬁed using the −i argument. The effect of this operation

is immediate.

nvidia−smi 387.12 2017/10/3 3

nvidia−smi(1) NVIDIA nvidia−smi(1)

−c, −−compute−mode=MODE

Set the compute mode for the target GPUs. See the (GPU ATTRIBUTES)section for a description of com-

pute mode. Requires root. Will impact all GPUs unless a single GPU is speciﬁed using the −i argument.

The effect of this operation is immediate. However, itdoes not persist across reboots. After each reboot

compute mode will reset to "DEFAULT".

−dm TYPE, −−driver−model=TYPE

−fdm TYPE, −−force−driver−model=TYPE

Enable or disable TCC drivermodel. For Windows only.Requires administrator privileges. −dm will fail

if a display is attached, but −fdm will force the drivermodel to change. Will impact all GPUs unless a sin-

gle GPU is speciﬁed using the −i argument. A reboot is required for the change to takeplace. See Driver

Model for more information on Windows drivermodels.

−−gom=MODE

Set GPU Operation Mode: 0/ALL_ON, 1/COMPUTE, 2/LOW_DP Supported on GK110 M-class and X-

class Tesla products from the Kepler family.Not supported on Quadro and Tesla C-class products.

LOW_DP and ALL_ON are the only modes supported on GeForce Titan devices. Requires administrator

privileges. See GPU Operation Mode for more information about GOM. GOM changes takeeffect after

reboot. The reboot requirement might be removedinthe future. Compute only GOMs don’tsupport

WDDM (Windows Display DriverModel)

−r,−−gpu−reset

Trigger a reset of one or more GPUs. Can be used to clear GPU HW and SW state in situations that would

otherwise require a machine reboot. Typically useful if a double bit ECC error has occurred. Optional −i

switch can be used to target one or more speciﬁc devices. Without this option, all GPUs are reset.

Requires root. There can't be anyapplications using these devices (e.g. CUDAapplication, graphics appli-

cation likeXserver,monitoring application likeother instance of nvidia-smi). There also can't be anycom-

pute applications running on anyother GPU in the system.

When resetting GPUs that have active NVLink connections to other GPUs, all GPUs with active NVLink

connections must be reset together,either by omitting the −i switch or using the −i switch to specify all

GPUs with active NVLink connections.

GPU reset is not guaranteed to work in all cases. It is not recommended for production environments at this

time. In some situations there may be HW components on the board that fail to revert back to an initial

state following the reset request. This is more likely to be seen on Fermi-generation products vs. Kepler,

and more likely to be seen if the reset is being performed on a hung GPU.

Following a reset, it is recommended that the health of each reset GPU be veriﬁed before further use. The

nvidia-healthmon tool is a good choice for this test. If anyGPU is not healthyacomplete reset should be

instigated by power cycling the node.

Visit http://developer.nvidia.com/gpu-deployment-kit to download the GDK and nvidia-healthmon.

−ac, −−applications−clocks=MEM_CLOCK,GRAPHICS_CLOCK

Speciﬁes maximum <memory,graphics> clocks as a pair (e.g. 2000,800) that deﬁnes GPU’sspeed while

running applications on a GPU. Supported on Maxwell-based GeForce and from the Kepler+ family in

Tesla/Quadro/Titan devices. Requires root unless restrictions are relaxed with the −acp command..

−rac, −−reset−applications−clocks

Resets the applications clocks to the default value. Supported on Maxwell-based GeForce and from the

Kepler+ family in Tesla/Quadro/Titan devices. Requires root unless restrictions are relaxed with the −acp

nvidia−smi 387.12 2017/10/3 4

nvidia−smi(1) NVIDIA nvidia−smi(1)

command.

−acp, −−applications−clocks−permission=MODE

Toggle whether applications clocks can be changed by all users or only by root. Av ailable arguments are

0|UNRESTRICTED, 1|RESTRICTED. Supported on Maxwell-based GeForce and from the Kepler+ fam-

ily in Tesla/Quadro/Titan devices. Requires root.

−pl, −−power−limit=POWER_LIMIT

Speciﬁes maximum power limit in watts. Accepts integer and ﬂoating point numbers. Only on supported

devices from Kepler family.Requires administrator privileges. Value needs to be between Min and Max

Power Limit as reported by nvidia-smi.

−am, −−accounting−mode=MODE

Enables or disables GPU Accounting. With GPU Accounting one can keep track of usage of resources

throughout lifespan of a single process. Only on supported devices from Kepler family.Requires adminis-

trator privileges. Available arguments are 0|DISABLED or 1|ENABLED.

−caa, −−clear−accounted−apps

Clears all processes accounted so far.Only on supported devices from Kepler family.Requires administra-

tor privileges.

−−auto−boost−default=MODE

Set the default auto boost policyto0/DISABLED or 1/ENABLED, enforcing the change only after the last

boost client has exited. Only on certain Tesla devices from the Kepler+ family and Maxwell-based

GeForce devices. Requires root.

−−auto−boost−default−force=MODE

Set the default auto boost policyto0/DISABLED or 1/ENABLED, enforcing the change immediately.

Only on certain Tesla devices from the Kepler+ family and Maxwell-based GeForce devices. Requires

root.

−−auto−boost−permission=MODE

Allownon-admin/root control overauto boost mode. Av a ilable arguments are 0|UNRESTRICTED,

1|RESTRICTED. Only on certain Tesla devices from the Kepler+ family and Maxwell-based GeForce

devices. Requires root.

[plus optional]

−i, −−id=ID

Modify a single speciﬁed GPU. The speciﬁed id may be the GPU/Unit's 0−based indexinthe natural enu-

meration returned by the driver, the GPU's board serial number,the GPU's UUID, or the GPU's PCI bus ID

(as domain:bus:device.function in hex). It is recommended that users desiring consistencyuse either UUID

or PCI bus ID, since device enumeration ordering is not guaranteed to be consistent between reboots and

board serial number might be shared between multiple GPUs on the same board.

UNIT MODIFICATION OPTIONS

−t, −−toggle−led=STATE

Set the LED indicator state on the front and back of the unit to the speciﬁed color.See the (UNIT

ATTRIBUTES)section for a description of the LED states. Allowed colors are 0|GREEN and 1|AMBER.

Requires root.

nvidia−smi 387.12 2017/10/3 5

资源文件列表:

NVSMI.zip 大约有5个文件

MCU.exe 838.99KB
nvdebugdump.exe 414.95KB
nvidia-smi.1.pdf 99.63KB
nvidia-smi.exe 505.77KB
nvml.dll 901KB