OS Manuals

/usr/bin/modprobe

Linux kernel module management utilities

From kmod 34.3-r0 (os), captured 2026-11-05 by running modprobe --help (exit 0). permalink

Usage:
	modprobe [options] [-i] [-b] modulename
	modprobe [options] -a [-i] [-b] modulename [modulename...]
	modprobe [options] -r [-i] modulename
	modprobe [options] -r -a [-i] modulename [modulename...]
	modprobe [options] -c
	modprobe [options] --dump-modversions filename
Management Options:
	-a, --all                   Consider every non-argument to
	                            be a module name to be inserted
	                            or removed (-r)
	-r, --remove                Remove modules instead of inserting
	    --remove-dependencies   Deprecated: use --remove-holders
	    --remove-holders        Also remove module holders (use together with -r)
	-w, --wait=<MSEC>           When removing a module, wait up to MSEC for
	                            module's refcount to become 0 so it can be
	                            removed (use together with -r)
	    --first-time            Fail if module already inserted or removed
	-i, --ignore-install        Ignore install commands
	-i, --ignore-remove         Ignore remove commands
	-b, --use-blacklist         Apply blacklist to resolved alias.
	-f, --force                 Force module insertion or removal.
	                            implies --force-modversions and
	                            --force-vermagic
	    --force-modversion      Ignore module's version
	    --force-vermagic        Ignore module's version magic

Query Options:
	-R, --resolve-alias         Only lookup and print alias and exit
	-D, --show-depends          Only print module dependencies and exit
	-c, --showconfig            Print out known configuration and exit
	-c, --show-config           Same as --showconfig
	    --show-modversions      Dump module symbol version and exit
	    --dump-modversions      Same as --show-modversions
	    --show-exports          Only print module exported symbol versions and exit

General Options:
	-n, --dry-run               Do not execute operations, just print out
	-n, --show                  Same as --dry-run
	-C, --config=FILE           Use FILE instead of default search paths
	-d, --dirname=DIR           Use DIR as filesystem root for /lib/modules
	-S, --set-version=VERSION   Use VERSION instead of `uname -r`
	-s, --syslog                print to syslog, not stderr
	-q, --quiet                 disable messages
	-v, --verbose               enables more messages
	-V, --version               show version
	-h, --help                  show this help
Options (26)
OptionDescriptionSource
-a, --allConsider every non-argument to be a module name to be inserted or removed (-r)help + man
-r, --removeThis option causes modprobe to remove rather than insert a module.help + man
--remove-dependenciesDeprecated: use --remove-holdershelp
--remove-holdersThis option causes modprobe to remove the mentioned module(s), alongside other modules that depend on it/them - aka the reverse dependency list.help + man
-w, --wait MSECThis option causes modprobe -r to continue trying to remove a module if it fails due to the module being busy, i.e. its refcount is not 0 at the time the call is made.help + man
--first-timeNormally, modprobe will succeed (and do nothing) if told to insert a module which is already present or to remove a module which isn't present.help + man
-i, --ignore-install, --ignore-removeThis option causes modprobe to ignore install and remove commands in the configuration file (if any) for the module specified on the command line (any dependent modules are still subject to commands…help + man
-b, --use-blacklistThis option causes modprobe to apply the blacklist commands in the configuration files (if any) to module names as well.help + man
-f, --forceTry to strip any versioning information from the module which might otherwise stop it from loading: this is the same as using both --force-vermagic and --force-modversion.help + man
--force-modversionWhen modules are compiled with CONFIG_MODVERSIONS set, a section detailing the versions of every interfaced used by (or supplied by) the module is created.help + man
--force-vermagicEvery module contains a small string containing important information, such as the kernel and compiler versions.help + man
-R, --resolve-aliasPrint all module names matching an alias.help + man
-D, --show-dependsList the dependencies of a module (or alias), including the module itself.help + man
-c, --showconfigDump out the effective configuration from the config directory and exit.help + man
--show-modversionsDump module symbol version and exithelp
--dump-modversionsPrint out a list of module versioning information required by a module.help + man
--show-exportsOnly print module exported symbol versions and exithelp + man
-n, --dry-run, --showThis option does everything but actually insert or delete the modules (or run the install or remove commands).help + man
-C, --config FILEThis option overrides the default configuration directory.help + man
-d, --dirname DIRUse DIR as filesystem root for /lib/moduleshelp + man
-S, --set-version VERSIONSet the kernel version, rather than using uname(2) to decide on the kernel version (which dictates where to find the modules).help + man
-s, --syslogThis option causes any error messages to go through the syslog mechanism (as LOG_DAEMON with level LOG_NOTICE) rather than to standard error.help + man
-q, --quietWith this flag, modprobe won't print an error message if you try to remove or insert a module it can't find (and isn't an alias or install/remove command).help + man
-v, --verbosePrint messages about what the program is doing.help + man
-V, --versionShow version of program and exit.help + man
-h, --helpshow this helphelp

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