OS Manuals

/usr/bin/nvidia-device-plugin

NVIDIA device plugin for Kubernetes

From nvidia-device-plugin-fips 0.20.1-r4 (enterprise-packages), captured 2026-11-08 by running nvidia-device-plugin --help (exit 0). permalink

NAME:
   NVIDIA Device Plugin - NVIDIA device plugin for Kubernetes

USAGE:
   NVIDIA Device Plugin [global options] command [command options]

VERSION:
   v0.20.1
commit: 487d7a93894b0f3ad08097169593972eb3ca8206-dirty

COMMANDS:
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --mig-strategy value                                           the desired strategy for exposing MIG devices on GPUs that support it:
                                                                    [none | single | mixed] (default: "none") [$MIG_STRATEGY]
   --fail-on-init-error                                           fail the plugin if an error is encountered during initialization, otherwise block indefinitely (default: true) [$FAIL_ON_INIT_ERROR]
   --driver-root value, --nvidia-driver-root value                the root path for the NVIDIA driver installation on the host (typical values are '/' or '/run/nvidia/driver') (default: "/") [$NVIDIA_DRIVER_ROOT]
   --dev-root value, --nvidia-dev-root value                      the root path for the NVIDIA device nodes on the host (typical values are '/' or '/run/nvidia/driver') [$NVIDIA_DEV_ROOT]
   --pass-device-specs                                            pass the list of DeviceSpecs to the kubelet on Allocate() (default: false) [$PASS_DEVICE_SPECS]
   --device-list-strategy value [ --device-list-strategy value ]  the desired strategy for passing the device list to the underlying runtime:
                                                                    [envvar | volume-mounts | cdi-annotations] (default: "envvar") [$DEVICE_LIST_STRATEGY]
   --device-id-strategy value                                     the desired strategy for passing device IDs to the underlying runtime:
                                                                    [uuid | index] (default: "uuid") [$DEVICE_ID_STRATEGY]
   --gdrcopy-enabled                                              ensure that containers that request NVIDIA GPU resources are started with GDRCopy support (default: false) [$GDRCOPY_ENABLED]
   --gds-enabled                                                  ensure that containers that request NVIDIA GPU resources are started with GPUDirect Storage support (default: false) [$GDS_ENABLED]
   --mofed-enabled                                                ensure that containers that request NVIDIA GPU resources are started with MOFED support (default: false) [$MOFED_ENABLED]
   --cdi-annotation-prefix value                                  the prefix to use for CDI container annotation keys (default: "cdi.k8s.io/") [$CDI_ANNOTATION_PREFIX]
   --nvidia-cdi-hook-path value, --nvidia-ctk-path value          the path to use for NVIDIA CDI hooks in the generated CDI specification (default: "/usr/bin/nvidia-ctk") [$NVIDIA_CDI_HOOK_PATH, $NVIDIA_CTK_PATH]
   --driver-root-ctr-path value, --container-driver-root value    the path where the NVIDIA driver root is mounted in the container; used for generating CDI specifications (default: "/driver-root") [$DRIVER_ROOT_CTR_PATH, $CONTAINER_DRIVER_ROOT]
   --mps-root value                                               the path on the host where MPS-specific mounts and files are created by the MPS control daemon manager [$MPS_ROOT]
   --shared-devices-allocation-policy value                       the allocation policy for replicated and MIG resources:
                                                                    [distributed | packed] (default: "distributed") [$SHARED_DEVICES_ALLOCATION_POLICY]
   --device-discovery-strategy value                              the strategy to use to discover devices: 'auto', 'nvml', or 'tegra' (default: "auto") [$DEVICE_DISCOVERY_STRATEGY]
   --imex-channel-ids value [ --imex-channel-ids value ]          A list of IMEX channels to inject. [$IMEX_CHANNEL_IDS]
   --imex-required                                                The specified IMEX channels are required (default: false) [$IMEX_REQUIRED]
   --kubelet-socket value                                         specify the socket for communicating with the kubelet; if this is empty, no connection with the kubelet is attempted (default: "/var/lib/kubelet/device-plugins/kubelet.sock") [$KUBELET_SOCKET]
   --config-file value                                            the path to a config file as an alternative to command line options or environment variables [$CONFIG_FILE]
   --cdi-feature-flags value [ --cdi-feature-flags value ]        A set of feature flags to be passed to the CDI spec generation logic [$CDI_FEATURE_FLAGS]
   --cdi-disable-hooks value [ --cdi-disable-hooks value ]        A set of OCI hooks to disable when generating CDI specifications; if the value 'all' is specified, then the CDI specification will exclude all OCI hooks. [$CDI_DISABLE_HOOKS]
   --help, -h                                                     show help
   --version, -v                                                  print the version
Options (24)
OptionDescriptionSource
--mig-strategy valuethe desired strategy for exposing MIG devices on GPUs that support it: [none | single | mixed] (default: "none") [$MIG_STRATEGY]help
--fail-on-init-errorfail the plugin if an error is encountered during initialization, otherwise block indefinitely (default: true) [$FAIL_ON_INIT_ERROR]help
--driver-root, --nvidia-driver-root valuethe root path for the NVIDIA driver installation on the host (typical values are '/' or '/run/nvidia/driver') (default: "/") [$NVIDIA_DRIVER_ROOT]help
--dev-root, --nvidia-dev-root valuethe root path for the NVIDIA device nodes on the host (typical values are '/' or '/run/nvidia/driver') [$NVIDIA_DEV_ROOT]help
--pass-device-specspass the list of DeviceSpecs to the kubelet on Allocate() (default: false) [$PASS_DEVICE_SPECS]help
--device-list-strategy valuethe desired strategy for passing the device list to the underlying runtime: [envvar | volume-mounts | cdi-annotations] (default: "envvar") [$DEVICE_LIST_STRATEGY]help
--device-id-strategy valuethe desired strategy for passing device IDs to the underlying runtime: [uuid | index] (default: "uuid") [$DEVICE_ID_STRATEGY]help
--gdrcopy-enabledensure that containers that request NVIDIA GPU resources are started with GDRCopy support (default: false) [$GDRCOPY_ENABLED]help
--gds-enabledensure that containers that request NVIDIA GPU resources are started with GPUDirect Storage support (default: false) [$GDS_ENABLED]help
--mofed-enabledensure that containers that request NVIDIA GPU resources are started with MOFED support (default: false) [$MOFED_ENABLED]help
--cdi-annotation-prefix valuethe prefix to use for CDI container annotation keys (default: "cdi.k8s.io/") [$CDI_ANNOTATION_PREFIX]help
--nvidia-cdi-hook-path, --nvidia-ctk-path valuethe path to use for NVIDIA CDI hooks in the generated CDI specification (default: "/usr/bin/nvidia-ctk") [$NVIDIA_CDI_HOOK_PATH, $NVIDIA_CTK_PATH]help
--driver-root-ctr-path, --container-driver-root valuethe path where the NVIDIA driver root is mounted in the container;help
--mps-root valuethe path on the host where MPS-specific mounts and files are created by the MPS control daemon manager [$MPS_ROOT]help
--shared-devices-allocation-policy valuethe allocation policy for replicated and MIG resources: [distributed | packed] (default: "distributed") [$SHARED_DEVICES_ALLOCATION_POLICY]help
--device-discovery-strategy valuethe strategy to use to discover devices: 'auto', 'nvml', or 'tegra' (default: "auto") [$DEVICE_DISCOVERY_STRATEGY]help
--imex-channel-ids valueA list of IMEX channels to inject.help
--imex-requiredThe specified IMEX channels are required (default: false) [$IMEX_REQUIRED]help
--kubelet-socket valuespecify the socket for communicating with the kubelet;help
--config-file valuethe path to a config file as an alternative to command line options or environment variables [$CONFIG_FILE]help
--cdi-feature-flags valueA set of feature flags to be passed to the CDI spec generation logic [$CDI_FEATURE_FLAGS]help
--cdi-disable-hooks valueA set of OCI hooks to disable when generating CDI specifications;help
--help, -hshow helphelp
--version, -vprint the versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.