| 1 |
.\" Generated by scdoc 1.11.4 |
| 2 |
.\" Complete documentation for this program is not available as a GNU info page |
| 3 |
.ie \n(.g .ds Aq \(aq |
| 4 |
.el .ds Aq ' |
| 5 |
.nh |
| 6 |
.ad l |
| 7 |
.\" Begin generated content: |
| 8 |
.TH "RMMOD" "8" "2026-04-26" "kmod" "rmmod" |
| 9 |
.PP |
| 10 |
.SH NAME |
| 11 |
.PP |
| 12 |
rmmod - Simple program to remove a module from the Linux Kernel |
| 13 |
.PP |
| 14 |
.SH SYNOPSIS |
| 15 |
.PP |
| 16 |
\fBrmmod\fR [\fIOPTIONS\fR] [\fIlist of modulenames\fR] |
| 17 |
.PP |
| 18 |
.SH DESCRIPTION |
| 19 |
.PP |
| 20 |
\fBrmmod\fR is a trivial program to remove a module or a list of modules from the |
| 21 |
kernel (when module unloading support is provided).\& Most users will want to use |
| 22 |
\fBmodprobe\fR(8) with the \fB-r\fR option instead since it removes unused dependent |
| 23 |
modules as well.\& |
| 24 |
.PP |
| 25 |
When a list of modules is provided, the program will process them one at a time.\& |
| 26 |
If a module is not found, \fBrmmod\fR will immediately exit with an error code.\& |
| 27 |
Should the module removal fail, the program will log an error AND continue with |
| 28 |
the next module.\& This behaviour is NOT controlled by the \fB--force\fR option.\& |
| 29 |
.PP |
| 30 |
.SH OPTIONS |
| 31 |
.PP |
| 32 |
\fB-f\fR, \fB--force\fR |
| 33 |
.RS 4 |
| 34 |
This option can be extremely dangerous: it has no effect unless |
| 35 |
CONFIG_MODULE_FORCE_UNLOAD was set when the kernel was compiled.\& With |
| 36 |
this option, you can remove modules which are being used, or which are |
| 37 |
not designed to be removed, or have been marked as unsafe (see \fBlsmod\fR(8)).\& |
| 38 |
.PP |
| 39 |
.RE |
| 40 |
\fB-s\fR, \fB--syslog\fR |
| 41 |
.RS 4 |
| 42 |
Send errors to syslog instead of standard error.\& |
| 43 |
.PP |
| 44 |
.RE |
| 45 |
\fB-v\fR, \fB--verbose\fR |
| 46 |
.RS 4 |
| 47 |
Print messages about what the program is doing.\& Usually \fBrmmod\fR prints |
| 48 |
messages only if something goes wrong.\& |
| 49 |
.PP |
| 50 |
.RE |
| 51 |
\fB-V\fR, \fB--version\fR |
| 52 |
.RS 4 |
| 53 |
Show version of program and exit.\& |
| 54 |
.PP |
| 55 |
.RE |
| 56 |
\fB-h\fR, \fB--help\fR |
| 57 |
.RS 4 |
| 58 |
Print the help message and exit.\& |
| 59 |
.PP |
| 60 |
.RE |
| 61 |
.SH COPYRIGHT |
| 62 |
.PP |
| 63 |
This manual page originally Copyright 2002, Rusty Russell, IBM Corporation.\& |
| 64 |
.PP |
| 65 |
.SH SEE ALSO |
| 66 |
.PP |
| 67 |
\fBmodprobe\fR(8), \fBinsmod\fR(8), \fBlsmod\fR(8), \fBmodinfo\fR(8), \fBdepmod\fR(8) |
| 68 |
.PP |
| 69 |
.SH BUGS |
| 70 |
.PP |
| 71 |
Please direct any bug reports to kmod'\&s issue tracker at |
| 72 |
https://github.\&com/kmod-project/kmod/issues/ alongside with version used, steps |
| 73 |
to reproduce the problem and the expected outcome.\& |
| 74 |
.PP |
| 75 |
.SH AUTHORS |
| 76 |
.PP |
| 77 |
Numerous contributions have come from the linux-modules mailing list |
| 78 |
<linux-modules@vger.\&kernel.\&org> and Github.\& If you have a clone of kmod.\&git |
| 79 |
itself, the output of \fBgit-shortlog\fR(1) and \fBgit-blame\fR(1) can show you the |
| 80 |
authors for specific parts of the project.\& |
| 81 |
.PP |
| 82 |
\fBLucas De Marchi\fR <lucas.\&de.\&marchi@gmail.\&com> is the current maintainer of the |
| 83 |
project.\& |