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

Pacman/ヒントとテクニック

2023-10-28T11:00:20Z

Linuxmetel: LANG=C が必要なコマンドがあることの注意の追加

{{Lowercase title}}
[[Category:パッケージマネージャー]]
[[en:Pacman/Tips and tricks]]
[[es:Pacman (Español)/Tips and tricks]]
[[fa:Pacman tips]]
[[fr:Pacman/Trucs et Astuces]]
[[it:Pacman (Italiano)/Tips and tricks]]
[[pt:Pacman (Português)/Tips and tricks]]
[[ru:Pacman (Русский)/Tips and tricks]]
[[zh-hans:Pacman (简体中文)/Tips and tricks]]
{{Related articles start}}
{{Related|pacman}}
{{Related|ミラー}}
{{Related|パッケージの作成}}
{{Related articles end}}
以下のヒントや pacman 自体の柔軟性を広げる汎用的な手法については、[[Core Utilities]] や [[Bash]] を見てください。日本語環境において、このページのコマンドのいくつかは ''LANG=C'' を前に付ける必要があります。

== メンテナンス ==

{{Note|このセクションで使われている ''comm'' (''sort'' でソートして入力する必要があります) の代わりに、{{ic|grep -Fxf}} や {{ic|grep -Fxvf}} を使うこともできます。}}

[[システムメンテナンス]]も参照。

=== パッケージをリストアップ ===

==== With version ====

バグを報告したりインストールしたパッケージについて説明するときは、インストール済みのパッケージとそのバージョンのリストを貼り付けると便利です。

* 明示的にインストールしたパッケージを全てリストアップ: {{ic|pacman -Qe}}。
* ''group'' グループに含まれるパッケージを全てリストアップ: {{ic|pacman -Sq group}}。
* 依存パッケージではない、明示的にインストールしたネイティブのパッケージ (同期データベースに存在するパッケージ) を全てリストアップ: {{ic|pacman -Qent}}。
* 外部からインストールしたパッケージ (手動でダウンロード・インストールしたパッケージ) をリストアップ: {{ic|pacman -Qm}}。
* ネイティブなパッケージ (同期データベースからインストールしたパッケージ) をリストアップ: {{ic|pacman -Qn}}。
* 正規表現でパッケージをリストアップ: {{ic|pacman -Qs ''regex''}}。
* 正規表現でカスタム出力形式を使ってパッケージをリストアップ: {{ic|expac -s "%-30n %v" ''regex''}} ({{Pkg|expac}} が必要です)。

==== 容量でソート ====

インストールしたパッケージのリストを容量で並び替えたい場合 (
どのパッケージが最大かを把握するのは、ハードドライブの空き容量を増やしたいときに有用です。
各パッケージ単独の容量を取得するか、パッケージとその依存関係の容量を取得するかの二つのオプションがあります。

===== パッケージ単独 =====

次のコマンドで、インストールされたパッケージ全てとそれぞれの容量をリストアップします:
$ pacman -Qi | awk '/^Name/{name=$3} /^Installed Size/{print $4$5, name}' | sort -h

===== パッケージとその依存関係 =====

パッケージとその依存関係の合計容量を表示するのは、次の方法があります。
* {{Pkg|expac}} をインストールして {{ic|<nowiki>expac -H M '%m\t%n' | sort -h</nowiki>}} を実行。
* {{ic|-c}} オプションを付けて {{Pkg|pacgraph}} を実行。

複数のパッケージのダウンロード容量をリストアップするには ({{ic|''packages''}} を空にすると全てのパッケージの情報が出力されます):

$ expac -S -H M '%k\t%n' ''packages''

{{Pkg|base}} や {{Grp|base-devel}} に存在しない明示的にインストールしたパッケージの容量と説明をリストアップするには:

$ expac -H M "%011m\t%-20n\t%10d" $(comm -23 <(pacman -Qqen | sort) <(pacman -Qqg base base-devel | sort)) | sort -n

アップグレード対象のパッケージとそのダウンロード容量をリストアップするには:
$ pacman -Quq|xargs expac -S -H M '%k\t%n' | sort -sh

==== 日付を使う ====

{{Pkg|expac}} を使って最後にインストールした20のパッケージをリストアップするには、次のコマンドを実行:

$ expac --timefmt='%Y-%m-%d %T' '%l\t%n' | sort | tail -n 20

もしくはエポック秒を使って (1970-01-01 UTC):

$ expac --timefmt=%s '%l\t%n' | sort -n | tail -n 20

==== 指定したグループやリポジトリに存在しないパッケージ ====

{{Note|依存パッケージとしてインストールされたが、既にどのパッケージからも必要とされていないパッケージを確認したい場合は[[#使用していないパッケージの削除 (孤立したパッケージ)|使用していないパッケージの削除 (孤立したパッケージ)]] を参照。}}

{{Pkg|base}} や {{Grp|base-devel}} グループに存在しない明示的にインストールしたパッケージをリストアップ:

$ comm -23 <(pacman -Qeq | sort) <(pacman -Qgq base base-devel | sort)

{{Pkg|base}} や {{Grp|base-devel}} グループに存在せず、他のパッケージによって必要とされていないインストール済みパッケージをリストアップ:

$ comm -23 <(pacman -Qqt | sort) <(pacman -Sqg base base-devel | sort)

上記と同じで、説明を付けてリストアップ:

$ expac -HM '%-20n\t%10d' $(comm -23 <(pacman -Qqt | sort) <(pacman -Qqg base base-devel | sort))

指定したリポジトリ ''repo_name'' に存在しないインストール済みパッケージをリストアップ:

$ comm -23 <(pacman -Qtq | sort) <(pacman -Slq ''repo_name'' | sort)

''repo_name'' リポジトリに含まれているインストール済みパッケージをリストアップ:

$ comm -12 <(pacman -Qtq | sort) <(pacman -Slq ''repo_name'' | sort)

{{Pkg|base}} グループにはなく、Arch Linux ISO には含まれているパッケージをリストアップ:
$ comm -23 <(curl https://git.archlinux.org/archiso.git/tree/configs/releng/packages.x86_64) <(pacman -Qqg base | sort)

==== 開発版パッケージ ====

開発版や不安定版のパッケージを全てリストアップするには、次のコマンドを実行します:
$ pacman -Qq | grep -Ee '-(bzr|cvs|darcs|git|hg|svn)$'

==== パッケージの依存パッケージ ====

パッケージの依存パッケージの一覧を入手したい場合、最も簡単な方法は以下のコマンドの出力を見ることです:

$ pacman -Qi ''package''

自動化させるには、pacman の出力をパースするというエラーの発生しやすい方法を取るのではなく、{{Pkg|expac}} を使ってください:

$ expac -S '%D' ''package''

=== パッケージの閲覧 ===

インストールされているすべてのパッケージを、各パッケージのインスタントプレビューで参照するには:

$ pacman -Qq | fzf --preview 'pacman -Qil {}' --layout=reverse --bind 'enter:execute(pacman -Qil {} | less)'

これは [[fzf]] を使用して、右側にパッケージ情報が表示されたすべてのパッケージを一覧表示する2ペインビューを表示します。

パッケージのリストをフィルタリングするための文字を入力します。矢印キー(または{{ic|Ctrl-j}}/{{ic|Ctrl-k}})を使用してナビゲートします。{{ic|Enter}} を押して、''less'' の下にパッケージ情報を表示します。

fzf を使用して、同様の方法で ''pacman'' にすべてのパッケージ(インストールされているものとまだインストールされていないものの両方)を参照するには、次を使用します。

$ pacman -Slq | fzf --preview 'pacman -Si {}' --layout=reverse

ナビゲーションのキーバインディングは同じですが、{{ic|Enter}} は同じようには機能しません。

=== パッケージに含まれているファイルを容量を付けてリストアップ ===

特定のパッケージが異常な容量を消費していて、どのファイルが容量を食っているのか調べたいときに便利なコマンドです。

$ pacman -Qlq ''package'' | grep -v '/$' | xargs du -h | sort -h

=== どのパッケージにも所有されていないファイルを特定する ===

どのパッケージにも所有されていない謎のファイルが存在する場合 ([[Arch Linux の安定化#パッケージマネージャを使ってソフトウェアをインストールする|パッケージマネージャを使わずにソフトウェアをインストール]]した場合など)、ファイルを見つけ出して消去すると良いでしょう。以下の手順で見つけ出せます:

# 所有者を確認したいファイルのソート済みリストを作成: {{bc|<nowiki>$ find /etc /opt /usr | sort > all_files.txt</nowiki>}}
# pacman によって追跡されているファイルのソート済みリストを作成 (そしてディレクトリの末尾のスラッシュを削除): {{bc|<nowiki>$ pacman -Qlq | sed 's|/$||' | sort > owned_files.txt</nowiki>}}
# 後者のファイルには存在しない行を確認: {{bc|$ comm -23 all_files.txt owned_files.txt}}

どのパッケージにも含まれない重要なファイル (実行時に生成されるファイルやカスタム設定など) も存在するため、安全に消去できるファイルを選び出す方法としては不適切です。

{{Tip|{{Pkg|lostfiles}} スクリプトは上記と同じようなことを実行しますが、出力から偽陽性のファイルを取り除くための包括的なブラックリストを使用します。}}

=== パッケージによって作成された所有されていないファイルの追跡 ===

ほとんどのシステムは、次のようないくつかの [http://ftp.rpm.org/max-rpm/s1-rpm-inside-files-list-directives.html#S3-RPM-INSIDE-FLIST-GHOST-DIRECTIVEghost] ファイルをゆっくりと収集します。通常の操作の過程で状態ファイル、ログ、インデックスなどとして。

{{Pkg|pacutils}} の {{ic|pacreport}} を使用して、{{ic|/etc/pacreport.conf}} を介してこれらのファイルとそれらの関連付けを追跡できます({{man|1|pacreport|FILES}} を参照

例は次のようになります (簡略化):

{{hc|/etc/pacreport.conf|2=
[Options]
IgnoreUnowned = usr/share/applications/mimeinfo.cache

[PkgIgnoreUnowned]
alsa-utils = var/lib/alsa/asound.state
bluez = var/lib/bluetooth
ca-certificates = etc/ca-certificates/trust-source/*
dbus = var/lib/dbus/machine-id
glibc = etc/ld.so.cache
grub = boot/grub/*
linux = boot/initramfs-linux.img
pacman = var/lib/pacman/local
update-mime-database = usr/share/mime/magic
}}

次に、root ユーザーとして {{ic|pacreport --unowned-files}} を使用すると、関連するパッケージがインストールされなくなった場合(または新しいファイルが作成された場合)に、所有されていないファイルが一覧表示されます。

さらに、[https://github.com/CyberShadow/aconfmgr aconfmgr]({{AUR|aconfmgr-git}})を使用すると、スクリプトを使用して、変更されたファイルや孤立したファイルを追跡できます。

=== 使用していないパッケージの削除 (孤立したパッケージ) ===

孤立したパッケージとは、依存関係としてインストールされ、どのパッケージにも必要なくなったパッケージです。

これらは {{ic|pacman -Rs ''package''}} の代わりに {{ic|pacman -R ''package''}} を使ってパッケージをアンインストールしたり、[[makedepends]] としてパッケージをインストールしたり、パッケージが新しいバージョンで依存関係を削除したりすることで、時間とともにシステムに蓄積されます。

孤立したファイルとその設定ファイルを再帰的に削除するには:

# pacman -Qtdq | pacman -Rns -

孤立したパッケージが見つからなかった場合、出力は {{ic|error: argument '-' specified with empty stdin}} となります。これは {{ic|pacman -Rns}} に引数が渡されていないので予想されます。このエラーは {{Pkg|moreutils}} パッケージの {{man|1|ifne}} を2番目のコマンドの前に付けることで回避できます。

{{Note|引数 {{ic|-Qt}} は真の孤立したパッケージのみをリストします。他のパッケージによって ''オプションで'' 必要とされるパッケージを含めるには、{{ic|-t}} フラグを 2 回渡します (''すなわち''、{{ic|-Qtt}})}}

{{Tip|''pacman'' のポストトランザクション [[Pacman#Hooks|hook]] に {{ic|pacman -Qtd}} コマンドを追加すると、トランザクションがパッケージを取りこぼした時に通知されます。これはパッケージがリポジトリから削除された時に通知するのに便利です。削除されたパッケージは (明示的にインストールされていない限り) ローカルインストールでも孤立したパッケージになります。孤立したパッケージが見つからない時に "failed to execute command" エラーを避けるには、フックで {{ic|Exec}} に以下のコマンドを使います: {{ic|<nowiki>/usr/bin/bash -c "/usr/bin/pacman -Qtd || /usr/bin/echo '=> None found.'"</nowiki>}}、{{AUR|pacman-log-orphans-hook}} パッケージはそのようなフックをより冗長な命令で提供します。}}

=== より多くの不要なパッケージを検出する ===

場合によっては、上記の方法では、不要なパッケージをすべて検出することはできません。例えば、依存性のサイクル ("循環依存"とも呼ばれる)、過剰な依存性 (複数回満たされる)、明示的でないオプションなどです。

このようなパッケージを検出するには:

$ pacman -Qqd | pacman -Rsu --print -

リスト内のすべてのパッケージを一度に削除する場合は、{{ic|--print}} 引数を指定せずにコマンドを実行します。

=== 必須パッケージ以外の全てのパッケージを削除する ===

必須パッケージを除くすべてのパッケージを削除する必要がある場合、1つの方法は、必要ではないパッケージのインストール理由を依存関係として設定してから、不要な依存関係をすべて削除することです。

まず、''明示的にインストール'' されたすべてのパッケージについて、インストール理由を ''依存関係としてインストール'' に変更します。

# pacman -D --asdeps $(pacman -Qqe)

次に、インストール理由を、必須パッケージのみの ''明示的にインストール'' に変更します。これらのパッケージをターゲットにしないために、''削除したくない'' パッケージは次のようになります。

# pacman -D --asexplicit base linux linux-firmware

{{Note|
* 削除されないようにするために、上記のコマンドに追加のパッケージを追加することができます。完全に機能する基本システムに必要な他のパッケージの詳細については、 [[インストールガイド#必須パッケージのインストール]] を参照してください。
* これはブートローダのパッケージも削除対象とされます。システムはまだ起動できるはずですが、ブートパラメータはこれ無しでは変更できないかもしれません。
}}

最後に、[[Pacman ヒント#使用していないパッケージの削除 (孤立したパッケージ)]] の手順に従って、''依存関係'' でインストールされたすべてのパッケージを削除します。

=== 複数のパッケージの依存パッケージリストを取得 ===

依存パッケージはアルファベット順でソートされ、重複するパッケージは削除されます。

{{Note|ローカルにインストールしたパッケージのツリーを表示したいだけの場合、{{ic|pacman -Qi}} を使ってください。}}

$ pacman -Si ''packages'' | awk -F'[:<=>]' '/^Depends/ {print $2}' | xargs -n1 | sort -u

もしくは、{{Pkg|expac}} を使用して:

$ expac -l '\n' %E -S ''packages'' | sort -u

=== 変更されたバックアップファイルをリストアップ ===

システムの設定ファイルをバックアップしたい場合は {{ic|/etc/}} にある全てのファイルをコピーすれば良いですが、普通は変更を加えたファイルだけをバックアップすればそれで足ります。変更が加えられた[[Pacnew と Pacsave ファイル#パッケージのバックアップファイル|バックアップファイル]]は次のコマンドで閲覧できます:

# pacman -Qii | awk '/^MODIFIED/ {print $2}'

root で上記のコマンドを実行することで root からしか読み取れないファイル ({{ic|/etc/sudoers}} など) も出力に含まれるようになります。

{{Tip|バックアップファイルだけでなく、pacman が認識している全ての変更済みファイルをリストアップしたい場合は[[#パッケージから変更された全てのファイルをリストアップ|パッケージから変更された全てのファイルをリストアップ]]を見てください。}}

=== pacman データベースをバックアップ ===

次のコマンドでローカルの pacman データベースをバックアップできます:

$ tar -cjf pacman_database.tar.bz2 /var/lib/pacman/local

バックアップした pacman データベースファイルは USB スティックや外付けハードドライブ、CD-R などのオフラインメディアに保存してください。

{{ic|pacman_database.tar.bz2}} ファイルを {{ic|/}} ディレクトリに移動して以下のコマンドを実行することでデータベースを復元できます:

# tar -xjvf pacman_database.tar.bz2

{{Note|pacman データベースファイルが破損していて、バックアップファイルが存在しない場合でも、pacman データベースを再構築できる望みはあります。[[# pacman のローカルデータベースを復元する|pacman のローカルデータベースを復元する]]を見てください。}}

{{Tip|{{AUR|pakbak-git}} パッケージには上記の作業を自動的に行うスクリプトと [[systemd]] サービスが入っています。{{ic|/etc/pakbak.conf}} で設定が可能です。}}

=== 変更履歴を簡単に確認 ===

メンテナがパッケージを更新するとき、大抵の場合コミットにはコメントが付けられます。{{AUR|pacolog}} をインストールすることでコマンドラインからコミットメッセージを確認することができます。{{ic|pacolog <package>}} を実行すると、公式リポジトリや AUR のパッケージの最近のコミットメッセージを出力します。

== インストールとリカバリ ==

パッケージを取得・復活させる別の方法。

=== パッケージを CD/DVD や USB スティックからインストールする ===

パッケージやパッケージグループをダウンロードするには:

# cd ~/Packages
# pacman -Syw base base-devel grub-bios xorg gimp --cachedir .
# repo-add ./custom.db.tar.gz ./*

ダウンロードしたら "Packages" フォルダを CD/DVD に焼くか USB スティック、外部 HDD などにコピーしてください。

インストールするには:

'''1.''' メディアをマウントする:

# mkdir /mnt/repo
# mount /dev/sr0 /mnt/repo # CD/DVD の場合
# mount /dev/sdxY /mnt/repo # USB スティックの場合。

'''2.''' {{ic|pacman.conf}} を編集して他のリポジトリ (例: extra, core など) の''前に''リポジトリを追加してください。この手順は重要です。これで標準のリポジトリに優先して CD/DVD/USB のファイルがインストールされるようになります:

{{hc|# nano /etc/pacman.conf|2=
[custom]
SigLevel = PackageRequired
Server = file:///mnt/repo/Packages}}

'''3.''' 最後に、pacman データベースを同期して新しいリポジトリを使えるようにしてください:

# pacman -Syu

=== カスタムローカルリポジトリ ===

''pacman'' に含まれる ''repo-add'' スクリプトを使うことで、個人的なリポジトリのデータベースを生成することができます。詳しい使い方は {{ic|repo-add --help}} を実行して見て下さい。

パッケージデータベースは tar ファイルです (任意で圧縮できます)。有効な拡張子は、''.db'' か ''.files'' の後に、アーカイブ拡張子 ''.tar''、''.tar.gz''、''.tar.bz2''、''.tar.xz''、''.tar.zst''、''.tar.Z'' のうちどれかを付け加えたものになります。(''repo-add'' を使用する際に) このファイルが存在している必要はありませんが、親ディレクトリはすべて存在していなければなりません。

新しいパッケージをデータベースに追加する、あるいはデータベース内にすでにある古いバージョンのパッケージを置き換えるには、以下を実行してください:

$ repo-add ''/path/to/repo.db.tar.gz /path/to/package-1.0-1-x86_64.pkg.tar.zst''

''repo-add'' を使用する際は、データベースとパッケージが同一のディレクトリ内に存在している必要はありません。ただし、そのデータベースを ''pacman'' で使用する際は、データベースとパッケージが一緒に存在している必要があるので注意してください。また、リポジトリに含めるビルド済みパッケージをすべて1つのディレクトリに入れておけば、シェルのグロブ拡張を使って複数のパッケージを一度に追加/更新することができます:

$ repo-add ''/path/to/repo.db.tar.gz /path/to/*.pkg.tar.zst''

{{Warning|''repo-add'' は、コマンドラインで渡された順番でエントリをデータベースに追加します。同じパッケージの複数のバージョンが渡された場合、正しいバージョンが最後に追加されるよう注意しなければなりません。特に、シェルによって使用される辞書順はロケール依存であり、''pacman'' によって使用される {{man|8|vercmp}} の順序とは異なるので注意してください。}}

複数のアーキテクチャをサポートしようと考えている場合、エラーが起こらないように注意する必要があります。各アーキテクチャに独自のディレクトリツリーが存在している必要があります:

{{hc|$ tree ~/customrepo/ {{!}} sed "s/$(uname -m)/''arch''/g"|
/home/archie/customrepo/
└── ''arch''
├── customrepo.db -> customrepo.db.tar.xz
├── customrepo.db.tar.xz
├── customrepo.files -> customrepo.files.tar.xz
├── customrepo.files.tar.xz
└── personal-website-git-b99cce0-1-''arch''.pkg.tar.zst

1 directory, 5 files
}}

''repo-add'' 実行ファイルは、パッケージが適切であるかどうかをチェックします。パッケージが適切でない場合、以下のようなエラーメッセージが出力されます:

==> ERROR: '/home/archie/customrepo/''arch''/foo-''arch''.pkg.tar.zst' does not have a valid database archive extension.

''repo-remove'' はパッケージデータベースからパッケージを削除するために使用されます。パッケージの名前のみをコマンドラインで指定します。

$ repo-remove ''/path/to/repo.db.tar.gz pkgname''

ローカルリポジトリを作成できたら、リポジトリを {{ic|pacman.conf}} に追加してください。カスタムリポジトリの例は {{ic|pacman.conf}} 内にあります。リポジトリ名は、データベースのファイル名からファイル拡張子を除いたものになります。上記の例では、リポジトリ名は単に ''repo'' となります。リポジトリの場所を参照するには、{{ic|file://}} URL を使うか、{{ic|<nowiki>http://localhost/path/to/directory</nowiki>}} を使って HTTP 経由で行ってください。

もし良ければ、カスタムリポジトリを[[非公式ユーザーリポジトリ|非公式ユーザリポジトリのリスト]]に追加して、コミュニティがその恩恵を受けられるようにしましょう。

=== pacman のキャッシュをネットワークで共有する ===

LAN 上で複数の Arch マシンを使っている場合、パッケージを共有することでダウンロード回数を劇的に減らすことができます。使用しているアーキテクチャが異なるマシン (i686 と x86_64) でキャッシュを共有してはいけません。問題が発生します。

==== 読み取り専用キャッシュ ====

{{Note|1=pacman がサーバーから 3 つのパッケージをダウンロードできない場合、代わりに別のミラーが使用されます。https://bbs.archlinux.org/viewtopic.php?id=268066 を参照してください。}}

迅速な解決策を探している場合は、他のコンピューターが最初のミラーとして使用できる [https://gist.github.com/willurd/5720255 基本的な一時 Web サーバー] を実行するだけです。

まず最初に、提供するディレクトリで pacman データベースを利用できるようにします。

# ln -s /var/lib/pacman/sync/*.db /var/cache/pacman/pkg/

次に、このディレクトリの提供を開始します。たとえば、[[Python]] [https://docs.python.org/3/library/http.server.html#http-server-cli http.server] モジュールの場合:
$ python -m http.server -d /var/cache/pacman/pkg/

{{Tip|デフォルトでは、Python {{ic|http.server}} は任意のインターフェイスのポート {{ic|8000}} を待受します。別のポートを使用するか、特定のアドレスにのみバインドするには、パラメータと引数を追加するだけです:

$ python -m http.server -d /var/cache/pacman/pkg/ --bind 127.0.0.1 8080
}}

次に、各クライアントマシンで {{ic|/etc/pacman.d/mirrorlist}} を [[ヘルプ:読み方|追加, 追記, 作成, 編集|編集]] して、このサーバーを最上位のエントリとして追加します。

{{hc|/etc/pacman.d/mirrorlist|2=
Server = http://''server-ip'':''port''
...
}}

{{Warning|この階層は存在しないため、クエリは失敗します、他のエントリの場合と同様に、このカスタムサーバーに {{ic|/repos/$repo/os/$arch}} を追加しないでください。}}

よりスタンドアロンのソリューションをお探しの場合は、{{Pkg|darkhttpd}} が非常に最小限の Web サーバーを提供します。前の {{ic|python}} コマンドを次のように置き換えます。

$ sudo -u http darkhttpd /var/cache/pacman/pkg --no-server-id

便宜上、darkhttpd を ''systemd'' サービスとして実行することもできます。[[systemd#ユニットファイル]] を参照してください。

Rust で書かれた小規模な Web サーバーである {{Pkg|miniserve}} も使用できます。

$ miniserve /var/cache/pacman/pkg

次に、 miniserve が利用可能な最初の URL を使用して、上記のように {{ic|/etc/pacman.d/mirrorlist}} を編集します。

すでに他の目的で Web サーバーを実行している場合は、代わりにそれをローカルリポジトリサーバーとして再利用できます。たとえば、すでに [[nginx]] でサイトを提供している場合は、ポート 8080 で待受する ''nginx'' サーバーブロックを追加できます。

{{hc|/etc/nginx/nginx.conf|
server {
listen 8080;
root /var/cache/pacman/pkg;
server_name myarchrepo.localdomain;
try_files $uri $uri/;
}
}}

この変更を加えた後は、必ず {{ic|nginx.service}} の [[再起動]] を行ってください。

{{Tip|どの Web サーバーを使用する場合でも、ファイアウォール設定 (存在する場合) で、設定されたポートへの目的のトラフィックの到達が許可され、不要なトラフィックが許可されていないことを確認してください。[[セキュリティ#ネットワークとファイアウォール]]を参照してください。}}

==== 読み取り専用キャッシュのオーバーレイマウント ====

ローカルネットワーク上の1台のマシンを{{ic|/var/cache/pacman/pkg}} ディレクトリの [[Overlayfs|overlay mount]] 読み取り専用パッケージキャッシュとして使うことができます。このような設定は、このサーバーに他のマシンでも使われる最新のパッケージが適度に包括的にインストールされている場合に有利です。これは低帯域幅のアップストリーム接続の端にある多くのマシンを管理するのに便利です。

例として、このメソッドを使用するには:

# mkdir /tmp/remote_pkg /mnt/workdir_pkg /tmp/pacman_pkg
# sshfs ''remote_username''@''remote_pkgcache_addr'':/var/cache/pacman/pkg /tmp/remote_pkg -C
# mount -t overlay overlay -o lowerdir=/tmp/remote_pkg,upperdir=/var/cache/pacman/pkg,workdir=/mnt/workdir_pkg /tmp/pacman_pkg

{{Note|作業ディレクトリは、上位ディレクトリと同じマウントされたデバイス上の空のディレクトリである必要があります。[[Overlayfs#使用方法]] を参照してください。}}

{{Tip|1={{ic|/tmp/pacman_pkg}} オーバーレイディレクトリをリストすると、"Stale file handle" などのエラーが発生する場合は、オプション {{ic|1=-o redirect_dir=off -oindex=off}} を使用してオーバーレイマウントを試してください。}}

この後、オプション {{ic|--cachedir /tmp/pacman_pkg}} を使用して ''pacman'' を実行します。例:

# pacman -Syu --cachedir /tmp/pacman_pkg

==== 分散読み取り専用キャッシュ ====

パッケージキャッシュを提供するネットワーク上の他のコンピューターを自動的に検出するための Arch 固有のツールがあります。{{Pkg|pacredir}}、[[pacserve]]、{{AUR|pkgdistcache}}、または {{AUR|paclan}} を試してください。 pkgdistcache は、プレーンな UDP の代わりに Avahi を使用します。これは、WiFi とイーサネット間のブリッジではなくルーティングを行う特定のホームネットワークでより適切に機能する可能性があります。

歴史的には、[https://bbs.archlinux.org/viewtopic.php?id=64391 PkgD] と [https://github.com/toofishes/multipkg multipkg] がありましたが、現在はメンテナンスされていません。

==== 読み書き可能キャッシュ ====

{{Tip|[[pacserve]] を使うことで以下の方法をもっと簡単に実現できます。}}

複数のコンピュータ間でパッケージを共有するには、ネットワークベースのマウントプロトコルを使って {{ic|/var/cache/pacman/}} を共有します。このセクションでは shfs または sshfs を使ってパッケージキャッシュと関連するライブラリディレクトリを同一ローカルネットワーク上の複数のコンピュータで共有する方法を示します。ネットワークで共有されるキャッシュは、ファイルシステムの選択やその他の要因で、遅くなることがあります。

まず、ネットワークをサポートするファイルシステムをインストールしてください。例えば [[sshfs]], [[shfs]], ftpfs, [[Samba|smbfs]], [[NFS|nfs]] など。

{{Tip|
* sshfs や shfs を使う場合、[[SSH 鍵]]を読んで下さい。
* デフォルトでは、smbfs はファイル名にコロンを使えないので、クライアントは問題のあるパッケージをダウンロードしなおしてしまいます。クライアント側で {{ic|mapchars}} マウントオプションを使用することで解決します。}}

それから、サーバーの {{ic|/var/cache/pacman/pkg}} をクライアントマシンの {{ic|/var/cache/pacman/pkg}} にマウントすることでパッケージを共有できます。

==== rsync で同期 ====

ローカル環境でのもう1つのアプローチは、 [[rsync]] です。キャッシュするサーバーを選択し、 [[Rsync#rsync デーモン|rsync デーモン]] を有効にします。クライアントでは、rsync プロトコルを介してこの共有と双方向で同期します。コロンを含むファイル名は、 rsync プロトコルでは問題ありません。

クライアントのドラフトの例では、共有名に {{ic|uname-m}} と入力し使用することで、アーキテクチャに依存する同期が保証されます。
# rsync rsync://server/share_$(uname -m)/ /var/cache/pacman/pkg/ ...
# pacman ...
# paccache ...
# rsync /var/cache/pacman/pkg/ rsync://server/share_$(uname -m)/ ...

==== nginx を使用する動的なリバースプロキシキャッシュ ====

[[nginx]] を使って公式の上流ミラーへのリクエストをプロキシして結果をローカルディスクにキャッシュすることができます。その後、ファイルへのリクエストは全てローカルのキャッシュから供給されるようになり、大量のサーバーを更新するときでもインターネットのトラフィックを簡単に最小限に抑えることができます。

{{Warning|この方法には欠点があります。パッケージファイルの相対パスが同じミラーを使う必要があり同じパスを使うようにキャッシュを設定しなければなりません。この例では、相対パスが {{ic|/archlinux/$repo/os/$arch}} のミラーを使用して {{ic|mirrorlist}} のキャッシュの {{ic|Server}} 設定も同じ相対パスとします。}}

この例では、キャッシュサーバーを {{ic|<nowiki>http://cache.domain.local:8080/</nowiki>}} で実行してパッケージを {{ic|/srv/http/pacman-cache/}} に保存します。

キャッシュのディレクトリを作成して nginx からファイルが書き込めるようにパーティションを設定:

# mkdir /srv/http/pacman-cache
# chown http:http /srv/http/pacman-cache

次に、nginx を [https://gist.github.com/anonymous/97ec4148f643de925e433bed3dc7ee7d 動的キャッシュ] として設定 (コマンドについてはコメントを読んでください)。

最後に、他の Arch Linux サーバーを更新して {{ic|mirrorlist}} ファイルに以下の行を追加して新しいキャッシュを使うように設定:

{{hc|/etc/pacman.d/mirrorlist|<nowiki>
Server = http://cache.domain.local:8080/archlinux/$repo/os/$arch
...
</nowiki>}}

{{Note|時間と共にディレクトリは膨れ上がるため、古いパッケージを消去できるようにする必要があります。({{ic|pacman}} に含まれている) {{ic|paccache}} を使うことでお好きな基準で消去を自動化することが可能です。例えば、{{ic|find /srv/http/pacman-cache/ -type d -exec paccache -v -r -k 2 -c {} \;}} はキャッシュディレクトリに最新から1つ前のバージョンまでパッケージを保持します。}}

==== Pacoloco プロキシキャッシュサーバー ====

[https://github.com/anatol/pacoloco Pacoloco] は、 pacman リポジトリ用の使いやすいプロキシキャッシュサーバです。 {{AUR|pacoloco-git}} としてインストールできます。構成ファイルを開き、pacman ミラーを追加します。:

{{hc|/etc/pacoloco.yaml|<nowiki>
port: 9129
repos:
mycopy:
urls:
- http://mirror.lty.me/archlinux
- http://mirrors.kernel.org/archlinux
</nowiki>}}

{{ic|pacoloco.service}} を [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 再起動] すると、プロキシリポジトリが {{ic|http://<myserver>:9129/repo/mycopy}} で利用できるようになります。

==== Flexo プロキシキャッシュサーバー ====

[https://github.com/nroi/flexo Flexo] pacman リポジトリ用のさらに別のプロキシキャッシュサーバーです。 Flexo は AUR で利用できます:{{AUR|flexo-git}} インストールしたら、 systemd で {{ic|flexo.service}} サービスを [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 スタート]します。

Flexo はデフォルトではポート 7878 で動作します。 {{ic|/etc/pacman.d/mirrorlist}} の先頭に {{ic|1=Server = http://''myserver'':7878/$repo/os/$arch}} と入力し、pacman が Flexo を介してパッケージをダウンロードできるようにします。

==== 同期プログラムを使用して pacman パッケージキャッシュを同期する ====

[[Syncthing]] または [[Resilio Sync]] を使用して、''pacman'' キャッシュディレクトリ (つまり、{{ic|/var/cache/pacman/pkg}}) を同期します。

==== 不要なキャッシュパージの防止 ====

デフォルトでは、{{ic|pacman -Sc}} は、コマンドが発行されたマシンにインストールされていないパッケージに対応するパッケージ tarball をキャッシュから削除します。''pacman'' は、キャッシュを共有するすべてのマシンにどのようなパッケージがインストールされるかを予測できないため、削除すべきではないファイルを削除してしまうことになります。

''古い'' tarball のみが削除されるようにキャッシュをクリーンアップするには:

{{hc|/etc/pacman.conf|2=
[options]
CleanMethod = KeepCurrent
}}

=== ファイルシステムからパッケージを再作成 ===

ファイルシステムからパッケージを再作成するには、(pacman に含まれている) ''bacman'' を使います。システム上のファイルがそのまま使われるため、作成されるパッケージにはファイルへの変更も一緒に含まれてしまいます。再作成したパッケージの配布は非推奨です。[[ABS]] や [[Arch Rollback Machine]] を見てください。

{{Tip|''bacman'' は {{ic|makepkg.conf}} の {{ic|PACKAGER}}, {{ic|PKGDEST}}, {{ic|PKGEXT}} オプションを使用します。環境変数をエクスポートすることで圧縮ツールのオプションを指定することができます。例えば {{ic|1=XZ_OPT="-T 0"}} は ''xz'' の並列圧縮を有効化します。}}

別のツールとして {{AUR|fakepkg}} も存在します。並列化をサポートしており複数のパッケージを入力することができます。''bacman'' ではどちらもサポートされていません。

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

明示的にインストールされたすべてのパッケージのリストを保持しておくと、たとえばシステムをバックアップしたり、新しいシステムへのインストールを高速化したりするのに役立ちます:

$ pacman -Qqe > pkglist.txt

{{Note|
* オプション {{ic|-t}} を使用すると、他の明示的にインストールされたパッケージですでに必要なパッケージは言及されません。このリストから再インストールする場合、それらはインストールされますが、依存関係としてのみです。
* オプション {{ic|-n}} を使用すると、外部パッケージ([[AUR]] など)がリストから省略されます。
* {{ic|comm -13 <(pacman -Qqdt {{!}} sort) <(pacman -Qqdtt {{!}} sort) > optdeplist.txt}} を使用して、インストールされているオプションの依存関係のリストも作成します。 {{ic|--asdeps}} で再インストールします。
* {{ic|pacman -Qqem> Foreignpkglist.txt}} を使用して、明示的にインストールされた AUR およびその他の外部パッケージのリストを作成します。}}

明示的にインストールされたパッケージの最新リストを保持するために(たとえば、バージョン管理された {{ic|/etc/}} と組み合わせて)、[[Pacman#フック|hook]] を設定できます。例:

[Trigger]
Operation = Install
Operation = Remove
Type = Package
Target = *

[Action]
When = PostTransaction
Exec = /bin/sh -c '/usr/bin/pacman -Qqe > /etc/pkglist.txt'

=== リストからパッケージをインストールする ===

以前に保存されたパッケージのリストからパッケージをインストールするには、すでに最新のインストール済みパッケージを再インストールせずに、を実行します。:

# pacman -S --needed - < pkglist.txt

ただし、AURからのものやローカルにインストールされたものなどの外部パッケージがリストに含まれている可能性があります。外部パッケージをリストから除外するには、前のコマンドラインを次のように拡張できます:

# pacman -S --needed $(comm -12 <(pacman -Slq | sort) <(sort pkglist.txt))

最終的に、システムのインストール済みパッケージがリストと一致することを確認し、リストに記載されていないすべてのパッケージを削除します:

# pacman -Rsu $(comm -23 <(pacman -Qq | sort) <(sort pkglist.txt))

{{Tip|これらのタスクは自動化できます。例えば、これらを参照 {{AUR|bacpac}}, {{AUR|packup}}, {{AUR|pacmanity}}, {{AUR|pug}} }}

=== パッケージから変更された全てのファイルをリストアップ ===

ファイルが破損している可能性があるが (例: ソフトウェアあるいはハードウェアの故障)、ファイルが確実に破損しているとは言えない場合、パッケージのハッシュサムを比較すると良いでしょう。{{Pkg|pacutils}} で比較することができます:

# paccheck --md5sum --quiet

データベースのリカバリについては [[#pacman のローカルデータベースを復元する|pacman のローカルデータベースを復元する]]を参照。{{ic|mtree}} ファイルも[[#.pkg ファイルに含まれているファイルを閲覧する|該当するパッケージファイルから {{ic|.MTREE}} として抽出]]できます。

{{Note|悪意のある変更がされている可能性がある場合は気をつけてください。セキュリティ上、ライブメディアを使用したりハッシュサムを別のところから持ってくるなどの用心をすることを推奨します。}}

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

全てのネイティブのパッケージを再インストールするには、次を使って下さい:

# pacman -Qnq | pacman -S -

外部の (AUR) パッケージは別に再インストールする必要があります。外部のパッケージは {{ic|pacman -Qmq}} で一覧できます。

デフォルトで Pacman はインストールの理由(明示的にインストールしたか、依存でインストールしたか)を維持します。

=== pacman のローカルデータベースを復元する ===

[[pacman/ローカルデータベースの復元]]を見てください。

=== 既存のインストールから USB キーを復元する ===

USB キーに Arch をインストールしていて壊してしまった場合 (例: ファイルの書き込み中に取り出してしまった場合など)、全てのパッケージを再インストールして元に戻せる可能性があります (USB キーが {{ic|/newarch}} にマウントされている場合):

# pacman -S $(pacman -Qq --dbpath /newarch/var/lib/pacman) --root /newarch --dbpath /newarch/var/lib/pacman

=== .pkg ファイルに含まれているファイルを閲覧する ===

例えば、{{Pkg|systemd}} パッケージに含まれている {{ic|/etc/systemd/logind.conf}} の中身をみたい場合:

$ tar -xOf /var/cache/pacman/pkg/systemd-204-3-x86_64.pkg.tar.xz etc/systemd/logind.conf

もしくは {{pkg|vim}} を使って圧縮ファイルを閲覧することもできます:

$ vim /var/cache/pacman/pkg/systemd-204-3-x86_64.pkg.tar.xz

=== 古いパッケージのライブラリを使っているアプリケーションを探す ===

パッケージをインストールしても、(デーモンやサーバーなど) ずっと実行し続けているプログラムが古いパッケージのライブラリのコードを使用している可能性があります。古いライブラリにセキュリティのバグが存在する場合、プログラムを実行し続けるのは得策ではありません。

以下のコマンドで古いパッケージのコードを使用しているプログラムを全て見つけることができます:

# lsof +c 0 | grep -w DEL | awk '1 { print $1 ": " $NF }' | sort -u

実行中のプログラムの名前と削除あるいは置換された古いライブラリが出力されます。

=== 必要な言語のコンテンツのみをインストールする ===

多くのパッケージは、ドキュメントと翻訳をいくつかの言語でインストールしようとします。一部のプログラムは、 {{AUR|localepurge}} などの不要なファイルを削除するように設計されています。これは、パッケージがインストールされた後に実行され、不要なロケールファイルを削除します。より直接的なアプローチは、 {{ic|pacman.conf}} の {{ic|NoExtract}} ディレクティブを介して提供され、これらのファイルがインストールされないようにします。

{{Warning|1=一部のユーザーは、[https://bbs.archlinux.org/viewtopic.php?id=250846 Xorg] の下でも、ロケールを削除すると [[Special:Permalink/460285#Dangerous NoExtract example|意図しない結果]] が発生したと指摘しました。}}

次の例では、英語 (US) ファイルをインストールするか、または何もインストールしません。:

{{hc|/etc/pacman.conf|2=
NoExtract = usr/share/help/* !usr/share/help/C/*
NoExtract = usr/share/gtk-doc/html/*
NoExtract = usr/share/locale/* usr/share/X11/locale/*/* usr/share/i18n/locales/* opt/google/chrome/locales/* !usr/share/X11/locale/C/*
NoExtract = !*locale*/en*/* !usr/share/*locale*/locale.*
NoExtract = !usr/share/*locales/en_?? !usr/share/*locales/i18n* !usr/share/*locales/iso*
NoExtract = usr/share/i18n/charmaps/* !usr/share/i18n/charmaps/UTF-8.gz
NoExtract = !usr/share/*locales/trans*
NoExtract = usr/share/man/* !usr/share/man/man*
NoExtract = usr/share/vim/vim*/lang/*
NoExtract = usr/lib/libreoffice/help/en-US/*
NoExtract = usr/share/kbd/locale/*
NoExtract = usr/share/*/translations/*.qm usr/share/qt/translations/*.pak !*/en-US.pak # Qt apps
NoExtract = usr/share/*/locales/*.pak opt/*/locales/*.pak usr/lib/*/locales/*.pak !*/en-US.pak # Electron apps
NoExtract = opt/onlyoffice/desktopeditors/dictionaries/* !opt/onlyoffice/desktopeditors/dictionaries/en_US/*
NoExtract = usr/share/ibus/dicts/emoji-*.dict !usr/share/ibus/dicts/emoji-en.dict
}}

=== 接続状況が悪い場合でもパッケージをインストールする ===

悪い接続状況 (携帯電話を使用する電車など) からパッケージをインストールしようとする場合は、{{ic|--disable-download-timeout}} オプションを使用して、次のようなエラーが発生する可能性を減らします。

error: failed retrieving file [...] Operation too slow. Less than 1 bytes/sec transferred the last 10 seconds

もしくは、

error: failed retrieving file [...] Operation timed out after 10014 milliseconds with 0 out of 0 bytes received

== パフォーマンス ==

{{Out of date|このページは、pacman が並列ダウンロードをネイティブにサポートする前に書かれました。v6 以降、複数のパッケージを同時にダウンロードするオプションは以下だけではないことを言及すべきです。}}

=== ダウンロード速度を向上させる ===

{{Note|ダウンロード速度が極端に遅い場合、使っている[[ミラー]]が ftp.archlinux.org ではないことを確認してください。[https://www.archlinux.org/news/302/ 2007年の3月からこのサーバーには速度制限がかかっています]。}}

パッケージをダウンロードするとき pacman は {{ic|/etc/pacman.d/mirrorlist}} に書かれている順番通りにミラーを使用します。リストの一番上のミラーがデフォルトで使用されますが、それが最速のミラーだとは限りません。一番高速なミラーを選択する方法は[[ミラー]]を見てください。

Pacman に初めから入っているファイルダウンローダの代わりに、他のアプリケーションを使ってパッケージをダウンロードすることで Pacman のパッケージダウンロード速度を上げることができます。

どんな場合でも、変更を行う前に最新の Pacman を使っていることを確認してください:

# pacman -Syu

==== Powerpill ====

Powerpill は Pacman の完全なラッパーで並行・分割ダウンロードを使うことによってダウンロード処理を高速化します。通常の Pacman は一度にひとつのパッケージしかダウンロードしないので、ダウンロードが完了するまで次のダウンロードが始まりません。Powerpill は異なるアプローチを取ります: 同時に可能な限り多くのパッケージをダウンロードしようとします。

[[Powerpill|Powerpill の wiki ページ]]に基本的な設定・使用方法と、パッケージと上流のリンクがあります。

==== wget ====

pacman に初めから入っている機能よりもパワフルなプロキシ設定が必要な場合、wget はとても使い勝手がよいです。

{{ic|wget}} を使うには、まず {{ic|pacman -S wget}} で wget をインストールして、それから {{ic|/etc/pacman.conf}} を編集して次の行を {{ic|[options]}} セクションでアンコメントしてください:

XferCommand = /usr/bin/wget -c -q --show-progress --passive-ftp -O %o %u

{{ic|/etc/pacman.conf}} に {{ic|wget}} パラメータを記述する代わりに、{{ic|wget}} の設定ファイルを直接修正することも可能です (システム全体のファイルは {{ic|/etc/wgetrc}}、ユーザー別のファイルは {{ic|$HOME/.wgetrc}})。

==== aria2 ====

[[aria2]] はレジューム機能と分割 HTTP/HTTPS/FTP ダウンロードをサポートしている軽量なダウンロードユーティリティです。[http://aria2.sourceforge.net/ aria2] を使えば同時に複数の HTTP/HTTPS/FTP 接続を Arch ミラーにすることができ、ファイル・パッケージの取得の際のダウンロード速度が上昇します。

{{Note|Pacman の XferCommand で aria2c を使っても複数パッケージの同時ダウンロードは行われません。Pacman はひとつのパッケージごとに XferCommand を呼び出し、それが完了してから次を呼び出すからです。同時に複数のパッケージをダウンロードするには、上の [[#Powerpill|powerpill]] のセクションを見て下さい。}}

{{Pkg|aria2}} をインストールして {{ic|/etc/pacman.conf}} を編集し、以下の行を {{ic|[options]}} セクションに追加してください:

XferCommand = /usr/bin/aria2c --allow-overwrite=true --continue=true --file-allocation=none --log-level=error --max-tries=2 --max-connection-per-server=2 --max-file-not-found=5 --min-split-size=5M --no-conf --remote-time=true --summary-interval=60 --timeout=5 --dir=/ --out %o %u

{{Tip|1=設定を簡単にして他の設定オプションを追加する [https://bbs.archlinux.org/viewtopic.php?pid=1491879#p1491879 aria2 を pacman で使用する別の設定] も存在します。}}

aria2c で使用できるオプションについては {{ic|man aria2c}} の [http://aria2.sourceforge.net/manual/en/html/aria2c.html#options OPTIONS] を見てください。

* {{ic|-d, --dir}}: [[pacman]] によって指定されるダウンロードしたファイルを保存するディレクトリ。
* {{ic|-o, --out}}: ダウンロードしたファイルの出力ファイル名。
* {{ic|%o}}: pacman によって指定されるローカルのファイル名を表す変数。
*{{ic|%u}}: pacman によって指定されるダウンロード URL を表す変数。

==== 他のアプリケーション ====

Pacman で利用できるダウンロードアプリケーションは他にもあります:

* {{ic|snarf}}: {{ic|1=XferCommand = /usr/bin/snarf -N %u}}
* {{ic|lftp}}: {{ic|1=XferCommand = /usr/bin/lftp -c pget %u}}
* {{ic|axel}}: {{ic|1=XferCommand = /usr/bin/axel -n 2 -v -a -o %o %u}}
* {{ic|hget}}: {{ic|1=XferCommand = /usr/bin/hget %u -n 2 -skip-tls false}} (詳細については [https://github.com/huydx/hget Githubプロジェクトページのドキュメントを読んで下さい])
* {{ic|saldl}}: {{ic|1=XferCommand = /usr/bin/saldl -c6 -l4 -s2m -o %o %u}} (詳細については [https://github.com/huydx/hget Githubプロジェクトページのドキュメントを読んで下さい])

== ユーティリティ ==
* {{App|Arch-Update|Gnome-Shell のアップデートインジケータ。|https://github.com/RaphaelRochet/arch-update|{{AUR|gnome-shell-extension-arch-update}}}}
* {{App|Lostfiles|孤立したファイルを検知するスクリプト。|https://github.com/graysky2/lostfiles|{{Pkg|lostfiles}}}}
* {{App|[[Arch Linux の安定化#pacmatic の使用|Pacmatic]]|アップグレードの前に Arch ニュースをチェックして、設定ファイルの変更を警告する pacman ラッパ。|http://kmkeen.com/pacmatic|{{Pkg|pacmatic}}}}
* {{App|pacutils|libalpm ベースのプログラムのヘルパーライブラリ。|https://github.com/andrewgregory/pacutils|{{AUR|pacutils-git}}}}
* {{App|[[pkgfile]]|あるファイルを使っているパッケージが何かを見つけるツール。|https://github.com/falconindy/pkgfile|{{Pkg|pkgfile}}}}
* {{App|[[pkgtools]]|Arch Linux パッケージ用のスクリプトコレクション。|https://github.com/Daenyth/pkgtools|{{AUR|pkgtools}}}}
* {{App|[[Powerpill]]|[[aria2]] や [[Reflector]] を通じて並列分割ダウンロードを行い pacman のダウンロード処理を高速化。|https://xyne.archlinux.ca/projects/powerpill/|{{AUR|powerpill}}}}
* {{App|repoctl|ローカルリポジトリの管理を補助するツール。|https://github.com/cassava/repoctl|{{AUR|repoctl}}}}
* {{App|repose|Arch Linux リポジトリ作成ツール。|https://github.com/vodik/repose|{{Pkg|repose}}}}
* {{App|[[Snapper#pacman のトランザクションをスナップショットで記録|snap-pac]]|openSUSE の YaST のように pacman で自動的に snapper のスナップショットを作成するツール。|https://github.com/wesbarnett/snap-pac|{{Pkg|snap-pac}}}}
* {{App|vrms-arch|仮想 Richard M. Stallman がインストールされた不自由なパッケージを報告します。|https://github.com/orospakr/vrms-arch|{{AUR|vrms-arch}}}}

=== グラフィカルフロントエンド ===

{{Warning|PackageKit は既定でシステムのパーミッションを {{ic|wheel}} グループに開放するので、一般的な用途ではおすすめできません。{{Bug|50459}} および {{Bug|57943}} を参照してください。}}

* {{App|Apper|PackageKit を使用し C++ で書かれた Qt 5 アプリケーションパッケージマネージャ。[https://www.freedesktop.org/wiki/Distributions/AppStream/ AppStream metadata] をサポート。|https://userbase.kde.org/Apper|{{Pkg|apper}}}}
* {{App|Discover|KDE のパッケージ管理ツールのコレクション。PackageKit を使用。[https://www.freedesktop.org/wiki/Distributions/AppStream/ AppStream metadata]、[[Flatpak]] および [[Fwupd]] をサポート。|https://userbase.kde.org/Discover|{{Pkg|discover}}}}
* {{App|GNOME packagekit|GTK ベースのパッケージ管理ツール。|https://www.freedesktop.org/software/PackageKit/|{{Pkg|gnome-packagekit}}}}
* {{App|GNOME Software|Gnome ソフトウェアアプリ (GNOME の精選ソフトウェアコレクション)。|https://wiki.gnome.org/Apps/Software|{{pkg|gnome-software}}}}
* {{App|pcurses|curses フロントエンドのパッケージ管理ツール。|https://github.com/schuay/pcurses|{{Pkg|pcurses}}}}
* {{App|tkPacman|Tcl/Tk と X11 にしか依存せず、CLI の ''pacman'' を使ってパッケージデータベースを操作できるソフトウェア。|https://sourceforge.net/projects/tkpacman|{{AUR|tkpacman}}}}

スクリーンキャプチャ

2023-10-11T17:34:10Z

Linuxmetel: /* スクリーンショットソフトウェア */ shutter が AUR から公式リポジトリに移っているようなので修正

[[Category:システム管理]]
[[Category:マルチメディア]]
[[cs:Taking a screenshot]]
[[en:Taking a screenshot]]
[[es:Taking a screenshot]]
[[fr:Capture d'écran]]
[[ru:Taking a screenshot]]
[[zh-hans:Taking a screenshot]]
{{Related articles start}}
{{Related|キーボードショートカット#カスタマイズ}}
{{Related articles end}}
この記事では、[[Wikipedia:ja:スクリーンショット|スクリーンショット]]と[[Wikipedia:ja:スクリーンキャスト|スクリーンキャスト]]のソフトウェアを一覧にして解説しています。

== スクリーンショットソフトウェア ==

=== 専用のソフトウェア ===

* {{App|CoreShot|X11 用のシンプルで軽量なスクリーンキャプチャユーティリティ。C-Suite |https://cubocore.org/|{{AUR|coreshot}}}}
* {{App|Deepin Screenshot|とても使いやすいスクリーンショットツール。機能: スクリーンショットツールを発動するホットキー、選択した領域のスクリーンショットの取得、スクリーンショットに文章や線画を簡単に追加。Python/Qt5 ベース。|https://www.deepin.org/|{{Pkg|deepin-screenshot}}}}
* {{App|Escrotum|pygtk を使用して画面をキャプチャ。scrot の影響を受けています。|https://github.com/Roger/escrotum|{{AUR|escrotum-git}}}}
* {{App|Flameshot|インタラクティブにスクリーンショットを取得できる Qt5 ベースのソフトウェア。取得したいエリアを選択して様々なツールで落書きしたりカスタマイズする機能があります。|https://github.com/lupoDharkael/flameshot|{{Pkg|flameshot}}}}
* {{App|gnome-screenshot|dconf, gtk3, libcanberra にしか依存しないため GNOME 以外でも使えます。|http://gnome.org|{{Pkg|gnome-screenshot}}}}
* {{App|gscreenshot|シンプルな GTK スクリーンショットユーティリティ。遅延時間を設定したり範囲選択・クリップボードにコピーする機能があります。|https://github.com/thenaterhood/gscreenshot|{{AUR|gscreenshot}}}}
* {{App|imgur-screenshot|スクリーンショットを取得して [http://imgur.com imgur] にアップロードするツール。|https://github.com/jomo/imgur-screenshot|{{AUR|imgur-screenshot-git}}}}
* {{App|KShare|ShareX の影響を受けているクロスプラットフォームのユーティリティ。Qt で書かれています。|https://kshare.arsenarsen.com|{{AUR|kshare}}}}
* {{App|Lightscreen|退屈なスクリーンショットの保存とカタログ化を自動化するシンプルなツール。表には現れないバックグラウンドプロセスとして動作し、(複数の) ホットキーで呼び出してスクリーンショットファイルをユーザーの設定にあわせてディスクに保存する。|http://lightscreen.com.ar|{{AUR|lightscreen}}}}
* {{App|maim|スクリーンショットを取得するシンプルなコマンドラインユーティリティ。scrot を置き換えるものとして様々な点で scrot よりも優れています。|https://github.com/naelstrof/maim|{{Pkg|maim}}}}
* {{App|screencloud|画面全体のスクリーンショットや領域を選択して撮影し、[http://imgur.com imgur]+auth にスクリーンショットをアップロードできるツール。プラグインとシステムトレイが付属。|http://screencloud.net/|{{AUR|screencloud}}}}
* {{App|screengrab|スクリーンショットを手軽に取得するためのクロスプラットフォームのアプリケーション (Qt)。|http://screengrab.doomer.org/|{{Pkg|screengrab}}}}
* {{App|[[Wikipedia:Scrot|Scrot]]|X 向けのシンプルなコマンドラインスクリーンショットユーティリティ。|http://freecode.com/projects/scrot|{{Pkg|scrot}}}}
* {{App|Shutter|リッチなスクリーンショット・編集プログラム。|http://shutter-project.org/|{{Pkg|shutter}}}}
* {{App|Spectacle|スクリーンショットを撮るための [[KDE]] のアプリケーション。デスクトップ全体、単一のウィンドウ、ウィンドウの一部、四角形またはフリーハンドで指定した領域の画面をキャプチャすることができます。{{Grp|kdegraphics}}{{Broken package link|パッケージが存在しません}} に含まれています。|https://github.com/KDE/spectacle/|{{Pkg|spectacle}}}}
* {{App|Xfce4 Screenshooter|画面全体、アクティブウィンドウ、または選択領域のキャプチャを行えます。スクリーンショットを撮るまでの待機時間とスクリーンショットを撮った後の動作を設定できます: PNG ファイルに保存、クリップボードにコピー、別のアプリケーションで開く、無料の画像ホスティングサービスである Imgur や ZimageZ にアップロード。{{Grp|xfce4-goodies}} に含まれています。|https://goodies.xfce.org/projects/applications/xfce4-screenshooter|{{Pkg|xfce4-screenshooter}}}}
* {{App|xwd|X Window System イメージダンプユーティリティ。|http://xorg.freedesktop.org/|{{Pkg|xorg-xwd}}}}

==== xwd ====

{{man|1|xwd}} is provided by {{Pkg|xorg-xwd}}.

ルートウィンドウのスクリーンショットを撮るには:

$ xwd -root -out screenshot.xwd

{{Tip|スクリーンショットを撮る前に遅延を取得するには、{{ic|sleep}} コマンドを使用します。例: {{ic|sleep 5; xwd ...}}}}

==== scrot ====

{{Pkg|scrot}} を使用すると、CLI からスクリーンショットを取得できるようになり、ユーザー定義可能な遅延時間などの機能が提供されます。特に指示がない限り、ファイルは現在の作業ディレクトリに保存されます。

$ scrot -t 20 -d 5

上記のコマンドは、Web 投稿用にサムネイル (元の 20%) とともに日付付きの ''.png'' ファイルを保存します。この場合、キャプチャする前に 5 秒の遅延を発生させます。

ファイルに保存するときに、標準の日付と時刻の書式設定を使用することもできます。例えば、

$ scrot ~/screenshots/%Y-%m-%d-%T-screenshot.png

スクリーンショットを現在の年、月、日、時、分、秒を含むファイル名でホームディレクトリ内の "screenshots" というフォルダーに保存します。

詳細については、{{man|1|scrot}} を参照してください。

{{Note|一部のウィンドウマネージャー ({{AUR|dwm}}、{{Pkg|xmonad}}、およびおそらくその他) では、ウィンドウマネージャーのキーボードショートカット経由で実行すると、{{ic|scrot -s}} が正しく動作しませんが、scrot の呼び出しの前に短い一時停止を追加することで、{{ic|sleep 0.2; scrot -s}} 回避できます。}}

==== escrotum ====

{{AUR|escrotum-git}} scrot からインスピレーションを得た、PyGTK を使用した画面キャプチャ

ウィンドウを更新して選択モードを使用すると scrot に不具合が生じるため作成されました。

コマンドラインインターフェイスは scrot とほぼ同じなので、代替として使用できます。

==== maim ====

{{Pkg|maim}} は、改善された scrot であることを目指しています。

全画面をファイルに保存します。

$ maim ''filename''

選択を求めてからファイルに保存します。

$ maim --select ''filename''

{{Pkg|xdotool}} がインストールされていると仮定して、アクティブなウィンドウをファイルに保存します。

$ maim --window $(xdotool getactivewindow) ''filename''

{{Pkg|xclip}} がインストールされていると仮定して、選択を求め、カーソルを使用せずに保存し、クリップボードに保存します。

$ maim -s | xclip -selection clipboard -t image/png -i

=== デスクトップ環境による方法 ===

==== Spectacle ====

[[KDE]] を使っている場合、{{ic|Spectacle}} を使用すると良いでしょう。{{ic|Prnt Scr}} で使うことができます。

Spectacle は {{Pkg|spectacle}} に入っています。

==== Xfce Screenshooter ====

[[Xfce]] を使っている場合 {{Pkg|xfce4-screenshooter}} をインストールしてキーボードバインディングを追加することができます:

''Xfce Menu > Settings > Keyboard > Application Shortcuts''

Screenshot プロンプトをスキップしたい場合は、オプションのターミナルに {{ic|$ xfce4-screenshooter -h}} と入力してください。

==== GNOME ====

[[GNOME]] ユーザーは {{ic|Prnt Scr}} を押すか ''Apps > Accessories > Take Screenshot'' でスクリーンショットが取れます。{{Pkg|gnome-screenshot}} をインストールする必要があります。

==== Cinnamon ====

[[Cinnamon]] はデフォルトでスクリーンショットユーティリティがインストールされません。{{Pkg|gnome-screenshot}} をインストールするとスクリーンショットが有効になり、''Menu > Accessories > Screenshot'' または {{ic|Prnt Scr}} を押すことで撮影できるようになります。

==== 他のデスクトップ環境やウィンドウマネージャ ====

[[LXDE]] などのデスクトップ環境や [[Openbox]] や [[Compiz]] などのウィンドウマネージャの場合、上述のコマンドをホットキーに追加してスクリーンショットを撮影することができます。例えば:
$ import -window root ~/Pictures/$(date '+%Y%m%d-%H%M%S').png
上のコマンドを {{ic|Prnt Scr}} キーに追加すれば Compiz でスクリーンショットを取得して Pictures フォルダに日付を付けて保存できます。Openbox の {{ic|rc.xml}} ファイルではコンマを使えないので、Openbox でこのコマンドを {{ic|Prnt Scr}} キーに指定するには、{{ic|rc.xml}} ファイルのキーボードセクションに以下を追加する必要があります:

{{hc|rc.xml|<nowiki>

<keybind key="Print">
<action name="Execute">
<command>sh -c "import -window root ~/Pictures/$(date '+%Y%m%d-%H%M%S').png"</command>
</action>
</keybind>
</nowiki>}}

上記の {{ic|Print}} が動作しない場合、[[特別なキーボードキー]]をみて、別の''キーシム''や''キーコード''を使って下さい。
[[LXDE]] などのデスクトップ環境や [[Openbox]] や [[Compiz]] などのウィンドウマネージャの場合、上述のコマンドをホットキーに追加してスクリーンショットを撮影することができます。例えば:
$ import -window root ~/Pictures/$(date '+%Y%m%d-%H%M%S').png
上のコマンドを {{ic|Prnt Scr}} キーに追加すれば Compiz でスクリーンショットを取得して Pictures フォルダに日付を付けて保存できます。Openbox の {{ic|rc.xml}} ファイルではコンマを使えないので、Openbox でこのコマンドを {{ic|Prnt Scr}} キーに指定するには、{{ic|rc.xml}} ファイルのキーボードセクションに以下を追加する必要があります:

{{hc|rc.xml|<nowiki>

<keybind key="Print">
<action name="Execute">
<command>sh -c "import -window root ~/Pictures/$(date '+%Y%m%d-%H%M%S').png"</command>
</action>
</keybind>
</nowiki>}}

上記の {{ic|Print}} が動作しない場合、[[特別なキーボードキー]]をみて、別の''キーシム''や''キーコード''を使って下さい。

=== スクリーンショットユーティリティが含まれているパッケージ ===

==== ImageMagick/GraphicsMagick ====

See [[ImageMagick#Screenshot taking]].

==== GIMP ====

GIMP を使ってスクリーンショットを取得することもできます (''File > Create > Screenshot''...)。

==== imlib2 ====

{{Pkg|imlib2}} にはスクリーンショットを取得するためのバイナリ {{ic|imlib2_grab}} が含まれています。フルスクリーンのスクリーンショットを取得するには、次を入力:

$ imlib2_grab screenshot.png

==== FFmpeg ====

[[FFmpeg#スクリーンキャプチャ]]を参照。

== 一般的な方法 ==

=== ImageMagick/GraphicsMagick ===

{{ic|import}} コマンドを使うことで現在のシステムのスクリーンショットを簡単に取得できます:
$ import -window root screenshot.jpg

{{ic|import}} は {{Pkg|imagemagick}} パッケージに入っています。

{{ic|-window}} オプションを付けずに {{ic|import}} を実行するとウィンドウや任意の領域をインタラクティブに選択することが可能です。

{{Note|'''graphicsmagick''' を使いたい場合は、"gm" を前に付けて下さい、例: {{ic|$ gm import -window root screenshot.jpg}}。}}

==== 複数の X 画面のスクリーンショット ====

twinview または dualhead で使っている場合、2回スクリーンショットを取得して {{Ic|imagemagick}} を使って貼り付けます:
{{bc|
import -window root -display :0.0 -screen /tmp/0.png
import -window root -display :0.1 -screen /tmp/1.png
convert +append /tmp/0.png /tmp/1.png screenshot.png
rm /tmp/{0,1}.png
}}

==== Xinerama ヘッドのスクリーンショット ====

Xinerama による multi-head セットアップでは仮想スクリーンが一つしかありません。物理的なスクリーンの高さに違いがあると、スクリーンショットにデッドスペースが出来てしまいます。こういう場合、それぞれの物理的なスクリーンごとにスクリーンショットを取得すると良いでしょう。Xinerama の情報が X サーバーから取り出せていれば、以下のスクリプトが動作します:
{{bc|<nowiki>
#!/bin/sh
xdpyinfo -ext XINERAMA | sed '/^ head #/!d;s///' |
while IFS=' :x@,' read i w h x y; do
import -window root -crop ${w}x$h+$x+$y head_$i.png
done
</nowiki>}}

==== アクティブなウィンドウ/フォーカスしたウィンドウのスクリーンショット ====

以下のスクリプトは現在フォーカスされているウィンドウのスクリーンショットを取得します。EWMH/NetWM 準拠の X ウィンドウマネージャで動作します。スクリーンショットを上書きしないように、ファイル名に取得時刻を使っています。
{{bc|<nowiki>
#!/bin/sh
activeWinLine=$(xprop -root | grep "_NET_ACTIVE_WINDOW(WINDOW)")
activeWinId=${activeWinLine:40}
import -window "$activeWinId" /tmp/$(date +%F_%H%M%S_%N).png
</nowiki>}}

もしくは、次のコマンドは EWMH をサポートしているかどうかに関わらず動作します:
$ import -window "$(xdotool getwindowfocus -f)" /tmp/$(date +%F_%H%M%S_%N).png

{{Note|(dwb や zathura) プログラムのスクリーンショットが空になる場合は、{{ic|xdotool}} コマンドに {{ic|-frame}} を付けたり {{ic|-f}} を削除してみてください。}}

=== xwd ===

ルートウィンドウのスクリーンショットを取得:
$ xwd -root -out screenshot.xwd

{{Note|{{ic|import}} でアクティブウィンドウのスクリーンショットを取得する方法でも {{ic|xwd}} を使うことができます。}}

=== scrot ===

{{Pkg|scrot}} を使えば CLI からスクリーンショットを撮ることができ、シャッターを押すまでの待機時間をユーザーが定義できるなどの機能があります。特に指定がなければ、カレントディレクトリにファイルが保存されます。
$ scrot -t 20 -d 5

上記のコマンドは日付が入った {{ic|.png}} ファイルが作成され、ウェブ投稿用にサムネイルも作られます (元の画像の 20%)。上の例ではキャプチャするまで5秒間待ちます。

ファイルに保存するときに標準的な日付のフォーマットを使うこともできます、例えば:
$ scrot ~/screenshots/%Y-%m-%d-%T-screenshot.png

このコマンドではホームディレクトリの "screenshots" という名前のフォルダに、現在の年・月・日・時間・分・秒がファイル名のスクリーンショットが保存されます。

詳しくは {{man|1|scrot}} を見て下さい。[https://github.com/kaihendry/Kai-s--HOME/tree/master/bin] のようにファイルのアップロードを自動化することもできます。

{{Note|一部のウィンドウマネージャでは ([[dwm]] や [[xmonad]] など)、{{ic|scrot -s}} がウィンドウマネージャのキーボードショートカットで正しく動作しないことがあります。scrot を実行する前に短いポーズを挟むことで問題を解決できます: {{ic|sleep 0.2; scrot -s}}。}}

=== escrotum ===

{{AUR|escrotum-git}} は pygtk を使って画面をキャプチャします。scrot にインスパイアされています。

選択モードを使った時に scrot ではウィンドウのリフレッシュでバグが発生するので開発されました。

コマンドラインインターフェースは scrot とほぼ同じなので、そのまま同じように使うことができます。

=== maim ===

{{Pkg|maim}} は scrot の向上版を目指しています。

scrot の欠点を補っており [https://github.com/naelstrof/slop slop] で領域のスクリーンショットを取得します。

=== FFmpeg ===

[[FFmpeg]] は X11 のスクリーンをキャプチャできる x11grab デバイスを提供しています。

ディスプレイの''横幅''x''高さ''を指定してスクリーンショットを取得:

$ ffmpeg -f x11grab -video_size ''width''x''height'' -i $DISPLAY -vframes 1 screen.png

上記のコマンドでは PNG コーデック (ロスレスでスクリーンショットに向いている) を使っていますが、他の画像コーデックも使うことができます。

同じデバイスを使ってスクリーンキャストも可能です (ディスプレイのリフレッシュレートを ''rate'' HZ で指定):

$ ffmpeg -f x11grab -video_size ''width''x''height'' -framerate ''rate'' -i $DISPLAY -c:v libx264 -preset ultrafast cast.mkv

上記のコマンドでは、エンコード速度が一番高速な x264 コーデックを使っていますが、他のコーデックも使えます。ただし (ディスクのパフォーマンスが足りなかったりエンコードが遅かったりして) フレームの書き込みが遅すぎると、フレームが抜け落ちて出力された動画は飛び飛びになります。

=== Weston ===

Wayland のコンポジットマネージャである [[Weston]] では、{{ic|Super+s}} を押すことでスクリーンショットを撮影することができ、Weston の現在の作業ディレクトリに保存されます。スクリーンキャストもサポートされています。録画の開始と停止は {{ic|Super+r}} を押すことで行われ、Weston の現在の作業ディレクトリに {{ic|capture.wcap}} という名前のファイルが作成されます。{{ic|wcap-decode --yuv4mpeg2 capture.wcap}} を実行することでキャプチャを YUV フォーマットにデコードできます。このコマンドの出力をファイルに書き込んだり、FFmpeg にパイプして更に処理を加えることもできます。

== スクリーンキャストソフトウェア ==

[[FFmpeg#スクリーンキャプチャ]] と [[Wikipedia:Comparison of screencasting software]] も参照してください。

スクリーンキャストユーティリティは、デスクトップや個々のウィンドウのビデオを作成することができます。

* {{App|Byzanz|GIF アニメーションを作成するシンプルなスクリーンキャストツール。|https://gitlab.gnome.org/Archive/byzanz|{{Pkg|byzanz}}}}
* {{App|Deepin Screen Recorder|Deepin デスクトップ用のスクリーンレコーダーアプリケーション。|https://www.deepin.org/en/original/deepin-screen-recorder/|{{Pkg|deepin-screen-recorder}}}}
* {{App|FFcast|Bash で書かれた FFmpeg ベースのスクリーンキャストツール。|https://github.com/lolilolicon/FFcast|{{AUR|ffcast}}}}
* {{App|Gpu Screen Recorder|Nvidia ShadowPlay に匹敵する、パフォーマンスを大幅に向上させるためだけに GPU でビデオをキャプチャするスクリーンレコーダー。ライブストリーミングとリプレイバッファもサポートします。現在は NVIDIA に限定されています。|https://git.dec05eba.com/gpu-screen-recorder-gtk/about/|{{AUR|gpu-screen-recorder-gtk-git}}}}
* {{App|Green Recorder|Linux システム用のシンプルかつ機能的なデスクトップレコーダー。|https://github.com/dvershinin/green-recorder|{{AUR|green-recorder}}}}
* {{App|Kazam|デザインを念頭に置いたスクリーンキャストプログラム。マルチスクリーン設定を処理します。|https://launchpad.net/kazam|{{AUR|kazam}}}}
* {{App|Kooha|最小限の GTK インターフェースを備えたシンプルなスクリーンレコーダー。|https://github.com/SeaDve/Kooha|{{Pkg|kooha}}}}
* {{App|menyoki|コマンドラインでスクリーンショット {ショット、キャスト} を実行し、ImageOpsを実行します。|https://github.com/orhun/menyoki|{{Pkg|menyoki}}}}
* {{App|[[Open Broadcaster Software]]|ビデオ録画およびライブストリーミングアプリケーション。|https://obsproject.com/|{{Pkg|obs-studio}}}}
:* {{AUR|obs-gnome-screencast}} – GNOME スクリーンキャスト機能用のプラグイン、Wayland をサポート
* {{App|[[Wikipedia:Peek_(software)|Peek]]|GIF、APNG、WebM、または MP4 アニメーションを生成するシンプルなスクリーンキャストツール。|https://github.com/phw/peek|{{Pkg|peek}}}}
* {{App|RecApp|GTK で書かれたユーザーフレンドリーなスクリーンキャスター。無料の GStreamer モジュールを使用し、FFmpeg に依存しません。|https://github.com/amikha1lov/RecApp|{{AUR|recapp-git}}}}
* {{App|RecordItNow|KDE 4 用のプラグインベースのデスクトップレコーダー。|http://recorditnow.sourceforge.net/|{{AUR|recorditnow}}}}
* {{App|[[RecordMyDesktop]]|CLI、GTK、または Qt インターフェイスを使用してデスクトップを ogg 形式に記録する使いやすいユーティリティです。(開発はアクティブではありません)|http://recordmydesktop.sourceforge.net/|CLI: {{Pkg|recordmydesktop}}, GTK: {{AUR|gtk-recordmydesktop}}, Qt: {{AUR|qt-recordmydesktop}}}}
* {{App|screencast|FFmpeg を使用して X11 デスクトップを記録するためのコマンドラインインターフェイス。オフライン記録とライブストリーミングをサポートします。|https://github.com/dbermond/screencast/|{{AUR|screencast}}}}
* {{App|Screencast|基本的な OS 向けに設計されたシンプルなスクリーンキャストレコーダー。|https://github.com/artemanufrij/screencast|{{AUR|pantheon-screencast}}}}
* {{App|[[Wikipedia:SimpleScreenRecorder|SimpleScreenRecorder]]|X11 および OpenGL をサポートする C++/Qt5 で書かれた機能豊富なスクリーンレコーダー。|https://www.maartenbaert.be/simplescreenrecorder/|{{AUR|simplescreenrecorder}}}}
* {{App|Spectacle|スクリーン {ショット,キャスト} 用の [[KDE]] アプリケーション。Wayland 上のデスクトップ全体、単一の画面、または単一のウィンドウのビデオ (音声なし) をキャプチャできます。{{Grp|kde-graphics}} の一部。|https://invent.kde.org/graphics/spectacle|{{Pkg|spectacle}}}}
* {{App|VokoScreen|GStreamer を使用したシンプルなスクリーンキャスト GUI ツール。|https://linuxecke.volkoh.de/vokoscreen/vokoscreen.html|{{Pkg|vokoscreen}}}}
* {{App|Wayfarer|GNOME / Wayland / Pipewire 用の GTK4 スクリーンレコーダー。|https://github.com/stronnag/wayfarer|{{AUR|wayfarer}}}}
* {{App|[[Wikipedia:XVidCap|XVidCap]]|X Window System の画面出力を音声ナレーション付きでスクリーンキャストまたはデジタル録音するためのアプリケーション。|http://xvidcap.sourceforge.net/|{{AUR|xvidcap}}}}

== Wayland ==

wlroots ベースのコンポジタで画面をキャプチャするには、スクリーンショットの場合は {{Pkg|grim}} または {{AUR|swayshot}}、ビデオの場合は {{Pkg|wf-recorder}} (または {{AUR|wf-recorder-git}}) を使用します。{{AUR|wlrobs-hg}} は、wlroot ベースのコンポジタでのスクリーンキャプチャーを可能にする {{Pkg|obs-studio}}プラグインです。必要に応じて、{{Pkg|slurp}} を使用してキャプチャする画面の部分を選択できます。

画面全体のスクリーンショットを撮ります。

$ grim screenshot.png

現在のウィンドウのスクリーンショットを撮る。

$ grim -g "$(swaymsg -t get_tree | jq -r '.. | select(.focused?) | .rect | "\(.x),\(.y) \(.width)x\(.height)"')" screenshot.png

画面の一部のスクリーンショットを撮ります。

$ grim -g "$(slurp)" screenshot.png

画面の一部のスクリーンショットを取得し、{{Pkg|wl-clipboard}} を使用してクリップボードに出力します。

$ grim -g "$(slurp)" - | wl-copy

画面全体のビデオをキャプチャする。

$ wf-recorder -f recording.mp4

画面の一部のビデオをキャプチャする。

$ wf-recorder -g "$(slurp)"

{{Tip|
* [https://github.com/de-arl/slurpshot slurpshot] を使用してスクリプトを撮るインタラクティブなスクリーンショットです {{Pkg|bemenu}}
* {{Pkg|swappy}} キャプチャ後のスクリーンショット編集および描画ツールを使用するには {{ic|grim -g "$(slurp)" - {{!}} swappy -f -}}
}}

また、上記の一部のプログラムは Wayland (例:{{Pkg|ksnip}}、{{AUR|green-recorder}}) で動作します。

===スクリーンキャスト===

==== GNOME スクリーンキャストより ====

{{AUR|green-recorder}}、{{AUR|obs-gnome-screencast}}、および {{AUR|obs-xdg-portal-git}} は、GNOME スクリーンキャスト機能を使用した Wayland でのスクリーンレコーディングをサポートしています。

==== 仮想 Web カメラのビデオフィード経由 ====

{{Tip|
* このメソッドは {{AUR|zoom}} ({{Pkg|xorg-xwayland}} で実行されるデスクトップ・クライアント) および {{Pkg|chrome}} ({{Pkg|firefox}} で実行される [https://bigbluebutton.org/ BigBlueButton]) でテストされています ({{Pkg|firefox}} では解像度が非常に低くなります) {{AUR|skypeforlinux-stable-bin}} は仮想ビデオデバイス {{ic|VirtualVideoDevice}} を検出しますが、空白の画面を出力します。
* この例では {{ic|wf-recorder}} を使用していますが、出力を仮想デバイスに送信するだけで、任意のソフトウェアを使用できます。}}

{{Pkg|wf-recorder}} (または {{AUR|wf-recorder-git}}) および {{Pkg|v4l2loopback-dkms}} をインストールします。次のパラメータを指定して {{ic|v4l2loopback}} カーネルモジュールをロードします。

# modprobe v4l2loopback exclusive_caps=1 card_label=VirtualVideoDevice

新しい仮想ビデオデバイス {{ic|VirtualVideoDevice}} が作成されたことを確認します。

{{hc|$ v4l2-ctl --list-devices|
...
VirtualVideoDevice (platform:v4l2loopback-000):
/dev/video2
...
}}

{{ic|wf-recorder}} を使用して画面の記録を開始し、{{ic|v4l2loopback}} によって作成された新しい仮想ビデオデバイス {{ic|VirtualVideoDevice}} に出力を送ります。

$ wf-recorder --muxer=v4l2 --codec=rawvideo --file=/dev/video2 -x yuv420p

ビデオ出力をズーム [https://github.com/ammen99/wf-recorder/pull/43] と互換性を持たせるには、{{ic|yuv420p}} 色空間が必要です。

上記の仮想ビデオデバイスをビデオ通話/ビデオ会議アプリケーションの "ウェブカメラ" として選択できるようになりました (デバイスの名前は {{ic|VirtualVideoDevice}}) {{ic|ffplay}} ({{Pkg|ffmpeg}}の一部) 、{{Pkg|mpv}}、または {{ic|gst-launch}} ({{Pkg|gstreamer}} の一部) を使用して、仮想ビデオデバイスが実際にスクリーン共有を出力していることを確認できます。

$ ffplay /dev/video2

$ mpv av://v4l2:/dev/video2

$ gst-launch-1.0 -v v4l2src device=/dev/video2 ! glimagesink

Firefox がビデオストリームを読み取ることができず、"AbortError: Starting video failed" のようなメッセージを出力する場合は、プリロードを試してください {{ic|v4l2compat.so}}:
$ LD_PRELOAD=/usr/lib/v4l1compat.so firefox

===== 個々のアプリケーションの共有 =====

{{Warning|ウィンドウのサイズを変更しても、共有されている領域は変更されないため、このメソッドには個々のアプリケーション共有の適切な実装は含まれません。}}

前述のように、{{ic|wf-recorder}} では、まず {{Pkg|slurp}} で領域を選択することで、画面の一部のみを記録できます。この機能を使用して、仮想ビデオデバイスを介して特定のリージョンまたはアプリケーションウィンドウを共有するには、次の変更されたコマンドで画面の記録を開始します。

$ wf-recorder '''-g "$(slurp)"''' --muxer=v4l2 --codec=rawvideo --file=/dev/video2 -x yuv420p

画面の領域を選択すると、上記のように仮想ビデオデバイス {{ic|/dev/video2}} からビデオフィードにアクセスできるようになります。

==== WebRTC プロトコル経由 ====

{{Warning|このメソッドでは、出力全体の共有のみが許可され、個々のアプリケーション [https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows] の共有は許可されません。}}

こちらを参照 [[PipeWire#WebRTC 画面共有]].

これで Chromium と Firefox からスクリーンシェアにアクセスできるようになります。こちらを参照、 [https://mozilla.github.io/webrtc-landing/gum_test.html Mozilla's getUserMedia/getDisplayMedia Test Page]

== ターミナル ==

=== ansi コードで出力 ===

{{Pkg|util-linux}} パッケージに含まれている、{{ic|script}} コマンドを使うことができます。{{ic|$ script}} と入力すればその瞬間から、全ての出力は (ansi コードを含めて) {{ic|typescript}} ファイルに保存されるようになります。

終わったら、{{ic|exit}} と入力するだけで {{ic|typescript}} が作成されます。作成されたファイルは [[AUR]] の {{AUR|ansi2html}} パッケージを使って html に変換できます。

{{ic|typescript}} ファイルを {{ic|typescript.html}} に変換するには、次を実行:

$ ansi2html --bg=dark < typescript > typescript.html

また、コマンドによっては直接 ansi2html にパイプで渡すこともできます:

$ ls --color|ansi2html --bg=dark >output.html

どんなコマンドでも使えるというわけではないので、その場合は、{{ic|script}} を使う必要があります。

=== フレームバッファ ===

[[フレームバッファ]]をインストールして、{{Pkg|fbgrab}} か {{Pkg|fbdump}} を使用して、スクリーンショットを撮ります。

=== 仮想コンソール ===

[[Uvesafb]] をインストールして {{Pkg|fbgrab}} または {{Pkg|fbdump}} を使ってスクリーンショットを取得してください。

単にコンソールの文章を取得したいだけで画像は要らない場合、{{Pkg|util-linux}} パッケージに含まれている {{ic|setterm}} を使うことができます。以下のコマンドは仮想コンソール 1 のテキストをカレントディレクトリの screen.dump ファイルに保存します:
# setterm -dump 1 -file screen.dump

{{ic|/dev/vcs1}} の中身を読まないといけないので root 権限が必要です。

KMSCON

2023-10-11T10:57:02Z

Linuxmetel: /* インストール */ kmscon 9.0.0が 2022 年にリリースされていたので修正

[[Category:ターミナルエミュレータ]]
[[en:KMSCON]]
[[zh-hans:KMSCON]]
{{Related articles start}}
{{Related|KMS}}
{{Related|systemd}}
{{Related|fbterm}}
{{Related articles end}}
[https://github.com/dvdhrm/kmscon プロジェクトの GitHub ページ]より:

:''Kmscon は linux のカーネルモード設定 (KMS) を使ったシンプルなターミナルエミュレータです。カーネルの VT 実装をユーザスペースのコンソールで置き換えようという試みです。''

== 機能 ==

Kmscon はカーネル内蔵の linux コンソールの互換品として機能します。以下の機能が存在します:

* vt220 から vt510 までの完全な実装。
* 国際化の完全サポート:
** Kmscon は CJK を含む、Unicode 文字を全て表示できます。
** Kmscon は libxkbcommon を使って国際化キーボードを扱えるため、X キーボードでサポートされている全てのキーボードレイアウトを利用することが可能です。
* ハードウェアアクセラレーションを使ったレンダリング。
* Multi-seat 可能。

{{Note|root で kmscon コンソールにログインするには、{{ic|pam_securetty}} モジュールを無効にする必要があります。{{ic|/etc/pam.d/login}} 内の適切な行を削除・コメントアウトしてください。}}

== インストール ==

その名前にかかわらず、KMS は kmscon に絶対必要というわけではありません。Kmscon は次のビデオバックエンドをサポートしています: fbdev (Linux fbdev ビデオバックエンド), drm2d (Linux DRM ソフトウェアレンダリングバックエンド), drm3d (Linux DRM ハードウェアレンダリングバックエンド)。あなたの環境でこの中のどれかひとつでも利用できるようにしてください。

{{AUR|kmscon}} もしくは開発版の {{AUR|kmscon-git}} をインストールしてください。あるいは {{AUR|kmscon-patched-git}} をインストールすることもできます。このパッチされたバージョンには依存パッケージの {{AUR|libtsm-patched-git}} と合わせて複数の修正や改善kmscon 9.0.0が含まれています。

TTY1 で kmscon を使えるようにするには、以下を実行してください:
{{bc|
# systemctl disable getty@tty1.service
# systemctl enable kmsconvt@tty1.service
}}

全ての仮想端末で kmscon を有効にする場合は、root で、以下を実行してください:

{{bc|
# ln -s /usr/lib/systemd/system/kmsconvt\@.service /etc/systemd/system/autovt\@.service
}}
これで {{pkg|systemd}} がそれぞれの VT で agetty の代わりに kmscon を起動するようになります。より正確に言うと、このコマンドは systemd-logind が新しい VT で getty@.service の代わりに kmsconvt@.service を使うようにさせます。getty@.service を使っている他のユニットやスクリプトにはこの変更が適用されません。

何らかの理由で kmscon が実行できないときは、代わりに getty@.service が起動されます。そのため問題が生じても動作を継続するためのフォールバックが常に存在します。さらに、VT が利用できない場合、このユニットは何も起動しません。

{{Warning|If you've replaced agetty on all terminals, take care to ensure ''kmscon'' presents you with a prompt before rebooting your machine, otherwise you may have to recover through a live CD.}}

== CJK サポート ==

Kmscon はデフォルトのフォントエンジン {{pkg|pango}} を通して CJK 文字のレンダリングをサポートしています。ただし、モノスペースフォントのエイリアスを適切な CJK フォントにマップするよう {{pkg|fontconfig}} を設定する必要があります。日本語ユーザーは、以下のテンプレートで日本語を表示できます:
{{hc|/etc/fonts/conf.d/99-kmscon.conf|<nowiki>
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<match>
<test name="family"><string>monospace</string></test>
<edit name="family" mode="prepend" binding="strong">
<string>DejaVu Sans Mono</string>
<string>IPAGothic</string>
</edit>
</match>
</fontconfig>
</nowiki>}}
{{Pkg|ttf-dejavu}} と {{Pkg|otf-ipafont}} をインストールしてください。両方とも[[公式リポジトリ]]に含まれています。

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

=== Xorg と kmscon の切り替えに問題が発生する ===

[[Xorg]] と kmscon の切り替えに問題が発生する場合は ExecStart に {{ic|--hwaccel --drm}} を追加するとよいかもしれません。
ExecStart=/usr/bin/kmscon "--vt=%I" --seats=seat0 --no-switchvt --font-name Terminus --font-size 12 --hwaccel --drm

=== 音声を制御できない ===

バージョン 7 で、オーディオをコントロールできない場合、ユーザーを '''audio''' [[ユーザーとグループ#グループ管理|グループ]]に追加してください。ただしグループに追加すると[[Advanced Linux Sound Architecture#インストール|問題]]が発生します。

=== Vim で端末の出力が消去されない ===

Vim を開いたときに端末の出力が消えない場合があります。ファイルの編集は可能ですがテキストが変更するまで表示されません。回避策として、{{ic|1=TERM=vt220}} [[環境変数]]を設定してみてください。もしくは、{{Pkg|vi}} や [[Neovim]] などの vi ライクなテキストエディタを使ってください。
{{Note|{{ic|TERM}} を {{ic|vt220}} に設定した場合、カラーのサポートが利用できません。}}

KMSCON

2023-10-11T10:52:10Z

Linuxmetel: /* インストール */ https://wiki.archlinux.org/title/KMSCON よりパッケージの参照を更新

[[Category:ターミナルエミュレータ]]
[[en:KMSCON]]
[[zh-hans:KMSCON]]
{{Related articles start}}
{{Related|KMS}}
{{Related|systemd}}
{{Related|fbterm}}
{{Related articles end}}
[https://github.com/dvdhrm/kmscon プロジェクトの GitHub ページ]より:

:''Kmscon は linux のカーネルモード設定 (KMS) を使ったシンプルなターミナルエミュレータです。カーネルの VT 実装をユーザスペースのコンソールで置き換えようという試みです。''

== 機能 ==

Kmscon はカーネル内蔵の linux コンソールの互換品として機能します。以下の機能が存在します:

* vt220 から vt510 までの完全な実装。
* 国際化の完全サポート:
** Kmscon は CJK を含む、Unicode 文字を全て表示できます。
** Kmscon は libxkbcommon を使って国際化キーボードを扱えるため、X キーボードでサポートされている全てのキーボードレイアウトを利用することが可能です。
* ハードウェアアクセラレーションを使ったレンダリング。
* Multi-seat 可能。

{{Note|root で kmscon コンソールにログインするには、{{ic|pam_securetty}} モジュールを無効にする必要があります。{{ic|/etc/pam.d/login}} 内の適切な行を削除・コメントアウトしてください。}}

== インストール ==

その名前にかかわらず、KMS は kmscon に絶対必要というわけではありません。Kmscon は次のビデオバックエンドをサポートしています: fbdev (Linux fbdev ビデオバックエンド), drm2d (Linux DRM ソフトウェアレンダリングバックエンド), drm3d (Linux DRM ハードウェアレンダリングバックエンド)。あなたの環境でこの中のどれかひとつでも利用できるようにしてください。

{{AUR|kmscon}} もしくは開発版の {{AUR|kmscon-git}} をインストールしてください。あるいは {{AUR|kmscon-patched-git}} をインストールすることもできます。このパッチされたバージョンには依存パッケージの {{AUR|libtsm-patched-git}} と合わせて、オリジナルのバージョン（2014年以降アップデートがない）には含まれない複数の修正や改善（24-bit カラーのサポート等）が含まれています。

TTY1 で kmscon を使えるようにするには、以下を実行してください:
{{bc|
# systemctl disable getty@tty1.service
# systemctl enable kmsconvt@tty1.service
}}

全ての仮想端末で kmscon を有効にする場合は、root で、以下を実行してください:

{{bc|
# ln -s /usr/lib/systemd/system/kmsconvt\@.service /etc/systemd/system/autovt\@.service
}}
これで {{pkg|systemd}} がそれぞれの VT で agetty の代わりに kmscon を起動するようになります。より正確に言うと、このコマンドは systemd-logind が新しい VT で getty@.service の代わりに kmsconvt@.service を使うようにさせます。getty@.service を使っている他のユニットやスクリプトにはこの変更が適用されません。

何らかの理由で kmscon が実行できないときは、代わりに getty@.service が起動されます。そのため問題が生じても動作を継続するためのフォールバックが常に存在します。さらに、VT が利用できない場合、このユニットは何も起動しません。

{{Warning|If you've replaced agetty on all terminals, take care to ensure ''kmscon'' presents you with a prompt before rebooting your machine, otherwise you may have to recover through a live CD.}}

== CJK サポート ==

Kmscon はデフォルトのフォントエンジン {{pkg|pango}} を通して CJK 文字のレンダリングをサポートしています。ただし、モノスペースフォントのエイリアスを適切な CJK フォントにマップするよう {{pkg|fontconfig}} を設定する必要があります。日本語ユーザーは、以下のテンプレートで日本語を表示できます:
{{hc|/etc/fonts/conf.d/99-kmscon.conf|<nowiki>
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<match>
<test name="family"><string>monospace</string></test>
<edit name="family" mode="prepend" binding="strong">
<string>DejaVu Sans Mono</string>
<string>IPAGothic</string>
</edit>
</match>
</fontconfig>
</nowiki>}}
{{Pkg|ttf-dejavu}} と {{Pkg|otf-ipafont}} をインストールしてください。両方とも[[公式リポジトリ]]に含まれています。

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

=== Xorg と kmscon の切り替えに問題が発生する ===

[[Xorg]] と kmscon の切り替えに問題が発生する場合は ExecStart に {{ic|--hwaccel --drm}} を追加するとよいかもしれません。
ExecStart=/usr/bin/kmscon "--vt=%I" --seats=seat0 --no-switchvt --font-name Terminus --font-size 12 --hwaccel --drm

=== 音声を制御できない ===

バージョン 7 で、オーディオをコントロールできない場合、ユーザーを '''audio''' [[ユーザーとグループ#グループ管理|グループ]]に追加してください。ただしグループに追加すると[[Advanced Linux Sound Architecture#インストール|問題]]が発生します。

=== Vim で端末の出力が消去されない ===

Vim を開いたときに端末の出力が消えない場合があります。ファイルの編集は可能ですがテキストが変更するまで表示されません。回避策として、{{ic|1=TERM=vt220}} [[環境変数]]を設定してみてください。もしくは、{{Pkg|vi}} や [[Neovim]] などの vi ライクなテキストエディタを使ってください。
{{Note|{{ic|TERM}} を {{ic|vt220}} に設定した場合、カラーのサポートが利用できません。}}

Libvirt

2023-03-10T15:14:24Z

Linuxmetel: /* UEFI サポート */ https://wiki.archlinux.org/index.php?title=Libvirt&oldid=767309 より翻訳を更新 & 操作に出てくるボタン等の表示を翻訳

{{DISPLAYTITLE:libvirt}}
[[Category:仮想化]]
[[en:Libvirt]]
[[zh-hans:Libvirt]]
[[zh-hant:Libvirt]]
{{Related articles start}}
{{Related|QEMU}}
{{Related|KVM}}
{{Related|VirtualBox}}
{{Related|Xen}}
{{Related|VMware}}
{{Related|OVMF による PCI パススルー}}
{{Related articles end}}

[http://wiki.libvirt.org/page/FAQ#Libvirt_FAQ libvirt: The virtualization API] より:
:Libvirt は仮想マシンや、ストレージ・ネットワークインターフェイスの管理などの仮想化機能を管理するための便利な手段を提供するソフトウェアのコレクションです。ソフトウェアには API ライブラリ、デーモン (libvirtd)、コマンドラインユーティリティ (virsh) が含まれています。

:libvirt の目標は様々な仮想化プロバイダ/ハイパーバイザを管理する共通の手段を提供することにあります。

:libvirt の主な特徴は以下の通りです:
:*''VM 管理'': 起動・停止・一時停止・保存・復旧・移行などの様々なドメイン操作。ディスク・ネットワークインターフェイス・メモリ・CPU など多数のデバイスのホットプラグ制御。
:*''リモートマシンのサポート'': libvirt デーモンが走ってるマシンなら libvirt の機能は全て使うことができます。リモートマシンも例外ではありません。リモートで接続するための様々なネットワーク転送をサポートしています。一番シンプルなのは SSH で、細かい設定を必要としません。
:*''ストレージ管理'': libvirt デーモンを動かしているホストを使って様々なタイプのストレージを管理できます: 様々なフォーマットのファイルイメージを作成 (qcow2, vmdk, raw, ...)、NFS 共有のマウント、既存の LVM ボリュームグループの列挙、新しい LVM ボリュームグループや論理ボリュームの作成、ディスクデバイスのパーティション、iSCSI 共有のマウントなど。
:*''ネットワークインターフェイス管理'': libvirt デーモンを動かしているホストを使って物理・論理ネットワークインターフェイスを管理できます。既存のインターフェイスを列挙するだけでなく、インターフェイス・ブリッジ・仮想 LAN・ボンドデバイスを設定 (作成) できます。
:*''仮想 NAT とルートベースネットワーク'': libvirt デーモンを動かしているホストを使って仮想ネットワークを管理・作成できます。Libvirt の仮想ネットワークはファイアウォールのルールを使うことでルーターとして動作し、VM からホストマシンのネットワークに透過的にアクセスすることを可能にします。

libvirt には [[QEMU|KVM/QEMU]], [[Xen]], [[LXC]], [http://openvz.org OpenVZ], [[VirtualBox]] などの[[:カテゴリ:仮想化|仮想化]]バックエンドを、リモート・ローカルを問わず管理するために、統一の抽象化レイヤーが備わっています ([http://libvirt.org/drivers.html その他])。

長期的に安定した C の API を用意することで、[http://libvirt.org/apps.html 様々なツール] で ''libvirtd'' デーモンに接続して多数の仮想化エンジンを管理することが可能です。libvirt デフォルトのクライアントは ''virsh'' と呼ばれています。

== インストール ==

デーモン・クライアントアーキテクチャをとっているため、''libvirt'' をインストールする必要があるのは仮想化システムをホストするマシンだけです。サーバーとクライアントは同じ物理マシンにすることができます。

=== サーバー ===

{{pkg|libvirt}} パッケージと、どれか一つハイパーバイザを[[インストール]]してください:

* [http://libvirt.org/drvqemu.html libvirt KVM/QEMU ドライバー] は基本の ''libvirt'' ドライバーなので [[QEMU#KVM を有効にする|KVM が有効]]になっていれば、完全に仮想化された、ハードウェアによる支援を受けたゲストを使うことができます。詳しくは [[QEMU]] の記事を見て下さい。

* 他にも仮想化バックエンドとして [[LXC]], [[VirtualBox]], [[Xen]] などが存在します。インストール方法はそれぞれのページを参照してください。
:{{Note|[http://libvirt.org/drvlxc.html libvirt LXC ドライバー] は {{Pkg|lxc}} に含まれている [[LXC]] のユーザースペースツールに依存していません。そのため、このドライバーを使う場合はパッケージをインストールする必要はありません。}}
:{{Warning|[[Xen]] のサポートはデフォルトでは利用できない状態になっています。[[ABS]] を使って {{Pkg|libvirt}} の [[PKGBUILD]] を修正して {{ic|--without-xen}} オプションを外してビルドする必要があります。VirtualBox は安定的に Xen をサポートする予定がないため {{ic|--without-vbox}} に置き換えても良いでしょう。}}

他にサポートされているハイパーバイザは [http://libvirt.org/drivers.html こちら] に記載されています。

ネットワークに接続するために、以下をインストールしてください:

* [http://wiki.libvirt.org/page/VirtualNetworking#The_default_configuration デフォルト] の NAT/DHCP ネットワークの場合 {{Pkg|ebtables}} と {{Pkg|dnsmasq}}。
* ブリッジネットワークの場合 {{Pkg|bridge-utils}}。
* [[SSH]] によるネットワーク管理の場合 {{Pkg|openbsd-netcat}}。

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

クライアントは仮想マシンを管理するために使用するユーザーインターフェイスです。

* ''virsh'' はドメインを管理・設定するためのコマンドラインプログラムです。{{Pkg|libvirt}} パッケージに含まれています。
* {{Pkg|virt-manager}} は仮想マシンを管理するためのグラフィカルユーザーインターフェイスです。
* {{Pkg|virt-viewer}} は仮想化されたゲスト OS のグラフィカルな画面を操作するための軽量なインターフェイスです。
* {{Pkg|gnome-boxes}} はリモートや仮想システムにアクセスするためのシンプルな GNOME 3 アプリケーションです。
* {{AUR|virt-manager-qt5}}{{Broken package link|パッケージが存在しません}} は virt-manager の Qt 版です。
* {{AUR|libvirt-sandbox}} はアプリケーションのサンドボックスツールキットです。

libvirt に対応しているソフトウェアのリストは [http://libvirt.org/apps.html こちら] にあります。

==設定==

システムレベルの管理をする場合、少なくとも、[[#認証を設定|認証を設定]]して、[[#デーモンを起動|デーモンを起動]]する必要があります。

{{Note|ユーザーセッションの管理をする場合、デーモンの設定は必要ありません。ただし、認証はローカルに限定され、フロントエンドは ''libvirtd'' デーモンのローカルインスタンスを起動します。}}

=== 認証を設定 ===

[http://libvirt.org/auth.html#ACL_server_config libvirt: Connection authentication] より:
:''libvirt'' デーモンではクライアントの接続に使用する認証メカニズムを管理者が選択することができます。基本的に libvirt デーモンのメイン設定ファイルである {{ic|/etc/libvirt/libvirtd.conf}} で設定します。libvirt のソケットごとに別々の認証メカニズムを設定できます。今のところ {{ic|none}}, {{ic|polkit}}, {{ic|sasl}} の中から選べます。

{{Pkg|libvirt}} は依存パッケージとして {{Pkg|polkit}} をインストールするので、{{ic|unix_sock_auth}} パラメータのデフォルト値としては [[#polkit を使う|polkit]] が使われます ([http://libvirt.org/auth.html#ACL_server_polkit ソース])。また、[[#ファイルベースのパーミッションで認証|ファイルベースのパーミッション]]を使うこともできます。

==== polkit を使う ====

{{Note|{{ic|polkit}} による認証を正しく動作させるにはシステムを再起動する必要があります。}}

''libvirt'' デーモンは {{ic|/usr/share/polkit-1/actions/org.libvirt.unix.policy}} で2つの [[Polkit#アクション|polkit アクション]]を提供します:
* 完全なアクセス管理のための {{ic|org.libvirt.unix.manage}} (RW デーモンソケット)
* アクセスの監視のための {{ic|org.libvirt.unix.monitor}} (読み取り専用ソケット).

RW デーモンソケットのデフォルトポリシーを使うには管理者として認証する必要があります。[[sudo]] 認証と似ていますが、クライアントアプリケーションを root で動かす必要があるというわけではありません。また、デフォルトポリシーではどんなアプリケーションでも RO ソケットに接続することはできます。

Arch では {{ic|wheel}} グループのユーザーを管理者として認識します: これは {{ic|/etc/polkit-1/rules.d/50-default.rules}} で定義されています ([[Polkit#管理者の識別]] を参照)。そのためユーザーを {{ic|wheel}} グループに追加さえすれば、新しいグループやルールファイルを作成する必要はありません。({{Pkg|virt-manager}} などで) RW ソケットに接続する時にユーザーのパスワードを入力するように求められます。

{{Note|パスワードの入力を要求するときは[[Polkit#認証エージェント|認証エージェント]]を使用します。コンソールを使っている場合、デフォルトの {{ic|pkttyagent}} エージェントが上手く動作しないことがあります。}}

{{Tip|認証でパスワードを入力しなくてもよいように設定したい場合、[[Polkit#パスワードプロンプトの迂回]] を見て下さい。}}

libvirt 1.2.16 から {{ic|libvirt}} グループのメンバーはデフォルトで RW デーモンソケットにパスワードを入力しなくてもアクセスすることができます [http://libvirt.org/git/?p=libvirt.git;a=commit;h=e94979e901517af9fdde358d7b7c92cc055dd50c]。libvirt グループを作成してユーザーをグループに追加するのが一番簡単です。RW デーモンソケットにアクセスするときに認証するグループを変更したい場合、以下のファイルを作成:

{{hc|/etc/polkit-1/rules.d/50-libvirt.rules|<nowiki>
/* Allow users in kvm group to manage the libvirt
daemon without authentication */
polkit.addRule(function(action, subject) {
if (action.id == "org.libvirt.unix.manage" &&
subject.isInGroup("kvm")) {
return polkit.Result.YES;
}
});</nowiki>
}}

そして[[ユーザーとグループ#ユーザー管理の他の例|ユーザー]]を {{ic|kvm}} グループに追加して再ログインしてください。''kvm'' は好きなグループに置き換えることができます。グループが存在することと、ユーザーがグループに属していることを確認してください (詳しくは[[ユーザーとグループ]]を参照)。グループの変更を適用するには再ログインが必要です。

==== ファイルベースのパーミッションで認証 ====

''libvirt'' グループのユーザーが仮想マシンを管理できるようにファイルベースのパーミッションを定義するには、以下の行をアンコメントします:

{{hc|/etc/libvirt/libvirtd.conf|<nowiki>
#unix_sock_group = "libvirt"
#unix_sock_ro_perms = "0777" # set to 0770 to deny non-group libvirt users
#unix_sock_rw_perms = "0770"
#auth_unix_ro = "none"
#auth_unix_rw = "none"
</nowiki>}}

ガイドによっては libvird の特定のディレクトリのパーミッションを変更すると管理がしやすくなると書かれていることがありますが、パッケージをアップデートする際に変更したパーミッションは元に戻ってしまうので注意してください。システムディレクトリを編集するときは、root ユーザーを使うようにしてください。

===デーモンを起動===

[[Systemd#ユニットを使う|systemd]] を使って {{ic|libvirtd.service}} と {{ic|virtlogd.service}} を起動してください。任意で {{ic|libvirtd.service}} を[[有効化]]してください。{{ic|libvirtd.service}} が有効化された場合、{{ic|virtlogd.socket}} と {{ic|virtlockd.socket}} も有効化されるため、{{ic|virtlogd.service}} を有効化する必要はありません。

=== TCP/IP ソケットの暗号化の解除 ===

{{Warning|この設定をすると、信頼されたネットワーク内における、リモートドメインの接続速度が向上します。セキュリティ的には完全な無防備なので注意してください。テスト目的であったり、セキュアでプライベート、信頼されたネットワークでおいてのみ使って下さい。SASL を有効にしないため、全ての TCP 通信は''クリアテキスト''になります。通常はどんなときでも SASL を有効にするようにしてください。}}

{{ic|/etc/libvirt/libvirtd.conf}} を編集:
{{hc|/etc/libvirt/libvirtd.conf|<nowiki>
listen_tls = 0
listen_tcp = 1
auth_tcp=none
</nowiki>}}

また、{{ic|/etc/conf.d/libvirtd}} を編集してサーバーをリスニングモードで起動する必要があります:

{{hc|/etc/conf.d/libvirtd|2=LIBVIRTD_ARGS="--listen"}}

=== ホストネームを使って仮想マシンにアクセス ===

ブリッジネットワークを使ってホストからゲストにアクセスするには、{{Pkg|libvirt}} に含まれている {{ic|libvirt}} NSS モジュールを有効にしてください。

{{ic|/etc/nsswitch.conf}} を編集:
{{hc|/etc/nsswitch.conf|<nowiki>
hosts: files libvirt dns myhostname
</nowiki>}}

{{Note|{{ic|ping}} や {{ic|ssh}} などのコマンドで仮想マシンのホストネームを使うことができるようになりますが、{{ic|host}} や {{ic|nslookup}} などのコマンドは DNS に依存するため使えない可能性があります。{{ic|getent hosts <vm-hostname>}} を使ってください。}}

== テスト ==

システムレベルでデーモンが正しく動作しているかテスト:

$ virsh -c qemu:///system

ユーザーセッションで libvirt が正しく動作するかテスト:

$ virsh -c qemu:///session

== 管理 ==

Libvirt の管理は3つのツールで行うことができます: 一つは GUI {{ic|virt-manager}} で、二つはコマンドラインツールです: {{ic|virsh}} と {{ic|guestfish}} ({{Pkg|libguestfs}} に含まれています)。

=== virsh ===

virsh はゲスト''ドメイン'' (仮想マシン) の管理のためのプログラムですが、仮想化管理のスクリプトにも使えます。ほとんどの virsh コマンドは実行するのに root 権限を必要とします。ただしドメインの作成や実行などは (VirtualBox と同じように) 通常ユーザーで実行することができます。

Virsh にはインタラクティブなターミナルが含まれており、コマンドを何も指定しないで実行したときに起動します (オプションは指定することができます): {{ic|virsh}}。インタラクティブターミナルはタブ補完をサポートしています。

コマンドラインから:

$ virsh [option] <command> [argument]...

インタラクティブターミナルから:

virsh # <command> [argument]...

ヘルプを見るには:

$ virsh help [option*] or [group-keyword*]

=== ストレージプール ===

プールはストレージ''ボリューム''を保存しておく場所です。libvirt における''ボリューム''は、他のハイパーバイザでは"仮想ディスク"または"仮想マシンイメージ"と定義されていることがあります。プールの場所はディレクトリでも、ネットワークファイルシステムでも、パーティションでもかまいません ([[LVM]] を含む)。プールは有効・無効を切り替えたり領域を予約することができます。

システムレベルでは、デフォルトで {{ic|/var/lib/libvirt/images/}} が有効になります。ユーザーセッションでは {{ic|virt-manager}} は {{ic|$HOME/VirtualMachines}} を作成します。

有効または無効なストレージプールを確認:

$ virsh pool-list --all

==== virsh を使って新しいプールを作成 ====

ストレージプールを追加したい場合、以下がコマンド形式、ディレクトリの追加、LVM ボリュームの追加の例です:

$ virsh pool-define-as name type [source-host] [source-path] [source-dev] [source-name] [<target>] [--source-format format]
$ virsh pool-define-as ''poolname'' dir - - - - /home/''username''/.local/libvirt/images
$ virsh pool-define-as ''poolname'' fs - - ''/dev/vg0/images'' - ''mntpoint''

上記のコマンドはプールの情報を定義します。ビルドするには:

$ virsh pool-build ''poolname''
$ virsh pool-start ''poolname''
$ virsh pool-autostart ''poolname''

削除するには:

$ virsh pool-undefine ''poolname''

{{Tip|LVM ストレージプールの場合:
* ボリュームグループはストレージプール専用にするほうが良いでしょう。
* LVM ボリュームグループの名前はプールの名前と変えて下さい。ストレージプールを削除したときに LVM グループも削除されてしまいます。
}}

==== virt-manager を使って新しいプールを作成 ====

まず、既存のサーバーに接続してください。そこで、右クリックして ''Details'' を選んで下さい。''Storage'' に行き左下の ''+'' アイコンを押して下さい。それからはウィザードに従って下さい。

=== ストレージボリューム ===

プールを作成したら、プールの中にボリュームを作成することができます。新しいドメイン (仮想マシン) を作成する場合、ドメインの作成時にボリュームを作成できるのでこの手順はスキップできます。

==== virsh を使って新しいボリュームを作成 ====

ボリュームの作成、確認、リサイズ、削除:

$ virsh vol-create-as ''poolname'' ''volumename'' 10GiB --format aw|bochs|raw|qcow|qcow2|vmdk
$ virsh vol-upload --pool ''poolname'' ''volumename'' ''volumepath''
$ virsh vol-list ''poolname''
$ virsh vol-resize --pool ''poolname'' ''volumename'' 12GiB
$ virsh vol-delete --pool ''poolname'' ''volumename''
$ virsh vol-dumpxml --pool ''poolname'' ''volumename'' # for details

==== virt-manager の補助記憶 ====

新しいバージョンの {{ic|virt-manager}} では新しいディスクを作成するときに補助記憶を指定することができます。新しい仮想システムをプロビジョニングする場合にベースイメージを基にして新しいドメインを作ることができるため、時間と容量の両方を節約できてとても便利です。ただし現在のバージョンの {{ic|virt-manager}} にはバグ (https://bugzilla.redhat.com/show_bug.cgi?id=1235406) が存在し、補助イメージが {{ic|qcow2}} タイプの場合に {{ic|virt-manager}} が間違ったタイプの補助イメージを選択してしまいます。この場合、補助タイプとして {{ic|raw}} が選択されます。補助記憶から新しいイメージが読み取れなくなり、補助記憶を用意する意味が完全に失われます。

この問題の回避策として {{ic|qemu-img}} を使うことで直接補助記憶を指定することができます。バグが修正されるまでは、補助記憶を使いたい場合、以下のコマンドを使って下さい:

$ qemu-img create -f qcow2 -o backing_file=<path to backing image>,backing_fmt=qcow2 <disk name> <disk size>

作成したイメージを新しいドメインのベースとすることで COW ボリュームとして補助記憶が使用され時間と容量が節約されます。

=== ドメイン ===

libvirt では仮想マシンは''ドメイン''と呼ばれます。コマンドラインから使う場合、{{ic|virsh}} でドメインを確認・作成・停止・シャットダウンできます。{{ic|virt-viewer}} を使って {{ic|virsh}} で起動したドメインを確認することも可能です。ドメインの作成は {{ic|virt-manager}} でグラフィカルに行うか {{ic|virt-install}} ({{pkg|virt-install}} パッケージに含まれているコマンドラインプログラム) を使います。

新しいドメインを作成するときは、インストールメディアを使用します。ドメインの作成後にロードします。ストレージプールから {{ic|.iso}} を参照したり、光学ドライブを参照することができます。

有効または無効なドメインを確認:

# virsh list --all

{{Note|[[SELinux]] はデフォルトで {{ic|/var/lib/libvirt/images/}} にボリュームが保存されることを必要とします。SELinux を使っていてボリュームに問題が起こる場合、ボリュームがそのディレクトリにあるか確認、またはあなたが使用している非デフォルトのディレクトリの適当なラベリングを追加してください。}}

==== virt-install を使って新しいドメインを作成 ====

ドメイン (仮想マシン) を細かく設定したい場合、[[#virt-manager を使って新しいドメインを作成|virt-manager を使って新しいドメインを作成]]する方が簡単です。しかしながら、基本的な設定は {{ic|virt-install}} で行うことができます。最低でも指定する必要があるのは {{ic|--name}}, {{ic|--memory}}, ゲストストレージ ({{ic|--disk}}, {{ic|--filesystem}} または {{ic|--nodisks}}), インストール方法 ({{ic|.iso}} または CD) です。オプションについて詳しくは {{man|1|virt-install}} を見てください。

Arch Linux のインストール (2GiB, qcow2 フォーマットのボリューム作成; ユーザーネットワーク):

$ virt-install \
--name arch-linux_testing \
--memory 1024 \
--vcpus=2,maxvcpus=4 \
--cpu host \
--cdrom $HOME/Downloads/arch-linux_install.iso \
--disk size=2,format=qcow2 \
--network user \
--virt-type kvm

Fedora testing (Xen ハイパーバイザ, 非デフォルトのプール, オリジナルの表示を使わない):

$ virt-install \
--connect xen:/// \
--name fedora-testing \
--memory 2048 \
--vcpus=2 \
--cpu=host \
--cdrom /tmp/fedora20_x84-64.iso \
--os-type=linux --os-variant=fedora20 \
--disk pool=testing,size=4 \
--network bridge=br0 \
--graphics=vnc \
--noautoconsole
$ virt-viewer --connect xen:/// fedora-testing

Windows:

$ virt-install \
--name=windows7 \
--memory 2048 \
--cdrom /dev/sr0 \
--os-variant=win7 \
--disk /mnt/storage/domains/windows7.qcow2,size=20GiB \
--network network=vm-net \
--graphics spice

{{Tip|{{ic|--os-variant}} の引数を取得するには {{ic|1=osinfo-query --fields=name,short-id,version os}} を実行してください。ドメインの仕様を定義するのに役立ちます。ただし、{{ic|--memory}} と {{ic|--disk}} を入力する必要があります。仕様が必要な場合は適当な {{ic|/usr/share/libosinfo/db/oses/''os''.xml}} を見て下さい。インストール後、[https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Virtualization_Host_Configuration_and_Guest_Installation_Guide/form-Virtualization_Host_Configuration_and_Guest_Installation_Guide-Para_virtualized_drivers-Mounting_the_image_with_virt_manager.html VirtIO ドライバー] が含まれている [http://www.spice-space.org/download.html Spice Guest Tools] をインストールすると良いでしょう。Windows の VirtIO ネットワークドライバーは {{Aur|virtio-win}} にもあります。ドライバーはゲストの {{ic|.xml}} 設定のデバイスセクションに {{ic|1=<model type='virtio' />}} で指定します。詳細は [[QEMU#Windows ゲストを用意する|QEMU]] の記事を読んで下さい。}}

既存のボリュームをインポート:

$ virt-install \
--name demo \
--memory 512 \
--disk /home/user/VMs/mydisk.img \
--import

==== virt-manager を使って新しいドメインを作成 ====

まずハイパーバイザに接続します (例: QEMU/KVM ''システム''またはユーザー''セッション'')。接続を右クリックして ''New'' を選択して、ウィザードに従って下さい。

* ''ステップ4'' で、''Allocate entire disk now'' のチェックを外すことができます -- VM がディスクの全てを使用していないときに容量を節約します。ただし、ディスクのフラグメンテーションが増加する可能性があるので、VM ホストのディスクの合計空き容量に''注意してください''、VM にディスク容量を追加で割り当てるほうが簡単だからです。

* ''ステップ5'' では、''Advanced options'' を開いて ''Virt Type'' を ''kvm'' に設定してください。追加のハードウェア設定が必要な場合、''Customize configuration before install'' オプションを選んで下さい。

==== ドメインの管理 ====

ドメインを起動:

$ virsh start ''domain''
$ virt-viewer --connect qemu:///session ''domain''

ドメインを上品にシャットダウン、または強制的にオフにする:

$ virsh shutdown ''domain''
$ virsh destroy ''domain''

libvirtd の起動時にドメインを自動実行:

$ virsh autostart ''domain''
$ virsh autostart ''domain'' --disable

ホストのシャットダウン時にドメインもシャットダウン:

: {{ic|libvirt-guests.service}} systemd サービスを使うことでホストのシャットダウン時に自動的にゲストの実行をサスペンド (もしくは) シャットダウンさせることができます。同じデーモンでホストの起動時に自動的にサスペンド (シャットダウン) されたゲストが復帰 (起動) されます。サービスのオプションは {{ic|/etc/conf.d/libvirt-guests}} をチェックしてください。

ドメインの設定を編集:

$ virsh edit ''domain''

{{note|QEMU によって直接起動した仮想マシンは libvirt ツールで管理できません。}}

=== ネットワーク ===

デフォルトでは、{{ic|libvird}} systemd サービスが起動すると、''default'' という名前の NAT ブリッジが作成されて外部ネットワークに接続できるようになります。

他のネットワーク接続が必要な場合、ドメインとの接続を作成することができる4つのネットワークタイプが存在します:

* bridge — 仮想デバイス。物理インターフェイスと直接データを共有します。ホストで''固定''ネットワークを使う場合や他のドメインに接続する必要がない場合、またはドメインに完全なインバウンドとアウトバウンドの通信が必要な場合やドメインを''システムレベル''で動作させる場合、ブリッジを使って下さい。ブリッジを追加する方法は[[ネットワークブリッジ]]を参照。作成後、ゲストの {{ic|.xml}} 設定ファイルで指定する必要があります。
* network — 仮想ネットワーク。他のドメインと共有することができます。ホストが''動的''ネットワーク (例: NetworkManager) やワイヤレスを使う場合仮想ネットワークを使って下さい。
* macvtap — ホストの物理インターフェイスに直接接続。
* user — ローカルのネットワーク。ユーザー''セッション''の場合に使って下さい。

{{ic|virsh}} にはネットワークを作成するための様々なオプションが存在していますが、({{ic|virt-manager}} などの) グラフィカルユーザーインターフェイスを使ったり [[#virt-install を使って新しいドメインを作成|virt-install でドメインを作成]]するときにネットワーク接続を作成する方が簡単です。

{{note|libvirt は {{pkg|dnsmasq}} で DHCP や DNS を管理し、仮想ネットワークごとにインスタンスを起動します。また、適切なルーティングが行われるように iptables ルールを追加して、{{ic|ip_forward}} カーネルパラメータを有効にします。libvirt を使うのにホストで dnsmasq を実行する必要はありません (libvirt の dnsmasq インスタンスと干渉する可能性があります)。}}

==== IPv6 ====

設定ツールを使って IPv6 アドレスを追加した際に、以下のようなエラーが表示されることがあります:
Check the host setup: enabling IPv6 forwarding with RA routes without accept_ra set to 2 is likely to cause routes loss. Interfaces to look at: ''eth0''

以下のファイルを作成することで問題を解決できます ({{ic|''eth0''}} は物理インターフェイスの名前に置き換えてください):

{{hc|/etc/sysctl.d/libvirt-bridge.conf|2=
net.ipv6.conf.eth0.accept_ra = 2
}}

設定したらマシンを再起動してください。

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

スナップショットは現時点でのドメインのディスク・メモリ・デバイスの状態を取得して、将来のために保存します。OS の"クリーン"なコピーを保存することから、ドメインが破壊される前にドメインの状態を保存することまで、様々な理由で使われます。スナップショットは一意な名前で識別されます。

スナップショットはボリュームの中に保存されるためボリュームが次の形式である必要があります: qcow2 または raw。スナップショットは差分を使用するので大量の容量を使用することはありません。

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

スナップショットが取得されると新しいブロックデバイスとして保存されオリジナルのスナップショットはオフラインになります。スナップショットは他のスナップショットから選択したりマージすることができます (ドメインをシャットダウンする必要はありません)。

動作中のドメインのボリュームを確認 (動作中のドメインは {{ic|virsh list}} で確認できます):

{{hc|# virsh domblklist ''domain''|<nowiki>
Target Source
------------------------------------------------
vda /vms/domain.img
</nowiki>}}

ボリュームの物理プロパティを確認するには:

{{hc|# qemu-img info /vms/domain.img|<nowiki>
image: /vms/domain.img
file format: qcow2
virtual size: 50G (53687091200 bytes)
disk size: 2.1G
cluster_size: 65536
</nowiki>}}

disk-only スナップショットを作成 ({{ic|--atomic}} オプションはスナップショットの作成が失敗した場合にボリュームに変更が加わっていないことを確認します):

# virsh snapshot-create-as ''domain'' snapshot1 --disk-only --atomic

スナップショットを確認:

{{hc|# virsh snapshot-list ''domain''|<nowiki>
Name Creation Time State
------------------------------------------------------------
snapshot1 2012-10-21 17:12:57 -0700 disk-snapshot
</nowiki>}}

{{ic|1=cp -sparse=true}} や {{ic|rsync -S}} を使ってオリジナルのイメージをコピーしてオリジナルのイメージをスナップショットにマージできます:

# virsh blockpull --domain ''domain'' --path /vms/''domain''.snapshot1

{{ic|domain.snapshot1}} が新しいボリュームになります。マージが完了したらオリジナルのボリューム ({{ic|domain.img}} とスナップショットのメタデータは削除できます。{{ic|virsh blockcommit}} が {{ic|blockpull}} と反対の動作をするようになる予定ですが現在開発中です ({{ic|snapshot-revert}} 機能を含む、来年リリース予定)。

=== 他の管理 ===

非デフォルトのハイパーバイザに接続:

$ virsh --connect xen:///
virsh # uri
xen:///

SSH で QEMU ハイパーバイザに接続してログイン:

$ virsh --connect qemu+ssh://''username''@''host''/system
$ LIBVIRT_DEBUG=1 virsh --connect qemu+ssh://''username''@''host''/system

SSH でグラフィカルコンソールに接続:

$ virt-viewer --connect qemu+ssh://''username''@''host''/system ''domain''
$ virt-manager --connect qemu+ssh://''username''@''host''/system ''domain''

{{Note|(Arch 以外の) RHEL リモートサーバーに接続するときに問題が発生する場合、{{bug|30748}} と {{bug|22068}} に書かれている方法を試してみて下さい。}}

VirtualBox ハイパーバイザに接続 (libvirt における VirtualBox のサポートはまだ安定していないため libvirtd がクラッシュする可能性があります):

$ virsh --connect vbox:///system

ネットワークの設定:

$ virsh -c qemu:///system net-list --all
$ virsh -c qemu:///system net-dumpxml default

== Python 接続コード ==

{{Pkg|libvirt-python}} パッケージによって {{ic|/usr/lib/python2.7/site-packages/libvirt.py}} に {{Pkg|python2}} API が提供されます。

一般的なサンプルは {{ic|/usr/share/doc/libvirt-python-''your_libvirt_version''/examples/}} にあります。

{{Pkg|qemu}} と {{Pkg|openssh}} を使う非公式のサンプル:

#! /usr/bin/env python2
# -*- coding: utf-8 -*-
import socket
import sys
import libvirt
if (__name__ == "__main__"):
<nowiki>conn = libvirt.open("qemu+ssh://xxx/system")</nowiki>
print "Trying to find node on xxx"
domains = conn.listDomainsID()
for domainID in domains:
domConnect = conn.lookupByID(domainID)
if domConnect.name() == 'xxx-node':
print "Found shared node on xxx with ID " + str(domainID)
domServ = domConnect
break

== UEFI サポート ==

Libvirt は QEMU と [https://github.com/tianocore/edk2 OVMF] で UEFI 仮想マシンをサポートしています。

{{Pkg|edk2-ovmf}} パッケージをインストールしてください。

その後 {{ic|libvirtd}} を[[再起動]]してください。

これで UEFI 仮想マシンを作成する準備が整いました。{{Pkg|virt-manager}} で新しい仮想マシンを作成してください。'新しい仮想マシンの作成' ウィザードの最後のページで、以下のようにしてください:

* 'インストールの前に設定をカスタマイズする' をクリックして '完了' を選択してください。
* '概要' タブで 'ファームウェア' フィールドを変更して 'UEFI x86_64' オプションを選択してください。
* 'インストールの開始' をクリックしてください。
* 起動画面で linuxefi コマンドによってインストーラーが起動され、システムの中で efibootmgr を実行することで UEFI OS が実行していることが確認できます。

詳しくは [https://fedoraproject.org/wiki/Using_UEFI_with_QEMU fedora の wiki ページ] を参照。

== PulseAudio ==

[[PulseAudio]] デーモンは通常のユーザーアカウントで動作し、同じユーザーからの接続だけを許可します。[[libvirt]] を使って root で QEMU を動作させた場合は困ることになります。通常ユーザーで QEMU を動作させるには {{ic|/etc/libvirt/qemu.conf}} を編集して {{ic|user}} オプションでユーザー名を指定してください:

user = "dave"

また、PulseAudio バックエンドを使用してサーバーに接続するように QEMU を設定する必要があります。{{ic|virsh edit}} を使ってデーモンの設定に以下のセクションを追加してください:

<qemu:commandline>
<qemu:env name='QEMU_AUDIO_DRV' value='pa'/>
<qemu:env name='QEMU_PA_SERVER' value='/run/user/1000/pulse/native'/>
</qemu:commandline>

{{ic|1000}} はあなたのユーザー ID に置き換えてください。

== 参照 ==

* [http://libvirt.org/drvqemu.html libvirt 公式ウェブサイト]
* [https://access.redhat.com/documentation/ja-JP/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/index.html Red Hat の仮想化の導入および管理ガイド]
* [https://access.redhat.com/documentation/ja-JP/Red_Hat_Enterprise_Linux/7/html/Virtualization_Tuning_and_Optimization_Guide/index.html Red Hat の仮想化のチューニングと最適化ガイド]
* [http://docs.slackware.com/howtos:general_admin:kvm_libvirt Slackware KVM and libvirt]
* [http://www-01.ibm.com/support/knowledgecenter/linuxonibm/liaat/liaatkvm.htm IBM KVM]
* [https://jamielinux.com/docs/libvirt-networking-handbook/ libvirt Networking Handbook]

Rofi

2023-02-06T14:18:02Z

Linuxmetel: /* 既知の問題#インプットメソッド */ インプットメソッドが動作しないことについて

{{DISPLAYTITLE:rofi}}
[[Category:アプリケーションランチャー]]
[[en:Rofi]]
[[pl:Rofi]]
[[pt:Rofi]]
[[ru:Rofi]]
{{Related articles start}}
{{Related|アプリケーション一覧/その他#アプリケーションランチャー}}
{{Related articles end}}

[https://github.com/DaveDavenport/rofi Rofi] は [https://github.com/seanpringle/simpleswitcher simpleswitcher] のクローンとして [https://github.com/seanpringle Sean Pringle] によって開発が始まり [https://github.com/DaveDavenport Dave Davenport] によって拡張されたウィンドウスイッチャ・実行ダイアログ・SSH ランチャです。[[dmenu]] を置き換えることができます。

== インストール ==

[[Xorg]] ディスプレイサーバーで使用する {{Pkg|rofi}} パッケージを [[インストール]] して下さい。

メインブランチの [[Wayland]] コンポジタのマージサポートは、 [https://github.com/davatorium/rofi/pull/1139] で無制限に停止しています。[[Wayland]] をサポートするには、代わりに {{AUR|rofi-lbonn-wayland}} または {{AUR|rofi-lbonn-wayland-git}} をインストールしてください。これらのパッケージには、Layer Shell プロトコルをサポートする Wayland コンポジターが必要であることに注意してください。これには、Sway などの wlroots ベースのコンポジターや一部の Mir ベースのコンポジターが含まれますが、Gnome 用のコンポジターなどの mutter は含まれていません。

rofi とその使用法の詳細については、{{man|1|rofi}} の man ページを参照してください。

== 設定 ==

現在、オプションを設定する方法が三つあります。

* ローカル設定。通常、XDGにより {{ic|~/.config/rofi/config.rasi}} にあります。
* コマンドラインオプション

$ rofi -combi-modi window,drun,ssh -theme solarized -font "hack 10" -show combi

次のような設定ファイルで表します:

configuration {
modi: "window,drun,ssh,combi";
font: "hack 10";
combi-modi: "window,drun,ssh";
}
@theme "solarized"

{{ic|config.rasi}} ファイルのオプション一覧を取得するには {{ic|rofi -dump-config}} を実行してください。{{ic|rofi -dump-config > ~/.config/rofi/config.rasi}} を実行し、直接あなたの {{ic|config}} ファイルに書き込むことができます。

{{Note|i3 の設定にカンマを入れると問題が発生する可能性があるので注意してください。キーをバインドして rofi を起動するには、設定ファイルを使用するか、カンマを {{ic|#}} で置き換えてください。例:{{ic|rofi -combi-modi window#drun#ssh}}}}

=== アイコン ===

アイコンを使用して、対応するエントリとともに表示することができます。 {{pkg|papirus-icon-theme}} がインストールされ、 {{ic|-show-icons}} を使用し、{{ic|-icon-theme}} でアイコンテーマを定義している場合は、次の操作を実行することで、 rofi でアイコンを使用できます。

$ rofi -combi-modi window,drun,ssh -theme solarized -font "hack 10" -show combi -icon-theme "Papirus" -show-icons

== カスタムテーマ ==

以下のコマンドで rofi のテーマのプレビューと適用ができます

rofi-theme-selector

カスタマイズは、{{ic|~/.config/rofi/config.rasi}} ファイルに保存されます。

=== 投稿されたテーマ ===

Rofi にはいくつかの公式テーマが付属しており、[https://github.com/DaveDavenport/rofi-themes rofi-themes] リポジトリにはさらに多くのユーザーテーマがあります。

公式テーマをロードするか、 .rasi ユーザーテーマをダウンロードして、コマンドラインの {{ic|~/.config/rofi/example.rasi}} または構成ファイルに配置します。

rofi <options> -theme example

または構成ファイル内

theme: "example";

== 既知の問題 ==
=== インプットメソッド ===
日本語入力等に用いる[[インプットメソッド]]が rofi 内では上手く動作しません。<nowiki>[</nowiki>[https://github.com/davatorium/rofi/issues/483 rofi issue #483]<nowiki>]</nowiki>, <nowiki>[</nowiki>[https://github.com/davatorium/rofi/pull/1735 rofi pull #1735]<nowiki>]</nowiki> 回避策として、別の場所で書いた文字列をドラックによって選択し、 [[クリップボード#セレクション|PRIMARY セレクション]]を通して Ctrl+Shift+c によって rofi 内に貼り付けることができます。

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

=== Rofi を dmenu の代替として使う ===

[[dmenu]] として (シンボリックリンクを介して) 呼び出された場合、''rofi'' は ''dmenu'' のように機能します。次に、スクリプトから ''dmenu'' を呼び出すプログラム ([[pass]] からの ''passmenu'' など) は、''dmenu'' の代わりに ''rofi'' を使用します。''dmenu'' モードでの {{ic|rofi}} の正確な動作は、{{man|5|rofi-dmenu}} で説明されています。

[[dmenu]] の外観に近づけるために、{{Pkg|rofi}} パッケージにデフォルトで同梱されているファイル {{ic|/usr/share/rofi/themes/dmenu.rasi}} を rofi 構成ディレクトリにコピーします。(通常は {{ic|~/.config/rofi}}) を有効にし、{{ic|config.rasi}} の末尾に {{ic|@theme dmenu}} を追加するか、{{ic|-theme dmenu}} コマンドラインのオプションを追加します。

=== rofi からシェルコマンドを実行 ===

{{ic|-run-shell-command '{terminal} -e ''SHELL'' -ic "{cmd} && read"}} を定義します。{{ic|''SHELL''}} は使用しているシェルです (例:Bash、zsh) これにより、入力バーにコマンドを入力し、続いて {{ic|Shift+Enter}} を入力できます。ターミナルは、次にキーを押すまで開いたままになります。

これは、i3 の推奨されるエスケープシーケンスの例です。

bindsym $mod+d exec --no-startup-id rofi -show drun -run-shell-command '{terminal} -e zsh -ic "{cmd} && read"'

=== Unicode 文字選択の統合 ===

{{Pkg|rofimoji}} は ''rofi'' と統合された Unicode 絵文字/文字選択ピッカーです [https://github.com/fdw/rofimoji#readme 使い方] と [https://github.com/fdw/rofimoji#configuration 設定] については、 [https://github.com/fdw/rofimoji#usage project's README] を参照してください。

=== 絵文字選択メニュー ===

''rofi'' と統合された絵文字ピッカーの {{Pkg|rofi-emoji}} をインストールします。 [https://github.com/Mange/rofi-emoji#readme 使用方法] については、[https://github.com/Mange/rofi-emoji#readme プロジェクトの README] を参照してください。

絵文字に関するレンダリングの問題が発生した場合 (たとえば、長方形としてレンダリング)、される場合 {{AUR|ttf-symbola}}、{{Pkg|noto-fonts-cjk}}、および/または {{Pkg|noto-fonts-emoji}} などをインストールして下さい。

=== 電源管理メニューとしての Rofi ===

Rofi を使用して、systemd で電源管理操作を実行できます。[https://github.com/jluttine/rofi-power-menu rofi-power-menu リポジトリ] をクローンします。これを起動するには、"rofi-power-menu" 実行可能ファイルの場所を rofi に伝える必要があります。たとえば、実行可能ファイルが {{ic|$HOME/.rofi-power-menu}} にある場合:

$ rofi -show p -modi p:$HOME/.rofi-power-menu

実行可能ファイルを PATH に入れ、その名前だけを渡すこともできます。

デフォルトのシンボルを表示するには、{{Pkg|ttf-nerd-fonts-symbols-2048-em}} をインストールする必要がある場合があります。

詳細については、リポジトリの README ファイルを参照してください。

=== クリップボードマネージャーとしての Rofi ===

Rofi は、[[Greenclip]] を使用して X11 クリップボードマネージャーとして使用できます。{{AUR|rofi-greenclip}} パッケージをインストールします。

Greenclip

2023-02-06T10:42:09Z

Linuxmetel: /* 設定例 */ max_selection_size_bytes も設定ファイルに必須のようなので

[[Category:アプリケーションランチャー]]
[[en:Greenclip]]
[[es: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

== 設定 ==

バージョン 4.0 以降では、設定ファイルは {{ic|~/.config/greenclip.toml}} に [[Wikipedia:ja:TOML|TOML]] 形式で置きます。

=== 設定例 ===

{{hc|~/.config/greenclip.toml|<nowiki>
[greenclip]
max_history_length = 250
max_selection_size_bytes = 0
history_file = "~/.cache/greenclip.history"
enable_image_support = true
image_cache_directory = "~/tmp/greenclip"
use_primary_selection_as_input = false
blacklisted_applications = []
trim_space_from_selection = true
# version 4.0 より static history は設定ファイル内
static_history = [
'''¯\_(ツ)_/¯''',
]
</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
}}

Greenclip

2023-02-06T10:31:39Z

Linuxmetel: /* 設定例 */ ファイル名の更新をしていなかったので修正

[[Category:アプリケーションランチャー]]
[[en:Greenclip]]
[[es: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

== 設定 ==

バージョン 4.0 以降では、設定ファイルは {{ic|~/.config/greenclip.toml}} に [[Wikipedia:ja:TOML|TOML]] 形式で置きます。

=== 設定例 ===

{{hc|~/.config/greenclip.toml|<nowiki>
[greenclip]
max_history_length = 250
history_file = "~/.cache/greenclip.history"
enable_image_support = true
image_cache_directory = "~/tmp/greenclip"
use_primary_selection_as_input = false
blacklisted_applications = []
trim_space_from_selection = true
# version 4.0 より static history は設定ファイル内
static_history = [
'''¯\_(ツ)_/¯''',
]
</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
}}

Greenclip

2023-02-06T10:30:56Z

Linuxmetel: /* 設定 */ 先程の編集のリンクにミスがあったので修正

[[Category:アプリケーションランチャー]]
[[en:Greenclip]]
[[es: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

== 設定 ==

バージョン 4.0 以降では、設定ファイルは {{ic|~/.config/greenclip.toml}} に [[Wikipedia:ja:TOML|TOML]] 形式で置きます。

=== 設定例 ===

{{hc|~/.config/greenclip.cfg|<nowiki>
[greenclip]
max_history_length = 250
history_file = "~/.cache/greenclip.history"
enable_image_support = true
image_cache_directory = "~/tmp/greenclip"
use_primary_selection_as_input = false
blacklisted_applications = []
trim_space_from_selection = true
# version 4.0 より static history は設定ファイル内
static_history = [
'''¯\_(ツ)_/¯''',
]
</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
}}

Greenclip

2023-02-06T10:27:51Z

Linuxmetel: /* 設定 */ version 4.0 以降で設定ファイル形式が toml になったので更新

[[Category:アプリケーションランチャー]]
[[en:Greenclip]]
[[es: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

== 設定 ==

バージョン 4.0 以降では、設定ファイルは {{ic|~/.config/greenclip.toml}} に [[ja:TOML|TOML]] 形式で置きます。

=== 設定例 ===

{{hc|~/.config/greenclip.cfg|<nowiki>
[greenclip]
max_history_length = 250
history_file = "~/.cache/greenclip.history"
enable_image_support = true
image_cache_directory = "~/tmp/greenclip"
use_primary_selection_as_input = false
blacklisted_applications = []
trim_space_from_selection = true
# version 4.0 より static history は設定ファイル内
static_history = [
'''¯\_(ツ)_/¯''',
]
</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
}}

デスクトップ環境

2023-01-20T11:11:44Z

Linuxmetel:

[[Category:デスクトップ環境]]
[[Category:ソフトウェア一覧]]
[[en:Desktop environment]]
[[es:Desktop environment]]
[[fa:Desktop environment]]
[[fi:Desktop environment]]
[[it:Desktop environment]]
[[pt:Desktop environment]]
[[ru:Desktop environment]]
[[uk:Desktop environment]]
[[zh-hans:Desktop environment]]
{{Related articles start}}
{{Related|デスクトップ環境の比較}}
{{Related|:Category:Freedesktop.org}}
{{Related articles end}}

[[Wikipedia:ja:デスクトップ環境|デスクトップ環境]] (DE) は、共通のグラフィカルユーザインターフェイス (GUI) を共有するプログラム群で構成される[[Wikipedia:ja:デスクトップ・メタファー|デスクトップ・メタファー]]の実装です。

== 概要 ==

デスクトップ環境は、アイコン、ツールバー、壁紙、デスクトップウィジェットのようなグラフィカルユーザーインターフェイスの一般的な要素を提供する様々なコンポーネントをバンドルしています。さらに、ほとんどのデスクトップ環境には総合的なアプリケーションとユーティリティが含まれています。最も重要なことは、デスクトップ環境は独自の[[ウィンドウマネージャ]]を提供していますが、通常それらは互換性のある他のものに置き換えることができるということです。

ユーザは様々な方法で自由に GUI 環境を構築することができます。デスクトップ環境は、GUI 環境を構築するための完全かつ便利な手段を提供するに過ぎません。ユーザーは複数のデスクトップ環境から自由にアプリケーションを取捨選択することもできます。例えば、[[KDE]] ユーザーは、(KDE の Konqueror ウェブブラウザが気に入らなかった場合) [[Epiphany]] ウェブブラウザなどの [[GNOME]] アプリケーションをインストールできます。このアプローチの欠点は、デスクトップ環境に含まれたアプリケーションの多くは DE 各々のライブラリにかなり依存しているということです。結果として、さまざまなデスクトップ環境からアプリケーションをインストールすると更に大量のライブラリのインストールの必要性を招きます。ディスク容量を節約したいユーザは、このような混合環境を避けたり、外部のライブラリにあまり依存していない代替環境を選んだりします。

なお、デスクトップ環境により提供されているアプリケーションは、それぞれのネイティブ環境にあわせて作られる傾向があります。外観上、異なったウィジェットツールキットがまざった混合環境では外見不一致になることがあります（つまり、インターフェースが別々のアイコン・ウィジェットスタイルを使うことになります）。ユーザーエクスペリエンス上、混合環境は振る舞いが等しくならないかもしれません（例: アイコンのダブルクリックに対するシングルクリック、ドラッグアンドドロップ機能）し混乱や意図しない振る舞いの原因となりえます。

== デスクトップ環境の一覧 ==

=== 公式サポート ===

* {{App|[[Budgie]]|Budgie は最近のユーザーを考慮して設計されたデスクトップ環境で、シンプリシティとエレガンスに焦点を置いています。|https://blog.buddiesofbudgie.org|{{Pkg|budgie-desktop}}}}
* {{App|[[Cinnamon]]|Cinnamon は伝統的なユーザーエクスペリエンスを得られるように力が入れられています。Cinnamon は Gnome 3 のフォークです。|https://github.com/linuxmint/Cinnamon|{{Pkg|cinnamon}}}}
* {{App|Cutefish|Cutefish は新しい、モダンなデスクトップ環境です。|https://cutefish-ubuntu.github.io|{{Grp|cutefish}}}}
* {{App|[[Deepin]]|Deepin デスクトップインターフェイスとアプリは直感的でエレガントなデザインを特徴としています。画面の遷移や共有、検索などをするだけで、喜びを。|https://www.deepin.org/|{{grp|deepin}}}}
* {{App|[[Enlightenment]]|Enlightenment デスクトップシェルは効率的なウィンドウマネージャを提供します。Enlightenment Foundation Libraries による他の重要なデスクトップコンポーネント、ファイルマネージャ、デスクトップアイコン、ウィジェットなども含まれます。テーマ機能を持ちつつ、古いハードウェアや組み込みデバイスでも動きます。|https://www.enlightenment.org/|{{Pkg|enlightenment}}}}
* {{App|[[GNOME]]|GNOME デスクトップ環境は、モダンなセッション (''GNOME'') とクラシックなセッション (''GNOME Classic'') の両方を持つ、魅力的かつ直感的なデスクトップです。|https://www.gnome.org/|{{grp|gnome}}}}
* {{App|[[GNOME Flashback]]|GNOME Flashback は元は GNOME フォールバックモードと呼ばれていた GNOME 3 用のシェルです。デスクトップレイアウトや使っている技術は GNOME2 と似ています。|https://wiki.gnome.org/Projects/GnomeFlashback|{{Pkg|gnome-flashback}}}}
* {{App|[[KDE Plasma]]|KDE Plasma デスクトップ環境は馴染み深い作業環境です。Plasma はモダンなデスクトップコンピューティングに必要なツールをすべて提供するので、使い始めてすぐに生産性を高めることができます。|https://www.kde.org/plasma-desktop|{{grp|plasma}}}}
* {{App|[[LXDE]]|Lightweight X11 Desktop Environment は速くて省エネルギーなデスクトップ環境です。モダンなインターフェース、多言語サポート、標準キーボードショートカットに加えて、タブファイルブラウズなどの付加的な機能を持っています。基礎から軽量にするよう作られているので、LXDE は他の環境よりも CPU や RAM の消費量が少なくみつもれます。|https://lxde.org/|GTK 2: {{grp|lxde}}, GTK 3: {{grp|lxde-gtk3}}}}
* {{App|[[LXQt]]|LXQt は LXDE (Lightweight Desktop Environment) の Qt 移植であり後継バージョンです。LXDE-Qt と Razor-qt のプロジェクトが統合して作られました: 軽量、モジュール式、極めて高速でユーザーフレンドリーなデスクトップ環境です。|https://lxqt.github.io/|{{grp|lxqt}}}}
* {{App|[[MATE]]|伝統的なやりかたを好む Linux ユーザーにとって直感的で魅力的なデスクトップを提供します。GNOME 2 のフォークとして開発が開始されましたが、現在では GTK+ 3 が使われてます。|https://mate-desktop.org/|{{grp|mate}}}}
* {{App|[[Sugar]]|Sugar 学習用プラットフォームは5歳から12歳までの子供たちにリッチメディアを通して勉学の助けにすることを目的とした活動のためのコンピュータ環境です。Sugar は高等な教育の機会をすべての子供に与えるための世界的な支援によって成り立っています。現在では世界中の、40カ国以上、25の言語をしゃべる、100万人近くの子供たちによって使われています。Sugar は現在多くの地域で見過ごされている、質の高い教育を通じて充実した生活をおくれるように人々を手助けしています。|https://sugarlabs.org/|{{Pkg|sugar}} + {{Grp|sugar-fructose}}}}
* {{App|UKUI|UKUI は GTK と Qt をベースに開発されている軽量なデスクトップ環境で、Ubuntu kylin に標準搭載されています。|https://www.ukui.org/|{{Grp|ukui}}}}
* {{App|[[Xfce]]|Xfce は伝統的な [[Wikipedia:ja:UNIX哲学|UNIX 哲学]]、モジュール性と効率性の体現者です。現代的なデスクトップ環境として期待される機能を持った多くのコンポーネントが含まれていますが、どれも比較的に軽量に抑えられています。コンポーネントは分割してパッケージ化され、最適なパーソナル環境を作るために必要なものだけをピックアップすることができます。|https://xfce.org/|{{grp|xfce4}}}}

=== 非公式サポート ===

* {{App|[[CDE]]|Common Desktop Environment は Unix および OpenVMS 用のデスクトップ環境で、Motif ウィジェットツールキットをベースとしています。かつては UNIX98 Workstation Product Standard に含まれており、商用の Unix ワークステーションと一緒に"クラシック"な Unix デスクトップとして長い間使われていました。旧式の環境でありながら、依然として整備されており Linux システムのサポートも続けられています。|https://sourceforge.net/projects/cdesktopenv/|{{AUR|cdesktopenv}}}}
* {{App|[[Equinox Desktop Environment|EDE]]|"Equinox Desktop Environment" はシンプルで極限の軽量・高速を目指して作られている DE です。|https://edeproject.org/|{{AUR|ede}}}}
* {{App|KDE 1|最近のシステムで動作するように移植されました。ほとんどノスタルジアのためですが、今でも実際に動作し、日々の作業環境として利用できます。AUR に KDE 1 のアプリケーションがあり、その数は増えています。|https://invent.kde.org/historical/kde1-kdebase|{{AUR|kde1-kdebase-git}}}}
* {{App|[[Liri]]|Liri は近代的なデザインと機能が特徴のデスクトップ環境です。Liri は [https://github.com/hawaii-desktop Hawaii], [https://github.com/papyros Papyros], [https://github.com/liri-project Liri Project] がマージして生まれました。開発状況はまだ実験的な段階です。|https://liri.io/|{{AUR|liri-shell-git}}}}
* {{App|[[Lumina]]|Lumina は Qt 5 で書かれた FreeBSD 向けの軽量なデスクトップ環境です。ウィンドウの管理には [[Fluxbox]] を使っています。|https://lumina-desktop.org/|{{AUR|lumina-desktop}}}}
* {{App|[[Moksha]]|Enlightenment のフォークで、Ubuntu ベースの Bodhi Linux でデフォルトのデスクトップ環境として使われています。|https://www.bodhilinux.com/moksha-desktop/|{{AUR|moksha-git}}}}
* {{App|[[Pantheon]]|Pantheon は elementary OS ディストリビューションのデフォルトデスクトップ環境として作成されました。Vala と GTK3 ツールキットを使ってゼロから書かれています。ユーザビリティや外観には GNOME Shell や macOS と似通っているところがあります。|https://elementary.io/|{{AUR|pantheon-session-git}}}}
* {{App|PaperDE|Qt/Wayland と wayfire の上に構築されたデスクトップ環境です。|https://cubocore.org/paperde.html|{{AUR|paperde}}}}
* {{App|Phosh|Phosh は GNOME ベースの [[Wayland]] シェルユーザインターフェイスで、モバイル端末で便利です。|https://gitlab.gnome.org/World/Phosh/phosh|{{AUR|phosh}}}}
* {{App|Plasma Mobile|Plasma Mobile はモバイル端末に焦点を当てたデスクトップ環境です。KDE Plasma スタックと [[Wayland]] の上に構築されています。|https://invent.kde.org/plasma/plasma-mobile|{{AUR|plasma-mobile}}}}
* {{App|theDesk|theDesk は、出来る限りユーザーの邪魔をしないように設計されたデスクトップ環境です。ウィジェットツールキットとして Qt 5 を、ウィンドウマネージャとして KWin を使用します。|https://github.com/vicr123/thedesk|{{AUR|thedesk}}}}
* {{App|[[Trinity]]|Trinity Desktop Environment (TDE) プロジェクトは KDE 3.5 のスタイルを維持するという目的から始まった Unix ライクなオペレーティングシステム向けのデスクトップ環境です。|https://www.trinitydesktop.org/|[[Trinity]] を参照}}
* {{App|Maui Shell|Maui Shell は、デスクトップ、タブレット、携帯電話のための収束型シェルです。|https://github.com/Nitrux/maui-shell|{{AUR|maui-shell-git}}}}

== カスタム環境 ==

''完全な''グラフィカル環境を構築するのに一番簡単な方法がデスクトップ環境です。しかし、ユーザーは人気のあるデスクトップ環境（とその依存コンポーネント）を使わずにも様々な方法でグラフィカル環境を作成・カスタマイズすることができます。一般的に、カスタム環境の作成は、最適な[[ウィンドウマネージャ]]や[[Wayland#コンポジタ|コンポジタ]]、[[アプリケーション一覧#タスクバー|タスクバー]]、その他雑多なアプリケーション (最小限度必要なソフトウェアとして[[ターミナルエミュレータ]]、[[アプリケーション一覧#ファイルマネージャ|ファイルマネージャ]]、[[テキストエディタ]]など) の選択によります。

通常デスクトップ環境により提供される他のコンポーネントとしては:

* [[Xorg#コンポジット|デスクトップコンポジタ (Xorg)]]
* [[デスクトップ通知#スタンドアロン|通知デーモン]]
* [[ディスプレイマネージャ#ディスプレイマネージャ一覧|ディスプレイマネージャ]]
* [[アプリケーション一覧#スクリーンロック|スクリーンロッカー]]
* [[アプリケーション一覧#アプリケーションランチャー|アプリケーションランチャー]]
* [[アプリケーション一覧#音量調整|オーディオ制御]]
* [[バックライト#バックライトユーティリティ|バックライト制御]]
* [[MPRIS#コントロールユーティリティ|メディア制御]]
* [[Polkit#認証エージェント|Polkit 認証エージェント]]
* [[電源管理]]
* [[スクリーンショットの取得|スクリーンキャプチャ]]
* [[バックライト#色補正|スクリーンの色温度]]
* [[アプリケーション一覧#壁紙設定|壁紙設定]]
* [[アプリケーション一覧#ログアウトダイアログ| ログアウトダイアログ]]
* [[デフォルトアプリケーション]]

=== 別のウィンドウマネージャを使う ===

使用しているデスクトップ環境の記事が存在する場合、その記事の ''別のウィンドウマネージャを使う'' のセクション (あるいは類似のセクション) を見てください。あるいは、公式のドキュメントを参照してください。

* [[Budgie#別のウィンドウマネージャを使う]]
* [[Cinnamon#別のウィンドウマネージャを使う]]
* [[GNOME#別のウィンドウマネージャを使用する]]
* [[KDE#別のウィンドウマネージャを使う]]
* [[LXDE#別のウィンドウマネージャを使う]]
* [[LXQt#別のウィンドウマネージャを使う]]
* [[MATE#別のウィンドウマネージャを使う]]
* [[Xfce#別のウィンドウマネージャを使う]]

{{TranslationStatus|Desktop environment|2022-08-12|738653}}

SageMath

2022-09-16T15:06:54Z

Linuxmetel: /* TeX Live が SageTex を認識しない場合 */ 改行が入っていなかったので挿入

[[Category:数値解析]]
[[en:SageMath]]
[[ko:SageMath]]
{{Related articles start}}
{{Related|Matlab}}
{{Related|Octave}}
{{Related|Mathematica}}
{{Related articles end}}

[http://www.sagemath.org SageMath] (旧名 '''Sage''') は数式処理や数値計算を行うためのプログラムでメインの言語として [[Python]] を使っています。Maple, Matlab, Mathematica といった商用プログラムの代わりとなることを目指しています。

Sage は以下をサポートしています:
* '''微積分学''': [[Wikipedia:Maxima (software)|Maxima]] と [[Wikipedia:SymPy|SymPy]] を使用。
* '''線形代数''': [[Wikipedia:GNU Scientific Library|GSL]], [[Wikipedia:SciPy|SciPy]], [[Wikipedia:NumPy|NumPy]] を使用。
* '''統計処理''': [[Wikipedia:R (programming language)|R]] (through RPy) と SciPy を使用。
* '''グラフ''': [[Wikipedia:matplotlib|matplotlib]] を使用。
* [[Wikipedia:IPython|IPython]] を使用する'''インタラクティブシェル'''。
* [[Wikipedia:Python Imaging Library|PIL]], [[Wikipedia:SQLAlchemy|SQLAlchemy]] などの '''Python モジュール'''へのアクセス。

== インストール ==

* {{Pkg|sagemath}} にはコマンドラインバージョンが含まれています。
* {{Pkg|sagemath-doc}} には HTML ドキュメントやコマンドラインのインラインヘルプが含まれています。

{{Note|多くの Sage パッケージは、{{pkg|sagemath}} パッケージの [[pacman#パッケージのインストール|オプションの依存関係]] または [[AUR]] で利用できるため、通常の Arch パッケージとして追加でインストールする必要があります。それらの機能の利点。 {{ic|sage -i}} を使用してインストールする必要はないことに注意してください。実際、pacman を使用して SageMath をインストールした場合、このコマンドは機能しません。}}

== 使用方法 ==
Sage は、数値計算用に多少の [http://doc.sagemath.org/html/ja/tutorial/afterword.html#section-mathannoy 改良] が施された Python をスクリプト言語として主に使用します。

=== Sage コマンドライン ===
Sage はコマンドラインから起動できます:
$ sage

Sage コマンドラインに関する情報は [http://doc.sagemath.org/html/en/reference/repl/index.html このページ] を見てください。

コマンドラインは IPython シェルがベースになっていて、Sage では全ての [http://doc.sagemath.org/html/ja/tutorial/interactive_shell.html 設定] を使用することができます。IPython のチュートリアルを読みたい場合はコミュニティによってメンテナンスされている [http://wiki.ipython.org/Cookbook IPython Cookbook] を見てください。

ただし、プロットなど、場合によっては使いづらいことがあります。何かをプロットしたい場合、例えば:
sage: plot(sin,(x,0,10))
Sage は外部アプリケーションでブラウザウィンドウを開きます。

=== Sage Notebook ===
{{Note|SageMath の Flask notebook はメンテナンスモードとなっており Jupyter notebook に置き換わって廃止される予定です。新しいワークシートを作成するときは Jupyter notebook を使うことを推奨します。{{pkg|sage-notebook-exporter}} アプリケーションで Flask ノートブックを Jupyter に変換できます。}}

高度な利用方法で Sage を使うときに適しているインタフェースは Notebook です。コマンドラインから Notebook サーバーを起動するには、次を実行:
$ sage -n

ノートブックは http://localhost:8080 からブラウザでアクセスすることができ、ログインを要求します。

しかしながら、インターネットを介さずにサーバーを個人用に動かしている場合、ログインは面倒です。次のコマンドを使うことで、ログインを必要とせずに、Notebook を起動してブラウザで自動的にポップアップさせることができます:
$ sage -c "notebook(automatic_login=True)"

Sage Notebook に関する完全なチュートリアルは [http://doc.sagemath.org/html/en/reference/notebook/index.html Sage のドキュメント] を見てください。{{ic|notebook()}} コマンドの詳細は [http://doc.sagemath.org/html/en/reference/notebook/index.html このページ] を見てください。

=== Jupyter Notebook ===
SageMath の {{Pkg|sagemath-jupyter}} には [https://jupyter.org/ Jupyter] notebook のカーネルが含まれています。カーネルを使うには、{{Pkg|ipython2-notebook}}{{Broken package link|パッケージが存在しません}} と {{Pkg|mathjax}} をインストールして、次のコマンドで notebook を起動してください:
$ jupyter notebook
そして "New..." ドロップダウンメニューから "SageMath" を選択します。SageMath の Jupyter notebook は {{ic|%display latex}} コマンドを使って [[LaTeX]] で出力することができ {{Pkg|jmol}} がインストールされている場合 3D プロットもサポートします。

=== Cantor ===
[http://edu.kde.org/applications/mathematics/cantor/ Cantor] は KDE Edu Project に含まれているアプリケーションです。Maxima, Sage, Octave, Scilab などの様々な数式処理アプリケーションのフロントエンドとして使うことができます。Cantor で Sage を使用する方法は Sage wiki の [http://wiki.sagemath.org/Cantor Cantor のページ] を見てください。

Cantor は[[公式リポジトリ]]から {{Pkg|cantor}} パッケージでインストールすることができ、このパッケージは {{Grp|kde-applications}} や {{Grp|kde-education}} グループに含まれています。

=== ドキュメント ===
ローカルのドキュメントは HTML や PDF などの複数のフォーマットにコンパイルすることができます。Sage の全てのリファレンスを作成するには、次のコマンドを (root で) 実行してください:
# sage --docbuild reference html

''reference'' ツリー全体の HTML ドキュメントが作成されます (1時間以上かかるかもしれません)。ドキュメントツリーの一部を作成することもできますが、何が必要なのか自分で調べておく必要があります。それまでは、[http://doc.sagemath.org/ オンラインリファレンス] を見るのが良いでしょう。

ドキュメントのリストは {{ic|sage --docbuild --documents}} を見てください。サポートされているフォーマットのリストは {{ic|sage --docbuild --formats}} を見てください。

== 任意のアドオン ==
=== SageTeX ===
システムに [[TeX Live]] をインストールしている場合、[http://doc.sagemath.org/html/ja/tutorial/sagetex.html SageTeX] に興味を覚えるかもしれません。Sage のコードを LaTeX ファイルの中に含めることができるようになるパッケージです。TeX Live は自動的に SageTeX に対応するようになっているので何も考えないで使いはじめることができます。

シンプルな例として、以下は Sage の 2D プロットを TEX ドキュメントに含める例です ({{ic|pdflatex}} を使用するとします):
* ドキュメントの前に {{ic|sagetex}} パッケージを記述
\usepackage{sagetex}

* {{ic|sagesilent}} 環境を作成してコードを挿入:
\begin{sagesilent}
dob(x) = sqrt(x^2 - 1) / (x * arctan(sqrt(x^2 - 1)))
dpr(x) = sqrt(x^2 - 1) / (x * log( x + sqrt(x^2 - 1)))
p1 = plot(dob,(x, 1, 10), color='blue')
p2 = plot(dpr,(x, 1, 10), color='red')
ptot = p1 + p2
ptot.axes_labels(['$\\xi$','$\\frac{R_h}{\\max(a,b)}$'])
\end{sagesilent}

* プロットを作成 (例: {{ic|float}} 環境の中):
\begin{figure}
\begin{center}
\sageplot[width=\linewidth]{ptot}
\end{center}
\end{figure}

* 以下を実行してドキュメントをコンパイル:
$ pdflatex <doc.tex>
$ sage <doc.sage>
$ pdflatex <doc.tex>

* 出力されたドキュメントを確認してください。

SageTeX の完全なドキュメントは [http://www.ctan.org/pkg/sagetex CTAN] にあります。

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

=== TeX Live が SageTex を認識しない場合 ===

TeX Live のインストールで SageTex パッケージが見つからない場合は、以下の手順を試してみてください (root として、またはローカルフォルダを使用します)
* ファイルを texmf ディレクトリにコピーします:
# cp /opt/sage/local/share/texmf/tex/* /usr/share/texmf/tex/
* TeX Liveをリフレッシュする。
* TeX Live をを更新します:

{{bc|
# texhash /usr/share/texmf/
texhash: Updating /usr/share/texmf/.//ls-R...
texhash: Done.
}}

== 参照 ==
* [http://www.sagemath.org/ 公式ウェブサイト]
* [http://doc.sagemath.org/ Sage のドキュメント]
* [http://planet.sagemath.org/ Planet Sage]
* [http://wiki.sagemath.org/ Sage Wiki]
* [http://www.sagemath.org/links-components.html Software Used by Sage]

電源管理

2022-07-18T13:36:38Z

Linuxmetel: /* ACPI イベント */ HUP シグナル送信のコマンドを追加

[[Category:電源管理]]
[[en:Power management]]
[[es:Power management]]
[[it:Shutdown Pressing Power Button]]
[[zh-hans:Power management]]
{{Related articles start}}
{{Related|サスペンドとハイバネート}}
{{Related|Display Power Management Signaling}}
{{Related|CPU 周波数スケーリング}}
{{Related|ハイブリッドグラフィック}}
{{Related|カーネルモジュール}}
{{Related|sysctl}}
{{Related|udev}}
{{Related articles end}}

電源管理とはシステムが使われていない場合に電力の供給を切ったり低電力状態にする機能のことです。このページでは Arch Linux における電源管理の全体的な外観を説明します。

ハードウェアの電源管理の設定を直接変更するときはカーネルの設定を使います:
* [[カーネルパラメータ]]
* [[カーネルモジュール]]
* [[udev]] ルール

また、カーネルと対話してイベントを処理する電源管理ツールが多数あります: [[#ユーザースペースツール]] を参照。

{{Note|ひとつの設定箇所・ツールで設定した電力設定が他の設定箇所・ツールで上書きされる可能性もあるので注意してください。}}

== ユーザースペースツール ==

以下のツールを使うことで手動で多数の設定を行うかわりになります。どのツールも多かれ少なかれ同じような動作をするので、衝突をさけるためにツールはどれか一つだけを実行してください。[[:Category:電源管理|電源管理カテゴリ]]を見ることで Arch Linux にどんな電源管理の選択肢が存在するかわかります。

以下は省電力設定をするために作られた人気のあるスクリプトやツールです:

=== コンソール ===

* {{App|[[acpid]]|ACPI の電源管理イベントを届けるデーモン。netlink をサポート。|https://sourceforge.net/projects/acpid2/|{{pkg|acpid}}}}
* {{App|[[Laptop Mode Tools]]|ノートパソコンの省電力設定をするユーティリティ。多少設定が要りますが省電力設定ユーティリティのデファクトスタンダードとされています。|https://github.com/rickysarraf/laptop-mode-tools|{{AUR|laptop-mode-tools}}}}
* {{App|libsmbios|Dell SMBIOS テーブルを操作するためのライブラリおよびツール。|https://github.com/dell/libsmbios|{{Pkg|libsmbios}}}}
* {{App|[[powertop]]|消費電力や電源管理の問題を診断して省電力設定を補助するツール。|https://01.org/powertop/|{{Pkg|powertop}}}}
* {{App|[[systemd]]|システムおよびサービスマネージャ。|https://freedesktop.org/wiki/Software/systemd/|{{Pkg|systemd}}}}
* {{App|[[TLP]]|Linux 向けの先進的な電源管理。|https://linrunner.de/tlp|{{Pkg|tlp}}}}

=== グラフィカル ===

* {{App|batterymon-clone|シンプルなバッテリモニタートレイアイコン。|https://github.com/jareksed/batterymon-clone|{{AUR|batterymon-clone}}}}
* {{App|batsignal|libnotify を使用してバッテリレベルの低下を警告する軽量バッテリモニタ。|https://github.com/electrickite/batsignal|{{AUR|batsignal}}}}
* {{App|cbatticon|システムトレイにある軽量で高速なバッテリアイコン。|https://github.com/valr/cbatticon|{{Pkg|cbatticon}}}}
* {{App|GNOME power manager|GNOME のシステム電力情報および統計|https://gitlab.gnome.org/GNOME/gnome-power-manager|{{Pkg|gnome-power-manager}}}}
* {{App|KDE Power Devil|Plasma 用の電源管理モジュール。|https://invent.kde.org/plasma/powerdevil|{{Pkg|powerdevil}}}}
* {{App|LXQt Power Management|LXQt 用の電源管理モジュール。|https://github.com/lxqt/lxqt-powermanagement|{{Pkg|lxqt-powermanagement}}}}
* {{App|MATE Power Management|MATE 用電源管理ツール|https://github.com/mate-desktop/mate-power-manager|{{Pkg|mate-power-manager}}}}
* {{App|MATE Power Statistics|MATE のシステム電力情報と統計|https://github.com/mate-desktop/mate-power-manager|{{Pkg|mate-power-manager}}}}
* {{App|powerkit|デスクトップに依存しない電源マネージャー。|https://github.com/rodlie/powerkit|{{AUR|powerkit}}}}
* {{App|Xfce Power Manager|Xfce 用の Power Manager。|https://docs.xfce.org/xfce/xfce4-power-manager/start|{{Pkg|xfce 4-power-manager}}}}
* {{App|vattery|システムトレイ内のラップトップバッテリのステータスを表示する、 Vala で書かれたバッテリ監視アプリケーション。|https://www.jezra.net/projects/vattery.html|{{AUR|vattery}}}}

== systemd による電源管理 ==

=== ACPI イベント ===

''systemd'' は電源関連の [[Wikipedia:Advanced_Configuration_and_Power_Interface|ACPI]] イベントを扱えます。{{ic|/etc/systemd/logind.conf}} や {{ic|/etc/systemd/logind.conf.d/*.conf}} のオプションを使って設定できます。詳細は {{man|5|logind.conf}} も参照して下さい。個別の電源マネージャを持たないシステムでは、この方法は [[acpid]] デーモンの代わりになりえます。ちなみに、[[acpid]] は ACPI イベントに対応するために使われるデーモンです。

定めることができる動作は {{ic|ignore}}, {{ic|poweroff}}, {{ic|reboot}}, {{ic|halt}}, {{ic|suspend}}, {{ic|hibernate}}, {{ic|hybrid-sleep}}, {{ic|suspend-then-hibernate}}, {{ic|lock}}, {{ic|kexec}} のいずれかです。ハイバーネートとサスペンドの場合は [[サスペンドとハイバネート]] を見て適切に設定して下さい。これらの動作が設定されていない場合は、''systemd'' はデフォルトの動作を行います。

{| class="wikitable sortable" border=1
!イベントハンドラ
!説明
!デフォルトの挙動
|-
|{{ic|HandlePowerKey}}
|パワーキーが押された時にトリガされます。
|{{ic|poweroff}}
|-
|{{ic|HandleSuspendKey}}
|サスペンドキーが押された時にトリガされます。
|{{ic|suspend}}
|-
|{{ic|HandleHibernateKey}}
|ハイバーネートキーあるいはボタンが押された時にトリガされます。
|{{ic|hibernate}}
|-
|{{ic|HandleLidSwitch}}
|ラップトップPCなどの蓋が閉じられた時にトリガされます。例外は下を見てください。
|{{ic|suspend}}
|-
|{{ic|HandleLidSwitchDocked}}
|PCがドッキングステーションや他のディスプレイに接続されている状況で、蓋が閉じられた時にトリガされます。
|{{ic|ignore}}
|-
|{{ic|HandleLidSwitchExternalPower}}
|システムが外部電源に接続されている状況で、蓋が閉じられた時にトリガされます。
|{{ic|HandleLidSwitch}}に設定されている動作
|}

変更を適用するには {{ic|systemd-logind}} に対して、 {{ic|HUP}} シグナルを発行して下さい:

# systemctl kill -s HUP systemd-logind

==== 電源マネージャ ====

[[デスクトップ環境]]には電源マネージャが含まれていることがあります。現在のバージョンの systemd では、{{ic|Handle*}} オプションは電源マネージャによって "inhibited" (一時的にオフ) にされない限りシステム全体に適用されます。停止されなければ、systemd がシステムをサスペンドした状態で終わることができ、立ち上がった時に他の電源マネージャによってもう一度停止されます。

最新の [[KDE]], [[GNOME]], [[Xfce]] の電源マネージャは "inhibited" コマンドを実行します。[[acpid]] など他のプログラムで ACPI イベントを管理したい場合は、{{ic|Handle}} オプションを {{ic|ignore}} に設定する必要があります。詳しくは {{man|1|systemd-inhibit}} を参照。

==== xss-lock ====

{{pkg|xss-lock}} は systemd の {{ic|suspend}}, {{ic|hibernate}}, {{ic|lock-session}}, {{ic|unlock-session}} イベントで適切なアクションを実行します (ロッカーの起動など)。''xss-lock'' は [[DPMS]] イベントにも反応します。

xss-lock を[[自動起動]]するときは以下のようなコマンドを使います:

xss-lock -- i3lock -n -i ''background_image.png'' &

xss-lock によってサスペンド時に CPU 消費率が 100% になる場合、[https://bitbucket.org/raymonad/xss-lock/commits/1e158fb20108058dbd62bd51d8e8c003c0a48717 commit 1e158f] にあるように {{AUR|xss-lock-git}} を使うことで問題が解決します。

=== サスペンドとハイバネート ===

''systemd'' はカーネルに入っているサスペンド・レジューム機能を使ってサスペンド (suspend to RAM)・ハイバネート・ハイブリッドサスペンドを行うコマンドを提供しています。また、サスペンドの前後の行動をカスタマイズするフックを追加する仕組みも存在します。

{{Note|''systemd'' はデフォルトの''カーネル''バックエンドに加えて、他のサスペンドバックエンド ([[Uswsusp]]) を使ってコンピュータをサスペンドしたりハイバネートすることもできます。例えば [[Uswsusp#systemd を使う]] を見て下さい。}}

{{ic|systemctl suspend}} は何も設定しなくても動きますが、あなたの環境で {{ic|systemctl hibernate}} を使うには[[サスペンドとハイバネート#ハイバネーション]]の指示に従う必要があります。

==== ハイブリッドスリープ ====

{{ic|systemctl hybrid-sleep}} はハイバネートとサスペンドを同時に行います。サスペンドとハイバネートのメリット・デメリットを組み合わせたものになります。突然コンピュータの電源が喪失 (コンセントが抜けたりバッテリーが切れる) しても、ハイバネートから復帰するため便利です。電源喪失がない場合、サスペンドから復帰するため、ハイバネートから復帰するよりも高速に復帰します。ただし、"hybrid-sleep" はハイバネートを機能させるためにメモリをスワップする必要があるので、普通の {{ic|systemctl suspend}} よりもスリープするのにかかる時間が長くなります。ハイブリッドスリープの別の方法として[[#遅延ハイバネーション|遅延ハイバネーション]]があります。

==== サスペンドやハイバネーションの代わりに常にハイブリッドスリープを使う ====

サスペンドやハイバネートが要求されたときでもハイブリッドスリープを行うように systemd を設定することができます。

デフォルトのサスペンドとハイバネートのアクションは {{ic|/etc/systemd/sleep.conf}} ファイルで設定します。両方ともハイブリッドスリープを実行するように設定するには:

{{hc|/etc/systemd/sleep.conf|2=
[Sleep]
# suspend=hybrid-sleep
SuspendMode=suspend
SuspendState=disk
# hibernate=hybrid-sleep
HibernateMode=suspend
HibernateState=disk
}}

詳しくは {{man|5|sleep.conf.d}} のマニュアルページを読んでください。

=== スリープフック ===

===== サスペンド/リジュームサービスファイル =====

サービスファイルを suspend.target, hibernate.target, sleep.target にフックすることでサスペンド・ハイバネート前後に行うアクションを設定できます。ユーザー・システムアクションを行うにはファイルを分割する必要があります。ユーザーサービスファイルを作動させるには、{{ic|# systemctl enable suspend@<user> && systemctl enable resume@<user>}}。例:

{{hc|/etc/systemd/system/suspend@.service|2=<nowiki>
[Unit]
Description=User suspend actions
Before=sleep.target

[Service]
User=%I
Type=forking
Environment=DISPLAY=:0
ExecStartPre= -/usr/bin/pkill -u %u unison ; /usr/local/bin/music.sh stop ; /usr/bin/mysql -e 'slave stop'
ExecStart=/usr/bin/sflock
ExecStartPost=/usr/bin/sleep 1

[Install]
WantedBy=sleep.target</nowiki>}}

{{hc|/etc/systemd/system/resume@.service|2=<nowiki>
[Unit]
Description=User resume actions
After=suspend.target

[Service]
User=%I
Type=simple
ExecStartPre=/usr/local/bin/ssh-connect.sh
ExecStart=/usr/bin/mysql -e 'slave start'

[Install]
WantedBy=suspend.target</nowiki>}}

{{Note|
* [[アプリケーション一覧/セキュリティ#スクリーンロック|slock]] を使用する場合、スリープする前にサービスを起動してはいけません。デフォルトの simple サービスタイプを使って下さい。でないと、先に ''slock'' が起動して、ロックを解除しないとスリープに入らないようになってしまいます。forking タイプを指定しても解決しません。
* スクリーンがロックされる前にスクリーンロックが返ってきてしまい、サスペンドから復帰するときに画面が点滅することがあります。{{ic|1=ExecStartPost=/usr/bin/sleep 1}} で遅延を追加することで解決します。}}

root アクションでは ({{ic|# systemctl enable root-suspend}} で有効にしてください):

{{hc|/etc/systemd/system/root-resume.service|2=<nowiki>
[Unit]
Description=Local system resume actions
After=suspend.target

[Service]
Type=simple
ExecStart=/usr/bin/systemctl restart mnt-media.automount

[Install]
WantedBy=suspend.target</nowiki>}}

{{hc|/etc/systemd/system/root-suspend.service|2=<nowiki>
[Unit]
Description=Local system suspend actions
Before=sleep.target

[Service]
Type=simple
ExecStart=-/usr/bin/pkill sshfs

[Install]
WantedBy=sleep.target</nowiki>}}

サービスファイルについてのヒント (詳しくは {{man|5|systemd.service}}):
* {{ic|1=<nowiki>Type=oneshot</nowiki>}} の場合、複数の {{ic|1=<nowiki>ExecStart=</nowiki>}} 行を使うことができます。それ以外の場合は使える ExecStart は一行だけです。{{ic|ExecStartPre}} を使ったりコマンドをセミコロンで分割することでコマンドを追加することができます（最初の例を見て下さい -- セミコロンの前後にはスペースが必要です）。
* コマンドの前に '-' を付けるとエラーが起こっても（終了ステータスが0以外でも）無視され、コマンドは成功したとして扱われます。
* サービスファイルのトラブルシューティングのときにエラーを見つけるには [[Systemd#Journal|journalctl]] を使うのがベストです。

===== サスペンド/レジュームサービスファイルの統合 =====

サスペンド/レジュームサービスファイルを統合すれば、様々なフェイズ（スリープ・レジューム）やターゲット（サスペンド・ハイバネート・ハイブリッドスリープ）でやることをひとつのフックで行うことができます。

例と説明:

{{hc|/etc/systemd/system/wicd-sleep.service|2=<nowiki>
[Unit]
Description=Wicd sleep hook
Before=sleep.target
StopWhenUnneeded=yes

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=-/usr/share/wicd/daemon/suspend.py
ExecStop=-/usr/share/wicd/daemon/autoconnect.py

[Install]
WantedBy=sleep.target</nowiki>}}

* {{ic|1=<nowiki>RemainAfterExit=yes</nowiki>}}: 起動後、明示的に止められるまでサービスは常時 active になります。
* {{ic|1=<nowiki>StopWhenUnneeded=yes</nowiki>}}: active のとき、サービスは sleep.target が停止した後に止められます。
* sleep.target は suspend.target, hibernate.target, hybrid-sleep.target から呼ばれ sleep.target 自身は StopWhenUnneeded サービスなので、タスクごとにフックが正しく起動・停止することが保証されています。

==== 遅延ハイバネーション ====

遅延ハイバネーションではスリープフックを利用して通常通りにサスペンドしますが、その後にハイバネーションを実行するタイマーをセットします。ハイバネーションを最初に実行しないためスリープに入るのが {{ic|systemctl hybrid-sleep}} よりも早くなります。ただし、"hybrid-sleep" とは違って、サスペンド中にハイバネーションを使うことで電源喪失から保護するようなことはできません。そのため遅延ハイバネーションはデスクトップなどよりもノートパソコンで使うほうが適しています。ハイバネーションが遅延されるため、サスペンド中はノートパソコンのバッテリーだけが使われ、それからハイバネーションが実行されます。バッテリーがなくなるまでサスペンドし続ける "hybrid-sleep" よりも消費電力を抑えることが可能です。ノートパソコンにハードディスクが搭載されている場合、ハイバネートするためにサスペンドから復帰したとき、ノートパソコンを数秒間は動かさないほうがよいでしょう。遅延ハイバネーションは消費電力だけでなくセキュリティに関しても利点があります (例: 完全なディスク暗号化を使っている場合)。サンプルスクリプトは [https://superuser.com/questions/298672/linuxhow-to-hibernate-after-a-period-of-sleep こちら] にあります。systemd のスリープフックについては [https://bbs.archlinux.org/viewtopic.php?pid=1420279#p1420279 こちらの投稿] も参照してください。

{{hc|/etc/systemd/system/suspend-to-hibernate.service|<nowiki>
[Unit]
Description=Delayed hibernation trigger
Documentation=https://bbs.archlinux.org/viewtopic.php?pid=1420279#p1420279
Documentation=https://wiki.archlinux.org/index.php/Power_management
Conflicts=hibernate.target hybrid-sleep.target
Before=sleep.target
StopWhenUnneeded=true

[Service]
Type=oneshot
RemainAfterExit=yes
Environment="WAKEALARM=/sys/class/rtc/rtc0/wakealarm"
Environment="SLEEPLENGTH=+2hour"
ExecStart=-/usr/bin/sh -c 'echo -n "alarm set for "; date +%%s -d$SLEEPLENGTH | tee $WAKEALARM'
ExecStop=-/usr/bin/sh -c '\
alarm=$(cat $WAKEALARM); \
now=$(date +%%s); \
if [ -z "$alarm" ] || [ "$now" -ge "$alarm" ]; then \
echo "hibernate triggered"; \
systemctl hibernate; \
else \
echo "normal wakeup"; \
fi; \
echo 0 > $WAKEALARM; \
'

[Install]
WantedBy=sleep.target
</nowiki>
}}

{{ic|Before}} と {{ic|Conflicts}} オプションはハイバネートでは動作させないようにするために必要です。そうしないと遅延ハイバネーションが実行されたときにサービスが2回実行されてしまいます。{{ic|WantedBy}} と {{ic|StopWhenUnneeded}} オプションはスリープの前に実行して復帰時に停止するように設定しています。サービスを[[有効化]]してください。

==== /usr/lib/systemd/system-sleep のフック ====

Systemd は {{ic|/usr/lib/systemd/system-sleep/}} 内の全ての実行可能ファイルを実行するときに、2つの引数を渡します:

* 引数 1: {{ic|pre}} か {{ic|post}}。マシンが停止するときと起動するとき。
* 引数 2: {{ic|suspend}} か {{ic|hibernate}} か {{ic|hybrid-sleep}}。呼び出されるものによる。

systemd はスクリプトを（ひとつずつではなく）同時に実行します。

カスタムスクリプトの出力は {{ic|systemd-suspend.service}}, {{ic|systemd-hibernate.service}}, {{ic|systemd-hybrid-sleep.service}} によって記録されます。出力を見るには systemd の [[Systemd#Journal|journal]] を使って下さい:
# journalctl -b -u systemd-suspend

{{Note|カスタムスクリプトを使うかわりに {{ic|sleep.target}}, {{ic|suspend.target}}, {{ic|hibernate.target}}, {{ic|hybrid-sleep.target}} を使ってユニットをスリープステートロジックにフックさせることもできます。}}

カスタムスリープスクリプトの例:

{{hc|/usr/lib/systemd/system-sleep/example.sh|
#!/bin/sh
case $1/$2 in
pre/*)
echo "Going to $2..."
;;
post/*)
echo "Waking up from $2..."
;;
esac}}

スクリプトを実行可能にするのを忘れないで下さい:
# chmod a+x /usr/lib/systemd/system-sleep/example.sh

詳しくは {{man|7|systemd.special}} や {{man|8|systemd-sleep}} を見てください。

== 省電力設定 ==

{{Note|[[ノートパソコン#電源管理]]ではノートパソコンでの電源管理（特にバッテリー状態の監視）を説明しています。}}

このセクションでは省電力機能を使用するのに必要な設定を扱います。コンピュータが AC 電源またはバッテリーで動作しているかに関わらず、ここに記載されているほとんど全ての機能には使用する価値があります。パフォーマンスへの影響は軽微ですが、大抵壊れているハードウェアやドライバーのためにデフォルトでは有効になっていません。電力の使用量を減らすことは熱を減らすことでもあり、[[Wikipedia:ja:インテルターボ・ブースト・テクノロジー|動的なオーバークロック]]によって、最近の Intel や AMD の CPU ではパフォーマンスの向上につながることもあります。

udev ルールなどを使ってスクリプトや省電力設定を自分で作成したい場合は以下の設定を参考にすることができます。

{{Note|以下で記述しているルールのほとんどは [[TLP]] などのツールで管理することもでき、ツールを使いながら自分でも管理するのは不得策です。}}

=== オーディオ ===

デフォルトでは、オーディオの省電力機能はほとんどのドライバーで無効になっています。{{ic|power_save}} パラメータを設定することで有効にすることができます。アイドルモードに移行するまでの時間を秒数で指定します。1秒後にサウンドカードをアイドル状態にするには、Intel の場合、以下を作成:

{{hc|/etc/modprobe.d/audio_powersave.conf|2=options snd_hda_intel power_save=1}}

ac97 の場合は以下を使って下さい:

options snd_ac97_codec power_save=1

{{Note|
* サウンドカードの製造者や使われているカーネルドライバーの情報を取得するには、{{ic|lspci -k}} を実行してください。
* サウンドカードの電源状態を変更すると壊れたハードウェアでポップノイズがまじったり著しい遅延が発生することがあります。
}}

HDMI の音声出力を無効化することで消費電力を下げることもできます。適切なカーネルモジュールを[[ブラックリスト]]に追加してください (例: {{ic|snd_hda_codec_hdmi}})。

=== バックライト ===

[[バックライト]]を見て下さい。

=== Bluetooth ===

[[Bluetooth]] を完全に無効化するには、{{ic|btusb}} と {{ic|bluetooth}} モジュールを[[カーネルモジュール#ブラックリスト|ブラックリスト]]に入れてください。

一時的にだけ bluetooth をオフにするには、''rfkill'' を使用します:

# rfkill block bluetooth

もしくは udev ルールを使って:

{{hc|/etc/udev/rules.d/50-bluetooth.rules|<nowiki>
# disable bluetooth
SUBSYSTEM=="rfkill", ATTR{type}=="bluetooth", ATTR{state}="0"
</nowiki>}}

=== ウェブカメラ ===

内蔵のウェブカメラを使わない場合、{{ic|uvcvideo}} モジュールを[[カーネルモジュール#ブラックリスト|ブラックリスト]]に入れてください。

=== カーネルパラメータ ===

このセクションでは {{ic|/etc/sysctl.d/}} の設定を使います。このディレクトリはカーネルの sysctl パラメータと対応するディレクトリです。詳しくは [http://0pointer.de/blog/projects/the-new-configuration-files The New Configuration Files] や、より正確な {{man|5|sysctl.d}} を見てください。

==== NMI watchdog の無効化 ====

[[Wikipedia:Non-maskable interrupt|NMI]] watchdog はカーネルパニックを引き起こすハードウェアのハングアップをキャッチするデバッグ機能です。システムによっては大量の割り込みが発生するため、消費電力の増加につながっていることがあります:

{{hc|/etc/sysctl.d/disable_watchdog.conf|2=kernel.nmi_watchdog = 0}}

もしくは起動の初期で完全に無効化するには[[カーネルパラメータ|カーネル行]]に {{ic|1=nmi_watchdog=0}} を追加してください。

==== ライトバック時間 ====

仮想メモリのダーティなライトバック時間を増やすことでディスク I/O がまとめられて、断続的なディスクの書き込みが減って、消費電力が抑えられます。この値を60秒に設定するには (デフォルトは5秒です):

{{hc|/etc/sysctl.d/dirty.conf|2=vm.dirty_writeback_centisecs = 6000}}

ジャーナルをサポートしているファイルシステム (ext4 や btrfs など) でジャーナルコミットでも同じことをするには、[[fstab]] でオプションとして {{ic|1=commit=60}} を使用します。

I/O パフォーマンスや省電力に影響する他のパラメータは [[sysctl#仮想メモリ]] を参照。

==== Laptop Mode ====

ラップトップモードの'ノブ'については[https://www.kernel.org/doc/Documentation/laptops/laptop-mode.txt カーネルドキュメント]を見て下さい。''"このノブの適切な値は5秒です。"''

{{hc|/etc/sysctl.d/laptop.conf|2=vm.laptop_mode = 5}}

=== ネットワークインターフェイス ===

[[Wake-on-LAN]] は便利な機能ですが、利用しない場合はサスペンド中にマジックパケットが来るのを待つのに無駄な電力を消耗するだけです。全ての Ethernet インターフェイスで Wake-on-LAN を無効化:

{{hc|/etc/udev/rules.d/70-disable_wol.rules|2=ACTION=="add", SUBSYSTEM=="net", KERNEL=="eth*", RUN+="/usr/bin/ethtool -s %k wol d"}}

全ての無線インターフェイスで省電力機能を有効にするには:

{{hc|/etc/udev/rules.d/70-wifi-powersave.rules|2=ACTION=="add", SUBSYSTEM=="net", KERNEL=="wlan*", RUN+="/usr/bin/iw dev %k set power_save on"}}

上記の例では、{{ic|%k}} がマッチするデバイスのカーネル名を示します。例えば、ルールが {{ic|wlan0}} に適用可能とわかった場合、{{ic|%k}} は {{ic|wlan0}} に置き換えられます。特定のインターフェイスにだけルールを適用するには、パターン {{ic|eth*}} と修飾子 {{ic|%k}} を適当なインターフェイスの名前に置き換えて下さい。詳しくは、[http://www.reactivated.net/writing_udev_rules.html Writing udev rules] を参照。

{{Note|ここで、設定ファイルの名前は重要です。systemd v197 から {{ic|80-net-setup-link.rules}} によって[[ネットワーク設定#デバイス名|永続的なデバイス名]]が導入されたため、デバイスに {{ic|enp2s0}} というような名前で呼ばれるようになる前に適用されるように、ネットワークの powersave ファイルは辞書順で {{ic|80-net-setup-link.rules}} よりも前に来る名前を付けなくてはなりません。}}

==== Intel ワイヤレスカード (iwlwifi) ====

Intel 製ワイヤレスカードの省電力機能は {{ic|iwlwifi}} ドライバーに適切なパラメータを渡すことで有効にできます。{{ic|/etc/modprobe.d/iwlwifi.conf}} ファイルに以下の行を追加することで永続的に有効にできます:

options iwlwifi power_save=1 d0i3_disable=0 uapsd_disable=0
options iwldvm force_cam=0

上記の省電力オプションは実験的であり、システムが不安定になる可能性があります。

=== バスパワーの管理 ===

==== Active State Power Management ====

コンピュータが [[Wikipedia:Active State Power Management|ASPM]] をサポートしているという信頼が得られなかった場合、起動時に無効化されます:

$ lspci -vv | grep ASPM.*abled\;

ASPM は BIOS によって扱われるため、ASPM が無効化される理由は以下の通りです [https://wireless.kernel.org/en/users/Documentation/ASPM]:

# BIOS が何らかの理由で ASPM を無効化した (コンフリクトが起こるから？)。
# PCIE が L0s 以外の ASPM を必要とする (L0s は無効化され L1 だけが有効化される)。
# ASPM について BIOS がプログラムされていない。
# BIOS にバグが存在する。

コンピュータが ASPM をサポートしていると信じられる場合は、{{ic|1=pcie_aspm=force}} [[カーネルパラメータ]]を使うことで強制的にオンにすることができます。

{{Warning|
* ASPM を強制するとフリーズやパニックが発生することがあります。ASPM が動作しなかったときにオプションを戻す手段があるか確認してください。
* ASPM をサポートしていないシステムで強制させると消費電力が逆に上昇することがあります。
}}

{{ic|powersave}} に調整するには次を実行 (以下のコマンドは ASPM が有効になっていないと機能しません):

echo powersave | tee /sys/module/pcie_aspm/parameters/policy

デフォルトでは以下のようになります:

{{hc|$ cat /sys/module/pcie_aspm/parameters/policy|[default] performance powersave}}

==== PCI Runtime Power Management ====

{{hc|/etc/udev/rules.d/pci_pm.rules|2=ACTION=="add", SUBSYSTEM=="pci", ATTR{power/control}="auto"}}

==== デバイスの電源管理 ====

''USB を含む''、(ほぼ) 全てのデバイスの電源管理を有効化:

{{hc|/etc/udev/rules.d/dev_power_save.rules|<nowiki>
# Various subsystems runtime power management (by bus or class)
ACTION=="add", SUBSYSTEMS=="*", TEST=="power/control", ATTR{power/control}="auto"

# Various subsystems power saving (by module)
ACTION=="add", SUBSYSTEMS=="*", TEST=="parameters/power_save", ATTR{parameters/power_save}="1" </nowiki>}}

影響を受けるデバイスを表示するには:
ls /sys/bus/*/devices/*/power/control
ls /sys/class/*/*/power/control
ls /sys/module/*/parameters/power_save

''USB を除く''全てのシステムで電源管理を有効にするには、最初のルールをサブシステムごとのルールに置き換えます (/sys/bus/''some_subsystem'', /sys/class/''some_subsystem''):
ACTION=="add", SUBSYSTEM=="some_subsystem", TEST=="power/control", ATTR{power/control}="auto"

==== USB の自動サスペンド ====

Linux カーネルは USB デバイスが使用されていないときに USB デバイスを自動的にサスペンドさせることができます。これによって電力を相当カットできるときもありますが、USB の省電力機能に対応していない USB デバイスではおかしな挙動が起こる可能性もあります (特に USB マウスやキーボード)。ホワイトリストとブラックリストでフィルタリングする [[udev]] ルールを使うことで問題は軽減されます。

最も単純であまり役に立たない、全ての USB デバイスで自動サスペンドを有効にする例:

{{hc|/etc/udev/rules.d/50-usb_power_save.rules|<nowiki>
ACTION=="add", SUBSYSTEM=="usb", TEST=="power/control", ATTR{power/control}="auto"
</nowiki>}}

自動サスペンドが動作するデバイスにだけ自動サスペンドを有効にするには、ベンダーとプロダクト ID でマッチングを行います (''lsusb'' を使って値を取得):

{{hc|/etc/udev/rules.d/50-usb_power_save.rules|<nowiki>
# whitelist for usb autosuspend
ACTION=="add", SUBSYSTEM=="usb", TEST=="power/control", ATTR{idVendor}=="05c6", ATTR{idProduct}=="9205", ATTR{power/control}="auto"
</nowiki>}}

もしくは、USB 自動サスペンドが使えないデバイスをブラックリストに入れて、他の全てのデバイスで自動サスペンドを有効にするには:

{{hc|/etc/udev/rules.d/50-usb_power_save.rules|<nowiki>
# blacklist for usb autosuspend
ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="05c6", ATTR{idProduct}=="9205", GOTO="power_usb_rules_end"

ACTION=="add", SUBSYSTEM=="usb", TEST=="power/control", ATTR{power/control}="auto"
LABEL="power_usb_rules_end"
</nowiki>}}

自動サスペンドに入るデフォルトのアイドル遅延時間は {{ic|usbcore}} [[カーネルモジュール]]の {{ic|autosuspend}} パラメータによって制御されています。遅延時間をデフォルトの2秒から5秒に設定するには:

{{hc|/etc/modprobe.d/usb-autosuspend.conf|<nowiki>
options usbcore autosuspend=5
</nowiki>}}

{{ic|power/control}} と同じように、{{ic|power/autosuspend}} 属性を設定することで遅延時間はデバイスごとに細かく設定することができます。

USB の電源管理に関する詳細は [https://www.kernel.org/doc/Documentation/usb/power-management.txt Linux カーネルドキュメント]を見て下さい。

==== SATA Active Link Power Management ====

{{Note|以下の設定を行うとアイドル状態になっているドライブにアクセスするときに遅延が発生するようになります。AC 電源を使用するかどうかによって変えるべき設定です。}}

{{hc|/etc/udev/rules.d/hd_power_save.rules|2=ACTION=="add", SUBSYSTEM=="scsi_host", KERNEL=="host*", ATTR{link_power_management_policy}="min_power"}}

{{Warning|デバイスによっては SATA Active Link Power Management でデータが消失する可能性があります (例: [[Lenovo ThinkPad T440s|Lenovo T440s]] はこの問題を抱えていることが[http://lkml.indiana.edu/hypermail/linux/kernel/1401.2/02171.html 知られています])。バックアップを取っていない場合は設定を有効にしないでください。}}

=== ハードディスクドライブ ===

設定できるドライブのパラメータについては [[hdparm]] を見て下さい。

多数のプログラムがディスクに頻繁に書き込みをおこなう場合は省電力は効率的ではありません。全てのプログラムを調査して、いつどのようにプログラムがディスクに書き込むを行うのか調べるのがディスクの使用量を減らす道です。{{Pkg|iotop}} を使えばどのプログラムがディスクに頻繁に書き込みしているかわかります。他のヒントは[[ソリッドステートドライブ#SSD の読み書きを最小化するヒント]]を見て下さい、ほとんどのヒントは SSD に限ったものではありません。

[[Fstab#atime オプション|noatime]] オプションを設定するなどの小さなことも馬鹿にできません。十分な RAM がある場合、[[スワップ#Swappiness|swappiness]] を無効化したり制限することでディスクへの書き込みが減る可能性があります。

=== CD/DVD のスピンダウン ===

[[udisks]] を使用してしばらくしてから CD/DVD ロムをスピンダウンさせるには:

# udisks --inhibit-polling /dev/sr0

== ツールとスクリプト ==

=== スクリプトと udev ルールを使う ===

systemd ユーザーは {{ic|systemctl suspend}} や {{ic|systemctl hibernate}} でサスペンドとハイバネートを行うことができ、{{ic|/etc/systemd/logind.conf}} で acpi イベントを処理することができるので、[[pm-utils]] と [[acpid]] を削除するということに興味を引かれるかもしれません。systemd が行えないことがたったひとつだけ存在します (systemd-204 現在): システムが AC 電源またはバッテリーで動作しているのかで別れる電源管理です。このギャップをなくすには、AC アダプタが抜き差しされたときにスクリプトを実行する [[udev]] ルールを作成します:

{{hc|/etc/udev/rules.d/powersave.rules|2=<nowiki>
SUBSYSTEM=="power_supply", ATTR{online}=="0", RUN+="/path/to/your/script true"
SUBSYSTEM=="power_supply", ATTR{online}=="1", RUN+="/path/to/your/script false"
</nowiki>}}

{{Note|''pm-powersave'' が使用しているのと同じスクリプトを使うことができます。実行可能属性を付与して別の所に保存する必要があります (例えば {{ic|/usr/local/bin/}})。}}

powersave スクリプトのサンプル: [[powerdown]], [https://github.com/Unia/powersave powersave]。

上記の udev ルールはちゃんと動作するはずですが、電源設定がサスペンドやハイバネートをした後に更新されない場合、以下の内容で {{ic|/usr/lib/systemd/system-sleep/}} にスクリプトを追加してください:

{{hc|/usr/lib/systemd/system-sleep/00powersave|<nowiki>
#!/bin/sh

case $1 in
pre) /path/to/your/script false ;;
post)
if cat /sys/class/power_supply/AC0/online | grep 0 > /dev/null 2>&1
then
/path/to/your/script true
else
/path/to/your/script false
fi
;;
esac
exit 0
</nowiki>}}

忘れずに実行可能属性を付与してください。

{{Note|あなたのノートパソコンでは AC0 が異なっている可能性があります。その場合は変更してください。}}

=== 電源設定の表示 ===

以下のスクリプトは USB や PCI デバイスの電源設定などのプロパティを表示します。全ての設定を見るには root 権限が必要なので注意して下さい。

{{bc|<nowiki>
#!/bin/bash

for i in $(find /sys/devices -name "bMaxPower")
do
busdir=${i%/*}
busnum=$(<$busdir/busnum)
devnum=$(<$busdir/devnum)
title=$(lsusb -s $busnum:$devnum)

printf "\n\n+++ %s\n -%s\n" "$title" "$busdir"

for ff in $(find $busdir/power -type f ! -empty 2>/dev/null)
do
v=$(cat $ff 2>/dev/null|tr -d "\n")
[[ ${#v} -gt 0 ]] && echo -e " ${ff##*/}=$v";
v=;
done | sort -g;
done;

printf "\n\n\n+++ %s\n" "Kernel Modules"
for mod in $(lspci -k | sed -n '/in use:/s,^.*: ,,p' | sort -u)
do
echo "+ $mod";
systool -v -m $mod 2> /dev/null | sed -n "/Parameters:/,/^$/p";
done
</nowiki>}}

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

=== フタのスイッチのアクションの遅延 ===

短期間に連続してフタのスイッチが反応した場合、''logind'' はドッキングを検出するために90秒までサスペンドを遅延します [https://lists.freedesktop.org/archives/systemd-devel/2015-January/027131.html]。この遅延時間は systemd v220 から設定ができます [https://cgit.freedesktop.org/systemd/systemd/commit/?id=9d10cbee89ca7f82d29b9cb27bef11e23e3803ba]:

{{hc|/etc/systemd/logind.conf|<nowiki>
...
HoldoffTimeoutSec=30s
...
</nowiki>}}

=== ノートパソコンをサスペンドする Fn キーが動作しない ===

{{ic|logind.conf}} をどう設定してもスリープボタンが動作しない場合 (ボタンを押しても syslog にメッセージすら表示されない)、おそらく logind がキーボードデバイスを監視していません [https://lists.freedesktop.org/archives/systemd-devel/2015-February/028325.html]。次のコマンドを実行してください:
# journalctl | grep "Watching system buttons"
すると以下のような表示がされます:
May 25 21:28:19 vmarch.lan systemd-logind[210]: Watching system buttons on /dev/input/event2 (Power Button)
May 25 21:28:19 vmarch.lan systemd-logind[210]: Watching system buttons on /dev/input/event3 (Sleep Button)
May 25 21:28:19 vmarch.lan systemd-logind[210]: Watching system buttons on /dev/input/event4 (Video Bus)
キーボードデバイスがないことに気づいて下さい。したがってキーボードデバイスの ATTRS{name} を取得します [http://systemd-devel.freedesktop.narkive.com/Rbi3rjNN/patch-1-2-logind-add-support-for-tps65217-power-button]:
# udevadm info -a /dev/input/by-path/*-kbd
...
KERNEL=="event0"
...
ATTRS{name}=="AT Translated Set 2 keyboard"
カスタム udev ルールを作成して "power-switch" タグを追加:
{{hc|/etc/udev/rules.d/70-power-switch-my.rules|<nowiki>
ACTION=="remove", GOTO="power_switch_my_end"
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{name}=="AT Translated Set 2 keyboard", TAG+="power-switch"
LABEL="power_switch_my_end"
</nowiki>}}
サービスを再起動してルールをリロードしてください:
# systemctl restart systemd-udevd
# udevadm trigger
# systemctl restart systemd-logind
これで syslog に {{ic|Watching system buttons on /dev/input/event0}} と表示されるようになるはずです。

== 参照 ==

* [https://www.thinkwiki.org/wiki/How_to_reduce_power_consumption ThinkWiki:How to reduce power consumption]
* [http://ivanvojtko.blogspot.sk/2016/04/how-to-get-longer-battery-life-on-linux.html How to get longer battery life on Linux]

利用者:Linuxmetel

2022-07-03T08:16:52Z

Linuxmetel:

Twitter: https://twitter.com/linuxmetel <br>
GitHub: https://github.com/linuxmetel

利用者:Linuxmetel

2022-07-03T08:16:35Z

Linuxmetel:

Twitter: https://twitter.com/linuxmetel
GitHub: https://github.com/linuxmetel

Mkinitcpio

2022-06-29T14:36:19Z

Linuxmetel: 自動検出ではなく autodetect の方が適切と思われる部分の修正

{{Lowercase title}}
[[Category:initramfs]]
[[Category:カーネル]]
[[Category:Arch プロジェクト]]
[[Category:コマンド]]
[[da:Mkinitcpio]]
[[de:Mkinitcpio]]
[[en:Mkinitcpio]]
[[es:Mkinitcpio]]
[[fr:mkinitcpio]]
[[id:Mkinitcpio]]
[[it:Mkinitcpio]]
[[ru:Mkinitcpio]]
[[zh-hans:Mkinitcpio]]
{{Related articles start}}
{{Related|Booster}}
{{Related|ブートデバッグ}}
{{Related|dracut}}
{{Related|カーネルモジュール}}
{{Related|initramfs の最小化}}
{{Related|systemd}}
{{Related articles end}}

[https://projects.archlinux.org/mkinitcpio.git/ mkinitcpio] は [[Wikipedia:Initial ramdisk|initial ramdisk]] 環境を作成するために使われる Bash スクリプトです。{{man|8|mkinitcpio}} より:

:''initial ramdisk は非常に小さい環境（初期ユーザー空間）であり、様々なカーネルモジュールをロードして [[init]] にコントロールを移す前に必要なことをセットアップします。これにより、root ファイルシステムを暗号化したりソフトウェア RAID アレイに root を載せることが可能になります。mkinitcpio はカスタムフックによって簡単に拡張することができ、自動時の自動検知など様々な機能を持っています。''

伝統的には、[[Arch ブートプロセス|ブートプロセス]]の初めにハードウェアを検知したりタスクの初期化を行うのはカーネルで、それから root ファイルシステムがマウントされ {{ic|init}} にコントロールが移されます。しかしながら、先端技術が生まれるにつれ、こういった作業は複雑になりつつあります。

今日、root ファイルシステムが載るハードウェアは SCSI から SATA、USB ドライブまで様々にわたり、それらハードウェアはそれぞれのマニュファクチャーによって作られたいろんなドライブコントローラによってコントロールされています。しかも、root ファイルシステムは暗号化されたり圧縮されたりする可能性もあります; ソフトウェア RAID アレイや論理ボリュームグループに含まれるかもしれません。複雑になったものをシンプルに扱う方法はユーザースペースへ管理を譲渡することです。
参照: [https://web.archive.org/web/20150430223035/http://archlinux.me/brain0/2010/02/13/early-userspace-in-arch-linux/ /dev/brain0 » Blog Archive » Early Userspace in Arch Linux]。

mkinitcpio は Arch Linux デベロッパーとコミュニティの貢献によって開発されています。[https://projects.archlinux.org/mkinitcpio.git/ Git リポジトリ]を見て下さい。

== インストール ==

{{Pkg|mkinitcpio}} パッケージは[[公式リポジトリ]]で利用可能で {{Pkg|linux}} パッケージの依存パッケージになっています。

上級者は {{AUR|mkinitcpio-git}} パッケージで mkinitcpio の最新開発バージョンをインストールできます。

{{Note|Git から mkinitcpio を使う時は [https://lists.archlinux.org/listinfo/arch-projects arch-projects メーリングリスト]を購読することが''強く''推奨されます！}}

== イメージ作成とアクティベーション ==

=== 自動生成 ===

カーネルがインストールまたはアップグレードされるたびに、[https://wiki.archlinux.jp/index.php/Pacman#.E3.83.95.E3.83.83.E3.82.AF pacman フック] は {{ic|/etc/mkinitcpio.d/}} に保存されている ''.preset'' ファイルを自動的に生成します。たとえば、公式の安定した {{Pkg|linux}} カーネルパッケージの場合は {{ic|linux.preset}} です。プリセットは、さまざまなパラメーターや出力ファイルの場所を手動で指定するのではなく、初期ramdiskイメージを作成するために必要な情報のリストです。
デフォルトでは、2つのイメージを作成するための手順が含まれています。

# mkinitcpio [[#設定]] で指定されたディレクティブに従って作成された ''デフォルト'' の RAM ディスクイメージ、および
# ''フォールバック'' RAM ディスクイメージ。作成時に ''autodetect'' フックがスキップされることを除いて上記と同じであるため、ほとんどのシステムをサポートするすべてのモジュールが含まれます。

プリセットを作成した後、pacman フックは、プリセットで提供された情報を使用して2つのイメージを生成する ''mkinitcpio'' スクリプトを呼び出します。

{{Note|''.preset'' ファイルは、カーネルの更新後に initramfs を自動的に再生成するために使用されます。編集するときは注意してください。}}

=== 手動生成 ===

スクリプトを手動で実行するには、手順について {{man|8|mkinitcpio}} のマニュアルページを参照してください。特に、カーネルパッケージによって提供されるプリセットを(再)生成するには、 {{ic|-p}}/{{ic|--preset}} オプションを使用してから、使用するプリセットを使用します。たとえば、 {{Pkg|linux}} パッケージの場合、次のコマンドを使用します。

# mkinitcpio -p linux

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

# mkinitcpio -P

ユーザーは、さまざまな構成で initramfs イメージをいくつでも作成できます。目的のイメージは、それぞれの [[ブートローダー]] 設定ファイルで指定する必要があります。

=== カスタマイズされた生成 ===

ユーザーは、代替の設定ファイルを使用してイメージを生成できます。たとえば、次の例では、 {{ic|/etc/mkinitcpio-custom.conf}}の指示に従って初期ramdiskイメージを生成し、 {{ic|/boot/initramfs-custom.img}} として保存します。

# mkinitcpio --config /etc/mkinitcpio-custom.conf --generate /boot/initramfs-custom.img

現在実行中のカーネル以外のカーネルのイメージを生成する場合は、カーネルリリースバージョンをコマンドラインに追加します。インストールされているカーネルリリースは {{ic|/usr/lib/modules/}} にあり、構文は各カーネルのコマンド{{ic|uname-r}} の出力と一致しています。

# mkinitcpio --generate /boot/initramfs-custom2.img --kernel 5.7.12-arch1-1

=== Unified カーネルイメージ ===

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

== 設定 ==

''mkinitcpio'' の基本の設定ファイルは {{ic|/etc/mkinitcpio.conf}} です。さらに、カーネルパッケージによって提供されるプリセット定義が {{ic|/etc/mkinitcpio.d}} ディレクトリにあります (例: {{ic|/etc/mkinitcpio.d/linux.preset}})。

{{Warning|デフォルトでは ''lvm2'', ''mdadm'', ''encrypt'' は有効化されていません。これらのフックが必要なときは注意してこのセクションを読んで下さい。}}

{{Note|ノード名が同一でカーネルモジュールが異なる複数のディスクコントローラを使っている場合 (例: 2つの SCSI/SATA または2つの IDE コントローラ)、{{ic|/etc/mkinitcpio.conf}} で指定するモジュールの順番が正しいことを確認して下さい。再起動で root デバイスの場所が変わってしまって、カーネルパニックが発生する可能性があります。また、[[永続的なブロックデバイスの命名]]を使えば正しいデバイスを確実にマウントすることができます。}}

{{Note|PS/2 キーボードを使っている場合: init でキーボード入力を使えるようにするには、{{ic|HOOKS}} に ''keyboard'' フックを追加してください。マザーボードによっては (特に旧世代のマザーボード)、i8042 コントローラが自動で検出されないことがあります。稀ですが、キーボードがないということもありえます。事前にこの状態を検出することができます。PS/2 端子があって {{ic|i8042: PNP: No PS/2 controller found. Probing ports directly}} メッセージが表示される場合、''atkbd'' を {{ic|MODULES}} に追加してください。}}

ユーザーは設定ファイルの中にある6つの変数を修正することが可能です:

; {{ic|MODULES}}: boot フックが実行される前にロードするべきカーネルモジュール。
; {{ic|BINARIES}}: initramfs イメージに含める追加のバイナリ。
; {{ic|FILES}}: initramfs イメージに含める追加のファイル。
; {{ic|HOOKS}}: フックは initial ramdisk で実行するスクリプトです。
; {{ic|COMPRESSION}}: initramfs イメージを圧縮するのに使われます。
; {{ic|COMPRESSION_OPTIONS}}: {{ic|COMPRESSION}} プログラムに渡すコマンドラインオプション。この設定の使用はあまり推奨されません。mkinitcpio は圧縮プログラムに特殊な細工を施すので (例: xz には {{ic|1=--check=crc32}} を指定します)、誤って利用するとシステムが起動できなくなる可能性があります。

=== MODULES ===

MODULES 行では何か他のことが行われる前にロードするモジュールを指定します。

モジュールの後ろに {{ic|?}} を付けると、モジュールが見つからなかったときでもエラーを投げません。これは、フックや設定ファイルにリストアップされたモジュールを含んでコンパイルするカスタムカーネルで有益かもしれません。

{{Note|
* ''reiser4'' を使う場合、モジュールのリストに必ず追加するようにしてください。
* mkinitcpio の実行時ライブでないブートプロセスの間にファイルシステムが必要な場合 (例えば LUKS の暗号化キーファイルが ''ext2'' ファイルシステム上にあって mkinitcpio の実行時には ''ext2'' ファイルシステムはマウントしない場合)、そのファイルシステムのモジュールも MODULES リストに追加する必要があります。詳しくは [[Dm-crypt/システム設定#cryptkey]] を参照。}}

=== BINARIES と FILES ===

ユーザーはオプションを使ってイメージにファイルを追加することができます。{{ic|BINARIES}} と {{ic|FILES}} はフックが実行される前に追加され、フックによって使用されるファイルを上書きすることがあります。{{ic|BINARIES}} は標準の {{ic|PATH}} に自動で配置され、依存関係がパースされます。つまり必要なライブラリも全て追加されます。{{ic|FILES}} は''そのままの状態で'' (as-is) 追加されます。例:

FILES=(/etc/modprobe.d/modprobe.conf)

BINARIES=(kexec)

{{ic|BINARIES}} と {{ic|FILES}} のどちらでも、スペースで区切ることで複数のエントリを追加することができます。

=== HOOKS ===

{{ic|HOOKS}} 設定は設定ファイルの中で一番重要な設定です。フックはイメージに追加されるものを記述する小さなスクリプトです。フックによっては、デーモンを起動したりスタックしたブロックデバイスを集めたりするためのランタイムコンポーネントを含んでいるものもあります。フックは名前によって参照され、設定ファイルの {{ic|HOOKS}} にある順番通りに実行されます。

ほとんどのシンプルな、シングルディスクセットアップではデフォルトの {{ic|HOOKS}} 設定で十分なはずです。[[LVM]], [[mdadm]], [[dm-crypt]] などスタックした root デバイスやマルチブロックデバイスを使う時は、関連する wiki ページを見て必要な設定を調べて下さい。

==== ビルドフック ====

ビルドフックは {{ic|/usr/lib/initcpio/install/}} にあります。カスタムビルドフックは {{ic|/etc/initcpio/install/}} に配置します。これらのファイルは mkinitcpio の実行時に bash シェルによって実行されます。ビルドフックには２つの関数が含まれています: {{ic|build}} と {{ic|help}}。{{ic|build}} 関数にはイメージに追加するモジュール・ファイル・バイナリを記述します。これらのアイテムの追加を容易にする {{man|8|mkinitcpio}} による API が用意されています。{{ic|help}} 関数はフックの役割を出力します。

すべてのフックを一覧するには:

$ mkinitcpio -L

特定のフックのヘルプを出力するには mkinitcpio の {{ic|-H}}/{{ic|--hookhelp}} オプションを使って下さい、例えば:

$ mkinitcpio -H udev

==== ランタイムフック ====

ランタイムフックは {{ic|/usr/lib/initcpio/hooks/}} にあります。カスタムランタイムフックは {{ic|/etc/initcpio/hooks/}} に配置します。全てのランタイムフックには同じ名前のビルドフックが存在している必要があり、そのビルドフックは {{ic|add_runscript}} をコールしてランタイムフックをイメージに追加します。これらのファイルは初期ユーザ空間で busybox の ash シェルによって実行されます。cleanup フックを除いて全てのフックは {{ic|HOOKS}} 設定の順番で実行されます。ランタイムフックには複数の関数を含めることができます:

{{ic|run_earlyhook}}: API ファイルシステムがマウントされカーネルコマンドラインがパースされたときに、この名前の関数が実行されます。一般的に udev など初期ユーザ空間が始まったときに必要になる追加のデーモンはこの関数に置きます。

{{ic|run_hook}}: 初期のフックの後すぐに、この名前の関数が実行されます。一番普通のフックポイントで、スタックブロックデバイスのアセンブリなどのオペレーションはここで行なって下さい。

{{ic|run_latehook}}: root デバイスがマウントされた後、この名前の関数が実行されます。root デバイスの後のセットアップや {{ic|/usr}} など他のファイルシステムのマウントなどに控えめに使われます。

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

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

==== 通常のフック ====

通常のフックとイメージ生成への影響と関連するランタイムを示した表です。パッケージにカスタムフックを入れることができるので、この表は完全ではないことに注意してください。

{| class="wikitable"
|+ '''現行のフック'''
|-
! busybox init !! systemd init !! [[#ビルドフック|ビルドフック]] !! [[#ランタイムフック|ランタイムフック]] (busybox init のみ)
|-
|colspan="2" style="text-align: center;"| '''base''' || 全ての initial directory をセットアップし基本のユーティリティとライブラリをインストールする。何をしようとしているのかわからない限りはこのフックを一番最初のフックにしておいてください。'''systemd''' フックを使用している場合、busybox のリカバリシェルが提供されます。 {{Note|initramfs の root アカウントが [https://github.com/archlinux/svntogit-packages/commit/776743d220cbb56e9abca2cc8bcef3a0ab7c8d0a locked] されてるため、リカバリシェルは使用できません。}}
| --
|-
| style="text-align: center;"| '''udev''' ||rowspan="3" style="text-align: center;"| '''systemd''' || イメージに udevd, udevadm, そして udev ルールの小さなサブセットを追加します。 || dev デーモンを起動してカーネルからの uevent を処理します。デバイスノードを作成します。ブートプロセスの単純化として、必要なモジュールを明示的に指定する必要をなくすため、udev フックの使用が推奨されています。
|-
| style="text-align: center;"| '''usr''' || {{ic|/usr}} の分割パーティションのサポートを追加。 || real root がマウントされた後に {{ic|/usr}} パーティションをマウントします。
|-
|-
| style="text-align: center;"| '''resume''' || -- || "ハイバネート" (suspend to disk) 状態からの復帰を試みます。詳しい設定方法は[[ハイバネート]]を見てください。
|-
| style="text-align: center;"| '''btrfs''' || {{Grey|--}} || root で [[Btrfs]] を有効にしてサブボリュームを使用するために必要なモジュールを設定します。シングルデバイスで Btrfs を使うだけならこのフックは不要です。 || udev フックが存在しないときに {{ic|btrfs device scan}} を実行してマルチデバイスの Btrfs root ファイルシステムを構築します。このフックを使うには {{Pkg|btrfs-progs}} パッケージが必要です。
|-
|colspan="2" style="text-align: center;"| '''autodetect''' || sysfs のスキャンによってモジュールのホワイトリストを作成して initramfs を小さくします。含まれているモジュールが正しく、欠けているものがないか確認してください。自動検知の利点を活かすためにこのフックは他の subsystem フックより前に実行してください。'autodetect' より前に置かれたフックは完全にインストールされます。 || --
|-
|colspan="2" style="text-align: center;"| '''modconf''' || {{ic|/etc/modprobe.d}} と {{ic|/usr/lib/modprobe.d/}} から modprobe 設定ファイルをロードします。 || --
|-
|colspan="2" style="text-align: center;"| '''block''' || 全てのブロックデバイスモジュールを追加します。昔は ''fw'', ''mmc'', ''pata'', ''sata'', ''scsi'' , ''usb'', ''virtio'' フックに分かれていました。 || --
|-
| style="text-align: center;"| '''net''' || {{R|''未実装''}} || ネットワークデバイスに必要なモジュールを追加します。PCMCIA net デバイスには ''pcmcia'' フックも追加してください。 || NFS の root ファイルシステムの管理を提供します。
|-
| style="text-align: center;"| '''dmraid''' || style="text-align: center;"| ''?'' || fakeRAID root デバイスのサポートを提供します。これを使うには {{Pkg|dmraid}} をインストールする必要があります。コントローラがサポートしている場合、fakeRAID では ''mdadm_udev'' フックと一緒に {{ic|mdadm}} を使うことが推奨されます。 || {{ic|dmraid}} を使用して fakeRAID ブロックデバイスを構築します。
|-
| style="text-align: center;"| '''mdadm''' || {{Grey|--}} || {{ic|/etc/mdadm.conf}} からの RAID アレイの構築や、起動中の自動検出のサポートを提供します。これを使うには {{Pkg|mdadm}} のインストールが必須です。このフックよりも ''mdadm_udev'' フックが推奨されています。 || {{ic|mdassemble}} を使ってソフトウェア RAID ブロックデバイスを構築します。
|-
|colspan="2" style="text-align: center;"| '''mdadm_udev''' || udev による RAID アレイの構築のサポートを提供します。これを使うには {{Pkg|mdadm}} のインストールが必要です。[[FakeRAID]] アレイでこのフックを使う場合、binaries セクションに {{ic|mdmon}} を含めて ''shutdown'' フックを追加することが推奨されます。再起動時に不必要な RAID を再ビルドしないためです。 || {{ic|udev}} と {{ic|mdadm}} を使ってソフトウェア RAID ブロックデバイスを動的に構築します。mdadm アセンブリの推奨方法です (上記の ''mdadm'' フックを使うよりも)。
|-
|colspan="2" style="text-align: center;"| '''keyboard''' || キーボードデバイスに必要なモジュールを追加します。あなたが USB キーボードを使っていて、それを初期ユーザ空間で使う必要があるとき (暗号化のパスフレーズを入力したりインタラクティブシェルを使う場合) はこのフックを使って下さい。副作用としてキーボード以外の入力デバイス用のモジュールが追加されることがありますが、困ることはないはずです。

{{Tip|異なるハードウェア構成で起動されるシステム(たとえば、外部キーボードと内部キーボードを備えたラップトップまたは [[Wikipedia:Headless computer|headless systems]]) の場合、このフックを '''autodetect''' の前に配置すると便利です。常にすべてのキーボードドライバを含めるため。それ以外の場合、外部キーボードは、イメージの作成時に接続されている場合にのみ、初期のユーザースペースで機能します。}}
|| --
|-
| style="text-align: center;"| '''keymap''' ||rowspan="2" style="text-align: center;"| '''sd-vconsole''' || {{ic|/etc/vconsole.conf}} から initramfs に指定したキーマップを追加します。システム暗号化 (特に[[Dm-crypt/システム全体の暗号化|完全なシステム暗号化]]) を使用する場合、{{ic|1=encrypt}} フックよりも前に追加するようにしてください。 || 初期ユーザ空間で {{ic|/etc/vconsole.conf}} から指定されたキーマップをロードします。
|-
| style="text-align: center;"| '''consolefont''' || {{ic|/etc/vconsole.conf}} から initramfs に指定したコンソールフォントを追加します。 || 初期ユーザ空間で {{ic|/etc/vconsole.conf}} から指定されたコンソールフォントをロードします。
|-
| style="text-align: center;"| '''encrypt''' || style="text-align: center;"| '''sd-encrypt''' || {{ic|dm_crypt}} カーネルモジュールと {{ic|cryptsetup}} ツールをイメージに追加します。これを使うには {{Pkg|cryptsetup}} をインストールする必要があります。 || 暗号化された root パーティションを検知してアンロックします。設定については [[#ランタイムのカスタマイズ]] を見て下さい。'''sd-encrypt''' については [[Dm-crypt/システム設定#sd-encrypt フックを使う]]を見てください。
|-
| style="text-align: center;"| '''lvm2''' || style="text-align: center;"| '''sd-lvm2''' || device mapper カーネルモジュールと {{ic|lvm}} ツールをイメージに追加します。これを使うには {{Pkg|lvm2}} をインストールする必要があります。 || 全ての LVM2 ボリュームグループを有効にします。root ファイルシステムが [[LVM]] 上にある場合は必須です。
|-
|colspan="2" style="text-align: center;"| '''fsck''' || fsck バイナリとファイルシステム特有のヘルパーを追加します。''autodetect'' フックの後ろに追加した場合、root ファイルシステムのヘルパーだけが追加されます。このフックの使用は強く推奨されており、{{ic|/usr}} パーティションを分割する場合は必須です。 || root デバイス (と分割している場合は {{ic|/usr}}) に対してマウントする前に fsck を実行します。ブートローダーのデフォルト設定で問題ありませんが、疑問がある場合は [https://bbs.archlinux.org/viewtopic.php?pid=1307895#p1307895 こちらの設定] を読んで下さい。
|-
|colspan="2" style="text-align: center;"| '''filesystems''' || イメージに必要なファイルシステムモジュールを含めます。ファイルシステムモジュールを MODULES で指定していない限りこのフックが必要になります。 || --
|-
|}

==== 廃止されたフック ====
{{Pkg|mkinitcpio}} 0.13.0 では、{{ic|usbinput}} フックは廃止され {{ic|keyboard}} フックを使うようになりました。

{{Pkg|mkinitcpio}} 0.12.0 では、以下のフックが廃止されました。以下のフックのどれかを使っているときは、{{ic|block}} フックに置き換える必要があります。

*{{ic|fw}}
*{{ic|mmc}}
*{{ic|pata}}
*{{ic|sata}}
*{{ic|scsi}}
*{{ic|usb}}
*{{ic|virtio}}

詳しくは、Git コミット [https://projects.archlinux.org/mkinitcpio.git/commit/?id=97368c0e78f3a4fe4d62f7aedde88d4be13bfdba 97368c0e78] や [https://mailman.archlinux.org/pipermail/arch-projects/2012-November/003426.html arch-projects メーリングリスト]を見て下さい。

=== COMPRESSION ===

カーネルは、 initramfs の圧縮にいくつかの形式をサポートしています: {{pkg|gzip}}、 {{pkg|bzip2}}、 lzma、 {{pkg|xz}}、 {{pkg|lzo}}、 {{pkg|lz4}} および {{pkg|zstd}} mkinitcpio はデフォルトで zstd 圧縮イメージを使用します。 zstd 圧縮はマルチスレッドモードで実行されます (検出されたコアと同じ数のスレッドを使用します。 {{ic|-T 0}} オプションを使用)

提供されている {{ic|mkinitcpio.conf}} には、さまざまな {{ic|COMPRESSION}} オプションがコメントアウトされています。別の圧縮方法に切り替える場合は、コメントを解除し、対応する圧縮ユーティリティがインストールされていることを確認します。何も指定しない場合は、zstdのデフォルトのメソッドが使用されます。非圧縮イメージを作成する場合は、設定ファイルで {{ic|1=COMPRESSION='''cat'''}} を指定するか、コマンドラインで {{ic|-z cat}} を使用します。

{{Tip|高圧縮モード (-9) のイメージの圧縮比は通常の約2.5で、解凍速度が非常に速いため、 '''lz4''' はより遅いシングルスレッド圧縮を犠牲にして最も速い解凍速度を実現します。わずかに優れた圧縮の、lzo も解凍が速いです。zstd は、マルチスレッド圧縮と、そのオプションを使用した幅広い圧縮レベルを備えた汎用的なソリューションを提供します。 {{man|1|zstd|Operation modifiers}} を参照してください。 xz は、解凍速度がはるかに遅くなりますが、高圧縮プリセット (-9) で約5の縮小係数で最小サイズを実現します。}}

=== COMPRESSION_OPTIONS ===

{{ic|COMPRESSION}} で指定したプログラムに渡す追加のフラグを記述します、例:

COMPRESSION_OPTIONS=(-9)

mkinitcpio はイメージを作成するときサポートされている圧縮方法に必要なフラグを渡すので、通常はこのオプションは必要ありません。なお、カーネルが作成された圧縮ファイルを解凍できないとき、このオプションを使っていないとシステムをブートできなくなる可能性があります。

== ランタイムのカスタマイズ ==

ランタイム設定オプションはカーネルコマンドラインを通して {{ic|init}} や特定のフックに渡すことができます。カーネルコマンドラインパラメータはブートローダによって与えられることがほとんどです。下で書かれているオプションをカーネルコマンドラインに追加することでデフォルトの挙動を変えることができます。詳しくは[[カーネルパラメータ]]や [[Arch ブートプロセス]]を見て下さい。

=== init ===

; {{ic|root}}: カーネルコマンドラインで指定する一番重要なパラメータであり、どのデバイスを root デバイスとしてマウントするかを決めます。mkinitcpio は柔軟に様々な形式を使うことができるようになっています、例:
root=/dev/sda1 # /dev node
root=LABEL=CorsairF80 # label
root=UUID=ea1c4959-406c-45d0-a144-912f4e86b207 # UUID
root=PARTUUID=14420948-2cea-4de7-b042-40f67c618660 # GPT partition UUID

{{Note|以下のブートパラメーターは initramfs 環境における {{ic|init}} のデフォルトの挙動を変更します。詳しくは {{ic|/usr/lib/initcpio/init}} を参照。{{ic|systemd}} フックが使われている場合 {{ic|base}} フックの {{ic|init}} は置き換わるため機能しません。}}

; {{ic|break}}: {{ic|<nowiki>break</nowiki>}} や {{ic|<nowiki>break=premount</nowiki>}} が指定された場合、(フックをロードした後、root ファイルシステムをマウントする前に) {{ic|init}} はブートプロセスを停止してトラブルシューティングに使うことができるインタラクティブシェルを起動します。{{ic|<nowiki>break=postmount</nowiki>}} と指定することで root がマウントされた後にこのシェルを起動することもできます。シェルを終了すると通常通りに起動が行われます。

; {{ic|disablehooks}}: {{ic|<nowiki>disablehooks=hook1{,hook2,...}</nowiki>}} を追加すると実行時にフックを無効化します。例: {{bc|1=disablehooks=resume}}

; {{ic|earlymodules}}: {{ic|<nowiki>earlymodules=mod1{,mod2,...}</nowiki>}} という風に先にロードするモジュールを指定することでモジュールがロードされる順番を変更することができます (例えば、複数のネットワークインターフェイスの順番を適切に確定したいときなどに使います)。

; {{ic|rootdelay=N}}: {{ic|rootdelay}} を追加すると root ファイルシステムをマウントする前に {{ic|N}} 秒間だけ停止します (例えば、初期化に時間がかかる USB ハードドライブから起動するときなどに使います)。

他のパラメータについては[[ブートデバッグ]]や {{man|8|mkinitcpio}} を見て下さい。

=== RAID を使う ===

{{Note|{{ic|mdadm}} は推奨されません。更新時に {{ic|1===> WARNING: Hook 'mdadm' is deprecated. Replace it with 'mdadm_udev' in your config}} が表示されます。}}

まず、{{ic|/etc/mkinitcpio.conf}} 内の {{ic|HOOKS}} に {{ic|mdadm_udev}} または {{ic|mdadm}} フックを追加し、必要な RAID モジュール全て (例: raid456, ext4) を {{ic|MODULES}} に追加して下さい。

{{ic|mdadm}} フックを使う場合、[[カーネルパラメータ]]で RAID アレイを設定する必要はありません。{{ic|mdadm}} フックは {{ic|/etc/mdadm.conf}} ファイルを使うか、またはブート時の init 段階でアレイを自動で検出します。

{{ic|mdadm_udev}} フックを使うことで udev による構築も可能です。上流ではこの方法が推奨されています。{{ic|/etc/mdadm.conf}} は構築されたデバイスに名前を付けるために読み込まれます。

=== net を使う ===

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

'''必要なパッケージ:'''

{{ic|net}} は {{Pkg|mkinitcpio-nfs-utils}} パッケージを必要とします。

'''カーネルパラメータ:'''

公式の[https://www.kernel.org/doc/Documentation/filesystems/nfs/nfsroot.txt カーネルドキュメント]に最新の情報が載っています。

'''ip='''

このパラメータはカーネルに、デバイスの IP アドレスの設定方法と、IP ルーティングテーブルの設定方法を指定します。コロンで区切った9つの引数を指定できます: {{ic|1=ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>:<dns0-ip>:<dns1-ip>}}。

カーネルコマンドラインにこのパラメータが存在しなかった場合、全てのフィールドが空とされて、[https://www.kernel.org/doc/Documentation/filesystems/nfs/nfsroot.txt カーネルドキュメント]に書かれているデフォルト設定が適用されます。一般的にはカーネルは自動設定を使って全てを設定しようとします。

{{ic|<autoconf>}} パラメータは 'ip' パラメータの唯一の値として指定できます (前の全ての ':' 文字を排除)。値が {{ic|1=ip=off}} や {{ic|1=ip=none}} の場合、自動設定は行われません。そうでないなら、自動的に設定されます。最も一般的な使い方は {{ic|1=ip=dhcp}} です。

パラメータの説明は、[https://www.kernel.org/doc/Documentation/filesystems/nfs/nfsroot.txt カーネルドキュメント]を参照してください。

; 例
ip=127.0.0.1:::::lo:none --> Enable the loopback interface.
ip=192.168.1.1:::::eth2:none --> Enable static eth2 interface.
ip=:::::eth0:dhcp --> Enable dhcp protocol for eth0 configuration.

{{Note|{{ic|<device>}} パラメータにはカーネルのデバイス名を使用してください (例: ''eth0'')、[[ネットワーク設定#デバイス名|udev]] のデバイス名 (例: ''enp2s0'') では動作しません。}}

'''BOOTIF='''

複数のネットワークカードを使っているときは、このパラメータに起動するインターフェイスの MAC アドレスを含めることができます。インターフェイスの数字が変わってしまったり、pxelinux の IPAPPEND 2 や IPAPPEND 3 オプションを使うときに便利です。指定しなかった場合、eth0 が使われます。

''例:''
BOOTIF=01-A1-B2-C3-D4-E5-F6 # Note the prepended "01-" and capital letters.

'''nfsroot='''

{{ic|nfsroot}} パラメータがコマンドラインで指定されなかった場合、デフォルトで {{ic|/tftpboot/%s}} が使われます。

nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]

パラメータの説明を見るには {{ic|mkinitcpio -H net}} を実行してください。

'''root=/dev/nfs'''

{{ic|nfsroot}} パラメータを使わない場合、{{ic|1=root=/dev/nfs}} を設定して自動設定により NFS root から起動するようにする必要があります。

=== LVM を使う ===

root デバイスを [[LVM]] 上に置く場合は、[[LVM#mkinitcpio.conf の設定|lvm2 フックを mkinitcpio.conf に追加する]]必要があります。

=== 暗号化された root を使う ===

[[Dm-crypt/システム全体の暗号化|root を暗号化]]している場合、{{ic|filesystems}} の前に {{ic|encrypt}} フックを追加する必要があり、他のフックも必要になります。ブートローダーによって特定のカーネルコマンドラインパラメータを指定しなくてはなりません: 詳しくは [[Dm-crypt/システム設定#mkinitcpio]] を見て下さい。

=== /usr パーティションを分割する ===

{{ic|/usr}} のパーティションを別にする場合、以下を行う必要があります:

* {{ic|fsck}} フックを追加して、{{ic|/etc/fstab}} で {{ic|/usr}} の {{ic|passno}} を {{ic|0}} にする。起動時に {{ic|/usr}} を fsck したい場合は必須です。このフックが存在しないと、{{ic|/usr}} は永遠に fsck されません。
* systemd フックを使っていない場合、{{ic|usr}} フックを追加。ルートがマウントされた後に {{ic|/usr}} パーティションがマウントされるようになります。0.9.0 以前では、{{ic|/usr}} はルートの {{ic|/etc/fstab}} で確認されたら自動的にマウントされていました。[[Fstab]] を参照。

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

=== イメージの展開 ===

initramfs イメージの中に何が入っているか気になるときは、イメージを展開して中に入っているファイルを調べることができます。

initramfs イメージは SVR4 CPIO アーカイブであり、{{ic|find}} と {{ic|bsdcpio}} コマンドによって生成されています。また、任意でカーネルが対応した圧縮方法によって圧縮されています。圧縮方法について詳しくは [[#COMPRESSION]] を見て下さい。

mkinitcpio には {{ic|lsinitcpio}} というユーティリティが含まれており initramfs イメージの中身を一覧・展開することができます。

イメージ内のファイルを一覧するには:
$ lsinitcpio /boot/initramfs-linux.img

作業ディレクトリにファイルを全て展開するには:
$ lsinitcpio -x /boot/initramfs-linux.img

イメージの重要なパーツについて読みやすいリストを取得することもできます:
$ lsinitcpio -a /boot/initramfs-linux.img

=== 展開して修正を加えたイメージの再圧縮 ===
上記のようにイメージを展開してから修正を加えたら、再圧縮に必要なコマンドを確認します。{{ic|/usr/bin/mkinitcpio}} を編集して以下のように行を変更してください (mkinitcpio v20-1 の場合は531行目):
#MKINITCPIO_PROCESS_PRESET=1 "$0" "${preset_cmd[@]}"
MKINITCPIO_PROCESS_PRESET=1 /usr/bin/bash -x "$0" "${preset_cmd[@]}"

そして通常のオプションで {{ic|mkinitcpio}} を実行 ({{ic|mkinitcpio -p linux}}) すると、最後の20行に以下のような表示がされます:
+ find -mindepth 1 -printf '%P\0'
+ LANG=C
+ bsdcpio -0 -o -H newc --quiet
+ gzip

上記の出力が再圧縮するのに必要なコマンドになります。例:
# find -mindepth 1 -printf '%P\0' | LANG=C bsdcpio -0 -o -H newc --quiet | gzip > /boot/initramfs-linux.img

{{Warning|上書きするまえに自動生成された {{ic|/boot/initramfs-linux.img}} の名前を変更することで、簡単に元に戻すことができるようになります。何か問題が発生して起動できなくなった場合、フォールバックイメージやブート CD で起動して、{{ic|mkinitcpio}} を実行して元のイメージに戻してください。}}

=== マウントされているのに "/dev must be mounted" と表示される ===
{{ic|/dev}} がマウントされているかどうか確認するのに mkinitcpio は {{ic|/dev/fd/}} が存在するかどうかを確かめます。問題がないようでしたら、手動で作成することができます:
# ln -s /proc/self/fd /dev/

当然 {{ic|/proc}} のマウントも必要です。mkinitcpio によって次にチェックされます。

=== LUKS/LVM/resume セットアップで systemd フックを使う ===
伝統的な {{ic|encrypt}}/{{ic|lvm2}}/{{ic|resume}} の代わりに {{ic|systemd}}/{{ic|sd-encrypt}}/{{ic|sd-lvm2}} フックを使う場合、ブートローダーで別の initrd パラメータを渡す必要があります。詳しくはフォーラムの投稿を見て下さい [https://bbs.archlinux.org/viewtopic.php?pid=1480241]。

=== Possibly missing firmware for module XXXX ===

カーネルのアップデート後に initramfs を再生成する際、以下のような警告が表示されることがあります:

==> WARNING: Possibly missing firmware for module: aic94xx
==> WARNING: Possibly missing firmware for module: wd719x

ファームウェアモジュールをインストールしていない Arch Linux ユーザーなら誰でも表示されます。ファームウェアを使用するハードウェアを使っていない場合、上記のメッセージは無視してかまいません。
2022年1月30日現在において、aic94xx、wd719x、xhci_pciモジュールについては表示を抑えることができます。
aic94xxモジュール向けに{{AUR|aic94xx-firmware}}を、wd719xモジュール向けに{{AUR|wd719x-firmware}}を、xhci_pci向けに{{AUR|upd72020x-fw}}をそれぞれインストールしてください。
詳しくは[https://gist.github.com/imrvelj/c65cd5ca7f5505a65e59204f5a3f7a6d こちらの議論]を参照してください。

殆どのファームウェアについては、''linux-firmware''パッケージを[[インストール]]することにより入手することができます。
他のパッケージについては、[[公式リポジトリ]]または[[AUR]]にてモジュール名を検索してください。

=== 標準的なレスキュー手順 ===

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

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

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

== 参照 ==
* Linux カーネルドキュメントの [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/plain/Documentation/filesystems/ramfs-rootfs-initramfs.txt?id=HEAD initramfs] ''What is rootfs?'' でページ内を検索してください
* Linux カーネルドキュメントの [https://doc.kusakata.com/admin-guide/initrd.html initrd]
* [[Wikipedia:ja:initrd]]

LightDM

2022-06-29T10:31:22Z

Linuxmetel: URI の更新や、一部の翻訳など

[[Category:ディスプレイマネージャ]]
[[Category:Canonical]]
[[en:LightDM]]
[[es:LightDM]]
[[fr:LightDM]]
[[ru:LightDM]]
[[zh-hans:LightDM]]
{{Related articles start}}
{{Related|ディスプレイマネージャ}}
{{Related|GDM}}
{{Related|KDM}}
{{Related|LXDM}}
{{Related articles end}}

[https://github.com/canonical/lightdm LightDM] はクロスデスクトップの[[ディスプレイマネージャ]]です。主な特徴は以下の通り:
* クロスデスクトップ - 様々なデスクトップに対応。
* 様々なディスプレイサーバーに対応 (X, Mir, ...)。
* 軽量 - メモリの使用量が少なくて高速に動作。
* ゲストセッションをサポート。
* リモートログインをサポート (XDMCP, VNC, XDMCP, pluggable)。
* 充実したテストスイート。
* 軽量なコードベース。

LightDM の設計に関する詳細は [https://www.freedesktop.org/wiki/Software/LightDM/Design ここ] から見れます。

== インストール ==
[[公式リポジトリ]]から {{Pkg|lightdm}} をインストールしてください。リリースバージョンについては、安定版は偶数 (1.8, 1.10) 開発版は奇数 (1.9, 1.11) が付けられています。開発ブランチは [[Arch User Repository|AUR]] から {{AUR|lightdm-devel}}　か {{AUR|lightdm-git}} をインストールすることで使えます。

=== Greeter===
Greeter もインストールする必要があります。Greeter はユーザーにログイン情報の入力を求める GUI であり、セッションの選択なども行います。Greeter 無しで LightDM を使うことも可能ですが、その場合は自動ログインを設定しなくてはなりません。デフォルトの Greeter は {{Pkg|lightdm-gtk-greeter}} です。LightDM は他の Greeter が設定されていない場合、この Greeter を使用します。

公式リポジトリには以下の Greeter が含まれています:

* {{Pkg|lightdm-gtk-greeter}}: '''デフォルト''' の Greeter
* lightdm-deepin-greeter ({{Pkg|deepin-session-ui}}): [[Deepin Desktop Environment|Deepin]] プロジェクトからの Greeter。
* {{Pkg|lightdm-pantheon-greeter}}: elementary OS プロジェクトの Greeter。
* {{Pkg|lightdm-slick-greeter}}: GTK ベースの {{Pkg|lightdm-gtk-greeter}} に比べて見た目にフォーカスした Greeter。{{AUR|lightdm-unity-greeter}} からのフォークで、 Linux Mint ではデフォルトになっています。
* {{Pkg|lightdm-webkit2-greeter}}: テーマに WebKit2 を使用する Greeter。{{AUR|lightdm-webkit-greeter}} の後継。
* {{Pkg|lightdm-webkit-theme-litarvan}}: モダンかつ完全な Webkit2 の LightDM テーマ。

他の Greeter は [[Arch User Repository|AUR]] からインストールすることができます:

* {{AUR|lightdm-unity-greeter}}: Ubuntu の [[Unity]] で使われている Greeter。
* {{AUR|lightdm-mini-greeter}}: ミニマルなシングルユーザー Greeter。
* {{AUR|lightdm-webkit-theme-aether}}: A sleek, straightforward Arch Linux themed login screen written on lightdm and the lightdm-webkit2-greeter.
* {{AUR|lightdm-elephant-greeter-git}}: 小さくてシンプルな Greeter。デフォルトでは {{Pkg|cage}} Wayland コンポジタ内で動作します。

設定ファイルの {{ic|[Seat:*]}} セクションを変更することでデフォルトの Greeter を変えることが可能です:
{{hc|/etc/lightdm/lightdm.conf|
[Seat:*]
…
greeter-session=lightdm-yourgreeter-greeter
}}

{{ic|/usr/share/xgreeters}} ディレクトリの {{ic|.desktop}} ファイルを見ることで利用可能な Greeter が確認できます。以下の例では {{ic|lightdm-gtk-greeter}} と {{ic|lightdm-kde-greeter}} が使えることがわかります:
{{hc|$ ls -1 /usr/share/xgreeters/|lightdm-gtk-greeter.desktop
lightdm-kde-greeter.desktop}}

== LightDM を有効にする ==
[[systemd#ユニットを使う|systemctl]] を使って {{ic|lightdm.service}} デーモンを有効にしてください、それで LightDM がブート時に起動するようになります。[[ディスプレイマネージャ#ディスプレイマネージャをロードする]]も参照。

== コマンドラインツール ==
LightDM はコマンドラインツール {{ic|dm-tool}} を提供しています。これを使うことで現在のシートのロック、セッションの切り替えなどができます。'最小主義の'ウィンドウマネージャを使っている場合やテストに便利です。利用できるコマンドを表示するには、次を実行してください:
$ dm-tool --help

=== ユーザー切り替え ===

{{Warning|1=LightDM に組み込まれているスクリーンロッカーである {{ic|dm-tool lock}} や {{ic|dm-tool switch-to-greeter}} の使用は推奨されません [https://bbs.archlinux.org/viewtopic.php?pid=1712213#p1712213]。[[#light-locker を使って画面をロック|light-locker]]など[[アプリケーション一覧/セキュリティ#スクリーンロック|他のスクリーンロッカー]]を使ってください。}}

LightDM の ''dm-tool'' コマンドを使って別々の tty に複数のユーザーをログインさせることができます。以下のコマンドは現在のセッションをロックするシグナルを送信して LightDM の greeter への切り替えを行って、新しいユーザーがログインできるようにします:
$ dm-tool switch-to-greeter

== テスト ==
まず、[[公式リポジトリ]]から {{Pkg|xorg-server-xephyr}} を[[Pacman|インストール]]してください。

そして X アプリケーションとして LightDM を起動してください:
$ lightdm --test-mode --debug

== 任意の設定と調整 ==
LightDM は設定ファイル {{ic|/etc/lightdm/lightdm.conf}} に修正を加えることで設定を行います。

また、Greeter にも設定ファイルが存在することがあります。例:

{{Pkg|lightdm-gtk-greeter}}: {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}}

{{Pkg|lightdm-webkit2-greeter}}: {{ic|/etc/lightdm/lightdm-webkit2-greeter.conf}}

{{Pkg|lightdm-kde-greeter}}{{Broken package link|パッケージが存在しません}}: {{ic|/etc/lightdm/lightdm-kde-greeter.conf}}

=== 背景画像・色を変更する ===
単色 (画像なし) を使いたい場合は {{ic|background}} 変数を十六進数の色コードに設定してください。例:
background=#000000

画像を使いたい場合は以下を参照してください。

==== GTK+ Greeter ====
{{Pkg|lightdm-gtk-greeter-settings}} を使うことで GUI で設定できます。

greeter 画面の壁紙をカスタマイズするには {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} を編集して {{ic|[greeter]}} セクションに {{ic|background}} 変数を定義する必要があります。例:
{{hc|/etc/lightdm/lightdm-gtk-greeter.conf|2=[greeter]
background=/usr/share/pixmaps/black_and_white_photography-wallpaper-1920x1080.jpg}}

{{Note|LightDM ユーザーが画像ファイルにアクセスできるようにするため、{{ic|/usr/share/pixmaps}} に PNG や JPG ファイルを配置することが推奨されています。}}

===== GTK3 ダークテーマ =====
GTK3 からテーマに "dark" カラーパレットが追加されていますが、lightdm-gtk-greeter はまだネイティブでサポートしていません。{{ic|/usr/share/xgreeters/lightdm-gtk-greeter.desktop}} の環境変数でテーマを上書きするようにしてください。例:
{{hc|/usr/share/xgreeters/lightdm-gtk-greeter.desktop|2=
[Desktop Entry]
Name=LightDM GTK+ Greeter
Comment=This runs the GTK+ greeter, it should only be run from LightDM
Exec=env GTK_THEME=Adwaita:dark lightdm-gtk-greeter
Type=Application
X-Ubuntu-Gettext-Domain=lightdm
}}

==== Webkit2 Greeter ====

{{Pkg|lightdm-webkit2-greeter}} の場合、ログイン画面で直接背景画像を選択することができます。起動するたびにランダムに画像を表示するオプションも存在します。デフォルトでは、画像は {{ic|/usr/share/backgrounds}} から読み込まれます。{{ic|lightdm-webkit2-greeter.conf}} を編集することで背景画像のディレクトリを変更できます。例:
{{hc|/etc/lightdm/lightdm-webkit2-greeter.conf|2=
[branding]
background_images = /usr/share/backgrounds
}}

{{Note|背景画像は LightDM ユーザーからアクセスできる場所にないと表示されないため {{ic|/home}} 下の場所を指定しないでください。}}

==== Unity Greeter ====
{{AUR|lightdm-unity-greeter}} を使っている場合 {{ic|/usr/share/glib-2.0/schemas/com.canonical.unity-greeter.gschema.xml}} ファイルを編集して次を実行してください:
# glib-compile-schemas /usr/share/glib-2.0/schemas/

[https://bbs.archlinux.org/viewtopic.php?id=149945 この] ページを参照。

==== KDE Greeter ====
''System Settings > Login Screen (LightDM)'' に行き背景画像を変更してください。

また、{{ic|lightdm-kde-greeter.conf}} の {{ic|Background}} 変数を編集する方法もあります:

{{hc|/etc/lightdm/lightdm-kde-greeter.conf|2=
[greeter]
theme-name=classic

[greeter-settings]
Background=/usr/share/archlinux/wallpaper/archlinux-underground.jpg
BackgroundKeepAspectRatio=true
GreetMessage=Welcome to %hostname%
}}

=== アバターを変更する ===

{{Tip|KDE を使っている場合、KDE システム設定からアバターを変更できます。}}

まず {{pkg|accountsservice}} パッケージ ([[公式リポジトリ]]にあります) がインストールされているか確認してください。それから、以下の手順で設定してください。<username> はあなたのログイン名に置き換えてください。.png ファイルの拡張子はファイル名に含めません。

* {{ic|/var/lib/AccountsService/users/<username>}} を作成・編集して、次の行を加えて下さい:

[User]
Icon=/var/lib/AccountsService/icons/''username''

* 96x96 の PNG アイコンファイルを {{ic|/var/lib/AccountsService/icons/''username''}} に配置して下さい。

{{Note|作成したファイルのパーミッションは 644 に設定して下さい。詳しくは [[chmod]] を参照。}}

=== Arch の 64x64 アイコンを使う ===
[[Arch User Repository|AUR]] の {{AUR|archlinux-artwork}} パッケージには素晴らしいサンプルが含まれており {{ic|/usr/share/archlinux/icons}} にインストールされます。以下のように {{ic|/usr/share/icons/hicolor/64x64/devices}} にコピーすることが可能です:
# find /usr/share/archlinux/icons -name "*64*" -exec cp {} /usr/share/icons/hicolor/64x64/devices \;

コピーした後は、{{AUR|archlinux-artwork}} パッケージは削除してかまいません。

=== 自動ログインを有効にする ===
LightDM の設定ファイルを編集して以下の行を変更してください:
{{hc|/etc/lightdm/lightdm.conf|2=
[Seat:*]
autologin-user=''username''
}}

パスワードを入力しないで自動的にログインするためにはユーザーが {{ic|autologin}} グループに入っている必要があります:

# groupadd -r autologin
# gpasswd -a ''USERNAME'' autologin

LightDM は {{ic|~/.dmrc}} に指定されたセッションを使ってログインします。このファイルを上書きするために、{{ic|lightdm.conf}} で {{ic|autologin-session}} を指定してください:

{{hc|/etc/lightdm/lightdm.conf|2=
[Seat:*]
autologin-user=''username''
autologin-session=''session''
}}

{{Note|GNOME ユーザー (と gnome-keyring ユーザー) は、自動でロックが解除されるように、キーリングに空のパスワードを設定する必要があります。}}

=== システム・サービスユーザーを隠す ===
システムユーザーをログイン画面で表示されないようにするには、任意の依存パッケージ {{Pkg|accountsservice}} をインストールするか、ユーザーの名前を {{ic|/etc/lightdm/users.conf}} の {{ic|hidden-users}} に追加してください。前者の方法ではユーザーを追加・削除したときにリストを更新する必要はありません。

=== SLiM からの移行 ===
[[xinitrc]] の中身を [[xprofile]] に移動し、[[ウィンドウマネージャ]]や[[デスクトップ環境]]を起動するコマンドを削除してください。

=== ~/.xinitrc を使ってログイン ===

カスタム起動スクリプトを使う場合は [[xprofile]] に移行することが推奨されますが、{{AUR|xinit-xsession}} をインストールすることで [[xinitrc]] を使うようにすることも可能です。{{ic|/usr/share/xsessions/}} に必要なファイルがインストールされ、LightDM を再起動したときにオプションが表示されるようになります。

=== NumLock を ON にする ===
{{Pkg|numlockx}} パッケージをインストールして {{ic|/etc/lightdm/lightdm.conf}} を編集して次の行を加えて下さい:
{{hc|/etc/lightdm/lightdm.conf|2=[Seat:*]
greeter-setup-script=/usr/bin/numlockx on}}

=== ユーザー切り替え ===
LightDM は様々なデスクトップ環境でのユーザー切り替えをサポートしています。ユーザー切り替えを有効にするにはシンボリックリンクを作成する必要があります:
# ln -s /usr/lib/lightdm/lightdm/gdmflexiserver /usr/local/bin/gdmflexiserver

他の方法については [[XScreenSaver#Lightdm]] の記事を見て下さい。

=== デフォルトセッション ===

他の DM と同じように、Lightdm は最後に選択された xsession を {{ic|~/.dmrc}} に保存します。詳しくは[[ディスプレイマネージャ#セッション設定]]を見てください。

=== ログインウィンドウの位置を変更 ===

==== GTK+ greeter ====

{{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} を編集して {{ic|position}} 変数に値を入力する必要があります。{{ic|x}} と {{ic|y}} を入れることができ、絶対座標 (ピクセル) と相対座標 (パーセント) で指定できます。また、ウィンドウのアンカーの位置 ({{ic|start}}, {{ic|center}}, {{ic|end}}) を指定することもできます。値はカンマで区切ります。

例:
position=200,start 50%,center

=== VNC サーバー ===
Lightdm を使って vnc 経由で接続することも可能です。サーバーとクライアントに {{pkg|tigervnc}} をインストールしてください。

サーバー側で root を使って認証パスワードを設定:

# vncpasswd /etc/vncpasswd

そして以下のように lightdm の設定ファイルを編集してください。{{ic|listen-address}} を使って vnc がローカルホストからの接続のみ listen するように設定します。[[TigerVNC#クライアント側|ssh とポートフォワーディング]]による接続のみ許可されます。SSH クライアントでは、トンネルの接続先として "localhost:5900" を使うようにしてください。デュアルスタックのネットワーク接続では "127.0.0.1:5900" や "::1:5900" は信頼性がありません。セキュアでない接続も許可するようにしたい場合、設定を無効化してください。

{{hc|/etc/lightdm/lightdm.conf|2=
[VNCServer]
enabled=true
command=Xvnc -rfbauth /etc/vncpasswd
port=5900
listen-address=localhost
width=1024
height=768
depth=24
}}

設定したら [[TigerVNC#クライアント側]]に書かれているように ssh トンネルを開いてローカルホストに接続してください。

{{Note|VNC 接続を開いたときに画面に何も表示されない場合、別の lightdm greeter を試してみてください。}}

=== light-locker を使って画面をロック ===
{{Pkg|light-locker}} は LightDM を使用してユーザーを認証するシンプルなスクリーンロッカーです。インストールして起動したら以下のコマンドでセッションをロックできます:
$ light-locker-command -l
上記コマンドを使うにはセッションの最初に {{ic|light-locker}} を起動する必要があります。[[自動起動]]を見てください。

== トラブルシューティング ==
画面が点滅して起動時に lightdm が現れない問題が起こる場合は、lightdm の設定ファイルに greeter を正しく定義しているか確認してください。GTK greeter を定義している場合は、{{ic|xsessions-directory}} (デフォルト: {{ic|/usr/share/xsessions}}) が存在していて少なくとも一つは .desktop ファイルが含まれていることを確認してください。

最後に使用したセッションが利用できなくなった時も同じ問題が lightdm の起動時に発生することがあります (例えば gnome を使った後 gnome-session パッケージを削除した場合): 一番簡単な回避策は削除したパッケージを一時的に戻すことです。もうひとつの解決策は:
# dbus-send --system --type=method_call --print-reply --dest=org.freedesktop.Accounts /org/freedesktop/Accounts/User1000 org.freedesktop.Accounts.User.SetXSession string:xfce
このコマンドはセッション "xfce" を user 1000 ユーザーのデフォルトとして設定します。

=== 電源メニュー (再起動、電源オフなど) が使えない ===
lightdm-1:1.6.0-6 より前に lightdm をインストールしている場合、次のバグが原因かもしれません: {{Bug|36613}}。修正するには次を実行してください:
# chown polkitd:root /usr/share/polkit-1/rules.d

=== 間違ったロケールが表示される ===
Lightdm でロケールが正しく表示されない場合はあなたが使用しているロケールを {{ic|/etc/environment}} に追加してください:
LANG=ja_JP.utf8

LightDM や greeter でシステムロケール以外の言語を使いたい場合、[[systemd#ユニットファイルの編集|ユニットファイルを編集]]して {{ic|1=Environment=}} オプションを追加してください。

=== Xresources が正しく読み込まれない ===
LightDM には [[Xresources]] ファイルがプリプロセッサによってロードされないという上流のバグが存在します [https://bugs.launchpad.net/lightdm/+bug/1084885]。実際面で、これは {{ic|#define}} で設定された変数が後で呼ばれた時に展開されないということを意味しています。urxvt でカスタムカラーのセットを使った時にピンクの画面になることでこれを確認できます。修正するには、{{ic|/etc/lightdm/Xsession}} を開いて次の行を探して下さい:
xrdb -nocpp -merge "$file"
次のように変更してください:
xrdb -merge "$file"
これで Xresources が処理され変数が正しく展開されます。

=== GTK greeter でアイコンが表示されない ===
{{Pkg|lightdm-gtk-greeter}} を greeter として使っていてプレースホルダ画像がアイコンとして表示される場合、正しいアイコンテーマとテーマを設定してください。次のファイルを確認してください:
{{hc|/etc/lightdm/lightdm-gtk-greeter.conf|
[greeter]
theme-name=mate # this should be the name of a directory under /usr/share/themes/
icon-theme-name=mate # this should be the name of a fully featured icons set directory under /usr/share/icons/
}}

=== ログインしようとすると LightDM がフリーズする ===

適当なユーザー名・パスワードを入力してログインしようとすると、LightDM がフリーズしデスクトップを起動できないことがあります。この問題を修正するには、{{Pkg|gdk-pixbuf2}} パッケージを再インストールしてください。[https://bbs.archlinux.org/viewtopic.php?id=179031 フォーラムへの投稿]を参照。

=== LightDM が間違ったモニタに表示される ===

マルチモニタを使っていると、LightDM が間違ったモニタに表示されることがあります (例: プライマリモニタが右側にある場合)。LightDM のログイン画面が特定のモニタで表示されるように指定するには、{{ic|/etc/lightdm/lightdm.conf}} を編集して ''display-setup-script'' パラメータを次のように変更してください:
{{hc|/etc/lightdm/lightdm.conf|2=
display-setup-script=xrandr --output ''HDMI1'' --primary
}}

''HDMI1'' は実際のモニタの ID に置き換えてください、{{ic|xrandr}} コマンドの出力で確認できます。

もしくは、GTK+ greeter を使用している場合、{{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} を編集して以下のように ''active-monitor'' パラメータを追加することもできます:
{{hc|/etc/lightdm/lightdm-gtk-greeter.conf|2=
[greeter]
active-monitor=0
}}

0 は適当なディスプレイの番号に置き換えてください。

=== LightDM が表示されない ===

システムの起動が速すぎて、グラフィックドライバーが読み込まれるよりも先に LightDM サービスが起動してしまうことがあります。このような場合、{{ic|lightdm.conf}} ファイルに以下の設定を追加してください:

[LightDM]
logind-check-graphical=true

上記の設定で LightDM はグラフィックデバイスの準備が完了するのを待ってから Greeter を生成してセッションを開始します。

=== Pulseaudio が自動的に起動しない ===

[[PulseAudio#実行]]を見て下さい。

=== タッチパッドでタップしてクリックできない ===

設定によってはタップでクリックが機能しないことがあります。[[libinput]] を使用している場合、{{ic|/etc/lightdm/lightdm.conf}} を編集して以下のように ''greeter-setup-script'' オプションをセットして xinput によるタッチパッドのクリックを有効にしてください:

{{hc|/etc/lightdm/lightdm.conf|2=
greeter-setup-script=xinput set-prop '''''device_number option_number setting_value'''''
}}

{{ic|xinput}} を使用して入力デバイスのプロパティを設定する方法は [[Libinput#設定]]を参照してください。

== 参照 ==
* {{Pkg|light-locker}} - LightDM を使用する画面ロッカー。
* [https://wiki.ubuntu.com/LightDM Ubuntu Wiki の記事]
* [https://wiki.gentoo.org/wiki/LightDM/ja Gentoo Wiki の記事]
* [https://launchpad.net/lightdm Launchpad のページ]
* [http://www.mattfischer.com/blog/?tag=lightdm LightDM ブログ]

利用者:Linuxmetel

2022-06-29T07:52:58Z

Linuxmetel: ページの白紙化

Emacs

2020-05-23T03:16:49Z

Linuxmetel: 一部を翻訳

[[Category:テキストエディタ]]
[[Category:コンソールアプリケーション]]
[[Category:GNU]]
[[de:Emacs]]
[[en:Emacs]]
[[es:Emacs]]
[[fr:Emacs]]
[[sr:Emacs]]
[[zh-hans:Emacs]]
[[Wikipedia:ja:Emacs|Emacs]] は拡張性があり、カスタマイズ可能な、セルフドキュメント方式のリアルタイム表示エディタです。Emacs のコアには、多数の Emacs の内蔵機能や拡張を実装するのに使われている言語である、[[Wikipedia:ja:Emacs Lisp|Emacs Lisp]] のインタプリタが存在します。GNU Emacs 22 から GTK がデフォルトの X ツールキットとして使われていますが、CLI 環境でも負けず劣らずに機能します。Emacs のテキスト編集機能はしばしば [[vim]] と比較されることがあります。

== インストール ==

Emacs には複数の種類があります (時々 ''emacsen'' と呼ばれます)。その中で最も一般的なのは [https://www.gnu.org/software/emacs/ GNU Emacs] です。

{{Pkg|emacs}} パッケージを[[インストール]]してください。いつもターミナルで作業をする場合は、GTK+ がいらない {{Pkg|emacs-nox}} の方が良いでしょう (サウンドなどの装飾的な機能もありません)。
ただしテキストバージョンにはいくつか欠点が存在します: サポートしている色やフォント処理の機能 (実行中にサイズを変更したり、単一の文章で複数のサイズを使うなど) が少なくなっています。その上、emacs-nox には Speedbar や GUD (デバッグ環境) などの高度な機能について制限があり、複雑なフェイスを使おうとするとやや遅くなります ("フェイス"とは Emacs におけるテキストの外観のことです)。

極めて重い依存パッケージをインストールすることなく Emacs の拡張機能を全て完全に使いたい場合、必要に応じて PKGBUILD をカスタマイズすることができます。{{ic|gtk3}} 以外を使えば gconf を排除することが可能です。画像や音声のサポートも同じように無効にできます。Emacs のソースフォルダで {{ic|./configure --help}} を実行して利用可能なオプションを表示してみて下さい。
{{hc|PKGBUILD|<nowiki>
# ...
./configure --prefix=/usr --sysconfdir=/etc --libexecdir=/usr/lib \
--localstatedir=/var --with-x-toolkit=gtk2 --with-xft \
--without-gconf --without-sound
# ...
</nowiki>}}

他に {{AUR|xemacs}}{{Broken package link|パッケージが存在しません}} もよく使われています。

== Emacs の実行 ==

emacs を起動する前に、終了の方法を知っておきましょう (特にターミナルで実行する場合): {{ic|Ctrl+x}}{{ic|Ctrl+c}} キーシーケンスを使って下さい。

=== 通常の方法 ===

Emacs を起動するには次を実行:

$ emacs

また、コンソールから使うには:

$ emacs -nw

(.emacs を使わずに) 高速でロードして CLI で編集するには:

$ emacs -Q -nw

nox バージョンをインストールしている場合、'emacs' と 'emacs -nw' は同じになります。

ファイル名を指定することですぐにファイルを開くこともできます:

$ emacs filename.txt

=== 色無し ===

デフォルトでは、Emacs はハイパーリンクが濃青で表示されるカラーテーマで起動します。Emacs をカラーテーマやスキームを使わずに起動するには:

$ emacs -nw --color=no

このコマンドでは全てのテキストがターミナルの前景色だけで表示されます。通常は黒背景に白字か、白背景に黒字となります。

=== デーモンとして ===

毎回 {{ic|.emacs}} ファイルをロードするため Emacs を起動するときには時間が多少かかります。また、別のインスタンスから同じファイルにアクセスしたいと思うときもあるかもしれません。バージョン23から、Emacs はユーザーが接続できるデーモンとして起動することが可能になっています。Emacs をデーモンとして実行するには:

$ emacs --daemon

起動時にデーモンを実行してウィンドウをデーモンに接続すると良いでしょう。さらに、グラフィカル・コンソールクライアント''両方を''同意時にデーモンに接続して GUI を素早く起動することも可能です。

デーモンに接続したいときは場合は次のコマンドを使って下さい (グラフィカル環境から実行したときはグラフィカルクライアントが、tty などのコンソールから実行したときはコンソールクライアントが起動します):

$ emacsclient

グラフィカル環境にいるときもコンソールクライアントを使いたい場合は次のコマンドを使って下さい:

$ emacsclient -t

さらに、{{ic|-a ""}} パラメータを追加することもできます。
これで、最初にコマンドを実行したときは、デーモンとして emacs が起動します。バックグラウンドで動き続けるので後で呼び出した時に起動時間が早くなります (バッファも残り続けます)。

ターミナルや他のプログラムからクライアントを起動した場合、呼び出すプログラムを使うことで Emacs クライアントを閉じなくてもクライアントを使い続けることができます。そのためには、 {{ic|-n}} ({{ic|--no-wait}}) パラメータを使ってクライアントを起動します:
$ emacsclient -nc

Mutt や Git などのプログラムは (コミットメッセージを読むための) エディタが終了するまで待機するため、{{ic|-n}} パラメータを使うことはできません。デフォルトエディタが設定されている場合、他のエディタを指定する必要があるかもしれません (例: {{ic|emacsclient -a "" -t}})。

以下のシェル設定が利用できます:

{{bc|1=
alias emt='emacsclient -nc -a ""'
alias emc='emacsclient -t -a ""'
EDITOR='emacsclient -a ""'
}}
ただしこれには注意事項があります: コマンドのスペースの関係で多数のプログラムが外部エディタをロードすることはできません。

スクリプトを書くほうがもっと使い勝手が良く信頼性があります:
{{hc|/usr/local/bin/emc|<nowiki>
#!/bin/sh
if [ -z "$DISPLAY" ]; then
IS_GRAPHICAL=true
else
IS_GRAPHICAL=$(emacs --batch -Q --eval='(if (fboundp '"'"'tool-bar-mode) (message "true") (message "false"))' 2>&1)
fi

if $IS_GRAPHICAL; then
emacsclient -a "" -nc "$@"
else
emacsclient -a "" -t "$@"
fi
</nowiki>}}
スクリプトは実行可能属性を付けて下さい:
# chmod 755 /usr/local/bin/emc

これで 'emc' が期待通りに動作するようになります。このクライアントをデフォルトのエディタにしたいときは上記のスクリプトで {{ic|EDITOR}} 環境変数を設定すれば OK です。

=== systemd ユニットとして ===

Emacs 26.1 から systemd ユニットが含まれています。Emacs のインストール後に以下のように有効化してください:

$ systemctl --user enable --now emacs

Emacs サーバーを実行したいユーザーで上記のコマンドを実行してください。サービスの起動後、Emacs の準備ができます。ユニットファイルは {{ic|/usr/lib/systemd/user/emacs.service}} に存在します。ユニットファイルの中身は以下のようになっています:

{{hc|/usr/lib/systemd/user/emacs.service|<nowiki>
[Unit]
Description=Emacs text editor
Documentation=info:emacs man:emacs(1) https://gnu.org/software/emacs/

[Service]
Type=simple
ExecStart=/usr/bin/emacs --fg-daemon
ExecStop=/usr/bin/emacsclient --eval "(kill-emacs)"
Environment=SSH_AUTH_SOCK=%t/keyring/ssh
Restart=on-failure

[Install]
WantedBy=default.target
</nowiki>}}

systemd のユーザーユニットはログインシェル ({{ic|~/.bash_profile}} など) から環境変数を継承しないため、{{ic|~/.pam_environment}} に変数を設定すると良いでしょう。詳しくは [[Systemd/ユーザー]]を参照。

emacs をデーモンとして起動する場合、{{ic|VISUAL}} と {{ic|EDITOR}} 環境変数を {{ic|emacsclient}} に設定することでプログラムからエディタを起動するときにエディタの新しいインスタンスを起動するかわりに emacsclient が使われるようになります。外部エディタを使用するプログラムとしてメールプログラム (メッセージを編集するため) や Git (コミットメッセージを編集するため)、less ({{ic|v}} コマンドで表示されたファイルを編集するため) などが存在します。emacsclient の {{ic|-n}} ({{ic|--nowait}}) オプションは使用しないでください。基本的にプログラムはエディタが終了したときに編集が完了したと認識するためです。

GUI の Emacs のスタートメニューエントリなども emacs ではなく emacsclient が使われるように変更することを推奨します。

== クイックスタート ==

Emacs は複雑ですが、そのカスタマイズと拡張性のレベルによってもたらされる利益を理解し始めるのにそう時間はかからないでしょう。さらに、幅広い拡張を利用することで Emacs はあらゆる種類の文章編集のための強力な環境に姿を変えることができます。

Emacs には素晴らしいチュートリアルが内蔵されており、スプラッシュ画面の最初のリンクをクリックしてアクセスできます。メニューから ''Help->Emacs Tutorial'' を選択するか 'F1' の後に 't' を押して下さい。このページは Emacs を始めるのに追加的なリソースになるように書かれています。

初心者にもエキスパートにも役立つ、リファレンスカードのセットも Emacs に含まれています、{{ic|/usr/share/emacs/<version>/etc/refcards/}} を見て下さい (<version> はあなたの emacs のバージョンに置き換えて下さい)。

=== 基本的な用語と慣習 ===

始めは慣れないと思うかもしれませんが Emacs にはいくつか特別な用語法と約束事があり、必要に応じて紹介していきます。ただ、Emacs を使うにあたって当然知ってるべきとされるような、基本的な用語についてはあらかじめ説明しておいたほうが良いでしょう。

真っ先に知るべきは''バッファ''の概念です。バッファは Emacs の中のデータを表します。例えば、Emacs でファイルを開いたとき、ディスクからファイルから読み込まれてバッファに中身が保存され、バッファを編集して後でディスクに上書き保存することができます。バッファはテキストに限られず、画像やウィジェットなども含めます。作業中でもバッファでアプリケーションを表示することすらできます。こういう考え方もできます: ディスク上のデータは'ファイル'であり、一方、Emacs 上のデータは'バッファ'である。

Emacs におけるキーシーケンスの決まり事も見慣れないかもしれません。即ち:

'''C-x''' は Control-x を示します

'''M-x''' は Meta-x を示します

{{Note|'Meta' は多くの場合 Alt キーに相当します。また、Esc キーを使うことも可能です。}}

例えば、Emacs を終了するには次のキーシーケンスを使います: '''C-x C-c'''。これは "Control を押しながら 'x' を押す。手を離す。Control を押しながら 'c' を押す" と読み替えることができます。Emacs にはメニューバーが存在しますが、キーシーケンスを使いこなせるように練習することを推奨します。以下から、Emacs で使われるキーバインディングと慣習について説明します。

=== 移動 ===

カーソルの移動は他のグラフィカルエディタとよく似ています。マウスや方向キーを使ってカーソルの位置 (Emacs では''ポイント''と呼ばれます) を変更することができます。一般的な移動コマンドは方向キーで出来ますが、Emacs には他にも便利なバインディングが存在します。1文字先に移動するには '''C-f''' を使用して、1文字前に移動するには '''C-b''' を使用します。'''C-n''' と '''C-p''' でそれぞれ次の行と前の行に移動できます。基本的に、マウスや方向キーを使うよりもこれらのキーシーケンスを使うことが推奨されています。

当然、Emacs には、単語や文単位で移動できる、もっと高度な移動コマンドが用意されています。'''M-f''' は1単語先に移動して '''M-b''' は1単語前にポイント移動します。同じく、'''M-e''' は1文先にポイント移動して '''M-a''' は前に戻ります。

ここまでは、紹介した全ての移動コマンドはポイントに関連しています。'''M-<''' を使うことでバッファの最初にポイントを移動することができ、逆に、'''M->''' はバッファの最後に移動します。特定の行番号にポイントを移動するには、'''M-g g''' を使います。'''M-g g''' は移動したい行番号を尋ねます。また、現在の行の先頭と末尾に移動するには、'''C-a''' あるいは '''C-e''' を使って下さい。

{{Note|上記のコマンドを含む全てのコマンドのキーバインドは、現在有効になっているモードによって''多少''ながら変わってくる可能性があります。しかしながら、同一の機能を実行するのにコマンドを置き換えることはあまりありません。詳しくは[[#モード|モード]]を見て下さい。}}

=== ファイルとバッファ ===

Emacs にはファイルを操作するためのコマンドが用意されています。このセクションでは最もよく使われるコマンドを紹介します。ファイルを開くには '''C-x C-f''' を使います (Emacs ではこのコマンドを 'find-file' と呼びます)。指定されたファイルが存在しなかった場合、Emacs は空のバッファを開きます。バッファを保存するとバッファの中身が入ったファイルが作成されます。'''C-x C-s''' を使うことでバッファを保存できます。別のファイル名でバッファを保存するには、'''C-x C-w''' を使って下さい (this is a mnemonic for the command 'write-file')。新しいファイル名が尋ねられ、ディスクにファイルが書き込まれます。'''C-x s''' で全てのバッファを保存することも可能です。最後に保存されていた状態からバッファに変更が加えられている場合、保存を実行するかどうか訊くプロンプトが表示されます。

{{Note|ファイルに対応するバッファが既に開かれている場合 '''C-x C-f''' はディスクからファイルを読み込みません。ディスクからファイルを再度読み込むには、(1) まずバッファを閉じて ('''C-x k''')、それからファイルを開くか ('''C-x C-f''') あるいは (2) '''M-x revert-buffer''' を使ってディスク上のデータに戻して下さい。それか (3) '''C-x C-v''' でファイルを現在のバッファにロードするか (4) '''C-x RET r RET''' で同一コードでファイルを再読み込みしてください。}}

"find-file" や "write-file" などのインタラクティブなコマンドでは Emacs ウィンドウの一番下の行に入力が求められます。この行のことは''ミニバッファ''と呼びます。ミニバッファでは基本的な編集コマンドを使うことができ、多くの *nix シェルで利用できるのと同じようなタブ補完機能があります。'''<TAB>''' を2回連続で押すと補完リストが表示され、マウスを使ってリストから補完候補を選択することも可能です。ミニバッファでの補完はコマンドやファイル名など様々な形で使えます。

ミニバッファには履歴機能も存在します。前に入力したコマンドは '''Up Arrow''' または '''M-p''' を使うことで再呼び出しできます。

ミニバッファは '''C-g''' を押すことでいつでも終了できます。

ファイルを複数開いたら、ファイルを切り替える手段が必要です。Emacs 内に既に存在するバッファにファイルを開くと、Emacs はそのバッファに切り替えます。しかしながらこれは効率的とは言えません。Emacs には表示するバッファを選択する '''C-x b''' が存在します (タブ補完が使えます)。存在しないバッファの名前を入力すると、その名前で新しいバッファが作成されます。

{{Note|前のバッファに切り替えるには '''C-x b <RET>''' を使います。前のバッファがデフォルトだからです。}}

全てのバッファのリストを '''C-x C-b''' で表示することができます。バッファが必要なくなったときは '''C-x k''' で削除することが可能です。

=== 編集 ===

Emacs には多数の編集コマンドが存在します。まだ紹介していない最も重要なコマンドはおそらく 'undo' でしょう。'''C-_''' または '''C-/''' で実行することができます。基本的に移動コマンドには対応する削除コマンドが存在します。例えば '''M-<backspace>''' で後方の単語を削除することができ、{{ic|M-d}} で前方の単語を削除できます。行末または文章の終わりまで削除するにはそれぞれ {{ic|C-k}} または {{ic|M-k}} を使います。

1行は80文字を超えていはいけないという経験則が存在します。1行の長さを長くしすぎないことで、特にウィンドウの縁で改行してしまうような場合に、可読性を維持することができます。改行の自動挿入 (または削除) は Emacs では詰め込み (''filling'') と呼ばれます。{{ic|M-q}} を使うことでパラグラフを折り返させることができます。

文字列と単語はそれぞれ {{ic|C-t}} と {{ic|M-t}} で置き換えることが可能です。例えば {{ic|Hello World!}} を {{ic|World! Hello}} と置き換えられます。

単語の大文字小文字はすぐに修正できます。{{ic|M-l}} は単語を小文字に変換し ({{ic|HELLO}} は {{ic|hello}})、{{ic|M-u}} は単語を大文字に変換します ({{ic|hello}} は {{ic|HELLO}})。そして {{ic|M-c}} は単語の最初の文字を大文字にして他の文字は小文字にします ({{ic|hElLo}} は {{ic|Hello}})。

=== kill と yank とリージョン ===

A region is a section of text between two positions. One of those positions is referred to as ''mark'', and the other is point. '''C-<SPC>''' is used to set the position of mark, after which point can be moved to create a region. Within GNU Emacs 23.1 onwards, this region is visible by default. There are a number of commands which act upon regions, among the most commonly used are ''killing'' commands.

In Emacs, cut and paste are referred to as ''kill'' and ''yank'', respectively. Many commands which delete more than one character (including many of those in the above section, such as '''C-k''' and '''M-d''') actually cut the text and append it to what is known as the ''kill-ring''. The kill-ring is simply a list of killed text. The kill-ring stores up to the last 60 kills by default. Successive kills are concatenated and stored at the head of the list.

'''C-w''' and '''M-w''' can be used to kill and copy a region, respectively.

To insert killed text into a buffer (known as 'yanking'), use '''C-y'''. '''C-y''' can be used multiple times in succession to yank text repeatedly. As mentioned, previous kills are stored in a list, however '''C-y''' only retrieves the first of them. The earlier kills can be accessed via '''M-y'''. This will remove the text inserted by 'yank' initially, replacing it with the text killed earlier. '''M-y''' must be used immediately following '''C-y''' and can be used in many times succession to cycle through the kill-ring.

=== 検索と置換 ===

Searching for a string is common practise in text-editing. This can be performed using '''C-s''' (to search forward) or '''C-r''' (to search backward). These commands prompt for the string for which to search. Searching is performed incrementally, and so it will match the next (or previous) occurrence as you type. 次の検索結果に行くにはC-sを、前の検索結果に行くにはC-rをおします。もし探しているものが見つかったのであれば、'''<RET>''' を押すことで検索を終了できます。 Alternatively, should you wish to return to the location you initiated the search, use '''C-g'''.

Once a search is completed (i.e., was not aborted with '''C-g''' or similar), the string which was searched for will be the default for any following search. To make use of this, press '''C-s C-s''' or '''C-r C-r''' to search forward or backward again, respectively.

I-search has some useful commands. Use '''M-e''' to edit the search field. Use
'''M-c''' to toggle case-sensitive matching.

Regular Expression searches behave identically to the searching described above except for the command to initiate the search. Use '''C-M-s''' or '''C-M-r''' to initiate a regexp search forward or backward, respectively. Once a Regular Expression search has commenced, '''C-s''' and '''C-r''' can be used to search forward or backward, just as with string searches.

In addition to searching, it is also possible to perform string and regular expression replacement (via '''M-%''' and '''C-M-%''', respectively). Prompts are provided for both the initial and replacement text, and then another prompt for the action to perform on the highlighted match. Although many options are available (the full list is available by pressing '''?'''), the most commonly used are '''y''', to perform replacement, '''n''', to skip this match, and '''!''' to replace this, and all following matches.

=== 前置引数 ===

'''C-u''' corresponds to the 'universal-argument' command. Providing a 'universal-argument' is a way to provide more information to a command (this information is referred to as a 'prefix argument'). For instance

C-u 80 %

will insert a line of percent signs. Or

C-u 4 M-d

Will delete 4 words. In this case, we provided the amount of words desired to the command invoked by '''M-d'''.

You can make it a little quicker by using the equivalent '''M-<number>''' as universal argument.

M-80 %

=== インデント ===

Indentation is usually performed with either '''<TAB>''', to indent a single line, or with '''C-M-\''', to indent a region. If the region is active (''i.e.'' highlighted), then '''<TAB>''' will also indent region.

Exactly how text is indented usually depends on the ''major-mode'' which is active. Major-modes often define indentation styles specialising in indenting a certain type of text. (See [[#モード|Modes]] for more information.)

In some cases, a suitable major-mode may not exist for a file type, in which case, manual indentation may be necessary. Create a region (see [[#kill と yank とリージョン|Killing, yanking and regions]]) then perform indentation with '''C-u <n> C-x <TAB>''' (where '<n>' is the number of columns which the text within the region should be indented). For example:

Increase the region's indentation by four columns:

C-u 4 C-x <TAB>

Decrease the region's indentation by two columns.

C-u -2 C-x <TAB>

=== ウィンドウとフレーム ===

Emacs is designed for convenient editing of many files at a time. This is achieved by dividing the Emacs interface into three levels. Namely, buffers, which have already been introduced, as well as ''windows'' and ''frames''.

'''ウィンドウ'''とは、Emacsでバッファを表示している場所のことです。 A window can display only one buffer at a time, however one buffer can be displayed in many windows. Beneath each window exists a ''mode-line'', which displays information for that buffer.

A '''frame''' is an Emacs "window" (in standard terminology. i.e., 'window' in the sense of the modern desktop paradigm) which contains a title bar, menu bar and one or more 'windows' (in Emacs terminology. i.e., the above definition of 'window').

From now on the definition of these terms as they exist in Emacs will be used.

To split the window horizontally or vertically use '''C-x 2''' or '''C-x 3''', respectively. This has the effect of creating another window in the current frame. To cycle between multiple windows, use '''C-x o'''.

The opposite of splitting a window, is deleting it. To delete the current window, use '''C-x 0''' and '''C-x 1''' to delete all windows except the current.

As with windows, it is also possible to create and delete frames. '''C-x 5 2''' creates a frame. With '''C-x 5 0''' to delete the current frame and '''C-x 5 1''' to delete all except the current frame.

{{Note|These commands do not affect buffers. For example, deleting a window does not kill the buffer it displays.}}

=== モード ===

Emacs モードは Emacs Lisp で書かれた拡張であり、接続されているバッファの挙動を制御します。大抵の場合、インデントやシンタックスハイライト、テキストを編集するときのキーバインドを提供します。洗練されたモードは Emacs を完全な IDE (統合開発環境) に変貌させます。Emacs は基本的にファイルの拡張子でモードをロードすべきか判断します。

シェルスクリプトを編集するのに役立つモードとして sh-mode, line-number-mode, column-number-mode が存在します。同時に使用することができ、以下のコマンドで呼び出します:

'''M-x sh-mode <RET>'''

'''M-x column-number-mode <RET>'''

line-number-mode はデフォルトで有効になっていますが、コマンドを再度実行することでオンとオフを切り替えられます:

'''M-x line-number-mode <RET>'''

sh-mode is a ''major-mode''. Major-modes adjust Emacs, and often also provide a specialised set of commands, for editing a particular type of text. Only one major-mode can be active in each buffer. In addition to syntax highlighting, and indentation support, sh-mode defines several commands to help write shell scripts. The following shows a few of those commands:

'''C-c (''' Insert a function definition

'''C-c C-f''' Insert a 'for' loop

'''C-c TAB''' Insert an 'if' statement

'''C-c C-w''' Insert a 'while' loop

'''C-c C-l''' Insert an indexed loop from 1 to n

'line-number-mode' と 'column-number-mode' は''マイナーモード''です。マイナーモードはメジャーモードを拡張することができ、同時に任意の数のマイナーモードを有効にできます。

=== マニュアル ===

Emacs を本当にマスターしたいのであれば、一番よく読むべき文章はやはり公式マニュアルです:
* Emacs: the complete Emacs user manual.
* Emacs FAQ.
* Emacs Lisp Intro: if you never used any programming language before.
* Elisp: if you are already familiar with a programming language.

You can access them as PDFs from [http://www.gnu.org/software/emacs/manual/ GNU.org] or directly from Emacs itself thanks to the embedded 'info' reader: '''C-h i'''. Press '''m''' to choose a book.

Some users prefer to read books using 'info' because of its convenient shortcuts, its paragraphs adapting to window width and the font adapted to current screen resolution. Some find it less irritating to the eyes. Finally you can easily copy content from the book to any Emacs buffer, and you can even execute Lisp code snippets directly from the examples.

You may want to read the '''Info''' book to know more about it: '''C-h i m info <RET>'''.
Press '''?''' while in info mode for a quick list of shortcuts.

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

前のセクションでは基本的な編集コマンドを説明していますが、それだけでは Emacs の可能性はわかりません。このセクションではより高度なテクニックや機能を紹介します。

ただし全てを説明するとなると長くなりすぎます。そのためこのセクションはあくまで Emacs の雅やかな機能をいくつか''デモ''するだけにとどめます。

全ての機能の詳細な説明は[[#ドキュメント|ドキュメント]]を見て下さい。

=== TRAMP ===

TRAMP (Transparent Remote Access, Multiple Protocols) は多数のプロトコルで、リモートファイルに透過的にアクセスすることができる拡張です。ファイル名を入力するときに、特定の形式を入力すると TRAMP が呼びだされます。例:

{{ic|/etc/hosts}} を root 権限で開く前に root のパスワードを要求するには:

C-x C-f /sudo::/etc/hosts

SSH で 'myhost' に 'myuser' として接続して {{ic|~/example.txt}} ファイルを開くには:

C-x C-f /ssh:myuser@myhost:~/example.txt

TRAMP のパスは '/[protocol]:[[user@]host]:<file>' という形式で指定します。TRAMP がサポートしているのは上記の例に限りません。詳しくは TRAMP の info マニュアルを参照してください。マニュアルは Emacs に付属しています。

=== キーボードマクロとレジスタ ===

This section will provide a practical demonstration of the use of a couple of more powerful editing features. Namely, ''keyboard macros'' and ''registers''.

The aim will be to produce a listing of a series of characters and their corresponding position in this list. While it is possible to format each of them by hand, this would be slow and error-prone. Alternatively, some of Emacs' more powerful editing functionality could be leveraged. Before describing a solution, some details behind the techniques which will be used follow.

The first feature which will be introduced is ''registers''. Registers are used to store and retrieve a variety of data types ranging from numbers to window configurations. Each register is given a name of a single character: this character is used to access the register.

The other which will be demonstrated is ''keyboard macros''. A keyboard macro stores a sequence of commands so they can be easily repeated later. These changes will now be performed step-by-step.

Starting with a buffer containing our set of characters:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

Prepare a register by invoking the `number-to-register' command ('''C-x r n''') then storing the number '0' in register 'k':

C-x r n k

With point at the beginning of the buffer, start a keyboard macro ('''C-x (''') and begin to format the characters:

C-x ( C-f M-4 .

Insert ('''C-x r i''') and increment ('''C-x r +''') the register 'k'. The prefix argument ('''C-u''') is used to leave point positioned after the inserted text:

C-u C-x r i k C-x r + k

Complete the formatting by inserting a newline. Emacs can then repeat that process, beginning from the point where we started defining the keyboard macro, for the rest of the characters. '''C-x e''' completes then invokes the keyboard macro. The prefix argument, '''M-0''', causes the macro to repeat until it comes across an error. In this case it aborts once it reaches the end of the buffer.

<RET> M-0 C-x e

The result:

A....0
B....1
C....2
[...]
x....49
y....50
z....51

If you want to save your macro for later use, you must give it a name and save it to your configuration file:
name-last-kbd-macro
insert-kbd-macro

All defined macros are stored in the macro ring. To cycle between macros, use
'''C-x C-k C-n''' next macro
'''C-x C-k C-p''' previous macro

You can also use registers to save virtually anything.

'''C-x r SPC''' Copy current point (position) to register
'''C-x r w''' Copy current window configuration to register.
'''C-x r j''' Restore register.

So if you often work with windows side by side, for different project, you can save the configuration for the different projects and easily switch from one view to the other.

You can list used registers with the '''list-registers''' command.

=== 正規表現 ===

Emacs Manual より: "正規表現 (''regexp'' と略す) とは、一致する可能性がある一連の (無限個でもよい) 文字列を表現するパターンである"。このセクションでは正規表現自体には深くは立ち入りません (単純に説明しきれない)。そのかわり正規表現のパワーを簡単にデモンストレーションします。詳しい説明は Emacs Manual の [https://www.gnu.org/software/emacs/manual/html_node/elisp/Regular-Expressions.html#Regular-Expressions Regular Expressions] セクションを見て下さい。

Given the same scenario presented above: A list of characters which are to be formatted to represent their respective position in the list. (see [[#キーボードマクロとレジスタ|Keyboard macros and registers]]). Again, starting with a buffer containing.

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

At the beginning of the buffer, use '''C-M-%''' (if the key-sequence is difficult to perform, it may be more comfortable to use '''M-x query-replace-regexp'''). At the prompt:
$.$
which simply matches one character. Then, when prompted for the replacement:
\1....\#^J
{{Note|'^J' represents where a newline should be placed, it should not be entered into the prompt. The newline must instead be inserted literally using '''C-q C-j'''.}}
The replacement expression reads: "Insert the matched text between the first set of parentheses (in this case, a single character), followed by 4 periods then insert an automatically incremented number followed by a newline.

Finally, press '''!''' to apply this across the entire buffer. All of the formatting that was performed in the previous section was performed with a single regexp replacement.

=== 矩形選択 ===

先進的なテキストエディタが当然備えているべき強力な機能として、テキストを矩形で選択・編集できるというのがあるでしょう。

Emacs でも矩形選択は可能です。'''C-SPC''' で普通にテキストを選択してから、複数の矩形コマンドを使うことができます。

'''C-x r t''' Replace rectangle with text.
'''C-x r k''' Kill (and save in kill-ring) rectangle.
'''C-x r y''' Yank rectangle.
'''C-x r o''' Blank out rectangle.

たとえハイライトされていても、上記のコマンドが矩形の外のテキストに影響を与えることはありません。

=== ブックマーク ===

Emacs は開いたファイルのリストを記録できます。

'''C-x r m''' カレントバッファをブックマークに追加。
'''C-x r b''' ブックマークからバッファを開く。
'''C-x r l''' ブックマークの確認。

=== Elisp インタプリタ ===

Evaluate an elisp expression using '''eval-last-sexp''' ('''C-x C-e'''). Emacs always spawns a '''*scratch*''' buffer when started. It will not be saved to disk, feel free to add any text / code you want. It is especially useful for elisp evaluation. Note that this buffer starts using '''lisp-interaction-mode''' by default.

Alternatively, Emacs provides a top-level elisp interpreter with the '''ielm''' command.

=== スマートなウィンドウ切り替え ===

長い間使っていると '''C-x o''' による伝統的なウィンドウ切り替えは面倒かもしれません。'''windmove''' コマンドはもっと便利にウィンドウを切り替えることができます。{{ic|Shift}} を押しながら方向キーでウィンドウを指定するだけです。

windmove キーを有効にするには、設定ファイルに以下を記述してください:

{{hc|~/.emacs|
(when (fboundp 'windmove-default-keybindings)
(windmove-default-keybindings))
}}

=== シェルコマンドの実行 ===

Use '''M-!''' to call an external command. Use a prefix argument ('''C-u M-!''') to output the result to current buffer at point.

You can use '''M-|''' on a region to use it as input for a command. For instance

'''C-u M-| sort -u RET'''

will sort region, remove duplicates and replace the region with the result.

=== シェルバッファ ===

You can spawn a shell buffer and execute commands just like you would do in any terminal.
A classic shell buffer can be spawned with the '''shell''' command.

Emacs features a very powerful shell entirely written in Emacs Lisp, the '''eshell'''. The major advantage over shells like csh or zsh is that the native shell language is elisp itself. So you can use all advanced feature of elisp for your shell functions.

=== 対応する括弧のハイライト ===

'''show-paren''' モードを使うことができます。デフォルトでは、対応する括弧が表示されるまで少し遅延がありますが、'''show-paren-delay''' を 0 に設定することでなくすことができます。

{{hc|~/.emacs|
(setq show-paren-delay 0)
(show-paren-mode 1)
}}

=== スペルチェック ===

辞書を選択するには:
'''M-x ispell-change-dictionary'''

To check a single work use '''M-$'''.
You can start checking the whole buffer with
'''M-x ispell-buffer'''

You can enable on-the-fly spell checking by enabling the '''flyspell-mode'''. For source code files you can restrict the mode to comments by using the '''flyspell-prog-mode''' instead. You will also need the ''aspell'' package for spelling in Emacs. There are corresponding packages for each language, so for English, you'd also want ''aspell-en'' (as well as ''aspell'').

=== テーブル ===

Emacs comes with some powerful functions to handle and generate tables for various languages. Let's show an example.

Fruits Quantity
Apples 5
Melons 2

Now select the previous content in a region, and run
table-capture

Use two spaces for the column delimiter, and a line break ('''C-q C-j''') for the row delimiter.
This will lead to the following result.

+------+--------+
|Fruits|Quantity|
+------+--------+
|Apples|5 |
+------+--------+
|Melons|2 |
+------+--------+

You can revert back the operation with
table-release
There is a lot of handy ''table-*'' functions, like ''table-insert-row'', ''table-span-cell'', ''table-widen-cell'', etc.

Finally, the ultimate purpose of the ''table'' functions is to convert it to the desired markup language.
Use the ''table-generate-source'' for that.
For LaTeX, the previous table would result in

% This LaTeX table template is generated by emacs 24.2.1
\begin{tabular}{|l|l|}
\hline
Fruits & Quantity \\
\hline
Apples & 5 \\
\hline
Melons & 2 \\
\hline
\end{tabular}

Using the table mode you can also do some spreadsheet work like sum on rows and columns, but you will quickly find it limited. Besides it is quite slow. Have a look at the [[#予定表、スプレッドシート、文章作成|org-mode]] for much more powerful possibilities.

=== 予定表、スプレッドシート、文章作成 ===

Emacs can offer powerful office features thanks to the famous and powerful [http://orgmode.org/ Org mode]. This mode is part of the standard Emacs distribution.

Org mode is originally a powerful TODO and Agenda agent, but has quickly evolved to a much wider set of features.
There is simply too much to tell about Org that we cannot aford even to skim over all the features. So we will only whet your appetite with a few exemples.

Open a new file TODO.org file, Org mode should be loaded. If not, switch to it with '''M-x org-mode'''.
{{hc|TODO.org|
* First entry
** Subentry
Some comments
*** Subsubentry
* Second entry
- List item 1
- List item 2
}}

Now a few useful bindings.
* '''TAB''' to cycle-fold current entry.
* '''S-TAB''' to cycle-fold all entries.
* '''M-RET''' to start a new item on the same level as the current one.
* '''M-<left>''' and '''M-<right>''' to change level.
* '''M-<up>''' and '''M-<down>''' to move item together with all its subsections.
* '''S-<left>''' and '''S-<right>''' to change status. On list items it will change the item style.
* '''S-<up>''' and '''S-<down>''' to change priority.
* '''C-c ^''' to sort all subentries of the current entry.
* '''C-c .''' to add a timestamp to the current entry. Use {{ic|Shift}} and arrows to skip days or weeks. Use the mouse on the calendar or press {{ic|Enter}} on a specific day to choose it.

The spreadsheet features are very comprehensive. Let's give an excerpt from the manual:

{{bc|<nowiki>
Finally, just to whet your appetite for what can be done with the
fantastic `calc.el' package, here is a table that computes the Taylor
series of degree `n' at location `x' for a couple of functions.

|---+-------------+---+-----+--------------------------------------|
| | Func | n | x | Result |
|---+-------------+---+-----+--------------------------------------|
| # | exp(x) | 1 | x | 1 + x |
| # | exp(x) | 2 | x | 1 + x + x^2 / 2 |
| # | exp(x) | 3 | x | 1 + x + x^2 / 2 + x^3 / 6 |
| # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 |
| # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2 |
| * | tan(x) | 3 | x | 0.0175 x + 1.77e-6 x^3 |
|---+-------------+---+-----+--------------------------------------|
#+TBLFM: $5=taylor($2,$4,$3);n3
</nowiki>}}
Org mode recognizes a table when the pipe '''|''' is the first non-whitespace character on line. In the previous text, no line was drawn. This is done automatically when '''TAB''' is pressed after an entry or the '''|-''' sequence. The result column was not written by hand neither, it is computed from the calc formula on the last line. Use '''C-u C-c C-c''' to recompute all values in a table.

There is also some handy row and column manipulation bindings like those for the TODO file. {{ic|Alt}} plus arrows will move columns and arrows.

For more in-depth details, refer to the official manual: '''C-h i m Org mode RET'''.

=== リファクタリングとスマート補完 ===

(Eclipse などの) IDE が大抵備えているプログラミング機能が必要な場合、[http://cedet.sourceforge.net/semantic.shtml Semantic] ツールが役に立ちます。Semantic は Emacs の標準ディストリビューションに含まれています。現在 C, C++, Scheme, Javascript, Java, HTML, Make がサポートされています。現在のサポート状況は [http://cedet.sourceforge.net/languagesupport.shtml CEDET のページ] で確認できます。

Open a file in your favorite programming language supported by Semantic and turn on the Semantic minor mode with
M-x semantic-mode
Semantic will work for a few seconds parsing the libraries included from your file (in C that would mostly be the standard library for instance).

==== 機能 ====

Once done, you can start using the great Semantic features:
;Smart completion
Press '''C-c , SPC''' to complete a symbol at point. If it is an argument, it will check for type correctness.

;Jump to symbol
Press '''C-c , j''' to prompt for a symbol and jump to its definition. You can use auto-completion with '''TAB'''. Use a capital '''J''' to search for symbol accross files.

;List symbol calls
Press '''C-c , g''' to prompt for a symbol and list the places where it is being referred to. You can use '''n''' and '''p''' to navigate through the resulting entries. Press '''RET''' to toggle details, and '''RET''' again on a reference to jump to it. Use a capital '''G''' in the first command to work across files.

;Refactoring
First list use of the symbol you want to refactor with the aforementioned command. Now press '''(''' to start defining a macro on the symbol. This is actually much more powerful than refactoring since you can apply any function to the symbol and even act on its surrounding symbols. Press '''C-x )''' to finish the macro and '''E''' to call it.

;Describe symbol
Call the following function to display details on a symbol.
semantic-ia-show-summary
This can be very useful for complexe data structures and function prototypes. There is no binding by default.

==== 設定 ====

Here follows a sample configuration for use of Semantic with all supported programming languages: an example binding and a display configuration.
;; Semantic with ghost display (allows M-n and M-p to browse completion).
(semantic-mode 1)
(define-key my-keys-minor-mode-map (kbd "C-c , d") 'semantic-ia-show-summary)
(setq semantic-complete-inline-analyzer-displayor-class 'semantic-displayor-ghost)

You can also add some specialization for a specific language. Here for C:
(add-hook
'c-mode-hook
(lambda ()
(local-set-key (kbd "M-TAB") 'semantic-complete-analyze-inline)
(local-set-key "." 'semantic-complete-self-insert)
(local-set-key ">" 'semantic-complete-self-insert)))

==== 文献 ====

Emacs から直接 info マニュアルにアクセスすることが可能です: '''C-h i m Semantic RET'''。

=== Emacs を git のマージツールとして使う ===

By default, Git provides support for using Emacs' Emerge mode as a merge tool. However you may prefer the Ediff mode. Unfortunately this mode is not supported by git for technical reasons. There is still a way to use it by evaluating some elisp code upon emacs call.

{{hc|.gitconfig|<nowiki>
[mergetool.ediff]
cmd = emacs --eval \" (progn (defun ediff-write-merge-buffer () (let ((file ediff-merge-store-file)) (set-buffer ediff-buffer-C) (write-region (point-min) (point-max) file) (message \\\"Merge buffer saved in: %s\\\" file) (set-buffer-modified-p nil) (sit-for 1))) (setq ediff-quit-hook 'kill-emacs ediff-quit-merge-hook 'ediff-write-merge-buffer) (ediff-merge-files-with-ancestor \\\"$LOCAL\\\" \\\"$REMOTE\\\" \\\"$BASE\\\" nil \\\"$MERGED\\\"))\"

[merge]
tool = ediff
</nowiki>}}

Note that the command has to be on a single line.
In the above example, we launch a new instance of Emacs. You might want to use emacsclient for quicker startup; it is not recommended though since the Ediff call is not really clean: it could mess with your current Emacs session.

If you want an instant startup you can use the '''-q''' parameter. If you want to launch Emacs quickly while preserving at least a part of your configuration, you can call Emacs with
emacs -q -l ~/.emacs-light
where the light configuration file loads only what you need for Ediff.

See [http://kerneltrap.org/mailarchive/git/2007/7/1/250424 kerneltrap.org] and [https://stackoverflow.com/questions/1817370/using-ediff-as-git-mergetool stackoverflow] for more details on this trick and the Ediff issue.

=== Caps Lock キーを Control キーとして使う ===
いわゆる 'emacs 小指' にならないようにこちらの挙動を好むユーザーもいます。X で試用してみたいときは、次を実行:
$ setxkbmap -option 'ctrl:nocaps'

また、キーを'''交換'''するには、次を実行:
$ setxkbmap -option 'ctrl:swapcaps'

永続的に設定したくなったら、{{ic|.xinitrc}} ファイルに上のコマンドを追加してください。

リージョンを小文字から大文字にする必要がある場合は、デフォルトの {{ic|C-x C-u}} キーバインディングを使って下さい、{{ic|upcase-region}} 関数が呼び出されます。

Caps Lock がない場合は、両方の "Shift" にマッピングしてください:
$ setxkbmap -option "shift:both_capslock"

一部のデスクトップ環境にはキーボードのマッピングを変更するためのグラフィカルなツールが含まれています。例えば [[Plasma|Plasma 5]] ならシステム設定を開いて入力デバイスをクリックしてください。キーボードを選択して高度な設定タブから Caps Lock を Ctrl として使用するように設定できます。

== カスタマイズ ==

Emacs は {{ic|~/.emacs}} を編集するか '''M-x customize''' を使うことで設定をすることができます。このセクションでは手動で {{ic|~/.emacs}} を編集する方に焦点をあて、いくつかのカスタマイズ例を示すことで、一般的な Emacs の設定をデモンストレーションします。customize コマンドは調整を行うためのシンプルなインターフェイスを提供しますが、おそらく Emacs に慣れてくるにつれて制約を感じるようになるでしょう。

All of the examples here can be performed while Emacs is running. To evaluate the expression within Emacs, use:

'''C-M-x''' with point anywhere within the expression.

or

'''C-x C-e''' with point following the last ')'

For some users, typing 'yes' and 'no' in prompts can quickly become tiring. To instead use the 'y' and 'n' keys at these prompts:

(defalias 'yes-or-no-p 'y-or-n-p)

カーソルの点滅を止めるには、次を使用:

(blink-cursor-mode -1)

同じく、前のセクションにある column-number-mode を有効にするには:

(column-number-mode 1)

The similarities between the previous two commands are not a coincidence: blink-cursor-mode and column-number-mode are both minor-modes. As a rule, minor-modes can be enabled given positive argument or disabled with a negative argument. Should the argument be omitted, the minor-mode will be toggled on/off.

Here are some more examples of minor-modes. The following will disable the scroll bars, menu-bar and tool-bar, respectively.

(scroll-bar-mode -1)
(menu-bar-mode -1)
(tool-bar-mode -1)

The variable, 'auto-mode-alist', can be modified to change the major-mode used by default for certain file names. The following example will make the default major-mode for '.tut' and '.req' files 'text-mode'.

(setq auto-mode-alist
(append
'(("\\.tut$" . text-mode)
("\\.req$" . text-mode))
auto-mode-alist))

Settings can also be applied on a per-mode basis. A common method for this is to add a function to a ''hook''. For example, to force indentation to use spaces instead of tabs, but only in text-mode:

(add-hook 'text-mode-hook (lambda () (setq indent-tabs-mode nil)))

Similarly, to only use spaces for indentation everywhere:

(setq-default indent-tabs-mode nil)

Keybindings can be adjusted in two ways. The first of which is 'define-key'. 'define-key' creates a keybinding for a command but only in one mode. The example below will make '''F8''' delete any whitespace from the end of each line of a 'text-mode' buffer:

(define-key text-mode-map (kbd "<f8>") 'delete-trailing-whitespace)

The other method is 'global-set-key'. This is used to bind a key to a command everywhere. To bind 'query-replace-regexp' ('''C-M-%''') to '<f7>'.

(global-set-key (kbd "<f7>") 'query-replace-regexp)

Binding a command to an alternate key does not replace any existing bindings. Which is to say, 'query-replace-regexp' would be bound to both '''F7''' and '''C-M-%''' after the above example.

Almost anything within Emacs can be configured. Browsing through the [http://emacswiki.org/ Emacs Wiki] should give a solid place to start.

=== マルチ設定 ===

複数の設定を使い、Emacs にどれか一つをロードさせることができます。

例えば、2つの設定ファイルを定義してみましょう。

{{hc|.emacs|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/plugins" nil t)
(load "~/.emacs.d/theme" nil t)
}}

This is the full configuration we load for the daemon. But the ''plugins'' file is huge and slow to load. If we want to spawn a new Emacs instance that does not need the ''plugins'' features, it can be cumbersome to load it everytime in the long run.

{{hc|.emacs-light|
(load "~/.emacs.d/main" nil t)
(load "~/.emacs.d/functions" nil t)
(load "~/.emacs.d/modes" nil t)
(load "~/.emacs.d/theme" nil t)
}}

And now we launch Emacs with
emacs -q -l ~/.emacs-light
You can create an alias to ease the call.

=== ローカル・カスタム変数 ===

You can define variables in your configuration file that can be later one modified locally for a file.

(defcustom my-compiler "gcc" "Some documentation")

Now in any file you can define local variables in two ways, see [https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html the manual for complete details ]

* Using {{ic| M-x add-file-local-variable-prop-line}}, which adds a commented line at the beginning similar to:
// -*- my-compiler:g++; mode:c++ -*-
* Or you can use {{ic| M-x add-file-local-variable}} to add lines near the end of the file:
// Local Variables:
// my-compiler: g++
// mode: c++
// End:

Note that for the values to take effect, you will need to call {{ic|M-x revert-buffer}}.

Custom variables are considered unsafe by default. If you try to open a file that contains local variable redefining custom variables, Emacs will ask you for confirmation.

You can declare the variable as secure, thus removing the Emacs prompt for confirmation. You need to specify a predicate that any new value has to verify so that it can be considered safe.

(defcustom my-compiler "gcc" "Some documentation" :safe 'stringp)

In the previous example, if you attempt to set anything else than a string, Emacs will consider it insecure.

=== カスタムカラーとテーマ ===

''face'' を使うことで簡単に色をカスタマイズすることができます:
(set-face-background 'region "color-17")
(set-face-foreground 'region "white")
(set-face-bold-p 'font-lock-builtin-face t )

You can have let Emacs tell you the name of the face where the point is. Use the ''customize-face'' function for that. The facility will show you how to set colors, bold, underline, etc.

Emacs in console can handle 256 colors, but you will have to use an appropriate terminal for that. For instance URxvt has support for 256 colors. You can use the ''list-colors-display'' for a comprehensive list of supported colors. This is highly terminal-dependent.

=== SyncTeX サポート ===

Emacs は強力な LaTeX エディタです。LaTeX モードを必要に応じて自由に編集・作成することができます。

Still, there might be some challenges, like SyncTeX support. First you need to make sure your TeX distribution has it. If you installed TeX Live manually, you may need to install the ''synctex'' package.
# umask 022 && tlmgr install synctex

SyncTeX support is viewer-dependent. Here we will use Zathura as an example, so the code needs to be adapted if you want to use another PDF viewer.

(defcustom tex-my-viewer "zathura --fork -s -x \"emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"'\"'\"%{input}\"'\"'\")) (goto-line %{line}))'\""
"PDF Viewer for TeX documents. You may want to fork the viewer
so that it detects when the same document is launched twice, and
persists when Emacs gets closed.

Simple command:

zathura --fork

We can use

emacsclient --eval '(progn (switch-to-buffer (file-name-nondirectory \"%{input}\")) (goto-line %{line}))'

to reverse-search a pdf using SyncTeX. Note that the quotes and double-quotes matter and must be escaped appropriately."
:safe 'stringp)

Here we define our custom variable. If you are using AucTeX or Emacs default LaTeX-mode, you will have to set the viewer accordingly.

Now open a LaTeX source file with Emacs, compile the document, and launch the viewer. Zathura will spawn. If you press {{ic|Ctrl+Left click}} Emacs should place the point at the corresponding position.

=== Systemd ファイルのシンタックスハイライト ===

[https://github.com/holomorph/systemd-mode systemd-mode] を使うことができます。

もしくは init ファイルに以下を追加することで、簡単に emacs で systemd のファイル (サービスやタイマーなど) をカラー表示できます:

(add-to-list 'auto-mode-alist '("\\.service\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.timer\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.target\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.mount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.automount\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.slice\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.socket\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.path\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.netdev\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.network\\'" . conf-unix-mode))
(add-to-list 'auto-mode-alist '("\\.link\\'" . conf-unix-mode))

=== emacs-nox のクリップボードサポート ===

emacs-nox で [[Xorg]] クリップボードを使うには、{{Pkg|xclip}} を[[インストール]]して以下の関数を {{ic|~/.emacs}} に追加してください [https://lists.gnu.org/archive/html/help-gnu-emacs/2014-08/msg00189.html]:

{{bc|1=
;; use xclip to copy/paste in emacs-nox
(unless window-system
(when (getenv "DISPLAY")
(defun xclip-cut-function (text &optional push)
(with-temp-buffer
(insert text)
(call-process-region (point-min) (point-max) "xclip" nil 0 nil "-i" "-selection" "clipboard")))
(defun xclip-paste-function()
(let ((xclip-output (shell-command-to-string "xclip -o -selection clipboard")))
(unless (string= (car kill-ring) xclip-output)
xclip-output )))
(setq interprogram-cut-function 'xclip-cut-function)
(setq interprogram-paste-function 'xclip-paste-function)
))
}}

{{Tip|以下を追加することでターミナルマウスサポートも有効にできます:
{{bc|1=
;; xterm mouse support
(require 'mouse)
(xterm-mouse-mode t)
}}
[http://www.opensource.apple.com/source/emacs/emacs-51/emacs/lisp/mwheel.el mwheel.el] を参照。}}

== パッケージ ==

Emacs の機能はサードパーティ製のパッケージで拡張できます。公式にサポートされているパッケージマネージャとして {{ic|package.el}} が組み込まれていますが、Emacs のコミュニティメンバーによって書かれたパッケージマネージャが他にも存在します。{{ic|package.el}} は {{ic|package-archives}} 変数を使ってパッケージを検索します。デフォルトでは [https://elpa.gnu.org/ Emacs Lisp Package Archive (ELPA)] が含まれています。{{ic|M-x list-packages}} で Emacs が認識している全てのパッケージが列挙されたバッファが作成されます。マニュアル ({{ic|[https://www.gnu.org/software/emacs/manual/html_node/emacs/Packages.html (info "(emacs) Packages")]}}) にはさらに詳しい情報が載っています。

サードパーティ製のパッケージのアーカイブを追加することもできます。[https://melpa.org/ MELPA] が広く使われています。

人気の拡張の多くは {{ic|[community]}} リポジトリのパッケージや [[AUR]] からインストールできます。大抵の場合、パッケージの名前の前に 'emacs-' が付きますが (例: {{Pkg|emacs-lua-mode}})、常にそうなっているわけではありません (例: {{AUR|auctex}})。

{{Tip|Arch Linux の Wiki を編集している場合は [[Emacs Mediawiki]] パッケージが役に立ちます。}}

パッケージによっては設定ファイルに変更を加えないと機能が有効にならない場合があります。例えば、{{AUR|auctex}} をインストールしたときは、設定ファイルに以下を追加:

{{bc|
(load "auctex.el" nil t t)
(load "preview-latex.el" nil t t)}}

パッケージのソースコードや README で有効化する方法が書かれているはずです。

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

=== Emacs が 'Undefined color: "WINDOW_FOREGROUND"' というエラーメッセージで起動しない ===

{{Pkg|mcpp}} パッケージまたは {{Pkg|gcc}} パッケージをインストールする必要があります。''xrdb'' は [[X resources]] を前処理するために C のプリプロセッサ ''cpp'' を使用します。C のプリプロセッサがインストールされていない場合、''xrdb'' は C のプリプロセッサを実行しないため WINDOW_FOREGROUND が16進数のカラーコードに展開されません。

=== カラー出力の問題 ===

デフォルトでは、Emacs シェルはカラー表示に使われるエスケープシーケンスをそのまま表示してしまいます。つまり、カラー出力がされるべきところに変な記号が表示されます。

この問題を解決するには以下を {{ic|~/.emacs}} に記述してください:
(add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)

=== X ウィンドウでの文字の表示問題 ===

X ウィンドウで emacs を起動した時にメインウィンドウの文字が全て黒縁の白四角になってしまう場合 (対応するフォントがインストールされていない文字を表示したときと同じような記号)、{{Pkg|xorg-fonts-75dpi}} や {{Pkg|xorg-fonts-100dpi}} をインストールして X ウィンドウを再起動してください。

=== 起動が遅い ===

{{Tip|[[#systemd ユニットとして|systemd ユニットとして]] Emacs を起動する方法でも起動時間を短縮できます。}}

しばしば起動時間が遅くなる原因は2つあります。

どちらが原因なのか調べるために、次のコマンドで Emacs を実行してください:

$ emacs -q

このコマンドでも Emacs の起動が遅い場合、[[#不適切なネットワーク設定|不適切なネットワーク設定]]を参照してください。そうでない場合は、ほぼ確実に .emacs に問題があります。

* {{ic|/etc/hosts}} の設定が間違っていると、Emacs の起動が5秒以上遅くなることになります。詳しくはネットワーク設定ガイドの '[[ネットワーク設定#ホストネームの設定|ホストネームの設定]]' を見てください。

* A simple way to search for the cause is to comment-out (i.e., prefix lines with ';') suspect sections of your {{ic|~/.emacs}} (or {{ic|~/.emacs.d/init.el}}) then start Emacs again to see if there's any change. Keep in mind use of "require" and "load" can slow the startup down, especially when used with larger extensions. They should, as a rule, only be used when their target is either: needed once Emacs starts or provides little more than "autoloads" for an extension. Otherwise, use the 'autoload function directly. For example, instead of:

(require 'anything)

you might use:

(autoload 'anything "anything" "Select anything" t)

=== Cannot open load file: ... ===

The most common cause of this error is the 'load-path' variable not including the path to the directory within which the extension is located. To solve this, add the appropriate path to the list to be searched prior to attempting to load the extension:

(add-to-list 'load-path "/path/to/directory/")

When attempting to use packages for extensions and Emacs has been configured with a prefix other than '/usr', the load-path will need to be updated. Place the following in {{ic|~/.emacs}} prior to the instructions provided by the package:

(add-to-list 'load-path "/usr/share/emacs/site-lisp")

If compiling Emacs by hand, keep in mind that the default prefix is '/usr/local'.

=== デッドアクセントキーの問題: '<dead-acute> is undefined' ===

このバグについて Google で検索すると、次のリンクが見つかります:
https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00167.html

Explaining the problem: in recent versions of
b72
Emacs, the normal way to use accent keys doesn't work as expected. Trying to accent a word like 'fiancé' will produce the message above.

A way to solve it is just put the line above on your startup file, {{ic|~/.emacs}}:

(require 'iso-transl)

And no, it isn't a bug, but a feature of new Emacs versions. Reading the subsequent messages about it on the mail list, we found it (https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00179.html):

:''It seems that nothing is loaded automatically because there is a choice betwee iso-transl and iso-acc. Both seem to provide an input method with C-x 8 or Alt-<accent> prefix, but what you and I are doing is just pressing a dead key (^, ´, `, ~, ¨) for the accent and then another key to "compose" the accented character. And there is no Alt key used in this! And according to documentation it seems be appropriate for 8-bit encodings, so it should be pretty useless in UTF-8. I reported this bug when it was introduced, but the bug seems to be classified as a feature ... Maybe it's just because the file is auto-loaded though pretty useless. ''

=== C-M-% やその他のバインディングが emacs nox で動作しない ===

これはターミナルが Xorg よりも制限的であることが原因です。ただし、ターミナルによっては多くのバインディングを扱うことができることがあります。2つの解決法が考えられます:
* グラフィカルバージョンを使用する。
* サポートされているバインディングに変更する。

例:
{{hc|.emacs|
(global-set-key (kbd "C-M-y") 'query-replace-regexp)
}}

=== Emacs がフリーズする ===

シングルスレッドであるがゆえに、Emacs は様々な操作でブロックします。フリーズが発生する状況は様々です。例えば、Emacs はあなたからの入力を待っているのかもしれません (例えばあるフレームでミニバッファを開いているのに他のフレームで作業しようとしている場合など)。あるいは、Emacs は完了するまで時間のかかるコードを実行中なのかもしれません。あるいはバグを踏んだという可能性もあります。Emacs プロセスを殺さずに Emacs のブロックを解除する方法は複数存在します。

* {{ic|C-g}} を押してみる。Emacs が行っていることによっては、複数回押す必要があります。
* {{ic|ESC ESC ESC}} を押してみる。
* 他のターミナルで {{ic|killall -SIGUSR2 emacs}} を実行する。

=== Emacs-nox の出力が汚い ===

When working in a terminal, the color, indentation, or anything related to the output might become crazy. This is (probably?) because Emacs was sent a special character at some point which may conflict with the current terminal.
If this happens you can do {{ic|M-x redraw-display}}, which will redraw the terminal's display. If this problem happens frequently, you might want to bind the command to a key, e.g. by putting something like
(global-set-key (kbd "<f7>") 'redraw-display)
in your .emacs file.

Graphical Emacs does not suffer from this issue.

=== emacs ターミナルにおかしなエスケープ数字 (utf-8) が表示される ===

{{ic|.bashrc}} または {{ic|.zshrc}} で以下の変数をエクスポートしてください:

{{hc|1=~/.bashrc|2=
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
export TERM=xterm-256color
}}

小文字の utf を使っていることがエラーの原因です (例: en_US.utf-8)。

利用可能なロケールは {{ic|locale -a}} で確認できます。

=== tmux で emacs を使っているときに Shift + 矢印キーが動作しない ===

まず [[tmux]] の設定で xterm-keys を有効にしてください:
{{hc|.tmux.conf|
setw -g xterm-keys on
}}

しかしながら、この設定は他のキーコンビネーションを破壊します。それを修正するために、以下を emacs の設定に記述します:
{{hc|~/.emacs|
(defadvice terminal-init-screen
;; The advice is named `tmux', and is run before `terminal-init-screen' runs.
(before tmux activate)
;; Docstring. This describes the advice and is made available inside emacs;
;; for example when doing C-h f terminal-init-screen RET
"Apply xterm keymap, allowing use of keys passed through tmux."
;; This is the elisp code that is run before `terminal-init-screen'.
(if (getenv "TMUX")
(let ((map (copy-keymap xterm-function-map)))
(set-keymap-parent map (keymap-parent input-decode-map))
(set-keymap-parent input-decode-map map))))
}}

詳しくは [https://github.com/tmux/tmux/blob/master/FAQ#L242 tmux FAQ] を参照。

=== KDE でウィンドウのリサイズがおかしい ===
KDE ユーザーには Emacs のウィンドウが正しくリサイズされないという現象がおこることがあります。リサイズした部分が透過されマウスでクリックしても下のウィンドウがクリックされます。この挙動を修正するには、KDE の GTK3 テーマを oxygen-gtk 以外のテーマに変更してください。例えば、{{Pkg|gtk3}} に含まれている Emacs テーマを使って下さい。

KDE で Emacs を完全に最大化するには、タイトルバーの Emacs アイコンをクリックして、More Actions > Special Window Settings を選択してください。そして "Size & Position" タブで "Obey geometry restrictions" を選択して、ドロップダウンメニューで "Force" を選んで右のラジオボタンで "No" を選んで下さい。

== 派生 ==

Emacs の実装は多数存在します。おそらく GNU/Emacs が一番ポピュラーです。

軽量な Emacs 互換のテキストエディタは Arch のリポジトリや [[AUR]] にあります。

=== mg ===

mg (旧名 MicroGnuEmacs) は C で書かれた軽量な Emacs の実装です。

{{Pkg|mg}} パッケージから入手できますが、上流の [http://homepage.boetes.org/software/mg/ ページ] からソースをダウンロードすることも可能です。mg は UTF-8 をサポートしていません。

=== zile ===

公式ウェブ[https://www.gnu.org/software/zile/ ページ]によると "GNU Zile は軽量な Emacs クローンです。Zile は Zile Is Lossy Emacs の略となっています。Zile は出来る限り Emacs に近づくように書かれており、きっと全ての Emacs ユーザーの手に馴染むでしょう"。Zile は UTF-8 をサポートしていません。

{{Pkg|zile}} パッケージからインストールできます。

最新の tarball は公式の GNU [http://ftp.sh.cvut.cz/MIRRORS/gnu/pub/gnu/zile/ ミラー] から落とせます。

=== uemacs ===

Linus Torvalds によるカスタム版 Micro-emacs。{{AUR|uemacs-git}} でインストール可能。

最新 (2005) の tarball は [ftp://ftp.cs.helsinki.fi/pub/Software/Local/uEmacs-PK/ こちら] にあります。

=== remacs ===

'''remacs''' はコミュニティによる Emacs の Rust 移植です。{{AUR|remacs-git}} パッケージでインストールできます。

== 参照 ==

* [https://www.gnu.org/software/emacs/ GNU Emacs ホームページ]
* [https://www.gnu.org/software/emacs/manual/emacs.html GNU Emacs マニュアル]
* [http://www.emacswiki.org/cgi-bin/wiki/ Emacs Wiki]
* [http://wikemacs.org WikEmacs - 読みやすいが不完全な Emacs wiki]
* [http://www2.lib.uchicago.edu/keith/tcl-course/emacs-tutorial.html Emacs とそのショートカットの有用な紹介]
* [https://d0edfcdc0ccc1cd13cdab5eb986fb92e8660dbef.googledrive.com/host/0B6LMD0u8OhYYZEotN2QyR1hwR1k/ Emacs 教会 (Google ドライブ)]
* [https://www.gnu.org/software/emacs/refcards/pdf/refcard.pdf 公式リファレンスカード]
* [[EXWM]] - Emacs X Window Manager

利用者:Linuxmetel

2020-05-23T03:08:31Z

Linuxmetel: ページの作成:「Arch系ではなく、Debian Sidユーザーですが、手伝えることがあれば手伝います。」

Arch系ではなく、Debian Sidユーザーですが、手伝えることがあれば手伝います。