Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lpstat-cups(1) [redhat man page]

lpstat(1)						      Easy Software Products							 lpstat(1)

NAME

       lpstat - print cups status information

SYNOPSIS

       lpstat [ -E ] [ -a [ destination(s) ] ] [ -c [ class(es) ] [ -d ] [ -h server ] [ -l ] [ -o [ destination(s) ] ] [ -p [ printer(s) ] ] [ -r
       ] [ -R ] [ -s ] [ -t ] [ -u [ user(s) ] ] [ -v [ printer(s) ] [ -W [ which-jobs ] ]

DESCRIPTION

       lpstat displays status information about the current classes, jobs, and printers. When run with no arguments, lpstat will list jobs  queued
       by the user. Other options include:

       -E
	    Forces encryption when connecting to the server.

       -a [printer(s)]
	    Shows the accepting state of printer queues. If no printers are specified then all printers are listed.

       -c [class(es)]
	    Shows the printer classes and the printers that belong to them. If no classes are specified then all classes are listed.

       -d
	    Shows the current default destination.

       -h server
	    Specifies the CUPS server to communicate with.

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

       -o [destination(s)]
	    Shows the jobs queue on the specified destinations. If no destinations are specified all jobs are shown.

       -p [printer(s)]
	    Shows the printers and whether or not they are enabled for printing. If no printers are specified then all printers are listed.

       -r
	    Shows whether or not the CUPS server is running.

       -R
	    Shows the ranking of print jobs.

       -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 "-p" options.

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

       -u [user(s)]
	    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)]
	    Shows the printers and what device they are attached to. If no printers are specified then all printers are listed.

       -W [which-jobs]
	    Specifies which jobs to show, completed or not-completed (the default).

COMPATIBILITY

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

       The "-h" option is not a standard System V option.

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

       The "-W" option is unique to CUPS.

SEE ALSO

       cancel(1), lp(1), CUPS Software Users Manual, http://localhost:631/documentation.html

COPYRIGHT

       Copyright 1993-2002 by Easy Software Products, All Rights Reserved.

2 October 2002						    Common UNIX Printing System 						 lpstat(1)

Check Out this Related Man Page

cupsenable(8)							    Apple Inc.							     cupsenable(8)

NAME

       cupsdisable, cupsenable - stop/start printers and classes

SYNOPSIS

       cupsdisable [ -E ] [-U username ] [ -c ] [ -h server[:port] ] [ -r reason ] [ --hold ] destination(s)
       cupsenable [ -E ] [-U username ] [ -c ] [ -h server[:port] ] [ --release ] destination(s)

DESCRIPTION

       cupsenable starts the named printers or classes.

       cupsdisable stops the named printers or classes.  The following options may be used:

       -E
	    Forces encryption of the connection to the server.

       -U username
	    Uses the specified username when connecting to the server.

       -c
	    Cancels all jobs on the named destination.

       -h server[:port]
	    Uses the specified server and port.

       --hold
	    Holds remaining jobs on the named printer.	Useful for allowing the current job to complete before performing maintenance.

       -r "reason"
	    Sets the message associated with the stopped state. If no reason is specified then the message is set to "Reason Unknown".

       --release
	    Releases pending jobs for printing. Use after running cupsdisable with the --hold option to resume printing.

COMPATIBILITY

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

       The System V versions of these commands are disable and enable. They have been renamed to avoid conflicts with the  bash(1)  build-in  com-
       mands of the same name.

       The  CUPS versions of disable and enable may ask the user for an access password depending on the printing system configuration.  This dif-
       fers from the System V versions which require the root user to execute these commands.

SEE ALSO

       cupsaccept(8), cupsreject(8), cancel(1), lp(1), lpadmin(8), lpstat(1),
       http://localhost:631/help

COPYRIGHT

       Copyright 2007-2013 by Apple Inc.

9 October 2008							       CUPS							     cupsenable(8)
Man Page