カーネルモジュール - 版の履歴

Oech3: インストールしない/* ブラックリスト */

2025-04-04T18:51:36Z

インストールしないブラックリスト

← 古い版		2025年4月5日 (土) 03:51時点における版
197行目:		197行目:
	* {{ic\|module_blacklist}} を使用すると、カーネルはそのモジュールのロードを完全に拒否します。暗黙のロードを防ぎたいだけで、後で手動でモジュールをロードする可能性がある場合は、正しいパラメータは {{ic\|1=modprobe.blacklist=modname1,modname2,modname3}} です。ただし、これでは、たとえば[[#systemd\|systemd]] や他のモジュールによる起動中の明示的なロードを防ぐことはできません。		* {{ic\|module_blacklist}} を使用すると、カーネルはそのモジュールのロードを完全に拒否します。暗黙のロードを防ぎたいだけで、後で手動でモジュールをロードする可能性がある場合は、正しいパラメータは {{ic\|1=modprobe.blacklist=modname1,modname2,modname3}} です。ただし、これでは、たとえば[[#systemd\|systemd]] や他のモジュールによる起動中の明示的なロードを防ぐことはできません。
	}}		}}

			=== インストールしない ===

			[[pacman#インストールさせないファイルを設定]]を使えます。
			{{hc\|/etc/pacman.conf\|2=NoExtract=usr/lib/modules//kernel/drivers/md/
			}}
			これが最も確実な方法です。

	== トラブルシューティング ==		== トラブルシューティング ==

AshMyzk: /* モジュールの自動ロード */ セクションの順番入れ替え (英語版に合わせる)

2024-12-27T06:14:10Z

モジュールの自動ロード: セクションの順番入れ替え (英語版に合わせる)

← 古い版		2024年12月27日 (金) 15:14時点における版
57行目:		57行目:

	今日、必要なモジュールのロードはすべて [[udev]] によって自動的に処理されます。したがって、ツリー外のカーネルモジュールを使用する必要がない場合は、ブート時にロードする必要のあるモジュールを設定ファイルに記述する必要はありません。ただし、ブートプロセスで追加のモジュールをロードしたり、コンピューターを正しく機能させるために他のモジュールをブラックリストに入れるなどのケースが考えられます。		今日、必要なモジュールのロードはすべて [[udev]] によって自動的に処理されます。したがって、ツリー外のカーネルモジュールを使用する必要がない場合は、ブート時にロードする必要のあるモジュールを設定ファイルに記述する必要はありません。ただし、ブートプロセスで追加のモジュールをロードしたり、コンピューターを正しく機能させるために他のモジュールをブラックリストに入れるなどのケースが考えられます。

		⚫	=== モジュールの早期ロード ===

		⚫	[[initramfs]] イメージには、 {{ic\|/etc/modules-load.d/}} で要求されたカーネルモジュールが含まれていない場合があります。また、そのフォルダに設定されているファイルが不足している場合もあります。モジュールの早期ロードは使用する initramfs ジェネレータに依存します。
		⚫	*{{pkg\|mkinitcpio}}: [[Mkinitcpio#MODULES]] を参照してください。
		⚫	*{{pkg\|dracut}}: [[Dracut#カーネルモジュールの早期ロード]] を参照してください。
		⚫	*{{pkg\|booster}}: [[Booster#モジュールの早期ロード]] を参照してください。

	=== systemd ===		=== systemd ===

	カーネルモジュールを {{ic\|/etc/modules-load.d/}} 配下のファイルに明示的にリストアップして、systemd が起動時にロードできるようにすることができます。各設定ファイルの名前の形式は {{ic\|/etc/modules-load.d/''program''.conf}} です。設定ファイルにはロードするカーネルモジュール名のリストが改行で区切られて含まれています。空行と最初の非空白文字が {{ic\|#}} または {{ic\|;}} である行は無視されます。		カーネルモジュールを {{ic\|/etc/modules-load.d/}} 配下のファイルに明示的にリストアップして、systemd が起動時にロードできるようにすることができます。各設定ファイルの名前の形式は {{ic\|/etc/modules-load.d/''program''.conf}} です。設定ファイルにはロードするカーネルモジュール名のリストが改行で区切られて含まれています。空行と最初の非空白文字が {{ic\|#}} または {{ic\|;}} である行は無視されます。

66行目:		74行目:

	詳しくは {{man\|5\|modules-load.d}} を参照してください。		詳しくは {{man\|5\|modules-load.d}} を参照してください。

⚫	=== モジュールの早期ロード ===

⚫	[[initramfs]] イメージには、 {{ic\|/etc/modules-load.d/}} で要求されたカーネルモジュールが含まれていない場合があります。また、そのフォルダに設定されているファイルが不足している場合もあります。モジュールの早期ロードは使用する initramfs ジェネレータに依存します。
⚫	*{{pkg\|mkinitcpio}}: [[Mkinitcpio#MODULES]] を参照してください。
⚫	*{{pkg\|dracut}}: [[Dracut#カーネルモジュールの早期ロード]] を参照してください。
⚫	*{{pkg\|booster}}: [[Booster#モジュールの早期ロード]] を参照してください。

	== 手動でモジュールを扱う ==		== 手動でモジュールを扱う ==

Kusanaginoturugi: /* 参照 */ update.

2024-08-23T09:50:32Z

参照: update.

← 古い版		2024年8月23日 (金) 18:50時点における版
209行目:		209行目:
	== 参照 ==		== 参照 ==

	* [http://linuxmanpages.com/man5/modprobe.conf.5.php modprobe man ページ]
	* [[PC スピーカーのビープ音の無効化]]		* [[PC スピーカーのビープ音の無効化]]
	* [https://lwn.net/Articles/391230/ Writing a WMI driver] - an LWM introduction		* [https://lwn.net/Articles/391230/ Writing a WMI driver] - an LWM introduction

			{{TranslationStatus\|Kernel module\|2024-08-23\|803682}}

Kusanaginoturugi: /* カーネルコマンドラインを使う */ update.

2024-08-23T09:48:46Z

カーネルコマンドラインを使う: update.

← 古い版		2024年8月23日 (金) 18:48時点における版
181行目:		181行目:

	事実上の、モジュールとそれが必要な他のモジュールのブラックリスト化になります。}}		事実上の、モジュールとそれが必要な他のモジュールのブラックリスト化になります。}}

		⚫	{{Note\|複数のモジュールをブラックリスト入りさせるときは、カンマで分割することを覚えておいて下さい。スペースなどを使うとシンタックスを破壊してしまうおそれがあります。}}

	=== カーネルコマンドラインを使う ===		=== カーネルコマンドラインを使う ===
190行目:		192行目:
	[[カーネルパラメータ]]のページで説明されているようにして、あなたのブートローダのカーネルラインに {{ic\|1=module_blacklist=modname1,modname2,modname3}} を追加するだけです。		[[カーネルパラメータ]]のページで説明されているようにして、あなたのブートローダのカーネルラインに {{ic\|1=module_blacklist=modname1,modname2,modname3}} を追加するだけです。

			{{Note\|
⚫	{{Note\|複数のモジュールをブラックリスト入りさせるときは、カンマで分割することを覚えておいて下さい。スペースなどを使うとシンタックスを破壊してしまうおそれがあります。}}
			* 複数のモジュールをブラックリスト入りさせるときは、カンマで分割することを覚えておいて下さい。スペースなどを使うとシンタックスを破壊してしまうおそれがあります。
			* {{ic\|module_blacklist}} を使用すると、カーネルはそのモジュールのロードを完全に拒否します。暗黙のロードを防ぎたいだけで、後で手動でモジュールをロードする可能性がある場合は、正しいパラメータは {{ic\|1=modprobe.blacklist=modname1,modname2,modname3}} です。ただし、これでは、たとえば[[#systemd\|systemd]] や他のモジュールによる起動中の明示的なロードを防ぐことはできません。
			}}

	== トラブルシューティング ==		== トラブルシューティング ==

Kusanaginoturugi: /* /etc/modprobe.d/ 内のファイルを使う */ update.

2024-08-23T09:46:57Z

/etc/modprobe.d/ 内のファイルを使う: update.

← 古い版		2024年8月23日 (金) 18:46時点における版
169行目:		169行目:
	{{hc\|/etc/modprobe.d/nobeep.conf\|		{{hc\|/etc/modprobe.d/nobeep.conf\|
	# Do not load the 'pcspkr' module on boot		# Do not load the 'pcspkr' module on boot

	blacklist pcspkr}}		blacklist pcspkr}}

Kusanaginoturugi: /* /etc/modprobe.d/ 内のファイルを使う */ update.

2024-08-23T09:43:16Z

/etc/modprobe.d/ 内のファイルを使う: update.

← 古い版		2024年8月23日 (金) 18:43時点における版
106行目:		106行目:
	# modprobe ''module_name parameter_name=parameter_value''		# modprobe ''module_name parameter_name=parameter_value''

	=== /etc/modprobe.d/ 内のファイルを使う ===		=== /etc/modprobe.d/ 内のファイルを使用する ===

	~~システムブート中、~~{{ic\|modprobe}} ~~を使ってモジュー~~ル~~を管理する~~ [[~~udev\|~~udev]] にモジュールの設定をわたすために {{ic\|~~/etc/~~modprobe~~.d/~~}} ~~ディレクトリ内のファイルが~~使われます。このディレクトリ内のファイルには ~~{{ic\|~~.conf}} 拡張子で終わる名前を付けます。構文は:		{{ic\|/etc/modprobe.d/}} ディレクトリ内のファイルは、[[udev]] にモジュール設定を渡すために使用できます。これにより、システムの起動時に {{ic\|modprobe}} を使用してモジュールのロードを管理します。このディレクトリ内の設定ファイルは、''.conf'' 拡張子で終わる任意の名前を持つことができます。構文は次のとおりです:

	{{hc\|/etc/modprobe.d/myfilename.conf\|2=		{{hc\|/etc/modprobe.d/myfilename.conf\|2=
			options ''module_name parameter_name=parameter_value''
	options modname parametername=parametervalue}}
			}}

			複数のモジュールパラメータはスペースで区切られ、パラメータにはカンマで区切られた値のリストを指定できます:

			{{hc\|/etc/modprobe.d/myfilename.conf\|2=
			options ''module_name param1=value1 param2=value2a,value2b …''
			}}

	例:		例:

	{{hc\|/etc/modprobe.d/thinkfan.conf\|2=		{{hc\|/etc/modprobe.d/thinkfan.conf\|2=
			# ThinkPad では、'thinkfan' デーモンがファンの速度を制御できるようにします
	# On Thinkpads, this lets the 'thinkfan' daemon control fan speed
		⚫	options thinkpad_acpi fan_control=1

			}}
⚫	options thinkpad_acpi fan_control=1}}

	{{Note\|影響を受けるモジュールが ~~init ramdisk~~ からロードされる場合、適切な ~~{{ic\|~~.conf}} ファイルを [[~~mkinitcpio\|~~mkinitcpio.conf]] の FILES に追加するか {{ic\|modconf}} [[~~mkinitcpio~~#HOOKS\|~~hook~~]] を使うかして、~~ramdisk~~ に含まれるようにする必要があります。デフォルトの initramfs の中身を確認するには ~~{{ic~~\|lsinitcpio ~~/boot/initramfs-linux.img}}~~ を使用してください。}}		{{Note\|影響を受けるモジュールが initramfs からロードされている場合、適切な ''.conf'' ファイルを [[mkinitcpio.conf]] の {{ic\|FILES}} に追加するか、{{ic\|modconf}} [[Mkinitcpio.conf#HOOKS\|フック]] を使用してから、''.conf'' ファイルを含めるために [[initramfs の再生成]] を行う必要があります。デフォルトの initramfs の内容を確認するには、[[mkinitcpio#イメージの抽出\|lsinitcpio]] を使用してください。}}

	=== カーネルコマンドラインを使う ===		=== カーネルコマンドラインを使う ===

Kusanaginoturugi: /* モジュールオプションを設定する */ update.

2024-08-23T09:29:58Z

モジュールオプションを設定する: update.

← 古い版		2024年8月23日 (金) 18:29時点における版
98行目:		98行目:
	== モジュールオプションを設定する ==		== モジュールオプションを設定する ==

	カーネルモジュールにパラメータを指定す~~るため~~に、modprobe ~~の conf~~ ファイルやカーネルコマンドラインを使うことができます。		カーネルモジュールにパラメータを渡すには、modprobe を使用してパラメータを手動で渡すか、modprobe 設定ファイルまたはカーネルコマンドラインを使用して特定のパラメータが常に適用されるようにすることができます。モジュールがカーネルに組み込まれている場合は、カーネルコマンドラインを使用する必要があり、他の方法は機能しません。

	=== ロード時に modprobe を使って手動で行う ===		=== ロード時に modprobe を使って手動で行う ===

Kusanaginoturugi: /* 手動でモジュールを扱う */ update.

2024-08-23T09:28:03Z

手動でモジュールを扱う: update.

← 古い版		2024年8月23日 (金) 18:28時点における版
83行目:		83行目:

	# modprobe ''module_name''		# modprobe ''module_name''

			ファイル名でモジュールをロードするには（つまり、{{ic\|/usr/lib/modules/$(uname -r)/}} にインストールされていないモジュール）:

			# insmod filename [args]

	モジュールをアンロードするには:		モジュールをアンロードするには:
91行目:		95行目:

	# rmmod ''module_name''		# rmmod ''module_name''

	設定ファイルをリロードするには:

	# systemctl restart systemd-modules-load.service

	== モジュールオプションを設定する ==		== モジュールオプションを設定する ==

Kusanaginoturugi: /* ヒントとテクニック */ 削除

2024-08-23T09:24:29Z

ヒントとテクニック: 削除

← 古い版		2024年8月23日 (金) 18:24時点における版
185行目:		185行目:

	{{Note\|複数のモジュールをブラックリスト入りさせるときは、カンマで分割することを覚えておいて下さい。スペースなどを使うとシンタックスを破壊してしまうおそれがあります。}}		{{Note\|複数のモジュールをブラックリスト入りさせるときは、カンマで分割することを覚えておいて下さい。スペースなどを使うとシンタックスを破壊してしまうおそれがあります。}}

	== ヒントとテクニック ==

	=== モジュールパラメータを一覧する Bash 関数 ===

	root 権限で実行することで、現在のパラメータ値を含む、現在ロードされているモジュールと全てのパラメータの一覧を表示する関数です。{{ic\|/proc/modules}} を使って現在ロードされているモジュールの一覧を取得して、モジュールファイルに modinfo で直接アクセスしてモジュールや（可能ならば）パラメータの説明を引き出し、最後に sysfs ファイルシステムにアクセスして実際のパラメータ名と現在の値を取得しています。

	{{bc\|<nowiki>
	function aa_mod_parameters ()
	{
	N=/dev/null;
	C=`tput op` O=$(echo -en "\n`tput setaf 2`>>> `tput op`");
	for mod in $(cat /proc/modules\|cut -d" " -f1);
	do
	md=/sys/module/$mod/parameters;
	[[ ! -d $md ]] && continue;
	m=$mod;
	d=`modinfo -d $m 2>$N \| tr "\n" "\t"`;
	echo -en "$O$m$C";
	[[ ${#d} -gt 0 ]] && echo -n " - $d";
	echo;
	for mc in $(cd $md; echo *);
	do
	de=`modinfo -p $mod 2>$N \| grep ^$mc 2>$N\|sed "s/^$mc=//" 2>$N`;
	echo -en "\t$mc=`cat $md/$mc 2>$N`";
	[[ ${#de} -gt 1 ]] && echo -en " - $de";
	echo;
	done;
	done
	}</nowiki>}}

	アウトプットのサンプル:

	{{hc\|# aa_mod_parameters\|2=
	>>> ehci_hcd - USB 2.0 'Enhanced' Host Controller (EHCI) Driver
	hird=0 - hird:host initiated resume duration, +1 for each 75us (int)
	ignore_oc=N - ignore_oc:ignore bogus hardware overcurrent indications (bool)
	log2_irq_thresh=0 - log2_irq_thresh:log2 IRQ latency, 1-64 microframes (int)
	park=0 - park:park setting; 1-3 back-to-back async packets (uint)

	>>> processor - ACPI Processor Driver
	ignore_ppc=-1 - ignore_ppc:If the frequency of your machine gets wronglylimited by BIOS, this should help (int)
	ignore_tpc=0 - ignore_tpc:Disable broken BIOS _TPC throttling support (int)
	latency_factor=2 - latency_factor: (uint)

	>>> usb_storage - USB Mass Storage driver for Linux
	delay_use=1 - delay_use:seconds to delay before using a new device (uint)
	option_zero_cd=1 - option_zero_cd:ZeroCD mode (1=Force Modem (default), 2=Allow CD-Rom (uint)
	quirks= - quirks:supplemental list of device IDs and their quirks (string)
	swi_tru_install=1 - swi_tru_install:TRU-Install mode (1=Full Logic (def), 2=Force CD-Rom, 3=Force Modem) (uint)

	>>> video - ACPI Video Driver
	allow_duplicates=N - allow_duplicates: (bool)
	brightness_switch_enabled=Y - brightness_switch_enabled: (bool)
	use_bios_initial_backlight=Y - use_bios_initial_backlight: (bool)}}

	== トラブルシューティング ==		== トラブルシューティング ==

Kusanaginoturugi: 序文を更新

2024-08-23T09:23:59Z

序文を更新

← 古い版		2024年8月23日 (金) 18:23時点における版
18行目:		18行目:
	{{Related articles end}}		{{Related articles end}}

	[[Wikipedia:~~ja:ローダブル・カーネル・モジュール~~\|カーネルモジュール]]は~~小さなコードの集まりであり~~、必要に応じてカーネルにロード・アンロードする~~ことが~~できます。~~カーネルモジュールは~~システムを再起動する必要なくカーネルの機能を拡張します。		[[Wikipedia:Loadable_kernel_module\|カーネルモジュール]] は、要求に応じてカーネルにロードおよびアンロードできるコードの一部です。これにより、システムを再起動する必要なく、カーネルの機能を拡張することができます。

	カーネルモジュールを作るには、[https://~~tldp~~.~~org/LDP~~/lkmpg/~~2.6/html/index.html~~ ~~このガイド~~] を~~読んで下~~さい。モジュールはビルトイン~~することも~~ロー~~ダブルにするこ~~ともできます。~~動的に~~モジュールをロード~~・リムーブ~~するには、カーネル設定でローダブルモジュールとして設定する必要があります (モジュールに関係する行には {{ic\|M}} が表示されます）。		カーネルモジュールを作成するには、[https://sysprog21.github.io/lkmpg/ The Linux Kernel Module Programming Guide] を参照してください。モジュールは、ビルトインまたはロード可能として設定できます。モジュールを動的にロードまたは削除するには、カーネルの設定でそのモジュールをロード可能なモジュールとして設定する必要があります（そのモジュールに関連する行には {{ic\|M}} という文字が表示されます）。

			新しいカーネルがインストールされるときにカーネルモジュールを自動的に再構築するには、[[Dynamic Kernel Module Support]] (DKMS) を参照してください。

	== 情報を取得 ==		== 情報を取得 ==