lpq(1) OpenPrinting lpq(1)

# [NAME](#NAME)

lpq - show printer queue status

# [SYNOPSIS](#SYNOPSIS)

**lpq** \[ **-h server**\[**:port**] ] \[ **-E** ] \[ **-U** *username* ] \[ **-P destination**\[**/instance**] ] \[ **-a** ] \[ **-l** ] \[ **+interval** ]

# [DESCRIPTION](#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](#OPTIONS)

**lpq** supports the following options:

[**-E**](#E)

Forces encryption when connecting to the server.

[**-P destination**\[**/instance**\]](#P)

Specifies an alternate printer or class name.

[**-U username**](#U)

Specifies an alternate username.

[**-a**](#a)

Reports jobs on all printers.

[**-h server**\[**:port**\]](#h)

Specifies an alternate server. Note: This option must occur before all others.

[**-l**](#l)

Requests a more verbose (long) reporting format.

# [SEE ALSO](#SEE_ALSO)

[**cancel**(1)](/man/os/cups/cancel.1), [**lp**(1)](/man/os/cups/lp.1), [**lpr**(1)](/man/os/cups/lpr.1), [**lprm**(1)](/man/os/cups/lprm.1), [**lpstat**(1)](/man/os/cups/lpstat.1), CUPS Online Help (http://localhost:631/help)

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2020-2024 by OpenPrinting.

CUPS 2022-05-02

---

Document: lpq(1) from cups 2.4.20-r0 (Chainguard OS)
Source: https://github.com/OpenPrinting/cups