lpstat(1) OpenPrinting lpstat(1)

# [NAME](#NAME)

lpstat - print cups status information

# [SYNOPSIS](#SYNOPSIS)

**lpstat** \[ **-h hostname**\[**:port**] ] \[ **-E** ] \[ **-H** ] \[ **-U** *username* ] \[ **-l** ] \[ **-W** *which-jobs* ] \[ **-a** \[ *destination(s)* ] ] \[ **-c** \[ *class(es)* ] ] \[ **-d** ] \[ **-e** ] \[ **-o** \[ *destination(s)* ] ] \[ **-p** \[ *printer(s)* ] ] \[ **-r** ] \[ **-R** ] \[ **-s** ] \[ **-t** ] \[ **-u** \[ *user(s)* ] ] \[ **-v** \[ *printer(s)* ] ]

# [DESCRIPTION](#DESCRIPTION)

**lpstat** displays status information about the current classes, jobs, and printers. When run with no arguments, **lpstat** will list active jobs queued by the current user.

# [OPTIONS](#OPTIONS)

The **lpstat** command supports the following options:

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

Forces encryption when connecting to the server.

[**-H**](#H)

Shows the server hostname and port.

[**-R**](#R)

Shows the ranking of print jobs.

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

Specifies an alternate username.

[**-W which-jobs**](#W)

Specifies which jobs to show, "all", "successful", "completed" or "not-completed" (the default). This option *must* appear before the *-o* option and/or any printer names, otherwise the default ("not-completed") value will be used in the request to the scheduler.

[**-a** \[*printer(s)*\]](#a)

Shows the accepting state of printer queues. If no printers are specified then all printers are listed.

[**-c** \[*class(es)*\]](#c)

Shows the printer classes and the printers that belong to them. If no classes are specified then all classes are listed.

[**-d**](#d)

Shows the current default destination.

[**-e**](#e)

Shows all available destinations on the local network.

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

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

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

Shows a long listing of printers, classes, or jobs.

[**-o** \[*destination(s)*\]](#o)

Shows the jobs queued on the specified destinations. If no destinations are specified all jobs are shown.

[**-p** \[*printer(s)*\]](#p)

Shows the printers and whether they are enabled for printing. If no printers are specified then all printers are listed.

[**-r**](#r)

Shows whether the CUPS server is running.

[**-s**](#s)

Shows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and their associated devices. This is equivalent to using the *-d*, *-c*, and *-v* options.

[**-t**](#t)

Shows all status information. This is equivalent to using the *-r*, *-d*, *-c*, *-v*, *-a*, *-p*, and *-o* options.

[**-u** \[*user(s)*\]](#u)

Shows a list of print jobs queued by the specified users. If no users are specified, lists the jobs queued by the current user.

[**-v** \[*printer(s)*\]](#v)

Shows the printers and what device they are attached to. If no printers are specified then all printers are listed.

# [CONFORMING TO](#CONFORMING_TO)

Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#". Also, printer and class names are *not* case-sensitive.

The *-h*, *-e*, *-E*, *-U*, and *-W* options are unique to CUPS.

The Solaris *-f*, *-P*, and *-S* options are silently ignored.

# [SEE ALSO](#SEE_ALSO)

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

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2020-2024 by OpenPrinting.

CUPS 2022-05-02

---

Document: lpstat(1) from cups 2.4.19-r4 (Chainguard OS)
Source: https://github.com/OpenPrinting/cups