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

HTTP トンネリング

2018-11-14T17:33:57Z

Ootaharuki99: 誤字を修正

[[Category:ネットワーク]]
[[Category:Secure Shell]]
[[en:HTTP tunneling]]
ネットワークにおいて、トンネリングとは上位の階層のプロトコル (この場合 HTTP) を使って低位の階層のプロトコル (この場合 TCP) を転送することです。

== トンネルの作成 ==

=== corkscrew と HTTP CONNECT を使う ===

SSH デーモンが動いているサーバーに接続をするために、HTTP CONNECT メソッドを使うことで HTTP CONNECT リクエストを HTTP プロキシに送信することによりプロキシを通してクライアントをサーバーに接続することができます。

{{Note|プロキシが HTTP CONNECT メソッドをサポートしていない場合、下の他の方法を見て下さい。}}

HTTP プロキシによる SSH のトンネリングを行うためのツールである [http://www.agroman.net/corkscrew/ corkscrew] を使います。[[公式リポジトリ]]の {{Pkg|corkscrew}} パッケージでインストールできます。

SSH 接続を開くのはとても簡単です:
$ ssh user@server -o "ProxyCommand corkscrew $proxy_ip_or_domain_name $proxy_port $destination_ip_or_domain_name $destination_port"

必要なのはシェルを開くことだけでなく、SOCKS トンネルなので、以下のようにすることで {{Ic|localhost:$port}} に [[wikipedia:SOCKS|SOCKS]] プロキシを作成します:
$ ssh -ND {{Ic|$port}} user@server -o "ProxyCommand corkscrew $proxy_ip_or_domain_name $proxy_port $destination_ip_or_domain_name $destination_port"

==== Git のトンネリング ====

制限のきつい法人向けファイアウォールは [[Git]] の使用するポートを塞いでしまうことがあります。その場合でも、corkscrew などのユーティリティを利用して HTTP プロキシのトンネルを通してやることで Git を使うことができます。Git が {{ic|GIT_PROXY_COMMAND}} 環境変数の設定を認識できるなら、{{ic|$GIT_PROXY_COMMAND}} でコマンドを実行してネットワークソケットの代わりにプログラムの標準入出力を使うようにします。

スクリプトファイル {{ic|corkscrewtunnel.sh}} を作成:

#!/bin/bash

corkscrew ''proxyhost'' ''proxyport'' $*

{{ic|GIT_PROXY_COMMAND}} を設定:

$ export GIT_PROXY_COMMAND=''path-to-corkscrewtunnel.sh''

これで、HTTP プロキシを使って Git をトンネリングできるはずです。

=== httptunnel を使う ===

[[公式リポジトリ]]の {{Pkg|httptunnel}} でインストールすることができる [http://www.nocrew.org/software/httptunnel.html httptunnel] は HTTP リクエストでトンネル化した双方向性の仮想データ接続を作成します。HTTP リクエストは必要であれば HTTP プロキシを通して送信することが可能です。ファイアウォールに拘束されているユーザーはこれを上手く使うことができます。HTTP プロキシによる WWW アクセスが許可されていれば、httptunnel や telnet、または PPP を使ってファイアウォールの外にあるコンピュータに接続できます。

ウェブサーバーが既にポート 80 を listen している場合、バーチャルホストを作成することで hts サーバーにウェブサーバーからプロキシ要求させることが可能です。それについてはここでは触れません。

ウェブサーバーがポート 80 を listen していない場合:
*サーバー側:
$ hts --forward-port localhost:22 80
*クライアント側:
$ htc --forward-port 8888 example.net:80
$ ssh -ND user@localhost -p 8888
{{Note|As SSH thinks it is connecting to localhost it will not recognize the fingerprint and display a warning.}}
これで {{Ic|localhost:8888}} を [http://ja.wikipedia.org/wiki/SOCKS SOCKS] プロキシとして使うことができます。

=== proxytunnel を使う ===

[[公式リポジトリ]]から {{Pkg|proxytunnel}} パッケージを[[インストール]]してください。

$ ProxyCommand /usr/bin/proxytunnel -p some-proxy:8080 -d www.muppetzone.com:443

=== openbsd-netcat を使う ===

[[公式リポジトリ]]から {{Pkg|openbsd-netcat}} パッケージを[[インストール]]してください。

openbsd の netcat を使って接続を開くには:

$ ssh user@final_server -o "ProxyCommand=nc -X connect -x some-proxy:$proxy_port %h %p"

== トンネルを使う ==

[[プロキシ設定#SOCKS プロキシを使う]] を見て下さい。

Network UPS Tools

2018-06-29T15:48:08Z

Ootaharuki99: /* upsmon の設定 */ 誤字の訂正

[[Category:電源管理]]
[[en:Network UPS Tools]]
この記事では [http://networkupstools.org/ Network UPS Tools (NUT)] をインストールする方法を説明します。Network UPS Tools は数千の UPS に対応しています。使用している UPS がサポートされているかどうかは [http://networkupstools.org/stable-hcl.html ハードウェア対応リスト] で確認できます。

== インストール ==

{{AUR|network-ups-tools}} パッケージを[[インストール]]してください。

== 設定 ==

NUT には3つのデーモンが存在します:
* UPS と通信を行うドライバー。
* ドライバーを使用して UPS の状態を報告するサーバー (upsd)。
* upsd サーバーを監視して受信した情報に基づいて動作する監視デーモン (upsmon)。

UPS に複数のシステムを接続する場合、それぞれのシステムで upsmon サービスを実行することでネットワークを介して UPS の状態を受け渡して監視することができます。NUT には [http://networkupstools.org/docs/user-manual.chunked/ar01s06.html#_configuring_and_using 設定に関する詳しいドキュメント] が存在しますが、この記事では USB UPS とサーバーを使用してすべてひとつのシステムで監視する環境を扱います。

=== ドライバーの設定 ===

使用する UPS によって設定は変わります。上のハードウェア対応リストを見て、UPS に適したドライバーがどれか確認してください。{{man|8|nut-scanner|url=http://networkupstools.org/docs/man/nut-scanner.html}} ツールを実行することでシステムに接続されている NUT に対応したデバイスを検出することもできます。

USB で接続する UPS の多くは {{man|8|usbhid-ups|url=http://networkupstools.org/docs/man/usbhid-ups.html}} ドライバーを使用します:

{{hc|/etc/ups/ups.conf|...
[''upsname'']<nowiki>
driver = usbhid-ups
port = auto</nowiki>
}}

UPS デバイスには好きな名前を付けてください。詳しくは {{man|5|ups.conf|url=http://networkupstools.org/docs/man/ups.conf.html}} を参照。

=== upsd の設定 ===

デフォルトでは upsd はローカルホストにしか接続を開きません。{{ic|/etc/ups/upsd.conf}} を編集することで upsd のデフォルト設定を変更できます。詳しくは {{man|5|upsd.conf|url=http://networkupstools.org/docs/man/upsd.conf.html}} を見てください。

サーバーに接続してコマンドを実行するには監視用のユーザーを追加する必要があります ({{man|5|upsd.users|url=http://networkupstools.org/docs/man/upsd.users.html}} を見てください):

{{hc|/etc/ups/upsd.users|...
[''upsuser'']<nowiki>
password = </nowiki>''password''<nowiki>
actions = SET
instcmds = ALL</nowiki>
}}

設定したら {{ic|nut-server.service}} を[[起動]]・[[有効化]]してください。nut-driver が自動で起動します。

起動できたら、{{ic|upsc <upsname>}} を実行して UPS から情報を取得できます。コマンドの出力例:

{{bc|
battery.charge: 100
battery.charge.low: 10
battery.charge.warning: 20
battery.mfr.date: CPS
battery.runtime: 5550
battery.runtime.low: 300
battery.type: PbAcid
battery.voltage: 13.5
battery.voltage.nominal: 12
device.mfr: CPS
device.model: UPS CP1000AVRLCD
device.type: ups
driver.name: usbhid-ups
driver.parameter.pollfreq: 30
driver.parameter.pollinterval: 2
driver.parameter.port: auto
driver.parameter.synchronous: no
driver.version: 2.7.4
driver.version.data: CyberPower HID 0.4
driver.version.internal: 0.41
input.transfer.high: 140
input.transfer.low: 90
input.voltage: 122.0
input.voltage.nominal: 120
output.voltage: 122.0
ups.beeper.status: disabled
ups.delay.shutdown: 20
ups.delay.start: 30
ups.load: 0
ups.mfr: CPS
ups.model: UPS CP1000AVRLCD
ups.productid: 0501
ups.realpower.nominal: 600
ups.status: OL
ups.test.result: Done and passed
ups.timer.shutdown: -60
ups.timer.start: 0
ups.vendorid: 0764
}}

=== upsmon の設定 ===

最初に upsmon を設定して upsd に接続してイベントが発生したときにアクションを実行します。

以下の行を {{ic|/etc/ups/upsmon.conf}} に追加:

MONITOR ''upsname''@localhost 1 ''upsduser'' ''password'' master

''upsname'' は UPS の名前、''upsduser'' と ''password'' は {{ic|/etc/ups/upsd.user}} で設定したユーザーとパスワードに置き換えてください。

どんな警告をどこに送信するか、バッテリーが少なくなったときにどのようなアクションを行うかを設定できます。{{man|5|upsmon.conf|url=http://networkupstools.org/docs/man/upsmon.conf.html}} を見てください。

設定したら {{ic|nut-monitor.service}} を[[起動]]・[[有効化]]してください。

Banana Pi

2017-11-18T07:12:58Z

Ootaharuki99: /* SATA HDD */

[[Category:ARM アーキテクチャ]]
[[en:Banana Pi]]
[http://www.lemaker.org/ メーカーのウェブサイト] より:
:Banana Pi はオープンソースのシングルボードコンピュータです。Android 4.4, Ubuntu, Debian, Rasberry Pi イメージ, Cubieboard イメージなどを動作させることができます。AllWinner A20 SoC を使っており、1GB DDR3 SDRAM が搭載されています。

BananaPi は [[Wikipedia:ARMv7-A|ARMv7-A アーキテクチャ]]で作られたミニマルなコンピュータです。詳細は [http://www.bananapi.org/ プロジェクトのページ] や [http://www.bananapi.org/p/product.html 技術仕様書] を見て下さい。

Allwinner SoC を使うため、Banana ボードはドキュメントがよくまとまっている Sunxi Linux カーネルが動作します。ハードウェアやカーネルに関連することについては、[https://linux-sunxi.org/Main_Page Sunxi Wiki] も参照してください。

== イントロダクション ==
この記事は [[Raspberry Pi]] のページが元になっています。さらに、この記事は詳しい手順を解説したセットアップガイドではなく、あくまで読者が既に Arch 環境をセットアップした経験があることを前提とします。Arch の初心者は[[ビギナーズガイド]]を読むようにしてください。特にユーザーの作成やシステムの管理などについてよくわからないときは必読です。

== Arch Linux ARM のインストール ==
=== ソースのダウンロード ===
まず、あなたのボードに合わせて適当なイメージをダウンロードします。Banana Pro で Banana Pi 用のイメージをインストールことも可能ではありますが、無線のサポートなどの機能は含まれていません。

* [http://www.lemaker.org/portal.php?mod=list&catid=4 Banana Pi 用の Arch イメージ]
* [http://www.lemaker.org/portal.php?mod=list&catid=5 Banana Pro 用の Arch イメージ]

こちらの [http://blog.eldajani.net/banana-pi-arch-linux-customized-distribution/ Pi 用の Arch / LXDE ディストリビューション] のように、カスタマイズされたイメージを使うこともできます。

=== インストール ===

[http://wiki.lemaker.org/SD_card_installation Banana Pi のドキュメント] を見て下さい。[http://www.lemaker.org/article-26-1.html Arch Linux イメージ] をダウンロードして、展開し、SD カードに書き込む必要があります。SD カードの容量が 4GB 以上あるときは、{{ic|parted}} などのツールでファイルシステムをリサイズできます。

== ネットワーク ==

=== SSH ===
デフォルトで [[Secure_Shell|SSH デーモン]]がインストールされるようになっています。デフォルトのログインデータは:
{| class="wikitable"
! タイプ
! ユーザー名
! パスワード
|-
|Root
|{{ic|root}}
|{{ic|bananapi}}
|-
|User
|{{ic|bananapi}}
|{{ic|bananapi}}
|}

== X.org ドライバー ==

Banana Pi 用の X.org ドライバーは ''xf86-video-fbdev'' パッケージでインストールできます。

== トラブルシューティング ==
=== HDMI 1080p 解像度 ===
デフォルトの 1280x720/60Hz から 1920x1080/60Hz に解像度を変更する方法は2つあります。

==== 手動で解像度を変更 ====
利用可能な HDMI 解像度を確認:
# cat /sys/class/graphics/fb0/modes
適当な解像度に変更、例:
# echo "D:1920x1080p-60" > /sys/class/graphics/fb0/mode

==== 起動時に自動的に解像度を設定 ====

{{ic|uEnv.txt}} のカーネルパラメータを編集して {{ic|script.bin}} に必要なパラメータを記述する必要があります。{{ic|script.bin}} はバイナリファイルのため、Sunix をツールを使ってバイナリファイルを {{ic|script.fex}} テキストファイルに変換して、変更を加えてから、{{ic|script.bin}} に再変換してください ([http://linux-sunxi.org/Fex_Guide#disp_init_configuration Sunxi fex ガイド], [http://linux-sunxi.org/Kernel_arguments Sunix カーネル引数], [http://forum.lemaker.org/viewthread.php?action=printable&tid=1881 スレッド] を参照):

$ cd $HOME
$ mkdir $HOME/boot
$ sudo mount /dev/mmcblk0p1 $HOME/boot
$ cp $HOME/boot/script.bin $HOME/script.bin
$ pacman -S sunxi-tools
$ bin2fex $HOME/script.bin $HOME/script.fex
作成された {{ic|script.fex}} を好きなエディタで編集します。{{ic|[disp_init]}} セクションを探して以下のパラメータを変更・追加してください:
screen0_output_mode = 10
fb0_framebuffer_num = 3
fb0_scaler_mode_enable = 0
sunxi_fb_mem_reserve = 32
変更を保存したら、{{ic|fex2bin}} を実行してから、{{ic|script.bin}} をバックアップして置き換えます:
$ $HOME/sunxi-tools/fex2bin $HOME/script.fex $HOME/script.bin
$ sudo cp $HOME/boot/script.bin $HOME/boot/script.bin.backup
$ sudo cp $HOME/script.bin $HOME/boot/script.bin
バックアップの作成後、root 権限で {{ic|$HOME/boot/uEnv.txt}} の {{ic|disp.screen0.output_mode}} を変更できます:
disp.screen0.output_mode=10:1920x1080p60
ブートパーティションをアンマウントして再起動したら、1080p/60Hz になっているはずです。

==== アイドル状態でディスプレイがオフになった後にオンにならなくなる ====
一定時間アイドル状態が続いてディスプレイがオフになった後、オンに戻らなくなる問題が発生する場合、[[DPMS]] を無効化することができます。その後、以下の X11 引数をディスプレイマネージャの適当な設定に追加してください:

-s 0 -dpms

例えば、[[SLiM]] を使っている場合、{{ic|/etc/slim.conf}} を編集します:
xserver_arguments -nolisten tcp vt07 -s 0 -dpms

デバイスを再起動したときなど、何らかの理由でディスプレイがオフから変えられなくなったとき、一時的に解像度を変更することでオンにすることができます:
# echo "D:1280x720p-60" > /sys/class/graphics/fb0/mode
# echo "D:1920x1080p-60" > /sys/class/graphics/fb0/mode

== ベンチマーク ==
実際に接続されているハードウェア (例: HDD) によって、ベンチマークの値は変わってきますが、Banana Pi のパフォーマンスを知るのにある程度は役に立つでしょう。
=== SATA HDD ===
2つの異なる外部 HDD (3.5インチ、外部電源) を SATA-L と eSATA-I ケーブルで Banana Pi に接続しています。読み書き速度は [[Core Utilities#dd|dd]] のものです (3回実行した平均):
{| style="text-align: center;" class="wikitable"
!
!HDD 1 (2 TB)
!HDD 2 (4 TB)
|-
!読み取り速度
|81.8 MB/s
|115.5 MB/s
|-
!書き込み速度
|37.6 MB/s
|39.4 MB/s
|}

=== ネットワーク ===
Allwinner A20 SoC に制限があるため、BPi はギガビットイーサネット NIC の理論値の帯域幅を完全に使うことはできません。それでも BPi は約 510 MBits/s を出すことができます。

ベンチマークは {{ic|iperf}} を使って実行しました (3回実行した平均値)。クライアントの BPi とサーバーはギガビットイーサネットによってギガビット対応のスイッチに接続しています。

== 参照 ==
* [http://wiki.lemaker.org/FAQ Manufacturers FAQ]

環境変数

2017-11-07T12:54:28Z

Ootaharuki99: GNOME Wayland で環境変数を設定する方法を追記しました。

[[Category:システム管理]]
[[de:Umgebungsvariablen]]
[[en:Environment variables]]
[[ru:Environment variables]]
[[zh-hans:Environment variables]]
{{Related articles start}}
{{Related|デフォルトアプリケーション}}
{{Related|Xdg-open}}
{{Related articles end}}
環境変数とは1つ、または複数のアプリケーションによって使用されるデータを含んだ名前付きオブジェクトです。簡単に言えば、名前と値がある変数です。環境変数の値は例えば、実行可能ファイルのファイルシステムにおける場所や使用するデフォルトのエディタ、システムロケールの設定などになります。Linux に慣れてないユーザーは、環境変数で設定をするのは御しがたいと考えがちですが、複数のアプリケーションと Linux のプロセスの設定を共有するシンプルな方法として環境変数が存在しています。

== ユーティリティ ==
{{Pkg|coreutils}} パッケージには ''printenv'' と ''env'' というプログラムが入っています。現在設定されている環境変数とその値を表示するには:

$ printenv

{{Note|環境変数の中にはユーザー個別のものも存在します。''printenv'' の出力を非特権ユーザーと ''root'' で比較してみてください。}}

{{ic|env}} ユーティリティを使うことで環境変数を変更してコマンドを実行することができます。以下の例では環境変数 {{ic|EDITOR}} を {{ic|vim}} に設定して ''xterm'' を起動します。以下のコマンドを実行してもグローバルな環境変数 {{ic|EDITOR}} に影響は与えません。

$ env EDITOR=vim xterm

[[Bash]] に組み込まれている ''set'' はシェルのオプションの値を変更したり、位置のパラメータを設定したり、シェル変数の名前や値を表示することができます。詳しくは、''set'' のドキュメントを見て下さい: [http://www.gnu.org/software/bash/manual/bash.html#The-Set-Builtin]。

特定のプロセスで使われている環境変数を確認したい場合は、{{ic|/proc/${PID}/environ}} を見て下さい。このファイルには特殊な {{ic|\x0}} 文字が含まれています。次の関数を使うことでファイルを解析できます。

# envof() { sed 's/\x0/\n/g' /proc/${1}/environ; }
# envof 1
TERM=linux

== 変数の定義 ==

=== グローバル ===

大半の Linux ディストリビューションは、あなたに {{ic|/etc/profile}} 等のファイルに環境変数の追加・変更を行うよう指示します。環境変数を維持管理し、それらを含む膨大な数のファイルに気を配る必要があります。原則的にあらゆるシェルスクリプトは環境変数の定義に使われる可能性がありますが、以下のような UNIX の慣例に従い特定のファイルでのみ行われるべきものです。

次のファイルがグローバルな環境変数の定義に使われるべきです: {{ic|/etc/profile}}、{{ic|/etc/bash.bashrc}}、および {{ic|/etc/environment}}。ファイルにはそれぞれ制限があるため、注意深く目的にあったものを選ぶべきです。

*{{ic|/etc/profile}} はログインシェル''のみ''において変数を初期化します。ただし、スクリプトを実行したり、全ての [[wikipedia:ja:Bourne Shell|Bourne shell]] 互換シェルで使うことができます。
*{{ic|/etc/bash.bashrc}} はインタラクティブシェル''のみ''において変数を初期化します。スクリプトも実行しますが (名前から分かる通り) Bash でしか使えません。
*{{ic|/etc/environment}} は PAM-env モジュールによって使われ、ログインシェルであるかそうでないか、インタラクティブシェルであるかそうでないか、また、Bash であるかそうでないかは関係ありません。そのためスクリプトやグロブ展開を使うことは不可能です。このファイルに記述できるのは {{ic|1=''variable=value''}} のペアだけです。

以下の例では、特定のユーザーで {{ic|~/bin}} ディレクトリを {{ic|PATH}} に追加しています。適当な環境変数設定ファイル ({{ic|/etc/profile}} あるいは {{ic|/etc/bash.bashrc}}) に記述することで使うことができます:

{{bc|<nowiki>
# If user ID is greater than or equal to 1000 & if ~/bin exists and is a directory & if ~/bin is not already in your $PATH
# then export ~/bin to your $PATH.
if [[ $UID -ge 1000 && -d $HOME/bin && -z $(echo $PATH | grep -o $HOME/bin) ]]
then
export PATH=$HOME/bin:${PATH}
fi
</nowiki>}}

=== ユーザーごと ===

{{Note|dbus デーモンや systemd のユーザーインスタンスは {{ic|.bashrc}} などで設定された環境変数を継承しません。そのため、D-Bus によって Nautilus などのアプリケーションが起動した場合、デフォルトで設定された環境変数を使いません。[[Systemd/ユーザー#環境変数]]を参照してください。}}

環境変数をグローバルに定義したくないという時もあるでしょう。例えば、{{ic|PATH}} に {{ic|/home/my_user/bin}} を追加したいが、システム上の他のユーザーには同じ {{ic|PATH}} を使って欲しくないという場合が考えられます。様々なファイルを使うことでローカルに環境変数を定義することができます:

# シェルの設定ファイル、例えば [[Bash#設定ファイル]] や [[Zsh#設定ファイル]]。
# {{ic|~/.profile}} は多数のシェルによってフォールバックとして使われます。[[wikipedia:Unix_shell#Configuration_files_for_shells]] を参照。
# {{ic|~/.pam_environment}} は {{ic|/etc/environment}} のユーザー個別の設定で、PAM-env モジュールによって使われます。詳しくは {{ic|pam_env(8)}} や {{ic|pam_env.conf(5)}} を参照。

ローカルで {{ic|PATH}} にディレクトリを追加したい場合、以下のように {{ic|~/.bash_profile}} に記述します:

export PATH="${PATH}:/home/my_user/bin"

変数をアップデートするために、再ログインするかファイルを ''source'' してください: {{ic|$ source ~/.bash_profile}}。

==== グラフィカルアプリケーション ====

GUI アプリケーションの環境変数を設定したいときは、[[xinitrc]] ([[ディスプレイマネージャ]]を使う場合 [[xprofile]]) に変数を記述することができます。例:

{{hc|1=~/.xinitrc|2=
export PATH="${PATH}:~/scripts"
export GUIVAR=value}}

GNOME Wayland は [[xprofile]] を読み込みません。GDM を使う場合、代わりにフォルダ {{ic|~/.local/share/gdm/env.d/}} (ユーザーのみ) または {{ic|/usr/share/gdm/env.d/}} (全てのユーザー) の中に置いた任意のファイルに変数を記述することができます。例:

{{hc|1=~/.local/share/gdm/env.d/envs|2=
PATH="${PATH}:~/scripts"
GUIVAR=value}}

=== セッションごと ===

時としてもっと限られた定義が必要になる場面もあります。絶対パスを入力せずに指定したディレクトリから一時的に実行ファイルを起動したい場合や、アプリケーションを実行するために短時間だけ {{ic|~/.bash_profile}} を編集しなくてはならない場合などです。

その場合、''export'' コマンドを使うことで、現在のセッションのみで {{ic|PATH}} 変数を定義することができます。ログアウトするまでは、{{ic|PATH}} 変数は一時的な設定が使われます。{{ic|PATH}} に特定のディレクトリを追加するには、次を実行:

$ export PATH="${PATH}:/home/my_user/tmp/usr/bin"

== サンプル ==
以下のセクションでは Linux システムで一般的に使われている環境変数を並べており、それぞれの値について説明しています。

*{{ic|DE}} は使用しているデスクトップ環境 (''D''esktop ''E''nvironment) を示します。[[xdg-open]] はこの環境変数を使ってデスクトップ環境に含まれているユーザーフレンドリーなファイルオープナアプリケーションを選択します。この機能を使うにはインストールする必要があるパッケージが存在します。[[GNOME]] の場合、{{AUR|libgnome}} が必要です。[[Xfce]] の場合、{{pkg|exo}} が必要です。使用される {{ic|DE}} 変数の値: {{ic|gnome}}, {{ic|kde}}, {{ic|xfce}}, {{ic|lxde}}, {{ic|mate}}。

:{{ic|DE}} 環境変数はウィンドウマネージャを起動する前にエクスポートする必要があります。例:

{{hc|~/.xinitrc|2=
export DE="xfce"
exec openbox
}}

:上記の設定をすると、Xfce の中で実行されていると認識され ''xdg-open'' がユーザーフレンドリーな ''exo-open'' を使うようになります。設定したいときは ''exo-preferred-applications'' を使って下さい。

*{{ic|DESKTOP_SESSION}} は {{ic|DE}} と似ていますが、[[LXDE]] デスクトップ環境で使われています: {{ic|DESKTOP_SESSION}} が {{ic|LXDE}} に設定されている場合、''xdg-open'' は ''pcmanfm'' のファイル関連付けを使います。

*{{ic|PATH}} はコロンで区切られたディレクトリのリストで、システムが実行ファイルを探す対象となります。通常のコマンド (例: ''pacman'', ''systemctl'' など) をシェルに打ち込むと、このリストにあるディレクトリから同じ名前の実行ファイルが探され、そして実行されます。{{ic|PATH}} に含まれないディレクトリ下のものを実行するには、実行ファイルへの絶対パスが必要です: {{ic|/opt/adobe-air-sdk/bin/adl}}。

{{Note|ユーザーが悪意のあるプログラムを実行してしまう可能性があるため、セキュリティ上の理由から {{ic|PATH}} に現在のワーキングディレクトリ {{ic|.}} を含めないことを推奨します。}}

*{{ic|HOME}} は現在のユーザーのホームディレクトリが入ります。この変数は、アプリケーションが現在のユーザーに関連した設定ファイル等を見つけるために使われます。

*{{ic|PWD}} にはワーキングディレクトリのパスが入ります。

*{{ic|OLDPWD}} には前のワーキングディレクトリのパスが入ります。つまり最後に ''cd'' を実行する前の {{ic|PWD}} です。

*{{ic|SHELL}} には実行中の、インタラクティブシェルの名前が入ります。例: {{ic|bash}}。

*{{ic|TERM}} には実行中のターミナルの名前が入ります。例: {{ic|xterm}}。

*{{ic|PAGER}} にはテキストファイルを閲覧するために使われるコマンドが入ります。例: {{ic|/bin/less}}。

*{{ic|EDITOR}} にはテキストファイルを編集するために使われる軽量なエディタのコマンドが入ります。例: {{ic|/usr/bin/nano}}。例えば、以下のようにすることで [[Xorg|X]] 環境下では ''gedit''、そうでなければ ''nano'' を使用するようにできます:

export EDITOR="$(if <nowiki>[[</nowiki> -n $DISPLAY <nowiki>]]</nowiki>; then echo 'gedit'; else echo 'nano'; fi)"

*{{ic|VISUAL}} にはメールの編集など、作業量が多いことをするのに使う、フル機能のエディタを実行するコマンドを指定します (例: {{ic|vi}}, [[vim]], [[emacs]] など)。

*{{ic|MAIL}} には受信したメールの保存場所が入ります。一般的な設定は {{ic|/var/spool/mail/$LOGNAME}} です。

*{{ic|BROWSER}} にはウェブブラウザのパスを指定します。インタラクティブシェルの設定ファイルで以下のように設定することで、[[Xorg|X]] など、グラフィカル環境が存在するかどうかで動的にウェブブラウザを変更することが可能です:

if <nowiki>[</nowiki> -n "$DISPLAY" <nowiki>]</nowiki>; then
export BROWSER=firefox
else
export BROWSER=links
fi

*{{ic|ftp_proxy}} と {{ic|http_proxy}} にはそれぞれ FTP と HTTP プロキシサーバーを記述します:
ftp_proxy="<nowiki>ftp://192.168.0.1:21</nowiki>"
http_proxy="<nowiki>http://192.168.0.1:80</nowiki>"

*{{ic|MANPATH}} には ''man'' が man ページを探すときに使うコロン区切りのディレクトリのリストが入ります。

{{Note|{{ic|/etc/profile}} に "Man is much better than us at figuring this out" (man は我々よりずっと上手くこれを解決する) と書いてあるとおり、一般的にこの変数はデフォルトのままにしておくべきです: {{ic|/usr/share/man:/usr/local/share/man}}。}}

*{{ic|INFODIR}} には ''info'' コマンドが info ページを探す際に使うコロン区切りのディレクトリのリストが入ります。例: {{ic|/usr/share/info:/usr/local/share/info}}。

*{{ic|TZ}} はユーザー別にシステムと違うタイムゾーンを指定するために使うことができます。{{ic|/usr/share/zoneinfo/}} に記載されているタイムゾーンを参考にしてください。例: {{ic|1=TZ="/usr/share/zoneinfo/Pacific/Fiji"}}。

=== pam_env を使う ===

{{ic|/etc/environment}} や {{ic|~/.pam_environment}} には癖があり、man ページ ({{ic|pam_env(8)}} や {{ic|pam_env.conf(5)}}) には明白な記述がありません。例:

{{hc|1=~/.pam_environment|2=
LANG DEFAULT=en_US.UTF-8
LC_ALL DEFAULT=${LANG}

XDG_CONFIG_HOME DEFAULT=@{HOME}/.config
#XDG_CONFIG_HOME=@{HOME}/.config # is **not** valid see below
XDG_DATA_HOME DEFAULT=@{HOME}/.local/share

# you can even use recently defined variables
RCRC DEFAULT=${XDG_CONFIG_HOME}/rcrc
BROWSER=firefox
#BROWSER DEFAULT=firefox # same as above
EDITOR=vim}}

{{ic|~/.pam_environment}} では2つの方法で環境変数を設定できます:

VARIABLE=VALUE

または:

VARIABLE [DEFAULT=[value]] [OVERRIDE=[value]]

前者では {{ic| ${VARIABLES} }} が使えませんが、後者では使えます。{{ic| @{HOME} }} は {{ic|/etc/passwd}} の定義を拡張する特殊な変数です ({{ic| @{SHELL} }} も同じ)。{{ic|VARIABLE}} を定義したら、{{ic| ${VARIABLE} }} で使うことができます。前に定義した変数を呼び出すときは中括弧とドル記号が必須なので注意してください ({{ic| ${} }})。

{{Note|上記のファイルは {{ic| ~/.{,bash_,z}profile }} や {{ic| ~/.zshenv }} よりも前に読み込まれます。}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Handbook:X86/Working/EnvVar/ja Gentoo Linux ドキュメント]

Pm-utils

2017-05-01T11:09:34Z

Ootaharuki99: 英語版でアーカイブが検討されてる旨が表示されているためその部分を追記。また、パッケージ関連のリンク・記述を修正・削除。

{{DISPLAYTITLE:pm-utils}}
[[Category:電源管理]]
[[en:Pm-utils]]
[[it:Pm-utils]]
[[ru:Pm-utils]]
[[zh-hans:Pm-utils]]
{{Related articles start}}
{{Related|Uswsusp}}
{{Related|TuxOnIce}}
{{Related articles end}}
{{Archive|公式サポートがなくなりました; systemdのサスペンド機能に取って代わられます|Talk:Pm-utils#Deletion Proposal}}
{{Warning|1=Pm-utils でハイバネートをして systemd をアップデートするとファイルが破壊されるという報告が存在します: https://bbs.archlinux.org/viewtopic.php?pid=1423442 。}}
'''pm-utils''' はサスペンドと電源状態を設定するフレームワークです。{{ic|powersave}} などのスクリプトなどを置き換えるために作られました。

pm-utils はカーネルのサスペンドと復帰を様々なハックで包み込むシェルスクリプトのコレクションです。サスペンドに対応していないドライバーやサブシステムによるバグを回避するためにハックが必要になります。カスタムフックをディレクトリに配置することで簡単に拡張することができ、システムの管理者がフックを作成するだけでなく、パッケージによってフックがインストールされることもあります。システムのサスペンドや電源状態の変化に特別注意する必要があるパッケージにフックが含まれています。

あまり知られていない機能として [[Laptop Mode Tools]] による切り替えを模倣します。

[[CPU 周波数スケーリング|cpupower]] パッケージと組み合わせて使うことで、ノートパソコン (デスクトップ) のユーザーは完全な電源管理スイートとして利用できます。

== インストール ==

[[公式リポジトリ]]の {{AUR|pm-utils}} パッケージを[[pacman|インストール]]してください。

{{Note|
* 復帰時にビデオに問題が発生する場合は、[[公式リポジトリ]]から {{Pkg|vbetool}} もインストールする必要があります。
* 初めてインストールするときは、{{Pkg|acpi}} がインストールされていることを確認してください。
}}

root で {{ic|pm-suspend}}, {{ic|pm-suspend-hybrid}}, {{ic|pm-hibernate}} を実行すると手動でサスペンドが行われます。サスペンドスクリプトは {{ic|/var/log/pm-suspend.log}} にログを書き出します。

=== 別のサスペンドバックエンドをインストール (任意) ===

Arch Linux のパッケージでは次のバックエンドに対応するようになっています: {{ic|kernel}}, {{ic|tuxonice}}, {{ic|uswsusp}}。

サスペンドバックエンドは {{ic|/etc/pm/config.d}} の {{ic|SLEEP_MODULE}} 設定変数で指定することができ、デフォルトでは {{ic|kernel}} バックエンドが使われます。別のサスペンドバックエンドを使うには、それぞれ必要なパッケージをインストールしてください。どちらも [[Arch User Repository]] からインストールできます:
* uswsusp - {{AUR|uswsusp-git}}
* tuxonice - {{AUR|linux-ice}} / [[linux-pf]]

さらに、{{AUR|pm-utils}} には独自のビデオ互換データベースが付属しており、{{ic|/usr/lib/pm-utils/video-quirks/}} にインストールされます。

== 基本設定 ==

=== スタンバイ/RAM にサスペンド ===

理想的な状態は、root で {{ic|pm-suspend}} を実行することでメモリへのサスペンドが開始され、全ての動作状態が RAM に保存されて、消費電力を抑えるために RAM 以外の部品は全部シャットダウンされることです。また、電源ボタンを押すことでこの状態から復帰できなければなりません。

{{Note|ネットワークドライバーは SUSPENDED_MODULES に必ず記述することを推奨します。ほとんどのワイヤレスドライバーはスタンバイ後に問題を起こすことが知られています。Intel の iwlwifi, Atheros の ath5k, Realtek の r8* ドライバーなどが復帰後に問題を起こすという報告がフォーラムにあります。iwlwifi は復帰後にリロードしないと接続速度が 1Mbps まで落ちます。}}

場合によっては、{{ic|pm-suspend}} を実行するとフリーズするなどの問題が発生することがあります。特定のモジュールが正しく動作しないのが原因です。問題を発生させるモジュールがわかっている場合、{{ic|/etc/pm/config.d/modules}} の {{ic|SUSPEND_MODULES}} に以下のようにモジュールを追加します:
SUSPEND_MODULES="uhci_hd button ehci_hd iwlwifi"
設定に追加されたモジュールはサスペンドが行われる前にアンロードされ、復帰後にリロードされます。

ノートパソコンのフタを閉じた時などの電源イベントによって自動的に {{ic|pm-suspend}} を実行するように設定したい場合は、[[Acpid]] を参照してください。

=== ハイバネーション (suspend2disk) ===

[[サスペンドとハイバネート#ハイバネーション]]の指示に従ってハイバネーションを設定してください。

もしくは、{{ic|kernel}} バックエンドを使わない場合、[[Uswsusp#設定]] や [[TuxOnIce#ブートローダーの設定]] を見て下さい。

=== 通常ユーザーでサスペンド/ハイバネート ===

root パスワードを入力することなくサスペンドする方法は3つあります: [[Udev]] を使用する方法、UPower を使用する方法、[[sudo|visudo]] でユーザーに適当な権限を与える方法です。

==== ユーザーに権限を与える方法 ====

{{AUR|pm-utils}} スクリプトは root で実行する必要があるため、sudo を使うことで root パスワードを入力しないで通常ユーザーでスクリプトを使えるようにすることができます。そうするには、root で {{ic|visudo}} を使って {{ic|/etc/sudoers}} ファイルを編集してください。詳しくは、[[sudo]] を参照。

以下の行を追加してください。{{ic|''username''}} はあなたのユーザー名に置き換えて、保存してから {{ic|visudo}} を終了します:
''username'' ALL = NOPASSWD: /usr/sbin/pm-hibernate
''username'' ALL = NOPASSWD: /usr/sbin/pm-suspend

もしくは、グループを使うこともできます。以下の行を使って下さい。{{ic|''group''}} は置き換えて下さい:
%''group'' ALL = NOPASSWD: /usr/sbin/pm-hibernate
%''group'' ALL = NOPASSWD: /usr/sbin/pm-suspend

{{Note|These must come after any user privilege specifications, e.g., {{ic|1=username ALL=(ALL) ALL}}, or they will not work.}}

上記の設定によって、パスワードを入力しなくても以下のコマンドを実行することでスクリプトが実行できます:
$ sudo pm-hibernate

もしくは:

$ sudo pm-suspend

また、ユーザーを {{ic|power}} [[グループ]]に追加して、アプレットなどを使用してサスペンドできるようにします。グループに追加していないと、[[GNOME]] のシャットダウンアプレットなどでサスペンドしようとしたときに、耳障りなビープ音が三回鳴って画面がロックされます。ユーザーをグループに追加するには:
# gpasswd -a ''username'' power

これで[[デスクトップ環境]]の電源管理ツールを使って、ノートパソコンのフタが閉じられたとき、あるいはバッテリーの残量が少なくなったときに、自動的にサスペンドやハイバネートをすることができるようになります。

=== 省電力機能 ===

pm-utils ではシステムが AC アダプタに接続しているかどうかに合わせてコマンドを実行することができます。スクリプトを {{ic|/etc/pm/power.d/}} フォルダの中に作成してください。スクリプトの例は [http://crunchbanglinux.org/forums/post/110148/#p110148 crunchbang フォーラム] に存在します。AC 状態の変化を検出するには upower を動作させる必要があるので注意してください (詳しくは [https://bbs.archlinux.org/viewtopic.php?id=132125] を参照)。

==== AC 状態にあわせて明るさを変化させる ====

以下は AC 状態にあわせて輝度を変化させる例です。以下の内容で {{ic|/etc/pm/power.d/00-brightness}} というファイルを作成して、あなたのシステムに合わせて、輝度設定のパスとファイルに書き出す値を変更してください。

{{bc|
#!/bin/bash

case $1 in
true)
echo "Enable screen power saving"
echo 5 > /sys/class/backlight/acpi_video0/device/backlight/acpi_video0/brightness
;;
false)
echo "Disable screen power saving"
echo 14 > /sys/class/backlight/acpi_video0/device/backlight/acpi_video0/brightness
;;
esac
}}

=== アイドル状態でサスペンド ===

xautolock プログラムを使う方法があります。{{ic|xautolock -time 30 -locker "sudo pm-suspend" -detectsleep &}} を {{ic|~/.xinitrc}} に追加してください。30分間、何も動作がない場合に {{ic|pm-suspend}} を呼び出します。

=== 通常のスワップパーティションの代わりにスワップファイルを使う ===

通常のスワップパーティションの代わりにスワップファイルを使いたい場合、[[スワップ#スワップファイル|スワップファイル]]を見て下さい。

== 高度な設定 ==

メインの設定ファイルは {{ic|/usr/lib/pm-utils/defaults}} です。このファイルを編集してはいけません。パッケージのアップデートによって、デフォルト設定に書き換えられてしまう可能性があります。設定ファイルは {{ic|/etc/pm/config.d/}} に置くようにしてください。{{ic|/etc/pm/config.d}} に {{ic|modules}} や {{ic|config}} という名前で、以下の内容のシンプルなテキストファイルを作成することで、システム全体の設定ファイルの設定を上書きできます:
SUSPEND_MODULES="button uhci_hcd"

=== 設定ファイルで利用できる変数 ===

; SUSPEND_MODULES="button": サスペンドする前にアンロードするモジュールのリスト
; SLEEP_MODULE="tuxonice uswsusp kernel": 試行するデフォルトのスリープ/復帰システム
; HIBERNATE_MODE="shutdown": 再起動ではなく強制的にシャットダウンさせる

=== フックの無効化 ===

不必要な、あるいは害を及ぼすフックが動作してしまう場合、それについてバグレポートを送って頂けると幸いです。{{ic|/etc/pm/sleep.d/}} にフックと呼応する空のファイルを作成することで簡単にフックを無効化できます。例えば {{ic|/usr/lib/pm-utils/sleep.d/45pcmcia}} フックを無効化したいときは、次を実行することで無効化できます:
# touch /etc/pm/sleep.d/45pcmcia
ダミーのフックには実行可能権限は付与しないでください。

{{Note|適当なディレクトリにダミーファイルを作成してください。例えば {{ic|/usr/lib/pm-utils/power.d}} のフックを無効化する場合、{{ic|/etc/pm/power.d}} にダミーファイルを作成する必要があります。}}

==== 別の方法 ====

ブラックリストにしたいモジュールを {{ic|HOOK_BLACKLIST}} 変数に定義したファイルを {{ic|/etc/pm/config.d}} に作成してください。例えば、省電力機能を自分で管理したい場合、以下を使います:
HOOK_BLACKLIST="hal-cd-polling intel-audio-powersave journal-commit laptop-mode pcie_aspm readahead sata_alpm sched-powersave xfs_buffer wireless"

=== フックの作成 ===

{{Note|systemd を使っている場合、sleep.d のフックはおそらく動作しません。そのようなときは systemd の[[電源管理#スリープフック|スリープフック]]を使って下さい。}}
サスペンドやハイバネートのときに何か特別なことをしたい場合、簡単にフックを自分で作成して {{ic|/etc/pm/sleep.d}} に配置することができます。このディレクトリに含まれているフックはサスペンド時にアルファベット順で実行されます (そのため名前の先頭には2桁の数字を付けて、順番が明確になるようにしています)。復帰時は逆の順番で実行されます。数字については以下のように決められています:
;00 - 49: ユーザーやパッケージが作成したフック。通常のサービスやユーザー空間のインフラストラクチャが動作しているときに実行するべきフック。
;50 - 74: サービスを管理するフック。この範囲のフックはサービスを起動したり停止します。50 以下のフックはサービスが有効になっている状態に実行されると考えてかまいません。
;75 - 89: コア以外のハードウェアあるいはモジュールを管理するフック。モジュールをロード・アンロードしたり、安全な状態にサスペンドしたりハイバネートするのを破壊するようなビデオ以外のハードウェアを扱うフックはこの範囲に収まります。75 以下では、全てのモジュールがロードされることになります。
;90 - 99: 重要なサスペンドのフック用に予約されています。

ログファイルに情報を流すだけの、無用のフックを作ると以下のようになります:

#!/bin/bash
case $1 in
hibernate)
echo "Hey guy, we are going to suspend to disk!"
;;
suspend)
echo "Oh, this time we are doing a suspend to RAM. Cool!"
;;
thaw)
echo "Oh, suspend to disk is over, we are resuming..."
;;
resume)
echo "Hey, the suspend to RAM seems to be over..."
;;
*) echo "Somebody is calling me totally wrong."
;;
esac

上記のファイルを {{ic|/etc/pm/sleep.d/66dummy}} として保存して {{ic|chmod +x /etc/pm/sleep.d/66dummy}} を実行してください。サスペンドや復帰時にメッセージが出力されます。

{{Warning|全てのフックは root で実行されます。したがって、一時ファイルを作成する場合は注意してください。セキュリティに問題が起きないように {{ic|PATH}} 環境変数が正しく設定されていることなどを確認します。}}

== 仕組み ==

仕組みはとても簡単です: メインスクリプト ({{ic|pm-suspend}}, {{ic|pm-hibernate}}, {{ic|pm-suspend-hybrid}} などのシンボリックリンクで {{ic|pm-action}} が呼びされます) はアルファベット順で実行可能スクリプトである"フック"を実行し、その際 {{ic|suspend}} (suspend to RAM) あるいは {{ic|hibernate}} (suspend to disk) のパラメータが使われます。全てのフックが実行されると、マシンはスリープ状態になります。マシンが再度起こされると、全てのフックは逆順に実行され {{ic|resume}} (resume from RAM) あるいは {{ic|thaw}} (resume from disk) のパラメータが使われます。フックは様々なことを行います。ブートローダーの準備や Bluetooth サブシステムの停止、重要なモジュールのアンロードなどです。

{{ic|pm-suspend}} と {{ic|pm-hibernate}} はどちらも大抵は [[Udev]] から呼び出され、Udev 自体は {{Pkg|gnome-power-manager}} や {{ic|kpowersave}} などのデスクトップアプレットから実行されます。

{{Note|{{ic|suspend-hybrid}} is a placeholder right now -- it is not completely implemented.}}

マシンを高出力モードあるいは低出力モードに設定することもできます。{{ic|true}} や {{ic|false}} のパラメータを追加して {{ic|pm-powersave}} コマンドを使います。基本的なところはサスペンドフレームワークと同じです。

サスペンドするときのフックは以下のディレクトリに配置されています:
;{{ic|/usr/lib/pm-utils/sleep.d}}: ディストリビューションやパッケージによって配置されたフック
;{{ic|/etc/pm/sleep.d}}: システム管理者によって追加されたフック

電源状態を変更するときのフックは以下のディレクトリに配置されています:
;{{ic|/usr/lib/pm-utils/power.d}}: ディストリビューションやパッケージによって配置されたフック
;{{ic|/etc/pm/power.d}}: システム管理者によって追加されたフック

{{ic|/etc/pm/}} のフックは {{ic|/usr/lib/pm-utils/}} のフックよりも優先されるため、システム管理者はディストリビューションによって決められたデフォルト設定を上書きすることができます。

=== Pm-suspend の内部 ===

This outlines the internal actions when {{ic|pm-suspend}} is run, describing how {{ic|pm-utils}} gracefully falls back onto the kernel method if the requirements of other methods are not met.

$ pm-suspend

The first step is set-up preliminary variables and source parent scripts:
export STASHNAME=pm-suspend
export METHOD="$(echo ${0##*pm-} |tr - _)"
. "/usr/lib/pm-utils/pm-functions"

The variable {{Ic|METHOD}} is extracted from the executable name, ''suspend'' from {{ic|pm-suspend}} and ''hibernate'' from {{ic|pm-hibernate}}.

The location of runtime configuration parameters is defined in {{ic|/usr/lib/pm-utils/pm-functions}} as ''PM_UTILS_RUNDIR="/var/run/pm-utils"'' and ''STORAGEDIR="${PM_UTILS_RUNDIR}/${STASHNAME}/storage"''. Therefore ''STORAGEDIR="/var/run/pm-utils/pm-suspend/storage"''; this is where {{ic|pm-suspend}} will cache its configuration. Disabled hooks are stored as plain text files with the hook name prefixed by "''disable_hook:''". Configuration parameters are appended to the ''parameters'' file:
{{hc|$ ls -lah /var/run/pm-utils/pm-suspend/storage/|
-rw-r--r-- 1 root root 20 May 19 09:57 disable_hook:99video
-rw-r--r-- 1 root root 0 May 19 02:59 parameters
-rw-r--r-- 1 root root 247 May 19 02:59 parameters.rm
-rw-r--r-- 1 root root 9 May 19 02:59 state:cpu0_governor
-rw-r--r-- 1 root root 9 May 19 02:59 state:cpu1_governor
}}

Then {{Ic|pm-functions}} will source the files located in {{Ic|/etc/pm/config.d/}} in addition to {{ic|/usr/lib/pm-utils/defaults}}. Upon returning, {{Ic|pm-functions}} will proceed to source the files specified by '''$SLEEP_METHOD''' as {{Ic|/usr/lib/pm-utils/module.d/$SLEEP_METHOD[...]}} if they exist:
for mod in $SLEEP_MODULE; do
mod="${PM_UTILS_LIBDIR}/module.d/${mod}"
[ -f "$mod" ] || continue
. "$mod"
done

Otherwise, if '''$SLEEP_MODULE''' is empty, {{ic|do_suspend()}} will be set to the kernel backend as described above:
if [ -z "$SUSPEND_MODULE" ]; then
if grep -q mem /sys/power/state; then
SUSPEND_MODULE="kernel"
do_suspend() { echo -n "mem" >/sys/power/state; }
elif [ -c /dev/pmu ] && pm-pmu --check; then
SUSPEND_MODULE="kernel"
do_suspend() { pm-pmu --suspend; }
elif grep -q standby /sys/power/state; then
SUSPEND_MODULE="kernel"
do_suspend() { echo -n "standby" >/sys/power/state; }
fi
fi

Assuming '''$SLEEP_MODULE''' is not empty and {{Ic|uswsusp}} is specified, {{Ic|/usr/lib/pm-utils/module.d/uswsusp}} is executed. This script checks several requirements (these are the requirements for being able to use uswsusp):
* [ -z $SUSPEND_MODULE ]
* command_exists s2ram
* grep -q mem /sys/power/state || ( [ -c /dev/pmu ] && pm-pmu --check; );
If these requirements are met, do_suspend() is defined as:
do_suspend()
{
uswsusp_get_quirks
s2ram --force $OPTS
}
Most importantly, the {{Ic|uswsusp}} module runs:
add_before_hooks uswsusp_hooks
add_module_help uswsusp_help
The first function, ''add_before_hook'' disables the '''pm-utils''' hooks '''99video''' since this functionality is subsumed by '''s2ram'''.
The second function, ''add_module_help'', adds uswsusp-module-specific help, which in essence replaces the help function provided by '''99video'''.

Back to {{Ic|pm-suspend}}:
command_exists "check_$METHOD" && command_exists "do_$METHOD"
"check_$METHOD"
This verifies that the ''check_suspend'' and ''do_suspend'' methods have been defined. The ''check_suspend'' method simply verifies that $SUSPEND_MODULE is not empty:

check_suspend() { [ -n "$SUSPEND_MODULE" ]; }

Lastly, {{Ic|pm-suspend}} must run all hooks that have not been disabled, sync file-system buffers, and run ''do_suspend'':
if run_hooks sleep "$ACTION $METHOD"; then
# Sleep only if we know how and if a hook did not inhibit us.
log "$(date): performing $METHOD"
sync
"do_$METHOD" || r=128
log "$(date): Awake."

The method ''run_hooks'' is a wrapper for ''_run_hooks'', which the case of {{ic|pm-suspend}} is called as ''run_hooks sleep "suspend suspend"''. Given that:
PARAMETERS="${STORAGEDIR}/parameters"
PM_UTILS_LIBDIR="/usr/lib/pm-utils"
PM_UTILS_ETCDIR="/etc/pm"

The method ''_run_hooks'', will for each hook in ''"${PM_UTILS_LIBDIR}/$1.d"'' and ''"${PM_UTILS_ETCDIR}/$1.d"'', check that sleep has not been inhibited and update the runtime parameters stored in ''$PARAMETERS'' before running each hook via ''run_hook $hook $2''. In the case of Suspend-to-RAM, all the hooks in ''{/usr/lib/pm-utils/sleep.d/,/etc/pm/sleep.d/}'' will be enumerated, and ''run_hook'' will be passed the parameters ''$hook'' and "''suspend suspend''". The method ''run_hook'' uses the ''hook_ok'' function to verify that the hook has not been disabled before executing the hook with the "''suspend suspend''" parameters.

== Tips and tricks ==

=== 復帰時にハードディスクの電源管理レベルを自動的に設定 ===

以下のようにフックを作成:
{{hc|/etc/pm/sleep.d/50-hdparm_pm|<nowiki>
#!/bin/dash

if [ -n "$1" ] && ([ "$1" = "resume" ] || [ "$1" = "thaw" ]); then
hdparm -B 254 /dev/sda > /dev/null
fi
</nowiki>}}

そして次を実行:
# chmod +x /etc/pm/sleep.d/50-hdparm_pm

上記の [[Bash]] スクリプトが動作しない場合、以下のスクリプトで動作する可能性があります:
{{hc|/etc/pm/sleep.d/50-hdparm_pm|<nowiki>
#!/bin/sh

. "${PM_FUNCTIONS}"
case "$1" in
thaw|resume)
sleep 6
hdparm -B 254 /dev/sda
;;
*)
;;
esac
exit $NA
</nowiki>}}

{{ic|-B}} スイッチの値を低くすると効果があるかもしれません。[[hdparm]] を見て下さい。

=== マウスの再起動 ===

ノートパソコンによっては、サスペンドがされた後にマウスが動かなくなることがあります。{{ic|/etc/pm/hooks}} にフックを作成して PS/2 ドライバー (例: {{ic|i8042}}) を強制的に再初期化することで解決します ([[#フックの作成|フックの作成]]を参照):

#!/bin/sh
echo -n "i8042" > /sys/bus/platform/drivers/i8042/unbind
echo -n "i8042" > /sys/bus/platform/drivers/i8042/bind

=== Openbox のメニューにスリープモードを追加 ===

Openbox を使っている場合、{{ic|~/.config/openbox/menu.xml}} のサブメニューにアイテムを追加することで、Openbox メニューにシャットダウンオプションとして新しいスクリプトを追加できます。例:
<menu id="64" label="Shutdown">
<item label="Lock"> <action name="Execute"> <execute>xscreensaver-command -lock</execute> </action> </item>
<item label="Logout"> <action name="Exit"/> </item>
<item label="Reboot"> <action name="Execute"> <execute>sudo shutdown -r now</execute> </action> </item>
<item label="Poweroff"> <action name="Execute"> <execute>sudo shutdown -h now </execute> </action> </item>
'''<item label="Hibernate"> <action name="Execute"> <execute>sudo pm-hibernate</execute> </action> </item>'''
'''<item label="Suspend"> <action name="Execute"> <execute>sudo pm-suspend</execute> </action> </item>'''
</menu>

=== "sleep" と "power" ボタンの処理 ===

"Sleep" と "power" ボタンは {{ic|acpid}} の {{ic|/etc/acpi/handler.sh}} で処理されます ("button/power" と "power/sleep" エントリを見て下さい)。{{ic|pm-suspend}} や {{ic|pm-hibernate}} を呼び出すようにデフォルトのアクションを置き換えることができます。

[[電源管理#ACPI イベント|systemd]] は独自に電源イベントを管理しており pm-utils や {{ic|/etc/pm/*}} のスクリプトは使わないので注意してください。

=== ハイバネートやサスペンド時にスクリーンセーバーをロック ===

You may wish to run a screen locking utility when the system suspends (so that a password is required after waking up). This can be done by adding a script to the {{ic|/etc/pm/sleep.d}} folder. Make sure the script is executable (chmod 755) and owned by {{ic|root:root}}.

シンプルなサンプルスクリプト:

{{hc|/etc/pm/sleep.d/00screensaver-lock|<nowiki>
#!/bin/sh
#
# 00screensaver-lock: lock workstation on hibernate or suspend

username= # add username here; i.e.: username=foobar
userhome=/home/$username
export XAUTHORITY="$userhome/.Xauthority"
export DISPLAY=":0"

case "$1" in
hibernate|suspend)
su $username -c "/usr/bin/slimlock" & # or any other such as /usr/bin/xscreensaver-command -lock
;;
thaw|resume)
;;
*) exit $NA
;;
esac</nowiki>}}

{{ic|/usr/bin/slimlock}} は使用する画面ロックユーティリティのパスに置き換えてください。

ユーザー名をハードコードしたくない場合 (例えばユーザーが複数いる場合など)、現在の X11 ユーザー名とディスプレイ番号を確認する必要があります。[[systemd]] を使っている場合、[https://github.com/rephorm/xuserrun xuserrun] と以下の sleep.d スクリプトが使えます (xuserrun と画面ロッカーのパスは適宜修正してください):

{{hc|/etc/pm/sleep.d/00screensaver-lock|<nowiki>
#!/bin/sh
#
# 00screensaver-lock: lock workstation on hibernate or suspend

case "$1" in
hibernate|suspend)
/path/to/xuserrun /usr/bin/slimlock & # or any other such as /usr/bin/xscreensaver-command -lock
;;
thaw|resume)
;;
*) exit $NA
;;
esac
</nowiki>}}

If you have problems using xuserrun, you can instead try having loginctl do this directly. This script will lock all active sessions before going into hibernation:

{{hc|/etc/pm/sleep.d/00screensaver-lock|<nowiki>
#!/bin/sh
#
# 00screensaver-lock: lock workstation on hibernate or suspend

case "$1" in
hibernate|suspend)
loginctl lock-sessions
;;
thaw|resume)
;;
*) exit $NA
;;
esac
</nowiki>}}

=== polkit でハイバネーションを無効化 ===

ハイバネーションを無効化するには、{{ic|/etc/polkit-1/}} に {{ic|99-disable-hibernate.rules}} という名前の新しいファイルを作成してください。そして、以下の内容を記述します:

{{hc|99-disable-hibernate.rules|<nowiki>
polkit.addRule(function(action, subject) {
if ((action.id == "org.freedesktop.login1.hibernate")) {
return polkit.Result.NO;
}
});

polkit.addRule(function(action, subject) {
if ((action.id == "org.freedesktop.login1.hibernate-multiple-sessions")) {
return polkit.Result.NO;
}
});
</nowiki>}}

KDE を使っている場合、一度ログオフすればハイバネーションオプションが消えます。

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

サスペンドやハイバネートが正しく動作しない場合、ログファイル {{ic|/var/log/pm-suspend.log}} に何らかの情報を見つけられる可能性があります。例えば、動作したフックやフックの出力などがログファイルで確認できます。

また、{{ic|pm-is-supported}} コマンドの出力も確認してください。このコマンドは ({{ic|--hibernate}} や {{ic|--suspend}} フラグが付けられたときに) サニティチェックを実行して、設定に問題がある場合エラーを報告します。設定の問題以外のエラーは認識してくれませんが、それでも有用ではあります。

=== セグメンテーション違反 ===

セグメンテーション違反が発生してシステムが反応しなくなったりする場合、[[#ハイバネーション (suspend2disk)|上]]で説明しているように {{ic|/boot/grub/menu.lst}} の resume-path に UUID を設定してみてください。

=== サスペンドから復帰する代わりに再起動する ===

この問題はサスペンド時に NVS 領域を保存するようになってから起こるようになりました (2.6.35-rc4) ([http://www.spinics.net/lists/linux-acpi/msg29521.html メーリングリストの投稿])。しかしながら、全てのマシンでこの機構が動作するとは限らないと知れ渡ってから、カーネルの開発者は {{ic|1=acpi_sleep=nonvs}} カーネルコマンドラインオプションで無効化できるようにしています ([[カーネルパラメータ]]を参照)。

=== サスペンドから復帰するとシャットダウンしてしまう ===

Acer Aspire AS3810TG では、サスペンドから復帰すると、パソコンが立ち上がるかわりにシャットダウンしてしまいます。同じような問題が発生する場合、カーネルに {{ic|1=i8042.reset=1}} パラメータを指定してみてください。[[GRUB]] の場合、{{ic|/boot/grub/grub.cfg}} の設定行を以下のようにします:
linux /vmlinuz-linux root=/dev/vg00/root resume=/dev/vg00/swap i8042.reset=1 ro

未確認ですが、以下を実行することで再起動せずにパラメータを設定することもできます:
# sysctl -e -w i8042.reset=1

=== サスペンドから復帰したときに画面が表示されない ===

Some laptops (e.g. Dell Inspiron Mini 1018) will just show a black screen with no backlight after resuming from suspend. If this happens to you, try going into the BIOS of the laptop and disabling Intel SpeedStep if it is present.

You could also try, without disabling SpeedStep, creating a quirk in {{ic|/etc/pm/sleep.d/}} with this content (requires {{Pkg|vbetool}}):
{{bc|
#!/bin/sh
#
case "$1" in
suspend)
;;
resume)
sleep 5
vbetool dpms off
vbetool dpms on
;;
*) exit $NA
;;
esac
}}
save it as you want but with a {{ic|00}} in front of the name so this is called last when resuming; remember to {{ic|chmod +x}} the script.
Try adjusting the {{ic|sleep}} time if the other commands are called too soon, or if it works well, you can also try removing that line.

Some other laptops (e.g. Toshiba Portégé R830) will just show a black screen with no backlight after resuming from suspend, with fans blowing at top speed. If this is what you're seeing, try going into the BIOS and disable the VT-d virtualization setting by switching to "VT-x only".

=== VirtualBox の問題 ===

ノートパソコンによっては VirtualBox のカーネルモジュールによって {{ic|pm-suspend}} や {{ic|pm-hibernate}} が機能しなくなることがあります ([https://bbs.archlinux.org/viewtopic.php?id=123354] を参照)。サスペンドやハイバネートがされる代わりに、システムはフリーズしてインジケータ LED が点滅します (ThinkPad の場合、サスペンドインジケータが点滅。MSI Wind U100 の場合、Caps Lock や Scroll Lock のインジケータが点滅)。{{ic|pm-suspend}} と {{ic|pm-hibernate}} のログは通常通りに出力されます。

サスペンドやハイバネートをする前にモジュールをアンロードして、復帰後にモジュールをリロードするようにすることで問題を解決できます。スクリプトを使うことでモジュールを管理できます:
{{bc|1=
#!/bin/sh

rmmod vboxdrv
pm-hibernate
modprobe vboxdrv
}}

{{Note|root で {{ic|vboxbuild}} を実行してカーネルモジュールをリビルドすることで問題が解決するという報告もあります。}}

=== スワップパーティションが存在しないのにハイバネート ===

有効なスワップパーティションが存在しないのにハイバネートしようとすると、ハイバネートが開始されるようにみえて、すぐに復帰してしまいます。たとえ、ログ出力を詳細にするように指定していても、スワップパーティションが存在しないことに関するエラーメッセージが全く表示されません。そのため、この問題をデバッグするのは大変です。スワップパーティションが何らかの理由で破損していて無効になっていると、インストール時にスワップパーティションを設定していてもこの問題が発生することがあります。ハイバネートですぐ復帰するようならば、使用しているスワップパーティションが本当に有効になっているか確認してください。{{ic|blkid}} コマンドの出力が以下のようになっている場合:
{{hc|# blkid|2=
/dev/sda1: UUID="00000-000-000-0000000" TYPE="ext2"
/dev/sda2: UUID="00000-000-000-0000000" TYPE="ext4"
/dev/sda3: UUID="00000-000-000-0000000" TYPE="ext4"
/dev/sda4: UUID="00000-000-000-0000000" TYPE="swap"
}}
タイプが {{ic|"swap"}} のパーティションがあれば大丈夫です。パーティションが存在しない場合、[[スワップ#スワップパーティション]]を見て、スワップパーティションを再作成・有効化してください。

=== サスペンドしようとしたときにカーソルしか表示されない黒画面になる ===

次のコマンドを実行したときにカーソルしか表示されなくなる場合:
$ sudo pm-suspend
{{ic|/var/log/pm-suspend.log}} を開いて "ehci" や "xhci" を検索してください。"ehci_hd", "xhci_hd", "ehci_hcd" などという名前が見つかります。

それから root で {{ic|/etc/pm/config.d/modules}} ファイルを作成して、先に見つけた ehci や xhci モジュールの名前を使ってコードを記述してください。例:
SUSPEND_MODULES="ehci_hcd"
これでサスペンドが機能するようになるはずです。

=== 画面が表示されない問題 ===

ノートパソコンを使っているユーザーの間でサスペンドやハイバネートからの復帰後に問題が発生することが報告されています。原因は {{ic|/etc/mkinitcpio.conf}} ファイルの "HOOKS" 配列の {{ic|autodetect}} フックです。{{ic|resume}} フックを追加するのと同じ方法でフックは無効化できます。リストから {{ic|autodetect}} を削除して新しいイメージを生成してください。

{{Note|[[plymouth]] を使っている場合、それが原因かもしれません。{{ic|/etc/mkinitcpio.conf}} ファイルの "HOOKS" 配列で {{ic|plymouth}} の前に {{ic|resume}} を追加することで問題が解決する場合があります。}}

=== 64ビットの OS で復帰できない ===

特定のマザーボードや BIOS の組み合わせで (特に Zotac の ITX ボードなどが知られています)、64ビットのオペレーティングシステムをインストールしている場合にサスペンドからの復帰が上手くできないことがあります。解決法は BIOS 設定を開いて DRAM 設定のページで "Memory Remapping Hole" を無効にしてください。RAM のサスペンドが修正されますが、全ての RAM が OS から認識されなくなる可能性もあります。

=== radeon ドライバーでハイバネートから復帰した時に黒画面になる ===

radeon ドライバーを使用していて {{ic|/etc/mkinitcpio.conf}} の {{ic|HOOKS}} 配列に {{ic|radeon}} があると、ハイバネーションからの復帰時に黒画面になることがあります。ただし、他のプロセスは問題なく動作します (コンソールを開いてコマンドを実行することで確認できます)。radeon の電源管理方法として {{ic|radeon.dpm<nowiki>=</nowiki>1}} を使用していることに関連がある模様です (カーネル 3.13 からのデフォルトとなっています)。

HOOKS 行から {{ic|radeon}} を削除 (そして initrd を再生成) することでこの問題は解決します ([https://bugs.freedesktop.org/show_bug.cgi?id=72716] を参照)。

=== ハイバネート時にコンピュータの電源が切れない ===

Linux をハイバネートしてディスクにデータが書き込まれた後、コンピュータの電源が正しく切れないことがあります。その場合、強制的に電源を切ってから再起動すると、復帰が正しく動作します。

{{ic|/etc/pm/config.d/hibernate_mode}} という名前の実行可能ファイルを作成して、次の行を記述することで修正できます: {{ic|HIBERNATE_MODE<nowiki>=</nowiki>"shutdown"}}。その後 pm-hibernate でコンピュータが正しくシャットダウンされるようになります。

=== サスペンド後にディスプレイの電源が入らない (radeon) ===

radeon gpu でサスペンド後にディスプレイが表示されない場合、以下の内容で {{ic|/etc/pm/config.d/radeon}} を作成してみてください:

{{hc|/etc/pm/config.d/radeon|2=
QUIRK_S3_BIOS="true"
QUIRK_S3_MODE="true"
}}

== 参照 ==

* [http://en.opensuse.org/SDB:Pm-utils OpenSUSE Wiki] - The article from where this was originally sourced (Licensed under GPL)
* [https://wiki.ubuntu.com/UnderstandingSuspend Understanding Suspend] - Ubuntu article explaining how suspending to RAM works
* [http://www.mjmwired.net/kernel/Documentation/power/basic-pm-debugging.txt#178 PM Debugging] - Basic PM debugging
*[[Cpufrequtils]] - CPU 周波数スケーリングと CPU 電源スキーム
*[[Acpid]] - ACPI イベントを通知するデーモン
* [http://superuser.com/questions/298672/linuxhow-to-hibernate-after-a-period-of-sleep Hibernate after sleep] - An example of a custom pm-utils hook where hibernation is triggered after a period of time in suspension

MTP

2017-01-17T12:52:35Z

Ootaharuki99: android-file-transfer が公式パッケージになっていたので修正

[[Category:サウンド]]
[[Category:イメージング]]
[[Category:ストレージ]]
[[Category:携帯端末]]
[[en:MTP]]
[[ru:MTP]]
[[zh-CN:MTP]]
{{Related articles start}}
{{Related|USB ストレージデバイス}}
{{Related articles end}}
MTP は多くの mp3 プレイヤー (例: Creative Zen) やモバイル端末 (例: Android 3+ デバイス) で使われているメディア転送プロトコル (Media Transfer Protocol) です。"Windows Media" フレームワークの一部であり、Windows Media Player と密接な関係があります。

== インストール ==

=== 機能性 ===

Linux の MTP サポートは {{Pkg|libmtp}} パッケージを[[インストール]]することで得られます。libmtp をインストールするだけでデバイスにアクセスできますが、特定のデバイスタイプで便利な機能 (例: ファイルマネージャ) と互換性を提供するパッケージが多数存在します。転送速度を向上させるパッケージもあります。

以下のパッケージはどれも [[Wikipedia:Filesystem in Userspace]] で実装されています:

* {{Pkg|mtpfs}}
* {{Pkg|android-file-transfer}} - ミニマルな UI が付属している MTP クライアント
* {{AUR|jmtpfs}} - Android 4 以降の新しいデバイスで上手く動作します
* {{AUR|go-mtpfs-git}} - Android 3 以降の新しいデバイスで上手く動作します
* {{AUR|simple-mtpfs}}

上記の全てが {{ic|libmtp}} よりも優れた機能とパフォーマンスを誇っています。USB デバイスは多数存在するので、まずどれか一番適しているか試すことから始めて下さい。

{{Tip|MTP 関連のパッケージをインストールした後はコンピュータを再起動することを推奨します。}}

=== ファイルマネージャと統合 ===

MTP を使ってファイルマネージャ上で Android デバイスのストレージの中身を表示するには、適当なプラグインをインストールしてください:

* [[GVFS]] を使用するファイルマネージャ (GNOME の [[Nautilus]], Xfce の [[Thunar]]) の場合、MTP のサポートは {{Pkg|gvfs-mtp}} を、PTP のサポートは {{Pkg|gvfs-gphoto2}} をインストールしてください。
* KIO (KDE の Dolphin) を使用するファイルマネージャの場合、MTP サポートは {{Pkg|kio-extras}} に含まれています (Dolphin に依存)。

必要なパッケージをインストールすれば、ファイルマネージャに自動的にデバイスが表示され、{{ic|mtp://[usb:002,013]/}} というような URL でアクセスすることができます。

== 使用方法 ==

まず最初にマウントポイントのディレクトリを作成する必要があります。以下の例では {{ic|~/mnt}} ディレクトリを使っています。また、コンピュータに接続する前にデバイスのロック画面を解除するようにしてください。

=== libmtp ===

MTP デバイスの接続時に、MTP デバイスが検出されたかどうかを確認するには次のコマンドを使用:
# mtp-detect
エラーが表示される場合、[[#libmtp 2|トラブルシューティング]]を参照。

{{Note|通常ユーザーは {{ic|uucp}} グループに属している必要があります。}}

MTP デバイスに接続するには、以下を使用:
# mtp-connect

接続が成功すると、{{ic|mtp-connect}} と一緒に複数のスイッチオプションを使ってデバイスのデータにアクセスすることができます。

以下のように、MTP デバイスにアクセスするのに使える単独のコマンドも存在します:

mtp-albumart mtp-emptyfolders mtp-getplaylist mtp-reset mtp-trexist
mtp-albums mtp-files mtp-hotplug mtp-sendfile
mtp-connect mtp-folders mtp-newfolder mtp-sendtr
mtp-delfile mtp-format mtp-newplaylist mtp-thumb
mtp-detect mtp-getfile mtp-playlists mtp-tracks

{{Warning|コマンドによっては MTP デバイスに悪影響を与えることがあるので注意してください。}}

=== mtpfs ===

{{Note|以下の方法が使えない時は [[デジタルカメラ#libgphoto2|gphoto2]] や、[[PCManFM]] などの gvfs をサポートしているファイルマネージャを用いる必要があります。}}

Mtpfs はあらゆる MTP デバイスの読み書きをサポートする FUSE ファイルシステムです。外付けデバイスとして MTP デバイスをマウントできるようにします。

Mtpfs は[[公式リポジトリ]]の {{Pkg|mtpfs}} パッケージでインストールすることが可能です。
* まず {{ic|/etc/fuse.conf}} を編集して以下の行をアンコメントしてください:
user_allow_other

* デバイスをマウントするには:
$ mtpfs -o allow_other /media/YOURMOUNTPOINT
* デバイスをアンマウントするには:
$ fusermount -u /media/YOURMOUNTPOINT
* デバイスを root でアンマウントするには:
# umount /media/YOURMOUNTPOINT

また、{{ic|~/.bashrc}} に以下を記述すると便利です:
alias android-connect="mtpfs -o allow_other /media/YOURMOUNTPOINT"
alias android-disconnect="fusermount -u /media/YOURMOUNTPOINT"
もしくは sudo を使って:
alias android-disconnect="sudo umount -u /media/YOURMOUNTPOINT"
{{Note|sudo を使用するときにパスワードを聞いて欲しくない場合は、[[USB ストレージデバイス]]を参照してください。}}

=== jmtpfs ===

[http://research.jacquette.com/jmtpfs-exchanging-files-between-android-devices-and-linux/ jmtpfs] は MTP (Media Transfer Protocol) デバイスへのアクセスを提供する FUSE と libmtp ベースのファイルシステムです。MTP はサポートしているが USB マスストレージはサポートしていない新しい Android デバイスと Linux システム間でのファイルの交換を特に目的にしています。jmtpfs は [[AUR]] の {{AUR|jmtpfs}} でインストール可能です。

デバイスをマウントするには次のコマンドを使用:
$ jmtpfs ~/mtp

デバイスをアンマウントするには次のコマンドを使用:
$ fusermount -u ~/mtp

=== go-mtpfs ===

{{Note|
* デバイスによってはファイルの書き込みについて go-mtpfs は mtpfs/jmtpfs よりも良いパフォーマンスを発揮します。速度が遅いときは試してみて下さい。
* 外付け SD カードが存在する場合は go-mtpfs によるマウントは失敗します。外付け SD カードがあるときは取り除いてからマウントしてみてください。
}}

上記のやり方では芳しい結果が得られない場合、[[AUR]] から {{AUR|go-mtpfs-git}} を試してみて下さい。以下の手順は Samsung Galaxy Nexus GSM, Asus/Google Nexus 7 (2012年の第一世代), Samsung Galaxy S 3 mini, Google Nexus 4 でテスト済みです (Nexus 4 で動作する mtp ソフトウェアは go-mtpfs だけでした。usb デバッグを有効にして、メディアデバイスとして接続する設定です)。

上のセクションで説明されているように {{Pkg|android-udev}} をインストールすると {{ic|/usr/lib/udev/rules.d/51-android.rules}} が作成されるので、あなたの idVendor と idProduct に適用されるように編集してください。ID は mtp-detect を実行することでわかります。行末にカンマと {{ic|<nowiki>OWNER="yourusername"</nowiki>}} を追加して、ファイルを保存します。

* "fuse" グループにユーザーを追加:
# gpasswd -a [user] fuse

* "fuse" グループが存在しない場合は次のコマンドでグループを作成:
# groupadd fuse

ログアウトまたは再起動して変更を適用してください。

* "Android" という名前のマウントポイントを作成するために次のコマンドを実行:
$ mkdir Android

* スマートフォンをマウントするには次を使用:
$ go-mtpfs Android

* スマートフォンをアンマウントするには:
$ fusermount -u Android

上の例と同じように {{ic|.bashrc}} にエイリアスを作成すると便利です。

=== simple-mtpfs ===

MTP デバイスのためのもうひとつの FUSE ファイルシステムです。{{Pkg|mtpfs}} よりも信頼性が上回っています。AUR から {{AUR|simple-mtpfs}} をインストールするか、ソースからビルドすることができます。以下のコマンドは root で実行しないで下さい。

MTP デバイスをリストアップするには次を実行:

$ simple-mtpfs --list-devices

MTP デバイス (この例ではデバイス0) をマウントするには次を実行

$ simple-mtpfs /path/to/your/mount/point

アンマウントするには次を実行:

$ fusermount -u /path/to/your/mount/point

=== Android File Transfer ===

;FUSE インターフェイス

$ mkdir ~/my-device
$ ./aft-mtp-mount ~/my-device

アルバムアートを表示したい場合、{{ic|albumart.xxx}} という名前を付けて一番最初にフォルダに配置してください。それから他のファイルをコピーしてください。また、fuse では ui/cli ファイル転送よりも7-8倍転送が遅くなるので注意してください。

;Qt ユーザーインターフェイス

アプリケーションを起動して、コピー先のフォルダを選択してツールバーのボタンをクリックしてください。利用できるオプション: ''Upload Album'', ''Upload Directory'', ''Upload Files''。''Upload Album'' はアルバムカバーのディレクトリを検索して、適当なカバーを設定します。

=== メディアプレイヤー ===

Amarok などの音楽プレイヤーで MTP デバイスを使うこともできます。これには {{ic|/usr/lib/udev/rules.d/51-android.rules}} を編集する必要があります (以下では MTP デバイスの例として Galaxy Nexus を使っています):

まず次を実行してデバイスを確認してください:
$ lsusb
以下のように表示されます:
Bus 003 Device 011: ID 04e8:6860 Samsung Electronics Co., Ltd GT-I9100 Phone [Galaxy S II], GT-P7500 [Galaxy Tab 10.1]
上記の場合は以下のようにエントリを記述します:
SUBSYSTEM=="usb", ATTR{idVendor}=="04e8", ATTR{idProduct}=="6860", MODE="0666", OWNER="[username]"
記述したら、udev ルールをリロードしてください:
# udevadm control --reload

{{Note|MTP をインストールした後、デバイスを認識させるために再起動が必要なことがあります。}}

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

=== libmtp ===

==== 未知のデバイス ====

以下のようなメッセージが表示される場合:

Device 0 (VID=XXXX and PID=XXXX) is UNKNOWN.
Please report this VID/PID and the device model to the libmtp development team

デバイスが次のリストに含まれているか確認する必要があります: [http://sourceforge.net/p/libmtp/code/ci/HEAD/tree/src/music-players.h Supported devices list]。リストに入っていない場合は、開発チームに報告してください。リストに含まれている場合は、libmtp が少しだけ旧式になっている可能性があります。libmtp によって適切に使用されるように、デバイスを次のファイルに追加することが可能です:
/usr/lib/udev/rules.d/69-libmtp.rules

==== Unable to enumerate USB device ====

システムログ ({{ic|journalctl}}) に以下のようなメッセージが表示される場合:

usb usb4-port2: unable to enumerate USB device

以下のコマンドを実行してみてください [https://bbs.archlinux.org/viewtopic.php?pid=1087323#p1087323]:

# modprobe -vr uhci_hcd
# modprobe -va ohci_hcd
# modprobe -va uhci_hcd

上記のコマンドで直る場合、以下の内容で {{ic|/etc/modprobe.d/usb_hci_order.conf}} を作成してください:

# create a dependency on ohci for uhci, which fixes problems
# with external usb devices not showing up
#
softdep uhci_hcd pre: ohci_hcd

=== gvfs-mtp ===

{{Pkg|gvfs-mtp}} パッケージをインストールしても、デバイスがファイルマネージャに表示されない場合、デバイスが自動マウントされるように udev ルールを書く必要があるかもしれません。

デバイスを接続して、vendor-id と product-id をそれぞれ取得してください:

$ lsusb
Bus 001 Device 007: ID 0421:0661 Nokia Mobile Phones Lumia 920
(...)

ID の文字の後の2つの数字が ''vendorID'' : ''productID'' です。

ID がわかったら udev ルールを作成します。例:

# nano /etc/udev/rules.d/51-android.rules

ルールの中身は以下のようにしてください:

ATTR{idVendor}=="YOUR VENDOR ID HERE", ATTR{idProduct}=="YOUR PRODUCT ID HERE", SYMLINK+="libmtp", MODE="660", ENV{ID_MTP_DEVICE}="1"

udev ルールをリロードします:

# udevadm control --reload

そしてシステムを再起動してください。これで (Thunar などの) ファイルマネージャは MTP デバイスを自動でマウントできるようになったはずです [https://bbs.archlinux.org/viewtopic.php?id=180719]。

=== kio-mtp ===

"ファイルマネージャで開く"が使えない場合は、{{ic|/usr/share/apps/solid/actions/solid_mtp.desktop}} ファイルを編集することで問題を解決できます。

次の行を:
Exec=kioclient exec mtp:udi=%i/
以下のように変更してください:
Exec=dolphin "mtp:/"

Fcitx

2016-10-05T12:50:39Z

Ootaharuki99: スキンについて言及

[[Category:国際化]]
[[en:Fcitx]]
[[zh-CN:Fcitx]]
{{Related articles start}}
{{Related|IBus}}
{{Related|SCIM}}
{{Related2|uim を使って日本語を入力|UIM}}
{{Related articles end}}
[https://fcitx-im.org/wiki/Fcitx Fcitx] (Flexible Input Method Framework) は Linux に環境非依存の言語サポートを提供する[[Wikipedia:ja:インプットメソッド|インプットメソッドフレームワーク]]です。多くの言語をサポートし便利な non-CJK 機能が含まれています。

==インストール==
{{Pkg|fcitx}} は [community] リポジトリから [[Pacman]] でインストールできます。

本体の他に、GTK+ や Qt アプリケーションで使うための[[#設定|インプットメソッドモジュール]]をインストールすると良いでしょう。

=== インプットメソッドエンジン ===

入力したい言語にあわせて、インプットメソッドエンジンをインストールしてください:

====日本語====

* {{Pkg|fcitx-anthy}}: 人気の日本語入力エンジン。開発は停止しています。
* {{Pkg|fcitx-mozc}}: Google 日本語入力のオープンソース版である [[Mozc]] がベース。
* {{Pkg|fcitx-kkc}}: {{Pkg|libkkc}} がベースの新しい日本語仮名漢字入力エンジン。
* {{Pkg|fcitx-skk}}: {{Pkg|libskk}} がベースの日本語仮名漢字入力エンジン。

==== 他の言語 ====

* {{Pkg|fcitx-sunpinyin}}: {{Pkg|sunpinyin}} がベース。速度と正確性のバランスが良い。
* {{Pkg|fcitx-libpinyin}}: {{Pkg|libpinyin}} がベース。素晴らしいアルゴリズムを持っていますがバグが存在し、辞書が欠けています。
* {{Pkg|fcitx-googlepinyin}}: {{Pkg|libgooglepinyin}} がベース。Android 用の Google ピンイン IME。
* {{AUR|fcitx-sogoupinyin}}: Linux 向けの捜狗インプットメソッド。同音異字、クラウド入力、英語入力、混合入力をサポート。
* {{Pkg|fcitx-cloudpinyin}}: クラウドによる中国語入力をサポート。
* {{Pkg|fcitx-chewing}}: {{Pkg|libchewing}} がベースの繁体字の注音入力エンジン。
* {{Pkg|fcitx-table-extra}}: [[Wikipedia:ja:倉頡輸入法|倉頡]], [[Wikipedia:Zhengma_method|郑码]], [[Wikipedia:Boshiamy_method|嘸蝦米]]サポートを追加。
* {{Pkg|fcitx-rime}}: [[Rime IME]] プロジェクトのスキーマがベース。
* {{Pkg|fcitx-hangul}}: {{Pkg|libhangul}} がベースの韓国語のハングル入力エンジン。
* {{Pkg|fcitx-unikey}}: ベトナム文字入力エンジン。
* {{Pkg|fcitx-sayura}}: シンハラ文字入力エンジン。
* {{Pkg|fcitx-m17n}}: [http://www.nongnu.org/m17n/ M17n] によって提供されている他の言語の入力エンジン。

==== その他 ====

* {{Pkg|fcitx-ui-light}}: fcitx の軽量 UI。
* {{Pkg|fcitx-fbterm}}: Fbterm のサポート。
* {{Pkg|fcitx-table-other}}: Latex, 絵文字など。

他のパッケージは [[AUR]] からインストールできます。fcitx のコンポーネントをインストールした後は fcitx の再起動が必要です。

===スキン===
fcitx にはスキンで外観をカスタマイズする機能があり、標準では dark, classic, default の3つのスキンのみが提供されています。

しかしながら、いくつかの追加スキンが [[AUR]] からインストールできます。以下はその一部です:

* {{AUR|fcitx-skin-material}}: マテリアルデザイン風の fcitx スキン。
* {{AUR|fcitx-skins}}: 8個のスキンを含んだリッチなパッケージ。

==設定==

Fcitx は GUI の設定ツールを提供しています。[[Arch User Repository|AUR]] から {{Pkg|kcm-fcitx}} (kcm ベース), {{Pkg|fcitx-configtool}} (gtk3 ベース), {{AUR|fcitx-configtool-gtk2}} (gtk2 ベース、サポートなし) のどれかをインストールできます。

Fcitx は手動設定をサポートしていません。

=== GTK+ と Qt モジュール ===

gtk や qt のプログラムでより良いエクスペリエンスを得たり、(特に gtk の方で) xim によって生じる未解決の問題・バグを除くために、gtk や qt の適切なインプットメソッドモジュールをインストールしてください: {{Pkg|fcitx-gtk2}} (gtk2), {{Pkg|fcitx-gtk3}} (gtk3), {{Pkg|fcitx-qt4}} (qt4), {{Pkg|fcitx-qt5}} (qt5)。次のコマンドを実行することで4つのパッケージをインストールできます (fcitx-qt5 はあまり使われていないので含まれていません):

# pacman -S fcitx-im

Fcitx を使う前に、環境変数をいくつか設定する必要があります。設定はとても簡単です。

以下の行をデスクトップのスタートアップスクリプトファイル (KDM, GDM, LightDM, SDDM を使っている場合は {{ic|.xprofile}} もしくは {{ic|.profile}}、startx や Slim を使っている場合は {{ic|.xinitrc}}) に追加してください。この設定で、fcitx は gtk/qt のインプットメソッドモジュールを使うようになり xim プログラムをサポートします (必要なインプットメソッドモジュールがすでにインストールされているか確認してください):

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

{{Warning|上記の設定を {{ic|.bashrc}} でしないでください。{{ic|.bashrc}} はインタラクティブな bash セッションを初期化するときに使われます。インタラクティブでないセッションや X セッションの初期化では用いられません。さらに、{{ic|.bashrc}} で環境変数を設定すると、コマンドラインから実行した診断ツールに誤解を与えて、X セッションでは環境変数が使われていないのに正しく設定されているかのように表示されることがあります。}}

{{Note|
* 上の設定で動かないときは {{ic|1=export DefaultIMModule=fcitx}} を追加してみて下さい。
* Fcitx で全ての Qt アプリに問題が発生する場合、qtconfig (qtconfig-qt4) を起動して、3番目のタブを開いて、"Default Input Method" コンボボックスに fcitx があることを確認してください。
* 現在、Qt5 アプリケーション + fcitx を使用する場合、上記の環境変数を {{ic|.bashrc}} ファイルにも追加しないと動作しないという報告があります (Plasma 5 を startx した場合や、gnome-shell で qt5 アプリケーションを起動した場合)。}}

変更を適用するためにログインしなおしてください。

=== Xim ===

任意で、gtk や qt のプログラムで xim を使うように設定することも可能で、その場合上の行を以下のように変更してください:

export GTK_IM_MODULE=xim
export QT_IM_MODULE=xim

{{Warning|xim を使用するとインプットメソッドによって、入力ができなくなったりインプットメソッドを再起動するとアプリケーションがフリーズするなどの問題がおこることがあります。xim 関連の問題に対しては Fcitx は修正やサポートを提供できません。これは他のインプットメソッドフレームワークでも同じで、可能な限り xim ではなくツールキット (gtk/qt) のインプットメソッドモジュールを使って下さい。}}

{{Note|Gtk2 は 2.24.20 から immodule のキャッシュファイルとして {{ic|/usr/lib/gtk-2.0/2.10.0/immodules.cache}} を使っています。{{ic|GTM_IM_MODULE_FILE}} 環境変数を設定していたり公式パッケージの install スクリプトを使ってキャッシュを更新していない場合、環境変数を変更・削除して {{ic|/usr/bin/gtk-query-immodules-2.0 --update-cache}} を使って immodule キャッシュを更新してください。}}

変更を適用するためにログインしなおしてください。

== 使用方法 ==

=== デスクトップ環境 ===

[[KDE]], [[GNOME]], [[Xfce]], [[LXDE]] などの XDG 互換のデスクトップ環境を使っている場合は、再ログインで自動的に起動するようになるはずです。起動しないときは、ターミナルを開いて次のように入力してください:

$ fcitx

fcitx が正しく動作しているか確認するために、leafpad といったアプリケーションを開いて CTRL+Space (インプットメソッドの切り替えのデフォルトのショートカット) を押して FCITX を呼び出しなにか文字を入力してみて下さい。

Fcitx があなたの環境で自動で起動しない場合や fctix を起動するパラメータを変更したい場合は、デスクトップ環境によって提供されているツールを使って xdg の自動起動を設定するか {{ic|~/.config/autostart/}} ディレクトリ内の {{ic|fcitx-autostart.desktop}} ファイルを編集してください (存在しないときは {{ic|/etc/xdg/autostart/}} からコピーしてください)。

デスクトップ環境が xdg 自動起動をサポートしていない場合は、(環境変数を正しく設定した後に) 次の行をスタートアップスクリプトに追加してください:

$ fcitx

xim サポートのある他のインプットメソッドが動作していると、Fcitx は xim エラーで起動できません。Fcitx を起動する前に他のインプットメソッドが動いていないことを確認してください。

==デスクトップ環境の統合==

===キーボードレイアウトの統合===
現在 fcitx-keyboard が初めからサポートされています。設定ツールを開き (上述の {{Pkg|kcm-fcitx}} もしくは {{Pkg|fcitx-configtool}})、"Show only current language" のチェックを外してあなたのキーボードにあったレイアウトを探して下さい。

スペルチェックを有効にするには、fcitx が fcitx-keyboard によるインプットメソッドを使っている時に ctrl + alt + h を押して下さい。長い単語を入力すれば、動いているかどうか確認できます。

===Gnome-Shell===

extensions.gnome.org や [[Arch User Repository|AUR]] の {{AUR|gnome-shell-extension-kimpanel-git}} パッケージから kimpanel をインストールでき、ibus-gjs と同じように使うことができます。

GNOME はありとあらゆるインプットメソッドを破壊しようとするため、Fcitx を使うために、gnome-control-center から全ての入力ソースとインプットメソッドのホットキーを削除してから次のコマンドを実行して iBus との統合を無効にする必要があります:
$ gsettings set org.gnome.settings-daemon.plugins.keyboard active false

===KDE===

{{Pkg|kcm-fcitx}} や {{Pkg|kdeplasma-addons-applets-kimpanel}} をインストールできます。

{{Pkg|kcm-fcitx}} は fcitx の kcontrol モジュールです。

{{Pkg|kdeplasma-addons-applets-kimpanel}} は kde と統合するための plasmoid です。kimpanel を plasma に追加すれば fcitx は自動的に切り替えます。

==クリップボード==
fcitx を使ってクリップボード (とクリップボード履歴) にある文章を入力することが可能です。デフォルトのトリガーキーは Control-; です。このトリガーキーはクリップボードのアドオンの設定ページにある他のオプションと同じように設定することが可能です。

{{Note|クリップボードマネージャではないため、クリップボードマネージャにあるような中身の選択や変更はできません。クリップボードからの入力にだけ使えます。}}

{{Warning|クライアントによっては複数行の入力をサポートしていないため fcitx-clipboard を使ってクリップボードの中身をペーストすると一行しか出ないことがあります。これはバグかプログラムの方の入力の問題なので fcitx は何もできません。}}

==トラブルシューティング==
=== 問題の診断 ===
fcitx を使っていて問題が発生する場合、例えばどのアプリケーションでも Ctrl+Space が使えないなどのことが起こるときは、{{ic|fcitx-diagnose}} を使ってまず問題を診断してみてください。{{ic|fcitx-diagnose}} はよくある問題についての手がかりを提供してくれます。また、(IRC やフォーラムなどで) 他の人に相談するときはコマンドの出力を貼り付けると役に立つはずです。

===Emacs===
{{ic|LC_CTYPE}} が英語の場合、emacs のバグによって emacs でインプットメソッドが使えなくなることがあります。emacs を起動する前に {{ic|ja_JP.UTF-8}} など {{ic|LC_CTYPE}} を他の値に設定することで問題を回避できます。

使用するロケールは有効である必要があります。{{ic|/etc/locale.gen}} を編集して適当な行 (例: {{ic|ja_JP.UTF-8}}) をアンコメントし、{{ic|locale-gen}} を実行してください。

[[Emacs#デーモンとして|emacs デーモン/クライアントモード]]を使う場合、デーモンの起動時に {{ic|LC_CTYPE}} を設定してください。例えば {{ic|1=LC_CTYPE=ja_JP.UTF-8 emacs --daemon}} というコマンドを使って emacs デーモンを起動します。

デフォルトのフォントセットはベースフォントとして {{ic|-*-*-*-r-normal--14-*-*-*-*-*-*-*}} を使います (src/xfns.c)。マッチするフォント (terminus や 75dpi など、{{ic|xlsfonts}} の出力を見て下さい) がない場合、XIM は有効になりません。

===インプットメソッドモジュール===
ほとんどのプログラムではインプットメソッドモジュールがなくてもインプットメソッドを使うことができますが、その場合、未解決の問題が発生する可能性があります。

バージョン 13 以降の firefox では、ポップアップメニューが xim にとって機能しなくなります。fcitx-gtk2 と最新の fcitx をインストールしてください。

===Ctrl+Space が GTK のプログラムで機能しない===

ロケールを英語に設定しているとこの問題が発生することがあります。GTK_IM_MODULE が正しく設定されているか確認してください。

参照: [http://fcitx-im.org/wiki/FAQ#When_use_Ctrl_.2B_Space.2C_Fcitx_cannot_be_triggered_on FAQ]

*_IM_MODULE 環境変数を設定していても fcitx が有効にできない場合は、適切なインプットメソッドモジュールをインストールしているか確認してください。

プログラムによっては xim しか使わないため、そうしたプログラムを使っているときは、XMODIFIERS が正しく設定されているか確認してください。プログラムの例: gtk や qt を使わないプログラム全て (例: tk や motif、もしくは xlib を直接使っているプログラム), emacs, opera, openoffice, libreoffice, skype。

gnome の gnome-terminal で fcitx が有効にできず、上の方法で効果がない場合は、以下のコマンドを試してみて下さい:

$ gsettings set org.gnome.settings-daemon.plugins.xsettings overrides "{'Gtk/IMModule':<'fcitx'>}"

=== 内蔵の Chinese Pinyin がデフォルトで有効にならない ===

ロケールが {{ic|en_US.UTF-8}} である場合、fcitx は内蔵の Chinese Pinyin インプットメソッドをデフォルトで有効にしません。{{ic|fcitx-keyboard-us}} インプットメソッドだけが有効にされます。{{ic|fcitx-diagnose}} コマンドを実行すると以下のように表示されます:

## Input Methods:
1. Found 1 enabled input methods:
fcitx-keyboard-us
2. Default input methods:
**You only have one input method enabled, please add a keyboard input method as the first one and your main input method as the second one.**

GUI の設定ツールで {{ic|Pinyin}} や {{ic|Shuangpin}} インプットメソッドを追加してインプットメソッドが有効にしてください。

=== fcitx と KDE ===

何らかの理由で、[[KDE]] がキーボードレイアウトを適切に扱えないことがあります。例えば、US (English) から LT (Lithuanian) に切り替えた場合、キーボードの数字キーは全てリトアニア文字になるはずですが、数字が出力されてしまいます。以下の手順で修正することが可能です:

# [[#KDE|上のセクション]]で書かれているパッケージをインストールしてください。
# バックグラウンドで {{ic|fcitx}} を動かしている場合は終了してください。
# KDE に関連することを無効にします:
## ''System settings --> Input devices --> Layouts (tab)'' から "Configure layouts" のチェックを外して下さい。
## ''System settings --> Input devices --> Advanced (tab)'' から "Configure keyboard options" のチェックを外して下さい。
# ターミナルを開いて {{ic|fcitx}} と入力して fcitx を起動します。ターミナルは閉じてもかまいません。{{ic|fcitx}} はバックグラウンドで動作し続けます。
# 必要なレイアウトを設定してください (システムトレイアイコンを右クリックして "Configure" をクリック)。
# システムトレイアイコンを右クリックして、"Exit" をクリック。

これでレイアウトがちゃんと使えるようになるはずです。KDE のレイアウト切り替えrアイコンが表示され、マウススクロールしたりアイコンをクリックすることでレイアウトを切り替えられます。

=== 勝手にインプットメソッドが英語に切り替わってしまう ===

XMind でエンターを押してノードを作成したときなど、インプットメソッドが勝手に英語に切り替わってしまって、元のインプットメソッドに手動で戻さなくてはならないことがあります。

この問題を修正するには、fcitx の GUI 設定ツール ({{Pkg|fcitx-configtool}} に含まれています) を開いて、"Global Config" タブの "Share State Among Window" ドロップダウンメニューから、"PerProgram" または "All" を選択してください。

==参照==
*[https://github.com/fcitx/fcitx/ Fcitx GitHub]
*[http://fcitx-im.org/ Fcitx Wiki]