Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

lpq (1)

Name

lpq - show printer queue status

Synopsis

lpq  [  -E  ]  [  -U  username  ]  [  -h  server[:port] ] [ -P destina-
tion[/instance] ] [ -a ] [ -l ] [ +interval ]

Description

lpq(1)                            Apple Inc.                            lpq(1)



NAME
       lpq - show printer queue status

SYNOPSIS
       lpq  [  -E  ]  [  -U  username  ]  [  -h  server[:port] ] [ -P destina-
       tion[/instance] ] [ -a ] [ -l ] [ +interval ]

DESCRIPTION
       lpq shows the current print queue status on the  named  printer.   Jobs
       queued  on the default destination will be shown if no printer or class
       is specified on the command-line.

       The +interval option allows you to continuously report the jobs in  the
       queue  until  the  queue is empty; the list of jobs is shown once every
       interval seconds.

OPTIONS
       lpq supports the following options:

       -E   Forces encryption when connecting to the server.

       -P destination[/instance]
            Specifies an alternate printer or class name.

       -U username
            Specifies an alternate username.

       -a   Reports jobs on all printers.

       -h server[:port]
            Specifies an alternate server.

       -l   Requests a more verbose (long) reporting format.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | print/cups       |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       cancel(1),  lp(1),  lpr(1),  lprm(1),  lpstat(1),  CUPS   Online   Help
       (http://localhost:631/help)

COPYRIGHT
       Copyright (C) 2007-2019 by Apple Inc.



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded   from    https://github.com/apple/cups/ar-
       chive/v2.3.3.zip.

       Further information about this software can be found on the open source
       community website at http://www.cups.org/.



26 April 2019                        CUPS                               lpq(1)