Mkinitcpio - 版の履歴

AshMyzk: 同期

2026-05-03T10:19:57Z

同期

Kgx: /* 標準的なレスキュー手順 */ 翻訳を修正

2025-09-11T11:11:48Z

標準的なレスキュー手順: 翻訳を修正

← 古い版		2025年9月11日 (木) 20:11時点における版
458行目:		458行目:
	=== 標準的なレスキュー手順 ===		=== 標準的なレスキュー手順 ===

	不適切な初期 RAM ディスクを使用~~すると~~、システムが起動できなくな~~ることがよくあります。し~~た~~がって~~、以下のようなシステムレスキュー手順に従ってください:		不適切な初期 RAM ディスクを使用して、システムが起動できなくなった場合、以下のようなシステムレスキュー手順に従ってください:

	==== あるマシンでは起動できるが他のマシンでは起動できない ====		==== あるマシンでは起動できるが他のマシンでは起動できない ====
464行目:		464行目:
	''mkinitcpio'' の {{ic\|autodetect}} フックは {{ic\|/sys}} をスキャンして、ロードされている[[カーネルモジュール]]を確認して不要なカーネルモジュールを排除します。{{ic\|/boot}} ディレクトリを他のマシンに移動して、初期ユーザー空間でブートが失敗する場合、カーネルモジュールが存在しないために新しいハードウェアが検出されていないのが原因かもしれません。USB 2.0 と 3.0 では必要なカーネルモジュールが異なるので注意してください。		''mkinitcpio'' の {{ic\|autodetect}} フックは {{ic\|/sys}} をスキャンして、ロードされている[[カーネルモジュール]]を確認して不要なカーネルモジュールを排除します。{{ic\|/boot}} ディレクトリを他のマシンに移動して、初期ユーザー空間でブートが失敗する場合、カーネルモジュールが存在しないために新しいハードウェアが検出されていないのが原因かもしれません。USB 2.0 と 3.0 では必要なカーネルモジュールが異なるので注意してください。

	修正するには、[[ブートローダー]]から [[#イメージ作成とアクティベーション\|fallback]] イメージを選択してください (fallback は {{ic\|autodetect}} によるフィルタリングがされていません)。起動したら、新しいマシンで ''mkinitcpio'' を実行して適切なモジュールでイメージを再生成してください。fallback イメージで起動できない場合、Arch Linux のライブ CD/USB で起動して、chroot し、新しいマシンで ''mkinitcpio'' を実行して下さい。それでも駄目な場合、initramfs にモジュールを[[#MODULES\|手動]]で追加します。		修正するには、[[ブートローダー]]から [[#イメージ作成とアクティベーション\|fallback]] イメージを選択してください (fallback は {{ic\|autodetect}} によるフィルタリングがされていません) 起動したら、新しいマシンで ''mkinitcpio'' を実行して適切なモジュールでイメージを再生成してください。fallback イメージで起動できない場合、Arch Linux のライブ CD/USB で起動して、chroot し、新しいマシンで ''mkinitcpio'' を実行して下さい。それでも駄目な場合、initramfs にモジュールを[[#MODULES\|手動]]で追加します。

	== 参照 ==		== 参照 ==

AshMyzk: 同期

2024-12-27T21:48:36Z

同期

← 古い版		2024年12月28日 (土) 06:48時点における版
80行目:		80行目:
	=== ユニファイドカーネルイメージ ===		=== ユニファイドカーネルイメージ ===

	''mkinitcpio'' は[[ユニファイドカーネルイメージ]] (UKI) を作成することができます。{{Pkg\|systemd-ukify}} が~~インストール~~されている場合、~~''mkinitcpio''~~ は ~~UKI の生成を systemd-ukify~~ に~~委託し~~ます。この~~パッケージがインストールされていない~~場合、''~~mkinitcpio~~'' は~~自身の実装を使~~用します。		''mkinitcpio'' は、それ自体または {{Pkg\|systemd-ukify}} 経由で[[ユニファイドカーネルイメージ]] (UKI) を作成することができます。{{Pkg\|systemd-ukify}} が存在しないか、{{ic\|--no-ukify}} によって明示的に無効化されている場合、UKI は mkinitcpio 自体によって構築されます。この場合、''ukify'' の高度な機能は利用できません。

			UKI 生成については [[ユニファイドカーネルイメージ]] を参照してください。

	== 設定 ==		== 設定 ==
86行目:		88行目:
	''mkinitcpio'' のプライマリ設定ファイルは、{{ic\|/etc/mkinitcpio.conf}} です。ドロップインの設定ファイル (例: {{ic\|/etc/mkinitcpio.conf.d/myhooks.conf}}) もサポートされています (ドロップインファイルは、mkinitcpio が {{ic\|-c}} オプションと共に実行された場合や、{{ic\|ALL_config}} を含んでいるプリセットを使用した場合には使用されません)。さらに、カーネルパッケージによって提供されるプリセット定義が {{ic\|/etc/mkinitcpio.d}} ディレクトリにあります (例: {{ic\|/etc/mkinitcpio.d/linux.preset}})。		''mkinitcpio'' のプライマリ設定ファイルは、{{ic\|/etc/mkinitcpio.conf}} です。ドロップインの設定ファイル (例: {{ic\|/etc/mkinitcpio.conf.d/myhooks.conf}}) もサポートされています (ドロップインファイルは、mkinitcpio が {{ic\|-c}} オプションと共に実行された場合や、{{ic\|ALL_config}} を含んでいるプリセットを使用した場合には使用されません)。さらに、カーネルパッケージによって提供されるプリセット定義が {{ic\|/etc/mkinitcpio.d}} ディレクトリにあります (例: {{ic\|/etc/mkinitcpio.d/linux.preset}})。

	ユーザーは、設定ファイルの中にある7つの変数を変更できます (詳細は {{man\|5\|mkinitcpio.conf}} を見てください):		ユーザーは、設定ファイルの中にある7つの変数を変更できます (詳細は {{man\|5\|mkinitcpio.conf\|VARIABLES}} を見てください):

	; {{ic\|MODULES}}: ブートフックが実行される前にロードされるカーネルモジュール。		; {{ic\|MODULES}}: ブートフックが実行される前にロードされるカーネルモジュール。
347行目:		349行目:
	* 起動時にこのパーティションのチェックを実行するために、{{ic\|fsck}} フックを追加して、{{ic\|/etc/fstab}} で {{ic\|/usr}} の {{ic\|passno}} を {{ic\|2}} にする。起動時に {{ic\|/usr}} を fsck したい場合は必須です (これはすべてのユーザに推奨されます)。このフックが存在しないと、{{ic\|/usr}} は永遠に fsck されません。		* 起動時にこのパーティションのチェックを実行するために、{{ic\|fsck}} フックを追加して、{{ic\|/etc/fstab}} で {{ic\|/usr}} の {{ic\|passno}} を {{ic\|2}} にする。起動時に {{ic\|/usr}} を fsck したい場合は必須です (これはすべてのユーザに推奨されます)。このフックが存在しないと、{{ic\|/usr}} は永遠に fsck されません。
	* systemd フックを使っていない場合、{{ic\|usr}} フックを追加する。ルートがマウントされた後に {{ic\|/usr}} パーティションがマウントされるようになります。		* systemd フックを使っていない場合、{{ic\|usr}} フックを追加する。ルートがマウントされた後に {{ic\|/usr}} パーティションがマウントされるようになります。

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

			=== フォールバック initramfs の生成を無効化する ===

			フォールバックイメージの生成は以下の方法で無効化できます:

		⚫	* {{ic\|/etc/mkinitcpio.d/}} 内の対応する ''.preset'' ファイル内の {{ic\|1=PRESETS=('default' 'fallback')}} 行を {{ic\|1=PRESETS=('default')}} に変更する。
			* {{ic\|/boot/}} 内のフォールバック initramfs イメージを削除する。
		⚫	* [[ブートローダー]]の設定を更新する。

		⚫	{{Warning\|フォールバック initramfs の生成を全て無効化すると、デフォルトの initramfs でシステムの起動が失敗した場合に、システムを起動するためのもう一つの手段が失われることになります。上記の手順を実行する前に、システムリカバリのための起動可能[[USB インストールメディア\|インストールメディア]]を作成しておいてください。}}

	== トラブルシューティング ==		== トラブルシューティング ==
418行目:		432行目:
	\|-		\|-
	\| nfp \|\| {{Pkg\|linux-firmware-nfp}}		\| nfp \|\| {{Pkg\|linux-firmware-nfp}}
			\|-
			\| qat_420xx \|\| ファームウェアはまだ利用できません。[https://intel.github.io/quickassist/RN/In-Tree/in_tree_firmware_RN.html?highlight=qat_420xx#id6] を参照。
	\|-		\|-
	\| qed \|\| {{Pkg\|linux-firmware-qlogic}}		\| qed \|\| {{Pkg\|linux-firmware-qlogic}}
429行目:		445行目:
	\| xhci_pci \|\| {{AUR\|upd72020x-fw}}		\| xhci_pci \|\| {{AUR\|upd72020x-fw}}
	\|}		\|}
	* 警告を取り除きたいが、必要ないファームウェアパッケージのためにシステムの空き領域を無駄にしたくない場合、~~fallback~~ initramfs の生成を無効化することができます:		* 警告を取り除きたいが、必要ないファームウェアパッケージのためにシステムの空き領域を無駄にしたくない場合、[[#フォールバック initramfs の生成を無効化する\|フォールバック initramfs の生成を無効化する]]ことができます。

⚫	*# {{ic\|/etc/mkinitcpio.d/}} 内のす~~べての~~ ''.preset'' ファイルで、{{ic\|1=PRESETS=('default' 'fallback')}} 行を {{ic\|1=PRESETS=('default')}} に変更~~してください~~。
			利用できないファームウェアに関しては、ダミーのファイルを作成することで警告を消すことができます。例えば:
	# fallback initramfs イメージを削除してください: {{ic\|# rm /boot/-fallback.img}}。

⚫	*# [[ブートローダー]]の設定~~ファイル~~を更新~~してください~~。
			# echo "Device not available" > /usr/lib/firmware/qat_420xx.bin
⚫	:{{Warning\|~~fallback~~ initramfs の生成を無効化すると、デフォルトの initramfs でシステムの起動が失敗した場合に、システムを起動するためのもう一つの手段が失われることになります。上記の手順を実行する前に、システムリカバリのための起動可能[[USB インストールメディア\|インストールメディア]]を作成しておいてください。}}
			# echo "Device not available" > /usr/lib/firmware/qat_420xx_mmp.bin

	=== No PS/2 controller found ===		=== No PS/2 controller found ===
455行目:		472行目:
	* Wikipedia 記事 [[wikipedia:ja:initrd\|initrd]]		* Wikipedia 記事 [[wikipedia:ja:initrd\|initrd]]

	{{TranslationStatus\|mkinitcpio\|2024-08-24\|~~813591~~}}		{{TranslationStatus\|mkinitcpio\|2024-12-27\|823193}}

AshMyzk: リンクを修正

2024-10-12T08:32:00Z

リンクを修正

← 古い版		2024年10月12日 (土) 17:32時点における版
285行目:		285行目:
	=== RAID を使う ===		=== RAID を使う ===

	[[RAID#~~mdadm フックを~~ mkinitcpio~~.conf~~ ~~に追加する~~]] を見てください。		[[RAID#mkinitcpio の設定]] を見てください。

	=== net を使う　===		=== net を使う ===

	{{Note\|NFSv4 はまだサポートされていません {{Bug\|28287}}。}}		{{Note\|NFSv4 はまだサポートされていません {{Bug\|28287}}。}}

AshMyzk: 同期

2024-08-24T07:11:50Z

同期

← 古い版		2024年8月24日 (土) 16:11時点における版
58行目:		58行目:
	=== 手動生成 ===		=== 手動生成 ===

	スクリプトを手動で実行するには、マニュアルページ {{man\|8\|mkinitcpio}} で手順を確認してください。特に、カーネルパッケージによって提供されるプリセットを(再)生成するには、使用するプリセットを {{ic\|-p}}/{{ic\|--preset}} オプションで指定してください。例えば、{{Pkg\|linux}} パッケージの場合、次のコマンドを使用してください:		スクリプトを手動で実行するには、マニュアルページ {{man\|8\|mkinitcpio}} で手順を確認してください。特に、カーネルパッケージによって提供されるプリセットに基づく initramfs イメージを(再)生成するには、使用するプリセットを {{ic\|-p}}/{{ic\|--preset}} オプションで指定してください。例えば、{{Pkg\|linux}} パッケージの場合、次のコマンドを使用してください:

	# mkinitcpio -p linux		# mkinitcpio -p linux

	既存のすべてのプリセットを(再)生成するには、{{ic\|-P}}/{{ic\|--allpresets}} スイッチを使用してください。これは通常、グローバルな [[#設定]] の変更後にすべての initramfs イメージを再生成するために使用されます:		既存のすべてのプリセットに基づく initramfs イメージを(再)生成するには、{{ic\|-P}}/{{ic\|--allpresets}} スイッチを使用してください。これは通常、グローバルな [[#設定]] の変更後にすべての initramfs イメージを再生成するために使用されます:

	# mkinitcpio -P		# mkinitcpio -P
232行目:		232行目:

	{{Tip\|		{{Tip\|
	* ~~zstd~~ と xz 圧縮~~アルゴ~~リズムはマルチスレッドモードで実行されます ({{ic\|-T0}} オプションが使用され、検出されたコアと同じ数のスレッドを作成しようと試みます)。		* lz4 と xz 圧縮ユーティリティはデフォルトでマルチスレッド化されており、zstd はマルチスレッドモードで実行されます ({{ic\|-T0}} オプションが使用され、検出されたコアと同じ数のスレッドを作成しようと試みます)。
	* lz4 は、高圧縮モード ({{ic\|-9}}) のイメージの圧縮率は通常約2.5で、~~シングルスレッド圧縮の遅さを犠牲にして~~最速の解凍速度を達成しています。zstd は、マルチスレッド圧縮と、オプションによる幅広い圧縮レベルにより、多用途のソリューションを提供します - {{man\|1\|zstd\|Operation ~~modifiers~~}} を参照。xz は、その高圧縮プリセット ({{ic\|-9}}) で約5の縮小率により最小サイズを実現しますが、その代償として展開速度がかなり遅くなります。		* lz4 は、高圧縮モード ({{ic\|-9}}) のイメージの圧縮率は通常約2.5で、最速の解凍速度を達成しています。zstd は、マルチスレッド圧縮と、オプションによる幅広い圧縮レベルにより、多用途のソリューションを提供します - {{man\|1\|zstd\|Operation Modifiers}} を参照。xz は、その高圧縮プリセット ({{ic\|-9}}) で約5の縮小率により最小サイズを実現しますが、その代償として展開速度がかなり遅くなります。
	}}		}}

455行目:		455行目:
	* Wikipedia 記事 [[wikipedia:ja:initrd\|initrd]]		* Wikipedia 記事 [[wikipedia:ja:initrd\|initrd]]

	{{TranslationStatus\|mkinitcpio\|2024-05-09\|~~807603~~}}		{{TranslationStatus\|mkinitcpio\|2024-08-24\|813591}}

Kusanaginoturugi: 校正（でき・出来）

2024-07-10T11:32:12Z

校正（でき・出来）

← 古い版		2024年7月10日 (水) 20:32時点における版
152行目:		152行目:
	{{ic\|run_latehook}}: root デバイスがマウントされた後、この名前の関数が実行されます。root デバイスの後のセットアップや {{ic\|/usr}} など他のファイルシステムのマウントなどに控えめに使われます。		{{ic\|run_latehook}}: root デバイスがマウントされた後、この名前の関数が実行されます。root デバイスの後のセットアップや {{ic\|/usr}} など他のファイルシステムのマウントなどに控えめに使われます。

	{{ic\|run_cleanuphook}}: 出来る限り最後に、この名前の関数が実行されます。設定ファイルの {{ic\|HOOKS}} の順番とは逆に実行されます。これらのフックは初期のフックによって起動したデーモンのシャットダウンなど、最後のクリーンアップに使われます。		{{ic\|run_cleanuphook}}: できる限り最後に、この名前の関数が実行されます。設定ファイルの {{ic\|HOOKS}} の順番とは逆に実行されます。これらのフックは初期のフックによって起動したデーモンのシャットダウンなど、最後のクリーンアップに使われます。

	{{Note\|ランタイムフックは busybox init でのみ使用されます。 '''systemd''' フックは systemd ベースの init をトリガーします。これはランタイムフックを実行せず、代わりに systemd ユニットを使用します。}}		{{Note\|ランタイムフックは busybox init でのみ使用されます。 '''systemd''' フックは systemd ベースの init をトリガーします。これはランタイムフックを実行せず、代わりに systemd ユニットを使用します。}}

AshMyzk: /* ポストフック */ テンプレートを修正

2024-05-09T04:05:37Z

ポストフック: テンプレートを修正

← 古い版		2024年5月9日 (木) 13:05時点における版
215行目:		215行目:
	==== ポストフック ====		==== ポストフック ====

	ポストフックは ic\|/usr/lib/initcpio/post/}} (パッケージによって提供されているフック) と {{ic\|/etc/initcpio/post/}} (カスタムのフック) に配置されている実行ファイルまたはシェルスクリプトです。これらのファイルは、署名などの追加のタスクを実行するために、イメージが生成された後に実行されます。		ポストフックは {{ic\|/usr/lib/initcpio/post/}} (パッケージによって提供されているフック) と {{ic\|/etc/initcpio/post/}} (カスタムのフック) に配置されている実行ファイルまたはシェルスクリプトです。これらのファイルは、署名などの追加のタスクを実行するために、イメージが生成された後に実行されます。

	各実行ファイルに対して以下の引数が以下の順番で渡されます:		各実行ファイルに対して以下の引数が以下の順番で渡されます:

AshMyzk: 同期

2024-05-09T04:04:11Z

同期

差分を表示

Kusanaginoturugi: ユニファイドカーネルイメージにへんこう

2024-04-24T11:21:38Z

ユニファイドカーネルイメージにへんこう

← 古い版		2024年4月24日 (水) 20:21時点における版
17行目:		17行目:
	{{Related\|mkinitcpio/Initramfs の最小化}}		{{Related\|mkinitcpio/Initramfs の最小化}}
	{{Related\|systemd}}		{{Related\|systemd}}
	{{Related\|~~Unified~~ カーネルイメージ}}		{{Related\|ユニファイドカーネルイメージ}}
	{{Related articles end}}		{{Related articles end}}
	[https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio mkinitcpio] は[[Wikipedia:Initial ramdisk\|初期 RAM ディスク]]環境を作成するために使われる Bash スクリプトです。{{man\|8\|mkinitcpio}} man ページより:		[https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio mkinitcpio] は[[Wikipedia:Initial ramdisk\|初期 RAM ディスク]]環境を作成するために使われる Bash スクリプトです。{{man\|8\|mkinitcpio}} man ページより:
80行目:		80行目:
	=== ユニファイドカーネルイメージ ===		=== ユニファイドカーネルイメージ ===

	バージョン31 以降の ''mkinitcpio'' では [[~~Unified~~ カーネルイメージ]] を作成することもできます。		バージョン31 以降の ''mkinitcpio'' では[[ユニファイドカーネルイメージ]]を作成することもできます。

	== 設定 ==		== 設定 ==
220行目:		220行目:
	# (イメージに) 使用されている'''カーネル''' (状況によってはこの引数が空になる場合があります)		# (イメージに) 使用されている'''カーネル''' (状況によってはこの引数が空になる場合があります)
	# 生成された '''initramfs イメージ'''		# 生成された '''initramfs イメージ'''
	# (オプション) 生成された '''~~unified~~ カーネルイメージ'''		# (オプション) 生成された'''ユニファイドカーネルイメージ'''

	さらに、次の環境変数が設定されます: カーネルの完全なバージョン {{ic\|KERNELVERSION}}、起動するためにカーネルを配置する必要のある場所のデフォルト {{ic\|KERNELDESTINATION}}。		さらに、次の環境変数が設定されます: カーネルの完全なバージョン {{ic\|KERNELVERSION}}、起動するためにカーネルを配置する必要のある場所のデフォルト {{ic\|KERNELDESTINATION}}。

Kusanaginoturugi: /* Unified カーネルイメージ */ ユニファイドカーネルイメージに変更

2024-04-24T11:14:08Z

Unified カーネルイメージ: ユニファイドカーネルイメージに変更

← 古い版		2024年4月24日 (水) 20:14時点における版
78行目:		78行目:
	# mkinitcpio --generate /boot/initramfs-custom2.img --kernel 5.7.12-arch1-1		# mkinitcpio --generate /boot/initramfs-custom2.img --kernel 5.7.12-arch1-1

	=== ~~Unified~~ カーネルイメージ ===		=== ユニファイドカーネルイメージ ===

	バージョン31 以降の ''mkinitcpio'' では [[Unified カーネルイメージ]] を作成することもできます。		バージョン31 以降の ''mkinitcpio'' では [[Unified カーネルイメージ]] を作成することもできます。

← 古い版		2024年7月10日 (水) 20:32時点における版
152行目:		152行目:
	{{ic\|run_latehook}}: root デバイスがマウントされた後、この名前の関数が実行されます。root デバイスの後のセットアップや {{ic\|/usr}} など他のファイルシステムのマウントなどに控えめに使われます。		{{ic\|run_latehook}}: root デバイスがマウントされた後、この名前の関数が実行されます。root デバイスの後のセットアップや {{ic\|/usr}} など他のファイルシステムのマウントなどに控えめに使われます。

	{{ic\|run_cleanuphook}}: 出来る限り最後に、この名前の関数が実行されます。設定ファイルの {{ic\|HOOKS}} の順番とは逆に実行されます。これらのフックは初期のフックによって起動したデーモンのシャットダウンなど、最後のクリーンアップに使われます。		{{ic\|run_cleanuphook}}: できる限り最後に、この名前の関数が実行されます。設定ファイルの {{ic\|HOOKS}} の順番とは逆に実行されます。これらのフックは初期のフックによって起動したデーモンのシャットダウンなど、最後のクリーンアップに使われます。

	{{Note\|ランタイムフックは busybox init でのみ使用されます。 '''systemd''' フックは systemd ベースの init をトリガーします。これはランタイムフックを実行せず、代わりに systemd ユニットを使用します。}}		{{Note\|ランタイムフックは busybox init でのみ使用されます。 '''systemd''' フックは systemd ベースの init をトリガーします。これはランタイムフックを実行せず、代わりに systemd ユニットを使用します。}}