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

Mutt

2024-10-20T06:03:27Z

Hory: neomuttはextraリポジトリに移動しています

[[Category:メールクライアント]]
[[Category:コンソールアプリケーション]]
[[Category:OpenPGP]]
[[en:Mutt]]
[[es:Mutt]]
[[it:Mutt]]
[[zh-hans:Mutt]]
[[zh-hant:Mutt]]
{{Related articles start}}
{{Related|fdm}}
{{Related|msmtp}}
{{Related|OfflineIMAP}}
{{Related|isync}}
{{Related articles end}}
'''Mutt''' は強力な機能を持っていることで知られているテキストベースのメールクライアントです。20年以上前に作られたメールクライアントでありながら、Mutt は今でも多くのパワーユーザーから愛用されています。

Mutt は主にメールユーザエージェント (MUA) として開発されており、最初はメールを読むために書かれました。他のメールアプリケーションと比べて後の実装 (メールの取得・送信・フィルタリングの追加) はシンプルとなっており、ユーザーは外部のアプリケーションを使って Mutt の機能を拡張できます。

しかしながら、Arch Linux の {{Pkg|mutt}} パッケージは IMAP や POP3、SMTP のサポートを有効にしてコンパイルされているため、外部アプリケーションの必要はありません。

この記事ではネイティブの IMAP を使ってメールを送受信する方法と、[[OfflineIMAP]] や [[getmail]] (POP3) を使ってメールを取得し、POP3 の場合 [[procmail]] でフィルタリングして、[[msmtp]] でメールを送信する方法の両方を説明します。

==インストール==
{{Pkg|mutt}} パッケージを[[インストール]]してください。

任意で [[isync]], [[OfflineIMAP]], [[msmtp]] などの外部のヘルパーアプリケーションをインストールしてください (IMAP セットアップをする場合)。

もしくは (POP3 を使う場合) {{AUR|getmail}}, {{Pkg|fetchmail}}, {{Pkg|fdm}}, {{Pkg|procmail}} をインストールしてください。

{{Note|
* LOGIN と PLAIN で認証するだけであれば、依存パッケージの {{Pkg|libsasl}} だけで使うことができます。
* CRAM-MD5, GSSAPI, DIGEST-MD5 を使用する場合は {{Pkg|cyrus-sasl-gssapi}} パッケージをインストールしてください。
* SMTP サーバーとして Gmail を使用する場合は {{Pkg|cyrus-sasl}} パッケージもインストールする必要があります。
}}

=== NeoMutt ===

[http://www.neomutt.org/ NeoMutt] プロジェクトは Mutt にあらゆるパッチを適用しています。パッチによって膨大な数の [http://www.neomutt.org/feature.html 機能] が追加されます。古い Mutt のパッチの多くは更新・整理されドキュメント化されています。

AUR には mutt の別バージョンのパッケージが存在していますが、NeoMutt は適切なコンパイルオプションを実行することでそれらを置き換えます。現在、NeoMutt は {{Pkg|neomutt}} や {{AUR|neomutt-git}} でインストールできます。

==設定==
このセクションでは [[#IMAP]], [[#POP3]], [[#Maildir]], [[#SMTP]] の設定を扱います。

デフォルトで Mutt は2つのディレクトリから設定ファイルを認識します: {{ic|~/.muttrc}} と {{ic|~/.mutt/muttrc}}。どちらでも問題ありません。別の場所に設定ファイルを配置したい場合は {{ic|$ mutt -F /path/to/.muttrc}} を使ってください。また、Mutt の設定の要件をある程度知る必要があります。Mutt の構文は Bourne Shell とよく似ています。例えば、別の設定ファイルを読み込むには:
source /path/to/other/config/file
シェルコマンドの結果を変数に入れることができます:
set editor=`echo \$EDITOR`
ここで {{ic|$}} はエスケープされるためシェルに渡される前に Mutt によって置き換えることはありません。Bash 構文の {{ic|$(...)}} は使えないためバッククォートを使用することを覚えておいてください。Mutt には定義済み変数がたくさん存在しますが、自分で設定することもできます。ユーザー変数には必ず前に "my" を付ける必要があります:
set my_name = "John Doe"

===IMAP===

====ネイティブの IMAP サポート====
{{Pkg|mutt}} パッケージは IMAP のサポートを有効にしてコンパイルされています。最低でも muttrc ファイルに4行を記述すればメールにアクセスすることができます。

=====imap_user=====
set imap_user=USERNAME

{{Tip|先ほどの例を続けると、Gmail には完全なメールアドレスが必要であることに注意してください。 (これは標準ではありません) {{bc|1=set imap_user=your.username@gmail.com}}}}

=====imap_pass=====
設定されていない場合、パスワードが要求されます。
set imap_pass=SECRET

{{Tip|Gmail で二段階認証を有効にしている場合、Mutt のためにアプリケーションパスワードを追加して、通常の Gmail パスワードの代わりに使うことができます。}}

=====folder=====
ローカルディレクトリに全てのメール (とディレクトリ) を保存するかわりに、サーバーを使用します (必要であれば最上階のフォルダも)。
set folder=imap[s]://imap.server.domain[:port]/[folder/]

フォルダを使用する必要はありませんが、他のフォルダが全て受信フォルダの中にある場合などに有用です。設定したフォルダは Mutt でイコール記号 (=) とプラス記号 (+) を使ってアクセスできます。例:
set folder=imaps://imap.gmail.com/

複数のアカウントを使用する場合、フォルダを分けるのがベストプラクティスです (例: ''account-hook'')。複数の Gmail アカウントを持っている場合:
set folder=imaps://username@imap.gmail.com/
''username@gmail.com'' はあなたのアカウントに置き換えてください。こうすることでフォルダを区別できるようになります。設定しないと認証エラーが発生します。

=====spoolfile=====
スプールファイルは、(フィルタリングされていない)電子メールが到着するフォルダーです。ほとんどの電子メールサービスでは、通常、INBOX という名前が付けられています。上記で設定したフル {{ic|folder}} パスの代わりに「=」または「+」を使用できるようになりました。例えば:

=====mailboxes=====
新着メールがないか定期的にチェックする必要がある imap フォルダーをここにリストします。
mailboxes =INBOX =family
mailboxes imaps://imap.gmail.com/INBOX imaps://imap.gmail.com/family

または、すべてのサブスクライブされた IMAP フォルダーを確認します(すべての {{Ic|mailboxes}} で追加)
set imap_check_subscribed

これら2つのバージョンは、すべてのフォルダーをサブスクライブする場合は同等です。したがって、2番目の方法の方がはるかに便利ですが、最初の方法の方が柔軟性が高くなります。また、新しいバージョンの Mutt は、デフォルトで「y」キーにバインドされたマクロを含むように設定されており、メールボックスの下にリストされているフォルダーのいずれかに変更できます。

変数を設定しなかった場合、デフォルトで ''spoolfile'' が使われます。[[#サイドバー|サイドバー]]でも使用する変数です。

=====まとめ=====
これらのオプションを使用すると、Mutt を起動し、IMAP パスワードを入力して、メールの読み取りを開始できます。以下は、IMAP サポートを改善するために追加を検討する可能性のある他の行を含む muttrc スニペット (Gmail用) です。
{{bc|1=
set folder = imaps://imap.gmail.com/
set imap_user = your.username@gmail.com
set imap_pass = your-imap-password
set spoolfile = +INBOX
mailboxes = +INBOX

# Store message headers locally to speed things up.
# If hcache is a folder, Mutt will create sub cache folders for each account which may speeds things up even more.
set header_cache = ~/.cache/mutt

# Store messages locally to speed things up, like searching message bodies.
# Can be the same folder as header_cache.
# This will cost important disk usage according to your e-mail amount.
set message_cachedir = "~/.cache/mutt"

# Specify where to save and/or look for postponed messages.
set postponed = +[Gmail]/Drafts

# Allow Mutt to open new imap connection automatically.
unset imap_passive

# Keep IMAP connection alive by polling intermittently (time in seconds).
set imap_keepalive = 300

# How often to check for new mail (time in seconds).
set mail_check = 120
}}

====外部の IMAP サポート====
IMAP のサポートは Mutt に組み込まれていますが、オフラインで読むためにメールをダウンロードすることはしません。[[OfflineIMAP]] や [[isync]] などの外部のアプリケーションを使うことでメールをローカルフォルダにダウンロードして、それを Mutt で処理することが可能です。

メールをソートしたい場合は {{pkg|spamassassin}} や {{AUR|imapfilter}} などのアプリケーションを使います。

===POP3===

{{Pkg|mutt}} パッケージは POP3 のサポートを有効にしてコンパイルされています。{{ic|muttrc(5)}} で説明されているように {{ic|pop_*}} 変数で設定できます。

また、外部のプログラムを使って POP3 でメールを取得することもできます。メールの取得には [[getmail]] を使ってメールのフィルタリングには [[procmail]] を使うのが人気のある選択肢です。

===Maildir===
Maildir は汎用・標準のフォーマットです。ほとんど全ての MUA が Maildir を処理でき、Mutt もサポートしています。Mutt で Maildir を使用するために必要な設定は少しだけです。muttrc を開いて以下の行を追加してください:
{{bc|1=
set mbox_type=Maildir
set folder=~/mail
set spoolfile=+/
set header_cache=~/.cache/mutt
}}

上記は Maildir にアクセスして INBOX に新しいローカルメールが存在しないか確認するだけの最小設定です。上記の設定はメールのヘッダーをキャッシュしてディレクトリの表示を高速化します。(Arch の公式パッケージを使っていない場合) キャッシュは使用できない可能性があります。上記の設定は OfflineIMAP には影響を与えないので注意してください。常にサーバー上の全てのディレクトリを同期します。{{ic|spoolfile}} は Mutt が新しいメールが来ていないか問い合わせるローカルディレクトリです。メーリングリストのディレクトリなどスプールファイルは追加することができます。詳しい設定方法は Mutt のマニュアルを参照してください。

===SMTP===
POP や IMAP を使ってメールを受け取る場合でもメールを送信するときは SMTP を使います。

==== フォルダ ====

ここには基本的に重要なフォルダが1つだけあります。送信されたすべての電子メールが保存されるフォルダです。
set record = +Sent

Gmail は送信したメールを自動的に {{ic|+[Gmail]/Sent}} に保存するため、重複させないようにします:
unset record

====ネイティブの SMTP サポート====
公式の {{Pkg|mutt}} は SMTP のサポートを有効にしてコンパイルされています。

例:
{{bc|1=
set my_pass='mysecretpass'
set my_user=myname

set realname = 'Your Real Name'
set from = your-email-address
set use_from = yes

set smtp_url=smtps://$my_user:$my_pass@smtp.domain.tld
set ssl_force_tls = yes
}}

SMTP 資格情報が IMAP 資格情報と同じである場合、これらの変数を使用できることに注意してください:

{{bc|1=
set smtp_url=smtps://$imap_user:$imap_pass@smtp.domain.tld
}}

以下のようなエラーが表示される場合、セキュリティパラメータを変更する必要があるかもしれません:
SSL routines:SSL23_GET_SERVER_HELLO:unknown protocol

サーバーは SMTPS ではなく SMTP を使っているため、以下のように設定する必要があります:
{{bc|1=
set smtp_url=smtp://$imap_user:$imap_pass@smtp.domain.tld
}}

STARTTLS を使用する場合、他にも設定する変数が存在します:
{{bc|1=
set ssl_starttls = yes
}}

詳しくは {{ic|man 5 muttrc}} を見て下さい。

====外部の SMTP サポート====

[[msmtp]], [[SSMTP]], {{Pkg|opensmtpd}} など外部の SMTP エージェントを使うこともできます。

{{ic|muttrc}} の {{ic|sendmail}} 変数で mutt でメールを配達するのに使用するプログラムと引数を定義できます。追加引数はプログラムによって受取人のアドレスとして解釈されます。

例えば、[[msmtp]] を使う場合:

{{hc|muttrc|2=
set realname='Disgruntled Kangaroo'

set sendmail="/usr/bin/msmtp"

set edit_headers=yes
set folder=~/mail
set mbox=+mbox
set spoolfile=+inbox
set record=+sent
set postponed=+drafts
set mbox_type=Maildir

mailboxes +inbox +lovey-dovey +happy-kangaroos
}}

====Mutt からメールを送信====
設定したら {{Ic|mutt}} を起動してください:

{{ic|~/mail/inbox}} にあるメールが全て表示されます。{{ic|m}} を押すとメールを書くことができます。{{Ic|EDITOR}} 環境変数で設定されたエディタが使われます。変数が設定されていない場合、Mutt を起動する前に設定できます:
$ export EDITOR=your-favorite-editor
$ mutt

EDITOR はシェルの設定ファイル ([[bashrc]] など) に保存するべきです。Mutt の設定ファイルでエディタを設定することもできます:
{{hc|.muttrc|2=set editor=your-favorite-editor}}

テストの目的で、手紙を自分宛てに送ってください。手紙を書いたら、保存してエディターを終了します。 Mutt に戻り、電子メールに関する情報が表示されます。 {{ic|y}} を押して送信します。

{{Warning|この時点で誤って {{ic|q}} を押すと、Mutt は {{ic|Postpone this message? (yes/no)}} これは本当にあなたが書いたばかりのメッセージを保存したいかどうかを尋ねています。「n」を押すと(おそらくメッセージを再度編集するため)、メッセージは完全に削除されます。 Mutt を使用するときは、「このメッセージを延期しますか?」本当に「このメッセージを保存しますか?」という意味です。}}

===マルチアカウント===

これで、少なくとも1つのアカウントに対して有効な構成ができるはずです。すべてを1つのファイルにまとめているので、複数のアカウントをどのように使用するのか疑問に思われるかもしれません。

必要なのは、アカウント固有のパラメーターをそれぞれのファイルに書き込んで、それらを調達することだけです。各アカウントのすべての IMAP / POP3 / SMTP 構成は、それぞれのフォルダーに移動する必要があります。
{{Warning|1つのアカウントが他のアカウントに指定されていない変数を設定している場合は、そのアカウントを '''must unset''' する必要があります。そうしないと、設定が重複し、予期しない動作が発生することになります。}}

Muttは、最も強力な機能の1つであるフックのおかげで、これを処理できます。基本的にフックは、特定のアクションの前に実行されるコマンドです。利用可能なフックがいくつかあります。複数のアカウントの場合、account-hooksとfolder-hooks を使用する必要があります。
* フォルダフックは、フォルダを切り替える前にコマンドを実行します。これは、特定のフォルダにいるときに適切な SMTP パラメータを設定するのに役立ちます。たとえば、仕事用メールボックスにいて、電子メールを送信すると、仕事用アカウントが送信者として自動的に使用されます。
* アカウントフックは、Mutt が IMAP 同期などのアカウントに関連する関数を呼び出すたびにコマンドを実行します。フォルダーに切り替える必要はありません。

フックは次の2つのパラメーターを取ります。
account-hook [!]regex command
folder-hook [!]regex command
正規表現は、一致するフォルダです(または!が前に付いていない場合)。コマンドは、何をすべきかを伝えます。

例:

{{hc|.muttrc|<nowiki>
## General options
set header_cache = "~/.cache/mutt"
set imap_check_subscribed
set imap_keepalive = 300
unset imap_passive
set mail_check = 60
set mbox_type=Maildir

## ACCOUNT1
source "~/.mutt/work"
# Here we use the $folder variable that has just been set in the sourced file.
# We must set it right now otherwise the 'folder' variable will change in the next sourced file.
folder-hook $folder 'source ~/.mutt/work'

## ACCOUNT2
source "~/.mutt/personal"
folder-hook *user@gmail.com/ 'source ~/.mutt/personal'
folder-hook *user@gmail.com/Family 'set realname="Bob"'
</nowiki>}}

{{hc|.mutt/work|<nowiki>
## Receive options.
set imap_user=user@gmail.com
set imap_pass=****
set folder = imaps://user@imap.gmail.com/
set spoolfile = +INBOX
set postponed = +Drafts
set record = +Sent

## Send options.
set smtp_url=smtps://user:****@smtp.gmail.com
set realname='User X'
set from=user@gmail.com
set hostname="gmail.com"
set signature="John Doe"
# Connection options
set ssl_force_tls = yes
unset ssl_starttls

## Hook -- IMPORTANT!
account-hook $folder "set imap_user=user@gmail.com imap_pass=****"
</nowiki>}}

Finally {{ic|.mutt/personal}} should be similar to {{ic|.mutt/work}}.

全てのアカウントを設定したら Mutt を起動してください。フォルダを変えればアカウントを切り替えることができます ({{ic|c}} キー)。もしくは[[#サイドバー|サイドバー]]を使うこともできます。

異なるメールボックスのフォルダーを変更するには、完全なアドレスを入力する必要があります IMAP/POP3 フォルダーの場合、これはかなり不便かもしれません、それにいくつかのキーをバインドしましょう。

{{bc|
## Shortcuts
macro index,pager <f2> '<sync-mailbox><enter-command>source ~/.mutt/personal<enter><change-folder>!<enter>'
macro index,pager <f3> '<sync-mailbox><enter-command>source ~/.mutt/work<enter><change-folder>!<enter>'
}}

上記のショートカット(またはサイドバー)を使用すると、フォルダーの変更(デフォルトでは {{ic|c}} を使用)はコンテキストに依存しません。つまり、現在のメールボックスのフォルダーは表示されませんが、最後にフォルダーを変更したときに使用されたフォルダーが一覧表示されます。動作をより文脈的にするための秘訣は、現在のメールボックスで=または+を押すことです。これは次のマクロで自動化できます。
macro index 'c' '<change-folder>?<change-dir><home>^K=<enter>'

===パスワード管理===
{{ic|.muttrc}} にパスワードを記述することはセキュリティ的に問題があります。毎回手動でパスワードを入力するという方法もありますが、面倒です。

[[GnuPG]] を使ってパスワードを暗号化しファイルに保存するという解決方法が存在します。まだキーペアを設定していない場合、先に[[GnuPG#鍵の作成|作成]]してください。以下の内容で [[tmpfs]] にファイルを作成:

set my_pass = "'' password''"

{{Note|ユーザー定義変数は必ず最初に {{ic|my_}} を付ける必要があります。}}

あなた自身を受取人としてファイルを[[GnuPG#暗号化と復号化|暗号化]]し、アクセス可能なディレクトリに移動してください。以下の例では暗号化したファイルを {{ic|$HOME/.my-pwds.gpg}} に配置しています。

mutt の設定ファイルに以下を追加 (アカウントの前に追加してください):

source "gpg -dq $HOME/.my-pwds.gpg |"

{{Note|上記の行の末尾にあるパイプとダブルクォートの間に空白は挟みません。}}

上記の設定でファイルが復号化され {{ic|my_pass}} 変数が設定されます。source された後は変数を自由に使うことができます。例:

{{bc|1=
set imap_pass=$my_pass
}}

OfflineIMAP や msmtp などの外部ツールを使用する場合、エージェント (例: gpg-agent、[[GnuPG#gpg-agent]] を参照) を設定してパスフレーズをキャッシュに保存して何度もパスワードが聞かれないようにしてください。

==== セキュリティの問題 ====

{{ic|enter-command}} が UI から利用できる場合、暗号化されていないパスワードが表示される可能性があります。Mutt の実行中にセッションにアクセスできるのがあなた以外の誰かである場合、これは望ましくない可能性があります。このため、これを無効にすることができます。その結果ユーザーが使用する予定のすべてのコマンドを事前にキーにバインドする必要があります。そうしないとアクセスできません。
{{hc|.muttrc|
bind generic,alias,attach,browser,editor,index,compose,pager,pgp,postpone ':' noop
}}

== ヒントとテクニック ==
Muttの使用とカスタマイズを始めるためのガイド
* [http://mutt.postle.net/ My first Mutt] (maintained by Bruno Postle)
* [http://www.therandymon.com/woodnotes/mutt/using-mutt.html The Woodnotes Guide to the Mutt Email Client] (maintained by Randall Wood)
* [http://stevelosh.com/blog/2012/10/the-homely-mutt The Homely Mutt] (by Steve Losh)
* [http://codesorcery.net/old/mutt/mutt-gnupg-howto Everything You Need To Know To Start Using GnuPG with Mutt] (by Justin R. Miller)

Mutt について何か疑問があったら、[[IRC チャンネル]]で質問してください。

===キーバインディング===

デフォルトのキーバインドは Emacs や Vi などの一般的なバインドとかけ離れています。自由に設定することができます。Mutt にはページャ・インデックス・添付ビューなどに様々なバインドのセットが用意されています。キーをバインドしたいときは編集したい''マップ''を指定してください。Mutt のヘルプページからコマンドとキーバインドのリストを確認できます (デフォルトキー: {{ic|?}})。Vi ライクなバインドの例:
{{hc|muttrc|<nowiki>
bind pager j next-line
bind pager k previous-line
bind attach,index,pager \CD next-page
bind attach,index,pager \CU previous-page
bind pager g top
bind pager G bottom
bind attach,index g first-entry
bind attach,index G last-entry
</nowiki>}}

=== 作成 ===

==== メールの暗号化と署名 (GnuPG) ====

[[GnuPG]] を使って mutt でメールを暗号化するには {{ic|/usr/share/doc/mutt/samples/gpg.rc}} を mutt の設定フォルダにコピーしてください (例: {{ic|~/.mutt/gpg.rc}})。そして mutt の設定ファイルに以下を追加してください (例: {{ic|~/.mutt/mutrrc}}):

source ~/.mutt/gpg.rc

コンポーズビューで {{ic|p}} を押すことで暗号化オプションを使うことができるようになります。

詳しくは {{man|5|muttrc}} の {{ic|pgp_*}} や {{ic|crypt_*}} オプションを見てください。

==== メールの文字エンコーディング ====
Mutt を使用する場合、指定する必要のある文字セットには2つのレベルがあります。
* 電子メールを作成するために使用されるテキストエディタは、目的のエンコーディングで保存する必要があります。
* その後、Mutt は電子メールをチェックし、{{ic|send_charset}} 変数で指定した優先順位に従って、どのエンコーディングがより適切であるかを判断します。デフォルト: "us-ascii:iso-8859-1:utf-8"

そのため、ISO-8859-1 で許可された文字( 'résumé'など)を使用して、Unicode 固有の文字を使用せずに電子メールを作成すると、Mutt はエンコーディングを ISO-8859-1 に設定します。

この動作を回避するには、{{ic|muttrc}} で変数を設定します。
set send_charset="us-ascii:utf-8"
あるいは
set send_charset="utf-8"

左から最初の互換性のある文字セットが使用されます。 UTF-8 は US-ASCII のスーパーセットであるため、UTF-8 の前に置いても問題ありません。これにより、電子メールヘッダーに文字セットが表示されたときに古い MUA が混乱しないことが保証されます。

==== カスタムメールヘッダ ====
Mutt ではメールヘッダを完全に制御することができます。

メールを書くときにヘッダを編集できるようにするには:
set edit_headers=yes

Muttには、ヘッダーをカスタマイズするための特別な関数 {{ic|my_hdr}} もあります。はい、変数と同じように名前が付けられていますが、実際は関数です。

あなたはそれを完全にクリアすることができます、それはあなたが異なるヘッダーでアカウントを切り替えるときに行うべきです、そうでなければそれらはオーバーラップします:
unmy_hdr *

他の変数もヘッダーに影響を与えるため、{{ic|my_hdr}} を使用する前にそれらをクリアするのが賢明です。:
unset use_from
unset use_domain
unset user_agent

これで、次の構文を使用して、ヘッダーに任意のフィールドを追加できます(非標準のものも含む):
my_hdr <FIELD>: <VALUE>
<VALUE>はコマンドの結果である可能性があることに注意してください。

例:
{{bc|
## Extra info.
my_hdr X-Info: Keep It Simple, Stupid.

## OS Info.
my_hdr X-Operating-System: `uname -s`, kernel `uname -r`

## This header only appears to MS Outlook users
my_hdr X-Message-Flag: WARNING!! Outlook sucks

## Custom Mail-User-Agent ID.
my_hdr User-Agent: Every email client sucks, this one just sucks less.
}}

==== 署名ブロック ====
ホームディレクトリに {{ic|.signature}} を作成してください。署名はメールの末尾に追加されます。もしくは Mutt の設定でファイルを指定することもできます:
set signature="path/to/sig/file"
===== ランダム署名 =====
''fortune'' (パッケージ: {{Pkg|fortune-mod}}) を使うことで Mutt にランダムに署名を追加することができます。

fortune ファイルを作成して以下の行を {{ic|.muttrc}} に追加してください:
{{bc|1=set signature="fortune pathtofortunefile|"}}
最後のパイプに注意してください。指定した文字列がファイルではなくコマンドであることをMuttに伝えます。

==== Mutt を使ってコマンドラインからメールを送信 ====
マニュアルページには、使用可能なすべてのコマンドとその使用方法が表示されますが、ここにいくつかの例を示します。 Mutt を使用して、.bash_profile を介したログイン、または通常の [[cron]] ジョブとしてトリガーされたアラート、ログ、またはその他のシステム情報を送信できます。

メッセージを送信:
mutt -s "Subject" somejoeorjane@someserver.com < /var/log/somelog

添付ファイルを付けてメッセージを送信:
mutt -s "Subject" somejoeorjane@someserver.com -a somefile < /tmp/sometext.txt

==== HTML メールの作成 ====

Mutt は WYSIWIG クライアントではないため、HTML はそのままソースコードを直接編集して扱うことができます。HTML 構文を使ってメールを書くだけです。例:
{{bc|<nowiki>
This is normal text<br>
<b>This is bold text</b></nowiki>
}}
メールを送信する前に、{{ic|edit-type}} コマンドを使って (デフォルトのショートカット: {{ic|Ctrl+t}})、{{ic|text/plain}} を {{ic|text/html}} に置き換えてください。

{{Note| HTML 形式の電子メールは、多くの人々によって役に立たず、扱いにくく、問題を抱えていると見なされています。 Mutt は w3m や lynx のようなテキストブラウザーで HTML メールを読むことができますが、プレーンテキストの電子メールに比べて明らかに利点はありません。可能な場合は、HTML 電子メールを作成しないでください。}}

==== 作成中に他のメールを表示 ====
Mutt のよくある不満として、新しいメール (あるいは返信) を作成しているときに、現在のメールを閉じないと (後回しにしないと) 他のメールを開けないというものがあります。以下の方法で解決できます:

まず、通常通り Mutt を立ち上げてください。そして、別のターミナルウィンドウを起動します。そして次のコマンドで新しい Mutt を起動:
mutt -R
これで読み取り専用モードで Mutt が起動するので、他のメールを自由に閲覧することができます。2番目の Mutt は必ず読み取り専用モードで起動することを強く推奨します。衝突が発生してしまう可能性があるためです。

{{Note|({{ic|c}} または {{ic|y}} を使用して) フォルダーを変更する場合、読み取り専用モードは保持されません。代わりに、{{ic|Esc c}} を使用する必要があります。}}

{{Tip|上記の解決法では多少入力が必要になるため、キーボードショートカットに以下のコマンドをバインドすると良いでしょう (詳しくは[[特別なキーボードキー]]を参照):
$TERMINAL -e mutt -R
{{ic|$TERMINAL}} は使用しているターミナルに置き換えて下さい。}}

=== 印刷 ===
{{AUR|muttprint}} をインストールすることで印刷の品質を向上することができます。muttrc ファイルに以下の行を追加してください:
set print_command="/usr/bin/muttprint %s -p {PrinterName}"

=== コンテンツの表示 ===

==== URL を表示 & ウェブブラウザの起動 ====
まだ行っていない場合は、まず$ HOMEに.muttディレクトリを作成する必要があります。そこで、macrosという名前のファイルを作成します。以下を挿入します。
macro pager \cb <pipe-entry>'urlview'<enter> 'Follow links with urlview'

次に {{AUR|urlview}} パッケージをインストールします。

$ HOMEに.urlviewを作成し、以下を挿入します。
REGEXP (((http|https|ftp|gopher)|mailto)[.:][^ >"\t]*|www\.[-a-z0-9.]+)[^ .,;\t>">\):]
COMMAND <your-browser> %s

pager でメールを読んでいるときにctrl + bを押すと、メールからすべての URL がリストされます。矢印キーで上下に移動し、目的の URL で Enter キーを押します。ブラウザが起動し、選択したサイトに移動します。
一部のブラウザでは、正しく機能するために追加の引数が必要になります。たとえば、[[Luakit]] は Mutt の終了時に閉じます。 {{ic|-n}} パラメータを使用して、バックグラウンドにフォークする必要があります。
COMMAND luakit -n %s 2>/dev/null
{{ic|2>/dev/null}} はそれを静かにすることです。つまり、不要なメッセージの印刷を防止します。

{{Note|urlview にはいくつかの欠点(たとえば、特定の電子メールエンコーディングを処理できないなど)かなり機能が不足しています(その他にも見つかったリンクのコンテキストを提供しません)より良い方法として、すべての電子メールエンコーディングを処理でき、リンクコンテキストを提供する [http://www.memoryhole.net/~kyle/extract_url/ extract_url.pl] もう1つは、リンクコンテキストを提供できるが、すべての電子メールエンコーディングを処理できない、 {{AUR|urlscan-git}} です。どちらも urlview のドロップイン代替品ですが、extract_url には追加の構成変更の恩恵を受ける機能があります。}}

==== HTML の表示 ====
HTML の本文を外部の HTML プログラムに渡してからダンプすることで、Eメールの表示を均一にして目立たなくすることができます。ここでは、{{Pkg|lynx}}、 {{Pkg|w3m}}、 {{Pkg|elinks}} の3つのプログラムについて説明します(選択したパッケージが [[pacman|installed]]) されていることを確認してください)。

{{ic|~/.mutt/mailcap}} が存在しない場合は、作成して以下を保存する必要があります。
text/html; lynx -assume_charset=%{charset} -display_charset=utf-8 -dump %s; nametemplate=%s.html; copiousoutput
または、w3m の場合
text/html; w3m -I %{charset} -T text/html; copiousoutput;
または、elinks の場合
text/html; elinks -dump ; copiousoutput;

muttrc を編集して以下を追加します。
set mailcap_path = ~/.mutt/mailcap

lynx、w3m、elinks で HTML メッセージを自動的に開くには、次の行をmuttrcに追加します。
auto_view text/html

この方法の利点は、html ボディをソースとして表示したり、開いたりする代わりに、
別のプログラム (この場合は lynx ) を使うと、フォーマットされた内容を直接見ることができます。
{{aur|urlview}} がインストールされていれば、電子メール内の URL リンクを {{ic|Ctrl+b}} で表示できます。

複数のエンコーディングや別のエンコーディングの電子メールをたくさん受信した場合、Mutt はデフォルトですべての電子メールを html として扱うことができます。これを回避するには、 ~/.muttrc に次の変数を追加します。muttrc は、Mutt が利用可能な場合はデフォルトで text に設定され、電子メールでテキストバージョンが利用できない場合にのみ w3m/lynx を使用します。

alternative_order text/plain text/html

一部の HTML メールは、テキストベースの Web ブラウザで正しく表示されない場合があります。このような場合、フォールバックソリューションとして、キーをバインドしてグラフィカルブラウザを開くことができます。次のマクロは、環境で定義された Web ブラウザーの添付ファイルビューから選択された HTML メールを開きます。 {{ic|~/.cache/mutt/}} フォルダーを自由に変更してください)。
macro attach 'V' "<pipe-entry>cat >~/.cache/mutt/mail.html && $BROWSER ~/.cache/mutt/mail.html && rm ~/.cache/mutt/mail.html<enter>"

==== メッセージビューのフィルタリング ====

{{ic|limit}} コマンド (既定のショートカット:{{ic|l}}) を使用すると、表示をパターンおよび特定のプロパティに一致する電子メールに制限できます。

ヘッダーに "foo" が含まれているすべての電子メールを表示するには、"foo" と入力するだけで完了です。フィルタを削除するには、"all" キーワードを使用します。

フラグの設定されたすべてのメッセージを表示するには、
~F
サイズが1MB以上またはjohndoeからの未読メッセージをすべて表示するには、次を使用します。
~U (~z 1M- | ~f johndoe)

すべての可能なパターンは公式マニュアルにリストされています。 [http://www.mutt.org/doc/manual/manual-4.html#ss4.2 official manual]

==== 会話のグループ化 ====

既定の並べ替え順序は、日付順です。並べ替えオプションを変更するには、{{ic|sort-mailbox}} コマンド (デフォルトキー: {{ic|o}}) を使用してください。
スレッドごとにEメールをグループ化することができます。この場合、スレッドのソート方法とスレッド内でのソート方法を定義できます。

次の例では、スレッドは最後の電子メールの日付に従って並べ替えられます。
{{hc|muttrc|<nowiki>
set sort=threads
set sort_aux=last-date-received
</nowiki>}}

===mutt とエディタの設定===

====vim====
*テキストの幅を72文字に制限するには、.vimrc ファイルを編集して以下を追加します。
au BufRead /tmp/mutt-* set tw=72

*もう1つの選択肢は、Vim のメールファイルタイププラグインを使用して、72文字幅以外のメール中心のオプションを有効にすることです。 ~/.vim/filetype.vim を編集し、存在しない場合は作成し、次を追加します。
{{bc|
augroup filetypedetect
" Mail
autocmd BufRead,BufNewFile *mutt-* setfiletype mail
augroup END
}}

*別の tmp ディレクトリを設定するには、 ~/.tmp 次のように muttrc に行を追加します。

*変更されたテキストを再フォーマットするには、Vim のコンテキストヘルプを参照してください。
:h 10.7

====GNU nano====
[ [nano] ] もMuttで使える素晴らしいコンソールエディタです。

テキストの幅を72文字に制限するには、を編集します。nanorcファイルに以下を追加します。
set fill 72

また、muttrcファイルでは、編集を開始する行を指定して、メールヘッダーをスキップできます。
set editor="nano +7"

====Emacs====
[[Emacs]] には ''mail'' と ''message'' メジャーモードが存在します。Mutt から Emacs が呼び出されたときに自動的に mail-mode に切り替えるには、{{ic|.emacs}} に以下を追加:
{{hc|.emacs|<nowiki>
;; Mutt support.
(setq auto-mode-alist (append '(("/tmp/mutt.*" . mail-mode)) auto-mode-alist))
</nowiki>}}

Emacs デーモンを使っている場合、Mutt から接続するには以下を {{ic|.muttrc}} に追加:
{{hc|.muttrc|<nowiki>
set editor="emacsclient -a \"\" -t"</nowiki>
}}

===表示設定===

====カラー====
{{ic|.muttrc}} ファイルにサンプルのカラー定義を追加してから自由にカスタマイズしてください:
$ cat /usr/share/doc/mutt/samples/colors.linux >> ~/.muttrc
これらの各設定で実際に生成される色は、 [[Xresources|~/Xresources]] ファイルを参照してください。

また、カラーを含む任意のファイルをソースにすることもできます(テーマファイルとして機能します)
{{bc|
source ~/.mutt/colors.zenburn
}}

テーマのサンプルは [http://nongeekshandbook.blogspot.be/2009/03/mutt-color-configuration.html] を見てください。

====インデックスフォーマット====

ここでは、{{ic|.muttrc}}を使用して、インデックスフォーマット (フォルダビューに表示される列) をカスタマイズします。
{{bc|<nowiki>
set date_format="%y-%m-%d %T"
set index_format="%2C | %Z [%d] %-30.30F (%-4.4c) %s"</nowiki>
}}
詳しくは [http://www.mutt.org/doc/manual/#index-format Mutt Reference], {{ic|man 3 strftime}}, {{ic|man 3 printf}} を見てください。

===="Sent" フォルダビューで送信者ではなく受信者を表示====

デフォルトでは、Mutt は送信者をインデックスビューに表示します。ほとんどのフォルダでは問題ありませんが、送信した電子メールのコピーを保存するフォルダには常に名前が表示されるので、あまり役に立ちません。

これを解決する最も簡単な方法は、muttrc に [https://dev.mutt.org/trac/wiki/UseCases/MultiAccounts#Settinguptheaddresses:alternates alternative email addresses] をセットアップすることです。送信者のアドレスがあなたの別のメールアドレスのどれかと一致すれば、 Mutt は自動的にインデックスに "宛先<受信者>" と表示します。

====可変幅のカラム====

ウィンドウのサイズを変更すると、送信者などの一部のフィールドに未使用のスペースが残っている間に、件名が切り捨てられる場合があります。 tput cols へのシェル呼び出しを使用して、端末でサポートされている列の最大数(つまり、幅)を取得できます。この値を使用して、送信者や件名などのフィールドに幅の割合を設定できます。

上記のフォルダーフックとサイドバーの幅 24 を使用した例
{{hc|muttrc|<nowiki>
## From field gets 30% of remaining space, Subject gets 70%.
## Remaining space is the total width minus the other fields (35), minus the sidebar (24)
set my_index_format_pre='set my_col_from = `echo $((30 * ($(tput cols)-35-24) / 100))`; set my_col_subject = `echo $((70 * ($(tput cols)-35-24) / 100))`; set index_format="%2C | %Z [%d] %-$my_col_from.${my_col_from}'
set my_index_format_post=' (%-4.4c) %?M?<%M> ?%-$my_col_subject.${my_col_subject}s"'

folder-hook .*[sS]ent.* "$my_index_format_pre"t"$my_index_format_post"
folder-hook ! .*[sS]ent.* "$my_index_format_pre"F"$my_index_format_post"
</nowiki>
}}

"must" フック内から変数 {{ic|my_col_from}} と {{ic|my_col_from}} を設定します。そうしないと、カラム値は再計算されません。

フォルダを変更せずにインデックスフォーマットを強制的に再計算するバインディングを追加できます。
{{hc|muttrc|<nowiki>
macro index,pager \CL "<enter-command>$my_index_format_pre"F"$my_index_format_post<enter><redraw-screen>"</nowiki>}}

====サイドバー====

サイドバーの設定例は {{ic|/usr/share/doc/mutt/samples/sample.muttrc-sidebar}} にあり、キーバインドも定義されています。あなたの mutt 設定ファイルにコピー・編集したり source してください。{{ic|1=set sidebar_visible = yes}} に必ず変更してください。

以下を追加することでサイドバーの表示を切り替えられます:
{{bc|<nowiki>
bind index,pager B sidebar-toggle-visible
</nowiki>}}

{{Note|{{ic|sidebar_sort_method}} オプションを使用しない場合、{{ic|mailboxes}} オプションを使用すると、フォルダは {{ic|mailboxes}} に設定された順序で表示されます。}}

{{ic|sidebar_sort_method}} オプションを使用しない場合、{{ic|mailboxes}} オプションを使用すると、フォルダは {{ic|mailboxes}} に設定された順序で表示されます。

{{Tip|異なるメールボックス間に区切り記号を追加するには、フォルダの一覧に偽のフォルダを追加します、例
mailboxes "+-- My mailbox -----------" }}

==== ページャビューの上にインデックスを表示 ====

{{ic|muttrc}} で以下の変数を設定してください:
set pager_index_lines=10

===連絡先の管理===

====アドレスのエイリアス====
Mutt では''エイリアス''を使って連絡先を管理します。エイリアスは '''nickname [longname] <address>''' です。
* The '''nickname''' は Mutt と入力すると連絡先が表示される。一言だけで、覚えやすいはずです。
* The '''longname''' はオプションです。いくつかの単語かもしれません。
* An '''<address>''' は有効な形式 (例{{ic|@}}) である必要があります。
実に簡単ですこれを {{ic|.muttrc}} に追加します。
{{bc|1=
set alias_file = "~/.mutt/aliases"
set sort_alias = alias
set reverse_alias = yes
source $alias_file
}}

説明

* {{ic|alias_file}} は、Mutt 内からエイリアスを追加したときに情報が保存されるファイルです。
* {{ic|sort_alias}} は、Mutt で表示されるエイリアスリストのソートに使用するフィールドを指定する。使用可能な値 :alias,address
* {{ic|reverse_alias}} yes に設定すると、メッセージの送信者と一致するエイリアスが見つかった場合に、インデックスメニューにエイリアスの「個人的な」名が表示されます。
* {{ic|source $alias_file}} は Mutt に起動時にエイリアスを読むように指示する。自動補完に必要です。

{{ic|To:}} がフルアドレスではなくエイリアスを書き込んでいることを示すメッセージが表示されたらあとはこれで完了です。この機能の利点は、{{ic|Tab}} を使用してエイリアスを自動補完できることです。
間違った文字列や空の文字列を自動補完すると完全なリストが表示されます。通常どおりにエイリアスを選択するか、インデックス番号を入力します。

エイリアスを作成するには、次の2つの方法があります。
* Mutt では、対象者のメールが選択されていれば {{ic|a}} を押す。
* alias_file を手動で編集します。構文は実に単純です。
{{bc|
alias nickname Long Name <my-friend@domain.tld>
}}

====Abook====

{{pkg|abook}} は連絡先管理のための専用のスタンドアロンプログラムです。とてもシンプルなテキストベースのインターフェースで人間が読めるプレーンテキストのデータベースに連絡先が保存されます。そして連絡先のプロパティは自由に拡張できます (誕生日, 住所, FAX など)。

Abook は、Mutt とのインターフェースとして特別に設計されているため、Mutt の内部エイリアスの完全でより機能的な置き換えとして機能できます。エイリアスの代わりに Abook を使用する場合は、{{ic|.muttrc}} のエイリアス構成を削除して、次を追加します。

{{hc|muttrc|<nowiki>
## Abook
set query_command= "abook --mutt-query '%s'"
macro index,pager a "<pipe-message>abook --add-email-quiet<return>" "Add this sender to Abook"
bind editor <Tab> complete-query
</nowiki>}}

詳しい解説や設定例は {{ic|abook}} や {{ic|abookrc}} の man ページを見てください。

====Goobook====

{{AUR|goobook-git}} パッケージをインストールして Goobook を使うことでコマンドラインや Mutt の中から Google コンタクトを検索することができます。

goobook を使用する前に {{ic|~/.goobookrc}} を設定してください。デフォルトテンプレートを生成するには:
$ goobook config-template > ~/.goobookrc

設定オプションについては {{ic|~/.goobookrc}} を見てください。最低でも、'''email''' と '''password''' は入力する必要があります。

{{Note|Google アカウントで二段階認証を有効にしている場合、アプリケーションパスワードを生成する必要があります。}}

エイリアスの代わりに Goobook を使用する場合は、{{ic|.muttrc}} を追加します。
{{hc|muttrc|<nowiki>
## GooBook
set query_command="goobook query '%s'"
macro index,pager a "<pipe-message>goobook add<return>" "add sender to google contacts"
bind editor <Tab> complete-query
</nowiki>}}

mutt 内で電子メールメッセージを作成すると、{{ic|Tab}} が Google の連絡先を検索するようになりました。メッセージの表示中に {{ic|a}} 送信者を Google の連絡先に追加します。

==== Khard ====
{{Pkg|khard}} は、ローカルに保存された carddav アドレス帳エントリを使用するコマンドラインアドレス帳です。 {{Pkg|vdirsyncer}} を使用して、それらを CardDAV サーバーと同期できます。 mutt での統合は、abook に似ています。 [https://khard.readthedocs.io/en/latest/scripting.html#mutt Khardのドキュメントを参照してください]

===複数の送信者アカウントの管理===

複数の送信者アカウントを使用する場合は、特定の送信者アカウントを受信者に自動的に関連付けることができます。{{AUR|mutt-vid}} は、送信された電子メールをスキャンして、特定の受信者に関連づけられた最新の「開始日」詳細情報を探し、mutt から source へのファイルに保存します。次回この受信者に電子メールを送信すると、mutt は以前に使用したのと同じ電子メールアドレスと実名を持つ送信フックを自動的に起動します。詳細は mutt-vid の[https://github.com/protist/mutt-vid ホームページ]を参照してください。

===手動で IMAP のメール取得をリクエスト===
次の自動 IMAPフェッチ(または、有効にしていない場合)を待機しない場合は、手動でメールをフェッチできます。
そのための mutt コマンド {{ic|imap-fetch-mail}} があります。
あるいは、キーにバインドすることもできます。
bind index "^" imap-fetch-mail

===カラー化によって巨大なフォルダのインデックスが遅くなる (IMAP)===

正規表現によるインデックスの強調表示は便利ですが、正規表現がメッセージの本文をチェックすると、フォルダーの表示が遅くなる可能性があります。

フォルダーフックを使用して、たとえば受信トレイ(メールボックスを効率的に空にした場合)の強調表示のみを行います。

folder-hook . 'uncolor index "~b \"Hi Joe\" ~R !~T !~F !~p !~P"'
folder-hook ""!"" 'color index brightyellow black "~b \"Hi Joe\" ~N !~T !~F !~p !~P"'

===フォルダの切り替えの高速化===
以下を {{ic|.muttrc}} に追加してください:
{{bc|1=
set sleep_time = 0
}}

===メールのアーカイブ化===
電子メールを読むときは、答える、フラグを付ける、アーカイブする、または削除するという4つの選択肢があります。これを念頭に置いている場合は、受信トレイをスリムに保ちこのマクロ( Gmail 用に設定)に適合させることができます。

macro index \' "<tag-pattern>~R !~D !~F<enter>\
<tag-prefix><save-message>+[Gmail]/All <enter>" \
"Archive"

===他のコンピュータにメールを移動===
メールを新しいマシンに転送する場合(コピー&ペースト)など、Muttが移行したファイルを読み取れるようにするには、ヘッダーキャッシュ(上記の構成に従っている場合は {{ic|~/.cache/mutt}} のようなファイルまたはフォルダー)を削除して、Mutt が移行したメールを読めるようにしてください、そうしないと Mutt はフリーズするかもしれません。

ヘッダキャッシュ用にフォルダを作成した場合、すべてのメールボックスに独自のキャッシュファイルが作成されるため、すべてを削除せずにキャッシュを個別に削除できます。

=== 添付ファイルを保存するデフォルトフォルダ ===

デフォルトでは Mutt は添付ファイルを起動したときのフォルダに保存します。添付ファイルの保存場所を常に {{ic|~/attachments}} にしたい場合、以下のエイリアスを作成することで {{ic|~/attachments}} から Mutt が起動するようになります:

alias mutt='cd ~/attachments && mutt'

=== ページャの挙動 ===

次のページに移動するときにコンテキスト行を表示します:

set pager_context=3

次のメールを表示する代わりに最後で停止します:

set pager_stop=yes

=== クイック返信 ===

デフォルトでは、Mutt はメールに返信するときに受信者と件名の確認を求めます。回答に元のメールを含めるかどうかも尋ねられます。常にデフォルト値を使用することを想定している場合は、以下の質問をスキップするように Mutt を設定できます:

{{hc|muttrc|<nowiki>
set fast_reply=yes
set include=yes
</nowiki>}}

送信する前に、受信者と件名を編集できます。

=== グループ返信のメールアドレスを無視 ===

CC されたメールにグループ返信すると、Mutt の受信者リストにメールアドレスが含まれます。 Mutt にいくつかのアドレスを無視するように頼むことができます:

alternates mail1@server1|mail2@server2|...

=== IMAP メッセージキャッシュ ===

組み込みの IMAP サポートを使用する場合、電子メールはデフォルトでメモリにフェッチされます。大きなメールを数回取得すると、 IMAP サーバーから何度もダウンロードされます。または、フェッチしたすべてのメッセージをディスクに保存するように Mutt に要求することもできます:
{{hc|muttrc|<nowiki>
set message_cachedir=~/.cache/mutt/messages
</nowiki>}}
これにより、大きな添付ファイルがある場合でも、 (フォルダーが存在している必要があります) 将来の検索が瞬時に行われます。たとえば、50MB の制限を超える最も古い電子メールからキャッシュを削除する場合は、次のようなスクリプトを使用できます:

{{hc|~/.mutt/purgecache.sh|<nowiki>
#!/bin/sh

## In KB.
CACHE_LIMIT=51200

cd "$1" 2>/dev/null
[ $? -ne 0 ] && exit

[ $(du -s . | cut -f1 -d' ') -lt $CACHE_LIMIT ] && exit
while IFS= read -r i; do
rm "$i"
[ $(du -s . | cut -f1 -d' ') -lt $CACHE_LIMIT ] && exit
done <<EOF
$(find . -type f -exec ls -rt1 {} +)
EOF
</nowiki>}}

起動時にそれを呼び出します:

{{hc|muttrc|<nowiki>
set message_cachedir=~/.cache/mutt/messages
source "~/.mutt/purgecache.sh '$message_cachedir'|"
</nowiki>}}

=== 添付ファイルを開くか、バックグラウンドでHTMLメールを表示する ===

デフォルトでは、mutt の添付ファイルを開くと mutt がブロックされます。{{ic|~/.mutt/mailcap}} を編集して {{ic|&}} を追加すると、mutt はバックグラウンドで [[デフォルトアプリケーション]] の1つを起動します。[[xdg-open]] を例にとると、

text/html; xdg-open %s &> /dev/null &; nametemplate=%s.html
application/*; xdg-open %s &> /dev/null &;
image/*; xdg-open %s &> /dev/null &;

{{ic|&> /dev/null}} は、エラーやメッセージが mutt ターミナルウィンドウを乱雑にするのを防ぐために使用されます。また、また .html 拡張子のないローカルファイルを HTML としてレンダリングすることを chromium が拒否するため、{{ic|code=nametemplate=%s.html}} が使用されます。

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

===Mutt でバックスペースが使えない===
これは、一部のxtermライクな端末に共通の問題です。
2つのソリューション:
* {{ic|.muttrc}} のキーを再バインドします
bind index,pager ^? previous-line
{{ic|^?}} は、[[wikipedia:Caret_notation|caret notation]] の Backspace を表す1文字です。Emacs で入力するには {{ic|Ctrl+q Backspace}} を使います、vimでは {{ic|Ctrl+v Backspace}} を使用します。

* または、端末を修正します:
$ infocmp > termbs.src
{{ic|termbs.src}} を編集して、{{ic|1=kbs=^H}} を {{ic|1=kbs=\177}} に変更します:
$ tic -x termbs.src

===''change-folder'' 機能で同一のメールボックスが表示される===

これはバグではありません、仕様です。詳しくは[[#マルチアカウント|マルチアカウント]]のセクションを見て下さい。

===Mutt を読み取り専用で使った時にフォルダが変えられない (Mutt -R)===

以下のようなマクロを使用していることが原因です:
macro index,pager <f2> '<sync-mailbox><enter-command>source ~/.mutt/personal<enter><change-folder>!<enter>'
上記のマクロはフォルダを切り替える前に同期を行います (同期は書き込み操作です)。[[#サイドバー|サイドバー]]を使用するか別のマクロを設定してください:
macro index,pager <f3> '<enter-command>source ~/.mutt/personal<enter><change-folder>!<enter>'

===Error sending message, child exited 127 (Exec error)===
これは SMTP エラーです。それは、mutt がメッセージの送信方法を知らないことを意味します。 sendmail をインストールして問題が解決するかどうかを確認するか、smtp_url 変数を設定できます。 gmail を使用する場合は、以下を muttrc に追加して、mutt にgmails smtp サーバーを使用するように指示できます。

set smtp_url=smtps://$imap_user:$imap_pass@smtp.gmail.com

smtpsプロトコルに注意してください、これは重要です。問題が解決するはずです。

===文字エンコーディングの問題===

文字列のエンコーディングに問題がある場合、まずは Mutt の wiki の [http://dev.mutt.org/trac/wiki/MuttFaq/Charset こちらのセクション] を見てください。

中国語のテキストがまだ文字化けしている場合は、たとえヘッダーに GB2312 が指定されていても、GBK でのデコードが役立つことがあります。これは、{{ic|mailcap}} ファイルに以下を追加することで、{{ic|iconv}} で行うことができます。
text/plain; iconv -f gbk -t utf-8 %s; test=echo "%{charset}" | grep -ic "gb2312"; copiousoutput;
{{ic|.muttrc}} に以下を追加して有効にします。
auto_view text/plain
HTMLメールの場合、次のように置き換えることにより、メールキャップの関連する行を編集できます。 {{ic|<nowiki>%{charset}</nowiki>}} with {{ic|<nowiki>$(echo %{charset} | sed s/gb2312/gbk/I)</nowiki>}}, 例えば:
text/html; w3m -dump -I $(echo %{charset} | sed s/gb2312/gbk/I) %s; nametemplate=%s.html; copiousoutput

===GMail にログインできない===

Gmail は {{ic|mutt}} などのアプリからのアクセスを無効にしています。[https://support.google.com/accounts/answer/6010255 こちら] の手順に従うことでアクセスが可能になります。

===urlview で長すぎる URL は開くことができません===

urlviewはテキストをデコードしないので、長すぎる URL は正しく解析されません [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=127090] を参照してください。代わりに mutt にメールをデコードさせることができます urlview を開く行を次のコードに置き換えます。

macro index \cb "\
:set my_tmp_pipe_decode=\$pipe_decode\n\
:set pipe_decode\n\
|urlview\n\
:set pipe_decode=\$my_tmp_pipe_decode\n\
:unset my_tmp_pipe_decode\n" \
'call urlview to extract URLs out of a message'

== ドキュメント ==

初心者は Mutt のヘルプを見つけるのにも苦労するかもしれませんが、公式ドキュメントでほとんどのトピックについて書かれています。公式ドキュメントを読むことを推奨します。

* [http://www.mutt.org/doc/manual/ 公式マニュアル]。Arch Linux の標準パッケージの {{pkg|mutt}} は HTML とプレーンテキストのマニュアルを {{ic|/usr/share/doc/mutt/}} にインストールします。
* {{ic|mutt}} と {{ic|muttrc}} の [[man ページ]]。

== 参照 ==
* [http://www.mutt.org/ Mutt 公式ウェブサイト]
* [http://www.mutt.org/doc/manual/ 公式マニュアル]
* [http://wiki.mutt.org/ The Mutt wiki]
* [http://pbrisbin.com/posts/two_accounts_in_mutt/ Brisbin's great guide on how to setup different IMAP accounts with Mutt, offlineimap, msmtp]
* [http://srobb.net/mutt.html A Quick Guide to Mutt]
* [http://stevelosh.com/blog/2012/10/the-homely-mutt/ Steve Losh on Mutt, offlineimap, msmtp, notmuch (focused on Gmail)]
* [http://www.muttrcbuilder.org/ muttrc builder]

インテルグラフィックス

2024-06-01T11:43:54Z

Hory: 誤字の修正

[[Category:グラフィック]]
[[Category:X サーバー]]
[[de:Intel]]
[[en:Intel graphics]]
[[es:Intel graphics]]
[[ru:Intel graphics]]
[[zh-hans:Intel graphics]]
{{Related articles start}}
{{Related|Intel GMA 3600}}
{{Related|Xorg}}
{{Related|カーネルモード設定}}
{{Related|Xrandr}}
{{Related|ハイブリッドグラフィック}}
{{Related|Vulkan}}
{{Related|GPGPU}}
{{Related articles end}}

Intel はオープンソースドライバの提供とサポートを行なっているので、Intel graphics は基本的にプラグアンドプレイです。

Intel GPU のモデルや関連するチップセットと CPU の包括的なリストは、[[Wikipedia:Intel Graphics Technology]] と [[Gentoo:Intel#Feature support]] を見てください。

{{Note|
* PowerVR ベースのグラフィックカード ([[Intel GMA 3600|GMA 3600]] シリーズ) はオープンソースドライバではサポートされていません。
* Intel 第 ''N'' 世代 (Gen ''N'') ハードウェアという記述は、CPU の世代を指すものではなく、[[Wikipedia:List of Intel graphics processing units|GPU の世代]]を指しています。これは CPU の世代とは異なります。
* あなたのカードを特定する方法については [[Xorg#ドライバーのインストール]] を参照してください。
}}

== インストール ==

* 以下のパッケージのうち1つを[[インストール]]してください。これらは、3D アクセラレーションのための [[wikipedia:ja:ダイレクト・レンダリング・インフラストラクチャ|DRI]] ドライバを提供します。
** {{Pkg|mesa}} は、第3世代ハードウェアおよびそれ以降用のモダンな Gallium3D ドライバを含む最新の [[Mesa]] パッケージです。これを使うことが推奨されます。
** {{Pkg|mesa-amber}} は、第2世代から第11世代までのハードウェア用のクラシックドライバ (Gallium3d でない) です。このドライバは、第7世代及びそれ以前のハードウェアにおいて高いパフォーマンスや安定性をもたらすかもしれませんが、メンテナンスされていません。
* 32ビットアプリケーションのサポートは、[[multilib]] リポジトリから {{Pkg|lib32-mesa}} か {{Pkg|lib32-mesa-amber}} パッケージもインストールしてください。
* [[Xorg]] で 2D アクセラレーションを提供する [[wikipedia:X.Org_Server#DDX|DDX]] ドライバに関しては、以下のうち1つを使ってください:
** {{Pkg|xorg-server}} パッケージに含まれる ''modesetting'' ドライバは、第4世代及びそれ以降のハードウェアにおいて推奨されます。これは、''glamor'' モジュール経由で DRI ドライバを使用してアクセラレーションを提供します。
** {{Pkg|xf86-video-intel}} パッケージは、第2世代から第9世代までのハードウェアにおいてレガシーな Intel DDX ドライバを提供します。一般に、このパッケージを使用することは推奨されません。下記のノートを参照してください。
* [[Vulkan]] サポート (Haswell 及びそれ以降; それより古いチップにおけるサポートは[https://gitlab.freedesktop.org/mesa/mesa/-/issues/8249#note_1758622 不完全であるか存在しません]) については、{{Pkg|vulkan-intel}} パッケージをインストールしてください。32 ビット [[Vulkan]] サポートについては、{{Pkg|lib32-vulkan-intel}} パッケージをインストールしてください。

[[ハードウェアビデオアクセラレーション]]も見てください。

{{Note|1=<nowiki/>
* 一部のディストリビューション ([https://www.phoronix.com/scan.php?page=news_item&px=Ubuntu-Debian-Abandon-Intel-DDX Debian & Ubuntu]、[https://www.phoronix.com/scan.php?page=news_item&px=Fedora-Xorg-Intel-DDX-Switch Fedora]、[https://community.kde.org/Plasma/5.9_Errata#Intel_GPUs KDE]) では、{{Pkg|xf86-video-intel}} ドライバのインストールが推奨されておらず、代わりに modesetting ドライバにフォールバックさせることが推奨されています。[https://web.archive.org/web/20160714232204/https://www.reddit.com/r/archlinux/comments/4cojj9/it_is_probably_time_to_ditch_xf86videointel/]、[https://www.phoronix.com/scan.php?page=article&item=intel-modesetting-2017&num=1]、[[Xorg#インストール]]、{{man|4|modesetting}} を参照してください。しかし、modesetting ドライバは次のような問題を引き起こす可能性があります: [https://gitlab.freedesktop.org/xorg/xserver/-/issues/1364 XFCE での画面のチラツキやマウスのジッタリング]、[https://bugs.chromium.org/p/chromium/issues/detail?id=370022 仮想デスクトップの切り替えを行ったときに Chromium でアーティファクトが発生する]、[https://gitlab.freedesktop.org/xorg/xserver/-/issues/928 vsync のジッタリング、mpv での動画のスタッタリング]。
* {{Pkg|xf86-video-intel}} ドライバには、第11世代及びそれ以降のハードウェアに対する適切なサポートがありません。それによって、アクセラレーションが提供されなかったり、レンダリングの問題が発生したりし、その結果として Plasma Desktop がほぼ利用不能な状態になります。[https://gitlab.freedesktop.org/xorg/driver/xf86-video-intel/-/commit/7181c5a41c3f00eaf996caa156523c708a18081e] を参照してください。
* {{Pkg|xf86-video-intel}} がインストールされている場合、グラフィックススタック全体がハードフリーズし、({{ic|Ctrl+Alt+F''n''}} を押して) 他の仮想コンソールに切り替えることすらできなくなり、[[SysRq]] でユーザプロセスを kill することしかできなくなるという問題が2件報告されています [https://bbs.archlinux.org/viewtopic.php?id=263323] [https://github.com/qutebrowser/qutebrowser/issues/4641]。
}}

== ローディング ==

Intel カーネルモジュールは、システムの起動時に自動的に正常にロードされるはずです。

正常にロードされない場合は:

* Intel はカーネルモード設定を必要とするので、[[カーネルパラメータ]] に {{ic|nomodeset}} を指定して '''いない''' ことを確認してください。
* また、{{ic|/etc/modprobe.d/}} や {{ic|/usr/lib/modprobe.d/}} で modprobe ブラックリストを使って Intel を無効にしていないか確認してください。

=== 早期 KMS ===

[[カーネルモード設定]] (KMS) は {{ic|i915}} ドライバによってサポートされており、[[mkinitcpio]] v32 から {{ic|kms}} フックがデフォルトで使用されているため (ブートの) 早い段階で有効化されます。他の環境で KMS をブートプロセスのできるだけ早い段階で有効化する方法については [[カーネルモード設定#KMS の早期開始]] を見てください。

=== GuC/HuC ファームウェアのロードを有効にする ===

{{Accuracy|Intel のドキュメントに反し、Tiger Lake と Rocket Lake の GPU は実際 {{ic|1=enable_guc=3}} をサポートし、{{ic|1=enable_guc=1}} がデフォルトとなっている場合があります。}}

第9世代から (Skylake およびそれ以降)、Intel GPU には以下の機能を提供する ''Graphics micro (μ) Controller'' (GuC) が搭載されています [https://01.org/linuxgraphics/downloads/firmware]{{Dead link|2023|04|23|status=403}}:
* 一部のメディアデコード機能を CPU から ''HEVC/H.265 micro (µ) Controller'' (HuC) にオフロードする。[[ハードウェアビデオアクセラレーション]]に {{Pkg|intel-media-driver}} を使用する場合にのみ、適用可能です。第9世代から導入されました。
* GuC をスケジューリング、コンテキスト送信、電源管理に使用する。第12世代、Alder Lake-P (Mobile) で導入されました。

この機能を使うには、GuC ファームウェアがロードされていなければなりません。HuC のサポートに関して、一部のビデオ機能 (例: SKL 低電力符号化モードにおける CBR レート制御) は HuC ファームウェアもロードされている必要があります [https://github.com/intel/media-driver#known-issues-and-limitations]。GuC と HuC ファームウェアのファイルは両方 {{Pkg|linux-firmware}} によって提供されています。

GuC の機能は {{ic|1=i915.enable_guc}} [[カーネルパラメータ]] によって制御されます。このパラメータの使用法は次のとおりです。:

{| class="wikitable"
! enable_guc の値 !! GuC 送信 !! HuC ファームウェアのロード !! デフォルトとなっているプラットフォーム !! サポートされているプラットフォーム
|-
|0 || {{No}} || {{No}} || Tiger Lake、Rocket Lake、Gen12 以前 [https://github.com/torvalds/linux/blob/b3454ce0b2c8a56e760e6baa88ed10278585072b/drivers/gpu/drm/i915/gt/uc/intel_uc.c#L26-L36] || すべて
|-
|1 || {{Yes}} || {{No}} || {{-}} || Alder Lake-P (Mobile) およびそれ以降
|-
|2 || {{No}} || {{Yes}} || Alder Lake-S (Desktop) [https://github.com/torvalds/linux/blob/b3454ce0b2c8a56e760e6baa88ed10278585072b/drivers/gpu/drm/i915/gt/uc/intel_uc.c#L38-L42] [https://lore.kernel.org/all/87ee6wit2r.fsf@intel.com/T/] || Gen9 およびそれ以降
|-
|3 || {{Yes}} || {{Yes}} || Alder Lake-P (Mobile) 及びそれ以降 || Gen 9.5 及びそれ以降 (一部個体ではこちらがより良い)
|}

GuC 送信や HuC ファームウェアのロードがあなたの GPU ではデフォルトで有効になっていない場合、手動で有効化できます。

{{Warning|1=GuC / HuC ファームウェアのロードを手動で有効化すると、[https://bugs.freedesktop.org/show_bug.cgi?id=111918 たとえその機能がサポートされていない場合でも]、カーネルに汚染マークが付きます。さらに、GuC/HuC ファームウェアのロードを有効化すると、一部のシステムで問題が発生する可能性があります。(ハイバネートから復帰したあとなどに) フリーズが発生する場合は、無効化してください。}}

まず、{{Pkg|linux-firmware}} が[[インストール]] されていることを確認してください。

{{ic|1=i915.enable_guc}} [[カーネルパラメータ]] を設定してください。例えば:

{{hc|/etc/modprobe.d/i915.conf|2=
options i915 enable_guc=2
}}

[[Initramfs を再生成する|Initramfs を再生成]] してください。次回の起動時に [[dmesg]] を使うことで GuC と HuC が両方有効化されていることを確認できます:

{{hc|# dmesg|2=
[30130.586970] i915 0000:00:02.0: [drm] GuC firmware i915/icl_guc_33.0.0.bin version 33.0 submission:disabled
[30130.586973] i915 0000:00:02.0: [drm] HuC firmware i915/icl_huc_9.0.0.bin version 9.0 authenticated:yes
}}

あなたのグラフィックアダプタで GuC と HuC がサポートされていない場合、以下が出力されます

{{hc|# dmesg|2=
[ 0.571339] i915 0000:00:02.0: [drm] Incompatible option enable_guc=2 - GuC is not supported!
[ 0.571340] i915 0000:00:02.0: [drm] Incompatible option enable_guc=2 - HuC is not supported!
}}

あるいは、以下で確認できます:

# cat /sys/kernel/debug/dri/0/gt/uc/guc_info
# cat /sys/kernel/debug/dri/0/gt/uc/huc_info

{{Note|1=GuC/HuC が有効化されている場合に {{ic|1=enable_gvt=1}} を設定して [[Intel GVT-g|GVT-g graphics virtualization]] を使用することは、linux 4.20.11 現在ではサポートされていません。システムのジャーナルに出力される通り、i915 モジュールの初期化に失敗します。

{{hc|# journalctl|
... kernel: [drm:intel_gvt_init [i915]] *ERROR* i915 GVT-g loading failed due to Graphics virtualization is not yet supported with GuC submission
... kernel: i915 0000:00:02.0: [drm:i915_driver_load [i915]] Device initialization failed (-5)
... kernel: i915: probe of 0000:00:02.0 failed with error -5
... kernel: snd_hda_intel 0000:00:1f.3: failed to add i915 component master (-19)
}}

[https://github.com/intel/gvt-linux/issues/77#issuecomment-707541069] で説明されているように、関連する警告は深刻なものではないことに注意してください:

{{hc|# journalctl -b |
... kernel: i915 0000:00:02.0: Direct firmware load for i915/gvt/vid_0x8086_did_0x5916_rid_0x02.golden_hw_state failed with error -2
}}
}}

== Xorg の設定 ==

たいてい、[[Xorg]] を実行するために設定は特に必要ありません。

しかし、ドライバのオプションを活用したい場合や、[[Xorg]] が起動しない場合などは、Xorg の設定ファイルを作成することができます。

=== modesetting ドライバを使う ===

{{Pkg|xf86-video-intel}} をインストールしたが、DDX ドライバを優先させずに modesetting ドライバを明示的にロードさせたい場合 (DDX ドライバと modesetting ドライバを比較したい場合など) は、以下のような設定ファイルを使用できます:

{{hc|/etc/X11/xorg.conf.d/20-intel.conf|
Section "Device"
Identifier "Intel Graphics"
Driver "modesetting"
EndSection
}}

=== Intel ドライバを使う ===

{{Note|以下は {{Pkg|xf86-video-intel}} が必要です。}}

以下のような Xorg 設定ファイルを作成してください:

{{hc|/etc/X11/xorg.conf.d/20-intel.conf|
Section "Device"
Identifier "Intel Graphics"
Driver "intel"
EndSection
}}

その他のオプションは {{ic|Driver}} の下の新しい行にユーザが追加します。
オプションの完全なリストは {{man|4|intel}} の man ページを参照してください。

{{Note|上に挙げたものよりも多くの device セクションを追加する必要があるかもしれません。これは必要なところに表示されます。}}

==== AccelMethod ====

設定ファイルを作成する際に、{{ic|Option "AccelMethod"}} を指定する必要がある場合があります。古典的なオプションは、{{ic|UXA}}、{{ic|SNA}} (デフォルト)、{{ic|BLT}} です。

デフォルトの {{ic|SNA}} で問題が発生した場合。(例: ピクセル化したグラフィック、壊れたテキストなど)、代わりに {{ic|UXA}} を使ってみてください、これは [[#Xorg の設定|Xorg 設定ファイル]] に次の行を追加することで可能です:

Option "AccelMethod" "uxa"

{{man|4|intel|CONFIGURATION DETAILS}} の "AccelMethod" オプションをご覧ください。

==== 最近の GPU で Intel DDX ドライバを使用する ====

第8世代 (Broadwell) からの Intel GPU では、Iris Mesa ドライバが必要です:

Option "DRI" "iris"

==== TearFree、TripleBuffer、SwapbuffersWait を無効化する ====

コンポジタを使用している場合 (GNOME、KDE Plasma、Xfce などの最近のデスクトップ環境ではデフォルトです)、通常、TearFree、TripleBuffer、SwapbuffersWait を無効化することでパフォーマンスを向上させ、電力消費量を削減することができます。

Option "TearFree" "false"
Option "TripleBuffer" "false"
Option "SwapbuffersWait" "false"

== モジュールベースのオプション ==

{{ic|i915}} カーネルモジュールにより、[[カーネルモジュール#モジュールオプションを設定する|モジュールオプション]] を介して設定できます。一部のモジュールオプションは、省電力に影響を与えます。

次のコマンドを使用して、すべてのオプションのリストと簡単な説明およびデフォルト値を生成できます:

$ modinfo -p i915

現在有効になっているオプションを確認するには、

# systool -m i915 -av

多くのオプションのデフォルトは-1であるため、チップごとの省電力のデフォルトになります。ただし、[[カーネルモジュール#モジュールオプションを設定する|モジュールオプション]] を使用して、より積極的な省電力を構成することも可能です。

{{Note|1=Linux 3.18 以降、これらのデフォルトから逸脱すると、カーネルが [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=fc9740cebc3ab7c65f3c5f6ce0caf3e4969013ca tainted] (汚染された) としてマークされます。これは基本的に、チップごとのデフォルト以外のオプションの使用は実験的なものと見なされ、開発者によってサポートされていないことを意味します。}}

=== フレームバッファー圧縮 (enable_fbc) ===

フレームバッファ圧縮 (FBC) は、スクリーンのリフレッシュ中の電力消費量とメモリの帯域幅の使用量を削減できる機能です。

この機能は、ハードウェアによってサポートされている場合、自動的に有効化されます。以下のコマンドを実行することで、この機能が有効化されているかどうか確認できます:

{{hc|$ modinfo i915 {{!}} grep enable_fbc|
parm: enable_fbc:Enable frame buffer compression for power savings (default: -1 (use per-chip default)) (int)
}}

parm が {{ic|-1}} に設定されている場合、何もする必要はありません。{{ic|-1}} でない場合、{{ic|1=i915.enable_fbc=1}} を[[カーネルパラメータ]]に追加するか、以下の内容で {{ic|/etc/modprobe.d/i915.conf}} を作成することで、FBC を強制的に有効化できます:

{{hc|/etc/modprobe.d/i915.conf|2=
options i915 enable_fbc=1
}}

{{Note|フレームバッファー圧縮は、Sandy Bridge(第6世代)より前の Intel GPU 世代では信頼できないか、使用できない場合があります。これにより、次のようなメッセージがシステムジャーナルに記録されます:

kernel: drm: not enough stolen space for compressed buffer, disabling.

Sandy Bridge 以前の CPU でフレームバッファー圧縮を有効にすると、次のようなエラーメッセージが表示されます。

{{hc|# dmesg|
[ 2360.475430] [drm] not enough stolen space for compressed buffer (need 4325376 bytes), disabling
[ 2360.475437] [drm] hint: you may be able to increase stolen memory size in the BIOS to avoid this
}}

解決策は、フレームバッファー圧縮を無効にすることです。これにより、消費電力がいつの間にか増加します (約 0.06 W)。無効にするには、カーネルラインパラメータに {{ic|1=i915.enable_fbc=0}} を追加します。圧縮を無効化した結果の詳細については、[https://web.archive.org/web/20200228230053/https://kernel.ubuntu.com/~cking/power-benchmarking/background-colour-and-framebuffer-compression/ こちら] を参照してください。}}

=== Fastboot ===

{{Note|1=Skylake およびそれ以降[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=3d6535cbed4a4b029602ff83efb2adec7cb8d28b]、さらに Bay- と Cherry-Trail (VLV/CHV)[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=7360c9f6b857e22a48e545f4e99c79630994e932] では、Linux 5.1 からこのパラメータがデフォルトで有効化されていました [https://kernelnewbies.org/Linux_5.1#Graphics]。その後、Linux 6.7 でこのパラメータは完全に削除され[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=58883680a8416661b48a800e5530e2efcea64a4a]、Linux 6.9 から fastboot は全ての GPU 世代 (Skylake よりも古い世代を含む) に対して有効化されました。[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=1b923307a1b0067a302b394e73311aeaebc06f65]}}

Intel Fastboot の目標は、BIOS または [[ブートローダー]] によってセットアップされたフレームバッファーを保持して、 [[Xorg]] が開始されるまでちらつきを回避することです。[https://lists.freedesktop.org/archives/intel-gfx/2012-May/017653.html][https://www.phoronix.com/scan.php?page=news_item&px=MTEwNzc]

fastboot がデフォルトでないプラットフォーム上で fastboot を有効にするには、{{ic|1=i915.fastboot=1}} を [[カーネルパラメータ]] として設定するか、{{ic|/etc/modprobe.d/i915.conf}} に以下を設定します:

{{hc|/etc/modprobe.d/i915.conf|2=
options i915 fastboot=1
}}

=== Intel GVT-g グラフィック仮想化のサポート===

詳細については [[Intel GVT-g]] を参照してください。

=== パフォーマンスサポートを有効化する ===

第6世代から (Sandy Bridge およびそれ以降) Intel GPU は、内部のパフォーマンスデータをドライバに公開するために使用されるパフォーマンスカウンタを提供しています。ドライバとハードウェアレジスタではこのインフラを ''Observation Architecture'' (内部的には "OA") と呼んでいますが [https://www.phoronix.com/scan.php?page=news_item&px=Intel-HSW-Observation-Arch]、Intel のドキュメントではこの機能をより一般的に ''Observability Performance Counters'' を提供するものとしています [https://01.org/sites/default/files/documentation/observability_performance_counters_haswell.pdf] [https://01.org/sites/default/files/documentation/intel-gfx-prm-osrc-skl-vol14-observability.pdf]。

デフォルトでは、[https://lwn.net/Articles/486306/ CAP_SYS_ADMIN] (root と等価です) や [https://lwn.net/Articles/812719/ CAP_PERFMON] [[ケイパビリティ]]で実行されているプログラムのみが observation architecture を利用できます [https://github.com/torvalds/linux/blob/b14ffae378aa1db993e62b01392e70d1e585fb23/drivers/gpu/drm/i915/i915_perf.c#L267] [https://github.com/torvalds/linux/blob/b14ffae378aa1db993e62b01392e70d1e585fb23/drivers/gpu/drm/i915/i915_perf.c#L3481-L3484]。ほとんどのアプリケーションはこれらのケイパビリティを持たずに実行されるため、以下の警告が出力されます:

MESA-INTEL: warning: Performance support disabled, consider sysctl dev.i915.perf_stream_paranoid=0

これらのケイパビリティ (または root) を使わずにパフォーマンスサポートを有効化するには、[[sysctl]] で説明されているように、(上記の警告で示されている) カーネルパラメータを設定してください。

{{Warning|アプリケーションにパフォーマンスデータへのアクセスを許してしまうなどのリスクが存在するため、{{ic|perf_event_paranoid}} ファミリのオプションには制限的なデフォルトが存在します [https://docs.kernel.org/admin-guide/perf-security.html]。とはいえ、{{ic|dev.i915.perf_stream_paranoid}} は GPU パフォーマンスカウンタへのアクセスにしか影響せず、CPU アーキテクチャ実行コンテキストレジスタなどと比べれば低リスクです。}}

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

=== スケーリングモードを設定する ===

フルスクリーンを使うアプリケーションで有用かもしれません:

$ xrandr --output LVDS1 --set PANEL_FITTING ''param''

選べる {{ic|''param''}} は:

* {{ic|center}}: 解像度は定義した通りに固定され、スケーリングは無効になります
* {{ic|full}}: 画面いっぱいまで解像度がスケールします
* {{ic|full_aspect}}: アスペクト比を維持したまま解像度を可能な限り最大までスケールします

うまく行かない場合は、以下を試してみてください:

$ xrandr --output LVDS1 --set "scaling mode" ''param''

{{ic|''param''}} は {{ic|"Full"}}、{{ic|"Center"}}、{{ic|"Full aspect"}} のいずれかです。

{{Note|1=上記のオプションは外部ディスプレイは現在のところ機能しません (例: VGA, DVI, HDMI, DP) [https://bugs.freedesktop.org/show_bug.cgi?id=90989]。}}

=== GMA 4500 での H.264 デコードのハードウェアアクセラレーション ===

{{Pkg|libva-intel-driver}} パッケージは、一部の GMA 4500 シリーズ GPU での MPEG-2 デコードのハードウェアアクセラレーションのみを提供します (H.264 デコードは提供しません)。あなたの GPU も関係しているどうかを確かめるには、そのドライバと {{Pkg|libva-utils}} パッケージの両方をインストールしてください。そして、{{ic|vainfo}} ツールの出力を見て、{{ic|VAProfileH264}} で始まるエントリがどれだけあるかを見てください。

H.264 デコードのサポートは、枝分かれた g45-h264 ブランチでメンテナンスされており、{{AUR|libva-intel-driver-g45-h264}} パッケージをインストールすることで使用できます。しかし、このサポートは実験的で、開発は放棄されていることに注意してください。GMA 4500 シリーズの GPU 上でこのドライバと共にVA-API を使うことで CPU の負荷を減らすことができますが、動画の再生がアクセラレートされていない状態ほどスムーズに再生できないかもしれません。mplayer を使ったテストでは H.264 でエンコードされた 1080p のビデオを vaapi を使って再生したところ (XV オーバーレイに比べて) CPU の負担は下がりましたが、途切れ途切れの再生になりました。一方 720p はうまく動きました [https://bbs.archlinux.org/viewtopic.php?id=150550]。他の報告も同じようなものでした [https://web.archive.org/web/20160325142959/http://www.emmolution.org/?p=192&cpage=1#comment-12292]。BIOS で割当済みビデオ RAM のサイズを高く設定すると、より質の高いハードウェアデコード再生が可能です。これを行うと、1080p h264 でもうまく行きます [https://lists.libreplanet.org/archive/html/guix-patches/2019-11/msg00652.html]。スムーズな再生 (1080p/720p) は、{{AUR|mpv-git}}、{{AUR|ffmpeg-git}}、{{AUR|libva-intel-driver-g45-h264}} を組み合わせて使うことでもうまく行きます。MPV と Firefox のプラグイン "Send to MPV player"[https://addons.mozilla.org/firefox/addon/send-to-mpv-player/] を用いることで、ハードウェアによりアクセラレートされた YouTube ビデオの再生が可能です。

=== 報告される OpenGL のバージョンを上書き ===

{{ic|MESA_GL_VERSION_OVERRIDE}} [[環境変数]]を使うことで、アプリケーションに報告される OpenGL のバージョンを上書きできます。例えば、{{ic|1=MESA_GL_VERSION_OVERRIDE=4.5}} と設定することで OpenGL 4.5 と報告されるようになります。

{{Note|上記の変数を使って既知の OpenGL バージョンなら、たとえ GPU によってサポートされていないバージョンでも使うこともできます。設定することで、アプリケーションによってクラッシュがなおったり、あるいはクラッシュが増えたりする可能性があります。全てのアプリケーションで同じ変数を使わない方が良いでしょう。}}

=== モニタリング ===

* {{App|intel_gpu_top|Intel GPU のための top ライクなタスクモニタ (root 権限が必要)|https://gitlab.freedesktop.org/drm/igt-gpu-tools|{{Pkg|intel-gpu-tools}}}}
* {{App|nvtop|AMD、Intel、NVIDIA のための GPU プロセスモニタリング (現在、Intel GPU に対しては非常に基本的なサポートしかありません)。|https://github.com/Syllo/nvtop|{{Pkg|nvtop}}}}

=== 明るさとガンマ値の設定 ===

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

=== 試験的な新しい Xe ドライバをテストする ===

(試験的な) [https://www.kernel.org/doc/html//next/gpu/rfc/xe.html 新しい Xe ドライバ]を試すには、以下が必要です:

* {{Pkg|linux}} 6.8 以上
* [[Wikipedia:ja:Tiger Lake|Tiger Lake]] 及びそれ以降の統合グラフィックス、またはディスクリートグラフィックカード。
* 公式リポジトリの {{Pkg|mesa}}。または、{{ic|1=-D intel-xe-kmd=enabled}} でビルドされた mesa。

以下のコマンドで PCI ID を確認してください:

{{hc|lspci -nn {{!}} grep VGA|
00:02.0 VGA compatible controller [0300]: Intel Corporation TigerLake-LP GT2 [Iris Xe Graphics] [8086:'''9a49'''] (rev 01)
}}

そして、適切な PCI ID を使って以下を[[カーネルパラメータ]]に追加してください:

... i915.force_probe=!'''9a49''' xe.force_probe='''9a49'''

必要なときに元に戻すためのブート手段を確保しておいてください。

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

=== ティアリング ===

==== Intel ドライバを使う ====

SNA アクセラレーションメソッドを取っている場合、一部のマシン上でティアリングが発生します。これを修正するには、以下の行を[[#Xorg の設定|設定ファイル]]に追加して {{Pkg|xf86-video-intel}} ドライバの {{ic|TearFree}} オプションを有効化してください:

{{hc|/etc/X11/xorg.conf.d/20-intel.conf|
Section "Device"
Identifier "Intel Graphics"
Driver "intel"
Option "TearFree" "true"
EndSection}}

詳細は[https://bugs.freedesktop.org/show_bug.cgi?id=37686 元のバグレポート]を見てください。

{{Note|1=<nowiki/>
* このオプションは、{{ic|SwapbuffersWait}} が {{ic|false}} のときに動作しない場合があります。
* このオプションはメモリアロケーションを増加させ、パフォーマンスが低下する場合があります。[https://bugs.freedesktop.org/show_bug.cgi?id=37686#c123]
* このオプションは、vsync のタイミングに厳しいアプリケーション (例えば、[[Wikipedia:Super Meat Boy|Super Meat Boy]]) において問題が発生する場合があります。
* このオプションはUXA アクセラレーションメソッドでは動作しません。SNA でしか使えません。
* Intel UHD 620 または 430 では、{{ic|TearFree}} を動作させるために {{ic|Option "TripleBuffer" "true"}} を追加する必要があります。
}}

==== modesetting ドライバを使う ====

最近、TearFree サポートが modesetting ドライバに[https://gitlab.freedesktop.org/xorg/xserver/-/merge_requests/1006 追加されました] [https://www.phoronix.com/news/xf86-video-modesetting-TearFree][https://www.phoronix.com/news/Modesetting-TearFree-Merged]。2023年11月の時点では、このパッチはまだ安定化されていません。なので、安定化されるまで {{AUR|xorg-server-git}} を使用する必要があります。

{{hc|/etc/X11/xorg.conf.d/20-intel.conf|
Section "Device"
Identifier "Intel Graphics"
Driver "modesetting"
Option "TearFree" "true"
EndSection}}

=== 垂直同期 (VSYNC) を無効化する ===

以下のような場合に便利です:

* Chromium/Chrome が、GPU のせいでラグくパフォーマンスが悪く、--disable-gpu スイッチを使うとスムーズに動作する場合。
* glxgears テストが期待するほどのパフォーマンスを発揮してくれない場合。

intel ドライバは垂直同期に [https://www.intel.com/support/graphics/sb/CS-004527.htm Triple Buffering] を使用します。これは、完全なパフォーマンスとティアリングの回避を可能にします。垂直同期をオフにするには (例えば、ベンチマークのために)、以下の {{ic|.drirc}} をホームディレクトリ内に追加してください:

{{hc|~/.drirc|2=
<device screen="0" driver="dri2">
<application name="Default">
<option name="vblank_mode" value="0"/>
</application>
</device>
}}

{{Note|このファイルを作成するために {{AUR|driconf}} を使用しないでください。このツールにはバグがあり、間違ったドライバを設定してしまいます。}}

=== DRI3 の問題 ===

{{Pkg|xf86-video-intel}} では DIR バージョンのデフォルトは ''DRI3'' です。一部の環境では DRI3 によって問題が発生することがあります [https://bugs.chromium.org/p/chromium/issues/detail?id=370022]。''DRI2'' を使うには[[#Xorg の設定|設定ファイル]]に以下の行を追加してください:

Option "DRI" "2"

{{ic|modesetting}} ドライバーでは上記の方法で DRI3 を無効化することはできません。代わりに {{ic|1=LIBGL_DRI3_DISABLE=1}} 環境変数を設定してください。

=== GTK アプリケーションでフォントや画面の表示がおかしい (サスペンド・復帰後に文字が表示されない) ===

GTK アプリケーションでフォントの文字が表示されなくなってしまう場合、以下の方法で直る可能性があります。{{ic|/etc/environment}} を[[編集]]して以下の行を追加してください:

{{hc|/etc/environment|output=
COGL_ATLAS_DEFAULT_BLIT_MODE=framebuffer
}}

[https://bugs.freedesktop.org/show_bug.cgi?id=88584 FreeDesktop bug 88584] も参照。

=== 起動中 "Loading modules" するときに画面がブラックアウトする ===

"late start" KMS を使っているとき "Loading modules" で画面がブラックアウトする場合、initramfs に i915 と intel_agp を加えると解決するかもしれません。[[カーネルモード設定#KMS の早期開始]]を見てください。

または、次の[[カーネルパラメータ]]を加えるとうまく動くかもしれません:

video=SVIDEO-1:d

VGA に出力する必要があるときは次を使ってみて下さい:

video=VGA-1:1280x800

=== Intel ドライバで X がフリーズ/クラッシュする ===

X のクラッシュを伴う問題、GPU のハングアップ、X のフリーズに関する問題は、{{ic|NoAccel}} オプションを使って GPU の使用を無効化することで修復できる場合があります。以下の行を[[#Xorg の設定|設定ファイル]]に追加してください:

Option "NoAccel" "True"

あるいは、{{ic|DRI}} オプションを使って 3D アクセラレーションだけを無効化してみてください:

Option "DRI" "False"

=== 認識されない解像度を追加する ===

この問題は、[[Xrandr#検出されない解像度を追加する|Xrandr のページ]] で扱っています。

=== バックライトを調整できない ===

サスペンドから復帰したあとにホットキーを使用してスクリーンの輝度を変更できない場合、[[バックライト]]の記事を見てあなたの設定ファイルをチェックしてみてください。

問題が解消されない場合は、以下の[[カーネルパラメータ]]のうち1つを試してください:

acpi_osi=Linux
acpi_osi="!Windows 2012"
acpi_osi=

また、fastboot モード ({{ic|i915.fastboot}} カーネルパラメータ) を使用していないことを確認してください。これは、バックライト制御を破壊することが[https://www.phoronix.com/forums/forum/software/mobile-linux/1066447-arch-linux-users-with-intel-graphics-can-begin-enjoying-a-flicker-free-boot 知られています]。

=== Chromium や Firefox の表示がおかしい/応答しない ===

Chromium や Firefox で表示の乱れ、応答なし、ラグ、低パフォーマンスが発生する場合、以下のような解決策があります。

* [[#AccelMethod|AccelMethod を "uxa" に設定する]]
* [[#垂直同期 (VSYNC) を無効化する|VSYNC を無効化する]]
* [[#ティアリング|TearFree オプションを有効化する]]
* "DRI" とアクセラレーションのメソッドを無効にする (Intel Iris 第10世代でテスト済み): {{bc|<nowiki>
Option "NoAccel" "True"
Option "DRI" "False"
</nowiki>}}

=== Broadwell/Core-M チップでカーネル 4.0 以上を使っている場合にクラッシュする ===

X/Wayland がロードされた数秒後、マシンがフリーズして、[[journalctl]] に以下のような Intel Graphics に関連するカーネルのクラッシュログが残ることがあります:

Jun 16 17:54:03 hostname kernel: BUG: unable to handle kernel NULL pointer dereference at (null)
Jun 16 17:54:03 hostname kernel: IP: [< (null)>] (null)
...
Jun 16 17:54:03 hostname kernel: CPU: 0 PID: 733 Comm: gnome-shell Tainted: G U O 4.0.5-1-ARCH #1
...
Jun 16 17:54:03 hostname kernel: Call Trace:
Jun 16 17:54:03 hostname kernel: [<ffffffffa055cc27>] ? i915_gem_object_sync+0xe7/0x190 [i915]
Jun 16 17:54:03 hostname kernel: [<ffffffffa0579634>] intel_execlists_submission+0x294/0x4c0 [i915]
Jun 16 17:54:03 hostname kernel: [<ffffffffa05539fc>] i915_gem_do_execbuffer.isra.12+0xabc/0x1230 [i915]
Jun 16 17:54:03 hostname kernel: [<ffffffffa055d349>] ? i915_gem_object_set_to_cpu_domain+0xa9/0x1f0 [i915]
Jun 16 17:54:03 hostname kernel: [<ffffffff811ba2ae>] ? __kmalloc+0x2e/0x2a0
Jun 16 17:54:03 hostname kernel: [<ffffffffa0555471>] i915_gem_execbuffer2+0x141/0x2b0 [i915]
Jun 16 17:54:03 hostname kernel: [<ffffffffa042fcab>] drm_ioctl+0x1db/0x640 [drm]
Jun 16 17:54:03 hostname kernel: [<ffffffffa0555330>] ? i915_gem_execbuffer+0x450/0x450 [i915]
Jun 16 17:54:03 hostname kernel: [<ffffffff8122339b>] ? eventfd_ctx_read+0x16b/0x200
Jun 16 17:54:03 hostname kernel: [<ffffffff811ebc36>] do_vfs_ioctl+0x2c6/0x4d0
Jun 16 17:54:03 hostname kernel: [<ffffffff811f6452>] ? __fget+0x72/0xb0
Jun 16 17:54:03 hostname kernel: [<ffffffff811ebec1>] SyS_ioctl+0x81/0xa0
Jun 16 17:54:03 hostname kernel: [<ffffffff8157a589>] system_call_fastpath+0x12/0x17
Jun 16 17:54:03 hostname kernel: Code: Bad RIP value.
Jun 16 17:54:03 hostname kernel: RIP [< (null)>] (null)

この問題は execlist のサポート (カーネル 4.0 からデフォルトに変更されました) を無効化することで解決します。以下の[[カーネルパラメータ]]を追加してください:

i915.enable_execlists=0

これは、カーネル 4.0.5 以上で壊れていることが知られています。

=== Windows をゲストとした場合にラグが発生する ===

VirtualBox でホスト側から（マウスカーソルを動かすなどして）画面を更新しないと Windows ゲストのビデオ出力が止まってしまうことがあります。{{ic|1=enable_fbc=1}} オプションを削除すれば問題は解決します。

=== 画面がちらつく ===

Intel iGPU で使用される省電力機能 Panel Self Refresh (PSR) は、一部の例でちらつきを発生させることが知られています {{Bug|49628}} {{Bug|49371}} {{Bug|50605}}。一時的な解決策は、[[カーネルパラメータ]] {{ic|1=i915.enable_psr=0}} を使ってこの機能を無効化することです。

=== i915 ドライバで OpenGL 2.1 ===

{{Pkg|mesa-amber}} パッケージに含まれる第3世代 GPU 用の古い mesa ドライバは、デフォルトでは OpenGL 2.0 が利用可能であると報告します。これは、対象のハードウェアが OpenGL 2.1 とは完全に互換性がないことが原因です。[https://www.phoronix.com/scan.php?page=news_item&px=Mesa-i915-OpenGL-2-Drop] OpenGL 2.1 のサポートは、{{ic|/etc/drirc}} または {{ic|~/.drirc}} で以下のようなオプションを設定することにより、手動で有効化することができます:

{{hc|/etc/drirc|output=
<driconf>
...
<device driver="i915">
<application name="Default">
<option name="'''stub_occlusion_query'''" value="'''true'''" />
<option name="'''fragment_shader'''" value="'''true'''" />
</application>
</device>
...
</driconf>
}}

{{Note|
* OpenGL のバージョンが戻ってしまう理由は、Chromium と他のアプリケーションでエクスペリエンスが悪化するためでした。必要であれば、drirc ファイルを編集して特定のアプリケーションに対して OpenGL 2.1 を {{ic|chromium}} 実行ファイルなどで無効化することもできます ([https://dri.freedesktop.org/wiki/ConfigurationInfrastructure/ 参照])。
* {{Pkg|mesa}} パッケージに含まれる新しい Gallium ベースの i915 ドライバは、常に OpenGL 2.1 が利用可能であると報告します。なので、このドライバに対しては上記の設定は不要です。
}}

=== KMS の問題: コンソールが小さい領域に制限される ===

低解像度のビデオポートの1つが起動時に有効になっていて、そのせいでターミナルがスクリーンの小さい領域を使っているのかもしれません。修正するには、ブートローダーでカーネルコマンドラインパラメータの {{ic|1=video=SVIDEO-1:d}} を使って i915 モジュールの設定でそのポートを明示的に無効化してください。詳細は [[カーネルパラメータ]] を見てください。

これでうまく行かない場合、SVIDEO-1 ではなく TV1 か VGA1 を無効化してみてください。ビデオポートの名前は [[xrandr]] でリストアップできます。

=== Haswell CPU で HDMI 経由で音声が出ない ===

[https://bugzilla.kernel.org/show_bug.cgi?id=60769 Linux カーネルの issue] によると、{{ic|1=intel_iommu=on}} を設定している場合には HDMI から音声が出力されないそうです。この問題を修正するには、以下の[[カーネルパラメータ]]を設定してください:

intel_iommu=on,igfx_off

あるいは、IOMMU を無効化してください:

intel_iommu=off

=== 低消費電力 Intel CPU でクラッシュ/フリーズ ===

低消費電力 Intel プロセッサやノート PC プロセッサは、低消費電力 Intel チップで使用されている電源管理機能に関する問題によりランダムにハングアップ/クラッシュする傾向にあります。そのようなクラッシュが発生する場合、この問題を報告するログは見られないでしょう。以下の[[カーネルパラメータ]]を追加することで、この問題を解決できるかもしれません。

{{Note|以下のカーネルパラメータを3つすべて一緒に使用することは推奨されません。}}

intel_idle.max_cstate=1 i915.enable_dc=0 ahci.mobile_lpm_policy=1

{{ic|1=ahci.mobile_lpm_policy=1}} は、いくつかの Lenovo ノート PC や一部の Acer ノートブックにおける、SATA コントローラーの問題のある電源管理に起因するハングアップを修正します。この回避策は Intel Graphics と厳密には関連していませんが、関連する問題を解決します。このカーネルパラメータを追加すると、''l''ink ''p''ower ''m''anagement をファームウェアのデフォルトから最大パフォーマンスに変更し、特定の Lenovo マシンでディスプレイ輝度を変更した際にハングする問題を解決しますが、modern ultrabook でアイドル時の電力消費量が 1~1.5W 増加します。詳細 (特に他の状態に関するもの) については、[https://lore.kernel.org/lkml/20171211165216.5604-1-hdegoede@redhat.com/ Linux カーネルメーリングリスト]や [https://access.redhat.com/documentation/en-en/red_hat_enterprise_linux/6/html/power_management_guide/alpm Red Hat ドキュメント]を見てください。

{{ic|1=i915.enable_dc=0}} は、GPU の電源管理を無効化します。これは、特定の Intel システム (特に、Goldmount と Kaby Lake Refresh チップ) におけるランダムなハングを解決します。このパラメータを使用すると、電力消費量が増え、ノート PC/notebook のバッテリー寿命が短くなります。

{{ic|1=intel_idle.max_cstate=1}} は、プロセッサのスリープ状態を制限し、プロセッサがディープスリープ状態に移行するのを防ぎます。これは絶対に理想的ではなく、電力消費量の増加とバッテリーの短命化を招きます。しかし、多くの Intel システムでランダムなハングを解決します。Intel Baytrail や Kaby Lake Refresh チップを使用している場合は、このパラメータを使用してください。Intel "Baytrail" チップは、このカーネルパラメータを使用しないと、[https://bugzilla.kernel.org/show_bug.cgi?id=109051#c752 ファームウェアの欠陥]によりランダムにハングしてしまうことが知られていましたが、理論的には [https://cgit.freedesktop.org/drm-intel/commit/?id=a75d035fedbdecf83f86767aa2e4d05c8c4ffd95 2019-04-26] に修正されました。
max_cstate パラメータに関する詳細は[https://docs.kernel.org/admin-guide/pm/intel_idle.html#kernel-command-line-options-and-module-parameters カーネルドキュメント]で、cstate に関する一般的な情報は [https://gist.github.com/wmealing/2dd2b543c4d3cff6cab7 GitHub 上の記事]で見られます。

頻繁にハングする問題を解決するために {{ic|1=intel_idle.max_cstate=1 i915.enable_dc=0 ahci.mobile_lpm_policy=1}} を追加して問題が解決した場合は、その後パラメータを一つずつ取り除いて、どのパラメータが実際に問題の解決になっているかを確かめるべきです。実際の問題が SATA の電源管理に関係していて、問題を実際に解決するパラメータが {{ic|1=ahci.mobile_lpm_policy=1}} である場合、cstate やディスプレイの電源管理が無効化されている状態でマシンを走らせることは推奨されていません。

詳細は [https://linuxreviews.org/Intel_graphics#Kernel_Parameters Linux Reviews] を見てください。

=== 165Hz モニタのサポートを追加する ===

一部の 165Hz モニタで、''xrandr'' が 165Hz のオプションを表示しない場合があり、さらに [[#認識されない解像度を追加する]] の方法ではこれを解決できません。この場合、[https://unix.stackexchange.com/questions/680356/i915-driver-stuck-at-40hz-on-165hz-screen i915-driver-stuck-at-40hz-on-165hz-screen] を見てください。

{{Note|{{ic|/etc/initramfs-tools/hooks/edid}} を作成する以外にも、[[mkinitcpio]] フックを作成する必要があります:

{{hc|/etc/initcpio/install/edid|
#!/bin/bash

build() {
add_file /lib/firmware/edid/edid.bin
}

help() {
cat <<HELPEOF
This hook add support for 165Hz
HELPEOF
}
}}

そして、{{ic|/etc/mkinitcpio.conf}} の HOOKS 配列に ''edid'' を末尾に追加してください。以下のように:

{{hc|/etc/mkinitcpio.conf|2=
HOOKS=(... fsck edid)
}}

そして、[[Initramfs を再生成する|initramfs を再生成]]してください。
}}

=== Raptor Lake と Alder Lake-P 上でスリープ/サスペンドから復帰するとフリーズする ===

Raptor Lake 及び Alder Lake-P の 12 世代モバイルプロセッサを搭載する、様々な製造者のノート PC は、サスペンドからの復帰後にフリーズや黒画面が発生すると報告されています。これは、多くのノート PC 製造者が、iGPU に接続されているポートが間違って記述されている、不適切な VBT (Video BIOS Table) を使用しているからです (freedesktop のイシュー [https://gitlab.freedesktop.org/drm/intel/-/issues/5531 5531] [https://gitlab.freedesktop.org/drm/intel/-/issues/6401 6401] で説明されています)。この場合、ドキュメント化されているケースは全て、重複した eDP エントリに関連しています。

ほとんどの製造者が、Windows が正しく動作するノート PC に向けて BIOS アップデートをリリース[https://gitlab.freedesktop.org/drm/i915/kernel/-/issues/7402 しない]ことを考えれば、この問題はカーネル側から対処するしかありません。重複した eDP エントリがカーネルに悪影響を与えるのを防ぐ方法は2つ、[https://bbs.archlinux.org/viewtopic.php?id=284176 カーネルにパッチを当てる]か、[https://gitlab.freedesktop.org/drm/i915/kernel/-/issues/7709 修正した VBT をロードする]かです。

カーネルにパッチを当てるには、以下のコマンドの出力を解析して、重複した eDP エントリを特定する必要があります:

{{hc|# intel_vbt_decode /sys/kernel/debug/dri/1/i915_vbt|
Child device info:
Device handle: 0x0008 (LFP 1 (eDP))
Device type: 0x1806 (unknown)
...
Child device info:
Device handle: 0x0080 (LFP 2 (eDP))
Device type: 0x1806 (unknown)
}}

この出力からは、重複している eDP エントリが実際に存在しており、カーネルは2つめのエントリを無視するであろうことがわかります。とはいえ、一応チェックしておくべきでしょう。次に、重複した画面のインデックスを必要に応じて {{ic|1=ignoreEntry = 1}} に置き換える以下のカーネルパッチで、この問題を解決できます。

--- a/drivers/gpu/drm/i915/display/intel_bios.c
+++ b/drivers/gpu/drm/i915/display/intel_bios.c
@@ -3688,6 +3688,14 @@
{
struct intel_bios_encoder_data *devdata;

+ int ignoreEntry = 0;
+
list_for_each_entry(devdata, &i915->display.vbt.display_devices, node)
- func(i915, devdata);
+ {
+ if (ignoreEntry != 1)
+ {
+ func(i915, devdata);
+ ignoreEntry++;
+ }
+ }
}

第2の解決方法は、[https://gitlab.freedesktop.org/drm/i915/kernel/-/issues/7709 VBT から重複したエントリを直接削除する]ことです。

VBT をコピーし、16進数エディタで編集して、重複しているデバイスハンドルに対応するデバイスタイプを {{ic|00 00}} に変更します:

$ cat /sys/kernel/debug/dri/0/i915_vbt > vbt

--- vbt
+++ modified_vbt
@@ -22,10 +22,10 @@
00000150 00 08 00 20 00 08 00 10 00 08 00 02 00 08 00 01 |... ............|
00000160 00 08 00 00 01 08 00 00 00 04 00 00 00 40 00 00 |.............@..|
00000170 00 20 00 00 00 10 00 00 00 02 00 00 00 01 00 00 |. ..............|
-00000180 00 00 01 00 00 02 8b 01 02 04 00 00 27 08 00 06 |............'...|
-00000190 18 00 00 00 00 00 00 00 00 00 00 00 00 0a 00 00 |................|
+00000180 00 00 01 00 00 02 8b 01 02 04 00 00 27 08 00 00 |............'...|
+00000190 00 00 00 00 00 00 00 00 00 00 00 00 00 0a 00 00 |................|
000001a0 03 00 00 00 c0 00 40 00 20 00 00 00 00 00 00 00 |......@. .......|
-000001b0 00 00 20 00 80 00 06 18 00 00 00 00 00 00 00 00 |.. .............|
+000001b0 00 00 20 00 80 00 00 00 00 00 00 00 00 00 00 00 |.. .............|
000001c0 00 00 00 00 07 00 00 00 00 00 00 c0 00 10 00 20 |............... |
000001d0 00 00 00 00 00 00 00 00 00 20 00 04 00 d2 60 00 |......... ....`.|
000001e0 10 10 00 23 21 10 00 00 00 00 00 07 00 00 02 00 |...#!...........|

修正後の VBT は、{{ic|/lib/firmware/modified_vbt}} にコピーして、{{ic|1=i915.vbt_firmware=modified_vbt}} カーネルパラメータを使用し、必要であれば [[initramfs を再生成する]]ことで、ロードすることができます。

== 参照 ==

* https://01.org/linuxgraphics/documentation (サポートされているハードウェア一覧など)

{{TranslationStatus|Intel graphics|2024-05-17|808220}}

W3m

2024-04-27T18:13:21Z

Hory: 前書きを整理した

{{Lowercase title}}
[[Category:ウェブブラウザ]]
[[en:w3m]]
[[pt:W3m]]
{{Related articles start}}
{{Related|ELinks}}
{{Related|Lynx}}
{{Related articles end}}
[https://salsa.debian.org/debian/w3m w3m] はテキストベースの Web ブラウザであり、[https://ja.wikipedia.org/wiki/More_(UNIX) more] や [[less]] のようなページャでもあります。
[[ターミナルエミュレータ]] を通じて Web ページが閲覧できるほか、HTML をプレーンテキストにタイプセットするテキスト整形ツールとしても使用できます。

== インストール ==

{{Pkg|w3m}} パッケージを [[インストール]] して下さい。

== 使い方 ==

[[man ページ]]を参照してください: {{man|1|w3m}}

== 設定 ==

w3m の設定は、ブラウザの設定パネルから変更するか、設定ファイルを直接編集することによって構成できます。

より高度なオプションの一部は設定パネルからは変更できないため、設定ファイルを直接編集することをお勧めします。

デフォルトでは、すべての設定ファイルは {{ic|~/.w3m/*}} に格納されます。

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

=== w3mで Vim キーバインドを使用する ===

{{ic|~/.w3m/keymap}} を [https://gist.githubusercontent.com/Lovebird-Connoisseur/a11b9dbc5c056d705d1f0e1053de35af/raw/92b30d2ca4cf67b5816146f86f5d920b4bdfc492/keymap カスタム設定] に置き換えます。

=== URL ヒント ===

w3m は [[qutebrowser]] のようなリンクナビゲーションをサポートしています。設定ファイルに移動して、次の行を {{ic|display_link_number 0}} から {{ic|display_link_number 1}} に変更するだけです。

そして、{{ic|keymap f COMMAND "RESHAPE ; LINK_BEGIN ; GOTO_LINK"}} と {{ic|keymap F COMMAND "RESHAPE ; LINK_BEGIN ; TAB_LINK"}} を {{ic|~/.w3m/keymap}} に追加します。

{{Note|qutebrowser はヒントを選択するためのさまざまなキーをサポートしていますが、w3m では数字キーを使用してリンクを選択することしかできません。}}

=== kittens イメージプロトコルの使用 ===

[[kitty]] ターミナルエミュレータのユーザーは、独自の [https://sw.kovidgoyal.net/kitty/graphics-protocol/ グラフィックスプロトコル] を使用することを選択できます。

これを行うには、{{ic|~/.w3m/config}} 内の次の行を変更するだけです。

inline_img_protocol 0
imgdisplay w3mimgdisplay

これに:

inline_img_protocol 4
imgdisplay kitty

=== 検索 ===

{{ic|wrap_search}} を 1 に設定すると、検索がページ内のすべての一致の最後に到達した後に先頭にジャンプできるようになります。

{{ic|ignorecase_search}} を 1 に設定すると、大文字と小文字を区別しない検索が有効になります。

{{Note|他のブラウザやテキストエディタとは異なり、w3m にはスマートケース検索のオプションがありません。}}

=== カスタム検索エンジン ===

キーをマップして、入力をキャプチャしてカスタム検索エンジンに渡す CGI スクリプトを起動できます。そのためには、まず {{ic|~/.w3m/keymap}} 内にキーバインドを作成してスクリプトを起動します。

keymap s COMMAND "SET_OPTION dictcommand=file:///cgi-bin/omnibar_google.cgi ; DICT_WORD"

そして、[https://raw.githubusercontent.com/gotbletu/shownotes/master/w3m_omnibar/omnibar_google.cgiomnibar_google.cgi] を {{ic|~/.w3m/cgi-bin}} ディレクトリ内に配置し、実行権限を与えます。

上記のスクリプトは Google の結果を返しますが、この種のスクリプトを使用して StackOverflow、GitHub、DuckDuckGo、Reddit、その他多数の Web サイトを検索することもできます。

同様のスクリプトは [https://github.com/gotbletu/shownotes/tree/master/w3m_omnibar GitHub] で参照できます。

=== リーダーモード ===

一部の Web ページは、コンテンツのほとんどを表示するために大量の JavaScript または CSS を使用しているため、w3m では適切に動作しません。記事の先頭に到達するために複数のページをスクロールしなければならないことがよくあります。

これは、最初に Web ページを {{AUR|rdrview-git}} などのリーダーモードプログラムに通すことで軽減できます。

これを行うには、次の行を {{ic|~/.w3m/keymap}} に追加します。

keymap R COMMAND "READD_SHELL 'rdrview $W3M_URL -H 2> /dev/null 1> /tmp/readable.html' ; LOAD /tmp/readdable.html"

=== リダイレクト URL ===

{{ic|~/.w3m/siteconf}} ファイルは、リファラーやユーザーエージェントなど、Web サイトに応じていくつかの環境設定を設定するために使用されます。

また、Web サイトの代わりに、より軽量 (レイアウトと帯域幅の両方の点で) でプライバシーの点で優れたサイトにリダイレクトするために使用することもできます。

これに加えて、特定の CGI スクリプトの実行にも使用できます。

{{hc|~/.w3m/siteconf|<nowiki>
url m!^https?://([a-z]+\.)?twitter\.com/!
substitute_url "https://nitter.net/"

url m!^https?://([a-z]+\.)?reddit\.com/!
substitute_url "https://safereddit.com/"

#url m!^https?://([a-z]+\.)?google\.com/!
#substitute_url "https://duckduckgo.com/lite/"

url m!^https?://([a-z]+\.)?imgur\.com/!
substitute_url "https://rimgo.pussthecat.org/"

url m!^https?://([a-z]+\.)?wikipedia\.com/!
substitute_url "https://wl.vern.cc/"

url "https://www.youtube.com/" exact
substitute_url "file:/cgi-bin/video.cgi?"
#substitute_url "https://yewtu.be/"

url "https://stackoverflow.com/" exact
substitute_url "https://ao.bloatcat.tk/"

url "https://www.reuters.com/" exact
substitute_url "https://neuters.de/"

url "https://fandom.com/" exact
substitute_url "https://breezewiki.pussthecat.org/"

url "https://medium.com/" exact
substitute_url "https://scribe.rip/"

url "https://web.archive.org/" exact
substitute_url "https://wayback-classic.net/"
</nowiki>}}

=== 閉じたウィンドウを復元する ===

デフォルトの w3m は閉じたタブを再度開くことができません。これを追加するには、CGI を使用して、タブを閉じるボタンをバインドして、閉じるタブの現在の URL をエコーし、別のキーをバインドしてファイルに追加された最新の URL を復元します。

{{ic|~/.w3m/keymap}} 内に次を追加します。

keymap d COMMAND "EXTERN 'echo %s >> ~/.w3m/RestoreTab.txt' ; CLOSE_TAB"
keymap u COMMAND TAB_GOTO file:/cgi-bin/restore_tab.cgi

次に、次のファイルを {{ic|~/.w3m/cgi-bin}} 内に配置し、[[ヘルプ:読み方#実行可能属性の付与|実行可能]] にします。

[https://raw.githubusercontent.com/felipesaa/A-vim-like-firefox-like-configuration-for-w3m/master/root-cgi-bin/restore_tab.cgi restore_tab.cgi]

=== magnet リンクを開く ===

[https://raw.githubusercontent.com/gotbletu/shownotes/master/w3m_plugins/cgi-bin/magnet.cgi Magnet.cgi] を使用すると、[[Transmission]] を使用して w3m 自動オープンマグネットリンクを作成できます。

=== フィンガープリント ===

==== tor の使用 ====

{{man|1|torify}} を使用して、w3m トラフィックを {{Pkg|tor}} 経由でルーティングできます。

$ torify w3m -v

==== ユーザーエージェントとヘッダー ====

デフォルトでは、w3m は独自のユーザーエージェントを使用します。これは、w3m ユーザーが他のユーザーの中で目立つことを意味します。

フィンガープリントは、より汎用的なユーザーエージェント、言語、および http_accept ヘッダーを使用することで減らすことができます。

{{hc|~/.w3m/config|2=
user_agent Mozilla/5.0 (Windows NO 10.0; rev:91.0) Gecko/20100101 Firefox91.0
no_referer 1
cross_origin_referer 0
accept_language en-US,en;q=0.5
accept_encoding gzip, deflate
accept_media text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
}}

==== Cookie を無効にする ====

Cookie を無効にするには、{{ic|~/.w3m/config}} で {{ic|use_cookie}} を 0 に設定します。

==== キャッシュを無効にする ====

キャッシュを無効にするには、{{ic|~/.w3m/config}} で {{ic|no_cache}} を 1 に設定します。

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

=== 画像がちらつく、遅延する ===

残念ながら、画像をスクロールしようとすると w3m が遅延し、ブラウザが数秒間応答しなくなる場合があります。

これに対する解決策は画像を完全に無効にすることですが、これにより一部の Web サイトが機能しなくなります (たとえば、hacker news はコメントのインデントに GIF を使用しています)

より洗練された解決策は、画像のオンとオフを切り替えるキーバインドを作成することです。そのためには、次の行を {{ic|~/.w3m/keymap}} に追加します。

keymap i COMMAND "SET_OPTION display_image=toggle ; RESHAPE"

== 参照 ==

* [https://w3m.sourceforge.net/ ホームページ]
* [https://github.com/tats/w3m Github リポジトリ]
* [http://www.w3m.rocks/ w3m.rocks]
* [https://github.com/felipesaa/A-vim-like-firefox-like-configuration-for-w3m w3m 用の vim 風の設定]
* [https://github.com/gotbletu/shownotes/tree/master/w3m_plugins/cgi-bin w3m プラグイン]

W3m

2024-04-27T16:14:26Z

Hory:

{{Lowercase title}}
[[Category:ウェブブラウザ]]
[[en:w3m]]
[[pt:W3m]]
{{Related articles start}}
{{Related|ELinks}}
{{Related|Lynx}}
{{Related articles end}}
[https://salsa.debian.org/debian/w3m w3m] はテキストベースの Web ブラウザであり、[https://ja.wikipedia.org/wiki/More_(UNIX) more] や [[less]] のようなページャでもあります。
w3m を使用すると、[[ターミナルエミュレータ]] を通じて Web ページを閲覧できます。さらに、w3m は、HTML をプレーンテキストにタイプセットするテキスト整形ツールとしても使用できます。

== インストール ==

{{Pkg|w3m}} パッケージを [[インストール]] して下さい。

== 使い方 ==

[[man ページ]]を参照してください: {{man|1|w3m}}

== 設定 ==

w3m の設定は、ブラウザの設定パネルから変更するか、設定ファイルを直接編集することによって構成できます。

より高度なオプションの一部は設定パネルからは変更できないため、設定ファイルを直接編集することをお勧めします。

デフォルトでは、すべての設定ファイルは {{ic|~/.w3m/*}} に格納されます。

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

=== w3mで Vim キーバインドを使用する ===

{{ic|~/.w3m/keymap}} を [https://gist.githubusercontent.com/Lovebird-Connoisseur/a11b9dbc5c056d705d1f0e1053de35af/raw/92b30d2ca4cf67b5816146f86f5d920b4bdfc492/keymap カスタム設定] に置き換えます。

=== URL ヒント ===

w3m は [[qutebrowser]] のようなリンクナビゲーションをサポートしています。設定ファイルに移動して、次の行を {{ic|display_link_number 0}} から {{ic|display_link_number 1}} に変更するだけです。

そして、{{ic|keymap f COMMAND "RESHAPE ; LINK_BEGIN ; GOTO_LINK"}} と {{ic|keymap F COMMAND "RESHAPE ; LINK_BEGIN ; TAB_LINK"}} を {{ic|~/.w3m/keymap}} に追加します。

{{Note|qutebrowser はヒントを選択するためのさまざまなキーをサポートしていますが、w3m では数字キーを使用してリンクを選択することしかできません。}}

=== kittens イメージプロトコルの使用 ===

[[kitty]] ターミナルエミュレータのユーザーは、独自の [https://sw.kovidgoyal.net/kitty/graphics-protocol/ グラフィックスプロトコル] を使用することを選択できます。

これを行うには、{{ic|~/.w3m/config}} 内の次の行を変更するだけです。

inline_img_protocol 0
imgdisplay w3mimgdisplay

これに:

inline_img_protocol 4
imgdisplay kitty

=== 検索 ===

{{ic|wrap_search}} を 1 に設定すると、検索がページ内のすべての一致の最後に到達した後に先頭にジャンプできるようになります。

{{ic|ignorecase_search}} を 1 に設定すると、大文字と小文字を区別しない検索が有効になります。

{{Note|他のブラウザやテキストエディタとは異なり、w3m にはスマートケース検索のオプションがありません。}}

=== カスタム検索エンジン ===

キーをマップして、入力をキャプチャしてカスタム検索エンジンに渡す CGI スクリプトを起動できます。そのためには、まず {{ic|~/.w3m/keymap}} 内にキーバインドを作成してスクリプトを起動します。

keymap s COMMAND "SET_OPTION dictcommand=file:///cgi-bin/omnibar_google.cgi ; DICT_WORD"

そして、[https://raw.githubusercontent.com/gotbletu/shownotes/master/w3m_omnibar/omnibar_google.cgiomnibar_google.cgi] を {{ic|~/.w3m/cgi-bin}} ディレクトリ内に配置し、実行権限を与えます。

上記のスクリプトは Google の結果を返しますが、この種のスクリプトを使用して StackOverflow、GitHub、DuckDuckGo、Reddit、その他多数の Web サイトを検索することもできます。

同様のスクリプトは [https://github.com/gotbletu/shownotes/tree/master/w3m_omnibar GitHub] で参照できます。

=== リーダーモード ===

一部の Web ページは、コンテンツのほとんどを表示するために大量の JavaScript または CSS を使用しているため、w3m では適切に動作しません。記事の先頭に到達するために複数のページをスクロールしなければならないことがよくあります。

これは、最初に Web ページを {{AUR|rdrview-git}} などのリーダーモードプログラムに通すことで軽減できます。

これを行うには、次の行を {{ic|~/.w3m/keymap}} に追加します。

keymap R COMMAND "READD_SHELL 'rdrview $W3M_URL -H 2> /dev/null 1> /tmp/readable.html' ; LOAD /tmp/readdable.html"

=== リダイレクト URL ===

{{ic|~/.w3m/siteconf}} ファイルは、リファラーやユーザーエージェントなど、Web サイトに応じていくつかの環境設定を設定するために使用されます。

また、Web サイトの代わりに、より軽量 (レイアウトと帯域幅の両方の点で) でプライバシーの点で優れたサイトにリダイレクトするために使用することもできます。

これに加えて、特定の CGI スクリプトの実行にも使用できます。

{{hc|~/.w3m/siteconf|<nowiki>
url m!^https?://([a-z]+\.)?twitter\.com/!
substitute_url "https://nitter.net/"

url m!^https?://([a-z]+\.)?reddit\.com/!
substitute_url "https://safereddit.com/"

#url m!^https?://([a-z]+\.)?google\.com/!
#substitute_url "https://duckduckgo.com/lite/"

url m!^https?://([a-z]+\.)?imgur\.com/!
substitute_url "https://rimgo.pussthecat.org/"

url m!^https?://([a-z]+\.)?wikipedia\.com/!
substitute_url "https://wl.vern.cc/"

url "https://www.youtube.com/" exact
substitute_url "file:/cgi-bin/video.cgi?"
#substitute_url "https://yewtu.be/"

url "https://stackoverflow.com/" exact
substitute_url "https://ao.bloatcat.tk/"

url "https://www.reuters.com/" exact
substitute_url "https://neuters.de/"

url "https://fandom.com/" exact
substitute_url "https://breezewiki.pussthecat.org/"

url "https://medium.com/" exact
substitute_url "https://scribe.rip/"

url "https://web.archive.org/" exact
substitute_url "https://wayback-classic.net/"
</nowiki>}}

=== 閉じたウィンドウを復元する ===

デフォルトの w3m は閉じたタブを再度開くことができません。これを追加するには、CGI を使用して、タブを閉じるボタンをバインドして、閉じるタブの現在の URL をエコーし、別のキーをバインドしてファイルに追加された最新の URL を復元します。

{{ic|~/.w3m/keymap}} 内に次を追加します。

keymap d COMMAND "EXTERN 'echo %s >> ~/.w3m/RestoreTab.txt' ; CLOSE_TAB"
keymap u COMMAND TAB_GOTO file:/cgi-bin/restore_tab.cgi

次に、次のファイルを {{ic|~/.w3m/cgi-bin}} 内に配置し、[[ヘルプ:読み方#実行可能属性の付与|実行可能]] にします。

[https://raw.githubusercontent.com/felipesaa/A-vim-like-firefox-like-configuration-for-w3m/master/root-cgi-bin/restore_tab.cgi restore_tab.cgi]

=== magnet リンクを開く ===

[https://raw.githubusercontent.com/gotbletu/shownotes/master/w3m_plugins/cgi-bin/magnet.cgi Magnet.cgi] を使用すると、[[Transmission]] を使用して w3m 自動オープンマグネットリンクを作成できます。

=== フィンガープリント ===

==== tor の使用 ====

{{man|1|torify}} を使用して、w3m トラフィックを {{Pkg|tor}} 経由でルーティングできます。

$ torify w3m -v

==== ユーザーエージェントとヘッダー ====

デフォルトでは、w3m は独自のユーザーエージェントを使用します。これは、w3m ユーザーが他のユーザーの中で目立つことを意味します。

フィンガープリントは、より汎用的なユーザーエージェント、言語、および http_accept ヘッダーを使用することで減らすことができます。

{{hc|~/.w3m/config|2=
user_agent Mozilla/5.0 (Windows NO 10.0; rev:91.0) Gecko/20100101 Firefox91.0
no_referer 1
cross_origin_referer 0
accept_language en-US,en;q=0.5
accept_encoding gzip, deflate
accept_media text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
}}

==== Cookie を無効にする ====

Cookie を無効にするには、{{ic|~/.w3m/config}} で {{ic|use_cookie}} を 0 に設定します。

==== キャッシュを無効にする ====

キャッシュを無効にするには、{{ic|~/.w3m/config}} で {{ic|no_cache}} を 1 に設定します。

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

=== 画像がちらつく、遅延する ===

残念ながら、画像をスクロールしようとすると w3m が遅延し、ブラウザが数秒間応答しなくなる場合があります。

これに対する解決策は画像を完全に無効にすることですが、これにより一部の Web サイトが機能しなくなります (たとえば、hacker news はコメントのインデントに GIF を使用しています)

より洗練された解決策は、画像のオンとオフを切り替えるキーバインドを作成することです。そのためには、次の行を {{ic|~/.w3m/keymap}} に追加します。

keymap i COMMAND "SET_OPTION display_image=toggle ; RESHAPE"

== 参照 ==

* [https://w3m.sourceforge.net/ ホームページ]
* [https://github.com/tats/w3m Github リポジトリ]
* [http://www.w3m.rocks/ w3m.rocks]
* [https://github.com/felipesaa/A-vim-like-firefox-like-configuration-for-w3m w3m 用の vim 風の設定]
* [https://github.com/gotbletu/shownotes/tree/master/w3m_plugins/cgi-bin w3m プラグイン]

CUPS/トラブルシューティング

2024-03-19T05:21:47Z

Hory: mDNSでプリンタを見つけられない問題の解決法を追記した

[[Category:プリンター]]
[[en:CUPS/Troubleshooting]]
[[ru:CUPS (Русский)/Troubleshooting]]
{{Related articles start}}
{{Related|CUPS}}
{{Related|CUPS/プリンター別の問題}}
{{Related articles end}}

この記事では一般的な CUPS の問題と印刷ドライバーに関するトラブルシューティングを提供しています (プリンターの共有については取り扱っていません)。問題の原因を調べる方法や特定の問題を解決する方法があります。

== イントロダクション ==

印刷が機能しない時は {{ic|/etc/cups/cupsd.conf}} の 'LogLevel' を次のように設定して:
LogLevel debug

次のコマンドで {{ic|/var/log/cups/error_log}} からの出力を表示してください:
# tail -n 100 -f /var/log/cups/error_log

出力の左端の文字の意味は:
*D=デバッグ (Debug)
*E=エラー (Error)
*I=情報 (Information)
*など

以下のファイルも有用です:
*{{ic|/var/log/cups/page_log}} - 印刷が成功する度に新しいエントリを表示します
*{{ic|/var/log/cups/access_log}} - cupsd http1.1 サーバー活動全てを表示します

勿論、問題を解決するには CUPS がどうやって動いているのか知るのが重要です:
# '印刷'が選択されると (ほとんどの) アプリケーションは .ps ファイル (PostScript、ページの見た目を記述するスクリプト言語) を CUPS に送信します。
# 次に CUPS はプリンターの PPD ファイル (プリンターの定義ファイル) を調べ、プリンターが理解する言語 (PJL, PCL など) に .ps ファイルを変換するにはどのフィルターが必要なのか目星をつけます (通常は GhostScript)。
# GhostScript が入力を受け取り、使用するフィルターを調べ、フィルターを適用して .ps ファイルをプリンターが理解するフォーマットに変換します。
# そして変換されたものはバックエンドに送信されます。例えば、プリンターが USB ポートに接続されている場合は、USB バックエンドが使われます。

文章を印刷して {{ic|error_log}} を見れば印刷プロセスのさらに詳しいイメージがわかります。

== アップグレードによる問題 ==

''CUPS や関連プログラムのパッケージのバージョンが上がった後に起こる問題''

=== CUPS が動作しなくなった ===

おそらく新しいバージョンを正しく動作させるために新しい設定ファイルが必要になっています。例えば、localhost:631 から CUPS を管理しようとすると "404 - page not found" のようなメッセージが表示されます。

新しい設定を使うには、{{ic|/etc/cups/cupsd.conf.default}} を {{ic|/etc/cups/cupsd.conf}} にコピーして (必要なら古い設定をバックアップしてください) から CUPS を再起動して新しい設定を適用してください。

=== 全てのジョブが"停止"になる ===

プリンターに送ったジョブが全て"停止"になる場合は、プリンターを削除してからもう一度追加してください。
[http://localhost:631 CUPS のウェブインターフェイス] を使って、Printers > Delete Printer に行って下さい。

プリンターの設定を確認するには ''Printers'' から ''Modify Printer'' に行って下さい。表示された情報をコピーして、次のページに進むには 'Modify Printer' をクリックしてください。

=== 全てのジョブが"プリンターが応答していません"になる ===

ネットワークプリンターを使っている場合、CUPS が CUPS が接続 URI に使っている名前が DNS によってプリンターの IP を解決しているか確認してください。例えばプリンターの接続が次のようになっている場合:
lpd://BRN_020554/BINARY_P1

ホスト名 'BRN_020554' が CUPS を動かしているサーバーからプリンターの IP に解決されるようにする必要があります。[[Avahi]] を使用している場合、[[Avahi#ホスト名の解決|Avahi のホストネーム解決]]が機能していることを確認してください。

もしくは、URI のホストネームをプリンターの実際の IP アドレスに置き換えてください。

=== PPD のバージョンが gutenprint と互換性がない ===

次を実行してください:
# /usr/bin/cups-genppdupdate

そして CUPS を再起動してください (このことは gutenprint のインストール後のメッセージでも指示されます)。

=== GTK3 アプリケーションの印刷ダイアログでプリンターが表示されない ===

GTK3 のバージョン 3.22.26 以前までは GTK3 の印刷ダイアログにプリンターを表示するには {{ic|gtk3-print-backends}} パッケージが必要でした。インストールしていない場合 [[gedit]] や [[Firefox]] などのアプリケーションで印刷ができず、CUPS のウェブインターフェイスや lpstat ではプリンターが認識されるため、コマンドラインや GIMP などの GTK2 アプリケーションからは印刷できる状態でした。

バージョン 3.22.26 から {{Pkg|gtk3}} パッケージにバックエンドが統合されたためパッケージのインストールは不要になりました。

== ネットワークの問題 ==

=== Unable to locate printer ===

CUPS でネットワークプリンターが探知されるのに、何か印刷しようとすると "Unable to locate printer" エラーが表示されることがあります。Avahi の [[Avahi#ホスト名の解決|.local ホストネーム解決]]を有効にすることで問題は解決します。詳しくは [[CUPS#ネットワーク]]を見てください。

ファイアウォールを使っている場合に問題が発生することもあります。ファイアウォールを無効化したり適切なルールを設定する必要がある場合があります。system-config-printer によるネットワークプリンターの検出は自動的に行われます。

=== 古い CUPS サーバー ===

CUPS バージョン 1.6 から、クライアントはデフォルトで IPP 2.0 を使用します。CUPS 1.5 / IPP 1.1 以下を使っている場合、クライアントのプロトコルは自動的にダウングレードされないため、サーバーと接続ができません。URL に {{ic|1=version=1.1}} オプションを追加することで解決します [https://www.cups.org/doc/network.html#TABLE2]。

=== CUPS によってプリンターが認識されるのに接続できない ===

デバッグログを有効にしてください。{{ic|Executing backend "/usr/lib/cups/backend/dnssd"...}} と何度も表示されるときはプリンター設定の dnssd を socket に変更してください。

例: {{ic|socket://192.168.11.6:9100}}。ポート番号は [[nmap]] や {{ic|telnet ''your-printer-ip'' 9100}} で確認できます。

=== ローカルでは共有プリンターが機能するのにリモートマシンから印刷できない ===

印刷ジョブがローカルマシンとリモートマシンの両方でフィルタを通して送信されているのが原因です。[[CUPS#ネットワーク_2|CUPS]] ページの警告を見てください。

=== ファイアウォールを使用しているとDNS-SDやmDNSでプリンタを見つけられない ===

コンピュータがネットワークプリンタから発信されるメッセージを受信できないことが原因です。
UDPポート5353を開いてください[https://www.cups.org/doc/firewalls.html]。

== USB プリンター ==

=== SANE と衝突する ===

[[SANE]] も実行している場合、CUPS に干渉する可能性があります。解決するには [[Udev]] ルールを作成して libsane でデバイスをマッチさせてください:
{{hc|/etc/udev/rules.d/99-printer.rules|output=
ATTRS{idVendor}=="''vendor id''", ATTRS{idProduct}=="''product id''", MODE="0664", GROUP="lp", ENV{libsane_matched}="yes"}}

=== usblp と衝突する ===

USB プリンターにアクセスする方法は2つあります: usblp カーネルモジュールと libusb です。前者は古い方法です。シンプルなシリアルデータストリームとしてデバイスファイルにデータを書き込むことでプリンターにデータを送信します。同一デバイスファイルを読み込むことで双方向アクセスが可能です。インク残量やプリンターの状態を読み込むことができます (PJL)。シンプルなプリンターでは上手く動作しますが、マルチプリンター (プリンター/スキャナ) では役不足で HP などのメーカーは独自のバックエンドを提供しています。ソース: [http://lists.linuxfoundation.org/pipermail/printing-architecture/2012/002412.html]。

{{Warning|{{Pkg|cups}} バージョン 1.6.0 以上では、{{ic|usblp}} カーネルモジュールをブラックリストに入れる必要はありません。ブラックリストに入れるしか解決方法がない場合は上流の CUPS バグトラッカーに報告してください。Till Kamppeter (Debian の CUPS メンテナ) と連絡がとれます。詳しくは [http://cups.org/str.php?L4128] を参照。}}

USB プリンターが動作しない場合、{{ic|usblp}} [[カーネルモジュール]]をブラックリスト化することで解決することがあります:

{{hc|/etc/modprobe.d/blacklistusblp.conf|
blacklist usblp
}}

カスタムカーネルを使っている場合は手動で {{ic|usbcore}} [[カーネルモジュール]]をロードする必要があります。

モジュールをロードしたら、プリンターを接続して、以下のコマンドを実行してカーネルによってプリンターが認識されていることを確認してください:
# journalctl -e
または:
# dmesg

{{ic|usblp}} を使用している場合、以下のように出力されていればプリンターが認識されています:
Feb 19 20:17:11 kernel: printer.c: usblp0: USB Bidirectional
printer dev 2 if 0 alt 0 proto 2 vid 0x04E8 pid 0x300E
Feb 19 20:17:11 kernel: usb.c: usblp driver claimed interface cfef3920
Feb 19 20:17:11 kernel: printer.c: v0.13: USB Printer Device Class driver

{{ic|usblp}} をブラックリスト化している場合、以下のように表示されます:
usb 3-2: new full speed USB device using uhci_hcd and address 3
usb 3-2: configuration #1 chosen from 1 choice

=== USB 自動サスペンド===

USB デバイスのドライバーが自動サスペンドをサポートしており、デバイスが使われていない場合、Linux カーネルは自動的にデバイスをサスペンド状態にします。自動サスペンドは電力を節約することができますが、一部の USB プリンターはカーネルが USB ポートをサスペンドしたときに切断されたと認識して、印刷を停止してしまいます。デバイスの自動サスペンドを無効化することで問題を回避できます。詳しくは[[電源管理#USB の自動サスペンド]]を参照。

== HP の問題 ==

[[CUPS/プリンター別の問題#HP]] も参照。

=== CUPS: "/usr/lib/cups/backend/hp failed" ===

D-Bus がインストール・起動されていることを確認してください。エラーが消えない場合、[[Avahi]] を起動してみてください。

http:// プロトコルを使用してネットワークプリンターとしてプリンターを追加してみてください。

{{Note|パーミッションを正しく設定する必要があります。}}

=== ジョブが完了したと言ってるのにプリンターが何もしない ===

古い hpijs ドライバーを選択している場合に HP のプリンターで発生する問題です (例: Deskjet D1600 シリーズ)。代わりに hpcups ドライバーを使ってください。

一部の HP 製のプリンターでは、プリンターを起動するたびにコンピュータからファームウェアをダウンロードさせる必要があります。udev に問題があってファームウェアのダウンロードが実行されないときも、この問題が発生します。手動でファームウェアをプリンターにダウンロードすることで解決します。プリンターが接続・起動されていることを確認してから次のコマンドを実行:
# hp-firmware -n

=== CUPS: '"foomatic-rip" not available/stopped with status 3' ===

HP プリンターを使っている場合に {{ic|/var/log/cups/error_log}} に以下のエラーメッセージが出力される場合、プリンターの状態が 'stopped' に設定されて完了されずに新しいジョブが処理されてしまっています:
Filter "foomatic-rip" for printer ''printer_name'' not available: No such file or director
または:
PID ''pid'' (/usr/lib/cups/filter/foomatic-rip) stopped with status 3!
{{pkg|hplip}} が[[インストール]]されていることを確認してください。

=== CUPS: "Filter failed" ===

"filter failed" エラーが発生する原因は様々です。CUPS のエラーログ (デフォルトでは {{ic|/var/log/cups/error_log}}) にはどのフィルターがなぜ機能しなかったか記録されます。

==== Missing ghostscript ====

{{pkg|ghostscript}} パッケージをインストールしてください ({{ic|/usr/lib/cups/filter/gstoraster}} を実行するのに ghostscript が必要です)。

==== foomatic-db がインストールされていない ====

{{pkg|foomatic-db}} と {{pkg|foomatic-db-ppds}} をインストールすることで解決する場合があります。

==== パーミッションに問題がある ====

プリンターの USB ポートのパーミッションを変更してください:

{{ic|lsusb}} コマンドでバスとデバイスの番号を取得:

{{hc|$ lsusb|Bus <BUSID> Device <DEVID>: ID <PRINTERID>:<VENDOR> Hewlett-Packard DeskJet D1360}}

得られた情報を利用してパーミッションを設定:

# chmod 0666 /dev/bus/usb/<BUSID>/<DEVID>

パーミッションの変更を永続化するため、コンピューターが起動する度に自動的に変更されるようにするには、以下の行を追加してください。

{{hc|/etc/udev/rules.d/10-local.rules|2=
SUBSYSTEM=="usb", ATTRS{idVendor}=="<VENDOR>", ATTRS{idProduct}=="<PRINTERID>", GROUP="lp", MODE:="666"
}}

システムによって変わるので、[[udev#デバイスの属性を一覧表示する]] のページを見て下さい。

==== Avahi が有効になってない ====

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

==== プラグインのバージョンが古い ====

プラグインのバージョンが古い場合も同じエラーが発生します。ログに {{ic|Plugin error}} とメッセージが表示されることもあります。{{AUR|hplip-plugin}} をインストールしている場合、パッケージを更新してください。もしくは {{ic|hp-setup -i}} を実行してプラグインの最新版をインストールしてください。

==== プリンターの設定が古い ====

{{AUR|hplip-plugin}} v3.17.11 現在 hpijs はもはや存在しません。hpijs を使用するプリンターの場合、印刷に失敗するようになります。新しい hpcups ドライバーが使われるように設定しなおしてください。

cups の error_log をチェックすることで問題を確認できます:

{{hc| $ cat /var/log/cups/error_log {{!}} grep hpijs |
...
D [09/Jan/2018:14:32:58 +0000] [Job 97] '''sh: hpijs: command not found'''
...}}

=== HP LaserJet で CUPS が空のページまたはエラーメッセージしか印刷しない ===

HP LaserJet (例: 3380) で画像を印刷しようとすると CUPS が機能しないバグが存在します。[https://bugs.launchpad.net/ubuntu/+source/cups-filters/+bug/998087 Ubuntu] によって報告され修正されています。最初のページは空で、2ページ目からは以下のエラーメッセージが印刷される場合:
ERROR:
invalidaccess
OFFENDING COMMAND:
filter
STACK:
/SubFileDecode
endstream
...

この問題を修正するには root で以下のコマンドを実行します:
# lpadmin -p ''printer'' -o pdftops-renderer-default=pdftops

=== HPLIP 3.13: プラグインをインストールしたのに HP Device Manager から認識されない ===

{{ic|/var/lib/hp/hplip.state}} のパーミッションが変更されてしまっていることが原因です。問題を解決するには、{{ic|chmod 644 /var/lib/hp/hplip.state}} と {{ic|chmod 755 /var/lib/hp}} を実行してください。詳しくは [https://bugs.launchpad.net/hplip/+bug/1131596] を参照。

=== hp-toolbox: "Unable to communicate with device" ===

# hp-toolbox
# error: Unable to communicate with device (code=12): hp:/usb/''printer id''

==== パーミッションの問題 ====

ユーザーを {{ic|lp}} と {{ic|sys}} [[グループ]]に追加してください。

==== 仮想 CDROM プリンター ====

MS Windows ドライバー向けに仮想の CD-ROM ドライブを用意する P1102 などのプリンターなどでも発生します。lp dev が現れたり消えたりします。その場合、{{Pkg|usb_modeswitch}} パッケージをインストールして "Smart Drive" をオフにしてください (パッケージに udev ルールが含まれています)。

==== ネットワークプリンター ====

[[Avahi|avahi-daemon]] が動作していないときに動的ホストネームを使用するネットワークプリンターを使ったときも同じ問題が置きます。DHCP によってプリンターの IP アドレスが変更されて ''hp-setup'' がプリンターを見つけられない可能性もあります。その場合、DHCP サーバーの設定でプリンターの DHCP 予約を追加してください。

=== hp-setup が PPD ファイルの指定を要求する ===

hp-setup のグラフィカルモードで PPD ファイルを選択したときに、フィールドが更新されずエラーメッセージが表示されないことがあります。

また、インタラクティブ (コンソール) モードの場合、ppd ファイルのパスを正しく指定しているのに以下のように表示されることがあります:

Please enter the full filesystem path to the PPD file to use (q=quit) :/usr/share/ppd/HP/hp-deskjet_2050_j510_series.ppd.gz
Traceback (most recent call last):
File "/usr/bin/hp-setup", line 536, in <module>
desc = nickname_pat.search(nickname).group(1)
TypeError: cannot use a string pattern on a bytes-like object

hp-setup を実行する前に CUPS をインストール・起動することで解決できます。

=== hp-setup: "Qt/PyQt 4 initialization failed" ===

{{Pkg|hplip}} の任意の依存パッケージである {{AUR|python-pyqt4}} を[[インストール]]してください。もしくは、{{ic|-i}} フラグを使ってコマンドラインインターフェースで hp-setup を起動してください。

=== hp-setup: 自動的にプリンターが検出されるがテストページを印刷しようとすると "Unable to communicate with device" ===

ローカルネットワーク接続で HP Officejet 6500A と hplip 3.13.5-2 を使用すると発生します。問題を解決するには、HP プリンターの IP アドレスを hp-setup に指定してください。

== その他 ==

=== プリンターが "Rendering completed" 状態で止まってしまう ===

==== インク残量 ====

インクの残量が少なくなると、"Rendering completed" 状態でプリンターが止まってしまうことがあります。また、ネットワークプリンターの場合、それによってネットワークに正しく接続されているのにもかかわらず、CUPS からプリンターが制御できなくなっているのかもしれません。この場合、インクカートリッジを交換することでプリンターは "Ready" 状態に戻り、ネットワークプリンターならば、プリンターが CUPS からまた使えるようになります。

{{Note|サードパーティ製のインクカートリッジを使っている場合、プリンターによって示されるインク残量が正確ではないことがあります。サードパーティ製のインクを使っていてプリンターが問題なく動作していたのに、"Rendering completed" 状態で動かなくなった場合は、インクが残っていると表示されていたとしてもまずインクカートリッジを交換してみてください。}}

==== パーミッションの問題 ====

{{pkg|cups}} 2.0.0-2 以前では、{{ic|Group}} ディレクティブで設定されるグループが {{ic|/etc/cups/cups-files.conf}} の {{ic|SystemGroup}} ディレクティブにも記載されていた場合、{{ic|cupsd}} は {{ic|nobody}} グループでヘルパープログラムを起動します。しかしながら、ヘルパーはプリンターデバイスに書き込みを行う必要があり、プリンターを作成するユーザーは {{ic|root}} でグループは {{ic|lp}} であるため、{{ic|nobody}} グループだと書き込みが行えずに印刷キューが "Paused" または "Stopped" になってしまいます。

この問題を解決するには、{{ic|Group}} ディレクティブを {{ic|lp}} に設定して、{{ic|SystemGroup}} ディレクティブに {{ic|lp}} が含まれていないことを確認してください。

Arch では [https://git.archlinux.org/svntogit/packages.git/commit/trunk?h=packages/cups&id=c20b22f4f996cb08b1aa856d4c8991e869459eb2] で修正されました。

=== unauthorised エラーで印刷が失敗する ===

リモートプリンターが認証を要求した場合、CUPS は自動的に {{ic|/etc/cups/printers.conf}} のプリンターに {{ic|AuthInfoRequired}} ディレクティブを追加します。しかし、一部のグラフィカルアプリケーション (例えば [[LibreOffice]] [https://bugs.documentfoundation.org/show_bug.cgi?id=53029]) にはログイン情報を要求する方法がないため、印刷ができなくなります。この問題を修正するには URI にユーザー名とパスワードを記入してください。[https://bugs.launchpad.net/ubuntu/+source/cups/+bug/283811] や [https://bbs.archlinux.org/viewtopic.php?id=61826] を参照。

=== Unknown supported format: application/postscript ===

{{ic|/etc/cups/mime.convs}} にある次の行をコメントアウトしてください:
application/octet-stream application/vnd.cups-raw 0 -
そして {{ic|/etc/cups/mime.types}} に以下を追加してください:
application/octet-stream

=== Print-Job client-error-document-format-not-supported ===

foomatic パッケージをインストールして foomatic ドライバーを使ってみて下さい。

=== Unable to get list of printer drivers ===

Foomatic ドライバーを削除するか、[[CUPS/プリンター別の問題#HPLIP ドライバー]]に書かれている解決方法を見て下さい。

=== lp: Error - Scheduler Not Responding ===

このエラーが表示される場合、[[CUPS]] が起動していること、環境変数 {{ic|CUPS_SERVER}} が設定されていないこと、{{ic|/etc/cups/client.conf}} に問題がないことを確認してください。

=== "Using invalid Host" エラーメッセージ ===

{{ic|/etc/cups/cupsd.conf}} に {{ic|ServerAlias *}} を追加してみてください。

=== LibreOffice から印刷できない ===

[[CUPS]] ウェブインターフェイスからテストページが印刷できるのに [[LibreOffice]] から印刷できない場合、{{Pkg|a2ps}} パッケージを[[インストール]]してみてください。

=== プリンターの出力がずれる ===

[[CUPS]] で設定された用紙サイズが間違っていることが原因です。

=== 問題が発生してプリンターが動作しなくなる ===

印刷中に問題が発生すると、CUPS でプリンターが反応しなくなることがあります。{{ic|lpq}} はプリンターが {{ic|is not ready}} だと報告します。{{ic|cupsenable}} でプリンターを再度有効化できます。CUPS のウェブインターフェイスでは、プリンターが ''Paused'' の場合にプリンターを復帰することで再有効化することが可能です。

CUPS によるプリンターの有効化を自動化するには、[https://www.cups.org/doc/man-cupsd.conf.html?TOPIC=Man+Pages#ErrorPolicy ErrorPolicy] をデフォルトの {{ic|stop-printer}} から {{ic|retry-this-job}} に変更してください。

=== Samsung: URF ERROR - Incomplete Session by time out ===

IPP を使ってネットワーク経由でファイルを Samsung プリンターで印刷しようとしたときに発生するエラーで、{{aur|samsung-unified-driver}} パッケージを使うことで解決します。

{{Note|エラーコードの 11-1112 はプリンターの内部接続の問題に対応しているため、Samsung の技術サポートに連絡しても無駄です。}}

=== Brother: プリンターがコピーを何枚も印刷する ===

ときどきプリンターがドキュメントのコピーを複数枚印刷してしまうことがあります (例えば MFC-9330CDW は10枚コピーします)。[[CUPS/プリンター別の問題#ファームウェアのアップデート|プリンターのファームウェアを更新]]することで解決します。

=== 通常ユーザーでプリンターのプロパティを変更したり特定のジョブを削除できない ===

通常ユーザーでプリンターのプロパティを変更したりプリンターのキューを管理するには、ユーザーを {{ic|sys}} グループに追加する必要があります。

CUPS

2024-03-19T04:59:22Z

Hory: 脱字の修正を行った

[[Category:プリンター]]
[[Category:サーバー]]
[[de:CUPS]]
[[en:CUPS]]
[[fr:CUPS]]
[[ru:CUPS]]
[[zh-hans:CUPS]]
{{Related articles start}}
{{Related|CUPS/プリンター共有}}
{{Related|CUPS/プリンター別の問題}}
{{Related|CUPS/トラブルシューティング}}
{{Related|Samba}}
{{Related|LPRng}}
{{Related articles end}}

[https://openprinting.github.io/cups/ CUPS] は、Linux® や他の Unix® ライクなオペレーティングシステムのための標準ベースのオープンソースな印刷システムです。OpenPrinting によって開発されています。

Arch Linux では、[https://www.cups.org/ Apple CUPS フォーク]ではなく、[https://openprinting.github.io/cups/ OpenPrinting CUPS フォーク]がパッケージングされています。

== インストール ==

{{Pkg|cups}} パッケージを[[インストール]]してください。

{{Note|CUPS では、ドライバは IPP Everywhere に取って代わられる形で非推奨となっているため、印刷を機能させるには {{Pkg|cups-pdf}} をインストールする必要がある場合があります。このパッケージがないと、''client-error-document-format-not-supported'' のようなエラーが発生する場合があります。IPP Everywhere は PDF を直接プリンタに送信するため、印刷したいものをまず PDF に変換するために cups-pdf が必要です。}}

任意で、PDF ドキュメントに"印刷"したい場合は、{{Pkg|cups-pdf}} パッケージを[[インストール]]してください。デフォルトでは、PDF ファイルは {{ic|/var/spool/cups-pdf/''username''/}} に保存されます。保存場所は {{ic|/etc/cups/cups-pdf.conf}} で変更することができます。

そして、{{ic|cups.service}} を[[有効化]]し、[[起動]]してください。または、[[#ソケットアクティベーション|ソケットアクティベーション]]を使用することで、このサービスがプログラムによって必要とされる場合にのみ CUPS を起動させることもできます。

=== ソケットアクティベーション ===

{{Pkg|cups}} は {{ic|cups.socket}} ユニットを提供しています。{{ic|cups.socket}} が有効化されている (かつ、{{ic|cups.service}} が[[無効化]]されている) 場合、''systemd'' は CUPS をすぐには起動せず、適切なソケットをただリッスンします。プログラムがそれらの CUPS ソケットのうちどれかへの接続を試みた時に、''systemd'' は {{ic|cups.service}} を起動し、それらのポートの制御を CUPS プロセスへ透過的に渡します。

=== 印刷の流れ ===

関連する問題を解決したい場合は、CUPS がどう機能するかを知っておくことが重要です:

# '印刷' が選択された際、アプリケーションは [[Wikipedia:ja:PDF|PDF]] ファイルを CUPS に送信します (アプリケーションが他の形式を送信した場合、それらはまず PDF に変換されます)。
# CUPS はプリンタの PPD ファイル (プリンタ記述ファイル) を参照し、PDF ファイルをプリンタの理解できる言語 (PJL、PCL、ビットマップ、ネイティブな PDF など) へ変換するためにどのようなフィルタを使用する必要があるかを調べます。
# フィルタが PDF ファイルをプリンタの理解できる形式へ変換します。
# 最後に、そのデータがバックエンドへ送られます。例えば、プリンタが USB ポートに接続されている場合、USB バックエンドが使用されます。

== 接続インターフェイス ==

様々なインターフェイスにおける、プリンタを認識させるための追加の手順を以下に載せています。

=== USB ===

USB プリンタが認識されているかどうか確認するには、まず {{Pkg|usbutils}} パッケージがインストールされていることを確認し、以下を実行してください:

{{hc|$ lsusb|
(...)
Bus 001 Device 007: ID 03f0:1004 Hewlett-Packard DeskJet 970c/970cse
}}

=== パラレルポート ===

パラレルポートプリンターを使うには、[[カーネルモジュール]] {{ic|lp}}、{{ic|parport}}、そして {{ic|parport_pc}} が必要です。

{{hc|# dmesg {{!}} grep -i parport|
parport0: Printer, Hewlett-Packard HP LaserJet 2100 Series
lp0: using parport0 (polling)
}}

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

==== 既知の場所のプリンタを追加する ====

プリンタのアドレスがわかっている場合 (アドレスは、プリンタの画面に表示されたり、他の何らかの方法でネットワークをスキャンしたりなどして得られます)、プリンタを動的に発見する機能 (DNS-SD/mDNS) に頼る必要はありません。CUPS のキューを直接追加することで、プリンタを使用することができます。''lpadmin'' でキューを追加する歩法については、次の章かドキュメント [https://github.com/OpenPrinting/cups/tree/v2.4.7#setting-up-printers Setting up printers] で見られます。

==== プリンタを発見する ====

DNS-SD/mDNS を使ってプリンタを発見、使用、または共有するには、[[Avahi]] を使って [[Avahi#ホスト名の解決|.local ホストネーム解決]]をセットアップして、{{ic|cups.service}} を[[再起動]]してください。

{{Note|DNS-SD は、[[Avahi]] を使用している時にのみ、サポートされています。CUPS は [[systemd-resolved]] を DNS-SD のために使用することをサポートしていません。[https://github.com/apple/cups/issues/5452 CUPS issue 5452] を参照してください。}}

[[Samba]] を使ってネットワークプリンターを共有する場合や、例えばシステムを Windows クライアント用のプリンターサーバーにする場合、{{Pkg|samba}} パッケージが必要です。

== プリンタードライバー ==

{{Note|訳注: CUPS は PPD とドライバのサポートを廃止し、完全に IPP Everywhere に依存させることを計画しています ([https://github.com/OpenPrinting/cups/issues/103 CUPS issue 103])。英語版の議論ページ [[:en:Talk:CUPS#CUPS printer drivers and backends are deprecated]] も参照してください。}}

最近 (2010年以降) のプリンタのほとんどは、AirPrint や IPP_Everywhere を実装しているのでドライバレスでの使用をサポートしています (以下を参照)。

プリンターのドライバーは以下のソースのどこかから入手することができます。動作するのが確認されているドライバーの不完全なリストは [[CUPS/プリンター別の問題]] を見てください。

プリンターを動かすのに、CUPS は PPD ファイルを必要とします。また、大抵のプリンターではいくつかの[https://www.cups.org/doc/man-filter.html フィルター]も必要です。CUPS がどうやって PPD やフィルターを使用するのかは [https://www.cups.org/doc/postscript-driver.html] に詳しく書かれています。

[https://www.openprinting.org/printers OpenPrinting Printer List] は多数のプリンターの推奨ドライバーを教えてくれます。個別のプリンターの PPD ファイルも提供されていますが、大抵の場合は [[#Foomatic|foomatic]] や推奨されているドライバーパッケージから手に入ります。

PPD ファイルが CUPS に供給されると、CUPS サーバーは PPD ファイルを再生成して {{ic|/etc/cups/ppd/}} に保存します。

[[PKGBUILD]] を作成する前に PPD ファイルが動作することを確認するために、PPD ファイルを {{ic|/usr/share/cups/''model''}} に手動で追加することができます。cups サービスを再起動したあとに、そのドライバが利用可能になるはずです。

=== AirPrint と IPP Everywhere ===

CUPS には [[Wikipedia:ja:AirPrint|AirPrint]] と [https://www.pwg.org/ipp/everywhere.html IPP Everywhere] プリンタのサポートが含まれています。そのようなプリンタは自動的に発見されるはずです。

=== OpenPrinting CUPS フィルタ ===

Linux Foundation の OpenPrinting ワークグループは、[https://wiki.linuxfoundation.org/openprinting/cups-filters cups-filters] を提供しています。これらは、かつて CUPS の一部だったがプロジェクトから外されたバックエンド、フィルタ、そしてその他のバイナリです。これらは、{{Pkg|cups}} の依存関係である {{Pkg|cups-filters}} パッケージで利用できます。

非 PDF プリンタは、{{Pkg|ghostscript}} をインストールする必要があります。PostScript プリンタは、{{Pkg|gsfonts}} も必要である場合があります。

=== Foomatic ===

Linux Foundation の OpenPrinting ワークグループの [https://wiki.linuxfoundation.org/openprinting/database/foomatic foomatic] は、多くのプリンタドライバの PPD を (フリーとフリーでないもの両方) 提供しています。foomatic が何をするかに関する詳細は [https://www.openprinting.org/download/kpfeifle/LinuxKongress2002/Tutorial/IV.Foomatic-Developer/IV.tutorial-handout-foomatic-development.html Foomatic from the Developer's View] を参照してください。

foomatic を使うには、{{Pkg|foomatic-db-engine}} と、以下から最低でも1つをインストールしてください:

* {{Pkg|foomatic-db}} - foomatic-db-engine によって PPD ファイルを生成するために使用される XML ファイルのコレクション。
* {{Pkg|foomatic-db-ppds}} — ビルド済み PPD ファイル群。
* {{Pkg|foomatic-db-nonfree}} — プリンタのメーカーからフリーでないライセンスの XML ファイルのコレクション。foomatic-db-engine によって PPD ファイルを生成するために使用されます。
* {{Pkg|foomatic-db-nonfree-ppds}} — フリーでないライセンスのビルド済み PPD ファイル群。

foomatic PPD は追加のフィルタを必要とする場合があります (例: {{AUR|min12xxw}})。

=== Gutenprint ===

[https://gimp-print.sourceforge.net/ Gutenprint プロジェクト]は、CUPS と [[GIMP]] で使うための、Canon、Epson、Lexmark、Sony、Olympus、そして PCL のプリンタ用のドライバを提供しています。

{{Pkg|gutenprint}} と {{Pkg|foomatic-db-gutenprint-ppds}} をインストールしてください。

{{Note|Gutenprint のパッケージが更新された際、{{ic|cups-genppdupdate}} を root として実行し CUPS を再起動するまで、Gutenprint ドライバを使用するプリンタは動作を停止します。''cups-genppdupdate'' は、構成されたプリンタの PPD ファイルを更新します。詳細は {{man|8|cups-genppdupdate}} を参照してください。}}

=== メーカー固有のドライバ ===

多くのプリンタメーカーは独自の Linux ドライバを配布しています。中には Arch の公式リポジトリや [[AUR]] から入手できるものもあります。

これらのドライバのうちいくつかは [[CUPS/プリンター別の問題]] で詳しく説明されています。

== プリンター URI ==

以下は、必要に応じて手動で URI を生成する追加の手順をリストアップしています。一部のプリンタとドライバは、[[CUPS/プリンター別の問題]] で説明されている通り、特殊な URI を必要とする場合があります。

=== USB ===

CUPS は USB プリンタの URI を自動的に生成できるはずです (例: {{ic|1=usb://HP/DESKJET%20940C?serial=CN16E6C364BH}})。

生成されない場合、[[CUPS/トラブルシューティング#USB プリンター]] でトラブルシューティングの手順を確認してください。

=== パラレルポート ===

URI は {{ic|parallel:''device''}} という形式である必要があります。例えば、プリンターが {{ic|/dev/lp0}} で接続されている場合、{{ic|parallel:/dev/lp0}} を使ってください。USB からパラレルポートに変換するアダプタを使っている場合、プリンター URI は {{ic|parallel:/dev/usb/lp0}} を使ってください。

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

[[#ネットワーク]]に書かれているように [[Avahi]] を設定することで、CUPS はプリンター URI を探知します。{{ic|avahi-discover}} を使ってプリンターの名前やアドレスを確認することもできます (例: {{ic|BRN30055C6B4C7A.local/10.10.0.155:631}})。

[[Avahi]] を使わずに URI を手動で生成することも可能です。ネットワークプリンターで利用可能な URI スキーマのリストは [https://www.cups.org/doc/network.html#PROTOCOLS CUPS のドキュメント]を見てください。プリンターによって URI には細かい違いがあるので、プリンターのマニュアルや [[CUPS/プリンター別の問題]]もチェックしてください。

[[SMB]] 共有におけるプリンタの URI は、{{man|8|smbspool}} man ページで説明されています。

{{Note|プリンタ URI 内の特殊文字は適切に URL エンコードする必要があります。さもないと、Windows プリンタ名やユーザのパスワードに空白が存在する場合、CUPS は {{ic|lpadmin: Bad device-uri}} エラーを投げます。
例えば、{{ic|smb://BEN-DESKTOP/HP Color LaserJet CP1510 series PCL6}} は {{ic|smb://BEN-DESKTOP/HP%20Color%20LaserJet%20CP1510%20series%20PCL6}} となります。

以下のコマンドを実行することで、URL エンコードされた文字列を得ることができます:

$ python -c 'from urllib.parse import quote; print("smb://" + quote("BEN-DESKTOP/HP Color LaserJet CP1510 series PCL6"))'

}}

リモートの CUPS 印刷サーバーは {{ic|ipp://''hostname'':631/printers/''queue_name''}} という形式の URI でアクセスできます。リモートの印刷サーバーをセットアップする方法は [[CUPS/プリンター共有#GNU/Linux システム間]] を見てください。

他の問題については [[CUPS/トラブルシューティング#ネットワークの問題]]を見てください。

{{Warning|1=サーバとクライアントの両方をプリンタフィルタで設定することは避けてください。クライアントかサーバのどちらかの印刷キューは 'raw' であるべきです。こうすることで、フィルタを通して印刷ジョブが2回送信されることを防ぐことができます (2回送信されてしまうと、共有されたプリンタがローカルでは動作するが、リモートマシンでは印刷に失敗してしまうなどの問題を引き起こす可能性があります [https://bbs.archlinux.org/viewtopic.php?pid=1589908#p1589908])。印刷キューを 'raw' に設定する例は [[#lp*]] を見てください。}}

== 使用方法 ==

CUPS は ''lp*'' ツールと ''cups*'' ツールを使って完全に制御できます。または、[[#ウェブインターフェイス]] や [[#GUI アプリケーション]] を使うこともできます。

* ''queue'' はキューを識別するために使われる短くてわかりやすい名前です。名前に空白・特殊文字を含めることはできません。例えば、HP LaserJet 5P を使用する印刷キューの名前は "hpljet5p" などとします。複数のキューを物理的なプリンターに関連付けることができます。
* ''location'' はプリンターの物理的な場所の説明です (例えば "bedroom" や "kitchen" など)。複数のプリンターを管理しやすくするためにあります。
* ''description'' はプリンターの完全な説明です。大抵はプリンターの正式名称が使われます ("HP LaserJet 5P" など)。

=== CLI ツール ===

コマンドラインツールに関するヒントは[http://localhost:631/help/options.html ローカルの CUPS ドキュメント]を参照してください。

{{Note|コマンドラインのスイッチはまとめて指定することができません。}}

SNMP を使って URI を見つけるには:

$ /usr/lib/cups/backend/snmp ''ip_address''

==== lp* ====

''lpinfo'' コマンドは、{{ic|-v}} オプションを付けるとシステムに接続されているプリンタの URI を一覧表示し、{{ic|-m}} オプションを付けるとシステム上にインストールされている利用可能な全てのドライバ (CUPS 用語では "モデル") を一覧表示します。

''lpadmin'' ユーティリティは、{{ic|-p ''queue_name''}} オプションを付けると新しいキューを作成します。{{ic|-p}} に {{ic|-E}} を加えると、プリンタを有効化し、ジョブを受け入れるようになります。{{ic|-v}} フラグはデバイスの URI を指定します。{{ic|-m}} フラグは、使用するドライバ (CUPS 用語では "モデル") か PPD ファイルを指定します。

{{ic|-x}} フラグを使うことでプリンタを取り除くこともできます (先に [[#cups*]] を読んでください)。

例:

# lpadmin -p HP_DESKJET_940C -E -v "usb://HP/DESKJET%20940C?serial=CN16E6C364BH" -m drv:///HP/hp-deskjet_940c.ppd.gz

ドライバレスのキュー (Apple AirPrint か IPP Everywhere) の場合は:

# lpadmin -p AirPrint -E -v "ipp://10.0.1.25/ipp/print" -m everywhere

raw キューの場合 (PPD もフィルタも無し):

# lpadmin -p SHARED_PRINTER -m raw

モデルではなく PPD を指定する場合:

# lpadmin -p Test_Printer -E -v "ipp://10.0.1.3/ipp/print" -m pxlmono.ppd

{{Note|
* PPD を指定する場合、フルパスではなくファイル名だけを指定してください (例えば、{{ic|/usr/share/ppd/cupsfilters/pxlmono.ppd}} ではなく {{ic|pxlmono.ppd}})。あるいは、{{ic|-P}} コマンドラインスイッチを使うことでフルパスを使用することもできます。
* 2021年現在、最近のプリンタの多くはドライバレスの印刷セットアップをサポートしており、{{ic|-m everywhere}} を指定すると (上記の例では2番目)、プリンタが定義され、ネットワーク上のプリンタにクエリすることで ''.ppd'' ファイルが {{ic|/etc/cups/ppd/}} 内に作成されます。
}}

''lpq'' ユーティリティはキューのチェックを行います。全てのキューをチェックするには {{ic|-a}} フラグを追加してください。

''lprm'' ユーティリティはキューをクリアします。デフォルトの最後のキューではなく、全てのエントリを削除するには {{ic|-}} を追加してください。

''lpr'' ユーティリティは印刷を行います。ファイルを ''N'' 回印刷するには {{ic|-# ''N''}} を使用してください。ヘッダを追加するには {{ic|-p}} フラグを使用してください。

''lpr'' を使って印刷テストを行う例:

$ lpr /usr/share/cups/data/testprint
$ echo 'Hello, world!' | lpr -p

''lpstat'' ユーティリティは、{{ic|-s}} フラグを付けて使用すると、ステータスをチェックします。{{ic|-p}} フラグを付けると、チェックするキューを指定できます。

''lpoptions'' ユーティリティは、上記の ''lpadmin'' と同じ {{ic|-p ''queue_name''}} フラグを使用します。{{ic|-l}} フラグを付けると、オプションを一覧表示します。{{ic|-d}} フラグは、デフォルトのプリンタを引数 {{ic|''queue_name''}} に設定します。{{ic|-o}} フラグは、オプションに値を設定します:

$ lpoptions -p HP_DESKJET_940C -o PageSize=A4
$ lpoptions -p HP_DESKJET_940C -o cupsIPPSupplies=true -o Duplex=DuplexNoTumble

==== cups* ====

ユーティリティ ''cupsaccept''、''cupsdisable''、''cupsenable''、そして ''cupsreject'' は、その名の通りの動作を行います。それぞれの動作は次のとおりです:ジョブを受け入れるようにプリンタを設定する、プリンタを無効化する、プリンタをアクティブ化する、全ての受信タスクを拒否するようにプリンタを設定する。

例として、プリンタをクリーンに取り除いてみましょう:

# cupsreject ''queue_name''
# cupsdisable ''queue_name''
# lpadmin -x ''queue_name''

==== ink ====

インクレベルを見るには {{AUR|ink}} を[[インストール]]してください。

{{Note|[http://libinklevel.sourceforge.net/index.html#supported サポートされているプリンタのリスト]を参照してください。}}

ユーザを {{ic|lp}} [[ユーザグループ]]に追加し、一旦ログアウトし、再度ログインしてください。

詳細を見るには、オプションを付けずに {{ic|ink}} を実行してください。

=== ウェブインターフェイス ===

CUPS サーバは、ウェブインターフェイス (http://localhost:631/ で利用可能) から完全に管理することができます。

{{Note|CUPS への HTTPS 接続を使用する場合、初回アクセス時はインターフェイスが現れるまでに非常に長い時間がかかる''場合があります''。これは、初回リクエスト時に SSL 証明書の生成がトリガーされ、これに時間が掛かる可能性があるからです。}}

ウェブインターフェイスから管理を行うには、認証が必要です。[[#パーミッション]] を参照してください。

;キューを追加する
'''Administration''' ('''管理''') ページを開いてください。

;既存のキューを編集する
'''Printers''' ('''プリンター''') ページを開き、編集したいキューを選択してください。

;キューをテストする
'''Printers''' ('''プリンター''') ページを開き、キューを選択してください。

=== GUI アプリケーション ===

CUPS を管理するのに十分な権限がユーザに無い場合、アプリケーションは起動時に root のパスワードを要求します。ユーザに root アクセスを要さない管理権限を与える方法は、[[#設定]] を見てください。

* {{App|Deepin Print Manager|Deepin デスクトップのためのプリンタ設定インターフェイス。|https://github.com/linuxdeepin/dde-printer|{{Pkg|deepin-printer}}}}
* {{App|GtkLP|CUPS の GTK インターフェイス。|https://gtklp.sirtobi.com/index.shtml|{{AUR|gtklp}}}}
* {{App|print-manager|印刷ジョブとプリンターの管理ツール ([[KDE]])。|https://invent.kde.org/utilities/print-manager|{{Pkg|print-manager}}}}
* {{App|system-config-printer|GTK プリンタ設定ツールと状態アプレット。|https://github.com/OpenPrinting/system-config-printer|{{Pkg|system-config-printer}}}}

== 設定 ==

CUPS サーバの設定は {{ic|/etc/cups/cupsd.conf}} と {{ic|/etc/cups/cups-files.conf}} にあります ({{man|5|cupsd.conf}} と {{man|5|cups-files.conf}} を参照)。どちらかのファイルを編集したら、変更を適用するために {{ic|cups.service}} を[[再起動]]してください。ほとんどのユーザにとって、デフォルトの設定で問題ありません。

=== パーミッション ===

==== グループ ====

プリンタの管理権限を持つ[[ユーザグループ]]は {{ic|/etc/cups/cups-files.conf}} 内の {{ic|SystemGroup}} で定義されています。デフォルトでは、{{ic|sys}} グループ、{{ic|root}} グループ、そして {{ic|wheel}} グループが使用されています。

CUPS のヘルパプログラムは、{{ic|cups}} ユーザとグループとして実行されます。これにより、ヘルパプログラムがプリンタデバイスにアクセスしたり、{{ic|/etc/cups/}} 内の設定ファイル ({{ic|cups}} グループによって所有されています) を読み込んだりすることができます。

{{Note|{{Pkg|cups}} 2.2.6-2 より前では、{{ic|lp}} グループが[https://gitlab.archlinux.org/archlinux/packaging/packages/cups/-/commit/b6ebb9850aa9a27c27e668fe066d063a7711c15b 代わりに使用されていました]。アップグレード後、{{ic|/etc/cups}} 内のファイルは、{{ic|/etc/cups/cups-files.conf}} 内で設定されている {{ic|cups}} グループ、{{ic|User 209}}、そして {{ic|Group 209}} によって所有されるはずです。}}

==== PolicyKit による管理者認証を許可する ====

[[PolicyKit]] を設定することで、ユーザは管理者パスワードを入力せずに GUI を使ってプリンタを設定できるようになります。

{{Note|system-config-printer を使用する場合、system-config-printer に PolicyKit を使用させるために {{Pkg|cups-pk-helper}} をインストールする必要があります。}}

以下は、wheel [[ユーザグループ]]のメンバーにパスワード無しでのプリンタ管理を許可する例です:

{{hc|/etc/polkit-1/rules.d/49-allow-passwordless-printer-admin.rules|2=
polkit.addRule(function(action, subject) {
if (action.id == "org.opensuse.cupspkhelper.mechanism.all-edit" &&
subject.isInGroup("wheel")){
return polkit.Result.YES;
}
});
}}

=== デフォルトの用紙サイズ ===

{{Pkg|cups}} は、{{Pkg|libpaper}} サポートありでビルドされており、libpaper はデフォルトで[[Wikipedia:ja:レターサイズ|レター]]用紙サイズ ({{ic|lpoptions}} では {{ic|PageSize}} と呼ばれています) を使用します。印刷キューを追加するたびに用紙サイズを変更する手間を省くために、{{ic|/etc/papersize}} を[[テキスト編集|編集]]してシステムのデフォルト用紙サイズを設定することができます。{{man|1|paper}} を参照してください。

=== アーカイブ PDF/A ===

以下は、互換性の高い形式で PDF ファイルを保存する方法です (通常、これらは Archival PDF や PDF/A、PDFA、ISO 19005 と呼ばれます)。

現在、オプションはありません。なので、cups によって使用される、''gs'' を呼び出すコマンドに追加する必要があります。

{{Accuracy|{{ic|/etc/cups/cups.conf}} は {{pkg|cups}} パッケージに存在しません。なので、以下の設定例のコメントアウトされているデフォルト引数付きの {{ic|GSCall}} オプションは存在しません。}}

{{hc|/etc/cups/cups.conf|2=
# GSCall %s -q -dCompatibilityLevel=%s -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile="%s" -dAutoRotatePages=/PageByPage -dAutoFilterColorImages=false -dColorImageFilter=/FlateEncode -dPDFSETTINGS=/prepress -c .setpdfwrite -f %s

# 上記は GSCall を呼び出す際のデフォルト引数です。-dNOPAUSE の前に -dPDFA を追加し、上記をアンコメントすると (デフォルトの設定が変わっているかもしれないので、以下の行を丸々コピペしないでください。あなたのシステム上のデフォルトを使用してください):

GSCall %s -q -dCompatibilityLevel=%s '''-dPDFA''' -dNOPAUSE -dBATCH -dSAFER -sDEVICE=pdfwrite -sOutputFile="%s" -dAutoRotatePages=/PageByPage -dAutoFilterColorImages=false -dColorImageFilter=/FlateEncode -dPDFSETTINGS=/prepress -c .setpdfwrite -f %s
}}

=== ログファイル ===

デフォルトでは、全てのログは {{ic|/var/log/cups/}} 内のファイルへ送られます。

ログレベルは {{ic|/etc/cups/cupsd.conf}} で変更できます。[https://www.cups.org/doc/man-cupsd.conf.html cupsd.conf ドキュメント]を参照してください。

{{ic|/etc/cups/cups-files.conf}} 内の {{ic|AccessLog}} ディレクティブ、{{ic|ErrorLog}} ディレクティブ、そして {{ic|PageLog}} ディレクティブの値を {{ic|syslog}} に変更することで、CUPS にログを代わりに [[systemd journal]] へ記録させることができます。元の提案された変更に関する情報は [[Fedora:Changes/CupsJournalLogging]] を参照してください。

=== cups-browsed ===

{{Out of date|DNS-SD で広告されたプリンタを発見するために {{ic|cups-browsed.service}} は必要ありません。これは {{ic|cups.service}} によって行われます。{{ic|cups-browsed.service}} は、LDAP サーバや、レガシーな CUPS プロトコル (CUPS サーバ ≤ 1.5) を使用するサーバでプリンタを発見する時にだけ必要になります。}}

CUPS は [[Avahi]] browsing を使ってネットワーク上の未知の共有プリンターを発見することができます。サーバーがどこにあるのかわからないくらい巨大な構成で有用です。この機能を使うには [[Avahi#ホスト名の解決|.local ホストネーム解決]]を設定して、{{ic|avahi-daemon.service}} と {{ic|cups-browsed.service}} の両方を起動してください。ジョブは何も処理されずにプリンターに直接送信されるため、作成されたキューが動作しない場合があります。しかし、[https://www.pwg.org/ipp/everywhere.html IPP Everywhere] や [[Wikipedia:ja:AirPrint|AirPrint]] をサポートするプリンタなど、ドライバレスのプリンタは設定せずに動作するはずです。

{{Note|1=<nowiki/>
* ネットワークプリンタの検索によって[https://bbs.archlinux.org/viewtopic.php?pid=1720219#p1720219 コンピュータの起動時間が大幅に長くなってしまうことがあります]。
* {{ic|cups-browsed.service}} は、プリンタがネットワークに現れたり消えたりしたときに、そのプリンタを動的に追加したり削除したりするときにだけ必要になります。単に DNS-SD/mDNS 対応のネットワークプリンタを CUPS に追加したい場合は、必要ありません。
}}

=== 印刷サーバとリモート管理 ===

[[CUPS/プリンター共有]] と [[CUPS/プリンター共有#リモート管理]] を見てください。

=== ローカルの CUPS サーバーを使わない ===

CUPS ではローカルにプリンターサーバーを立ち上げるかわりにリモートのプリンターサーバーに直接接続するように設定することができます。{{Pkg|libcups}} パッケージの[[インストール]]が必要です。ただし、アプリケーションによってはリモートのサーバーを使用する場合も印刷するのに {{Pkg|cups}} パッケージのインストールを必要とします。

{{Note|ローカルの CUPS サーバーを使わずにリモートプリンターにアクセスすることは開発者によって非推奨とされています。[https://lists.cups.org/pipermail/cups/2015-October/027229.html]}}

リモートの CUPS サーバーを使うには、{{ic|CUPS_SERVER}} [[環境変数]]を {{ic|printerserver.mydomain:port}} に設定してください。例えば、単一の [[Firefox]] インスタンスにおいて別の印刷サーバを使用した場合は ({{ic|printserver.mydomain:port}} の部分は、あなたの印刷サーバの名前/ポートに置き換えてください):

$ CUPS_SERVER=printserver.mydomain:port firefox

この設定を永続化するには、設定ファイル {{ic|/etc/cups/client.conf}} を作成し、それにリモート CUPS サーバーのホスト名を追加します:

ServerName server

カスタムポートを指定することもできます:

ServerName server:port

詳細は、[https://www.cups.org/doc/sharing.html#AUTO_IPP] を参照してください。

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

[[CUPS/トラブルシューティング]] と [[CUPS/プリンター別の問題]] を見てください。

== 参照 ==

* [http://localhost:631/help 公式 CUPS ドキュメント] (''ローカルにインストールされています'')
* [[Wikipedia:ja:CUPS]]
* [https://wiki.linuxfoundation.org/openprinting/start OpenPrinting ホームページ]
* [https://ja.opensuse.org/%E5%8D%B0%E5%88%B7%E5%87%A6%E7%90%86%E3%81%AE%E8%80%83%E3%81%88%E6%96%B9 印刷処理の考え方 - 印刷ワークフローについての説明]
* [https://en.opensuse.org/SDB:CUPS_in_a_Nutshell OpenSuSE CUPS in a Nutshell - a quick CUPS overview]
* [[Gentoo:Printing]]
* [[debian:Printing|Debian の印刷ポータル - 詳細な技術的ガイド]]
* [[debian:SystemPrinting|Debian の印刷の概要 - CUPS 印刷システムの基本的な概要]]
* [https://lists.linuxfoundation.org/pipermail/printing-architecture/ CUPS メーリングリスト]
* [https://lists.cups.org/mailman/listinfo/cups CUPS メーリングリスト (Apple フォーク)]
* [https://github.com/OpenPrinting/cups/issues CUPS 問題トラッカー]
* [https://github.com/apple/cups/issues CUPS 問題トラッカー (Apple フォーク)]

{{TranslationStatus|CUPS|2023-11-02|790537}}

フロッピーディスク

2024-03-17T17:46:01Z

Hory: USBで接続するFDDにはfloppyモジュールが必要ないことを追記した。

[[Category:ストレージ]]
[[Category:ファイルシステム]]
[[en:Floppy disks]]

フロッピーディスク（ディスケットとも）は磁性体を塗布した樹脂製の薄く柔らかい円盤を樹脂製の保護ケースに収めた記憶媒体です。
フロッピーディスクはフロッピーディスクドライブ（FDD）によって読み書きされます。

以下ではフロッピーディスクの基本的な使用方法やツールについて説明しています。

==インストール==

===カーネルモジュール===

ATAコネクタで接続するフロッピーディスクドライブの殆どは標準カーネルでサポートされています。フロッピーディスクドライブのドライバーとしては {{ic|floppy}} モジュールが使われます。

{{ic|floppy}} モジュールはデフォルトでは読み込まれないかもしれません。そのような場合、以下のコマンドでロードしてください:

# modprobe floppy

USBで接続するフロッピーディスクドライブの殆どはUSB大容量記憶装置クラスに準拠しているため、そのまま使用できるかもしれません。

===パッケージ===

Arch のパッケージリポジトリにはフロッピーディスクに関係するパッケージが2つ存在します:

* {{Pkg|dosfstools}}
* {{Pkg|mtools}}

更に、USB接続のフロッピーディスクドライブで低レベルフォーマットを行うには{{AUR|ufiformat}}が必要です。

==使用方法==

以下にフロッピーディスクを使用する一般的な手順を示します。以下のコマンド例では全て {{ic|/dev/fd0}} をフロッピーディスクドライブの Linux デバイスとして仮定しています。
デフォルトでは、全てのコマンドは管理者権限で実行する必要があります。
また、USBで接続するフロッピーディスクドライブは {{ic|/dev/sd''X''}}と表示されることに注意してください。

===ローレベルフォーマット===

フロッピーディスク（及び極初期のハードディスクドライブ）では「ローレベルフォーマット」を実行することにより、ディスク上にセクタやトラックの様々なマーカーが作成されます。
これはファイルシステムより低いレイヤで実行されます。
USB接続のフロッピーディスクドライブでそれを行うには{{AUR|ufiformat}}を用います。

# ufiformat /dev/sd''X''

デフォルトでは、現在のメディアの記録密度でフォーマットします。
フロッピーディスクコントローラがサポートしているフロッピーディスクの記録密度は{{ic|ufiformat -i /dev/sd''X''}}で確認することができます。

===フォーマット===

# mkfs.vfat /dev/fd0

===マウント===

# mount -t vfat /dev/fd0 /media/floppy

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

=== Unable to get diskette geometry ===

{{hc|# mkfs.msdos /dev/fd0 |
mkfs.msdos 3.0.5 (27 Jul 2009)
mkfs.msdos: unable to get diskette geometry for '/dev/fd0'
}}

上記のようなエラーが発生する場合、おそらくフロッピードライブが物理的に破損しています。

=== /dev/sg* family: No such file or directory ===

{{hc|# ufiformat /dev/sd''X''|
/dev/sg* family: No such file or directory
}}

上記のようなエラーが発生する場合、{{ic|sg}}モジュールがロードされていないのかもしれません。
その場合は以下のコマンドを実行することでロードすることができます。

# modprobe sg

==参照==

* [https://linux.die.net/man/8/floppy floppy(8)]
* [https://linux.die.net/man/8/fdformat fdformat(8)]
* http://www.daniel-baumann.ch/software/dosfstools/ - DOS ファイルシステムユーティリティ (not so verbosely documented IMHO)
* https://www.gnu.org/software/mtools/ - マウントせずに Unix から MS-DOS ディスクにアクセスするユーティリティコレクション
* https://github.com/tedigh/ufiformat/blob/master/README.md - ufiformat/README.md

フロッピーディスク

2024-03-07T06:26:09Z

Hory: ローレベルフォーマットについて追加した

[[Category:ストレージ]]
[[Category:ファイルシステム]]
[[en:Floppy disks]]
[[Wikipedia:ja:フロッピーディスク|Wikipedia]] より:

:フロッピーディスク（別名ディスケット）は薄くて柔らかい磁気ストレージメディアを防塵用に長方形のプラスチック容器に封入したディスクストレージメディアである。フロッピーディスクはフロッピーディスクドライブ（FDD）によって読み書きされる。

以下ではフロッピーディスクの基本的な使用方法やツールについて説明しています。

==インストール==

===カーネルモジュール===

ほとんどのフロッピードライブは標準カーネルでサポートされています。フロッピーディスクドライブのドライバーとしては {{ic|floppy}} モジュールが使われます。

{{ic|floppy}} モジュールはデフォルトでは読み込まれないかもしれません。そのような場合、以下のコマンドでロードしてください:

# modprobe floppy

===パッケージ===

Arch のパッケージリポジトリにはフロッピーディスクに関係するパッケージが2つ存在します:

* {{Pkg|dosfstools}}
* {{Pkg|mtools}}

更に、USB接続のフロッピーディスクドライブで低レベルフォーマットを行うには{{AUR|ufiformat}}が必要です。

==使用方法==

以下は一般的な作業を実行するコマンドです。以下のコマンド例では全て {{ic|/dev/fd0}} をフロッピーディスクドライブの Linux デバイスとして仮定しています。デフォルトでは、全てのコマンドは ''root'' で実行する必要があります。また、USBで接続するフロッピーディスクドライブは {{ic|/dev/sd''X''}}と表示されることに注意してください。

===ローレベルフォーマット===

フロッピーディスク（及び極初期のハードディスクドライブ）では「ローレベルフォーマット」を実行することにより、ディスク上にセクタやトラックの様々なマーカーが作成される。これはファイルシステムより低いレイヤで実行される。USB接続のフロッピーディスクドライブでそれを行うには{{AUR|ufiformat}}を用います。

# ufiformat /dev/sd''X''

デフォルトでは、ディスク上に在るフォーマットを使用します。フロッピーディスクコントローラがサポートしているフロッピーディスクのフォーマットは{{ic|ufiformat -i /dev/sd''X''}}で確認することができます。

===フォーマット===

# mkfs.vfat /dev/fd0

===マウント===

# mount -t vfat /dev/fd0 /media/floppy

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

=== Unable to get diskette geometry ===

{{hc|# mkfs.msdos /dev/fd0 |
mkfs.msdos 3.0.5 (27 Jul 2009)
mkfs.msdos: unable to get diskette geometry for '/dev/fd0'
}}

上記のようなエラーが発生する場合、おそらくフロッピードライブが物理的に破損しています。

=== /dev/sg* family: No such file or directory ===

{{hc|# ufiformat /dev/sd''X''|
/dev/sg* family: No such file or directory
}}

上記のようなエラーが発生する場合、{{ic|sg}}モジュールがロードされていないのかもしれません。その場合は以下のコマンドを実行することでロードすることができます。

# modprobe sg

==参照==

* [https://linux.die.net/man/8/floppy floppy(8)]
* [https://linux.die.net/man/8/fdformat fdformat(8)]
* http://www.daniel-baumann.ch/software/dosfstools/ - DOS ファイルシステムユーティリティ (not so verbosely documented IMHO)
* https://www.gnu.org/software/mtools/ - マウントせずに Unix から MS-DOS ディスクにアクセスするユーティリティコレクション