ArchWiki - 利用者の投稿記録 [ja]

Lua

2026-04-24T21:43:13Z

Kgx: /* インストール */ 同期

[[Category:プログラミング言語]]
[[en:Lua]]
[[zh-hans:Lua]]
[https://www.lua.org/about.html lua.org] より:
:Lua は、効率的でパワフルかつ軽量な埋め込み可能なスクリプト言語です
Lua はその性質から [[C]] との相互運用性が高く、他のプログラムの設定や拡張に適しています。基本的な Lua インタプリタのサイズは 250K 未満です。公式実装は [[Wikipedia:ja:ANSI C|ANSI C]] で書かれており、多数のプラットフォームやアーキテクチャで機能します。

== インストール ==

複数のバージョンが存在します:

* {{Pkg|lua}} — Lua 5.5
* {{Pkg|lua54}} — Lua 5.4
* {{Pkg|lua53}} — Lua 5.3
* {{Pkg|lua52}} — Lua 5.2
* {{Pkg|lua51}} — Lua 5.1

== JIT コンパイルのサポート ==

[[Wikipedia:ja:実行時コンパイラ|JIT コンパイル]] はソースコードのコンパイルを実行前ではなく実行時に行う手法です。[https://luajit.org/ LuaJIT] は Lua 5.1 を置き換えることができます。LuaJIT は高い性能が必要な状況下に適しています。

JIT コンパイルのサポートを得るには {{Pkg|luajit}} パッケージを[[インストール]]してください。

== モジュール ==

[https://luarocks.org/ LuaRocks] パッケージマネージャは {{Pkg|luarocks}} パッケージでインストールできます。

また、一部のモジュールは [https://www.archlinux.jp/packages/?&q=lua- 公式リポジトリ] に含まれています。

== 参照 ==

* [https://www.lua.org/manual/ Lua リファレンスマニュアル]

Bcachefs

2026-04-18T09:47:00Z

Kgx: 同期

[[Category:ファイルシステム]]
[[en:Bcachefs]]
[[zh-hans:Bcachefs]]
{{Related articles start}}
{{Related|ファイルシステム}}
{{Related articles end}}
[https://bcachefs.org/ Bcachefs] は、[[Btrfs]] と [[ZFS]] の機能をよりクリーンなコードベース、より安定性、より高速、GPL 互換のライセンスを提供することを目的とした次世代の CoW ファイルシステムです。

[[Bcache]] は、主に Kent Overstreet によって開発されています。

{{Warning|Bcachefs は実験的なファイルシステムです。データを失う可能性があるので必ずバックアップを取るようにしてください。}}

== インストール ==

{{Pkg|bcachefs-tools}} と {{Pkg|bcachefs-dkms}} をインストールして下さい。

== セットアップ ==

=== シングルドライブ ===

# bcachefs format /dev/sd''X''
# mount -t bcachefs /dev/sd''X'' /mnt

=== 複数のドライブ===

Bcachefs は、RAID0 と同様に、デフォルトでデータをストライプ化します。冗長性は '''replicas''' オプションを介して処理されます。{{ic|1=--replicas=2}} を備えた 2 台のドライブは RAID1 に相当し、{{ic|1=--replicas=2}} を備えた 4 台のドライブは RAID10 に相当します。

# bcachefs format /dev/sd''X'' /dev/sd''Y'' --replicas=''n''
# mount -t bcachefs /dev/sd''X'':/dev/sd''Y'' /mnt

異種ドライブがサポートされています。サイズが異なる場合は、一部に大きなストライプが使用され、すべてが同じ割合で埋められます。速度が異なる場合、複製されたデータの読み取りは、IO 遅延が最も短いデータに送信されます。一部が他よりも信頼性が高い場合 (ハードウェア RAID デバイスなど)、{{ic|1=--durability=2 ''device''}} を設定して、そのデバイス上のデータの各コピーを 2 つの複製としてカウントできます。

=== 暗号化されたルートファイルシステム ===

Bcachefs は、ChaCha20Poly1305 を使用したファイルシステム全体の暗号化をサポートしています。暗号化されたファイルシステムをフォーマットするには、次のようにします:

# bcachefs format --encrypted /dev/sd''X''

ルートファイルシステムの場合、起動時や休止状態からの復帰時にファイルシステムの解除を求めるようにするため、{{ic|/etc/mkinitcpio.conf}} の設定ファイル内で [[Mkinitcpio#HOOKS|HOOKS]] 配列に {{ic|bcachefs}} を追加してください。

=== SSD キャッシング ===

Bcachefs には、バックグラウンド、フォアグラウンド、プロモートの3つのストレージカテゴリがあります。ファイルシステムへの書き込みでは、フォアグラウンドドライブに優先順位が付けられ、その後、時間の経過とともにバックグラウンドに移動されます。読み取りはプロモートドライブにキャッシュされます。

{{Note|これらは、単一の大規模プールに対する優先ガイドラインにすぎません。書き込みは、フォアグラウンドがいっぱいの場合はバックグラウンドに直接行われ、両方がいっぱいの場合はプロモートに行われます。メタデータはフォアグラウンドを優先しますが、どのメタデータにも書き込むことができます。キャッシュドライブにはまだデータが含まれている可能性があるため、キャッシュドライブを削除するときは注意してください。[[Bcachefs#デバイスの削除|デバイスの削除]] を参照してください。}}

推奨される設定は、フォアグラウンドとプロモートに ssd グループを使用し、バックグラウンド (ライトバックキャッシュ) に hdd グループを使用することです。

# bcachefs format \
--label=ssd.ssd1 /dev/sd''A'' \
--label=ssd.ssd2 /dev/sd''B'' \
--label=hdd.hdd1 /dev/sd''C'' \
--label=hdd.hdd2 /dev/sd''D'' \
--label=hdd.hdd3 /dev/sd''E'' \
--label=hdd.hdd4 /dev/sd''F'' \
--replicas=2 \
--foreground_target=ssd \
--promote_target=ssd \
--background_target=hdd
# mount -t bcachefs /dev/sd''A'':/dev/sd''B'':/dev/sd''C'':/dev/sd''D'':/dev/sd''E'':/dev/sd''F'' /mnt

ライトスルーキャッシュの場合は、上記と同じことを行いますが、各 SSD デバイスで {{ic|1=--durability=0 ''device''}} を設定します。
ライトアラウンドキャッシュの場合、フォアグラウンドターゲットを HDD グループに、プロモートターゲットを SSD グループに設定します。

=== マウント ===

デフォルトのマウント方法では、マウントディレクティブですべてのデバイスを指定します。

# mount -t bcachefs /dev/sd''A'':/dev/sd''B'':/dev/sd''C'':/dev/sd''D'':/

{{ic|mount.bcachefs}} コマンドは、UUID によるファイルシステムのマウントをサポートしています。
これは、ファイルシステムの作成時に {{ic|bcachefs format}} によって表示されます。

# mount.bcachefs UUID=f66d108f-83d2-4679-b50b-7d5e710f6a2b /mnt/

== 設定 ==

ほとんどのオプションは以下の方法で設定できます:

* {{ic|bcachefs format}} の実行時
* フォーマット後に {{ic|bcachefs set-fs-option}} を使用
* マウント時に {{ic|1=mount -o ''option=value''}} を指定
* または sysfs を介して、例:{{ic|echo ''X'' > /sys/fs/bcachefs/''UUID''/options/''option''}}

マウントオプションは他の方法で設定されたオプションを上書きします。これらの方法で設定されたオプションはファイルシステムのスーパーブロックに保存されます。

{{Note|sysfs を使用できるようにするには、ファイルシステムをマウントする必要があります。 fsck を除くすべての操作はライブファイルシステムで可能です。}}

使用可能なオプションの例は次の通りです:

{| class="wikitable"
|+ Bcachefs オプション
! オプション !! 説明
|-
| metadata_checksum || メタデータの書き込みに使用されるチェックサムアルゴリズムを指定します。デフォルトのアルゴリズムは ''crc32c'' です。{{ic|none}}、{{ic|crc32c}}、{{ic|crc64}}、{{ic|xxhash}} のいずれかを選択できます。
|-
| data_checksum || データの書き込みに使用されるチェックサムアルゴリズムを指定し、{{ic|metadata_checksum}} と同じデフォルトとオプションを共有します。
|-
| compression || (フォアグラウンド) 圧縮に使用するアルゴリズムを指定します。デフォルトでは、このオプションは指定されていません。{{ic|none}}、{{ic|lz4}}、{{ic|gzip}}、{{ic|zstd}} のいずれかを選択できます。
|-
| background_compression || (バックグラウンド) 圧縮に使用するアルゴリズムを指定し、{{ic|compression.}} と同じデフォルトとオプションを共有します。
|-
| str_hash || ディレクトリエントリと xattrs に使用されるハッシュ関数を指定します。{{ic|crc32c}}、{{ic|crc64}}、および {{ic|siphash}} のいずれかを選択できます。
|-
| nocow || 可能な場合は、すべての書き込みがその場で行われます。スナップショットと reflink では引き続き書き込みが COW になります。このオプションはデータのチェックサム、圧縮、暗号化を暗黙的に無効にします。
|-
| encrypted || ファイルシステム (chacha20/poly1305) で [https://bcachefs.org/Encryption/ 暗号化] を有効にします。パスフレーズの入力を求められます。
|-
|}

その他のオプションについては、[https://bcachefs-docs.readthedocs.io/en/latest/options.html bcachefs ドキュメント] を参照してください。

以下は、{{ic|1=bcachefs setattr ''file'' --option=value}} を使用して、ディレクトリごとまたはファイルごとに設定することもできます。ディレクトリにオプションを設定すると、再帰的にオプションが伝播されます。

{{Note|rebalance thread はまだバックグラウンドで replicas を調整していません。つまり、ファイルの replicas オプションを変更する場合は、手動で rereplicate コマンドを実行して、古いファイルが新しいルールに従っていることを確認する必要があります。}}

* data_replicas
* data_checksum
* compression, background_compression
* foreground_target, background_target, promote_target

どのオプションがアクティブであるかを確認するには、{{ic|getfattr -d -m 'bcachefs_effective\.' ''directory/file''}} を実行します。

{{Note|ディスク使用量レポートは現在、非圧縮サイズを表示しています。それ以外は圧縮が完了しています。}}

=== デバイスのグループの変更 ===

# echo ''group'' > /sys/fs/bcachefs/''filesystem_uuid''/dev-''X''/label

{{Note|これを有効にするには、再マウントが必要です。}}

=== デバイスの追加 ===

# bcachefs device add --group=''group'' /mnt /dev/''device''

これがグループ内の最初のドライブである場合は、それを使用するためにターゲット設定を変更する必要があります。この例は、キャッシュドライブを追加するためのものです。

# echo ''new_group'' > /sys/fs/bcachefs/''filesystem_uuid''/options/promote_target
# echo ''new_group'' > /sys/fs/bcachefs/''filesystem_uuid''/options/foreground_target
# echo ''old_group'' > /sys/fs/bcachefs/''filesystem_uuid''/options/background_target

{{Note|追加されたデバイス間でストライピングされるのは新しい書き込みのみです。ディスクのリバランスがトリガーされると、ディスク使用量が特定のしきい値に達するまで、既存のものは変更されません。現在、リバランス/リストライプを手動でトリガーすることはできません。}}

=== デバイスの削除 ===

まず、少なくとも 2 つのメタデータのレプリカがあることを確認します (Evacuate はメタデータに対して機能していないようです) データとメタデータがすでに複製されている場合は、この手順をスキップできます。

# echo 2 > /sys/fs/bcachefs/''UUID''/options/metadata_replicas
# bcachefs data rereplicate /mnt
# bcachefs device set-state ''device'' readonly
# bcachefs device evacuate ''device''

デバイスを削除します:

# bcachefs device remove ''device''
# bcachefs data rereplicate /mnt

=== レプリケーション ===

メタデータとデータのレプリカは、ユーザーが望む冗長性のレベルに応じて個別に設定できます。レプリカに関連するオプションは 5 つあります。

* {{ic|1=--replicas=X}} メタデータとデータのレプリカの数を同時に設定します。
* {{ic|1=--metadata_replicas=X}} 最終的に書き込まれるメタデータのレプリカの数を設定します。
* {{ic|1=--data_replicas=X}} 最終的に書き込まれるデータレプリカの数を設定します。
* {{ic|1=--metadata_replicas_required=X}} メタデータが "書き込まれた" とみなされる前に書き込む必要があるメタデータのレプリカの数を設定します。
* {{ic|1=--data_replicas_required=X}} データが "書き込まれた" とみなされる前に書き込む必要があるデータレプリカの数を設定します。

{{Note|{{ic|--[meta]data_replicas_required}} と {{ic|--[meta]data_replicas}} の区別は重要で、replicas required 値はすぐに書き込まれるレプリカの数のフロアを設定するのに対し、replicas 値は最終的に書き込まれるレプリカの目標数を設定します。
}}

=== 圧縮 ===

圧縮は、{{ic|1=--compression=}} オプションで設定します。圧縮レベルの設定も可能です。zstd 圧縮レベル 5 を設定する例、{{ic|1=--compression=zstd:5}}

=== サブボリューム ===

Bcachefsは、[[Btrfs#Subvolumes|Btrfs]] と同様のユーザースペースインターフェースを使用してサブボリュームとスナップショットをサポートしています。新しいサブボリュームは空の状態で作成することも、別のサブボリュームのスナップショットとして作成することもできます。スナップショットは書き込み可能で、さらにスナップショットを作成することもでき、スナップショットのツリー構造を形成します。

スナップショットの作成は非常に低コストです。[[Btrfs#Subvolumes|Btrfs]] のように COW(Copy-On-Write)Bツリーのクローンに基づいているのではなく、Bツリー内の個々のキーのバージョン管理に基づいています。何千、何百万ものスナップショットを作成することが可能で、唯一の制限はディスクスペースです。

==== サブボリュームの作成 ====

新しい空のサブボリュームを作成するには:

# bcachefs subvolume create ''/path/to/subvolume''

==== サブボリュームの削除 ====

既存のサブボリュームやスナップショットを削除するには:

# bcachefs subvolume delete ''/path/to/subvolume''

==== 既存のサブボリュームのスナップショットを作成する ====

既存のサブボリュームのスナップショットを作成するには、次の手順を実行します。

# bcachefs subvolume snapshot ''/path/to/source'' ''/path/to/dest''

{{ic|rm -rf}} のように、すべての内容を削除した後、通常の rmdir を使用してサブボリュームを削除することもできます。

再帰的なスナップショットの作成やサブボリュームを再帰的にリストする方法などの機能はまだ実装されていません。

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

さらに有用なエラーメッセージについては、[[systemd/ジャーナル|ジャーナル]]を確認してください。

=== フラグの順序 ===

一部の {{ic|bcachefs format}} フラグは、引数の順序に基づいて設定され、フラグが切り替えられた後のドライブにのみ影響します。たとえば、SSD に {{ic|1=--durability=0}} を持たせて {{ic|--discard}} を有効にし、HDD ではデフォルトを使用する場合は、引数が次の順序で渡されるようにしてください。

# bcachefs format \
--label=hdd.hdd1 /dev/sd''C'' \
--label=hdd.hdd2 /dev/sd''D'' \
--label=hdd.hdd3 /dev/sd''E'' \
--label=hdd.hdd4 /dev/sd''F'' \
--durability=0 --discard \
--label=ssd.ssd1 /dev/sd''A'' \
--label=ssd.ssd2 /dev/sd''B'' \
--replicas=2 \
--foreground_target=ssd \
--promote_target=ssd \
--background_target=hdd

=== フォーマット後のレプリカの設定 ===

{{ic|set-fs-option}} を使用して、フォーマット後にレプリカ数を設定することができます。

# bcachefs set-fs-option --metadata_replicas=''2'' --data_replicas=''2'' /dev/sd''X''

その後、すべてのファイルに次のレプリカが存在することを確認するように bcachefs に指示する必要があります。

# bcachefs data rereplicate /mnt

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

=== 32-ビットプログラムがディレクトリの内容を認識しない ===

一部の 32-ビットプログラムは、{{man|3|readdir}} syscall の実行時にファイルシステムから返されるデータの非互換性により、Bcachefs 内のディレクトリの内容の取得に失敗する場合があります。[https://github.com/koverstreet/bcachefs/issues/650]

この問題は、そのようなプログラムの読み書きに [[tmpfs]] などの別のファイルシステムを一時的に使用することで回避できます。

=== スワップファイルにはサポートされていないエクステントが含まれています ===

Bcachefs は現在 [https://github.com/koverstreet/bcachefs/issues/368 swapfiles] をサポートしていません。

=== マルチデバイス fstab ===

現在、[https://github.com/systemd/systemd/issues/8234 systemd のバグ] があり、fstab でコロンで区切られたデバイスを使用して起動時にマルチデバイス bcachefs ファイルシステムをマウントできません。 mount -a を実行すると機能しますが、起動時にはマウントされません。ただし、bcachefs-tools バージョン 1.7.0 以降では、1 つのデバイスノードを使用してマルチデバイスアレイをマウントできるようになりました。これにより、通常の {{ic|1=UUID=}} 指定子の使用が可能になります。

# UUID=10176fc9-c4fa-4a30-9fd0-a756d861c4cd /mnt bcachefs defaults,nofail 0 0

ファイルシステム UUID / 外部 UUID は、次のいずれかを使用して見つけることができます:

# bcachefs fs usage
# bcachefs show-super device

=== 暗号化されたデバイスのマウントエラー ===

{{ic|--encrypted}} オプションで作成されたデバイスのマウントが、{{ic|bcachefs locked /dev/sd''XY''}} の後に失敗した場合
ERROR - bcachefs::commands::cmd_mount: Fatal error: Required key not available

これは、キーをセッション [https://lore.kernel.org/all/6018852.lOV4Wx5bFT@lichtvoll.de/] に手動でリンクすることで回避できます:

# keyctl link @u @s
# mount /dev/sd''XY'' /mnt
Enter passphrase:

''mount'' によって照会されるパスフレーズを新たに入力する必要はありません ({{ic|Enter}} を押すだけで十分です。)

== 参照 ==

* [https://bcachefs.org/bcachefs-principles-of-operation.pdf 公式マニュアル]
* [https://www.patreon.com/bcachefs Kent Overstreet's Patreon page]
* [[Wikipedia:Bcachefs]]
* [https://bcachefs-docs.readthedocs.io/en/latest/introduction.html bcachefs on ReadTheDocs]

Niri

2026-04-09T08:50:48Z

Kgx: 同期

[[Category:Wayland コンポジタ]]
[[en:Niri]]
[https://github.com/niri-wm/niri Niri] は、スクロール可能なタイリング型 [[Wayland]] コンポジタです。[[Sway]] や [[Hyprland]] とは異なり、Niri はウィンドウを無限に広がる水平なデスクトップ上に配置し、左右にスクロールして操作します(より高度なレイアウトも可能です) [[GNOME]] の PaperWM や [[KDE]] の Karousel に近い操作感を提供します。

== インストール ==

Niri は {{pkg|niri}} パッケージで[[インストール]]できます。また、より快適な環境を構築するために、以下のパッケージのインストールが推奨されます:

* {{pkg|fuzzel}}: Niri のデフォルトアプリケーションランチャー
* {{pkg|mako}}: 通知サーバー
* [[waybar]]: Wayland 用ステータスバー
* {{pkg|xdg-desktop-portal-gtk}}, {{pkg|xdg-desktop-portal-gnome}}: スクリーン共有を可能にするため
* [[alacritty]]: Niri のデフォルトターミナル
* {{pkg|swaybg}}: 壁紙の設定
* {{pkg|swayidle}}, {{pkg|swaylock}}: アイドル時の画面ロック
* {{pkg|xwayland-satellite}}: X11 アプリケーションの実行用
* {{pkg|udiskie}}: USB ドライブの管理と自動マウント

== 起動 ==

Niri には [[デスクトップエントリ]] が含まれており、[[ディスプレイマネージャ]] から選択可能です。これを選択すると {{ic|niri-session}} が実行され、[[systemd]] への [[環境変数]] のエクスポートが適切に行われます。

また、[[getty]] (コンソール) から直接起動する場合は、以下のコマンドを実行します:

niri-session -l

これは [[Getty#Automatic login to virtual console|自動ログイン]] と組み合わせることで、シームレスな [[Arch ブートプロセス|ブート]] 体験を実現できます。

== 設定 ==

Niri は {{ic|~/.config/niri/config.kdl}} から設定を読み込みます。ファイル形式は KDL で、セクションごとに分かれています。初回実行時に生成されるデフォルト設定ファイルには、各オプションの説明がコメントとして記載されています。ただし、アップデートで追加された新機能については記載されないため、[https://niri-wm.github.io/niri/Configuration:-Introduction.html Niri 公式ドキュメント] を参照してください。

設定ファイルを保存すると、Niri は自動的に設定を適用します。設定内容が不正であっても Niri はクラッシュせず、最後に動作していた状態が維持され、エラーがユーザーに通知されます。セッション外で設定を検証するには {{ic|niri validate}} を使用します。

=== キーマップ ===

キーマップを設定するには、{{ic|input/keyboard/xkb}} セクションを編集します。

例えば、"US Int Alt Gr" レイアウトを使用し、{{ic|CapsLock}} を {{ic|Ctrl}} として機能させる場合は以下のようになります:

{{hc|~/.config/niri/config.kdl|
input {
keyboard {
xkb {
layout "us"
variant "altgr-intl"
options "ctrl:nocaps"
}
}
...
}
}}

=== 出力 ===

まず {{ic|niri msg outputs}} を実行して、Niri が認識している出力を確認します。その後、各モニターに設定を適用できます。例として、HDMI モニターを 2560x1440 60Hz、スケーリング 1.2 に設定し、ノート PC の内蔵モニターをオフにする設定は以下の通りです:

{{hc|~/.config/niri/config.kdl|
output "HDMI-A-1" {
mode "2560x1440@60.000"
scale 1.2
}

output "eDP-1" {
off
}
}}

{{Note|ドッキングステーションへの接続時などに動的なレイアウト変更を行いたい場合は、[[kanshi]] を併用することも検討してください。}}

=== キーバインド ===

binds セクションでは、Niri を操作するキーの組み合わせを設定します。初回起動時に生成される設定には多くのバインドが含まれており、これらはすべて変更可能です。

注意点として、Niri はデフォルトのキーバインドを自動的にロードしません。設定ファイルに記述がないバインドは機能しません。そのため、不要なバインドを削除する際は、削除ではなくコメントアウトに留めることが推奨されます。

バインドは、修飾キーに {{ic|+}} を繋げ、アクションを括弧内に記述します。spawn アクションはプログラムを起動します。以下の例では、{{ic|Mod+T}} で [[alacritty]] を、{{ic|Mod+D}} で {{pkg|fuzzel}} を起動します。{{ic|Mod}} は通常、単独実行時は {{ic|Super}} キー、他のコンポジット内での実行時は {{ic|Alt}} キーになります。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+T { spawn "alacritty"; }
Mod+D { spawn "fuzzel"; }
...
}
}}

{{ic|spawn}} に渡す引数にスペースが含まれる場合は、個別に引用符で囲む必要があります:

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+Ctrl+semicolon {
spawn "swaylock" "-c" "121212" "-e" "-f" "-F"
}
...
}
}}

==== WASD 風のナビゲーション ====

ゲームのような WASD キーによるウィンドウ移動を設定することも可能です。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+A { focus-column-left; }
Mod+S { focus-window-or-workspace-down; }
Mod+W { focus-window-or-workspace-up; }
Mod+D { focus-column-right; }
...
}
}}

※この設定を導入する場合、既存の他のバインドとの競合を避けるために調整が必要になる場合があります。

=== 自動起動 ===

Niri の起動時に特定のプログラムを同時に開始できます。
前述した {{Pkg|mako}}、{{Pkg|waybar}}、{{Pkg|swayidle}}/{{Pkg|swaylock}} などの設定例は以下の通りです:

{{hc|~/.config/niri/config.kdl|
spawn-at-startup "mako"
spawn-at-startup "waybar"
spawn-at-startup "swayidle" "-w" "timeout" "601" "niri msg action power-off-monitors" "timeout" "600" "swaylock -f" "before-sleep" "swaylock -f"
}}

これらのプロセスは Niri セッションに紐付けられており、Niri が終了または中断されると終了します。プロセスをバックグラウンドで永続させたい場合は、引数に {{ic|"&"}} を追加してください。

=== XWayland ===

Niri は X11 アプリケーションを実行するための XWayland を標準ではサポートしていません。その代わり、外部ツールの使用を推奨しています。オプションの依存関係にある {{Pkg|xwayland-satellite}} をインストールすれば、特別な設定なしで使用可能です。

=== マルチ GPU 設定 ===

内蔵グラフィックスと専用 GPU (dGPU) の両方を搭載した環境では、Niri がデフォルトで dGPU を使用してしまい、バッテリーを浪費する場合があります。

{{Note|NVIDIA カードを使用している場合は、GPU を低電力状態にする方法やアプリごとの起動設定について [[PRIME]] を参照してください。}}

Niri が使用する GPU を指定するには、まずシステムで利用可能なレンダリングデバイスを確認します:
{{hc|
$ ls -l /dev/dri/by-path/*-render|
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c1:00.0-render -> ../renderD129
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c2:00.0-render -> ../renderD128
}}

次に、PCI アドレスを使って各デバイスがどのカードかを確認します:
{{hc|
$ lspci -s c1:00.0|
c1:00.0 VGA compatible controller: NVIDIA Corporation GB206M [GeForce RTX 5070 Max-Q / Mobile] (rev a1)
}}

使用したいデバイスを特定したら、Niri の設定ファイルに追記します:
{{hc|
~/.config/niri/config.kdl|
debug {
render-drm-device "/dev/dri/renderD128"
}
}}

再起動後、以下のコマンドで GPU が正しく低電力状態 (D3cold など) になっているか確認できます:
{{hc|
$ cat /sys/class/drm/card*/device/power_state|
D3cold
D0
}}

== 参照 ==

[https://niri-wm.github.io/niri/ Niri 公式 Wiki]

Niri

2026-04-07T22:00:08Z

Kgx: /* 起動 */ リンクを修正

[[Category:Wayland コンポジタ]]
[[en:Niri]]
[https://github.com/niri-wm/niri Niri] は、スクロール可能なタイリング型 [[Wayland]] コンポジタです。[[Sway]] や [[Hyprland]] とは異なり、Niri はウィンドウを無限に広がる水平なデスクトップ上に配置し、左右にスクロールして操作します(より高度なレイアウトも可能です) [[GNOME]] の PaperWM や [[KDE]] の Karousel に近い操作感を提供します。

== インストール ==

Niri は {{pkg|niri}} パッケージで[[インストール]]できます。また、より快適な環境を構築するために、以下のパッケージのインストールが推奨されます:

* {{pkg|fuzzel}}: Niri のデフォルトアプリケーションランチャー
* {{pkg|mako}}: 通知サーバー
* [[waybar]]: Wayland 用ステータスバー
* {{pkg|xdg-desktop-portal-gtk}}, {{pkg|xdg-desktop-portal-gnome}}: スクリーン共有を可能にするため
* [[alacritty]]: Niri のデフォルトターミナル
* {{pkg|swaybg}}: 壁紙の設定
* {{pkg|swayidle}}, {{pkg|swaylock}}: アイドル時の画面ロック
* {{pkg|xwayland-satellite}}: X11 アプリケーションの実行用
* {{pkg|udiskie}}: USB ドライブの管理と自動マウント

== 起動 ==

Niri には [[デスクトップエントリ]] が含まれており、[[ディスプレイマネージャ]] から選択可能です。これを選択すると {{ic|niri-session}} が実行され、[[systemd]] への [[環境変数]] のエクスポートが適切に行われます。

また、[[getty]] (コンソール) から直接起動する場合は、以下のコマンドを実行します:

niri-session -l

これは [[Getty#Automatic login to virtual console|自動ログイン]] と組み合わせることで、シームレスな [[Arch ブートプロセス|ブート]] 体験を実現できます。

== 設定 ==

Niri は {{ic|~/.config/niri/config.kdl}} から設定を読み込みます。ファイル形式は KDL で、セクションごとに分かれています。初回実行時に生成されるデフォルト設定ファイルには、各オプションの説明がコメントとして記載されています。ただし、アップデートで追加された新機能については記載されないため、[https://niri-wm.github.io/niri/Configuration:-Introduction.html Niri 公式ドキュメント] を参照してください。

設定ファイルを保存すると、Niri は自動的に設定を適用します。設定内容が不正であっても Niri はクラッシュせず、最後に動作していた状態が維持され、エラーがユーザーに通知されます。セッション外で設定を検証するには {{ic|niri validate}} を使用します。

== キーマップ ==

キーマップを設定するには、{{ic|input/keyboard/xkb}} セクションを編集します。

例えば、"US Int Alt Gr" レイアウトを使用し、{{ic|CapsLock}} を {{ic|Ctrl}} として機能させる場合は以下のようになります:

{{hc|~/.config/niri/config.kdl|
input {
keyboard {
xkb {
layout "us"
variant "altgr-intl"
options "ctrl:nocaps"
}
}
...
}
}}

=== 出力 ===

まず {{ic|niri msg outputs}} を実行して、Niri が認識している出力を確認します。その後、各モニターに設定を適用できます。例として、HDMI モニターを 2560x1440 60Hz、スケーリング 1.2 に設定し、ノート PC の内蔵モニターをオフにする設定は以下の通りです:

{{hc|~/.config/niri/config.kdl|
output "HDMI-A-1" {
mode "2560x1440@60.000"
scale 1.2
}

output "eDP-1" {
off
}
}}

{{Note|ドッキングステーションへの接続時などに動的なレイアウト変更を行いたい場合は、[[kanshi]] を併用することも検討してください。}}

=== キーバインド ===

binds セクションでは、Niri を操作するキーの組み合わせを設定します。初回起動時に生成される設定には多くのバインドが含まれており、これらはすべて変更可能です。

注意点として、Niri はデフォルトのキーバインドを自動的にロードしません。設定ファイルに記述がないバインドは機能しません。そのため、不要なバインドを削除する際は、削除ではなくコメントアウトに留めることが推奨されます。

バインドは、修飾キーに {{ic|+}} を繋げ、アクションを括弧内に記述します。spawn アクションはプログラムを起動します。以下の例では、{{ic|Mod+T}} で [[alacritty]] を、{{ic|Mod+D}} で {{pkg|fuzzel}} を起動します。{{ic|Mod}} は通常、単独実行時は {{ic|Super}} キー、他のコンポジット内での実行時は {{ic|Alt}} キーになります。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+T { spawn "alacritty"; }
Mod+D { spawn "fuzzel"; }
...
}
}}

{{ic|spawn}} に渡す引数にスペースが含まれる場合は、個別に引用符で囲む必要があります:

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+Ctrl+semicolon {
spawn "swaylock" "-c" "121212" "-e" "-f" "-F"
}
...
}
}}

==== WASD 風のナビゲーション ====

ゲームのような WASD キーによるウィンドウ移動を設定することも可能です。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+A { focus-column-left; }
Mod+S { focus-window-or-workspace-down; }
Mod+W { focus-window-or-workspace-up; }
Mod+D { focus-column-right; }
...
}
}}

※この設定を導入する場合、既存の他のバインドとの競合を避けるために調整が必要になる場合があります。

=== 自動起動 ===

Niri の起動時に特定のプログラムを同時に開始できます。
前述した {{Pkg|mako}}、{{Pkg|waybar}}、{{Pkg|swayidle}}/{{Pkg|swaylock}} などの設定例は以下の通りです:

{{hc|~/.config/niri/config.kdl|
spawn-at-startup "mako"
spawn-at-startup "waybar"
spawn-at-startup "swayidle" "-w" "timeout" "601" "niri msg action power-off-monitors" "timeout" "600" "swaylock -f" "before-sleep" "swaylock -f"
}}

これらのプロセスは Niri セッションに紐付けられており、Niri が終了または中断されると終了します。プロセスをバックグラウンドで永続させたい場合は、引数に {{ic|"&"}} を追加してください。

=== XWayland ===

Niri は X11 アプリケーションを実行するための XWayland を標準ではサポートしていません。その代わり、外部ツールの使用を推奨しています。オプションの依存関係にある {{Pkg|xwayland-satellite}} をインストールすれば、特別な設定なしで使用可能です。

=== マルチ GPU 設定 ===

内蔵グラフィックスと専用 GPU (dGPU) の両方を搭載した環境では、Niri がデフォルトで dGPU を使用してしまい、バッテリーを浪費する場合があります。

{{Note|NVIDIA カードを使用している場合は、GPU を低電力状態にする方法やアプリごとの起動設定について [[PRIME]] を参照してください。}}

Niri が使用する GPU を指定するには、まずシステムで利用可能なレンダリングデバイスを確認します:
{{hc|
$ ls -l /dev/dri/by-path/*-render|
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c1:00.0-render -> ../renderD129
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c2:00.0-render -> ../renderD128
}}

次に、PCI アドレスを使って各デバイスがどのカードかを確認します:
{{hc|
$ lspci -s c1:00.0|
c1:00.0 VGA compatible controller: NVIDIA Corporation GB206M [GeForce RTX 5070 Max-Q / Mobile] (rev a1)
}}

使用したいデバイスを特定したら、Niri の設定ファイルに追記します:
{{hc|
~/.config/niri/config.kdl|
debug {
render-drm-device "/dev/dri/renderD128"
}
}}

再起動後、以下のコマンドで GPU が正しく低電力状態 (D3cold など) になっているか確認できます:
{{hc|
$ cat /sys/class/drm/card*/device/power_state|
D3cold
D0
}}

== 参照 ==

[https://niri-wm.github.io/niri/ Niri 公式 Wiki]

PipeWire

2026-02-20T09:01:15Z

Kgx: /* 設定 */ 同期

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[[pt:PipeWire]]
[[ru:PipeWire]]
[[zh-hans:PipeWire]]
{{Related articles start}}
{{Related|PipeWire/サンプル}}
{{Related|WirePlumber}}
{{Related articles end}}
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、[[PulseAudio]]、[[JACK]]、[[ALSA]]、[[GStreamer]] をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリから {{Pkg|pipewire}} パッケージを[[インストール]]してください。[[multilib]] サポート用として {{Pkg|lib32-pipewire}} も用意されています。

オプションとして、ドキュメントを確認するために {{Pkg|pipewire-docs}} をインストールすることもできます。

PipeWireは他のオーディオサーバーのドロップイン代替(そのまま置き換え可能な代用)として機能します。詳細は [[#オーディオ]] を参照してください。

=== セッションマネージャー ===

[[JACK]] と同様に、PipeWire 自体は内部に接続ロジックを実装していません。新しいストリームを監視し、それらを適切な出力デバイスやアプリケーションに接続する役割は、「セッションマネージャー」と呼ばれる外部コンポーネントに委ねられています。

==== WirePlumber ====

[[WirePlumber]] は推奨されるセッションマネージャーです。モジュール設計に基づいており、実際の管理機能は Lua プラグインによって実装されています。

標準の設定ファイルは {{ic|/usr/share/wireplumber}} に保存されています。WirePlumber をカスタマイズする推奨される方法は、{{ic|/etc/wireplumber}} または {{ic|~/.config/wireplumber}} に特定の設定を上書きするスニペットを追加することです。[https://pipewire.pages.freedesktop.org/wireplumber/daemon/locations.html#config-locations]

WirePlumber はバージョン 0.5 で設定形式を {{ic|.lua}} から {{ic|.conf}} に変更しました。移行の手順については [https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/migration.html#config-migration] を参照してください。

==== PipeWire Media Session ====

{{Pkg|pipewire-media-session}} は推奨されず、廃止予定(非推奨)となっています。これは主にテスト目的、および新しいセッションマネージャーを構築するための例として実装されたものです。

=== 起動 ===

PipeWire はサーバーの管理と自動的な [[ソケットアクティベーション]] に [[systemd/ユーザー]] を使用します。必要に応じて自動的に起動します。

ログイン時に PipeWire をあらかじめ起動しておくには、{{ic|pipewire.service}}、{{ic|pipewire-pulse.service}}、および {{ic|wireplumber.service}} の[[ユーザーユニット]]を[[有効化/起動]]してください。

=== GUI ===

* {{App|Cable|PipeWire および WirePlumber の設定を実行時に動的に変更するための PyQt アプリケーション。|https://github.com/magillos/Cable|{{AUR|cable}}}}
* {{App|coppwr|PipeWire 用の低レベル制御および診断 GUI。|https://github.com/dimtpap/coppwr|{{AUR|coppwr}}}}
* {{App|Helvum|JACK ツール「catia」にインスパイアされた GTK ベースのパッチベイ。接続セットの保存機能はありません。|https://gitlab.freedesktop.org/pipewire/helvum|{{Pkg|helvum}}}}
* {{App|pwvucontrol|Pipewire Volume Control。pavucontrol の代替。|https://github.com/saivert/pwvucontrol|{{AUR|pwvucontrol}}}}
* {{App|qpwgraph|JACK ツール「QjackCtl」にインスパイアされた Qt ベースのグラフ/パッチベイ。接続セットを保存できます。|https://gitlab.freedesktop.org/rncbc/qpwgraph|{{Pkg|qpwgraph}}}}
* {{App|sonusmix|Pipewire オーディオルーティングツール。|https://codeberg.org/sonusmix/sonusmix|{{AUR|sonusmix}}}}

=== TUI ===

* {{App|pipemixer|ncurses で構築された PipeWire 用の TUI ボリュームコントロールアプリケーション。|https://github.com/heather7283/pipemixer|{{AUR|pipemixer}}}}
* {{App|wiremix|PipeWire 用のシンプルな TUI オーディオミキサー。|https://github.com/tsowell/wiremix|{{Pkg|wiremix}}}}

== 設定 ==

PipeWire パッケージは、初期設定の[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PipeWire#configuration-file-pipewireconf 設定ファイル]を {{ic|/usr/share/pipewire}} に提供しています。パッケージのアップデートによって変更が上書きされてしまうため、これらのファイルを直接編集してはいけません。PipeWire を設定するには、{{ic|/usr/share/pipewire}} 内のファイルを、システム全体の代替ロケーションである {{ic|/etc/pipewire}} か、ユーザーごとのロケーションである {{ic|~/.config/pipewire}} にコピーしてください。優先順位の高いディレクトリに同名のファイルが存在する場合、それより優先順位の低いディレクトリにある同名ファイルは無視されます。

PipeWire は、PulseAudio のプロファイルに加えて、独自の [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/FAQ#what-is-the-pro-audio-profile Pro Audio] ([[プロフェッショナルオーディオ|プロオーディオ]]と混同しないでください) プロファイルを備えており、{{Pkg|pavucontrol}} から選択できます。

== 使用方法 ==

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。再起動するか、ログインし直すか、{{ic|pulseaudio.service}} を[[停止]]して、{{ic|pipewire-pulse.service}} ユーザーユニットを実行すると効果がわかります。

パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire ''x.y.z'')
...
Default Sink: alsa_output.{bus}-{device}.{profile}
Default Source: alsa_input.{bus}-{device}.{profile}
...
}}

{{man|1|pactl}} は、依存関係として ''pipewire-pulse'' とともにインストールされる PulseAudio クライアントライブラリパッケージ ({{pkg|libpulse}}) によって提供されます。

===== 全体または個別のチャンネルの音量を設定する =====

出力チャンネルのボリュームを調整するには、{{ic|pactl get-sink-volume {sink}}} を使用して、''Default Sink:'' (上記) または ''Name'' の値を使用して ''sink'' を指定する必要があります。:
'' (下記)、デフォルトのシンクデバイス (''@DEFAULT_SINK@'')、または ''Sink #'' (例: 以下の ''1''):
{{hc|$ pactl list sinks {{!}} grep -B1 -A9 State:|2=
Sink #1
State: RUNNING
Name: alsa_output.pci-0000_2d_00.4.analog-surround-51
...
Driver: PipeWire
...
Mute: no
Volume: front-left: 65536 / 100% / 0.00 dB, front-right: 65536 / 100% / 0.00 dB, rear-left: 65536 / 100% / 0.00 dB, rear-right: 65536 / 100% / 0.00 dB, front-center: 65536 / 100% / 0.00 dB, lfe: 65536 / 100% / 0.00 dB
balance 0.00
}}
ヒント: オーディオが再生されている場合、他のデバイスとして ''実行中'' の {{man|1|grep}} は ''一時停止'' されます。

''バランス'' 比率は自動的に計算されます。デフォルトのデバイスの全体のボリュームを設定するには、次のコマンドを使用します: {{bc|pactl set-sink-volume @DEFAULT_SINK@ 75%}}
個別のチャンネルを設定するには、各チャンネルのボリュームを個別に指定します:
{{bc|pactl set-sink-volume @DEFAULT_SINK@ 100% 75% 100% 75% 100% 100%}}

''ソース'' 入力も同様に処理されます。さらに詳しい設定 (モジュールなど) については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Migrate-PulseAudio Migrate PulseAudio] および [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio Pipewire-Pulse Configuration] を参照してください。

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

===== プロファイルの自動選択機能 =====

{{Pkg|pipewire-media-session}} は、入力ストリームが必要なときに、HSP/HFP と A2DP プロファイルを自動的に切り替えます。これを有効にするには、{{ic|bluez5.autoswitch-profile}} プロパティを {{ic|true}} にセットしてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf (or ~/.config/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
{
...
actions = {
update-props = {
...
bluez5.autoswitch-profile = true
...
}}

これらの機能は、[[WirePlumber]] ではまだ [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/90 実装中] です。

==== PipeWire ネイティブパッチセット ====

グラフィカルな視覚化と接続の作成のための Helvum はありますが、それ以外はまだ入っていません。以下は、ワイヤセットの保存、ワイヤセットの読み込み、すべての接続の解除を行う bash スクリプトです。保存と読み込みには、コマンドラインパラメータでファイル名を指定します。

{{hc|pw-savewires|<nowiki>
#!/bin/bash

if [[ "$#" -ne 1 ]]; then
echo
echo 'usage: pw-savewires filename'
echo
exit 0
fi

rm $1 &> /dev/null
while IFS= read -r line; do
link_on=`echo $line | cut -f 4 -d '"'`
link_op=`echo $line | cut -f 6 -d '"'`
link_in=`echo $line | cut -f 8 -d '"'`
link_ip=`echo $line | cut -f 10 -d '"'`
echo "Saving: " "'"$link_on:$link_op"','"$link_in:$link_ip"'"
echo "'"$link_on:$link_op"','"$link_in:$link_ip"'" >> $1
done < <(pw-cli dump short link)
</nowiki>}}

{{hc|pw-loadwires|<nowiki>
#!/bin/python

import sys
import csv
import os

if len(sys.argv) < 2:
print('\n usage: pw-loadwires filename\n')
quit()

with open(sys.argv[1], newline='') as csvfile:
pwwreader = csv.reader(csvfile, delimiter=',', quotechar='"')
for row in pwwreader:
print('Loading: ' + row[0] + ' --> ' + row[1])
process = os.popen('pw-link ' + row[0] + ' ' + row[1])
</nowiki>}}

{{hc|pw-dewire|<nowiki>
#!/bin/bash
while read -r line; do
echo 'Dewiring: ' $line '...'
pw-link -d $line
done < <(pw-cli dump short link {{!}} grep -Eo '^[0-9]+')
</nowiki>}}

==== ネットワーク上のコンピューターとオーディオ機器を共有する ====

PipeWire 自体はネットワーク透過型ではありませんが、そのパルス実装は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio#network-support ネットワークストリーミング] をサポートしています。ネットワーク上のコンピュータ間でオーディオを共有する簡単な方法は、[[Avahi]] デーモンを使って検出することです。
オーディオを共有するすべてのコンピュータで {{ic|avahi-daemon.service}} が実行されていることを確認してください。

ローカルのオーディオデバイスを共有するために、ホスト上で適切なモジュールをロードしてください。

pactl load-module module-native-protocol-tcp listen=''192.168.1.10'' # Use the local IP address
pactl load-module module-zeroconf-publish

次に、クライアントにディスカバリモジュールをロードします。

pactl load-module module-zeroconf-discover

===== AirPlay レシーバーにオーディオをストリーミングする =====

[[Wikipedia:ja:AirPlay#Receivers|AirPlay Receiver]] を装ったデバイスにオーディオをストリーミングすることが可能です。この機能を有効にするには、[https://docs.pipewire.org/page_module_raop_discover.html RAOP Discover モジュール] をロードします。

$ pactl load-module module-raop-discover

専用の設定ファイルを作成することで、このモジュールを自動的にロードすることもできます。

{{hc|/etc/pipewire/pipewire.conf.d/raop-discover.conf (or ~/.config/pipewire/pipewire.conf.d/raop-discover.conf)|2=
context.modules = [
{
name = libpipewire-module-raop-discover
args = { }
}
]
}}

一部のスピーカーの AirPlay 実装 (Sonos AirPlay 2 スピーカーなど) では、ソースデバイスで着信 UDP トラフィック用にポート 6001 および 6002 を開く必要がある場合があります。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

==== PipeWire シンクとして ALSA dmix デバイスを使用する ====

PipeWire サーバー(またはユーザーごとに複数) を [[Advanced Linux Sound Architecture#Dmix|ALSA dmix デバイス]] を介して ALSA に出力することが可能です。これにより、ALSA を主要な音声出力システムとして使用しながら、Bluetooth ヘッドフォンなどの ALSA 以外のデバイスを使用することができるようになります。

===== ALSA dmix セットアップ =====

{{ic|PCH}} と {{ic|HDMI}} の 2 枚のカードがあるとします。

{{hc|/proc/asound/cards|
0 [PCH ]: HDA-Intel - HDA Intel PCH
HDA Intel PCH at 0xdff40000 irq 146
1 [HDMI ]: HDA-Intel - HDA ATI HDMI
HDA ATI HDMI at 0xdfe60000 irq 147
}}

PCM は次のようになります。

{{hc|/proc/asound/pcm|
00-00: ALC1220 Analog : ALC1220 Analog : playback 1 : capture 1
00-02: ALC1220 Alt Analog : ALC1220 Alt Analog : capture 1
01-03: HDMI 0 : HDMI 0 : playback 1
01-07: HDMI 1 : HDMI 1 : playback 1
01-08: HDMI 2 : HDMI 2 : playback 1
01-09: HDMI 3 : HDMI 3 : playback 1
01-10: HDMI 4 : HDMI 4 : playback 1
01-11: HDMI 5 : HDMI 5 : playback 1
}}

ALSA 設定が次のようになっているとします。

{{hc|/etc/asound.conf|
ctl.!default {
type hw
card PCH
}

pcm.!default {
type plug
slave.pcm "'''dmix:PCH,0'''"
}

pcm.dhdmi {
type plug
slave.pcm "'''dmix:HDMI,9'''"
}
}}

この特定の例では、dmix デバイスは {{ic|dmix:PCH,0}} と {{ic|dmix:HDMI,9}} になります。

===== PipeWire dmix セットアップ =====

まず、{{ic|alsa_monitor.enable()}} をコメントアウトして、{{ic|wireplumber}} によるハードウェア ALSA デバイスの監視と追加を停止します。

{{hc|/etc/wireplumber/main.lua.d/90-enable-all.lua (or ~/.config/wireplumber/main.lua.d/90-enable-all.lua)|
...
-- Load devices
'''-- alsa_monitor.enable()'''
v4l2_monitor.enable()
libcamera_monitor.enable()
...
}}

ここで、dmix デバイスを使用するように {{ic|pipewire}} を設定します。デフォルトの設定ファイル ({{ic|/usr/share/pipewire/pipewire.conf}}) には [https://gitlab.freedesktop.org/pipewire/pipewire/-/blob/0.3.59/src/daemon /pipewire.conf.in#L219-239 コメントアウトされた例] をベースとして使用できます。

独自の要素を {{ic|context.objects}} 配列に追加します。

{{hc|/etc/pipewire/pipewire.conf.d/alsa-dmix.conf (or ~/.config/pipewire/pipewire.conf.d/alsa-dmix.conf)|output=
context.objects = [
# We do not start with dmix, but with an input device.
# Do not forget to add an input device.
# On a friend's Laptop, I saw Zoom having a nervous
# breakdown and endlessly crying because no input device
# was configured! You have been warned.
{ factory = adapter
args = {
factory.name = api.alsa.pcm.source
node.name = "alsa-mic-internal" # name of pulse device (mpv)
node.description = "Mic Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Source"
api.alsa.path = "'''hw:PCH,0'''"
}
}
# Okay, now we add our dmix PCMs
{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-internal" # name of pulse device (mpv)
node.description = "PCM Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
api.alsa.path = "'''dmix:PCH,0'''"
}
}

{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-hdmi" # name of pulse device (mpv)
node.description = "PCM HDMI" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
# remember this is a non-default dmix from /etc/asound.conf
api.alsa.path = "'''dmix:HDMI,9'''"
}
}
]
}}

ユーザー (非 root) として、{{ic|wpctl status}} の出力を確認し、{{ic|wpctl set-default ''ID''}} でデフォルトの入力(ソース) と出力 (シンク) のデバイスを好みのものに設定します。{ic|''ID''}} はシンク/ソース名の前の数字です。

これで、構成を完全にテストすることができます。

==== デバイスプロファイルの切り替え ====

{{ic|snd_hda_intel}} などの一部のハードウェアオーディオデバイスは、デバイスが実行されているプロファイルによって機能が異なります。{{ic|snd_hda_intel}} の場合、HDMI とアナログ出力用に個別のプロファイルがあります。

WirePlumber で HDMI に切り替える:

{{hc|
$ wpctl set-profile <device-ID> 3
$ wpctl status
|output=
...
├─ Sinks:
│ * 53. Built-in Audio Digital Stereo (HDMI) [vol: 1.00]
...
}}

WirePlumber でアナログに切り替える:

{{hc|
$ wpctl set-profile <device-ID> 1
$ wpctl status
|output=
...
├─ Sinks:
│ * 51. Built-in Audio Analog Stereo [vol: 0.60]
...
}}

=== WebRTC 画面共有 ===

ほとんどのアプリケーションは、例えばウェブブラウザで WebRTC を使うとき (例: Google Meet) などに、デスクトップ (あるいは個々のアプリケーション) をキャプチャするために X11 に依存していました。Wayland では、セキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して、Wayland 上のコンテンツを共有できます。

{{Tip|WebRTC 画面共有が機能しているかどうか、[https://mozilla.github.io/webrtc-landing/gum_test.html Mozilla の GetUserMedia WebRTX テストページ]でテストしましょう。}}

{{Note|1={{Pkg|xdg-desktop-portal}} 1.10.0 では、D-Bus インターフェースの仕様と実装の不一致が修正されました。[https://github.com/flatpak/xdg-desktop-portal/pull/609] そのため、一部のクライアントは xdg-desktop-portal 1.10.0 またはそれ以降で動作しないかもしれません。}}

Firefox (バージョン84以降) と Chromium (バージョン110以降) はデフォルトでこの方法をサポートしていますが、Chromium の古いバージョン (バージョン73以降) では、URL {{ic|chrome://flags/#enable-webrtc-pipewire-capturer}} で対応する (実験的) フラグを設定するか、CLI 引数 {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を用いて、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWire サポート] を有効化する必要があります。

{{Pkg|obs-studio}} (バージョン27以降) は、新しい PipeWire キャプチャソースを使用することにより、この方法をサポートしています。

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインを使用して設定なしで動作するはずです ([[GStreamer#PipeWire]] を参照してください)。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

{{Pkg|pipewire-v4l2}} を使用すると、{{ic|pw-v4l2}} スクリプトを使用してライブラリをプリロードすることも可能になります ({{ic|/lib/pipewire-0.3/v4l2/libpw-v4l2.so}}) は、v4l2 呼び出しをインターセプトし、PipeWire 経由でビデオをルーティングします。

== 音声のポストプロセッシング ==

=== Pipewire モジュールフィルターチェーン ===

Pipewire には {{ic|[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Filter-Chain filter-chain]}} という内部モジュールがあり、音声の入出力を処理するノードを作成することができます。参照してください。
/usr/share/pipewire/filter-chain/ を参照してください。
イコライザー、バーチャルサラウンドサウンド、LADSPA プラグイン、チャンネルミキシングなどの例を紹介します。

==== システム全体のパラメトリックイコライゼーション ====

設定ファイルを {{ic|.config}} フォルダにコピーします。
mkdir -p ~/.config/pipewire/pipewire.conf.d
cp /usr/share/pipewire/filter-chain/sink-eq6.conf ~/.config/pipewire/pipewire.conf.d/
次に、{{ic|sink-eq6.conf}} を編集して、必要なパラメータを組み込みます。ヘッドフォンの場合、これらは [https://old.reddit.com/r/oratory1990/wiki/index Oratory1990 のデータベース] から入手できます。そこにリストされていない場合は、[https://github.com/jaakkopasanen/AutoEq/tree/master/results/ AutoEQ project]

プリアンプが必要な場合は、{{ic|eq_band_1}} を変更して、{{ic|bq_highshelf}} フィルタを周波数 0Hz でマイナスゲイン (-120 〜 +20dB のゲインをサポート) で適用します。
label = bq_highshelf
control = { "Freq" = 0 "Q" = 1.0 "Gain" = -7.5 }

6 バンドを超える場合は、{{ic|nodes}} リストと対応する {{ic|links}} にさらにエントリを追加して、1 つのフィルタ ":Out" を次のフィルタ ":In" に接続します。たとえば、11 に増やします。バンド (プリアンプ + 10):
{ output = "eq_band_6:Out" input = "eq_band_7:In" }
{ output = "eq_band_7:Out" input = "eq_band_8:In" }
{ output = "eq_band_8:Out" input = "eq_band_9:In" }
{ output = "eq_band_9:Out" input = "eq_band_10:In" }
{ output = "eq_band_10:Out" input = "eq_band_11:In" }

Pipewire を再起動し、デフォルトのサウンド出力デバイスとして "Equalizer Sink" を選択します。これは、すべてのアプリケーションに適用されます。

=== EasyEffects ===

EasyEffects (以前は PulseEffects と呼ばれていました) は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/easyeffects GitHub ページ]にエフェクトの一覧があります。

EasyEffects を使用するには、{{pkg|easyeffects}} をインストールします。プリセット設定集については、[https://github.com/wwmm/easyeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

{{Note|PulseEffects の古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

=== NoiseTorch ===

{{aur|noisetorch}} はノイズ抑制に使用できます。ビルド済み ({{aur|noisetorch-bin}}) や開発版 ({{aur|noisetorch-git}}) のパッケージもあります。

起動すると選択したマイクにモジュールを読み込むことができます。声が出力される閾値を調整することができます。実際の声が削除されない最大のレベルに設定するべきです。

=== Noise suppression for voice ===

{{pkg|noise-suppression-for-voice}} をインストールし、以下のいずれかのオプションを使用します:

* 以下の行を {{ic|context.exec}} セクションに追加する:

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.exec = [
...
{ path = "/usr/bin/pipewire" args = "-c /usr/share/pipewire/filter-chain/source-rnnoise.conf" }
...
}}

* https://github.com/werman/noise-suppression-for-voice#pipewire に従う

そして、オーディオ設定でノイズキャンセルソースをデフォルトとして設定します。この機能を使う前に、アプリケーションを再起動する必要があるかもしれません。

=== JamesDSP ===

[https://github.com/Audio4Linux/JDSP4Linux#readme JamesDSP for Linux] ({{AUR|jamesdsp}} として入手可能) は PipeWire と PulseAudio のためのオープンソースのサウンドエフェクトを提供します。LADSPA や Calf などに依存することなく、独自のエフェクトエンジンを使用しています。JamesDSP は当初 Android デバイス用のオーディオエフェクトプロセッサーとして公開されました。

=== LADSPA、LV2、VST プラグイン ===

LADSPA、LV2、VSTのプラグインを使用したい場合は、カスタム PulseAudio null シンクと Carla Jack ホストを利用できます。{{pkg|pipewire-pulse}} と {{pkg|pipewire-jack}} と {{pkg|carla}} をインストールします。はじめに {{ic|default_null_sink}} という名前の PulseAudio の null シンクを作成します。

pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=default_null_sink channel_map=FL,FR

{{ic|pw-jack carla-rack}} で PipeWire を使用する Carla を起動します。''Rack'' タブで使いたいプラグインを全て追加します。プラグインのタイプが ''stereo'' であることを確認してください。適用する順番を変えることができます。EasyEffectsのようにリストの最初のプラグインが最初に入力の音声ストリームを受け取ります。その後 ''Patchbay'' タブに移動し {{ic|default_null_sink}} の L/R monitor を Carla input に接続し、Carla output を出力したいデバイス (スピーカーやイヤホンや HDMI 出力など) の playback に接続します。設定をフォルダに保存します ({{ic|~/Documents/carla_sink_effects.carxp}} など)。

Firefox で動画を見ている時など、アプリケーションが音声を再生している時に効果を試すことができます。2つの方法があります。一つは Carla の ''Patchbay'' タブで Firefox の接続を全て外し {{ic|default_null_sink}} の L/R output に接続する方法です。もう一つは {{pkg|pavucontrol}} を使用し Firefox の音声ストリームを {{ic|default_null_sink}} に変更する方法です (この方法は同じアプリケーションの次回起動時に同じ接続先を使用するはずです)。

これらの設定を起動時に適用するには、まず2つの systemd ユーザーサービスを作成します:

{{hc|~/.config/systemd/user/jack-carla-rack.service|output=
[Unit]
Description=Load Carla Rack JACK host

[Service]
PassEnvironment="PIPEWIRE_LINK_PASSIVE=true"
Type=exec
ExecStart=/usr/bin/pw-jack carla-rack -n

[Install]
WantedBy=default.target
}}
{{hc|~/.config/systemd/user/pulseaudio-null-sink@.service|output=
[Unit]
Description=Load %i Pulseaudio null sink
Before=jack-carla-rack.service
After=pipewire-pulse.service

[Service]
Type=oneshot
ExecStart=/usr/bin/pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=%i channel_map=FL,FR
ExecStop=/usr/bin/pactl unload-module module-null-sink
RemainAfterExit=yes

[Install]
WantedBy=default.target
}}

''jack-carla-rack'' サービスの ''Environment'' を Carla の設定ファイルのフルパスを指定するよう上書きします:

{{hc|~/.config/systemd/user/jack-carla-rack.service.d/override.conf|output=
Environment="CARLA_CONFIG_FILE=/home/username/Documents/carla_sink_effects.carxp"
ExecStart=
ExecStart=/usr/bin/pw-jack carla-rack -n $CARLA_CONFIG_FILE
}}

最後に、作成したサービスを有効化します。''pulseaudio-null-sink'' サービスには {{ic|default_null_sink}} 引数をつけてください:

systemctl --user enable pulseaudio-null-sink@default_null_sink.service
systemctl --user enable jack-carla-rack.service

{{Note|システム設定で {{ic|default_null_sink}} をデフォルトデバイスに設定すると、全てのアプリケーションが {{ic|default_null_sink}} にリダイレクトされ、音量の変更がスピーカーではなく {{ic|default_null_sink}} に対して行われるようになります。スピーカーの音量を変更したい場合は、デフォルトデバイスをスピーカーから変更せずにアプリケーションの出力先を pavucontrol で {{ic|default_null_sink}} に変更してください (PipeWire の互換性レイヤーは次回起動時も出力先を覚えています)。}}

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

=== オーディオ ===

==== PipeWire にマイクが検出されない ====

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{Pkg|alsa-card-profiles}} を使ってデバイスを検出します。これがうまくいかない場合は、{{ic|api.alsa.use-acp}} をオフにするか、オプションで {{ic|api.alsa.use-ucm}} をオンにすることを試してみてください。

{{Pkg|pipewire-media-session}} を使用している場合。
{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf)|output=
...
rules = [
{
...
actions = {
update-props = {
...
api.alsa.use-acp = false
...
}}

それ以外の場合は、{{Pkg|wireplumber}} を使用している場合。
{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|output=
...
alsa_monitor.rules = {
{
...
apply_properties = {
-- Use ALSA-Card-Profile devices. They use UCM or the profile
-- configuration to configure the device and mixer settings.
-- ["api.alsa.use-acp"] = true,

-- Use UCM instead of profile when available. Can be
-- disabled to skip trying to use the UCM profile.
["api.alsa.use-ucm"] = true,
...
}}

その後、pipewire を再起動し、利用可能なデバイスを確認します。

{{hc| 1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

==== 新しいデバイスを接続したときにサウンドが自動的に切り替わらない ====

新しく接続されたデバイスに自動的に切り替えるには、次のファイルを作成します。:

{{hc|/etc/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf (or ~/.config/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf)|output=
# override for pipewire-pulse.conf file
pulse.cmd = [
{ cmd = "load-module" args = "module-always-sink" flags = [ ] }
{ cmd = "load-module" args = "module-switch-on-connect" }
]
}}

==== サウンドが自動的に Bluetooth ヘッドフォンに切り替わらない ====

{{ic|pactl load-module module-switch-on-connect}} を実行し、ログイン時に自動的にそのコマンドが実行されるようにデスクトップ環境を設定してください。詳しくは [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/89 wireplumber issue #89] を見てください。

==== Bluetooth デバイスに接続しても音が出ない ====

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

==== 音量が小さい ====

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

==== increasing RLIMIT_MEMLOCK ====

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

==== サンプリングレートを変更する ====

PipeWire のデフォルトでは、グローバルサンプルレートは 48kHz に設定されています。これを変更したい場合(より高い値をサポートする DAC を所有しているなど)、設定ファイル {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} 行を編集することで行うことができます。例えば、192kHz にしたい場合は、{{ic|48000}} を {{ic|1=default.clock.rate = 192000}} にコメントを解除して変更します。

PipeWire は、DAC がサポートする出力サンプルレートを変更することもできます。設定するには、{{ic|1=default.clock.allowed-rates = [ 48000 ]}} という行をコメント解除して設定します。例えば、{{ic|[ 44100 48000 88200 96000 ]}} とします。サンプルレートは、カードがアイドルのときに再生されるオーディオストリームのサンプルレートに従います。

どの出力サンプルレートとサンプルフォーマットが DAC に送られたデータであるかを確認するには(おそらく桁を変更する必要があります)。
cat /proc/asound/card0/pcm0p/sub0/hw_params
どの入力サンプルレートを使用しているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します。({{ic|c}} は "capture" の略、{{ic|p}} は "playback" の略です).

==== 許容されるサンプルレートの変更 ====

PipeWire は、DAC がサポートする出力サンプルレートを動的に変更することもできます。サンプルレートは、再生中のオーディオストリームのサンプルレートに従います。

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.properties = {
...
'''default.clock.allowed-rates = [ ''sample_rate_1'' ''sample_rate_2'' ''sample_rate_3'' ... ]'''
...
}}
たとえば、{{ic|[ 44100 48000 88200 96000 ]}} です。DAC でサポートされている値については、ハードウェアのマニュアルを参照してください。

開発者の [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1523] によると: "PipeWire は最大16の異なるサンプルレートを許容し、可能な限り切り替えます。" つまり、上記の設定では、'''再サンプリングは行われない'''ということです。

DAC に送信されるデータがどの出力サンプルレートとサンプルフォーマットであるかを確認するには (おそらく桁を変更する必要があります):

$ cat /proc/asound/card0/pcm0p/sub0/hw_params

どの入力サンプルレートが使用されているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します ({{ic|c}} は "capture" の略で、{{ic|p}} は "playback" の略です)

==== 音質 (リサンプリング品質) ====

PulseAudio を {{ic|1=resample-method = speex-float-10}} または {{ic|soxr-vhq}} で使用していた場合、コメントを解除して {{ic|1=resample.XXX}} を変更することを検討するとよいかもしれません。{{ic|1=resample.quality = 4}} を {{ic|10}} または最大値 {{ic|15}} に変更することを検討してください。(存在しない場合は {{ic|/usr/share/pipewire/}} からコピーしてください)。PipeWire の再起動を忘れないでください (sudo なし): {{ic|systemctl --user restart pipewire.service pipewire-pulse.socket}} (設定変更を適用させたい場合は、{{ic|pipewire-pulse.socket}}を絶対に忘れないでください)。

{{ic|10}} と {{ic|15}} では、品質の差はほとんどありませんが、CPU 負荷は 2〜3 倍になっています。また、{{ic|4}}, {{ic|10}}, {{ic|15}} のレイテンシーの差はまだ誰も調べていません。Ryzen 2600 で 44100→48000Hz で {{ic|1= resample.quality = 15}} にすると {{ic|pipewire}} や {{ic|pipewire-pulse}} プロセスが 1CPUコア4.0% の負荷となる。

リサンプラーの比較はこちら:https://src.infinitewave.ca/(18KHz以上、120dB以上は注意)。speeex は ''Xiph.org Speex'' と記載されています。

PipeWire は Spa と呼ばれる独自のリサンプリングアルゴリズムを使用しています。SoX の {{ic|sox}}、Speex の {{ic|speexenc}} と同様、PipeWire にはそのスタンドアロン版があります。{{ic|spa-resample}} 使い方は
spa-resample -q 15 -f s24 -r 48000 input16bit44100orAnythingElse.wav output24bit48000hz.wav

自分で sink を作れば、他のリサンプラーを使うことも可能でしょう。あるいは、音楽プレーヤーのプラグインを使うこともできます(例えば、Qmmp には SoX プラグインがあります)

==== 外付けサウンドカードが再接続後に有効にならない ====

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

==== 音が出ないまたは pactl info が Failure: Connection refused と表示する ====

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (OFTC の [ircs://irc.oftc.net/pipewire #pipewire]) かメーリングリストで相談してください。

==== Bluetooth の音声の品質が低い====

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...
}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...
}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

==== 再生開始時に明らかな音声の遅延やポップノイズ/音割れが発生する ====

これは、非アクティブ時のノードの一時停止が原因です。

{{pkg|pipiwire-media-session}} を使用:

これを無効にするには、遅延が発生する場所に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を 0 に変更します。無効にするか、他の値を試して、何が機能するかを確認します。

または、{{ic|/etc/pipewire/media-session.d/media-session.conf}} の行 {{ic|suspend-node}} をコメントアウトすることもできます。

[[再起動]] して {{ic|pipewire.service}} と {{ic|pipewire-pulse.service}} の両方の変更を適用して下さい。

{{pkg|wireplumber}} で、新しいファイルを作成してデフォルト設定を上書きします:

{{hc|~/.config/wireplumber/main.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/main.lua.d/51-disable-suspension.lua)|2=
table.insert (alsa_monitor.rules, {
matches = {
{
-- Matches all sources.
{ "node.name", "matches", "alsa_input.*" },
},
{
-- Matches all sinks.
{ "node.name", "matches", "alsa_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

Bluetooth デバイスの場合は、次の設定も使用します (ファイルの場所が異なることに注意してください):

{{hc|~/.config/wireplumber/bluetooth.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/bluetooth.lua.d/51-disable-suspension.lua)|2=
-- Note: bluez_monitor, not alsa_monitor
table.insert (bluez_monitor.rules, {
matches = {
{
-- Matches all sources.
-- Note: bluez_input, not alsa_input
{ "node.name", "matches", "bluez_input.*" },
},
{
-- Matches all sinks.
-- Note: bluez_output, not alsa_output
{ "node.name", "matches", "bluez_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

{{ic|pipewire.service}} と {{ic|wireplumber.service}} を再起動して、変更を適用します。

サスペンドを完全に無効にする代わりに、タイムアウト値を、ソースがサスペンドされるまでに必要な遅延秒数に変更することもできます。

==== 複数のストリームの再生が開始されると音声が途切れる ====

この問題は通常、{{ic|pipewire-pulse.service}} [[systemd/ユーザー|ユーザーユニット]] の [[journal]] を読み取り、次のような行を見つけることで診断できます。

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド] によると、{{pkg|pipewire-media-session}} のこの問題を解決するには:

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf|2=
api.alsa.headroom = 1024
}}

{{pkg|wireplumber}} を使用する場合:

{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|2=
apply_properties = {
["api.alsa.headroom"] = 1024,
},
}}

カーネルページのロックやスケジューリングの遅延が原因で音声の途切れが発生する場合は、[[ゲーム#カーネルパラメータを調整して応答時間を安定化させる|カーネルパラメータを調整して応答時間を安定化させる]] を参照してください。

==== 音がひずむ ====
* マイクについては、{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。
* {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} のコメントを外して、値を {{ic|44100}} に下げてみてください。

==== スタンバイ後に音声の問題が発生する ====

スリープから復帰した際に音が消えたり壊れたりする場合は、ALSA を最初期化すると改善するかもしれません:

# alsactl init

==== USB DAC(例:Schiit 社製 DAC)で高レイテンシー ====

サンプルレートやフォーマットを変更することで、Schiit Hel 2 などの一部の DAC でレイテンシーを減らすことができるかもしれません [https://www.reddit.com/r/osugame/comments/msifdd/usb_dacamp_and_audio_lag/] ''pipewire-media-session'' のマッチングルールを使用すると、デバイスのプロパティを設定することができます [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-pipewire-media-session#matching-rules]
''pipewire-media-session'' の {{ic|alsa-monitor.conf}} のデフォルト設定を {{ic|/etc/pipewire/media-session.d}} か {{ic|~/.config/pipewire/media-session.d}} にコピーしてください。
そして、以下のような新しいルールブロックを追加してください。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf
~/.config/pipewire/media-session.d/alsa-monitor.conf|output=
rules = {
...
{
matches = [
{
node.name = "alsa_output.<name of node>"
}
]
actions = {
update-props = {
audio.format = "S24_3LE"
audio.rate = 96000
# Following value should be doubled until audio doesn't cut out or other issues stop occurring
api.alsa.period-size = 128
}
}
}
...
}
}}

{{ic|alsa_output.<node name>}} ノードは {{ic|pw-top}} で取得することができます。

DAC は異なるフォーマットやサンプルレートをサポートしているかもしれません。[[ALSA]] に問い合わせることで、あなたの DAC が何をサポートしているかを確認することができます。

まず、DAC のカード番号を取得します。

{{hc|$ aplay -l|
...
card 3: S2 [Schiit Hel 2], device 0: USB Audio [USB Audio]
Subdevices: 0/1
Subdevice #0: subdevice #0
...
}}

つまり、この例ではカード3ということになります。
サポートされているすべてのサンプルレートとフォーマットを取得します。

{{hc|$ cat /proc/asound/cardX/streamX|
...
Playback:
...
Interface 1
Altset 1
Format: S16_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 16
...
Interface 1
Altset 2
Format: S24_3LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 24
...
Interface 1
Altset 3
Format: S32_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 32
...
...
}}

この場合、{{ic|S16_LE, S24_3LE, S32_LE}} はサポートされているフォーマットで、{{ic|44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000}} はすべてのフォーマットでサポートされているサンプルレートとなります。

==== 音量が 30% になるまで USB DAC から音が出ない ====

USB DAC の中には、ある一定の音量に達するまで音が出なくなるものがあります [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1117] 一般的にこれは約 25%〜30% で、最初の音量が不快なほど大きくなり、低い音量を維持することができなくなります。解決策としては、{{ic|["api.alsa.soft-mixer"]}} を {{ic|true}} に設定して、ハードウェアミキサーの音量コントロールを無視することが挙げられます。

{{Pkg|wireplumber}} でこれを実現するには、{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}} 設定に次を使用して構成フラグメントを追加します。 {{ic|table.insert}}:

{{hc|~/.config/wireplumber/main.lua.d/51-volume-fix.lua|output=

table.insert (alsa_monitor.rules, {
matches = {
{
-- This matches all cards.
{ "device.name", "matches", "alsa_card.*" },
},
},
-- Apply properties on the matched object.
apply_properties = {
-- Don't use the hardware mixer for volume control. It
-- will only use software volume. The mixer is still used
-- to mute unused paths based on the selected port.
["api.alsa.soft-mixer"] = true,
}
})
}}

次に、pipewire を再起動します。{{ic|alsamixer}} でマスターボリュームを設定し、{{ic|# alsactl store}} で設定を保存します。これで、ボリュームミキサーを通常どおり使用できるようになります。

==== リアルタイムオーディオが動作しない ====

{{ic|RTKit error: org.freedesktop.DBus.Error.AccessDenied}} が {{ic|systemctl --user status pipewire.service}} の出力に表示された場合、pipewire daemon の優先度がリアルタイムに変更されていないことを示します。この問題については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1069] を参照してください。

==== 同じサウンドカード上の複数のシンクへの同時出力 ====

{{ic|/usr/share/alsa-card-profile/mixer/profile-sets/default.conf}} のコピーを作成し、アップデート後も変更が持続するようにします。ここでは、アナログと HDMI の2つのデフォルトマッピングを結合したプロファイルを定義しています。

{{hc|/usr/share/alsa-card-profile/mixer/profile-sets/multiple.conf|2=
[General]
auto-profiles = no

[Mapping analog-stereo]
device-strings = front:%f
channel-map = left,right
paths-output = analog-output analog-output-lineout analog-output-speaker analog-output-headphones analog-output-headphones-2
paths-input = analog-input-front-mic analog-input-rear-mic analog-input-internal-mic analog-input-dock-mic analog-input analog-input-mic analog-input-linein analog-input-aux analog-input-video analog-input-tvtuner analog-input-fm analog-input-mic-line analog-input-headphone-mic analog-input-headset-mic
priority = 15

[Mapping hdmi-stereo]
description = Digital Stereo (HDMI)
device-strings = hdmi:%f
paths-output = hdmi-output-0
channel-map = left,right
priority = 9
direction = output

[Profile multiple]
description = Analog Stereo Duplex + Digital Stereo (HDMI) Output
output-mappings = analog-stereo hdmi-stereo
input-mappings = analog-stereo
}}

ここで、PipeWire の media-session に、新しい card-profile を使用してデバイスをマッチングするように設定します。識別情報は、{{ic|$ pw-cli dump device}} で見つけることができます。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf|2=
rules = [
{
matches = [ { alsa.card_name = "HDA Intel PCH" } ]
actions = {
update-props = {
api.alsa.use-acp = true
device.profile-set = "multiple.conf"
device.profile = "multiple"
api.acp.auto-profile = false
api.acp.auto-port = false
}
}
}
]
}}

==== Discord から通知音が鳴らない ====

min.quantum が低すぎることが原因かもしれませんので、700以上に設定してみてください。pipewire-pulse.conf の pulse.rules セクションに以下のルールを追加することで、Discord 専用にオーバーライドすることが可能です。

{{hc|/etc/pipewire/pipewire-pulse.conf (or ~/.config/pipewire/pipewire-pulse.conf)|output=
...
pulse.rules = [
...
{
# Discord notification sounds fix
matches = [ { application.process.binary = "Discord" } ]
actions = {
update-props = {
pulse.min.quantum = 1024/48000 # 21ms
}
}
}
...
}}

==== PipeWire で FMOD ゲームがクラッシュする ====

[[Wikipedia:Pillars_of_Eternity|Pillars of Eternity]] のような古いバージョンの [[Wikipedia:FMOD|FMOD オーディオエンジン]] を使っているゲームの中には、PulseAudio バイナリが存在しないと {{ic|pulseaudio --check}} を呼び出してクラッシュするものがあります。回避策としては、{{ic|/bin/pulseaudio}}を{{ic|/bin/true}}にシンボリックリンクすることです[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1514]

# ln -s /bin/true /bin/pulseaudio

PulseAudio を再インストールする場合は、シンボリックリンクを削除する必要があることに注意してください。

==== 自動切り替えが機能しない ====

自動切り替えが機能しない場合、[[WirePlumber]] の状態に問題がある可能性があります。[https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/191#note_1252549 this comment] が提案しているように、[[WirePlumber]] のローカル状態を削除し、デーモンを再起動することで改善されるかどうか確認することができます。

$ rm -r ~/.local/state/wireplumber/

次に、{{ic|wireplumber.service}} [[systemd/ユーザー|ユーザーユニット]] を [[ヘルプ:読み方# systemd ユニットのコントロール|再起動]] します。

==== リアルタイムプライオリティの欠落/サスペンド後の負荷によるクラックリング ====

rtkit の [https://github.com/heftig/rtkit/issues/13 2011年] からのバグにより、サスペンドイベントが発生すると PipeWire のリアルタイム優先度が取り消され、元に戻らなくなります。この原因となる保護を無効にするには、{{ic|rtkit-daemon.service}} を [[編集]] してください:

{{hc|/etc/systemd/system/rtkit-daemon.service.d/override.conf|2=
[Service]
ExecStart=
ExecStart=/usr/lib/rtkit-daemon --no-canary
}}

次に、メディアセッションサービスとともに、{{ic|rtkit-daemon.service}} ユニットと {{ic|pipewire.service}} ユーザーユニットを再起動します。

==== RAOP デバイス (Sonos など) へのストリーミング中に音が出ない ====

[[Avahi]] または [[systemd-resolved]] を使用して mDNS ホスト名解決を設定します。

==== KDE Plasma でサウンドデバイスが表示されない ====

PipeWire クライアント (デスクトップ環境を含む) は、[https://specations.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables XDG_RUNTIME_DIR] [[環境変数]] に依存して PipeWire デーモンに接続する場合があります。[https://docs.pipewire.org/page_daemon.html] ログイン直後にサウンドデバイスが表示されない場合は、この変数が手動で間違ったパスに設定されている可能性があります。

これは PipeWire を手動で再起動することで解決できますが、Chromium で画面共有できない ({{ic|pipewire context failed}} により) など、他の問題が依然として発生する可能性があります。{{ic|XDG_RUNTIME_DIR}} は {{man|8|pam_systemd}} によって自動的に設定されるため、初期化ファイルに設定されているインスタンスをすべて削除する必要があります。

==== SDDM ユーザーのデバイス音量がログイン時に復元されない ====

SDDM を使用していて、ログイン後にオーディオの音量レベルが正しく復元されない場合は、SDDM に対して Pipewire をマスクしてください。SDDM で実行される Wireplumber が、ユーザーの Wireplumber セッションに干渉する可能性があります。

systemctl --user -M sddm@ mask pipewire.socket

詳細については、[https://wiki.debian.org/PipeWire#Device_volume_for_SDDM_users_is_not_restored_on_login Debian Wiki] の記事を参照してください。

==== ターミナルベルが動作しない ====

PipeWire の観点からは、module x11.bell がロードされている必要があります。これはデフォルトの設定です(上記の設定ファイルも参照){{Pkg|pipewire-x11-bell}} パッケージがインストールされているか確認してください。

また、ウィンドウマネージャーがターミナルベルに影響を与えることがあります。例えば、xfwm を使用している場合は、xfwm-terminal の設定で "聴ベル(Audible bell)" が有効になっているか確認してください。

次に、PipeWire サービスを再起動します:

systemctl --user restart pipewire

ターミナルベルが動作するか試すには、以下のコマンドを実行します:

echo $'\a'

==== 最初の再生試行まで音が出ない ====

PipeWire がソケットアクティベーションによって起動される設定になっている場合、一部の PipeWire ネイティブアプリケーションにおいて、[[WirePlumber]] がノードを構成する前にオーディオの再生を試みてしまい、結果としてエラーが発生することがあります。

例:

{{hc|$ mpv -v ''/path/to/file''|
[ao/pipewire] PipeWire does not have any audio sinks, skipping
[ao] Failed to initialize audio driver 'pipewire'
}}

{{hc|$ journalctl --user -u mpd.service|
output: Failed to play on "PipeWire" (pipewire): no target node available
exception: Failed to open audio output
}}

回避策として、{{ic|pipewire.service}} の[[ユーザーユニット]]を[[有効化]]してください。

=== ビデオ ===

==== OBS(など)がウィンドウ/スクリーンを要求しても何も表示されない ====

{{Pkg|xdg-desktop-portal}} と {{Pkg|xdg-desktop-portal-gtk}} または {{Pkg|xdg-desktop-portal-kde}} がインストールされていることが確実なら、デーモンの実行状態を確認してください。

OBS では、すべてがうまくいっていれば、{{ic|stdout}} にこのように表示されるはずです。

...
info: [pipewire] desktop selected, setting up screencast
info: [pipewire] created stream 0x5632d7456850
info: [pipewire] playing stream...

マルチモニタ環境では、{{Pkg|slurp}} パッケージを使用すると、すべての画面をキャプチャすることができます。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

PipeWire

2026-02-20T08:58:55Z

Kgx: /* インストール */ 同期

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[[pt:PipeWire]]
[[ru:PipeWire]]
[[zh-hans:PipeWire]]
{{Related articles start}}
{{Related|PipeWire/サンプル}}
{{Related|WirePlumber}}
{{Related articles end}}
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、[[PulseAudio]]、[[JACK]]、[[ALSA]]、[[GStreamer]] をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリから {{Pkg|pipewire}} パッケージを[[インストール]]してください。[[multilib]] サポート用として {{Pkg|lib32-pipewire}} も用意されています。

オプションとして、ドキュメントを確認するために {{Pkg|pipewire-docs}} をインストールすることもできます。

PipeWireは他のオーディオサーバーのドロップイン代替(そのまま置き換え可能な代用)として機能します。詳細は [[#オーディオ]] を参照してください。

=== セッションマネージャー ===

[[JACK]] と同様に、PipeWire 自体は内部に接続ロジックを実装していません。新しいストリームを監視し、それらを適切な出力デバイスやアプリケーションに接続する役割は、「セッションマネージャー」と呼ばれる外部コンポーネントに委ねられています。

==== WirePlumber ====

[[WirePlumber]] は推奨されるセッションマネージャーです。モジュール設計に基づいており、実際の管理機能は Lua プラグインによって実装されています。

標準の設定ファイルは {{ic|/usr/share/wireplumber}} に保存されています。WirePlumber をカスタマイズする推奨される方法は、{{ic|/etc/wireplumber}} または {{ic|~/.config/wireplumber}} に特定の設定を上書きするスニペットを追加することです。[https://pipewire.pages.freedesktop.org/wireplumber/daemon/locations.html#config-locations]

WirePlumber はバージョン 0.5 で設定形式を {{ic|.lua}} から {{ic|.conf}} に変更しました。移行の手順については [https://pipewire.pages.freedesktop.org/wireplumber/daemon/configuration/migration.html#config-migration] を参照してください。

==== PipeWire Media Session ====

{{Pkg|pipewire-media-session}} は推奨されず、廃止予定(非推奨)となっています。これは主にテスト目的、および新しいセッションマネージャーを構築するための例として実装されたものです。

=== 起動 ===

PipeWire はサーバーの管理と自動的な [[ソケットアクティベーション]] に [[systemd/ユーザー]] を使用します。必要に応じて自動的に起動します。

ログイン時に PipeWire をあらかじめ起動しておくには、{{ic|pipewire.service}}、{{ic|pipewire-pulse.service}}、および {{ic|wireplumber.service}} の[[ユーザーユニット]]を[[有効化/起動]]してください。

=== GUI ===

* {{App|Cable|PipeWire および WirePlumber の設定を実行時に動的に変更するための PyQt アプリケーション。|https://github.com/magillos/Cable|{{AUR|cable}}}}
* {{App|coppwr|PipeWire 用の低レベル制御および診断 GUI。|https://github.com/dimtpap/coppwr|{{AUR|coppwr}}}}
* {{App|Helvum|JACK ツール「catia」にインスパイアされた GTK ベースのパッチベイ。接続セットの保存機能はありません。|https://gitlab.freedesktop.org/pipewire/helvum|{{Pkg|helvum}}}}
* {{App|pwvucontrol|Pipewire Volume Control。pavucontrol の代替。|https://github.com/saivert/pwvucontrol|{{AUR|pwvucontrol}}}}
* {{App|qpwgraph|JACK ツール「QjackCtl」にインスパイアされた Qt ベースのグラフ/パッチベイ。接続セットを保存できます。|https://gitlab.freedesktop.org/rncbc/qpwgraph|{{Pkg|qpwgraph}}}}
* {{App|sonusmix|Pipewire オーディオルーティングツール。|https://codeberg.org/sonusmix/sonusmix|{{AUR|sonusmix}}}}

=== TUI ===

* {{App|pipemixer|ncurses で構築された PipeWire 用の TUI ボリュームコントロールアプリケーション。|https://github.com/heather7283/pipemixer|{{AUR|pipemixer}}}}
* {{App|wiremix|PipeWire 用のシンプルな TUI オーディオミキサー。|https://github.com/tsowell/wiremix|{{Pkg|wiremix}}}}

== 設定 ==

PipeWire パッケージは、初期設定ファイルを{{ic|/usr/share/pipewire}} に用意しています。パッケージのアップデートで変更内容が上書きされてしまうので、これらのファイルを直接編集するべきではありません。PipeWire を設定するには、ファイルを {{ic|/usr/share/pipewire}} からシステム全体の代替場所 {{ic|/etc/pipewire}} か、ユーザーの場所 {{ic|~/.config/pipewire}} にコピーしてください。[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PipeWire#configuration-file-pipewireconf]

=== プロファイル ===

Pipewire では、PulseAudio のプロファイルに加えて、pavucontrol で選択可能なカスタムの ''Pro Audio'' プロファイルが提供されています。その効果はこちらで解説しています:https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/FAQ#what-is-the-pro-audio-profile

== 使用方法 ==

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。再起動するか、ログインし直すか、{{ic|pulseaudio.service}} を[[停止]]して、{{ic|pipewire-pulse.service}} ユーザーユニットを実行すると効果がわかります。

パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire ''x.y.z'')
...
Default Sink: alsa_output.{bus}-{device}.{profile}
Default Source: alsa_input.{bus}-{device}.{profile}
...
}}

{{man|1|pactl}} は、依存関係として ''pipewire-pulse'' とともにインストールされる PulseAudio クライアントライブラリパッケージ ({{pkg|libpulse}}) によって提供されます。

===== 全体または個別のチャンネルの音量を設定する =====

出力チャンネルのボリュームを調整するには、{{ic|pactl get-sink-volume {sink}}} を使用して、''Default Sink:'' (上記) または ''Name'' の値を使用して ''sink'' を指定する必要があります。:
'' (下記)、デフォルトのシンクデバイス (''@DEFAULT_SINK@'')、または ''Sink #'' (例: 以下の ''1''):
{{hc|$ pactl list sinks {{!}} grep -B1 -A9 State:|2=
Sink #1
State: RUNNING
Name: alsa_output.pci-0000_2d_00.4.analog-surround-51
...
Driver: PipeWire
...
Mute: no
Volume: front-left: 65536 / 100% / 0.00 dB, front-right: 65536 / 100% / 0.00 dB, rear-left: 65536 / 100% / 0.00 dB, rear-right: 65536 / 100% / 0.00 dB, front-center: 65536 / 100% / 0.00 dB, lfe: 65536 / 100% / 0.00 dB
balance 0.00
}}
ヒント: オーディオが再生されている場合、他のデバイスとして ''実行中'' の {{man|1|grep}} は ''一時停止'' されます。

''バランス'' 比率は自動的に計算されます。デフォルトのデバイスの全体のボリュームを設定するには、次のコマンドを使用します: {{bc|pactl set-sink-volume @DEFAULT_SINK@ 75%}}
個別のチャンネルを設定するには、各チャンネルのボリュームを個別に指定します:
{{bc|pactl set-sink-volume @DEFAULT_SINK@ 100% 75% 100% 75% 100% 100%}}

''ソース'' 入力も同様に処理されます。さらに詳しい設定 (モジュールなど) については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Migrate-PulseAudio Migrate PulseAudio] および [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio Pipewire-Pulse Configuration] を参照してください。

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

===== プロファイルの自動選択機能 =====

{{Pkg|pipewire-media-session}} は、入力ストリームが必要なときに、HSP/HFP と A2DP プロファイルを自動的に切り替えます。これを有効にするには、{{ic|bluez5.autoswitch-profile}} プロパティを {{ic|true}} にセットしてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf (or ~/.config/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
{
...
actions = {
update-props = {
...
bluez5.autoswitch-profile = true
...
}}

これらの機能は、[[WirePlumber]] ではまだ [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/90 実装中] です。

==== PipeWire ネイティブパッチセット ====

グラフィカルな視覚化と接続の作成のための Helvum はありますが、それ以外はまだ入っていません。以下は、ワイヤセットの保存、ワイヤセットの読み込み、すべての接続の解除を行う bash スクリプトです。保存と読み込みには、コマンドラインパラメータでファイル名を指定します。

{{hc|pw-savewires|<nowiki>
#!/bin/bash

if [[ "$#" -ne 1 ]]; then
echo
echo 'usage: pw-savewires filename'
echo
exit 0
fi

rm $1 &> /dev/null
while IFS= read -r line; do
link_on=`echo $line | cut -f 4 -d '"'`
link_op=`echo $line | cut -f 6 -d '"'`
link_in=`echo $line | cut -f 8 -d '"'`
link_ip=`echo $line | cut -f 10 -d '"'`
echo "Saving: " "'"$link_on:$link_op"','"$link_in:$link_ip"'"
echo "'"$link_on:$link_op"','"$link_in:$link_ip"'" >> $1
done < <(pw-cli dump short link)
</nowiki>}}

{{hc|pw-loadwires|<nowiki>
#!/bin/python

import sys
import csv
import os

if len(sys.argv) < 2:
print('\n usage: pw-loadwires filename\n')
quit()

with open(sys.argv[1], newline='') as csvfile:
pwwreader = csv.reader(csvfile, delimiter=',', quotechar='"')
for row in pwwreader:
print('Loading: ' + row[0] + ' --> ' + row[1])
process = os.popen('pw-link ' + row[0] + ' ' + row[1])
</nowiki>}}

{{hc|pw-dewire|<nowiki>
#!/bin/bash
while read -r line; do
echo 'Dewiring: ' $line '...'
pw-link -d $line
done < <(pw-cli dump short link {{!}} grep -Eo '^[0-9]+')
</nowiki>}}

==== ネットワーク上のコンピューターとオーディオ機器を共有する ====

PipeWire 自体はネットワーク透過型ではありませんが、そのパルス実装は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio#network-support ネットワークストリーミング] をサポートしています。ネットワーク上のコンピュータ間でオーディオを共有する簡単な方法は、[[Avahi]] デーモンを使って検出することです。
オーディオを共有するすべてのコンピュータで {{ic|avahi-daemon.service}} が実行されていることを確認してください。

ローカルのオーディオデバイスを共有するために、ホスト上で適切なモジュールをロードしてください。

pactl load-module module-native-protocol-tcp listen=''192.168.1.10'' # Use the local IP address
pactl load-module module-zeroconf-publish

次に、クライアントにディスカバリモジュールをロードします。

pactl load-module module-zeroconf-discover

===== AirPlay レシーバーにオーディオをストリーミングする =====

[[Wikipedia:ja:AirPlay#Receivers|AirPlay Receiver]] を装ったデバイスにオーディオをストリーミングすることが可能です。この機能を有効にするには、[https://docs.pipewire.org/page_module_raop_discover.html RAOP Discover モジュール] をロードします。

$ pactl load-module module-raop-discover

専用の設定ファイルを作成することで、このモジュールを自動的にロードすることもできます。

{{hc|/etc/pipewire/pipewire.conf.d/raop-discover.conf (or ~/.config/pipewire/pipewire.conf.d/raop-discover.conf)|2=
context.modules = [
{
name = libpipewire-module-raop-discover
args = { }
}
]
}}

一部のスピーカーの AirPlay 実装 (Sonos AirPlay 2 スピーカーなど) では、ソースデバイスで着信 UDP トラフィック用にポート 6001 および 6002 を開く必要がある場合があります。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

==== PipeWire シンクとして ALSA dmix デバイスを使用する ====

PipeWire サーバー(またはユーザーごとに複数) を [[Advanced Linux Sound Architecture#Dmix|ALSA dmix デバイス]] を介して ALSA に出力することが可能です。これにより、ALSA を主要な音声出力システムとして使用しながら、Bluetooth ヘッドフォンなどの ALSA 以外のデバイスを使用することができるようになります。

===== ALSA dmix セットアップ =====

{{ic|PCH}} と {{ic|HDMI}} の 2 枚のカードがあるとします。

{{hc|/proc/asound/cards|
0 [PCH ]: HDA-Intel - HDA Intel PCH
HDA Intel PCH at 0xdff40000 irq 146
1 [HDMI ]: HDA-Intel - HDA ATI HDMI
HDA ATI HDMI at 0xdfe60000 irq 147
}}

PCM は次のようになります。

{{hc|/proc/asound/pcm|
00-00: ALC1220 Analog : ALC1220 Analog : playback 1 : capture 1
00-02: ALC1220 Alt Analog : ALC1220 Alt Analog : capture 1
01-03: HDMI 0 : HDMI 0 : playback 1
01-07: HDMI 1 : HDMI 1 : playback 1
01-08: HDMI 2 : HDMI 2 : playback 1
01-09: HDMI 3 : HDMI 3 : playback 1
01-10: HDMI 4 : HDMI 4 : playback 1
01-11: HDMI 5 : HDMI 5 : playback 1
}}

ALSA 設定が次のようになっているとします。

{{hc|/etc/asound.conf|
ctl.!default {
type hw
card PCH
}

pcm.!default {
type plug
slave.pcm "'''dmix:PCH,0'''"
}

pcm.dhdmi {
type plug
slave.pcm "'''dmix:HDMI,9'''"
}
}}

この特定の例では、dmix デバイスは {{ic|dmix:PCH,0}} と {{ic|dmix:HDMI,9}} になります。

===== PipeWire dmix セットアップ =====

まず、{{ic|alsa_monitor.enable()}} をコメントアウトして、{{ic|wireplumber}} によるハードウェア ALSA デバイスの監視と追加を停止します。

{{hc|/etc/wireplumber/main.lua.d/90-enable-all.lua (or ~/.config/wireplumber/main.lua.d/90-enable-all.lua)|
...
-- Load devices
'''-- alsa_monitor.enable()'''
v4l2_monitor.enable()
libcamera_monitor.enable()
...
}}

ここで、dmix デバイスを使用するように {{ic|pipewire}} を設定します。デフォルトの設定ファイル ({{ic|/usr/share/pipewire/pipewire.conf}}) には [https://gitlab.freedesktop.org/pipewire/pipewire/-/blob/0.3.59/src/daemon /pipewire.conf.in#L219-239 コメントアウトされた例] をベースとして使用できます。

独自の要素を {{ic|context.objects}} 配列に追加します。

{{hc|/etc/pipewire/pipewire.conf.d/alsa-dmix.conf (or ~/.config/pipewire/pipewire.conf.d/alsa-dmix.conf)|output=
context.objects = [
# We do not start with dmix, but with an input device.
# Do not forget to add an input device.
# On a friend's Laptop, I saw Zoom having a nervous
# breakdown and endlessly crying because no input device
# was configured! You have been warned.
{ factory = adapter
args = {
factory.name = api.alsa.pcm.source
node.name = "alsa-mic-internal" # name of pulse device (mpv)
node.description = "Mic Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Source"
api.alsa.path = "'''hw:PCH,0'''"
}
}
# Okay, now we add our dmix PCMs
{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-internal" # name of pulse device (mpv)
node.description = "PCM Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
api.alsa.path = "'''dmix:PCH,0'''"
}
}

{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-hdmi" # name of pulse device (mpv)
node.description = "PCM HDMI" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
# remember this is a non-default dmix from /etc/asound.conf
api.alsa.path = "'''dmix:HDMI,9'''"
}
}
]
}}

ユーザー (非 root) として、{{ic|wpctl status}} の出力を確認し、{{ic|wpctl set-default ''ID''}} でデフォルトの入力(ソース) と出力 (シンク) のデバイスを好みのものに設定します。{ic|''ID''}} はシンク/ソース名の前の数字です。

これで、構成を完全にテストすることができます。

==== デバイスプロファイルの切り替え ====

{{ic|snd_hda_intel}} などの一部のハードウェアオーディオデバイスは、デバイスが実行されているプロファイルによって機能が異なります。{{ic|snd_hda_intel}} の場合、HDMI とアナログ出力用に個別のプロファイルがあります。

WirePlumber で HDMI に切り替える:

{{hc|
$ wpctl set-profile <device-ID> 3
$ wpctl status
|output=
...
├─ Sinks:
│ * 53. Built-in Audio Digital Stereo (HDMI) [vol: 1.00]
...
}}

WirePlumber でアナログに切り替える:

{{hc|
$ wpctl set-profile <device-ID> 1
$ wpctl status
|output=
...
├─ Sinks:
│ * 51. Built-in Audio Analog Stereo [vol: 0.60]
...
}}

=== WebRTC 画面共有 ===

ほとんどのアプリケーションは、例えばウェブブラウザで WebRTC を使うとき (例: Google Meet) などに、デスクトップ (あるいは個々のアプリケーション) をキャプチャするために X11 に依存していました。Wayland では、セキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して、Wayland 上のコンテンツを共有できます。

{{Tip|WebRTC 画面共有が機能しているかどうか、[https://mozilla.github.io/webrtc-landing/gum_test.html Mozilla の GetUserMedia WebRTX テストページ]でテストしましょう。}}

{{Note|1={{Pkg|xdg-desktop-portal}} 1.10.0 では、D-Bus インターフェースの仕様と実装の不一致が修正されました。[https://github.com/flatpak/xdg-desktop-portal/pull/609] そのため、一部のクライアントは xdg-desktop-portal 1.10.0 またはそれ以降で動作しないかもしれません。}}

Firefox (バージョン84以降) と Chromium (バージョン110以降) はデフォルトでこの方法をサポートしていますが、Chromium の古いバージョン (バージョン73以降) では、URL {{ic|chrome://flags/#enable-webrtc-pipewire-capturer}} で対応する (実験的) フラグを設定するか、CLI 引数 {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を用いて、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWire サポート] を有効化する必要があります。

{{Pkg|obs-studio}} (バージョン27以降) は、新しい PipeWire キャプチャソースを使用することにより、この方法をサポートしています。

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインを使用して設定なしで動作するはずです ([[GStreamer#PipeWire]] を参照してください)。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

{{Pkg|pipewire-v4l2}} を使用すると、{{ic|pw-v4l2}} スクリプトを使用してライブラリをプリロードすることも可能になります ({{ic|/lib/pipewire-0.3/v4l2/libpw-v4l2.so}}) は、v4l2 呼び出しをインターセプトし、PipeWire 経由でビデオをルーティングします。

== 音声のポストプロセッシング ==

=== Pipewire モジュールフィルターチェーン ===

Pipewire には {{ic|[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Filter-Chain filter-chain]}} という内部モジュールがあり、音声の入出力を処理するノードを作成することができます。参照してください。
/usr/share/pipewire/filter-chain/ を参照してください。
イコライザー、バーチャルサラウンドサウンド、LADSPA プラグイン、チャンネルミキシングなどの例を紹介します。

==== システム全体のパラメトリックイコライゼーション ====

設定ファイルを {{ic|.config}} フォルダにコピーします。
mkdir -p ~/.config/pipewire/pipewire.conf.d
cp /usr/share/pipewire/filter-chain/sink-eq6.conf ~/.config/pipewire/pipewire.conf.d/
次に、{{ic|sink-eq6.conf}} を編集して、必要なパラメータを組み込みます。ヘッドフォンの場合、これらは [https://old.reddit.com/r/oratory1990/wiki/index Oratory1990 のデータベース] から入手できます。そこにリストされていない場合は、[https://github.com/jaakkopasanen/AutoEq/tree/master/results/ AutoEQ project]

プリアンプが必要な場合は、{{ic|eq_band_1}} を変更して、{{ic|bq_highshelf}} フィルタを周波数 0Hz でマイナスゲイン (-120 〜 +20dB のゲインをサポート) で適用します。
label = bq_highshelf
control = { "Freq" = 0 "Q" = 1.0 "Gain" = -7.5 }

6 バンドを超える場合は、{{ic|nodes}} リストと対応する {{ic|links}} にさらにエントリを追加して、1 つのフィルタ ":Out" を次のフィルタ ":In" に接続します。たとえば、11 に増やします。バンド (プリアンプ + 10):
{ output = "eq_band_6:Out" input = "eq_band_7:In" }
{ output = "eq_band_7:Out" input = "eq_band_8:In" }
{ output = "eq_band_8:Out" input = "eq_band_9:In" }
{ output = "eq_band_9:Out" input = "eq_band_10:In" }
{ output = "eq_band_10:Out" input = "eq_band_11:In" }

Pipewire を再起動し、デフォルトのサウンド出力デバイスとして "Equalizer Sink" を選択します。これは、すべてのアプリケーションに適用されます。

=== EasyEffects ===

EasyEffects (以前は PulseEffects と呼ばれていました) は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/easyeffects GitHub ページ]にエフェクトの一覧があります。

EasyEffects を使用するには、{{pkg|easyeffects}} をインストールします。プリセット設定集については、[https://github.com/wwmm/easyeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

{{Note|PulseEffects の古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

=== NoiseTorch ===

{{aur|noisetorch}} はノイズ抑制に使用できます。ビルド済み ({{aur|noisetorch-bin}}) や開発版 ({{aur|noisetorch-git}}) のパッケージもあります。

起動すると選択したマイクにモジュールを読み込むことができます。声が出力される閾値を調整することができます。実際の声が削除されない最大のレベルに設定するべきです。

=== Noise suppression for voice ===

{{pkg|noise-suppression-for-voice}} をインストールし、以下のいずれかのオプションを使用します:

* 以下の行を {{ic|context.exec}} セクションに追加する:

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.exec = [
...
{ path = "/usr/bin/pipewire" args = "-c /usr/share/pipewire/filter-chain/source-rnnoise.conf" }
...
}}

* https://github.com/werman/noise-suppression-for-voice#pipewire に従う

そして、オーディオ設定でノイズキャンセルソースをデフォルトとして設定します。この機能を使う前に、アプリケーションを再起動する必要があるかもしれません。

=== JamesDSP ===

[https://github.com/Audio4Linux/JDSP4Linux#readme JamesDSP for Linux] ({{AUR|jamesdsp}} として入手可能) は PipeWire と PulseAudio のためのオープンソースのサウンドエフェクトを提供します。LADSPA や Calf などに依存することなく、独自のエフェクトエンジンを使用しています。JamesDSP は当初 Android デバイス用のオーディオエフェクトプロセッサーとして公開されました。

=== LADSPA、LV2、VST プラグイン ===

LADSPA、LV2、VSTのプラグインを使用したい場合は、カスタム PulseAudio null シンクと Carla Jack ホストを利用できます。{{pkg|pipewire-pulse}} と {{pkg|pipewire-jack}} と {{pkg|carla}} をインストールします。はじめに {{ic|default_null_sink}} という名前の PulseAudio の null シンクを作成します。

pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=default_null_sink channel_map=FL,FR

{{ic|pw-jack carla-rack}} で PipeWire を使用する Carla を起動します。''Rack'' タブで使いたいプラグインを全て追加します。プラグインのタイプが ''stereo'' であることを確認してください。適用する順番を変えることができます。EasyEffectsのようにリストの最初のプラグインが最初に入力の音声ストリームを受け取ります。その後 ''Patchbay'' タブに移動し {{ic|default_null_sink}} の L/R monitor を Carla input に接続し、Carla output を出力したいデバイス (スピーカーやイヤホンや HDMI 出力など) の playback に接続します。設定をフォルダに保存します ({{ic|~/Documents/carla_sink_effects.carxp}} など)。

Firefox で動画を見ている時など、アプリケーションが音声を再生している時に効果を試すことができます。2つの方法があります。一つは Carla の ''Patchbay'' タブで Firefox の接続を全て外し {{ic|default_null_sink}} の L/R output に接続する方法です。もう一つは {{pkg|pavucontrol}} を使用し Firefox の音声ストリームを {{ic|default_null_sink}} に変更する方法です (この方法は同じアプリケーションの次回起動時に同じ接続先を使用するはずです)。

これらの設定を起動時に適用するには、まず2つの systemd ユーザーサービスを作成します:

{{hc|~/.config/systemd/user/jack-carla-rack.service|output=
[Unit]
Description=Load Carla Rack JACK host

[Service]
PassEnvironment="PIPEWIRE_LINK_PASSIVE=true"
Type=exec
ExecStart=/usr/bin/pw-jack carla-rack -n

[Install]
WantedBy=default.target
}}
{{hc|~/.config/systemd/user/pulseaudio-null-sink@.service|output=
[Unit]
Description=Load %i Pulseaudio null sink
Before=jack-carla-rack.service
After=pipewire-pulse.service

[Service]
Type=oneshot
ExecStart=/usr/bin/pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=%i channel_map=FL,FR
ExecStop=/usr/bin/pactl unload-module module-null-sink
RemainAfterExit=yes

[Install]
WantedBy=default.target
}}

''jack-carla-rack'' サービスの ''Environment'' を Carla の設定ファイルのフルパスを指定するよう上書きします:

{{hc|~/.config/systemd/user/jack-carla-rack.service.d/override.conf|output=
Environment="CARLA_CONFIG_FILE=/home/username/Documents/carla_sink_effects.carxp"
ExecStart=
ExecStart=/usr/bin/pw-jack carla-rack -n $CARLA_CONFIG_FILE
}}

最後に、作成したサービスを有効化します。''pulseaudio-null-sink'' サービスには {{ic|default_null_sink}} 引数をつけてください:

systemctl --user enable pulseaudio-null-sink@default_null_sink.service
systemctl --user enable jack-carla-rack.service

{{Note|システム設定で {{ic|default_null_sink}} をデフォルトデバイスに設定すると、全てのアプリケーションが {{ic|default_null_sink}} にリダイレクトされ、音量の変更がスピーカーではなく {{ic|default_null_sink}} に対して行われるようになります。スピーカーの音量を変更したい場合は、デフォルトデバイスをスピーカーから変更せずにアプリケーションの出力先を pavucontrol で {{ic|default_null_sink}} に変更してください (PipeWire の互換性レイヤーは次回起動時も出力先を覚えています)。}}

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

=== オーディオ ===

==== PipeWire にマイクが検出されない ====

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{Pkg|alsa-card-profiles}} を使ってデバイスを検出します。これがうまくいかない場合は、{{ic|api.alsa.use-acp}} をオフにするか、オプションで {{ic|api.alsa.use-ucm}} をオンにすることを試してみてください。

{{Pkg|pipewire-media-session}} を使用している場合。
{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf)|output=
...
rules = [
{
...
actions = {
update-props = {
...
api.alsa.use-acp = false
...
}}

それ以外の場合は、{{Pkg|wireplumber}} を使用している場合。
{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|output=
...
alsa_monitor.rules = {
{
...
apply_properties = {
-- Use ALSA-Card-Profile devices. They use UCM or the profile
-- configuration to configure the device and mixer settings.
-- ["api.alsa.use-acp"] = true,

-- Use UCM instead of profile when available. Can be
-- disabled to skip trying to use the UCM profile.
["api.alsa.use-ucm"] = true,
...
}}

その後、pipewire を再起動し、利用可能なデバイスを確認します。

{{hc| 1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

==== 新しいデバイスを接続したときにサウンドが自動的に切り替わらない ====

新しく接続されたデバイスに自動的に切り替えるには、次のファイルを作成します。:

{{hc|/etc/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf (or ~/.config/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf)|output=
# override for pipewire-pulse.conf file
pulse.cmd = [
{ cmd = "load-module" args = "module-always-sink" flags = [ ] }
{ cmd = "load-module" args = "module-switch-on-connect" }
]
}}

==== サウンドが自動的に Bluetooth ヘッドフォンに切り替わらない ====

{{ic|pactl load-module module-switch-on-connect}} を実行し、ログイン時に自動的にそのコマンドが実行されるようにデスクトップ環境を設定してください。詳しくは [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/89 wireplumber issue #89] を見てください。

==== Bluetooth デバイスに接続しても音が出ない ====

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

==== 音量が小さい ====

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

==== increasing RLIMIT_MEMLOCK ====

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

==== サンプリングレートを変更する ====

PipeWire のデフォルトでは、グローバルサンプルレートは 48kHz に設定されています。これを変更したい場合(より高い値をサポートする DAC を所有しているなど)、設定ファイル {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} 行を編集することで行うことができます。例えば、192kHz にしたい場合は、{{ic|48000}} を {{ic|1=default.clock.rate = 192000}} にコメントを解除して変更します。

PipeWire は、DAC がサポートする出力サンプルレートを変更することもできます。設定するには、{{ic|1=default.clock.allowed-rates = [ 48000 ]}} という行をコメント解除して設定します。例えば、{{ic|[ 44100 48000 88200 96000 ]}} とします。サンプルレートは、カードがアイドルのときに再生されるオーディオストリームのサンプルレートに従います。

どの出力サンプルレートとサンプルフォーマットが DAC に送られたデータであるかを確認するには(おそらく桁を変更する必要があります)。
cat /proc/asound/card0/pcm0p/sub0/hw_params
どの入力サンプルレートを使用しているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します。({{ic|c}} は "capture" の略、{{ic|p}} は "playback" の略です).

==== 許容されるサンプルレートの変更 ====

PipeWire は、DAC がサポートする出力サンプルレートを動的に変更することもできます。サンプルレートは、再生中のオーディオストリームのサンプルレートに従います。

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.properties = {
...
'''default.clock.allowed-rates = [ ''sample_rate_1'' ''sample_rate_2'' ''sample_rate_3'' ... ]'''
...
}}
たとえば、{{ic|[ 44100 48000 88200 96000 ]}} です。DAC でサポートされている値については、ハードウェアのマニュアルを参照してください。

開発者の [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1523] によると: "PipeWire は最大16の異なるサンプルレートを許容し、可能な限り切り替えます。" つまり、上記の設定では、'''再サンプリングは行われない'''ということです。

DAC に送信されるデータがどの出力サンプルレートとサンプルフォーマットであるかを確認するには (おそらく桁を変更する必要があります):

$ cat /proc/asound/card0/pcm0p/sub0/hw_params

どの入力サンプルレートが使用されているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します ({{ic|c}} は "capture" の略で、{{ic|p}} は "playback" の略です)

==== 音質 (リサンプリング品質) ====

PulseAudio を {{ic|1=resample-method = speex-float-10}} または {{ic|soxr-vhq}} で使用していた場合、コメントを解除して {{ic|1=resample.XXX}} を変更することを検討するとよいかもしれません。{{ic|1=resample.quality = 4}} を {{ic|10}} または最大値 {{ic|15}} に変更することを検討してください。(存在しない場合は {{ic|/usr/share/pipewire/}} からコピーしてください)。PipeWire の再起動を忘れないでください (sudo なし): {{ic|systemctl --user restart pipewire.service pipewire-pulse.socket}} (設定変更を適用させたい場合は、{{ic|pipewire-pulse.socket}}を絶対に忘れないでください)。

{{ic|10}} と {{ic|15}} では、品質の差はほとんどありませんが、CPU 負荷は 2〜3 倍になっています。また、{{ic|4}}, {{ic|10}}, {{ic|15}} のレイテンシーの差はまだ誰も調べていません。Ryzen 2600 で 44100→48000Hz で {{ic|1= resample.quality = 15}} にすると {{ic|pipewire}} や {{ic|pipewire-pulse}} プロセスが 1CPUコア4.0% の負荷となる。

リサンプラーの比較はこちら:https://src.infinitewave.ca/(18KHz以上、120dB以上は注意)。speeex は ''Xiph.org Speex'' と記載されています。

PipeWire は Spa と呼ばれる独自のリサンプリングアルゴリズムを使用しています。SoX の {{ic|sox}}、Speex の {{ic|speexenc}} と同様、PipeWire にはそのスタンドアロン版があります。{{ic|spa-resample}} 使い方は
spa-resample -q 15 -f s24 -r 48000 input16bit44100orAnythingElse.wav output24bit48000hz.wav

自分で sink を作れば、他のリサンプラーを使うことも可能でしょう。あるいは、音楽プレーヤーのプラグインを使うこともできます(例えば、Qmmp には SoX プラグインがあります)

==== 外付けサウンドカードが再接続後に有効にならない ====

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

==== 音が出ないまたは pactl info が Failure: Connection refused と表示する ====

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (OFTC の [ircs://irc.oftc.net/pipewire #pipewire]) かメーリングリストで相談してください。

==== Bluetooth の音声の品質が低い====

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...
}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...
}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

==== 再生開始時に明らかな音声の遅延やポップノイズ/音割れが発生する ====

これは、非アクティブ時のノードの一時停止が原因です。

{{pkg|pipiwire-media-session}} を使用:

これを無効にするには、遅延が発生する場所に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を 0 に変更します。無効にするか、他の値を試して、何が機能するかを確認します。

または、{{ic|/etc/pipewire/media-session.d/media-session.conf}} の行 {{ic|suspend-node}} をコメントアウトすることもできます。

[[再起動]] して {{ic|pipewire.service}} と {{ic|pipewire-pulse.service}} の両方の変更を適用して下さい。

{{pkg|wireplumber}} で、新しいファイルを作成してデフォルト設定を上書きします:

{{hc|~/.config/wireplumber/main.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/main.lua.d/51-disable-suspension.lua)|2=
table.insert (alsa_monitor.rules, {
matches = {
{
-- Matches all sources.
{ "node.name", "matches", "alsa_input.*" },
},
{
-- Matches all sinks.
{ "node.name", "matches", "alsa_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

Bluetooth デバイスの場合は、次の設定も使用します (ファイルの場所が異なることに注意してください):

{{hc|~/.config/wireplumber/bluetooth.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/bluetooth.lua.d/51-disable-suspension.lua)|2=
-- Note: bluez_monitor, not alsa_monitor
table.insert (bluez_monitor.rules, {
matches = {
{
-- Matches all sources.
-- Note: bluez_input, not alsa_input
{ "node.name", "matches", "bluez_input.*" },
},
{
-- Matches all sinks.
-- Note: bluez_output, not alsa_output
{ "node.name", "matches", "bluez_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

{{ic|pipewire.service}} と {{ic|wireplumber.service}} を再起動して、変更を適用します。

サスペンドを完全に無効にする代わりに、タイムアウト値を、ソースがサスペンドされるまでに必要な遅延秒数に変更することもできます。

==== 複数のストリームの再生が開始されると音声が途切れる ====

この問題は通常、{{ic|pipewire-pulse.service}} [[systemd/ユーザー|ユーザーユニット]] の [[journal]] を読み取り、次のような行を見つけることで診断できます。

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド] によると、{{pkg|pipewire-media-session}} のこの問題を解決するには:

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf|2=
api.alsa.headroom = 1024
}}

{{pkg|wireplumber}} を使用する場合:

{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|2=
apply_properties = {
["api.alsa.headroom"] = 1024,
},
}}

カーネルページのロックやスケジューリングの遅延が原因で音声の途切れが発生する場合は、[[ゲーム#カーネルパラメータを調整して応答時間を安定化させる|カーネルパラメータを調整して応答時間を安定化させる]] を参照してください。

==== 音がひずむ ====
* マイクについては、{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。
* {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} のコメントを外して、値を {{ic|44100}} に下げてみてください。

==== スタンバイ後に音声の問題が発生する ====

スリープから復帰した際に音が消えたり壊れたりする場合は、ALSA を最初期化すると改善するかもしれません:

# alsactl init

==== USB DAC(例:Schiit 社製 DAC)で高レイテンシー ====

サンプルレートやフォーマットを変更することで、Schiit Hel 2 などの一部の DAC でレイテンシーを減らすことができるかもしれません [https://www.reddit.com/r/osugame/comments/msifdd/usb_dacamp_and_audio_lag/] ''pipewire-media-session'' のマッチングルールを使用すると、デバイスのプロパティを設定することができます [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-pipewire-media-session#matching-rules]
''pipewire-media-session'' の {{ic|alsa-monitor.conf}} のデフォルト設定を {{ic|/etc/pipewire/media-session.d}} か {{ic|~/.config/pipewire/media-session.d}} にコピーしてください。
そして、以下のような新しいルールブロックを追加してください。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf
~/.config/pipewire/media-session.d/alsa-monitor.conf|output=
rules = {
...
{
matches = [
{
node.name = "alsa_output.<name of node>"
}
]
actions = {
update-props = {
audio.format = "S24_3LE"
audio.rate = 96000
# Following value should be doubled until audio doesn't cut out or other issues stop occurring
api.alsa.period-size = 128
}
}
}
...
}
}}

{{ic|alsa_output.<node name>}} ノードは {{ic|pw-top}} で取得することができます。

DAC は異なるフォーマットやサンプルレートをサポートしているかもしれません。[[ALSA]] に問い合わせることで、あなたの DAC が何をサポートしているかを確認することができます。

まず、DAC のカード番号を取得します。

{{hc|$ aplay -l|
...
card 3: S2 [Schiit Hel 2], device 0: USB Audio [USB Audio]
Subdevices: 0/1
Subdevice #0: subdevice #0
...
}}

つまり、この例ではカード3ということになります。
サポートされているすべてのサンプルレートとフォーマットを取得します。

{{hc|$ cat /proc/asound/cardX/streamX|
...
Playback:
...
Interface 1
Altset 1
Format: S16_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 16
...
Interface 1
Altset 2
Format: S24_3LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 24
...
Interface 1
Altset 3
Format: S32_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 32
...
...
}}

この場合、{{ic|S16_LE, S24_3LE, S32_LE}} はサポートされているフォーマットで、{{ic|44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000}} はすべてのフォーマットでサポートされているサンプルレートとなります。

==== 音量が 30% になるまで USB DAC から音が出ない ====

USB DAC の中には、ある一定の音量に達するまで音が出なくなるものがあります [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1117] 一般的にこれは約 25%〜30% で、最初の音量が不快なほど大きくなり、低い音量を維持することができなくなります。解決策としては、{{ic|["api.alsa.soft-mixer"]}} を {{ic|true}} に設定して、ハードウェアミキサーの音量コントロールを無視することが挙げられます。

{{Pkg|wireplumber}} でこれを実現するには、{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}} 設定に次を使用して構成フラグメントを追加します。 {{ic|table.insert}}:

{{hc|~/.config/wireplumber/main.lua.d/51-volume-fix.lua|output=

table.insert (alsa_monitor.rules, {
matches = {
{
-- This matches all cards.
{ "device.name", "matches", "alsa_card.*" },
},
},
-- Apply properties on the matched object.
apply_properties = {
-- Don't use the hardware mixer for volume control. It
-- will only use software volume. The mixer is still used
-- to mute unused paths based on the selected port.
["api.alsa.soft-mixer"] = true,
}
})
}}

次に、pipewire を再起動します。{{ic|alsamixer}} でマスターボリュームを設定し、{{ic|# alsactl store}} で設定を保存します。これで、ボリュームミキサーを通常どおり使用できるようになります。

==== リアルタイムオーディオが動作しない ====

{{ic|RTKit error: org.freedesktop.DBus.Error.AccessDenied}} が {{ic|systemctl --user status pipewire.service}} の出力に表示された場合、pipewire daemon の優先度がリアルタイムに変更されていないことを示します。この問題については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1069] を参照してください。

==== 同じサウンドカード上の複数のシンクへの同時出力 ====

{{ic|/usr/share/alsa-card-profile/mixer/profile-sets/default.conf}} のコピーを作成し、アップデート後も変更が持続するようにします。ここでは、アナログと HDMI の2つのデフォルトマッピングを結合したプロファイルを定義しています。

{{hc|/usr/share/alsa-card-profile/mixer/profile-sets/multiple.conf|2=
[General]
auto-profiles = no

[Mapping analog-stereo]
device-strings = front:%f
channel-map = left,right
paths-output = analog-output analog-output-lineout analog-output-speaker analog-output-headphones analog-output-headphones-2
paths-input = analog-input-front-mic analog-input-rear-mic analog-input-internal-mic analog-input-dock-mic analog-input analog-input-mic analog-input-linein analog-input-aux analog-input-video analog-input-tvtuner analog-input-fm analog-input-mic-line analog-input-headphone-mic analog-input-headset-mic
priority = 15

[Mapping hdmi-stereo]
description = Digital Stereo (HDMI)
device-strings = hdmi:%f
paths-output = hdmi-output-0
channel-map = left,right
priority = 9
direction = output

[Profile multiple]
description = Analog Stereo Duplex + Digital Stereo (HDMI) Output
output-mappings = analog-stereo hdmi-stereo
input-mappings = analog-stereo
}}

ここで、PipeWire の media-session に、新しい card-profile を使用してデバイスをマッチングするように設定します。識別情報は、{{ic|$ pw-cli dump device}} で見つけることができます。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf|2=
rules = [
{
matches = [ { alsa.card_name = "HDA Intel PCH" } ]
actions = {
update-props = {
api.alsa.use-acp = true
device.profile-set = "multiple.conf"
device.profile = "multiple"
api.acp.auto-profile = false
api.acp.auto-port = false
}
}
}
]
}}

==== Discord から通知音が鳴らない ====

min.quantum が低すぎることが原因かもしれませんので、700以上に設定してみてください。pipewire-pulse.conf の pulse.rules セクションに以下のルールを追加することで、Discord 専用にオーバーライドすることが可能です。

{{hc|/etc/pipewire/pipewire-pulse.conf (or ~/.config/pipewire/pipewire-pulse.conf)|output=
...
pulse.rules = [
...
{
# Discord notification sounds fix
matches = [ { application.process.binary = "Discord" } ]
actions = {
update-props = {
pulse.min.quantum = 1024/48000 # 21ms
}
}
}
...
}}

==== PipeWire で FMOD ゲームがクラッシュする ====

[[Wikipedia:Pillars_of_Eternity|Pillars of Eternity]] のような古いバージョンの [[Wikipedia:FMOD|FMOD オーディオエンジン]] を使っているゲームの中には、PulseAudio バイナリが存在しないと {{ic|pulseaudio --check}} を呼び出してクラッシュするものがあります。回避策としては、{{ic|/bin/pulseaudio}}を{{ic|/bin/true}}にシンボリックリンクすることです[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1514]

# ln -s /bin/true /bin/pulseaudio

PulseAudio を再インストールする場合は、シンボリックリンクを削除する必要があることに注意してください。

==== 自動切り替えが機能しない ====

自動切り替えが機能しない場合、[[WirePlumber]] の状態に問題がある可能性があります。[https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/191#note_1252549 this comment] が提案しているように、[[WirePlumber]] のローカル状態を削除し、デーモンを再起動することで改善されるかどうか確認することができます。

$ rm -r ~/.local/state/wireplumber/

次に、{{ic|wireplumber.service}} [[systemd/ユーザー|ユーザーユニット]] を [[ヘルプ:読み方# systemd ユニットのコントロール|再起動]] します。

==== リアルタイムプライオリティの欠落/サスペンド後の負荷によるクラックリング ====

rtkit の [https://github.com/heftig/rtkit/issues/13 2011年] からのバグにより、サスペンドイベントが発生すると PipeWire のリアルタイム優先度が取り消され、元に戻らなくなります。この原因となる保護を無効にするには、{{ic|rtkit-daemon.service}} を [[編集]] してください:

{{hc|/etc/systemd/system/rtkit-daemon.service.d/override.conf|2=
[Service]
ExecStart=
ExecStart=/usr/lib/rtkit-daemon --no-canary
}}

次に、メディアセッションサービスとともに、{{ic|rtkit-daemon.service}} ユニットと {{ic|pipewire.service}} ユーザーユニットを再起動します。

==== RAOP デバイス (Sonos など) へのストリーミング中に音が出ない ====

[[Avahi]] または [[systemd-resolved]] を使用して mDNS ホスト名解決を設定します。

==== KDE Plasma でサウンドデバイスが表示されない ====

PipeWire クライアント (デスクトップ環境を含む) は、[https://specations.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables XDG_RUNTIME_DIR] [[環境変数]] に依存して PipeWire デーモンに接続する場合があります。[https://docs.pipewire.org/page_daemon.html] ログイン直後にサウンドデバイスが表示されない場合は、この変数が手動で間違ったパスに設定されている可能性があります。

これは PipeWire を手動で再起動することで解決できますが、Chromium で画面共有できない ({{ic|pipewire context failed}} により) など、他の問題が依然として発生する可能性があります。{{ic|XDG_RUNTIME_DIR}} は {{man|8|pam_systemd}} によって自動的に設定されるため、初期化ファイルに設定されているインスタンスをすべて削除する必要があります。

==== SDDM ユーザーのデバイス音量がログイン時に復元されない ====

SDDM を使用していて、ログイン後にオーディオの音量レベルが正しく復元されない場合は、SDDM に対して Pipewire をマスクしてください。SDDM で実行される Wireplumber が、ユーザーの Wireplumber セッションに干渉する可能性があります。

systemctl --user -M sddm@ mask pipewire.socket

詳細については、[https://wiki.debian.org/PipeWire#Device_volume_for_SDDM_users_is_not_restored_on_login Debian Wiki] の記事を参照してください。

==== ターミナルベルが動作しない ====

PipeWire の観点からは、module x11.bell がロードされている必要があります。これはデフォルトの設定です(上記の設定ファイルも参照){{Pkg|pipewire-x11-bell}} パッケージがインストールされているか確認してください。

また、ウィンドウマネージャーがターミナルベルに影響を与えることがあります。例えば、xfwm を使用している場合は、xfwm-terminal の設定で "聴ベル(Audible bell)" が有効になっているか確認してください。

次に、PipeWire サービスを再起動します:

systemctl --user restart pipewire

ターミナルベルが動作するか試すには、以下のコマンドを実行します:

echo $'\a'

==== 最初の再生試行まで音が出ない ====

PipeWire がソケットアクティベーションによって起動される設定になっている場合、一部の PipeWire ネイティブアプリケーションにおいて、[[WirePlumber]] がノードを構成する前にオーディオの再生を試みてしまい、結果としてエラーが発生することがあります。

例:

{{hc|$ mpv -v ''/path/to/file''|
[ao/pipewire] PipeWire does not have any audio sinks, skipping
[ao] Failed to initialize audio driver 'pipewire'
}}

{{hc|$ journalctl --user -u mpd.service|
output: Failed to play on "PipeWire" (pipewire): no target node available
exception: Failed to open audio output
}}

回避策として、{{ic|pipewire.service}} の[[ユーザーユニット]]を[[有効化]]してください。

=== ビデオ ===

==== OBS(など)がウィンドウ/スクリーンを要求しても何も表示されない ====

{{Pkg|xdg-desktop-portal}} と {{Pkg|xdg-desktop-portal-gtk}} または {{Pkg|xdg-desktop-portal-kde}} がインストールされていることが確実なら、デーモンの実行状態を確認してください。

OBS では、すべてがうまくいっていれば、{{ic|stdout}} にこのように表示されるはずです。

...
info: [pipewire] desktop selected, setting up screencast
info: [pipewire] created stream 0x5632d7456850
info: [pipewire] playing stream...

マルチモニタ環境では、{{Pkg|slurp}} パッケージを使用すると、すべての画面をキャプチャすることができます。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

PipeWire

2026-02-20T08:51:52Z

Kgx: /* オーディオ */ 最初の再生試行まで音が出ないを翻訳して追加

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[[pt:PipeWire]]
[[ru:PipeWire]]
[[zh-hans:PipeWire]]
{{Related articles start}}
{{Related|PipeWire/サンプル}}
{{Related|WirePlumber}}
{{Related articles end}}
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、[[PulseAudio]]、[[JACK]]、[[ALSA]]、[[GStreamer]] をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリから {{Pkg|pipewire}} パッケージを [[インストール]] してください。[[multilib]] に対応した {{Pkg|lib32-pipewire}} もあります。

Pipewire は [[systemd/ユーザー]] を使ってサーバーを管理し、ソケットを自動で起動します。

オプションとして、{{Pkg|pipewire-docs}} をインストールすると、ドキュメントを確認することができます。

Pipewire は、他のオーディオサーバーと置き換えることができます。詳しくは [[PipeWire#オーディオ|オーディオ]] を参照してください。

=== セッションマネージャー ===

[[JACK]] と同様、PipeWire は内部で接続ロジックを実装していません。新しいストリームを監視し、適切な出力デバイスやアプリケーションに接続する負担は、セッションマネージャーとして知られる外部のコンポーネントに任されています。

現在、推奨のセッションマネージャーは1つだけで次になります:
* {{App|[[WirePlumber]]| 強力なマネージャであり、現在の推奨品です。モジュール設計に基づいており、実際の管理機能を実装する Lua プラグインがあります。|https://pipewire.pages.freedesktop.org/wireplumber/|{{Pkg|wireplumber}}}}

次のセッションマネージャーはサポート外になっており WirePlumber を推奨しています:

* {{App|PipeWire Media Session|いくつかの基本的なデスクトップのユースケースに対応した非常にシンプルなセッションマネージャです。これは主にテスト用と新しいセッションマネージャを構築するための例として実装されました。|https://gitlab.freedesktop.org/pipewire/media-session|{{Pkg|pipewire-media-session}}}}

PipeWire のインストール時に、どちらかを選ぶように指示されます。後で適切なパッケージをインストールすることで、もう一方のオプションと衝突しますが、置き換えることで切り替えが可能です。

=== GUI ===

* {{App|Helvum|PipeWire 用の GTK 製のパッチベイ。 JACK のツールの catia にインスパイアされた。|https://gitlab.freedesktop.org/ryuukyu/helvum|{{pkg|helvum}}}}
* {{App|qpwgraph|Qt-based Graph/Patchbay for PipeWire, inspired by the JACK tool QjackCtl.|https://gitlab.freedesktop.org/rncbc/qpwgraph|{{Pkg|qpwgraph}}}}

== 設定 ==

PipeWire パッケージは、初期設定ファイルを{{ic|/usr/share/pipewire}} に用意しています。パッケージのアップデートで変更内容が上書きされてしまうので、これらのファイルを直接編集するべきではありません。PipeWire を設定するには、ファイルを {{ic|/usr/share/pipewire}} からシステム全体の代替場所 {{ic|/etc/pipewire}} か、ユーザーの場所 {{ic|~/.config/pipewire}} にコピーしてください。[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PipeWire#configuration-file-pipewireconf]

=== プロファイル ===

Pipewire では、PulseAudio のプロファイルに加えて、pavucontrol で選択可能なカスタムの ''Pro Audio'' プロファイルが提供されています。その効果はこちらで解説しています:https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/FAQ#what-is-the-pro-audio-profile

== 使用方法 ==

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。再起動するか、ログインし直すか、{{ic|pulseaudio.service}} を[[停止]]して、{{ic|pipewire-pulse.service}} ユーザーユニットを実行すると効果がわかります。

パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire ''x.y.z'')
...
Default Sink: alsa_output.{bus}-{device}.{profile}
Default Source: alsa_input.{bus}-{device}.{profile}
...
}}

{{man|1|pactl}} は、依存関係として ''pipewire-pulse'' とともにインストールされる PulseAudio クライアントライブラリパッケージ ({{pkg|libpulse}}) によって提供されます。

===== 全体または個別のチャンネルの音量を設定する =====

出力チャンネルのボリュームを調整するには、{{ic|pactl get-sink-volume {sink}}} を使用して、''Default Sink:'' (上記) または ''Name'' の値を使用して ''sink'' を指定する必要があります。:
'' (下記)、デフォルトのシンクデバイス (''@DEFAULT_SINK@'')、または ''Sink #'' (例: 以下の ''1''):
{{hc|$ pactl list sinks {{!}} grep -B1 -A9 State:|2=
Sink #1
State: RUNNING
Name: alsa_output.pci-0000_2d_00.4.analog-surround-51
...
Driver: PipeWire
...
Mute: no
Volume: front-left: 65536 / 100% / 0.00 dB, front-right: 65536 / 100% / 0.00 dB, rear-left: 65536 / 100% / 0.00 dB, rear-right: 65536 / 100% / 0.00 dB, front-center: 65536 / 100% / 0.00 dB, lfe: 65536 / 100% / 0.00 dB
balance 0.00
}}
ヒント: オーディオが再生されている場合、他のデバイスとして ''実行中'' の {{man|1|grep}} は ''一時停止'' されます。

''バランス'' 比率は自動的に計算されます。デフォルトのデバイスの全体のボリュームを設定するには、次のコマンドを使用します: {{bc|pactl set-sink-volume @DEFAULT_SINK@ 75%}}
個別のチャンネルを設定するには、各チャンネルのボリュームを個別に指定します:
{{bc|pactl set-sink-volume @DEFAULT_SINK@ 100% 75% 100% 75% 100% 100%}}

''ソース'' 入力も同様に処理されます。さらに詳しい設定 (モジュールなど) については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Migrate-PulseAudio Migrate PulseAudio] および [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio Pipewire-Pulse Configuration] を参照してください。

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

===== プロファイルの自動選択機能 =====

{{Pkg|pipewire-media-session}} は、入力ストリームが必要なときに、HSP/HFP と A2DP プロファイルを自動的に切り替えます。これを有効にするには、{{ic|bluez5.autoswitch-profile}} プロパティを {{ic|true}} にセットしてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf (or ~/.config/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
{
...
actions = {
update-props = {
...
bluez5.autoswitch-profile = true
...
}}

これらの機能は、[[WirePlumber]] ではまだ [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/90 実装中] です。

==== PipeWire ネイティブパッチセット ====

グラフィカルな視覚化と接続の作成のための Helvum はありますが、それ以外はまだ入っていません。以下は、ワイヤセットの保存、ワイヤセットの読み込み、すべての接続の解除を行う bash スクリプトです。保存と読み込みには、コマンドラインパラメータでファイル名を指定します。

{{hc|pw-savewires|<nowiki>
#!/bin/bash

if [[ "$#" -ne 1 ]]; then
echo
echo 'usage: pw-savewires filename'
echo
exit 0
fi

rm $1 &> /dev/null
while IFS= read -r line; do
link_on=`echo $line | cut -f 4 -d '"'`
link_op=`echo $line | cut -f 6 -d '"'`
link_in=`echo $line | cut -f 8 -d '"'`
link_ip=`echo $line | cut -f 10 -d '"'`
echo "Saving: " "'"$link_on:$link_op"','"$link_in:$link_ip"'"
echo "'"$link_on:$link_op"','"$link_in:$link_ip"'" >> $1
done < <(pw-cli dump short link)
</nowiki>}}

{{hc|pw-loadwires|<nowiki>
#!/bin/python

import sys
import csv
import os

if len(sys.argv) < 2:
print('\n usage: pw-loadwires filename\n')
quit()

with open(sys.argv[1], newline='') as csvfile:
pwwreader = csv.reader(csvfile, delimiter=',', quotechar='"')
for row in pwwreader:
print('Loading: ' + row[0] + ' --> ' + row[1])
process = os.popen('pw-link ' + row[0] + ' ' + row[1])
</nowiki>}}

{{hc|pw-dewire|<nowiki>
#!/bin/bash
while read -r line; do
echo 'Dewiring: ' $line '...'
pw-link -d $line
done < <(pw-cli dump short link {{!}} grep -Eo '^[0-9]+')
</nowiki>}}

==== ネットワーク上のコンピューターとオーディオ機器を共有する ====

PipeWire 自体はネットワーク透過型ではありませんが、そのパルス実装は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio#network-support ネットワークストリーミング] をサポートしています。ネットワーク上のコンピュータ間でオーディオを共有する簡単な方法は、[[Avahi]] デーモンを使って検出することです。
オーディオを共有するすべてのコンピュータで {{ic|avahi-daemon.service}} が実行されていることを確認してください。

ローカルのオーディオデバイスを共有するために、ホスト上で適切なモジュールをロードしてください。

pactl load-module module-native-protocol-tcp listen=''192.168.1.10'' # Use the local IP address
pactl load-module module-zeroconf-publish

次に、クライアントにディスカバリモジュールをロードします。

pactl load-module module-zeroconf-discover

===== AirPlay レシーバーにオーディオをストリーミングする =====

[[Wikipedia:ja:AirPlay#Receivers|AirPlay Receiver]] を装ったデバイスにオーディオをストリーミングすることが可能です。この機能を有効にするには、[https://docs.pipewire.org/page_module_raop_discover.html RAOP Discover モジュール] をロードします。

$ pactl load-module module-raop-discover

専用の設定ファイルを作成することで、このモジュールを自動的にロードすることもできます。

{{hc|/etc/pipewire/pipewire.conf.d/raop-discover.conf (or ~/.config/pipewire/pipewire.conf.d/raop-discover.conf)|2=
context.modules = [
{
name = libpipewire-module-raop-discover
args = { }
}
]
}}

一部のスピーカーの AirPlay 実装 (Sonos AirPlay 2 スピーカーなど) では、ソースデバイスで着信 UDP トラフィック用にポート 6001 および 6002 を開く必要がある場合があります。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

==== PipeWire シンクとして ALSA dmix デバイスを使用する ====

PipeWire サーバー(またはユーザーごとに複数) を [[Advanced Linux Sound Architecture#Dmix|ALSA dmix デバイス]] を介して ALSA に出力することが可能です。これにより、ALSA を主要な音声出力システムとして使用しながら、Bluetooth ヘッドフォンなどの ALSA 以外のデバイスを使用することができるようになります。

===== ALSA dmix セットアップ =====

{{ic|PCH}} と {{ic|HDMI}} の 2 枚のカードがあるとします。

{{hc|/proc/asound/cards|
0 [PCH ]: HDA-Intel - HDA Intel PCH
HDA Intel PCH at 0xdff40000 irq 146
1 [HDMI ]: HDA-Intel - HDA ATI HDMI
HDA ATI HDMI at 0xdfe60000 irq 147
}}

PCM は次のようになります。

{{hc|/proc/asound/pcm|
00-00: ALC1220 Analog : ALC1220 Analog : playback 1 : capture 1
00-02: ALC1220 Alt Analog : ALC1220 Alt Analog : capture 1
01-03: HDMI 0 : HDMI 0 : playback 1
01-07: HDMI 1 : HDMI 1 : playback 1
01-08: HDMI 2 : HDMI 2 : playback 1
01-09: HDMI 3 : HDMI 3 : playback 1
01-10: HDMI 4 : HDMI 4 : playback 1
01-11: HDMI 5 : HDMI 5 : playback 1
}}

ALSA 設定が次のようになっているとします。

{{hc|/etc/asound.conf|
ctl.!default {
type hw
card PCH
}

pcm.!default {
type plug
slave.pcm "'''dmix:PCH,0'''"
}

pcm.dhdmi {
type plug
slave.pcm "'''dmix:HDMI,9'''"
}
}}

この特定の例では、dmix デバイスは {{ic|dmix:PCH,0}} と {{ic|dmix:HDMI,9}} になります。

===== PipeWire dmix セットアップ =====

まず、{{ic|alsa_monitor.enable()}} をコメントアウトして、{{ic|wireplumber}} によるハードウェア ALSA デバイスの監視と追加を停止します。

{{hc|/etc/wireplumber/main.lua.d/90-enable-all.lua (or ~/.config/wireplumber/main.lua.d/90-enable-all.lua)|
...
-- Load devices
'''-- alsa_monitor.enable()'''
v4l2_monitor.enable()
libcamera_monitor.enable()
...
}}

ここで、dmix デバイスを使用するように {{ic|pipewire}} を設定します。デフォルトの設定ファイル ({{ic|/usr/share/pipewire/pipewire.conf}}) には [https://gitlab.freedesktop.org/pipewire/pipewire/-/blob/0.3.59/src/daemon /pipewire.conf.in#L219-239 コメントアウトされた例] をベースとして使用できます。

独自の要素を {{ic|context.objects}} 配列に追加します。

{{hc|/etc/pipewire/pipewire.conf.d/alsa-dmix.conf (or ~/.config/pipewire/pipewire.conf.d/alsa-dmix.conf)|output=
context.objects = [
# We do not start with dmix, but with an input device.
# Do not forget to add an input device.
# On a friend's Laptop, I saw Zoom having a nervous
# breakdown and endlessly crying because no input device
# was configured! You have been warned.
{ factory = adapter
args = {
factory.name = api.alsa.pcm.source
node.name = "alsa-mic-internal" # name of pulse device (mpv)
node.description = "Mic Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Source"
api.alsa.path = "'''hw:PCH,0'''"
}
}
# Okay, now we add our dmix PCMs
{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-internal" # name of pulse device (mpv)
node.description = "PCM Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
api.alsa.path = "'''dmix:PCH,0'''"
}
}

{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-hdmi" # name of pulse device (mpv)
node.description = "PCM HDMI" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
# remember this is a non-default dmix from /etc/asound.conf
api.alsa.path = "'''dmix:HDMI,9'''"
}
}
]
}}

ユーザー (非 root) として、{{ic|wpctl status}} の出力を確認し、{{ic|wpctl set-default ''ID''}} でデフォルトの入力(ソース) と出力 (シンク) のデバイスを好みのものに設定します。{ic|''ID''}} はシンク/ソース名の前の数字です。

これで、構成を完全にテストすることができます。

==== デバイスプロファイルの切り替え ====

{{ic|snd_hda_intel}} などの一部のハードウェアオーディオデバイスは、デバイスが実行されているプロファイルによって機能が異なります。{{ic|snd_hda_intel}} の場合、HDMI とアナログ出力用に個別のプロファイルがあります。

WirePlumber で HDMI に切り替える:

{{hc|
$ wpctl set-profile <device-ID> 3
$ wpctl status
|output=
...
├─ Sinks:
│ * 53. Built-in Audio Digital Stereo (HDMI) [vol: 1.00]
...
}}

WirePlumber でアナログに切り替える:

{{hc|
$ wpctl set-profile <device-ID> 1
$ wpctl status
|output=
...
├─ Sinks:
│ * 51. Built-in Audio Analog Stereo [vol: 0.60]
...
}}

=== WebRTC 画面共有 ===

ほとんどのアプリケーションは、例えばウェブブラウザで WebRTC を使うとき (例: Google Meet) などに、デスクトップ (あるいは個々のアプリケーション) をキャプチャするために X11 に依存していました。Wayland では、セキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して、Wayland 上のコンテンツを共有できます。

{{Tip|WebRTC 画面共有が機能しているかどうか、[https://mozilla.github.io/webrtc-landing/gum_test.html Mozilla の GetUserMedia WebRTX テストページ]でテストしましょう。}}

{{Note|1={{Pkg|xdg-desktop-portal}} 1.10.0 では、D-Bus インターフェースの仕様と実装の不一致が修正されました。[https://github.com/flatpak/xdg-desktop-portal/pull/609] そのため、一部のクライアントは xdg-desktop-portal 1.10.0 またはそれ以降で動作しないかもしれません。}}

Firefox (バージョン84以降) と Chromium (バージョン110以降) はデフォルトでこの方法をサポートしていますが、Chromium の古いバージョン (バージョン73以降) では、URL {{ic|chrome://flags/#enable-webrtc-pipewire-capturer}} で対応する (実験的) フラグを設定するか、CLI 引数 {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を用いて、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWire サポート] を有効化する必要があります。

{{Pkg|obs-studio}} (バージョン27以降) は、新しい PipeWire キャプチャソースを使用することにより、この方法をサポートしています。

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインを使用して設定なしで動作するはずです ([[GStreamer#PipeWire]] を参照してください)。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

{{Pkg|pipewire-v4l2}} を使用すると、{{ic|pw-v4l2}} スクリプトを使用してライブラリをプリロードすることも可能になります ({{ic|/lib/pipewire-0.3/v4l2/libpw-v4l2.so}}) は、v4l2 呼び出しをインターセプトし、PipeWire 経由でビデオをルーティングします。

== 音声のポストプロセッシング ==

=== Pipewire モジュールフィルターチェーン ===

Pipewire には {{ic|[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Filter-Chain filter-chain]}} という内部モジュールがあり、音声の入出力を処理するノードを作成することができます。参照してください。
/usr/share/pipewire/filter-chain/ を参照してください。
イコライザー、バーチャルサラウンドサウンド、LADSPA プラグイン、チャンネルミキシングなどの例を紹介します。

==== システム全体のパラメトリックイコライゼーション ====

設定ファイルを {{ic|.config}} フォルダにコピーします。
mkdir -p ~/.config/pipewire/pipewire.conf.d
cp /usr/share/pipewire/filter-chain/sink-eq6.conf ~/.config/pipewire/pipewire.conf.d/
次に、{{ic|sink-eq6.conf}} を編集して、必要なパラメータを組み込みます。ヘッドフォンの場合、これらは [https://old.reddit.com/r/oratory1990/wiki/index Oratory1990 のデータベース] から入手できます。そこにリストされていない場合は、[https://github.com/jaakkopasanen/AutoEq/tree/master/results/ AutoEQ project]

プリアンプが必要な場合は、{{ic|eq_band_1}} を変更して、{{ic|bq_highshelf}} フィルタを周波数 0Hz でマイナスゲイン (-120 〜 +20dB のゲインをサポート) で適用します。
label = bq_highshelf
control = { "Freq" = 0 "Q" = 1.0 "Gain" = -7.5 }

6 バンドを超える場合は、{{ic|nodes}} リストと対応する {{ic|links}} にさらにエントリを追加して、1 つのフィルタ ":Out" を次のフィルタ ":In" に接続します。たとえば、11 に増やします。バンド (プリアンプ + 10):
{ output = "eq_band_6:Out" input = "eq_band_7:In" }
{ output = "eq_band_7:Out" input = "eq_band_8:In" }
{ output = "eq_band_8:Out" input = "eq_band_9:In" }
{ output = "eq_band_9:Out" input = "eq_band_10:In" }
{ output = "eq_band_10:Out" input = "eq_band_11:In" }

Pipewire を再起動し、デフォルトのサウンド出力デバイスとして "Equalizer Sink" を選択します。これは、すべてのアプリケーションに適用されます。

=== EasyEffects ===

EasyEffects (以前は PulseEffects と呼ばれていました) は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/easyeffects GitHub ページ]にエフェクトの一覧があります。

EasyEffects を使用するには、{{pkg|easyeffects}} をインストールします。プリセット設定集については、[https://github.com/wwmm/easyeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

{{Note|PulseEffects の古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

=== NoiseTorch ===

{{aur|noisetorch}} はノイズ抑制に使用できます。ビルド済み ({{aur|noisetorch-bin}}) や開発版 ({{aur|noisetorch-git}}) のパッケージもあります。

起動すると選択したマイクにモジュールを読み込むことができます。声が出力される閾値を調整することができます。実際の声が削除されない最大のレベルに設定するべきです。

=== Noise suppression for voice ===

{{pkg|noise-suppression-for-voice}} をインストールし、以下のいずれかのオプションを使用します:

* 以下の行を {{ic|context.exec}} セクションに追加する:

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.exec = [
...
{ path = "/usr/bin/pipewire" args = "-c /usr/share/pipewire/filter-chain/source-rnnoise.conf" }
...
}}

* https://github.com/werman/noise-suppression-for-voice#pipewire に従う

そして、オーディオ設定でノイズキャンセルソースをデフォルトとして設定します。この機能を使う前に、アプリケーションを再起動する必要があるかもしれません。

=== JamesDSP ===

[https://github.com/Audio4Linux/JDSP4Linux#readme JamesDSP for Linux] ({{AUR|jamesdsp}} として入手可能) は PipeWire と PulseAudio のためのオープンソースのサウンドエフェクトを提供します。LADSPA や Calf などに依存することなく、独自のエフェクトエンジンを使用しています。JamesDSP は当初 Android デバイス用のオーディオエフェクトプロセッサーとして公開されました。

=== LADSPA、LV2、VST プラグイン ===

LADSPA、LV2、VSTのプラグインを使用したい場合は、カスタム PulseAudio null シンクと Carla Jack ホストを利用できます。{{pkg|pipewire-pulse}} と {{pkg|pipewire-jack}} と {{pkg|carla}} をインストールします。はじめに {{ic|default_null_sink}} という名前の PulseAudio の null シンクを作成します。

pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=default_null_sink channel_map=FL,FR

{{ic|pw-jack carla-rack}} で PipeWire を使用する Carla を起動します。''Rack'' タブで使いたいプラグインを全て追加します。プラグインのタイプが ''stereo'' であることを確認してください。適用する順番を変えることができます。EasyEffectsのようにリストの最初のプラグインが最初に入力の音声ストリームを受け取ります。その後 ''Patchbay'' タブに移動し {{ic|default_null_sink}} の L/R monitor を Carla input に接続し、Carla output を出力したいデバイス (スピーカーやイヤホンや HDMI 出力など) の playback に接続します。設定をフォルダに保存します ({{ic|~/Documents/carla_sink_effects.carxp}} など)。

Firefox で動画を見ている時など、アプリケーションが音声を再生している時に効果を試すことができます。2つの方法があります。一つは Carla の ''Patchbay'' タブで Firefox の接続を全て外し {{ic|default_null_sink}} の L/R output に接続する方法です。もう一つは {{pkg|pavucontrol}} を使用し Firefox の音声ストリームを {{ic|default_null_sink}} に変更する方法です (この方法は同じアプリケーションの次回起動時に同じ接続先を使用するはずです)。

これらの設定を起動時に適用するには、まず2つの systemd ユーザーサービスを作成します:

{{hc|~/.config/systemd/user/jack-carla-rack.service|output=
[Unit]
Description=Load Carla Rack JACK host

[Service]
PassEnvironment="PIPEWIRE_LINK_PASSIVE=true"
Type=exec
ExecStart=/usr/bin/pw-jack carla-rack -n

[Install]
WantedBy=default.target
}}
{{hc|~/.config/systemd/user/pulseaudio-null-sink@.service|output=
[Unit]
Description=Load %i Pulseaudio null sink
Before=jack-carla-rack.service
After=pipewire-pulse.service

[Service]
Type=oneshot
ExecStart=/usr/bin/pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=%i channel_map=FL,FR
ExecStop=/usr/bin/pactl unload-module module-null-sink
RemainAfterExit=yes

[Install]
WantedBy=default.target
}}

''jack-carla-rack'' サービスの ''Environment'' を Carla の設定ファイルのフルパスを指定するよう上書きします:

{{hc|~/.config/systemd/user/jack-carla-rack.service.d/override.conf|output=
Environment="CARLA_CONFIG_FILE=/home/username/Documents/carla_sink_effects.carxp"
ExecStart=
ExecStart=/usr/bin/pw-jack carla-rack -n $CARLA_CONFIG_FILE
}}

最後に、作成したサービスを有効化します。''pulseaudio-null-sink'' サービスには {{ic|default_null_sink}} 引数をつけてください:

systemctl --user enable pulseaudio-null-sink@default_null_sink.service
systemctl --user enable jack-carla-rack.service

{{Note|システム設定で {{ic|default_null_sink}} をデフォルトデバイスに設定すると、全てのアプリケーションが {{ic|default_null_sink}} にリダイレクトされ、音量の変更がスピーカーではなく {{ic|default_null_sink}} に対して行われるようになります。スピーカーの音量を変更したい場合は、デフォルトデバイスをスピーカーから変更せずにアプリケーションの出力先を pavucontrol で {{ic|default_null_sink}} に変更してください (PipeWire の互換性レイヤーは次回起動時も出力先を覚えています)。}}

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

=== オーディオ ===

==== PipeWire にマイクが検出されない ====

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{Pkg|alsa-card-profiles}} を使ってデバイスを検出します。これがうまくいかない場合は、{{ic|api.alsa.use-acp}} をオフにするか、オプションで {{ic|api.alsa.use-ucm}} をオンにすることを試してみてください。

{{Pkg|pipewire-media-session}} を使用している場合。
{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf)|output=
...
rules = [
{
...
actions = {
update-props = {
...
api.alsa.use-acp = false
...
}}

それ以外の場合は、{{Pkg|wireplumber}} を使用している場合。
{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|output=
...
alsa_monitor.rules = {
{
...
apply_properties = {
-- Use ALSA-Card-Profile devices. They use UCM or the profile
-- configuration to configure the device and mixer settings.
-- ["api.alsa.use-acp"] = true,

-- Use UCM instead of profile when available. Can be
-- disabled to skip trying to use the UCM profile.
["api.alsa.use-ucm"] = true,
...
}}

その後、pipewire を再起動し、利用可能なデバイスを確認します。

{{hc| 1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

==== 新しいデバイスを接続したときにサウンドが自動的に切り替わらない ====

新しく接続されたデバイスに自動的に切り替えるには、次のファイルを作成します。:

{{hc|/etc/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf (or ~/.config/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf)|output=
# override for pipewire-pulse.conf file
pulse.cmd = [
{ cmd = "load-module" args = "module-always-sink" flags = [ ] }
{ cmd = "load-module" args = "module-switch-on-connect" }
]
}}

==== サウンドが自動的に Bluetooth ヘッドフォンに切り替わらない ====

{{ic|pactl load-module module-switch-on-connect}} を実行し、ログイン時に自動的にそのコマンドが実行されるようにデスクトップ環境を設定してください。詳しくは [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/89 wireplumber issue #89] を見てください。

==== Bluetooth デバイスに接続しても音が出ない ====

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

==== 音量が小さい ====

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

==== increasing RLIMIT_MEMLOCK ====

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

==== サンプリングレートを変更する ====

PipeWire のデフォルトでは、グローバルサンプルレートは 48kHz に設定されています。これを変更したい場合(より高い値をサポートする DAC を所有しているなど)、設定ファイル {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} 行を編集することで行うことができます。例えば、192kHz にしたい場合は、{{ic|48000}} を {{ic|1=default.clock.rate = 192000}} にコメントを解除して変更します。

PipeWire は、DAC がサポートする出力サンプルレートを変更することもできます。設定するには、{{ic|1=default.clock.allowed-rates = [ 48000 ]}} という行をコメント解除して設定します。例えば、{{ic|[ 44100 48000 88200 96000 ]}} とします。サンプルレートは、カードがアイドルのときに再生されるオーディオストリームのサンプルレートに従います。

どの出力サンプルレートとサンプルフォーマットが DAC に送られたデータであるかを確認するには(おそらく桁を変更する必要があります)。
cat /proc/asound/card0/pcm0p/sub0/hw_params
どの入力サンプルレートを使用しているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します。({{ic|c}} は "capture" の略、{{ic|p}} は "playback" の略です).

==== 許容されるサンプルレートの変更 ====

PipeWire は、DAC がサポートする出力サンプルレートを動的に変更することもできます。サンプルレートは、再生中のオーディオストリームのサンプルレートに従います。

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.properties = {
...
'''default.clock.allowed-rates = [ ''sample_rate_1'' ''sample_rate_2'' ''sample_rate_3'' ... ]'''
...
}}
たとえば、{{ic|[ 44100 48000 88200 96000 ]}} です。DAC でサポートされている値については、ハードウェアのマニュアルを参照してください。

開発者の [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1523] によると: "PipeWire は最大16の異なるサンプルレートを許容し、可能な限り切り替えます。" つまり、上記の設定では、'''再サンプリングは行われない'''ということです。

DAC に送信されるデータがどの出力サンプルレートとサンプルフォーマットであるかを確認するには (おそらく桁を変更する必要があります):

$ cat /proc/asound/card0/pcm0p/sub0/hw_params

どの入力サンプルレートが使用されているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します ({{ic|c}} は "capture" の略で、{{ic|p}} は "playback" の略です)

==== 音質 (リサンプリング品質) ====

PulseAudio を {{ic|1=resample-method = speex-float-10}} または {{ic|soxr-vhq}} で使用していた場合、コメントを解除して {{ic|1=resample.XXX}} を変更することを検討するとよいかもしれません。{{ic|1=resample.quality = 4}} を {{ic|10}} または最大値 {{ic|15}} に変更することを検討してください。(存在しない場合は {{ic|/usr/share/pipewire/}} からコピーしてください)。PipeWire の再起動を忘れないでください (sudo なし): {{ic|systemctl --user restart pipewire.service pipewire-pulse.socket}} (設定変更を適用させたい場合は、{{ic|pipewire-pulse.socket}}を絶対に忘れないでください)。

{{ic|10}} と {{ic|15}} では、品質の差はほとんどありませんが、CPU 負荷は 2〜3 倍になっています。また、{{ic|4}}, {{ic|10}}, {{ic|15}} のレイテンシーの差はまだ誰も調べていません。Ryzen 2600 で 44100→48000Hz で {{ic|1= resample.quality = 15}} にすると {{ic|pipewire}} や {{ic|pipewire-pulse}} プロセスが 1CPUコア4.0% の負荷となる。

リサンプラーの比較はこちら:https://src.infinitewave.ca/(18KHz以上、120dB以上は注意)。speeex は ''Xiph.org Speex'' と記載されています。

PipeWire は Spa と呼ばれる独自のリサンプリングアルゴリズムを使用しています。SoX の {{ic|sox}}、Speex の {{ic|speexenc}} と同様、PipeWire にはそのスタンドアロン版があります。{{ic|spa-resample}} 使い方は
spa-resample -q 15 -f s24 -r 48000 input16bit44100orAnythingElse.wav output24bit48000hz.wav

自分で sink を作れば、他のリサンプラーを使うことも可能でしょう。あるいは、音楽プレーヤーのプラグインを使うこともできます(例えば、Qmmp には SoX プラグインがあります)

==== 外付けサウンドカードが再接続後に有効にならない ====

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

==== 音が出ないまたは pactl info が Failure: Connection refused と表示する ====

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (OFTC の [ircs://irc.oftc.net/pipewire #pipewire]) かメーリングリストで相談してください。

==== Bluetooth の音声の品質が低い====

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...
}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...
}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

==== 再生開始時に明らかな音声の遅延やポップノイズ/音割れが発生する ====

これは、非アクティブ時のノードの一時停止が原因です。

{{pkg|pipiwire-media-session}} を使用:

これを無効にするには、遅延が発生する場所に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を 0 に変更します。無効にするか、他の値を試して、何が機能するかを確認します。

または、{{ic|/etc/pipewire/media-session.d/media-session.conf}} の行 {{ic|suspend-node}} をコメントアウトすることもできます。

[[再起動]] して {{ic|pipewire.service}} と {{ic|pipewire-pulse.service}} の両方の変更を適用して下さい。

{{pkg|wireplumber}} で、新しいファイルを作成してデフォルト設定を上書きします:

{{hc|~/.config/wireplumber/main.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/main.lua.d/51-disable-suspension.lua)|2=
table.insert (alsa_monitor.rules, {
matches = {
{
-- Matches all sources.
{ "node.name", "matches", "alsa_input.*" },
},
{
-- Matches all sinks.
{ "node.name", "matches", "alsa_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

Bluetooth デバイスの場合は、次の設定も使用します (ファイルの場所が異なることに注意してください):

{{hc|~/.config/wireplumber/bluetooth.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/bluetooth.lua.d/51-disable-suspension.lua)|2=
-- Note: bluez_monitor, not alsa_monitor
table.insert (bluez_monitor.rules, {
matches = {
{
-- Matches all sources.
-- Note: bluez_input, not alsa_input
{ "node.name", "matches", "bluez_input.*" },
},
{
-- Matches all sinks.
-- Note: bluez_output, not alsa_output
{ "node.name", "matches", "bluez_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

{{ic|pipewire.service}} と {{ic|wireplumber.service}} を再起動して、変更を適用します。

サスペンドを完全に無効にする代わりに、タイムアウト値を、ソースがサスペンドされるまでに必要な遅延秒数に変更することもできます。

==== 複数のストリームの再生が開始されると音声が途切れる ====

この問題は通常、{{ic|pipewire-pulse.service}} [[systemd/ユーザー|ユーザーユニット]] の [[journal]] を読み取り、次のような行を見つけることで診断できます。

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド] によると、{{pkg|pipewire-media-session}} のこの問題を解決するには:

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf|2=
api.alsa.headroom = 1024
}}

{{pkg|wireplumber}} を使用する場合:

{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|2=
apply_properties = {
["api.alsa.headroom"] = 1024,
},
}}

カーネルページのロックやスケジューリングの遅延が原因で音声の途切れが発生する場合は、[[ゲーム#カーネルパラメータを調整して応答時間を安定化させる|カーネルパラメータを調整して応答時間を安定化させる]] を参照してください。

==== 音がひずむ ====
* マイクについては、{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。
* {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} のコメントを外して、値を {{ic|44100}} に下げてみてください。

==== スタンバイ後に音声の問題が発生する ====

スリープから復帰した際に音が消えたり壊れたりする場合は、ALSA を最初期化すると改善するかもしれません:

# alsactl init

==== USB DAC(例:Schiit 社製 DAC)で高レイテンシー ====

サンプルレートやフォーマットを変更することで、Schiit Hel 2 などの一部の DAC でレイテンシーを減らすことができるかもしれません [https://www.reddit.com/r/osugame/comments/msifdd/usb_dacamp_and_audio_lag/] ''pipewire-media-session'' のマッチングルールを使用すると、デバイスのプロパティを設定することができます [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-pipewire-media-session#matching-rules]
''pipewire-media-session'' の {{ic|alsa-monitor.conf}} のデフォルト設定を {{ic|/etc/pipewire/media-session.d}} か {{ic|~/.config/pipewire/media-session.d}} にコピーしてください。
そして、以下のような新しいルールブロックを追加してください。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf
~/.config/pipewire/media-session.d/alsa-monitor.conf|output=
rules = {
...
{
matches = [
{
node.name = "alsa_output.<name of node>"
}
]
actions = {
update-props = {
audio.format = "S24_3LE"
audio.rate = 96000
# Following value should be doubled until audio doesn't cut out or other issues stop occurring
api.alsa.period-size = 128
}
}
}
...
}
}}

{{ic|alsa_output.<node name>}} ノードは {{ic|pw-top}} で取得することができます。

DAC は異なるフォーマットやサンプルレートをサポートしているかもしれません。[[ALSA]] に問い合わせることで、あなたの DAC が何をサポートしているかを確認することができます。

まず、DAC のカード番号を取得します。

{{hc|$ aplay -l|
...
card 3: S2 [Schiit Hel 2], device 0: USB Audio [USB Audio]
Subdevices: 0/1
Subdevice #0: subdevice #0
...
}}

つまり、この例ではカード3ということになります。
サポートされているすべてのサンプルレートとフォーマットを取得します。

{{hc|$ cat /proc/asound/cardX/streamX|
...
Playback:
...
Interface 1
Altset 1
Format: S16_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 16
...
Interface 1
Altset 2
Format: S24_3LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 24
...
Interface 1
Altset 3
Format: S32_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 32
...
...
}}

この場合、{{ic|S16_LE, S24_3LE, S32_LE}} はサポートされているフォーマットで、{{ic|44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000}} はすべてのフォーマットでサポートされているサンプルレートとなります。

==== 音量が 30% になるまで USB DAC から音が出ない ====

USB DAC の中には、ある一定の音量に達するまで音が出なくなるものがあります [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1117] 一般的にこれは約 25%〜30% で、最初の音量が不快なほど大きくなり、低い音量を維持することができなくなります。解決策としては、{{ic|["api.alsa.soft-mixer"]}} を {{ic|true}} に設定して、ハードウェアミキサーの音量コントロールを無視することが挙げられます。

{{Pkg|wireplumber}} でこれを実現するには、{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}} 設定に次を使用して構成フラグメントを追加します。 {{ic|table.insert}}:

{{hc|~/.config/wireplumber/main.lua.d/51-volume-fix.lua|output=

table.insert (alsa_monitor.rules, {
matches = {
{
-- This matches all cards.
{ "device.name", "matches", "alsa_card.*" },
},
},
-- Apply properties on the matched object.
apply_properties = {
-- Don't use the hardware mixer for volume control. It
-- will only use software volume. The mixer is still used
-- to mute unused paths based on the selected port.
["api.alsa.soft-mixer"] = true,
}
})
}}

次に、pipewire を再起動します。{{ic|alsamixer}} でマスターボリュームを設定し、{{ic|# alsactl store}} で設定を保存します。これで、ボリュームミキサーを通常どおり使用できるようになります。

==== リアルタイムオーディオが動作しない ====

{{ic|RTKit error: org.freedesktop.DBus.Error.AccessDenied}} が {{ic|systemctl --user status pipewire.service}} の出力に表示された場合、pipewire daemon の優先度がリアルタイムに変更されていないことを示します。この問題については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1069] を参照してください。

==== 同じサウンドカード上の複数のシンクへの同時出力 ====

{{ic|/usr/share/alsa-card-profile/mixer/profile-sets/default.conf}} のコピーを作成し、アップデート後も変更が持続するようにします。ここでは、アナログと HDMI の2つのデフォルトマッピングを結合したプロファイルを定義しています。

{{hc|/usr/share/alsa-card-profile/mixer/profile-sets/multiple.conf|2=
[General]
auto-profiles = no

[Mapping analog-stereo]
device-strings = front:%f
channel-map = left,right
paths-output = analog-output analog-output-lineout analog-output-speaker analog-output-headphones analog-output-headphones-2
paths-input = analog-input-front-mic analog-input-rear-mic analog-input-internal-mic analog-input-dock-mic analog-input analog-input-mic analog-input-linein analog-input-aux analog-input-video analog-input-tvtuner analog-input-fm analog-input-mic-line analog-input-headphone-mic analog-input-headset-mic
priority = 15

[Mapping hdmi-stereo]
description = Digital Stereo (HDMI)
device-strings = hdmi:%f
paths-output = hdmi-output-0
channel-map = left,right
priority = 9
direction = output

[Profile multiple]
description = Analog Stereo Duplex + Digital Stereo (HDMI) Output
output-mappings = analog-stereo hdmi-stereo
input-mappings = analog-stereo
}}

ここで、PipeWire の media-session に、新しい card-profile を使用してデバイスをマッチングするように設定します。識別情報は、{{ic|$ pw-cli dump device}} で見つけることができます。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf|2=
rules = [
{
matches = [ { alsa.card_name = "HDA Intel PCH" } ]
actions = {
update-props = {
api.alsa.use-acp = true
device.profile-set = "multiple.conf"
device.profile = "multiple"
api.acp.auto-profile = false
api.acp.auto-port = false
}
}
}
]
}}

==== Discord から通知音が鳴らない ====

min.quantum が低すぎることが原因かもしれませんので、700以上に設定してみてください。pipewire-pulse.conf の pulse.rules セクションに以下のルールを追加することで、Discord 専用にオーバーライドすることが可能です。

{{hc|/etc/pipewire/pipewire-pulse.conf (or ~/.config/pipewire/pipewire-pulse.conf)|output=
...
pulse.rules = [
...
{
# Discord notification sounds fix
matches = [ { application.process.binary = "Discord" } ]
actions = {
update-props = {
pulse.min.quantum = 1024/48000 # 21ms
}
}
}
...
}}

==== PipeWire で FMOD ゲームがクラッシュする ====

[[Wikipedia:Pillars_of_Eternity|Pillars of Eternity]] のような古いバージョンの [[Wikipedia:FMOD|FMOD オーディオエンジン]] を使っているゲームの中には、PulseAudio バイナリが存在しないと {{ic|pulseaudio --check}} を呼び出してクラッシュするものがあります。回避策としては、{{ic|/bin/pulseaudio}}を{{ic|/bin/true}}にシンボリックリンクすることです[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1514]

# ln -s /bin/true /bin/pulseaudio

PulseAudio を再インストールする場合は、シンボリックリンクを削除する必要があることに注意してください。

==== 自動切り替えが機能しない ====

自動切り替えが機能しない場合、[[WirePlumber]] の状態に問題がある可能性があります。[https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/191#note_1252549 this comment] が提案しているように、[[WirePlumber]] のローカル状態を削除し、デーモンを再起動することで改善されるかどうか確認することができます。

$ rm -r ~/.local/state/wireplumber/

次に、{{ic|wireplumber.service}} [[systemd/ユーザー|ユーザーユニット]] を [[ヘルプ:読み方# systemd ユニットのコントロール|再起動]] します。

==== リアルタイムプライオリティの欠落/サスペンド後の負荷によるクラックリング ====

rtkit の [https://github.com/heftig/rtkit/issues/13 2011年] からのバグにより、サスペンドイベントが発生すると PipeWire のリアルタイム優先度が取り消され、元に戻らなくなります。この原因となる保護を無効にするには、{{ic|rtkit-daemon.service}} を [[編集]] してください:

{{hc|/etc/systemd/system/rtkit-daemon.service.d/override.conf|2=
[Service]
ExecStart=
ExecStart=/usr/lib/rtkit-daemon --no-canary
}}

次に、メディアセッションサービスとともに、{{ic|rtkit-daemon.service}} ユニットと {{ic|pipewire.service}} ユーザーユニットを再起動します。

==== RAOP デバイス (Sonos など) へのストリーミング中に音が出ない ====

[[Avahi]] または [[systemd-resolved]] を使用して mDNS ホスト名解決を設定します。

==== KDE Plasma でサウンドデバイスが表示されない ====

PipeWire クライアント (デスクトップ環境を含む) は、[https://specations.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables XDG_RUNTIME_DIR] [[環境変数]] に依存して PipeWire デーモンに接続する場合があります。[https://docs.pipewire.org/page_daemon.html] ログイン直後にサウンドデバイスが表示されない場合は、この変数が手動で間違ったパスに設定されている可能性があります。

これは PipeWire を手動で再起動することで解決できますが、Chromium で画面共有できない ({{ic|pipewire context failed}} により) など、他の問題が依然として発生する可能性があります。{{ic|XDG_RUNTIME_DIR}} は {{man|8|pam_systemd}} によって自動的に設定されるため、初期化ファイルに設定されているインスタンスをすべて削除する必要があります。

==== SDDM ユーザーのデバイス音量がログイン時に復元されない ====

SDDM を使用していて、ログイン後にオーディオの音量レベルが正しく復元されない場合は、SDDM に対して Pipewire をマスクしてください。SDDM で実行される Wireplumber が、ユーザーの Wireplumber セッションに干渉する可能性があります。

systemctl --user -M sddm@ mask pipewire.socket

詳細については、[https://wiki.debian.org/PipeWire#Device_volume_for_SDDM_users_is_not_restored_on_login Debian Wiki] の記事を参照してください。

==== ターミナルベルが動作しない ====

PipeWire の観点からは、module x11.bell がロードされている必要があります。これはデフォルトの設定です(上記の設定ファイルも参照){{Pkg|pipewire-x11-bell}} パッケージがインストールされているか確認してください。

また、ウィンドウマネージャーがターミナルベルに影響を与えることがあります。例えば、xfwm を使用している場合は、xfwm-terminal の設定で "聴ベル(Audible bell)" が有効になっているか確認してください。

次に、PipeWire サービスを再起動します:

systemctl --user restart pipewire

ターミナルベルが動作するか試すには、以下のコマンドを実行します:

echo $'\a'

==== 最初の再生試行まで音が出ない ====

PipeWire がソケットアクティベーションによって起動される設定になっている場合、一部の PipeWire ネイティブアプリケーションにおいて、[[WirePlumber]] がノードを構成する前にオーディオの再生を試みてしまい、結果としてエラーが発生することがあります。

例:

{{hc|$ mpv -v ''/path/to/file''|
[ao/pipewire] PipeWire does not have any audio sinks, skipping
[ao] Failed to initialize audio driver 'pipewire'
}}

{{hc|$ journalctl --user -u mpd.service|
output: Failed to play on "PipeWire" (pipewire): no target node available
exception: Failed to open audio output
}}

回避策として、{{ic|pipewire.service}} の[[ユーザーユニット]]を[[有効化]]してください。

=== ビデオ ===

==== OBS(など)がウィンドウ/スクリーンを要求しても何も表示されない ====

{{Pkg|xdg-desktop-portal}} と {{Pkg|xdg-desktop-portal-gtk}} または {{Pkg|xdg-desktop-portal-kde}} がインストールされていることが確実なら、デーモンの実行状態を確認してください。

OBS では、すべてがうまくいっていれば、{{ic|stdout}} にこのように表示されるはずです。

...
info: [pipewire] desktop selected, setting up screencast
info: [pipewire] created stream 0x5632d7456850
info: [pipewire] playing stream...

マルチモニタ環境では、{{Pkg|slurp}} パッケージを使用すると、すべての画面をキャプチャすることができます。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

Kanshi

2026-02-20T05:51:17Z

Kgx: 翻訳

[[Category:Wayland]]
[[en:Kanshi]]
[[zh-hans:Kanshi]]
{{Related articles start}}
{{Related|Sway}}
{{Related articles end}}

[https://gitlab.freedesktop.org/emersion/kanshi kanshi] を使用すると、ホットプラグに応じて自動的に有効・無効が切り替わる出力プロファイルを定義できます。例えば、ノートパソコンをドックに接続した際に内蔵スクリーンをオフにする、といった設定が可能です。

これは、[https://github.com/phillipberndt/autorandr autorandr] などのツールのWayland版に相当します。kanshiは、wlr-output-management プロトコルをサポートしている Wayland コンポジタで使用できます。

== インストール ==

{{Pkg|kanshi}} パッケージ、または {{AUR|kanshi-git}} を[[インストール]]してください。

== 設定 ==

=== 基本設定 ===

kanshiの設定ファイルを作成します:

{{hc|1=~/.config/kanshi/config|2=
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
}

profile {
output LVDS-1 enable scale 2
}
}}

各出力プロファイルはブラケット(波括弧)で区切られます。その中には複数の出力ディレクティブが含まれます(構文は {{man|5|sway-output}} と同様です) リストされているすべての出力が接続されている場合に、そのプロファイルが有効になります。

{{Tip|出力名や詳細情報のリストを取得するには、{{ic|wlr-randr}} や {{ic|swaymsg -t get_outputs}} などのコマンドを使用するか、GUIアプリケーションである {{AUR|wdisplays-git}} または {{AUR|wdisplays-persistent}} を使用してください。これらは、kanshiの設定ファイルに直接書き込むことも可能です。}}

=== 応用設定 ===

複数のセットアップ (例:ノート PC 本体のみ、自宅でモニター1台に接続、職場でモニター2台に接続、など) を簡単に管理するために、プロファイル内で使用する出力のデフォルト値を定義し、エイリアスを割り当てることができます。デフォルト値は、その出力が言及されているすべてのプロファイルに適用されます。詳細は {{man|5|kanshi}} を参照してください。

{{hc|1=~/.config/kanshi/config|2=
output "Dell Inc. DELL S2721DGF G52TR83" {
mode 2560x1440@165.08
position 1280,0
scale 2
alias $HOME_1
}

output "LG Display 0x058B Unknown" {
mode 2560x1440@59.99800
position 0,0
scale 2
alias $INTERNAL
}

profile home_1 {
output $INTERNAL disable
output $HOME_1 enable
}
}}

これらの値は、[https://wiki.hyprland.org/Configuring/Using-hyprctl/ hyprctl monitors] のようなコマンドで確認できます。実行すると、以下のように出力されます。

{{hc|1=hyprctl monitors|2=
make: LG Display
model: 0x058B
serial:
}}

また、exec ディレクティブを使用することで、プロファイルが正常に適用された後にコマンドを実行し、ワークフローとさらに統合させることも可能です。

{{hc|1=~/.config/kanshi/config|2=
profile home_1 {
output $INTERNAL disable
output $HOME_1 enable
exec uwsm app -- $HOME/.config/hypr/scripts/move-workspaces.sh "LG Display 0x058B"
}
}}

== 使用方法 ==

次のコマンドを実行します:

$ kanshi

自動的に実行する方法については、[[#systemd で kanshi を管理する]] を参照してください。

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

=== systemd で kanshi を管理する ===

[[Sway#systemd で sway 固有のデーモンを管理する]] の手順に従って、{{ic|~/.config/systemd/user/sway-session.target}} を作成し、起動してください (未作成の場合)

次に、{{ic|kanshi.service}} ファイルを作成します:

{{hc|1=~/.config/systemd/user/kanshi.service|2=
[Unit]
Description=Dynamic output configuration for Wayland compositors
Documentation=man:kanshi(1)
BindsTo=sway-session.target

[Service]
Type=simple
ExecStart=/usr/bin/kanshi

[Install]
WantedBy=sway-session.target
}}

この[[ユーザーユニット]]を[[有効化]]してください。これにより、Sway の実行中にのみ有効になり、Sway が停止すると無効になります。

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

=== スリープ復帰後、外部モニターのワークスペース番号が2から始まる ===

[[#設定|上記]]のような設定をしている場合、2番目のディスプレイを接続した際、最初のディスプレイが無効化されているため、2番目のディスプレイのワークスペースは「1」から始まるはずです。初回接続時やシステム起動直後はその通りになりますが、スリープ復帰後にこの番号が「2」になってしまうことがあります。この場合は、kanshi の設定ファイルにディレクティブを追加して、最初のワークスペースをそのモニターに移動させるようにしてください:

{{hc|1=~/.config/kanshi/config|2=
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
# 以下のディレクティブを追加します(出力名は適宜書き換えてください):
exec swaymsg workspace 1, move workspace to HDMI-A-1
}

profile {
output LVDS-1 enable scale 2
}
}}

== 参照 ==

* [https://gitlab.freedesktop.org/emersion/kanshi ソースコードとドキュメント]

Niri

2026-02-17T07:23:42Z

Kgx: 微修正

[[Category:Wayland コンポジタ]]
[[en:Niri]]
[https://github.com/niri-wm/niri Niri] は、スクロール可能なタイリング型 [[Wayland]] コンポジタです。[[Sway]] や [[Hyprland]] とは異なり、Niri はウィンドウを無限に広がる水平なデスクトップ上に配置し、左右にスクロールして操作します(より高度なレイアウトも可能です) [[GNOME]] の PaperWM や [[KDE]] の Karousel に近い操作感を提供します。

== インストール ==

Niri は {{pkg|niri}} パッケージで[[インストール]]できます。また、より快適な環境を構築するために、以下のパッケージのインストールが推奨されます:

* {{pkg|fuzzel}}: Niri のデフォルトアプリケーションランチャー
* {{pkg|mako}}: 通知サーバー
* [[waybar]]: Wayland 用ステータスバー
* {{pkg|xdg-desktop-portal-gtk}}, {{pkg|xdg-desktop-portal-gnome}}: スクリーン共有を可能にするため
* [[alacritty]]: Niri のデフォルトターミナル
* {{pkg|swaybg}}: 壁紙の設定
* {{pkg|swayidle}}, {{pkg|swaylock}}: アイドル時の画面ロック
* {{pkg|xwayland-satellite}}: X11 アプリケーションの実行用
* {{pkg|udiskie}}: USB ドライブの管理と自動マウント

== 起動 ==

Niri には [[デスクトップエントリ]] が含まれており、[[ディスプレイマネージャ]] から選択可能です。これを選択すると {{ic|niri-session}} が実行され、[[systemd]] への [[環境変数]] のエクスポートが適切に行われます。

また、[[getty]] (コンソール) から直接起動する場合は、以下のコマンドを実行します:

niri-session -l

これは [[Getty#Automatic login to virtual console|自動ログイン]] と組み合わせることで、シームレスな [[ブート]] 体験を実現できます。

== 設定 ==

Niri は {{ic|~/.config/niri/config.kdl}} から設定を読み込みます。ファイル形式は KDL で、セクションごとに分かれています。初回実行時に生成されるデフォルト設定ファイルには、各オプションの説明がコメントとして記載されています。ただし、アップデートで追加された新機能については記載されないため、[https://niri-wm.github.io/niri/Configuration:-Introduction.html Niri 公式ドキュメント] を参照してください。

設定ファイルを保存すると、Niri は自動的に設定を適用します。設定内容が不正であっても Niri はクラッシュせず、最後に動作していた状態が維持され、エラーがユーザーに通知されます。セッション外で設定を検証するには {{ic|niri validate}} を使用します。

== キーマップ ==

キーマップを設定するには、{{ic|input/keyboard/xkb}} セクションを編集します。

例えば、"US Int Alt Gr" レイアウトを使用し、{{ic|CapsLock}} を {{ic|Ctrl}} として機能させる場合は以下のようになります:

{{hc|~/.config/niri/config.kdl|
input {
keyboard {
xkb {
layout "us"
variant "altgr-intl"
options "ctrl:nocaps"
}
}
...
}
}}

=== 出力 ===

まず {{ic|niri msg outputs}} を実行して、Niri が認識している出力を確認します。その後、各モニターに設定を適用できます。例として、HDMI モニターを 2560x1440 60Hz、スケーリング 1.2 に設定し、ノート PC の内蔵モニターをオフにする設定は以下の通りです:

{{hc|~/.config/niri/config.kdl|
output "HDMI-A-1" {
mode "2560x1440@60.000"
scale 1.2
}

output "eDP-1" {
off
}
}}

{{Note|ドッキングステーションへの接続時などに動的なレイアウト変更を行いたい場合は、[[kanshi]] を併用することも検討してください。}}

=== キーバインド ===

binds セクションでは、Niri を操作するキーの組み合わせを設定します。初回起動時に生成される設定には多くのバインドが含まれており、これらはすべて変更可能です。

注意点として、Niri はデフォルトのキーバインドを自動的にロードしません。設定ファイルに記述がないバインドは機能しません。そのため、不要なバインドを削除する際は、削除ではなくコメントアウトに留めることが推奨されます。

バインドは、修飾キーに {{ic|+}} を繋げ、アクションを括弧内に記述します。spawn アクションはプログラムを起動します。以下の例では、{{ic|Mod+T}} で [[alacritty]] を、{{ic|Mod+D}} で {{pkg|fuzzel}} を起動します。{{ic|Mod}} は通常、単独実行時は {{ic|Super}} キー、他のコンポジット内での実行時は {{ic|Alt}} キーになります。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+T { spawn "alacritty"; }
Mod+D { spawn "fuzzel"; }
...
}
}}

{{ic|spawn}} に渡す引数にスペースが含まれる場合は、個別に引用符で囲む必要があります:

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+Ctrl+semicolon {
spawn "swaylock" "-c" "121212" "-e" "-f" "-F"
}
...
}
}}

==== WASD 風のナビゲーション ====

ゲームのような WASD キーによるウィンドウ移動を設定することも可能です。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+A { focus-column-left; }
Mod+S { focus-window-or-workspace-down; }
Mod+W { focus-window-or-workspace-up; }
Mod+D { focus-column-right; }
...
}
}}

※この設定を導入する場合、既存の他のバインドとの競合を避けるために調整が必要になる場合があります。

=== 自動起動 ===

Niri の起動時に特定のプログラムを同時に開始できます。
前述した {{Pkg|mako}}、{{Pkg|waybar}}、{{Pkg|swayidle}}/{{Pkg|swaylock}} などの設定例は以下の通りです:

{{hc|~/.config/niri/config.kdl|
spawn-at-startup "mako"
spawn-at-startup "waybar"
spawn-at-startup "swayidle" "-w" "timeout" "601" "niri msg action power-off-monitors" "timeout" "600" "swaylock -f" "before-sleep" "swaylock -f"
}}

これらのプロセスは Niri セッションに紐付けられており、Niri が終了または中断されると終了します。プロセスをバックグラウンドで永続させたい場合は、引数に {{ic|"&"}} を追加してください。

=== XWayland ===

Niri は X11 アプリケーションを実行するための XWayland を標準ではサポートしていません。その代わり、外部ツールの使用を推奨しています。オプションの依存関係にある {{Pkg|xwayland-satellite}} をインストールすれば、特別な設定なしで使用可能です。

=== マルチ GPU 設定 ===

内蔵グラフィックスと専用 GPU (dGPU) の両方を搭載した環境では、Niri がデフォルトで dGPU を使用してしまい、バッテリーを浪費する場合があります。

{{Note|NVIDIA カードを使用している場合は、GPU を低電力状態にする方法やアプリごとの起動設定について [[PRIME]] を参照してください。}}

Niri が使用する GPU を指定するには、まずシステムで利用可能なレンダリングデバイスを確認します:
{{hc|
$ ls -l /dev/dri/by-path/*-render|
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c1:00.0-render -> ../renderD129
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c2:00.0-render -> ../renderD128
}}

次に、PCI アドレスを使って各デバイスがどのカードかを確認します:
{{hc|
$ lspci -s c1:00.0|
c1:00.0 VGA compatible controller: NVIDIA Corporation GB206M [GeForce RTX 5070 Max-Q / Mobile] (rev a1)
}}

使用したいデバイスを特定したら、Niri の設定ファイルに追記します:
{{hc|
~/.config/niri/config.kdl|
debug {
render-drm-device "/dev/dri/renderD128"
}
}}

再起動後、以下のコマンドで GPU が正しく低電力状態 (D3cold など) になっているか確認できます:
{{hc|
$ cat /sys/class/drm/card*/device/power_state|
D3cold
D0
}}

== 参照 ==

[https://niri-wm.github.io/niri/ Niri 公式 Wiki]

Kanshi

2026-02-17T07:22:03Z

Kgx:

[[Category:Wayland]]
[[en:Kanshi]]
[[zh-hans:Kanshi]]
{{Related articles start}}
{{Related|Sway}}
{{Related articles end}}

[https://gitlab.freedesktop.org/emersion/kanshi kanshi] allows you to define output profiles that are automatically enabled and disabled on hotplug. For instance, this can be used to turn a laptop's internal screen off when docked.

This is a Wayland equivalent for tools like [https://github.com/phillipberndt/autorandr autorandr]. kanshi can be used on Wayland compositors supporting the wlr-output-management protocol.

== Installation ==

[[Install]] {{Pkg|kanshi}} or {{AUR|kanshi-git}}.

== Configuration ==

=== Basic ===

Create kanshi configuration file:

{{hc|1=~/.config/kanshi/config|2=
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
}

profile {
output LVDS-1 enable scale 2
}
}}

Each output profile is delimited by brackets. It contains several output directives (whose syntax is similar to {{man|5|sway-output}}). A profile will be enabled if all of the listed outputs are connected.

{{Tip|You can get a list of output names and additional information using commands like {{ic|wlr-randr}}, {{ic|swaymsg -t get_outputs}} or use the GUI applications {{AUR|wdisplays-git}} or {{AUR|wdisplays-persistent}} which will write also directly to kanshi's configuration file.}}

=== Advanced ===

For easier management of multiple setups ''(e.g. Internal laptop monitor only, Docked to one monitor at home, Docked to two work monitors, ...)'' you can define defaults for the outputs used inside profiles and assign them aliases. The defaults will apply to all profiles where the respective output is mentioned. For more see {{man|5|kanshi}}).

{{hc|1=~/.config/kanshi/config|2=
output "Dell Inc. DELL S2721DGF G52TR83" {
mode 2560x1440@165.08
position 1280,0
scale 2
alias $HOME_1
}

output "LG Display 0x058B Unknown" {
mode 2560x1440@59.99800
position 0,0
scale 2
alias $INTERNAL
}

profile home_1 {
output $INTERNAL disable
output $HOME_1 enable
}
}}

You can find out these values with a command like [https://wiki.hyprland.org/Configuring/Using-hyprctl/ hyprctl monitors] which will display all three of those in its output.

{{hc|1=hyprctl monitors|2=
make: LG Display
model: 0x058B
serial:
}}

It is also possible to further integrate kanshi with your workflow by using the ''exec'' directive to execute a command once the profile was successfully applied.

{{hc|1=~/.config/kanshi/config|2=
profile home_1 {
output $INTERNAL disable
output $HOME_1 enable
exec uwsm app -- $HOME/.config/hypr/scripts/move-workspaces.sh "LG Display 0x058B"
}
}}

== Usage ==

Run the command:

$ kanshi

See [[#Manage kanshi with systemd]] for an automated usage.

== Tips and tricks ==

=== Manage kanshi with systemd ===

Create and start {{ic|~/.config/systemd/user/sway-session.target}} (if you don't have created yet) by following [[Sway#Manage Sway-specific daemons with systemd]].

Create the {{ic|kanshi.service}} file:

{{hc|1=~/.config/systemd/user/kanshi.service|2=
[Unit]
Description=Dynamic output configuration for Wayland compositors
Documentation=man:kanshi(1)
BindsTo=sway-session.target

[Service]
Type=simple
ExecStart=/usr/bin/kanshi

[Install]
WantedBy=sway-session.target
}}

[[Enable]] this [[user unit]]. It is only activated when Sway is running and deactivated when Sway stops.

== Troubleshooting ==

=== Workspace number starts from 2 in external monitor after wake up ===

If you have a configuration like [[#Configuration|above]], when you connected a second display to your computer, the workspace in the second display should start from 1 since the first display is disabled. This should be the case when you plugged your monitor in the first time or after starting the system. But after sleep, this number might be 2. In this case just move the first workspace to this monitor by adding a directive to the kanshi configuration file:

{{hc|1=~/.config/kanshi/config|2=
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
# We've added this directive here (do not forget to update the output name):
exec swaymsg workspace 1, move workspace to HDMI-A-1
}

profile {
output LVDS-1 enable scale 2
}
}}

== See also ==

* [https://gitlab.freedesktop.org/emersion/kanshi Source code and documentation]

Niri

2026-02-17T07:21:12Z

Kgx: 翻訳

[[Category:Wayland コンポジタ]]
[[en:Niri]]
[https://github.com/niri-wm/niri Niri] は、スクロール可能なタイリング型 [[Wayland]] コンポジットです。[[Sway]] や [[Hyprland]] とは異なり、Niri はウィンドウを無限に広がる水平なデスクトップ上に配置し、左右にスクロールして操作します(より高度なレイアウトも可能です)。[[GNOME]] の PaperWM や [[KDE]] の Karousel に近い操作感を提供します。
インストール

Niri は {{pkg|niri}} パッケージで[[インストール]]できます。また、より快適な環境を構築するために、以下のパッケージのインストールが推奨されます:

* {{pkg|fuzzel}}: Niri のデフォルトアプリケーションランチャー
* {{pkg|mako}}: 通知サーバー
* [[waybar]]: Wayland 用ステータスバー
* {{pkg|xdg-desktop-portal-gtk}}, {{pkg|xdg-desktop-portal-gnome}}: スクリーン共有を可能にするため
* [[alacritty]]: Niri のデフォルトターミナル
* {{pkg|swaybg}}: 壁紙の設定
* {{pkg|swayidle}}, {{pkg|swaylock}}: アイドル時の画面ロック
* {{pkg|xwayland-satellite}}: X11 アプリケーションの実行用
* {{pkg|udiskie}}: USB ドライブの管理と自動マウント

== 起動 ==

Niri には [[デスクトップエントリ]] が含まれており、[[ディスプレイマネージャ]] から選択可能です。これを選択すると {{ic|niri-session}} が実行され、[[systemd]] への [[環境変数]] のエクスポートが適切に行われます。

また、[[getty]] (コンソール) から直接起動する場合は、以下のコマンドを実行します:

niri-session -l

これは [[Getty#Automatic login to virtual console|自動ログイン]] と組み合わせることで、シームレスな [[ブート]] 体験を実現できます。

== 設定 ==

Niri は {{ic|~/.config/niri/config.kdl}} から設定を読み込みます。ファイル形式は KDL で、セクションごとに分かれています。初回実行時に生成されるデフォルト設定ファイルには、各オプションの説明がコメントとして記載されています。ただし、アップデートで追加された新機能については記載されないため、[https://niri-wm.github.io/niri/Configuration:-Introduction.html Niri 公式ドキュメント] を参照してください。

設定ファイルを保存すると、Niri は自動的に設定を適用します。設定内容が不正であっても Niri はクラッシュせず、最後に動作していた状態が維持され、エラーがユーザーに通知されます。セッション外で設定を検証するには {{ic|niri validate}} を使用します。

== キーマップ ==

キーマップを設定するには、{{ic|input/keyboard/xkb}} セクションを編集します。

例えば、"US Int Alt Gr" レイアウトを使用し、{{ic|CapsLock}} を {{ic|Ctrl}} として機能させる場合は以下のようになります:

{{hc|~/.config/niri/config.kdl|
input {
keyboard {
xkb {
layout "us"
variant "altgr-intl"
options "ctrl:nocaps"
}
}
...
}
}}

=== 出力 ===

まず {{ic|niri msg outputs}} を実行して、Niri が認識している出力を確認します。その後、各モニターに設定を適用できます。例として、HDMI モニターを 2560x1440 60Hz、スケーリング 1.2 に設定し、ノート PC の内蔵モニターをオフにする設定は以下の通りです:

{{hc|~/.config/niri/config.kdl|
output "HDMI-A-1" {
mode "2560x1440@60.000"
scale 1.2
}

output "eDP-1" {
off
}
}}

{{Note|ドッキングステーションへの接続時などに動的なレイアウト変更を行いたい場合は、[[kanshi]] を併用することも検討してください。}}

=== キーバインド ===

binds セクションでは、Niri を操作するキーの組み合わせを設定します。初回起動時に生成される設定には多くのバインドが含まれており、これらはすべて変更可能です。

注意点として、Niri はデフォルトのキーバインドを自動的にロードしません。設定ファイルに記述がないバインドは機能しません。そのため、不要なバインドを削除する際は、削除ではなくコメントアウトに留めることが推奨されます。

バインドは、修飾キーに {{ic|+}} を繋げ、アクションを括弧内に記述します。spawn アクションはプログラムを起動します。以下の例では、{{ic|Mod+T}} で [[alacritty]] を、{{ic|Mod+D}} で {{pkg|fuzzel}} を起動します。{{ic|Mod}} は通常、単独実行時は {{ic|Super}} キー、他のコンポジット内での実行時は {{ic|Alt}} キーになります。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+T { spawn "alacritty"; }
Mod+D { spawn "fuzzel"; }
...
}
}}

{{ic|spawn}} に渡す引数にスペースが含まれる場合は、個別に引用符で囲む必要があります:

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+Ctrl+semicolon {
spawn "swaylock" "-c" "121212" "-e" "-f" "-F"
}
...
}
}}

==== WASD 風のナビゲーション ====

ゲームのような WASD キーによるウィンドウ移動を設定することも可能です。

{{hc|~/.config/niri/config.kdl|
binds {
...
Mod+A { focus-column-left; }
Mod+S { focus-window-or-workspace-down; }
Mod+W { focus-window-or-workspace-up; }
Mod+D { focus-column-right; }
...
}
}}

※この設定を導入する場合、既存の他のバインドとの競合を避けるために調整が必要になる場合があります。

=== 自動起動 ===

Niri の起動時に特定のプログラムを同時に開始できます。
前述した {{Pkg|mako}}、{{Pkg|waybar}}、{{Pkg|swayidle}}/{{Pkg|swaylock}} などの設定例は以下の通りです:

{{hc|~/.config/niri/config.kdl|
spawn-at-startup "mako"
spawn-at-startup "waybar"
spawn-at-startup "swayidle" "-w" "timeout" "601" "niri msg action power-off-monitors" "timeout" "600" "swaylock -f" "before-sleep" "swaylock -f"
}}

これらのプロセスは Niri セッションに紐付けられており、Niri が終了または中断されると終了します。プロセスをバックグラウンドで永続させたい場合は、引数に {{ic|"&"}} を追加してください。

=== XWayland ===

Niri は X11 アプリケーションを実行するための XWayland を標準ではサポートしていません。その代わり、外部ツールの使用を推奨しています。オプションの依存関係にある {{Pkg|xwayland-satellite}} をインストールすれば、特別な設定なしで使用可能です。

=== マルチ GPU 設定 ===

内蔵グラフィックスと専用 GPU (dGPU) の両方を搭載した環境では、Niri がデフォルトで dGPU を使用してしまい、バッテリーを浪費する場合があります。

{{Note|NVIDIA カードを使用している場合は、GPU を低電力状態にする方法やアプリごとの起動設定について [[PRIME]] を参照してください。}}

Niri が使用する GPU を指定するには、まずシステムで利用可能なレンダリングデバイスを確認します:
{{hc|
$ ls -l /dev/dri/by-path/*-render|
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c1:00.0-render -> ../renderD129
lrwxrwxrwx 1 root root 13 Jan 10 13:02 /dev/dri/by-path/pci-0000:c2:00.0-render -> ../renderD128
}}

次に、PCI アドレスを使って各デバイスがどのカードかを確認します:
{{hc|
$ lspci -s c1:00.0|
c1:00.0 VGA compatible controller: NVIDIA Corporation GB206M [GeForce RTX 5070 Max-Q / Mobile] (rev a1)
}}

使用したいデバイスを特定したら、Niri の設定ファイルに追記します:
{{hc|
~/.config/niri/config.kdl|
debug {
render-drm-device "/dev/dri/renderD128"
}
}}

再起動後、以下のコマンドで GPU が正しく低電力状態 (D3cold など) になっているか確認できます:
{{hc|
$ cat /sys/class/drm/card*/device/power_state|
D3cold
D0
}}

== 参照 ==

[https://niri-wm.github.io/niri/ Niri 公式 Wiki]

Kanshi

2026-02-17T07:18:47Z

Kgx: 英語版から転載

{{Lowercase title}}
[[Category:Wayland]]
[[en:Kanshi]]
[[zh-hans:Kanshi]]
{{Related articles start}}
{{Related|Sway}}
{{Related articles end}}

[https://gitlab.freedesktop.org/emersion/kanshi kanshi] allows you to define output profiles that are automatically enabled and disabled on hotplug. For instance, this can be used to turn a laptop's internal screen off when docked.

This is a Wayland equivalent for tools like [https://github.com/phillipberndt/autorandr autorandr]. kanshi can be used on Wayland compositors supporting the wlr-output-management protocol.

== Installation ==

[[Install]] {{Pkg|kanshi}} or {{AUR|kanshi-git}}.

== Configuration ==

=== Basic ===

Create kanshi configuration file:

{{hc|1=~/.config/kanshi/config|2=
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
}

profile {
output LVDS-1 enable scale 2
}
}}

Each output profile is delimited by brackets. It contains several output directives (whose syntax is similar to {{man|5|sway-output}}). A profile will be enabled if all of the listed outputs are connected.

{{Tip|You can get a list of output names and additional information using commands like {{ic|wlr-randr}}, {{ic|swaymsg -t get_outputs}} or use the GUI applications {{AUR|wdisplays-git}} or {{AUR|wdisplays-persistent}} which will write also directly to kanshi's configuration file.}}

=== Advanced ===

For easier management of multiple setups ''(e.g. Internal laptop monitor only, Docked to one monitor at home, Docked to two work monitors, ...)'' you can define defaults for the outputs used inside profiles and assign them aliases. The defaults will apply to all profiles where the respective output is mentioned. For more see {{man|5|kanshi}}).

{{hc|1=~/.config/kanshi/config|2=
output "Dell Inc. DELL S2721DGF G52TR83" {
mode 2560x1440@165.08
position 1280,0
scale 2
alias $HOME_1
}

output "LG Display 0x058B Unknown" {
mode 2560x1440@59.99800
position 0,0
scale 2
alias $INTERNAL
}

profile home_1 {
output $INTERNAL disable
output $HOME_1 enable
}
}}

You can find out these values with a command like [https://wiki.hyprland.org/Configuring/Using-hyprctl/ hyprctl monitors] which will display all three of those in its output.

{{hc|1=hyprctl monitors|2=
make: LG Display
model: 0x058B
serial:
}}

It is also possible to further integrate kanshi with your workflow by using the ''exec'' directive to execute a command once the profile was successfully applied.

{{hc|1=~/.config/kanshi/config|2=
profile home_1 {
output $INTERNAL disable
output $HOME_1 enable
exec uwsm app -- $HOME/.config/hypr/scripts/move-workspaces.sh "LG Display 0x058B"
}
}}

== Usage ==

Run the command:

$ kanshi

See [[#Manage kanshi with systemd]] for an automated usage.

== Tips and tricks ==

=== Manage kanshi with systemd ===

Create and start {{ic|~/.config/systemd/user/sway-session.target}} (if you don't have created yet) by following [[Sway#Manage Sway-specific daemons with systemd]].

Create the {{ic|kanshi.service}} file:

{{hc|1=~/.config/systemd/user/kanshi.service|2=
[Unit]
Description=Dynamic output configuration for Wayland compositors
Documentation=man:kanshi(1)
BindsTo=sway-session.target

[Service]
Type=simple
ExecStart=/usr/bin/kanshi

[Install]
WantedBy=sway-session.target
}}

[[Enable]] this [[user unit]]. It is only activated when Sway is running and deactivated when Sway stops.

== Troubleshooting ==

=== Workspace number starts from 2 in external monitor after wake up ===

If you have a configuration like [[#Configuration|above]], when you connected a second display to your computer, the workspace in the second display should start from 1 since the first display is disabled. This should be the case when you plugged your monitor in the first time or after starting the system. But after sleep, this number might be 2. In this case just move the first workspace to this monitor by adding a directive to the kanshi configuration file:

{{hc|1=~/.config/kanshi/config|2=
profile {
output LVDS-1 disable
output "Some Company ASDF 4242" mode 1600x900 position 0,0
# We've added this directive here (do not forget to update the output name):
exec swaymsg workspace 1, move workspace to HDMI-A-1
}

profile {
output LVDS-1 enable scale 2
}
}}

== See also ==

* [https://gitlab.freedesktop.org/emersion/kanshi Source code and documentation]

Waybar

2026-02-17T07:16:10Z

Kgx: 英語版から転載

[[Category:Wayland]]
[[de:Waybar]]
[[en:Waybar]]
[[pl:Waybar]]
[https://github.com/Alexays/Waybar Waybar] is a highly customizable [[Wayland]] bar for [[Sway]] and Wlroots based compositors. Its configuration is done in JSONC with styling in CSS.

== Installation ==

[[Install]] the {{Pkg|waybar}} package.

For the icons of the preconfigured modules a font like {{Pkg|otf-font-awesome}} is needed.
Some standard modules need further programs to function properly. Those are visible through error messages from those modules.

== Configuration ==
{{Expansion|This chapter only links to an external source.}}
There are some good explanations in the [https://github.com/Alexays/Waybar/wiki/Configuration Waybar Wiki].

== See also ==
* [https://github.com/Alexays/Waybar Official Git-Repository]
* [https://github.com/Alexays/Waybar/wiki Official Wiki]
* {{man|5|waybar}}

Mkinitcpio

2025-09-11T11:11:48Z

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

{{Lowercase title}}
[[Category:initramfs]]
[[Category:カーネル]]
[[Category:Arch プロジェクト]]
[[Category:コマンド]]
[[de:Mkinitcpio]]
[[en:Mkinitcpio]]
[[fr:Mkinitcpio]]
[[pt:Mkinitcpio]]
[[ru:Mkinitcpio]]
[[zh-hans:Mkinitcpio]]
{{Related articles start}}
{{Related|Booster}}
{{Related|ブートデバッグ}}
{{Related|dracut}}
{{Related|カーネルモジュール}}
{{Related|mkinitcpio/Initramfs の最小化}}
{{Related|systemd}}
{{Related|ユニファイドカーネルイメージ}}
{{Related articles end}}
[https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio mkinitcpio] は[[Wikipedia:Initial ramdisk|初期 RAM ディスク]]環境を作成するために使われる Bash スクリプトです。{{man|8|mkinitcpio}} man ページより:

:初期 ram ディスクは非常に小さい環境（初期ユーザー空間）であり、様々なカーネルモジュールをロードして {{ic|init}} にコントロールを移す前に必要なことをセットアップします。これにより、root ファイルシステムを暗号化したりソフトウェア RAID アレイに root を載せたりすることが可能になります。''mkinitcpio'' はカスタムフックによって簡単に拡張することができ、実行時の自動検知など様々な機能を持っています。

伝統的には、[[Arch ブートプロセス|ブートプロセス]]の初めにハードウェアを検知したりタスクの初期化を行うのはカーネルで、それから root ファイルシステムがマウントされ {{ic|init}} にコントロールが移されます。しかしながら、先端技術が生まれるにつれ、こういった作業は複雑になりつつあります。

今日、root ファイルシステムが載るハードウェアは SCSI から SATA、USB ドライブまで様々にわたり、それらハードウェアはそれぞれのメーカーによって作られたいろんなドライブコントローラによってコントロールされています。しかも、root ファイルシステムは暗号化されたり圧縮されたりする可能性もあります; ソフトウェア RAID アレイや論理ボリュームグループに含まれるかもしれません。複雑になったものをシンプルに扱う方法はユーザースペース (初期RAMディスク) へ管理を譲渡することです。参照: [https://web.archive.org/web/20150430223035/http://archlinux.me/brain0/2010/02/13/early-userspace-in-arch-linux/ /dev/brain0 » Blog Archive » Early Userspace in Arch Linux]。

''mkinitcpio'' は Arch Linux デベロッパーとコミュニティの貢献によって開発されています。[https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio public Git リポジトリ]を見て下さい。

初期 ramdisk フェーズ中に行われる様々なタスクがどのように実行されるかには、2つの異なるアプローチがあることに注意が必要です。

; Busybox ベースの初期 ramdisk: 初期 ramdisk のファイルシステムをスキャンし、実行されるスクリプト（この文脈ではランタイムフックと呼ばれる）を開始する init スクリプトが起動されます。
; systemd ベースの初期 ramdisk: 初期 ramdisk フェーズの開始時にすでに systemd が起動されています。実行されるタスクは、通常の systemd ユニットファイルによって決定されます。参照：[https://www.freedesktop.org/software/systemd/man/latest/bootup.html systemd bootup process]。

具体的なバリアントは、{{ic|/etc/mkinitcpio.conf}} 内の {{ic|HOOKS}} 配列に {{ic|systemd}} フックが存在するかどうかによって決まります。より詳細については、[[#通常のフック]] を参照してください。

== インストール ==

{{Pkg|mkinitcpio}} パッケージを[[インストール]]してください。このパッケージは {{Pkg|linux}} の依存パッケージとなっているので、大抵すでにインストールされているでしょう。

上級者は {{AUR|mkinitcpio-git}} パッケージで ''mkinitcpio'' の最新開発バージョンをインストールできます。

== イメージ作成とアクティベーション ==

=== 自動生成 ===

カーネルがインストールまたはアップグレードされるたびに、[[pacman フック]]は {{ic|/etc/mkinitcpio.d/}} 内に保存される ''.preset'' ファイルを自動的に生成します。例えば、公式の安定版 {{Pkg|linux}} カーネルパッケージの場合は {{ic|linux.preset}} です。プリセットは、様々なパラメーターや出力ファイルの場所を手動で指定する手間を省き、初期 RAM ディスクイメージを作成するために必要な情報のリストです。
デフォルトでは、2つのイメージを生成するための命令が含まれています:

# ''default'' RAM ディスクイメージ。このイメージの内容は、mkinicpio の [[#設定]] で指定されたディレクティブに従って生成されます。
# ''fallback'' RAM ディスクイメージ。作成時に ''autodetect'' フックがスキップされることを除いて上記と同じであるため、ほとんどのシステムをサポートするすべてのモジュールが含まれます。

プリセットを作成した後、pacman フックは、プリセットで提供された情報を使用して2つのイメージを生成する ''mkinitcpio'' スクリプトを呼び出します。

{{Note|''.preset'' ファイルは、カーネルの更新後に initramfs を自動的に再生成するために使用されます。編集するときは注意してください。}}

=== 手動生成 ===

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

# mkinitcpio -p linux

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

# mkinitcpio -P

ユーザーは、さまざまな構成で initramfs イメージをいくつでも作成できます。生成したいイメージは、それぞれの[[ブートローダー]]の設定ファイルで指定する必要があります。

=== 生成のカスタマイズ ===

ユーザーは、代替の設定ファイルを使用してイメージを生成できます。次の例では、{{ic|/etc/mkinitcpio-custom.conf}} に記述されている指示に従って初期 RAM ディスクイメージを生成し、{{ic|/boot/initramfs-custom.img}} として保存します。

# mkinitcpio --config /etc/mkinitcpio-custom.conf --generate /boot/initramfs-custom.img

現在実行中のカーネル以外のカーネルのイメージを生成する場合は、カーネルリリースバージョンをコマンドラインに追加してください。インストールされているカーネルリリースは {{ic|/usr/lib/modules/}} にあり、構文は各カーネルのコマンド {{ic|uname -r}} の出力と一致しています。

# mkinitcpio --generate /boot/initramfs-custom2.img --kernel 5.7.12-arch1-1

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

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

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

== 設定 ==

''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|VARIABLES}} を見てください):

; {{ic|MODULES}}: ブートフックが実行される前にロードされるカーネルモジュール。
; {{ic|BINARIES}}: initramfs イメージに含める追加のバイナリ。
; {{ic|FILES}}: initramfs イメージに含める追加のファイル。
; {{ic|HOOKS}}: フックは初期 RAM ディスクで実行するスクリプトです。
; {{ic|COMPRESSION}}: initramfs イメージを圧縮する際に使用されます。
; {{ic|COMPRESSION_OPTIONS}}: {{ic|COMPRESSION}} のプログラムに渡す追加の引数。この設定の使用は推奨されません。''mkinitcpio'' は圧縮プログラムに対する特殊な要件を処理するため (例: xz には {{ic|1=--check=crc32}} を指定します)、誤って利用するとシステムが起動できなくなる可能性があります。
; {{ic|MODULES_DECOMPRESS}}: ロード可能なカーネルモジュールとファームウェアのファイルを解凍しておくか、もとの圧縮した状態のままにしておくかを設定します。

{{Note|
* システムが必要とする場合があるフックのいくつか ('''lvm2'''、'''mdadm_udev'''、'''encrypt''' など) は、デフォルトで有効化されて'''いません'''。これに関する指示は [[#HOOKS]] セクションを注意深く読んでください。
* バージョン 36 より前の ''mkinitcpio'' によって作成されたプリセットファイルでは、{{ic|ALL_config}} 変数が定義されており、この変数が存在しているとドロップインの設定ファイルが読み込まれません。ドロップインファイルを有効化するには、古いプリセットファイルにある {{ic|1=ALL_config="/etc/mkinitcpio.conf"}} 行をコメントアウトしてください。
}}

=== MODULES ===

{{ic|MODULES}} 配列では、何か他のことが行われる前にロードするモジュールを指定します。

モジュールの後ろに {{ic|?}} を付けると、モジュールが見つからなかったときでもエラーを投げません。これは、フックや設定ファイルにリストアップされたモジュールを含んでコンパイルするカスタムカーネルで有益かもしれません。

{{Note|
* Out-of-tree のファイルシステムを初期ユーザー空間でマウントするつもりであるならば (例えば、そのようなファイルシステムをルートファイルシステムとしてを使用する場合)、そのファイルシステムのモジュール ({{ic|reiser4}} など) を {{ic|MODULES}} 配列に'''追加しておかなければなりません'''。
* '''encrypt''' や '''sd-encrypt''' を使用し、かつ ''mkinitcpio'' が実行されるシステムと生成されたイメージが使用されるシステムが異なる場合、システムの起動中に LUKS デバイスをアンロックするために必要なキーボードモジュールやファイルシステムを {{ic|MODULES}} 配列に追加する必要があります。例えば、使用するキーファイルが ext2 ファイルシステム上にあるが、''mkinitcpio'' が実行されたときには ext2 ファイルシステムがマウントされていなかった場合、{{ic|ext2}} を追加してください。詳細は [[Dm-crypt/システム設定#cryptkey]] を見てください。
* LUKS デバイスをアンロックするために USB 3 ハブのキーボードを使いたい場合、{{ic|usbhid xhci_hcd}} を追加してください。
* ドッキングステーションに接続されているディスプレイを使用する場合、initrd の出力を見えるようにするためにあなたのグラフィックカードのモジュールを追加する必要があるかもしれません (例: ほとんどの Intel カードでは {{ic|i915}})。
}}

=== BINARIES と FILES ===

以下のオプションを使ってイメージにファイルを追加することができます。{{ic|BINARIES}} と {{ic|FILES}} はフックが実行される前に追加され、フックによって使用/提供されるファイルを上書きすることがあります。{{ic|BINARIES}} は標準の {{ic|PATH}} に自動で配置され、依存関係がパースされます。つまり必要なライブラリも全て追加されます。{{ic|FILES}} は''そのままの状態で''追加されます。例:

FILES=(/etc/modprobe.d/modprobe.conf)

BINARIES=(kexec)

{{ic|BINARIES}} と {{ic|FILES}} は両方とも [[Bash]] 配列です。なので、スペースで区切ることで複数のエントリを追加することができます。

=== HOOKS ===

{{ic|HOOKS}} 配列は設定ファイルの中で一番重要な設定です。フックはイメージに追加されるものを記述する小さなスクリプトです。フックによっては、デーモンを起動したりスタックしたブロックデバイスを集めたりするためのランタイムコンポーネントを含んでいるものもあります。フックは名前によって参照され、設定ファイルの {{ic|HOOKS}} にある順番通りに実行されます。

ほとんどのシンプルな単一ディスク環境では、デフォルトの {{ic|HOOKS}} 設定で十分なはずです。[[LVM]]、[[RAID]]、[[dm-crypt]] などのスタックルートデバイスやマルチブロックデバイスを使う時は、関連する wiki ページを見て必要な設定を調べて下さい。

==== ビルドフック ====

ビルドフックは {{ic|/usr/lib/initcpio/install/}} にあります。カスタムビルドフックは {{ic|/etc/initcpio/install/}} に配置します。これらのファイルは ''mkinitcpio'' の実行時に bash シェルによって実行されます。ビルドフックには２つの関数が含まれています: {{ic|build}} と {{ic|help}}。{{ic|build}} 関数にはイメージに追加するモジュール、ファイル、バイナリを記述します。これらのアイテムの追加を容易にする {{man|8|mkinitcpio}} による API が用意されています。{{ic|help}} 関数はフックの役割を出力します。

すべてのフックを一覧するには:

$ mkinitcpio -L

特定のフックのヘルプを出力するには ''mkinitcpio'' の {{ic|-H}}/{{ic|--hookhelp}} オプションを使って下さい、例えば:

$ mkinitcpio -H udev

==== ランタイムフック ====

ランタイムフックは {{ic|/usr/lib/initcpio/hooks/}} にあります。カスタムランタイムフックは {{ic|/etc/initcpio/hooks/}} に配置します。全てのランタイムフックには同じ名前のビルドフックが存在している必要があり、そのビルドフックは {{ic|add_runscript}} をコールしてランタイムフックをイメージに追加します。これらのファイルは初期ユーザ空間で busybox の ash シェルによって実行されます。cleanup フックを除いて全てのフックは {{ic|HOOKS}} 設定の順番で実行されます。ランタイムフックには複数の関数を含めることができます:

{{ic|run_earlyhook}}: API ファイルシステムがマウントされカーネルコマンドラインがパースされたときに、この名前の関数が実行されます。一般的に udev など初期ユーザ空間が始まったときに必要になる追加のデーモンはこの関数に置きます。

{{ic|run_hook}}: 初期のフックの後すぐに、この名前の関数が実行されます。一番一般的なフックポイントで、スタックブロックデバイスのアセンブリなどのオペレーションはここで行なって下さい。

{{ic|run_latehook}}: root デバイスがマウントされた後、この名前の関数が実行されます。root デバイスの後のセットアップや {{ic|/usr}} など他のファイルシステムのマウントなどに控えめに使われます。

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

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

==== 通常のフック ====

以下は、通常のフックとイメージ生成への影響と関連するランタイムを示した表です。パッケージにカスタムフックを入れることができるので、この表は完全ではないことに注意してください。

{| class="wikitable"
! busybox init !! systemd init !! [[#ビルドフック|ビルドフック]] !! [[#ランタイムフック|ランタイムフック]] (busybox init のみ)
|-
| {{C|'''base'''}} || {{Grey|''任意''}} || 全ての初期ディレクトリをセットアップし、基本のユーティリティとライブラリをインストールします。'''systemd''' フックを使用していない場合、このフックは重要な busybox init を提供するので、何をしようとしているか理解していない限りはこのフックを常に1番最初に置いてください。 '''systemd''' フックを使用する場合、'''base''' フックは busybox のリカバリシェルを提供するだけなので、'''base''' の追加は任意となります。{{Note|initramfs の root アカウントが[https://gitlab.archlinux.org/archlinux/packaging/packages/systemd/-/commit/292cdf8a2f7dd7c6c7d91d2b59617391935c837c ロックされている]ため、リカバリシェルは使用できません。{{Bug|70408}}  を見てください。}}
| {{-}}
|-
| {{C|'''udev'''}} ||rowspan="3" {{C|'''systemd'''}} || イメージに udevd, udevadm, そして udev ルールの小さなサブセットを追加します。 || udev デーモンを起動して、カーネルからの uevent を処理します; デバイスノードを作成します。ブートプロセスの単純化として、必要なモジュールを明示的に指定する必要をなくすため、udev フックの使用が推奨されています。
|-
| {{C|'''usr'''}} || {{ic|/usr}} の分割パーティションのサポートを追加します。詳細は [[#/usr を別のパーティションに分割する]] を見てください。 || 本物のルートファイルシステムがマウントされた後に {{ic|/usr}} パーティションをマウントします。
|-
|-
| {{C|'''resume'''}} || ハイバネートイメージにカーネルのコンパイル時デフォルト以外の圧縮アルゴリズムを使用する際に復帰できるようにするために、{{ic|lzo}} と {{ic|lz4}} カーネルモジュールを (initramfs に) 追加します。{{ic|HibernateLocation}} UEFI 変数で指定されたハイバネートイメージから復帰できるようにするために {{man|8|systemd-hibernate-resume}} バイナリを追加します。|| "ハイバネート" (suspend to disk) 状態からの復帰を試みます。詳しい設定方法は [[ハイバネート]] を見てください。
|-
| {{C|'''btrfs'''}} || {{Grey|–}} || [[Btrfs]] を有効にして、Btrfs でフォーマットされた複数のデバイスを使用するために必要なモジュールを設定します。このフックを使うには、{{Pkg|btrfs-progs}} をインストールする必要があります。単一のデバイスで Btrfs を使うだけならこのフックは不要であり、{{ic|filesystems}} フックで十分です。 || udev フックが存在しないときに {{ic|btrfs device scan}} を実行してマルチデバイスの Btrfs root ファイルシステムを構築します。このフックを使うには {{Pkg|btrfs-progs}} パッケージが必要です。
|-
|colspan="2" {{C|'''autodetect'''}} || sysfs のスキャンによってモジュールのホワイトリストを作成して initramfs を小さくします。含まれているモジュールが正しく、欠けているものがないか確認してください。自動検知の利点を活かすためにこのフックは他の subsystem フックより前に実行してください。'autodetect' より前に置かれたフックは完全にインストールされます。 || {{-}}
|-
|colspan="2" {{C|'''microcode'''}} || Intel 及び AMD プロセッサ向けの[[マイクロコード]]早期アップデートファイルを未圧縮 initramfs イメージの先頭に埋め込みます。これは、利用可能であれば {{ic|/usr/lib/firmware/amd-ucode/}} と {{ic|/usr/lib/firmware/intel-ucode/}} にあるマイクロコードファイルを使用します。これらのファイルが利用できない場合は、{{ic|/boot/amd-ucode.img}} と {{ic|/boot/intel-ucode.img}} を展開して使用します。 '''autodetect''' フックがこのフックより前に実行される場合、イメージをビルドする際に使用したシステムに搭載されているプロセッサ向けのマイクロコードの早期アップデートファイルのみが追加されます。 このフックは、非推奨となっている {{ic|--microcode}} フラグと、プリセットファイルの {{ic|microcode}} オプションの機能を置き換えるものです。また、このフックによって、メインの initramfs イメージにマイクロコードのアップデートが埋め込まれるようになるため、マイクロコードを読み込む {{ic|initrd}} 行をブートローダーの設定に追加する必要が無くなります。 || {{-}}
|-
|colspan="2" {{C|'''modconf'''}} || {{ic|/etc/modprobe.d/}} と {{ic|/usr/lib/modprobe.d/}} から modprobe 設定ファイルをロードします。 || {{-}}
|-
|colspan="2" {{C|'''kms'''}} || [[カーネルモード設定#設定|KMS の早期開始]] を提供する GPU モジュールを追加します。加えて、一部のノート PC の LCD パネルに組み込まれているプライバシースクリーンに必要なモジュールも追加します。|| {{-}}
|-
|colspan="2" {{C|'''keyboard'''}} || キーボードデバイスに必要なモジュールを追加します。あなたが USB キーボードを使っていて、それを初期ユーザ空間で使う必要があるとき (暗号化のパスフレーズを入力したりインタラクティブシェルを使う場合) はこのフックを使って下さい。副作用としてキーボード以外の入力デバイス用のモジュールが追加されることがありますが、困ることはないはずです。

{{Note|異なるハードウェア構成で起動されるシステム(たとえば、外部キーボードと内部キーボードを備えたラップトップまたは [[Wikipedia:Headless computer|ヘッドレスシステム]]) の場合、起動時にキーボードを利用できるようにするために (例えば、{{ic|encrypt}} フックが使用されている場合に暗号化済みデバイスをアンロックするために)、このフックを '''autodetect''' の前に配置する必要があります。}}

| {{-}}
|-
| {{C|'''keymap'''}} ||rowspan="2" {{C|'''sd-vconsole'''}} || {{ic|/etc/vconsole.conf}} から initramfs に、指定した[[コンソールでのキーボード設定#永続的な設定|コンソールキーマップ]]を追加します。[[Dm-crypt/システム全体の暗号化|システム暗号化]]を使用する場合 (特にフルディスク暗号化) 、{{ic|1=encrypt}} フックよりも前に追加するようにしてください。 || 初期ユーザ空間で {{ic|/etc/vconsole.conf}} から指定されたキーマップをロードします。
|-
| {{C|'''consolefont'''}} || {{ic|/etc/vconsole.conf}} から initramfs に、指定した[[コンソールでのキーボード設定#永続的な設定|コンソールフォント]]を追加します。 || 初期ユーザ空間で {{ic|/etc/vconsole.conf}} から指定されたコンソールフォントをロードします。
|-
|colspan="2" {{C|'''block'''}} || ブロックデバイスのモジュールを追加します。'''autodetect''' フックがこのフックより前に実行される場合、このフックはシステム上で使用されているブロックデバイスのモジュールのみを追加します。例外は {{ic|ahci}}、{{ic|sd_mod}}、{{ic|usb_storage}}、{{ic|uas}}、{{ic|mmc_block}}、{{ic|nvme}}、{{ic|virtio_scsi}}、{{ic|virtio_blk}} モジュールで、これらは無条件に必ず追加されます。 || {{-}}
|-
| {{C|'''net'''}} || {{Grey|''未実装''}} || ネットワークデバイスに必要なモジュールを追加します。このフックを使うには {{Pkg|mkinitcpio-nfs-utils}} をインストールしなければなりません。詳細は [[#net を使う]] を見てください。 || NFS の root ファイルシステムの管理を提供します。
|-
| {{C|'''dmraid'''}} || {{Grey|''?''}} || fakeRAID root デバイスのサポートを提供します。これを使うには {{Pkg|dmraid}} をインストールする必要があります。コントローラがサポートしている場合、fakeRAID では ''mdadm_udev'' フックと一緒に [[mdadm]] を使うことが推奨されます。詳細は [[#RAID を使う]] を見てください。 || {{ic|dmraid}} を使用して fakeRAID ブロックデバイスを検索・構築します。
|-
|colspan="2" {{C|'''mdadm_udev'''}} || udev を使って RAID アレイの構築をサポートします。このフックを使うには {{Pkg|mdadm}} をインストールする必要があります。詳細は [[RAID#mkinitcpio を設定する]] を見てください。 || {{-}}
|-
| {{C|'''encrypt'''}} || {{C|'''sd-encrypt'''}} || {{ic|dm_crypt}} カーネルモジュールと {{ic|cryptsetup}} ツールをイメージに追加します。これを使うには {{Pkg|cryptsetup}} をインストールする必要があります。{{Note|暗号化されたデバイスを起動時にアンロックするための ''keyboard'' フックの注意書きや、ファイルをアンロックする際はファイルシステムについての [[#MODULES]] にある注意書きを見てください。}} || 暗号化された root パーティションを検知してアンロックします。設定については [[#ランタイムのカスタマイズ]] を見て下さい。
'''sd-encrypt''' については [[Dm-crypt/システム設定#sd-encrypt フックを使う]]を見てください。
|-
|colspan="2" {{C|'''lvm2'''}} || device mapper カーネルモジュールと {{ic|lvm}} ツールをイメージに追加します。これを使うには {{Pkg|lvm2}} をインストールする必要があります。ルートファイルシステムを [[LVM]] 上に置いている場合、このフックは必須です。 || {{-}}
|-
|colspan="2" {{C|'''filesystems'''}} || イメージに必要なファイルシステムモジュールを含めます。ファイルシステムモジュールを {{ic|MODULES}} で指定していない限りこのフックが'''必要'''になります。 || {{-}}
|-
|colspan="2" {{C|'''fsck'''}} || fsck バイナリとファイルシステム固有のヘルパーを追加し、マウント前にルードデバイスに対して fsck を実行できるようにします。'''autodetect''' フックの後ろにこのフックを追加した場合、root ファイルシステムのヘルパーだけが追加されます。このフックの使用は'''強く'''推奨されており、{{ic|/usr}} パーティションを分割する場合は必須です。このフックを含める場合、初期ユーザ空間でキーボードが動作することを保証するために必要なモジュールも追加することを強く推奨します。 このフックを使用するには、[[カーネルコマンドライン]]にパラメータ {{ic|rw}} を設定する必要があります ([https://bbs.archlinux.org/viewtopic.php?pid=1307895#p1307895 議論])。詳細は [[fsck#ブート時のチェック]] を見てください。 || {{-}}
|-
|colspan="2" {{C|'''acpi_override'''}} || {{ic|/usr/initcpio/acpi_override/}} と {{ic|/etc/initcpio/acpi_override/}} ディレクトリ内にある ACPI Machine Language (''.aml'') ファイルを未圧縮早期 initramfs イメージに追加します。そうすることで、カーネルがブートの非常に早い段階で ACPI テーブル (例えば [[DSDT]]) をオーバーライドできるようにします。[https://docs.kernel.org/admin-guide/acpi/initrd_table_override.html] || {{-}}
|}

==== ポストフック ====

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

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

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

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

=== COMPRESSION ===

カーネルは、initramfs の圧縮にいくつかの形式をサポートしています: {{Pkg|gzip}}、{{Pkg|bzip2}}、lzma ({{Pkg|xz}})、{{Pkg|xz}}、lzo ({{Pkg|lzop}})、{{Pkg|lz4}}、{{Pkg|zstd}}。mkinitcpio はデフォルトで zstd 圧縮イメージを使用します。mkinitcpio はデフォルトで、カーネル 5.9 及びそれ以降に対しては zstd 圧縮を、5.9 より前のカーネルバージョンに対しては gzip を使用します。

提供されている {{ic|mkinitcpio.conf}} には、さまざまな {{ic|COMPRESSION}} オプションがコメントアウトされています。別の圧縮方法に切り替える場合は、コメントを解除し、対応する圧縮ユーティリティがインストールされていることを確認してください。何も指定しない場合は、デフォルトのメソッドが使用されます。非圧縮イメージを作成する場合は、設定ファイルで {{ic|1=COMPRESSION='''cat'''}} を指定するか、コマンドラインで {{ic|-z cat}} を使用します。

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

=== COMPRESSION_OPTIONS ===

{{ic|COMPRESSION}} で指定したプログラムに渡す追加のフラグを記述します、例:

COMPRESSION_OPTIONS=(-9)

このオプションは空のままにしておくことができます。''mkinitcpio'' は、サポートされている圧縮メソッドに、機能するイメージを生成するために必須なフラグを渡すことを保証しています。

{{Warning|このオプションを間違って使用すると、カーネルが生成されたイメージを解凍できない場合、''システムが起動不能になる''場合があります。}}

デフォルトの zstd 圧縮では、カスタムカーネルのスペースを節約するために (特に[[デュアルブート]]環境で、EFI システムパーティションを {{ic|/boot}} として使用する場合)、{{ic|--long}} オプションは非常に効果的です。ただし、RAM の限られたシステムは、このオプションをした場合に initramfs を解凍できない場合があります。また、{{ic|-v}} オプションは、initramfs の生成中に詳細を見たい場合に必要になるかもしれません。例:

COMPRESSION="zstd"
COMPRESSION_OPTIONS=(-v -5 --long)

xz で圧縮レベル {{ic|-9e}} を使用し、ローダブルなカーネルモジュールとファームウェアを解凍しておくことで、圧縮速度が最も遅くなりますが、圧縮率を最大に高めることができます:

COMPRESSION="xz"
COMPRESSION_OPTIONS=(-9e)
MODULES_DECOMPRESS="yes"

=== MODULES_DECOMPRESS ===

{{ic|MODULES_DECOMPRESS}} は、initramfs の作成時にカーネルモジュールとファームウェアのファイルを解凍しておくかを決めます。デフォルトは {{ic|no}} です。

Arch では[[カーネルモジュール]]と {{Pkg|linux-firmware}} を zstd でレベル 19 で圧縮しています。Initramfs でより高い圧縮率を使用する場合、{{ic|1=MODULES_DECOMPRESS="yes"}} を設定することで、initramfs のサイズをさらに小さくすることができます。しかし、カーネルが個々のモジュールとファームウェアをロード時に解凍する場合よりも、initramfs イメージ全体を解凍するのにより多くの時間が掛かるようになるため、ブートの初期段階で RAM と CPU の使用率を増加させ、RAM 容量が限られていて CPU の性能が低いシステムで悪影響を及ぼします。

{{Tip|Initramfs の生成プロセスの終わりあたりになると、二重圧縮を防ぐために、残りの ''.bz2''、''.gz''、''.lz4''、''.lzma''、''.lzo''、''.xz''、''.zst'' ファイルは全て未圧縮早期 initramfs イメージに移動されます。}}

== ランタイムのカスタマイズ ==

ランタイム設定オプションはカーネルコマンドラインを通して {{ic|init}} や特定のフックに渡すことができます。カーネルコマンドラインパラメータはブートローダによって与えられることがほとんどです。下で書かれているオプションをカーネルコマンドラインに追加することでデフォルトの挙動を変えることができます。詳しくは [[カーネルパラメータ]] や [[Arch ブートプロセス]] を見て下さい。

=== base フックの init ===

; {{ic|1=root=}}: カーネルコマンドラインで指定する一番重要なパラメータであり、どのデバイスを root デバイスとしてマウントするかを決めます。''mkinitcpio'' は柔軟に様々な形式を使うことができるようになっています。形式の例は [[永続的なブロックデバイスの命名#カーネルパラメータ]] を見てください。

{{Note|以下のブートパラメーターは initramfs 環境における {{ic|init}} のデフォルトの挙動を変更します。詳しくは {{ic|/usr/lib/initcpio/init}} を参照。{{ic|systemd}} フックが使われている場合 {{ic|base}} フックの {{ic|init}} は置き換わるため機能しません。}}

; {{ic|break}}: {{ic|break}} や {{ic|1=break=premount}} が指定された場合、(フックをロードした後、root ファイルシステムをマウントする前に) {{ic|init}} はブートプロセスを停止してトラブルシューティングに使うことができるインタラクティブシェルを起動します。{{ic|1=break=postmount}} と指定することで root がマウントされた後にこのシェルを起動することもできます。シェルを終了すると通常通りに起動が行われます。

; {{ic|1=disablehooks=}}: {{ic|1=disablehooks=hook1[,hook2,...]}} を追加すると実行時にフックを無効化します。例: {{bc|1=disablehooks=resume}}

; {{ic|1=earlymodules=}}: {{ic|1=earlymodules=mod1[,mod2,...]}} という風に先にロードするモジュールを指定することでモジュールがロードされる順番を変更することができます (例えば、複数のネットワークインターフェイスの順番を適切に確定したいときなどに使います)。

他のパラメータについては [[ブートデバッグ]] や {{man|8|mkinitcpio}} を見て下さい。

=== RAID を使う ===

[[RAID#mkinitcpio の設定]] を見てください。

=== net を使う ===

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

'''必要なパッケージ'''

{{ic|net}} は {{Pkg|mkinitcpio-nfs-utils}} パッケージを必要とします。

'''カーネルパラメータ'''

公式の[https://docs.kernel.org/admin-guide/nfs/nfsroot.html カーネルドキュメント]に包括的で最新の情報が載っています。

'''ip='''

このパラメータはカーネルに、デバイスの IP アドレスの設定方法と、IP ルーティングテーブルの設定方法を指定します。コロンで区切った9つまでの引数を指定できます: {{ic|1=ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>:<dns0-ip>:<dns1-ip>:<ntp0-ip>}}。

カーネルコマンドラインにこのパラメータが存在しなかった場合、全てのフィールドが空とされて、[https://docs.kernel.org/admin-guide/nfs/nfsroot.html カーネルドキュメント]に書かれているデフォルト設定が適用されます。一般的にはカーネルは自動設定を使って全てを設定しようとします。

{{ic|<autoconf>}} パラメータは {{ic|ip}} パラメータの唯一の値として指定できます (前の全ての {{ic|:}} 文字を排除)。値が {{ic|1=ip=off}} や {{ic|1=ip=none}} の場合、自動設定は行われません。そうでないなら、自動的に設定されます。最も一般的な使い方は {{ic|1=ip=dhcp}} です。

パラメータの説明は、[https://docs.kernel.org/admin-guide/nfs/nfsroot.html カーネルドキュメント]を参照してください。

例:

ip=127.0.0.1:::::lo:none --> ループバックインターフェイスを有効化。
ip=192.168.1.1:::::eth2:none --> 静的 eth2 インターフェイスを有効化。
ip=:::::eth0:dhcp --> eth0 構成に対して dhcp プロトコルを有効化。

{{Note|{{ic|<device>}} パラメータにはカーネルのデバイス名を使用してください (例: {{ic|eth0}})、永続的な名前のデバイス名 (例: {{ic|enp2s0}}) では動作しません。詳細は [[ネットワーク設定#ネットワークインターフェイス]] を見てください。}}

'''BOOTIF='''

複数のネットワークカードを使っているときは、このパラメータに起動するインターフェイスの MAC アドレスを含めることができます。インターフェイスの数字が変わってしまったり、pxelinux の IPAPPEND 2 や IPAPPEND 3 オプションを使うときに便利です。指定しなかった場合、{{ic|eth0}} が使われます。

例:

BOOTIF=01-A1-B2-C3-D4-E5-F6 # 先頭の "01-" と大文字に注意

'''nfsroot='''

{{ic|nfsroot}} パラメータがコマンドラインで指定されなかった場合、デフォルトで {{ic|/tftpboot/%s}} が使われます。

nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]

パラメータの説明を見るには {{ic|mkinitcpio -H net}} を実行してください。

=== LVM を使う ===

root デバイスを [[LVM]] 上に置く場合は、[[LVM に Arch Linux をインストールする#mkinitcpio フックを追加する]] を見てください。

=== 暗号化されたルートを使う ===

[[Dm-crypt/システム全体の暗号化|root を暗号化]]している場合、どのフックを含めるべきかに関する詳細な情報は [[Dm-crypt/システム設定#mkinitcpio]] を見て下さい。

=== /usr を別のパーティションに分割する ===

{{ic|/usr}} のパーティションを別にする場合、以下を行う必要があります:

* 起動時にこのパーティションのチェックを実行するために、{{ic|fsck}} フックを追加して、{{ic|/etc/fstab}} で {{ic|/usr}} の {{ic|passno}} を {{ic|2}} にする。起動時に {{ic|/usr}} を fsck したい場合は必須です (これはすべてのユーザに推奨されます)。このフックが存在しないと、{{ic|/usr}} は永遠に fsck されません。
* 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 インストールメディア|インストールメディア]]を作成しておいてください。}}

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

=== イメージの展開 ===

initramfs イメージの中に何が入っているか気になるときは、イメージを展開して中に入っているファイルを調べることができます。

initramfs イメージは SVR4 CPIO アーカイブであり、{{ic|find}} と {{ic|bsdcpio}} コマンドによって生成されています。また、任意で、カーネルが対応した圧縮方法によって圧縮されています。圧縮方法について詳しくは [[#COMPRESSION]] を見て下さい。

''mkinitcpio'' には {{man|1|lsinitcpio}} というユーティリティが含まれており initramfs イメージの中身を一覧・展開することができます。

イメージ内のファイルを一覧するには:

# lsinitcpio /boot/initramfs-linux.img

カレントディレクトリにファイルを全て展開するには:

# lsinitcpio -x /boot/initramfs-linux.img

イメージの重要なパーツについて読みやすいリストを取得することもできます:

# lsinitcpio -a /boot/initramfs-linux.img

=== 展開して修正を加えたイメージの再圧縮 ===

{{ic|/usr/bin/mkinitcpio}} スクリプトの {{ic|build_image}} 関数を以下のパラメータで実行してください:

build_image ''出力ファイル'' ''圧縮方式''

{{ic|build_image}} 関数の内容で新しいスクリプトを作成することでこれを実行できます。
これはカレントディレクトリ内の内容を {{ic|''出力ファイル''}} というファイルに圧縮します。

{{Warning|上書きするまえに自動生成された {{ic|/boot/initramfs-linux.img}} の名前を変更することで、簡単に元に戻すことができるようになります。何か問題が発生して起動できなくなった場合、fallback イメージやブート CD で起動して、{{ic|mkinitcpio}} を実行して元のイメージに戻してください。あるいは、自分で修正してイメージを再圧縮してください。}}

=== マウントされているのに "/dev must be mounted" と表示される ===

{{ic|/dev}} がマウントされているかどうか確認するために mkinitcpio は {{ic|/dev/fd/}} が存在するかどうかを確かめます。問題がないようでしたら、手動で作成することができます:

# ln -s /proc/self/fd /dev/

(当然 {{ic|/proc}} のマウントも必要です。''mkinitcpio'' によって次にチェックされます。)

=== Possibly missing firmware for module XXXX ===

カーネルのアップデート後に initramfs を再生成する際、以下のような警告が表示されることがあります:

==> WARNING: Possibly missing firmware for module: '<nowiki/>''module_name''<nowiki/>'

''default'' initramfs イメージを生成するときに同じようなメッセージが表示される場合、警告メッセージが言っている通り、追加のファームウェアをインストールする必要があるかもしれません。ほとんどの一般的なファームウェアファイルは {{Pkg|linux-firmware}} パッケージを[[インストール]]することで入手できます。ファームウェアを提供する他のパッケージについては、以下の表を見るか、[[公式リポジトリ]]や [[AUR]] でモジュール名を検索してみてください。

メッセージが ''fallback'' initramfs イメージの生成時にのみ表示される場合は、以下の2つの選択肢があります:

* 影響を受けるハードウェアを使用しないことがわかっている場合は、警告を安全に無視できます。
* 警告を抑制したい場合、不足しているファームウェアをインストールできます。メタパッケージ {{AUR|mkinitcpio-firmware}} には、ほどんどのオプションのファームウェアが含まれています。あるいは、手動で必要なパッケージをインストールしてください:
:{| class="wikitable"
|-
! モジュール !! パッケージ
|-
| aic94xx || {{AUR|aic94xx-firmware}}
|-
| ast || {{AUR|ast-firmware}}
|-
| bfa || {{Pkg|linux-firmware-qlogic}}
|-
| bnx2x || {{Pkg|linux-firmware-bnx2x}}
|-
| liquidio || {{Pkg|linux-firmware-liquidio}}
|-
| mlxsw_spectrum || {{Pkg|linux-firmware-mellanox}}
|-
| 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}}
|-
| qla1280 || {{Pkg|linux-firmware-qlogic}}
|-
| qla2xxx || {{Pkg|linux-firmware-qlogic}}
|-
| wd719x || {{AUR|wd719x-firmware}}
|-
| xhci_pci || {{AUR|upd72020x-fw}}
|}
* 警告を取り除きたいが、必要ないファームウェアパッケージのためにシステムの空き領域を無駄にしたくない場合、[[#フォールバック initramfs の生成を無効化する|フォールバック initramfs の生成を無効化する]]ことができます。

利用できないファームウェアに関しては、ダミーのファイルを作成することで警告を消すことができます。例えば:

# echo "Device not available" > /usr/lib/firmware/qat_420xx.bin
# echo "Device not available" > /usr/lib/firmware/qat_420xx_mmp.bin

=== No PS/2 controller found ===

一部のマザーボードで (ほとんどの場合、古いもの。しかし、一部の新しいものでも起こります)、i8042 コントローラが自動検出できません。稀なケースですが、キーボードが使えなくなってしまうことがあります。この状況を事前に察知することができます。PS/2 ポートがあり、{{ic|i8042: PNP: No PS/2 controller found. Probing ports directly}} というメッセージが表示される場合、{{ic|MODULES}} 配列に {{ic|atkbd}} を追加してください。[https://archlinux.org/news/linux-313-warning-ps2-keyboard-support-is-now-modular/]

=== 標準的なレスキュー手順 ===

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

==== あるマシンでは起動できるが他のマシンでは起動できない ====

''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|手動]]で追加します。

== 参照 ==

* Linux カーネルドキュメント [https://docs.kernel.org/filesystems/ramfs-rootfs-initramfs.html#what-is-rootfs initramfs, "What is rootfs?"]
* Linux カーネルドキュメント [https://docs.kernel.org/admin-guide/initrd.html initrd]
* Wikipedia 記事 [[wikipedia:ja:initrd|initrd]]

{{TranslationStatus|mkinitcpio|2024-12-27|823193}}

Lenovo ThinkPad T14/T14s (Intel) Gen 4

2025-09-02T04:33:43Z

Kgx: 無駄な改行を削除

[[Category:Lenovo]]
[[en:Lenovo ThinkPad T14/T14s (Intel) Gen 4]]
{| class="wikitable" style="float: right;"
|-
! ハードウェア !! PCI/USB ID !! 動作状況
|-
| タッチパッド || {{ic|04F3:3195}} || {{Yes}}
|-
| トラックポイント || {{ic|04F3:2EA3}} || {{Yes}}
|-
| GPU (Intel) || {{ic|8086:a7a1}} || {{Yes}}
|-
| Web カメラ || {{ic|04f2:b74f}} || {{Yes}}
|-
| Bluetooth || {{ic|8087:0033}} || {{Yes}}
|-
| オーディオ || {{ic|8086:51ca}} || {{Yes}}
|-
| Wi-Fi || {{ic|8086:51f1}} || {{Yes}}
|-
| Ethernet || {{ic|8086:0dc6}} || {{Yes}}
|-
| モバイルブロードバンド || || {{Y|未テスト}}
|-
| 指紋認証リーダー || || {{Yes}}
|-
| スマートカードリーダー || || {{Y|未テスト}}
|}
Lenovo ThinkPad T14/T14s (Intel) Gen 4 は 2023年5月に登場した。14インチディスプレイ、第13世代 Intel Core プロセッサ、統合型 Intel Iris Xe グラフィックスを搭載している。カーネル >=6.11.6 でほぼすべての機能がそのまま動作します。

この機種であることを確認するには、{{Pkg|dmidecode}} をインストールし、以下を実行して下さい:

{{hc|# dmidecode -s system-version|ThinkPad T14 Gen 4}}

ノートパソコン関連記事と推奨事項の概要は [[ノートパソコン]] を参照。

== インストール ==

=== Intel Turbo Boost Max ===

Intel® Turbo Boost Max Technology 3.0 が有効になっているか確認する:

$ cat /sys/devices/system/cpu/intel_pstate/no_turbo

出力が `1` の場合は無効になっているので、BIOS をデフォルトにリセットする必要があります。リセット後に再度コマンドを実行すると `0` が出力されるはずです。
その後、CPU が高クロックまでブーストしているのを確認できます。

=== サウンド ===

この機種の内蔵サウンドカードは [https://wiki.archlinux.org/title/Advanced_Linux_Sound_Architecture#Firmware Sound Open Firmware] が必要です。

== ファームウェア ==

=== fwupd ===

[[fwupd]] は UEFI BIOS、NVMe SSD、Embedded Controller、Intel Management Engine のアップデートをそのままサポートしています。

== ファンクションキー ==

{| class="wikitable"
! Key !! Visible?1 !! Marked?2 !! Effect
|-
| {{ic|Fn+Esc}} || {{No}} || {{Yes}} || Enables Fn lock
|-
| {{ic|Fn}} || {{Yes}} || {{Yes}} || {{ic|XF86WakeUp}}
|-
| {{ic|Fn+F1}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMute}}
|-
| {{ic|Fn+F2}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioLowerVolume}}
|-
| {{ic|Fn+F3}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioRaiseVolume}}
|-
| {{ic|Fn+F4}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMicMute}}
|-
| {{ic|Fn+F5}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessDown}}
|-
| {{ic|Fn+F6}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessUp}}
|-
| {{ic|Fn+F7}} || {{Yes}} || {{Yes}} || {{ic|XF86Display}}
|-
| {{ic|Fn+F8}} || {{Yes}} || {{Yes}} || {{ic|XF86WLAN}}
|-
| {{ic|Fn+F9}} || {{Yes}} || {{Yes}} || {{ic|XF86Messenger}}
|-
| {{ic|Fn+F10}} || {{Yes}} || {{Yes}} || {{ic|XF86Go}}
|-
| {{ic|Fn+F11}} || {{Yes}} || {{Yes}} || {{ic|Cancel}}
|-
| {{ic|Fn+F12}} || {{Yes}} || {{Yes}} || {{ic|XF86Favorites}}
|-
| {{ic|Fn+Space}} || {{No}} || {{Yes}} || Toggle keyboard backlight3
|}

# {{ic|wev}} などのツールでキー入力が可視化できるかどうか。
# キーキャップにその機能を示すシンボルが印字されているかどうか。
# そのまま動作するが、ソフトウェア制御も可能。

== モバイルブロードバンド ==

[[NetworkManager#Mobile broadband support]] を参照。

== 参照 ==

=== T14 リンク ===

* https://ubuntu.com/certified/202303-31392

=== T14s リンク ===

* https://ubuntu.com/certified/202305-31639

Lenovo ThinkPad T14/T14s (Intel) Gen 4

2025-09-02T04:33:13Z

Kgx:

[[Category:Lenovo]]
[[en:Lenovo ThinkPad T14/T14s (Intel) Gen 4]]

{| class="wikitable" style="float: right;"
|-
! ハードウェア !! PCI/USB ID !! 動作状況
|-
| タッチパッド || {{ic|04F3:3195}} || {{Yes}}
|-
| トラックポイント || {{ic|04F3:2EA3}} || {{Yes}}
|-
| GPU (Intel) || {{ic|8086:a7a1}} || {{Yes}}
|-
| Web カメラ || {{ic|04f2:b74f}} || {{Yes}}
|-
| Bluetooth || {{ic|8087:0033}} || {{Yes}}
|-
| オーディオ || {{ic|8086:51ca}} || {{Yes}}
|-
| Wi-Fi || {{ic|8086:51f1}} || {{Yes}}
|-
| Ethernet || {{ic|8086:0dc6}} || {{Yes}}
|-
| モバイルブロードバンド || || {{Y|未テスト}}
|-
| 指紋認証リーダー || || {{Yes}}
|-
| スマートカードリーダー || || {{Y|未テスト}}
|}
Lenovo ThinkPad T14/T14s (Intel) Gen 4 は 2023年5月に登場した。14インチディスプレイ、第13世代 Intel Core プロセッサ、統合型 Intel Iris Xe グラフィックスを搭載している。カーネル >=6.11.6 でほぼすべての機能がそのまま動作します。

この機種であることを確認するには、{{Pkg|dmidecode}} をインストールし、以下を実行して下さい:

{{hc|# dmidecode -s system-version|ThinkPad T14 Gen 4}}

ノートパソコン関連記事と推奨事項の概要は [[ノートパソコン]] を参照。

== インストール ==

=== Intel Turbo Boost Max ===

Intel® Turbo Boost Max Technology 3.0 が有効になっているか確認する:

$ cat /sys/devices/system/cpu/intel_pstate/no_turbo

出力が `1` の場合は無効になっているので、BIOS をデフォルトにリセットする必要があります。リセット後に再度コマンドを実行すると `0` が出力されるはずです。
その後、CPU が高クロックまでブーストしているのを確認できます。

=== サウンド ===

この機種の内蔵サウンドカードは [https://wiki.archlinux.org/title/Advanced_Linux_Sound_Architecture#Firmware Sound Open Firmware] が必要です。

== ファームウェア ==

=== fwupd ===

[[fwupd]] は UEFI BIOS、NVMe SSD、Embedded Controller、Intel Management Engine のアップデートをそのままサポートしています。

== ファンクションキー ==

{| class="wikitable"
! Key !! Visible?1 !! Marked?2 !! Effect
|-
| {{ic|Fn+Esc}} || {{No}} || {{Yes}} || Enables Fn lock
|-
| {{ic|Fn}} || {{Yes}} || {{Yes}} || {{ic|XF86WakeUp}}
|-
| {{ic|Fn+F1}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMute}}
|-
| {{ic|Fn+F2}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioLowerVolume}}
|-
| {{ic|Fn+F3}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioRaiseVolume}}
|-
| {{ic|Fn+F4}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMicMute}}
|-
| {{ic|Fn+F5}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessDown}}
|-
| {{ic|Fn+F6}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessUp}}
|-
| {{ic|Fn+F7}} || {{Yes}} || {{Yes}} || {{ic|XF86Display}}
|-
| {{ic|Fn+F8}} || {{Yes}} || {{Yes}} || {{ic|XF86WLAN}}
|-
| {{ic|Fn+F9}} || {{Yes}} || {{Yes}} || {{ic|XF86Messenger}}
|-
| {{ic|Fn+F10}} || {{Yes}} || {{Yes}} || {{ic|XF86Go}}
|-
| {{ic|Fn+F11}} || {{Yes}} || {{Yes}} || {{ic|Cancel}}
|-
| {{ic|Fn+F12}} || {{Yes}} || {{Yes}} || {{ic|XF86Favorites}}
|-
| {{ic|Fn+Space}} || {{No}} || {{Yes}} || Toggle keyboard backlight3
|}

# {{ic|wev}} などのツールでキー入力が可視化できるかどうか。
# キーキャップにその機能を示すシンボルが印字されているかどうか。
# そのまま動作するが、ソフトウェア制御も可能。

== モバイルブロードバンド ==

[[NetworkManager#Mobile broadband support]] を参照。

== 参照 ==

=== T14 リンク ===

* https://ubuntu.com/certified/202303-31392

=== T14s リンク ===

* https://ubuntu.com/certified/202305-31639

Lenovo ThinkPad T14/T14s (Intel) Gen 4

2025-09-02T04:32:40Z

Kgx:

[[Category:Lenovo]]
[[en:Lenovo ThinkPad T14/T14s (Intel) Gen 4]]

{| class="wikitable" style="float: right;"
|-
! ハードウェア !! PCI/USB ID !! 動作状況
|-
| タッチパッド || {{ic|04F3:3195}} || {{Yes}}
|-
| トラックポイント || {{ic|04F3:2EA3}} || {{Yes}}
|-
| GPU (Intel) || {{ic|8086:a7a1}} || {{Yes}}
|-
| Web カメラ || {{ic|04f2:b74f}} || {{Yes}}
|-
| Bluetooth || {{ic|8087:0033}} || {{Yes}}
|-
| オーディオ || {{ic|8086:51ca}} || {{Yes}}
|-
| Wi-Fi || {{ic|8086:51f1}} || {{Yes}}
|-
| Ethernet || {{ic|8086:0dc6}} || {{Yes}}
|-
| モバイルブロードバンド || || {{Y|未テスト}}
|-
| 指紋認証リーダー || || {{Yes}}
|-
| スマートカードリーダー || || {{Y|未テスト}}
|}

Lenovo ThinkPad T14/T14s (Intel) Gen 4 は 2023年5月に登場した。14インチディスプレイ、第13世代 Intel Core プロセッサ、統合型 Intel Iris Xe グラフィックスを搭載している。カーネル >=6.11.6 でほぼすべての機能がそのまま動作します。

この機種であることを確認するには、{{Pkg|dmidecode}} をインストールし、以下を実行して下さい:

{{hc|# dmidecode -s system-version|ThinkPad T14 Gen 4}}

ノートパソコン関連記事と推奨事項の概要は [[ノートパソコン]] を参照。

== インストール ==

=== Intel Turbo Boost Max ===

Intel® Turbo Boost Max Technology 3.0 が有効になっているか確認する:

$ cat /sys/devices/system/cpu/intel_pstate/no_turbo

出力が `1` の場合は無効になっているので、BIOS をデフォルトにリセットする必要があります。リセット後に再度コマンドを実行すると `0` が出力されるはずです。
その後、CPU が高クロックまでブーストしているのを確認できます。

=== サウンド ===

この機種の内蔵サウンドカードは [https://wiki.archlinux.org/title/Advanced_Linux_Sound_Architecture#Firmware Sound Open Firmware] が必要です。

== ファームウェア ==

=== fwupd ===

[[fwupd]] は UEFI BIOS、NVMe SSD、Embedded Controller、Intel Management Engine のアップデートをそのままサポートしています。

== ファンクションキー ==

{| class="wikitable"
! Key !! Visible?1 !! Marked?2 !! Effect
|-
| {{ic|Fn+Esc}} || {{No}} || {{Yes}} || Enables Fn lock
|-
| {{ic|Fn}} || {{Yes}} || {{Yes}} || {{ic|XF86WakeUp}}
|-
| {{ic|Fn+F1}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMute}}
|-
| {{ic|Fn+F2}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioLowerVolume}}
|-
| {{ic|Fn+F3}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioRaiseVolume}}
|-
| {{ic|Fn+F4}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMicMute}}
|-
| {{ic|Fn+F5}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessDown}}
|-
| {{ic|Fn+F6}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessUp}}
|-
| {{ic|Fn+F7}} || {{Yes}} || {{Yes}} || {{ic|XF86Display}}
|-
| {{ic|Fn+F8}} || {{Yes}} || {{Yes}} || {{ic|XF86WLAN}}
|-
| {{ic|Fn+F9}} || {{Yes}} || {{Yes}} || {{ic|XF86Messenger}}
|-
| {{ic|Fn+F10}} || {{Yes}} || {{Yes}} || {{ic|XF86Go}}
|-
| {{ic|Fn+F11}} || {{Yes}} || {{Yes}} || {{ic|Cancel}}
|-
| {{ic|Fn+F12}} || {{Yes}} || {{Yes}} || {{ic|XF86Favorites}}
|-
| {{ic|Fn+Space}} || {{No}} || {{Yes}} || Toggle keyboard backlight3
|}

# {{ic|wev}} などのツールでキー入力が可視化できるかどうか。
# キーキャップにその機能を示すシンボルが印字されているかどうか。
# そのまま動作するが、ソフトウェア制御も可能。

== モバイルブロードバンド ==

[[NetworkManager#Mobile broadband support]] を参照。

== 参照 ==

=== T14 リンク ===

* https://ubuntu.com/certified/202303-31392

=== T14s リンク ===

* https://ubuntu.com/certified/202305-31639

Linux ファームウェア

2025-09-02T04:27:32Z

Kgx: /* インストール */ リンクを修正

[[Category:ハードウェア]]
[[Category:カーネル]]
[[en:Linux firmware]]
[[ru:Linux firmware]]
[[zh-hans:Linux 固件]]
{{Related articles start}}
{{Related|カーネル}}
{{Related|マイクロコード}}
{{Related|fwupd}}
{{Related articles end}}

[https://gitlab.com/kernel-firmware/linux-firmware#linux-firmware Linux ファームウェア]は、特定のハードウェアデバイスの一部または完全な機能に必要な、[[Wikipedia:Binary blob|バイナリ・ブロブ]]のコレクションであり、[[Wikipedia:Linux kernel|Linux カーネル]]とともに配布されます。これらのバイナリ・ブロブは、[[Wikipedia:GNU General Public License|GPL]] でライセンスされた作品に含めることは許可されていませんが、別の形で再配布することは許可されています。

ファームウェアが必要となる典型的なハードウェアの種類:

* [[Wikipedia:Graphics processing unit|GPU]]
* [[ネットワーク設定/イーサネット|有線]]ネットワークアダプター
* [[ネットワーク設定/ワイヤレス|無線]]ネットワークアダプター
* [[Bluetooth]] コントローラー
* サウンドカード ― [[プロフェッショナルオーディオ]]やオンボードオーディオ

== インストール ==

{{Pkg|linux-firmware}} [[メタパッケージ]]を [[インストール]]することで、[https://gitlab.archlinux.org/archlinux/packaging/packages/linux-firmware/-/blob/main/PKGBUILD?ref_type=heads#L103 よく使われる] すべてのファームウェアを取得できます。これはほとんどのユーザーに推奨される方法です。ディスク容量を節約したい場合は、自身のシステムで使用しているハードウェアベンダー向けのファームウェアのみを選んでインストールすることもできます。

{{Warning|必要なファームウェアがないと、システムが動作しない可能性があります。}}

{{Pkg|linux-firmware}} によってインストールされる主なパッケージ:

* {{Pkg|linux-firmware-amdgpu}} — [[AMD]] Radeon GPU
* {{Pkg|linux-firmware-atheros}} — [[Wikipedia:Atheros|Qualcomm Atheros]] 製 Wi-Fi および Bluetooth アダプター
* {{Pkg|linux-firmware-broadcom}} — [[Broadcom]] および [[Wikipedia:Cypress Semiconductor|Cypress]] 製ネットワークアダプター
* {{Pkg|linux-firmware-cirrus}} — [[Wikipedia:Cirrus Logic|Cirrus Logic]] 製オーディオデバイス
* {{Pkg|linux-firmware-intel}} — [[Intel]] 製オーディオデバイス、Bluetooth アダプター、GPU、ネットワークアダプター、NPU、Web カメラなどの各種デバイス
* {{Pkg|linux-firmware-mediatek}} — [[Wikipedia:MediaTek|MediaTek]] および [[Wikipedia:Ralink|Ralink]] 製ネットワークアダプター
* {{Pkg|linux-firmware-nvidia}} — [[NVIDIA]] 製 GPU および SoC
* {{Pkg|linux-firmware-other}} — その他の未分類デバイス
* {{Pkg|linux-firmware-radeon}} — [[ATI]] Radeon GPU
* {{Pkg|linux-firmware-realtek}} — [[Wikipedia:Realtek|Realtek]] 製ネットワークおよび Bluetooth アダプター

オプションパッケージ:

* {{Pkg|linux-firmware-liquidio}} — [[Wikipedia:Cavium|Cavium]] LiquidIO サーバーアダプター
* {{Pkg|linux-firmware-marvell}} — [[Wikipedia:Marvell Technology|Marvell]] 製ネットワークアダプター
* {{Pkg|linux-firmware-mellanox}} — [[Wikipedia:Mellanox Technologies|Mellanox]] 製 Spectrum スイッチ
* {{Pkg|linux-firmware-nfp}} — [[Wikipedia:Netronome|Netronome]] Flow Processor
* {{Pkg|linux-firmware-qcom}} — [[Wikipedia:Qualcomm|Qualcomm]] 製 SoC
* {{Pkg|linux-firmware-qlogic}} — [[Wikipedia:QLogic|QLogic]] 製ネットワークデバイス

サードパーティ製パッケージ:

* {{Pkg|alsa-firmware}} — {{Pkg|alsa-tools}} に含まれるローダープログラムおよびホットプラグ対応ファームウェアローダー、詳しくは [[ALSA#Firmware]] を参照
* {{Pkg|sane-gt68xx-firmware}} — [http://www.meier-geinitz.de/sane/gt68xx-backend/ gt68xx] ベースのスキャナー用
* {{Pkg|sigrok-firmware-fx2lafw}} — [https://sigrok.org/wiki/Fx2lafw FX2] ロジックアナライザー用
* {{Pkg|sof-firmware}} — [[Advanced Linux Sound Architecture#ファームウェア|Sound Open Firmware]] 用

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

=== 読み込まれたファームウェアの検出 ===

デバッグやインストールすべきファームウェアパッケージを特定するために、システムによってどのファームウェアが読み込まれたかを知りたい場合があります。

これは [https://docs.kernel.org/admin-guide/dynamic-debug-howto.html dynamic debug] を使って確認できます:

* [[カーネルパラメータ]] に {{ic|1=dyndbg="func fw_log_firmware_info +p"}} を追加してください。なお、使用している [[ブートローダー]] によってはクォートをエスケープする必要があります。
* 以下のコマンドで読み込まれたファームウェアを一覧表示できます:
{{bc|# journalctl -kg 'loaded f'}}

== 参照 ==

* [[Gentoo:Linux firmware]]

Linux ファームウェア

2025-09-02T04:26:03Z

Kgx: 他言語へのリンクを追加

[[Category:ハードウェア]]
[[Category:カーネル]]
[[en:Linux firmware]]
[[ru:Linux firmware]]
[[zh-hans:Linux 固件]]
{{Related articles start}}
{{Related|カーネル}}
{{Related|マイクロコード}}
{{Related|fwupd}}
{{Related articles end}}

[https://gitlab.com/kernel-firmware/linux-firmware#linux-firmware Linux ファームウェア]は、特定のハードウェアデバイスの一部または完全な機能に必要な、[[Wikipedia:Binary blob|バイナリ・ブロブ]]のコレクションであり、[[Wikipedia:Linux kernel|Linux カーネル]]とともに配布されます。これらのバイナリ・ブロブは、[[Wikipedia:GNU General Public License|GPL]] でライセンスされた作品に含めることは許可されていませんが、別の形で再配布することは許可されています。

ファームウェアが必要となる典型的なハードウェアの種類:

* [[Wikipedia:Graphics processing unit|GPU]]
* [[ネットワーク設定/イーサネット|有線]]ネットワークアダプター
* [[ネットワーク設定/ワイヤレス|無線]]ネットワークアダプター
* [[Bluetooth]] コントローラー
* サウンドカード ― [[プロフェッショナルオーディオ]]やオンボードオーディオ

== インストール ==

{{Pkg|linux-firmware}} [[メタパッケージ]]を [[インストール]]することで、[https://gitlab.archlinux.org/archlinux/packaging/packages/linux-firmware/-/blob/main/PKGBUILD?ref_type=heads#L103 よく使われる] すべてのファームウェアを取得できます。これはほとんどのユーザーに推奨される方法です。ディスク容量を節約したい場合は、自身のシステムで使用しているハードウェアベンダー向けのファームウェアのみを選んでインストールすることもできます。

{{Warning|必要なファームウェアがないと、システムが動作しない可能性があります。}}

{{Pkg|linux-firmware}} によってインストールされる主なパッケージ:

* {{Pkg|linux-firmware-amdgpu}} — [[AMD]] Radeon GPU
* {{Pkg|linux-firmware-atheros}} — [[Wikipedia:Atheros|Qualcomm Atheros]] 製 Wi-Fi および Bluetooth アダプター
* {{Pkg|linux-firmware-broadcom}} — [[Broadcom]] および [[Wikipedia:Cypress Semiconductor|Cypress]] 製ネットワークアダプター
* {{Pkg|linux-firmware-cirrus}} — [[Wikipedia:Cirrus Logic|Cirrus Logic]] 製オーディオデバイス
* {{Pkg|linux-firmware-intel}} — [[Intel]] 製オーディオデバイス、Bluetooth アダプター、GPU、ネットワークアダプター、NPU、Web カメラなどの各種デバイス
* {{Pkg|linux-firmware-mediatek}} — [[Wikipedia:MediaTek|MediaTek]] および [[Wikipedia:Ralink|Ralink]] 製ネットワークアダプター
* {{Pkg|linux-firmware-nvidia}} — [[NVIDIA]] 製 GPU および SoC
* {{Pkg|linux-firmware-other}} — その他の未分類デバイス
* {{Pkg|linux-firmware-radeon}} — [[ATI]] Radeon GPU
* {{Pkg|linux-firmware-realtek}} — [[Wikipedia:Realtek|Realtek]] 製ネットワークおよび Bluetooth アダプター

オプションパッケージ:

* {{Pkg|linux-firmware-liquidio}} — [[Wikipedia:Cavium|Cavium]] LiquidIO サーバーアダプター
* {{Pkg|linux-firmware-marvell}} — [[Wikipedia:Marvell Technology|Marvell]] 製ネットワークアダプター
* {{Pkg|linux-firmware-mellanox}} — [[Wikipedia:Mellanox Technologies|Mellanox]] 製 Spectrum スイッチ
* {{Pkg|linux-firmware-nfp}} — [[Wikipedia:Netronome|Netronome]] Flow Processor
* {{Pkg|linux-firmware-qcom}} — [[Wikipedia:Qualcomm|Qualcomm]] 製 SoC
* {{Pkg|linux-firmware-qlogic}} — [[Wikipedia:QLogic|QLogic]] 製ネットワークデバイス

サードパーティ製パッケージ:

* {{Pkg|alsa-firmware}} — {{Pkg|alsa-tools}} に含まれるローダープログラムおよびホットプラグ対応ファームウェアローダー、詳しくは [[ALSA#Firmware]] を参照
* {{Pkg|sane-gt68xx-firmware}} — [http://www.meier-geinitz.de/sane/gt68xx-backend/ gt68xx] ベースのスキャナー用
* {{Pkg|sigrok-firmware-fx2lafw}} — [https://sigrok.org/wiki/Fx2lafw FX2] ロジックアナライザー用
* {{Pkg|sof-firmware}} — [[Sound Open Firmware]] 用

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

=== 読み込まれたファームウェアの検出 ===

デバッグやインストールすべきファームウェアパッケージを特定するために、システムによってどのファームウェアが読み込まれたかを知りたい場合があります。

これは [https://docs.kernel.org/admin-guide/dynamic-debug-howto.html dynamic debug] を使って確認できます:

* [[カーネルパラメータ]] に {{ic|1=dyndbg="func fw_log_firmware_info +p"}} を追加してください。なお、使用している [[ブートローダー]] によってはクォートをエスケープする必要があります。
* 以下のコマンドで読み込まれたファームウェアを一覧表示できます:
{{bc|# journalctl -kg 'loaded f'}}

== 参照 ==

* [[Gentoo:Linux firmware]]

Advanced Linux Sound Architecture

2025-09-02T04:23:23Z

Kgx: /* インストール */ 同期

[[Category:サウンド]]
[[cs:Advanced Linux Sound Architecture]]
[[de:Alsa]]
[[en:Advanced Linux Sound Architecture]]
[[es:Advanced Linux Sound Architecture]]
[[fa:ALSA]]
[[fr:Alsa]]
[[he:Advanced Linux Sound Architecture]]
[[it:Advanced Linux Sound Architecture]]
[[nl:Advanced Linux Sound Architecture]]
[[pt:Advanced Linux Sound Architecture]]
[[ru:Advanced Linux Sound Architecture]]
[[sk:Advanced Linux Sound Architecture]]
[[th:Advanced Linux Sound Architecture]]
[[tr:Gelişmiş_ses_mimarisi_(ALSA)]]
[[zh-hans:Advanced Linux Sound Architecture]]
{{Related articles start}}
{{Related|Advanced Linux Sound Architecture/設定例}}
{{Related|Advanced Linux Sound Architecture/トラブルシューティング}}
{{Related|サウンドシステム}}
{{Related|PC スピーカーのビープ音の無効化}}
{{Related|PulseAudio}}
{{Related|Open Sound System}}
{{Related articles end}}
[[Wikipedia:ja:Advanced Linux Sound Architecture|Advanced Linux Sound Architecture]] ('''ALSA''') は、サウンドカードのデバイスドライバを提供する Open Sound System (OSSv3) を置き換えるために開発された Linux カーネルコンポーネントです。デバイスドライバの他に、'''ALSA''' は、カーネルドライバと直接やりとりせずに高レベルの API を使ってドライバ機能を使いたいという開発者のために、ユーザ空間のライブラリも提供しています。

== インストール ==

ALSA ドライバは Linux カーネルの一部です。ALSA ライブラリ({{Pkg|alsa-lib}})は通常、[[PKGBUILD#依存関係|依存関係]]としてインストールされます。そのため、手動でインストールする必要はありません。

起動時に自動で [[udev]] があなたのハードウェアを調べて、オーディオカード用の適切なカーネルモジュールをロードします。したがって、サウンドはすでに鳴らせるはずです。

ただ、デフォルトでは全てのチャンネルはミュートにされています。[[#チャンネルのミュートを解除する|チャンネルのミュートを解除]]してください。

=== ファームウェア ===

[https://www.sofproject.org/ Sound Open Firmware] (SOF) ({{Pkg|sof-firmware}}) は通常、ノートパソコンで必須です。これらのノートパソコンはCadence Tensilica Xtensaアーキテクチャの [[Wikipedia:デジタル信号プロセッサ|DSP]] を搭載していることが多いため、[https://thesofproject.github.io/latest/platforms/ 対応プラットフォーム] のリストをご覧ください。

ファームウェアがインストールされていない場合、[[journal]] には次のようなメッセージが表示されます:

error: sof firmware file is missing
error: failed to load DSP firmware -2
error: sof_probe_work failed err: -2

SOF のトラブルシューティングの詳細については、[https://thesofproject.github.io/latest/getting_started/intel_debug/introduction.html Intel ハードウェアプラットフォームの概要] を参照してください。

Cirrus Logic [https://www.cirrus.com/products/audio/boosted-amplifiers/laptop-audio スマートアンプ] を搭載したノートパソコンには、{{Pkg|linux-firmware-cirrus}} パッケージが必要です。こちらもご覧ください:

* [https://docs.kernel.org/sound/codecs/cs35l56.html Cirrus Logic CS35L54/56/57/63 Boosted Smart Amplifiers 用オーディオドライバ]
* [https://gitlab.archlinux.org/archlinux/packaging/packages/linux-firmware/-/issues/19 archlinux/packaging/packages/linux-firmware#19]

{{Pkg|linux-firmware-intel}} パッケージは一部の Intel オーディオデバイスに必要です。

{{Pkg|alsa-firmware}} パッケージには、[https://github.com/alsa-project/alsa-firmware 特定の] サウンドカードに必要な可能性があるファームウェアが含まれています。

あわせて [[#デフォルトサウンドカードの設定]] および [[Linux ファームウェア]] も参照。

=== ALSA ユーティリティ ===

{{Pkg|alsa-utils}} パッケージを[[インストール]]してください、サウンドデバイスをコンソールや端末から設定するための {{ic|alsamixer}} ユーザー空間ツールが含まれています。また、[[#高品質なリサンプリング|高品質なリサンプリング]]や[[#アップ・ダウンミキシング|アップ・ダウンミキシング]]などの高度な機能を使いたい場合は {{Pkg|alsa-plugins}} パッケージをインストールしてください。

=== ALSA と systemd ===

{{pkg|alsa-utils}} パッケージには、それぞれ起動時とシャットダウン時に動くように設定された {{ic|alsa-restore.service}} と {{ic|alsa-state.service}} が含まれています。

自動的にインストールされ有効化されるため、特に設定は必要ありません。{{ic|systemctl}} を使うことでステータスを確認できます。

{{Note|1=ALSA は設定を {{ic|/var/lib/alsa/asound.state}} に保存します。}}

=== ユーザー権限 ===

通常、ローカルユーザーは音楽を再生したり、ミキサーレベルを変更する権限があります。

リモートユーザーが ALSA を使用できるようにするには、ユーザーを {{ic|audio}} グループに[[ユーザーとグループ#グループ管理|追加]]する必要があります。

{{Note|1={{ic|audio}} グループに含まれているユーザーは直接デバイスにアクセスできるので、アプリケーションから排他的にアウトプットしたり(ソフトウェアミキシングが破壊されます)、高速ユーザー切り替えや multiseat を破壊してしまうおそれがあります。よって、特に必要がないのならばユーザーを {{ic|audio}} グループに追加することは'''推奨されません'''[https://wiki.ubuntu.com/Audio/TheAudioGroup]}}

=== OSS との互換性 ===

{{Note|{{ic|/dev/dsp}} や {{ic|/dev/snd/seq}} が存在しないとアプリケーションがエラーを吐く場合は以下の設定が必要です。}}

ALSA には [[OSS]] のコールに介入して ALSA を使うようにさせる機能があります。このエミュレーションレイヤーは {{ic|/dev/dsp}} を開いて音声データを直接書き込むような古いアプリケーションで有用です。OSS やエミュレーションライブラリがないと、{{ic|/dev/dsp}} が見つからずにアプリケーションは音声を鳴らすことができません。

OSS アプリケーションに dmix (ソフトウェアミキシング) を扱わせたい場合は {{Pkg|alsa-oss}} パッケージをインストールして {{ic|snd-seq-oss}}, {{ic|snd-pcm-oss}}, {{ic|snd-mixer-oss}} [[カーネルモジュール]]をロードして OSS エミュレーションモジュールを有効にしてください。

==チャンネルのミュートを解除する==

現在のバージョンでは ALSA をインストールしたあと全てのチャンネルは'''デフォルトでミュートされています'''。手動でチャンネルをアンミュートする必要があります。

===amixer を使ってミュートを解除===

コマンドラインで {{ic|amixer}} を使うことでサウンドカードのマスターボリュームのミュートを解除できます:

$ amixer sset Master unmute

===alsamixer を使ってミュートを解除===

{{ic|alsamixer}} ncurses UI を使えば簡単にミュートを解除できます:

$ alsamixer

{{ic|alsamixer}} の、チャンネルの下の {{ic|MM}} ラベルはそのチャンネルがミュートになっていることを示しています。{{ic|00}} はミュートが解除されていることを示しています。

{{ic|←}} や {{ic|→}} キーを押して {{ic|Master}} や {{ic|PCM}} チャンネルに移動して {{ic|m}} キーを押してミュートを解除してください。{{ic|↑}} キーを押してボリュームを上げて値を {{ic|0}} dB ゲインにしてください。ゲインは左上の {{ic|項目:}} の隣に表示されます。

{{Note|ゲインを大きくしすぎると音にノイズが混じります。}}

=== 5.1/7.1 サウンドのミュートの解除 ===

5.1 または 7.1 サラウンドを鳴らしたいときは Front, Surround, Center, LFE (サブウーファー), Side などの他のチャンネルも同じようにミュートを解除してください（これらのチャンネル名は Intel HD Audio のものです、チャンネル名はハードウェアによって変わっているかもしれません）。

{{Note|ミュートを解除しただけではステレオ音源は自動でアップミキシングされません。[[#アップ・ダウンミキシング]] を見て下さい。}}

=== マイクの有効化 ===

マイクロフォンを有効にするには、Capture タブに {{ic|F4}} で切り替えてチャンネルを {{ic|Space}} で有効にしてください。マイクが使えない時は [[Advanced Linux Sound Architecture/トラブルシューティング#マイクロフォン]] を見て下さい。

=== テスト ===

次に、音が鳴るかテストしてみましょう:

$ speaker-test -c 2

{{ic|-c}} はスピーカーによって変えて下さい。例えば 7.1 では {{ic|-c 8}} を使います:

$ speaker-test -c 8

間違ったデバイスから音が出力される場合、{{ic|-D}} 引数を使って手動でデバイスを指定してみてください:

$ speaker-test -D default:PCH -c 8

{{ic|-D}} では PCM チャンネルの名前を値として指定できます。以下のコマンドで確認することができます:

{{hc|<nowiki>$ aplay -L | grep :CARD</nowiki>|2=
default:CARD=PCH # 'default:PCH' is the PCM channel name for -D
sysdefault:CARD=PCH
front:CARD=PCH,DEV=0
surround21:CARD=PCH,DEV=0
surround40:CARD=PCH,DEV=0
surround41:CARD=PCH,DEV=0
surround50:CARD=PCH,DEV=0
surround51:CARD=PCH,DEV=0
surround71:CARD=PCH,DEV=0
}}

音が出ない場合、[[#設定]]や [[Advanced Linux Sound Architecture/トラブルシューティング]]に進んで問題を解決してください。

===ノート===

* カードによってはアナログサウンドを聞くためにはデジタル出力をミュートする必要があります。Soundblaster Audigy LS では IEC958 チャンネルをミュートしてください。
* マシンによっては (Thinkpad T61 など)、Speaker チャンネルのミュートを解除する必要があります。
* マシンによっては (Dell E6400 など)、同じく {{ic|Front}} や {{ic|Headphone}} チャンネルのミュートを解除する必要があります。
* 再起動するとボリューム調整が元に戻ってしまう場合、root で alsamixer を実行してみて下さい。

==設定==

システムの設定ファイルは {{ic|/etc/asound.conf}} で、ユーザー別の設定ファイルは {{ic|~/.asoundrc}} です。

===デフォルトサウンドカードの設定===

起動毎にサウンドカードの順番が変わってしまうときは、{{ic|/etc/modprobe.d}} 内の {{ic|.conf}} で終わるファイル (例: {{ic|/etc/modprobe.d/alsa-base.conf}}) に順番を明記することができます。
例えば、mia サウンドカードを #0 にしたい場合は:

{{hc|/etc/modprobe.d/alsa-base.conf|2=<nowiki>
options snd slots=snd_mia,snd_hda_intel
options snd_mia index=0
options snd_hda_intel index=1
</nowiki>}}

{{ic|<nowiki>$ cat /proc/asound/modules</nowiki>}} を使ってロードされているサウンドモジュールとその順番を取得してください。{{ic|<nowiki>$ lsmod | grep snd</nowiki>}} を使ってデバイス・モジュールのリストを取得してください。この設定では {{ic|snd_mia}} を使うサウンドカードと {{ic|snd_hda_intel}} を使うサウンドカード (例: オンボード) を一枚づつ挿していると仮定しています。

index を {{ic|-2}} にすることで ALSA にカードを優先的に使わせないようにすることも可能です。Linux Mint や Ubuntu などのディストリビューションでは以下の設定を使うことで USB やその他の"一般的でない"ドライバに index {{ic|0}} を与えないようにしています:

{{hc|/etc/modprobe.d/alsa-base.conf|2=
options bt87x index=-2
options cx88_alsa index=-2
options saa7134-alsa index=-2
options snd-atiixp-modem index=-2
options snd-intel8x0m index=-2
options snd-via82xx-modem index=-2
options snd-usb-audio index=-2
options snd-usb-caiaq index=-2
options snd-usb-ua101 index=-2
options snd-usb-us122l index=-2
options snd-usb-usx2y index=-2
options snd-pcsp index=-2
options snd-usb-audio index=-2
}}

変更を反映させるには再起動する必要があります。

==== 環境変数を使ってデフォルト PCM を選択する ====

設定ファイルで、以下を追加してください:
pcm.!default {
type plug
slave.pcm {
@func getenv
vars [ ALSAPCM ]
default "hw:Audigy2"
}
}

default の行はあなたのカードの名前に置き換える必要があります (ここでは {{ic|Audigy2}} を例にしています)。{{ic|aplay -l}} で名前を取得することができ '''surround51''' のように PCM を使うことも可能です。ただしマイクロフォンを使う必要がある場合は full-duplex PCM をデフォルトにすると良いでしょう。

これで環境変数 {{ic|ALSAPCM}} を変更することでサウンドカードを選択できるようになります。カードを選択できない全てのプログラムで問題なく使えます。
例えば、'''mix51to20''' という名前の downmix PCM を書いたときは {{ic|mplayer}} を {{ic|ALSAPCM=mix51to20 mplayer example_6_channel.wav}} で使うことができます。

==== ハードウェアを直接割り当てる ====

{{Warning|この設定では他のアプリケーションからデバイスが使用不可能になります。この方法は、デジタル出力や音楽サーバーに捧げる場合など、わざとそうした場合にのみ推奨されます。サウンドサーバーや[[Advanced_Linux_Sound_Architecture#ミキシング|ミキシング]]無しの設定は[[Chromium]]等の幾つかのアプリケーションでサポートされていません。}}

まずデフォルトに設定したいカード・デバイスの id を {{ic|aplay -l}} で見つける必要があります:

{{hc|$ aplay -l|2=
**** List of PLAYBACK Hardware Devices ****
card 0: Intel [HDA Intel], device 0: CONEXANT Analog [CONEXANT Analog]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: Intel [HDA Intel], device 1: Conexant Digital [Conexant Digital]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 1: JamLab [JamLab], device 0: USB Audio [USB Audio]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 2: Audio [Altec Lansing XT1 - USB Audio], device 0: USB Audio [USB Audio]
Subdevices: 1/1
Subdevice #0: subdevice #0
}}

例えば、このリストの最後のエントリはカード ID 2,カード名 Audio でデバイス ID 0 です。このカードをデフォルトにするには、システム全体のファイル {{ic|/etc/asound.conf}} かユーザー定義ファイル {{ic|~/.asoundrc}} のどちらかを使ってください。ファイルが存在しないときは作成する必要があります。そして以下のオプションを適切なカード・デバイス id を使って挿入して下さい。

{{bc|
pcm.!default {
type hw
card Audio #又はcard 2
hint
show on #幾つかのアプリケーションで必要
}
}

ctl.!default {
type hw
card Audio
}

pcm.dmixer {
type dmix
ipc_key 2048
slave {
pcm "hw:Audio"
}
}
pcm.dsnooper {
type dsnoop
ipc_key 2048
slave {
pcm "hw:Audio"
}
}
}}

カードIDではなくカード名の使用をおすすめします。デバイスの順番に依存しないためです。

{{ic|pcm.dmixer}}と{{ic|pcm.dsnooper}}は[[Advanced_Linux_Sound_Architecture#ミキシング|ミキシング]]が必要なアプリケーションの為の予備です。
{{Accuracy|General method to select alsa device should be introduced such as environment value.}}
例えば、{{ic|1=chromium -alsa-output-device=pcm.dmixer -alsa-input-device=pcm.dsnooper}}でChromiumがミキシングを使えるようになります。

{{Note|Asus U32U シリーズではカードの pcm と ctl の両方を 1 に設定する必要があります。}}

'pcm' オプションは音声の再生で使われるカード・デバイスに影響を与え、'ctl' オプションは alsamixer などのコントロールユーティリティで使われるカードに影響を与えます。

アプリケーション (mplayer など) を（再）起動すれば変更はすぐ適用されます。また、''aplay'' などのコマンドを使ってテストすることが可能です。

$ aplay -D default:PCH ''your_favourite_sound.wav''

asound 設定に関するエラーが表示される場合は、[http://www.alsa-project.org/main/index.php/Asoundrc#The_default_plugin 上流のドキュメント] を確認して設定ファイルフォーマットの変更を確認してください。

===サウンドモジュールがロードされていることを確かめる===

udev が正しくサウンドカードを検知しているかチェックするには次のコマンドを実行してください:

{{hc|<nowiki>$ lsmod | grep '^snd' | column -t</nowiki>|<nowiki>
snd_hda_codec_hdmi 22378 4
snd_hda_codec_realtek 294191 1
snd_hda_intel 21738 1
snd_hda_codec 73739 3 snd_hda_codec_hdmi,snd_hda_codec_realtek,snd_hda_intel
snd_hwdep 6134 1 snd_hda_codec
snd_pcm 71032 3 snd_hda_codec_hdmi,snd_hda_intel,snd_hda_codec
snd_timer 18992 1 snd_pcm
snd 55132 9 snd_hda_codec_hdmi,snd_hda_codec_realtek,snd_hda_intel,snd_hda_codec,snd_hwdep,snd_pcm,snd_timer
snd_page_alloc 7017 2 snd_hda_intel,snd_pcm
</nowiki>}}

出力が上と同じようになっていれば、サウンドドライバが首尾よく自動検出されています。
{{Note|{{ic|udev>=171}} から、OSS エミュレーションモジュール ({{ic|snd_seq_oss, snd_pcm_oss, snd_mixer_oss}}) はデフォルトではロードされないようになりました: 必要ならば[[カーネルモジュール#ロード|手動でロードしてください]]。}}

{{ic|/dev/snd/}} ディレクトリにデバイスファイルがあるか調べてもいいかもしれません:

{{hc|$ ls -l /dev/snd|2=<nowiki>
total 0
crw-rw---- 1 root audio 116, 0 Apr 8 14:17 controlC0
crw-rw---- 1 root audio 116, 32 Apr 8 14:17 controlC1
crw-rw---- 1 root audio 116, 24 Apr 8 14:17 pcmC0D0c
crw-rw---- 1 root audio 116, 16 Apr 8 14:17 pcmC0D0p
crw-rw---- 1 root audio 116, 25 Apr 8 14:17 pcmC0D1c
crw-rw---- 1 root audio 116, 56 Apr 8 14:17 pcmC1D0c
crw-rw---- 1 root audio 116, 48 Apr 8 14:17 pcmC1D0p
crw-rw---- 1 root audio 116, 1 Apr 8 14:17 seq
crw-rw---- 1 root audio 116, 33 Apr 8 14:17 timer
</nowiki>}}

{{Note|IRC やフォーラムで助けを求める時は、上記のコマンドの出力を貼って下さい。}}

とにかく '''controlC0''' や '''pcmC0D0p''' のようなデバイスがあれば、サウンドモジュールが正しくロードされていることを示しています。

そうなってないのなら、あなたのサウンドモジュールは正しく検出されていません。これを解決するには、手動でモジュールのロードを試して下さい:

* サウンドカードのモジュールを確認します: [http://www.alsa-project.org/main/index.php/Matrix:Main ALSA Soundcard Matrix] モジュールには名前の前に 'snd-' が付きます (例: {{ic|snd-via82xx}})。
* [[カーネルモジュール#ロード|モジュールをロードします]]。
* {{ic|/dev/snd}} の中のデバイスファイルを確認したり（上述）、{{ic|alsamixer}} や {{ic|amixer}} に変化がないか調べて下さい。
* {{ic|snd-NAME-OF-MODULE}} と {{ic|snd-pcm-oss}} を[[カーネルモジュール#ロード|起動時にロード]]するよう設定して下さい。

===S/PDIF 出力===

[[wikipedia:ja:S/PDIF|S/PDIF]] はコンピュータとオーディオアンプを接続するときにしばしば使われるデジタルオーディオインターフェイスです (5.1/7.1 サラウンドのホームシアターなど)。
{{note|サウンドカードによっては以下の瀬底でアナログ出力が無効になることがあります (例: Sound Blaster Audigy 2)。}}
使用している[[シェル]]にあわせて、シェルの設定ファイルに以下の行を追加してください:
amixer -c 0 cset name='IEC958 Playback Switch' on

カードのデジタル出力の名前は以下のコマンドで確認できます:
$ amixer scontrols

===イコライザー===

====AlsaEqual を使う (UI あり)====

{{AUR|alsaequal}} パッケージをインストールしてください。

パッケージをインストールした後、以下を ALSA 設定ファイル ({{ic|~/.asoundrc}} か {{ic|/etc/asound.conf}}) に挿入してください:

ctl.equal {
type equal;
}

pcm.plugequal {
type equal;
# Modify the line below if you do not
# want to use sound card 0.
#slave.pcm "plughw:0,0";
#by default we want to play from more sources at time:
slave.pcm "plug:dmix";
}
#pcm.equal {
# If you do not want the equalizer to be your
# default soundcard comment the following
# line and uncomment the above line. (You can
# choose it as the output device by addressing
# it with specific apps,eg mpg123 -a equal 06.Back_In_Black.mp3)
pcm.!default {
type plug;
slave.pcm plugequal;
}

x86_64 環境で {{Pkg|lib32-flashplugin}}{{Broken package link|{{aur-mirror|lib32-flashplugin}}}} を使用している場合、上記の設定では flash で音が鳴りません。以下の設定で flash の音を有効にできますが、{{ic|pcm "hw:0,0"}} の行でサウンドカードを手動で指定する必要があります (利用可能なサウンドカードとカードのデバイス番号は {{ic|aplay -l}} で確認できます):

{{hc|/etc/asound.conf|2=
pcm.dmixer {
type dmix
ipc_key 2048
slave {
pcm "hw:0,0"
buffer_size 16384
}
}

ctl.equal {
type equal;
}

pcm.equalizer {
type equal
slave.pcm "plug:dmixer"
}

pcm.!default {
type plug
slave.pcm equalizer
}
}}

次のコマンドを使ってイコライザーを変更することができます:
$ alsamixer -D equal

設定ファイルはユーザーごとに違うので注意してください。{{ic|~/.alsaequal.bin}}　に保存されます。
AlsaEqual を異なるユーザーの [[Music Player Daemon|mpd]] などのソフトウェアで使いたいときは、次を実行することで設定できます:
# su mpd -c 'alsamixer -D equal'
もしくは、ユーザーの home にある {{ic|.alsaequal.bin}} のシンボリックリンクを作って下さい。

=====AlsaEqual の管理=====

{{AUR|alsaequal-mgr}} パッケージをインストールしてください。

通常通りイコライザーを設定してください:
$ alsamixer -D equal

状態に満足したら、名前を付けて保存してください (例: "foo"):
$ alsaequal-mgr save foo

イコライザーの状態 "foo" は次のコマンドで戻すことができます:
$ alsaequal-mgr load foo

ゲームや映画、音楽のジャンル別、VoIP アプリなどそれぞれに合わせてイコライザーの状態を作成し、必要なときにリロードできます。

オプションの詳細は [https://xyne.archlinux.ca/projects/alsaequal-mgr/ project page] を見て下さい。

====mbeq を使う====

{{Note|この方法では ladspa プラグインを使う必要があります。サウンドを再生する際に CPU の使用量が多めです。さらに、ステレオサウンドを念頭に置いて作成されています (例: ヘッドフォン)。}}

{{Pkg|alsa-plugins}}, {{Pkg|ladspa}}, {{Pkg|swh-plugins}} パッケージをインストールしてください。

まだ {{ic|~/.asoundrc}} か {{ic|/etc/asound.conf}} ファイルを作成していない場合は、どちらかを作成して以下を挿入して下さい:

{{hc|/etc/asound.conf|2=<nowiki>pcm.eq {
type ladspa

# The output from the EQ can either go direct to a hardware device
# (if you have a hardware mixer, e.g. SBLive/Audigy) or it can go
# to the software mixer shown here.
#slave.pcm "plughw:0,0"
slave.pcm "plug:dmix"

# Sometimes you may need to specify the path to the plugins,
# especially if you have just installed them. Once you have logged
# out/restarted this should not be necessary, but if you get errors
# about being unable to find plugins, try uncommenting this.
#path "/usr/lib/ladspa"

plugins [
{
label mbeq
id 1197
input {
#this setting is here by example, edit to your own taste
#bands: 50hz, 100hz, 156hz, 220hz, 311hz, 440hz, 622hz, 880hz, 1250hz, 1750hz, 25000hz,
#50000hz, 10000hz, 20000hz
controls [ -5 -5 -5 -5 -5 -10 -20 -15 -10 -10 -10 -10 -10 -3 -2 ]
}
}
]
}

# Redirect the default device to go via the EQ - you may want to do
# this last, once you are sure everything is working. Otherwise all
# your audio programs will break/crash if something has gone wrong.

pcm.!default {
type plug
slave.pcm "eq"
}

# Redirect the OSS emulation through the EQ too (when programs are running through "aoss")

pcm.dsp0 {
type plug
slave.pcm "eq"
}
</nowiki>}}

==高品質なリサンプリング==

ソフトウェアミキシングが有効になっていると、ALSA は全てを同じ周波数 (デフォルトで 48000) にリサンプリングします。dmix はサウンドの品質を落としてしまう低品質リサンプリングアルゴリズムを使っています。

{{pkg|alsa-plugins}} と {{pkg|libsamplerate}} をインストールして下さい。

デフォルトの変換器を libsamplerate に変更します:

{{hc|/etc/asound.conf|defaults.pcm.rate_converter "samplerate_best"}}

または:

{{hc|~/.asoundrc|defaults.pcm.rate_converter "samplerate_best"}}

'''samplerate_best''' は最高のサウンド品質を提供しますが、リアルタイムサンプリングをするには CPU サイクルが大量に必要になるので使うにはそこそこの CPU が必須です。また、dmix の設定で buffer_size を基本の 4096 から 8192 か 16384 に調整する必要もあるかもしれません。他のアルゴリズム ('''samplerate''' など) も利用できますがデフォルトのリサンプラーに比べておそらくあまり改善はないでしょう。

{{Warning|環境によっては、samplerate_best を有効にすると flashplayer でサウンドが出力されなくなるという問題が発生します。}}

==アップ・ダウンミキシング==

===アップミキシング===

音楽などのステレオ音源を 5.1 や 7.1 サウンドシステムをフルに使って再生するには、アップミキシングを使う必要があります。黎明期ではこれをするのはとても難しいものでした。ですが現在では簡単にアップミキシングができるプラグインがあります。{{Pkg|alsa-plugins}} に含まれている {{ic|upmix}} プラグインを使います。

それから以下を ALSA 設定ファイル ({{ic|/etc/asound.conf}} か {{ic|~/.asoundrc}}) に追加してください:
pcm.upmix71 {
type upmix
slave.pcm "surround71"
delay 15
channels 8
}

上の例は 7.1 のものですが 5.1 や 4.0 にも簡単に変えられます。

設定をするとアップミキシングに使う新しい pcm が加わります。全てのサウンド音源をこの pcm に通したい時は、次のようにデフォルトとして追加してください:

pcm.!default "plug:upmix71"

このプラグインは使うにあたって特に設定を変える必要はありません。
プラグインが動作しないときは、以下のようにしてアップミキシングする PCM のための dmixer を自分で設定してください:
pcm.dmix6 {
type asym
playback.pcm {
type dmix
ipc_key 567829
slave {
pcm "hw:0,0"
channels 6
}
}
}

そして "surround71" のかわりに "dmix6" を使って下さい。
音がスキップしたり歪むときは、buffer_size を増やす (例: 32768) か [[#高品質なリサンプリング|高品質リサンプラー]]を使ってください。

===ダウンミキシング===
5.1 サウンドの映画をステレオシステムで視聴するときなど、音源をステレオにダウンミキシングしたい場合、{{Pkg|alsa-plugins}} に含まれている {{ic|vdownmix}} プラグインを使って下さい。

設定ファイルに以下を追加して下さい:

pcm.!surround51 {
type vdownmix
slave.pcm "default"
}
pcm.!surround40 {
type vdownmix
slave.pcm "default"
}

{{Note|1=これだけではダウンミキシングが動作しないかもしれません、[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=541786] を参照してください。その場合、{{ic|pcm.!default "plug:surround51"}} か {{ic|pcm.!default "plug:surround40"}} を追加する必要があります。{{ic|vdownmix}} プラグはひとつだけ使うことができます; 7.1 チャンネルのときは、上の設定の代わりに {{ic|surround71}} を使って下さい。{{ic|vdownmix}} と {{ic|dmix}} の両方を動かす設定例が[https://bbs.archlinux.org/viewtopic.php?id=167275 ここ]にあります。}}

==ミキシング==

ミキシングを使うことで複数のアプリケーションが同時に音を出力することが可能になります。外付けのサウンドカードはほとんどの場合ハードウェアミキシングをサポートしており、可能であればデフォルトで有効にされます。内蔵のマザーボードに載っているサウンドカード (Intel HD Audio など) は基本的にハードウェアミキシングをサポートしていません。そのようなカードでは、dmix という名前の ALSA プラグインを使ってソフトウェアミキシングを利用します。この機能はハードウェアミキシングが使えない場合に自動で有効にされます。

===手動で dmix を有効にする===

{{Note|ALSA 1.0.9rc2 以上ではアナログサウンドに dmix を設定する必要はありません。ハードウェアミキシングをサポートしていないサウンドカードのために Dmix はデフォルトで有効にされています。}}

ソフトウェアミキシングが動作しない場合は、あなたの home フォルダに以下の内容で .asoundrc ファイルを作成してください。

pcm.dsp {
type plug
slave.pcm "dmix"
}

これでソフトウェアミキシングが有効になり複数のアプリケーションがサウンドカードを使えるようになるはずです。使えない場合は、{{ic|/etc/asound.conf}} の中身を全て上のように置き換えてみて下さい。

S/PDIF などのデジタル音声出力をするために、ALSA パッケージは依然として dmix をデフォルトで有効にしていません。そのため、上の dmix 設定は S/PDIF デバイスで dmix を有効にするために使うことはできません。

一般的な問題と解決方法は [[Advanced Linux Sound Architecture/トラブルシューティング]] を見て下さい。

===ハードウェアミキシング===

====サポート====

ハードウェアでミキシングをサポートしているオーディオチップセットを持っている場合、設定は必要ありません。ほとんど全てのオンボード・オーディオチップセットはハードウェアミキシングをサポートしていないので、ソフトウェアでミキシングする必要があります（上述）。ハードウェアミキシングをサポートしているサウンドカードは少なく、Linux でサポートされているサウンドカードは以下になります:

* Creative SoundBlaster Live! (5.1 モデル)
* Creative SoundBlaster Audigy (複数)
* Creative SoundBlaster Audidy 2 (ZS モデル)
* Creative SoundBlaster Audigy 4 (Pro モデル)

{{Note|
* 上記のカードのローエンド版 (Audigy SE, Audigy 2 NX, SoundBlaster Live! 24bit, SoundBlaster Live! 7.1) は別のチップを使っているためハードウェアミキシングに対応していません。
* オンボードの VIA8237 チップは4ストリームのハードウェアミキシングに対応していますが、マザーボードによってはそれが3ストリームになったり (4番目のストリームが音を出さない) あるいは使えないこともあります。動作したとしても、他の方法と比べて音質は劣ります。}}

====フィックス====

64-bit Arch で Intel Corporation 82801I (ICH9 Family) HD Audio Controller (rev 02) を使っている場合、Enemy Territory でサウンドを鳴らすには以下を実行して下さい:
echo "et.x86 0 0 direct" > /proc/asound/card0/pcm0p/oss
echo "et.x86 0 0 disable" > /proc/asound/card0/pcm0c/oss

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

=== USB サウンドカードのホットプラグ ===

USB サウンドカードが挿入されたときに、自動的に第一のアウトプットデバイスにするために、以下の udev ルールを使うことができます (例: 以下の2行を {{ic|/etc/udev/rules.d/00-local.rules}} に追加して再起動する)。

{{bc|1=KERNEL=="pcmC[D0-9cp]*", ACTION=="add", PROGRAM="/bin/sh -c 'K=%k; K=$${K#pcmC}; K=$${K%%D*}; echo defaults.ctl.card $$K > /etc/asound.conf; echo defaults.pcm.card $$K >>/etc/asound.conf'"
KERNEL=="pcmC[D0-9cp]*", ACTION=="remove", PROGRAM="/bin/sh -c 'echo defaults.ctl.card 0 > /etc/asound.conf; echo defaults.pcm.card 0 >>/etc/asound.conf'"}}

=== 同時出力 ===

ミニジャックで接続した外付けスピーカーと内蔵のスピーカーで同時に音楽を再生したい場合、{{ic|alsamixer}} や {{ic|amixer}} を使うことで ''Auto-Mute'' のミュートを解除してください:
$ amixer sset "Auto-Mute" unmute

そして ''Headphones''', ''Speaker'', '''Bass Speaker'' など他の必要なアイテムのミュートを解除してください。
{{Note|(ミニジャック) ヘッドフォンコネクタで接続した場合に音が割れる場合、[[Advanced Linux Sound Architecture/トラブルシューティング#ミニジャック (ヘッドフォンコネクタ) で音が割れる]]を見て下さい。}}

=== キーボードのボリュームコントロール ===

以下のコマンドをボリュームキーにマッピングしてください: {{ic|XF86AudioRaiseVolume}}, {{ic|XF86AudioLowerVolume}}, {{ic|XF86AudioMute}}

ボリュームを上げるには:
amixer set Master 5%+

ボリュームを下げるには:
amixer set Master 5%-

==トラブルシューティング==
[[Advanced Linux Sound Architecture/トラブルシューティング]]を見て下さい。

==設定例==

[[Advanced Linux Sound Architecture/設定例]]を見て下さい。

==参照==
* [http://www.alsa-project.org/ ALSA wiki]
* [http://www.alsa-project.org/main/index.php/Asoundrc Asoundrc]
* [http://alsa.opensrc.org/ 非公式 ALSA wiki]
* [https://www.mjmwired.net/kernel/Documentation/sound/alsa/ALSA-Configuration.txt 高度な ALSA モジュール設定]
* [https://bbs.archlinux.org/viewtopic.php?id=36815 HOWTO: compile driver from svn]
* [http://www.volkerschatz.com/noise/alsa.html A close look at ALSA: ALSA concept introduction]
* [http://www.sabi.co.uk/Notes/linuxSoundALSA.html Linux ALSA sound notes]

Lenovo ThinkPad T14/T14s (Intel) Gen 4

2025-09-02T04:05:15Z

Kgx: 翻訳

[[Category:Lenovo]]
[[en:Lenovo ThinkPad T14/T14s (Intel) Gen 4]]

{| class="wikitable archwiki-table-laptop"
|-
! ハードウェア !! PCI/USB ID !! 動作状況
|-
| タッチパッド || {{ic|04F3:3195}} || {{Yes}}
|-
| トラックポイント || {{ic|04F3:2EA3}} || {{Yes}}
|-
| GPU (Intel) || {{ic|8086:a7a1}} || {{Yes}}
|-
| Web カメラ || {{ic|04f2:b74f}} || {{Yes}}
|-
| Bluetooth || {{ic|8087:0033}} || {{Yes}}
|-
| オーディオ || {{ic|8086:51ca}} || {{Yes}}
|-
| Wi-Fi || {{ic|8086:51f1}} || {{Yes}}
|-
| Ethernet || {{ic|8086:0dc6}} || {{Yes}}
|-
| モバイルブロードバンド || || {{Y|未テスト}}
|-
| 指紋認証リーダー || || {{Yes}}
|-
| スマートカードリーダー || || {{Y|未テスト}}
|}

Lenovo ThinkPad T14/T14s (Intel) Gen 4 は 2023年5月に登場した。14インチディスプレイ、第13世代 Intel Core プロセッサ、統合型 Intel Iris Xe グラフィックスを搭載している。カーネル >=6.11.6 でほぼすべての機能がそのまま動作します。

この機種であることを確認するには、{{Pkg|dmidecode}} をインストールし、以下を実行して下さい:

{{hc|# dmidecode -s system-version|ThinkPad T14 Gen 4}}

ノートパソコン関連記事と推奨事項の概要は [[ノートパソコン]] を参照。

== インストール ==

=== Intel Turbo Boost Max ===

Intel® Turbo Boost Max Technology 3.0 が有効になっているか確認する:

$ cat /sys/devices/system/cpu/intel_pstate/no_turbo

出力が `1` の場合は無効になっているので、BIOS をデフォルトにリセットする必要があります。リセット後に再度コマンドを実行すると `0` が出力されるはずです。
その後、CPU が高クロックまでブーストしているのを確認できます。

=== サウンド ===

この機種の内蔵サウンドカードは [https://wiki.archlinux.org/title/Advanced_Linux_Sound_Architecture#Firmware Sound Open Firmware] が必要です。

== ファームウェア ==

=== fwupd ===

[[fwupd]] は UEFI BIOS、NVMe SSD、Embedded Controller、Intel Management Engine のアップデートをそのままサポートしています。

== ファンクションキー ==

{| class="wikitable"
! Key !! Visible?1 !! Marked?2 !! Effect
|-
| {{ic|Fn+Esc}} || {{No}} || {{Yes}} || Enables Fn lock
|-
| {{ic|Fn}} || {{Yes}} || {{Yes}} || {{ic|XF86WakeUp}}
|-
| {{ic|Fn+F1}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMute}}
|-
| {{ic|Fn+F2}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioLowerVolume}}
|-
| {{ic|Fn+F3}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioRaiseVolume}}
|-
| {{ic|Fn+F4}} || {{Yes}} || {{Yes}} || {{ic|XF86AudioMicMute}}
|-
| {{ic|Fn+F5}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessDown}}
|-
| {{ic|Fn+F6}} || {{Yes}} || {{Yes}} || {{ic|XF86MonBrightnessUp}}
|-
| {{ic|Fn+F7}} || {{Yes}} || {{Yes}} || {{ic|XF86Display}}
|-
| {{ic|Fn+F8}} || {{Yes}} || {{Yes}} || {{ic|XF86WLAN}}
|-
| {{ic|Fn+F9}} || {{Yes}} || {{Yes}} || {{ic|XF86Messenger}}
|-
| {{ic|Fn+F10}} || {{Yes}} || {{Yes}} || {{ic|XF86Go}}
|-
| {{ic|Fn+F11}} || {{Yes}} || {{Yes}} || {{ic|Cancel}}
|-
| {{ic|Fn+F12}} || {{Yes}} || {{Yes}} || {{ic|XF86Favorites}}
|-
| {{ic|Fn+Space}} || {{No}} || {{Yes}} || Toggle keyboard backlight3
|}

# {{ic|wev}} などのツールでキー入力が可視化できるかどうか。
# キーキャップにその機能を示すシンボルが印字されているかどうか。
# そのまま動作するが、ソフトウェア制御も可能。

== モバイルブロードバンド ==

[[NetworkManager#Mobile broadband support]] を参照。

== 関連項目 ==

=== T14 リンク ===

* [https://ubuntu.com/certified/202303-31392](https://ubuntu.com/certified/202303-31392)

Neovim

2025-09-01T09:44:57Z

Kgx: /* ヒントとテクニック */ 同期

[[Category:開発]]
[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[en:Neovim]]
[[es:Neovim]]
[[pl:Neovim]]
[[pt:Neovim]]
[[zh-hans:Neovim]]
[https://neovim.io/ Neovim] は、コードベースの改善を目的とした [[Vim]] のフォークであり、API の実装を容易にし、ユーザーエクスペリエンスとプラグインの実装を向上させます。Neovim は [[Helix]] のようなエディターに影響を与えました。

== インストール ==

{{Pkg|neovim}} パッケージを [[インストール]] または最新の開発バージョンの場合は {{Aur|neovim-nightly-bin}} を選択して下さい。メインの設定言語として {{Pkg|lua}} を使用することが強く推奨されます。
システムクリップボードを Neovim で動作させるには、{{Pkg|xclip}} (X11) または {{Pkg|wl-clipboard}} (Wayland) をインストールする必要があります。

{{Note|neovim では、一部の機能が外部 ''プロバイダ'' に委任されます。Python プロバイダの場合は、{{Pkg|python-pynvim}} を使用します。
クリップボードプロバイダの場合は、[https://neovim.io/doc/user/provider.html#provider-clipboard provider-clipbood] または {{ic|:help provider-clipboard}} neovim コマンドを参照してください。}}

また、[https://github.com/neovim/neovim/wiki/Related-projects 多くの GUI およびその他の関連プロジェクト] のいずれかをインストールすることもできます (大部分は [[公式リポジトリ]] または [[AUR]] にあります。)

* {{App|{{Pkg|neovim-qt}}|高速、軽量、カスタマイズ可能な Qt GUI 複数のタブ、分割ウィンドウ、カスタマイズ可能なテーマのサポートを含む、最新のインターフェイスを提供します。|https://github.com/equalsraf/neovim-qt|{{Pkg|neovim-qt}}}}
* {{App|{{AUR|neovim-gtk}}|GTK GUI 分割ウィンドウ、複数のタブ、カスタマイズ可能なテーマのサポートを含む、最新のカスタマイズ可能なインターフェイスを提供します。|https://github.com/Lyude/neovim-gtk|{{AUR|neovim-gtk}}, {{AUR|neovim-gtk-git}}}}
* {{App|{{AUR|uivonim-git}}|([https://aur.archlinux.org/packages/uibonim-git#comment-888471 Inactive]) シンプルで軽量な GTK GUI 分割ウィンドウやカスタマイズ可能なテーマのサポートなど、最小限のインターフェイスを提供します。|{{AUR|uivonim-git}}|{{AUR|uivonim-git}}}}
* {{App|{{Pkg|neovide}}|Rust GUI.|https://github.com/neovide/neovide|{{Pkg|neovide}}, {{AUR|neovide-git}}}}
* {{App|{{AUR|neoray-git}}|Go GUI.|https://github.com/hismailbulut/neoray|{{AUR|neoray-git}}}}
* {{App|{{AUR|gnvim}}|GTK GUI.|https://github.com/vhakulinen/gnvim|{{AUR|gnvim}}}}
* {{App|{{AUR|fvim}}|F# GUI.|https://github.com/yatli/fvim|{{AUR|fvim}}}}

== 設定 ==

Neovim のユーザ固有の設定ファイルは {{ic|$XDG_CONFIG_HOME/nvim/init.vim}} にあり、デフォルトでは {{ic|~/.config/nvim/init.vim}} です。グローバルコンフィグレーションファイルが、存在する場合は {{ic|$XDG_CONFIG_DIRS/nvim/sysinit.vim}} デフォルトでは {{ic|/etc/xdg/nvim/sysinit.vim}} から、存在しない場合は {{ic|/usr/share/nvim/sysinit.vim}} からロードされます。このファイルは、ユーザが編集することはできません。[https://github.com/neovim/neovim/blob/master/runtime/doc/starting.txt#L437] デフォルトでは、以前のグローバルコンフィグレーションファイルは存在しません。前者のファイルを作成する場合、 pacman でインストールされた vim パッケージを Neovim で動作させる機能が必要な場合は、後者をソースにすることもできます。

Neovim は Vimのほとんどのオプションと互換性がありますが、 Neovim 固有のオプションもあります。 Neovim のオプションの完全なリストについては、 Neovim の [https://neovim.io/doc/user/options.html help file] を参照してください。

Neovim のデータディレクトリは {{ic|~/.local/share/nvim/}} にあり、開いているファイルのスワップ、 [https://neovim.io/doc/user/starting.html#shada ShaDa] (共有データ) ファイル、プラグインのサイトディレクトリが含まれています。

Nvim のバージョン 0.5 から Lua を使って Nvim を設定することができるようになりました。現在の設定を変換する方法については、[https://github.com/nanotee/nvim-lua-guide] を参照してください。現時点では、{{ic|init.lua}} と一般的な {{ic|init.vim}} を比較した場合、あまり大きなメリットはありませんが、正しく設定すれば、Lua は起動時間を少し改善しますし、設定が簡単なので、Lua で書かれたプラグインをいくつか使う場合に特に有用です。

=== vim からの移行 ===

既存の Vim の設定を Nvim に移行したい場合は、{{ic|~/.vimrc}} を {{ic|~/.config/nvim/init.vim}} にコピーするだけす。
該当する場合は、{{ic|~/.vim/autoload/}} の内容を {{ic|~/.local/share/nvim/site/autoload/}} にコピーしてください。

=== vim と nvim の間の共有設定 ===

Neovimは、メイン設定ディレクトリとして {{ic|~/.vim}} の代わりに {{ic|$XDG_CONFIG_HOME/nvim}} を使用し、メイン設定ファイルとして {{ic|~/.vimrc}} の代わりに {{ic|$XDG_CONFIG_HOME/nvim/init.vim}} を使用します。

vim を使い続けたい場合や、Neovim で既存の vim 構成をソース化したい場合は、 [https://neovim.io/doc/user/nvim.html#nvim-from-vim nvim-from-vim] または {{ic|:help nvim-from-vim}} neovim コマンドを参照して下さい。

==== プラグインのロード ====

[[公式リポジトリ]] や [[AUR]] からインストールした Vim/Nvim プラグインは自動的に {{ic|/etc/xdg/nvim/sysinit.vim}} でソースを取得するので、余計な手順を踏む必要はありません。膨大な数のプラグインが両方の場所で見つかりますが、プラグインを追加する最も推奨される方法はプラグインマネージャを使うことです。最もよく使われるのは、Vim と Nvim の両方で使える [https://github.com/junegunn/vim-plug vim-plug] とと Nvim のみで動作する Lua で書かれた [https://github.com/folke/lazy.nvim lazy.nvim] です。どちらも github ブランチからランタイムコマンドまで、柔軟な設定が可能です。

vim 用に書かれたプラグインのほとんどは Nvim でも問題なく動作しますが、Nvim 用に書かれたプラグインのすべてが Vim で動作するわけではないので、互換性のある設定を確保したい場合は、従来の {{ic|init.vim}} や {{ic|.vimrc}} を使ってください。

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

=== vi や vim を neovim で置き換える ===

{{ic|$VISUAL}} と {{ic|$EDITOR}} [[環境変数]]を設定することで大抵の場合に neovim が使われるようになります。

一部のアプリケーションでは vi や vim がデフォルトエディタとしてハードコードされていますが、{{AUR|neovim-drop-in}} をインストールすることで ''neovim'' を使うことができます。

=== init.vim から .vimrc にシンボリックリンクを作成 ===

neovim は標準 vim と互換性を保っているため、{{ic|nvim/init.vim}} から {{ic|.vimrc}} にシンボリックリンクを張ることで設定オプションをそのまま使うことができます:

$ ln -s ~/.vimrc ~/.config/nvim/init.vim

neovim と vim の設定を分けたい場合、{{ic|.vimrc}} ファイルの中で {{ic|if}} ブロックを使うことでどちらかにだけ適用される設定を記述できます:

if has('nvim')
" Neovim specific commands
else
" Standard vim specific commands
endif

=== True color のサポート ===

[https://github.com/carlowood/nneovim-true-color-scheme-editor このプロジェクト] の {{ic|READMEs}} では、構文の強調表示に24ビットの ''TrueColor'' サポートを追加する方法と、カラーピッカーを使用してリアルタイムでどのように表示されるかを確認する方法について説明しています。C++ 用の作者のシンタックスハイライト (インストールしている場合) が付属しています。

=== カーソルの最後の位置をサポート ===

カーソルの最後の位置を保存したい場合は、[https://github.com/neovim/neovim/issues/16339#issuecomment-1348133829 lastplace.lua] が非常に便利です。 {{ic|~/.config/nvim/plugin/}} またはシステム全体のディレクトリ {{ic|/usr/share/nvim/runtime/plugin/}} に配置する必要があります。

=== 言語サーバープロトコル (LSP) ===

Neovim には、組み込みの [https://microsoft.github.io/language-server-protocol Language Server Protocol] クライアントが含まれており [https://github.com/neovim/nvim-lspconfig nvim-lspconfig] プラグインは、その共通設定を提供します。

Arch パッケージのリストについては、[[言語サーバープロトコル]] を参照してください。

=== ページャとして使用 ===

マニュアルページを開くには {{ic|:Man}} コマンドを使います。neovim ですべてのマニュアルページを開くには、{{ic|MANPAGER}} [[環境変数]] を {{ic|nvim +Man!}} に設定します。

他のページャをサポートするには {{AUR|nvimpager}} か {{AUR|nvimpager-git}} パッケージをインストールし、{{ic|PAGER}} [[環境変数]] を {{ic|nvimpager}} に設定します。

{{AUR|page-git}} でパッケージされている [https://github.com/I60R/page page] も試してみてください。

=== 複数の nvim 設定を並行して利用する ===

[https://neovim.io/doc/user/starting.html#%24NVIM_APPNAME NVIM_APPNAME] 環境変数を使うことで、複数の nvim フレーバーを並行してインストールして利用することができます。
{{ic|XDG_CONFIG_HOME}} 内にディレクトリを作成し、例として {{ic|~/.config/foo}} に新しい nvim 設定を置きます。

特定の設定で ''nvim'' を実行するには:

* シェルや設定ファイルで直接 {{ic|NVIM_APPNAME}} 変数を設定します: {{ic|1=export NVIM_APPNAME=foo}} これにより {{ic|nvim}} コマンドが自動的に ''foo'' フレーバーを呼び出すようになります。デフォルトの動作に戻すには {{ic|unset NVIM_APPNAME}} を実行してください。
* エイリアスを定義する方法もあります。例: {{ic|1=alias v=' NVIM_APPNAME=foo nvim'}}

==== ネイティブの nvim 設定と並行して LazyVim をインストールする ====

人気のある [https://www.lazyvim.org/ LazyVim] フレーバーを ''ネイティブ'' の nvim 設定と並行してインストールしたい場合は、[https://www.lazyvim.org/installation インストール手順] に従ってください。
ただし実際の nvim 設定ディレクトリである {{ic|~/.config/nvim}}, {{ic|~/.local/share/nvim}}, {{ic|~/.local/state/nvim}}, {{ic|~/.cache/nvim}} を削除または移動する必要はありません。

代わりに、スタータリポジトリを {{ic|.config}} パス内のお好みのディレクトリ名にクローンしてください。以下のコマンドでは {{ic|nvimLazyvim}} というディレクトリ名を例としています:

$ git clone https://github.com/LazyVim/starter ~/.config/nvimLazyvim

{{ic|.git}} ディレクトリを削除するのを忘れないでください:

$ rm -rf ~/.config/nvimLazyvim/.git

新しい ''フレーバー'' を起動するには次のコマンドを使います:

$ NVIM_APPNAME=nvimLazyvim nvim

入力を短縮するために、{{ic|.bashrc}} または {{ic|.zshrc}} に以下の行を追加してエイリアスを作成できます:

{{hc|.zshrc|2=
alias v=' NVIM_APPNAME=nvimLazyvim nvim'
}}

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

=== Neovim を終了してもカーソルが元に戻らない ===

Neovim の終了後もカーソルが点滅してしまう場合は [https://github.com/neovim/neovim/wiki/FAQ#cursor-style-isnt-restored-after-exiting-nvim neovim FAQ] の解決方法を見てください。

=== システムアップグレード後の Tree-sitter パーサーエラー ===

システムを更新した後は、{{ic|:Lazy sync}} などを使用して Neovim のパッケージを同期し、{{ic|:TSUpdate}} を使用して手動でパーサーを強制的に更新することをお勧めします。{{ic|~/.local/share/nvim}} にある Neovim のキャッシュファイルを削除すると、問題が解決する場合があります。

=== Tree-sitter executable not found ===

{{Pkg|tree-sitter}} パッケージはライブラリのみを提供します。''tree-sitter'' 実行ファイルが必要な場合は、{{Pkg|tree-sitter-cli}} をインストールしてください。

== 参照 ==

* [https://github.com/neovim/neovim Github リポジトリ]
* [https://github.com/neovim/neovim/wiki Github wiki]

Neovim

2025-09-01T09:40:30Z

Kgx: /* トラブルシューティング */ 同期

[[Category:開発]]
[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[en:Neovim]]
[[es:Neovim]]
[[pl:Neovim]]
[[pt:Neovim]]
[[zh-hans:Neovim]]
[https://neovim.io/ Neovim] は、コードベースの改善を目的とした [[Vim]] のフォークであり、API の実装を容易にし、ユーザーエクスペリエンスとプラグインの実装を向上させます。Neovim は [[Helix]] のようなエディターに影響を与えました。

== インストール ==

{{Pkg|neovim}} パッケージを [[インストール]] または最新の開発バージョンの場合は {{Aur|neovim-nightly-bin}} を選択して下さい。メインの設定言語として {{Pkg|lua}} を使用することが強く推奨されます。
システムクリップボードを Neovim で動作させるには、{{Pkg|xclip}} (X11) または {{Pkg|wl-clipboard}} (Wayland) をインストールする必要があります。

{{Note|neovim では、一部の機能が外部 ''プロバイダ'' に委任されます。Python プロバイダの場合は、{{Pkg|python-pynvim}} を使用します。
クリップボードプロバイダの場合は、[https://neovim.io/doc/user/provider.html#provider-clipboard provider-clipbood] または {{ic|:help provider-clipboard}} neovim コマンドを参照してください。}}

また、[https://github.com/neovim/neovim/wiki/Related-projects 多くの GUI およびその他の関連プロジェクト] のいずれかをインストールすることもできます (大部分は [[公式リポジトリ]] または [[AUR]] にあります。)

* {{App|{{Pkg|neovim-qt}}|高速、軽量、カスタマイズ可能な Qt GUI 複数のタブ、分割ウィンドウ、カスタマイズ可能なテーマのサポートを含む、最新のインターフェイスを提供します。|https://github.com/equalsraf/neovim-qt|{{Pkg|neovim-qt}}}}
* {{App|{{AUR|neovim-gtk}}|GTK GUI 分割ウィンドウ、複数のタブ、カスタマイズ可能なテーマのサポートを含む、最新のカスタマイズ可能なインターフェイスを提供します。|https://github.com/Lyude/neovim-gtk|{{AUR|neovim-gtk}}, {{AUR|neovim-gtk-git}}}}
* {{App|{{AUR|uivonim-git}}|([https://aur.archlinux.org/packages/uibonim-git#comment-888471 Inactive]) シンプルで軽量な GTK GUI 分割ウィンドウやカスタマイズ可能なテーマのサポートなど、最小限のインターフェイスを提供します。|{{AUR|uivonim-git}}|{{AUR|uivonim-git}}}}
* {{App|{{Pkg|neovide}}|Rust GUI.|https://github.com/neovide/neovide|{{Pkg|neovide}}, {{AUR|neovide-git}}}}
* {{App|{{AUR|neoray-git}}|Go GUI.|https://github.com/hismailbulut/neoray|{{AUR|neoray-git}}}}
* {{App|{{AUR|gnvim}}|GTK GUI.|https://github.com/vhakulinen/gnvim|{{AUR|gnvim}}}}
* {{App|{{AUR|fvim}}|F# GUI.|https://github.com/yatli/fvim|{{AUR|fvim}}}}

== 設定 ==

Neovim のユーザ固有の設定ファイルは {{ic|$XDG_CONFIG_HOME/nvim/init.vim}} にあり、デフォルトでは {{ic|~/.config/nvim/init.vim}} です。グローバルコンフィグレーションファイルが、存在する場合は {{ic|$XDG_CONFIG_DIRS/nvim/sysinit.vim}} デフォルトでは {{ic|/etc/xdg/nvim/sysinit.vim}} から、存在しない場合は {{ic|/usr/share/nvim/sysinit.vim}} からロードされます。このファイルは、ユーザが編集することはできません。[https://github.com/neovim/neovim/blob/master/runtime/doc/starting.txt#L437] デフォルトでは、以前のグローバルコンフィグレーションファイルは存在しません。前者のファイルを作成する場合、 pacman でインストールされた vim パッケージを Neovim で動作させる機能が必要な場合は、後者をソースにすることもできます。

Neovim は Vimのほとんどのオプションと互換性がありますが、 Neovim 固有のオプションもあります。 Neovim のオプションの完全なリストについては、 Neovim の [https://neovim.io/doc/user/options.html help file] を参照してください。

Neovim のデータディレクトリは {{ic|~/.local/share/nvim/}} にあり、開いているファイルのスワップ、 [https://neovim.io/doc/user/starting.html#shada ShaDa] (共有データ) ファイル、プラグインのサイトディレクトリが含まれています。

Nvim のバージョン 0.5 から Lua を使って Nvim を設定することができるようになりました。現在の設定を変換する方法については、[https://github.com/nanotee/nvim-lua-guide] を参照してください。現時点では、{{ic|init.lua}} と一般的な {{ic|init.vim}} を比較した場合、あまり大きなメリットはありませんが、正しく設定すれば、Lua は起動時間を少し改善しますし、設定が簡単なので、Lua で書かれたプラグインをいくつか使う場合に特に有用です。

=== vim からの移行 ===

既存の Vim の設定を Nvim に移行したい場合は、{{ic|~/.vimrc}} を {{ic|~/.config/nvim/init.vim}} にコピーするだけす。
該当する場合は、{{ic|~/.vim/autoload/}} の内容を {{ic|~/.local/share/nvim/site/autoload/}} にコピーしてください。

=== vim と nvim の間の共有設定 ===

Neovimは、メイン設定ディレクトリとして {{ic|~/.vim}} の代わりに {{ic|$XDG_CONFIG_HOME/nvim}} を使用し、メイン設定ファイルとして {{ic|~/.vimrc}} の代わりに {{ic|$XDG_CONFIG_HOME/nvim/init.vim}} を使用します。

vim を使い続けたい場合や、Neovim で既存の vim 構成をソース化したい場合は、 [https://neovim.io/doc/user/nvim.html#nvim-from-vim nvim-from-vim] または {{ic|:help nvim-from-vim}} neovim コマンドを参照して下さい。

==== プラグインのロード ====

[[公式リポジトリ]] や [[AUR]] からインストールした Vim/Nvim プラグインは自動的に {{ic|/etc/xdg/nvim/sysinit.vim}} でソースを取得するので、余計な手順を踏む必要はありません。膨大な数のプラグインが両方の場所で見つかりますが、プラグインを追加する最も推奨される方法はプラグインマネージャを使うことです。最もよく使われるのは、Vim と Nvim の両方で使える [https://github.com/junegunn/vim-plug vim-plug] とと Nvim のみで動作する Lua で書かれた [https://github.com/folke/lazy.nvim lazy.nvim] です。どちらも github ブランチからランタイムコマンドまで、柔軟な設定が可能です。

vim 用に書かれたプラグインのほとんどは Nvim でも問題なく動作しますが、Nvim 用に書かれたプラグインのすべてが Vim で動作するわけではないので、互換性のある設定を確保したい場合は、従来の {{ic|init.vim}} や {{ic|.vimrc}} を使ってください。

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

=== vi や vim を neovim で置き換える ===

{{ic|$VISUAL}} と {{ic|$EDITOR}} [[環境変数]]を設定することで大抵の場合に neovim が使われるようになります。

一部のアプリケーションでは vi や vim がデフォルトエディタとしてハードコードされていますが、{{AUR|neovim-drop-in}} をインストールすることで ''neovim'' を使うことができます。

=== init.vim から .vimrc にシンボリックリンクを作成 ===

neovim は標準 vim と互換性を保っているため、{{ic|nvim/init.vim}} から {{ic|.vimrc}} にシンボリックリンクを張ることで設定オプションをそのまま使うことができます:

$ ln -s ~/.vimrc ~/.config/nvim/init.vim

neovim と vim の設定を分けたい場合、{{ic|.vimrc}} ファイルの中で {{ic|if}} ブロックを使うことでどちらかにだけ適用される設定を記述できます:

if has('nvim')
" Neovim specific commands
else
" Standard vim specific commands
endif

=== True color のサポート ===

[https://github.com/carlowood/nneovim-true-color-scheme-editor このプロジェクト] の {{ic|READMEs}} では、構文の強調表示に24ビットの ''TrueColor'' サポートを追加する方法と、カラーピッカーを使用してリアルタイムでどのように表示されるかを確認する方法について説明しています。C++ 用の作者のシンタックスハイライト (インストールしている場合) が付属しています。

=== カーソルの最後の位置をサポート ===

カーソルの最後の位置を保存したい場合は、[https://github.com/neovim/neovim/issues/16339#issuecomment-1348133829 lastplace.lua] が非常に便利です。 {{ic|~/.config/nvim/plugin/}} またはシステム全体のディレクトリ {{ic|/usr/share/nvim/runtime/plugin/}} に配置する必要があります。

=== 言語サーバープロトコル (LSP) ===

Neovim には、組み込みの [https://microsoft.github.io/language-server-protocol Language Server Protocol] クライアントが含まれており [https://github.com/neovim/nvim-lspconfig nvim-lspconfig] プラグインは、その共通設定を提供します。

Arch パッケージのリストについては、[[言語サーバープロトコル]] を参照してください。

=== ページャとして使用 ===

マニュアルページを開くには {{ic|:Man}} コマンドを使います。neovim ですべてのマニュアルページを開くには、{{ic|MANPAGER}} [[環境変数]] を {{ic|nvim +Man!}} に設定します。

他のページャをサポートするには {{AUR|nvimpager}} か {{AUR|nvimpager-git}} パッケージをインストールし、{{ic|PAGER}} [[環境変数]] を {{ic|nvimpager}} に設定します。

{{AUR|page-git}} でパッケージされている [https://github.com/I60R/page page] も試してみてください。

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

=== Neovim を終了してもカーソルが元に戻らない ===

Neovim の終了後もカーソルが点滅してしまう場合は [https://github.com/neovim/neovim/wiki/FAQ#cursor-style-isnt-restored-after-exiting-nvim neovim FAQ] の解決方法を見てください。

=== システムアップグレード後の Tree-sitter パーサーエラー ===

システムを更新した後は、{{ic|:Lazy sync}} などを使用して Neovim のパッケージを同期し、{{ic|:TSUpdate}} を使用して手動でパーサーを強制的に更新することをお勧めします。{{ic|~/.local/share/nvim}} にある Neovim のキャッシュファイルを削除すると、問題が解決する場合があります。

=== Tree-sitter executable not found ===

{{Pkg|tree-sitter}} パッケージはライブラリのみを提供します。''tree-sitter'' 実行ファイルが必要な場合は、{{Pkg|tree-sitter-cli}} をインストールしてください。

== 参照 ==

* [https://github.com/neovim/neovim Github リポジトリ]
* [https://github.com/neovim/neovim/wiki Github wiki]

Virt-Manager

2025-08-23T05:48:15Z

Kgx: /* ネットワーク */

[[Category:仮想化]]
[[en:Virt-Manager]]
[[pt:Virt-Manager]]
[[Wikipedia:ja:Virt-manager|virt-manager]] は [[libvirt]] ライブラリのグラフィカルフロントエンドであり、仮想マシンの管理機能を提供します。
virt-manager のインターフェースを使えば、ユーザーはターミナルを使わずに仮想マシンを作成・削除・操作できます。

virt-manager は主に KVM をサポートしているが、Xen や LXC といった他のハイパーバイザーでも動作可能。

== インストール ==

まず [[libvirt]] または [[LXC]] のページを参照し、仮想マシンを作成できることを確認します。その後 {{Pkg|virt-manager}} パッケージを[[インストール]] して下さい。
必要に応じて [[QEMU]] もインストールして下さい。

{{ic|LXC}} 接続を使用する場合は {{ic|libvirtd.service}} ユニットを [[有効化/起動]] します。

{{ic|QEMU}} 接続を使用する場合は {{ic|libvirtd.socket}} ユニットを [[有効化/起動]] します。

サービスが実行中かどうかは [[ユニットステータス]] で確認できます。

{{Note|ドメインの [https://www.libvirt.org/manpages/virsh.html#autostart 自動起動機能] を使用するには、{{ic|libvirtd.service}} を有効にする必要があります。}}

== 設定 ==

=== 基本設定 ===

自分を ''libvirt'' [[ユーザーグループ]] に追加して下さい。

また、virt-manager のデフォルトプール外にあるファイルやフォルダを利用する場合、それらの所有者を {{ic|libvirt-qemu}} グループに設定しておくとよいでしょう。そうしないと、アクセス時にパーミッションエラーが発生する可能性があります。

# chown "$USER":libvirt-qemu ''/path/to/vm/folder''

{{Tip|他にも解決方法はあります。もし忘れても virt-manager が権限変更を提案してくれます。}}

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

=== Socket を使わない非 root KVM ===

{{Note|[[systemd]] のソケットを有効化するとこの設定は上書きされるので、ソケットを有効化したくない場合にのみ行ってください。}}

root 権限のない通常のユーザーとして使用するには、KVM を設定する必要があります。これにより、libvirt ネットワークコンポーネントも有効になります。

次のように変更して、UNIX ドメインソケットの所有権を libvirt に設定し、UNIX ソケットの権限を読み取りと書き込みに設定します:

{{hc|/etc/libvirt/libvirtd.conf|2=
...
unix_sock_group = 'libvirt'
...
unix_sock_rw_perms = '0770'
...
}}

自分を ''libvirt'' [[ユーザーグループ]] に追加する。

さらに {{ic|/etc/libvirt/qemu.conf}} に自分のユーザーを設定します。設定しないと QEMU がローカルディスクにアクセスする際に permission denied となります。

{{ic|1=user = "libvirt-qemu"}} または {{ic|1=group = "libvirt-qemu"}} を検索し、両方のエントリのコメントを解除して、{{ic|libvirt-qemu}} を自分のユーザー名またはIDに変更してください。編集後、以下のようになります。

{{hc|/etc/libvirt/qemu.conf|2=
# Some examples of valid values are:
#
# user = "qemu" # A user named "qemu"
# user = "+0" # Super user (uid=0)
# user = "100" # A user named "100" or a user with uid=100
#
user = "''username''"

# The group for QEMU processes run by the system instance. It can be
# specified in a similar way to user.
group = "''username''"
}}

Virt-Manager を開くと、QEMU 接続のシステムバリアント (root) がデフォルトになります。

これをユーザー接続に変更するには、''ファイル'' > ''接続の追加'' に移動します。

次に、ハイパーバイザーとして {{ic|QEMU/KVM ユーザーセッション}} を選択し、[OK] をクリックします。
これにより、ユーザーセッションに自動接続されます。必要に応じて、システム接続を切断して削除することもできます。

=== ネットワーク ===

{{Note|
*記事は '''ユーザーセッション''' での virt-manager と libvirt の利用に焦点を当てていますが、ユーザーセッションにはネットワーク機能の制限があります。(詳細は [https://wiki.libvirt.org/FAQ.html#what-is-the-difference-between-qemu-system-and-qemu-session-which-one-should-i-use libvirt の FAQ を参照してください。)]
*ネットワークの問題の場合は、[[libvirt]] も参照してください。}}

ユーザーセッションでネットワークブリッジを使用するには、まず {{ic|libvirt}} システム管理で設定する必要があります。

このためには、{{ic|libvirt}} [[libvirt#Daemon|デーモン]] が実行されている必要があります。

正常に起動すると、QEMU 接続のシステムバリアント (root) が virt-managerで開きます。ネットワークタブで必要な設定を行い、ブリッジを設定してください。

ユーザーセッション仮想マシンでブリッジを使用できるようにするには、ブリッジの設定に応じて [[QEMU#Bridged networking using qemu-bridge-helper|qemu-bridge-helper]] を設定します。

その後、ブリッジは、virt-manager ユーザーセッションで実行される仮想ネットワークで使用できるようになります。

==== NAT - Bridged - Host-Only====

===== NAT =====

NAT は同じ IP 経由で VM をルーティングします。このオプションはハードウェアの表示 -> NIC で使用でき、追加の設定は必要ありません。

===== Bridged =====

ブリッジモードでは、VM がネットワーク内の独自のクライアントであるかのように動作します。
virt-manager では、インターフェースを選択する必要があります。

これは、自動的に選択される virtualbox や vmware とは異なります。
Bridged を使用するには、NAT を使用して [[#仮想インターフェースの作成|仮想インターフェース]] を作成する必要があります。

(独自のインターフェースを使用することも可能ですが、追加の設定が必要になる場合があります。)

===== Host-Only =====

ホストのみの設定では、ホストとゲスト間のネットワーク操作のみが許可されます。

このオプションは virt-manager には存在しません。
代わりに、仮想分離ネットワークに接続されたブリッジを使用する必要があります。[[#仮想インターフェースの作成]] を参照してください。

=== 接続の詳細 ===

==== 仮想インターフェースの作成 ====

編集 → 接続の詳細 → 追加へ進みます。

以下のオプションが利用可能です:

NAT, Routed, Open, Isolated, SR-IOV Pool

=== 3Dアクセラレーション ===

virtio は準仮想化 3D グラフィックドライバです。基本的な 3D アクセラレーションを有効にするには、以下の手順を実行してください。

# 仮想マシンの設定ページに移動します。
# "ハードウェアの追加" ボタンをクリックし、"ビデオ" を選択し、"モデル" で "Virtio" を選択します。その後、サイドバー内の他の "ビデオ" 仮想ハードウェアを削除します。
# "Display Spice" に移動し、"Listen Type" を "None" に設定します。また、"OpenGL" チェックボックスをオンにして、適切なレンダラーを選択します。
# "Video Virtio" をクリックし、"3D Acceleration" にチェックを入れます。

{{Pkg|mesa-utils}} パッケージの ''glxgears'' を使用して 3D グラフィックスをテストできます。{{ic|glxgears -info}} はコンソールに OpenGL レンダラー情報を表示します。

== 参照 ==

* [https://virt-manager.org Project homepage]
* [https://github.com/virt-manager/virt-manager Project repository]
* [https://www.spice-space.org/download.html Spice drivers (graphics)]
* [https://github.com/virtio-win/virtio-win-pkg-scripts/blob/master/README.md VirtIO Windows drivers]

Virt-Manager

2025-08-23T05:47:28Z

Kgx: /* ネットワーク */ リンクを修正

[[Category:仮想化]]
[[en:Virt-Manager]]
[[pt:Virt-Manager]]
[[Wikipedia:ja:Virt-manager|virt-manager]] は [[libvirt]] ライブラリのグラフィカルフロントエンドであり、仮想マシンの管理機能を提供します。
virt-manager のインターフェースを使えば、ユーザーはターミナルを使わずに仮想マシンを作成・削除・操作できます。

virt-manager は主に KVM をサポートしているが、Xen や LXC といった他のハイパーバイザーでも動作可能。

== インストール ==

まず [[libvirt]] または [[LXC]] のページを参照し、仮想マシンを作成できることを確認します。その後 {{Pkg|virt-manager}} パッケージを[[インストール]] して下さい。
必要に応じて [[QEMU]] もインストールして下さい。

{{ic|LXC}} 接続を使用する場合は {{ic|libvirtd.service}} ユニットを [[有効化/起動]] します。

{{ic|QEMU}} 接続を使用する場合は {{ic|libvirtd.socket}} ユニットを [[有効化/起動]] します。

サービスが実行中かどうかは [[ユニットステータス]] で確認できます。

{{Note|ドメインの [https://www.libvirt.org/manpages/virsh.html#autostart 自動起動機能] を使用するには、{{ic|libvirtd.service}} を有効にする必要があります。}}

== 設定 ==

=== 基本設定 ===

自分を ''libvirt'' [[ユーザーグループ]] に追加して下さい。

また、virt-manager のデフォルトプール外にあるファイルやフォルダを利用する場合、それらの所有者を {{ic|libvirt-qemu}} グループに設定しておくとよいでしょう。そうしないと、アクセス時にパーミッションエラーが発生する可能性があります。

# chown "$USER":libvirt-qemu ''/path/to/vm/folder''

{{Tip|他にも解決方法はあります。もし忘れても virt-manager が権限変更を提案してくれます。}}

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

=== Socket を使わない非 root KVM ===

{{Note|[[systemd]] のソケットを有効化するとこの設定は上書きされるので、ソケットを有効化したくない場合にのみ行ってください。}}

root 権限のない通常のユーザーとして使用するには、KVM を設定する必要があります。これにより、libvirt ネットワークコンポーネントも有効になります。

次のように変更して、UNIX ドメインソケットの所有権を libvirt に設定し、UNIX ソケットの権限を読み取りと書き込みに設定します:

{{hc|/etc/libvirt/libvirtd.conf|2=
...
unix_sock_group = 'libvirt'
...
unix_sock_rw_perms = '0770'
...
}}

自分を ''libvirt'' [[ユーザーグループ]] に追加する。

さらに {{ic|/etc/libvirt/qemu.conf}} に自分のユーザーを設定します。設定しないと QEMU がローカルディスクにアクセスする際に permission denied となります。

{{ic|1=user = "libvirt-qemu"}} または {{ic|1=group = "libvirt-qemu"}} を検索し、両方のエントリのコメントを解除して、{{ic|libvirt-qemu}} を自分のユーザー名またはIDに変更してください。編集後、以下のようになります。

{{hc|/etc/libvirt/qemu.conf|2=
# Some examples of valid values are:
#
# user = "qemu" # A user named "qemu"
# user = "+0" # Super user (uid=0)
# user = "100" # A user named "100" or a user with uid=100
#
user = "''username''"

# The group for QEMU processes run by the system instance. It can be
# specified in a similar way to user.
group = "''username''"
}}

Virt-Manager を開くと、QEMU 接続のシステムバリアント (root) がデフォルトになります。

これをユーザー接続に変更するには、''ファイル'' > ''接続の追加'' に移動します。

次に、ハイパーバイザーとして {{ic|QEMU/KVM ユーザーセッション}} を選択し、[OK] をクリックします。
これにより、ユーザーセッションに自動接続されます。必要に応じて、システム接続を切断して削除することもできます。

=== ネットワーク ===

{{Note|
*記事は '''ユーザーセッション''' での virt-manager と libvirt の利用に焦点を当てていますが、ユーザーセッションにはネットワーク機能の制限があります。(詳細は [https://wiki.libvirt.org/FAQ.html#what-is-the-difference-between-qemu-system-and-qemu-session-which-one-should-i-use libvirt の FAQ を参照してください。]
*ネットワークの問題の場合は、[[libvirt]] も参照してください。}}

ユーザーセッションでネットワークブリッジを使用するには、まず {{ic|libvirt}} システム管理で設定する必要があります。

このためには、{{ic|libvirt}} [[libvirt#Daemon|デーモン]] が実行されている必要があります。

正常に起動すると、QEMU 接続のシステムバリアント (root) が virt-managerで開きます。ネットワークタブで必要な設定を行い、ブリッジを設定してください。

ユーザーセッション仮想マシンでブリッジを使用できるようにするには、ブリッジの設定に応じて [[QEMU#Bridged networking using qemu-bridge-helper|qemu-bridge-helper]] を設定します。

その後、ブリッジは、virt-manager ユーザーセッションで実行される仮想ネットワークで使用できるようになります。

==== NAT - Bridged - Host-Only====

===== NAT =====

NAT は同じ IP 経由で VM をルーティングします。このオプションはハードウェアの表示 -> NIC で使用でき、追加の設定は必要ありません。

===== Bridged =====

ブリッジモードでは、VM がネットワーク内の独自のクライアントであるかのように動作します。
virt-manager では、インターフェースを選択する必要があります。

これは、自動的に選択される virtualbox や vmware とは異なります。
Bridged を使用するには、NAT を使用して [[#仮想インターフェースの作成|仮想インターフェース]] を作成する必要があります。

(独自のインターフェースを使用することも可能ですが、追加の設定が必要になる場合があります。)

===== Host-Only =====

ホストのみの設定では、ホストとゲスト間のネットワーク操作のみが許可されます。

このオプションは virt-manager には存在しません。
代わりに、仮想分離ネットワークに接続されたブリッジを使用する必要があります。[[#仮想インターフェースの作成]] を参照してください。

=== 接続の詳細 ===

==== 仮想インターフェースの作成 ====

編集 → 接続の詳細 → 追加へ進みます。

以下のオプションが利用可能です:

NAT, Routed, Open, Isolated, SR-IOV Pool

=== 3Dアクセラレーション ===

virtio は準仮想化 3D グラフィックドライバです。基本的な 3D アクセラレーションを有効にするには、以下の手順を実行してください。

# 仮想マシンの設定ページに移動します。
# "ハードウェアの追加" ボタンをクリックし、"ビデオ" を選択し、"モデル" で "Virtio" を選択します。その後、サイドバー内の他の "ビデオ" 仮想ハードウェアを削除します。
# "Display Spice" に移動し、"Listen Type" を "None" に設定します。また、"OpenGL" チェックボックスをオンにして、適切なレンダラーを選択します。
# "Video Virtio" をクリックし、"3D Acceleration" にチェックを入れます。

{{Pkg|mesa-utils}} パッケージの ''glxgears'' を使用して 3D グラフィックスをテストできます。{{ic|glxgears -info}} はコンソールに OpenGL レンダラー情報を表示します。

== 参照 ==

* [https://virt-manager.org Project homepage]
* [https://github.com/virt-manager/virt-manager Project repository]
* [https://www.spice-space.org/download.html Spice drivers (graphics)]
* [https://github.com/virtio-win/virtio-win-pkg-scripts/blob/master/README.md VirtIO Windows drivers]

Virt-Manager

2025-08-23T05:45:06Z

Kgx: 翻訳

[[Category:仮想化]]
[[en:Virt-Manager]]
[[pt:Virt-Manager]]
[[Wikipedia:ja:Virt-manager|virt-manager]] は [[libvirt]] ライブラリのグラフィカルフロントエンドであり、仮想マシンの管理機能を提供します。
virt-manager のインターフェースを使えば、ユーザーはターミナルを使わずに仮想マシンを作成・削除・操作できます。

virt-manager は主に KVM をサポートしているが、Xen や LXC といった他のハイパーバイザーでも動作可能。

== インストール ==

まず [[libvirt]] または [[LXC]] のページを参照し、仮想マシンを作成できることを確認します。その後 {{Pkg|virt-manager}} パッケージを[[インストール]] して下さい。
必要に応じて [[QEMU]] もインストールして下さい。

{{ic|LXC}} 接続を使用する場合は {{ic|libvirtd.service}} ユニットを [[有効化/起動]] します。

{{ic|QEMU}} 接続を使用する場合は {{ic|libvirtd.socket}} ユニットを [[有効化/起動]] します。

サービスが実行中かどうかは [[ユニットステータス]] で確認できます。

{{Note|ドメインの [https://www.libvirt.org/manpages/virsh.html#autostart 自動起動機能] を使用するには、{{ic|libvirtd.service}} を有効にする必要があります。}}

== 設定 ==

=== 基本設定 ===

自分を ''libvirt'' [[ユーザーグループ]] に追加して下さい。

また、virt-manager のデフォルトプール外にあるファイルやフォルダを利用する場合、それらの所有者を {{ic|libvirt-qemu}} グループに設定しておくとよいでしょう。そうしないと、アクセス時にパーミッションエラーが発生する可能性があります。

# chown "$USER":libvirt-qemu ''/path/to/vm/folder''

{{Tip|他にも解決方法はあります。もし忘れても virt-manager が権限変更を提案してくれます。}}

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

=== Socket を使わない非 root KVM ===

{{Note|[[systemd]] のソケットを有効化するとこの設定は上書きされるので、ソケットを有効化したくない場合にのみ行ってください。}}

root 権限のない通常のユーザーとして使用するには、KVM を設定する必要があります。これにより、libvirt ネットワークコンポーネントも有効になります。

次のように変更して、UNIX ドメインソケットの所有権を libvirt に設定し、UNIX ソケットの権限を読み取りと書き込みに設定します:

{{hc|/etc/libvirt/libvirtd.conf|2=
...
unix_sock_group = 'libvirt'
...
unix_sock_rw_perms = '0770'
...
}}

自分を ''libvirt'' [[ユーザーグループ]] に追加する。

さらに {{ic|/etc/libvirt/qemu.conf}} に自分のユーザーを設定します。設定しないと QEMU がローカルディスクにアクセスする際に permission denied となります。

{{ic|1=user = "libvirt-qemu"}} または {{ic|1=group = "libvirt-qemu"}} を検索し、両方のエントリのコメントを解除して、{{ic|libvirt-qemu}} を自分のユーザー名またはIDに変更してください。編集後、以下のようになります。

{{hc|/etc/libvirt/qemu.conf|2=
# Some examples of valid values are:
#
# user = "qemu" # A user named "qemu"
# user = "+0" # Super user (uid=0)
# user = "100" # A user named "100" or a user with uid=100
#
user = "''username''"

# The group for QEMU processes run by the system instance. It can be
# specified in a similar way to user.
group = "''username''"
}}

Virt-Manager を開くと、QEMU 接続のシステムバリアント (root) がデフォルトになります。

これをユーザー接続に変更するには、''ファイル'' > ''接続の追加'' に移動します。

次に、ハイパーバイザーとして {{ic|QEMU/KVM ユーザーセッション}} を選択し、[OK] をクリックします。
これにより、ユーザーセッションに自動接続されます。必要に応じて、システム接続を切断して削除することもできます。

=== ネットワーク ===

{{Note|
*記事は '''ユーザーセッション''' での virt-manager と libvirt の利用に焦点を当てていますが、ユーザーセッションにはネットワーク機能の制限があります。(詳細は [https://wiki.libvirt.org/FAQ.html#what-is-the-difference-between-qemu-system-and-qemu-session-which-one-should-i-use
*ネットワークの問題の場合は、[[libvirt]] も参照してください。}}

ユーザーセッションでネットワークブリッジを使用するには、まず {{ic|libvirt}} システム管理で設定する必要があります。

このためには、{{ic|libvirt}} [[libvirt#Daemon|デーモン]] が実行されている必要があります。

正常に起動すると、QEMU 接続のシステムバリアント (root) が virt-managerで開きます。ネットワークタブで必要な設定を行い、ブリッジを設定してください。

ユーザーセッション仮想マシンでブリッジを使用できるようにするには、ブリッジの設定に応じて [[QEMU#Bridged networking using qemu-bridge-helper|qemu-bridge-helper]] を設定します。

その後、ブリッジは、virt-manager ユーザーセッションで実行される仮想ネットワークで使用できるようになります。

==== NAT - Bridged - Host-Only====

===== NAT =====

NAT は同じ IP 経由で VM をルーティングします。このオプションはハードウェアの表示 -> NIC で使用でき、追加の設定は必要ありません。

===== Bridged =====

ブリッジモードでは、VM がネットワーク内の独自のクライアントであるかのように動作します。
virt-manager では、インターフェースを選択する必要があります。

これは、自動的に選択される virtualbox や vmware とは異なります。
Bridged を使用するには、NAT を使用して [[#仮想インターフェースの作成|仮想インターフェース]] を作成する必要があります。

(独自のインターフェースを使用することも可能ですが、追加の設定が必要になる場合があります。)

===== Host-Only =====

ホストのみの設定では、ホストとゲスト間のネットワーク操作のみが許可されます。

このオプションは virt-manager には存在しません。
代わりに、仮想分離ネットワークに接続されたブリッジを使用する必要があります。[[#仮想インターフェースの作成]] を参照してください。

=== 接続の詳細 ===

==== 仮想インターフェースの作成 ====

編集 → 接続の詳細 → 追加へ進みます。

以下のオプションが利用可能です:

NAT, Routed, Open, Isolated, SR-IOV Pool

=== 3Dアクセラレーション ===

virtio は準仮想化 3D グラフィックドライバです。基本的な 3D アクセラレーションを有効にするには、以下の手順を実行してください。

# 仮想マシンの設定ページに移動します。
# "ハードウェアの追加" ボタンをクリックし、"ビデオ" を選択し、"モデル" で "Virtio" を選択します。その後、サイドバー内の他の "ビデオ" 仮想ハードウェアを削除します。
# "Display Spice" に移動し、"Listen Type" を "None" に設定します。また、"OpenGL" チェックボックスをオンにして、適切なレンダラーを選択します。
# "Video Virtio" をクリックし、"3D Acceleration" にチェックを入れます。

{{Pkg|mesa-utils}} パッケージの ''glxgears'' を使用して 3D グラフィックスをテストできます。{{ic|glxgears -info}} はコンソールに OpenGL レンダラー情報を表示します。

== 参照 ==

* [https://virt-manager.org Project homepage]
* [https://github.com/virt-manager/virt-manager Project repository]
* [https://www.spice-space.org/download.html Spice drivers (graphics)]
* [https://github.com/virtio-win/virtio-win-pkg-scripts/blob/master/README.md VirtIO Windows drivers]

Virt-Manager

2025-08-23T05:14:49Z

Kgx: 英語版から転載

[[Wikipedia:Virt-manager|virt-manager]] is a graphical user front end for the [[libvirt]] library which provides virtual machine management services. virt-manager interface makes it easy for the user to create, delete and manipulate virtual machines without going through the terminal.

virt-manager mainly supports KVM but it can work with other hypervisors, such as Xen and LXC.

== Installation ==
First follow the [[libvirt]] or [[LXC]] pages and ensure you can create virtual machines, then [[install]] the {{Pkg|virt-manager}} package.
Install [[QEMU]] if needed.

To use an {{ic|LXC}} connection [[enable/start]] the {{ic|libvirtd.service}} unit.

To use a {{ic|QEMU}} connection [[enable/start]] the {{ic|libvirtd.socket}} unit.

You can check the [[unit status]] to make sure the service is running.

{{Note|The domain [https://www.libvirt.org/manpages/virsh.html#autostart autostart] feature requires {{ic|libvirtd.service}} to be enabled.}}

== Configuration ==

=== Basic configuration ===

Add yourself to the ''libvirt'' [[user group]].

It is also a good idea to ensure that any files/folders outside of virt-manager's default pool are owned by the {{ic|libvirt-qemu}} group, otherwise you might encounter permission errors when accessing files outside of the default pool.

# chown "$USER":libvirt-qemu ''/path/to/vm/folder''

{{Tip|There are other ways to solve this issue, if you forget then virt-manager will ask for permission to change these settings for you.}}

== Tips and tricks ==

=== Non root KVM without Socket ===

{{Note|Enabling the [[systemd]] socket overrides this, only do this if you don't want to enable the socket}}

To use as a normal user without [[root]] we need to configure KVM, this will also enable the libvirt networking components.

Set the UNIX domain socket ownership to libvirt and the UNIX socket permission to read and write by changing the following:

{{hc|/etc/libvirt/libvirtd.conf|2=
...
unix_sock_group = 'libvirt'
...
unix_sock_rw_perms = '0770'
...
}}

Add your user to the ''libvirt'' [[user group]].

Add your user to {{ic|/etc/libvirt/qemu.conf}}. Otherwise, QEMU will give a permission denied error when trying to access local drives.

Search for {{ic|1=user = "libvirt-qemu"}} or {{ic|1=group = "libvirt-qemu"}}, uncomment both entries and change {{ic|libvirt-qemu}} to your user name or ID. Once edited it should look something like below.

{{hc|/etc/libvirt/qemu.conf|2=
# Some examples of valid values are:
#
# user = "qemu" # A user named "qemu"
# user = "+0" # Super user (uid=0)
# user = "100" # A user named "100" or a user with uid=100
#
user = "''username''"

# The group for QEMU processes run by the system instance. It can be
# specified in a similar way to user.
group = "''username''"
}}

Upon opening Virt-Manager, it will default to the system variant (root) of the QEMU connection.

This can be changed to the user connection by going to: ''File'' > ''Add Connection''.

Now select {{ic|QEMU/KVM User session}} as the Hypervisor and click OK.
This will now auto-connect to the user session. You can now disconnect and remove the system connection if desired.

=== Networking ===

{{Note|
*The virt-manager article focuses on using virt-manager and libvirt in '''user session''', which has limited networking capabilities (see [https://wiki.libvirt.org/FAQ.html#what-is-the-difference-between-qemu-system-and-qemu-session-which-one-should-i-use libvirt FAQ] for details). There are more networking possibilities when using the system variant (root).
*Also look at [[libvirt]] in case of networking issues.}}

To use a network bridge in user session it has to be setup in {{ic|libvirt}} system administration first.

For this the {{ic|libvirt}} [[libvirt#Daemon|daemon]] must be running.

When it is started successfully, the system variant (root) of the QEMU connection can be opened in virt-manager. Setup the bridge with the desired settings in the networking tab there.

To be able to use the bridge in a user session virtual machine, setup the [[QEMU#Bridged networking using qemu-bridge-helper|qemu-bridge-helper]] according to your bridge setup .

After that the bridge can be used at a virtual network that runs in virt-manager user session.

==== NAT - Bridged - Host-Only====

===== NAT =====

NAT routes the VM over the same IP, this option is available in the Show hardware -> NIC and does not need any additional configuration

===== Bridged =====

Bridged mode acts as if the VM where it's own client in the network.
In virt-manager you must select an interface for it.

Which is different from virtualbox or vmware, where it gets automatically selected.
In order to use Bridged you should create a [[#Creating a Virtual Interface|virtual interface]] with NAT.

(It can be possible to use your own interface, but that might require additional configuration.)

===== Host-Only =====

A host only configuration, only permits network operations between host and guest.

This option doesn't exist for virt-manager.
Instead you must use a bridge connected to a virtual isolated Network. See: [[#Creating a Virtual Interface]]

=== Connection Details ===

==== Creating a Virtual Interface ====

Go to Edit -> Connection Details -> add

Following Options are available:

NAT, Routed, Open, Isolated, SR-IOV Pool

=== 3D acceleration ===

virtio is a paravirtual 3D graphics driver. To enable basic 3D acceleration:

# Go to a virtual machine's setting page.
# Click on the "Add Hardware" button > Video > select the "Model" as "Virtio". Then remove any other "Video" virtual hardware (within the sidebar).
# Go to "Display Spice" and set "Listen Type" to "None". Also tick the "OpenGL" checkbox and select the appropriate renderer.
# Click on "Video Virtio" and tick "3D Acceleration".

You can use ''glxgears'' from the {{Pkg|mesa-utils}} package to test the 3D graphics. {{ic|glxgears -info}} displays OpenGL renderer info in the console.

== See also ==

* [https://virt-manager.org Project homepage]
* [https://github.com/virt-manager/virt-manager Project repository]
* [https://www.spice-space.org/download.html Spice drivers (graphics)]
* [https://github.com/virtio-win/virtio-win-pkg-scripts/blob/master/README.md VirtIO Windows drivers]

Reflector

2025-08-23T01:20:15Z

Kgx: /* 自動化 */ 同期

[[Category:パッケージ管理]]
[[en:Reflector]]
[[es:Reflector]]
[[fr:Reflector]]
[[it:Reflector]]
[[ko:Reflector]]
[[pl:Reflector]]
[[ru:Reflector]]
[[zh-hans:Reflector]]
{{Related articles start}}
{{Related|ミラー}}
{{Related|Pacman}}
{{Related articles end}}
[https://xyne.archlinux.ca/projects/reflector/ Reflector] は [https://archlinux.org/mirrors/status/ Arch Linux Mirror Status] ページから最新のミラーリストを取得して、フィルタリングおよび速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きする Python スクリプトです。

== インストール ==

{{Pkg|reflector}} パッケージを[[インストール]]してください。

== 使用方法 ==

利用できるコマンドを表示するには、次のコマンドを実行:
# reflector --help

{{Note|通常、国ごとにミラーを絞り込むのは得策ではありません。ひとつの国に存在するミラーの数には限りがありますし、ネットワークの通信速度は地理的な距離だけで決まるものではないからです。}}

=== サンプル ===

{{man|1|reflector|EXAMPLES}} を参照してください。

{{Note|{{ic|/etc/pacman.d/mirrorlist}} を上書きする例は root 権限で実行する必要があります。作業を進める前にバックアップを作成し、その後結果を確認してください。}}

== 自動化 ==

=== systemd サービス ===

Reflector には {{ic|reflector.service}} が同梱されており、{{ic|/etc/xdg/reflector/reflector.conf}} に指定されたオプションを使って Reflector を実行します。このファイルにあるデフォルトのオプションは、良い出発点であり例となります。

Reflector を起動時に実行するには {{ic|reflector.service}} を [[有効化]] してください。すぐに実行する場合は、サービスを [[起動]] します。

{{Note|{{ic|reflector.service}} は [[systemd#ネットワークが稼働した後にサービスを実行する|network-online.target]] を介してネットワーク待機サービスが設定されている必要があります。}}

=== systemd タイマー ===

Reflector は [[systemd/タイマー]]({{ic|reflector.timer}})を提供しており、[[#systemd サービス]] {{ic|reflector.service}} を週に一度起動します。スケジュールは {{ic|reflector.timer}} を [[編集]] することで変更できます。

{{ic|reflector.service}} が起動する際のデフォルトオプションを変更するには、[[#systemd サービス]] で説明されているように設定ファイルを編集してください。その後、{{ic|reflector.timer}} を [[起動]] し、[[有効化]] します。

スケジュールより前にミラーリストを更新したい場合は、{{ic|reflector.service}} を [[起動]] してください。

=== pacman フック ===

{{Pkg|pacman-mirrorlist}} は定期的に更新されるわけではなく、世界のどこかでミラーが追加・削除されたからといって reflector を呼び出すのは適切ではありません。その代わりに [[systemd/タイマー]] のアプローチを利用してください。{{ic|mirrorlist.pacnew}} をまったくインストールしたくない場合は、{{ic|/etc/pacman.conf}} の [[pacman#インストールさせないファイルを設定|NoExtract]] を使用してください。

== 参照 ==

* [https://bbs.archlinux.org/viewtopic.php?id=115714 Reflector Arch Linux フォーラムのスレッド]
* [https://xyne.archlinux.ca/projects/reflector/ 変更ログを含むアップストリームプロジェクトページ]

Reflector

2025-08-23T01:11:34Z

Kgx: /* 使用方法 */ 同期

[[Category:パッケージ管理]]
[[en:Reflector]]
[[es:Reflector]]
[[fr:Reflector]]
[[it:Reflector]]
[[ko:Reflector]]
[[pl:Reflector]]
[[ru:Reflector]]
[[zh-hans:Reflector]]
{{Related articles start}}
{{Related|ミラー}}
{{Related|Pacman}}
{{Related articles end}}
[https://xyne.archlinux.ca/projects/reflector/ Reflector] は [https://archlinux.org/mirrors/status/ Arch Linux Mirror Status] ページから最新のミラーリストを取得して、フィルタリングおよび速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きする Python スクリプトです。

== インストール ==

{{Pkg|reflector}} パッケージを[[インストール]]してください。

== 使用方法 ==

利用できるコマンドを表示するには、次のコマンドを実行:
# reflector --help

{{Note|通常、国ごとにミラーを絞り込むのは得策ではありません。ひとつの国に存在するミラーの数には限りがありますし、ネットワークの通信速度は地理的な距離だけで決まるものではないからです。}}

=== サンプル ===

{{man|1|reflector|EXAMPLES}} を参照してください。

{{Note|{{ic|/etc/pacman.d/mirrorlist}} を上書きする例は root 権限で実行する必要があります。作業を進める前にバックアップを作成し、その後結果を確認してください。}}

== 自動化 ==

=== Systemd サービス ===

サービスは、{{ic|/etc/xdg/reflector/reflector.conf}} で指定されたパラメータを使用し Reflector を実行します。このファイルのデフォルトのオプションは、例として示しています。

たとえば、HTTPS をサポートし、上書き {{ic|/etc/pacman.d/mirrorlist}} する最新の5つのミラーを日本とオーストラリアから選択するには、次のコマンドを使用します。

{{hc|/etc/xdg/reflector/reflector.conf|
--save /etc/pacman.d/mirrorlist
--country Japan,Australia
--protocol https
--latest 5
}}

{{ic|reflector.service}} を [[有効化]] すればミラーリストが起動時に更新されます。

{{Note|{{ic|reflector.service}} は、[[systemd#ネットワークが稼働した後にサービスを実行する|network-online.target]] を介して設定されるネットワーク待機サービスに依存します。}}

=== Systemd タイマー ===

バージョン2020.8 以降、Reflector は [[systemd/タイマー]] ({{ic|reflector.timer}}) を提供しており、 [[Reflector#Systemd サービス]] {{ic|reflector.service}} を毎週開始します。スケジュールは {{ic|reflector.timer}} を [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E7.B7.A8.E9.9B.86 編集] することで変更できます。

まず、[[Reflector#Systemd サービス]] の説明に従って、設定ファイルを編集します。設定ファイルを更新した後、{{ic|reflector.timer}} を [[有効化]] してください。

ミラーリストをスケジュールより先に更新するには、{{ic|reflector.service}} を [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 start] してください。

=== Pacman フック ===

{{Pkg|pacman-mirrorlist}} は定期的に更新されず、世界の一部のミラーが追加または削除されたという理由だけで reflector を呼び出します。代わりにタイマーベースの自動化を使いましょう。もし {{ic|mirrorlist.pacnew}} を全くインストールしたくない場合は、{{ic|pacman.conf}} で {{ic|NoExtract}} を使って下さい。

== 参照 ==

* [https://bbs.archlinux.org/viewtopic.php?id=115714 Reflector Arch Linux フォーラムのスレッド]
* [https://xyne.archlinux.ca/projects/reflector/ 変更ログを含むアップストリームプロジェクトページ]

パフォーマンスの向上

2025-08-15T08:12:28Z

Kgx: /* irqbalance */ 同期

[[Category:ハードウェア]]
[[Category:システム管理]]
[[en:Improving performance]]
[[es:Improving performance]]
[[fr:Improving performance]]
[[pl:Improving performance]]
[[pt:Improving performance]]
[[ru:Improving performance]]
[[zh-hans:Improving performance]]
{{Related articles start}}
{{Related|パフォーマンスの向上/ブートプロセス}}
{{Related|Pacman ヒント#パフォーマンス}}
{{Related|OpenSSH#SSH の高速化}}
{{Related|OpenOffice#OpenOffice の高速化}}
{{Related|ノートパソコン}}
{{Related|Preload}}
{{Related articles end}}

この記事では、知覚または計測できるシステムパフォーマンスの向上を最終目的として、パフォーマンスに関連する基本的なシステム診断、及び、リソース消費量の削減やシステム最適化のための手順に関する情報を提供しています。ゲーミングおよび低レイテンシに特有のその他のアドバイスは [[ゲーム#パフォーマンスを向上させる]] も参照してください。

== 基本 ==

=== システムを知る ===

システムをチューンするには、全体のスピードを下げているボトルネックやサブシステムに狙いを定めるがベストな方法です。システムの仕様を知ることは、それらを特定することに役立ちます。

* (LibreOffice や Firefox などの) 巨大なアプリケーションを同時に動作させたときにコンピュータが遅くなる場合、RAM の容量が十分であるか確認してください。以下のコマンドを使って、"available" 列の値を確認してください: {{bc|$ free -h}}
* 起動時間が長い場合、または、アプリケーションを初めて起動するとき (だけ) にロードに長い時間が掛かる場合、おそらくハードドライブが遅過ぎます。ハードドライブの速度を計測するには {{ic|hdparm}} コマンドを使うことができます: {{bc|# hdparm -t /dev/sd''X''}} {{Note|{{Pkg|hdparm}} で出力されるのはハードドライブの純粋な読み込み速度なので、有効なベンチマークとは言えませんが、平均的なコンピュータでは (アイドル状態のときに) 40MB/s より高い数値が出るのが妥当です。}}
* 十分な RAM が利用できる時でも CPU 負荷が一貫して高い場合、不要な[[デーモン]]やプロセスを無効化するなどして CPU 使用量を減らすことを試みてください。{{Pkg|htop}} や {{ic|pstree}} などの[[アプリケーション一覧/ユーティリティ#システム監視|システム監視ツール]]で CPU 負担をモニタすることができます: {{bc|$ htop}}
* ダイレクトレンダリングを使うアプリケーション (つまり、ビデオプレイヤ、ゲーム、[[ウィンドウマネージャ]]などの GPU を使うアプリケーション) が遅い場合、GPU パフォーマンスを向上させることで解決するはずです。まず初めにダイレクトレンダリングが有効になっているかどうか確認しましょう。{{ic|glxinfo}} コマンドを使うことで確認できます ({{Pkg|mesa-utils}} パッケージに含まれています)。次のコマンドを実行すると {{ic|direct rendering: Yes}} と表示される必要があります: {{bc|$ glxinfo {{!}} grep "direct rendering"}}
* [[デスクトップ環境]]を動かしている場合、(不要な) 視覚デスクトップ効果を無効化することで GPU 使用率を削減できる場合があります。現在使用しているものがハードウェアや個人の要件に合わない場合、より軽量な環境を使用するか、[[デスクトップ環境#カスタム環境|カスタムの環境]]を作成しましょう。
* 最適化された[[カーネル]]を使用することでパフォーマンスを向上できます。一般に {{Pkg|linux-zen}} が良い選択肢です。しかし、この記事の特定の部分で説明されているように、デフォルトのカーネルを調節することで良いパフォーマンスを得られます。

=== ベンチマーク ===

最適化の効果を判断できないことがたびたびあります。そういった場合は[[ベンチマーク]]ツールで計測することができます。

== ストレージデバイス ==

==== セクタサイズ ====

NVMe ドライブや Advanced Format ハードディスクが[[アドバンスドフォーマット|適切な論理セクタサイズ]]を使用していることを確認してください。

=== パーティショニング ===

パーティションが[[パーティショニング#パーティションアライメント|適切にアライメントされている]]ことを確認してください。

==== 複数のドライブ ====

複数のドライブを持っているのであれば、ソフトウェア [[RAID]] を組んでパフォーマンスを劇的に向上させることができます。

[[スワップ]]を別のディスク上に作成することでもパフォーマンスを多少向上させることができます。特に、スワップが頻繁に発生する場合です。

===== SSD を HDD のキャッシュとして使う =====

ハードディスクから移行することができない場合、ソリッドステートドライブをキャッシュレイヤとして使うことで読み書き速度を向上させ、ランダムアクセスによるパフォーマンスの低下を減らすことができます。方法としては、[[LVM#キャッシュ]]、[[Bcache]]、[[Bcachefs#SSD キャッシング]] があります。

==== HDD でのレイアウト ====

従来の回転式 HDD を使用している場合、パーティションのレイアウトがシステムのパフォーマンスに影響を与える可能性があります。ドライブの最初のセクター（ディスクの外周の近く）は最後のセクターよりも高速です。また、パーティションを小さくすれば必要なドライブヘッドの移動が少なくなり、ディスク操作をスピードアップできます。従って、システムのために作るパーティションは小さく (15~20GiB、必要に応じて調節) して、できるだけドライブの最初に配置することが推奨されます。他のデータ（画像・動画など）は別のパーティションに置くべきです。通常、システム ({{ic|/}}) から home ディレクトリ ({{ic|/home}}) を分割することでこれを達成できます。

{{Note|このページのすべてのアドバイスにおいて言えることですが、得られる利益を計測してください: ハードドライブを[https://blog.stuffedcow.net/2019/09/hard-disk-geometry-microbenchmarking/#shortstroke ショートストローク]したり、合計容量の数％しか使わないようにしたりしない限り、一般的な使用においては読み書き操作が依然としてドライブ全体に及ぶため、パーティションを分割してもほんの数%しかアクセス時間は改善されません。それと比べて、SSD にアップグレードするとパフォーマンスが1桁以上向上します。}}

=== ファイルシステムの選択とチューニング ===

ファイルシステムごとに強みが異なるのでシステムごとにファイルシステムを選ぶことはとても重要です。[[ファイルシステム]]の記事に人気のあるファイルシステムの簡単な説明がされています。[[:カテゴリ:ファイルシステム]]から関連記事も見ることができます。

==== マウントオプション ====

様々な [[fstab#atime オプション|*atime]] オプションが、{{ic|strictatime}} のパフォーマンスのペナルティを軽減することができます。

他のマウントオプションはファイルシステム固有なので、ファイルシステムの関連記事を参照してください:

* [[Ext3]]
* [[Ext4#パフォーマンスの向上]]
* [[JFS#最適化]]
* [[XFS#パフォーマンス]]
* [[Btrfs#デフラグメンテーション]]、[[Btrfs#圧縮]]、{{man|5|btrfs}}
* [[ZFS#チューニング]]
* [[NTFS#パフォーマンスの向上]]

===カーネルパラメータの調整===

ブロックデバイスのパフォーマンスに影響するキーが複数存在します、詳しくは [[sysctl#仮想メモリ]] を見て下さい。

=== I/O スケジューラの設定 ===

==== 背景情報 ====

入出力 ''(I/O)'' スケジューラはストレージデバイスにブロック I/O の操作を送信するときの順番を決めるカーネルコンポーネントです。I/O スケジューラの目的は読み込みリクエストを最適な方法で扱うことであるため、以下の2つのドライブの特徴を押さえておくことが重要です:

* HDD は回転ディスクでありヘッドが物理的に必要な場所に移動します。そのため、ランダムアクセスは 3〜12ms と非常に遅くなります (ハイエンドサーバーのドライブなのかノートパソコンのドライブなのか、あるいはディスクコントローラの書き込みバッファを迂回するかなどで速度は変わります)。逆に連続アクセスなら高いスループットを得ることが可能です。連続アクセスならヘッドはほとんど動かなくてよいためです。典型的な HDD は毎秒200回ほどの I/O リクエストを処理することができます ''(IOPS)''。

* SSD には物理的に移動する部品がありません。ランダムアクセスはシーケンシャルアクセスと同じ速度が出ます (0.1ms 未満)。SSD は複数のリクエストを一度にこなすこともできます。典型的な SSD のスループットは 10,000 IOPS を超えるため、大抵の場合は必要な仕事量を上回ります。

プロセスを大量に実行してストレージの様々な場所の I/O リクエストを発生させているとき (つまりランダムアクセスをしている状態)、数千の IOPS が生成されますが、普通の HDD では 200 IOPS までしか対応できません。ストレージにアクセスできるまで待機するリクエストの待ち行列が作られることになります。I/O スケジューラはこの待ち行列を最適化します。

==== スケジューリングアルゴリズム ====

スループットを改善する方法の一つとして、待機リクエストの順番を論理アドレスで並び替えてできるだけ一番近いリクエストを通すことで、アクセスをリニア化する方法があります。これが [[w:ja:エレベータアルゴリズム|elevator]] スケジューラと呼ばれる Linux の最初の I/O スケジューラでした。

エレベータアルゴリズムの問題点はシーケンシャルアクセスをするプロセスが上手く動かなくなることです。そのようなプロセスは、データブロックを読み取って数マイクロ秒で処理してから次のブロックを読み出します。エレベータスケジューラはプロセスが近くのブロックを呼びだそうとしていることを知らないため、他の場所のリクエストに移ってしまいます。[[w:Anticipatory_scheduling|anticipatory]] IO スケジューラはこの問題を解決します。このスケジューラは、他のリクエストを処理する前に、近くで別の読み取り操作が発生することを予測して、数ミリ秒待機します。

上述のスケジューラはどちらも全体のスループットを改善することを目指していましたが、それによって不幸にも長い間待たされてしまうリクエストも発生していました。例えば、プロセスの多くがストレージ領域の最初の部分をリクエストしていて、不幸なプロセスはストレージの末端付近をリクエストしているような状況を考えて下さい。そのため、開発者は公平なアルゴリズムを作成することを決めて [[w:Deadline_scheduler|deadline]] スケジューラが追加されました。deadline スケジューラはアドレスによってキューの順番を決めますが (エレベーターアルゴリズムと同じ)、一定期間、リクエストがキューの中で待機した場合、リクエストを (経過時間によって順番が付けられる) "expired" キューに移動します。スケジューラは先に expired キューをチェックして、リクエストを処理してからエレベーターキューに移動します。このアルゴリズムは公平性のために全体のスループットを犠牲にしているわけです。

[[w:CFQ|Completely Fair Queuing (CFQ)]] は別のアプローチで問題に取り組みました。CFQ はプロセスの優先度に基づくキューを使ってタイムスライスと許容するリクエストの数を割り当てます。さらに [[cgroups]] のサポートを追加することで特定のプロセスグループに一定の IO を予約できるようにしました。これは共有・クラウドサーバーで特に役立ちます。ユーザーはリソースが必要なときに料金を払って IOPS を得られるのです。また、同期 I/O で近くの操作を待機するという ''anticipatory'' スケジューラの機能を改良して取り入れています。''anticipatory'' と ''elevator'' スケジューラは Linux カーネルから外され、下記のより高度な代替スケジューラに置き換えられました。

[https://docs.kernel.org/block/bfq-iosched.html Budget Fair Queuing (BFQ)] は CFQ のコードをベースにいくつか改善を加えています。各プロセスに固定長のタイムスライスを与えるかわりに、プロセスのセクタ数から計算した "budget" を割り当ててヒューリスティックを用います。BFQ は想定的に複雑なスケジューラであるため、オーバーヘッドが大きく、回転ドライブや低速 SSD に適しています。特に遅い CPU と組み合わせたときに高速なデバイスの足を引っ張ってしまうような場合に有用です。BFQ は個人用のシステムでインタラクティブな作業を行うときに、ストレージデバイスがまるで待機状態のときのように素早く反応することを目標としています。デフォルト設定ではスループットの最大化よりもレイテンシの最小化が優先されているのが特徴です。これにより、ハードドライブにおいて[https://www.phoronix.com/review/linux-50hdd-io/2 アプリケーションの起動を劇的に加速化]させられる場合があります。

[https://lwn.net/Articles/720675/ Kyber] はネットワークルーティングで用いられている積極的なキュー管理テクニックから生まれた新しいスケジューラです。リクエストを制限するメカニズムとして「トークン」を基に実装されています。リクエストの割当を受けるにはキューイングトークンを必要とすることで、リクエストのスタベーションを防ぎます。ディスパッチトークンによってデバイスの特定の優先度の操作に制限されます。さらに、ターゲットの読み込みレイテンシを定義して、レイテンシ目標を達成するためにスケジューラ自身がチューニングを行います。アルゴリズムの実装は比較的シンプルなので高速なデバイスでも効率的に機能します。

==== カーネルの I/O スケジューラ ====

初期のアルゴリズムには既にメインラインから外されているものもあります。公式の Linux カーネルはいくつかの I/O スケジューラをサポートしています。[https://www.thomas-krenn.com/en/wiki/Linux_Multi-Queue_Block_IO_Queueing_Mechanism_(blk-mq) Multi-Queue Block I/O Queuing Mechanism (blk-mq)] は I/O クエリを複数のキューに割り当てて、複数のスレッドおよび CPU コアにタスクを分散させます。このフレームワークでは以下のスケジューラが使えます:

*''None''、キューイングアルゴリズムは適用されません。
*''mq-deadline'' は deadline スケジューラ (下記を参照) をマルチスレッドに対応させたスケジューラです。
*''Kyber''
*''BFQ''

==== I/O スケジューラの変更 ====

{{Note|スケジューラーの最適な選択は、デバイスとワークロードの正確な性質の両方によって異なります。また、MB/秒単位のスループットだけがパフォーマンスの指標ではありません。デッドラインや公平性は全体的なスループットを低下させますが、システムの応答性を向上させる可能性があります。 [[ベンチマーク]] は、各 I/O スケジューラのパフォーマンスを示すのに役立つ場合があります。}}

特定のデバイスで利用可能なスケジューラとアクティブなスケジューラを表示するには (アクティブなスケジューラは角括弧の中):

{{hc|$ cat /sys/block/'''''sda'''''/queue/scheduler|
mq-deadline kyber [bfq] none
}}

全デバイスで利用可能なスケジューラを表示するには:

{{hc|$ grep "" /sys/block/'''*'''/queue/scheduler|
/sys/block/pktcdvd0/queue/scheduler:none
/sys/block/sda/queue/scheduler:mq-deadline kyber [bfq] none
/sys/block/sr0/queue/scheduler:[mq-deadline] kyber bfq none
}}

デバイス ''sda'' のアクティブな I/O スケジューラを ''bfq'' に変更するには:

# echo '''''bfq''''' > /sys/block/'''''sda'''''/queue/scheduler

I/O スケジューラの変更プロセスは、ディスクが回転式か否かに応じて自動化することができ、起動毎に永続化させることができます。例えば、以下の [[udev]] ルールは、回転ドライブに対しては ''bfq'' を、[[SSD]]/eMMC ドライブに対しては ''bfq'' を、[[NVMe]] に対しては ''none'' を設定します:

{{hc|/etc/udev/rules.d/60-ioschedulers.rules|<nowiki>
# HDD
ACTION=="add|change", KERNEL=="sd[a-z]*", ATTR{queue/rotational}=="1", ATTR{queue/scheduler}="bfq"

# SSD
ACTION=="add|change", KERNEL=="sd[a-z]*|mmcblk[0-9]*", ATTR{queue/rotational}=="0", ATTR{queue/scheduler}="bfq"

# NVMe SSD
ACTION=="add|change", KERNEL=="nvme[0-9]*", ATTR{queue/rotational}=="0", ATTR{queue/scheduler}="none"
</nowiki>}}

再起動するか、強制的に[[udev#新しいルールをロードする|新しいルールをロード]]してください。

==== IO スケジューラの調整 ====

カーネルの I/O スケジューラには遅延・期限時間や FIFO パラメータなどそれぞれ設定項目が存在します。特定のデバイスとワークロードの組み合わせにあわせてアルゴリズムを調整することが可能です。スループットを高めたり遅延を少なくしたりするときに用います。
設定項目と説明は [https://docs.kernel.org/block/index.html カーネルドキュメント] で確認できます。

特定のデバイスで設定可能なパラメータを確認するには (以下の例では ''sdb'' は ''deadline'' を使用しています):

{{hc|$ ls /sys/block/'''''sdb'''''/queue/iosched|
fifo_batch front_merges read_expire write_expire writes_starved}}

レイテンシを犠牲に ''deadline'' のスループットを高めるには以下のコマンドで {{ic|fifo_batch}} を増やします:

{{bc|# echo ''32'' > /sys/block/'''''sdb'''''/queue/iosched/'''fifo_batch'''}}

=== 電源管理設定とライトキャッシュ ===

従来の回転ディスク (HDD) を使用する場合は、省電力機能を完全に無効にするか下げるかし、書き込みキャッシュが有効になっているかどうかを確認すると良いかもしれません。

[[Hdparm#電源管理の設定]] と [[Hdparm#ライトキャッシュ]] を参照してください。

後で、起動時にこれらを適用する [[Hdparm#udev ルールによる永続的な設定|udev ルール]] を作成することができます。

{{Tip|[[GNOME]] では、"ディスク" アプリケーションからこれらのパラメータのいくつかを設定でき、udev ルールは必要ありません。}}

{{Note|一部の機能はあなたのハードドライブではサポートされていないかもしれません。その場合、Hdparm が通知します。なので、この特定の機能の設定を無視してください。}}

=== ディスクの読み書きを減らす ===

遅いストレージデバイスへの不必要なアクセスを避けることはパフォーマンスを向上にとって良いことであり、デバイスの寿命を伸ばすことにも繋がります。ただし最近のハードウェアでは寿命への影響はわずかです。

{{Note|書き込み増幅率が平凡な 10x で、書き込み/消去サイクルが標準的な 10000 である、32GB の SSD の場合、'''毎日 10GB のデータ書き込みを行うと'''、'''8年間で寿命が尽きる'''とされます。この数字はもっと[https://kcall.co.uk/ssd/ 容量が大きい SSD] を使ったり書き込み増幅が少ない最新のコントローラを使うことで改善されます。また、ディスクの書き込みを制限するのにどの方法が必要なのか考えるときは[https://web.archive.org/web/20161124030749/http://techreport.com/review/27909/the-ssd-endurance-experiment-theyre-all-dead この耐久実験]も参照してください。}}

==== ディスクの書き込みを表示する ====

{{Pkg|iotop}} パッケージはプログラムをディスクの書き込み数でソートして、どれくらいの頻度でどれだけディスクに書き込んでいるか表示します。詳しくは {{man|8|iotop}} を見てください。

==== ファイルを tmpfs に再配置する ====

ブラウザプロファイルなどのファイルを [[tmpfs]] ファイルシステムに再配置してメモリ内に保存することで、アプリケーションのレスポンスを向上させることができます:

* ブラウザプロファイルを同期させる方法については [[Profile-sync-daemon]] を参照してください。特定のブラウザには注意が必要な場合があります。例えば [[Firefox Ramdisk]] を参照してください。
* 任意の指定されたフォルダを同期させる方法については [[Anything-sync-daemon]] を参照してください。
* tmpfs 内でパッケージをビルドすることでコンパイル時間を減らす方法については [[Makepkg#ビルド時間を短縮する]] を参照してください。

==== ファイルシステム ====

対応する[[ファイルシステム]]ページを参照して、パフォーマンス改善に関する指示があるか見てください。[[#ファイルシステムの選択とチューニング]] に挙げられているファイルシステムのリストも参照してください。

==== スワップ領域 ====

詳細は [[スワップ#パフォーマンス]] を見てください。

==== ライトバックの間隔とバッファサイズ ====

詳細は [[Sysctl#仮想メモリ]] を見てください。

==== コアダンプを無効化する ====

[[コアダンプ#自動的なコアダンプの無効化]] を見てください。

=== ionice によるストレージ I/O スケジューリング ===

バックアップなど多くのタスクにおいては、そのタスクを実行するために、ストレージ I/O の遅延が短かったり、ストレージ I/O の帯域が大きかったりする必要はありません。そのようなタスクはバックグラウンドタスクに分類することができます。一方、デスクトップにおいて高速な I/O は UI の応答性を高める上で必須です。ゆえに、他のタスクがストレージ I/O を必要としている間は、バックグラウンドタスクによって利用できるストレージ帯域幅を減らすことが有益です。これは、プロセスごとに異なる優先度を設定できる Linux I/O スケジューラ BFQ を使用することで実現できます。

以下のようにバックグラウンドプロセスを実行することで、プロセスの I/O 優先度 "Idle" レベルまで落とすことができます:

$ ionice -c 3 ''command''

詳細は [https://www.cyberciti.biz/tips/linux-set-io-scheduling-class-priority.html a short introduction to ionice] や {{man|1|ionice}} を参照してください。

=== トリム ===

最適なパフォーマンスを得るには、SSD の空きブロックを定期的に discard (トリム) してランダム書き込みの速度を最適化するべきです。詳細は [[ソリッドステートドライブ#TRIM]] を参照してください。

== ネットワーク ==

* カーネルネットワーキング: [[Sysctl#パフォーマンスを向上させる]] を参照
* NIC: [[ネットワーク設定#MTU とキューの長さの設定]] を参照
* DNS: キャッシュ付きの DNS リゾルバの使用を検討してください。[[ドメイン名前解決#DNS サーバ]] を参照
* Samba: [[Samba#スループットを向上させる]] を参照

== CPU ==

=== オーバークロック ===

[[Wikipedia:ja:オーバークロック|オーバークロック]]は、CPU クロック周波数の上限を上げることにより、CPU の計算パフォーマンスを向上させます。オーバークロックできるかどうかは、CPU モデルとマザーボードモデルの組み合わせに依存します。オーバークロックは BIOS を介して行うのが最も一般的です。オーバークロックには欠点とリスクもあります。ここでは推奨も非推奨もしないでおきましょう。

Intel 製のチップの多くは acpi_cpufreq などや他のほとんどのユーティリティに正しいクロック周波数を伝えません。この結果、[[dmesg]] は極端なメッセージを表示します (これは、{{ic|acpi_cpufreq}} カーネルモジュールをアンロードしてブラックリスト化することで回避可能です)。クロック速度を読むには、{{Pkg|i7z}} パッケージの ''i7z'' を使用してください。オーバークロックされた CPU が正しく動作していることを確認する方法として、[[ストレステスト]]が推奨されます。

=== 周波数スケーリング ===

[[CPU 周波数スケーリング]]を見てください。

=== CPU スケジューラ ===

メインライン Linux カーネルのデフォルトの CPU スケジューラは [https://lwn.net/Articles/925371/ EEVDF] です。

* {{App|[[Wikipedia:Brain_Fuck_Scheduler#MuQSS|MuQSS]]|Multiple Queue Skiplist Scheduler。[[Wikipedia:Con_Kolivas|Con Kolivas]] によって開発されている {{ic|-ck}} パッチセットにより利用可能。|[[非公式ユーザーリポジトリ/Repo-ck]]|{{AUR|linux-ck}}}}
* {{App|[https://cchalpha.blogspot.com/2020/05/project-c-announcement.html Project C]|BMQ を Project C にリファクタリングするためのクロスプロジェクト。Project C コードベースに基づいて PSD を再作成します。よって、これは2つのプロジェクトのマージであり、その後 PDS が Project C として更新されます。より最近の開発として推奨されます。|https://cchalpha.blogspot.com/|{{AUR|linux-prjc}}}}
* {{App|BORE|BORE スケジューラは、対話型タスクにおいてある程度の公平性を犠牲にして低レイテンシを実現することに焦点を当てています。CFS の上に構築されており、vruntime コード更新だけに調整されています。なので、他の非公式 CPU スケジューラと比較して、全体的な変更は非常に小さいです。|https://github.com/firelzrd/bore-scheduler|{{AUR|linux-cachyos-bore}}}}
* {{App|SCX|システムをリセットせずに様々な CPU スケジューラを動的にロードできるようにします。|https://github.com/sched-ext/scx|{{Pkg|scx-scheds}}}}

=== リアルタイムカーネル ===

(TV チューナーカードをフル HD 解像度 (1080p) で実行するなど) 一部の使用用途では、[[リアルタイムカーネル]]を使うと利益を得られる場合があります。

=== プロセスの優先順位を設定 ===

{{man|1|nice}} と {{man|1|renice}} も参照してください。

==== Ananicy ====

[https://gitlab.com/ananicy-cpp/ananicy-cpp Ananicy CPP] は動的に実行可能ファイルの nice レベルを調整するためのデーモンで、{{Pkg|ananicy-cpp}} や {{AUR|ananicy-cpp-git}} パッケージで利用可能です。nice レベルとは、CPU リソースを配分するときの実行可能ファイルの優先度を表すものです。

{{Warning|1=[[Gamemode]] と [https://gitlab.com/ananicy-cpp/ananicy-cpp Ananicy CPP] はどちらもプロセスの nice レベルを調整しようとします。これらのツールを組み合わせて使用することは推奨されていません。[https://github.com/CachyOS/ananicy-rules/blob/master/README.md#gamemode--ananicy-cpp--bad-idea]}}

==== cgroups ====

[[cgroups]] を見てください。

==== LimitCPU ====

[https://limitcpu.sourceforge.net/ LimitCPU] は特定のプロセスの CPU 使用率を制限するプログラムです。{{AUR|limitcpu}} をインストールすれば、プロセスの PID で CPU 使用率を 0 から 100 までの値にコンピュータに搭載されている CPU コア数をかけた数字の範囲で制限することができます。例えば、CPU コアが8個であれば利用可能な値は 0 から 800 です。使用例:

$ limitcpu -l 50 -p 5081

=== irqbalance ===

{{Pkg|irqbalance}} はマルチプロセッサシステムでパフォーマンスを向上させるためにプロセッサ間でハードウェア割り込みを分散させます。{{ic|irqbalance.service}} で[[systemd#ユニットを使う|操作]]することが可能です。

{{Warning|1=一部のケースでは、irqbalance が省電力機能に干渉し、ビデオゲームでのスタッタリングやフレームレート低下を引き起こす可能性があります。[https://bugs.launchpad.net/ubuntu/+source/ubuntu-meta/+bug/1833322/comments/4]}}

=== CPU の脆弱性の緩和策をオフにする ===

{{Warning|1=以下の設定を使うときは問題の脆弱性について確認してください。詳しくは [https://phoronix.com/scan.php?page=news_item&px=Linux-Improve-CPU-Spec-Switches こちら] や [https://linuxreviews.org/HOWTO_make_Linux_run_blazing_fast_(again)_on_Intel_CPUs こちら] のページを参照。}}

CPU の脆弱性の緩和策をオフにすることで、パフォーマンスが向上する場合があります。以下の[[カーネルパラメータ]]ですべての緩和策が無効になります:

mitigations=off

このパラメータによって切り替えられるすべてのスイッチについての説明は、[https://docs.kernel.org/admin-guide/kernel-parameters.html kernel.org] で見られます。{{AUR|spectre-meltdown-checker}} や {{man|1|lscpu}} ({{Pkg|util-linux}} に同梱) を使うことで、脆弱性チェックを行うことができます。

{{Note|1=第10世代およびそれ以降の Intel CPU、または AMD Ryzen シリーズ 1000 およびそれ以降の CPU を使用している場合、緩和策を無効化することにより得られるパフォーマンスの向上は、最大でも 5% にとどまります。一方、それ以前の世代の CPU では、最大 25% まで向上します。[https://www.phoronix.com/scan.php?page=article&item=3-years-specmelt 2021 初頭における総評]、[https://www.phoronix.com/scan.php?page=article&item=spectre-rocket-lake Rocket Lake におけるテスト]、[https://www.phoronix.com/scan.php?page=article&item=alder-lake-mitigations Alder Lake におけるテスト] を参照。}}

== グラフィック ==

=== Xorg の設定 ===

グラフィックパフォーマンスは {{man|5|xorg.conf}} の設定に依存している場合があります。[[NVIDIA]]、[[AMDGPU]]、[[Intel]] の記事を参照してください。不適切な設定は Xorg が動作しなくなる原因になるため、注意しましょう。

=== Mesa の設定 ===

Mesa ドライバのパフォーマンスは [https://dri.freedesktop.org/wiki/ConfigurationInfrastructure/ drirc] で設定できます。{{Pkg|adriconf}} (Advanced DRI Configurator) はオプションを設定して標準の drirc ファイルに書き込むことで MESA ドライバを設定する GUI ツールです。

=== ハードウェアビデオアクセラレーション ===

[[ハードウェアビデオアクセラレーション]]により、ビデオカードに動画のデコード/エンコードをさせることができます。

=== オーバークロック ===

CPU と同様に、(GPU の) オーバークロックは直接的にパフォーマンスを向上できますが、一般には推奨されません。いくつかのパッケージがあります: {{AUR|rovclock}} (ATI カード)、{{Pkg|rocm-smi-lib}} (最近の AMD カード)、{{AUR|nvclock}} (古い NVIDIA カード - Geforce 9 まで)、{{Pkg|nvidia-utils}} (最近の NVIDIA カード)。

[[AMDGPU#オーバークロック]] や [[NVIDIA/ヒントとテクニック#オーバークロックを有効化する]] を参照してください。

=== PCIe resizable BAR を有効化する ===

{{Note|
* 一部のシステムでは、PCIe resizable BAR を有効化するとパフォーマンスが大幅に劣化する可能性があります。システムのベンチマークを行って、PCI resizable BAR がパフォーマンスを向上させていることを確認してください。
* 効果を発揮させるには、[[Wikipedia:Unified Extensible Firmware Interface#CSM booting|Compatibility Support Module (CSM)]] を無効化しなければなりません。
}}

PCI の仕様では、PCI デバイスのメモリを PCI コントローラに公開するために、より大きい[[wikipedia:PCI_configuration_space#Standardized_registers|基底アドレスレジスタ]] (BAR) を使用できます。そうすることで、ビデオカードのパフォーマンスを向上できる可能性があります。ビデオメモリ全体にアクセスすることでパフォーマンスを向上できますし、グラフィックドライバの最適化も可能になります。Resizable BAR、above 4G decoding、そしてドライバ最適化の組み合わせを、AMD は [https://www.amd.com/en/gaming/technologies/smart-technologies.html AMD Smart Access Memory] と呼んでおり、初期は AMD Series 500 チップセットマザーボードで利用できましたが、後に UEFI アップデートを通して AMD Series 400 と Intel Series 300 以降に拡張されました。この設定はすべてのマザーボードで利用できるわけではなく、特定のボードではブート問題を引き起こすことが知られています。

BAR のサイズが 256M の場合、この機能は有効化されていないか、サポートされていません:

{{hc|1=# dmesg {{!}} grep BAR=|2=
[drm] Detected VRAM RAM=8176M, BAR=256M}}

有効化するには、マザーボード設定で "Above 4G Decode" か ">4GB MMIO" という名前の設定を有効化してください。BAR が大きくなっていることを確認するには:

{{hc|1=# dmesg {{!}} grep BAR=|2=
[drm] Detected VRAM RAM=8176M, BAR=8192M}}

== RAM、スワップ、OOM 処理 ==

=== クロック周波数とタイミング ===

RAM は BIOS で設定することで、クロック周波数とタイミングを別々にすることができます。メモリのパフォーマンスは両方の値によって変わります。BIOS に用意されている最高速のプリセットを選択することでデフォルト設定よりも性能を上げることができます。マザーボードやメモリのメーカーがサポートしていない周波数まで値を高めると、CPU のオーバークロックと同じようなリスクがあるので注意してください。[[#オーバークロック]]を参照。

=== RAM オーバーレイ上に root を置く ===

{{Out of date|liveroot スクリプトはメンテナンスされていないようです。しかし、このアプローチは依然として機能するはずです。}}

書き込みが遅いメディア (USB や回転 HDD) を使う場合、(ディスク上の) 読み取り専用の root の上で RAM オーバーレイを作って root を動作させることができます。root に書き込みできる領域が制限されるかわりにパフォーマンスが劇的に改善します。{{AUR|liveroot}} を見て下さい。

=== zram 内のスワップや zswap ===

[[zswap]] や [[zram#スワップとしての使用|zram 内のスワップ]]を使うことで、似たような利点を (同じくらいのコストで) 得られます。これら2つは一般に意図が似ていますが、動作が異なります:

* zswap は、圧縮された RAM キャッシュとして動作し、ユーザ空間の設定をあまり必要としません (と同時に許可もしていません)。スワップデバイスと組み合わせて、スワップのキャッシュとして動作します。スワップに入りそうなページは、代わりに zswap に入る可能性があります。

* zram は、RAM 内に圧縮されたブロックデバイスを作成できるカーネルモジュールです。この圧縮されたブロックデバイスはスワップデバイスとして使用でき、他のスワップデバイスと組み合わせる必要はありません。多くの設定オプションがあり、例えばコールドページを保持しておくバッキングデバイスを使用するかどうかも指定できます。

両方とも[[スワップ]]サブシステムを呼び出すため、スワップに影響を与える設定はこれらのシステムにも影響を与えます。例えば、[[スワップ#Swappiness|swappiness]] は、メモリが圧迫している状況で、カーネルがファイルキャッシュをドロップするか、ページをスワップに移動させるかのどちらを優先させるかを指定します。Zswap はページのスワップへの移動動作をインターセプトし、zram もスワップとして動作するため、このオプションはこれら2つのメカニズムがどれくらいの頻度で使用されるかにも影響を与えます。

=== グラフィックカードの RAM を使う ===

稀なケースとして、RAM 容量が非常に小さいが、ビデオ RAM に余りがある場合、後者をスワップとして使用できます。[[ビデオメモリにスワップ]] を参照してください。

=== メモリ不足の状況におけるシステムのレスポンスを改善する ===

従来の GNU/Linux システム (特にグラフィカルワークステーション) では、割り当てられたメモリがオーバーコミットすると、カーネル内の out-of-memory (OOM) killer がトリガーされるか、十分な量のメモリが開放される (システムが応答しない場合、メモリを大量消費するアプリケーションを閉じることは難しいため、これはすぐには起こり得ないでしょう) まで、システム全体のレスポンスがほぼ使用不能な状態まで低下します。挙動は特定の環境や条件に依存しており、通常のレスポンス状態に戻るまでには数秒から30分以上かかる場合があります。会議でのプレゼンテーションなどのような重要な状況においては、待つのが苦痛になるでしょう。

[https://lore.kernel.org/lkml/d9802b6a-949b-b327-c4a6-3dbca485ec20@gmx.com/T/ カーネル]と[https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/XUZLHJ5O32OX24LG44R7UZ2TMN6NY47N/ Fedora] のメーリングリストで議論されている通り、メモリ不足の状況におけるカーネルとユーザ空間の挙動は将来的に改善されるかもしれませんが、ユーザは、システムのハードリセットや {{ic|vm.overcommit_*}} [[sysctl]] パラメータの調整よりも実行可能で効果的なオプションを使うことができます:

* [https://docs.kernel.org/admin-guide/sysrq.html Magic SysRq キー] ({{ic|Alt+SysRq+f}}) で手動でカーネルの OOM killer をトリガーする。
* ユーザ空間の OOM デーモンを使ってこれに自動的 (または対話的) に対処する。

{{Warning|OOM killer をトリガーして実行中のアプリケーションを kill すると、保存されていない作業が失われる場合があります。アプリケーションが最終的に通常通りメモリを開放してくれることを期待して辛抱強く待つか、あるいは応答がないシステムを可能な限り早く通常に戻したいと望むかは、あなた次第です。}}

カーネルの OOM killer では終了する (しない) プロセスに優先順位を付けられないので、SysRq よりも OOM デーモンのほうが好ましい場合もあります。いくつかの OOM デーモンをリストアップしました:

* {{App|systemd-oomd|[[systemd]] によって {{ic|systemd-oomd.service}} として提供されています。cgroups-v2 と pressure stall information (PSI) を使用してプロセスを監視し、カーネル空間で OOM が発生する前にアクションを取ります。|https://github.com/systemd/systemd, {{man|8|systemd-oomd}}|{{Pkg|systemd}}}}
* {{App|earlyoom|C で書かれた、シンプルなユーザ空間の OOM killer 実装です。|https://github.com/rfjakob/earlyoom|{{Pkg|earlyoom}}}}
* {{App|oomd|[https://lwn.net/Articles/759781/ PSI] ベースの OOM killer 実装です。Linux カーネルバージョン 4.20+ を必要とします。設定は JSON で行い、非常に複雑です。Facebook の本番環境において動作確認済み。|https://github.com/facebookincubator/oomd|{{AUR|oomd}}}}
* {{App|nohang|Python で書かれた、洗練された OOM ハンドラ。オプションで PSI サポートあり。earlyoom よりも設定可能です。|https://github.com/hakavlad/nohang|{{AUR|nohang-git}}}}
* {{App|low-memory-monitor|GNOME 開発者の取り組み。ユーザ空間のアプリケーションにメモリ不足の状態を伝えるためのより良いコミュニケーションを提供することを目的としており、さらにカーネルの OOM killer をトリガーするように設定することができます。PSI ベースで、Linux 5.2+ を必要とします。|https://gitlab.freedesktop.org/hadess/low-memory-monitor/|{{AUR|low-memory-monitor-git}}}}
* {{App|uresourced|アクティブなグラフィカルユーザセッションに対して、cgroup ベースのリソース保護を有効化する小さなデーモン。|https://gitlab.freedesktop.org/benzea/uresourced|{{AUR|uresourced}}}}

== ウォッチドッグ ==

[[Wikipedia:Watchdog timer]] ([[wikipedia:ja:ウォッチドッグタイマー|日本語版]]) より:

:ウォッチドッグタイマーはコンピュータの動作に支障が生じていないか確認して復旧するために使われる電子的なタイマーである。通常、コンピュータは定期的にウォッチドッグタイマーをリセットする。何らかの理由でウォッチドッグをリセットできなかった場合、タイマーによってタイムアウト信号が生成され、コンピュータを安定状態に移行して通常のシステムオペレーティングを復旧させるなどの対応が行われる。

よって、ウォッチドッグは例外的な状況でカーネルの回復を最適化するために使用されています。もし、'''重要なシステムサービス''' (例: ネットワーク、ファイルシステム、ACPI、systemd) が応答しなくなった場合、ウォッチドッグはそれを検知し、再起動をトリガーします。それにより、システムがロックアップし、応答しなくなったサービスのせいで長い遅延が発生してしまうことを回避できます。[[#メモリ不足の状況におけるシステムのレスポンスを改善する]] で説明されているように、この緊急メカニズムとランタイムのシステムリソース管理とを区別することは重要です。

=== systemd ウォッチドッグ ===

systemd にはウォッチドッグのリセット機構が内蔵されています。これは、適切なカーネルモジュールがロードされている場合に (以下を参照)、{{ic|/dev/watchdog}} として公開されているハードウェアウォッチドッグと対話します。システムが応答しなくなった場合、ハードウェアウォッチドッグがシステムリセットをトリガーします。

==== systemd でウォッチドッグを設定する ====

デフォルトでは、{{ic|RuntimeWatchdogSec}} は無効化されています。システムのウォッチドッグを有効化するには、以下のような {{man|5|systemd-system.conf}} [[ドロップインファイル]]を作成してください:

{{hc|/etc/systemd/system.conf.d/watchdog.conf|2=
[Manager]
RuntimeWatchdogSec=10s
RebootWatchdogSec=45s
}}

* {{ic|1=RuntimeWatchdogSec=10s}}: systemd が 10 秒より長く応答しなかった場合、システムを再起動します。
* {{ic|1=RebootWatchdogSec=45s}}: システムが再起動中にハングした場合、ウォッチドッグは 45 秒後にリセットを強制します。

以下のコマンドで適用します:

# systemctl daemon-reexec

ウォッチドッグがアクティブであることを確認してください:

{{hc|$ systemctl show {{!}} grep Watchdog|2=
RuntimeWatchdogUSec=10s
RebootWatchdogUSec=45s
}}

==== ハードウェアのウォッチドッグサポートを確認する ====

多くのシステムで、ハードウェアウォッチドッグのサポートは異なるカーネルモジュール (例: 一部の Intel チップセットでは {{ic|iTCO_wdt}}、特定の AMD プラットフォームでは {{ic|sp5100_tco}}) によって提供されている場合があります。ハードウェアウォッチドッグのモジュールを確認するには、以下を実行してください:

$ lsmod | grep wdt

関連するウォッチドッグモジュール (例: {{ic|iTCO_wdt}}、{{ic|sp5100_tco}}) を見つけたら、以下のようなファイルを作成してモジュールが[[カーネルモジュール#systemd|ブート時にロード]]されるようにしてください:

{{hc|/etc/modules-load.d/watchdog.conf|
''module_name''
}}

# modprobe ''module_name''

{{ic|''module_name''}} の部分は、あなたのハードウェアにおける実際のモジュール名に置き換えてください。

=== リファレンス ===

* {{man|5|systemd-system.conf}}
* [https://docs.kernel.org/watchdog/index.html Linux カーネルウォッチドッグのドキュメント]
* [[Systemd-boot|Arch Wiki – Systemd Boot]]
* [https://0pointer.de/blog/projects/watchdog.html Lennart Poettering による systemd ウォッチドッグに関するブログ記事]

== 参照 ==

* [https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Performance_Tuning_Guide/index.html Red Hat Performance Tuning Guide]
* [https://www.thomas-krenn.com/en/wiki/Linux_Performance_Measurements_using_vmstat Linux Performance Measurements using vmstat]

{{TranslationStatus|Improving performance|2025-07-07|839855}}

GNOME

2025-08-15T06:16:48Z

Kgx: /* インストール */ 同期

[[Category:GNOME]]
[[cs:GNOME]]
[[de:GNOME]]
[[en:GNOME]]
[[es:GNOME]]
[[it:GNOME]]
[[pt:GNOME]]
[[ru:GNOME]]
[[zh-hans:GNOME]]
{{Related articles start}}
{{Related|デスクトップ環境}}
{{Related|GTK}}
{{Related|GDM}}
{{Related|GNOME/ヒントとテクニック}}
{{Related|GNOME/トラブルシューティング}}
{{Related|GNOME/Files}}
{{Related|GNOME/Gedit}}
{{Related|GNOME/Web}}
{{Related|GNOME/Evolution}}
{{Related|GNOME/Flashback}}
{{Related|GNOME/Keyring}}
{{Related|GNOME/ドキュメントビューア}}
{{Related|公式リポジトリ#gnome-unstable}}
{{Related articles end}}

[[Wikipedia:ja:GNOME|GNOME]] (/(ɡ)noʊm/) は、シンプルで使いやすいことを目指した [[デスクトップ環境]] です。[[Wikipedia:ja:GNOMEプロジェクト|GNOME プロジェクト]] によって設計され、すべてフリーでオープンソースのソフトウェアで構成されています。デフォルトのディスプレイは [[Xorg]] の代わりに [[Wayland]] であり、利用可能なセッションは以下の通りです。

* '''GNOME ''' は、GNOME Shell を [[Wayland]] 上で動作させます。伝統的な X アプリケーションは Xwayland を通して実行され、デフォルトの選択です。
* '''GNOME Classic''' は "[https://help.gnome.org/users/gnome-help/stable/gnome-classic.html 伝統的なデスクトップ体験]" を提供します。(GNOME 2 に似たインターフェイスで) [https://web.archive.org/web/20190503163814/http://www.worldofgnome.org/welcome-to-gnome-3-8-flintstones-mode/ 特定の拡張子や値] を使用します。したがって、これは GNOME Shell をカスタマイズしたものであり、真の意味で別個のモードと言うわけではありません。
* '''GNOME on Xorg''' は [[Xorg]] を使って GNOME Shell を実行します。

== インストール ==

GNOME には2つのパッケージグループが存在します:

* {{Grp|gnome}} には、ベースの GNOME デスクトップと、統合された[https://apps.gnome.org/ コアアプリケーション]が含まれています。
* {{Grp|gnome-circle}} には、GNOME エコシステムを拡張するためのさまざまな[https://apps.gnome.org/#circle 追加アプリケーション]が含まれています。
* {{Grp|gnome-extra}} には、E メールクライアント、IRC クライアント、[[#高度な設定|GNOME Tweaks]]、ゲーム集、そして開発ツールを含むその他の GNOME アプリケーションが含まれています。このグループは {{Grp|gnome}} を必要とすることに注意してください。

ベースのデスクトップは [[Wikipedia:ja:Mutter|Mutter]] ウィンドウマネージャのプラグインである [[Wikipedia:ja:GNOME Shell|GNOME Shell]] からできています。これは {{Pkg|gnome-shell}} パッケージでで個別にインストールできます。

{{Note|''mutter'' はデスクトップのコンポジットマネージャとして動作します。ハードウェアグラフィックアクセラレーションを使って画面のちらつきを抑えます。GNOME セッションマネージャはあなたのビデオドライバが GNOME Shell を動かすことができるか自動で検知して、場合によっては ''llvmpipe'' によるソフトウェアレンダリングを利用します。}}

不安定なリリースも使用できます。[[公式リポジトリ#gnome-unstable]] を参照してください。

== 起動 ==

GNOME は[[ディスプレイマネージャ]]を使ってグラフィカルに起動することも、コンソールから手動で起動する (ただし、一部の機能が不足している場合があります) こともできます。{{Grp|gnome}} に含まれているディスプレイマネージャは [[GDM]] です。

{{Note|GNOME における画面ロック (など) のサポートは GDM によって提供されています。GNOME を GDM で開始しない場合、他の画面ロッカーを使用できます。[[アプリケーション一覧/セキュリティ#スクリーンロック]] を参照してください。}}

=== グラフィカル ===

{{Grp|gnome}} グループをインストールしていて、次回のブート時に GNOME を自動的に開始させたい場合、{{ic|gdm.service}} を[[有効化]]してください。ディスプレイマネージャのセッションメニューからセッションを選ぶことができます: ''GNOME''、''GNOME Classic'' ({{Pkg|gnome-shell-extensions}} がインストールされている場合にのみ表示されます)、''GNOME on Xorg''。Wayland セッションは [[GDM#Xorg バックエンドを使う|GDM の設定ファイル]]で有効化/無効化できます。

再起動せずに GNOME をすぐに起動したい場合は、グラフィックに使用されていない tty から前述の {{ic|gdm.service}} を[[起動]]してください。

=== 手動 ===

==== Xorg セッション ====

* GNOME on Xorg セッションの場合は、{{ic|~/.xinitrc}} ファイルに以下を追加してください (詳細は [https://gitlab.gnome.org/GNOME/gtk/issues/1390#note_344758] を参照してください): {{bc|<nowiki>
export XDG_SESSION_TYPE=x11
export GDK_BACKEND=x11
exec gnome-session
</nowiki>}}
* GNOME Classic セッションの場合は、{{ic|~/.xinitrc}} ファイルに以下を追加してください: {{bc|<nowiki>
export XDG_CURRENT_DESKTOP=GNOME-Classic:GNOME
export GNOME_SHELL_SESSION_MODE=classic
exec gnome-session
</nowiki>}}

{{ic|~/.xinitrc}} ファイルを編集した後、{{ic|startx}} コマンドで GNOME を起動できます (logind セッションの保持など、その他の詳細については [[xinitrc]] を参照してください)。{{ic|~/.xinitrc}} ファイルを設定した後、例えば以下を {{ic|.bash_profile}} に追加することで tty1 で[[ログイン時に X を起動]]するように設定することもできます:

{{bc|<nowiki>
if [[ -z $DISPLAY && $(tty) == /dev/tty1 ]]; then
XDG_SESSION_TYPE=x11 GDK_BACKEND=x11 exec startx
fi
</nowiki>}}

==== Wayland セッション ====

{{Accuracy|dbus から {{ic|gnome-session}} を実行すると、問題が発生したり、あるいは全く動作しない場合があります。発生する問題としては、Chrome/Chromium を起動できなかったり、サウンドデバイスを利用できなかったりします。{{ic|gnome-session}} を直接実行するほうが良く機能するでしょう。議論: [[:en:Talk:GNOME#Manually start a Wayland session]]}}

{{Note|[[Wayland]] に移植されていないアプリケーションを実行するには、まだ X サーバが必要です (詳細は [[Wayland#Xwayland]] を参照してください)。Qt のような特定のグラフィックライブラリを使用するアプリケーションは、環境変数を設定することで強制的に Wayland を使用させることができます。詳しくは [[Wayland#GUI ライブラリ]] をご覧ください。}}

Wayland セッションを手動で開始するには:

$ XDG_SESSION_TYPE=wayland dbus-run-session gnome-session

{{ic|gnome-shell --wayland}} を直接実行することは推奨されていません。セッション管理機能が無いからです。

GNOME を手動で起動する際に {{ic|gdm}} は全く '''不要''' であることに注意してください (つまり、{{ic|gdm.service}} も不要です)。なので、個人の好みで {{ic|gnome}} グループに含まれる数個のパッケージだけで、アクセス可能な最小限の GNOME 環境を構築することができます。

tty1 へのログイン時にセッションを開始するには、前述のコマンドを {{ic|.bash_profile}} に追加してください。Firefox と QT アプリケーションは {{ic|XDG_SESSION_TYPE}} の設定を反映しないので、それらのアプリケーションに対しても変数を追加してください:

{{bc|<nowiki>
if [[ -z $DISPLAY && $(tty) == /dev/tty1 && $XDG_SESSION_TYPE == tty ]]; then
MOZ_ENABLE_WAYLAND=1 QT_QPA_PLATFORM=wayland XDG_SESSION_TYPE=wayland exec dbus-run-session gnome-session
fi
</nowiki>}}

=== Wayland における GNOME アプリケーション ===

''GNOME'' セッションを使用すると、GNOME アプリケーションは Wayland を使用して実行されます。デバッグする際には、https://docs.gtk.org/gtk3/running.html と https://docs.gtk.org/gtk4/running.html にオプションと環境変数のリストがあります。

== ナビゲーション ==

GNOME shell の効果的な使い方を学ぶには、[https://wiki.gnome.org/Projects/GnomeShell/CheatSheet GNOME Shell Cheat Sheet] を読んでください。GNOME shell の機能とキーボードショートカットを紹介しています。機能にはタスクの切り替え、キーボードの使用、ウィンドウの制御、パネル、概要モードなどが含まれます。ショートカットのいくつかを紹介します:

* {{ic|Super+m}}: 通知リストを表示
* {{ic|Super+a}}: アプリケーションメニューを表示
* {{ic|Alt+Tab}}: アクティブなアプリケーションを循環
* {{ic|Alt+`}}(US キーボードレイアウトなら {{ic|Tab}} の上のキー): フォアグラウンドのアプリケーションのウィンドウの循環
* {{ic|Alt+F2}} を押してから {{ic|r}} または {{ic|restart}}: シェルに問題が発生した場合にシェルを再起動 (X/レガシーモード限定、Wayland モードでは機能しません)

デフォルトの設定を変更してウィンドウの切り替えを Windows のようにする方法については、[[GNOME/ヒントとテクニック#ナビゲーション]] を見てください。

その他のショートカットについては、[https://help.gnome.org/users/gnome-help/stable/keyboard-nav.html キーボードナビゲーション]を参照してください。

== アプリケーションの旧名 ==

{{Note|GNOME プログラムの中には名前の変更が行われて、ドキュメントやダイアログでのアプリケーション名は変更されたのに実行可能ファイルの名前は変わっていないものがあります。以下の表ではそのようなアプリケーションを挙げています。}}

{{Tip|アプリケーションの旧名を Shell の検索バーで検索すると探したいアプリケーションが出て来ます。例えば、''nautilus'' を検索すると ''Files'' が表示されます。}}

{| class="wikitable"
! 新名
! 旧名
|-
| [[GNOME Files|Files]]
| Nautilus
|-
| [[GNOME Web|Web]]
| Epiphany
|-
| Videos
| Totem
|-
| Main Menu
| Alacarte
|-
| [[Evince|Document Viewer]]
| Evince
|-
| Disk Usage Analyser
| Baobab
|-
| Image Viewer
| EoG (Eye of GNOME)
|-
| [[GNOME Keyring|Passwords and Keys]]
| Seahorse
|-
| GNOME Translation Editor
| Gtranslator
|}

== 設定 ==

GNOME 設定 (''gnome-control-center'') と GNOME アプリケーションは、設定を保存するために [[wikipedia:Dconf|dconf]] 設定システムを使用します。

{{man|1|gsettings}} コマンドラインツールを使えば dconf データベースに直接アクセスできます。また、ユーザインターフェイスに公開されていない設定項目を設定することもできます。コマンドラインツール {{man|1|dconf}} は、検証プロセスをスキップしてデータベースを直接変更することができます。gsettings と dconf の設定キーは同じですが、形式が若干異なっています: gsettings での {{ic|gsettings set mygroup.mysubgroup mysetting myvalue}} は、dconf では {{ic|dconf write /mygroup/mysubgroup/mysetting myvalue}} となります。

GNOME 3.24 より前は、設定は GNOME 設定デーモン ({{ic|/usr/lib/gnome-settings-daemon/gnome-settings-daemon}}) によって適用されていました。これは、GNOME セッションの外から実行することができました。

しかし、GNOME 2.24 から、GNOME 設定デーモンは複数の設定プラグイン {{ic|/usr/lib/gnome-settings-daemon/gsd-*}} に置き換えられました (プラグインは後に {{ic|/usr/lib/gsd-*}} に移動されました)。現在、これらのプラグインは {{ic|/etc/xdg/autostart/}} にあるデスクトップファイル ({{ic|org.gnome.SettingsDaemon.*.desktop}} でマッチします) で制御されます。これらのプラグインを GNOME セッションの外から実行するには、プラグインの[[デスクトップエントリ]]を {{ic|~/.config/autostart}} にコピー/編集する必要があります。

設定は基本的にユーザーごとに行われます。以下のセクションではマルチユーザーシステム用に設定テンプレートを作成する方法については扱っていません。

=== システム設定 ===

==== 色 ====

{{ic|colord}} デーモンはディスプレイの EDID を読み取って適切なカラープロファイルを展開します。ほとんどのカラープロファイルは正確で、セットアップは必要ありません。しかし、カラープロファイルが正確でない場合や、ディスプレイが古い場合は、新しいカラープロファイルを {{ic|~/.local/share/icc/}} に置いて、それを使用することができます。

==== 夜間モード ====

GNOMEには、[[Redshift]] のようなブルーライトフィルタが組み込まれています。ディスプレイ設定メニューから、夜間モードを有効化したり、有効化する時間をカスタマイズしたりできます。さらに、以下の {{Pkg|dconf}} 設定で色温度を調整することができます (例として 5000 に設定しています):

$ gsettings set org.gnome.settings-daemon.plugins.color night-light-temperature 5000

{{Tip|Wayland セッションで日中の色温度を変更するには、[https://extensions.gnome.org/extension/1276/night-light-slider/ Night Light Slider 拡張]をインストールしてください。}}

{{Note|現在、NVIDIA カードを使用している場合、夜間モードは Wayland セッションで動作しません。}}

==== 日付と時刻 ====

システムに [[Network Time Protocol daemon]] が設定されている場合、GNOME でも適用されます。必要であれば、メニューから同期を手動に設定することも可能です。

ロケーションサービスが有効化されている場合 (設定の ''プライバシー'' セクションを見てください)、GNOME はタイムゾーンの自動選択をサポートします (システム設定の ''日付と時刻'' セクションで有効化できます)。

上部のバーに日付を表示するには、次を実行してください:

$ gsettings set org.gnome.desktop.interface clock-show-date true

さらに、上部のバーのカレンダーに週番号を表示するには、次を実行してください:

$ gsettings set org.gnome.desktop.calendar show-weekdate true

==== デフォルトアプリケーション ====

GNOME を初めてインストールしたとき、特定のプロトコルについて間違ったアプリケーションが開かれてしまうことがあります。例えば、動画を開いた時に [[VLC]] ではなく ''totem'' が起動してしまう、など。プロトコルによってはアプリケーションの関連付けをシステム設定の ''Default Apps'' から設定することができます。

他のプロトコルの設定については [[デフォルトアプリケーション]] を見て下さい。

==== マウスとタッチパッド ====

タッチパッドの大抵の設定はシステム設定の ''マウスとタッチパッド'' から行うことができます。

使用しているデバイスによっては、他の設定が使える場合もありますが、デフォルトの GUI では設定ができません。例えば、タッチパッドに以下のような {{ic|click-method}} の設定がある場合:

{{hc|$ gsettings range org.gnome.desktop.peripherals.touchpad click-method|
enum
'default'
'none'
'areas'
'fingers'
}}

手動で設定するには:

$ gsettings set org.gnome.desktop.peripherals.touchpad click-method 'fingers'

または、{{Pkg|gnome-tweaks}} で設定することもできます。

{{Note|1=GNOME は [[synaptics]] ドライバーをサポートしていません。代わりに [[libinput]] を使う必要があります。[https://bugzilla.gnome.org/show_bug.cgi?id=764257#c12 こちらのバグレポート]を参照。}}

===== マウスによるウィンドウサイズの変更 =====

デフォルトでは、{{ic|Super}} を押した状態でマウスの左ボタンでウィンドウをドラッグすることで、ウィンドウを移動させることができます。

さらに、{{ic|Super}} を押した状態でマウスの右ボタンでウィンドウをドラッグすることで、ウィンドウをリサイズするように設定することもできます:

$ gsettings set org.gnome.desktop.wm.preferences resize-with-right-button true

{{ic|Super}} 以外を使いたい場合は、{{ic|Alt}} や {{ic|Ctrl}} などの他の修飾キーに変更することもできます:

$ gsettings set org.gnome.desktop.wm.preferences mouse-button-modified "'<Alt>'"

==== ネットワーク ====

[[NetworkManager]] は GNOME プロジェクトのネイティブなツールであり、GNOME Shell からネットワークの設定を制御することができます。{{Pkg|networkmanager}} パッケージを[[インストール]]し、{{ic|NetworkManager.service}} systemd ユニットを[[有効化]]してください。

他の[[ネットワークマネージャ]]を使うこともできますが、NetworkManager は GNOME Shell のネットワーク設定やステータスインジケータアプレットの {{Pkg|network-manager-applet}} (GNOME の依存パッケージではありません) と完全に統合されています。

{{Note|1={{Pkg|networkmanager}} の ''nmtui'' でセットアップされた隠されたワイヤレスネットワークは、自動的に接続されません。そのようなネットワークで自動接続の機能を使うには GNOME コントロールセンターを使って新しいプロファイルを作成する必要があります。}}

==== オンラインアカウント ====

[[ownCloud]] などの一部のオンラインアカウントにおいては、[[GNOME Files]] や GNOME Documents などの GNOME アプリケーションで完全な機能を使用するために {{Pkg|gvfs-goa}} がインストールされている必要があります [https://wiki.gnome.org/ThreePointSeven/Features/Owncloud]。

詳細は [https://help.gnome.org/users/gnome-help/stable/accounts.html Online accounts] を見てください。

==== 検索 ====

GNOME シェルには検索機能が存在し、{{ic|Super}} キーを押してから入力することですぐにアクセスできます。{{Pkg|tracker3}} パッケージは {{Grp|gnome}} グループの {{Pkg|tracker3-miners}} の依存パッケージとしてデフォルトでインストールされます。このパッケージは、アプリケーションのインデックス生成とメタデータのデータベースを提供します。''検索とインデックス生成'' メニューアイテムから設定することができ、ステータスは {{ic|tracker3 status}} でクエリできます。ユーザーがログインしたときに ''gnome-session'' によって自動的に起動されます。{{ic|tracker3 daemon -s}} を実行することで手動でインデックス作成を開始することもできます。検索の設定は ''設定'' からでも行うことができます。

Tracker のデータベースは {{ic|tracker3 sparql}} コマンドを使うことでクエリできます。詳しくは {{man|1|tracker3-sparql}} を参照。

==== アクセシビリティ ====

GNOME には、''設定 > アクセシビリティ'' から利用できるアクセシビリティ設定があります。トップバーアイコンを有効にした後、主な設定を直接切り替えることができますが、''eeing'', ''Hearing'', ''Typing'', ''Pointing and clicking'', ''Zoom'' のサブメニューを介してさらなる設定が利用できることに注意してください。

==== デバイスのセキュリティ設定 ====

Gnome 43 には、設定に新しい [https://release.gnome.org/43/ Device Security] パネルが付属しています。これを機能させるには {{Pkg|fwupd}} が必要です。[https://gitlab.gnome.org/GNOME/gnome-control-center/-/issues/2122] を参照してください。

=== 高度な設定 ===

先に述べたように、[[GTK]] テーマや[[ウィンドウマネージャ]]のテーマなどの多くの設定オプションが GNOME 設定 (''gnome-control-center'') に公開されません。それらの設定を変更したい場合は、多くの設定を公開する便利なグラフィカルツールである GNOME Tweaks ({{Pkg|gnome-tweaks}}) を使うことができます。

また、{{man|1|dconf-editor}} (グラフィカルな DConf 設定ツール) や [https://developer.gnome.org/gio/stable/GSettings.html gsettings] コマンドラインツールを使って (DConf データベースに保存されている) GNOME の設定を変更することもできます。GNOME Tweaks には隠された設定は存在しません。しかし、以下のセクションで説明されている設定全てが GNOME Tweaks にあるわけではないことに注意してください。

==== 拡張機能 ====

拡張機能のカタログは https://extensions.gnome.org で見られます。拡張機能は[https://archlinux.org/packages/?q=gnome-shell-extension 公式リポジトリ] (数個だけです) や [https://aur.archlinux.org/packages?K=gnome-shell-extension AUR]、[https://extensions.gnome.org ブラウザ]からインストールできます。

{{Accuracy|以下のノートでは、手動によるユーザファイル管理の方が "簡単" だと言って推奨されていますが、理由が説明されていません。}}

{{Note|
* ブラウザーから拡張機能をインストールすると、現在のユーザーのみが使用できるようになり、それぞれを手動で更新する必要があります。これが最も簡単な方法です。
** さらに、ブラウザから拡張機能をインストールする場合は、{{Pkg|gnome-browser-connector}} をインストールする必要があります。公式リポジトリや AUR から拡張機能をインストールする必要はありません。
* AUR から (または、ある場合は公式リポジトリから) 拡張機能をインストールすると、システム全体で使用できるようになります ([[AUR ヘルパー]]を使用している場合は、更新プロセスが自動化されます)。
}}

インストールされた拡張機能は、''gnome-extensions-app'' で GUI から、{{man|1|gnome-extensions}} でコマンドラインから、またはブラウザから、設定/有効化/無効化することができます。ブラウザからでは、画面右上のスイッチを '''ON''' に設定し、ポップアップウィンドウで '''Install''' をクリックすることで、拡張機能をインストールしてブラウザで有効にすることができます。インストールされた拡張機能は、https://extensions.gnome.org/local/ に表示され、利用可能な更新を確認できます。

{{Pkg|gnome-shell-extensions}} パッケージは、GNOME プロジェクトの一部としてメンテナンスされている非常に便利な拡張機能のセットを提供します。

{{AUR|extension-manager}} は、拡張機能のインストールと削除、およびシステム全体とユーザーの両方の拡張機能の有効化と無効化にも使用できるグラフィカルツールです。使用する前に、よく知られている問題のリストを見てください: https://github.com/mjakeman/extension-manager/labels/bug

拡張機能の使用を有効にするには (デフォルトでは無効):

$ gsettings set org.gnome.shell disable-user-extensions false

現在有効になっている拡張機能を一覧表示するには:

$ gsettings get org.gnome.shell enabled-extensions

上記のコマンドは、すでに削除された拡張機能を表示する場合があります。有効 ''かつ'' インストールされている拡張機能のみを一覧表示するには、代わりに ''gnome-extensions'' を使用します:

$ gnome-extensions list --enabled

GNOME シェル拡張機能の詳細については、https://extensions.gnome.org/about/ を参照してください。

==== 外観 ====

===== テーマ =====

{{Note|[https://release.gnome.org/42/ Gnome 42] の時点で、多くのデフォルトの GNOME アプリケーションが libadwaita で GTK 4 を使用しています。現在、それらのアプリケーションは gsettings や {{pkg|gnome-tweaks}} によるテーマの変更をサポートしておらず、唯一のグラフィカルな設定方法は ''設定 > 外観'' です。Adwaita や Adwaita-dark 以外の GTK テーマを設定する方法については [[GTK#テーマ]] を参照してください。}}

GNOME はデフォルトで Adwaita を使用します。Adwaita-dark を GTK 2 アプリケーションのみに適用するには、以下のシンボリックリンクを使用します:

$ ln -s /usr/share/themes/Adwaita-dark ~/.themes/Adwaita

{{Note|Adwaita-dark テーマは {{Pkg|gnome-themes-extra}} によって提供されており、GNOME の最小インストールではインストールされない可能性があります。}}

新しいテーマを選択するには、(テーマを適切なディレクトリに移動して) GNOME Tweaks を使うか、以下の GSettings コマンドを使用してください。

GTK テーマの場合:

$ gsettings set org.gnome.desktop.interface gtk-theme ''theme-name''

アイコンテーマの場合:

$ gsettings set org.gnome.desktop.interface icon-theme ''theme-name''

{{Note|ウィンドウマネージャのテーマは GTK のテーマに従います。{{ic|org.gnome.desktop.wm.preferences theme}} を使うことは非推奨で無視されます。}}

[[GTK#テーマ]] と [[アイコン#アイコンテーマ]] を見て下さい。

===== タイトルバーのボタンの順番 =====

GNOME のウィンドウマネージャ (Mutter、Metacity) でボタンの順番を設定するには:

$ gsettings set org.gnome.desktop.wm.preferences button-layout ':minimize,maximize,close'

{{Tip|コロンは、タイトルバーのどちらの側にウィンドウのボタンを表示するかを表しています。}}

===== GNOME シェルのテーマ =====

GNOME Shell 自体のテーマも設定可能です。Shell のテーマを使うには、まず {{Pkg|gnome-shell-extensions}} がインストールされていることを確認してください。そして、''GNOME 拡張機能'' アプリケーションか [https://extensions.gnome.org GNOME Shell Extensions] ウェブページで ''User Themes'' 拡張を有効化してください。Shell のテーマは、''GNOME 拡張機能'' を使ってロードしたり選択したりできます。

多くの GNOME Shell テーマが [https://aur.archlinux.org/packages?K=gtk+theme AUR] で利用できます。多くのテーマは同じ形式の名前を使用していないため、AUR でテーマを検索してみてください。Shell のテーマは [https://gnome-look.org/ gnome-look.org] からダウンロードすることも可能です。

===== AppIndicators/Top バーのアイコン =====

AppIndicators (バックグラウンドで動作する特定のアプリケーションを制御/監視する際に便利です) を有効化するには、{{Pkg|gnome-shell-extension-appindicator}} か {{AUR|gnome-shell-extension-appindicator-git}} をインストールし、[[#ナビゲーション|GNOME Shell を再起動]]し、''GNOME 拡張機能'' アプリケーションで AppIndicator を有効化するか以下を実行してください:

$ gnome-extensions enable $(gnome-extensions list {{!}} grep -m 1 appindicatorsupport)

===== アニメーションの速度 =====

GNOME シェルのアニメーションは、速度を上げたり、遅くしたり、無効にしたりできます。[[GNOME/ヒントとテクニック#アニメーション速度を変更する]] を参照してください。

===== Shell のぼかし =====

Blur my Shell は、概要画面だけでなく、シェル自身や他のアプリにぼかし効果を追加する拡張機能です。{{AUR|gnome-shell-extension-blur-my-shell}} か {{AUR|gnome-shell-extension-blur-my-shell-git}} (開発アップデート) をインストールしてください。この拡張機能は高度にカスタマイズ可能で、ぼかしをかけるアプリケーションを選択することができます。

===== Alt-Tab でカバーフロー =====

GNOME のデフォルトの Alt-Tab は非常にシンプルで、選択されたウィンドウの概要が表示されることはありません。Coverflow Alt-Tab は Alt-Tab の動作を拡張し、アプリケーション間の切り替えをより簡単にする機能を追加し、さらに見栄えも良くする拡張機能です。{{AUR|gnome-shell-extension-coverflow-alt-tab-git}} をインストールすれば、この拡張機能の設定を好みに合わせて変更することができます。

==== 自動起動 ====

GNOME は [[XDG Autostart]] を実装しています。

{{Pkg|gnome-tweaks}} で自動起動のエントリを管理することができます。

{{Tip|1=Tweaks の ''スタートアップアプリケーション'' セクションにあるプラス記号ボタンが反応しない場合は、次のコマンド {{ic|gnome-tweaks}} を使用してターミナルから Tweaks を起動してみてください。以下の [https://bbs.archlinux.org/viewtopic.php?pid=1413631#p1413631 フォーラムスレッド]を参照してください。}}

{{Note|非推奨となった ''gnome-session-properties'' ダイアログは、{{AUR|gnome-session-properties}} パッケージを[[インストール]]することで追加できます。これにより、''gnome-tweaks'' では許可されていない、システム全体で自動起動するアプリケーションを無効にする機能も提供されます。}}

==== デスクトップ ====

===== Dash to Dock =====

ダッシュをオーバービューの外に出して、アプリケーションを簡単に起動・切り替えできるドックにするには、{{AUR|gnome-shell-extension-dash-to-dock}} を[[インストール]]します。

===== オーバービューモードでの起動 =====

GNOME 40 からは、(以前のバージョンのように) 空のデスクトップではなく、直接オーバービューモードで起動するようになりました。{{AUR|gnome-shell-extension-no-overview}} を[[インストール]]することで、以前の挙動を模倣させることができます。

または、{{AUR|gnome-shell-extension-dash-to-dock}} を使用している場合、gsettings を使ってこの挙動を無効化できます:

$ gsettings set org.gnome.shell.extensions.dash-to-dock disable-overview-on-startup true

[https://discourse.gnome.org/t/gnome-40-login-is-to-the-activities-overview-mode-how-do-you-disable-this/5783] での議論を参照してください。

==== クリップボードの履歴 ====

他のデスクトップ環境とは異なり、GNOME にはクリップボードの履歴を管理するためのビルトインツールがありません。しかし、拡張機能の助けを借りて、これを行うことができます。{{AUR|gnome-shell-extension-clipboard-indicator}} をインストールして下さい。

==== 天気 ====

選択した場所に基づいて現在の天気情報をトップパネルに表示するには、{{AUR|gnome-shell-extension-openweather}} をインストールしてください。天気情報はリアルタイムで更新され、天候、風速、気圧などの有用な情報を表示します。

==== サウンド入出力デバイスセレクター ====

{{Accuracy|おそらく、GNOME 43 の時点ではもはや必要ありません。}}

デフォルトでは、サウンドの入出力デバイスを変更したり、マイクの音量を変更したい場合、GNOME Control Center を開いて、そこからこれらの設定を行う必要があります。デバイスセレクターとマイクのボリュームスライダーを統合するには、{{AUR|gnome-shell-extension-sound-output-device-chooser}} か {{AUR|gnome-shell-extension-sound-output-device-chooser-git}} をインストールしてください。インストール後にさらに設定を行うことができます。

==== フォント ====

{{Tip|''倍率'' を 1.00 より大きい値に設定した場合、アクセシビリティメニューが自動的に有効になります。}}

ウィンドウタイトル、インターフェイス (アプリケーション)、ドキュメントやモノスペースのフォントを設定することができます。gnome-tweaks の ''フォント'' タブにあるオプションを見て下さい。

サブピクセルレンダリングについては大抵のモニターに適合する RGBA が良いでしょう。フォントの表示がおかしい場合は ''弱'' や ''なし'' にまでヒンティングを減らして下さい。

==== インプットメソッド ====

Gnome は [[IBus]] によって[[インプットメソッド]]の統合的なサポートをしており、インストールする必要があるのは {{Pkg|ibus}} と必要なインプットメソッドエンジン (例: Intelligent Pinyin の場合 {{Pkg|ibus-libpinyin}}) だけです。インストール後、GNOME 設定 (''gnome-control-center'') の ''キーボード > 入力ソース'' からインプットメソッドエンジンをキーボードレイアウトとして追加できます。

==== キーボード配列の癖 ====

Neo2 のような複数のレイヤー/モディファイアを使う代替キーボードレイアウトを使っている場合、GNOME 設定 (''gnome-control-center'') の ''キーボード > 特殊文字の入力'' で ''代替文字キー'' を ''右 Alt'' から変更して、キーボードレイアウトのネイティブモディファイアとして使えるようにしなければならない場合があります。例えば、''左 Alt'' に設定すると、''Alt+Tab'' ができなくなるので、変更する場合は注意が必要です。
この変更をしないと、左の ''Mod3'' キーは動作するかもしれませんが、右のキー (''AltGr'') は動作しないかもしれません。(2021-05-18現在)

==== 電源 ====

ノート PC を使用している場合、アイドル時や電源ボタンが押された時、蓋が閉じられたときの挙動を制御する以下の設定を変更したい場合があります:

$ gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-timeout ''3600''
$ gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-type ''hibernate''
$ gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-timeout ''1800''
$ gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-battery-type ''hibernate''
$ gsettings set org.gnome.settings-daemon.plugins.power power-button-action ''suspend''
$ gsettings set org.gnome.desktop.lockdown disable-lock-screen ''true''

フタを閉じた時でもモニターの電源を切らないようにするには:

$ gsettings set org.gnome.settings-daemon.plugins.xrandr default-monitors-setup do-nothing

GNOME 3.24 では以下の設定が廃止されました:

org.gnome.settings-daemon.plugins.power button-hibernate
org.gnome.settings-daemon.plugins.power button-power
org.gnome.settings-daemon.plugins.power button-sleep
org.gnome.settings-daemon.plugins.power button-suspend
org.gnome.settings-daemon.plugins.power critical-battery-action

===== ノートパソコンの蓋が閉まってもサスペンドさせない =====

GNOME の設定パネルには、ラップトップの蓋が閉じたときに起動する動作をユーザが変更するためのオプションがありません。しかし、{{Pkg|gnome-tweaks}} は {{Pkg|systemd}} によって適用される設定を上書きすることができます。''全般'' タブで、''ラップトップの蓋を閉じるとサスペンドする'' をオフにしてください。そうすると、システムは蓋を閉じたときに ''Suspend to RAM (S3)'' をしなくなります。

システム全体で蓋スイッチの動作を変更するには、上記の設定が '''off でない''' ことを確認し、{{ic|/etc/systemd/logind.conf}} の systemd 設定を編集してください。蓋を閉じた時のサスペンドをオフにするには、[[電源管理#ACPI イベント]] で説明されているように {{ic|1=HandleLidSwitch=ignore}} を設定してください。

===== バッテリー残量が少なくなった時の動作を変更する =====

設定パネルにはバッテリーが少なくなったときに行うアクションを変更するオプションは存在しません。dconf からも設定は削除されています。現在は upower によって管理されているので、{{ic|/etc/UPower/UPower.conf}} で upower の設定を変更してください。以下の設定を適宜修正してください:

{{hc|head=/etc/UPower/UPower.conf|output=
PercentageLow=10
PercentageCritical=3
PercentageAction=2
CriticalPowerAction=HybridSleep
}}

===== 電源モード =====

電源プロファイルをサポートするために、({{Pkg|gnome-control-center}} の) 任意の依存パッケージである [[power-profiles-daemon]] をインストールしてください。''gnome-shell'' と GNOME Settings は両方とも起動時に {{ic|power-profiles-daemon}} のアクティブ化をリクエストするので、このサービスを明示的に[[起動/有効化]]する必要はありません。

このサービスがアクティブである時、電源プロファイルは GNOME 設定とシステムメニューの ''電源'' セクションで管理できます。

==== スクリーンキャスト ====

組み込みのスクリーンショットツールには、デフォルトではスクリーンキャストオプションがありません。({{Pkg|gnome-shell}} の) 任意の依存パッケージである {{Pkg|gst-plugin-pipewire}} をインストールすることで、画面の録画が可能になります。

=== 別のウィンドウマネージャを使う ===

GNOME Shell は別の[[ウィンドウマネージャ]]の使用をサポートしていませんが、[[GNOME Flashback]] は Metacity と [[Compiz]] のセッションを提供します。さらに、代替のコンポーネントを使用する独自の[[GNOME/ヒントとテクニック#カスタム GNOME セッション|カスタムの GNOME セッション]]を定義することができます。

[[Wayland]] 環境下では、GNOME Shell を別のコンポジターに置き換えると、{{Pkg|gnome-control-center}} (GNOME 設定) の特定セクションが正しく表示されなくなります。"gnome-control-center" は動作しますが、{{Pkg|mutter}} (GNOME Shell) がこれらのセクションの表示に必要な設定を提供できないため、設定が反映されなかったり、設定内容が正確に表示されなかったりします。影響を受けるセクションには、bluetooth、ディスプレイ、マウス/タッチパッドなどがあります。

== 参照 ==

* [https://www.gnome.org/ 公式ウェブサイト]
* [https://blogs.gnome.org/tbernard/2021/06/15/community-power-2/ GNOME への貢献、機能リクエスト、バグ、コード]
* [[Wikipedia:ja:GNOME|Wikipedia 記事]]
* [https://extensions.gnome.org/ GNOME-Shell 拡張]
* [https://wiki.gnome.org/Projects/GnomeShell/CheatSheet GNOME Shell チートシート]
* カスタマイズ (テーマやアイコンなど):
** [https://wiki.gnome.org/Personalization Personalize GNOME]
** [https://www.gnome-look.org/ GNOME Look]
* GNOME アプリケーション:
** [https://wiki.gnome.org/Apps GNOME アプリインデックス]
** [[Wikipedia:ja:GNOME Core Applications]]
* GNOME ソース/ミラー:
** [https://gitlab.gnome.org/ GNOME GitLab]
** [https://github.com/GNOME GNOME Github ミラー]

{{TranslationStatus|GNOME|2023-08-01|783436}}

ドットファイル

2025-05-15T02:16:31Z

Kgx: /* Git を使ってドットファイルを直接管理する */

[[Category:設定ファイル]]
[[Category:設定管理]]
[[en:Dotfiles]]
[[es:Dotfiles]]
[[pt:Dotfiles]]
[[zh-hans:Dotfiles]]
{{Related articles start}}
{{Related|XDG Base Directory サポート}}
{{Related|X resources}}
{{Related articles end}}

ユーザー固有のアプリケーション設定は、伝統的に [[Wikipedia:dotfile|ドットファイル]](ファイル名がドットで始まるファイル) に保存されています。変更を追跡し、さまざまなホスト間でドットファイルを同期するために、[[Git]] などの [[バージョン管理システム]] でドットファイルを管理することは一般的な方法です。ドットファイルを管理するには、さまざまな方法があります(例えば、ホームディレクトリでドットファイルを直接追跡する、サブディレクトリに保存する、[[シェル]]スクリプトや[[#他のツール|専用ツール]] でファイルをシンボリックリンク/コピー/生成するなど)。ドットファイルの管理方法とは別に、この記事には、[[#リポジトリ|ドットファイルのリボジトリのリスト]] も含まれています。

== Git を使ってドットファイルを直接管理する ==

ドットファイルを直接 Git で追跡することの利点は、[[Git]] だけで済み、シンボリックリンクを必要としないことです。デメリットは、[[#ホスト固有の設定|ホスト固有の設定]] では一般的に複数の [[Git#Branching|branches]] に変更をマージする必要があるということです。

このアプローチを実現する最も簡単な方法は、[[Git]] リポジトリをホームディレクトリで直接初期化し、デフォルトで {{man|5|gitignore}} パターンの {{ic|*}} を使用してすべてのファイルを無視することです。ただし、この方法には 2 つの欠点があります。ホームディレクトリに他の Git リポジトリがある場合は混乱する可能性があります (たとえば、リポジトリの初期化を忘れた場合、突然 dotfile リポジトリを操作することになります) また、ディレクトリ内のどのファイルが簡単に確認できなくなります。現在のディレクトリは追跡されません (無視されるため)

これらの欠点を避けるための代替方法として、"bare repository and alias method" があります。この方法は、[https://news.ycombinator.com/item?id=11071754 Ask Hacker News: What do you use to manage your dotfiles?] で広く知られるようになったもので、たった3つのコマンドでセットアップが可能です:

$ git init --bare ~/.dotfiles
$ alias config='/usr/bin/git --git-dir=$HOME/.dotfiles/ --work-tree=$HOME'
$ config config status.showUntrackedFiles no

{{note|通常、ドットファイルのパーミッションはすべてデフォルトの設定のままで問題ありませんが、特定のファイルに特定のパーミッションが必要な場合は、別の方法を検討する必要があります。Git はファイルのパーミッションを保存しないためです。}}

このドットファイルを使って新しいシステムに複製できます:

$ git clone --bare <git-repo-url> $HOME/.dotfiles
$ alias config='/usr/bin/git --git-dir="$HOME/.dotfiles/" --work-tree="$HOME"'
$ config checkout
$ config config --local status.showUntrackedFiles no

* リモートリポジトリを使わずにこれを行うには、[[git#バンドル|git bundles]] を使用できます。ソースコンピュータで {{ic|dotfiles.bundle}} という名前の git バンドルを作成するには、次のコマンドを実行します:
:{{bc|<nowiki>
$ dotfiles bundle create --progress dotfiles.bundle --all
</nowiki>}}

:バンドルは {{ic|<git-repo-url>}} と同様に使用できます:
:{{bc|<nowiki>
$ git clone --bare dotfiles.bundle $HOME/.dotfiles
</nowiki>}}

* 上書きされる可能性のあるいくつかのストック設定がすでにある場合は、次のようなエラーが発生します:
:{{bc|<nowiki>
$ config checkout
error: The following untracked working tree files would be overwritten by checkout:
.bashrc
.gitignore
Please move or remove them before you can switch branches.
Aborting
</nowiki>}}

:既存のファイルを書き換える {{ic|$ config checkout -f}} を使用することもできます。または、より安全な方法として、次のスクリプトを使用してすべてのファイルのバックアップを取得し、{{ic|checkout}} を使用することもできます:
:{{bc|<nowiki>
mkdir -p .config-backup && \
config checkout 2>&1 | egrep "\s+\." | awk {'print $1'} | \
xargs -I{} mv {} .config-backup/{}
</nowiki>}}

その後、作成した [[エイリアス]] でドットファイルを管理することができます。もし [[Bash]] を使っていてこのエイリアスを bash 補完したい場合は、{{AUR|bash-complete-alias}} をインストールして、エイリアスと次の行を {{ic|~/.bashrc}} に追加してください。

$ complete -F _complete_alias config

bash で補完させるもう一つの方法は、{{ic|~/.bashrc}} に以下を追加することです。([https://askubuntu.com/a/642778] から引用):

source /usr/share/bash-completion/completions/git
__git_complete config __git_main

{{Tip|機密情報を誤ってコミットしないようにするには、[https://wiki.archlinux.org/title/Git#Filtering_confidential_information Git#Filtering confidential information] を参照してください。}}

== ホスト固有の設定 ==

様々なマシンで dotfiles を同期させる際によくある問題が、ホスト固有の設定です。

[[Git]] では、すべての共有設定を master ブランチで管理し、個々のマシンにはマシン固有のブランチをチェックアウトすることでこれを解決できます。ホスト固有の設定はマシン固有のブランチにコミットすることができます。共有設定が master ブランチで変更された場合、マシンごとのブランチは更新された master の上にリベースされる必要があります。

[[コマンドラインシェル#設定ファイル|シェル設定ファイル]] のような設定スクリプトでは、条件付きロジックを使用することができます。例えば、[[Bash]] スクリプト (すなわち {{ic|.bashrc}}) は、マシン名 (またはタイプ、カスタム変数など) に応じて異なる設定を適用することができます。

if <nowiki>[[ "$(hostname)" == "archlaptop" ]];</nowiki> then
# laptop specific commands here
else
# desktop or server machine commands
fi

同様のことは、[[.Xresources]] でも実現できます。[https://jnrowe.github.io/articles/tips/Sharing_Xresources_between_systems.html]

Git ブランチのリベースが面倒だと感じる場合は、''ファイルのグループ化'' をサポートする [[#Tools|ツール]] や、さらに柔軟性を求めるなら ''加工処理'' を行うツールを使用するとよいでしょう。

== ツール ==

;ファイルのグループ化
:設定ファイルを設定グループ (プロファイルまたはパッケージとも呼ばれる) にグループ化する方法です。
処理
:ホストによってカスタマイズできるように、設定ファイルを処理するツールもあります。

{| class="wikitable sortable" style="text-align: center;"
! 名前 !! パッケージ !! 言語 !! ファイルのグループ化 !! 処理
|-
! [https://github.com/anishathalye/dotbot dotbot]
| {{Pkg|chezmoi}} || Python || 設定ファイル || {{Grey|No}}
|-
! [https://github.com/twpayne/chezmoi chezmoi]
| {{AUR|dotbot}} || Go || ディレクトリベース || Go テンプレート
|-
! [https://github.com/kesslern/dot-templater dot-templater]
| {{AUR|dot-templater-git}} || Rust || ディレクトリベース || カスタムシンタックス
|-
! [https://github.com/oknozor/toml-bombadil toml-bombadil]
| {{Pkg|toml-bombadil}} || Rust || 設定ファイル || tera
|-
! [https://deadc0de.re/dotdrop/ dotdrop]
| {{AUR|dotdrop}} || Python || 設定ファイル || Jinja2
|-
! [https://github.com/jbernard/dotfiles dotfiles]
| {{AUR|dotfiles}} || Python || {{Grey|[https://github.com/jbernard/dotfiles/pull/24 No]}} || {{Grey|No}}
|-
! [https://github.com/EvanPurkhiser/dots Dots]
| {{AUR|dots-manager}} || Python || ディレクトリベース || カスタム追加ポイント
|-
! [https://github.com/SuperCuber/dotter dotter]
| {{AUR|dotter-rs}} || Rust || 設定ファイル || Handlebars
|-
! [https://dt.cli.rs dt-cli]
| {{AUR|dt-cli}} || Rust || 設定ファイル || Handlebars
|-
! [https://www.gnu.org/software/stow/ GNU Stow]
| {{Pkg|stow}} || Perl || ディレクトリベース [http://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html] || {{Grey|No}}
|-
! [https://github.com/lra/mackup Mackup]
| {{AUR|mackup}} || Python || アプリケーションごとに自動 || {{Grey|No}}
|-
! [https://github.com/darkfeline/mir.qualia mir.qualia]
| {{AUR|mir.qualia}} || Python || {{Grey|No}} || カスタムブロック
|-
! [https://github.com/thoughtbot/rcm rcm]
| {{AUR|rcm}} || Perl || ディレクトリベース (ホストまたはタグによる) || {{Grey|No}}
|-
! [https://github.com/sebastiancarlos/yas-bdsm yas-bdsm]
| {{-}} || Shell || ディレクトリベース || {{Grey|No}}
|}

=== Git を wrapping するツール ===

[[Git]] に不安がある場合は、バージョン管理システムを (多かれ少なかれ) 抽象化するこれらのツールのいずれかを使用することをお勧めします。

{| class="wikitable sortable" style="text-align:center;"
! 名前 !! パッケージ !! 言語 !! ファイルのグループ化 !! 処理
|-
! [https://github.com/kazhala/dotbare dotbare]
| {{AUR|dotbare}} || Shell ({{Pkg|fzf}}) || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/kobus-v-schoor/dotgit dotgit]
| {{AUR|dotgit}} || Python || ファイル名ベース || {{Grey|No}}
|-
! [https://github.com/andsens/homeshick homeshick]
| {{AUR|homeshick-git}} || Bash || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/technicalpickles/homesick homesick]
| {{-}} || Ruby || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/pearl-core/pearl Pearl]
| {{AUR|pearl-git}} || Python || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/RichiH/vcsh vcsh]
| {{Pkg|vcsh}} || Shell || リポジトリ的 || {{Grey|No}}
|-
! [https://yadm.io yadm](1)
| {{Pkg|yadm}} || Bash || ファイル名ベース (by class/OS/distro/hostname/user)[https://yadm.io/docs/alternates] ||組み込みのテンプレート /Jinja2/ESH [https://yadm.io/docs/templates] (オプション)
|-
! [https://github.com/justone/dotfiles dfm]
| {{AUR|dfm}} || Perl || リポジトリ的 || {{Grey|No}}
|}

# [[GPG]] または OpenSS による機密ファイルの暗号化をサポートします。 [https://yadm.io/docs/encryption]

== ユーザーリポジトリ ==

{{Note|このテーブルは、ドットファイルの参照/例として使用して下さい。ドットファイルをテーブルに追加する場合は、それらがクリーンでコメントされていて、最新の状態に保たれているかを確認してください。}}
{{Warning|これらのドットファイルは Arch Linux スタッフによって検証されていないため、自己責任で使用してください。}}

{| class="wikitable sortable" style="text-align:center"
! 作者 || シェル || WM / DE || エディタ || ターミナル || マルチプレクサ || オーディオ || モニター || メール || IRC || ファイルマネージャ || RSS リーダー
|-
! [https://github.com/adamperkowski/dwm adamperkowski]
| [[Zsh]] || [[dwm]] || [[Neovim]] || [[Kitty]] || [[tmux]] || [[Mpv]] || custom || || [[WeeChat]] || ||
|-
! [https://github.com/alfunx/.dotfiles alfunx]
| [[Zsh]] || [[Awesome]] || [[Vim]] || [[Kitty]] || [[tmux]] || [[Ncmpcpp]]/[[Mpd]] || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]]/lain || [[Thunderbird]] || || ||
|-
! [https://gitlab.com/Ambrevar/dotfiles Ambrevar]
| Eshell || [[EXWM]] || [[Emacs]] || Emacs (Eshell) || Emacs TRAMP + dtach || EMMS || [[Conky]]/[[Dzen]] || mu4e || Circe || ||
|-
! [https://github.com/ask1234560/dotfiles_bspwm ananthu]
| [[Zsh]] || [[Bspwm]] || [[Neovim]] || [[Alacritty]] || || [[Mpv]] || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]], [[Polybar]] || [[Neomutt]] || [[WeeChat]] || [[Ranger]] ||
|-
! [https://github.com/awalGarg/dotfiles awal]
| [[Fish]] || [[i3]] || [[Vim]] || [[St]] || [[tmux]] || || i3status || || The Lounge || ||
|-
! [https://github.com/ayekat/localdir ayekat]
| [[Zsh]] || karuiwm || [[Vim]] || [[Rxvt-unicode]] || [[tmux]] || [[Ncmpcpp]]/[[Mpd]] || karuibar || [[Mutt]] || [[Irssi]] || ||
|-
! [https://github.com/BachoSeven/dotfiles bachoseven]
| [[Zsh]] || [[Dwm]] [https://github.com/BachoSeven/dwm source] || [[Neovim]] || [[St]] [https://github.com/BachoSeven/st source] || [[tmux]] || [[Ncmpcpp]] || bottom || [[Neomutt]] || [[WeeChat]] || [[Lf]] || [[newsboat]]
|-
! [https://github.com/bamos/dotfiles bamos]
| [[Zsh]] || [[i3]]/[[xmonad]] || vim/emacs || rxvt-unicode || [[tmux]] || mpv/cmus || conky/xmobar || mutt || ERC || ||
|-
! [https://github.com/benmezger/dotfiles benmezger]
| [https://github.com/benmezger/dotfiles zsh/bash] || [https://github.com/benmezger/dotfiles/tree/main/dot_config/i3 i3-gaps] || [https://github.com/benmezger/dotfiles/tree/main/dot_doom.d emacs] || [https://github.com/benmezger/dotfiles/blob/main/dot_Xresources rxvt-unicode]/[https://github.com/benmezger/dotfiles/blob/main/dot_config/alacritty/ alacritty] || [https://github.com/benmezger/dotfiles/blob/main/dot_tmux.conf tmux] || mopidy/ncmpcpp || [https://github.com/benmezger/dotfiles/blob/main/dot_config/i3/status.toml.tmpl i3status-rs] || [https://github.com/benmezger/dotfiles/blob/main/dot_doom.d/ mu4e]/[https://github.com/benmezger/dotfiles/blob/main/dot_config/neomutt neomutt]/[https://github.com/benmezger/dotfiles/blob/main/dot_mbsyncrc.tmpl mbsync] || [https://github.com/benmezger/dotfiles/blob/main/dot_weechat/ weechat] || ||
|-
! [https://github.com/pbrisbin/dotfiles brisbin33]
| [https://github.com/pbrisbin/oh-my-zsh zsh] || [https://github.com/pbrisbin/xmonad-config xmonad] || [https://github.com/pbrisbin/vim-config vim] || rxvt-unicode || [[GNU Screen]] || || dzen || [https://github.com/pbrisbin/mutt-config mutt] || [https://github.com/pbrisbin/irssi-config irssi] || ||
|-
! [https://gitlab.com/BVollmerhaus/dotfiles BVollmerhaus]
| [https://gitlab.com/BVollmerhaus/dotfiles/-/tree/master/config/fish fish] || [https://gitlab.com/BVollmerhaus/dotfiles/blob/master/config/i3/config i3-gaps] || [https://gitlab.com/BVollmerhaus/dotfiles/blob/master/config/kak/kakrc kakoune] || [https://gitlab.com/BVollmerhaus/dotfiles/-/blob/master/config/kitty/kitty.conf kitty] || || || [https://gitlab.com/BVollmerhaus/dotfiles/blob/master/config/polybar/config polybar] || || || [https://gitlab.com/BVollmerhaus/dotfiles/-/tree/master/config/ranger ranger] ||
|-
! [https://github.com/christian-heusel/dotfiles christian-heusel]
| [[Zsh]] || [[i3]] || [[Neovim]] || [[st]] / [[terminator]] || byobu / [[tmux]] || || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]] || [[neomutt]]/[[thunderbird]] || [[WeeChat]] || [[nemo]] / [[ranger]] ||
|-
! [https://github.com/CuterThanYou/dotfiles CuterThanYou]
| [[Zsh]] || [[i3]] / [[Hyprland]] || [[Neovim]] || [[Alacritty]] / [[Foot]] || || [[Mpv]] || [[Polybar]] / Yambar || || || [[Lf]] / [[Thunar]] ||[[Newsboat]]
|-
! [https://github.com/cinelli/dotfiles cinelli]
| [[Zsh]] || dwm || [[Vim]] || termite-git || || pianobar || htop || mutt-kz || weechat || ||
|-
! [https://github.com/dikiaap/dotfiles dikiaap]
| [[Zsh]] || [[i3]]-gaps || neovim || alacritty || [[tmux]] || || i3blocks || || || nnn ||
|-
! [https://github.com/Earnestly/dotfiles Earnestly]
| [[Zsh]] || [[i3]]/orbment || vim/emacs || termite || [[tmux]] || mpd || conky || mutt || weechat || ||
|-
! [https://github.com/ErikBjare/dotfiles ErikBjare]
| [[Zsh]] || [[xmonad]]/[[Xfce|Xfce4]] || [[Vim]] || terminator || [[tmux]] || || xfce4-panel || || weechat || ||
|-
! [https://github.com/erikw/dotfiles erikw]
| [[Zsh]]/[[Bash]] || DWM/macOS || NeoVim || urxvtc || [[tmux]] || mpd || || mutt || irssi || ||
|-
! [https://github.com/falconindy/dotfiles falconindy]
| [[Bash]] || [[i3]] || [[Vim]] || rxvt-unicode || || ncmpcpp || conky || mutt || || ||
|-
! [https://github.com/filiparag/dotfiles filiparag]
| [[fish]] || bspwm || [[Vim]] || alacritty || [[tmux]] || mpv, [https://github.com/altdesktop/playerctl playerctl] || htop, polybar || [https://www.nongnu.org/mailnotify/ mail-notification] || || [[PCManFM]] ||
|-
! [https://github.com/Freed-Wu/Freed-Wu Freed-Wu]
| [[zsh]] || [[openbox]] || [[neovim]] || [[wezterm]] || [[tmux]] || [[cmus]] || bottom || [[neomutt]] || [[WeeChat]] || [[neovim]] || [[newsboat]]
|-
! [https://git.sr.ht/~gardenapple/dotfiles gardenapple]
| [[Zsh]] ([https://git.sr.ht/~gardenapple/dotfiles/tree/main/item/stow/zsh/.zshrc fish-like]) || [[Hyprland]] || [[neovim]] || [[kitty]] || || || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]] || [[aerc]] || || [[vifm]] || [[Newsboat]]
|-
! [https://github.com/graysky2/configs/tree/master/dotfiles graysky]
| [[Zsh]] || Xfce|xfce4 || [[Vim]] || terminal || || ncmpcpp || custom || thunderbird || || ||
|-
! [https://github.com/hugdru/dotfiles hugdru]
| [[Zsh]] || awesome || neovim || rxvt-unicode || [[tmux]] || || || thunderbird || weechat || ||
|-
! [https://github.com/insanum/dotfiles insanum]
| [[Bash]] || herbstluftwm || [[Vim]] || evilvte || [[tmux]] || || dzen || mutt-kz || || ||
|-
! [https://github.com/isti115/dotfiles isti115]
| [https://github.com/Isti115/dotfiles/blob/master/.config/powershell/Microsoft.PowerShell_profile.ps1 pwsh]
|| [https://github.com/Isti115/dotfiles/blob/master/.config/sway/config sway]
|| [https://github.com/Isti115/dotfiles/tree/master/.config/nvim neovim]
|| [https://github.com/Isti115/dotfiles/blob/master/.config/alacritty/alacritty.yml alacritty]
|| [[tmux]]
|| [https://github.com/Isti115/dotfiles/tree/master/.config/mpv mpv] / playerctl
|| [https://github.com/Isti115/dotfiles/tree/master/.config/waybar waybar] / htop / ytop
||
||
|| [https://github.com/Isti115/dotfiles/tree/master/.config/ranger ranger]
||
|-
! [https://hg.sr.ht/~jasonwryan/shiv jasonwryan]
| bash/zsh || dwm || [[Vim]] || rxvt-unicode || [[tmux]] || ncmpcpp || custom || mutt || irssi || ||
|-
! [https://github.com/JDevlieghere/dotfiles/ jdevlieghere]
| [[Zsh]] || xmonad || [[Vim]] || terminal || [[tmux]] || || htop || mutt || weechat || ||
|-
! [https://github.com/jelly/Dotfiles jelly]
| [[Zsh]] || [[i3]] || [[Vim]] || termite || [[tmux]] || ncmpcpp || || mutt-kz-git || weechat || ||
|-
! [https://gitlab.com/jlo62/dotties jl2]
| [[Zsh]] || swayfx || geany || [[foot]] || || || missioncenter, eww (bar) || || srain || [[thunar]] ||
|-
! [https://github.com/markuszoppelt/dotfiles MarkusZoppelt]
| [[Zsh]] || gnome || [[Neovim]] || [[Alacritty]] || [[tmux]] || || || || || ||
|-
! [https://github.com/maximbaz/dotfiles maximbaz]
| [[Zsh]] || sway || kakoune || kitty || || || waybar || neomutt || || nnn ||
|-
! [https://code.mehalter.com/dotfiles mehalter]
| [[Zsh]] || [[i3]]-gaps || neovim || termite || [[tmux]] || cmus || gotop || neomutt || weechat || ranger ||
|-
! [https://github.com/meskarune/.dotfiles meskarune]
| [[Bash]] || herbstluftwm || [[Vim]] || rxvt-unicode || [[GNU Screen]] || || conky || || weechat || ||
|-
! [https://github.com/neersighted/dotfiles neersighted]
| [[fish]] || [[i3]] || neovim || alacritty || [[tmux]] || ncmpcpp || || || || ||
|-
! [https://github.com/nimaipatel/dotfiles nimaipatel]
| [[fish]] || awesome|| neovim || alacritty || || ncmpcpp || || || || ||
|-
! [https://github.com/oibind/dotfiles oibind]
| [[fish]] || awesome || neovim || st || [[tmux]] || || htop-vim || || weechat || lf ||
|-
! [https://github.com/ok100/configs OK100]
| [[Bash]] || dwm || [[Vim]] || rxvt-unicode || || cmus || conky, dzen || mutt || weechat || ||
|-
! [https://github.com/orhun/dotfiles orhun]
| [[Bash]] || [[i3]]-gaps || neovim || alacritty || || || i3status || || weechat || tere ||
|-
! [https://github.com/pablox-cl/dotfiles pablox-cl]
| zsh (zplug) || [[GNOME]] || neovim || kitty || || || || || || ||
|-
! [https://github.com/patri9ck/dotfiles patri9ck]
| [[Zsh]] || [[bspwm]] || [[Vim]] || [[kitty]] || || || || || || [[Thunar]] ||
|-
! [https://gitlab.com/peterzuger/dotfiles peterzuger]
| [[Zsh]] || [[i3]]-gaps || emacs || rxvt-unicode || [[GNU Screen]] || moc || htop || || || ||
|-
! [https://gitlab.com/polyzen/dotfiles polyzen]
| [[Zsh]] || [[i3]] || Neovim || Alacritty || [[tmux]] || mpv || i3status,htop || himalaya || || ranger || Newsboat
|-
! [https://github.com/potamides/dotfiles potamides]
| [[Bash]] || awesome || neovim || termite || [[tmux]] || ncmpcpp || conky,htop || mutt || weechat || ranger ||
|-
! [https://github.com/reisub0/dot reisub0]
| [[fish]] || qtile || neovim || kitty || || mpd || conky || || || ||
|-
! [https://github.com/sistematico/majestic sistematico]
| zsh/fish/bash || [https://github.com/Airblader/i3 i3-gaps] || vim/nano || termite || [[tmux]] || ncmpcpp || polybar || mutt || weechat || ||
|-
! [https://git.sr.ht/~thecashewtrader/dotfiles thecashewtrader]
| Eshell || EXWM || Emacs || Emacs (VTerm) || Emacs || Bongo || htop || mu4e || ERC || Dired || Elfeed
|-
! [https://github.com/thiagowfx/.dotfiles thiagowfx]
| bash/zsh || [[i3]] || [[Vim]] || alacritty || [[tmux]] || playerctl || i3status || || || ranger ||
|-
! [https://codeberg.org/tplasdio/dotfiles tplasdio]
| [https://codeberg.org/tplasdio/bash-config bash (ble.sh)] || [https://codeberg.org/tplasdio/awesomewm-config awesome] || [https://codeberg.org/tplasdio/neovim-config neovim] || [https://codeberg.org/tplasdio/dotfiles/src/branch/main/.config/alacritty/alacritty.yml alacritty] || [https://codeberg.org/tplasdio/dotfiles/src/branch/main/.config/byobu/.tmux.conf tmux] || [https://codeberg.org/tplasdio/mpv-config mpv], mpvs || htop || neomutt || weechat || [https://codeberg.org/tplasdio/lf-config lf] ||
|-
! [https://github.com/tuurep/dotfiles tuurep]
| [[Bash]] || openbox || neovim || alacritty || [[tmux]] || || polybar || || || ||
|-
! [https://git.sr.ht/~unrealapex/dotfiles unrealapex]
| [[Zsh]] || [[Dwm]] || [[Neovim]] || [[St]] || || [[Ncmpcpp]] || htop || [[Neomutt]] || [[Irssi]] || fff || [[Newsboat]]
|-
! [https://github.com/vodik/dotfiles vodik]
| [[Zsh]] || xmonad || [[Vim]] || termite-git || [[tmux]] || ncmpcpp || custom || mutt || weechat || ||
|-
! [https://github.com/w0ng/dotfiles w0ng]
| [[Zsh]] || dwm || [[Vim]] || rxvt-unicode || [[tmux]] || ncmpcpp || custom || mutt || irssi || ||
|-
! [https://github.com/whitelynx/dotfiles whitelynx]
| [[fish]] || [[i3]] || neovim || kitty || || || i3pystatus || || || ||
|-
! [https://git.sr.ht/~whynothugo/dotfiles whynothugo]
| [[Zsh]] || sway || neovim || alacritty || || mpv || waybar, top || neomutt || || nemo ||
|-
! [https://github.com/wryonik/dotfiles wryonik]
| [[Zsh]] || i3-gaps-rounded || [[Vim]] || terminator || || cmus || htop, i3blocks, gotop || || || ranger, nautilus ||
|}

== 参照 ==

* [http://mywiki.wooledge.org/DotFiles gregswiki:DotFiles]
* [http://wiki.haskell.org/Xmonad/Config_archive XMonad Config Archive]
* [http://dotshare.it dotshare.it]
* [https://dotfiles.github.io/ dotfiles.github.io]
* [https://terminal.sexy/ terminal.sexy] - ターミナルのカラースキームデザイナー

ドットファイル

2025-05-15T02:15:29Z

Kgx: /* Git を使ってドットファイルを直接管理する */ 同期

[[Category:設定ファイル]]
[[Category:設定管理]]
[[en:Dotfiles]]
[[es:Dotfiles]]
[[pt:Dotfiles]]
[[zh-hans:Dotfiles]]
{{Related articles start}}
{{Related|XDG Base Directory サポート}}
{{Related|X resources}}
{{Related articles end}}

ユーザー固有のアプリケーション設定は、伝統的に [[Wikipedia:dotfile|ドットファイル]](ファイル名がドットで始まるファイル) に保存されています。変更を追跡し、さまざまなホスト間でドットファイルを同期するために、[[Git]] などの [[バージョン管理システム]] でドットファイルを管理することは一般的な方法です。ドットファイルを管理するには、さまざまな方法があります(例えば、ホームディレクトリでドットファイルを直接追跡する、サブディレクトリに保存する、[[シェル]]スクリプトや[[#他のツール|専用ツール]] でファイルをシンボリックリンク/コピー/生成するなど)。ドットファイルの管理方法とは別に、この記事には、[[#リポジトリ|ドットファイルのリボジトリのリスト]] も含まれています。

== Git を使ってドットファイルを直接管理する ==

ドットファイルを直接 Git で追跡することの利点は、[[Git]] だけで済み、シンボリックリンクを必要としないことです。デメリットは、[[#ホスト固有の設定|ホスト固有の設定]] では一般的に複数の [[Git#Branching|branches]] に変更をマージする必要があるということです。

このアプローチを実現する最も簡単な方法は、[[Git]] リポジトリをホームディレクトリで直接初期化し、デフォルトで {{man|5|gitignore}} パターンの {{ic|*}} を使用してすべてのファイルを無視することです。ただし、この方法には 2 つの欠点があります。ホームディレクトリに他の Git リポジトリがある場合は混乱する可能性があります (たとえば、リポジトリの初期化を忘れた場合、突然 dotfile リポジトリを操作することになります) また、ディレクトリ内のどのファイルが簡単に確認できなくなります。現在のディレクトリは追跡されません (無視されるため)

これらの欠点を避けるための代替方法として、"bare repository and alias method" があります。この方法は、[https://news.ycombinator.com/item?id=11071754 Ask Hacker News: What do you use to manage your dotfiles?] で広く知られるようになったもので、たった3つのコマンドでセットアップが可能です:

$ git init --bare ~/.dotfiles
$ alias config='/usr/bin/git --git-dir=$HOME/.dotfiles/ --work-tree=$HOME'
$ config config status.showUntrackedFiles no

{{note|通常、ドットファイルのパーミッションはすべてデフォルトの設定のままで問題ありませんが、特定のファイルに特定のパーミッションが必要な場合は、別の方法を検討する必要があります。Git はファイルのパーミッションを保存しないためです。}}

このドットファイルを使って新しいシステムに複製できます:

$ git clone --bare <git-repo-url> $HOME/.dotfiles
$ alias config='/usr/bin/git --git-dir="$HOME/.dotfiles/" --work-tree="$HOME"'
$ config checkout
$ config config --local status.showUntrackedFiles no

リモートリポジトリを使わずにこれを行うには、[[git#バンドル|git bundles]] を使用できます。ソースコンピュータで {{ic|dotfiles.bundle}} という名前の git バンドルを作成するには、次のコマンドを実行します:
:{{bc|<nowiki>
$ dotfiles bundle create --progress dotfiles.bundle --all
</nowiki>}}

:バンドルは {{ic|<git-repo-url>}} と同様に使用できます:
:{{bc|<nowiki>
$ git clone --bare dotfiles.bundle $HOME/.dotfiles
</nowiki>}}

* 上書きされる可能性のあるいくつかのストック設定がすでにある場合は、次のようなエラーが発生します:
:{{bc|<nowiki>
$ config checkout
error: The following untracked working tree files would be overwritten by checkout:
.bashrc
.gitignore
Please move or remove them before you can switch branches.
Aborting
</nowiki>}}

:既存のファイルを書き換える {{ic|$ config checkout -f}} を使用することもできます。または、より安全な方法として、次のスクリプトを使用してすべてのファイルのバックアップを取得し、{{ic|checkout}} を使用することもできます:
:{{bc|<nowiki>
mkdir -p .config-backup && \
config checkout 2>&1 | egrep "\s+\." | awk {'print $1'} | \
xargs -I{} mv {} .config-backup/{}
</nowiki>}}

その後、作成した [[エイリアス]] でドットファイルを管理することができます。もし [[Bash]] を使っていてこのエイリアスを bash 補完したい場合は、{{AUR|bash-complete-alias}} をインストールして、エイリアスと次の行を {{ic|~/.bashrc}} に追加してください。

$ complete -F _complete_alias config

bash で補完させるもう一つの方法は、{{ic|~/.bashrc}} に以下を追加することです。([https://askubuntu.com/a/642778] から引用):

source /usr/share/bash-completion/completions/git
__git_complete config __git_main

{{Tip|機密情報を誤ってコミットしないようにするには、[https://wiki.archlinux.org/title/Git#Filtering_confidential_information Git#Filtering confidential information] を参照してください。}}

== ホスト固有の設定 ==

様々なマシンで dotfiles を同期させる際によくある問題が、ホスト固有の設定です。

[[Git]] では、すべての共有設定を master ブランチで管理し、個々のマシンにはマシン固有のブランチをチェックアウトすることでこれを解決できます。ホスト固有の設定はマシン固有のブランチにコミットすることができます。共有設定が master ブランチで変更された場合、マシンごとのブランチは更新された master の上にリベースされる必要があります。

[[コマンドラインシェル#設定ファイル|シェル設定ファイル]] のような設定スクリプトでは、条件付きロジックを使用することができます。例えば、[[Bash]] スクリプト (すなわち {{ic|.bashrc}}) は、マシン名 (またはタイプ、カスタム変数など) に応じて異なる設定を適用することができます。

if <nowiki>[[ "$(hostname)" == "archlaptop" ]];</nowiki> then
# laptop specific commands here
else
# desktop or server machine commands
fi

同様のことは、[[.Xresources]] でも実現できます。[https://jnrowe.github.io/articles/tips/Sharing_Xresources_between_systems.html]

Git ブランチのリベースが面倒だと感じる場合は、''ファイルのグループ化'' をサポートする [[#Tools|ツール]] や、さらに柔軟性を求めるなら ''加工処理'' を行うツールを使用するとよいでしょう。

== ツール ==

;ファイルのグループ化
:設定ファイルを設定グループ (プロファイルまたはパッケージとも呼ばれる) にグループ化する方法です。
処理
:ホストによってカスタマイズできるように、設定ファイルを処理するツールもあります。

{| class="wikitable sortable" style="text-align: center;"
! 名前 !! パッケージ !! 言語 !! ファイルのグループ化 !! 処理
|-
! [https://github.com/anishathalye/dotbot dotbot]
| {{Pkg|chezmoi}} || Python || 設定ファイル || {{Grey|No}}
|-
! [https://github.com/twpayne/chezmoi chezmoi]
| {{AUR|dotbot}} || Go || ディレクトリベース || Go テンプレート
|-
! [https://github.com/kesslern/dot-templater dot-templater]
| {{AUR|dot-templater-git}} || Rust || ディレクトリベース || カスタムシンタックス
|-
! [https://github.com/oknozor/toml-bombadil toml-bombadil]
| {{Pkg|toml-bombadil}} || Rust || 設定ファイル || tera
|-
! [https://deadc0de.re/dotdrop/ dotdrop]
| {{AUR|dotdrop}} || Python || 設定ファイル || Jinja2
|-
! [https://github.com/jbernard/dotfiles dotfiles]
| {{AUR|dotfiles}} || Python || {{Grey|[https://github.com/jbernard/dotfiles/pull/24 No]}} || {{Grey|No}}
|-
! [https://github.com/EvanPurkhiser/dots Dots]
| {{AUR|dots-manager}} || Python || ディレクトリベース || カスタム追加ポイント
|-
! [https://github.com/SuperCuber/dotter dotter]
| {{AUR|dotter-rs}} || Rust || 設定ファイル || Handlebars
|-
! [https://dt.cli.rs dt-cli]
| {{AUR|dt-cli}} || Rust || 設定ファイル || Handlebars
|-
! [https://www.gnu.org/software/stow/ GNU Stow]
| {{Pkg|stow}} || Perl || ディレクトリベース [http://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html] || {{Grey|No}}
|-
! [https://github.com/lra/mackup Mackup]
| {{AUR|mackup}} || Python || アプリケーションごとに自動 || {{Grey|No}}
|-
! [https://github.com/darkfeline/mir.qualia mir.qualia]
| {{AUR|mir.qualia}} || Python || {{Grey|No}} || カスタムブロック
|-
! [https://github.com/thoughtbot/rcm rcm]
| {{AUR|rcm}} || Perl || ディレクトリベース (ホストまたはタグによる) || {{Grey|No}}
|-
! [https://github.com/sebastiancarlos/yas-bdsm yas-bdsm]
| {{-}} || Shell || ディレクトリベース || {{Grey|No}}
|}

=== Git を wrapping するツール ===

[[Git]] に不安がある場合は、バージョン管理システムを (多かれ少なかれ) 抽象化するこれらのツールのいずれかを使用することをお勧めします。

{| class="wikitable sortable" style="text-align:center;"
! 名前 !! パッケージ !! 言語 !! ファイルのグループ化 !! 処理
|-
! [https://github.com/kazhala/dotbare dotbare]
| {{AUR|dotbare}} || Shell ({{Pkg|fzf}}) || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/kobus-v-schoor/dotgit dotgit]
| {{AUR|dotgit}} || Python || ファイル名ベース || {{Grey|No}}
|-
! [https://github.com/andsens/homeshick homeshick]
| {{AUR|homeshick-git}} || Bash || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/technicalpickles/homesick homesick]
| {{-}} || Ruby || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/pearl-core/pearl Pearl]
| {{AUR|pearl-git}} || Python || リポジトリ的 || {{Grey|No}}
|-
! [https://github.com/RichiH/vcsh vcsh]
| {{Pkg|vcsh}} || Shell || リポジトリ的 || {{Grey|No}}
|-
! [https://yadm.io yadm](1)
| {{Pkg|yadm}} || Bash || ファイル名ベース (by class/OS/distro/hostname/user)[https://yadm.io/docs/alternates] ||組み込みのテンプレート /Jinja2/ESH [https://yadm.io/docs/templates] (オプション)
|-
! [https://github.com/justone/dotfiles dfm]
| {{AUR|dfm}} || Perl || リポジトリ的 || {{Grey|No}}
|}

# [[GPG]] または OpenSS による機密ファイルの暗号化をサポートします。 [https://yadm.io/docs/encryption]

== ユーザーリポジトリ ==

{{Note|このテーブルは、ドットファイルの参照/例として使用して下さい。ドットファイルをテーブルに追加する場合は、それらがクリーンでコメントされていて、最新の状態に保たれているかを確認してください。}}
{{Warning|これらのドットファイルは Arch Linux スタッフによって検証されていないため、自己責任で使用してください。}}

{| class="wikitable sortable" style="text-align:center"
! 作者 || シェル || WM / DE || エディタ || ターミナル || マルチプレクサ || オーディオ || モニター || メール || IRC || ファイルマネージャ || RSS リーダー
|-
! [https://github.com/adamperkowski/dwm adamperkowski]
| [[Zsh]] || [[dwm]] || [[Neovim]] || [[Kitty]] || [[tmux]] || [[Mpv]] || custom || || [[WeeChat]] || ||
|-
! [https://github.com/alfunx/.dotfiles alfunx]
| [[Zsh]] || [[Awesome]] || [[Vim]] || [[Kitty]] || [[tmux]] || [[Ncmpcpp]]/[[Mpd]] || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]]/lain || [[Thunderbird]] || || ||
|-
! [https://gitlab.com/Ambrevar/dotfiles Ambrevar]
| Eshell || [[EXWM]] || [[Emacs]] || Emacs (Eshell) || Emacs TRAMP + dtach || EMMS || [[Conky]]/[[Dzen]] || mu4e || Circe || ||
|-
! [https://github.com/ask1234560/dotfiles_bspwm ananthu]
| [[Zsh]] || [[Bspwm]] || [[Neovim]] || [[Alacritty]] || || [[Mpv]] || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]], [[Polybar]] || [[Neomutt]] || [[WeeChat]] || [[Ranger]] ||
|-
! [https://github.com/awalGarg/dotfiles awal]
| [[Fish]] || [[i3]] || [[Vim]] || [[St]] || [[tmux]] || || i3status || || The Lounge || ||
|-
! [https://github.com/ayekat/localdir ayekat]
| [[Zsh]] || karuiwm || [[Vim]] || [[Rxvt-unicode]] || [[tmux]] || [[Ncmpcpp]]/[[Mpd]] || karuibar || [[Mutt]] || [[Irssi]] || ||
|-
! [https://github.com/BachoSeven/dotfiles bachoseven]
| [[Zsh]] || [[Dwm]] [https://github.com/BachoSeven/dwm source] || [[Neovim]] || [[St]] [https://github.com/BachoSeven/st source] || [[tmux]] || [[Ncmpcpp]] || bottom || [[Neomutt]] || [[WeeChat]] || [[Lf]] || [[newsboat]]
|-
! [https://github.com/bamos/dotfiles bamos]
| [[Zsh]] || [[i3]]/[[xmonad]] || vim/emacs || rxvt-unicode || [[tmux]] || mpv/cmus || conky/xmobar || mutt || ERC || ||
|-
! [https://github.com/benmezger/dotfiles benmezger]
| [https://github.com/benmezger/dotfiles zsh/bash] || [https://github.com/benmezger/dotfiles/tree/main/dot_config/i3 i3-gaps] || [https://github.com/benmezger/dotfiles/tree/main/dot_doom.d emacs] || [https://github.com/benmezger/dotfiles/blob/main/dot_Xresources rxvt-unicode]/[https://github.com/benmezger/dotfiles/blob/main/dot_config/alacritty/ alacritty] || [https://github.com/benmezger/dotfiles/blob/main/dot_tmux.conf tmux] || mopidy/ncmpcpp || [https://github.com/benmezger/dotfiles/blob/main/dot_config/i3/status.toml.tmpl i3status-rs] || [https://github.com/benmezger/dotfiles/blob/main/dot_doom.d/ mu4e]/[https://github.com/benmezger/dotfiles/blob/main/dot_config/neomutt neomutt]/[https://github.com/benmezger/dotfiles/blob/main/dot_mbsyncrc.tmpl mbsync] || [https://github.com/benmezger/dotfiles/blob/main/dot_weechat/ weechat] || ||
|-
! [https://github.com/pbrisbin/dotfiles brisbin33]
| [https://github.com/pbrisbin/oh-my-zsh zsh] || [https://github.com/pbrisbin/xmonad-config xmonad] || [https://github.com/pbrisbin/vim-config vim] || rxvt-unicode || [[GNU Screen]] || || dzen || [https://github.com/pbrisbin/mutt-config mutt] || [https://github.com/pbrisbin/irssi-config irssi] || ||
|-
! [https://gitlab.com/BVollmerhaus/dotfiles BVollmerhaus]
| [https://gitlab.com/BVollmerhaus/dotfiles/-/tree/master/config/fish fish] || [https://gitlab.com/BVollmerhaus/dotfiles/blob/master/config/i3/config i3-gaps] || [https://gitlab.com/BVollmerhaus/dotfiles/blob/master/config/kak/kakrc kakoune] || [https://gitlab.com/BVollmerhaus/dotfiles/-/blob/master/config/kitty/kitty.conf kitty] || || || [https://gitlab.com/BVollmerhaus/dotfiles/blob/master/config/polybar/config polybar] || || || [https://gitlab.com/BVollmerhaus/dotfiles/-/tree/master/config/ranger ranger] ||
|-
! [https://github.com/christian-heusel/dotfiles christian-heusel]
| [[Zsh]] || [[i3]] || [[Neovim]] || [[st]] / [[terminator]] || byobu / [[tmux]] || || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]] || [[neomutt]]/[[thunderbird]] || [[WeeChat]] || [[nemo]] / [[ranger]] ||
|-
! [https://github.com/CuterThanYou/dotfiles CuterThanYou]
| [[Zsh]] || [[i3]] / [[Hyprland]] || [[Neovim]] || [[Alacritty]] / [[Foot]] || || [[Mpv]] || [[Polybar]] / Yambar || || || [[Lf]] / [[Thunar]] ||[[Newsboat]]
|-
! [https://github.com/cinelli/dotfiles cinelli]
| [[Zsh]] || dwm || [[Vim]] || termite-git || || pianobar || htop || mutt-kz || weechat || ||
|-
! [https://github.com/dikiaap/dotfiles dikiaap]
| [[Zsh]] || [[i3]]-gaps || neovim || alacritty || [[tmux]] || || i3blocks || || || nnn ||
|-
! [https://github.com/Earnestly/dotfiles Earnestly]
| [[Zsh]] || [[i3]]/orbment || vim/emacs || termite || [[tmux]] || mpd || conky || mutt || weechat || ||
|-
! [https://github.com/ErikBjare/dotfiles ErikBjare]
| [[Zsh]] || [[xmonad]]/[[Xfce|Xfce4]] || [[Vim]] || terminator || [[tmux]] || || xfce4-panel || || weechat || ||
|-
! [https://github.com/erikw/dotfiles erikw]
| [[Zsh]]/[[Bash]] || DWM/macOS || NeoVim || urxvtc || [[tmux]] || mpd || || mutt || irssi || ||
|-
! [https://github.com/falconindy/dotfiles falconindy]
| [[Bash]] || [[i3]] || [[Vim]] || rxvt-unicode || || ncmpcpp || conky || mutt || || ||
|-
! [https://github.com/filiparag/dotfiles filiparag]
| [[fish]] || bspwm || [[Vim]] || alacritty || [[tmux]] || mpv, [https://github.com/altdesktop/playerctl playerctl] || htop, polybar || [https://www.nongnu.org/mailnotify/ mail-notification] || || [[PCManFM]] ||
|-
! [https://github.com/Freed-Wu/Freed-Wu Freed-Wu]
| [[zsh]] || [[openbox]] || [[neovim]] || [[wezterm]] || [[tmux]] || [[cmus]] || bottom || [[neomutt]] || [[WeeChat]] || [[neovim]] || [[newsboat]]
|-
! [https://git.sr.ht/~gardenapple/dotfiles gardenapple]
| [[Zsh]] ([https://git.sr.ht/~gardenapple/dotfiles/tree/main/item/stow/zsh/.zshrc fish-like]) || [[Hyprland]] || [[neovim]] || [[kitty]] || || || [[アプリケーション一覧/ユーティリティ#タスクマネージャ|Htop]] || [[aerc]] || || [[vifm]] || [[Newsboat]]
|-
! [https://github.com/graysky2/configs/tree/master/dotfiles graysky]
| [[Zsh]] || Xfce|xfce4 || [[Vim]] || terminal || || ncmpcpp || custom || thunderbird || || ||
|-
! [https://github.com/hugdru/dotfiles hugdru]
| [[Zsh]] || awesome || neovim || rxvt-unicode || [[tmux]] || || || thunderbird || weechat || ||
|-
! [https://github.com/insanum/dotfiles insanum]
| [[Bash]] || herbstluftwm || [[Vim]] || evilvte || [[tmux]] || || dzen || mutt-kz || || ||
|-
! [https://github.com/isti115/dotfiles isti115]
| [https://github.com/Isti115/dotfiles/blob/master/.config/powershell/Microsoft.PowerShell_profile.ps1 pwsh]
|| [https://github.com/Isti115/dotfiles/blob/master/.config/sway/config sway]
|| [https://github.com/Isti115/dotfiles/tree/master/.config/nvim neovim]
|| [https://github.com/Isti115/dotfiles/blob/master/.config/alacritty/alacritty.yml alacritty]
|| [[tmux]]
|| [https://github.com/Isti115/dotfiles/tree/master/.config/mpv mpv] / playerctl
|| [https://github.com/Isti115/dotfiles/tree/master/.config/waybar waybar] / htop / ytop
||
||
|| [https://github.com/Isti115/dotfiles/tree/master/.config/ranger ranger]
||
|-
! [https://hg.sr.ht/~jasonwryan/shiv jasonwryan]
| bash/zsh || dwm || [[Vim]] || rxvt-unicode || [[tmux]] || ncmpcpp || custom || mutt || irssi || ||
|-
! [https://github.com/JDevlieghere/dotfiles/ jdevlieghere]
| [[Zsh]] || xmonad || [[Vim]] || terminal || [[tmux]] || || htop || mutt || weechat || ||
|-
! [https://github.com/jelly/Dotfiles jelly]
| [[Zsh]] || [[i3]] || [[Vim]] || termite || [[tmux]] || ncmpcpp || || mutt-kz-git || weechat || ||
|-
! [https://gitlab.com/jlo62/dotties jl2]
| [[Zsh]] || swayfx || geany || [[foot]] || || || missioncenter, eww (bar) || || srain || [[thunar]] ||
|-
! [https://github.com/markuszoppelt/dotfiles MarkusZoppelt]
| [[Zsh]] || gnome || [[Neovim]] || [[Alacritty]] || [[tmux]] || || || || || ||
|-
! [https://github.com/maximbaz/dotfiles maximbaz]
| [[Zsh]] || sway || kakoune || kitty || || || waybar || neomutt || || nnn ||
|-
! [https://code.mehalter.com/dotfiles mehalter]
| [[Zsh]] || [[i3]]-gaps || neovim || termite || [[tmux]] || cmus || gotop || neomutt || weechat || ranger ||
|-
! [https://github.com/meskarune/.dotfiles meskarune]
| [[Bash]] || herbstluftwm || [[Vim]] || rxvt-unicode || [[GNU Screen]] || || conky || || weechat || ||
|-
! [https://github.com/neersighted/dotfiles neersighted]
| [[fish]] || [[i3]] || neovim || alacritty || [[tmux]] || ncmpcpp || || || || ||
|-
! [https://github.com/nimaipatel/dotfiles nimaipatel]
| [[fish]] || awesome|| neovim || alacritty || || ncmpcpp || || || || ||
|-
! [https://github.com/oibind/dotfiles oibind]
| [[fish]] || awesome || neovim || st || [[tmux]] || || htop-vim || || weechat || lf ||
|-
! [https://github.com/ok100/configs OK100]
| [[Bash]] || dwm || [[Vim]] || rxvt-unicode || || cmus || conky, dzen || mutt || weechat || ||
|-
! [https://github.com/orhun/dotfiles orhun]
| [[Bash]] || [[i3]]-gaps || neovim || alacritty || || || i3status || || weechat || tere ||
|-
! [https://github.com/pablox-cl/dotfiles pablox-cl]
| zsh (zplug) || [[GNOME]] || neovim || kitty || || || || || || ||
|-
! [https://github.com/patri9ck/dotfiles patri9ck]
| [[Zsh]] || [[bspwm]] || [[Vim]] || [[kitty]] || || || || || || [[Thunar]] ||
|-
! [https://gitlab.com/peterzuger/dotfiles peterzuger]
| [[Zsh]] || [[i3]]-gaps || emacs || rxvt-unicode || [[GNU Screen]] || moc || htop || || || ||
|-
! [https://gitlab.com/polyzen/dotfiles polyzen]
| [[Zsh]] || [[i3]] || Neovim || Alacritty || [[tmux]] || mpv || i3status,htop || himalaya || || ranger || Newsboat
|-
! [https://github.com/potamides/dotfiles potamides]
| [[Bash]] || awesome || neovim || termite || [[tmux]] || ncmpcpp || conky,htop || mutt || weechat || ranger ||
|-
! [https://github.com/reisub0/dot reisub0]
| [[fish]] || qtile || neovim || kitty || || mpd || conky || || || ||
|-
! [https://github.com/sistematico/majestic sistematico]
| zsh/fish/bash || [https://github.com/Airblader/i3 i3-gaps] || vim/nano || termite || [[tmux]] || ncmpcpp || polybar || mutt || weechat || ||
|-
! [https://git.sr.ht/~thecashewtrader/dotfiles thecashewtrader]
| Eshell || EXWM || Emacs || Emacs (VTerm) || Emacs || Bongo || htop || mu4e || ERC || Dired || Elfeed
|-
! [https://github.com/thiagowfx/.dotfiles thiagowfx]
| bash/zsh || [[i3]] || [[Vim]] || alacritty || [[tmux]] || playerctl || i3status || || || ranger ||
|-
! [https://codeberg.org/tplasdio/dotfiles tplasdio]
| [https://codeberg.org/tplasdio/bash-config bash (ble.sh)] || [https://codeberg.org/tplasdio/awesomewm-config awesome] || [https://codeberg.org/tplasdio/neovim-config neovim] || [https://codeberg.org/tplasdio/dotfiles/src/branch/main/.config/alacritty/alacritty.yml alacritty] || [https://codeberg.org/tplasdio/dotfiles/src/branch/main/.config/byobu/.tmux.conf tmux] || [https://codeberg.org/tplasdio/mpv-config mpv], mpvs || htop || neomutt || weechat || [https://codeberg.org/tplasdio/lf-config lf] ||
|-
! [https://github.com/tuurep/dotfiles tuurep]
| [[Bash]] || openbox || neovim || alacritty || [[tmux]] || || polybar || || || ||
|-
! [https://git.sr.ht/~unrealapex/dotfiles unrealapex]
| [[Zsh]] || [[Dwm]] || [[Neovim]] || [[St]] || || [[Ncmpcpp]] || htop || [[Neomutt]] || [[Irssi]] || fff || [[Newsboat]]
|-
! [https://github.com/vodik/dotfiles vodik]
| [[Zsh]] || xmonad || [[Vim]] || termite-git || [[tmux]] || ncmpcpp || custom || mutt || weechat || ||
|-
! [https://github.com/w0ng/dotfiles w0ng]
| [[Zsh]] || dwm || [[Vim]] || rxvt-unicode || [[tmux]] || ncmpcpp || custom || mutt || irssi || ||
|-
! [https://github.com/whitelynx/dotfiles whitelynx]
| [[fish]] || [[i3]] || neovim || kitty || || || i3pystatus || || || ||
|-
! [https://git.sr.ht/~whynothugo/dotfiles whynothugo]
| [[Zsh]] || sway || neovim || alacritty || || mpv || waybar, top || neomutt || || nemo ||
|-
! [https://github.com/wryonik/dotfiles wryonik]
| [[Zsh]] || i3-gaps-rounded || [[Vim]] || terminator || || cmus || htop, i3blocks, gotop || || || ranger, nautilus ||
|}

== 参照 ==

* [http://mywiki.wooledge.org/DotFiles gregswiki:DotFiles]
* [http://wiki.haskell.org/Xmonad/Config_archive XMonad Config Archive]
* [http://dotshare.it dotshare.it]
* [https://dotfiles.github.io/ dotfiles.github.io]
* [https://terminal.sexy/ terminal.sexy] - ターミナルのカラースキームデザイナー

Fortune

2025-05-08T09:12:48Z

Kgx: /* 使用方法 */ 同期

[[Category:視覚効果]]
[[Category:コマンドシェル]]
[[en:Fortune]]
[[pt:Fortune]]
{{Related articles start}}
{{Related|アスキーアート}}
{{Related articles end}}
[[Wikipedia:ja:Fortune (UNIX)|Fortune]] は引用句データベースからランダムに痛烈・示唆的・頓馬・皮肉なメッセージを表示するシンプルなプログラムです。''fortune'' コマンドラインユーティリティは、{{Pkg|fortune-mod}} パッケージの一部です。

== インストール ==

{{Pkg|fortune-mod}} または {{AUR|fortune-mod-git}} パッケージを[[インストール]]してください。

{{Tip|特定のソースからの引用を提供するメタパッケージは、[[AUR]] で "fortune-mod-" というプレフィックスで利用できます。例えば、{{AUR|fortune-mod-archlinux}} は Arch 関係の発言集を含んでいます。}}

== 使用方法 ==

ターミナルで以下のコマンドを実行:
{{hc|$ fortune|
It is Texas law that when two trains meet each other at a railroad crossing,
each shall come to a full stop, and neither shall proceed until the other has gone.}}

インタラクティブシェルを起動したときにランダムな引用句を表示するには、シェルの rc 設定ファイルに ''fortune'' コマンドを追加してください:
#!/bin/bash
# ~/.bashrc
fortune

{{Note|デフォルトでは、{{ic|fortune}} はあまり害のない引用句を表示します [https://github.com/shlomif/fortune-mod/blob/master/fortune-mod/Offensive] しかしながら、過激と思えるような引用句もパッケージには含まれており、{{ic|/usr/share/fortune/off/}} に入ります。使用したい場合は {{man|6|fortune}} を参照してください。}}

=== カスタムファイルの作成 ===

カスタムファイルを作成するには、最初に引用句を含むファイルを作成する必要があります。各引用句の間に、{{ic|%}} 文字のみを含む行を追加する必要があります。myquotes など、任意の名前を使用してこのファイルを保存します。次に引用句のランダムアクセスを有効にするために、{{ic|strfile ''myquotes''}} をターミナルで実行します。ターミナルで {{ic|fortune ''myquotes''}} を実行すると、引用句にアクセスできるようになります。このコマンドを実行するには、{{ic|''myquotes''}} と {{ic|''myquotes''.dat}} が同じディレクトリにいる必要があります。コマンドを実行するだけで引用句にアクセスできるようにしたい場合は、両方のファイルを {{ic|/usr/share/fortune/}} ディレクトリに移動する必要があります。ファイルに変更を加える場合は、最初から繰り返します。

=== Cowsay ===

[[アスキーアート#Cowsay]] を参照。

===Ponysay===

[[アスキーアート#Ponysay]] を参照。

== 参照 ==
* [https://github.com/shlomif/fortune-mod fortune-mod GitHub プロジェクトページ]

Fortune

2025-05-08T09:11:03Z

Kgx: /* インストール */ 同期

[[Category:視覚効果]]
[[Category:コマンドシェル]]
[[en:Fortune]]
[[pt:Fortune]]
{{Related articles start}}
{{Related|アスキーアート}}
{{Related articles end}}
[[Wikipedia:ja:Fortune (UNIX)|Fortune]] は引用句データベースからランダムに痛烈・示唆的・頓馬・皮肉なメッセージを表示するシンプルなプログラムです。''fortune'' コマンドラインユーティリティは、{{Pkg|fortune-mod}} パッケージの一部です。

== インストール ==

{{Pkg|fortune-mod}} または {{AUR|fortune-mod-git}} パッケージを[[インストール]]してください。

{{Tip|特定のソースからの引用を提供するメタパッケージは、[[AUR]] で "fortune-mod-" というプレフィックスで利用できます。例えば、{{AUR|fortune-mod-archlinux}} は Arch 関係の発言集を含んでいます。}}

== 使用方法 ==

ターミナルで以下のコマンドを実行:
{{hc|$ fortune|
It is Texas law that when two trains meet each other at a railroad crossing,
each shall come to a full stop, and neither shall proceed until the other has gone.}}

インタラクティブシェルを起動したときにランダムな引用句を表示するには、シェルの rc 設定ファイルに ''fortune'' コマンドを追加してください:
#!/bin/bash
# ~/.bashrc
fortune

[[Dash]] を使用する場合:

#!/bin/dash
# ~/.dashrc
fortune

ターミナルにログインしたときにランダムな引用句を表示するには、シェルのプロファイル設定ファイルに ''fortune'' コマンドを追加してください:
#!/bin/mksh
# ~/.profile
fortune

{{Note|デフォルトでは、{{ic|fortune}} はあまり害のない引用句を表示します [https://github.com/shlomif/fortune-mod/blob/master/fortune-mod/Offensive]。しかしながら、過激と思えるような引用句もパッケージには含まれており、{{ic|/usr/share/fortune/off/}} に入ります。使用したい場合は {{man|6|fortune}} を参照してください。}}

=== カスタムファイルの作成 ===

カスタムファイルを作成するには、最初に引用句を含むファイルを作成する必要があります。各引用句の間に、{{ic|%}} 文字のみを含む行を追加する必要があります。myquotes など、任意の名前を使用してこのファイルを保存します。次に引用句のランダムアクセスを有効にするために、{{ic|strfile ''myquotes''}} をターミナルで実行します。ターミナルで {{ic|fortune ''myquotes''}} を実行すると、引用句にアクセスできるようになります。このコマンドを実行するには、{{ic|''myquotes''}} と {{ic|''myquotes''.dat}} が同じディレクトリにいる必要があります。コマンドを実行するだけで引用句にアクセスできるようにしたい場合は、両方のファイルを {{ic|/usr/share/fortune/}} ディレクトリに移動する必要があります。ファイルに変更を加える場合は、最初から繰り返します。

=== Cowsay ===

[[アスキーアート#Cowsay]] を参照。

===Ponysay===

[[アスキーアート#Ponysay]] を参照。

== 参照 ==
* [https://github.com/shlomif/fortune-mod fortune-mod GitHub プロジェクトページ]

Sudo

2025-05-07T08:53:48Z

Kgx: /* ヒントとテクニック */ 同期

[[Category:セキュリティ]]
[[Category:コマンド]]
[[de:sudo]]
[[en:Sudo]]
[[es:Sudo]]
[[fr:Sudo]]
[[pt:Sudo]]
[[ru:Sudo]]
[[uk:Sudo]]
[[zh-hans:Sudo]]
{{Related articles start}}
{{Related|ユーザーとグループ}}
{{Related|su}}
{{Related|doas}}
{{Related articles end}}

[https://www.sudo.ws/sudo/ sudo] を使うことでシステム管理者は権限を委託できるようになり、root や他のユーザーとして複数の(もしくは全ての)コマンドを実行する能力を特定のユーザー(もしくはユーザーのグループ)に与えることができます。

Sudo は root でコマンドを実行するためのものとして [[su]] に代わるものです。[[su]] が root シェルを起動してそれから全てのコマンドを root として実行できるようにするのに対し、sudo は一つのコマンドだけに特権を与えます。必要な時だけに root 特権を有効にするので、sudo を使うことにより打ち間違いや呼び出されたコマンドのバグによってシステムを破壊してしまう可能性を減らすことができます。

Sudo は他のユーザーとしてコマンドを実行するために使うこともできます; さらに、sudo は全てのコマンドとセキュリティ検査のアクセス失敗を記録します。

== インストール ==

{{Pkg|sudo}} パッケージをインストールしてください。あるいは、{{Pkg|sudo-rs}}にsudo-rsというメモリ安全なsudoの実装があります。

== 使用方法 ==

ユーザーはコマンドの前に {{ic|sudo}} を付けることで、スーパーユーザー(もしくはその他の)特権がある状態でコマンドを実行できます。

''sudo'' を使うときはコマンドの前に {{ic|sudo}} と空白を付けてください:

$ sudo ''cmd''

例えば、pacman を root で使いたいなら:

$ sudo pacman -Syu

詳しくは {{man|8|sudo}} を見てください。

=== ログインシェル ===

すべてのコマンドを他のユーザーとして実行するために単に ''sudo'' を前置するだけでは不十分です。特に、[[Wikipedia:Redirection_(computing)|リダイレクション]]や[[Wikipedia:Command substitution|コマンド置換]]を使用する場合、ログインシェルを使用する必要があります。これは {{ic|sudo -iu ''user''}} で簡単にアクセスできます（目的のユーザーが root である場合は {{ic|-u ''user''}} を省略できます）。

次の例では、コマンド置換はフルシェルで動作しますが、''sudo'' を前置すると失敗します：

{{hc|$ sudo wpa_supplicant -B -i ''interface'' -c '''<('''wpa_passphrase ''MYSSID passphrase''''')'''|
Successfully initialized wpa_supplicant
Failed to open config file '/dev/fd/63', error: No such file or directory
Failed to read or parse configuration '/dev/fd/63'
}}

== 設定 ==

=== デフォルトのスケルトンファイル ===

{{man|5|sudoers|SUDOERS OPTIONS}} は {{ic|/etc/sudoers}} ファイル内の {{ic|Defaults}} コマンドで使用できる全てのオプションをリストアップします。

オプションのリスト (バージョン 1.8.7 のソースコードから解析されたもの) を {{ic|sudoers}} 用に最適化した形式で表示するには [https://gist.github.com/AladW/7eca9799b9ea624eca31] を参照してください。

パスワードのタイムアウトの設定など、より詳しい情報は {{man|5|sudoers}} を見て下さい。

=== 現在の設定を表示 ===

{{ic|sudo -ll}} を実行して現在の sudo 設定を表示してください。{{ic|sudo -lU ''user''}} で指定したユーザーの sudo 設定も確認できます。

=== visudo を使う ===

sudo の設定ファイルは {{ic|/etc/sudoers}} です。このファイルは'''どんなときでも''' {{ic|visudo}} コマンドを使って編集するべきです。{{ic|visudo}} は {{ic|sudoers}} ファイルをロックし、一時ファイルに編集内容を保存して、それを {{ic|/etc/sudoers}} にコピーする前にファイルの構文をチェックします。

{{Warning|
* {{ic|sudoers}} に構文エラーの危険性があるということは絶対避けなくてはいけません!どんなエラーでも sudo を使用不可能にしてしまいます。エラーを防ぐためにどんなときでも {{ic|visudo}} を使って編集するようにしてください。
* {{man|8|visudo}} は、ユーザーが選択したエディターのユーザー環境変数を尊重するように visudo を設定すると、その変数を別の値に設定するだけで、visudo 権限を持つユーザーがログを記録せずに root として任意のコマンドを実行できるようになるため、セキュリティホールになる可能性があると警告しています。}}

visudo のデフォルトエディタは {{ic|vi}} です。core リポジトリの sudo はデフォルトで {{Ic|--with-env-editor}} を有効にしてコンパイルされており、{{Ic|VISUAL}} や {{Ic|EDITOR}} 変数を使用することができます。{{ic|VISUAL}} が設定されている場合 {{ic|EDITOR}} は使われません。

現在のシェルセッションの間だけ '''visudo''' のエディタとして nano を使いたい場合、'''visudo''' を実行する前に {{Ic|EDITOR}} 変数を設定してください:

# EDITOR=nano visudo

もしくは {{ic|/etc/sudoers}} ファイルのコピーを編集して {{ic|visudo -c -f ''/copy/of/sudoers''}} でチェックすることもできます。visudo でファイルをロックしたくない場合に有用です。

エディタを永久に変更するには、[[環境変数#ユーザーごと]]を参照してください。システム全体で ''visudo'' のみのエディタを永久に変更するには、以下を {{ic|/etc/sudoers}} に追加します（[[nano]] が好みのエディタであると仮定します）：

# デフォルトのエディタを nano の制限付きバージョンに設定し、visudo が EDITOR/VISUAL を使用しないようにする。
Defaults editor=/usr/bin/rnano, !env_editor

=== エントリの例 ===

ユーザー USER_NAME が {{ic|sudo}} を使った時に、完全な root 権限を与えたい場合は、次の行を加えて下さい:

USER_NAME ALL=(ALL) ALL

マシンのホストネームが HOST_NAME のときだけ、ユーザー USER_NAME に他のユーザーとしてコマンドを実行する権限を与えるには:

USER_NAME HOST_NAME=(ALL) ALL

{{ic|wheel}} グループに追加されている全てのユーザーが sudo を使えるようにするには:

%wheel ALL=(ALL) ALL

{{Tip|新しい管理者を作成する際、{{ic|wheel}} グループに sudo アクセスを有効にし、[[ユーザーとグループ#グループ管理|ユーザーを追加する]]ことが望ましいです。デフォルトでは、[[Polkit#Administrator identities|Polkit]] は {{ic|wheel}} グループのメンバーを管理者として扱うためです。ユーザーが {{ic|wheel}} のメンバーでない場合、Polkit を使用するソフトウェアはユーザーのパスワードではなく root のパスワードを使用して認証を求めることがあります。}}

ユーザー {{ic|USER_NAME}} にパスワードを尋ねるのを無効化するには:

{{Warning|これにより、ユーザー名で実行されている任意のプロセスが、許可を求めずに sudo を使用できるようになります。}}

Defaults:USER_NAME !authenticate

ホスト {{ic|HOST_NAME}} 上のユーザー {{ic|USER_NAME}} のみに対して明示的に定義されたコマンドを有効にするには：

USER_NAME HOST_NAME=/usr/bin/halt,/usr/bin/poweroff,/usr/bin/reboot,/usr/bin/pacman -Syu

{{note|後ろの行の設定が前の設定よりも優先されるので、細かくカスタマイズしたオプションはファイルの最後に置くべきです。特にユーザーがグループに含まれているときは上のような行は {{ic|%wheel}} 行の後にすべきです。}}
ユーザー USER_NAME がホスト HOST_NAME を使っているときだけ特定のコマンドに sudo をパスワードなしで使えるようにするには:

USER_NAME HOST_NAME= NOPASSWD: /usr/bin/halt,/usr/bin/poweroff,/usr/bin/reboot,/usr/bin/pacman -Syu

説明のついた sudoers のサンプルは {{ic|/usr/share/doc/sudo/examples/sudoers}} にあります。詳しくは {{man|5|sudoers}} を見て下さい。

=== Sudoers デフォルトファイルパーミッション ===

sudoers ファイルの所有者とグループはゼロにしてください、つまり所有者が居てはいけません。ファイルパーミッションは 0440 に設定する必要があります。このパーミッションはデフォルトでセットされますが、パーミッションを変える事故を起こしてしまった場合、すぐにパーミッションを元に戻すか sudo を消して下さい。

# chown -c root:root /etc/sudoers
# chmod -c 0440 /etc/sudoers

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

=== パスワードプロンプトのタイムアウトを無効にする ===

よくある悩みは、通常のパーミッションで実行され、必要な時にのみ上昇するバックグラウンドターミナルで実行される長時間実行プロセスです。これにより sudo のパスワード入力が促され、気づかれずにタイムアウトし、その時点でプロセスが終了し、完了した作業は失われるか、せいぜいキャッシュされます。一般的なアドバイスは、パスワードなしの sudo を有効にするか、パスワードを記憶する sudo のタイムアウトを延長することです。これらはいずれもセキュリティに悪影響を及ぼします。 '''プロンプト''' タイムアウトを無効にすることもできますが、これは適切なセキュリティ上の目的を果たすものではありません、そこを理解して設定する必要があります。

Defaults passwd_timeout=0

=== Bash 補完 ===

sudo コマンドで完全な Bash 補完機能を利用できるようにするには、{{Pkg|bash-completion}} パッケージをインストールしてください。
何らかの理由でこのパッケージをインストールできない場合、sudo コマンドの補完機能は限定的になりますが、代替手段として以下の内容を [[.bashrc]] に追加することで利用可能です:

complete -cf sudo

=== エイリアスを渡す ===

[[Zsh]] と [[Bash]] では、エイリアスは通常、コマンドの最初の単語に対してのみ展開されます。これは、{{ic|sudo}} コマンドを実行するときにエイリアスが通常展開されないことを意味します。次の単語を展開する方法の一つは、スペースで終わる sudo のエイリアスを作成することです。以下を[[コマンドラインシェル#設定ファイル|シェルの設定ファイル]]に追加します:

alias sudo='sudo '

{{man|1|zshmisc|ALIASING}} はこれがどのように機能するかを説明しています:
: 置換テキストがスペースで終わる場合、シェル入力の次の単語は常にエイリアス展開の対象になります。

{{man|1|bash|ALIASES}} も同様に説明しています:
: エイリアス値の最後の文字が空白の場合、エイリアスの次のコマンド単語もエイリアス展開の対象としてチェックされます。

=== パスワードプロンプトに端末ベルを鳴らす ===

バックグラウンドの端末で sudo プロンプトに注意を引く為に、[[Wikipedia:Bell character|bell character]] を鳴らす方法もあります。

Defaults passprompt="^G[sudo] password for %p: "

{{ic|^G}} は文字通りベル文字です。例えば。 [[vim]] で、シーケンスを使用して挿入 {{ic|Ctrl+v}} {{ic|Ctrl+g}} または [[Nano]] {{ic|alt+v}} {{ic|Ctrl+g}}

もう一つのオプションとして、{{ic|SUDO_PROMPT}} [[環境変数]] を設定する方法があります。例えば、シェルの設定ファイルに以下を追加します:

export SUDO_PROMPT=$'\a[sudo] please enter a password: '

=== ターミナルごとの sudo を無効化 ===

{{Warning|以下を行うとすべてのプロセスがあなたの sudo セッションを使うようになります。}}

新しいターミナルを開くたびにパスワードを入力するよう求められる sudo のデフォルト設定が煩わしい場合は、{{ic|timestamp_type}} を {{ic|global}} に設定します:

Defaults timestamp_type=global

=== パスワードの入力回数を減らす ===

5分ごとにパスワードを再入力するのが面倒な場合 (デフォルト)、 {{ic|timestamp_timeout}} に長い値を設定することで変更することができます。(単位:分)。

Defaults timestamp_timeout=10

多くの sudo コマンドを連続して使用する場合、{{ic|timestamp_timeout}} を増やすよりも、sudo を使用するたびにタイムアウトを更新する方が論理的です。タイムアウトを更新するには、{{ic|sudo -v}} を使用します({{ic|sudo -K}} は即座に取り消します)。

次の内容を[[環境変数#シェルの初期化ファイルを使う|シェル初期化ファイル]]に追加することで、自動化することができます:

alias sudo='sudo -v; sudo '

また、bash 関数を使用することも可能です。詳細は [https://unix.stackexchange.com/questions/584725/expand-certain-aliases-from-within-sudo-bash-function stackexchange] を参照してください。

=== 環境変数 ===

環境変数をたくさん使っている場合や、{{ic|1=export http_proxy="..."}} でプロクシー設定を export している場合、sudo を使うときに、sudo に {{ic|-E}} オプションを付けない限りこれらの環境変数が root アカウントに渡されません。

$ sudo -E pacman -Syu

環境変数を維持するために {{ic|env_keep}} にそれら環境変数を追加するのを推奨します:
{{hc|/etc/sudoers|<nowiki>
Defaults env_keep += "ftp_proxy http_proxy https_proxy no_proxy"
</nowiki>}}

=== Root パスワード ===

ユーザーは、{{ic|/etc/sudoers}} の Defaults 行に {{ic|targetpw}}(ターゲットユーザー、デフォルトは root)または {{ic|rootpw}} を追加することで、ユーザーパスワードの代わりに root パスワードを尋ねるように sudo を設定できます:

Defaults targetpw

root パスワードをユーザーに公開しないようにするためには、これを特定のグループに制限できます:

Defaults:%wheel targetpw
%wheel ALL=(ALL) ALL

=== root ログインを無効化 ===

sudo をインストール・設定したら、root ログインを無効化できます。root を無効化すれば、攻撃者はユーザーのパスワードだけでなく sudoer として設定されたユーザー名もまず考えなくてはならなくなります。[[Secure Shell#root ログインを制限する]]も参照。

{{Warning|
* ルートログインを無効にすることで、自分自身をロックアウトしてしまう可能性がありますのでご注意ください。Sudo は自動的にインストールされませんし、そのデフォルトの設定では、パスワードなしの root アクセスも、自分のパスワードによる root アクセスもできません。root アカウントを無効にする前に、ユーザが sudoer として適切に設定されていることを確認してください!
* sudoers ファイルをデフォルトで rootpw を使用するように変更した場合、以下のコマンドで root ログインを無効化しないでください!
* すでにロックアウトされている場合は、[[パスワードリカバリ]] を参照してください。
}}

アカウントをロックするには {{ic|passwd}} を使います:

# passwd -l root

同じようなコマンドで root をアンロックできます。

$ sudo passwd -u root

もしくは、{{ic|/etc/shadow}} を編集して root の暗号化されたパスワードを "!" で置き換えてください:

root:!:12345::::::

もう一度 root ログインを有効にするには:

$ sudo passwd root

システム緊急時には、リカバリプロンプトが root パスワードを要求するため、リカバリシェルにログインすることができません。緊急時に自動的に root アカウントをアンロックするには、{{ic|rescue.service}} に [[ドロップインファイル]] を使用して {{ic|1=SYSTEMD_SULOGIN_FORCE=1}} 環境変数を追加します:

{{hc|/etc/systemd/system/rescue.service.d/SYSTEMD_SULOGIN_FORCE.conf|2=
[Service]
Environment=SYSTEMD_SULOGIN_FORCE=1
}}

{{Tip|''root'' アカウントを無効化した後もインタラクティブな root プロンプトを表示するには、{{ic|sudo -i}} を使ってください。}}

==== kdesu ====

KDE では root 権限で GUI アプリケーションを起動するのに kdesu が使われることがあります。root アカウントが無効になっているときでもデフォルトで kdesu は su を使おうとします。幸いに、kdesu では su の代わりに sudo を使うようにすることができます。{{ic|~/.config/kdesurc}} (kde4 の場合は {{ic|~/.kde4/share/config/kdesurc}}) ファイルを作成・編集してください:

[super-user-command]
super-user-command=sudo

もしくは以下のコマンドを使用 (kde4 の場合は ''kwriteconfig'' を使用):

$ kwriteconfig5 --file kdesurc --group super-user-command --key super-user-command sudo

=== sudoでハード化する例 ===

例えば、admin, devel, joe の3人のユーザーを作ったとします。''admin'' は journalctl, systemctl, mount, kill, iptables に、''devel'' はパッケージのインストールや設定ファイルの編集に、そして ''joe'' はログインするユーザにそれぞれ使用します。''joe" にリブート、シャットダウン、netctl を使わせるためには、以下のようにします。

{{ic|/etc/pam.d/su}} と {{ic|/etc/pam.d/su-l}} を編集してください。
ユーザが wheel グループに属していることを要求するが、誰もその中に入れないようにする。
#%PAM-1.0
auth sufficient pam_rootok.so
# Uncomment the following line to implicitly trust users in the "wheel" group.
#auth sufficient pam_wheel.so trust use_uid
# Uncomment the following line to require a user to be in the "wheel" group.
auth required pam_wheel.so use_uid
auth required pam_unix.so
account required pam_unix.so
session required pam_unix.so

SSH ログインを 'ssh' グループに制限します。''joe'' だけがこのグループの一員になります。
groupadd -r ssh
gpasswd -a joe ssh
echo 'AllowGroups ssh' >> /etc/ssh/sshd_config

[[リスタート]] {{ic|sshd.service}}.

ユーザーを他のグループに追加する。
for g in power network ;do ;gpasswd -a joe $g ;done
for g in network power storage ;do ;gpasswd -a admin $g ;done

デベロッパーが編集できるように、コンフィグにパーミッションを設定します。
chown -R devel:root /etc/{http,openvpn,cups,zsh,vim,screenrc}

Cmnd_Alias POWER = /usr/bin/shutdown -h now, /usr/bin/halt, /usr/bin/poweroff, /usr/bin/reboot
Cmnd_Alias STORAGE = /usr/bin/mount -o nosuid\,nodev\,noexec, /usr/bin/umount
Cmnd_Alias SYSTEMD = /usr/bin/journalctl, /usr/bin/systemctl
Cmnd_Alias KILL = /usr/bin/kill, /usr/bin/killall
Cmnd_Alias PKGMAN = /usr/bin/pacman
Cmnd_Alias NETWORK = /usr/bin/netctl
Cmnd_Alias FIREWALL = /usr/bin/iptables, /usr/bin/ip6tables
Cmnd_Alias SHELL = /usr/bin/zsh, /usr/bin/bash
%power ALL = (root) NOPASSWD: POWER
%network ALL = (root) NETWORK
%storage ALL = (root) STORAGE
root ALL = (ALL) ALL
admin ALL = (root) SYSTEMD, KILL, FIREWALL
devel ALL = (root) PKGMAN
joe ALL = (devel) SHELL, (admin) SHELL

この設定により、root ユーザーでのログインはほとんど必要なくなります。

''joe'' は自宅の WiFi に接続できます。
sudo netctl start home
sudo poweroff

''joe'' は、他のユーザーとして netctl を使用できません。
sudo -u admin -- netctl start home

''joe'' が journalctl を使ったり、逃亡したプロセスを kill したりする必要があるとき、そのユーザーに切り替えることができます。
sudo -i -u devel
sudo -i -u admin

しかし、''joe'' は root ユーザーに切り替えることはできません。
sudo -i -u root

''joe'' が管理者として gnu-screen のセッションを開始したい場合は、次のようにします。
sudo -i -u admin
admin% chown admin:tty `echo $TTY`
admin% screen

=== /etc/sudoers.d のドロップインファイルを使って sudo を設定 ===

''sudo'' は {{ic|/etc/sudoers.d/}} ディレクトリ内のファイルを読み込みます。{{ic|/etc/sudoers}} を編集するかわりに、{{ic|/etc/sudoers.d/}} ディレクトリのファイルで設定を変更することができます。これには2つのメリットがあります:
* {{ic|sudoers.pacnew}} ファイルを編集する必要がありません。
* 新しいエントリに問題があった場合、{{ic|/etc/sudoers}} を編集するのではなく問題のあるファイルを削除するだけですみます。

ドロップインファイルのエントリの形式は {{ic|/etc/sudoers}} 自体と同じです。直接編集するときは、{{ic|visudo -f /etc/sudoers.d/''somefile''}} を使ってください。詳しくは {{man|5|sudoers}} の "Including other files from within sudoers" セクションを参照。

{{ic|/etc/sudoers.d/}} ディレクトリのファイルは辞書順に読み込まれます。ファイル名に {{ic|.}} または {{ic|~}} が含まれているとスキップされます。ソート順で問題が起こらないように、ファイル名には2桁の数字を付けてください。例: {{ic|01_foo}}。

{{Note|ドロップインファイルのエントリの順番は重要です: 間違って上書きしてしまわないように注意してください。}}

{{Warning|{{ic|/etc/sudoers.d/}} のファイルは {{ic|/etc/sudoers}} と同じように注意して扱う必要があります: フォーマットを間違えてしまうと {{ic|sudo}} が機能不全に陥ります。{{ic|visudo}} を使うことを強く推奨します。}}

=== ファイルの編集 ===

{{ic|sudo -e}} または {{ic|sudoedit}} を使うことで、ファイルを他のユーザーとして編集することができます。テキストエディタを動かすユーザーは変わりません。

テキストエディタの権限を昇格させることなく root でファイルを編集することが可能です。詳しくは {{man|8|sudo|e}} を読んでください。

エディタは他のプログラムに設定できます。例えば {{Pkg|meld}} を使って [[Pacnew と Pacsave ファイル|pacnew]] ファイルを管理する場合:

$ SUDO_EDITOR=meld sudo -e /etc/''file''{,.pacnew''}

=== 侮辱を有効にする ===

visudo を使用して sudoers ファイルに次の行を追加することにより、sudo でイースターエッグ (侮辱) することができます。

不正なパスワードを入力すると、{{ic|Sorry, try again.}} のメッセージがユーモラスな侮辱に置き換えられます。

{{hc|1=/etc/sudoers|2=
Defaults insults
}}

=== パスワード入力のフィードバックを有効にする ===

デフォルトでは、パスワードを入力する際に視覚的なフィードバックはありません。これは、セキュリティを高めるために意図的に行われています。しかし、視覚的な入力が必要な場合は、この行を追加することで有効にすることができます:

{{hc|/etc/sudoers|2=
Defaults pwfeedback
}}

=== カラーパスワードプロンプト ===

パスワードプロンプトをカラーや太字フォントでカスタマイズするには、シェル初期化ファイルに {{ic|SUDO_PROMPT}} [[環境変数]] を設定し、{{man|1|tput}} を使用します。

例えば、パスワードプロンプトを太字の赤で表示するには、以下のように設定します:

export SUDO_PROMPT="$(tput setaf 1 bold)Password:$(tput sgr0) "

また、デフォルトメッセージに異なる色を使用するには、以下のようにします:

export SUDO_PROMPT="$(tput setab 1 setaf 7 bold)[sudo]$(tput sgr0) $(tput setaf 6)password for$(tput sgr0) $(tput setaf 5)%p$(tput sgr0): "

{|
|-
|

{| class="wikitable"
|+ tput コマンドラインオプションチートシート
|-
! tput コマンド !! 説明
|-
| {{ic|tput bold}} || 太字テキスト
|-
| {{ic|tput setaf [CODE]}} || 前景色を設定
|-
| {{ic|tput setab [CODE]}} || 背景色を設定
|-
| {{ic|tput rev}} || 色を反転
|-
| {{ic|tput sgr0}} || すべてをリセット
|}
 
 
 

||    ||

{| class="wikitable sortable"
|+ tput カラーコード
|-
! tput カラー [CODE] !! 色
|-
| 0 || 黒
|-
| 1 || 赤
|-
| 2 || 緑
|-
| 3 || 黄
|-
| 4 || 青
|-
| 5 || マゼンタ
|-
| 6 || シアン
|-
| 7 || 白
|}

|}

=== U2F の使用 ===

U2F は sudo と一緒に使用するのに最適です。これは、公共の場所での[[Wikipedia:Shoulder surfing (computer security)|ショルダーハック]]のリスクを効果的に排除しながら、シンプルな物理的なタッチでプロンプトを承認する意識的なコントロールを与えてくれます。

[[Universal 2nd Factor#パスワードなしの sudo]] を参照してください。

=== 保護されたファイルへの書き込み ===

sudo を使用する際、保護されたファイルに書き込みたい場合、[[tee]] を使うことで、このような分離が可能になります:

$ ''input stream'' | sudo tee ''--option'' ''protected_file_1 protected_file_2...''

これは、単純な {{ic|>}}/{{ic|>>}} が機能しない場合に有効です。

==== Vim の場合 ====

他のユーザーが所有するファイルを編集している際、sudo 付きで [[Vim]] を起動するのを忘れた場合にも、同様の方法が役立ちます。
そのようなときには、[[Vim]] 内部で以下を実行することでファイルを保存できます:

:w !sudo tee %

この操作を簡単に使えるように、以下を {{ic|~/.vimrc}} に追加すると、コマンドモードで {{ic|:w!!}} によるマッピングが使えるようになります:

{{hc|~/.vimrc|2=
" Allow saving of files as sudo when I forgot to start vim using sudo
cmap w!! w !sudo tee > /dev/null %
}}

{{ic|> /dev/null}} の部分は、標準出力を明示的に破棄するためのもので、他のパイプコマンドに何も渡す必要がないためです。

この仕組みがどのように動作し、なぜ機能するのかについての詳細な説明は、StackOverflow の記事
[https://stackoverflow.com/questions/2600783/how-does-the-vim-write-with-sudo-trick-work How does the vim “write with sudo” trick work?] を参照してください。

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

=== SSH TTY 問題 ===

リモートコマンドを実行するとき SSH はデフォルトでは tty を割り当てません。tty がないと、パスワードを要求するときに sudo は echo を無効化することができません。ssh の {{ic|-tt}} オプションを使うことで強制的に tty を割り当てることができます ({{ic|-tt}} を2回使ってください)。

{{ic|Defaults}} オプションの {{ic|requiretty}} は tty が存在するときだけ sudo を実行することを許可します。

# Disable "ssh hostname sudo <cmd>", because it will show the password in clear text. You have to run "ssh -t hostname sudo <cmd>".
#
#Defaults requiretty

=== Permissive Umask ===

Sudo はユーザーの [[umask]] の値を sudo の umask (デフォルトは 0022) と結合します。これによってユーザーの umask が許可している以上のパーミッションでファイルを作成できないようにしています。umask をカスタマイズしていない場合はデフォルトで問題ありませんが、sudo によって実行されたユーティリティが作成したファイルのパーミッションが root で直接実行した場合と異なってしまう可能性があります。エラーが発生する場合、たとえユーザーが指定した umask よりもパーミッションを甘くしたいときでも、sudo には umask を修正する手段があります。以下を追加 ({{ic|visudo}} を使用) することで sudo のデフォルトの挙動が上書きされます:

Defaults umask = 0022
Defaults umask_override

sudo の umask が root のデフォルト umask (0022) に設定されデフォルトの挙動が上書きされます。ユーザーによって設定された umask を無視して指定された umask を常時使うようになります。

{{TranslationStatus|Sudo|2024-07-31|811791}}

Doas

2025-05-06T18:09:52Z

Kgx: /* 使用方法 */ 同期

{{Lowercase title}}
[[Category:セキュリティ]]
[[Category:コマンド]]
[[en:doas]]
[[ru:doas]]
[[zh-hans:Doas]]
{{Related articles start}}
{{Related|ユーザーとグループ}}
{{Related|sudo}}
{{Related|アプリケーション一覧/セキュリティ#管理者権限}}
{{Related articles end}}
OpenDoas は OpenBSD の [[Wikipedia:doas|doas]] コマンドの移植版です。[[sudo]] と比べてサイズがかなり小さいことで知られています。''sudo'' と同じように、''doas'' はシステム上の他のユーザーとして実行したいときに使います。

== インストール ==

{{Pkg|opendoas}} パッケージをインストールしてください。

== 使用方法 ==

非特権ユーザーで ''doas'' を使い始めるには、設定が必要です。[[#設定]]を見てください。

''doas'' を使う時はコマンドとその引数の前に {{ic|doas}} とスペースを追加します:

$ doas ''cmd''

例えば [[pacman]] を使う場合:

$ doas pacman -Syu

別のユーザーとして対話型シェルに入るには({{ic|-u ''user''}} を省略すると、デフォルトで root になります):

$ doas -su ''user''

一部のコマンドを実行するには、別のユーザーとしてログインする必要があります。詳しくは [[Sudo#ログインシェル]] を参照してください。

詳細については、 {{man|1|doas}} を参照してください。

== 設定 ==

[[PAM]] モジュールはインストールされますが、デフォルトの設定やサンプルは含まれていません。

[[ユーザーとグループ#ユーザーグループ|wheel]] グループのメンバーに他のユーザーとしてコマンドの実行を許可するには、以下の内容の設定ファイルを作成します:

{{hc|/etc/doas.conf|
permit setenv {{{{ic|PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin}}}} :wheel

}}

{{Note|
* 設定ファイルは改行で終わる必要があります。
* {{ic|setenv}} オプションは、OpenDoas の BSD 由来の [https://github.com/Duncaen/OpenDoas/issues/117 問題] を回避します。Linux では、{{ic|/usr/local/bin}} は一般的に実行可能ファイルを上書きするために使われるので、パッケージの実行可能ファイルを含む {{ic|/usr/bin}} の前に置かれます
}}

{{ic|/etc/doas.conf}} の所有者および所有グループは {{ic|0}} に、ファイルのパーミッションは {{ic|0400}} に設定してください:

# chown -c root:root /etc/doas.conf
# chmod -c 0400 /etc/doas.conf

{{ic|/etc/doas.conf}} の構文エラーをチェックするには、以下のコマンドを実行:

# doas -C /etc/doas.conf && echo "config ok" || echo "config error"

{{Warning|{{ic|/etc/doas.conf}} に構文エラーが含まれないように必ずチェックしてください。}}

{{ic|plugdev}} グループのメンバーが root ユーザーとして [[S.M.A.R.T.#smartctl|smartctl]] をパスワードなしで実行できるようにするには:

{{hc|/etc/doas.conf|
permit nopass :plugdev as root cmd /usr/bin/smartctl
}}

{{ic|/etc/doas.conf}} の基本構文は以下のとおりです:

permit|deny [options] identity [as target] [cmd command [args ...]]

詳しくは {{man|5|doas.conf}} を読んでください。

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

=== doas の persist 機能 ===

''doas'' には永続機能があります: ユーザーが認証成功した後、しばらくはパスワードを要求しなくなります。デフォルトでは無効になっているので、{{ic|persist}} オプションで有効にしてください:

{{hc|/etc/doas.conf|2=
permit '''persist''' setenv {PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin} :wheel
}}

{{ic|doas -L}} を実行すると、自動的なタイムアウト前に保存されていた認証情報がクリアされます。

{{Note|永続的機能はデフォルトで無効になっています。これは潜在的に危険であるためです。元の ''doas'' では、カーネル API を使ってタイムアウトの設定と解除を行っています。この API は OpenBSD 特有のもので、他のオペレーティングシステムには同様の API が存在しません。そのため、代替手段として、''sudo'' と同様にタイムスタンプファイルを使って永続機能が実装されています。}}

=== sudo から doas への移行 ===

後方互換を保ちつつ ''sudo'' から ''doas'' にスムーズに移行するために、以下の設定を追加すると良いかもしれません:

alias sudo='doas'
alias sudoedit='doas rnano'

または、代わりに、''sudo'' を ''doas'' へのシンボリックリンクにします。(ただし {{ic|sudoedit}} コマンドは提供されません):

# ln -s $(which doas) /usr/bin/sudo

もう1つの方法は、いくつかの sudo オプションをエミュレートする {{AUR|doas-sudo-shim}} をインストールすることです。

{{Note|デフォルトでは、''sudo'' はいくつかの環境変数を保持しますが、''doas'' は保持しません。特に XAUTHORITY、LANG、LC_ALL は保持しません。これは、X でグラフィカルなアプリケーションを起動したり、ユーザーのロケールにアクセスしたりすることが、さらなる設定なしではできないことを意味します。例えば、''wheel'' グループのメンバーがグラフィカルなアプリケーションを実行したり、setenv オプションを使用してユーザーのロケールにアクセスできるようにするには、次のようにします。
{{hc|/etc/doas.conf|
permit setenv { XAUTHORITY LANG LC_ALL } :wheel
}}
}}

=== Bash タブ補完 ===

デフォルトでは、bash はカレントまたは参照ディレクトリ内のファイルとディレクトリのみをタブで補完します。引数を別のコマンドのように補完するようにするには(他のコマンドのタブ補完の設定も利用する)、次のようにユーザの {{ic|.bashrc}} またはグローバルの {{ic|/etc/bash.bashrc}} に追加します。

{{hc|~/.bashrc|
complete -cf doas
}}

{{Pkg|bash-completion}} がインストールされている場合は、以下を使用して、ターゲットコマンドの追加補完を可能にすることもできます。
{{hc|~/.bashrc|
complete -F _command doas
}}

{{TranslationStatus|doas|2025-05-07|736536}}

Doas

2025-05-06T18:05:41Z

Kgx: /* ヒントとテクニック */ 同期

{{Lowercase title}}
[[Category:セキュリティ]]
[[Category:コマンド]]
[[en:doas]]
[[ru:doas]]
[[zh-hans:Doas]]
{{Related articles start}}
{{Related|ユーザーとグループ}}
{{Related|sudo}}
{{Related|アプリケーション一覧/セキュリティ#管理者権限}}
{{Related articles end}}
OpenDoas は OpenBSD の [[Wikipedia:doas|doas]] コマンドの移植版です。[[sudo]] と比べてサイズがかなり小さいことで知られています。''sudo'' と同じように、''doas'' はシステム上の他のユーザーとして実行したいときに使います。

== インストール ==

{{Pkg|opendoas}} パッケージをインストールしてください。

== 使用方法 ==

非特権ユーザーで ''doas'' を使い始めるには、設定が必要です。[[#設定]]を見てください。

''doas'' を使う時はコマンドとその引数の前に {{ic|doas}} とスペースを追加します:

$ doas ''cmd''

例えば [[pacman]] を使う場合:

$ doas pacman -Syu

root のインタラクティブシェルを開くには:

$ doas -s

詳しくは {{man|1|doas}} を参照してください。

== 設定 ==

[[PAM]] モジュールはインストールされますが、デフォルトの設定やサンプルは含まれていません。

[[ユーザーとグループ#ユーザーグループ|wheel]] グループのメンバーに他のユーザーとしてコマンドの実行を許可するには、以下の内容の設定ファイルを作成します:

{{hc|/etc/doas.conf|
permit setenv {{{{ic|PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin}}}} :wheel

}}

{{Note|
* 設定ファイルは改行で終わる必要があります。
* {{ic|setenv}} オプションは、OpenDoas の BSD 由来の [https://github.com/Duncaen/OpenDoas/issues/117 問題] を回避します。Linux では、{{ic|/usr/local/bin}} は一般的に実行可能ファイルを上書きするために使われるので、パッケージの実行可能ファイルを含む {{ic|/usr/bin}} の前に置かれます
}}

{{ic|/etc/doas.conf}} の所有者および所有グループは {{ic|0}} に、ファイルのパーミッションは {{ic|0400}} に設定してください:

# chown -c root:root /etc/doas.conf
# chmod -c 0400 /etc/doas.conf

{{ic|/etc/doas.conf}} の構文エラーをチェックするには、以下のコマンドを実行:

# doas -C /etc/doas.conf && echo "config ok" || echo "config error"

{{Warning|{{ic|/etc/doas.conf}} に構文エラーが含まれないように必ずチェックしてください。}}

{{ic|plugdev}} グループのメンバーが root ユーザーとして [[S.M.A.R.T.#smartctl|smartctl]] をパスワードなしで実行できるようにするには:

{{hc|/etc/doas.conf|
permit nopass :plugdev as root cmd /usr/bin/smartctl
}}

{{ic|/etc/doas.conf}} の基本構文は以下のとおりです:

permit|deny [options] identity [as target] [cmd command [args ...]]

詳しくは {{man|5|doas.conf}} を読んでください。

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

=== doas の persist 機能 ===

''doas'' には永続機能があります: ユーザーが認証成功した後、しばらくはパスワードを要求しなくなります。デフォルトでは無効になっているので、{{ic|persist}} オプションで有効にしてください:

{{hc|/etc/doas.conf|2=
permit '''persist''' setenv {PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin} :wheel
}}

{{ic|doas -L}} を実行すると、自動的なタイムアウト前に保存されていた認証情報がクリアされます。

{{Note|永続的機能はデフォルトで無効になっています。これは潜在的に危険であるためです。元の ''doas'' では、カーネル API を使ってタイムアウトの設定と解除を行っています。この API は OpenBSD 特有のもので、他のオペレーティングシステムには同様の API が存在しません。そのため、代替手段として、''sudo'' と同様にタイムスタンプファイルを使って永続機能が実装されています。}}

=== sudo から doas への移行 ===

後方互換を保ちつつ ''sudo'' から ''doas'' にスムーズに移行するために、以下の設定を追加すると良いかもしれません:

alias sudo='doas'
alias sudoedit='doas rnano'

または、代わりに、''sudo'' を ''doas'' へのシンボリックリンクにします。(ただし {{ic|sudoedit}} コマンドは提供されません):

# ln -s $(which doas) /usr/bin/sudo

もう1つの方法は、いくつかの sudo オプションをエミュレートする {{AUR|doas-sudo-shim}} をインストールすることです。

{{Note|デフォルトでは、''sudo'' はいくつかの環境変数を保持しますが、''doas'' は保持しません。特に XAUTHORITY、LANG、LC_ALL は保持しません。これは、X でグラフィカルなアプリケーションを起動したり、ユーザーのロケールにアクセスしたりすることが、さらなる設定なしではできないことを意味します。例えば、''wheel'' グループのメンバーがグラフィカルなアプリケーションを実行したり、setenv オプションを使用してユーザーのロケールにアクセスできるようにするには、次のようにします。
{{hc|/etc/doas.conf|
permit setenv { XAUTHORITY LANG LC_ALL } :wheel
}}
}}

=== Bash タブ補完 ===

デフォルトでは、bash はカレントまたは参照ディレクトリ内のファイルとディレクトリのみをタブで補完します。引数を別のコマンドのように補完するようにするには(他のコマンドのタブ補完の設定も利用する)、次のようにユーザの {{ic|.bashrc}} またはグローバルの {{ic|/etc/bash.bashrc}} に追加します。

{{hc|~/.bashrc|
complete -cf doas
}}

{{Pkg|bash-completion}} がインストールされている場合は、以下を使用して、ターゲットコマンドの追加補完を可能にすることもできます。
{{hc|~/.bashrc|
complete -F _command doas
}}

{{TranslationStatus|doas|2025-05-07|736536}}

Tar によるフルシステムバックアップ

2025-05-03T08:52:28Z

Kgx: /* 並列圧縮でバックアップ */ 同期

[[Category:バックアップ]]
[[en:Full System Backup with tar]]
[[es:Full System Backup with tar]]
[[zh-hans:Full system backup with tar]]
{{Related articles start}}
{{Related|システムバックアップ}}
{{Related|SquashFS によるフルシステムバックアップ}}
{{Related articles end}}
この記事では [[tar]] を使ってフルシステムバックアップを行う方法を説明します。

tar を使ったバックアップには、ディスク領域の節約に役立つ圧縮機能があることや、簡単にできるという利点があります。基本的な手順は以下のようになります:

# LiveCD から起動
# Linux 環境に [[Change Root]]
# パーティションやドライブをマウント
# 除外リストを追加
# バックアップスクリプトを使ってバックアップ

全てのファイルシステムが LVM ボリューム上にある場合、[[LVM#スナップショット|LVM のスナップショット]]を使うことでバックアップによってシステムが使えなくなる時間を最小限に留めることができます。

== LiveCD を起動 ==

多くの Linux ブータブル CD、USB には、root をインストール先へ変更できる機能があります。バックアップを行うためにルートを変更する必要はありませんが、スクリプトを一時ドライブに転送したり、ファイルシステム上で見つけたりする必要がなく、スクリプトを実行するだけで済みます。Live メディアは、現在 Linux インストールされているものと同じアーキテクチャ (i686 または x86_64) である必要があります。

== Change Root ==

まずは現在の Linux 環境にスクリプト環境をセットアップしてください。通常のプログラムと同じようにスクリプトを実行できるようにします。詳しくは [http://linuxtidbits.wordpress.com/2009/12/03/setting-up-a-scripting-environment/ こちらの記事] を読んでください。次に Change Root を実行します。詳しくは [[Change Root]] の記事を読んでください。Change Root を行うときに一時的なファイルシステム ({{ic|/proc}}, {{ic|/sys}}, {{ic|/dev}}) をマウントする必要はありません。起動時に作成されているファイルシステムをバックアップしてしまうと通常の作成プロセスと干渉する可能性があります。Change Root を行うには Linux がインストールされているルートパーティションをマウントしてください。例:

# mkdir /mnt/arch
# mount /dev/<your-partition-or-drive>

{{Ic|fdisk -l}} でパーティションやドライブを確認できます。その後に [[chroot]] を実行してください:

# cd /mnt/arch
# chroot . /bin/bash

{{Warning|ターゲットシステムに chroot するために {{ic|arch-chroot}} を使用しないでください。一時ファイルシステム、すべてのシステムメモリ、その他の興味深いものをバックアップしようとするため、バックアッププロセスは失敗します。代わりにプレーンな {{ic|chroot}} を使用してください。}}

この例では bash を使用していますが、利用可能な場合は他のシェルを使用することもできます。これで、スクリプト環境に入ります (これは、入力時に {{ic|~/.bashrc}} をソースしていることが前提です。)

{{hc|~/.bash_profile|
# If using bash, source the local .bashrc
source ~/.bashrc
}}

== 他のパーティションのマウント ==

使用しているパーティション (例: {{ic|/home}} パーティション) は適切な場所にマウントする必要があります。

== 除外ファイルリスト ==

{{Ic|tar}} には指定されたファイルやディレクトリを無視する機能があります。1行ごとに指定してください。正規表現も使えます。例:

# Not old backups
/opt/backup/arch-full*

# Not temporary files
/tmp/*

# Not the cache for pacman
/var/cache/pacman/pkg/
...

== バックアップスクリプト ==

{{ic|bsdtar}} でバックアップを取るのは簡単なプロセスです。ここでは、それを行うことができる基本的なスクリプトを紹介し、いくつかのチェックを提供します。このスクリプトを修正して、バックアップの場所と除外ファイル (ある場合) を定義し、{{ic|chroot}} してすべてのパーティションをマウントした後にこのコマンドを実行する必要があります。[https://bbs.archlinux.org/viewtopic.php?id=146269 GNU tar を {{ic|--xattrs}} で実行しても拡張属性は保存されない] ことに注意してください。

{{bc|1=
#!/bin/bash
# full system backup

# Backup destination
backdest=/opt/backup

# Labels for backup name
#PC=${HOSTNAME}
pc=pavilion
distro=arch
type=full
date=$(date "+%F")
backupfile="$backdest/$distro-$type-$date.tar.gz"

# Exclude file location
prog=${0##*/} # Program name from filename
excdir="/home/<user>/.bin/root/backup"
exclude_file="$excdir/$prog-exc.txt"

# Check if chrooted prompt.
echo -n "First chroot from a LiveCD. Are you ready to backup? (y/n): "
read executeback

# Check if exclude file exists
if [ ! -f $exclude_file ]; then
echo -n "No exclude file exists, continue? (y/n): "
read continue
if [ $continue == "n" ]; then exit; fi
fi

if [ $executeback = "y" ]; then
# -p, --acls and --xattrs store all permissions, ACLs and extended attributes.
# Without both of these, many programs will stop working!
# It is safe to remove the verbose (-v) flag. If you are using a
# slow terminal, this can greatly speed up the backup process.
# Use bsdtar because GNU tar will not preserve extended attributes.
bsdtar --exclude-from=$exclude_file --acls --xattrs -cpvzf $backupfile /
fi
}}

== リストア ==

以前のバックアップから復元するには、関連するすべてのパーティションをマウントし、現在の作業ディレクトリをルートディレクトリに変更して、次のコマンドを実行します。

$ bsdtar --acls --xattrs -xpzf ''backupfile''

バックアップファイルをバックアップアーカイブに置き換えます。バックアップの作成後に追加されたすべてのファイルの削除は、手動で行う必要があります。ファイルシステムを再作成するのが簡単な方法です。

== 並列圧縮でバックアップ ==

並列圧縮 ([[Wikipedia:Symmetric multiprocessing|SMP]]) を使ってバックアップしたい場合 {{Pkg|pbzip2}} (Parallel bzip2) を使用してください:

# bsdtar -cvf /path/to/chosen/directory/etc-backup.tar.bz2 \
--use-compress-program pbzip2 /etc

{{ic|etc-backup.tar.bz2}} を1つ以上のオフラインメディア (USB スティック、外付けハードドライブ、CD-R など) に保存します。時々、元のファイルとディレクトリをバックアップと比較して、バックアッププロセスの整合性を検証します。比較を迅速に行うために、バックアップファイルのハッシュのリストを維持することもできます。

破損した {{ic|/etc}} ファイルを復元するには、一時作業ディレクトリに {{ic|etc-backup.tar.bz2}} ファイルを抽出し、必要に応じて個々のファイルとディレクトリをコピーします。{{ic|/etc}} ディレクトリ全体をそのすべての内容とともに復元するには、root として次のコマンドを実行します:

# bsdtar -xvf etc-backup.tar.bz2 -C /

Systemd/タイマー

2025-05-02T16:10:07Z

Kgx: /* cron を置き換える */ 同期

{{Lowercase title}}
[[Category:システム管理]]
[[de:Systemd/Timers]]
[[en:Systemd/Timers]]
[[es:Systemd/Timers]]
[[fr:Systemd/cron]]
[[pt:Systemd/Timers]]
[[ru:Systemd (Русский)/Timers]]
[[zh-hans:Systemd/Timers]]
{{Related articles start}}
{{Related|systemd}}
{{Related|systemd/ユーザー}}
{{Related|systemd FAQ}}
{{Related|cron}}
{{Related articles end}}
タイマーは名前が {{ic|.timer}} で終わる [[systemd]] のユニットファイルであり、{{ic|.service}} ファイルやイベントを制御します。[[cron]] の代わりとしてタイマーを使うことができます ([[#cron を置き換える]] を読んで下さい)。タイマーにはカレンダー時刻のイベントとモノトニック時刻のイベントのサポートが入っており、さらに非同期に実行することも可能です。

== タイマーユニット ==

タイマーは拡張子が {{ic|.timer}} の ''systemd'' のユニットファイルです。他の [[systemd#ユニットファイル|ユニット設定ファイル]] と似ていますが特別に {{ic|[Timer]}} セクションが存在します。{{ic|[Timer]}} セクションにはタイマーが作動する時間と処理を定義します。タイマーには2つのタイプがあり、どちらか一つを使って定義されます:

* '''モノトニックタイマー''' は刻々と変わる開始点と相応したタイムスパンの後に作動します。様々なモノトニックタイマーが存在しますがどれも次のような形式です: {{ic|1=On''Type''Sec=}} {{ic|OnBootSec}} と {{ic|OnActiveSec}} は全てのモノトニックタイマーで共通です。
* '''リアルタイムタイマー''' (別名ウォールクロックタイマー) は (cron のジョブと同じように) カレンダーイベントにあわせて作動します。{{ic|1=OnCalendar=}} オプションを使って定義を行います。

タイマーのオプションについては {{man|5|systemd.timer}} の [[man ページ]] で説明されています。カレンダーイベントやタイムスパンの引数構文については {{man|7|systemd.time}} の [[man ページ]] で説明されています。

{{Note|''systemd'' は、ブート後にアクティブにする必要があるすべてのタイマーを設定するターゲット {{ic|timers.target}} を提供します (詳細については、{{man|7|systemd.special}} を参照してください) これを使用するには、タイマーの {{ic|[Install]}} セクションに {{ic|1=WantedBy=timers.target}} を追加し、タイマーユニットを [[有効化]] します。}}

== サービスユニット ==

それぞれの {{ic|.timer}} ファイルには、対応する {{ic|.service}} ファイルが存在します (例: {{ic|foo.timer}} と {{ic|foo.service}})。{{ic|.timer}} ファイルは {{ic|.service}} ファイルを作動・制御します。{{ic|.service}} に {{ic|[Install]}} セクションは必要ありません。有効にするのは ''timer'' ユニットだからです。必要ならば、タイマーの {{ic|[Timer]}} セクションで {{ic|1=Unit=}} オプションを使うことで別の名前のユニットを制御することもできます。

== 管理 ==

''timer'' ユニットを使用するには、他のユニットと同じように[[systemd#ユニットを使う|有効化・起動]]します。起動しているタイマーを全て表示するには、次を実行:

{{hc|$ systemctl list-timers|
NEXT LEFT LAST PASSED UNIT ACTIVATES
Thu 2014-07-10 19:37:03 CEST 11h left Wed 2014-07-09 19:37:03 CEST 12h ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service
Fri 2014-07-11 00:00:00 CEST 15h left Thu 2014-07-10 00:00:13 CEST 8h ago logrotate.timer logrotate.service
}}

{{Note|
* (有効でないタイマーも含めて) 全てのタイマーを確認したい場合、{{ic|systemctl list-timers --all}} を使って下さい。
* タイマーによって実行するサービスの状態は、今現在作動しているのでない限り、inactive になります。
* タイマーがズレる場合は、{{ic|/var/lib/systemd/timers}} もしくは {{ic|~/.local/share/systemd/}} にある {{ic|stamp-*}} ファイルを削除してみてください。stamp ファイルはタイマーが実行された最後の時刻を記録しており、ファイルを削除することでタイマーの次の作動時に systemd が再構成を行います。
}}

== サンプル ==

タイマーを使用してサービスを実行するのにあたって、service ユニットファイルに変更を加える必要はありません。以下の例では {{ic|foo.timer}} という名前のタイマーを使って {{ic|foo.service}} を定期的に実行します。

=== モノトニックタイマー ===

起動15分後に実行され、システムが起動している間、一週間ごとに再度実行されるタイマー:

{{hc|/etc/systemd/system/foo.timer|<nowiki>
[Unit]
Description=Run foo weekly and on boot

[Timer]
OnBootSec=15min
OnUnitActiveSec=1w

[Install]
WantedBy=timers.target
</nowiki>}}

=== リアルタイムタイマー ===

一週間ごとに起動するタイマー (月曜日の午前12:00に実行)。システムの電源が切られていたなどの理由で、最後の起動時間を過ぎていた場合、すぐに実行されます ({{ic|1=Persistent=true}} オプション):

{{hc|/etc/systemd/system/foo.timer|<nowiki>
[Unit]
Description=Run foo weekly

[Timer]
OnCalendar=weekly
Persistent=true

[Install]
WantedBy=timers.target</nowiki>}}

もっと細かく日時を指定する必要がある場合、次の形式で {{ic|OnCalendar}} イベントを制御できます: {{ic|DayOfWeek Year-Month-Day Hour:Minute:Second}}。アスタリスクをワイルドカードとして使うことができ、カンマで複数の日時を指定することができます。値を {{ic|..}} で区切ることで連続的に日程を指定することも可能です。

例えば、以下の場合、毎月の1日から4日まで、月曜日か火曜日の場合にのみ、午後0時にサービスを実行します:

OnCalendar=Mon,Tue *-*-01..04 12:00:00

毎月第1土曜日にサービスを実行したい場合は以下のようになります:

OnCalendar=Sat *-*-1..7 18:00:00

毎朝4時に実行したい場合は以下のようになります:

OnCalendar=*-*-* 4:00:00

{{ic|OnCalendar}} は複数指定でき、複数の異なるタイミングでサービスを実行できます。次の例では、平日の22:30および土日の20:00に実行されます:

OnCalendar=Mon..Fri 22:30
OnCalendar=Sat,Sun 20:00

ディレクティブの最後にタイムゾーンを指定することもできます (受け入れられる値をリストするには、{{ic|timedatectl list-timezones}} を使用します。)

OnCalendar=*-*-* 02:00:00 Europe/Paris

詳しくは {{man|7|systemd.time}} を見てください。

{{Tip|
* {{ic|OnCalendar}} の日時の指定方法は ''systemd-analyze'' ユーティリティの {{ic|calendar}} オプションを使用することでテストすることができます。タイマーユニットで使用したときに次に実行される日時も確認できます。例えば、{{ic|systemd-analyze calendar weekly}} や {{ic|systemd-analyze calendar "Mon,Tue *-*-01..04 12:00:00"}} のようにコマンドを実行することでテストできます。
* {{Pkg|libfaketime}} でインストールできる {{ic|faketime}} コマンドを使うと、これらのコマンドを使ったいろいろなシナリオをテストするのに便利です。
* {{ic|daily}} や {{ic|weekly}} などの特殊なイベントの表現は''特定の起動時間''を示しているため、同じカレンダーイベントが設定されているタイマーがあった場合、同時に起動します。そのようなことが発生すると、タイマーのサービスがシステムリソースを取り合って、システムパフォーマンスが落ち込む可能性があります。このような問題は {{ic|RandomizedDelaySec}} オプションを使用してタイマーの起動時間を散らすことで解決できます。{{man|5|systemd.timer}} を参照してください。
* {{ic|AccuracySec}} のデフォルト値 ''1m'' の不正確さを避けるために、オプション {{ic|1=AccuracySec=1us}} を [Timer] セクションに追加します。{{man|5|systemd.timer}} も参照してください。
* 一部のオプション ({{ic|WakeSystem}}) は、特定のシステム機能を必要とし、タイマーの開始を妨げる場合があり、その結果、次のエラーメッセージが表示されます: "Failed to enter waiting state: Operation not supported" そして "Failed with result 'resources'."
}}

== 一時的な .timer ユニット ==

{{ic|systemd-run}} を使うことで一時的な {{ic|.timer}} ユニットを作ることができます。サービスファイルを作成しなくても、特定時刻にコマンドが実行されるように設定することが可能です。例えば、以下のコマンドは30秒後にファイルを作成します:

# systemd-run --on-active=30 /bin/touch /tmp/foo

タイマーファイルが存在しない既存のサービスファイルを指定することもできます。例えば、以下のコマンドは12.5時間後に {{ic|''someunit''.service}} という名前の systemd ユニットを起動します:

# systemd-run --on-active="12h 30m" --unit ''someunit''.service

詳しくは {{man|1|systemd-run}} を見てください。

== cron を置き換える ==

おそらく一番有名なジョブスケジューラは [[cron]] ですが、''systemd'' のタイマーはその代替手段になりえます。

=== メリット ===

タイマーを使う主要なメリットは、それぞれのジョブが固有の ''systemd'' サービスを使うというところに根ざします。そのメリットには以下のようなものがあります:

* タイマーとは別個にジョブを実行することが簡単にできます。これによってデバッグが楽になります。
* 特定の環境で動作するようにジョブを設定することができます ({{man|5|systemd.exec}} [[man ページ]]を参照)。
* ジョブを [[cgroups]] の支配下に置けます。
* 他の ''systemd'' ユニットに依存するようにジョブを設定できます。
* ''systemd'' の journal でジョブが記録されるのでデバッグが簡単です。

=== 注意事項 ===

cron では簡単にできることが、タイマーユニットを使用する場合、難しかったり不可能であったりすることがいくつか存在します。

* 冗長性: ''systemd'' を使って定期的なジョブを設定するには2つのファイルを作成して2回 {{ic|systemctl}} コマンドを実行します。それに対して crontab には一行を追加するだけです。
* メール: cron の {{ic|MAILTO}} のように、ジョブの失敗時にメールを送信する組み込み機能はありません。代わりに、{{ic|1=OnFailure=}} を使用して同様の機能を設定する方法については、[[systemd#Eメールでの通知]] を参照してください。

また、デフォルトでは [[systemd/ユーザー|ユーザー]] タイマー・ユニットは、ユーザーのログインセッションがアクティブな間のみ実行されます。ただし、[[systemd/ユーザー#systemd のユーザーインスタンスを自動起動|lingering]] を有効にすることで、ユーザーがログインしていない状態でも、ブート時にサービスを実行できるようになります。

=== crontab を使用する ===

crontab を使って定期的なサービスを管理するツールとして {{aur|systemd-cron-next}} と {{aur|systemd-cron}} があります。どちらも [[AUR]] からインストールすることができます。これらのツールには systemd に存在しない {{ic|MAILTO}} 機能が実装されています。

もし、スケジュールされたジョブをまとめて見れるから crontab が好きだという場合は、{{ic|systemctl}} でそれと同じことが可能です。[[#管理]] を見て下さい。

=== 手動で行う ===

既存の crontab から移行する以外に、cron と同じ周期を使用することが望ましい場合があります。定期的に開始する各サービスのタイマーを作成するという面倒な作業を回避するには、[[systemd#ユニットを使う|テンプレートユニット]] を使用します。例:

{{hc|/etc/systemd/system/monthly@.timer|2=
[Unit]
Description=Monthly Timer for %i service

[Timer]
OnCalendar=*-*-1 02:00:00
AccuracySec=6h
RandomizedDelaySec=1h
Persistent=true
Unit=%i.service

[Install]
WantedBy=default.target
}}

{{Note|タイマーの起動によってすべてのユニットが同時に開始されるのを避けるために、{{ic|AccuracySec}} だけでなく {{ic|RandomizedDelaySec}} を使用する重要性については、{{man|5|systemd.timer|OPTIONS}} を参照してください。}}

その後、{{ic|monthly@''unit_name''.timer}} を [[起動/有効化]] 行うだけで済みます。

{{Tip|テンプレートユニットはネストできます。たとえば、{{ic|monthly@btrfs-scrub@mnt-$(systemd-escape bbb76c63-e4ac-4e39-8897-a120c5d30686).timer}} を [[起動/有効化]] することができます。}}

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

=== "有効期間" の処理 ===

一部のソフトウェアは、最後に実行されてからの経過時間を追跡します。たとえば、最後のダウンロードが 24 時間以内に終了した場合はデータベースの更新をブロックします。

デフォルトでは、タイマーは起動したタスクがいつ終了したかを追跡しません。これを回避するには、{{ic|OnUnitInactiveSeconds}} を使用できます:

{{hc|/etc/systemd/system/daily-inactive@.timer|2=
[Unit]
Description=Launch %i service 24hours after it deactivated

[Timer]
'''OnUnitInactiveSec=1day1sec'''
Unit=%i.service
Persistent=true

[Install]
WantedBy=default.target
}}

{{Tip|{{ic|1=Restart=on-failure}} と {{ic|RestartSec}} を併用すると、失敗と成功の後に異なるスケジュールに従ってユニットを再実行することができます。{{man|5|systemd.service|OPTIONS}} を参照して下さい。}}

=== デスクトップ通知 ===

{{AUR|systemd-timer-notify}} は、systemd のタイマーによってサービスが実行された際に、自動的にデスクトップ通知を表示するツールです。通知はサービスの実行中に表示され、サービスの終了とともに自動的に閉じられます。

このツールは、CPU 使用率が高い原因を把握したり、バックアップサービスが終了していない場合にシャットダウンを防いだりするのに役立ちます。

詳細および設定オプションについては、以下のページをご覧ください:
https://gitlab.com/Zesko/systemd-timer-notify

== 参照 ==

* {{man|5|systemd.timer}}
* [https://fedoraproject.org/wiki/Features/SystemdCalendarTimers Fedora Project wiki] の ''systemd'' カレンダータイマーのページ
* [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki] の ''systemd'' タイマーサービスのセクション
* {{App|systemd-cron|cron スクリプトを実行する systemd ユニットが入っています。''systemd-crontab-generator'' を使って crontab を変換。|https://github.com/systemd-cron/systemd-cron|{{Aur|systemd-cron}}}}
* {{App|systemd-cron-next|crontab と anacrontab ファイルからタイマーとサービスを生成するツール|https://github.com/systemd-cron/systemd-cron-next|{{Aur|systemd-cron-next-git}}}}
* [https://fedoramagazine.org/systemd-timers-for-scheduling-tasks/ Systemd Timers for Scheduling Tasks]

Systemd/タイマー

2025-05-02T16:03:59Z

Kgx: /* 参照 */ 同期

{{Lowercase title}}
[[Category:システム管理]]
[[de:Systemd/Timers]]
[[en:Systemd/Timers]]
[[es:Systemd/Timers]]
[[fr:Systemd/cron]]
[[pt:Systemd/Timers]]
[[ru:Systemd (Русский)/Timers]]
[[zh-hans:Systemd/Timers]]
{{Related articles start}}
{{Related|systemd}}
{{Related|systemd/ユーザー}}
{{Related|systemd FAQ}}
{{Related|cron}}
{{Related articles end}}
タイマーは名前が {{ic|.timer}} で終わる [[systemd]] のユニットファイルであり、{{ic|.service}} ファイルやイベントを制御します。[[cron]] の代わりとしてタイマーを使うことができます ([[#cron を置き換える]] を読んで下さい)。タイマーにはカレンダー時刻のイベントとモノトニック時刻のイベントのサポートが入っており、さらに非同期に実行することも可能です。

== タイマーユニット ==

タイマーは拡張子が {{ic|.timer}} の ''systemd'' のユニットファイルです。他の [[systemd#ユニットファイル|ユニット設定ファイル]] と似ていますが特別に {{ic|[Timer]}} セクションが存在します。{{ic|[Timer]}} セクションにはタイマーが作動する時間と処理を定義します。タイマーには2つのタイプがあり、どちらか一つを使って定義されます:

* '''モノトニックタイマー''' は刻々と変わる開始点と相応したタイムスパンの後に作動します。様々なモノトニックタイマーが存在しますがどれも次のような形式です: {{ic|1=On''Type''Sec=}} {{ic|OnBootSec}} と {{ic|OnActiveSec}} は全てのモノトニックタイマーで共通です。
* '''リアルタイムタイマー''' (別名ウォールクロックタイマー) は (cron のジョブと同じように) カレンダーイベントにあわせて作動します。{{ic|1=OnCalendar=}} オプションを使って定義を行います。

タイマーのオプションについては {{man|5|systemd.timer}} の [[man ページ]] で説明されています。カレンダーイベントやタイムスパンの引数構文については {{man|7|systemd.time}} の [[man ページ]] で説明されています。

{{Note|''systemd'' は、ブート後にアクティブにする必要があるすべてのタイマーを設定するターゲット {{ic|timers.target}} を提供します (詳細については、{{man|7|systemd.special}} を参照してください) これを使用するには、タイマーの {{ic|[Install]}} セクションに {{ic|1=WantedBy=timers.target}} を追加し、タイマーユニットを [[有効化]] します。}}

== サービスユニット ==

それぞれの {{ic|.timer}} ファイルには、対応する {{ic|.service}} ファイルが存在します (例: {{ic|foo.timer}} と {{ic|foo.service}})。{{ic|.timer}} ファイルは {{ic|.service}} ファイルを作動・制御します。{{ic|.service}} に {{ic|[Install]}} セクションは必要ありません。有効にするのは ''timer'' ユニットだからです。必要ならば、タイマーの {{ic|[Timer]}} セクションで {{ic|1=Unit=}} オプションを使うことで別の名前のユニットを制御することもできます。

== 管理 ==

''timer'' ユニットを使用するには、他のユニットと同じように[[systemd#ユニットを使う|有効化・起動]]します。起動しているタイマーを全て表示するには、次を実行:

{{hc|$ systemctl list-timers|
NEXT LEFT LAST PASSED UNIT ACTIVATES
Thu 2014-07-10 19:37:03 CEST 11h left Wed 2014-07-09 19:37:03 CEST 12h ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service
Fri 2014-07-11 00:00:00 CEST 15h left Thu 2014-07-10 00:00:13 CEST 8h ago logrotate.timer logrotate.service
}}

{{Note|
* (有効でないタイマーも含めて) 全てのタイマーを確認したい場合、{{ic|systemctl list-timers --all}} を使って下さい。
* タイマーによって実行するサービスの状態は、今現在作動しているのでない限り、inactive になります。
* タイマーがズレる場合は、{{ic|/var/lib/systemd/timers}} もしくは {{ic|~/.local/share/systemd/}} にある {{ic|stamp-*}} ファイルを削除してみてください。stamp ファイルはタイマーが実行された最後の時刻を記録しており、ファイルを削除することでタイマーの次の作動時に systemd が再構成を行います。
}}

== サンプル ==

タイマーを使用してサービスを実行するのにあたって、service ユニットファイルに変更を加える必要はありません。以下の例では {{ic|foo.timer}} という名前のタイマーを使って {{ic|foo.service}} を定期的に実行します。

=== モノトニックタイマー ===

起動15分後に実行され、システムが起動している間、一週間ごとに再度実行されるタイマー:

{{hc|/etc/systemd/system/foo.timer|<nowiki>
[Unit]
Description=Run foo weekly and on boot

[Timer]
OnBootSec=15min
OnUnitActiveSec=1w

[Install]
WantedBy=timers.target
</nowiki>}}

=== リアルタイムタイマー ===

一週間ごとに起動するタイマー (月曜日の午前12:00に実行)。システムの電源が切られていたなどの理由で、最後の起動時間を過ぎていた場合、すぐに実行されます ({{ic|1=Persistent=true}} オプション):

{{hc|/etc/systemd/system/foo.timer|<nowiki>
[Unit]
Description=Run foo weekly

[Timer]
OnCalendar=weekly
Persistent=true

[Install]
WantedBy=timers.target</nowiki>}}

もっと細かく日時を指定する必要がある場合、次の形式で {{ic|OnCalendar}} イベントを制御できます: {{ic|DayOfWeek Year-Month-Day Hour:Minute:Second}}。アスタリスクをワイルドカードとして使うことができ、カンマで複数の日時を指定することができます。値を {{ic|..}} で区切ることで連続的に日程を指定することも可能です。

例えば、以下の場合、毎月の1日から4日まで、月曜日か火曜日の場合にのみ、午後0時にサービスを実行します:

OnCalendar=Mon,Tue *-*-01..04 12:00:00

毎月第1土曜日にサービスを実行したい場合は以下のようになります:

OnCalendar=Sat *-*-1..7 18:00:00

毎朝4時に実行したい場合は以下のようになります:

OnCalendar=*-*-* 4:00:00

{{ic|OnCalendar}} は複数指定でき、複数の異なるタイミングでサービスを実行できます。次の例では、平日の22:30および土日の20:00に実行されます:

OnCalendar=Mon..Fri 22:30
OnCalendar=Sat,Sun 20:00

ディレクティブの最後にタイムゾーンを指定することもできます (受け入れられる値をリストするには、{{ic|timedatectl list-timezones}} を使用します。)

OnCalendar=*-*-* 02:00:00 Europe/Paris

詳しくは {{man|7|systemd.time}} を見てください。

{{Tip|
* {{ic|OnCalendar}} の日時の指定方法は ''systemd-analyze'' ユーティリティの {{ic|calendar}} オプションを使用することでテストすることができます。タイマーユニットで使用したときに次に実行される日時も確認できます。例えば、{{ic|systemd-analyze calendar weekly}} や {{ic|systemd-analyze calendar "Mon,Tue *-*-01..04 12:00:00"}} のようにコマンドを実行することでテストできます。
* {{Pkg|libfaketime}} でインストールできる {{ic|faketime}} コマンドを使うと、これらのコマンドを使ったいろいろなシナリオをテストするのに便利です。
* {{ic|daily}} や {{ic|weekly}} などの特殊なイベントの表現は''特定の起動時間''を示しているため、同じカレンダーイベントが設定されているタイマーがあった場合、同時に起動します。そのようなことが発生すると、タイマーのサービスがシステムリソースを取り合って、システムパフォーマンスが落ち込む可能性があります。このような問題は {{ic|RandomizedDelaySec}} オプションを使用してタイマーの起動時間を散らすことで解決できます。{{man|5|systemd.timer}} を参照してください。
* {{ic|AccuracySec}} のデフォルト値 ''1m'' の不正確さを避けるために、オプション {{ic|1=AccuracySec=1us}} を [Timer] セクションに追加します。{{man|5|systemd.timer}} も参照してください。
* 一部のオプション ({{ic|WakeSystem}}) は、特定のシステム機能を必要とし、タイマーの開始を妨げる場合があり、その結果、次のエラーメッセージが表示されます: "Failed to enter waiting state: Operation not supported" そして "Failed with result 'resources'."
}}

== 一時的な .timer ユニット ==

{{ic|systemd-run}} を使うことで一時的な {{ic|.timer}} ユニットを作ることができます。サービスファイルを作成しなくても、特定時刻にコマンドが実行されるように設定することが可能です。例えば、以下のコマンドは30秒後にファイルを作成します:

# systemd-run --on-active=30 /bin/touch /tmp/foo

タイマーファイルが存在しない既存のサービスファイルを指定することもできます。例えば、以下のコマンドは12.5時間後に {{ic|''someunit''.service}} という名前の systemd ユニットを起動します:

# systemd-run --on-active="12h 30m" --unit ''someunit''.service

詳しくは {{man|1|systemd-run}} を見てください。

== cron を置き換える ==

おそらく一番有名なジョブスケジューラは [[cron]] ですが、''systemd'' のタイマーはその代替手段になりえます。

=== メリット ===

タイマーを使う主要なメリットは、それぞれのジョブが固有の ''systemd'' サービスを使うというところに根ざします。そのメリットには以下のようなものがあります:

* タイマーとは別個にジョブを実行することが簡単にできます。これによってデバッグが楽になります。
* 特定の環境で動作するようにジョブを設定することができます ({{man|5|systemd.exec}} [[man ページ]]を参照)。
* ジョブを [[cgroups]] の支配下に置けます。
* 他の ''systemd'' ユニットに依存するようにジョブを設定できます。
* ''systemd'' の journal でジョブが記録されるのでデバッグが簡単です。

=== 注意事項 ===

cron では簡単にできることが、タイマーユニットを使用する場合、難しかったり不可能であったりすることがいくつか存在します。

* 冗長性: ''systemd'' を使って定期的なジョブを設定するには2つのファイルを作成して2回 {{ic|systemctl}} コマンドを実行します。それに対して crontab には一行を追加するだけです。
* メール: ジョブが失敗した時にメールを送信する cron の {{ic|MAILTO}} と同等なものは存在しません。ただし各サービスに {{ic|1=OnFailure=}} オプションを使うことで同じような機能を設定することはできます。

=== MAILTO ===

Cron の {{ic|MAILTO}} のように、systemd で、ユニットが失敗したときにメールを送信するように設定できます。それにはまず2つのファイルが必要です: メールを送信するための実行可能ファイルと、実行可能ファイルを起動するための ''.service''。以下の例では、{{ic|sendmail}} ({{ic|smtp-forwarder}} を含むパッケージにはすべて含まれています) を使用するシェルスクリプトが実行可能ファイルになっています:

{{hc|/usr/local/bin/systemd-email|<nowiki>#!/bin/bash

/usr/bin/sendmail -t <<ERRMAIL
To: $1
From: systemd <root@$HOSTNAME>
Subject: $2
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset=UTF-8

$(systemctl status --full "$2")
ERRMAIL</nowiki>}}

どんな実行可能ファイルを使うのであれ、上記のシェルスクリプトのように、最低でも2つの引数が必要になります: 送信先のアドレスと状態を取得するユニットファイルです。以下の ''.service'' はそれらの引数を渡します:

{{hc|/etc/systemd/system/status-email-''user''@.service|2=[Unit]
Description=status email for %i to ''user''

[Service]
Type=oneshot
ExecStart=/usr/local/bin/systemd-email ''address'' %i
User=nobody
Group=systemd-journal}}

{{ic|''user''}} はメールを送信するユーザーに、{{ic|''address''}} はユーザーのメールアドレスに置き換えてください。受信者はハードコードされますが、インスタンスパラメータとしてユニットファイルを渡すことで、上記のサービスだけで他のユニットのメールも送ることができます。{{ic|status-email-''user''@dbus.service}} を[[systemd#ユニットを使う|起動]]して、メールが受け取れることを確認してください。

問題ないようでしたら、メールを送って欲しいユニットの {{ic|[Unit]}} セクションに {{ic|1=OnFailure=status-email-''user''@%n.service}} を追加してください。{{ic|%n}} はユニットの名前をテンプレートに指定します。

{{note|
*[[SSMTP#セキュリティ]] にしたがって SSMTP を設定した場合、ユーザー {{ic|nobody}} は {{ic|/etc/ssmtp/ssmtp.conf}} にアクセスすることができず、{{ic|systemctl start status-email-''user''@dbus.service}} コマンドは失敗します。{{ic|status-email-''user''@.service}} モジュールの User に {{ic|root}} を使うことでこれを回避できます。
* メールスクリプトで {{ic|mail -s somelogs ''address''}} を使用すると、{{ic|mail}} はフォークして、systemd はスクリプトの終了を確認したときに mail プロセスを終了します。{{ic|mail -Ssendwait -s somelogs ''address''}} として mail がフォークしないようにしてください。}}

=== crontab を使用する ===

crontab を使って定期的なサービスを管理するツールとして {{aur|systemd-cron-next}} と {{aur|systemd-cron}} があります。どちらも [[AUR]] からインストールすることができます。これらのツールには systemd に存在しない {{ic|MAILTO}} 機能が実装されています。

もし、スケジュールされたジョブをまとめて見れるから crontab が好きだという場合は、{{ic|systemctl}} でそれと同じことが可能です。[[#管理]] を見て下さい。

=== 手動で行う ===

既存の crontab から移行する以外に、cron と同じ周期を使用することが望ましい場合があります。定期的に開始する各サービスのタイマーを作成するという面倒な作業を回避するには、[[systemd#ユニットを使う|テンプレートユニット]] を使用します。例:

{{hc|/etc/systemd/system/monthly@.timer|2=
[Unit]
Description=Monthly Timer for %i service

[Timer]
OnCalendar=*-*-1 02:00:00
AccuracySec=6h
RandomizedDelaySec=1h
Persistent=true
Unit=%i.service

[Install]
WantedBy=default.target
}}

{{Note|タイマーの起動によってすべてのユニットが同時に開始されるのを避けるために、{{ic|AccuracySec}} だけでなく {{ic|RandomizedDelaySec}} を使用する重要性については、{{man|5|systemd.timer|OPTIONS}} を参照してください。}}

その後、{{ic|monthly@''unit_name''.timer}} を [[起動/有効化]] 行うだけで済みます。

{{Tip|テンプレートユニットはネストできます。たとえば、{{ic|monthly@btrfs-scrub@mnt-$(systemd-escape bbb76c63-e4ac-4e39-8897-a120c5d30686).timer}} を [[起動/有効化]] することができます。}}

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

=== "有効期間" の処理 ===

一部のソフトウェアは、最後に実行されてからの経過時間を追跡します。たとえば、最後のダウンロードが 24 時間以内に終了した場合はデータベースの更新をブロックします。

デフォルトでは、タイマーは起動したタスクがいつ終了したかを追跡しません。これを回避するには、{{ic|OnUnitInactiveSeconds}} を使用できます:

{{hc|/etc/systemd/system/daily-inactive@.timer|2=
[Unit]
Description=Launch %i service 24hours after it deactivated

[Timer]
'''OnUnitInactiveSec=1day1sec'''
Unit=%i.service
Persistent=true

[Install]
WantedBy=default.target
}}

{{Tip|{{ic|1=Restart=on-failure}} と {{ic|RestartSec}} を併用すると、失敗と成功の後に異なるスケジュールに従ってユニットを再実行することができます。{{man|5|systemd.service|OPTIONS}} を参照して下さい。}}

=== デスクトップ通知 ===

{{AUR|systemd-timer-notify}} は、systemd のタイマーによってサービスが実行された際に、自動的にデスクトップ通知を表示するツールです。通知はサービスの実行中に表示され、サービスの終了とともに自動的に閉じられます。

このツールは、CPU 使用率が高い原因を把握したり、バックアップサービスが終了していない場合にシャットダウンを防いだりするのに役立ちます。

詳細および設定オプションについては、以下のページをご覧ください:
https://gitlab.com/Zesko/systemd-timer-notify

== 参照 ==

* {{man|5|systemd.timer}}
* [https://fedoraproject.org/wiki/Features/SystemdCalendarTimers Fedora Project wiki] の ''systemd'' カレンダータイマーのページ
* [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki] の ''systemd'' タイマーサービスのセクション
* {{App|systemd-cron|cron スクリプトを実行する systemd ユニットが入っています。''systemd-crontab-generator'' を使って crontab を変換。|https://github.com/systemd-cron/systemd-cron|{{Aur|systemd-cron}}}}
* {{App|systemd-cron-next|crontab と anacrontab ファイルからタイマーとサービスを生成するツール|https://github.com/systemd-cron/systemd-cron-next|{{Aur|systemd-cron-next-git}}}}
* [https://fedoramagazine.org/systemd-timers-for-scheduling-tasks/ Systemd Timers for Scheduling Tasks]

Systemd/タイマー

2025-05-02T16:02:19Z

Kgx: /* "有効期間" の処理 */ 同期

{{Lowercase title}}
[[Category:システム管理]]
[[de:Systemd/Timers]]
[[en:Systemd/Timers]]
[[es:Systemd/Timers]]
[[fr:Systemd/cron]]
[[pt:Systemd/Timers]]
[[ru:Systemd (Русский)/Timers]]
[[zh-hans:Systemd/Timers]]
{{Related articles start}}
{{Related|systemd}}
{{Related|systemd/ユーザー}}
{{Related|systemd FAQ}}
{{Related|cron}}
{{Related articles end}}
タイマーは名前が {{ic|.timer}} で終わる [[systemd]] のユニットファイルであり、{{ic|.service}} ファイルやイベントを制御します。[[cron]] の代わりとしてタイマーを使うことができます ([[#cron を置き換える]] を読んで下さい)。タイマーにはカレンダー時刻のイベントとモノトニック時刻のイベントのサポートが入っており、さらに非同期に実行することも可能です。

== タイマーユニット ==

タイマーは拡張子が {{ic|.timer}} の ''systemd'' のユニットファイルです。他の [[systemd#ユニットファイル|ユニット設定ファイル]] と似ていますが特別に {{ic|[Timer]}} セクションが存在します。{{ic|[Timer]}} セクションにはタイマーが作動する時間と処理を定義します。タイマーには2つのタイプがあり、どちらか一つを使って定義されます:

* '''モノトニックタイマー''' は刻々と変わる開始点と相応したタイムスパンの後に作動します。様々なモノトニックタイマーが存在しますがどれも次のような形式です: {{ic|1=On''Type''Sec=}} {{ic|OnBootSec}} と {{ic|OnActiveSec}} は全てのモノトニックタイマーで共通です。
* '''リアルタイムタイマー''' (別名ウォールクロックタイマー) は (cron のジョブと同じように) カレンダーイベントにあわせて作動します。{{ic|1=OnCalendar=}} オプションを使って定義を行います。

タイマーのオプションについては {{man|5|systemd.timer}} の [[man ページ]] で説明されています。カレンダーイベントやタイムスパンの引数構文については {{man|7|systemd.time}} の [[man ページ]] で説明されています。

{{Note|''systemd'' は、ブート後にアクティブにする必要があるすべてのタイマーを設定するターゲット {{ic|timers.target}} を提供します (詳細については、{{man|7|systemd.special}} を参照してください) これを使用するには、タイマーの {{ic|[Install]}} セクションに {{ic|1=WantedBy=timers.target}} を追加し、タイマーユニットを [[有効化]] します。}}

== サービスユニット ==

それぞれの {{ic|.timer}} ファイルには、対応する {{ic|.service}} ファイルが存在します (例: {{ic|foo.timer}} と {{ic|foo.service}})。{{ic|.timer}} ファイルは {{ic|.service}} ファイルを作動・制御します。{{ic|.service}} に {{ic|[Install]}} セクションは必要ありません。有効にするのは ''timer'' ユニットだからです。必要ならば、タイマーの {{ic|[Timer]}} セクションで {{ic|1=Unit=}} オプションを使うことで別の名前のユニットを制御することもできます。

== 管理 ==

''timer'' ユニットを使用するには、他のユニットと同じように[[systemd#ユニットを使う|有効化・起動]]します。起動しているタイマーを全て表示するには、次を実行:

{{hc|$ systemctl list-timers|
NEXT LEFT LAST PASSED UNIT ACTIVATES
Thu 2014-07-10 19:37:03 CEST 11h left Wed 2014-07-09 19:37:03 CEST 12h ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service
Fri 2014-07-11 00:00:00 CEST 15h left Thu 2014-07-10 00:00:13 CEST 8h ago logrotate.timer logrotate.service
}}

{{Note|
* (有効でないタイマーも含めて) 全てのタイマーを確認したい場合、{{ic|systemctl list-timers --all}} を使って下さい。
* タイマーによって実行するサービスの状態は、今現在作動しているのでない限り、inactive になります。
* タイマーがズレる場合は、{{ic|/var/lib/systemd/timers}} もしくは {{ic|~/.local/share/systemd/}} にある {{ic|stamp-*}} ファイルを削除してみてください。stamp ファイルはタイマーが実行された最後の時刻を記録しており、ファイルを削除することでタイマーの次の作動時に systemd が再構成を行います。
}}

== サンプル ==

タイマーを使用してサービスを実行するのにあたって、service ユニットファイルに変更を加える必要はありません。以下の例では {{ic|foo.timer}} という名前のタイマーを使って {{ic|foo.service}} を定期的に実行します。

=== モノトニックタイマー ===

起動15分後に実行され、システムが起動している間、一週間ごとに再度実行されるタイマー:

{{hc|/etc/systemd/system/foo.timer|<nowiki>
[Unit]
Description=Run foo weekly and on boot

[Timer]
OnBootSec=15min
OnUnitActiveSec=1w

[Install]
WantedBy=timers.target
</nowiki>}}

=== リアルタイムタイマー ===

一週間ごとに起動するタイマー (月曜日の午前12:00に実行)。システムの電源が切られていたなどの理由で、最後の起動時間を過ぎていた場合、すぐに実行されます ({{ic|1=Persistent=true}} オプション):

{{hc|/etc/systemd/system/foo.timer|<nowiki>
[Unit]
Description=Run foo weekly

[Timer]
OnCalendar=weekly
Persistent=true

[Install]
WantedBy=timers.target</nowiki>}}

もっと細かく日時を指定する必要がある場合、次の形式で {{ic|OnCalendar}} イベントを制御できます: {{ic|DayOfWeek Year-Month-Day Hour:Minute:Second}}。アスタリスクをワイルドカードとして使うことができ、カンマで複数の日時を指定することができます。値を {{ic|..}} で区切ることで連続的に日程を指定することも可能です。

例えば、以下の場合、毎月の1日から4日まで、月曜日か火曜日の場合にのみ、午後0時にサービスを実行します:

OnCalendar=Mon,Tue *-*-01..04 12:00:00

毎月第1土曜日にサービスを実行したい場合は以下のようになります:

OnCalendar=Sat *-*-1..7 18:00:00

毎朝4時に実行したい場合は以下のようになります:

OnCalendar=*-*-* 4:00:00

{{ic|OnCalendar}} は複数指定でき、複数の異なるタイミングでサービスを実行できます。次の例では、平日の22:30および土日の20:00に実行されます:

OnCalendar=Mon..Fri 22:30
OnCalendar=Sat,Sun 20:00

ディレクティブの最後にタイムゾーンを指定することもできます (受け入れられる値をリストするには、{{ic|timedatectl list-timezones}} を使用します。)

OnCalendar=*-*-* 02:00:00 Europe/Paris

詳しくは {{man|7|systemd.time}} を見てください。

{{Tip|
* {{ic|OnCalendar}} の日時の指定方法は ''systemd-analyze'' ユーティリティの {{ic|calendar}} オプションを使用することでテストすることができます。タイマーユニットで使用したときに次に実行される日時も確認できます。例えば、{{ic|systemd-analyze calendar weekly}} や {{ic|systemd-analyze calendar "Mon,Tue *-*-01..04 12:00:00"}} のようにコマンドを実行することでテストできます。
* {{Pkg|libfaketime}} でインストールできる {{ic|faketime}} コマンドを使うと、これらのコマンドを使ったいろいろなシナリオをテストするのに便利です。
* {{ic|daily}} や {{ic|weekly}} などの特殊なイベントの表現は''特定の起動時間''を示しているため、同じカレンダーイベントが設定されているタイマーがあった場合、同時に起動します。そのようなことが発生すると、タイマーのサービスがシステムリソースを取り合って、システムパフォーマンスが落ち込む可能性があります。このような問題は {{ic|RandomizedDelaySec}} オプションを使用してタイマーの起動時間を散らすことで解決できます。{{man|5|systemd.timer}} を参照してください。
* {{ic|AccuracySec}} のデフォルト値 ''1m'' の不正確さを避けるために、オプション {{ic|1=AccuracySec=1us}} を [Timer] セクションに追加します。{{man|5|systemd.timer}} も参照してください。
* 一部のオプション ({{ic|WakeSystem}}) は、特定のシステム機能を必要とし、タイマーの開始を妨げる場合があり、その結果、次のエラーメッセージが表示されます: "Failed to enter waiting state: Operation not supported" そして "Failed with result 'resources'."
}}

== 一時的な .timer ユニット ==

{{ic|systemd-run}} を使うことで一時的な {{ic|.timer}} ユニットを作ることができます。サービスファイルを作成しなくても、特定時刻にコマンドが実行されるように設定することが可能です。例えば、以下のコマンドは30秒後にファイルを作成します:

# systemd-run --on-active=30 /bin/touch /tmp/foo

タイマーファイルが存在しない既存のサービスファイルを指定することもできます。例えば、以下のコマンドは12.5時間後に {{ic|''someunit''.service}} という名前の systemd ユニットを起動します:

# systemd-run --on-active="12h 30m" --unit ''someunit''.service

詳しくは {{man|1|systemd-run}} を見てください。

== cron を置き換える ==

おそらく一番有名なジョブスケジューラは [[cron]] ですが、''systemd'' のタイマーはその代替手段になりえます。

=== メリット ===

タイマーを使う主要なメリットは、それぞれのジョブが固有の ''systemd'' サービスを使うというところに根ざします。そのメリットには以下のようなものがあります:

* タイマーとは別個にジョブを実行することが簡単にできます。これによってデバッグが楽になります。
* 特定の環境で動作するようにジョブを設定することができます ({{man|5|systemd.exec}} [[man ページ]]を参照)。
* ジョブを [[cgroups]] の支配下に置けます。
* 他の ''systemd'' ユニットに依存するようにジョブを設定できます。
* ''systemd'' の journal でジョブが記録されるのでデバッグが簡単です。

=== 注意事項 ===

cron では簡単にできることが、タイマーユニットを使用する場合、難しかったり不可能であったりすることがいくつか存在します。

* 冗長性: ''systemd'' を使って定期的なジョブを設定するには2つのファイルを作成して2回 {{ic|systemctl}} コマンドを実行します。それに対して crontab には一行を追加するだけです。
* メール: ジョブが失敗した時にメールを送信する cron の {{ic|MAILTO}} と同等なものは存在しません。ただし各サービスに {{ic|1=OnFailure=}} オプションを使うことで同じような機能を設定することはできます。

=== MAILTO ===

Cron の {{ic|MAILTO}} のように、systemd で、ユニットが失敗したときにメールを送信するように設定できます。それにはまず2つのファイルが必要です: メールを送信するための実行可能ファイルと、実行可能ファイルを起動するための ''.service''。以下の例では、{{ic|sendmail}} ({{ic|smtp-forwarder}} を含むパッケージにはすべて含まれています) を使用するシェルスクリプトが実行可能ファイルになっています:

{{hc|/usr/local/bin/systemd-email|<nowiki>#!/bin/bash

/usr/bin/sendmail -t <<ERRMAIL
To: $1
From: systemd <root@$HOSTNAME>
Subject: $2
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset=UTF-8

$(systemctl status --full "$2")
ERRMAIL</nowiki>}}

どんな実行可能ファイルを使うのであれ、上記のシェルスクリプトのように、最低でも2つの引数が必要になります: 送信先のアドレスと状態を取得するユニットファイルです。以下の ''.service'' はそれらの引数を渡します:

{{hc|/etc/systemd/system/status-email-''user''@.service|2=[Unit]
Description=status email for %i to ''user''

[Service]
Type=oneshot
ExecStart=/usr/local/bin/systemd-email ''address'' %i
User=nobody
Group=systemd-journal}}

{{ic|''user''}} はメールを送信するユーザーに、{{ic|''address''}} はユーザーのメールアドレスに置き換えてください。受信者はハードコードされますが、インスタンスパラメータとしてユニットファイルを渡すことで、上記のサービスだけで他のユニットのメールも送ることができます。{{ic|status-email-''user''@dbus.service}} を[[systemd#ユニットを使う|起動]]して、メールが受け取れることを確認してください。

問題ないようでしたら、メールを送って欲しいユニットの {{ic|[Unit]}} セクションに {{ic|1=OnFailure=status-email-''user''@%n.service}} を追加してください。{{ic|%n}} はユニットの名前をテンプレートに指定します。

{{note|
*[[SSMTP#セキュリティ]] にしたがって SSMTP を設定した場合、ユーザー {{ic|nobody}} は {{ic|/etc/ssmtp/ssmtp.conf}} にアクセスすることができず、{{ic|systemctl start status-email-''user''@dbus.service}} コマンドは失敗します。{{ic|status-email-''user''@.service}} モジュールの User に {{ic|root}} を使うことでこれを回避できます。
* メールスクリプトで {{ic|mail -s somelogs ''address''}} を使用すると、{{ic|mail}} はフォークして、systemd はスクリプトの終了を確認したときに mail プロセスを終了します。{{ic|mail -Ssendwait -s somelogs ''address''}} として mail がフォークしないようにしてください。}}

=== crontab を使用する ===

crontab を使って定期的なサービスを管理するツールとして {{aur|systemd-cron-next}} と {{aur|systemd-cron}} があります。どちらも [[AUR]] からインストールすることができます。これらのツールには systemd に存在しない {{ic|MAILTO}} 機能が実装されています。

もし、スケジュールされたジョブをまとめて見れるから crontab が好きだという場合は、{{ic|systemctl}} でそれと同じことが可能です。[[#管理]] を見て下さい。

=== 手動で行う ===

既存の crontab から移行する以外に、cron と同じ周期を使用することが望ましい場合があります。定期的に開始する各サービスのタイマーを作成するという面倒な作業を回避するには、[[systemd#ユニットを使う|テンプレートユニット]] を使用します。例:

{{hc|/etc/systemd/system/monthly@.timer|2=
[Unit]
Description=Monthly Timer for %i service

[Timer]
OnCalendar=*-*-1 02:00:00
AccuracySec=6h
RandomizedDelaySec=1h
Persistent=true
Unit=%i.service

[Install]
WantedBy=default.target
}}

{{Note|タイマーの起動によってすべてのユニットが同時に開始されるのを避けるために、{{ic|AccuracySec}} だけでなく {{ic|RandomizedDelaySec}} を使用する重要性については、{{man|5|systemd.timer|OPTIONS}} を参照してください。}}

その後、{{ic|monthly@''unit_name''.timer}} を [[起動/有効化]] 行うだけで済みます。

{{Tip|テンプレートユニットはネストできます。たとえば、{{ic|monthly@btrfs-scrub@mnt-$(systemd-escape bbb76c63-e4ac-4e39-8897-a120c5d30686).timer}} を [[起動/有効化]] することができます。}}

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

=== "有効期間" の処理 ===

一部のソフトウェアは、最後に実行されてからの経過時間を追跡します。たとえば、最後のダウンロードが 24 時間以内に終了した場合はデータベースの更新をブロックします。

デフォルトでは、タイマーは起動したタスクがいつ終了したかを追跡しません。これを回避するには、{{ic|OnUnitInactiveSeconds}} を使用できます:

{{hc|/etc/systemd/system/daily-inactive@.timer|2=
[Unit]
Description=Launch %i service 24hours after it deactivated

[Timer]
'''OnUnitInactiveSec=1day1sec'''
Unit=%i.service
Persistent=true

[Install]
WantedBy=default.target
}}

{{Tip|{{ic|1=Restart=on-failure}} と {{ic|RestartSec}} を併用すると、失敗と成功の後に異なるスケジュールに従ってユニットを再実行することができます。{{man|5|systemd.service|OPTIONS}} を参照して下さい。}}

=== デスクトップ通知 ===

{{AUR|systemd-timer-notify}} は、systemd のタイマーによってサービスが実行された際に、自動的にデスクトップ通知を表示するツールです。通知はサービスの実行中に表示され、サービスの終了とともに自動的に閉じられます。

このツールは、CPU 使用率が高い原因を把握したり、バックアップサービスが終了していない場合にシャットダウンを防いだりするのに役立ちます。

詳細および設定オプションについては、以下のページをご覧ください:
https://gitlab.com/Zesko/systemd-timer-notify

== 参照 ==

* {{man|5|systemd.timer}}
* [https://fedoraproject.org/wiki/Features/SystemdCalendarTimers Fedora Project wiki] の ''systemd'' カレンダータイマーのページ
* [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki] の ''systemd'' タイマーサービスのセクション
* {{App|systemd-cron-next|crontab と anacrontab ファイルからタイマーとサービスを生成するツール|https://github.com/systemd-cron/systemd-cron-next|{{Aur|systemd-cron-next}}}}
* {{App|systemd-cron|cron スクリプトを実行する systemd ユニットが入っています。''systemd-crontab-generator'' を使って crontab を変換。|https://github.com/systemd-cron/systemd-cron|{{Aur|systemd-cron}}}}

Makepkg-optimize

2025-04-28T05:48:09Z

Kgx: /* chroot を使う */ 同期

{{Lowercase title}}
[[Category:パッケージ管理]]
[[en:Makepkg-optimize]]
[[ru:Makepkg-optimize]]
{{Related articles start}}
{{Related|DeveloperWiki:クリーンな chroot 内でビルドする}}
{{Related|Arch User Repository}}
{{Related articles end}}

{{AUR|makepkg-optimize}} は [[pacman]] を補助する [https://git.archlinux.org/pacman.git/commit/?id=295a3491adc4af5c8634ac82777212ed9c664457 tidy]、[https://git.archlinux.org/pacman.git/commit/?id=508b4e3ec0cb3e365942f4dc0626edda4789932b buildenv] と [https://git.archlinux.org/pacman.git/commit/?id=0bb04fa16a82db133dd010478c1256bc8500c5e7 executable] スクリプト集です。{{ic|build()}} と {{ic|package()}} で最適化をかけるマクロを提供します。

{{Note|[[Arch User Repository]] の他のパッケージと同じく、{{AUR|makepkg-optimize}} に公式サポートはありません。AUR ページのコメント欄を使ってください。}}

== インストール ==

{{AUR|makepkg-optimize}} をインストールしてください。また、最適化を行うためにバックエンドをインストールしてください: {{Pkg|openmp}}, {{Pkg|upx}}, {{Pkg|optipng}}, {{AUR|svgo}}, {{Pkg|polly}}

== 設定 ==

{{AUR|makepkg-optimize}} は現在の [[makepkg]] の設定から {{ic|/etc/makepkg-optimize.conf}} という名前の [https://jlk.fjfi.cvut.cz/arch/manpages/man/makepkg.conf.5 設定ファイル] を生成します。

このファイルには[[Makepkg#最適化されたパッケージの作成|コンパイルフラグ]], [https://aur.archlinux.org/cgit/aur.git/tree/buildenv_ext.conf?h=makepkg-optimize ビルド環境], [https://aur.archlinux.org/cgit/aur.git/tree/pkgopts_ext.conf?h=makepkg-optimize パッケージオプション], [https://aur.archlinux.org/cgit/aur.git/tree/destdirs_ext.conf?h=makepkg-optimize パッケージ出力], [https://aur.archlinux.org/cgit/aur.git/tree/compress-param_max.conf?h=makepkg-optimize 圧縮デフォルト] の追加オプションが記載されています。デフォルトでは全て無効となっています。

== 最適化されたパッケージのビルド ==

{{Warning|最適化によってはパッケージのビルドが上手くいかなくなることがあり、過最適化がパフォーマンスの劣化を引き起こしたりセグメンテーション違反が発生する可能性もあります。}}

[[#設定|最適化の設定]]を行ったら、[[Makepkg#使用方法|ビルド]]するときに設定ファイルを指定してください:

$ makepkg -c --config /etc/makepkg-optimize.conf

{{Tip|パッケージに古い最適化フラグを再利用しないように、{{ic|makepkg}}に{{ic|-c}}を使用します。[[Makepkg#使用方法]]を参照してください。}}

{{Note|[[Wikipedia:Profile-guided optimization|Profile-guided optimization]] ではパッケージを''2回''ビルド・インストールする必要があります。最初 {{ic|$PROFDEST/''pkgbase''.gen}} にプロファイルを生成して、それからプロファイルを {{ic|$PROFDEST/''pkgbase''.used}} に移動して適用します。}}

== chroot で最適化されたパッケージのビルド ==

また、{{ic|makepkg-optimize}} を使って [[en2:DeveloperWiki:Building in a clean chroot#Classic way|chroot]] の中で最適化済みのパッケージをビルドすることもできます。

=== Chroot の設定 ===

[[DeveloperWiki:クリーンな chroot でビルドする#古典的な方法|chroot をセットアップ]]した後、設定が必要です。

==== makepkg-optimize とバックエンドのインストール ====

まず、chroot に最適化マクロのバックエンドをインストール:

$ arch-nspawn "$CHROOT"/root pacman -S openmp upx optipng polly

それから {{AUR|makepkg-optimize}} と {{AUR|svgo}} を[[Arch User Repository#ビルドファイルを獲得|ダウンロード]]・[[DeveloperWiki:クリーンな chroot でビルドする#chroot でのビルド|ビルド]]してください。

chroot でインストールするには、以下のようにパッケージファイルをコピーしてインストールします:

# cp svgo-1.2.2-2-any.pkg.tar.xz "$CHROOT"/root/root/
$ arch-nspawn "$CHROOT"/root pacman -U /root/svgo-1.2.2-2-any.pkg.tar.xz
{{Warning|上記の操作を行うと完全な chroot ではなくなります。}}

=== chroot を使う ===

==== パッケージのビルド ====

まず、{{ic|$CHROOT/root/etc/makepkg-optimize.conf}} を編集して[[makepkg-optimize#設定|好みの最適化を選択]]してください。

[[DeveloperWiki:クリーンな chroot でビルドする#chroot でのビルド|ビルド]]するときに、{{ic|makepkg}} に設定ファイルを指定してください:

$ makechrootpkg -c -r "$CHROOT" -- -c --config /etc/makepkg-optimize.conf

===== PGO でビルド =====

{{ic|BUILDENV}} の {{ic|pgo}} オプションは、パッケージのビルド時にこのフラグが有効になっているかどうかによって、プロファイルの ''生成'' または ''適用'' のどちらかを行います。
クリーンな chroot ビルドでは、プロファイル生成時にはソフトウェアが chroot の外で実行される一方で、再コンパイル時にはプロファイルを chroot 内から適用する必要があるため、これが複雑になります。
この問題を解決する方法は、バインドマウントされたフォルダーを使って、3つのファイルシステム間を橋渡しすることです。

====== PGO キャッシュの作成 ======

プロファイルデータを保存するフォルダーを作成してバインドします [https://gcc.gnu.org/onlinedocs/gcc/Gcov-Data-Files.html profiles]:

# mkdir -m 777 {"$CHROOT"/{root,"$USER"},}/mnt/pgo
# mount -o bind {,"$CHROOT"/root}/mnt/pgo
# mount -o bind "$CHROOT"/{root,"$USER"}/mnt/pgo

{{Tip|起動時にこれらのフォルダーを自動的にバインドするには、[[fstab]] を使います。[https://serverfault.com/a/613184 bind] の設定例:
#PGODEST
/full/path/to/$CHROOT/$USER/mnt/pgo/ /mnt/pgo/ none bind,x-gvfs-hide 0 0
/mnt/pgo/ /full/path/to/$CHROOT/root/mnt/pgo/ none bind,x-gvfs-hide 0 0

{{Note|chroot 内の pgo ディレクトリへのパスは、$VARIABLES を使わずにフルパスで記述してください。}} }}

{{ic|$CHROOT/root/etc/makepkg-optimize.conf}} を編集し、{{ic|1=PROFDEST=/mnt/pgo}} を設定します。

====== プログラムのプロファイル ======

パッケージをビルドして、[[Pacman#追加コマンド|インストール]]して、テスト実行してみてください。

{{Note|プログラムの {{ic|exit()}} 時にプロファイルは作成されます。[[systemd]] などのデーモンの場合、プロファイルを作成するには再起動が必要となります。再起動したら、再ビルドする前に PGO キャッシュを再バインドしてください。}}

ソフトウェアを一通り使ったら、パッケージを[[#パッケージのビルド|再ビルド]]・再インストールしてください。

Makepkg-optimize

2025-04-28T05:47:07Z

Kgx: /* PGO でビルド */ 同期

{{Lowercase title}}
[[Category:パッケージ管理]]
[[en:Makepkg-optimize]]
[[ru:Makepkg-optimize]]
{{Related articles start}}
{{Related|DeveloperWiki:クリーンな chroot 内でビルドする}}
{{Related|Arch User Repository}}
{{Related articles end}}

{{AUR|makepkg-optimize}} は [[pacman]] を補助する [https://git.archlinux.org/pacman.git/commit/?id=295a3491adc4af5c8634ac82777212ed9c664457 tidy]、[https://git.archlinux.org/pacman.git/commit/?id=508b4e3ec0cb3e365942f4dc0626edda4789932b buildenv] と [https://git.archlinux.org/pacman.git/commit/?id=0bb04fa16a82db133dd010478c1256bc8500c5e7 executable] スクリプト集です。{{ic|build()}} と {{ic|package()}} で最適化をかけるマクロを提供します。

{{Note|[[Arch User Repository]] の他のパッケージと同じく、{{AUR|makepkg-optimize}} に公式サポートはありません。AUR ページのコメント欄を使ってください。}}

== インストール ==

{{AUR|makepkg-optimize}} をインストールしてください。また、最適化を行うためにバックエンドをインストールしてください: {{Pkg|openmp}}, {{Pkg|upx}}, {{Pkg|optipng}}, {{AUR|svgo}}, {{Pkg|polly}}

== 設定 ==

{{AUR|makepkg-optimize}} は現在の [[makepkg]] の設定から {{ic|/etc/makepkg-optimize.conf}} という名前の [https://jlk.fjfi.cvut.cz/arch/manpages/man/makepkg.conf.5 設定ファイル] を生成します。

このファイルには[[Makepkg#最適化されたパッケージの作成|コンパイルフラグ]], [https://aur.archlinux.org/cgit/aur.git/tree/buildenv_ext.conf?h=makepkg-optimize ビルド環境], [https://aur.archlinux.org/cgit/aur.git/tree/pkgopts_ext.conf?h=makepkg-optimize パッケージオプション], [https://aur.archlinux.org/cgit/aur.git/tree/destdirs_ext.conf?h=makepkg-optimize パッケージ出力], [https://aur.archlinux.org/cgit/aur.git/tree/compress-param_max.conf?h=makepkg-optimize 圧縮デフォルト] の追加オプションが記載されています。デフォルトでは全て無効となっています。

== 最適化されたパッケージのビルド ==

{{Warning|最適化によってはパッケージのビルドが上手くいかなくなることがあり、過最適化がパフォーマンスの劣化を引き起こしたりセグメンテーション違反が発生する可能性もあります。}}

[[#設定|最適化の設定]]を行ったら、[[Makepkg#使用方法|ビルド]]するときに設定ファイルを指定してください:

$ makepkg -c --config /etc/makepkg-optimize.conf

{{Tip|パッケージに古い最適化フラグを再利用しないように、{{ic|makepkg}}に{{ic|-c}}を使用します。[[Makepkg#使用方法]]を参照してください。}}

{{Note|[[Wikipedia:Profile-guided optimization|Profile-guided optimization]] ではパッケージを''2回''ビルド・インストールする必要があります。最初 {{ic|$PROFDEST/''pkgbase''.gen}} にプロファイルを生成して、それからプロファイルを {{ic|$PROFDEST/''pkgbase''.used}} に移動して適用します。}}

== chroot で最適化されたパッケージのビルド ==

また、{{ic|makepkg-optimize}} を使って [[en2:DeveloperWiki:Building in a clean chroot#Classic way|chroot]] の中で最適化済みのパッケージをビルドすることもできます。

=== Chroot の設定 ===

[[DeveloperWiki:クリーンな chroot でビルドする#古典的な方法|chroot をセットアップ]]した後、設定が必要です。

==== makepkg-optimize とバックエンドのインストール ====

まず、chroot に最適化マクロのバックエンドをインストール:

$ arch-nspawn "$CHROOT"/root pacman -S openmp upx optipng polly

それから {{AUR|makepkg-optimize}} と {{AUR|svgo}} を[[Arch User Repository#ビルドファイルを獲得|ダウンロード]]・[[DeveloperWiki:クリーンな chroot でビルドする#chroot でのビルド|ビルド]]してください。

chroot でインストールするには、以下のようにパッケージファイルをコピーしてインストールします:

# cp svgo-1.2.2-2-any.pkg.tar.xz "$CHROOT"/root/root/
$ arch-nspawn "$CHROOT"/root pacman -U /root/svgo-1.2.2-2-any.pkg.tar.xz
{{Warning|上記の操作を行うと完全な chroot ではなくなります。}}

=== chroot を使う ===

{{Note|chroot を [[en2:DeveloperWiki:Building in a clean chroot#Building in the chroot|アップデート]] するとき、[[#makepkg-optimize とバックエンドのインストール|AUR パッケージ]]は手動で更新が必要です。}}

==== パッケージのビルド ====

まず、{{ic|$CHROOT/root/etc/makepkg-optimize.conf}} を編集して[[makepkg-optimize#設定|好みの最適化を選択]]してください。

[[DeveloperWiki:クリーンな chroot でビルドする#chroot でのビルド|ビルド]]するときに、{{ic|makepkg}} に設定ファイルを指定してください:

$ makechrootpkg -c -r "$CHROOT" -- -c --config /etc/makepkg-optimize.conf

===== PGO でビルド =====

{{ic|BUILDENV}} の {{ic|pgo}} オプションは、パッケージのビルド時にこのフラグが有効になっているかどうかによって、プロファイルの ''生成'' または ''適用'' のどちらかを行います。
クリーンな chroot ビルドでは、プロファイル生成時にはソフトウェアが chroot の外で実行される一方で、再コンパイル時にはプロファイルを chroot 内から適用する必要があるため、これが複雑になります。
この問題を解決する方法は、バインドマウントされたフォルダーを使って、3つのファイルシステム間を橋渡しすることです。

====== PGO キャッシュの作成 ======

プロファイルデータを保存するフォルダーを作成してバインドします [https://gcc.gnu.org/onlinedocs/gcc/Gcov-Data-Files.html profiles]:

# mkdir -m 777 {"$CHROOT"/{root,"$USER"},}/mnt/pgo
# mount -o bind {,"$CHROOT"/root}/mnt/pgo
# mount -o bind "$CHROOT"/{root,"$USER"}/mnt/pgo

{{Tip|起動時にこれらのフォルダーを自動的にバインドするには、[[fstab]] を使います。[https://serverfault.com/a/613184 bind] の設定例:
#PGODEST
/full/path/to/$CHROOT/$USER/mnt/pgo/ /mnt/pgo/ none bind,x-gvfs-hide 0 0
/mnt/pgo/ /full/path/to/$CHROOT/root/mnt/pgo/ none bind,x-gvfs-hide 0 0

{{Note|chroot 内の pgo ディレクトリへのパスは、$VARIABLES を使わずにフルパスで記述してください。}} }}

{{ic|$CHROOT/root/etc/makepkg-optimize.conf}} を編集し、{{ic|1=PROFDEST=/mnt/pgo}} を設定します。

====== プログラムのプロファイル ======

パッケージをビルドして、[[Pacman#追加コマンド|インストール]]して、テスト実行してみてください。

{{Note|プログラムの {{ic|exit()}} 時にプロファイルは作成されます。[[systemd]] などのデーモンの場合、プロファイルを作成するには再起動が必要となります。再起動したら、再ビルドする前に PGO キャッシュを再バインドしてください。}}

ソフトウェアを一通り使ったら、パッケージを[[#パッケージのビルド|再ビルド]]・再インストールしてください。

Makepkg-optimize

2025-04-28T05:45:16Z

Kgx: /* PGO キャッシュの作成 */ 同期

{{Lowercase title}}
[[Category:パッケージ管理]]
[[en:Makepkg-optimize]]
[[ru:Makepkg-optimize]]
{{Related articles start}}
{{Related|DeveloperWiki:クリーンな chroot 内でビルドする}}
{{Related|Arch User Repository}}
{{Related articles end}}

{{AUR|makepkg-optimize}} は [[pacman]] を補助する [https://git.archlinux.org/pacman.git/commit/?id=295a3491adc4af5c8634ac82777212ed9c664457 tidy]、[https://git.archlinux.org/pacman.git/commit/?id=508b4e3ec0cb3e365942f4dc0626edda4789932b buildenv] と [https://git.archlinux.org/pacman.git/commit/?id=0bb04fa16a82db133dd010478c1256bc8500c5e7 executable] スクリプト集です。{{ic|build()}} と {{ic|package()}} で最適化をかけるマクロを提供します。

{{Note|[[Arch User Repository]] の他のパッケージと同じく、{{AUR|makepkg-optimize}} に公式サポートはありません。AUR ページのコメント欄を使ってください。}}

== インストール ==

{{AUR|makepkg-optimize}} をインストールしてください。また、最適化を行うためにバックエンドをインストールしてください: {{Pkg|openmp}}, {{Pkg|upx}}, {{Pkg|optipng}}, {{AUR|svgo}}, {{Pkg|polly}}

== 設定 ==

{{AUR|makepkg-optimize}} は現在の [[makepkg]] の設定から {{ic|/etc/makepkg-optimize.conf}} という名前の [https://jlk.fjfi.cvut.cz/arch/manpages/man/makepkg.conf.5 設定ファイル] を生成します。

このファイルには[[Makepkg#最適化されたパッケージの作成|コンパイルフラグ]], [https://aur.archlinux.org/cgit/aur.git/tree/buildenv_ext.conf?h=makepkg-optimize ビルド環境], [https://aur.archlinux.org/cgit/aur.git/tree/pkgopts_ext.conf?h=makepkg-optimize パッケージオプション], [https://aur.archlinux.org/cgit/aur.git/tree/destdirs_ext.conf?h=makepkg-optimize パッケージ出力], [https://aur.archlinux.org/cgit/aur.git/tree/compress-param_max.conf?h=makepkg-optimize 圧縮デフォルト] の追加オプションが記載されています。デフォルトでは全て無効となっています。

== 最適化されたパッケージのビルド ==

{{Warning|最適化によってはパッケージのビルドが上手くいかなくなることがあり、過最適化がパフォーマンスの劣化を引き起こしたりセグメンテーション違反が発生する可能性もあります。}}

[[#設定|最適化の設定]]を行ったら、[[Makepkg#使用方法|ビルド]]するときに設定ファイルを指定してください:

$ makepkg -c --config /etc/makepkg-optimize.conf

{{Tip|パッケージに古い最適化フラグを再利用しないように、{{ic|makepkg}}に{{ic|-c}}を使用します。[[Makepkg#使用方法]]を参照してください。}}

{{Note|[[Wikipedia:Profile-guided optimization|Profile-guided optimization]] ではパッケージを''2回''ビルド・インストールする必要があります。最初 {{ic|$PROFDEST/''pkgbase''.gen}} にプロファイルを生成して、それからプロファイルを {{ic|$PROFDEST/''pkgbase''.used}} に移動して適用します。}}

== chroot で最適化されたパッケージのビルド ==

また、{{ic|makepkg-optimize}} を使って [[en2:DeveloperWiki:Building in a clean chroot#Classic way|chroot]] の中で最適化済みのパッケージをビルドすることもできます。

=== Chroot の設定 ===

[[DeveloperWiki:クリーンな chroot でビルドする#古典的な方法|chroot をセットアップ]]した後、設定が必要です。

==== makepkg-optimize とバックエンドのインストール ====

まず、chroot に最適化マクロのバックエンドをインストール:

$ arch-nspawn "$CHROOT"/root pacman -S openmp upx optipng polly

それから {{AUR|makepkg-optimize}} と {{AUR|svgo}} を[[Arch User Repository#ビルドファイルを獲得|ダウンロード]]・[[DeveloperWiki:クリーンな chroot でビルドする#chroot でのビルド|ビルド]]してください。

chroot でインストールするには、以下のようにパッケージファイルをコピーしてインストールします:

# cp svgo-1.2.2-2-any.pkg.tar.xz "$CHROOT"/root/root/
$ arch-nspawn "$CHROOT"/root pacman -U /root/svgo-1.2.2-2-any.pkg.tar.xz
{{Warning|上記の操作を行うと完全な chroot ではなくなります。}}

=== chroot を使う ===

{{Note|chroot を [[en2:DeveloperWiki:Building in a clean chroot#Building in the chroot|アップデート]] するとき、[[#makepkg-optimize とバックエンドのインストール|AUR パッケージ]]は手動で更新が必要です。}}

==== パッケージのビルド ====

まず、{{ic|$CHROOT/root/etc/makepkg-optimize.conf}} を編集して[[makepkg-optimize#設定|好みの最適化を選択]]してください。

[[DeveloperWiki:クリーンな chroot でビルドする#chroot でのビルド|ビルド]]するときに、{{ic|makepkg}} に設定ファイルを指定してください:

$ makechrootpkg -c -r "$CHROOT" -- -c --config /etc/makepkg-optimize.conf

===== PGO でビルド =====

====== PGO キャッシュの作成 ======

プロファイルデータを保存するフォルダーを作成してバインドします [https://gcc.gnu.org/onlinedocs/gcc/Gcov-Data-Files.html profiles]:

# mkdir -m 777 {"$CHROOT"/{root,"$USER"},}/mnt/pgo
# mount -o bind {,"$CHROOT"/root}/mnt/pgo
# mount -o bind "$CHROOT"/{root,"$USER"}/mnt/pgo

{{Tip|起動時にこれらのフォルダーを自動的にバインドするには、[[fstab]] を使います。[https://serverfault.com/a/613184 bind] の設定例:
#PGODEST
/full/path/to/$CHROOT/$USER/mnt/pgo/ /mnt/pgo/ none bind,x-gvfs-hide 0 0
/mnt/pgo/ /full/path/to/$CHROOT/root/mnt/pgo/ none bind,x-gvfs-hide 0 0

{{Note|chroot 内の pgo ディレクトリへのパスは、$VARIABLES を使わずにフルパスで記述してください。}} }}

{{ic|$CHROOT/root/etc/makepkg-optimize.conf}} を編集し、{{ic|1=PROFDEST=/mnt/pgo}} を設定します。

====== プログラムのプロファイル ======

パッケージをビルドして、[[Pacman#追加コマンド|インストール]]して、テスト実行してみてください。

{{Note|プログラムの {{ic|exit()}} 時にプロファイルは作成されます。[[systemd]] などのデーモンの場合、プロファイルを作成するには再起動が必要となります。再起動したら、再ビルドする前に PGO キャッシュを再バインドしてください。}}

ソフトウェアを一通り使ったら、パッケージを[[#パッケージのビルド|再ビルド]]・再インストールしてください。

Ext4

2025-04-26T15:24:05Z

Kgx: 翻訳ステータスを更新

[[Category:ファイルシステム]]
[[de:Ext4]]
[[en:Ext4]]
[[es:Ext4]]
[[fr:Ext4]]
[[ru:Ext4]]
[[zh-hans:Ext4]]
{{Related articles start}}
{{Related|ファイルシステム}}
{{Related|Ext3}}
{{Related articles end}}

Ext4 は Linux で一番よく使われているファイルシステム、Ext3 の発展版です。多くの点で、Ext3 から Ext4 になって Ext2 から Ext3 に進んだときよりも大きな改善がされています。Ext3 では Ext2 にジャーナリングを追加したのがほとんどでしたが、Ext4 ではファイルデータを保存するファイルシステムの重要なデータ構造にメスが入っています。その結果、改良された設計、優れたパフォーマンス、信頼性、機能性を備えたファイルシステムが誕生しました (ソース: [http://kernelnewbies.org/Ext4 Ext4 - Linux Kernel Newbies])

== 新しく ext4 ファイルシステムを作成 ==

{{Pkg|e2fsprogs}} を [[インストール]] します。

パーティションをフォーマットするには次を実行:

# mkfs.ext4 /dev/''partition''

{{Tip|
*オプションについては {{man|8|mke2fs}} の [[man ページ]]を見て下さい。{{ic|/etc/mke2fs.conf}} を編集すればデフォルトのオプションを見たり設定できます。
*サポートされている場合は、[[Ext4#メタデータチェックサムを有効化する|メタデータチェックサム]] を有効にすることをお勧めします。
}}

=== Bytes-per-inode 比率 ===

'''mke2fs''' はひとつの inode に対してディスク上に ''bytes-per-inode'' バイト分の領域を作成します。''bytes-per-inode'' 比率を大きくすることで、作成される inode は少なくなります。詳しくは {{man|8|mke2fs}} を参照。

新しいファイルやディレクトリ、シンボリックリンクなどを作成するとき [[Wikipedia:Inode|inode]] が最低でもひとつは必要です。inode の数が少なすぎると、たとえディスクに空き容量があったとしてもファイルシステムにファイルを作成できなくなります。

ファイルシステムを作成した後に bytes-per-inode 比率や inode の数を変更することはできないため、ファイルが作成できなくなってしまわないように {{ic|mkfs.ext4}} はデフォルトでは比率を低くして inode に対して16384バイト (16Kb) を割り当てます。

しかしながら、1GB 以上のファイルが多数存在してファイルの平均容量がメガバイト級になるような使い方をしているパーティションの場合、inode の数が多すぎてファイルの作成では inode の限界に絶対に達しないということになります。

未使用の inode にも256バイト取られるのでディスク領域の無駄使いです (256バイトという数字は {{ic|/etc/mke2fs.conf}} で設定されていますが変更してはいけません) 256バイトでも数百万の inode に換算するとギガバイト単位で容量を無駄にしていることになります。

{{ic|df}} と {{ic|df -i}} を実行したときの {{ic|{I}Use%}} の値を比較することでどれくらい無駄になっているのか確認できます:

{{hc|$ df -h /home|
Filesystem Size Used Avail '''Use%''' Mounted on
/dev/mapper/lvm-home 115G 56G 59G '''49%''' /home}}
{{hc|$ df -hi /home|
Filesystem Inodes IUsed IFree '''IUse%''' Mounted on
/dev/mapper/lvm-home 1.8M 1.1K 1.8M '''1%''' /home}}

bytes-per-inode 比率を変更するには、{{ic|-T ''usage-type''}} オプションを使用します。{{ic|/etc/mke2fs.conf}} で定義されたタイプを使用してファイルシステムの利用方法を指定できます。{{ic|largefile}} や {{ic|largefile4}} タイプは inode に対してそれぞれ 1 MiB と 4 MiB という大きな容量を割り当てます。以下のように使うことができます:

# mkfs.ext4 -T largefile /dev/''device''

{{ic|-i}} オプションを使って bytes-per-inode 比率を直接設定することもできます。例えば {{ic|-i 2097152}} なら 2 MiB、{{ic|-i 6291456}} なら 6 MiB になります。

{{Tip|逆に、メールやニュースグループのアイテムなどで小さなファイルを何百万も保存するような使い方をする場合、{{ic|news}} (ひとつの inode に4096バイトを割り当て) や {{ic|small}} (inode 自体のサイズやブロックサイズも小さくする) などのタイプを使うこともできます。}}

{{Warning|シンボリックリンクを大量に使用する場合は、bytes-per-inode 比率を低くして inode の数量は大きくしてください。シンボリックリンクを作成しても容量は取られませんが inode はひとつ消費されるので、ファイルシステムの inode をあっという間に使い切ってしまう可能性があります。}}

=== 予約ブロック ===

デフォルトでは、ファイルシステムの 5% はフラグメントが起こらないように root ユーザー用に予約されます。非特権のプロセスがファイルシステムに書き込めなくなってからも root が使用しているデーモンは正しく動作し続けることができます (詳しくは {{man|8|mke2fs}} を参照)。

最近の大容量ディスクでは、パーティションを長期アーカイブとして使用したり、システム運用に重要でない場合({{ic|/home}}など)必要以上に大きな値を設定します。予約ブロックに関する ext4 開発者の Ted Ts'o の意見は [https://www.redhat.com/archives/ext3-users/2009-January/msg00026.html このメール] を、このトピックに関する一般的な背景は [https://superuser.com/questions/1256074/how-much-space-to-leave-free-on-hdd-or-ssd/1257550#1257550 このスーパーユーザの回答] を参照してください。

パーティションが以下の条件を満たしているならば、ディスク容量を増やすために予約ブロックの割合を減らしても大抵は問題ありません:

*パーティションがとても大きい (例えば 50GB 以上)
*長期保存用のアーカイブとして使っている、頻繁にファイルを作成したり削除することがない。

ext4 関連のユーティリティを使うときに {{ic|-m}} オプションで予約ブロックの割合を指定できます。

ファイルシステムの作成時に予約ブロックを全く作成しないようにするには:

# mkfs.ext4 -m 0 /dev/''device''

パーティションの予約ブロックの割合を 1% に設定するには:

# tune2fs -m 1 /dev/''device''

予約ブロック数をギガバイト単位の絶対サイズに設定する場合は、{{ic|-r}} を使用します。

# tune2fs -r $((''ngigs'' * 1024**3 / ''blocksize'')) /dev/''device''

{{ic|''blocksize''}} はファイルシステムのブロックサイズをバイト単位で指定します。これはほとんどの場合 4096 ですが、念のため確認することができます。

{{hc|# tune2fs -l /dev/''device'' {{!}} egrep '^Block size:'|
Block size: 4096
}}

{{ic|$(())}} 構文は、数式展開のための構文です。この構文は {{Pkg|bash}} と {{Pkg|zsh}} では動作しますが、{{Pkg|fish}} では動作しません。''fish'' では、このような構文になります。

# tune2fs -r (math 'ngigs * 1024^3 / blocksize') /dev/''device''

これらのコマンドは、現在マウントされているファイルシステムに適用することができ、変更は即座に反映されます。デバイス名は {{man|8|findmnt}} で調べることができます。

# tune2fs -m 1 "$(findmnt -no SOURCE ''/the/mount/point'')"

現在の予約ブロック数を問い合わせる場合。

{{hc|# tune2fs -l /dev/mapper/proxima-root {{!}} egrep '^Reserved block count:'|
Reserved block count: 2975334
}}

これはブロック数なので、これにファイルシステムのブロックサイズを掛けて、バイト数やギガバイト数を得る必要があります。{{ic|1=2975334 * 4096 / 1024**3 = 11.34 GiB}} です。

==ext2/ext3 から ext4 に移行==

===ext2/ext3 パーティションを変換せずに ext4 としてマウント===

====理由====

ext4 を完全に変換する案と ext2/ext3 をそのまま使用する案の折衷案として、既存の ext2/ext3 パーティションを ext4 としてマウントする方法があります。

'''利点:'''
* 互換性 (ext2/ext3 としてファイルシステムをマウントできます) – ext4 のサポートがないオペレーティングシステムからもファイルシステムを読み込むことが可能です (例: Windows の ext2/ext3 ドライバー)
* パフォーマンスが向上 (ext4 パーティションに完全に変換するのよりは劣ります) – 詳しくは [http://kernelnewbies.org/Ext4] や [http://events.linuxfoundation.org/slides/2010/linuxcon_japan/linuxcon_jp2010_fujita.pdf] を見てください。

'''欠点:'''
* ext4 の機能を全て活用することはできません (マルチブロックアロケーションや遅延アロケーションなどのディスクフォーマットに変更を与える機能は使えません)

{{Note|ext4 が比較的新しいファイルシステムということ以外に (このこと自体をリスクと考えることもできます)、この方法を使用することで不利益になることは特にありません。}}

====方法====

# {{ic|/etc/fstab}} を編集して ext4 としてマウントしたいパーティションの 'type' を ext2/ext3 から ext4 に変更してください。
# 変更したパーティションを再マウントします。

===ext2/ext3 パーティションを ext4 に変換===

====理由====

ext4 の能力を活かすには、非可逆の変換をする必要があります。

'''利点:'''
* パフォーマンスの向上と新機能 – 詳しくは [http://kernelnewbies.org/Ext4] や [http://events.linuxfoundation.org/slides/2010/linuxcon_japan/linuxcon_jp2010_fujita.pdf] を見てください。

'''欠点:'''
* {{ic|/boot}} パーティションなど、静的なファイルしか存在しない場合、新機能を使うメリットはありません。さらに、ジャーナリングによって性能がむしろ落ちる可能性もあります。
* 一方通行 (ext4 パーティションを ext2/ext3 に'ダウングレード'することはできません) ただしエクステントなどのオプションを有効にしなければ後方互換性を確保できます。

====方法====

以下の手順は [http://ext4.wiki.kernel.org/index.php/Ext4_Howto カーネルドキュメント] と [https://bbs.archlinux.org/viewtopic.php?id=61602 フォーラムスレッド] から引用しています。

{{Warning|
* システムのルートパーティションを変換する場合、再起動時にフォールバックの initramfs が使えるようになっていることを確認してください。また、変換する前に {{ic|/etc/mkinitcpio.conf}} の [[Mkinitcpio#MODULES|MODULES]] 行に {{ic|ext4}} を追加して {{Ic|mkinitcpio -p linux}} でデフォルトの initramfs を再作成してください。
* 分割している {{ic|/boot}} パーティションを変換する場合、[[ブートローダー]]が ext4 からの起動に対応していることを確認してください。}}

# '''[[バックアッププログラム|バックアップ]]'''を行なって下さい。ext4 に変換する ext3 パーティションに存在するデータを全てバックアップします。特に / (root) パーティションをバックアップする場合は、[http://clonezilla.org Clonezilla] が役に立ちます。
# {{ic|/etc/fstab}} を編集して ext4 に変換するパーティションの 'type' を ext3 から ext4 に変換してください。
# (必要であれば) ライブメディアを起動します。{{Pkg|e2fsprogs}} で変換を行う際はドライブがマウントされていない状態になっている必要があります。ドライブの root (/) パーティションを変換するときは、他のライブメディアから起動して変換するのが一番簡単です。
# パーティションがマウントされていないことを確認してください
# ext2 パーティションを変換する場合、まずは {{ic|tune2fs -j /dev/sdxX}} を root で実行して[[ファイルシステム#ジャーナリング|ジャーナル]]を追加して ext3 パーティションに変換してください。
# {{Ic|tune2fs -O extent,uninit_bg,dir_index /dev/sdxX}} を root で実行 ({{Ic|/dev/sdxX}} は変換するパーティションのパスに置き換えて下さい、例: {{Ic|/dev/sda1}})。ext4 に変換されます (不可逆です)
# root で {{Ic|fsck -f /dev/sdxX}} を実行。
#* ファイルシステムのチェックを実行しないとファイルシステムを読み込めなくなります。''fsck'' の実行は必須です。グループ記述子のチェックサムエラーが発見されます。これは仕様通りの動作です。{{ic|-f}} オプションはファイルシステムに問題がない場合でも強制的にチェックを実行します。{{ic|-p}} オプションを使用して自動修復させることもできます (オプションを使用しない場合、エラーに対して入力を求められます)
# 推奨: パーティションをマウントして {{Ic|e4defrag -c -v /dev/sdxX}} を実行。
#* ファイルシステムが ext4 に変換されても、変換前に書き込まれたファイルは ext4 のエクステントオプションを利用することができません。エクステントオプションは巨大なファイルの操作を高速化しフラグメンテーションを減らしてファイルシステムのチェック時間を短縮します。ext4 を活用するには、全てのファイルをディスクに再書き込みする必要があります。''e4defrag'' を使うことで問題を解決できます。
# Arch Linux を再起動してください。

== パフォーマンスの向上 ==

=== アクセス時間の更新を無効にする ===

''ext4''ファイルシステムは、ファイルが最後にアクセスされた時刻に関する情報を記録しますが、これには記録に伴うコストがあります。{{ic|noatime}} や関連するオプションについては、[[fstab#atime オプション]] を参照してください。

=== コミット間隔の増加 ===

{{ic|commit}} オプションで長い時間遅延を提供することにより、データとメタデータの同期間隔を増やすことができます。

デフォルトの5秒は、電源が失われた場合、最新の5秒の作業が失われることを意味します。
5秒ごとにすべてのデータ/ジャーナルを物理メディアに完全に同期します。ただし、ジャーナリングのおかげで、ファイルシステムが損傷することはありません。
次の [[fstab]] は、 {{ic|commit}} の使用法を示しています。

{{hc|/etc/fstab|2=
/dev/sda5 / ext4 defaults,'''commit=60''' 0 1
}}

=== バリアとパフォーマンス ===

{{Warning|バリアを無効化すると、電源が失われたときにキャッシュが正しく書き込まれるか保証がされなくなります。これによってファイルシステムの破壊やデータ損失が発生する場合があります。}}

''Ext4'' はデフォルトで書き込みバリアを有効にします。これにより、書き込みキャッシュの電源が失われた場合でも、ファイルシステムのメタデータがディスク上に正しく書き込まれ、順序付けされることが保証されます。これには、特に ''fsync'' を頻繁に使用するアプリケーションや、小さなファイルを多数作成および削除するアプリケーションの場合、パフォーマンスにコストが伴います。何らかの方法でバッテリーバックアップが行われている書き込みキャッシュを持つディスクの場合、バリアを無効にするとパフォーマンスが安全に向上する可能性があります。

バリアをオフにしたいときは {{ic|/etc/fstab}} の変更したいファイルシステムに {{Ic|1=barrier=0}} オプションを追加してください。例:

{{hc|/etc/fstab|2=
/dev/sda5 / ext4 defaults,'''barrier=0''' 0 1
}}

=== ジャーナリングの無効化 ===

{{Warning|ジャーナリングなしでファイルシステムを使用すると、停電やカーネルのロックアップなどの突然のマウント解除の場合にデータが失われる可能性があります。}}

''ext4'' を使用してジャーナルを無効にするには、マウントされていないディスクで次のコマンドを使用します。

# tune2fs -O "^has_journal" /dev/sdXN

=== ジャーナルを使用してパフォーマンスを最適化する ===

[https://lwn.net/Articles/842385/ Fast commits for ext4] の記事のイントロダクションは、マウントオプション {{ic|1=data=journal}} や {{ic|1=data=writeback}} が、デフォルトの {{ic|1=data=ordered}} 動作モードと比較して、どのように全体的な ext4 のパフォーマンスを高速化するかを簡潔にまとめています。さらに、ジャーナリング自体は、{{ic|journal_async_commit}} マウントオプションを追加することで高速化できます。

{{Note|{{ic|journal_async_commit}} マウントオプションは、デフォルトのマウントオプションである {{ic|1=data=ordered}} と一緒に使うと[https://patchwork.ozlabs.org/patch/414750/ 動作しません]。なので、明示的に {{ic|''ext4_device''}} を別のモードでマウントしてください。{{man|5|ext4|3=data=}} を見てください。}}

さらに別のオプションとして、新しいジャーナルフォーマットを使用する方法があります。詳細は [[#fast_commit を有効化]] を参照してください。

==== 外部ジャーナルデバイス ====

デフォルト以外の {{ic|1=data=}} オプションを使用している場合、専用のジャーナルデバイスを使用することで、ファイル操作が高速化される場合もあります。例えば、データには比較的遅いデバイスを使用し、ジャーナルにはより高速だが小容量の別デバイスを使用する場合などです。別のジャーナルデバイスを設定するには:

# mke2fs -O journal_dev /dev/''journal_device''

{{ic|''ext4_device''}} のジャーナルとして {{ic|''journal_device''}} を割り当てるには、次を使用してください:

# tune2fs -J device=/dev/''journal_device'' /dev/''ext4_device''

{{ic|''ext4_device''}} に新しいファイルシステムを作成したい場合は、{{ic|tune2fs}} の代わりに {{ic|mkfs.ext4}} を使用してください。

{{ic|''journal_device''}} を {{ic|''ext4_device''}} の依存関係として追加するには、{{ic|/etc/fstab}} で {{ic|x-systemd.requires}} マウントオプションを使用します:

{{hc|/etc/fstab|2=
/dev/''ext4_device'' / ext4 defaults,'''x-systemd.requires=/dev/''journal_device''''' 0 1
}}

これにより、{{ic|''journal_device''}} にセットアップ (例:暗号化) が必要な場合でも問題を防ぐことができます。

{{Note|{{ic|UUID}} とジャーナルデバイスの devnum の両方が ext4 ファイルシステムに保存されます。ジャーナルデバイスの読み込み時には devnum のみが使用されるため、ディスクの並び順が変更されると問題が発生します。devnum が間違ったデバイスを指している場合、Linux はファイルシステムのマウントを拒否しますが、以下の回避策が役立つかもしれません:

パスを使用してジャーナルのロードを強制する {{ic|journal_path}} マウントオプションを使い、保存された devnum を無視する:

{{hc|/etc/fstab|2=
/dev/''ext4_device'' / ext4 defaults,x-systemd.requires=/dev/''journal_device'','''journal_path=/dev/''journal_device''''' 0 1
}}

{{ic|e2fsck}} は {{ic|UUID}} を使ってジャーナルデバイスを検索し、ずれていた場合には保存された devnum を修正します。ただし、これを破損とみなして不要なフルファイルシステムスキャンをトリガーしてしまいます([https://github.com/tytso/e2fsprogs/pull/26] を参照)これを {{ic|e2fsck}} の [https://man.archlinux.org/man/e2fsck.conf.5.en 設定ファイル]で無効化できます:

{{hc|/etc/e2fsck.conf|2=
[problems]
# PR_0_EXTERNAL_JOURNAL_HINT: Superblock hint for external superblock should be xxxx
0x000033 = {
# Tell e2fsck that if this problem is encountered, it can be fixed but should
# not be considered corruption, the filesystem should still be marked clean.
not_a_fix = true
}
}}
}}

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

=== ファイルベースの暗号化を使用する ===

Linux 4.1 以降、ext4 はファイル暗号化をネイティブにサポートしています。 [[fscrypt]] の記事を参照してください。暗号化はディレクトリレベルで適用され、ディレクトリごとに異なる暗号化キーを使用できます。これは、ブロックデバイスレベルの暗号化である [[dm-crypt]] と、スタック暗号化ファイルシステムである [[eCryptfs]] の両方とは異なります。

=== メタデータチェックサムを有効化する ===

ファイルシステムが {{Pkg|e2fsprogs}} で作成されている場合。1.43 (2016) 以降では、メタデータチェックサムがデフォルトで有効になっています。既存のファイルシステムを変換して、メタデータチェックサムのサポートを有効にすることができます。

CPU が SSE 4.2 をサポートしている場合、{{ic|crc32c_intel}} が有効であることを確認してください。ハードウェアアクセラレーションによる CRC32C アルゴリズム [https://ext4.wiki.kernel.org/index.php/Ext4_Metadata_Checksums#Benchmarking] を有効にするために [[カーネルモジュール]] がロードされています。もしそうでなければ、代わりに {{ic|crc32c_generic}} モジュールをロードしてください。

メタデータチェックサムの詳細については、[https://ext4.wiki.kernel.org/index.php/Ext4_Metadata_Checksums ext4 wiki] を参照してください。

{{Tip|{{ic|dumpe2fs}} を使用して、ファイルシステムで有効になっている機能を確認します。
# dumpe2fs -h ''/dev/path/to/disk''
}}

{{Note|ファイルシステムをマウントしないでください。}}

まず、{{ic|e2fsck}} を使用してパーティションをチェックし、最適化する必要があります。

# e2fsck -Df ''/dev/path/to/disk''

ファイルシステムを64ビットに変換します。

# resize2fs -b ''/dev/path/to/disk''

最後に、チェックサムサポートを有効にします。

# tune2fs -O metadata_csum ''/dev/path/to/disk''

検証します:

{{hc|# dumpe2fs -h ''/dev/path/to/disk'' {{!}} grep features:|2=
Filesystem features: has_journal ext_attr resize_inode dir_index filetype extent '''64bit''' flex_bg sparse_super large_file huge_file dir_nlink extra_isize '''metadata_csum'''
}}

=== LVM を使用する場合のメンテナンス ===

''e2scrub'' ツールは、ext4ファイルシステムのメタデータをチェックするためのツールで、特に LVM (Logical Volume Manager) の論理ボリュームで使用されている場合に適用されます。このチェックを行うには、ボリュームグループに256MiBの未割り当てスペースが必要です。これは、ツールがチェック用にスナップショットを作成するためです。

{{man|8|e2scrub}} マニュアルによると、このツールはエラーを修復するものではなく、エラーを報告し、次回のマウント前に ''e2fsck''({{man|8|e2fsck}} を参照)の実行が必要であることをファイルシステムにマークします。

このチェックは自動化可能で、例えば、パッケージに含まれる {{ic|e2scrub_all.timer}} ユニットを有効化することで設定できます。

なお、必要な256MiBの未割り当てスペースが不足している場合は、[[LVM#論理ボリュームとファイルシステムのサイズを一度に変更する]] を参照してください。

=== fast_commit を有効化 ===

ext4の "fast commits" 機能は、新しい軽量なジャーナリング方式を導入します。この機能は、ext4 ファイルシステムのパフォーマンスを大幅に向上させることが期待されています。[https://lwn.net/Articles/842385/]

新しいファイルシステムでこの機能を有効にするには、{{ic|fast_commit}} を {{ic|-O}} ファイルシステムオプション引数に含めます。

既存のファイルシステムでこの機能を有効にするには、次のコマンドを実行します:

# tune2fs -O fast_commit /dev/''drivepartition''

現在の構成または変更を確認するには:

# tune2fs -l /dev/''drivepartition'' | grep features

既存のファイルシステムでこの機能を無効にするには、次のコマンドを実行します:

# tune2fs -O '^fast_commit' /dev/''drivepartition''

=== 大文字と小文字を区別しないモードを有効にする ===

{{Warning|
* {{ic|casefold}} 機能が有効にされている場合、それは確実に無効化することができません({{ic|tune2fs}} の潜在的なバグのため)有効化する前に、以下の制限に注意してください
* GRUB は現在、ext4 の {{ic|casefold}} 機能をサポートしていません。[https://savannah.gnu.org/bugs/?56897 GRUB バグ#56897] を参照してください。この機能を GRUB が読み取る必要があるファイルシステムで有効にすると、システムは起動不可能になり、{{ic|unknown filesystem}} という無意味なエラーが表示されます。たとえ実際にディレクトリがその機能を使用していなくてもです。
* {{ic|casefold}} 機能は {{ic|overlayfs}} と互換性がないため、[[Docker]] や [[Podman]] などのコンテナソフトウェアがそのファイルシステムで動作しなくなる可能性があります。また、{{man|8|systemd-sysext}} 拡張イメージなどの高度な [[systemd]] 機能も使用できなくなる場合があります。
}}

Ext4 は大文字と小文字を区別しないモードで使用でき、[[Wine]] で実行されるアプリケーションやゲームのパフォーマンスを向上させることができます。この機能はファイルシステム全体には影響しません。大文字と小文字を区別しない属性が有効になっているディレクトリにのみ影響します。

まず、ファイルシステムでこの機能を有効にします:

# tune2fs -O casefold ''/dev/path/to/disk''

これで、任意のディレクトリで大文字と小文字を区別しない[[ファイルのパーミッションと属性#ファイルの属性|属性]]を有効にできるようになります:

$ chattr +F ''/mnt/partition/case-insensitive-directory''

ディレクトリは空である必要があり、他の場所からサブディレクトリを移動させても、その属性は継承されないことに注意してください。

== 参照 ==

* [https://ext4.wiki.kernel.org/ 公式 Ext4 wiki]
* Ext4 wiki の [https://ext4.wiki.kernel.org/index.php/Ext4_Disk_Layout Ext4 ディスクレイアウト]
* LWN の [https://lwn.net/Articles/639427/ Ext4 暗号化] 記事
* ext4 暗号化のカーネルコミット [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=6162e4b0bedeb3dac2ba0a5e1b1f56db107d97ec] [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=8663da2c0919896788321cd8a0016af08588c656]
* [http://e2fsprogs.sourceforge.net/e2fsprogs-release.html e2fsprogs 変更履歴]
* [https://ext4.wiki.kernel.org/index.php/Ext4_Metadata_Checksums Ext4 メタデータチェックサム]

{{TranslationStatus|Ext4|2025-04-27|805843}}

Ext4

2025-04-26T15:21:56Z

Kgx: /* 外部ジャーナルを使用してパフォーマンスを最適化する */ 同期

ファイルシステム

2025-04-24T12:20:01Z

Kgx: /* ファイルシステムのタイプ */ リンクを修正

[[Category:ファイルシステム]]
[[Category:一覧]]
[[en:File systems]]
[[es:File systems]]
[[it:File systems]]
[[pt:File systems]]
[[ru:File systems]]
[[uk:File systems]]
[[zh-hans:File systems]]
{{Related articles start}}
{{Related|パーティショニング}}
{{Related|デバイスファイル#lsblk}}
{{Related|ファイルのパーミッションと属性}}
{{Related|fsck}}
{{Related|fstab}}
{{Related|アプリケーション一覧/ユーティリティ#マウントツール}}
{{Related|QEMU#raw イメージからパーティションをマウントする}}
{{Related|udev}}
{{Related|udisks}}
{{Related|umask}}
{{Related|USB ストレージデバイス}}
{{Related articles end}}

[[Wikipedia:ja:ファイルシステム|Wikipedia]] より:

:ファイルシステムは、コンピュータのリソースを操作するための、オペレーティングシステム (OS) が持つ機能の一つ。ファイルとは、主に補助記憶装置に格納されたデータを指すが、デバイスやプロセス、カーネル内の情報といったものもファイルとして提供するファイルシステムもある。

:より正確に定義すれば、ファイルシステムは抽象データ型の集まりであり、ストレージ、階層構造、データの操作/アクセス/検索のために実装されたものである。ファイルシステムを特殊用途のデータベース管理システム (DBMS) と見なせるかどうかは議論があるが、ファイルシステムとデータベース管理システムには多くの共通点がある。

個々のドライブパーティションに、多くのファイルシステムのなかから1つを設定することができます。ファイルシステムはそれぞれにメリット、デメリット、特徴があります。ここではサポートされているファイルシステムの概要を記述します。より多くの情報を見るには Wikipedia へのリンクを辿って下さい。

== ファイルシステムのタイプ ==

一般的な概要については {{man|5|filesystems}} を、詳細な機能の比較については [[Wikipedia:Comparison of file systems]] を参照してください。カーネルによってすでにロードされている、あるいは組み込まれているファイルシステムは、{{ic|/proc/filesystems}} にリストアップされています。一方、インストールされているモジュールは {{ic|ls /lib/modules/$(uname -r)/kernel/fs}} ですべて見ることができます。

{| class="wikitable sortable"
|+ 組み込まれている (in-tree) ファイルシステムと FUSE ファイルシステム
! ファイルシステム
! 作成コマンド
! ユーザースペースユーティリティ
! [[Archiso]] [https://gitlab.archlinux.org/archlinux/archiso/-/blob/master/configs/releng/packages.x86_64]
! カーネルのドキュメント [https://docs.kernel.org/filesystems/index.html]
! 備考
|-
| [[Bcachefs]]
| {{man|8|bcachefs}}
| {{Pkg|bcachefs-tools}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/bcachefs/index.html]
| Linux 6.7 から利用可能 (実験的)。
|-
| [[Btrfs]]
| {{man|8|mkfs.btrfs}}
| {{Pkg|btrfs-progs}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/btrfs.html btrfs.html]
| [https://btrfs.readthedocs.io/en/latest/Status.html 安定性に関する状況]
|-
| [[VFAT]]
| {{man|8|mkfs.fat}}
| {{Pkg|dosfstools}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/vfat.html vfat.html]
| [[Wikipedia:ja:Windows 9x系|Windows 9x]] のファイルシステム。一般的に、USB フラッシュドライブや SD カードで用いられます。
|-
| rowspan="2" | [[Wikipedia:ja:exFAT|exFAT]]
| {{man|8|mkfs.exfat}}
| {{Pkg|exfatprogs}}
| {{Yes}}
|
| Linux 5.4 のネイティブのファイルシステム。[https://lwn.net/Articles/799425/] 一般的に、USB フラッシュドライブや SD カードで用いられます。
|-
| {{man|8|mkexfatfs}}
| {{Pkg|exfat-utils}}
| {{No}}
| N/A (FUSE ベース)
|
|-
| [[F2FS]]
| {{man|8|mkfs.f2fs}}
| {{Pkg|f2fs-tools}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/f2fs.html f2fs.html]
| フラッシュメモリベースのデバイス。縮小することはできません。
|-
| [[ext3]]
| {{man|8|mkfs.ext3}}
| {{Pkg|e2fsprogs}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/ext3.html ext3.html]
|
|-
| [[ext4]]
| {{man|8|mkfs.ext4}}
| {{Pkg|e2fsprogs}}
| {{Yes}}
| [https://docs.kernel.org/admin-guide/ext4.html ext4.html]
|
|-
| [[Wikipedia:ja:Hierarchical File System|HFS]]
| {{man|8|mkfs.hfsplus|url=https://manpages.debian.org/unstable/hfsprogs/mkfs.hfsplus.8.en.html}}
| {{AUR|hfsprogs}}
| {{No}}
| [https://docs.kernel.org/filesystems/hfs.html hfs.html]
| [[Wikipedia:ja:Classic Mac OS|Classic Mac OS]] のファイルシステム
|-
| [[Wikipedia:ja:HFS Plus|HFS+]]
| {{man|8|mkfs.hfsplus|url=https://manpages.debian.org/unstable/hfsprogs/mkfs.hfsplus.8.en.html}}
| {{AUR|hfsprogs}}
| {{No}}
| [https://docs.kernel.org/filesystems/hfsplus.html hfsplus.html]
| [[Wikipedia:ja:macOS|macOS]] (8–10.12) のファイルシステム
|-
| [[JFS]]
| {{man|8|mkfs.jfs}}
| {{Pkg|jfsutils}}
| {{Yes}}
| [https://docs.kernel.org/admin-guide/jfs.html jfs.html]
|
|-
| [[Wikipedia:ja:NILFS|NILFS2]]
| {{man|8|mkfs.nilfs2}}
| {{Pkg|nilfs-utils}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/nilfs2.html nilfs2.html]
| 基本的にフラッシュベースのデバイスで用いることを意図しています。[[拡張属性|xattrs]] と [[ACL]] はサポートされていません。
|-
| rowspan="2" | [[NTFS]]
|
|
| {{Yes}}
| [https://docs.kernel.org/filesystems/ntfs3.html ntfs3.html]
| [[Wikipedia:ja:Windows NT|Windows NT]] のファイルシステム。[https://www.paragon-software.com/home/ntfs3-driver-faq/ 新しいドライバ]。Linux 5.15 から利用可能。
|-
| {{man|8|mkfs.ntfs}}
| {{Pkg|ntfs-3g}}
| {{Yes}}
| N/A (FUSE ベース)
| 拡張機能付き FUSE ドライバ。
|-
| [[Wikipedia:ReiserFS|ReiserFS]]
| {{man|8|mkfs.reiserfs|url=https://manpages.debian.org/unstable/reiserfsprogs/mkfs.reiserfs.8.en.html}}
| {{AUR|reiserfsprogs}}
| {{No}}
|
| [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=eb103a51640ee32ab01c51e13bf8fca211f25f61 Linux 5.18 から非推奨となっており]、[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=fb6f20ecb121cef4d7946f834a6ee867c4e21b4a Linux 6.13 で削除されました]。
|-
| [[Wikipedia:ja:Universal Disk Format|UDF]]
| {{man|8|mkfs.udf}}
| {{Pkg|udftools}}
| {{Yes}}
| [https://docs.kernel.org/filesystems/udf.html udf.html]
| ディスクイメージや DVD/ブルーレイ用の ISO/IEC 13346 ファイルシステム。
|-
| [[XFS]]
| {{man|8|mkfs.xfs}}
| {{Pkg|xfsprogs}}
| {{Yes}}
|
[https://docs.kernel.org/admin-guide/xfs.html xfs.html] 
[https://docs.kernel.org/filesystems/xfs/xfs-delayed-logging-design.html xfs-delayed-logging-design.html] 
[https://docs.kernel.org/filesystems/xfs/xfs-self-describing-metadata.html xfs-self-describing-metadata.html]
| [https://web.archive.org/web/20220902080136/https://xfs.org/index.php/XFS_FAQ#Q:_Is_there_a_way_to_make_a_XFS_filesystem_larger_or_smaller.3F 縮小不可]
|}

{| class="wikitable sortable"
|+ 外部 (out-of-tree) のファイルシステム
! ファイルシステム
! 作成コマンド
! カーネルパッチセット
! ユーザースペースユーティリティ
! 備考
|-
| [[Wikipedia:ja:Apple File System|APFS]]
| {{man|8|mkapfs|url=https://manpages.debian.org/unstable/apfsprogs/mkapfs.8.en.html}}
| {{AUR|linux-apfs-rw-dkms-git}}
| {{AUR|apfsprogs-git}}
| [[Wikipedia:ja:macOS|macOS]] (10.13 およびそれ以降) のファイルシステム。読み取り専用。書き込みサポートは試験的。Fuse バージョンの {{AUR|apfs-fuse-git}} も参照。
|-
| [[Wikipedia:ja:Reiser4|Reiser4]]
| {{man|8|mkfs.reiser4|url=https://manpages.debian.org/unstable/reiser4progs/mkfs.reiser4.8.en.html}}
|
| {{AUR|reiser4progs}}
|
|-
| [[ZFS]]
|
| {{AUR|zfs-linux}}, {{AUR|zfs-dkms}}
| {{AUR|zfs-utils}}
| [[Wikipedia:OpenZFS|OpenZFS]] 移植
|}

=== ジャーナリング ===

ext3/4、HFS+、JFS、NTFS、ReiserFS、XFS ファイルシステムは[[Wikipedia:ja:ジャーナリングファイルシステム|ジャーナリング]]を使用します。ジャーナリングは、変更をファイルシステムにコミットする前にログに記録することで、障害に対する耐性を提供します。システムクラッシュや停電が発生した場合、こうしたファイルシステムはより迅速にオンラインに戻り、データが破損する可能性が低くなります。ログ記録はファイルシステム内の専用領域で行われます。

ext3/4 はデータモードジャーナリングを提供しており、任意でメタデータに加えてデータもログに記録できます。データモードジャーナリングは書き込み操作を2回行うため (まずジャーナルに、次にディスクに)、速度面でペナルティがあります。そのため、データモードジャーナリングはデフォルトで有効化されていません。ファイルシステムの種類と機能を選ぶ際には、システム速度とデータ安全性とのトレードオフについて検討するべきでしょう。

同様に、Reiser4 は設定可能な[https://reiser4.wiki.kernel.org/index.php/Reiser4_transaction_models 「トランザクションモデル」]を提供しています。[https://reiser4.wiki.kernel.org/index.php/V4#Wandering_Logs wandering logs] と呼ばれる特殊なモデルは、ディスクへ2回書き込む必要がありません。'''write-anywhere''' モデルは、純粋なコピーオンライト方式です。'''hybrid''' と呼ばれる混合方式は、ヒューリスティックにこれら2つのモデルを切り替えます。

Reiser4、Btrfs、Bcachefs、ZFS といったコピーオンライト (別名 write-anywhere) ベースのファイルシステムは、設計上完全にアトミックに動作し、メタデータとインラインデータの両方に対してチェックサムを提供します (操作が不完全に行われることはありません。正常に動作しているハードウェア上では、不完全な操作によってデータが破損することはありません)。なので、これらのファイルシステムは、設計上、他のファイルシステムよりもデータ損失が発生しにくく、メタデータを保護するために従来のジャーナルを使用する必要がありません (メタデータが in-place に更新されることはないからです)。Btrfs は依然としてジャーナルのようなログツリーを使用していますが、fdatasync/fsync の高速化のために使用しているにすぎません。

FAT、exFAT、ext2、HFS はジャーナリングもアトミック性も提供していません。これらのファイルシステムは、一時的な使用あるいは古いシステムのためのものであり、信頼できるストレージが必要である場合に使用することは推奨されません。

=== FUSE ベースのファイルシステム ===

[[FUSE]] を見てください。

=== スタック可能なファイルシステム ===

* {{App|[[eCryptfs]]|Enterprise Cryptographic Filesystem は Linux 用のディスク暗号化ソフトウェアのパッケージです。これは POSIX 準拠のファイルシステムレベルの暗号化レイヤとして実装され、オペレーティングシステムレベルで GnuPG と同様の機能を提供することを目的としています。|https://ecryptfs.org|{{Pkg|ecryptfs-utils}}}}
* {{App|mergerfs|FUSE ベースの union ファイルシステムです。|https://github.com/trapexit/mergerfs|{{AUR|mergerfs}}}}
* {{App|mhddfs|FUSE ベースの union ファイルシステムである Multi-HDD FUSE ファイルシステム。|http://mhddfs.uvw.ru|{{AUR|mhddfs}}}}
* {{App|[[overlayfs]]|OverlayFS は Linux 用のファイルシステムサービスで、他のファイルシステムの union マウントを実装しています。|https://docs.kernel.org/filesystems/overlayfs.html|{{Pkg|linux}}}}
* {{App|unionfs-fuse|ユーザースペース Unionfs の実装。|https://github.com/rpodgorny/unionfs-fuse|{{AUR|unionfs-fuse}}}}

=== 読み取り専用のファイルシステム ===

* {{App|DwarFS|DwarFS は、Linux と Windows 用の高速で高圧縮率の読み取り専用ファイルシステムです。DwarFS は、多かれ少なかれ SquashFS と同じ機能をサポートしていますが、より圧縮に優れており、ハッシュアルゴリズムをカスタム可能です。|https://github.com/mhx/dwarfs|{{Aur|dwarfs}}}}
* {{App|[[Wikipedia:ja:EROFS|EROFS]]|Enhanced Read-Only File System は、パフォーマンスの向上とストレージ容量の圧縮を目的とした軽量の読み取り専用ファイルシステムです。|https://erofs.docs.kernel.org/|{{Pkg|erofs-utils}}}}
* {{App|[[Wikipedia:ja:SquashFS|SquashFS]]|SquashFS は、読み取り専用の圧縮ファイルシステムです。SquashFS はファイル、inodes、ディレクトリーを圧縮し、さらに大きな圧縮のために最大 1 MiB のブロック・サイズをサポートします。|https://github.com/plougher/squashfs-tools|{{Pkg|squashfs-tools}}}}

=== クラスタ化ファイルシステム ===

* {{App|[[BeeGFS]]|高パフォーマンスコンピューティングのために開発・最適化された並列ファイルシステム。|https://www.beegfs.io/c/|{{AUR|beegfs-client}}}}
* {{App|[[Ceph]]|優れたパフォーマンス、信頼性、拡張性を実現するように設計された、統合された分散ストレージシステム。|https://ceph.com/|{{AUR|ceph}}}}
* {{App|[[GlusterFS]]|数ペタバイトまで拡張可能なクラスタファイルシステム。|https://www.gluster.org/|{{Pkg|glusterfs}}}}
* {{App|[[IPFS]]|Web を高速化、安全化、およびオープン化するためのピアツーピアハイパーメディアプロトコル。IPFS は HTTP に取って代わり、私たち全員のためにより良いウェブを構築することを目指しています。ブロックを使用してファイルの一部を保存し、各ネットワーク・ノードは関心のあるコンテンツのみを保存し、重複除外、分散、拡張性の高いシステムをユーザーのみに制限 (現在はアルファ版)|https://ipfs.io/|{{Pkg|kubo}}}}
* {{App|[[MinIO]]|MinIO は高パフォーマンスな S3 互換のオブジェクトストレージを提供します。|https://min.io|{{Pkg|minio}}}}
* {{App|[[Wikipedia: MooseFS|MooseFS]]|MooseFS は、耐障害性で可用性が高い、高性能なスケールアウトネットワーク分散ファイルシステムです。|https://moosefs.com|{{Pkg|moosefs}}}}
* {{App|OpenAFS|AFS 分散ファイルシステムのオープンソース実装。|https://www.openafs.org|{{AUR|openafs}}}}
* {{App|[[Wikipedia: OrangeFS|OrangeFS]]|OrangeFS は、マルチサーバ・ベースのディスク・ストレージに透過的に並列アクセスするために設計されたスケール・アウト・ネットワーク・ファイル・システムです。並列および分散アプリケーション向けに最適化された MPI-IO のサポート。Linux クライアントだけでなく、Windows、Hadoop、WebDAV 用の並列ストレージの使用を簡素化します。POSIX 互換です。バージョン4.6以降のLinux カーネルに含まれます。|https://www.orangefs.org/}}
* {{App|Sheepdog|ボリュームおよびコンテナサービス用の分散オブジェクトストレージシステムで、ディスクとノードをインテリジェントに管理します。|https://sheepdog.github.io/sheepdog/|{{AUR|sheepdog}}}}
* {{App|[[Wikipedia:Tahoe-LAFS|Tahoe-LAFS]]|Tahoe Least-Authority File Store は、フリーでオープン、安全、分散、耐障害性、ピアツーピア分散データストアおよび分散ファイルシステムです。|https://tahoe-lafs.org/|{{AUR|tahoe-lafs}}{{Broken package link|package not found}}}}

=== 共有ディスクファイルシステム ===

* {{App|[[Wikipedia:GFS2|GFS2]]|GFS2 では、クラスタのすべてのメンバーが同じ共有ブロック・ストレージに直接同時にアクセスできます。|https://pagure.io/gfs2-utils|{{AUR|gfs2-utils}}}}
* {{App|[[Wikipedia:OCFS2|OCFS2]]|Oracle Cluster File System (バージョン2) は、Oracle Corporation によって開発され、GNU General Public License の下でリリースされる共有ディスク・ファイル・システムです。|https://oss.oracle.com/projects/ocfs2/|{{AUR|ocfs2-tools}}}}
* {{App|[[Wikipedia:VMware_VMFS|VMware VMFS]]|VMware の VMFS (Virtual Machine File System) は、同社の主力サーバ仮想化スイートである vSphere で使用されているファイルシステムです。|https://core.vmware.com/resource/vmware-vsphere-vmfs|{{AUR|vmfs-tools}}}}

== 既存のファイルシステムを特定する ==

[[lsblk]] を使って、既存のファイルシステムを特定することができます:

{{hc|1=$ lsblk -f|2=
NAME FSTYPE LABEL UUID MOUNTPOINT
sdb
└─sdb1 vfat Transcend 4A3C-A9E9
}}

存在する場合、既存のファイルシステムが {{ic|FSTYPE}} 列に表示されます。[[mount]] されている場合は、{{ic|MOUNTPOINT}} 列に表示されます。

== ファイルシステムを作成する ==

ファイルシステムは通常、[[LVM]]、[[RAID]]、[[dm-crypt]] などの論理コンテナ内、[[パーティション]]、通常のファイル ([[Wikipedia:Loop device]] を参照) に作成されます。このセクションでは、パーティションの場合について説明します。

{{Note|1=ファイルシステムはディスクに直接書き込むことができます (そのようなディスクは ''スーパーフロッピー'' または [[パーティショニング#パーティションレスディスク|パーティションレスディスク]] と呼ばれます)。この方法を取るといくつかの制限が発生します (特に、そのようなドライブから[[Arch ブートプロセス|起動する]]場合)。例については、[[Btrfs#パーティションレス Btrfs ディスク]] を参照してください。}}

{{Warning|
* 新しいファイルシステムを作成した後、このパーティション上に以前保存されていたデータを復元できる可能性はほとんどありません。'''保持したいデータのバックアップを作成してください'''。
* 特定のパーティションの目的により、ファイルシステムの選択が制限される場合があります。たとえば、 [[EFI システムパーティション]] には [[FAT32]] ファイルシステムが含まれている必要があり、 {{ic|/boot}} ディレクトリを含むファイルシステムは [[ブートローダー]] によってサポートされている必要があります。
}}

続行する前に、ファイルシステムを作成する[[lsblk|デバイスを特定]]し、それがマウントされているかどうかを[[lsblk|確認]]してください。例えば:

{{hc|$ lsblk -f|
NAME FSTYPE LABEL UUID MOUNTPOINT
sda
├─sda1 C4DA-2C4D
├─sda2 ext4 5b1564b2-2e2c-452c-bcfa-d1f572ae99f2 /mnt
└─sda3 56adc99b-a61e-46af-aab7-a6d07e504652
}}

先に進む前に、マウントされているファイルシステムを '''[[#ファイルシステムのアンマウント|アンマウント]]しなければなりません'''。上記の例では、既存のファイルシステムは {{ic|/dev/sda2}} にあり、 {{ic|/mnt}} にマウントされていますが、マウントを解除する必要があります:

# umount /dev/sda2

マウントされたばかりのファイルシステムを見つける方法は、[[#マウントしたファイルシステムの一覧表示]] を参照してください。

新しいファイルシステムを作成するには、{{man|8|mkfs}} を使用します。正確なタイプ、および特定のファイルシステムにインストールする可能性のあるユーザースペースユーティリティについては、 [[#ファイルシステムのタイプ]] を参照してください。

たとえば、 {{ic|/dev/sda1}} でタイプ [[ext4]] (Linux データパーティションで一般的に使われています) の新しいファイルシステムを作成するには、次のコマンドを実行します:

# mkfs.ext4 /dev/sda1

{{Tip|
* ''mkfs.ext4'' の {{ic|-L}} フラグを使用して、[[永続的なブロックデバイスの命名#by-label|ファイルシステムラベル]] を指定できます。''e2label'' を使用して、既存のファイルシステムのラベルを変更できます。
* ファイルシステムは、特定の制限付きで、作成後に「サイズ変更」できます。たとえば、 [[XFS]] ファイルシステムのサイズを増やすことはできますが、減らすことはできません。詳細については、 [[Wikipedia:ファイルシステムの比較#サイズ変更機能]] およびそれぞれのファイルシステムのドキュメントを参照してください。}}

これで、新しいファイルシステムを任意のディレクトリにマウントできます。

== ファイルシステムのマウント ==

デバイス(パーティションなど)上にあるファイルシステムを手動でディレクトリにマウントするには、{{man|8|mount}} を使用します。この例では {{ic|/dev/sda1}} を {{ic|/mnt}} にマウントしています。

# mount /dev/sda1 /mnt

これは {{ic|/dev/sda1}} 上のファイルシステムをディレクトリ {{ic|/mnt}} にアタッチし、ファイルシステムの内容を見えるようにするものです。この操作の前に {{ic|/mnt}} に存在していたデータは、デバイスがアンマウントされるまで不可視状態になります。

[[fstab]] には、デバイスが存在する場合に自動的にマウントされる方法に関する情報が含まれています。この動作を変更する方法の詳細については、[[fstab]] の記事を参照してください。

デバイスが {{ic|/etc/fstab}} で指定されていて、コマンドラインでデバイスかマウントポイントだけが指定された場合、その情報がマウント時に使用されます。例えば、{{ic|/etc/fstab}} に {{ic|/dev/sda1}} を {{ic|/mnt}} にマウントするという行がある場合、以下は自動的にその場所にデバイスをマウントすることになります。

# mount /dev/sda1

または、

# mount /mnt

''mount'' にはいくつかのオプションがあり、その多くは指定されたファイルシステムに依存します。
オプションは以下の方法で変更することができます:

* コマンドラインで ''mount'' と共にフラグを使用する
* [[fstab]] を編集する
* [[udev]] ルールを作成する
* [[Arch build system|カーネルを自分でコンパイルする]]
* ファイルシステム固有のマウントスクリプト ({{ic|/usr/bin/mount.*}} にあります) を使用する

より詳しい情報は、これらの関連記事と、興味のあるファイルシステムの記事をご覧下さい。

{{Tip|
* ファイルシステムは ''mount'' の代わりに ''systemd-mount'' でもマウントできます。マウントポイントが指定されていない場合、ファイルシステムは {{ic|/run/media/system/''device_identifier''/}} にマウントされます。これにより、ファイルシステムをどこにマウントするかを決めることなく、簡単にマウントすることができます。使い方や詳細は {{man|1|systemd-mount}} を参照してください。
* 一般ユーザーとしてファイルシステムをマウントする方法については、[[udisks#使用方法]] を見てください。これにより、root 権限や完全なグラフィック環境、udisks を使用するファイルマネージャを用いずにファイルシステムをマウントできるようになります。
}}

=== マウントしたファイルシステムの一覧表示 ===

マウントされている全てのファイルシステムを一覧表示するには {{man|8|findmnt}} を使ってください:

$ findmnt

''findmnt'' は様々な引数を取り、出力をフィルタリングしたり、追加情報を表示したりすることができます。例えば、デバイスやマウントポイントを引数として取り、指定されたものについての情報のみを表示させることができます:

$ findmnt /dev/sda1

''findmnt'' は {{ic|/etc/fstab}}, {{ic|/etc/mtab}}, {{ic|/proc/self/mounts}} から情報を収集します。

=== ファイルシステムのアンマウント ===

ファイルシステムをアンマウントするには {{man|8|umount}} を使ってください。ファイルシステムがあるデバイス (例:{{ic|/dev/sda1}}) かマウントポイント (例:{{ic|/mnt}}) のどちらかを指定することが可能です。

# umount /dev/sda1

または、

# umount /mnt

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

=== "linux Structure needs cleaning" ===

ファイルシステムを[[#ファイルシステムのアンマウント|アンマウント]]し、問題のあるボリュームで [[fsck]] を実行してください。

== 参照 ==

* {{man|5|filesystems}}
* {{man|1|systemd-mount}}
* [https://docs.kernel.org/filesystems/index.html Linux によってサポートされているファイルシステムのドキュメント]
* [[Wikipedia:File systems]]
* [[Wikipedia:Mount (Unix)]]

{{TranslationStatus|File systems|2025-04-11|831547}}

Tmpfs

2025-04-22T01:29:33Z

Kgx: /* サンプル */ 同期

{{Lowercase title}}
[[Category:ファイルシステム]]
[[en:Tmpfs]]
[[es:Tmpfs]]
[[ru:Tmpfs]]
[[Wikipedia:Tmpfs|tmpfs]] はメモリやスワップパーティションに存在する一時ファイルシステムです。ディレクトリを tmpfs としてマウントすることでファイルへのアクセスを高速化させたり、再起動時に自動的に中身が消去されるようにすることができます。

{{Tip|[[systemd]] を使っている場合、[[Systemd#systemd-tmpfiles - 一時ファイル|systemd-tmpfiles]] を使って tmpfs ディレクトリの一時ファイルを起動時に再作成することができます。}}

== 使用方法 ==

{{man|5|tmpfs}} が使われる主なディレクトリは [https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch03s18.html /tmp], [https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch05s09.html /var/lock], [https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch05s13.html /var/run] です。tmpfs を [https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch05s15.html /var/tmp] で使ってはいけません。このフォルダは、再起動しても消えない一時ファイルを置くところだからです。

{{Pkg|glibc}} 2.2 以上では tmpfs は [[wikipedia:ja:共有メモリ#UNIXでのサポート|POSIX shared memory]] の {{ic|/dev/shm}} にマウントされることになっています。{{ic|/dev/shm}} への tmpfs のマウントは [[systemd]] によって自動的に行われるため、[[fstab]] における手動設定は必要なくなりました。

Arch は tmpfs の {{ic|/run}} ディレクトリを使っており、{{ic|/var/run}} と {{ic|/var/lock}} は互換性維持のため単なるシンボリックリンクとして存在しています。また、systemd のデフォルト設定で {{ic|/tmp}} で使用されるため、特別な設定が必要ないかぎり [[fstab]] にエントリを記述する必要はありません。

一般的に、tmpfs フォルダを使う意味があるのは、読み書き操作を頻繁に実行するような I/O の処理が重い作業やプログラムです。アプリケーションによっては、部分的な (または全ての) データを共有メモリにオフロードすることで体感することができるほどの変化が現れることもあります。例えば、[[Firefox_Ramdisk|Firefox のプロファイルを RAM に再配置]]するとパフォーマンスが著しく上昇します。

== サンプル ==

デフォルトでは、tmpfs パーティションの最大容量は合計 RAM の半分に設定されていますが、この値はカスタマイズすることができます。

{{Note|実際に使用されるメモリ/スワップは使用する量によって変わり、必要とされるまで tmpfs パーティションはメモリを消費しないので注意してください。}}

最大容量を明示的に設定するために、以下の例ではデフォルトの {{ic|/tmp}} マウントを上書きして、{{ic|size}} マウントオプションを使っています:

{{hc|/etc/fstab|2=
tmpfs /tmp tmpfs rw,nodev,nosuid,size=2G 0 0}}

以下はユーザーに tmpfs マウントを追加する、より高度な例です。ウェブサイトや mysql の一時ファイル、{{ic|~/.vim/}} などで有用です。設定する前にマウントオプションをよく確かめて下さい。悪用を防止するためにできる限りセキュリティを高めるべきです。容量を制限したり、uid と gid のモードを指定すると良いでしょう。詳しくは、[[#参照]]セクションのリンクを見て下さい。

{{hc|/etc/fstab|2=
tmpfs /www/cache tmpfs rw,size=1G,nr_inodes=5k,noexec,nodev,nosuid,uid=''user'',gid=''group'',mode=1700 0 0}}

詳細は {{man|5|tmpfs}} man ページおよび [[セキュリティ#ファイルシステム]] に載っています。

変更を適用するには再起動してください。{{ic|mount -a}} と実行するだけで変更が即座に適用できるかに思われるかもしれませんが、これではディレクトリ内に存在する既存のファイルにアクセスできなくなってしまいます (特にロックファイルを使用するプログラムを実行している場合は危険です)。ただし、ディレクトリの中身が全て空なのであれば、再起動する代わりに {{ic|mount -a}} を実行しても問題ありません (もしくは個別にマウントを実行してもよい)。

変更の適用後、{{ic|findmnt}} を使って {{ic|/proc/mounts}} を見ることで効果が現れているかどうか確認することができます:

{{hc|$ findmnt /tmp|
TARGET SOURCE FSTYPE OPTIONS
/tmp tmpfs tmpfs rw,nosuid,nodev,relatime}}

また、tmpfs は再起動せずとも一時的にサイズを変更することが可能です。いますぐ巨大なコンパイルを行う必要があるときなどに有用です。その場合、以下を実行します:

# mount -o remount,size=4G,noatime /tmp

または RAM に基づいてサイズを変更する場合は:

# mount -o remount,size=80% /tmp

== 自動マウントの無効化 ==

[[systemd]] 下では、{{ic|/etc/fstab}} にエントリを記述してなくても {{ic|/tmp}} は自動的に tmpfs としてマウントされます。自動マウントを無効にするには、{{ic|tmp.mount}} systemd ユニットを[[マスク]]してください。

ファイルは tmpfs ではなく、ブロックデバイスに保存されるようになります。{{ic|/tmp}} の中身は再起動しても消去されないようになるので、問題が起こる可能性があります。前の挙動に戻して再起動で {{ic|/tmp}} フォルダが自動的に消去されるようにするには、以下の {{man|5|tmpfiles.d}} を使ってください:

{{hc|/etc/tmpfiles.d/tmp.conf|2=
# see tmpfiles.d(5)
# always enable /tmp folder cleaning
D! /tmp 1777 root root 0

# remove files in /var/tmp older than 10 days
D /var/tmp 1777 root root 10d

# namespace mountpoints (PrivateTmp=yes) are excluded from removal
x /tmp/systemd-private-*
x /var/tmp/systemd-private-*
X /tmp/systemd-private-*/tmp
X /var/tmp/systemd-private-*/tmp}}

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

=== root で tmpfs のシンボリックリンクを開けない ===

{{ic|/tmp}} は tmpfs を使っているので、カレントディレクトリを {{ic|/tmp}} に変更してから、ファイルを作成して、同じ {{ic|/tmp}} ディレクトリの中にファイルのシンボリックリンクを作成してみて下さい。シンボリックリンクを使って作成したファイルを開こうとすると、パーミッションエラーが表示されるはずです。{{ic|/tmp}} には [https://wiki.ubuntu.com/Security/Features#Symlink_restrictions スティッキービット] が設定されているためにこうなります。

この挙動は {{ic|/proc/sys/fs/protected_symlinks}} や sysctl で変更できます: {{ic|1=sysctl -w fs.protected_symlinks=0}}。設定を永続化させる方法は [[Sysctl#設定]] を見て下さい。

{{Warning|この挙動を変更するとセキュリティに問題が起こります。無闇に無効化しないでください。}}

== 参照 ==

* [https://www.kernel.org/doc/html/latest/filesystems/tmpfs.html Linux カーネルドキュメント]

Fstab

2025-04-22T01:27:01Z

Kgx: /* ヒントとテクニック */ 同期

{{Lowercase title}}
[[Category:ファイルシステム]]
[[Category:ブートプロセス]]
[[de:Fstab]]
[[en:Fstab]]
[[es:Fstab]]
[[fr:Fstab]]
[[it:Fstab]]
[[pt:Fstab]]
[[ru:Fstab]]
[[zh-hans:Fstab]]
{{Related articles start}}
{{Related|永続的なブロックデバイスの命名}}
{{Related|ファイルシステム}}
{{Related|tmpfs}}
{{Related|スワップ}}
{{Related|genfstab}}
{{Related articles end}}

{{man|5|fstab}} ファイルは、ディスクパーティションや様々なブロックデバイス、リモートファイルシステムをどうやってファイルシステムにマウントするかを記述します。

ファイルシステムは一行毎に記述されます。書かれている定義は、起動時やシステムマネージャの設定がリロードされたときに [[systemd]] の mount ユニットに動的に変換されます。デフォルトの設定では、マウントを必要とするサービスが起動する前にファイルシステムの [[fsck]] とマウントを自動的に実行します。例えば、[[NFS]] や [[Samba]] などのリモートファイルシステムはネットワークが立ち上がった後に systemd によって自動的にマウントされます。そのため、{{ic|/etc/fstab}} に指定するローカル・リモートファイルシステムのマウントに設定は必要ありません。詳しくは {{man|5|systemd.mount}} を見て下さい。

{{ic|mount}} コマンドはディレクトリやデバイスがひとつだけ指定された場合、他のパラメータの値を取得するために fstab を使います。このとき、fstab に記述されたマウントオプションも使われます。

== 使用法 ==

以下は、ファイルシステムの UUID を使用した {{ic|/etc/fstab}} の例です:

{{hc|/etc/fstab|2=
# <device> <dir> <type> <options> <dump> <fsck>
UUID=0a3407de-014b-458b-b5c1-848e92a327a3 / ext4 defaults 0 1
UUID=CBB6-24F2 /boot vfat defaults,nodev,nosuid,noexec,fmask=0177,dmask=0077 0 2
UUID=f9fe0b69-a280-415d-a03a-a32752370dee none swap defaults 0 0
UUID=b411dc99-f0a0-4c87-9e05-184977be8539 /home ext4 defaults 0 2
}}

* {{ic|<device>}} には、マウントされるべきブロック特殊デバイスやリモートファイルシステムを記述します。[[#ファイルシステムの識別]] を見てください。
* {{ic|<dir>}} には、[[マウント]]ディレクトリを記述します。
* {{ic|<type>}} [[ファイルシステム]]の種類。
* {{ic|<options>}} 関連するマウントオプション。{{man|8|mount|FILESYSTEM-INDEPENDENT MOUNT OPTIONS}} と {{man|5|ext4|Mount options for ext4}} を見てください。
* {{ic|<dump>}} は {{man|8|dump|url=https://linux.die.net/man/8/dump}} ユーティリティによってチェックされます。このフィールドは通常 {{ic|0}} にセットします。{{ic|0}} はチェックを無効化します。
* {{ic|<fsck>}} は、起動時にチェックするファイルシステムの順番を設定します。{{man|8|fsck}} を見てください。ルートファイルシステムには {{ic|1}} を設定するべきです。他のパーティションには {{ic|2}} を設定するか、チェックを無効化する {{ic|0}} を設定するべきです。

{{Tip|
* タイプ {{ic|auto}} は、使用されているファイルシステムの種類をマウントコマンドに推測させます。このオプションは、[[光学ディスクドライブ|光学メディア]] (CD/DVD/Blu-ray) の場合に便利です。
* ルートファイルシステムが [[btrfs]] か [[XFS]] の場合、fsck の順番は {{ic|1}} ではなく {{ic|0}} に設定するべきです。{{man|8|fsck.btrfs}} と {{man|8|fsck.xfs}} を見てください。
}}

スタートアップ時や、{{ic|noauto}} オプションが指定されていないデバイスに対して {{man|8|mount}} コマンドを {{ic|-a}} フラグ付きで実行した時に、{{ic|/etc/fstab}} 内で指定されたすべてのデバイスは自動的にマウントされます。リストにあるが存在しないデバイスは、{{ic|nofail}} オプションが使用されている場合を除き、エラーとなります。

詳細は {{man|5|fstab|DESCRIPTION}} を見てください。

== ファイルシステムの識別 ==

{{ic|/etc/fstab}} でファイルシステムを識別する方法がいくつか存在します: カーネルの名前記述子、ファイルシステムのラベルや UUID、GPT パーティションのラベルや UUID です。カーネルの名前記述子は使用すべきではありません。ラベルよりも UUID や PARTUUID を優先して使用すべきです。詳細は [[永続的なブロックデバイスの命名]] を見てください。この記事を読み進める前に、その記事を先に読むことをおすすめします。

このセクションでは、ファイルシステムをマウントするいくつかの方法を例を通して説明します。以下の例で使用されるコマンド {{ic|lsblk -f}} と {{ic|blkid}} の出力は、[[永続的なブロックデバイスの命名]] で見られます。

=== カーネルの名前記述子 ===

{{ic|lsblk -f}} を実行してパーティションの一覧を出力し、''NAME'' 列の値の前に {{ic|/dev/}} を付け加えてください。

{{hc|/etc/fstab|2=
# <device <dir> <type> <options> <dump> <fsck>
/dev/sda2 / ext4 defaults 0 1
/dev/sda1 /boot vfat defaults,nodev,nosuid,noexec,fmask=0177,dmask=0077 0 2
/dev/sda3 /home ext4 defaults 0 2
/dev/sda4 none swap defaults 0 0
}}

{{Warning|[[デバイスファイル#ブロックデバイスの名前|ブロックデバイスのカーネル名記述子]] は [[永続的なブロックデバイスの命名|永続的]] ではなく、ブートごとに変更される可能性があるため、設定ファイル ({{ic|/etc/fstab を含む}}) で使用しないでください。}}

=== ファイルシステムラベル ===

{{ic|lsblk -f}} を実行してパーティションの一覧を出力し、[[LABEL]] 列の値の前に {{ic|1=LABEL=}} を付け加えてください。あるいは、{{ic|blkid}} を実行し、LABEL の値を引用符無しで使ってください:

{{hc|/etc/fstab|2=
# <device> <dir> <type> <options> <dump> <fsck>
LABEL=System / ext4 defaults 0 1
LABEL=ESP /boot vfat defaults,nodev,nosuid,noexec,fmask=0177,dmask=0077 0 2
LABEL=Data /home ext4 defaults 0 2
LABEL=Swap none swap defaults 0 0
}}

{{Note|任意のフィールドにスペースが含まれる場合、[[#ファイルパスのスペース]] を見てください。}}

=== ファイルシステム UUID ===

{{ic|lsblk -f}} を実行してパーティションの一覧を出力し、[[UUID]] 列の値の前に {{ic|1=UUID=}} を付け加えてください。あるいは、{{ic|blkid}} を実行し、UUID の値を引用符無しで使ってください:

{{hc|/etc/fstab|2=
# <device> <dir> <type> <options> <dump> <fsck>
UUID=0a3407de-014b-458b-b5c1-848e92a327a3 / ext4 defaults 0 1
UUID=CBB6-24F2 /boot vfat defaults,nodev,nosuid,noexec,fmask=0177,dmask=0077 0 2
UUID=b411dc99-f0a0-4c87-9e05-184977be8539 /home ext4 defaults 0 2
UUID=f9fe0b69-a280-415d-a03a-a32752370dee none swap defaults 0 0
}}

=== GPT パーティションラベル ===

{{ic|blkid}} を実行してパーティションの一覧を出力し、[[PARTLABEL]] の値を引用符無しで使ってください:

{{hc|/etc/fstab|2=
# <device> <dir> <type> <options> <dump> <fsck>
PARTLABEL=GNU/Linux / ext4 defaults 0 1
PARTLABEL=EFI\040system\040partition /boot vfat defaults,nodev,nosuid,noexec,fmask=0177,dmask=0077 0 2
PARTLABEL=Home /home ext4 defaults 0 2
PARTLABEL=Swap none swap defaults 0 0
}}

{{Note|任意のフィールドにスペースが含まれる場合、[[#ファイルパスのスペース]] を見てください。}}

=== GPT パーティション UUID ===

{{ic|blkid}} を実行してパーティションの一覧を出力し、[[PARTUUID]] の値を引用符無しで使ってください:

{{hc|/etc/fstab|2=
# <device> <dir> <type> <options> <dump> <fsck>
PARTUUID=98a81274-10f7-40db-872a-03df048df366 / ext4 defaults 0 1
PARTUUID=d0d0d110-0a71-4ed6-936a-304969ea36af /boot vfat defaults,nodev,nosuid,noexec,fmask=0177,dmask=0077 0 2
PARTUUID=7280201c-fc5d-40f2-a9b2-466611d3d49e /home ext4 defaults 0 2
PARTUUID=039b6c1c-7553-4455-9537-1befbc9fbc5b none swap defaults 0 0
}}

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

=== systemd による自動マウント ===

systemd のすべてのマウントオプションは {{man|5|systemd.mount}} を見てください。

==== ローカルパーティション ====

巨大なパーティションが存在する場合、''fsck'' によってそのパーティションがチェックされている間に、そのパーティションに依存しないサービスを起動できるようにすると効率が良くなるかもしれません。パーティションの {{ic|/etc/fstab}} エントリに以下のオプションを追加することでそのように設定できます:

x-systemd.automount

そのパーティションに最初にアクセスしたときに fsck とマウントを行うようになり、パーティションの準備ができるまでカーネルがそのパーティションへのファイルアクセスを全てバッファします。
この方法は、巨大な {{ic|/home}} パーティションがある場合などに適用できます。
{{Note|この設定はファイルシステムのタイプを {{ic|autofs}} にします。これは [[mlocate]] によってデフォルトで無視されます。}}

==== リモートファイルシステム ====

同じ設定はリモートファイルシステムのマウントにも適用できます。アクセスしたときにだけリモートファイルシステムをマウントしたい場合、{{ic|x-systemd.automount}} パラメータを使って下さい。さらに、{{ic|1=x-systemd.mount-timeout=}} オプションを使うことで、マウントコマンドが完了するまでの制限時間を指定できます。また、{{ic|_netdev}} オプションで systemd がネットワークに依存するマウントであることを認識してネットワークがオンラインになった後に順番を入れ替えます。

x-systemd.automount,x-systemd.mount-timeout=30,_netdev

==== 暗号化ファイルシステム ====

キーファイルによって暗号化したファイルシステムがある場合も、{{ic|noauto}} パラメータを {{ic|/etc/crypttab}} の適当なエントリに追加することができます。設定することで ''systemd'' は起動時に暗号化デバイスを開かないようになり、実際にアクセスされたときになってから指定したキーファイルを使ってファイルシステムを開いてマウントします。デバイスが利用可能になるのを systemd が待機しないようになるので、暗号化 RAID デバイスなどを使っている場合、起動時間が数秒間短くなるかもしれません。例:

{{hc|/etc/crypttab|
data /dev/md/MyRAIDArray /etc/cryptsetup-keys.d/data.key noauto
}}

==== 自動アンマウント ====

{{ic|x-systemd.idle-timeout}} フラグを使うことで一定時間アイドル状態のときにタイムアウトするのを指定できます。例:

x-systemd.automount,x-systemd.idle-timeout=1min

上記の設定の場合、1分間操作がないと systemd によってアンマウントされます。

=== 外部デバイス ===

外部デバイスが存在する時はマウントし、存在しない場合は無視したい場合、{{ic|nofail}} オプションが必要です。これにより、起動時にエラーが発生するのを防ぐことができます。例えば:

{{hc|/etc/fstab|2=
LABEL=MyExternalDrive /media/backup jfs nofail,x-systemd.device-timeout=5 0 2
}}

{{ic|nofail}} オプションは {{ic|x-systemd.device-timeout}} オプションと組み合わせて使うのが最も効果的です。デフォルトのデバイスタイムアウトは 90 秒であるのが理由で、タイムアウトを再設定しなかった場合、{{ic|nofail}} だけが指定されている切断済みの外部デバイスのせいで起動時間が 90 秒長くなってしまいます。タイムアウトを 0 にはしないでください。0 は無限に待つことになります。

=== ファイルパスのスペース ===

{{ic|fstab}} ではスペースがフィールドの区切り文字として使用されているため、フィールド (''PARTLABEL''、''LABEL''、マウントポイント) にスペースが含まれている場合、これらのスペースをエスケープ文字 {{ic|\}} と3桁の8進数 {{ic|040}} に置き換えなければなりません:

{{hc|/etc/fstab|2=
UUID=47FA-4071 /home/username/Camera\040Pictures vfat defaults 0 0
LABEL=Storage\040drive /media/100\040GB\040(Storage) ext4 defaults,user 0 2
}}

=== atime オプション ===

以下は、ドライブのパフォーマンスに影響を与える可能性のあるアクセス時間オプションです。

* {{ic|strictatime}} オプションは、ファイルがアクセスされるたびにファイルのアクセス時間を更新します。これは、Linux がサーバーで使用される場合に特に有効です。デスクトップでの使用にはあまり価値がありません。{{ic|strictatime}} オプションの欠点は、ページキャッシュからファイルを読み取る(ドライブではなくメモリから読み取る)場合でも、書き込みが発生することです。
* {{ic|noatime}} オプションは、ファイルを読み取るたびにファイルアクセス時間をドライブに書き込むことを完全に無効にします。これは、最後に変更されてからファイルが読み取られたかどうかを知る必要があるアプリケーションを除き、ほぼすべてのアプリケーションでうまく機能します。このオプションが有効になっている場合、ファイルへの書き込み時間情報は、ファイルが書き込まれるたびに引き続き更新されます。
* {{ic|nodiratime}} オプションは、ディレクトリに対してのみファイルアクセス時間の書き込みを無効にし、他のファイルは引き続きアクセス時間が書き込まれます。{{Note|{{ic|noatime}} は {{ic|nodiratime}} を含みます。[https://lwn.net/Articles/244941/ 両方を指定する必要はありません。]}}
*{{ic|relatime}} は、以前のアクセス時間が現在の変更または変更時間よりも前の場合にのみアクセス時間を更新します。さらに、Linux 2.6.30以降、以前のアクセス時間が24時間以上前の場合、アクセス時間は常に更新されます。このオプションは、{{ic|defaults}} オプション、{{ic|atime}} オプション(カーネルのデフォルトである {{ic|relatime}} を使用することを意味します。{{man|8|mount}} および [[wikipedia:Stat (system call)#Criticism of atime]] を参照)またはオプションがまったく指定されていない場合に使用されます。

[[Mutt]] や、最後に変更されてからファイルが読み取られたかどうかを知る必要がある他のアプリケーションを使用する場合、{{ic|noatime}} オプションは使用しないでください。{{ic|relatime}} オプションを使用することは許容され、パフォーマンスの向上も提供します。

カーネル4.0以降、別の関連オプションがあります:

* {{ic|lazytime}} は、inode タイムスタンプ(アクセス、変更、作成時間)の変更をメモリ内でのみ保持することにより、ディスクへの書き込みを減らします。オンディスクタイムスタンプは、(1)ファイルタイムスタンプに関係のない変更のためにファイルinodeを更新する必要がある場合、(2)ディスクへの同期が発生した場合、(3)削除されていない inode がメモリから削除された場合、または(4)メモリ内コピーが最後にディスクに書き込まれてから24時間以上経過した場合にのみ更新されます。
: {{Warning|システムがクラッシュした場合、ディスク上のアクセス時間や最終変更日時は最大で24時間ずれる可能性があります。}}

{{ic|lazytime}} オプションは、前述の {{ic|*atime}} オプションと "組み合わせて" 機能し、代替として機能しないことに注意してください。つまり、デフォルトでは {{ic|relatime}} ですが、プレーンな {{ic|relatime}} オプションと同じかそれ以下のディスク書き込みコストで {{ic|strictatime}} にすることもできます。

=== ルートパーティションの再マウント ===

何らかの理由で誤ってルートパーティションを読み込み専用でマウントしてしまった場合は、次のコマンドでルートパーティションを再マウントしてください:

# mount -o remount,rw /

=== GPT パーティションの自動マウント ===

UEFI/GPT を使用している場合、[https://uapi-group.org/specifications/specs/discoverable_partitions_specification/ Discoverable Partitions Specification] に従ってパーティショニングすることで、特定のパーティションを {{ic|/etc/fstab}} から省略することができ、{{man|8|systemd-gpt-auto-generator}} を使ってそのパーティションをマウントすることができます。[[systemd#GPT パーティションの自動マウント]] を見てください。

ルートボリュームのカスタムマウントオプションを指定するには、{{ic|/dev/gpt-auto-root}} をデバイス名として使用します:

{{hc|/etc/fstab|2=
/dev/gpt-auto-root / ext4 defaults,noatime 0 1
}}

=== バインドマウント ===

{{ic|bind}} オプションにより、ディレクトリをリンクさせることができます:

{{hc|/etc/fstab|2=
# <device> <dir> <type> <options> <dump> <fsck>
UUID=94649E22649E06E0 /media/user/OS/ ntfs defaults,rw,errors=remount-ro 0 0
/media/user/OS/Users/user/Music/ /home/user/Music/ none defaults,bind 0 0
/media/user/OS/Users/user/Pictures/ /home/user/Pictures/ none defaults,bind 0 0
/media/user/OS/Users/user/Videos/ /home/user/Videos/ none defaults,bind 0 0
/media/user/OS/Users/user/Downloads/ /home/user/Downloads/ none defaults,bind 0 0
/media/user/OS/Users/user/Documents/ /home/user/Documents/ none defaults,bind 0 0
/media/user/OS/Users/user/projects/ /home/user/projects/windows/ none defaults,bind 0 0
}}

詳細は {{man|8|mount|Bind mount operation}} を見てください。

=== genfstab を使用して fstab を自動的に生成する ===

''genfstab'' ツールを使用して fstab ファイルを作成できます。詳細については、[[genfstab]] を参照してください。

=== GUI ユーティリティ ===

以下は、マウントポイントを変更する際に用いることのできるプログラムのリストです。Fstab で利用できる機能のうち一部は実装されていないかもしれませんが、最も利用される機能はすべて実装されており、作業がうんと楽になるかもしれません:

* {{App|[[wikipedia:GNOME Disks|GNOME Disks]]|ストレージデバイスを管理するための GNOME ユーティリティ。|https://apps.gnome.org/DiskUtility/|{{Pkg|gnome-disk-utility}}}}
* {{App|KDE Partition Manager|コンピュータ上のディスク、パーティション、ファイルシステムの管理を補助するユーティリティ。|https://apps.kde.org/partitionmanager/|{{Pkg|partitionmanager}}}}

=== ユーザーのパーミッションと所有者を変更する ===

あるドライブのマウントをすべてのユーザーに許可したい場合、以下のマウントポイントオプションを fstab エントリに追加することを検討してください。

{{Note|これは、ファイルのパーミッション機能が無いファイルシステムに対しても用いられます。この場合、ドライブ全体の所有者とパーミッションは、そのドライブをマウントしたユーザーに設定されます。}}

* {{ic|users}} - 全てのユーザーは、(たとえ他の通常ユーザーがそのドライブをマウントしていたとしても) 対象のファイルシステムをマウント/アンマウントできるようになります。このオプションは、noexec、nosuid、nodev オプションも暗黙的に設定します (ただし、後続のオプションによって上書きされない限り。例えば、users,exec,dev,suid)。これを有効化するには {{ic|users}} をマウントオプションに追加してください。
* {{ic|user}} - 任意の通常ユーザーに対象のファイルシステムのマウントを許可します。ただし、同じユーザーしかそのファイルシステムをアンマウントできません。このオプションは、noexec、nosuid、nodev オプションも暗黙的に設定します (ただし、後続のオプションによって上書きされない限り。例えば、users,exec,dev,suid)。これを有効化するには {{ic|user}} をマウントオプションに追加してください。

FAT や exFAT のようにファイルのパーミッションが実装されていないファイルシステムの場合は、ドライブ全体及び保存されているファイルに対してユーザーとグループを明示的に設定することができます。特定のユーザーの ID は {{ic|/etc/passwd}} で調べられます。UID は passwd エントリの3番目、GID は4番目です。

* {{ic|uid}} - ドライブの所有者 ID を設定します
* {{ic|gid}} - ドライブのグループ ID を設定します

Ext4 や brtfs などパーミッション機能を持つファイルシステムの場合は、(ドライブをマウントしたユーザー以外の) 他のユーザーはドライブにアクセスできないかもしれません。{{ic|/path/to/drive/}} のパーみションを確認し、必要に応じてパーミッションを変更してください。

=== 変更を検証する ===

{{ic|findmnt --verify --verbose}} コマンドを使用して、fstab ファイル内の構文エラーや無効なオプションがないかを確認します。

== 参照 ==

* [https://docs.kernel.org/admin-guide/devices.html ブロックデバイスを含むデバイスリスト]
* [https://refspecs.linuxfoundation.org/FHS_3.0/fhs/index.html Filesystem Hierarchy Standard]
* [https://www.askapache.com/optimize/super-speed-secrets/ TMPFS を使ってキャッシュとサイト速度を30倍に高速化]

{{TranslationStatus|Fstab|2024-05-29|809165}}