OS Manuals

/usr/bin/nvidia-k8s-vgpu-dm

NVIDIA vGPU Device Manager lets administrators declaratively define a set of vGPU device configurations in a YAML file and apply one of them to every GPU on a node. It ships two Go binaries: nvidia-vgpu-dm, a CLI with 'apply' and 'assert' subcommands that creates or checks vGPU (mdev) devices on the host through the NVIDIA vGPU Manager, and nvidia-k8s-vgpu-dm, a Kubernetes per-node controller (DaemonSet, usually deployed by the NVIDIA GPU Operator). The controller watches the nvidia.com/vgpu.config node…

From vgpu-device-manager 0.5.1-r0 (enterprise-packages), captured 2026-11-08 by running nvidia-k8s-vgpu-dm --help (exit 0). permalink

Also provided by 1 other package version
time="2026-11-08T04:59:06Z" level=info msg="version: v0.5.1, commit: 90553f85de8836d6baddd84ca5ff6894f38813f4"
NAME:
   nvidia-k8s-vgpu-dm - A new cli application

USAGE:
   nvidia-k8s-vgpu-dm [global options] command [command options]

VERSION:
   v0.5.1, commit: 90553f85de8836d6baddd84ca5ff6894f38813f4

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

GLOBAL OPTIONS:
   --kubeconfig value                              absolute path to the kubeconfig file [$KUBECONFIG]
   --node-name value, -n value                     the name of the node to watch for label changes on [$NODE_NAME]
   --namespace value, --ns value                   the namespace in which the GPU components are deployed [$NAMESPACE]
   --config-file value, -f value                   the path to the vGPU configuration file [$CONFIG_FILE]
   --default-vgpu-config value, -d value           the default vGPU config to use if no label is set [$DEFAULT_VGPU_CONFIG]
   --host-root-mount value, -m value               container path where host root directory is mounted (default: "/host") [$HOST_ROOT_MOUNT]
   --host-mig-manager-state-file value, -o value   host path where the host's systemd mig-manager state file is located (default: "/etc/systemd/system/nvidia-mig-manager.service.d/override.conf") [$HOST_MIG_MANAGER_STATE_FILE]
   --host-kubelet-systemd-service value, -k value  name of the host's 'kubelet' systemd service which may need to be shutdown/restarted across a MIG mode reconfiguration (default: "kubelet.service") [$HOST_KUBELET_SYSTEMD_SERVICE]
   --driver-root-ctr-path value, -a value          root path to the NVIDIA driver installation mounted in the container (default: "/driver-root") [$DRIVER_ROOT_CTR_PATH]
   --gpu-clients-file value, -g value              the path to the file listing the GPU clients that need to be shutdown across a MIG configuration [$GPU_CLIENTS_FILE]
   --with-reboot, -r                               reboot the node if changing the MIG mode fails for any reason (default: false) [$WITH_REBOOT]
   --with-shutdown-host-gpu-clients, -w            shutdown/restart any required host GPU clients across a MIG configuration (default: false) [$WITH_SHUTDOWN_HOST_GPU_CLIENTS]
   --help, -h                                      show help
   --version, -v                                   print the version
Options (14)
OptionDescriptionSource
--kubeconfig valueabsolute path to the kubeconfig file [$KUBECONFIG]help
--node-name, -n valuethe name of the node to watch for label changes on [$NODE_NAME]help
--namespace, --ns valuethe namespace in which the GPU components are deployed [$NAMESPACE]help
--config-file, -f valuethe path to the vGPU configuration file [$CONFIG_FILE]help
--default-vgpu-config, -d valuethe default vGPU config to use if no label is set [$DEFAULT_VGPU_CONFIG]help
--host-root-mount, -m valuecontainer path where host root directory is mounted (default: "/host") [$HOST_ROOT_MOUNT]help
--host-mig-manager-state-file, -o valuehost path where the host's systemd mig-manager state file is located (default: "/etc/systemd/system/nvidia-mig-manager.service.d/override.conf") [$HOST_MIG_MANAGER_STATE_FILE]help
--host-kubelet-systemd-service, -k valuename of the host's 'kubelet' systemd service which may need to be shutdown/restarted across a MIG mode reconfiguration (default: "kubelet.service") [$HOST_KUBELET_SYSTEMD_SERVICE]help
--driver-root-ctr-path, -a valueroot path to the NVIDIA driver installation mounted in the container (default: "/driver-root") [$DRIVER_ROOT_CTR_PATH]help
--gpu-clients-file, -g valuethe path to the file listing the GPU clients that need to be shutdown across a MIG configuration [$GPU_CLIENTS_FILE]help
--with-reboot, -rreboot the node if changing the MIG mode fails for any reason (default: false) [$WITH_REBOOT]help
--with-shutdown-host-gpu-clients, -wshutdown/restart any required host GPU clients across a MIG configuration (default: false) [$WITH_SHUTDOWN_HOST_GPU_CLIENTS]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.