unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 lpstat(1)							   lpstat(1)




 NAME
      lpstat - report line printer status information

 SYNOPSIS
      lpstat [-drst] [-a[list]] [-c[list]] [-o[list]] [-p[list]] [-u[list]]
      [-v[list]] [ID...]

 DESCRIPTION
      The lpstat utility writes to standard output information about the
      current status of the line printer system.

      If no arguments are given, lpstat writes the status of all requests
      made to lp by the user that are still in the output queue.

 OPTIONS
      The lpstat utility supports the XBD specification, Section 10.2,
      Utility Syntax Guidelines, except the option-arguments are optional
      and cannot be presented as separate arguments.

      Some of the options below can 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 quoted list of items separated from one another by a
      comma or one or more blank  characters, or combinations of both. See
      EXAMPLES.

      The omission of a list following such options causes all information
      relevant to the option to be written to standard output; for example:

	   lpstat -o

      writes the status of all output requests that are still in the output
      queue.

	   -a[list]    Write the acceptance status of destinations for
		       output requests.	 The list argument is a list of
		       intermixed printer names and class names.

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

	   -d	       Write the system default destination for output
		       requests.

	   -o[list]    Write the status of output requests. The list
		       argument is a list of intermixed printer names, class
		       names and request IDs.

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





 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 lpstat(1)							   lpstat(1)




	   -r	       Write the status of the line printer request
		       scheduler.

	   -s	       Write a status summary, including the status of the
		       line printer scheduler, the system default
		       destination, a list of class names and their members
		       and a list of printers and their associated devices.

	   -t	       Write all status information.

	   -u[list]    Write the status of output requests for users. The
		       list argument is a list of login names.

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

 OPERANDS
      The following operand is supported:

	   ID	       A request ID, as returned by lp.

 STDIN
      Not used.

 INPUT FILES
      None.

 ENVIRONMENT VARIABLES
      The following environment variables affect the execution of lpstat:

	   LANG			    Provide a default value for the
				    internationalisation variables that are
				    unset or null.  If LANG is unset or
				    null, the corresponding value from the
				    implementation-specific default locale
				    will be used. If any of the
				    internationalisation variables contains
				    an invalid setting, the utility will
				    behave as if none of the variables had
				    been defined.

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

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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 lpstat(1)							   lpstat(1)




	   LC_MESSAGES		    Determine the locale that should be used
				    to affect the format and contents of
				    diagnostic messages written to standard
				    error, and informative messages written
				    to standard output.

	   LC_TIME		    Determine the format of date and time
				    strings output when displaying line
				    printer status information with the -a,
				    -o, -p, -t, or -u options.

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

	   TZ			    Determine the timezone used with date
				    and time strings.

 ASYNCHRONOUS EVENTS
      Default.

 STDOUT
      The standard output is a text file containing the information
      described in OPTIONS, in an unspecified format.

 STDERR
      Used only for diagnostic messages.

 OUTPUT FILES
      None.

 EXTENDED DESCRIPTION
      None.

 EXIT STATUS
      The following exit values are returned:

	   0	Successful completion.

	   >0	An error occurred.

 CONSEQUENCES OF ERRORS
      Default.

 APPLICATION USAGE
      The lpstat utility cannot reliably determine the status of print
      requests in all conceivable circumstances.  When the printer is under
      the control of another operating system or resides on a remote system
      across a network, it need not be possible to determine the status of
      the print job after it has left the control of the local operating
      system.  Even on local printers, spooling hardware in the printer may



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 lpstat(1)							   lpstat(1)




      make it appear that the print job has been completed long before the
      final page is printed.

 EXAMPLES
      1.   Obtain the status of two printers, the pathnames of two printers,
	   a list of all class names and the status of the request named
	   HiPri-33:

		lpstat -plaser1,laser4 -v"laser2 laser3" -c HiPri-33

      2.   Obtain user print job status using the obsolescent mixed blank
	   and comma form:

		lpstat -u"ddg,gmv, maw"

 FUTURE DIRECTIONS
      A version of lpstat that fully supports the XBD specification, Section
      10.2, Utility Syntax Guidelines may be introduced in a future issue.

 SEE ALSO
      cancel(1), lp(1).

 CHANGE HISTORY
      First released in Issue 2.

    Issue 3
      The operation of this utility in an 8-bit transparent manner has been
      noted.

      The operation of this utility in an internationalised environment has
      been described.

    Issue 4
      Format reorganised.

      Exceptions to Utility Syntax Guidelines conformance noted.

      Internationalised environment variable support mandated.

 STANDARDS CONFORMANCE
      lpstat: SVID2, SVID3, XPG2, XPG3, XPG4













				    - 4 -	  Formatted:  August 2, 2006






 lpstat(1)							   lpstat(1)




				 HP-UX EXTENSIONS



 DESCRIPTION
      Any arguments that are not options are assumed to be request ids (as
      returned by lp).	lpstat prints the status of such requests.  options
      can appear in any order and can be repeated and intermixed with other
      arguments.

	   -i	       Inhibit the reporting of remote status.

	   -o[list]    Also see the -i option.

	   -t	       Print all status information.  Same as specifying -r,
		       -s, -a, -p, -o.	See the -i option.

    Security Restriction
      Only users who have the lp subsystem authorization or the printqueue
      secondary subsystem authorization can view the entire queue.
      Unauthorized users can view only their own jobs whose sensitivity
      levels are dominated by the user's current sensitivity level.

      The allowmacaccess privilege allows viewing jobs at higher sensitivity
      levels.

 EXAMPLES
      Check whether your job is queued:

	   lpstat

      Check the relative position of a queued job:

	   lpstat -t

      Verify that the job scheduler is running:

	   lpstat -r

 FILES
      /var/spool/lp/*
      /var/adm/lp/*
      /etc/lp/*
      /usr/lib/lp/*

 SEE ALSO
      enable(1), lp(1), rlpstat(1M).

 STANDARDS CONFORMANCE
      lpstat: SVID2, SVID3, XPG2, XPG3, XPG4




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000