[Summary view] [Print] [Text view]

   1  .\" This manpage has been automatically generated by docbook2man 
   2  .\" from a DocBook document.  This tool can be found at:
   3  .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
   4  .\" Please send any bug reports, improvements, comments, patches, 
   5  .\" etc. to Steve Cheng <steve@ggi-project.org>.
   6  .TH "RMMOD" "8" "13 October 2008" "" ""
   7  
   8  .SH NAME
   9  rmmod \- simple program to remove a module from the Linux Kernel
  10  .SH SYNOPSIS
  11  
  12  \fBrmmod\fR [ \fB-f\fR ] [ \fB-w\fR ] [ \fB-s\fR ] [ \fB-v\fR ] [ \fB\fImodulename\fB\fR ]
  13  
  14  .SH "DESCRIPTION"
  15  .PP
  16  \fBrmmod\fR is a trivial program to remove a
  17  module from the kernel.  Most users will want to use
  18  \fBmodprobe\fR(8) instead, with the \fB-r\fR option.
  19  .SH "OPTIONS"
  20  .TP
  21  \fB-v --verbose \fR
  22  Print messages about what the program is doing.
  23  Usually \fBrmmod\fR only prints messages
  24  if something goes wrong.
  25  .TP
  26  \fB-f --force \fR
  27  This option can be extremely dangerous: it has no effect unless
  28  CONFIG_MODULE_FORCE_UNLOAD was set when the kernel was
  29  compiled.  With this option, you can remove modules which are
  30  being used, or which are not designed to be removed, or have
  31  been marked as unsafe (see \fBlsmod\fR(8)).
  32  .TP
  33  \fB-w --wait \fR
  34  Normally, \fBrmmod\fR will refuse to
  35  unload modules which are in use.  With this option,
  36  \fBrmmod\fR will isolate the module, and
  37  wait until the module is no longer used.  Noone new
  38  will be able to use the module, but it's up to you to
  39  make sure the current users eventually finish with it.
  40  See \fBlsmod\fR(8)) for information on usage counts.
  41  .TP
  42  \fB-s --syslog \fR
  43  Send errors to the syslog, instead of standard error.
  44  .TP
  45  \fB-V --version \fR
  46  Show version of program, and exit.  See below for caveats
  47  when run on older kernels.
  48  .SH "BACKWARDS COMPATIBILITY"
  49  .PP
  50  This version of \fBrmmod\fR is for kernels
  51  2.5.48 and above.  If it detects a kernel
  52  with support for old-style modules (for which much of the work
  53  was done in userspace), it will attempt to run
  54  \fBrmmod.old\fR in its place, so it is completely
  55  transparent to the user.
  56  .SH "COPYRIGHT"
  57  .PP
  58  This manual page Copyright 2002, Rusty Russell, IBM Corporation.
  59  .SH "SEE ALSO"
  60  .PP
  61  \fBmodprobe\fR(8),
  62  \fBinsmod\fR(8),
  63  \fBlsmod\fR(8),
  64  \fBrmmod.old\fR(8)