Index for Section 1

Alphabetical listing for L

Bottom of page

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
  industry 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
      argument 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
      intermixed 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
  pertaining 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
  output 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
      multibyte characters in arguments).

  LC_MESSAGES
      Determines the locale for the format and contents of diagnostic
      messages 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)

Index for Section 1

Alphabetical listing for L

Top of page