OS Manuals

/usr/bin/lpstat

The CUPS Printing System

From cups 2.4.20-r0 (os), captured 2026-11-05 by running lpstat --help (exit 1). permalink

Usage: lpstat [options]
Options:
-E                      Encrypt the connection to the server
-h server[:port]        Connect to the named server and port
-l                      Show verbose (long) output
-U username             Specify the username to use for authentication
-H                      Show the default server and port
-W completed            Show completed jobs
-W not-completed        Show pending jobs
-a [destination(s)]     Show the accepting state of destinations
-c [class(es)]          Show classes and their member printers
-d                      Show the default destination
-e                      Show available destinations on the network
-o [destination(s)]     Show jobs
-p [printer(s)]         Show the processing state of destinations
-r                      Show whether the CUPS server is running
-R                      Show the ranking of jobs
-s                      Show a status summary
-t                      Show all status information
-u [user(s)]            Show jobs queued by the current or specified users
-v [printer(s)]         Show the devices for each destination
Options (18)
OptionDescriptionSource
-EForces encryption when connecting to the server.help + man
-h server[:portConnect to the named server and porthelp
-lShows a long listing of printers, classes, or jobs.help + man
-U usernameSpecify the username to use for authenticationhelp + man
-HShows the server hostname and port.help + man
-W completedSpecifies which jobs to show, "all", "successful", "completed" or "not-completed" (the default).help + man
-a destination(s)Show the accepting state of destinationshelp
-c class(es)Show classes and their member printershelp
-dShows the current default destination.help + man
-eShows all available destinations on the local network.help + man
-o destination(s)Show jobshelp
-p printer(s)Show the processing state of destinationshelp
-rShows whether the CUPS server is running.help + man
-RShows the ranking of print jobs.help + man
-sShows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and their associated devices.help + man
-tShows all status information.help + man
-u user(s)Show jobs queued by the current or specified usershelp
-v printer(s)Show the devices for each destinationhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.