NAME

       nvidia-modprobe - Load the NVIDIA kernel module and create NVIDIA character device files.

SYNOPSIS

       nvidia-modprobe [options]
       nvidia-modprobe [options] --create-nvidia-device-file=MINOR-NUMBER
       nvidia-modprobe [options] --module-instance=MODULE-INSTANCE

DESCRIPTION

       The nvidia-modprobe utility is used by user-space NVIDIA driver components to make sure the NVIDIA kernel
       module is loaded, the NVIDIA character device files are present and configure certain runtime settings in
       the  kernel.   These facilities are normally provided by Linux distribution configuration systems such as
       udev.  When possible, it is recommended to use your Linux distribution's native mechanisms  for  managing
       kernel module loading, device file creation and kernel runtime config settings.  This utility is provided
       as a fallback to work out-of-the-box in a distribution-independent way.

       When installed by nvidia-installer , nvidia-modprobe is installed setuid root.

       Users  should  not  normally need to run nvidia-modprobe by hand: the NVIDIA user-space driver components
       will fork(2)/exec(3) it when needed.

       When run without any options, nvidia-modprobe will load the NVIDIA kernel module and then exit. When  the
       --module-instance  option  is  specified  on systems with multiple NVIDIA kernel modules, nvidia-modprobe
       will load the corresponding NVIDIA kernel module and  then  exit.  When  the  --create-nvidia-device-file
       option is specified, nvidia-modprobe will also create the requested device file.

       The source code to nvidia-modprobe is available here: ⟨https://download.nvidia.com/XFree86/
       nvidia-modprobe/⟩

OPTIONS

       -v, --version
              Print the utility version and exit.

       -h, --help
              Print usage information for the command line options and exit.

       -c MINOR-NUMBER, --create-nvidia-device-file=MINOR-NUMBER
              Create  the  NVIDIA device file with the given minor number; this option can be specified multiple
              times to create multiple NVIDIA device files.

ADVANCED OPTIONS

       -u, --unified-memory
              Load the NVIDIA Unified Memory kernel module or create device files for it, instead of the  NVIDIA
              kernel module.

       -m, --modeset
              Load the NVIDIA modeset kernel module and create its device file.

       -s, --nvswitch
              Load the NVIDIA kernel module and create the NVSwitch device files for each minor number specified
              using the -c flag.

       -l, --nvlink
              Load the NVIDIA kernel module and create the NVLink control device file.

       -f NVIDIA-CAPABILITY-DEVICE-FILE, --nvidia-capability-device-file=NVIDIA-CAPABILITY-DEVICE-FILE
              Create  the  NVIDIA capability device files with the given capability /proc file path. This option
              can be specified multiple times to create multiple NVIDIA capability device files.

       -i NVIDIA-IMEX-CHANNEL-DEVICE-FILE, --nvidia-imex-channel-device-file=NVIDIA-IMEX-CHANNEL-DEVICE-FILE
              Create the NVIDIA IMEX channel device files for the given minor number range format  <start:number
              of minors>

       -a, --auto-online-movable
              Enable  the online_movable auto onlining kernel setting for platforms (like Grace Hopper) that add
              and online GPU memory to the kernel

EXAMPLES

       nvidia-modprobe
              Run `/sbin/modprobe nvidia`

       nvidia-modprobe -c 0 -c 1
              Run `/sbin/modprobe nvidia` and create /dev/nvidia0 and /dev/nvidia1

       nvidia-modprobe -i 0
              Run `/sbin/modprobe nvidia0`

AUTHOR

       Andy Ritger
       NVIDIA Corporation

COPYRIGHT

       Copyright © 2013 NVIDIA Corporation.

nvidia-modprobe 550.78                             2024-05-23                                 nvidia-modprobe(1)