man/lpq.man

   1 .\"
   2 .\" lpq man page for CUPS.
   3 .\"
   4 .\" Copyright 2007-2014 by Apple Inc.
   5 .\" Copyright 1997-2006 by Easy Software Products.
   6 .\"
   7 .\" These coded instructions, statements, and computer programs are the
   8 .\" property of Apple Inc. and are protected by Federal copyright
   9 .\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  10 .\" which should have been included with this file.  If this file is
  11 .\" file is missing or damaged, see the license at "http://www.cups.org/".
  12 .\"
  13 .TH lpq 1 "CUPS" "12 June 2014" "Apple Inc."
  14 .SH NAME
  15 lpq \- show printer queue status
  16 .SH SYNOPSIS
  17 .B lpq
  18 [
  19 .B \-E
  20 ] [
  21 .B \-U
  22 .I username
  23 ] [
  24 \fB\-h \fIserver\fR[\fB:\fIport\fR]
  25 ] [
  26 \fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
  27 ] [
  28 .B \-a
  29 ] [
  30 .B \-l
  31 ] [
  32 .BI + interval
  33 ]
  34 .SH DESCRIPTION
  35 \fBlpq\fR shows the current print queue status on the named printer.
  36 Jobs queued on the default destination will be shown if no printer or class is specified on the command-line.
  37 .LP
  38 The \fI+interval\fR option allows you to continuously report the jobs in the queue until the queue is empty; the list of jobs is shown once every \fIinterval\fR seconds.
  39 .SH OPTIONS
  40 \fBlpq\fR supports the following options:
  41 .TP 5
  42 .B \-E
  43 Forces encryption when connecting to the server.
  44 .TP 5
  45 \fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
  46 Specifies an alternate printer or class name.
  47 .TP 5
  48 \fB\-U \fIusername\fR
  49 Specifies an alternate username.
  50 .TP 5
  51 .B \-a
  52 Reports jobs on all printers.
  53 .TP 5
  54 \fB\-h \fIserver\fR[\fB:\fIport\fR]
  55 Specifies an alternate server.
  56 .TP 5
  57 .B \-l
  58 Requests a more verbose (long) reporting format.
  59 .SH SEE ALSO
  60 .BR cancel (1),
  61 .BR lp (1),
  62 .BR lpr (1),
  63 .BR lprm (1),
  64 .BR lpstat (1),
  65 CUPS Online Help (http://localhost:631/help)
  66 .SH COPYRIGHT
  67 Copyright \[co] 2007-2015 by Apple Inc.