「Uswsusp」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(文字列「http://git.kernel.org/」を「https://git.kernel.org/」に置換)
(アーカイブ)
タグ: 新規リダイレクト
 
1行目: 1行目:
  +
#redirect [[ArchWiki:アーカイブ]]
[[Category:電源管理]]
 
  +
[[Category:アーカイブ]]
[[en:Uswsusp]]
 
{{Related articles start}}
 
{{Related|hibernate-script}}
 
{{Related|Pm-utils}}
 
{{Related|TuxOnIce}}
 
{{Related articles end}}
 
 
[http://suspend.sourceforge.net/ uswsusp] (userspace software suspend) は Linux 環境でハイバネーション (suspend-to-disk) や サスペンド (suspend-to-RAM あるいは standby) をするために使われるユーザースペースツールのセットです。以下のツールから構成されます:
 
* '''s2ram''' - サスペンドの前や復帰後にグラフィックアダプタの操作をユーザーランドから行えるようにして復帰後にグラフィック (やシステム全体) を復活させる、カーネルの suspend-to-RAM 機構のラッパー。vbetool や radeontool の機能を取り入れます。動作中のハードウェアの設定リストと適切な操作のセットを読み込むことで正しく復帰を実行します。HAL によって管理されているハードウェアのホワイトリストを使用します - '''s2ram''' は HAL のデータベースオプションを '''s2ram''' のパラメータに翻訳します。
 
:{{Note|HAL は廃止されユーザー空間の設定を省いて直接 KMS ドライバーがグラフィックカードの状態を保存するため、'''s2ram''' の開発は終了しておりホワイトリストのエントリがこれから追加されることはありません。KMS ドライバーを使っている場合、'''s2ram''' は直接マシンをサスペンドします。}}
 
* '''s2disk''' - ユーザー空間ソフトウェアサスペンド (µswsusp) のリファレンス実装。システムをサスペンドするのに必要な手順 (プロセスのフリーズやスワップ領域の準備など) をまとめて、イメージの読み書きを処理します。s2disk はイメージの圧縮や暗号化などの機能をサポートしており、他の機能 (例: 見栄えの良いプログレスバー, 外部ディスクへのイメージの保存, 復帰中にテトリスを遊ぶなど) も簡単に追加できます。
 
 
* '''s2both''' - バッテリー残量がないときは s2ram と s2disk の機能を組み合わせるのが大いに役立ちます。s2both は (s2disk のように) システムのスナップショットをスワップに書き出して、それから (s2ram のように) マシンを STR 状態にします。バッテリーの残量が十分ある場合は STR から高速に復帰でき、足りないときはディスクから復帰するため作業を喪失することがありません。
 
 
== インストール ==
 
 
uswsusp は [[AUR]] の {{AUR|uswsusp-git}} からインストールできます。
 
 
== 設定 ==
 
 
ディスクにサスペンドする前に {{ic|/etc/suspend.conf}} を編集してください。
 
 
* スワップパーティションを使う場合:
 
resume device = /dev/disk/by-label/swap
 
 
{{ic|/dev/disk/by-label/swap}} はスワップパーティションが含まれている適当なブロックデバイスに置き換えて下さい。
 
 
* [[スワップ#スワップファイル|スワップファイル]]を使う場合:
 
resume device = /dev/sdXN # the partition which contains swapfile
 
resume offset = 123456
 
 
123456 はスワップファイルのヘッダが存在する resume デバイスの先頭からのオフセットに置き換えて下さい。resume オフセットは以下のコマンドで確認できます:
 
 
# swap-offset your-swap-file
 
 
* {{ic|image size}} パラメータを使うことで s2disk によって作成されるシステムのスナップショットイメージの容量を制限することができます (任意)。設定された容量ではイメージを作成することができない場合でも、s2disk は制限を無視してサスペンドを行います。イメージ容量を 0 に設定した場合、イメージは可能な限り小さくなります。
 
 
* {{ic|shutdown method}} パラメータはマシンの電源を切れる状態になったときに実行する操作を指定します (任意)。"reboot" に設定するとマシンはすぐに再起動するようになります。"platform" に設定するとカーネルから利用できる特殊な電源管理の操作を使ってマシンはシャットダウンします。ハードウェアによっては復帰後に正しく再初期化するために必要だったり、システムの復帰が高速化されたりします。
 
 
* {{ic|compute checksum}} パラメータが 'y' に設定されている場合、s2disk と resume ツールは MD5 アルゴリズムを使ってイメージの整合性を確認します。
 
 
* {{ic|compress}} パラメータが 'y' に設定されている場合、s2disk と resume ツールは LZF 圧縮アルゴリズムを使ってイメージを圧縮・解凍します。
 
 
* {{ic|splash}} が 'y' に設定されている場合、s2disk や resume はスプラッシュシステムを使います。現在 splashy と fbsplash がサポートされています。{{Note|上記のパラメータを使うには uswsusp の {{ic|configure}} フラグを変える必要があります ({{ic|--enable-splashy}} と {{ic|--enable-fbsplash}})。}}
 
 
* {{ic|resume pause}} オプションはハイバネートから復帰した後に待機時間を挟み込み、ユーザーが統計情報を読めるようにします (読み書き速度やイメージ容量など)。
 
 
* {{ic|threads}} が有効になっている場合、s2disk はイメージの圧縮・暗号化・書き込みに複数のスレッドを使います。有効にすることで動作が高速になります。詳しくは [https://git.kernel.org/?p=linux/kernel/git/rafael/suspend-utils.git;a=blob;f=suspend.c;h=166a62f03ea9daaba271e7cebf94c76881d4266f;hb=HEAD suspend.c] のコメントを読んで下さい。
 
 
=== 暗号化のサポート ===
 
* パッケージに含まれている suspend-keygen ユーティリティでキーを生成してください
 
* {{Ic|/etc/suspend.conf}} にキーの名前を記述します:
 
encrypt = y
 
RSA key file = <path_to_keyfile>
 
 
=== initramfs の再作成 ===
 
{{Note|{{ic|/etc/suspend.conf}} を編集したら、必ず initramfs を再生成してください。再生成しなかった場合、Linux は起動時にイメージを認識できず、エラーメッセージが表示されるようになります。{{ic|uresume}} フックの起動後、libgcrypt のバージョンに関するメッセージの後に起動プロセスが止まるようになります。}}
 
{{ic|/etc/mkinitcpio.conf}} ファイルを編集して HOOKS エントリに "uresume" を追加してください:
 
HOOKS="base udev autodetect block '''uresume''' filesystems"
 
そして ramdisk を再作成してください:
 
# mkinitcpio -p linux
 
 
=== サンプル設定 ===
 
 
{{hc|/etc/suspend.conf|2=
 
snapshot device = /dev/snapshot
 
 
resume device = /dev/disk/by-label/swap
 
 
# image size is in bytes
 
image size = 1468006400
 
 
#suspend loglevel = 2
 
 
compute checksum = y
 
 
compress = y
 
 
#encrypt = y
 
 
#early writeout = y
 
 
#splash = y
 
 
# up to 60 (seconds)
 
#resume pause = 30
 
 
threads = y
 
}}
 
 
== 使用方法 ==
 
 
=== スタンドアロン ===
 
 
ディスクにサスペンドするには、次を実行:
 
 
# s2disk
 
 
RAM にサスペンドするには、まず次を実行:
 
 
# s2ram --test
 
 
あなたのマシンが動作確認済みのマシンデータベースに入っているか確認します。"Machine matched entry xyz" などと返ってきたら次を実行:
 
 
# s2ram
 
 
サスペンドできない場合 --force パラメータを使用したり、他のパラメータと組み合わせる必要があるかもしれません ({{ic|s2ram --help}} を参照)。
 
 
[[Pm-utils]] や hibernate-script などの s2disk を内部的に呼び出すユーザースペースツールを使用する必要がある場合もあります。詳しくは [[hibernate-script]] を見て下さい。
 
 
=== systemd を使う ===
 
 
{{ic|systemctl hibernate}} でシステムをハイバネートさせるには、{{ic|systemd-hibernate.service}} を[[systemd#ユニットファイルの編集|編集]]して以下を追加:
 
 
{{hc|1=/etc/systemd/system/systemd-hibernate-service.d/override.conf|2=
 
[Service]
 
ExecStart=
 
ExecStartPre=-/usr/bin/run-parts -v -a pre /usr/lib/systemd/system-sleep
 
ExecStart=/usr/bin/s2disk
 
ExecStartPost=-/usr/bin/run-parts -v --reverse -a post /usr/lib/systemd/system-sleep
 
}}
 
 
上記の設定をした後 {{ic|systemctl hibernate}} を実行するとハイバネートが行われます。uswsusp によるハイブリッドスリープを有効にしたい場合は上記の ''s2disk'' を ''s2both'' に置き換えて同じように {{ic|systemd-hybrid-sleep.service}} を編集してください。
 
 
== トラブルシューティング ==
 
 
=== マシンがホワイトリストに入っていない ===
 
 
{{ic|s2ram}} でホワイトリストのエントリとあなたのマシンが一致しない場合、あなたのマシンに関する様々な情報が出力されます ({{ic|s2ram -i}} で表示されるのと同じです)。その場合、{{ic|s2ram -f}} を使うことで {{ic|s2ram}} で強制的にマシンをサスペンドすることができます。
 
 
=== {{ic|s2ram -f}} が動作しない ===
 
 
{{Ic|s2ram -f}} が動作しない場合、{{Ic|s2ram}} によって提供されている別の手段を試してみて下さい。{{Ic|s2ram -h}} を実行すると利用可能なオプションのリストが表示されます:
 
{{hc|# s2ram -h|<nowiki>
 
Usage: s2ram [-nhi] [-fspmrav]
 
 
Options:
 
-h, --help: this text.
 
-n, --test: test if the machine is in the database.
 
returns 0 if known and supported
 
-i, --identify: prints a string that identifies the machine.
 
-f, --force: force suspending, even on unknown machines.
 
 
The following options are only available with -f/--force:
 
-s, --vbe_save: save VBE state before suspending and restore after resume.
 
-p, --vbe_post: VBE POST the graphics card after resume
 
-m, --vbe_mode: get VBE mode before suspend and set it after resume
 
-r, --radeontool: turn off the backlight on radeons before suspending.
 
-a, --acpi_sleep: set the acpi_sleep parameter before suspend
 
1=s3_bios, 2=s3_mode, 3=both
 
-v, --pci_save: save the PCI config space for the VGA card.
 
</nowiki>}}
 
 
以下の組み合わせを試してみて下さい:
 
s2ram -f -a 1
 
s2ram -f -a 2
 
s2ram -f -a 3
 
s2ram -f -p -m
 
s2ram -f -p -s
 
s2ram -f -m
 
s2ram -f -s
 
s2ram -f -p
 
s2ram -f -a 1 -m
 
s2ram -f -a 1 -s
 
 
上記の組み合わせがどれも上手く行かない場合、{{ic|-v}} スイッチを追加してもういちど試してみてください。
 
 
{{ic|-a}} オプションと vbetool オプション ({{ic|-p}}, {{ic|-m}}, {{ic|-s}}) は基本的にあまり意味がありません。
 
 
一部の組み合わせが機能する場合 (例: {{ic|s2ram -f -a 3}} と {{ic|s2ram -f -p -m}})、ユーザー空間の方法 ({{ic|-p}}, {{ic|-m}}, {{ic|-s}}) よりもカーネル内の方法 ({{ic|-a}}) を優先してください。
 
 
Verify all combinations in both cases when reporting success to the {{ic|s2ram}} developers:
 
* when issuing {{ic|s2ram}} from console
 
* when issuing {{ic|s2ram}} from X
 
 
=== オプションをどのように組み合わせても s2ram が動作しない ===
 
 
There is a trick which does not correspond to a command line option, because it requires additional operations from you. It is marked with NOFB in the whitelist and used for those laptops which suspend and resume properly only if no framebuffer is used. If you verify that no command line option of {{Ic|s2ram}} works, you can try disabling the framebuffer. To do this, you need to edit your bootloader configuration, remove any possible {{Ic|1=vga=<foo>}} values from the kernel line and reboot. This at least if you use the VESAFB framebuffer (as in the arch default kernel). If you use a different framebuffer driver, refer to the documentation of the driver to see how to disable it.
 
 
== 参照 ==
 
 
* [http://suspend.sourceforge.net/ Uswsusp ホームページ]
 
* ソースコードに含まれている [https://git.kernel.org/?p=linux/kernel/git/rafael/suspend-utils.git;a=blob;f=HOWTO;h=116cddaa76cbdec69eb8b1e87b7df8931d3a73da;hb=HEAD HOWTO ファイル]
 
* {{ic|/usr/share/doc/suspend/README}} Uswsusp ドキュメント
 
* {{ic|/usr/share/doc/suspend/README.s2ram-whitelist}} s2ram-whitelist README
 

2024年9月8日 (日) 17:37時点における最新版