lpstat man page on BSDOS

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



lpstat(1)						lpstat(1)

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

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

DESCRIPTION
       The lpstat command prints information  about  the  current
       status  of the LP print service.	 This is implemented as a
       front end to the LPRng lpq(1) program, and does	not  have
       the full functionality of the native lpstat program.

       If  no options are given, then lpstat prints the status of
       all the user's print requests made by lp	 on  the  default
       printer.	  (see lp(1) and lpr(1)).  Any arguments that are
       not options are assumed to be request-IDs as  returned  by
       lp or printer names.  The lpstat command prints the status
       of such requests.  The options may appear in any order and
       may be repeated and intermixed with other arguments.  Some
       of the keyletters below may be  followed	 by  an	 optional
       list that can be in one of two forms: a list of items sep-
       arated 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 keyletter that takes list  as  an
       argument	 causes all information relevant to the keyletter
       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  information relevant to the key letter to be printed.
       For example, the command:

	      example% lpstat -o

       prints the status of all output requests.

OPTIONS
       The following options are supported:

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

			    7 Feb 1994				1

lpstat(1)						lpstat(1)

       -c [list]      Print name of all classes	 and  their  mem-
		      bers.   list  is	a  list	 of  class names.
		      (Same effect as -o.)

       -d	      Print the system	default	 destination  for
		      output requests.

       -f [list] [-l] Print list of printers supporting the spec-
		      ified forms option is ignored.

       -o [list]      Print the status of output  requests:  list
		      is  a  list  of  intermixed  printer names,
		      class names, and request-IDs.  The  keylet-
		      ter -o may be omitted.

       -p [list]      Print  the  status  of printers.	list is a
		      list of printer  names.	(Same  effect  as
		      -o.)

       -P	      Print the paper types.  Ignored.

       -r	      Print  the  status of the LP request sched-
		      uler.

       -R	      Print a number showing the position of each
		      job in the print queue.  Ignored.

       -s	      Print  a	status summary.	 Produces a short
		      status listing.

       -S [list] [-l] List or verify character sets of	printers.
		      (Ignored.)

       -t	      Print all status information.

       -u [login-ID-list]
		      Print  the  status  of  output requests for
		      users.  (Same effect as -o.)

       -v [list]      Print the path names of the printer  output
		      devices.	(Ignored.)

ENVIRONMENT
       See  environ(5) for descriptions of the following environ-
       ment variables that affect the execution of lpstat:

       LPDEST	      Determine the spool queue.  If  the  LPDEST
		      environment   variable   is  not	set,  the
		      PRINTER environment variable will be  used.
		      The  -P dest  option  takes precedence over
		      LPDEST.  Results are undefined when  -P  is
		      not  specified  and LPDEST contains a value
		      that is not a valid device  or  destination
		      name.

			    7 Feb 1994				2

lpstat(1)						lpstat(1)

       PRINTER	      Determine the output device or destination.
		      If the LPDEST and PRINTER environment vari-
		      ables  are  not  set, an unspecified output
		      device is used.  The -P dest option and the
		      LPDEST  environment  variable  takes prece-
		      dence over PRINTER.  Results are	undefined
		      when  -P is not specified, LPDEST is unset,
		      and PRINTER contains a value that is not	a
		      valid device or destination name.

EXIT STATUS
       The following exit values are returned by cancel:

       0	      Successful completion.

       >0	      An error occurred.

SEE ALSO
       lpd.conf(5),  lpc(8),  lpd(8), checkpc(8), lpr(1), lpq(1),
       lprm(1), printcap(5), lpd.perms(5), pr(1).

DIAGNOSTICS
       Most of the diagnostics are self explanatory.
       If you are puzzled over the exact cause of failure,
       set the debugging level on (-D5) and run again.
       The debugging information will
       help you to pinpoint the exact cause of failure.

HISTORY
       LPRng is a enhanced printer spooler system with	function-
       ality  similar  to  the	Berkeley LPR software.	The LPRng
       mailing list is lprng@lprng.com; subscribe by sending mail
       to  lprng-request@lprng.com with the word subscribe in the
       body.	  The	  software     is     available	     from
       ftp://ftp.astart.com/pub/LPRng.

AUTHOR
       Patrick Powell <papowell@astart.com>.

			    7 Feb 1994				3

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

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