.\" Copyright (c) 1983, 1991, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)printcap.5	8.2 (Berkeley) 12/11/93
.\" %FreeBSD: src/usr.sbin/lpr/lpr/printcap.5,v 1.33 2004/07/02 23:12:47 ru Exp %
.\"
.\" $FreeBSD$
.Dd October 11, 2000
.Dt PRINTCAP 5
.Os
.Sh 名称
.Nm printcap
.Nd プリンタケーパビリティデータベース
.Sh 書式
.Nm
.Sh 解説
.Nm
は、
ラインプリンタの記述に使われる
.Xr termcap 5
を簡略化したものです。
スプールシステムは利用のたび毎に
.Nm
ファイルにアクセスするため、
プリンタを動的に追加したり削除することが可能です。
データベース中の各々のエントリが、1 台のプリンタを記述するのに使われます。
.Xr termcap 5
とは異なり、このデータベースは代替できません。
これは、アカウント情報がバイパスされてしまうことがあるからです。
.Pp
デフォルトのプリンタは通常
.Em lp
ですが、環境変数
.Ev PRINTER
によって上書きすることもできます。
各スプーリングユーティリティはオプション
.Fl P Ar printer
をサポートし、出力先のプリンタ名を明示することが可能です。
.Pp
あるプリンタに対するデータベースをセットアップする方法の詳細については、
.%T "4.3 BSD Line Printer Spooler Manual"
を参照してください。
.Sh ケーパビリティ
ファイルレイアウトの解説については
.Xr termcap 5
を参照してください。
.Bl -column Namexxx Typexx "/var/spool/lpdxxxxx"
.Sy "Name	Type	Default	Description
.It "af	str" Ta Dv NULL Ta No "アカウンティングファイル名"
.It "br	num	none	lp が tty の場合、ボーレートを設定 "
.Xr ( ioctl 2
call)
.It "cf	str" Ta Dv NULL Ta No "cifplot データ用フィルタ"
.It "ct	num	120	TCP コネクションのタイムアウト時間(秒)"
.It "df	str" Ta Dv NULL Ta No "tex データ用フィルタ"
.Tn ( DVI
フォーマット)
.It "ff	str" Ta So Li \ef Sc Ta No "フォームフィード送信文字"
.It "fo	bool	false	デバイスオープン時にフォームフィードを印字"
.It "gf	str" Ta Dv NULL Ta No "グラフデータフィルタ"
.Xr ( plot 3
フォーマット
.It "hl	bool	false	バーストヘッダページを最後に印刷"
.It "ic	bool	false	字下げ出力の用の(非標準の) ioctl をサポートした
ドライバ"
.It "if	str" Ta Dv NULL Ta No "アカウンティングを行うためのテキストフィルタ名"
.It "lf	str" Ta Pa /dev/console Ta No "エラーロギングファイル名"
.It "lo	str" Ta Pa lock Ta No "ロックファイル名"
.It "lp	str" Ta Pa /dev/lp Ta No "出力時にオープンするデバイス名、またはオープンする TCP ソケット" Em port Ns @ Ns Em machine
.It "mc	num" Ta 0 Ta Xr lpr 1
で要求できる最大部数を指定します。0 = 制限なし。
.It "ms	str" Ta Dv NULL Ta No "lp が tty の場合、コンマで区切ったリスト。"
tty モード記述用の
.Xr stty 1
リストに似ている。
.It "mx	num	0	最大ファイルサイズ ("
.Dv BUFSIZ
ブロック単位)。0 = 制限なし。
.It "nd	str" Ta Dv NULL Ta No "キューのリスト用の次のディレクトリ (未実装)"
.It "nf	str" Ta Dv NULL Ta No "ditroff データ用フィルタ (device independent troff)"
.It "of	str" Ta Dv NULL Ta No "出力用フィルタリングプログラム名"
.It "pc	num	200	1 フィートまたは 1 ページあたりの
費用 (1/100 セント単位)"
.It "pl	num	66	1 ページの行数"
.It "pw	num	132	1 行の文字数"
.It "px	num	0	ピクセル単位のページ幅 (水平方向)"
.It "py	num	0	ピクセル単位のページ長 (垂直方向)"
.It "rc	bool	false	リモートホストへ送信時、各部を再送します (下記参照)"
.It "rf	str" Ta Dv NULL Ta No ""
.Tn FORTRAN
形式のテキストファイル出力用フィルタ
.It "rg	str" Ta Dv NULL Ta No "グループ制限。許可されたグループのメンバのみアクセスが許可される"
.It "rm	str" Ta Dv NULL Ta No "リモートプリンタが接続されているホスト名"
.It "rp	str" Ta Pa lp Ta No "リモートプリンタ名引数"
.It "rs	bool	false	ローカルにアカウントを持つリモートユーザに対する制限"
.It "rw	bool	false	プリンタデバイスを読み書き用にオープンする"
.It "sb	bool	false	短いバナー (1 行のみ)"
.It "sc	bool	false	複数コピーの抑制"
.It "sd	str" Ta Pa /var/spool/lpd Ta No "スプール ディレクトリ"
.It "sf	bool	false	フォームフィードの抑制"
.It "sh	bool	false	バーストページヘッダの出力抑制"
.It "sr	str" Ta Dv NULL Ta No "受信される各データファイルの統計情報を保持するファイル名"
.It "ss	str" Ta Dv NULL Ta No "送信される各データファイルの統計情報を保持するファイル名"
.It "st	str" Ta Pa status Ta No "状態ファイル名"
.It "tf	str" Ta Dv NULL Ta No "troff データ用フィルタ (cat phototypesetter)"
.It "tr	str" Ta Dv NULL Ta No "キューが空の時に印刷するトレイラ文字列"
.It "vf	str" Ta Dv NULL Ta No "ラスタイメージ用フィルタ"
.El
.Pp
2 文字のケーパビリティは、別の読み易い名前があります。
.Bl -column "短い形式" "長い形式"
.Sy "短い形式	長い形式"
.It "af	acct.file"
.It "br	tty.rate"
.It "cf	filt.cifplot"
.It "ct	remote.timeout"
.It "df	filt.dvi"
.It "du	daemon.user"
.It "ff	job.formfeed"
.It "fo	job.topofform"
.It "gf	filt.plot"
.It "hl	banner.last"
.It "if	filt.input"
.It "lf	spool.log"
.It "lo	spool.lock"
.It "lp	tty.device"
.It "mc	max.copies"
.It "ms	tty.mode"
.It "mx	max.blocks"
.It "nf	filt.ditroff"
.It "of	filt.output"
.It "pc	acct.price"
.It "pl	page.length"
.It "pw	page.width"
.It "px	page.pwidth"
.It "py	page.plength"
.It "rc	remote.resend_copies"
.It "rf	filt.fortran"
.It "rg	daemon.restrictgrp"
.It "rm	remote.host"
.It "rp	remote.queue"
.It "rs	daemon.restricted"
.It "rw	tty.rw"
.It "sb	banner.short"
.It "sc	job.no_copies"
.It "sd	spool.dir"
.It "sf	job.no_formfeed"
.It "sh	banner.disable"
.It "sr	stat.recv"
.It "ss	stat.send"
.It "st	spool.status"
.It "tf	filt.troff"
.It "tr	job.trailer"
.It "vf	filt.raster"
.El
.Pp
ローカルラインプリンタのドライバが字下げをサポートしているならば、
プリンタデーモンはその使い方を理解しなければなりません。
.Sh フィルタ
.Xr lpd 8
デーモンは
.Em filters
のパイプラインを作成し、さまざまなタイプのプリンタ用に処理を行います。
フィルタは
.Xr lpr 1
へ渡されるフラグに応じて選択されます。
パイプラインは次のように設定されます。
.Bd -literal -offset indent
p	pr | if	通常テキスト + pr(1)
none	if	通常テキスト
c	cf	cifplot
d	df	DVI (tex)
g	gf	plot(3)
n	nf	ditroff
f	rf	Fortran
t	tf	troff
v	vf	ラスタイメージ
.Ed
.Pp
.Sy if
フィルタは次の引数をとります。
.Bd -ragged -offset indent
.Cm if
.Op Fl c
.Fl w Ns Ar width
.Fl l Ns Ar length
.Fl i Ns Ar indent
.Fl n Ar login
.Fl h Ar host acct-file
.Ed
.Pp
.Fl c
フラグは
.Fl l
フラグ (コントロール文字をそのまま通過させます) が
.Xr lpr 1
に指定された場合のみ渡されます。
.Ar width
機能と
.Ar length
機能はページ幅とページ長を
(それぞれ
.Cm pw
と
.Cm pl
によって) 文字単位で指定します。
.Fl n
と
.Fl h
パラメータでそれぞれのジョブの所有者のログイン名とログイン先ホスト名を
指定します。
.Ar acct-file
機能は
.Nm
の
.Cm af
エントリがそのまま使われます。
.Pp
.Cm if
が指定されなかった場合、
.Cm of
が代わりに使われます。
.Cm of
は
.Cm if
が個々のジョブ毎にオープンされるのに対して、たった 1 回だけ
オープンされると言う特徴を持っています。
そのため、アカウンティングを行うには
.Cm if
の方が向いています。
.Cm of
には、
.Ar width
と
.Ar length
フラグのみが与えられます。
.Pp
その他の全てのフィルタは次のように呼び出されます。
.Bd -ragged -offset indent
.Nm filter
.Fl x Ns Ar width
.Fl y Ns Ar length
.Fl n Ar login
.Fl h Ar host acct-file
.Ed
.Pp
.Ar width
と
.Ar length
はピクセル単位で表され、それぞれ
.Cm px
と
.Cm py
エントリで指定されます。
.Pp
全てのフィルタはファイルを
.Em stdin
から読み込み
.Em stdout
からの出力をプリンタに送られ、
.Em stderr
または
.Xr syslog 3
がログ出力に使われます。
フィルタは
.Dv SIGINT
を無視してはいけません。
.Sh リモートプリンティング
.Cm rm
を使用してリモートプリンタに印刷する時、
.Cm if
または
.Cm of
を使用できます。両方を指定した場合、
.Cm of
は無視されます。
どちらのフィルタも同様に振舞いますが、上述の通り異なった引数を渡されます。
特に、出力フィルタはファイルが転送されるたびに、停止・再起動されます。
このように動作することが必要な理由は、フィルタを通した結果の大きさをリモート
.Xr lpd 8
に渡すためです。
.Pp
.Fl p
フラグが
.Xr lpr 1
に渡されると、
.Xr pr 1
はローカルでは実行されませんが、リモートの
.Xr lpd 8
に対して要求されます。それゆえ、
.Cm if
を介したフィルタリングは、
.Xr pr 1
が実行される後ではなく前に実行されることになります。
.Pp
ネットワークプリンタのモデルによっては、
.Xr lpd 8
からのジョブを受け付けるものの、ジョブ制御ファイルを無視し、
各データファイルがプリンタに届くと印刷するだけのものがあります。
このような動作の副作用のひとつに、
.Xr lpr 1
コマンドで指定される
.Fl #
フラグで指定される複数部数の要求をプリンタが無視してしまうことがあります。
.Cm rc
エントリは、ユーザが元々要求した各部に対して、
.Xr lpd 8
がデータファイルを再送するようにします。
.Cm rc
エントリを指定して良いのは、プリンタに直接ジョブを送るホストだけです。
.Pp
.Cm lp
が
.Em port Ns @ Ns Em machine
で指定された場合 (そして
.Cm rm
が使用されない場合)、印刷データは指定された
.Em machine
の指定された
.Em port
に直接転送されます。
.Sh 転送の統計情報
印刷ジョブがリモートマシン
(他の UNIX ボックスかもしれませんしネットワークプリンタかもしれません)
に転送されるとき、各転送の統計情報を保持することが有効かもしれません。
.Cm sr
および
.Cm ss
のオプションは、lpd がこのような統計情報を保持するためのファイル名を示します。
ジョブの統計情報の行が各データファイルに書き込まれるのは、
ファイルの転送に成功したときです。
行の書式は、転送における送信側と受信側とで、同一です。
.Pp
ジョブを送ってくる種々のマシンとプリントサーバ間のネットワーク性能に
興味がある場合、
受信データファイルの統計情報をプリントサーバで使えるかもしれません。
プリントサーバは、印刷ジョブがサーバに届くたびに、
各印刷ジョブの速度の統計情報を集めることができます。
.Pp
誰がどのジョブをリモートプリンタに送ったのか、
何時送られたのか、そしてファイルの (バイト数での) 大きさはどのくらいだったか
について知りたい場合、送信データファイルの統計情報を
最小のアカウンティング記録として使えるかもしれません。
しかし、何ページ印刷したのかといった情報は一切含みません。
なぜなら、
そのような情報をリモート (ネットワーク) プリンタから得るための標準的な方法が
存在しないためです。
.Sh ロギング
ラインプリンタプログラム自身 (つまり
.Xr lpd 8
とそれに関連するプログラム) が生成したエラーメッセージは、
.Xr syslog 3
の
.Dv LPR
ファシリティを使ってロギングされます。
フィルタの 1 つから
.Em stderr
に出力されたメッセージは、対応する
.Cm lf
で指定されたファイルに送られます。
当然、フィルタ自身もまた
.Xr syslogd 8
を使うことがあるかも知れません。
.Pp
コンソールに送られるエラーメッセージには、ラインフィードだけではなく
キャリッジリターンとラインフィードが追加されます。
.Sh 関連項目
.Xr lpq 1 ,
.Xr lpr 1 ,
.Xr lprm 1 ,
.Xr hosts.lpd 5 ,
.Xr termcap 5 ,
.Xr chkprintcap 8 ,
.Xr lpc 8 ,
.Xr lpd 8 ,
.Xr pac 8
.Rs
.%T "4.3 BSD Line Printer Spooler Manual"
.Re
.Sh 歴史
.Nm
ファイルフォーマットは
.Bx 4.2
から登場しました。