.\" Copyright (c) 1983, 1990, 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.
.\"
.\" @(#)lpq.1 8.2 (Berkeley) 4/28/95
.\" %FreeBSD: src/usr.sbin/lpr/lpq/lpq.1,v 1.5.2.4 2002/06/21 16:40:46 charnier Exp %
.\" $FreeBSD$
.\"
.Dd April 28, 1995
.Dt LPQ 1
.Os
.Sh 名称
.Nm lpq
.Nd キューに登録されている印刷ジョブの確認を行う
.Sh 書式
.Nm
.Op Fl a
.Op Fl l
.Op Fl P Ns Ar printer
.Op job # ...\&
.Op user ...\&
.Sh 解説
.Nm
ユーティリティは、ラインプリンタにファイルをプリントアウトするために
.Xr lpd 8
が利用するスプールエリアを調べ、
指定したジョブもしくはユーザに関連するすべてのジョブの状態を報告します。
.Nm
ユーティリティを引数を指定せずに実行したときは、現在、キュー内にあるすべての
ジョブの状態を報告します。
.Pp
オプションとしては、以下のものがあります:
.Pp
.Bl -tag -width indent
.It Fl P
特定のプリンタを指定します。
指定しない場合は、デフォルトのラインプリンタ
(もしくは環境変数
.Ev PRINTER
の値)が用いられます。
この他に指定された引数はすべてユーザ名ないしジョブ番号とみなされ、
操作対象のジョブを選別するのに用いられます。
.It Fl l
ジョブエントリを構成するファイルのそれぞれについての情報を
表示します。たいていは 1 行に収まる程度の情報が表示されます。
.It Fl a
特定のプリンタに対しての情報だけでなく、全てのプリンタに対する情報を
報告します。
.El
.Pp
委託された(つまり
.Xr lpr 1
の実行)各ジョブに対して、
.Nm
はユーザ名、
キュー内でのランク、ジョブが持っているファイルの名前、ジョブ識別子
(特定のジョブを削除するために
.Xr lprm 1
に引数として与えられる番号)、
そして合計のサイズを報告します。ジョブの順番はスプールディレクトリを
スキャンするアルゴリズムに依存し、
.Tn FIFO
(First In First Out) であると仮定しています。
ジョブのファイル名がわからない場合 (
.Xr lpr 1
がパイプラインで接続された場合など) は、ファイル名は``(standard input)'' と
表示されます。
.Pp
もし
.Nm
がデーモンがないと警告した場合 (何かの不調が原因である)、
.Xr lpc 8
コマンドを用いてプリンタデーモンをリスタートさせてください。
.Sh 環境変数
.Bl -tag -width PRINTER
.It Ev PRINTER
かわりのデフォルトプリンタを指定する
.El
.Sh 関連ファイル
.Bl -tag -width "/var/spool/*/lock" -compact
.It Pa /etc/printcap
プリンタの特性を記述する。
.It Pa /var/spool/*
スプールディレクトリ。printcap での設定により決まる。
.It Pa /var/spool/*/cf*
ジョブを明記した制御ファイル。
.It Pa /var/spool/*/lock
現在アクティブなジョブを得るためのロックファイル。
.El
.Sh 関連項目
.Xr lpr 1 ,
.Xr lprm 1 ,
.Xr lpc 8 ,
.Xr lpd 8
.Sh 歴史
.Nm
ユーティリティは
.Bx 3
から登場しました。
.Sh バグ
スプールディレクトリに格納される情報は動的に変化するため、
.Nm
の報告内容は信頼性の低い場合があります。
画面出力形式は端末の行の長さの影響を受けやすく、
行方向に余分な空白が入ることがあります。
.Sh 診断
種々のファイルがオープンできません。
ロックファイルが壊れています。
デーモンが動作していなくても、スプールディレクトリにゴミが残ることがあります。
