Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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]
       [-l]] [ -o [list]] [ -p	[list] [-D] [-l]] [ -S [list]  [-l]]  [	 -u  [
       login- ID -list]] [ -v [list]]

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 may appear	in any
       order and may be	repeated and intermixed	with  other  arguments.	  Some
       key  letters  may 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 on all platforms.

       -d    Prints the	default	destination for	output requests.

       -o [list]
	     Prints the	status of output requests. list	is a  list  of	inter-
	     mixed printer names, class	names, and request-IDs.	The key	letter
	     -o	may be omitted.	Specify	printer	and class names	using  atomic,
	     POSIX-style  (server:destination),	 or  Federated	Naming Service
	     (FNS) (.../service/printer/...) names. See	 printers.conf(4)  for
	     information  regarding  the naming	conventions for	atomic and FNS
	     names, and	standards(5) for information regarding POSIX.

       -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	sched-
	     uler, the default destination, a list of printers and their asso-
	     ciated  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.

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

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

	     login-ID
		   a user on any system

	     system_name!login-ID
		   a user on system system_name

	     system_name!all
		   all users on	system system_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.

       The following options return accurate results only if they  are	issued
       from  a	Solaris	2.6 Operating Environment or compatible	version	of the
       LP print	server.

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

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

       -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	will list the form descriptions.

       -p [list] [-D] [-l]
	     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.

       -S [list] [-l]
	     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  charac-
	     ter set. The list also shows whether the print wheel or character
	     set is mounted, or	specifies  the	built-in  character  set  into
	     which it maps.

       -d    Prints the	default	destination for	output requests.

       -o [list]
	     Prints  the  status  of output requests. list is a	list of	inter-
	     mixed printer names, class	names, and request-IDs.	The key	letter
	     -o	may be omitted.

       -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	sched-
	     uler, the default destination, a list of printers and their asso-
	     ciated 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.

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

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

	     login-ID
		   a user on any system

	     system_name!login-ID
		   a user on system system_name

	     system_name!all
		   all users on	system system_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
       /var/spool/print/*
	     LP	print queue.

       $HOME/.printers
	     User-configurable printer database.

       /etc/printers.conf
	     System configuration database.

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

       printers.org_dir
	     NIS+ version of /etc/printers.conf.

       fns.ctx_dir.domain
	     FNS version of /etc/printers.conf.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpcu			   |
       +-----------------------------+-----------------------------+

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)

SunOS 5.9			  6 Aug	1999			     lpstat(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lpstat&sektion=1&manpath=SunOS+5.9>

home | help