nvidia-container-toolkit/cmd/nvidia-cdi-hook
Evan Lezar 39975fc77b
[no-relnote] Refactor ldconfig hooks
Signed-off-by: Evan Lezar <elezar@nvidia.com>
2025-06-24 13:53:20 +02:00
..
chmod
commands Add create-soname-symlinks hook 2025-06-24 13:49:24 +02:00
create-soname-symlinks [no-relnote] Refactor ldconfig hooks 2025-06-24 13:53:20 +02:00
create-symlinks
cudacompat
disable-device-node-modification Add a hook to disable device node creation in a container 2025-06-04 19:08:48 +02:00
update-ldcache [no-relnote] Refactor ldconfig hooks 2025-06-24 13:53:20 +02:00
main.go Add envvar to control debug logging in CDI hooks 2025-05-30 15:27:52 +02:00
README.md

NVIDIA CDI Hook

The CLI nvidia-cdi-hook provides container device runtime hook capabilities when called by a container runtime, as specific in a Container Device Interface file.

Generating a CDI

The CDI itself is created for an NVIDIA-capable device using the nvidia-ctk cdi generate command.

When nvidia-ctk cdi generate is run, the CDI specification is generated as a yaml file. The CDI specification provides instructions for a container runtime to set up devices, files and other resources for the container prior to starting it. Those instructions may include executing command-line tools to prepare the filesystem. The execution of such command-line tools is called a hook.

nvidia-cdi-hook is the CLI tool that is expected to be called by the container runtime, when specified by the CDI file.

See the nvidia-ctk documentation for more information on generating a CDI file.

Functionality

The nvidia-cdi-hook CLI provides the following functionality:

  • chmod - Change the permissions of a file or directory inside the directory path to be mounted into a container.
  • create-symlinks - Create symlinks inside the directory path to be mounted into a container.
  • update-ldcache - Update the dynamic linker cache inside the directory path to be mounted into a container.