Debian Codegraph @

upstream/debian-unstable/man8/rmmod.8

raw
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.\&