manual/modutils/release/man8/rmmod.8

   1 .\" Copyright (c) 1994, 1995, 1999 Bjorn Ekwall <bj0rn@blox.se>
   2 .\" Copyright (c) 1996 Free Software Foundation, Inc. (via rth)
   3 .\" This program is distributed according to the Gnu General Public License.
   4 .\" See the file COPYING in the distribution source directory
   5 .\"
   6 .\" Translated Sun Aug 15 10:58:04 JST 1999
   7 .\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
   8 .\" Updated Fri Sep 22 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
   9 .\" Updated Sun Jan 28 2001 by Kentaro Shirakata <argrath@ub32.org>
  10 .\" Updated Sun Jun  3 2001 by Kentaro Shirakata <argrath@ub32.org>
  11 .\" Updated Sat Mar 16 2002 by Kentaro Shirakata <argrath@ub32.org>
  12 .\"
  13 .\" WORD: generated comment     自動生成コメント
  14 .\" WORD: persistent data       永続データ
  15 .TH RMMOD 8 "February 6, 2002" Linux "Linux Module Support"
  16 .SH 名前
  17 rmmod \- ローダブルモジュールをアンロードする
  18 .SH 書式
  19 .hy 0
  20 .B rmmod
  21 [ \-aehrsvV ] module ...
  22 .SH このマニュアルについて
  23 このマニュアルは、Linux Kernel 2.4 の時代に使われていた modutils
  24 パッケージの \fBrmmod\fP の説明で、古いものです。現在ではたいていの場合、kmod
  25 パッケージの \fBrmmod\fP が使われています。(2022/12/02, Linux JM Project)
  26 .SH 説明
  27 .B rmmod
  28 は、実行中のカーネルからローダブルモジュールをアンロードする。
  29 .PP
  30 .B rmmod
  31 はカーネルからモジュールのセットをアンロードしようとする。アンロードに
  32 は制限があり、そのモジュールは使用中であってはならず、また他のモジュール
  33 から参照中であってもならない。
  34 .PP
  35 コマンドラインで複数のモジュールが指示されている場合、モジュールは
  36 指示された順に削除される。
  37 これにより、スタックしているモジュールのアンロードも行うことが出来る。
  38 .PP
  39 オプション '\fB-r\fR' を与えると、モジュールを再帰的に削除しようとする。
  40 つまり、スタックのトップにいるモジュールがコマンドラインで指定されると、
  41 このモジュールが用いている全てのモジュールを (可能ならば) 削除する。
  42 .PP
  43 .SH オプション
  44 .TP
  45 .BR \-a ", " \-\-all
  46 自動削除を行う: 使っていないモジュールに「削除予定」のタグをつけ、
  47 既にタグのついているモジュールを削除する。
  48 前回の自動削除以降も未使用のままであったモジュールは
  49 タグがついたままである。
  50 この 2 パスの手法により、一瞬使われなくなっただけの
  51 モジュールが削除されるのを防ぐ。
  52 .TP
  53 .BR \-e ", " \-\-persist
  54 指定されたモジュールの永続データ(persistent data)を保存する。モジュールのアンロードは行わない。
  55 モジュール名が指定されなかった場合は全てのモジュールの永続データが保存される。
  56 データの保存は、カーネルと modutils の両方が永続データに対応しており、
  57 かつ \fI/proc/ksyms\fR に
  58 .br
  59 __insmod_\fImodulename\fP_P\fIpersistent_filename\fP
  60 .br
  61 エントリがある場合にのみ行われる。
  62 .TP
  63 .BR \-h ", " \-\-help
  64 オプションの一覧を表示して直ちに終了する。
  65 .TP
  66 .BR \-r ", " \-\-stacks
  67 モジュールのスタックを削除する。
  68 .TP
  69 .BR \-s ", " \-\-syslog
  70 全ての出力を端末ではなく \fBsyslog\fP(3) に対して行う。
  71 .TP
  72 .BR \-v ", " \-\-verbose
  73 詳細に表示する。
  74 .TP
  75 .BR \-V ", " \-\-version
  76 \fBmodutils\fR のバージョンを表示する。
  77 .SH 永続データ
  78 モジュールに永続データ(
  79 .IR insmod (8)
  80 と
  81 .IR modules.conf (5)
  82 参照)がある場合、モジュールをアンロードした時に __insmod _P エントリの
  83 ファイル名のファイルに永続データを保存する。
  84 また、任意の時点で rmmod\ -e を実行することによってモジュールを
  85 アンロードすることなく永続データを保存することも出来る。
  86
  87 .PP
  88 永続データがファイルに書き込まれるとき、先頭に以下のような
  89 自動生成コメント行が付く。
  90 .br
  91 #% \fIkernel_version timestamp\fR
  92 .br
  93 自動生成コメント行は'#%'で始まる。
  94 全ての自動生成コメント行は読み込み時に削除されるが、
  95 その他のコメントは保存される。
  96 データがファイルに保存されるとき、既に存在するコメントの順番と位置は保存される。
  97 新しい値はファイルの最後に追加される。
  98 モジュールにない値がファイルに合った場合、それらの値は保存されるが
  99 「この値は使用されていない」旨の自動生成コメントによる警告がその前につく。
 100 これにより、永続データを失ったり、警告メッセージを受け取ったりすることなく
 101 カーネルを切り替えることが出来る。
 102 .PP
 103 .B 注意:
 104 行の空白以外の最初の文字が'#'である場合にのみコメントとして扱われる。
 105 空行以外で、'#'で始まっていない行はモジュールオプションとして
 106 扱われる(一行毎に一つ)。
 107 オプション行は先頭のスペースを取り除き、
 108 残りは全て insmod にオプションとして渡される。
 109 .SH 関連項目
 110 .BR insmod "(8), " lsmod "(8), " ksyms "(8), " modprobe "(8)."
 111 .SH バグ
 112 \fBrmmod\fR [\fB\-V\fR\ |\ \fB\-\-version\fR] はバージョン情報を
 113 表示して直ちに終了するべきである。
 114 しかしながら、現在はバージョン情報を表示した後、
 115 何もオプションが指定されなかったかのように振舞う。
 116 .SH 履歴
 117 モジュール対応を誰が最初に考えたのかは不明である。
 118 .br
 119 Linux 用の最初のバージョンは Bas Laarhoven <bas@vimec.nl> が作成した。
 120 .br
 121 バージョン 0.99.14 は Jon Tombs <jon@gtex02.us.es> が作成した。
 122 .br
 123 Bjorn Ekwall <bj0rn@blox.se> が拡張を行った。
 124 .br
 125 バージョン 2.1.17 への更新は Richard Henderson <rth@tamu.edu> が行った。
 126 .br
 127 バージョン 2.2.2 への更新は Bjorn Ekwall <bj0rn@blox.se> が行った。
 128 .br
 129 modutils 2.3.20 への更新は Keith Owens <kaos@ocs.com.au> が行った。
 130 .br
 131 2.3.22 からの永続データは Keith Owens <kaos@ocs.com.au> が行った。