lpstat-cups

lpstat(1)                   Easy Software Products                   lpstat(1)



NAME
       lpstat - print cups status information

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

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). 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.

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" and "-W" options are unique to CUPS.

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

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

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



3 January 2003            Common UNIX Printing System                lpstat(1)