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

Rust

2021-08-25T12:40:20Z

R6eve: curlオプションを英語版かつ公式ドキュメントと同期

[[Category:プログラミング言語]]
[[en:Rust]]
[[ru:Rust]]
[http://rust-lang.org/ Rust] は驚異的に高速で、セグメンテーション違反を滅多に起こさず、スレッドとメモリの安全性が保証された、システムプログラミング言語です。

== ライブラリ ==

=== Rust コアライブラリ ===

[https://doc.rust-lang.org/core/ Rust Core Library] は何にも依存しない Rust 標準ライブラリの基礎となるライブラリです。LLVM と直接通じることで、ハードウェアに囚われないプラットフォームとして Rust を使うことができます。LLVM との緊密な統合により、Clang でコンパイルされた C アプリケーションよりも高い性能を発揮することができ、libcore で設計された Rust ソフトウェアは C よりも低レイヤーを扱うことができます。組み込み環境向けのソフトウェアを開発している場合、{{ic|#![no_std]}} で標準ライブラリを省くことでコアライブラリだけを使うことができ、バイナリサイズを小さく、高い性能を発揮させることが可能です。ただし、{{ic|#![no_std]}} を使用すると Rust コミュニティから取得することができる膨大なソフトウェアに制限がかかるため、大抵のライブラリは標準ライブラリを必要としています。

=== Rust 標準ライブラリ ===

[http://doc.rust-lang.org/std/index.html Rust Standard Library] は移植性の高い Rust ソフトウェアによって構成された便利な高水準の抽象ライブラリです。{{ic|Vec}}, {{ic|Iterator}}, {{ic|Option}}, {{ic|Result}}, {{ic|String}} 型や、基本的なメソッド、大量の標準マクロ、I/O やマルチスレッドのサポート、{{ic|Box}} によるヒープメモリ確保などの便利な機能、その他、コアライブラリに存在しない高度な機能が多数存在します。

=== リリースサイクル ===

Rust は Firefox のリリースサイクルと同じように6週間ごとに定期的にリリースされます。新しいリリースが出るたびに、コアライブラリや標準ライブラリは改善され、対応プラットフォームが新しく増えたりパフォーマンスが向上したり、あるいは新しい機能の安定化が行われます。

== インストール ==

=== ネイティブのインストール方法 ===

Rust の最新安定版を[[インストール]]するには、{{Pkg|rust}} パッケージを[[インストール]]してください。{{ic|rustc}} コンパイラと [[Cargo]] がインストールされます。

Rust コンパイラの開発版は [[AUR]] からインストールできます。ビルド済みの汎用バイナリは {{AUR|rust-nightly-bin}} を、システムライブラリが付属するコンパイラのビルドは {{AUR|rust-git}} を使ってください。[[非公式ユーザーリポジトリ#rust-git|非公式リポジトリ]]を使うことで定期的に更新されるビルド済みの rust-git パッケージを入手することもできます。

=== Rustup によるインストール方法 ===

Rust でソフトウェアを開発するときに、公式に推奨されている Rust のインストール方法は [https://www.rustup.rs/ Rustup ツールチェインマネージャ] を使用する方法です (Rustup は Rust で書かれています)。

ソフトウェアリポジトリに存在するスタンドアロンな Rust を使用しないで、Rustup ツールチェインマネージャを使用する利点として、複数のプラットフォーム (Windows, Mac, Android) やアーキテクチャ (x86, x86_64, arm) 用に複数のツールチェイン (stable, beta, nightly) をインストールすることができる点が挙げられます。

==== 上流のインストールスクリプト ====

{{ic|curl --proto '<nowiki>=</nowiki>https' --tlsv1.2 -sSf <nowiki>https://sh.rustup.rs</nowiki> -o rust.sh}} としてファイルをダウンロードします。そのあと、{{ic|less ./rust.sh}} でファイルの内容を確認した上で、{{ic|./rust.sh}} でスクリプトを実行してください。スクリプトはログインシェルの[[Bash#実行|設定ファイル]]の PATH のみ変更します。一度ログアウトしてからログインしなおすか {{ic|source $HOME/.cargo/env}} を実行する必要があります。rustup をアップデート {{ic|rustup self update}} を実行するだけです。

{{Warning|[https://rustup.rs/ Rustup] のドキュメントに書かれている、{{ic|curl ''some-url'' | sh}} を実行するのは、セキュリティ上のリスクがあると考えられます。ダウンロード中に壊れさえするかもしれない、未知のソースコードを実行するからです。従って、実行する前に、手動でダウンロードし内容を確認することが推奨されます。}}

{{Note|{{ic|rustup}} コマンドを実行する前に PATH に {{ic|$HOME/.cargo/bin}} を追加してください。}}

==== Arch Linux パッケージ ====

{{Pkg|rustup}} は[[公式リポジトリ]]からインストールすることもできます。公式リポジトリからインストールした場合 {{ic|rustup self update}} は使用できないので注意してください。pacman で直接パッケージをアップデートする必要があります。

この方法だと、Rust のバイナリが {{ic|~/.cargo/bin}} ではなく {{ic|/usr/bin}} にあり、{{ic|PATH}} に別のディレクトリを加えなくてよい利点があります。

{{Note|既定では、{{Pkg|rustup}} パッケージをインストールしても、ツールチェインはインストール'''されません'''。かわりに、{{ic|/usr/bin/rustup}} コマンドから {{ic|/usr/bin/rustc}} や {{ic|/usr/bin/cargo}} など一般的なバイナリにシンボリックリンクが張られます。次に述べるように、Rust コマンドを動作させるには、利用者が手動でツールチェインをインストールする必要があります。}}

ツールチェインをインストールするには、{{ic|stable}} か {{ic|nightly}} のどちらのバージョンを使用するか rustup に指定する必要があります:

{{bc|<nowiki>
$ rustup default stable
</nowiki>}}

==== 使い方 ====

{{ic|stable}}、{{ic|beta}}、{{ic|nightly}} や {{ic|1.23.0}} などのツールチェインを手動でインストールする必要があったり、また、他のツールチェインを使用したりテストするときには次のコマンドを入力します:

$ rustup toolchain install ''toolchain''

すると、Rust コマンドを {{ic|rustup run ''toolchain'' ''command''}} として実行できます。これらのコマンドを直接実行するには、ツールチェインをアクティベートする必要があります:
$ rustup default toolchain

{{ic|rustc -V}} を使って rust のバージョンを確認してください:

{{hc|$ rustc -V |<nowiki>
rustc 1.26.0 (a77568041 2018-05-07)
</nowiki>}}

{{Note|Rustup は {{Pkg|rust}} パッケージに含まれている Rust コマンドのうち、{{ic|rustfmt}} や {{ic|rls}} などいくつかをインストールしません。これにより、Rust メンテナが nightly チャンネルを {{ic|rustfmt}}/{{ic|rls}} が壊れていても提供できるようになります。これらをインストールするには、個別に {{ic|rustup component add rls}} および {{ic|rustup component add rustfmt}} を実行します。また、実行することで、{{ic|rustfmt}}/{{ic|rls}} が壊れる場合、nightly チャンネルの更新を保留するようになります。}}

{{Note|Rust 自身にはリンカはないので、リンカが別途インストールされてなければなりません。リンカとして例えば {{Pkg|gcc}} をインストールすることができます。リンカがないと Rust は {{ic|error: linker `cc` not found.}} とエラーを出力します。}}

=== インストールのテスト ===

以下のようなシンプルなプログラムをビルドして、Rust が正しくインストールされていることを確認してください:
{{hc|~/hello.rs|
fn main() {
println!("Hello, World!");
}
}}

{{ic|rustc}} でコンパイルして実行することができます:
{{hc|$ rustc hello.rs && ./hello|
Hello, World!
}}

== クロスコンパイル ==

=== rustup を使う ===

rustup を使うことで簡単にクロスコンパイルができます。rustup は多数のクロスコンパイルターゲットに対応しています。対応しているプラットフォームの完全なリストは {{ic|rustup target list}} を実行することで確認できます。

例えば、gnu コンパイラを使って Windows 用にコンパイルする stable チャンネルの rust をインストールしたい場合、以下を実行:

{{bc|<nowiki>
$ rustup install stable-x86_64-pc-windows-gnu
</nowiki>}}

上記のコマンドでは、コンパイル先のアーキテクチャ用の rust とツールしかインストールされません。場合によってはクロスコンパイルするのに追加でツールが必要になる可能性があります。

=== Windows ===

このセクションでは、{{ic|$ARCH}} がターゲットのアーキテクチャです ({{ic|x86_64}} または {{ic|i686}})。

# {{AUR|mingw64-w64-gcc-base}}{{Broken package link|パッケージが存在しません}} と {{Pkg|mingw-w64-gcc}} と {{Pkg|wine}} を[[インストール]]。
# rustup を使っている場合、{{ic|rustup install stable-$ARCH-pc-windows-gnu}} と {{ic|rustup target add $ARCH-pc-windows-gnu}} を実行することで rust と標準ライブラリをインストールできます。rustup を使っていない場合、rustlib ディレクトリ ({{AUR|rust-nightly-bin}} を使用する場合は {{ic|/usr/local/lib/rustlib}}、公式の {{Pkg|rust}} パッケージを使用する場合は {{ic|/usr/lib/rustlib}}) に Windows 用の Rust の標準ライブラリのコピーをインストールします。一番簡単な方法は、ターゲットとするアーキテクチャの Windows 用の Rust インストーラーをダウンロードして、Wine を使ってインストール ({{ic|wine start my-rust-installer.msi}}) してから rustlib ディレクトリにコピー {{ic|$INSTALL_DIR/bin/rustlib/$ARCH-pc-windows-gnu}} する方法です。
# 最後に、cargo の設定ファイルに以下を追加して MinGW-w64 の gcc/ar のパスを cargo に指定します:
{{hc|~/.cargo/config|<nowiki>
[target.$ARCH-pc-windows-gnu]
linker = "/usr/bin/$ARCH-w64-mingw32-gcc"
ar = "/usr/$ARCH-w64-mingw32/bin/ar"
</nowiki>}}

cargo に {{ic|--target $ARCH-pc-windows-gnu}} と指定することで Windows 向けのクロスコンパイルができます:
{{bc|<nowiki>
$ # Build
$ cargo build --release --target "$ARCH-pc-windows-gnu"
$ # Run unit tests under wine
$ cargo test --target "$ARCH-pc-windows-gnu"
</nowiki>}}

=== 非公式パッケージ ===

[[非公式ユーザーリポジトリ#archlinuxcn|非公式の archlinuxcn リポジトリ]]には i686, ARM, ARMv7, Windows 32, Windows 64 向けの rust-nightly と Rust 標準ライブラリが含まれています。パッケージをインストールすればクロスコンパイルができます。ただし、ARM のツールチェインは自分で用意する必要があります。32ビット版の Windows を対象にビルドする場合、実行するのに {{ic|libgcc_s_dw2-1.dll}} が必要になります。

== Cargo ==

Rust のパッケージマネージャである [https://crates.io/ Cargo] は {{Pkg|rust}} パッケージに付属しています。ナイトリー版は AUR の {{AUR|cargo-nightly-bin}} でインストールできます。{{Pkg|rustup}} を使用している場合、Cargo は既にインストールされています。

Cargo は Rust プロジェクトの依存関係を宣言することができるようにするツールであり、それによってビルドがいつでも通ることが保証されます。

=== 使用方法 ===

Cargo を使って新しいプロジェクトを作成するには:
{{bc|$ cargo new hello_world --bin}}

{{Note|Cargo がプロジェクトをコンパイルするのに必要なメタデータを全て含めたマニフェストファイルである {{ic|Cargo.toml}} ファイルを Cargo は使用します:
{{hc|head=Cargo.toml|
output=[package]
name = "hello_world"
version = "0.1.0"
authors = ["Your Name <you@example.com>"]
}}
}}

=== sccache ===
[https://github.com/mozilla/sccache sccache] を使うと中間生成物をキャッシュすることで、前回のコンパイル時から変化しない部分の再コンパイル時間を省きます。{{Pkg|sccache}} パッケージで[[インストール]]できます。

Cargo で利用するには以下の方法があります。
{{ic|RUSTC_WRAPPER}} [[環境変数]]を設定することで一時的に sccache を利用できます:
RUSTC_WRAPPER=sccache cargo build

常に利用するようにするには、{{ic|~/.cargo/config}} に以下の設定を加えます:
{{hc|~/.cargo/config|<nowiki>
[build]
rustc-wrapper = "sccache"
</nowiki>}}

== IDE のサポート ==

=== ツール ===

==== Racer ====

[https://github.com/phildawes/racer Racer] 自動補完エンジンは Rust の自動補完が必要な際に現在最も優れている選択肢です。ただし、Racer を使うには Rust のソースコードのコピーをインストールする必要があります。入手する方法は複数存在します:
* rustup を使う: {{ic|rustup component add rust-src}}。
* AUR を使う: {{Aur|rust-src}}{{Broken package link|パッケージが存在しません}} または {{Aur|rust-nightly-src}}。AUR を使用する場合は {{ic|RUST_SRC_PATH}} 環境変数を設定してください。
ソースコードをインストールしたら、{{pkg|rust-racer}} パッケージをインストールするか、[[#Cargo|Cargo]] を使って Racer をインストールすることができます:

$ cargo install racer

==== Clippy ====

[https://github.com/Manishearth/rust-clippy Clippy] は Rust のナイトリービルドに存在するコンパイラプラグイン機能を利用して、様々なエラーや慣習的な警告を検出する文法チェックを行います。安定版の Rust コンパイラでコンパイルするときに clippy を使うことはできません。Clippy は cargo でインストールできます:

$ cargo install clippy

=== エディタ ===

{{Note|IDE やテキストエディタの対応状況については [https://areweideyet.com/ Are we (I)DE yet?] にも述べられています。}}

==== Atom ====

[[Atom]] はプラグインで Rust 言語をサポートします: [https://atom.io/packages/language-rust language-rust] と [https://atom.io/packages/linter-rust linter-rust]。

==== IntelliJ IDEA ====

[[IntelliJ IDEA]] には [https://github.com/intellij-rust/intellij-rust Rust プラグイン] が存在します。CLion でも同じプラグインが使えます。ツールチェインを設定するときは rustup を使ってソースをダウンロード ({{ic|rustup component add rust-src}}) して、ツールチェインのディレクトリとして {{ic|~/.rustup/toolchains/<your toolchain>/bin}} を選択してください。

==== Visual Studio Code ====

[[VSCode]] の Rust のサポートは [https://marketplace.visualstudio.com/items?itemName=kalitaalexey.vscode-rust Rust] 拡張をインストールすることで得られます。

==== Vim ====

[[Vim]] による Rust のサポートは公式の [https://github.com/rust-lang/rust.vim rust.vim] プラグインで得ることができます。

====Emacs====

Emacs の Rust サポートは公式の [https://github.com/rust-lang/rust-mode rust-mode] プラグインか {{AUR|emacs-rust-mode}}{{Broken package link|パッケージが存在しません}} パッケージで有効にできます。

==== Kate ====

Kate support for Rust is installed by default by the {{Pkg|kate}} package, but also requires extra configurations.
First, install the package {{Pkg|rust-racer}}
Second, get the Rust source:
* With rustup: {{ic|rustup component add rust-src}}
* or From the AUR: {{Aur|rust-src-git}} or {{Aur|rust-nightly-src}}, in this case you must set the {{ic|RUST_SRC_PATH}} environment var.
Third, configure Kate by clicking Settings -> Configure Kate, then navigate to Application -> Plugins, then tick the 'Rust code completion', then you will see Application -> Rust code completion in the left sidebar, navigation to it, and assign 'Rust source tree location' to {{ic|$HOME/.rustup/toolchains/stable-x86_64-unknown-linux-gnu/lib/rustlib/src/rust/src}}
if you install the Rust source with rustup.

== 参照 ==

* [http://rust-lang.org/ Rust プログラミング言語の公式ウェブサイト]
* [https://www.rust-lang.org/documentation.html Rust ドキュメント]
* [http://doc.rust-lang.org/stable/book/ 公式 Rust Book]
* [https://doc.rust-lang.org/std/ 標準ライブラリ API 索引]
* [http://rustbyexample.com/ 説明が付されているサンプル集]
* [https://github.com/ctjhoa/rust-learning Rust チュートリアルのページリスト]
* [https://crates.io/ Cargo で使用できるライブラリ (crate)]
* [https://this-week-in-rust.org/ 今週の Rust]
* [http://blog.rust-lang.org/ Rust プログラミング言語ブログ]
* [https://users.rust-lang.org/ Rust ユーザーフォーラム]
* [https://internals.rust-lang.org/ Rust Internals フォーラム]
* [https://rust.libhunt.com/ Awesome Rust: Rust ライブラリやリソースの精選集]
* [[Wikipedia:ja:Rust (プログラミング言語)|Wikipedia の記事]]

利用者:R6eve

2021-08-04T21:32:26Z

R6eve: 内容を「Neat」で置換

Neat

利用者:R6eve

2020-06-25T06:17:54Z

R6eve:

Neat

* GitHub - https://github.com/r6eve/
* E-Mail - (λx.r6eve179fxgmail.com)@

利用者:R6eve

2019-04-08T05:39:21Z

R6eve:

ニート

* GitHub - https://github.com/r6eve/
* E-Mail - (λx.r6eve179fxgmail.com)@

WeeChat

2019-01-29T07:30:16Z

R6eve: サーバーに接続セクションを翻訳

[[Category:Internet Relay Chat]]
[[en:WeeChat]]
{{Related articles start}}
{{Related|IRC チャンネル}}
{{Related|irssi}}
{{Related|HexChat}}
{{Related articles end}}
'''WeeChat''' は高い拡張性を誇る機能豊富な IRC クライアントです。現在も活発に開発されています。

== インストール ==

[[公式リポジトリ]]から {{Pkg|weechat}} を[[インストール]]してください。開発版は [[AUR]] の {{AUR|weechat-git}} でインストールできます。

== 実行 ==

WeeChat は複数のインターフェイスを備えられるようになっています。'''weechat-[interface]''' を実行して WeeChat を起動してください。

現在のところ WeeChat には Ncurses インターフェイスしかありません。WeeChat の起動コマンドは:

$ weechat

== 設定 ==

WeeChat を設定する方法は3つあります: WeeChat の内部コマンドを使用する; '''iset''' を使用する; もしくは .conf ファイルを直接編集する。WeeChat は終了時や {{ic|/save}} の実行時に自動的に設定を保存するため、エディタで .conf ファイルを編集したら、終了する前にコンソールから {{ic|/reload}} を実行するようにしてください。そうしないと、編集したところが元に戻ってしまいます。

=== 内部コマンド ===

{{ic|/set}} コマンドは次の構造に従います:
{{ic|/set.[file.name].[section].[directive]}}

'''weechat'''のバッファ・ウィンドウにて {{ic|/set}} と打つことですべての設定可能オプションの一覧を得られます。デフォルトの設定可能オプションは約600個もあるので、ワイルドカードを使って検索するのがおすすめです: {{ic|/set irc.server.*}} や {{ic|/set *server*}} のように使えます。{{ic|/help}} コマンドを使ってオプション毎にヘルプを得ることもできます。

/help irc.server.freenode.autoconnect

=== 内部メニュー ===

より便利にするには、'''iset''' スクリプトをインストールしてください。weechat 0.3.9 の場合は次を実行します:

/script install iset.pl

それより古いバージョンなら、{{ic|/weeget install iset}} を使うか、[http://www.weechat.org/scripts/source/stable/iset.pl.html/ iset.pl] を {{ic|~/.weechat/perl/autoload}} へ直接ダウンロードしてください。

インストールが完了したら、次を実行します。

/iset

すべての設定オプションが表示されたバッファを得られます。

=== 設定ファイル ===

WeeChat の .conf ファイルは {{ic|~/.weechat}} に保存されています。ファイルにコメントは付いていません。詳しい説明はプログラムの内部コマンドを使うか、WeeChat の [http://www.weechat.org/files/doc/stable/weechat_user.en.html ユーザーガイド] を見て下さい。

{{Tip|{{ic|.weechat}} ディレクトリを別の場所（''$XDG_CONFIG_HOME'' のような）に指定したい場合は、次のオプションを使ってください : {{ic|$weechat -d $XDG_CONFIG_HOME/weechat}}}}

== サーバーに接続 ==

{{Note| 1.1+ [https://weechat.org/files/releasenotes/ReleaseNotes-devel.html#_temporary_servers_disabled_by_default_with_connect Release Note] では '''/connect''' による一時的なサーバへの接続はデフォルトで無効にされています。

'''/set irc.look.temporary_servers on''' で有効にできます。

}}

'''/connect''' を使うことでIRCサーバへ接続できます。

/connect chat.freenode.net

また、'''Server''' の設定が済んでるなら次でもできます:

/connect freenode

== サーバープロファイルの作成 ==

If you plan on connecting to a server more than once it may be beneficial to create a '''Server'''.

/server add example irc.example.net/6667

Would create the server '''example''' which would connect to '''irc.example.net''' on port '''6667'''

See the WeeChat documentation and '''/help server''' for more information.

== SSL の設定 ==

Many IRC servers, including [https://freenode.net/ freenode] where [[IRC チャンネル|#archlinux]] is, support SSL.

If you're making a server with '''/server''', add the SSL port (usually 6697) and '''-ssl''' to the end of the line. For example:

/server add freenode chat.freenode.net/6697 -ssl

You can do the same thing if using '''/connect'''.

/connect chat.freenode.net/6697 -ssl

{{Warning|Some servers need the '''ssl_dhkey_size''' value changed to something lower. For example, if you're using freenode you'll need to set '''/set irc.server.freenode.ssl_dhkey_size 1024''' or '''/set irc.server.chat.freenode.net.ssl_dhkey_size 1024''' (see the server log)}}

{{Note|Different servers may have a different port than 6697 - this is server specific.}}

You may also want to change the location where WeeChat looks for trusted authorities (the default value is {{ic|%h/ssl/CAs.pem}} which translates to {{ic|~/.weechat/ssl/CAs.pem)}}:

/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"

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

=== アップグレード ===

WeeChat can be upgraded without disconnecting from the IRC servers (non-SSL connections only):

/upgrade

This will load the new WeeChat binary and reload the current configuration.

=== エイリアス ===

Aliases can be created to simplify commonly executed commands. A nice example is Wraithan's '''smart filter''' alias:

'''Smart Filter'''

First, we need to enable smart filters:

/set irc.look.smart_filter "on"

Next, we will create the '''sfilter''' alias:

/alias sfilter filter add irc_smart_$server_$channel irc.$server.$channel irc_smart_filter *

We can now type

/sfilter

in any buffer, and the smart filter will only be enabled for that buffer.

The following alias will remove a previously enabled smart filter in the current buffer. Add the alias:

/alias rmsfilter filter del irc_smart_$server_$channel

and execute it by

/rmsfilter

=== Exec コマンド ===
A new plugin called "exec" has been added, with command {{ic|/exec}}. It will execute external command and can display output to the current buffer with the '''-o''' option or locally (default).

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

Some helpful bindings:

To use ctrl-left/right arrow keys to jump to next/previous words on the input line:

/key bind meta2-1;5D /input move_previous_word
/key bind meta2-1;5C /input move_next_word

=== アイドル時に SSH の接続が切れる ===

If you're connecting to your WeeChat through a remote shell using SSH, for example running it in [[screen]] or [[tmux]] you might experience getting disconnected after a while when idle. There are multiple factors in play why this might happen, but the easiest way to change this is to force the connection to be kept alive by appending this to your SSH-configuration on the remote shell.

This has nothing to do with WeeChat itself, but losing connection when idle won't happen with it's alternative [[irssi]] by default, and thus is a common situation for those converting to WeeChat.

{{hc|# /etc/ssh/sshd_config|2=
ClientAliveInterval 300}}

Or have a look at [http://mosh.mit.edu/ Mosh].

=== Slack IRC ゲートウェイ ===

[https://slack.com/ Slack] is a platform for team communication, a IRC on steroïd. Thanks to its open API, it is possible to connect to your slack team using weechat.

Once weechat is running, all you have to is add a new server this way:

{{ic|<nowiki>/server add NAME HOST/6667 -autoconnect -ssl -ssl_dhkey_size=512 -password=PASSWORD -username=USERNAME -nicks=NICK</nowiki>}}

where:

* '''NAME''' is the name you want to give to the server
* '''HOST''' is the the Host as provided on the Gateways page of your slack team
* '''PASSWORD''' is the Pass as provided on the Gateways page of your slack team
* '''USERNAME''' is the User as provided on the Gateways page of your slack team
* '''NICK''' is your Slack username.

==== ファイルのアップロード ====

To upload a file, run this following command from your shell :

{{ic|<nowiki>curl -F file=@/path/to/file -F channels=CHAN -F token=XXX https://slack.com/api/files.upload</nowiki>}}

where:

* '''CHAN''' is the channel ID as provided on the Gateways page of your slack team
* '''XXX''' is the team token as provided on the Gateways page of your slack team

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

=== プラグインのロードエラー ===

You may see output like the following in the main window after starting '''weechat''':

12:29:37 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/'''tcl.so'''": libtcl8.6.so: cannot open shared object file: No such file or directory
12:29:37 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
12:29:37 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/'''ruby.so'''": libruby.so.2.0: cannot open shared object file: No such file or directory
12:29:37 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
12:29:37 | Plugins loaded: alias, aspell, charset, fifo, guile, irc, logger, lua, perl, python, relay, rmodifier, script, xfer

The default configuration for weechat attempts to load all plugins found in /usr/lib/weechat/plugins which in this case includes both tcl and ruby. These packages are not required by the weechat package and may not be installed on your machine. There are two options if these errors bother you:

# [[公式リポジトリ]]から {{Pkg|tcl}}, {{Pkg|ruby}} を[[インストール]]。
# Or, run {{ic|/set weechat.plugin.autoload "*,!tcl,!ruby"}} which will prevent loading those plugins with a bang (!) prefix.

== ヘルプの表示 ==

To access WeeChat's built-in help, simply type

/help

and the help will be displayed in the main buffer (usually buffer 1).

== 参照 ==

* [http://www.weechat.org Home Page]
* [http://www.weechat.org/doc/ WeeChat Documentation]
* [http://www.weechat.org/scripts/ WeeChat Scripts]
* [http://dev.weechat.org/ WeeChat Development Blog]

=== ガイド ===

* [http://fixato.org/guides/setting_up_weechat.html FiXato's guide to WeeChat]
* [http://pascalpoitras.com/2013/06/29/weechat-my-favorites-scripts/ Pascalpoitras: Favorite scripts]
* [http://pascalpoitras.com/ Pascalpoitras Weechat Tips]
* [http://robots.thoughtbot.com/weechat-for-slacks-irc-gateway Thoughbot article on weechat and slack]

WeeChat

2019-01-28T05:58:23Z

R6eve: 設定セクションを翻訳

[[Category:Internet Relay Chat]]
[[en:WeeChat]]
{{Related articles start}}
{{Related|IRC チャンネル}}
{{Related|irssi}}
{{Related|HexChat}}
{{Related articles end}}
'''WeeChat''' は高い拡張性を誇る機能豊富な IRC クライアントです。現在も活発に開発されています。

== インストール ==

[[公式リポジトリ]]から {{Pkg|weechat}} を[[インストール]]してください。開発版は [[AUR]] の {{AUR|weechat-git}} でインストールできます。

== 実行 ==

WeeChat は複数のインターフェイスを備えられるようになっています。'''weechat-[interface]''' を実行して WeeChat を起動してください。

現在のところ WeeChat には Ncurses インターフェイスしかありません。WeeChat の起動コマンドは:

$ weechat

== 設定 ==

WeeChat を設定する方法は3つあります: WeeChat の内部コマンドを使用する; '''iset''' を使用する; もしくは .conf ファイルを直接編集する。WeeChat は終了時や {{ic|/save}} の実行時に自動的に設定を保存するため、エディタで .conf ファイルを編集したら、終了する前にコンソールから {{ic|/reload}} を実行するようにしてください。そうしないと、編集したところが元に戻ってしまいます。

=== 内部コマンド ===

{{ic|/set}} コマンドは次の構造に従います:
{{ic|/set.[file.name].[section].[directive]}}

'''weechat'''のバッファ・ウィンドウにて {{ic|/set}} と打つことですべての設定可能オプションの一覧を得られます。デフォルトの設定可能オプションは約600個もあるので、ワイルドカードを使って検索するのがおすすめです: {{ic|/set irc.server.*}} や {{ic|/set *server*}} のように使えます。{{ic|/help}} コマンドを使ってオプション毎にヘルプを得ることもできます。

/help irc.server.freenode.autoconnect

=== 内部メニュー ===

より便利にするには、'''iset''' スクリプトをインストールしてください。weechat 0.3.9 の場合は次を実行します:

/script install iset.pl

それより古いバージョンなら、{{ic|/weeget install iset}} を使うか、[http://www.weechat.org/scripts/source/stable/iset.pl.html/ iset.pl] を {{ic|~/.weechat/perl/autoload}} へ直接ダウンロードしてください。

インストールが完了したら、次を実行します。

/iset

すべての設定オプションが表示されたバッファを得られます。

=== 設定ファイル ===

WeeChat の .conf ファイルは {{ic|~/.weechat}} に保存されています。ファイルにコメントは付いていません。詳しい説明はプログラムの内部コマンドを使うか、WeeChat の [http://www.weechat.org/files/doc/stable/weechat_user.en.html ユーザーガイド] を見て下さい。

{{Tip|{{ic|.weechat}} ディレクトリを別の場所（''$XDG_CONFIG_HOME'' のような）に指定したい場合は、次のオプションを使ってください : {{ic|$weechat -d $XDG_CONFIG_HOME/weechat}}}}

== サーバーに接続 ==

{{Note| Using '''/connect''' to connect to a temporary server is disabled by default if you're using 1.1+ [https://weechat.org/files/releasenotes/ReleaseNotes-devel.html#_temporary_servers_disabled_by_default_with_connect Release Note]

Enable by '''/set irc.look.temporary_servers on'''

}}

You can connect to a IRC server by using '''/connect'''.

/connect chat.freenode.net

Or if there is already a '''Server''' setup you can use:

/connect freenode

== サーバープロファイルの作成 ==

If you plan on connecting to a server more than once it may be beneficial to create a '''Server'''.

/server add example irc.example.net/6667

Would create the server '''example''' which would connect to '''irc.example.net''' on port '''6667'''

See the WeeChat documentation and '''/help server''' for more information.

== SSL の設定 ==

Many IRC servers, including [https://freenode.net/ freenode] where [[IRC チャンネル|#archlinux]] is, support SSL.

If you're making a server with '''/server''', add the SSL port (usually 6697) and '''-ssl''' to the end of the line. For example:

/server add freenode chat.freenode.net/6697 -ssl

You can do the same thing if using '''/connect'''.

/connect chat.freenode.net/6697 -ssl

{{Warning|Some servers need the '''ssl_dhkey_size''' value changed to something lower. For example, if you're using freenode you'll need to set '''/set irc.server.freenode.ssl_dhkey_size 1024''' or '''/set irc.server.chat.freenode.net.ssl_dhkey_size 1024''' (see the server log)}}

{{Note|Different servers may have a different port than 6697 - this is server specific.}}

You may also want to change the location where WeeChat looks for trusted authorities (the default value is {{ic|%h/ssl/CAs.pem}} which translates to {{ic|~/.weechat/ssl/CAs.pem)}}:

/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"

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

=== アップグレード ===

WeeChat can be upgraded without disconnecting from the IRC servers (non-SSL connections only):

/upgrade

This will load the new WeeChat binary and reload the current configuration.

=== エイリアス ===

Aliases can be created to simplify commonly executed commands. A nice example is Wraithan's '''smart filter''' alias:

'''Smart Filter'''

First, we need to enable smart filters:

/set irc.look.smart_filter "on"

Next, we will create the '''sfilter''' alias:

/alias sfilter filter add irc_smart_$server_$channel irc.$server.$channel irc_smart_filter *

We can now type

/sfilter

in any buffer, and the smart filter will only be enabled for that buffer.

The following alias will remove a previously enabled smart filter in the current buffer. Add the alias:

/alias rmsfilter filter del irc_smart_$server_$channel

and execute it by

/rmsfilter

=== Exec コマンド ===
A new plugin called "exec" has been added, with command {{ic|/exec}}. It will execute external command and can display output to the current buffer with the '''-o''' option or locally (default).

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

Some helpful bindings:

To use ctrl-left/right arrow keys to jump to next/previous words on the input line:

/key bind meta2-1;5D /input move_previous_word
/key bind meta2-1;5C /input move_next_word

=== アイドル時に SSH の接続が切れる ===

If you're connecting to your WeeChat through a remote shell using SSH, for example running it in [[screen]] or [[tmux]] you might experience getting disconnected after a while when idle. There are multiple factors in play why this might happen, but the easiest way to change this is to force the connection to be kept alive by appending this to your SSH-configuration on the remote shell.

This has nothing to do with WeeChat itself, but losing connection when idle won't happen with it's alternative [[irssi]] by default, and thus is a common situation for those converting to WeeChat.

{{hc|# /etc/ssh/sshd_config|2=
ClientAliveInterval 300}}

Or have a look at [http://mosh.mit.edu/ Mosh].

=== Slack IRC ゲートウェイ ===

[https://slack.com/ Slack] is a platform for team communication, a IRC on steroïd. Thanks to its open API, it is possible to connect to your slack team using weechat.

Once weechat is running, all you have to is add a new server this way:

{{ic|<nowiki>/server add NAME HOST/6667 -autoconnect -ssl -ssl_dhkey_size=512 -password=PASSWORD -username=USERNAME -nicks=NICK</nowiki>}}

where:

* '''NAME''' is the name you want to give to the server
* '''HOST''' is the the Host as provided on the Gateways page of your slack team
* '''PASSWORD''' is the Pass as provided on the Gateways page of your slack team
* '''USERNAME''' is the User as provided on the Gateways page of your slack team
* '''NICK''' is your Slack username.

==== ファイルのアップロード ====

To upload a file, run this following command from your shell :

{{ic|<nowiki>curl -F file=@/path/to/file -F channels=CHAN -F token=XXX https://slack.com/api/files.upload</nowiki>}}

where:

* '''CHAN''' is the channel ID as provided on the Gateways page of your slack team
* '''XXX''' is the team token as provided on the Gateways page of your slack team

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

=== プラグインのロードエラー ===

You may see output like the following in the main window after starting '''weechat''':

12:29:37 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/'''tcl.so'''": libtcl8.6.so: cannot open shared object file: No such file or directory
12:29:37 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
12:29:37 =!= | Error: unable to load plugin "/usr/lib/weechat/plugins/'''ruby.so'''": libruby.so.2.0: cannot open shared object file: No such file or directory
12:29:37 =!= | If you're trying to load a script and not a C plugin, try command to load scripts (/perl, /python, ...)
12:29:37 | Plugins loaded: alias, aspell, charset, fifo, guile, irc, logger, lua, perl, python, relay, rmodifier, script, xfer

The default configuration for weechat attempts to load all plugins found in /usr/lib/weechat/plugins which in this case includes both tcl and ruby. These packages are not required by the weechat package and may not be installed on your machine. There are two options if these errors bother you:

# [[公式リポジトリ]]から {{Pkg|tcl}}, {{Pkg|ruby}} を[[インストール]]。
# Or, run {{ic|/set weechat.plugin.autoload "*,!tcl,!ruby"}} which will prevent loading those plugins with a bang (!) prefix.

== ヘルプの表示 ==

To access WeeChat's built-in help, simply type

/help

and the help will be displayed in the main buffer (usually buffer 1).

== 参照 ==

* [http://www.weechat.org Home Page]
* [http://www.weechat.org/doc/ WeeChat Documentation]
* [http://www.weechat.org/scripts/ WeeChat Scripts]
* [http://dev.weechat.org/ WeeChat Development Blog]

=== ガイド ===

* [http://fixato.org/guides/setting_up_weechat.html FiXato's guide to WeeChat]
* [http://pascalpoitras.com/2013/06/29/weechat-my-favorites-scripts/ Pascalpoitras: Favorite scripts]
* [http://pascalpoitras.com/ Pascalpoitras Weechat Tips]
* [http://robots.thoughtbot.com/weechat-for-slacks-irc-gateway Thoughbot article on weechat and slack]

NFS

2019-01-09T04:29:15Z

R6eve: マイナーな誤字の修正

[[Category:ファイルシステム]]
[[Category:ネットワーク共有]]
[[ar:NFS]]
[[cs:NFS]]
[[de:Network File System]]
[[en:NFS]]
[[es:NFS]]
[[fr:NFS]]
[[it:NFS]]
[[ru:NFS]]
[[zh-hans:NFS]]
{{Related articles start}}
{{Related|NFS/トラブルシューティング}}
{{Related|Avahi}}
{{Related|ディスクレスシステム}}
{{Related articles end}}
[[Wikipedia:ja:Network File System|Wikipedia]] より:
: ''Network File System (NFS) はローカルストレージにアクセスするのと同じようにネットワーク上のファイルにクライアントコンピュータでアクセスできるようにする分散ファイルシステムおよびそのプロトコルである。1984年に Sun Microsystems によって開発された。''

{{Note|
*NFS は暗号化されません。機密情報を扱うときは [[Kerberos]] や [[Tinc]] などの暗号化プロトコルを使って NFS をトンネル化してください。
*[[Samba]] とは異なり、NFS にはデフォルトでユーザー認証がありません。クライアントのアクセスは IP アドレスや[[ホストネーム]]で制限します。
}}

== インストール ==

クライアントとサーバーどちらでも必要なのは {{Pkg|nfs-utils}} パッケージの[[pacman|インストール]]だけです。

{{Note|クライアント・サーバーの時計を一致させるために全てのノードで時刻同期デーモンを使うことが強く推奨されます。全てのノードで時計が正確でないと、NFS は望ましくない遅延を生じさせる可能性があります。[[Network Time Protocol daemon|NTP]] システムを使ってサーバーとクライアントの両方をインターネット上の正確な NTP サーバーに同期させることが推奨されています。}}

==設定==

===サーバー===

NFS サーバーにはエクスポート (共有ディレクトリ) のリストが必要で、{{ic|/etc/exports}} に定義します。{{ic|/etc/exports}} に定義する NFS 共有はいわゆる NFS ルートからの相対パスになります。セキュリティ上、NFS ルートを定義するときはサーバーのルートファイルシステム下の専用のディレクトリツリーを使用して、ユーザーからマウントポイントへのアクセスを制限すると良いでしょう。バインドマウントを使用して共有マウントポイントから実際のファイルシステム上のディレクトリにリンクします。

下の例では以下の設定を使用します:
# NFS ルートは {{ic|/srv/nfs}}。
# エクスポートは {{ic|/srv/nfs/music}} で {{ic|/mnt/music}} にバインドマウントする。

# mkdir -p /srv/nfs/music /mnt/music
# mount --bind /mnt/music /srv/nfs/music

サーバーを再起動してもマウントされるように、バインドマウントを [[fstab]] に追加:

{{hc|/etc/fstab|/mnt/music /srv/nfs/music none bind 0 0}}

{{Note|
* NFS にはサーバーのファイルシステムのパーミッションが適用されるため、接続するユーザーに適当な権限があることを確認してください。
* [[ZFS]] ファイルシステムの場合、バインドマウントの使い方が特殊です。[[ZFS#バインドマウント]]を見てください。}}

CIDR によるアドレス指定またはホストネームを使ってマウントを許可するクライアントマシンを制限するには {{ic|/etc/exports}} に以下のように共有ディレクトリを追加:

{{hc|/etc/exports|<nowiki>
/srv/nfs 192.168.1.0/24(rw,fsid=root,crossmnt)
/srv/nfs/music 192.168.1.0/24(rw) # Use whatever export options you see fit
</nowiki>}}

サーバー実行中に {{ic|/etc/exports}} を変更した場合は再度エクスポートしないと変更が適用されないので注意してください:
# exportfs -rav

利用可能なオプションについて詳しくは {{man|5|exports}} を参照してください。
{{Tip|IP の範囲を CIDR 表記に変換するツールとして [http://ip2cidr.com/ ip2cidr] が存在します。}}
{{Note|エクスポート先が tmpfs ファイルシステムの場合、{{ic|1=fsid=1}} オプションが必要です。}}

==== サーバーを起動する ====

{{ic|nfs-server.service}} を[[起動]]・[[有効化]]してください。

==== その他 ====

===== 任意のサーバー設定 =====

高度な設定オプションは {{ic|/etc/nfs.conf}} で設定できます。単純な構成の場合はファイルを編集する必要はありません。

===== 特定のインターフェイスあるいは IP からのアクセスに NFS を制限 =====

デフォルトでは {{ic|nfs-server.service}} を起動すると {{ic|/etc/exports}} とは関係なく全てのネットワークインターフェイスから接続を待機します。待機する IP あるいはホストネームを定義することで挙動を変更できます:

{{hc|/etc/nfs.conf|2=
[nfsd]
host=192.168.1.123
# Alternatively, you can use your hostname.
# host=myhostname
}}

変更を適用するには {{ic|nfs-server.service}} を[[再起動]]してください。

===== NFSv4 の ID マッピングが有効になっていることを確認 =====

idmapd が動作していても、マッピングが完全には有効になっていないことがあります。{{ic|/sys/module/nfsd/parameters/nfs4_disable_idmapping}} が {{ic|N}} になっている場合、以下のコマンドを実行することで有効にできます:

# echo "N" | sudo tee /sys/module/nfsd/parameters/nfs4_disable_idmapping

変更を永続化するには[[カーネルモジュール#モジュールオプションを設定する|モジュールオプション]]で設定してください:

{{hc|/etc/modprobe.d/nfsd.conf|<nowiki>
options nfsd nfs4_disable_idmapping=0
</nowiki>}}

===== NFSv3 の固定ポート =====
NFSv3 クライアントのサポートが必要な場合、固定ポートを使うのが良いでしょう。デフォルトでは NFSv3 による {{ic|rpc.statd}} や {{ic|lockd}} の制御にはランダムな一時ポートが使われます。ファイアウォールを通して NFSv3 の制御ができるようにするには固定ポートを定義する必要があります。{{ic|/etc/sysconfig/nfs}} を編集して {{ic|STATDARGS}} を設定してください:

{{hc|/etc/sysconfig/nfs|2=
STATDARGS="-p 32765 -o 32766 -T 32803"
}}

{{ic|rpc.mountd}} は {{ic|/etc/services}} を読み込んで通常の状態では同じ固定ポート 2048 に bind されます。しかしながら、明示的に定義する必要があるときは {{ic|/etc/sysconfig/nfs}} を編集して {{ic|RPCMOUNTDARGS}} を設定してください:

{{hc|/etc/sysconfig/nfs|2=
RPCMOUNTDARGS="-p 20048"
}}

上記の変更を加えたら、複数のサービスを再起動してください。最初に設定オプションを {{ic|/run/sysconfig/nfs-utils}} (参照: {{ic|/usr/lib/systemd/scripts/nfs-utils_env.sh}}) に書き出して、二番目に新しいポートで {{ic|rpc.statd}} を再起動し、最後に新しいポートで {{ic|lockd}} (カーネルモジュール) をリロードします。次のサービスを[[再起動]]してください: {{ic|nfs-config}}, {{ic|rpcbind}}, {{ic|rpc-statd}}, {{ic|nfs-server}}。

再起動後、サーバーで {{ic|rpcinfo -p}} を使って固定ポートが思い通りにいってるか確認してください。クライアントから {{ic|rpcinfo -p <server IP>}} を使えば本当に同じ固定ポートを使っているか明らかになります。

===== NFSv2 との互換性 =====

NFSv2 を使用するクライアント (例えば U-Boot) のサポートが必要な場合、{{ic|/etc/sysconfig/nfs}} に {{ic|1=RPCNFSDARGS="-V 2"}} を設定してください。

===== ファイアウォール設定 =====

ファイアウォールを通過してアクセスできるようにするには、デフォルト設定の場合 tcp と udp のポート 111, 2049, 20048 を開放する必要があります。{{ic|rpcinfo -p}} を使ってサーバーで使用しているポートを確認してください。この設定を [[iptables]] でするには、{{ic|/etc/iptables/iptables.rules}} を編集して以下の行を含めるようにしてください:

{{hc|/etc/iptables/iptables.rules|<nowiki>
-A INPUT -p tcp -m tcp --dport 111 -j ACCEPT
-A INPUT -p tcp -m tcp --dport 2049 -j ACCEPT
-A INPUT -p tcp -m tcp --dport 20048 -j ACCEPT
-A INPUT -p udp -m udp --dport 111 -j ACCEPT
-A INPUT -p udp -m udp --dport 2049 -j ACCEPT
-A INPUT -p udp -m udp --dport 20048 -j ACCEPT
</nowiki>}}

NFSv3 と、上記の {{ic|rpc.statd}} や {{ic|lockd}} の固定ポートを使用している場合は、それらも設定に追加してください:

{{hc|/etc/iptables/iptables.rules|<nowiki>
-A INPUT -p tcp -m tcp --dport 32765 -j ACCEPT
-A INPUT -p tcp -m tcp --dport 32803 -j ACCEPT
-A INPUT -p udp -m udp --dport 32765 -j ACCEPT
-A INPUT -p udp -m udp --dport 32803 -j ACCEPT
</nowiki>}}

v4 以上だけを使う構成の場合、開く必要があるのは tcp ポート 2049 だけです。したがって、必要な行は一行だけになります:

{{hc|/etc/iptables/iptables.rules|<nowiki>
-A INPUT -p tcp -m tcp --dport 2049 -j ACCEPT
</nowiki>}}

変更を適用するために、{{ic|iptables}} サービスを再起動してください。

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

NFSv4 で [[Kerberos]] を使用する場合、{{ic|nfs-client.target}} も[[起動]]・[[有効化]]する必要があります。{{ic|rpc-gssd.service}} が起動します。しかしながら、glibc のバグ ({{Bug|50663}}) が原因で、現在 {{ic|rpc-gssd.service}} は起動に失敗します。サービスに "-f" (foreground) フラグを追加することで起動できます:

{{hc|# systemctl edit rpc-gssd.service|2=
[Unit]
Requires=network-online.target
After=network-online.target

[Service]
Type=simple
ExecStart=
ExecStart=/usr/sbin/rpc.gssd -f
}}

==== Linux からマウントする ====

NFSv3 の場合、次のコマンドを使ってサーバーのエクスポートされたファイルシステムを表示:
$ showmount -e servername

NFSv4 の場合、root NFS ディレクトリをマウントして利用できるマウントを確認:
# mount server:/ /mountpoint/on/client

そしてサーバーの NFS エクスポートルートは省略してマウント:
# mount -t nfs -o vers=4 servername:/music /mountpoint/on/client

マウントが失敗する場合はサーバーのエクスポートルートを含めて見て下さい (Debian/RHEL/SLES では必須、ディストリビューションによっては {{ic|-t nfs}} ではなく {{ic|-t nfs4}}):
# mount -t nfs -o vers=4 servername:/srv/nfs/music /mountpoint/on/client

{{Note|サーバーの名前は (IP アドレスではなく) ホストネームを指定する必要があります。それ以外だとリモート共有がハングアップします。}}

===== /etc/fstab を使う =====

クライアントを立ち上げたときにいつでも NFS 共有が使えるように、常に稼働させているサーバーでは [[fstab]] を利用すると便利です。{{ic|/etc/fstab}} ファイルを編集して、設定に合わせて適切な行を追加してください。また、サーバーの NFS エクスポートルートは省略します。

{{hc|/etc/fstab|<nowiki>
servername:/music /mountpoint/on/client nfs rsize=8192,wsize=8192,timeo=14,_netdev 0 0
</nowiki>}}

{{Note|マウントオプションについては {{man|5|nfs}} や {{man|8|mount}} を参照してください。}}

マウントオプションの説明は以下の通り:

; rsize と wsize: {{ic|rsize}} はサーバーから読み込むときに使用されるバイト数の値です。{{ic|wsize}} はサーバーに書き込むときのバイト数の値です。どちらもデフォルトは 1024 ですが、8192 などと値を高く設定することでスループットを改善できます。この値は汎用ではありません。値を変更した後にテストを行うことを推奨します、[[#パフォーマンスチューニング]]を見てください。

; timeo: {{ic|timeo}} は RPC タイムアウトの後に再送信を行うまで待機する時間の値です (10分の1秒単位)。最初にタイムアウトした後、再試行する度にタイムアウトの値は2倍になっていき、最大60秒になるか正式なタイムアウトになります。遅いサーバーやトラフィックの多いネットワークに接続する場合、このタイムアウトの値を増やすことでパフォーマンスが改善されるかもしれません。

; _netdev: {{ic|_netdev}} オプションは共有をマウントする前にネットワークが立ち上がるまで待機するようシステムに通知するオプションです。systemd は NFS がこのオプションを使うことを想定していますが、どんな形式のネットワークファイルシステムであれ、このオプションを使うことはグッドプラクティスと言えます。

; minorversion: NFS バージョン 4.1 の Windows Server 2012 (Essentials) の共有をマウントするときは {{ic| <nowiki>minorversion=1</nowiki>}} を使います。

{{Note|6番目のフィールド ({{ic|fs_passno}}) をゼロ以外の値に設定すると予期しない挙動が発生することがあります。例えば systemd で自動マウントしたときにチェックの待機が行われなくなります。}}

===== systemd で /etc/fstab を使う =====

systemd の {{ic|automount}} サービスを使う方法もあります。接続が遮断されたり、復帰した時に素早くネットワークデバイスを再マウントするため、{{ic|_netdev}} よりも好ましいと思われます。さらに、autofs の問題も解決します、下の例を見て下さい:

{{hc|1=/etc/fstab|2=
servername:/home ''/mountpoint/on/client'' nfs noauto,x-systemd.automount,x-systemd.device-timeout=10,timeo=14,x-systemd.idle-timeout=1min 0 0
}}

systemd が fstab の変更に気づくようにクライアントを再起動する必要があります。もしくは、systemd を[[Systemd#ユニットを使う|リロード]]して {{ic|''mountpoint-on-client''.automount}} を再起動して {{ic|/etc/fstab}} の設定を再読み込みしてください。

{{Tip|
* 上記の {{ic|noauto}} はアクセスされるまで NFS 共有をマウントしません: いますぐに利用できるようにしたいときは {{ic|auto}} を使って下さい。<br>ネットワークが立ち上がってなかったり利用できないことが理由でマウントが失敗する問題が発生するときは、{{ic|NetworkManager-wait-online.service}} を [[systemd#ユニットを使う|有効]]にします: このサービスは有効化される前に {{ic|network.target}} の全てのリンクが利用可能になることを保証します。
* {{ic|users}} マウントオプションはユーザーによるマウントを許可しますが、{{ic|noexec}} などのオプションも含まれているので注意してください。
* {{ic|<nowiki>x-systemd.idle-timeout=1min</nowiki>}} オプションは NFS 共有が1分間使われなかったときに自動的にアンマウントします。ネットワークから突然切断する可能性があるノートパソコンなどで有用です。
* NFS のせいでシャットダウンや再起動に時間がかかってしまうときは、{{ic|NetworkManager-wait-online.service}} を[[有効化]]して NFS ボリュームがアンマウントされる前に NetworkManager が終了しないようにしてください。それでもシャットダウンが長すぎる場合 {{ic|<nowiki>x-systemd.requires=network.target</nowiki>}} マウントオプションを追加してみてください。
}}

{{Note|サーバーでも同じ方法で systemd で NFS 共有を自動マウントすると、データの量が多かった場合にフリーズする可能性があります。}}

===== autofs を使う =====

複数のマシンを NFS で接続したい場合は [[autofs]] を使うのが便利です。サーバーだけでなくクライアントにもなることができます。他の簡単な方法よりもこの方法が推奨される理由は、サーバーの電源が落とされた時に、クライアントがNFS 共有を見つけられないことについてエラーを投げないからです。詳しくは [[autofs#NFS ネットワークマウント]] を見て下さい。

==== Windows からマウントする ====

{{Note|"Client for NFS" が含まれているのは Windows 7 の Ultimate と Enterprise エディションや Windows 8 の Enterprise エディションだけです。}}
"Client for NFS" サービスが有効になっていれば Windows から NFS 共有をマウントできます (デフォルトでは有効になっていません)。
サービスをインストールするにはコントロールパネルの "Programs and features" から "Turn Windows features on or off" をクリックしてください。"Services for NFS" と副サービス ("Administrative tools" と "Client for NFS") を両方有効にします。

"Services for Network File System" (検索ボックスで探して下さい) を開いて ''client > properties'' を右クリックすることでグローバルオプションを設定できます。

{{Warning|パフォーマンスに深刻な問題が発生することがありますが (ギガビット LAN でもフォルダを表示するのに30から60秒ほどかかったり、ファイルのコピー速度が 2 MB/s になったりします)、Microsoft はまだ解決方法を用意できていません [https://social.technet.microsoft.com/Forums/en-CA/w7itpronetworking/thread/40cc01e3-65e4-4bb6-855e-cef1364a60ac]。}}

エクスプローラーを使って共有をマウントするには:

{{ic|Computer}} > {{ic|Map network drive}} > {{ic|servername:/srv/nfs4/music}}

==== OS X からマウントする ====

{{Note|OS X はデフォルトでセキュアでない (>1024) ポートを使って共有をマウントしません。}}
{{ic|insecure}} フラグを使って共有をエクスポートし、Finder でマウントする:

{{ic|Go}} > {{ic|Connect to Server}} > {{ic|nfs://servername/}}

またはターミナルでセキュアなポートを使って共有をマウント:
# mount -t nfs -o resvport,nolocks,locallocks servername:/srv/nfs4 /Volumes/servername

{{ic|nolocks}} と {{ic|locallocks}} オプションを使う理由については [https://web.archive.org/web/20151212160906/https://blogs.oracle.com/jag/entry/nfs_on_snow_leopard NFS on Snow Leopard] を見てください。

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

=== パフォーマンスチューニング ===

NFS の性能を完全に発揮するには、ネットワーク設定にあわせて {{ic|rsize}} や {{ic|wsize}} マウントオプションを調整する必要があります。

最近の Linux カーネル (2.6.18 以上) ではメモリの容量によって NFS サーバーが使用できる I/O のサイズ (最大ブロックサイズ) が変わります。最大は 1M (1048576バイト) で、NFS クライアントがより大きな {{ic|rsize}} や {{ic|wsize}} を必要としている場合でもサーバーの最大ブロックサイズが使われます [https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/5.8_Technical_Notes/Known_Issues-kernel.html]。''nfsd'' を起動する前に {{ic|/proc/fs/nfsd/max_block_size}} に書き込むことでサーバーのデフォルト最大ブロックサイズを変更できます。例えば、以下のコマンドは昔のデフォルトの IO サイズであった 32k に設定します:

# echo 32767 > /proc/fs/nfsd/max_block_size

変更を永続化するには [[Systemd#一時ファイル|systemd-tmpfile]] を作成してください:

{{hc|/etc/tmpfiles.d/nfsd-block-size.conf|
w /proc/fs/nfsd/max_block_size - - - - 32768}}

=== systemd-networkd で共有を自動マウント ===

systemd-networkd を使っている場合、起動時に nfs がマウントされないことがあります。以下のようなエラーが表示されます:
mount[311]: mount.nfs4: Network is unreachable

解決方法は簡単です。{{ic|systemd-networkd-wait-online.service}} を[[有効化]]して、ネットワークが完全に設定されるまで待機するように systemd を設定してください。サービスが平行して起動しなくなるので起動時間は多少長くなります。

=== 自動マウントの処理 ===

ローカルのワイヤレスネットワークから nfs 共有を使う必要があるノートパソコンでこの設定は役に立ちます。nfs ホストが到達できない状態になったとき、nfs 共有はアンマウントされ、hard マウントオプションを使っている際にシステムフリーズが起こらなくなります。https://bbs.archlinux.org/viewtopic.php?pid=1260240#p1260240 を参照。

NFS のマウントポイントが {{ic|/etc/fstab}} に正しく記述されていることを確認してください:

{{hc|/etc/fstab|<nowiki>
lithium:/mnt/data /mnt/data nfs noauto,noatime,rsize=32768,wsize=32768 0 0
lithium:/var/cache/pacman /var/cache/pacman nfs noauto,noatime,rsize=32768,wsize=32768 0 0</nowiki>
}}

{{ic|noauto}} マウントオプションは起動時に自動的に共有をマウントしないように systemd に命じます。これを設定していないとネットワーク上に共有が存在するかどうかわからないのに systemd が共有をマウントしようとしてブート中にブランクスクリーンで止まってしまいます。

root 以外のユーザー {{ic|user}} で NFS 共有をマウントするには fstab にエントリを追加する必要があります。

''cron'' を使って NFS ホストが到達可能なチェックする {{ic|auto_share}} スクリプトを作成:

{{hc|/usr/local/bin/auto_share|<nowiki>
#!/bin/bash

function net_umount {
umount -l -f $1 &>/dev/null
}

function net_mount {
mountpoint -q $1 || mount $1
}

NET_MOUNTS=$(sed -e '/^.*#/d' -e '/^.*:/!d' -e 's/\t/ /g' /etc/fstab | tr -s " ")$'\n'b

printf %s "$NET_MOUNTS" | while IFS= read -r line
do
SERVER=$(echo $line | cut -f1 -d":")
MOUNT_POINT=$(echo $line | cut -f2 -d" ")

# Check if server already tested
if [[ "${server_ok[@]}" =~ "${SERVER}" ]]; then
# The server is up, make sure the share are mounted
net_mount $MOUNT_POINT
elif [[ "${server_notok[@]}" =~ "${SERVER}" ]]; then
# The server could not be reached, unmount the share
net_umount $MOUNT_POINT
else
# Check if the server is reachable
ping -c 1 "${SERVER}" &>/dev/null

if [ $? -ne 0 ]; then
server_notok[${#Unix[@]}]=$SERVER
# The server could not be reached, unmount the share
net_umount $MOUNT_POINT
else
server_ok[${#Unix[@]}]=$SERVER
# The server is up, make sure the share are mounted
net_mount $MOUNT_POINT
fi
fi
done
</nowiki>}}

スクリプトに実行権限を付与:

# chmod +x /usr/local/bin/auto_share

[[cron]] エントリか [[systemd/タイマー|systemd タイマー]]を作成して、共有サーバーにアクセスできるか1分ごとに確認するようにしてください。

==== Cron ====

{{hc|# crontab -e|<nowiki>
* * * * * /usr/local/bin/auto_share
</nowiki>}}

==== systemd/タイマー ====

以下のユニットを作成:

{{hc|# /etc/systemd/system/auto_share.timer|<nowiki>
[Unit]
Description=Check the network mounts

[Timer]
OnCalendar=*-*-* *:*:00

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

{{hc|# /etc/systemd/system/auto_share.service|<nowiki>
[Unit]
Description=Check the network mounts

[Service]
Type=simple
ExecStart=/usr/local/bin/auto_share
</nowiki>}}

作成したら {{ic|auto_share.timer}} を[[有効化]]してください。

==== systemd で起動時にマウント ====

systemd のユニットファイルを使って起動時に NFS 共有をマウントすることも可能です。クライアントに NetworkManager がインストール・設定されている場合はユニットファイルは必要ありません。[[#NetworkManager dispatcher]] を見て下さい。

{{hc|/etc/systemd/system/auto_share.service|<nowiki>
[Unit]
Description=NFS automount
After=syslog.target network.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/usr/local/bin/auto_share

[Install]
WantedBy=multi-user.target
</nowiki>}}

{{ic|auto_share.service}} を[[有効化]]してください。

==== NetworkManager dispatcher ====

上で説明している方法に加えて、ネットワークの状態が変わった時にスクリプトを実行するよう NetworkManager を設定することもできます。

{{ic|NetworkManager-dispatcher}} サービスを有効化・起動してください。

ネットワーク状態の変化にあわせてネットワーク上の共有をマウントする一番簡単な方法は {{ic|auto_share}} スクリプトにシンボリックリンクを作成することです:

# ln -s /usr/local/bin/auto_share /etc/NetworkManager/dispatcher.d/30-nfs.sh

ただし、特定の場合では、ネットワーク接続が無効になった後にアンマウントが実行され、KDE Plasma アプレットがフリーズしたりすることがあります。

以下のスクリプトを使うことでネットワーク接続が切れる前に NFS 共有を安全にアンマウントすることができます:

{{hc|/etc/NetworkManager/dispatcher.d/30-nfs.sh|<nowiki>
#!/bin/bash

# Find the connection UUID with "nmcli con show" in terminal.
# All NetworkManager connection types are supported: wireless, VPN, wired...
WANTED_CON_UUID="CHANGE-ME-NOW-9c7eff15-010a-4b1c-a786-9b4efa218ba9"

if [[ "$CONNECTION_UUID" == "$WANTED_CON_UUID" ]]; then

# Script parameter $1: NetworkManager connection name, not used
# Script parameter $2: dispatched event

case "$2" in
"up")
mount -a -t nfs4,nfs
;;
"pre-down");&
"vpn-pre-down")
umount -l -a -t nfs4,nfs >/dev/null
;;
esac
fi
</nowiki>}}
スクリプトに実行可能属性を付与:
# chmod +x /etc/NetworkManager/dispatcher.d/30-nfs.sh
{{ic|/etc/NetworkManager/dispatcher.d/pre-down}} にシンボリックリンクを作成して {{ic|pre-down}} イベントをキャッチ:
# ln -s /etc/NetworkManager/dispatcher.d/30-nfs.sh /etc/NetworkManager/dispatcher.d/pre-down.d/30-nfs.sh

上記のスクリプトは別の接続で別の共有をマウントするように修正することができます。

[[NetworkManager#dispatcher を使って CIFS 共有のマウントを処理]]を参照。

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

[[NFS/トラブルシューティング]]を参照してください。

== 参照 ==

* [http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.aix.prftungd/doc/prftungd/nfs_perf.htm NFS Performance Management]
* [http://blogs.msdn.com/sfu/archive/2008/04/14/all-well-almost-about-client-for-nfs-configuration-and-performance.aspx Microsoft Services for Unix NFS Client info]
* [https://web.archive.org/web/20151212160906/https://blogs.oracle.com/jag/entry/nfs_on_snow_leopard NFS on Snow Leopard]

Firefox/設定

2018-11-19T05:47:12Z

R6eve: ノートの翻訳

[[Category:ウェブブラウザ]]
[[en:Firefox/Tweaks]]
[[tr:Firefox İpuçları]]
{{Related articles start}}
{{Related|Firefox}}
{{Related|ブラウザプラグイン}}
{{Related|Firefox Ramdisk}}
{{Related|Firefox プライバシー}}
{{Related articles end}}

このページでは Firefox の高度な設定オプションとパフォーマンスを上げる設定を説明します。

== パフォーマンス ==

Firefox のパフォーマンスを向上させる方法には、Firefox の実行中に入力できるパラメータ、開発者によって決められている設定の変更、もしくは外部プログラムやスクリプトによる高度な方法が存在します。

{{Note|かならず最新版の Firefox を使って下さい。}}

=== Firefox の高度なオプション ===
このセクションではパフォーマンスに関する Firefox の高度なオプションについて説明しています。詳しい情報は [http://kb.mozillazine.org/Category:Tweaking_preferences Mozillazine フォーラムの投稿] を見て下さい。

==== OpenGL Off-Main-Thread Compositing (OMTC) の有効化 ====

{{Warning|特定のハードウェアで OpenGL OMTC が無効になる場合、おそらく安定に問題があったり、システムリソースの消費が激しかったり、ドライバーにバグが存在するなどの可能性があります。強制的に有効化するときは自己責任で行って下さい。}}
{{Note|Firefox バージョン 40 から基本的なソフトウェア OMTC はデフォルトで有効になります。}}

OpenGL OMTC を有効にするには {{ic|about:config}} を開いて以下を設定します:
* {{ic|layers.acceleration.force-enabled true}}

Firefox を再起動することで変更が適用されます。

OpenGL OMTC が有効になっているかどうか確認するには、{{ic|about:support}} を開いて "Graphics" セクションの "GPU Accelerated Windows" を見ます。"0/1 Basic (OMTC)" (または 0/2) と表示されている場合、OpenGL OMTC は無効になっています。"1/1 OpenGL (OMTC)" (または 1/2 や 2/2) となっている場合、有効です。

上記の設定で GPU アクセラレーションが有効にならない場合、環境変数を設定してみてください: {{ic|1=export MOZ_USE_OMTC=1}}。設定してから Firefox を起動します [http://featherweightmusings.blogspot.se/2013/11/no-more-main-thread-opengl-in-firefox.html]。

Firefox の OMTC に関する詳細は次のページにあります: https://wiki.mozilla.org/Platform/GFX/OffMainThreadCompositing

==== AzureContentBackend を Cairo の代わりに Skia に設定する ====
{{Note|Firefox 51 からデフォルトのコンテンツバックエンドは Skia です。}}
[https://skia.org/ Skia] は Linux 版のデフォルト Azure バックエンドとして使われた Cairo を置き換える 2D オープンソースグラフィックライブラリです。

Skia をデフォルトに設定するには {{ic|about:config}} から以下の設定を行ってください:
* {{ic|gfx.content.azure.backends skia,cairo}}

Firefox を再起動すると変更が適用されます。

デフォルトの Azure バックエンドを確認するには {{ic|about:support}} を開いてグラフィックセクションの "AzureContentBackend" が "skia" になっているか確認してください。

==== Accelerated Azure Canvas を有効にする ====
{{ic|about:config}} を開いて、右クリックして新しい真偽値を作ってください。名前を {{ic|gfx.canvas.azure.accelerated}} にして true に設定してください。

Firefox を再起動して {{ic|about:support}} の AzureCanvasAccelerated が 1 になっていれば有効です。

==== ネットワーク設定 ====

高度なネットワーク設定は {{ic|about:config}} ページから変更できます (''network'' を検索してみてください)。

{| class="wikitable"
|+ 推奨値
! 設定名 || 値 || 説明
|-
| network.http.pipelining || true || 通常接続で [http://www-archive.mozilla.org/projects/netlib/http/pipelining-faq.html pipelining] を有効にします。
|-
| network.http.pipelining.ssl || true || SSL 接続で HTTP pipelining を有効にします。
|-
| network.http.proxy.pipelining || true || プロキシ接続で pipelining を有効にします。
|}

==== アンチフィッシングの無効化 ====
{{Note|プロファイルフォルダのファイル削除には危険が伴うため、先にバックアップをすることを推奨します。}}

Firefox のアンチフィッシング機能は Firefox の起動や終了を遅くすることがあります。問題は Firefox が [[Sqlite]] データベースを使っており、何度も使用しているうちにデータベースが巨大に成長することで読み書きが遅くなるのが原因です。どのサイトが怪しいのか Firefox に知らせてもらう必要がないと感じたのならば、機能を無効にすることが可能です:

* 設定のセキュリティタブで次のオプションをオフにしてください: ''"攻撃サイトとして報告されているサイトをブロックする"'' と ''"偽装サイトとして報告されているサイトをブロックする"''。

* プロファイルフォルダ ({{ic|~/.mozilla/firefox/<profile_dir>/}}) に存在する {{ic|urlclassifier}} から始まるファイルを全て削除してください:
$ rm -i ~/.mozilla/firefox/<profile_dir>/urlclassifier*

:上記のファイルは Firefox によって再作成されることがありますが、初期サイズから大きく成長することはなくなります。

==== urlclassifier3.sqlite が作成されないようにする ====
上述のように {{ic|urlclassifier*}} ファイルを全て削除しても、一定期間後に {{ic|urlclassifier3.sqlite}} のサイズがまた増加することがあります。将来的にサイズが増加しないようにするシンプルな解決法:

$ cd ~/.mozilla/firefox/<profile_dir>
$ echo "" > urlclassifier3.sqlite
$ chmod 400 urlclassifier3.sqlite

ファイルを空にして読み取り専用にすることで Firefox から書き込めないようになります。

==== OCSP 検証の無効化 ====
OCSP バリデーションは、Firefox が新しいサーバーに接続 (HTTPS) するたびに [http://news.netcraft.com/archives/2013/04/16/certificate-revocation-and-the-performance-of-ocsp.html 遅延を発生させる] ことがあります。特に、HTTPS を使用するページにウェブガジェットが含まれていた場合、一つの URL で複数の接続が発生することになり、事態を悪化させます。

* 設定 -> 詳細 -> 証明書にある次のオプションをオフにしてください: ''"OSCP レスポンダに問い合わせてデジタル証明書の有効性をリアルタイムに確認する"''。

{{Warning|OCSP を無効化した場合、中間者攻撃から無防備になります。Wi-Fi や VPN などの攻撃されるおそれがある接続を使用する場合は、OSCP はオンのままにしておくことが強く推奨されます。}}

==== ディスクキャッシュの無効化 ====
ロードされたオブジェクト (html ページ、jpeg 画像、css スタイルシート、gif バナー) はすべて Firefox キャッシュに保存され、同じオブジェクトを今度使用するときにロードすることで、もう一度サーバーからダウンロードする必要を省きます。しかしながら、実際に再利用されるオブジェクトはごくわずかに限られています (通常は 30% ほど)。これはオブジェクトの有効期間が短すぎたり、アップデートがあったり、もしくは、単純にユーザーが行う行動 (訪問済みのページではなく新しいページをロードするなど) が原因であったりします。Firefox のキャッシュはメモリキャッシュとディスクキャッシュに分けられており、ディスクキャッシュを使用している場合、オブジェクトがロードされる度にディスクに書き込みが行われ、また、同時に古いオブジェクトの削除もされるために、頻繁にディスクの書き込みが発生します。

* 設定 -> 詳細 -> ネットワーク -> キャッシュされた Web ページから ''"キャッシュサイズを制限する"'' でゼロを指定してください。

==== セッションを保存する間隔を長くする ====
Firefox のセッションは15秒ごとに現在の状態 (開かれている url、cookie、履歴とブックマーク) を自動的に保存しています。これはユーザーが必要とするところよりも少し頻繁すぎる嫌いがあり、頻繁にディスクアクセスを発生させています。

セッションの保存間隔の設定は {{ic|about:config}} ページから変更できます (''sessionstore'' を検索してください)。

* browser.sessionstore.interval 300000

セッションの保存を無効化したい場合、以下の設定を true から false に変更してください:

* browser.sessionstore.resume_from_crash false

==== 即座にページをレンダリング ====
Mozilla アプリケーションはウェブページを漸増的にレンダリングします。ページ全体がダウンロードされる前に、ページの一部だけを表示するのです。基本的にウェブページの最初の部分には表示に関係する情報はあまり存在しないため、Mozilla アプリケーションはページをレンダリングする前に少しの間だけ待機します。以下の設定はインターバルを制御します。接続速度が遅い場合 (ダイアルアップ接続など)、設定を変更するとウェブページのロード時間が長くなることがあるので注意してください。

* nglayout.initialpaint.delay の値を 0 に変更。

上記の設定は {{ic|about:config}} ページで行うことができます。

=== その他の設定 ===
このセクションでは Firefox のパフォーマンスを向上させるその他の設定を説明しています。

==== UPX で Firefox バイナリを圧縮して起動時間を短縮 ====
[http://upx.sourceforge.net/ UPX] は高速な伸長をサポートしている実行可能ファイル圧縮ツールであり、メモリのオーバーヘッドを減らします。[[公式リポジトリ]]の {{Pkg|upx}} パッケージで[[インストール]]できます。

{{ic|upx}} を使用して Firefox の実行可能ファイルを圧縮する前に、バイナリのバックアップを作成してください:
# cp /usr/lib/firefox/firefox /usr/lib/firefox/firefox.backup

最後に、{{ic|upx}} を実行して、最大圧縮レベルを適用してください:
# upx --best /usr/lib/firefox/firefox

==== リファラーヘッダの制御 ====
Firefox バージョン 28 では HTTP リファラーヘッダの送信を制御することができます。GUI の設定からはオプションを書けられませんが、{{ic|about:config}} で変更することが可能です。関連するキーは4つ存在します [https://security.stackexchange.com/a/80194]。推奨される設定を以下の行で説明します。

{| class="wikitable"
|+ 推奨値
! キー || 推奨 || [https://ip-check.info ip-check.info] || デフォルト || 説明
|-
| network.http.sendRefererHeader || 1 || 1 || 2 || リンクをクリックした場合にのみ送信 (0 は完全に送信しない、1 はリンクのクリック時のみ、2 は常に送信)。
|-
| network.http.referer.XOriginPolicy || 1 || 1 || 0 || ベースドメインが一致する場合にのみ送信 (0 は常に送信、2 はホストが一致する場合のみ)。
|-
| network.http.referer.spoofSource || true || false || false || リンク先の URI を送信。
|-
| network.http.referer.trimmingPolicy || 2 || 0 || 0 || スキーム・ホスト・ポートを送信しない (0 は全て送信しない、1 はスキームやホストのポート・パスを送信しない)。
|}

==== プロファイルの SQLite データベースのデフラグ ====
{{Warning|以下の設定はデータベースを破損させてセッションが正しく保存されなくなる可能性があります。}}

Firefox 3.0 ではブックマーク・履歴・パスワードは SQLite データベースに保存されます。SQLite データベースは使っていくうちに断片化して空き領域があちこちにできます。Firefox はデータベースを確認して最適化することはしないので、しばらくすると断片化は性能に影響してきます。データベースのデフラグを行なって使われていない領域を削除することで起動時間を短縮したりブックマークや履歴などの操作を高速化することが可能です。

Firefox を実行していないときに {{AUR|profile-cleaner}} を使うことでデフラグを行えます。

{| class="wikitable"
|+ デフラグ前後のサイズの比較
! SQLite データベース || デフラグ前のサイズ || デフラグ後のサイズ || % 変化
|-
|urlclassifier3.sqlite|| 37 M || 30 M || 19 %
|-
|places.sqlite || 16 M || 2.4 M || 85 %
|-
|}

Firefox の最近のバージョンでは、ページのロードが遅くなったりプロファイルの破損の原因となる places データベースをデフラグ・最適化するツールが用意されています。ツールを使うには {{ic|about:support}} ページを開いてください。{{ic|Places データベース}} の下にある {{ic|完全性を検証}} ボタンを押してください。

==== tmpfs でプロファイルを RAM にキャッシュ ====
システムにメモリが余っている場合、{{ic|tmpfs}} を使って[[Firefox Ramdisk|プロファイルディレクトリ全体をキャッシュ]]することができます。そうすると Firefox のレスポンスが高まります。

==== スポンサーコンテンツやタイルをオフにする ====
{{ic|about:config}} で {{ic|browser.newtabpage.directory.source}} と {{ic|browser.newtabpage.directory.ping}} の値を空にしてください。また、新しいタブページのツールからタイル機能を無効にすると良いでしょう。[[Wireshark]] セッションで通信を確認できます。

==== Electrolysis の有効化 ====
Firefox 48 (45 ESR) 以上では Electrolysis (マルチプロセス) を有効化することでパフォーマンスとセキュリティを高めることができます。{{ic|about:config}} で {{ic|browser.tabs.remote.autostart}} を ''true'' に設定してください。Electrolysis を強制的に有効化することもできますが [https://wiki.mozilla.org/Electrolysis#Force_Enable]、問題が起こる可能性があるため基本的には推奨されません。

Electrolysis が有効になっているか確認するには {{ic|about:support}} の「アプリケーション基本情報」セクションにある「マルチプロセスウィンドウ」を確認してください。"0/1 (無効)" となっている場合 Electrolysis は無効です。"1/1 (ユーザー設定により有効)" となっていれば有効です。''*/*'' の数字は Firefox の開かれているウィンドウの数を示します。例えば 0/2 は2つ開かれている Firefox のウィンドウのどちらも Electrolysis を使用しておらず、2/2 は両方のウィンドウで有効になっていることを意味します。

==== HTTP キャッシュの有効化 ====
{{ic|about:config}} で {{ic|browser.cache.use_new_backend}} を 0 から 1 に設定してください。

==== Pocket の無効化 ====
Pocket サービスを使用しない場合、{{ic|about:config}} で {{ic|extensions.pocket.enabled}} を ''false'' に設定することで無効にできます。
{{Note|45ESR の場合、キーは {{ic|browser.pocket...}} です。}}

== 外観 ==
=== フォント ===
次の記事を参照してください: [[フォント設定]]

==== DPI の値の設定 ====
システムの DPI が 96 を下回っている場合、設定を変更することで Firefox のフォントの見た目を良くすることができます。デフォルトでは Firefox は DPI の値は 96 を使用し、96 を上回っている場合だけシステム値を使います。値に関係なくシステム値を使うようにするには、アドレスバーに {{ic|about:config}} と入力して {{ic|layout.css.dpi}} を '''0''' に設定してください。

上記の設定は Firefox のユーザーインターフェースの DPI 設定にだけ影響を与えるので注意してください。ウェブページのコンテンツの DPI 値は 96 のままです。変更するには {{ic|layout.css.devPixelsPerPx}} をシステムの DPI を 96 で割った値に設定してください。例えばシステムの DPI が 144 の場合、設定する値は 144/96 = 1.5 です。{{ic|layout.css.devPixelsPerPx}} を '''1.5''' にするとウェブページのコンテンツの DPI が 144 になります。

高解像度ディスプレイについての情報は [[HiDPI#Firefox]] を参照してください。DPI の計算は [https://www.sven.de/dpi/] を見てください。

==== Microsoft Windows のデフォルトフォント設定 ====
以下は Firefox を Microsoft Windows にインストールした時のデフォルトフォント設定です。多くのウェブサイトは Microsoft フォントを使っています。
{{bc|
Proportional: Serif Size (pixels): 16
Serif: Times New Roman
Sans-serif: Arial
Monospace: Courier New Size (pixels): 13
}}

=== 一般的なユーザーインターフェイスの CSS 設定 ===
Firefox のユーザーインターフェイスは {{ic|~/.mozilla/firefox/<profile_dir>/chrome/}} 内の {{ic|userChrome.css}} や {{ic|userContent.css}} ファイルを編集することで変更することができます (''profile_dir'' は ''hash.name'' という形式を取っており、''hash'' は8文字のランダムな文字列です。プロファイルの ''name'' は通常 ''default'' となっています)。

{{Note|{{ic|chrome/}} フォルダと {{ic|userChrome.css}}/{{ic|userContent.css}} ファイルは存在している必要がないので、作る必要があるかもしれません。}}

このセクションでは (ウェブページではなく) Firefox のユーザーインターフェイスを変更する {{ic|userChrome.css}} ファイルについてだけ扱います。

==== フォントの変更 ====
この設定はグローバルな GTK+ のフォント設定を上書きします。ウェブページには影響を与えません、ユーザーインターフェイスのフォントだけが変更されます:
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css|
* {
font-family: "FONT_NAME";
}
}}

==== ボタンアイコンの隠匿 ====
テキストボタンを有効化:
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css|
.button-box .button-icon {
display: none;
}
}}

==== 様々なタブボタンの隠匿 ====
以下の設定はタブバーの縁で表示される矢印、全てのタブのドロップダウンリストを切り替えるボタン、新しいタブを作成するプラス記号を非表示にします:
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css|<nowiki>
/* Tab bar */

.tabbrowser-strip *[class^="scrollbutton"] {
/* Hide tab scroll buttons */
display: none;
}

.tabbrowser-strip *[class^="tabs-alltabs"] {
/* Hide tab drop-down list */
display: none;
}

.tabbrowser-strip *[class^="tabs-newtab-button"] {
/* Hide new-tab button */
display: none;
}</nowiki>
}}

==== 水平タブ ====
タブバーをブラウザウィンドウの側面に横に並べて表示するには:
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css|
/* Display the tabbar on the left */
#content > tabbox {
-moz-box-orient: horizontal;
}

.tabbrowser-strip {
-moz-box-orient: vertical;
/*
* You can set this to -moz-scrollbars-vertical instead,
* but then the scrollbar will *always* be visible. this way
* there is never a scrollbar, so it behaves like the tab bar
* normally does
*/
overflow: -moz-scrollbars-none;
}

.tabbrowser-tabs {
-moz-box-orient: horizontal;
min-width: 20ex; /* You may want to increase this value */
-mox-box-pack: start;
-moz-box-align: start;
}

.tabbrowser-tabs > hbox {
-moz-box-orient: vertical;
-moz-box-align: stretch;
-moz-box-pack: start;
}

.tabbrowser-tabs > hbox > tab {
-moz-box-align: start;
-moz-box-orient: horizontal;
}
}}

==== ウィンドウの縁とタイトルバーを非表示にする ====
[https://addons.mozilla.org/firefox/addon/hide-caption-titlebar-plus-sma/ Hide Caption Titlebar Plus] 拡張をインストールして以下の設定を行ってください (他の設定はデフォルトのままにしてください):
{| class="wikitable"
! オプション
! 値
|-
| Show Custom Caption/TitleBar
| Never
|-
| Activate custom borders and corner resizers
| Deactivate
|-
| Enable Customizable Buttons (min,max,close)
| Using a Glass-like window background
|-
| Custom Minimize, Max, Close Buttons
| Auto. Current theme's skin (fixed position)
|-
| Drag Fx window using Tab-bar background
| Enable
|-
| Alternative hide-titlebar feature
| Use
|}

[https://addons.mozilla.org/firefox/addon/classicthemerestorer/ Classic Theme Restorer] 拡張では他にもタブの高さを 28px に設定したりツールバーやボタンを有効化・無効化するオプションが使えます。

==== ブックマークツールバーを自動で隠匿 ====
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css|
#PersonalToolbar {
visibility: collapse !important;
}

#navigator-toolbox:hover > #PersonalToolbar {
visibility: visible !important;
}
}}

==== サイドバーの幅の制限をなくす ====
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css|
/* remove maximum/minimum width restriction of sidebar */
#sidebar {
max-width: none !important;
min-width: 0px !important;
}
}}

=== ウェブコンテンツの CSS 設定 ===
このセクションではウェブコンテンツに CSS のカスタムルールを追加できる {{ic|userContent.css}} ファイルについて扱います。このファイルへの変更はブラウザの再起動時に適用されます。

頻繁に使うウェブサイトに小さな修正を加えたり個人的なスタイルを適用することが可能です。人気のウェブサイトのカスタムスタイルシートは [http://userstyles.org/ userstyles.org] などから手に入れることができます。[https://addons.mozilla.org/firefox/addon/superusercontent/ superUserContent] などのアドオンをインストールしてテーマを管理することが可能です。アドオンは {{ic|chrome/userContent.css.d}} ディレクトリを作成してページが更新されたときに中に入っている CSS ファイルに変更を適用します。

==== 他の CSS ファイルのインポート ====
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userContent.css|
@import url("./imports/some_file.css");
}}

==== ドメインの特定部位をブロック ====
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userContent.css|
@-moz-document domain(example.com) {
div#header {
background-image: none !important;
}
}
}}

==== PDF ファイルのリンクの後ろに [pdf] を追加 ====
{{hc|~/.mozilla/firefox/<profile_dir>/chrome/userContent.css|<nowiki>
/* add '[pdf]' next to links to PDF files */
a[href$=".pdf"]:after {
font-size: smaller;
content: " [pdf]";
}</nowiki>
}}

==== Firefox 4 の新しいメニューバー/Firefox ボタン ====
新しい Firefox ボタンとクラシックなメニューバーを切り替えるには:
* ボタンが有効な場合、''Preferences > Menu Bar'' にチェックを入れるかツールバーを右クリックして ''Menu Bar'' にチェックを入れてください。
* メニューバーが有効な場合、''View > Toolbars > Menu Bar'' のチェックを外すか、ツールバーを右クリックして ''Menu Bar'' のチェックを外してください。

GNU/Linux では Windows のオレンジのボタンの代わりにグレーのボタンが表示されます。設定によって Firefox アイコンに "Firefox" というテキストの表示に変えられます。

{{ic|~/.mozilla/firefox/userprofile/chrome/userChrome.css}} ファイルに以下を追加するとテキストの前にアイコンが表示されます:
{{bc|
#appmenu-toolbar-button {
list-style-image: url("chrome://branding/content/icon16.png");
}
}}

同じファイルに以下を追加すると "Firefox" の文字が消えます:
{{bc|
#appmenu-toolbar-button > .toolbarbutton-text,
#appmenu-toolbar-button > .toolbarbutton-menu-dropmarker {
display: none !important;
}
}}

Windows の Firefox 4 以上のデフォルト設定をコピーしてオレンジの背景を追加し、プライベートブラウジングモードを紫背景にする {{ic|userChrome.css}} 設定:
{{bc|
#main-window:not([privatebrowsingmode]) #appmenu-toolbar-button {
-moz-appearance: none !important;
color: #FEEDFC !important;
background: -moz-linear-gradient(hsl(34,85%,60%), hsl(26,72%,53%) 95%) !important;
border: 1px solid #000000 !important;
}

#main-window:not([privatebrowsingmode]) #appmenu-toolbar-button:hover:not(:active):not([open]) {
-moz-appearance: none !important;
color: #FEEDFC !important;
background: -moz-linear-gradient(hsl(26,72%,53%), hsl(34,85%,60%) 95%) !important;
border: 1px solid #000000 !important;
}

#main-window:not([privatebrowsingmode]) #appmenu-toolbar-button:hover:active,
#main-window:not([privatebrowsingmode]) #appmenu-toolbar-button[open] {
-moz-appearance: none !important;
color: #FEEDFC !important;
background: -moz-linear-gradient(hsl(26,72%,53%), hsl(26,72%,53%) 95%) !important;
border: 1px solid #000000 !important;
}

#appmenu-toolbar-button {
-moz-appearance: none !important;
color: #FEEDFC !important;
background: -moz-linear-gradient(hsl(279,70%,46%), hsl(276,75%,38%) 95%) !important;
border: 1px solid #000000 !important;
}

#main-window #appmenu-toolbar-button:hover:not(:active):not([open]) {
-moz-appearance: none !important;
color: #FEEDFC !important;
background: -moz-linear-gradient(hsl(276,75%,38%), hsl(279,70%,46%) 95%) !important;
border: 1px solid #000000 !important;
}

#main-window #appmenu-toolbar-button:hover:active,
#main-window #appmenu-toolbar-button[open] {
-moz-appearance: none !important;
color: #FEEDFC !important;
background: -moz-linear-gradient(hsl(276,75%,38%), hsl(276,75%,38%) 95%) !important;
border: 1px solid #000000 !important;
}
}}

{{Note|{{ic|chrome}} ディレクトリと {{ic|userChrome.css}} が存在しない場合は作成してください。}}

==== 広告のブロック ====

{{ic|userContent.css}} を使って広告をブロックする方法については [http://www.floppymoose.com floppymoose.com] にサンプルがあります。

==== フルスクリーンの警告を無効化 ====

フルスクリーンモードにしたときに表示される警告は {{ic|about:config}} で "full-screen-api.warning.timeout" を 0 に設定することで無効にできます。

== その他 ==

その他のヒントと設定。

=== 追加のメディアコーデックの有効化 ===

設定する前に、デフォルトで有効になっていないことには理由があることを覚えておいて下さい。安定に問題があったり、メモリリークが発生することがあります。{{ic|about:config}} を開いて以下のオプションを確認してください:

{| class="wikitable"
|+ 推奨値
! キー || 値 || 説明
|-
| media.mediasource.enabled || true (デフォルト) || [[wikipedia:Media_Source_Extensions|Media Source Extensions]] (MSE) の有効化
|-
| media.mediasource.mp4.enabled || true (デフォルト) || [[wikipedia:ja:MP4|MP4]] MSE の有効化
|-
| media.mediasource.webm.enabled || true (デフォルト) || [[wikipedia:ja:WebM|WebM]] MSE の有効化。
|-
| media.mediasource.ignore_codecs || true || H.264 MSE などを有効化 (キーは作成してください)
|}

==== Widevine と Netflix/Amazon Video ====

Widevine は Netflix や Amazon プライムビデオなどがビデオコンテンツの保護のために使用しているデジタル著作権管理ツールです。

Widevine が使われているページを初めて表示すると Firefox はアドレスバーの下に DRM をインストールしてもよいか表示します。承認したらダウンロードバーが消えるまで待ってください。完了したら Netflix や Amazon プライムビデオなどから動画を視聴できるはずです。
{{Note|コンテンツ設定の "DRM コンテンツの再生" にチェックが入っていることを確認してください。}}

=== マウスホイールでスクロールする速度 ===

マウスホイールによるスクロール速度のデフォルト値を修正するには (例: スピードアップ)、{{ic|about:config}} を開いて {{ic|mousewheel.acceleration}} を検索してください。利用可能なオプションが表示されるので、以下を修正します:

* {{ic|mousewheel.acceleration.start}} を '''-1''' に設定。
* {{ic|mousewheel.acceleration.factor}} を適当な値に設定 (10 から 20 が普通使われる値です)。

もしくは [http://smoothwheel.mozdev.org/ SmoothWheel add-on] をインストールすることでも変更できます。

=== ピクセル単位で正確なトラックパッドのスクロール ===

(Nautilus などの GTK3 アプリケーションで使われている) 正確なトラックパッドスクロールを有効にするには、Firefox を起動する前に {{ic|1=MOZ_USE_XINPUT2=1}} [[環境変数]]を設定してください。

スクロールがぎくしゃくする場合、設定 > 詳細からスムーススクロールオプションを有効にしてみてください。

=== Firefox 検索バーの検索エンジンの順番を変更 ===

検索エンジンが表示される順番を変えるには:
* 検索エンジンのドロップダウンリストを開いて ''Manage Search Engines...'' エントリをクリック。
* 移動したい検索エンジンを選択して ''Move Up'' や ''Move Down'' で移動します。ドラッグアンドドロップで移動することも可能です。

=== Abiword や LibreOffice Writer で *.doc を自動的に開く方法 ===

''Preferences > Applications'' を開いて ''Word Document'' (または ''Word 2007 Document'' の {{ic|*.docx}}) を検索してください。見つけたら、ドロップダウンリストをクリックして ''Use other...'' を選択してください。そして Abiword や Writer の実行可能ファイルのパスを指定してください ({{ic|/usr/bin/abiword}} や {{ic|/usr/bin/lowriter}})。

=== "I'm Feeling Lucky" モード ===

検索エンジンによっては "feeling lucky" 機能が存在することがあります。例えば、Google には "I'm Feeling Lucky" があり、DuckDuckGo には "I'm Feeling Ducky" があります。

機能を有効化するには:
# アドレスバーに {{ic|about:config}} と入力。
# {{ic|keyword.url}} という文字列を検索。
# 値を検索エンジンの URL に設定。

Google の場合、次のように設定:
{{bc|<nowiki>https://www.google.com/search?btnI=I%27m+Feeling+Lucky&q=</nowiki>}}
DuckDuckGo の場合、次のように設定:
{{bc|<nowiki>https://duckduckgo.com/?q=\</nowiki>}}

=== DNSSEC で DNS をセキュア化 ===

[[en2:DNSSEC|DNSSEC]] のサポートを有効にすることでブラウジングを安全にすることができます。

=== マグネットプロトコルの関連付けの追加 ===

{{ic|about:config}} で {{ic|network.protocol-handler.expose.magnet}} を '''false''' に設定してください。

次にマグネットリンクを開いたとき、{{ic|Launch Application}} ダイアログが表示されます。ダイアログから、使いたい torrent クライアントを選択してください。他のプロトコルも同じように設定できます。

=== マグネットプロトコルの関連付けを kTorrent (KDE4) に追加 ===

{{ic|/usr/share/applications/kde4/ktorrent.desktop}} のユーザーコピーを {{ic|~/.local/share/applications/kde4/}} に作成して、{{ic|1=Mimetype=}} に以下を追加してください:

x-scheme-handler/magnet

{{ic|~/.config/mimeapps.list}} を修正して以下を追加:

x-scheme-handler/magnet=kde4-ktorrent.desktop

[https://superuser.com/questions/44072/how-do-i-associate-magnet-links-with-ktorrent-in-firefox] を見て下さい。

=== 突然終了してしまうのを防ぐ ===

[https://addons.mozilla.org/firefox/addon/disable-ctrl-q-shortcut/ Disable Ctrl-Q Shortcut] 拡張をインストールすることでブラウザを不注意に閉じてしまうことを防止できます。

もしくはウィンドウマネージャの設定ファイルにルールを追加する方法もあります。例えば [[openbox]] なら {{ic|~/.config/openbox/rc.xml}} ファイルの ''<keyboard>'' セクションに以下を追加してください:
<keybind key="C-q">
<action name="Execute">
<execute>false</execute>
</action>
</keybind>
{{Note|上記の設定はグラフィックサーバーで動作する全てのアプリケーションに適用されます。}}

=== 最新版でプラグインが動作しない ===

Arch はブリーディングエッジなので、最新の Firefox では動作しないプラグインと互換性の問題が起こることがあります (例: [http://5digits.org/pentadactyl/index Pentadactyl])。可能であれば、ナイトリー/ベータ版をインストールするか、[[パッケージのダウングレード]]を見て下さい。

[https://addons.mozilla.org/firefox/addon/checkcompatibility/ Disable Add-on Compatibility Checks] プラグインは新しいバージョンでもちゃんと動くのにプラグインが無効化される問題を解決します。

=== スクロールがギクシャクしている ===

Firefox でのスクロールが"ガタガタ"あるいは"ムラがある"と感じられることがあります。[http://forums.mozillazine.org/viewtopic.php?f=8&t=2749475/ MozillaZine] が Gentoo でスクロールを修正する設定を投稿していますが、Arch Linux でも同じように直ることが報告されています:

# {{ic|mousewheel.min_line_scroll_amount}} を 40 に設定
# {{ic|general.smoothScroll}} と {{ic|general.smoothScroll.pages}} を ''false'' に設定
# {{ic|image.mem.min_discard_timeout_ms}} を 2100000000 のように大きな値に設定、ただし 2140000000 を超えてはならない。この値よりも上の値に設定してしまうと Firefox は次のエラーを吐きます: "The text you entered is not a number"。
# {{ic|image.mem.max_decoded_image_kb}} を最低でも 512K に設定

これでスクロールがスムーズになるはずです。

=== nspawn コンテナの中で Firefox を実行 ===

PID 1 で実行するには:

# systemd-nspawn --setenv=DISPLAY=:0 \
--setenv=XAUTHORITY=~/.Xauthority \
--bind-ro=$HOME/.Xauthority:/root/.Xauthority \
--bind=/tmp/.X11-unix \
-D ~/containers/firefox \
firefox

もしくは [[systemd-networkd]] を使って systemd でネットワークを設定したコンテナを起動する場合:

# systemd-nspawn --bind-ro=$HOME/.Xauthority:/root/.Xauthority \
--bind=/tmp/.X11-unix \
-D ~/containers/firefox \
--network-veth -b

コンテナを起動したら、以下のように Xorg ライブラリを実行してください:

# systemd-run -M firefox --setenv=DISPLAY=:0 firefox

=== 検索がマッチした箇所をスクロールバーに表示 ===

[https://addons.mozilla.org/firefox/addon/findbar-tweak/ FindBar Tweak] 拡張をインストールすることで表示できます。

=== タッチスクリーンのジェスチャーを有効化 ===

{{ic|dom.w3c_touch_events.enabled}} が 1 (''有効'') または 2 (''デフォルト、自動認識'') に設定されていることを確認してください。

Firefox を起動する前に {{ic|1=export MOZ_USE_XINPUT2=1}} を実行してください。変更を永続化するには {{ic|/etc/profile.d/firefox.sh}} にコマンドを追加してください。

=== WebRTC オーディオのポストプロセス処理を無効化 ===

PulseAudio の [[PulseAudio/トラブルシューティング#エコー除去・ノイズキャンセルを有効にする|module-echo-cancel]] を使用している場合、Firefox がポストプロセス処理を音声にかけないように設定すると良いでしょう。
{| class="wikitable"
|+ オーディオのポストプロセス処理を無効化するには、以下のパラメータを設定
! キー || 値 || 説明
|-
| media.getusermedia.aec_enabled || false || AEC = 音響エコー除去 (Acoustic Echo Cancellation)
|-
| media.getusermedia.agc_enabled || false || AGC = 自動ゲインコントロール (Automatic Gain Control)
|-
| media.getusermedia.noise_enabled || false || ノイズ除去。Firefox のノイズ除去を無効にすると音がミッキーマウスのようになることがあります。
|}

=== Firefox の URL バーのマウスクリックを Windows と同じにする ===

{{ic|about:config}} で以下を設定してください:
{{bc|
browser.urlbar.clickSelectsAll true
browser.urlbar.doubleClickSelectsAll false
layout.word_select.stop_at_punctuation true
}}
URL バーのシングルクリックで全てを選択し、ダブルクリックで単語を選択、トリプルクリックで全てを選択するようになります。

== 参照 ==

* [http://kb.mozillazine.org/Knowledge_Base MozillaZine Wiki]
* [http://kb.mozillazine.org/About:config_entries about:config Entries Explained]
* [http://linuxtidbits.wordpress.com/2009/08/01/better-fox-cat-and-weasel/ Firefox touch-ups that might be desired]

Rxvt-unicode

2018-11-18T20:47:32Z

R6eve: トラブルシューティングの残りを翻訳

{{DISPLAYTITLE:rxvt-unicode}}
[[Category:ターミナルエミュレータ]]
[[de:urxvt]]
[[en:Rxvt-unicode]]
[[es:Rxvt-unicode]]
[[fr:urxvt]]
[[ru:Rxvt-unicode]]
[[sr:Rxvt-unicode]]
{{Related articles start}}
{{Related|rxvt-unicode/ヒントとテクニック}}
{{Related articles end}}
[http://software.schmorp.de/pkg/rxvt-unicode.html rxvt-unicode] は細かいカスタマイズができるターミナルエミュレータで [[Wikipedia:ja:Rxvt|rxvt]] のフォークです。一般に {{Ic|urxvt}} と呼ばれている、rxvt-unicode は[[デーモン]]化して一つの[[Wikipedia:ja:プロセス|プロセス]]で複数のクライアントを実行することができ、システムリソースの使用を抑えることができます。Marc Lehmann によって開発されており、rxvt-unicode の取り柄としては [[Wikipedia:ja:Unicode|Unicode]] による多言語サポートや、透過、複数のフォントタイプの表示機能、[[Perl]] 拡張のサポートなどが挙げられます。

== インストール ==

{{Pkg|rxvt-unicode}} パッケージでインストールすることができます。

== 設定 ==

設定と値の完全なリストは {{man|1|urxvt}} と {{man|7|urxvt}} を見て下さい。

=== ~/.Xresources の作成 ===

rxvt-unicode の外観や機能はコマンドラインの引数や [[X resources]] によって制御されます。コマンドライン引数は [[X resources]] の設定よりも優先して適用されます。

{{ic|urxvt --help}} は全ての ''rxvt'' リソースを標準エラーに出力します。各リソースの説明は man ページに存在します。

=== スクロールバックの位置 ===

デフォルトでは、シェル出力が更新されると、スクロールバックの表示は自動的にバッファの最後にジャンプし、新しい出力を表示します。前の出力（コンパイラメッセージなど）を表示したい場合は {{ic|~/.Xresources}} に以下のオプションを設定します:

! do not scroll with output
URxvt*scrollTtyOutput: false

! scroll in relation to buffer (with mouse scroll or Shift+Page Up)
URxvt*scrollWithBuffer: true

! scroll back to the bottom on keypress
URxvt*scrollTtyKeypress: true

=== セカンダリスクリーンのスクロールバッファ ===

''セカンダリスクリーン''でページャをスクロールすると (例えば {{ic|less}} で {{ic|'''-X'''}} オプションを省略した場合）、端末のバッファではなくページャ内でスクロールできるようスクロールバックバッファを無効にすることをお勧めします。konsole および vte ベースの端末ではデフォルトでこういう仕様になっており動作を変更できません。urxvt で ''セカンダリスクリーン''のスクロールバックバッファを無効にするには:

URxvt.secondaryScreen: 1
URxvt.secondaryScroll: 0

上記の設定は、マウスホイールを使用してスクロールする場合を除いて、期待通りに機能します。マウスホイールでセカンダリスクリーンのページャをスクロールしたとき、スクロールバックバッファに何かがあると、ページャの代わりにスクロールバックバッファがマウスホイールでスクロールされます。この問題を解決するには、rxvt-unicode に新しいオプションを導入する必要があります [https://bbs.archlinux.org/viewtopic.php?id=132150]。AUR の {{aur|rxvt-unicode-better-wheel-scrolling}} でパッチが適用された rxvt-unicode が利用できます。パッケージのインストール後、以下を設定ファイルに追加してください:

URxvt.secondaryWheel: 1

{{Note|perl 拡張の {{AUR|urxvt-vtwheel}} は上記のオプションと衝突します。}}

=== フォントを宣言する方法 ===

URxvt.font: 9x15
上記の設定は以下と同じです:
URxvt.font: -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso8859-1

同じフォントを太字で使用するには:
URxvt.font: 9x15bold
上記の設定は以下と同じです:
URxvt.font: -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso8859-1

X コアフォントの短縮名の完全なリストは {{ic|/usr/share/fonts/misc/fonts.alias}} にあります ({{ic|/usr/share/fonts/}} のサブディレクトリにも fonts.alias ファイルが存在しますが、実際のフォントとは別のパッケージになっているため、インストールされていないフォントも含まれます)。フォントの短縮エイリアスは ISO-10646-1 (Unicode) バージョンではなく ISO-8859-1 バージョンを選択し、100 DPI バージョンではなく 75 DPI バージョンのフォントが使われるため、フォントを選択したいときは長い方の名前を使ってください。

上記はビットマップフォントの話で、他のフォントは以下のように Xft で使うことができます:
URxvt.font: xft:monaco:size=10

または:
URxvt.font: xft:monaco:bold:size=10

{{Note|Xft のフォント名にハイフン(-)が含まれている場合は、バックスラッシュ(\)を2回打ってエスケープしてください。バックスラッシュ1回でエスケープする urxvt の -fn オプションや fc-list の出力とは仕方が異なります。}}

以下のようにターミナルにエスケープコードを出力することで一時的にフォントをテストすることが可能です:
$ printf '\e]710;%s\007' "xft:Terminus:pixelsize=12"

=== フォントの間隔 ===

デフォルトでは文字の間隔が広すぎるように感じられる場合、以下のエントリで調整できます:

{{hc|~/.Xresources|<nowiki>
URxvt.letterSpace: -1
</nowiki>}}

{{ic|-1}} で1ピクセル文字の間隔が狭まります。必要ならばもっと狭めることもできます。

=== カラー ===

デフォルトで、rxvt-unicode はカラーサポートを有効にしてコンパイルされています。デフォルトの前景色・背景色に加えて、rxvt は256色まで表示することができます (太字・点滅・下線とそれらの組み合わせも可能です)。

foreground, background, cursorColor, cursorColor2, colorBD, colorUL は0から15の数字で色を指定することができ、短い名前で color0-color15 の色を使うことができます。詳しくは [[#Xresources]] を参照。

{{Note|デフォルトでは {{ic|urxvt}} は [[Xterm]] と同じ色を使用しますが、ひとつだけ違う色があります。変更するには Xresources に {{ic|URxvt.color12: rgb:5c/5c/ff}} を追加してください。}}

== カットアンドペースト ==

Rxvt-unicode はデフォルトで {{Ic|PRIMARY}} セレクションにロードされているカットバッファを使います。詳しくは [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod#THE_SELECTION_SELECTING_AND_PASTING_ Selecting and pasting text] を見てください。

{{ic|ALT-CTRL-c}} と {{ic|ALT-CTRL-v}} でコピーアンドペーストができます。

{{Note|選択したテキストは自動的に {{ic|PRIMARY}} にコピーされます。{{Pkg|rxvt-unicode}} 9.20 から [[#Perl 拡張|perl 拡張]]の {{ic|selection-to-clipboard}} を使うことでテキストを {{ic|CLIPBOARD}} にコピーできます。}}

[[クリップボード#クリップボードマネージャの一覧]]も参照。

== Perl 拡張 ==

=== クリックできる URL ===

matcher 拡張を使うことでターミナルに表示された URL をクリックできるようになります。例えば、(規定のウェブブラウザを使って) 左マウスボタンでリンクを開くには、以下を {{ic|.Xresources}} に追加します:

URxvt.perl-ext-common: default,matcher
URxvt.url-launcher: /usr/bin/xdg-open
URxvt.matcher.button: 1

rxvt-unicode 9.14 から、キーボードを使って最近閲覧した URL を開いたり確認することもできるようになりました:

URxvt.keysym.C-Delete: perl:matcher:last
URxvt.keysym.M-Delete: perl:matcher:list

マッチするリンクに前景色・背景色といった[[#カラー|色]]を付けることもできます。例えば青色なら次です:

URxvt.matcher.rend.0: Uline Bold fg5

他には、{{ic|colorUL}} を使えば #RRGGBB スタイルでの色付けができます。ただし、これはリンクにマッチした部分だけでなく下線付きテキストのすべてに適用されます:

URxvt.colorUL: #4682B4

=== ヤンクできる URL (マウスを使用しない) ===

また、マウスを使わずに選択したURLをブラウザで開くこともできます。

{{Pkg|urxvt-perls}} パッケージをインストールして適当に {{ic|.Xresources}} を調整してください。例:
URxvt.perl-ext: default,url-select
URxvt.keysym.M-u: perl:url-select:select_next
URxvt.url-select.launcher: /usr/bin/xdg-open
URxvt.url-select.underline: true

{{Note|この拡張は、上で説明したクリックできる URL拡張を置き換えるため、{{Ic|matcher}} を {{Ic|URxvt.perl-ext}} のリストから除外してください。}}

'''キーコマンド:'''

{| class="wikitable"
! キー !! 説明
|-
| Alt+u || 選択モードに移行。スクリーン上にある最後のURLが選択されます。{{ic|Alt+u}} を繰り返せば更に上にあるURLを選択できます。
|-
| k || 上にあるURLを選択
|-
| j || 下にあるURLを選択
|-
| Return || 選択モードを終了して選択したURLをブラウザで開く
|-
| o || 選択モードを終了せずに選択したURLをブラウザで開く
|-
| y || 選択モードを終了して選択したURLをコピーする
|-
| Esc || URL 選択モードをキャンセル。
|}

=== シンプルなタブ ===

urxvt にタブを追加するには、以下を {{ic|~/.Xresources}} に追加します:
URxvt.perl-ext-common: ...,tabbed,...

タブをコントロールするには:

{| class="wikitable"
! キー !! 説明
|-
| Shift+Down || 新しいタブ
|-
| Shift+Left || 左のタブに移動
|-
| Shift+Right || 右のタブに移動
|-
| Ctrl+Left || タブを左に移動
|-
| Ctrl+Right || タブを右に移動
|-
| Ctrl+d || タブを閉じる
|}

タブの色は以下のようにして変更できます:

URxvt.tabbed.tabbar-fg: 2
URxvt.tabbed.tabbar-bg: 0
URxvt.tabbed.tab-fg: 3
URxvt.tabbed.tab-bg: 0

=== フルスクリーン ===

{{AUR|urxvt-fullscreen}} パッケージをインストールして、urxvt をフルスクリーンにするキーバインディングを設定することができます:

{{hc|~/.Xresources|
...
URxvt.perl-ext-common: ..., fullscreen, ...
URxvt.keysym.F11: perl:fullscreen:switch
...
}}

=== フォントサイズを即座に変更 ===

{{AUR|urxvt-resize-font-git}} パッケージをインストールして {{ic|~/.Xresources}} の Perl 拡張に以下を追加してください:

URxvt.perl-ext-common: ...,resize-font,...

デフォルトのキーバインド:
* {{ic|Ctrl++}} (または {{ic|1=Ctrl+Shift+=}}) でサイズを大きくする
* {{ic|Ctrl+-}} でサイズを小さくする
* {{ic|1=Ctrl+=}} でサイズをリセットする
* {{ic|Ctrl+?}} で現在のサイズを表示

以下のようにキーバインドを変更することもできます:

URxvt.keysym.C-Down: resize-font:smaller
URxvt.keysym.C-Up: resize-font:bigger

キーバインドとしてCtrl+Shiftを使うなら、デフォルトのキーバインドを無効化しておく必要があります（[http://wilmer.gaa.st/blog/archives/36-rxvt-unicode-and-ISO-14755-mode.html 詳細]）:

URxvt.iso14755: false
URxvt.iso14755_52: false

=== Perl 拡張の無効化 ===

Perl 拡張機能を使っていない場合、完全に Perl 拡張を無効化することでセキュリティと性能を高めることができます:
URxvt.perl-ext:
URxvt.perl-ext-common:

{{Note|複数の Perl 拡張を使うなら、次のようにカンマ区切りに並べて記述することができます: {{ic|URxvt.perl-ext-common:default,matcher,tabbed}}}}}}

=== インプットメソッドのインライン表示 ===
urxvt でインプットメソッドをインライン表示にする場合は、以下を {{ic|~/.Xresources}} に追加します:
URxvt.perl-ext-common: ...,xim-onthespot,...

インプットメソッドの指定とプレエディットタイプの設定も必要になります (''fcitx'' の部分は自分が使用しているインプットメソッドに変更する必要があります):
URxvt.inputMethod: fcitx
URxvt.preeditType: OnTheSpot

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

=== v9.09 にアップグレードした後に透過が機能しない ===

rxvt-unicode の開発者によって壁紙を設定するプログラムとの互換性が大幅に削除されました。対応していない壁紙設定プログラムを使うと透過が機能しなくなります。推奨されている壁紙設定プログラムは以下です:

* [[feh]]
* hsetroot
* esetroot

完全透過を使うには、URxvt.tintColor と URxvt.inheritPixmap をコメントアウトしてください。

=== リモートホスト ===

リモートホストにログインしているときに、urxvt-unicode を使ってテキストモードプログラムを実行すると問題が発生することがあります。その場合は {{Pkg|rxvt-unicode-terminfo}} をリモートホストにインストールするかローカルホストの {{ic|/usr/share/terminfo/r/rxvt-unicode}} をリモートホストの {{ic|~/.terminfo/r/rxvt-unicode}} にコピーすれば解決できます。rxvt-unicode-256color の場合も同様です。

一部のリモートシステムには TERM=xterm と明記しないと自動的にタイトルが変更しないものもあります。それを修正するには、次の行をリモートマシンの .bashrc に追記してください:

PROMPT_COMMAND='echo -ne "\033]0;${USER}@${HOSTNAME}:${PWD}\007"'

=== rxvt-unicode を gmrun ターミナルとして使う ===

他のターミナルとは異なり、urxvt は {{Ic|-e}} への引数としてクォートで囲まれた引数ではなく分割された引数を取ります。この挙動は、クォートで囲まれた引数を期待する gmrun を使うときトラブルになります。これを避けるには、 {{ic|.gmrunrc}} にて gmrun の変数である "Terminal" の前に "eval" を置いてください:

Terminal = eval urxvt
TermExec = ${Terminal} -e

（gmrun はコマンドを実行するのに {{ic|/bin/sh}} を使うため、"eval" は理解されます。）[[Bash]] でいう {{Ic|$@}} と同じように "eval" は {{Ic|-e}} の引数を "分割する" 副作用を持つので、コマンドを urxvt に上手く渡せます。

=== テンキーの出力がおかしい (例: vim) ===

今までに詳細が報告されてないにも関わらず、一部のDebian GNU/Linux ユーザはこの症状に遭遇することがあります。TERM=rxvt が互換性あるキーマップを提供していても、どの設定でどのようにして起こるのか不明にも関わらず、間違った TERM 設定によりこの問題が起こる可能性があります。この問題に対する解決策を確認でき、助けになるならレポートしてください。

ただ、''xmodmap'' プログラム ({{Pkg|xorg-xmodmap}}) を使い、テンキーをリマップすることができます。

1. {{ic|xev}} プログラム使用時にて数字キー（テンキー）が生成するキーコードを確認。

* {{ic|xev}} プログラムを起動します
* キーコードを入力して {{ic|xev}} が出力する ''... keycode xxx ...'' を探してください。例えば、私のキーボードのテンキー1だと ''''keycode 87'''' を持つ "End" キーでもあります。

2. 大抵の場合 {{ic|~/.Xmodmap}} に置く、キーコードを表現する xmodmap ファイルを作成か変更。

数字キーの xmodmap ファイル例は次です:

{{bc|1=
keycode 63 = KP_Multiply
keycode 79 = Home KP_7
keycode 80 = Up KP_8
keycode 81 = Prior KP_9
keycode 82 = KP_Subtract
keycode 83 = Left KP_4
keycode 84 = KP_5
keycode 85 = Right KP_6
keycode 86 = KP_Add
keycode 87 = End KP_1
keycode 88 = Down KP_2
keycode 89 = Next KP_3
keycode 90 = Insert KP_0
keycode 91 = Delete KP_Decimal
keycode 112 = Prior
keycode 117 = Next
}}

3. xmodmap フィアルを X セッションの起動時に読み込む。

例えば、次の行を {{ic|~/.xinitrc}} に追記します:

...
xmodmap ~/.Xmodmap
...

=== 特定のキーの組み合わせが機能しない ===

[http://vim.wikia.com/wiki/Get_Alt_key_to_work_in_terminal?useskin=monobook Get Alt key to work in terminal] を見てください。

=== 文字を表示するときに遅くなる ===

alsamixer や xprop といったプログラムのなかにはグラフィックドライバが上手く動かず再描画が酷く遅くなるものがあります。これは {{ic|~/.Xresources}} のオプションである "skipBuiltinGlyphs" かコマンドラインオプションである {{ic|-sbg}} によって修正できるかもしれません。1つの解決策として {{ic|~/.Xresources}} に次の行を追記してください:

URxvt*skipBuiltinGlyphs: true

=== 長い行で動作が遅くなる ===

{{ic|matcher}} プラグインが原因かもしれません。{{ic|matcher}} プラグインは行が更新される度にその行に対して正規表現によるマッチを行うため、巨大な {{ic|saveLines}} を持っていると {{ic|saveLines}} の最大まで行を読み込みこの問題が悪化します。

シンプルな回避方法は次です:

* {{ic|saveLines}} を小さくする
* {{ic|matcher}} プラグインを無効にする

これらがどうしても欲しいオプションで削除できないなら、特定の長さでURLマッチを無効化させることもできます:

# {{ic|/usr/lib/urxvt/perl/matcher}} を {{ic|~/.urxvt/ext/}} へコピーします（ディレクトリがない場合は作成してください）
# {{ic|~/.urxvt/ext/matcher}} を編集します。サブルーチンである {{ic|on_line_update}} の {{ic|<nowiki>my ($self, $row) = @_;</nowiki>}} の行を見付けてください。270行目のはずです。
# その行の後に、次の行を追加してください {{ic|return () if $row < -100;}} 。これでターミナル上部から100行超える行でのURLマッチ動作を防げます。

== 参照 ==

* [http://software.schmorp.de/pkg/rxvt-unicode.html rxvt-unicode] - 公式サイト
* [http://cvs.schmorp.de/rxvt-unicode/ Source Code] - Browseable CVS
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod rxvt-unicode FAQ] - 公式 FAQ
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod rxvt-unicode Reference] - 公式マニュアルページ
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/src/urxvt.pm urxvtperl] - 公式 Perl 拡張リファレンス

利用者:R6eve

2018-11-11T02:29:06Z

R6eve: メールアドレスの追加

ニート（Neat）

* GitHub - https://github.com/r6eve/
* Twitter - https://twitter.com/r6eve179f/
* E-Mail - (λx.r6eve179fxgmail.com)@

利用者:R6eve

2018-11-09T05:22:45Z

R6eve: 注釈の追加

ニート（Neat）

* GitHub - https://github.com/r6eve/
* Twitter - https://twitter.com/r6eve179f/

利用者:R6eve

2018-11-09T05:21:07Z

R6eve: 自己紹介ページの作成

Neat

* GitHub - https://github.com/r6eve/
* Twitter - https://twitter.com/r6eve179f/

Rxvt-unicode

2018-11-08T06:20:18Z

R6eve: Perl 拡張セクションの残りを翻訳

{{DISPLAYTITLE:rxvt-unicode}}
[[Category:ターミナルエミュレータ]]
[[de:urxvt]]
[[en:Rxvt-unicode]]
[[es:Rxvt-unicode]]
[[fr:urxvt]]
[[ru:Rxvt-unicode]]
[[sr:Rxvt-unicode]]
{{Related articles start}}
{{Related|rxvt-unicode/ヒントとテクニック}}
{{Related articles end}}
[http://software.schmorp.de/pkg/rxvt-unicode.html rxvt-unicode] は細かいカスタマイズができるターミナルエミュレータで [[Wikipedia:ja:Rxvt|rxvt]] のフォークです。一般に {{Ic|urxvt}} と呼ばれている、rxvt-unicode は[[デーモン]]化して一つの[[Wikipedia:ja:プロセス|プロセス]]で複数のクライアントを実行することができ、システムリソースの使用を抑えることができます。Marc Lehmann によって開発されており、rxvt-unicode の取り柄としては [[Wikipedia:ja:Unicode|Unicode]] による多言語サポートや、透過、複数のフォントタイプの表示機能、[[Perl]] 拡張のサポートなどが挙げられます。

== インストール ==

{{Pkg|rxvt-unicode}} パッケージでインストールすることができます。

== 設定 ==

設定と値の完全なリストは {{man|1|urxvt}} と {{man|7|urxvt}} を見て下さい。

=== ~/.Xresources の作成 ===

rxvt-unicode の外観や機能はコマンドラインの引数や [[X resources]] によって制御されます。コマンドライン引数は [[X resources]] の設定よりも優先して適用されます。

{{ic|urxvt --help}} は全ての ''rxvt'' リソースを標準エラーに出力します。各リソースの説明は man ページに存在します。

=== スクロールバックの位置 ===

デフォルトでは、シェル出力が更新されると、スクロールバックの表示は自動的にバッファの最後にジャンプし、新しい出力を表示します。前の出力（コンパイラメッセージなど）を表示したい場合は {{ic|~/.Xresources}} に以下のオプションを設定します:

! do not scroll with output
URxvt*scrollTtyOutput: false

! scroll in relation to buffer (with mouse scroll or Shift+Page Up)
URxvt*scrollWithBuffer: true

! scroll back to the bottom on keypress
URxvt*scrollTtyKeypress: true

=== セカンダリスクリーンのスクロールバッファ ===

''セカンダリスクリーン''でページャをスクロールすると (例えば {{ic|less}} で {{ic|'''-X'''}} オプションを省略した場合）、端末のバッファではなくページャ内でスクロールできるようスクロールバックバッファを無効にすることをお勧めします。konsole および vte ベースの端末ではデフォルトでこういう仕様になっており動作を変更できません。urxvt で ''セカンダリスクリーン''のスクロールバックバッファを無効にするには:

URxvt.secondaryScreen: 1
URxvt.secondaryScroll: 0

上記の設定は、マウスホイールを使用してスクロールする場合を除いて、期待通りに機能します。マウスホイールでセカンダリスクリーンのページャをスクロールしたとき、スクロールバックバッファに何かがあると、ページャの代わりにスクロールバックバッファがマウスホイールでスクロールされます。この問題を解決するには、rxvt-unicode に新しいオプションを導入する必要があります [https://bbs.archlinux.org/viewtopic.php?id=132150]。AUR の {{aur|rxvt-unicode-better-wheel-scrolling}} でパッチが適用された rxvt-unicode が利用できます。パッケージのインストール後、以下を設定ファイルに追加してください:

URxvt.secondaryWheel: 1

{{Note|perl 拡張の {{AUR|urxvt-vtwheel}} は上記のオプションと衝突します。}}

=== フォントを宣言する方法 ===

URxvt.font: 9x15
上記の設定は以下と同じです:
URxvt.font: -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso8859-1

同じフォントを太字で使用するには:
URxvt.font: 9x15bold
上記の設定は以下と同じです:
URxvt.font: -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso8859-1

X コアフォントの短縮名の完全なリストは {{ic|/usr/share/fonts/misc/fonts.alias}} にあります ({{ic|/usr/share/fonts/}} のサブディレクトリにも fonts.alias ファイルが存在しますが、実際のフォントとは別のパッケージになっているため、インストールされていないフォントも含まれます)。フォントの短縮エイリアスは ISO-10646-1 (Unicode) バージョンではなく ISO-8859-1 バージョンを選択し、100 DPI バージョンではなく 75 DPI バージョンのフォントが使われるため、フォントを選択したいときは長い方の名前を使ってください。

上記はビットマップフォントの話で、他のフォントは以下のように Xft で使うことができます:
URxvt.font: xft:monaco:size=10

または:
URxvt.font: xft:monaco:bold:size=10

{{Note|Xft のフォント名にハイフン(-)が含まれている場合は、バックスラッシュ(\)を2回打ってエスケープしてください。バックスラッシュ1回でエスケープする urxvt の -fn オプションや fc-list の出力とは仕方が異なります。}}

以下のようにターミナルにエスケープコードを出力することで一時的にフォントをテストすることが可能です:
$ printf '\e]710;%s\007' "xft:Terminus:pixelsize=12"

=== フォントの間隔 ===

デフォルトでは文字の間隔が広すぎるように感じられる場合、以下のエントリで調整できます:

{{hc|~/.Xresources|<nowiki>
URxvt.letterSpace: -1
</nowiki>}}

{{ic|-1}} で1ピクセル文字の間隔が狭まります。必要ならばもっと狭めることもできます。

=== カラー ===

デフォルトで、rxvt-unicode はカラーサポートを有効にしてコンパイルされています。デフォルトの前景色・背景色に加えて、rxvt は256色まで表示することができます (太字・点滅・下線とそれらの組み合わせも可能です)。

foreground, background, cursorColor, cursorColor2, colorBD, colorUL は0から15の数字で色を指定することができ、短い名前で color0-color15 の色を使うことができます。詳しくは [[#Xresources]] を参照。

{{Note|デフォルトでは {{ic|urxvt}} は [[Xterm]] と同じ色を使用しますが、ひとつだけ違う色があります。変更するには Xresources に {{ic|URxvt.color12: rgb:5c/5c/ff}} を追加してください。}}

== カットアンドペースト ==

Rxvt-unicode はデフォルトで {{Ic|PRIMARY}} セレクションにロードされているカットバッファを使います。詳しくは [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod#THE_SELECTION_SELECTING_AND_PASTING_ Selecting and pasting text] を見てください。

{{ic|ALT-CTRL-c}} と {{ic|ALT-CTRL-v}} でコピーアンドペーストができます。

{{Note|選択したテキストは自動的に {{ic|PRIMARY}} にコピーされます。{{Pkg|rxvt-unicode}} 9.20 から [[#Perl 拡張|perl 拡張]]の {{ic|selection-to-clipboard}} を使うことでテキストを {{ic|CLIPBOARD}} にコピーできます。}}

[[クリップボード#クリップボードマネージャの一覧]]も参照。

== Perl 拡張 ==

=== クリックできる URL ===

matcher 拡張を使うことでターミナルに表示された URL をクリックできるようになります。例えば、(規定のウェブブラウザを使って) 左マウスボタンでリンクを開くには、以下を {{ic|.Xresources}} に追加します:

URxvt.perl-ext-common: default,matcher
URxvt.url-launcher: /usr/bin/xdg-open
URxvt.matcher.button: 1

rxvt-unicode 9.14 から、キーボードを使って最近閲覧した URL を開いたり確認することもできるようになりました:

URxvt.keysym.C-Delete: perl:matcher:last
URxvt.keysym.M-Delete: perl:matcher:list

マッチするリンクに前景色・背景色といった[[#カラー|色]]を付けることもできます。例えば青色なら次です:

URxvt.matcher.rend.0: Uline Bold fg5

他には、{{ic|colorUL}} を使えば #RRGGBB スタイルでの色付けができます。ただし、これはリンクにマッチした部分だけでなく下線付きテキストのすべてに適用されます:

URxvt.colorUL: #4682B4

=== ヤンクできる URL (マウスを使用しない) ===

また、マウスを使わずに選択したURLをブラウザで開くこともできます。

{{Pkg|urxvt-perls}} パッケージをインストールして適当に {{ic|.Xresources}} を調整してください。例:
URxvt.perl-ext: default,url-select
URxvt.keysym.M-u: perl:url-select:select_next
URxvt.url-select.launcher: /usr/bin/xdg-open
URxvt.url-select.underline: true

{{Note|この拡張は、上で説明したクリックできる URL拡張を置き換えるため、{{Ic|matcher}} を {{Ic|URxvt.perl-ext}} のリストから除外してください。}}

'''キーコマンド:'''

{| class="wikitable"
! キー !! 説明
|-
| Alt+u || 選択モードに移行。スクリーン上にある最後のURLが選択されます。{{ic|Alt+u}} を繰り返せば更に上にあるURLを選択できます。
|-
| k || 上にあるURLを選択
|-
| j || 下にあるURLを選択
|-
| Return || 選択モードを終了して選択したURLをブラウザで開く
|-
| o || 選択モードを終了せずに選択したURLをブラウザで開く
|-
| y || 選択モードを終了して選択したURLをコピーする
|-
| Esc || URL 選択モードをキャンセル。
|}

=== シンプルなタブ ===

urxvt にタブを追加するには、以下を {{ic|~/.Xresources}} に追加します:
URxvt.perl-ext-common: ...,tabbed,...

タブをコントロールするには:

{| class="wikitable"
! キー !! 説明
|-
| Shift+Down || 新しいタブ
|-
| Shift+Left || 左のタブに移動
|-
| Shift+Right || 右のタブに移動
|-
| Ctrl+Left || タブを左に移動
|-
| Ctrl+Right || タブを右に移動
|-
| Ctrl+d || タブを閉じる
|}

タブの色は以下のようにして変更できます:

URxvt.tabbed.tabbar-fg: 2
URxvt.tabbed.tabbar-bg: 0
URxvt.tabbed.tab-fg: 3
URxvt.tabbed.tab-bg: 0

=== フルスクリーン ===

{{AUR|urxvt-fullscreen}} パッケージをインストールして、urxvt をフルスクリーンにするキーバインディングを設定することができます:

{{hc|~/.Xresources|
...
URxvt.perl-ext-common: ..., fullscreen, ...
URxvt.keysym.F11: perl:fullscreen:switch
...
}}

=== フォントサイズを即座に変更 ===

{{AUR|urxvt-resize-font-git}} パッケージをインストールして {{ic|~/.Xresources}} の Perl 拡張に以下を追加してください:

URxvt.perl-ext-common: ...,resize-font,...

デフォルトのキーバインド:
* {{ic|Ctrl++}} (または {{ic|1=Ctrl+Shift+=}}) でサイズを大きくする
* {{ic|Ctrl+-}} でサイズを小さくする
* {{ic|1=Ctrl+=}} でサイズをリセットする
* {{ic|Ctrl+?}} で現在のサイズを表示

以下のようにキーバインドを変更することもできます:

URxvt.keysym.C-Down: resize-font:smaller
URxvt.keysym.C-Up: resize-font:bigger

キーバインドとしてCtrl+Shiftを使うなら、デフォルトのキーバインドを無効化しておく必要があります（[http://wilmer.gaa.st/blog/archives/36-rxvt-unicode-and-ISO-14755-mode.html 詳細]）:

URxvt.iso14755: false
URxvt.iso14755_52: false

=== Perl 拡張の無効化 ===

Perl 拡張機能を使っていない場合、完全に Perl 拡張を無効化することでセキュリティと性能を高めることができます:
URxvt.perl-ext:
URxvt.perl-ext-common:

{{Note|複数の Perl 拡張を使うなら、次のようにカンマ区切りに並べて記述することができます: {{ic|URxvt.perl-ext-common:default,matcher,tabbed}}}}}}

=== インプットメソッドのインライン表示 ===
urxvt でインプットメソッドをインライン表示にする場合は、以下を {{ic|~/.Xresources}} に追加します:
URxvt.perl-ext-common: ...,xim-onthespot,...

インプットメソッドの指定とプレエディットタイプの設定も必要になります (''fcitx'' の部分は自分が使用しているインプットメソッドに変更する必要があります):
URxvt.inputMethod: fcitx
URxvt.preeditType: OnTheSpot

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

=== v9.09 にアップグレードした後に透過が機能しない ===

rxvt-unicode の開発者によって壁紙を設定するプログラムとの互換性が大幅に削除されました。対応していない壁紙設定プログラムを使うと透過が機能しなくなります。推奨されている壁紙設定プログラムは以下です:

* [[feh]]
* hsetroot
* esetroot

完全透過を使うには、URxvt.tintColor と URxvt.inheritPixmap をコメントアウトしてください。

=== リモートホスト ===

リモートホストにログインしているときに、urxvt-unicode を使ってテキストモードプログラムを実行すると問題が発生することがあります。その場合は {{Pkg|rxvt-unicode-terminfo}} をリモートホストにインストールするかローカルホストの {{ic|/usr/share/terminfo/r/rxvt-unicode}} をリモートホストの {{ic|~/.terminfo/r/rxvt-unicode}} にコピーすれば解決できます。rxvt-unicode-256color の場合も同様です。

Some remote systems do not change title automatically unless you specify TERM=xterm. To fix the issue add this line to .bashrc on the remote machine:

PROMPT_COMMAND='echo -ne "\033]0;${USER}@${HOSTNAME}:${PWD}\007"'

=== rxvt-unicode を gmrun ターミナルとして使う ===

Unlike some other terminals, urxvt expects the arguments to {{Ic|-e}} to be given separately, rather than grouped together with quotes. This causes trouble with gmrun, which assumes the opposite behavior. This can be worked around by putting an "eval" in front of gmrun's "Terminal" variable in {{ic|.gmrunrc}}:

Terminal = eval urxvt
TermExec = ${Terminal} -e

(gmrun uses {{ic|/bin/sh}} to execute commands, so the "eval" is understood here.) The "eval" has the side-effect of "breaking up" the argument to {{Ic|-e}} in the same way that {{Ic|$@}} does in [[Bash]], making the command intelligible to urxvt.

=== テンキーの出力がおかしい (例: vim) ===

Some Debian GNU/Linux users seem to have this problem, although no specific details were reported so far. It is possible that this is caused by the wrong TERM setting, although the details of whether and how this can happen are unknown, as TERM=rxvt should offer a compatible keymap. See the answer to the previous question, and please report if that helped.

However, using the ''xmodmap'' program ({{Pkg|xorg-xmodmap}}), you can re-map your number pad keys back.

1. Check the keycode that your numerical keypad (numpad) generates using {{ic|xev}} program.

* Start the {{ic|xev}} program
* Press your number pad keys and look for ''... keycode xxx ...'' in {{ic|xev}}'s output. For example, numpad 1 in my keyboard is also "End" key, that have a ''''keycode 87''''.

2. Create or modify your xmodmap file, usually {{ic|~/.Xmodmap}}, with the content representing your keycode.

Example of xmodmap file with number pad keycode:

{{bc|1=
keycode 63 = KP_Multiply
keycode 79 = Home KP_7
keycode 80 = Up KP_8
keycode 81 = Prior KP_9
keycode 82 = KP_Subtract
keycode 83 = Left KP_4
keycode 84 = KP_5
keycode 85 = Right KP_6
keycode 86 = KP_Add
keycode 87 = End KP_1
keycode 88 = Down KP_2
keycode 89 = Next KP_3
keycode 90 = Insert KP_0
keycode 91 = Delete KP_Decimal
keycode 112 = Prior
keycode 117 = Next
}}

3. Load your xmodmap file at X session start-up.

For example, in {{ic|~/.xinitrc}} file add:

...
xmodmap ~/.Xmodmap
...

=== 特定のキーの組み合わせが機能しない ===

[http://vim.wikia.com/wiki/Get_Alt_key_to_work_in_terminal?useskin=monobook Get Alt key to work in terminal] を見てください。

=== 文字を表示するときに遅くなる ===

Some programs like alsamixer and xprop do not perform well with some graphics drivers and in consequence redraw very slowly. The option "skipBuiltinGlyphs" for {{ic|~/.Xresources}} or the command line option {{ic|-sbg}} may fix this. One possible solution is to add the following to {{ic|~/.Xresources}}:

URxvt*skipBuiltinGlyphs: true

=== 長い行で動作が遅くなる ===

The {{ic|matcher}} plugin may be the culprit here. It must match a regex against a line every time the line updates, and if you have a large {{ic|saveLines}} value this can exacerbate the problem by allowing a very large maximum line length.

There are some simple workarounds:

* Reduce {{ic|saveLines}}
* Disable the {{ic|matcher}} plugin

If neither of those are palatable options, you can compromise by disabling URL matching past a certain cutoff point:

# Copy {{ic|/usr/lib/urxvt/perl/matcher}} to {{ic|~/.urxvt/ext/}} (creating the directory if necessary)
# Edit {{ic|~/.urxvt/ext/matcher}}, and find the {{ic|<nowiki>my ($self, $row) = @_;</nowiki>}} line in the {{ic|on_line_update}} sub. It should be line 270.
# After that line, insert the line {{ic|return () if $row < -100;}}. This disables URL matching on any line that starts more than 100 rows behind the top of the terminal.

== 参照 ==

* [http://software.schmorp.de/pkg/rxvt-unicode.html rxvt-unicode] - 公式サイト
* [http://cvs.schmorp.de/rxvt-unicode/ Source Code] - Browseable CVS
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod rxvt-unicode FAQ] - 公式 FAQ
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod rxvt-unicode Reference] - 公式マニュアルページ
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/src/urxvt.pm urxvtperl] - 公式 Perl 拡張リファレンス

Rxvt-unicode

2018-11-07T05:17:56Z

R6eve: Xftのエスケープ部分を翻訳

{{DISPLAYTITLE:rxvt-unicode}}
[[Category:ターミナルエミュレータ]]
[[de:urxvt]]
[[en:Rxvt-unicode]]
[[es:Rxvt-unicode]]
[[fr:urxvt]]
[[ru:Rxvt-unicode]]
[[sr:Rxvt-unicode]]
{{Related articles start}}
{{Related|rxvt-unicode/ヒントとテクニック}}
{{Related articles end}}
[http://software.schmorp.de/pkg/rxvt-unicode.html rxvt-unicode] は細かいカスタマイズができるターミナルエミュレータで [[Wikipedia:ja:Rxvt|rxvt]] のフォークです。一般に {{Ic|urxvt}} と呼ばれている、rxvt-unicode は[[デーモン]]化して一つの[[Wikipedia:ja:プロセス|プロセス]]で複数のクライアントを実行することができ、システムリソースの使用を抑えることができます。Marc Lehmann によって開発されており、rxvt-unicode の取り柄としては [[Wikipedia:ja:Unicode|Unicode]] による多言語サポートや、透過、複数のフォントタイプの表示機能、[[Perl]] 拡張のサポートなどが挙げられます。

== インストール ==

{{Pkg|rxvt-unicode}} パッケージでインストールすることができます。

== 設定 ==

設定と値の完全なリストは {{man|1|urxvt}} と {{man|7|urxvt}} を見て下さい。

=== ~/.Xresources の作成 ===

rxvt-unicode の外観や機能はコマンドラインの引数や [[X resources]] によって制御されます。コマンドライン引数は [[X resources]] の設定よりも優先して適用されます。

{{ic|urxvt --help}} は全ての ''rxvt'' リソースを標準エラーに出力します。各リソースの説明は man ページに存在します。

=== スクロールバックの位置 ===

デフォルトでは、シェル出力が更新されると、スクロールバックの表示は自動的にバッファの最後にジャンプし、新しい出力を表示します。前の出力（コンパイラメッセージなど）を表示したい場合は {{ic|~/.Xresources}} に以下のオプションを設定します:

! do not scroll with output
URxvt*scrollTtyOutput: false

! scroll in relation to buffer (with mouse scroll or Shift+Page Up)
URxvt*scrollWithBuffer: true

! scroll back to the bottom on keypress
URxvt*scrollTtyKeypress: true

=== セカンダリスクリーンのスクロールバッファ ===

''セカンダリスクリーン''でページャをスクロールすると (例えば {{ic|less}} で {{ic|'''-X'''}} オプションを省略した場合）、端末のバッファではなくページャ内でスクロールできるようスクロールバックバッファを無効にすることをお勧めします。konsole および vte ベースの端末ではデフォルトでこういう仕様になっており動作を変更できません。urxvt で ''セカンダリスクリーン''のスクロールバックバッファを無効にするには:

URxvt.secondaryScreen: 1
URxvt.secondaryScroll: 0

上記の設定は、マウスホイールを使用してスクロールする場合を除いて、期待通りに機能します。マウスホイールでセカンダリスクリーンのページャをスクロールしたとき、スクロールバックバッファに何かがあると、ページャの代わりにスクロールバックバッファがマウスホイールでスクロールされます。この問題を解決するには、rxvt-unicode に新しいオプションを導入する必要があります [https://bbs.archlinux.org/viewtopic.php?id=132150]。AUR の {{aur|rxvt-unicode-better-wheel-scrolling}} でパッチが適用された rxvt-unicode が利用できます。パッケージのインストール後、以下を設定ファイルに追加してください:

URxvt.secondaryWheel: 1

{{Note|perl 拡張の {{AUR|urxvt-vtwheel}} は上記のオプションと衝突します。}}

=== フォントを宣言する方法 ===

URxvt.font: 9x15
上記の設定は以下と同じです:
URxvt.font: -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso8859-1

同じフォントを太字で使用するには:
URxvt.font: 9x15bold
上記の設定は以下と同じです:
URxvt.font: -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso8859-1

X コアフォントの短縮名の完全なリストは {{ic|/usr/share/fonts/misc/fonts.alias}} にあります ({{ic|/usr/share/fonts/}} のサブディレクトリにも fonts.alias ファイルが存在しますが、実際のフォントとは別のパッケージになっているため、インストールされていないフォントも含まれます)。フォントの短縮エイリアスは ISO-10646-1 (Unicode) バージョンではなく ISO-8859-1 バージョンを選択し、100 DPI バージョンではなく 75 DPI バージョンのフォントが使われるため、フォントを選択したいときは長い方の名前を使ってください。

上記はビットマップフォントの話で、他のフォントは以下のように Xft で使うことができます:
URxvt.font: xft:monaco:size=10

または:
URxvt.font: xft:monaco:bold:size=10

{{Note|Xft のフォント名にハイフン(-)が含まれている場合は、バックスラッシュ(\)を2回打ってエスケープしてください。バックスラッシュ1回でエスケープする urxvt の -fn オプションや fc-list の出力とは仕方が異なります。}}

以下のようにターミナルにエスケープコードを出力することで一時的にフォントをテストすることが可能です:
$ printf '\e]710;%s\007' "xft:Terminus:pixelsize=12"

=== フォントの間隔 ===

デフォルトでは文字の間隔が広すぎるように感じられる場合、以下のエントリで調整できます:

{{hc|~/.Xresources|<nowiki>
URxvt.letterSpace: -1
</nowiki>}}

{{ic|-1}} で1ピクセル文字の間隔が狭まります。必要ならばもっと狭めることもできます。

=== カラー ===

デフォルトで、rxvt-unicode はカラーサポートを有効にしてコンパイルされています。デフォルトの前景色・背景色に加えて、rxvt は256色まで表示することができます (太字・点滅・下線とそれらの組み合わせも可能です)。

foreground, background, cursorColor, cursorColor2, colorBD, colorUL は0から15の数字で色を指定することができ、短い名前で color0-color15 の色を使うことができます。詳しくは [[#Xresources]] を参照。

{{Note|デフォルトでは {{ic|urxvt}} は [[Xterm]] と同じ色を使用しますが、ひとつだけ違う色があります。変更するには Xresources に {{ic|URxvt.color12: rgb:5c/5c/ff}} を追加してください。}}

== カットアンドペースト ==

Rxvt-unicode はデフォルトで {{Ic|PRIMARY}} セレクションにロードされているカットバッファを使います。詳しくは [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod#THE_SELECTION_SELECTING_AND_PASTING_ Selecting and pasting text] を見てください。

{{ic|ALT-CTRL-c}} と {{ic|ALT-CTRL-v}} でコピーアンドペーストができます。

{{Note|選択したテキストは自動的に {{ic|PRIMARY}} にコピーされます。{{Pkg|rxvt-unicode}} 9.20 から [[#Perl 拡張|perl 拡張]]の {{ic|selection-to-clipboard}} を使うことでテキストを {{ic|CLIPBOARD}} にコピーできます。}}

[[クリップボード#クリップボードマネージャの一覧]]も参照。

== Perl 拡張 ==

=== クリックできる URL ===

matcher 拡張を使うことでターミナルに表示された URL をクリックできるようになります。例えば、(規定のウェブブラウザを使って) 左マウスボタンでリンクを開くには、以下を {{ic|.Xresources}} に追加します:

URxvt.perl-ext-common: default,matcher
URxvt.url-launcher: /usr/bin/xdg-open
URxvt.matcher.button: 1

rxvt-unicode 9.14 から、キーボードを使って最近閲覧した URL を開いたり確認することもできるようになりました:

URxvt.keysym.C-Delete: perl:matcher:last
URxvt.keysym.M-Delete: perl:matcher:list

Matching links can be colored with a chosen foreground or background [[#Colors|color]], for example blue:

URxvt.matcher.rend.0: Uline Bold fg5

Alternatively, use {{ic|colorUL}} for a #RRGGBB color. This will however color all underlined text, instead of only link matches:

URxvt.colorUL: #4682B4

=== ヤンクできる URL (マウスを使用しない) ===

In addition, you can select and open URLs in your web browser without using the mouse.

{{Pkg|urxvt-perls}} パッケージをインストールして適当に {{ic|.Xresources}} を調整してください。例:
URxvt.perl-ext: default,url-select
URxvt.keysym.M-u: perl:url-select:select_next
URxvt.url-select.launcher: /usr/bin/xdg-open
URxvt.url-select.underline: true

{{Note|This extension replaces the Clickable URLs extension mentioned above, so {{Ic|matcher}} can be removed from the {{Ic|URxvt.perl-ext}} list.}}

'''キーコマンド:'''

{| class="wikitable"
! キー !! 説明
|-
| Alt+u || Enter selection mode. The last URL on your screen will be selected. You can repeat {{ic|Alt+u}} to select the next upward URL.
|-
| k || Select next upward URL
|-
| j || Select next downward URL
|-
| Return || Open selected URL in browser and quit selection mode
|-
| o || Open selected URL in browser without quitting selection mode
|-
| y || Copy (yank) selected URL and quit selection mode
|-
| Esc || URL 選択モードをキャンセル。
|}

=== シンプルなタブ ===

urxvt にタブを追加するには、以下を {{ic|~/.Xresources}} に追加します:
URxvt.perl-ext-common: ...,tabbed,...

タブをコントロールするには:

{| class="wikitable"
! キー !! 説明
|-
| Shift+Down || 新しいタブ
|-
| Shift+Left || 左のタブに移動
|-
| Shift+Right || 右のタブに移動
|-
| Ctrl+Left || タブを左に移動
|-
| Ctrl+Right || タブを右に移動
|-
| Ctrl+d || タブを閉じる
|}

タブの色は以下のようにして変更できます:

URxvt.tabbed.tabbar-fg: 2
URxvt.tabbed.tabbar-bg: 0
URxvt.tabbed.tab-fg: 3
URxvt.tabbed.tab-bg: 0

=== フルスクリーン ===

{{AUR|urxvt-fullscreen}} パッケージをインストールして、urxvt をフルスクリーンにするキーバインディングを設定することができます:

{{hc|~/.Xresources|
...
URxvt.perl-ext-common: ..., fullscreen, ...
URxvt.keysym.F11: perl:fullscreen:switch
...
}}

=== フォントサイズを即座に変更 ===

{{AUR|urxvt-resize-font-git}} パッケージをインストールして {{ic|~/.Xresources}} の Perl 拡張に以下を追加してください:

URxvt.perl-ext-common: ...,resize-font,...

デフォルトのキーバインド:
* {{ic|Ctrl++}} (または {{ic|1=Ctrl+Shift+=}}) でサイズを大きくする
* {{ic|Ctrl+-}} でサイズを小さくする
* {{ic|1=Ctrl+=}} でサイズをリセットする
* {{ic|Ctrl+?}} で現在のサイズを表示

以下のようにキーバインドを変更することもできます:

URxvt.keysym.C-Down: resize-font:smaller
URxvt.keysym.C-Up: resize-font:bigger

For the suggested Ctrl+Shift bindings to work, a default binding needs to be disabled (see discussion [http://wilmer.gaa.st/blog/archives/36-rxvt-unicode-and-ISO-14755-mode.html here]):

URxvt.iso14755: false
URxvt.iso14755_52: false

=== Perl 拡張の無効化 ===

Perl 拡張機能を使っていない場合、完全に Perl 拡張を無効化することでセキュリティと性能を高めることができます:
URxvt.perl-ext:
URxvt.perl-ext-common:

{{Note|If you use multiple Perl extension features, you can list them in succession, comma-separated: {{ic|URxvt.perl-ext-common:default,matcher,tabbed.}}}}

=== インプットメソッドのインライン表示 ===
urxvt でインプットメソッドをインライン表示にする場合は、以下を {{ic|~/.Xresources}} に追加します:
URxvt.perl-ext-common: ...,xim-onthespot,...

インプットメソッドの指定とプレエディットタイプの設定も必要になります (''fcitx'' の部分は自分が使用しているインプットメソッドに変更する必要があります):
URxvt.inputMethod: fcitx
URxvt.preeditType: OnTheSpot

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

=== v9.09 にアップグレードした後に透過が機能しない ===

rxvt-unicode の開発者によって壁紙を設定するプログラムとの互換性が大幅に削除されました。対応していない壁紙設定プログラムを使うと透過が機能しなくなります。推奨されている壁紙設定プログラムは以下です:

* [[feh]]
* hsetroot
* esetroot

完全透過を使うには、URxvt.tintColor と URxvt.inheritPixmap をコメントアウトしてください。

=== リモートホスト ===

リモートホストにログインしているときに、urxvt-unicode を使ってテキストモードプログラムを実行すると問題が発生することがあります。その場合は {{Pkg|rxvt-unicode-terminfo}} をリモートホストにインストールするかローカルホストの {{ic|/usr/share/terminfo/r/rxvt-unicode}} をリモートホストの {{ic|~/.terminfo/r/rxvt-unicode}} にコピーすれば解決できます。rxvt-unicode-256color の場合も同様です。

Some remote systems do not change title automatically unless you specify TERM=xterm. To fix the issue add this line to .bashrc on the remote machine:

PROMPT_COMMAND='echo -ne "\033]0;${USER}@${HOSTNAME}:${PWD}\007"'

=== rxvt-unicode を gmrun ターミナルとして使う ===

Unlike some other terminals, urxvt expects the arguments to {{Ic|-e}} to be given separately, rather than grouped together with quotes. This causes trouble with gmrun, which assumes the opposite behavior. This can be worked around by putting an "eval" in front of gmrun's "Terminal" variable in {{ic|.gmrunrc}}:

Terminal = eval urxvt
TermExec = ${Terminal} -e

(gmrun uses {{ic|/bin/sh}} to execute commands, so the "eval" is understood here.) The "eval" has the side-effect of "breaking up" the argument to {{Ic|-e}} in the same way that {{Ic|$@}} does in [[Bash]], making the command intelligible to urxvt.

=== テンキーの出力がおかしい (例: vim) ===

Some Debian GNU/Linux users seem to have this problem, although no specific details were reported so far. It is possible that this is caused by the wrong TERM setting, although the details of whether and how this can happen are unknown, as TERM=rxvt should offer a compatible keymap. See the answer to the previous question, and please report if that helped.

However, using the ''xmodmap'' program ({{Pkg|xorg-xmodmap}}), you can re-map your number pad keys back.

1. Check the keycode that your numerical keypad (numpad) generates using {{ic|xev}} program.

* Start the {{ic|xev}} program
* Press your number pad keys and look for ''... keycode xxx ...'' in {{ic|xev}}'s output. For example, numpad 1 in my keyboard is also "End" key, that have a ''''keycode 87''''.

2. Create or modify your xmodmap file, usually {{ic|~/.Xmodmap}}, with the content representing your keycode.

Example of xmodmap file with number pad keycode:

{{bc|1=
keycode 63 = KP_Multiply
keycode 79 = Home KP_7
keycode 80 = Up KP_8
keycode 81 = Prior KP_9
keycode 82 = KP_Subtract
keycode 83 = Left KP_4
keycode 84 = KP_5
keycode 85 = Right KP_6
keycode 86 = KP_Add
keycode 87 = End KP_1
keycode 88 = Down KP_2
keycode 89 = Next KP_3
keycode 90 = Insert KP_0
keycode 91 = Delete KP_Decimal
keycode 112 = Prior
keycode 117 = Next
}}

3. Load your xmodmap file at X session start-up.

For example, in {{ic|~/.xinitrc}} file add:

...
xmodmap ~/.Xmodmap
...

=== 特定のキーの組み合わせが機能しない ===

[http://vim.wikia.com/wiki/Get_Alt_key_to_work_in_terminal?useskin=monobook Get Alt key to work in terminal] を見てください。

=== 文字を表示するときに遅くなる ===

Some programs like alsamixer and xprop do not perform well with some graphics drivers and in consequence redraw very slowly. The option "skipBuiltinGlyphs" for {{ic|~/.Xresources}} or the command line option {{ic|-sbg}} may fix this. One possible solution is to add the following to {{ic|~/.Xresources}}:

URxvt*skipBuiltinGlyphs: true

=== 長い行で動作が遅くなる ===

The {{ic|matcher}} plugin may be the culprit here. It must match a regex against a line every time the line updates, and if you have a large {{ic|saveLines}} value this can exacerbate the problem by allowing a very large maximum line length.

There are some simple workarounds:

* Reduce {{ic|saveLines}}
* Disable the {{ic|matcher}} plugin

If neither of those are palatable options, you can compromise by disabling URL matching past a certain cutoff point:

# Copy {{ic|/usr/lib/urxvt/perl/matcher}} to {{ic|~/.urxvt/ext/}} (creating the directory if necessary)
# Edit {{ic|~/.urxvt/ext/matcher}}, and find the {{ic|<nowiki>my ($self, $row) = @_;</nowiki>}} line in the {{ic|on_line_update}} sub. It should be line 270.
# After that line, insert the line {{ic|return () if $row < -100;}}. This disables URL matching on any line that starts more than 100 rows behind the top of the terminal.

== 参照 ==

* [http://software.schmorp.de/pkg/rxvt-unicode.html rxvt-unicode] - 公式サイト
* [http://cvs.schmorp.de/rxvt-unicode/ Source Code] - Browseable CVS
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod rxvt-unicode FAQ] - 公式 FAQ
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod rxvt-unicode Reference] - 公式マニュアルページ
* [http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/src/urxvt.pm urxvtperl] - 公式 Perl 拡張リファレンス

SSHFS

2018-11-02T05:07:33Z

R6eve: 誤字修正

[[Category:ファイルシステム]]
[[Category:Secure Shell]]
[[en:SSHFS]]
[[es:SSHFS]]
[[it:Sshfs]]
[[ru:SSHFS]]
[[zh-hans:SSHFS]]
{{Related articles start}}
{{Related|SCP と SFTP}}
{{Related|SFTP chroot}}
{{Related|Pure-FTPd}}
{{Related|SSH}}
{{Related|sftpman}}
{{Related articles end}}
sshfs を使うことで ([[SSH]] でアクセスできる) リモートシステムをローカルフォルダにマウントすることができます。ツールを使ってマウントしたファイルを様々に操作することが可能です (コピー、名前を変更、vim で編集など)。基本的に shfs の代わりに sshfs を使うことが推奨されます。shfs の新しいバージョンは2004年からリリースされていません。

== インストール ==

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

=== マウント ===
ディレクトリをマウントする前に、対象のディレクトリのファイルパーティションが正しく設定されているか (ユーザーがアクセスできるか) 確認してください。マウントするには、{{ic|sshfs}} を実行してリモートディレクトリをマウントします:
$ sshfs ''[user@]host:[dir] mountpoint [options]''

例:
$ sshfs sessy@mycomputer:/remote/path /local/path -C -p 9876 -o allow_other
{{ic|-p 9876}} はポート番号、{{ic|-C}} は圧縮の使用、{{ic|-o allow_other}} は root 以外のユーザーの読み書きの許可です。

{{Note|
* {{ic|allow_other}} オプションはデフォルトで無効になっています。有効にするには {{ic|/etc/fuse.conf}} の {{ic|user_allow_other}} 行をアンコメントして root 以外のユーザーが allow_other マウントオプションを使えるようにしてください。
* -p スイッチを使うのが面倒な場合、{{ic|~/.ssh/config}} でホストごとに非標準ポートを定義することもできます。詳しくは [[Secure Shell#ssh の設定に接続データを保存する]] を参照。}}

必要であれば、SSH はパスワードを尋ねます。何度もパスワードを入力したくない場合は、[[SSH 鍵]]を読んでください。

{{Tip|[[Google Authenticator]] を使うことで sshfs のセキュリティを向上させることができます。}}

=== アンマウント ===

リモートシステムをアンマウントするには:
$ fusermount -u ''local_mount_point''
例:
$ fusermount -u /mnt/sessy

== Chroot ==

(特定の) ユーザーをディレクトリに閉じ込めたい場合、{{ic|/etc/ssh/sshd_config}} を編集してください:

{{hc|/etc/ssh/sshd_config|.....
Match User someuser
ChrootDirectory /chroot/%u
ForceCommand internal-sftp #to restrict the user to sftp only
AllowTcpForwarding no
X11Forwarding no
.....}}

{{Note|chroot ディレクトリの所有者は root である必要があります。そうでない場合、接続ができません。詳しくは man ページで {{ic|Match, ChrootDirectory}} や {{ic|ForceCommand}} を確認してください。}}

== ヘルパー ==

sshfs ファイルシステムを頻繁にマウントする必要がある場合、[[sftpman]] などの sshfs ヘルパーを使うと良いでしょう。

コマンドラインと GTK のフロントエンドが入っており、マウントやアンマウントをワンクリックで行うことができるようになります。

== 自動マウント ==

起動時や、必要に応じて (ディレクトリのアクセス時に)、自動マウントを行うことができます。どちらにしても、セットアップは {{ic|/etc/[[fstab]]}} で行います。

{{Note|自動マウントは root ユーザーによって行われるため、通常ユーザーの {{ic|.ssh/config}} で設定した Hosts は使えなくなります。root ユーザーで通常ユーザーの SSH 鍵を使うときは、{{ic|IdentityFile}} オプションにフルパスを指定してください。そして、ホストの署名が {{ic|.ssh/known_hosts}} ファイルに追加されるように root で一度は手動で sshfs マウントを使用します。}}

=== 必要に応じてマウント ===

{{ic|/etc/fstab}} エントリを使うことで systemd でオンデマンドのマウントを行えます。

例:
user@host:/remote/folder /mount/point fuse.sshfs noauto,x-systemd.automount,_netdev,users,idmap=user,IdentityFile=/home/user/.ssh/id_rsa,allow_other,reconnect 0 0
ここで重要なマウントオプションは ''noauto,x-systemd.automount,_netdev'' です。
* ''noauto'' で起動時にマウントしないように設定します。
* ''x-systemd.automount'' によって必要になったときにマウントします。
* ''_netdev'' はブロックデバイスではなくネットワークデバイスであることを指定します (''_netdev'' がないと "No such device" エラーが発生します)。

{{Tip|{{AUR|autosshfs-git}} は新しいマウントポイントを追加するのに {{ic|/etc/fstab}} を編集する必要がなくなり、(autosshfs が有効になった) 通常ユーザーがアクセスしようとしただけで作成されます (例: {{ic|ls ~/mnt/ssh/[user@]yourremotehost[:port]}})。{{AUR|autosshfs-git}} は AutoFS を使います。{{ic|autosshfs-user}} で使用するユーザーを有効にする必要があります。}}

=== 起動時にマウント ===

{{ic|/etc/[[fstab]]}} で sshfs を使ってリモートのファイルシステムをマウントする例:
USERNAME@HOSTNAME_OR_IP:/REMOTE/DIRECTORY /LOCAL/MOUNTPOINT fuse.sshfs defaults,_netdev 0 0

''fstab'' の行の例:
llib@192.168.1.200:/home/llib/FAH /media/FAH2 fuse.sshfs defaults,_netdev 0 0
ユーザーの SSH 鍵を使っている場合、自動的に動作するようになります。[[SSH 鍵]]を見て下さい。

複数のユーザーで sshfs を使いたい場合:
user@domain.org:/home/user /media/user fuse.sshfs defaults,allow_other,_netdev 0 0

マウントする前にネットワークが有効になっていることを確認するために ''_netdev'' マウントオプションを設定することが重要です。

=== ユーザーアクセスのセキュア化 ===

{{ic|/etc/[[fstab]]}} で自動マウントする場合、ファイルシステムは基本的に root によってマウントされます。デフォルトでは、通常ユーザーとしてアクセスして他のユーザーのアクセスを制限したいときに予期しない結果を招くことがあります。

マウントポイントの設定例:

USERNAME@HOSTNAME_OR_IP:/REMOTE/DIRECTORY /LOCAL/MOUNTPOINT fuse.sshfs noauto,x-systemd.automount,_netdev,user,idmap=user,follow_symlinks,identityfile=/home/USERNAME/.ssh/id_rsa,allow_other,default_permissions,uid=USER_ID_N,gid=USER_GID_N 0 0

オプションの説明:

* ''allow_other'' - root 以外のユーザーが共有フォルダにアクセスすることを許可します。
* ''default_permissions'' - カーネルからパーミッションを確認することを許可します。リモートファイルシステムの実際のパーミッションが使われます。''allow_other'' によって許可されたユーザー以外にも制限的なアクセスを許可します。
* ''uid'', ''gid'' - ファイルの所有権を特定の値に設定します。''uid'' にはユーザーの ID、''gid'' にはユーザーのグループ ID を指定します。

== オプション ==

sshfs はローカル・リモートのユーザー ID を自動的に変換することができます。

''idmap'' オプションを ''user'' に設定することで接続するユーザーの UID が変換されます:

# sshfs -o idmap=user sessy@mycomputer:/home/sessy /mnt/sessy -C -p 9876

上記のコマンドはリモートのユーザー "sessy" の UID をプロセスを実行しているローカルユーザーにマッピングします (上記の例では "root")。GID は変わりません。UID と GID 変換を細かく制御する必要がある場合、''idmap=file'' オプションと ''uidfile'' と ''gidfile'' を見てください。

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

=== チェックリスト ===

[[Secure_Shell#チェックリスト|SSH のチェックリスト]]を最初に読んで、以下を確認してください:

1. SSH ログインでサーバーの {{ic|/etc/issue}} ファイルから情報を送信している場合、SSHFS が混乱してしまいます。サーバーの {{ic|/etc/issue}} ファイルは無効にしてください:

$ mv /etc/issue /etc/issue.orig

2. ウェブ上の SSH 関連のトラブルシューティング記事のほとんどは Systemd を考慮していません。{{ic|/etc/fstab}} の定義が {{ic|''sshfs#''user@host:/mnt/server/folder ... fuse ...}} から始まる間違ったものであることはしばしばで、{{ic|user@host:/mnt/server/folder ... fuse.''sshfs'' ... ''x-systemd'', ...}} が正しい構文になります。

3. サーバーのソースフォルダとコンテンツがサーバーのユーザーによって所有されていることを確認してください。

$ chown -R USER_S: /mnt/servers/folder

4. サーバーのユーザー ID とクライアントのユーザー ID が異なっている可能性があります。当然ユーザー名は同一である必要があります。クライアントのユーザー ID に注意してください。SSHFS は以下のマウントオプションで UID を変換します:

uid=''USER_C_ID'',gid=''GROUP_C_ID''

5. クライアントのターゲットマウントポイント (フォルダ) がクライアントのユーザーによって所有されていることを確認してください。SSHFS のマウントオプションで指定したユーザー ID と同じである必要があります。

$ chown -R USER_C: /mnt/client/folder

6. クライアントのマウントポイント (フォルダ) が空であることを確認してください。デフォルトでは SSHFS のフォルダを空でないフォルダにマウントすることはできませ。

7. {{ic|/etc/fstab}} で SSH 公開鍵認証を使って SSH 共有を自動マウントしたい場合、以下のように設定してください:

''USER_S''@''SERVER'':/mnt/on/server /nmt/on/client fuse.sshfs x-systemd.automount,_netdev,user,idmap=user,transform_symlinks,identityfile=/home/''USER_C''/.ssh/id_rsa,allow_other,default_permissions,uid=''USER_C_ID'',gid=''GROUP_C_ID'',umask=0 0 0

設定例:

SERVER = Server host name (serv)
USER_S = Server user name (pete)
USER_C = Client user name (pete)
USER_S_ID = Server user ID (1004)
USER_C_ID = Client user ID (1000)
GROUP_C_ID = Client user's group ID (100)

クライアントユーザーの ID とグループ ID は以下のコマンドで確認できます:

$ id USERNAME

実際に {{ic|/etc/fstab}} に設定する行は以下のようになります:

pete@serv:/mnt/on/server /nmt/on/client fuse.sshfs x-systemd.automount,_netdev,user,idmap=user,transform_symlinks,identityfile=/home/pete/.ssh/id_rsa,allow_other,default_permissions,uid=1004,gid=1000,umask=0 0 0

8. チェックリストに追加するべきことが他にもあるのであれば追加してください。

=== ピアによって接続がリセットされる ===

* ホストネームを使ってリモートマシンにアクセスしようとしている場合、ドメイン名が解決できないのが原因かもしれないので、IP アドレスを使って接続してみてください。{{ic|/etc/hosts}} を編集してサーバーの設定が正しいことを確認してください。
* デフォルトではないキーの名前を使っている場合、{{ic|-i .ssh/my_key}} と指定しても意味がありません。{{ic|-o IdentityFile<nowiki>=</nowiki>/home/user/.ssh/my_key}} のようにキーのフルパスを使う必要があります。
* {{ic|sshfs_debug}} オプションを追加することで問題の解決に役に立つ情報が得られます ({{ic|sshfs -o sshfs_debug user@server ...}})。
* 何も有用な情報が得られないときは、{{ic|debug}} オプションも追加してみてください。
* sshfs で DD-WRT などが動作しているルーターに接続する場合、[http://www.dd-wrt.com/wiki/index.php/SFTP_with_DD-WRT こちら] に解決方法が載っています (dropbear にパッチをあてるかわりに sshfs コマンドで {{ic|1=-osftp_server=/opt/libexec/sftp-server}} オプションを使うこともできます)。
* 古いフォーラムスレッド: [https://bbs.archlinux.org/viewtopic.php?id=27613 sshfs: Connection reset by peer]
* ユーザーを使ってサーバーにログインできることを確認してください (特に AllowUsers を使用する場合)。
* {{ic|/etc/ssh/sshd_config}} で {{ic|Subsystem sftp /usr/lib/ssh/sftp-server}} が有効になっていることを確認してください。

{{Note|sshfs に複数のオプションを指定する場合、カンマで区切る必要があります。例: {{ic|sshfs -o sshfs_debug,IdentityFile<nowiki>=</nowiki></path/to/key> user@server ...}}。}}

=== Remote host has disconnected ===

''sshfs'' を使おうとした直後にこのメッセージが表示される場合:
* まず'''リモート'''マシンに ''sftp'' がインストールされていることを確認してください。インストールしていないと、動作しません。
{{Tip|リモートサーバーで OpenWRT を動かしている場合: {{ic|opkg install openssh-sftp-server}} でインストールできます。}}
* それから、リモートマシンの {{ic|/etc/ssh/sshd_config}} に記載されている {{ic|Subsystem}} のパスが正しいかどうか確認してください。パスは {{ic|find / -name sftp-server}} で確認できます。

Arch Linux では {{ic|/etc/ssh/sshd_config}} のデフォルト値は {{ic|Subsystem sftp /usr/lib/ssh/sftp-server}} です。

=== Thunar と FAM のリモートファイルの問題 ===

リモートフォルダが表示されず、ホームディレクトリに戻ってしまう場合、あるいは Thunar で他のリモートファイルにアクセスできない場合、FAM を {{Pkg|gamin}} で置き換えてください。Gamin は FAM の後継です。

=== アプリがフリーズする (例: Nautilus, Gedit) ===
{{Note|下記の設定をすると最近使用したファイルのリストが作られなくなります。また、書き込みエラーが発生することがあります。}}

アプリケーションがフリーズする (反応しなくなる) 場合、{{ic|~/recently-used.xbel}} の書き込み権限を無効化する必要があるかもしれません:

# chattr +i /home/USERNAME/.local/share/recently-used.xbel

詳しくは次の [https://bugs.archlinux.org/task/40260 バグレポート] を見て下さい。

=== sshfs をマウントされているときにシャットダウンでフリーズ ===

sshfs を手動でマウントして、シャットダウン前にアンマウントしていなかった場合、systemd がシャットダウン時にフリーズすることがあります。この問題を解決するには、以下のファイルを (root で) 作成してください:
{{hc|/etc/systemd/system/killsshfs.service|<nowiki>
[Unit]
After=network.target

[Service]
RemainAfterExit=yes
ExecStart=-/bin/true
ExecStop=-/usr/bin/pkill -x sshfs

[Install]
WantedBy=multi-user.target
</nowiki>}}
そしてサービスを有効化します: {{ic|systemctl enable killsshfs.service}}

=== fstab によるマウントの問題 ===

詳細な出力を得たい場合、マウントオプションに以下を追加してください:

ssh_command=ssh\040-vv,sshfs_debug,debug
{{Note|上記の {{ic|\040}} は fstab でフィールドを区切るのに使うスペースを意味します。}}

{{ic|mount -av}} を実行してデバッグ出力を確認するために、以下のオプションを削除してください:
noauto,x-systemd.automount

== 参照 ==

* [http://wiki.gilug.org/index.php/How_to_mount_SFTP_accesses How to mount chrooted SSH filesystem], with special care with owners and permissions questions.
* [http://www.admin-magazine.com/HPC/Articles/Sharing-Data-with-SSHFS SSHFS – Installation and Performance] — NFS との比較と最適化ヒント。