Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

lp(1)									lp(1)


  lp, cancel - Sends or	cancels	a printing request


  lp [-cmsw] [-A options] [-o option] [-d printer] [-n copies] [-t title]

  cancel [request_ID...] printer...

  cancel request_ID... [printer...]


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

  lp: XCU5.0

  cancel:  XCU5.0

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


  Options for the lp command can appear	in any order and can be	mixed with

  The cancel command has no options.

  -A options
      [Tru64 UNIX]  Specifies one or more country-specific options.  See
      lpr(1) for details about these options.

  -c  Makes copies of the files	to be printed immediately when lp is invoked.
      Normally,	files are not copied, but are linked whenever possible.	 If
      the -c option is not given, be careful not to remove any of the files
      before the request is finished printing.	Note also that in the absence
      of the -c	option any changes made	to the named files after the request
      is made, but before it is	printed, are reflected in the printed output.

  -d printer
      Selects printer as the device to do the printing (also known as the
      printing destination).  Under certain conditions (printer	unavailabil-
      ity, file	space limitations, and so on), requests	for specific destina-
      tions cannot be accepted.	 By default, printer is	taken from the LPDEST
      environment variable if it is set.  Otherwise, the PRINTER environment
      variable or a default destination, if one	exists,	for the	system is
      used.  Destination names vary between systems.  (See the lpq(1) and
      lpstat(1)	reference pages.)

  -m  Sends mail (see the mailx(1) reference page) after the files are
      printed.	By default, no mail is sent upon normal	completion of the
      print request.

  -n number
      Prints number copies (default of 1).

  -o option
      This option is recognized	as valid option	by the command-line parser,
      but is not supported on a	Tru64 UNIX system.  On other systems, multi-
      ple -o options can be used to specify printer-dependent or class-
      dependent	options.

  -s  Suppresses messages from lp, such	as "request id is ...".

  -t title
      Prints title on the banner page of the output.

  -w  Functions	like -m	(for compatibility reasons).


      Specifies	one or more files to be	printed.

      Cancel the request with the request ID.

      Cancel all requests made by you with that	printer	as the destination.


  The lp command sends the specified files and associated information (col-
  lectively called a request) to a line	printer	for printing.  The cancel
  command cancels printing requests.

  The lp command associates a unique ID	with each request and prints it	on
  the standard output.	If you do not specify a	file, or specify a - (dash)
  in place of a	file, lp accepts standard input	at this	point in the list of

  The cancel command cancels printer requests made by the lp or	lpr command
  (see lpr(1)).	 You can specify either	request_ID, to cancel the request
  with that request ID,	or printer, to cancel all requests made	by you with
  that printer as the destination.  (If	you are	operating with superuser
  authority, all requests to that printer are canceled,	including those	of
  other	users.)	A specified request is canceled	even if	it is currently
  printing, and	the printer is freed to	print the next available request. The
  cancel command is marked LEGACY in XCU Issue 5.

  You can also use the request ID to find the status of	the request. (See the
  lpq(1) and lpstat(1) reference pages.)


  The following	exit values are	returned by both the cancel and	lp commands:

  0   Successful completion.

  >>0  An error occurred.


  The following	environment variables affect the execution of lp and cancel:

      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.

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

      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).

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

      Determines the format of date and	time strings displayed in the banner.

      Determines the output device destination if the -d option	is not used
      with the lp command.

      Determines the location of message catalogues for	the processing of

      Determines the output device destination if the -d option	is not used
      with lp command and the LPDEST environment variable is not set.


      Printer description file

      Spool directories

      Daemon control files

      Data files specified in cf files

      Temporary	copies of cf files

      Minimum free space to leave

      Line printer devices

      Socket for local requests


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

  Others:  i18n_printing(5)

  Standards:  standards(5)