.\" Copyright (C) 2005-2010 NVIDIA Corporation.
.\"
.\" WARNING: THIS FILE IS AUTO-GENERATED!  Edit nvidia-modprobe.1.m4 instead.
.\" Define the .URL macro and then override it with the www.tmac package if it
.\" exists.
.de URL
\\$2 \(la \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.TH nvidia\-modprobe 1 "2019-05-07" "nvidia\-modprobe 418.56"

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

.SH SYNOPSIS
.BI "nvidia\-modprobe [" "options" "]"
.br
.BI "nvidia\-modprobe [" "options" "] \-\-create\-nvidia\-device\-file=" MINOR-NUMBER "
.br
.BI "nvidia\-modprobe [" "options" "] \-\-module\-instance=" MODULE-INSTANCE "
.br

.SH DESCRIPTION
The
.B nvidia\-modprobe
utility is used by user-space NVIDIA driver components to make sure the NVIDIA kernel module is loaded and that the NVIDIA character device files are present.  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 and device file creation.  This utility is provided as a fallback to work out-of-the-box in a distribution-independent way.
.PP
When installed
.B by nvidia\-installer
,
.B nvidia\-modprobe
is installed setuid root.
.PP
Users should not normally need to run
.B nvidia\-modprobe
by hand: the NVIDIA user-space driver components will fork(2)/exec(3) it when needed.
.PP
When run without any options,
.B nvidia\-modprobe
will load the NVIDIA kernel module and then exit. When the
.B \-\-module\-instance
option is specified on systems with multiple NVIDIA kernel modules,
.B nvidia\-modprobe
will load the corresponding NVIDIA kernel module and then exit. When the
.B \-\-create\-nvidia\-device\-file
option is specified,
.B nvidia\-modprobe
will also create the requested device file.

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

.SH OPTIONS
.TP
.BI "\-v, \-\-version"
Print the utility version and exit.
.TP
.BI "\-h, \-\-help"
Print usage information for the command line options and exit.
.TP
.BI "\-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.
.TP
.BI "\-i " "MODULE-INSTANCE" ", \-\-module-instance=" "MODULE-INSTANCE"
Load the required NVIDIA kernel module that corresponds to the specified 
.I MODULE\-INSTANCE
value. The value should be between 0 and 7.
.SH "ADVANCED OPTIONS"
.TP
.BI "\-u, \-\-unified-memory"
Load the NVIDIA Unified Memory kernel module or create device files for it, instead of the NVIDIA kernel module.
.TP
.BI "\-m, \-\-modeset"
Load the NVIDIA modeset kernel module and create its device file.

.SH EXAMPLES
.TP
.B nvidia\-modprobe
Run `/sbin/modprobe nvidia`
.TP
.B nvidia\-modprobe -c 0 -c 1
Run `/sbin/modprobe nvidia` and create
.I
/dev/nvidia0
and
.I
/dev/nvidia1
.TP
.B nvidia\-modprobe -i 0
Run `/sbin/modprobe nvidia0`
.

.SH AUTHOR
Andy Ritger
.br
NVIDIA Corporation

.SH COPYRIGHT
Copyright \(co 2013 NVIDIA Corporation.