unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



lpstat(1)							    lpstat(1)



NAME

  lpstat - Displays line printer status	information

SYNOPSIS

  lpstat [-a[list]] [-c[list]] [-d  | -r  | -s	| -t] [-o[list]] [-p[list]]
  [-u[list]] [-v[list]]	[request_ID...]

  The lpstat command displays information about	the current status of the
  line printer.

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  lpstat:  XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

  -a[list]
      Specifies	the display of acceptance status (with respect to the lp and
      lpr commands) of destinations for	requests.  The list argument is	a
      list of intermixed printer names and request IDs.

  -cO[clist]
      Write the	class names and	their members.	The list argument is a list
      of class names.

  -d  Specifies	the display of the system default destination for the lp and
      lpr commands.

  -o[list]
      Specifies	the display of the status of printer requests. The list	argu-
      ment is a	list of	intermixed printer names and request IDs. Note that
      when combined, the -o and	-u options do not produce merged output.

  -p[list]
      Specifies	the display of the status of printers.	The list argument is
      a	list of	printer	names.

  -r  Specifies	the display of the status of the line printer daemon.

  -s  Specifies	the display of a status	summary, including the status of the
      line printer scheduler, the system default destination, and a list of
      printers and their associated devices.

  -t  Specifies	the display of all status information.

  -u[list]
      Specifies	the display of the status of all printer requests.  The	list
      argument is a list of usernames. The list	argument is a list of inter-
      mixed printer names and request IDs. Note	that when combined, the	-o
      and -u options do	not produce merged output.

  -v[list]
      Specifies	the display of the names of printers and the path names	of
      the devices associated with them.	The list argument is a list of
      printer names.

OPERANDS

  request_ID
      A	request	ID as returned by lp or	lpr.

DESCRIPTION

  If no	options	are given, then	lpstat displays	the status of all requests
  made by the lp and lpr commands. Any arguments that are not options are
  assumed to be	a request_ID (as returned by the lp or lpr commands).  The
  lpstatcommand	displays the status of such requests.

  Options can appear in	any order and can be repeated and intermixed with
  other	options.  Some options can be followed by an optional list that	is
  either a list	of items separated from	one another by a , (comma), or a list
  of items enclosed in " " (double quotes) and separated from one another by
  a comma or one or more spaces.  For example:

       -u"user1, user2,	user3"

  Specifying just the option with no arguments causes all information per-
  taining to that option to be displayed.

  If the LPDEST	environment variable is	set to a valid printer name, this
  becomes the default destination; otherwise, PRINTER is tried and, as a last
  resort, a system-specific printer.

NOTES

  The lpstat utility is	marked LEGACY in XCU Issue 5.

  [Tru64 UNIX]	Output produced	by the lpstat command is very similar to out-
  put from lpq and lpc,	rather than output from	earlier	versions of lpstat.

EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion.

  >>0  An error occurred.

ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of lpstat:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      Determines the location of message catalogues for	the processing of
      LC_MESSAGES.

  TZ  Determines the time zone used with date and time strings.

FILES

  /etc/printcap
      Printer description file.

  /var/spool/*
      Spool directories.

  /var/spool/*/minfree
      Minimum free space to leave.

  /dev/lp*
      Line printer devices.

  /dev/printer
      Socket for local requests.

  /var/spool/*/cf*
      Daemon control files.

  /var/spool/*/df*
      Data files specified in cf files.

  /var/spool/*/tf*
      Temporary	copies of cf files.

  /var/spool/*/lock
      Lock file	used to	obtain the process ID of the current daemon and	the
      request ID of the	currently active request.

SEE ALSO

  Commands:  lp(1), lpc(8), lpd(8), lpq(1), lpr(1), lprm(1)

  Files:  printcap(4)

  Standards:  standards(5)