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

Wayland

2022-03-07T22:31:50Z

Funcrab: /* Qt */ 環境変数 QT_QPA_PLATFORM="wayland;xcb" の引用元URLを追加

[[Category:グラフィカルユーザーインターフェイス]]
[[es:Wayland]]
[[en:Wayland]]
[[fr:Wayland]]
[[pt:Wayland]]
[[ru:Wayland]]
[[zh-hans:Wayland]]
{{Related articles start}}
{{Related|Kernel Mode Setting}}
{{Related|Xorg}}
{{Related|スクリーンショットの取得#Wayland}}
{{Related articles end}}

[https://wayland.freedesktop.org/ Wayland] はディスプレイサーバープロトコルです。[[Xorg|X Window System]] の後継となることを目指しています。[[Wikipedia:Wayland_(display_server_protocol)#Differences_between_Wayland_and_X|Wikipedia に Wayland と Xorg の比較]] が掲載されています。

Wayland プロトコルを使用するディスプレイサーバは、[[Wikipedia:ja:コンポジット型ウィンドウマネージャ|コンポジット型ウィンドウマネージャ]] としても機能するため、'''コンポジタ''' と呼ばれます。以下に[[#コンポジタ|Wayland コンポジタのリスト]]を示します。

レガシーな [[X11]] アプリケーションをシームレスに動かすための後方互換性として、[[#XWayland|XWayland]] を使うことができます。これは Wayland に X サーバを提供します。

== 要件 ==
ほとんどの Wayland コンポジタは [[KMS]] を利用しているシステムで動作します。

また、Wayland はただのライブラリなので、それだけでは使い物になりません。X サーバーを置き換えるには、([[Weston]] や [[Sway]] などの) コンポジタあるいは ([[GNOME]] や [[KDE]] など) デスクトップ環境が必要です。

GPU ドライバーと Wayland コンポジタは同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: [[Wikipedia:Generic Buffer Management|GBM]] と [https://www.phoronix.com/scan.php?page=news_item&px=XDC2016-Device-Memory-API EGLStreams] です。

{| class="wikitable"
|-
! バッファ API !! GPU ドライバーのサポート !! Wayland コンポジタのサポート
|-
| GBM || [[NVIDIA]] < 495* 以外の全てのドライバー || 全てのコンポジタ
|-
| EGLStreams || [[NVIDIA]] || [[GNOME]], [[KDE]] [[Weston#EGLstream_support_(for_proprietary_Nvidia_Driver)|Weston]] (with a third-party patch)
|-
|}

: *: Nvidia >= 495 は EGLStreams と GBM[https://www.phoronix.com/scan.php?page=news_item&px=NVIDIA-495.44-Linux-Driver] の両方をサポートします。

== コンポジタ ==

タイル型とスタック型の違いは、[[ウィンドウマネージャ#種類]]を参照してください。

=== タイル型 ===

* {{App|[[Cagebreak]]|cage をベースに、[[ratpoison]] にインスパイアされています。|https://github.com/project-repo/cagebreak|{{AUR|cagebreak}} {{AUR|cagebreak-bin}}}}
* {{App|Cardboard|スクロールコンポジタ。wlroots をベースに、PaperWM にインスパイアされています。|https://gitlab.com/cardboardwm/cardboard|{{AUR|cardboard-git}}}}
* {{App|dwl|wlroots ベースの [[dwm]] ライクな Wayland コンポジタ。|https://github.com/djpohly/dwl|{{AUR|dwl}}}}
* {{App|japokwm|wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。|https://github.com/werererer/japokwm|{{AUR|japokwm-git}}}}
* {{App|[[Qtile]]|Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。|https://github.com/qtile/qtile|{{Pkg|qtile}}}}
* {{App|river|dwm [[bspwm]] にインスパイアされた動的なタイル型 Wayland コンポジタ。|https://github.com/ifreund/river|{{AUR|river-git}}}}
* {{App|[[Sway]]|wlroots ベースの [[i3]] 互換 Wayland コンポジタ。|https://github.com/swaywm/sway|{{Pkg|sway}}}}
* {{App|[[Velox]]|swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。|https://github.com/michaelforney/velox|{{AUR|velox}}}}
* {{App|waymonad|[[Haskell]] で書かれた xmonad にインスパイアされた Wayland コンジタ。|https://github.com/waymonad/waymonad}}
* {{App|newm|ラップトップとタッチパッドを念頭に置いて作成された Wayland コンポジタ|https://github.com/jbuchermn/newm/|{{AUR|newm-git}}}}

=== スタック型 ===

* {{App|[[Enlightenment]]|[[Enlightenment#Enlightenment を手動で起動する]] を参照してください。詳細: [https://git.enlightenment.org/core/enlightenment.git/tree/README] [https://www.enlightenment.org/about-wayland]|https://www.enlightenment.org/|{{Pkg|enlightenment}}}}
* {{App|Greenfield|Web ブラウザーで実行され、リモートアプリケーションを表示できます。|https://greenfield.app/}}
* {{App|Grefsen|最小限のデスクトップ環境を提供する Qt/Wayland コンポジタ。|https://github.com/ec1oud/grefsen}}
* {{App|hikari|FreeBSD で活発に開発されている [[cwm]] にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしている。|https://hikari.acmelabs.space/|{{AUR|hikari}}}}
* {{App|KDE [[w:KWin|KWin]]|[[KDE#Starting Plasma]] を参照。|https://userbase.kde.org/KWin|{{Pkg|kwin}}}}
* {{App|Liri Shell|[[Liri]] の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。|https://github.com/lirios/shell|{{AUR|liri-shell-git}}}}
* {{App|labwc|Openbox にインスパイアされた wlroots ベースのコンポジタ。|https://github.com/johanmalm/labwc|{{AUR|labwc-git}}}}
* {{App|[[w:Mutter (software)|Mutter]]|[[GNOME#Starting]] を参照してください。|https://gitlab.gnome.org/GNOME/mutter|{{Pkg|mutter}}}}
* {{App|wayfire|[[Compiz]] にインスパイアされ、wlroots に基づく 3D コンポジタ。|https://wayfire.org/|{{AUR|wayfire}}}}
* {{App|[[Weston]]|Wayland コンポジタのリファレンス実装。|https://gitlab.freedesktop.org/wayland/weston|{{Pkg|weston}}}}
* {{App|wio|Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。|https://wio-project.org/}}

=== その他 ===

* {{App|Cage|キオスクのような単一のフルスクリーンアプリケーションを表示します。 |https://www.hjdskes.nl/projects/cage/|{{Pkg|cage}}}}
* {{App|Maze Compositor|Qt を使用して 3D 迷路ウィンドウをレンダリングします。|https://github.com/imbavirus/mazecompositor}}
* {{App|Motorcar|バーチャルリアリティを使用して 3D ウィンドウを探索する Wayland コンポジタ。|https://github.com/evil0sheep/motorcar}}

上記のいくつかは [[ディスプレイマネージャ]] をサポートする場合があります。
それらがどのように開始されるかを {{ic|/usr/share/wayland-sessions/''compositor''.desktop}} を見て確認してください。

== ディスプレイマネージャ ==

Wayland コンポジタの実行をサポートした[[ディスプレイマネージャ]]は以下の表の通りです。種類の列にはディスプレイマネージャが Wayland 上での実行をサポートしているかどうかが示されています。

{| class="wikitable sortable"
! 名前
! 種類
! 説明
|-
| [[GDM]]
| Wayland/X11 上で動作
| [[GNOME]] ディスプレイマネージャ。
|-
| {{AUR|greetd}}
| ログインデーモン
| 最小でありながら柔軟なログインデーモン。
|-
| [[LightDM]]
| Wayland/X11 上で動作 [https://github.com/CanonicalLtd/lightdm/commit/f4f681f7b4209a634b021ba731addec1e081e5c7]
| 様々なデスクトップに対応したディスプレイマネージャ。
|-
| {{AUR|Ly}}
| コンソール上で動作
| TUI ディスプレイマネージャ。
|-
| [[SDDM]]
| X11 上で動作 [https://github.com/sddm/sddm/pull/616]
| QML ベースのディスプレイマネージャ。
|-
| {{AUR|tbsm}}
| コンソール上で動作
| bash のみに依存するシンプルな CLI セッションランチャー。
|}

== GUI ライブラリ ==
[https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] も参照してください。

=== GTK ===

{{pkg|gtk3}} と {{pkg|gtk4}} パッケージは Wayland バックエンドが有効になっています。

Wayland と X 両方のバックエンドが有効になっているとき、GTK+ ではデフォルトで Wayland バックエンドを使いますが、{{ic|GDK_BACKEND=x11}} 環境変数を設定することで Xwayland を使うように上書きできます。

=== Qt ===

[[Qt]] 5 または 6 は Wayland をサポートしています。{{Pkg|qt5-wayland}} または {{Pkg|qt6-wayland}} パッケージをインストールしてください。

Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、[[環境変数]] {{ic|1=QT_QPA_PLATFORM=wayland}} をセットして下さい。一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} とセットします。
これは、{{AUR|zoom}} など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。
また、{{ic|1=QT_QPA_PLATFORM="wayland;xcb"}} を使用すると、QtがWaylandが利用できない場合、代わりにxcb (X11)プラグインを使用させることができます。[https://www.qt.io/blog/2018/05/29/whats-new-in-qt-5-11-for-the-wayland-platform-plugin]

[[sway]] などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、 [https://keepassxc.org KeepassXC] はトレイに最小化できません。これは、アプリケーションを実行する前に {{Pkg|qt5ct}} をインストールし、 {{ic|1=QT_QPA_PLATFORMTHEME=qt5ct}} を設定することで解決できます。

===Clutter===

Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。

Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|CLUTTER_BACKEND=wayland}} を設定する必要があります。

===SDL2 ===

SDL2 アプリケーションを Wayland 上で動作させるには、環境変数 {{ic|SDL_VIDEODRIVER=wayland}} を設定します。

{{Note|Wayland 未対応の古い SDL が内部に含まれたゲームでは、{{ic|1=SDL_VIDEODRIVER=wayland}} を指定すると動作が壊れる場合があります。アプリケーションを XWayland で強制的に実行するには、{{ic|1=SDL_VIDEODRIVER=x11}} を設定します。}}

=== GLFW ===

GLFW で Wayland バックエンドを使用するには、({{Pkg|glfw-x11}} の代わりに) {{Pkg|glfw-wayland}} パッケージをインストールしてください。

=== GLEW ===

{{AUR|glew-wayland}} パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で {{Pkg|glew}} を使うことです。{{Bug|62713}} を参照してください。

===EFL===

EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。

=== winit ===

[https://github.com/rust-windowing/winit Winit] は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、明示的に設定することもできます。{{ic|WINIT_UNIX_BACKEND}} 環境変数の値を {{ic|x11}} や {{ic|wayland}} としてください。

=== Electron ===

{{Pkg|electron}} ベースのアプリケーションを Wayland でネイティブに使用するには、{{ic|${XDG_CONFIG_HOME}/electron-flags.conf}} を作成または編集して、次のオプションを追加します。

{{hc|1=~/.config/electron-flags.conf|2=
--enable-features=UseOzonePlatform
--ozone-platform=wayland
}}

古いバージョンの electron には独自の {{ic|electron-flags.conf}} ファイルが必要であることに注意してください。''electron12'' パッケージがインストールされている場合は、次のようにします。

$ ln -s electron-flags.conf ~/.config/electron12-flags.conf

{{ic|${XDG_CONFIG_HOME} }} 内にコピーしてください、または、異なる {{Pkg|electron}} バージョンで異なるランタイムオプションを使用したい場合は、別の {{ic|${XDG_CONFIG_HOME}/electron12-flags.conf}} ファイルを使用する必要があります。

{{Tip|Electron-flags をグローバルに上書きする代わりに、[[デスクトップエントリ]] を変更するとよいでしょう。}}

== XWayland ==

[https://wayland.freedesktop.org/xserver.html XWayland] は、Wayland の下で実行される X サーバーです。レガシー [[X11]] アプリケーションに下位互換性を提供します。

これを使用するには、{{Pkg|xorg-xwayland}} パッケージを [[インストール]] します。

XWaylandはコンポジターを介して開始されるため、選択したコンポジターを使用して、XWayland の互換性と XWayland の開始方法の説明を確認して下さい。

{{Note|セキュリティについて: XWayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。
}}

=== NVIDIA ドライバ ===

{{Note|バージョン 470 より前の Nvidia ドライバ(例: {{aur|nvidia-390xx-dkms}}) はハードウェアアクセラレーションされた XWayland をサポートしておらず、Wayland 以外のアプリケーションで Wayland セッションのパフォーマンスが低下します。}}

なお、[[NVIDIA#DRM kernel mode setting|DRM KMS]] を有効にする必要があります。また、お使いのディスプレイマネージャ(例: [[GDM#Wayland と独自の NVIDIA ドライバ|GDM]])の[https://us.download.nvidia.com/XFree86/Linux-x86_64/470.42.01/README/xwayland.html 公式ドキュメント]に記載されている情報も見てください。

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

=== Xwayland アプリケーションであることを視認する ===

アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、{{AUR|extramaus}} を使用します。
アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。

または、{{pkg|xorg-xeyes}} を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。

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

=== 色補正 ===

[[バックライト#色補正]]を参照。

=== 動作が遅い、表示がおかしい、クラッシュする ===

Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} などの rc ファイルから該当箇所を削除してみてください。

=== Electron ベースのアプリケーションでは、ディスプレイ::0を開けません ===

GDK_BACKEND = wayland を設定していないことを確認してください。グローバルに設定すると、 Electron アプリが機能しなくなります。

=== リモートディスプレイ ===

いくつか選択肢が考えられます:
* [[Sway]] など {{Pkg|wlroots}} ベースのコンポジタでは {{AUR|wayvnc}} VNC サーバーが利用できます。
* [[Weston]] には RDP バックエンドが含まれています。{{man|7|weston-rdp}} を参照してください。
* {{Pkg|mutter}} ベースの場合は {{Pkg|gnome-remote-desktop}} が使えます。[https://wiki.gnome.org/Projects/Mutter/RemoteDesktop 公式サイト] を参照してください。
* {{AUR|waypipe}} や {{AUR|waypipe-git}} は Wayland アプリケーションの透過プロキシです。[[SSH]] を組み合わせることで外部から操作できます。詳細は[https://gitlab.freedesktop.org/mstoeckl/waypipe 公式サイト]を参照してください。

=== ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力 ===

Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。

入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:
* ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
* マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。

Wayland と XWayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。X上で動作するアプリケーションの場合、対応は不要です。

関連する拡張:
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml XWayland keyboard grabbing protocol] (XWayland のサポートは xorg-server 1.20 開発ツリーに追加されています [https://lists.x.org/archives/xorg-devel/2017-August/054231.html])
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol]
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/relative-pointer/relative-pointer-unstable-v1.xml Relative pointer protocol]
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml Pointer constraints protocol]

サポートしている Wayland コンポジタ:
* Mutter, [[GNOME]] のコンポジタ ([https://bugzilla.gnome.org/show_bug.cgi?id=783342 リリース 3.28] 以上)。
* {{Pkg|wlroots}} (Relative pointer protocols と Pointer constraints protocol に対応)

サポートしているウィジェットツールキット:
* GTK (リリース 3.22.18 以上)。

=== GTK テーマが動かない ===

https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland を参照してください。

==参照==

* [https://wayland.freedesktop.org/docs/html/ Wayland オンラインドキュメント]
* [https://gitlab.freedesktop.org/wayland Official Wayland Git Repo]
* [[Fedora:How to debug Wayland problems|Fedora Wiki の Wayland のデバッグに関する記事]]
* [https://arewewaylandyet.com/ Are we Wayland yet?]
* [https://awesomeopensource.com/projects/wayland Awesome Wayland projects]
* [[カーソルテーマ]]
* [https://bbs.archlinux.org/viewtopic.php?id=107499 Arch Linux forum discussion]
* [https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives i3 Migration Guide - Common X11 apps used on i3 with Wayland alternatives]
* [https://wayland.app/protocols/ Wayland Explorer - A better way to read Wayland documentation]

{{TranslationStatus|Wayland|2021-11-09|700011}}

Wayland

2022-03-07T22:27:11Z

Funcrab: /* Qt */ waylandプラグインが使えない時にxcb(X11)を使用するようにフォールバックする変数「QT_QPA_PLATFORM="wayland;xcb"」の記述を追加

[[Category:グラフィカルユーザーインターフェイス]]
[[es:Wayland]]
[[en:Wayland]]
[[fr:Wayland]]
[[pt:Wayland]]
[[ru:Wayland]]
[[zh-hans:Wayland]]
{{Related articles start}}
{{Related|Kernel Mode Setting}}
{{Related|Xorg}}
{{Related|スクリーンショットの取得#Wayland}}
{{Related articles end}}

[https://wayland.freedesktop.org/ Wayland] はディスプレイサーバープロトコルです。[[Xorg|X Window System]] の後継となることを目指しています。[[Wikipedia:Wayland_(display_server_protocol)#Differences_between_Wayland_and_X|Wikipedia に Wayland と Xorg の比較]] が掲載されています。

Wayland プロトコルを使用するディスプレイサーバは、[[Wikipedia:ja:コンポジット型ウィンドウマネージャ|コンポジット型ウィンドウマネージャ]] としても機能するため、'''コンポジタ''' と呼ばれます。以下に[[#コンポジタ|Wayland コンポジタのリスト]]を示します。

レガシーな [[X11]] アプリケーションをシームレスに動かすための後方互換性として、[[#XWayland|XWayland]] を使うことができます。これは Wayland に X サーバを提供します。

== 要件 ==
ほとんどの Wayland コンポジタは [[KMS]] を利用しているシステムで動作します。

また、Wayland はただのライブラリなので、それだけでは使い物になりません。X サーバーを置き換えるには、([[Weston]] や [[Sway]] などの) コンポジタあるいは ([[GNOME]] や [[KDE]] など) デスクトップ環境が必要です。

GPU ドライバーと Wayland コンポジタは同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: [[Wikipedia:Generic Buffer Management|GBM]] と [https://www.phoronix.com/scan.php?page=news_item&px=XDC2016-Device-Memory-API EGLStreams] です。

{| class="wikitable"
|-
! バッファ API !! GPU ドライバーのサポート !! Wayland コンポジタのサポート
|-
| GBM || [[NVIDIA]] < 495* 以外の全てのドライバー || 全てのコンポジタ
|-
| EGLStreams || [[NVIDIA]] || [[GNOME]], [[KDE]] [[Weston#EGLstream_support_(for_proprietary_Nvidia_Driver)|Weston]] (with a third-party patch)
|-
|}

: *: Nvidia >= 495 は EGLStreams と GBM[https://www.phoronix.com/scan.php?page=news_item&px=NVIDIA-495.44-Linux-Driver] の両方をサポートします。

== コンポジタ ==

タイル型とスタック型の違いは、[[ウィンドウマネージャ#種類]]を参照してください。

=== タイル型 ===

* {{App|[[Cagebreak]]|cage をベースに、[[ratpoison]] にインスパイアされています。|https://github.com/project-repo/cagebreak|{{AUR|cagebreak}} {{AUR|cagebreak-bin}}}}
* {{App|Cardboard|スクロールコンポジタ。wlroots をベースに、PaperWM にインスパイアされています。|https://gitlab.com/cardboardwm/cardboard|{{AUR|cardboard-git}}}}
* {{App|dwl|wlroots ベースの [[dwm]] ライクな Wayland コンポジタ。|https://github.com/djpohly/dwl|{{AUR|dwl}}}}
* {{App|japokwm|wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。|https://github.com/werererer/japokwm|{{AUR|japokwm-git}}}}
* {{App|[[Qtile]]|Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。|https://github.com/qtile/qtile|{{Pkg|qtile}}}}
* {{App|river|dwm [[bspwm]] にインスパイアされた動的なタイル型 Wayland コンポジタ。|https://github.com/ifreund/river|{{AUR|river-git}}}}
* {{App|[[Sway]]|wlroots ベースの [[i3]] 互換 Wayland コンポジタ。|https://github.com/swaywm/sway|{{Pkg|sway}}}}
* {{App|[[Velox]]|swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。|https://github.com/michaelforney/velox|{{AUR|velox}}}}
* {{App|waymonad|[[Haskell]] で書かれた xmonad にインスパイアされた Wayland コンジタ。|https://github.com/waymonad/waymonad}}
* {{App|newm|ラップトップとタッチパッドを念頭に置いて作成された Wayland コンポジタ|https://github.com/jbuchermn/newm/|{{AUR|newm-git}}}}

=== スタック型 ===

* {{App|[[Enlightenment]]|[[Enlightenment#Enlightenment を手動で起動する]] を参照してください。詳細: [https://git.enlightenment.org/core/enlightenment.git/tree/README] [https://www.enlightenment.org/about-wayland]|https://www.enlightenment.org/|{{Pkg|enlightenment}}}}
* {{App|Greenfield|Web ブラウザーで実行され、リモートアプリケーションを表示できます。|https://greenfield.app/}}
* {{App|Grefsen|最小限のデスクトップ環境を提供する Qt/Wayland コンポジタ。|https://github.com/ec1oud/grefsen}}
* {{App|hikari|FreeBSD で活発に開発されている [[cwm]] にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしている。|https://hikari.acmelabs.space/|{{AUR|hikari}}}}
* {{App|KDE [[w:KWin|KWin]]|[[KDE#Starting Plasma]] を参照。|https://userbase.kde.org/KWin|{{Pkg|kwin}}}}
* {{App|Liri Shell|[[Liri]] の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。|https://github.com/lirios/shell|{{AUR|liri-shell-git}}}}
* {{App|labwc|Openbox にインスパイアされた wlroots ベースのコンポジタ。|https://github.com/johanmalm/labwc|{{AUR|labwc-git}}}}
* {{App|[[w:Mutter (software)|Mutter]]|[[GNOME#Starting]] を参照してください。|https://gitlab.gnome.org/GNOME/mutter|{{Pkg|mutter}}}}
* {{App|wayfire|[[Compiz]] にインスパイアされ、wlroots に基づく 3D コンポジタ。|https://wayfire.org/|{{AUR|wayfire}}}}
* {{App|[[Weston]]|Wayland コンポジタのリファレンス実装。|https://gitlab.freedesktop.org/wayland/weston|{{Pkg|weston}}}}
* {{App|wio|Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。|https://wio-project.org/}}

=== その他 ===

* {{App|Cage|キオスクのような単一のフルスクリーンアプリケーションを表示します。 |https://www.hjdskes.nl/projects/cage/|{{Pkg|cage}}}}
* {{App|Maze Compositor|Qt を使用して 3D 迷路ウィンドウをレンダリングします。|https://github.com/imbavirus/mazecompositor}}
* {{App|Motorcar|バーチャルリアリティを使用して 3D ウィンドウを探索する Wayland コンポジタ。|https://github.com/evil0sheep/motorcar}}

上記のいくつかは [[ディスプレイマネージャ]] をサポートする場合があります。
それらがどのように開始されるかを {{ic|/usr/share/wayland-sessions/''compositor''.desktop}} を見て確認してください。

== ディスプレイマネージャ ==

Wayland コンポジタの実行をサポートした[[ディスプレイマネージャ]]は以下の表の通りです。種類の列にはディスプレイマネージャが Wayland 上での実行をサポートしているかどうかが示されています。

{| class="wikitable sortable"
! 名前
! 種類
! 説明
|-
| [[GDM]]
| Wayland/X11 上で動作
| [[GNOME]] ディスプレイマネージャ。
|-
| {{AUR|greetd}}
| ログインデーモン
| 最小でありながら柔軟なログインデーモン。
|-
| [[LightDM]]
| Wayland/X11 上で動作 [https://github.com/CanonicalLtd/lightdm/commit/f4f681f7b4209a634b021ba731addec1e081e5c7]
| 様々なデスクトップに対応したディスプレイマネージャ。
|-
| {{AUR|Ly}}
| コンソール上で動作
| TUI ディスプレイマネージャ。
|-
| [[SDDM]]
| X11 上で動作 [https://github.com/sddm/sddm/pull/616]
| QML ベースのディスプレイマネージャ。
|-
| {{AUR|tbsm}}
| コンソール上で動作
| bash のみに依存するシンプルな CLI セッションランチャー。
|}

== GUI ライブラリ ==
[https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] も参照してください。

=== GTK ===

{{pkg|gtk3}} と {{pkg|gtk4}} パッケージは Wayland バックエンドが有効になっています。

Wayland と X 両方のバックエンドが有効になっているとき、GTK+ ではデフォルトで Wayland バックエンドを使いますが、{{ic|GDK_BACKEND=x11}} 環境変数を設定することで Xwayland を使うように上書きできます。

=== Qt ===

[[Qt]] 5 または 6 は Wayland をサポートしています。{{Pkg|qt5-wayland}} または {{Pkg|qt6-wayland}} パッケージをインストールしてください。

Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、[[環境変数]] {{ic|1=QT_QPA_PLATFORM=wayland}} をセットして下さい。一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} とセットします。
これは、{{AUR|zoom}} など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。
また、{{ic|1=QT_QPA_PLATFORM="wayland;xcb"}} を使用すると、QtがWaylandが利用できない場合、代わりにxcb (X11)プラグインを使用させることができます。

[[sway]] などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、 [https://keepassxc.org KeepassXC] はトレイに最小化できません。これは、アプリケーションを実行する前に {{Pkg|qt5ct}} をインストールし、 {{ic|1=QT_QPA_PLATFORMTHEME=qt5ct}} を設定することで解決できます。

===Clutter===

Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。

Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|CLUTTER_BACKEND=wayland}} を設定する必要があります。

===SDL2 ===

SDL2 アプリケーションを Wayland 上で動作させるには、環境変数 {{ic|SDL_VIDEODRIVER=wayland}} を設定します。

{{Note|Wayland 未対応の古い SDL が内部に含まれたゲームでは、{{ic|1=SDL_VIDEODRIVER=wayland}} を指定すると動作が壊れる場合があります。アプリケーションを XWayland で強制的に実行するには、{{ic|1=SDL_VIDEODRIVER=x11}} を設定します。}}

=== GLFW ===

GLFW で Wayland バックエンドを使用するには、({{Pkg|glfw-x11}} の代わりに) {{Pkg|glfw-wayland}} パッケージをインストールしてください。

=== GLEW ===

{{AUR|glew-wayland}} パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で {{Pkg|glew}} を使うことです。{{Bug|62713}} を参照してください。

===EFL===

EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。

=== winit ===

[https://github.com/rust-windowing/winit Winit] は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、明示的に設定することもできます。{{ic|WINIT_UNIX_BACKEND}} 環境変数の値を {{ic|x11}} や {{ic|wayland}} としてください。

=== Electron ===

{{Pkg|electron}} ベースのアプリケーションを Wayland でネイティブに使用するには、{{ic|${XDG_CONFIG_HOME}/electron-flags.conf}} を作成または編集して、次のオプションを追加します。

{{hc|1=~/.config/electron-flags.conf|2=
--enable-features=UseOzonePlatform
--ozone-platform=wayland
}}

古いバージョンの electron には独自の {{ic|electron-flags.conf}} ファイルが必要であることに注意してください。''electron12'' パッケージがインストールされている場合は、次のようにします。

$ ln -s electron-flags.conf ~/.config/electron12-flags.conf

{{ic|${XDG_CONFIG_HOME} }} 内にコピーしてください、または、異なる {{Pkg|electron}} バージョンで異なるランタイムオプションを使用したい場合は、別の {{ic|${XDG_CONFIG_HOME}/electron12-flags.conf}} ファイルを使用する必要があります。

{{Tip|Electron-flags をグローバルに上書きする代わりに、[[デスクトップエントリ]] を変更するとよいでしょう。}}

== XWayland ==

[https://wayland.freedesktop.org/xserver.html XWayland] は、Wayland の下で実行される X サーバーです。レガシー [[X11]] アプリケーションに下位互換性を提供します。

これを使用するには、{{Pkg|xorg-xwayland}} パッケージを [[インストール]] します。

XWaylandはコンポジターを介して開始されるため、選択したコンポジターを使用して、XWayland の互換性と XWayland の開始方法の説明を確認して下さい。

{{Note|セキュリティについて: XWayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。
}}

=== NVIDIA ドライバ ===

{{Note|バージョン 470 より前の Nvidia ドライバ(例: {{aur|nvidia-390xx-dkms}}) はハードウェアアクセラレーションされた XWayland をサポートしておらず、Wayland 以外のアプリケーションで Wayland セッションのパフォーマンスが低下します。}}

なお、[[NVIDIA#DRM kernel mode setting|DRM KMS]] を有効にする必要があります。また、お使いのディスプレイマネージャ(例: [[GDM#Wayland と独自の NVIDIA ドライバ|GDM]])の[https://us.download.nvidia.com/XFree86/Linux-x86_64/470.42.01/README/xwayland.html 公式ドキュメント]に記載されている情報も見てください。

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

=== Xwayland アプリケーションであることを視認する ===

アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、{{AUR|extramaus}} を使用します。
アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。

または、{{pkg|xorg-xeyes}} を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。

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

=== 色補正 ===

[[バックライト#色補正]]を参照。

=== 動作が遅い、表示がおかしい、クラッシュする ===

Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} などの rc ファイルから該当箇所を削除してみてください。

=== Electron ベースのアプリケーションでは、ディスプレイ::0を開けません ===

GDK_BACKEND = wayland を設定していないことを確認してください。グローバルに設定すると、 Electron アプリが機能しなくなります。

=== リモートディスプレイ ===

いくつか選択肢が考えられます:
* [[Sway]] など {{Pkg|wlroots}} ベースのコンポジタでは {{AUR|wayvnc}} VNC サーバーが利用できます。
* [[Weston]] には RDP バックエンドが含まれています。{{man|7|weston-rdp}} を参照してください。
* {{Pkg|mutter}} ベースの場合は {{Pkg|gnome-remote-desktop}} が使えます。[https://wiki.gnome.org/Projects/Mutter/RemoteDesktop 公式サイト] を参照してください。
* {{AUR|waypipe}} や {{AUR|waypipe-git}} は Wayland アプリケーションの透過プロキシです。[[SSH]] を組み合わせることで外部から操作できます。詳細は[https://gitlab.freedesktop.org/mstoeckl/waypipe 公式サイト]を参照してください。

=== ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力 ===

Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。

入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:
* ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
* マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。

Wayland と XWayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。X上で動作するアプリケーションの場合、対応は不要です。

関連する拡張:
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml XWayland keyboard grabbing protocol] (XWayland のサポートは xorg-server 1.20 開発ツリーに追加されています [https://lists.x.org/archives/xorg-devel/2017-August/054231.html])
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol]
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/relative-pointer/relative-pointer-unstable-v1.xml Relative pointer protocol]
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml Pointer constraints protocol]

サポートしている Wayland コンポジタ:
* Mutter, [[GNOME]] のコンポジタ ([https://bugzilla.gnome.org/show_bug.cgi?id=783342 リリース 3.28] 以上)。
* {{Pkg|wlroots}} (Relative pointer protocols と Pointer constraints protocol に対応)

サポートしているウィジェットツールキット:
* GTK (リリース 3.22.18 以上)。

=== GTK テーマが動かない ===

https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland を参照してください。

==参照==

* [https://wayland.freedesktop.org/docs/html/ Wayland オンラインドキュメント]
* [https://gitlab.freedesktop.org/wayland Official Wayland Git Repo]
* [[Fedora:How to debug Wayland problems|Fedora Wiki の Wayland のデバッグに関する記事]]
* [https://arewewaylandyet.com/ Are we Wayland yet?]
* [https://awesomeopensource.com/projects/wayland Awesome Wayland projects]
* [[カーソルテーマ]]
* [https://bbs.archlinux.org/viewtopic.php?id=107499 Arch Linux forum discussion]
* [https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives i3 Migration Guide - Common X11 apps used on i3 with Wayland alternatives]
* [https://wayland.app/protocols/ Wayland Explorer - A better way to read Wayland documentation]

{{TranslationStatus|Wayland|2021-11-09|700011}}

Snapper

2022-01-16T04:39:21Z

Funcrab: /* {{ic|/}} を {{ic|@}} のスナップショットに復元 */ mountコマンド例のデバイス部分を斜体に変更

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは '''{{ic|snapper rollback}} を使用することは想定していません'''が、[[#/ を @ のスナップショットに復元|/ を @ のスナップショットに復元]]した時の問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。''/dev/sda2'' をマウントする例：

# mount -o subvolid=5 ''/dev/sda2'' /mnt

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、終了するときは {{ic|q}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Snapper

2022-01-16T04:20:48Z

Funcrab: /* {{ic|/}} を {{ic|@}} のスナップショットに復元 */ mountコマンド例を追加

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは '''{{ic|snapper rollback}} を使用することは想定していません'''が、[[#/ を @ のスナップショットに復元|/ を @ のスナップショットに復元]]した時の問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。/dev/sda2 をマウントする例：

# mount -o subvolid=5 /dev/sda2 /mnt

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、終了するときは {{ic|q}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Wayland

2022-01-14T15:43:06Z

Funcrab: /* winit */ 誤字訂正（XINIT⇒WINIT）

[[Category:グラフィカルユーザーインターフェイス]]
[[es:Wayland]]
[[en:Wayland]]
[[fr:Wayland]]
[[pt:Wayland]]
[[ru:Wayland]]
[[zh-hans:Wayland]]
{{Related articles start}}
{{Related|Kernel Mode Setting}}
{{Related|Xorg}}
{{Related|スクリーンショットの取得#Wayland}}
{{Related articles end}}

[https://wayland.freedesktop.org/ Wayland] はディスプレイサーバープロトコルです。[[Xorg|X Window System]] の後継となることを目指しています。[[Wikipedia:Wayland_(display_server_protocol)#Differences_between_Wayland_and_X|Wikipedia に Wayland と Xorg の比較]] が掲載されています。

Wayland プロトコルを使用するディスプレイサーバは、[[Wikipedia:ja:コンポジット型ウィンドウマネージャ|コンポジット型ウィンドウマネージャ]] としても機能するため、'''コンポジタ''' と呼ばれます。以下に[[#コンポジタ|Wayland コンポジタのリスト]]を示します。

レガシーな [[X11]] アプリケーションをシームレスに動かすための後方互換性として、[[#XWayland|XWayland]] を使うことができます。これは Wayland に X サーバを提供します。

== 要件 ==
ほとんどの Wayland コンポジタは [[KMS]] を利用しているシステムで動作します。

また、Wayland はただのライブラリなので、それだけでは使い物になりません。X サーバーを置き換えるには、([[Weston]] や [[Sway]] などの) コンポジタあるいは ([[GNOME]] や [[KDE]] など) デスクトップ環境が必要です。

GPU ドライバーと Wayland コンポジタは同一のバッファ API に対応している場合に互換性があります。主要な API は2つ存在します: [[Wikipedia:Generic Buffer Management|GBM]] と [https://www.phoronix.com/scan.php?page=news_item&px=XDC2016-Device-Memory-API EGLStreams] です。

{| class="wikitable"
|-
! バッファ API !! GPU ドライバーのサポート !! Wayland コンポジタのサポート
|-
| GBM || [[NVIDIA]] < 495* 以外の全てのドライバー || 全てのコンポジタ
|-
| EGLStreams || [[NVIDIA]] || [[GNOME]], [[KDE]] [[Weston#EGLstream_support_(for_proprietary_Nvidia_Driver)|Weston]] (with a third-party patch)
|-
|}

: *: Nvidia >= 495 は EGLStreams と GBM[https://www.phoronix.com/scan.php?page=news_item&px=NVIDIA-495.44-Linux-Driver] の両方をサポートします。

== コンポジタ ==

タイル型とスタック型の違いは、[[ウィンドウマネージャ#種類]]を参照してください。

=== タイル型 ===

* {{App|[[Cagebreak]]|cage をベースに、[[ratpoison]] にインスパイアされています。|https://github.com/project-repo/cagebreak|{{AUR|cagebreak}} {{AUR|cagebreak-bin}}}}
* {{App|Cardboard|スクロールコンポジタ。wlroots をベースに、PaperWM にインスパイアされています。|https://gitlab.com/cardboardwm/cardboard|{{AUR|cardboard-git}}}}
* {{App|dwl|wlroots ベースの [[dwm]] ライクな Wayland コンポジタ。|https://github.com/djpohly/dwl|{{AUR|dwl}}}}
* {{App|japokwm|wlroots ベースの、レイアウト作成を中心とした動的な Wayland タイリングコンポジタ。|https://github.com/werererer/japokwm|{{AUR|japokwm-git}}}}
* {{App|[[Qtile]]|Python で記述および設定されたフル機能のハッキング可能なタイリングウィンドウマネージャーと Wayland コンポジタ。|https://github.com/qtile/qtile|{{Pkg|qtile}}}}
* {{App|river|dwm [[bspwm]] にインスパイアされた動的なタイル型 Wayland コンポジタ。|https://github.com/ifreund/river|{{AUR|river-git}}}}
* {{App|[[Sway]]|wlroots ベースの [[i3]] 互換 Wayland コンポジタ。|https://github.com/swaywm/sway|{{Pkg|sway}}}}
* {{App|[[Velox]]|swc ベースのシンプルなウィンドウマネージャです。[[dwm]] と [[xmonad]] の影響を受けています。|https://github.com/michaelforney/velox|{{AUR|velox}}}}
* {{App|waymonad|[[Haskell]] で書かれた xmonad にインスパイアされた Wayland コンジタ。|https://github.com/waymonad/waymonad}}
* {{App|newm|ラップトップとタッチパッドを念頭に置いて作成された Wayland コンポジタ|https://github.com/jbuchermn/newm/|{{AUR|newm-git}}}}

=== スタック型 ===

* {{App|[[Enlightenment]]|[[Enlightenment#Enlightenment を手動で起動する]] を参照してください。詳細: [https://git.enlightenment.org/core/enlightenment.git/tree/README] [https://www.enlightenment.org/about-wayland]|https://www.enlightenment.org/|{{Pkg|enlightenment}}}}
* {{App|Greenfield|Web ブラウザーで実行され、リモートアプリケーションを表示できます。|https://greenfield.app/}}
* {{App|Grefsen|最小限のデスクトップ環境を提供する Qt/Wayland コンポジタ。|https://github.com/ec1oud/grefsen}}
* {{App|hikari|FreeBSD で活発に開発されている [[cwm]] にインスパイアされた wlroots ベースのコンポジタ。Linux もサポートしている。|https://hikari.acmelabs.space/|{{AUR|hikari}}}}
* {{App|KDE [[w:KWin|KWin]]|[[KDE#Starting Plasma]] を参照。|https://userbase.kde.org/KWin|{{Pkg|kwin}}}}
* {{App|Liri Shell|[[Liri]] の一部、しかし、QtQuick と QtCompositor を使って Wayland 用のコンポジタとして作られています。|https://github.com/lirios/shell|{{AUR|liri-shell-git}}}}
* {{App|labwc|Openbox にインスパイアされた wlroots ベースのコンポジタ。|https://github.com/johanmalm/labwc|{{AUR|labwc-git}}}}
* {{App|[[w:Mutter (software)|Mutter]]|[[GNOME#Starting]] を参照してください。|https://gitlab.gnome.org/GNOME/mutter|{{Pkg|mutter}}}}
* {{App|wayfire|[[Compiz]] にインスパイアされ、wlroots に基づく 3D コンポジタ。|https://wayfire.org/|{{AUR|wayfire}}}}
* {{App|[[Weston]]|Wayland コンポジタのリファレンス実装。|https://gitlab.freedesktop.org/wayland/weston|{{Pkg|weston}}}}
* {{App|wio|Plan 9 のリオデスクトップのルックアンドフィールを複製することを目的とする wlroots ベースのコンポジタ。|https://wio-project.org/}}

=== その他 ===

* {{App|Cage|キオスクのような単一のフルスクリーンアプリケーションを表示します。 |https://www.hjdskes.nl/projects/cage/|{{Pkg|cage}}}}
* {{App|Maze Compositor|Qt を使用して 3D 迷路ウィンドウをレンダリングします。|https://github.com/imbavirus/mazecompositor}}
* {{App|Motorcar|バーチャルリアリティを使用して 3D ウィンドウを探索する Wayland コンポジタ。|https://github.com/evil0sheep/motorcar}}

上記のいくつかは [[ディスプレイマネージャ]] をサポートする場合があります。
それらがどのように開始されるかを {{ic|/usr/share/wayland-sessions/''compositor''.desktop}} を見て確認してください。

== ディスプレイマネージャ ==

Wayland コンポジタの実行をサポートした[[ディスプレイマネージャ]]は以下の表の通りです。種類の列にはディスプレイマネージャが Wayland 上での実行をサポートしているかどうかが示されています。

{| class="wikitable sortable"
! 名前
! 種類
! 説明
|-
| [[GDM]]
| Wayland/X11 上で動作
| [[GNOME]] ディスプレイマネージャ。
|-
| {{AUR|greetd}}
| ログインデーモン
| 最小でありながら柔軟なログインデーモン。
|-
| [[LightDM]]
| Wayland/X11 上で動作 [https://github.com/CanonicalLtd/lightdm/commit/f4f681f7b4209a634b021ba731addec1e081e5c7]
| 様々なデスクトップに対応したディスプレイマネージャ。
|-
| {{AUR|Ly}}
| コンソール上で動作
| TUI ディスプレイマネージャ。
|-
| [[SDDM]]
| X11 上で動作 [https://github.com/sddm/sddm/pull/616]
| QML ベースのディスプレイマネージャ。
|-
| {{AUR|tbsm}}
| コンソール上で動作
| bash のみに依存するシンプルな CLI セッションランチャー。
|}

== GUI ライブラリ ==
[https://wayland.freedesktop.org/toolkits.html 公式ウェブサイト] も参照してください。

=== GTK ===

{{pkg|gtk3}} と {{pkg|gtk4}} パッケージは Wayland バックエンドが有効になっています。

Wayland と X 両方のバックエンドが有効になっているとき、GTK+ ではデフォルトで Wayland バックエンドを使いますが、{{ic|GDK_BACKEND=x11}} 環境変数を設定することで Xwayland を使うように上書きできます。

=== Qt ===

[[Qt]] 5 または 6 は Wayland をサポートしています。{{Pkg|qt5-wayland}} または {{Pkg|qt6-wayland}} パッケージをインストールしてください。

Wayland プラグインを使って Qt 5 アプリケーションを動作させるには、[https://wiki.qt.io/QtWayland#How_do_I_use_QtWayland.3F] にあるように、{{ic|1=-platform wayland}} を使用するか、[[環境変数]] {{ic|1=QT_QPA_PLATFORM=wayland}} をセットして下さい。一方、Wayland セッション上で [[X11]] を使用させるには、{{ic|1=QT_QPA_PLATFORM=xcb}} とセットします。
これは、{{AUR|zoom}} など、システムの Qt の実装を使用しない一部のプロプライエタリアプリケーションで必要になる場合があります。

[[sway]] などの一部のコンポジターでは、ネイティブに実行されている Qt アプリケーションの機能が不足している場合があります。たとえば、 [https://keepassxc.org KeepassXC] はトレイに最小化できません。これは、アプリケーションを実行する前に {{Pkg|qt5ct}} をインストールし、 {{ic|1=QT_QPA_PLATFORMTHEME=qt5ct}} を設定することで解決できます。

===Clutter===

Clutter ツールキットには Wayland バックエンドがあり、Clutter を Wayland のクライアントとして動作させることが可能です。このバックエンドは {{Pkg|clutter}} パッケージで有効になっています。

Clutter アプリを Wayland 上で動作させるには、環境変数 {{ic|CLUTTER_BACKEND=wayland}} を設定する必要があります。

===SDL2 ===

SDL2 アプリケーションを Wayland 上で動作させるには、環境変数 {{ic|SDL_VIDEODRIVER=wayland}} を設定します。

{{Note|Wayland 未対応の古い SDL が内部に含まれたゲームでは、{{ic|1=SDL_VIDEODRIVER=wayland}} を指定すると動作が壊れる場合があります。アプリケーションを XWayland で強制的に実行するには、{{ic|1=SDL_VIDEODRIVER=x11}} を設定します。}}

=== GLFW ===

GLFW で Wayland バックエンドを使用するには、({{Pkg|glfw-x11}} の代わりに) {{Pkg|glfw-wayland}} パッケージをインストールしてください。

=== GLEW ===

{{AUR|glew-wayland}} パッケージは現在のところ、多くの GLEW ベースのアプリケーションでまだ動作しませんので、唯一の選択肢は Xwayland で {{Pkg|glew}} を使うことです。{{Bug|62713}} を参照してください。

===EFL===

EFL は Wayland を完全にサポートしています。Wayland で EFL アプリケーションを動かすには、Wayland の [https://wayland.freedesktop.org/efl.html プロジェクトページ] を見て下さい。

=== winit ===

[https://github.com/rust-windowing/winit Winit] は [[Rust]] で書かれたウィンドウ管理ライブラリです。デフォルトでは Wayland が X11 より優先される仕様ですが、明示的に設定することもできます。{{ic|WINIT_UNIX_BACKEND}} 環境変数の値を {{ic|x11}} や {{ic|wayland}} としてください。

=== Electron ===

{{Pkg|electron}} ベースのアプリケーションを Wayland でネイティブに使用するには、{{ic|${XDG_CONFIG_HOME}/electron-flags.conf}} を作成または編集して、次のオプションを追加します。

{{hc|1=~/.config/electron-flags.conf|2=
--enable-features=UseOzonePlatform
--ozone-platform=wayland
}}

古いバージョンの electron には独自の {{ic|electron-flags.conf}} ファイルが必要であることに注意してください。''electron12'' パッケージがインストールされている場合は、次のようにします。

$ ln -s electron-flags.conf ~/.config/electron12-flags.conf

{{ic|${XDG_CONFIG_HOME} }} 内にコピーしてください、または、異なる {{Pkg|electron}} バージョンで異なるランタイムオプションを使用したい場合は、別の {{ic|${XDG_CONFIG_HOME}/electron12-flags.conf}} ファイルを使用する必要があります。

{{Tip|Electron-flags をグローバルに上書きする代わりに、[[デスクトップエントリ]] を変更するとよいでしょう。}}

== XWayland ==

[https://wayland.freedesktop.org/xserver.html XWayland] は、Wayland の下で実行される X サーバーです。レガシー [[X11]] アプリケーションに下位互換性を提供します。

これを使用するには、{{Pkg|xorg-xwayland}} パッケージを [[インストール]] します。

XWaylandはコンポジターを介して開始されるため、選択したコンポジターを使用して、XWayland の互換性と XWayland の開始方法の説明を確認して下さい。

{{Note|セキュリティについて: XWayland は X サーバーであるため、 Wayland のセキュリティ機能はありません。
}}

=== NVIDIA ドライバ ===

{{Note|バージョン 470 より前の Nvidia ドライバ(例: {{aur|nvidia-390xx-dkms}}) はハードウェアアクセラレーションされた XWayland をサポートしておらず、Wayland 以外のアプリケーションで Wayland セッションのパフォーマンスが低下します。}}

なお、[[NVIDIA#DRM kernel mode setting|DRM KMS]] を有効にする必要があります。また、お使いのディスプレイマネージャ(例: [[GDM#Wayland と独自の NVIDIA ドライバ|GDM]])の[https://us.download.nvidia.com/XFree86/Linux-x86_64/470.42.01/README/xwayland.html 公式ドキュメント]に記載されている情報も見てください。

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

=== Xwayland アプリケーションであることを視認する ===

アプリケーションが Xwayland 経由で実行されているかどうかを判断するには、{{AUR|extramaus}} を使用します。
アプリケーションのウィンドウ上にマウスポインタを移動して、マウスポインタが赤くなる場合は、アプリケーションが Xwayland 経由で実行されています。

または、{{pkg|xorg-xeyes}} を使用して、アプリケーションウィンドウ上でマウスポインタを移動するときに、目が動いているかどうかで確認することもできます。

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

=== 色補正 ===

[[バックライト#色補正]]を参照。

=== 動作が遅い、表示がおかしい、クラッシュする ===

Gnome-shell で X から Wayland に切り替えるとグラフィック表示に問題が発生することがあります。原因として Xorg ベースの gnome-shell 用に {{ic|1=CLUTTER_PAINT=disable-clipped-redraws:disable-culling}} が設定されている可能性があります。{{ic|/etc/environment}} などの rc ファイルから該当箇所を削除してみてください。

=== Electron ベースのアプリケーションでは、ディスプレイ::0を開けません ===

GDK_BACKEND = wayland を設定していないことを確認してください。グローバルに設定すると、 Electron アプリが機能しなくなります。

=== リモートディスプレイ ===

いくつか選択肢が考えられます:
* [[Sway]] など {{Pkg|wlroots}} ベースのコンポジタでは {{AUR|wayvnc}} VNC サーバーが利用できます。
* [[Weston]] には RDP バックエンドが含まれています。{{man|7|weston-rdp}} を参照してください。
* {{Pkg|mutter}} ベースの場合は {{Pkg|gnome-remote-desktop}} が使えます。[https://wiki.gnome.org/Projects/Mutter/RemoteDesktop 公式サイト] を参照してください。
* {{AUR|waypipe}} や {{AUR|waypipe-git}} は Wayland アプリケーションの透過プロキシです。[[SSH]] を組み合わせることで外部から操作できます。詳細は[https://gitlab.freedesktop.org/mstoeckl/waypipe 公式サイト]を参照してください。

=== ゲームやリモートデスクトップ、仮想マシンウィンドウでの入力 ===

Xorg と異なり、Wayland では入力デバイスを独占 (グラブ) することができません。キーボードショートカットやポインタデバイスをアプリケーションウィンドウに渡すのは Wayland コンポジタの役目となっています。

入力グラブが変わったことで以下のように既存のアプリケーションで問題が発生します:
* ホットキーや修飾キーがコンポジタによって認識されてしまい、リモートデスクトップや仮想マシンのウィンドウに送信されなくなります。
* マウスポインタがアプリケーションウィンドウに制限されなくなるため、仮想マシンやリモートデスクトップのウィンドウ内のマウスポインタの位置がホスト環境のマウスポインタとずれるようになります。

Wayland と XWayland にプロトコル拡張を追加することで解決を図っていますが、Wayland コンポジタが拡張をサポートしている必要があり、ネイティブの Wayland クライアントの場合、ウィジェットツールキット (例: GTK, Qt) やアプリケーション自身が拡張に対応していなければなりません。X上で動作するアプリケーションの場合、対応は不要です。

関連する拡張:
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/xwayland-keyboard-grab/xwayland-keyboard-grab-unstable-v1.xml XWayland keyboard grabbing protocol] (XWayland のサポートは xorg-server 1.20 開発ツリーに追加されています [https://lists.x.org/archives/xorg-devel/2017-August/054231.html])
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/keyboard-shortcuts-inhibit/keyboard-shortcuts-inhibit-unstable-v1.xml Compositor shortcuts inhibit protocol]
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/relative-pointer/relative-pointer-unstable-v1.xml Relative pointer protocol]
* [https://cgit.freedesktop.org/wayland/wayland-protocols/tree/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml Pointer constraints protocol]

サポートしている Wayland コンポジタ:
* Mutter, [[GNOME]] のコンポジタ ([https://bugzilla.gnome.org/show_bug.cgi?id=783342 リリース 3.28] 以上)。
* {{Pkg|wlroots}} (Relative pointer protocols と Pointer constraints protocol に対応)

サポートしているウィジェットツールキット:
* GTK (リリース 3.22.18 以上)。

=== GTK テーマが動かない ===

https://github.com/swaywm/sway/wiki/GTK-3-settings-on-Wayland を参照してください。

==参照==

* [https://wayland.freedesktop.org/docs/html/ Wayland オンラインドキュメント]
* [https://gitlab.freedesktop.org/wayland Official Wayland Git Repo]
* [[Fedora:How to debug Wayland problems|Fedora Wiki の Wayland のデバッグに関する記事]]
* [https://arewewaylandyet.com/ Are we Wayland yet?]
* [https://awesomeopensource.com/projects/wayland Awesome Wayland projects]
* [[カーソルテーマ]]
* [https://bbs.archlinux.org/viewtopic.php?id=107499 Arch Linux forum discussion]
* [https://github.com/swaywm/sway/wiki/i3-Migration-Guide#common-x11-apps-used-on-i3-with-wayland-alternatives i3 Migration Guide - Common X11 apps used on i3 with Wayland alternatives]
* [https://wayland.app/protocols/ Wayland Explorer - A better way to read Wayland documentation]

{{TranslationStatus|Wayland|2021-11-09|700011}}

Snapper

2022-01-11T03:49:38Z

Funcrab: lessのgg（最初に戻る）よりもq（exit）の方が実用的なので変更

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは '''{{ic|snapper rollback}} を使用することは想定していません'''が、[[#/ を @ のスナップショットに復元|/ を @ のスナップショットに復元]]した時の問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、終了するときは {{ic|q}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Pacman

2022-01-10T15:38:42Z

Funcrab: /* アップグレード中に Pacman がクラッシュしました */ ケース「"pacman: command not found"」について追加

[[Category:パッケージ管理]]
[[Category:Arch プロジェクト]]
[[Category:コマンド]]
[[ar:Pacman]]
[[cs:Pacman]]
[[da:Pacman]]
[[de:Pacman]]
[[el:Pacman]]
[[en:Pacman]]
[[es:Pacman]]
[[fa:Pacman]]
[[fr:Pacman]]
[[id:Pacman]]
[[it:Pacman]]
[[ko:Pacman]]
[[nl:Pacman]]
[[pl:Pacman]]
[[pt:Pacman]]
[[ru:Pacman]]
[[sr:Pacman]]
[[sv:Pacman]]
[[zh-hans:Pacman]]
[[zh-hant:Pacman]]
{{Lowercase title}}
{{Related articles start}}
{{Related|パッケージの作成}}
{{Related|パッケージのダウングレード}}
{{Related|Pacman のパフォーマンスの向上}}
{{Related|Pacman GUI フロントエンド}}
{{Related|Pacman 比較表}}
{{Related|Pacman ヒント}}
{{Related|FAQ#パッケージ管理}}
{{Related|pacman-key}}
{{Related|Pacnew と Pacsave ファイル}}
{{Related|Pacman/ローカルデータベースの復元}}
{{Related|アプリケーション一覧/ユーティリティ#パッケージ管理}}
{{Related|Arch Build System}}
{{Related|公式リポジトリ}}
{{Related|Arch User Repository}}
{{Related articles end}}

'''[https://www.archlinux.org/pacman/ pacman]''' [[Wikipedia:ja:パッケージ管理システム|パッケージマネージャ]]は Arch Linux の主要な機能のひとつです。pacman はシンプルなバイナリのパッケージ形式と簡単に利用できる[[Arch Build System|ビルドシステム]]から成っています。pacman のゴールはパッケージ管理を楽にすることであり、[[公式リポジトリ|公式 Arch リポジトリ]]にあるパッケージや、ユーザー自身が作成したパッケージを容易に管理することができます。

Pacman はマスターサーバーと同期してシステムを最新に保ちます。このサーバー・クライアントモデルによって、シンプルなコマンドだけで必要な依存性を解決してパッケージのダウンロード・インストールをすることができます。

Pacman は C 言語で書かれており {{ic|.pkg.tar.xz}} パッケージフォーマットを使います。

{{Tip|1=公式の {{Pkg|pacman}} パッケージには [[makepkg]] や '''vercmp''' などのツールが含まれています。'''pactree''' や [[#部分的なアップグレードはサポートされていません|checkupdates]] など他の有用なツールは {{Pkg|pacman-contrib}} パッケージに含まれています([https://git.archlinux.org/pacman.git/commit/?id=0c99eabd50752310f42ec808c8734a338122ec86 以前] は pacman パッケージに含まれていました)。ツールの一覧を見るには {{ic|pacman -Ql pacman pacman-contrib {{!}} grep -E 'bin/.+'}} を実行してください。 }}

==使い方==

pacman で何ができるかをちゃんと学びたい場合、{{man|8|pacman}} を参照してください。以下にあるのは pacman でできることのほんの一例です。

{{Tip|他の Linux ディストリビューションを使ったことがある場合、[[Pacman 比較表]]の記事が役に立つでしょう。}}

===パッケージのインストール===

{{Note|
* パッケージには [[PKGBUILD#optdepends|optdepends]] が設定されていることがあります。必ずインストールする必要はありませんが、インストールすることで機能が追加されます。[[#パッケージ・データベースに問い合わせる|パッケージ・データベースに問い合わせる]]ことで情報を参照することができます。
* 他のパッケージの依存パッケージとしてパッケージをインストールする場合 (そのパッケージ自体は必要としていない場合)、{{ic|--asdeps}} オプションを使用することを推奨します。詳しくは[[#インストール理由|インストール理由]]を参照。}}

{{Warning|1=パッケージのインストールをする際に、[[#パッケージのアップグレード|アップグレード]]をせずにパッケージリストを更新しないでください (つまり {{ic|pacman -Sy ''パッケージ名''}} をしてはいけない)。これを実行すると依存関係に問題がおこる可能性があります。[[#部分的なアップグレードはサポートされていません]] や https://bbs.archlinux.org/viewtopic.php?id=89328 を参照。}}

====特定のパッケージのインストール====

ひとつ、あるいは複数の（依存を含む）パッケージをインストールするときは:

# pacman -S ''パッケージ名1'' ''パッケージ名2'' ...

異なるリポジトリにそれぞれ同じ名前のパッケージが存在することがあります (例: [extra] リポジトリと [testing] リポジトリ)。このような場合、どちらをインストールするかを明示してください:

# pacman -S extra/''パッケージ名''

名前に類似パターンが存在するパッケージをインストールしたい場合 (グループ全体ではなくマッチするパッケージのみ、例: {{Grp|plasma}}):

# pacman -S plasma-{desktop,mediacenter,nm}

もちろん、必要に応じて更に複雑なパターンを指定することもできます:

# pacman -S plasma-{workspace{,-wallpapers},pa}

====パッケージグループのインストール====

パッケージグループに属しているパッケージを同時にインストールすることができます。例えば:

# pacman -S gnome

を実行すると {{Grp|gnome}} グループからインストールしたいパッケージを選択するように表示されます。

パッケージグループには大量のパッケージが含まれており、しばしばインストールしたいパッケージはそのうちの少しだけということがあるかもしれません。インストールするパッケージの番号を全て入力するという方法でもよいですが、以下のようにすることで簡単にパッケージを選択することが可能です:

Enter a selection (default=all): 1-10 15

以上で1番から10番までと15番のパッケージがインストールされます。

Enter a selection (default=all): ^5-8 ^2

以上で5番から8番までと2番のパッケージ以外の全てのパッケージをインストールします。

どのパッケージが gnome グループに属しているか見るには:

# pacman -Sg gnome

どのようなパッケージグループがあるかは https://www.archlinux.jp/groups/ を見て下さい。

{{Note|グループの中にインストール済みのパッケージがある場合でも、グループにあわせて再インストールされます。{{ic|--needed}} オプションを使うことで無視できます。}}

===パッケージの削除===

あるパッケージを、そのパッケージが必要としていたものを残したまま削除するには:

# pacman -R ''パッケージ名''

削除したいパッケージと、そのパッケージだけが必要としている他のパッケージを一緒に削除するには:

# pacman -Rs ''パッケージ名''

削除したいパッケージと、そのパッケージが必要としている他のパッケージ、さらに削除したいパッケージに依存しているパッケージを削除するには:

{{Warning|この操作は再帰的です。必要なパッケージを削除してしまうこともあるので、気をつけて使って下さい。}}

# pacman -Rsc ''パッケージ名''

他のパッケージから依存されているパッケージを、依存しているパッケージを削除しないで削除するには:

# pacman -Rdd ''パッケージ名''

デフォルトでは、pacman は削除されたパッケージの設定ファイルを *.pacsave という拡張子をつけてバックアップします。もしこれらのファイルも一緒に削除したい場合:

# pacman -Rn ''パッケージ名''

{{Note|Pacman はパッケージがインストールされた後に作成された設定ファイルを削除しません。$HOME ディレクトリ下の設定ファイルなどは手動で削除してください。}}

===パッケージのアップグレード===

Pacman は以下のコマンドひとつでシステムの全てのパッケージのアップデートができます。システムがどれだけ新しいかによってかかる時間が変わります。このコマンドはリポジトリデータベースと同期して''それから''システムのパッケージをアップデートします(リポジトリにない'ローカル'パッケージは別です):

# pacman -Syu

{{Warning|アップデートがきたらすぐにアップデートしようとする前に、Arch のローリングリリースのことを再確認してください、アップデートが思いがけない結果になることもあります。つまり、重要なプレゼンをやらなくちゃいけないからといってアップデートするのは賢いとは言えません。手の空いた時間に、何が起こっても対処できるように準備をしてからアップデートしましょう。}}

Pacman は強力なパッケージ管理ツールですが、全ての問題を解決できるわけではありません。混乱したのなら [[The Arch Way]] を読んで下さい。ユーザーは用心深くなって、システムのメンテナンスの責任を自分でとらなくてはなりません。'''システムアップデートをしたときは、pacman からの表示を全て読み常識を働かせることが肝要です'''。[[Arch Linux の安定化#Arch のメンテナンス]]を見てください。もし（ユーザーによって作られた）設定ファイルを新しいパッケージのバージョンにあわせて変更する必要があるときは、ユーザーの設定を上書きするのを回避するために {{ic|.pacnew}} ファイルが作られます。Pacman はユーザーにそれらをマージするよう表示します。これらのファイルはユーザーが手動で修正しなくてはなりません。パッケージのアップグレードや削除のあとチェックするのが良いでしょう。詳しくは [[Pacnew と Pacsave ファイル]]を見てください。

{{Tip|
* Pacman からの出力は {{ic|/var/log/pacman.log}} に記録されています。
* {{AUR|wat-git}} などのログビューアを使うことで pacman のログを検索できます。
}}

アップグレードするまえに、[https://www.archlinux.jp/ Arch Linux ホームページ] の最新ニュースをチェックしておくとよいでしょう (もしくは [https://www.archlinux.jp/feeds/ RSS フィード], [https://lists.archlinux.org/listinfo/arch-announce/ arch-announce メーリングリスト]を講読したり Twitter の [https://twitter.com/archlinux_jp @archlinux_jp] をフォローする): アップデートの際にいつもとは違うユーザーの操作が必要になった時 (pacman から与えられる指示だけでは不十分な場合など)、それに関してニュースが作られているはずです。

もし解決できない問題にあたったときは、フォーラムを検索してみましょう。他の人も同じ問題にぶつかり、解決法が投稿されているかもしれません。

====部分的なアップグレードはサポートされていません====

Arch Linux はローリングリリースであり、常に新しいバージョンの[[Wikipedia:ja:ライブラリ|ライブラリ]]がリポジトリにプッシュされます。開発者や Trusted User はライブラリにあわせてリポジトリの全てのパッケージをリビルドします。ローカルでパッケージをインストールした場合 ([[Arch User Repository|AUR]] のパッケージなど)、ユーザーは必要に応じて[[Wikipedia:soname|共有ライブラリ]]にあわせてリビルドしなくてはなりません。

つまり部分的なアップグレードは'''サポートされていません'''。{{ic|pacman -Sy package}} や、それと同等の {{ic|pacman -Sy}} からの {{ic|pacman -S package}} などをしないでください。どんなときでも、パッケージをインストールする前に ({{ic|pacman -Syu}} で) アップグレードしてください。{{ic|IgnorePkg}} や {{ic|IgnoreGroup}} を使用する場合は気をつけて扱って下さい。{{ic|pacman -Sy}} は基本的に使ってはいけないコマンドで、代わりに {{ic|pacman -Syu}} を使って下さい。

一度、部分的なアップグレードがなされると、リンクしていたライブラリが見つからなくなってバイナリが壊れてしまいます。'''シンボリックリンクを張ることでこの問題を"解決"しようとしてはいけません'''。ライブラリは''後方互換性がない''ときには [[Wikipedia:soname|soname]] のバージョンアップに対応します。{{ic|pacman -Syu}} を実行しさえすれば、ミラーと同期して ''pacman'' が壊れていないかぎり問題が修正されます。

インストールされているパッケージのアップグレードを確認したいときは {{Pkg|pacman-contrib}} パッケージに含まれている bash スクリプト '''checkupdates''' を使うことで、システムアップデートを行わずに安全に確認が行えます。

===パッケージ・データベースに問い合わせる===

Pacman からローカルデータベースに問い合わせるときは {{ic|-Q}} フラグを、同期データベースに問い合わせるときは {{ic|-S}} フラグを、ファイルデータベースに問い合わせるときは {{ic|-F}} フラグを使います。それぞれのフラグのサブオプションについては {{ic|pacman -Q --help}}, {{ic|pacman -S --help}}, {{ic|pacman -F --help}} を見てください。

Pacman を使ってパッケージ名と説明の両方をデータベースの検索にかけるには:

$ pacman -Ss ''検索ワード1'' ''検索ワード2'' ...

場合によって {{Ic|-s}} の組み込みの ERE (拡張正規表現) が望まない結果を生むことがあります。そのようなときは検索対象をパッケージ名だけに絞ってみてください:

$ pacman -Ss '^vim-'

既にインストール済みのパッケージから検索するには:

$ pacman -Qs ''検索ワード1'' ''検索ワード2'' ...

リモートパッケージからパッケージファイルの名前で検索するには:

$ pacman -Fs ''検索ワード1'' ''検索ワード2'' ...

パッケージ名が分かっていれば、より詳しい情報を得ることができます:

$ pacman -Si ''パッケージ名''

既にインストールしたパッケージの情報を得るには:

$ pacman -Qi ''パッケージ名''

{{ic|-i}} フラグをふたつ付けることでバックアップファイルの一覧と状態を表示できます:

$ pacman -Qii ''パッケージ名''

あるパッケージによってインストールされたファイルの一覧を得るには:

$ pacman -Ql ''パッケージ名''

リモートパッケージによってインストールされるファイルのリストを得るには:

$ pacman -Fl ''パッケージ名''

あるファイルがどのパッケージによってインストールされたかを調べるには:

$ pacman -Qo ''/パス/ファイル名''

あるファイルがどのリモートパッケージに属しているかデータベースに問い合わせるには:

$ pacman -F ''/パス/ファイル名''

孤立した、他のパッケージに必要とされていないパッケージの一覧を得るには:

$ pacman -Qdt

{{Tip|上記のコマンドを pacman の post-transaction [[#フック|フック]]に追加することで、トランザクションによってパッケージが孤立したときに通知することができます。(明示的にインストールしたのでない限り) リポジトリから消されたパッケージはローカルでは孤児になるため、パッケージがリポジトリから消されたときに知ることができます。孤児が見つからなかったときに "failed to execute command" エラーを表示しないようにするため、フックの {{ic|Exec}} では次のコマンドを使用してください: {{ic|<nowiki>/usr/bin/bash -c "/usr/bin/pacman -Qtd || /usr/bin/echo '=> None found.'"</nowiki>}}。}}

明示的にインストールしたパッケージで、依存関係で必要とされていないパッケージを全て表示するには:

$ pacman -Qet

[[pacman ヒント]]には他の例も載っています。

====Pactree====

パッケージの依存のツリーを見るには:

$ pactree ''パッケージ名''

あるパッケージを必要としている全てのパッケージを見るには [[pkgtools]] の {{ic|whoneeds}} を使います:

$ whoneeds ''パッケージ名''

もしくは ''pactree'' のリバースフラグを使って:

$ pactree -r ''package_name''

====データベースの構造====

通常 pacman のデータベースは {{ic|/var/lib/pacman/sync}} に配置され、{{ic|/etc/pacman.conf}} で指定したリポジトリのデータベースファイルがそこに作成されます。データベースファイルは gzip で圧縮された tar アーカイブになっており、パッケージごとにディレクトリが含まれています。例えば {{Pkg|which}} パッケージの場合:

{{bc|
% tree which-2.20-6
which-2.20-6<nowiki>
|-- depends
`-- desc</nowiki>
}}

{{ic|depends}} ファイルにはパッケージが依存するパッケージのリストが記載されており、{{ic|desc}} にはファイルサイズや MD5 ハッシュなどのパッケージの情報が入っています。

===パッケージキャッシュの削除===

pacman はダウンロードしたパッケージを {{ic|/var/cache/pacman/pkg/}} に保存し、古いバージョンやアンインストールされたパッケージを自動では削除しません。従ってこのフォルダのサイズをあまりにも大きくしすぎないために定期的・計画的にこのフォルダを掃除する必要があります。

現在インストールされていないパッケージキャッシュを全て削除するオプションは:

# pacman -Sc

{{Warning|
* インストールしたパッケージが安定していて、[[パッケージのダウングレード|ダウングレード]]が必要ないときだけ行なって下さい。この操作をするとキャッシュフォルダから全ての古いバージョンを削除するため、現在インストールされているバージョンのパッケージだけが残ります。将来のアップグレードでパッケージが破損したときに古いパッケージが必要になることがあり、バージョンを戻したいと思ったときに、キャッシュに古いパッケージがないと [[Arch Linux Archive]] などから古いパッケージを取得するしか方法がなくなってしまいます。
* {{ic|pacman -Scc}} でキャッシュフォルダを完全に削除することも可能ですが、これはあまり推奨されてはいません。上の欠点に加えて、必要なときにキャッシュフォルダから直接パッケージを再インストールすることができなくなってしまい、再ダウンロードが強いられるためです。よっぽどディスク容量を欲しているとき以外は使うべきではありません。
}}

上記の欠点のため、{{ic|-Sc}} や {{ic|-Scc}} スイッチを使う代わりに、キャッシュから削除するパッケージの数をもっと細かく制御できるスクリプトを使うのが推奨されます:

*{{Pkg|pacman-contrib}} パッケージに入っている ''paccache'' コマンドは、デフォルトでそれぞれのパッケージのキャッシュで一番新しい3つのバージョンを残して後を全て削除します: {{bc|$ paccache -r}} ただし、この方法では ''paccache'' はパッケージがインストールされているかどうかを確認''しない''ため、既にアンインストールしたパッケージも保持されます。アンインストールしたパッケージのキャッシュを全て削除するには、次のコマンドを実行する必要があります: {{bc|$ paccache -ruk0}} 他のオプションは {{ic|paccache -h}} を見て下さい。

*もしくは、{{AUR|pkgcacheclean}} をインストールして使うこともできます: {{bc|# pkgcacheclean}}

{{Tip|1=[[#フック]]を作成して pacman の操作後に上記のコマンドを自動的に実行することができます。サンプルが [https://bbs.archlinux.org/viewtopic.php?pid=1694743#p1694743 こちらのスレッド] に載っています。}}

===追加コマンド===

システムのアップグレードとパッケージのインストール (ワンライナー):

# pacman -Syu ''パッケージ名1'' ''パッケージ名2'' ...

インストールをしないで、パッケージをダウンロードする:

# pacman -Sw ''パッケージ名''

リポジトリに存在しない'ローカル'のパッケージ (例: [[Arch User Repository|AUR]] のパッケージ) をインストール:

# pacman -U /パス/パッケージ名-version.pkg.tar.xz

リポジトリにない、リモートのパッケージを URI を入力してインストール:

# pacman -U <nowiki>http://www.example.com/repo/example.pkg.tar.xz</nowiki>

{{Tip|pacman のキャッシュにローカルパッケージのコピーを残したいときは、次を使って下さい:
{{bc|<nowiki>
# pacman -U file://path/to/package/package_name-version.pkg.tar.xz
</nowiki>}}
}}

{{Warning|{{ic|--force}} スイッチを使う時は細心の注意を払って下さい、誤って使用すると大きな問題が起こる場合があります。Arch ニュースでこのスイッチを使うように指示があってとき''だけ''使用することを強く推奨します。}}

''pacman'' で何か操作を行うときは、必ず、インストールしたり削除したりするパッケージのリストが表示され、権限が要求されます。{{ic|-p}} を使うことで {{ic|-S}}, {{ic|-U}}, {{ic|-R}} などの操作を阻止することができます。

''pacman'' にはシステムの操作を簡単にする多数のユーティリティが入っています。それぞれのユーティリティは {{ic|--help}} スイッチを付けて呼び出すことでコマンドオプションを表示できます。

===インストール理由===

''pacman'' データベースではインストールしたパッケージはインストールしたときの理由によって2つのグループに分別されます:

*'''明示的にインストール''': ''pacman'' の {{ic|-S}} や {{ic|-U}} コマンドによって文字通り指定されたパッケージ。
*'''依存パッケージ''': ''pacman'' のインストールコマンドにパッケージの名前は指定されず、明示的にインストールした他のパッケージから[[PKGBUILD#依存関係|必要]]とされたためにインストールされたパッケージ。

パッケージのインストール時、以下のようにすることでインストール理由を''依存パッケージ''に強制的に変えることができます:

# pacman -S --asdeps ''package_name''

{{Tip|任意の依存パッケージを {{ic|--asdeps}} でインストールすると、[[Pacman ヒント#使用していないパッケージの削除 (孤立したパッケージ)|孤立したパッケージを削除]]するときに ''pacman'' によって任意の依存パッケージも削除されるようになります。}}

パッケージの再インストールを行っても、デフォルトではインストール理由は変更されません。

明示的にインストールしたパッケージのリストは {{ic|pacman -Qe}} で表示でき、依存パッケージのリストは {{ic|pacman -Qd}} で表示できます。

既にインストールしたパッケージのインストール理由を変更したい場合、以下のコマンドを実行:

# pacman -D --asdeps ''package_name''

インストール理由を「明示的にインストール」に変えたいときは {{ic|--asexplicit}} を使ってください。

{{Note|{{ic|pacman -Syu ''package_name'' --asdeps}} のように、アップグレードをするときに {{ic|--asdeps}} や {{ic|--asexplicit}} オプションを使用するのは推奨されません。インストールされるパッケージだけでなく、アップグレードされるパッケージのインストール理由まで変更されてしまうためです。}}

===特定のファイルが含まれているパッケージを検索===

ファイルデータベースを同期してください:

# pacman -Fy

ファイルが含まれているパッケージを検索するには:

$ pacman -Fs pacman
core/pacman 5.0.1-4
usr/bin/pacman
usr/share/bash-completion/completions/pacman
extra/xscreensaver 5.36-1
usr/lib/xscreensaver/pacman

{{Tip|[[cron]] ジョブや [[systemd/タイマー|systemd タイマー]]を設定してファイルデータベースを定期的に同期させることができます。}}

高度な使い方をしたい場合、全てのファイルと関連するパッケージのデータベースを使用する [[pkgfile]] をインストールしてください。

==設定==

pacman の設定は {{ic|/etc/pacman.conf}} に記述されています。ここで pacman がどのように動作するかを決めることができます。より詳しい情報は {{man|5|pacman.conf}} にあります。

===全般設定===

全般的な設定は {{ic|[options]}} セクションにあります。ここで設定されている項目については {{man|5|pacman.conf}} かデフォルトの {{ic|pacman.conf}} を参照してください。

====カラー出力====

[[コンソールのカラー出力#pacman]] を見てください。

==== 並列ダウンロードを有効にする ====

''pacman'' 6.0 はパッケージを同時にダウンロードするオプションを導入しました。この機能を使用するには、{{ic|/etc/pacman.conf}} で {{ic|ParallelDownloads}} を正の整数に (例:{{ic|5}}) など設定する必要があります。このオプションが設定されていない場合、パッケージは順番にダウンロードされます。

====アップデートする前にバージョンを比較====

利用可能なパッケージの新旧バージョンを確認したい場合、{{ic|/etc/pacman.conf}} の "VerbosePkgLists" 行をアンコメントしてください。{{ic|pacman -Syu}} の出力が以下のようになります:

Package (6) Old Version New Version Net Change Download Size

extra/libmariadbclient 10.1.9-4 10.1.10-1 0.03 MiB 4.35 MiB
extra/libpng 1.6.19-1 1.6.20-1 0.00 MiB 0.23 MiB
extra/mariadb 10.1.9-4 10.1.10-1 0.26 MiB 13.80 MiB

====アップグレードさせないパッケージを設定====

ある特定のパッケージをアップデートさせないようにするには:

IgnorePkg=linux

複数のパッケージを記述するときはスペースで区切るか、{{ic|IgnorePkg}} 行を追加してください。

====アップグレードさせないグループを設定====

パッケージの場合と同様に、アップグレードさせないグループを指定することができます:

IgnoreGroup=gnome

====アップグレードさせないファイルを設定====

{{Ic|NoUpgrade}} ディレクティブで指定されたファイルはパッケージのインストール・アップグレードで変更を加えられることがなくなり、''.pacnew'' 拡張子が付いたファイルが新しくインストールされます:

NoUpgrade=''path/to/file''

{{Note|パスはパッケージ内のファイルを参照します。したがって、一番最初のスラッシュは必要ありません。}}

====インストールさせないファイルを設定====

特定のディレクトリのインストールをさせないようにするには {{Ic|NoExtract}} リストにディレクトリを加えます。例えば、[[systemd]] ユニットのインストールを避けるには:

NoExtract=usr/lib/systemd/system/*

もしくは {{AUR|localepurge}} と同じように、英語以外のローカライゼーションのインストールを止めるには:

NoExtract = usr/share/help/* !usr/share/help/en*
NoExtract = usr/share/locale/* !usr/share/locale/en* !usr/share/locale/locale.alias
NoExtract = usr/share/man/* !usr/share/man/man*
NoExtract = usr/share/vim/vim74/lang/*

後ろのルールは前のルールを上書きします。また、{{ic|!}} でルールを打ち消すことで、必要なロケールだけを維持できます。

{{Tip|pacman 5 から、''localepurge'' や ''bleachbit'' で消去したロケールがあるパッケージをアップデートする際に、''pacman'' はロケールが存在しないという警告メッセージを表示します。警告を表示しないようにするには {{ic|pacman.conf}} の {{ic|CheckSpace}} オプションをコメントアウトしてください。ただし容量チェック機能は全てのパッケージで無効になります。}}

====複数の設定ファイルを使用====

設定ファイルが複数あって (メインの設定と [[公式リポジトリ|testing]] リポジトリを有効にした設定がある場合など)、設定ファイルのオプションを共有したい場合、設定ファイルで {{ic|Include}} オプションを宣言することができます。例:

Include = /path/to/common/settings

{{ic|/path/to/common/settings}} は共有したいオプションが存在するファイルに置き換えてください。

===フック===

''pacman'' は {{ic|/usr/share/libalpm/hooks/}} ディレクトリのフックを処理の前後に実行することができます。さらに {{ic|pacman.conf}} の {{ic|HookDir}} オプションでフックディレクトリを指定できます (デフォルトは {{ic|/etc/pacman.d/hooks}} です)。フックファイルの名前には必ず ''.hook'' を後ろに付ける必要があります。

Pacman フックは様々なことに使われています。例えば、{{ic|systemd-sysusers}} と {{ic|systemd-tmpfiles}} を組み合わせてパッケージのインストール時に自動的にシステムユーザーを作成します。例として {{pkg|tomcat8}} パッケージでは {{ic|tomcat8}} という名前のシステムユーザーが必要だと指定されており特定のディレクトリの所有者がこのユーザーになるように設定されています。pacman フックの {{ic|systemd-sysusers.hook}} と {{ic|systemd-tmpfiles.hook}} は {{ic|tomcat8}} パッケージにシステムユーザーと一時ファイルが含まれていることを認識して {{ic|systemd-sysusers}} と {{ic|systemd-tmpfiles}} を実行します。

alpm のフックに関する詳細は {{man|5|alpm-hooks}} の man ページを参照。

===リポジトリ===

{{ic|/etc/pacman.conf}} に書かれているように、Repositories セクションではどの[[公式リポジトリ|リポジトリ]]を使うか定義します。リポジトリはここで直接設定することもできますし、他のファイル ({{ic|/etc/pacman.d/mirrorlist}}) から読み込ませることもできます。ただしどれかひとつのファイルを使うようにしてください。ミラーの設定は[[ミラー|ここ]]を見て下さい。

{{Warning|[testing] リポジトリを使う場合には注意が必要です。このリポジトリにあるパッケージは活発に開発が進んでいるため、更新したら動かなくなるものもあります。testing リポジトリを使う場合は、最新情報が流れている [https://lists.archlinux.org/listinfo/arch-dev-public arch-dev-public メーリングリスト] を購読するのをお薦めします。}}

===パッケージのセキュリティ===

Pacman 4 は署名済みのパッケージをサポートしていて、パッケージにセキュリティレイヤーを加えています。{{ic|SigLevel}} を使うことでリポジトリ毎に（もしくは全体的に）セキュリティレベルを設定することが可能です。デフォルトの設定では {{ic|SigLevel <nowiki>=</nowiki> Required DatabaseOptional}} によって全てのリポジトリで全てのパッケージの署名検証が有効にされています。上述したようにリポジトリ毎に {{ic|SigLevel}} を使うことでこの設定を上書きすることができます。パッケージに署名する方法や署名の検証について詳しくは、[[pacman-key]] を見てください。

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

===パッケージ XYZ にアップデートしたらシステムが壊れました===

Arch Linux はローリングリリースで最前線のディストリビューションです。一般的な使用については安定していると判断されるとすぐにパッケージがアップデートされます。しかしながら、アップデートにユーザーの介入が必要になるときが時々あります: 設定ファイルをアップデートしたり、追加の依存パッケージを変更したりなど。

一番重要なことは"やみくもに" Arch のシステムをアップデートしないということです。常時、アップデートされるパッケージの一覧を読みましょう。"重要な"パッケージ ({{Pkg|linux}}, {{Pkg|xorg-server}} など) がアップデートされるのか確認しましょう。もしそうであれば、https://www.archlinux.jp/ でニュースをチェックしたり最近のフォーラムの投稿を見て同じ問題が発生している人がいないか確認したりするのが大抵の場合役に立ちます。

パッケージをアップデートすると問題が発生することを予期される・知られている場合は、パッケージ作成者はパッケージがアップデートされた時、pacman が正しいメッセージを表示しているか確認します。アップデート後に問題がおこった時は、pacman の出力をログ ({{ic|/var/log/pacman.log}}) を見て再チェックしてください。

この段階で '''pacman から何も有用な情報が得られなく、https://www.archlinux.jp/ に関連するニュースもなく、フォーラムにもそのアップデートに関連する投稿がされていない時は'''、助けを求めるのにフォーラムや [[IRC チャンネル|IRC]] を使ったり問題のあるパッケージを[[パッケージのダウングレード|ダウングレード]]してください。

===パッケージ ABC のアップデートが公開されているはずなのに、pacman はシステムは最新だと言っています===

Pacman のミラーはすぐに同期されるわけではありません。あなたのアップデートが有効になるまで 24 時間以上かかることもあります。おとなしく待つか他のミラーを使ってください。[https://www.archlinux.jp/mirrors/status/ MirrorStatus] にミラーの更新状況がのっています。

===アップデートでこんなエラーが出ました: "file exists in filesystem"===

関連: ''Taken from https://bbs.archlinux.org/viewtopic.php?id=56373 by Misfit138.''

error: could not prepare transaction
error: failed to commit transaction (conflicting files)
package: /path/to/file exists in filesystem
Errors occurred, no packages were upgraded.

なぜこれが起こるというと: pacman がファイル衝突を検知して、あなたのために、故意に、ファイルを上書きしないようにしているからです。これは仕様であり、欠陥ではありません。

この問題は簡単に解決できます。安全な方法は初めに他のパッケージがファイルを使っていないか確認する ({{ic|pacman -Qo ''/path/to/file''}}) ことです。ファイルが他のパッケージによって使われている場合、[[バグ報告ガイドライン|バグレポートをしてください]]。他のパッケージによって使われていない場合、'ファイルシステムに存在している'ファイルの名前を変えてもう一度アップデートしてください。うまくいったならば、そのファイルは削除してかまいません。

pacman やフロントエンドを使わずに手動でプログラムをインストールしたときは、プログラムとファイルを削除して pacman を使って正しく再インストールしなくてはなりません。

全てのパッケージはインストールされるとパッケージのメタデータを含んだ {{ic|/var/lib/pacman/local/$package-$version/files}} ファイルを作ります。このファイルが壊れている（または空だったり見つからない）と、パッケージをアップデートしようしたときに "file exists in filesystem" エラーが出ます。このようなエラーは大抵一つのパッケージだけが関わっていて、手動で名前を変更してその後削除する代わりに、{{ic|pacman -S --overwrite glob パッケージ名}} で pacman に glob に一致するファイルを上書きさせることができます。

{{Warning|一般的に --overwrite スイッチの使用は避けてください。}}

===パッケージのインストール時にこんなエラーが出ました: "not found in sync db"===

まず、パッケージが本当に存在しているか確認しましょう（打ち間違いも見逃さずに！）。パッケージが存在しているのなら、あなたのパッケージリストが古くなっているかリポジトリが正しく設定されていない可能性があります。{{ic|pacman -Syy}} で全てのパッケージリストを更新してください。

===パッケージをインストールする時にエラーが表示されます: "target not found"===

まず、パッケージが本当に存在するか確認してください (typo がないかよく見てください)。確かにパッケージが存在する場合、パッケージリストが古くなっていたりあなたの使っているリポジトリが正しく設定されていない可能性があります。{{ic|pacman -Syy}} を実行して強制的に全てのパッケージリストを更新してみましょう。

また、パッケージが含まれているリポジトリがあなたのシステムで有効になっていないのかもしれません。例えば、パッケージは ''multilib'' リポジトリにあるが、''multilib'' が {{ic|pacman.conf}} で有効になっていないということが考えられます。

=== pacman の手動再インストール ===

==== pacman-static を使用====

{{AUR|pacman-static}} は pacman を静的にコンパイルしたものなので、システム上のライブラリが動作していなくても実行できます。これは、 [https://wiki.archlinux.jp/index.php/%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9#.E9.83.A8.E5.88.86.E7.9A.84.E3.81.AA.E3.82.A2.E3.83.83.E3.83.97.E3.82.B0.E3.83.AC.E3.83.BC.E3.83.89.E3.81.AF.E3.82.B5.E3.83.9D.E3.83.BC.E3.83.88.E3.81.95.E3.82.8C.E3.81.A6.E3.81.84.E3.81.BE.E3.81.9B.E3.82.93 部分的なアップグレード] が実行され、 pacman が実行できなくなった場合にも便利です。

固定コメントと PKGBUILD は、バイナリを直接ダウンロードする方法を提供し、 pacman を再インストールしたり、部分的なアップグレードの場合にシステム全体をアップグレードしたりするために使用できます。

==== 外部の pacman を使用する ====

{{ic|pacman-static}} でさえ動作しない場合は、外部の pacman を使用してリカバリできます。最も簡単な方法の1つは、 [[archiso]] を使用し、 {{ic|--sysroot}}} または {{ic|--root}} を使用してマウントポイントを指定する方法です。 {{ic|--sysroot}} に必要なファイルシステムをマウントする方法については、 [[Chroot#chrootの使用]] を参照してください。

==== 手動で抽出する ====

{{Warning|以下の方法でシステムをさらに再起不能にまで壊してしまう可能性があります。[[#アップグレード中に Pacman がクラッシュしました]]に書かれている方法で直らない場合の最後の手段として使ってください。}}

''pacman'' がどうしようもなく破壊されたとしても、最新のパッケージを手動でダウンロードして適切な場所に展開することで修復が可能です。以下のような手順で行います:

#インストールするパッケージを確認
#適当なミラーからパッケージをそれぞれダウンロード
#パッケージをルートディレクトリに展開
#{{ic|pacman -S --force}} でパッケージを再インストールしてパッケージデータベースを更新
#フルシステムアップグレードを実行

問題なく動く Arch 環境があるのであれば、以下のコマンドで依存パッケージのリストを確認できます:

$ pacman -Q $(pactree -u pacman)

問題によってはアップデートしなくてはならないパッケージは少数かもしれません。パッケージは以下のようにして展開します:

# tar -xvpwf ''package.tar.xz'' -C / --exclude .PKGINFO --exclude .INSTALL --exclude .MTREE --exclude .BUILDINFO

{{ic|w}} フラグを使ってインタラクティブモードにしていることに注意してください。インタラクティブで実行しないと重要なファイルを誤って上書きしてしまう可能性があります。また、パッケージは適切な順番で展開するようにしてください。[https://bbs.archlinux.org/viewtopic.php?id=95007 こちらのフォーラムの投稿] には ''pacman'' の一部の依存パッケージだけが壊れた時の解決方法の例が載っています。

===アップグレード中に Pacman がクラッシュしました===

パッケージの削除・再インストール・アップグレード中に "database write" エラーを残して pacman がクラッシュする場合:

#Arch インストールメディアを使って起動してください。
#root でルートファイルシステムをマウントします ({{ic|mount /dev/sdaX /mnt}})。{{ic|df -h}} で十分な空き容量があることを確認してください。
#proc, sys, dev ファイルシステムもマウントしてください: {{ic|mount -t proc proc /mnt/proc; mount --rbind /sys /mnt/sys; mount --rbind /dev /mnt/dev}}。
#システムがデフォルトのデータベースとディレクトリの場所を使っている場合、root で {{ic|1=pacman --root=/mnt --cachedir=/mnt/var/cache/pacman/pkg -Syyu}} を実行することでシステムの "pacman" データベースを更新してアップグレードすることができます。
#アップグレード後、アップグレードがないことと壊れているパッケージを確認してください: {{ic|find /mnt/usr/lib -size 0}}。
#{{ic|1=pacman --root /mnt --cachedir=/mnt/var/cache/pacman/pkg -S ''package''}} で壊れているパッケージを再インストールしてください。

==== pacman: command not found ====

pacmanのキャッシュディレクトリをシンボリックリンクしてはいけません。
代わりに別のキャッシュディレクトリを構成するか、バインドマウントを使用してください。
[https://bbs.archlinux.org/viewtopic.php?id=241213]

==="make install" を使ってソフトウェアをインストールしましたが、ファイルがどのパッケージにも属していません===

"conflicting files" エラーが出る場合、{{ic|--force}} スイッチをつけると pacman が手動でインストールしたソフトウェアを上書きします ({{ic|pacman -S --force}})。ファイルシステム中の''所有されていない''ファイルを検索するスクリプトについては [[Pacman ヒント#ファイルがどのパッケージにも所有されていないことを確認]] を見て下さい。
{{Warning|{{ic|--force}} スイッチを使う時は気をつけてください。間違った使用で重大な問題が発生することがあります。Arch ニュースで使うように指示が出ている時にだけ使うことを推奨します。}}

===システムをアップグレードした後、再起動すると "unable to find root device" エラーが出て起動できません===

おそらく initramfs がカーネルアップデート中に破損しています(不正に {{ic|--force}} オプションを使うと起こりえます)。2つの解決方法があります:

'''1.''' ''Fallback'' エントリを試す:

{{Tip|いずれの理由でエントリを削除した場合でも、ブートローダのメニューが表示された時に {{ic|Tab}} キー ([[Syslinux]] の場合) や {{ic|e}} ([[GRUB]] や [[systemd-boot]] の場合) を押して、{{ic|initramfs-linux-fallback.img}} に名前を変更して {{ic|Enter}} や {{ic|b}} を押して（ブートローダによる）新しいパラメータを使って起動できます。}}

システムが起動したら、コンソールかターミナルから次のコマンド (持ち合わせの {{Pkg|linux}} カーネル用)を入力して initramfs イメージを再生成します:

{{bc|# mkinitcpio -p linux}}

'''2.''' それが機能しない場合は、現在の Arch リリース（CD/DVDまたはUSBスティック）から、ルートパーティションとブートパーティションをマウントします。次に、chroot します。

# arch-chroot /mnt
# pacman -Syu mkinitcpio systemd linux

{{Note|
* もしあなたが現在のリリースを持っていなかったり、他の "Live" Linux ディストリビューションを持っていないなら、昔ながらの方法で [[chroot]] することができます。もちろん、単に {{ic|arch-chroot}} スクリプトを実行するよりも、より多くの入力が必要になります。
* "pacman" が {{ic|Could not resolve host}} で失敗した場合は、 [https://wiki.archlinux.jp/index.php/%E3%83%8D%E3%83%83%E3%83%88%E3%83%AF%E3%83%BC%E3%82%AF%E8%A8%AD%E5%AE%9A#.E6.8E.A5.E7.B6.9A.E3.81.AE.E7.A2.BA.E8.AA.8D 接続の確認] をクリックしてください。
* arch-chroot または chroot 環境に入れないが、パッケージを再インストールする必要がある場合は、ルートパーティションで "pacman" コマンド {{ic|pacman--sysroot/mnt-Syu foo bar}} を使用できます。}}

カーネル ({{Pkg|linux}} パッケージ) を再インストールすると、自動的に {{ic|mkinitcpio-p linux}} で initramfsイメージが再生成されます。これを個別に行う必要はありません。

その後、{{ic|exit}}、{{ic|umount/mnt/{boot,} }} および {{ic|reboot}} を実行してください。

===signature from "User <email@gmail.com>" is unknown trust===

以下の方法を試してみてください:

*{{ic|pacman-key --refresh-keys}} で既知のキーを更新してください。
*手動で {{ic|archlinux-keyring}} パッケージをアップグレードしてください: {{ic|pacman -Sy archlinux-keyring && pacman -Su}}。
*[[pacman-key#全ての鍵のリセット]]に従って下さい。

===PGP 鍵のインポートが要求される===

古いバージョンの ISO で Arch を[[インストールガイド|インストール]]しようとすると、PGP 鍵のインポートが要求されることがあります。鍵のダウンロードに同意して先に進んでください。PGP 鍵を追加できない場合、キーリングを更新したり {{Pkg|archlinux-keyring}} をアップグレードしてください ([[#signature from "User <email@gmail.com>" is unknown trust|上]]を参照)。

===エラー: key "0123456789ABCDEF" could not be looked up remotely===

パッケージが {{Pkg|archlinux-keyring}} に最近追加された新しい鍵で署名されている場合、アップグレード時にはまだローカルで鍵が利用できない状態になっていることがあります (鶏が先か、卵が先か)。インストール済みの {{Pkg|archlinux-keyring}} に鍵が含まれていない場合、Pacman は鍵サーバーを確認しにいきますが、プロキシやファイアウォールを使っているなどの理由でエラーになることがあります。[[#signature from "User <email@gmail.com>" is unknown trust|上]]で書かれているように {{Pkg|archlinux-keyring}} を先にアップグレードしてください。

===signature from "User <email@archlinux.org>" is invalid===

システム[[時刻]]が間違っていると、署名鍵が期限切れとして扱われたりパッケージの署名チェックが失敗して、以下のようなエラーが表示されます:

error: ''package'': signature from "User <email@archlinux.org>" is invalid
error: failed to commit transaction (invalid or corrupted package (PGP signature))
Errors occured, no packages were upgraded.

パッケージをインストール・アップグレードする前に　{{ic|ntpd -qg}} と {{ic|hwclock -w}} を root で実行して下さい。

==="failed to commit transaction (invalid or corrupted package)" エラー===

{{ic|/var/cache/pacman/pkg}} にある {{ic|*.part}} ファイル (部分ダウンロードファイル) を探して、ファイルを削除して下さい ({{ic|pacman.conf}} で {{ic|XferCommand}} を設定しているとこのエラーがよく起こります)。

# find /var/cache/pacman/pkg/ -iname "*.part" -exec rm {} \;

===pacman を使うたびにエラーが表示されます: 'warning: current locale is invalid; using default "C" locale'===

そのエラーは、あなたの locale が正しく設定されていないと言っています。[[ロケール]]を見て下さい。

===pacman でプロキシ設定を使うにはどうすればいいですか？===

環境変数 ({{ic|$http_proxy}}, {{ic|$ftp_proxy}} など) を使って下さい。[[sudo]] と一緒に Pacman を使う時は、[[sudo#環境変数|環境変数を pacman に渡すように]] sudo を設定してください。

===明示的にインストールしたか依存でインストールしたかの情報を保ちながら、全てのパッケージを再インストールするにはどうすればいいですか===

ネイティブのパッケージを全て再インストールするには: {{ic|<nowiki>pacman -Qnq | pacman -S -</nowiki>}} ({{ic|-S}} オプションはデフォルトでインストールの理由を維持します)。

次に自分で作成したパッケージを全て再インストールしてください、{{ic|pacman -Qmq}} でパッケージを確認できます。

===パッケージのダウンロード時にフリーズする===

''pacman'' がリポジトリのアップデートや同期をできないというネットワークの問題がいくつか報告されています [https://bbs.archlinux.org/viewtopic.php?id=68944] [https://bbs.archlinux.org/viewtopic.php?id=65728]。Arch Linux のインストール時にこの問題が発生する場合、''pacman'' のデフォルトのファイルダウンローダを置き換えることで解決します (詳しくは [[pacman のパフォーマンスの向上]]を参照)。[[VirtualBox]] で Arch Linux をゲスト OS としてインストールする時にこの問題が起こる場合、マシンのプロパティで ''NAT'' の代わりに ''Host interface'' を使うことで解決します。

===Failed retrieving file 'core.db' from mirror===

[[ミラー]]を正しく設定しているのにこのエラーメッセージが表示される場合、[[Resolv.conf|ネームサーバ]]を設定してみてください。

==参照==

*[https://www.archlinux.org/pacman/ Pacman ホームページ]
*{{man|3|libalpm}}
*{{man|8|pacman}}
*{{man|5|pacman.conf}}
*{{man|8|repo-add}}

Snapper

2022-01-10T14:48:23Z

Funcrab: lessのgg（最初に戻る）よりもq（exit）の方が実用的なので変更

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは '''{{ic|snapper rollback}} を使用することは想定していません'''が、[[#/ を @ のスナップショットに復元|/ を @ のスナップショットに復元]]した時の問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、ファイルの最初に戻りたいときは {{ic|gg}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Snapper

2022-01-10T14:46:53Z

Funcrab: /* {{ic|/}} を {{ic|@}} のスナップショットに復元 */ lessNoexit

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは '''{{ic|snapper rollback}} を使用することは想定していません'''が、[[#/ を @ のスナップショットに復元|/ を @ のスナップショットに復元]]した時の問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、終了するときは {{ic|q}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Snapper

2022-01-10T14:31:03Z

Funcrab: /* 推奨ファイルシステムレイアウト */ snapper rollbackコマンドを想定しない旨を強調しスナップショット復元方法へのリンクを追加

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは '''{{ic|snapper rollback}} を使用することは想定していません'''が、[[#/ を @ のスナップショットに復元|/ を @ のスナップショットに復元]]した時の問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、ファイルの最初に戻りたいときは {{ic|gg}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Snapper

2022-01-10T12:57:45Z

Funcrab: /* {{ic|/}} を {{ic|@}} のスナップショットに復元 */ vi から cat+lessを使用する形に変更

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは {{ic|snapper rollback}} を使用することは想定していませんが、コマンドで {{ic|/}} をリストアしたときの問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|less}} を使ってファイルを確認できます:
# cat /mnt/@snapshots/*/info.xml {{!}} less
次のページを見たいときは {{ic|space}} を、ファイルの最初に戻りたいときは {{ic|gg}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Picom

2022-01-04T16:53:46Z

Funcrab: /* マルチディスプレイ */ 英語版を反映

[[Category:X サーバー]]
[[Category:視覚効果]]
[[en:Picom]]
[[ko:Compton]]
[[ru:Compton]]
[[zh-hans:Compton]]
[https://github.com/yshui/picom Picom] は軽量なスタンドアロン型のコンポジットマネージャです。コンポジット機能が含まれていない [[Xorg]] の[[ウィンドウマネージャ]]を使っている場合に向いています。Picom は [https://github.com/chjj/compton/ compton] のフォークであり、compton は [http://oliwer.net/xcompmgr-dana/ xcompmgr-dana] のフォークですが、xcompmgr-dana は [[xcompmgr]] のフォークです。

Picom は大量にあった先行者のバグを修正していることで特に有名で、信頼性があり安定しているということで人気があります。他にも、高速な GLX (OpenGL) バックエンド (デフォルトでは無効になっています) やデフォルトのアクティブ・インアクティブウィンドウの透過、ウィンドウの枠の透過、ウィンドウの背景のブラー、ウィンドウの色の反転、描画レートの調整、垂直同期、条件で分岐する細かい制御、設定ファイルの読み込み、D-Bus の制御など、多数の改善や設定オプションが実装されています。

== インストール ==

{{Pkg|picom}} パッケージをインストールしてください。[[git]] 版を使う場合、{{AUR|picom-git}} をインストールしてください。また、[[Qt]] ベースの設定 GUI を {{AUR|compton-conf}} または {{AUR|compton-conf-git}} をインストールすることで使うことができます。

== 設定 ==

デフォルトの設定は {{ic|/etc/xdg/picom.conf}} にあります。 {{ic|~/.config/picom.conf}} や {{ic|~/.config/picom/picom.conf}}、{{ic|~/.picom.conf}} にコピーしてカスタマイズできます。

picom でカスタム設定ファイルを使うには、次のコマンドを使用:

$ picom --config ''path/to/''picom.conf

=== 一部ウィンドウの影を無効化 ===

picom が影を描画することによって、一部のアプリケーションでは見た目がおかしくなってしまうことがあります。{{ic|shadow-exclude}} オプションで picom の影を無効にできます。現在無効になっているウィンドウについては [https://projects.archlinux.org/svntogit/community.git/tree/trunk/compton.conf?h=packages/compton#n80] を見てください。

メニューの影を無効化するには {{ic|picom.conf}} wintypes に以下を追加してください:

# menu = { shadow = false; };
dropdown_menu = { shadow = false; };
popup_menu = { shadow = false; };
utility = { shadow = false; };

=== 透過 ===

選択・非選択ウィンドウの透過率を設定するには、以下を {{ic|picom.conf}} に追加 (例: ターミナルエミュレータ):

opacity-rule = [
"90:class_g = 'URxvt' && focused",
"60:class_g = 'URxvt' && !focused"
];

[[#タブ化したウィンドウ (影と透過)]]も見てください。

== 使用方法 ==

Picom はいつでも手動で有効化・無効化することができます。また、バックグラウンドで自動起動 ([[デーモン]]) することも可能です。また、コンポジット効果を設定できる任意の引数もあります。引数の一部:

* {{ic|-b}}: バックグラウンドプロセス ([[デーモン]]) で実行 (例: [[Openbox]] などの[[ウィンドウマネージャ]]で自動起動する場合)
* {{ic|-c}}: 影効果を有効化
* {{ic|-C}}: パネルとドックの影効果を無効化
* {{ic|-G}}: アプリケーションウィンドウとドラッグアンドドロップオブジェクトの影効果を無効化
* {{ic|--config}}: 指定した設定ファイルを使用

他にも、タイミングの設定や、管理するディスプレイ、メニューやウィンドウの縁、インアクティブアプリケーションメニューの透過度など多数のオプションが存在します。詳しくは {{man|1|picom}} を見て下さい。

{{Note|他の[[コンポジットマネージャ]]が動作している場合、''picom'' を起動する前に無効化してください。}}

セッション中にデフォルトのコンポジット効果を手動で有効化するには、次のコマンドを使用:

$ picom

また、影効果を全て無効化するには、{{ic|-C}} と {{ic|-G}} 引数を追加します:

$ picom -CG

バックグラウンドプロセス ([[デーモン]]) として picom を自動起動するには、{{ic|-b}} 引数を使います:

$ picom -b

[[デーモン]]プロセスの影効果を全て無効化するには、{{ic|-C}} と {{ic|-G}} 引数を追加:

$ picom -CGb

以下は引数を追加して必要な値を設定した例です:

$ picom -cCGfF -o 0.38 -O 200 -I 200 -t 0 -l 0 -r 3 -D2 -m 0.88

== マルチディスプレイ ==
xinerama を使わずに[[マルチディスプレイ]]の設定をしている場合 (複数のスクリーンで X サーバーを実行している場合)、デフォルトでは picom は一つのスクリーンでしか起動しません。{{ic|DISPLAY}} 環境変数を使うことで全てのスクリーンで実行させることができます。
例えば、バックグラウンドで X スクリーン 0 で実行する場合：

DISPLAY=":0" picom -b

上記はすべてのモニタで動作するはずですが、動作しない場合は手動で各モニタを指定する古い方法を試してみてください。

seq 0 3 | xargs -l1 -I@ picom -b -d :0.@

== トラブルシューティング ==
最近のバージョンの picom には DRI2 アクセラレーションに問題があり、DRI2 を使っているときにちらつきが発生していました ([https://github.com/yshui/picom/issues/47 picom バグ], [https://bugs.freedesktop.org/show_bug.cgi?id=108651 mesa バグ])。対処策によって問題は解決していますが、一部のユーザーにはまだ問題が残っているという報告があります。DRI3 にはこのような問題はありません。

他のアプリケーションやプログラムで正しい設定をしていない場合、コンポジット効果を有効にすることで外観がおかしくなる問題が発生することがあります。

=== Conky ===

[[Conky]] のウィンドウの影を無効化するには、{{ic|~/.conkyrc}} に以下を記述します:

own_window_class conky

=== dwm と dmenu===

dwm のステータスバーは picom の関数から検出されず、自動的にウィンドウマネージャのエレメントが除外されることはありません。また、dwm のステータスバーと dmenu のどちらもウィンドウ id は固定されていません。ステータスバーがウィンドウ透過しないようにしたい場合、ソースコードのウィンドウクラスにパッチをあてるか、他の属性を使って除外してください。dmenu と dwm のステータスバーを上部に表示している場合、位置によって指定することができます:
$ picom <any other arguments> --focus-exclude "x = 0 && y = 0 && override_redirect = true"

もしくは、設定ファイルを使う場合:
focus-exclude = "x = 0 && y = 0 && override_redirect = true";

上書きリダイレクトプロパティは大抵のウィンドウでは false になっています。それによって左下に配置された他のウィンドウが除外されることを防げます (例えば、dwm ステータスバーが非表示になった場合、x0 y0 は dwm のマスタースタックにある全てのウィンドウにマッチします)。

=== Firefox ===

[[#一部ウィンドウの影を無効化]]を見てください。

Firefox の部品の影を無効化するには {{ic|picom.conf}} の shadow-exclude に以下を追加します:

"class_g = 'firefox' && argb",

詳しくは [https://github.com/chjj/compton/issues/201#issuecomment-45288510] を参照。

=== Slock ===
インアクティブウィンドウの透過を有効にしている場合 (コマンドで実行している場合 {{ic|-i}} 引数)、[[アプリケーション一覧/セキュリティ#スクリーンロック|slock]] を使っているときに問題が発生します。透過度を {{ic|0.2}} にすることで解決します。例えばコマンドで picom を実行する場合:

$ picom <any other arguments> -i 0.2

または、設定ファイルを使う場合:

inactive-dim = 0.2;

もしくは、slock のウィンドウ ID を使用して slock を除外したり、名前がないウィンドウを全て除外する方法もあります。
{{note|プログラムによっては新しいインスタンスを起動するたびに id を変化させるものもありますが、slock の id は固定されています。}}
名前がないウィンドウを全て picom から除外するには:
$ picom <other arguments> --focus-exclude "! name~=''"
次のコマンドを実行することで slock のウィンドウ id を確認できます:
$ xwininfo & slock
画面の何処かを (slock が終了する前に) 素早くクリックして、パスワードを入力してロックを解除してください。以下のようにウィンドウ id が出力されます:
xwininfo: Window id: 0x1800001 (has no name)
取得できたウィンドウ id を使って picom から除外するには:
$ picom <any other arguments> --focus-exclude 'id = 0x1800001'
もしくは、設定ファイルを使う場合:
focus-exclude = "id = 0x1800001";

=== ちらつき ===

デフォルトの {{ic|picom.conf}} を使っているときに最大化されたウィンドウでちらつきが発生する場合、以下のオプションで解決できます:

unredir-if-possible = false;

詳しくは [https://github.com/chjj/compton/issues/402] を参照。

=== フルスクリーン画面でティアリングが発生する ===

フルスクリーンでビデオ再生するとティアリングが発生する場合、[[Picom#ちらつき|ちらつき]] を参照してください。

=== xft フォントを使用した場合にラグが発生する ===

[[xterm]] や [[urxvt]] などのアプリケーションで Xft フォントを使用した場合に酷いラグが発生する場合、以下のオプションを使ってみてください:

--xrender-sync --xrender-sync-fence

もしくは xrender バックエンドを使ってみてください。

詳しくは [https://github.com/chjj/compton/issues/152] を参照。

=== AMD の Catalyst ドライバーを使ってる場合に画面に問題が発生する ===
次の引数を付けて picom を起動するか:

--backend xrender

{{ic|picom.conf}} ファイルに以下を追加してください:

backend = "xrender";

詳しくは https://github.com/chjj/compton/issues/208 を参照。

=== タブ化したウィンドウ (影と透過) ===

透過されたウィンドウがタブ化されているとき、下のタブになっているウィンドウが見えてしまいます。タブ化されたウィンドウそれぞれが影を描画するため、影が重なります。

既存の [https://projects.archlinux.org/svntogit/community.git/tree/trunk/compton.conf?h=packages/compton#n80 shadow-exclude リスト] に以下を追加することで重複する影の問題を解決できます:

"_NET_WM_STATE@:32a *= '_NET_WM_STATE_HIDDEN'"

また、{{ic|picom.conf}} に以下を追加することで下のタブになっているウィンドウを描画しないようにできます:

opacity-rule = [
"95:class_g = 'URxvt' && !_NET_WM_STATE@:32a",
"0:_NET_WM_STATE@[0]:32a *= '_NET_WM_STATE_HIDDEN'",
"0:_NET_WM_STATE@[1]:32a *= '_NET_WM_STATE_HIDDEN'",
"0:_NET_WM_STATE@[2]:32a *= '_NET_WM_STATE_HIDDEN'",
"0:_NET_WM_STATE@[3]:32a *= '_NET_WM_STATE_HIDDEN'",
"0:_NET_WM_STATE@[4]:32a *= '_NET_WM_STATE_HIDDEN'"
];

{{ic|URxvt}} はあなたが使っているターミナルの Xorg クラスに置き換えてください。{{ic|xprop WM_CLASS}} コマンドを実行してからウィンドウをクリックすることでウィンドウのクラスを確認できます。

詳しくは [https://www.reddit.com/r/unixporn/comments/330zxl/webmi3_no_more_overlaying_shadows_and_windows_in/] を参照。

{{Warning|i3 と kitty を使っている場合、i3 のリロード時に全ての kitty のタブ化されたインスタンスがフリーズします (2019年6月4日現在) [https://github.com/kovidgoyal/kitty/issues/1681]。}}

=== xsetroot で背景色が変えられない ===
現在、picom は {{ic|xsetroot}} の {{ic|-solid}} オプションと互換性がありません。解決方法としては {{Pkg|hsetroot}} を使って背景色を設定するようにしてください:

$ hsetroot -solid '#000000'

詳しくは https://github.com/chjj/compton/issues/162 を参照。

=== NVIDIA のプロプライエタリドライバーでちらつきが発生する ===
{{ic|picom.conf}} で以下のように設定してみてください:
vsync = "opengl"

=== Nvidia のプロプライエタリドライバーと FullCompositionPipeline でラグが発生する ===

[[#AMD の Catalyst ドライバーを使ってる場合に画面に問題が発生する]] を見てください。

=== Nvidia のプロプライエタリドライバーで Xorg によって GPU のメモリリークが発生する ===

[[#AMD の Catalyst ドライバーを使ってる場合に画面に問題が発生する]] を見てください。

=== サスペンド後の Slock ===
systemd サービスを使ってサスペンド・ハイバネート時に slock を起動している場合、復帰後に画面のロックが解除されてしまうことがあります。問題を解決するには、ウィンドウフェーディングを無効化してください:
$ picom --no-fading-openclose

== 参照 ==

*[https://ubuntuforums.org/showthread.php?t=2144468&p=12644745#post12644745 Howto: Using Picom for tear-free compositing on XFCE or LXDE]

Snapper

2022-01-02T19:52:22Z

Funcrab: /* boot パーティションのバックアップ */ 英語版を反映

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/etc/pacman.d/hooks/50-bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Path
Target = usr/lib/modules/*/vmlinuz

[Action]
Depends = rsync
Description = Backing up /boot...
When = PostTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは {{ic|snapper rollback}} を使用することは想定していませんが、コマンドで {{ic|/}} をリストアしたときの問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|vi}} を使ってファイルを確認できます:
# vi /mnt/@snapshots/*/info.xml
次のファイルを見たいときは {{ic|:n}} を、最初のファイルに戻りたいときは {{ic|:rew}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Solo

2021-12-31T13:21:06Z

Funcrab: 英語版へのリンクを追加

[[Category:Universal 2nd Factor]]
[[en:Solo]]
{{Related articles start}}
{{Related|Universal 2nd Factor}}
{{Related articles end}}

The [https://solokeys.com/ Solo] is an open-source FIDO2 security key. This article describes how to set up and use it.

== Introduction ==

The Solo (or SoloKey) is a small [[Wikipedia:Security token|USB Security token]] supporting [[Wikipedia:Universal_2nd_Factor|Universal 2nd Factor]] (U2F) requests, thus acting as a second factor for authentication. It also supports the newer [[Wikipedia:FIDO2 Project|FIDO2]] standard allowing for passwordless logins.

Compared to a [[YubiKey]] it offers less features but supports firmware upgrades to extend the functionality in the future. Both hardware and software are released as open source.

== Installation ==

Special drivers are not required for the key to work. It is recommended to install the Solo software and upgrade the firmware of your Solo.

=== Upgrading the firmware ===

Managing your Solo, e.g. upgrading the firmware or setting a PIN, requires the {{AUR|solo-python}} package. After installing the package, first check if your key is detected.

{{hc|$ solo ls|:: Solos
123456XXXXXX: SoloKeys Solo 3.0.1}}

Then you can use {{ic|solo key update}} to perform a firmware upgrade, {{ic|solo key set-pin}} to set a PIN, and {{ic|solo key change-pin}} to change your pin.

=== Test the Solo in your browser ===

Visit the [https://webauthn.io/ Webauthn demo], type in a username and click on "Register". Your Solo's LED will flash until you click it. After that, you can login to the page only using your Solo, no need for username or password.

== See also ==

* [https://solokeys.com/ SoloKeys Official Website]
* [https://docs.solokeys.io/solo/ Solo Technical Documentation]

Snapper

2021-12-21T11:49:37Z

Funcrab: /* 推奨ファイルシステムレイアウト */ 英語版を反映

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/usr/share/libalpm/hooks/50_bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Package
Target = linux*

[Action]
Depends = rsync
Description = Backing up /boot...
When = PreTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは {{ic|snapper rollback}} を使用することは想定していませんが、コマンドで {{ic|/}} をリストアしたときの問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです。

{| class="wikitable"
|+ ファイルシステムレイアウト
! サブボリューム !! マウントポイント
|-
| @ || /
|-
| @home || /home
|-
| @snapshots || /.snapshots
|-
| @var_log || /var/log
|}

subvolid=5
|
├── @ -|
| 含まれるディレクトリ:
| ├── /usr
| ├── /bin
| ├── /.snapshots
| ├── ...
|
├── @home
├── @snapshots
├── @var_log
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|vi}} を使ってファイルを確認できます:
# vi /mnt/@snapshots/*/info.xml
次のファイルを見たいときは {{ic|:n}} を、最初のファイルに戻りたいときは {{ic|:rew}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Pacman

2021-12-20T15:04:51Z

Funcrab: /* パッケージ・データベースに問い合わせる pacman -Fo ⇒ pacman -F コマンド表記を英語版に合わせた

[[Category:パッケージ管理]]
[[Category:Arch プロジェクト]]
[[Category:コマンド]]
[[ar:Pacman]]
[[cs:Pacman]]
[[da:Pacman]]
[[de:Pacman]]
[[el:Pacman]]
[[en:Pacman]]
[[es:Pacman]]
[[fa:Pacman]]
[[fr:Pacman]]
[[id:Pacman]]
[[it:Pacman]]
[[ko:Pacman]]
[[nl:Pacman]]
[[pl:Pacman]]
[[pt:Pacman]]
[[ru:Pacman]]
[[sr:Pacman]]
[[sv:Pacman]]
[[zh-hans:Pacman]]
[[zh-hant:Pacman]]
{{Lowercase title}}
{{Related articles start}}
{{Related|パッケージの作成}}
{{Related|パッケージのダウングレード}}
{{Related|Pacman のパフォーマンスの向上}}
{{Related|Pacman GUI フロントエンド}}
{{Related|Pacman 比較表}}
{{Related|Pacman ヒント}}
{{Related|FAQ#パッケージ管理}}
{{Related|pacman-key}}
{{Related|Pacnew と Pacsave ファイル}}
{{Related|Pacman/ローカルデータベースの復元}}
{{Related|アプリケーション一覧/ユーティリティ#パッケージ管理}}
{{Related|Arch Build System}}
{{Related|公式リポジトリ}}
{{Related|Arch User Repository}}
{{Related articles end}}

'''[https://www.archlinux.org/pacman/ pacman]''' [[Wikipedia:ja:パッケージ管理システム|パッケージマネージャ]]は Arch Linux の主要な機能のひとつです。pacman はシンプルなバイナリのパッケージ形式と簡単に利用できる[[Arch Build System|ビルドシステム]]から成っています。pacman のゴールはパッケージ管理を楽にすることであり、[[公式リポジトリ|公式 Arch リポジトリ]]にあるパッケージや、ユーザー自身が作成したパッケージを容易に管理することができます。

Pacman はマスターサーバーと同期してシステムを最新に保ちます。このサーバー・クライアントモデルによって、シンプルなコマンドだけで必要な依存性を解決してパッケージのダウンロード・インストールをすることができます。

Pacman は C 言語で書かれており {{ic|.pkg.tar.xz}} パッケージフォーマットを使います。

{{Tip|1=公式の {{Pkg|pacman}} パッケージには [[makepkg]] や '''vercmp''' などのツールが含まれています。'''pactree''' や [[#部分的なアップグレードはサポートされていません|checkupdates]] など他の有用なツールは {{Pkg|pacman-contrib}} パッケージに含まれています([https://git.archlinux.org/pacman.git/commit/?id=0c99eabd50752310f42ec808c8734a338122ec86 以前] は pacman パッケージに含まれていました)。ツールの一覧を見るには {{ic|pacman -Ql pacman pacman-contrib {{!}} grep -E 'bin/.+'}} を実行してください。 }}

==使い方==

pacman で何ができるかをちゃんと学びたい場合、{{man|8|pacman}} を参照してください。以下にあるのは pacman でできることのほんの一例です。

{{Tip|他の Linux ディストリビューションを使ったことがある場合、[[Pacman 比較表]]の記事が役に立つでしょう。}}

===パッケージのインストール===

{{Note|
* パッケージには [[PKGBUILD#optdepends|optdepends]] が設定されていることがあります。必ずインストールする必要はありませんが、インストールすることで機能が追加されます。[[#パッケージ・データベースに問い合わせる|パッケージ・データベースに問い合わせる]]ことで情報を参照することができます。
* 他のパッケージの依存パッケージとしてパッケージをインストールする場合 (そのパッケージ自体は必要としていない場合)、{{ic|--asdeps}} オプションを使用することを推奨します。詳しくは[[#インストール理由|インストール理由]]を参照。}}

{{Warning|1=パッケージのインストールをする際に、[[#パッケージのアップグレード|アップグレード]]をせずにパッケージリストを更新しないでください (つまり {{ic|pacman -Sy ''パッケージ名''}} をしてはいけない)。これを実行すると依存関係に問題がおこる可能性があります。[[#部分的なアップグレードはサポートされていません]] や https://bbs.archlinux.org/viewtopic.php?id=89328 を参照。}}

====特定のパッケージのインストール====

ひとつ、あるいは複数の（依存を含む）パッケージをインストールするときは:

# pacman -S ''パッケージ名1'' ''パッケージ名2'' ...

異なるリポジトリにそれぞれ同じ名前のパッケージが存在することがあります (例: [extra] リポジトリと [testing] リポジトリ)。このような場合、どちらをインストールするかを明示してください:

# pacman -S extra/''パッケージ名''

名前に類似パターンが存在するパッケージをインストールしたい場合 (グループ全体ではなくマッチするパッケージのみ、例: {{Grp|plasma}}):

# pacman -S plasma-{desktop,mediacenter,nm}

もちろん、必要に応じて更に複雑なパターンを指定することもできます:

# pacman -S plasma-{workspace{,-wallpapers},pa}

====パッケージグループのインストール====

パッケージグループに属しているパッケージを同時にインストールすることができます。例えば:

# pacman -S gnome

を実行すると {{Grp|gnome}} グループからインストールしたいパッケージを選択するように表示されます。

パッケージグループには大量のパッケージが含まれており、しばしばインストールしたいパッケージはそのうちの少しだけということがあるかもしれません。インストールするパッケージの番号を全て入力するという方法でもよいですが、以下のようにすることで簡単にパッケージを選択することが可能です:

Enter a selection (default=all): 1-10 15

以上で1番から10番までと15番のパッケージがインストールされます。

Enter a selection (default=all): ^5-8 ^2

以上で5番から8番までと2番のパッケージ以外の全てのパッケージをインストールします。

どのパッケージが gnome グループに属しているか見るには:

# pacman -Sg gnome

どのようなパッケージグループがあるかは https://www.archlinux.jp/groups/ を見て下さい。

{{Note|グループの中にインストール済みのパッケージがある場合でも、グループにあわせて再インストールされます。{{ic|--needed}} オプションを使うことで無視できます。}}

===パッケージの削除===

あるパッケージを、そのパッケージが必要としていたものを残したまま削除するには:

# pacman -R ''パッケージ名''

削除したいパッケージと、そのパッケージだけが必要としている他のパッケージを一緒に削除するには:

# pacman -Rs ''パッケージ名''

削除したいパッケージと、そのパッケージが必要としている他のパッケージ、さらに削除したいパッケージに依存しているパッケージを削除するには:

{{Warning|この操作は再帰的です。必要なパッケージを削除してしまうこともあるので、気をつけて使って下さい。}}

# pacman -Rsc ''パッケージ名''

他のパッケージから依存されているパッケージを、依存しているパッケージを削除しないで削除するには:

# pacman -Rdd ''パッケージ名''

デフォルトでは、pacman は削除されたパッケージの設定ファイルを *.pacsave という拡張子をつけてバックアップします。もしこれらのファイルも一緒に削除したい場合:

# pacman -Rn ''パッケージ名''

{{Note|Pacman はパッケージがインストールされた後に作成された設定ファイルを削除しません。$HOME ディレクトリ下の設定ファイルなどは手動で削除してください。}}

===パッケージのアップグレード===

Pacman は以下のコマンドひとつでシステムの全てのパッケージのアップデートができます。システムがどれだけ新しいかによってかかる時間が変わります。このコマンドはリポジトリデータベースと同期して''それから''システムのパッケージをアップデートします(リポジトリにない'ローカル'パッケージは別です):

# pacman -Syu

{{Warning|アップデートがきたらすぐにアップデートしようとする前に、Arch のローリングリリースのことを再確認してください、アップデートが思いがけない結果になることもあります。つまり、重要なプレゼンをやらなくちゃいけないからといってアップデートするのは賢いとは言えません。手の空いた時間に、何が起こっても対処できるように準備をしてからアップデートしましょう。}}

Pacman は強力なパッケージ管理ツールですが、全ての問題を解決できるわけではありません。混乱したのなら [[The Arch Way]] を読んで下さい。ユーザーは用心深くなって、システムのメンテナンスの責任を自分でとらなくてはなりません。'''システムアップデートをしたときは、pacman からの表示を全て読み常識を働かせることが肝要です'''。[[Arch Linux の安定化#Arch のメンテナンス]]を見てください。もし（ユーザーによって作られた）設定ファイルを新しいパッケージのバージョンにあわせて変更する必要があるときは、ユーザーの設定を上書きするのを回避するために {{ic|.pacnew}} ファイルが作られます。Pacman はユーザーにそれらをマージするよう表示します。これらのファイルはユーザーが手動で修正しなくてはなりません。パッケージのアップグレードや削除のあとチェックするのが良いでしょう。詳しくは [[Pacnew と Pacsave ファイル]]を見てください。

{{Tip|
* Pacman からの出力は {{ic|/var/log/pacman.log}} に記録されています。
* {{AUR|wat-git}} などのログビューアを使うことで pacman のログを検索できます。
}}

アップグレードするまえに、[https://www.archlinux.jp/ Arch Linux ホームページ] の最新ニュースをチェックしておくとよいでしょう (もしくは [https://www.archlinux.jp/feeds/ RSS フィード], [https://lists.archlinux.org/listinfo/arch-announce/ arch-announce メーリングリスト]を講読したり Twitter の [https://twitter.com/archlinux_jp @archlinux_jp] をフォローする): アップデートの際にいつもとは違うユーザーの操作が必要になった時 (pacman から与えられる指示だけでは不十分な場合など)、それに関してニュースが作られているはずです。

もし解決できない問題にあたったときは、フォーラムを検索してみましょう。他の人も同じ問題にぶつかり、解決法が投稿されているかもしれません。

====部分的なアップグレードはサポートされていません====

Arch Linux はローリングリリースであり、常に新しいバージョンの[[Wikipedia:ja:ライブラリ|ライブラリ]]がリポジトリにプッシュされます。開発者や Trusted User はライブラリにあわせてリポジトリの全てのパッケージをリビルドします。ローカルでパッケージをインストールした場合 ([[Arch User Repository|AUR]] のパッケージなど)、ユーザーは必要に応じて[[Wikipedia:soname|共有ライブラリ]]にあわせてリビルドしなくてはなりません。

つまり部分的なアップグレードは'''サポートされていません'''。{{ic|pacman -Sy package}} や、それと同等の {{ic|pacman -Sy}} からの {{ic|pacman -S package}} などをしないでください。どんなときでも、パッケージをインストールする前に ({{ic|pacman -Syu}} で) アップグレードしてください。{{ic|IgnorePkg}} や {{ic|IgnoreGroup}} を使用する場合は気をつけて扱って下さい。{{ic|pacman -Sy}} は基本的に使ってはいけないコマンドで、代わりに {{ic|pacman -Syu}} を使って下さい。

一度、部分的なアップグレードがなされると、リンクしていたライブラリが見つからなくなってバイナリが壊れてしまいます。'''シンボリックリンクを張ることでこの問題を"解決"しようとしてはいけません'''。ライブラリは''後方互換性がない''ときには [[Wikipedia:soname|soname]] のバージョンアップに対応します。{{ic|pacman -Syu}} を実行しさえすれば、ミラーと同期して ''pacman'' が壊れていないかぎり問題が修正されます。

インストールされているパッケージのアップグレードを確認したいときは {{Pkg|pacman-contrib}} パッケージに含まれている bash スクリプト '''checkupdates''' を使うことで、システムアップデートを行わずに安全に確認が行えます。

===パッケージ・データベースに問い合わせる===

Pacman からローカルデータベースに問い合わせるときは {{ic|-Q}} フラグを、同期データベースに問い合わせるときは {{ic|-S}} フラグを、ファイルデータベースに問い合わせるときは {{ic|-F}} フラグを使います。それぞれのフラグのサブオプションについては {{ic|pacman -Q --help}}, {{ic|pacman -S --help}}, {{ic|pacman -F --help}} を見てください。

Pacman を使ってパッケージ名と説明の両方をデータベースの検索にかけるには:

$ pacman -Ss ''検索ワード1'' ''検索ワード2'' ...

場合によって {{Ic|-s}} の組み込みの ERE (拡張正規表現) が望まない結果を生むことがあります。そのようなときは検索対象をパッケージ名だけに絞ってみてください:

$ pacman -Ss '^vim-'

既にインストール済みのパッケージから検索するには:

$ pacman -Qs ''検索ワード1'' ''検索ワード2'' ...

リモートパッケージからパッケージファイルの名前で検索するには:

$ pacman -Fs ''検索ワード1'' ''検索ワード2'' ...

パッケージ名が分かっていれば、より詳しい情報を得ることができます:

$ pacman -Si ''パッケージ名''

既にインストールしたパッケージの情報を得るには:

$ pacman -Qi ''パッケージ名''

{{ic|-i}} フラグをふたつ付けることでバックアップファイルの一覧と状態を表示できます:

$ pacman -Qii ''パッケージ名''

あるパッケージによってインストールされたファイルの一覧を得るには:

$ pacman -Ql ''パッケージ名''

リモートパッケージによってインストールされるファイルのリストを得るには:

$ pacman -Fl ''パッケージ名''

あるファイルがどのパッケージによってインストールされたかを調べるには:

$ pacman -Qo ''/パス/ファイル名''

あるファイルがどのリモートパッケージに属しているかデータベースに問い合わせるには:

$ pacman -F ''/パス/ファイル名''

孤立した、他のパッケージに必要とされていないパッケージの一覧を得るには:

$ pacman -Qdt

{{Tip|上記のコマンドを pacman の post-transaction [[#フック|フック]]に追加することで、トランザクションによってパッケージが孤立したときに通知することができます。(明示的にインストールしたのでない限り) リポジトリから消されたパッケージはローカルでは孤児になるため、パッケージがリポジトリから消されたときに知ることができます。孤児が見つからなかったときに "failed to execute command" エラーを表示しないようにするため、フックの {{ic|Exec}} では次のコマンドを使用してください: {{ic|<nowiki>/usr/bin/bash -c "/usr/bin/pacman -Qtd || /usr/bin/echo '=> None found.'"</nowiki>}}。}}

明示的にインストールしたパッケージで、依存関係で必要とされていないパッケージを全て表示するには:

$ pacman -Qet

[[pacman ヒント]]には他の例も載っています。

====Pactree====

パッケージの依存のツリーを見るには:

$ pactree ''パッケージ名''

あるパッケージを必要としている全てのパッケージを見るには [[pkgtools]] の {{ic|whoneeds}} を使います:

$ whoneeds ''パッケージ名''

もしくは ''pactree'' のリバースフラグを使って:

$ pactree -r ''package_name''

====データベースの構造====

通常 pacman のデータベースは {{ic|/var/lib/pacman/sync}} に配置され、{{ic|/etc/pacman.conf}} で指定したリポジトリのデータベースファイルがそこに作成されます。データベースファイルは gzip で圧縮された tar アーカイブになっており、パッケージごとにディレクトリが含まれています。例えば {{Pkg|which}} パッケージの場合:

{{bc|
% tree which-2.20-6
which-2.20-6<nowiki>
|-- depends
`-- desc</nowiki>
}}

{{ic|depends}} ファイルにはパッケージが依存するパッケージのリストが記載されており、{{ic|desc}} にはファイルサイズや MD5 ハッシュなどのパッケージの情報が入っています。

===パッケージキャッシュの削除===

pacman はダウンロードしたパッケージを {{ic|/var/cache/pacman/pkg/}} に保存し、古いバージョンやアンインストールされたパッケージを自動では削除しません。従ってこのフォルダのサイズをあまりにも大きくしすぎないために定期的・計画的にこのフォルダを掃除する必要があります。

現在インストールされていないパッケージキャッシュを全て削除するオプションは:

# pacman -Sc

{{Warning|
* インストールしたパッケージが安定していて、[[パッケージのダウングレード|ダウングレード]]が必要ないときだけ行なって下さい。この操作をするとキャッシュフォルダから全ての古いバージョンを削除するため、現在インストールされているバージョンのパッケージだけが残ります。将来のアップグレードでパッケージが破損したときに古いパッケージが必要になることがあり、バージョンを戻したいと思ったときに、キャッシュに古いパッケージがないと [[Arch Linux Archive]] などから古いパッケージを取得するしか方法がなくなってしまいます。
* {{ic|pacman -Scc}} でキャッシュフォルダを完全に削除することも可能ですが、これはあまり推奨されてはいません。上の欠点に加えて、必要なときにキャッシュフォルダから直接パッケージを再インストールすることができなくなってしまい、再ダウンロードが強いられるためです。よっぽどディスク容量を欲しているとき以外は使うべきではありません。
}}

上記の欠点のため、{{ic|-Sc}} や {{ic|-Scc}} スイッチを使う代わりに、キャッシュから削除するパッケージの数をもっと細かく制御できるスクリプトを使うのが推奨されます:

*{{Pkg|pacman-contrib}} パッケージに入っている ''paccache'' コマンドは、デフォルトでそれぞれのパッケージのキャッシュで一番新しい3つのバージョンを残して後を全て削除します: {{bc|$ paccache -r}} ただし、この方法では ''paccache'' はパッケージがインストールされているかどうかを確認''しない''ため、既にアンインストールしたパッケージも保持されます。アンインストールしたパッケージのキャッシュを全て削除するには、次のコマンドを実行する必要があります: {{bc|$ paccache -ruk0}} 他のオプションは {{ic|paccache -h}} を見て下さい。

*もしくは、{{AUR|pkgcacheclean}} をインストールして使うこともできます: {{bc|# pkgcacheclean}}

{{Tip|1=[[#フック]]を作成して pacman の操作後に上記のコマンドを自動的に実行することができます。サンプルが [https://bbs.archlinux.org/viewtopic.php?pid=1694743#p1694743 こちらのスレッド] に載っています。}}

===追加コマンド===

システムのアップグレードとパッケージのインストール (ワンライナー):

# pacman -Syu ''パッケージ名1'' ''パッケージ名2'' ...

インストールをしないで、パッケージをダウンロードする:

# pacman -Sw ''パッケージ名''

リポジトリに存在しない'ローカル'のパッケージ (例: [[Arch User Repository|AUR]] のパッケージ) をインストール:

# pacman -U /パス/パッケージ名-version.pkg.tar.xz

リポジトリにない、リモートのパッケージを URI を入力してインストール:

# pacman -U <nowiki>http://www.example.com/repo/example.pkg.tar.xz</nowiki>

{{Tip|pacman のキャッシュにローカルパッケージのコピーを残したいときは、次を使って下さい:
{{bc|<nowiki>
# pacman -U file://path/to/package/package_name-version.pkg.tar.xz
</nowiki>}}
}}

{{Warning|{{ic|--force}} スイッチを使う時は細心の注意を払って下さい、誤って使用すると大きな問題が起こる場合があります。Arch ニュースでこのスイッチを使うように指示があってとき''だけ''使用することを強く推奨します。}}

''pacman'' で何か操作を行うときは、必ず、インストールしたり削除したりするパッケージのリストが表示され、権限が要求されます。{{ic|-p}} を使うことで {{ic|-S}}, {{ic|-U}}, {{ic|-R}} などの操作を阻止することができます。

''pacman'' にはシステムの操作を簡単にする多数のユーティリティが入っています。それぞれのユーティリティは {{ic|--help}} スイッチを付けて呼び出すことでコマンドオプションを表示できます。

===インストール理由===

''pacman'' データベースではインストールしたパッケージはインストールしたときの理由によって2つのグループに分別されます:

*'''明示的にインストール''': ''pacman'' の {{ic|-S}} や {{ic|-U}} コマンドによって文字通り指定されたパッケージ。
*'''依存パッケージ''': ''pacman'' のインストールコマンドにパッケージの名前は指定されず、明示的にインストールした他のパッケージから[[PKGBUILD#依存関係|必要]]とされたためにインストールされたパッケージ。

パッケージのインストール時、以下のようにすることでインストール理由を''依存パッケージ''に強制的に変えることができます:

# pacman -S --asdeps ''package_name''

{{Tip|任意の依存パッケージを {{ic|--asdeps}} でインストールすると、[[Pacman ヒント#使用していないパッケージの削除 (孤立したパッケージ)|孤立したパッケージを削除]]するときに ''pacman'' によって任意の依存パッケージも削除されるようになります。}}

パッケージの再インストールを行っても、デフォルトではインストール理由は変更されません。

明示的にインストールしたパッケージのリストは {{ic|pacman -Qe}} で表示でき、依存パッケージのリストは {{ic|pacman -Qd}} で表示できます。

既にインストールしたパッケージのインストール理由を変更したい場合、以下のコマンドを実行:

# pacman -D --asdeps ''package_name''

インストール理由を「明示的にインストール」に変えたいときは {{ic|--asexplicit}} を使ってください。

{{Note|{{ic|pacman -Syu ''package_name'' --asdeps}} のように、アップグレードをするときに {{ic|--asdeps}} や {{ic|--asexplicit}} オプションを使用するのは推奨されません。インストールされるパッケージだけでなく、アップグレードされるパッケージのインストール理由まで変更されてしまうためです。}}

===特定のファイルが含まれているパッケージを検索===

ファイルデータベースを同期してください:

# pacman -Fy

ファイルが含まれているパッケージを検索するには:

$ pacman -Fs pacman
core/pacman 5.0.1-4
usr/bin/pacman
usr/share/bash-completion/completions/pacman
extra/xscreensaver 5.36-1
usr/lib/xscreensaver/pacman

{{Tip|[[cron]] ジョブや [[systemd/タイマー|systemd タイマー]]を設定してファイルデータベースを定期的に同期させることができます。}}

高度な使い方をしたい場合、全てのファイルと関連するパッケージのデータベースを使用する [[pkgfile]] をインストールしてください。

==設定==

pacman の設定は {{ic|/etc/pacman.conf}} に記述されています。ここで pacman がどのように動作するかを決めることができます。より詳しい情報は {{man|5|pacman.conf}} にあります。

===全般設定===

全般的な設定は {{ic|[options]}} セクションにあります。ここで設定されている項目については {{man|5|pacman.conf}} かデフォルトの {{ic|pacman.conf}} を参照してください。

====カラー出力====

[[コンソールのカラー出力#pacman]] を見てください。

==== 並列ダウンロードを有効にする ====

''pacman'' 6.0 はパッケージを同時にダウンロードするオプションを導入しました。この機能を使用するには、{{ic|/etc/pacman.conf}} で {{ic|ParallelDownloads}} を正の整数に (例:{{ic|5}}) など設定する必要があります。このオプションが設定されていない場合、パッケージは順番にダウンロードされます。

====アップデートする前にバージョンを比較====

利用可能なパッケージの新旧バージョンを確認したい場合、{{ic|/etc/pacman.conf}} の "VerbosePkgLists" 行をアンコメントしてください。{{ic|pacman -Syu}} の出力が以下のようになります:

Package (6) Old Version New Version Net Change Download Size

extra/libmariadbclient 10.1.9-4 10.1.10-1 0.03 MiB 4.35 MiB
extra/libpng 1.6.19-1 1.6.20-1 0.00 MiB 0.23 MiB
extra/mariadb 10.1.9-4 10.1.10-1 0.26 MiB 13.80 MiB

====アップグレードさせないパッケージを設定====

ある特定のパッケージをアップデートさせないようにするには:

IgnorePkg=linux

複数のパッケージを記述するときはスペースで区切るか、{{ic|IgnorePkg}} 行を追加してください。

====アップグレードさせないグループを設定====

パッケージの場合と同様に、アップグレードさせないグループを指定することができます:

IgnoreGroup=gnome

====アップグレードさせないファイルを設定====

{{Ic|NoUpgrade}} ディレクティブで指定されたファイルはパッケージのインストール・アップグレードで変更を加えられることがなくなり、''.pacnew'' 拡張子が付いたファイルが新しくインストールされます:

NoUpgrade=''path/to/file''

{{Note|パスはパッケージ内のファイルを参照します。したがって、一番最初のスラッシュは必要ありません。}}

====インストールさせないファイルを設定====

特定のディレクトリのインストールをさせないようにするには {{Ic|NoExtract}} リストにディレクトリを加えます。例えば、[[systemd]] ユニットのインストールを避けるには:

NoExtract=usr/lib/systemd/system/*

もしくは {{AUR|localepurge}} と同じように、英語以外のローカライゼーションのインストールを止めるには:

NoExtract = usr/share/help/* !usr/share/help/en*
NoExtract = usr/share/locale/* !usr/share/locale/en* !usr/share/locale/locale.alias
NoExtract = usr/share/man/* !usr/share/man/man*
NoExtract = usr/share/vim/vim74/lang/*

後ろのルールは前のルールを上書きします。また、{{ic|!}} でルールを打ち消すことで、必要なロケールだけを維持できます。

{{Tip|pacman 5 から、''localepurge'' や ''bleachbit'' で消去したロケールがあるパッケージをアップデートする際に、''pacman'' はロケールが存在しないという警告メッセージを表示します。警告を表示しないようにするには {{ic|pacman.conf}} の {{ic|CheckSpace}} オプションをコメントアウトしてください。ただし容量チェック機能は全てのパッケージで無効になります。}}

====複数の設定ファイルを使用====

設定ファイルが複数あって (メインの設定と [[公式リポジトリ|testing]] リポジトリを有効にした設定がある場合など)、設定ファイルのオプションを共有したい場合、設定ファイルで {{ic|Include}} オプションを宣言することができます。例:

Include = /path/to/common/settings

{{ic|/path/to/common/settings}} は共有したいオプションが存在するファイルに置き換えてください。

===フック===

''pacman'' は {{ic|/usr/share/libalpm/hooks/}} ディレクトリのフックを処理の前後に実行することができます。さらに {{ic|pacman.conf}} の {{ic|HookDir}} オプションでフックディレクトリを指定できます (デフォルトは {{ic|/etc/pacman.d/hooks}} です)。フックファイルの名前には必ず ''.hook'' を後ろに付ける必要があります。

Pacman フックは様々なことに使われています。例えば、{{ic|systemd-sysusers}} と {{ic|systemd-tmpfiles}} を組み合わせてパッケージのインストール時に自動的にシステムユーザーを作成します。例として {{pkg|tomcat8}} パッケージでは {{ic|tomcat8}} という名前のシステムユーザーが必要だと指定されており特定のディレクトリの所有者がこのユーザーになるように設定されています。pacman フックの {{ic|systemd-sysusers.hook}} と {{ic|systemd-tmpfiles.hook}} は {{ic|tomcat8}} パッケージにシステムユーザーと一時ファイルが含まれていることを認識して {{ic|systemd-sysusers}} と {{ic|systemd-tmpfiles}} を実行します。

alpm のフックに関する詳細は {{man|5|alpm-hooks}} の man ページを参照。

===リポジトリ===

{{ic|/etc/pacman.conf}} に書かれているように、Repositories セクションではどの[[公式リポジトリ|リポジトリ]]を使うか定義します。リポジトリはここで直接設定することもできますし、他のファイル ({{ic|/etc/pacman.d/mirrorlist}}) から読み込ませることもできます。ただしどれかひとつのファイルを使うようにしてください。ミラーの設定は[[ミラー|ここ]]を見て下さい。

{{Warning|[testing] リポジトリを使う場合には注意が必要です。このリポジトリにあるパッケージは活発に開発が進んでいるため、更新したら動かなくなるものもあります。testing リポジトリを使う場合は、最新情報が流れている [https://lists.archlinux.org/listinfo/arch-dev-public arch-dev-public メーリングリスト] を購読するのをお薦めします。}}

===パッケージのセキュリティ===

Pacman 4 は署名済みのパッケージをサポートしていて、パッケージにセキュリティレイヤーを加えています。{{ic|SigLevel}} を使うことでリポジトリ毎に（もしくは全体的に）セキュリティレベルを設定することが可能です。デフォルトの設定では {{ic|SigLevel <nowiki>=</nowiki> Required DatabaseOptional}} によって全てのリポジトリで全てのパッケージの署名検証が有効にされています。上述したようにリポジトリ毎に {{ic|SigLevel}} を使うことでこの設定を上書きすることができます。パッケージに署名する方法や署名の検証について詳しくは、[[pacman-key]] を見てください。

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

===パッケージ XYZ にアップデートしたらシステムが壊れました===

Arch Linux はローリングリリースで最前線のディストリビューションです。一般的な使用については安定していると判断されるとすぐにパッケージがアップデートされます。しかしながら、アップデートにユーザーの介入が必要になるときが時々あります: 設定ファイルをアップデートしたり、追加の依存パッケージを変更したりなど。

一番重要なことは"やみくもに" Arch のシステムをアップデートしないということです。常時、アップデートされるパッケージの一覧を読みましょう。"重要な"パッケージ ({{Pkg|linux}}, {{Pkg|xorg-server}} など) がアップデートされるのか確認しましょう。もしそうであれば、https://www.archlinux.jp/ でニュースをチェックしたり最近のフォーラムの投稿を見て同じ問題が発生している人がいないか確認したりするのが大抵の場合役に立ちます。

パッケージをアップデートすると問題が発生することを予期される・知られている場合は、パッケージ作成者はパッケージがアップデートされた時、pacman が正しいメッセージを表示しているか確認します。アップデート後に問題がおこった時は、pacman の出力をログ ({{ic|/var/log/pacman.log}}) を見て再チェックしてください。

この段階で '''pacman から何も有用な情報が得られなく、https://www.archlinux.jp/ に関連するニュースもなく、フォーラムにもそのアップデートに関連する投稿がされていない時は'''、助けを求めるのにフォーラムや [[IRC チャンネル|IRC]] を使ったり問題のあるパッケージを[[パッケージのダウングレード|ダウングレード]]してください。

===パッケージ ABC のアップデートが公開されているはずなのに、pacman はシステムは最新だと言っています===

Pacman のミラーはすぐに同期されるわけではありません。あなたのアップデートが有効になるまで 24 時間以上かかることもあります。おとなしく待つか他のミラーを使ってください。[https://www.archlinux.jp/mirrors/status/ MirrorStatus] にミラーの更新状況がのっています。

===アップデートでこんなエラーが出ました: "file exists in filesystem"===

関連: ''Taken from https://bbs.archlinux.org/viewtopic.php?id=56373 by Misfit138.''

error: could not prepare transaction
error: failed to commit transaction (conflicting files)
package: /path/to/file exists in filesystem
Errors occurred, no packages were upgraded.

なぜこれが起こるというと: pacman がファイル衝突を検知して、あなたのために、故意に、ファイルを上書きしないようにしているからです。これは仕様であり、欠陥ではありません。

この問題は簡単に解決できます。安全な方法は初めに他のパッケージがファイルを使っていないか確認する ({{ic|pacman -Qo ''/path/to/file''}}) ことです。ファイルが他のパッケージによって使われている場合、[[バグ報告ガイドライン|バグレポートをしてください]]。他のパッケージによって使われていない場合、'ファイルシステムに存在している'ファイルの名前を変えてもう一度アップデートしてください。うまくいったならば、そのファイルは削除してかまいません。

pacman やフロントエンドを使わずに手動でプログラムをインストールしたときは、プログラムとファイルを削除して pacman を使って正しく再インストールしなくてはなりません。

全てのパッケージはインストールされるとパッケージのメタデータを含んだ {{ic|/var/lib/pacman/local/$package-$version/files}} ファイルを作ります。このファイルが壊れている（または空だったり見つからない）と、パッケージをアップデートしようしたときに "file exists in filesystem" エラーが出ます。このようなエラーは大抵一つのパッケージだけが関わっていて、手動で名前を変更してその後削除する代わりに、{{ic|pacman -S --overwrite glob パッケージ名}} で pacman に glob に一致するファイルを上書きさせることができます。

{{Warning|一般的に --overwrite スイッチの使用は避けてください。}}

===パッケージのインストール時にこんなエラーが出ました: "not found in sync db"===

まず、パッケージが本当に存在しているか確認しましょう（打ち間違いも見逃さずに！）。パッケージが存在しているのなら、あなたのパッケージリストが古くなっているかリポジトリが正しく設定されていない可能性があります。{{ic|pacman -Syy}} で全てのパッケージリストを更新してください。

===パッケージをインストールする時にエラーが表示されます: "target not found"===

まず、パッケージが本当に存在するか確認してください (typo がないかよく見てください)。確かにパッケージが存在する場合、パッケージリストが古くなっていたりあなたの使っているリポジトリが正しく設定されていない可能性があります。{{ic|pacman -Syy}} を実行して強制的に全てのパッケージリストを更新してみましょう。

また、パッケージが含まれているリポジトリがあなたのシステムで有効になっていないのかもしれません。例えば、パッケージは ''multilib'' リポジトリにあるが、''multilib'' が {{ic|pacman.conf}} で有効になっていないということが考えられます。

=== pacman の手動再インストール ===

==== pacman-static を使用====

{{AUR|pacman-static}} は pacman を静的にコンパイルしたものなので、システム上のライブラリが動作していなくても実行できます。これは、 [https://wiki.archlinux.jp/index.php/%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9#.E9.83.A8.E5.88.86.E7.9A.84.E3.81.AA.E3.82.A2.E3.83.83.E3.83.97.E3.82.B0.E3.83.AC.E3.83.BC.E3.83.89.E3.81.AF.E3.82.B5.E3.83.9D.E3.83.BC.E3.83.88.E3.81.95.E3.82.8C.E3.81.A6.E3.81.84.E3.81.BE.E3.81.9B.E3.82.93 部分的なアップグレード] が実行され、 pacman が実行できなくなった場合にも便利です。

固定コメントと PKGBUILD は、バイナリを直接ダウンロードする方法を提供し、 pacman を再インストールしたり、部分的なアップグレードの場合にシステム全体をアップグレードしたりするために使用できます。

==== 外部の pacman を使用する ====

{{ic|pacman-static}} でさえ動作しない場合は、外部の pacman を使用してリカバリできます。最も簡単な方法の1つは、 [[archiso]] を使用し、 {{ic|--sysroot}}} または {{ic|--root}} を使用してマウントポイントを指定する方法です。 {{ic|--sysroot}} に必要なファイルシステムをマウントする方法については、 [[Chroot#chrootの使用]] を参照してください。

==== 手動で抽出する ====

{{Warning|以下の方法でシステムをさらに再起不能にまで壊してしまう可能性があります。[[#アップグレード中に Pacman がクラッシュしました]]に書かれている方法で直らない場合の最後の手段として使ってください。}}

''pacman'' がどうしようもなく破壊されたとしても、最新のパッケージを手動でダウンロードして適切な場所に展開することで修復が可能です。以下のような手順で行います:

#インストールするパッケージを確認
#適当なミラーからパッケージをそれぞれダウンロード
#パッケージをルートディレクトリに展開
#{{ic|pacman -S --force}} でパッケージを再インストールしてパッケージデータベースを更新
#フルシステムアップグレードを実行

問題なく動く Arch 環境があるのであれば、以下のコマンドで依存パッケージのリストを確認できます:

$ pacman -Q $(pactree -u pacman)

問題によってはアップデートしなくてはならないパッケージは少数かもしれません。パッケージは以下のようにして展開します:

# tar -xvpwf ''package.tar.xz'' -C / --exclude .PKGINFO --exclude .INSTALL --exclude .MTREE --exclude .BUILDINFO

{{ic|w}} フラグを使ってインタラクティブモードにしていることに注意してください。インタラクティブで実行しないと重要なファイルを誤って上書きしてしまう可能性があります。また、パッケージは適切な順番で展開するようにしてください。[https://bbs.archlinux.org/viewtopic.php?id=95007 こちらのフォーラムの投稿] には ''pacman'' の一部の依存パッケージだけが壊れた時の解決方法の例が載っています。

===アップグレード中に Pacman がクラッシュしました===

パッケージの削除・再インストール・アップグレード中に "database write" エラーを残して pacman がクラッシュする場合:

#Arch インストールメディアを使って起動してください。
#root でルートファイルシステムをマウントします ({{ic|mount /dev/sdaX /mnt}})。{{ic|df -h}} で十分な空き容量があることを確認してください。
#proc, sys, dev ファイルシステムもマウントしてください: {{ic|mount -t proc proc /mnt/proc; mount --rbind /sys /mnt/sys; mount --rbind /dev /mnt/dev}}。
#システムがデフォルトのデータベースとディレクトリの場所を使っている場合、root で {{ic|1=pacman --root=/mnt --cachedir=/mnt/var/cache/pacman/pkg -Syyu}} を実行することでシステムの "pacman" データベースを更新してアップグレードすることができます。
#アップグレード後、アップグレードがないことと壊れているパッケージを確認してください: {{ic|find /mnt/usr/lib -size 0}}。
#{{ic|1=pacman --root /mnt --cachedir=/mnt/var/cache/pacman/pkg -S ''package''}} で壊れているパッケージを再インストールしてください。

==="make install" を使ってソフトウェアをインストールしましたが、ファイルがどのパッケージにも属していません===

"conflicting files" エラーが出る場合、{{ic|--force}} スイッチをつけると pacman が手動でインストールしたソフトウェアを上書きします ({{ic|pacman -S --force}})。ファイルシステム中の''所有されていない''ファイルを検索するスクリプトについては [[Pacman ヒント#ファイルがどのパッケージにも所有されていないことを確認]] を見て下さい。
{{Warning|{{ic|--force}} スイッチを使う時は気をつけてください。間違った使用で重大な問題が発生することがあります。Arch ニュースで使うように指示が出ている時にだけ使うことを推奨します。}}

===システムをアップグレードした後、再起動すると "unable to find root device" エラーが出て起動できません===

おそらく initramfs がカーネルアップデート中に破損しています(不正に {{ic|--force}} オプションを使うと起こりえます)。2つの解決方法があります:

'''1.''' ''Fallback'' エントリを試す:

{{Tip|いずれの理由でエントリを削除した場合でも、ブートローダのメニューが表示された時に {{ic|Tab}} キー ([[Syslinux]] の場合) や {{ic|e}} ([[GRUB]] や [[systemd-boot]] の場合) を押して、{{ic|initramfs-linux-fallback.img}} に名前を変更して {{ic|Enter}} や {{ic|b}} を押して（ブートローダによる）新しいパラメータを使って起動できます。}}

システムが起動したら、コンソールかターミナルから次のコマンド (持ち合わせの {{Pkg|linux}} カーネル用)を入力して initramfs イメージを再生成します:

{{bc|# mkinitcpio -p linux}}

'''2.''' それが機能しない場合は、現在の Arch リリース（CD/DVDまたはUSBスティック）から、ルートパーティションとブートパーティションをマウントします。次に、chroot します。

# arch-chroot /mnt
# pacman -Syu mkinitcpio systemd linux

{{Note|
* もしあなたが現在のリリースを持っていなかったり、他の "Live" Linux ディストリビューションを持っていないなら、昔ながらの方法で [[chroot]] することができます。もちろん、単に {{ic|arch-chroot}} スクリプトを実行するよりも、より多くの入力が必要になります。
* "pacman" が {{ic|Could not resolve host}} で失敗した場合は、 [https://wiki.archlinux.jp/index.php/%E3%83%8D%E3%83%83%E3%83%88%E3%83%AF%E3%83%BC%E3%82%AF%E8%A8%AD%E5%AE%9A#.E6.8E.A5.E7.B6.9A.E3.81.AE.E7.A2.BA.E8.AA.8D 接続の確認] をクリックしてください。
* arch-chroot または chroot 環境に入れないが、パッケージを再インストールする必要がある場合は、ルートパーティションで "pacman" コマンド {{ic|pacman--sysroot/mnt-Syu foo bar}} を使用できます。}}

カーネル ({{Pkg|linux}} パッケージ) を再インストールすると、自動的に {{ic|mkinitcpio-p linux}} で initramfsイメージが再生成されます。これを個別に行う必要はありません。

その後、{{ic|exit}}、{{ic|umount/mnt/{boot,} }} および {{ic|reboot}} を実行してください。

===signature from "User <email@gmail.com>" is unknown trust===

以下の方法を試してみてください:

*{{ic|pacman-key --refresh-keys}} で既知のキーを更新してください。
*手動で {{ic|archlinux-keyring}} パッケージをアップグレードしてください: {{ic|pacman -Sy archlinux-keyring && pacman -Su}}。
*[[pacman-key#全ての鍵のリセット]]に従って下さい。

===PGP 鍵のインポートが要求される===

古いバージョンの ISO で Arch を[[インストールガイド|インストール]]しようとすると、PGP 鍵のインポートが要求されることがあります。鍵のダウンロードに同意して先に進んでください。PGP 鍵を追加できない場合、キーリングを更新したり {{Pkg|archlinux-keyring}} をアップグレードしてください ([[#signature from "User <email@gmail.com>" is unknown trust|上]]を参照)。

===エラー: key "0123456789ABCDEF" could not be looked up remotely===

パッケージが {{Pkg|archlinux-keyring}} に最近追加された新しい鍵で署名されている場合、アップグレード時にはまだローカルで鍵が利用できない状態になっていることがあります (鶏が先か、卵が先か)。インストール済みの {{Pkg|archlinux-keyring}} に鍵が含まれていない場合、Pacman は鍵サーバーを確認しにいきますが、プロキシやファイアウォールを使っているなどの理由でエラーになることがあります。[[#signature from "User <email@gmail.com>" is unknown trust|上]]で書かれているように {{Pkg|archlinux-keyring}} を先にアップグレードしてください。

===signature from "User <email@archlinux.org>" is invalid===

システム[[時刻]]が間違っていると、署名鍵が期限切れとして扱われたりパッケージの署名チェックが失敗して、以下のようなエラーが表示されます:

error: ''package'': signature from "User <email@archlinux.org>" is invalid
error: failed to commit transaction (invalid or corrupted package (PGP signature))
Errors occured, no packages were upgraded.

パッケージをインストール・アップグレードする前に　{{ic|ntpd -qg}} と {{ic|hwclock -w}} を root で実行して下さい。

==="failed to commit transaction (invalid or corrupted package)" エラー===

{{ic|/var/cache/pacman/pkg}} にある {{ic|*.part}} ファイル (部分ダウンロードファイル) を探して、ファイルを削除して下さい ({{ic|pacman.conf}} で {{ic|XferCommand}} を設定しているとこのエラーがよく起こります)。

# find /var/cache/pacman/pkg/ -iname "*.part" -exec rm {} \;

===pacman を使うたびにエラーが表示されます: 'warning: current locale is invalid; using default "C" locale'===

そのエラーは、あなたの locale が正しく設定されていないと言っています。[[ロケール]]を見て下さい。

===pacman でプロキシ設定を使うにはどうすればいいですか？===

環境変数 ({{ic|$http_proxy}}, {{ic|$ftp_proxy}} など) を使って下さい。[[sudo]] と一緒に Pacman を使う時は、[[sudo#環境変数|環境変数を pacman に渡すように]] sudo を設定してください。

===明示的にインストールしたか依存でインストールしたかの情報を保ちながら、全てのパッケージを再インストールするにはどうすればいいですか===

ネイティブのパッケージを全て再インストールするには: {{ic|<nowiki>pacman -Qnq | pacman -S -</nowiki>}} ({{ic|-S}} オプションはデフォルトでインストールの理由を維持します)。

次に自分で作成したパッケージを全て再インストールしてください、{{ic|pacman -Qmq}} でパッケージを確認できます。

===パッケージのダウンロード時にフリーズする===

''pacman'' がリポジトリのアップデートや同期をできないというネットワークの問題がいくつか報告されています [https://bbs.archlinux.org/viewtopic.php?id=68944] [https://bbs.archlinux.org/viewtopic.php?id=65728]。Arch Linux のインストール時にこの問題が発生する場合、''pacman'' のデフォルトのファイルダウンローダを置き換えることで解決します (詳しくは [[pacman のパフォーマンスの向上]]を参照)。[[VirtualBox]] で Arch Linux をゲスト OS としてインストールする時にこの問題が起こる場合、マシンのプロパティで ''NAT'' の代わりに ''Host interface'' を使うことで解決します。

===Failed retrieving file 'core.db' from mirror===

[[ミラー]]を正しく設定しているのにこのエラーメッセージが表示される場合、[[Resolv.conf|ネームサーバ]]を設定してみてください。

==参照==

*[https://www.archlinux.org/pacman/ Pacman ホームページ]
*{{man|3|libalpm}}
*{{man|8|pacman}}
*{{man|5|pacman.conf}}
*{{man|8|repo-add}}

Snapper

2021-12-16T12:49:25Z

Funcrab: /* 推奨ファイルシステムレイアウト */ ノートにBtrfsの制限「スナップショットにはスワップファイルを含むことができない」を記載

[[Category:ファイルシステム]]
[[en:Snapper]]
[[zh-hans:Snapper]]
{{Related articles start}}
{{Related|Btrfs}}
{{Related|mkinitcpio}}
{{Related articles end}}

[http://snapper.io Snapper] は openSUSE の Arvin Schnell によって作られた、[[Btrfs]] のサブボリュームと [[LVM]] のボリュームのスナップショットの管理を助けるツールです。スナップショットを作成して比較したり、前のスナップショットに戻したり、自動スナップショットが行えます。

==インストール==
安定版は {{Pkg|snapper}} パッケージからインストールできます。開発版は {{AUR|snapper-git}} パッケージで利用可能です。

GUI は {{AUR|snapper-gui-git}} パッケージでインストールすることができます。

==新しい設定の作成==

Btrfs サブボリュームで Snapper の設定を作成する前に、あらかじめサブボリュームが作成されている必要があります。サブボリュームが存在しない場合、Snapper の設定をするまえに[[Btrfs#サブボリュームを作成する|サブボリュームを作成]]してください。

Btrfs サブボリュームが {{ic|''/path/to/subvolume''}} に存在していて、{{ic|''config''}} という名前で新しく Snapper の設定を作るには:

# snapper -c ''config'' create-config ''/path/to/subvolume''

上記のコマンドを実行すると:
*{{ic|/etc/snapper/config-templates}} にあるデフォルトのテンプレートに基づいて {{ic|/etc/snapper/configs/''config''}} に設定ファイルが作成されます。
*{{ic|''/path/to/subvolume''/.snapshots}} にサブボリュームが作成されてスナップショットが保存されます。スナップショットのパスは {{ic|''/path/to/subvolume''/.snapshots/''#''/snapshot}} になります ({{ic|''#''}} はスナップショット番号です)。
*{{ic|/etc/conf.d/snapper}} の {{ic|SNAPPER_CONFIGS}} に {{ic|''config''}} が追加されます。

例えば、{{ic|/}} にマウントされたサブボリュームの設定ファイルを作成する場合:

# snapper -c root create-config /

この時点で、設定は有効になっています。[[cron]] デーモンが動作している場合、snapper は[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を作成します。[[cron]] デーモンを使っていない場合、systemd サービスとタイマーを使用する必要があります。[[#有効化/無効化]]を見てください。

設定について詳しくは {{ic|snapper-configs}} の [[man ページ]]を参照。

== スナップショットの作成 ==

=== 自動タイムラインスナップショット ===

Snapper では毎時・毎日・毎月・毎年に保存するスナップショットの数を設定できるスナップショットタイムラインを作成することができます。デフォルトでは1時間毎にスナップショットが取得されます。そして1日1回、タイムラインのクリーンアップアルゴリズムによって"古くなって要らなくなった"スナップショットを削除します。

==== 有効化/無効化 ====

[[cron]] デーモンが動作している場合、自動タイムラインスナップショットは自動的に起動します。無効化するには、サブボリュームに存在する設定ファイルを編集して以下を設定してください:

{{bc|<nowiki>TIMELINE_CREATE="no"</nowiki>}}

[[cron]] デーモンを使っていない場合、パッケージに含まれている systemd ユニットを使うことができます。{{ic|snapper-timeline.timer}} を[[起動]]・[[有効化]]することで自動タイムラインスナップショットが開始されます。さらに、{{ic|snapper-cleanup.timer}} を[[起動]]・[[有効化]]すると定期的に古いスナップショットが消去されます。

{{Note|cron デーモンと有効化された systemd ユニットがともに動作すると、重複したスナップショットが作成される結果になる場合があります。systemd ユニットを使いつつ cron 側を無効にできるかもしれない一つの手法に、[[pacman]] の [[pacman#インストールさせないファイルを設定|NoExtract]] および [[pacman#アップグレードさせないファイルを設定|NoUpgrade]] を使い、snapper のパッケージの cron ファイルをインストールしない方法があります。[https://unix.stackexchange.com/questions/425570/snapper-has-recently-started-performing-duplicate-snapshots-each-hour] を見てください。}}

==== スナップショットのリミットの設定 ====

デフォルト設定では、毎時間10個、毎日10個、毎月10個、毎年10個のスナップショットが保存されます。{{ic|/}} など頻繁にサブボリュームに変更を加える場合は、この設定を変更したほうが良いでしょう。[[#ドライブの負担を抑える]]を見て下さい。

以下は、5時間、毎日7個のスナップショットだけを維持して、毎月・毎年は保存しない設定の例です:
{{hc|head=/etc/snapper/configs/''config''|output=
TIMELINE_MIN_AGE="1800"
TIMELINE_LIMIT_HOURLY="5"
TIMELINE_LIMIT_DAILY="7"
TIMELINE_LIMIT_WEEKLY="0"
TIMELINE_LIMIT_MONTHLY="0"
TIMELINE_LIMIT_YEARLY="0"
}}

==== スナップショットとクリーンアップの頻度を変更する ====

systemd タイマーを使っている場合、タイマーを[[Systemd#ユニットファイルの編集|編集]]してスナップショットの頻度を変更できます。

例えば、{{ic|snapper-timeline.timer}} を編集して以下のようにすることで5分毎にスナップショットが作成されます:

[Timer]
OnCalendar=
OnCalendar=*:0/5

{{Note|設定パラメータ {{ic|TIMELINE_LIMIT_HOURLY}} は上記の設定に関連付けられています。上の例では5分毎にスナップショットが作成されるようになります。}}

{{ic|snapper-cleanup.timer}} を編集するときは {{ic|OnUnitActiveSec}} を変更してください。1時間毎に古いスナップショットを消去するには、以下を追加:

[Timer]
OnUnitActiveSec=1h

詳しくは [[Systemd/タイマー]]や [[Systemd#ドロップインファイル]]を参照。

=== 手動スナップショット ===

==== シンプルなスナップショット ====

デフォルトでは Snapper は他のスナップショットと特別な関係を持たない、単純なスナップショットを作成します。

手動でサブボリュームのスナップショットを作成するには、以下のコマンドを実行:

# snapper -c ''config'' create --description ''desc''

上記のコマンドはクリーンアップアルゴリズムを使用しないため、スナップショットは明示的に[[#スナップショットの削除|削除]]するまでずっと残り続けます。

クリーンアップアルゴリズムを設定するには {{ic|create}} の後に {{ic|-c}} フラグを使用して {{ic|number}}, {{ic|timeline}}, {{ic|pre}}, {{ic|post}} のどれかを選択してください。{{ic|number}} は設定ファイルで指定された番号にあわせて定期的にスナップショットを削除します。例えば、{{ic|number}} アルゴリズムを使用するスナップショットを作成するには:

# snapper -c ''config'' create -c number

{{ic|timeline}} スナップショットについては[[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を、{{ic|pre}} と {{ic|post}} については[[#事前事後のスナップショット|事前事後のスナップショット]]を見てください。

==== 事前事後のスナップショット ====

シンプルなスナップショットだけでなく、Snapper では事前事後のスナップショットを作成できます。事前 (''pre'') スナップショットには必ず対応する事後 (''post'') スナップショットが存在します。このペアによってシステムに変更を加える前後のスナップショットを作成することができます。

事前事後のスナップショットを作成するには、まず事前スナップショットを作成:

# snapper -c ''config'' create -t pre -p

上記のコマンドでスナップショット番号が出力されます。

それからシステムに何らかの変更を加えます (例えば新しいプログラムをインストールしたり、ソフトウェアをアップグレードするなど)。

次に事後のスナップショットを作成:

# snapper -c ''config'' create -t post --pre-number ''#''

{{ic|''#''}} は事前スナップショットの番号に置き換えてください。

{{ic|create}} に {{ic|--command}} フラグを指定して、コマンドをラップすることもできます:

# snapper -c ''config'' create --command ''cmd''

{{ic|''cmd''}} は事前事後のスナップショットを作成する間に実行したいコマンドに置き換えてください。

[[#pacman のトランザクションをスナップショットで記録|pacman のトランザクションをスナップショットで記録]]も見てください。

=== 起動時にスナップショットを作成 ===

snapper で {{ic|root}} 設定のスナップショットを作成するには {{ic|snapper-boot.timer}} を[[有効化]]してください。

== スナップショットの確認 ==

作成されたスナップショットを確認するには:

# snapper -c ''config'' list

== 設定の確認 ==

全ての[[#新しい設定の作成|設定]]を確認するには:

# snapper list-configs

== スナップショットの削除 ==

スナップショット番号 {{ic|''#''}} を削除するには:

# snapper -c ''config'' delete ''#''

一度に複数のスナップショットを削除できます。例えば、root 設定の65と70のスナップショットを削除するには:

# snapper -c root delete 65 70

{{Note|事前スナップショットを削除した場合、事後スナップショットも一緒に削除してください。逆も然りです。}}

==root 以外のユーザーでアクセス==
設定は root ユーザーによって作成され、デフォルトでは、root だけが設定を確認したり変更できます。

特定のユーザーからもスナップショットを確認できるようにしたいときは、{{ic|/etc/snapper/configs/''config''}} ファイルの {{ic|ALLOW_USERS}} の値を変更してください。そうすれば通常ユーザーでも {{ic|snapper -c ''config''list}} を実行できるようになります。

さらに、ユーザーを使って {{ic|.snapshots}} ディレクトリを閲覧できるようにしたい、それでいてディレクトリの所有者は root のままにしておきたいということが考えられます。そのような場合、使用したいユーザーが属しているグループに、グループ所有者を変更してください。例えば {{ic|users}}　を使う場合:

# chmod a+rx .snapshots
# chown :users .snapshots

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

=== pacman のトランザクションをスナップショットで記録 ===

pacman の操作時に自動的にスナップショットを作成するためのパッケージが複数存在します:

* {{App|pacupg|Btrfs のスナップショットでパッケージと AUR のアップグレードを記録して、簡単にロールバックできるようにするスクリプト。|https://github.com/crossroads1112/bin/tree/master/pacupg|{{AUR|pacupg}}}}
* {{App|snap-pac|openSUSE の YaST のように自動的に[[#事前事後のスナップショット|事前事後のスナップショット]]を作成します。[[Pacman#フック]]を使用しています。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|snap-pac-grub|{{pkg|snap-pac}} でスナップショットが作成された後に {{Pkg|grub-btrfs}} 用に GRUB エントリを更新します。[[Pacman#フック]]を使用します。||{{aur|snap-pac-grub}}}}
* {{App|snp|シェルコマンドの実行前後に snapper でスナップショットを取るラッパー。例: {{ic|$ snp pacman -Syu}}|https://gist.github.com/erikw/5229436|}}

=== boot パーティションのバックアップ ===

{{ic|/boot}} パーティションが btrfs ファイルシステム上に存在しない場合 (例: [[ESP]])、snapper でバックアップすることはできません。フックを使用してカーネルのアップデート時に boot パーティションを自動的に btrfs ファイルシステムにコピーさせることはできます。{{Pkg|snap-pac}} でも上手くバックアップされます。
{{hc|1=/usr/share/libalpm/hooks/50_bootbackup.hook|2=
[Trigger]
Operation = Upgrade
Operation = Install
Operation = Remove
Type = Package
Target = linux*

[Action]
Depends = rsync
Description = Backing up /boot...
When = PreTransaction
Exec = /usr/bin/rsync -a --delete /boot /.bootbackup
}}

=== 外部ドライブに差分バックアップ ===

以下のパッケージは {{ic|btrfs send}} と {{ic|btrfs receive}} を使用して外部ドライブにバックアップを差分で送信します:

* {{App|buttersink|Btrfs スナップショットの rsync のようなもので、スナップショットの差分だけを送信することで自動的に同期を最適化します。|https://github.com/AmesCornish/buttersink.git|{{AUR|buttersink-git}}}}
* {{App|snap-sync|snapper スナップショットを使用して外部ドライブにバックアップします。|https://github.com/wesbarnett/snap-sync.git|{{Pkg|snap-sync}}}}
* {{App|snapsync|snapper 用の同期ツール。|https://github.com/doudou/snapsync|{{AUR|ruby-snapsync}}}}

===推奨ファイルシステムレイアウト===

{{Note|1=以下のレイアウトは {{ic|snapper rollback}} を使用することは想定していませんが、コマンドで {{ic|/}} をリストアしたときの問題を軽減します。[https://bbs.archlinux.org/viewtopic.php?id=194491 フォーラムスレッド] を参照してください。}}

以下は {{ic|/}} を簡単に復元できるようにするための推奨ファイルシステムレイアウトです:

subvolid=5
|
├── @
| |
| ├── /usr
| |
| ├── /bin
| |
| ├── /.snapshots
| |
| ├── ...
|
├── @snapshots
|
└── @...

{{ic|/.snapshots}} は {{ic|@snapshots}} のマウントポイントです。{{ic|@...}} は {{ic|/}} にマウントするサブボリューム ({{ic|@}}) とは別に保存したいサブボリュームになります。{{ic|/}} のスナップショットを作成するとき、他のサブボリュームはスナップショットに含まれません。ただし、別の snapper 設定を作成することで他のサブボリュームもスナップショットで記録できます。システムを {{ic|/}} のスナップショットの時点まで戻したいと思ったときに、他のサブボリュームには影響が及びません。

例えば、{{ic|/}} をスナップショット時に戻したいが {{ic|/home}} は最新の状態のままにしたい場合、サブボリュームを作成して {{ic|/home}} にマウントしてください。詳しくは [[Btrfs#サブボリュームをマウントする]]を参照。

上記のレイアウトは snapper ユーティリティで定期的に {{ic|/}} のスナップショットが作成できるのと同時に、起動できなくなった場合に Arch のライブ CD から {{ic|/}} を簡単に復元することができます。

その場合、初期設定をしたら snapper に特別な設定をする必要はありません。

{{Note|
* サブボリュームが {{ic|@}} 下に入れ子になっていても、{{ic|/}} のスナップショットには含まれません。{{ic|/}} にマウントしているサブボリュームのスナップショットを保存したい場合は snapper でサブボリュームの設定を行ってください。
* [[Btrfs#スワップファイル|Btrfs の制限]]により、スナップショットされたボリュームは[[スワップ#スワップファイル|スワップファイル]]を含むことができません。スワップファイルを別のサブボリュームに置くか、[[スワップ#スワップパーティション|スワップパーティション]]を作成してください。
}}

====snapper の設定とマウントポイント====

{{ic|/.snapshots}} がマウントされていないこと、フォルダとして存在しないことを確認してください:
# umount /.snapshots
# rm -r /.snapshots

それから {{ic|/}} の[[#新しい設定の作成|新しい設定を作成]]します。

そして {{ic|@snapshots}} を {{ic|/.snapshots}} に[[マウント]]してください。例えば、ファイルシステムが {{ic|/dev/sda1}} に存在する場合:
# mount -o subvol=@snapshots /dev/sda1 /.snapshots
マウントを永続化させるには、[[fstab]] にエントリを作成します。

もしくは fstab エントリが既に存在する場合、スナップショットのサブボリュームを再マウントします:
# mount -a

フォルダには {{ic|750}} の[[ファイルのパーミッションと属性#数字を使う方法|パーミッション]]を設定してください。

snapper が作成するスナップショットは全て {{ic|@}} サブボリュームの外に保存されるため、snapper のスナップショットを削除しなくても {{ic|@}} を簡単に置き換えることができます。

===={{ic|/}} を {{ic|@}} のスナップショットに復元 ====

snapper のスナップショットを使って {{ic|/}} をリストアしたくなったら、まずは Arch Linux のライブ USB/CD を起動します。

トップレベルのサブボリューム (subvolid=5) を[[マウント]]してください。{{ic|subvolid}} マウントフラグは省略します。

{{ic|/mnt/@snapshots/*/info.xml}} から復元したいスナップショットを確認します:
{{Tip|{{ic|vi}} を使ってファイルを確認できます:
# vi /mnt/@snapshots/*/info.xml
次のファイルを見たいときは {{ic|:n}} を、最初のファイルに戻りたいときは {{ic|:rew}} を使用します。}}

{{ic|<description>}} タグと {{ic|<date>}} タグを見て、リストアしたいスナップショットが確認できたら、{{ic|<num>}} の番号をメモしてください。

そして {{ic|@}} を他の場所 (例: {{ic|/@.broken}}) にして現在のシステムのコピーを保存します。もしくは {{ic|btrfs subvolume delete}} で {{ic|@}} を削除します。

読み取り専用のスナップショットから読み書き可能なスナップショットを作成:

# btrfs subvol snapshot /mnt/@snapshots/''#''/snapshot /mnt/@

{{ic|''#''}} は復元したい snapper のスナップショットの番号に置き換えてください。これで {{ic|/}} は前の状態に戻ります。再起動してください。

===スナップショットからファイルを削除===

過去のスナップショットから特定のファイルやフォルダを削除したい場合、[https://pypi.python.org/pypi/snapperS snapperS] というスクリプトが存在します。

スクリプトを使わずにファイルを削除したい場合、以下のコマンドを実行して [https://unix.stackexchange.com/a/149933/3587 スナップショットのサブボリュームを読み書き可能] にする必要があります:

# btrfs property set /path/to/.snapshots/<snapshot_num>/snapshot ro false

{{ic|1=ro=false}} となっていることを確認:

{{hc|# btrfs property get /path/to/.snapshots/<snapshot_num>/snapshot|2=ro=false}}

これで {{ic|/path/to/.snapshots/<snapshot_num>/snapshot}} のファイルは通常通りに編集することが可能になります。

=== ドライブの負担を抑える ===

頻繁に変更が加わるファイルシステム (例えば多数のシステムアップデートが行われる {{ic|/}} など) で長期間にわたって頻繁にスナップショットを取得すると動作がかなり遅くなることがあります。以下のようにすることで遅くなるのを回避できます:
* スナップショットを作成する価値がない {{ic|/var/cache/pacman/pkg}}, {{ic|/var/abs}}, {{ic|/var/tmp}}, {{ic|/srv}} などのサブボリュームを[[Btrfs#サブボリュームを作成する|作成]]する。
* [[#自動タイムラインスナップショット|自動タイムラインスナップショット]]を使う場合に、毎時・毎日・毎周・毎年のスナップショットのデフォルト設定を変更する。

==== updatedb ====

デフォルトでは、{{ic|updatedb}} は snapper によって作成された {{ic|.snapshots}} ディレクトリのインデックスも作成してしまい、スナップショットが大量にある場合、深刻な遅延が発生したりメモリが異常に消費される原因になります。以下のように設定ファイルを編集することでインデックスを作成しないように {{ic|updatedb}} を設定できます:
{{hc|/etc/updatedb.conf|2=PRUNENAMES = ".snapshots"}}

=== ログファイルの保持 ===

{{ic|/var/log}} のサブボリュームを作成して {{ic|/}} のスナップショットに含まれないようにすることを推奨します。{{ic|/}} のスナップショットを復元したときにログファイルまで前の状態に戻ってしまうことがなくなり、トラブルシューティングが楽になります。

== トラブルシューティング ==
===Snapper のログ===
Snapper は全ての活動を {{ic|/var/log/snapper.log}} に書き出します。何か問題が発生しているように感じたら真っ先にこのファイルをチェックしてください。

毎時・毎日・毎週のスナップショットに問題がある場合、おそらく cronie サービス (もしくはその他の cron デーモン) が動いていなかったのが原因だということが多くあります。

===IO エラー===
スナップショットを作成しようとすると IO エラーが表示される場合、スナップショットを作成しようとしたサブボリュームと関連付けられている [https://bbs.archlinux.org/viewtopic.php?id=164404 .snapshots] ディレクトリもサブボリュームになっていることを確認してください。

また、{{ic|.snapshots}} の所有者が root になっていない可能性もあります ({{ic|/var/log/snapper.log}} に {{ic|Btrfs.cc(openInfosDir):219 - .snapshots must have owner root}} というエラーが出力されます)。

== 参照 ==
* [http://snapper.io/ Snapper ホームページ]
* [https://en.opensuse.org/Portal:Snapper openSUSE Snapper ポータル]
* [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs ホームページ]
* [https://www.linux.com/news/enterprise/systems-management/878490-snapper-suses-ultimate-btrfs-snapshot-manager/ Linux.com: Snapper: SUSE's Ultimate Btrfs Snapshot Manager]

Greenclip

2021-12-15T13:46:34Z

Funcrab: トラブルシューティングを追加: i3でクリップボード記録がされない問題の対応を記載

[[Category:アプリケーションランチャー]]
[[en:Greenclip]]
[https://github.com/erebe/greenclip Greenclip] はシンプルなクリップボードマネージャです。[[Haskell]] で書かれており [[Rofi]] と統合して動作するように作られています。

== インストール ==

{{AUR|rofi-greenclip}} パッケージを[[インストール]]してください。

起動時にサービスを開始できるようにします:

$ systemctl --user enable greenclip.service

== 使用方法 ==

デーモンを生成:
$ /usr/bin/greenclip daemon

あるいはサービスを起動・有効化:

$ systemctl --user start greenclip.service

[[rofi]] の中でリストとしてエントリを表示:
$ rofi -modi "clipboard:greenclip print" -show clipboard
選択したエントリが[[クリップボード]]に保存されます。

クリップボードの履歴を全て消去するには:
$ greenclip clear

== 設定 ==

設定ファイルは {{ic|~/.config/greenclip.cfg}} に存在します。

=== 設定例 ===

{{hc|~/.config/greenclip.cfg|<nowiki>
Config {
maxHistoryLength = 250,
historyPath = "~/.cache/greenclip.history",
staticHistoryPath = "~/.cache/greenclip.staticHistory",
imageCachePath = "/tmp/",
usePrimarySelectionAsInput = False,
blacklistedApps = [],
trimSpaceFromSelection = True
}
</nowiki>}}

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

=== i3-wm でクリップボードの記録ができない ===

i3設定ファイルに下記を入れてください。サービス起動は必要ありません。
[[https://github.com/erebe/greenclip/issues/70 greenclip issue #70]]

{{hc|~/.config/i3/config|
# clipboard tool
exec --no-startup-id greenclip daemon>/dev/null
bindsym $mod+c exec --no-startup-id rofi -modi "clipboard:greenclip print" -show clipboard
}}

Fcitx5

2021-12-13T16:12:06Z

Funcrab: 環境変数部分を反映

[[Category:インプットメソッド]]
[[en:Fcitx5]]
[[zh-hans:Fcitx5]]
{{Related articles start}}
{{Related|Fcitx}}
{{Related|IBus}}
{{Related articles end}}

Fcitx5 は [[Fcitx]] の後継です。

== インストール ==

{{Pkg|fcitx5}} パッケージを[[インストール]]してください。

{{Grp|fcitx5-im}} パッケージグループ, {{Pkg|fcitx5}} 本体, [[#設定ツール]], {{AUR|fcitx5-qt4-git}} を除く全ての [[#インプットメソッドモジュール]]

{{Note|{{Pkg|fcitx5}} は基本的なフレームワークを提供するだけで英語のサポートが提供されます。中国語や日本語などの他の言語を入力する場合は、インプットメソッドエンジンが必要です。}}

=== 中国語 ===

* {{Pkg|fcitx5-chewing}} は {{Pkg|libchewing}} に基づく繁体字の注音入力エンジンです。
* {{Pkg|fcitx5-chinese-addons}} には中国語に関連するアドオンが含まれています。fcitx4 にバンドルされている IME も含まれます。
* {{Pkg|fcitx5-rime}} は [[Rime IME]] プロジェクトのスキーマを基にしています。

=== 日本語 ===

* {{Pkg|fcitx5-anthy}} は人気の日本語入力エンジンです。ただし、開発は滞っています。
* {{Pkg|fcitx5-mozc}} Google 日本語入力のオープンソース版である [[Mozc]] がベース。
* {{Pkg|fcitx5-skk}} は {{Pkg|libskk}} がベースの日本語仮名漢字入力エンジンです。

=== 他の言語 ===

* {{Pkg|fcitx5-hangul}} は {{Pkg|libhangul}} ベースの韓国語ハングル入力エンジンです。
* {{Pkg|fcitx5-unikey}} はベトナム文字入力エンジンです。
* {{Pkg|fcitx5-m17n}}, for typing other miscellaneous languages.

=== インプットメソッドモジュール ===

より良いエクスペリエンスを得るために、以下のモジュールもインストールすると良いでしょう。モジュールをインストールしなくても大抵のアプリケーションでインプットメソッドは動作しますが、インプットメソッドがフリーズしたり、プレビューウィンドウの位置がずれたり、プレビューが表示されなかったりする可能性があります。

* Qt プログラムには {{Pkg|fcitx5-qt}} をインストールしてください。
* GTK プログラムには {{Pkg|fcitx5-gtk}} をインストールしてください。
* Qt4 プログラムには {{AUR|fcitx5-qt4-git}} をインストールしてください。
* Qt5 プログラムには {{AUR|fcitx5-qt5-git}} をインストールしてください。
* Qt6 プログラムには {{AUR|fcitx5-qt6-git}} をインストールしてください。
* 日付と時刻のサポートについては {{Pkg|fcitx5-lua}} をインストールしてください。

{{Tip|通常、{{Pkg|fcitx5-qt}} と {{Pkg|fcitx5-gtk}} をインストールすると、あらゆる状況に対応できます。}}

== 使用方法 ==
=== インプットメソッドモジュールの環境変数の設定 ===

Fcitx5を常用する場合は、環境変数を変更する必要があります。

{{ic|/etc/environment}}を編集し、以下の行を追加します。

GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx

{{Tip|1=これらの変数を設定する他の方法については、 [[環境変数]] を参照してください。SDL2ライブラリのベンダー修正版を使用する一部のゲーム（Dota2など）では、{{ic|1=SDL_IM_MODULE=fcitx}} も追記します。}}

=== デスクトップ環境での自動起動 ===

デスクトップの起動時に {{Pkg|fcitx5}} の自動起動が必要な場合は、[[Fcitx#デスクトップ環境での自動起動]] を参照してください。

== 設定 ==
=== 設定ツール ===

{{Pkg|fcitx5}} の設定ファイルは、{{ic|~/.local/share/fcitx5}} にあります。テキストエディタを使用して設定ファイルを編集できますが、GUIを使った方が明らかに便利です。 {{Pkg|fcitx5-configtool}} パッケージをインストールします。

=== テーマ ===

収録されているテーマは非常に少なく、[https://github.com/search?q=fcitx5+theme&type=Repositories GitHub] でより多くのテーマを見つけることができます。
* {{Pkg|fcitx5-material-color}}: このテーマはマイクロソフトの PinYin のような感じです。公式版は [https://github.com/hosxy/Fcitx5-Material-Color GitHub: Fcitx5-Material-Color] にあります。README.md ファイルに1行モードの美しい感じを設定するためのガイダンスがあります。

{{Tip|KCM を使用している場合は、''Setting -> Location -> input method -> Configure addons -> Classic user interface -> Theme'' でテーマを切り替えます。}}

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

=== 問題の診断 ===
fcitx5 の使用に問題がある場合 (例. {{ic|Ctrl+Space}} がすべてのアプリケーションで機能しないなど。最初に試すべきことは、{{ic|fcitx5-diagnose}} を使用して診断することです。{{ic|fcitx5-diagnose}} の出力には、最も一般的な問題の手がかりが含まれています。

=== 最新の wps は fcitx5 を使用できません ===

参照. [[WPS Office#Fcitx5 cannot input Chinese]]

=== intellij IDE で error position ===

一部のJavaアプリケーションは正確に位置を取得できません。Fcitx5はこの問題を修正できません [https://github.com/fcitx/fcitx5/issues/79].

=== 絵文字が候補ボックスで異常を示しています ===

1. 絵文字のフォントがインストールされていることを確認します。 ( 例えば {{Pkg|noto-fonts-emoji}} )

2. システムフォントを {{ic|Noto Sans CJK JP}}

3. 次のコマンドを使用して再起動 '''reboot Fcitx5''' :

# kill `ps -A | grep fcitx5 | awk '{print $1}'` && fcitx5&

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

=== 選択した文字の Unicode エンコーディングを表示する方法 ===

*選択したテキストの Unicode エンコーディングをテキストエディタで表示する場合は、テキストを直接選択し、ショートカットキー{{ic|ctrl + alt + shift + u}}を使用して、選択したテキストのエンコーディングを表示します。

*非編集領域(この Wiki など)のテキストの Unicode エンコーディングを表示する場合は、まずテキストをクリップボードにコピーしてから、編集可能な領域(検索ボックスなど)をクリックする必要があります。次に、ショートカットキー {{ic|ctrl + alt + shift + u}} を使用して、クリップボード内のテキストのエンコーディングを表示できます。

=== 特殊文字を入力 ===

一般に、{{ic|≤}}、{{ic|ā}}、{{ic|á}}、{{ic|©}} などの単純な記号は、[[Xorg でのキーボード設定#コンポーズキーの設定|コンポーズキーの設定]] から入力できますが {{ic|2}}、{{ic|3}}、{{ic|4}}などの特殊記号の場合は、次のいずれかをカスタマイズします {{ic|~/XCompose}} または、Fcitx5 の Unicode 関数を使用します。

{{ic|1}} を例にとってみましょう。

任意の入力ボックスにカーソルを置いて {{ic|Ctrl+Alt+Shift+U}} を押し、{{ic|円1}} と入力すると、{{ic|1}} などの特殊文字が表示されます。

=== RIME ===

ユーザーデータディレクトリは {{ic|~/.local/share/fcitx5/rime/}} です。
{{Note|次の例では、{{ic|luna_pinyin}}を例にしています。他の入力方式の変更を参照してください}}

==== ギリシャ文字 ====

{{ic|luna_pinyin.custom.yaml}} をカスタムファイルとして次のコードを追加します。

{{hc|luna_pinyin.custom.yaml|
recognizer:
patterns:
# Use / as the identifier here
# You can freely replace your favorite identifiers (such as: `~, .\; etc., characters that need not be displayed directly on the screen)
# Replace the / before the Greek letter at the same time
punct: "^/([0-9]0?{{!}}[A-Za-z]+)$"
punctuator:
symbols:
# Here, the letter name is used as the code of the Greek letter, and you can replace it with your favorite code as needed.
# For example, if you want to use a as the alpha code
# just replace the alpha below with a
"/alpha": ["Α", "α"]
"/beta": ["Β", "β"]
"/gamma": ["Γ", "γ"]
"/delta": ["Δ", "δ"]
"/epsilon": ["Ε", "ε"]
"/zeta": ["Ζ", "ζ"]
"/eta": ["Η", "η"]
"/theta": ["Θ", "θ"]
"/iota": ["Ι", "ι"]
"/kappa": ["Κ", "κ"]
"/lambda": ["Λ", "λ"]
"/mu": ["Μ", "μ"]
"/nu": ["Ν", "ν"]
"/xi": ["Ξ", "ξ"]
"/omicron": ["Ο", "ο"]
"/pi": ["Π", "π"]
"/rho": ["Ρ","ρ"]
"/sigma": ["Σ", "σ", "ς"]
"/tau": ["Τ", "τ"]
"/upsilon": ["Υ", "υ"]
"/phi": ["Φ", "φ"]
"/chi": ["Χ", "χ"]
"/psi": ["Ψ", "ψ"]
"/omega": ["Ω", "ω"]
}}

例えば、{{ic|α}} を使いたい場合、{{ic|/alpha}} と入力します。

=== 半角/全角句読点の切り替え ===

{{Pkg|fcitx5-chinese-addons}} では、デフォルトで全角句読点が使用されますが、{{ic|Ctrl + .}} で半角と全角の句読点を切り替えることができます。

Profile-sync-daemon

2021-12-04T12:41:07Z

Funcrab: /* FAQ */ === overlayfs モードとは? === タイトルのマーキング記述を削ってしまっていたので修正

[[Category:ウェブブラウザ]]
[[Category:スクリプト]]
[[en:Profile-sync-daemon]]
[[ru:Profile-sync-daemon]]
{{Related articles start}}
{{Related|Anything-sync-daemon}}
{{Related|Firefox}}
{{Related|Chromium}}
{{Related|Opera}}
{{Related|Pdnsd}}
{{Related|ソリッドステートドライブ}}
{{Related articles end}}

{{pkg|profile-sync-daemon}} (psd)はブラウザプロファイルを tmpfs で管理して定期的に物理ディスク (HDD/SSD) に同期させる、とても小さな擬似的なデーモンです。rsync でブラウザプロファイルの tmpfs のコピーとメディアのバックアップを同期させるという革新的な利用法によります。さらに、psd にはクラッシュからの復元機能が存在します。

{{Note|場合によっては、デフォルトの構成ファイル {{ic|/usr/share/psd/psd.conf}} のアップストリームが更新/変更されます。ユーザーコピー {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} をそれと比較する必要があります。 Arch Linux の pacman ではユーザーにこれを行うように通知する必要があります。他のパッケージマネージャーやディストリビューションのユーザーは、定期的にファイルを手動で、変更部分を差し替える必要があります。}}

{{Note|psd はブラウザのキャッシュを RAM にコピーするため、 [https://www.reddit.com/r/archlinux/comments/4l7gvm/very_slow_when_login/d3lrx9y/ login] の速度が低下する可能性があります。}}

== psd 設計目標とメリット ==

#透過的に利用できる
#物理ドライブの損耗が減る
#速度

プロファイルやブラウザキャッシュなどを [[tmpfs]] (RAM ディスク) に再配置して、ブラウザの使用に関連する I/O を物理ドライブから RAM に変更することにより、物理ドライブの消耗を抑えつつブラウザの速度や反応性を劇的に高められます。

{{Note|Chrome/Chromium, Firefox (v21 以上), Midori, Rekonq などのブラウザはプロファイルのディレクトリとは別個にキャッシュディレクトリを保存しています。この挙動を変更するのは profile-sync-daemon の射程外です。Chromium の [[Chromium 設定#tmpfs にキャッシュ]]セクションや [[Firefox Ramdisk]] 記事を参照して対処することが推奨されます。}}

== セットアップとインストール ==

{{Pkg|profile-sync-daemon}} パッケージをインストールします。

=== 設定ファイルの編集 ===
psd を初めて実行したときに、全ての設定が記述された {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} が作成されます (以下、このファイルを設定ファイルと呼称します)。

{{Note|psd を実行している間に設定ファイルを編集した場合、変更が適用されるのは init サービスから psd を再起動したときです。}}

$ psd
First time running psd so please edit /home/facade/.config/psd/psd.conf to your liking and run again.

* 任意で overlayfs を利用することで同期を高速化させてメモリの使用量を減らすことができます。USE_OVERLAYFS 変数を設定してください。このオプションを使う場合、{{ic|/usr/bin/psd-overlay-helper}} に sudo 権限が必要で、カーネルが overlayfs バージョン22以上に対応していなければなりません。この機能の詳細は下の FAQ を見て下さい。
* 任意で BROWSERS 行をアンコメントして tmpfs に同期するブラウザを指定することができます。BROWSERS がコメントアウトされている場合 (デフォルト)、サポートしているブラウザ全てのプロファイルが同期されます。
* 任意でクラッシュしたときに復帰するためのスナップショットを無効化することができます (非推奨)。USE_BACKUPS 変数で設定します。

例: Chromium, Opera, Midori をインストールしていて Chromium と Opera だけを tmpfs に同期する (Midori はバックアップのブラウザとしてたまにしか使わない) という場合:

# List browsers separated by spaces to include in the sync. Useful if you do not
# wish to have all possible browser profiles sync'ed which is the default if
# this variable is left commented.
#
# Possible values:
# chromium
# chromium-dev
# conkeror.mozdev.org
# epiphany
# firefox
# firefox-trunk
# google-chrome
# google-chrome-beta
# google-chrome-unstable
# heftig-aurora
# icecat
# inox
# luakit
# midori
# opera
# opera-beta
# opera-developer
# opera-legacy
# otter-browser
# qupzilla
# qutebrowser
# palemoon
# rekonq
# seamonkey
# surf
# vivaldi
# vivaldi-snapshot
#
BROWSERS="chromium opera"

psd のバージョン 5.54 から、overlayfs がネイティブでサポートされるようになりました。この機能を使うには 3.18.0 以上の Linux カーネルが必要です。

== サポートしているブラウザ ==

現在、以下のブラウザを自動で検出して管理します:
* [[Chromium]]
* {{AUR|chromium-dev}}
* {{AUR|conkeror-git}}
* [[Epiphany]]
* [[Firefox]] (安定版・ベータ版・Aurora 版など全てをサポート)
* {{AUR|google-chrome}}
* {{AUR|google-chrome-beta}}
* {{AUR|google-chrome-dev}}
* [https://bbs.archlinux.org/viewtopic.php?id=117157 heftig バージョンの Aurora]: Arch Linux 専用ブラウザ
* {{AUR|icecat}}
* [[Luakit]]
* [[Midori]]
* [[Opera]]
* [[Otter Browser]]
* [[Qutebrowser]]
* {{AUR|palemoon}} / {{AUR|palemoon-bin}}
* {{Pkg|seamonkey}}
* {{AUR|surf}}
* [[Vivaldi]]

== psd を使う ==

=== プレビューモード (parse) ===

'parse' オプションを使うことで {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} に基づいて ''psd'' が何を行うのかを正確に表示することができます。次のように呼び出して下さい:
$ psd p
Profile-sync-daemon v6.44

Systemd service: active
resync-timer: active
sync on sleep: enabled
use overlayfs: enabled

Psd will manage the following per /home/facade/.config/psd/psd.conf settings:

browser/psname: chromium/chromium
owner/group id: facade/100
sync target: /home/facade/.config/chromium
tmpfs dir: /run/user/1000/facade-chromium
profile size: 93M
overlayfs size: 39M
recovery dirs: 2 <- delete with the c option
dir path/size: /home/facade/.config/chromium-backup-crashrecovery-20150117_171359 (92M)
dir path/size: /home/facade/.config/chromium-backup-crashrecovery-20150119_112204 (93M)

browser/psname: firefox/firefox
owner/group id: facade/100
sync target: /mnt/data/docs/facade/mozilla/firefox/f8cv8bfu.default
tmpfs dir: /run/user/1000/facade-firefox-f8cv8bfu.default
profile size: 145M
overlayfs size: 13M
recovery dirs: none

上記の通り、特定のブラウザが BROWSERS 行に設定されていない場合、''psd'' は指定されたユーザーのサポートされているプロファイル全てを同期します。

=== クリーンモード ===
クリーンモードを使うと保存されているスナップショットを全て削除します。削除しても問題ない場合にのみ実行してください。

$ psd c

Profile-sync-daemon v6.03 on Arch Linux.

Deleting 2 crashrecovery dirs for profile /home/facade/.config/chromium
/home/facade/.config/chromium-backup-crashrecovery-20150117_171359
/home/facade/.config/chromium-backup-crashrecovery-20150119_112204

=== psd の起動と停止 ===

psd のバージョン 6.x シリーズのリリースから、公式でサポートされる init システムは systemd だけになりました。Psd には起動と停止を行うための systemd ユーザーサービスが付属しています (psd.service)。さらに、1時間毎に tmpfs からディスクに再同期させる resync-timer も含まれています。resync-timer は psd.service によって自動的に起動するため、あなたがタイマーを起動させる必要はありません。

systemd のユーザーモードの使い方がよくわからない場合、以下のコマンドで psd サービスを有効化できます:

$ systemctl --user [option] psd.service

次のオプションが利用できます: {{ic|start}} {{ic|stop}} {{ic|enable}} {{ic|disable}} {{ic|status}}。

===サポートしているディストリビューション===

psd は systemd サービスが付いているただの bash スクリプトなので、systemd が動作している Linux ならどこでも動作します。公式パッケージとして提供しているディストリビューションが数多くあり、psd をインストールする方法をユーザーがメンテナンスしている場合もあります。ソースから psd をビルドすることも可能です。利用できるパッケージやインストールの手順については公式ウェブサイトを見て下さい。

=== もっと頻繁に同期する (任意) ===

パッケージには一時間ごとに同期を行うタイマーが入っています。任意で、[[Systemd#ユニットファイルの編集|systemd ユニットを編集]]することでこの挙動を再定義することが可能です。以下の例は10分毎に同期させるようにタイマーを変更します:

{{hc|~/.config/systemd/user/psd-resync.timer.d/frequency.conf|<nowiki>
[Unit]
Description=Timer for Profile-sync-daemon

[Timer]
OnUnitActiveSec=
OnUnitActiveSec=10m
</nowiki>}}

オプションについては {{man|5|systemd.timer}} を見て下さい。

== FAQ ==

=== overlayfs モードとは? ===

{{Note|Linuxカーネルで利用可能な overlayfs にはいくつかのバージョンがあり、様々なディストリビューションで運用されています。バージョン22以下では、「overlayfs」と呼ばれるモジュールが使用されていますが、新しいバージョン（23以上）では、「overlay」と呼ばれるモジュールが使用されています（新しいバージョンでは、「fs」がないことに注意してください）。Psdは、カーネルが利用可能な overlayfs を使用するように設定されていれば、自動的にそれを検出します。}}

Overlayfs は Linux カーネル 3.18.0 でメインラインに取り込まれたシンプルなユニオンファイルシステムです。psd バージョン 5.54 から、overlayfs を使うことで psd の tmpfs 領域のメモリフットプリントを減らしたり、同期を高速化させることができるようになっています。オーバーレイマウントでは、プロファイル全体ではなく、変更が加えられたデータだけが書き出されるというところがミソです。overlayfs モードで実行した場合、psd がデフォルトで使用する同一の復帰機能も有効になります。Overlayfs モードは {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} の {{ic|1=USE_OVERLAYFS="yes"}} という行をアンコメントしてデーモンを再起動することで有効にできます。

Linux カーネルで利用できる overlayfs にはディストロによって複数のバージョンが存在します。バージョン 22 以前ではモジュールは 'overlayfs' と呼ばれていましたが、新しいバージョン (23 以上) ではモジュールの名前は 'overlay' になっています ('fs' が取られた)。Psd はあなたの使用しているカーネルで利用できる overlayfs を自動的に検出します。

psd のバージョン 6.05 から、overlayfs モードを利用するには {{ic|/usr/bin/psd-overlay-helper}} に (パスワードプロンプトが表示されない) sudo でアクセスできるようにするか、あるいはグローバルな sudo 権限が必要になりました。{{ic|/etc/sudoers}} に以下の行を設定することでユーザーに権限が与えられます。root で {{ic|/usr/bin/visudo}} を実行して追加してください:

foo ALL=(ALL) NOPASSWD: /usr/bin/psd-overlay-helper

上のプレビューモードのセクションの例を見れば、overlayfs を使うことでどれくらいメモリの使用量が節約できているのかわかります。"overlayfs size" とプロファイルごとの "profile size" の合計を比較してください。プロファイルに書き込まれているデータの量によって数字は変わってきますが、基本的に overlayfs のサイズはプロファイルのサイズより小さくなるはずです。

=== /run/user/xxxx にプロファイルを乗せるのに大量のメモリが必要です。メモリの割り当てを変えることはできますか? ===
{{ic|/run/user}} の容量は {{ic|/etc/systemd/logind.conf}} の RuntimeDirectorySize ディレクティブによって制御されるのが通常です (詳しくは {{ic|logind.conf}} の man ページを見て下さい)。デフォルトでは、物理メモリの 10% が使われますが、メモリの使用量を増やすことができます。tmpfs は実際に使用する分だけしか消費しません。許容できる最大限のサイズを指定してください。

=== overlayfs を有効にしたときに他のブラウザプロファイルディレクトリ "foo-back-ovfs" が作成されるのはなぜですか? ===
overlayfs は読み取り専用のベースコピー (いわゆる下層ディレクトリ) をプロファイルにマウントして、その上に新しいデータを管理することで機能します。読み取り専用ファイルシステムに再同期しないように、代わりにコピーが使われます。つまり overlayfs を使用することで、同期時間が高速になりメモリの使用量が減るのに対してホームディレクトリのディスク容量が使われるというトレードオフが成立しています。

=== システムがクラッシュして同期がされませんでした。どうすればいいですか? ===

運が良ければ、ブラウザプロファイルの"最新の問題がない"バックアップがファイルシステムに残っている可能性があります。{{ic|psd}} の再起動時に、プロファイルの tmpfs コピーのシンボリックリンクに問題がないか確認するチェックが行われます。問題がなかった場合、''psd'' は"最新の問題ない"バックアップのスナップショットを作成します。これは ''psd'' によってデータが失われないようにするためのサニティーチェックであり、データが消失した場合、他に原因があります。

{{Note|必要であれば、{{ic|$XDG_CONFIG_HOME/psd/psd.conf}} で {{ic|USE_BACKUPS}} 変数をアンコメントして 'no' に設定することでスナップショット/バックアップ機能を完全に無効化できます。}}

=== スナップショットはどこにありますか? ===

ブラウザによります。ブラウザプロファイルと同じディレクトリにスナップショットが存在し、リカバリが作られた時刻のタイムスタンプが付けられています。例えば、chromium なら {{ic|~/.config/chromium-backup-crashrecovery-20130912_153310}} などになります。もちろん、日付_時間の部分は異なっているでしょう。

=== スナップショットを復元するにはどうすればいいですか? ===

* {{ic|psd}} を停止してください。
* tmpfs のブラウザプロファイルディレクトリのシンボリックリンクがないことを確認してください。存在する場合、''psd'' は何らかの理由で適切に停止していません。
* プロファイルの"問題がある"コピーをバックアップに移動してください (やみくもに削除するのはやめましょう)。
* スナップショットディレクトリをブラウザが使用する名前にコピーしてください。

Chromium の例:
$ mv ~/.config/chromium ~/.config/chromium-bad
$ cp -a ~/.config/chromium-backup-crashrecovery-20130912_153310 ~/.config/chromium

Chromium を実行したらコピーしたバックアップスナップショットが使われます。全て問題ないようでしたら、ブラウザを閉じて psd を再起動してください。ここまできたら {{ic|~/.config/chromium-backup-crashrecovery-20130912_153310}} を削除してもかまいません。

=== psd でスナップショットを自動的に削除できますか? ===
"clean" スイッチを付けて psd を実行すればスナップショットが削除されます。

== サポート ==

気づいたことやコメントなどは [https://bbs.archlinux.org/viewtopic.php?pid=1026974 議論スレッド] に投稿してください。

== 他のディストロで PSD ==

''psd'' は bash スクリプトなので、どんな Linux ディストロでも動作します。それぞれのディストリビューションでパッケージが用意されていたり、ユーザーが自分でインストールできるように方法が用意されています。インストール方法は [https://github.com/graysky2/profile-sync-daemon#installation-from-distro-packages 公式ウェブサイト] を見て下さい。

== 参照 ==

* http://www.webupd8.org/2013/02/keep-your-browser-profiles-in-tmpfs-ram.html
* http://bernaerts.dyndns.org/linux/250-ubuntu-tweaks-ssd

Profile-sync-daemon

2021-12-04T12:36:04Z

Funcrab: /* overlayfs モードとは? */ ノートを記述

[[Category:ウェブブラウザ]]
[[Category:スクリプト]]
[[en:Profile-sync-daemon]]
[[ru:Profile-sync-daemon]]
{{Related articles start}}
{{Related|Anything-sync-daemon}}
{{Related|Firefox}}
{{Related|Chromium}}
{{Related|Opera}}
{{Related|Pdnsd}}
{{Related|ソリッドステートドライブ}}
{{Related articles end}}

{{pkg|profile-sync-daemon}} (psd)はブラウザプロファイルを tmpfs で管理して定期的に物理ディスク (HDD/SSD) に同期させる、とても小さな擬似的なデーモンです。rsync でブラウザプロファイルの tmpfs のコピーとメディアのバックアップを同期させるという革新的な利用法によります。さらに、psd にはクラッシュからの復元機能が存在します。

{{Note|場合によっては、デフォルトの構成ファイル {{ic|/usr/share/psd/psd.conf}} のアップストリームが更新/変更されます。ユーザーコピー {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} をそれと比較する必要があります。 Arch Linux の pacman ではユーザーにこれを行うように通知する必要があります。他のパッケージマネージャーやディストリビューションのユーザーは、定期的にファイルを手動で、変更部分を差し替える必要があります。}}

{{Note|psd はブラウザのキャッシュを RAM にコピーするため、 [https://www.reddit.com/r/archlinux/comments/4l7gvm/very_slow_when_login/d3lrx9y/ login] の速度が低下する可能性があります。}}

== psd 設計目標とメリット ==

#透過的に利用できる
#物理ドライブの損耗が減る
#速度

プロファイルやブラウザキャッシュなどを [[tmpfs]] (RAM ディスク) に再配置して、ブラウザの使用に関連する I/O を物理ドライブから RAM に変更することにより、物理ドライブの消耗を抑えつつブラウザの速度や反応性を劇的に高められます。

{{Note|Chrome/Chromium, Firefox (v21 以上), Midori, Rekonq などのブラウザはプロファイルのディレクトリとは別個にキャッシュディレクトリを保存しています。この挙動を変更するのは profile-sync-daemon の射程外です。Chromium の [[Chromium 設定#tmpfs にキャッシュ]]セクションや [[Firefox Ramdisk]] 記事を参照して対処することが推奨されます。}}

== セットアップとインストール ==

{{Pkg|profile-sync-daemon}} パッケージをインストールします。

=== 設定ファイルの編集 ===
psd を初めて実行したときに、全ての設定が記述された {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} が作成されます (以下、このファイルを設定ファイルと呼称します)。

{{Note|psd を実行している間に設定ファイルを編集した場合、変更が適用されるのは init サービスから psd を再起動したときです。}}

$ psd
First time running psd so please edit /home/facade/.config/psd/psd.conf to your liking and run again.

* 任意で overlayfs を利用することで同期を高速化させてメモリの使用量を減らすことができます。USE_OVERLAYFS 変数を設定してください。このオプションを使う場合、{{ic|/usr/bin/psd-overlay-helper}} に sudo 権限が必要で、カーネルが overlayfs バージョン22以上に対応していなければなりません。この機能の詳細は下の FAQ を見て下さい。
* 任意で BROWSERS 行をアンコメントして tmpfs に同期するブラウザを指定することができます。BROWSERS がコメントアウトされている場合 (デフォルト)、サポートしているブラウザ全てのプロファイルが同期されます。
* 任意でクラッシュしたときに復帰するためのスナップショットを無効化することができます (非推奨)。USE_BACKUPS 変数で設定します。

例: Chromium, Opera, Midori をインストールしていて Chromium と Opera だけを tmpfs に同期する (Midori はバックアップのブラウザとしてたまにしか使わない) という場合:

# List browsers separated by spaces to include in the sync. Useful if you do not
# wish to have all possible browser profiles sync'ed which is the default if
# this variable is left commented.
#
# Possible values:
# chromium
# chromium-dev
# conkeror.mozdev.org
# epiphany
# firefox
# firefox-trunk
# google-chrome
# google-chrome-beta
# google-chrome-unstable
# heftig-aurora
# icecat
# inox
# luakit
# midori
# opera
# opera-beta
# opera-developer
# opera-legacy
# otter-browser
# qupzilla
# qutebrowser
# palemoon
# rekonq
# seamonkey
# surf
# vivaldi
# vivaldi-snapshot
#
BROWSERS="chromium opera"

psd のバージョン 5.54 から、overlayfs がネイティブでサポートされるようになりました。この機能を使うには 3.18.0 以上の Linux カーネルが必要です。

== サポートしているブラウザ ==

現在、以下のブラウザを自動で検出して管理します:
* [[Chromium]]
* {{AUR|chromium-dev}}
* {{AUR|conkeror-git}}
* [[Epiphany]]
* [[Firefox]] (安定版・ベータ版・Aurora 版など全てをサポート)
* {{AUR|google-chrome}}
* {{AUR|google-chrome-beta}}
* {{AUR|google-chrome-dev}}
* [https://bbs.archlinux.org/viewtopic.php?id=117157 heftig バージョンの Aurora]: Arch Linux 専用ブラウザ
* {{AUR|icecat}}
* [[Luakit]]
* [[Midori]]
* [[Opera]]
* [[Otter Browser]]
* [[Qutebrowser]]
* {{AUR|palemoon}} / {{AUR|palemoon-bin}}
* {{Pkg|seamonkey}}
* {{AUR|surf}}
* [[Vivaldi]]

== psd を使う ==

=== プレビューモード (parse) ===

'parse' オプションを使うことで {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} に基づいて ''psd'' が何を行うのかを正確に表示することができます。次のように呼び出して下さい:
$ psd p
Profile-sync-daemon v6.44

Systemd service: active
resync-timer: active
sync on sleep: enabled
use overlayfs: enabled

Psd will manage the following per /home/facade/.config/psd/psd.conf settings:

browser/psname: chromium/chromium
owner/group id: facade/100
sync target: /home/facade/.config/chromium
tmpfs dir: /run/user/1000/facade-chromium
profile size: 93M
overlayfs size: 39M
recovery dirs: 2 <- delete with the c option
dir path/size: /home/facade/.config/chromium-backup-crashrecovery-20150117_171359 (92M)
dir path/size: /home/facade/.config/chromium-backup-crashrecovery-20150119_112204 (93M)

browser/psname: firefox/firefox
owner/group id: facade/100
sync target: /mnt/data/docs/facade/mozilla/firefox/f8cv8bfu.default
tmpfs dir: /run/user/1000/facade-firefox-f8cv8bfu.default
profile size: 145M
overlayfs size: 13M
recovery dirs: none

上記の通り、特定のブラウザが BROWSERS 行に設定されていない場合、''psd'' は指定されたユーザーのサポートされているプロファイル全てを同期します。

=== クリーンモード ===
クリーンモードを使うと保存されているスナップショットを全て削除します。削除しても問題ない場合にのみ実行してください。

$ psd c

Profile-sync-daemon v6.03 on Arch Linux.

Deleting 2 crashrecovery dirs for profile /home/facade/.config/chromium
/home/facade/.config/chromium-backup-crashrecovery-20150117_171359
/home/facade/.config/chromium-backup-crashrecovery-20150119_112204

=== psd の起動と停止 ===

psd のバージョン 6.x シリーズのリリースから、公式でサポートされる init システムは systemd だけになりました。Psd には起動と停止を行うための systemd ユーザーサービスが付属しています (psd.service)。さらに、1時間毎に tmpfs からディスクに再同期させる resync-timer も含まれています。resync-timer は psd.service によって自動的に起動するため、あなたがタイマーを起動させる必要はありません。

systemd のユーザーモードの使い方がよくわからない場合、以下のコマンドで psd サービスを有効化できます:

$ systemctl --user [option] psd.service

次のオプションが利用できます: {{ic|start}} {{ic|stop}} {{ic|enable}} {{ic|disable}} {{ic|status}}。

===サポートしているディストリビューション===

psd は systemd サービスが付いているただの bash スクリプトなので、systemd が動作している Linux ならどこでも動作します。公式パッケージとして提供しているディストリビューションが数多くあり、psd をインストールする方法をユーザーがメンテナンスしている場合もあります。ソースから psd をビルドすることも可能です。利用できるパッケージやインストールの手順については公式ウェブサイトを見て下さい。

=== もっと頻繁に同期する (任意) ===

パッケージには一時間ごとに同期を行うタイマーが入っています。任意で、[[Systemd#ユニットファイルの編集|systemd ユニットを編集]]することでこの挙動を再定義することが可能です。以下の例は10分毎に同期させるようにタイマーを変更します:

{{hc|~/.config/systemd/user/psd-resync.timer.d/frequency.conf|<nowiki>
[Unit]
Description=Timer for Profile-sync-daemon

[Timer]
OnUnitActiveSec=
OnUnitActiveSec=10m
</nowiki>}}

オプションについては {{man|5|systemd.timer}} を見て下さい。

== FAQ ==

overlayfs モードとは? ===

{{Note|Linuxカーネルで利用可能な overlayfs にはいくつかのバージョンがあり、様々なディストリビューションで運用されています。バージョン22以下では、「overlayfs」と呼ばれるモジュールが使用されていますが、新しいバージョン（23以上）では、「overlay」と呼ばれるモジュールが使用されています（新しいバージョンでは、「fs」がないことに注意してください）。Psdは、カーネルが利用可能な overlayfs を使用するように設定されていれば、自動的にそれを検出します。}}

Overlayfs は Linux カーネル 3.18.0 でメインラインに取り込まれたシンプルなユニオンファイルシステムです。psd バージョン 5.54 から、overlayfs を使うことで psd の tmpfs 領域のメモリフットプリントを減らしたり、同期を高速化させることができるようになっています。オーバーレイマウントでは、プロファイル全体ではなく、変更が加えられたデータだけが書き出されるというところがミソです。overlayfs モードで実行した場合、psd がデフォルトで使用する同一の復帰機能も有効になります。Overlayfs モードは {{ic|$XDG_CONFIG_HOME/psd/psd.conf}} の {{ic|1=USE_OVERLAYFS="yes"}} という行をアンコメントしてデーモンを再起動することで有効にできます。

Linux カーネルで利用できる overlayfs にはディストロによって複数のバージョンが存在します。バージョン 22 以前ではモジュールは 'overlayfs' と呼ばれていましたが、新しいバージョン (23 以上) ではモジュールの名前は 'overlay' になっています ('fs' が取られた)。Psd はあなたの使用しているカーネルで利用できる overlayfs を自動的に検出します。

psd のバージョン 6.05 から、overlayfs モードを利用するには {{ic|/usr/bin/psd-overlay-helper}} に (パスワードプロンプトが表示されない) sudo でアクセスできるようにするか、あるいはグローバルな sudo 権限が必要になりました。{{ic|/etc/sudoers}} に以下の行を設定することでユーザーに権限が与えられます。root で {{ic|/usr/bin/visudo}} を実行して追加してください:

foo ALL=(ALL) NOPASSWD: /usr/bin/psd-overlay-helper

上のプレビューモードのセクションの例を見れば、overlayfs を使うことでどれくらいメモリの使用量が節約できているのかわかります。"overlayfs size" とプロファイルごとの "profile size" の合計を比較してください。プロファイルに書き込まれているデータの量によって数字は変わってきますが、基本的に overlayfs のサイズはプロファイルのサイズより小さくなるはずです。

=== /run/user/xxxx にプロファイルを乗せるのに大量のメモリが必要です。メモリの割り当てを変えることはできますか? ===
{{ic|/run/user}} の容量は {{ic|/etc/systemd/logind.conf}} の RuntimeDirectorySize ディレクティブによって制御されるのが通常です (詳しくは {{ic|logind.conf}} の man ページを見て下さい)。デフォルトでは、物理メモリの 10% が使われますが、メモリの使用量を増やすことができます。tmpfs は実際に使用する分だけしか消費しません。許容できる最大限のサイズを指定してください。

=== overlayfs を有効にしたときに他のブラウザプロファイルディレクトリ "foo-back-ovfs" が作成されるのはなぜですか? ===
overlayfs は読み取り専用のベースコピー (いわゆる下層ディレクトリ) をプロファイルにマウントして、その上に新しいデータを管理することで機能します。読み取り専用ファイルシステムに再同期しないように、代わりにコピーが使われます。つまり overlayfs を使用することで、同期時間が高速になりメモリの使用量が減るのに対してホームディレクトリのディスク容量が使われるというトレードオフが成立しています。

=== システムがクラッシュして同期がされませんでした。どうすればいいですか? ===

運が良ければ、ブラウザプロファイルの"最新の問題がない"バックアップがファイルシステムに残っている可能性があります。{{ic|psd}} の再起動時に、プロファイルの tmpfs コピーのシンボリックリンクに問題がないか確認するチェックが行われます。問題がなかった場合、''psd'' は"最新の問題ない"バックアップのスナップショットを作成します。これは ''psd'' によってデータが失われないようにするためのサニティーチェックであり、データが消失した場合、他に原因があります。

{{Note|必要であれば、{{ic|$XDG_CONFIG_HOME/psd/psd.conf}} で {{ic|USE_BACKUPS}} 変数をアンコメントして 'no' に設定することでスナップショット/バックアップ機能を完全に無効化できます。}}

=== スナップショットはどこにありますか? ===

ブラウザによります。ブラウザプロファイルと同じディレクトリにスナップショットが存在し、リカバリが作られた時刻のタイムスタンプが付けられています。例えば、chromium なら {{ic|~/.config/chromium-backup-crashrecovery-20130912_153310}} などになります。もちろん、日付_時間の部分は異なっているでしょう。

=== スナップショットを復元するにはどうすればいいですか? ===

* {{ic|psd}} を停止してください。
* tmpfs のブラウザプロファイルディレクトリのシンボリックリンクがないことを確認してください。存在する場合、''psd'' は何らかの理由で適切に停止していません。
* プロファイルの"問題がある"コピーをバックアップに移動してください (やみくもに削除するのはやめましょう)。
* スナップショットディレクトリをブラウザが使用する名前にコピーしてください。

Chromium の例:
$ mv ~/.config/chromium ~/.config/chromium-bad
$ cp -a ~/.config/chromium-backup-crashrecovery-20130912_153310 ~/.config/chromium

Chromium を実行したらコピーしたバックアップスナップショットが使われます。全て問題ないようでしたら、ブラウザを閉じて psd を再起動してください。ここまできたら {{ic|~/.config/chromium-backup-crashrecovery-20130912_153310}} を削除してもかまいません。

=== psd でスナップショットを自動的に削除できますか? ===
"clean" スイッチを付けて psd を実行すればスナップショットが削除されます。

== サポート ==

気づいたことやコメントなどは [https://bbs.archlinux.org/viewtopic.php?pid=1026974 議論スレッド] に投稿してください。

== 他のディストロで PSD ==

''psd'' は bash スクリプトなので、どんな Linux ディストロでも動作します。それぞれのディストリビューションでパッケージが用意されていたり、ユーザーが自分でインストールできるように方法が用意されています。インストール方法は [https://github.com/graysky2/profile-sync-daemon#installation-from-distro-packages 公式ウェブサイト] を見て下さい。

== 参照 ==

* http://www.webupd8.org/2013/02/keep-your-browser-profiles-in-tmpfs-ram.html
* http://bernaerts.dyndns.org/linux/250-ubuntu-tweaks-ssd

Btrfs

2021-12-04T12:10:21Z

Funcrab: /* 圧縮 */ zstdのコマンド関連を記述した

[[Category:ファイルシステム]]
[[en:Btrfs]]
[[fr:Btrfs]]
[[zh-hans:Btrfs]]
{{Related articles start}}
{{Related|ファイルシステム}}
{{Related|mkinitcpio}}
{{Related|Snapper}}
{{Related|dm-crypt/システム全体の暗号化#Btrfs サブボリュームとスワップ}}
{{Related articles end}}

[[Wikipedia:ja:Btrfs]] より:

:''Btrfs (B-tree File System: 読み方は "バター FS", "ベター FS", "B木 FS", "ビーティーアール FS" など) は Linux 向けの実験的なコピーオンライトのファイルシステムで GPL でライセンスされています。Oracle Corporation によって2007年から開発が開始されました。2014年8月にはディスク上のフォーマットが固まっています。''

[https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs Wiki] より:

:''Btrfs は Linux 用の全く新しいコピーオンライト (COW) のファイルシステムです。先進的な機能を実装することを目指しつつ、障害耐性を持ち簡単に管理できることに焦点が置かれています。Btrfs は Oracle, Red Hat, Fujitsu, Intel, SUSE, STRATO やその他多くの人々によって共同で開発されており GPL でライセンスされていて誰でも貢献できるように開かれています。''

{{Warning|Btrfs には実験的な機能が存在します。詳しくは Btrfs Wiki の [https://btrfs.wiki.kernel.org/index.php/Status Status] や [https://btrfs.wiki.kernel.org/index.php/FAQ#Is_btrfs_stable.3F Is Btrfs stable?]、[https://btrfs.wiki.kernel.org/index.php/Getting_started Getting started] などを見てください。[[#既知の問題]]も参照。}}

== インストール ==

Btrfs はデフォルトのカーネルに含まれており、ツール ({{pkg|btrfs-progs}}) は[[公式リポジトリ]]から入手できます。[[GRUB]], [[mkinitcpio]], [[Syslinux]] には Btrfs のサポートがあるので追加の設定は必要ありません。

=== 追加のパッケージ ===

* {{Pkg|btrfs-progs}} には Btrfs ファイルシステムのエラーを修正できるツール ''btrfsck'' が含まれています。
* {{AUR|btrfs-progs-git}} はナイトリービルドです。

{{Tip|Btrfs を効率的に動かす提案が [https://btrfs.wiki.kernel.org/index.php/Getting_started Btrfs Wiki Getting Started] に載っています。}}

== Btrfs の一般的な管理 ==

=== 新しいファイルシステムを作成する ===

Btrfs ファイルシステムは新規作成することも既存のファイルシステムから変換することも可能です。

パーティションをフォーマットするには次を実行してください:

# mkfs.btrfs -L ''mylabel'' /dev/''partition''

{{Note|1=2013年11月の[https://git.kernel.org/cgit/linux/kernel/git/mason/btrfs-progs.git/commit/?id=c652e4efb8e2dd76ef1627d8cd649c6af5905902 この] コミット以降、Btrfs のデフォルトのブロックサイズは 16KB になっています。}}

大きいブロックサイズをデータ・メタデータに使うには、下の例のように {{ic|-n}} スイッチを使って {{ic|nodesize}} の値を指定して下さい (例: 16KB ブロック):

# mkfs.btrfs -L ''mylabel'' -n 16k /dev/''partition''

複数のデバイスを入力して RAID を作成することもできます。サポートされている RAID レベルは RAID 0, RAID 1, RAID 10 などです。デフォルトではメタデータはミラーされデータはストライピングされます。より多くの情報が必要な場合、[https://btrfs.wiki.kernel.org/index.php/Using_Btrfs_with_Multiple_Devices Using Btrfs with Multiple Devices] を見てください。

# mkfs.btrfs [options] /dev/<part1> /dev/<part2>

{{Tip|ミラーリングをしない場合、''raid0'' オプションを使って下さい: {{ic|# mkfs.btrfs -d raid0 /dev/''part1'' /dev/''part2''}}。}}

{{Warning|Btrfs の RAID 5 と RAID 6 モードには致命的な欠点があります。壊れても良いデータ以外でテストすべきではありません。現状については https://btrfs.wiki.kernel.org/index.php/RAID56 を参照してください。}}

=== 使用済み・空き容量を表示する ===

{{ic|/usr/bin/df}} などの linux の一般的なユーザー空間ツールは Btrfs パーティションの空き容量について間違った報告をします。なぜならメタデータによって使用される予約済みのスペースを考慮しないからです。btrfs パーティションに問い合わせるときは {{ic|/usr/bin/btrfs}} を使うのが推奨されています。以下は {{ic|df -h}} を使った時と、{{ic|btrfs filesystem df}} を使った時の出力の例です:

{{hc|$ df -h /|
Filesystem Size Used Avail Use% Mounted on
/dev/sda3 119G 3.0G 116G 3% /
}}

{{hc|$ btrfs filesystem df /|2=
Data: total=3.01GB, used=2.73GB
System: total=4.00MB, used=16.00KB
Metadata: total=1.01GB, used=181.83MB
}}

{{ic|df -h}} は 3.0GB 使用されているとしているのに対して {{ic|btrfs filesystem df}} はデータは 2.73GB だと報告しているのに気づいて下さい。これは Btrfs がスペースをプールに割り当てているためです。本当のディスク使用量は3つの 'used' を合計した値であり、{{ic|df -h}} による 3.0GB よりかは下回ります。

{{Note|1=カーネル 3.15 以上で {{ic|btrfs filesystem df}} の出力にタイプ {{ic|unknown}} のエントリが表示される場合、これは表示のバグです。[http://thread.gmane.org/gmane.comp.file-systems.btrfs/34419 このパッチ] によって、このエントリは一種のバッファである GlobalReserve を意味しています。このエントリは RAID では {{ic|unknown, single}} として表示され re-balance することができません。}}

他にも大まかに使用容量を読み出すコマンドとして {{ic|btrfs filesystem show}} が使用できます:

# btrfs filesystem show /dev/sda3

空き容量の情報を取得する最新のコマンドは {{ic|btrfs filesystem usage}} です:

# btrfs filesystem usage

{{Note|1={{ic|btrfs filesystem usage}} コマンドは RAID レベルが {{ic|RAID5/RAID6}} だと上手く機能しません。}}

== 既知の問題 ==

試行する前に知っておくべき制限事項が存在します。

=== 暗号化 ===

Btrfs にはビルトインの暗号化サポートはありません(将来実装される予定です)が、<code>mkfs.btrfs</code> をする前にパーティションを暗号化することができます。[[dm-crypt]] を見て下さい。

既に btrfs ファイルシステムを作成してしまっている場合、[[EncFS]] や [[TrueCrypt]] などを使うことができます。ただし btrfs のいくつかの機能が使えなくなるかもしれません。

=== スワップファイル ===

Btrfs の [[スワップファイル]] は Linux カーネル5.0 以降でサポートされています。[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=ed46ff3d423780fa5173b38a844bf0fdb210a2a7] スワップファイルを初期化する適切な方法は、最初にファイルをホストする非圧縮、非スナップショットのサブボリュームを作成し、そのディレクトリに ''cd'' してから、長さゼロのファイルを作成し、{{ic|No_COW}} を設定することです。属性を [https://wiki.archlinux.jp/index.php/%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E5%B1%9E%E6%80%A7#chattr_.E3.81.A8_lsattr chattr] で指定し、圧縮が無効になっていることを確認します。

# cd ''/path/to/swapfile''
# truncate -s 0 ./swapfile
# chattr +C ./swapfile
# btrfs property set ./swapfile compression none

詳細な設定については、 [https://wiki.archlinux.jp/index.php/%E3%82%B9%E3%83%AF%E3%83%83%E3%83%97#.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E4.BD.9C.E6.88.90 スワップファイルの作成] を参照してください。スワップファイルへの休止状態の構成については、[https://wiki.archlinux.org/index.php/Power_management/Suspend_and_hibernate#Hibernation_into_swap_file_on_Btrfs Hibernation into swap file on Btrfs]で説明されています。

{{Note|1=Linux カーネル5.0 以降、 Btrfs にはネイティブスワップファイルのサポートがありますが、いくつかの制限があります。
* スワップファイルをスナップショットサブボリュームに置くことはできません。適切な手順は、スワップファイルを配置する新しいサブボリュームを作成することです。
* 複数のデバイスにまたがるファイルシステム上のスワップファイルはサポートされていません。 [https://btrfs.wiki.kernel.org/index.php/FAQ#Does_btrfs_support_swap_files.3F Btrfs wiki: Does btrfs support swap files?] および [https://bbs.archlinux.org/viewtopic.php?pid=1849371#p1849371 Arch forums discussion]。
}}

== 機能 ==

様々な機能が備わっていて、それぞれ設定が可能です。

=== クォータ ===

{{warning|Qgroup はまだ安定状態ではなくサブボリュームのスナップショットとクォータを組み合わせると操作によってパフォーマンスに問題をきたします (スナップショットの削除など)。さらに [https://btrfs.wiki.kernel.org/index.php/Quota_support#Known_issues 既知の問題] が存在しています。}}

Btrfs におけるクォータのサポートはクォータグループ (qgroup) を利用してサブボリュームレベルで実装されています: 各サブボリュームにはデフォルトで ''0/<subvolume id>'' という形式でクォータグループが割り当てられています。必要であればクォータグループを作成することもできます。

クォータグループを使うにはまずクォータを有効にする必要があります:

# btrfs quota enable <path>

上記のコマンドを実行してから新しいサブボリュームを作成すると、グループによって制御が可能になります。既存のサブボリュームでも制御を行いたい場合、クォータを有効にしてから、''<subvolume id>'' を使ってサブボリュームごとにクォータグループを作成して再スキャンしてください:

# btrfs subvolume list <path> | cut -d' ' -f2 | xargs -I{} -n1 btrfs qgroup create 0/{} <path>
# btrfs quota rescan <path>

Btrfs のクォータグループはツリー構造になっていて、サイズ制限はクォータグループごとに設定し、ツリーに属しているサブボリュームに制限が課せられます。

クォータグループで設定できる制限は合計データ使用量・非共有のデータ使用量・圧縮データ使用量、あるいはそれらを組み合わせたものです。元のボリュームファイルを削除してコピーを残す場合、他のクォータグループの非共有制限が変わるため、ファイルのコピーや削除で制限に抵触する可能性があります。例えば、新しいスナップショットが元のサブボリュームの全てのブロックと同じデータを持っている場合、どちらかのサブボリュームだけで共通データを削除するともう片方のサブボリュームの制限に引っかかる可能性があります。

クォータグループに制限を設定するには、{{ic|btrfs qgroup limit}} コマンドを使います。合計使用量の制限や非共有制限 ({{ic|-e}}) または圧縮制限 ({{ic|-c}}) が設定できます。ファイルシステムの特定のパスにおける使用量や制限を表示するには:

# btrfs qgroup show -reF <path>

=== コミット間隔の設定 ===

ファイルシステムにどのデータを書き込むかは BTRFS とシステム全体の設定によって決められます。BTRFS のデフォルトでは30秒のチェックポイントインターバルでファイルシステムに新しいデータが送られます。この間隔は[[#チェックポイントインターバル|後述]]のマウントオプションで調整可能です。

システム全体の設定もインターバルに影響を与えます。それには /proc/sys/vm/* 以下のファイルも含まれており、この wiki では扱っていません。Documentation/sysctl/vm.txt にこれらのファイルに関するカーネルドキュメントがあります。

=== コピーオンライト (CoW) ===

デフォルトでは、いついかなる時も、全てのファイルに対して btrfs は CoW を行います: 今までに存在していなかったファイルを書き込もうとした場合、データは空き領域に書き込まれて、ファイルシステムのメタデータブロックが CoW されます。"通常の"ファイルシステムでは、ファイルの一部を上書きした場合、置換先のデータに直接上書きがなされます。CoW ファイルシステムでは、新しいデータはディスクの空き容量に書き込まれて、それから、新しいデータを参照するようにファイルのメタデータが変更されます。元のデータはどこからも参照されなくなって始めて削除されます。

CoW にはアドバンテージがありますが、大きなファイルに小さなランダム書き込みを行うときのパフォーマンスについてはあまり良い影響を与えません。たとえ"コピー"を行わないときでもファイルを断片化させるからです。データベースファイルや仮想マシンイメージについては CoW を無効化することが推奨されます。

CoW を無効にする方法の一つは "nodatacow" オプションを使ってマウントすることです。しかしながら、これではファイルシステム全体で CoW を無効にすることになります。

{{Note|{{ic|nodatacow}} は新規作成されたファイルにのみ影響します。既存のファイルにはまだ CoW が行われる可能性があります。}}

ファイルやディレクトリ単体で CoW を無効化するには、次のコマンドを使って下さい:

$ chattr +C </dir/file>

以上のコマンドで CoW が無効化されるのはファイルの参照が一つしかない操作の場合に限られます。複数の参照がある場合 (例: {{ic|1=cp --reflink=always}} を使用したりファイルシステムのスナップショットが存在する場合)、CoW は依然として実行されます。

{{Note|chattr の man ページより: btrfs では、 'C' フラグは新しい、または空のファイルにセットしなければなりません。既にデータブロックを持つファイルにフラグを設定した場合、ファイルに新しいブロックが割り当てられると完全な安定のためにフラグの定義が消されます。ディレクトリに 'C' フラグがセットされている場合、そのディレクトリ自体には影響がなく、ディレクトリに作成された新しいファイルに {{ic|No_COW}} 属性が付けられます。}}

{{Tip|上の Note に従い、ディレクトリ内の既存のファイルで CoW を無効にするときは、次のようにします:
$ mv ''/path/to/dir'' ''/path/to/dir''_old
$ mkdir ''/path/to/dir''
$ chattr +C ''/path/to/dir''
$ cp -a ''/path/to/dir''_old/* ''/path/to/dir''
$ rm -rf ''/path/to/dir''_old
作業中にファイルが使用されないように気を付けてください。また、 {{ic|mv}} や下で説明する {{ic|cp --reflink}} では CoW を無効にできないことに注意してください。
}}

同じように、ファイルのコピー時に CoW を強制してスペースを節約するには次を使って下さい (デフォルトでは {{ic|cp}} を使った場合、実際にデータがコピーされます):

$ cp --reflink source dest

dest ファイルが変更されると、元から変更されたブロックだけがディスクに書き込まれます。cp を 'cp --reflink=auto' にするエイリアスを作ってもいいかもしれません。

=== マルチデバイスファイルシステムと RAID 機能 ===

[https://btrfs.wiki.kernel.org/index.php/Using_Btrfs_with_Multiple_Devices Using Btrfs with Multiple Devices] の提案も見て下さい。

====マルチデバイスファイルシステム====

{{Note|適当な ''.device'' ジョブ以外でマルチデバイスファイルシステムをマウントするとファイルシステムの [https://github.com/systemd/systemd/issues/1921 バグ] が原因でフリーズして systemd が起動できなくなります。}}

''btrfs'' ファイルシステムを作成する際に、''mkfs.btrfs'' したい分だけのパーティション・デバイスを指定することができます。ファイルシステムは指定された全てのデバイスにわたって作成されます。このように '''"'''pool'''"''' することによって、複数のパーティションやデバイスを一つの大きな ''btrfs'' ファイルシステムにできるのです。

また、既に存在している btrfs ファイルシステムからデバイスを追加・削除することも可能です(用心が必要ですが)。

(btrfs ボリュームとも呼ばれる) マルチデバイス ''btrfs'' ファイルシステムは {{ic|btrfs device scan}} を実行するまで認識されません。''btrfs'' mkinitcpio フックがこれを行います。

====RAID 機能====

{{Note|カーネル 3.19 から、復元や再構築のコードもマージされています。通常の使用に耐えうるようになっています。新しいコードなので、安定化するのは次かその次のバージョンのカーネルになると思われます。}}

マルチデバイスファイルシステムを作成するとき、ファイルシステムに追加したデバイス全体で RAID0, RAID1, RAID10, RAID5, RAID6 を使うように指定することもできます。RAID レベルはデータとメタデータで別個に適用することができます。デフォルトでは、メタデータはシングルボリュームやマルチディスクの RAID1 で複製されます。

btrfs は raid0, raid1, raid10 のブロックペアで動作します:

raid0 - 2つのデバイスに分散されるブロックペア

raid1 - 2つのデバイスに書き込まれるブロックペア

マウント中に {{ic|btrfs balance}} コマンドを使って RAID レベルを変更することができます:

# btrfs balance start -mconvert=RAIDレベル -dconvert=RAIDレベルマウントポイント

ディスクが2つある場合、md-raid ([[mdadm]]) で定義する raid レベルと一致します。ディスクが3つ以上の場合は、md-raid とは全く異なるものになります。

例えば:
* md による raid1 の3つの 1TB ディスクを使って、1TB の空き容量で、2つのディスクを失ってもデータが消失しないようにすることが出来ます。
* data=raid1 の Btrfs ボリュームの3つの 1TB ディスクを使って、満杯になるまでほぼ 1.5TB のデータを保存することができます。ディスクが1つなくなってもデータは消失しません。

Btrfs はディスクに分散してブロックペアを配置するのにラウンドロビン方式を使っています。Linux 3.0 から,ブロックペアを分散する際に大きなディスクを優先するように quasi-round-robin 方式が使われています。これによって複数のディスクからディスクセットが出来ているときに raid0 や raid1 でほとんど (もしくは全て) の領域を効率的に利用することが可能になっています。例えば、1台の 1TB のディスクと2台の 500GB のディスクからなるセットで data=raid1 を使用すると 1TB のディスクには全てのブロックのコピーが、500GB のそれぞれのディスクにはブロックが交互に (ラウンドロビンで) 配置されます。完全な利用効率が実現されます。1TB のディスクと 750GB のディスク、500GB のディスクからなるセットでも同じことが行われますが、ファイルシステムは 750GB のディスクの 250GB が利用できないことを報告します。いつでも全ての領域を活用できるようにするには (最後に上げた例でも)、data=single を使って下さい (data=single は raid コントローラによって定義される JBOD と同じです)。詳しくは [https://btrfs.wiki.kernel.org/index.php/FAQ#How_much_space_do_I_get_with_unequal_devices_in_RAID-1_mode.3F BTRFS FAQ] を参照。

{{Warning|パリティ RAID (RAID 5/6) のコードにはデータを消失する可能性のある深刻なバグが存在します。詳しくは Btrfs Wiki の [https://btrfs.wiki.kernel.org/index.php/RAID56 RAID5/6] のページや [https://www.mail-archive.com/linux-btrfs@vger.kernel.org/msg55161.html linux-btrfs メーリングリスト] のバグレポートを読んでください。}}

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

btrfs の機能のひとつにサブボリュームがあります。サブボリュームは基本的にファイルとディレクトリを保持している名前の付いた b 木です。root ツリーのツリーの中に inode を持ち、root 以外の所有者やグループも設定できます。サブボリュームは任意でブロックを割り当てることもできます。ブロックとファイルエクステントの全ては参照カウントでありスナップショットを可能にしています。仮想マシンの動的な容量拡張に似て、必要な時に必要な分だけのデバイス上の容量を使います。また、サブボリュームを異なったマウントオプションを使ってマウントすることでセキュリティの柔軟性を持たせることもできます。

==== サブボリュームを作成する ====

サブボリュームを作成するには:
# btrfs subvolume create ''/path/to/subvolume''

==== サブボリュームを一覧する ====

現在のサブボリュームのリストを表示するには:

# btrfs subvolume list -p .

==== サブボリュームをマウントする ====

サブボリュームは {{ic|1=subvol=''/path/to/subvolume''}} や {{ic|1=subvolid=''objectid''}} マウントフラグを使うことでファイルシステムのパーティションと同じようにマウントできます。例えば、{{ic|subvol_root}} という名前のサブボリュームが存在したら {{ic|/}} にマウントすることができます。ファイルシステムのトップレベルにサブボリュームを作成して適切なマウントポイントにマウントすることで、伝統的なファイルシステムのパーティションと同じように使うことができ、[[#スナップショット|スナップショット]]を使用してファイルシステムを前の状態に簡単に戻すことが可能です。

{{Tip|1=トップレベルのサブボリューム (ID=5) を {{ic|/}} として使用しないことでサブボリュームのレイアウトの変更を簡単にできます。サブボリュームを作成して実際のデータを保存して {{ic|/}} にマウントします。}}

[[Snapper#推奨ファイルシステムレイアウト]], [https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Managing_Snapshots Btrfs SysadminGuide#Managing Snapshots], [https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Layout Btrfs SysadminGuide#Layout] などにサブボリュームを使用するファイルシステムレイアウトの例が存在します。

===== マウントオプション =====

{{ic|1=subvol=}} でサブボリュームをマウントする際、複数のマウントオプションが利用できます。例えば、[[#圧縮|圧縮]]や[[#コピーオンライト (CoW)|コピーオンライト (CoW)]] に関するマウントオプションが使えます。

詳しくは [https://btrfs.wiki.kernel.org/index.php/Mount_options Btrfs Wiki Mount options] や [https://btrfs.wiki.kernel.org/index.php/Gotchas Btrfs Wiki Gotchas] を見てください。様々なマウントオプションを使うことで Btrfs の特性は大きく変わります。活発に開発されているファイルシステムであるため、リグレッションも考慮してください。[[#参照|参照]]セクションには複数のベンチマークへのリンクが存在します。

{{Warning|特定のマウントオプションは安全を保証するための機能を無効化して、ファイルシステムが完全に破損する危険性を引き上げてしまいます。}}

==== サブボリュームをルートとしてマウントする ====

サブボリュームをルートマウントポイントとして使用するには、{{ic|1=rootflags=subvol=''/path/to/subvolume''}} を使用して [[カーネルパラメータ#設定|カーネルパラメータ]] 経由でサブボリュームを指定します。{{ic|/etc/fstab}} でルート・マウントポイントを編集し、マウント・オプションに {{ic|1=subvol=}} を指定します。または、サブボリュームの ID {{ic|1=rootflags=subvolid=''objectid''}} をカーネルパラメータとして使い、{{ic|1=subvolid=''objectid''}} を {{ic|/etc/fstab}} のマウントオプションとして指定することもできます。

==== デフォルトのサブボリュームを設定する ====

{{Warning|{{ic|btrfs subvolume set-default}} でデフォルトのサブボリュームを変更すると、{{ic|1=subvolid=0}} マウントオプションを使わない限り、ファイルシステムのトップレベルがアクセスできなくなります。参照: [https://btrfs.wiki.kernel.org/index.php/SysadminGuide Btrfs Wiki Sysadmin Guide]。}}

{{ic|1=subvol=}} マウントオプションが指定されていない場合、デフォルトのサブボリュームがマウントされます。

# btrfs subvolume set-default ''subvolume-id'' /.

'''サンプル:'''

{{hc|# btrfs subvolume list .|
ID 258 gen 9512 top level 5 path root_subvolume
ID 259 gen 9512 top level 258 path home
ID 260 gen 9512 top level 258 path var
ID 261 gen 9512 top level 258 path usr
}}

# btrfs subvolume set-default 258 .

'''リセット:'''

# btrfs subvolume set-default 0 .

==== スナップショット ====

詳しくは [https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Snapshots Btrfs Wiki SysadminGuide#Snapshots] を見て下さい。

スナップショットを作成するには:

# btrfs subvolume snapshot ''source'' [''dest''/]''name''

スナップショットは再帰的ではありません、つまりサブボリューム内にある全てのサブボリュームはスナップショットでは空のディレクトリになります。

==== 送信/受信 ====

サブボリュームは {{ic|send}} コマンドを使って標準出力やファイルに送信することができます。Btrfs の {{ic|receive}} コマンドにパイプで渡すことで非常に便利に使うことが可能です。例えば、{{ic|/root_backup}} という名前のスナップショットを {{ic|/backup}} に送信するには以下のコマンドを実行します:

# btrfs send /root_backup | btrfs receive /backup

送信するスナップショットは読み取り専用である必要があります。上記のコマンドは外部デバイスにサブボリュームをコピーするのにも使えます (例えば上の {{ic|/backup}} を USB ディスクにマウント)。

また、スナップショットの差分だけを送信することも可能です。例えば、上記のように {{ic|root_backup}} のコピーを送信したことがある場合、{{ic|root_backup_new}} という名前の読み取り専用のスナップショットを新しく作成してから、増加差分だけを {{ic|/backup}} に送信するには:

# btrfs send -p /root_backup /root_backup_new | btrfs receive /backup

これで {{ic|root_backup_new}} という名前の新しいサブボリュームが {{ic|/backup}} に作成されます。

差分バックアップをしたり自動的にバックアップを行うツールは [https://btrfs.wiki.kernel.org/index.php/Incremental_Backup Btrfs Wiki's Incremental Backup] を見てください。

=== デフラグメンテーション ===

Btrfs はオンラインデフラグをサポートしています。root フォルダのメタデータをデフラグするには、次を実行してください:
# btrfs filesystem defragment /
上のコマンドはファイルシステム全体のデフラグを''行いません''。詳しくは、btrfs wiki の[https://btrfs.wiki.kernel.org/index.php/Problem_FAQ#Defragmenting_a_directory_doesn.27t_work このページ]を見て下さい。

ファイルシステム全体をデフラグするには、次を実行してください:
# btrfs filesystem defragment -r -v /

=== 圧縮 ===

Btrfs は透過圧縮をサポートしています、これはパーティション上の全てのファイルが自動的に圧縮されることを意味します。このことはファイルの容量を減らすだけでなく、特に [https://www.phoronix.com/scan.php?page=article&item=btrfs-zstd-compress zstd アルゴリズム] や [https://www.phoronix.com/scan.php?page=article&item=btrfs_lzo_2638&num=1 lzo アルゴリズム] を使う場合、一般的に [https://www.phoronix.com/scan.php?page=article&item=btrfs_compress_2635&num=1 パフォーマンスが向上] します。

圧縮は {{ic|1=compress=''arg''}} マウントオプションを使って有効にします。''alg'' は{{ic|zlib}}、{{ic|lzo}}、{{ic|zstd}}、または{{ic|no}}（圧縮しない場合）のいずれかです
。マウントオプションが追加された後に作成・変更されたファイルだけに圧縮が適用されます。ただし、{{ic|btrfs filesystem defragment -c''alg''}} コマンドを使うことで既存のファイルに圧縮を適用することも簡単にできます (例えば ext3/4 から変換した後)。{{ic|''alg''}} は {{ic|zlib}}、{{ic|lzo}}、{{ic|zstd}} のいずれかです。{{ic|zstd}} を使ってファイルシステム全体を再圧縮するには、次のコマンドを実行してください:

# btrfs filesystem defragment -r -v -czstd /

空の Btrfs パーティションに Arch をインストールする時に圧縮を有効にするには、ファイルシステムを[[マウント]]する時に compress オプションを使います:

# mount -o compress=zstd /dev/sdxY /mnt/

設定の際、[[fstab]] でルートファイルシステムのマウントオプションに {{ic|1=compress=zstd}} を追加してください。

{{Tip|{{ic|compress}} マウントオプションを使わずファイルごとに圧縮を有効にすることも可能です。ファイルに {{ic|chattr +c}} を適用するだけです。ディレクトリに適用した場合、新しいファイルは自動的に圧縮されます。}}

{{Warning|このオプションを使用すると、{{ic|zstd}} をサポートしていない古いカーネルや {{Pkg|btrfs-progs}} を使用しているシステムでは、ファイルシステムの読み取りや修復ができなくなる可能性があります。
[[GRUB]] は 2.04 で ''zstd'' をサポートしました。MBR/ESP にインストールされているブートローダが自動的にアップグレードされないので、BIOS/UEFI の設定に応じたオプションで {{ic|grub-install}} を実行して、実際にアップグレードしていることを確認してください。[https://bugs.archlinux.org/task/63235 FS#63235] を参照してください。}}

=== チェックポイントインターバル ===
Linux 3.12 から、チェックポイントインターバルをデフォルトの30秒から変えることができるようになっています。{{ic|/etc/fstab}} の btrfs パーティションに {{ic|commit}} マウントフラグを追加してください。

LABEL=arch64 / btrfs defaults,noatime,compress=lzo,commit=120 0 0

=== パーティショニング ===

Btrfs はデータストレージデバイス全体を占領して [[Master Boot Record|MBR]] や [[GUID Partition Table|GPT]] パーティショニングスキームを置き換えることができます。[[#サブボリューム|サブボリューム]]を使ってパーティションを模すことが可能です。ディスクを一つしか使っていない場合、このアプローチにはいくつか制限があります:

* [[fstab|マウントポイント]]によって異なる[[ファイルシステム]]を使うことはできません
* Btrfs は[[スワップ#スワップファイル|スワップファイル]]をサポートしていないので[[スワップ|スワップ領域]]を使うことができません。[[スワップ#スワップパーティション|スワップパーティション]]も作れません。ハイバネーションイメージはスワップ領域に保存されるので、ハイバネーション/レジュームも使えません
* [[Unified Extensible Firmware Interface|UEFI]] を使って起動できません

既存のパーティションテーブルを Btrfs で上書きするには、次のコマンドを実行してください:
# mkfs.btrfs /dev/sdX
{{ic|/dev/sdaX}} を指定するとパーティションスキーム全体を置き換える代わりに既存のパーティションがフォーマットされます。

[[Master Boot Record|MBR]] のデータストレージデバイスと同じ方法で[[ブートローダー]]をインストールしてください。例えば [[GRUB]] なら:
# grub-install --recheck /dev/sdX

{{Warning|{{ic|btrfs subvolume set-default}} コマンドを使ってデフォルトのサブボリュームをトップレベル (ID 0) 以外に変更すると GRUB を破壊するおそれがあります。リセットするには [[#デフォルトのサブボリュームを設定する]] を見て下さい。}}

=== Scrub ===

Btrfs の scrub はオンラインのファイルシステムチェックツールです。ファイルシステム上の全てのデータとメタデータを読み込んで、チェックサムと RAID ストレージの重複コピーを使用してデータに破損がないか確認して修復を行います。

# btrfs scrub start /
# btrfs scrub status /

{{Warning|scrub プロセスが動作しているとシステムはサスペンドできません、詳しくは [http://comments.gmane.org/gmane.comp.file-systems.btrfs/33106 このスレッド] を見て下さい。}}

==== systemd サービス ====

{{Pkg|btrfs-progs}} パッケージには特定のマウントポイントをひと月毎にスクラブする {{ic|btrfs-scrub@.timer}} ユニットが付属しています。エンコードしたパスを指定してタイマーを[[有効化]]してください。例えば {{ic|/}} なら {{ic|btrfs-scrub@-.timer}} を、{{ic|/home}} なら {{ic|btrfs-scrub@home.timer}} を使います。

{{ic|btrfs-scrub@.service}} を[[起動]]することで手動でスクラブを実行することもできます (同じくエンコードしたパスを指定してください)。{{ic|btrfs scrub}} コマンドを手動で実行するのとは違って systemd サービスを使うことで [[systemd#Journal|journal]] にログが記録されます。

=== Balance ===

balance はファイルシステム上の全てのデータをアロケータに再度流し込みます。デバイスが追加されたり削除された場合にファイルシステム上のデータを再配置するために実行します。balance はデバイスが故障した場合に、冗長な RAID レベルのコピーを再生成します。

{{Pkg|btrfs-progs}}-3.12 から''バランシング''はバックグラウンドプロセスになりました - 詳しくは {{ic|man 8 btrfs-balance}} を見て下さい。

# btrfs balance start /
# btrfs balance status /

=== SSD TRIM ===

{{ic|discard}} オプションを使ってマウントした場合、Btrfs ファイルシステムは TRIM コマンドをサポートしている SSD ドライブの空きブロックを自動的に開放します。

SATA 3.1 よりも古い場合、TRIM コマンドは同期的で、コマンドが実行されている間は全ての I/O がブロックされます。ファイルシステムの同期などによって、プチフリーズが発生する可能性があります。このような場合、{{ic|discard}} を使用する代わりに定期的な trim を有効にすることができます:

# systemctl enable fstrim.timer

SATA バージョンを確認するには次を実行:

# smartctl --info /dev/sd''X''

詳しくは[[ソリッドステートドライブ#TRIM]] を参照。

=== 重複排除 ===

コピーオンライトを使用した場合、Btrfs は実際にはデータをコピーしないでファイルやサブボリュームをコピーできます。ファイルに変更が加えられたときに新しい本当のコピーが作成されます。重複排除はさらに共通部分が存在するデータブロックを認識して、コピーオンライトと同じようにエクステントにまとめてしまいます。

Btrfs パーティションの重複排除に使用するツールについては [https://btrfs.wiki.kernel.org/index.php/Deduplication#Batch 上流の Wiki エントリ] を見てください。{{Pkg|duperemove}}, {{aur|bedup}}, ''btrfs-dedup'' などが存在します。{{pkg|rmlint}} あるいは {{aur|jdupes}} などを使うことでファイルベースでデータの重複排除を行うこともできます。

Btrfs の開発者はインバンド (同期的・インライン) 重複排除に取り組んでおり、新しいデータがファイルシステムに書き込まれたときに重複排除が実行されます。現在のところ実験的な機能としてツリー外で開発されています。新しい機能をテストしてみたい場合は [https://btrfs.wiki.kernel.org/index.php/User_notes_on_dedupe カーネルの wiki ページ] を参照してください。

== 既知の問題 ==

試す前に、いくつかの制限を知っておく必要があります。

=== 暗号化 ===

Btrfs には暗号化のサポートが組み込まれていませんが、この [https://lwn.net/Articles/700487/] は将来的に提供される可能性があります。ユーザーは、 {{ic|mkfs.btrfs}} を実行する前にパーティションを暗号化できます。 [https://wiki.archlinux.jp/index.php/Dm-crypt/%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E5%85%A8%E4%BD%93%E3%81%AE%E6%9A%97%E5%8F%B7%E5%8C%96#Btrfs_.E3.82.B5.E3.83.96.E3.83.9C.E3.83.AA.E3.83.A5.E3.83.BC.E3.83.A0.E3.81.A8.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97 dm-crypt/スワップを使用したsystem#Btrfsサブボリューム全体の暗号化] を参照してください。

既存の Btrfs ファイルシステムは [[EncFS]] や [[TrueCrypt]] のようなものを使用できますが、おそらく Btrfs の機能の一部はありません。

=== TLP ===

TLP を使用するには、ファイルシステムの破損を回避するために特別な予防措置が必要です。詳細については、 [[TLP#Btrfs|TLP の Btrfs セクション]] を参照してください。

=== btrfs チェックの問題 ===
ツール{{ic|btrfs check}} には既知の問題があるため、セクション [[#btrfscheck]] をよく参照してから実行してください。

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

=== パーティションレス Btrfs ディスク ===

{{Warning|
* ほとんどのユーザーはこのタイプのセットアップを望まず、代わりに通常のパーティションにBtrfsをインストールする必要があります。さらに、 GRUB はパーティションレスディスクへのインストールを強くお勧めしません。
* {{Pkg|grub}} 2.04 以降、GRUB の {{ic|core.img}} は大きすぎてBtrfsVBRに収まりません。 {{Bug|63656}} を参照してください。
}}

Btrfs は、 [[#Subvolumes|subvolumes]] を使用してパーティションをシミュレートし、 [[MBR]] または [[GPT]] パーティションスキームを置き換えて、データストレージデバイス全体を占有できます。ただし、別の方法で作成された既存の [https://wiki.archlinux.jp/index.php/%E3%83%91%E3%83%BC%E3%83%86%E3%82%A3%E3%82%B7%E3%83%A7%E3%83%8B%E3%83%B3%E3%82%B0 パーティション] で [[#File systemcreation|create a Btrfsfilesystem]] を実行するためにパーティションレスセットアップを使用する必要はありません。パーティションレスのシングルディスクセットアップには、いくつかの制限があります。

* 他の [[ファイルシステム]] を同じディスク上の別のパーティションに配置することはできません。
* バージョン5.0より前の Linux カーネルを使用している場合、 [[スワップ|スワップ領域]] は使用できません。 Btrfs は[https://wiki.archlinux.jp/index.php/%E3%82%B9%E3%83%AF%E3%83%83%E3%83%97#.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB スワップファイル] 5.0 より前をサポートしておらず、 [https://wiki.archlinux.jp/index.php/%E3%82%B9%E3%83%AF%E3%83%83%E3%83%97#.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97.E3.83.91.E3.83.BC.E3.83.86.E3.82.A3.E3.82.B7.E3.83.A7.E3.83.B3 スワップパーティション] を作成する場所もありませんでした。
* [[UEFI]] を使用して起動することはできません。

既存のパーティションテーブルを Btrfs で上書きするには、次のコマンドを実行します:

# mkfs.btrfs /dev/sd''X''

たとえば、 {{ic|/dev/sda1}} ではなく {{ic|/dev/sda}} を使用します。後者は、パーティショニングスキーム全体を置き換えるのではなく、既存のパーティションをフォーマットします。ルートパーティションは Btrfs なので、 {{ic|btrfs}} がカーネルに組み込まれていることを確認するか、 {{ic|btrfs}} を [[mkinitcpio.conf#MODULES]] と [https://wiki.archlinux.jp/index.php/Mkinitcpio#.E3.82.A4.E3.83.A1.E3.83.BC.E3.82.B8.E4.BD.9C.E6.88.90.E3.81.A8.E3.82.A2.E3.82.AF.E3.83.86.E3.82.A3.E3.83.99.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3 initramfsを再生成する] に入れてください。

[https://wiki.archlinux.jp/index.php/Arch_%E3%83%96%E3%83%BC%E3%83%88%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9#.E3.83.96.E3.83.BC.E3.83.88.E3.83.AD.E3.83.BC.E3.83.80.E3.83.BC ブートローダ] を、 [https://wiki.archlinux.jp/index.php/%E3%83%91%E3%83%BC%E3%83%86%E3%82%A3%E3%82%B7%E3%83%A7%E3%83%8B%E3%83%B3%E3%82%B0#Master_Boot_Record マスターブートレコード] を備えたデータ記憶装置の場合と同様にインストールします。[[Syslinux#手動インストール]] または [[GRUB/Tips and tricks#パーティションまたはパーティションレスディスクへのインストール]] を参照してください。 {{ic|/sysrootをマウントできませんでした。}} が原因でカーネルがブートしない場合は、 {{ic|/etc/default/grub}} に {{ic|1=GRUB_PRELOAD_MODULES="btrfs"}} を追加して、 grub 設定 ([[GRUB#メインの構成ファイルを生成する]]) を生成してください。

=== Ext3/4 から Btrfs への変換 ===

{{Warning|btrfs メーリングリストには、不完全/破壊/破損した変換に関する多くの報告があります。失いたくないデータや ''作業中'' のバックアップがあることを確認してください。詳細については、 btrfswiki の [https://btrfs.wiki.kernel.org/index.php/Conversion_from_Ext3Conversion fromExt3] を参照してください。}}
{{Warning| btrfs-progs 5.6.1 以前にはバグがあり、最後のブロックグループのサイズが間違った btrfs ファイルシステムが生成され、新しく変換されたbtrfsをマウントできなくなります。このバグは、 [https://github.com/kdave/btrfs-progs/commit/0ff7a9b5210723bd4ad0d9d78dbbb18ee8fdd2b1#diff-31168275dcaac634489082b54c4c66d0 thiscommit] の btrfs-progs5.7 で修正されています。 btrfs-progs5.7-1 以降の btrfs-convert を使用してください。}}

インストール CD から起動し、次の手順で変換します:

# btrfs-convert /dev/''partition''

パーティションをマウントし、ファイルをチェックして変換をテストします。変更を反映するために、必ず {{ic|/etc/fstab}} を変更してください( '''type''' を {{ic|btrfs}} に、 '''fs_passno''' [最後のフィールド] を {{ic|0}} Btrfs は起動時にファイルシステムチェックを行わないため)。また、パーティションの UUID が変更されることに注意してください。したがって、 UUID を使用する場合は、それに応じて fstab を更新してください。 {{ic|chroot}} をシステムにインストールし、 GRUB メニューリストを再構築します ([[既存の Linux からインストール]] および [[GRUB]] の記事を参照)。ルートファイルシステムを変換する場合、 chroot されたまま {{ic|mkinitcpio -p linux}} を実行して initramfs を再生成しないと、システムが正常に起動しません。 'unknown filesystem' で grub でスタックした場合は、 {{ic|grub-install /dev/''partition''}} で grub を再インストールし、構成も再生成してください {{ic|grub-mkconfig -o /boot/grub/grub.cfg}}

{{Note|新しく変換された btrfs にファイルをマウントまたは書き込みできないなどの問題がある場合は、バックアップサブボリューム {{ic|/ext2_saved}} がまだ存在する限り、常にロールバックするオプションがあります。 {{ic|btrfs-convert -r /dev/''partition''}} コマンドを使用してロールバックします。これにより、新しく変換された btrfs ファイルシステムへの変更が破棄されます。}}

問題がないことを確認したら、バックアップ {{ic|ext2_saved}} サブボリュームを削除して変換を完了します。これがないと ext3/4 に戻れないことに注意してください。

# btrfs subvolume delete /ext2_saved

最後に [[#Balance|balance]] ファイルシステムでスペースを再利用します。

以前にインストールされた一部のアプリケーションは、 Btrfs に適合させる必要があることに注意してください。特に [[TLP#Btrfs]] はファイルシステムの破損を避けるために特別な注意が必要です。

=== チェックサムのハードウェアアクセラレーション ===

Btrfs のチェックサムでハードウェアアクセラレーションが使われているかどうか確認するには:
{{hc|<nowiki>$ dmesg | grep crc32c</nowiki>|<nowiki>Btrfs loaded, crc32c=crc32c-intel</nowiki>}}

{{ic|<nowiki>crc32c=crc32c-generic</nowiki>}} と表示された場合、ルートパーティションが Btrfs であるため、ハードウェアアクセラレーションを使うにはカーネルに {{ic|crc32c-intel}} を組み込む必要があります。[[mkinitcpio.conf]] に {{ic|crc32c-intel}} を追加するだけでは機能しません。

=== ファイルシステム破損のリカバリ ===

{{Warning|{{ic|btrfs check}} ツールには既知の問題があります。セクション [[Btrfs#btrfs check|btrfs check]] を参照してください。}}

''btrfs-check'' はマウントされているファイルシステムでは使えません。ライブ USB から起動しないで ''btrfs-check'' を使えるようにするには、初期 RAM ディスクに以下のように追加してください:

{{hc|/etc/mkinitcpio.conf|output=
BINARIES="/usr/bin/btrfs"
}}

設定したら [[mkinitcpio]] を使って initramfs を再生成してください。

起動に問題が発生したら、ユーティリティを使って修復することができます。

{{Note|fsck でキャッシュを無効化する必要がある場合、起動後に一定時間フリーズするのは通常の動作です (btrfs-transaction がハングアップしているというメッセージがコンソールに表示されます)。しばらく経てばシステムは復帰します。}}

詳しくは [https://btrfs.wiki.kernel.org/index.php/Btrfsck Btrfs Wiki] を参照。

=== スナップショットから起動する ===

スナップショットをブートするためには、セクション [[Btrfs#サブボリュームをルートとしてマウントする|サブボリュームをルートとしてマウントする]] で説明されているように、サブボリュームをルートパーティションとしてマウントする場合と同じ手順が適用されます。スナップショットはサブボリュームのようにマウントできます。

* [[GRUB]] を使用している場合、{{Pkg|grub-btrfs}} または {{AUR|grub-btrfs-git}} を使用して構成ファイルを再生成すると、自動的に btrfs スナップショットをブートメニューに取り込むことができます。
* [[rEFInd]] を使用している場合は、{{ic|refind-btrfs.service}} を [[systemd#ユニットを使う|有効]] にして開始後に、{{AUR|refind-btrfs}} を使用してブートメニューに btrfs スナップショットを自動的に取り込むことができます。

=== systemd-nspawn で Btrfs サブボリュームを使う ===

[[Systemd-nspawn#Btrfs のサブボリュームをコンテナのルートとして使う]]や [[Systemd-nspawn#コンテナの一時的な Btrfs スナップショットを使う]]を見てください。

=== アクセス時間のメタデータ更新を削減 ===

Btrfs は書き込み時にコピーの性質を持つため、ファイルにアクセスするだけでメタデータのコピーと書き込みを開始します。アクセス時間の更新頻度を減らすと、この予期しないディスク使用がなくなり、パフォーマンスが向上する可能性があります。使用可能なオプションについては、 [[fstab#atime オプション|atime オプション]] を参照してください。

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

一般的なトラブルシューティングについては [https://btrfs.wiki.kernel.org/index.php/Problem_FAQ Btrfs Problem FAQ] を見て下さい。

=== GRUB ===

==== パーティションオフセット ====

[[GRUB]] は Btrfs パーティションを起動することができますが、そのモジュールは ext4 などよりも大きく、''grub-install'' によって作成される {{ic|core.img}} が MBR と最初のパーティションの間に収まらない可能性があります。GPT を使うか、最初のパーティションの前に数 MB の空きスペースを作ることでこの問題を解決できます。

==== root が見つからない ====

RAID セットアップから起動した時にエラー {{ic|1=error no such device: root}} が表示される場合、{{ic|/usr/share/grub/grub-mkconfig_lib}} を編集して {{ic|1=echo " search --no-floppy --fs-uuid --set=root ${hints} ${fs_uuid}"}} からクォートを削除してください。grub の設定を再生成すればエラーを出さずに起動できるはずです。

=== BTRFS: open_ctree failed ===

2014年11月現在、{{ic|mkinitcpio.conf}} で {{ic|btrfs}} フックを使用してマルチデバイスの Btrfs を使っている場合に以下のエラーが発生するというバグが [[systemd]] か [[mkinitcpio]] のどちらかに存在します:

{{bc|<nowiki>
BTRFS: open_ctree failed
mount: wrong fs type, bad option, bad superblock on /dev/sdb2, missing codepage or helper program, or other error

In some cases useful info is found in syslog - try dmesg|tail or so.

You are now being dropped into an emergency shell.
</nowiki>}}

{{ic|/etc/mkinitcpio.conf}} の {{ic|HOOKS}} 行から {{ic|btrfs}} を削除して代わりに {{ic|MODULES}} 行に {{ic|btrfs}} を追加することで解決します。修正を施したら {{ic|mkinitcpio -p linux}} で initramfs を再生成して (必要ならプリセットを調整します) 再起動してください。

詳細は [https://bbs.archlinux.org/viewtopic.php?id=189845 フォーラムスレッド] や {{Bug|42884}} を見て下さい。

デバイスが存在しない raid アレイをマウントしようとしたときも同じエラーが表示されます。その場合は {{ic|/etc/fstab}} に {{ic|degraded}} マウントオプションを追加してください。ルートパーティションがアレイ上にある場合、[[カーネルパラメータ]]に {{ic|1=rootflags=degraded}} を追加してください。

=== btrfs check ===

{{Warning|Btrfs はまだ開発途上であり、特に {{ic|btrfs check}} コマンドについては仕様が固まっていないので、{{ic|--repair}} スイッチを付けて {{ic|btrfs check}} を実行するときはあらかじめ Btrfs のドキュメントを読んでバックアップを作成することを強く推奨します。}}

''[https://btrfs.wiki.kernel.org/index.php/Manpage/btrfs-check btrfs check]'' コマンドを使うことでアンマウントされた Btrfs ファイルシステムをチェックしたり修復することが可能です。ただし、この修復ツールはまだ開発中であり、特定のファイルシステムエラーは修復することができません。

詳しくは [https://btrfs.wiki.kernel.org/index.php/Btrfsck Btrfsck] を参照。

== 参照 ==

* 公式サイト
** [https://btrfs.wiki.kernel.org/ Btrfs Wiki]
* パフォーマンス関連
** [https://superuser.com/questions/432188/should-i-put-my-multi-device-btrfs-filesystem-on-disk-partitions-or-raw-devices Btrfs on raw disks?]
** [http://comments.gmane.org/gmane.comp.file-systems.btrfs/19440 Varying leafsize and nodesize in Btrfs]
** [http://comments.gmane.org/gmane.comp.file-systems.btrfs/15646 Btrfs support for efficient SSD operation (data blocks alignment)]
** [https://btrfs.wiki.kernel.org/index.php/FAQ#Is_Btrfs_optimized_for_SSD.3F Is Btrfs optimized for SSDs?]
** Phoronix によるマウントオプションのベンチマーク
*** [https://www.phoronix.com/scan.php?page=article&item=btrfs-mount-linux49 Linux 4.9]
*** [https://www.phoronix.com/scan.php?page=article&item=linux_314_btrfs Linux 3.14]
*** [https://www.phoronix.com/scan.php?page=article&item=linux_btrfs_311&num=1 Linux 3.11]
*** [https://www.phoronix.com/scan.php?page=news_item&px=MTM0OTU Linux 3.9]
*** [https://www.phoronix.com/scan.php?page=article&item=btrfs_linux37_mounts&num=1 Linux 3.7]
*** [https://www.phoronix.com/scan.php?page=article&item=linux_btrfs_options&num=1 Linux 3.2]
** [http://blog.erdemagaoglu.com/post/4605524309/lzo-vs-snappy-vs-lzf-vs-zlib-a-comparison-of Lzo vs. zLib]
* その他
** [http://www.funtoo.org/wiki/BTRFS_Fun Funtoo Wiki Btrfs Fun]
** [https://www.phoronix.com/scan.php?page=news_item&px=MTA0ODU Avi Miller presenting Btrfs] at SCALE 10x, January 2012.
** [https://www.phoronix.com/scan.php?page=news_item&px=MTA4Mzc Summary of Chris Mason's talk] from LFCS 2012
** [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commit;h=35054394c4b3cecd52577c2662c84da1f3e73525 Btrfs: stop providing a bmap operation to avoid swapfile corruptions] 2009-01-21
** [http://marc.merlins.org/perso/btrfs/post_2014-03-22_Btrfs-Tips_-Doing-Fast-Incremental-Backups-With-Btrfs-Send-and-Receive.html Doing Fast Incremental Backups With Btrfs Send and Receive]

Btrfs

2021-12-04T11:02:28Z

Funcrab: zstd 圧縮形式に少し言及した。コマンド等は別途整備が必要

[[Category:ファイルシステム]]
[[en:Btrfs]]
[[fr:Btrfs]]
[[zh-hans:Btrfs]]
{{Related articles start}}
{{Related|ファイルシステム}}
{{Related|mkinitcpio}}
{{Related|Snapper}}
{{Related|dm-crypt/システム全体の暗号化#Btrfs サブボリュームとスワップ}}
{{Related articles end}}

[[Wikipedia:ja:Btrfs]] より:

:''Btrfs (B-tree File System: 読み方は "バター FS", "ベター FS", "B木 FS", "ビーティーアール FS" など) は Linux 向けの実験的なコピーオンライトのファイルシステムで GPL でライセンスされています。Oracle Corporation によって2007年から開発が開始されました。2014年8月にはディスク上のフォーマットが固まっています。''

[https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs Wiki] より:

:''Btrfs は Linux 用の全く新しいコピーオンライト (COW) のファイルシステムです。先進的な機能を実装することを目指しつつ、障害耐性を持ち簡単に管理できることに焦点が置かれています。Btrfs は Oracle, Red Hat, Fujitsu, Intel, SUSE, STRATO やその他多くの人々によって共同で開発されており GPL でライセンスされていて誰でも貢献できるように開かれています。''

{{Warning|Btrfs には実験的な機能が存在します。詳しくは Btrfs Wiki の [https://btrfs.wiki.kernel.org/index.php/Status Status] や [https://btrfs.wiki.kernel.org/index.php/FAQ#Is_btrfs_stable.3F Is Btrfs stable?]、[https://btrfs.wiki.kernel.org/index.php/Getting_started Getting started] などを見てください。[[#既知の問題]]も参照。}}

== インストール ==

Btrfs はデフォルトのカーネルに含まれており、ツール ({{pkg|btrfs-progs}}) は[[公式リポジトリ]]から入手できます。[[GRUB]], [[mkinitcpio]], [[Syslinux]] には Btrfs のサポートがあるので追加の設定は必要ありません。

=== 追加のパッケージ ===

* {{Pkg|btrfs-progs}} には Btrfs ファイルシステムのエラーを修正できるツール ''btrfsck'' が含まれています。
* {{AUR|btrfs-progs-git}} はナイトリービルドです。

{{Tip|Btrfs を効率的に動かす提案が [https://btrfs.wiki.kernel.org/index.php/Getting_started Btrfs Wiki Getting Started] に載っています。}}

== Btrfs の一般的な管理 ==

=== 新しいファイルシステムを作成する ===

Btrfs ファイルシステムは新規作成することも既存のファイルシステムから変換することも可能です。

パーティションをフォーマットするには次を実行してください:

# mkfs.btrfs -L ''mylabel'' /dev/''partition''

{{Note|1=2013年11月の[https://git.kernel.org/cgit/linux/kernel/git/mason/btrfs-progs.git/commit/?id=c652e4efb8e2dd76ef1627d8cd649c6af5905902 この] コミット以降、Btrfs のデフォルトのブロックサイズは 16KB になっています。}}

大きいブロックサイズをデータ・メタデータに使うには、下の例のように {{ic|-n}} スイッチを使って {{ic|nodesize}} の値を指定して下さい (例: 16KB ブロック):

# mkfs.btrfs -L ''mylabel'' -n 16k /dev/''partition''

複数のデバイスを入力して RAID を作成することもできます。サポートされている RAID レベルは RAID 0, RAID 1, RAID 10 などです。デフォルトではメタデータはミラーされデータはストライピングされます。より多くの情報が必要な場合、[https://btrfs.wiki.kernel.org/index.php/Using_Btrfs_with_Multiple_Devices Using Btrfs with Multiple Devices] を見てください。

# mkfs.btrfs [options] /dev/<part1> /dev/<part2>

{{Tip|ミラーリングをしない場合、''raid0'' オプションを使って下さい: {{ic|# mkfs.btrfs -d raid0 /dev/''part1'' /dev/''part2''}}。}}

{{Warning|Btrfs の RAID 5 と RAID 6 モードには致命的な欠点があります。壊れても良いデータ以外でテストすべきではありません。現状については https://btrfs.wiki.kernel.org/index.php/RAID56 を参照してください。}}

=== 使用済み・空き容量を表示する ===

{{ic|/usr/bin/df}} などの linux の一般的なユーザー空間ツールは Btrfs パーティションの空き容量について間違った報告をします。なぜならメタデータによって使用される予約済みのスペースを考慮しないからです。btrfs パーティションに問い合わせるときは {{ic|/usr/bin/btrfs}} を使うのが推奨されています。以下は {{ic|df -h}} を使った時と、{{ic|btrfs filesystem df}} を使った時の出力の例です:

{{hc|$ df -h /|
Filesystem Size Used Avail Use% Mounted on
/dev/sda3 119G 3.0G 116G 3% /
}}

{{hc|$ btrfs filesystem df /|2=
Data: total=3.01GB, used=2.73GB
System: total=4.00MB, used=16.00KB
Metadata: total=1.01GB, used=181.83MB
}}

{{ic|df -h}} は 3.0GB 使用されているとしているのに対して {{ic|btrfs filesystem df}} はデータは 2.73GB だと報告しているのに気づいて下さい。これは Btrfs がスペースをプールに割り当てているためです。本当のディスク使用量は3つの 'used' を合計した値であり、{{ic|df -h}} による 3.0GB よりかは下回ります。

{{Note|1=カーネル 3.15 以上で {{ic|btrfs filesystem df}} の出力にタイプ {{ic|unknown}} のエントリが表示される場合、これは表示のバグです。[http://thread.gmane.org/gmane.comp.file-systems.btrfs/34419 このパッチ] によって、このエントリは一種のバッファである GlobalReserve を意味しています。このエントリは RAID では {{ic|unknown, single}} として表示され re-balance することができません。}}

他にも大まかに使用容量を読み出すコマンドとして {{ic|btrfs filesystem show}} が使用できます:

# btrfs filesystem show /dev/sda3

空き容量の情報を取得する最新のコマンドは {{ic|btrfs filesystem usage}} です:

# btrfs filesystem usage

{{Note|1={{ic|btrfs filesystem usage}} コマンドは RAID レベルが {{ic|RAID5/RAID6}} だと上手く機能しません。}}

== 既知の問題 ==

試行する前に知っておくべき制限事項が存在します。

=== 暗号化 ===

Btrfs にはビルトインの暗号化サポートはありません(将来実装される予定です)が、<code>mkfs.btrfs</code> をする前にパーティションを暗号化することができます。[[dm-crypt]] を見て下さい。

既に btrfs ファイルシステムを作成してしまっている場合、[[EncFS]] や [[TrueCrypt]] などを使うことができます。ただし btrfs のいくつかの機能が使えなくなるかもしれません。

=== スワップファイル ===

Btrfs の [[スワップファイル]] は Linux カーネル5.0 以降でサポートされています。[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=ed46ff3d423780fa5173b38a844bf0fdb210a2a7] スワップファイルを初期化する適切な方法は、最初にファイルをホストする非圧縮、非スナップショットのサブボリュームを作成し、そのディレクトリに ''cd'' してから、長さゼロのファイルを作成し、{{ic|No_COW}} を設定することです。属性を [https://wiki.archlinux.jp/index.php/%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E5%B1%9E%E6%80%A7#chattr_.E3.81.A8_lsattr chattr] で指定し、圧縮が無効になっていることを確認します。

# cd ''/path/to/swapfile''
# truncate -s 0 ./swapfile
# chattr +C ./swapfile
# btrfs property set ./swapfile compression none

詳細な設定については、 [https://wiki.archlinux.jp/index.php/%E3%82%B9%E3%83%AF%E3%83%83%E3%83%97#.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E4.BD.9C.E6.88.90 スワップファイルの作成] を参照してください。スワップファイルへの休止状態の構成については、[https://wiki.archlinux.org/index.php/Power_management/Suspend_and_hibernate#Hibernation_into_swap_file_on_Btrfs Hibernation into swap file on Btrfs]で説明されています。

{{Note|1=Linux カーネル5.0 以降、 Btrfs にはネイティブスワップファイルのサポートがありますが、いくつかの制限があります。
* スワップファイルをスナップショットサブボリュームに置くことはできません。適切な手順は、スワップファイルを配置する新しいサブボリュームを作成することです。
* 複数のデバイスにまたがるファイルシステム上のスワップファイルはサポートされていません。 [https://btrfs.wiki.kernel.org/index.php/FAQ#Does_btrfs_support_swap_files.3F Btrfs wiki: Does btrfs support swap files?] および [https://bbs.archlinux.org/viewtopic.php?pid=1849371#p1849371 Arch forums discussion]。
}}

== 機能 ==

様々な機能が備わっていて、それぞれ設定が可能です。

=== クォータ ===

{{warning|Qgroup はまだ安定状態ではなくサブボリュームのスナップショットとクォータを組み合わせると操作によってパフォーマンスに問題をきたします (スナップショットの削除など)。さらに [https://btrfs.wiki.kernel.org/index.php/Quota_support#Known_issues 既知の問題] が存在しています。}}

Btrfs におけるクォータのサポートはクォータグループ (qgroup) を利用してサブボリュームレベルで実装されています: 各サブボリュームにはデフォルトで ''0/<subvolume id>'' という形式でクォータグループが割り当てられています。必要であればクォータグループを作成することもできます。

クォータグループを使うにはまずクォータを有効にする必要があります:

# btrfs quota enable <path>

上記のコマンドを実行してから新しいサブボリュームを作成すると、グループによって制御が可能になります。既存のサブボリュームでも制御を行いたい場合、クォータを有効にしてから、''<subvolume id>'' を使ってサブボリュームごとにクォータグループを作成して再スキャンしてください:

# btrfs subvolume list <path> | cut -d' ' -f2 | xargs -I{} -n1 btrfs qgroup create 0/{} <path>
# btrfs quota rescan <path>

Btrfs のクォータグループはツリー構造になっていて、サイズ制限はクォータグループごとに設定し、ツリーに属しているサブボリュームに制限が課せられます。

クォータグループで設定できる制限は合計データ使用量・非共有のデータ使用量・圧縮データ使用量、あるいはそれらを組み合わせたものです。元のボリュームファイルを削除してコピーを残す場合、他のクォータグループの非共有制限が変わるため、ファイルのコピーや削除で制限に抵触する可能性があります。例えば、新しいスナップショットが元のサブボリュームの全てのブロックと同じデータを持っている場合、どちらかのサブボリュームだけで共通データを削除するともう片方のサブボリュームの制限に引っかかる可能性があります。

クォータグループに制限を設定するには、{{ic|btrfs qgroup limit}} コマンドを使います。合計使用量の制限や非共有制限 ({{ic|-e}}) または圧縮制限 ({{ic|-c}}) が設定できます。ファイルシステムの特定のパスにおける使用量や制限を表示するには:

# btrfs qgroup show -reF <path>

=== コミット間隔の設定 ===

ファイルシステムにどのデータを書き込むかは BTRFS とシステム全体の設定によって決められます。BTRFS のデフォルトでは30秒のチェックポイントインターバルでファイルシステムに新しいデータが送られます。この間隔は[[#チェックポイントインターバル|後述]]のマウントオプションで調整可能です。

システム全体の設定もインターバルに影響を与えます。それには /proc/sys/vm/* 以下のファイルも含まれており、この wiki では扱っていません。Documentation/sysctl/vm.txt にこれらのファイルに関するカーネルドキュメントがあります。

=== コピーオンライト (CoW) ===

デフォルトでは、いついかなる時も、全てのファイルに対して btrfs は CoW を行います: 今までに存在していなかったファイルを書き込もうとした場合、データは空き領域に書き込まれて、ファイルシステムのメタデータブロックが CoW されます。"通常の"ファイルシステムでは、ファイルの一部を上書きした場合、置換先のデータに直接上書きがなされます。CoW ファイルシステムでは、新しいデータはディスクの空き容量に書き込まれて、それから、新しいデータを参照するようにファイルのメタデータが変更されます。元のデータはどこからも参照されなくなって始めて削除されます。

CoW にはアドバンテージがありますが、大きなファイルに小さなランダム書き込みを行うときのパフォーマンスについてはあまり良い影響を与えません。たとえ"コピー"を行わないときでもファイルを断片化させるからです。データベースファイルや仮想マシンイメージについては CoW を無効化することが推奨されます。

CoW を無効にする方法の一つは "nodatacow" オプションを使ってマウントすることです。しかしながら、これではファイルシステム全体で CoW を無効にすることになります。

{{Note|{{ic|nodatacow}} は新規作成されたファイルにのみ影響します。既存のファイルにはまだ CoW が行われる可能性があります。}}

ファイルやディレクトリ単体で CoW を無効化するには、次のコマンドを使って下さい:

$ chattr +C </dir/file>

以上のコマンドで CoW が無効化されるのはファイルの参照が一つしかない操作の場合に限られます。複数の参照がある場合 (例: {{ic|1=cp --reflink=always}} を使用したりファイルシステムのスナップショットが存在する場合)、CoW は依然として実行されます。

{{Note|chattr の man ページより: btrfs では、 'C' フラグは新しい、または空のファイルにセットしなければなりません。既にデータブロックを持つファイルにフラグを設定した場合、ファイルに新しいブロックが割り当てられると完全な安定のためにフラグの定義が消されます。ディレクトリに 'C' フラグがセットされている場合、そのディレクトリ自体には影響がなく、ディレクトリに作成された新しいファイルに {{ic|No_COW}} 属性が付けられます。}}

{{Tip|上の Note に従い、ディレクトリ内の既存のファイルで CoW を無効にするときは、次のようにします:
$ mv ''/path/to/dir'' ''/path/to/dir''_old
$ mkdir ''/path/to/dir''
$ chattr +C ''/path/to/dir''
$ cp -a ''/path/to/dir''_old/* ''/path/to/dir''
$ rm -rf ''/path/to/dir''_old
作業中にファイルが使用されないように気を付けてください。また、 {{ic|mv}} や下で説明する {{ic|cp --reflink}} では CoW を無効にできないことに注意してください。
}}

同じように、ファイルのコピー時に CoW を強制してスペースを節約するには次を使って下さい (デフォルトでは {{ic|cp}} を使った場合、実際にデータがコピーされます):

$ cp --reflink source dest

dest ファイルが変更されると、元から変更されたブロックだけがディスクに書き込まれます。cp を 'cp --reflink=auto' にするエイリアスを作ってもいいかもしれません。

=== マルチデバイスファイルシステムと RAID 機能 ===

[https://btrfs.wiki.kernel.org/index.php/Using_Btrfs_with_Multiple_Devices Using Btrfs with Multiple Devices] の提案も見て下さい。

====マルチデバイスファイルシステム====

{{Note|適当な ''.device'' ジョブ以外でマルチデバイスファイルシステムをマウントするとファイルシステムの [https://github.com/systemd/systemd/issues/1921 バグ] が原因でフリーズして systemd が起動できなくなります。}}

''btrfs'' ファイルシステムを作成する際に、''mkfs.btrfs'' したい分だけのパーティション・デバイスを指定することができます。ファイルシステムは指定された全てのデバイスにわたって作成されます。このように '''"'''pool'''"''' することによって、複数のパーティションやデバイスを一つの大きな ''btrfs'' ファイルシステムにできるのです。

また、既に存在している btrfs ファイルシステムからデバイスを追加・削除することも可能です(用心が必要ですが)。

(btrfs ボリュームとも呼ばれる) マルチデバイス ''btrfs'' ファイルシステムは {{ic|btrfs device scan}} を実行するまで認識されません。''btrfs'' mkinitcpio フックがこれを行います。

====RAID 機能====

{{Note|カーネル 3.19 から、復元や再構築のコードもマージされています。通常の使用に耐えうるようになっています。新しいコードなので、安定化するのは次かその次のバージョンのカーネルになると思われます。}}

マルチデバイスファイルシステムを作成するとき、ファイルシステムに追加したデバイス全体で RAID0, RAID1, RAID10, RAID5, RAID6 を使うように指定することもできます。RAID レベルはデータとメタデータで別個に適用することができます。デフォルトでは、メタデータはシングルボリュームやマルチディスクの RAID1 で複製されます。

btrfs は raid0, raid1, raid10 のブロックペアで動作します:

raid0 - 2つのデバイスに分散されるブロックペア

raid1 - 2つのデバイスに書き込まれるブロックペア

マウント中に {{ic|btrfs balance}} コマンドを使って RAID レベルを変更することができます:

# btrfs balance start -mconvert=RAIDレベル -dconvert=RAIDレベルマウントポイント

ディスクが2つある場合、md-raid ([[mdadm]]) で定義する raid レベルと一致します。ディスクが3つ以上の場合は、md-raid とは全く異なるものになります。

例えば:
* md による raid1 の3つの 1TB ディスクを使って、1TB の空き容量で、2つのディスクを失ってもデータが消失しないようにすることが出来ます。
* data=raid1 の Btrfs ボリュームの3つの 1TB ディスクを使って、満杯になるまでほぼ 1.5TB のデータを保存することができます。ディスクが1つなくなってもデータは消失しません。

Btrfs はディスクに分散してブロックペアを配置するのにラウンドロビン方式を使っています。Linux 3.0 から,ブロックペアを分散する際に大きなディスクを優先するように quasi-round-robin 方式が使われています。これによって複数のディスクからディスクセットが出来ているときに raid0 や raid1 でほとんど (もしくは全て) の領域を効率的に利用することが可能になっています。例えば、1台の 1TB のディスクと2台の 500GB のディスクからなるセットで data=raid1 を使用すると 1TB のディスクには全てのブロックのコピーが、500GB のそれぞれのディスクにはブロックが交互に (ラウンドロビンで) 配置されます。完全な利用効率が実現されます。1TB のディスクと 750GB のディスク、500GB のディスクからなるセットでも同じことが行われますが、ファイルシステムは 750GB のディスクの 250GB が利用できないことを報告します。いつでも全ての領域を活用できるようにするには (最後に上げた例でも)、data=single を使って下さい (data=single は raid コントローラによって定義される JBOD と同じです)。詳しくは [https://btrfs.wiki.kernel.org/index.php/FAQ#How_much_space_do_I_get_with_unequal_devices_in_RAID-1_mode.3F BTRFS FAQ] を参照。

{{Warning|パリティ RAID (RAID 5/6) のコードにはデータを消失する可能性のある深刻なバグが存在します。詳しくは Btrfs Wiki の [https://btrfs.wiki.kernel.org/index.php/RAID56 RAID5/6] のページや [https://www.mail-archive.com/linux-btrfs@vger.kernel.org/msg55161.html linux-btrfs メーリングリスト] のバグレポートを読んでください。}}

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

btrfs の機能のひとつにサブボリュームがあります。サブボリュームは基本的にファイルとディレクトリを保持している名前の付いた b 木です。root ツリーのツリーの中に inode を持ち、root 以外の所有者やグループも設定できます。サブボリュームは任意でブロックを割り当てることもできます。ブロックとファイルエクステントの全ては参照カウントでありスナップショットを可能にしています。仮想マシンの動的な容量拡張に似て、必要な時に必要な分だけのデバイス上の容量を使います。また、サブボリュームを異なったマウントオプションを使ってマウントすることでセキュリティの柔軟性を持たせることもできます。

==== サブボリュームを作成する ====

サブボリュームを作成するには:
# btrfs subvolume create ''/path/to/subvolume''

==== サブボリュームを一覧する ====

現在のサブボリュームのリストを表示するには:

# btrfs subvolume list -p .

==== サブボリュームをマウントする ====

サブボリュームは {{ic|1=subvol=''/path/to/subvolume''}} や {{ic|1=subvolid=''objectid''}} マウントフラグを使うことでファイルシステムのパーティションと同じようにマウントできます。例えば、{{ic|subvol_root}} という名前のサブボリュームが存在したら {{ic|/}} にマウントすることができます。ファイルシステムのトップレベルにサブボリュームを作成して適切なマウントポイントにマウントすることで、伝統的なファイルシステムのパーティションと同じように使うことができ、[[#スナップショット|スナップショット]]を使用してファイルシステムを前の状態に簡単に戻すことが可能です。

{{Tip|1=トップレベルのサブボリューム (ID=5) を {{ic|/}} として使用しないことでサブボリュームのレイアウトの変更を簡単にできます。サブボリュームを作成して実際のデータを保存して {{ic|/}} にマウントします。}}

[[Snapper#推奨ファイルシステムレイアウト]], [https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Managing_Snapshots Btrfs SysadminGuide#Managing Snapshots], [https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Layout Btrfs SysadminGuide#Layout] などにサブボリュームを使用するファイルシステムレイアウトの例が存在します。

===== マウントオプション =====

{{ic|1=subvol=}} でサブボリュームをマウントする際、複数のマウントオプションが利用できます。例えば、[[#圧縮|圧縮]]や[[#コピーオンライト (CoW)|コピーオンライト (CoW)]] に関するマウントオプションが使えます。

詳しくは [https://btrfs.wiki.kernel.org/index.php/Mount_options Btrfs Wiki Mount options] や [https://btrfs.wiki.kernel.org/index.php/Gotchas Btrfs Wiki Gotchas] を見てください。様々なマウントオプションを使うことで Btrfs の特性は大きく変わります。活発に開発されているファイルシステムであるため、リグレッションも考慮してください。[[#参照|参照]]セクションには複数のベンチマークへのリンクが存在します。

{{Warning|特定のマウントオプションは安全を保証するための機能を無効化して、ファイルシステムが完全に破損する危険性を引き上げてしまいます。}}

==== サブボリュームをルートとしてマウントする ====

サブボリュームをルートマウントポイントとして使用するには、{{ic|1=rootflags=subvol=''/path/to/subvolume''}} を使用して [[カーネルパラメータ#設定|カーネルパラメータ]] 経由でサブボリュームを指定します。{{ic|/etc/fstab}} でルート・マウントポイントを編集し、マウント・オプションに {{ic|1=subvol=}} を指定します。または、サブボリュームの ID {{ic|1=rootflags=subvolid=''objectid''}} をカーネルパラメータとして使い、{{ic|1=subvolid=''objectid''}} を {{ic|/etc/fstab}} のマウントオプションとして指定することもできます。

==== デフォルトのサブボリュームを設定する ====

{{Warning|{{ic|btrfs subvolume set-default}} でデフォルトのサブボリュームを変更すると、{{ic|1=subvolid=0}} マウントオプションを使わない限り、ファイルシステムのトップレベルがアクセスできなくなります。参照: [https://btrfs.wiki.kernel.org/index.php/SysadminGuide Btrfs Wiki Sysadmin Guide]。}}

{{ic|1=subvol=}} マウントオプションが指定されていない場合、デフォルトのサブボリュームがマウントされます。

# btrfs subvolume set-default ''subvolume-id'' /.

'''サンプル:'''

{{hc|# btrfs subvolume list .|
ID 258 gen 9512 top level 5 path root_subvolume
ID 259 gen 9512 top level 258 path home
ID 260 gen 9512 top level 258 path var
ID 261 gen 9512 top level 258 path usr
}}

# btrfs subvolume set-default 258 .

'''リセット:'''

# btrfs subvolume set-default 0 .

==== スナップショット ====

詳しくは [https://btrfs.wiki.kernel.org/index.php/SysadminGuide#Snapshots Btrfs Wiki SysadminGuide#Snapshots] を見て下さい。

スナップショットを作成するには:

# btrfs subvolume snapshot ''source'' [''dest''/]''name''

スナップショットは再帰的ではありません、つまりサブボリューム内にある全てのサブボリュームはスナップショットでは空のディレクトリになります。

==== 送信/受信 ====

サブボリュームは {{ic|send}} コマンドを使って標準出力やファイルに送信することができます。Btrfs の {{ic|receive}} コマンドにパイプで渡すことで非常に便利に使うことが可能です。例えば、{{ic|/root_backup}} という名前のスナップショットを {{ic|/backup}} に送信するには以下のコマンドを実行します:

# btrfs send /root_backup | btrfs receive /backup

送信するスナップショットは読み取り専用である必要があります。上記のコマンドは外部デバイスにサブボリュームをコピーするのにも使えます (例えば上の {{ic|/backup}} を USB ディスクにマウント)。

また、スナップショットの差分だけを送信することも可能です。例えば、上記のように {{ic|root_backup}} のコピーを送信したことがある場合、{{ic|root_backup_new}} という名前の読み取り専用のスナップショットを新しく作成してから、増加差分だけを {{ic|/backup}} に送信するには:

# btrfs send -p /root_backup /root_backup_new | btrfs receive /backup

これで {{ic|root_backup_new}} という名前の新しいサブボリュームが {{ic|/backup}} に作成されます。

差分バックアップをしたり自動的にバックアップを行うツールは [https://btrfs.wiki.kernel.org/index.php/Incremental_Backup Btrfs Wiki's Incremental Backup] を見てください。

=== デフラグメンテーション ===

Btrfs はオンラインデフラグをサポートしています。root フォルダのメタデータをデフラグするには、次を実行してください:
# btrfs filesystem defragment /
上のコマンドはファイルシステム全体のデフラグを''行いません''。詳しくは、btrfs wiki の[https://btrfs.wiki.kernel.org/index.php/Problem_FAQ#Defragmenting_a_directory_doesn.27t_work このページ]を見て下さい。

ファイルシステム全体をデフラグするには、次を実行してください:
# btrfs filesystem defragment -r -v /

=== 圧縮 ===

Btrfs は透過圧縮をサポートしています、これはパーティション上の全てのファイルが自動的に圧縮されることを意味します。このことはファイルの容量を減らすだけでなく、特に [https://www.phoronix.com/scan.php?page=article&item=btrfs-zstd-compress zstd アルゴリズム] や [https://www.phoronix.com/scan.php?page=article&item=btrfs_lzo_2638&num=1 lzo アルゴリズム] を使う場合、一般的に [https://www.phoronix.com/scan.php?page=article&item=btrfs_compress_2635&num=1 パフォーマンスが向上] します。

圧縮は {{ic|1=compress=zlib}} か {{ic|1=compress=lzo}} マウントオプションを使って有効にします。マウントオプションが追加された後に作成・変更されたファイルだけに圧縮が適用されます。ただし、{{ic|btrfs filesystem defragment -c''alg''}} コマンドを使うことで既存のファイルに圧縮を適用することも簡単にできます (例えば ext3/4 から変換した後)。{{ic|''alg''}} は {{ic|zlib}} または {{ic|lzo}} のどちらかに置き換えてください。{{ic|lzo}} を使ってファイルシステム全体を再圧縮するには、次のコマンドを実行してください:

# btrfs filesystem defragment -r -v -clzo /

{{Tip|{{ic|compress}} マウントオプションを使わずファイルごとに圧縮を有効にすることも可能です。ファイルに {{ic|chattr +c}} を適用するだけです。ディレクトリに適用した場合、新しいファイルは自動的に圧縮されます。}}

空の Btrfs パーティションに Arch をインストールする際に、[[ビギナーズガイド#ドライブの準備|ドライブの準備]]をした後 {{ic|compress}} オプションを設定してください。他のターミナルに切り替えて ({{ic|Ctrl+Alt+number}})、次のコマンドを実行してください:
# mount -o remount,compress=lzo /mnt/target

インストールが完了した後に、{{ic|/etc/[[fstab]]}} の root ファイルシステムのマウントオプションに {{ic|1=compress=lzo}} を加えて下さい。

=== チェックポイントインターバル ===
Linux 3.12 から、チェックポイントインターバルをデフォルトの30秒から変えることができるようになっています。{{ic|/etc/fstab}} の btrfs パーティションに {{ic|commit}} マウントフラグを追加してください。

LABEL=arch64 / btrfs defaults,noatime,compress=lzo,commit=120 0 0

=== パーティショニング ===

Btrfs はデータストレージデバイス全体を占領して [[Master Boot Record|MBR]] や [[GUID Partition Table|GPT]] パーティショニングスキームを置き換えることができます。[[#サブボリューム|サブボリューム]]を使ってパーティションを模すことが可能です。ディスクを一つしか使っていない場合、このアプローチにはいくつか制限があります:

* [[fstab|マウントポイント]]によって異なる[[ファイルシステム]]を使うことはできません
* Btrfs は[[スワップ#スワップファイル|スワップファイル]]をサポートしていないので[[スワップ|スワップ領域]]を使うことができません。[[スワップ#スワップパーティション|スワップパーティション]]も作れません。ハイバネーションイメージはスワップ領域に保存されるので、ハイバネーション/レジュームも使えません
* [[Unified Extensible Firmware Interface|UEFI]] を使って起動できません

既存のパーティションテーブルを Btrfs で上書きするには、次のコマンドを実行してください:
# mkfs.btrfs /dev/sdX
{{ic|/dev/sdaX}} を指定するとパーティションスキーム全体を置き換える代わりに既存のパーティションがフォーマットされます。

[[Master Boot Record|MBR]] のデータストレージデバイスと同じ方法で[[ブートローダー]]をインストールしてください。例えば [[GRUB]] なら:
# grub-install --recheck /dev/sdX

{{Warning|{{ic|btrfs subvolume set-default}} コマンドを使ってデフォルトのサブボリュームをトップレベル (ID 0) 以外に変更すると GRUB を破壊するおそれがあります。リセットするには [[#デフォルトのサブボリュームを設定する]] を見て下さい。}}

=== Scrub ===

Btrfs の scrub はオンラインのファイルシステムチェックツールです。ファイルシステム上の全てのデータとメタデータを読み込んで、チェックサムと RAID ストレージの重複コピーを使用してデータに破損がないか確認して修復を行います。

# btrfs scrub start /
# btrfs scrub status /

{{Warning|scrub プロセスが動作しているとシステムはサスペンドできません、詳しくは [http://comments.gmane.org/gmane.comp.file-systems.btrfs/33106 このスレッド] を見て下さい。}}

==== systemd サービス ====

{{Pkg|btrfs-progs}} パッケージには特定のマウントポイントをひと月毎にスクラブする {{ic|btrfs-scrub@.timer}} ユニットが付属しています。エンコードしたパスを指定してタイマーを[[有効化]]してください。例えば {{ic|/}} なら {{ic|btrfs-scrub@-.timer}} を、{{ic|/home}} なら {{ic|btrfs-scrub@home.timer}} を使います。

{{ic|btrfs-scrub@.service}} を[[起動]]することで手動でスクラブを実行することもできます (同じくエンコードしたパスを指定してください)。{{ic|btrfs scrub}} コマンドを手動で実行するのとは違って systemd サービスを使うことで [[systemd#Journal|journal]] にログが記録されます。

=== Balance ===

balance はファイルシステム上の全てのデータをアロケータに再度流し込みます。デバイスが追加されたり削除された場合にファイルシステム上のデータを再配置するために実行します。balance はデバイスが故障した場合に、冗長な RAID レベルのコピーを再生成します。

{{Pkg|btrfs-progs}}-3.12 から''バランシング''はバックグラウンドプロセスになりました - 詳しくは {{ic|man 8 btrfs-balance}} を見て下さい。

# btrfs balance start /
# btrfs balance status /

=== SSD TRIM ===

{{ic|discard}} オプションを使ってマウントした場合、Btrfs ファイルシステムは TRIM コマンドをサポートしている SSD ドライブの空きブロックを自動的に開放します。

SATA 3.1 よりも古い場合、TRIM コマンドは同期的で、コマンドが実行されている間は全ての I/O がブロックされます。ファイルシステムの同期などによって、プチフリーズが発生する可能性があります。このような場合、{{ic|discard}} を使用する代わりに定期的な trim を有効にすることができます:

# systemctl enable fstrim.timer

SATA バージョンを確認するには次を実行:

# smartctl --info /dev/sd''X''

詳しくは[[ソリッドステートドライブ#TRIM]] を参照。

=== 重複排除 ===

コピーオンライトを使用した場合、Btrfs は実際にはデータをコピーしないでファイルやサブボリュームをコピーできます。ファイルに変更が加えられたときに新しい本当のコピーが作成されます。重複排除はさらに共通部分が存在するデータブロックを認識して、コピーオンライトと同じようにエクステントにまとめてしまいます。

Btrfs パーティションの重複排除に使用するツールについては [https://btrfs.wiki.kernel.org/index.php/Deduplication#Batch 上流の Wiki エントリ] を見てください。{{Pkg|duperemove}}, {{aur|bedup}}, ''btrfs-dedup'' などが存在します。{{pkg|rmlint}} あるいは {{aur|jdupes}} などを使うことでファイルベースでデータの重複排除を行うこともできます。

Btrfs の開発者はインバンド (同期的・インライン) 重複排除に取り組んでおり、新しいデータがファイルシステムに書き込まれたときに重複排除が実行されます。現在のところ実験的な機能としてツリー外で開発されています。新しい機能をテストしてみたい場合は [https://btrfs.wiki.kernel.org/index.php/User_notes_on_dedupe カーネルの wiki ページ] を参照してください。

== 既知の問題 ==

試す前に、いくつかの制限を知っておく必要があります。

=== 暗号化 ===

Btrfs には暗号化のサポートが組み込まれていませんが、この [https://lwn.net/Articles/700487/] は将来的に提供される可能性があります。ユーザーは、 {{ic|mkfs.btrfs}} を実行する前にパーティションを暗号化できます。 [https://wiki.archlinux.jp/index.php/Dm-crypt/%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E5%85%A8%E4%BD%93%E3%81%AE%E6%9A%97%E5%8F%B7%E5%8C%96#Btrfs_.E3.82.B5.E3.83.96.E3.83.9C.E3.83.AA.E3.83.A5.E3.83.BC.E3.83.A0.E3.81.A8.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97 dm-crypt/スワップを使用したsystem#Btrfsサブボリューム全体の暗号化] を参照してください。

既存の Btrfs ファイルシステムは [[EncFS]] や [[TrueCrypt]] のようなものを使用できますが、おそらく Btrfs の機能の一部はありません。

=== TLP ===

TLP を使用するには、ファイルシステムの破損を回避するために特別な予防措置が必要です。詳細については、 [[TLP#Btrfs|TLP の Btrfs セクション]] を参照してください。

=== btrfs チェックの問題 ===
ツール{{ic|btrfs check}} には既知の問題があるため、セクション [[#btrfscheck]] をよく参照してから実行してください。

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

=== パーティションレス Btrfs ディスク ===

{{Warning|
* ほとんどのユーザーはこのタイプのセットアップを望まず、代わりに通常のパーティションにBtrfsをインストールする必要があります。さらに、 GRUB はパーティションレスディスクへのインストールを強くお勧めしません。
* {{Pkg|grub}} 2.04 以降、GRUB の {{ic|core.img}} は大きすぎてBtrfsVBRに収まりません。 {{Bug|63656}} を参照してください。
}}

Btrfs は、 [[#Subvolumes|subvolumes]] を使用してパーティションをシミュレートし、 [[MBR]] または [[GPT]] パーティションスキームを置き換えて、データストレージデバイス全体を占有できます。ただし、別の方法で作成された既存の [https://wiki.archlinux.jp/index.php/%E3%83%91%E3%83%BC%E3%83%86%E3%82%A3%E3%82%B7%E3%83%A7%E3%83%8B%E3%83%B3%E3%82%B0 パーティション] で [[#File systemcreation|create a Btrfsfilesystem]] を実行するためにパーティションレスセットアップを使用する必要はありません。パーティションレスのシングルディスクセットアップには、いくつかの制限があります。

* 他の [[ファイルシステム]] を同じディスク上の別のパーティションに配置することはできません。
* バージョン5.0より前の Linux カーネルを使用している場合、 [[スワップ|スワップ領域]] は使用できません。 Btrfs は[https://wiki.archlinux.jp/index.php/%E3%82%B9%E3%83%AF%E3%83%83%E3%83%97#.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB スワップファイル] 5.0 より前をサポートしておらず、 [https://wiki.archlinux.jp/index.php/%E3%82%B9%E3%83%AF%E3%83%83%E3%83%97#.E3.82.B9.E3.83.AF.E3.83.83.E3.83.97.E3.83.91.E3.83.BC.E3.83.86.E3.82.A3.E3.82.B7.E3.83.A7.E3.83.B3 スワップパーティション] を作成する場所もありませんでした。
* [[UEFI]] を使用して起動することはできません。

既存のパーティションテーブルを Btrfs で上書きするには、次のコマンドを実行します:

# mkfs.btrfs /dev/sd''X''

たとえば、 {{ic|/dev/sda1}} ではなく {{ic|/dev/sda}} を使用します。後者は、パーティショニングスキーム全体を置き換えるのではなく、既存のパーティションをフォーマットします。ルートパーティションは Btrfs なので、 {{ic|btrfs}} がカーネルに組み込まれていることを確認するか、 {{ic|btrfs}} を [[mkinitcpio.conf#MODULES]] と [https://wiki.archlinux.jp/index.php/Mkinitcpio#.E3.82.A4.E3.83.A1.E3.83.BC.E3.82.B8.E4.BD.9C.E6.88.90.E3.81.A8.E3.82.A2.E3.82.AF.E3.83.86.E3.82.A3.E3.83.99.E3.83.BC.E3.82.B7.E3.83.A7.E3.83.B3 initramfsを再生成する] に入れてください。

[https://wiki.archlinux.jp/index.php/Arch_%E3%83%96%E3%83%BC%E3%83%88%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9#.E3.83.96.E3.83.BC.E3.83.88.E3.83.AD.E3.83.BC.E3.83.80.E3.83.BC ブートローダ] を、 [https://wiki.archlinux.jp/index.php/%E3%83%91%E3%83%BC%E3%83%86%E3%82%A3%E3%82%B7%E3%83%A7%E3%83%8B%E3%83%B3%E3%82%B0#Master_Boot_Record マスターブートレコード] を備えたデータ記憶装置の場合と同様にインストールします。[[Syslinux#手動インストール]] または [[GRUB/Tips and tricks#パーティションまたはパーティションレスディスクへのインストール]] を参照してください。 {{ic|/sysrootをマウントできませんでした。}} が原因でカーネルがブートしない場合は、 {{ic|/etc/default/grub}} に {{ic|1=GRUB_PRELOAD_MODULES="btrfs"}} を追加して、 grub 設定 ([[GRUB#メインの構成ファイルを生成する]]) を生成してください。

=== Ext3/4 から Btrfs への変換 ===

{{Warning|btrfs メーリングリストには、不完全/破壊/破損した変換に関する多くの報告があります。失いたくないデータや ''作業中'' のバックアップがあることを確認してください。詳細については、 btrfswiki の [https://btrfs.wiki.kernel.org/index.php/Conversion_from_Ext3Conversion fromExt3] を参照してください。}}
{{Warning| btrfs-progs 5.6.1 以前にはバグがあり、最後のブロックグループのサイズが間違った btrfs ファイルシステムが生成され、新しく変換されたbtrfsをマウントできなくなります。このバグは、 [https://github.com/kdave/btrfs-progs/commit/0ff7a9b5210723bd4ad0d9d78dbbb18ee8fdd2b1#diff-31168275dcaac634489082b54c4c66d0 thiscommit] の btrfs-progs5.7 で修正されています。 btrfs-progs5.7-1 以降の btrfs-convert を使用してください。}}

インストール CD から起動し、次の手順で変換します:

# btrfs-convert /dev/''partition''

パーティションをマウントし、ファイルをチェックして変換をテストします。変更を反映するために、必ず {{ic|/etc/fstab}} を変更してください( '''type''' を {{ic|btrfs}} に、 '''fs_passno''' [最後のフィールド] を {{ic|0}} Btrfs は起動時にファイルシステムチェックを行わないため)。また、パーティションの UUID が変更されることに注意してください。したがって、 UUID を使用する場合は、それに応じて fstab を更新してください。 {{ic|chroot}} をシステムにインストールし、 GRUB メニューリストを再構築します ([[既存の Linux からインストール]] および [[GRUB]] の記事を参照)。ルートファイルシステムを変換する場合、 chroot されたまま {{ic|mkinitcpio -p linux}} を実行して initramfs を再生成しないと、システムが正常に起動しません。 'unknown filesystem' で grub でスタックした場合は、 {{ic|grub-install /dev/''partition''}} で grub を再インストールし、構成も再生成してください {{ic|grub-mkconfig -o /boot/grub/grub.cfg}}

{{Note|新しく変換された btrfs にファイルをマウントまたは書き込みできないなどの問題がある場合は、バックアップサブボリューム {{ic|/ext2_saved}} がまだ存在する限り、常にロールバックするオプションがあります。 {{ic|btrfs-convert -r /dev/''partition''}} コマンドを使用してロールバックします。これにより、新しく変換された btrfs ファイルシステムへの変更が破棄されます。}}

問題がないことを確認したら、バックアップ {{ic|ext2_saved}} サブボリュームを削除して変換を完了します。これがないと ext3/4 に戻れないことに注意してください。

# btrfs subvolume delete /ext2_saved

最後に [[#Balance|balance]] ファイルシステムでスペースを再利用します。

以前にインストールされた一部のアプリケーションは、 Btrfs に適合させる必要があることに注意してください。特に [[TLP#Btrfs]] はファイルシステムの破損を避けるために特別な注意が必要です。

=== チェックサムのハードウェアアクセラレーション ===

Btrfs のチェックサムでハードウェアアクセラレーションが使われているかどうか確認するには:
{{hc|<nowiki>$ dmesg | grep crc32c</nowiki>|<nowiki>Btrfs loaded, crc32c=crc32c-intel</nowiki>}}

{{ic|<nowiki>crc32c=crc32c-generic</nowiki>}} と表示された場合、ルートパーティションが Btrfs であるため、ハードウェアアクセラレーションを使うにはカーネルに {{ic|crc32c-intel}} を組み込む必要があります。[[mkinitcpio.conf]] に {{ic|crc32c-intel}} を追加するだけでは機能しません。

=== ファイルシステム破損のリカバリ ===

{{Warning|{{ic|btrfs check}} ツールには既知の問題があります。セクション [[Btrfs#btrfs check|btrfs check]] を参照してください。}}

''btrfs-check'' はマウントされているファイルシステムでは使えません。ライブ USB から起動しないで ''btrfs-check'' を使えるようにするには、初期 RAM ディスクに以下のように追加してください:

{{hc|/etc/mkinitcpio.conf|output=
BINARIES="/usr/bin/btrfs"
}}

設定したら [[mkinitcpio]] を使って initramfs を再生成してください。

起動に問題が発生したら、ユーティリティを使って修復することができます。

{{Note|fsck でキャッシュを無効化する必要がある場合、起動後に一定時間フリーズするのは通常の動作です (btrfs-transaction がハングアップしているというメッセージがコンソールに表示されます)。しばらく経てばシステムは復帰します。}}

詳しくは [https://btrfs.wiki.kernel.org/index.php/Btrfsck Btrfs Wiki] を参照。

=== スナップショットから起動する ===

スナップショットをブートするためには、セクション [[Btrfs#サブボリュームをルートとしてマウントする|サブボリュームをルートとしてマウントする]] で説明されているように、サブボリュームをルートパーティションとしてマウントする場合と同じ手順が適用されます。スナップショットはサブボリュームのようにマウントできます。

* [[GRUB]] を使用している場合、{{Pkg|grub-btrfs}} または {{AUR|grub-btrfs-git}} を使用して構成ファイルを再生成すると、自動的に btrfs スナップショットをブートメニューに取り込むことができます。
* [[rEFInd]] を使用している場合は、{{ic|refind-btrfs.service}} を [[systemd#ユニットを使う|有効]] にして開始後に、{{AUR|refind-btrfs}} を使用してブートメニューに btrfs スナップショットを自動的に取り込むことができます。

=== systemd-nspawn で Btrfs サブボリュームを使う ===

[[Systemd-nspawn#Btrfs のサブボリュームをコンテナのルートとして使う]]や [[Systemd-nspawn#コンテナの一時的な Btrfs スナップショットを使う]]を見てください。

=== アクセス時間のメタデータ更新を削減 ===

Btrfs は書き込み時にコピーの性質を持つため、ファイルにアクセスするだけでメタデータのコピーと書き込みを開始します。アクセス時間の更新頻度を減らすと、この予期しないディスク使用がなくなり、パフォーマンスが向上する可能性があります。使用可能なオプションについては、 [[fstab#atime オプション|atime オプション]] を参照してください。

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

一般的なトラブルシューティングについては [https://btrfs.wiki.kernel.org/index.php/Problem_FAQ Btrfs Problem FAQ] を見て下さい。

=== GRUB ===

==== パーティションオフセット ====

[[GRUB]] は Btrfs パーティションを起動することができますが、そのモジュールは ext4 などよりも大きく、''grub-install'' によって作成される {{ic|core.img}} が MBR と最初のパーティションの間に収まらない可能性があります。GPT を使うか、最初のパーティションの前に数 MB の空きスペースを作ることでこの問題を解決できます。

==== root が見つからない ====

RAID セットアップから起動した時にエラー {{ic|1=error no such device: root}} が表示される場合、{{ic|/usr/share/grub/grub-mkconfig_lib}} を編集して {{ic|1=echo " search --no-floppy --fs-uuid --set=root ${hints} ${fs_uuid}"}} からクォートを削除してください。grub の設定を再生成すればエラーを出さずに起動できるはずです。

=== BTRFS: open_ctree failed ===

2014年11月現在、{{ic|mkinitcpio.conf}} で {{ic|btrfs}} フックを使用してマルチデバイスの Btrfs を使っている場合に以下のエラーが発生するというバグが [[systemd]] か [[mkinitcpio]] のどちらかに存在します:

{{bc|<nowiki>
BTRFS: open_ctree failed
mount: wrong fs type, bad option, bad superblock on /dev/sdb2, missing codepage or helper program, or other error

In some cases useful info is found in syslog - try dmesg|tail or so.

You are now being dropped into an emergency shell.
</nowiki>}}

{{ic|/etc/mkinitcpio.conf}} の {{ic|HOOKS}} 行から {{ic|btrfs}} を削除して代わりに {{ic|MODULES}} 行に {{ic|btrfs}} を追加することで解決します。修正を施したら {{ic|mkinitcpio -p linux}} で initramfs を再生成して (必要ならプリセットを調整します) 再起動してください。

詳細は [https://bbs.archlinux.org/viewtopic.php?id=189845 フォーラムスレッド] や {{Bug|42884}} を見て下さい。

デバイスが存在しない raid アレイをマウントしようとしたときも同じエラーが表示されます。その場合は {{ic|/etc/fstab}} に {{ic|degraded}} マウントオプションを追加してください。ルートパーティションがアレイ上にある場合、[[カーネルパラメータ]]に {{ic|1=rootflags=degraded}} を追加してください。

=== btrfs check ===

{{Warning|Btrfs はまだ開発途上であり、特に {{ic|btrfs check}} コマンドについては仕様が固まっていないので、{{ic|--repair}} スイッチを付けて {{ic|btrfs check}} を実行するときはあらかじめ Btrfs のドキュメントを読んでバックアップを作成することを強く推奨します。}}

''[https://btrfs.wiki.kernel.org/index.php/Manpage/btrfs-check btrfs check]'' コマンドを使うことでアンマウントされた Btrfs ファイルシステムをチェックしたり修復することが可能です。ただし、この修復ツールはまだ開発中であり、特定のファイルシステムエラーは修復することができません。

詳しくは [https://btrfs.wiki.kernel.org/index.php/Btrfsck Btrfsck] を参照。

== 参照 ==

* 公式サイト
** [https://btrfs.wiki.kernel.org/ Btrfs Wiki]
* パフォーマンス関連
** [https://superuser.com/questions/432188/should-i-put-my-multi-device-btrfs-filesystem-on-disk-partitions-or-raw-devices Btrfs on raw disks?]
** [http://comments.gmane.org/gmane.comp.file-systems.btrfs/19440 Varying leafsize and nodesize in Btrfs]
** [http://comments.gmane.org/gmane.comp.file-systems.btrfs/15646 Btrfs support for efficient SSD operation (data blocks alignment)]
** [https://btrfs.wiki.kernel.org/index.php/FAQ#Is_Btrfs_optimized_for_SSD.3F Is Btrfs optimized for SSDs?]
** Phoronix によるマウントオプションのベンチマーク
*** [https://www.phoronix.com/scan.php?page=article&item=btrfs-mount-linux49 Linux 4.9]
*** [https://www.phoronix.com/scan.php?page=article&item=linux_314_btrfs Linux 3.14]
*** [https://www.phoronix.com/scan.php?page=article&item=linux_btrfs_311&num=1 Linux 3.11]
*** [https://www.phoronix.com/scan.php?page=news_item&px=MTM0OTU Linux 3.9]
*** [https://www.phoronix.com/scan.php?page=article&item=btrfs_linux37_mounts&num=1 Linux 3.7]
*** [https://www.phoronix.com/scan.php?page=article&item=linux_btrfs_options&num=1 Linux 3.2]
** [http://blog.erdemagaoglu.com/post/4605524309/lzo-vs-snappy-vs-lzf-vs-zlib-a-comparison-of Lzo vs. zLib]
* その他
** [http://www.funtoo.org/wiki/BTRFS_Fun Funtoo Wiki Btrfs Fun]
** [https://www.phoronix.com/scan.php?page=news_item&px=MTA0ODU Avi Miller presenting Btrfs] at SCALE 10x, January 2012.
** [https://www.phoronix.com/scan.php?page=news_item&px=MTA4Mzc Summary of Chris Mason's talk] from LFCS 2012
** [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commit;h=35054394c4b3cecd52577c2662c84da1f3e73525 Btrfs: stop providing a bmap operation to avoid swapfile corruptions] 2009-01-21
** [http://marc.merlins.org/perso/btrfs/post_2014-03-22_Btrfs-Tips_-Doing-Fast-Incremental-Backups-With-Btrfs-Send-and-Receive.html Doing Fast Incremental Backups With Btrfs Send and Receive]

アプリケーション一覧/セキュリティ

2021-10-25T01:13:57Z

Funcrab: Fix: bitwarden, bitwarden-cli のパッケージが AUR -> 公式に移動したのを反映

<noinclude>
[[Category:アプリケーション]]
[[カテゴリ:セキュリティ]]
[[Category:ソフトウェア一覧]]
[[en:List of applications/Security]]
[[es:List of applications (Español)/Security]]
[[it:List of applications (Italiano)/Security]]
[[pt:List of applications (Português)/Security]]
[[ru:List of applications (Русский)/Security]]
[[zh-hans:List of applications (简体中文)/Security]]
[[zh-hant:List of applications (正體中文)/Security]]
{{List of Applications navigation}}
</noinclude>
== セキュリティ ==

詳しいガイドは、ArchWiki のメインページを見て下さい、[[セキュリティ]]。

=== ネットワークセキュリティ ===

See also [[Wikipedia:Comparison of packet analyzers]].

* {{App|airgeddon|Multi-use bash script to audit wireless networks|https://github.com/v1s1t0r1sh3r3/airgeddon|{{AUR|airgeddon-git}}}}
* {{App|[[Wikipedia:Arpwatch|Arpwatch]]|Ethernet の活動を監視し Ethernet/IP アドレスペアリングのデータベースを保持するツール。|https://ee.lbl.gov/|{{Pkg|arpwatch}}}}
* {{App|bettercap|Swiss army knife for network attacks and monitoring.|https://www.bettercap.org/|{{Pkg|bettercap}}}}
* {{App|darkstat|Captures network traffic, calculates statistics about usage, and serves reports over HTTP.|https://unix4lyfe.org/darkstat/|{{Pkg|darkstat}}}}
* {{App|[[Wikipedia:dSniff|dsniff]]|Collection of tools for network auditing and penetration testing.|https://www.monkey.org/~dugsong/dsniff/|{{Pkg|dsniff}}}}
* {{App|[[Wikipedia:EtherApe|EtherApe]]|etherman を手本に作成されたグラフィカルネットワークモニター。Featuring link layer, IP and TCP modes, ネットワークの活動状態をグラフィカルに表示します。Hosts and links change in size with traffic. Color coded protocols display.|https://etherape.sourceforge.io/|{{Pkg|etherape}}}}
* {{App|[[Wikipedia:Ettercap (software)|Ettercap]]|Multipurpose Network sniffer/analyser/interceptor/logger.|https://ettercap.github.io/ettercap/|CLI: {{Pkg|ettercap}}, GUI: {{Pkg|ettercap-gtk}}}}
* {{App|GNOME Network Tools|GNOME interface for various networking tools.|https://gitlab.gnome.org/GNOME/gnome-nettool|{{Pkg|gnome-nettool}}}}
* {{App|[[Honeyd]]|コンピュータネットワーク上に複数の仮想ホストを設定・起動するためのツール。||http://www.honeyd.org/|{{AUR|honeyd}}}}
* {{App|hping|Command-line oriented TCP/IP packet assembler/analyzer.|http://hping.org/|{{Pkg|hping}}}}
* {{App|IPTraf|コンソールベースのネットワークモニタリングユーティリティ。|https://sourceforge.net/projects/iptraf-ng/|{{Pkg|iptraf-ng}}}}
* {{App|jnettop|top-like console network traffic visualizer.|https://sourceforge.net/projects/jnettop/|{{Pkg|jnettop}}}}
* {{App|[[Wikipedia:justniffer|justniffer]]|Network protocol analyzer that captures network traffic and produces logs in a customized way, can emulate Apache web server log files, track response times and extract all "intercepted" files from the HTTP traffic.|http://justniffer.sourceforge.net/|{{AUR|justniffer}}}}
* {{App|Kismet|802.11 layer2 ワイヤレスネットワークの検出・キャプチャ・侵入検知システム。|https://www.kismetwireless.net/|{{Pkg|kismet}}}}
* {{App|LinSSID|Graphical wireless scanner.|https://sourceforge.net/projects/linssid/|{{Pkg|linssid}}}}
* {{App|Nemesis|コマンドラインのネットワークパケットクラフト・インジェクションツール。|http://nemesis.sourceforge.net/|{{AUR|nemesis}}}}
* {{App|Net Activity Viewer|Graphical network connections viewer, similar in functionality with Netstat.|http://netactview.sourceforge.net/|{{AUR|netactview}}}}
* {{App|[[Wikipedia:netsniff-ng|netsniff-ng]]|High performance Linux network sniffer for packet inspection.|http://netsniff-ng.org/|{{Pkg|netsniff-ng}}}}
* {{App|[[Wikipedia:ngrep|ngrep]]|grep-like utility that allows you to search for network packets on an interface.|https://github.com/jpr5/ngrep|{{Pkg|ngrep}}}}
* {{App|[[Nmap]]|コンピュータネットワーク上のホストとサービスを探しネットワークの"マップ"を作るために使われるセキュリティスキャナ。|https://nmap.org/|CLI: {{Pkg|nmap}}, GUI: {{AUR|zenmap}}}}
* {{App|[[Ntop]]|top がプロセスの動きを表示するように、ネットワークの使用を表示するためのネットワーク監視ツール。|https://www.ntop.org/|{{AUR|ntop}}}}
* {{App|pyNeighborhood|GTK-based SMB/CIFS browsing utility.|https://launchpad.net/pyneighborhood|{{AUR|pyneighborhood}}}}
* {{App|Smb4K|Advanced network neighborhood browser and Samba share mounting utility for KDE.|https://smb4k.sourceforge.io/|{{Pkg|smb4k}}}}
* {{App|[[Snort]]|ネットワーク侵入防止・検知システム。|https://www.snort.org/|{{AUR|snort}}}}
* {{App|Spectools|Wi-Spy デバイスなどのハードウェアのスペクトラムアナライザとして使えるユーティリティ集。|https://www.kismetwireless.net/static/spectools/|{{AUR|spectools}}}}
* {{App|[[Sshguard]]|ブルートフォース攻撃から SSH などのサービスを防護する Fail2ban に似たデーモン。|https://www.sshguard.net/|{{Pkg|sshguard}}}}
* {{App|[[Suricata]]|高性能なネットワーク IDS, IPS, Network Security Monitoring エンジン。|https://suricata-ids.org/|{{AUR|suricata}}}}
* {{App|[[Network Debugging#Tcpdump|Tcpdump]]|コンソールベースのパケットアナライザで、ネットワーク越しに転送された TCP/IP などのパケットを傍受して表示することができます。|http://www.tcpdump.org/|{{Pkg|tcpdump}}}}
* {{App|[[Wikipedia:tcptrace|tcptrace]]|TCP dump file analysis tool.|http://tcptrace.org/{{Dead link|2020|12|27|status=403}}|{{Pkg|tcptrace}}}}
* {{App|[[vnStat]]|選択したインターフェースのトラフィックをログする、コンソールベースのネットワークトラフィックモニタ。|https://humdi.net/vnstat/|{{Pkg|vnstat}}}}
* {{App|What IP|Small GTK application to get info on your IP.|https://gabmus.gitlab.io/whatip/|{{AUR|whatip-git}}}}
* {{App|wifiphisher|Fast automated phishing attacks against WPA networks.|https://github.com/wifiphisher/wifiphisher|{{AUR|wifiphisher-git}}}}
* {{App|[[Wireshark]]|コンピュータネットワークで動いているトラフィックを見るためのネットワークプロトコルアナライザー。|https://www.wireshark.org/|CLI: {{Pkg|wireshark-cli}}, GUI: {{Pkg|wireshark-qt}}}}
* {{App|[[Wikipedia:Xplico|Xplico]]|Network forensics analysis tool (NFAT), which is a software that reconstructs the contents of acquisitions performed with a packet sniffer.|https://www.xplico.org/|{{AUR|xplico}}}}
* {{App|Zeek|Powerful network analysis framework that is much different from the typical IDS you may know.|https://zeek.org/|{{AUR|zeek}}}}

=== ファイアウォール ===

See [[iptables#Front-ends]].

=== 脅威と脆弱性保護 ===

* {{App|AFICK|ファイルシステムの変更を監視して侵入を検知するセキュリティツール。|http://afick.sourceforge.net/|{{AUR|afick}}}}
* {{App|[[Wikipedia:Lynis|Lynis]]|Unix/Linux システムを防護するセキュリティ・システム監査ツール。|https://cisofy.com/lynis/|{{Pkg|lynis}}}}
* {{App|[[Metasploit Framework]]|exploit コードを開発・テスト・使用するための高度なオープンソースプラットフォーム。|https://www.metasploit.com/|{{Pkg|metasploit}}}}
* {{App|[[Nessus]]|総合的な脆弱性スキャンプログラム。|https://www.tenable.com/products/nessus|{{AUR|nessus}}}}
* {{App|[[OpenVAS]]|脆弱性をスキャンして管理する包括的かつ強力なソリューションを提供する複数のサービスとツールからなるフレームワーク。FOSS Nessus のフォーク。|http://www.openvas.org/|{{AUR|openvas-scanner}}}}
* {{App|OSSEC|オープンソースのホストベースの侵入検知システム。ログを解析、ファイルの整合性を確認、ポリシーを確認、rootkit を検出、リアルタイムの改変に対応します。|https://ossec.github.io/|{{AUR|ossec-agent}} {{AUR|ossec-local}} {{AUR|ossec-server}}}}
* {{App|Samhain|ホストベースの侵入検知システム (HIDS)。ファイルの整合性の確認、ログファイルの監視・解析、rootkit の検出、ポートの監視、危険な SUID 実行ファイルや隠しプロセスを検出します。|https://www.la-samhna.de/samhain/index.html|{{AUR|samhain}}}}
* {{App|[[Wikipedia:Tiger (security software)|Tiger]]|セキュリティ監査と侵入検知システムの両方の役割を果たすことができるセキュリティツール。|http://www.nongnu.org/tiger/|{{AUR|tiger}}}}
* {{App|[[Wikipedia:Open Source Tripwire|Tripwire]]|侵入検知システム。|https://github.com/Tripwire/tripwire-open-source|{{AUR|tripwire-git}}}}

=== ファイルセキュリティ ===

* {{App|[[AIDE]]|ファイルとディレクトリの整合性チェッカー。|https://aide.github.io|{{AUR|aide}}}}
* {{App|[[Logwatch]]|カスタマイズできるログ分析システム。|https://sourceforge.net/projects/logwatch/|{{Pkg|logwatch}}}}

=== アンチマルウェア ===

* {{App|[[ClamAV]]|オープンソースのアンチウイルスエンジン。トロイの木馬、ウイルス、マルウェアなどの危険なプログラムを検出します。|http://www.clamav.net/|{{Pkg|clamav}}}}
* {{App|ClamTk|Graphical front-end for ClamAV using Perl and Gtk libraries. It is designed to be an easy-to-use, lightweight, on-demand antivirus scanner for Linux systems.|https://dave-theunsub.github.io/clamtk/|{{Pkg|clamtk}}, Nautilus plugin: {{AUR|clamtk-gnome}}, MATE plugin: {{AUR|clamtk-mate}}, Thunar plugin: {{AUR|thunar-sendto-clamtk}}}}
* {{App|Linux Malware Detect||共有ホスト環境の脅威に対応するために作られたマルウェアスキャナ。|https://www.rfxn.com/projects/linux-malware-detect/|{{AUR|maldet}}}}
* {{App|Rootkit Hunter|rootkit などの招かれざるツールの存在をチェックします。|http://rkhunter.sourceforge.net/|{{Pkg|rkhunter}}}}
* {{App|Hostsblock|A script that downloads, sorts, and compiles multiple ad- and malware-blocking {{ic|hosts}} files.|https://gaenserich.github.io/hostsblock/|{{AUR|hostsblock}}}}

=== スクリーンロック ===

{{Merge|Session lock#By environment|Same purpose.}}

See also [[Session lock]].

{{Warning|''sflock'', ''physlock'', ''Cinnamon Screensaver'', ''MATE Screensaver'', ''GNOME Screensaver'' だけが tty アクセスをブロックすることができます。手動でブロックする方法は [[Xorg#TTY のアクセスをブロック]]を見てください。}}

* {{App|betterlockscreen|''i3lock-color'' wrapper. Betterlockscreen allows you to cache images with different filters and lockscreen with blazing speed.|https://github.com/pavanjadhaw/betterlockscreen|{{Aur|betterlockscreen}}}}
* {{App|Cinnamon Screensaver|Cinnamon デスクトップの画面ロッカー。|https://github.com/linuxmint/cinnamon-screensaver|{{Pkg|cinnamon-screensaver}}}}
* {{App|Deepin Screensaver|A lightweight Qt5 based screensaver.|https://github.com/linuxdeepin/deepin-screensaver|{{Pkg|deepin-screensaver}}}}
* {{App|GNOME Screensaver|Legacy GNOME デスクトップの画面ロッカー。Unmaintained since 2012.|https://wiki.gnome.org/Attic/GnomeScreensaver|{{Pkg|gnome-screensaver}}}}
* {{App|i3lock|シンプルな画面ロッカー。ユーザーフィードバックを提供し、PAM 認証を使用します。画像や単色の背景を設定可能。|https://i3wm.org/i3lock/|{{Pkg|i3lock}}}}
* {{App|i3lock-blur|''i3lock'' のフォークで背景としてブラー効果をかけたデスクトップを使うことができます。|https://github.com/karulont/i3lock-blur|{{Aur|i3lock-blur}}}}
* {{App|i3lock-color|Fork of ''i3lock'' with color and positioning configuration support and 背景画像としてブラーのかかったデスクトップのスクリーンショットをセットします。|https://github.com/Raymo111/i3lock-color|{{AUR|i3lock-color}}, {{AUR|i3lock-color-git}}}}
* {{App|Light-locker|デスクトップの依存を増やすことなくデスクトップと統合することができる、単純な安全で安心なシンプルロッカー (''gnome-screensaver'' のフォーク)。ConsoleKit/UPower や ''logind/systemd'' でセッションをロックするために [[LightDM]] を使っています。|https://github.com/the-cavalry/light-locker|{{Pkg|light-locker}}}}
* {{App|MATE Screensaver|MATE デスクトップ環境のスクリーンセーバー・ロッカー。|https://github.com/mate-desktop/mate-screensaver|{{Pkg|mate-screensaver}}}}
* {{App|physlock|画面とコンソールのロッカー。|https://github.com/muennich/physlock|{{Pkg|physlock}}}}
* {{App|sflock|X 用の slock ベースのシンプルなスクリーンロッカー。基本的なユーザーフィードバックを提供します。|https://github.com/benruijl/sflock|{{AUR|sflock-git}}}}
* {{App|[[slock]]|てもシンプルで軽量な X スクリーンロッカー。ロック時には黒い背景しか表示しません、アニメーションやテキストはありません。|https://tools.suckless.org/slock/|{{Pkg|slock}}}}
* {{App|sxlock|sflock のフォーク。基本的なユーザーフィードバック・PAM 認証・DPMS と RandR をサポート。サスペンドやハイバネート時に画面をロックする {{ic|sxlock.service}} があります。詳しくは [https://github.com/lahwaacz/sxlock/blob/master/README.md README] を参照。|https://github.com/lahwaacz/sxlock|{{AUR|sxlock-git}}}}
* {{App|tsscreenlock|theShell で使われているスクリーンロッカー。音楽のコントロールを表示し、theShell を使用している場合、デスクトップ通知も表示。|https://github.com/vicr123/tsscreenlock|{{AUR|tsscreenlock}}}}
* {{App|vlock|TTY ロッカー。[https://lists.archlinux.org/pipermail/aur-general/2013-July/024662.html オリジナルの vlock] のミラーは [https://github.com/WorMzy/vlock GitHub] から取得できます。|http://kbd-project.org/|{{Pkg|kbd}}}}
* {{App|xfce4-screensaver|A screen saver and locker that aims to have simple, sane, secure defaults and be well integrated with the xfce desktop.|https://git.xfce.org/apps/xfce4-screensaver/about/|{{Pkg|xfce4-screensaver}}}}
* {{App|xlockmore|シンプルな X11 画面ロック。PAM 対応。|http://sillycycle.com/xlockmore.html|{{Pkg|xlockmore}}}}
* {{App|[[XScreenSaver]]|X Window System 向けのスクリーンセーバー・ロッカー。|https://www.jwz.org/xscreensaver/|{{Pkg|xscreensaver}}}}
* {{App|XSecureLock|セキュリティに焦点を置いた X11 のスクリーンロックユーティリティ。|https://github.com/google/xsecurelock|{{Pkg|xsecurelock}}}}
* {{App|xtrlock|非常に軽量な X ディスプレイロッカー。ウィンドウは表示したままで、マウスカーソルの代わりにロックアイコンを表示します。パスワードを入力すれば画面のロックは解除されます。|https://packages.debian.org/sid/xtrlock|{{Pkg|xtrlock}}}}

=== Password auditing ===

* {{App|[[Wikipedia:John the Ripper|John the Ripper]]|Password cracker.|https://www.openwall.com/john|{{Pkg|john}}}}
* {{App|[[Hashcat]]|Multithreaded advanced password recovery utility.|https://hashcat.net/hashcat|{{Pkg|hashcat}}}}

=== パスワードマネージャ ===

See also [[KeePass]].

==== Console ====

* {{App|gopass|Advanced console based password manager, supporting GnuPG and other backends.|https://github.com/justwatchcom/gopass|{{Pkg|gopass}}}}
* {{App|KeePassC|Curses-based password manager compatible to KeePass v.1.x.|https://outerhaven.de/keepassc/|{{AUR|keepassc}}}}
* {{App|LastPass|Hosted password manager. |https://www.lastpass.com/|{{Pkg|lastpass-cli}}}}
* {{App|[[pass]]|シンプルなコンソールベースのパスワードマネージャ featuring flat text file organization and GnuPG encryption.|https://www.passwordstore.org/|{{Pkg|pass}}}}
* {{App|pwsafe|暗号化されたパスワードデータベースを管理する Unix コマンドラインプログラム。|http://nsd.dyndns.org/pwsafe/|{{AUR|pwsafe}}}}
* {{App|spm|PGP を使用して POSIX シェルだけで書かれたシンプルなパスワードマネージャ。軽量・高速でスクリプトに簡単に組み込めます。|https://notabug.org/kl3/spm/|{{AUR|spm}}}}
* {{App|tpm|tiny password manager, inspired by pass, written entirely in POSIX shell.|https://github.com/nmeum/tpm|{{AUR|tpm}}}}
* {{App|Ylva|Command-line password manager, written in C, uses OpenSSL.|https://www.ylvapasswordmanager.com/|{{AUR|ylva}}}}

==== Graphical ====

* {{App|Authenticator|Two-factor authentication application built for GNOME.|https://gitlab.gnome.org/World/Authenticator|{{AUR|authenticator}}}}
* {{App|Bitwarden|Open source password manager with desktop, mobile, browser, and CLI versions. Cloud or self-hosted.|https://bitwarden.com/|{{Pkg|bitwarden}}, {{Pkg|bitwarden-cli}}}}
* {{App|Encryptr|ゼロ知識・クラウドベースのパスワードマネージャ。|https://spideroak.com/encryptr/|{{AUR|encryptr}}}}
* {{App|Enpass|マルチプラットフォームのパスワードマネージャ。|https://www.enpass.io/|{{AUR|enpass-bin}}}}
* {{App|Figaro's Password Manager 2|[http://fpm.sourceforge.net/ Figaro's Password Manager] の GTK2 ポートで新機能がいくつか追加されています。|https://als.regnet.cz/fpm2/|{{AUR|fpm2}}}}
* {{App|GNOME Password Safe|Password manager for GNOME which makes use of the KeePass v.4 format.|https://gitlab.gnome.org/World/PasswordSafe|{{Pkg|gnome-passwordsafe}}}}
* {{App|Ked Password Manager|大量のパスワードを扱うのに役立つパスワードマネージャ。|http://kedpm.sourceforge.net|{{AUR|kedpm}}}}
* {{App|[[KeePass|KeePass Password Safe]]|安全な方法でパスワードを管理するための、パスワードマネージャ。Mono ベース。|https://keepass.info/|{{Pkg|keepass}}}}
* {{App|KeePassX|Qt-based password manager. KeePass v.1.x や KeePass v.2.x と互換性あり。|https://www.keepassx.org/|version 1: {{AUR|keepassx}}, version 2: {{AUR|keepassx2}}}}
* {{App|KeePassXC|Community fork of KeePassX with more active development. Compatible with KeePass v.1.x (import only) and KeePass v.2.x.|https://keepassxc.org/|{{Pkg|keepassxc}}}}
* {{App|[[KDE Wallet|KDE Wallet Manager]]|Tool to manage the passwords on your system. By using the KDE wallet subsystem it not only allows you to keep your own secrets but also to access and manage the passwords of every application that integrates with the wallet.|https://kde.org/applications/en/system/org.kde.kwalletmanager5|{{Pkg|kwalletmanager}}}}
* {{App|OTPClient|Highly secure and easy to use GTK software for two-factor authentication that supports both Time-based One-time Passwords (TOTP) and HMAC-Based One-Time Passwords (HOTP).|https://github.com/paolostivanin/OTPClient|{{AUR|otpclient}}}}
* {{App|Passbook|Modern password manager for GNOME.|https://wiki.gnome.org/Apps/Passbook|{{AUR|passbook}}}}
* {{App|Password Gorilla|クロスプラットフォームのパスワードマネージャ。|https://github.com/zdia/gorilla/wiki|{{AUR|password-gorilla}}}}
* {{App|Password Safe|シンプルで安全なパスワードマネージャ。|https://pwsafe.org/|{{AUR|passwordsafe}}}}
* {{App|QPass|パスワード生成器が付いている使いやすいパスワードマネージャ。|http://qpass.sourceforge.net/|{{AUR|qpass}}}}
* {{App|QtPass|GUI for pass, the standard unix password manager.|https://qtpass.org/|{{Pkg|qtpass}}}}
* {{App|Revelation|GNOME デスクトップのパスワードマネージャ。|https://revelation.olasagasti.info/|{{AUR|revelation}}}}
* {{App|[[Wikipedia:Seahorse (software)|Seahorse]]|GNOME Keyring で暗号化キーとパスワードを管理する GNOME アプリケーション。|https://wiki.gnome.org/Apps/Seahorse|{{Pkg|seahorse}}}}
* {{App|Universal Password Manager|GNOME Keyring で暗号化キーとパスワードを管理する GNOME アプリケーション。|http://upm.sourceforge.net/|{{AUR|universal-password-manager}}}}

=== Cryptography ===

==== ハッシュチェッカー ====

* {{app|cfv|チェックサムファイルのテストと作成ができる小さなユーティリティ。{{ic|.sfv}}, {{ic|.csv}}, {{ic|.crc}}, {{ic|.md5}}, {{ic|md5sum}}, {{ic|sha1sum}}, {{ic|.torrent}}, {{ic|par}}, {{ic|.par2}} ファイルに対応。| http://cfv.sourceforge.net/|{{AUR|cfv}}}}
* {{App|GtkHash|メッセージダイジェストまたはチェックサムを計算する GTK ユーティリティ。|https://github.com/tristanheaven/gtkhash|{{AUR|gtkhash}}}}
* {{App|hashdeep|様々なファイルのハッシュやメッセージダイジェストを計算するクロスプラットフォームのツール。|http://md5deep.sourceforge.net/|{{Pkg|hashdeep}}}}
* {{App|Quick Hash GUI|ファイルのすばやい選択とハッシュ作成ができる GUI (フォルダ構造で別々に行ったり再帰的に使用可能)。|https://www.quickhash-gui.org/|{{AUR|quickhash-gui-bin}}}}
* {{App|RHash|ハッシュサムを確認するためのユーティリティ (SFV, CRC など)。多数のアルゴリズムをサポート。|https://github.com/rhash/RHash/|{{Pkg|rhash}}}}
* {{App|MassHash|Python で書かれたファイルハッシュ作成ツールのセット (CLI と GTK の GUI)。MD5, SHA-1, SHA-224, SHA-256, SHA-384, SHA-512 などのアルゴリズムをサポート。|https://jdleicher.github.io/MassHash/|{{AUR|masshash}}}}
* {{App|Parchive||https://github.com/Parchive/par2cmdline|{{Pkg|par2cmdline}}}}

==== 暗号化, 署名, ステガノグラフィー ====

* {{app|age|A simple, modern and secure encryption tool (and library) with small explicit keys, no config options, and UNIX-style composability.|https://age-encryption.org/v1|Go: {{Pkg|age}} {{AUR|age-git}} Rust: {{AUR|rust-rage}} {{AUR|rust-rage-git}}}}
* {{app|ccrypt|ファイルやストリームを暗号化・復号化するためのコマンドラインユーティリティ based on [[Wikipedia:Advanced_Encryption_Standard|Rijndael]].|http://ccrypt.sourceforge.net/|{{AUR|ccrypt}}}}
* {{App|[[Wikipedia:Enigmail|Enigmail]]|Mozilla Thunderbird や Seamonkey のセキュリティ拡張。OpenPGP 規格で暗号化・署名されたメールを送受信できるようになります。|https://enigmail.net|{{Pkg|thunderbird-extension-enigmail}}}}
* {{App|GNOME Keysign|GTK/GNOME application to use GnuPG for signing other people's keys. Quickly, easily, and securely.|https://wiki.gnome.org/Apps/Keysign|{{AUR|gnome-keysign}}}}
* {{App|[[GnuPG]]|RFC4880 で定義されている OpenPGP 標準の GNU プロジェクトによる完全でフリーな実装。パッケージの電子署名で広く使われている、PGP を置き換える。|https://gnupg.org/|{{Pkg|gnupg}}}}
* {{App|GPG-Crypter|Graphical front-end to GnuPG(GPG) using the GTK3 toolkit and GPGME library.|https://sourceforge.net/projects/gpg-crypter/|{{Pkg|gpg-crypter}}}}
* {{App|[[Keybase]]|Key directory mapping social media identities, with cross platform encrypted chat, cloud storage, and git repositories.|https://keybase.io/|{{Pkg|keybase}}}}
* {{App|[[Wikipedia:KGPG|KGpg]]|KDE のシンプルな GnuPG インターフェイス。|https://www.kde.org/applications/utilities/kgpg/|{{Pkg|kgpg}}}}
* {{App|Kleopatra|Certificate Manager and Unified Crypto GUI for KDE. It supports managing X.509 and OpenPGP certificates in the GpgSM keybox and retrieving certificates from LDAP servers.|https://www.kde.org/applications/utilities/kleopatra/|{{Pkg|kleopatra}}}}
* {{app|minisign|Simple program that only implements key signing|https://github.com/jedisct1/minisign|{{pkg|minisign}} }}
* {{App|[[Wikipedia:Seahorse (software)|Seahorse]]|GNOME Keyring で暗号鍵やパスワードを管理するための GNOME アプリケーション。|https://wiki.gnome.org/Apps/Seahorse|{{Pkg|seahorse}}}}
* {{App|scrypt|Command-line encryption utility featuring the memory-hardened {{ic|scrypt}} key derivation function.|https://www.tarsnap.com/scrypt.html|{{pkg|scrypt}}}}
* {{App|steghide|画像や音声ファイルなど様々な種類のファイルにデータを隠すことが出来るステガノグラフィーユーティリティ。|http://steghide.sourceforge.net|{{AUR|steghide}}}}

==== Data-at-rest encryption ====

See [[Data-at-rest encryption]].

=== 管理者権限 ===

* {{App|[https://man.openbsd.org/doas.1 doas]|A portable version of OpenBSD's doas command, known for being substantially smaller in size compared to sudo.|https://github.com/Duncaen/OpenDoas|{{pkg|opendoas}}}}
* {{App|[[su]]|Command used to assume the identity of another user on the system.|https://git.kernel.org/pub/scm/utils/util-linux/util-linux.git/about/|{{Pkg|util-linux}}}}
* {{App|[[sudo]]|Command to delegate the ability to run commands as root or another user while providing an audit trail.|https://www.sudo.ws/sudo/|{{pkg|sudo}}}}

Qutebrowser

2021-10-24T16:15:52Z

Funcrab: fix typo

{{Lowercase title}}
[[Category:ウェブブラウザ]]
[[en:Qutebrowser]]
[https://github.com/The-Compiler/qutebrowser qutebrowser] は軽量で vim ライクなキーボード操作ができる PyQt5 と QtWebEngine ベースのブラウザです。

== インストール ==

{{Pkg|qutebrowser}} または {{AUR|qutebrowser-git}} パッケージをインストールしてください。

== 基本的な使い方 ==

コマンドプロンプトを出すには {{ic|:}} を使います。{{ic|Tab}} で自動補完が効きます。

qutebrowser を初めて起動した場合、クイックスタートページが表示されます。クイックスタートは {{ic|:help}} でいつでも開けます。キーボードショートカットは [http://qutebrowser.org/img/cheatsheet-big.png チートシート] を見てください。

=== ユーザー設定 ===

UIから、コマンドラインから、もしくはPythonスクリプトからの三種類の方法で設定することができます。

qutebrowser に付属しているヘルプでは、それぞれの使い方について詳細に書かれています。ヘルプを参照するには、 {{ic|:help}} を入力し、そのページで {{ic|Configuring qutebrowser}} を選択してください。

設定ファイルがおかれるパスを知るには、 {{ic|qute://version}} を開いてください。Archlinux では {{ic|$XDG_CONFIG_HOME/qutebrowser/}}になるはずです。

qutebrowserによって設定される値は {{ic|autoconfig.yml}} (手動では変更しないべきです)に、ユーザーの書いた Python スクリプトは {{ic|config.py}} に保存されます。

==== UIから設定する ====

{{ic|:set}} で設定画面を開くことができます。設定が終わったら、もう一度 {{ic|:set}} することで保存できます。

例えば、 {{ic|url.searchengines}} の下では検索エンジンの設定ができます。これは、key-value のペアのリストとして保存されています。何も設定していない場合、以下のような値になっているはずです。

{"DEFAULT": "<nowiki>https://duckduckgo.com/?q={}</nowiki>"}

これは、DuckDuckGo をデフォルトの検索エンジンとして設定しています。ここで、{{ic|<nowiki>{}</nowiki>}} は検索する文字列に置き換えられます。

ArchWiki を検索するショートカットを追加したいときは、以下のようにします:

{"DEFAULT": "<nowiki>https://duckduckgo.com/?q={}</nowiki>", "aw": "<nowiki>https://wiki.archlinux.jp/?search={}</nowiki>"}

これで、 {{ic|:open aw qutebrowser}} と入力すればこのページが開かれるはずです。標準設定では {{ic|o}} で {{ic|:open}} を置き換えるようにキーマップが設定されているので、{{ic|o aw ''your_search_term''}} と入力することで ArchWiki を素早く検索できます。

検索するための引数の渡し方は検索エンジンによって異なることに注意してください。例えば Google を設定するには {{ic|<nowiki>https://www.google.com/search?hl=en&q={}</nowiki>}} とします

==== コマンドラインから設定する ====

{{ic|:set}} の後に、設定したい項目と設定したい値を打ちます。例えば、 qutebrowser を再起動したときに前回開いていたページを復元したい場合、以下のようにすることができます。

:set auto_save.session true

==== Python スクリプトで設定する ====

{{ic|:config-write-py --defaults}} でテンプレートファイルが生成されます。

詳しくは {{ic|qute://help/configuring.html#configpy}} を参照してください。

=== {{ic|qutebrowser.conf}} と {{ic|keys.config}} からのミグレーション ===

{{ic|qutebrowser.conf}} と {{ic|keys.config}} は、v1.0.0 以前までに使われていた方法です。

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

{{Note|キーバインドも他の設定と同じファイルに保存されるようになりました}}

{{ic|:bind ''key'' ''command''}} コマンドで直接ブラウザからキーバインドを編集してもかまいませんし、ファイルからキーバインドを編集することも可能です。初めから、大漁、盛りだくさんのキーバインドが設定されています。キーバインドにラグが感じられる場合、他のキーバインドが同じキーを使っているのが原因です。

=== 動画の再生 ===

[[ブラウザプラグイン#マルチメディアの再生]]を見てください。

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

=== {{ic|WM_CLASS}} を設定する ===

{{ic|--qt-arg NAME VALUE}} でQtに値を渡すことができます。{{ic|NAME}} に {{ic|name}} を指定すると、 {{ic|WM_CLASS}} に任意の文字列を設定することができます。

qutebrowser --qt-arg name <設定したい文字列>

これは、タイル型ウィンドウマネージャーでウィンドウの管理をする場合等に有用です。

{{Tip|{{ic|--temp-basedir}} や {{ic|--basedir}} を使わない場合、全てのウィンドウは同じqutebrowserインスタンスに属するため同じ {{ic|WM_CLASS}} を共有します。}}