RMMOD linux command manual

rmmod(8)                                                           rmmod(8)



NAME
       rmmod -- simple program to remove a module from the Linux Kernel

SYNOPSIS
       rmmod [-f]  [-w]  [-s]  [-v]  [modulename]

DESCRIPTION
       rmmod  is  a trivial program to remove a module from the kernel.  Most
       users will want to use modprobe(8) instead, with the -r option.


OPTIONS
       -v --verbose
                 Print messages about what the  program  is  doing.   Usually
                 rmmod only prints messages if something goes wrong.


       -f --force
                 This  option  can  be  extremely dangerous: it has no effect
                 unless CONFIG_MODULE_FORCE_UNLOAD was set  when  the  kernel
                 was  compiled.   With  this  option,  you can remove modules
                 which are being used,  or  which  are  not  designed  to  be
                 removed, or have been marked as unsafe (see lsmod(8)).


       -w --wait Normally,  rmmod  will refuse to unload modules which are in
                 use.  With this option, rmmod will isolate the  module,  and
                 wait  until the module is no longer used.  Noone new will be
                 able to use the module, but it's up to you to make sure  the
                 current  users eventually finish with it.  See lsmod(8)) for
                 information on usage counts.


       -s --syslog
                 Send errors to the syslog, instead of standard error.


       -V --version
                 Show version of program, and exit.  See  below  for  caveats
                 when run on older kernels.


BACKWARDS COMPATIBILITY
       This  version of rmmod is for kernels 2.5.48 and above.  If it detects
       a kernel with support for old-style modules (for  which  much  of  the
       work was done in userspace), it will use previous modutils code, so it
       is completely transparent to the user.


COPYRIGHT
       This manual page Copyright 2002, Rusty Russell, IBM Corporation.


SEE ALSO
       modprobe(8), insmod(8), lsmod(8), rmmod.old(8)



                                                                     rmmod(8)