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

FreeBSD Manual Pages

  
 
  

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 [ lo-
       gin- 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 op-
       tions are assumed to be request-IDs as returned by lp. The lpstat  com-
       mand  prints the	status of such requests. options may appear in any or-
       der 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  ac-
	     ceptable  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