RMMOD(8)
๐ RMMOD โ bestie's guide to yeeting kernel modules โจ
okay so welcome to rmmod(8), the manual page for the icon herself: rmmod. she's from the kmod family, she lives in section 8 (system admin things), and her whole job is unplugging modules from your Linux kernel. let's get into it ๐ซถ
๐ธ NAME ๐ธ
rmmod โ a simple lil program to remove a module from the Linux Kernel. that's the whole vibe. no cap. ๐
โจ SYNOPSIS โจ
rmmod [OPTIONS] [list of modulenames]
yes bestie, she takes options and a whole guest list of module names. multitasking queen ๐
๐ฆ DESCRIPTION ๐ฆ
okay so rmmod is a trivial program โ and I mean that affectionately โ that removes a module, or a list of modules, from the kernel. that is, when module unloading support is provided. (if it's not, that's a whole other situation, and it's giving "not today" ๐ญ)
lowkey though? most users are gonna want modprobe(8) with the -r option instead, because that one removes unused dependent modules too. like, it does the extra credit. rmmod is the girl who does exactly the assignment and nothing more. respect. ๐
when you hand her a list of modules, she processes them one at a time. and here's the important part, so listen up:
- if a module is not found,
rmmodwill immediately exit with an error code. like, she's done. she's leaving. - if the module removal fails, the program will log an error AND continue with the next module. so she's upset but she's still showing up. ๐
and the biggest plot twist: this behaviour is NOT controlled by the --force option. that's right. --force does not touch this. periodt.
๐ OPTIONS ๐
-f,--forceโ this option can be extremely dangerous bestie, like I'm not being dramatic. it has no effect unlessCONFIG_MODULE_FORCE_UNLOADwas set when the kernel was compiled. with this option you can remove modules which are being used, or which were not designed to be removed, or which have been marked as unsafe (peeplsmod(8)for that). this is the "I know a shortcut" option and the shortcut is a cliff. be careful. ๐-s,--syslogโ sends errors to syslog instead of standard error. so when things go wrong, the message goes somewhere else. mysterious. โจ-v,--verboseโ prints messages about what the program is doing. usuallyrmmodonly speaks up if something goes wrong, so this is her talkative era. ๐-V,--versionโ show the version of the program and exit. quick lil flex. ๐-h,--helpโ print the help message and exit. your girl always has a cheat sheet. ๐
๐ COPYRIGHT ๐
this manual page is originally Copyright 2002, Rusty Russell, IBM Corporation. legends only. ๐ซถ
๐ SEE ALSO ๐
go read these too, they're the friend group:
๐ BUGS ๐
found a bug? please direct any bug reports to kmod's issue tracker at https://github.com/kmod-project/kmod/issues/ โ and bring receipts bestie:
- the version used
- steps to reproduce the problem
- the expected outcome
that's the whole trio. don't leave one out, I'm begging ๐ญ
๐ AUTHORS ๐
numerous contributions have come from the linux-modules mailing list <linux-modules@vger.kernel.org> and Github. it's giving community effort. ๐ฆ
if you have a clone of kmod.git itself, the output of git-shortlog(1) and git-blame(1) can show you the authors for specific parts of the project. detective work, but make it git. ๐
Lucas De Marchi <lucas.de.marchi@gmail.com> is the current maintainer of the project. main character energy, honestly. ๐
okay that's the whole page, you ate that ๐
this was kmod, 2026-10-30, RMMOD(8) โ now go unload something responsibly, bestie ๐ธโจ
๐ฆ where this page comes from
- arch rolling: kmod 34.3-1 ยท LGPL-2.1-or-later AND GPL-2.0-or-later
- ๐ girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms