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

AVR

2024-08-17T06:05:33Z

Shota: 英語版に同期し翻訳ステータスを付与

[[カテゴリ:開発]]
[[en:AVR]]
[[Wikipedia:AVR_microcontrollers|AVR]] は Microchip Technology 社 (以前は Atmel 社でしたが買収されました)によって開発されているマイクロコントローラ (MCU) の一種です。 AVR は [[Arduino]] プロジェクトに代表される様に、とりわけホビーや教育用途で広まっています。このページでは、これらのMCUの8ビットシリーズを扱います。

== ツールチェイン ==

ツールチェインと GNU コンパイラのために {{Pkg|avr-gcc}} を[[インストール]]して下さい。

== プログラマー (書込器） ==
AVR チップへ作成したプログラムを書き込むためには、プログラマーと、それを行うソフトウェアが必要です。有名なプログラマーには [https://www.fischl.de/usbasp USBasp]や[https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/ATAVRISP2 AVRISP mkII]、[https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE Atmel-ICE]、[https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/ATSTK500 STK500]があります。 LPT ポートで動く単純な DIY プログラマーである [https://www.olimex.com/Products/AVR/Programmers/AVR-PG2B AVR-PG2B] などもあります。 {{Pkg|avrdude}} は、これらも含めて多くのプログラマーをサポートします。

=== udev ルール ===

{{Pkg|avrdue}} を root 権限なしで動かすには次の様な [[Udev]] ルールを作ってください。この udev ルールによって、指定の USB デバイスを取り扱う権限を他のグループに移します ({{ic|uucp}} がこの手の処理によく使われます)。

{{hc|/etc/udev/rules.d/99-avrprogrammer.rules|2=
# Set group for a programmer matching with vendor and product IDs
SUBSYSTEM=="usb", ATTRS{idVendor}=="''your Vendor ID''", ATTRS{idProduct}=="''your Product ID''", GROUP="uucp", MODE="0666"
}}

イタリック表記の部分は、使っているプログラマーのベンダーとプロダクト ID ({{Pkg|usbutils}} パッケージにある {{ic|lsusb}} コマンドを使って特定できます) に置き換えて、また、{{ic|uucp}} グループはあなたの補助グループに置き換えてください。

== 使い方 ==

AVR チップのために C 言語のプログラムをコンパイルするには、 {{ic|avr-gcc}} が使えます。ここでは例として、 ATmega8A を 8 MHz で動かすことを考えます。目的の MCU (サポートされる MCU のリストは {{man|1=1|2=avr-gcc|3=mmcu=}} にあります) と動作周波数を指定する必要があります:

$ avr-gcc -DF_CPU=8000000UL -mmcu=atmega8a -std=gnu99 main.c -o main.elf

avrdude は、直接 ELF ファイルを読む事ができますが、次の様に Intel HEX 形式に変換することもできます:

$ avr-objcopy -O ihex -j .text -j .data main.elf main.hex

書き込むファイルができたら、書き込み先の flash ROM を指定して、 avrdude を実行します。ここでは AVRISP mkII を例に取って、安全のため書き込み周波数を 125 kHz に小さくして書き込みます:

$ avrdude -p atmega8 -c avrispmkII -B 125kHz -U flash:w:main.hex

これで完了です。他には、 avrdude は EEPROM や fuse への書き込みもサポートします。例えば、low fuse と high fuse それぞれに 0x9F と 0xD1 を書き込むには、次のようにします:

$ avrdude -p atmega8 -c avrispmkII -B 125kHz -U lfuse:w:0x9F:m -U hfuse:w:0xD1:m

ISP プログラミングの時には、 MCU の動作周波数の 1/8 を越えないように気を付けてください。多くの新しいチップでは 1 MHz の設定で販売されているので、 125 kHz の書き込み速度にするのがよいでしょう。

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

=== 最適化 ===

AVR は小さな flash ROM サイズと非力な CPU で構成されているので、 ROM サイズの縮小や性能の向上のために最適化も考慮すると良いでしょう。 GCC の最適化レベルの指定 {{ic|-Os}} や他の機能 {{ic|-funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums}} を使う事がよく知られた方法です。必要のないライブラリへの参照を除くためやガベージコレクションを使うためには、 {{ic|-ffunction-sections -fdata-sections -Wl,--gc-sections}} があります。

=== Makefile のサンプル ===

大きなプロジェクトを管理することは面倒で、 Makefile による管理は非常に有効です。 [https://www.avrfreaks.net/sites/default/files/Makefile.txt AVRfreaks] を元にしたサンプルを、ここで紹介します。

CC = avr-gcc
OBJCOPY = avr-objcopy
SIZE = avr-size
NM = avr-nm
AVRDUDE = avrdude
REMOVE = rm -f

MCU = atmega8a
F_CPU = 8000000

LFUSE = 0x9f
HFUSE = 0xd1

TARGET = firmware
SRC = main.c lcd.c twi.c
OBJ = $(SRC:.c=.o)
LST = $(SRC:.c=.lst)

FORMAT = ihex

OPTLEVEL = s

CDEFS =

CFLAGS = -DF_CPU=$(F_CPU)UL
CFLAGS += $(CDEFS)
CFLAGS += -O$(OPTLEVEL)
CFLAGS += -mmcu=$(MCU)
CFLAGS += -std=gnu99
CFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
CFLAGS += -ffunction-sections -fdata-sections
CFLAGS += -Wall -Wstrict-prototypes
CFLAGS += -Wa,-adhlns=$(<:.c=.lst)

LDFLAGS = -Wl,--gc-sections
LDFLAGS += -Wl,--print-gc-sections

AVRDUDE_MCU = atmega8
AVRDUDE_PROGRAMMER = avrispmkII
AVRDUDE_SPEED = -B 1MHz

AVRDUDE_FLAGS = -p $(AVRDUDE_MCU)
AVRDUDE_FLAGS += -c $(AVRDUDE_PROGRAMMER)
AVRDUDE_FLAGS += $(AVRDUDE_SPEED)

MSG_LINKING = Linking:
MSG_COMPILING = Compiling:
MSG_FLASH = Preparing HEX file:

all: gccversion $(TARGET).elf $(TARGET).hex size

.SECONDARY: $(TARGET).elf
.PRECIOUS: $(OBJ)

%.hex: %.elf
@echo
@echo $(MSG_FLASH) $@
$(OBJCOPY) -O $(FORMAT) -j .text -j .data $< $@

%.elf: $(OBJ)
@echo
@echo $(MSG_LINKING) $@
$(CC) -mmcu=$(MCU) $(LDFLAGS) $^ --output $(@F)

%.o : %.c
@echo $(MSG_COMPILING) $<
$(CC) $(CFLAGS) -c $< -o $(@F)

gccversion:
@$(CC) --version

size: $(TARGET).elf
@echo
$(SIZE) -C --mcu=$(AVRDUDE_MCU) $(TARGET).elf

analyze: $(TARGET).elf
$(NM) -S --size-sort -t decimal $(TARGET).elf

isp: $(TARGET).hex
$(AVRDUDE) $(AVRDUDE_FLAGS) -U flash:w:$(TARGET).hex

fuses:
$(AVRDUDE) $(AVRDUDE_FLAGS) -U lfuse:w:$(LFUSE):m -U hfuse:w:$(HFUSE):m

release: fuses isp

clean:
$(REMOVE) $(TARGET).hex $(TARGET).elf $(OBJ) $(LST) *~

=== 制御レジスタ値の計算 ===

プロジェクト開発速度の向上のために、 {{AUR|avrcalc}} ユーティリティが使えます。これはタイマーや周波数などの制御レジスタのパラメータの計算に役立ちます。

== 参照 ==
* [[Arduino]]
* https://www.microchip.com/design-centers/8-bit/avr-mcus

{{TranslationStatus|AVR|2024-08-17|790657}}

AVR

2024-08-17T06:02:50Z

Shota: /* 使い方 */ MCU リストへのリンクを追加

AVR

2024-08-17T05:56:07Z

Shota: /* udev の問題 */ のタイトルを /* udev ルール */ に修正して、内容を英語版に合わせて更新

[[カテゴリ:開発]]
[[en:AVR]]
[[Wikipedia:AVR_microcontrollers|AVR]] は Microchip Technology 社 (以前は Atmel 社でしたが買収されました)によって開発されているマイクロコントローラ (MCU) の一種です。 AVR は [[Arduino]] プロジェクトに代表される様に、とりわけホビーや教育用途で広まっています。このページでは、これらのMCUの8ビットシリーズを扱います。

== ツールチェイン ==

ツールチェインと GNU コンパイラのために {{Pkg|avr-gcc}} を[[インストール]]して下さい。

== プログラマー (書込器） ==
AVR チップへ作成したプログラムを書き込むためには、プログラマーと、それを行うソフトウェアが必要です。有名なプログラマーには [https://www.fischl.de/usbasp USBasp]や[https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/ATAVRISP2 AVRISP mkII]、[https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE Atmel-ICE]、[https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/ATSTK500 STK500]があります。 LPT ポートで動く単純な DIY プログラマーである [https://www.olimex.com/Products/AVR/Programmers/AVR-PG2B AVR-PG2B] などもあります。 {{Pkg|avrdude}} は、これらも含めて多くのプログラマーをサポートします。

=== udev ルール ===

{{Pkg|avrdue}} を root 権限なしで動かすには次の様な [[Udev]] ルールを作ってください。この udev ルールによって、指定の USB デバイスを取り扱う権限を他のグループに移します ({{ic|uucp}} がこの手の処理によく使われます)。

{{hc|/etc/udev/rules.d/99-avrprogrammer.rules|2=
# Set group for a programmer matching with vendor and product IDs
SUBSYSTEM=="usb", ATTRS{idVendor}=="''your Vendor ID''", ATTRS{idProduct}=="''your Product ID''", GROUP="uucp", MODE="0666"
}}

イタリック表記の部分は、使っているプログラマーのベンダーとプロダクト ID ({{Pkg|usbutils}} パッケージにある {{ic|lsusb}} コマンドを使って特定できます) に置き換えて、また、{{ic|uucp}} グループはあなたの補助グループに置き換えてください。

== 使い方 ==

AVR チップのために C 言語のプログラムをコンパイルするには、 {{ic|avr-gcc}} が使えます。ここでは例として、 ATmega8A を 8 MHz で動かすことを考えます。目的の MCU と動作周波数を指定する必要があります:

$ avr-gcc -DF_CPU=8000000UL -mmcu=atmega8a -std=gnu99 main.c -o main.elf

avrdude は、直接 ELF ファイルを読む事ができますが、次の様に Intel HEX 形式に変換することもできます:

$ avr-objcopy -O ihex -j .text -j .data main.elf main.hex

書き込むファイルができたら、書き込み先の flash ROM を指定して、 avrdude を実行します。ここでは AVRISP mkII を例に取って、安全のため書き込み周波数を 125 kHz に小さくして書き込みます:

$ avrdude -p atmega8 -c avrispmkII -B 125kHz -U flash:w:main.hex

これで完了です。他には、 avrdude は EEPROM や fuse への書き込みもサポートします。例えば、low fuse と high fuse それぞれに 0x9F と 0xD1 を書き込むには、次のようにします:

$ avrdude -p atmega8 -c avrispmkII -B 125kHz -U lfuse:w:0x9F:m -U hfuse:w:0xD1:m

ISP プログラミングの時には、 MCU の動作周波数の 1/8 を越えないように気を付けてください。多くの新しいチップでは 1 MHz の設定で販売されているので、 125 kHz の書き込み速度にするのがよいでしょう。

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

=== 最適化 ===

AVR は小さな flash ROM サイズと非力な CPU で構成されているので、 ROM サイズの縮小や性能の向上のために最適化も考慮すると良いでしょう。 GCC の最適化レベルの指定 {{ic|-Os}} や他の機能 {{ic|-funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums}} を使う事がよく知られた方法です。必要のないライブラリへの参照を除くためやガベージコレクションを使うためには、 {{ic|-ffunction-sections -fdata-sections -Wl,--gc-sections}} があります。

=== Makefile のサンプル ===

大きなプロジェクトを管理することは面倒で、 Makefile による管理は非常に有効です。 [https://www.avrfreaks.net/sites/default/files/Makefile.txt AVRfreaks] を元にしたサンプルを、ここで紹介します。

CC = avr-gcc
OBJCOPY = avr-objcopy
SIZE = avr-size
NM = avr-nm
AVRDUDE = avrdude
REMOVE = rm -f

MCU = atmega8a
F_CPU = 8000000

LFUSE = 0x9f
HFUSE = 0xd1

TARGET = firmware
SRC = main.c lcd.c twi.c
OBJ = $(SRC:.c=.o)
LST = $(SRC:.c=.lst)

FORMAT = ihex

OPTLEVEL = s

CDEFS =

CFLAGS = -DF_CPU=$(F_CPU)UL
CFLAGS += $(CDEFS)
CFLAGS += -O$(OPTLEVEL)
CFLAGS += -mmcu=$(MCU)
CFLAGS += -std=gnu99
CFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
CFLAGS += -ffunction-sections -fdata-sections
CFLAGS += -Wall -Wstrict-prototypes
CFLAGS += -Wa,-adhlns=$(<:.c=.lst)

LDFLAGS = -Wl,--gc-sections
LDFLAGS += -Wl,--print-gc-sections

AVRDUDE_MCU = atmega8
AVRDUDE_PROGRAMMER = avrispmkII
AVRDUDE_SPEED = -B 1MHz

AVRDUDE_FLAGS = -p $(AVRDUDE_MCU)
AVRDUDE_FLAGS += -c $(AVRDUDE_PROGRAMMER)
AVRDUDE_FLAGS += $(AVRDUDE_SPEED)

MSG_LINKING = Linking:
MSG_COMPILING = Compiling:
MSG_FLASH = Preparing HEX file:

all: gccversion $(TARGET).elf $(TARGET).hex size

.SECONDARY: $(TARGET).elf
.PRECIOUS: $(OBJ)

%.hex: %.elf
@echo
@echo $(MSG_FLASH) $@
$(OBJCOPY) -O $(FORMAT) -j .text -j .data $< $@

%.elf: $(OBJ)
@echo
@echo $(MSG_LINKING) $@
$(CC) -mmcu=$(MCU) $(LDFLAGS) $^ --output $(@F)

%.o : %.c
@echo $(MSG_COMPILING) $<
$(CC) $(CFLAGS) -c $< -o $(@F)

gccversion:
@$(CC) --version

size: $(TARGET).elf
@echo
$(SIZE) -C --mcu=$(AVRDUDE_MCU) $(TARGET).elf

analyze: $(TARGET).elf
$(NM) -S --size-sort -t decimal $(TARGET).elf

isp: $(TARGET).hex
$(AVRDUDE) $(AVRDUDE_FLAGS) -U flash:w:$(TARGET).hex

fuses:
$(AVRDUDE) $(AVRDUDE_FLAGS) -U lfuse:w:$(LFUSE):m -U hfuse:w:$(HFUSE):m

release: fuses isp

clean:
$(REMOVE) $(TARGET).hex $(TARGET).elf $(OBJ) $(LST) *~

=== 制御レジスタ値の計算 ===

プロジェクト開発速度の向上のために、 {{AUR|avrcalc}} ユーティリティが使えます。これはタイマーや周波数などの制御レジスタのパラメータの計算に役立ちます。

== 参照 ==
* [[Arduino]]
* https://www.microchip.com/design-centers/8-bit/avr-mcus

Libinput

2024-08-14T01:38:38Z

Shota: 翻訳ステータスの追加

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

=== 入力時のタッチパッドの有効化 ===

デフォルトでは、[[libinput]] はタイピング中にタッチパッドを無効化します。[[Inkscape]] におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}} へ {{ic|InputClass}} セクションを加える事でこの無効化動作を避ける事ができます:

Section "InputClass"
...
Option "DisableWhileTyping" "0"
EndSection

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

=== 慣性スクロールが KDE で使えない ===

慣性スクロールの機能は現在実装されていません ([https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383])。Chromium-ベースのブラウザ上については、[https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] の拡張機能をインストールする事で使えるようになります。

=== タブレットモードでキーがスタックする ===

いくつかのタブレット PC (Lenovo Yoga など) において、タブレットモードへの切り替わり時にキー入力が停止しタブレットモードを抜けるまでスタックします。libinput の quirks ファイルを編集する事で解決できる場合があります。詳細は [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914] を見てください。

For example, find the name of the keyboard device:
例えば、キーボードデバイスの名前が次の場合:

{{hc|# libinput list-devices|
...
Device: AT Translated Set 2 keyboard
Kernel: /dev/input/event3
Capabilities: keyboard
...
}}

次の様に上書き用のファイルを作ってください:

{{hc|/etc/libinput/local-overrides.quirks|2=
[Lenovo Thinkpad Yoga]
MatchName=AT Translated Set 2 keyboard
ModelTabletModeNoSuspend=0
}}

{{ic|1=ModelTabletModeNoSuspend=0}} によってキースタックの問題となる振る舞いを無効化します。 [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] に、設定ファイルのフォーマットやデバイス名の指定方法が記載されています。いくつかのデバイスについては既存の quirks エントリーを使って上書き用のファイルを作れます。デフォルトの quirks ファイルは {{ic|/usr/share/libinput/}} にあります。

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] Linux における入力デバイスの取り扱いの経緯と現状 (2020年時点) の概説
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] libinput の概説

{{TranslationStatus|libinput|2024-08-14|808708}}

Libinput

2024-08-14T01:32:26Z

Shota: /* タブレットモードでキーがスタックする */ エスケープシーケンス忘れ

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

=== 入力時のタッチパッドの有効化 ===

デフォルトでは、[[libinput]] はタイピング中にタッチパッドを無効化します。[[Inkscape]] におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}} へ {{ic|InputClass}} セクションを加える事でこの無効化動作を避ける事ができます:

Section "InputClass"
...
Option "DisableWhileTyping" "0"
EndSection

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

=== 慣性スクロールが KDE で使えない ===

慣性スクロールの機能は現在実装されていません ([https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383])。Chromium-ベースのブラウザ上については、[https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] の拡張機能をインストールする事で使えるようになります。

=== タブレットモードでキーがスタックする ===

いくつかのタブレット PC (Lenovo Yoga など) において、タブレットモードへの切り替わり時にキー入力が停止しタブレットモードを抜けるまでスタックします。libinput の quirks ファイルを編集する事で解決できる場合があります。詳細は [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914] を見てください。

For example, find the name of the keyboard device:
例えば、キーボードデバイスの名前が次の場合:

{{hc|# libinput list-devices|
...
Device: AT Translated Set 2 keyboard
Kernel: /dev/input/event3
Capabilities: keyboard
...
}}

次の様に上書き用のファイルを作ってください:

{{hc|/etc/libinput/local-overrides.quirks|2=
[Lenovo Thinkpad Yoga]
MatchName=AT Translated Set 2 keyboard
ModelTabletModeNoSuspend=0
}}

{{ic|1=ModelTabletModeNoSuspend=0}} によってキースタックの問題となる振る舞いを無効化します。 [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] に、設定ファイルのフォーマットやデバイス名の指定方法が記載されています。いくつかのデバイスについては既存の quirks エントリーを使って上書き用のファイルを作れます。デフォルトの quirks ファイルは {{ic|/usr/share/libinput/}} にあります。

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-14T01:29:31Z

Shota: /* Keys stuck after entering tablet mode */ を訳出

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

=== 入力時のタッチパッドの有効化 ===

デフォルトでは、[[libinput]] はタイピング中にタッチパッドを無効化します。[[Inkscape]] におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}} へ {{ic|InputClass}} セクションを加える事でこの無効化動作を避ける事ができます:

Section "InputClass"
...
Option "DisableWhileTyping" "0"
EndSection

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

=== 慣性スクロールが KDE で使えない ===

慣性スクロールの機能は現在実装されていません ([https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383])。Chromium-ベースのブラウザ上については、[https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] の拡張機能をインストールする事で使えるようになります。

=== タブレットモードでキーがスタックする ===

いくつかのタブレット PC (Lenovo Yoga など) において、タブレットモードへの切り替わり時にキー入力が停止しタブレットモードを抜けるまでスタックします。libinput の quirks ファイルを編集する事で解決できる場合があります。詳細は [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914] を見てください。

For example, find the name of the keyboard device:
例えば、キーボードデバイスの名前が次の場合:

{{hc|# libinput list-devices|
...
Device: AT Translated Set 2 keyboard
Kernel: /dev/input/event3
Capabilities: keyboard
...
}}

次の様に上書き用のファイルを作ってください:

{{hc|/etc/libinput/local-overrides.quirks|2=
[Lenovo Thinkpad Yoga]
MatchName=AT Translated Set 2 keyboard
ModelTabletModeNoSuspend=0
}}

{{ic|ModelTabletModeNoSuspend=0}} によってキースタックの問題となる振る舞いを無効化します。 [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] に、設定ファイルのフォーマットやデバイス名の指定方法が記載されています。いくつかのデバイスについては既存の quirks エントリーを使って上書き用のファイルを作れます。デフォルトの quirks ファイルは {{ic|/usr/share/libinput/}} にあります。

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-14T01:21:13Z

Shota: /* Inertial scrolling does not work in KDE */ を訳出

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

=== 入力時のタッチパッドの有効化 ===

デフォルトでは、[[libinput]] はタイピング中にタッチパッドを無効化します。[[Inkscape]] におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}} へ {{ic|InputClass}} セクションを加える事でこの無効化動作を避ける事ができます:

Section "InputClass"
...
Option "DisableWhileTyping" "0"
EndSection

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

=== 慣性スクロールが KDE で使えない ===

慣性スクロールの機能は現在実装されていません ([https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383])。Chromium-ベースのブラウザ上については、[https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] の拡張機能をインストールする事で使えるようになります。

=== Keys stuck after entering tablet mode ===

On some Tablet PCs (notably Lenovo Yogas), holding a keyboard key while entering the tablet mode can cause the key be stuck until the tablet mode is disabled. It is sometimes possible to fix this behavior by modifying libinput quirks files. See [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914].

For example, find the name of the keyboard device:

{{hc|# libinput list-devices|
...
Device: AT Translated Set 2 keyboard
Kernel: /dev/input/event3
Capabilities: keyboard
...
}}

Then, create an override file:

{{hc|/etc/libinput/local-overrides.quirks|2=
[Lenovo Thinkpad Yoga]
MatchName=AT Translated Set 2 keyboard
ModelTabletModeNoSuspend=0
}}

{{ic|ModelTabletModeNoSuspend{{=}}0}} disables behavior that causes the bug. Consult [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] for information about configuration format and Match directives that select the device to configure. It is often possible to create an override file based on an existing quirks entry for your particular device. Default quirks files can be found in {{ic|/usr/share/libinput/}}.

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T10:37:14Z

Shota: /* 入力時のタッチパッドの有効化 */ 翻訳

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

=== 入力時のタッチパッドの有効化 ===

デフォルトでは、[[libinput]] はタイピング中にタッチパッドを無効化します。[[Inkscape]] におけるマウス入力付きキーバインディング動作など、いくつかのソフトウェアにおいて問題になります。次のように {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}} へ {{ic|InputClass}} セクションを加える事でこの無効化動作を避ける事ができます:

Section "InputClass"
...
Option "DisableWhileTyping" "0"
EndSection

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

=== Inertial scrolling does not work in KDE ===

The feature is currently not implemented, see [https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383]. As a workaround for Chromium-based browsers, install the [https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] extension.

=== Keys stuck after entering tablet mode ===

On some Tablet PCs (notably Lenovo Yogas), holding a keyboard key while entering the tablet mode can cause the key be stuck until the tablet mode is disabled. It is sometimes possible to fix this behavior by modifying libinput quirks files. See [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914].

For example, find the name of the keyboard device:

{{hc|# libinput list-devices|
...
Device: AT Translated Set 2 keyboard
Kernel: /dev/input/event3
Capabilities: keyboard
...
}}

Then, create an override file:

{{hc|/etc/libinput/local-overrides.quirks|2=
[Lenovo Thinkpad Yoga]
MatchName=AT Translated Set 2 keyboard
ModelTabletModeNoSuspend=0
}}

{{ic|ModelTabletModeNoSuspend{{=}}0}} disables behavior that causes the bug. Consult [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] for information about configuration format and Match directives that select the device to configure. It is often possible to create an override file based on an existing quirks entry for your particular device. Default quirks files can be found in {{ic|/usr/share/libinput/}}.

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T10:31:56Z

Shota: 英語版から内容を同期 (未翻訳)

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

=== 入力時のタッチパッドの有効化 ===

By default, [[libinput]] disables the mousepad when typing. This is conflicting for some software such as [[Inkscape]] which has keybindings that require mouse movement while a key is pressed. You can disable this by adding the following line to the {{ic|InputClass}} section of {{ic|/etc/X11/xorg.conf.d/30-touchpad.conf}}:

Section "InputClass"
...
Option "DisableWhileTyping" "0"
EndSection

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

=== Inertial scrolling does not work in KDE ===

The feature is currently not implemented, see [https://bugs.kde.org/show_bug.cgi?id=456383 KDE bug 456383]. As a workaround for Chromium-based browsers, install the [https://chrome.google.com/webstore/detail/smoothscroll/nbokbjkabcmbfdlbddjidfmibcpneigj SmoothScroll] extension.

=== Keys stuck after entering tablet mode ===

On some Tablet PCs (notably Lenovo Yogas), holding a keyboard key while entering the tablet mode can cause the key be stuck until the tablet mode is disabled. It is sometimes possible to fix this behavior by modifying libinput quirks files. See [https://gitlab.freedesktop.org/libinput/libinput/-/issues/914 Issue 914].

For example, find the name of the keyboard device:

{{hc|# libinput list-devices|
...
Device: AT Translated Set 2 keyboard
Kernel: /dev/input/event3
Capabilities: keyboard
...
}}

Then, create an override file:

{{hc|/etc/libinput/local-overrides.quirks|2=
[Lenovo Thinkpad Yoga]
MatchName=AT Translated Set 2 keyboard
ModelTabletModeNoSuspend=0
}}

{{ic|ModelTabletModeNoSuspend{{=}}0}} disables behavior that causes the bug. Consult [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html Device quirks] for information about configuration format and Match directives that select the device to configure. It is often possible to create an override file based on an existing quirks entry for your particular device. Default quirks files can be found in {{ic|/usr/share/libinput/}}.

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T10:29:15Z

Shota: /* マウスホイールのスクロール速度の調整 */ 英語版に合わせた小さい修正

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop <nowiki>'</nowiki>''device_name''<nowiki>'</nowiki> 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|''device_name''}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]。

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T10:18:53Z

Shota: /* fusuma */ 英語版に同期

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

あるいは、AUR バージョンが存在します: {{AUR|ruby-fusuma}}。

{{ic|fusuma}} [[Ruby#RubyGems|Ruby gem]] 以外にも、{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]] あるいは、{{pkg|xdotool}} (X 用) か {{pkg|ydotool}} (Wayland, X11 など汎用) をインストールする必要があります。更なる代替は [https://github.com/iberianpig/fusuma#alternatives-to-xdotool こちら]にリストされています。

{{Tip|{{ic|fusuma-plugin-sendkey}} [[Ruby#RubyGems|Ruby gem]]は X と Wayland 両方をサポートしています。}}

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
sendkey: 'LEFTALT+RIGHT'
right:
sendkey: 'LEFTALT+LEFT'
up:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
down:
sendkey: 'LEFTALT+TAB'
pinch:
in:
sendkey: 'LEFTALT+LEFTSHIFT+TAB'
out:
sendkey: 'LEFTALT+TAB'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

あるいは {{ic|xdotool}} では次のようにします:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
command: 'xdotool key alt+Right'
right:
command: 'xdotool key alt+Left'
up:
command: 'xdotool key ctrl+shift+plus'
down:
command: 'xdotool key ctrl+minus'
pinch:
in:
command: 'xdotool key ctrl+shift+plus'
out:
command: 'xdotool key ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

{{ic|ydotool}} は {{ic|xdotool}} と同様です。

スワイプの閾値を低くするとページをスワイプしすぎるので重要です。

上記の設定は3本指のスワイプを使います。2本指のスワイプはサポートされていません [https://github.com/iberianpig/fusuma/issues/104#issuecomment-434742767]。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop 'RAPOO Rapoo 2.4G Wireless Device' 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|RAPOO Rapoo 2.4G Wireless Device}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T10:07:18Z

Shota: /* libinput-gestures */ Touchegg との干渉を追記 (英語版より)

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

[[Touchegg]] を使っている場合は、干渉を避ける為に {{AUR|libinput-gestures}} はアンインストールしてください[https://github.com/JoseExposito/gnome-shell-extension-x11gestures/issues/41]。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

また、AUR には旧バージョンが存在します: {{AUR|ruby-fusuma}}。

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
shortcut: 'alt+Right'
right:
shortcut: 'alt+Left'
up:
shortcut: 'ctrl+shift+plus'
down:
shortcut: 'ctrl+minus'
pinch:
in:
shortcut: 'ctrl+shift+plus'
out:
shortcut: 'ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

スワイプの閾値を低くするとページをスワイプしすぎてしまいます。

上記の設定は3本指のスワイプを使います。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop 'RAPOO Rapoo 2.4G Wireless Device' 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|RAPOO Rapoo 2.4G Wireless Device}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T03:40:09Z

Shota: /* タッチパッドの無効化 */ を /* デバイスの無効化 */ に変更し構成を英語版に同期

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== デバイスの無効化 ===

==== 環境変数を使う ====

[[環境変数]] {{ic|LIBINPUT_IGNORE_DEVICE}} を使って指定のデバイスの初期化を避ける事ができます [https://wayland.freedesktop.org/libinput/doc/latest/device-configuration-via-udev.html#ignoring-devices]。次のような [[udev]] ルールを使って設定するのが最適です:

{{hc|/etc/udev/rules.d/99-libinput-ignore.rules|2=
ACTION=="add{{!}}change", ''device_delineation'', ENV{LIBINPUT_IGNORE_DEVICE}="1"
}}

''device_delineation'' によってデバイスを指定します。例えば ibinput で全ての USB デバイスを無視させるには {{ic|lsusb}} から取得した ID ''vendor_id'' と ''product_id'' を使って {{ic|1=SUBSYSTEMS=="usb", ATTRS{idVendor}=="''vendor_id''", ATTRS{idProduct}=="''product_id''"}} とします。

一度ファイルを用意したら、udev は自動的に設定の変更を反映するので ([[Udev#新しいルールをロードする]]を参照)、デバイスを再接続するだけで反映されます。

==== xinput を使う ====

タッチパッドを始めとするデバイスを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

有効化・無効化をトグルするには [https://github.com/lahwaacz/Scripts/blob/master/toggle-touchpad.sh] のようなスクリプトを書いてください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

また、AUR には旧バージョンが存在します: {{AUR|ruby-fusuma}}。

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
shortcut: 'alt+Right'
right:
shortcut: 'alt+Left'
up:
shortcut: 'ctrl+shift+plus'
down:
shortcut: 'ctrl+minus'
pinch:
in:
shortcut: 'ctrl+shift+plus'
out:
shortcut: 'ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

スワイプの閾値を低くするとページをスワイプしすぎてしまいます。

上記の設定は3本指のスワイプを使います。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop 'RAPOO Rapoo 2.4G Wireless Device' 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|RAPOO Rapoo 2.4G Wireless Device}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T03:25:05Z

Shota: /* 設定 */ 「Via Udev Rule」以外を英語版に同期

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況 ([[#グラフィカルツール]]を参照)、あるいはデスクトップ環境非依存の [[udev]] ルールによって異なります。あなたのデスクトップ環境がまだサポートしていないオプション (例えば [[GNOME]] におけるタッチパッドスクロースの速度) を設定したい場合は、{{AUR|libinput-config-git}} が使えるかもしれません。サポートされているオプションは [https://gitlab.com/warningnonpotablewater/libinput-config libinput-config README] にまとめられています。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== Xorg の xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|
* libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、デフォルトのインストールディレクトリにおいて synaptics の設定ファイルが {{ic|70-}} と大きい番号で始まる為 synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。
* 設定ファイルが無効になっているようであれば、そのファイルが非特権ユーザーからも読めるかどうかを確認してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルで好きな数だけセクションを定義することができます。{{man|5|xorg.conf|INPUTCLASS_SECTION}} にあるフィルターを使ってデバイスをフィルターできます。例えば、
* {{ic|MatchIsPointer "on"}} (トラックポイント)
* {{ic|MatchIsKeyboard "on"}}
* {{ic|MatchIsTouchpad "on"}}
* {{ic|MatchIsTouchscreen "on"}}
入力デバイスは {{man|4|libinput|CONFIGURATOIN_DETAILS}} を見ながら設定できます。
一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあり、適用するには X を再起動する必要があったりするので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** 設定パネルからマウスのオプションが選べます。{{ic|mate-mouse-properties}} からも設定できます。
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** {{pkg|xfce4-settings}} にあるマウスやタッチパッドのサブメニューから設定できます。

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== タッチパッドの無効化 ===

タッチパッドを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

また、AUR には旧バージョンが存在します: {{AUR|ruby-fusuma}}。

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
shortcut: 'alt+Right'
right:
shortcut: 'alt+Left'
up:
shortcut: 'ctrl+shift+plus'
down:
shortcut: 'ctrl+minus'
pinch:
in:
shortcut: 'ctrl+shift+plus'
out:
shortcut: 'ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

スワイプの閾値を低くするとページをスワイプしすぎてしまいます。

上記の設定は3本指のスワイプを使います。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop 'RAPOO Rapoo 2.4G Wireless Device' 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|RAPOO Rapoo 2.4G Wireless Device}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T02:38:06Z

Shota: /* インストール */ 英語版に合わせて構成を修正。

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Xorg]] か [[Wayland]] をインストールしている場合、libinput は依存関係により自動的にインストールされているはずで、特別にインストールする必要はありません。

* [[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。
* [[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージが依存関係によりインストールされているはずです。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換します。
** また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況によって変わります。[[#グラフィカルツール]]を参照。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス|入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、{{ic|70-synaptics.conf}} のファイル名によって synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルでお好きな数だけセクションを定義することができます。{{ic|MatchIsPointer "on"}}, {{ic|MatchIsKeyboard "on"}}, {{ic|MatchIsTouchpad "on"}}, {{ic|MatchIsTouchscreen "on"}} などを使って設定したいデバイスをフィルタリングしてください。詳しくは {{man|4|libinput}} を参照。一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあるので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** Mouse option available in the settings panel. Also accessible using {{ic|mate-mouse-properties}}
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** Configured from the Mouse and Touchpad submenu in {{pkg|xfce4-settings}}.

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== タッチパッドの無効化 ===

タッチパッドを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

また、AUR には旧バージョンが存在します: {{AUR|ruby-fusuma}}。

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
shortcut: 'alt+Right'
right:
shortcut: 'alt+Left'
up:
shortcut: 'ctrl+shift+plus'
down:
shortcut: 'ctrl+minus'
pinch:
in:
shortcut: 'ctrl+shift+plus'
out:
shortcut: 'ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

スワイプの閾値を低くするとページをスワイプしすぎてしまいます。

上記の設定は3本指のスワイプを使います。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop 'RAPOO Rapoo 2.4G Wireless Device' 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|RAPOO Rapoo 2.4G Wireless Device}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

Libinput

2024-08-13T02:32:57Z

Shota: 英文に合わせて序文のマイナーな修正

{{Lowercase title}}
[[Category:入力デバイス]]
[[en:Libinput]]
[[es:Libinput]]
[[zh-hans:Libinput]]
{{Related articles start}}
{{Related|Xorg}}
{{Related|Synaptics タッチパッド}}
{{Related|Wayland}}
{{Related articles end}}

[https://freedesktop.org/wiki/Software/libinput/ libinput] プロジェクトより:

:libinput は Wayland コンポジタで入力デバイスを処理するためのライブラリで、汎用的な X.Org 入力ドライバーでもあります。デバイスの検出・管理、入力デバイスのイベントの処理・抽象化を担当し、ユーザーが期待する一般的な機能セットを提供することでコンポジタを改造する必要があるコードの量を減らします。

X.Org の入力ドライバーは標準的な[[Xorg#入力デバイス|入力デバイス]]のほとんどサポートしています。特にプロジェクトが力を入れてるのは、タッチパッドやタッチスクリーンのタッチ機能 (マルチタッチやジェスチャー) の先進的なサポートです。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/ libinput のドキュメント] を見て下さい。

== インストール ==

[[Wayland]] で libinput を使用する場合、特にインストールする必要があるものはありません。あなたが使用しているグラフィカル環境の依存パッケージとして {{pkg|libinput}} パッケージは既にインストールされているはずです。他に必要なドライバーはありません。

[[Xorg]] で libinput を使用する場合、{{Pkg|xf86-input-libinput}} パッケージを[[インストール]]してください。xf86-input-libinput は libinput のラッパーで、X でも libinput で入力デバイスを扱えるようになります。evdev や synaptics の代わりのドライバーとしても使うことが可能です [https://freedesktop.org/wiki/Software/libinput/]。つまり、{{ic|xf86-input-}} で始まる X 用のドライバーパッケージを置換できます。

また、{{Pkg|xorg-xinput}} をインストールすることで実行中に設定を変更することができます。

== 設定 ==

[[Wayland]] 用の libinput 設定ファイルは存在しません。設定できるオプションは使用しているデスクトップ環境のサポート状況によって変わります。[[#グラフィカルツール]]を参照。

[[Xorg]] 用のデフォルト設定ファイルは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} にインストールされます。キーボードやタッチパッド、トラックポイントやサポートされているタッチスクリーンなら特別な設定をしなくても自動で検出されます。

=== xinput を使う ===

まず、次を実行してください:
# libinput list-devices
上記のコマンドは接続されているデバイスと、libinput によってサポートされている機能を出力します。

グラフィカル環境を[[再起動]]すれば、他のドライバーが優先的に使用されるように設定されていないかぎり、デフォルト設定によって libinput によってデバイスが管理されるようになるはずです。

設定できるオプションは {{man|4|libinput}} [[man ページ]]を参照してください。''xinput'' ツールを使うことで使用している特定のデバイスのオプションを確認・変更することができます。

デバイスとその番号を確認するには:
$ xinput list
オプションを確認するには:
$ xinput list-props ''device''
オプションを設定するには:
$ xinput set-prop ''device'' ''option-number'' ''setting''

例えば、libinput の Click Method Enabled (303) のオプションを設定するには、以下のコマンドを実行:

$ xinput set-prop 14 303 1 1

または

$ xinput set-prop 14 "libinput Click Method Enabled" 1 1

=== Xorg 設定ファイルを使う ===

オプションの永続的な設定については [[Xorg#.conf ファイルを使う]] を見て下さい。[[Logitech Marble Mouse#libinput を使う]]や下の[[#ボタンの再マッピング]]に設定例が載っています。

通常、[[Xorg#入力デバイス|入力デバイス]]用に別のドライバーを同時にインストールすることができます。デバイスのドライバーを libinput を使うように切り替えたいときは、{{ic|/etc/X11/xorg.conf.d/}} にある昔の設定ファイルによって他のドライバーが優先されるようになっていないことを確認してください。

{{Tip|libinput と synaptics を同時にインストールしてデフォルト設定を使っている場合 ({{ic|/etc/X11/xorg.conf.d}} に両方のファイルが存在しない場合)、{{ic|70-synaptics.conf}} のファイル名によって synaptics が優先されます。libinput を優先させたい場合、デフォルトの libinput 設定のシンボリックリンクを作成してください:
# ln -s /usr/share/X11/xorg.conf.d/40-libinput.conf /etc/X11/xorg.conf.d/40-libinput.conf
両方の設定ファイルが {{ic|/etc/X11/xorg.conf.d}} に存在する場合、libinput の設定ファイルは2番目になります。[[Xorg#.conf ファイルを使う]]を見てください。libinput を無効化したくなった場合、作成したシンボリックリンクを {{ic|/etc/X11/xorg.conf.d/}} から削除してください。}}

どのデバイスが libinput によって管理されているか [[Xorg#共通|xorg のログファイル]]で確認できます。例えば、{{ic|/etc/X11/xorg.conf.d/}} に何も設定ファイルを置いていない (デバイスを自動で検出させている) ノートパソコンの場合、以下のようになります:
{{hc|$ grep -e "Using input driver 'libinput'" ''/path/to/Xorg.0.log''|
[ 28.799] (II) Using input driver 'libinput' for 'Power Button'
[ 28.847] (II) Using input driver 'libinput' for 'Video Bus'
[ 28.853] (II) Using input driver 'libinput' for 'Power Button'
[ 28.860] (II) Using input driver 'libinput' for 'Sleep Button'
[ 28.872] (II) Using input driver 'libinput' for 'AT Translated Set 2 keyboard'
[ 28.878] (II) Using input driver 'libinput' for 'SynPS/2 Synaptics TouchPad'
[ 28.886] (II) Using input driver 'libinput' for 'TPPS/2 IBM TrackPoint'
[ 28.895] (II) Using input driver 'libinput' for 'ThinkPad Extra Buttons'}}

もちろん、あるデバイスでは他のドライバーを使用して、他のデバイスでは libinput を使うようにすることもできます。使用するドライバーを決める要因は様々です。例えば、[[Synaptics タッチパッド]]ドライバーと比べて、libinput ドライバーにはタッチパッドの挙動をカスタマイズするためのオプションが少ないですが、マルチタッチイベントをよりプログラマティックに処理することができます (例: 手のひら検出)。従って、あるドライバーでハードウェアの問題を抱えるような場合、別のドライバーを試してみると良いでしょう。

カスタム設定ファイルは {{ic|/etc/X11/xorg.conf.d/}} に配置します。よく使われるファイル名は {{ic|30-touchpad.conf}} です。

{{Tip|利用可能な設定オプションや説明などは {{ic|/usr/share/X11/xorg.conf.d/40-libinput.conf}} や {{man|4|libinput}} のマニュアルページを参照してください。}}

基本的な設定は以下のようになります:
{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "devname"
Driver "libinput"
...
EndSection
}}
単体の設定ファイルでお好きな数だけセクションを定義することができます。{{ic|MatchIsPointer "on"}}, {{ic|MatchIsKeyboard "on"}}, {{ic|MatchIsTouchpad "on"}}, {{ic|MatchIsTouchscreen "on"}} などを使って設定したいデバイスをフィルタリングしてください。詳しくは {{man|4|libinput}} を参照。一般的な設定オプションは以下の通りです:
* {{ic|"Tapping" "on"}}: タップでクリック。
* {{ic|"ClickMethod" "clickfinger"}}: トラックパッドの中・右ボタンの領域が消えて、代わりに2本指のクリックが右クリックに、3本指のクリックが中クリックになります。詳しくは [https://wayland.freedesktop.org/libinput/doc/latest/clickpad-softbuttons.html#clickfinger-behavior ドキュメント] を参照。
* {{ic|"NaturalScrolling" "true"}}: ナチュラルスクロール (逆スクロール)。
* {{ic|"ScrollMethod" "edge"}}: エッジスクロール (縦スクロール)。
デバイスによっては上記の一部オプションが使えないこともあるので注意してください。

=== グラフィカルツール ===

複数の GUI ツールが存在します:

* [[GNOME]]:
** コントロールセンターの 'Mouse & Touchpad' に基本的な設定 UI が存在します。[[GNOME#マウスとタッチパッド]]も参照。
** {{pkg|gnome-tweaks}} には他にもいくつか設定が存在します。
* [[Cinnamon]]:
** GNOME UI と同じように設定することができます。
* [[MATE]]:
** Mouse option available in the settings panel. Also accessible using {{ic|mate-mouse-properties}}
* [[KDE|KDE Plasma]] 5:
** キーボード・マウス・コントローラーデバイスはシステム設定から設定できます。
* [[Xfce]]:
** Configured from the Mouse and Touchpad submenu in {{pkg|xfce4-settings}}.

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

=== ボタンの再マッピング ===

例としてタッチパッドの2本指タップと3本指タップを置き換えるとします。デフォルトでは3本指タップでテキストを貼り付けることができますが、[[Xorg]] の設定ファイルで {{ic|TappingButtonMap}} オプションを設定することで2本指タップで貼り付けを行うように設定できます。1・2・3本指のタップを左・右・中に設定するには {{ic|TappingButtonMap}} を {{ic|lrm}} に、左・中・右にするには {{ic|lmr}} に設定してください。

{{hc|/etc/X11/xorg.conf.d/30-touchpad.conf|
Section "InputClass"
Identifier "touchpad"
Driver "libinput"
MatchIsTouchpad "on"
Option "Tapping" "on"
Option "TappingButtonMap" "lmr"
EndSection}}

デバイスがタッチパッドではない場合は {{ic|MatchIsTouchpad "on"}} を削除して {{ic|Identifier}} も変えてください。

=== ボタンの手動再マッピング ===

デバイスによってはボタンのマッピングを変えたいというときもあるでしょう。例えば、中ボタンがマウスホイールと一体となっている場合、マウスの親指ボタンを中ボタン (X11 では貼り付けに使われています) の代わりに使いたいと思うかもしれません。現在のボタンマッピングは次のコマンドで確認できます (''device'' は {{ic|xinput list}} で確認できるデバイス名あるいはデバイス ID に置き換えてください):
$ xinput get-button-map ''device''
ボタン番号の順番は自由に変更することができます。例:
$ xinput set-button-map ''device'' 1 6 3 4 5 0 7
上記の例では、6番目のボタンを中ボタンにマッピングして、元々の中ボタンは0を指定して無効にしています。[[Wayland]] でも上記の設定は使えますが、''device'' の番号とボタンのマップの両方が異なっているので注意してください。Xorg と Wayland で設定を直接相互利用することはできません。

{{Tip|({{Pkg|xorg-xev}} パッケージに含まれている) ''xev'' を使うことで実際のボタンがどの ID にマッピングされているか確認できます。}}

デバイスによっては同じデバイス名で複数回、それぞれ異なる量のボタンが存在します。以下は [[xinitrc]] で Logitech Revolution MX マウスのボタンマッピングを変更する例です:

{{hc|~/.xinitrc|<nowiki>
...
for i in $(xinput list | grep "Logitech USB Receiver" | perl -n -e'/id=(\d+)/ && print "$1\n"')
do if xinput get-button-map "$i" 2>/dev/null| grep -q 20; then
xinput set-button-map "$i" 1 17 3 4 5 8 7 6 9 10 11 12 13 14 15 16 2 18 19 20
fi
done
...</nowiki>}}

=== タッチパッド感度の変更 ===

libinput がタッチが押されたときと離されたときを認識する適切な閾値を探す方法は上流ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/touchpad-pressure-debugging.html#touchpad-pressure-hwdb] に書かれています。

タッチパッドのカスタム圧力値は一時的なローカルデバイスクアークで設定できます。[https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html] を見てください。

{{Note|クアークは内部的な API で将来的に libinput で動作するか保証がありません。バージョン 1.11 と 1.12 の間から、udev ルール [https://wayland.freedesktop.org/libinput/doc/1.11.3/udev_config.html#hwdb] が {{ic|.quirk}} ファイルによって置き換えられました [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html]。}}

=== タッチパッドの無効化 ===

タッチパッドを無効化するには、まず {{ic|xinput list}} で名前を確認してから {{ic|xinput disable ''name''}} で無効化してください。

{{Note|
* ID 番号を使うよりも名前を使うほうが安定して無効化できます。デバイスの番号は変わる可能性があります。
* 名前に空白が含まれる場合はクォートで囲ってください。
}}

設定を永続化する場合は[[自動起動]]を見てください。

=== ジェスチャー ===

libinput ドライバーにはスワイプやピンチなどの高度なマルチタッチイベントを処理できるロジックが含まれていますが [https://wayland.freedesktop.org/libinput/doc/latest/gestures.html]、[[デスクトップ環境]]や[[ウィンドウマネージャ]]がまだそれらのアクションを実装していない可能性があります。

==== libinput-gestures ====

[[wikipedia:Extended_Window_Manager_Hints|EWMH]] ([https://www.freedesktop.org/wiki/Specifications/wm-spec/ wm-spec] を参照) 互換のウィンドウマネージャでは、代わりに [https://github.com/bulletmark/libinput-gestures libinput-gestures] ユーティリティを使うことができます。このプログラムは libinput のジェスチャーを ({{ic|libinput debug-events}} を使って) タッチパッドから読み込んで設定ファイルにあわせてジェスチャーをマッピングします。libinput に組み込まれている認識機能の範囲内で柔軟な設定が可能です。

[https://github.com/bulletmark/libinput-gestures libinput-gestures] を使用するには、{{Aur|libinput-gestures}} パッケージをインストールしてください。デフォルト設定では、スワイプやピンチのジェスチャーが使えます。また、個人設定ファイルで自由にジェスチャーを定義できます。詳しくは [https://github.com/bulletmark/libinput-gestures/blob/master/README.md README] を見てください。

==== fusuma ====

[https://github.com/iberianpig/fusuma Fusuma] は [[Ruby]] で書かれたマルチタッチジェスチャー認識ツールで、libinput-gestures の代替として使えます。

{{ic|fusuma}} の [[Ruby#RubyGems|Ruby gem]] をインストールしてください:

$ gem install fusuma

また、AUR には旧バージョンが存在します: {{AUR|ruby-fusuma}}。

それから {{ic|~/.config/fusuma/config.yml}} で以下のように設定:

{{hc|~/.config/fusuma/config.yml|<nowiki>
swipe:
3:
left:
shortcut: 'alt+Right'
right:
shortcut: 'alt+Left'
up:
shortcut: 'ctrl+shift+plus'
down:
shortcut: 'ctrl+minus'
pinch:
in:
shortcut: 'ctrl+shift+plus'
out:
shortcut: 'ctrl+minus'

threshold:
swipe: 0.5
pinch: 0.2

interval:
swipe: 0.2
pinch: 0.2
</nowiki>}}

スワイプの閾値を低くするとページをスワイプしすぎてしまいます。

上記の設定は3本指のスワイプを使います。

==== gebaar ====
[https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar] もジェスチャー認識ツールです。
Fusuma と違いピンチ (サポートは今後予定されています) やスワイプには対応していませんが、3/4指で上下左右にスワイプする以外に、Fusuma にはない斜めスワイプにも対応しています。

gebaar のフォークは [https://github.com/Osleg/gebaar-libinput Gebaar] にあり、{{AUR|gebaar-libinput-git}} を使ってインストールすることができます。{{AUR|gebaar-libinput-git}} はピンチジェスチャーをサポートし、オリジナルの gebaar に機能が追加されています。このバージョンは現在活発に開発されており、オリジナルとは互換性のない設定変更が導入されていることに注意してください [https://github.com/Coffee2CodeNL/gebaar-libinput Gebaar]

==== GnomeExtendedGestures ====

GNOME との統合が必要な場合、[https://github.com/mpiannucci/GnomeExtendedGestures GnomeExtendedGestures] が存在します ({{Aur|gnome-shell-extension-extended-gestures-git}})。3本指の縦・横のジェスチャーを設定して gnome-shell のアクションを実行できます (アプリケーションの切り替えなど)。

=== ボタンを押したままマウスでスクロールする ===

マウスボタン(マウスにボタンがある場合は、右ボタンや中央ボタンなど)を押したままマウスを動かすことで、マウスやトラックボールでのスクロールを最適化する良い方法があります。マウスにマウスホイールがない場合 (トラックボールの場合が多い) に非常に便利です。そのためには、{{ic|ScrollMethod}} を {{ic|button}} に設定し、アクションの {{ic|ScrollButton}} オプションをマウスボタンを指定する必要があります。これを実現するための設定例を次に示します。

{{hc|/etc/X11/xorg.conf.d/00-mouse.conf|
Section "InputClass"
Identifier "system-mouse"
MatchIsPointer "on"
Option "ScrollMethod" "button"
Option "ScrollButton" "3"
EndSection
}}

=== マウスホイールのスクロール速度の調整 ===

マウスによっては、特に [[HiDPI]] デスクトップで使用する場合、ホイールのスクロールが遅すぎることがあります。[https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/12 patch] が libinput にサブミットされましたが、受け付けられませんでした。このパッチにはサードパーティの [https://github.com/archlinuxcn/repo/tree/d0eb728b38450b47a4913539193a58fb523cc255/archlinuxcn/xf86-input-libinput-oldherl xf86-input-libinput] が組み込まれています。

このパッチでは、マウスに新しいプロパティ {{ic|libinput Scroll Distance Scale}} が導入され、次のようなスケーリング係数を設定できます。

$ xinput --set-prop 'RAPOO Rapoo 2.4G Wireless Device' 'libinput Scroll Distance Scale' 2.5 2.5

ここで、{{ic|RAPOO Rapoo 2.4G Wireless Device}} は、{{ic|xinput --list}} にリストされているマウスデバイスの名前です。{{ic|2.5 2.5}} は、それぞれx軸とy軸の倍率です。

または、{{Aur|libinput-multiplier}} をインストールして [[Xorg]] を再起動し、y軸のスクロール距離を6倍に拡大します。

$echo 6>/tmp/libinput_discrete_deltay_multiplier

フォーカス変更時に倍率を変更する場合 [https://github.com/tkkcc/libinput_patch#change-with-focused-window こちらを参照]

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

まず、{{ic|libinput debug-events}} を実行して問題をデバッグできないか確認してください。利用可能なオプションは {{man|1|libinput-debug-events}} を見てください。

入力デバイスによってはカーネルのサポートが必要なことがありますが、それを確認するには {{Pkg|evemu}} パッケージに含まれている ''evemu-describe'' を使います:

[http://ix.io/m6b software supported input trackpad driver] の出力を [https://github.com/whot/evemu-devices/blob/master/touchpads/SynPS2%20Synaptics%20TouchPad-with-scrollbuttons.events a supported trackpad] と比較して下さい (ABS_, ABS_MT, REL_X/Y)。クリックパッドの場合 {{ic|INPUT_PROP_BUTTONPAD}} プロパティも設定されます。

=== タッチパッドが GNOME で動作しない ===

以下のコマンドを実行してタッチパッドのイベントを GNOME デスクトップに送信してください:
$ gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled

さらに、GNOME によって特定の設定が上書きされ、タップがオフになったり強制的にナチュラルスクロールになることがあります。そのような場合、GNOME の {{ic|gsettings}} コマンドラインツールを使うか、適当なグラフィカルフロントエンドを使って設定を行ってください。例えば、タップを有効にしてナチュラルスクロールを無効化したい場合、以下のようにタッチパッドの設定値を変更します:
$ gsettings set org.gnome.desktop.peripherals.touchpad tap-to-click true
$ gsettings set org.gnome.desktop.peripherals.touchpad natural-scroll false

== 参照 ==

* [https://wayland.freedesktop.org/libinput/doc/latest/index.html libinput Wayland ドキュメント]
* [https://archive.fosdem.org/2015/schedule/event/libinput/attachments/slides/591/export/events/attachments/libinput/slides/591/libinput_xorg.pdf FOSDEM 2015 - libinput] - Hans de Goede によるプロジェクトの目標と計画についての説明
*[http://who-t.blogspot.com.au/ Peter Hutterer のブログ] - プロジェクトのハッカーによる libinput 関連の記事
* [https://www.youtube.com/watch?v=HllUoT_WE7Y Talk by the primary libinput maintainer] outlining the history and state (as of 2020) of Linux input device handling
* [https://who-t.blogspot.com/2018/07/why-its-not-good-idea-to-handle-evdev.html Blog post by the libinput maintainer] outlining the rationale for libinput

St

2024-03-10T09:55:22Z

Shota: Update of other languages

{{Lowercase title}}
[[Category:ターミナルエミュレータ]]
[[Category:Suckless]]
[[en:St]]
[[cs:St]]
[[pt:St]]
[[zh-hans:St]]
[http://st.suckless.org/ st] は [http://suckless.org suckless] による [[Xorg|X]] 向けのシンプルなターミナル実装です。[[xterm]] や [[urxvt]] を置き換える軽量なターミナルとして作られました。st は現在、256色、ほとんどの VT10X エスケープシーケンス、UTF-8、X11 コピー/ペースト、フォントのアンチエイリアス (fontconfig を使用)、フォールバックフォント、リサイズ、config.h によるショートカット、線画をサポートしています。

== インストール ==
{{AUR|st}} または {{AUR|st-git}} パッケージを[[インストール]]してください。

* [[Wayland]] では、st は Xwayland を使用します。Xwayland メモリフットプリントを回避して同様のターミナルを使用したい場合は、、{{AUR|wterm-git}} の使用を検討してください。

== 設定 ==

''st'' は、コンパイル時にコピーされる {{ic|config.h}} ファイルを介して構成されます。デフォルトは、ソースに含まれている{{ic|config.def.h}} です。独自の {{ic|config.h}} と [[PKGBUILD]] を自分でメンテナンスするようにしてください。

=== シェル ===

''st'' のデフォルトシェルを変更するには、以下の行を編集:

static char shell[] = "/bin/sh";

または、'st' の起動時にオプションの最後にシェルを指定します。

$ st ''options'' fish

=== ターミナル ===

ターミナルのタイプを変更するには、以下の行を編集:

static char *termname = "st-256color";

''st'' は {{ic|termname}} の値を {{ic|TERM}} 変数に設定します。

=== フォント ===

以下の行を自由に編集してください:

static char *font = "Liberation Mono:pixelsize=12:antialias=false:autohint=false";

コマンドラインでフォントの名前を指定することもできます:

$ st -f "Liberation Mono:size=12"
$ st -f 'Liberation Mono-12'

フォント名は fc-list で見つけることができます。

=== カーソル ===

デフォルトでは、マウスポインタは {{ic|XC_xterm;}} であり、見つけるのが難しいかもしれません。

カーソルテーマの通常のテーマに変更するには、以下を編集します:

static unsigned int mouseshape = XC_left_ptr;

=== カラー ===

以下の行を編集することで''前景''・''背景''・''カーソル''の色を設定できます:

unsigned int defaultfg = 7;
unsigned int defaultbg = 0;
static unsigned int defaultcs = 256;

上記の値は同一ファイルの {{ic|*colorname[]}} 配列を参照します。デフォルトの色を使うことも {{ic|#rrggbb}} という形式で色を追加することもできます。例:

static const char *colorname[] = {
/* 8 normal colors */
"black",
"red3",
"green3",
"yellow3",
"blue2",
"magenta3",
"cyan3",
"gray90",

/* 8 bright colors */
"gray50",
"red",
"green",
"yellow",
"#5c5cff",
"magenta",
"cyan",
"white",

[255] = 0,

/* more colors can be added after 255 to use with DefaultXX */
"#cccccc",
"#eeeeee",
"#111111",
};

/*
* Default colors (colorname index)
* foreground, background, cursor
*/
unsigned int defaultfg = 257;
unsigned int defaultbg = 258;
static unsigned int defaultcs = 256;

カラーパレットの作成を容易にするツールが存在します。例えば、 [https://terminal.sexy terminal sexy] にはあらかじめ用意されたものがあり、''st'' のフォーマットに直接エクスポートすることができます。([https://github.com/stayradiated/terminal.sexy/issues/22#issuecomment-430629424] を参照)。

Solarized カラースキームのパッチがあります。インストールするには、[https://st.suckless.org/patches/solarized/] を参照してください。

=== パッチ ===

[https://st.suckless.org/patches/alpha/ suckless website] から入手できるパッチはたくさんあります。パッチを適用するには、[https://www.gnu.org/software/diffutils/manual/html_node/Invoking-diff.html diff] をダウンロードし、 {{ic|patch -i patch.diff}} を使用して適用します。これにより、デフォルトの設定ファイル {{ic|config.def.h}} が変更されます。独自の {{ic|config.h}} を維持している場合は、 {{ic|config.h}} から {{ic|config.def.h}} に構成をコピーし、名前を {{ic|config.h}} に変更してから、 {{ic|make clean install}} を実行します。

=== デスクトップエントリ ===
以下のような[[デスクトップエントリ]]を作成することで、指定したフォントで ''st'' を簡単に起動できます (例: {{Pkg|adobe-source-code-pro-fonts}}):

{{hc|~/.local/share/applications/simple-terminal.desktop|2=
[Desktop Entry]
Name=Simple Terminal
GenericName=Terminal
Comment=standard terminal emulator for the X window system
Exec=st -t "Suckless Terminal" -f "Source Code Pro:style=Semibold:size=12" -g "80x24"
Terminal=false
Type=Application
Encoding=UTF-8
Icon=terminal
Categories=System;TerminalEmulator;
Keywords=shell;prompt;command;commandline;cmd;
}}

上記のメニューエントリはアプリケーションリストのシステムツールに ''Simple Terminal'' として表示されます。

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

==== キーボード ====

一部のアプリケーションで {{ic|Delete}} が正しく機能しない場合は、以下を {{ic|~/.inputrc}} または {{ic|/etc/inputrc}} に追加します。

set enable-keypad on

bash 上の IPython などの一部のアプリケーションで上記が動作しない場合、代わりに {{ic|enable-keypad}} をオフにして、st の [https://git.suckless.org/st/file/FAQ.html#l55 st FAQ] で紹介されているように、 {{ic|~/.bashrc}} に以下を追加してください。

printf '\033[?1h\033=' >/dev/tty

=== Vim ===
==== ''vim'' のテキストの背景色が文字でない部分に表示されない ====
{{ic|config.h}} の {{ic|termname}} を {{ic|st-256color}} に設定して再コンパイルしてみてください。シェルの中で {{ic|TERM}} 変数は設定しないでください。{{ic|st-256color}} に設定すると問題が発生します。

{{ic|.vimrc}} ファイルに以下の行を記述するという解決方法もあります:

if &term =~ '256color'
" disable Background Color Erase (BCE) so that color schemes
" render properly when inside 256-color tmux and GNU screen.
" see also http://sunaku.github.io/vim-256color-bce.html
set t_ut=
endif

==== 256color と truecolor が tmux などで機能しない ====

まず、この [https://bbs.archlinux.org/viewtopic.php?pid=1755862#p1755862 スレッド] で説明されているように、 {{ic|~/.bashrc}} で {{ic|TERM}} の値を設定およびエクスポートしていないことを確認してください
{{note|{{ic|TERM}} を明示的に設定しないでください。 {{ic|tmux.conf}} で {{ic|default-terminal}} 設定を設定して正しく実行してください}}

次に使用している vim のバージョンが '''{{ic|1=>=7.4.1799}}''' であることを確認します。これは、 {{ic|termguicolors}} が追加されたときです。

最後に、以下を {{ic|~/.vimrc}} に追加します:

set t_8f=^[[38;2;%lu;%lu;%lum " set foreground color
set t_8b=^[[48;2;%lu;%lu;%lum " set background color
colorscheme Tomorrow-Night-Eighties
set t_Co=256 " Enable 256 colors
set termguicolors " Enable GUI colors for the terminal to get truecolor

{{note|{{ic|^[}} は、{{ic|t_8f}} と {{ic|t_8b}}の各値の前に付けるリテラルエスケープ(<Esc>)文字です。これは単一の文字であり、{{ic | vim}}で再現できます。 '''INSERT''' モードで、{{ic|<C-v>-<Esc>}} を押します(Control+v を押してから Esc を押します)。引き続き '''INSERT''' モードになります。もう一度 <Esc> を押すと、 '''NORMAL''' モードに戻ります。

{{tip|{{ic|colorscheme}}、{{ic|t_Co}}、{{ic|を設定する前に、{{ic|t_8f}} と {{ic|t_8b}} の値を設定することをお勧めします。 termguicolors}}.}}

詳細については、{{ic|vim}} の {{ic|:help}} を参照してください: {{ic|xterm-true-color}}、{{ic|t_8f}}、{{ic|t_8b}}
}}

=== ページに絵文字が含まれているとクラッシュする ===

[https://lists.suckless.org/dev/1707/31965.html グリフが関連付けられていない] カラー絵文字を含むページを読み込もうとすると、st がクラッシュする可能性があります。特に、 {{Pkg|ttf-joypixels}} などのフォントで見られる場合、別の端末から実行すると、次のようなものが返されます。

X Error of failed request: BadLength (poly request too large or internal Xlib length error)
Major opcode of failed request: 139 (RENDER)
Minor opcode of failed request: 20 (RenderAddGlyphs)
Serial number of failed request: 5118
Current serial number in output stream: 5209

これを修正するには、Unicode カバレッジ用に {{AUR|ttf-symbola}} をインストールするだけです。

別の解決策は、 {{AUR|libxft-bgra}} パッケージをインストールすることです。これによりカラー絵文字をサポートするパッチバージョンの libXft が提供されます。

== 参照 ==
*[http://st.suckless.org/ ホームページ]
*[http://git.suckless.org/st/plain/FAQ よくある質問]
*[http://git.suckless.org/st/ 公式 git リポジトリ]

アプリケーション一覧/マルチメディア

2023-07-04T05:47:43Z

Shota: /* Graphical image viewers */ nomacs が AUR に移動

<noinclude>
[[Category:アプリケーション]]
[[Category:マルチメディア]]
[[Category:ソフトウェア一覧]]
[[en:List of applications/Multimedia]]
[[es:List of applications/Multimedia]]
[[it:List of applications/Multimedia]]
[[ru:List of applications/Multimedia]]
[[uk:List of applications/Multimedia]]
[[zh-hans:List of applications/Multimedia]]
[[zh-hant:List of applications/Multimedia]]
{{List of Applications navigation}}
</noinclude>
== マルチメディア ==

=== コーデック ===

次の記事を参照してください: [[コーデック]]。

=== 画像 ===

==== 画像ビューア ====

See also [[Wikipedia:Comparison of image viewers]].

===== Framebuffer image viewers =====

* {{App|fbi|Linux フレームバッファコンソールの為の画像ビューア。|https://www.kraxel.org/blog/linux/fbida/|{{Pkg|fbida}}}}
* {{App|fbv|フレームバッファコンソール用のとてもシンプルな画像ファイルビューア。|http://s-tech.elsat.net.pl/fbv/|{{Pkg|fbv}}}}
* {{App|fim|広範囲にカスタマイズできるスクリプト可能なフレームバッファ画像ビューア、fbi ベース。|https://www.nongnu.org/fbi-improved/|{{AUR|fim}}}}
* {{App|jfbview|フレームバッファPDF/画像ビューア、Imlib2 ベース。Vim の様な操作性、回転とズーム、フィットの為のズーム、素早いマルチスレッドレンダリングなどの特徴があります。|https://github.com/jichu4n/jfbview|{{AUR|jfbview}}}}

===== Graphical image viewers =====

* {{App|CoreImage|Simple lightweight easy to use image viewer based on Qt. Part of C-Suite.|https://cubocore.org/|{{AUR|coreimage}}}}
* {{App|Deepin Image Viewer|Deepin デスクトップ環境の画像ビューア。|https://www.deepin.org/en/original/deepin-image-viewer/|{{Pkg|deepin-image-viewer}}}}
* {{App|Ephoto|EFL ベースの軽量な画像ビューア。|https://www.enlightenment.org/about-ephoto|{{AUR|ephoto}}}}
* {{App|[[Wikipedia:Eye_of_GNOME|Eye of GNOME]]|画像回覧・カタログ表示プログラム、GNOME デスクトップ環境の一部。|https://wiki.gnome.org/Apps/EyeOfGnome|{{Pkg|eog}}}}
* {{App|Eye of MATE|MATE デスクトップのシンプルな画像ビューア。|https://github.com/mate-desktop/eom|{{Pkg|eom}}}}
* {{App|EyeSight|Hawaii デスクトップ環境の画像ビューア。|https://github.com/hawaii-desktop/eyesight|{{AUR|eyesight}}}}
* {{App|[[feh]]|imlib2 を使う、高速で軽量な画像ビューア。|https://feh.finalrewind.org/|{{Pkg|feh}}}}
* {{App|GalaPix|OpenGL ベースの画像ビューア、大きな画像コレクションを同時に回覧・ズーム。|https://github.com/Galapix/galapix|{{AUR|galapix}}}}
* {{App|[[Wikipedia:Geeqie|Geeqie]]|RAW ファイルのサポートなどの機能が追加されている画像ブラウザ・ビューア (GQview のフォーク)。|http://geeqie.org/|{{Pkg|geeqie}}}}
* {{App|GPicView|シンプルで高速な X 用画像ビューア、[[LXDE]] デスクトップの一部。|http://lxde.sourceforge.net/gpicview/|{{Pkg|gpicview}}}}
* {{App|[[Wikipedia:Gwenview|Gwenview]]|KDE デスクトップ用の高速で簡単に使える画像ビューア。|https://apps.kde.org/gwenview|{{Pkg|gwenview}}}}
* {{App|ida|X11 application (Motif based) for viewing images.|https://www.kraxel.org/blog/linux/fbida/|{{Pkg|fbida}} + {{Pkg|libxpm}} + {{Pkg|openmotif}}}}
* {{App|imv|Wayland やアニメーション GIF にも対応している軽量な画像ビューア which uses FreeImage.|https://www.github.com/eXeC64/imv/|{{Pkg|imv}}}}
* {{App|Koko|Image viewer designed for desktop and touch devices.|https://apps.kde.org/koko/|{{AUR|koko}}}}
* {{App|KuickShow|Fast and convenient image viewer for KDE.|https://userbase.kde.org/KuickShow|{{Pkg|kuickshow}}}}
* {{App|LxImage-Qt|LXQt の画像ビューア。|https://github.com/lxde/lximage-qt|{{Pkg|lximage-qt}}}}
* {{App|meh|XLib だけを使用する small・単純・高速な画像ビューア。|https://www.johnhawthorn.com/meh/|{{AUR|meh-git}}}}
* {{App|Mirage|画像の切り取り・リサイズなどの機能、カスタムアクション、サムネイルパネルをサポートしている PyGTK 画像ビューア。|https://sourceforge.net/projects/mirageiv.berlios/|{{AUR|mirage}}}}
* {{App|nomacs|Qt 画像ビューア。機能豊富でありながら起動が速く、設定で様々なウィジェットを表示できます or only the image.|https://nomacs.org/|{{AUR|nomacs}}}}
* {{App|PhotoQt|シンプルで使いやすいインターフェイスを持つ、高速で細かい設定が可能な画像ビューア。|https://photoqt.org/|{{AUR|photoqt}}}}
* {{App|pqiv|GTK 3 based command-line image viewer with a minimal UI supporting images in compressed archives, rewrite of qiv.|https://github.com/phillipberndt/pqiv/|{{Pkg|pqiv}}}}
* {{App|qimgv|Fast and easy to use Qt5 image viewer. Supports webm/mp4 playback via mpv.|https://github.com/easymodo/qimgv/|{{AUR|qimgv}}}}
* {{App|qeh|Actually fast and simple image viewer. Like feh but faster and simpler, and support for more formats.|https://github.com/sandsmark/qeh/|{{AUR|qeh-git}}}}
* {{App|Quick Image Viewer|GTK と imlib2 を基にした非常に小さく高速な画像ビューア。|http://spiegl.de/qiv/|{{Pkg|qiv}}}}
* {{App|qView|Qt image viewer designed with minimalism and usability in mind.|https://interversehq.com/qview/|{{AUR|qview}}}}
* {{App|Ristretto|Xfce デスクトップ環境向けの高速で軽量な画像ビューア。|https://docs.xfce.org/apps/ristretto/start|{{Pkg|ristretto}}}}
* {{App|shufti|画像やファイルのディレクトリによってズームレベルや回転、ウィンドウサイズやデスクトップの位置・表示エリアの非破壊的な保存と復元ができるツール。|https://github.com/danboid/shufti|{{AUR|shufti}}}}
* {{App|[[sxiv]]|タイル型ウィンドウマネージャと上手く動作する imlib2 を使ったシンプルな画像ビューア。|https://github.com/muennich/sxiv|{{Pkg|sxiv}}}}
* {{App|Viewnior|画像の反転・回転・アニメーション機能と設定できるマウスアクション機能を持った最小主義の GTK 画像ビューア。|https://siyanpanayotov.com/project/viewnior|{{Pkg|viewnior}}}}
* {{App|Vimiv|vim ライクなキーバインドを備えた画像ビューア。Gtk3 ツールキットを使って Python 3 で書かれています。|https://karlch.github.io/vimiv/|{{Pkg|vimiv}}}}
* {{App|Vimiv (Qt port)|vim ライクなキーバインドを備えた画像ビューア。It is written in python3 and PyQt5.|https://karlch.github.io/vimiv-qt/|{{AUR|vimiv-qt}}}}
* {{App|vpv|Image viewer designed for scientific image visualization.|https://github.com/kidanger/vpv|{{AUR|vpv}}}}
* {{App|Xloadimage|クラシックな X 画像ビューア。|https://sioseis.ucsd.edu/xloadimage.html{{Dead link|2021|05|17|status=SSL error}}|{{Pkg|xloadimage}}}}

==== Image organizers ====

See also [[Wikipedia:Image organizer]].

* {{App|Deepin Album|Photo manager for viewing and organizing pictures, for Deepin desktop.|https://github.com/linuxdeepin/deepin-album|{{Pkg|deepin-album}}}}
* {{App|[[Wikipedia:digiKam|digiKam]]|プラグイン方式の編集機能を備えている KDE ベースの画像管理ソフト。digiKam は RAW 現像や画像編集ができる他の似たアプリケーションよりも多くの機能があると主張しています。|https://www.digikam.org/|{{Pkg|digikam}}}}
* {{App|Frogr|Small application for the GNOME desktop that allows users to manage their accounts in the Flickr image hosting website.|https://wiki.gnome.org/Apps/Frogr|{{AUR|frogr}}}}
* {{App|GNOME Photos|GNOME で写真を表示・管理・共有。|https://wiki.gnome.org/Apps/Photos|{{Pkg|gnome-photos}}}}
* {{App|[[Wikipedia:GThumb|gThumb]]|GNOME デスクトップ用の画像ビューア and browser。|https://wiki.gnome.org/Apps/Gthumb|{{Pkg|gthumb}}}}
* {{App|[[Wikipedia:KPhotoAlbum|KPhotoAlbum]]|Digital image cataloging software that supports annotation, browsing, searching and viewing of digital images and videos.|https://www.kphotoalbum.org/|{{Pkg|kphotoalbum}}}}
* {{App|Memories|Image viewer and manager designed for elementary OS.|https://anufrij.org/memories/|{{AUR|showmypictures}}}}
* {{App|Pantheon Photos|Photo organizer for Pantheon.|https://launchpad.net/pantheon-photos|{{Pkg|pantheon-photos}}}}
* {{App|PhotoPrism|Personal Photo Management powered by Go and Google TensorFlow|https://photoprism.app/|{{AUR|photoprism}}}}
* {{App|Phototonic|Fast and functional image viewer and browser (Qt).|https://github.com/oferkv/phototonic/|{{Pkg|phototonic}}}}
* {{App|Pix|Image gallery and image viewer that can be used to open images with other applications like an image editor, add tags to the files, add annotations to pictures, rotate and share them.|https://apps.kde.org/pix/|{{Pkg|maui-pix}}}}
* {{App|Pix|Image viewer and browser based on gthumb. X-Apps Project.|https://github.com/linuxmint/pix|{{AUR|pix}}}}
* {{App|Rapid Photo Downloader|Download photos and videos from cameras, memory cards and portable storage devices.|https://www.damonlynch.net/rapid/|{{Pkg|rapid-photo-downloader}}}}
* {{App|[[Wikipedia:Shotwell_(software)|Shotwell]]|GNOME デスクトップ環境のために作られたデジタル写真オーガナイザー。|https://wiki.gnome.org/Apps/Shotwell|{{Pkg|shotwell}}}}

==== Image processing ====

* {{App|CairoSVG|SVG to PNG, PDF, PS converter.|https://cairosvg.org/|{{Pkg|python-cairosvg}}}}
* {{App|Converseen|Qt-based batch image converter and resizer.|https://converseen.fasterland.net/|{{Pkg|converseen}}}}
* {{App|CropGUI|GTK utility for lossless cropping and rotation of jpeg files|https://github.com/jepler/cropgui|{{AUR|cropgui}}}}
* {{App|[[Wikipedia:dcraw|dcraw]]|多数のカメラの RAW 形式を変換。|https://dechifro.org/dcraw/|{{Pkg|dcraw}}}}
* {{App|[[Wikipedia:G'MIC|G'MIC]]|画像処理のためのフル機能のオープンソースフレームワーク。1d スカラ信号から 3d+t マルチスペクトル立体画像, including 2d color images まで様々なユーザーインターフェイスで画像データセットの変換・操作・フィルタリング・視覚化ができます。|https://www.gmic.eu/|{{Pkg|gmic}}}}
* {{App|[[Wikipedia:GraphicsMagick|GraphicsMagick]]|API の保持とコマンドラインの安定を目指して作られた ImageMagick のフォーク。パフォーマンスを高めるためにマルチコアもサポートしており、そのパフォーマンスが買われて多くの商用サイト (Flickr, etsy) で使われています。|http://www.graphicsmagick.org/|{{Pkg|graphicsmagick}}}}
* {{App|[[ImageMagick]]|コマンドライン画像編集プログラム。100 以上のフォーマットの正確なコンバートをサポートしていることで知られています。基本的に API を使ってスクリプトを作りバックエンドで処理するのに使われます。|https://www.imagemagick.org/script/index.php|{{Pkg|imagemagick}}}}
* {{App|PosteRazor|Cut an image or PDF into pieces which can be printed and assembled to a poster|https://posterazor.sourceforge.io/|{{Pkg|posterazor}}}}

===== Image compression =====

====== Console ======

* {{App|[[Wikipedia:Guetzli|Guetzli]]|A perceptual JPEG encoder, aiming for excellent compression density at high visual quality.|https://github.com/google/guetzli|{{Pkg|guetzli}}}}
* {{App|jpegoptim|JPEG optimization utility providing lossless and lossy compression.|https://www.kokkonen.net/tjko/projects.html#jpegoptim|{{Pkg|jpegoptim}}}}
* {{App|optipng|Lossless PNG compressor.|http://optipng.sourceforge.net/|{{Pkg|optipng}}}}
* {{App|oxipng|Lossless multithreaded PNG compressor.|https://github.com/shssoichiro/oxipng|{{Pkg|oxipng}}}}
* {{App|pngcrush|Tool for optimizing the compression of PNG files.|https://pmt.sourceforge.io/pngcrush/|{{Pkg|pngcrush}}}}
* {{App|pngquant|Lossy compression of PNG images.|https://pngquant.org/|{{Pkg|pngquant}}}}
* {{App|zopflipng|Highly efficient PNG optimisation tool using Google's zopfli library|https://github.com/google/zopfli|{{AUR|zopflipng-git}}}}

====== Graphical ======

* {{App|Curtail|GTK-based image compressor, supporting PNG and JPEG file types.|https://github.com/Huluti/Curtail|{{Pkg|curtail}}}}
* {{App|Image Optimizer|Simple lossless image optimizer built with Vala and Gtk for Elementary OS.|https://github.com/GijsGoudzwaard/Image-Optimizer|{{AUR|image-optimizer-git}}}}
* {{App|Trimage|Qt-based tool for optimizing PNG and JPG files.|https://trimage.org/|{{AUR|trimage}}}}

==== ラスタ画像 editors ====

See also [[Wikipedia:Comparison of raster graphics editors]].

* {{App|AzPainter|ペイントソフトウェア for illustration drawing.|https://gitlab.com/azelpg/azpainter|{{AUR|azpainter}}}}
* {{App|CorePaint|Simple bitmap painting tool to produce very simple graphics. Part of C-Suite.|https://cubocore.org/|{{AUR|corepaint}}}}
* {{App|Deepin Draw|Lightweight drawing tool for Deepin desktop.|https://github.com/linuxdeepin/deepin-draw|{{Pkg|deepin-draw}}}}
* {{App|Drawing|Drawing application for the GNOME desktop, using Cairo and GdkPixbuf for basic drawing operations.|https://github.com/maoschanz/drawing|{{Pkg|drawing}}}}
* {{App|Drawpile|Collaborative drawing program that allows multiple users to sketch on the same canvas simultaneously.|https://drawpile.net/|{{AUR|drawpile}}}}
* {{App|[[GIMP]]|[[Wikipedia:ja:Adobe Photoshop|Adobe Photoshop]] などのプロプライエタリエディタに似ている画像編集スイート。GIMP ([[GNU プロジェクト|GNU]] Image Manipulation Program) は 1990 年代半ばに開発がスタートし、今では多くの[[GIMP/CMYK サポート|プラグイン]]と追加機能を持っています。|https://www.gimp.org/|{{Pkg|gimp}}}}
* {{App|Glimpse|A fork of GIMP, usability-focused free software application capable of expert level image manipulation.|https://glimpse-editor.github.io/|{{AUR|glimpse-editor}}{{Broken package link|package not found}}}}
* {{App|[[Wikipedia:GNU Paint|Gpaint]]|GNOME 用の [[Wikipedia:PC_Paintbrush|Paintbrush]] クローン。|https://www.gnu.org/software/gpaint/|{{AUR|gpaint}}}}
* {{App|[[Wikipedia:GrafX2|GrafX2]]|Bitmap paint program specialized in 256 color drawing.|http://grafx2.chez.com/|{{Pkg|grafx2}}}}
* {{App|ImEditor|Simple and versatile image editor.|https://imeditor.github.io/|{{AUR|imeditor}}}}
* {{App|[[Wikipedia:KolourPaint|KolourPaint]]|フリーの、KDE 用ラスタ画像エディタ。Windows 7 以前の Microsoft ペイントに似ていますが、透過などの追加機能を備えています。Part of {{Grp|kde-applications}} and {{Grp|kde-graphics}} groups.|http://kolourpaint.org/|{{Pkg|kolourpaint}}}}
* {{App|[[Wikipedia:Krita|Krita]]|KDE プラットフォームのデジタルペインティング・イラストレーションソフトウェア。|https://krita.org/|{{Pkg|krita}}}}
* {{App|Milton|Infinite-canvas paint program.|https://www.miltonpaint.com/|{{AUR|milton}}}}
* {{App|mtPaint|パレットがインデックスされた画像やピクセルアート向けの画像編集プログラム。|http://mtpaint.sourceforge.net/|{{Pkg|mtpaint}}}}
* {{App|[[Wikipedia:MyPaint|MyPaint]]|デジタルペインター向けのフリーグラフィックアプリケーション。|http://mypaint.org|{{Pkg|mypaint}}}}
* {{App|PhotoFlare|Simple but powerful image editor originally inspired by PhotoFiltre.|https://photoflare.io/|{{Pkg|photoflare}}}}
* {{App|[[Wikipedia:Pinta (software)|Pinta]]|[[Wikipedia:ja:Paint.NET|Paint.NET]] に倣ったお絵かきプログラム。カジュアルユーザー向けのシンプルな GIMP 代替を提供することが目標。|https://pinta-project.com/|{{Pkg|pinta}}}}
* {{App|Pixelitor|Advanced image editor with support for layers, layer masks, text layers, multiple undo, blending modes, cropping, Gaussian blurring, unsharp masking, histograms, etc.|https://pixelitor.sourceforge.io/|{{AUR|pixelitor}}}}
* {{App|Swappy|Wayland native snapshot editing tool.|https://github.com/jtheoof/swappy|{{Pkg|swappy}}}}
* {{App|[[Wikipedia:XPaint|XPaint]]|多くの標準的なペイントプログラムが持っている機能を持ったカラー画像編集ツール。|https://sourceforge.net/projects/sf-xpaint/|{{AUR|xpaint}}}}

[[Wikipedia:digiKam|digiKam]], Ephoto, GNOME Photos, [[Wikipedia:GThumb|gThumb]], ida, nomacs, Pantheon Photos, Phototonic and [[Wikipedia:Shotwell_(software)|Shotwell]] などの画像ビューア and organizers では基本的な画像編集もできます。

==== Specialized photo editors ====

* {{App|[[Wikipedia:darktable|darktable]]|撮影ワークフローや RAW 現像をするためのアプリケーション。|https://www.darktable.org/|{{Pkg|darktable}}}}
* {{App|Filmulator|Simple raw photo editor based on the process of developing film.|https://filmulator.org/|{{AUR|filmulator}}}}
* {{App|FOSStriangulator|Tool for making triangulated illustrations out of photos.|https://github.com/FOSStriangulator/FOSStriangulator|{{AUR|fosstriangulator}}}}
* {{App|[[Wikipedia:Hugin (software)|Hugin]]|Panorama photo stitcher.|http://hugin.sourceforge.net/|{{Pkg|hugin}}}}
* {{App|[[Wikipedia:LightZone|LightZone]]|Professional-level digital darkroom and photo editor comparable to Photoshop Lightroom.|http://lightzoneproject.org/|{{AUR|lightzone}}}}
* {{App|[[Wikipedia:Luminance HDR|Luminance HDR]]|HDR イメージングのワークフローを提供する、オープンソースのグラフィカルユーザーインターフェースアプリケーション。|http://qtpfsgui.sourceforge.net/|{{Pkg|luminancehdr}}}}
* {{App|[[Wikipedia:UFRaw|nUFRaw]]|Utility to read and manipulate raw images from digital cameras using DCRaw.|https://sourceforge.net/projects/nufraw/|{{Pkg|gimp-nufraw}}}}
* {{App|Oqapy|Photographic workflow application.|https://oqapy.eu/|{{AUR|oqapy}}}}
* {{App|[[Wikipedia:Rawstudio|Rawstudio]]|Raw-image converter written in GTK.|https://rawstudio.org/|{{AUR|rawstudio}}}}
* {{App|[[Wikipedia:RawTherapee|RawTherapee]]|強力なクロスプラットフォームの raw 画像処理プログラム。|https://www.rawtherapee.com/|{{Pkg|rawtherapee}}}}
* {{App|Showfoto|Photo editor with powerful image editing tools.|https://www.digikam.org/|{{Pkg|digikam}}}}

==== Photo geotagging ====

* {{App|Geotag|Match date/time information from photos with location information from a GPS unit or from a map.|http://geotag.sourceforge.net/|{{Pkg|geotag}}}}
* {{App|Geotagging|Photography geotagging tool to synchronize photos with gps track log (GPX).|https://github.com/jmlich/geotagging|{{AUR|geotagging}}}}
* {{App|GottenGeography|Easy to use photo geotagging application for the GNOME desktop.|https://launchpad.net/gottengeography|{{Pkg|gottengeography}}}}
* {{App|GPicSync|Inserts location in your pictures metadata from a GPS tracklog.|https://github.com/FrancoisSchnell/GPicSync|{{AUR|gpicsync}}}}
* {{App|GPSCorrelate|Correlate (geotagging) digital camera photos with GPS data in GPX format.|https://github.com/freefoote/gpscorrelate|{{Pkg|gpscorrelate}}}}

==== ベクタ画像 editors ====

See also [[Wikipedia:Comparison of vector graphics editors]].

* {{App|[[Wikipedia:Dia (software)|Dia]]|GTK ベースの作図プログラム。|https://wiki.gnome.org/Apps/Dia|{{Pkg|dia}}}}
* {{App|diagrams.net|Diagram drawing application built on web technology. Based on the [https://electronjs.org/ Electron] platform.|https://www.diagrams.net/|{{AUR|drawio-desktop}}}}
* {{App|Dot Matrix|The glyph playground of creativity from simple lines.|https://github.com/lainsce/dot-matrix/|{{AUR|dot-matrix}}}}
* {{App|Figma|Unofficial desktop application for Figma collaborative design tool. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/Figma-Linux/figma-linux|{{AUR|figma-linux}}}}
* {{App|Gravit Designer|Proprietary vector design application. Based on the [https://electronjs.org/ Electron] platform.|https://designer.io/|{{AUR|gravit-designer-bin}}}}
* {{App|[[Inkscape]]|ベクタ画像エディタ。[[Wikipedia:ja:Adobe Illustrator|Illustrator]], [[Wikipedia:ja:CorelDRAW|CorelDraw]], [[Wikipedia:Xara X|Xara X]] に似た機能を持ち SVG (Scalable Vector Graphics) ファイルフォーマットを使うことができます。Inkscape は多くの高度な SVG 機能をサポートしており（マーカー、クローン、アルファブレンドなど）、すっきりしたインターフェースを持っています。ノードの編集、複雑なパス操作、ビットマップのトレースなどを簡単に行えます。また、開かれた、コミュニティ貢献の開発によってユーザーと開発者のコミュニティは非常に活発です。|https://inkscape.org/|{{Pkg|inkscape}}}}
* {{App|[[Wikipedia:Karbon (software)|Karbon]]|ベクタ画像エディタ、Calligra スイートの一部。|https://www.calligra.org/karbon/|{{Pkg|calligra}}}}
* {{App|[[LibreOffice|LibreOffice Draw]]|Vector graphics editor and diagramming tool included in the LibreOffice suite similar to Microsoft Visio.|https://www.libreoffice.org/discover/draw/|{{Pkg|libreoffice-still}} or {{Pkg|libreoffice-fresh}}}}
* {{App|Mockingbot|Proprietary prototyping & collaboration design tool. Based on the [https://electronjs.org/ Electron] platform.|https://mockingbot.com/|{{AUR|mockingbot}}}}
* {{App|[[OpenOffice|OpenOffice Draw]]|Vector graphics editor and diagramming tool included in the OpenOffice suite.|https://www.openoffice.org/product/draw.html|{{AUR|openoffice-bin}}}}
* {{App|Pencil Project|GUI プロトタイピング・モックアップツール。Based on the [https://electronjs.org/ Electron] platform.|https://pencil.evolus.vn/|{{AUR|pencil}}}}
* {{App|[[Wikipedia:SK1 (program)|sK1]]|Adobe Illustrator や CorelDraw の代替、PostScript や PDF ですぐに出力できるようになっています。|https://sk1project.net/|{{AUR|sk1}}}}
* {{App|SvgVi|SVG viewer and editor using XML declarations.|https://gitlab.com/pwmc/svgvi|{{AUR|svgvi}}}}
* {{App|[[Wikipedia:yEd|yEd]]||多目的の proprietary ダイアグラム作成プログラム。フローチャート、ネットワーク図、UML ダイアグラム、BPMN ダイアグラム、マインドマップ、組織図、実体関連 (ER) 図。|https://www.yworks.com/products/yed|{{AUR|yed}}}}
* {{App|[[Wikipedia:Xfig|Xfig]]|Interactive drawing tool.|http://mcj.sourceforge.net/|{{AUR|xfig}}}}

==== Font editors ====

See also [[Wikipedia:Comparison of font editors]].

* {{App|Birdfont|Font editor which lets you create vector graphics and export TTF, EOT and SVG fonts.|https://birdfont.org/|{{Pkg|birdfont}}}}
* {{App|[[Wikipedia:FontForge|FontForge]]|Outline font editor.|https://fontforge.github.io/|{{Pkg|fontforge}}}}
* {{App|TruFont|Font-editing application.|https://trufont.github.io/|{{AUR|trufont}}}}

==== 2D animation ====
* {{App|enve|Flexible, user expandable 2D animation software.|https://maurycyliebner.github.io/|{{AUR|enve-git}}}}
* {{App|Glaxnimate|Vector 2D animation software, mainly for Lottie and TGS formats, but have a good standard animated SVG export|https://glaxnimate.mattbas.org/|{{AUR|glaxnimate}}}}
* {{App|[[Wikipedia:Toonz|OpenToonz]]|2D animation creation software.|https://opentoonz.github.io/e/|{{Pkg|opentoonz}}}}
* {{App|[[Wikipedia:Pencil2D|Pencil2D]]|Easy, intuitive tool to make 2D hand-drawn animations.|https://www.pencil2d.org/|{{Pkg|pencil2d}}}}
* {{App|qStopMotion|Application for creating stop-motion animation movies. The users will be able to create stop-motions from pictures imported from a camera or from the harddrive and export the animation to different video formats such as mpeg or avi.|http://qstopmotion.org/|{{Pkg|qstopmotion}}}}
* {{App|Scribl|Application to create simple video lectures that combine audio with hand-drawn animation.|https://www.scribl.ink/|{{AUR|scribl}}}}
* {{App|Stopmotion|Application to create stop-motion animations. It helps you capture and edit the frames of your animation and export them as a single file.|http://linuxstopmotion.org/|{{AUR|stopmotion}}}}
* {{App|[[Wikipedia:Synfig|Synfig Studio]]|2D animation software, designed as powerful industrial-strength solution for creating film-quality animation using a vector and bitmap artwork.|https://www.synfig.org/|{{Pkg|synfigstudio}}}}
* {{App|[[Wikipedia:Tupi (software)|TupiTube Desk]]|Desktop application to create and share 2D animations, focused on kids and teenagers.|https://www.maefloresta.com/|{{Pkg|tupitube}}}}
* {{App|Aseprite|Pixel art 2d animation|https://www.aseprite.org/|{{AUR|aseprite}}}}
* {{App|Pixelorama|Pixel art 2d animation|https://orama-interactive.itch.io/pixelorama|{{AUR|pixelorama}}}}

The drawing application [[Wikipedia:Krita|Krita]] and the 3D editor [[Blender]] (Grease Pencil mode) have both 2D animation features too.

==== 3D computer graphics ====

See also [[Wikipedia:Comparison of 3D computer graphics software]].

* {{App|Art of Illusion|Java で書かれた 3D モデリング・レンダリングスタジオ。|http://www.artofillusion.org/|{{AUR|aoi}}}}
* {{App|[[Blender]]|3D モデリング、テキスチャ、アニメーションなどの機能を持った完全一体型の 3D グラフィック創作スイート。|https://www.blender.org/|{{Pkg|blender}}}}
* {{App|CloudCompare|3D point cloud and mesh processing software.|https://cloudcompare.org/|{{AUR|cloudcompare}}}}
* {{App|Dust3D|3D modeling software. It helps you create a 3D watertight base model in seconds. Use it to speed up your character modeling in game making, 3D printing, and so on.|https://dust3d.org/|{{AUR|dust3d}}}}
* {{App|F3D|A fast and minimalist KISS 3D viewer. Supported file formats: VTK (legacy and XML), STL, GLTF, PLY, OBJ, 3DS, …|https://f3d-app.github.io/f3d/|{{AUR|f3d}}}}
* {{App|Goxel|Open Source 3D voxel editor.|https://goxel.xyz/|{{Pkg|goxel}}}}
* {{App|[[Wikipedia:MakeHuman|MakeHuman™]]|人間の体を作成するための Parametrical モデルのプログラム。|http://www.makehumancommunity.org/|{{AUR|makehuman}}}}
* {{App|MeshLab|System for processing and editing 3D triangular meshes.|https://www.meshlab.net/|{{AUR|meshlab}}}}
* {{App|[[Wikipedia:Sweet_Home_3D|Sweet Home 3D]]|Interior design software application for the planning and development of floor plans|http://sweethome3d.com/|{{Pkg|sweethome3d}}}}
* {{App|[[Wikipedia:POV-Ray|POV-Ray]]|3D グラフィックを作成するスクリプトベースのレイトレーシングソフトウェア。|https://www.povray.org/|{{Pkg|povray}}}}
* {{App|VoxelShop|Extremely intuitive and powerful software to modify and create voxel objects.|https://blackflux.com/node/11{{Dead link|2021|05|17|status=SSL error}}|{{AUR|voxelshop}}}}
* {{App|[[Wikipedia:Wings3d|Wings 3D]]|パワフルで使いやすい先進的なサブディビジョンモデラー。|http://www.wings3d.com/|{{AUR|wings3d}}}}

==== Color pickers and palettes ====

* {{App|Agave|Colorscheme designer tool for GNOME.|https://web.archive.org/web/20170327063642/http://home.gna.org/colorscheme/|{{AUR|agave}}}}
* {{App|Chameleon|Simple color picker for X11 which outputs colors to stdout.|https://github.com/seebye/chameleon|{{AUR|chameleon-git}}}}
* {{App|ColorGrab|Cross-platform color picker.|https://github.com/nielssp/colorgrab|{{AUR|colorgrab}}}}
* {{App|Color Palette|Tool for viewing the GNOME color palette as defined by the design guidelines.|https://gitlab.gnome.org/World/design/palette|{{AUR|palette}}}}
* {{App|colorpicker|Click on a pixel on your screen and print its color value in RGB. Written for X11.|https://github.com/Jack12816/colorpicker|{{AUR|colorpicker}}}}
* {{App|Color Picker|Simplistic color picker for the Pantheon desktop.|https://github.com/RonnyDo/ColorPicker|{{AUR|color-picker}}}}
* {{App|Coulr|Color box to help developers and designers.|https://github.com/Huluti/Coulr|{{AUR|coulr}}}}
* {{App|Deepin Picker|Color picker tool for Deepin desktop.|https://www.deepin.org/en/original/deepin-picker/|{{Pkg|deepin-picker}}}}
* {{App|delicolour|Lightweight GTK 3 color finder.|https://github.com/eepp/delicolour|{{AUR|delicolour}}}}
* {{App|gcolor2|Simple GTK 2 color selector.|http://gcolor2.sourceforge.net/|{{Pkg|gcolor2}}}}
* {{App|Gcolor3|Simple GTK 3 color selector.|https://www.hjdskes.nl/projects/gcolor3/|{{Pkg|gcolor3}}}}
* {{App|GPick|Advanced color picker tool.|http://www.gpick.org/|{{Pkg|gpick}}}}
* {{App|KColorChooser|Simple application to select the color from the screen or from a pallete. Part of {{Grp|kde-graphics}}.|https://apps.kde.org/kcolorchooser/|{{Pkg|kcolorchooser}}}}
* {{App|Kontrast|Tool to check contrast for colors that allows verifying that your colors are correctly accessible. Part of {{Grp|kde-accessibility}}.|https://apps.kde.org/kontrast/|{{Pkg|kontrast}}}}
* {{App|MATE Color Selection|Choose colors from the palette or the screen. Run with {{ic|mate-color-select}}.|https://mate-desktop.org/|{{Pkg|mate-desktop}}}}
* {{App|Pick|Simple color picker tool for the Linux desktop.|https://www.kryogenix.org/code/pick|{{AUR|pick-colour-picker}}}}
* {{App|PrestoPalette|An artist's tool for creating harmonious color palettes.|https://github.com/PrestoPalette/PrestoPalette|{{AUR|prestopalette}}}}
* {{App|xcolor|Lightweight color picker for X11.|https://soft.github.io/xcolor/|{{Pkg|xcolor}}}}

==== スクリーンキャプチャ ====

[[スクリーンショットの取得#専用のソフトウェア]] を参照してください。

==== Digital camera managers ====

See [[gPhoto#Installation]].

=== 音声 ===

==== オーディオシステム ====

See also the main article [[サウンドシステム]] and [[Wikipedia:ja:サウンドサーバ]].

==== オーディオプレイヤー ====

See also [[Wikipedia:Comparison of audio player software]].

Many applications in the [[#Video players]] section also support audio playback.

===== Server =====

* {{App|[[Music Player Daemon]]|Audio player that has a server-client architecture. In order to interface with it, a separate client is needed.|https://www.musicpd.org/|{{Pkg|mpd}}}}
* {{App|[[:en:Funkwhale]]|self-hosted, modern, free and open-source music server, heavily inspired by Grooveshark. Instances can be federated.|https://funkwhale.audio/|{{AUR|funkwhale}}}}

===== Console =====

* {{App|[[cmus]]|多くの機能を持っている ncurses ベースのミュージックプレイヤー。|https://cmus.github.io/|{{Pkg|cmus}}}}
* {{App|Cplay|様々なオーディオプレイヤーに対応した curses フロントエンド (ogg123, mpg123, mpg321, splay, madplay, mikmod, xmp, sox)。|https://directory.fsf.org/wiki/Cplay|{{AUR|cplay}}}}
* {{App|davis|A CLI client for {{Pkg|mpd}}, written in Rust.|https://github.com/SimonPersson/davis}}
* {{App|Herrie|最小主義のコンソールベースのミュージックプレイヤー、ネイティブで AudioScrobbler をサポート。|https://github.com/EdSchouten/herrie|{{AUR|herrie}}}}
* {{App|[[MOC]]|ncurses コンソールオーディオプレイヤー。MP3, OGG, WAV フォーマットをサポート。|https://moc.daper.net/|{{Pkg|moc}}}}
* {{App|MPFC|Gstreamer ベースの curses インターフェイスを備えたオーディオプレーヤー。|https://code.google.com/archive/p/mpfc/|{{AUR|mpfc}}}}
* {{App|[[Wikipedia:Mpg123|mpg123]]|Linux, FreeBSD, Solaris, HP-UX やその他多くの UNIX システムに対応している高速でフリーの MP3 コンソールオーディオプレイヤー (MP1 と MP2 もデコードします)。|https://www.mpg123.org/|{{Pkg|mpg123}}}}
* {{App|vitunes|Curses-based music player and playlist manager with vim-like keybindings.|http://vitunes.org/|{{AUR|vitunes}}}}
* {{App|whistle|curses ベースのコマンドライン音声プレイヤー。|https://github.com/ap0calypse/whistle/|{{AUR|whistle-git}}}}
* {{App|[[Wikipedia:XMMS2|XMMS2]]|人気のミュージックプレイヤーを完全に書き換えたもの。|https://xmms2.org|{{Pkg|xmms2}}}}

===== Graphical =====

====== GStreamer-based ======

* {{App|[[Wikipedia:Banshee (media player)|Banshee]]|[[Wikipedia:ja:iTunes|iTunes]] クローン、GTK と [[Mono]] で作られ、機能豊富です。Discontinued upstream.|https://gitlab.gnome.org/Archive/banshee|{{AUR|banshee}}}}
* {{App|Blanket|Improve focus and increase your productivity by listening to different sounds.|https://github.com/rafaelmardojai/blanket|{{Pkg|blanket}}}}
* {{App|Byte|Music player designed for elementary OS.|https://github.com/alainm23/byte|{{AUR|byte}}}}
* {{App|[[Wikipedia:Clementine_(software)|Clementine]]|Qt5 にポートされた Amarok 1.4 クローン。 See also Strawberry (below).|https://www.clementine-player.org/|{{Pkg|clementine}}}}
* {{App|Cozy|Modern audio book player for Linux using GTK 3.|https://cozy.geigi.de/|{{AUR|cozy-audiobooks}}}}
* {{App|[[Exaile]]|Amarok の GTK クローン。|https://www.exaile.org/|{{AUR|exaile}}}}
* {{App|GNOME Music|GNOME の新しい音楽再生アプリケーション。エレガントな没入型のブラウザと、シンプルでわかりやすいコントロールを備えています。|https://wiki.gnome.org/Apps/Music|{{Pkg|gnome-music}}}}
* {{App|Guayadeque|巨大なコレクションを簡単に管理できるフル機能のメディアプレイヤー。GStreamer メディアフレームワークを使っています。|https://www.guayadeque.org/|{{AUR|guayadeque}}}}
* {{App|Lollypop|GNOME の音楽プレイヤー。|https://wiki.gnome.org/Apps/Lollypop|{{Pkg|lollypop}}}}
* {{App|Melody|Music player for listening to local music files, online radios and audio CD's.|https://anufrij.org/melody/|{{AUR|playmymusic}}}}
* {{App|[[Wikipedia:Muine|Muine]]|C# で書かれた音楽プレイヤー。|https://gitlab.gnome.org/Archive/muine|{{AUR|muine}}}}
* {{App|Pantheon Music|Simple, fast, and good looking music player. The official elementary music player.|https://github.com/elementary/music|{{Pkg|pantheon-music}}}}
* {{App|Parlatype|Minimal audio player for manual speech transcription, for GNOME. It plays audio sources to transcribe them in your favorite text application.|https://www.parlatype.org/|{{AUR|parlatype}}}}
* {{App|Pragha|A lightweight two-panel GTK music manager written in C.|https://pragha-music-player.github.io/|{{Pkg|pragha}}}}
* {{App|[[Wikipedia:Quod Libet (software)|Quod Libet]]|GTK, Python と GStreamer で書かれた音声プレイヤー。プレイリストで正規表現をサポートしています。|https://github.com/quodlibet/quodlibet/|{{Pkg|quodlibet}}}}
* {{App|[[Rhythmbox]]|iTunes の GTK クローン。GNOME のデフォルトプレイヤー。|https://wiki.gnome.org/Apps/Rhythmbox|{{Pkg|rhythmbox}}}}
* {{App|Sayonara|C++ で書かれた Qt フレームワークの小規模で高速な Linux 用の音声プレイヤー。|https://sayonara-player.com/|{{AUR|sayonara-player}}}}
* {{App|Strawberry|Fork of Clementine aimed at audio enthusiasts and music collectors. Uses Qt6.|https://www.strawberrymusicplayer.org/|{{Pkg|strawberry}}}}
* {{App|Tauon Music Box|Modern, comfortable and streamlined music player for the playback of your music collection.|https://tauonmusicbox.rocks/|{{AUR|tauon-music-box}}}}

====== Phonon-based ======

* {{App|[[Amarok]]|機能が非常に多いことで有名な成熟した Qt ベースのプレイヤー。|https://amarok.kde.org/|{{AUR|amarok}}}}
* {{App|[[Wikipedia:JuK|JuK]]|オーディオジュークボックスアプリケーション。MP3, Ogg Vorbis, FLAC 音声ファイルをサポート。|https://juk.kde.org/|{{Pkg|juk}}}}
* {{App|Yarock|Modern looking music player, packed with features, that doesn’t depend on any specific desktop environment. Yarock is designed to provide an easy and pretty music browser based on cover art.|https://seb-apps.github.io/yarock/|{{AUR|yarock}}}}

====== Other ======

* {{App|[[Wikipedia:Aqualung (software)|Aqualung]]|Advanced music player, which plays audio CDs, internet radio streams and podcasts as well as soundfiles in just about any audio format and has the feature of inserting no gaps between adjacent tracks.|https://aqualung.jeremyevans.net/|{{AUR|aqualung}}}}
* {{App|[[Audacious]]|Beep や古い XMMS に似ている [[Wikipedia:ja:Winamp|Winamp]] クローン。|https://audacious-media-player.org/|{{Pkg|audacious}}}}
* {{App|[[Wikipedia:DeaDBeeF|DeaDBeeF]]|多くの機能を持っている軽くて速い音楽プレイヤー。GNOME や KDE には依存せず、GTK GUI だけでなくコンソールだけでも利用可能。たくさんのプラグインやメタデータエディタも付属。|https://deadbeef.sourceforge.io/|{{AUR|deadbeef}}}}
* {{App|Deepin Music|Awesome music player with brilliant and tweakful UI Deepin-UI based.|https://www.deepin.org/en/original/deepin-music/|{{Pkg|deepin-music}}}}
* {{App|Drumstick MIDI File Player|MIDI file player based on Drumstick.|https://sourceforge.net/projects/dmidiplayer/|{{AUR|dmidiplayer}}}}
* {{App|Elisa|Simple music player by the KDE community aiming to provide a nice experience for its users.|https://apps.kde.org/elisa/|{{Pkg|elisa}}}}
* {{App|gmusicbrowser|MP3/OGG/FLAC ファイルコレクション用のオープンソースのジュークボックス。|https://gmusicbrowser.org/|{{AUR|gmusicbrowser}}}}
* {{App|Goggles Music Manager|音楽の自動カテゴライズ、ギャップレス再生、簡単なタグ編集、インターネットラジオなどの機能があるミュージックコレクションマネージャ and player。[[Wikipedia:Fox toolkit|Fox toolkit]] を使っています。|https://gogglesmm.github.io/|{{Pkg|gogglesmm}}}}
* {{App|LXMusic|最小主義で xmms2 ベースの音楽プレイヤー。|https://wiki.lxde.org/en/LXMusic|{{Pkg|lxmusic}}}}
* {{App|museeks|Minimalistic and easy to use music player. Based on the [https://electronjs.org/ Electron] platform.|https://museeks.io/|{{AUR|museeks-bin}}}}
* {{App|Musique|ありふれた音楽プレイヤー。|https://flavio.tordini.org/musique|{{AUR|musique}}}}
* {{App|[[Wikipedia:qmmp|Qmmp]]|Winamp や XMMS に似たユーザーインターフェースを持っている Qt ベースのマルチメディアプレイヤー。|https://qmmp.ylsoftware.com/|{{Pkg|qmmp}}}}
* {{App|Soundux|Soundboard that features a simple user interface.|https://soundux.rocks/|{{AUR|soundux}}}}
* {{App|Vvave|Tiny Qt music player to keep your favorite songs at hand.|https://vvave.kde.org/|{{Pkg|vvave}}}}

==== Internet radio listeners ====

* {{App|GNOME Internet Radio Locator|Easily find live radio programs based on geographical location of radio broadcasters on the Internet.|https://wiki.gnome.org/Apps/InternetRadioLocator|{{AUR|gnome-internet-radio-locator}}}}
* {{App|Goodvibes|Lightweight internet radio player.|https://gitlab.com/goodvibes/goodvibes|{{AUR|goodvibes}}}}
* {{App|Radiotray-NG|Internet radio player systray applet.|https://github.com/ebruck/radiotray-ng|{{AUR|radiotray-ng}}}}
* {{App|Shortwave|GTK 3 application for finding and listening to internet radio stations.|https://gitlab.gnome.org/World/Shortwave|{{AUR|shortwave}}}}
* {{App|Tuner|Minimalist radio station player.|https://github.com/louis77/tuner|{{AUR|tuner}}}}

==== Music streaming clients ====

* {{App|Google Play Music Desktop Player|Beautiful cross platform desktop player for Google Play Music. Based on the [https://electronjs.org/ Electron] platform.|https://googleplaymusicdesktopplayer.com/{{Dead link|2021|05|17|status=SSL error}}|{{AUR|gpmdp}}}}
* {{App|Headset|Desktop app that turns YouTube into a world class music streaming service. Based on the [https://electronjs.org/ Electron] platform.|https://headsetapp.co/|{{AUR|headset}}}}
* {{App|MellowPlayer|A free, open source and cross-platform Qt-based desktop application that runs web-based music streaming services in its own window and provides integration with your desktop.|https://colinduquesnoy.gitlab.io/MellowPlayer/|{{AUR|mellowplayer}}}}
* {{App|Nuclear|Modern music player focused on streaming from free sources. Based on the [https://electronjs.org/ Electron] platform.|http://nuclear.gumblert.tech/|{{AUR|nuclear-player-bin}}}}
* {{App|[[pianobar]]|online radio Pandora のコンソールベースのフロントエンド。|https://6xq.net/projects/pianobar/|{{Pkg|pianobar}}}}
* {{App|Pithos|Python/GTK の Pandora Radio デスクトップクライアント。|https://pithos.github.io/|{{AUR|pithos}}}}
* {{App|[[Spotify]]|プロプライエタリの音楽ストリーミングサービス。ローカル再生と Spotify の巨大なライブラリからのストリーミング（フリーアカウントが必要）をサポート。|https://www.spotify.com/|{{AUR|spotify}}}}

==== オーディオタグエディタ ====

===== Console =====

* {{App|[[Beets]]|音楽ライブラリオーガナイザー、タグエディタ。|https://beets.io/|{{Pkg|beets}}}}
* {{App|Demlo|音楽のタグ付け、エンコード、バッチリネームなど。|https://ambrevar.bitbucket.io/demlo/|{{AUR|demlo}}}}
* {{App|id3|Command-line utility to edit ID3 1.x and 2.x tags.|https://squell.github.io/id3/|{{AUR|id3}}}}
* {{App|id3ted|Command line id3 tag editor.|https://muennich.github.io/id3ted/|{{AUR|id3ted}}{{Broken package link|package not found}}}}
* {{App|id3v2|Command line editor for id3v2 tags.|http://id3v2.sourceforge.net/|{{Pkg|id3v2}}}}
* {{App|MP3Info|MP3 technical info viewer and ID3 1.x tag editor.|https://ibiblio.org/mp3info/|{{Pkg|mp3info}}}}
* {{App|MP3Unicode|Command line utility to convert ID3 tags in mp3 files between different encodings.|http://mp3unicode.sourceforge.net/|{{Pkg|mp3unicode}}}}
* {{App|Taffy|シンプルなコマンドラインタグエディタ。多数の音声フォーマットに対応。|https://github.com/jangler/taffy|{{AUR|taffy}}}}
* {{App|Tagutil|CLI tool to edit music file's tag. It aims to provide both an easy-to-script interface and ease of use interactively.|https://github.com/kAworu/tagutil|{{AUR|tagutil}}}}

===== Graphical =====

* {{App|Audio Tag Tool|MP3 と Ogg Vorbis ファイルのタグを編集するためのツール。|https://github.com/impegoraro/tagtool|{{AUR|tagtool}}}}
* {{App|Coquillo|Metadata editor for various audio formats.|https://github.com/sjuvonen/coquillo|{{AUR|coquillo}}}}
* {{App|[[Wikipedia:EasyTag|EasyTag]]|music ファイルの ID3 タグを回覧・編集・書込するためのユーティリティ, supports many audio formats.|https://wiki.gnome.org/Apps/EasyTAG|{{Pkg|easytag}}}}
* {{App|[[Wikipedia:Ex Falso (software)|Ex Falso]]|クロスプラットフォーム対応のフリーでオープンソースオーディオタグエディタとライブラリ管理。Run with {{ic|exfalso}}.|https://github.com/quodlibet/quodlibet/|{{Pkg|quodlibet}}}}
* {{App|GabTag|Audio tagging tool written in GTK.|https://github.com/lachhebo/gabtag|{{AUR|gabtag}}}}
* {{App|Kid3|MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF ファイルタグエディタ。|https://kid3.kde.org/|KDE: {{Pkg|kid3}}, Qt: {{Pkg|kid3-qt}}}}
* {{App|KTag Editor|ID3v tag editor developed in Qt5 framework. Supported files are mp3, wav, ogg, wma, flac, asf.|https://karoljkocmaros.blogspot.com/p/ktag-editor.html|{{AUR|ktageditor}}}}
* {{App|MP3Info GUI|MP3 の内部情報ビューアと ID3 1.x タグエディタ。The graphical interface can be launched with the {{ic|gmp3info}} command.|https://ibiblio.org/mp3info/|{{Pkg|mp3info}}}}
* {{App|[[Wikipedia:MusicBrainz Picard|Picard]]|Python によって書かれたクロスプラットフォームのオーディオタグエディタ ([[Wikipedia:MusicBrainz|MusicBrainz]] 公式タグエディタ)。|https://picard.musicbrainz.org/|{{Pkg|picard}}}}
* {{App|NTag|Graphical tag editor focused on everyday life use cases.|https://github.com/nrittsti/ntag|{{AUR|ntag}}}}
* {{App|[[Wikipedia:Puddletag|Puddletag]]|Windows 用の MP3tag のリプレースメント。|https://docs.puddletag.net/|{{AUR|puddletag}}}}
* {{App|Qoobar|ユニバーサルな Qt ベースの音声タグ付けプログラム (クラシック音楽に特化)。|http://qoobar.sourceforge.net/en/index.htm|{{AUR|qoobar}}}}
* {{App|Tag Editor|Qt GUI によるタグエディタ。コマンドラインインターフェイスも装備。MP4/M4A/AAC (iTunes), ID3v1, ID3v2, Vorbis, Opus, FLAC and Matroska に対応。|https://github.com/Martchus/tageditor|{{AUR|tageditor}}}}
* {{App|Thunar Media Tags Plugin|Adds special features for media files to the Thunar File Manager, including the ability to edit tags.|https://goodies.xfce.org/projects/thunar-plugins/thunar-media-tags-plugin|{{Pkg|thunar-media-tags-plugin}}}}

==== Lyrics ====

===== Lyrics players =====

* {{App|Floodlight Presenter|Presentation and lyrics program for churches to display lyrics and media.|https://floodlight.gitlab.io/|{{AUR|floodlight-presenter}}}}
* {{App|Give Me Lyrics|See the lyrics of the song that is playing, from any application.|https://github.com/muriloventuroso/givemelyrics|{{AUR|givemelyrics}}}}
* {{App|Lyrics|Display lyrics on media players with [[MPRIS]] interface.|https://github.com/naaando/lyrics|{{AUR|lyrics}}}}
* {{App|OSD Lyrics|Lyric show compatible with various media players.|https://github.com/osdlyrics/osdlyrics|{{Pkg|osdlyrics}}}}

===== Lyrics downloaders =====

* {{App|clyrics|拡張性がある歌詞取得プログラム。cmus や mocp のデーモンをサポート。|https://github.com/trizen/clyrics|{{AUR|clyrics}}}}
* {{App|glyrc|Command-line music related metadata searchengine, including support for downloading lyrics.|https://github.com/sahib/glyr|{{Pkg|glyr}}}}

===== Lyrics editors =====

* {{App|Karaoke Lyrics Editor|Lyrics editor and CD+G/video exporter for Karaoke.|https://www.ulduzsoft.com/linux/karaoke-lyrics-editor/|{{AUR|karlyriceditor}}}}
* {{App|LyricsX|Lyrics editor.|https://github.com/timxx/lyricsx|{{AUR|lyricsx}}}}

==== Audio converters ====

* {{App|Caudec|A multiprocess command line audio converter that supports many formats (FLAC, MP3, Ogg Vorbis, Windows codecs and many more)|https://caudec.cocatre.net/|{{AUR|caudec}}}}
* {{App|[[Wikipedia:Ecasound|Ecasound]]|Command line tools designed for multitrack audio processing. It can be used for simple tasks like audio playback, recording and format conversions, as well as for multitrack effect processing, mixing, recording and signal recycling.|https://nosignal.fi/ecasound/|{{Pkg|ecasound}}}}
* {{App|FFaudioConverter|Batch audio converter and effects processor. It can convert files or whole folders containing music and video files to other audio formats with FFmpeg.|https://github.com/Bleuzen/FFaudioConverter|{{AUR|ffaudioconverter}}}}
* {{App|Flacon|Extracts individual tracks from one big audio file containing the entire album of music and saves them as separate audio files.|https://flacon.github.io/|{{AUR|flacon}}}}
* {{App|[[Wikipedia:Fre:ac|fre:ac]]|Audio converter and CD ripper with support for various popular formats and encoders.|https://freac.org/|{{AUR|freac}}}}
* {{App|Gnac|GNOME の音声コンバーター。|http://gnac.sourceforge.net/|{{Pkg|gnac}}}}
* {{App|SoundConverter|A graphical application to convert audio files into different formats.|https://soundconverter.org/|{{pkg|soundconverter}}}}
* {{App|soundKonverter|Qt-based GUI front-end to various audio converters.|https://github.com/dfaust/soundkonverter|{{pkg|soundkonverter}}}}
* {{App|[[Wikipedia:SoX|SoX]]|Command line utility that can convert various formats of computer audio files into other formats.|http://sox.sourceforge.net/|{{Pkg|sox}}}}

==== サウンド編集 ====

See also [[Wikipedia:Comparison of digital audio editors]].

* {{App|[[Wikipedia:Audacity (audio editor)|Audacity]]|デジタル音声の波形編集プログラム。|https://www.audacityteam.org/|{{Pkg|audacity}}}}
* {{App|GNOME Sound Recorder|録音と再生ができるサウンドレコーダアプリケーション。.flac, .ogg (OGG オーディオ, もしくは .oga), .wav 音声ファイル。|https://wiki.gnome.org/Apps/SoundRecorder|{{Pkg|gnome-sound-recorder}}}}
* {{App|[[Wikipedia:Gnome Wave Cleaner|Gnome Wave Cleaner]]|Digital audio editor to denoise, dehiss and amplify audio files.|http://gwc.sourceforge.net/|{{AUR|gwc}}}}
* {{App|Kwave|KDE 用のサウンドエディタ。|http://kwave.sourceforge.net/|{{Pkg|kwave}}}}
* {{App|mhWaveEdit|Graphical program for editing, playing and recording sound files.|https://github.com/magnush/mhwaveedit/|{{AUR|mhwaveedit}}}}
* {{App|[[Wikipedia:Mp3splt|Mp3splt]]|Utility to split mp3, ogg vorbis and native FLAC files selecting a begin and an end time position, without decoding.|http://mp3splt.sourceforge.net/|CLI: {{Pkg|mp3splt}}, GUI: {{Pkg|mp3splt-gtk}}}}
* {{App|ocenaudio|Proprietary cross-platform, easy to use, fast and functional audio editor.|https://www.ocenaudio.com/en/|{{AUR|ocenaudio-bin}}}}
* {{App|Play it Slowly|Play back audio files at a different speed or pitch.|https://29a.ch/playitslowly|{{Pkg|playitslowly}}}}
* {{App|Polyphone|A soundfont editor to create and edit a musical instrument based on samples, using the sf2 format.|https://www.polyphone-soundfonts.com/|{{Pkg|polyphone}}}}
* {{App|Snd|Advanced sound editor modeled loosely after Emacs.|https://ccrma.stanford.edu/software/snd/|{{Pkg|snd}}}}
* {{App|[[Wikipedia:Sweep (software)|Sweep]]|Audio editor and live playback tool.|http://www.metadecks.org/software/sweep/|{{Pkg|sweep}}}}
* {{App|[[Wikipedia:WaveSurfer|WaveSurfer]]|Tool for sound visualization and manipulation. Typical applications are speech/sound analysis and sound annotation/transcription.|https://www.speech.kth.se/wavesurfer/|{{AUR|wavesurfer}}}}

==== Digital audio workstations ====

See also [[プロオーディオ]].

* {{App|[[Wikipedia:Ardour (software)|Ardour]]|マルチチャンネルハードディスクレコーダーとデジタルオーディオワークステーション。|https://ardour.org/|{{Pkg|ardour}}}}
* {{App|[[Wikipedia:Bitwig Studio|Bitwig Studio]]|プロプライエタリなプロフェッショナル用デジタルオーディオワークステーション。||https://www.bitwig.com/en/home.html|{{AUR|bitwig-studio}}}}
* {{App|Frinika|Digital audio workstation, features sequencer, soft-synths, realtime effects and audio recording.|https://www.frinika.com/|{{AUR|frinika}}}}
* {{App|[[LMMS]]|Digital audio workstation which コンピューターによる作曲を支援します。|https://lmms.io/|{{Pkg|lmms}}}}
* {{App|[[Wikipedia:MusE|MusE]]|MIDI/Audio sequencer (digital audio workstation) with recording and editing capabilities, aims to be a complete multitrack virtual studio for Linux.|https://muse-sequencer.github.io//|{{Pkg|muse}}}}
* {{App|Non|Modular digital audio workstation composed of four main parts: Timeline, Sequencer, Mixer and Session Manager.|https://non.tuxfamily.org/|{{Pkg|non-timeline}}, {{Pkg|non-sequencer}}, {{Pkg|non-mixer}}, {{Pkg|new-session-manager}}}}
* {{App|[[Wikipedia:Qtractor|Qtractor]]|Qt ベースのハードディスクレコーダーと、平均的なホームユーザーだけでなくプロフェッショナルユーザーの要求にも応えるパワフルなデジタルオーディオワークステーション。|https://qtractor.sourceforge.io/qtractor-index.html|{{Pkg|qtractor}}}}
* {{App|[[Wikipedia:REAPER|REAPER]]|Proprietary digital audio workstation, offering a full multitrack audio and MIDI recording, editing, processing, mixing and mastering toolset.|https://www.reaper.fm/|{{AUR|reaper-bin}}}}
* {{App|[[Wikipedia:Rosegarden|Rosegarden]]|ALSA と Qt を使って開発されたデジタルオーディオワークステーション、MIDI シーケンサー、楽譜エディタ、作曲・編曲ツールとして使用可能。|https://www.rosegardenmusic.com/|{{Pkg|rosegarden}}}}
* {{App|[[Wikipedia:Tracktion Waveform|Tracktion Waveform]]|Proprietary digital audio workstation, specifically designed for the needs of modern music producers.|https://www.tracktion.com/|{{AUR|tracktion-waveform}}}}

==== Audio analyzers ====

* {{App|audioprism|Spectrogram tool for PulseAudio input and WAV files.|https://github.com/vsergeev/audioprism|{{AUR|audioprism}}}}
* {{App|[[Wikipedia:BRP-PACU|BRP-PACU]]|Dual channel FFT based acoustic analysis tool to help engineers analyze live professional sound systems using the transfer function.|https://sourceforge.net/projects/brp-pacu/|{{AUR|brp-pacu}}}}
* {{App|Baudline|Proprietary time-frequency and spectrogram analyzer|http://www.baudline.com/index.html|{{AUR|baudline-bin}}}}
* {{App|FMIT|Graphical utility for tuning your musical instruments, with error and volume history and advanced features.|https://gillesdegottex.github.io/fmit/|{{AUR|fmit}}}}
* {{App|Friture|Real-time audio analyzer.|https://friture.org/|{{AUR|friture}}}}
* {{App|Mousai|Simple application for identifying songs using the API of audd.io.|https://github.com/SeaDve/Mousai|{{AUR|mousai}}}}
* {{App|rtspeccy|Real time audio spectrum analyzer.|https://www.uninformativ.de/git/rtspeccy/|{{AUR|rtspeccy-git}}}}
* {{App|sndpeek|Real-time audio visualization tool.|https://soundlab.cs.princeton.edu/software/sndpeek/|ALSA: {{AUR|sndpeek-alsa}}, JACK: {{AUR|sndpeek-jack}}}}
* {{App|SongRec|Unofficial Shazam client to recognize audio from an arbitrary audio file or from the microphone, written in Rust.|https://github.com/marin-m/SongRec|{{Pkg|songrec}}}}
* {{App|[[Wikipedia:Sonic Visualiser|Sonic Visualiser]]|Viewing and analyzing the contents of music audio files.|https://www.sonicvisualiser.org/|{{Pkg|sonic-visualiser}}}}
* {{App|Spek|Helps to analyse your audio files by showing their spectrogram.|http://spek.cc/|{{AUR|spek}}}}

==== Scorewriters ====

See also [[LilyPond#Front-ends]] and [[Wikipedia:Comparison of scorewriters]].

* {{App|Aria Maestosa|MIDI sequencer/editor. It lets you compose, edit and play MIDI files with a few clicks in a user-friendly interface offering score, keyboard, guitar, drum and controller views.|https://ariamaestosa.github.io/ariamaestosa/docs/index.html|{{AUR|ariamaestosa}}}}
* {{App|[[Wikipedia:Canorus|Canorus]]|Music score editor. It supports an unlimited number and length of staffs, polyphony, a MIDI playback of notes, chord markings, lyrics, import/export filters to formats like MIDI, MusicXML, ABC Music, MusiXTeX and LilyPond.|https://sourceforge.net/projects/canorus/|{{AUR|canorus}}}}
* {{App|[[Wikipedia:Impro-Visor|Impro-Visor]]|Music notation program designed to help jazz musicians compose and hear solos similar to ones that might be improvised.|https://www.cs.hmc.edu/~keller/jazz/improvisor/|{{AUR|impro-visor}}}}
* {{App|[[LilyPond]]|Music engraving program, devoted to producing the highest-quality sheet music possible.|https://lilypond.org/|{{Pkg|lilypond}}}}
* {{App|[[Wikipedia:MuseScore|MuseScore]]|Create, playback, and print sheet music.|https://musescore.org/|{{Pkg|musescore}}}}
* {{App|[[Wikipedia:TuxGuitar|TuxGuitar]]|Multitrack guitar tablature editor and player.|http://tuxguitar.com.ar/|{{AUR|tuxguitar}}}}

==== Audio synthesis environments ====

See also [[Wikipedia:Comparison of audio synthesis environments]].

* {{App|Blue|Music composition environment for Csound, written in Java.|https://blue.kunstmusik.com/|{{AUR|csound-blue}}}}
* {{App|Cabbage|Framework for audio software development using simple markup text and the Csound audio synthesis language.|https://cabbageaudio.com/|{{AUR|cabbage}}{{Broken package link|package not found}}}}
* {{App|[[Wikipedia:ChucK|ChucK]]|Strongly-timed, concurrent, and on-the-fly music programming language.|https://chuck.cs.princeton.edu/|{{Pkg|chuck}}}}
* {{App|[[Wikipedia:Csound|Csound]]|Sound and music computing system.|https://csound.com/|{{Pkg|csound}}}}
* {{App|CsoundQt|Frontend for Csound featuring a highlighting editor with autocomplete, interactive widgets and integrated help.|https://csoundqt.github.io/|{{Pkg|csoundqt}}}}
* {{App|FoxDot|Live Coding with Python and SuperCollider.|https://foxdot.org/|{{Pkg|foxdot}}}}
* {{App|[[Wikipedia:Pure Data|Pure Data]]|Real-time music and multimedia environment.|http://msp.ucsd.edu/software.html|{{Pkg|pd}}}}
* {{App|[[Wikipedia:Sonic Pi|Sonic Pi]]|Code-based music creation and performance tool.|https://sonic-pi.net/|{{Pkg|sonic-pi}}}}
* {{App|[[Wikipedia:SuperCollider|SuperCollider]]|Platform for audio synthesis and algorithmic composition, used by musicians, artists, and researchers working with sound.|https://supercollider.github.io/|{{Pkg|supercollider}}}}
* {{App|[[:en:VCV Rack]]| Virtual Eurorack DAW. Use a plugin systems to add more [[WIkipedia:Eurorack|Eurorack]] emulated modules.|https://vcvrack.com/|{{AUR|vcvrack}}}}

==== Sound generators ====

This section contains [[Wikipedia:Drum machine|drum machines]], [[Wikipedia:Software sampler|software samplers]] and [[Wikipedia:Software synthesizer|software synthesizers]].

* {{App|ADLMIDI|OPL3/OPN2 synthesizer using ADLMIDI.|https://github.com/jpcima/adljack|{{Pkg|adljack}}}}
* {{App|ADLplug|FM Yamaha OPL3 synthesizer for ADLMIDI.|https://github.com/jpcima/ADLplug|{{Pkg|adlplug}}}}
* {{App|Agordejo|Music and audio production session manager based on NSM.|https://www.laborejo.org/agordejo/|{{Pkg|agordejo}}}}
* {{App|ams|Alsa Modular Synth. Realtime modular synthesizer and effect processor.|http://alsamodular.sourceforge.net/|{{Pkg|ams}}}}
* {{App|[[Wikipedia:Amsynth|amsynth]]|Analog Modelling SYNTHesizer. Easy-to-use software synthesizer with a classic subtractive synthesizer topology.|https://amsynth.github.io/|{{Pkg|amsynth}}}}
* {{App|[[Wikipedia:Din (din is noise)|DIN]]|Sound synthesizer and musical instrument.|https://dinisnoise.org/|{{Pkg|din}}}}
* {{App|Drumstick|Set of MIDI tools: drum grid, MIDI player, virtual piano.|https://drumstick.sourceforge.io/|{{Pkg|drumstick}}}}
* {{App|Element|A modular LV2/VST3 audio plugin host.|https://kushview.net/element/|{{Pkg|element}}}}
* {{App|Fluajho|SF2 soundfont sample player for JACK based on Fluidsynth.|https://www.laborejo.org/fluajho/|{{Pkg|fluajho}}}}
* {{App|[[FluidSynth]]|Real-time software synthesizer based on the SoundFont 2 specifications.|https://www.fluidsynth.org/|{{Pkg|fluidsynth}}}}
* {{App|Geonkick|Synthesizer that can synthesize elements of percussion. The most basic examples are: kicks, snares, hit-hats, shakers, claps.|https://gitlab.com/iurie-sw/geonkick|{{Pkg|geonkick}}}}
* {{App|Gigedit|Graphical instrument editor for sample based virtual instruments, based on the GigaStudio/Gigasampler file format.|http://doc.linuxsampler.org/Gigedit/|{{Pkg|gigedit}}}}
* {{App|GrandOrgue|Virtual pipe organ sample player application supporting a HW1 compatible file format.|https://sourceforge.net/projects/ourorgan/|{{AUR|grandorgue-svn}}{{Broken package link|package not found}}}}
* {{App|GSequencer|Provides various tools to play, create, edit and mix your own music. It features a step sequencer, piano roll, automation and wave-form editor.|https://nongnu.org/gsequencer/|{{AUR|gsequencer}}}}
* {{App|Helm|Software synthesizer to create electronic music on your computer.|https://tytel.org/helm/|{{Pkg|helm-synth}}}}
* {{App|[[Wikipedia:Hydrogen (software)|Hydrogen]]|Advanced drum machine to create drum sequences.|https://github.com/hydrogen-music/hydrogen|{{Pkg|hydrogen}}}}
* {{App|JSampler|Java GUI for [[LinuxSampler]] software audio sampler.|http://jsampler.sourceforge.net/|{{Pkg|jsampler}}}}
* {{App|OPNplug|FM Yamaha OPN2 synthesizer for OPNMIDI.|https://github.com/jpcima/ADLplug|{{Pkg|opnplug}}}}
* {{App|Patroneo|Easy to use pattern based midi sequencer.|https://www.laborejo.org/patroneo/|{{Pkg|patroneo}}}}
* {{App|[[Wikipedia:PySynth|PySynth]]|Suite of simple music synthesizers and helper scripts written in Python 3.|https://mdoege.github.io/PySynth/|{{AUR|python-pysynth-git}}}}
* {{App|QMidiArp|Advanced MIDI arpeggiator, programmable step sequencer and LFO.|http://qmidiarp.sourceforge.net/|{{Pkg|qmidiarp}}}}
* {{App|QmidiCtl|MIDI remote controller application that sends MIDI data over the network, using UDP/IP multicast.|https://qmidictl.sourceforge.io/|{{Pkg|qmidictl}}}}
* {{App|QmidiNet|MIDI network gateway application that sends and receives MIDI data over the network, using UDP/IP multicast.|https://qmidinet.sourceforge.io/|{{Pkg|qmidinet}}}}
* {{App|QMidiRoute|MIDI router and processor for ALSA.|http://alsamodular.sourceforge.net/|{{Pkg|qmidiroute}}}}
* {{App|Qsampler|Qt GUI for [[LinuxSampler]] software audio sampler.|https://qsampler.sourceforge.io/|{{Pkg|qsampler}}}}
* {{App|Qsynth|Qt GUI for Fluidsynth.|https://qsynth.sourceforge.io/|{{Pkg|qsynth}}}}
* {{App|Qwertone|Simple music synthesizer app (like a toy-piano), but based on usual qwerty-keyboard for input.|https://gitlab.com/azymohliad/qwertone|{{AUR|qwertone-git}}}}
* {{App|QXGEdit|Qt GUI for editing MIDI System Exclusive files for XG devices (eg. Yamaha DB50XG).|https://qxgedit.sourceforge.io/|{{Pkg|qxgedit}}}}
* {{App|setBfree|DSP tonewheel organ.|https://setbfree.org/|{{Pkg|setbfree}}}}
* {{App|SpectMorph|Analyze samples of musical instruments and combine them (morphing).|http://spectmorph.org/|{{Pkg|spectmorph}}}}
* {{App|[[Timidity|TiMidity++]]|Software synthesizer, which can play MIDI files by converting them into PCM waveform data.|http://timidity.sourceforge.net/|{{Pkg|timidity++}}}}
* {{App|Vee One Suite|Old-school software instruments: synthv1, a polyphonic subtractive synthesizer; samplv1, a polyphonic sampler synthesizer; drumkv1, yet another drum-kit sampler; padthv1, a polyphonic additive synthesizer.|https://www.rncbc.org/|{{Pkg|synthv1}}, {{Pkg|samplv1}}, {{Pkg|drumkv1}}, {{Pkg|padthv1}}}}
* {{App|Vico|Minimalistic Midi sequencer that is intended to be used in parallel with other software.|https://www.laborejo.org/vico/|{{Pkg|vico}}}}
* {{App|VMPK|Virtual MIDI Piano Keyboard. MIDI events generator and receiver. It can use midi SoundFonts to generate sound by itself, or can be used to drive a MIDI synthesizer.|https://vmpk.sourceforge.io/|{{Pkg|vmpk}}}}
* {{App|[[Wikipedia:Yoshimi (synthesizer)|Yoshimi]]|Software synthesizer, a fork of ZynAddSubFX.|http://yoshimi.sourceforge.net/|{{Pkg|yoshimi}}}}
* {{App|[[Wikipedia:ZynAddSubFX|ZynAddSubFX]]|Fully featured software synthesizer capable of making a countless number of instruments, from some common heard from expensive hardware to interesting sounds that you will boost to an amazing universe of sounds.|https://zynaddsubfx.sourceforge.io/|{{Pkg|zynaddsubfx}}}}

==== Music trackers ====

* {{App|[[Wikipedia:Buzztrax|Buzztrax]]|Music studio to compose songs using only a computer with a soundcard.|https://news.buzztrax.org/{{Dead link|2021|05|17|status=domain name not resolved}}|{{AUR|buzztrax}}}}
* {{App|FamiStudio|Very simple music editor for the Nintendo Entertainment System or Famicom.|https://famistudio.org/|{{AUR|famistudio}}}}
* {{App|klystrack|Tracker for making C64/NES/Amiga-style chiptunes on a modern platform.|https://kometbomb.github.io/klystrack/|{{AUR|klystrack-git}}}}
* {{App|[[Wikipedia:MilkyTracker|MilkyTracker]]|Music application for creating .MOD and .XM module files.|https://milkytracker.titandemo.org/|{{Pkg|milkytracker}}}}
* {{App|[[Wikipedia:OpenMPT|OpenMPT]]|Tracker software to create and play back some great music on your computer.|https://openmpt.org/|{{AUR|openmpt}}}}
* {{App|Radium|Music editor with a new type of interface.|https://users.notam02.no/~kjetism/radium/|{{AUR|radium}}}}
* {{App|Schism Tracker|Create high quality music without the requirements of specialized, expensive equipment, and with a unique "finger feel" that is difficult to replicate in part.|http://schismtracker.org/|{{AUR|schismtracker}}}}

==== DJ ====

* {{App|Giada|Minimal, hardcore audio tool for DJs, live performers and electronic musicians.|https://giadamusic.com/|{{Pkg|giada}}}}
* {{App|IDJC|Powerful yet easy to use source-client for individuals interested in streaming live radio shows over the Internet using Shoutcast or Icecast servers.|http://idjc.sourceforge.net/|{{AUR|idjc}}}}
* {{App|Linux Show Player|Powerful and feature-rich software to arrange cue lists. Designed for theatre plays and live music shows.|https://www.linux-show-player.org/|{{AUR|linux-show-player}}}}
* {{App|Luppp|Music creation tool, intended for live use. The focus is on real time processing and a fast and intuitive workflow.|http://openavproductions.com/luppp/|{{Pkg|luppp}}}}
* {{App|[[Wikipedia:Mixxx|Mixxx]]|Integrates the tools DJs need to perform creative live mixes with digital music files.|https://mixxx.org/|{{Pkg|mixxx}}}}
* {{App|[[Seq24]]|Minimal loop based MIDI sequencer for a live performance with a very simple interface for editing and playing MIDI 'loops'.|http://filter24.org/seq24/|{{AUR|seq24-bzr}}}}
* {{App|[[Wikipedia:xwax|xwax]]|Digital Vinyl System (DVS) for Linux. It allows DJs and turntablists to playback digital audio files (MP3, Ogg Vorbis, FLAC, AAC and more), controlled using a normal pair of turntables via timecoded vinyls.|https://xwax.org/|{{Pkg|xwax}}}}

==== Audio effects ====

* {{App|Calf Plugin Pack for JACK|Process and produce sounds using a set of plugins with JACK interface. ({{ic|calfjackhost}})|https://calf-studio-gear.org/|{{Pkg|calf}}}}
* {{App|Carla|Audio plugin host, with support for many audio drivers and plugin formats.|https://kxstudio.linuxaudio.org/Applications:Carla|{{Pkg|carla}}}}
* {{App|guitarix|Virtual guitar amplifier for JACK.|https://guitarix.org/|{{Pkg|guitarix}}}}
* {{App|PulseEffects|Apply effects to PulseAudio applications and input sources over PipeWire (over PulseAudio with legacy package).|https://github.com/wwmm/pulseeffects|{{AUR|pulseeffects}}{{Broken package link|replaced by {{Pkg|easyeffects}}}}, {{AUR|pulseeffects-legacy-git}}}}
* {{App|Rakarrack|Richly featured multi-effects processor emulating a guitar effects pedalboard.|http://rakarrack.sourceforge.net/|{{AUR|rakarrack}}}}

==== Audio visualizers ====

* {{App|Barva|Visualizer for PulseAudio that pulses the background of your terminal.|https://github.com/Kharacternyk/barva/|{{AUR|barva-git}}}}
* {{App|C.A.V.A.|ALSA, MPD, PulseAudio に対応しているコンソールベースのオーディオビジュアライザー。|https://github.com/karlstav/cava/|{{AUR|cava}}}}
* {{App|Cavalcade|GTK GUI for C.A.V.A.|https://github.com/worron/cavalcade/|{{AUR|cavalcade}}}}
* {{App|cli-visualizer|カスタマイズ性が高い CLI ベースのオーディオビジュアライザー。|https://github.com/dpayne/cli-visualizer|{{AUR|cli-visualizer}}}}
* {{App|GLava|OpenGL audio spectrum visualizer. Its primary use case is for desktop windows or backgrounds.|https://github.com/wacossusca34/glava|{{Pkg|glava}}}}
* {{App|GLMViz|Fully configurable OpenGL music visualizer.|https://github.com/hannesha/GLMViz|{{AUR|glmviz-git}}}}
* {{App|Le Biniou|User-friendly, powerful music visualization / VJing tool.|https://biniou.net/|{{AUR|lebiniou}}}}
* {{App|[[projectM]]|3D アクセラレーションを使う反復画像ベースレンダリングを使うミュージックビジュアライザー。|https://github.com/projectM-visualizer/projectm|{{Pkg|projectm-pulseaudio}}}}
* {{App|[[Wikipedia:VSXu|VSXu]]|OpenGL-based (hardware-accelerated), modular programming environment with its main purpose to リアルタイムのオーディオビジュアルプリセットを作成・表示.|https://www.vsxu.com/|{{AUR|vsxu}}}}

==== Remote audio ====

* {{App|jammr|Play jam sessions with musicians around the world over the internet.|https://jammr.net/|{{AUR|jammr}}}}
* {{App|Jamulus|Enables musicians to perform real-time jam sessions over the internet.|https://jamulus.io/|{{AUR|jamulus}}}}
* {{App|Noson|Fast and smart controller for SONOS devices.|https://janbar.github.io/noson-app/|{{AUR|noson-app}}}}
* {{App|SonoBus|Application for streaming high-quality, low-latency peer-to-peer audio between devices over the internet or a local network.|https://sonobus.net/|{{AUR|sonobus}}}}
* {{App|Upplay|Qt-based UPnP audio control point.|https://lesbonscomptes.com/upplay/|{{AUR|upplay}}}}

==== 音量調整 ====

See also [[PulseAudio#Front-ends]] and [[JACK Audio Connection Kit#GUI]].

* {{App|[[Wikipedia:alsamixer|alsamixer]]|Soundcard mixer for ALSA soundcard driver, with ncurses interface.|https://alsa-project.org/|{{Pkg|alsa-utils}}}}
* {{App|ALSA Tray|Provides a systray icon and a command line interface for setting the volume of the ALSA Mixers.|https://projects.flogisoft.com/alsa-tray/|{{AUR|alsa-tray}}}}
* {{App|AlsaVolume|Tray ALSA volume changer written using gtkmm.|https://github.com/Vitozz/cppAlsaVolume|{{AUR|cpp-alsa-volume}}}}
* {{App|AMixST|Volume wheel using ALSA and Qt5.|https://github.com/FenixFyreX/amixst|{{AUR|amixst}}}}
* {{App|Emixer|Utility to control volume levels. Part of Enlightenment.|https://www.enlightenment.org/about-enlightenment|{{Pkg|enlightenment}}}}
* {{App|GNOME ALSA Mixer|ALSA mixer for GNOME.|https://launchpad.net/gnome-alsamixer|{{AUR|gnome-alsamixer}}}}
* {{App|GVolWheel|トレイアイコンからボリュームを操作できるオーディオミキサー。|https://github.com/Junker/gvolwheel|{{AUR|gvolwheel}}}}
* {{App|KMix|KDE volume control program.|https://apps.kde.org/kmix/|{{Pkg|kmix}}}}
* {{App|MATE Volume Control|Audio mixer application and system tray applet for MATE to mix audio and adjust volume levels of various audio mixer devices.|https://github.com/mate-desktop/mate-media|{{Pkg|mate-media}}}}
* {{App|PNMixer|Obmixer のフォーク。ALSA のチャンネル選択、接続・切断の検出、ショートカットなどの機能が追加されています。|https://github.com/nicklan/pnmixer/wiki|{{AUR|pnmixer}}}}
* {{App|QasTools|Collection of desktop applications for the Linux sound system ALSA. It provides QasMixer (mixer), QasHctl (HCTL mixer) and QasConfig (configuration browser).|https://gitlab.com/sebholt/qastools|{{Pkg|qastools}}}}
* {{App|Retrovol|Retro-looking volume setting tray applet.|https://github.com/pizzasgood/retrovol|{{AUR|retrovol}}}}
* {{App|Volctl|Per-application system tray applet volume control for PulseAudio.|https://buzz.github.io/volctl/|{{AUR|volctl}}}}
* {{App|[[Volnoti]]|GNU/Linux などの POSIX オペレーティングシステム向けの軽量なボリューム通知デーモン。|https://github.com/davidbrazdil/volnoti|{{AUR|volnoti}}}}
* {{App|Volti|内蔵ミキサーとマルチメディアキーのサポートがある、システムトレイからオーディオボリュームを操作するための GTK アプリケーション。ALSA だけを使用します。|https://github.com/gen2brain/volti|{{AUR|volti}}}}
* {{App|Volume Icon|チャンネル選択、テーマや外部ミキサーなどが使えるシステムトレイのボリュームコントロール。|http://nullwise.com/volumeicon.html|{{Pkg|volumeicon}}}}
* {{App|VolWheel|トレイアイコンをスクロールしてサウンドボリュームを操作できる小さなアプリケーション。|https://oliwer.net/b/volwheel.html|{{AUR|volwheel}}}}
* {{App|Xfce ALSA Panel Plugin|Simple ALSA volume control plugin for [[Xfce]]4 panel.|https://github.com/equeim/xfce4-alsa-plugin|{{AUR|xfce4-alsa-plugin}}}}

==== CD リッピング ====

[[光学ディスクドライブ#CD]] を見て下さい。

=== 動画 ===

==== ビデオプレーヤー ====

See also [[Wikipedia:Comparison of video player software]].

===== コンソール =====

* {{App|[[FFmpeg|FFplay]]|FFmpeg ライブラリと SDL ライブラリを使用するシンプルでポータブルなメディアプレイヤー。 It is mostly used as a testbed for the various FFmpeg APIs.|https://ffmpeg.org/|{{Pkg|ffmpeg}}}}
* {{App|[[GStreamer|gst-play-1.0]]|GStreamer のシンプルなコマンドライン再生テストツール。|https://gstreamer.freedesktop.org/|{{Pkg|gst-plugins-base-libs}}}}
* {{App|[[MPlayer]]|多様なビデオ・オーディオフォーマットをサポートしているビデオプレイヤー。|https://mplayerhq.hu/design7/news.html|{{Pkg|mplayer}}}}
* {{App|[[mpv]]|MPlayer と mplayer2 ベースの動画プレイヤー|https://mpv.io/|{{Pkg|mpv}}}}
* {{App|[[VLC media player]]|TTY で HD 動画をスムーズに再生できる、有名なビデオプレイヤーのコマンドライン版。The rc interface can be launched with {{ic|vlc -I rc}}, and the ncurses interface {{ic|vlc -I ncurses}} で起動します。|https://www.videolan.org/vlc/|{{Pkg|vlc}}}}

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

====== GStreamer-based ======

* {{App|Cinema|Video player and manager for watching local video files.|https://anufrij.org/cinema/|{{AUR|playmyvideos}}}}
* {{App|Clapper|GNOME media player built using GJS with GTK4 toolkit and powered by GStreamer with OpenGL rendering.|https://rafostar.github.io/clapper/|{{AUR|clapper}}}}
* {{App|Glide|Simple and minimalistic media player relying on GStreamer for the multimedia support and GTK+ for the user interface.|https://github.com/philn/glide|{{Pkg|glide}}}}
* {{App|[[Wikipedia:GNOME Videos|GNOME Videos]]|GStreamer を使用する GNOME デスクトップのメディアプレイヤー (音声と動画の両方に対応)。{{Grp|gnome}} に含まれています。|https://wiki.gnome.org/Apps/Videos|{{Pkg|totem}}}}
* {{App|Identity|Program for comparing multiple versions of an image or video.|https://gitlab.gnome.org/YaLTeR/identity|{{AUR|identity}}}}
* {{App|Movie Monad|Free and simple to use video player made with Haskell using [[GStreamer]] and GTK. Precompiled and no Haskell dependency in run-time. |https://lettier.github.io/movie-monad/|{{AUR|movie-monad}}}}
* {{App|Pantheon Videos|Video player and library app designed for elementary OS using [[GStreamer]].|https://github.com/elementary/videos|{{Pkg|pantheon-videos}}}}
* {{App|Parole|[[GStreamer]] フレームワークによるモダンなメディアプレイヤー。|https://docs.xfce.org/apps/parole/start|{{Pkg|parole}}}}
* {{App|Rage|おまけ機能が存在する Enlightenment Foundation Libraries を使って書かれた動画・音声プレイヤー。Uses [[GStreamer]]|https://www.enlightenment.org/about-rage|{{AUR|rage}}}}
* {{App|Snappy|ミニマルなインターフェイスを持つパワフルなメディアプレイヤー that uses [[GStreamer]].|https://wiki.gnome.org/Apps/Snappy|{{Pkg|snappy-player}}}}
* {{App|Spivak|Karaoke player based on [[GStreamer]] and Qt5.|https://github.com/gyunaev/spivak|{{AUR|spivak}}}}
* {{App|Xnoise|"スマートな GUI、スピードと多くの機能"を備えた音声・ビデオ両方の GTK と GStreamer を使ったメディアプレイヤー (開発中止)。|http://xnoise-media-player.com/|{{Pkg|xnoise}}}}

====== mpv-based ======

* {{App|Baka MPlayer|Free and open source, cross-platform, [[mpv]] based multimedia player (Qt 5).|https://github.com/u8sand/Baka-MPlayer|{{Pkg|baka-mplayer}}}}
* {{App|Bomi|bomi is a graphical user interface(GUI) player based on mpv for Linux.|https://bomi-player.github.io/|{{AUR|bomi-git}}}}
* {{App|Celluloid|Simple GTK frontend for [[mpv]], formerly GNOME MPV.|https://celluloid-player.github.io/|{{Pkg|celluloid}}}}
* {{App|Clip|Video player and collection manager utilizing [[mpv]] as the backend.|https://mauikit.org/|{{Pkg|maui-clip}}}}
* {{App|Deepin Movie|Movie player for Deepin desktop based on [[mpv]].|https://www.deepin.org/en/original/deepin-movie/|{{Pkg|deepin-movie}}}}
* {{App|Haruna Video Player|Qt/QML video player built on top of [[mpv]].|https://invent.kde.org/multimedia/haruna|{{AUR|haruna}}}}
* {{App|Kawaii-Player|Audio/video manager and multimedia player (based on [[mpv]]) with PC-to-PC casting feature, along with functionalities of portable media server and torrent streaming server.|https://github.com/kanishka-linux/kawaii-player|{{AUR|kawaii-player}}}}
* {{App|KittehPlayer|A YouTube-like video player based on Qt, QML and [[mpv]].|https://github.com/purringChaos/KittehPlayer|{{AUR|kittehplayer-git}}}}
* {{App|Media Player Classic Qute Theater|Clone of [[Wikipedia:Media Player Classic|Media Player Classic]] reimplimented in Qt and based on [[mpv]].|https://github.com/mpc-qt/mpc-qt|{{AUR|mpc-qt}}}}
* {{App|Minitube|YouTube desktop application written in C++ using [[mpv]] and Qt.|https://flavio.tordini.org/minitube|{{Pkg|minitube}}}}
* {{App|MoonPlayer|Video player for playing and downloading online videos from YouTube, Youku etc.|https://github.com/coslyk/moonplayer|{{AUR|moonplayer}}}}
* {{App|[[mpv]]|Very basic GUI for mpv. Can be launched with {{ic|mpv --player-operation-mode=pseudo-gui}}.|https://mpv.io/|{{Pkg|mpv}}}}
* {{App|mpvz|Qt5/QML based GUI for libmpv. Based on the Tethys theme for Bomi.|https://github.com/Zren/mpvz|{{AUR|mpvz-git}}}}
* {{App|[[Wikipedia:SMPlayer|SMPlayer]]|Qt multimedia player with extra features (CSS themes, YouTube integration, etc.) based on [[mpv]]. It can use [[MPlayer]] as alternative backend.|https://www.smplayer.info/|{{Pkg|smplayer}}}}
* {{App|xt7-player-mpv|Qt/Gambas GUI to [[mpv]] with a rich set of configurable options including filters and drivers, ladspa plugins support as well as library/playlist managment, YouTube, online radios, podcasts, DVB-T and more.|https://github.com/kokoko3k/xt7-player-mpv|{{AUR|xt7-player-mpv}}}}

====== MPlayer-based ======

* {{App|GNOME MPlayer|Simple GTK-based GUI for [[MPlayer]].|https://sites.google.com/site/kdekorte2/gnomemplayer|{{Pkg|gnome-mplayer}}}}

====== Phonon-based ======

* {{App|[[Wikipedia:Dragon Player|Dragon Player]]|KDE 用のシンプルなビデオプレイヤー based on [[Phonon]]. Part of the {{Grp|kde-multimedia}} group.|https://apps.kde.org/dragonplayer/|{{Pkg|dragon}}}}
* {{App|[[Wikipedia:KMPlayer|KMPlayer]]|Simple [[Phonon]]-based video player for KDE and video player plugin for Konqueror. It can use [[MPlayer]] as alternative backend.|https://apps.kde.org/kmplayer/|{{Pkg|kmplayer}}}}

====== Other ======

* {{App|FreeTube|Desktop YouTube player built with privacy in mind. Use YouTube without advertisements and prevent Google from tracking you with their cookies and JavaScript. Based on the [https://electronjs.org/ Electron] platform.|https://freetubeapp.io/|{{AUR|freetube-bin}}}}
* {{App|[[Wikipedia:ja:Kaffeine|Kaffeine]]|デフォルトで VLC をバックエンドに使う、多目的 KDE メディアプレイヤー。デジタル TV ([[DVB-T]], DVB-C, [[DVB-S]]) をサポート。|https://apps.kde.org/kaffeine/|{{Pkg|kaffeine}}}}
* {{App|Kaku|Highly integrated music player supports different online platform like YouTube, SoundCloud, Vimeo and more. Based on the [https://electronjs.org/ Electron] platform.|https://kaku.rocks/|{{AUR|kaku-bin}}}}
* {{App|[[Kodi]]|Media player and entertainment hub for digital media.|https://kodi.tv/|{{Pkg|kodi-x11}}{{Broken package link|replaced by {{Pkg|kodi}}}}, {{Pkg|kodi-wayland}}{{Broken package link|replaced by {{Pkg|kodi}}}} or {{Pkg|kodi-gbm}}{{Broken package link|replaced by {{Pkg|kodi}}}}}}
* {{App|QMPlay2|T ベースの動画プレイヤー。ffmpeg と libmodplug がサポートしている全てのフォーマットを再生できます。モジュールシステムが統合されており、Youtube ブラウザなどが入っています。|https://github.com/zaps166/QMPlay2|{{AUR|qmplay2}}}}
* {{App|QtAV Player|QtAV and [[FFmpeg]] ベースのシンプルなメディアプレイヤー。Run with {{ic|Player}} or {{ic|QMLPlayer}}.|https://www.qtav.org/|{{Pkg|qtav}}}}
* {{App|Stremio|Extensible media center.|https://www.stremio.com/|{{AUR|stremio}}, {{AUR|stremio-beta}}|}}
* {{App|[[Wikipedia:tvtime|tvtime]]|High quality television application for use with video capture cards.|https://linuxtv.org/|{{Pkg|tvtime}}}}
* {{App|[[VLC media player]]|中堅のビデオプレーヤー、様々なオーディオ・ビデオフォーマットをサポート。|https://www.videolan.org/vlc/|{{Pkg|vlc}}}}
* {{App|[[Wikipedia:xine|xine]]|フリーのマルチメディアプレイヤー。|https://www.xine-project.org/|{{Pkg|xine-ui}}}}
* {{App|Xjadeo|Video player that displays a video-clip in sync with an external time source (MTC, LTC, JACK-transport).|http://xjadeo.sourceforge.net/|{{Pkg|xjadeo}}}}
* {{App|YUView|Qt-based YUV player with an advanced analytic toolset.|https://github.com/IENT/YUView|{{AUR|yuview}}}}

==== Video converters ====

See also [[Wikipedia:Comparison of video converters]] and [[コーデック#Container format tools]].

===== Console =====

* {{App|[[Wikipedia:Avidemux|Avidemux CLI]]|単純な切り取り、フィルタリング、エンコードなどの作業のためのフリーのビデオエディタ。|https://www.avidemux.org/|{{Pkg|avidemux-cli}}}}
* {{App|[[FFmpeg]]|音声や動画を記録・変換・ストリーミングすることができる、完全なクロスプラットフォームのソリューション。|https://ffmpeg.org/|{{Pkg|ffmpeg}}}}
* {{App|[[Wikipedia:HandBrake|HandBrake CLI]]|mkv/x264 リッピングのバッチ処理にうってつけのシンプルでパワフルなビデオトランスコーダー。|https://handbrake.fr/|{{Pkg|handbrake-cli}}}}
* {{App|[[Wikipedia:MEncoder|MEncoder]]|Free command line video decoding, encoding and filtering tool.|https://mplayerhq.hu/design7/news.html|{{Pkg|mencoder}}}}
* {{App|Transcode|Command line tool for video stream processing.|http://www.transcoding.org/|{{Pkg|transcode}}}}

===== Graphical =====

* {{App|Ciano|Simple multimedia file converter using FFmpeg and ImageMagick.|https://robertsanseries.github.io/ciano/|{{Pkg|ciano}}}}
* {{App|FFmpegYAG|Advanced GUI for the popular FFmpeg audio/video encoding tool.|https://sourceforge.net/projects/ffmpegyag/|{{AUR|ffmpegyag}}}}
* {{App|FF Multi Converter|Simple graphical application which enables you to convert audio, video, image and document files between all popular formats, by utilizing other command-line tools.|https://sites.google.com/site/ffmulticonverter/|{{AUR|ffmulticonverter}}}}
* {{App|[[Wikipedia:HandBrake|HandBrake]]|mkv/x264 リッピングのバッチ処理にうってつけのシンプルでパワフルなビデオトランスコーダー。GTK バージョン。|https://handbrake.fr/|{{Pkg|handbrake}}}}
* {{App|QWinFF|Qt5 GUI for FFmpeg that can read audio and video files in various formats and convert them into other formats.|https://qwinff.github.io/|{{AUR|qwinff}}}}
* {{App|Transmageddon|動画を GStreamer によってサポートされているフォーマットに変換するシンプルな python アプリケーション。|http://www.linuxrising.org/ |{{Pkg|transmageddon}}}}
* {{App|WinFF|Graphical video and audio batch converter using FFmpeg.|https://www.biggmatt.com/winff/|{{AUR|winff}}}}

==== ビデオエディタ ====

See also [[Wikipedia:Comparison of video editing software]].

* {{App|[[Wikipedia:Avidemux|Avidemux]]|単純な切り取り、フィルタリング、エンコードなどの作業のためのフリーのビデオエディタ。|http://fixounet.free.fr/avidemux/| {{Pkg|avidemux-qt}}}}
* {{App|[[Wikipedia:Blender_(software)#Video_editing|Blender]]|ノンリニアな動画エディタが組み込まれているフル機能の 3D グラフィック作成スイート。|https://www.blender.org/|{{Pkg|blender}}}}
* {{App|[[Wikipedia:Cinelerra|Cinelerra (Heroine Virtual)]]|プロフェッショナルなビデオ編集・合成環境。|http://heroinewarrior.com/cinelerra.php|{{AUR|cinelerra-hv}}}}
* {{App|[[Wikipedia:Cinelerra|Cinelerra (Community Version)]]|プロフェッショナルなビデオ編集・合成環境。|http://cinelerra-cv.wikidot.com/|{{AUR|cinelerra-cv}}}}
* {{App|[[Wikipedia:Cinelerra|Cinelerra GG Infinity]]|プロフェッショナルなビデオ編集・合成環境。|https://www.cinelerra-gg.org/|{{AUR|cinelerra-gg-git}}}}
* {{App|[[DaVinci Resolve]]|Proprietary A/V post-production software suite.|https://www.blackmagicdesign.com/products/davinciresolve/|{{AUR|davinci-resolve}}}}
* {{App|[[Wikipedia:Flowblade|Flowblade]]|Linux 用のマルチトラック・ノンリニア動画エディタ。素早く、堅牢な編集環境を得られるように作られています。|https://jliljebl.github.io/flowblade/|{{Pkg|flowblade}}}}
* {{App|[[Wikipedia:Kdenlive|Kdenlive]]|セミプロフェッショナルな作業のために設計されたノンリニアビデオエディタ。|https://kdenlive.org/|{{Pkg|kdenlive}}}}
* {{App|[[Wikipedia:Lightworks|Lightworks]]|様々なフォーマットのデジタル動画を編集・マスタリングするための、プロプライエタリのプロフェッショナルノンリニア編集システム。|https://www.lwks.com/|{{AUR|lightworks}}}}
* {{App|[[Wikipedia:LiVES|LiVES]]|ビデオエディタ and VJ (ライブパフォーマンス) platform.|http://lives-video.com/|{{AUR|lives}}}}
* {{App|LosslessCut|GUI tool for lossless trimming/cutting of video/audio files. Based on the [https://electronjs.org/ Electron] platform.|https://mifi.no/losslesscut/|{{AUR|losslesscut-bin}}}}
* {{App|[[Wikipedia:Natron (software)|Natron]]|Open-source compositing software. Node-graph based. Similar in functionalities to Adobe After Effects and Nuke by The Foundry.|https://natrongithub.github.io/|{{AUR|natron}}}}
* {{App|Olive|Non-linear video editor aiming to provide a fully-featured alternative to high-end professional video editing software.
|https://www.olivevideoeditor.org/|{{AUR|olive}}}}
* {{App|[[Wikipedia:OpenShot_Video_Editor|OpenShot]]|MLT フレームワークを使ったノンリニアビデオエディタ。|https://www.openshot.org/|{{Pkg|openshot}}}}
* {{App|[[Wikipedia:Pitivi|Pitivi]]|直感的に操作でき GNOME と協調するように作られたビデオエディタ。|https://www.pitivi.org/ |{{Pkg|pitivi}}}}
* {{App|[[Wikipedia:Shotcut|Shotcut]]|フリーでオープンソースのクロスプラットフォーム動画エディタ。|https://www.shotcut.org/ |{{Pkg|shotcut}}}}
* {{App|VapourSynth Editor|Editor for VapourSynth scripts.|https://bitbucket.org/mystery_keeper/vapoursynth-editor|{{AUR|vapoursynth-editor}}}}
* {{App|VidCutter|Fast lossless media cutter + joiner w/ frame-accurate SmartCut options powered by mpv, FFmpeg via a sleek Qt5 GUI.|https://vidcutter.ozmartians.com/|{{Pkg|vidcutter}}}}
* {{App|Video Trimmer|Cut out a fragment of a video given the start and end timestamps. The video is never re-encoded, so the process is very fast and does not reduce the video quality.|https://gitlab.gnome.org/YaLTeR/video-trimmer|{{AUR|video-trimmer}}}}

==== Subtitles ====

===== Subtitle players =====

* {{App|Penguin Subtitle Player|スタンドアロン字幕プレイヤー that provides a translucent window which always stays on the top so subtitles can be shown on top of the video without blocking anything.|https://github.com/carsonip/Penguin-Subtitle-Player|{{Pkg|penguin-subtitle-player}}}}
* {{App|SubtitlesPrinter|X の画面上に字幕を表示。動画プレイヤーに依存しません。|https://github.com/OlivierMarty/SubtitlesPrinter|{{AUR|subtitles-printer-git}}}}

===== Subtitle downloaders =====

* {{App|QNapi|Qt client for downloading movie subtitles from NapiProjekt, OpenSubtitles, Napisy24.|https://qnapi.github.io/|{{Pkg|qnapi}}}}
* {{App|subdl|Command-line tool for downloading subtitles from opensubtitles.org.|https://github.com/akexakex/subdl|{{Pkg|subdl}}}}
* {{App|SubDownloader|Automatic download/upload of subtitles using fast hashing.|https://github.com/subdownloader/subdownloader|{{Pkg|subdownloader}}}}

===== Subtitle editors =====

See also [[Wikipedia:Comparison of subtitle editors]].

* {{App|[[Wikipedia:Aegisub|Aegisub]]|Subtitle editor.|https://github.com/Aegisub/Aegisub|{{Pkg|aegisub}}}}
* {{App|Gaupol|フル機能の字幕エディタ。|https://otsaloma.io/gaupol/|{{Pkg|gaupol}}}}
* {{App|[[Wikipedia:Gnome Subtitles|Gnome Subtitles]]|GNOME の動画字幕エディタ。|http://www.gnomesubtitles.org/|{{Pkg|gnome-subtitles}}}}
* {{App|Jubler|Open-source multiplatform subtitle editor written in Java.|https://www.jubler.org/|{{AUR|jubler}}}}
* {{App|Subtitle Composer|字幕エディタ for KDE supporting various formats, 様々なプレイヤーのバックエンドをサポートしており、波形を表示することもできます。|https://subtitlecomposer.kde.org/|{{AUR|subtitlecomposer}}}}
* {{App|[[Wikipedia:Subtitle_Edit|Subtitle Edit]]|Subtitle editing program. Written in C# using mono.|https://github.com/SubtitleEdit/subtitleedit|{{AUR|subtitleedit}}}}
* {{App|Subtitle Editor|GTK 3 tool to edit subtitles for GNU/Linux/*BSD.|https://kitone.github.io/subtitleeditor/|{{Pkg|subtitleeditor}}}}

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

[[スクリーンショットの取得#スクリーンキャスト]] を参照してください。

==== Miracast ====

See [[:en:Miracast#Implementations]].

==== ウェブカメラ ====

See also [[FFmpeg#Recording webcam]] and [[Wikipedia:Comparison of webcam software]].

* {{App|[[Wikipedia:Cheese (software)|Cheese]]|Take photos and videos with your webcam, with fun graphical effects.|https://wiki.gnome.org/Apps/Cheese|{{Pkg|cheese}}}}
* {{App|Deepin Camera|Tool to view camera, take photo and video.|https://github.com/linuxdeepin/deepin-camera|{{Pkg|deepin-camera}}}}
* {{App|fswebcam|Small and simple command line webcam software that generates images for a webcam.|https://www.sanslogic.co.uk/fswebcam/|{{AUR|fswebcam}}}}
* {{App|[[Wikipedia:Guvcview|Guvcview]]|Simple interface for capturing and viewing video from v4l2 devices.|http://guvcview.sourceforge.net/|GTK: {{Pkg|guvcview}}, Qt: {{Pkg|guvcview-qt}}}}
* {{App|Kamoso|Webcam recorder from KDE community.|https://apps.kde.org/kamoso/|{{Pkg|kamoso}}}}
* {{App|MJPG-streamer|Command line application which can be used to stream M-JPEG over an IP-based network from a webcam to various types of viewers.|https://github.com/jacksonliam/mjpg-streamer|{{AUR|mjpg-streamer-git}}}}
* {{App|[[Motion]]|Highly configurable program that monitors video signals from many types of cameras. It is able to detect if a significant part of the picture has changed; in other words, it can detect motion.|https://motion-project.github.io/|{{Pkg|motion}}}}
* {{App|Pantheon Camera|Camera app designed for elementary OS.|https://github.com/elementary/camera|{{Pkg|pantheon-camera}}}}
* {{App|QtCAM|Webcam software with more than 10 image control settings, extension settings and color space switching.|https://www.e-consystems.com/opensource-linux-webcam-software-application.asp|{{AUR|qtcam-git}}}}
* {{App|v4l2ucp|Universal control panel for V4L2 devices.|http://v4l2ucp.sourceforge.net/|{{AUR|v4l2ucp}}}}
* {{App|v4l-utils|Provides a series of utilities for media devices.|https://linuxtv.org/|{{Pkg|v4l-utils}}}}
* {{App|Webcamoid|Full featured webcam suite.|https://webcamoid.github.io/|{{AUR|webcamoid}}}}
* {{App|ZArt|GUI for G'MIC real-time manipulations on the output of a webcam.|https://gmic.eu/|{{Pkg|zart}}{{Broken package link|package not found}}}}

==== DVD authoring ====

See also [[Wikipedia:List of DVD authoring applications]].

* {{App|Bombono DVD|DVD authoring program with nice and clean GUI.|https://bombono.com/|{{AUR|bombono-dvd}}}}
* {{App|[[Wikipedia:DeVeDe|Devede]]|Program to create VideoDVDs and CDs.|https://rastersoft.com/programas/devede.html|{{Pkg|devede}}}}
* {{App|[[Wikipedia:DVDStyler|DVDStyler]]|DVD authoring application for the creation of professional-looking DVDs.|https://www.dvdstyler.org/|{{Pkg|dvdstyler}}}}

==== DVD リッピング ====

[[光学ディスクドライブ#DVD]] を見て下さい。

==== Video thumbnails ====

* {{App|vcsi|Create video contact sheets. A video contact sheet is an image composed of video capture thumbnails arranged on a grid.|https://github.com/amietn/vcsi|{{AUR|vcsi}}}}
* {{App|Video Contact Sheet|Bash script meant to create video contact sheets (previews) of videos. Any video supported by mplayer and ffmpeg can be used.|https://p.outlyer.net/vcs|{{AUR|video-contact-sheet}}}}

=== Game and interactive application development ===
* {{App|[[Godot Engine]]|Game development platform for both 2D and 3D games, with integrate IDE|https://godotengine.org|{{Pkg|godot}}}}
* {{App|LÖVE|Lua based game development environment|https://love2d.org|{{Pkg|love}}}}
* {{App|TIC-80|Fantasy computer/console|https://tic80.com|{{AUR|tic-80-git}}}}

=== Collection managers ===

* {{App|Data Crow|Media cataloger and media organizer.|https://datacrow.net/|{{AUR|datacrow}}}}
* {{App|[[Wikipedia:GCstar|GCstar]]|GNOME application for organizing various collections (board games, comic books, movies, stamps, etc.).|http://www.gcstar.org/|{{AUR|gcstar}}}}
* {{App|Griffith|Movie collection manager application.|https://gitlab.com/Strit/griffith|{{Pkg|griffith}}}}
* {{App|MediaElch|Media manager for Kodi. Information about movies, TV shows, concerts and music are stored as nfo files.|https://www.kvibes.de/mediaelch/|{{Pkg|mediaelch}}}}
* {{App|[[Wikipedia:Tellico_(software)|Tellico]]|KDE application for organizing various collections (books, video, music, coins, etc.).|https://tellico-project.org/|{{Pkg|tellico}}}}
* {{App|tinyMediaManager|Media management tool to provide metadata for Kodi.|https://www.tinymediamanager.org/|{{AUR|tiny-media-manager}}}}
* {{App|vMovieDB|Movie collection manager for the Gnome desktop.|https://sourceforge.net/projects/vmoviedb/|{{AUR|vmoviedb}}}}

=== Media servers ===

* {{App|Airsonic|Web-based media streamer, providing ubiquitous access to your music. (Fork of Subsonic.)|https://airsonic.github.io/|{{AUR|airsonic}}}}
* {{App|[[Emby]]|Proprietary media server, which automatically converts and streams your media on-the-fly to play on any device.|https://emby.media/|{{Pkg|emby-server}}}}
* {{App|OwnTone|DAAP (iTunes) and MPD media server with support for AirPlay devices, Apple Remote, Chromecast, Spotify and internet radio.|https://owntone.github.io/owntone-server/|{{AUR|owntone-server}}}}
* {{App|Gerbera|UPnP Media Server to stream your media to devices on your home network. (Fork of MediaTomb.)|https://gerbera.io/|{{Pkg|gerbera}}}}
* {{App|[[Icecast]]|Streaming media (audio/video) server which currently supports Ogg (Vorbis and Theora), Opus, WebM and MP3 streams.|https://icecast.org/|{{Pkg|icecast}}}}
* {{App|[[:en:Jellyfin]]|Media system that puts you in control of managing and streaming your media.|https://jellyfin.org/|Server: {{AUR|jellyfin}}, desktop client: {{AUR|jellyfin-media-player}}, cast client: {{AUR|jellyfin-mpv-shim}}}}
* {{App|[[Plex]]|Proprietary media server, which organizes your personal video, music, and photo collections and streams them to all of your devices.|https://www.plex.tv/|{{AUR|plex-media-server}}}}
* {{App|[[ReadyMedia]]|Simple media server software, with the aim of being fully compliant with DLNA/UPnP-AV clients.|https://sourceforge.net/projects/minidlna/|{{Pkg|minidlna}}}}
* {{App|[[Rygel]]|UPnP AV MediaServer and MediaRenderer that allows you to easily share audio, video and pictures, and control of media player on your home network.|https://wiki.gnome.org/Projects/Rygel|{{Pkg|rygel}}}}
* {{App|Serviio|Proprietary media server, which allows you to stream your media files (music, video or images) to renderer devices (e.g. a TV set, Bluray player, games console or mobile phone) on your connected home network.|https://serviio.org/|{{AUR|serviio}}}}
* {{App|[[Subsonic]]|Proprietary media server to stream from your own computer.|http://www.subsonic.org/|{{AUR|subsonic}}}}
* {{App|[[Tvheadend]]|TV streaming server and recorder supporting DVB-S, DVB-S2, DVB-C, DVB-T, ATSC, ISDB-T, IPTV, SAT>IP and HDHomeRun as input sources.|https://tvheadend.org/|{{AUR|tvheadend}}}}
* {{App|[[Universal Media Server]]|UPnP media server, which is capable of sharing video, audio and images between most modern devices. (Fork of PS3 Media Server.)|https://www.universalmediaserver.com/|{{AUR|ums}}}}

=== メタデータ ===

* {{App|CoreInfo|Simple media metadata viewer built on mediainfo library. Part of C-Suite.|https://cubocore.org/|{{AUR|coreinfo}}}}
* {{App|DV Analyzer|Technical quality control and reporting tool that examines DV streams in order to report errors.|https://mediaarea.net/DVAnalyzer|CLI: {{AUR|dvanalyzer}}, GUI: {{AUR|dvanalyzer-gui}}}}
* {{App|[[Wikipedia:ExifTool|ExifTool]]|Command-line application for reading, writing and editing meta information in a wide variety of files.|https://sno.phy.queensu.ca/~phil/exiftool/|{{Pkg|perl-image-exiftool}}}}
* {{App|Exiv2|Command line utility to manage image metadata. It provides fast and easy read and write access to the Exif, IPTC and XMP metadata and the ICC Profile embedded within digital images in various formats.|https://exiv2.org/|{{Pkg|exiv2}}}}
* {{App|[[Wikipedia:FFmpeg|ffprobe]]|Gather information from multimedia streams and print it in human- and machine-readable fashion.|https://ffmpeg.org/ffprobe.html|{{Pkg|ffmpeg}}}}
* {{App|jExifToolGUI|Java/Swing graphical frontend for ExifTool, which reads and writes all kind of metadata tags from/to image files.|https://hvdwolf.github.io/jExifToolGUI/|{{AUR|jexiftoolgui}}}}
* {{App|jhead|Exif jpeg header manipulation tool.|https://sentex.net/~mwandel/jhead/|{{Pkg|jhead}}}}
* {{App|MediaConch|Implementation checker, policy checker, reporter, and fixer.|https://mediaarea.net/MediaConch|CLI: {{AUR|mediaconch}}, GUI: {{AUR|mediaconch-gui}}}}
* {{App|[[Wikipedia:MediaInfo|MediaInfo]]|Convenient unified display of the most relevant technical and tag data for video and audio files.|https://mediaarea.net/en/MediaInfo|CLI: {{Pkg|mediainfo}}, GUI: {{Pkg|mediainfo-gui}}}}
* {{App|[[Wikipedia:libsndfile|sndfile-info]]|Obtaining information about the contents of an audio file.|http://mega-nerd.com/libsndfile/|{{Pkg|libsndfile}}}}

=== Mobile device managers ===

* {{App|Android File Transfer|Interactive [[Media Transfer Protocol]] client with Qt5 GUI.|https://whoozle.github.io/android-file-transfer-linux/|{{Pkg|android-file-transfer}}}}
* {{App|[[Wikipedia:Gnokii|gnokii]]|携帯電話を使うためのツールとユーザースペースドライバ。|https://www.gnokii.org/|{{AUR|gnokii}}}}
* {{App|gMTP|Simple MP3 and media player client for [[Media Transfer Protocol]].|https://gmtp.sourceforge.io/|{{Pkg|gmtp}}}}
* {{App|GNOME Phone Manager|GNOME デスクトップから携帯電話をコントロール。|https://wiki.gnome.org/Attic/PhoneManager|{{AUR|gnome-phone-manager}}}}
* {{App|[[Wikipedia:gtkpod|gtkpod]]|GUI for Apple's iPod using GTK. It allows you to import your existing iTunes database, add songs, podcasts, videos and cover art, and to edit ID3 tags.|https://sourceforge.net/projects/gtkpod/|{{AUR|gtkpod}}}}
* {{App|KDE Connect|Provides integration between devices.|https://kdeconnect.kde.org/|{{Pkg|kdeconnect}}}}
* {{App|Modem Manager GUI|Control EDGE/3G/4G broadband modem specific functions.|https://linuxonly.ru/page/modem-manager-gui|{{Pkg|modem-manager-gui}}}}
* {{App|Wammu|Manage data in your cell phone such as contacts, calendar or messages.|https://wammu.eu/|{{AUR|wammu}}}}

=== 光メディアの書き込み ===

[[光学ディスクドライブ#GUI で CD/DVD/BD を焼く]] を見てください。

<noinclude>
{{TranslationStatus|List of applications/Multimedia|2021-12-29|707821}}
</noinclude>

トラックポイント

2023-05-14T00:16:28Z

Shota: /* Two-finger scroll ceases to work after suspending */ 訳出

[[Category:入力デバイス]]
[[Category:Lenovo]]
[[en:TrackPoint]]
[[zh-hans:TrackPoint]]
TrackPoint はキーボードの中央に位置するポインティングスティックに対する Lenovo の登録商標です。トラックポイントは {{Pkg|xf86-input-evdev}} や {{Pkg|xf86-input-libinput}} でサポートされています。

デフォルトの [[Xorg]] ではクリックとポイントをサポートしていますが、{{ic|evdev}} ドライバーで中クリックやスクロールを使うには設定が必要です。

== GUI の設定 ==

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

{{Note|上記のソフトウェアはメンテナンスが止まっています (最後のリリースは2013年です)。{{Pkg|xf86-input-libinput}} を使用する場合、細かい設定ができない可能性があります。}}

==中ボタンのスクロール==

{{Pkg|xf86-input-libinput}} を使用する場合、デフォルトで中ボタンのスクロールが有効になります。

{{Pkg|xf86-input-evdev}} を使用する場合、中ボタンのスクロールは {{Pkg|xorg-xinput}} パッケージの ''xinput'' でサポートされます。例:

{{hc|~/.xinitrc|
xinput set-prop "''TPPS/2 IBM TrackPoint''" "Evdev Wheel Emulation" 1
xinput set-prop "''TPPS/2 IBM TrackPoint''" "Evdev Wheel Emulation Button" 2
xinput set-prop "''TPPS/2 IBM TrackPoint''" "Evdev Wheel Emulation Timeout" 200
xinput set-prop "''TPPS/2 IBM TrackPoint''" "Evdev Wheel Emulation Axes" 6 7 4 5
}}

{{Note|
* デバイスの名前は {{ic|xinput --list}} や {{Pkg|hwinfo}} で確認できます。
* {{ic|"Device Accel Constant Deceleration"}} の行ではトラックポイントの感度を設定しています。
}}

=== Xorg の設定 ===

トラックポイントで中マウスボタンを押すことによるスクロールを有効にするには、{{ic|/etc/X11/xorg.conf.d/20-thinkpad.conf}} を作成してください ({{ic|TPPS/2 IBM TrackPoint}} は ''xinput'' で確認できるデバイス名に置き換えてください):

Section "InputClass"
Identifier "Trackpoint Wheel Emulation"
Driver "evdev"
MatchProduct "''TPPS/2 IBM TrackPoint''"
MatchDevicePath "/dev/input/event*"
Option "EmulateWheel" "true"
Option "EmulateWheelButton" "2"
Option "Emulate3Buttons" "false"
Option "XAxisMapping" "6 7"
Option "YAxisMapping" "4 5"
EndSection

=== 2ボタントラックポイント ===
ボタンが2つあるトラックポイントの場合、{{Pkg|xf86-input-libinput}} を使うと、スクロールボタンを右クリックボタンに設定することができます。

''device'' を {{ic|xinput}} を実行するとわかるデバイス名に置き換えてください:

$ xinput set-prop "''device''" "libinput Button Scrolling Button" 3

== Sysfs 属性 ==

トラックポイントでは属性を {{ic|/sys/devices/platform/i8042/serio1/}} のファイルから変更することができます。例えば、手動でタップでクリック機能を有効にするには:

# echo -n 1 > /sys/devices/platform/i8042/serio1/press_to_select

{{Note|{{ic|press_to_select}} ファイルの位置は使用するデバイスによって変わります。トラックポイントとタッチパッドが両方存在するコンピュータでは {{ic|/sys/devices/platform/i8042/serio1/serio2/}} のパスが使われますが、トラックポイントデバイスがしか存在しない場合は {{ic|/sys/devices/platform/i8042/serio1/}} のパスが使われます。}}

=== 起動時に設定 ===

==== udev ルール ====

このルールは、トラックポイントの'''速度'''を上げ、起動時に'''タップして選択'''(上記を参照)できるようにします。

{{hc|1=/etc/udev/rules.d/10-trackpoint.rules|2=
ACTION=="add", SUBSYSTEM=="input", ATTR{name}=="TPPS/2 IBM TrackPoint", ATTR{device/sensitivity}="240", ATTR{device/press_to_select}="1"
}}

==== systemd.path ユニット ====

ブートプロセスの中で {{ic|/sys/devices/platform/i8042/serio1/serio2/}} の属性やファイルが現れるのが遅すぎて上記の udev ルールを使う方法が使えないという [https://bbs.archlinux.org/viewtopic.php?id=199998 報告] がフォーラムにあります。代わりに ''systemd.path'' ユニットを使ってトラックポイントの属性を設定することができます。

まず {{ic|/usr/local/bin/trackpoint_configuration.sh}} とう名前のスクリプトを作成してください。スクリプトの中で [[#Sysfs 属性]]に書かれているようにトラックポイントの属性を設定します。それから以下の systemd ユニットを作成してください。スクリプトで変更する属性は全て {{ic|PathExists}} に指定してください。

{{hc|/etc/systemd/system/trackpoint_parameters.path|2=
[Unit]
Description=Watch for, and modify, Trackpoint attributes

[Path]
PathExists=/sys/devices/platform/i8042/serio1/press_to_select

[Install]
WantedBy=default.target
}}

{{hc|/etc/systemd/system/trackpoint_parameters.service|2=
[Unit]
Description=Set TrackPoint attributes

[Service]
ExecStart=/usr/local/bin/trackpoint_configuration.sh
}}

最後に {{ic|trackpoint_parameters.path}} を[[起動]]・[[有効化]]してください。

==== udev hwdb エントリ ====

Libinput は [https://github.com/systemd/systemd/blob/master/hwdb/70-pointingstick.hwdb udev ハードウェアデータベース] のエントリに基づいて sysfs にパラメータを適用します。Wayland コンポジタでは libinput が唯一の入力インターフェイスになります。Wayland コンポジタや X セッションを起動する前に変更を行っても上書きされてしまいます。

libinput のデフォルト設定を上書きするには、ローカル hwdb エントリを追加してください:

{{hc|/etc/udev/hwdb.d/99-trackpoint.hwdb|2=
evdev:name:TPPS/2 IBM TrackPoint:dmi:bvn*:bvr*:bd*:svnLENOVO:pn*:pvrThinkPad??60?:*
POINTINGSTICK_SENSITIVITY=250
}}

[https://github.com/systemd/systemd/blob/master/hwdb/70-pointingstick.hwdb udev ハードウェアデータベース] で様々なベンダー/モデルキーを見つけることができます。なお、[https://cgit.freedesktop.org/wayland/libinput/commit/src/evdev.c?id=3669fa10dff95371658647272ef7ac7a3ef29a61 このコミットから]、libinput は POINTINGSTICK_CONST_ACCEL 設定パラメータを無視し、POINTINGSTICK_SENSITIVITY (0から255の値をとります) を参照します。

変更を適用するには udev の hwdb をリロードします:

# udevadm hwdb --update

コンポジタや X セッションを再起動する前に変更をテストするには、まず以下のコマンドでデバイスの入力ノード {{ic|/dev/input/eventX}} を確認してください:

# libinput-list-devices

そして以下のコマンドを実行してデバッグ出力を生成:

# udevadm trigger /sys/class/input/eventX
# udevadm test /sys/class/input/eventX

{{Note|上記のコマンドでは hwdb からパラメータは適用されませんが、{{ic|udevadm test}} コマンドの出力で変更を確認できます。}}

最後に、Wayland コンポジタや X セッションを再起動して変更を適用してください。

==== device-quirks ====

{{ic|libinput}} は {{ic|.ini}} スタイルの設定ファイルに移行しており、トラックポイントのパラメータを {{ic|/etc/libinput/}} 内で上書きすることで調節できます。

例えば、トラックポイントの速度を上書きするには、{{ic|/etc/libinput/local-overrides.quirks}} を次のように作成してください:
[Trackpoint Override]
MatchUdevType=pointingstick
AttrTrackpointMultiplier=0.75

詳細については、公式ドキュメント [https://wayland.freedesktop.org/libinput/doc/latest/device-quirks.html#installing-temporary-local-device-quirks libinput: Installing temporary local device quirks] を参照してください。

{{Warning|Model quirks は内部 API であり、後方互換性の保証なく突然変更されることがありえます。ディストリビューション側が libinput をアップデートするまでの方策としてのみ利用するようにしてください。}}

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

===トラックポイントが認識されない、あるいは数分後に認識される===
カーネルのバグが原因です。参照: https://bugzilla.kernel.org/show_bug.cgi?id=33292

対処方法は {{ic|psmouse}} モジュールに {{ic|1=proto=bare}} を指定することです。ただし、これを設定するとクリックパッドによるスクロールと2本指の中クリックが無効化されてしまいます:
# modprobe psmouse proto=bare

=== トラックポイントのボタンが動かない場合がある ===

BIOS でタッチパッドを無効化すると間違ったボタンが無効になったり、トラックポイントのボタンが安定して動作しない場合、{{ic|psmouse}} モジュールに {{ic|1=proto=imps}} を設定することで解決できます:
# rmmod psmouse; modprobe psmouse proto=imps

=== サスペンド後に二本指でのスクロールが機能しなくなる ===

いくつかのラップトップでは、psmouse が起動に失敗することや、サスペンド後に復帰しないことがあります:

psmouse serio1: synaptics: Unable to initialize device

カーネルコマンドラインに {{ic|1=psmouse.synaptics_intertouch=0}} を追記してみてください。

=== Trackpoint moves on its own ===

On some ThinkPads the TrackPoint cursor moves spontaneously after release and it does not stop. This happens because of a low value of the {{ic|drift_time}} parameter (e.g. 5), you need to change it to 25 or 30 to fix the problem. This can be done with a [[udev]] rule:

{{hc|/etc/udev/rules.d/10-trackpoint.rules|2=
ACTION=="add", SUBSYSTEM=="input", ATTR{name}=="TPPS/2 IBM TrackPoint", ATTR{device/drift_time}="25"
}}

== 参照 ==

* [https://www.thinkwiki.org/wiki/How_to_configure_the_TrackPoint How to configure the TrackPoint - ThinkWiki]
* [https://gist.githubusercontent.com/noromanba/11261595/raw/478cf4c4d9b63f1e59364a6f427ffccd63db5e1e/thinkpad-trackpoint-speed.mkd Trackpoint speed]
* [https://askubuntu.com/questions/37824/what-is-the-best-way-to-configure-a-thinkpads-trackpoint/553926 What is the best way to configure a Thinkpad's TrackPoint?]

Flatpak

2023-05-04T03:04:24Z

Shota: /* インストール */ flatpak のビルド方法について、英語版を反映 (flatpak-builder を使うように変更)

[[Category:開発]]
[[de:Flatpak]]
[[en:Flatpak]]
[[es:Flatpak]]
[[pt:Flatpak]]
[[zh-hans:Flatpak]]
{{Related articles start}}
{{Related|Snapd}}
{{Related|bubblewrap}}
{{Related articles end}}
プロジェクトの [https://github.com/flatpak/flatpak/blob/master/README.md README] より:
:[https://flatpak.org Flatpak] は Linux 上でサンドボックス化したデスクトップアプリケーションをビルド・配布・実行するためのシステムです。

{{man|1|flatpak}} より:

:Flatpak はアプリケーションやランタイムを管理するためのツールです。Flatpak モデルでは、アプリケーションをホスト環境とは独立してビルド・配布することができます。アプリケーションは実行時にホスト環境から隔離 (サンドボックス化) されます。
:Flatpak は [https://ostree.readthedocs.io/en/latest/ OSTree] を使用してデータを配布・デプロイします。Flatpak のリポジトリは OSTree のリポジトリであり、ostree ユーティリティによって操作することが可能です。ランタイムやアプリケーションのインストールは OSTree のチェックアウトと同じです。

{{Warning|<nowiki></nowiki>
* Flatpak アプリケーションは、[https://flathub.org/home flathub] にあるパッケージであっても、例えば {{ic|$HOME}} のユーザーファイルへのアクセスを許可したり、X11 を通じてサンドボックスから逃れるなど、'''デフォルトでは''' 効果的にサンドボックス化されません。[https://hanako.codeberg.page/]
* 信頼できないコードを実行することは決して安全ではなく、サンドボックス化によってこれを変更することはできません。}}

== インストール ==

{{pkg|flatpak}} パッケージを[[インストール]]してください。flatpak をビルドしたい場合は、{{pkg|flatpak-builder}} もインストールして下さい。

=== デスクトップとの統合 ===

flatpak アプリケーションがデスクトップと対話するためには、[[PipeWire#WebRTC 画面共有|xdg-desktop-portal]] を必ずセットアップしてください。デスクトップの実装によっては、アプリケーションがいくつかのポータルにアクセスする前に確認ダイアログが表示されます。

== リポジトリの管理 ==

{{Note|デフォルトでは、すべての flatpak コマンドはシステム全体で機能します。つまり、パッケージはコンピュータ内のすべてのユーザーにインストールされ、flatpak はユーザーに root のパスワードの入力を要求します。パッケージをインストールし、 (スーパーユーザー権限を必要とせずに) 単一のユーザーでリポジトリを操作するには、オプション {{ic|--user}} を各コマンドに追加します。たとえば、自分だけに表示されるリポジトリを追加したい場合は、{{ic|$ flatpak remote-add --user ''name'' ''location''}} を実行する必要があります。自分だけが表示できるパッケージをインストールするには、{{ic|$ flatpak install --user ''package-name''}} を実行します。}}

=== リポジトリの追加 ===

リモートの flatpak リポジトリを追加するには次のコマンドを実行:

$ flatpak remote-add ''name'' ''location''

''name'' は新しいリモートリポジトリの名前、''location'' はリポジトリのパスあるいは URL に置き換えてください。

例えば公式の [https://flathub.org/ Flathub リポジトリ] を追加するには:

$ flatpak remote-add --if-not-exists flathub <nowiki>https://dl.flathub.org/repo/flathub.flatpakrepo</nowiki>

=== リポジトリの削除 ===

リモートの flatpak リポジトリを削除するには次のコマンドを実行:

$ flatpak remote-delete ''name''

''name'' は削除したいリモートリポジトリの名前に置き換えてください。

=== リポジトリの一覧表示 ===

追加されたすべてのリポジトリの一覧を表示するには、次のようにします。

$ flatpak remotes

== ランタイムとアプリケーションの管理 ==

=== リモートのランタイムやアプリケーションの検索 ===

新しく追加したリモートリポジトリのランタイムやアプリケーションを検索するには、リポジトリの appstream データを取得する必要があります:

{{hc|$ flatpak update|
Looking for updates...
Updating appstream data for remote ''name''
}}

取得したら {{ic|flatpak search ''packagename''}} でパッケージを検索できます。例えば {{ic|flathub}} リポジトリの {{ic|libreoffice}} パッケージを探すには:

{{hc|$ flatpak search libreoffice|
Application ID Version Branch Remotes Description
org.libreoffice.LibreOffice stable flathub The LibreOffice productivity suite
}}

=== 利用可能なランタイムとアプリケーションの確認 ===

''remote'' という名前のリモートリポジトリに存在するランタイムとアプリケーションを確認するには次を実行:

$ flatpak remote-ls ''remote''

=== ランタイムやアプリケーションのインストール ===

ランタイムやアプリケーションをインストールするには次を実行:

$ flatpak install ''remote'' ''name''

''remote'' はリモートリポジトリの名前に、''name'' はインストールしたいアプリケーションやランタイムの名前に置き換えてください。

{{Tip|識別子の一部のみを指定することもできます。例えば {{ic|flatpak install libreoffice}} を実行してもインストールが行えます。}}

=== インストールされたランタイムやアプリケーションの確認 ===

インストールされたランタイムやアプリケーションを確認するには次を実行:

$ flatpak list

=== アプリケーションの実行 ===

Flatpak アプリケーションはコマンドラインから起動することもできます:

$ flatpak run ''name''

=== ランタイムやアプリケーションのアップデート ===

''name'' という名前のランタイムあるいはアプリケーションをアップデートするには次を実行:

$ flatpak update ''name''

==== systemd による自動アップデート ====

システムのランタイムやアプリケーションを自動的に更新するには、以下のファイルを作成します。

{{hc|/etc/systemd/system/flatpak-update.service|2=
[Unit]
Description=Update Flatpak
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
ExecStart=/usr/bin/flatpak update --noninteractive --assumeyes

AmbientCapabilities=
CapabilityBoundingSet=CAP_SYS_ADMIN CAP_NET_ADMIN
DevicePolicy=closed
InaccessibleDirectories=/home
LockPersonality=true
MemoryDenyWriteExecute=true
NoNewPrivileges=true
PrivateDevices=true
PrivateIPC=true
PrivateTmp=true
PrivateUsers=true
ProcSubset=all
ProtectClock=true
ProtectControlGroups=true
ProtectHostname=true
ProtectKernelLogs=true
ProtectKernelModules=true
ProtectKernelTunables=true
ProtectProc=invisible
ProtectSystem=strict
ReadOnlyDirectories=/
ReadWriteDirectories=/var/lib/flatpak/
ReadWriteDirectories=/root/.local/share/flatpak/
RemoveIPC=true
RestrictAddressFamilies=AF_INET AF_INET6 AF_NETLINK AF_UNIX
RestrictRealtime=true
RestrictSUIDSGID=true
SystemCallArchitectures=native
SystemCallFilter=~@clock
SystemCallFilter=~@debug
SystemCallFilter=~@module
SystemCallFilter=~@raw-io
SystemCallFilter=~@reboot
SystemCallFilter=~@swap
SystemCallFilter=~@cpu-emulation
SystemCallFilter=~@obsolete
UMask=0077

[Install]
WantedBy=multi-user.target
}}

{{hc|/etc/systemd/system/flatpak-update.timer|2=
[Unit]
Description=Update Flatpak

[Timer]
OnBootSec=2m
OnActiveSec=2m
OnUnitInactiveSec=24h
OnUnitActiveSec=24h
AccuracySec=1h
RandomizedDelaySec=10m

[Install]
WantedBy=timers.target
}}

systemdのタイマーを有効にするために、実行します。

$ systemctl enable --now flatpak-update.timer

=== ランタイムやアプリケーションのアンインストール ===

''name'' という名前のランタイムあるいはアプリケーションをアンインストールするには次を実行:

$ flatpak uninstall ''name''

{{Tip|{{ic|flatpak uninstall --unused}} とすると、どのアプリケーションやランタイムでも使用されていない "refs" をアンインストールできます。}}

=== ランタイムまたはアプリケーションをダウングレードする ===

ランタイムやアプリケーションをダウングレードするには、まず、関連するコミット ID を探します。

$ flatpak remote-info --log ''remote'' ''name''

ここで、''remote'' はリポジトリ (flathub など)、''name'' はアプリケーションまたはランタイムの名前です。そして、コミットをデプロイします。

$ flatpak update --commit=''commit'' ''name''

ここで、''commit'' は希望するバージョンのコミット、 ``name`` は前回と同じです。

この手順は、パッケージを最新版でない希望のバージョンに選択的にアップグレードするのにも使えます。

このパッケージのアップデートを {{ic|flatpak update}} から除外するには、[[Flatpak#ランタイムまたはアプリケーションの更新を防止する|ランタイムまたはアプリケーションの更新を防止する]] を参照してください。

=== ランタイムまたはアプリケーションの更新を防止する ===

ランタイムまたはアプリケーションへの自動および手動更新を防止するには、{{ic|flatpak mask}} コマンドを使用します。

$ flatpak mask ''name''

これにより、選択的なアップグレードとダウングレードも防止されます。

マスクを元に戻し、更新を再度有効にするには、{{ic|flatpak mask --remove}} を使用します。

$ flatpak mask --remove ''name''

=== Flatpak の .desktop ファイルをメニューに追加 ===

Flatpak ではウィンドウマネージャが XDG_DATA_DIRS 環境変数を参照してアプリケーションを見つけるようになっています。セッションを再起動する必要があったり、ランチャーによっては環境変数がサポートされていない場合があります。スキャンされるディレクトリのリストを編集出来る場合、以下を追加してください:

~/.local/share/flatpak/exports/share/applications
/var/lib/flatpak/exports/share/applications

上記の設定で Awesome から Flatpak アプリが起動できるようになります。

=== アプリケーションのサンドボックス権限を表示する ===

Flatpak のアプリケーションには、あらかじめサンドボックスのルールが設定されており、アプリケーションがアクセスできるリソースやファイルシステムのパスが定義されています。
特定のアプリケーションのアクセス権を表示するには、次のようにします。
$ flatpak info --show-permissions ''name''
サンドボックスのパーミッション名のリファレンスは、[https://docs.flatpak.org/en/latest/sandbox-permissions-reference.html オフィシャル flatpak ドキュメント] にあります。

=== サンドボックスでのアプリケーションの権限を上書き ===
既定のアプリケーションの権限が寛容すぎたり厳しすぎる場合は、{{ic|flatpak override}} コマンドを利用して権限を書き換えられます。
例:
flatpak override --nofilesystem=home ''name''
これにより、アプリケーションがホームディレクトリへアクセスできなくなります。

デバイス、ファイルシステム、ソケットといった権限の種別ごとに、コマンドラインオプションで特定の権限を許可や拒否することができます。例えば、{{ic|1=--device=''device_name''}} とすると特定のデバイスへのアクセスを許可し、一方 {{ic|1=--nodevice=''device_name''}} とすると特定のデバイスへのアクセス権限を拒否します。

すべての設定については、マニュアルページを参照してください: {{man|1|flatpak-override}}

次のコマンドを実行すると、上書きした設定をリセットし既定の権限に戻せます:
$ flatpak override --reset ''name''

== カスタムベースランタイムの作成 ==

{{Warning|あなたのソフトウェアを Flatpak として公開したい場合、Arch ベースのランタイムを使うことは相応しくありません。そのような場合は [http://docs.flatpak.org 公式ドキュメント] に従って [http://flatpak.org/runtimes.html 共通ランタイム] を使用して Flatpak エコシステムに適合させると良いでしょう。}}

{{Note|
* アプリやランタイムを作成するときはソフトウェアはサンドボックス化されないため、信用できないソフトウェアをビルドするときは普段使いのユーザーアカウントは使わないことを推奨します。
* バンドルを配布する場合、バンドルしたソフトウェアのソースコードを要求に応じて提供する法的な義務を負います。[[ABS]] を使ってソースからパッケージをビルドすることもできます。}}

pacman を使うことで Flatpak 用に Arch ベースのカスタムランタイムやベース SDK を作成することができます。カスタムランタイムを使用してアプリケーションをビルドしたりパッケージ化することが可能です。デフォルトの {{ic|org.freedesktop.BasePlatform}} や {{ic|org.freedesktop.BaseSdk}} ランタイムを使用する代わりとなります。

{{Pkg|flatpak}} だけでなく、{{Pkg|fakeroot}} のインストールが必要です。また、pacman フックを使うには {{Pkg|fakechroot}} も必要です。

まずは、ランタイムやアプリケーションをビルドするためのディレクトリを作成してください:

$ mkdir ''myflatpakbuilddir''
$ cd ''myflatpakbuilddir''

次にランタイムベースプラットフォームをビルドするためのディレクトリを用意します。シンボリックリンクを作成して Arch からデフォルトの {{ic|/usr/share}} などにアクセスできるようにしてください:

$ mkdir -p ''myruntime''/files/var/lib/pacman
$ touch ''myruntime''/files/.ref
$ ln -s /usr/usr/share ''myruntime''/files/share
$ ln -s /usr/usr/include ''myruntime''/files/include
$ ln -s /usr/usr/local ''myruntime''/files/local

Arch ランタイムから OS のフォントを利用できるようにするには:

$ mkdir -p ''myruntime''/files/usr/share/fonts
$ ln -s /run/host/fonts ''myruntime''/files/usr/share/fonts/flatpakhostfonts

ランタイムにパッケージをインストールする前に {{ic|pacman.conf}} を編集する必要があります。{{ic|/etc/pacman.conf}} をビルドディレクトリにコピーして以下の変更を行ってください:

* {{ic|CheckSpace}} オプションを削除して pacman によってルートファイルシステムに関するエラーが表示されないようにしてください。
* 不必要なカスタムリポジトリを削除してください。必要なのは {{ic|IgnorePkg}}, {{ic|IgnoreGroup}}, {{ic|NoUpgrade}}, {{ic|NoExtract}} の設定だけです。

それからランタイムにパッケージをインストールします:

$ fakechroot fakeroot pacman -Syu --root ''myruntime''/files --dbpath ''myruntime''/files/var/lib/pacman --config pacman.conf base
$ mv pacman.conf ''myruntime''/files/etc/pacman.conf

{{ic|''myruntime''/files/etc/locale.gen}} を編集して使用する[[ロケール]]を設定してください。その後ランタイムのロケールを再生成:

$ fakechroot chroot ''myruntime''/files locale-gen

パッケージをビルドしたり pacman を実行するのに必要なアプリケーションを追加することでベースランタイムからベース SDK を作成できます:

$ cp -r ''myruntime'' mysdk
$ fakechroot fakeroot pacman -S --root mysdk/files --dbpath mysdk/files/var/lib/pacman --config mysdk/files/etc/pacman.conf base-devel fakeroot fakechroot --needed

ランタイムと SDK についてのメタデータを追加:

{{hc|''myruntime''/metadata|2=
[Runtime]
name=org.mydomain.BasePlatform
runtime=org.mydomain.BasePlatform/x86_64/2016-06-26
sdk=org.mydomain.BaseSdk/x86_64/2016-06-26
}}

{{hc|mysdk/metadata|2=
[Runtime]
name=org.mydomain.BaseSdk
runtime=org.mydomain.BasePlatform/x86_64/2016-06-26
sdk=org.mydomain.BaseSdk/x86_64/2016-06-26
}}

カレントディレクトリのローカルリポジトリにベースランタイムと SDK を追加してください。“My Arch base runtime” や “My Arch base SDK” などの適当なコミットメッセージを使用すると良いでしょう。

$ ostree init --mode archive-z2 --repo=.
$ EDITOR="nano -w" ostree commit -b runtime/org.mydomain.BasePlatform/x86_64/2016-06-26 --tree=dir=''myruntime''
$ EDITOR="nano -w" ostree commit -b runtime/org.mydomain.BaseSdk/x86_64/2016-06-26 --tree=dir=mysdk
$ ostree summary -u

ランタイムと SDK をインストール:

$ flatpak remote-add --user --no-gpg-verify myarchos file://$(pwd)
$ flatpak install --user myarchos org.mydomain.BasePlatform 2016-06-26
$ flatpak install --user myarchos org.mydomain.BaseSdk 2016-06-26

=== pacman でアプリを作成 ===

[http://flatpak.org/developer.html 通常の方法] でアプリケーションをビルドする代わりに、pacman を使って通常の Arch パッケージのコンテナを作成することができます。アプリを作成するとき {{ic|/usr}} は読み込み専用であるため、アプリをビルドするときに Arch のパッケージを使うことはできません。pacman でアプリを作成する場合:

* pacman を使って依存パッケージを全て含んだランタイムを作成する。
* [http://flatpak.org/developer.html 通常の方法] でアプリをコンパイルするか、{{ic|configure}} スクリプトで {{ic|1=--prefix=/app}} を使用するように Flatpak 向けにカスタマイズした [[PKGBUILD]] を使う。

あるいは:
* pacman を使って pacman でインストールしたアプリを含むランタイムを作成する
* アプリを起動するためのダミーアプリを作成する。

後者の場合、まずは以下のように pacman を使ってランタイムを作成します (例として {{Pkg|gedit}} をコンテナ化)。ランタイムは pacman を使って初期化・準備します。

$ flatpak build-init -w geditruntime org.mydomain.geditruntime org.mydomain.BaseSdk org.mydomain.BasePlatform 2016-06-26
$ flatpak build geditruntime sed -i "s/^#Server/Server/g" /etc/pacman.d/mirrorlist
$ flatpak build geditruntime ln -s /usr/var/lib /var/lib
$ flatpak build geditruntime fakeroot pacman-key --init
$ flatpak build geditruntime fakeroot pacman-key --populate archlinux

pacman からホストのネットワーク接続が使えるようにする必要があります:

$ flatpak build --share=network geditruntime fakechroot fakeroot pacman --root /usr -S gedit

ランタイムを完成させる前にインストールをテストすることができます:

$ flatpak build --socket=x11 geditruntime gedit

ランタイムをビルドを完了して新しいローカルリポジトリにエクスポートしてください。pacman の GnuPG 鍵のパーミッションが干渉する可能性があるため先に削除する必要があります。

$ flatpak build geditruntime rm -r /etc/pacman.d/gnupg
$ flatpak build-finish geditruntime
$ sed -i "s/\[Application\]/\[Runtime\]/;s/runtime=org.mydomain.BasePlatform/runtime=org.mydomain.geditruntime/" geditruntime/metadata
$ flatpak build-export -r geditrepo geditruntime

それからダミーアプリを作成:

$ flatpak build-init geditapp org.gnome.gedit org.mydomain.BaseSdk org.mydomain.geditruntime

ビルドを完了するときに指定するオプションで、サンドボックス化されたときのアプリのアクセス権限を調整することができます。利用可能なオプションは [[#参照|Flatpak のドキュメント]]や [https://gitlab.gnome.org/GNOME/gnome-apps-nightly/tree/master GNOME のマニフェストファイル] を見てください。また、ビルドが完了した後、エクスポートする前に必要に応じて {{ic|geditapp/metadata}} を編集する方法もあります。メタデータファイルが完成したら、リポジトリにアプリをエクスポートしてください。

$ flatpak build-finish geditapp --socket=x11 ''[possibly other options]'' --command=gedit
$ flatpak build-export geditrepo geditapp

ランタイムを使ってアプリをインストール:

$ flatpak --user remote-add --no-gpg-verify geditrepo geditrepo
$ flatpak install --user geditrepo org.mydomain.geditruntime
$ flatpak install --user geditrepo org.gnome.gedit
$ flatpak run org.gnome.gedit

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

=== Flatpak は Linux で強化されたカーネルでは実行されません ===

{{Pkg|linux-hardened}} カーネルは {{ic|kernel.unprivileged_userns_clone}} を {{ic|0}} に設定しており、特権ユーザのみが新しいユーザ名前空間を作成することができるようになっているためです。

これを修正する一つの方法は、{{pkg|bubblewrap-suid}} を [[インストール]] することです.このパッケージは {{man|1|bwrap}} の {{ic|setuid}} ビットを有効にして、bubblewrap が自分自身を昇格させて新しい名前空間を作成できるようにしたバージョンを提供します。

また、{{man|8|sysctl}} を使って {{ic|kernel.unprivileged_userns_clone}} を {{ic|1}} に設定して、非特権ユーザーが新しいユーザーネームスペースを作成できるようにすることも可能です。

# sysctl kernel.unprivileged_userns_clone=1

{{Warning|このカーネルパラメータ値を使用すると、セキュリティ上マイナスの影響があります。詳しくは [[セキュリティ#アプリケーションのサンドボックス化]] をご覧ください。}}

この変更を再起動後も維持するには、設定ファイルを {{man|5|sysctl.d}} に追加します。

{{hc|head=/etc/sysctl.d/flatpak.conf|
output=kernel.unprivileged_userns_clone=1
}}

詳細については、[[Bubblewrap#インストール]] の注記を参照してください。

=== xdg-desktop-portal が起動しない ===

[[xinit#xinitrc|手動で設定された実行コマンド]] で X を起動する場合、`xinitrc` リファレンスのすべての重要な構成要素を含んでいることを確認してください。そのうちの1つは、D-Bus セッションサービスに使用される環境のアップデートを実行するスクリプトをソースとしています。

systemctl --user import-environment DISPLAY XAUTHORITY
if command -v dbus-update-activation-environment >/dev/null 2>&1; then
dbus-update-activation-environment DISPLAY XAUTHORITY
fi

=== Flatpak アプリケーションがデフォルトのシステムテーマを選択しない ===

flatpak のドキュメントに記載されているように、flatpak アプリにシステムテーマを適用する理想的な方法はありません。
[https://docs.flatpak.org/en/latest/desktop-integration.html?highlight=theme#applying-themes] [https://docs.flatpak.org/en/latest/desktop-integration.html?highlight=theme#theming] しかし [https://web.archive.org/web/20230106121332/https://itsfoss.com/flatpak-app-apply-theme/ there is a workaround] flatpak アプリにテーマを適用するために使用できます。

=== Firefox でローカル HTML ページを開くと "ファイルが見つかりません" というエラーが表示される ===

Flatpak 版 Firefox のデフォルトでは、ローカルの HTML を開くと "File not found" エラーページが表示されます。これは、[[Flatpak#サンドボックスでのアプリケーションの権限を上書き|パーミッション]] が、ファイルを含むフォルダーにアクセスするためにアプリに付与されなければならないからです。

ただし、ホームフォルダ全体へのアクセス許可を与えると、Firefox は {{ic|~/.mozilla}} に既存のプロファイルをチェックし、サンドボックス化されたフォルダ {{ic|~/.var/app/org.mozilla.firefox/cache/mozilla/}} から以前に使用したプロファイルの代わりにロードすることに注意ください。(Flatseal などで) パーミッションを変更した後に前のセッションのタブや閲覧履歴がなくなった場合は、{{ic|~/.mozilla}} へのアクセスを除外するようにパーミッションを変更するか、{{ic|~/.var/app/org.mozilla.firefox/cache/mozilla/}} から {{ic|~/.mozilla}} へのプロファイルコピーを検討して下さい。

=== wlroots ベースのコンポジターでリンクを開くことができない ===

URI を開こうとする Flatpak アプリケーションは {{ic|org.freedesktop.portal.OpenURI.OpenURI}} インターフェースを使用します。[[PipeWire#WebRTC 画面共有|xdg-desktop-portal]] で公開されている [[D-Bus]] インターフェースを使用します。[https://github.com/emersion/xdg-desktop-portal-wlr/issues/42 xdg-desktop-portal-wlr バックエンド] はこの呼び出しをサポートしていないので、例えば {{pkg|xdg-desktop-portal-gtk}} のように、隙間を埋めるための追加のバックエンドが必要になります。

== 参照 ==

* [http://flatpak.org 公式ウェブサイト]
* [https://docs.flatpak.org/en/latest/index.html ドキュメント]
* [https://github.com/flatpak/flatpak/wiki 公式 Github wiki]
* [[Wikipedia:Flatpak]]
* [https://wiki.gnome.org/Projects/SandboxedApps Gnome SandboxedApps]
* [https://community.kde.org/Guidelines_and_HOWTOs/Flatpak KDE Testing Runtime and Applications]

PipeWire

2023-05-04T02:53:08Z

Shota: /* セッションマネージャー */ WirePlumber を推奨とする記述を英語版から反映

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[[pt:PipeWire]]
[[ru:PipeWire]]
{{Related articles start}}
{{Related|PipeWire/サンプル}}
{{Related|WirePlumber}}
{{Related articles end}}
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、[[PulseAudio]]、[[JACK]]、[[ALSA]]、[[GStreamer]] をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリから {{Pkg|pipewire}} パッケージを [[インストール]] してください。[[multilib]] に対応した {{Pkg|lib32-pipewire}} もあります。

Pipewire は [[systemd/ユーザー]] を使ってサーバーを管理し、ソケットを自動で起動します。

オプションとして、{{Pkg|pipewire-docs}} をインストールすると、ドキュメントを確認することができます。

Pipewire は、他のオーディオサーバーと置き換えることができます。詳しくは [[PipeWire#オーディオ|オーディオ]] を参照してください。

=== セッションマネージャー ===

[[JACK]] と同様、PipeWire は内部で接続ロジックを実装していません。新しいストリームを監視し、適切な出力デバイスやアプリケーションに接続する負担は、セッションマネージャーとして知られる外部のコンポーネントに任されています。

現在、推奨のセッションマネージャーは1つだけで次になります:
* {{App|[[WirePlumber]]| 強力なマネージャであり、現在の推奨品です。モジュール設計に基づいており、実際の管理機能を実装する Lua プラグインがあります。|https://pipewire.pages.freedesktop.org/wireplumber/|{{Pkg|wireplumber}}}}

次のセッションマネージャーはサポート外になっており WirePlumber を推奨しています:

* {{App|PipeWire Media Session|いくつかの基本的なデスクトップのユースケースに対応した非常にシンプルなセッションマネージャです。これは主にテスト用と新しいセッションマネージャを構築するための例として実装されました。|https://gitlab.freedesktop.org/pipewire/media-session|{{Pkg|pipewire-media-session}}}}

PipeWire のインストール時に、どちらかを選ぶように指示されます。後で適切なパッケージをインストールすることで、もう一方のオプションと衝突しますが、置き換えることで切り替えが可能です。

=== GUI ===

* {{App|Helvum|PipeWire 用の GTK 製のパッチベイ。 JACK のツールの catia にインスパイアされた。|https://gitlab.freedesktop.org/ryuukyu/helvum|{{pkg|helvum}}}}
* {{App|qpwgraph|Qt-based Graph/Patchbay for PipeWire, inspired by the JACK tool QjackCtl.|https://gitlab.freedesktop.org/rncbc/qpwgraph|{{Pkg|qpwgraph}}}}

== 設定 ==

PipeWire パッケージは、初期設定ファイルを{{ic|/usr/share/pipewire}} に用意しています。パッケージのアップデートで変更内容が上書きされてしまうので、これらのファイルを直接編集するべきではありません。PipeWire を設定するには、ファイルを {{ic|/usr/share/pipewire}} からシステム全体の代替場所 {{ic|/etc/pipewire}} か、ユーザーの場所 {{ic|~/.config/pipewire}} にコピーしてください。[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PipeWire#configuration-file-pipewireconf]

=== プロファイル ===

Pipewire では、PulseAudio のプロファイルに加えて、pavucontrol で選択可能なカスタムの ''Pro Audio'' プロファイルが提供されています。その効果はこちらで解説しています：https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/FAQ#what-is-the-pro-audio-profile

== 使用方法 ==

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

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

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。再起動するか、ログインし直すか、{{ic|systemctl start --user pipewire-pulse.service}} を実行すると有効化されます。

パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|1=$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire 0.3.16)
...
}}

システム起動時に PipeWire が正しく機能しない場合は、[[systemd/ユーザー|ユーザーサービス]] {{ic|pipewire-pulse.service}} と {{ic|pipewire.service}} と {{ic|pipewire-media-session.service}} が起動して実行されているか確認します。{{ic|pipewire-pulse.service}} と {{ic|pipewire-pulse.socket}} は root で実行することを制限するような {{ic|ConditionUser}} を設定していることに注意してください。

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

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

===== プロファイルの自動選択機能 =====

{{Pkg|pipewire-media-session}} は、入力ストリームが必要なときに、HSP/HFP と A2DP プロファイルを自動的に切り替えます。これを有効にするには、{{ic|bluez5.autoswitch-profile}} プロパティを {{ic|true}} にセットしてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf (or ~/.config/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
{
...
actions = {
update-props = {
...
bluez5.autoswitch-profile = true
...
}}

これらの機能は、[[WirePlumber]] ではまだ [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/90 実装中] です。

==== PipeWire ネイティブパッチセット ====

グラフィカルな視覚化と接続の作成のための Helvum はありますが、それ以外はまだ入っていません。以下は、ワイヤセットの保存、ワイヤセットの読み込み、すべての接続の解除を行う bash スクリプトです。保存と読み込みには、コマンドラインパラメータでファイル名を指定します。

{{hc|pw-savewires|<nowiki>
#!/bin/bash

if [[ "$#" -ne 1 ]]; then
echo
echo 'usage: pw-savewires filename'
echo
exit 0
fi

rm $1 &> /dev/null
while IFS= read -r line; do
link_on=`echo $line | cut -f 4 -d '"'`
link_op=`echo $line | cut -f 6 -d '"'`
link_in=`echo $line | cut -f 8 -d '"'`
link_ip=`echo $line | cut -f 10 -d '"'`
echo "Saving: " "'"$link_on:$link_op"','"$link_in:$link_ip"'"
echo "'"$link_on:$link_op"','"$link_in:$link_ip"'" >> $1
done < <(pw-cli dump short link)
</nowiki>}}

{{hc|pw-loadwires|<nowiki>
#!/bin/python

import sys
import csv
import os

if len(sys.argv) < 2:
print('\n usage: pw-loadwires filename\n')
quit()

with open(sys.argv[1], newline='') as csvfile:
pwwreader = csv.reader(csvfile, delimiter=',', quotechar='"')
for row in pwwreader:
print('Loading: ' + row[0] + ' --> ' + row[1])
process = os.popen('pw-link ' + row[0] + ' ' + row[1])
</nowiki>}}

{{hc|pw-dewire|<nowiki>
#!/bin/bash
while read -r line; do
echo 'Dewiring: ' $line '...'
pw-link -d $line
done < <(pw-cli dump short link {{!}} grep -Eo '^[0-9]+')
</nowiki>}}

==== ネットワーク上のコンピューターとオーディオ機器を共有する ====

PipeWire 自体はネットワーク透過型ではありませんが、そのパルス実装は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-PulseAudio#network-support ネットワークストリーミング] をサポートしています。ネットワーク上のコンピュータ間でオーディオを共有する簡単な方法は、[[Avahi]] デーモンを使って検出することです。
オーディオを共有するすべてのコンピュータで {{ic|avahi-daemon.service}} が実行されていることを確認してください。

ローカルのオーディオデバイスを共有するために、ホスト上で適切なモジュールをロードしてください。

pactl load-module module-native-protocol-tcp listen=''192.168.1.10'' # Use the local IP address
pactl load-module module-zeroconf-publish

次に、クライアントにディスカバリモジュールをロードします。

pactl load-module module-zeroconf-discover

===== AirPlay レシーバーにオーディオをストリーミングする =====

[[Wikipedia:ja:AirPlay#Receivers|AirPlay Receiver]] を装ったデバイスにオーディオをストリーミングすることが可能です。この機能を有効にするには、[https://docs.pipewire.org/page_module_raop_discover.html RAOP Discover モジュール] をロードします。

$ pactl load-module module-raop-discover

専用の設定ファイルを作成することで、このモジュールを自動的にロードすることもできます。

{{hc|/etc/pipewire/pipewire.conf.d/raop-discover.conf (or ~/.config/pipewire/pipewire.conf.d/raop-discover.conf)|2=
context.modules = [
{
name = libpipewire-module-raop-discover
args = { }
}
]
}}

一部のスピーカーの AirPlay 実装 (Sonos AirPlay 2 スピーカーなど) では、ソースデバイスで着信 UDP トラフィック用にポート 6001 および 6002 を開く必要がある場合があります。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

==== PipeWire シンクとして ALSA dmix デバイスを使用する ====

PipeWire サーバー(またはユーザーごとに複数) を [[Advanced Linux Sound Architecture#Dmix|ALSA dmix デバイス]] を介して ALSA に出力することが可能です。これにより、ALSA を主要な音声出力システムとして使用しながら、Bluetooth ヘッドフォンなどの ALSA 以外のデバイスを使用することができるようになります。

===== ALSA dmix セットアップ =====

{{ic|PCH}} と {{ic|HDMI}} の 2 枚のカードがあるとします。

{{hc|/proc/asound/cards|
0 [PCH ]: HDA-Intel - HDA Intel PCH
HDA Intel PCH at 0xdff40000 irq 146
1 [HDMI ]: HDA-Intel - HDA ATI HDMI
HDA ATI HDMI at 0xdfe60000 irq 147
}}

PCM は次のようになります。

{{hc|/proc/asound/pcm|
00-00: ALC1220 Analog : ALC1220 Analog : playback 1 : capture 1
00-02: ALC1220 Alt Analog : ALC1220 Alt Analog : capture 1
01-03: HDMI 0 : HDMI 0 : playback 1
01-07: HDMI 1 : HDMI 1 : playback 1
01-08: HDMI 2 : HDMI 2 : playback 1
01-09: HDMI 3 : HDMI 3 : playback 1
01-10: HDMI 4 : HDMI 4 : playback 1
01-11: HDMI 5 : HDMI 5 : playback 1
}}

ALSA 設定が次のようになっているとします。

{{hc|/etc/asound.conf|
ctl.!default {
type hw
card PCH
}

pcm.!default {
type plug
slave.pcm "'''dmix:PCH,0'''"
}

pcm.dhdmi {
type plug
slave.pcm "'''dmix:HDMI,9'''"
}
}}

この特定の例では、dmix デバイスは {{ic|dmix:PCH,0}} と {{ic|dmix:HDMI,9}} になります。

===== PipeWire dmix セットアップ =====

まず、{{ic|alsa_monitor.enable()}} をコメントアウトして、{{ic|wireplumber}} によるハードウェア ALSA デバイスの監視と追加を停止します。

{{hc|/etc/wireplumber/main.lua.d/90-enable-all.lua (or ~/.config/wireplumber/main.lua.d/90-enable-all.lua)|
...
-- Load devices
'''-- alsa_monitor.enable()'''
v4l2_monitor.enable()
libcamera_monitor.enable()
...
}}

ここで、dmix デバイスを使用するように {{ic|pipewire}} を設定します。デフォルトの設定ファイル ({{ic|/usr/share/pipewire/pipewire.conf}}) には [https://gitlab.freedesktop.org/pipewire/pipewire/-/blob/0.3.59/src/daemon /pipewire.conf.in#L219-239 コメントアウトされた例] をベースとして使用できます。

独自の要素を {{ic|context.objects}} 配列に追加します。

{{hc|/etc/pipewire/pipewire.conf.d/alsa-dmix.conf (or ~/.config/pipewire/pipewire.conf.d/alsa-dmix.conf)|output=
context.objects = [
# We do not start with dmix, but with an input device.
# Do not forget to add an input device.
# On a friend's Laptop, I saw Zoom having a nervous
# breakdown and endlessly crying because no input device
# was configured! You have been warned.
{ factory = adapter
args = {
factory.name = api.alsa.pcm.source
node.name = "alsa-mic-internal" # name of pulse device (mpv)
node.description = "Mic Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Source"
api.alsa.path = "'''hw:PCH,0'''"
}
}
# Okay, now we add our dmix PCMs
{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-internal" # name of pulse device (mpv)
node.description = "PCM Internal" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
api.alsa.path = "'''dmix:PCH,0'''"
}
}

{ factory = adapter
args = {
factory.name = api.alsa.pcm.sink # sink for dmix
node.name = "alsa-dmix-hdmi" # name of pulse device (mpv)
node.description = "PCM HDMI" # name of pulse device (pavucontrol)
media.class = "Audio/Sink" # Sink for dmix
# remember this is a non-default dmix from /etc/asound.conf
api.alsa.path = "'''dmix:HDMI,9'''"
}
}
]
}}

ユーザー (非 root) として、{{ic|wpctl status}} の出力を確認し、{{ic|wpctl set-default ''ID''}} でデフォルトの入力(ソース) と出力 (シンク) のデバイスを好みのものに設定します。{ic|''ID''}} はシンク/ソース名の前の数字です。

これで、構成を完全にテストすることができます。

==== デバイスプロファイルの切り替え ====

{{ic|snd_hda_intel}} などの一部のハードウェアオーディオデバイスは、デバイスが実行されているプロファイルによって機能が異なります。{{ic|snd_hda_intel}} の場合、HDMI とアナログ出力用に個別のプロファイルがあります。

WirePlumber で HDMI に切り替える:

{{hc|
$ wpctl set-profile <device-ID> 3
$ wpctl status
|output=
...
├─ Sinks:
│ * 53. Built-in Audio Digital Stereo (HDMI) [vol: 1.00]
...
}}

WirePlumber でアナログに切り替える:

{{hc|
$ wpctl set-profile <device-ID> 1
$ wpctl status
|output=
...
├─ Sinks:
│ * 51. Built-in Audio Analog Stereo [vol: 0.60]
...
}}

=== WebRTC 画面共有 ===

ほとんどのアプリケーションは、例えばウェブブラウザで WebRTC を使うとき (例: Google Meet) などに、デスクトップ (あるいは個々のアプリケーション) をキャプチャするために X11 に依存していました。Wayland では、セキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して、Wayland 上のコンテンツを共有できます。

これには、{{Pkg|xdg-desktop-portal}} に加えてそのバックエンドのうち1つを[https://jgrulich.cz/2018/07/04/how-to-enable-and-use-screen-sharing-on-wayland インストールする]必要があります。利用可能なバックエンドは:

* {{Pkg|xdg-desktop-portal-gnome}}: [[GNOME]] 用。これは {{Pkg|xdg-desktop-portal-gtk}} に依存しています。
* {{Pkg|xdg-desktop-portal-gtk}}: [[GTK]] アプリケーション用。
* {{Pkg|xdg-desktop-portal-kde}}: [[KDE]] 用。
* {{Pkg|xdg-desktop-portal-lxqt}}: [[LXQt]] 用。
* {{Pkg|xdg-desktop-portal-wlr}}: wlroots ベースの Wayland コンポジタ用 (例: [[Sway]]、{{AUR|dwl}})。

バックエンドをインストールした後、{{ic|xdg-desktop-portal.service}} [[ユーザーユニット]]を[[再起動]]する必要があります。これは、まだサービスが開始されていない場合、サービスを開始します。

{{Tip|WebRTC 画面共有が機能しているかどうか、[https://mozilla.github.io/webrtc-landing/gum_test.html Mozilla の GetUserMedia WebRTX テストページ]でテストしましょう。}}

{{Note|1={{Pkg|xdg-desktop-portal}} 1.10.0 では、D-Bus インターフェースの仕様と実装の不一致が修正されました。[https://github.com/flatpak/xdg-desktop-portal/pull/609] そのため、一部のクライアントは xdg-desktop-portal 1.10.0 またはそれ以降で動作しないかもしれません。}}

Firefox (バージョン84以降) と Chromium (バージョン110以降) はデフォルトでこの方法をサポートしていますが、Chromium の古いバージョン (バージョン73以降) では、URL {{ic|chrome://flags/#enable-webrtc-pipewire-capturer}} で対応する (実験的) フラグを設定するか、CLI 引数 {{ic|1=--enable-features=WebRTCPipeWireCapturer}} を用いて、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWire サポート]を有効化する必要があります。

{{Pkg|obs-studio}} (バージョン27以降) は、新しい PipeWire キャプチャソースを使用することにより、この方法をサポートしています。

{{Accuracy|[https://github.com/flatpak/xdg-desktop-portal-gtk/pull/225 このプルリクエスト]がマージされたので、特定のアプリ/ウィンドウの共有に関する以下の注意書きは、{{Pkg|xdg-desktop-portal-gtk}} に対してはもはや正しくないかもしれません。この議論を追跡するチケットも[https://github.com/flatpak/xdg-desktop-portal-gtk/issues/204]で参照してください。}}

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows][https://github.com/KDE/xdg-desktop-portal-kde/blob/master/TODO]

==== xdg-desktop-portal-wlr ====

{{ic|xdg-desktop-portal-wlr}} を機能させるには、環境変数 {{ic|1=XDG_CURRENT_DESKTOP}} と {{ic|1=WAYLAND_DISPLAY}} を [[Systemd/ユーザー#環境変数|systemd ユーザセッション]]で設定しなければなりません。{{ic|1=XDG_CURRENT_DESKTOP}} は使用中のコンポジタの名前に設定しなければなりません (例: {{ic|1=XDG_CURRENT_DESKTOP=sway}})。{{ic|1=WAYLAND_DISPLAY}} は、コンポジタによって自動的に設定されます。

{{ic|systemctl --user show-environment}} を実行して、これらの変数が設定されているかどうかを確認してください。設定されていない場合、以下のコマンドをコンポジタの起動後に実行して (例えば、以下のコマンドをコンポジタの設定ファイルにインクルードして)、これらの環境変数を systemd ユーザセッションと dbus にインポートしてください。

$ systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
$ dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=''compositor_name''

{{Note|[[Sway]] は、これを自動的に行うドロップインファイルを提供します。[[Sway#設定]] を参照してください。}}

詳細は [https://github.com/emersion/xdg-desktop-portal-wlr#running] と [https://github.com/emersion/xdg-desktop-portal-wlr/wiki] を参照してください。

{{Tip|2つ以上のモニタを持っている場合は、{{ic|xdg-desktop-portal-wlr}} で共有するモニタを選択するために、{{pkg|slurp}} をインストールし、以下の設定を追加してください ({{man|5|xdg-desktop-portal-wlr|SCREENCAST OPTIONS}} を参照):

{{hc|~/.config/xdg-desktop-portal-wlr/config|2=
chooser_type = simple
chooser_cmd = slurp -f %o -ro
}}

画面共有がリクエストされると、{{ic|slurp}} がクロスヘアのカーソルを表示し、共有したい画面の選択を求めてきます。選択すると、{{ic|xdg-desktop-portal-wlr}} はその画面の共有を許可します。
}}

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインを使用して設定なしで動作するはずです ([[GStreamer#PipeWire]]を参照してください)。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

== 音声のポストプロセッシング ==

=== Pipewire モジュールフィルターチェーン ===

Pipewire には {{ic|[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Filter-Chain filter-chain]}} という内部モジュールがあり、音声の入出力を処理するノードを作成することができます。参照してください。
/usr/share/pipewire/filter-chain/ を参照してください。
イコライザー、バーチャルサラウンドサウンド、LADSPA プラグイン、チャンネルミキシングなどの例を紹介します。

==== システム全体のパラメトリックイコライゼーション ====

設定ファイルを {{ic|.config}} フォルダにコピーします。
mkdir -p ~/.config/pipewire/pipewire.conf.d
cp /usr/share/pipewire/filter-chain/sink-eq6.conf ~/.config/pipewire/pipewire.conf.d/
次に、{{ic|sink-eq6.conf}} を編集して、必要なパラメータを組み込みます。ヘッドフォンの場合、これらは [https://old.reddit.com/r/oratory1990/wiki/index Oratory1990 のデータベース] から入手できます。そこにリストされていない場合は、[https://github.com/jaakkopasanen/AutoEq/tree/master/results/ AutoEQ project]

プリアンプが必要な場合は、{{ic|eq_band_1}} を変更して、{{ic|bq_highshelf}} フィルタを周波数 0Hz でマイナスゲイン (-120 〜 +20dB のゲインをサポート) で適用します。
label = bq_highshelf
control = { "Freq" = 0 "Q" = 1.0 "Gain" = -7.5 }

6 バンドを超える場合は、{{ic|nodes}} リストと対応する {{ic|links}} にさらにエントリを追加して、1 つのフィルタ ":Out" を次のフィルタ ":In" に接続します。たとえば、11 に増やします。バンド (プリアンプ + 10):
{ output = "eq_band_6:Out" input = "eq_band_7:In" }
{ output = "eq_band_7:Out" input = "eq_band_8:In" }
{ output = "eq_band_8:Out" input = "eq_band_9:In" }
{ output = "eq_band_9:Out" input = "eq_band_10:In" }
{ output = "eq_band_10:Out" input = "eq_band_11:In" }

Pipewire を再起動し、デフォルトのサウンド出力デバイスとして "Equalizer Sink" を選択します。これは、すべてのアプリケーションに適用されます。

=== EasyEffects ===

EasyEffects (以前は PulseEffects と呼ばれていました) は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/easyeffects GitHub ページ]にエフェクトの一覧があります。

EasyEffects を使用するには、{{pkg|easyeffects}} をインストールします。プリセット設定集については、[https://github.com/wwmm/easyeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

{{Note|PulseEffects の古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

=== NoiseTorch ===

{{aur|noisetorch}} はノイズ抑制に使用できます。ビルド済み ({{aur|noisetorch-bin}}) や開発版 ({{aur|noisetorch-git}}) のパッケージもあります。

起動すると選択したマイクにモジュールを読み込むことができます。声が出力される閾値を調整することができます。実際の声が削除されない最大のレベルに設定するべきです。

=== Noise suppression for voice ===

{{pkg|noise-suppression-for-voice}} をインストールし、以下のいずれかのオプションを使用します:

* 以下の行を {{ic|context.exec}} セクションに追加する:

{{hc|/etc/pipewire/pipewire.conf (or ~/.config/pipewire/pipewire.conf)|output=
...
context.exec = [
...
{ path = "/usr/bin/pipewire" args = "-c /usr/share/pipewire/filter-chain/source-rnnoise.conf" }
...
}}

* https://github.com/werman/noise-suppression-for-voice#pipewire に従う

そして、オーディオ設定でノイズキャンセルソースをデフォルトとして設定します。この機能を使う前に、アプリケーションを再起動する必要があるかもしれません。

=== JamesDSP ===

[https://github.com/Audio4Linux/JDSP4Linux#readme JamesDSP for Linux] ({{AUR|jamesdsp}} として入手可能) は PipeWire と PulseAudio のためのオープンソースのサウンドエフェクトを提供します。LADSPA や Calf などに依存することなく、独自のエフェクトエンジンを使用しています。JamesDSP は当初 Android デバイス用のオーディオエフェクトプロセッサーとして公開されました。

=== LADSPA、LV2、VST プラグイン ===

LADSPA、LV2、VSTのプラグインを使用したい場合は、カスタム PulseAudio null シンクと Carla Jack ホストを利用できます。{{pkg|pipewire-pulse}} と {{pkg|pipewire-jack}} と {{pkg|carla}} をインストールします。はじめに {{ic|default_null_sink}} という名前の PulseAudio の null シンクを作成します。

pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=default_null_sink channel_map=FL,FR

{{ic|pw-jack carla-rack}} で PipeWire を使用する Carla を起動します。''Rack'' タブで使いたいプラグインを全て追加します。プラグインのタイプが ''stereo'' であることを確認してください。適用する順番を変えることができます。EasyEffectsのようにリストの最初のプラグインが最初に入力の音声ストリームを受け取ります。その後 ''Patchbay'' タブに移動し {{ic|default_null_sink}} の L/R monitor を Carla input に接続し、Carla output を出力したいデバイス (スピーカーやイヤホンや HDMI 出力など) の playback に接続します。設定をフォルダに保存します ({{ic|~/Documents/carla_sink_effects.carxp}} など)。

Firefox で動画を見ている時など、アプリケーションが音声を再生している時に効果を試すことができます。2つの方法があります。一つは Carla の ''Patchbay'' タブで Firefox の接続を全て外し {{ic|default_null_sink}} の L/R output に接続する方法です。もう一つは {{pkg|pavucontrol}} を使用し Firefox の音声ストリームを {{ic|default_null_sink}} に変更する方法です (この方法は同じアプリケーションの次回起動時に同じ接続先を使用するはずです)。

これらの設定を起動時に適用するには、まず2つの systemd ユーザーサービスを作成します:

{{hc|~/.config/systemd/user/jack-carla-rack.service|output=
[Unit]
Description=Load Carla Rack JACK host

[Service]
PassEnvironment="PIPEWIRE_LINK_PASSIVE=true"
Type=exec
ExecStart=/usr/bin/pw-jack carla-rack -n

[Install]
WantedBy=default.target
}}
{{hc|~/.config/systemd/user/pulseaudio-null-sink@.service|output=
[Unit]
Description=Load %i Pulseaudio null sink
Before=jack-carla-rack.service
After=pipewire-pulse.service

[Service]
Type=oneshot
ExecStart=/usr/bin/pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=%i channel_map=FL,FR
ExecStop=/usr/bin/pactl unload-module module-null-sink
RemainAfterExit=yes

[Install]
WantedBy=default.target
}}

''jack-carla-rack'' サービスの ''Environment'' を Carla の設定ファイルのフルパスを指定するよう上書きします:

{{hc|~/.config/systemd/user/jack-carla-rack.service.d/override.conf|output=
Environment="CARLA_CONFIG_FILE=/home/username/Documents/carla_sink_effects.carxp"
ExecStart=
ExecStart=/usr/bin/pw-jack carla-rack -n $CARLA_CONFIG_FILE
}}

最後に、作成したサービスを有効化します。''pulseaudio-null-sink'' サービスには {{ic|default_null_sink}} 引数をつけてください:

systemctl --user enable pulseaudio-null-sink@default_null_sink.service
systemctl --user enable jack-carla-rack.service

{{Note|システム設定で {{ic|default_null_sink}} をデフォルトデバイスに設定すると、全てのアプリケーションが {{ic|default_null_sink}} にリダイレクトされ、音量の変更がスピーカーではなく {{ic|default_null_sink}} に対して行われるようになります。スピーカーの音量を変更したい場合は、デフォルトデバイスをスピーカーから変更せずにアプリケーションの出力先を pavucontrol で {{ic|default_null_sink}} に変更してください (PipeWire の互換性レイヤーは次回起動時も出力先を覚えています)。}}

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

=== オーディオ ===

==== PipeWire にマイクが検出されない ====

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{Pkg|alsa-card-profiles}} を使ってデバイスを検出します。これがうまくいかない場合は、{{ic|api.alsa.use-acp}} をオフにするか、オプションで {{ic|api.alsa.use-ucm}} をオンにすることを試してみてください。

{{Pkg|pipewire-media-session}} を使用している場合。
{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf (or ~/.config/pipewire/media-session.d/alsa-monitor.conf)|output=
...
rules = [
{
...
actions = {
update-props = {
...
api.alsa.use-acp = false
...
}}

それ以外の場合は、{{Pkg|wireplumber}} を使用している場合。
{{hc|/etc/wireplumber/main.lua.d/50-alsa-config.lua (or ~/.config/wireplumber/main.lua.d/50-alsa-config.lua)|output=
...
alsa_monitor.rules = {
{
...
apply_properties = {
-- Use ALSA-Card-Profile devices. They use UCM or the profile
-- configuration to configure the device and mixer settings.
-- ["api.alsa.use-acp"] = true,

-- Use UCM instead of profile when available. Can be
-- disabled to skip trying to use the UCM profile.
["api.alsa.use-ucm"] = true,
...
}}

その後、pipewire を再起動し、利用可能なデバイスを確認します。

{{hc| 1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

==== 新しいデバイスを接続したときにサウンドが自動的に切り替わらない ====

新しく接続されたデバイスに自動的に切り替えるには、次のファイルを作成します。:

{{hc|/etc/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf (or ~/.config/pipewire/pipewire-pulse.conf.d/switch-on-connect.conf)|output=
# override for pipewire-pulse.conf file
pulse.cmd = [
{ cmd = "load-module" args = "module-always-sink" flags = [ ] }
{ cmd = "load-module" args = "module-switch-on-connect" }
]
}}

==== サウンドが自動的に Bluetooth ヘッドフォンに切り替わらない ====

{{ic|pactl load-module module-switch-on-connect}} を実行し、ログイン時に自動的にそのコマンドが実行されるようにデスクトップ環境を設定してください。詳しくは [https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/89 wireplumber issue #89] を見てください。

==== Bluetooth デバイスに接続しても音が出ない ====

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

==== 音量が小さい ====

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

==== increasing RLIMIT_MEMLOCK ====

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

==== サンプリングレートを変更する ====

PipeWire のデフォルトでは、グローバルサンプルレートは 48kHz に設定されています。これを変更したい場合(より高い値をサポートする DAC を所有しているなど)、設定ファイル {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} 行を編集することで行うことができます。例えば、192kHz にしたい場合は、{{ic|48000}} を {{ic|1=default.clock.rate = 192000}} にコメントを解除して変更します。

PipeWire は、DAC がサポートする出力サンプルレートを変更することもできます。設定するには、{{ic|1=default.clock.allowed-rates = [ 48000 ]}} という行をコメント解除して設定します。例えば、{{ic|[ 44100 48000 88200 96000 ]}} とします。サンプルレートは、カードがアイドルのときに再生されるオーディオストリームのサンプルレートに従います。

どの出力サンプルレートとサンプルフォーマットが DAC に送られたデータであるかを確認するには(おそらく桁を変更する必要があります)。
cat /proc/asound/card0/pcm0p/sub0/hw_params
どの入力サンプルレートを使用しているかを確認するには、{{ic|pcm0p}} を {{ic|pcm0c}} に変更します。({{ic|c}} は "capture" の略、{{ic|p}} は "playback" の略です).

==== 音質(リサンプリング品質) ====
PulseAudio を {{ic|1=resample-method = speex-float-10}} または {{ic|soxr-vhq}} で使用していた場合、コメントを解除して {{ic|1=resample.XXX}} を変更することを検討するとよいかもしれません。{{ic|1=resample.quality = 4}} を {{ic|10}} または最大値 {{ic|15}} に変更することを検討してください。(存在しない場合は {{ic|/usr/share/pipewire/}} からコピーしてください)。PipeWire の再起動を忘れないでください (sudo なし): {{ic|systemctl --user restart pipewire.service pipewire-pulse.socket}} (設定変更を適用させたい場合は、{{ic|pipewire-pulse.socket}}を絶対に忘れないでください)。

{{ic|10}} と {{ic|15}} では、品質の差はほとんどありませんが、CPU 負荷は2〜3倍になっています。また、{{ic|4}}, {{ic|10}}, {{ic|15}} のレイテンシーの差はまだ誰も調べていません。Ryzen 2600 で 44100→48000Hz で {{ic|1= resample.quality = 15}} にすると {{ic|pipewire}} や {{ic|pipewire-pulse}} プロセスが 1CPUコア4.0% の負荷となる。

リサンプラーの比較はこちら:https://src.infinitewave.ca/(18KHz以上、120dB以上は注意)。speeex は ''Xiph.org Speex'' と記載されています。

PipeWire は Spa と呼ばれる独自のリサンプリングアルゴリズムを使用しています。SoX の {{ic|sox}}、Speex の {{ic|speexenc}} と同様、PipeWire にはそのスタンドアロン版があります。{{ic|spa-resample}} 使い方は
spa-resample -q 15 -f s24 -r 48000 input16bit44100orAnythingElse.wav output24bit48000hz.wav

自分で sink を作れば、他のリサンプラーを使うことも可能でしょう。あるいは、音楽プレーヤーのプラグインを使うことも出来ます(例えば、Qmmp には SoX プラグインがあります)

==== 外付けサウンドカードが再接続後に有効にならない ====

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

==== 音が出ないまたは pactl info が Failure: Connection refused と表示する ====

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (OFTC の [ircs://irc.oftc.net/pipewire #pipewire]) かメーリングリストで相談してください。

==== Bluetooth の音声の品質が低い====

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...
}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...
}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

==== 再生開始時の音声の遅延やポップ/クラックが目立つ ====

これは、非アクティブ時のノードの一時停止が原因です。

{{pkg|pipiwire-media-session}} を使用:

これを無効にするには、遅延が発生する場所に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を 0 に変更します。無効にするか、他の値を試して、何が機能するかを確認します。

または、{{ic|/etc/pipewire/media-session.d/media-session.conf}} の行 {{ic|suspend-node}} をコメントアウトすることもできます。

{{ic|pipewire.service}} と {{ic|pipewire-pulse.service}} の両方でこれらの変更を適用するか、代わりに [[再起動]] します。

{{pkg|wireplumber}} で、新しいファイルを作成してデフォルト設定を上書きします。

{{hc|~/.config/wireplumber/main.lua.d/51-disable-suspension.lua
(or /etc/wireplumber/main.lua.d/51-disable-suspension.lua)|2=
table.insert (alsa_monitor.rules, {
matches = {
{
-- Matches all sources.
{ "node.name", "matches", "alsa_input.*" },
},
{
-- Matches all sinks.
{ "node.name", "matches", "alsa_output.*" },
},
},
apply_properties = {
["session.suspend-timeout-seconds"] = 0, -- 0 disables suspend
},
})
}}

一時停止を完全に無効にする代わりに、タイムアウト値を、ソースを一時停止するまでの希望の遅延秒数に変更することもできます。

==== 再生開始時に音声に遅延が発生する ====

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を {{ic|0}} に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。{{ic|/etc/pipewire/media-session.d/media-session.conf}} の {{ic|suspend-node}} の行をコメントアウトすることもできます。変更を適用するには {{ic|pipewire}} と {{ic|pipewire-pulse}} systemd サービスの両方を再起動するか、システムを再起動してください。

==== 複数のストリームの再生開始時に音声が途切れる ====

この問題は通常 {{ic|journalctl -b | grep -i pipewire}} を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド]によると、この問題を解決するには {{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} を編集し、{{ic|1=api.alsa.headroom = 0}} という行のコメントを外し、値を {{ic|1024}} に変更します。

==== 音がひずむ ====
* マイクについては、{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。
* {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} のコメントを外して、値を {{ic|44100}} に下げてみてください。

==== スタンバイ後に音声の問題が発生する ====

スリープから復帰した際に音が消えたり壊れたりする場合は、ALSA を最初期化すると改善するかもしれません:

# alsactl init

==== USB DAC(例:Schiit 社製 DAC)で高レイテンシー ====

サンプルレートやフォーマットを変更することで、Schiit Hel 2 などの一部の DAC でレイテンシーを減らすことができるかもしれません [https://www.reddit.com/r/osugame/comments/msifdd/usb_dacamp_and_audio_lag/] ''pipewire-media-session'' のマッチングルールを使用すると、デバイスのプロパティを設定することができます [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Config-pipewire-media-session#matching-rules]
''pipewire-media-session'' の {{ic|alsa-monitor.conf}} のデフォルト設定を {{ic|/etc/pipewire/media-session.d}} か {{ic|~/.config/pipewire/media-session.d}} にコピーしてください。
そして、以下のような新しいルールブロックを追加してください。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf
~/.config/pipewire/media-session.d/alsa-monitor.conf|output=
rules = {
...
{
matches = [
{
node.name = "alsa_output.<name of node>"
}
]
actions = {
update-props = {
audio.format = "S24_3LE"
audio.rate = 96000
# Following value should be doubled until audio doesn't cut out or other issues stop occurring
api.alsa.period-size = 128
}
}
}
...
}
}}

{{ic|alsa_output.<node name>}} ノードは {{ic|pw-top}} で取得することができます。

DAC は異なるフォーマットやサンプルレートをサポートしているかもしれません。[[ALSA]] に問い合わせることで、あなたの DAC が何をサポートしているかを確認することができます。

まず、DAC のカード番号を取得します。

{{hc|$ aplay -l|
...
card 3: S2 [Schiit Hel 2], device 0: USB Audio [USB Audio]
Subdevices: 0/1
Subdevice #0: subdevice #0
...
}}

つまり、この例ではカード3ということになります。
サポートされているすべてのサンプルレートとフォーマットを取得します。

{{hc|$ cat /proc/asound/cardX/streamX|
...
Playback:
...
Interface 1
Altset 1
Format: S16_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 16
...
Interface 1
Altset 2
Format: S24_3LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 24
...
Interface 1
Altset 3
Format: S32_LE
Channels: 2
Endpoint: 0x05 (5 OUT) (ASYNC)
Rates: 44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000
Data packet interval: 125 us
Bits: 32
...
...
}}

この場合、{{ic|S16_LE, S24_3LE, S32_LE}} はサポートされているフォーマットで、{{ic|44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000}} はすべてのフォーマットでサポートされているサンプルレートとなります。

==== 音量が 30% になるまで USB DAC から音が出ない ====

USB DAC の中には、ある一定の音量に達するまで音が出なくなるものがあります [https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1117] 一般的にこれは約 25%〜30% で、最初の音量が不快なほど大きくなり、低い音量を維持することができなくなります。解決策としては、{{ic|["api.alsa.soft-mixer"]}} を {{ic|true}} に設定して、ハードウェアミキサーの音量コントロールを無視することが挙げられます。

{{Pkg|wireplumber}} でこれを実現するには、{{ic|/usr/share/wireplumber/main.lua.d/50-alsa-config.lua}} 設定に次を使用して構成フラグメントを追加します。 {{ic|table.insert}}:

{{hc|~/.config/wireplumber/main.lua.d/51-volume-fix.lua|output=

table.insert (alsa_monitor.rules, {
matches = {
{
-- This matches all cards.
{ "device.name", "matches", "alsa_card.*" },
},
},
-- Apply properties on the matched object.
apply_properties = {
-- Don't use the hardware mixer for volume control. It
-- will only use software volume. The mixer is still used
-- to mute unused paths based on the selected port.
["api.alsa.soft-mixer"] = true,
}
})
}}

次に、pipewire を再起動します。{{ic|alsamixer}} でマスターボリュームを設定し、{{ic|# alsactl store}} で設定を保存します。これで、ボリュームミキサーを通常どおり使用できるようになります。

==== リアルタイムオーディオが動作しない ====

{{ic|RTKit error: org.freedesktop.DBus.Error.AccessDenied}} が {{ic|systemctl --user status pipewire.service}} の出力に表示された場合、pipewire daemon の優先度がリアルタイムに変更されていないことを示します。この問題については、[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1069] を参照してください。

==== 同じサウンドカード上の複数のシンクへの同時出力 ====

{{ic|/usr/share/alsa-card-profile/mixer/profile-sets/default.conf}} のコピーを作成し、アップデート後も変更が持続するようにします。ここでは、アナログと HDMI の2つのデフォルトマッピングを結合したプロファイルを定義しています。

{{hc|/usr/share/alsa-card-profile/mixer/profile-sets/multiple.conf|2=
[General]
auto-profiles = no

[Mapping analog-stereo]
device-strings = front:%f
channel-map = left,right
paths-output = analog-output analog-output-lineout analog-output-speaker analog-output-headphones analog-output-headphones-2
paths-input = analog-input-front-mic analog-input-rear-mic analog-input-internal-mic analog-input-dock-mic analog-input analog-input-mic analog-input-linein analog-input-aux analog-input-video analog-input-tvtuner analog-input-fm analog-input-mic-line analog-input-headphone-mic analog-input-headset-mic
priority = 15

[Mapping hdmi-stereo]
description = Digital Stereo (HDMI)
device-strings = hdmi:%f
paths-output = hdmi-output-0
channel-map = left,right
priority = 9
direction = output

[Profile multiple]
description = Analog Stereo Duplex + Digital Stereo (HDMI) Output
output-mappings = analog-stereo hdmi-stereo
input-mappings = analog-stereo
}}

ここで、PipeWire の media-session に、新しい card-profile を使用してデバイスをマッチングするように設定します。識別情報は、{{ic|$ pw-cli dump device}} で見つけることができます。

{{hc|/etc/pipewire/media-session.d/alsa-monitor.conf|2=
rules = [
{
matches = [ { alsa.card_name = "HDA Intel PCH" } ]
actions = {
update-props = {
api.alsa.use-acp = true
device.profile-set = "multiple.conf"
device.profile = "multiple"
api.acp.auto-profile = false
api.acp.auto-port = false
}
}
}
]
}}

==== Discord から通知音が鳴らない ====

min.quantum が低すぎることが原因かもしれませんので、700以上に設定してみてください。pipewire-pulse.conf の pulse.rules セクションに以下のルールを追加することで、Discord 専用にオーバーライドすることが可能です。

{{hc|/etc/pipewire/pipewire-pulse.conf (or ~/.config/pipewire/pipewire-pulse.conf)|output=
...
pulse.rules = [
...
{
# Discord notification sounds fix
matches = [ { application.process.binary = "Discord" } ]
actions = {
update-props = {
pulse.min.quantum = 1024/48000 # 21ms
}
}
}
...
}}

==== PipeWire で FMOD ゲームがクラッシュする ====

[[Wikipedia:Pillars_of_Eternity|Pillars of Eternity]] のような古いバージョンの [[Wikipedia:FMOD|FMOD オーディオエンジン]] を使っているゲームの中には、PulseAudio バイナリが存在しないと {{ic|pulseaudio --check}} を呼び出してクラッシュするものがあります。回避策としては、{{ic|/bin/pulseaudio}}を{{ic|/bin/true}}にシンボリックリンクすることです[https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1514]

# ln -s /bin/true /bin/pulseaudio

PulseAudio を再インストールする場合は、シンボリックリンクを削除する必要があることに注意してください。

==== 自動切り替えが機能しない ====

自動切り替えが機能しない場合、[[WirePlumber]] の状態に問題がある可能性があります。[https://gitlab.freedesktop.org/pipewire/wireplumber/-/issues/191#note_1252549 this comment] が提案しているように、[[WirePlumber]] のローカル状態を削除し、デーモンを再起動することで改善されるかどうか確認することができます。

$ rm -r ~/.local/state/wireplumber/

次に、{{ic|wireplumber.service}} [[systemd/ユーザー|ユーザーユニット]] を [[ヘルプ:読み方# systemd ユニットのコントロール|再起動]] します。

=== ビデオ ===

==== OBS（など）がウィンドウ/スクリーンを要求しても何も表示されない ====

{{Pkg|xdg-desktop-portal}} と {{Pkg|xdg-desktop-portal-gtk}} または {{Pkg|xdg-desktop-portal-kde}} がインストールされていることが確実なら、デーモンの実行状態を確認してください。

OBS では、すべてがうまくいっていれば、{{ic|stdout}} にこのように表示されるはずです。

...
info: [pipewire] desktop selected, setting up screencast
info: [pipewire] created stream 0x5632d7456850
info: [pipewire] playing stream…

マルチモニタ環境では、{{Pkg|slurp}} パッケージを使用すると、すべての画面をキャプチャすることができます。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

GnuPG

2023-02-07T10:04:11Z

Shota: /* 失効証明書のバックアップ */ 内部リンクの修正。

[[Category:暗号化]]
[[Category:メール]]
[[Category:GNU]]
[[en:GnuPG]]
[[es:GnuPG]]
[[ru:GnuPG]]
[[zh-hans:GnuPG]]
[[zh-hant:GnuPG]]
{{Related articles start}}
{{Related|pacman-key}}
{{Related|ディスク暗号化}}
{{Related|アプリケーション一覧/セキュリティ#暗号化, 署名, ステガノグラフィー}}
{{Related articles end}}
[https://www.gnupg.org/ 公式サイト] によれば:

:GnuPG は [https://tools.ietf.org/html/rfc4880 RFC4880] (別名 PGP) で定義される [http://openpgp.org/about/ OpenPGP] 標準の完全でフリーな実装です。GnuPG を使うことでデータや通信を暗号化したり署名することができます。多目的の鍵管理システムであり、あらゆる種類の公開鍵ディレクトリのアクセスモジュールです。GnuPG (またの名を GPG) は他のアプリケーションとの簡単に連携できる機能を備えたコマンドラインツールです。豊富なアプリケーションとライブラリが利用可能です。GnuPG のバージョン2は S/MIME と ssh のサポートも含んでいます。

== インストール ==

{{Pkg|gnupg}} をインストールしてください。

gnupg をインストールすると、GnuPG がパスフレーズエントリに使用するシンプルな PIN やパスフレーズエントリダイアログのコレクションである {{Pkg|pinentry}} もインストールされます。シェルスクリプト {{ic|/usr/bin/pinentry}} は [[#pinentry]] で説明されている順番で、どの ''pinentry'' ダイアログを使用するかを決定します。

グラフィカルフロントエンドや GnuPG と連携するプログラムを使いたい場合は[[アプリケーション一覧/セキュリティ#暗号化, 署名, ステガノグラフィー]]を参照してください。

== 設定 ==

=== 設定ファイルのディレクトリ ===

GnuPG では {{ic|$GNUPGHOME}} によって全ての設定ファイルを保存するディレクトリが指定されます。デフォルトでは {{ic|$GNUPGHOME}} は設定されておらず、代わりに {{ic|$HOME}} が使われます。そのためインストール直後は {{ic|~/.gnupg}} ディレクトリが確認できます。[[自動起動|スタートアップファイル]]に次の行を記述することでデフォルト設定を変更できます:

export GNUPGHOME="''/path/to/directory''"

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

デフォルトの設定ファイルは {{ic|~/.gnupg/gpg.conf}} と {{ic|~/.gnupg/dirmngr.conf}} です。

デフォルトでは、gnupg ディレクトリの[[ファイルのパーミッションと属性|パーミッション]]は ''700'' に設定されており、ディレクトリのファイルのパーミッションは ''600'' に設定されています。ファイルの読み書きやアクセスの権限を持っているのはディレクトリの所有者だけです (''r'',''w'',''x'')。これはセキュリティ上の理由で設定されていることなので変更してはいけません。ディレクトリやファイルがこのセキュリティ対策に従っていない場合、ファイルやホームディレクトリのパーミッションが安全ではないという警告が表示されます。

どんな長いオプションも設定ファイルに追加します。2つのダッシュを書かないで、オプションや必要な引数の名前を書いて下さい。スケルトンファイルは {{ic|/usr/share/doc/gnupg/}} にあります。gpg がなんらかの操作のため最初に起動されたとき、{{ic|~/.gnupg}} が存在しなければこれらのファイルが {{ic|~/.gnupg}} にコピーされます。[[#参照]] に他の例があります。

また、[[pacman]] がパッケージの署名の検証に使用する設定ファイルは別に存在します。詳しくは [[pacman-key]] を見てください。

=== 新規ユーザーのデフォルトオプション ===

新規ユーザーのデフォルトオプションを設定したい場合、{{ic|/etc/skel/.gnupg/}} に設定ファイルを配置してください。新しいユーザーが追加されると、{{ic|/etc/skel/.gnupg/}} から GnuPG のホームディレクトリにファイルがコピーされます。既存のユーザーのために新しい GnuPG ホームディレクトリを作成できる ''addgnupghome'' というスクリプトも存在します:

# addgnupghome user1 user2

上記のコマンドは {{ic|/home/user1/.gnupg}} と {{ic|/home/user2/.gnupg}} を作成してスケルトンディレクトリからファイルをコピーします。既に GnuPG のホームディレクトリが存在するユーザーはスキップされます。

== 使い方 ==

{{Note|コマンドに ''{{ic|<user-id>}}'' が必要なときは、鍵 ID、指紋、名前やメールアドレスの一部などを指定できます。これについて GnuPG は寛容です。}}

=== 鍵ペアの作成 ===

鍵ペアを生成するにはターミナルに次を入力:

$ gpg --full-gen-key

{{Tip|{{ic|--expert}} を使うことで他の暗号を利用することができます ([[wikipedia:ja:楕円曲線暗号|楕円曲線暗号]]など)。}}

上記のコマンドを実行すると複数の質問がきかれます。大抵の場合、以下の設定が必要になります:

* RSA (署名のみ) と RSA (暗号化のみ) 鍵。
* 鍵長は2048ビットで十分です。4096ビットを使ったところで [https://www.gnupg.org/faq/gnupg-faq.html#no_default_of_rsa4096 "大した効果はありませんし、無駄に時間がかかるようになるだけです"] 。
* 副鍵の有効期限の設定は技術的には必須ではありませんが、設定することは悪くありません。標準的なユーザーなら、1年間で十分でしょう。たとえ鍵束へのアクセスを失っても、他の人が有効でないことを知ることができるようになります。鍵を作成した後、新しい鍵を再発行しなくても満了日は延長することができます。
* 名前とメールアドレス。後で同じ鍵に別の識別子を追加できます (複数のメールアドレスが存在する場合など)。
* コメントは必要ありません。コメントフィールドのセマンティクスは [https://lists.gnupg.org/pipermail/gnupg-devel/2015-July/030150.html 定義があやふや] なため、識別子としては限定的です。
* 安全なパスフレーズを選ぶようにしてください ([[セキュリティ#パスワードの管理]]を参照)。

{{Note|入力した名前とメールアドレスは鍵をインポートすれば誰でも確認できるようになります。}}

=== 鍵一覧 ===

* 公開鍵束の鍵の一覧:

$ gpg --list-keys

* 秘密鍵束の鍵の一覧:

$ gpg --list-secret-keys

=== 公開鍵のエクスポート ===

公開鍵暗号で交換されたメッセージの機密性を保証するのが gpg の主な利用法です。互いの鍵束の公開鍵を交換して、メッセージを暗号化するときに使用します。秘密鍵は必ず漏洩しないようにしてください。機密性が破れてしまいます。

他の人があなたに暗号化したメッセージを送れるようにするには、彼らがあなたの公開鍵を知っている必要があります。

(メールで送る場合などのために) ASCII 版の公開鍵を {{ic|''public.key''}} ファイルとして生成するには:

$ gpg --output ''public.key'' --armor --export ''user-id''

あるいは、[[#鍵サーバーを使用する|鍵サーバー]]で鍵を共有する方法もあります。

{{Tip|
* {{ic|--no-emit-version}} を使うか、これを設定ファイルに書くことでバージョン番号の表示を抑制できます。
* {{ic|user-id}} を省略して、キーリング内のすべての公開鍵をエクスポートできます。これは、一度に複数の ID を共有したい場合や、別のアプリケーションにインポートする場合に便利です。例: [[Thunderbird#Use_OpenPGP_with_external_GnuPG|Thunderbird]]。}}

=== 公開鍵のインポート ===

メッセージを暗号化して他の人に送るには、彼らの公開鍵が必要です。公開鍵 ({{ic|''public.key''}}) を自分の公開鍵リングにインポートするには:

$ gpg --import public.key

あるいは、[[#鍵サーバーを使用する|鍵サーバー]]で公開鍵を見つけます。

特定の Arch Linux パッケージをインストールするためにキー ID をインポートしたい場合は、[[pacman-key#キーリングの管理|キーリングの管理]] と [[Makepkg#署名チェック]] を参照してください。

=== 鍵サーバーを使用する ===

==== 鍵の送信 ====

自分の公開鍵を公共の PGP 鍵サーバーに登録することで、他の人があなたに直接連絡することなしにあなたの鍵を入手できるようになります:

$ gpg --send-keys ''user-id''

{{Warning|鍵を鍵サーバーに登録してから、サーバーから鍵を削除することはできません [https://pgp.mit.edu/faq.html]。その理由は、[https://pgp.mit.edu/faq.html MIT PGP Public Key Server FAQ]で説明されています。}}
{{Note|関連するメールアドレスが公開されると、スパムメールの標的となる可能性があり、この場合、スパム対策用のフィルタリングが必要となる場合があります。}}

==== 鍵の検索と受信 ====

鍵サーバーの鍵の情報を確認したい場合、次のコマンドを実行:

$ gpg --search-keys ''user-id''

鍵サーバーから鍵をインポートするには:

$ gpg --recv-keys ''key-id''

{{Warning|
* 誰でも鍵サーバーに鍵を送ることができます。そのため、ダウンロードした鍵が本当にその人のものであると信用してはいけません。入手した鍵の指紋を、持ち主が別の場所（ブログ、サイト、メール・電話で連絡するなど）で公開している指紋と比較してその鍵の真正性を確かめるべきです。複数の情報源を使うことでその鍵の信頼性は増します。[[Wikipedia:Public key fingerprint]] を参照。
* ID が短いと衝突する可能性があります。インポートされた鍵には全て短い ID が割り当てられます。鍵を受け取るときに完全な指紋か長い鍵 ID を使うことで衝突を回避できます [https://lkml.org/lkml/2016/8/15/445]。
}}

{{Tip|{{ic|auto-key-retrieve}} を {{ic|gpg.conf}} に追加すると、必要に応じて鍵サーバから鍵を自動的に取得しますが、これは '''プライバシー侵害''' と見なされる可能性があります。{{man|1|gpg}} の "web bug" を参照。}}

==== 鍵サーバー ====

最も一般的な鍵サーバーは次の通りです。

* [https://keyserver.ubuntu.com Ubuntu 鍵サーバー]: federated, no verification, keys cannot be deleted.
* [https://keys.mailvelope.com Mailvelope 鍵サーバー]: central, verification of email IDs, keys can be deleted.
* [https://keys.openpgp.org keys.openpgp.org]: central, verification of email IDs, keys can be deleted, no third-party signatures (i.e. no Web of Trust support).

詳細は [[Wikipedia:Key server (cryptographic)#Keyserver examples]] に一覧があります。

代替の鍵サーバーは、例えば、[[#設定ファイル]]の 1 つで　{{ic|keyserver}} オプションで指定することができます。

{{hc|~/.gnupg/dirmngr.conf|
keyserver hkp://keyserver.ubuntu.com
}}
通常のサーバーが思うように動かないときに、一時的に別のサーバーを使用するのは便利なことです。例えば、以下のような方法で実現できます。

$ gpg --keyserver hkps://keys.openpgp.org/ --search-keys 931FF8E79F0876134EDDBDCCA87FF9DF48BF1C90

{{Tip|
* If receiving fails with the message {{ic|gpg: keyserver receive failed: General error}}, and you use the default hkps keyserver pool, make sure set the HKPS pool verification certificate with {{ic|hkp-cacert /usr/share/gnupg/sks-keyservers.netCA.pem}} in your {{ic|dirmngr.conf}} and kill the old dirmngr process.
* If receiving fails with the message {{ic|gpg: keyserver receive failed: Connection refused}}, try using a different DNS server.
* You can connect to the keyserver over [[Tor]] with [[Tor#Torsocks]]. Or using the {{ic|--use-tor}} command line option. See [https://gnupg.org/blog/20151224-gnupg-in-november-and-december.html] for more information.
* You can connect to a keyserver using a proxy by setting the {{ic|http_proxy}} [[environment variable]] and setting {{ic|honor-http-proxy}} in {{ic|dirmngr.conf}}. Alternatively, set {{ic|http-proxy ''host[:port]''}} in the configuration file to override the environment variable of the same name. [[Restart]] the {{ic|dirmngr.service}} [[systemd/User|user service]] for the changes to take effect.}}

=== Web Key Directory ===

Web Key Service (WKS) プロトコルは、鍵配布のための新しい [https://datatracker.ietf.org/doc/draft-koch-openpgp-webkey-service/ 標準]で、電子メールドメインが [https://wiki.gnupg.org/WKD Web Key Directory (WKD)] という独自の鍵サーバーを提供するものです。電子メールアドレス（例 : {{ic|user@example.com}}）に暗号化するとき、GnuPG （>=2.1.16）は、公開鍵をローカル鍵束にまだ持っていなければ、 HTTPS でそのドメイン（{{ic|example.com}}）に照会します。オプション {{ic|auto-key-locate}} は、このメールアドレスのローカル鍵束に鍵がない場合、WKD プロトコルを使って鍵を探します。

# gpg --recipient ''user@example.org'' --auto-key-locate --encrypt ''doc''

WKD をサポートしているメールプロバイダーの一覧は [https://wiki.gnupg.org/WKD#Implementations GnuPG Wiki] を参照してください。メールアドレスのドメインを自分で管理している場合は、[https://wiki.gnupg.org/WKDHosting このガイド]に従って、自分のドメインで WKD を有効にすることができます。あなたの鍵が WKD で見つかるかどうかを確認するには、[https://metacode.biz/openpgp/web-key-directory このウェブインターフェイス]が使用できます。

=== 暗号化と復号化 ===

==== 非対称 ====

暗号化や復号化をするときは複数の秘密鍵を使用することが可能です。複数の鍵を使うときは使用する鍵を選択する必要があります。{{ic|-u ''<user-id>''}} オプションや {{ic|--local-user ''<user-id>''}} オプションを使うことで選択できます。このオプションを使うとデフォルトの鍵を使用する代わりに指定された鍵を使用します。先に[[#鍵の作成]]が必要です。

(テキストでメッセージをコピー＆ペーストするのに適している) ASCII armor を使ってファイルを暗号化するには、次を使用:

$ gpg --encrypt --armor secret.txt

単に暗号化だけしたいときは {{ic|--armor}} は不要です。

{{Tip|
* 受取人を変更したい場合は {{ic|-r ''<user-id>''}} (または {{ic|--recipient ''<user-id>''}}) オプションで変更できます。
* 暗号メッセージに受取人の鍵 ID を入れたくないときは {{ic|--recipient}} のかわりに {{ic|-R ''<user-id>''}} または {{ic|--hidden-recipient ''<user-id>''}} を追加してください。メッセージの受取人を隠蔽して、トラフィックの解析に対する対抗策になります。
* バージョン番号を出力したくないときは {{ic|--no-emit-version}} を追加してください。または設定ファイルに同じ設定を追加してください。}}

{{Note|gnupg を使えば機密文書を暗号化できますが、一度に複数のファイルを暗号化することはできません。ディレクトリやファイルシステム全体を暗号化したいときは、[[TrueCrypt]] や [[EncFS]] などを使用するか、tarball にファイルをまとめて暗号化すると良いでしょう。}}

ファイルを復号化するには、次のコマンドを使用:

$ gpg --decrypt secret.txt.asc

パスフレーズの入力が求められます。復号化するには送信者の公開鍵をインポートしてある必要があります。

==== 対称 ====
対称暗号化では鍵を生成する必要がなくパスフレーズだけでデータを暗号化できます。対称暗号化を使用するするには {{ic|--symmetric}} または {{ic|-c}} を使用します:

$ gpg -c ''doc''

例:

* パスフレーズを使って対称暗号で {{ic|''doc''}} を暗号化。
* AES-256 暗号アルゴリズムを使ってパスフレーズを暗号化。
* SHA-512 ダイジェストアルゴリズムを使ってパスフレーズをハッシュ化。
* 65536回繰り返しパスフレーズをハッシュ化。

$ gpg -c --s2k-cipher-algo AES256 --s2k-digest-algo SHA512 --s2k-count 65536 ''doc''

対称暗号化された {{ic|''doc''.gpg}} をパスフレーズで復号化して {{ic|''doc''}} として同じディレクトリに出力するには:

$ gpg --output ''doc'' --decrypt ''doc''.gpg

==== ディレクトリ ====

ディレクトリの暗号化・復号化は {{man|1|gpgtar}} で行うことができます。

暗号化:
$ gpgtar -c -o ''dir''.gpg ''dir''

復号化:
$ gpgtar -d ''dir''.gpg

== 鍵の管理 ==

=== 秘密鍵のバックアップ ===

秘密鍵をバックアップするには以下を実行:

$ gpg --export-secret-keys --armor ''<user-id>'' > ''privkey.asc''

''gpg'' のリリース 2.1 からデフォルトの挙動が変わっており、たとえ鍵の作成時にパスワードを設定しなかった場合でも上記のコマンドを実行したときにパスフレーズによる保護が必須になっています。エクスポートされたファイルを入手してしまえば、パスフレーズを知らなくてもファイルを暗号化したり署名を加えることができてしまうためです。

{{Warning|パスフレーズは秘密鍵の最大の弱点となります。暗号化されたコンテナやドライブなど、秘密鍵は安全な場所に保管してください。}}

秘密鍵のバックアップをインポートするには:
$ gpg --import ''privkey.asc''

=== 失効証明書のバックアップ ===

失効証明書は、新しく生成されたキーに対して自動的に生成されます。これらはデフォルトで {{ic|~/.gnupg/openpgp-revocs.d/}} にあります。証明書のファイル名は、取り消すキーのフィンガープリントです。
失効証明書は、ユーザーが後で次を使用して手動で生成することもできます。

$ gpg --gen-revoke --armor --output ''revcert.asc'' ''user-id''

この証明書は、紛失または侵害された場合に [[#鍵の取り消し]] に使用できます。バックアップは、秘密鍵にアクセスできなくなったため、上記のコマンドで新しい失効証明書を生成できない場合に役立ちます。必要に応じて印刷して手で入力できるほど短いです。

{{Warning|失効証明書にアクセスできる人は誰でも、キーを公に失効させることができます。このアクションは元に戻すことはできません。秘密鍵を保護するのと同じように、失効証明書を保護します。}}

=== 鍵の編集 ===

* {{ic|gpg --edit-key ''<user-id>''}} コマンドを実行するとメニューが表示され、鍵管理に関連するほとんどの作業を行うことができます。以下は満了日を設定する例です:

$ gpg --edit-key ''<user-id>''
> key ''number''
> expire ''yyyy-mm-dd''
> save
> quit

便利なコマンド:
> passwd # change the passphrase
> clean # compact any user ID that is no longer usable (e.g revoked or expired)
> revkey # revoke a key
> addkey # add a subkey to this key
> expire # change the key expiration time

* 公開鍵の ASCII バージョンを生成 (例: メールなどで配るため):

$ gpg --armor --output public.key --export ''<user-id>''

* PGP 公開鍵サーバーに鍵を登録して、他の人があなたに直接連絡しなくても鍵を取得できるようにする:

$ gpg --keyserver pgp.mit.edu --send-keys ''<key-id>''

* ユーザー Bob あてに署名と暗号化:

$ gpg -se -r Bob ''file''

* クリアテキスト署名を作成:

$ gpg --clearsign ''file''

=== 副鍵のエクスポート ===

複数のデバイスで同じ鍵を使い回す場合、マスター鍵を分離させて、セキュリティが低いシステムでは暗号化に必要な副鍵だけを使いたいという状況が考えられます。

まず、エクスポートしたい副鍵を確認してください:

$ gpg -K

エクスポートする副鍵だけを選択:

$ gpg -a --export-secret-subkeys [subkey id]! > /tmp/subkey.gpg

{{Warning|''!'' を追加するのを忘れると、全ての副鍵がエクスポートされます。}}

ここで作業を終えても良いですが、パスフレーズの変更もしておくと安全です。一時フォルダに鍵をインポートします:

$ gpg --homedir /tmp/gpg --import /tmp/subkey.gpg
$ gpg --homedir /tmp/gpg --edit-key ''<user-id>''
> passwd
> save
$ gpg --homedir /tmp/gpg -a --export-secret-subkeys [subkey id]! > /tmp/subkey.altpass.gpg

{{Note|マスター鍵が存在しない、また、マスター鍵のパスワードが変更されていないという警告が表示されますが、変更したのは副鍵のパスワードなので無視してかまいません。}}

これで、他のデバイスで {{ic|/tmp/subkey.altpass.gpg}} を使うことができます。

=== 有効期限の延長 ===

{{Warning|何か特段の事情がないかぎり、有効期限が切れたり無効になった副鍵を削除しないでください。削除してしまうとその副鍵で暗号化したファイルを復号化できなくなってしまいます。満了した、または無効のキーを削除するのは他のユーザーの鍵束を整理するときだけにしてください。}}

副鍵を設定して一定期間後に満了したら、新しい副鍵を作成できます。他のユーザーが鍵束を更新できるように数週間前に行うようにしましょう。

{{Note|新しい鍵を作成する必要はありません。期限がきて使えなくなっただけだからです。有効期間を延長することができます。}}

* 新しい副鍵を作成 (署名と暗号化の鍵の両方)

$ gpg --edit-key ''<user-id>''
> addkey

そして質問に答えて下さい (推奨される設定については前のセクションを参照)。

* 変更を保存:

> save

* 鍵サーバーにアップデート:

$ gpg --keyserver pgp.mit.edu --send-keys ''<user-id>''

また、この鍵を複数のコンピュータで使用する場合は、公開鍵（新しい署名付き有効期限付き）をエクスポートして、それらのマシンでインポートすることもできます。

$ gpg --export --output pubkey.gpg ''user-id''
$ gpg --import pubkey.gpg

秘密鍵の再エクスポートやバックアップの更新は必要ありません。マスター秘密鍵自体に有効期限がなく、公開鍵やサブ鍵に残された有効期限の署名があればよいのです。

=== Rotating subkeys ===

{{Warning|'''Never''' delete your expired or revoked subkeys unless you have a good reason. Doing so will cause you to lose the ability to decrypt files encrypted with the old subkey. Please '''only''' delete expired or revoked keys from other users to clean your keyring.}}

Alternatively, if you prefer to stop using subkeys entirely once they have expired, you can create new ones. Do this a few weeks in advance to allow others to update their keyring.

{{Tip|You do not need to create a new key simply because it is expired. You can extend the expiration date, see the section [[#Extending expiration date]].}}

Create new subkey (repeat for both signing and encrypting key)

$ gpg --edit-key ''user-id''
> addkey

And answer the following questions it asks (see [[#Create a key pair]] for suggested settings).

Save changes

> save

Update it to a keyserver.

$ gpg --keyserver pgp.mit.edu --send-keys ''user-id''

You will also need to export a fresh copy of your secret keys for backup purposes. See the section [[#Backup your private key]] for details on how to do this.

{{Tip|Revoking expired subkeys is unnecessary and arguably bad form. If you are constantly revoking keys, it may cause others to lack confidence in you.}}

=== 鍵の取り消し ===

鍵が侵害された、置き換えられた、使用されなくなった、またはパスフレーズを忘れた場合は、キーの取り消しを実行する必要があります。これは、鍵を鍵の失効証明書とマージすることによって行われます。

鍵ペアにアクセスできなくなった場合は、まず[[#公開鍵のインポート]]して独自の鍵をインポートします。
次に、キーを失効させるために、[[#失効証明書のバックアップ]] で保存したファイルをインポートします。

$ gpg --import ''revcert.asc''

ここで、取り消しを公開する必要があります。 [[#鍵サーバーを使用する]]で過去に PGP サーバーを使用したことがある場合は、取り消された鍵を公開 PGP サーバーに送信します。それ以外の場合は、取り消された鍵をファイルにエクスポートし、通信パートナーに配布します。

== 署名 ==

署名は文章を証明します。文章が改変された場合、署名の検証に失敗します。公開鍵を使用して文章を暗号化する暗号化とは違って、署名はユーザーの秘密鍵を使って作成されます。署名された文章を受け取った人は送り主の公開鍵を使って署名を検証できます。

=== 署名の作成 ===

==== ファイルに署名する ====

ファイルに署名するには {{ic|--sign}} または {{ic|-s}} フラグを使います:

$ gpg --output ''doc.sig'' --sign ''doc''

上記のコマンドは暗号化も行ってファイルをバイナリ形式で保存します。

==== ファイルやメッセージにクリア署名 ====

バイナリ形式に圧縮しないでファイルに署名するには:

$ gpg --clearsign ''doc''

上記のコマンドは文章を ASCII-armored 署名でラッピングしますが、文章に変更は加えられません。

==== 分離署名を作成する ====

文章やファイルとは別に署名ファイルを作成したい場合、{{ic|--detach-sig}} フラグを使ってください:

$ gpg --output ''doc.sig'' --detach-sig ''doc''

上記の方法はソフトウェアプロジェクトを配布するときによく用いられます。署名書を検証することで第三者によってファイルが改竄されていないことが確認できます。

==== 署名の検証 ====

署名を検証するには {{ic|--verify}} フラグを使います:

$ gpg --verify ''doc.sig''

{{ic|''doc.sig''}} は検証したい署名に置き換えてください。

ファイルの検証と復号化を同時に行いたいお場合、{{ic|--decrypt}} フラグを使ってください。

分離署名を検証する場合、ファイルと署名の両方が必要になります。例えば、Arch Linux の ISO を検証する場合:

$ gpg --verify ''archlinux-''version''.iso.sig''

{{ic|archlinux-''version''.iso}} が同じディレクトリに存在していなければなりません。

=== 署名の確認 ===

署名を確認するには、{{ic|--verify}} フラグを使用します。

$ gpg --verify ''doc''.sig

ここで {{ic|''doc''.sig}} は、検証したい署名を含む署名付きファイルです。

分離された署名を検証する場合、署名されたデータファイルと署名ファイルの両方が検証時に存在する必要があります。例えば、Arch Linux の最新の iso を検証する場合、次のようになります。

$ gpg --verify archlinux-''version''.iso.sig

ここで {{ic|archlinux-''version''.iso}} は同じディレクトリにある必要があります。

また、第2引数で署名付きデータファイルを指定することも可能です。

$ gpg --verify archlinux-''version''.iso.sig ''/path/to/''archlinux-''version''.iso

署名に加えて暗号化されている場合は、[[#暗号化と復号化|復号化]]を行うだけで署名も検証されます。

== gpg-agent ==

''gpg-agent'' はキーチェインにパスワードをリクエストしたりキャッシュしたりするのに使われるデーモンです。メールクライアントなど外部のプログラムから GnuPG を利用する場合に便利です。{{Pkg|gnupg}} には [[systemd/ユーザー|systemd ユーザー]]ソケットが付属しており、デフォルトで有効になります: {{ic|gpg-agent.socket}}, {{ic|gpg-agent-extra.socket}}, {{ic|gpg-agent-browser.socket}}, {{ic|gpg-agent-ssh.socket}}, {{ic|dirmngr.socket}}。

* ''gpg'' はメインの {{ic|gpg-agent.socket}} を使って ''gpg-agent'' デーモンに接続します。
* {{ic|gpg-agent-extra.socket}} はリモート環境から Unix ドメインソケットの転送を設定します。秘密鍵をリモート環境に移さなくてもリモート環境で ''gpg'' が使えるようになります。詳しくは {{man|1|gpg-agent}} を参照。
* The {{ic|gpg-agent-browser.socket}} allows web browsers to access the ''gpg-agent'' daemon.
* [[SSH]] は {{ic|gpg-agent-ssh.socket}} を使って ''ssh-add'' プログラムによって追加された [[SSH 鍵]]をキャッシュします。必要な設定は [[#SSH エージェント]]を見てください。
* {{ic|dirmngr.socket}} は鍵サーバーへの接続を処理する GnuPG デーモンを起動します。

{{Note|GnuPG の設定ファイルのディレクトリがデフォルトと異なる場合、{{ic|gpgconf --list-dirs}} の値を使用するようにソケットファイルを編集してください。}}

=== 設定 ===

gpg-agent は {{ic|~/.gnupg/gpg-agent.conf}} ファイルで設定することができます。設定オプションは {{man|1|gpg-agent}} に記載されています。例えば、未使用の鍵の cache ttl を変更することができます:

{{hc|~/.gnupg/gpg-agent.conf|
default-cache-ttl 3600
}}

{{Tip|セッションを通してパスフレーズをキャッシュするには、次のコマンドを実行してください:
$ /usr/lib/gnupg/gpg-preset-passphrase --preset XXXXXX

XXXX は鍵輪に置き換えてください。鍵輪の値は {{ic|gpg --with-keygrip -K}} を実行することで取得できます。パスフレーズは {{ic|gpg-agent}} が再起動されるまで保存されます。{{ic|default-cache-ttl}} の値を設定した場合、そちらが優先されます。
}}

=== エージェントのリロード ===

設定を変更した後は、{{ic|gpg-connect-agent}} でエージェントをリロードしてください:

$ gpg-connect-agent reloadagent /bye

シェルに {{ic|OK}} と出力されます。

しかし、エージェント設定に {{ic|keep-screen}} が追加されている場合など、再起動だけでは十分でないこともあります。
この場合、まず進行中の gpg-agent プロセスを kill してから、上記で説明したように再起動する必要があります。

=== pinentry ===

{{ic|gpg-agent}} は {{ic|pinentry-program}} stanza を使用して、パスフレーズの入力を促す際に、特定の {{Pkg|pinentry}} ユーザーインターフェイスを使用するように設定できます。例えば、以下の通りです。

{{hc|~/.gnupg/gpg-agent.conf|
pinentry-program /usr/bin/pinentry-curses
}}

他のも様々な pinentry プログラムがあります。{{ic|pacman -Ql pinentry {{!}} grep /usr/bin/}} を参照してください。

{{Tip|{{ic|/usr/bin/pinentry-kwallet}} を使うには {{AUR|kwalletcli}} パッケージをインストールする必要があります。}}

変更を行った後は、[[#エージェントのリロード|エージェントのリロード]]を忘れないでください。

=== パスワードのキャッシュ ===

GnuPG のパスワードをセッションの間だけ記憶させたい場合、{{ic|max-cache-ttl}} と {{ic|default-cache-ttl}} を高い値に設定してください:

{{hc|
gpg-agent.conf|
max-cache-ttl 60480000
default-cache-ttl 60480000
}}

詳しくは [[#gpg-agent]] を参照。

=== 無人のパスフレーズ ===

GnuPG 2.1.0 から gpg-agent と pinentry の利用が必須になりました。これによって {{ic|--passphrase-fd 0}} コマンドラインオプションによって STDIN からパイプで渡されたパスフレーズの後方互換性が損ねられています。古いリリースと同じような機能を使うには2つのことをする必要があります:

まず、gpg-agent の設定を編集して ''loopback'' pinentry モードを許可してください:

{{hc|1=~/.gnupg/gpg-agent.conf|2=
allow-loopback-pinentry
}}

gpg-agent プロセスが実行している場合は再起動して変更を適用します。

次に、更新する必要があるアプリケーションに以下のようにコマンドラインパラメータを含めて loopback モードを使用します:

$ gpg --pinentry-mode loopback ...

もしくは、コマンドラインで設定ができない場合、オプションを設定に追加します:

{{hc|1=~/.gnupg/gpg.conf|2=
pinentry-mode loopback
}}

{{Note|上流の開発者は ''gpg.conf'' で ''pinentry-mode loopback'' を設定すると他の機能が使えなくなる可能性があると示唆しています。出来るかぎりコマンドラインオプションを使うようにして下さい [https://bugs.g10code.com/gnupg/issue1772]。}}

=== SSH エージェント ===

''gpg-agent'' には OpenSSH エージェントのエミュレーション機能が存在します。既に GnuPG スイートを使っているのであれば、SSH 鍵をキャッシュするのに使うことが可能です。さらに、パスフレーズを管理するのに GnuPG エージェントの PIN エントリダイアログを使えます。

==== SSH_AUTH_SOCK の設定 ====

SSH が ''ssh-agent'' の代わりに ''gpg-agent'' を使うように {{ic|SSH_AUTH_SOCK}} を設定してください。シェルのタイプに関係なくプロセスが ''gpg-agent'' インスタンスを使うようにするには [[環境変数#pam_env を使う|pam_env]] を使用します:

{{hc|~/.pam_environment|2=
SSH_AGENT_PID DEFAULT=
SSH_AUTH_SOCK DEFAULT="${XDG_RUNTIME_DIR}/gnupg/S.gpg-agent.ssh"
}}

{{note|
* {{ic|SSH_AUTH_SOCK}} を手動で設定する場合、{{ic|GNUPGHOME}} をカスタマイズしているときはソケットの場所が異なる可能性があるので注意してください。以下の bash の例を使用するか、{{ic|SSH_AUTH_SOCK}} を {{ic|gpgconf --list-dirs agent-ssh-socket}} の値に変更してください。
* GNOME Keyring がインストールされている場合、その ssh コンポーネントを[[GNOME/Keyring#キーリングデーモンの無効化|無効化]]する必要があります。そうしないと、{{ic|SSH_AUTH_SOCK}} を上書きしてしまいます。}}

または、Bash を使う場合:

{{hc|~/.bashrc|<nowiki>
unset SSH_AGENT_PID
if [ "${gnupg_SSH_AUTH_SOCK_by:-0}" -ne $$ ]; then
export SSH_AUTH_SOCK="$(gpgconf --list-dirs agent-ssh-socket)"
fi
</nowiki>}}

{{Note|1=<nowiki></nowiki>エージェントを {{ic|gpg-agent --daemon /bin/sh}} で起動している場合、シェルは {{ic|SSH_AUTH_SOCK}} 変数を ''gpg-agent'' から承継します [http://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=blob;f=agent/gpg-agent.c;hb=7bca3be65e510eda40572327b87922834ebe07eb#l1307]。}}

==== 適切な TTY を使うように pinentry を設定 ====

{{man|1|gpg-agent}} にあるように、ユーザーを X セッションに切り替えた場合は GPG_TTY も設定して TTY を更新してください。例:

{{hc|~/.bashrc|<nowiki>
# Set GPG TTY
export GPG_TTY=$(tty)

# Refresh gpg-agent tty in case user switches into an X session
gpg-connect-agent updatestartuptty /bye >/dev/null
</nowiki>}}

複数の端末を同時に使用し、''ssh'' コマンドを実行した同じ端末から ''pinentry-curses'' で ''gpg-agent'' がパスフレーズを要求するようにしたい場合、SSH 設定ファイルに以下を追加してください。これにより、''ssh'' コマンドを実行するたびに TTY がリフレッシュされるようになります [https://unix.stackexchange.com/a/499133]。

{{hc|~/.ssh/config|2=
Match host * exec "gpg-connect-agent UPDATESTARTUPTTY /bye"
}}

なお、環境変数 GPG_TTY が設定されていないと動作しません。

==== SSH 鍵の追加 ====

''gpg-agent'' が起動していれば [[SSH 鍵#ssh-agent|ssh-agent]] と同じように ''ssh-add'' で鍵を追加できます。追加された鍵は {{ic|~/.gnupg/sshcontrol}} ファイルに保存されます。パスフレーズが必要になったときは毎回 ''pinentry'' ダイアログが表示されます。パスフレーズのキャッシュは {{ic|~/.gnupg/gpg-agent.conf}} ファイルで制御します。以下の例では ''gpg-agent'' で鍵を3時間キャッシュします:

{{hc|~/.gnupg/gpg-agent.conf|
default-cache-ttl-ssh 10800
max-cache-ttl-ssh 10800}}

==== SSH 認証に PGP 鍵を使用する ====

PGP 鍵を SSH 鍵として使うこともできます。鍵のメンテナンスを楽にして SSH 鍵をキーカードに保存できます。認証機能を有効にして鍵を作成する必要があります ([[#カスタム機能]]を参照)。SSH 認証に PGP 鍵を使用することで得られる様々な利点があります。

* Reduced key maintenance, as you will no longer need to maintain an SSH key.
* The ability to store the authentication key on a smartcard. GnuPG will automatically detect the key when the card is available, and add it to the agent (check with {{ic|ssh-add -l}} or {{ic|ssh-add -L}}). The comment for the key should be something like: {{ic|openpgp:''key-id''}} or {{ic|cardno:''card-id''}}.

To retrieve the public key part of your GPG/SSH key, run {{ic|gpg --export-ssh-key ''gpg-key''}}. If your key is authentication-capable but this command still fails with "Unusable public key", add a {{ic|!}} suffix ([https://dev.gnupg.org/T2957]).

Unless you have your GPG key on a keycard, you need to add your key to {{ic|$GNUPGHOME/sshcontrol}} to be recognized as a SSH key. If your key is on a keycard, its keygrip is added to {{ic|sshcontrol}} implicitly. If not, get the keygrip of your key this way:

{{hc|$ gpg --list-keys --with-keygrip|2=
sub rsa4096 2018-07-25 [A]
Keygrip = ''1531C8084D16DC4C36911F1585AF0ACE7AAFD7E7''
}}

Then edit {{ic|sshcontrol}} like this. Adding the keygrip is a one-time action; you will not need to edit the file again, unless you are adding additional keys.

{{hc|$GNUPGHOME/sshcontrol|
''1531C8084D16DC4C36911F1585AF0ACE7AAFD7E7''
}}

== スマートカード ==

{{Note|{{Pkg|pcsclite}} と {{Pkg|libusb-compat}} をインストールして、{{ic|pcscd.service}} サービスを [[systemd#ユニットを使う|systemd]] で実行する必要があります。}}

GnuPG はスマートカードリーダーのインターフェイスとして ''scdaemon'' を使います。詳しくは [[man ページ]]を参照してください。

=== GnuPG のみ設定 ===

GnuPG ベース以外のカードを使う予定がない場合は、{{ic|~/.gnupg/scdaemon.conf}} の {{Ic|reader-port}} パラメータを確認してください。'0' が最初に利用できるシリアルポートリーダーを、'32768' (デフォルト) が最初の USB リーダーを示しています。

=== GnuPG と OpenSC ===

opensc ドライバーであらゆるスマートカードを使う場合は (例: いろいろな国の ID カード)、GnuPG の設定に注意する必要があります。何も設定をしていないと {{Ic|gpg --card-status}} を使った時に以下のようなメッセージが表示されることがあります:

gpg: selecting openpgp failed: ec=6.108

デフォルトでは、scdaemon はデバイスに直接接続しようとします。リーダーが他のプロセスによって使用中だとこの接続は失敗します。例えば: OpenSC によって使用される pcscd デーモン。この状況に対処するには、opensc と同じ基盤のドライバーを使って一緒に動作できるようにする必要があります。scdaemon に pcscd を使用させるため、{{ic|~/.gnupg/scdaemon.conf}} から {{Ic|reader-port}} を削除して、{{ic|libpcsclite.so}} ライブラリの場所を指定し、ccid を無効化してください:

{{hc|~/.gnupg/scdaemon.conf|<nowiki>
pcsc-driver /usr/lib/libpcsclite.so
card-timeout 5
disable-ccid
</nowiki>}}

OpenSC を使わない場合は {{man|1|scdaemon}} をチェックしてください。

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

=== 他のアルゴリズム ===

強力なアルゴリズムを使用したい場合:

{{hc|~/.gnupg/gpg.conf|
...

personal-digest-preferences SHA512
cert-digest-algo SHA512
default-preference-list SHA512 SHA384 SHA256 SHA224 AES256 AES192 AES CAST5 ZLIB BZIP2 ZIP Uncompressed
personal-cipher-preferences TWOFISH CAMELLIA256 AES 3DES
}}

GnuPG の最新版では、デフォルトのアルゴリズムとして SHA256 と AES が使われており、どちらも殆どの場合安全です。しかしながら、2.1 以前の古い GnuPG を使っている場合や、さらに高いセキュリティを求めたい場合、上記のように設定するようにしてください。

=== パスワードの暗号化 ===

{{Tip|[[pass]] は以下の作業を自動化します。}}

パスワードを暗号化すれば、設定ファイルに平文で書き込まれなくなります。メールのパスワードなどが良い例でしょう。

まずパスワードを記述したファイルを作成してください。パスワードの後に空行を'''一行'''だけ追加しておく必要があります。そうしないとファイルを評価するときに gpg がエラーメッセージを返します。

そして次を実行:

$ gpg -e -a -r ''<user-id>'' ''your_password_file''

{{ic|-e}} は encrypt、{{ic|-a}} は armor (ASCII 出力)、{{ic|-r}} は受取人のユーザー ID です。

新しく {{ic|''your_password_file''.asc}} ファイルが作られます。

=== 鍵の無効化 ===

{{Warning|
*無効化証明書にアクセスできれば誰でも鍵を無効化して、利用できなくすることができてしまいます。
*鍵を無効化するのは、鍵が解読されたり消失したり、あるいはパスフレーズを忘れた場合にのみ行なってください。}}

新しい鍵を生成すると無効化証明書が自動的に生成されます。ユーザーが手動で後から生成することも可能です。無効化証明書は {{ic|~/.gnupg/openpgp-revocs.d/}} に存在します。証明書のファイル名は無効化する鍵のフィンガープリントになります。

鍵を無効化したい場合、無効化証明書をインポートするだけです:

$ gpg --import ''<fingerprint>''.rev

そして鍵サーバーをアップデート:

$ gpg --keyserver subkeys.pgp.net --send-keys ''<userid>''

=== 信頼モデルの変更 ===

デフォルトでは GnuPG は信頼モデルとして [[Wikipedia:Web of Trust|Web of Trust]] を使います。Web of Trust から [[Wikipedia:Trust on First|Trust on First]] に変更することが可能です。鍵を追加するときに {{ic|1=--trust-model=tofu}} を追加するか GnuPG の設定ファイルにオプションを追加してください。詳細は [https://lists.gnupg.org/pipermail/gnupg-devel/2015-October/030341.html GnuPG メーリングリストのメール] を参照。

=== 受取人の id を全て隠す ===

デフォルトでは暗号メッセージには受取人の鍵 ID が含まれます。{{ic|hidden-recipient ''<user-id>''}} を使うことで暗号化するときに ID は削除することが可能です。全ての受取人で ID を削除するには設定ファイルに {{ic|throw-keyids}} を追加してください。この設定によってメッセージの受取人を隠すことができ、トラフィックの解析に対抗することができます (ソーシャルエンジニアリングを使うことでメッセージを復号化できてしまえば誰が受取人なのか確認される可能性があります)。欠点としては、暗号鍵を全て試すことになるので復号化が遅くなります ({{ic|--try-secret-key ''<user-id>''}})。

=== キーサインパーティで caff を使う ===

鍵サーバーやキーリングにある鍵の正当性をユーザーが確認 (つまり鍵の持ち主が本人であることを確認) できるように、PGP/GPG はいわゆる信頼の輪 ("Web of Trust") を利用しています。信頼の輪を維持するために様々なハッカーイベントが開かれており、キーサインパーティはそのひとつです。[[Wikipedia:Zimmermann–Sassaman key-signing protocol|Zimmermann-Sassaman]] 鍵署名プロトコルはキーサインパーティを効果的に行うための方式です。[http://www.cryptnet.net/fdp/crypto/keysigning_party/en/keysigning_party.html こちら] にハウツー記事があります。

キーサインパーティの後、鍵に署名したり所有者に署名を送るのを簡略化するために、''caff'' というツールを使うことができます。AUR のパッケージ {{AUR|caff-svn}} でインストールすることができます。

所有者に署名を送信するには [[Wikipedia:ja:メール転送エージェント|MTA]] が必要です。MTA を設定していない場合、[[msmtp]] をインストールして下さい。

=== 長い ID やフィンガープリントを毎回表示する ===

長い鍵 ID を表示させるには設定ファイルに {{ic|keyid-format 0xlong}} を追加してください。鍵の指紋を完全に表示するには、設定ファイルに {{ic|with-fingerprint}} を追加してください。

=== カスタム機能 ===

鍵にカスタム機能を設定することができます。以下の機能を使うことが可能です:

* Certify (マスター鍵のみ) - 副鍵の作成ができるようになります。
* Sign - 公開鍵で検証することができる暗号化署名が作成可能になります。
* Encrypt - 公開鍵でデータを暗号化して、秘密鍵で復号化することができます。
* Authenticate - GnuPG 以外のプログラムで鍵を使って認証できます。SSH 鍵として使用することができるようになります。

マスター鍵の機能は以下のコマンドで指定できます:

$ gpg --full-generate-key --expert

オプションを選択して機能を設定することができます。

副鍵にカスタム機能を指定したい場合、{{ic|gpg --edit-key}} に {{ic|--expert}} フラグを追加してください。詳しくは[[#鍵の編集]]を参照。

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

=== Not enough random bytes available ===
鍵を生成するときに、gpg は以下のエラーを表示することがあります:
Not enough random bytes available. Please do some other work to give the OS a chance to collect more entropy!
残っているエントロピーを確認するには、カーネルパラメータをチェックしてください:
$ cat /proc/sys/kernel/random/entropy_avail

エントロピーがたくさんある健康的な Linux 環境ならマックスの 4,096 ビットに近い値が返されます。返ってくる値が 200 以下の場合、システムのエントロピーが足りていません。

エントロピー問題を解決するには、メッセージ通りのことをするのがベストです (例: ディスクを動かす、マウスを動かす、wiki を編集する - 何でもエントロピーの生成に繋がります)。それでも問題が解決しない場合、エントロピーを使い果たしているサービスが何なのかチェックして、しばらくそのサービスを停止してみてください。サービスを停止できない場合、[[乱数生成#高速な RNG]] を見て下さい。

=== su ===

{{Ic|pinentry}} を使う場合、使用するターミナルデバイス (例: {{Ic|/dev/tty1}}) の適切なパーミッションが必要です。しかしながら、''su'' (または ''sudo'') を使用すると、所有権は元のユーザーに残り、新しいユーザーにはなくなります。これでは pinentry はたとえ root であっても起動しません。pinentry を使用する (つまりエージェントで gpg を使用する) 前にデバイスのパーミッションを同じ所に変更する必要があります。root で gpg を実行する場合、gpg を使用する直前に所有者を root に変更してください:

# chown root /dev/ttyN # where N is the current tty

そして gpg を使用した後に元に戻して下さい。おそらく {{Ic|/dev/pts/}} と同じのが正しいです。

{{Note|tty の所有者が pinentry を実行しているユーザーと一致している必要があります。{{Ic|tty}} グループに属しているだけでは不十分です。}}

{{Tip|{{ic|script}} で gpg を実行した場合、新しい tty が適切な所有権で使われます:

# script -q -c "gpg --gen-key" /dev/null
}}

=== エージェントがファイルの終末についてエラーを表示する ===

デフォルトの pinentry プログラムは pinentry-gtk-2 であり、D-Bus セッションバスを正しく実行する必要があります。詳しくは[[一般的なトラブルシューティング#セッションのパーミッション]]を見て下さい。

もしくは、{{ic|pinentry-qt}} を使うこともできます。[[#pinentry]] を参照。

=== KGpg 設定のパーミッション ===

{{Pkg|kgpg}} には {{ic|~/.gnupg/}} のオプションが使えないという問題がありました。非推奨となった ''options'' ファイルが原因です。[https://bugs.kde.org/show_bug.cgi?id=290221 バグ] レポートを参照してください。

=== GNOME on Wayland で SSH エージェントのソケットが上書きされる ===

Wayland のセッションでは、{{Ic|gnome-session}} によって {{Ic|SSH_AUTH_SOCK}} が標準の gnome-keyring ソケット {{Ic|$XDG_RUNTIME_DIR/keyring/ssh}} に設定されます。このため {{Ic|~/.pam_environmment}} や systemd のユニットファイルで設定した値が上書きされてしまいます。

この挙動を無効化するには {{Ic|GSM_SKIP_AGENT_WORKAROUND}} 変数を設定してください:

{{hc|~/.pam_environment|2=
SSH_AGENT_PID DEFAULT=
SSH_AUTH_SOCK DEFAULT="${XDG_RUNTIME_DIR}/gnupg/S.gpg-agent.ssh"
GSM_SKIP_SSH_AGENT_WORKAROUND DEFAULT="true"
}}

=== mutt ===

Mutt は ''gpg-agent'' を正しく使用できないため、mutt を使う場合は {{ic|GPG_AGENT_INFO}} [[環境変数]]を設定する必要があります (中身は何でもかまいません)。[[#パスワードのキャッシュ|パスワードのキャッシュ]]も有効化してください。

詳しくは [https://bbs.archlinux.org/viewtopic.php?pid=1490821#p1490821 フォーラムスレッド] を参照してください。

=== gnupg バージョン 2.1 にアップグレードすると鍵が"消失"する ===

{{ic|gpg --list-keys}} を実行しても以前まで使っていた鍵が表示されない場合、また、アプリケーションが鍵を見つけられないまたは鍵が不正だとエラーを吐く場合、鍵が新しいフォーマットに移行できていない可能性があります。

[http://jo-ke.name/wp/?p=111 GnuPG invalid packet workaround] を読んで下さい。要約すると、旧式の {{ic|pubring.gpg}} と {{ic|secring.gpg}} ファイルの鍵にはバグが存在しており、新しい {{ic|pubring.kbx}} ファイルと {{ic|private-keys-v1.d/}} サブディレクトリ、そしてディレクトリのファイルによって置き換えられたということが書かれています。以下のコマンドを実行することで消失した鍵を復旧させることができるかもしれません:

$ cd
$ cp -r .gnupg gnupgOLD
$ gpg --export-ownertrust > otrust.txt
$ gpg --import .gnupg/pubring.gpg
$ gpg --import-ownertrust otrust.txt
$ gpg --list-keys

=== (鍵を受信しようとすると) どの鍵サーバーでも gpg がフリーズする ===

特定の鍵サーバーで鍵を受信しようとして gpg がフリーズしている場合、dirmngr を kill して (問題が起こっていない) 他の鍵サーバーにアクセスできるようにする必要があります。そうしないと全ての鍵サーバーでフリーズしてしまいます。

=== スマートカードが検出されない ===

スマートカードにアクセスするための権限がない場合、カードを正しく設定して接続しても、{{ic|card error}} が表示されることがあります。

スマートカードにアクセスする必要があるユーザーに {{ic|scard}} を追加することで解決できます。追加したら、以下のような [[Udev#udev ルールを記述する|udev]] ルールを作って下さい:
{{hc|/etc/udev/rules.d/71-gnupg-ccid.rules|<nowiki>
ACTION=="add", SUBSYSTEM=="usb", ENV{ID_VENDOR_ID}=="1050", ENV{ID_MODEL_ID}=="0116|0111", MODE="660", GROUP="scard"
</nowiki>}}

VENDOR と MODEL は {{ic|lsusb}} の出力にあわせて変更する必要があります。上記は YubikeyNEO の例です。

=== gpg: WARNING: server 'gpg-agent' is older than us (x < y) ===

{{ic|gnupg}} をアップグレードしたのに古い gpg-agent が動作し続けていると警告が表示されます。ユーザーの {{ic|gpg-agent.socket}} を再起動してください (再起動するときに {{ic|--user}} フラグを使ってください)。

=== IPC 接続の呼び出しに失敗 ===

{{ic|killall gpg-agent dirmngr}} と {{ic|$GNUPGHOME/crls.d/}} フォルダの権限が {{ic|700}} になっていて、{{ic|gpg-agent}} と {{ic|dirmngr}} が起動していないことを確認してください．

デフォルトでは、{{Pkg|gnupg}} パッケージは、ソケットのために {{ic|/run/user/$UID/gnupg/}} ディレクトリを使用します。[https://github.com/gpg/gnupg/blob/25ae80b8eb6e9011049d76440ad7d250c1d02f7c/README#L121-L122 GnuPG documentation] には、このディレクトリが望ましいと書かれています (すべてのファイルシステムがソケットに対応しているわけではありません)。あなたの {{ic|agent-socket}} の設定が、適切なファイルシステムを持つパスを指定しているかどうか確認してください。ic|agent-socket}} のパス設定は、 {{ic|gpgconf --list-dirs agent-socket}} を実行することで確認することができます。

{{ic|gpg-agent}} が正常に起動するか、{{ic|gpg-agent --daemon}} でテストしてください。

=== 汚染された PGP 証明書の軽減 ===

2019 年 6 月、未知の攻撃者が数万（または数十万）の署名を持つ複数の高プロファイル PGP 証明書をスパム送信し（CVE-2019-13050）、これらの署名を SKS 鍵サーバーにアップロードしていました。
これらの汚染された証明書がキーリングに存在すると、gpg は以下のメッセージを表示してハングします。

gpg: removing stale lockfile (created by 7055)

この場合、[https://tech.michaelaltfield.net/2019/07/14/mitigating-poisoned-pgp-certificates/ ブログポスト]にあるように、汚染された証明書を削除することで軽減できる可能性があります。

=== IPC 応答が無効であり、デバイスの ioctl が不適切 ===

デフォルトの pinentry プログラムは、{{ic|/usr/bin/pinentry-gtk-2}} です。{{Pkg|gtk2}} が使用できない場合、pinentry は{{ic|/usr/bin/pinentry-curses}}にフォールバックし、署名に失敗します。

gpg: signing failed: Inappropriate ioctl for device
gpg: [stdin]: clear-sign failed: Inappropriate ioctl for device

pinentry プログラム {{ic|/usr/bin/pinentry-tty}} と {{ic|/usr/bin/pinentry-curses}} を使用するには、環境変数 {{ic|GPG_TTY}} を設定する必要があります。

$ export GPG_TTY=$(tty)

=== キーブロックのリソースが存在しません ===

鍵をインポートしようとしたときに、このようなエラーが発生した場合、

gpg: keyblock resource '''gnupg_home''/pubring.kbx': No such file or directory

これは GnuPG がホームディレクトリを作成しないためです。単に手動で作成してください。

$ mkdir -m 700 ''gnupg_home''

== 参照 ==

* [https://gnupg.org/ GNU Privacy Guard ホームページ]
* [https://futureboy.us/pgp.html Alan Eliasen's GPG Tutorial]
* [[RFC:4880|RFC 4880]] — "OpenPGP Message Format"
* [https://help.riseup.net/en/security/message-security/openpgp/gpg-best-practices gpg.conf recommendations and best practices]
* [[Fedora:Creating GPG Keys]]
* [[Debian:Subkeys]]
* [https://github.com/lfit/itpol/blob/master/protecting-code-integrity.md Protecting code integrity with PGP]
* [https://sanctum.geek.nz/arabesque/series/gnu-linux-crypto/ A more comprehensive gpg Tutorial]
* [https://www.reddit.com/r/GPGpractice/ /r/GPGpractice - a subreddit to practice using GnuPG.]

利用者:Shota

2023-01-04T00:57:23Z

Shota: 運用している計算機のリストの更新

== 自己紹介 ==
普段から Arch Linux を使っているので、何か Arch community に貢献できればと思っています。

== 計算機環境 ==

Archlinux で運用しているもののみ記載。

* Main PC: [[Lenovo_ThinkPad_X1_Extreme]].
* その他
** [[Lenovo_ThinkPad_X230]]
** Fujitsu ESPRIMO
** Raspberry Pi 2B+, 1
** VPS いくつか

== Tips ==
* <s>ThinkPad におけるトラックポイントの速さの変更方法: [https://askubuntu.com/questions/37824/what-is-the-best-way-to-configure-a-thinkpads-trackpoint ask ubuntu のフォーラムより]</s> -> [[トラックポイント]]。

トランスポート層セキュリティ

2023-01-02T03:37:11Z

Shota: /* 信頼管理 */ 英語版に合わせて管理方法のいくつかの例を追加。英語版からの翻訳。

[[Category:Transport Layer Security]]
[[en:Transport Layer Security]]
[[Wikipedia:ja:Transport Layer Security|Wikipedia]] より:
:'''Transport Layer Security''' ('''TLS''') およびその前身の [[RFC:7568|Secure Sockets Layer]] ('''SSL''') はコンピュータネットワークにおいてセキュリティを要求される通信を行うためのプロトコルである。ウェブブラウザやメール、インスタントメッセージ、voice over IP (VoIP) などのアプリケーションで幅広く使われているプロトコルとなっている。ウェブサイトは TLS によってサーバーとウェブブラウザ間の通信を暗号化できる。

== 実装 ==

TLS の実装は 5 種類あり、[[公式リポジトリ]]で公開されています。OpenSSL は base メタパッケージの間接的な依存関係であるため、すでにシステムにインストールされているはずです({{Pkg|base}} > {{Pkg|coreutils}} > {{Pkg|openssl}})。GnuTLS は多くのパッケージで必要とされているため、すでにシステムにインストールされている可能性があります。

* {{App|[[OpenSSL]]|堅牢・商業品質・フル機能の TLS と SSL プロトコルのツールキット。汎用の暗号ライブラリでもあります。|https://www.openssl.org/|{{Pkg|openssl}}}}
* {{App|[[GnuTLS]]|TLS, SSL, DTLS プロトコルのフリーソフトウェア実装。X.509, PKCS #12, OpenPGP などの API を提供します。|https://www.gnutls.org/|{{Pkg|gnutls}}}}
* {{App|[[Network Security Services]] (NSS)|TLS/SSL と [[Wikipedia:S/MIME|S/MIME]] をサポートする暗号ライブラリの実装。TLS アクセラレーションとスマートカードもサポート。|https://firefox-source-docs.mozilla.org/security/nss/index.html|{{Pkg|nss}}}}
* {{App|[[mbed TLS]]|ポータブルな SSL/TLS 実装。別名 PolarSSL。|https://tls.mbed.org/|{{Pkg|mbedtls}}}}
* {{App|[[Wikipedia:ja:LibreSSL|LibreSSL]]|OpenBSD プロジェクトによって2014年に OpenSSL からフォークされた TLS/crypto スタック。コードベースを近代的に改修してセキュリティを向上させることを目標としています。|https://www.libressl.org/|{{Pkg|libressl}}}}

== 認証局 ==

TLS では、一連の[[Wikipedia:Certificate authority|認証局]]（CA）の 1 つが、サーバーからの[[Wikipedia:public key certificate|公開鍵証明書]]の信頼性をチェックし署名します。TLS でサーバーに接続するクライアントは、CA の電子署名を通じて、その証明書の信頼性を確認することができます。電子署名を確認するために、クライアントは、別の経路から取得し自己署名証明書として保存された CA の公開鍵を持っている必要があります。Arch Linux では CA 証明書のデフォルトセットは {{Pkg|ca-certificates}} パッケージで提供されています。

{{Note|現在、Arch Linux は [[MozillaWiki:CA|Mozilla CA Certificate Store]] からの CA 証明書をデフォルトセットとして使用しています。}}

Arch Linux は CA 証明書を管理するために、システム全体の集中化されたインターフェースを提供します。このインターフェースは {{Pkg|libp11-kit}} パッケージの {{ic|/usr/lib/pkcs11/p11-kit-trust.so}} というライブラリで、証明書のための [[Wikipedia:PKCS 11|PKCS #11]] API を提供し、{{ic|/usr/share/ca-certificates/trust-source/}} ("Default Trust" トークン) と {{ic|/etc/ca-certificates/trust-source/}} ("System Trust" トークン) に格納されています。

コマンドラインからインターフェースを使用するために、{{Pkg|p11-kit}} パッケージは {{man|1|trust}} ユーティリティを提供します。

CA 証明書の管理に独自の論理を使用しており [[Wikipedia:PKCS 11|PKCS #11]] に移植されていないライブラリのために、{{Pkg|ca-certificates-utils}} パッケージは {{man|8|update-ca-trust}} スクリプトを提供し、集中管理インタフェースを通して得られた CA 証明書を {{ic|/etc/ca-certificates/extracted/}} と {{ic|/etc/ssl/certs/}} にコピーします。

=== CA 証明書のデフォルトセットをロードするためのメカニズムの概要 ===

{| class="wikitable"
! 実装 !! メカニズム !! Arch Linux 設定
|-
| [[OpenSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供する{{man|3|SSL_CTX_set_default_verify_paths}}。
| デフォルトファイルは {{ic|/etc/ssl/cert.pem}} です。デフォルトディレクトリは {{ic|/etc/ssl/certs/}} です。
|-
| [[GnuTLS]]
| ハードコードされたディレクトリ、ファイル、または[https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS 11|PKCS #11]] モジュールから証明書をロードする API 関数を提供する。最後のケースでは、ハードコードされた [[RFC:7512|URL]] によって、任意の信頼できる証明書、または {{ic|trust-policy: yes}} とマークされたモジュール上の信頼できる CA 証明書、オプションで追加のフィルタリング基準を持つ証明書をロードすることができます[https://www.gnutls.org/manual/gnutls.html#Installing-for-a-software-distribution], [https://www.gnutls.org/manual/gnutls.html#Certificate-credentials]。
| [https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS11|PKCS #11]] モジュールから、{{ic|trust-policy: yes}} でマークされた、信頼できるすべての CA 証明書をロードします。
|-
| [[Network Security Services]]
| 専用の API で管理されている [[Wikipedia:PKCS11|PKCS#11]] モジュールの動的に構成されたリストから証明書を自動的にロードします。構成は、ユーザーが指定した任意のディレクトリに保存できます。 [https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/PKCS11/FAQ], {{man|1|modutil}}.
|
|-
| [[mbed TLS]]
| ユーザーは証明書をロードする必要があります。 [https://tls.mbed.org/kb/how-to/mbedtls-tutorial].
|
|-
| [[Wikipedia:LibreSSL|LibreSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供します。 {{man|3|libressl-SSL_CTX_load_verify_locations}}
|デフォルトのファイルは {{ic|/etc/libressl/cert.pem}} で、デフォルトのディレクトリは {{ic |/etc/libressl/certs/}} です。
|}

{{Note| 現在、[[Wikipedia:LibreSSL|LibreSSL]] は独自の CA 証明書のリストを使っています。詳細は {{Bug|69298}} を参照して下さい。}}

== 信頼管理 ==

信頼管理のために {{man|1|trust}} というユーティリティが提供されています。 {{ic|trust-policy: yes}} と設定され {{ic|priority:}} の設定と共に保存されている [[Wikipedia:PKCS 11|PKCS #11]] モジュールのリストを元に動作します。モジュールの設定の詳細については {{man|5|pkcs11.conf}} を参照して下さい.

{{Note| [[Wikipedia:PKCS 11|PKCS #11]] インターフェースをサポートしていないライブラリーでの管理状態を修正した場合、毎回 {{man|8|update-ca-trust}} を実行して下さい。}}

{{Tip|{{man|1|p11tool}} や {{man|1|pkcs11-tool}} といった [[Wikipedia:PKCS 11|PKCS #11]] モジュールの操作のための、統合的なツールを使って管理する事も可能です。}}

=== 信頼された証明書のリスト ===

$ trust list

=== 信頼された証明書のリストへ追加する方法 ===

# trust anchor ''certificate.crt''

証明書は、 [https://github.com/p11-glue/p11-kit/blob/master/doc/internal/persist-format.txt persistence] フォーマットあるいは、 DER や PEM フォーマット ('''OpenSSL''' がサポートする ''trusted certificate'' フォーマットを含む) でリストされている必要があります。このコマンドは、証明書をモジュールリストの一番始めの書き込み可能なトークンとして追加します。

{{Warning|この方法はシステムの全ユーザが秘密鍵にアクセスする事を可能とし、TLS トラフィックの傍受ができ得る状態になります。詳細は [[プロキシサーバー#HTTPS MITM プロキシ|HTTPS MITM プロキシ]] を参照して下さい。}}

=== 信頼された証明書のリストからの削除 ===

$ trust anchor --remove 'pkcs11:id=''%00%11%22%33%44%55%66%77%88%99%AA%BB%CC%DD%EE%FF%00%11%22%33'';type=cert'

=== デフォルトの証明書リストの上書き ===

{{ic|/usr/share/ca-certificates/trust-source/}} にある証明書のトークンは書き込み制限が掛けられているため、デフォルトの証明書を無効化するためには次の様なコマンドを使います:

$ trust extract --format=pem-bundle --filter='pkcs11:id=''%00%11%22%33%44%55%66%77%88%99%AA%BB%CC%DD%EE%FF%00%11%22%33'';type=cert' /etc/ca-certificates/trust-source/blocklist/untrusted_authority.pem

== 証明書を取得 ==

最初に RSA 秘密鍵を生成してください。鍵を生成する前に、[[umask]] でファイルモード作成マスクを制限的に (例えば {{ic|077}}) 設定してください。

{{Note|{{Pkg|openssl}} パッケージは他のディストリビューションと違って {{ic|/etc/ssl/private}} ディレクトリを保護しません。{{Bug|43059}} を参照。}}

証明書は [[Wikipedia:Certificate signing request|証明書署名要求]] (CSR) を使って認証局から取得するか、あるいは [[Wikipedia:Self-signed certificate|自己署名]] することができます。自己署名証明書は簡単に生成できますが、クライアントはデフォルトでは拒否するため、自己署名証明書を信頼するようにクライアントを設定する必要があります。

実際の生成コマンドは以下の実装の記事を見てください:

* [[OpenSSL]]
* [[GnuTLS#使用方法]]
* [[Network Security Services]]
* [[mbed TLS#使用方法]]

{{Tip|[[#ACME クライアント|ACME]] を使うことで [https://letsencrypt.org/ Let's Encrypt] 認証局からフリーの証明書を取得できます。}}

== サーバーサイドの推奨事項 ==

[[Wikipedia:ja:Transport Layer Security#TLS/SSLの既知の脆弱性|TLS に対する攻撃]] は多数存在するため、ベストプラクティスに注意してください:

* [https://disablessl3.com/ SSLv3 を無効化] することで [[Wikipedia:POODLE|POODLE]] 攻撃を防ぐ。
* [https://weakdh.org/sysadmin.html weakdh.org の TLS の Diffie-Hellman デプロイガイド]
* [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla による Server Side TLS の記事]
* [https://github.com/ssllabs/research/wiki/SSL-and-TLS-Deployment-Best-Practices SSL Labs の SSL と TLS デプロイベストプラクティス]
* [https://cipherli.st/ Cipherli.st]

=== TLS のチェック ===

TLS をチェックするプログラム:

* {{Pkg|testssl.sh}}
* [[Nmap]]
* [[OpenSSL]]
* [https://github.com/mozilla/cipherscan cipherscan]

TLS をチェックするウェブサイト:

* https://dev.ssllabs.com/ssltest/ (HTTPS のみ)
* https://www.checktls.com/ (メールのみ)
* https://www.htbridge.com/ssl/ (任意ポート)
* https://tls.imirhil.fr/tls (任意ポート)

== その他 ==

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

[[Wikipedia:ja:Automated Certificate Management Environment|Automated Certificate Management Environment]] (ACME) プロトコルは [[Let's Encrypt]] などの [[Wikipedia:ja:認証局|認証局]] から X.509 証明書をリクエストできるプロトコルです。

[https://letsencrypt.org/docs/client-options/ ACME クライアントの一覧] も参照してください。

* {{App|acme-client|C で書かれたセキュアな Let's Encrypt クライアント。|https://kristaps.bsd.lv/acme-client/|{{AUR|acme-client}}{{Broken package link|パッケージが存在しません}}}}
* {{App|acme-tiny|Let's Encrypt から TLS 証明書を作成・更新するための200行の Python スクリプト。|https://github.com/diafygi/acme-tiny|{{Pkg|acme-tiny}}}}
* {{App|acme.sh|Unix シェルスクリプトだけで作られた ACME クライアント。|https://github.com/Neilpang/acme.sh|{{AUR|acme.sh-git}}}}
* {{App|acmetool|Go で書かれた使いやすい ACME CLI。|https://github.com/hlandau/acme|{{AUR|acmetool}}, {{AUR|acmetool-git}}}}
* {{App|[[Certbot]]|Python で書かれた、Let's Encrypt によって推奨されている ACME クライアント。|https://github.com/certbot/certbot|{{Pkg|certbot}}}}
* {{App|dehydrated|Bash で書かれた ACME クライアント。|https://github.com/lukas2511/dehydrated|{{Pkg|dehydrated}}, {{AUR|dehydrated-git}}}}
* {{App|getssl|Bash で書かれた ACME クライアント。|https://github.com/srvrco/getssl|{{AUR|getssl}}, {{AUR|getssl-git}}}}
* {{App|lego|Go で書かれた Lets Encrypt クライアントと ACME ライブラリ。|https://github.com/xenolf/lego|{{AUR|lego-git}}}}
* {{App|letsencrypt-cli|もうひとつの Letsencrypt (ACME) クライアント。Ruby を使用。|https://github.com/zealot128/ruby-acme-cli|{{AUR|letsencrypt-cli}}}}
* {{App|manuale|完全手動の Let's Encrypt クライアント。Python で書かれています。|https://github.com/veeti/manuale|{{AUR|manuale}}}}
* {{App|ruby-acme-client|letsencrypt の ACME プロトコルの Ruby クライアント。|https://github.com/unixcharles/acme-client|{{AUR|ruby-acme-client}}}}
* {{App|simp_le|シンプルな Let's Encrypt クライアント。Python で書かれています。|https://github.com/zenhack/simp_le|{{AUR|simp_le-git}}}}

オンラインのインタラクティブな、https://gethttpsforfree.com クライアントでは、ウェブページからシェルコマンドラインにコピーペーストして、10 回ほどやり直す必要があります。その間に推奨されるコマンドを実行します。また、おそらくそのページで手動更新をしなければならないでしょう。あるいは、他の方法で更新を行う必要があります。一方、あなたは、それが成功したかどうか、すべてのステップで見ることができます。証明書を要求するためだけにソフトウェアをインストールする必要はありません。そして、秘密鍵やサーバー・ソフトウェアを、完全に意識的にしか触れないようにすることができるようになります。

=== OCSP ===

[[Wikipedia:ja:Online Certificate Status Protocol|Online Certificate Status Protocol]] (OCSP) は [[Firefox]] によってサポートされています。[[Chromium]] は独自のメカニズムを備えています [http://dev.chromium.org/Home/chromium-security/crlsets]。

GnuTLS の {{man|1|ocsptool}} や OpenSSL の {{man|1ssl|ocsp}} も参照。

=== HSTS ===

[[Wikipedia:ja:HTTP Strict Transport Security|HTTP Strict Transport Security]] (HSTS) メカニズムは Firefox, Chromium, [[wget]] ({{ic|~/.wget-hsts}}) によってサポートされています。

=== DNS CAA ===

See [[Wikipedia:DNS Certification Authority Authorization]].

== 参照 ==

* [https://wiki.gentoo.org/wiki/Certificates Gentoo:Certificates]
* [https://www.happyassassin.net/2015/01/12/a-note-about-ssltls-trusted-certificate-stores-and-platforms/ A note about SSL/TLS trusted certificate stores, and platforms (OpenSSL and GnuTLS)]

プロキシサーバー

2023-01-02T03:36:42Z

Shota: 英語版に合わせて /* HTTPS MITM プロキシ */ を追加。

[[Category:プロキシサーバー]]
[[Category:ネットワーク設定]]
[[en:Proxy settings]]
[[es:Proxy settings]]
{{Related articles start}}
{{Related|HTTP トンネリング}}
{{Related articles end}}

プロキシはリモートの、資源を消費する、または直接使うのが難しいサービスのためのインターフェイスです。ソース: [http://en.wiktionary.org/wiki/proxy Proxy - Wiktionary]。

== HTTPS MITM プロキシ ==

HTTPS 接続をデバッグする際、ブラウザの外で通信を監視できると便利な場合があります。TLS MITM で傍受するためには、ブラウザやシステムにおけるプロキシの [[Transport_Layer_Security#認証局|認証局]] の信頼情報を登録する必要があります。

* {{App|Charles|Javaで書かれたグラフィカルな試用版ソフト。|https://www.charlesproxy.com/|{{AUR|charles}}}}
* {{App|Fiddler|Mono 上で動くプロプライエタリでグラフィカルなツール。|https://www.telerik.com/fiddler|{{AUR|fiddler}}}}
* {{App|microsocks|C言語で書かれたシンプルな SOCKS5 プロキシサーバー。|https://github.com/rofl0r/microsocks|{{Pkg|microsocks}}}}
* {{App|mitmproxy|Pythonで書かれたコマンドラインとウェブインターフェース。APIも提供しています。|https://mitmproxy.org/|{{Pkg|mitmproxy}}}}
* {{App|sslsplit|TLS 接続に対して汎用的に動作するプロキシ。しかしブラウザにおける HTTP プロキシとしては使えません。C言語で書かれています。|https://www.roe.ch/SSLsplit|{{Pkg|sslsplit}}}}

==環境変数==
([[wget]] など) いくつかのプログラムは "protocol_proxy" という形式の環境変数を使って特定のプロコトルのプロキシを決定します (例: HTTP, FTP, ...)。

以下はそれらの変数をシェルで設定する方法の例です:

{{bc|<nowiki>
export http_proxy=http://10.203.0.1:5187/
export https_proxy=$http_proxy
export ftp_proxy=$http_proxy
export rsync_proxy=$http_proxy
export no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com"</nowiki>}}

プログラムによっては大文字の環境変数を使用することがあります。

プロキシ環境変数を全てのユーザーと全てのアプリケーションで使えるようにするために、上記の export コマンドをスクリプトに追加することができます。例えば {{ic|/etc/profile.d/}} に "proxy.sh" を作成。スクリプトには実行可能属性を付与してください。この方法はプロクシ設定のオプションが存在しない [[Xfce]] などのデスクトップ環境を使ってる場合に便利です。例えば、[[Chromium]] ブラウザは Xfce の実行中、この方法を使って設定されて変数を利用します。

システム全体でプロキシを簡単に設定できることを標榜している [https://github.com/himanshub16/ProxyMan ProxyMan] という名前のツールも存在します。[[Git]], [[npm]], [[Dropbox]] などのソフトウェアのプロキシ設定も管理されます。Alan Pope によるスクリプトに影響を受けています。

また、{{ic|.bashrc}} に関数を追加することで変数の切り替えを自動化することも可能です (スクリプトのアイデアは Alan Pope):
<nowiki>
function proxy_on() {
export no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com"

if (( $# > 0 )); then
valid=$(echo $@ | sed -n 's/$[0-9]\{1,3\}.$\{4\}:$[0-9]\+$/&/p')
if [[ $valid != $@ ]]; then
>&2 echo "Invalid address"
return 1
fi

export http_proxy="http://$1/" \
https_proxy=$http_proxy \
ftp_proxy=$http_proxy \
rsync_proxy=$http_proxy
echo "Proxy environment variable set."
return 0
fi

echo -n "username: "; read username
if [[ $username != "" ]]; then
echo -n "password: "
read -es password
local pre="$username:$password@"
fi

echo -n "server: "; read server
echo -n "port: "; read port
export http_proxy="http://$pre$server:$port/" \
https_proxy=$http_proxy \
ftp_proxy=$http_proxy \
rsync_proxy=$http_proxy \
HTTP_PROXY=$http_proxy \
HTTPS_PROXY=$http_proxy \
FTP_PROXY=$http_proxy \
RSYNC_PROXY=$http_proxy
}

function proxy_off(){
unset http_proxy https_proxy ftp_proxy rsync_proxy \
HTTP_PROXY HTTPS_PROXY FTP_PROXY RSYNC_PROXY
echo -e "Proxy environment variable removed."
}</nowiki>

ユーザー名やパスワードが必要ない場合は削除してください。

別の手段として、以下のスクリプトを使うこともできます。"YourUserName", "ProxyServerAddress:Port", "LocalAddress", "LocalDomain" の文字列を置き換えてから、{{ic|~/.bashrc}} を編集して関数を含めて下さい。新しい bash ウィンドウでは自動的に新しい関数が使えます。既存の bash ウィンドウでは、{{ic|source ~/.bashrc}} と入力して下さい。{{ic|.bashrc}} に全てを記述するのではなく、{{ic|functions}} などの別のファイルに関数の定義を記述して {{ic|.bashrc}} に {{ic|source functions}} を追加することもできます。また、"myProxy" はもっと短く書くことができます。

<nowiki>
#!/bin/bash

assignProxy(){
PROXY_ENV="http_proxy ftp_proxy https_proxy all_proxy HTTP_PROXY HTTPS_PROXY FTP_PROXY ALL_PROXY"
for envar in $PROXY_ENV
do
export $envar=$1
done
for envar in "no_proxy NO_PROXY"
do
export $envar=$2
done
}

clrProxy(){
PROXY_ENV="http_proxy ftp_proxy https_proxy all_proxy HTTP_PROXY HTTPS_PROXY FTP_PROXY ALL_PROXY"
for envar in $PROXY_ENV
do
unset $envar
done
}

myProxy(){
user=YourUserName
read -p "Password: " -s pass && echo -e " "
proxy_value="http://$user:$pass@ProxyServerAddress:Port"
no_proxy_value="localhost,127.0.0.1,LocalAddress,LocalDomain.com"
assignProxy $proxy_value $no_proxy_value
}</nowiki>

===sudo でもプロキシを使う===

プロキシ環境変数を (手動コマンドや .bashrc で) 単一のユーザーでのみ設定した場合、[[sudo]] でコマンドを実行するとプロキシ設定は失われます (もしくは [[yaourt]] などのプログラムで sudo を内部的に使用した場合)。

sudo の設定ファイル (visudo で編集できます) に次の行を追加することでプロキシ設定を通すことができます:

<nowiki>Defaults env_keep += "http_proxy https_proxy ftp_proxy"</nowiki>

rsync_proxy や no_proxy など他の環境変数を追加することも可能です。

===ネットワークマネージャによる自動化===
*[[NetworkManager]] は環境変数を変更することができません。
*[[netctl]] は環境変数を設定することはできますが、netctl の子供ではない他のアプリケーションから変数を参照することはできません。

==libproxy について==
[https://code.google.com/p/libproxy/ libproxy] (extra リポジトリに入っています) はネットワークリソースにアクセスする全てのアプリケーションによって使われることを目指している抽象レイヤーです。開発中ですが、広く採用されたら、GNU/Linux における統合的な自動プロキシ管理が実現するでしょう。

libproxy の役割は様々なソースからプロキシ設定を読み込んで、ライブラリを使用するアプリケーションから使えるようにすることです。libproxy の面白いところは [[wikipedia:ja:Web Proxy Auto-Discovery Protocol|Web Proxy Autodiscovery Protocol]] の実装と [[wikipedia:ja:プロキシ自動設定|Proxy Auto-Config]] の実装を提供しているところです。

{{Ic|/usr/bin/proxy}} バイナリには引数として URL を指定することができ、ネットワークリソースを取得するのに使えるプロキシを返します。
{{Note|1={{ic|1={ pkg-config 'mozjs185 >= 1.8.5'; } }} が失敗するためバージョン 0.4.11 は {{ic|1=http_proxy='wpad:'}} をサポートしていません。}}

2009年4月6日現在、libproxy は libsoup に依存されています。そのため {{Pkg|midori}} ブラウザによって間接的に利用されます。

== ウェブプロキシ ==
* [[Squid]] はとても人気のあるキャッシュ/最適化プロキシです。
* [[Privoxy]] は匿名化とアドブロックを行うプロキシです。
* シンプルなプロキシが欲しい場合、ssh とポートフォワーディングを使うことができます。

=== SSH によるシンプルなプロキシ ===
以下のようにアカウント (USER) があるサーバー (HOST) に接続してください:
ssh -D PORT USER@HOST
PORT については、IANA で登録されてないポート番号を選択してください。ローカル PORT のトラフィックを指定し、リモート HOST に転送されます。ssh は [[Wikipedia:ja:SOCKS|SOCKS]] サーバーのように動作します。SOCKS プロキシサーバーをサポートしているソフトウェアを設定することで localhost の PORT に接続することができます。

==SOCKS プロキシを使う==
2つのケースが考えられます:
*使いたいアプリケーションが [[Wikipedia:ja:SOCKS#SOCKS 5プロトコル|SOCKS5]] プロキシに対応している場合 (例えば [[Firefox]])、プロキシを使うようにアプリケーションを設定するだけです。
*使いたいアプリケーションが SOCKS プロキシに対応していない場合、{{Pkg|tsocks}} や {{Pkg|proxychains-ng}} を使うことができます。

Firefox では、設定 > ネットワーク > 接続設定から SOCKS プロキシを使うことができます。"手動でプロキシを設定する" を選択して、SOCKS ホストを設定してください (HTTP プロキシや SSL プロキシなどの他のフィールドは空のままにしておいてください)。例えば、SOCKS5 プロキシが localhost のポート 8080 で動作している場合、SOCKS ホストフィールドには "127.0.0.1" と書いて、ポートには "8080" と書きます。

''proxychains-ng'' を使う場合、設定は {{ic|/etc/proxychains.conf}} で行います。最後の行をアンコメントする必要があり (デフォルトでは [[Tor]] を使うように設定されています)、SOCKS プロキシのパラメータで置き換えてください。例えば、上記と同じ SOCKS5 プロキシを使う場合、最後の行を以下のように置き換えます:
socks5 127.0.0.1 8080

''proxychains-ng'' は次のコマンドで起動できます:
proxychains <program>
<program> はシステムにインストールされているどのプログラムにも置き換えられます (例: [[xterm]], gnome-terminal など)。

''tsocks'' を使う場合、設定は {{ic|/etc/tsocks.conf}} に記述します。オプションについては {{man|5|tsocks.conf}} を見て下さい。最小限の設定ファイルは以下のようになります:
{{hc|/etc/tsocks.conf|2=
server = 127.0.0.1
server_port = 8080
server_type = 5}}

=== curl と pacman ===
{{ic|all_proxy}} 環境変数を設定することで curl と pacman で socks5 プロキシを使用できます:
{{bc|1=$ export all_proxy="socks5://your.proxy:1080"}}

==GNOME3 のプロキシ設定==
[[Chromium]] など、プログラムによっては gnome で保存された設定を優先的に使うことがあります。この設定は gnome-control-center フロントエンドや gsettings で変更することが可能です。

gsettings set org.gnome.system.proxy mode 'manual'
gsettings set org.gnome.system.proxy.http host 'proxy.localdomain.com'
gsettings set org.gnome.system.proxy.http port 8080
gsettings set org.gnome.system.proxy.ftp host 'proxy.localdomain.com'
gsettings set org.gnome.system.proxy.ftp port 8080
gsettings set org.gnome.system.proxy.https host 'proxy.localdomain.com'
gsettings set org.gnome.system.proxy.https port 8080
gsettings set org.gnome.system.proxy ignore-hosts "['localhost', '127.0.0.0/8', '10.0.0.0/8', '192.168.0.0/16', '172.16.0.0/12' , '*.localdomain.com' ]"

[[AUR]] の {{AUR|proxydriver}} パッケージを使用することで、[[NetworkManager#プロクシ設定|NetworkManager]] が特定のネットワークに接続した際に自動的に実行するように設定することもできます。

== Microsoft NTLM プロキシ ==

Windows ネットワークでは、NT LAN Manager (NTLM) がユーザーの認証や整合性、機密性を実現する Microsoft セキュリティプロトコルのサービスを提供します。

[[AUR]] の {{AUR|cntlm}} はアプリケーションと NTLM プロキシの間に入って、NTLM 認証をオンザフライで追加します。複数の "parent" プロキシを指定することができ Cntlm はどれか一つが動作するまで試行します。認証済みの接続は全てキャッシュされ効率を高めるために再利用されます。

(NTLM PROXY IP:PORT + CREDENTIALS + OTHER INFO) -----> '''(127.0.0.1:PORT)'''

=== 設定 ===

{{ic|/etc/cntlm.conf}} の設定を必要に応じて変更してください。パスワードは絶対に変更してください。それから次を実行:

$ cntlm -H

このコマンドによってプロキシのホスト名、ユーザー名、パスワードそれぞれの暗号化されたパスワードハッシュが生成されます。

{{Warning|暗号化されたハッシュではなく平文のパスワードを使っている場合、{{Pkg|ettercap}} で簡単にパスワードを盗み取ることができてしまいます。}}

{{ic|/etc/cntlm.conf}} をもう一度編集して生成された3つのハッシュを全て記述して、{{ic|cntlm.service}} を[[systemd#ユニットを使う|有効化]]してください。

設定をテストするには、次を実行:

$ cntlm -v

=== 使用方法 ===

プロキシには次のアドレスを使って下さい:

127.0.0.1:PORT

もしくは:

localhost:PORT

{{ic|PORT}} は {{ic|/etc/cntlm.conf}} の {{ic|Listen}} パラメータに合わせてください。デフォルトは {{ic|3128}} です。

トランスポート層セキュリティ

2023-01-02T02:54:05Z

Shota: /* CA 証明書のデフォルトセットをロードするためのメカニズムの概要 */ ノートを英語版から追記

[[Category:Transport Layer Security]]
[[en:Transport Layer Security]]
[[Wikipedia:ja:Transport Layer Security|Wikipedia]] より:
:'''Transport Layer Security''' ('''TLS''') およびその前身の [[RFC:7568|Secure Sockets Layer]] ('''SSL''') はコンピュータネットワークにおいてセキュリティを要求される通信を行うためのプロトコルである。ウェブブラウザやメール、インスタントメッセージ、voice over IP (VoIP) などのアプリケーションで幅広く使われているプロトコルとなっている。ウェブサイトは TLS によってサーバーとウェブブラウザ間の通信を暗号化できる。

== 実装 ==

TLS の実装は 5 種類あり、[[公式リポジトリ]]で公開されています。OpenSSL は base メタパッケージの間接的な依存関係であるため、すでにシステムにインストールされているはずです({{Pkg|base}} > {{Pkg|coreutils}} > {{Pkg|openssl}})。GnuTLS は多くのパッケージで必要とされているため、すでにシステムにインストールされている可能性があります。

* {{App|[[OpenSSL]]|堅牢・商業品質・フル機能の TLS と SSL プロトコルのツールキット。汎用の暗号ライブラリでもあります。|https://www.openssl.org/|{{Pkg|openssl}}}}
* {{App|[[GnuTLS]]|TLS, SSL, DTLS プロトコルのフリーソフトウェア実装。X.509, PKCS #12, OpenPGP などの API を提供します。|https://www.gnutls.org/|{{Pkg|gnutls}}}}
* {{App|[[Network Security Services]] (NSS)|TLS/SSL と [[Wikipedia:S/MIME|S/MIME]] をサポートする暗号ライブラリの実装。TLS アクセラレーションとスマートカードもサポート。|https://firefox-source-docs.mozilla.org/security/nss/index.html|{{Pkg|nss}}}}
* {{App|[[mbed TLS]]|ポータブルな SSL/TLS 実装。別名 PolarSSL。|https://tls.mbed.org/|{{Pkg|mbedtls}}}}
* {{App|[[Wikipedia:ja:LibreSSL|LibreSSL]]|OpenBSD プロジェクトによって2014年に OpenSSL からフォークされた TLS/crypto スタック。コードベースを近代的に改修してセキュリティを向上させることを目標としています。|https://www.libressl.org/|{{Pkg|libressl}}}}

== 認証局 ==

TLS では、一連の[[Wikipedia:Certificate authority|認証局]]（CA）の 1 つが、サーバーからの[[Wikipedia:public key certificate|公開鍵証明書]]の信頼性をチェックし署名します。TLS でサーバーに接続するクライアントは、CA の電子署名を通じて、その証明書の信頼性を確認することができます。電子署名を確認するために、クライアントは、別の経路から取得し自己署名証明書として保存された CA の公開鍵を持っている必要があります。Arch Linux では CA 証明書のデフォルトセットは {{Pkg|ca-certificates}} パッケージで提供されています。

{{Note|現在、Arch Linux は [[MozillaWiki:CA|Mozilla CA Certificate Store]] からの CA 証明書をデフォルトセットとして使用しています。}}

Arch Linux は CA 証明書を管理するために、システム全体の集中化されたインターフェースを提供します。このインターフェースは {{Pkg|libp11-kit}} パッケージの {{ic|/usr/lib/pkcs11/p11-kit-trust.so}} というライブラリで、証明書のための [[Wikipedia:PKCS 11|PKCS #11]] API を提供し、{{ic|/usr/share/ca-certificates/trust-source/}} ("Default Trust" トークン) と {{ic|/etc/ca-certificates/trust-source/}} ("System Trust" トークン) に格納されています。

コマンドラインからインターフェースを使用するために、{{Pkg|p11-kit}} パッケージは {{man|1|trust}} ユーティリティを提供します。

CA 証明書の管理に独自の論理を使用しており [[Wikipedia:PKCS 11|PKCS #11]] に移植されていないライブラリのために、{{Pkg|ca-certificates-utils}} パッケージは {{man|8|update-ca-trust}} スクリプトを提供し、集中管理インタフェースを通して得られた CA 証明書を {{ic|/etc/ca-certificates/extracted/}} と {{ic|/etc/ssl/certs/}} にコピーします。

=== CA 証明書のデフォルトセットをロードするためのメカニズムの概要 ===

{| class="wikitable"
! 実装 !! メカニズム !! Arch Linux 設定
|-
| [[OpenSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供する{{man|3|SSL_CTX_set_default_verify_paths}}。
| デフォルトファイルは {{ic|/etc/ssl/cert.pem}} です。デフォルトディレクトリは {{ic|/etc/ssl/certs/}} です。
|-
| [[GnuTLS]]
| ハードコードされたディレクトリ、ファイル、または[https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS 11|PKCS #11]] モジュールから証明書をロードする API 関数を提供する。最後のケースでは、ハードコードされた [[RFC:7512|URL]] によって、任意の信頼できる証明書、または {{ic|trust-policy: yes}} とマークされたモジュール上の信頼できる CA 証明書、オプションで追加のフィルタリング基準を持つ証明書をロードすることができます[https://www.gnutls.org/manual/gnutls.html#Installing-for-a-software-distribution], [https://www.gnutls.org/manual/gnutls.html#Certificate-credentials]。
| [https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS11|PKCS #11]] モジュールから、{{ic|trust-policy: yes}} でマークされた、信頼できるすべての CA 証明書をロードします。
|-
| [[Network Security Services]]
| 専用の API で管理されている [[Wikipedia:PKCS11|PKCS#11]] モジュールの動的に構成されたリストから証明書を自動的にロードします。構成は、ユーザーが指定した任意のディレクトリに保存できます。 [https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/PKCS11/FAQ], {{man|1|modutil}}.
|
|-
| [[mbed TLS]]
| ユーザーは証明書をロードする必要があります。 [https://tls.mbed.org/kb/how-to/mbedtls-tutorial].
|
|-
| [[Wikipedia:LibreSSL|LibreSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供します。 {{man|3|libressl-SSL_CTX_load_verify_locations}}
|デフォルトのファイルは {{ic|/etc/libressl/cert.pem}} で、デフォルトのディレクトリは {{ic |/etc/libressl/certs/}} です。
|}

{{Note| 現在、[[Wikipedia:LibreSSL|LibreSSL]] は独自の CA 証明書のリストを使っています。詳細は {{Bug|69298}} を参照して下さい。}}

== 信頼管理 ==

認証局のブラックリストを管理する方法は[[セキュリティ#SSL 証明書の管理]]を見てください。

=== システム全体で認証局を信頼 ===

{{Warning|以下のコマンドを実行すると誰でも秘密鍵にアクセスして TLS 通信を傍受できるようになります。}}

# trust anchor ''certificate''.crt

上記は [[プロキシ設定#HTTPS MITM プロキシ|HTTPS MITM プロキシ]]で通信を傍受するのに必要です。

== 証明書を取得 ==

最初に RSA 秘密鍵を生成してください。鍵を生成する前に、[[umask]] でファイルモード作成マスクを制限的に (例えば {{ic|077}}) 設定してください。

{{Note|{{Pkg|openssl}} パッケージは他のディストリビューションと違って {{ic|/etc/ssl/private}} ディレクトリを保護しません。{{Bug|43059}} を参照。}}

証明書は [[Wikipedia:Certificate signing request|証明書署名要求]] (CSR) を使って認証局から取得するか、あるいは [[Wikipedia:Self-signed certificate|自己署名]] することができます。自己署名証明書は簡単に生成できますが、クライアントはデフォルトでは拒否するため、自己署名証明書を信頼するようにクライアントを設定する必要があります。

実際の生成コマンドは以下の実装の記事を見てください:

* [[OpenSSL]]
* [[GnuTLS#使用方法]]
* [[Network Security Services]]
* [[mbed TLS#使用方法]]

{{Tip|[[#ACME クライアント|ACME]] を使うことで [https://letsencrypt.org/ Let's Encrypt] 認証局からフリーの証明書を取得できます。}}

== サーバーサイドの推奨事項 ==

[[Wikipedia:ja:Transport Layer Security#TLS/SSLの既知の脆弱性|TLS に対する攻撃]] は多数存在するため、ベストプラクティスに注意してください:

* [https://disablessl3.com/ SSLv3 を無効化] することで [[Wikipedia:POODLE|POODLE]] 攻撃を防ぐ。
* [https://weakdh.org/sysadmin.html weakdh.org の TLS の Diffie-Hellman デプロイガイド]
* [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla による Server Side TLS の記事]
* [https://github.com/ssllabs/research/wiki/SSL-and-TLS-Deployment-Best-Practices SSL Labs の SSL と TLS デプロイベストプラクティス]
* [https://cipherli.st/ Cipherli.st]

=== TLS のチェック ===

TLS をチェックするプログラム:

* {{Pkg|testssl.sh}}
* [[Nmap]]
* [[OpenSSL]]
* [https://github.com/mozilla/cipherscan cipherscan]

TLS をチェックするウェブサイト:

* https://dev.ssllabs.com/ssltest/ (HTTPS のみ)
* https://www.checktls.com/ (メールのみ)
* https://www.htbridge.com/ssl/ (任意ポート)
* https://tls.imirhil.fr/tls (任意ポート)

== その他 ==

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

[[Wikipedia:ja:Automated Certificate Management Environment|Automated Certificate Management Environment]] (ACME) プロトコルは [[Let's Encrypt]] などの [[Wikipedia:ja:認証局|認証局]] から X.509 証明書をリクエストできるプロトコルです。

[https://letsencrypt.org/docs/client-options/ ACME クライアントの一覧] も参照してください。

* {{App|acme-client|C で書かれたセキュアな Let's Encrypt クライアント。|https://kristaps.bsd.lv/acme-client/|{{AUR|acme-client}}{{Broken package link|パッケージが存在しません}}}}
* {{App|acme-tiny|Let's Encrypt から TLS 証明書を作成・更新するための200行の Python スクリプト。|https://github.com/diafygi/acme-tiny|{{Pkg|acme-tiny}}}}
* {{App|acme.sh|Unix シェルスクリプトだけで作られた ACME クライアント。|https://github.com/Neilpang/acme.sh|{{AUR|acme.sh-git}}}}
* {{App|acmetool|Go で書かれた使いやすい ACME CLI。|https://github.com/hlandau/acme|{{AUR|acmetool}}, {{AUR|acmetool-git}}}}
* {{App|[[Certbot]]|Python で書かれた、Let's Encrypt によって推奨されている ACME クライアント。|https://github.com/certbot/certbot|{{Pkg|certbot}}}}
* {{App|dehydrated|Bash で書かれた ACME クライアント。|https://github.com/lukas2511/dehydrated|{{Pkg|dehydrated}}, {{AUR|dehydrated-git}}}}
* {{App|getssl|Bash で書かれた ACME クライアント。|https://github.com/srvrco/getssl|{{AUR|getssl}}, {{AUR|getssl-git}}}}
* {{App|lego|Go で書かれた Lets Encrypt クライアントと ACME ライブラリ。|https://github.com/xenolf/lego|{{AUR|lego-git}}}}
* {{App|letsencrypt-cli|もうひとつの Letsencrypt (ACME) クライアント。Ruby を使用。|https://github.com/zealot128/ruby-acme-cli|{{AUR|letsencrypt-cli}}}}
* {{App|manuale|完全手動の Let's Encrypt クライアント。Python で書かれています。|https://github.com/veeti/manuale|{{AUR|manuale}}}}
* {{App|ruby-acme-client|letsencrypt の ACME プロトコルの Ruby クライアント。|https://github.com/unixcharles/acme-client|{{AUR|ruby-acme-client}}}}
* {{App|simp_le|シンプルな Let's Encrypt クライアント。Python で書かれています。|https://github.com/zenhack/simp_le|{{AUR|simp_le-git}}}}

オンラインのインタラクティブな、https://gethttpsforfree.com クライアントでは、ウェブページからシェルコマンドラインにコピーペーストして、10 回ほどやり直す必要があります。その間に推奨されるコマンドを実行します。また、おそらくそのページで手動更新をしなければならないでしょう。あるいは、他の方法で更新を行う必要があります。一方、あなたは、それが成功したかどうか、すべてのステップで見ることができます。証明書を要求するためだけにソフトウェアをインストールする必要はありません。そして、秘密鍵やサーバー・ソフトウェアを、完全に意識的にしか触れないようにすることができるようになります。

=== OCSP ===

[[Wikipedia:ja:Online Certificate Status Protocol|Online Certificate Status Protocol]] (OCSP) は [[Firefox]] によってサポートされています。[[Chromium]] は独自のメカニズムを備えています [http://dev.chromium.org/Home/chromium-security/crlsets]。

GnuTLS の {{man|1|ocsptool}} や OpenSSL の {{man|1ssl|ocsp}} も参照。

=== HSTS ===

[[Wikipedia:ja:HTTP Strict Transport Security|HTTP Strict Transport Security]] (HSTS) メカニズムは Firefox, Chromium, [[wget]] ({{ic|~/.wget-hsts}}) によってサポートされています。

=== DNS CAA ===

See [[Wikipedia:DNS Certification Authority Authorization]].

== 参照 ==

* [https://wiki.gentoo.org/wiki/Certificates Gentoo:Certificates]
* [https://www.happyassassin.net/2015/01/12/a-note-about-ssltls-trusted-certificate-stores-and-platforms/ A note about SSL/TLS trusted certificate stores, and platforms (OpenSSL and GnuTLS)]

トランスポート層セキュリティ

2023-01-02T02:51:16Z

Shota: /* 認証局 */ 日本語訳の改善

[[Category:Transport Layer Security]]
[[en:Transport Layer Security]]
[[Wikipedia:ja:Transport Layer Security|Wikipedia]] より:
:'''Transport Layer Security''' ('''TLS''') およびその前身の [[RFC:7568|Secure Sockets Layer]] ('''SSL''') はコンピュータネットワークにおいてセキュリティを要求される通信を行うためのプロトコルである。ウェブブラウザやメール、インスタントメッセージ、voice over IP (VoIP) などのアプリケーションで幅広く使われているプロトコルとなっている。ウェブサイトは TLS によってサーバーとウェブブラウザ間の通信を暗号化できる。

== 実装 ==

TLS の実装は 5 種類あり、[[公式リポジトリ]]で公開されています。OpenSSL は base メタパッケージの間接的な依存関係であるため、すでにシステムにインストールされているはずです({{Pkg|base}} > {{Pkg|coreutils}} > {{Pkg|openssl}})。GnuTLS は多くのパッケージで必要とされているため、すでにシステムにインストールされている可能性があります。

* {{App|[[OpenSSL]]|堅牢・商業品質・フル機能の TLS と SSL プロトコルのツールキット。汎用の暗号ライブラリでもあります。|https://www.openssl.org/|{{Pkg|openssl}}}}
* {{App|[[GnuTLS]]|TLS, SSL, DTLS プロトコルのフリーソフトウェア実装。X.509, PKCS #12, OpenPGP などの API を提供します。|https://www.gnutls.org/|{{Pkg|gnutls}}}}
* {{App|[[Network Security Services]] (NSS)|TLS/SSL と [[Wikipedia:S/MIME|S/MIME]] をサポートする暗号ライブラリの実装。TLS アクセラレーションとスマートカードもサポート。|https://firefox-source-docs.mozilla.org/security/nss/index.html|{{Pkg|nss}}}}
* {{App|[[mbed TLS]]|ポータブルな SSL/TLS 実装。別名 PolarSSL。|https://tls.mbed.org/|{{Pkg|mbedtls}}}}
* {{App|[[Wikipedia:ja:LibreSSL|LibreSSL]]|OpenBSD プロジェクトによって2014年に OpenSSL からフォークされた TLS/crypto スタック。コードベースを近代的に改修してセキュリティを向上させることを目標としています。|https://www.libressl.org/|{{Pkg|libressl}}}}

== 認証局 ==

TLS では、一連の[[Wikipedia:Certificate authority|認証局]]（CA）の 1 つが、サーバーからの[[Wikipedia:public key certificate|公開鍵証明書]]の信頼性をチェックし署名します。TLS でサーバーに接続するクライアントは、CA の電子署名を通じて、その証明書の信頼性を確認することができます。電子署名を確認するために、クライアントは、別の経路から取得し自己署名証明書として保存された CA の公開鍵を持っている必要があります。Arch Linux では CA 証明書のデフォルトセットは {{Pkg|ca-certificates}} パッケージで提供されています。

{{Note|現在、Arch Linux は [[MozillaWiki:CA|Mozilla CA Certificate Store]] からの CA 証明書をデフォルトセットとして使用しています。}}

Arch Linux は CA 証明書を管理するために、システム全体の集中化されたインターフェースを提供します。このインターフェースは {{Pkg|libp11-kit}} パッケージの {{ic|/usr/lib/pkcs11/p11-kit-trust.so}} というライブラリで、証明書のための [[Wikipedia:PKCS 11|PKCS #11]] API を提供し、{{ic|/usr/share/ca-certificates/trust-source/}} ("Default Trust" トークン) と {{ic|/etc/ca-certificates/trust-source/}} ("System Trust" トークン) に格納されています。

コマンドラインからインターフェースを使用するために、{{Pkg|p11-kit}} パッケージは {{man|1|trust}} ユーティリティを提供します。

CA 証明書の管理に独自の論理を使用しており [[Wikipedia:PKCS 11|PKCS #11]] に移植されていないライブラリのために、{{Pkg|ca-certificates-utils}} パッケージは {{man|8|update-ca-trust}} スクリプトを提供し、集中管理インタフェースを通して得られた CA 証明書を {{ic|/etc/ca-certificates/extracted/}} と {{ic|/etc/ssl/certs/}} にコピーします。

=== CA 証明書のデフォルトセットをロードするためのメカニズムの概要 ===

{| class="wikitable"
! 実装 !! メカニズム !! Arch Linux 設定
|-
| [[OpenSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供する{{man|3|SSL_CTX_set_default_verify_paths}}。
| デフォルトファイルは {{ic|/etc/ssl/cert.pem}} です。デフォルトディレクトリは {{ic|/etc/ssl/certs/}} です。
|-
| [[GnuTLS]]
| ハードコードされたディレクトリ、ファイル、または[https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS 11|PKCS #11]] モジュールから証明書をロードする API 関数を提供する。最後のケースでは、ハードコードされた [[RFC:7512|URL]] によって、任意の信頼できる証明書、または {{ic|trust-policy: yes}} とマークされたモジュール上の信頼できる CA 証明書、オプションで追加のフィルタリング基準を持つ証明書をロードすることができます[https://www.gnutls.org/manual/gnutls.html#Installing-for-a-software-distribution], [https://www.gnutls.org/manual/gnutls.html#Certificate-credentials]。
| [https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS11|PKCS #11]] モジュールから、{{ic|trust-policy: yes}} でマークされた、信頼できるすべての CA 証明書をロードします。
|-
| [[Network Security Services]]
| 専用の API で管理されている [[Wikipedia:PKCS11|PKCS#11]] モジュールの動的に構成されたリストから証明書を自動的にロードします。構成は、ユーザーが指定した任意のディレクトリに保存できます。 [https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/PKCS11/FAQ], {{man|1|modutil}}.
|
|-
| [[mbed TLS]]
| ユーザーは証明書をロードする必要があります。 [https://tls.mbed.org/kb/how-to/mbedtls-tutorial].
|
|-
| [[Wikipedia:LibreSSL|LibreSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供します。 {{man|3|libressl-SSL_CTX_load_verify_locations}}
|デフォルトのファイルは {{ic|/etc/libressl/cert.pem}} で、デフォルトのディレクトリは {{ic |/etc/libressl/certs/}} です。
|}

== 信頼管理 ==

認証局のブラックリストを管理する方法は[[セキュリティ#SSL 証明書の管理]]を見てください。

=== システム全体で認証局を信頼 ===

{{Warning|以下のコマンドを実行すると誰でも秘密鍵にアクセスして TLS 通信を傍受できるようになります。}}

# trust anchor ''certificate''.crt

上記は [[プロキシ設定#HTTPS MITM プロキシ|HTTPS MITM プロキシ]]で通信を傍受するのに必要です。

== 証明書を取得 ==

最初に RSA 秘密鍵を生成してください。鍵を生成する前に、[[umask]] でファイルモード作成マスクを制限的に (例えば {{ic|077}}) 設定してください。

{{Note|{{Pkg|openssl}} パッケージは他のディストリビューションと違って {{ic|/etc/ssl/private}} ディレクトリを保護しません。{{Bug|43059}} を参照。}}

証明書は [[Wikipedia:Certificate signing request|証明書署名要求]] (CSR) を使って認証局から取得するか、あるいは [[Wikipedia:Self-signed certificate|自己署名]] することができます。自己署名証明書は簡単に生成できますが、クライアントはデフォルトでは拒否するため、自己署名証明書を信頼するようにクライアントを設定する必要があります。

実際の生成コマンドは以下の実装の記事を見てください:

* [[OpenSSL]]
* [[GnuTLS#使用方法]]
* [[Network Security Services]]
* [[mbed TLS#使用方法]]

{{Tip|[[#ACME クライアント|ACME]] を使うことで [https://letsencrypt.org/ Let's Encrypt] 認証局からフリーの証明書を取得できます。}}

== サーバーサイドの推奨事項 ==

[[Wikipedia:ja:Transport Layer Security#TLS/SSLの既知の脆弱性|TLS に対する攻撃]] は多数存在するため、ベストプラクティスに注意してください:

* [https://disablessl3.com/ SSLv3 を無効化] することで [[Wikipedia:POODLE|POODLE]] 攻撃を防ぐ。
* [https://weakdh.org/sysadmin.html weakdh.org の TLS の Diffie-Hellman デプロイガイド]
* [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla による Server Side TLS の記事]
* [https://github.com/ssllabs/research/wiki/SSL-and-TLS-Deployment-Best-Practices SSL Labs の SSL と TLS デプロイベストプラクティス]
* [https://cipherli.st/ Cipherli.st]

=== TLS のチェック ===

TLS をチェックするプログラム:

* {{Pkg|testssl.sh}}
* [[Nmap]]
* [[OpenSSL]]
* [https://github.com/mozilla/cipherscan cipherscan]

TLS をチェックするウェブサイト:

* https://dev.ssllabs.com/ssltest/ (HTTPS のみ)
* https://www.checktls.com/ (メールのみ)
* https://www.htbridge.com/ssl/ (任意ポート)
* https://tls.imirhil.fr/tls (任意ポート)

== その他 ==

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

[[Wikipedia:ja:Automated Certificate Management Environment|Automated Certificate Management Environment]] (ACME) プロトコルは [[Let's Encrypt]] などの [[Wikipedia:ja:認証局|認証局]] から X.509 証明書をリクエストできるプロトコルです。

[https://letsencrypt.org/docs/client-options/ ACME クライアントの一覧] も参照してください。

* {{App|acme-client|C で書かれたセキュアな Let's Encrypt クライアント。|https://kristaps.bsd.lv/acme-client/|{{AUR|acme-client}}{{Broken package link|パッケージが存在しません}}}}
* {{App|acme-tiny|Let's Encrypt から TLS 証明書を作成・更新するための200行の Python スクリプト。|https://github.com/diafygi/acme-tiny|{{Pkg|acme-tiny}}}}
* {{App|acme.sh|Unix シェルスクリプトだけで作られた ACME クライアント。|https://github.com/Neilpang/acme.sh|{{AUR|acme.sh-git}}}}
* {{App|acmetool|Go で書かれた使いやすい ACME CLI。|https://github.com/hlandau/acme|{{AUR|acmetool}}, {{AUR|acmetool-git}}}}
* {{App|[[Certbot]]|Python で書かれた、Let's Encrypt によって推奨されている ACME クライアント。|https://github.com/certbot/certbot|{{Pkg|certbot}}}}
* {{App|dehydrated|Bash で書かれた ACME クライアント。|https://github.com/lukas2511/dehydrated|{{Pkg|dehydrated}}, {{AUR|dehydrated-git}}}}
* {{App|getssl|Bash で書かれた ACME クライアント。|https://github.com/srvrco/getssl|{{AUR|getssl}}, {{AUR|getssl-git}}}}
* {{App|lego|Go で書かれた Lets Encrypt クライアントと ACME ライブラリ。|https://github.com/xenolf/lego|{{AUR|lego-git}}}}
* {{App|letsencrypt-cli|もうひとつの Letsencrypt (ACME) クライアント。Ruby を使用。|https://github.com/zealot128/ruby-acme-cli|{{AUR|letsencrypt-cli}}}}
* {{App|manuale|完全手動の Let's Encrypt クライアント。Python で書かれています。|https://github.com/veeti/manuale|{{AUR|manuale}}}}
* {{App|ruby-acme-client|letsencrypt の ACME プロトコルの Ruby クライアント。|https://github.com/unixcharles/acme-client|{{AUR|ruby-acme-client}}}}
* {{App|simp_le|シンプルな Let's Encrypt クライアント。Python で書かれています。|https://github.com/zenhack/simp_le|{{AUR|simp_le-git}}}}

オンラインのインタラクティブな、https://gethttpsforfree.com クライアントでは、ウェブページからシェルコマンドラインにコピーペーストして、10 回ほどやり直す必要があります。その間に推奨されるコマンドを実行します。また、おそらくそのページで手動更新をしなければならないでしょう。あるいは、他の方法で更新を行う必要があります。一方、あなたは、それが成功したかどうか、すべてのステップで見ることができます。証明書を要求するためだけにソフトウェアをインストールする必要はありません。そして、秘密鍵やサーバー・ソフトウェアを、完全に意識的にしか触れないようにすることができるようになります。

=== OCSP ===

[[Wikipedia:ja:Online Certificate Status Protocol|Online Certificate Status Protocol]] (OCSP) は [[Firefox]] によってサポートされています。[[Chromium]] は独自のメカニズムを備えています [http://dev.chromium.org/Home/chromium-security/crlsets]。

GnuTLS の {{man|1|ocsptool}} や OpenSSL の {{man|1ssl|ocsp}} も参照。

=== HSTS ===

[[Wikipedia:ja:HTTP Strict Transport Security|HTTP Strict Transport Security]] (HSTS) メカニズムは Firefox, Chromium, [[wget]] ({{ic|~/.wget-hsts}}) によってサポートされています。

=== DNS CAA ===

See [[Wikipedia:DNS Certification Authority Authorization]].

== 参照 ==

* [https://wiki.gentoo.org/wiki/Certificates Gentoo:Certificates]
* [https://www.happyassassin.net/2015/01/12/a-note-about-ssltls-trusted-certificate-stores-and-platforms/ A note about SSL/TLS trusted certificate stores, and platforms (OpenSSL and GnuTLS)]

トランスポート層セキュリティ

2023-01-02T02:43:58Z

Shota: /* 実装 */ NSS のリンクが切れていたので修正。英語版のリンクでリダイレクトされた先に置き換えた。

[[Category:Transport Layer Security]]
[[en:Transport Layer Security]]
[[Wikipedia:ja:Transport Layer Security|Wikipedia]] より:
:'''Transport Layer Security''' ('''TLS''') およびその前身の [[RFC:7568|Secure Sockets Layer]] ('''SSL''') はコンピュータネットワークにおいてセキュリティを要求される通信を行うためのプロトコルである。ウェブブラウザやメール、インスタントメッセージ、voice over IP (VoIP) などのアプリケーションで幅広く使われているプロトコルとなっている。ウェブサイトは TLS によってサーバーとウェブブラウザ間の通信を暗号化できる。

== 実装 ==

TLS の実装は 5 種類あり、[[公式リポジトリ]]で公開されています。OpenSSL は base メタパッケージの間接的な依存関係であるため、すでにシステムにインストールされているはずです({{Pkg|base}} > {{Pkg|coreutils}} > {{Pkg|openssl}})。GnuTLS は多くのパッケージで必要とされているため、すでにシステムにインストールされている可能性があります。

* {{App|[[OpenSSL]]|堅牢・商業品質・フル機能の TLS と SSL プロトコルのツールキット。汎用の暗号ライブラリでもあります。|https://www.openssl.org/|{{Pkg|openssl}}}}
* {{App|[[GnuTLS]]|TLS, SSL, DTLS プロトコルのフリーソフトウェア実装。X.509, PKCS #12, OpenPGP などの API を提供します。|https://www.gnutls.org/|{{Pkg|gnutls}}}}
* {{App|[[Network Security Services]] (NSS)|TLS/SSL と [[Wikipedia:S/MIME|S/MIME]] をサポートする暗号ライブラリの実装。TLS アクセラレーションとスマートカードもサポート。|https://firefox-source-docs.mozilla.org/security/nss/index.html|{{Pkg|nss}}}}
* {{App|[[mbed TLS]]|ポータブルな SSL/TLS 実装。別名 PolarSSL。|https://tls.mbed.org/|{{Pkg|mbedtls}}}}
* {{App|[[Wikipedia:ja:LibreSSL|LibreSSL]]|OpenBSD プロジェクトによって2014年に OpenSSL からフォークされた TLS/crypto スタック。コードベースを近代的に改修してセキュリティを向上させることを目標としています。|https://www.libressl.org/|{{Pkg|libressl}}}}

== 認証局 ==

TLS では、一連の[[Wikipedia:Certificate authority|認証局]]（CA）の 1 つが、サーバーからの[[Wikipedia:public key certificate|公開鍵証明書]]の信頼性をチェックし、署名します。TLS でサーバーに接続するクライアントは、CA の電子署名に依存して、その証明書の信頼性を確認することができます。電子署名を確認するために、クライアントは別の経路で取得し、自己署名証明書として保存された CA の公開鍵を持っている必要があります。Arch Linux では CA 証明書のデフォルトセットは {{Pkg|ca-certificates}} パッケージで提供されています。

{{Note|現在、Arch Linux は [[MozillaWiki:CA|Mozilla CA Certificate Store]] からの CA 証明書をデフォルトセットとして使用しています。}}

Arch Linux は CA 証明書を管理するために、システム全体の集中化されたインターフェースを提供します。このインターフェースは {{Pkg|libp11-kit}} パッケージの {{ic|/usr/lib/pkcs11/p11-kit-trust.so}} というライブラリで、証明書のための [[Wikipedia:PKCS 11|PKCS #11]] API を提供し、{{ic|/usr/share/ca-certificates/trust-source/}} ("Default Trust" トークン) と {{ic|/etc/ca-certificates/trust-source/}} ("System Trust" トークン) に格納されています。

コマンドラインからインターフェースを使用するために、{{Pkg|p11-kit}} パッケージは {{man|1|trust}} ユーティリティを提供します。

[[Wikipedia:PKCS 11|PKCS #11]] に移植されておらず，CA 証明書の管理に独自の論理を使用しているライブラリのために、{{Pkg|ca-certificates-utils}} パッケージは {{man|8|update-ca-trust}} スクリプトを提供し，集中管理インタフェースを通して得られた CA 証明書を {{ic|/etc/ca-certificates/extracted/}} と {{ic|/etc/ssl/certs/}} にコピーします。

=== CA 証明書のデフォルトセットをロードするためのメカニズムの概要 ===

{| class="wikitable"
! 実装 !! メカニズム !! Arch Linux 設定
|-
| [[OpenSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供する{{man|3|SSL_CTX_set_default_verify_paths}}。
| デフォルトファイルは {{ic|/etc/ssl/cert.pem}} です。デフォルトディレクトリは {{ic|/etc/ssl/certs/}} です。
|-
| [[GnuTLS]]
| ハードコードされたディレクトリ、ファイル、または[https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS 11|PKCS #11]] モジュールから証明書をロードする API 関数を提供する。最後のケースでは、ハードコードされた [[RFC:7512|URL]] によって、任意の信頼できる証明書、または {{ic|trust-policy: yes}} とマークされたモジュール上の信頼できる CA 証明書、オプションで追加のフィルタリング基準を持つ証明書をロードすることができます[https://www.gnutls.org/manual/gnutls.html#Installing-for-a-software-distribution], [https://www.gnutls.org/manual/gnutls.html#Certificate-credentials]。
| [https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS11|PKCS #11]] モジュールから、{{ic|trust-policy: yes}} でマークされた、信頼できるすべての CA 証明書をロードします。
|-
| [[Network Security Services]]
| 専用の API で管理されている [[Wikipedia:PKCS11|PKCS#11]] モジュールの動的に構成されたリストから証明書を自動的にロードします。構成は、ユーザーが指定した任意のディレクトリに保存できます。 [https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/PKCS11/FAQ], {{man|1|modutil}}.
|
|-
| [[mbed TLS]]
| ユーザーは証明書をロードする必要があります。 [https://tls.mbed.org/kb/how-to/mbedtls-tutorial].
|
|-
| [[Wikipedia:LibreSSL|LibreSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供します。 {{man|3|libressl-SSL_CTX_load_verify_locations}}
|デフォルトのファイルは {{ic|/etc/libressl/cert.pem}} で、デフォルトのディレクトリは {{ic |/etc/libressl/certs/}} です。
|}

== 信頼管理 ==

認証局のブラックリストを管理する方法は[[セキュリティ#SSL 証明書の管理]]を見てください。

=== システム全体で認証局を信頼 ===

{{Warning|以下のコマンドを実行すると誰でも秘密鍵にアクセスして TLS 通信を傍受できるようになります。}}

# trust anchor ''certificate''.crt

上記は [[プロキシ設定#HTTPS MITM プロキシ|HTTPS MITM プロキシ]]で通信を傍受するのに必要です。

== 証明書を取得 ==

最初に RSA 秘密鍵を生成してください。鍵を生成する前に、[[umask]] でファイルモード作成マスクを制限的に (例えば {{ic|077}}) 設定してください。

{{Note|{{Pkg|openssl}} パッケージは他のディストリビューションと違って {{ic|/etc/ssl/private}} ディレクトリを保護しません。{{Bug|43059}} を参照。}}

証明書は [[Wikipedia:Certificate signing request|証明書署名要求]] (CSR) を使って認証局から取得するか、あるいは [[Wikipedia:Self-signed certificate|自己署名]] することができます。自己署名証明書は簡単に生成できますが、クライアントはデフォルトでは拒否するため、自己署名証明書を信頼するようにクライアントを設定する必要があります。

実際の生成コマンドは以下の実装の記事を見てください:

* [[OpenSSL]]
* [[GnuTLS#使用方法]]
* [[Network Security Services]]
* [[mbed TLS#使用方法]]

{{Tip|[[#ACME クライアント|ACME]] を使うことで [https://letsencrypt.org/ Let's Encrypt] 認証局からフリーの証明書を取得できます。}}

== サーバーサイドの推奨事項 ==

[[Wikipedia:ja:Transport Layer Security#TLS/SSLの既知の脆弱性|TLS に対する攻撃]] は多数存在するため、ベストプラクティスに注意してください:

* [https://disablessl3.com/ SSLv3 を無効化] することで [[Wikipedia:POODLE|POODLE]] 攻撃を防ぐ。
* [https://weakdh.org/sysadmin.html weakdh.org の TLS の Diffie-Hellman デプロイガイド]
* [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla による Server Side TLS の記事]
* [https://github.com/ssllabs/research/wiki/SSL-and-TLS-Deployment-Best-Practices SSL Labs の SSL と TLS デプロイベストプラクティス]
* [https://cipherli.st/ Cipherli.st]

=== TLS のチェック ===

TLS をチェックするプログラム:

* {{Pkg|testssl.sh}}
* [[Nmap]]
* [[OpenSSL]]
* [https://github.com/mozilla/cipherscan cipherscan]

TLS をチェックするウェブサイト:

* https://dev.ssllabs.com/ssltest/ (HTTPS のみ)
* https://www.checktls.com/ (メールのみ)
* https://www.htbridge.com/ssl/ (任意ポート)
* https://tls.imirhil.fr/tls (任意ポート)

== その他 ==

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

[[Wikipedia:ja:Automated Certificate Management Environment|Automated Certificate Management Environment]] (ACME) プロトコルは [[Let's Encrypt]] などの [[Wikipedia:ja:認証局|認証局]] から X.509 証明書をリクエストできるプロトコルです。

[https://letsencrypt.org/docs/client-options/ ACME クライアントの一覧] も参照してください。

* {{App|acme-client|C で書かれたセキュアな Let's Encrypt クライアント。|https://kristaps.bsd.lv/acme-client/|{{AUR|acme-client}}{{Broken package link|パッケージが存在しません}}}}
* {{App|acme-tiny|Let's Encrypt から TLS 証明書を作成・更新するための200行の Python スクリプト。|https://github.com/diafygi/acme-tiny|{{Pkg|acme-tiny}}}}
* {{App|acme.sh|Unix シェルスクリプトだけで作られた ACME クライアント。|https://github.com/Neilpang/acme.sh|{{AUR|acme.sh-git}}}}
* {{App|acmetool|Go で書かれた使いやすい ACME CLI。|https://github.com/hlandau/acme|{{AUR|acmetool}}, {{AUR|acmetool-git}}}}
* {{App|[[Certbot]]|Python で書かれた、Let's Encrypt によって推奨されている ACME クライアント。|https://github.com/certbot/certbot|{{Pkg|certbot}}}}
* {{App|dehydrated|Bash で書かれた ACME クライアント。|https://github.com/lukas2511/dehydrated|{{Pkg|dehydrated}}, {{AUR|dehydrated-git}}}}
* {{App|getssl|Bash で書かれた ACME クライアント。|https://github.com/srvrco/getssl|{{AUR|getssl}}, {{AUR|getssl-git}}}}
* {{App|lego|Go で書かれた Lets Encrypt クライアントと ACME ライブラリ。|https://github.com/xenolf/lego|{{AUR|lego-git}}}}
* {{App|letsencrypt-cli|もうひとつの Letsencrypt (ACME) クライアント。Ruby を使用。|https://github.com/zealot128/ruby-acme-cli|{{AUR|letsencrypt-cli}}}}
* {{App|manuale|完全手動の Let's Encrypt クライアント。Python で書かれています。|https://github.com/veeti/manuale|{{AUR|manuale}}}}
* {{App|ruby-acme-client|letsencrypt の ACME プロトコルの Ruby クライアント。|https://github.com/unixcharles/acme-client|{{AUR|ruby-acme-client}}}}
* {{App|simp_le|シンプルな Let's Encrypt クライアント。Python で書かれています。|https://github.com/zenhack/simp_le|{{AUR|simp_le-git}}}}

オンラインのインタラクティブな、https://gethttpsforfree.com クライアントでは、ウェブページからシェルコマンドラインにコピーペーストして、10 回ほどやり直す必要があります。その間に推奨されるコマンドを実行します。また、おそらくそのページで手動更新をしなければならないでしょう。あるいは、他の方法で更新を行う必要があります。一方、あなたは、それが成功したかどうか、すべてのステップで見ることができます。証明書を要求するためだけにソフトウェアをインストールする必要はありません。そして、秘密鍵やサーバー・ソフトウェアを、完全に意識的にしか触れないようにすることができるようになります。

=== OCSP ===

[[Wikipedia:ja:Online Certificate Status Protocol|Online Certificate Status Protocol]] (OCSP) は [[Firefox]] によってサポートされています。[[Chromium]] は独自のメカニズムを備えています [http://dev.chromium.org/Home/chromium-security/crlsets]。

GnuTLS の {{man|1|ocsptool}} や OpenSSL の {{man|1ssl|ocsp}} も参照。

=== HSTS ===

[[Wikipedia:ja:HTTP Strict Transport Security|HTTP Strict Transport Security]] (HSTS) メカニズムは Firefox, Chromium, [[wget]] ({{ic|~/.wget-hsts}}) によってサポートされています。

=== DNS CAA ===

See [[Wikipedia:DNS Certification Authority Authorization]].

== 参照 ==

* [https://wiki.gentoo.org/wiki/Certificates Gentoo:Certificates]
* [https://www.happyassassin.net/2015/01/12/a-note-about-ssltls-trusted-certificate-stores-and-platforms/ A note about SSL/TLS trusted certificate stores, and platforms (OpenSSL and GnuTLS)]

トランスポート層セキュリティ

2023-01-02T02:39:07Z

Shota: 序文において微妙な訳のニュアンスの修正

[[Category:Transport Layer Security]]
[[en:Transport Layer Security]]
[[Wikipedia:ja:Transport Layer Security|Wikipedia]] より:
:'''Transport Layer Security''' ('''TLS''') およびその前身の [[RFC:7568|Secure Sockets Layer]] ('''SSL''') はコンピュータネットワークにおいてセキュリティを要求される通信を行うためのプロトコルである。ウェブブラウザやメール、インスタントメッセージ、voice over IP (VoIP) などのアプリケーションで幅広く使われているプロトコルとなっている。ウェブサイトは TLS によってサーバーとウェブブラウザ間の通信を暗号化できる。

== 実装 ==

TLS の実装は 5 種類あり、[[公式リポジトリ]]で公開されています。OpenSSL は base メタパッケージの間接的な依存関係であるため、すでにシステムにインストールされているはずです({{Pkg|base}} > {{Pkg|coreutils}} > {{Pkg|openssl}})。GnuTLS は多くのパッケージで必要とされているため、すでにシステムにインストールされている可能性があります。

* {{App|[[OpenSSL]]|堅牢・商業品質・フル機能の TLS と SSL プロトコルのツールキット。汎用の暗号ライブラリでもあります。|https://www.openssl.org/|{{Pkg|openssl}}}}
* {{App|[[GnuTLS]]|TLS, SSL, DTLS プロトコルのフリーソフトウェア実装。X.509, PKCS #12, OpenPGP などの API を提供します。|https://www.gnutls.org/|{{Pkg|gnutls}}}}
* {{App|[[Network Security Services]] (NSS)|TLS/SSL と [[Wikipedia:S/MIME|S/MIME]] をサポートする暗号ライブラリの実装。TLS アクセラレーションとスマートカードもサポート。|https://developer.mozilla.org/NSS|{{Pkg|nss}}}}
* {{App|[[mbed TLS]]|ポータブルな SSL/TLS 実装。別名 PolarSSL。|https://tls.mbed.org/|{{Pkg|mbedtls}}}}
* {{App|[[Wikipedia:ja:LibreSSL|LibreSSL]]|OpenBSD プロジェクトによって2014年に OpenSSL からフォークされた TLS/crypto スタック。コードベースを近代的に改修してセキュリティを向上させることを目標としています。|https://www.libressl.org/|{{Pkg|libressl}}}}

== 認証局 ==

TLS では、一連の[[Wikipedia:Certificate authority|認証局]]（CA）の 1 つが、サーバーからの[[Wikipedia:public key certificate|公開鍵証明書]]の信頼性をチェックし、署名します。TLS でサーバーに接続するクライアントは、CA の電子署名に依存して、その証明書の信頼性を確認することができます。電子署名を確認するために、クライアントは別の経路で取得し、自己署名証明書として保存された CA の公開鍵を持っている必要があります。Arch Linux では CA 証明書のデフォルトセットは {{Pkg|ca-certificates}} パッケージで提供されています。

{{Note|現在、Arch Linux は [[MozillaWiki:CA|Mozilla CA Certificate Store]] からの CA 証明書をデフォルトセットとして使用しています。}}

Arch Linux は CA 証明書を管理するために、システム全体の集中化されたインターフェースを提供します。このインターフェースは {{Pkg|libp11-kit}} パッケージの {{ic|/usr/lib/pkcs11/p11-kit-trust.so}} というライブラリで、証明書のための [[Wikipedia:PKCS 11|PKCS #11]] API を提供し、{{ic|/usr/share/ca-certificates/trust-source/}} ("Default Trust" トークン) と {{ic|/etc/ca-certificates/trust-source/}} ("System Trust" トークン) に格納されています。

コマンドラインからインターフェースを使用するために、{{Pkg|p11-kit}} パッケージは {{man|1|trust}} ユーティリティを提供します。

[[Wikipedia:PKCS 11|PKCS #11]] に移植されておらず，CA 証明書の管理に独自の論理を使用しているライブラリのために、{{Pkg|ca-certificates-utils}} パッケージは {{man|8|update-ca-trust}} スクリプトを提供し，集中管理インタフェースを通して得られた CA 証明書を {{ic|/etc/ca-certificates/extracted/}} と {{ic|/etc/ssl/certs/}} にコピーします。

=== CA 証明書のデフォルトセットをロードするためのメカニズムの概要 ===

{| class="wikitable"
! 実装 !! メカニズム !! Arch Linux 設定
|-
| [[OpenSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供する{{man|3|SSL_CTX_set_default_verify_paths}}。
| デフォルトファイルは {{ic|/etc/ssl/cert.pem}} です。デフォルトディレクトリは {{ic|/etc/ssl/certs/}} です。
|-
| [[GnuTLS]]
| ハードコードされたディレクトリ、ファイル、または[https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS 11|PKCS #11]] モジュールから証明書をロードする API 関数を提供する。最後のケースでは、ハードコードされた [[RFC:7512|URL]] によって、任意の信頼できる証明書、または {{ic|trust-policy: yes}} とマークされたモジュール上の信頼できる CA 証明書、オプションで追加のフィルタリング基準を持つ証明書をロードすることができます[https://www.gnutls.org/manual/gnutls.html#Installing-for-a-software-distribution], [https://www.gnutls.org/manual/gnutls.html#Certificate-credentials]。
| [https://man.archlinux.org/man/pkcs11.conf.5 設定された] [[Wikipedia:PKCS11|PKCS #11]] モジュールから、{{ic|trust-policy: yes}} でマークされた、信頼できるすべての CA 証明書をロードします。
|-
| [[Network Security Services]]
| 専用の API で管理されている [[Wikipedia:PKCS11|PKCS#11]] モジュールの動的に構成されたリストから証明書を自動的にロードします。構成は、ユーザーが指定した任意のディレクトリに保存できます。 [https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/PKCS11/FAQ], {{man|1|modutil}}.
|
|-
| [[mbed TLS]]
| ユーザーは証明書をロードする必要があります。 [https://tls.mbed.org/kb/how-to/mbedtls-tutorial].
|
|-
| [[Wikipedia:LibreSSL|LibreSSL]]
| ハードコードされたディレクトリまたはファイルから証明書をロードする API 関数を提供します。 {{man|3|libressl-SSL_CTX_load_verify_locations}}
|デフォルトのファイルは {{ic|/etc/libressl/cert.pem}} で、デフォルトのディレクトリは {{ic |/etc/libressl/certs/}} です。
|}

== 信頼管理 ==

認証局のブラックリストを管理する方法は[[セキュリティ#SSL 証明書の管理]]を見てください。

=== システム全体で認証局を信頼 ===

{{Warning|以下のコマンドを実行すると誰でも秘密鍵にアクセスして TLS 通信を傍受できるようになります。}}

# trust anchor ''certificate''.crt

上記は [[プロキシ設定#HTTPS MITM プロキシ|HTTPS MITM プロキシ]]で通信を傍受するのに必要です。

== 証明書を取得 ==

最初に RSA 秘密鍵を生成してください。鍵を生成する前に、[[umask]] でファイルモード作成マスクを制限的に (例えば {{ic|077}}) 設定してください。

{{Note|{{Pkg|openssl}} パッケージは他のディストリビューションと違って {{ic|/etc/ssl/private}} ディレクトリを保護しません。{{Bug|43059}} を参照。}}

証明書は [[Wikipedia:Certificate signing request|証明書署名要求]] (CSR) を使って認証局から取得するか、あるいは [[Wikipedia:Self-signed certificate|自己署名]] することができます。自己署名証明書は簡単に生成できますが、クライアントはデフォルトでは拒否するため、自己署名証明書を信頼するようにクライアントを設定する必要があります。

実際の生成コマンドは以下の実装の記事を見てください:

* [[OpenSSL]]
* [[GnuTLS#使用方法]]
* [[Network Security Services]]
* [[mbed TLS#使用方法]]

{{Tip|[[#ACME クライアント|ACME]] を使うことで [https://letsencrypt.org/ Let's Encrypt] 認証局からフリーの証明書を取得できます。}}

== サーバーサイドの推奨事項 ==

[[Wikipedia:ja:Transport Layer Security#TLS/SSLの既知の脆弱性|TLS に対する攻撃]] は多数存在するため、ベストプラクティスに注意してください:

* [https://disablessl3.com/ SSLv3 を無効化] することで [[Wikipedia:POODLE|POODLE]] 攻撃を防ぐ。
* [https://weakdh.org/sysadmin.html weakdh.org の TLS の Diffie-Hellman デプロイガイド]
* [https://wiki.mozilla.org/Security/Server_Side_TLS Mozilla による Server Side TLS の記事]
* [https://github.com/ssllabs/research/wiki/SSL-and-TLS-Deployment-Best-Practices SSL Labs の SSL と TLS デプロイベストプラクティス]
* [https://cipherli.st/ Cipherli.st]

=== TLS のチェック ===

TLS をチェックするプログラム:

* {{Pkg|testssl.sh}}
* [[Nmap]]
* [[OpenSSL]]
* [https://github.com/mozilla/cipherscan cipherscan]

TLS をチェックするウェブサイト:

* https://dev.ssllabs.com/ssltest/ (HTTPS のみ)
* https://www.checktls.com/ (メールのみ)
* https://www.htbridge.com/ssl/ (任意ポート)
* https://tls.imirhil.fr/tls (任意ポート)

== その他 ==

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

[[Wikipedia:ja:Automated Certificate Management Environment|Automated Certificate Management Environment]] (ACME) プロトコルは [[Let's Encrypt]] などの [[Wikipedia:ja:認証局|認証局]] から X.509 証明書をリクエストできるプロトコルです。

[https://letsencrypt.org/docs/client-options/ ACME クライアントの一覧] も参照してください。

* {{App|acme-client|C で書かれたセキュアな Let's Encrypt クライアント。|https://kristaps.bsd.lv/acme-client/|{{AUR|acme-client}}{{Broken package link|パッケージが存在しません}}}}
* {{App|acme-tiny|Let's Encrypt から TLS 証明書を作成・更新するための200行の Python スクリプト。|https://github.com/diafygi/acme-tiny|{{Pkg|acme-tiny}}}}
* {{App|acme.sh|Unix シェルスクリプトだけで作られた ACME クライアント。|https://github.com/Neilpang/acme.sh|{{AUR|acme.sh-git}}}}
* {{App|acmetool|Go で書かれた使いやすい ACME CLI。|https://github.com/hlandau/acme|{{AUR|acmetool}}, {{AUR|acmetool-git}}}}
* {{App|[[Certbot]]|Python で書かれた、Let's Encrypt によって推奨されている ACME クライアント。|https://github.com/certbot/certbot|{{Pkg|certbot}}}}
* {{App|dehydrated|Bash で書かれた ACME クライアント。|https://github.com/lukas2511/dehydrated|{{Pkg|dehydrated}}, {{AUR|dehydrated-git}}}}
* {{App|getssl|Bash で書かれた ACME クライアント。|https://github.com/srvrco/getssl|{{AUR|getssl}}, {{AUR|getssl-git}}}}
* {{App|lego|Go で書かれた Lets Encrypt クライアントと ACME ライブラリ。|https://github.com/xenolf/lego|{{AUR|lego-git}}}}
* {{App|letsencrypt-cli|もうひとつの Letsencrypt (ACME) クライアント。Ruby を使用。|https://github.com/zealot128/ruby-acme-cli|{{AUR|letsencrypt-cli}}}}
* {{App|manuale|完全手動の Let's Encrypt クライアント。Python で書かれています。|https://github.com/veeti/manuale|{{AUR|manuale}}}}
* {{App|ruby-acme-client|letsencrypt の ACME プロトコルの Ruby クライアント。|https://github.com/unixcharles/acme-client|{{AUR|ruby-acme-client}}}}
* {{App|simp_le|シンプルな Let's Encrypt クライアント。Python で書かれています。|https://github.com/zenhack/simp_le|{{AUR|simp_le-git}}}}

オンラインのインタラクティブな、https://gethttpsforfree.com クライアントでは、ウェブページからシェルコマンドラインにコピーペーストして、10 回ほどやり直す必要があります。その間に推奨されるコマンドを実行します。また、おそらくそのページで手動更新をしなければならないでしょう。あるいは、他の方法で更新を行う必要があります。一方、あなたは、それが成功したかどうか、すべてのステップで見ることができます。証明書を要求するためだけにソフトウェアをインストールする必要はありません。そして、秘密鍵やサーバー・ソフトウェアを、完全に意識的にしか触れないようにすることができるようになります。

=== OCSP ===

[[Wikipedia:ja:Online Certificate Status Protocol|Online Certificate Status Protocol]] (OCSP) は [[Firefox]] によってサポートされています。[[Chromium]] は独自のメカニズムを備えています [http://dev.chromium.org/Home/chromium-security/crlsets]。

GnuTLS の {{man|1|ocsptool}} や OpenSSL の {{man|1ssl|ocsp}} も参照。

=== HSTS ===

[[Wikipedia:ja:HTTP Strict Transport Security|HTTP Strict Transport Security]] (HSTS) メカニズムは Firefox, Chromium, [[wget]] ({{ic|~/.wget-hsts}}) によってサポートされています。

=== DNS CAA ===

See [[Wikipedia:DNS Certification Authority Authorization]].

== 参照 ==

* [https://wiki.gentoo.org/wiki/Certificates Gentoo:Certificates]
* [https://www.happyassassin.net/2015/01/12/a-note-about-ssltls-trusted-certificate-stores-and-platforms/ A note about SSL/TLS trusted certificate stores, and platforms (OpenSSL and GnuTLS)]

利用者:Shota

2022-12-11T03:07:05Z

Shota: /* Tips */ ThinkPad トラックポイントの設定

== 自己紹介 ==
普段から Arch Linux を使っているので、何か Arch community に貢献できればと思っています。
* Main PC: [[Lenovo_ThinkPad_X230]], [[Lenovo_ThinkPad_X1_Extreme]].

== Tips ==
* <s>ThinkPad におけるトラックポイントの速さの変更方法: [https://askubuntu.com/questions/37824/what-is-the-best-way-to-configure-a-thinkpads-trackpoint ask ubuntu のフォーラムより]</s> -> [[トラックポイント]]。

利用者:Shota

2022-10-13T00:04:30Z

Shota: 自分用 Tips のメモ

== 自己紹介 ==
普段から Arch Linux を使っているので、何か Arch community に貢献できればと思っています。
* Main PC: [[Lenovo_ThinkPad_X230]], [[Lenovo_ThinkPad_X1_Extreme]].

== Tips ==
* ThinkPad におけるトラックポイントの速さの変更方法: [https://askubuntu.com/questions/37824/what-is-the-best-way-to-configure-a-thinkpads-trackpoint ask ubuntu のフォーラムより]

RAID

2022-08-20T15:06:44Z

Shota: 英語版から序文を翻訳

{{Translateme|翻訳が古くなっています。}}
[[Category:Arch の入手とインストール]]
[[Category:ファイルシステム]]
[[en:RAID]]
[[es:RAID]]
[[it:RAID]]
[[zh-hans:RAID]]
{{Related articles start}}
{{Related|ソフトウェア RAID と LVM}}
{{Related|Fake RAID でインストール}}
{{Related|シングルドライブ環境を RAID に変換}}
{{Related|ZFS}}
{{Related|ZFS/仮想ディスク}}
{{Related|スワップ#ストライピング}}
{{Related|Btrfs#RAID 機能}}
{{Related articles end}}
RAID とは Redundant Array of Independent Disks (個別のディスクによる冗長化集合 https://ja.wikipedia.org/wiki/RAID) の略であり、複数のディスクドライブ (典型的にはディスクドライブかパーティシヨン) を組み合わせて1つの論理ユニットとして扱うストレージ技術です。RAID の実装に応じて、この論理ユニットは1つのファイルシステムや、いくつかのパーティションを保持する更なる透過型レイヤとすることができます。[[#RAID レベル]] と呼ばれるいくつかの方法の内、いずれかによってデータはドライブの集合にまたがって分散させられます。このレベルによって冗長性やパフォーマンスを変えられ、この選択によって、ハードディスクの故障によるデータ損傷から守ったり、パフォーマンスを向上させたり、あるいは両方を実現できます。

この記事では mdadm によるソフトウェア RAID アレイの作成・管理方法を説明します。

{{Warning|RAID を設定する前に、かならず全てのデータを[[バックアッププログラム|バックアップ]]しておきましょう。}}

== イントロダクション ==
{{Wikipedia/ja|RAID}}
独立ディスク冗長アレイ (Redundant Array of Independent Disks, RAID) は複数のディスクドライブの構成部品 (一般的にはディスクドライブまたはそのパーティション) をまとめて一つの論理ユニットにするストレージ技術です。RAID の実装によって、この論理ユニットはファイルシステム、あるいは複数のパーティションを保持する追補的な透過レイヤーになります。データは "RAID レベル" と呼ばれる様々な方法によって、必要とされる冗長性やパフォーマンスにあわせて、ドライブに分散されます。RAID レベルの選択によって、ハードディスクが壊れた時にデータが喪失することを防いだり、パフォーマンスを向上させたり、あるいはその両方を実現できます。

ほとんどの RAID レベルでは冗長性が確保されていますが、RAID はデータが安全であることを保証するものではありません。火事があったときや、コンピュータが盗まれたとき、または複数のドライブが同時に壊れた場合など RAID はデータを保護しません。さらに、RAID でシステムをインストールするのは複雑な作業であり、そのときにデータを破壊してしまう可能性もあります。 {{Warning|従って、RAID を設定する前に、かならず全てのデータを[[バックアッププログラム|バックアップ]]しておきましょう。}}

{{Note|データの保存や冗長性のために RAID アレイを使おうと思っているユーザーは [[ZFS]] によって実装されている RAIDZ についても採用を検討すると良いでしょう。ソフトウェア RAID の代替としてより近代的でパワフルな能力があります。}}

===通常の RAID レベル===
[[Wikipedia:Standard RAID levels|RAID のレベル]]はたくさん存在します、以下は最も一般的に使われているレベルです。

; [[Wikipedia:Standard RAID levels#RAID 0|RAID 0]]
: ストライピングを使ってディスクを結合します。RAID 0 には''冗長性がありません''が、RAID とされています。耐障害性がない代わりに、''速度が向上する恩恵があります''。データが消失する可能性を差し引いても速度を上げる価値がある場合 (例えば[[スワップ]]パーティション)、この RAID レベルを選択します。サーバーでは、RAID 1 や RAID 5 アレイを使う方が適切です。RAID 0 アレイのブロックデバイスのサイズは一番小さいコンポーネントパーティションとコンポーネントパーティションの数を掛けた値になります。
; [[Wikipedia:Standard RAID levels#RAID 1|RAID 1]]
: 最もシンプルな RAID レベル: ミラーリングです。他の RAID レベルと同様に、パーティションを複数の物理ディスクドライブに配置した時にだけ意味をなします。ドライブのどれか一台が故障しても、RAID アレイによるブロックデバイスは通常通りに稼働し続けます。例では[[スワップ]]や一時的なデータを除いて全てを RAID 1 に保存します。ソフトウェア実装を使う場合、ブートパーティションで使えるのは RAID 1 レベルしかないので注意してください。ブートパーティションを読み込むブートローダーは RAID を認識できないながらも、RAID 1 のコンポーネントパーティションは通常のパーティションとして読み込めるからです。RAID 1 アレイのブロックデバイスのサイズは一番小さいコンポーネントパーティションと同じになります。
; [[Wikipedia:Standard RAID levels#RAID 5|RAID 5]]
: 三台以上の物理ドライブが必要で、RAID 0 の速度・サイズのメリットを残しながら RAID 1 の冗長性を実現します。RAID 5 は RAID 0 と同じようにストライピングを使いますが、それに加えて''それぞれのディスクに分散して''パリティブロックの記録を行います。ディスクが故障した時は、パリティブロックを利用して交換したディスクにデータを再構築します。RAID 5 は一台のディスクの喪失まで耐えることが可能です。
: {{Note|速度とデータの冗長性を両得できることから RAID 5 はよく使われています。ただし一台のドライブが壊れてから、ドライブを置き換える前にもう一台ドライブが故障すると、全てのデータを喪失するので注意してください。さらに、最近のディスク容量や修復不能なリードエラー (unrecoverble read error; URE) の発生率を考えると、4TiB のアレイを再構築するとき URE が (50% 以上という) 高い確率で発生します。そのため、ストレージ業界では RAID 5 はもはや推奨されていません。}}
; [[Wikipedia:Standard RAID levels#RAID 6|RAID 6]]
: 四台以上の物理ドライブを必要とし、RAID 5 の利点を活かしながらドライブが二台故障しても安全です。RAID 6 も RAID 5 と同じようにストライピングを使用しますが、二つの異なるパリティブロックを''それぞれのメンバーディスクに分散して''保存します。ディスクが故障したときは、パリティブロックを利用して交換したディスクにデータを再構築します。RAID 6 は二台のディスクの喪失まで耐えることが可能です。ドライブを再構築するときでもアレイにパリティブロックが存在するため、読み取りエラーに対する堅牢性は高くなっています。ただし、オーバーヘッドを考えると RAID 6 はコストがかかります。大抵の場合は far2 レイアウトの RAID 10 のほうが高い性能と堅牢性を確保できます (下を参照)。

===ネストされた RAID レベル===
; [[Wikipedia:Nested RAID levels#RAID 1 + 0|RAID 1+0]]
: RAID 1+0 は2つの標準 RAID レベルを組み合わせてパフォーマンスと冗長性を獲得する入れ子の RAID です。よく ''RAID 10'' と呼ばれますが、Linux MD RAID 10 は単純な RAID レイヤーとは多少異なっています。下記を見てください。

; [[Wikipedia:Non-standard_RAID_levels#Linux_MD_RAID_10|RAID 10]]
: Linux における RAID 10 は RAID 1+0 の概念に基づいていますが、シングルレイヤーとして実装することで複数のレイアウトが可能になっています。

: Y 台のディスクによる ''near X'' レイアウトは Y/2 個のストライプで X 個のチャンクが作成されますが、Y を均等に X で割る必要はありません。near という名前のとおり、チャンクは複製されるディスクに近い場所に配置されます。2台以上の任意の台数のディスクを使うことができます。2台のディスクによる Near 2 は RAID 1 と同じであり、4台のディスクによる Near 2 は RAID 1+0 と同じです。

: Y 台のディスクによる ''far X'' レイアウトはストライプによる読み取り性能を複製されたアレイで発揮します。ディスクをフロントとバックに分けて、ディスク1のフロントはディスク2のバックに複製され、ディスク2のフロントはディスク1のバックに複製されます。RAID 0 や RAID 5 と同じように、シーケンシャルリードを高速化することが可能です。欠点としては複製を保存するのにディスクがシークする距離が長くなるためシーケンシャルライトが遅くなります。それでも、読み込み速度が重要で可用性・冗長性が必要な場合は RAID 1+0 や RAID 5 よりも far 2 レイアウトの RAID 10 を使うことを推奨します。ただしバックアップを置き換えることはできません。

=== RAID レベルの比較 ===
{| class="wikitable"
! RAID レベル!!データの冗長性!!物理ドライブの利用効率!!読込パフォーマンス!!書込パフォーマンス!!最小ドライブ数
|-
| '''0'''||{{No}}||100%||nX '''最速'''||nX '''最速'''||2
|-
| '''1'''||{{Yes}}||50%||nX (理論値) 1X (実測値)||1X||2
|-
| '''5'''||{{Yes}}||67% - 94%||(n−1)X '''高速'''||(n−1)X '''高速'''
||3
|-
| '''6'''||{{Yes}}||50% - 88%||(n−2)X||(n−2)X||4
|-
| '''10''' (far2) ||{{Yes}}||50%||nX '''最速''' (RAID 0 と同等)||(n/2)X||2
|-
| '''10''' (near2) ||{{Yes}}||50%||nX (理論値) 1X (実測値)||(n/2)X||2
|}
<nowiki>*</nowiki> ''n'' は利用するディスクの数。

== 実装 ==
RAID デバイスの制御方法は様々です:

; ソフトウェア RAID
: 不明瞭なプロプライエタリのファームウェアや使用するソフトウェアに依存しないため楽な実装方法です。アレイはオペレーティングシステムによって以下のいずれかで管理されます:
:* 抽象レイヤー (例: [[#セットアップ|mdadm]])。 {{Note|このガイドで使用する方法です。}}
:* 論理ボリュームマネージャ (例: [[LVM]])。
:* ファイルシステムのコンポーネント (例: [[ZFS]], [[Btrfs]])。

; ハードウェア RAID
: PC に取り付けた専用のハードウェアカードにディスクを直接接続してアレイをダイレクトに制御します。[[Wikipedia:ja:CPU|ホストプロセッサ (CPU)]] とは独立したオンボードのプロセッサ上で RAID が処理されます。この方法はオペレーティングシステムから独立していますが、ハードウェア RAID コントローラを正しく作動させるためにはドライバーが必要になります。RAID アレイの設定は、メーカーによって、オプション ROM インターフェイスを使ったり、OS をインストールする際に専用のアプリケーションを使って行います。この設定は Linux からは見ることができません、システムには単一のディスクとして認識されます。

; [[Fake RAID でインストール|FakeRAID]]
: このタイプのRAIDは正しくは BIOS またはオンボード RAID と呼ぶべきですが、ハードウェア RAID として偽って喧伝されています。アレイの管理はオプション ROM やファームウェアと ([[UEFI]] の場合) ファームウェアで RAID ロジックが実装される擬似的な RAID コントローラが行いますが、''全ての'' RAID 機能が実装された完全な RAID コントローラではありません。そのため、このタイプの RAID は FakeRAID と呼称されることがあります。FakeRAID のコントローラは[[公式リポジトリ]]の {{Pkg|dmraid}} を使って扱います。FakeRAID コントローラの例: [[Wikipedia:Intel Rapid Storage Technology|Intel Rapid Storage]], JMicron JMB36x RAID ROM, AMD RAID, ASMedia 106x, NVIDIA MediaShield など。

===使用している RAID はどのタイプか？===

ソフトウェア RAID の実装はユーザーによるため、ソフトウェア RAID を使ってることは簡単にわかります。

反対に、FakeRAID と真のハードウェア RAID を見分けるのは難しいかもしれません。上記の通り、しばしばメーカーはこれら二つの RAID タイプを誤って区別していることがあり、不当表示も考えられます。この場合、一番良い方法は {{ic|lspci}} コマンドを実行して出力を見て RAID コントローラを調べることです。それからその RAID コントローラに関する情報がないか検索してみてください。完全なハードウェア RAID コントローラは多くの場合やや高価 (~$400+) であり、システムをカスタマイズする際、ハードウェア RAID 構成を選択するとコンピュータの価格にそれと分かるくらいの変化があるはずです。

==セットアップ==
[[公式リポジトリ]]から {{Pkg|mdadm}} をインストールして下さい。''mdadm'' は普通のブロックデバイスを使って純粋なソフトウェア RAID を組むのに使われます: 元となるハードウェアは RAID ロジックを全く搭載せず、ディスクだけ供給します。''mdadm'' はどんな組み合わせのブロックデバイスでも使うことができます。あまり一般的でない組み合わせであってもです。例えば、サムドライブを集めて RAID アレイを作成することが可能です。

===デバイスの準備===
{{Warning|このステップではデバイス上の全てのデータを消去します、消去を行うデバイスを間違えないように気をつけて入力して下さい。}}

問題が発生しないように RAID の各デバイスで中身を[[ディスクの完全消去|完全に消去]]したほうが良いでしょう。デバイスを既存のアレイから再利用する場合、古い RAID 設定情報を全て削除して下さい:
# mdadm --zero-superblock /dev/<drive>

もしくはドライブの特定パーティションを削除する場合は:
# mdadm --zero-superblock /dev/<partition>

{{Note|パーティションのスーパーブロックを消去してもディスク上の他のパーティションに影響を与えることはありません。}}

===パーティションテーブルの作成===
アレイで使用する前にディスクをパーティションすることが強く推奨されます。ほとんどの RAID ユーザーは 2 TB 以上の HDD を選択するため、GPT パーティションテーブルが必須または推奨です。{{Pkg|gptfdisk}} を使うことでディスクを簡単にパーティションすることができます。

* 作成後、パーティションのタイプにはヘックスコード FD00 を指定してください。
* 巨大なディスクアレイを用いる場合、ディスクを後で区別しやすくするために[[永続的なブロックデバイスの命名#by-label|ディスクラベル]]や[[永続的なブロックデバイスの命名#by-partlabel|パーティションラベル]]を付けるようにしてください。
* 各デバイスに作成するパーティションのサイズは同じ大きさにすることを推奨します。
* パーティションするときはデバイスの末端に 100 MB の空きスペースを残すと良いでしょう。根拠は下を見て下さい。

{{Note|(パーティションを作らずに) 生のディスク上に直接 RAID を作成することも可能ですが、故障したディスクを交換するときに問題が起こることがあるのであまり推奨されません。}}

RAID の故障したディスクを置き換える時は、新しいディスクの容量は故障したディスクのサイズと全く同じまたはそれ以上でなくてはなりません - そうでないとアレイの再作成プロセスが作動しません。同じメーカーの同じモデルのハードドライブだとしても容量には多少の誤差があることがあります。ディスクの最後に未使用のスペースを残しておくことでドライブ間の容量の違いを埋め合わせることができ、また、ドライブの機種を置き換えることが楽になります。従って、'''ディスクの最後に未割り当て領域を 100 MB 残しておくことはグッドプラクティスと言えます'''。

====MBR を使う場合のパーティションタイプ====
MBR パーティションテーブルの HDD にパーティションを作成する場合、使用するパーティションタイプは以下になります:

* 0xDA (ファイルシステム以外のデータ用 -- 現在 [https://raid.wiki.kernel.org/index.php/Partition_Types kernel.org] によって推奨されています)
* 0xFD (raid の自動検出アレイ -- initrd を起動してカーネルモジュールをロードするようになるまでは使われていました)

===アレイの作成===
{{Warning|現在、カーネルのバージョン 4.2.x と 4.3.x には RAID10 アレイを作成できないというバグが存在します。RAID10 レイアウトを作る必要がある場合は、バグが修正されるまで、{{pkg|linux-lts}} のカーネルバージョン 4.1.x シリーズを使うことが推奨されます。詳しくは [[#参照]] セクションを見て下さい。}}

{{ic|mdadm}} を使ってアレイを作成します。以下では複数の例をあげています。
{{Warning|下のサンプルをコピーペーストするだけですませないでください。頭を使って適切なオプション・ドライブ文字に置き換えましょう。}}

{{Note|RAID1 アレイを [[Syslinux]] から起動する場合 syslinux v4.07 の制限として metadata の値をデフォルトの 1.2 ではなく 1.0 にする必要があります。}}

以下の例では2つのデバイスによる RAID1 アレイを作成します:
# mdadm --create --verbose --level=1 --metadata=1.2 --chunk=64 --raid-devices=2 /dev/md0 /dev/sdb1 /dev/sdc1
{{Note|実際には RAID1 では chunk スイッチは必要ありません。}}

以下の例では4つのデバイスによる RAID5 アレイを作成します:
# mdadm --create --verbose --level=5 --metadata=1.2 --chunk=256 --raid-devices=4 /dev/md0 /dev/sdb1 /dev/sdc1 /dev/sdd1 /dev/sde1 --spare-devices=1 /dev/sdf1

以下の例では2つのデバイスによる RAID10 (far2) アレイを作成します:

# mdadm --create --verbose --level=10 --metadata=1.2 --chunk=512 --raid-devices=2 --layout=f2 /dev/md0 /dev/sdb1 /dev/sdc1

{{Tip|{{ic|--homehost}} と {{ic|--name}} オプションを使うことで raid デバイスにカスタム名称を付けることができます。名前はコロンで区切られます。}}

アレイは仮想デバイス {{ic|/dev/mdX}} 下に作成され、編成されて (縮退モードで) 使用できるようになります。バックグラウンドで mdadm がアレイをリシンクしている間、仮想デバイスを使って直接起動することが可能です。パリティのリストアには長い時間かかるかもしれません。次のコマンドで進捗を確認できます:
$ cat /proc/mdstat

===設定ファイルの更新===

新しい RAID アレイを作成した後は、デフォルトの設定ファイルである {{ic|mdadm.conf}} を以下のようにして更新する必要があります:
# mdadm --detail --scan >> /etc/mdadm.conf

このコマンドを実行したらテキストファイルで {{ic|mdadm.conf}} 設定ファイルをチェックして中身が問題ないか確認してください。

===アレイの構築===

設定ファイルを更新できたら mdadm を使ってアレイを構築することができます:

# mdadm --assemble --scan

===RAID ファイルシステムのフォーマット===
アレイは他のディスクと同じようにフォーマットすることができます、覚えておくべきことは:
* ボリュームサイズが巨大になるため適合しないファイルシステムが存在します (参照: [[Wikipedia:Comparison of file systems#Limits|ファイルシステムの制限]])。
* オンラインでのサイズの拡大や縮小に対応しているファイルシステムがふさわしいでしょう (参照: [[Wikipedia:Comparison of file systems#Features|ファイルシステムの機能]])。
* パフォーマンスを最適化するために適切なストライドとストライプ幅を計算するべきです。

==== ストライドとストライプ幅の計算 ====

まずはストライドを計算してください:

ストライド = (チャンクサイズ / ブロックサイズ)

最適なストライドを計算するために、以下に注意してください:
* Arch では大抵のファイルシステムのデフォルトブロックサイズは 4096 (4 KiB) です。詳しくは {{ic|/etc/mke2fs.conf}} を見て下さい。
* ''チャンクサイズ''はユーザーが指定することができる 4K (1ブロック: [[Advanced Format]] ディスクでない場合は512バイト) から 64K まで、あるいはそれ以上の値です。{{ic|mdadm}} のデフォルトで選択されるチャンクサイズは 512 KiB です ({{ic|<nowiki># mdadm --detail /dev/mdX | grep 'Chunk Size'</nowiki>}} で確認できます)。巨大なファイルを日常的に使用する場合 (ビデオ編集やグラフィック処理など)、チャンクサイズを小さくすることで巨大なファイルのアクセス速度を向上させることができます。

{{Tip|最適なチャンクサイズについては [http://www.zdnet.com/article/chunks-the-hidden-key-to-raid-performance/ Chunks: the hidden key to RAID performance] を参照してください。}}

次に、ストライプ幅を計算してください:

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)

===== 例 1. RAID0 =====
適切なストライプ幅とストライドで ext4 にフォーマットする例:
* 仮に2つの物理ディスクで構成される RAID0 アレイとします。
* チャンクサイズは 64k。
* ブロックサイズは 4k。

ストライド = (チャンクサイズ / ブロックサイズ)。この例では、(64/4) となりストライド = 16です。

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)。この例では、(2*16) となりストライプ幅 = 32です。

# mkfs.ext4 -v -L myarray -m 0.5 -b 4096 -E stride=16,stripe-width=32 /dev/md0

===== 例 2. RAID5 =====
適切なストライプ幅とストライドで ext4 にフォーマットする例:
* 仮に4つの物理ディスクで構成される RAID5 アレイとします。3つはデータディスクで1つはパリティディスクです。
* チャンクサイズは 256k。
* ブロックサイズは 4k。

ストライド = (チャンクサイズ / ブロックサイズ)。この例では、(256/4) となりストライド = 64です。

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)。この例では、(3*64) となりストライプ幅 = 192です。

# mkfs.ext4 -v -L myarray -m 0.5 -b 4096 -E stride=64,stripe-width=192 /dev/md0

===== 例 3. RAID10 (far2) =====
適切なストライプ幅とストライドで ext4 にフォーマットする例:
* 仮に2つの物理ディスクで構成される RAID10 アレイとします。far2 レイアウトの RAID10 なので当然、2つともデータディスクになります。
* チャンクサイズは 512k。
* ブロックサイズは 4k。

ストライド = (チャンクサイズ / ブロックサイズ)。この例では、(512/4) となりストライド = 128です。

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)。この例では、(2*128) となりストライプ幅 = 256です。

# mkfs.ext4 -v -L myarray -m 0.01 -b 4096 -E stride=128,stripe-width=256 /dev/md0

== ライブ CD からマウント ==
ライブ CD から RAID パーティションをマウントしたい場合、次のコマンドを使います:
# mdadm --assemble /dev/<disk1> /dev/<disk2> /dev/<disk3> /dev/<disk4>

ディスクアレイが存在しないのに誤って RAID 1 と認識されて ({{ic|mdadm --detail /dev/md<number>}})、inactive と報告される場合 ({{ic|cat /proc/mdstat}})、先にアレイを停止してください:
# mdadm --stop /dev/md<number>

== RAID に Arch Linux をインストール ==
{{Note|以下のセクションは root ファイルシステムがアレイ上にある場合にのみ当てはまります。データパーティションをアレイに収納する場合はこのセクションをスキップしてかまいません。}}
インストール手順の[[パーティショニング]]と[[ファイルシステム#デバイスのフォーマット|フォーマット]]の間に RAID アレイを作成してください。root ファイルシステムにするパーティションを直接フォーマットする代わりに、RAID アレイの上に作成します。[[#セットアップ|セットアップ]]セクションの指示に従って RAID アレイを作成してください。その後はインストールの手順に従って pacstrap のステップが完了するところまで進みます。[[Unified Extensible Firmware Interface|UEFI]] で起動する場合、[[EFI システムパーティション#RAID 上に ESP を配置]]も読んでください。

=== 設定ファイルの更新 ===
{{Note|以下は chroot の外で実行します、そしてファイルパスには /mnt を前に付けます。}}
ベースシステムをインストールしたら、デフォルトの設定ファイル {{ic|mdadm.conf}} を次のようにして更新する必要があります:
# mdadm --detail --scan >> /mnt/etc/mdadm.conf

上のコマンドを実行した後は、かならずテキストエディタを使って mdadm.conf 設定ファイルをチェックして中身が問題ないか確認してください。

{{Note|起動時に (デフォルトで有効になる) ''mdmonitor'' が失敗しないようにするには、{{ic|mdadm.conf}} の一番下にある '''MAILADDR''' をアンコメントして、アレイに問題が起こった時に通知が行くメールアドレスかアプリケーションを記述してください。}}

インストールの手順に戻って “Initial ramdisk 環境の作成” のステップまで進んだら、次のセクションを見て下さい。

=== mdadm フックを mkinitcpio.conf に追加する ===
{{Note|以下は chroot 中に実行します。}}
init イメージに直接 mdadm のサポートを追加するために [[mkinitcpio]] の [[Mkinitcpio#HOOKS|HOOKS]] セクションに {{ic|mdadm_udev}} を追加してください:
HOOKS="base udev autodetect block '''mdadm_udev''' filesystems usbinput fsck"

HOOKS に変更を加えた後は initramfs イメージを再生成します ([[Mkinitcpio#イメージ作成とアクティベーション|イメージ作成とアクティベーション]]を参照):
# mkinitcpio -p linux

=== ブートローダーの設定 ===

RAID アレイごとに {{ic|md}} [[カーネルパラメータ]]を追加してください。また、{{ic|root}} パラメータでマッピングするデバイスを正しく指定します。以下の例では三つの RAID 1 アレイを記述しており適当な一つを root として設定しています:
root=/dev/md1 md=0,/dev/sda2,/dev/sdb2 md=1,/dev/sda3,/dev/sdb3 md=2,/dev/sda4,/dev/sdb4

上記のカーネルデバイスノードによる方法だとソフトウェア raid パーティションからの起動が失敗する場合、もうひとつの信頼性のある方法としてパーティションラベルを使う方法があります:
root=LABEL=Root_Label

[[GRUB#RAID]] も参照してください。

== RAID のメンテナンス ==
=== スクラビング ===
誤りをチェック・修正するために定期的にデータ[[wikipedia:Data_scrubbing|スクラビング]]を実行するのは良い習慣です。アレイのサイズや設定にもよりますが、スクラブは完了するまでかなり時間がかかります。

データスクラブを開始するには:
# echo check > /sys/block/md0/md/sync_action

check オペレーションは不良セクタがないかドライブをスキャンして自動的に不良セクタを修復します。不良データ (他のディスクが示すデータと一致しないセクタのデータ、例えば、パリティブロックと他のデータブロックによって該当するデータブロックが不正だと判断される場合など) を含んでいる良好セクタを見つけた場合、対処は何もされませんが、イベントが記録されます (下を参照)。"何もされない"ことで、管理者はセクタのデータと、重複するデータからセクタを再生成することで得られるデータを検査して正しいデータを選んで保持することができます。

mdadm に関連する様々なタスクやアイテムと同様に、スクラブの状態は {{ic|/proc/mdstat}} を読み出すことで調べることができます。

例:
{{hc|$ cat /proc/mdstat|<nowiki>
Personalities : [raid6] [raid5] [raid4] [raid1]
md0 : active raid1 sdb1[0] sdc1[1]
3906778112 blocks super 1.2 [2/2] [UU]
[>....................] check = 4.0% (158288320/3906778112) finish=386.5min speed=161604K/sec
bitmap: 0/30 pages [0KB], 65536KB chunk
</nowiki>}}

実行中のデータスクラブを安全に停止するには:
# echo idle > /sys/block/md0/md/sync_action

{{Note|スクラブを途中で中止した後にシステムを再起動してしまうと、スクラブはもういちど最初からやり直されます。}}

スクラブが完了したら、(不良セクタがあった場合) いくつのブロックが不良として判断されたか確認することができます:
# cat /sys/block/md0/md/mismatch_cnt

==== スクラビングの一般的な注意事項 ====
{{Note|ユーザーは /sys/block/md0/md/sync_action に '''repair''' を echo することもできますが、データにミスマッチが発生したとき、一貫性のために自動的に更新が行われるため、推奨されません。正しいパリティまたはデータブロックなのか (RAID1 の場合どちらのデータブロックなのか) 判断することができないのが危険です。この操作によって間違ったデータではなく正しいデータが選択されるかどうかは一か八かです。}}

定期的にスクラブを root で実行する cron ジョブを設定するのは良い考えです。ジョブの設定に役立つ {{AUR|raid-check}} を見て下さい。cron の代わりに systemd タイマーを使ってスクラブを実行したい場合は {{AUR|raid-check-systemd}} をインストールしてください。systemd タイマーのユニットファイルとスクリプトが含まれています。

==== スクラビングの RAID1 と RAID10 の注意事項 ====
カーネルにおける RAID1 と RAID10 の書き込みはバッファがないため、アレイが問題ないときでもアレイにゼロ以外のミスマッチがカウントされることがあります。このようなゼロ以外のカウントは一時的なデータ領域にしか存在せず、問題は起こりません。しかしながら、一時的なデータのゼロ以外のカウントと実際に問題が起こっていることを示すゼロ以外のカウントを見分けることはできません。このために RAID1 や RAID10 アレイでは誤検知が発生することがあります。それでもデバイスにあるかもしれない不良セクタを見つけて直すために定期的にスクラブすることを推奨します。

===アレイからデバイスを削除する===
アレイからデバイスを削除する際は削除する前にそのデバイスが壊れているとマークを付けます:
# mdadm --fail /dev/md0 /dev/sdxx

そしてアレイからデバイスを削除します:
# mdadm -r /dev/md0 /dev/sdxx

ドライブを完全に削除するときは (例えば、今後別の方法で使用する) 上記の2つのコマンドを実行した後に:

# mdadm --zero-superblock /dev/sdxx

{{Warning|
* 上記のコマンドを RAID0 アレイで実行してはいけません。データが消失してしまいます。
* 削除したディスクのスーパーブロックを消去せずに再利用した場合、再起動時に全てのデータが消失します。}}

アレイの使用を停止:
# 対象のアレイをアンマウント
# 次のコマンドでアレイを停止: {{ic|mdadm --stop /dev/md0}}
# セクションの最初に書かれている3つのコマンドを各デバイスで繰り返し実行。
# {{ic|/etc/mdadm.conf}} から対応する行を削除

=== アレイに新しいデバイスを追加する ===
デバイスがマウントされている動作中のシステム上で mdadm を使って新しいデバイスを追加することができます。上述しているように既存のアレイの一つとして同じレイアウトを使って新しいデバイスをパーティションしてください。

RAID アレイを構築していない場合は構築します:
# mdadm --assemble /dev/md0 /dev/sda1 /dev/sdb1

アレイに新しいデバイスを追加:
# mdadm --add /dev/md0 /dev/sdc1

mdadm がデバイスを追加するのにはあまり時間はかかりません。進捗を確認するには:
# cat /proc/mdstat

デバイスが追加されたかは次のコマンドで確認:
# mdadm --misc --detail /dev/md0

==== RAID0 アレイの場合 ====

以下のようなエラーが表示された場合:
mdadm: add new device failed for /dev/sdc1 as 2: Invalid argument

これはおそらく RAID0 を使っていることが原因です。上のコマンドは新しいディスクを"スペア"として追加しますが、RAID0 にはスペアは存在しません。RAID0 アレイにデバイスを追加したいときは、一つのコマンドで "grow" して "add" する必要があります:
# mdadm --grow /dev/md0 --raid-devices=3 --add /dev/sdc1

=== RAID ボリュームのサイズを増やす ===

RAID アレイに巨大なディスクを追加した場合やパーティションサイズを増やした場合、RAID ボリュームのサイズを増加させて空き領域を埋めると良いでしょう。まずは上のセクションに従って RAID ボリュームを再構築してください。再構築が完了したら領域を埋めるように拡張してください:
# mdadm --grow /dev/md0 --size=max
そして RAID ボリューム {{ic|/dev/md0}} に存在するパーティションのサイズを変更してください。詳しくは[[パーティショニング]]を参照。最後に、パーティション内のファイルシステムをリサイズしてください。{{ic|gparted}} でパーティショニングした場合、自動的にリサイズされます。他のツールを使った場合、パーティションをアンマウントして手動でファイルシステムをリサイズしてください:
{{bc|
# umount /storage
# fsck.ext4 -f /dev/md0p1
# resize2fs /dev/md0p1
}}

=== 同期速度の制限を変更 ===

同期には時間がかかります。マシンで他の作業をしていない場合、速度制限を上げることが可能です。

{{hc|# cat /proc/mdstat|<nowiki>
Personalities : [raid1]
md0 : active raid1 sda3[2] sdb3[1]
155042219 blocks super 1.2 [2/1] [_U]
[>....................] recovery = 0.0% (77696/155042219) finish=265.8min speed=9712K/sec

unused devices: <none>
</nowiki>}}

現在の制限速度を確認:

{{hc|# cat /proc/sys/dev/raid/speed_limit_min|
1000
}}
{{hc|# cat /proc/sys/dev/raid/speed_limit_max|
200000
}}

制限を上げる:

# echo 400000 >/proc/sys/dev/raid/speed_limit_min
# echo 400000 >/proc/sys/dev/raid/speed_limit_max

上記の設定後、同期速度と予想完了時間を確認してみてください:

{{hc|# cat /proc/mdstat|<nowiki>
Personalities : [raid1]
md0 : active raid1 sda3[2] sdb3[1]
155042219 blocks super 1.2 [2/1] [_U]
[>....................] recovery = 1.3% (2136640/155042219) finish=158.2min speed=16102K/sec

unused devices: <none>
</nowiki>}}

[[sysctl#MDADM]] も参照してください。

== 監視 ==
RAID デバイスの状態を出力するシンプルなワンライナー:
{{hc|awk '/^md/ {printf "%s: ", $1}; /blocks/ {print $NF}' </proc/mdstat
|md1: [UU]
md0: [UU]
}}

===Watch mdstat===
{{bc|watch -t 'cat /proc/mdstat'}}
または {{pkg|tmux}} を使う場合:
{{bc|tmux split-window -l 12 "watch -t 'cat /proc/mdstat'"}}

===iotop で IO を追跡===
{{pkg|iotop}} パッケージはプロセスの入出力の統計を表示します。次のコマンドを使って raid スレッドの IO を表示することができます。

{{bc|<nowiki>iotop -a -p $(sed 's, , -p ,g' <<<`pgrep "_raid|_resync|jbd2"`)</nowiki>}}

===iostat で IO を追跡 ===

{{Pkg|sysstat}} パッケージに入っている ''iostat'' ユーティリティはデバイスやパーティションの入出力の統計を表示します。

iostat -dmy 1 /dev/md0
iostat -dmy 1 # all

===イベントでメールを送信===
smtp メールサーバー (sendmail) かメールフォワーダ (ssmtp/msmtp) が必要です。おそらく一番シンプルな方法は {{AUR|dma}} を使うことです。とても小さく (インストール容量 0.08 MiB) でセットアップがいりません。

{{ic|/etc/mdadm.conf}} を編集して通知を受信するメールアドレスを指定します。
{{Note|上記のとおり dma を使用する場合、外部のメールアドレスではなくローカルホストのユーザー名に直接メールを送ることができます。}}

設定をテストするには:
# mdadm --monitor --scan --oneshot --test

[[mdadm]] には監視作業を行う systemd サービス (mdmonitor.service) が含まれているため、ここで、やるべきことはもうありません。{{ic|/etc/mdadm.conf}} でメールアドレスを設定していないと、サービスは失敗します。mdadm イベントでメールを受けとりたくない場合は、サービスの失敗は無視してかまいません。通知を表示したくなく、失敗メッセージが気になるならば、ユニットをマスクしてください。

==== その他の方法 ====

smtp メールサーバーやメールフォワーダをインストールする代わりに、既存の [[S-nail]] ツールを使うこともできます (忘れずにセットアップしてください)。

以下の内容で {{ic|/etc/mdadm_warning.sh}} という名前のファイルを作成:

#!/bin/bash
event=$1
device=$2

echo " " | /usr/bin/mailx -s "$event on $device" '''destination@email.com'''

実行権限を与えます: {{ic|chmod +x /etc/mdadm_warning.sh}}

それから {{ic|mdadm.conf}} にこのファイルを追加してください:

PROGRAM /etc/mdadm_warning.sh

前記の方法と同じ方法でテスト・有効化します。

==トラブルシューティング==
再起動した時に "invalid raid superblock magic" というエラーが表示される場合、ハードドライブを追加したときは、ハードドライブの順番が正しいか確認してください。インストール時の RAID デバイスは hdd, hde, hdf だったとしても起動時には hda, hdb, hdc になっているかもしれません。カーネルラインをそれにあわせて修正してください。

===エラー: "kernel: ataX.00: revalidation failed"===
突然 (再起動後または BIOS の設定を変更した後) 以下のようなエラーメッセージが表示された場合:

Feb 9 08:15:46 hostserver kernel: ata8.00: revalidation failed (errno=-5)

これは必ずしもドライブが壊れたことを意味しているわけはありません。要するに、まだあわてるような時間じゃありません。BIOS やカーネルパラメータで APIC または ACPI 設定を変更した場合、設定を戻せば問題ないはずです。大抵は、ACPI をオフにすれば直ります。

===読み取り専用でアレイを起動===
md アレイが起動すると、スーパーブロックが書き出され、resync が走ることがあります。読み取り専用で起動するにはカーネルモジュール {{ic|md_mod}} のパラメータ {{ic|start_ro}} を設定します。これが設定されている場合、新しいアレイは 'auto-ro' モードになり、内部 io (スーパーブロックの更新, resync, recovery) が全て無効化されて、書き込みリクエストが来た時に初めて 'rw' に自動的に切り替わります。

{{Note|最初の書き込みリクエストがある前に {{ic|mdadm --readonly}} を使うことでアレイを完全な 'ro' モードに設定できます。また、{{ic|mdadm --readwrite}} で書き込みを行わないで再同期を開始できます。}}

起動時にパラメータを設定するには、カーネル行に {{ic|<nowiki>md_mod.start_ro=1</nowiki>}} を追加してください。

もしくはモジュールのロード時に {{ic|/etc/modprobe.d/}} ファイルや {{ic|/sys/}} から直接設定します。
{{bc|echo 1 > /sys/module/md_mod/parameters/start_ro}}

===raid の故障したまたは存在しないドライブからリカバリする===
何らかの理由でドライブの一つが壊れた時も上述のエラーが表示されることがあります。その場合、ディスクが一つ足りない状態でも raid がオンになるようにしなくてはなりません。次のコマンドを入力 (必要に応じて変更してください):
# mdadm --manage /dev/md0 --run

これで次のようにしてまたマウントできるようになったはずです (fstab で記述している場合):
# mount /dev/md0

raid がまた動作するようになって使えるようにはなりましたが、ディスクが一つ不足しています。ディスクを追加するために[[#デバイスの準備|デバイスの準備]]で記述しているようにしてパーティションしてください。パーティションしたら次のコマンドで raid に新しいディスクを追加できます:
# mdadm --manage --add /dev/md0 /dev/sdd1

次を入力すれば:
# cat /proc/mdstat
raid が有効になって再構築されたことが確認できるでしょう。

設定を更新しても良いかもしれません (参照: [[#設定ファイルの更新|設定ファイルの更新]])。

== ベンチマーク ==
RAID をベンチマークするツールは複数存在します。同じ RAID ボリュームからマルチスレッドで読み取るときの速度向上が一番の改善点になります。

{{AUR|tiobench}}{{Broken package link|パッケージが存在しません}} はフルスレッドによるディスク I/O を計測することでパフォーマンスがどれくらい向上したかベンチマークします。

{{Pkg|bonnie++}} はひとつまたは複数のファイルへのデータベースタイプのアクセスをテストしたり、小さなファイルを作成・読込・削除することで Squid や INN、または Maildir フォーマットのメールなどといったプログラムの使用をシミュレートします。同梱されている [http://www.coker.com.au/bonnie++/zcav/ ZCAV] プログラムはディスクに書き込みを行わずにハードドライブの領域のパフォーマンスをテストします。

{{ic|hdparm}} を RAID のベンチマークに使っては'''いけません'''、出てくる結果には全く一貫性がありません。

== 参照 ==
* Linux カーネルアーカイブの [http://raid.wiki.kernel.org/index.php/Linux_Raid Linux RAID wiki エントリ]
* [https://raid.wiki.kernel.org/index.php/Write-intent_bitmap How Bitmaps Work]
* Red Hat Enterprise Linux 6 ドキュメントの [https://access.redhat.com/documentation/ja-JP/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/ch-raid.html 第17章: Redundant Array of Independent Disks (RAID)]
* [http://tldp.org/FAQ/Linux-RAID-FAQ/x37.html Linux-RAID FAQ] on the Linux Documentation Project
* [http://support.dell.com/support/topics/global.aspx/support/entvideos/raid?c=us&l=en&s=gen Dell.com Raid Tutorial] - Interactive Walkthrough of Raid
* [http://www.miracleas.com/BAARF/ BAARF] including ''[http://www.miracleas.com/BAARF/RAID5_versus_RAID10.txt Why should I not use RAID 5?]'' by Art S. Kagel
* [http://www.linux-mag.com/id/7924/ Introduction to RAID], [http://www.linux-mag.com/id/7931/ Nested-RAID: RAID-5 and RAID-6 Based Configurations], [http://www.linux-mag.com/id/7928/ Intro to Nested-RAID: RAID-01 and RAID-10], and [http://www.linux-mag.com/id/7932/ Nested-RAID: The Triple Lindy] in Linux Magazine
* [http://www.cyberciti.biz/tips/linux-raid-increase-resync-rebuild-speed.html HowTo: Speed Up Linux Software Raid Building And Re-syncing]
* [http://fomori.org/blog/?p=94 RAID5-Server to hold all your data]

'''既知のバグ'''
* [http://marc.info/?l=linux-raid&m=144960710718870&w=2 linux-raid ML #1]
* [http://marc.info/?l=linux-raid&m=144830809503689&w=2 linux-raid ML #2]

'''mdadm'''
* [http://anonscm.debian.org/gitweb/?p=pkg-mdadm/mdadm.git;a=blob_plain;f=debian/FAQ;hb=HEAD Debian mdadm FAQ]
* [https://www.kernel.org/pub/linux/utils/raid/mdadm/ mdadm ソースコード]
* [http://www.linux-mag.com/id/7939/ Software RAID on Linux with mdadm] in Linux Magazine

'''フォーラムスレッド'''
* [http://forums.overclockers.com.au/showthread.php?t=865333 Raid Performance Improvements with bitmaps]
* [https://bbs.archlinux.org/viewtopic.php?id=125445 GRUB and GRUB2]
* [https://bbs.archlinux.org/viewtopic.php?id=123698 Can't install grub2 on software RAID]
* [https://forums.gentoo.org/viewtopic-t-888624-start-0.html Use RAID metadata 1.2 in boot and root partition]

'''RAID と暗号化'''
* [http://www.shimari.com/dm-crypt-on-raid/ Linux/Fedora: Encrypt /home and swap over RAID with dm-crypt] by Justin Wells

NVIDIA Optimus

2022-08-20T14:50:29Z

Shota: /* いくつかの方法 */ 英語版を元に他の手法について追記

[[Category:グラフィック]]
[[en:NVIDIA Optimus]]
[[ru:NVIDIA Optimus]]
[[zh-hans:NVIDIA Optimus]]
{{Related articles start}}
{{Related|PRIME}}
{{Related|Bumblebee}}
{{Related|Nouveau}}
{{Related|NVIDIA}}
{{Related|nvidia-xrun}}
{{Related|External GPU}}
{{Related articles end}}

[[Wikipedia:NVIDIA Optimus|NVIDIA Optimus]] は Intel の内蔵 GPU とディスクリートの NVIDIA GPU をノートパソコンに組み込んで利用できるようにする技術です。

== いくつかの方法 ==

* [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E3.82.A4.E3.83.B3.E3.83.86.E3.83.AB.E3.81.AE.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.81.AE.E3.81.BF.E3.82.92.E4.BD.BF.E7.94.A8 インテルのグラフィックスのみを使用] -NVIDIA GPU の電源は完全にオフになるため、消費電力を節約できます。
* [[NVIDIA_Optimus#nvidia グラフィックのみを使用|nvidia グラフィックのみを使用]] -インテルグラフィックスよりもパフォーマンスは向上しますが、より多くのバッテリを消費します (モバイルデバイスには適していません) 。これは、 [[#optimus-manager を使用する|optimus-manager ]] および [[#nvidia-xrun を使用する|nvidia-xrun]] オプションと同じ基本プロセスを利用しており、より自動化されたアプローチの1つを選択する前に、一般的な機能のトラブルシューティングおよび検証する必要があります。
* 両方を使用する (必要に応じて NVIDIA GPU を使用し、電源を切ったままにして電力を節約する) :
** [[#PRIME レンダリングオフロードを使用する]] -NVIDIA が公式にサポートしている方法です。
** [[#optimus-manager を使用する]] -1つのコマンドでグラフィックスを切り替えます (有効にするにはログアウトとログインが必要です) NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。1.4リリース以降では、AMD と NVIDIA の組み合わせもサポートされています。
** [[#nvidia-xrun を使用する]] -NVIDIA グラフィックスを使用して別の TTY で別の X セッションを実行します。NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。
** [[#Bumblebee を使用]] -インテルのグラフィックスを他のすべてのものに使用しながら、選択したアプリケーションをNVIDIA のグラフィックスで実行できるようにすることで、Windows に似た機能を提供します。しかし、パフォーマンスに重大な問題があります。
** [[#nouveau を使う]] -独自の NVIDIA ドライバと比較してパフォーマンスが低く、スリープと休止状態で問題が発生する可能性があります。最新の NVIDIA GPU では動作しません。
** [[#EnvyControl を使用する]] - optimus-manager と同様な方法ですが、大量な設定なしで使えます。またバックグラウンドでデーモンを実行する必要もなく、GNOME ユーザーであっても GDM のパッチバージョンをインストールする必要もありません。
** [[#NVidia-eXec を使用する]] - Bumblebee と同様ですが、パフォーマンス低下の問題の影響はありません。Xorg と Wayland で動作します。ただし、この手法はまだ実験段階で、GNOME/GDM の環境下でのみテストされているだけです。
** [[#nvidia-switch を使用する]] - nvidia-xrun と同様な手法ですが、TTY を変更する必要がありません。切替はディスプレイマネージャ下でのログインとログアウトによって行われます。しかしながら、このパッケージは Debian ライクなシステムでのみテストされているだけです。とはいっても、nvidia-xrun と同様、他の Linux システム全てで動作するはずです。

{{Note|これらのオプションはすべて相互に排他的です。1つの方法をテストして別の方法を選択する場合は、別の方法を試行する前に、1つの方法に従って行われた構成変更を必ず元に戻す必要があります。そうしないと、ファイルの競合や未定義の動作が発生する可能性があります。}}

== インテルのグラフィックスのみを使用 ==

特定の GPU のみに切り替えずに使用する場合は、システムの BIOS でオプションを確認してください。いずれかのカードを無効にするオプションがあるはずです。ラップトップによっては、個別のカードを無効にすることしかできない場合や、その逆の場合がありますが、カードのうちの1つだけを使用する予定があるかどうかを確認してください。

BIOS が Nvidia グラフィックスを無効にできない場合は、Linux カーネル自体から無効にできます。[[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

=== レンダリングプロバイダを切り替えずに CUDA を使用 ===

CUDA は、NVIDIA グラフィックスにレンダリングを切り替えることなく使用できます。CUDA アプリケーションを起動する前に、NVIDIA カードの電源が入っていることを確認するだけです。詳細については、 [[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

これで、CUDA アプリケーションを起動すると、必要なすべてのカーネルモジュールが自動的にロードされます。CUDA の使用後に NVIDIA カードの電源を切る前に、まず {{ic|nvidia}} カーネルモジュールをアンロードする必要があります。

#rmmod nvidia_uvm
#rmmod NVIDIA

== nvidia グラフィックのみを使用 ==

[[NVIDIA|プロプライエタリの NVIDIA ドライバー]]は nouveau ドライバーのような動的な切り替えはサポートしていません (つまり NVIDIA デバイスしか使用できません)。また、NVIDIA は画面にティアリングが発生する問題を認識していますが未だに修正がなされていません。そのかわり、ディスクリート GPU を利用して nouveau ドライバーよりも高い性能を発揮することができます (2017年1月現在)。

まず {{Pkg|nvidia}} と {{Pkg|xorg-xrandr}} パッケージをインストールしてください。

そして、{{ic|xorg.conf}} を設定します。NVIDIA カードの PCI アドレスを知る必要があるので、次のコマンドを実行してください:

$ lspci | grep -E "VGA|3D"

NVIDIA と書かれた行の最初の7文字が PCI アドレスです。例えば {{ic|01:00.0}} などと表記されます。{{ic|xorg.conf}} では {{ic|#:#:#}} という形式で表記する必要があります。例えば {{ic|01:00.0}} の場合 {{ic|1:0:0}} となります。

{{Note|セットアップによっては EDID ファイルによる nvidia ドライバーのディスプレイの値の自動検出がされなくなることがあります。解決方法は [[#解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される]] を見て下さい。}}

{{hc|/etc/X11/xorg.conf.d/10-nvidia-drm-outputclass.conf|
Section "OutputClass"
Identifier "intel"
MatchDriver "i915"
Driver "modesetting"
EndSection

Section "OutputClass"
Identifier "nvidia"
MatchDriver "nvidia-drm"
Driver "nvidia"
Option "AllowEmptyInitialConfiguration"
Option "PrimaryGPU" "yes"
ModulePath "/usr/lib/nvidia/xorg"
ModulePath "/usr/lib/xorg/modules"
EndSection

}}

次に、{{ic|~/.xinitrc}} の最初に以下の2行を追加してください:

{{hc|~/.xinitrc|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

そしてドライバーをロードするために再起動し、X を起動させます。

ディスプレイの dpi が正しくない場合は以下の行を追加してください:

xrandr --dpi 96

X の起動時に黒画面が表示される場合、{{ic|~/.xinitrc}} に記述した {{ic|xrandr}} コマンドの後にアンパサンドがないことを確認してください。アンパサンドがある場合、{{ic|xrandr}} コマンドが実行し終える前にウィンドウマネージャが起動してしまうことがあり、そうなると黒画面になってしまいます。

アンパサンドがないのに黒画面になる場合、下の [[#別の設定]] を見て下さい。

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

ディスプレイマネージャを使用する場合、{{ic|~/.xinitrc}} の代わりにディスプレイマネージャのディスプレイ設定スクリプトを作成・編集する必要があります。

==== LightDM ====

[[LightDM]] ディスプレイマネージャの場合:

{{hc|/etc/lightdm/display_setup.sh|
#!/bin/sh
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

スクリプトに実行可能属性を付与:

# chmod +x /etc/lightdm/display_setup.sh

{{ic|/etc/lightdm/lightdm.conf}} の {{ic|[Seat:*]}} セクションを編集してスクリプトを実行するように lightdm を設定:

{{hc|/etc/lightdm/lightdm.conf|output=
[Seat:*]
display-setup-script=/etc/lightdm/display_setup.sh
}}

再起動して、ディスプレイマネージャが起動するのを確認してください。

==== SDDM ====
[[SDDM]] ディスプレイマネージャの場合:

{{hc|/usr/share/sddm/scripts/Xsetup|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

==== GDM ====
[[GDM]] ディスプレイマネージャの場合 {{ic|.desktop}} ファイルを作成します:

{{hc|/usr/share/gdm/greeter/autostart/optimus.desktop|
<nowiki>[Desktop Entry]
Type=Application
Name=Optimus
Exec=sh -c "xrandr --setprovideroutputsource modesetting NVIDIA-0; xrandr --auto"
NoDisplay=true
X-GNOME-Autostart-Phase=DisplayServer</nowiki>
}}

また、GDM が [[GDM#Xorg バックエンドを使う|Xorg バックエンドを使う]]ようになっているか確認してください。

==== KDM ====

KDE の [[KDM]] の場合、{{ic|/usr/share/config/kdm/Xsetup}} に xrandr の行を追加してください。

=== 3D の確認 ===

NVIDIA グラフィックが使われているかどうかは {{Pkg|mesa-demos}} をインストールして次のコマンドを実行することで確認できます:

$ glxinfo | grep NVIDIA

=== 詳細情報 ===

詳しい情報は、NVIDIA の公式ページ [http://us.download.nvidia.com/XFree86/Linux-x86/370.28/README/randr14.html] を見て下さい。

== 切り替え可能なグラフィックスを使用 ==

=== PRIME レンダリングオフロードを使用する===

これは、切り替え可能なグラフィックスをサポートする公式の NVIDIA メソッドです。

詳細については、 [[PRIME#PRIME render offload]] を参照してください。

=== nouveau を使う===

グラフィックスイッチングについては [[PRIME]] を、オープンソースの NVIDIA ドライバについては [[nouveau]] を参照してください。

=== Bumblebee を使用===

[[Bumblebee]] を参照してください。

=== nvidia-xrun を使用する ===

[[nvidia-xrun]] を参照してください。

=== optimus-manager を使用する ===

[https://github.com/Askannz/optimus-manager Optimus-manager] アップストリームのドキュメントを参照してください。Arch Linux システムでのインストールと設定の両方の説明があります。

=== EnvyControl を使用する ===

アップストリームのドキュメント [https://github.com/geminis3/envycontrol EnvyControl] を参照してください。インストール方法と使い方の説明があります。

=== NVidia-eXec を使用する ===

アップストリームのドキュメント [https://github.com/pedro00dk/nvidia-exec NVidia-eXec] を参照してください。インストール方法と使い方の説明があります。

=== nvidia-switch を使用する ===

アップストリームのドキュメント [https://github.com/nvidiaswitch/nvidia-switch nvidia-switch] を参照してください。インストール方法と使い方の説明があります。

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

=== 垂直同期が機能せずティアリングが発生する ===

解決するには {{pkg|xorg-server}} 1.19 以上、{{pkg|linux}} カーネル 4.5 以上、{{pkg|nvidia}} 370.23 以上が必須です。[[NVIDIA#DRM カーネルモードセッティング]]を有効にすることで PRIME 同期が有効になりティアリングが解消されます。

詳しくは公式の [https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/ フォーラムスレッド] を参照してください。

=== Failed to initialize the NVIDIA GPU at PCI:1:0:0 (GPU fallen off the bus / RmInitAdapter failed!) ===

カーネルパラメータに {{ic|1=rcutree.rcu_idle_gp_delay=1}} を追加してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=169742 こちら] を参照。

=== 解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される ===

nVidia ドライバーがディスプレイの EDID を検出できないのが原因です。手動で EDID ファイルのパスを指定するか、同じような方法で同一の情報を提供する必要があります。

EDID ファイルのパスを指定するには {{ic|Xorg.conf}} の nvidia カードの Device セクションを編集して、以下の行を追加して適当にパスを置き換えてください:

{{hc|/etc/X11/xorg.conf|
Section "Device"
Option "ConnectedMonitor" "CRT-0"
Option "CustomEDID" "CRT-0:/sys/class/drm/card0-LVDS-1/edid"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
EndSection
}}

Xorg が起動しない場合は、CRT という文字列を全て DFB に置き換えてみて下さい。card0 は intel カードの識別子でディスプレイは LVDS で接続されています。edid バイナリはこのディレクトリに存在します。ハードウェアの構成が異なっている場合、CustomEDID の値も変わってくるので確認するようにしてください。パスの先頭の {{ic|/sys/class/drm}} は変わらないはずです。

または、{{Pkg|read-edid}} などのツールを使って edid を自分で作成して、作成したファイルを使うようにドライバーを設定することもできます。modeline も使えますが、"UseEDID" と "IgnoreEDID" は変更するようにしてください。

=== Wrong resolution without EDID errors ===

Using ''nvidia-xconfig'', incorrect information might be generated in Xorg.conf and in particular wrong monitor refresh rates that restruct the possible resolutions. Try commenting out the {{ic|HorizSync}}/{{ic|VertRefresh}} lines. If this helps, you can probably also remove everything else not mentioned in this article.

=== ロックアップ問題 (lspci がフリーズ) ===
GTX 965M が搭載された最新のノートパソコンで (Bumblebee などで) bbswitch や nouveau を使ったときに lspci がフリーズしたり、サスペンドが失敗したり、シャットダウン時に止まってしまったり、optirun でフリーズが発生することがあります。

dGPU 電源リソースがオンになっている場合、ACPI コードで失敗してフリーズが起こることがあります ([https://bugzilla.kernel.org/show_bug.cgi?id=156341 カーネルバグ 156341])。

解決方法については [https://github.com/Bumblebee-Project/Bumblebee/issues/764#issuecomment-234494238 こちら] を見てください。また、{{ic|1=acpi_osi="!Windows 2015"}} や {{ic|1=acpi_osi=! acpi_osi="Windows 2009"}} を[[カーネルパラメータ]]に追加して起動することで解決することもあります。

=== No screens found on a laptop/NVIDIA Optimus ===

Check if {{ic|<nowiki>$ lspci | grep VGA</nowiki>}}
outputs something similar to:
00:02.0 VGA compatible controller: Intel Corporation Core Processor Integrated Graphics Controller (rev 02)
01:00.0 VGA compatible controller: nVidia Corporation Device 0df4 (rev a1)

NVIDIA drivers now offer Optimus support since 319.12 Beta [https://www.nvidia.com/object/linux-display-amd64-319.12-driver.html] with kernels above and including 3.9.

Another solution is to install the [[Intel]] driver to handle the screens, then if you want 3D software you should run them through [[Bumblebee]] to tell them to use the NVIDIA card.

NVIDIA Optimus

2022-08-20T14:39:32Z

Shota: /* いくつかの方法 */ リンクの微調整

[[Category:グラフィック]]
[[en:NVIDIA Optimus]]
[[ru:NVIDIA Optimus]]
[[zh-hans:NVIDIA Optimus]]
{{Related articles start}}
{{Related|PRIME}}
{{Related|Bumblebee}}
{{Related|Nouveau}}
{{Related|NVIDIA}}
{{Related|nvidia-xrun}}
{{Related|External GPU}}
{{Related articles end}}

[[Wikipedia:NVIDIA Optimus|NVIDIA Optimus]] は Intel の内蔵 GPU とディスクリートの NVIDIA GPU をノートパソコンに組み込んで利用できるようにする技術です。

== いくつかの方法 ==

* [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E3.82.A4.E3.83.B3.E3.83.86.E3.83.AB.E3.81.AE.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.81.AE.E3.81.BF.E3.82.92.E4.BD.BF.E7.94.A8 インテルのグラフィックスのみを使用] -NVIDIA GPU の電源は完全にオフになるため、消費電力を節約できます。
* [[NVIDIA_Optimus#nvidia グラフィックのみを使用|nvidia グラフィックのみを使用]] -インテルグラフィックスよりもパフォーマンスは向上しますが、より多くのバッテリを消費します (モバイルデバイスには適していません) 。これは、 [[#optimus-manager を使用する|optimus-manager ]] および [[#nvidia-xrun を使用する|nvidia-xrun]] オプションと同じ基本プロセスを利用しており、より自動化されたアプローチの1つを選択する前に、一般的な機能のトラブルシューティングおよび検証する必要があります。
* 両方を使用する (必要に応じて NVIDIA GPU を使用し、電源を切ったままにして電力を節約する) :
** [[#PRIME レンダリングオフロードを使用する]] -NVIDIA が公式にサポートしている方法です。
** [[#optimus-manager を使用する]] -1つのコマンドでグラフィックスを切り替えます (有効にするにはログアウトとログインが必要です) NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。1.4リリース以降では、AMD と NVIDIA の組み合わせもサポートされています。
** [[#nvidia-xrun を使用する]] -NVIDIA グラフィックスを使用して別の TTY で別の X セッションを実行します。NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。
** [[#Bumblebee を使用]] -インテルのグラフィックスを他のすべてのものに使用しながら、選択したアプリケーションをNVIDIA のグラフィックスで実行できるようにすることで、Windows に似た機能を提供します。しかし、パフォーマンスに重大な問題があります。
** [[#nouveau を使う]] -独自の NVIDIA ドライバと比較してパフォーマンスが低く、スリープと休止状態で問題が発生する可能性があります。最新の NVIDIA GPU では動作しません。

{{Note|これらのオプションはすべて相互に排他的です。1つの方法をテストして別の方法を選択する場合は、別の方法を試行する前に、1つの方法に従って行われた構成変更を必ず元に戻す必要があります。そうしないと、ファイルの競合や未定義の動作が発生する可能性があります。}}

== インテルのグラフィックスのみを使用 ==

特定の GPU のみに切り替えずに使用する場合は、システムの BIOS でオプションを確認してください。いずれかのカードを無効にするオプションがあるはずです。ラップトップによっては、個別のカードを無効にすることしかできない場合や、その逆の場合がありますが、カードのうちの1つだけを使用する予定があるかどうかを確認してください。

BIOS が Nvidia グラフィックスを無効にできない場合は、Linux カーネル自体から無効にできます。[[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

=== レンダリングプロバイダを切り替えずに CUDA を使用 ===

CUDA は、NVIDIA グラフィックスにレンダリングを切り替えることなく使用できます。CUDA アプリケーションを起動する前に、NVIDIA カードの電源が入っていることを確認するだけです。詳細については、 [[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

これで、CUDA アプリケーションを起動すると、必要なすべてのカーネルモジュールが自動的にロードされます。CUDA の使用後に NVIDIA カードの電源を切る前に、まず {{ic|nvidia}} カーネルモジュールをアンロードする必要があります。

#rmmod nvidia_uvm
#rmmod NVIDIA

== nvidia グラフィックのみを使用 ==

[[NVIDIA|プロプライエタリの NVIDIA ドライバー]]は nouveau ドライバーのような動的な切り替えはサポートしていません (つまり NVIDIA デバイスしか使用できません)。また、NVIDIA は画面にティアリングが発生する問題を認識していますが未だに修正がなされていません。そのかわり、ディスクリート GPU を利用して nouveau ドライバーよりも高い性能を発揮することができます (2017年1月現在)。

まず {{Pkg|nvidia}} と {{Pkg|xorg-xrandr}} パッケージをインストールしてください。

そして、{{ic|xorg.conf}} を設定します。NVIDIA カードの PCI アドレスを知る必要があるので、次のコマンドを実行してください:

$ lspci | grep -E "VGA|3D"

NVIDIA と書かれた行の最初の7文字が PCI アドレスです。例えば {{ic|01:00.0}} などと表記されます。{{ic|xorg.conf}} では {{ic|#:#:#}} という形式で表記する必要があります。例えば {{ic|01:00.0}} の場合 {{ic|1:0:0}} となります。

{{Note|セットアップによっては EDID ファイルによる nvidia ドライバーのディスプレイの値の自動検出がされなくなることがあります。解決方法は [[#解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される]] を見て下さい。}}

{{hc|/etc/X11/xorg.conf.d/10-nvidia-drm-outputclass.conf|
Section "OutputClass"
Identifier "intel"
MatchDriver "i915"
Driver "modesetting"
EndSection

Section "OutputClass"
Identifier "nvidia"
MatchDriver "nvidia-drm"
Driver "nvidia"
Option "AllowEmptyInitialConfiguration"
Option "PrimaryGPU" "yes"
ModulePath "/usr/lib/nvidia/xorg"
ModulePath "/usr/lib/xorg/modules"
EndSection

}}

次に、{{ic|~/.xinitrc}} の最初に以下の2行を追加してください:

{{hc|~/.xinitrc|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

そしてドライバーをロードするために再起動し、X を起動させます。

ディスプレイの dpi が正しくない場合は以下の行を追加してください:

xrandr --dpi 96

X の起動時に黒画面が表示される場合、{{ic|~/.xinitrc}} に記述した {{ic|xrandr}} コマンドの後にアンパサンドがないことを確認してください。アンパサンドがある場合、{{ic|xrandr}} コマンドが実行し終える前にウィンドウマネージャが起動してしまうことがあり、そうなると黒画面になってしまいます。

アンパサンドがないのに黒画面になる場合、下の [[#別の設定]] を見て下さい。

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

ディスプレイマネージャを使用する場合、{{ic|~/.xinitrc}} の代わりにディスプレイマネージャのディスプレイ設定スクリプトを作成・編集する必要があります。

==== LightDM ====

[[LightDM]] ディスプレイマネージャの場合:

{{hc|/etc/lightdm/display_setup.sh|
#!/bin/sh
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

スクリプトに実行可能属性を付与:

# chmod +x /etc/lightdm/display_setup.sh

{{ic|/etc/lightdm/lightdm.conf}} の {{ic|[Seat:*]}} セクションを編集してスクリプトを実行するように lightdm を設定:

{{hc|/etc/lightdm/lightdm.conf|output=
[Seat:*]
display-setup-script=/etc/lightdm/display_setup.sh
}}

再起動して、ディスプレイマネージャが起動するのを確認してください。

==== SDDM ====
[[SDDM]] ディスプレイマネージャの場合:

{{hc|/usr/share/sddm/scripts/Xsetup|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

==== GDM ====
[[GDM]] ディスプレイマネージャの場合 {{ic|.desktop}} ファイルを作成します:

{{hc|/usr/share/gdm/greeter/autostart/optimus.desktop|
<nowiki>[Desktop Entry]
Type=Application
Name=Optimus
Exec=sh -c "xrandr --setprovideroutputsource modesetting NVIDIA-0; xrandr --auto"
NoDisplay=true
X-GNOME-Autostart-Phase=DisplayServer</nowiki>
}}

また、GDM が [[GDM#Xorg バックエンドを使う|Xorg バックエンドを使う]]ようになっているか確認してください。

==== KDM ====

KDE の [[KDM]] の場合、{{ic|/usr/share/config/kdm/Xsetup}} に xrandr の行を追加してください。

=== 3D の確認 ===

NVIDIA グラフィックが使われているかどうかは {{Pkg|mesa-demos}} をインストールして次のコマンドを実行することで確認できます:

$ glxinfo | grep NVIDIA

=== 詳細情報 ===

詳しい情報は、NVIDIA の公式ページ [http://us.download.nvidia.com/XFree86/Linux-x86/370.28/README/randr14.html] を見て下さい。

== 切り替え可能なグラフィックスを使用 ==

=== PRIME レンダリングオフロードを使用する===

これは、切り替え可能なグラフィックスをサポートする公式の NVIDIA メソッドです。

詳細については、 [[PRIME#PRIME render offload]] を参照してください。

=== nouveau を使う===

グラフィックスイッチングについては [[PRIME]] を、オープンソースの NVIDIA ドライバについては [[nouveau]] を参照してください。

=== Bumblebee を使用===

[[Bumblebee]] を参照してください。

=== nvidia-xrun を使用する ===

[[nvidia-xrun]] を参照してください。

=== optimus-manager を使用する ===

[https://github.com/Askannz/optimus-manager Optimus-manager] アップストリームのドキュメントを参照してください。Arch Linux システムでのインストールと設定の両方の説明があります。

=== EnvyControl を使用する ===

アップストリームのドキュメント [https://github.com/geminis3/envycontrol EnvyControl] を参照してください。インストール方法と使い方の説明があります。

=== NVidia-eXec を使用する ===

アップストリームのドキュメント [https://github.com/pedro00dk/nvidia-exec NVidia-eXec] を参照してください。インストール方法と使い方の説明があります。

=== nvidia-switch を使用する ===

アップストリームのドキュメント [https://github.com/nvidiaswitch/nvidia-switch nvidia-switch] を参照してください。インストール方法と使い方の説明があります。

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

=== 垂直同期が機能せずティアリングが発生する ===

解決するには {{pkg|xorg-server}} 1.19 以上、{{pkg|linux}} カーネル 4.5 以上、{{pkg|nvidia}} 370.23 以上が必須です。[[NVIDIA#DRM カーネルモードセッティング]]を有効にすることで PRIME 同期が有効になりティアリングが解消されます。

詳しくは公式の [https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/ フォーラムスレッド] を参照してください。

=== Failed to initialize the NVIDIA GPU at PCI:1:0:0 (GPU fallen off the bus / RmInitAdapter failed!) ===

カーネルパラメータに {{ic|1=rcutree.rcu_idle_gp_delay=1}} を追加してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=169742 こちら] を参照。

=== 解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される ===

nVidia ドライバーがディスプレイの EDID を検出できないのが原因です。手動で EDID ファイルのパスを指定するか、同じような方法で同一の情報を提供する必要があります。

EDID ファイルのパスを指定するには {{ic|Xorg.conf}} の nvidia カードの Device セクションを編集して、以下の行を追加して適当にパスを置き換えてください:

{{hc|/etc/X11/xorg.conf|
Section "Device"
Option "ConnectedMonitor" "CRT-0"
Option "CustomEDID" "CRT-0:/sys/class/drm/card0-LVDS-1/edid"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
EndSection
}}

Xorg が起動しない場合は、CRT という文字列を全て DFB に置き換えてみて下さい。card0 は intel カードの識別子でディスプレイは LVDS で接続されています。edid バイナリはこのディレクトリに存在します。ハードウェアの構成が異なっている場合、CustomEDID の値も変わってくるので確認するようにしてください。パスの先頭の {{ic|/sys/class/drm}} は変わらないはずです。

または、{{Pkg|read-edid}} などのツールを使って edid を自分で作成して、作成したファイルを使うようにドライバーを設定することもできます。modeline も使えますが、"UseEDID" と "IgnoreEDID" は変更するようにしてください。

=== Wrong resolution without EDID errors ===

Using ''nvidia-xconfig'', incorrect information might be generated in Xorg.conf and in particular wrong monitor refresh rates that restruct the possible resolutions. Try commenting out the {{ic|HorizSync}}/{{ic|VertRefresh}} lines. If this helps, you can probably also remove everything else not mentioned in this article.

=== ロックアップ問題 (lspci がフリーズ) ===
GTX 965M が搭載された最新のノートパソコンで (Bumblebee などで) bbswitch や nouveau を使ったときに lspci がフリーズしたり、サスペンドが失敗したり、シャットダウン時に止まってしまったり、optirun でフリーズが発生することがあります。

dGPU 電源リソースがオンになっている場合、ACPI コードで失敗してフリーズが起こることがあります ([https://bugzilla.kernel.org/show_bug.cgi?id=156341 カーネルバグ 156341])。

解決方法については [https://github.com/Bumblebee-Project/Bumblebee/issues/764#issuecomment-234494238 こちら] を見てください。また、{{ic|1=acpi_osi="!Windows 2015"}} や {{ic|1=acpi_osi=! acpi_osi="Windows 2009"}} を[[カーネルパラメータ]]に追加して起動することで解決することもあります。

=== No screens found on a laptop/NVIDIA Optimus ===

Check if {{ic|<nowiki>$ lspci | grep VGA</nowiki>}}
outputs something similar to:
00:02.0 VGA compatible controller: Intel Corporation Core Processor Integrated Graphics Controller (rev 02)
01:00.0 VGA compatible controller: nVidia Corporation Device 0df4 (rev a1)

NVIDIA drivers now offer Optimus support since 319.12 Beta [https://www.nvidia.com/object/linux-display-amd64-319.12-driver.html] with kernels above and including 3.9.

Another solution is to install the [[Intel]] driver to handle the screens, then if you want 3D software you should run them through [[Bumblebee]] to tell them to use the NVIDIA card.

NVIDIA Optimus

2022-08-20T14:38:21Z

Shota: /* 切り替え可能なグラフィックスを使用 */ 英語版を元に追記

[[Category:グラフィック]]
[[en:NVIDIA Optimus]]
[[ru:NVIDIA Optimus]]
[[zh-hans:NVIDIA Optimus]]
{{Related articles start}}
{{Related|PRIME}}
{{Related|Bumblebee}}
{{Related|Nouveau}}
{{Related|NVIDIA}}
{{Related|nvidia-xrun}}
{{Related|External GPU}}
{{Related articles end}}

[[Wikipedia:NVIDIA Optimus|NVIDIA Optimus]] は Intel の内蔵 GPU とディスクリートの NVIDIA GPU をノートパソコンに組み込んで利用できるようにする技術です。

== いくつかの方法 ==

* [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E3.82.A4.E3.83.B3.E3.83.86.E3.83.AB.E3.81.AE.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.81.AE.E3.81.BF.E3.82.92.E4.BD.BF.E7.94.A8 インテルのグラフィックスのみを使用] -NVIDIA GPU の電源は完全にオフになるため、消費電力を節約できます。
* [[NVIDIA_Optimus#nvidia グラフィックのみを使用|nvidia グラフィックのみを使用]] -インテルグラフィックスよりもパフォーマンスは向上しますが、より多くのバッテリを消費します (モバイルデバイスには適していません) 。これは、 [[#optimus-managerを使用する|optimus-manager ]] および [[#nvidia-xrun を使用する|nvidia-xrun]] オプションと同じ基本プロセスを利用しており、より自動化されたアプローチの1つを選択する前に、一般的な機能のトラブルシューティングおよび検証する必要があります。
* 両方を使用する (必要に応じて NVIDIA GPU を使用し、電源を切ったままにして電力を節約する) :
** [[#PRIME レンダリングオフロードを使用する]] -NVIDIA が公式にサポートしている方法です。
** [[#optimus-managerを使用する]] -1つのコマンドでグラフィックスを切り替えます (有効にするにはログアウトとログインが必要です) NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。1.4リリース以降では、AMD と NVIDIA の組み合わせもサポートされています。
** [[#nvidia-xrun を使用する]] -NVIDIA グラフィックスを使用して別の TTY で別の X セッションを実行します。NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。
** [[#Bumblebee を使用]] -インテルのグラフィックスを他のすべてのものに使用しながら、選択したアプリケーションをNVIDIA のグラフィックスで実行できるようにすることで、Windows に似た機能を提供します。しかし、パフォーマンスに重大な問題があります。
** [[#nouveau を使う]] -独自の NVIDIA ドライバと比較してパフォーマンスが低く、スリープと休止状態で問題が発生する可能性があります。最新の NVIDIA GPU では動作しません。

{{Note|これらのオプションはすべて相互に排他的です。1つの方法をテストして別の方法を選択する場合は、別の方法を試行する前に、1つの方法に従って行われた構成変更を必ず元に戻す必要があります。そうしないと、ファイルの競合や未定義の動作が発生する可能性があります。}}

== インテルのグラフィックスのみを使用 ==

特定の GPU のみに切り替えずに使用する場合は、システムの BIOS でオプションを確認してください。いずれかのカードを無効にするオプションがあるはずです。ラップトップによっては、個別のカードを無効にすることしかできない場合や、その逆の場合がありますが、カードのうちの1つだけを使用する予定があるかどうかを確認してください。

BIOS が Nvidia グラフィックスを無効にできない場合は、Linux カーネル自体から無効にできます。[[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

=== レンダリングプロバイダを切り替えずに CUDA を使用 ===

CUDA は、NVIDIA グラフィックスにレンダリングを切り替えることなく使用できます。CUDA アプリケーションを起動する前に、NVIDIA カードの電源が入っていることを確認するだけです。詳細については、 [[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

これで、CUDA アプリケーションを起動すると、必要なすべてのカーネルモジュールが自動的にロードされます。CUDA の使用後に NVIDIA カードの電源を切る前に、まず {{ic|nvidia}} カーネルモジュールをアンロードする必要があります。

#rmmod nvidia_uvm
#rmmod NVIDIA

== nvidia グラフィックのみを使用 ==

[[NVIDIA|プロプライエタリの NVIDIA ドライバー]]は nouveau ドライバーのような動的な切り替えはサポートしていません (つまり NVIDIA デバイスしか使用できません)。また、NVIDIA は画面にティアリングが発生する問題を認識していますが未だに修正がなされていません。そのかわり、ディスクリート GPU を利用して nouveau ドライバーよりも高い性能を発揮することができます (2017年1月現在)。

まず {{Pkg|nvidia}} と {{Pkg|xorg-xrandr}} パッケージをインストールしてください。

そして、{{ic|xorg.conf}} を設定します。NVIDIA カードの PCI アドレスを知る必要があるので、次のコマンドを実行してください:

$ lspci | grep -E "VGA|3D"

NVIDIA と書かれた行の最初の7文字が PCI アドレスです。例えば {{ic|01:00.0}} などと表記されます。{{ic|xorg.conf}} では {{ic|#:#:#}} という形式で表記する必要があります。例えば {{ic|01:00.0}} の場合 {{ic|1:0:0}} となります。

{{Note|セットアップによっては EDID ファイルによる nvidia ドライバーのディスプレイの値の自動検出がされなくなることがあります。解決方法は [[#解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される]] を見て下さい。}}

{{hc|/etc/X11/xorg.conf.d/10-nvidia-drm-outputclass.conf|
Section "OutputClass"
Identifier "intel"
MatchDriver "i915"
Driver "modesetting"
EndSection

Section "OutputClass"
Identifier "nvidia"
MatchDriver "nvidia-drm"
Driver "nvidia"
Option "AllowEmptyInitialConfiguration"
Option "PrimaryGPU" "yes"
ModulePath "/usr/lib/nvidia/xorg"
ModulePath "/usr/lib/xorg/modules"
EndSection

}}

次に、{{ic|~/.xinitrc}} の最初に以下の2行を追加してください:

{{hc|~/.xinitrc|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

そしてドライバーをロードするために再起動し、X を起動させます。

ディスプレイの dpi が正しくない場合は以下の行を追加してください:

xrandr --dpi 96

X の起動時に黒画面が表示される場合、{{ic|~/.xinitrc}} に記述した {{ic|xrandr}} コマンドの後にアンパサンドがないことを確認してください。アンパサンドがある場合、{{ic|xrandr}} コマンドが実行し終える前にウィンドウマネージャが起動してしまうことがあり、そうなると黒画面になってしまいます。

アンパサンドがないのに黒画面になる場合、下の [[#別の設定]] を見て下さい。

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

ディスプレイマネージャを使用する場合、{{ic|~/.xinitrc}} の代わりにディスプレイマネージャのディスプレイ設定スクリプトを作成・編集する必要があります。

==== LightDM ====

[[LightDM]] ディスプレイマネージャの場合:

{{hc|/etc/lightdm/display_setup.sh|
#!/bin/sh
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

スクリプトに実行可能属性を付与:

# chmod +x /etc/lightdm/display_setup.sh

{{ic|/etc/lightdm/lightdm.conf}} の {{ic|[Seat:*]}} セクションを編集してスクリプトを実行するように lightdm を設定:

{{hc|/etc/lightdm/lightdm.conf|output=
[Seat:*]
display-setup-script=/etc/lightdm/display_setup.sh
}}

再起動して、ディスプレイマネージャが起動するのを確認してください。

==== SDDM ====
[[SDDM]] ディスプレイマネージャの場合:

{{hc|/usr/share/sddm/scripts/Xsetup|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

==== GDM ====
[[GDM]] ディスプレイマネージャの場合 {{ic|.desktop}} ファイルを作成します:

{{hc|/usr/share/gdm/greeter/autostart/optimus.desktop|
<nowiki>[Desktop Entry]
Type=Application
Name=Optimus
Exec=sh -c "xrandr --setprovideroutputsource modesetting NVIDIA-0; xrandr --auto"
NoDisplay=true
X-GNOME-Autostart-Phase=DisplayServer</nowiki>
}}

また、GDM が [[GDM#Xorg バックエンドを使う|Xorg バックエンドを使う]]ようになっているか確認してください。

==== KDM ====

KDE の [[KDM]] の場合、{{ic|/usr/share/config/kdm/Xsetup}} に xrandr の行を追加してください。

=== 3D の確認 ===

NVIDIA グラフィックが使われているかどうかは {{Pkg|mesa-demos}} をインストールして次のコマンドを実行することで確認できます:

$ glxinfo | grep NVIDIA

=== 詳細情報 ===

詳しい情報は、NVIDIA の公式ページ [http://us.download.nvidia.com/XFree86/Linux-x86/370.28/README/randr14.html] を見て下さい。

== 切り替え可能なグラフィックスを使用 ==

=== PRIME レンダリングオフロードを使用する===

これは、切り替え可能なグラフィックスをサポートする公式の NVIDIA メソッドです。

詳細については、 [[PRIME#PRIME render offload]] を参照してください。

=== nouveau を使う===

グラフィックスイッチングについては [[PRIME]] を、オープンソースの NVIDIA ドライバについては [[nouveau]] を参照してください。

=== Bumblebee を使用===

[[Bumblebee]] を参照してください。

=== nvidia-xrun を使用する ===

[[nvidia-xrun]] を参照してください。

=== optimus-manager を使用する ===

[https://github.com/Askannz/optimus-manager Optimus-manager] アップストリームのドキュメントを参照してください。Arch Linux システムでのインストールと設定の両方の説明があります。

=== EnvyControl を使用する ===

アップストリームのドキュメント [https://github.com/geminis3/envycontrol EnvyControl] を参照してください。インストール方法と使い方の説明があります。

=== NVidia-eXec を使用する ===

アップストリームのドキュメント [https://github.com/pedro00dk/nvidia-exec NVidia-eXec] を参照してください。インストール方法と使い方の説明があります。

=== nvidia-switch を使用する ===

アップストリームのドキュメント [https://github.com/nvidiaswitch/nvidia-switch nvidia-switch] を参照してください。インストール方法と使い方の説明があります。

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

=== 垂直同期が機能せずティアリングが発生する ===

解決するには {{pkg|xorg-server}} 1.19 以上、{{pkg|linux}} カーネル 4.5 以上、{{pkg|nvidia}} 370.23 以上が必須です。[[NVIDIA#DRM カーネルモードセッティング]]を有効にすることで PRIME 同期が有効になりティアリングが解消されます。

詳しくは公式の [https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/ フォーラムスレッド] を参照してください。

=== Failed to initialize the NVIDIA GPU at PCI:1:0:0 (GPU fallen off the bus / RmInitAdapter failed!) ===

カーネルパラメータに {{ic|1=rcutree.rcu_idle_gp_delay=1}} を追加してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=169742 こちら] を参照。

=== 解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される ===

nVidia ドライバーがディスプレイの EDID を検出できないのが原因です。手動で EDID ファイルのパスを指定するか、同じような方法で同一の情報を提供する必要があります。

EDID ファイルのパスを指定するには {{ic|Xorg.conf}} の nvidia カードの Device セクションを編集して、以下の行を追加して適当にパスを置き換えてください:

{{hc|/etc/X11/xorg.conf|
Section "Device"
Option "ConnectedMonitor" "CRT-0"
Option "CustomEDID" "CRT-0:/sys/class/drm/card0-LVDS-1/edid"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
EndSection
}}

Xorg が起動しない場合は、CRT という文字列を全て DFB に置き換えてみて下さい。card0 は intel カードの識別子でディスプレイは LVDS で接続されています。edid バイナリはこのディレクトリに存在します。ハードウェアの構成が異なっている場合、CustomEDID の値も変わってくるので確認するようにしてください。パスの先頭の {{ic|/sys/class/drm}} は変わらないはずです。

または、{{Pkg|read-edid}} などのツールを使って edid を自分で作成して、作成したファイルを使うようにドライバーを設定することもできます。modeline も使えますが、"UseEDID" と "IgnoreEDID" は変更するようにしてください。

=== Wrong resolution without EDID errors ===

Using ''nvidia-xconfig'', incorrect information might be generated in Xorg.conf and in particular wrong monitor refresh rates that restruct the possible resolutions. Try commenting out the {{ic|HorizSync}}/{{ic|VertRefresh}} lines. If this helps, you can probably also remove everything else not mentioned in this article.

=== ロックアップ問題 (lspci がフリーズ) ===
GTX 965M が搭載された最新のノートパソコンで (Bumblebee などで) bbswitch や nouveau を使ったときに lspci がフリーズしたり、サスペンドが失敗したり、シャットダウン時に止まってしまったり、optirun でフリーズが発生することがあります。

dGPU 電源リソースがオンになっている場合、ACPI コードで失敗してフリーズが起こることがあります ([https://bugzilla.kernel.org/show_bug.cgi?id=156341 カーネルバグ 156341])。

解決方法については [https://github.com/Bumblebee-Project/Bumblebee/issues/764#issuecomment-234494238 こちら] を見てください。また、{{ic|1=acpi_osi="!Windows 2015"}} や {{ic|1=acpi_osi=! acpi_osi="Windows 2009"}} を[[カーネルパラメータ]]に追加して起動することで解決することもあります。

=== No screens found on a laptop/NVIDIA Optimus ===

Check if {{ic|<nowiki>$ lspci | grep VGA</nowiki>}}
outputs something similar to:
00:02.0 VGA compatible controller: Intel Corporation Core Processor Integrated Graphics Controller (rev 02)
01:00.0 VGA compatible controller: nVidia Corporation Device 0df4 (rev a1)

NVIDIA drivers now offer Optimus support since 319.12 Beta [https://www.nvidia.com/object/linux-display-amd64-319.12-driver.html] with kernels above and including 3.9.

Another solution is to install the [[Intel]] driver to handle the screens, then if you want 3D software you should run them through [[Bumblebee]] to tell them to use the NVIDIA card.

NVIDIA Optimus

2022-08-20T14:32:44Z

Shota: /* いくつかの方法 */ 内部リンクになっているべきリンクを修正

[[Category:グラフィック]]
[[en:NVIDIA Optimus]]
[[ru:NVIDIA Optimus]]
[[zh-hans:NVIDIA Optimus]]
{{Related articles start}}
{{Related|PRIME}}
{{Related|Bumblebee}}
{{Related|Nouveau}}
{{Related|NVIDIA}}
{{Related|nvidia-xrun}}
{{Related|External GPU}}
{{Related articles end}}

[[Wikipedia:NVIDIA Optimus|NVIDIA Optimus]] は Intel の内蔵 GPU とディスクリートの NVIDIA GPU をノートパソコンに組み込んで利用できるようにする技術です。

== いくつかの方法 ==

* [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E3.82.A4.E3.83.B3.E3.83.86.E3.83.AB.E3.81.AE.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.81.AE.E3.81.BF.E3.82.92.E4.BD.BF.E7.94.A8 インテルのグラフィックスのみを使用] -NVIDIA GPU の電源は完全にオフになるため、消費電力を節約できます。
* [[NVIDIA_Optimus#nvidia グラフィックのみを使用|nvidia グラフィックのみを使用]] -インテルグラフィックスよりもパフォーマンスは向上しますが、より多くのバッテリを消費します (モバイルデバイスには適していません) 。これは、 [[#optimus-managerを使用する|optimus-manager ]] および [[#nvidia-xrun を使用する|nvidia-xrun]] オプションと同じ基本プロセスを利用しており、より自動化されたアプローチの1つを選択する前に、一般的な機能のトラブルシューティングおよび検証する必要があります。
* 両方を使用する (必要に応じて NVIDIA GPU を使用し、電源を切ったままにして電力を節約する) :
** [[#PRIME レンダリングオフロードを使用する]] -NVIDIA が公式にサポートしている方法です。
** [[#optimus-managerを使用する]] -1つのコマンドでグラフィックスを切り替えます (有効にするにはログアウトとログインが必要です) NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。1.4リリース以降では、AMD と NVIDIA の組み合わせもサポートされています。
** [[#nvidia-xrun を使用する]] -NVIDIA グラフィックスを使用して別の TTY で別の X セッションを実行します。NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。
** [[#Bumblebee を使用]] -インテルのグラフィックスを他のすべてのものに使用しながら、選択したアプリケーションをNVIDIA のグラフィックスで実行できるようにすることで、Windows に似た機能を提供します。しかし、パフォーマンスに重大な問題があります。
** [[#nouveau を使う]] -独自の NVIDIA ドライバと比較してパフォーマンスが低く、スリープと休止状態で問題が発生する可能性があります。最新の NVIDIA GPU では動作しません。

{{Note|これらのオプションはすべて相互に排他的です。1つの方法をテストして別の方法を選択する場合は、別の方法を試行する前に、1つの方法に従って行われた構成変更を必ず元に戻す必要があります。そうしないと、ファイルの競合や未定義の動作が発生する可能性があります。}}

== インテルのグラフィックスのみを使用 ==

特定の GPU のみに切り替えずに使用する場合は、システムの BIOS でオプションを確認してください。いずれかのカードを無効にするオプションがあるはずです。ラップトップによっては、個別のカードを無効にすることしかできない場合や、その逆の場合がありますが、カードのうちの1つだけを使用する予定があるかどうかを確認してください。

BIOS が Nvidia グラフィックスを無効にできない場合は、Linux カーネル自体から無効にできます。[[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

=== レンダリングプロバイダを切り替えずに CUDA を使用 ===

CUDA は、NVIDIA グラフィックスにレンダリングを切り替えることなく使用できます。CUDA アプリケーションを起動する前に、NVIDIA カードの電源が入っていることを確認するだけです。詳細については、 [[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

これで、CUDA アプリケーションを起動すると、必要なすべてのカーネルモジュールが自動的にロードされます。CUDA の使用後に NVIDIA カードの電源を切る前に、まず {{ic|nvidia}} カーネルモジュールをアンロードする必要があります。

#rmmod nvidia_uvm
#rmmod NVIDIA

== nvidia グラフィックのみを使用 ==

[[NVIDIA|プロプライエタリの NVIDIA ドライバー]]は nouveau ドライバーのような動的な切り替えはサポートしていません (つまり NVIDIA デバイスしか使用できません)。また、NVIDIA は画面にティアリングが発生する問題を認識していますが未だに修正がなされていません。そのかわり、ディスクリート GPU を利用して nouveau ドライバーよりも高い性能を発揮することができます (2017年1月現在)。

まず {{Pkg|nvidia}} と {{Pkg|xorg-xrandr}} パッケージをインストールしてください。

そして、{{ic|xorg.conf}} を設定します。NVIDIA カードの PCI アドレスを知る必要があるので、次のコマンドを実行してください:

$ lspci | grep -E "VGA|3D"

NVIDIA と書かれた行の最初の7文字が PCI アドレスです。例えば {{ic|01:00.0}} などと表記されます。{{ic|xorg.conf}} では {{ic|#:#:#}} という形式で表記する必要があります。例えば {{ic|01:00.0}} の場合 {{ic|1:0:0}} となります。

{{Note|セットアップによっては EDID ファイルによる nvidia ドライバーのディスプレイの値の自動検出がされなくなることがあります。解決方法は [[#解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される]] を見て下さい。}}

{{hc|/etc/X11/xorg.conf.d/10-nvidia-drm-outputclass.conf|
Section "OutputClass"
Identifier "intel"
MatchDriver "i915"
Driver "modesetting"
EndSection

Section "OutputClass"
Identifier "nvidia"
MatchDriver "nvidia-drm"
Driver "nvidia"
Option "AllowEmptyInitialConfiguration"
Option "PrimaryGPU" "yes"
ModulePath "/usr/lib/nvidia/xorg"
ModulePath "/usr/lib/xorg/modules"
EndSection

}}

次に、{{ic|~/.xinitrc}} の最初に以下の2行を追加してください:

{{hc|~/.xinitrc|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

そしてドライバーをロードするために再起動し、X を起動させます。

ディスプレイの dpi が正しくない場合は以下の行を追加してください:

xrandr --dpi 96

X の起動時に黒画面が表示される場合、{{ic|~/.xinitrc}} に記述した {{ic|xrandr}} コマンドの後にアンパサンドがないことを確認してください。アンパサンドがある場合、{{ic|xrandr}} コマンドが実行し終える前にウィンドウマネージャが起動してしまうことがあり、そうなると黒画面になってしまいます。

アンパサンドがないのに黒画面になる場合、下の [[#別の設定]] を見て下さい。

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

ディスプレイマネージャを使用する場合、{{ic|~/.xinitrc}} の代わりにディスプレイマネージャのディスプレイ設定スクリプトを作成・編集する必要があります。

==== LightDM ====

[[LightDM]] ディスプレイマネージャの場合:

{{hc|/etc/lightdm/display_setup.sh|
#!/bin/sh
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

スクリプトに実行可能属性を付与:

# chmod +x /etc/lightdm/display_setup.sh

{{ic|/etc/lightdm/lightdm.conf}} の {{ic|[Seat:*]}} セクションを編集してスクリプトを実行するように lightdm を設定:

{{hc|/etc/lightdm/lightdm.conf|output=
[Seat:*]
display-setup-script=/etc/lightdm/display_setup.sh
}}

再起動して、ディスプレイマネージャが起動するのを確認してください。

==== SDDM ====
[[SDDM]] ディスプレイマネージャの場合:

{{hc|/usr/share/sddm/scripts/Xsetup|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

==== GDM ====
[[GDM]] ディスプレイマネージャの場合 {{ic|.desktop}} ファイルを作成します:

{{hc|/usr/share/gdm/greeter/autostart/optimus.desktop|
<nowiki>[Desktop Entry]
Type=Application
Name=Optimus
Exec=sh -c "xrandr --setprovideroutputsource modesetting NVIDIA-0; xrandr --auto"
NoDisplay=true
X-GNOME-Autostart-Phase=DisplayServer</nowiki>
}}

また、GDM が [[GDM#Xorg バックエンドを使う|Xorg バックエンドを使う]]ようになっているか確認してください。

==== KDM ====

KDE の [[KDM]] の場合、{{ic|/usr/share/config/kdm/Xsetup}} に xrandr の行を追加してください。

=== 3D の確認 ===

NVIDIA グラフィックが使われているかどうかは {{Pkg|mesa-demos}} をインストールして次のコマンドを実行することで確認できます:

$ glxinfo | grep NVIDIA

=== 詳細情報 ===

詳しい情報は、NVIDIA の公式ページ [http://us.download.nvidia.com/XFree86/Linux-x86/370.28/README/randr14.html] を見て下さい。

== 切り替え可能なグラフィックスを使用 ==

=== PRIME レンダリングオフロードを使用する===

これは、切り替え可能なグラフィックスをサポートする公式の NVIDIA メソッドです。

詳細については、 [[PRIME#PRIME render offload]] を参照してください。

=== nouveau を使う===

グラフィックスイッチングについては [[PRIME]] を、オープンソースの NVIDIA ドライバについては [[nouveau]] を参照してください。

=== Bumblebee を使用===

[[Bumblebee]] を参照してください。

=== nvidia-xrun を使用する ===

[[nvidia-xrun]] を参照してください。

=== optimus-managerを使用する ===

[https://github.com/Askannz/optimus-manager Optimus-manager] アップストリームのドキュメントを参照してください。Arch Linux システムでのインストールと設定の両方について説明します。

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

=== 垂直同期が機能せずティアリングが発生する ===

解決するには {{pkg|xorg-server}} 1.19 以上、{{pkg|linux}} カーネル 4.5 以上、{{pkg|nvidia}} 370.23 以上が必須です。[[NVIDIA#DRM カーネルモードセッティング]]を有効にすることで PRIME 同期が有効になりティアリングが解消されます。

詳しくは公式の [https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/ フォーラムスレッド] を参照してください。

=== Failed to initialize the NVIDIA GPU at PCI:1:0:0 (GPU fallen off the bus / RmInitAdapter failed!) ===

カーネルパラメータに {{ic|1=rcutree.rcu_idle_gp_delay=1}} を追加してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=169742 こちら] を参照。

=== 解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される ===

nVidia ドライバーがディスプレイの EDID を検出できないのが原因です。手動で EDID ファイルのパスを指定するか、同じような方法で同一の情報を提供する必要があります。

EDID ファイルのパスを指定するには {{ic|Xorg.conf}} の nvidia カードの Device セクションを編集して、以下の行を追加して適当にパスを置き換えてください:

{{hc|/etc/X11/xorg.conf|
Section "Device"
Option "ConnectedMonitor" "CRT-0"
Option "CustomEDID" "CRT-0:/sys/class/drm/card0-LVDS-1/edid"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
EndSection
}}

Xorg が起動しない場合は、CRT という文字列を全て DFB に置き換えてみて下さい。card0 は intel カードの識別子でディスプレイは LVDS で接続されています。edid バイナリはこのディレクトリに存在します。ハードウェアの構成が異なっている場合、CustomEDID の値も変わってくるので確認するようにしてください。パスの先頭の {{ic|/sys/class/drm}} は変わらないはずです。

または、{{Pkg|read-edid}} などのツールを使って edid を自分で作成して、作成したファイルを使うようにドライバーを設定することもできます。modeline も使えますが、"UseEDID" と "IgnoreEDID" は変更するようにしてください。

=== Wrong resolution without EDID errors ===

Using ''nvidia-xconfig'', incorrect information might be generated in Xorg.conf and in particular wrong monitor refresh rates that restruct the possible resolutions. Try commenting out the {{ic|HorizSync}}/{{ic|VertRefresh}} lines. If this helps, you can probably also remove everything else not mentioned in this article.

=== ロックアップ問題 (lspci がフリーズ) ===
GTX 965M が搭載された最新のノートパソコンで (Bumblebee などで) bbswitch や nouveau を使ったときに lspci がフリーズしたり、サスペンドが失敗したり、シャットダウン時に止まってしまったり、optirun でフリーズが発生することがあります。

dGPU 電源リソースがオンになっている場合、ACPI コードで失敗してフリーズが起こることがあります ([https://bugzilla.kernel.org/show_bug.cgi?id=156341 カーネルバグ 156341])。

解決方法については [https://github.com/Bumblebee-Project/Bumblebee/issues/764#issuecomment-234494238 こちら] を見てください。また、{{ic|1=acpi_osi="!Windows 2015"}} や {{ic|1=acpi_osi=! acpi_osi="Windows 2009"}} を[[カーネルパラメータ]]に追加して起動することで解決することもあります。

=== No screens found on a laptop/NVIDIA Optimus ===

Check if {{ic|<nowiki>$ lspci | grep VGA</nowiki>}}
outputs something similar to:
00:02.0 VGA compatible controller: Intel Corporation Core Processor Integrated Graphics Controller (rev 02)
01:00.0 VGA compatible controller: nVidia Corporation Device 0df4 (rev a1)

NVIDIA drivers now offer Optimus support since 319.12 Beta [https://www.nvidia.com/object/linux-display-amd64-319.12-driver.html] with kernels above and including 3.9.

Another solution is to install the [[Intel]] driver to handle the screens, then if you want 3D software you should run them through [[Bumblebee]] to tell them to use the NVIDIA card.

NVIDIA Optimus

2022-08-20T14:27:53Z

Shota: /* いくつかの方法 */ 内部リンクの修正 (修正ミスの修正)

[[Category:グラフィック]]
[[en:NVIDIA Optimus]]
[[ru:NVIDIA Optimus]]
[[zh-hans:NVIDIA Optimus]]
{{Related articles start}}
{{Related|PRIME}}
{{Related|Bumblebee}}
{{Related|Nouveau}}
{{Related|NVIDIA}}
{{Related|nvidia-xrun}}
{{Related|External GPU}}
{{Related articles end}}

[[Wikipedia:NVIDIA Optimus|NVIDIA Optimus]] は Intel の内蔵 GPU とディスクリートの NVIDIA GPU をノートパソコンに組み込んで利用できるようにする技術です。

== いくつかの方法 ==

* [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E3.82.A4.E3.83.B3.E3.83.86.E3.83.AB.E3.81.AE.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.81.AE.E3.81.BF.E3.82.92.E4.BD.BF.E7.94.A8 インテルのグラフィックスのみを使用] -NVIDIA GPU の電源は完全にオフになるため、消費電力を節約できます。
* [[NVIDIA_Optimus#nvidia グラフィックのみを使用|nvidia グラフィックのみを使用]] -インテルグラフィックスよりもパフォーマンスは向上しますが、より多くのバッテリを消費します (モバイルデバイスには適していません) 。これは、 [[#optimus-managerを使用する|optimus-manager ]] および [[#nvidia-xrun を使用する|nvidia-xrun]] オプションと同じ基本プロセスを利用しており、より自動化されたアプローチの1つを選択する前に、一般的な機能のトラブルシューティングおよび検証する必要があります。
* 両方を使用する (必要に応じて NVIDIA GPU を使用し、電源を切ったままにして電力を節約する) :
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 PRIME render offloadを使用] -NVIDIA が公式にサポートしている方法です。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 optimus-manager の使用] -1つのコマンドでグラフィックスを切り替えます (有効にするにはログアウトとログインが必要です) NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。1.4リリース以降では、AMD と NVIDIA の組み合わせもサポートされています。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 nvidia-xrun を使用] -NVIDIA グラフィックスを使用して別の TTY で別の X セッションを実行します。NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 Bumblebee の使用] -インテルのグラフィックスを他のすべてのものに使用しながら、選択したアプリケーションをNVIDIA のグラフィックスで実行できるようにすることで、Windows に似た機能を提供します。しかし、パフォーマンスに重大な問題があります。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 nouveau を使用] -独自の NVIDIA ドライバと比較してパフォーマンスが低く、スリープと休止状態で問題が発生する可能性があります。最新の NVIDIA GPU では動作しません。

{{Note|これらのオプションはすべて相互に排他的です。1つの方法をテストして別の方法を選択する場合は、別の方法を試行する前に、1つの方法に従って行われた構成変更を必ず元に戻す必要があります。そうしないと、ファイルの競合や未定義の動作が発生する可能性があります。}}

== インテルのグラフィックスのみを使用 ==

特定の GPU のみに切り替えずに使用する場合は、システムの BIOS でオプションを確認してください。いずれかのカードを無効にするオプションがあるはずです。ラップトップによっては、個別のカードを無効にすることしかできない場合や、その逆の場合がありますが、カードのうちの1つだけを使用する予定があるかどうかを確認してください。

BIOS が Nvidia グラフィックスを無効にできない場合は、Linux カーネル自体から無効にできます。[[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

=== レンダリングプロバイダを切り替えずに CUDA を使用 ===

CUDA は、NVIDIA グラフィックスにレンダリングを切り替えることなく使用できます。CUDA アプリケーションを起動する前に、NVIDIA カードの電源が入っていることを確認するだけです。詳細については、 [[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

これで、CUDA アプリケーションを起動すると、必要なすべてのカーネルモジュールが自動的にロードされます。CUDA の使用後に NVIDIA カードの電源を切る前に、まず {{ic|nvidia}} カーネルモジュールをアンロードする必要があります。

#rmmod nvidia_uvm
#rmmod NVIDIA

== nvidia グラフィックのみを使用 ==

[[NVIDIA|プロプライエタリの NVIDIA ドライバー]]は nouveau ドライバーのような動的な切り替えはサポートしていません (つまり NVIDIA デバイスしか使用できません)。また、NVIDIA は画面にティアリングが発生する問題を認識していますが未だに修正がなされていません。そのかわり、ディスクリート GPU を利用して nouveau ドライバーよりも高い性能を発揮することができます (2017年1月現在)。

まず {{Pkg|nvidia}} と {{Pkg|xorg-xrandr}} パッケージをインストールしてください。

そして、{{ic|xorg.conf}} を設定します。NVIDIA カードの PCI アドレスを知る必要があるので、次のコマンドを実行してください:

$ lspci | grep -E "VGA|3D"

NVIDIA と書かれた行の最初の7文字が PCI アドレスです。例えば {{ic|01:00.0}} などと表記されます。{{ic|xorg.conf}} では {{ic|#:#:#}} という形式で表記する必要があります。例えば {{ic|01:00.0}} の場合 {{ic|1:0:0}} となります。

{{Note|セットアップによっては EDID ファイルによる nvidia ドライバーのディスプレイの値の自動検出がされなくなることがあります。解決方法は [[#解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される]] を見て下さい。}}

{{hc|/etc/X11/xorg.conf.d/10-nvidia-drm-outputclass.conf|
Section "OutputClass"
Identifier "intel"
MatchDriver "i915"
Driver "modesetting"
EndSection

Section "OutputClass"
Identifier "nvidia"
MatchDriver "nvidia-drm"
Driver "nvidia"
Option "AllowEmptyInitialConfiguration"
Option "PrimaryGPU" "yes"
ModulePath "/usr/lib/nvidia/xorg"
ModulePath "/usr/lib/xorg/modules"
EndSection

}}

次に、{{ic|~/.xinitrc}} の最初に以下の2行を追加してください:

{{hc|~/.xinitrc|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

そしてドライバーをロードするために再起動し、X を起動させます。

ディスプレイの dpi が正しくない場合は以下の行を追加してください:

xrandr --dpi 96

X の起動時に黒画面が表示される場合、{{ic|~/.xinitrc}} に記述した {{ic|xrandr}} コマンドの後にアンパサンドがないことを確認してください。アンパサンドがある場合、{{ic|xrandr}} コマンドが実行し終える前にウィンドウマネージャが起動してしまうことがあり、そうなると黒画面になってしまいます。

アンパサンドがないのに黒画面になる場合、下の [[#別の設定]] を見て下さい。

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

ディスプレイマネージャを使用する場合、{{ic|~/.xinitrc}} の代わりにディスプレイマネージャのディスプレイ設定スクリプトを作成・編集する必要があります。

==== LightDM ====

[[LightDM]] ディスプレイマネージャの場合:

{{hc|/etc/lightdm/display_setup.sh|
#!/bin/sh
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

スクリプトに実行可能属性を付与:

# chmod +x /etc/lightdm/display_setup.sh

{{ic|/etc/lightdm/lightdm.conf}} の {{ic|[Seat:*]}} セクションを編集してスクリプトを実行するように lightdm を設定:

{{hc|/etc/lightdm/lightdm.conf|output=
[Seat:*]
display-setup-script=/etc/lightdm/display_setup.sh
}}

再起動して、ディスプレイマネージャが起動するのを確認してください。

==== SDDM ====
[[SDDM]] ディスプレイマネージャの場合:

{{hc|/usr/share/sddm/scripts/Xsetup|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

==== GDM ====
[[GDM]] ディスプレイマネージャの場合 {{ic|.desktop}} ファイルを作成します:

{{hc|/usr/share/gdm/greeter/autostart/optimus.desktop|
<nowiki>[Desktop Entry]
Type=Application
Name=Optimus
Exec=sh -c "xrandr --setprovideroutputsource modesetting NVIDIA-0; xrandr --auto"
NoDisplay=true
X-GNOME-Autostart-Phase=DisplayServer</nowiki>
}}

また、GDM が [[GDM#Xorg バックエンドを使う|Xorg バックエンドを使う]]ようになっているか確認してください。

==== KDM ====

KDE の [[KDM]] の場合、{{ic|/usr/share/config/kdm/Xsetup}} に xrandr の行を追加してください。

=== 3D の確認 ===

NVIDIA グラフィックが使われているかどうかは {{Pkg|mesa-demos}} をインストールして次のコマンドを実行することで確認できます:

$ glxinfo | grep NVIDIA

=== 詳細情報 ===

詳しい情報は、NVIDIA の公式ページ [http://us.download.nvidia.com/XFree86/Linux-x86/370.28/README/randr14.html] を見て下さい。

== 切り替え可能なグラフィックスを使用 ==

=== PRIME レンダリングオフロードを使用する===

これは、切り替え可能なグラフィックスをサポートする公式の NVIDIA メソッドです。

詳細については、 [[PRIME#PRIME render offload]] を参照してください。

=== nouveau を使う===

グラフィックスイッチングについては [[PRIME]] を、オープンソースの NVIDIA ドライバについては [[nouveau]] を参照してください。

=== Bumblebee を使用===

[[Bumblebee]] を参照してください。

=== nvidia-xrun を使用する ===

[[nvidia-xrun]] を参照してください。

=== optimus-managerを使用する ===

[https://github.com/Askannz/optimus-manager Optimus-manager] アップストリームのドキュメントを参照してください。Arch Linux システムでのインストールと設定の両方について説明します。

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

=== 垂直同期が機能せずティアリングが発生する ===

解決するには {{pkg|xorg-server}} 1.19 以上、{{pkg|linux}} カーネル 4.5 以上、{{pkg|nvidia}} 370.23 以上が必須です。[[NVIDIA#DRM カーネルモードセッティング]]を有効にすることで PRIME 同期が有効になりティアリングが解消されます。

詳しくは公式の [https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/ フォーラムスレッド] を参照してください。

=== Failed to initialize the NVIDIA GPU at PCI:1:0:0 (GPU fallen off the bus / RmInitAdapter failed!) ===

カーネルパラメータに {{ic|1=rcutree.rcu_idle_gp_delay=1}} を追加してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=169742 こちら] を参照。

=== 解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される ===

nVidia ドライバーがディスプレイの EDID を検出できないのが原因です。手動で EDID ファイルのパスを指定するか、同じような方法で同一の情報を提供する必要があります。

EDID ファイルのパスを指定するには {{ic|Xorg.conf}} の nvidia カードの Device セクションを編集して、以下の行を追加して適当にパスを置き換えてください:

{{hc|/etc/X11/xorg.conf|
Section "Device"
Option "ConnectedMonitor" "CRT-0"
Option "CustomEDID" "CRT-0:/sys/class/drm/card0-LVDS-1/edid"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
EndSection
}}

Xorg が起動しない場合は、CRT という文字列を全て DFB に置き換えてみて下さい。card0 は intel カードの識別子でディスプレイは LVDS で接続されています。edid バイナリはこのディレクトリに存在します。ハードウェアの構成が異なっている場合、CustomEDID の値も変わってくるので確認するようにしてください。パスの先頭の {{ic|/sys/class/drm}} は変わらないはずです。

または、{{Pkg|read-edid}} などのツールを使って edid を自分で作成して、作成したファイルを使うようにドライバーを設定することもできます。modeline も使えますが、"UseEDID" と "IgnoreEDID" は変更するようにしてください。

=== Wrong resolution without EDID errors ===

Using ''nvidia-xconfig'', incorrect information might be generated in Xorg.conf and in particular wrong monitor refresh rates that restruct the possible resolutions. Try commenting out the {{ic|HorizSync}}/{{ic|VertRefresh}} lines. If this helps, you can probably also remove everything else not mentioned in this article.

=== ロックアップ問題 (lspci がフリーズ) ===
GTX 965M が搭載された最新のノートパソコンで (Bumblebee などで) bbswitch や nouveau を使ったときに lspci がフリーズしたり、サスペンドが失敗したり、シャットダウン時に止まってしまったり、optirun でフリーズが発生することがあります。

dGPU 電源リソースがオンになっている場合、ACPI コードで失敗してフリーズが起こることがあります ([https://bugzilla.kernel.org/show_bug.cgi?id=156341 カーネルバグ 156341])。

解決方法については [https://github.com/Bumblebee-Project/Bumblebee/issues/764#issuecomment-234494238 こちら] を見てください。また、{{ic|1=acpi_osi="!Windows 2015"}} や {{ic|1=acpi_osi=! acpi_osi="Windows 2009"}} を[[カーネルパラメータ]]に追加して起動することで解決することもあります。

=== No screens found on a laptop/NVIDIA Optimus ===

Check if {{ic|<nowiki>$ lspci | grep VGA</nowiki>}}
outputs something similar to:
00:02.0 VGA compatible controller: Intel Corporation Core Processor Integrated Graphics Controller (rev 02)
01:00.0 VGA compatible controller: nVidia Corporation Device 0df4 (rev a1)

NVIDIA drivers now offer Optimus support since 319.12 Beta [https://www.nvidia.com/object/linux-display-amd64-319.12-driver.html] with kernels above and including 3.9.

Another solution is to install the [[Intel]] driver to handle the screens, then if you want 3D software you should run them through [[Bumblebee]] to tell them to use the NVIDIA card.

NVIDIA Optimus

2022-08-20T14:27:08Z

Shota: /* いくつかの方法 */ 内部リンクの修正

[[Category:グラフィック]]
[[en:NVIDIA Optimus]]
[[ru:NVIDIA Optimus]]
[[zh-hans:NVIDIA Optimus]]
{{Related articles start}}
{{Related|PRIME}}
{{Related|Bumblebee}}
{{Related|Nouveau}}
{{Related|NVIDIA}}
{{Related|nvidia-xrun}}
{{Related|External GPU}}
{{Related articles end}}

[[Wikipedia:NVIDIA Optimus|NVIDIA Optimus]] は Intel の内蔵 GPU とディスクリートの NVIDIA GPU をノートパソコンに組み込んで利用できるようにする技術です。

== いくつかの方法 ==

* [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E3.82.A4.E3.83.B3.E3.83.86.E3.83.AB.E3.81.AE.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.81.AE.E3.81.BF.E3.82.92.E4.BD.BF.E7.94.A8 インテルのグラフィックスのみを使用] -NVIDIA GPU の電源は完全にオフになるため、消費電力を節約できます。
* [[NVIDIA_Optimus#nvidia グラフィックのみを使用|nvidia グラフィックのみを使用]] -インテルグラフィックスよりもパフォーマンスは向上しますが、より多くのバッテリを消費します (モバイルデバイスには適していません) 。これは、 [[#optimus-managerを使用する|optimus-manager ]] および [[#nvidia-xrun を使用する
|nvidia-xrun]] オプションと同じ基本プロセスを利用しており、より自動化されたアプローチの1つを選択する前に、一般的な機能のトラブルシューティングおよび検証する必要があります。
* 両方を使用する (必要に応じて NVIDIA GPU を使用し、電源を切ったままにして電力を節約する) :
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 PRIME render offloadを使用] -NVIDIA が公式にサポートしている方法です。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 optimus-manager の使用] -1つのコマンドでグラフィックスを切り替えます (有効にするにはログアウトとログインが必要です) NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。1.4リリース以降では、AMD と NVIDIA の組み合わせもサポートされています。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 nvidia-xrun を使用] -NVIDIA グラフィックスを使用して別の TTY で別の X セッションを実行します。NVIDIA GPU の性能を最大限に引き出し、使用していない場合はオフにします。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 Bumblebee の使用] -インテルのグラフィックスを他のすべてのものに使用しながら、選択したアプリケーションをNVIDIA のグラフィックスで実行できるようにすることで、Windows に似た機能を提供します。しかし、パフォーマンスに重大な問題があります。
** [https://wiki.archlinux.jp/index.php/NVIDIA_Optimus#.E5.88.87.E3.82.8A.E6.9B.BF.E3.81.88.E5.8F.AF.E8.83.BD.E3.81.AA.E3.82.B0.E3.83.A9.E3.83.95.E3.82.A3.E3.83.83.E3.82.AF.E3.82.B9.E3.82.92.E4.BD.BF.E7.94.A8 nouveau を使用] -独自の NVIDIA ドライバと比較してパフォーマンスが低く、スリープと休止状態で問題が発生する可能性があります。最新の NVIDIA GPU では動作しません。

{{Note|これらのオプションはすべて相互に排他的です。1つの方法をテストして別の方法を選択する場合は、別の方法を試行する前に、1つの方法に従って行われた構成変更を必ず元に戻す必要があります。そうしないと、ファイルの競合や未定義の動作が発生する可能性があります。}}

== インテルのグラフィックスのみを使用 ==

特定の GPU のみに切り替えずに使用する場合は、システムの BIOS でオプションを確認してください。いずれかのカードを無効にするオプションがあるはずです。ラップトップによっては、個別のカードを無効にすることしかできない場合や、その逆の場合がありますが、カードのうちの1つだけを使用する予定があるかどうかを確認してください。

BIOS が Nvidia グラフィックスを無効にできない場合は、Linux カーネル自体から無効にできます。[[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

=== レンダリングプロバイダを切り替えずに CUDA を使用 ===

CUDA は、NVIDIA グラフィックスにレンダリングを切り替えることなく使用できます。CUDA アプリケーションを起動する前に、NVIDIA カードの電源が入っていることを確認するだけです。詳細については、 [[ハイブリッドグラフィック#ディスクリート GPU の完全な電源オフ]] を参照してください。

これで、CUDA アプリケーションを起動すると、必要なすべてのカーネルモジュールが自動的にロードされます。CUDA の使用後に NVIDIA カードの電源を切る前に、まず {{ic|nvidia}} カーネルモジュールをアンロードする必要があります。

#rmmod nvidia_uvm
#rmmod NVIDIA

== nvidia グラフィックのみを使用 ==

[[NVIDIA|プロプライエタリの NVIDIA ドライバー]]は nouveau ドライバーのような動的な切り替えはサポートしていません (つまり NVIDIA デバイスしか使用できません)。また、NVIDIA は画面にティアリングが発生する問題を認識していますが未だに修正がなされていません。そのかわり、ディスクリート GPU を利用して nouveau ドライバーよりも高い性能を発揮することができます (2017年1月現在)。

まず {{Pkg|nvidia}} と {{Pkg|xorg-xrandr}} パッケージをインストールしてください。

そして、{{ic|xorg.conf}} を設定します。NVIDIA カードの PCI アドレスを知る必要があるので、次のコマンドを実行してください:

$ lspci | grep -E "VGA|3D"

NVIDIA と書かれた行の最初の7文字が PCI アドレスです。例えば {{ic|01:00.0}} などと表記されます。{{ic|xorg.conf}} では {{ic|#:#:#}} という形式で表記する必要があります。例えば {{ic|01:00.0}} の場合 {{ic|1:0:0}} となります。

{{Note|セットアップによっては EDID ファイルによる nvidia ドライバーのディスプレイの値の自動検出がされなくなることがあります。解決方法は [[#解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される]] を見て下さい。}}

{{hc|/etc/X11/xorg.conf.d/10-nvidia-drm-outputclass.conf|
Section "OutputClass"
Identifier "intel"
MatchDriver "i915"
Driver "modesetting"
EndSection

Section "OutputClass"
Identifier "nvidia"
MatchDriver "nvidia-drm"
Driver "nvidia"
Option "AllowEmptyInitialConfiguration"
Option "PrimaryGPU" "yes"
ModulePath "/usr/lib/nvidia/xorg"
ModulePath "/usr/lib/xorg/modules"
EndSection

}}

次に、{{ic|~/.xinitrc}} の最初に以下の2行を追加してください:

{{hc|~/.xinitrc|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

そしてドライバーをロードするために再起動し、X を起動させます。

ディスプレイの dpi が正しくない場合は以下の行を追加してください:

xrandr --dpi 96

X の起動時に黒画面が表示される場合、{{ic|~/.xinitrc}} に記述した {{ic|xrandr}} コマンドの後にアンパサンドがないことを確認してください。アンパサンドがある場合、{{ic|xrandr}} コマンドが実行し終える前にウィンドウマネージャが起動してしまうことがあり、そうなると黒画面になってしまいます。

アンパサンドがないのに黒画面になる場合、下の [[#別の設定]] を見て下さい。

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

ディスプレイマネージャを使用する場合、{{ic|~/.xinitrc}} の代わりにディスプレイマネージャのディスプレイ設定スクリプトを作成・編集する必要があります。

==== LightDM ====

[[LightDM]] ディスプレイマネージャの場合:

{{hc|/etc/lightdm/display_setup.sh|
#!/bin/sh
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

スクリプトに実行可能属性を付与:

# chmod +x /etc/lightdm/display_setup.sh

{{ic|/etc/lightdm/lightdm.conf}} の {{ic|[Seat:*]}} セクションを編集してスクリプトを実行するように lightdm を設定:

{{hc|/etc/lightdm/lightdm.conf|output=
[Seat:*]
display-setup-script=/etc/lightdm/display_setup.sh
}}

再起動して、ディスプレイマネージャが起動するのを確認してください。

==== SDDM ====
[[SDDM]] ディスプレイマネージャの場合:

{{hc|/usr/share/sddm/scripts/Xsetup|
xrandr --setprovideroutputsource modesetting NVIDIA-0
xrandr --auto
}}

==== GDM ====
[[GDM]] ディスプレイマネージャの場合 {{ic|.desktop}} ファイルを作成します:

{{hc|/usr/share/gdm/greeter/autostart/optimus.desktop|
<nowiki>[Desktop Entry]
Type=Application
Name=Optimus
Exec=sh -c "xrandr --setprovideroutputsource modesetting NVIDIA-0; xrandr --auto"
NoDisplay=true
X-GNOME-Autostart-Phase=DisplayServer</nowiki>
}}

また、GDM が [[GDM#Xorg バックエンドを使う|Xorg バックエンドを使う]]ようになっているか確認してください。

==== KDM ====

KDE の [[KDM]] の場合、{{ic|/usr/share/config/kdm/Xsetup}} に xrandr の行を追加してください。

=== 3D の確認 ===

NVIDIA グラフィックが使われているかどうかは {{Pkg|mesa-demos}} をインストールして次のコマンドを実行することで確認できます:

$ glxinfo | grep NVIDIA

=== 詳細情報 ===

詳しい情報は、NVIDIA の公式ページ [http://us.download.nvidia.com/XFree86/Linux-x86/370.28/README/randr14.html] を見て下さい。

== 切り替え可能なグラフィックスを使用 ==

=== PRIME レンダリングオフロードを使用する===

これは、切り替え可能なグラフィックスをサポートする公式の NVIDIA メソッドです。

詳細については、 [[PRIME#PRIME render offload]] を参照してください。

=== nouveau を使う===

グラフィックスイッチングについては [[PRIME]] を、オープンソースの NVIDIA ドライバについては [[nouveau]] を参照してください。

=== Bumblebee を使用===

[[Bumblebee]] を参照してください。

=== nvidia-xrun を使用する ===

[[nvidia-xrun]] を参照してください。

=== optimus-managerを使用する ===

[https://github.com/Askannz/optimus-manager Optimus-manager] アップストリームのドキュメントを参照してください。Arch Linux システムでのインストールと設定の両方について説明します。

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

=== 垂直同期が機能せずティアリングが発生する ===

解決するには {{pkg|xorg-server}} 1.19 以上、{{pkg|linux}} カーネル 4.5 以上、{{pkg|nvidia}} 370.23 以上が必須です。[[NVIDIA#DRM カーネルモードセッティング]]を有効にすることで PRIME 同期が有効になりティアリングが解消されます。

詳しくは公式の [https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/ フォーラムスレッド] を参照してください。

=== Failed to initialize the NVIDIA GPU at PCI:1:0:0 (GPU fallen off the bus / RmInitAdapter failed!) ===

カーネルパラメータに {{ic|1=rcutree.rcu_idle_gp_delay=1}} を追加してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=169742 こちら] を参照。

=== 解像度や画面スキャンが正しく認識されず Xorg.log に EDID のエラーが表示される ===

nVidia ドライバーがディスプレイの EDID を検出できないのが原因です。手動で EDID ファイルのパスを指定するか、同じような方法で同一の情報を提供する必要があります。

EDID ファイルのパスを指定するには {{ic|Xorg.conf}} の nvidia カードの Device セクションを編集して、以下の行を追加して適当にパスを置き換えてください:

{{hc|/etc/X11/xorg.conf|
Section "Device"
Option "ConnectedMonitor" "CRT-0"
Option "CustomEDID" "CRT-0:/sys/class/drm/card0-LVDS-1/edid"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
EndSection
}}

Xorg が起動しない場合は、CRT という文字列を全て DFB に置き換えてみて下さい。card0 は intel カードの識別子でディスプレイは LVDS で接続されています。edid バイナリはこのディレクトリに存在します。ハードウェアの構成が異なっている場合、CustomEDID の値も変わってくるので確認するようにしてください。パスの先頭の {{ic|/sys/class/drm}} は変わらないはずです。

または、{{Pkg|read-edid}} などのツールを使って edid を自分で作成して、作成したファイルを使うようにドライバーを設定することもできます。modeline も使えますが、"UseEDID" と "IgnoreEDID" は変更するようにしてください。

=== Wrong resolution without EDID errors ===

Using ''nvidia-xconfig'', incorrect information might be generated in Xorg.conf and in particular wrong monitor refresh rates that restruct the possible resolutions. Try commenting out the {{ic|HorizSync}}/{{ic|VertRefresh}} lines. If this helps, you can probably also remove everything else not mentioned in this article.

=== ロックアップ問題 (lspci がフリーズ) ===
GTX 965M が搭載された最新のノートパソコンで (Bumblebee などで) bbswitch や nouveau を使ったときに lspci がフリーズしたり、サスペンドが失敗したり、シャットダウン時に止まってしまったり、optirun でフリーズが発生することがあります。

dGPU 電源リソースがオンになっている場合、ACPI コードで失敗してフリーズが起こることがあります ([https://bugzilla.kernel.org/show_bug.cgi?id=156341 カーネルバグ 156341])。

解決方法については [https://github.com/Bumblebee-Project/Bumblebee/issues/764#issuecomment-234494238 こちら] を見てください。また、{{ic|1=acpi_osi="!Windows 2015"}} や {{ic|1=acpi_osi=! acpi_osi="Windows 2009"}} を[[カーネルパラメータ]]に追加して起動することで解決することもあります。

=== No screens found on a laptop/NVIDIA Optimus ===

Check if {{ic|<nowiki>$ lspci | grep VGA</nowiki>}}
outputs something similar to:
00:02.0 VGA compatible controller: Intel Corporation Core Processor Integrated Graphics Controller (rev 02)
01:00.0 VGA compatible controller: nVidia Corporation Device 0df4 (rev a1)

NVIDIA drivers now offer Optimus support since 319.12 Beta [https://www.nvidia.com/object/linux-display-amd64-319.12-driver.html] with kernels above and including 3.9.

Another solution is to install the [[Intel]] driver to handle the screens, then if you want 3D software you should run them through [[Bumblebee]] to tell them to use the NVIDIA card.

ダイナミック DNS

2022-07-03T02:12:51Z

Shota: /* ddclient */ DNSdynamic のリンク先が異なるサービスとなっている。英語版でも消去されていたのでこちらも消去.

[[Category:Domain Name System]]
[[en:Dynamic DNS]]
'''Dynamic DNS''' あるいは '''DDNS''' はインターネット上の絶えず変化する IP アドレスを指し示す [[:カテゴリ:Domain Name System|DNS]] をリアルタイムに更新する手法です。ダイナミック DNS は固定 IP が存在しないリソースに恒久的なドメイン名を割り当てるのに使われます。DDNS を使用するには、DDNS プロバイダで登録を行なって、さらに、IP アドレスが変わったときにプロバイダに新しい IP を通知するように自動更新ツールを設定する必要があります。

== ルーター ==

DDNS を必要とするデバイスがルーターを通している場合、まずルーターだけで DDNS サービスを更新することができないか確認してください。使用できるサービスは限られますが、ルーターを使うことにはメリットが複数存在します: セットアップが簡単であり、メンテナンスの必要がほとんどありません。そしてダウンタイムがなくなります (ルーターが落ちた場合、インターネットに接続自体ができなくなります)。

== 更新用クライアントツール ==

いくつかの DDNS プロバイダはクライアントツールを必須とはしておらず、[[cURL]] で更新することも可能であることは気に留めておいて下さい。

=== 複数サービスに対応したクライアント ===

* {{App|[[#ddclient|ddclient]]|多くのDDNSサービスのアカウントのDDNSエントリを更新できます。|https://github.com/ddclient/ddclient|{{Pkg|ddclient}}}}
* {{App|ddnsc|Pythonで書かれたシンプルで軽量なクライアント。|https://github.com/shyaminayesh/ddnsc|{{AUR|ddnsc}}}}
* {{App|inadyn|SSL/TLSをサポートしたDDNSクライアント。|https://troglobit.com/projects/inadyn/|{{Pkg|inadyn}}}}
* {{App|inadyn-mt|inadyn が元となったシンプルなDDNSクライアント。|http://inadyn-mt.sourceforge.net/|{{AUR|inadyn-mt}}}}
* {{App|ndyndns|DynDNS と Namecheapをサポートしています。|https://github.com/niklata/ndyndns|{{AUR|ndyndns}}}}

=== 特定のサービスの為のクライアント ===

* {{App|duckdns|systemd を用いて DuckDNS.org のエントリを更新するクライアント。|https://www.duckdns.org/|{{AUR|duckdns}}, {{AUR|duckdns-ipv6}}}}
* {{App|hetzner_ddns|Hetzner DNS のためのDDNS デーモン。|https://github.com/filiparag/hetzner_ddns|{{AUR|hetzner_ddns}}}}
* {{App|noip|no-ip.com サービスのためのDDNS クライアント。|3=https://www.no-ip.com/downloads.php?page=linux|4={{AUR|noip}}}}
* {{App|petrified|freedns.afraid.org を更新するための bash クライアント。|https://gitlab.com/troyengel/petrified|{{AUR|petrified}}}}

=== ddclient ===

{{Pkg|ddclient}} は多数の DDNS サービスに対応しているため、[[#ルーター|ルーター]]が使えない場合は DDNS を更新するための推奨ツールとなります。ddclient は [[systemd]] にも対応しています。

インストールした後、デフォルトの設定ファイル {{ic|/etc/ddclient/ddclient.conf}} を編集して使用する DDNS プロバイダをセットアップしてください (ファイルには多数の例が記載されています)。設定したら {{ic|ddclient.service}} を[[起動]]・[[有効化]]してください。

{{ic|-noquiet}} と {{ic|-debu}} オプションを付けて実行することで設定をテストできます:

# ddclient -daemon=0 -noquiet -debug

ddclient 対応のサービスの一部を以下に挙げます。[https://sourceforge.net/p/ddclient/code/HEAD/tree/trunk/sample-etc_ddclient.conf examples] や [https://sourceforge.net/p/ddclient/wiki/protocols/ protocols] にはさらに多くのプロバイダが載っています。

{| class="wikitable"
|+ ddclient に対応しているサービス
! サービス名
! 費用
! 利用可能なレコード
! ホストネーム数
! 設定のノート
! 他のツール
|-
! [http://now-dns.com/ Now-DNS]
| 無料 || A, AAAA || 無制限 || {{ic|dyndns2}} プロトコルを使用、サーバー: {{ic|now-dns.com/update}} ||
|-
! [http://www.changeip.com/ ChangeIP]
| 無料あるいは有料 || A, AAAA, CNAME, MX, サブドメイン || 7つまで無料 || ||
|-
! [https://www.duckdns.org/ Duck DNS]
| 無料 || || || || {{aur|duckdns}}
|-
! [https://www.dynu.com/ Dynu]
| 無料あるいは有料 || || 4つまで無料、有料で500まで || [https://www.dynu.com/DynamicDNS/IPUpdateClient/DDClient サンプル] ||
|-
! [http://freedns.afraid.org/ FreeDNS]
| 無料あるいは有料 || CNAME, A, AAAA, MX, NS, TXT, LOC, RP, HINFO, SRV || 5つまで無料 || [http://freedns.afraid.org/scripts/freedns.clients.php 例] || {{aur|afraid-dyndns-uv}}, {{aur|petrified}}
|-
! [http://www.noip.com/ No-IP]
| 無料あるいは有料 || || 3つまで無料、有料で25以上 || {{ic|noip}} プロトコル、{{ic|dynupdate.no-ip.com}} サーバーを使用 || {{aur|noip}}
|-
! [https://www.nsupdate.info/ nsupdate.info]
| 無料かつオープンソース || A, AAAA || || {{ic|dyndns2}} プロトコルを使用 || {{aur|inadyn-fork}}
|-
|}

{{Note|no-ip の無料ユーザーは30日ごとにドメインを手動で確認する必要があります。有料ユーザーはドメイン確認が不要です。詳しくは [http://www.noip.com/support/knowledgebase/why-is-my-hostname-pending-deletion/ Why is My Hostname Pending Deletion?] を参照。}}

==== 外部ウェブサイトから IP アドレスを確認 ====

ddclient が IP アドレスを検出できない場合、[http://checkip.dyndns.org checkip.dyndns.org] などの外部ウェブサイトから IP アドレスを取得するように ddclient を設定できます。デフォルトでは {{ic|use=web]} を指定した場合にこのアドレスが利用されます。また、IPを確認するサービスへの頻繁なアクセスを避けるために、確認までの期間を延すことが推奨されています:

{{hc|/etc/ddclient/ddclient.conf|2=
daemon=900
# web status page から IP アドレスを取得
use=web
}}

他の IP 確認サービスを {{ic|web}} オプションで設定する事もできます:

{{hc|/etc/ddclient/ddclient.conf|2=
daemon=900
# web status page から IP アドレスを取得
use=web, web=myonlineportal.net/checkip
}}

==== IPv6 アドレスを決めるためにスクリプトを使う ====

ddclient は時折、IPv6 アドレスの取得を間違えるか失敗します。しかし、外部のウェブサイトの代わりにローカルに IPv6 を知ることができます。以下のスクリプトが使えます:

{{hc|/usr/bin/get-ip|2=
<nowiki>
#!/bin/bash
/sbin/ip -6 addr | grep inet6 | awk -F '[ \t]+|/' '{print $3}' | grep -v ^::1 | grep -v ^fe80
</nowiki>
}}

このスクリプトを使うように ddclient を設定するには:

{{hc|/etc/ddclient/ddclient.conf|2=
# obtain IP address from script
use=cmd,cmd='/usr/bin/get-ip'
}}

==== ネットワークが立ち上がった後に ddclient を起動 ====

ddclient で IP を更新できない場合、おそらくネットワークが立ち上がる前に ddclient のプロセスが起動しているのが原因です。修正するには、ユニットファイルを編集して {{ic|network-online.target}} に依存するようにしてください:

{{hc|# systemctl edit ddclient.service|2=
[Unit]
After=network-online.target
Wants=network-online.target
}}

== 他のプロバイダ ==

以下の DDNS プロバイダは [[#ddclient|ddclient]] に対応していないため、特殊なツールを使ったりカスタムスクリプトで IP を更新する必要があります。コマンドラインで IP を更新できる場合、[[cron]] や [[systemd/タイマー]]などのツールを利用して更新を自動化することができます。

=== duiadns ===
[https://www.duiadns.net Duiadns.org] は無料のサービスです。{{AUR|duiadns}}{{Broken package link|{{aur-mirror|duiadns}}}} で自動化が可能。

=== FreeDns.io ===

[https://freedns.io FreeDns.io] は無料で A, AAAA, DNS レコードを提供します。CNAME, TXT, MX レコードはプレミアムメンバーになる必要があります。HTTP API を利用して IP を更新することができます (1時間あたり60回までの制限あり)。[https://github.com/nkovacne/freedns-samples 複数のサンプルスクリプト] が用意されています。

=== Now-DNS ===
[https://now-dns.com Now-DNS.com] は簡単にセットアップができる無料サービスです。

=== System-NS ===

[http://system-ns.com/ System-NS] はコマンドラインによる更新ができる無料サービスです。[https://system-ns.com/services/dynamic 公式のドキュメント] を参照してください。

=== Loopia.se ===

ネームサーバーとして loopia.se を使う場合、[https://support.loopia.se/wiki/curl/ 公式ドキュメント] に書かれているように ''curl'' で DNS レコードを更新することができます。

ダイナミック DNS

2022-07-02T10:08:02Z

Shota: /* 他のプロバイダ */ 節が重複してしまったので削除

[[Category:Domain Name System]]
[[en:Dynamic DNS]]
'''Dynamic DNS''' あるいは '''DDNS''' はインターネット上の絶えず変化する IP アドレスを指し示す [[:カテゴリ:Domain Name System|DNS]] をリアルタイムに更新する手法です。ダイナミック DNS は固定 IP が存在しないリソースに恒久的なドメイン名を割り当てるのに使われます。DDNS を使用するには、DDNS プロバイダで登録を行なって、さらに、IP アドレスが変わったときにプロバイダに新しい IP を通知するように自動更新ツールを設定する必要があります。

== ルーター ==

DDNS を必要とするデバイスがルーターを通している場合、まずルーターだけで DDNS サービスを更新することができないか確認してください。使用できるサービスは限られますが、ルーターを使うことにはメリットが複数存在します: セットアップが簡単であり、メンテナンスの必要がほとんどありません。そしてダウンタイムがなくなります (ルーターが落ちた場合、インターネットに接続自体ができなくなります)。

== 更新用クライアントツール ==

いくつかの DDNS プロバイダはクライアントツールを必須とはしておらず、[[cURL]] で更新することも可能であることは気に留めておいて下さい。

=== 複数サービスに対応したクライアント ===

* {{App|[[#ddclient|ddclient]]|多くのDDNSサービスのアカウントのDDNSエントリを更新できます。|https://github.com/ddclient/ddclient|{{Pkg|ddclient}}}}
* {{App|ddnsc|Pythonで書かれたシンプルで軽量なクライアント。|https://github.com/shyaminayesh/ddnsc|{{AUR|ddnsc}}}}
* {{App|inadyn|SSL/TLSをサポートしたDDNSクライアント。|https://troglobit.com/projects/inadyn/|{{Pkg|inadyn}}}}
* {{App|inadyn-mt|inadyn が元となったシンプルなDDNSクライアント。|http://inadyn-mt.sourceforge.net/|{{AUR|inadyn-mt}}}}
* {{App|ndyndns|DynDNS と Namecheapをサポートしています。|https://github.com/niklata/ndyndns|{{AUR|ndyndns}}}}

=== 特定のサービスの為のクライアント ===

* {{App|duckdns|systemd を用いて DuckDNS.org のエントリを更新するクライアント。|https://www.duckdns.org/|{{AUR|duckdns}}, {{AUR|duckdns-ipv6}}}}
* {{App|hetzner_ddns|Hetzner DNS のためのDDNS デーモン。|https://github.com/filiparag/hetzner_ddns|{{AUR|hetzner_ddns}}}}
* {{App|noip|no-ip.com サービスのためのDDNS クライアント。|3=https://www.no-ip.com/downloads.php?page=linux|4={{AUR|noip}}}}
* {{App|petrified|freedns.afraid.org を更新するための bash クライアント。|https://gitlab.com/troyengel/petrified|{{AUR|petrified}}}}

=== ddclient ===

{{Pkg|ddclient}} は多数の DDNS サービスに対応しているため、[[#ルーター|ルーター]]が使えない場合は DDNS を更新するための推奨ツールとなります。ddclient は [[systemd]] にも対応しています。

インストールした後、デフォルトの設定ファイル {{ic|/etc/ddclient/ddclient.conf}} を編集して使用する DDNS プロバイダをセットアップしてください (ファイルには多数の例が記載されています)。設定したら {{ic|ddclient.service}} を[[起動]]・[[有効化]]してください。

{{ic|-noquiet}} と {{ic|-debu}} オプションを付けて実行することで設定をテストできます:

# ddclient -daemon=0 -noquiet -debug

ddclient 対応のサービスの一部を以下に挙げます。[https://sourceforge.net/p/ddclient/code/HEAD/tree/trunk/sample-etc_ddclient.conf examples] や [https://sourceforge.net/p/ddclient/wiki/protocols/ protocols] にはさらに多くのプロバイダが載っています。

{| class="wikitable"
|+ ddclient に対応しているサービス
! サービス名
! 費用
! 利用可能なレコード
! ホストネーム数
! 設定のノート
! 他のツール
|-
! [http://now-dns.com/ Now-DNS]
| 無料 || A, AAAA || 無制限 || {{ic|dyndns2}} プロトコルを使用、サーバー: {{ic|now-dns.com/update}} ||
|-
! [http://www.changeip.com/ ChangeIP]
| 無料あるいは有料 || A, AAAA, CNAME, MX, サブドメイン || 7つまで無料 || ||
|-
! [http://www.dnsdynamic.org/ DNSdynamic]
| 無料 || || || [https://www.dnsdynamic.org/api.php 例] ||
|-
! [https://www.duckdns.org/ Duck DNS]
| 無料 || || || || {{aur|duckdns}}
|-
! [https://www.dynu.com/ Dynu]
| 無料あるいは有料 || || 4つまで無料、有料で500まで || [https://www.dynu.com/DynamicDNS/IPUpdateClient/DDClient サンプル] ||
|-
! [http://freedns.afraid.org/ FreeDNS]
| 無料あるいは有料 || CNAME, A, AAAA, MX, NS, TXT, LOC, RP, HINFO, SRV || 5つまで無料 || [http://freedns.afraid.org/scripts/freedns.clients.php 例] || {{aur|afraid-dyndns-uv}}, {{aur|petrified}}
|-
! [http://www.noip.com/ No-IP]
| 無料あるいは有料 || || 3つまで無料、有料で25以上 || {{ic|noip}} プロトコル、{{ic|dynupdate.no-ip.com}} サーバーを使用 || {{aur|noip}}
|-
! [https://www.nsupdate.info/ nsupdate.info]
| 無料かつオープンソース || A, AAAA || || {{ic|dyndns2}} プロトコルを使用 || {{aur|inadyn-fork}}
|-
|}

{{Note|no-ip の無料ユーザーは30日ごとにドメインを手動で確認する必要があります。有料ユーザーはドメイン確認が不要です。詳しくは [http://www.noip.com/support/knowledgebase/why-is-my-hostname-pending-deletion/ Why is My Hostname Pending Deletion?] を参照。}}

==== 外部ウェブサイトから IP アドレスを確認 ====

ddclient が IP アドレスを検出できない場合、[http://checkip.dyndns.org checkip.dyndns.org] などの外部ウェブサイトから IP アドレスを取得するように ddclient を設定できます。デフォルトでは {{ic|use=web]} を指定した場合にこのアドレスが利用されます。また、IPを確認するサービスへの頻繁なアクセスを避けるために、確認までの期間を延すことが推奨されています:

{{hc|/etc/ddclient/ddclient.conf|2=
daemon=900
# web status page から IP アドレスを取得
use=web
}}

他の IP 確認サービスを {{ic|web}} オプションで設定する事もできます:

{{hc|/etc/ddclient/ddclient.conf|2=
daemon=900
# web status page から IP アドレスを取得
use=web, web=myonlineportal.net/checkip
}}

==== IPv6 アドレスを決めるためにスクリプトを使う ====

ddclient は時折、IPv6 アドレスの取得を間違えるか失敗します。しかし、外部のウェブサイトの代わりにローカルに IPv6 を知ることができます。以下のスクリプトが使えます:

{{hc|/usr/bin/get-ip|2=
<nowiki>
#!/bin/bash
/sbin/ip -6 addr | grep inet6 | awk -F '[ \t]+|/' '{print $3}' | grep -v ^::1 | grep -v ^fe80
</nowiki>
}}

このスクリプトを使うように ddclient を設定するには:

{{hc|/etc/ddclient/ddclient.conf|2=
# obtain IP address from script
use=cmd,cmd='/usr/bin/get-ip'
}}

==== ネットワークが立ち上がった後に ddclient を起動 ====

ddclient で IP を更新できない場合、おそらくネットワークが立ち上がる前に ddclient のプロセスが起動しているのが原因です。修正するには、ユニットファイルを編集して {{ic|network-online.target}} に依存するようにしてください:

{{hc|# systemctl edit ddclient.service|2=
[Unit]
After=network-online.target
Wants=network-online.target
}}

== 他のプロバイダ ==

以下の DDNS プロバイダは [[#ddclient|ddclient]] に対応していないため、特殊なツールを使ったりカスタムスクリプトで IP を更新する必要があります。コマンドラインで IP を更新できる場合、[[cron]] や [[systemd/タイマー]]などのツールを利用して更新を自動化することができます。

=== duiadns ===
[https://www.duiadns.net Duiadns.org] は無料のサービスです。{{AUR|duiadns}}{{Broken package link|{{aur-mirror|duiadns}}}} で自動化が可能。

=== FreeDns.io ===

[https://freedns.io FreeDns.io] は無料で A, AAAA, DNS レコードを提供します。CNAME, TXT, MX レコードはプレミアムメンバーになる必要があります。HTTP API を利用して IP を更新することができます (1時間あたり60回までの制限あり)。[https://github.com/nkovacne/freedns-samples 複数のサンプルスクリプト] が用意されています。

=== Now-DNS ===
[https://now-dns.com Now-DNS.com] は簡単にセットアップができる無料サービスです。

=== System-NS ===

[http://system-ns.com/ System-NS] はコマンドラインによる更新ができる無料サービスです。[https://system-ns.com/services/dynamic 公式のドキュメント] を参照してください。

=== Loopia.se ===

ネームサーバーとして loopia.se を使う場合、[https://support.loopia.se/wiki/curl/ 公式ドキュメント] に書かれているように ''curl'' で DNS レコードを更新することができます。

ダイナミック DNS

2022-07-02T10:06:13Z

Shota: /* 更新用クライアントツール */ テーブル以外は英語版と同期。便利そうだったのでテーブルは、この構成を保持しておきたいと考えた。

[[Category:Domain Name System]]
[[en:Dynamic DNS]]
'''Dynamic DNS''' あるいは '''DDNS''' はインターネット上の絶えず変化する IP アドレスを指し示す [[:カテゴリ:Domain Name System|DNS]] をリアルタイムに更新する手法です。ダイナミック DNS は固定 IP が存在しないリソースに恒久的なドメイン名を割り当てるのに使われます。DDNS を使用するには、DDNS プロバイダで登録を行なって、さらに、IP アドレスが変わったときにプロバイダに新しい IP を通知するように自動更新ツールを設定する必要があります。

== ルーター ==

DDNS を必要とするデバイスがルーターを通している場合、まずルーターだけで DDNS サービスを更新することができないか確認してください。使用できるサービスは限られますが、ルーターを使うことにはメリットが複数存在します: セットアップが簡単であり、メンテナンスの必要がほとんどありません。そしてダウンタイムがなくなります (ルーターが落ちた場合、インターネットに接続自体ができなくなります)。

== 更新用クライアントツール ==

いくつかの DDNS プロバイダはクライアントツールを必須とはしておらず、[[cURL]] で更新することも可能であることは気に留めておいて下さい。

=== 複数サービスに対応したクライアント ===

* {{App|[[#ddclient|ddclient]]|多くのDDNSサービスのアカウントのDDNSエントリを更新できます。|https://github.com/ddclient/ddclient|{{Pkg|ddclient}}}}
* {{App|ddnsc|Pythonで書かれたシンプルで軽量なクライアント。|https://github.com/shyaminayesh/ddnsc|{{AUR|ddnsc}}}}
* {{App|inadyn|SSL/TLSをサポートしたDDNSクライアント。|https://troglobit.com/projects/inadyn/|{{Pkg|inadyn}}}}
* {{App|inadyn-mt|inadyn が元となったシンプルなDDNSクライアント。|http://inadyn-mt.sourceforge.net/|{{AUR|inadyn-mt}}}}
* {{App|ndyndns|DynDNS と Namecheapをサポートしています。|https://github.com/niklata/ndyndns|{{AUR|ndyndns}}}}

=== 特定のサービスの為のクライアント ===

* {{App|duckdns|systemd を用いて DuckDNS.org のエントリを更新するクライアント。|https://www.duckdns.org/|{{AUR|duckdns}}, {{AUR|duckdns-ipv6}}}}
* {{App|hetzner_ddns|Hetzner DNS のためのDDNS デーモン。|https://github.com/filiparag/hetzner_ddns|{{AUR|hetzner_ddns}}}}
* {{App|noip|no-ip.com サービスのためのDDNS クライアント。|3=https://www.no-ip.com/downloads.php?page=linux|4={{AUR|noip}}}}
* {{App|petrified|freedns.afraid.org を更新するための bash クライアント。|https://gitlab.com/troyengel/petrified|{{AUR|petrified}}}}

=== ddclient ===

{{Pkg|ddclient}} は多数の DDNS サービスに対応しているため、[[#ルーター|ルーター]]が使えない場合は DDNS を更新するための推奨ツールとなります。ddclient は [[systemd]] にも対応しています。

インストールした後、デフォルトの設定ファイル {{ic|/etc/ddclient/ddclient.conf}} を編集して使用する DDNS プロバイダをセットアップしてください (ファイルには多数の例が記載されています)。設定したら {{ic|ddclient.service}} を[[起動]]・[[有効化]]してください。

{{ic|-noquiet}} と {{ic|-debu}} オプションを付けて実行することで設定をテストできます:

# ddclient -daemon=0 -noquiet -debug

ddclient 対応のサービスの一部を以下に挙げます。[https://sourceforge.net/p/ddclient/code/HEAD/tree/trunk/sample-etc_ddclient.conf examples] や [https://sourceforge.net/p/ddclient/wiki/protocols/ protocols] にはさらに多くのプロバイダが載っています。

{| class="wikitable"
|+ ddclient に対応しているサービス
! サービス名
! 費用
! 利用可能なレコード
! ホストネーム数
! 設定のノート
! 他のツール
|-
! [http://now-dns.com/ Now-DNS]
| 無料 || A, AAAA || 無制限 || {{ic|dyndns2}} プロトコルを使用、サーバー: {{ic|now-dns.com/update}} ||
|-
! [http://www.changeip.com/ ChangeIP]
| 無料あるいは有料 || A, AAAA, CNAME, MX, サブドメイン || 7つまで無料 || ||
|-
! [http://www.dnsdynamic.org/ DNSdynamic]
| 無料 || || || [https://www.dnsdynamic.org/api.php 例] ||
|-
! [https://www.duckdns.org/ Duck DNS]
| 無料 || || || || {{aur|duckdns}}
|-
! [https://www.dynu.com/ Dynu]
| 無料あるいは有料 || || 4つまで無料、有料で500まで || [https://www.dynu.com/DynamicDNS/IPUpdateClient/DDClient サンプル] ||
|-
! [http://freedns.afraid.org/ FreeDNS]
| 無料あるいは有料 || CNAME, A, AAAA, MX, NS, TXT, LOC, RP, HINFO, SRV || 5つまで無料 || [http://freedns.afraid.org/scripts/freedns.clients.php 例] || {{aur|afraid-dyndns-uv}}, {{aur|petrified}}
|-
! [http://www.noip.com/ No-IP]
| 無料あるいは有料 || || 3つまで無料、有料で25以上 || {{ic|noip}} プロトコル、{{ic|dynupdate.no-ip.com}} サーバーを使用 || {{aur|noip}}
|-
! [https://www.nsupdate.info/ nsupdate.info]
| 無料かつオープンソース || A, AAAA || || {{ic|dyndns2}} プロトコルを使用 || {{aur|inadyn-fork}}
|-
|}

{{Note|no-ip の無料ユーザーは30日ごとにドメインを手動で確認する必要があります。有料ユーザーはドメイン確認が不要です。詳しくは [http://www.noip.com/support/knowledgebase/why-is-my-hostname-pending-deletion/ Why is My Hostname Pending Deletion?] を参照。}}

==== 外部ウェブサイトから IP アドレスを確認 ====

ddclient が IP アドレスを検出できない場合、[http://checkip.dyndns.org checkip.dyndns.org] などの外部ウェブサイトから IP アドレスを取得するように ddclient を設定できます。デフォルトでは {{ic|use=web]} を指定した場合にこのアドレスが利用されます。また、IPを確認するサービスへの頻繁なアクセスを避けるために、確認までの期間を延すことが推奨されています:

{{hc|/etc/ddclient/ddclient.conf|2=
daemon=900
# web status page から IP アドレスを取得
use=web
}}

他の IP 確認サービスを {{ic|web}} オプションで設定する事もできます:

{{hc|/etc/ddclient/ddclient.conf|2=
daemon=900
# web status page から IP アドレスを取得
use=web, web=myonlineportal.net/checkip
}}

==== IPv6 アドレスを決めるためにスクリプトを使う ====

ddclient は時折、IPv6 アドレスの取得を間違えるか失敗します。しかし、外部のウェブサイトの代わりにローカルに IPv6 を知ることができます。以下のスクリプトが使えます:

{{hc|/usr/bin/get-ip|2=
<nowiki>
#!/bin/bash
/sbin/ip -6 addr | grep inet6 | awk -F '[ \t]+|/' '{print $3}' | grep -v ^::1 | grep -v ^fe80
</nowiki>
}}

このスクリプトを使うように ddclient を設定するには:

{{hc|/etc/ddclient/ddclient.conf|2=
# obtain IP address from script
use=cmd,cmd='/usr/bin/get-ip'
}}

==== ネットワークが立ち上がった後に ddclient を起動 ====

ddclient で IP を更新できない場合、おそらくネットワークが立ち上がる前に ddclient のプロセスが起動しているのが原因です。修正するには、ユニットファイルを編集して {{ic|network-online.target}} に依存するようにしてください:

{{hc|# systemctl edit ddclient.service|2=
[Unit]
After=network-online.target
Wants=network-online.target
}}

=== 他のプロバイダ ===

他の DDNS プロバイダは ddclient とは互換性がありません。対応しないプロバイダの為には、特殊なツールやカスタムのスクリプトを必要になるかもしれません。もし IP アドレスがコマンドラインでアップデート可能であるならば、[[cron]] や [[systemd/タイマー]] などのツールで自動的に実現可能であることを覚えておいて下さい。

== 他のプロバイダ ==

以下の DDNS プロバイダは [[#ddclient|ddclient]] に対応していないため、特殊なツールを使ったりカスタムスクリプトで IP を更新する必要があります。コマンドラインで IP を更新できる場合、[[cron]] や [[systemd/タイマー]]などのツールを利用して更新を自動化することができます。

=== duiadns ===
[https://www.duiadns.net Duiadns.org] は無料のサービスです。{{AUR|duiadns}}{{Broken package link|{{aur-mirror|duiadns}}}} で自動化が可能。

=== FreeDns.io ===

[https://freedns.io FreeDns.io] は無料で A, AAAA, DNS レコードを提供します。CNAME, TXT, MX レコードはプレミアムメンバーになる必要があります。HTTP API を利用して IP を更新することができます (1時間あたり60回までの制限あり)。[https://github.com/nkovacne/freedns-samples 複数のサンプルスクリプト] が用意されています。

=== Now-DNS ===
[https://now-dns.com Now-DNS.com] は簡単にセットアップができる無料サービスです。

=== System-NS ===

[http://system-ns.com/ System-NS] はコマンドラインによる更新ができる無料サービスです。[https://system-ns.com/services/dynamic 公式のドキュメント] を参照してください。

=== Loopia.se ===

ネームサーバーとして loopia.se を使う場合、[https://support.loopia.se/wiki/curl/ 公式ドキュメント] に書かれているように ''curl'' で DNS レコードを更新することができます。

ダイナミック DNS

2022-07-02T09:37:54Z

Shota: 英語版に併せてセクション構成を変更

[[Category:Domain Name System]]
[[en:Dynamic DNS]]
'''Dynamic DNS''' あるいは '''DDNS''' はインターネット上の絶えず変化する IP アドレスを指し示す [[:カテゴリ:Domain Name System|DNS]] をリアルタイムに更新する手法です。ダイナミック DNS は固定 IP が存在しないリソースに恒久的なドメイン名を割り当てるのに使われます。DDNS を使用するには、DDNS プロバイダで登録を行なって、さらに、IP アドレスが変わったときにプロバイダに新しい IP を通知するように自動更新ツールを設定する必要があります。

== ルーター ==

DDNS を必要とするデバイスがルーターを通している場合、まずルーターだけで DDNS サービスを更新することができないか確認してください。使用できるサービスは限られますが、ルーターを使うことにはメリットが複数存在します: セットアップが簡単であり、メンテナンスの必要がほとんどありません。そしてダウンタイムがなくなります (ルーターが落ちた場合、インターネットに接続自体ができなくなります)。

== 更新用クライアントツール ==

=== ddclient ===

{{Pkg|ddclient}} は多数の DDNS サービスに対応しているため、[[#ルーター|ルーター]]が使えない場合は DDNS を更新するための推奨ツールとなります。ddclient は [[systemd]] にも対応しています。

インストールした後、デフォルトの設定ファイル {{ic|/etc/ddclient/ddclient.conf}} を編集して使用する DDNS プロバイダをセットアップしてください (ファイルには多数の例が記載されています)。設定したら {{ic|ddclient.service}} を[[起動]]・[[有効化]]してください。

ddclient 対応のサービスの一部を以下に挙げます。[https://sourceforge.net/p/ddclient/code/HEAD/tree/trunk/sample-etc_ddclient.conf examples] や [https://sourceforge.net/p/ddclient/wiki/protocols/ protocols] にはさらに多くのプロバイダが載っています。

{| class="wikitable"
|+ ddclient に対応しているサービス
! サービス名
! 費用
! 利用可能なレコード
! ホストネーム数
! 設定のノート
! 他のツール
|-
! [http://www.changeip.com/ ChangeIP]
| 無料あるいは有料 || A, AAAA, CNAME, MX, サブドメイン || 7つまで無料 || ||
|-
! [http://www.dnsdynamic.org/ DNSdynamic]
| 無料 || || || [https://www.dnsdynamic.org/api.php 例] ||
|-
! [https://www.duckdns.org/ Duck DNS]
| 無料 || || || || {{aur|duckdns}}
|-
! [https://www.dynu.com/ Dynu]
| 無料あるいは有料 || || 4つまで無料、有料で500まで || [https://www.dynu.com/DynamicDNS/IPUpdateClient/DDClient サンプル] ||
|-
! [http://freedns.afraid.org/ FreeDNS]
| 無料あるいは有料 || CNAME, A, AAAA, MX, NS, TXT, LOC, RP, HINFO, SRV || 5つまで無料 || [http://freedns.afraid.org/scripts/freedns.clients.php 例] || {{aur|afraid-dyndns-uv}}, {{aur|petrified}}
|-
! [http://www.noip.com/ No-IP]
| 無料あるいは有料 || || 3つまで無料、有料で25以上 || {{ic|noip}} プロトコル、{{ic|dynupdate.no-ip.com}} サーバーを使用 || {{aur|noip}}
|-
! [http://now-dns.com/ Now-DNS]
| 無料 || A, AAAA || 無制限 || {{ic|dyndns2}} プロトコルを使用、サーバー: {{ic|now-dns.com/update}} ||
|-
! [https://www.nsupdate.info/ nsupdate.info]
| 無料かつオープンソース || A, AAAA || || {{ic|dyndns2}} プロトコルを使用 || {{aur|inadyn-fork}}
|-
|}

{{Note|no-ip の無料ユーザーは30日ごとにドメインを手動で確認する必要があります。有料ユーザーはドメイン確認が不要です。詳しくは [http://www.noip.com/support/knowledgebase/why-is-my-hostname-pending-deletion/ Why is My Hostname Pending Deletion?] を参照。}}

==== 外部ウェブサイトから IP アドレスを確認 ====

ddclient が IP アドレスを検出できない場合、[http://whatismyip.org/ whatismyip.org] などの外部ウェブサイトから IP アドレスを取得するように ddclient を設定できます。設定ファイルに以下のように追加してください:

{{hc|/etc/ddclient/ddclient.conf|2=
# use whatismyip.org to determine IP address
use=web
web=whatismyip.org
}}

==== ネットワークが立ち上がった後に ddclient を起動 ====

ddclient で IP を更新できない場合、おそらくネットワークが立ち上がる前に ddclient のプロセスが起動しているのが原因です。修正するには、ユニットファイルを編集して {{ic|network-online.target}} に依存するようにしてください:

{{hc|# systemctl edit ddclient.service|2=
[Unit]
After=network-online.target
Wants=network-online.target
}}

{{ic|network-online.target}} に追加の設定が必要かもしれません。[https://www.freedesktop.org/wiki/Software/systemd/NetworkTarget#cutthecraphowdoimakenetwork.targetworkforme] を参照してください。

=== 他のツール ===

複数のプロバイダで使用することができる他の DDNS 更新ツールとして {{AUR|inadyn-mt}} ([https://sourceforge.net/projects/inadyn-mt 対応しているプロバイダ]) と {{AUR|ndyndns}} (DynDNS と Namecheap が対応) が存在します。

== 他のプロバイダ ==

以下の DDNS プロバイダは [[#ddclient|ddclient]] に対応していないため、特殊なツールを使ったりカスタムスクリプトで IP を更新する必要があります。コマンドラインで IP を更新できる場合、[[cron]] や [[systemd/タイマー]]などのツールを利用して更新を自動化することができます。

=== duiadns ===
[https://www.duiadns.net Duiadns.org] は無料のサービスです。{{AUR|duiadns}}{{Broken package link|{{aur-mirror|duiadns}}}} で自動化が可能。

=== FreeDns.io ===

[https://freedns.io FreeDns.io] は無料で A, AAAA, DNS レコードを提供します。CNAME, TXT, MX レコードはプレミアムメンバーになる必要があります。HTTP API を利用して IP を更新することができます (1時間あたり60回までの制限あり)。[https://github.com/nkovacne/freedns-samples 複数のサンプルスクリプト] が用意されています。

=== Now-DNS ===
[https://now-dns.com Now-DNS.com] は簡単にセットアップができる無料サービスです。

=== System-NS ===

[http://system-ns.com/ System-NS] はコマンドラインによる更新ができる無料サービスです。[https://system-ns.com/services/dynamic 公式のドキュメント] を参照してください。

=== Loopia.se ===

ネームサーバーとして loopia.se を使う場合、[https://support.loopia.se/wiki/curl/ 公式ドキュメント] に書かれているように ''curl'' で DNS レコードを更新することができます。

RAID

2022-04-29T04:34:20Z

Shota: /* 通常の RAID レベル */ URE の意味を明示

[[Category:Arch の入手とインストール]]
[[Category:ファイルシステム]]
[[en:RAID]]
[[es:RAID]]
[[it:RAID]]
[[zh-hans:RAID]]
{{Related articles start}}
{{Related|ソフトウェア RAID と LVM}}
{{Related|Fake RAID でインストール}}
{{Related|シングルドライブ環境を RAID に変換}}
{{Related|ZFS}}
{{Related|ZFS/仮想ディスク}}
{{Related|スワップ#ストライピング}}
{{Related|Btrfs#RAID 機能}}
{{Related articles end}}
この記事では RAID とは何なのか、そして mdadm によるソフトウェア RAID アレイの作成・管理方法を説明しています。

== イントロダクション ==
{{Wikipedia/ja|RAID}}
独立ディスク冗長アレイ (Redundant Array of Independent Disks, RAID) は複数のディスクドライブの構成部品 (一般的にはディスクドライブまたはそのパーティション) をまとめて一つの論理ユニットにするストレージ技術です。RAID の実装によって、この論理ユニットはファイルシステム、あるいは複数のパーティションを保持する追補的な透過レイヤーになります。データは "RAID レベル" と呼ばれる様々な方法によって、必要とされる冗長性やパフォーマンスにあわせて、ドライブに分散されます。RAID レベルの選択によって、ハードディスクが壊れた時にデータが喪失することを防いだり、パフォーマンスを向上させたり、あるいはその両方を実現できます。

ほとんどの RAID レベルでは冗長性が確保されていますが、RAID はデータが安全であることを保証するものではありません。火事があったときや、コンピュータが盗まれたとき、または複数のドライブが同時に壊れた場合など RAID はデータを保護しません。さらに、RAID でシステムをインストールするのは複雑な作業であり、そのときにデータを破壊してしまう可能性もあります。 {{Warning|従って、RAID を設定する前に、かならず全てのデータを[[バックアッププログラム|バックアップ]]しておきましょう。}}

{{Note|データの保存や冗長性のために RAID アレイを使おうと思っているユーザーは [[ZFS]] によって実装されている RAIDZ についても採用を検討すると良いでしょう。ソフトウェア RAID の代替としてより近代的でパワフルな能力があります。}}

===通常の RAID レベル===
[[Wikipedia:Standard RAID levels|RAID のレベル]]はたくさん存在します、以下は最も一般的に使われているレベルです。

; [[Wikipedia:Standard RAID levels#RAID 0|RAID 0]]
: ストライピングを使ってディスクを結合します。RAID 0 には''冗長性がありません''が、RAID とされています。耐障害性がない代わりに、''速度が向上する恩恵があります''。データが消失する可能性を差し引いても速度を上げる価値がある場合 (例えば[[スワップ]]パーティション)、この RAID レベルを選択します。サーバーでは、RAID 1 や RAID 5 アレイを使う方が適切です。RAID 0 アレイのブロックデバイスのサイズは一番小さいコンポーネントパーティションとコンポーネントパーティションの数を掛けた値になります。
; [[Wikipedia:Standard RAID levels#RAID 1|RAID 1]]
: 最もシンプルな RAID レベル: ミラーリングです。他の RAID レベルと同様に、パーティションを複数の物理ディスクドライブに配置した時にだけ意味をなします。ドライブのどれか一台が故障しても、RAID アレイによるブロックデバイスは通常通りに稼働し続けます。例では[[スワップ]]や一時的なデータを除いて全てを RAID 1 に保存します。ソフトウェア実装を使う場合、ブートパーティションで使えるのは RAID 1 レベルしかないので注意してください。ブートパーティションを読み込むブートローダーは RAID を認識できないながらも、RAID 1 のコンポーネントパーティションは通常のパーティションとして読み込めるからです。RAID 1 アレイのブロックデバイスのサイズは一番小さいコンポーネントパーティションと同じになります。
; [[Wikipedia:Standard RAID levels#RAID 5|RAID 5]]
: 三台以上の物理ドライブが必要で、RAID 0 の速度・サイズのメリットを残しながら RAID 1 の冗長性を実現します。RAID 5 は RAID 0 と同じようにストライピングを使いますが、それに加えて''それぞれのディスクに分散して''パリティブロックの記録を行います。ディスクが故障した時は、パリティブロックを利用して交換したディスクにデータを再構築します。RAID 5 は一台のディスクの喪失まで耐えることが可能です。
: {{Note|速度とデータの冗長性を両得できることから RAID 5 はよく使われています。ただし一台のドライブが壊れてから、ドライブを置き換える前にもう一台ドライブが故障すると、全てのデータを喪失するので注意してください。さらに、最近のディスク容量や修復不能なリードエラー (unrecoverble read error; URE) の発生率を考えると、4TiB のアレイを再構築するとき URE が (50% 以上という) 高い確率で発生します。そのため、ストレージ業界では RAID 5 はもはや推奨されていません。}}
; [[Wikipedia:Standard RAID levels#RAID 6|RAID 6]]
: 四台以上の物理ドライブを必要とし、RAID 5 の利点を活かしながらドライブが二台故障しても安全です。RAID 6 も RAID 5 と同じようにストライピングを使用しますが、二つの異なるパリティブロックを''それぞれのメンバーディスクに分散して''保存します。ディスクが故障したときは、パリティブロックを利用して交換したディスクにデータを再構築します。RAID 6 は二台のディスクの喪失まで耐えることが可能です。ドライブを再構築するときでもアレイにパリティブロックが存在するため、読み取りエラーに対する堅牢性は高くなっています。ただし、オーバーヘッドを考えると RAID 6 はコストがかかります。大抵の場合は far2 レイアウトの RAID 10 のほうが高い性能と堅牢性を確保できます (下を参照)。

===ネストされた RAID レベル===
; [[Wikipedia:Nested RAID levels#RAID 1 + 0|RAID 1+0]]
: RAID 1+0 は2つの標準 RAID レベルを組み合わせてパフォーマンスと冗長性を獲得する入れ子の RAID です。よく ''RAID 10'' と呼ばれますが、Linux MD RAID 10 は単純な RAID レイヤーとは多少異なっています。下記を見てください。

; [[Wikipedia:Non-standard_RAID_levels#Linux_MD_RAID_10|RAID 10]]
: Linux における RAID 10 は RAID 1+0 の概念に基づいていますが、シングルレイヤーとして実装することで複数のレイアウトが可能になっています。

: Y 台のディスクによる ''near X'' レイアウトは Y/2 個のストライプで X 個のチャンクが作成されますが、Y を均等に X で割る必要はありません。near という名前のとおり、チャンクは複製されるディスクに近い場所に配置されます。2台以上の任意の台数のディスクを使うことができます。2台のディスクによる Near 2 は RAID 1 と同じであり、4台のディスクによる Near 2 は RAID 1+0 と同じです。

: Y 台のディスクによる ''far X'' レイアウトはストライプによる読み取り性能を複製されたアレイで発揮します。ディスクをフロントとバックに分けて、ディスク1のフロントはディスク2のバックに複製され、ディスク2のフロントはディスク1のバックに複製されます。RAID 0 や RAID 5 と同じように、シーケンシャルリードを高速化することが可能です。欠点としては複製を保存するのにディスクがシークする距離が長くなるためシーケンシャルライトが遅くなります。それでも、読み込み速度が重要で可用性・冗長性が必要な場合は RAID 1+0 や RAID 5 よりも far 2 レイアウトの RAID 10 を使うことを推奨します。ただしバックアップを置き換えることはできません。

=== RAID レベルの比較 ===
{| class="wikitable"
! RAID レベル!!データの冗長性!!物理ドライブの利用効率!!読込パフォーマンス!!書込パフォーマンス!!最小ドライブ数
|-
| '''0'''||{{No}}||100%||nX '''最速'''||nX '''最速'''||2
|-
| '''1'''||{{Yes}}||50%||nX (理論値) 1X (実測値)||1X||2
|-
| '''5'''||{{Yes}}||67% - 94%||(n−1)X '''高速'''||(n−1)X '''高速'''
||3
|-
| '''6'''||{{Yes}}||50% - 88%||(n−2)X||(n−2)X||4
|-
| '''10''' (far2) ||{{Yes}}||50%||nX '''最速''' (RAID 0 と同等)||(n/2)X||2
|-
| '''10''' (near2) ||{{Yes}}||50%||nX (理論値) 1X (実測値)||(n/2)X||2
|}
<nowiki>*</nowiki> ''n'' は利用するディスクの数。

== 実装 ==
RAID デバイスの制御方法は様々です:

; ソフトウェア RAID
: 不明瞭なプロプライエタリのファームウェアや使用するソフトウェアに依存しないため楽な実装方法です。アレイはオペレーティングシステムによって以下のいずれかで管理されます:
:* 抽象レイヤー (例: [[#セットアップ|mdadm]])。 {{Note|このガイドで使用する方法です。}}
:* 論理ボリュームマネージャ (例: [[LVM]])。
:* ファイルシステムのコンポーネント (例: [[ZFS]], [[Btrfs]])。

; ハードウェア RAID
: PC に取り付けた専用のハードウェアカードにディスクを直接接続してアレイをダイレクトに制御します。[[Wikipedia:ja:CPU|ホストプロセッサ (CPU)]] とは独立したオンボードのプロセッサ上で RAID が処理されます。この方法はオペレーティングシステムから独立していますが、ハードウェア RAID コントローラを正しく作動させるためにはドライバーが必要になります。RAID アレイの設定は、メーカーによって、オプション ROM インターフェイスを使ったり、OS をインストールする際に専用のアプリケーションを使って行います。この設定は Linux からは見ることができません、システムには単一のディスクとして認識されます。

; [[Fake RAID でインストール|FakeRAID]]
: このタイプのRAIDは正しくは BIOS またはオンボード RAID と呼ぶべきですが、ハードウェア RAID として偽って喧伝されています。アレイの管理はオプション ROM やファームウェアと ([[UEFI]] の場合) ファームウェアで RAID ロジックが実装される擬似的な RAID コントローラが行いますが、''全ての'' RAID 機能が実装された完全な RAID コントローラではありません。そのため、このタイプの RAID は FakeRAID と呼称されることがあります。FakeRAID のコントローラは[[公式リポジトリ]]の {{Pkg|dmraid}} を使って扱います。FakeRAID コントローラの例: [[Wikipedia:Intel Rapid Storage Technology|Intel Rapid Storage]], JMicron JMB36x RAID ROM, AMD RAID, ASMedia 106x, NVIDIA MediaShield など。

===使用している RAID はどのタイプか？===

ソフトウェア RAID の実装はユーザーによるため、ソフトウェア RAID を使ってることは簡単にわかります。

反対に、FakeRAID と真のハードウェア RAID を見分けるのは難しいかもしれません。上記の通り、しばしばメーカーはこれら二つの RAID タイプを誤って区別していることがあり、不当表示も考えられます。この場合、一番良い方法は {{ic|lspci}} コマンドを実行して出力を見て RAID コントローラを調べることです。それからその RAID コントローラに関する情報がないか検索してみてください。完全なハードウェア RAID コントローラは多くの場合やや高価 (~$400+) であり、システムをカスタマイズする際、ハードウェア RAID 構成を選択するとコンピュータの価格にそれと分かるくらいの変化があるはずです。

==セットアップ==
[[公式リポジトリ]]から {{Pkg|mdadm}} をインストールして下さい。''mdadm'' は普通のブロックデバイスを使って純粋なソフトウェア RAID を組むのに使われます: 元となるハードウェアは RAID ロジックを全く搭載せず、ディスクだけ供給します。''mdadm'' はどんな組み合わせのブロックデバイスでも使うことができます。あまり一般的でない組み合わせであってもです。例えば、サムドライブを集めて RAID アレイを作成することが可能です。

===デバイスの準備===
{{Warning|このステップではデバイス上の全てのデータを消去します、消去を行うデバイスを間違えないように気をつけて入力して下さい。}}

問題が発生しないように RAID の各デバイスで中身を[[ディスクの完全消去|完全に消去]]したほうが良いでしょう。デバイスを既存のアレイから再利用する場合、古い RAID 設定情報を全て削除して下さい:
# mdadm --zero-superblock /dev/<drive>

もしくはドライブの特定パーティションを削除する場合は:
# mdadm --zero-superblock /dev/<partition>

{{Note|パーティションのスーパーブロックを消去してもディスク上の他のパーティションに影響を与えることはありません。}}

===パーティションテーブルの作成===
アレイで使用する前にディスクをパーティションすることが強く推奨されます。ほとんどの RAID ユーザーは 2 TB 以上の HDD を選択するため、GPT パーティションテーブルが必須または推奨です。{{Pkg|gptfdisk}} を使うことでディスクを簡単にパーティションすることができます。

* 作成後、パーティションのタイプにはヘックスコード FD00 を指定してください。
* 巨大なディスクアレイを用いる場合、ディスクを後で区別しやすくするために[[永続的なブロックデバイスの命名#by-label|ディスクラベル]]や[[永続的なブロックデバイスの命名#by-partlabel|パーティションラベル]]を付けるようにしてください。
* 各デバイスに作成するパーティションのサイズは同じ大きさにすることを推奨します。
* パーティションするときはデバイスの末端に 100 MB の空きスペースを残すと良いでしょう。根拠は下を見て下さい。

{{Note|(パーティションを作らずに) 生のディスク上に直接 RAID を作成することも可能ですが、故障したディスクを交換するときに問題が起こることがあるのであまり推奨されません。}}

RAID の故障したディスクを置き換える時は、新しいディスクの容量は故障したディスクのサイズと全く同じまたはそれ以上でなくてはなりません - そうでないとアレイの再作成プロセスが作動しません。同じメーカーの同じモデルのハードドライブだとしても容量には多少の誤差があることがあります。ディスクの最後に未使用のスペースを残しておくことでドライブ間の容量の違いを埋め合わせることができ、また、ドライブの機種を置き換えることが楽になります。従って、'''ディスクの最後に未割り当て領域を 100 MB 残しておくことはグッドプラクティスと言えます'''。

====MBR を使う場合のパーティションタイプ====
MBR パーティションテーブルの HDD にパーティションを作成する場合、使用するパーティションタイプは以下になります:

* 0xDA (ファイルシステム以外のデータ用 -- 現在 [https://raid.wiki.kernel.org/index.php/Partition_Types kernel.org] によって推奨されています)
* 0xFD (raid の自動検出アレイ -- initrd を起動してカーネルモジュールをロードするようになるまでは使われていました)

===アレイの作成===
{{Warning|現在、カーネルのバージョン 4.2.x と 4.3.x には RAID10 アレイを作成できないというバグが存在します。RAID10 レイアウトを作る必要がある場合は、バグが修正されるまで、{{pkg|linux-lts}} のカーネルバージョン 4.1.x シリーズを使うことが推奨されます。詳しくは [[#参照]] セクションを見て下さい。}}

{{ic|mdadm}} を使ってアレイを作成します。以下では複数の例をあげています。
{{Warning|下のサンプルをコピーペーストするだけですませないでください。頭を使って適切なオプション・ドライブ文字に置き換えましょう。}}

{{Note|RAID1 アレイを [[Syslinux]] から起動する場合 syslinux v4.07 の制限として metadata の値をデフォルトの 1.2 ではなく 1.0 にする必要があります。}}

以下の例では2つのデバイスによる RAID1 アレイを作成します:
# mdadm --create --verbose --level=1 --metadata=1.2 --chunk=64 --raid-devices=2 /dev/md0 /dev/sdb1 /dev/sdc1
{{Note|実際には RAID1 では chunk スイッチは必要ありません。}}

以下の例では4つのデバイスによる RAID5 アレイを作成します:
# mdadm --create --verbose --level=5 --metadata=1.2 --chunk=256 --raid-devices=4 /dev/md0 /dev/sdb1 /dev/sdc1 /dev/sdd1 /dev/sde1 --spare-devices=1 /dev/sdf1

以下の例では2つのデバイスによる RAID10 (far2) アレイを作成します:

# mdadm --create --verbose --level=10 --metadata=1.2 --chunk=512 --raid-devices=2 --layout=f2 /dev/md0 /dev/sdb1 /dev/sdc1

{{Tip|{{ic|--homehost}} と {{ic|--name}} オプションを使うことで raid デバイスにカスタム名称を付けることができます。名前はコロンで区切られます。}}

アレイは仮想デバイス {{ic|/dev/mdX}} 下に作成され、編成されて (縮退モードで) 使用できるようになります。バックグラウンドで mdadm がアレイをリシンクしている間、仮想デバイスを使って直接起動することが可能です。パリティのリストアには長い時間かかるかもしれません。次のコマンドで進捗を確認できます:
$ cat /proc/mdstat

===設定ファイルの更新===

新しい RAID アレイを作成した後は、デフォルトの設定ファイルである {{ic|mdadm.conf}} を以下のようにして更新する必要があります:
# mdadm --detail --scan >> /etc/mdadm.conf

このコマンドを実行したらテキストファイルで {{ic|mdadm.conf}} 設定ファイルをチェックして中身が問題ないか確認してください。

===アレイの構築===

設定ファイルを更新できたら mdadm を使ってアレイを構築することができます:

# mdadm --assemble --scan

===RAID ファイルシステムのフォーマット===
アレイは他のディスクと同じようにフォーマットすることができます、覚えておくべきことは:
* ボリュームサイズが巨大になるため適合しないファイルシステムが存在します (参照: [[Wikipedia:Comparison of file systems#Limits|ファイルシステムの制限]])。
* オンラインでのサイズの拡大や縮小に対応しているファイルシステムがふさわしいでしょう (参照: [[Wikipedia:Comparison of file systems#Features|ファイルシステムの機能]])。
* パフォーマンスを最適化するために適切なストライドとストライプ幅を計算するべきです。

==== ストライドとストライプ幅の計算 ====

まずはストライドを計算してください:

ストライド = (チャンクサイズ / ブロックサイズ)

最適なストライドを計算するために、以下に注意してください:
* Arch では大抵のファイルシステムのデフォルトブロックサイズは 4096 (4 KiB) です。詳しくは {{ic|/etc/mke2fs.conf}} を見て下さい。
* ''チャンクサイズ''はユーザーが指定することができる 4K (1ブロック: [[Advanced Format]] ディスクでない場合は512バイト) から 64K まで、あるいはそれ以上の値です。{{ic|mdadm}} のデフォルトで選択されるチャンクサイズは 512 KiB です ({{ic|<nowiki># mdadm --detail /dev/mdX | grep 'Chunk Size'</nowiki>}} で確認できます)。巨大なファイルを日常的に使用する場合 (ビデオ編集やグラフィック処理など)、チャンクサイズを小さくすることで巨大なファイルのアクセス速度を向上させることができます。

{{Tip|最適なチャンクサイズについては [http://www.zdnet.com/article/chunks-the-hidden-key-to-raid-performance/ Chunks: the hidden key to RAID performance] を参照してください。}}

次に、ストライプ幅を計算してください:

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)

===== 例 1. RAID0 =====
適切なストライプ幅とストライドで ext4 にフォーマットする例:
* 仮に2つの物理ディスクで構成される RAID0 アレイとします。
* チャンクサイズは 64k。
* ブロックサイズは 4k。

ストライド = (チャンクサイズ / ブロックサイズ)。この例では、(64/4) となりストライド = 16です。

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)。この例では、(2*16) となりストライプ幅 = 32です。

# mkfs.ext4 -v -L myarray -m 0.5 -b 4096 -E stride=16,stripe-width=32 /dev/md0

===== 例 2. RAID5 =====
適切なストライプ幅とストライドで ext4 にフォーマットする例:
* 仮に4つの物理ディスクで構成される RAID5 アレイとします。3つはデータディスクで1つはパリティディスクです。
* チャンクサイズは 256k。
* ブロックサイズは 4k。

ストライド = (チャンクサイズ / ブロックサイズ)。この例では、(256/4) となりストライド = 64です。

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)。この例では、(3*64) となりストライプ幅 = 192です。

# mkfs.ext4 -v -L myarray -m 0.5 -b 4096 -E stride=64,stripe-width=192 /dev/md0

===== 例 3. RAID10 (far2) =====
適切なストライプ幅とストライドで ext4 にフォーマットする例:
* 仮に2つの物理ディスクで構成される RAID10 アレイとします。far2 レイアウトの RAID10 なので当然、2つともデータディスクになります。
* チャンクサイズは 512k。
* ブロックサイズは 4k。

ストライド = (チャンクサイズ / ブロックサイズ)。この例では、(512/4) となりストライド = 128です。

ストライプ幅 = (物理'''データ'''ディスクの数 * ストライド)。この例では、(2*128) となりストライプ幅 = 256です。

# mkfs.ext4 -v -L myarray -m 0.01 -b 4096 -E stride=128,stripe-width=256 /dev/md0

== ライブ CD からマウント ==
ライブ CD から RAID パーティションをマウントしたい場合、次のコマンドを使います:
# mdadm --assemble /dev/<disk1> /dev/<disk2> /dev/<disk3> /dev/<disk4>

ディスクアレイが存在しないのに誤って RAID 1 と認識されて ({{ic|mdadm --detail /dev/md<number>}})、inactive と報告される場合 ({{ic|cat /proc/mdstat}})、先にアレイを停止してください:
# mdadm --stop /dev/md<number>

== RAID に Arch Linux をインストール ==
{{Note|以下のセクションは root ファイルシステムがアレイ上にある場合にのみ当てはまります。データパーティションをアレイに収納する場合はこのセクションをスキップしてかまいません。}}
インストール手順の[[パーティショニング]]と[[ファイルシステム#デバイスのフォーマット|フォーマット]]の間に RAID アレイを作成してください。root ファイルシステムにするパーティションを直接フォーマットする代わりに、RAID アレイの上に作成します。[[#セットアップ|セットアップ]]セクションの指示に従って RAID アレイを作成してください。その後はインストールの手順に従って pacstrap のステップが完了するところまで進みます。[[Unified Extensible Firmware Interface|UEFI]] で起動する場合、[[EFI システムパーティション#RAID 上に ESP を配置]]も読んでください。

=== 設定ファイルの更新 ===
{{Note|以下は chroot の外で実行します、そしてファイルパスには /mnt を前に付けます。}}
ベースシステムをインストールしたら、デフォルトの設定ファイル {{ic|mdadm.conf}} を次のようにして更新する必要があります:
# mdadm --detail --scan >> /mnt/etc/mdadm.conf

上のコマンドを実行した後は、かならずテキストエディタを使って mdadm.conf 設定ファイルをチェックして中身が問題ないか確認してください。

{{Note|起動時に (デフォルトで有効になる) ''mdmonitor'' が失敗しないようにするには、{{ic|mdadm.conf}} の一番下にある '''MAILADDR''' をアンコメントして、アレイに問題が起こった時に通知が行くメールアドレスかアプリケーションを記述してください。}}

インストールの手順に戻って “Initial ramdisk 環境の作成” のステップまで進んだら、次のセクションを見て下さい。

=== mdadm フックを mkinitcpio.conf に追加する ===
{{Note|以下は chroot 中に実行します。}}
init イメージに直接 mdadm のサポートを追加するために [[mkinitcpio]] の [[Mkinitcpio#HOOKS|HOOKS]] セクションに {{ic|mdadm_udev}} を追加してください:
HOOKS="base udev autodetect block '''mdadm_udev''' filesystems usbinput fsck"

HOOKS に変更を加えた後は initramfs イメージを再生成します ([[Mkinitcpio#イメージ作成とアクティベーション|イメージ作成とアクティベーション]]を参照):
# mkinitcpio -p linux

=== ブートローダーの設定 ===

RAID アレイごとに {{ic|md}} [[カーネルパラメータ]]を追加してください。また、{{ic|root}} パラメータでマッピングするデバイスを正しく指定します。以下の例では三つの RAID 1 アレイを記述しており適当な一つを root として設定しています:
root=/dev/md1 md=0,/dev/sda2,/dev/sdb2 md=1,/dev/sda3,/dev/sdb3 md=2,/dev/sda4,/dev/sdb4

上記のカーネルデバイスノードによる方法だとソフトウェア raid パーティションからの起動が失敗する場合、もうひとつの信頼性のある方法としてパーティションラベルを使う方法があります:
root=LABEL=Root_Label

[[GRUB#RAID]] も参照してください。

== RAID のメンテナンス ==
=== スクラビング ===
誤りをチェック・修正するために定期的にデータ[[wikipedia:Data_scrubbing|スクラビング]]を実行するのは良い習慣です。アレイのサイズや設定にもよりますが、スクラブは完了するまでかなり時間がかかります。

データスクラブを開始するには:
# echo check > /sys/block/md0/md/sync_action

check オペレーションは不良セクタがないかドライブをスキャンして自動的に不良セクタを修復します。不良データ (他のディスクが示すデータと一致しないセクタのデータ、例えば、パリティブロックと他のデータブロックによって該当するデータブロックが不正だと判断される場合など) を含んでいる良好セクタを見つけた場合、対処は何もされませんが、イベントが記録されます (下を参照)。"何もされない"ことで、管理者はセクタのデータと、重複するデータからセクタを再生成することで得られるデータを検査して正しいデータを選んで保持することができます。

mdadm に関連する様々なタスクやアイテムと同様に、スクラブの状態は {{ic|/proc/mdstat}} を読み出すことで調べることができます。

例:
{{hc|$ cat /proc/mdstat|<nowiki>
Personalities : [raid6] [raid5] [raid4] [raid1]
md0 : active raid1 sdb1[0] sdc1[1]
3906778112 blocks super 1.2 [2/2] [UU]
[>....................] check = 4.0% (158288320/3906778112) finish=386.5min speed=161604K/sec
bitmap: 0/30 pages [0KB], 65536KB chunk
</nowiki>}}

実行中のデータスクラブを安全に停止するには:
# echo idle > /sys/block/md0/md/sync_action

{{Note|スクラブを途中で中止した後にシステムを再起動してしまうと、スクラブはもういちど最初からやり直されます。}}

スクラブが完了したら、(不良セクタがあった場合) いくつのブロックが不良として判断されたか確認することができます:
# cat /sys/block/md0/md/mismatch_cnt

==== スクラビングの一般的な注意事項 ====
{{Note|ユーザーは /sys/block/md0/md/sync_action に '''repair''' を echo することもできますが、データにミスマッチが発生したとき、一貫性のために自動的に更新が行われるため、推奨されません。正しいパリティまたはデータブロックなのか (RAID1 の場合どちらのデータブロックなのか) 判断することができないのが危険です。この操作によって間違ったデータではなく正しいデータが選択されるかどうかは一か八かです。}}

定期的にスクラブを root で実行する cron ジョブを設定するのは良い考えです。ジョブの設定に役立つ {{AUR|raid-check}} を見て下さい。cron の代わりに systemd タイマーを使ってスクラブを実行したい場合は {{AUR|raid-check-systemd}} をインストールしてください。systemd タイマーのユニットファイルとスクリプトが含まれています。

==== スクラビングの RAID1 と RAID10 の注意事項 ====
カーネルにおける RAID1 と RAID10 の書き込みはバッファがないため、アレイが問題ないときでもアレイにゼロ以外のミスマッチがカウントされることがあります。このようなゼロ以外のカウントは一時的なデータ領域にしか存在せず、問題は起こりません。しかしながら、一時的なデータのゼロ以外のカウントと実際に問題が起こっていることを示すゼロ以外のカウントを見分けることはできません。このために RAID1 や RAID10 アレイでは誤検知が発生することがあります。それでもデバイスにあるかもしれない不良セクタを見つけて直すために定期的にスクラブすることを推奨します。

===アレイからデバイスを削除する===
アレイからデバイスを削除する際は削除する前にそのデバイスが壊れているとマークを付けます:
# mdadm --fail /dev/md0 /dev/sdxx

そしてアレイからデバイスを削除します:
# mdadm -r /dev/md0 /dev/sdxx

ドライブを完全に削除するときは (例えば、今後別の方法で使用する) 上記の2つのコマンドを実行した後に:

# mdadm --zero-superblock /dev/sdxx

{{Warning|
* 上記のコマンドを RAID0 アレイで実行してはいけません。データが消失してしまいます。
* 削除したディスクのスーパーブロックを消去せずに再利用した場合、再起動時に全てのデータが消失します。}}

アレイの使用を停止:
# 対象のアレイをアンマウント
# 次のコマンドでアレイを停止: {{ic|mdadm --stop /dev/md0}}
# セクションの最初に書かれている3つのコマンドを各デバイスで繰り返し実行。
# {{ic|/etc/mdadm.conf}} から対応する行を削除

=== アレイに新しいデバイスを追加する ===
デバイスがマウントされている動作中のシステム上で mdadm を使って新しいデバイスを追加することができます。上述しているように既存のアレイの一つとして同じレイアウトを使って新しいデバイスをパーティションしてください。

RAID アレイを構築していない場合は構築します:
# mdadm --assemble /dev/md0 /dev/sda1 /dev/sdb1

アレイに新しいデバイスを追加:
# mdadm --add /dev/md0 /dev/sdc1

mdadm がデバイスを追加するのにはあまり時間はかかりません。進捗を確認するには:
# cat /proc/mdstat

デバイスが追加されたかは次のコマンドで確認:
# mdadm --misc --detail /dev/md0

==== RAID0 アレイの場合 ====

以下のようなエラーが表示された場合:
mdadm: add new device failed for /dev/sdc1 as 2: Invalid argument

これはおそらく RAID0 を使っていることが原因です。上のコマンドは新しいディスクを"スペア"として追加しますが、RAID0 にはスペアは存在しません。RAID0 アレイにデバイスを追加したいときは、一つのコマンドで "grow" して "add" する必要があります:
# mdadm --grow /dev/md0 --raid-devices=3 --add /dev/sdc1

=== RAID ボリュームのサイズを増やす ===

RAID アレイに巨大なディスクを追加した場合やパーティションサイズを増やした場合、RAID ボリュームのサイズを増加させて空き領域を埋めると良いでしょう。まずは上のセクションに従って RAID ボリュームを再構築してください。再構築が完了したら領域を埋めるように拡張してください:
# mdadm --grow /dev/md0 --size=max
そして RAID ボリューム {{ic|/dev/md0}} に存在するパーティションのサイズを変更してください。詳しくは[[パーティショニング]]を参照。最後に、パーティション内のファイルシステムをリサイズしてください。{{ic|gparted}} でパーティショニングした場合、自動的にリサイズされます。他のツールを使った場合、パーティションをアンマウントして手動でファイルシステムをリサイズしてください:
{{bc|
# umount /storage
# fsck.ext4 -f /dev/md0p1
# resize2fs /dev/md0p1
}}

=== 同期速度の制限を変更 ===

同期には時間がかかります。マシンで他の作業をしていない場合、速度制限を上げることが可能です。

{{hc|# cat /proc/mdstat|<nowiki>
Personalities : [raid1]
md0 : active raid1 sda3[2] sdb3[1]
155042219 blocks super 1.2 [2/1] [_U]
[>....................] recovery = 0.0% (77696/155042219) finish=265.8min speed=9712K/sec

unused devices: <none>
</nowiki>}}

現在の制限速度を確認:

{{hc|# cat /proc/sys/dev/raid/speed_limit_min|
1000
}}
{{hc|# cat /proc/sys/dev/raid/speed_limit_max|
200000
}}

制限を上げる:

# echo 400000 >/proc/sys/dev/raid/speed_limit_min
# echo 400000 >/proc/sys/dev/raid/speed_limit_max

上記の設定後、同期速度と予想完了時間を確認してみてください:

{{hc|# cat /proc/mdstat|<nowiki>
Personalities : [raid1]
md0 : active raid1 sda3[2] sdb3[1]
155042219 blocks super 1.2 [2/1] [_U]
[>....................] recovery = 1.3% (2136640/155042219) finish=158.2min speed=16102K/sec

unused devices: <none>
</nowiki>}}

[[sysctl#MDADM]] も参照してください。

== 監視 ==
RAID デバイスの状態を出力するシンプルなワンライナー:
{{hc|awk '/^md/ {printf "%s: ", $1}; /blocks/ {print $NF}' </proc/mdstat
|md1: [UU]
md0: [UU]
}}

===Watch mdstat===
{{bc|watch -t 'cat /proc/mdstat'}}
または {{pkg|tmux}} を使う場合:
{{bc|tmux split-window -l 12 "watch -t 'cat /proc/mdstat'"}}

===iotop で IO を追跡===
{{pkg|iotop}} パッケージはプロセスの入出力の統計を表示します。次のコマンドを使って raid スレッドの IO を表示することができます。

{{bc|<nowiki>iotop -a -p $(sed 's, , -p ,g' <<<`pgrep "_raid|_resync|jbd2"`)</nowiki>}}

===iostat で IO を追跡 ===

{{Pkg|sysstat}} パッケージに入っている ''iostat'' ユーティリティはデバイスやパーティションの入出力の統計を表示します。

iostat -dmy 1 /dev/md0
iostat -dmy 1 # all

===イベントでメールを送信===
smtp メールサーバー (sendmail) かメールフォワーダ (ssmtp/msmtp) が必要です。おそらく一番シンプルな方法は {{AUR|dma}} を使うことです。とても小さく (インストール容量 0.08 MiB) でセットアップがいりません。

{{ic|/etc/mdadm.conf}} を編集して通知を受信するメールアドレスを指定します。
{{Note|上記のとおり dma を使用する場合、外部のメールアドレスではなくローカルホストのユーザー名に直接メールを送ることができます。}}

設定をテストするには:
# mdadm --monitor --scan --oneshot --test

[[mdadm]] には監視作業を行う systemd サービス (mdmonitor.service) が含まれているため、ここで、やるべきことはもうありません。{{ic|/etc/mdadm.conf}} でメールアドレスを設定していないと、サービスは失敗します。mdadm イベントでメールを受けとりたくない場合は、サービスの失敗は無視してかまいません。通知を表示したくなく、失敗メッセージが気になるならば、ユニットをマスクしてください。

==== その他の方法 ====

smtp メールサーバーやメールフォワーダをインストールする代わりに、既存の [[S-nail]] ツールを使うこともできます (忘れずにセットアップしてください)。

以下の内容で {{ic|/etc/mdadm_warning.sh}} という名前のファイルを作成:

#!/bin/bash
event=$1
device=$2

echo " " | /usr/bin/mailx -s "$event on $device" '''destination@email.com'''

実行権限を与えます: {{ic|chmod +x /etc/mdadm_warning.sh}}

それから {{ic|mdadm.conf}} にこのファイルを追加してください:

PROGRAM /etc/mdadm_warning.sh

前記の方法と同じ方法でテスト・有効化します。

==トラブルシューティング==
再起動した時に "invalid raid superblock magic" というエラーが表示される場合、ハードドライブを追加したときは、ハードドライブの順番が正しいか確認してください。インストール時の RAID デバイスは hdd, hde, hdf だったとしても起動時には hda, hdb, hdc になっているかもしれません。カーネルラインをそれにあわせて修正してください。

===エラー: "kernel: ataX.00: revalidation failed"===
突然 (再起動後または BIOS の設定を変更した後) 以下のようなエラーメッセージが表示された場合:

Feb 9 08:15:46 hostserver kernel: ata8.00: revalidation failed (errno=-5)

これは必ずしもドライブが壊れたことを意味しているわけはありません。要するに、まだあわてるような時間じゃありません。BIOS やカーネルパラメータで APIC または ACPI 設定を変更した場合、設定を戻せば問題ないはずです。大抵は、ACPI をオフにすれば直ります。

===読み取り専用でアレイを起動===
md アレイが起動すると、スーパーブロックが書き出され、resync が走ることがあります。読み取り専用で起動するにはカーネルモジュール {{ic|md_mod}} のパラメータ {{ic|start_ro}} を設定します。これが設定されている場合、新しいアレイは 'auto-ro' モードになり、内部 io (スーパーブロックの更新, resync, recovery) が全て無効化されて、書き込みリクエストが来た時に初めて 'rw' に自動的に切り替わります。

{{Note|最初の書き込みリクエストがある前に {{ic|mdadm --readonly}} を使うことでアレイを完全な 'ro' モードに設定できます。また、{{ic|mdadm --readwrite}} で書き込みを行わないで再同期を開始できます。}}

起動時にパラメータを設定するには、カーネル行に {{ic|<nowiki>md_mod.start_ro=1</nowiki>}} を追加してください。

もしくはモジュールのロード時に {{ic|/etc/modprobe.d/}} ファイルや {{ic|/sys/}} から直接設定します。
{{bc|echo 1 > /sys/module/md_mod/parameters/start_ro}}

===raid の故障したまたは存在しないドライブからリカバリする===
何らかの理由でドライブの一つが壊れた時も上述のエラーが表示されることがあります。その場合、ディスクが一つ足りない状態でも raid がオンになるようにしなくてはなりません。次のコマンドを入力 (必要に応じて変更してください):
# mdadm --manage /dev/md0 --run

これで次のようにしてまたマウントできるようになったはずです (fstab で記述している場合):
# mount /dev/md0

raid がまた動作するようになって使えるようにはなりましたが、ディスクが一つ不足しています。ディスクを追加するために[[#デバイスの準備|デバイスの準備]]で記述しているようにしてパーティションしてください。パーティションしたら次のコマンドで raid に新しいディスクを追加できます:
# mdadm --manage --add /dev/md0 /dev/sdd1

次を入力すれば:
# cat /proc/mdstat
raid が有効になって再構築されたことが確認できるでしょう。

設定を更新しても良いかもしれません (参照: [[#設定ファイルの更新|設定ファイルの更新]])。

== ベンチマーク ==
RAID をベンチマークするツールは複数存在します。同じ RAID ボリュームからマルチスレッドで読み取るときの速度向上が一番の改善点になります。

{{AUR|tiobench}}{{Broken package link|パッケージが存在しません}} はフルスレッドによるディスク I/O を計測することでパフォーマンスがどれくらい向上したかベンチマークします。

{{Pkg|bonnie++}} はひとつまたは複数のファイルへのデータベースタイプのアクセスをテストしたり、小さなファイルを作成・読込・削除することで Squid や INN、または Maildir フォーマットのメールなどといったプログラムの使用をシミュレートします。同梱されている [http://www.coker.com.au/bonnie++/zcav/ ZCAV] プログラムはディスクに書き込みを行わずにハードドライブの領域のパフォーマンスをテストします。

{{ic|hdparm}} を RAID のベンチマークに使っては'''いけません'''、出てくる結果には全く一貫性がありません。

== 参照 ==
* Linux カーネルアーカイブの [http://raid.wiki.kernel.org/index.php/Linux_Raid Linux RAID wiki エントリ]
* [https://raid.wiki.kernel.org/index.php/Write-intent_bitmap How Bitmaps Work]
* Red Hat Enterprise Linux 6 ドキュメントの [https://access.redhat.com/documentation/ja-JP/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/ch-raid.html 第17章: Redundant Array of Independent Disks (RAID)]
* [http://tldp.org/FAQ/Linux-RAID-FAQ/x37.html Linux-RAID FAQ] on the Linux Documentation Project
* [http://support.dell.com/support/topics/global.aspx/support/entvideos/raid?c=us&l=en&s=gen Dell.com Raid Tutorial] - Interactive Walkthrough of Raid
* [http://www.miracleas.com/BAARF/ BAARF] including ''[http://www.miracleas.com/BAARF/RAID5_versus_RAID10.txt Why should I not use RAID 5?]'' by Art S. Kagel
* [http://www.linux-mag.com/id/7924/ Introduction to RAID], [http://www.linux-mag.com/id/7931/ Nested-RAID: RAID-5 and RAID-6 Based Configurations], [http://www.linux-mag.com/id/7928/ Intro to Nested-RAID: RAID-01 and RAID-10], and [http://www.linux-mag.com/id/7932/ Nested-RAID: The Triple Lindy] in Linux Magazine
* [http://www.cyberciti.biz/tips/linux-raid-increase-resync-rebuild-speed.html HowTo: Speed Up Linux Software Raid Building And Re-syncing]
* [http://fomori.org/blog/?p=94 RAID5-Server to hold all your data]

'''既知のバグ'''
* [http://marc.info/?l=linux-raid&m=144960710718870&w=2 linux-raid ML #1]
* [http://marc.info/?l=linux-raid&m=144830809503689&w=2 linux-raid ML #2]

'''mdadm'''
* [http://anonscm.debian.org/gitweb/?p=pkg-mdadm/mdadm.git;a=blob_plain;f=debian/FAQ;hb=HEAD Debian mdadm FAQ]
* [https://www.kernel.org/pub/linux/utils/raid/mdadm/ mdadm ソースコード]
* [http://www.linux-mag.com/id/7939/ Software RAID on Linux with mdadm] in Linux Magazine

'''フォーラムスレッド'''
* [http://forums.overclockers.com.au/showthread.php?t=865333 Raid Performance Improvements with bitmaps]
* [https://bbs.archlinux.org/viewtopic.php?id=125445 GRUB and GRUB2]
* [https://bbs.archlinux.org/viewtopic.php?id=123698 Can't install grub2 on software RAID]
* [https://forums.gentoo.org/viewtopic-t-888624-start-0.html Use RAID metadata 1.2 in boot and root partition]

'''RAID と暗号化'''
* [http://www.shimari.com/dm-crypt-on-raid/ Linux/Fedora: Encrypt /home and swap over RAID with dm-crypt] by Justin Wells

Systemd-homed

2022-02-26T13:19:45Z

Shota: /* homectl */ systemd-homed が管理する UID 範囲を修正

{{lowercase title}}
[[Category:セキュリティ]]
[[en:Systemd-homed]]
[[pt:Systemd-homed]]
{{Related articles start}}
{{Related|ユーザーとグループ}}
{{Related|fscrypt}}
{{Related|セキュリティ}}
{{Related|PAM}}
{{Related articles end}}

{{man|8|systemd-homed}} は現在のシステム構成に依存しないポータブルなユーザーアカウントを提供する [[systemd]] サービスです。

ポータビリティを実現するために、systemd-homed は全てのユーザー関連情報をストレージメディアに移動して、可能であれば暗号化を行い、ユーザーに関する署名済み情報 (パスワードやユーザーが属するグループ、UID/GID、その他 {{ic|/}} に散在する情報) を含む {{ic|~/.identity}} ファイルを作成します。

ポータブルなホームディレクトリを可能にするだけではなく、ログイン時に {{ic|/home}} を暗号化しシステムの停止時にフォルダに施錠するという管理を自動化することでセキュリティも確保されます。

== インストール ==

''systemd-homed'' は {{Pkg|systemd}} に含まれています。{{ic|systemd-homed.service}} を[[起動]]・[[有効化]]してください。また、{{Pkg|pambase}} のバージョン 20200721.1-2 以降には、systemd-homed のユーザーセッションで必要となる [[PAM#設定 | PAMの設定]] が付属しています。

== ユーティリティ ==

=== homectl ===

homectl を使うことでユーザーを作成・更新・調査して、ホームディレクトリと {{man|8|systemd-homed}} サービスで管理される {{ic|~/.identity}} を作成することができます。

[https://systemd.io/UIDS-GIDS/ 60001–60513 の範囲で]空きの UID を使用して、'username' という名前のユーザーを作成 (同じ名前のグループを作成して GID と UID を同じにして ''username'' をグループのメンバーに設定し、デフォルトシェルを {{ic|/bin/bash}} に設定):

# homectl create username

上記のコマンドでホームディレクトリのマウントポイントは {{ic|/home/''username''}} に設定されます。ストレージ方式は次の順番で選択されます:

# {{ic|luks}}: LUKS がサポートされている場合。
# {{ic|サブボリューム}}: LUKS がサポートされておらず、サブボリュームはサポートされている場合。
# {{ic|ディレクトリ}}: 上のいずれもサポートされておらず他のマニュアルのオプションでも指定されていない場合。

'''LUKS''' のイメージパスは {{ic|/home/''username''.home}} に、'''ディレクトリ'''のディレクトリパスは {{ic|/home/''username''.homedir}} に設定されます。

{{Note| '''homectl''' は systemd-homedが管理し該当する名前とユーザーの ID 以外には、グループの作成・削除を管理しません。古典的なツールを使ってください。}}

{{Warning|{{ic|~/.identity}} ファイルは署名されるためテキストエディタを使って直接編集してはありません。署名が破壊され不正なファイルとなってしまいます。編集するときは {{ic|1=homectl update --identity=/path/to/.identity}} を使ってください。}}

=== userdbctl ===

古典的な UNIX によるユーザー管理と [[systemd-homed]] によるユーザー管理、両方によるユーザー・グループ・グループ属性を調査するための問い合わせツール。

== ストレージ方式 ==

=== [[LUKS]] ホームディレクトリ ===

ユーザーのホームディレクトリはループバックファイルあるいはリムーバルメディアの [[LUKS]] ボリューム内の Linux [[ファイルシステム]]に保存されます。この方式を使う際は {{ic|1=--storage=luks}} を '''homectl''' に指定してください。

リムーバルメディアを使う場合は以下の条件を満たす必要があります:

* イメージには GPT パーティションテーブルが必要です。現在のところ、そのパーティションひとつだけで、パーティションのタイプが {{ic|UUID 773f91ef-66d4-49b5-bd83-d683bf40ad16}} である必要があります。また、パーティションのラベルがユーザーの名前でなくてはなりません。

* パーティションには LUKS2 ボリュームが必要で、ラベルがユーザー名と一致している必要があります。LUKS2 ボリュームには systemd-homed タイプの LUKS2 トークンフィールドが必要です。このトークンの JSON データには base64 でエンコードされたデータを含むレコードフィールドが必要です。このデータは JSON のユーザーレコードであり、{{ic|~/.identity}} と同じようにシリアライゼーションされています。このトークンの JSON データには iv フィールドも必要で、暗号化のための base64 でエンコードされたバイナリ初期化ベクタを記述します。LUKS2 ボリュームが使用するのと同じ暗号化が使われ、同じボリュームキーで解錠されますが、自己の IV を使います。

* LUKS2 ボリュームの中は [[ext4]], [[btrfs]], [[XFS]] のいずれかの Linux ファイルシステムである必要があり、ファイルシステムのラベルはユーザー名でなければなりません。

* ファイルシステムにはユーザーと同じ名前のディレクトリが必要です。このディレクトリがログイン時にユーザーのホームディレクトリになります。他のストレージ方式と同じように {{ic|~/.identity}} ファイルにユーザーレコードのコピーを保持します。

=== [[fscrypt]] ディレクトリ ===

{{Tip|fscrypt をサポートしているファイルシステムには [[ext4]] や [[F2FS]] があります。}}
上記の方法と同じようにユーザーのホームディレクトリが保存されますが、ファイルシステムネイティブの暗号化が使われます。この方式を使う場合は {{ic|1=--storage=fscrypt}} を '''homectl''' に指定してください。

=== ディレクトリまたは [[btrfs]] サブボリューム ===

ユーザーのホームディレクトリは {{ic|/home/''username''.homedir}} に保存され、ログイン時にバインド[[マウント]]を使って {{ic|/home/''username''}} にマウントされます。この方式では暗号化は行われません。この方式を使う際は {{ic|1=--storage=directory}} または {{ic|1=--storage=subvolume}} を '''homectl''' に指定してください。

=== CIFS サーバー ===

この方式では、ホームディレクトリはログイン時に CIFS (''Common Internet File System'') サーバからマウントされます。この CIFS は [[Samba]] プロトコルによって実装されています。この方式を使う際は {{ic|1=--storage=cifs}} を'''homectl'''に指定して下さい。また、ローカルパスワードが CIFS サービスへのログイン情報としても使われます。

== ユーザーレコードの属性 ==

ユーザーレコードを見るには次のようにします:

# homectl inspect ''username''

また、変更、追加したい場合は次のようにします:

# homectl update ''username'' --''property''=''VALUE''

オプションの詳細は {{man|1|homectl}} を参照してください。

== ユーザー管理の例 ==

=== ユーザーの作成 ===

LUKS による暗号化を使ってユーザーを作成する:

# homectl create ''username'' --storage=luks

fscrypt を使ってユーザーを作成する (ただし、fscript が[[Fscrypt#ファイルシステム| ファイルシステムで有効化]] されているか気を付けてください):

# homectl create ''username'' --storage=fscrypt

UID とシェル、グループを指定してユーザーを作成する:

# homectl create ''username'' --shell=/bin/zsh --uid=60100 --member-of=wheel,adm,uucp

他のオプションは {{man|1|homectl|USER RECORD PROPERTIES}} を参照してください。

=== ユーザーの削除 ===
{{Warning|ユーザーの削除は即座に実行されます。注意してください。}}

複数のユーザーを同時に削除することができます。次のコマンドを実行することで 2 ユーザーが即座に削除されます:

# homectl remove ''username'' ''username2''

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

=== Forget key on suspend ===

{{Warning|Mistakes in [[PAM]] configuration can break the system authorization up to not being able to login even as ''root''. Backing up existing configuration files is recommended before making any changes.}}

The {{ic|suspend}} option can be used with {{ic|pam_systemd_home.so}} entries in the files in {{ic|/etc/pam.d/}} to enable forget key on suspend. No session manager at the moment supports this feature. Furthermore, TTY sessions do not support the reathentication mechanism. So, when session managers start supporting this feature, the suspend option should only be enabled for them. Read {{man|8|pam_systemd_home}} and the [http://www.linux-pam.org/Linux-PAM-html/Linux-PAM_SAG.html Linux-PAM System Administrators' Guide] for more details.

=== SSH remote unlocking ===

''systemd-homed'' encrypts your home directory using your password, so SSH configured for public key authentication cannot mount it or read {{ic|authorized_keys}}. A possible solution is to add authorized keys to your user record and require both public key and password for authentication. Add the following to {{ic|sshd_config}}:

AuthenticationMethods publickey,password
AuthorizedKeysCommand /usr/bin/userdbctl ssh-authorized-keys %u
AuthorizedKeysCommandUser root

Make sure that you have not disabled password authentication:

#PasswordAuthentication yes

Update your user record with your authorized keys using:

# homectl update ''username'' --ssh-authorized-keys=@/path/to/.ssh/authorized_keys

From now on, SSH will ask you to enter your password after completing key-based authentication. ''systemd-homed'' will use it to unlock and mount your home directory.

=== Mounting encrypted home directory for rescue ===

If you need to mount a ''systemd-homed''-encrypted directory from a rescue disk or another machine, you will need to decrypt the directory outside of the ''systemd-homed'' framework. You may wish to keep a text file or script of this solution from the [https://bbs.archlinux.org/viewtopic.php?id=258152 forums] on your rescue disk for emergencies:

# losetup -fP ''username''.home
# cryptsetup open /dev/''loopXpY'' ''mappername''
# mount /dev/mapper/''mappername'' ''/mnt/mountpoint''

where,

* {{ic|''username''.home}} is the file in the {{ic|/home}} directory with your username and the ''.home'' extension as its name
* {{ic|''loopXpY''}} is the device in the {{ic|/dev}} directory with the loop number of the loopback device created in the prior step and the partition number of the relevant partition, probably {{ic|/dev/loop0p1}}
* {{ic|''mappername''}} is whatever alias you decide to adopt for the mapped device, e.g. {{ic|user_oldhome}}
* {{ic|''/mnt/mountpoint''}} is wherever you want to mount your decrypted home directory

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

=== SDDM がユーザーをリストしない ===

こちらを参照してください: [[SDDM#ユーザーが greeter に表示されない]]。

== 参照 ==

* https://systemd.io/CONVERTING_TO_HOMED/
* https://systemd.io/HOME_DIRECTORY/

デスクトップ通知

2022-02-23T01:02:50Z

Shota: /* スタンドアロン */ 英語版を参照して項目を削除、追加

[[Category:X サーバー]]
[[Category:通知]]
[[Category:開発]]
[[Category:ソフトウェア一覧]]
[[en:Desktop notifications]]
[[es:Desktop notifications]]
[[ru:Desktop notifications]]
{{Related articles start}}
{{Related|GTK+}}
{{Related|Libcanberra}}
{{Related articles end}}
デスクトップ通知は、非同期に特定のイベントをユーザーに通知する小さくて控えめなポップアップダイアログです。

==Libnotify==

Libnotify は [[GTK+]] や [[Qt]] アプリケーションのサポートを提供する [https://developer.gnome.org/notification-spec/ Desktop Notifications Specification] の実装で特定のデスクトップに依存していません: [[Evolution]] や [[Pidgin]] など多数のオープンソースアプリによって使用されています。Libnotify は[[公式リポジトリ]]にある {{Pkg|libnotify}} パッケージでインストールすることが可能です。

libnotify を使うには、[[#通知サーバー|通知サーバー]]をインストールする必要があります。

== 通知サーバー ==

===ビルトイン===
以下のデスクトップ環境では通知を表示するためにそれぞれ独自の実装を使っており、置き換えることができません。通知サーバーはログイン時に自動で起動し DBus によってアプリケーションからの通知を受け取ります。

* [[Cinnamon]] は通知サーバーを備えており、通知は画面の右上に表示されます。
* [[Enlightenment]] は Notification 拡張を通して通知サーバーを提供しています。通知オプションは[[Enlightenment#通知|設定]]が可能です。
* [[GNOME]] は通知サーバーを備えており、通知は画面の上部に表示されます。
* [[KDE]] は通知サーバーを備えており、通知は画面の右下に表示されます。

また、[[Deepin]] および [[GNOME Flashback]] も同様に通知サーバーを備えています。

===スタンドアロン===
他のデスクトップ環境では、ウィンドウマネージャやデスクトップ環境の自動実行を使って通知サーバーを起動する必要があります。

[[D-Bus]] で初めて呼ばれた時に通知サーバーを起動させるには、通知サーバー ({{Pkg|notification-daemon}} パッケージなど) をインストールした後、以下のように設定を {{ic|/usr/share/dbus-1/services}} (またはユーザー個別に起動したい場合 {{ic|$XDG_DATA_HOME/dbus-1/services}}) に追加します:

{{hc|org.freedesktop.Notifications.service|2=
[D-BUS Service]
Name=org.freedesktop.Notifications
Exec=/usr/lib/notification-daemon-1.0/notification-daemon
}}

通知サーバーは以下から選ぶことができます:

* {{App|[[Avant Window Navigator]]|AWN で使うことができる通知デーモンアプレット。|https://github.com/p12tic/awn-extras|{{AUR|awn-extras-applets}}}}
* {{App|Deadd Notification Center|Dnust にインスパイヤされた、通知センターが付いた通知デーモン。|https://github.com/phuhl/linux_notification_center|{{AUR|deadd-notification-center}}}}
* {{App|[[Dunst]]|[[dwm]] などのミニマルなウィンドウマネージャにうってつけの Linux 用の最小通知デーモン。|https://dunst-project.org/|{{pkg|dunst}}}}
* {{App|fnott|wlroots-based コンポジタのための軽量な Wayland 向けの通知デーモン。キーボードによって操作される。|https://codeberg.org/dnkl/fnott|{{AUR|fnott}}}}
* {{App|LXQt Notification Daemon|[[LXQt]] の通知サーバー。|https://github.com/lxde/lxqt-notificationd|{{pkg|lxqt-notificationd}}}}
* {{App|mako|[[Wayland]] 向けの軽量な通知サーバー。現時点では [[Sway]] と一緒に動作します。|https://github.com/emersion/mako|{{Pkg|mako}} {{AUR|mako-git}}}}
* {{App|MATE Notification Daemon|[[MATE]] の通知サーバー。|https://github.com/mate-desktop/mate-notification-daemon/|{{Pkg|mate-notification-daemon}}}}
* {{App|Notification Daemon|[[GNOME Flashback]] によって使われている通知サーバー。|https://github.com/GNOME/notification-daemon|{{pkg|notification-daemon}}}}
:{{ic|/usr/lib/notification-daemon-1.0/notification-daemon}} で手動で起動できます。
* {{App|Notify OSD|[[Unity]] の通知サーバー。|https://launchpad.net/notify-osd|{{Pkg|notify-osd}}}}
* {{App|statnot|小さくて軽量な通知デーモン。ルートウィンドウのタイトルや標準出力、FIFO パイプなどに通知を出力できるので、タイル型ウィンドウマネージャと相性がとても良いです。|https://github.com/halhen/statnot|{{AUR|statnot}}}}
* {{App|sandsmark-notificationd| ミニマムな通知デーモン。ミュート機能をサポート。|https://github.com/sandsmark/sandsmark-notificationd|{{AUR|sandsmark-notificationd-git}}}}
* {{App|twmn|タイル型ウィンドウマネージャ向けの通知システム。|https://github.com/sboli/twmn|{{AUR|twmn-git}}}}
* {{App|wired|レイヤーブロックのカスタマイズ性が高い軽量な通知デーモン。Rust で書かれている。|https://github.com/Toqozz/wired-notify|{{AUR|wired}}}}
* {{App|Xfce Notification Daemon|[[Xfce]] の通知サーバー。|https://goodies.xfce.org/projects/applications/xfce4-notifyd|{{Pkg|xfce4-notifyd}}}}
:{{Tip|xfce4-notifyd を設定するには、ターミナルから次のコマンドを実行してください: {{ic|xfce4-notifyd-config}}。}}

==プログラミングでの使い方==
GObject-Introspection やバインディングを通して多くのプログラミング言語を使ったり、または bash を利用して簡単に libnotify でメッセージを表示することができます。

以下の例ではシンプルな "Hello world" の通知が表示されます。

===Bash===

* 依存パッケージ: {{Pkg|libnotify}}

{{hc|hello_world.sh|2=
#!/bin/bash
notify-send 'Hello world!' 'This is an example notification.' --icon=dialog-information
}}

{{Tip|
* 利用可能なアイコンは [https://specifications.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html Icon Naming Specification] から参照できます。
* root で実行するバックグラウンドスクリプトからデスクトップ通知を送信するには ({{ic|''X_user''}} と {{ic|''X_userid''}} は X を実行するユーザーおよびユーザー ID に置き換えてください): {{ic|1=# sudo -u ''X_user'' DISPLAY=:0 DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/''X_userid''/bus notify-send 'Hello world!' 'This is an example notification.'}}。}}

=== Boo ===

* 依存パッケージ: {{Pkg|notify-sharp-3}} ({{AUR|boo}})
* ビルドするのに必要なパッケージ: {{AUR|boo}}
* ビルド: {{ic|booc hello_world.boo}}
* 実行: {{ic|mono hello_world.exe}} (または {{ic|booi hello_world.boo}})

{{hc|hello_world.boo|2=
import Notifications from "notify-sharp"
Hello = Notification()
Hello.Summary = "Hello world!"
Hello.Body = "This is an example notification."
Hello.IconName = "dialog-information"
Hello.Show()
}}

=== C ===

* 依存パッケージ: {{Pkg|glib2}}
* ビルド: {{ic|gcc -o hello_world `pkg-config --cflags --libs gio-2.0` hello_world.c}}

{{hc|hello_world.c|2=
#include <gio/gio.h>
int main() {
GApplication *application = g_application_new ("hello.world", G_APPLICATION_FLAGS_NONE);
g_application_register (application, NULL, NULL);
GNotification *notification = g_notification_new ("Hello world!");
g_notification_set_body (notification, "This is an example notification.");
GIcon *icon = g_themed_icon_new ("dialog-information");
g_notification_set_icon (notification, icon);
g_application_send_notification (application, NULL, notification);
g_object_unref (icon);
g_object_unref (notification);
g_object_unref (application);
return 0;
}
}}

* 依存パッケージ: {{Pkg|libnotify}}
* ビルド: {{ic|gcc -o hello_world `pkg-config --cflags --libs libnotify` hello_world.c}}

{{hc|hello_world.c|2=
#include <libnotify/notify.h>
int main() {
notify_init ("Hello world!");
NotifyNotification * Hello = notify_notification_new ("Hello world", "This is an example notification.", "dialog-information");
notify_notification_show (Hello, NULL);
g_object_unref(G_OBJECT(Hello));
notify_uninit();
return 0;
}
}}

=== C++ ===

* 依存パッケージ: {{Pkg|glibmm}}
* ビルド: {{Ic|g++ -o hello_world `pkg-config --cflags --libs giomm-2.4` hello_world.cc}}

{{hc|hello_world.cc|2=
#include <giomm-2.4/giomm.h>
int main(int argc, char *argv[]) {
auto Application = Gio::Application::create("hello.world", Gio::APPLICATION_FLAGS_NONE);
Application->register_application();
auto Notification = Gio::Notification::create("Hello world");
Notification->set_body("This is an example notification.");
auto Icon = Gio::ThemedIcon::create("dialog-information");
Notification->set_icon (Icon);
Application->send_notification(Notification);
return 0;
}
}}

* 依存パッケージ: {{AUR|libnotifymm}}
* ビルド: {{Ic|g++ -o hello_world `pkg-config --cflags --libs libnotifymm-1.0` hello_world.cc}}

{{hc|hello_world.cc|2=
#include <libnotifymm.h>
int main(int argc, char *argv[]) {
Notify::init("Hello world!");
Notify::Notification Hello("Hello world", "This is an example notification.", "dialog-information");
Hello.show();
return 0;
}
}}

=== C# ===

* 依存パッケージ: {{Pkg|notify-sharp-3}}
* ビルド: {{ic|mcs -pkg:notify-sharp-3.0 hello_world.cs}}
* 実行: {{ic|mono hello_world.exe}}

{{hc|hello_world.cs|2=
using Notifications;
public class HelloWorld {
static void Main() {
var Hello = new Notification();
Hello.Summary = "Hello world!";
Hello.Body = "This is an example notification.";
Hello.IconName = "dialog-information";
Hello.Show();
}
}
}}

=== Cobra ===

* 依存パッケージ: {{Pkg|notify-sharp-3}}
* ビルドするのに必要なパッケージ: {{AUR|cobra}}
* ビルド: {{ic|cobra -c hello_world}}
* 実行: {{ic|mono hello_world.exe}}

{{hc|hello_world.cobra|<nowiki>@args -pkg:notify-sharp-3.0
use Notifications
class HelloWorld
def main
hello = Notification()
hello.summary = "Hello world!"
hello.body = "This is an example notification."
hello.iconName = "dialog-information"
hello.show</nowiki>}}

===Crystal===

* 依存パッケージ: [https://github.com/woodruffw/notify.cr woodruffw/notify.cr] (shards から)
* ビルドするのに必要なパッケージ: {{Pkg|crystal}} および {{Pkg|shards}}

{{hc|hello_world.cr|2=
require "notify"
notifier = Notify.new
notifier.notify "Hello", body: "World!"
}}

=== F# ===

* 依存パッケージ: {{Pkg|notify-sharp-3}}
* ビルドするのに必要なパッケージ: {{AUR|fsharp}}
* ビルド: {{ic|fsharpc -r:notify-sharp.dll -I:/usr/lib/mono/notify-sharp-3.0/ -I:/usr/lib/mono/gtk-sharp-3.0/ hello_world.fs}}
* 実行: {{ic|mono hello_world.exe}}

{{hc|hello_world.fs|2=
open Notifications
let Hello = new Notification()
Hello.Summary <- "Hello world!"
Hello.Body <- "This is an example notification."
Hello.IconName <- "dialog-information"
Hello.Show()
}}

=== Genie ===

* 依存パッケージ: {{Pkg|glib2}}
* ビルドするのに必要なパッケージ: {{Pkg|vala}}
* ビルド: {{ic|valac --pkg gio-2.0 hello_world.gs}}

{{hc|hello_world.gs|2=
uses
GLib

init
var Application = new GLib.Application ("hello.world", GLib.ApplicationFlags.FLAGS_NONE);
Application.register ();
var Notification = new GLib.Notification ("Hello world");
Notification.set_body ("This is an example notification.");
var Icon = new GLib.ThemedIcon ("dialog-information");
Notification.set_icon (Icon);
Application.send_notification (null, Notification);
}}

* 依存パッケージ: {{Pkg|libnotify}}
* ビルドするのに必要なパッケージ: {{Pkg|vala}}
* ビルド: {{ic|valac --pkg libnotify hello_world.gs}}

{{hc|hello_world.gs|2=
uses
Notify

init
Notify.init ("Hello world")
var Hello=new Notify.Notification ("Hello world!","This is an example notification.","dialog-information")
Hello.show ()
}}

=== Go ===

* 依存パッケージ: {{Pkg|libnotify}}
* ビルドするのに必要なパッケージ: {{AUR|go-notify-git}}
* ビルド: {{ic|go build hello_world.go}}
* 実行: {{ic|go run hello_world.go}}

{{hc|hello_world.go|2=
package main
import ("github.com/mqu/go-notify")

func main() {
notify.Init("Hello world")
hello := notify.NotificationNew("Hello World!", "This is an example notification.","dialog-information")
hello.Show()
}
}}

=== Groovy ===

* 依存パッケージ: {{Pkg|groovy}}, {{AUR|java-gnome}}
* ビルド: {{ic|groovyc -cp /usr/share/java/gtk.jar HelloWorld.groovy && jar cfe HelloWorld.jar HelloWorld HelloWorld.class}}
* 実行: {{ic|java -cp /usr/share/groovy/embeddable/groovy-all.jar:/usr/share/java/gtk.jar:HelloWorld.jar HelloWorld}} (または {{ic|groovy -cp /usr/share/java/gtk.jar HelloWorld.groovy}})

{{hc|HelloWorld.groovy|2=
import org.gnome.gtk.*
import org.gnome.notify.*

Gtk.init()
Notify.init("Hello world")
def Hello = new Notification("Hello world!", "This is an example notification.", "dialog-information")
Hello.show()
}}

=== Haskell ===

* ビルドするのに必要なパッケージ: {{Pkg|haskell-fdo-notify}}
* ビルド: {{ic|ghc hello_world}}
{{hc|hello_world.hs|2=
import DBus.Notify
main = do
client <- connectSession
let hello = blankNote { summary="Hello world!",
body=(Just $ Text "This is an example notification."),
appImage=(Just $ Icon "dialog-information") }
notification <- notify client hello
return 0
}}

=== IronPython ===

* 依存パッケージ: {{Pkg|notify-sharp-3}}, {{AUR|ironpython}}
* 実行: {{ic|ipy hello_world.py}}

{{hc|hello_world.py|2=
import clr
clr.AddReference('notify-sharp')
import Notifications
Hello = Notifications.Notification()
Hello.Summary = "Hello world!"
Hello.Body = "This is an example notification."
Hello.IconName = "dialog-information"
Hello.Show()
}}

=== Java ===

* 依存パッケージ: {{AUR|java-gnome}}
* ビルドするのに必要なパッケージ: java-environment
* ビルド: {{ic|javac -cp /usr/share/java/gtk.jar HelloWorld.java && jar cfe HelloWorld.jar HelloWorld HelloWorld.class}}
* 実行: {{ic|java -cp /usr/share/java/gtk.jar:HelloWorld.jar HelloWorld}}

{{hc|HelloWorld.java|2=
import org.gnome.gtk.Gtk;
import org.gnome.notify.Notify;
import org.gnome.notify.Notification;

public class HelloWorld
{
public static void main(String[] args) {
Gtk.init(args);
Notify.init("Hello world");
Notification Hello = new Notification("Hello world!", "This is an example notification.", "dialog-information");
Hello.show();
}
}
}}

=== JavaScript ===

* 依存パッケージ: {{Pkg|gjs}}

{{hc|hello_world.js|2=
#!/usr/bin/gjs
const Gio = imports.gi.Gio;
var Application = new Gio.Application ({application_id: "hello.world"});
Application.register (null);
var Notification = new Gio.Notification ();
Notification.set_title ("Hello world");
Notification.set_body ("This is an example notification.");
var Icon = new Gio.ThemedIcon ({name: "dialog-information"});
Notification.set_icon (Icon);
Application.send_notification (null, Notification);
}}

* 依存パッケージ: {{Pkg|libnotify}}, {{Pkg|gjs}}

{{hc|hello_world.js|2=
#!/usr/bin/gjs
const Notify = imports.gi.Notify;
Notify.init ("Hello world");
var Hello=new Notify.Notification ({summary: "Hello world!",
body: "This is an example notification.",
"icon-name": "dialog-information"});
Hello.show ();
}}

=== JRuby ===

* 依存パッケージ: {{AUR|java-gnome}}, {{Pkg|jruby}}
* ビルド: {{ic|jrubyc hello_world.rb && jar cfe hello_world.jar hello_world hello_world.class}}
* 実行: {{ic|java -cp /opt/jruby/lib/jruby.jar:hello_world.jar hello_world}} または {{ic|jruby hello_world.rb}}
{{hc|hello_world.rb|2=
require '/usr/share/java/gtk.jar'
import Java::OrgGnomeGtk::Gtk
import Java::OrgGnomeNotify::Notify
import Java::OrgGnomeNotify::Notification

Gtk.init(nil)
Notify.init("Hello world")
Hello = Notification.new("Hello world!", "This is an example notification.", "dialog-information")
Hello.show
}}

=== Jython ===

* 依存パッケージ: {{AUR|java-gnome}}, {{Pkg|jython}}
* 実行: {{ic|1=jython -Dpython.path=/usr/share/java/gtk.jar hello_world.py}}
{{hc|hello_world.py|2=
from org.gnome.gtk import Gtk
from org.gnome.notify import Notify, Notification
Gtk.init(None)
Notify.init("Hello world")
Hello=Notification("Hello world!", "This is an example notification.", "dialog-information")
Hello.show()
}}

=== Lua ===

* 依存パッケージ: {{Pkg|lua-lgi}}

{{hc|hello_world.lua|2=
#!/usr/bin/lua
lgi = require 'lgi'
Gio = lgi.require('Gio')
Application = Gio.Application.new("hello.world",Gio.ApplicationFlags.FLAGS_NONE);
Application:register();
Notification = Gio.Notification.new("Hello world");
Notification:set_body("This is an example notification.");
Icon = Gio.ThemedIcon.new("dialog-information");
Notification:set_icon(Icon);
Application:send_notification(nil, Notification);
}}

* 依存パッケージ: {{Pkg|libnotify}}, {{Pkg|lua-lgi}}

{{hc|hello_world.lua|2=
#!/usr/bin/lua
lgi = require 'lgi'
Notify = lgi.require('Notify')
Notify.init("Hello world")
Hello=Notify.Notification.new("Hello world","This is an example notification.","dialog-information")
Hello:show()</nowiki>}}

=== Nemerle ===

* 依存パッケージ: {{Pkg|notify-sharp-3}}
* ビルドするのに必要なパッケージ: {{AUR|nemerle}}
* ビルド: {{ic|ncc -pkg:notify-sharp-3.0 -out:hello_world.exe hello_world.n}}
* 実行: {{ic|mono hello_world.exe}}

{{hc|hello_world.n|2=
using Notifications;
public class HelloWorld {
static Main() : void {
def Hello = Notification();
Hello.Summary = "Hello world!";
Hello.Body = "This is an example notification.";
Hello.IconName = "dialog-information";
Hello.Show();
}
}
}}

=== Pascal ===

* 依存パッケージ: {{Pkg|libnotify}}
* ビルドするのに必要なパッケージ: {{Pkg|fpc}}, [https://github.com/ik5/libnotify-fpc libnotify バインディング]
* ビルド: {{ic|fpc hello_world}}

{{hc|hello_world.pas|2=
program hello_world;
uses libnotify;
var hello : PNotifyNotification;
begin
notify_init(argv[0]);
hello := notify_notification_new ('Hello world', 'This is an example notification.', 'dialog-information');
notify_notification_show (hello, nil);
end.
}}

=== Perl ===

==== libnotify を使用 ====

* 依存パッケージ: {{Pkg|libnotify}}, {{Pkg|perl-glib-object-introspection}}
{{hc|hello_world.pl|2=
#!/usr/bin/perl
use Glib::Object::Introspection;
Glib::Object::Introspection->setup (
basename => 'Notify',
version => '0.7',
package => 'Notify');
Notify->init;
my $hello = Notify::Notification->new('Hello world!',
"This is an example notification.",
"dialog-information");
$hello->show;
}}

==== 直接 D-Bus 呼び出し ====

* 依存関係: {{Pkg|perl-net-dbus}}
{{hc|hello_world.pl|2=
#!/usr/bin/perl
use Net::DBus;
my $bus = Net::DBus->session;
my $svc = $bus->get_service('org.freedesktop.Notifications');
my $obj = $svc->get_object('/org/freedesktop/Notifications');
my $id = $obj->Notify('myapp', 0,
'dialog-information',
'Hello world!',
'This is an example notification.',
[], {}, 0);
}}

=== Python ===

* 依存パッケージ: {{Pkg|python-gobject}} (または Python 2 なら {{Pkg|python2-gobject}})

{{hc|hello_world.py|2=
#!/usr/bin/python
import gi
gi.require_version('Gio', '2.0')
from gi.repository import Gio
Application=Gio.Application.new ("hello.world", Gio.ApplicationFlags.FLAGS_NONE);
Application.register ()
Notification=Gio.Notification.new ("Hello world")
Notification.set_body ("This is an example notification.")
Icon=Gio.ThemedIcon.new ("dialog-information")
Notification.set_icon (Icon)
Application.send_notification (None, Notification)
}}

* 依存パッケージ: {{Pkg|libnotify}}, {{Pkg|python-gobject}} (または Python 2 なら {{Pkg|python2-gobject}})

{{hc|hello_world.py|2=
#!/usr/bin/python
import gi
gi.require_version('Notify', '0.7')
from gi.repository import Notify
Notify.init ("Hello world")
Hello = Notify.Notification.new ("Hello world","This is an example notification.","dialog-information")
Hello.show ()
}}

=== Ruby ===

*依存パッケージ: {{Pkg|libnotify}}, {{AUR|ruby-gir_ffi}}

{{hc|hello_world.rb|2=
#!/usr/bin/ruby
require 'gir_ffi'
GirFFI.setup :Notify
Notify.init("Hello world")
Hello = Notify::Notification.new("Hello world!", "This is an example notification.", "dialog-information")
Hello.show
}}

=== Rust ===

[https://crates.io/crates/notify-rust notify-rust] を使用。
* ビルドするのに必要なパッケージ: {{Pkg|rust}} か {{Pkg|rustup}} ([[Rust]] を参照)
* ビルド: {{ic|cargo build}}
* 実行: {{ic|target/debug/hello_world}} または {{ic|cargo run}}

{{hc|Cargo.toml|2=
[package]
name = "hello_world"
version = "0.1.0"

[dependencies]
notify-rust = "^3"
}}

{{hc|src/main.rs|2=
extern crate notify_rust;
use notify_rust::Notification;
fn main(){
Notification::new()
.summary("Hello world")
.body("This is an example notification.")
.icon("dialog-information")
.show().unwrap();
}
}}

=== Scala ===

* 依存パッケージ: {{AUR|java-gnome}} (と {{Pkg|scala}})
* ビルドするのに必要なパッケージ: {{Pkg|scala}}
* ビルド: {{ic|scalac -cp /usr/share/java/gtk.jar -d HelloWorld.jar HelloWorld.scala}}
* 実行: {{ic|java -cp /usr/share/java/gtk.jar:HelloWorld.jar HelloWorld}} (または {{ic|scala -cp /usr/share/java/gtk.jar HelloWorld.scala}})

{{hc|HelloWorld.scala|2=
import org.gnome.gtk._
import org.gnome.notify._

object HelloWorld {
def main(args: Array[String]) {
Gtk.init(args)
Notify.init("Hello world")
var Hello = new Notification("Hello world!", "This is an example notification.", "dialog-information")
Hello.show()
}
}
}}

=== Vala ===

*依存パッケージ: {{Pkg|glib2}}
*ビルドするのに必要なパッケージ: {{Pkg|vala}}
*ビルド: {{ic|valac --pkg gio-2.0 hello_world.vala}}

{{hc|hello_world.vala|2=
using GLib;
public class HelloWorld {
static void main () {
var Application = new GLib.Application ("hello.world", GLib.ApplicationFlags.FLAGS_NONE);
Application.register ();
var Notification = new GLib.Notification ("Hello world");
Notification.set_body ("This is an example notification.");
var Icon = new GLib.ThemedIcon ("dialog-information");
Notification.set_icon (Icon);
Application.send_notification (null, Notification);
}
}
}}

*依存パッケージ: {{Pkg|libnotify}}
*ビルドするのに必要なパッケージ: {{Pkg|vala}}
*ビルド: {{ic|valac --pkg libnotify hello_world.vala}}

{{hc|hello_world.vala|2=
using Notify;
public class HelloWorld {
static void main () {
Notify.init ("Hello world");
var Hello = new Notify.Notification("Hello world!", "This is an example notification.", "dialog-information");
Hello.show ();
}
}
}}

=== Visual Basic .NET ===

* 依存パッケージ: {{Pkg|notify-sharp-3}}
* ビルドするのに必要なパッケージ: {{AUR|mono-basic}}
* ビルド: {{ic|vbnc -r:/usr/lib/mono/notify-sharp-3.0/notify-sharp.dll hello_world.vb}}
* 実行: {{ic|mono hello_world.exe}}

{{hc|hello_world.vb|2=
Imports Notifications
Public Class Hello
Public Shared Sub Main
Dim Hello As New Notification
Hello.Summary = "Hello world!"
Hello.Body = "This is an example notification."
Hello.IconName = "dialog-information"
Hello.Show
End Sub
End Class
}}

==参照==
*[https://developer.gnome.org/libnotify/ Libnotify リファレンスマニュアル]
*[http://milky.manishsinha.net/2009/03/29/working-with-libnotify/ C サンプル]
*[http://hashbang.fr/tutoriel-notify.html Python サンプル] (フランス語の記事)

Arch ブートプロセス

2022-02-11T05:21:17Z

Shota: /* ファームウェアの種類 */ 内部リンクの細かい修正

[[Category:ブートプロセス]]
[[Category:Arch について]]
[[ar:Arch boot process]]
[[bs:Arch boot process]]
[[cs:Arch boot process]]
[[en:Arch boot process]]
[[es:Arch boot process]]
[[fr:Processus de boot]]
[[it:Arch boot process]]
[[pt:Arch boot process]]
[[zh-hans:Arch boot process]]
{{Related articles start}}
{{Related|ブートローダー}}
{{Related|Master Boot Record}}
{{Related|GUID Partition Table}}
{{Related|Unified Extensible Firmware Interface}}
{{Related|mkinitcpio}}
{{Related|init}}
{{Related|systemd}}
{{Related|fstab}}
{{Related|自動起動}}
{{Related articles end}}
Arch Linux を起動するためには、[[GRUB|GRUB]] や [[Syslinux|Syslinux]] などの Linux 対応のブートローダを、[[Master Boot Record|Master Boot Record]] もしくは [[GUID Partition Table|GUID Partition Table]] にインストールする必要があります。ブートローダは、ブートプロセスが始まる前にカーネルや[[mkinitcpio|初期 RAM ディスク]]をロードする仕事を行います。[[Wikipedia:ja:BIOS|BIOS]] と [[Unified Extensible Firmware Interface|UEFI]] で起動の流れはかなり異なっています。このページや関連するページに詳しい説明があります。

== ファームウェアの種類 ==

=== BIOS ===

[[Wikipedia:ja:BIOS|BIOS]] (Basic Input-Outout System) とはシステムの電源を入れた時に最初に実行されるプログラム(ファームウェア)のことです。ほとんどの場合、BIOS はマザーボード内のフラッシュメモリに保存され、システムストレージとは独立しています。

=== UEFI ===

[[Unified Extensible Firmware Interface]] は、パーティションテーブルとファイルシステムの両方の読み取りをサポートしています。UEFI か MBR か、にかかわらず、UEFI は [https://ja.wikipedia.org/wiki/%E4%B8%8D%E6%8F%AE%E7%99%BA%E6%80%A7%E3%83%A1%E3%83%A2%E3%83%AA NVRAM] を起動せず、代わりにブートエントリに依存します。

UEFI 仕様では [[FAT|FAT12、FAT16、および FAT32]] ファイルシステム ([https://uefi.org/sites/default/files/resources/UEFI_Spec_2_8_final.pdf#G17.1019485 UEFI 仕様バージョン2.8、セクション13.3.1.1] を参照) のサポートが義務付けられていますが、規格に準拠しているベンダーは任意でファイルシステムのサポートを追加できます。たとえば、Apple [[Mac]] は独自のHFS+ファイルシステムドライバをサポートしています。UEFI の実装では、光ディスク用の ISO-9660 もサポートされています。

UEFIは、[[#Boot loader|boot loaders]] 、ブートマネージャ、 [[Unified_Extensible_Firmware_Interface#UEFI シェル |UEFI シェル]] などの EFI アプリケーションを起動します。これらのアプリケーションは通常、 [[EFI システムパーティション]] にファイルとして保存されます。各ベンダーは、EFI システムパーティションの {{ic|/EFI/''vendor_name''}} フォルダにファイルを格納できます。アプリケーションを起動するには、NVRAM または UEFI シェルにブートエントリを追加します。

UEFI 仕様では、[https://ja.wikipedia.org/wiki/Unified_Extensible_Firmware_Interface 互換性サポートモジュール (CSM)] によるレガシー BIOS ブートがサポートされています。UEFI で CSM が有効な場合、UEFI はすべてのドライブの CSM ブートエントリを生成します。CSM ブートエントリがブート元として選択された場合、UEFI の CSM はドライブの MBR ブートストラップコードからのブートを試みます。

== ブートプロセス ==

=== BIOS ===
# システムの電源が入れられ [[Wikipedia:ja:Power On Self Test|POST]] が実行される
# BIOS がブートに必要なシステムハードウェア (ディスクやキーボードコントローラなど) を初期化する
# (BIOS のディスク順で) 最初のディスクの最初の440バイト ([[Master Boot Record|Master Boot Record]]) が BIOS によって実行される
# BIOS から MBR ブートコードにコントロールが移り、次のステージのコードが起動する (通常は[[ブートローダー]]のコード)
# 起動した(2番目の)コード(ブートローダー)はサポートと設定ファイルを読み込む
# 設定ファイルのデータに基づき、ブートローダーはカーネルと initramfs をシステムメモリ (RAM) にロードしてカーネルを起動する

=== UEFI ===
次のページを参照してください: [[Unified Extensible Firmware Interface#UEFI のブートプロセス]]

== ブートローダー ==

ブートローダーは、ファームウェア([[Wikipedia:BIOS|BIOS]] または [[UEFI]]) によって起動されるソフトウェアです。カーネルは必要な [[カーネルパラメータ]] と [[mkinitcpio|初期RAMディスク]] を設定ファイルに基づいてロードします。UEFI の場合、EFI ブートスタブを使用して、UEFI からカーネル自体を直接起動できます。ブート前にカーネルパラメータを編集するために、別のブートローダやブートマネージャを使うこともできます。

{{Warning|ブートローダーはカーネルと initramfs イメージにアクセスできなければなりません。アクセスできなければシステムはブートしません。したがって、通常のセットアップでは、{{ic|/boot}} へのアクセスをサポートしている必要があります。つまり、ブロックデバイスからスタックされたブロックデバイス (LVM、RAID、dm-crypt、LUKSなど) まで、カーネルやinitramfsイメージが存在するファイルシステムまで、すべてをサポートしなければなりません。}}

{{Note|[[マイクロコード]] の更新を読み込むには、ブートローダの設定を調整する必要があります。 [https://www.archlinux.org/news/changes-to-intel-microcodeupdates/]}}

=== 機能比較 ===

{{Note|
GPT は UEFI 仕様の一部であるため、すべての UEFI ブートローダーは GPT ディスクをサポートします。BIOS システム上の GPT は、[https://www.rodsbooks.com/gdisk/hybrid.html HybridMBR]で "hybrid booting" を使うか、新しい [http://repo.or.cz/syslinux.git/blob/HEAD:/doc/gpt.txt GPTのみ] プロトコルを使うことで可能です。ただしこのプロトコルは特定の BIOS 実装で問題を引き起こす可能性があります。詳細については、[http://www.rodsbooks.com/gdisk/bios.html#bios書籍] を参照してください。
* ファイルシステムのサポートで言及されている暗号化は [[wikipedia:Filesystem-level encryption|filesystem-level encryption]] であり [[dm-crypt|ブロックレベルの暗号化]] とは関係ありません。
}}

{| class="wikitable sortable"
! rowspan="2"| 名前
! colspan="2"| ファームウェア
! colspan="2"| [[パーティショニング#パーティションテーブル|パーティションテーブル]]
! rowspan="2"| マルチブート
! colspan="5"| [[ファイルシステム]]
! rowspan="2"| 備考
|-
! BIOS !! [[UEFI]]
! [[MBR]] !! [[GPT]]
! [[Btrfs]] !! [[ext4]] !! ReiserFS !! [[VFAT]] !! [[XFS]]
|-
! [[EFISTUB]]
| {{-}} || {{Yes}}
| {{Yes}} || {{Yes}}
| {{-}}
| {{-}} || {{-}} || {{-}} || {{G|Inherited from firmware1}} || {{-}}
| カーネルはEFI実行可能ファイルに変換され、[[UEFI]] ファームウェアまたは別のブートローダーから直接ロードされます。
|-
! [[Clover]]
| {{G|Emulates UEFI}} || {{Yes}}
| {{Yes}} || {{Yes}}
| {{Yes}}2
| {{No}} || {{Y|Without encryption}} || {{No}} || {{G|Inherited from firmware1}} || {{No}}
| rEFIt のフォークは、[[wikipedia:OSx86|macOS on non-Apple hardware]] を実行するように変更されました。
|-
! [[GRUB]]
| {{Yes}} || {{Yes}}
| {{Yes}} || {{Yes}}
| {{Yes}}
| {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
| BIOS / GPT 構成では、[[GRUB#BIOS|BIOSシステム]] が必要です。 RAID、LUKS1、LVMをサポートします(シンプロビジョニングボリュームはサポートしません)
|-
! [[rEFInd]]
| {{No}} || {{Yes}}
| {{Yes}} || {{Yes}}
| {{Yes}}2
| {{Y|Without encryption}} || {{Y|Without encryption}} || {{Y|Without tail-packing feature}} || {{G|Inherited from firmware1}} || {{No}}
| 明示的な構成なしでカーネルとパラメーターの自動検出をサポートします。
|-
! [[Syslinux]]
| {{Yes}} || {{Y|[[Syslinux#Limitations of UEFI Syslinux|Partial]]}}
| {{Yes}} || {{Yes}}
| {{Y|[[Syslinux#Chainloading|Partial]]}}
| {{Y|Without: multi-device volumes, compression, encryption}} || {{Y|Without encryption}} || {{No}} || {{Yes}} || {{Y|MBR only; without sparse inodes}}
| 特定の [[ファイルシステム]] 機能はサポートされていません。[https://wiki.syslinux.org/wiki/index.php?title=Filesystem] ファイルシステムドライバーがありません [https://bugzilla.syslinux.org/show_bug.cgi?id=33] は、インストールされているファイルシステムにのみアクセスできます。
|-
! [[systemd-boot]]
| {{No}} || {{Yes}}
| {{Y|[https://github.com/systemd/systemd/issues/1125 Manual install only]}} || {{Yes}}
| {{Yes}}2
| {{No}} || {{No}} || {{No}} || {{G|Inherited from firmware1}} || {{No}}
| [[ESP]] または拡張ブートローダーパーティション(XBOOTLDRパーティション)以外のパーティションからバイナリを起動することはできません。
|-
! {{Grey|[[GRUB Legacy]]}}
| {{Yes}} || {{No}}
| {{Yes}} || {{No}}
| {{Yes}}
| {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Y|XFS v4 only}}
| [https://www.gnu.org/software/grub/grub-legacy.html廃止] [[GRUB]] を支持
|-
! {{Grey|[[LILO]]}}
| {{Yes}} || {{No}}
| {{Yes}} || {{No}}
| {{Yes}}
| {{No}} || {{Y|Without encryption}} || {{Yes}} || {{Yes}} || {{Yes|http://xfs.org/index.php/XFS_FAQ#Q:_Does_LILO_work_with_XFS.3F}}
| [https://web.archive.org/web/20180323163248/http://lilo.alioth.debian.org/ 廃止] 制限による (Btrfs、GPT、RAIDなど)
|}

# ファイルシステムのサポートはファームウェアから継承されます。 UEFI 仕様では、FAT12、FAT16、および FAT32 ファイルシステムのサポートが義務付けられていますが、ベンダーはオプションで追加のファイルシステムのサポートを追加できます。[https://uefi.org/sites/default/files/resources/UEFI_Spec_2_8_final.pdf#G17.1345080] たとえば、Apple [[Mac]] のファームウェアは HFS+ ファイルシステムをサポートしています。ファームウェアが起動時に [[Unified Extensible Firmware Interface#UEFIドライバー| UEFIドライバー]] をロードするためのインターフェースを提供する場合、ファイルシステムドライバーを(個別に取得して)ロードすることにより、追加のファイルシステムのサポートを追加できます。
#A [https://www.rodsbooks.com/efi-bootloaders/principles.html boot manager] 他の EFI アプリケーション、たとえば {{ic | 1 = CONFIG_EFI_STUB = y}} および Windows {{ic|bootmgfw.efi}} で構築された Linux カーネルイメージのみを起動できます。

[[Wikipedia:Comparison of boot loaders]] も参照してください。

== カーネル ==
カーネルはオペレーティングシステムのコアです。ローレベル (''カーネル空間'') で、マシンのハードウェアとハードウェアを使って実行されるプログラムを橋渡しします。CPU を効率的に利用するために、カーネルはスケジューラーを使ってどのタスクが優先的に実行されるかを決定し、多くのタスクが同時に実行されるのを可能にしています。

== initramfs ==
カーネルがロードされた後、カーネルは [[mkinitcpio|initramfs]] (initial RAM ファイルシステム) を解凍して、initial root ファイルシステムにします。カーネルは最初のプロセスとして {{ic|/init}} を起動します。''初期ユーザー空間''の始まりです。

initramfs の目的は root ファイルシステムにアクセスできる位置にシステムをブートストラップすることです (詳しくは [[FHS]] を見て下さい)。これは IDE, SCSI, SATA, USB/FW (外部ハードウェアから起動する場合) などのデバイスのために必要なモジュールがカーネルに入っていない場合 initramfs からモジュールをロードできなくてはならないということを意味しています; (プログラムやスクリプトから明示的に指定されるか [[udev|udev]] を通すかして) 正しいモジュールがロードされると、ブートプロセスが再開されます。従って、initramfs に含めなくてはならないのは root ファイルシステムにアクセスするために必要なモジュールだけで、使用する全てのモジュールを入れる必要はありません。ほとんどのモジュールは後の init プロセス中に、udev によってロードされます。

== Init プロセス ==

初期ユーザー空間の最終段階として、本当の root がマウントされ、initial root ファイルシステムを置き換えます。{{ic|/sbin/init}} が実行され、{{ic|/init}} プロセスを置き換えます。Arch は init プロセスとして [[systemd|systemd]] を使っています。

== getty ==
[[init]] は [[Wikipedia:Virtual console|virtual terminal]] (典型的には6つ) ごとに [[getty]] を1回呼び出し、各ttyを初期化してユーザ名とパスワードを要求します。ユーザ名とパスワードが与えられると、getty はそれらを {{ic|/etc/passwd}} と {{ic|/etc/shadow}} と照合し、 [[#Login|login]] を呼び出します。あるいは、システム上にディスプレイマネージャがあれば、getty はそれを起動します。

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

[[ディスプレイマネージャ]] は、tty の getty ログインプロンプトを置き換えるように設定できます。

起動後にディスプレイマネージャを自動的に初期化するには、 [[systemd]] からサービスユニットを手動で有効にする必要があります。サービス・ユニットの有効化と起動の詳細は、[[systemd#ユニットを使う]] を参照してください。

== ログイン ==

''ログイン'' プログラムは、環境変数を設定し、{{ic|/etc/passwd}} に基づいてユーザーのシェルを起動することによって、ユーザーのセッションを開始します。

''ログイン'' プログラムは、ログインに成功するとログインシェルを実行する直前に [[Wikipedia:motd (Unix) |/etc/motd]] (message of the day) の内容を表示します。利用規約を表示してユーザーに地域のポリシーや伝えたいことを思い出させるのに適した場所です。

== シェル ==

ユーザーの [[シェル]] が起動されると、通常はユーザーにプロンプトを表示する前に [[bashrc]] などの実行時設定ファイルが実行されます。アカウントが [[%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E6%99%82%E3%81%AB_X_%E3%82%92%E8%B5%B7%E5%8B%95]] に設定されている場合、実行時設定ファイルは [[startx]] または [[xinit]] を呼び出します。

== GUI, xinit or wayland ==

[[xinit]] はユーザの [[xinitrc]] runtime configuration fileを実行しこれは通常 [[ウィンドウマネージャ]] を開始します。ユーザがウィンドウマネージャを終了すると、''xinit''、 ''startx''、シェル、ログイン、の順序で終了して [[#getty|getty]] に戻ります。

== 参照 ==
* [http://archlinux.me/brain0/2010/02/13/early-userspace-in-arch-linux/ Early Userspace in Arch Linux]
* [https://www.ibm.com/developerworks/linux/library/l-linuxboot/ Inside the Linux boot process]
* [https://www.linuxjournal.com/article/4622 Boot with GRUB]
* [[Wikipedia:Linux startup process]]
* [[Wikipedia:ja:initrd]]
* [http://www.cyberciti.biz/faq/grub-boot-into-single-user-mode/ Boot Linux Grub Into Single User Mode]

アプリケーション一覧/インターネット

2022-02-05T09:44:58Z

Shota: /* Cloud synchronization clients */ wiki 内部に向いた空リンクの修正

<noinclude>
[[Category:インターネットアプリケーション]]
[[Category:ソフトウェア一覧]]
[[cs:List of applications (Čeština)/Internet]]
[[en:List of applications/Internet]]
[[es:List of applications (Español)/Internet]]
[[it:List of applications (Italiano)/Internet]]
[[pt:List of applications (Português)/Internet]]
[[zh-hans:List of applications (简体中文)/Internet]]
[[zh-hant:List of applications (正體中文)/Internet]]
{{List of Applications navigation}}
</noinclude>
== インターネット ==

=== Network connection ===

==== ネットワーク管理 ====

[[ネットワーク設定#ネットワーク管理]] を参照してください。

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

* {{App|Bitmask|Secured and encrypted communication using various service providers|https://bitmask.net/|{{AUR|bitmask}}}}
* {{App|Libreswan| 「IPsec」と「IKE」をベースにした、最も広くサポートされ、標準化されたVPNプロトコルのフリーソフトウェア実装です。|https://libreswan.org/|{{AUR|libreswan}}}}
* {{App|[[NetworkManager]]|Supports a variety of protocols (e.g. MS, Cisco, Fortinet) via a plugin system.|https://wiki.gnome.org/Projects/NetworkManager/VPN|{{pkg|networkmanager}}}}
* {{App|[[OpenConnect]]|Cisco と Juniper VPN に対応。|https://www.infradead.org/openconnect/|{{pkg|openconnect}}}}
* {{App|[[Openswan]]|IPsec-based VPN Solution.|https://www.openswan.org/|{{AUR|openswan}}}}
* {{App|[[OpenVPN]]|OpenVPN による VPN に接続します。|https://openvpn.net/|{{pkg|openvpn}}}}
* {{App|[[PPTP クライアント]]|Microsoft VPN (MPPE) などの PPTP VPN に接続します。(insecure)|http://pptpclient.sourceforge.net/|{{pkg|pptpclient}}}}
* {{App|[[strongSwan]]|IPsec-based VPN Solution.|https://www.strongswan.org/|{{pkg|strongswan}}}}
* {{App|[[tinc]]|tinc is a free VPN daemon.|https://www.tinc-vpn.org/|{{pkg|tinc}}}}
* {{App|[[:en:vopono]]|OpenVPN and Wireguard wrapper to launch applications with VPN tunnels in network namespaces.|https://github.com/jamesmcm/vopono|{{AUR|vopono}}}}
* {{App|[[Vpnc]]|To connect to Cisco 3000 VPN Concentrators.|https://www.unix-ag.uni-kl.de/~massar/vpnc/|{{pkg|vpnc}}}}
* {{App|[[WireGuard]]|Next generation secure network tunnel.|https://www.wireguard.com/|{{Pkg|wireguard-tools}}}}

==== Proxy servers ====

* {{App|Brook|Proxy focusing on strong encryption and being undetectable.|https://txthinking.github.io/brook/|{{Pkg|brook}}}}
* {{App|Dante|SOCKS server and SOCKS client, implementing RFC 1928 and related standards.|https://www.inet.no/dante/|{{Pkg|dante}}}}
* {{App|[[Privoxy]]|Non-caching web proxy with advanced filtering capabilities for enhancing privacy, modifying web page data and HTTP headers, controlling access, and removing ads and other obnoxious Internet junk.|https://www.privoxy.org/|{{Pkg|privoxy}}}}
* {{App|Project V|Project V is a set of tools to help you build your own privacy network over internet.|https://www.v2fly.org/en_US/|{{Pkg|v2ray}}}}
* {{App|[[Shadowsocks]]|Secure socks5 proxy, designed to protect your Internet traffic.|https://www.shadowsocks.org/en/index.html|Python: {{Pkg|shadowsocks}}, C: {{Pkg|shadowsocks-libev}}, Qt: {{Pkg|shadowsocks-qt5}}}}
* {{App|[[Squid]]|Caching proxy for the Web supporting HTTP, HTTPS, FTP, and more.|http://www.squid-cache.org/|{{Pkg|squid}}}}
* {{App|[[Stunnel]]|A server and client to add and remove TLS encryption to TCP data flow.|https://www.stunnel.org/|{{Pkg|stunnel}}}}
* {{App|Tinyproxy|Lightweight HTTP/HTTPS proxy daemon.|https://tinyproxy.github.io/|{{Pkg|tinyproxy}}}}
* {{App|[[Trojan]]|An unidentifiable mechanism that helps you bypass GFW.|https://trojan-gfw.github.io/trojan/|{{Pkg|trojan}}}}
* {{App|[[Varnish]]|High-performance HTTP accelerator.|https://varnish-cache.org/|{{Pkg|varnish}}}}
* {{App|XX-Net|Easy to use web proxy tool.|https://github.com/XX-net/XX-Net/|{{Aur|xx-net}}}}
* {{App|Ziproxy|Forwarding (non-caching) compressing HTTP proxy server.|http://ziproxy.sourceforge.net/|{{Pkg|ziproxy}}}}

==== 匿名化ネットワーク ====

* {{App|[[Freenet]]|検閲が存在しない暗号化ネットワーク。|https://freenetproject.org|{{AUR|freenet}}}}
* {{App|[[GNUnet]]|セキュアなピアツーピアネットワークのフレームワーク。|http://gnunet.org|CLI: {{AUR|gnunet}}, GUI: {{AUR|gnunet-gtk}}}}
* {{App|[[I2P]]|分散型の匿名ネットワーク。|https://geti2p.net|{{Pkg|i2pd}}, {{AUR|i2p}}, {{AUR|i2p-bin}}}}
* {{App|Lantern|ピアツーピアインターネット検閲回避ソフトウェア。|https://getlantern.org/|{{AUR|lantern-bin}}}}
* {{App|[[Tor]]|匿名化オーバーレイネットワーク。|http://www.torproject.org/|{{pkg|tor}}}}

=== ウェブブラウザ ===

See also [[Wikipedia:Comparison of web browsers]].

==== コンソール ====

* {{App|[[Wikipedia:Browsh|browsh]]|A fully-modern text-based browser. Runs as a frontend to headless Firefox.|https://www.brow.sh/|{{AUR|browsh}}}}
* {{App|[[ELinks]]|先進的な、定評のある高機能なテキストモードウェブブラウザ with mouse wheel scroll support, frames and tables, extensible with Lua & Guile (Links フォーク)。|http://elinks.or.cz/|{{Pkg|elinks}}}}
* {{App|[[Wikipedia:ja:Links|Links]]|テキスト WWW ブラウザ。Lynx に似ているコンソールバージョン [links] と、CSS・画像レンダリング・プルダウン式のメニューがあるグラフィカルな X-window/フレームバッファバージョンの [xlinks -g] があります (Arch では両方コンパイルされています)。|http://links.twibright.com/|{{Pkg|links}}}}
* {{App|[[Wikipedia:ja:Lynx (ウェブブラウザ)|Lynx]]|World Wide Web 用のテキストブラウザ。|https://lynx.invisible-island.net/|{{Pkg|lynx}}}}
* {{App|[[Wikipedia:ja:w3m|w3m]]|テキストベースのウェブブラウザ。vim ライクのキーバインドがあり、画像を表示することも可能です。|https://salsa.debian.org/debian/w3m|{{Pkg|w3m}}}}

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

===== Gecko ベース =====

See also [[Wikipedia:Gecko (software)]].

* {{App|[[Firefox]]|Mozilla によって開発されている、高速レンダリングを行う Gecko ベースの拡張性のあるブラウザ。|https://mozilla.com/firefox|{{Pkg|firefox}}}}
* {{App|[[Wikipedia:ja:SeaMonkey|SeaMonkey]]|Mozilla インターネットスイートの後継。|https://www.seamonkey-project.org/|{{Pkg|seamonkey}}}}

====== Firefox spin-offs ======
* {{App|[[Wikipedia:Cliqz|Cliqz]]|Firefox-based privacy aware web browser. Discontinued.|https://cliqz.com/|{{AUR|cliqz}} or {{AUR|cliqz-bin}}}}
* {{App|Dot|A fork of firefox focused on privacy and a sleeker UI.|https://www.dothq.co/|{{AUR|dot-bin}}}}
* {{App|FireDragon|A fork of LibreWolf that includes KDE integration patches and custom branding.|https://gitlab.com/dr460nf1r3/settings/|{{AUR|firedragon}}}}
* {{App|[[Wikipedia:ja:GNU IceCat|GNU IceCat]]|[[GNU プロジェクト]]によって配布されている Firefox ESR のカスタムビルド。フリーでないコンポーネントを削除し、プライバシー保護用の拡張を追加しています。リリースサイクルは Mozilla Firefox よりも遅れがちです。|https://www.gnu.org/software/gnuzilla/|{{AUR|icecat}} または {{AUR|icecat-bin}}}}
* {{App|LibreWolf|A fork of Firefox, focused on privacy, security and freedom.|https://librewolf-community.gitlab.io/|{{AUR|librewolf}} or {{AUR|librewolf-bin}}}}
* {{App|[[Tor]] Browser Launcher|Securely and easily download, verify, install, and launch Tor Browser, a fork of Firefox ESR.|https://github.com/micahflee/torbrowser-launcher|{{Pkg|torbrowser-launcher}}}}
* {{App|Waterfox Classic|Optimized fork of Firefox 56, without data collection and allowing unsigned extensions and NPAPI plugins.|https://www.waterfox.net/|{{AUR|waterfox-classic-bin}}}}
* {{App|Waterfox Current|Optimized fork of Firefox ESR, updated feature-rich branch of Waterfox.|https://www.waterfox.net/|{{AUR|waterfox-current-bin}}}}
* {{App|Waterfox G3|Optimized fork of Firefox 78, updated feature-rich branch of Waterfox.|https://www.waterfox.net/|{{AUR|waterfox-g3-bin}}}}

===== Blink ベース =====

[[Wikipedia:ja:Blink (レンダリングエンジン)]] を参照。

* {{App|[[Chromium]]|Google によって開発されているウェブブラウザ。WebKit レイアウトエンジンを使っています。Google Chrome のオープンソースプロジェクト。|https://www.chromium.org/|{{Pkg|chromium}}}}

====== Privacy-focused chromium spin-offs ======

* {{App|[[Wikipedia:Brave (web browser)|Brave]]|Web browser with builtin ad- and tracker blocking.|https://www.brave.com/|{{AUR|brave-bin}}}}
* {{App|Iridium|Chromium 用のプライバシー保護 [https://git.iridiumbrowser.de/cgit.cgi/iridium-browser/tree/?h=patchview パッチセット]。詳しくは [https://github.com/iridium-browser/tracker/wiki/Differences-between-Iridium-and-Chromium Chromium との差異] を参照。|https://iridiumbrowser.de/|{{AUR|iridium-rpm}}}}
* {{App|Ungoogled chromium|Google との統合を排除してプライバシーや透過性を高めた Google Chromium の改造版。|https://github.com/Eloston/ungoogled-chromium|{{AUR|ungoogled-chromium}}}}

====== Proprietary chromium spin-offs ======

* {{App|[[Google Chrome]]|Google によって開発されているプロプライエタリのウェブブラウザ。|https://www.google.com/chrome/|{{AUR|google-chrome}}}}
* {{App|[[Wikipedia:Microsoft Edge|Microsoft Edge]]|Proprietary web browser developed by Microsoft.|https://www.microsoft.com/edge/|{{AUR|microsoft-edge-stable-bin}}}}
* {{App|[[Opera]]|Proprietary browser developed by Opera Software.|https://opera.com|{{Pkg|opera}}}}
* {{App|[[Wikipedia:SlimBrowser|Slimjet]]|高速・スマート・強力なプロプライエタリブラウザ。Chromium がベース。|http://www.slimjet.com/|{{AUR|slimjet}}}}
* {{App|[[Vivaldi]]|パワーユーザーのために作られた先進的な proprietary ブラウザ。|https://vivaldi.com/|{{Pkg|vivaldi}}}}
* {{App|[[Wikipedia:Yandex Browser|Yandex Browser]]|ミニマルな設計と洗練されたテクノロジーによりウェブを高速・安全・簡単にする proprietary ブラウザ。|https://browser.yandex.com/|{{AUR|yandex-browser-beta}}}}

====== qt5-webengine ベース ======

* {{App|[[Wikipedia:Dooble|Dooble]]|Colorful Web browser.|https://textbrowser.github.io/dooble/|{{AUR|dooble}}}}
* {{App|[[Wikipedia:Eric Python IDE|Eric]]|QtWebEngine-based HTML browser, part of the eric6 development toolset, can be launched with the {{ic|eric6_browser}} command.|https://eric-ide.python-projects.org/|{{AUR|eric}}}}
* {{App|[[Wikipedia:Falkon|Falkon]]|Web browser based on QtWebEngine, written in Qt framework.|https://falkon.org/|{{pkg|falkon}}}}
* {{App|[[Wikipedia:Konqueror|Konqueror]]|Qt ツールキットと Qt WebEngine (または KHTML レイアウトエンジン) をベースとしたウェブブラウザ。{{Grp|kde-network}} に含まれています。|https://apps.kde.org/konqueror/|{{Pkg|konqueror}}}}
* {{App|Liri Browser|[[Liri]] のミニマルなマテリアルデザインのウェブブラウザ。|https://github.com/lirios/browser|{{AUR|liri-browser-git}}}}
* {{App|Qt WebBrowser|Qt と Qt WebEngine を使用して組み込みデバイス用に開発されたブラウザ。|https://doc.qt.io/QtWebBrowser/|{{AUR|qtwebbrowser}}}}
* {{App|[[qutebrowser]]|キーボードで操作する、[[vim]] ライクなブラウザ。PyQt5 と QtWebEngine がベース。|https://qutebrowser.org/|{{Pkg|qutebrowser}}}}

====== Browsers based on electron ======

* {{App|Beaker|Peer-to-peer web browser with tools to create and host websites. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/beakerbrowser/beaker|{{AUR|beaker-browser}}}}
* {{App|Ferdi|[[Wikipedia:Electron (software framework)|Electron]] application. Messaging browser that allows you to combine your favorite messaging services into one application. It is based on Franz.|https://getferdi.com/|{{AUR|ferdi}}}}
* {{App|Franz|[[Wikipedia:Electron (software framework)|Electron]] application. Messaging browser for WhatsApp, Facebook Messenger, Slack, Telegram and many other web services.|https://meetfranz.com/|{{AUR|franz}}}}
* {{App|Min|[[Electron]] プラットフォームをベースにして作成されたスマートで高速なウェブブラウザ。|https://minbrowser.github.io/min/|{{Pkg|min}}}}

===== WebKit ベース =====

[[Wikipedia:ja:WebKit]] を参照。

{{Note|今日では使用が非推奨となっている webkit ポート (webkitgtk/webkitgtk2/qtwebkit) をベースとしているブラウザはリストから削除されました。詳しくは [https://blogs.gnome.org/mcatanzaro/2016/02/01/on-webkit-security-updates/ こちら] を参照。}}

====== webkit2gtk ベース ======

Most of these support ad-blocking via [https://github.com/jun7/wyebadblock wyebadblock].
* {{App|[[Badwolf]]|A minimalist privacy-focused browser.|https://hacktivis.me/projects/badwolf|{{AUR|badwolf}}}}
* {{App|Ephemeral|A private-by-default, always-incognito browser for elementary OS.|https://github.com/cassidyjames/ephemeral|{{AUR|ephemeral}}}}
* {{App|Eolie|Simple web browser for GNOME.|https://wiki.gnome.org/Apps/Eolie|{{Pkg|eolie}}}}
* {{App|[[GNOME Web]]|WebKitGTK レンダリングエンジンを使うウェブブラウザ。part of {{Grp|gnome}}.|https://wiki.gnome.org/Apps/Web/|{{Pkg|epiphany}}}}
* {{App|[[Lariza]]|GTK 3, GLib, WebKit2GTK を使用するシンプルなウェブブラウザ。|https://www.uninformativ.de/git/lariza/|{{AUR|lariza}}}}
* {{App|[[Luakit]]|Fast, small, webkit based browser framework extensible by Lua.|https://luakit.github.io/|{{Pkg|luakit}}}}
* {{App|[[Midori]]|GTK と Webkit ベースの軽量なウェブブラウザ。|https://www.midori-browser.org/|{{Pkg|midori}}}}
* {{App|Nyxt|Keyboard-oriented, infinitely extensible browser designed for power users. It has familiar key-bindings (Emacs, VI, CUA) and features fuzzy searching between tabs, multiple selections, history as a tree and more.|https://nyxt.atlas.engineer/|{{AUR|nyxt}}}}
* {{App|[[surf]]|軽量な WebKit ベースブラウザ。[http://suckless.org/philosophy suckless philosophy] に従っています (基本的にブラウザ自体はひとつの C ソースファイルで構成)。|https://surf.suckless.org/|{{AUR|surf}}}}
* {{App|Surfer|Simple keyboard based web browser, written in C. It supports custom JS-scripts.|https://github.com/nihilowy/surfer|{{AUR|surfer-git}}}}
* {{App|Tangram|Integration of web applications into the desktop, specifically GNOME.|https://github.com/sonnyp/Tangram|{{AUR|tangram}}}}
* {{App|Vimb|A Vim-like web browser written in C that is inspired by Pentadactyl and Vimprobable. It includes a manpage and a howto for common configurations. It supports custom JS-scripts, dark mode and handles geolocation requests.|https://fanglingsu.github.io/vimb/|{{Pkg|vimb}}}}
* {{App|wyeb|A vim-like web browser inspired by dwb and luakit with Adblock.|https://github.com/jun7/wyeb|{{aur|wyeb-git}}}}

====== qt5-webkit ベース ======

* {{App|OSPKit|Webkit based html browser for printing.|http://osp.kitchen/tools/ospkit/|{{AUR|ospkit-git}}}}
* {{App|[[Otter Browser]]|Qt5 を使用して昔の Opera (12.x) の UI を再現するブラウザ。|https://otter-browser.org/|{{Pkg|otter-browser}}}}
* {{App|[[qutebrowser]]|キーボードで操作する、vim ライクなブラウザ。PyQt5 と QtWebKit がベース。|https://github.com/qutebrowser/qutebrowser|{{Pkg|qutebrowser}}}}
* {{App|smtube|Application that allows to browse, search and play YouTube videos.|https://www.smtube.org/|{{Pkg|smtube}}}}
* {{App|WCGBrowser|A web browser for kiosk systems.|http://www.alandmoore.com/wcgbrowser/wcgbrowser.html|{{AUR|wcgbrowser-git}}}}

===== その他 =====

* {{App|[[Wikipedia:Basilisk (web browser)|Basilisk]]|Another [[Wikipedia:Goanna (software)|Goanna-based]] browser from the developers of [[Wikipedia:Pale Moon (web browser)|Pale Moon]]. It features a Firefox 52-based UI, and is a perpetual beta. It lacks support for WebExtensions, but still supports XUL-based addons.|https://basilisk-browser.org/|{{AUR|basilisk-bin}}}}
* {{App|[[Wikipedia:Dillo|Dillo]]|[[Wikipedia:ja:FLTK|FLTK]] ベースの小型・高速なグラフィカルウェブブラウザ。独自のレイアウトエンジンを使用。|https://www.dillo.org/|{{Pkg|dillo}}}}
* {{App|[[Wikipedia:Links (web browser)|Links]]|Graphics and text mode web browser. Includes a graphical X-window/framebuffer version with CSS, image rendering, pull-down menus. It can be launched with the {{ic|xlinks -g}} command.|http://links.twibright.com/|{{Pkg|links}}}}
* {{App|[[Wikipedia:NetSurf|NetSurf]]|C で書かれたフェザー級のブラウザ。its slowly developing JavaScript support and カスタムレンダリングエンジンによって高速レンダリングすることで有名。|https://www.netsurf-browser.org/|{{Pkg|netsurf}}}}
* {{App|[[Wikipedia:Pale Moon (web browser)|Pale Moon]]|速度を重視して Firefox 29 以前のインターフェイスを備えた Firefox のフォーク。Gecko のフォークである [[Wikipedia:ja:Goanna|Goanna]] レイアウトエンジンを使用。Firefox のアドオンが動作しないことがあります。WebExtensions, cache2, e10s, OTMC など Firefox の新機能はサポートしていません。Many of the old [https://github.com/JustOff/ca-archive 93,598 versions of 19,450 Firefox add-ons created by 14,274 developers over the past 15 years using XUL/XPCOM technology in the Classic Add-ons Archive] still work.|https://www.palemoon.org/|{{AUR|palemoon}} or {{AUR|palemoon-bin}}}}

==== Gemini browsers ====

See also [[Wikipedia:Gemini (protocol)#Software]].

* {{App|Amfora|Terminal browser for the Gemini protocol.|https://github.com/makeworld-the-better-one/amfora|{{Pkg|amfora}}}}
* {{App|Bombabillo|Non-web client for the terminal, supporting Gopher, Gemini and much more.|https://bombadillo.colorfield.space/|{{AUR|bombadillo-git}}}}
* {{App|Castor|Graphical client for the Gemini, Gopher, and Finger protocols, written in Rust with GTK.|https://git.sr.ht/~julienxx/castor|{{AUR|castor}}}}
* {{App|Kristall|Qt-based Gemini browser.|https://github.com/MasterQ32/kristall|{{AUR|kristall}}}}
* {{App|Lagrange|Desktop GUI client for browsing Gemini space, offering modern conveniences familiar from web browsers.|https://gmi.skyjake.fi/lagrange|{{AUR|lagrange}}}}

=== Web servers ===

A [[Wikipedia:Web server|web server]] serves HTML web pages and other files via HTTP to clients like [[:Category:Web browser|web browsers]].
The major web servers can be interfaced with programs to serve dynamic content ([[web applications]]).

See also [[:Category:Web server]] and [[Wikipedia:Comparison of web server software]].

* {{App|[[Apache HTTP Server]]|A high performance Unix-based HTTP server.|https://httpd.apache.org/|{{Pkg|apache}}}}
* {{App|[[Caddy]]|HTTP/2 web server with automatic HTTPS.|https://caddyserver.com/|{{Pkg|caddy}}}}
* {{App|[[Hiawatha]]|Secure and advanced web server.|https://www.hiawatha-webserver.org/|{{Pkg|hiawatha}}}}
* {{App|[[Lighttpd]]|A secure, fast, compliant and very flexible web-server.|https://www.lighttpd.net/|{{Pkg|lighttpd}}}}
* {{App|[[nginx]]|Lightweight HTTP server and IMAP/POP3 proxy server.|https://nginx.org/|{{Pkg|nginx}}}}
* {{App|sthttpd|Supported fork of the thttpd web server.|https://github.com/blueness/sthttpd|{{Pkg|sthttpd}}}}
* {{App|yaws|Web server/framework written in Erlang.|http://yaws.hyber.org/|{{Pkg|yaws}}}}

==== Static web servers ====

* {{App|darkhttpd|A small and secure static web server, written in C, does not support HTTPS or Auth.|https://unix4lyfe.org/darkhttpd/|{{Pkg|darkhttpd}}}}
* {{App|KatWeb|A lightweight static web server and reverse proxy, written in Go, designed for the modern web.|https://github.com/kittyhacker101/KatWeb|{{AUR|katweb}}}}
* {{App|quark|An extremly small and simple http get-only web server. It only serves static pages on a single host.|https://tools.suckless.org/quark/|{{AUR|quark-git}}}}
* {{App|serve|Static file serving and directory listing.|https://github.com/zeit/serve|{{AUR|nodejs-serve}}}}
* {{App|servy|A tiny little web server, single binary, written in Rust.|https://github.com/zethra/servy|{{AUR|servy}}}}
* {{App|Webfs|Simple and instant web server for mostly static content.|https://linux.bytesex.org/misc/webfs.html|{{Pkg|webfs}}}}

The [[Python]] standard library module [https://docs.python.org/library/http.server.html http.server] can also be used from the command-line.

==== Specialized web servers ====

* {{App|chezdav|WebDAV server that allows to share a particular directory.|https://wiki.gnome.org/phodav|{{Pkg|phodav}}}}
* {{App|Mongoose|Embedded web server library, supports WebSocket and MQTT.|https://github.com/cesanta/mongoose|{{AUR|mongoose}}}}
* {{App|OnionShare|Lets you securely and anonymously send and receive files. It works by starting a web server, making it accessible as a Tor onion service, and generating an unguessable web address so others can download files from you, or upload files to you.|https://onionshare.org/|{{Pkg|onionshare}}}}
* {{App|VServer|GTK application, which opens an http server in the selected folder and shares your files.|https://github.com/bcedu/ValaSimpleHTTPServer|{{AUR|vserver-git}}}}
* {{App|webhook|Small server for creating HTTP endpoints (hooks)|https://github.com/adnanh/webhook|{{Pkg|webhook}}}}
* {{App|Woof|An ad-hoc single file webserver; Web Offer One File.|http://www.home.unix-ag.org/simon/woof.html|{{AUR|woof}}}}

==== WSGI servers ====

* {{App|Gunicorn|A Python WSGI HTTP Server for UNIX.|https://gunicorn.org/|{{Pkg|gunicorn}}, {{AUR|python2-gunicorn}}}}
* {{App|[[uWSGI]]|A fast, self-healing and developer/sysadmin-friendly application container server written in C.|https://uwsgi-docs.readthedocs.io/|{{Pkg|uwsgi}}}}
* {{App|Waitress|A WSGI server for Python 3.|https://github.com/Pylons/waitress|{{Pkg|python-waitress}}}}

Apache also supports WSGI with [[mod_wsgi]].

==== Performance testing ====

* {{App|http_load|A webserver performance testing tool, runs in a single process.|https://www.acme.com/software/http_load/|{{AUR|http_load}}}}
* {{App|httperf|Can generate various HTTP workloads, written in C.|https://github.com/httperf/httperf|{{AUR|httperf}}}}
* {{App|siege|An HTTP regression testing and benchmarking utility.|https://www.joedog.org/siege-home/|{{Pkg|siege}}}}
* {{App|vegeta|HTTP load testing tool, written in Go.|https://github.com/tsenart/vegeta|{{Pkg|vegeta}}}}
* {{App|Web Bench|Benchmarking tool, uses fork() for simulating multiple clients.|http://home.tiscali.cz/~cz210552/webbench.html|{{AUR|webbench}}}}

=== ファイル共有 ===

==== ダウンロードマネージャ ====

See also [[Wikipedia:Comparison of download managers]].

===== Console =====

* {{App|[[aria2]]|軽量なダウンロードユーティリティ。HTTP/S, FTP, SFTP, BitTorrent と Metalink をサポート。内蔵の JSON-RPC か XML-RPC インターフェースを通じてデーモンとして起動・操作することも可能です。|https://aria2.github.io/|{{Pkg|aria2}}}}
* {{App|Axel|Featherweight command line download accelerator sitting at under 250kB on disk. Supports HTTP/S and FTP.|https://github.com/eribertomota/axel|{{Pkg|axel}}}}
* {{App|[[Wikipedia:cURL|cURL]]|An URL retrieval utility and library. Supports HTTP, FTP and SFTP.|https://curl.haxx.se/|{{Pkg|curl}}}}
* {{App|HTTPie|Human-friendly command-line HTTP client for the API era.|https://github.com/httpie/httpie|{{Pkg|httpie}}}}
* {{App|[[Wikipedia:HTTrack|HTTrack]]|An easy-to-use offline browser utility. It allows you to download a World Wide Web site from the Internet to a local directory, building recursively all directories, getting HTML, images, and other files from the server to your computer.|https://www.httrack.com/|{{Pkg|httrack}}}}
* {{App|[[Wikipedia:Lftp|LFTP]]|Sophisticated file transfer program. Supports HTTP, FTP, SFTP, FISH, and BitTorrent.|https://lftp.yar.ru/|{{Pkg|lftp}}}}
* {{App|mps-youtube|Terminal based YouTube jukebox with playlist management. Plays audio/video through mplayer/mpv.|https://github.com/mps-youtube/mps-youtube|{{Pkg|mps-youtube}}}}
* {{App|Plowshare|A set of command-line tools designed for managing file-sharing websites (aka Hosters).|https://github.com/mcrapet/plowshare|{{Pkg|plowshare}}}}
* {{App|[[Wikipedia:RTMPDump|RTMPDump]]|Download FLV videos through RTMP (Adobe's proprietary protocol for Flash video players)|http://rtmpdump.mplayerhq.hu/|{{Pkg|rtmpdump}}}}
* {{App|snarf|Command-line URL retrieval tool. Supports HTTP and FTP.|https://www.xach.com/snarf/|{{Pkg|snarf}}}}
* {{App|[[Streamlink]]|Launch streams from various streaming services in a custom video player or save them to a file.|https://streamlink.github.io/|{{Pkg|streamlink}}}}
* {{App|[[Wikipedia:Streamripper|Streamripper]]|Records and splits streaming mp3 into tracks.|http://streamripper.sourceforge.net/|{{AUR|streamripper}}}}
* {{App|You-Get|Download media contents (videos, audios, images) from the Web.|https://you-get.org/|{{Pkg|you-get}}}}
* {{App|[[youtube-dl]]|YouTube and many other web sites から動画をダウンロード。|https://rg3.github.io/youtube-dl/|{{Pkg|youtube-dl}}}}
* {{App|youtube-viewer|Command line utility for viewing YouTube videos.|https://github.com/trizen/youtube-viewer|{{AUR|youtube-viewer}}}}
* {{App|yt-dlp|A youtube-dl fork with additional features and fixes.|https://github.com/yt-dlp/yt-dlp|{{Pkg|yt-dlp}}}}
* {{App|[[Wikipedia:Wget|Wget]]|A network utility to retrieve files from the Web. Supports HTTP and FTP.|https://www.gnu.org/software/wget/|{{Pkg|wget}}}}

===== Graphical =====

* {{App|ClipGrab|Downloader and converter for YouTube, Vimeo and many other online video sites.|https://clipgrab.org/|{{Pkg|clipgrab}}}}
* {{App|FatRat|HTTP, FTP, SFTP, BitTorrent, Metalink などをサポートしている Qt ベースのダウンロードマネージャ。|https://github.com/LubosD/fatrat|{{AUR|fatrat-git}}}}
* {{App|Forklift|Simple GUI for youtube-dl using PyGObject.|https://github.com/Johnn3y/Forklift|{{AUR|forklift-git}}}}
* {{App|FreeRapid|Java-based downloader that supports downloading from file-sharing services.|https://wordrider.net/freerapid/|{{AUR|freerapid}}}}
* {{App|gtk-youtube-viewer|GTK utility for viewing YouTube videos.|https://github.com/trizen/youtube-viewer|{{AUR|youtube-viewer}} + {{Pkg|perl-gtk3}} + {{Pkg|perl-file-sharedir}}}}
* {{App|[[Wikipedia:Wget#GWget|Gwget]]|GNOME のダウンロードマネージャ。Supports HTTP and FTP.|https://gitlab.gnome.org/Archive/gwget|{{Pkg|gwget}}}}
* {{App|Gydl|GUI wrapper around the already existing youtube-dl program to download content from sites like YouTube.|https://github.com/JannikHv/gydl|{{AUR|gydl-git}}}}
* {{App|Gyre|GTK3 downloader for videos from Coub.|https://github.com/HelpSeeker/Gyre|{{AUR|gyre}}}}
* {{App|[[JDownloader]]|Java-based downloader for one-click hosting sites.|https://jdownloader.org/|{{AUR|jdownloader2}}}}
* {{App|[[Wikipedia:KGet|KGet]]|DKDE のダウンロードマネージャ。HTTP, FTP, BitTorrent, Metalink をサポート。{{Grp|kde-network}} に含まれています。|https://apps.kde.org/kget/|{{Pkg|kget}}}}
* {{App|MegaBasterd|Yet another unofficial MEGA downloader/uploader/streaming suite.|https://github.com/tonikelope/megabasterd|{{AUR|megabasterd-bin}}}}
* {{App|Motrix|Full-featured download manager that supports downloading HTTP, FTP, BitTorrent, Magnet, etc. Based on the [https://electronjs.org/ Electron] platform.|https://motrix.app/|{{AUR|motrix}}}}
* {{App|Persepolis|Graphical front-end for aria2 download manager with lots of features. Supports HTTP and FTP.|https://persepolisdm.github.io/|{{Pkg|persepolis}}}}
* {{App|[[pyLoad]]|Downloader written in Python and designed to be extremely lightweight, easily extensible and fully manageable via web.|https://pyload.net/|{{AUR|pyload-git}}{{Broken package link|package not found}}}}
* {{App|Steadyflow|Simple download manager for GNOME. Supports HTTP and FTP.|https://launchpad.net/steadyflow|{{Pkg|steadyflow}}}}
* {{App|Streamtuner2|Internet radio station and video browser. It simply lists stations in categories from different directories and launches your preferred media apps for playback.|https://sourceforge.net/projects/streamtuner2/|{{AUR|streamtuner2}}}}
* {{App|uGet|GTK ダウンロードマネージャ。ダウンロードの分類や HTML のインポートができます。Supports HTTP, FTP, BitTorrent, Metalink, YouTube and Mega.|https://ugetdm.com/|{{Pkg|uget}}}}
* {{App|Video Downloader|GTK application to download videos from websites like YouTube and many others (based on youtube-dl).|https://github.com/Unrud/video-downloader|{{AUR|video-downloader}}}}
* {{App|Xtreme Download Manager|Powerful tool to increase download speed up-to 500%. Supports HTTP and FTP. Video grabber works in a general way and is not limited to certain websites.|https://subhra74.github.io/xdm/|{{AUR|xdman}}}}
* {{App|youtubedl-gui|Simple-to-use graphical interface for youtube-dl.|https://github.com/JaGoLi/ytdl-gui|{{AUR|youtubedl-gui}}}}

==== LAN file transfer ====

See also [[#LAN messengers]].

* {{App|LAN Share|Cross platform local area network file transfer application, built using Qt GUI framework. It can be used to transfer a whole folder, one or more files, large or small immediately without any additional configuration.|https://github.com/abdularis/LAN-Share|{{AUR|lanshare}}}}
* {{App|NitroShare|Cross-platform network file transfer application, built using Qt GUI framework. It is designed to make transferring files from one device to another on the local network extremely simple.|https://nitroshare.net/|{{Pkg|nitroshare}}}}
* {{App|Teleport|Native GTK3 app to effortlessly share files on the local network.|https://gitlab.gnome.org/jsparber/teleport|{{AUR|teleport-share-git}}}}
* {{App|Warpinator|GTK app to share files across the LAN.|https://github.com/linuxmint/warpinator|{{Pkg|warpinator}}}}

==== クラウドストレージサーバー ====

* {{App|[[Cozy]]|A personal cloud you can hack, host and delete.|https://cozy.io/|{{Pkg|cozy-stack}}}}
* {{App|[[Nextcloud]]|あなたが管理するハードウェアで集中的にファイルを保存できるクラウドサーバー。|https://nextcloud.com|{{Pkg|nextcloud}}}}
* {{App|[[Pydio]]|Mature open source web application for file sharing and synchronization.|https://pydio.com/|{{AUR|pydio}}}}
* {{App|[[Seafile]]|オンラインファイルストレージ・コラボレーションツール with advanced support for file syncing, privacy protection and teamwork.|https://www.seafile.com/|{{AUR|seafile-server}}}}

==== Cloud synchronization clients ====

{{Tip|<nowiki></nowiki>
* Some [[同期およびバックアッププログラム]] provide direct support for some cloud-storage services.
* Some [[FUSE#List of FUSE filesystems|FUSE filesystems]] provide a way to mount cloud-storage as a filesystem. Google Drive can be accessed also by {{Pkg|gvfs-google}} for GVFS-based applications (like [[Nautilus]]), and by {{Pkg|kio-gdrive}} for KIO-based applications (like [[Dolphin]]).
* See [[保存データ暗号化#クラウドストレージの最適化]] to achieve zero-knowledge (client-side transparent encryption) storage on any third-party cloud service.
}}

===== Multi-protocol clients =====

* {{App|CloudCross|Synchronize local files and folders with many cloud providers. Mail.ru Cloud, Yandex Disk, Google Drive, OneDrive and Dropbox support is available.|https://cloudcross.mastersoft24.ru/|{{AUR|cloudcross}}}}
* {{App|Rclone|Multi-provider sync, copy, and mount client.|https://rclone.org/|{{Pkg|rclone}}}}
* {{App|Rclone Browser|GUI client for Rclone.|https://github.com/kapitainsky/RcloneBrowser|{{AUR|rclone-browser}}}}

===== Google Drive clients =====

* {{App|drive|Tiny program to pull or push Google Drive files.|https://github.com/odeke-em/drive|{{AUR|drive-bin}}, {{AUR|drive-git}}}}
* {{App|DriveSync|Command line utility that synchronizes your Google Drive files with a local folder on your machine.|https://github.com/MStadlmeier/drivesync|{{AUR|drivesync}}}}
* {{App|gdrive|Command line utility for interacting with Google Drive.|https://github.com/prasmussen/gdrive|{{AUR|gdrive}}}}
* {{App|Grive|Google Drive client with support for new Drive REST API and partial sync.|https://github.com/vitalif/grive2|{{AUR|grive}}}}
* {{App|[[Insync]]|Unofficial proprietary Google Drive desktop client.|https://www.insynchq.com/|{{AUR|insync}}}}
* {{App|ODrive|Google Drive GUI based on the [https://electronjs.org/ Electron] platform.|https://github.com/liberodark/ODrive|{{AUR|odrive-bin}}}}
* {{App|VGrive|GTK-based GUI client (back-end and front-end) for Google Drive made in Vala.|https://github.com/bcedu/VGrive|{{AUR|vgrive}}}}

===== Other synchronization clients =====

* {{App|aws-cli|CLI for Amazon Web Services, including efficient file transfers to and from Amazon S3.|https://aws.amazon.com/cli/|{{Pkg|aws-cli}}}}
* {{App|Backblaze B2|Backblaze B2 open-source command-line client.|https://www.backblaze.com/b2/cloud-storage.html|{{AUR|backblaze-b2}}}}
* {{App|Baidu Netdisk|Proprietary client for cloud storage service launched by Baidu (formerly Baidu Cloud).|https://pan.baidu.com|{{AUR|baidunetdisk-bin}}}}
* {{App|[[Cozy]] Drive|Desktop client for Cozy.|https://cozy-labs.github.io/cozy-desktop/|{{Pkg|cozy-desktop}}}}
* {{App|[[Dropbox]]|Proprietary desktop client for Dropbox.|https://www.dropbox.com/|{{AUR|dropbox}}}}
* {{App|hubiC|Proprietary synchronization client service and command line tools for hubiC.|https://hubic.com/en/downloads|{{AUR|hubic}}}}
* {{App|[[Wikipedia:Mega (service)|Mega]] Sync Client|Proprietary desktop client to sync files with Mega.|https://mega.nz/|{{AUR|megasync}}}}
* {{App|Megatools|Unofficial CLI for Mega.|https://megatools.megous.com/|{{AUR|megatools}}}}
* {{App|[[Nextcloud]] Client|Desktop client for Nextcloud.|https://nextcloud.com/|{{Pkg|nextcloud-client}}}}
* {{App|Nutstore|Proprietary desktop client for Nutstore.|https://www.jianguoyun.com/|{{AUR|nutstore}}}}
* {{App|OneDrive|Unofficial CLI for [https://onedrive.live.com/about/ OneDrive].|https://github.com/skilion/onedrive|{{AUR|onedrive}}}}
* {{App|[[Wikipedia:ownCloud|ownCloud]] Desktop Client|Desktop syncing client for ownCloud.|https://owncloud.com/client/|{{Pkg|owncloud-client}}}}
* {{App|pCloud Drive|Proprietary desktop syncing client for pCloud. Based on the [https://electronjs.org/ Electron] platform.|https://www.pcloud.com/download-free-online-cloud-file-storage.html|{{AUR|pcloud-drive}}}}
* {{App|[[Pydio]]Sync|Desktop client for Pydio.|https://pydio.com/|{{AUR|pydio-sync}}}}
* {{App|S3cmd|Unofficial CLI for Amazon S3.|https://s3tools.org/s3cmd|{{Pkg|s3cmd}}}}
* {{App|[[Seafile]] Client|GUI client for Seafile.|https://www.seafile.com/|{{AUR|seafile-client}}}}
* {{App|[[Wikipedia:SpiderOak|SpiderOak]] One|Proprietary client for SpiderOak One.|https://spideroak.com/|{{AUR|spideroak-one}}}}
* {{App|[[Wikipedia:Synology|Synology]] Drive|Proprietary GUI client to sync and share files between a centralized Synology NAS and multiple client computers.|https://www.synology.com/|{{AUR|synology-drive}}}}
* {{App|[[Wikipedia:Tresorit|Tresorit]]|Proprietary desktop syncing client for Tresorit.|https://tresorit.com/download|{{AUR|tresorit}}}}
* {{App|[[Yandex Disk]]|Proprietary CLI for Yandex Disk.|https://disk.yandex.ru/|{{AUR|yandex-disk}}}}

==== FTP ====

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

See also [[Wikipedia:Comparison of FTP client software]].
* {{App|[[Wikipedia:FileZilla|FileZilla]]|高速で信頼性のある FTP, FTPS, SFTP クライアント。|https://filezilla-project.org/|{{Pkg|filezilla}}}}
* {{App|[[Wikipedia:gFTP|gFTP]]|Linux 用のマルチスレッド FTP クライアント。|https://www.gftp.org/|{{Pkg|gftp}}}}
* {{App|ftp|Simple ftp client provided by GNU Inetutils|https://www.gnu.org/software/inetutils/manual/inetutils.html#ftp-invocation|{{Pkg|inetutils}}}}
* {{App|ncftp|FTP を実装するフリーのアプリケーションプログラムのセット。|https://www.ncftp.com/|{{Pkg|ncftp}}}}
* {{App|[[Wikipedia:tnftp|tnftp]]|先進的な機能を持った [[Wikipedia:ja:NetBSD|NetBSD]] 用に開発された FTP クライアント。|http://freshmeat.sourceforge.net/projects/tnftp|{{Pkg|tnftp}}}}

[[Dolphin]], [[GNOME Files]], [[Thunar]] などのファイルマネージャにも FTP 機能はあります。

===== FTP サーバー =====

See also [[Wikipedia:List of FTP server software]].

* {{App|bftpd|小さくて、設定しやすい FTP サーバー。|http://bftpd.sourceforge.net/|{{Pkg|bftpd}}}}
* {{App|ftpd|Simple ftp server provided by GNU Inetutils|https://www.gnu.org/software/inetutils/manual/inetutils.html#ftpd-invocation|{{Pkg|inetutils}}}}
* {{App|[[ProFTPD|proFTPd]]|セキュアでコンフィグラブルな FTP サーバー。|http://www.proftpd.org/|{{AUR|proftpd}}}}
* {{App|[[Pure-FTPd]]|フリーの (BSD ライセンス)、セキュアな、品質の高い、標準規格に準拠した FTP サーバー。|https://www.pureftpd.org/project/pure-ftpd/|{{AUR|pure-ftpd}}}}
* {{App|[[SSH]]|SFTP は高信頼性のデータストリームでファイルアクセス・転送・管理を行うネットワークプロトコルです。|https://www.openssh.com|{{Pkg|openssh}}}}
* {{App|[[vsftpd]]|UNIX-ライクシステム用の軽量で安定かつセキュアな FTP サーバー。|https://security.appspot.com/vsftpd.html|{{Pkg|vsftpd}}}}

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

Some [[#Download managers|download managers]] are also able to connect to the BitTorrent network: [[Aria2]], [[Wikipedia:Lftp|LFTP]], FatRat, [[Wikipedia:KGet|KGet]], [[Wikipedia:MLDonkey|MLDonkey]], uGet.

See also [[Wikipedia:Comparison of BitTorrent clients]].

===== コンソール =====

* {{App|Ctorrent|C++ で実装された軽量かつ軽快な BitTorrent クライアント。|https://www.rahul.net/dholmes/ctorrent/|{{AUR|enhanced-ctorrent}}}}
* {{App|[[Deluge]]|BitTorrent client with multiple user interfaces in a client/server model. This package includes a console client.|https://deluge-torrent.org/|{{Pkg|deluge}}}}
* {{App|peerflix|Streaming torrent client for node.js.|https://github.com/mafintosh/peerflix|{{AUR|peerflix}}}}
* {{App|[[rTorrent]]|シンプルで軽量な ncurses BitTorrent クライアント。{{Pkg|libtorrent}} バックエンドが必要です。|https://rakshasa.github.io/rtorrent/|{{Pkg|rtorrent}}}}
* {{App|[[Transmission]] CLI|シンプルで使いやすい BitTorrent クライアント。デーモン版 and multiple フロントエンドが存在します。This package バックエンド・デーモン・コマンドラインインターフェイス・ウェブ UI インターフェイスを含む|https://transmissionbt.com/|{{Pkg|transmission-cli}}}}

===== グラフィカルインターフェイス =====

* {{App|[[Deluge]] (GTK interface)|Python using GTK で書かれたユーザーフレンドリーな BitTorrent クライアント。|https://deluge-torrent.org/|{{Pkg|deluge-gtk}}}}
* {{App|Fragments|Easy to use BitTorrent client for the GNOME desktop environment.|https://gitlab.gnome.org/World/Fragments|{{Pkg|fragments}}}}
* {{App|[[Wikipedia:FrostWire|FrostWire]]|Easy to use cloud downloader, BitTorrent client and media player.|https://www.frostwire.com/|{{AUR|frostwire}}}}
* {{App|[[Ktorrent]]|KDE 向けの高機能な BitTorrent クライアント。|https://apps.kde.org/ktorrent/|{{Pkg|ktorrent}}}}
* {{App|Powder Player|Hybrid between a streaming BitTorrent client and a player. Based on the [https://electronjs.org/ Electron] platform.|https://powder.media/|{{AUR|powder-player-bin}}}}
* {{App|[[Wikipedia:qBittorrent|qBittorrent]]|µtorrent に似ているオープンソースの (GPLv2) BitTorrent クライアント with an integrated torrent search engine.|https://www.qbittorrent.org/|{{Pkg|qbittorrent}}}}
* {{App|[[Wikipedia:Tixati|Tixati]]|BitTorrent プロトコルを使用する proprietary P2P クライアント。|https://tixati.com/|{{AUR|tixati}}}}
* {{App|Torrential|Simple torrent client for elementary OS.|https://github.com/davidmhewitt/torrential|{{Pkg|torrential}}}}
* {{App|[[Transmission]]|シンプルで使いやすい BitTorrent クライアント。デーモン版 and multiple フロントエンドが存在します。|https://transmissionbt.com/|GTK: {{Pkg|transmission-gtk}}, Qt: {{Pkg|transmission-qt}}}}
* {{App|[[Transmission]] Remote|GTK client for remote management of the Transmission BitTorrent client, using its HTTP RPC protocol.|https://github.com/transmission-remote-gtk/transmission-remote-gtk|{{Pkg|transmission-remote-gtk}}}}
* {{App|Tremotesf|Qt client for remote management of the Transmission BitTorrent client, using its HTTP RPC protocol.|https://github.com/equeim/tremotesf2|{{AUR|tremotesf}}}}
* {{App|[[Wikipedia:Tribler|Tribler]]|第4世代ファイル共有システム型 bittorrent クライアント。|https://www.tribler.org|{{AUR|tribler}}}}
* {{App|[[Wikipedia:Vuze|Vuze]]|Java で書かれた高機能な BitTorrent クライアント (旧名 Azureus)。|https://www.vuze.com/|{{AUR|vuze}}}}
* {{App|WebTorrent Desktop|Streaming BitTorrent application. Based on the [https://electronjs.org/ Electron] platform.|https://webtorrent.io/desktop/|{{AUR|webtorrent-desktop}}}}

==== 他の P2P ネットワーク ====

See also [[Wikipedia:Comparison of file-sharing applications]].

* {{App|[[aMule]]|有名な eDonkey/Kad クライアント。デーモン版、GTK、ウェブ、CLI フロントエンド。|https://www.amule.org/|{{Pkg|amule}}}}
* {{App|EiskaltDC++|Direct Connect and ADC client.|https://github.com/eiskaltdcpp/eiskaltdcpp|GTK: {{AUR|eiskaltdcpp-gtk}}, Qt: {{AUR|eiskaltdcpp-qt}}}}
* {{App|[[Wikipedia:gtk-gnutella|gtk-gnutella]]|GTK server/client for the Gnutella peer-to-peer network.|http://gtk-gnutella.sourceforge.net/|{{AUR|gtk-gnutella}}}}
* {{App|KaMule|aMule の KDE グラフィカルフロントエンド。|https://www.linux-apps.com/content/show.php?content=150270|{{AUR|kamule}}}}
* {{App|LBRY|Browser and wallet for LBRY, the decentralized, user-controlled content marketplace. Based on the [https://electronjs.org/ Electron] platform.|https://lbry.io/|{{AUR|lbry-app-bin}}}}
* {{App|lbt|Small set of command-line tools for LBRY.|https://gitlab.com/gardenappl/lbt|{{AUR|lbt}}}}
* {{App|[[Wikipedia:MLDonkey|MLDonkey]]|Multi-protocol P2P client that supports HTTP, FTP, BitTorrent, Direct Connect, eDonkey and FastTrack.|http://mldonkey.sourceforge.net/|{{AUR|mldonkey}}}}
* {{App|ncdc|Modern and lightweight Direct Connect and ADC client with a friendly ncurses interface.|https://dev.yorhel.nl/ncdc|{{AUR|ncdc}}}}
* {{App|Nicotine+|A graphical client for the Soulseek P2P network.|https://github.com/Nicotine-Plus/nicotine-plus|{{Pkg|nicotine+}}}}
* {{App|Send Anywhere|Proprietary file sharing service where users can directly share digital content in real time. Based on the [https://electronjs.org/ Electron] platform.|https://send-anywhere.com/|{{AUR|sendanywhere}}}}
* {{App|Valknut|Direct Connect client (like DC++) with segmented downloading.|http://wxdcgui.sourceforge.net/|{{AUR|valknut}}}}

==== Pastebin services ====

See also [[Wikipedia:Pastebin]].

Pastebin services are often used to quote text or images while collaborating and troubleshooting. Pastebin クライアントを使えば、cli から投稿することができるようになります。
{{Note|An acceptable pastebin service does not require enabling JavaScript for viewing, does not display adverts, manipulate the pasted content or require a login.
[https://pastebin.com/ pastebin.com] is blocked for some people because of malware found on the site and has a history of annoying issues (requires JavaScript, displays adverts, inserts CRLF line-endings and displaying CAPTCHAs at random). Do '''not''' use it.}}
===== Without a dedicated client =====
Some services can be used with more general command line tool, such as [[CURL]]. For extensions, such as line numbers, one can use more command line tools. Such as {{ic|cat -n}}.

* [http://ix.io/ ix.io]. Usage examples are:
: {{bc|''command'' <nowiki>|& curl -F 'f:1=<-' ix.io </nowiki>}} or upload a file: {{bc|<nowiki>curl -F 'f:1=<-' ix.io < </nowiki>''file''}}
*[http://sprunge.us/ sprunge.us] has a similar service, and also offers a plain HTML form. Usage examples are:
:{{bc|''command'' <nowiki>|& curl -F 'sprunge=<-' sprunge.us </nowiki>}} or upload a file: {{bc|<nowiki>curl -F 'sprunge=<-' sprunge.us < </nowiki>''file''}}
:Note that you can append {{ic|?<lang>}} to the returned URL to get syntax highlighting for {{ic|<lang>}} (e.g. {{ic|<nowiki>http://sprunge.us/xxxxxx?bash</nowiki>}} for a bash configuration file or script).
:As of December 2021, it also seems that sprunge.us accepts longer input than ix.io.
*[https://termbin.com termbin.com] works with [[nc]].

===== Dedicated clients =====

* {{App|Elmer|wgetpaste や curlpaste に似ている pastebin クライアント。Perl で書かれており usable with wget or curl. サーバー: [http://codepad.org/ codepad.org], [http://rafb.me/ rafb.me], [http://sprunge.us/ sprunge.us].|https://github.com/sudokode/elmer|{{AUR|elmer}}}}
* {{App|Fb-client|https://paste.xinu.at/ paste.xinu.at] pastebin のクライアント。|https://paste.xinu.at|{{Pkg|fb-client}}}}
* {{App|Gist|[https://gist.github.com/ gist.github.com] pastebin サービスのコマンドライン用インターフェース。|https://github.com/defunkt/gist|{{Pkg|gist}}}}
* {{App|imgur|[https://imgur.com imgur.com] 画像共有サービスに画像をアップロードできる CLI クライアント。|https://github.com/tremby/imgur.sh|{{AUR|imgur.sh}}}}
* {{App|Ix|ix.io pastebin のクライアント。|http://ix.io|{{AUR|ix}}}}
* {{App|Pastebinit|Pastebin クライアントとして動く小さな Python スクリプト。サーバー: [http://pastie.org/ pastie.org], [https://paste.kde.org/ paste.kde.org], [https://paste.debian.net/ paste.debian.net], [https://paste.ubuntu.com/ paste.ubuntu.com] など (全てのリストは {{ic|pastebinit -l}} を見てください)。|https://launchpad.net/pastebinit|{{Pkg|pastebinit}}}}
* {{App|ruby-haste|[https://hastebin.com/ hastebin.com] のクライアント。|https://github.com/seejohnrun/haste-client|{{AUR|ruby-haste}}}}
* {{App|Uppity|無愛想な pastebin クライアント。|https://github.com/Kiwi/Uppity|{{AUR|uppity-git}}}}
* {{App|Wgetpaste|多くの pastebin サービスへの投稿を自動化する bash スクリプト。サーバー: [http://pastebin.ca/ pastebin.ca], [http://codepad.org/ codepad.org], [https://dpaste.com/ dpaste.com] and [https://pastebin.osuosl.org/ pastebin.osuosl.org].|http://wgetpaste.zlin.dk/|{{Pkg|wgetpaste}}}}

=== コミュニケーション ===

==== 電子メールクライアント ====

See also [[Wikipedia:Comparison of email clients]]

===== コンソール =====

* {{App|[[aerc]]|Work in progress asynchronous email client.|https://git.sr.ht/~sircmpwn/aerc|{{Pkg|aerc}}}}
* {{App|alot|[https://notmuchmail.org/ notmuch mail] ベースの実験的なターミナル MUA。[http://urwid.org/ urwid] ツールキットを使って python で書かれています。|https://github.com/pazz/alot|{{Pkg|alot}}}}
* {{App|[[Alpine]]|[[Wikipedia:Pine (email client)|Pine]] ベースの高速で使いやすい Apache ライセンスのメールクライアント。|https://alpine.x10host.com/|{{AUR|alpine-git}}}}
* {{App|[[S-nail]]|''ed'' のようなコマンド構文で使えるメール処理システム。[[Wikipedia:mailx|mailx]] の機能を提供します。|https://www.sdaoden.eu/code.html#s-mailx|{{Pkg|s-nail}}}}
* {{App|mu/mu4e|メールインデックス作成プログラム (mu) と emacs 用のクライアント (mu4e)。Xapian による高速検索が使えます。|https://www.djcbsoftware.nl/code/mu/mu4e.html|{{AUR|mu}}}}
* {{App|[[Mutt]]|小さいがパワフルなテキストベースのメールクライアント。|http://www.mutt.org/|{{Pkg|mutt}}}}
* {{App|[[Mutt#NeoMutt|NeoMutt]]|Command line mail reader (or MUA). It's a fork of Mutt with added features.|https://neomutt.org/|{{Pkg|neomutt}}}}
* {{App|[[nmh]]|モジュール式のメール管理システム。|https://www.nongnu.org/nmh/|{{AUR|nmh}}}}
* {{App|[[notmuch]]|''xapian'' 上で動作する高速なメールインデクサ。|https://notmuchmail.org/|{{Pkg|notmuch}}}}
* {{App|sendemail|A lightweight command line SMTP email client written in Perl.|http://caspian.dotconf.net/menu/Software/SendEmail/|{{AUR|sendemail}}}}
* {{App|[[Sup]]|非常に高速な検索、タグ付け、スレッディング、GMail ライクな操作ができる CLI メールクライアント。|https://sup-heliotrope.github.io/|{{AUR|sup}}}}
* {{App|swaks|Swiss Army Knife SMTP; Command line SMTP testing, including TLS and AUTH, can be used to send emails.|https://jetmore.org/john/code/swaks/|{{Pkg|swaks}}}}
* {{App|Wanderlust|Emacs 用のメールクライアント・ニュースリーダー。|http://www.gohome.org/wl/|{{Pkg|wanderlust}}}}

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

* {{App|Balsa|Gnome プロジェクトのシンプルで軽量な電子メールクライアント。|https://pawsa.fedorapeople.org/balsa/|{{Pkg|balsa}}}}
* {{App|[[Wikipedia:Claws Mail|Claws Mail]]|軽量な GTK ベースの電子メールクライアント・ニュースリーダー。|https://www.claws-mail.org/|{{Pkg|claws-mail}}}}
* {{App|ElectronMail|Unofficial desktop app for several end-to-end encrypted email providers (like ProtonMail, Tutanota). Based on the [https://electronjs.org/ Electron] platform.|https://github.com/vladimiry/ElectronMail|{{AUR|electronmail-bin}}}}
* {{App|[[Evolution]]|成熟した高機能な電子メールクライアント that is part of the GNOME project. Part of {{Grp|gnome-extra}}.|https://wiki.gnome.org/Apps/Evolution|{{Pkg|evolution}}}}
* {{App|Geary|[[Wikipedia:ja:Vala|Vala]] で作られたシンプルなデスクトップメールクライアント。|https://wiki.gnome.org/Apps/Geary|{{Pkg|geary}}}}
* {{App|[[Wikipedia:Kmail|Kmail]]|成熟した高機能な電子メールクライアント。Part of {{Grp|kdepim}}{{Broken package link|package not found}}.|https://kontact.kde.org/components/kmail.html|{{Pkg|kmail}}}}
* {{App|Kube|Modern communication and collaboration client built with QtQuick.|https://kube-project.com/|{{Pkg|kube}}}}
* {{App|Mailspring|Fork of [[Wikipedia:Nylas Mail|Nylas Mail]] by one of the original authors. The paid "Pro" version requires a Mailspring ID and has extra features like snooze, send later. Based on the [https://electronjs.org/ Electron] platform.|https://getmailspring.com/|{{AUR|mailspring}}}}
* {{App|openWMail|Gmail & Google Inbox 用のデスクトップクライアント。Based on the [https://electronjs.org/ Electron] platform.|https://openwmail.github.io/|{{AUR|openwmail}}}}
* {{App|[[Wikipedia:SeaMonkey#Mail|SeaMonkey Mail & Newsgroups]]|SeaMonkey スイートに含まれているメールクライアント。|https://www.seamonkey-project.org/|{{Pkg|seamonkey}}}}
* {{App|[[Wikipedia:Sylpheed|Sylpheed]]|軽量でユーザーフレンドリーな GTK 電子メールクライアント。|https://sylpheed.sraoss.jp/en/|{{Pkg|sylpheed}}}}
* {{App|[[Thunderbird]]|Mozilla によって開発されている、GTK で書かれた高機能な電子メールクライアント。|https://www.thunderbird.net/|{{Pkg|thunderbird}}}}
* {{App|Trojitá|Qt IMAP 電子メールクライアント。Only supports [https://bugs.kde.org/show_bug.cgi?id=321374 one IMAP account].|http://trojita.flaska.net/|{{Pkg|trojita}}}}
* {{App|Tutanota|Email client for Tutanota mail service. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/tutao/tutanota|{{AUR|tutanota-desktop}}}}
* {{App|Viagee|It allows desktop mail actions, such as 'Send File as Email' or web 'mailto' links, to be handled by the Gmail web client.|https://davesteele.github.io/viagee/|{{AUR|viagee}}}}

===== Web-based =====

* {{App|[[Wikipedia:Mailpile|Mailpile]]|A modern, fast web-mail client with user-friendly encryption and privacy features.|https://www.mailpile.is/|{{AUR|mailpile}}}}
* {{App|[[Nextcloud]] Mail|An email webapp for NextCloud.|https://github.com/nextcloud/mail|{{Pkg|nextcloud-app-mail}}}}
* {{App|Roundcubemail|ネイティブなアプリケーションのようなインターフェイスがある、ブラウザベースの多言語 IMAP クライアント。|https://roundcube.net/|{{Pkg|roundcubemail}}}}
* {{App|[[Squirrelmail|SquirrelMail]]|Webmail for Nuts!|https://squirrelmail.org/|{{AUR|squirrelmail}}}}

==== Mail notifiers ====

* {{App|Ayatana Webmail|Webmail notifications and actions for any desktop.|https://tari.in/www/software/ayatana-webmail/|{{AUR|ayatana-webmail}}}}
* {{App|Bubblemail|New and Unread mail notification service for local mailboxes, pop, imap, and gnome online accounts. A fork of Mailnag.|http://bubblemail.free.fr/|{{AUR|bubblemail}}}}
* {{App|CheckMails|System tray unread mail checker using IMAP protocol.|https://github.com/j4321/CheckMails|{{AUR|checkmails}}}}
* {{App|Gnubiff|Mail notification program that checks for mail and displays headers when new mail has arrived.|http://gnubiff.sourceforge.net/|{{Pkg|gnubiff}}}}
* {{App|Mailnag|Extensible mail notification daemon.|https://github.com/pulb/mailnag|{{Pkg|mailnag}}}}
* {{App|QGmailNotifier|Portable Qt5 based GMail notifier.|https://github.com/eteran/qgmailnotifier|{{AUR|qgmailnotifier}}}}

==== メールサーバー ====

See [[メールサーバー]].

* {{App|DavMail|POP/IMAP/SMTP/Caldav/Carddav/LDAP exchange gateway allowing users to use any mail/calendar client with an Exchange server.|http://davmail.sourceforge.net/|{{AUR|davmail}}}}
* {{App|Modoboa|A modular mail hosting and management platform, written in Python.|https://modoboa.org/|{{AUR|modoboa}}}}

==== Mail retrieval agents ====

See also [[Wikipedia:Mail retrieval agent]].

* {{App|[[fdm]]|Program to fetch and deliver mail.|https://github.com/nicm/fdm|{{Pkg|fdm}}}}
* {{App|[[Wikipedia:Fetchmail|Fetchmail]]|A remote-mail retrieval utility.|https://www.fetchmail.info/|{{Pkg|fetchmail}}}}
* {{App|[[getmail]]|A POP3/IMAP4 mail retriever with reliable Maildir and command delivery.|http://pyropus.ca/software/getmail/|{{AUR|getmail}}}}
* {{App|hydroxide|A third-party, open-source ProtonMail CardDAV, IMAP and SMTP bridge|https://github.com/emersion/hydroxide|{{AUR|hydroxide}}}}
* {{App|imapsync|IMAP synchronisation, sync, copy or migration tool|https://imapsync.lamiral.info/|{{Pkg|imapsync}}}}
* {{App|[[isync]]|IMAP and MailDir mailbox synchronizer|http://isync.sourceforge.net/|{{Pkg|isync}}}}
* {{App|mpop|A small, fast POP3 client suitable as a fetchmail replacement|https://marlam.de/mpop/|{{Pkg|mpop}}}}
* {{App|[[OfflineIMAP]]|Synchronizes emails between two repositories.|https://www.offlineimap.org/|{{Pkg|offlineimap}}}}

==== インスタントメッセージクライアント ====

See also [[Wikipedia:Comparison of instant messaging clients]] and [[Wikipedia:Comparison of VoIP software]].

このセクションでは[[Wikipedia:ja:インスタントメッセージ|インスタントメッセージ]]をサポートしている全てのソフトウェアを並べています。

===== マルチプロトコルクライアント =====

{{Note|このセクションの全てのメッセンジャーは、直接接続することで複数のネットワークをサポートしています。}}

これらのクライアントによってサポートされているネットワークの数は多いですが、（マルチプロトコルクライアントのご多分に漏れず）ネットワークごとの特有の機能は制限があったりサポートされていません。

====== コンソール ======

* {{App|BarnOwl|ncurses ベースのチャットクライアント。Zephyr, XMPP, IRC, Twitter プロトコルをサポート。|https://barnowl.mit.edu/|{{AUR|barnowl}}}}
* {{App|[[Bitlbee|BitlBee]]|人気のあるチャットネットワーク (XMPP, ICQ, Twitter) に接続できる IRC クライアント。|https://bitlbee.org/|{{AUR|bitlbee}}}}
* {{App|[[Wikipedia:Centericq|CenterIM]]|テキストモードメニューとウィンドウドリブンな IM インターフェースを持つ。Supports most of widely used IM protocols, including ICQ, IRC, XMPP.|http://centerim.org/|{{AUR|centerim}}}}
* {{App|EKG2|Ncurses based XMPP, Gadu-Gadu, ICQ and IRC client.|https://github.com/ekg2/ekg2|{{AUR|ekg2}}}}
* {{App|Finch|libpurple を使っている ncurses ベースのチャットクライアント and supports all its protocols (Bonjour, Gadu-Gadu, Groupwise, ICQ, IRC, SIMPLE, XMPP, Zephyr).|https://developer.pidgin.im/wiki/Using%20Finch|{{Pkg|finch}}}}
* {{App|[[WeeChat]]|モジュール式で軽量な ncurses ベース IRC クライアント。A variety of other protocols are supported through plugins.|https://weechat.org/|{{Pkg|weechat}}}}

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

* {{App|[[Wikipedia:Jitsi|Jitsi]]|Java で書かれたオーディオ・ビデオ VoIP 電話とインスタントメッセンジャー that supports protocols such as SIP, XMPP, ICQ, IRC and many other useful features.|https://jitsi.org/|{{AUR|jitsi}}}}
* {{App|[[Wikipedia:Kopete|Kopete]]|Bonjour, Gadu-Gadu, GroupWise, ICQ, XMPP などをサポートしているユーザーフレンドリーな IM。|https://apps.kde.org/kopete/|{{Pkg|kopete}}}}
* {{App|[[KDE#KDE Telepathy|KDE Telepathy]]|[[Wikipedia:ja:Telepathy|Telepathy]] フレームワークを使っている KDE のインスタントメッセージクライアント。Kopete に代わるものとして開発されました。|https://userbase.kde.org/Telepathy|{{Pkg|telepathy-kde-meta}}}}
* {{App|Lith|WeeChat Relay client, allowing to connect to a running WeeChat instance from anywhere.|https://lith.app/|{{AUR|lith-git}}}}
* {{App|[[Pidgin]]|マルチプロトコル・インスタントメッセージクライアント with audio support that uses libpurple and supports all its protocols (Bonjour, Gadu-Gadu, Groupwise, ICQ, IRC, SIMPLE, XMPP, Zephyr).|https://pidgin.im/|{{Pkg|pidgin}}}}
* {{App|qutIM|シンプルでユーザーフレンドリーな IM。ICQ, XMPP, Mail.Ru, IRC, VKontakte をサポート。|https://qutim.org/|{{AUR|qutim}}}}
* {{App|[[Wikipedia:Smuxi|Smuxi]]|クロスプラットフォーム IRC クライアント that also supports Twitter and XMPP. |https://smuxi.im/|{{AUR|smuxi}}}}
* {{App|[[Thunderbird]]|Feature-rich email client supports instant messaging and chat using IRC and XMPP.|https://www.thunderbird.net/|{{Pkg|thunderbird}}}}
* {{App|Volt|Proprietary native desktop client for Skype, Telegram, Slack, XMPP, Discord, IRC and more. |https://volt-app.com/|{{AUR|volt}}}}

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

See also [[Wikipedia:Comparison of Internet Relay Chat clients]].

====== コンソール ======

* {{App|[[Wikipedia:BitchX|BitchX]]|人気の [[Wikipedia:ircII|ircII]] から開発されたコンソールベースの IRC クライアント。|http://www.bitchx.org/|{{AUR|bitchx-git}}}}
* {{App|ERC|パワフルな、モジュール式の、拡張性のある [[Emacs]] 用 IRC クライアント。|https://savannah.gnu.org/projects/erc/|included with {{Pkg|emacs}}}}
* {{App|[[Wikipedia:Ii (IRC client)|ii]]|フェザー級の IRC クライアント。文字通り {{ic|tail -f}} で会話して {{ic|echo}} で返事をファイルに出力する。|https://tools.suckless.org/ii/|{{AUR|ii}}}}
* {{App|ircii|Oldest maintained IRC client which lays claim to being small and fast owing to its reduced feature set.|http://www.eterna.com.au/ircii/|{{AUR|ircii}}}}
* {{App|[[Irssi]]|細かく設定ができる ncurses ベースの IRC クライアント。|https://irssi.org/|{{Pkg|irssi}}}}
* {{App|pork|プログラマブルで、ncurses ベースの IRC クライアント。ircII と雰囲気が似ています。|http://dev.ojnk.net/|{{Pkg|pork}}}}
* {{App|ScrollZ|[[Wikipedia:ircII|ircII]] がベースの先進的な IRC クライアント。|https://www.scrollz.info/|{{AUR|scrollz}}}}
* {{App|sic|[[Wikipedia:Ii (IRC client)|ii]] に似た極端にシンプルな IRC クライアント。|https://tools.suckless.org/sic/|{{AUR|sic}}}}
* {{App|tiny|an IRC client written in Rust with a clutter-free interface|https://github.com/osa1/tiny|{{AUR|tiny-irc-client-git}}}}

'''Comparison'''

{| class="wikitable sortable"
! Name !! Package !! Written in !! Extensible !! [[Wikipedia:Simple Authentication and Security Layer|SASL]]
|-
! [[Wikipedia:BitchX|BitchX]]
| {{AUR|bitchx-git}} || C || {{C|?}} || {{C|?}}
|-
! [https://savannah.gnu.org/projects/erc/ ERC]
| {{Pkg|emacs}} || ELisp || {{G|in ELisp}} || {{Y|[https://www.emacswiki.org/emacs/ErcSASL via script]}}
|-
! [[Wikipedia:Ii (IRC client)|ii]]
| {{AUR|ii}} || C || {{G|stdin/stdout}} || {{No}}
|-
! [[Irssi]]
| {{Pkg|irssi}} || C || {{G|in Perl}} || {{Yes}}
|-
! [http://dev.ojnk.net/ pork]
| {{Pkg|pork}} || C || {{G|in Perl}} || {{No}}
|-
! [https://www.scrollz.info/ ScrollZ]
| {{AUR|scrollz}} || C || {{C|?}} || {{No}}
|-
! [https://tools.suckless.org/sic/ sic]
| {{AUR|sic}} || C || {{G|stdin/stdout}} || {{No}}
|-
! [https://github.com/osa1/tiny tiny]
| {{AUR|tiny-irc-client-git}} || Rust || {{No}} || {{Yes}}
|-
! [[WeeChat]]
| {{Pkg|weechat}} || C || {{G|[https://weechat.org/files/doc/stable/weechat_scripting.en.html multiple languages]}} || {{Yes}}
|}

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

* {{App|[[Wikipedia:ChatZilla|ChatZilla]]|Clean, easy to use and highly extensible Internet Relay Chat (IRC) client, built on the Mozilla platform using [[Wikipedia:XULRunner|XULRunner]]. Included in the [[Wikipedia:SeaMonkey|SeaMonkey]] suite.|http://chatzilla.hacksrus.com/|{{Pkg|seamonkey}}}}
* {{App|[[HexChat]]|XChat フォーク。Linux と Windows に対応。|https://hexchat.github.io/|{{Pkg|hexchat}}}}
* {{App|[[Wikipedia:Konversation|Konversation]]|KDE デスクトップ向け Qt ベースの IRC クライアント。|https://konversation.kde.org/|{{Pkg|konversation}}}}
* {{App|[[Wikipedia:KVIrc|KVIrc]]|テーマをサポートしている Qt ベースの IRC クライアント。|http://kvirc.net/|{{Pkg|kvirc}}}}
* {{App|Loqui|GTK IRC クライアント。|https://loqui.sunnyone.org/|{{AUR|loqui}}}}
* {{App|LostIRC|タブ自動補完、マルチサーバーサポート, logging などが特徴のシンプルな GTK IRC クライアント。|http://lostirc.sourceforge.net|{{AUR|lostirc}}}}
* {{App|Polari|GNOME プロジェクトによるシンプルな IRC クライアント。|https://wiki.gnome.org/Apps/Polari|{{Pkg|polari}}}}
* {{App|[[Quassel]]|近代的で、クロスプラットフォームの、分散型 IRC クライアント。|https://quassel-irc.org/|KDE: {{Pkg|quassel-monolithic}}, Qt: {{Pkg|quassel-monolithic-qt}}}}
* {{App|Srain|Modern, beautiful IRC client written in GTK 3.|https://srain.im/|{{AUR|srain}}}}

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

See also [[Wikipedia:XMPP]] and [[Wikipedia:Comparison of instant messaging clients#XMPP-related features]].

====== コンソール ======

* {{App|Freetalk|コンソールベースの XMPP クライアント。|https://www.gnu.org/software/freetalk/|{{AUR|freetalk}}}}
* {{App|jabber.el|[[Emacs]] 用の最小 Jabber クライアント。|http://emacs-jabber.sourceforge.net/|{{AUR|emacs-jabber}}}}
* {{App|jp (Salut à Toi)|Salut à Toi 用の CLI フロントエンド、多目的 XMPP クライアント。|https://salut-a-toi.org/|{{AUR|sat-jp}}}}
* {{App|[[Wikipedia:MCabber|MCabber]]|小さな XMPP クライアント。機能: SSL, PGP, MUC, OTR, UTF8.|https://mcabber.com/|{{Pkg|mcabber}}}}
* {{App|Poezio|IRC のような使い心地の XMPP クライアント。|https://poez.io/|{{AUR|poezio}}}}
* {{App|Primitivus (Salut à Toi)|Salut à Toi 用のコンソールフロントエンド、多目的 XMPP クライアント。|https://salut-a-toi.org/|{{AUR|sat-primitivus}}}}
* {{App|Profanity|Irssi からインスパイアされたコンソールベースの XMPP クライアント。|https://profanity-im.github.io/|{{Pkg|profanity}}}}
* {{App|xmpp-client|OTR に対応するミニマルな XMPP クライアント。|https://github.com/agl/xmpp-client|{{AUR|go-xmpp-client}}{{Broken package link|package not found}}}}

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

* {{App|Cagou (Salut à Toi)|Desktop/mobiles frontend for Salut à Toi, multi-purpose XMPP client|https://salut-a-toi.org/|{{AUR|sat-cagou-hg}}}}
* {{App|Converse.js|Web-based XMPP chat client written in JavaScript.|https://conversejs.org/|{{AUR|conversejs-git}}}}
* {{App|Dino|A modern, easy to use XMPP client, with PGP and OMEMO support.|https://dino.im/|{{Pkg|dino}}}}
* {{App|[[Gajim]]|XMPP client with audio support written in Python using GTK.|https://gajim.org/|{{Pkg|gajim}}}}
* {{App|Kaidan|A simple, user-friendly Jabber/XMPP client providing a modern user interface using Kirigami and QtQuick.|https://www.kaidan.im/|{{AUR|kaidan}}}}
* {{App|[[Wikipedia:Kadu (software)|Kadu]]|Qt-based XMPP and Gadu-Gadu client.|http://www.kadu.im/|{{AUR|kadu}}}}
* {{App|Libervia (Salut à Toi)|Web frontend for Salut à Toi, multi-purpose XMPP client|https://salut-a-toi.org/|{{AUR|sat-libervia-hg}}}}
* {{App|Nextcloud JavaScript XMPP Client|Chat app for Nextcloud with XMPP, end-to-end encryption, video calls, file transfer & group chat.|https://github.com/nextcloud/jsxc.nextcloud|{{AUR|nextcloud-app-jsxc}}}}
* {{App|[[Wikipedia:Psi (instant messaging client)|Psi]]|Qt ベースの XMPP クライアント。|https://psi-im.org/|{{Pkg|psi}} or {{Pkg|psi-nowebengine}}}}
* {{App|[[Wikipedia:Spark (XMPP client)|Spark]]|Cross-platform real-time XMPP collaboration client optimized for business and organizations.|https://www.igniterealtime.org/projects/spark/|{{AUR|spark}}}}
* {{App|Swift|XMPP client written in C++ with Qt and Swiften.|https://swift.im/|{{Pkg|swift-im}}}}
* {{App|[[Wikipedia:Tkabber|Tkabber]]|Easy to hack ejabberd XMPP サーバーの作者による機能豊富な XMPP クライアント。|http://tkabber.jabber.ru/|{{AUR|tkabber}}}}
* {{App|Vacuum IM|Full-featured crossplatform XMPP client.|https://github.com/Vacuum-IM/vacuum-im|{{AUR|vacuum-im}}}}

===== SIP clients =====

See also [[Wikipedia:List of SIP software#Clients]].

* {{App|[[Wikipedia:Blink (SIP client)|Blink]]|最新の使いやすい SIP クライアント。|https://icanblink.com/|{{AUR|blink}}}}
* {{App|[[Jami]]|SIP-compatible softphone and instant messenger for the decentralized Jami network. Formerly known as Ring and SFLphone.|https://jami.net/|{{Pkg|jami-gnome}}}}
* {{App|[[Wikipedia:Linphone|Linphone]]|インターネットを通じて自由に音声、ビデオ、テキストメッセージでコミュニケーションできる VoIP フォンアプリケーション (SIP client)。|https://www.linphone.org/|{{AUR|linphone-desktop}}}}
* {{App|[[Wikipedia:Twinkle (software)|Twinkle]]|SIP を使った VoIP や IM コミュニケーションの Qt ソフトフォン。|http://twinkle.dolezel.info/|{{AUR|twinkle}}}}
* {{App|Zoiper|Proprietary SIP and IAX2 VoIP softphone|https://zoiper.com|{{AUR|zoiper}}}}

===== Matrix clients =====

See also [[Matrix]] and [https://matrix.org/clients/ Matrix Clients].

* {{App|Element|Glossy Matrix client with an emphasis on performance and usability. Web application and desktop application based on the [https://electronjs.org/ Electron] platform.|https://element.io/|{{Pkg|element-web}}, {{Pkg|element-desktop}}}}
* {{App|FluffyChat|Multi-platform Matrix client with a simple and clean UI written in Dart/Flutter.|https://fluffychat.im/|{{AUR|fluffychat}}}}
* {{App|Fractal|Matrix client for GNOME written in Rust.|https://wiki.gnome.org/Apps/Fractal|{{Pkg|fractal}}}}
* {{App|Gomuks|Terminal Matrix client written in Go using [https://github.com/tulir/mautrix-go mautrix] and [https://github.com/tulir/mauview mauview].|https://maunium.net/go/gomuks|{{AUR|gomuks}}}}
* {{App|Mirage|A fancy, customizable, keyboard-operable Matrix chat client for encrypted and decentralized communication. Written in Qt/QML + Python with nio, currently in alpha.|https://github.com/mirukana/mirage|{{AUR|matrix-mirage}}, {{AUR|matrix-mirage-git}}}}
* {{App|Neochat|KDE client for the Matrix protocol.|https://apps.kde.org/neochat/|{{Pkg|neochat}}}}
* {{App|nheko|Desktop client for the Matrix protocol.|https://github.com/Nheko-Reborn/nheko|{{AUR|nheko}}, {{AUR|nheko-git}}}}
* {{App|Quaternion|Qt5-based IM client for the Matrix protocol.|https://github.com/QMatrixClient/Quaternion|{{AUR|quaternion}}}}
* {{App|SchildiChat|Matrix client based on Element with a more traditional instant messaging experience. Based on the [https://electronjs.org/ Electron] platform.|https://schildi.chat/|{{AUR|schildichat-desktop-bin}}}}
* {{App|Spectral|Qt5-based Glossy cross-platform client for Matrix.|https://gitlab.com/spectral-im/spectral|{{AUR|spectral-matrix}}}}
* {{App|Syphon|Privacy-centric cross-platform Matrix client with E2EE support, currently in alpha.|https://github.com/syphon-org/syphon|{{AUR|syphon-bin}}}}

===== Tox clients =====

See also [[Tox]].

* {{App|qTox|Powerful Tox client written in C++/Qt that follows the Tox design guidelines.|https://qtox.github.io/|{{Pkg|qtox}}}}
* {{App|ratox|FIFO based tox client.|https://git.z3bra.org/ratox/file/README.html|{{AUR|ratox-git}}}}
* {{App|Toxic|ncurses-based Tox client|https://github.com/Jfreegman/toxic|{{Pkg|toxic}}}}
* {{App|Toxygen|Tox client written in pure Python3.|https://github.com/toxygen-project/toxygen|{{AUR|toxygen-git}}}}
* {{App|Venom|a modern Tox client for the GNU/Linux desktop|https://github.com/naxuroqa/Venom|{{AUR|venom}}}}
* {{App|µTox|Lightweight Tox client.|https://github.com/uTox/uTox|{{Pkg|utox}}}}

===== LAN メッセンジャー =====

See also [[Avahi#Link-Local (Bonjour/Zeroconf) chat]] and [[Wikipedia:Comparison of LAN messengers]].

* {{App|BeeBEEP|Secure LAN Messenger.|https://www.beebeep.net/|{{Pkg|beebeep}}}}
* {{App|iptux|LAN 通信ソフトウェア。IP Messenger と互換性あり。|https://github.com/iptux-src/iptux|{{Pkg|iptux}}}}
* {{App|LAN Messenger|P2P chat application for intranet communication and does not require a server. A variety of handy features are supported including notifications, personal and group messaging with encryption, file transfer and message logging.|https://lanmessenger.github.io/|{{AUR|lmc}}}}

===== P2P messaging clients =====

See also [[Ring]] and [[Tox]].

* {{App|[[Bitmessage]]|Decentralized and trustless P2P communications protocol for sending encrypted messages to another person or to many subscribers.|https://bitmessage.org/|{{AUR|pybitmessage}}}}
* {{App|[[Wikipedia:Briar (software)|Briar]]|Briar is a messaging app designed for activists, journalists, and anyone else who needs a safe, easy and robust way to communicate.|https://briarproject.org/|{{AUR|briar-gtk}}, {{AUR|briar-headless}}, {{AUR|python-briar-wrapper}}}}
* {{App|Patchwork|Decentralized messaging and sharing app built on top of Secure Scuttlebutt (SSB). Based on the [https://electronjs.org/ Electron] platform.|https://github.com/ssbc/patchwork|{{AUR|ssb-patchwork}}}}
* {{App|[[RetroShare]]|Serverless encrypted instant messenger with filesharing, chatgroups, mail.|https://retroshare.cc/|{{AUR|retroshare}}}}
* {{App|[[Wikipedia:Ricochet (software)|Ricochet]]|[[Tor]] サービスを基にして作成された匿名のピアツーピアによるインスタントメッセージシステム。|https://ricochet.im/|{{AUR|ricochet}}}}

===== その他 IM clients =====

* {{App|BlueJeans|Proprietary desktop application for BlueJeans video calls. Based on the [https://electronjs.org/ Electron] platform.|https://www.bluejeans.com/|{{AUR|bluejeans}}}}
* {{App|Caprine|Unofficial Facebook Messenger app. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/sindresorhus/caprine|{{Pkg|caprine}}}}
* {{App|Chatterino|Chat client for Twitch chat.|https://chatterino.com/|{{AUR|chatterino2-git}}}}
* {{App|Delta Chat|A privacy oriented chat application built on e-mail. Based on the [https://electronjs.org/ Electron] platform.|https://delta.chat/|{{AUR|deltachat-desktop-git}}}}
* {{App|[[Discord]]|ゲーマー用の proprietary オールインワンの音声・テキストチャット。フリーでデスクトップとスマートフォンの両方で動作。Based on the [https://electronjs.org/ Electron] platform.|https://discordapp.com/|{{Pkg|discord}}}}
* {{App|[[Wikipedia:Gitter|Gitter]]|Communication product for communities and teams on GitHub.|https://gitter.im/|{{AUR|gitter}}}}
* {{App|Hangups|Google ハングアウトのサードパーティ製インスタントメッセージクライアント with console interface.|https://github.com/tdryer/hangups|{{AUR|hangups}}}}
* {{App|[[ICQ]]|Official ICQ client for Linux.|https://icq.com/linux/|{{AUR|icqdesktop-bin}}}}
* {{App|IRCCloud|Desktop client for a modern, always-connected IRC client service. Based on the [https://electronjs.org/ Electron] platform.|https://www.irccloud.com/|{{AUR|irccloud}}}}
* {{App|[[Wikipedia:Jitsi|Jitsi]] Meet|Desktop application for Jitsi Meet. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/jitsi/jitsi-meet-electron|{{AUR|jitsi-meet-desktop}}}}
* {{App|Kotatogram Desktop|Experimental fork of Telegram Desktop.|https://kotatogram.github.io/|{{AUR|kotatogram-desktop}}}}
* {{App|Matterhorn|Console client for the Mattermost chat system.|https://github.com/matterhorn-chat/matterhorn|{{AUR|matterhorn}}}}
* {{App|[[Mattermost]] Desktop|Desktop application for Mattermost. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/mattermost/desktop|{{AUR|mattermost-desktop}}}}
* {{App|Meowgram|Telegram client written in GTK and Python.|https://github.com/ExposedCat/Meowgram|{{AUR|meowgram-git}}}}
* {{App|[[Wikipedia:Microsoft Teams|Microsoft Teams]]|Official proprietary client for Microsoft Teams. Based on the [https://electronjs.org/ Electron] platform.|https://teams.microsoft.com/downloads|{{AUR|teams}}}}
* {{App|[[Mumble]]|TeamSpeak に似たボイスチャットアプリケーション。|https://www.mumble.info/|{{Pkg|mumble}}}}
* {{App|[[QQ]]|Proprietary instant messaging software developed by Tencent (imitating ICQ).|https://im.qq.com/|{{AUR|linuxqq}}}}
* {{App|Rocket.Chat Desktop|Desktop application for Rocket.Chat. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/RocketChat/Rocket.Chat.Electron|{{AUR|rocketchat-desktop}}}}
* {{App|Session Desktop|Onion routing based messenger. Based on the [https://electronjs.org/ Electron] platform.|https://getsession.org/|{{AUR|session-desktop}}}}
* {{App|[[Wikipedia:Signal (software)|Signal]] Desktop|Desktop application for Signal private messenger. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/signalapp/Signal-Desktop|{{Pkg|signal-desktop}}}}
* {{App|[[Wikipedia:Skype|Skype]]|音声 and video コミュニケーションが行える人気 but proprietary のアプリケーション。Based on the [https://electronjs.org/ Electron] platform.|https://www.skype.com/|{{AUR|skypeforlinux-stable-bin}}}}
* {{App|[[Wikipedia:Slack (software)|Slack]]|Proprietary Slack client for desktop. Based on the [https://electronjs.org/ Electron] platform.|https://slack.com/downloads/linux|{{AUR|slack-desktop}}}}
* {{App|teams-for-linux|Unofficial Microsoft Teams for Linux client. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/IsmaelMartinez/teams-for-linux|{{AUR|teams-for-linux}}}}
* {{App|[[TeamSpeak]]|ゲーマーをターゲットにしたプロプライエタリの VoIP アプリケーション。|https://www.teamspeak.com/|{{Pkg|teamspeak3}}}}
* {{App|[[TeamTalk]]|Proprietary VoIP application with video chat, file and desktop sharing. Desktop sharing does not appear to be working in Linux though. AUR package is server only, but client is built in the make process.|https://bearware.dk|{{AUR|teamtalk}}}}
* {{App|[[Telegram]] Desktop|Official Telegram desktop client.|https://desktop.telegram.org/|{{Pkg|telegram-desktop}}}}
* {{App|Telegrand|GTK4 telegram client for GNOME.|https://github.com/melix99/telegrand|{{AUR|telegrand-git}}}}
* {{App|ThreemaQT|Unofficial Threema Web desktop client.|https://gitlab.com/bit3/threemaqt|{{AUR|threemaqt}}}}
* {{App|[[Wikipedia:Viber|Viber]]|Proprietary cross-platform IM and VoIP software.|https://www.viber.com/products/linux/|{{AUR|viber}}}}
* {{App|WhatsAppQT|Unofficial WhatsApp Web desktop client.|https://gitlab.com/bit3/whatsappqt|{{AUR|whatsappqt}}}}
* {{App|[[Wikipedia:Wire (software)|Wire]]|Modern, private messenger. Based on the [https://electronjs.org/ Electron] platform.|https://wire.com/|{{Pkg|wire-desktop}}}}
* {{App|YakYak|Unofficial desktop client for Google Hangouts. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/yakyak/yakyak|{{AUR|yakyak-git}}}}
* {{App|[[Wikipedia:Zoom Video Communications|Zoom]]|Proprietary video conferencing, online meetings and group messaging application.|https://zoom.us/|{{AUR|zoom}}}}
* {{App|[[Wikipedia:Zulip|Zulip]]|Desktop client for Zulip group chat. Based on the [https://electronjs.org/ Electron] platform.|https://zulipchat.com/apps/linux|{{AUR|zulip-desktop}}}}

==== Instant messaging servers ====

See also [[Wikipedia:Comparison of instant messaging protocols]].

===== IRC servers =====

See also [[Wikipedia:Comparison of Internet Relay Chat daemons]].

* {{App|[[InspIRCd]]|A stable, modern and lightweight IRC daemon.|https://www.inspircd.org/|{{AUR|inspircd}}}}
* {{App|IRCD-Hybrid|A lightweight, high-performance internet relay chat daemon.|https://www.ircd-hybrid.org/|{{AUR|ircd-hybrid}}}}
* {{App|miniircd|A small and configuration free IRC server, suitable for private use.|https://github.com/jrosdahl/miniircd|{{AUR|miniircd-git}}}}
* {{App|ngIRCd|A free, portable and lightweight Internet Relay Chat server for small or private networks.|https://ngircd.barton.de/|{{Pkg|ngircd}}}}
* {{App|Ergo|A modern and simple to set up IRC server written in Go. Combines the features of an IRCd, a services framework, and a bouncer.|https://ergo.chat/|{{AUR|ergochat}}}}
* {{App|[[UnrealIRCd]]|Open Source IRC Server.|https://www.unrealircd.org/|{{Pkg|unrealircd}}}}

===== XMPP サーバー =====

See also [[Wikipedia:Comparison of XMPP server software]].

* {{App|[[Prosody]]|[https://www.lua.org/ Lua] プログラミング言語で書かれた XMPP サーバー。Prosody は軽量で高い拡張性を持つように設計されています。ライセンスは [https://prosody.im/source/mit MIT ライセンス]。|https://prosody.im/|{{Pkg|prosody}}}}
* {{App|Ejabberd|Robust, scalable and extensible Erlang で書かれた Jabber サーバー。|https://www.ejabberd.im/|{{Pkg|ejabberd}}}}
* {{App|[[Jabberd2]]|C 言語で書かれた XMPP サーバーで GNU General Public License でライセンスされています。jabberd14 から影響を受けています。|https://jabberd2.org/|{{AUR|jabberd2}}}}
* {{App|[[Openfire]]|XMPP IM マルチプラットフォームサーバー。Java で書かれています。|https://www.igniterealtime.org/projects/openfire/|{{Pkg|openfire}}}}

===== SIP servers =====

See also [[Wikipedia:List of SIP software#Servers]].

* {{App|[[Asterisk]]|A complete PBX solution.|https://www.asterisk.org/|{{AUR|asterisk}}}}
* {{App|Kamailio|Rock solid SIP server.|https://www.kamailio.org/|{{AUR|kamailio}}}}
* {{App|openSIPS|SIP proxy/server for voice, video, IM, presence and any other SIP extensions.|https://opensips.org/|{{Pkg|opensips}}}}
* {{App|Repro|An open-source, free SIP server.|https://www.resiprocate.org/About_Repro|{{AUR|repro}}}}
* {{App|[[Wikipedia:Yate (telephony engine)|Yate]]|Advanced, mature, flexible telephony server that is used for VoIP and fixed networks, and for traditional mobile operators and MVNOs.|http://yate.ro/|{{Pkg|yate}}}}

===== Other IM servers =====

* {{App|[[Mattermost]]|Open source private cloud server, Slack-alternative.|https://github.com/mattermost/mattermost-server|{{Pkg|mattermost}}}}
* {{App|[[Murmur]]|Mumble のボイスチャットアプリケーションサーバー。|https://www.mumble.info/|{{Pkg|murmur}}}}
* {{App|Nextcloud Talk|Video- and audio-conferencing app for Nextcloud.|https://github.com/nextcloud/spreed|{{Pkg|nextcloud-app-spreed}}}}
* {{App|Rocket.Chat|Web chat server, developed in JavaScript, using the Meteor fullstack framework.|https://github.com/RocketChat/Rocket.Chat|{{AUR|rocketchat-server}}}}
* {{App|Spreed WebRTC|WebRTC audio/video call and conferencing server.|https://github.com/strukturag/spreed-webrtc|{{AUR|spreed-webrtc-server}}}}
* {{App|[[Matrix|Synapse]]|matrix プロトコルのリファレンス実装であるホームサーバー。|https://github.com/matrix-org/synapse|{{Pkg|matrix-synapse}}}}
* {{App|[[TeamSpeak]] Server|Proprietary VoIP conference server.|https://teamspeak.com/|{{Pkg|teamspeak3-server}}}}
* {{App|uMurmur|Minimalistic Mumble server.|https://umurmur.net/|{{Pkg|umurmur}}}}

==== Collaborative software ====

See also [[Wikipedia:Collaborative software]].

* {{App|[[Wikipedia:Citadel/UX|Citadel/UX]]|Includes an email & mailing list server, instant messaging, address books, calendar/scheduling, bulletin boards, and wiki and blog engines.|https://www.citadel.org/|{{AUR|webcit}}}}
* {{App|[[Kolab]]|Kolab Groupware solution consisting of a server and various clients.|https://kolab.org/|{{AUR|kolab}}{{Broken package link|package not found}}}}
* {{App|[[SOGo]]|Groupware server built around OpenGroupware.org (OGo) and the SOPE application server.|https://sogo.nu/|{{AUR|sogo}}}}

=== ニュース・RSS・ブログ ===

==== フィードリーダー ====

[[Wikipedia:RSS|RSS]]/[[Wikipedia:Atom (standard)|Atom]] aggregators. Some [[#Email clients|email clients]] are also able to act as news aggregator: [[Wikipedia:Claws Mail|Claws Mail]] RSSyl plugin, [[Evolution]] RSS plugin, [[Wikipedia:SeaMonkey#Mail|SeaMonkey Mail & Newsgroups]], [[Thunderbird]].

See also [[Wikipedia:Comparison of feed aggregators]].

===== コンソール =====

* {{App|[[Wikipedia:Canto (news aggregator)|Canto]]|ncurses RSS アグリゲータ。|https://github.com/themoken/canto-curses|{{Pkg|canto-curses}}}}
* {{App|[[Wikipedia:Gnus|Gnus]]|Emacs 用の電子メール、NNTP、RSS クライアント。|https://www.gnus.org/|{{Pkg|emacs}}}}
* {{App|[[Newsboat]]|[[Mutt]] メールクライアントに似たレイアウトとキーバインドを持つ ncurses RSS アグリゲータ。|https://newsboat.org/|{{Pkg|newsboat}}}}
* {{App|Rawdog|"RSS Aggregator Without Delusions Of Grandeur" は RSS/CDF/Atom フィードをパースして時間順で HTML ページに変換します。|https://offog.org/code/rawdog/|{{AUR|rawdog}}}}
* {{App|sfeed|Lightweight RSS and Atom parser.|https://codemadness.org/sfeed-simple-feed-parser.html|{{AUR|sfeed-git}}}}
* {{App|Snownews|テキストモード RSS ニュースリーダー。|https://github.com/kouya/snownews|{{AUR|snownews}}}}

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

* {{App|[[Wikipedia:Kontact#News Feed Aggregator|Akregator]]|KDE 向けのニュースアグリゲータ、{{Grp|kdepim}}{{Broken package link|package not found}} の一部。|https://kontact.kde.org/components/akregator.html|{{Pkg|akregator}}}}
* {{App|Alduin|RSS, Atom and JSON feed aggregator. Based on the [https://electronjs.org/ Electron] platform. Discontinued.|https://alduinapp.github.io/|{{AUR|alduin}}}}
* {{App|Alligator|Kirigami-based RSS/Atom feed reader for mobile devices.|https://apps.kde.org/alligator/|{{AUR|alligator}}}}
* {{App|FeedReader|Modern desktop application designed to complement existing web-based RSS accounts. Discontinued.|https://jangernert.github.io/FeedReader/|{{AUR|feedreader}}}}
* {{App|Feeds|An RSS/Atom feed reader for GNOME.|https://gabmus.gitlab.io/gnome-feeds/|{{Pkg|gfeeds}}}}
* {{App|Fluent Reader|Modern desktop RSS reader built with React and Fluent UI. Based on the [https://electronjs.org/ Electron] platform.|https://hyliu.me/fluent-reader/|{{AUR|fluent-reader}}}}
* {{App|HackUp|Read Hacker News from the desktop.|https://github.com/mdh34/hackup|{{AUR|hackup-git}}}}
* {{App|[[Wikipedia:Liferea|Liferea]]|オンラインのニュースフィードやウェブログを読むための GTK ニュースアグリゲータ。|https://lzone.de/liferea/|{{Pkg|liferea}}}}
* {{App|NewsFlash|Modern feed reader designed for the GNOME desktop. The spiritual successor to FeedReader.|https://gitlab.com/news-flash/news_flash_gtk|{{Pkg|newsflash}}}}
* {{App|[[Nextcloud]] News|RSS/Atom feed reader for Nextcloud.|https://github.com/nextcloud/news|{{Pkg|nextcloud-app-news}}}}
* {{App|QuiteRSS|Qt/С++ で書かれている RSS/Atom フィードリーダー。|https://quiterss.org/|{{Pkg|quiterss}}}}
* {{App|Raven|Simple desktop RSS reader made using VueJS. Based on the [https://electronjs.org/ Electron] platform.|https://ravenreader.app/|{{AUR|raven-reader}}}}
* {{App|RSS Guard|Qt フレームワークで開発されている非常に小さな RSS/Atom ニュースリーダー。|https://github.com/martinrotter/rssguard|{{Pkg|rssguard}} or {{Pkg|rssguard-nowebengine}}}}
* {{App|selfoss|The new multipurpose RSS reader, live stream, mashup, aggregation web application.|https://selfoss.aditu.de/|{{AUR|selfoss}}}}
* {{App|Tickr|テレビのニュース番組にあるようにフィードをデスクトップにスクロールしながら表示する GTK ベースの RSS リーダー。|https://www.open-tickr.net/|{{AUR|tickr}}}}
* {{App|[[Tiny Tiny RSS]]|Web-based news feed (RSS/Atom) aggregator.|https://tt-rss.org/|{{Pkg|tt-rss}}}}

==== ポッドキャストクライアント ====

Some media players are also able to act as podcast client: [[Amarok]], [[Wikipedia:Banshee (media player)|Banshee]], Cantata, [[Wikipedia:Clementine_(software)|Clementine]], Goggles Music Manager, [[Wikipedia:Rhythmbox|Rhythmbox]], [[VLC media player]]. [[Wikipedia:git-annex|git-annex]] can also [https://git-annex.branchable.com/tips/downloading_podcasts/ function as podcatcher].

See also [[Wikipedia:List of podcatchers]].

===== Console =====

* {{App|castero|A TUI podcast client for the terminal.|https://github.com/xgi/castero|{{AUR|castero-git}}}}
* {{App|castget|Simple, command-line RSS enclosure downloader, primarily intended for automatic, unattended downloading of podcasts.|https://castget.johndal.com/|{{Pkg|castget}}}}
* {{App|gpo|Text mode interface of gPodder.|https://gpodder.github.io/|{{Pkg|gpodder}}}}
* {{App|Greg|コマンドラインのポッドキャストアグリゲーター。|https://github.com/manolomartinez/greg|{{AUR|greg-git}}}}
* {{App|Marrie|コマンドラインインターフェイスで動作するシンプルなポッドキャストクライアント。|https://github.com/rafaelmartins/marrie/|{{AUR|marrie-git}}}}
* {{App|pcd|A minimal podcast client written in go|https://github.com/kvannotten/pcd|{{AUR|pcd}}}}

===== Graphical =====

* {{App|CPod|Simple, beautiful podcast app. Based on the [https://electronjs.org/ Electron] platform.|https://github.com/z-------------/CPod|{{AUR|cpod}}}}
* {{App|GNOME Podcasts|Podcast client for the GNOME Desktop written in Rust.|https://gitlab.gnome.org/World/podcasts|{{Pkg|gnome-podcasts}}}}
* {{App|gPodder|ポッドキャストクライアント・メディアアグリゲーター (GTK インターフェイス)。|https://gpodder.github.io/|{{Pkg|gpodder}}}}
* {{App|Vocal|近代的なデスクトップにあうシンプルなポッドキャストクライアント (GTK)。|https://vocalproject.net/|{{Pkg|vocal}}}}

==== Usenet ニュースリーダー ====

Some [[#Email clients|email clients]] are also able to act as Usenet newsreader: [[Wikipedia:Claws Mail|Claws Mail]], [[Evolution]], [[Mutt#NeoMutt|NeoMutt]], [[Wikipedia:SeaMonkey#Mail|SeaMonkey Mail & Newsgroups]], [[Wikipedia:Sylpheed|Sylpheed]], [[Thunderbird]].

See also: [[Wikipedia:List of Usenet newsreaders]], [[Wikipedia:Comparison of Usenet newsreaders]].

===== Console =====

* {{app|nn|UNIX 用のユーザーフレンドリな (curses ベースの) Usenet ニュースリーダー。|http://www.nndev.org/|{{AUR|nn}}}}
* {{app|[[Wikipedia:slrn|slrn]]|Text-based news client.|https://www.slrn.org/|{{AUR|slrn}}}}
* {{app|[[Wikipedia:Tin_(newsreader)|tin]]|NNTP と spool ベースのクロスプラットフォームなスレッド式 UseNet ニュースリーダー。|http://tin.org/|{{AUR|tin}}}}
* {{app|trn|テキストベースのスレッド式 Usenet ニュースリーダー。|http://trn.sourceforge.net/|{{AUR|trn}}}}

===== Graphical =====

* {{app|[[NZBGet]]|Usenet binary downloader for .nzb files with web and CLI interface.|https://nzbget.net/|{{Pkg|nzbget}}}}
* {{app|[[Wikipedia:Pan (newsreader)|Pan]]|テキストとバイナリ両方を扱える GTK の Usenet ニュースリーダー。|http://pan.rebelbase.com/|{{Pkg|pan}}}}
* {{app|[[SABnzbd]]|Python で書かれたオープンソースのバイナリニュースリーダー。|https://sabnzbd.org/|{{AUR|sabnzbd}}}}
* {{app|XRN|X Window System 向けの Usenet ニュースリーダー。|http://www.mit.edu/people/jik/software/xrn.html|{{AUR|xrn}}}}

==== マイクロブログクライアント ====

See also [[Wikipedia:List of Twitter services and applications]].

===== Console =====

* {{App|bti|Simple command line client for twitter/identi.ca|https://gregkh.github.io/bti/|{{pkg|bti}}}}
* {{App|oysttyer|(official fork of ttytter) An interactive console text-based command-line Twitter client written in Perl.|https://github.com/oysttyer/oysttyer|{{AUR|oysttyer-git}}}}
* {{App|Rainbowstream|Python で書かれた強力かつ機能豊富な Twitter コンソールクライアント。|https://github.com/orakaro/rainbowstream |{{AUR|rainbowstream}}}}
* {{App|toot|CLI and TUI tool for interacting with Mastodon instances|https://github.com/ihabunek/toot|{{AUR|toot}}}}
* {{App|turses|コンソールベースの ''tyrs'' の機能を改善させた Twitter クライアント。|https://github.com/louipc/turses|{{AUR|turses-git}}}}

===== Graphical =====

* {{App|Cawbird|Native GTK Twitter client for the Linux desktop.|https://ibboard.co.uk/cawbird/|{{Pkg|cawbird}}}}
* {{App|Choqok|KDE のマイクロブログクライアント。Twitter.com, Pump.io, GNU social, opendesktop.org サービスをサポート。|https://choqok.kde.org/|{{Pkg|choqok}}}}
* {{App|Giara|Reddit app, built with Python, GTK and Handy.|https://gitlab.gnome.org/World/giara|{{AUR|giara}}}}
* {{App|Mikutter|[[GTK]] と Ruby を使用する simple, powerfull Twitter クライアント。|https://mikutter.hachune.net/|{{AUR|mikutter}}}}
* {{App|Pumpa|C++ と Qt で書かれた Pump.io クライアント。|https://pumpa.branchable.com/|{{AUR|pumpa-git}}}}
* {{App|Tootle|GTK3 client for Mastodon.|https://github.com/bleakgrey/tootle|{{AUR|tootle}}}}
* {{App|Turpial|マルチインターフェイスの Twitter クライアント。Python で書かれています。|http://turpial.org.ve/|{{AUR|turpial-git}}}}
* {{App|Whalebird|Mastodon client application. Based on the [https://electronjs.org/ Electron] platform.|https://whalebird.social/|{{AUR|whalebird-bin}}}}

==== ブログソフトウェア ====

See also [[Wikipedia:Blog software]] and [[Wikipedia:List of content management systems]].
{{note|Content managers, social networks, and blog publishers overlap in many functions.}}
* {{App|[[Diaspora]]|分散型のプライバシー指向ソーシャルネットワーク。|https://diasporafoundation.org|{{AUR|diaspora-mysql}} or {{AUR|diaspora-postgresql}}}}
* {{App|[[Drupal]]|A PHP-based content management platform.|https://www.drupal.org/|{{Pkg|drupal}}}}
* {{App|[[Ghost]]|JavaScript で書かれているブログプラットフォーム。MIT ライセンスで配布。個々のブロガーのオンラインパブリッシュを簡単にするように作られています。|https://ghost.org/|{{AUR|ghost-web}}}}
* {{App|[[Joomla]]|PHP 製のコンテンツ管理システム (CMS)。ウェブサイトを作成したり強力なオンラインアプリケーションが使えます。|https://www.joomla.org/|{{AUR|joomla}}}}
* {{App|[[Wordpress]]|Blog tool and publishing platform.|https://wordpress.org/|{{Pkg|wordpress}}}}

==== Static site generators ====

* {{App|Hexo|高速・シンプル・パワフルなブログフレームワーク。|https://hexo.io/|{{AUR|hexo-cli}}}}
* {{App|Hugo|Hugo is a static HTML and CSS website generator written in Go. It is optimized for speed, ease of use, and configurability.|https://gohugo.io/|{{Pkg|hugo}}}}
* {{App|[[Jekyll]]|静的ブログエンジン。Ruby で書かれており、Markdown や textile などのフォーマットをサポート。|https://jekyllrb.com/|{{AUR|jekyll}}}}
* {{App|Nanoblogger|Bash で書かれたコマンドラインの小規模な weblog エンジン。cat, grep, sed などの標準 UNIX ツールを使って静的な HTML コンテンツを作成します。It is not maintained anymore.|http://nanoblogger.sourceforge.net/|{{AUR|nanoblogger}}}}
* {{App|Nikola|Python で書かれた静的サイトジェネレータ。incremental rebuilds and 複数のマークアップフォーマットに対応。|https://getnikola.com/|{{Pkg|nikola}}}}
* {{app|Pelican|静的なサイトジェネレータ。Python で動作。|https://docs.getpelican.com/|{{Pkg|pelican}}}}

=== リモートデスクトップ ===

[[Wikipedia:ja:リモートデスクトップ]]や [[Wikipedia:Comparison of remote desktop software]] も参照。

See also [https://remotedesktop.google.com Chrome Remote Desktop] for a web browser based solution.

==== リモートデスクトップクライアント ====

* {{App|[[Wikipedia:AnyDesk|AnyDesk]]|Proprietary remote desktop software.|https://anydesk.com/|{{AUR|anydesk-bin}}}}
* {{App|GNOME Connections|Remote desktop client for GNOME. Supports RDP and VNC.|https://gitlab.gnome.org/GNOME/connections|{{Pkg|gnome-connections}}}}
* {{App|GVncViewer|Gtk-VNC によるシンプルな VNC クライアント。Run with {{ic|gvncviewer}}.|https://wiki.gnome.org/Projects/gtk-vnc|{{Pkg|gtk-vnc}}}}
* {{App|[[Wikipedia:KRDC|KRDC]]|KDE のリモートデスクトップクライアント。RDP と VNC をサポート。{{Grp|kde-network}} に含まれています。|https://apps.kde.org/krdc/|{{Pkg|krdc}}}}
* {{App|[[Remmina]]|GTK で書かれたリモートデスクトップクライアント。RDP, VNC, NX, XDMCP, SSH をサポート。|https://remmina.org/|{{Pkg|remmina}}}}
* {{App|Remote Viewer|Simple remote display client. Supports SPICE and VNC.|https://virt-manager.org/|{{Pkg|virt-viewer}}}}
* {{App|Remotely|Simple VNC viewer for GNOME. Discontinued.|https://gitlab.gnome.org/World/Remotely|{{AUR|remotely}}}}
* {{App|Sunlogin Remote Control|Proprietary software that supports remote control of mobile devices, Windows, Mac, Linux and other systems. It uses its own proprietary protocol.|https://sunlogin.oray.com/en/about/about|{{AUR|sunloginclient}}}}
* {{App|ToDesk|Proprietary remote desktop client that suits for remote teamwork. It uses its own proprietary protocol.|https://www.todesk.com/|{{AUR|todesk-bin}}}}
* {{App|[[Wikipedia:TeamViewer|TeamViewer]]|プロプライエタリのリモートデスクトップクライアント。プロプライエタリの独自プロトコルを使用。|https://www.teamviewer.com/|{{AUR|teamviewer}}}}
* {{App|[[TigerVNC|vncviewer (TigerVNC)]]|X 用の VNC ビューア。|https://tigervnc.org/|{{Pkg|tigervnc}}}}
* {{App|[[Wikipedia:Vinagre|Vinagre]]|GNOME のリモートデスクトップビューア。RDP, VNC, SPICE, SSH をサポート。{{Grp|gnome-extra}} に含まれています。|https://wiki.gnome.org/Apps/Vinagre|{{Pkg|vinagre}}}}
* {{App|xfreerdp|FreeRDP X11 クライアント。Run with {{ic|xfreerdp}}.|https://www.freerdp.com/|{{Pkg|freerdp}}}}
* {{App|[[X2Go]] Client|X2Go システムのグラフィカルクライアント (Qt5)。[[w:NX technology|NX technology]] プロトコルを使用。|https://wiki.x2go.org/doku.php|{{Pkg|x2goclient}}}}

==== リモートデスクトップサーバー ====

* {{App|Krfb|KDE の VNC サーバー。{{Grp|kde-network}} に含まれています。|https://apps.kde.org/krfb/|{{Pkg|krfb}}}}
* {{App|[[NoMachine]]|Proprietary remote desktop server and client based on [[w:NX technology|NX technology]].|https://nomachine.com/|{{AUR|nomachine}}}}
* {{App|wayvnc|({{Pkg|sway}}などの) wlroots ベースの wayland コンポジタのための VNC サーバ |https://github.com/any1/wayvnc|{{Pkg|wayvnc}}}}
* {{App|[[TigerVNC|x0vncserver (TigerVNC)]]|X ディスプレイの VNC サーバー。|https://tigervnc.org/|{{Pkg|tigervnc}}}}
* {{App|[[x11vnc]]|リアル X ディスプレイの VNC サーバー。|http://www.karlrunge.com/x11vnc/|{{Pkg|x11vnc}}}}
* {{App|[[X2Go]] Server|オープンソースのリモートデスクトップソフトウェア。[[w:NX technology|NX technology]] プロトコルを使用。|https://wiki.x2go.org/doku.php|{{Pkg|x2goserver}}}}
* {{App|[[Xpra]]|A multi-platform screen and application forwarding system.|https://xpra.org/|{{Pkg|xpra}}}}
* {{App|[[Xrdp]]|A daemon that supports RDP. It uses Xvnc, X11rdp or xorgxrdp as a backend.|http://xrdp.org/|{{AUR|xrdp}}}}

<noinclude>
{{TranslationStatus|List of applications/Internet|2021-12-30|707512}}
</noinclude>

保存データ暗号化

2022-02-05T09:43:10Z

Shota: /* スタックファイルシステムの暗号化 */ クラウドストレージの最適化の節をコピー

[[Category:暗号化]]
[[Category:ファイルシステム]]
[[en:Data-at-rest encryption]]
[[es:Data-at-rest encryption]]
[[pl:Data-at-rest encryption]]
[[pt:Data-at-rest encryption]]
{{Related articles start}}
{{Related|dm-crypt}}
{{Related|TrueCrypt}}
{{Related|eCryptfs}}
{{Related|EncFS}}
{{Related|gocryptfs}}
{{Related|fscrypt}}
{{Related|Tomb}}
{{Related|tcplay}}
{{Related|GnuPG}}
{{Related|自己暗号化ドライブ}}
{{Related articles end}}
この記事では、[[ブロックデバイス]]や[[ディスクパーティション]]、ディレクトリに書き込んだり読み込んだりするデータをその場で暗号化/復号化する、[[Wikipedia:Data at rest|保存データ]] [[Wikipedia:Disk encryption|暗号化]]ソフトウェアについて説明します。ブロックデバイスの例としては、ハードディスク、フラッシュドライブ、DVDなどがあります。

保存データの暗号化は、あくまでもオペレーティングシステムの既存のセキュリティ機構を補助するものと考えるべきで、物理的なアクセスの保護に焦点を当て、ネットワークセキュリティやユーザーベースのアクセスコントロールなどは、システムの''他''の部分に依存することになります。

フルディスク暗号化 (FDE) については、[[dm-crypt/システム全体の暗号化]]を参照してください。

==なぜ暗号化を使うのか?==

ディスク暗号化は確実にファイルを常に暗号化された状態でディスクに保存することができます。ファイルにアクセスできるのは、システムが動いていて信頼されたユーザーによってロックを解除された間だけで、その場合にのみオペレーティングシステムやアプリケーションは読み取れる状態でファイルにアクセスすることができるようになります。権限のないユーザーが直接ディスクの中身を見たとしても、わかるのは意味がわからないランダムなデータだけで、実際のファイルを読み取ることは不可能です。

ディスク暗号化によって、例えば、コンピュータやハードディスクが以下の状態にあるときにデータを勝手に見られることを防げます:
* あなたの離席中に、他の信頼されない人々がアクセスすることができる場所に置かれている場合。
* ノートパソコンやネットブック、または外付けのストレージデバイスなどのように紛失したり盗まれた場合。
* 修理に出している間。
* 寿命が尽きて廃棄した時。

さらに、ディスク暗号化を使うことで、オペレーティングシステムを改竄しようとする不正アクセスに対するセキュリティの強化にもなります。例えば、システムへの物理的なアクセスを手に入れた攻撃者によるキーロガーやトロイの木馬のインストールへの防衛手段になります。

{{Warning|ディスク暗号化はあらゆる脅威からデータを保護するわけではないので注意してください。}}
ディスク暗号化によっても以下のような場合には対処できません:
* システムが動いていて、あなたがロックを解除してディスクの暗号化している部分をマウントしてしまった後に (インターネットなどを介して) 攻撃者がシステムに侵入した場合。
* [[Wikipedia:Cold boot attack|コールドブートアタック]]に必要な手段を攻撃者が手に入れていて、(画面ロックを使っていたとしても) コンピュータが動作している、または動作していたすぐ後に攻撃者が物理的にアクセスできる場合。
* 政府機関が、上記の攻撃を簡単に行える資力を持っているだけでなく、もっとシンプルに、様々な[[Wikipedia:ja:強制|強制執行]]を使って無理矢理キーやパスフレーズを明かさせることができる場合。世界中の非民主的な国々、さらにアメリカやイギリスでも、何か興味深いものをあなたが隠していると法執行機関が疑いをかけた場合、法執行機関によってロックの解除を合法的に迫られる可能性があります。
* [[Wikipedia:Rubber-hose_cryptanalysis|締め上げ暗号分析]]。[https://xkcd.com/538/ XKCD #538] も参照してください。

あなたがシステムを使う前にシステムに細工を施すことができるプロの攻撃者にまともに対抗するには非常に強固なディスク暗号化が必要になります (例: 平文のブートパーティションがなく真正の確認があるフルシステム暗号化)。それでもあらゆるタイプの改竄を押しとどめることができるかというと疑問です (例: ハードウェアキーロガー)。おそらく[[Wikipedia:Hardware-based full disk encryption|ハードウェアベースの完全ディスク暗号化]]と[[Wikipedia:Trusted_Computing|トラステッドコンピューティング]]が最善策でしょう。

{{Warning|ディスク暗号化をしたとしても[[ディスクの完全消去|ディスクの消去]]からは保護されません。データを安全に保つため[[バックアッププログラム|定期的なバックアップ]]を推奨します。}}

=== データ暗号化 vs システム暗号化 ===

; データ暗号化
: データ暗号化は、ユーザーのデータ ({{ic|/home}} ディレクトリの中や、データ DVD などのリムーバブルメディア) だけの暗号化と定義され、一番シンプルで込み入ったところがないディスク暗号化の利用法ですが、致命的な欠点があります。
: 最近の計算システムでは、ユーザーデータに関する情報や、またはデータそれ自体の一部を以下のようなハードドライブの暗号化されていない領域にキャッシュ・保存するバックグラウンドプロセスが多数存在します:

:* スワップパーティション
:** ''(救済策: スワップを無効にする、または[[Dm-crypt/スワップの暗号化|スワップも暗号化]]してしまう)''
:* {{ic|/tmp}} (ユーザーアプリケーションによって作成される一時ファイル)
:** ''(救済策: そのようなアプリケーションを使うのをやめる、または {{ic|/tmp}} を [[RAM ディスク]]にマウントする)''
:* {{ic|/var}} (ログファイルやデータベースなど。例えば mlocate は全てのファイル名のインデックスを {{ic|/var/lib/mlocate/mlocate.db}} に保存します)

:さらに、データ暗号化だけではオフラインのシステムのタンパリング攻撃にたいして隙を残すことになります (例: 暗号化されたデータを解除するために使用するパスフレーズを[[Wikipedia:ja:キーロガー|記録]]するプログラムや、ロックを解除するのを待ってから密かに攻撃者がデータを回収できる場所にデータをコピー/送信するプログラムのインストール)。

; システム暗号化
: システム暗号化は、オペレーティングシステム''と''ユーザーデータの暗号化と定義されており、データ暗号化の欠点を解決します。

: メリット:
:* オペレーティングシステムのファイルに対する権限のない物理アクセス (と改竄) を防ぎます ''(ただし上の警告を見て下さい)''
:* システムによってキャッシュされる可能性のあるプライベートなデータへの権限のない物理アクセスを防ぎます
: デメリット:
:* ユーザーのログイン中またはログイン後にディスクの暗号化された部分を解除することはできなくなります。起動時に行わなくてはなりません

実際には、データ暗号化とシステム暗号化はいつでも判然と区別することができるというわけではなく、様々な妥協やカスタマイズをしたセットアップというのが考えられます。

いずれにせよ、ディスク暗号化はあくまでオペレーティングシステムの既存のセキュリティ機構の添え物として考えるべきです。ネットワークセキュリティやユーザーベースのアクセス制御などを提供するシステムの''他の''部分を活かしながら、オフラインの物理アクセスの防御も考えて下さい。

[[Wikipedia:Disk encryption]] も参照。

== システムデータ暗号化 ==

ユーザーデータそのもの（ホームディレクトリ内やデータ DVD などのリムーバブルメディアにあることが多い）を暗号化するのは、最もシンプルで侵入の少ない方法ですが、いくつかの重大な欠点もあります。最近のコンピュータシステムでは、多くのバックグラウンドプロセスがあり、ユーザーデータに関する情報やデータ自体の一部を、ハードディスクの暗号化されていない領域にキャッシュして保存している可能性があります。

:* スワップパーティション
:** (potential remedies: disable swapping, or use [[スワップの暗号化]] as well)
:* {{ic|/tmp}} (temporary files created by user applications)
:** (potential remedies: avoid such applications; mount {{ic|/tmp}} inside a [[ramdisk]])
:* {{ic|/var}} (log files and databases and such; for example, [[mlocate]] stores an index of all file names in {{ic|/var/lib/mlocate/mlocate.db}})

The solution is to encrypt both system and user data, preventing unauthorized physical access to private data that may be cached by the system. This however comes with the disadvantage that unlocking of the encrypted parts of the disk has to happen at boot time. Another benefit of system data encryption is that it complicates the installation of malware like [[Wikipedia:Keystroke logging|keyloggers]] or rootkits for someone with physical access.

==利用可能な手段==

あらゆるディスク暗号化の手段というのは、ディスクは暗号化されたデータを保持しながら、暗号コンテナ (つまり暗号化されたデータを保持するディスクの論理部) が"解除"されてマウントされているときにかぎり、オペレーティングシステムやアプリケーションからは通常の読み込み可能なデータとして見えるようにするという方法で働きます。

暗号化を使うには、ユーザーによって"秘密情報"が供給される必要があり (通常はキーファイルやパスフレーズの形で指定します)、それから実際の暗号化キーが生成されます (そしてセッションの間はカーネルのキーリングに保存されます)。

この種の仕組みが全くわからないという場合は、下の[[#暗号化の仕組み|暗号化の仕組み]]セクションを読んで下さい。

利用できるディスク暗号化の方法は、稼働するレイヤーによって2つのタイプに分けることができます:

===スタックファイルシステムの暗号化===

スタックファイルシステムによる暗号化ソリューションは既存のファイルシステム上に積み上げられるレイヤーとして実装され、暗号化が有効になったフォルダへ書き込まれた全てのファイルを、実際のファイルシステムがディスクに書き込む前に即座に暗号化します。そしてファイルシステムがディスクからファイルを読み込んだ時は復号化を行います。この方法では、ホストファイルシステムには暗号化された形でファイルが保存されますが (ファイルの中身や、ファイル名・フォルダ名も、同じ長さのランダムなデータで置き換えられます)、それ以外のファイルはファイルシステム上に通常のファイル/シンボリックリンク/ハードリンクとして暗号化されない形で存在します。

ホストファイルシステムにある暗号化されたファイルが保存されたフォルダをロック解除するため、(特殊なスタック擬似ファイルシステムを使って) それ自体または別の場所にマウントされ、同じファイルが読み込める形で現れます。アンマウントしたり、システムの電源が落とされるまでその状態は維持されます。

スタックファイルシステム暗号化で利用できるソリューションには [[eCryptfs]] や [[EncFS]] があります。

==== クラウドストレージの最適化 ====

If you are deploying stacked filesystem encryption to achieve zero-knowledge synchronization with third-party-controlled locations such as cloud-storage services, you may want to consider alternatives to eCryptfs and EncFS, since these are not optimized for transmission of files over the Internet. There are some solutions designed for this purpose instead:

* [[gocryptfs]]
* {{AUR|cryptomator}} or {{AUR|cryptomator-bin}} (multi-platform)
* {{Pkg|cryfs}}

Note that some cloud-storage services offer zero-knowledge encryption directly through their own [[アプリケーション一覧/インターネット#Cloud synchronization clients|client applications]].

===ブロックデバイスの暗号化===

一方、ブロックデバイス暗号化はファイルシステムレイヤーの''下''で動作して、特定のブロックデバイス (つまり、ディスクやパーティション全体、または仮想的なループバックデバイスとして振る舞うファイル) に書き込まれる全てのデータが暗号化されます。このため、ブロックデバイスがオフラインのときは、中身が全てランダムなデータの巨大なブロブのように見え、ファイルシステムやデータに何が含まれているのか判断できなくなります。データにまたアクセスするときは、保護されたコンテナ (この場合、ブロックデバイス) を特殊な方法で任意の場所にマウントします。

Arch Linux では"ブロックデバイス暗号化"として以下の方法が利用できます:

;loop-AES: loop-AES は cryptoloop の後継で、システム暗号化のためのセキュアで高速なソリューションです。ただし、標準にないカーネルのサポートが必要になるため loop-AES は他の選択肢と比べてユーザーフレンドリーとは言い難いかもしれません。

;dm-crypt: [[dm-crypt]] は Linux カーネルによって提供されている標準の device-mapper 暗号化機能です。直接使うことでパーティションやキーの管理のあらゆることを完全にコントロールすることができます。dm-crypt の管理はユーザースペースユーティリティの {{Pkg|cryptsetup}} を使って行います。次のタイプのブロックデバイス暗号化に使用することが可能です: ''LUKS'' (デフォルト), ''plain'', そして機能制限がありますが ''loopAES'' と ''Truecrypt'' デバイス。
:* デフォルトで使用される LUKS は dm-crypt をセットアップするのに必要な情報を全てディスクに保存する便利なレイヤーで、使いやすさと暗号のセキュリティを増すためにパーティションとキー管理を抽象化します。
:* plain dm-crypt モードは、オリジナルのカーネルの機能であり、便利なレイヤーを使いません。レイヤーを使った時と同じ暗号強度を確保するのは難しくなります。そうしようとすると、結果的にキー (パスフレーズまたはキーファイル) が長くなってしまいます。しかしながら、下で説明しているように利点も存在します。

;TrueCrypt: [[TrueCrypt]] の開発者は2014年5月にサポートを終了しています。それ以降脆弱性が修正されていないため、使用してはなりません。

;VeraCrypt: TureCryptの後継です。

選択するレイヤーの実用性については、下の[[#実用性|比較表]]を見て下さい。[http://ksouedu.com/doc/ecryptfs-utils/ecryptfs-faq.html#compare eCryptfs] についての記事も参照。

=== Block device vs stacked filesystem encryption ===

{| class="wikitable left-align-row-headers" style="text-align:center;"
! Aspect
! {{B|Block device encryption}}
! {{V|Stacked filesystem encryption}}
|-
! Encrypts
| whole block devices
| files
|-
! Container for encrypted data may be...
| a disk or disk partition / a file as loop device
| a directory in an existing file system
|-
! Relation to filesystem
| operates below filesystem layer: does not care whether the content of the encrypted block device is a filesystem, a partition table, a LVM setup, or anything else
| adds an additional layer to an existing filesystem, to automatically encrypt/decrypt files whenever they are written/read
|-
! File metadata (number of files, dir structure, file sizes, permissions, mtimes, etc.) is encrypted
| {{Yes}}
| {{No}} (file and dir names can be encrypted though)
|-
! Can be used to custom-encrypt whole hard drives (including partition tables)
| {{Yes}}
| {{No}}
|-
! Can be used to encrypt swap space
| {{Yes}}
| {{No}}
|-

! Can be used without pre-allocating a fixed amount of space for the encrypted data container
| {{No}}
| {{Yes}}
|-
! Can be used to protect existing filesystems without block device access, e.g. NFS or Samba shares, cloud storage, etc.
| {{No}}
| {{Yes}}
|-
! Allows offline file-based backups of encrypted files
| {{No}}
| {{Yes}}
|}

===比較表===
"dm-crypt +/- LUKS" のカラムは LUKS ("+") と plain ("-") 両方の暗号化モードにおける dm-crypt の機能を示しています。特定の機能が LUKS の使用を必要とする場合、そのことは "(LUKS を使用)" で表されます。同じように "(LUKS を使用しない)" はその機能を実現するのに LUKS の使用が逆効果であり、plain モードを使うべきことを示しています。

{| class="wikitable" style="text-align:center; cell-padding:100px; "
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |
=====''概要''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent; width:20px" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
タイプ
| colspan="4" | ブロックデバイスの暗号化
| colspan="2" | スタックファイルシステムの暗号化
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
主なセールスポイント
| 最古の手段であり、おそらく最速であり、レガシーなシステムでも動作します
| Linux におけるブロックデバイス暗号化のデファクトスタンダードであり柔軟性があります
| 携帯性が高く、洗練された、自己完結型の暗号化ソリューション
| 活発に開発されている TrueCrypt のフォークで、デファクトスタンダードの代替
| EncFS よりも若干高速で、暗号化されたファイルは個別にシステム間で移動できます
| 一番使うのが簡単で、root 以外による管理をサポートしています
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
Arch Linux における利用手段
| カスタムカーネルの手動コンパイルが必須
| ''カーネルモジュール:'' デフォルトのカーネルに含まれています; ''ツール:'' {{Pkg|device-mapper}}, {{Pkg|cryptsetup}} [core]
| {{pkg|truecrypt}} [extra] (開発終了) または後方互換のある {{pkg|veracrypt}} [community]
| {{pkg|veracrypt}} [community]
| ''カーネルモジュール:'' デフォルトのカーネルに含まれています; ''ツール:'' {{Pkg|ecryptfs-utils}} [community]
| {{Pkg|encfs}} [community]
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ライセンス
| GPL
| GPL
| TrueCrypt License 3.1[[#参照|[1]]]
| Apache License 2.0, 一部はTrueCrypt License v3.0[[#参照|[1]]]
| GPL
| GPL
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="5" style="border-right-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |
=====''基本的な分類''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
暗号化の対象
| colspan="4" | ブロックデバイス全体
| colspan="2" | ファイル
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
暗号化されたデータのコンテナ
| colspan="4" |
* ディスクまたはディスクパーティション
* 仮想パーティションとして作用するファイル
| colspan="2" |
* 既存のファイルシステムのディレクトリ
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ファイルシステムとの関係
| colspan="4" | ファイルシステムレイヤーの下で動作し、暗号化されたブロックデバイスの中身がファイルシステム、パーティションテーブル、LVM のどれであるかには関しない
| colspan="2" | 既存のファイルシステムにレイヤーを追加して、ファイルが書き込まれたり読み込まれた時に自動的に暗号化または復号化を行う
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
暗号化の実装空間
| colspan="5" | カーネル空間
| ユーザー空間 ''(FUSE を使用)''
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
暗号メタデータの保存場所
| ?
| LUKS を使用: LUKS ヘッダー
| colspan="2" rowspan="2" | (復号化された) デバイスの冒頭/最後 ([http://www.truecrypt.org/docs/volume-format-specification フォーマット])
| 暗号化されたファイルのヘッダー
| EncFs コンテナのトップレベルにあるコントロールファイル
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
暗号鍵の保存場所
| ?
| LUKS を使用: LUKS ヘッダー
| colspan="2" rowspan="1" | 何処にでも保存できるキーファイル
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="5" style="border-right-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |

=====''実用性''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ファイルのメタデータ (ファイルの数, ディレクトリ構造, ファイルサイズ, パーミッション, 更新時刻など) の暗号化
| colspan="4" | ✔
| colspan="2" | ✖ ''(ファイルやディレクトリの名前は暗号化できます)''
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
(パーティションテーブルを含む) ハードドライブ全体の暗号化
| colspan="4" | ✔
| colspan="2" | ✖
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
スワップ領域の暗号化
| colspan="4" | ✔
| colspan="2" | ✖
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
あらかじめ特定のサイズのスペースを暗号化データコンテナに割り当てなくても使用できるか
| colspan="4" | ✖
| colspan="2" | ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ブロックデバイスにアクセスできない既存のファイルシステム (NFS や Samba の共有、クラウドストレージなど) の保護に使用できるか
| colspan="4" |     ✖[[#参照|[2]]]
| colspan="2" | ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
暗号化されたファイルのファイルベースのオフラインバックアップ
| colspan="4" | ✖
| colspan="2" | ✔
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="5" style="border-right-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |
=====''ユーザビリティ''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ログイン時の自動マウントのサポート
| ?
| ✔
| ✔
| ✔
| ✔
| ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
アイドル状態による自動アンマウントのサポート
| ?
| ?
| ?
| ?
| ?
| ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
root 以外のユーザーによる暗号化されたデータのコンテナの作成と破壊
| ✖
| ✖
| ✖
| ✖
| 制限あり
| ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
GUI
| ✖
| ✖
| ✔
| ✔
| ✖
| ✔
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="5" style="border-right-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |

=====''セキュリティ''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
サポートされている暗号
| AES
| AES, Anubis, CAST5/6, Twofish, Serpent, Camellia, Blowfish, ... (カーネルの Crypto API が用意している全ての暗号)
| AES, Twofish, Serpent
| AES, Twofish, Serpernt, Camellia, Kuznyechik
| AES, Blowfish, Twofish...
| AES, Blowfish, Twofish, その他システムで使える暗号
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ソルティングのサポート
| ?
| ✔ (LUKS を使用)
| ✔
| ✔
| ✔
| ?
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
複数の暗号による多段処理のサポート
| ?
| 複数のブロックデバイスを段階的に暗号化することは可能
| ✔
| ✔
| ?
| ✖
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
キースロットの拡散のサポート
| ?
| ✔ (LUKS を使用)
| ?
| ?
| ?
| ?
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
キースクラブに対する保護
| ✔
| ✔ (LUKS を使用しない)
| ?
| ?
| ?
| ?
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
同一の暗号化されたデータに対して複数のキー (別個に無効にできる) のサポート
| ?
| ✔ (LUKS を使用)
| ?
| ?
| ?
| ✖
|- valign="top"
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="5" style="border-right-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |

=====''パフォーマンス''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
マルチスレッドのサポート
| ?
| ✔[[#参照|[8]]]
| ✔
| ✔
| ?
| ?
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ハードウェア支援暗号化のサポート
| ✔
| ✔
| ✔
| ✔
| ✔
| ✔[[#参照|[13]]]
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="4" style="border-right-color:transparent" |
| colspan="2" style="border-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |

=====''ブロックデバイス暗号化特有の事項''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
| colspan="2" rowspan="2" style="border-color:transparent" |
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
所定の暗号化済みのブロックデバイスを (手動で) リサイズすることのサポート
| ?
| ✔
| ✖
| ✖
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="4" style="border-color:transparent" |
| colspan="2" style="border-right-color:transparent" |
|-
| colspan="7" style="border-left-color:transparent; text-align:left;" |
=====''スタックファイルシステム暗号化特有の事項''=====
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="6" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
サポートされるファイルシステム
| ext3, ext4, xfs (注意事項あり), jfs, nfs...
| ext3, ext4, xfs (with caveats), jfs, nfs, cifs...[https://github.com/vgough/encfs]
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="6" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ファイル名の暗号化
| ✔
| ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="6" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
ファイル名の暗号化を''しない''機能
| ✔
| ✔
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="6" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
スパースファイルの最適化処理
| ✖
| ✔
|-
| colspan="3" style="height:20px; border-color:transparent" |
| colspan="5" style="border-right-color:transparent" |
|-
| colspan="3" style="border-left-color:transparent; border-top-color:transparent; text-align:left;" |

=====''互換性と普及度''=====
! scope="col" style="background:#E2E2E2" | Loop-AES
! scope="col" style="background:#E2E2E2" | dm-crypt +/- LUKS
! scope="col" style="background:#E2E2E2" | TrueCrypt
! scope="col" style="background:#E2E2E2" | VeraCrypt
! scope="col" style="background:#E2E2E2" | eCryptfs
! scope="col" style="background:#E2E2E2" | EncFs
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
サポートされる Linux カーネルバージョン
| 2.0 以上
| CBC モード 2.6.4, ESSIV 2.6.10, LRW 2.6.20, XTS 2.6.24
| ?
| ?
| ?
| 2.4 以上
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" rowspan="3" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" | 暗号化されたデータにアクセスできるオペレーティングシステム
! scope="row" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" | Windows
| ✔[[#参照|[3]]]
| ?[[#参照|[4]]]
| ✔
| ✔
| ?
|     ✔[[#参照|[9]]]
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" | macOS
| ?
| ?
| ✔
| ✔
| ?
|     ✔[[#参照|[5]]]
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" | FreeBSD
| ?
| ?
| ✔ (VeraCrypt を使用)
| ✔
| ?
|     ✔[[#参照|[6]]]
|- valign="top"
| style="border-left-color:transparent; border-bottom-color:transparent" |
! scope="row" colspan="2" style="text-align:left; font-weight:normal; color:#393939; background:#E2E2E2; padding:0 6px" |
使用しているディストリビューション
| ?
|
* Debian/Ubuntu インストーラ (システム暗号化)
* Fedora インストーラ
| ?
| ?
|
* Ubuntu インストーラ (ホームディレクトリの暗号化)
* Chromium OS (キャッシュされたユーザーデータの暗号化[[#参照|[7]]])
| ?
|}

==準備==

===セットアップの選択===

どのディスク暗号化をセットアップするのが適切なのかはあなたの目的 (上の [[#なぜ暗号化を使うのか?]] を読んで下さい) とシステムパラメータによって様々です。 
とりわけ、以下の質問に答える必要があるでしょう:

<ul>
<li>あなたが身を守りたいのはどのような"攻撃者"からか?
<ul style="list-style-type:circle;color:#777;font-size:90%;line-height:1em;margin-top:0">
<li>システムの電源がオフになっていたり盗まれたりしたときにディスクを詮索するカジュアルなコンピュータユーザー</li>
<li>あなたがシステムを使用する前後に繰り返しシステムに読み書きアクセスをすることができるプロの暗号解読者</li>
<li>その中間</li>
</ul></li>
</ul>

<ul>
<li>どの暗号化ストラテジーを使用するのか?
<ul style="list-style-type:circle;color:#777;font-size:90%;line-height:1em;margin-top:0">
<li>データ暗号化</li>
<li>システム暗号化</li>
<li>その中間</li>
</ul></li></ul>

<ul>
<li>スワップや {{ic|/tmp}} などはどうすればいいか?
<ul style="list-style-type:circle;color:#777;font-size:90%;line-height:1em;margin-top:0">
<li>無視する、データが流出しないことを祈る</li>
<li>無効化する、または ramdisk としてマウント</li>
<li>暗号化する ''(完全なディスク暗号化の一部として、または別個に暗号化)''</li>
</ul></li></ul>

<ul>
<li>どうやってディスクの暗号化された部分を解除するか?
<ul style="list-style-type:circle;color:#777;font-size:90%;line-height:1em;margin-top:0">
<li>パスフレーズ ''(ログインパスワードと同じパスワード、または別個のパスワード)''</li>
<li>キーファイル ''(例: 安全な場所に置いたり常に持ち歩いている USB スティックに保存)''</li>
<li>両方</li>
</ul></li>
</ul>

<ul>
<li>ディスクの暗号化された部分を解除するのは''いつ''か?
<ul style="list-style-type:circle;color:#777;font-size:90%;line-height:1em;margin-top:0">
<li>起動する前</li>
<li>起動中</li>
<li>ログイン時</li>
<li>''(ログイン後に)'' 必要に応じて手動で</li>
</ul></li>
</ul>

<ul>
<li>複数のユーザーに便宜をはかるにはどうすればいいか?
<ul style="list-style-type:circle;color:#777;font-size:90%;line-height:1em;margin-top:0">
<li>気にしない</li>
<li>パスフレーズ/キーを共有する</li>
<li>ディスクの同一の暗号化部分に対して別個に発行・無効化できるパスフレーズ/キーを使う</li>
<li>ユーザーごとにディスクの暗号化部分を分ける</li>
</ul></li>
</ul>

さらに技術的な選択をする必要があります (上の [[#利用可能な手段]] や、下の [[#暗号化の仕組み]] を参照):

* スタックファイルシステムの暗号化 vs. ブロックデバイスの暗号化
* キーの管理
* 暗号と利用モード
* メタデータの保管
* "下位ディレクトリ"の場所 (スタックファイルシステムの暗号化を使う場合)

実際にやってみると、以下のような取り合わせが考えられると思われます:

;例 1: [[EncFS]] を使ってユーザーのホームディレクトリに "~/Private" という仮想フォルダを作って暗号化する、シンプルなデータ暗号化 (内蔵ハードドライブ) └──> ~/.Private のファイルは暗号化されてディスク上に保存されます └──> 必要に応じて専用のパスフレーズでロックを解除します 

;例 2: [[TrueCrypt]] で暗号化した USB ドライブによる、シンプルなデータ暗号化 (リムーバブルメディア) └──> コンピュータに接続したときにロックを解除します (専用のパスフレーズと、キーファイルを変換した ~/photos/2006-09-04a.jpg を使用)

;例 3: [[ECryptfs]] でそれぞれのユーザーの''ホームディレクトリ''を暗号化する、部分的なシステム暗号化 └──> 各々のユーザーのログイン時に、ログインパスフレーズを使ってロックを解除します └──> ''スワップ''と ''/tmp'' パーティションは [[dm-crypt|Dm-crypt と LUKS]] で暗号化して、セッションごとに自動生成される使い捨てのキーを使用 └──> slocate (やその他のアプリ) による /home の中身のインデックス作成/キャッシュは無効にする

;例 4: システム暗号化 - /boot パーティションを除いてハードドライブ全体を [[dm-crypt|Dm-crypt と LUKS]] で暗号化 └──> 起動中に、パスフレーズまたはキーファイルが保存された USB スティックを使ってロックを解除します └──> ユーザーごとに別々のパスフレーズ/キーを使用 - 別個に無効化可能 └──> [[Dm-crypt/システム全体の暗号化#LUKS on LVM|LUKS を LVM 上に配置]]して複数のドライブを跨ったりするパーティションレイアウトにおける暗号化の柔軟性を確保

;例 5: 徹底して隠されたシステム暗号化 - [[dm-crypt|plain dm-crypt]] によるハードドライブ全体の暗号化 └──> 専用のパスフレーズとキーファイルが入った USB スティックを使用して USB ブート └──> マウントする前にデータの状態をチェックします └──> /boot パーティションは先の USB スティック上に配置

もちろん他にも様々な組み合わせが考えられます。あなたのシステムにとってどのようなセットアップが適切か注意深く計画を練って下さい。

===強固なパスフレーズの選択===

[[セキュリティ#パスワード]]を見てください。

===ディスクの準備===

ディスク (の一部) に暗号化をセットアップする前に、まず確実にディスクを消去するようにしてください。ディスクを消去する際にはドライブ全体またはパーティション全体をゼロバイトやランダムなバイトのストリームで上書きします。これを行う理由は以下の通り:

<ul>
<li>'''以前に保存されていたデータのリカバリを防ぐ'''
たとえディスクを暗号化したとしても、実際のセクタは必要に応じて、ファイルシステムが特定のセクタにデータを作成したり修正したときにしか上書きされることはありません (下の [[#暗号化の仕組み]] を参照)。ファイルシステムから"使用されていない"セクタは弄られることがないため、前に使っていたファイルシステムのデータが残ってしまっている可能性があります。先にドライブに保存していたデータを完全に[[Wikipedia:Data_recovery|リカバリ]]不可能にするには、手動でデータを消去するしか道はないでしょう。 データを完全に消去するということについては、ゼロバイトを使用するかランダムバイトを使用するかの違いはありません (ゼロバイトで消去するほうが高速です)。
</li>

<li>'''暗号化されたドライブの利用状況の発覚を防ぐ'''
理想を言えば、ディスクの暗号化部分はランダムなデータと区別を付かないようにするほうが望ましいでしょう。暗号化データを含んでいるセクタの数を知ることができなくなるということ自体が (完全な機密性を確保する上で) 好ましいですし、暗号化を解除しようと試みる攻撃者に対してセキュリティを増すことにもつながります。 利用状況の発覚を防ぐということに関しては、高品質なランダムバイトを使用してディスクを消去するのが重要です。
</li>
</ul>

二番目の理由はブロックデバイスの暗号化をしている場合にのみ意味をなします。スタックファイルシステムの暗号化では簡単に暗号化データを突き止められてしまいます (ホストファイルシステムに暗号化されたファイルがあることは隠しようがありません)。また、たとえ特定のフォルダだけを暗号化したいという場合でも、暗号化されてない状態でフォルダに保存されていたファイルを削除するためには ([[Wikipedia:ja:フラグメンテーション|断片化]]している可能性があるため) パーティション全体を消去する必要があります。同一パーティションに別のフォルダが存在する場合、一度バックアップして、削除してから元のパーティションに戻すようにします。

ディスク消去することを決めたら、[[ディスクの完全消去]]の記事を参照してください。

{{Tip|ハードディスクドライブを完全に消去する方法を決めるときは、暗号化ドライブとして使用する以上、消去をするのは一回だけで十分だということを覚えておいてください。}}

==暗号化の仕組み==

このセクションは、一般的なディスク暗号化の心臓部である仕組みと方法についての高レベルなイントロダクションです。

技術的数学的な詳細にまで立ち入ることはありませんが (適当な技術書を読んで下さい)、システム管理者が理解しておくべき、暗号化セットアップの選択がユーザビリティやセキュリティにどう影響をあたえるのかという基礎知識を提供します。

===基本原理===

ディスクを暗号化するとき、各ブロックデバイス (スタックファイルシステムの暗号化の場合、個々のファイル) は等長の'''セクタ'''に分割されます。例えば512バイト (4096ビット) など。暗号化・復号化はセクタ単位で行われるので、ディスク上のブロックデバイスやファイルの n 番目のセクタには、元のデータの n 番目のセクタを暗号化したものが保存されます。

オペレーティングシステムやアプリケーションがブロックデバイス・ファイルから特定のデータを要求した場合、そのデータが含まれているセクタ全体がディスクから読み込まれて、即座に復号化され、一時的にメモリに保存されます:

╔═══════╗
sector 1 ║"???.."║
╠═══════╣ ╭┈┈┈┈┈╮
sector 2 ║"???.."║ ┊ key ┊
╠═══════╣ ╰┈┈┬┈┈╯
: : │
╠═══════╣ ▼ ┣┉┉┉┉┉┉┉┫
sector n ║"???.."║━━━━━━━(decryption)━━━━━━▶┋"abc.."┋ sector n
╠═══════╣ ┣┉┉┉┉┉┉┉┫
: :
╚═══════╝

encrypted unencrypted
blockdevice or data in RAM
file on disk

同じように、書き込み操作のときは、該当箇所のセクタが全て再暗号化されます (他のセクタに変更が加えられることはありません)。

データを暗号化・復号化するために、ディスク暗号化システムはディスクに関連付けられたユニークな秘密鍵を知る必要があります。暗号化されたブロックデバイスやフォルダをマウントするには、適切な鍵が必要です (以後「マスター鍵」と呼びます)。

暗号化のセキュリティでは鍵のエントロピーが一番重要です。ランダムに生成された一定の長さ (例えば32バイト=256ビット) のバイト文字列が望ましいですが、覚えづらい上にマウント時に手動で入力するのは苦痛です。

そこで2つの方法があります。1番目の方法はマスター鍵のエントロピーを増大させる暗号化アプリケーションです。通常は人間が扱える程度のパスフレーズが用いられます。様々なタイプの暗号化方法があり[[#比較表|比較表]]ではそれぞれの特徴を列記しています。そして、2番目の方法は高エントロピーのキーファイルを作成して暗号化するデータドライブとは別のメディアに保存する方式です。

''参照:''
* [[Wikipedia:ja:認証付き暗号]]

===鍵とキーファイルとパスフレーズ===

以下はキーファイルでマスター鍵を安全に保存する方法の例です:

<ul>
<li>'''''プレーンテキストのキーファイルに保存'''''

マスター鍵をファイルに保存するのは最も単純な方法です。ファイル (キーファイル) は USB メモリなどに保存して、安全な場所に保管しておき、ディスク上の暗号データをマウントしたいときだけコンピュータに接続します (例: 起動時やログイン時)。
</li>

<li>'''''パスフレーズで保護したキーファイルあるいはディスクに保存'''''

マスター鍵 (と暗号データ) は秘密のパスフレーズで保護することができます。暗号化したブロックデバイスやフォルダをマウントするたびに思い出して入力する必要があります。詳しくは下の[[#暗号メタデータ]]を見てください。

<li>'''''セッションごとにランダムに生成'''''

スワップ領域や {{ic|/tmp}} パーティションを暗号化する場合など、ときとしてマスター鍵を必ずしも保存しなくてよい場合があります。セッション毎に使い捨てのキーをランダムに生成するのであれば、ユーザーが何かする必要はありません。その場合、パーティションをアンマウントするとパーティションに書き込まれたデータを誰も復号化できなくなります。暗号化するのが一時ファイルなどの場合はそれで特に問題ありません。
</li>
</ul>

===暗号メタデータ===

暗号技術ではマスター鍵のセキュリティを守るために暗号化関数がよく使われます。暗号化されたデバイスがマウントされたとき、パスフレーズやキーファイルを暗号化関数に入れて、出てきた計算結果を使ってマスター鍵を解錠してデータを復号化します。

一般的なのはパスフレーズのいわゆる「キーストレッチング」です (「鍵導出関数」が使用されます)。パスフレーズはマウントキーとして使用し、実際のマスター鍵を復号化するのに使われます (マスター鍵は暗号化された状態で保存されます):

<pre>
╭┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╮ ╭┈┈┈┈┈┈┈┈┈┈┈╮
┊ mount passphrase ┊━━━━━⎛key derivation⎞━━━▶┊ mount key ┊
╰┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈╯ ,───⎝ function ⎠ ╰┈┈┈┈┈┬┈┈┈┈┈╯
╭──────╮ ╱ │
│ salt │───────────´ │
╰──────╯ │
╭─────────────────────╮ ▼ ╭┈┈┈┈┈┈┈┈┈┈┈┈╮
│ encrypted master key│━━━━━━━━━━━━━━━━━━━━━━(decryption)━━━▶┊ master key ┊
╰─────────────────────╯ ╰┈┈┈┈┈┈┈┈┈┈┈┈╯
</pre>

'''鍵導出関数''' (例: PBKDF2 や scrypt) は意図的に低速にしか動作しないようになっており (ハッシュ関数を何度も繰り返し使用します、例えば HMAC-SHA-512 を1000回実行)、総当り攻撃によってパスフレーズを見つけ出すことが事実上不可能です。正しいパスワードを持っているユーザーの場合、計算する必要があるのは一度だけなので、多少遅くても問題になりません。

また、ディスク暗号化をセットアップするときにランダムに生成される "'''salt'''" を追加引数として使います。salt は暗号メタデータに含まれ暗号化されていない状態で保存されます。セットアップのたびに異なる値となるため、あらかじめ計算済みのテーブルを使って鍵導出関数に対して総当り攻撃をすることが不可能になります。

'''暗号化されたマスター鍵'''は暗号化されたデータと一緒にディスク上に保存するため、暗号化データの機密性は完全に秘密のパスフレーズに依存します。

USB スティックなどのキーファイルに暗号化したマスター鍵を保存することでセキュリティをさらに向上させることも可能です。いわゆる'''二段階認証'''です: 暗号化されたデータにアクセスするにはあなただけが知っているもの (パスフレーズ) に加えて、あなただけが持っているもの (キーファイル) も必要となります。

二段階認証を実現する他の方法として、上記の鍵導出を強化してパスフレーズと (USB スティックなどに保存した) 外部のファイルに含まれるバイトデータを数学的に「ミックス」してから鍵導出関数に渡すという手段もあります。使用するファイルは何でもかまいません。通常の JPEG 画像などであれば[[#もっともらしい否認]]にも有効でしょう。画像ではありますが、ここでは同じ「キーファイル」となります。

導出したマスター鍵は暗号化ブロックデバイスやフォルダがマウントされている間だけ、メモリ上に安全に保管されます (カーネルのキーリングなど)。

通常はディスクデータを暗号化・復号化するのにマスター鍵が直接使われることはありません。例えば、スタックファイルシステム暗号化の場合、ファイルにはそれぞれ別々の暗号鍵が自動的に割り当てられます。ファイルを読み書きしたくなったら、最初にメイン鍵を使ってファイルの鍵を復号化してから、ファイルの中身が復号化・暗号化できるようになります:

╭┈┈┈┈┈┈┈┈┈┈┈┈╮
┊ master key ┊
''file on disk:'' ╰┈┈┈┈┈┬┈┈┈┈┈┈╯
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐ │
╎╭───────────────────╮╎ ▼ ╭┈┈┈┈┈┈┈┈┈┈╮
╎│ encrypted file key│━━━━(decryption)━━━▶┊ file key ┊
╎╰───────────────────╯╎ ╰┈┈┈┈┬┈┈┈┈┈╯
╎┌───────────────────┐╎ ▼ ┌┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┐
╎│ encrypted file │◀━━━━━━━━━━━━━━━━━(de/encryption)━━━▶┊ readable file ┊
╎│ contents │╎ ┊ contents ┊
╎└───────────────────┘╎ └┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┘
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘

同じように、スタックファイルシステム暗号化の場合、ファイル名を暗号化するときは別の鍵 (例: フォルダごとに割り振られた鍵) が使われます。

ブロックデバイス暗号化の場合、デバイスごと、つまり全てのデータで使われるのはひとつのマスター鍵です。一部のブロックデバイス暗号化では同一デバイスに複数のパスフレーズやキーファイルを割り当てることができますが、できないものもあります。上記の関数を使ってマスター鍵を保全する場合もあればキーのセキュリティを完全にユーザーに委ねる場合もあります。例として [[dm-crypt]] の plain モードと LUKS モードで使用される暗号パラメータで説明しましょう。

両方のモードで使用するパラメータを比較すると、dm-crypt の plain モードではキーファイルの場所に関するパラメータがあることに気づくでしょう (例: {{ic|--keyfile-size}}, {{ic|--keyfile-offset}})。dm-crypt の LUKS モードではキーファイルの場所を指定する必要はありません。各ブロックデバイスのヘッダーに暗号のメタデータが含まれるためです。ヘッダーには使用する暗号、暗号化されたマスター鍵、そして鍵導出に必要なパラメータが存在します。最後のパラメータは最初にマスター鍵を暗号化したときに使用したオプションから生成されます (例: {{ic|--iter-time}}, {{ic|--use-random}})。

暗号化手段のメリット・デメリットについては[[#比較表]]やそれぞれのページを参照してください。

''参照:''
* [[Wikipedia:ja:パスワード]]
* [[Wikipedia:ja:鍵 (暗号)]]
* [[Wikipedia:Key_management]]
* [[Wikipedia:ja:鍵導出関数]]

===暗号と利用モード===

与えられた暗号鍵を使って実際に暗号化データと非暗号化データ (つまり"平文"と"暗号文") を変換するのに使われるアルゴリズムは "'''cipher'''" と呼ばれます。

ディスク暗号化では等長なブロックのデータを処理する"ブロック暗号" (block cipher) が用いられます。ブロック長は16バイト (128ビット) などになります。執筆時点で、主に使われている暗号は以下のとおり:
{| class="wikitable" style="margin:0 5em 1.5em 5em;"
! scope="col" style="text-align:left" |
! scope="col" style="text-align:left" | ブロックサイズ
! scope="col" style="text-align:left" | キーサイズ
! scope="col" style="text-align:left" | 注記
|-
! scope="row" style="text-align:right" | [[Wikipedia:ja:Advanced_Encryption_Standard|AES]]
| 128 ビット
| 128, 192, 256 ビット
| ''アメリカ政府の "SECRET" または "TOP SECRET" の機密情報を保護するのに足ると NSA によって承認されています (192または256ビットのキーサイズの使用時)。''
|-
! scope="row" style="text-align:right" | [[Wikipedia:ja:Blowfish|Blowfish]]
| 64 ビット
| 32–448 ビット
| ''初期のパテントフリーでセキュアな暗号の一つであり誰でも使えるため、Linux ではかなり定着しています。''
|-
! scope="row" style="text-align:right" | [[Wikipedia:ja:Twofish|Twofish]]
| 128 ビット
| 128, 192, 256 ビット
| ''Blowfish の後継として開発されましたが、それほど幅広くは利用されていません。''
|-
! scope="row" style="text-align:right" | [[Wikipedia:ja:Serpent (暗号)|Serpent]]
| 128 ビット
| 128, 192, 256 ビット
| AES コンペティションの5つの最終候補の中で一番セキュアだと考えられています[[#参照|[10]]][[#参照|[11]]][[#参照|[12]]]。
|}

セクタの暗号化・復号化 ([[#基本原理|上を参照]]) を行うときはセクタを暗号のブロックサイズにあわせて小さなブロックに分割します。個々のブロックに暗号をどのように適用していくかは特定のルールセット (いわゆる"'''暗号利用モード'''") に従います。

特に手を加えずにそれぞれのブロックを独立して暗号化するのはセキュアではありません ("''電子符号表 (electronic codebook, ECB)''" モードと呼ばれます)。平文で同じ16バイトのテキストがあれば、暗号文も常に同じになるため、ディスクに保存されている暗号文から簡単にパターンを見つけ出すことができてしまいます。

実際に広く使われている利用モードは "''暗号ブロック連鎖 (cipher-block chaining, CBC)''" です。CBC モードでセクタを暗号化した場合、平文データの各ブロックは前のブロックの暗号文と数学的に混ぜ合わされてから暗号化されます。最初のブロックは前の暗号文がないため、"'''初期化ベクトル (IV)'''" と呼ばれる暗号メタデータに保存されている特殊な事前生成済みのデータブロックが使われます:

╭──────────────╮
│initialization│
│vector │
╰────────┬─────╯
╭ ╠══════════╣ ╭─key │ ┣┉┉┉┉┉┉┉┉┉┉┫
│ ║ ║ ▼ ▼ ┋ ┋ . START
┴ ║"????????"║◀━━━━(cipher)━━━━(+)━━━━━┋"Hello, W"┋ block ╱╰────┐
sector n ║ ║ ┋ ┋ 1 ╲╭────┘
of file or ║ ║──────────────────╮ ┋ ┋ '
blockdevice ╟──────────╢ ╭─key │ ┠┈┈┈┈┈┈┈┈┈┈┨
┬ ║ ║ ▼ ▼ ┋ ┋
│ ║"????????"║◀━━━━(cipher)━━━━(+)━━━━━┋"orld !!!"┋ block
│ ║ ║ ┋ ┋ 2
│ ║ ║──────────────────╮ ┋ ┋
│ ╟──────────╢ │ ┠┈┈┈┈┈┈┈┈┈┈┨
│ ║ ║ ▼ ┋ ┋
: : ... : ... ... : ... : ...

ciphertext plaintext
on disk in RAM

復号化するときは、手順が逆になります。

注目に値することの1つは、セクターごとに一意の初期化ベクトルを生成することです。最も簡単な選択は、セクター番号などのすぐに利用できる値から予測可能な方法で計算することです。ただし、これにより、システムに繰り返しアクセスする攻撃者が、いわゆる [[wikipedia:Watermarking_attack|watermarkingattack]] を実行できる可能性があります。これを防ぐために、'' 暗号化されたソルトセクター初期化ベクトル ( '''ESSIV''')'' と呼ばれる方法を使用して、潜在的な攻撃者に完全にランダムに見えるように初期化ベクトルを生成できます。

ディスク暗号化に利用できる他のより複雑な操作モードもいくつかあります。これらは、そのような攻撃に対する組み込みのセキュリティをすでに提供しています(したがって、 ESSIV を必要としません)。
暗号化されたデータの信頼性をさらに保証できるものもあります(つまり、キーにアクセスできない人によってデータが変更/破損されていないことを確認します)。

''参照:''
* [[Wikipedia:Disk_encryption_theory]]
* [[Wikipedia:ja:ブロック暗号]]
* [[Wikipedia:ja:暗号利用モード]]

===もっともらしい否認===

[[Wikipedia:Plausible deniability]] を参照してください。

== ディスク暗号化シナリオのバックアップ ==

データ損失から保護するために、ユーザーデータの [[バックアップ]] を作成します。一般に、暗号化されたデータのバックアップも暗号化する必要があります。

=== ブロックデバイスの暗号化 ===

複数のオプションがあり、暗号化コンテナが存在するディスクブロックデバイスをイメージとしてバックアップできます。 {{ic|/dev/sd''x''}} または暗号化されたコンテナ内のファイルシステムをバックアップできます。 {{ic|/dev/mapper/''dm_name''}} またはファイルをバックアップできます。例: [[rsync]] で。次のセクションでは、各オプションの長所と短所を示します。

==== ディスクブロックデバイスのバックアップ ====

ディスクブロックデバイスのバックアップは次のとおりです。

* 作業コピーと同じレベルのセキュリティでそのまま暗号化
* LUKS ヘッダーが含まれています
* 常にディスクブロックデバイスと同じ大きさ
* 増分バックアップ、圧縮、重複排除などの高度なバックアップ戦略を簡単に許可することはできません
* 暗号化コンテナも復元されるため、新しいディスクに簡単に復元できます

==== ファイルシステムまたはファイルのバックアップ ====

1つまたは複数のファイルのバックアップは次のとおりです。

* ''そのまま'' 暗号化されていない
* ネットワーク経由で転送する前、またはディスクに保存するときに暗号化する必要があり、追加の作業が必要です
* 必ずしも作業コピーと同じレベルのセキュリティで暗号化されているとは限りません
* LUKS ヘッダーは含まれていません
* ファイルシステムの使用済みスペースと同じ大きさのみ。たとえば、[[Partclone]]
* 増分バックアップ、圧縮、重複排除などの高度なバックアップ戦略を可能にします
* LUKS ヘッダーのバックアップを復元するなどして、暗号化コンテナを新しいディスクに手動で復元する必要があります

==== LUKS ヘッダーバックアップ ====

LUKS を使用している場合、[https://wiki.archlinux.jp/index.php/Dm-crypt/%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9%E3%81%AE%E6%9A%97%E5%8F%B7%E5%8C%96#.E3.83.90.E3.83.83.E3.82.AF.E3.82.A2.E3.83.83.E3.83.97.E3.81.A8.E3.83.AA.E3.82.B9.E3.83.88.E3.82.A2 dm-crypt/デバイスの暗号化#バックアップとリストア]を作成できます。特にパスフレーズが取り消されている場合は、これらのバックアップを定期的にチェックして同期するのが理にかなっています。

ただし、データのバックアップがあり、それを復元する場合は、cryptsetupを使用してLUKS暗号化パーティションを最初から再作成してからデータを復元できます。したがって、LUKSヘッダーのバックアップはデータのバックアップよりも重要ではありません。

==参照==

# [[#概要|^]] http://www.truecrypt.org/legal/license を参照
# [[#実用性|^]] ファイルシステムのひとつのファイルをコンテナとして使うことはできますが(仮想ループバックデバイス)、ファイルシステム(の機能)を使うことはできなくなります。
# [[#互換性と普及度|^]] [http://www.scherrer.cc/crypt CrossCrypt] - Windows XP や Windows 2000 と互換性のあるオープンソースの AES と TwoFish による Linux の暗号化
# [[#互換性と普及度|^]] (1) [https://sourceforge.net/projects/freeotfe.mirror/ FreeOTFE (on sf.net)] (2) [https://web.archive.org/web/20130531062457/http://freeotfe.org/ FreeOTFE (archived)] - Windows 2000 以上 (PC) や Windows Mobile 2003 以上 (PDA) をサポート
# [[#互換性と普及度|^]] [http://www.arg0.net/encfs-mac-build EncFs build instructions for Mac] を参照
# [[#互換性と普及度|^]] http://www.freshports.org/sysutils/fusefs-encfs/ を参照
# [[#互換性と普及度|^]] https://www.chromium.org/chromium-os/chromiumos-design-docs/protecting-cached-user-data を参照
# [[#互換性と普及度|^]] http://kernelnewbies.org/Linux_2_6_38#head-49f5f735853f8cc7c4d89e5c266fe07316b49f4c
# [[#互換性と普及度|^]] http://members.ferrara.linux.it/freddy77/encfs.html
# [[#互換性と普及度|^]] http://csrc.nist.gov/archive/aes/round2/r2report.pdf
# [[#互換性と普及度|^]] https://www.cl.cam.ac.uk/~rja14/Papers/serpentcase.pdf
# [[#互換性と普及度|^]] https://www.cl.cam.ac.uk/~rja14/Papers/serpent.pdf
# [[#パフォーマンス|^]] https://github.com/vgough/encfs/issues/118
# [[#互換性と普及度|^]] [https://github.com/t-d-k/LibreCrypt LibreCrypt] (旧名 [https://github.com/t-d-k/doxbox DOXBOX]) - 新しいバージョンの Windows におけるオープンな dm-crypt / LUKS のサポート (OTFE のフォークを含む)

Rsync

2022-01-29T10:40:21Z

Shota: 外国語 wiki へのリンクを追加 ( en:Special:PermanentLink/714198 に追従)

{{Lowercase title}}
[[Category:同期]]
[[Category:バックアップ]]
[[Category:コマンド]]
[[de:Rsync]]
[[en:Rsync]]
[[es:Rsync]]
[[fr:Rsync]]
[[ru:Rsync]]
[[zh-hans:Rsync]]
{{Related articles start}}
{{Related|rsync によるフルシステムバックアップ}}
{{Related|同期およびバックアッププログラム}}
{{Related articles end}}
[https://rsync.samba.org/ rsync] は高速な差分ファイル転送を行うオープンソースのユーティリティです。

== インストール ==

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

''rsync'' をソースマシンと転送先マシンの両方にインストールする必要があります。

=== フロントエンド ===

* {{App|Grsync|GTK フロントエンド|http://www.opbyte.it/grsync/|{{Pkg|grsync}}}}
* {{App|gutback|シェルで書かれた rsync ラッパー|https://github.com/gutenye/gutbackup|{{Aur|gutbackup}}}}
* {{App|JotaSync|スケジューラ内蔵の rsync 用 Java Swing GUI|https://trixon.se/projects/jotasync/|{{Aur|jotasync}}}}
* {{App|luckyBackup|C++ で書かれた Qt フロントエンド|http://luckybackup.sourceforge.net/index.html|{{Aur|luckybackup}}}}

その他に rsync を使っているツールは以下の通りです: {{Pkg|rdiff-backup}} 、 {{AUR|osync}}。

== cp/mv の代わりとして使う ==

{{Note|1=cp/mv の代わりに rsync を使う事は異なるファイルシステム間では効果的ですが、同じファイルシステム上でコピーや移動する為には効果はないです。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=271953] を参照してください。}}

rsync は {{ic|cp}} または {{ic|mv}} コマンドの上位互換として使うことができ、特に大きなファイルのコピーに役立ちます:

$ rsync -P source destination

{{ic|-P}} オプションは {{Ic|--partial --progress}} と同じで、一部ずつファイルを転送して、転送中にプログレスバーを表示します。

ディレクトリを再帰的にコピーしたいときは {{ic|-r --recursive}} オプションを使用し、相対パス名を使いたい時は {{ic|-R}} を使います (転送先のフォルダでフォルダ全体の階層を再生成します)。

{{ic|cp}} と同様にローカルにコピーする事に使えるだけでなく、例えば異なるホスト間といった、リモート同士でファイルをコピーする事にも使えます。リモートの場所はホスト-コロンシンタックスを使って指示できます:

$ rsync source host:destination

あるいは

$ rsync host:source destination

ネットワークを利用したファイルのやりとりには [[SSH]] をデフォルトで使い、{{ic|host}} は実際のホスト名かもしくは {{ic|.ssh/config}} で定義されたプロファイルやエイリアスで指示できます。

ローカルかリモートでのファイルのやりとりに関わらず、 rsync はまず始めにファイル情報を含むファイルリストを作成します (デフォルトでは、ファイル情報はサイズと最後に修正したタイムスタンプから成ります)。このファイルリストは次にファイルを構築する必要があるか否かの判断に利用されます。それぞれのファイルを構築する際には、それぞれのブロックが長さ '''S''' バイトでオーバーラップがなくまた長さ '''S''' で分割可能なようなオフセットを持つようにブロックに分けられ、弱いチェックサムと強いチェックサムを生成します。これら情報によって、rsync はファイル全体をやりとりすることなく巨大なファイルを構築することができます。実用的かつ数学的な詳細な説明は次にあるので参照してください: [https://rsync.samba.org/how-rsync-works.html rsync がどのように動作するか]、[https://rsync.samba.org/tech_report/tech_report.html rsync のアルゴリズム]。

実用的なデフォルトの設定を手早く使いたい場合は、次の様にしてエイリアスを定義できます:
{{bc|1=
cpr() {
rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 "$@"
}
mvr() {
rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 --remove-source-files "$@"
} }}

* {{ic|-hh}}: 数を読み易いフォーマット (human-readable format) で出力します
* {{ic|1=--info=stats1,progress2}}: {{ic|stats1}} は rsync のファイル移行の統計を verbosity level 1 で出力します。{{ic|progress2}} は全やりとりの進捗を出力し、{{ic|progress1}} はファイル毎に進捗を出力します。
* {{ic|1=--modify-window=1}}: 2つのファイルのタイムスタンプを比較する際に 1秒以下の違いがあっても同じタイムスタンプとして処理します。
* {{ic|--remove-source-files}}: 正常にファイルのやりとりができた後に、ソースディレクトリからファイルを削除します。

{{Note|ここでの「チェックサム」は {{ic|--checksum}} オプションでの振る舞いとは読み替えできません。{{ic|--checksum}} オプションはファイルの転送前に使用されるファイルスキップヒューリスティックに影響します。{{ic|--checksum}} とは無関係に、「チェックサム」は、rsync がどのようにファイルを転送するかという意味で、ブロックに基づくファイル構築に常に使われます。}}

=== 末尾のスラッシュに関する注意事項 ===

Arch はデフォルトで GNU cp (GNU {{Pkg|coreutils}} の一部) を使用します。ただし、rsync は BSD cp の規則に従います。これは、末尾にスラッシュ「/」が付いたソースディレクトリに特別な処理を与えます。

$ rsync -r source destination

ディレクトリ "destination/source" を "source" の内容で作成するのに対して、

$ rsync -r source/ destination

は "source/" 内のすべてのファイルを "destination" にコピーしてその間にサブディレクトリは置きません。もし次を実行した様になります

$ rsync -r source/. destination

GNU cp は "source" と "source/" を同じように扱うので ("source/." は違います)、これらの動作は GNU cp の動作とは異なります。また、シェルによっては、タブを補完するディレクトリ名の末尾にスラッシュを自動的に付加するものもあります。これらの要因のために、 rsync を初めて使う、あるいは時々使うユーザの間では、 rsync の異なる動作を忘れてしまい、コマンドラインの最後にあるスラッシュを忘れてしまうことで、混乱を招いたり、重要なファイルを上書きしたりする傾向があります。

したがって、ラッパースクリプトを使用して、rsync を呼び出す前に末尾のスラッシュを自動的に削除することが賢明です:

#!/bin/sh
new_args=();
for i in "$@"; do
case $i in /) i=/;; */) i=${i%/};; esac
new_args="$new_args $i";
done
exec rsync "${(@)new_args}"

このスクリプトをパスの通った場所に置き、シェルの init ファイル内で rsync というエイリアスを付けられます。

== バックアップユーティリティとして使う ==

rsync プロトコルは最後にバックアップされた時点から変更があったファイルだけを転送することができ、簡単にバックアップの為に使う事ができます。この節では、リムーバルメディアへコピーするといった、シンプルな定期的なバックアップスクリプトを紹介します。

=== 自動バックアップ ===

このサンプルを使うには、スクリプトを {{ic|/etc/cron.daily}} ディレクトリに作成して下さい。cron [[デーモン]]をインストールして適切に設定することで毎日実行せせるようになります。

まず、適切なコマンドオプションを含んだスクリプトを作成:

{{hc|/etc/cron.daily/backup|
#!/bin/sh
rsync -a --delete --quiet /path/to/backup /location/of/backup}}

* {{ic|-a}} : ファイルをアーカイブする。ファイルの属性も保存 (ただし ACL やハードリンク、ケイパビリティなどの拡張属性は除外)
* {{ic|--delete}} : バックアップ元で削除されたファイルはバックアップ先でも同じように削除する

ここで、{{ic|/path/to/backup}} はバックアップしたいものに (例えば {{ic|/home}})、{{ic|/location/of/backup}} はバックアップの保存先に変更します (例えば {{ic|/media/disk}})。

最後に、スクリプトを[[ヘルプ:読み方#実行可能属性の付与|実行可能]]にします:

=== SSH を使った自動バックアップ ===

[[SSH]] を使ってリモートホストにバックアップする場合、以下のスクリプトを使用:

{{hc|/etc/cron.daily/backup|
#!/bin/sh
rsync -a --delete --quiet -e ssh /path/to/backup remoteuser@remotehost:/location/of/backup
}}

* {{ic|-e ssh}} : rsync に SSH を使うことを教える
* {{ic|remoteuser}} : ホスト {{ic|remotehost}} のユーザー
* {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)

{{Note|Rsync は、インクリメンタルバックアップでもってソース元のマシンでの状態と合うようにターゲットマシンのファイルを更新しようとします。つまり、SSH を越えてルートユーザがオーナーであるファイルをバックアップする場合 (あるいは {{ic|-a}} などによってパーミッションやオーナシップを保とうとする場合) はターゲットマシンのルートアクセスが必要になります。自動的にこれを実行しようとする場合、SSH デーモンに [https://unix.stackexchange.com/a/92397 パスワード無しの公開鍵] を使ってルートユーザにログインすることを許可するように設定して、rsync をルート権限で実行することが良いでしょう。}}

=== NetworkManager を使った自動バックアップ ===

以下のスクリプトはケーブルを接続した時にバックアップを開始します。

まず、適当なコマンドオプションを含んだスクリプトを作成:

{{hc|/etc/NetworkManager/dispatcher.d/backup|2=
#!/bin/sh

if [ x"$2" = "xup" ] ; then
rsync --force --ignore-errors -a --delete --bwlimit=2000 --files-from=files.rsync /path/to/backup /location/of/backup
fi
}}

* {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)
* {{ic|--files-from}} : ファイルから {{ic|/path/to/backup}} の相対パスを読み込み
* {{ic|--bwlimit}} : I/O 帯域を制限、単位はキロバイト毎秒

このスクリプトの所有者をルートユーザにして下さい (詳しくは [[NetworkManager#ネットワークサービスと NetworkManager dispatcher|NetworkManager dispatcher]] を参照)。

=== systemd と inotify を使った自動バックアップ ===

{{Note|
* inotify と systemd の制限により ([http://www.quora.com/Linux-Kernel/Inotify-monitoring-of-directories-is-not-recursive-Is-there-any-specific-reason-for-this-design-in-Linux-kernel この質問と答え] を参照)、再帰的なファイルシステムの監視は不可能です。ディレクトリとその中身を監視することはできますが、サブディレクトリにまで再帰的に実行してその中身を監視することはされません。監視するディレクトリは全て明示的に指定する必要があります (ディレクトリが既に指定した監視ディレクトリの下にあっても記述する必要がある)。
* このセットアップは [[systemd/ユーザー]]インスタンスをベースにしています。
}}

[[cron]] の実装など、スケジュールによって適宜バックアップを実行するのではなく、この方法ではバックアップするファイルに変更があった度にバックアップを実行することが可能です。{{ic|systemd.path}} ユニットは {{ic|inotify}} を使ってファイルシステムを監視し、{{ic|systemd.service}} と一緒に使うことでファイルシステムのイベントに合わせてあらゆるプロセスを開始することができます (この場合は ''rsync'' のバックアップ)。

まず、バックアップするファイルを監視する {{ic|systemd.path}} ファイルを作成:

{{hc|~/.config/systemd/user/backup.path|<nowiki>
[Unit]
Description=Checks if paths that are currently being backed up have changed

[Path]
PathChanged=%h/documents
PathChanged=%h/music

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

そして変更を検出した時に実行される {{ic|systemd.service}} ファイルを作成します。デフォルトで、パスユニット (ここでは {{ic|backup.path}}) と同じ名前の、拡張子が {{ic|.path}} ではなく {{ic|.service}} のサービスファイルが実行されます (ここでは {{ic|backup.service}})。

{{Note|rsync コマンドを複数実行する必要がある場合は、{{ic|1=Type=oneshot}} を使って下さい。実行する ''rsync'' ごとに、複数の {{ic|1=ExecStart=}} パラメータを指定することができます。もしくは、[[cron]] スクリプトなど、バックアップ作業を全て実行するスクリプトを書いても良いでしょう。}}

{{hc|~/.config/systemd/user/backup.service|<nowiki>
[Unit]
Description=Backs up files

[Service]
ExecStart=/usr/bin/rsync %h/./documents %h/./music -CERrltm --delete ubuntu:</nowiki>}}

これで後は通常の systemd サービスと同じように {{ic|backup.path}} を起動・有効化するだけです。ファイルの変更の監視を始めて {{ic|backup.service}} を自動的に起動します:

=== 一週間ごとに差分バックアップ ===

実行毎の完全なバックアップを作成して、ファイルに変更があったものだけの差分バックアップのコピーを分かれたディレクトリに保持しつつ、一週間ごとに差分バックアップを行う便利な rsync のオプションです。

まず、適当なコマンドオプションを含むスクリプトを作成:

{{hc|/etc/cron.daily/backup|2=
#!/bin/sh

DAY=$(date +%A)

if [ -e /location/to/backup/incr/$DAY ] ; then
rm -fr /location/to/backup/incr/$DAY
fi

rsync -a --delete --quiet --inplace --backup --backup-dir=/location/to/backup/incr/$DAY /path/to/backup/ /location/to/backup/full/
}}

{{ic|--inplace}} オプションは {{ic|--partial}} を伴ない、転送先のファイルを所定の場所に更新します。

=== スナップショットバックアップ ===

同じアイデアを使ってファイルのスナップショットのツリーを作ることができます。言い換えれば、ファイルのコピーが含まれる日付順のディレクトリです。コピーはハードリンクで作られ、変更があったファイルだけが場所を取ります。これは Apple の TimeMachine で使われているアイデアです。

次の基本的なスクリプトは簡単な実装であり、変更がないファイルへハードリンクさせる {{ic|--link-dest}} オプションを使って素早くインクリメンタルスナップショットを生成します:

{{hc|/usr/local/bin/snapbackup.sh|<nowiki>
#!/bin/sh

# Basic snapshot-style rsync backup script

# Config
OPT="-aPh"
LINK="--link-dest=/snapshots/username/last/"
SRC="/home/username/files/"
SNAP="/snapshots/username/"
LAST="/snapshots/username/last"
date=`date "+%Y-%b-%d:_%T"`

# Run rsync to create snapshot
rsync $OPT $LINK $SRC ${SNAP}$date

# Remove symlink to previous snapshot
rm -f $LAST

# Create new symlink to latest snapshot for the next backup to hardlink
ln -s ${SNAP}$date $LAST
</nowiki>}}

{{ic|--link-dest}} のために既にターゲットに存在しているフルバックアップへのシンボリックリンクが必須です。最新のスナップショットが削除された場合、最新のスナップショットへのシンボリックリンクを再生成する必要があります。{{ic|--link-dest}} が動作しているシンボリックリンクを見付けられなかった場合、rsync は差分だけでなくソースファイルの全てをコピーします。

より精錬されたバージョンは、{{ic|$SNAP/lates}} の最新のフルバックアップと最後のバックアップからの数回分の変更を保持します。現在のフルバックアップのスナップショット {{ic|$SNAP/$DATETAG}} を、変更がないファイルへハードリンクさせるために {{ic|cp -al}} を使って生成します:

{{hc|/usr/local/bin/rsnapshot.sh|<nowiki>
#!/bin/sh

## my own rsync-based snapshot-style backup procedure
## (cc) marcio rps AT gmail.com

# config vars

SRC="/home/username/files/" #dont forget trailing slash!
SNAP="/snapshots/username"
OPTS="-rltgoi --delay-updates --delete --chmod=a-w"
MINCHANGES=20

# run this process with real low priority

ionice -c 3 -p $$
renice +12 -p $$

# sync

rsync $OPTS $SRC $SNAP/latest >> $SNAP/rsync.log

# check if enough has changed and if so
# make a hardlinked copy named as the date

COUNT=$( wc -l $SNAP/rsync.log|cut -d" " -f1 )
if [ $COUNT -gt $MINCHANGES ] ; then
DATETAG=$(date +%Y-%m-%d)
if [ ! -e $SNAP/$DATETAG ] ; then
cp -al $SNAP/latest $SNAP/$DATETAG
chmod u+w $SNAP/$DATETAG
mv $SNAP/rsync.log $SNAP/$DATETAG
chmod u-w $SNAP/$DATETAG
fi
fi
</nowiki>}}

このスクリプトを systemd の[[systemd/タイマー|タイマー]]ユニットから実行することで、ぐっとシンプルにできます。

=== システムのフルバックアップ ===

このセクションでは、 ''rsync'' を使用して、選択したいくつかのディレクトリを除く {{ic|/}} ツリー全体のコピーを転送する方法について説明します。このアプローチは、 {{ic|dd}} を使用した [[ディスクのクローン]] よりも優れていると考えられます。これは、異なるサイズ、パーティションテーブル、およびファイルシステムを使用できるためであり、 {{ic|cp-a}} を使用したコピーよりも優れているためです。これにより、ファイルのアクセス許可、属性、 [[アクセス制御リスト]] および [[ファイルのパーミッションと属性#拡張属性|拡張属性]] をより細かく制御できるようになります。

''rsync'' はシステムの実行中でも機能しますが、転送中に変更されたファイルは転送される場合とされない場合があり、転送されたファイルを使用する一部のプログラムの未定義の動作を引き起こす可能性があります。

このアプローチは、既存のインストールを新しい HDD または [[SSD]] に移行する場合に適しています。

rootとして次のコマンドを実行して下さい。root権限で実行することで rsync がすべてのシステムファイルにアクセスし、所有権を保持できます:

# rsync -aAXHv --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} / ''/path/to/backup''

{{ic|-aAX}} のオプションセットを使用することにより、ファイルはアーカイブモードで転送され、シンボリックリンク、デバイス、アクセス許可、所有権、変更時間、 [[ACL]]、および拡張属性が保持されます。ターゲット [[ファイルシステム]] がこの機能をサポートしていると仮定します。オプション {{ic|-H}} はハードリンクを保持しますが、より多くのメモリを使用します。

{{ic|--exclude}} オプションを指定すると、指定したパターンに一致するファイルが除外されます。ディレクトリ {{ic|/dev}}}、 {{ic|/proc}}、 {{ic|/sys}}、 {{ic|/tmp}}、 {{ic|/run}} は上記のコマンドに含まれますが、これらのディレクトリの ''内容'' は除外されます。これは、起動時にはディレクトリが作成されますが、ディレクトリ自体は作成されないためです。{{ic|/lost+found}}はファイルシステム固有です。上記のコマンドは、 [https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html bash]および [http://zsh.sourceforge.net/Doc/Release/Expansion.html#Brace-Expansion zsh] シェルの両方で使用できるブレース展開に依存します。別の [[シェル]] を使用する場合は、 {{ic|--exclude}} パターンを手動で繰り返す必要があります。除外パターンを引用符で囲むと、 [[シェル]] による展開が回避されます。これは、たとえば [[SSH]] のバックアップ時に必要です。除外パスの最後に {{ic|*}} を指定すると、ディレクトリ自体がまだ存在しない場合でも作成されます。

{{Note|
* {{ic|/mnt}} または {{ic|/media}} 以外の場所でシステムをバックアップする場合は、無限ループを回避するために、除外パターンのリストにシステムを追加することを忘れないでください。
*システムにバインドマウントがある場合は、それらも除外して、バインドマウントされたコンテンツが1回だけコピーされるようにする必要があります。
※[[スワップファイル]] を使用する場合は、必ず除外してください。
* {{ic|/home/}} ディレクトリをバックアップするかどうかを検討してください。データが含まれている場合は、システムよりもかなり大きくなる可能性があります。それ以外の場合は、 {{ic|/home/*/.thumbnails/*}}, {{ic|/home/*/.cache/mozilla/*}}, {{ic|/home/*/.cache/chromium/*}}, と {{ic|/home/*/.local/share/Trash/*}} などの重要でないサブディレクトリを除外することを検討してください。 {{ic|/home/*/.local/share/Trash/*}} は、システムにインストールされているソフトウェアによって異なります。
* [[GVFS]] がインストールされている場合、 rsync エラーを防ぐために、 {{ic|/home/*/.gvfs}} を除外する必要があります。
* [[Dhcpcd]] ≥9.0.0 がインストールされている場合は、 {{ic|/var/lib/dhcpcd/*}} ディレクトリを除外します。これは、いくつかのシステムディレクトリをサブディレクトリとしてマウントするためです。
}}

追加の [[rsync]] オプションを含めるか、次のようないくつかを削除することをお勧めします。完全なリストについては、 {{man|1|rsync}} を参照してください。

* メモリが非常に少ないシステムで実行している場合は、 {{ic|-H}} オプションを削除することを検討してください。ただし、最近のほとんどのマシンでは問題ありません。使用するソフトウェアによっては、ファイルシステムに多くのハードリンクが存在する可能性があります(たとえば、 [[Flatpak]] を使用している場合)。多くのハードリンクは {{ic|/usr/}} ディレクトリの下にあります。
* これを同じバックアップディレクトリで複数回実行している場合は、rsync の {{ic|--delete}} オプションを追加することをお勧めします。この場合、ソースパスが {{ic|/*}} で終わっていないことを確認してください。そうでない場合、このオプションはソースディレクトリのサブディレクトリ内のファイルにのみ影響しますが、存在するファイルには影響しません。
* 仮想ディスク、 [[Docker]] イメージなどのスパースファイルを使用する場合は、 {{ic|-S}} オプションを追加する必要があります。
* {{ic|--numeric-ids}} オプションは、ユーザー名とグループ名のマッピングを無効にします。代わりに、数値のグループ ID とユーザー ID が転送されます。これは、 [[SSH]] を介してバックアップする場合、またはライブシステムを使用して別のシステムディスクをバックアップする場合に役立ちます。
* {{ic|-v}} の代わりに {{ic|1=-info=progress2}} オプションを選択すると、転送されるファイルのリストではなく、全体的な進行状況情報と転送速度が表示されます。
* 再帰時にファイルシステムの境界を越えないようにするには、オプション {{ic|-x}}/{{ic|--one-file-system}} を追加します。これにより、階層内のマウントポイントをバックアップできなくなります。

=== バックアップを復元する ===

バックアップを復元する場合は、実行されたのと同じ rsync コマンドを使用しますが、ソースと宛先を逆にします。

== ファイルシステムのクローニング ==

rsync は、ファイルシステムのメタデータを含む可能な限り多くの情報を保持しながら、ファイルシステム内のすべてのデータのコピーを実行する方法を提供します。これは、ソースファイルシステムと宛先ファイルシステムが同じタイプである必要がないファイルシステムレベルでのデータ複製の手順です。バックアップ、ファイルシステムの移行、またはデータ復旧に使用できます。

rsync の "アーカイブ" モードは、アクセス制御リスト、拡張属性、スパースファイルプロパティなどの特別なファイルシステムメタデータはバックアップされません。ファイルシステムレベルでのクローンを成功させるには、いくつかのオプションを追加する必要があります。

rsync -qaHAXS SOURCE_DIR DESTINATION_DIR

それらの意味は (manpageから):

--hard-links, -H preserve hard links
--acls, -A preserve ACLs (implies --perms)
--xattrs, -X preserve extended attributes
--sparse, -S turn sequences of nulls into sparse blocks

さらに、コピーから除外するツリーの下に他のファイルシステムがマウントされている場合は、 {{ic|-x}} を使用します。
生成されたコピーは、 {{ic|diff}} の再帰オプションを使用して、ファイルシステムレベルで簡単に再読み取りおよびチェックできます(たとえば、データ回復の試行後)。

diff -r SOURCE_DIR DESTINATION_DIR

rsync を使用し、 [[新しいハードウェアに移行する]] で説明されているように [[fstab]] と [[ブートローダー]] を更新することで、ファイルシステムの移行を成功させることができます。これは基本的に、ルートファイルシステムを別のルートファイルシステムに変換する時にも適しています。

== rsync デーモン ==

''rsync'' は、ポート {{ic|873}} で待機しているサーバー上でデーモンとして実行できます。

テンプレート {{ic|/etc/rsyncd.conf}} を編集して共有を構成し、 {{ic|rsyncd.service}} を [[systemd#ユニットを使う|スタート]] します。

{{Note| {{Pkg|rsync}} 3.2.0-1 の時点で、パッケージはアップストリーム systemd ユニットファイル {{ic|rsyncd.service}} と {{ic|rsyncd@.service}} を採用しました。 {{ic|1=ProtectHome}} の変更についてコメントがあり、 {{ic|[Service]}} セクションのセキュリティ機能 {{ic|1=ProtectSystem=full}} は引き続きアクティブです。これにより、 {{ic|/boot/}}、 {{ic|/etc/}}、および {{ic|/usr/}} ディレクトリが読み取り専用になります。 rsyncd 書き込みシステムディレクトリが必要な場合は、ユニットを [[systemd#ユニットファイルの編集|編集]] して、オーバーライドするスニペットの {{ic|[Service]}} セクションで {{ic|1=ProtectSystem=off}} を設定できます。}}

クライアントからの使用

例:サーバーコンテンツの一覧表示:

$ rsync rsync://''server/share''

クライアントからサーバーにファイルを転送する:

$ rsync ''local-file'' rsync://''server/share/''

ポート {{ic|873}} とユーザー認証を開くための iptables を検討してください。

{{Note|ユーザー認証を含むすべての転送データは暗号化されていません。}}

=== 設定例 ===

==== ファイルのリストから共有する ====

{{hc|1=/etc/rsyncd.conf|2=
...

# Needed when crossing filesystem boundaries.
#use chroot = no
read only = yes

...

[sync]
path = /
# List of files to copy.
include from = /backup.list
# Exclude the rest.
exclude = *
}}

ファイルリスト内では、ワイルドカード {{ic|***}} が使用されている場合を除き、すべての ''中間パス'' が必要です:

{{hc|/backup.list|
/etc/
/etc/conf.d/
/etc/conf.d/hwclock
/etc/fonts/***
}}

== 参照 ==

* その他の使用例は、こちらで検索できます。 [https://bbs.archlinux.org/viewforum.php?id=27 Community Contributions] , [https://bbs.archlinux.org/viewforum.php?id=33 General Programming] フォーラム
* [https://www.pointsoftware.ch/2012/09/12/howto-local-and-remote-snapshot-backup-using-rsync-with-hard-links/ Howto – local and remote snapshot backup using rsync with hard links] ハードリンクやMD5インテグリティシグネチャ、'chattr' 保護、フィルタールール、ディスククオータ、リテンションポリシー（新しいファイルを保存する時のバックアップローテーション) とファイル重複排除といった内容があります。
* [https://stackoverflow.com/questions/5527068/how-do-you-use-an-identity-file-with-rsync Using SSH keys/identity files with rsync]
* [https://www.fosslinux.com/41713/top-20-rsync-examples-in-linux.htm Linuxでのトップ20のRsyncサンプル]

Rsync

2022-01-29T10:35:40Z

Shota: 関連記事の参照先を修正

{{Lowercase title}}
[[Category:同期]]
[[Category:バックアップ]]
[[Category:コマンド]]
[[en:Rsync]]
[[es:Rsync]]
[[zh-hans:Rsync]]
{{Related articles start}}
{{Related|rsync によるフルシステムバックアップ}}
{{Related|同期およびバックアッププログラム}}
{{Related articles end}}
[https://rsync.samba.org/ rsync] は高速な差分ファイル転送を行うオープンソースのユーティリティです。

== インストール ==

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

''rsync'' をソースマシンと転送先マシンの両方にインストールする必要があります。

=== フロントエンド ===

* {{App|Grsync|GTK フロントエンド|http://www.opbyte.it/grsync/|{{Pkg|grsync}}}}
* {{App|gutback|シェルで書かれた rsync ラッパー|https://github.com/gutenye/gutbackup|{{Aur|gutbackup}}}}
* {{App|JotaSync|スケジューラ内蔵の rsync 用 Java Swing GUI|https://trixon.se/projects/jotasync/|{{Aur|jotasync}}}}
* {{App|luckyBackup|C++ で書かれた Qt フロントエンド|http://luckybackup.sourceforge.net/index.html|{{Aur|luckybackup}}}}

その他に rsync を使っているツールは以下の通りです: {{Pkg|rdiff-backup}} 、 {{AUR|osync}}。

== cp/mv の代わりとして使う ==

{{Note|1=cp/mv の代わりに rsync を使う事は異なるファイルシステム間では効果的ですが、同じファイルシステム上でコピーや移動する為には効果はないです。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=271953] を参照してください。}}

rsync は {{ic|cp}} または {{ic|mv}} コマンドの上位互換として使うことができ、特に大きなファイルのコピーに役立ちます:

$ rsync -P source destination

{{ic|-P}} オプションは {{Ic|--partial --progress}} と同じで、一部ずつファイルを転送して、転送中にプログレスバーを表示します。

ディレクトリを再帰的にコピーしたいときは {{ic|-r --recursive}} オプションを使用し、相対パス名を使いたい時は {{ic|-R}} を使います (転送先のフォルダでフォルダ全体の階層を再生成します)。

{{ic|cp}} と同様にローカルにコピーする事に使えるだけでなく、例えば異なるホスト間といった、リモート同士でファイルをコピーする事にも使えます。リモートの場所はホスト-コロンシンタックスを使って指示できます:

$ rsync source host:destination

あるいは

$ rsync host:source destination

ネットワークを利用したファイルのやりとりには [[SSH]] をデフォルトで使い、{{ic|host}} は実際のホスト名かもしくは {{ic|.ssh/config}} で定義されたプロファイルやエイリアスで指示できます。

ローカルかリモートでのファイルのやりとりに関わらず、 rsync はまず始めにファイル情報を含むファイルリストを作成します (デフォルトでは、ファイル情報はサイズと最後に修正したタイムスタンプから成ります)。このファイルリストは次にファイルを構築する必要があるか否かの判断に利用されます。それぞれのファイルを構築する際には、それぞれのブロックが長さ '''S''' バイトでオーバーラップがなくまた長さ '''S''' で分割可能なようなオフセットを持つようにブロックに分けられ、弱いチェックサムと強いチェックサムを生成します。これら情報によって、rsync はファイル全体をやりとりすることなく巨大なファイルを構築することができます。実用的かつ数学的な詳細な説明は次にあるので参照してください: [https://rsync.samba.org/how-rsync-works.html rsync がどのように動作するか]、[https://rsync.samba.org/tech_report/tech_report.html rsync のアルゴリズム]。

実用的なデフォルトの設定を手早く使いたい場合は、次の様にしてエイリアスを定義できます:
{{bc|1=
cpr() {
rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 "$@"
}
mvr() {
rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 --remove-source-files "$@"
} }}

* {{ic|-hh}}: 数を読み易いフォーマット (human-readable format) で出力します
* {{ic|1=--info=stats1,progress2}}: {{ic|stats1}} は rsync のファイル移行の統計を verbosity level 1 で出力します。{{ic|progress2}} は全やりとりの進捗を出力し、{{ic|progress1}} はファイル毎に進捗を出力します。
* {{ic|1=--modify-window=1}}: 2つのファイルのタイムスタンプを比較する際に 1秒以下の違いがあっても同じタイムスタンプとして処理します。
* {{ic|--remove-source-files}}: 正常にファイルのやりとりができた後に、ソースディレクトリからファイルを削除します。

{{Note|ここでの「チェックサム」は {{ic|--checksum}} オプションでの振る舞いとは読み替えできません。{{ic|--checksum}} オプションはファイルの転送前に使用されるファイルスキップヒューリスティックに影響します。{{ic|--checksum}} とは無関係に、「チェックサム」は、rsync がどのようにファイルを転送するかという意味で、ブロックに基づくファイル構築に常に使われます。}}

=== 末尾のスラッシュに関する注意事項 ===

Arch はデフォルトで GNU cp (GNU {{Pkg|coreutils}} の一部) を使用します。ただし、rsync は BSD cp の規則に従います。これは、末尾にスラッシュ「/」が付いたソースディレクトリに特別な処理を与えます。

$ rsync -r source destination

ディレクトリ "destination/source" を "source" の内容で作成するのに対して、

$ rsync -r source/ destination

は "source/" 内のすべてのファイルを "destination" にコピーしてその間にサブディレクトリは置きません。もし次を実行した様になります

$ rsync -r source/. destination

GNU cp は "source" と "source/" を同じように扱うので ("source/." は違います)、これらの動作は GNU cp の動作とは異なります。また、シェルによっては、タブを補完するディレクトリ名の末尾にスラッシュを自動的に付加するものもあります。これらの要因のために、 rsync を初めて使う、あるいは時々使うユーザの間では、 rsync の異なる動作を忘れてしまい、コマンドラインの最後にあるスラッシュを忘れてしまうことで、混乱を招いたり、重要なファイルを上書きしたりする傾向があります。

したがって、ラッパースクリプトを使用して、rsync を呼び出す前に末尾のスラッシュを自動的に削除することが賢明です:

#!/bin/sh
new_args=();
for i in "$@"; do
case $i in /) i=/;; */) i=${i%/};; esac
new_args="$new_args $i";
done
exec rsync "${(@)new_args}"

このスクリプトをパスの通った場所に置き、シェルの init ファイル内で rsync というエイリアスを付けられます。

== バックアップユーティリティとして使う ==

rsync プロトコルは最後にバックアップされた時点から変更があったファイルだけを転送することができ、簡単にバックアップの為に使う事ができます。この節では、リムーバルメディアへコピーするといった、シンプルな定期的なバックアップスクリプトを紹介します。

=== 自動バックアップ ===

このサンプルを使うには、スクリプトを {{ic|/etc/cron.daily}} ディレクトリに作成して下さい。cron [[デーモン]]をインストールして適切に設定することで毎日実行せせるようになります。

まず、適切なコマンドオプションを含んだスクリプトを作成:

{{hc|/etc/cron.daily/backup|
#!/bin/sh
rsync -a --delete --quiet /path/to/backup /location/of/backup}}

* {{ic|-a}} : ファイルをアーカイブする。ファイルの属性も保存 (ただし ACL やハードリンク、ケイパビリティなどの拡張属性は除外)
* {{ic|--delete}} : バックアップ元で削除されたファイルはバックアップ先でも同じように削除する

ここで、{{ic|/path/to/backup}} はバックアップしたいものに (例えば {{ic|/home}})、{{ic|/location/of/backup}} はバックアップの保存先に変更します (例えば {{ic|/media/disk}})。

最後に、スクリプトを[[ヘルプ:読み方#実行可能属性の付与|実行可能]]にします:

=== SSH を使った自動バックアップ ===

[[SSH]] を使ってリモートホストにバックアップする場合、以下のスクリプトを使用:

{{hc|/etc/cron.daily/backup|
#!/bin/sh
rsync -a --delete --quiet -e ssh /path/to/backup remoteuser@remotehost:/location/of/backup
}}

* {{ic|-e ssh}} : rsync に SSH を使うことを教える
* {{ic|remoteuser}} : ホスト {{ic|remotehost}} のユーザー
* {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)

{{Note|Rsync は、インクリメンタルバックアップでもってソース元のマシンでの状態と合うようにターゲットマシンのファイルを更新しようとします。つまり、SSH を越えてルートユーザがオーナーであるファイルをバックアップする場合 (あるいは {{ic|-a}} などによってパーミッションやオーナシップを保とうとする場合) はターゲットマシンのルートアクセスが必要になります。自動的にこれを実行しようとする場合、SSH デーモンに [https://unix.stackexchange.com/a/92397 パスワード無しの公開鍵] を使ってルートユーザにログインすることを許可するように設定して、rsync をルート権限で実行することが良いでしょう。}}

=== NetworkManager を使った自動バックアップ ===

以下のスクリプトはケーブルを接続した時にバックアップを開始します。

まず、適当なコマンドオプションを含んだスクリプトを作成:

{{hc|/etc/NetworkManager/dispatcher.d/backup|2=
#!/bin/sh

if [ x"$2" = "xup" ] ; then
rsync --force --ignore-errors -a --delete --bwlimit=2000 --files-from=files.rsync /path/to/backup /location/of/backup
fi
}}

* {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)
* {{ic|--files-from}} : ファイルから {{ic|/path/to/backup}} の相対パスを読み込み
* {{ic|--bwlimit}} : I/O 帯域を制限、単位はキロバイト毎秒

このスクリプトの所有者をルートユーザにして下さい (詳しくは [[NetworkManager#ネットワークサービスと NetworkManager dispatcher|NetworkManager dispatcher]] を参照)。

=== systemd と inotify を使った自動バックアップ ===

{{Note|
* inotify と systemd の制限により ([http://www.quora.com/Linux-Kernel/Inotify-monitoring-of-directories-is-not-recursive-Is-there-any-specific-reason-for-this-design-in-Linux-kernel この質問と答え] を参照)、再帰的なファイルシステムの監視は不可能です。ディレクトリとその中身を監視することはできますが、サブディレクトリにまで再帰的に実行してその中身を監視することはされません。監視するディレクトリは全て明示的に指定する必要があります (ディレクトリが既に指定した監視ディレクトリの下にあっても記述する必要がある)。
* このセットアップは [[systemd/ユーザー]]インスタンスをベースにしています。
}}

[[cron]] の実装など、スケジュールによって適宜バックアップを実行するのではなく、この方法ではバックアップするファイルに変更があった度にバックアップを実行することが可能です。{{ic|systemd.path}} ユニットは {{ic|inotify}} を使ってファイルシステムを監視し、{{ic|systemd.service}} と一緒に使うことでファイルシステムのイベントに合わせてあらゆるプロセスを開始することができます (この場合は ''rsync'' のバックアップ)。

まず、バックアップするファイルを監視する {{ic|systemd.path}} ファイルを作成:

{{hc|~/.config/systemd/user/backup.path|<nowiki>
[Unit]
Description=Checks if paths that are currently being backed up have changed

[Path]
PathChanged=%h/documents
PathChanged=%h/music

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

そして変更を検出した時に実行される {{ic|systemd.service}} ファイルを作成します。デフォルトで、パスユニット (ここでは {{ic|backup.path}}) と同じ名前の、拡張子が {{ic|.path}} ではなく {{ic|.service}} のサービスファイルが実行されます (ここでは {{ic|backup.service}})。

{{Note|rsync コマンドを複数実行する必要がある場合は、{{ic|1=Type=oneshot}} を使って下さい。実行する ''rsync'' ごとに、複数の {{ic|1=ExecStart=}} パラメータを指定することができます。もしくは、[[cron]] スクリプトなど、バックアップ作業を全て実行するスクリプトを書いても良いでしょう。}}

{{hc|~/.config/systemd/user/backup.service|<nowiki>
[Unit]
Description=Backs up files

[Service]
ExecStart=/usr/bin/rsync %h/./documents %h/./music -CERrltm --delete ubuntu:</nowiki>}}

これで後は通常の systemd サービスと同じように {{ic|backup.path}} を起動・有効化するだけです。ファイルの変更の監視を始めて {{ic|backup.service}} を自動的に起動します:

=== 一週間ごとに差分バックアップ ===

実行毎の完全なバックアップを作成して、ファイルに変更があったものだけの差分バックアップのコピーを分かれたディレクトリに保持しつつ、一週間ごとに差分バックアップを行う便利な rsync のオプションです。

まず、適当なコマンドオプションを含むスクリプトを作成:

{{hc|/etc/cron.daily/backup|2=
#!/bin/sh

DAY=$(date +%A)

if [ -e /location/to/backup/incr/$DAY ] ; then
rm -fr /location/to/backup/incr/$DAY
fi

rsync -a --delete --quiet --inplace --backup --backup-dir=/location/to/backup/incr/$DAY /path/to/backup/ /location/to/backup/full/
}}

{{ic|--inplace}} オプションは {{ic|--partial}} を伴ない、転送先のファイルを所定の場所に更新します。

=== スナップショットバックアップ ===

同じアイデアを使ってファイルのスナップショットのツリーを作ることができます。言い換えれば、ファイルのコピーが含まれる日付順のディレクトリです。コピーはハードリンクで作られ、変更があったファイルだけが場所を取ります。これは Apple の TimeMachine で使われているアイデアです。

次の基本的なスクリプトは簡単な実装であり、変更がないファイルへハードリンクさせる {{ic|--link-dest}} オプションを使って素早くインクリメンタルスナップショットを生成します:

{{hc|/usr/local/bin/snapbackup.sh|<nowiki>
#!/bin/sh

# Basic snapshot-style rsync backup script

# Config
OPT="-aPh"
LINK="--link-dest=/snapshots/username/last/"
SRC="/home/username/files/"
SNAP="/snapshots/username/"
LAST="/snapshots/username/last"
date=`date "+%Y-%b-%d:_%T"`

# Run rsync to create snapshot
rsync $OPT $LINK $SRC ${SNAP}$date

# Remove symlink to previous snapshot
rm -f $LAST

# Create new symlink to latest snapshot for the next backup to hardlink
ln -s ${SNAP}$date $LAST
</nowiki>}}

{{ic|--link-dest}} のために既にターゲットに存在しているフルバックアップへのシンボリックリンクが必須です。最新のスナップショットが削除された場合、最新のスナップショットへのシンボリックリンクを再生成する必要があります。{{ic|--link-dest}} が動作しているシンボリックリンクを見付けられなかった場合、rsync は差分だけでなくソースファイルの全てをコピーします。

より精錬されたバージョンは、{{ic|$SNAP/lates}} の最新のフルバックアップと最後のバックアップからの数回分の変更を保持します。現在のフルバックアップのスナップショット {{ic|$SNAP/$DATETAG}} を、変更がないファイルへハードリンクさせるために {{ic|cp -al}} を使って生成します:

{{hc|/usr/local/bin/rsnapshot.sh|<nowiki>
#!/bin/sh

## my own rsync-based snapshot-style backup procedure
## (cc) marcio rps AT gmail.com

# config vars

SRC="/home/username/files/" #dont forget trailing slash!
SNAP="/snapshots/username"
OPTS="-rltgoi --delay-updates --delete --chmod=a-w"
MINCHANGES=20

# run this process with real low priority

ionice -c 3 -p $$
renice +12 -p $$

# sync

rsync $OPTS $SRC $SNAP/latest >> $SNAP/rsync.log

# check if enough has changed and if so
# make a hardlinked copy named as the date

COUNT=$( wc -l $SNAP/rsync.log|cut -d" " -f1 )
if [ $COUNT -gt $MINCHANGES ] ; then
DATETAG=$(date +%Y-%m-%d)
if [ ! -e $SNAP/$DATETAG ] ; then
cp -al $SNAP/latest $SNAP/$DATETAG
chmod u+w $SNAP/$DATETAG
mv $SNAP/rsync.log $SNAP/$DATETAG
chmod u-w $SNAP/$DATETAG
fi
fi
</nowiki>}}

このスクリプトを systemd の[[systemd/タイマー|タイマー]]ユニットから実行することで、ぐっとシンプルにできます。

=== システムのフルバックアップ ===

このセクションでは、 ''rsync'' を使用して、選択したいくつかのディレクトリを除く {{ic|/}} ツリー全体のコピーを転送する方法について説明します。このアプローチは、 {{ic|dd}} を使用した [[ディスクのクローン]] よりも優れていると考えられます。これは、異なるサイズ、パーティションテーブル、およびファイルシステムを使用できるためであり、 {{ic|cp-a}} を使用したコピーよりも優れているためです。これにより、ファイルのアクセス許可、属性、 [[アクセス制御リスト]] および [[ファイルのパーミッションと属性#拡張属性|拡張属性]] をより細かく制御できるようになります。

''rsync'' はシステムの実行中でも機能しますが、転送中に変更されたファイルは転送される場合とされない場合があり、転送されたファイルを使用する一部のプログラムの未定義の動作を引き起こす可能性があります。

このアプローチは、既存のインストールを新しい HDD または [[SSD]] に移行する場合に適しています。

rootとして次のコマンドを実行して下さい。root権限で実行することで rsync がすべてのシステムファイルにアクセスし、所有権を保持できます:

# rsync -aAXHv --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} / ''/path/to/backup''

{{ic|-aAX}} のオプションセットを使用することにより、ファイルはアーカイブモードで転送され、シンボリックリンク、デバイス、アクセス許可、所有権、変更時間、 [[ACL]]、および拡張属性が保持されます。ターゲット [[ファイルシステム]] がこの機能をサポートしていると仮定します。オプション {{ic|-H}} はハードリンクを保持しますが、より多くのメモリを使用します。

{{ic|--exclude}} オプションを指定すると、指定したパターンに一致するファイルが除外されます。ディレクトリ {{ic|/dev}}}、 {{ic|/proc}}、 {{ic|/sys}}、 {{ic|/tmp}}、 {{ic|/run}} は上記のコマンドに含まれますが、これらのディレクトリの ''内容'' は除外されます。これは、起動時にはディレクトリが作成されますが、ディレクトリ自体は作成されないためです。{{ic|/lost+found}}はファイルシステム固有です。上記のコマンドは、 [https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html bash]および [http://zsh.sourceforge.net/Doc/Release/Expansion.html#Brace-Expansion zsh] シェルの両方で使用できるブレース展開に依存します。別の [[シェル]] を使用する場合は、 {{ic|--exclude}} パターンを手動で繰り返す必要があります。除外パターンを引用符で囲むと、 [[シェル]] による展開が回避されます。これは、たとえば [[SSH]] のバックアップ時に必要です。除外パスの最後に {{ic|*}} を指定すると、ディレクトリ自体がまだ存在しない場合でも作成されます。

{{Note|
* {{ic|/mnt}} または {{ic|/media}} 以外の場所でシステムをバックアップする場合は、無限ループを回避するために、除外パターンのリストにシステムを追加することを忘れないでください。
*システムにバインドマウントがある場合は、それらも除外して、バインドマウントされたコンテンツが1回だけコピーされるようにする必要があります。
※[[スワップファイル]] を使用する場合は、必ず除外してください。
* {{ic|/home/}} ディレクトリをバックアップするかどうかを検討してください。データが含まれている場合は、システムよりもかなり大きくなる可能性があります。それ以外の場合は、 {{ic|/home/*/.thumbnails/*}}, {{ic|/home/*/.cache/mozilla/*}}, {{ic|/home/*/.cache/chromium/*}}, と {{ic|/home/*/.local/share/Trash/*}} などの重要でないサブディレクトリを除外することを検討してください。 {{ic|/home/*/.local/share/Trash/*}} は、システムにインストールされているソフトウェアによって異なります。
* [[GVFS]] がインストールされている場合、 rsync エラーを防ぐために、 {{ic|/home/*/.gvfs}} を除外する必要があります。
* [[Dhcpcd]] ≥9.0.0 がインストールされている場合は、 {{ic|/var/lib/dhcpcd/*}} ディレクトリを除外します。これは、いくつかのシステムディレクトリをサブディレクトリとしてマウントするためです。
}}

追加の [[rsync]] オプションを含めるか、次のようないくつかを削除することをお勧めします。完全なリストについては、 {{man|1|rsync}} を参照してください。

* メモリが非常に少ないシステムで実行している場合は、 {{ic|-H}} オプションを削除することを検討してください。ただし、最近のほとんどのマシンでは問題ありません。使用するソフトウェアによっては、ファイルシステムに多くのハードリンクが存在する可能性があります(たとえば、 [[Flatpak]] を使用している場合)。多くのハードリンクは {{ic|/usr/}} ディレクトリの下にあります。
* これを同じバックアップディレクトリで複数回実行している場合は、rsync の {{ic|--delete}} オプションを追加することをお勧めします。この場合、ソースパスが {{ic|/*}} で終わっていないことを確認してください。そうでない場合、このオプションはソースディレクトリのサブディレクトリ内のファイルにのみ影響しますが、存在するファイルには影響しません。
* 仮想ディスク、 [[Docker]] イメージなどのスパースファイルを使用する場合は、 {{ic|-S}} オプションを追加する必要があります。
* {{ic|--numeric-ids}} オプションは、ユーザー名とグループ名のマッピングを無効にします。代わりに、数値のグループ ID とユーザー ID が転送されます。これは、 [[SSH]] を介してバックアップする場合、またはライブシステムを使用して別のシステムディスクをバックアップする場合に役立ちます。
* {{ic|-v}} の代わりに {{ic|1=-info=progress2}} オプションを選択すると、転送されるファイルのリストではなく、全体的な進行状況情報と転送速度が表示されます。
* 再帰時にファイルシステムの境界を越えないようにするには、オプション {{ic|-x}}/{{ic|--one-file-system}} を追加します。これにより、階層内のマウントポイントをバックアップできなくなります。

=== バックアップを復元する ===

バックアップを復元する場合は、実行されたのと同じ rsync コマンドを使用しますが、ソースと宛先を逆にします。

== ファイルシステムのクローニング ==

rsync は、ファイルシステムのメタデータを含む可能な限り多くの情報を保持しながら、ファイルシステム内のすべてのデータのコピーを実行する方法を提供します。これは、ソースファイルシステムと宛先ファイルシステムが同じタイプである必要がないファイルシステムレベルでのデータ複製の手順です。バックアップ、ファイルシステムの移行、またはデータ復旧に使用できます。

rsync の "アーカイブ" モードは、アクセス制御リスト、拡張属性、スパースファイルプロパティなどの特別なファイルシステムメタデータはバックアップされません。ファイルシステムレベルでのクローンを成功させるには、いくつかのオプションを追加する必要があります。

rsync -qaHAXS SOURCE_DIR DESTINATION_DIR

それらの意味は (manpageから):

--hard-links, -H preserve hard links
--acls, -A preserve ACLs (implies --perms)
--xattrs, -X preserve extended attributes
--sparse, -S turn sequences of nulls into sparse blocks

さらに、コピーから除外するツリーの下に他のファイルシステムがマウントされている場合は、 {{ic|-x}} を使用します。
生成されたコピーは、 {{ic|diff}} の再帰オプションを使用して、ファイルシステムレベルで簡単に再読み取りおよびチェックできます(たとえば、データ回復の試行後)。

diff -r SOURCE_DIR DESTINATION_DIR

rsync を使用し、 [[新しいハードウェアに移行する]] で説明されているように [[fstab]] と [[ブートローダー]] を更新することで、ファイルシステムの移行を成功させることができます。これは基本的に、ルートファイルシステムを別のルートファイルシステムに変換する時にも適しています。

== rsync デーモン ==

''rsync'' は、ポート {{ic|873}} で待機しているサーバー上でデーモンとして実行できます。

テンプレート {{ic|/etc/rsyncd.conf}} を編集して共有を構成し、 {{ic|rsyncd.service}} を [[systemd#ユニットを使う|スタート]] します。

{{Note| {{Pkg|rsync}} 3.2.0-1 の時点で、パッケージはアップストリーム systemd ユニットファイル {{ic|rsyncd.service}} と {{ic|rsyncd@.service}} を採用しました。 {{ic|1=ProtectHome}} の変更についてコメントがあり、 {{ic|[Service]}} セクションのセキュリティ機能 {{ic|1=ProtectSystem=full}} は引き続きアクティブです。これにより、 {{ic|/boot/}}、 {{ic|/etc/}}、および {{ic|/usr/}} ディレクトリが読み取り専用になります。 rsyncd 書き込みシステムディレクトリが必要な場合は、ユニットを [[systemd#ユニットファイルの編集|編集]] して、オーバーライドするスニペットの {{ic|[Service]}} セクションで {{ic|1=ProtectSystem=off}} を設定できます。}}

クライアントからの使用

例:サーバーコンテンツの一覧表示:

$ rsync rsync://''server/share''

クライアントからサーバーにファイルを転送する:

$ rsync ''local-file'' rsync://''server/share/''

ポート {{ic|873}} とユーザー認証を開くための iptables を検討してください。

{{Note|ユーザー認証を含むすべての転送データは暗号化されていません。}}

=== 設定例 ===

==== ファイルのリストから共有する ====

{{hc|1=/etc/rsyncd.conf|2=
...

# Needed when crossing filesystem boundaries.
#use chroot = no
read only = yes

...

[sync]
path = /
# List of files to copy.
include from = /backup.list
# Exclude the rest.
exclude = *
}}

ファイルリスト内では、ワイルドカード {{ic|***}} が使用されている場合を除き、すべての ''中間パス'' が必要です:

{{hc|/backup.list|
/etc/
/etc/conf.d/
/etc/conf.d/hwclock
/etc/fonts/***
}}

== 参照 ==

* その他の使用例は、こちらで検索できます。 [https://bbs.archlinux.org/viewforum.php?id=27 Community Contributions] , [https://bbs.archlinux.org/viewforum.php?id=33 General Programming] フォーラム
* [https://www.pointsoftware.ch/2012/09/12/howto-local-and-remote-snapshot-backup-using-rsync-with-hard-links/ Howto – local and remote snapshot backup using rsync with hard links] ハードリンクやMD5インテグリティシグネチャ、'chattr' 保護、フィルタールール、ディスククオータ、リテンションポリシー（新しいファイルを保存する時のバックアップローテーション) とファイル重複排除といった内容があります。
* [https://stackoverflow.com/questions/5527068/how-do-you-use-an-identity-file-with-rsync Using SSH keys/identity files with rsync]
* [https://www.fosslinux.com/41713/top-20-rsync-examples-in-linux.htm Linuxでのトップ20のRsyncサンプル]