Mac Developer Library Developer


This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

lpstat(1)                                        Apple Inc.                                        lpstat(1)

       lpstat - print cups status information

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

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

       The lpstat command supports the following options:

            Forces encryption when connecting to the server.

            Shows the server hostname and port.

            Shows the ranking of print jobs.

       -U username
            Specifies an alternate username.

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

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

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

            Shows the current default destination.

       -h server[:port]
            Specifies an alternate server.

            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 speci-fied specified
            fied then all printers are listed.

            Shows whether the CUPS server is running.

            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.

            Shows all status information. This is equivalent to using the  "-r",  "-d",  "-c",  "-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.

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

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

       cancel(1), lp(1),

       Copyright 2007-2013 by Apple Inc.

10 September 2008                                   CUPS                                           lpstat(1)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.