CUPS

2020-11-27T15:27:44Z

Sksat: org.cups.cupsd.serviceをcups.serviceに置き換え

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

[https://www.cups.org/ CUPS] は標準ベースの、Apple によって開発されている macOS® やその他の UNIX® ライクなオペレーティングシステム向けのオープンソースの印刷システムです。

== インストール ==

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

PDF 文章に「印刷」したい場合、{{pkg|cups-pdf}} パッケージもインストールしてください。デフォルトでは、PDF ファイルは {{ic|/var/spool/cups-pdf/$USER}} に保存されます。作成場所は {{ic|/etc/cups/cups-pdf.conf}} で変更できます。

インストールしたら {{ic|cups.service}} を[[起動]]・[[有効化]]してください。

== 接続インターフェイス ==
以下には様々なインターフェイスごとにプリンターを認識させる手順を載せています。

{{Note|1=<nowiki></nowiki>
* CUPS ヘルパープログラムは {{ic|cups}} ユーザー・グループを使って動作します。これによってヘルパープログラムからプリンターデバイスにアクセスできるようになり {{ic|cups}} グループに属する {{ic|/etc/cups/}} の設定ファイルを読み込めるようになります。
* {{Pkg|cups}} 2.2.6-2 以前では、{{ic|lp}} グループが使われていました [https://git.archlinux.org/svntogit/packages.git/commit/trunk?h=packages/cups&id=a209bf21797a239c7ddb4614f0266ba1e5238622]。アップグレード後、{{ic|/etc/cups}} のファイルの所有者は {{ic|cups}} グループに設定し、{{ic|/etc/cups/cups-files.conf}} には {{ic|User 209}} と {{ic|Group 209}} を記述する必要があります。
}}

=== USB ===
USB プリンターが認識されているかどうか確認するには:
{{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)
}}

=== ネットワーク ===
[[Avahi]] を使うことでローカルネットワーク内のプリンターをスキャンできます。[[Avahi]] ホストネームを使ってネットワークプリンターを接続するには、[[Avahi#ホスト名の解決|.local ホストネーム解決]]をセットアップして {{ic|cups.service}} を[[systemd#ユニットを使う|再起動]]してください。

[[Samba]] プロトコルを使ってネットワークプリンターに接続する場合や、Windows クライアント用のプリンターサーバーを使う場合、{{Pkg|samba}} パッケージをインストールしてください。

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

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

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

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

新しいドライバーをインストールした後は cups サービスの再起動が必要です。

=== CUPS ===
CUPS は何も設定をしなくても動作する PPD やフィルターのバイナリを少数ながらデフォルトで用意しています。また、CUPS は [[wikipedia:ja:AirPrint|AirPrint]] と [http://www.pwg.org/ipp/everywhere.html IPP Everywhere] プリンターにも対応しています。

=== Foomatic ===
[https://wiki.linuxfoundation.org/openprinting/database/foomatic foomatic] プロジェクトはフリーであるかを問わず多数のプリンタードライバーの PPD を提供しています。foomatic の活動の詳細は [http://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}} と {{pkg|foomatic-db}}, {{pkg|foomatic-db-ppds}}, {{pkg|foomatic-db-nonfree-ppds}}, {{pkg|foomatic-db-gutenprint-ppds}} の最低でもどれかひとつをインストールします。

foomatic の PPD は別途でフィルターを必要とすることがあり、{{pkg|gutenprint}} や {{pkg|ghostscript}} などが挙げられます (例えば {{aur|min12xxw}})。{{pkg|ghostscript}} が必要な場合、{{pkg|gsfonts}} もおそらく必須です。

=== メーカー別のドライバー ===
様々なプリンターメーカーが独自の Linux ドライバーを提供しています。中には Arch の公式リポジトリや [[AUR]] からインストールできるドライバーもあります。

一部のドライバーについては [[CUPS/プリンター別の問題]]に詳しい説明があります。

== プリンター URI ==

以下では手動での 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 スキーマのリストは CUPS のドキュメント [https://www.cups.org/doc/network.html#PROTOCOLS] を見てください。プリンターによって URI には細かい違いがあるので、プリンターのマニュアルや [[CUPS/プリンター別の問題]]もチェックしてください。

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

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

{{Warning|1=サーバーとクライアントの両方をプリンターフィルターで設定してはいけません。クライアントかサーバーのどちらかの印刷キューが 'raw' である必要があります。フィルターによってプリンターに同じ印刷ジョブを2回送信して問題が発生するのを避けるためです (例: [https://bbs.archlinux.org/viewtopic.php?pid=1589908#p1589908])。印刷キューを 'raw' に設定する例は[[#使用方法]]を見てください。}}

== 使用方法 ==

CUPS はコマンドラインツールの the lp* と cups* を使うことで制御できます。また、[[#ウェブインターフェイス|ウェブインターフェイス]]や [[#GUI アプリケーション|GUI アプリケーション]]を利用することも可能です。

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

=== CLI ツール ===

[http://localhost:631/help/options.html CUPS ローカルドキュメント] にはコマンドラインツールに関するヒントが載っています。

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

;デバイスを確認
# lpinfo -v #
$ /usr/lib/cups/backend/snmp ''ip_address'' # Use SNMP to find a URI

;モデルを確認
$ lpinfo -m

;新しい印刷キューを追加
# lpadmin -p ''queue_name'' -E -v ''uri'' -m ''model''

''queue_name'' は適当な名前に置き換えてください。例:
# lpadmin -p HP_DESKJET_940C -E -v "usb://HP/DESKJET%20940C?serial=CN16E6C364BH" -m drv:///HP/hp-deskjet_940c.ppd.gz
# lpadmin -p AirPrint -E -v "ipp://10.0.1.25/ipp/print" -m everywhere # Driverless queue (Apple AirPrint or IPP Everywhere)
# lpadmin -p SHARED_PRINTER -m raw # Raw queue; no PPD or filter
# lpadmin -p Test_Printer -E -v "ipp://10.0.1.3/ipp/print" -m pxlmono.ppd # Specifying a PPD instead of a model

{{Note|PPD を指定する場合、フルパスではなくファイル名だけ指定してください (例えば {{ic|/usr/share/ppd/cupsfilters/pxlmono.ppd}} ではなく {{ic|pxlmono.ppd}} を指定します)。}}

;デフォルトプリンターを設定
$ lpoptions -d ''queue_name''

;オプションを変更
$ lpoptions -p ''queue_name'' -l # List the options
$ lpoptions -p ''queue_name'' -o ''option''=''value'' # Set an option

例:
$ lpoptions -p HP_DESKJET_940C -o PageSize=A4

;状態を確認
$ lpstat -s
$ lpstat -p ''queue_name''

;プリンターを無効化
# cupsdisable ''queue_name''

;プリンターを有効化
# cupsenable ''queue_name''

;ジョブを受け取るようにプリンターを設定
# cupsaccept ''queue_name''

;プリンターの削除
まず印刷を要求するエントリを全て拒否するように設定してください:
# cupsreject ''queue_name''
次にプリンターを無効化してください:
# cupsdisable ''queue_name''
最後に削除してください:
# lpadmin -x ''queue_name''

;ファイルを印刷
$ lpr ''file''
$ lpr -# 17 ''file'' # print the file 17 times
$ echo 'Hello, world!' | lpr -p # print the result of a command. The -p switch adds a header.

;印刷キューを確認
$ lpq
$ lpq -a # on all queues

;印刷キューを消去
# lprm # remove last entry only
# lprm - # remove all entries

=== ウェブインターフェイス ===

CUPS サーバーはウェブインターフェイスを使って管理することができます。http://localhost:631/ を開いてください。

{{Note|HTTPS 接続で CUPS を使用する場合、初めてアクセスしたときにインターフェイスが表示されるまで長い時間がかかります。初期設定で行われる SSL 証明書の生成に時間がかかるためです。}}

ウェブインターフェイスから管理設定を行うには認証が必要です。{{ic|root}} で認証するか、ユーザーをプリンターの管理権限グループに追加してください。[[#設定]]を参照。

;印刷キューを追加
'''Administration''' ページを開いてください。

;既存のキューを編集
'''Printers''' ページを開いて、編集したいキューを選択してください。

;キューをテスト
'''Printers''' ページを開いて、キューを選択してください。

=== GUI アプリケーション ===

CUPS を管理するのに十分な権限を持っていない場合、アプリケーションが起動するときに root パスワードが要求されます。root 権限を与えずにユーザーに管理者権限を与える方法は[[#設定]]を見てください。

* {{App|print-manager|印刷ジョブとプリンターの管理ツール ([[KDE]])。|https://cgit.kde.org/print-manager.git|{{Pkg|print-manager}}}}
* {{App|system-config-printer|[[GTK+]] の CUPS プリンター設定ツール・状態アプレット。|http://cyberelk.net/tim/software/system-config-printer/|{{Pkg|system-config-printer}}}}
* {{App|gtklp|CUPS の GTK+ インターフェイス。|https://gtklp.sirtobi.com/index.shtml|{{AUR|gtklp}}}}

== 設定 ==

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}} グループが使われます。

{{pkg|cups}} は {{pkg|libpaper}} のサポートを有効にしてビルドされており、libpaper はデフォルトの用紙サイズとして '''Letter''' を使います。印刷キューを追加するたびに用紙サイズを変更しなくてもいいように、{{ic|/etc/papersize}} を編集してデフォルトの用紙サイズを設定してください。詳しくは {{man|5|papersize}} を参照。

デフォルトでは、全てのログは {{ic|/var/log/cups/}} 内のファイルに送信されます。{{ic|/etc/cups/cups-files.conf}} 内の {{ic|AccessLog}}, {{ic|ErrorLog}}, {{ic|PageLog}} ディレクティブの値を {{ic|syslog}} に変更することで、CUPS から [[systemd#Journal|systemd journal]] にログを吐かせることができます。詳しくは [https://fedoraproject.org/wiki/Changes/CupsJournalLogging fedora wiki] を見てください。

=== cups-browsed ===

CUPS は [[Avahi]] を使ってネットワーク上の未知の共有プリンターを発見することができます。サーバーがどこにあるのかわからないくらい巨大な構成で有用です。この機能を使うには [[Avahi#ホスト名の解決|.local ホストネーム解決]]を設定して、{{ic|avahi-daemon.service}} と {{ic|cups-browsed.service}} の両方を起動してください。ジョブは何も処理されずにプリンターに直接送信されるため、キューの作成が上手く行かない場合もあります。[http://www.pwg.org/ipp/everywhere.html IPP Everywhere] あるいは [[wikipedia:ja:AirPrint|AirPrint]] に対応しているドライバー不要のプリンターであれば特に設定をしなくても問題なく動作するはずです。

{{Note|1=ネットワークプリンターの検索によってコンピュータの起動時間が大幅に遅くなってしまうことがあります [https://bbs.archlinux.org/viewtopic.php?pid=1720219#p1720219]。}}

=== プリンター共有 ===

[[CUPS/プリンター共有]]と[[CUPS/プリンター共有#リモート管理]]を見てください。

=== PolicyKit による管理者認証 ===

[[PolicyKit]] を設定することで管理者パスワードを入力しなくても GUI を使ってユーザーからプリンターを設定できるようにすることができます。

{{Note|ルールを適用するには {{Pkg|cups-pk-helper}} のインストールが必要な場合があります。}}

以下は wheel [[グループ]]のメンバーにプリンターの管理を許可する例です:

{{hc|/etc/polkit-1/rules.d/49-allow-passwordless-printer-admin.rules|<nowiki>
polkit.addRule(function(action, subject) {
if (action.id == "org.opensuse.cupspkhelper.mechanism.all-edit" &&
subject.isInGroup("wheel")){
return polkit.Result.YES;
}
});</nowiki>}}

=== ローカルの CUPS サーバーを使わない ===

CUPS ではローカルにプリンターサーバーを立ち上げるかわりにリモートのプリンターサーバーに直接接続するように設定することができます。{{Pkg|libcups}} パッケージの[[インストール]]が必要です。ただし、アプリケーションによってはリモートのサーバーを使用する場合も印刷するのに {{Pkg|cups}} パッケージのインストールを必要とします。

{{Warning|ローカルの CUPS サーバーを使わずにリモートプリンターにアクセスすることは開発者によって非推奨とされています [http://www.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

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

[[CUPS/トラブルシューティング]]を見てください。

== 参照 ==

* [http://localhost:631/help CUPS 公式ドキュメント], ''ローカルにインストールされたドキュメント''
* [[Wikipedia:ja:Common Unix Printing System]]
* [https://www.linuxfoundation.org/collaborate/workgroups/openprinting 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 OpenSuSE の印刷処理の考え方 - 印刷ワークフローについての説明]
* [https://en.opensuse.org/SDB:CUPS_in_a_Nutshell OpenSuSE CUPS in a Nutshell - a quick CUPS overview]
* [https://wiki.gentoo.org/wiki/Printing/ja Gentoo の印刷ガイド]
* [https://wiki.debian.org/Printing Debian の印刷ポータル]
* [https://wiki.debian.org/SystemPrinting Debian の CUPS 印刷システムの概要]

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

CUPS