lpstat man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

lpstat(1)			 User Commands			     lpstat(1)

NAME
       lpstat - print information about the status of the print service

SYNOPSIS
       lpstat [-d] [-r] [-R] [-s] [-t] [-a [list]] [-c [list]]
	    [-f [list]] [-o [list]] [-p [list] [-D]] [-S [list]]
	    [-u [login- ID -list]] [-v [list]] [-l level]

DESCRIPTION
       The lpstat utility displays information about the current status of the
       LP print service to standard output.

       If no options are given, lpstat prints the status  of  all  the	user's
       print  requests	made  by  lp.  See  lp(1).  Any arguments that are not
       options are assumed to be request-IDs as returned  by  lp.  The	lpstat
       command	prints	the  status  of	 such requests. options appears in any
       order and can be repeated and intermixed with other arguments. Some key
       letters	can  be followed by an optional list that can be in one of two
       forms: a list of items separated from one another by a comma, or a list
       of  items  separated from one another by spaces enclosed in quotes. For
       example:

	 example% lpstat -u "user1 user2 user3"

       Specifying all after any key letter that	 takes	list  as  an  argument
       causes  all  information	 relevant to the key letter to be printed. For
       example, the command:

	 example% lpstat -o all

       prints the status of all output requests.

       The omission of a list following such key letters causes	 all  informa‐
       tion  relevant  to  the key letter to be printed. For example, the com‐
       mand:

	 example% lpstat -o

       prints the status of all output requests.

       The print client commands  locate  destination  information  using  the
       "printers"  database  in the name service switch. See nsswitch.conf(4),
       printers(4), and printers.conf(4) for details.

OPTIONS
       The following options are supported:

       -a [list]	     Reports whether print destinations are  accepting
			     requests.	list  is  a list of intermixed printer
			     names and class names.

			     If the print queue is remote and IPP is  in  use,
			     the  information  provided	 is very close to that
			     reported for local queues. If the print queue  is
			     remote and IPP is not in use (the print server is
			     older  than  Solaris  9,  Update  6  or   another
			     RFC-1179-based  print  service), this option does
			     not report any useful information.

       -c [list]	     Prints name of all	 classes  and  their  members.
			     list is a list of class names.

			     If	 the  print queue is remote and IPP is in use,
			     the information provided is very  close  to  that
			     reported  for local queues. If the print queue is
			     remote and IPP is not in use (the print server is
			     older   than  Solaris  9,	Update	6  or  another
			     RFC-1179-based print service), this  option  does
			     not report any useful information.

       -d		     Prints   the   default   destination  for	output
			     requests.

       -f[list] [-l]	     Prints a verification that the forms in list  are
			     recognized	 by  the  LP  print service. list is a
			     list of forms; the default is all. The -l	option
			     lists the form descriptions.

			     If	 the  print queue is remote and IPP is in use,
			     the information provided is very  close  to  that
			     reported  for local queues. If the print queue is
			     remote and IPP is not in use (the print server is
			     older   than  Solaris  9,	Update	6  or  another
			     RFC-1179-based print service), this  option  does
			     not report any useful information.

       -l [level]	     Specifies	 the   verbosity  level	 for  extended
			     reporting of printer or job objects (-o, -p,  -r,
			     -u).  Without  this option, a level of 0 is used,
			     which reports summary information. When no	 level
			     is specified, a level of 1is used, which provides
			     more information about the object. A level	 of  2
			     or	  more	 enumerates   all   of	 the  object's
			     attributes.

			     If the print queue is remote and IPP is  in  use,
			     the  information  provided	 is very close to that
			     reported for local queues. If the print queue  is
			     remote and IPP is not in use (the print server is
			     older  than  Solaris  9,  Update  6  or   another
			     RFC-1179-based  print  service), this option does
			     not report any useful information.

       -o [list]	     Prints the status of output requests. list	 is  a
			     list  of  intermixed  printer names, class names,
			     and request-IDs. The key letter -o can  be	 omit‐
			     ted.

			     Specify  printer  and  class  names using atomic,
			     URI-style	(scheme://endpoint),  or   POSIX-style
			     (server:destination)  names. See printers.conf(4)
			     for more information.

       -p [list] [-D]	     Prints the status of printers. list is a list  of
			     printer names. If the -D option is given, a brief
			     description is printed for each printer in	 list.
			     If	 the  -l option is given and the printer is on
			     the local machine, a  full	 description  of  each
			     printer's	configuration  is  returned, including
			     the form  mounted,	 the  acceptable  content  and
			     printer  types,  a	 printer  description, and the
			     interface used.

			     If the print queue is remote and IPP is  in  use,
			     correct job id is reported. If the print queue is
			     remote and IPP is not in use (the print server is
			     older   than  Solaris  9,	Update	6  or  another
			     RFC-1179-based print service), -p	[list]	always
			     reports  the  first job in the queue irrespective
			     of its status.

       -r		     Prints the status of the LP request scheduler.

       -R		     Prints a number  showing  the  position  of  each
			     request in the print queue.

       -s		     Prints  a status summary, including the status of
			     the LP scheduler, the default destination, a list
			     of	 printers and their associated devices, a list
			     of the machines sharing print services, a list of
			     all  forms	 currently  mounted, and a list of all
			     recognized character sets and print wheels.

       -S [list]	     Prints a verification that the character sets  or
			     the print wheels specified in list are recognized
			     by the LP print service. Items  in	 list  can  be
			     character	sets  or print wheels; the default for
			     the list is all. If the -l option is given,  each
			     line  is  appended by a list of printers that can
			     handle the print wheel or character set. The list
			     also  shows  whether the print wheel or character
			     set is mounted, or specifies the built-in charac‐
			     ter set into which it maps.

			     If	 the  print queue is remote and IPP is in use,
			     the information provided is very  close  to  that
			     reported  for local queues. If the print queue is
			     remote and IPP is not in use (the print server is
			     older   than  Solaris  9,	Update	6  or  another
			     RFC-1179-based print service), this  option  does
			     not report any useful information.

       -t		     Prints  all status information. This includes all
			     the information obtained with the -s option, plus
			     the acceptance and idle/busy status of all print‐
			     ers.

       -u [login-ID-list]    Prints the status of output requests  for	users.
			     The login-ID-list argument can include any or all
			     of the following constructs:

			     login-ID		     a user on any system

			     system_name!login-ID    a	user  on  system  sys‐
						     tem_name

			     system_name!all	     all  users on system sys‐
						     tem_name

			     all!login-ID	     a user on all systems

			     all		     all users on all systems

       -v [list]	     Prints the names of printers and the  path	 names
			     of	 the  devices  associated  with them or remote
			     system names for network printers. list is a list
			     of printer names.

EXIT STATUS
       The following exit values are returned:

       0	   Successful completion.

       non-zero	   An error occurred.

FILES
       /etc/printers.conf      System printer configuration database

       $HOME/.printers	       User-configurable printer database

       ou=printers	       LDAP version of /etc/printers.conf

       printers.conf.byname    NIS version of /etc/printers.conf

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWlp-cmds		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Committed			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Standard		     │See standards(5).		   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       cancel(1),  lp(1), lpq(1B), lpr(1B), lprm(1B), nsswitch.conf(4), print‐
       ers(4), printers.conf(4), attributes(5), standards(5)

NOTES
       For remote print queues, the BSD print protocol provides a very limited
       set of information. The Internet Print Protocol (IPP) is preferred.

       When IPP is in use, the user is prompted for a passphrase if the remote
       print service is configured to require authentication.

SunOS 5.11			  10 Dec 2009			     lpstat(1)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net