manual/module-init-tools/original/man8/rmmod.8

   1 ...\" $Header: /JM/JM/manual/module-init-tools/original/man8/rmmod.8,v 1.1 2005/07/10 14:15:02 nakano Exp $
   2 ...\"
   3 ...\"   transcript compatibility for postscript use.
   4 ...\"
   5 ...\"   synopsis:  .P! <file.ps>
   6 ...\"
   7 .de P!
   8 .fl
   9 \!!1 setgray
  10 .fl
  11 \\&.\"
  12 .fl
  13 \!!0 setgray
  14 .fl                     \" force out current output buffer
  15 \!!save /psv exch def currentpoint translate 0 0 moveto
  16 \!!/showpage{}def
  17 .fl                     \" prolog
  18 .sy sed -e 's/^/!/' \\$1\" bring in postscript file
  19 \!!psv restore
  20 .
  21 .de pF
  22 .ie     \a\\*(f1\a\a .ds f1 \\n(.f
  23 .el .ie \a\\*(f2\a\a .ds f2 \\n(.f
  24 .el .ie \a\\*(f3\a\a .ds f3 \\n(.f
  25 .el .ie \a\\*(f4\a\a .ds f4 \\n(.f
  26 .el .tm ? font overflow
  27 .ft \\$1
  28 ..
  29 .de fP
  30 .ie     !\a\\*(f4\a\a \{\
  31 .       ft \\*(f4
  32 .       ds f4\"
  33 '       br \}
  34 .el .ie !\a\\*(f3\a\a \{\
  35 .       ft \\*(f3
  36 .       ds f3\"
  37 '       br \}
  38 .el .ie !\a\\*(f2\a\a \{\
  39 .       ft \\*(f2
  40 .       ds f2\"
  41 '       br \}
  42 .el .ie !\a\\*(f1\a\a \{\
  43 .       ft \\*(f1
  44 .       ds f1\"
  45 '       br \}
  46 .el .tm ? font underflow
  47 ..
  48 .ds f1\"
  49 .ds f2\"
  50 .ds f3\"
  51 .ds f4\"
  52 '\" t
  53 .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
  54 .TH "rmmod" "8"
  55 .SH "NAME"
  56 rmmod \(em simple program to remove a module from the Linux Kernel
  57 .SH "SYNOPSIS"
  58 .PP
  59 \fBrmmod\fR [\fB-f\fP]  [\fB-w\fP]  [\fB-s\fP]  [\fB-v\fP]  [\fImodulename\fR]
  60 .SH "DESCRIPTION"
  61 .PP
  62 \fBrmmod\fR is a trivial program to remove a
  63 module from the kernel.  Most users will want to use
  64 \fBmodprobe\fP\fB(8)\fP instead, with the \fB-r\fP option.
  65
  66 .SH "OPTIONS"
  67 .IP "\fB-v\fP \fB--verbose\fP         " 10
  68 Print messages about what the program is doing.
  69 Usually \fBrmmod\fR only prints messages
  70 if something goes wrong.
  71
  72 .IP "\fB-f\fP \fB--force\fP         " 10
  73 This option can be extremely dangerous: it has no effect unless
  74 CONFIG_MODULE_FORCE_UNLOAD was set when the kernel was
  75 compiled.  With this option, you can remove modules which are
  76 being used, or which are not designed to be removed, or have
  77 been marked as unsafe (see \fBlsmod\fP\fB(8)\fP).
  78
  79 .IP "\fB-w\fP \fB--wait\fP         " 10
  80 Normally, \fBrmmod\fR will refuse to
  81 unload modules which are in use.  With this option,
  82 \fBrmmod\fR will isolate the module, and
  83 wait until the module is no longer used.  Noone new
  84 will be able to use the module, but it's up to you to
  85 make sure the current users eventually finish with it.
  86 See \fBlsmod\fP\fB(8)\fP) for information on usage counts.
  87
  88 .IP "\fB-s\fP \fB--syslog\fP         " 10
  89 Send errors to the syslog, instead of standard error.
  90
  91 .IP "\fB-V\fP \fB--version\fP         " 10
  92 Show version of program, and exit.  See below for caveats
  93 when run on older kernels.
  94
  95 .SH "BACKWARDS COMPATIBILITY"
  96 .PP
  97 This version of \fBrmmod\fR is for kernels
  98 \fB2.5.48\fP and above.  If it detects a kernel
  99 with support for old-style modules (for which much of the work
 100 was done in userspace), it will attempt to run
 101 \fBrmmod.old\fR in its place, so it is completely
 102 transparent to the user.
 103
 104 .SH "COPYRIGHT"
 105 .PP
 106 This manual page Copyright 2002, Rusty Russell, IBM Corporation.
 107
 108 .SH "SEE ALSO"
 109 .PP
 110 \fBmodprobe\fP\fB(8)\fP,
 111 \fBinsmod\fP\fB(8)\fP,
 112 \fBlsmod\fP\fB(8)\fP,
 113 \fBrmmod.old\fP\fB(8)\fP
 114 ...\" created by instant / docbook-to-man, Thu 30 Oct 2003, 11:07