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

FreeBSD Manual Pages

  
 
  

home | help
lp(1)									 lp(1)

NAME
       lp, lpalt, cancel - print/alter/cancel requests on an LP	destination

SYNOPSIS
       [file ...]

       id

       [id ...]	[dest ...]

DESCRIPTION
       The command queues files	for printing.  The command changes information
       in a queued request.  The command deletes a queued request.

   lp Command
       The command arranges for	the  named  files,  file ...,  and  associated
       information  (collectively called a request) to be queued for output to
       a destination in	the LP	(line  printer)	 subsystem.   The  process  is
       called printing,	regardless of the actual output	device.

       associates a unique identifier with each	request	and writes it to stan-
       dard output, using the message:

       The request ID is which can be used later to alter, cancel, or find the
       status of the request (see and below, and lpstat(1)).

       For example, in the following message,

       the request ID is

   lp Options and Arguments
       recognizes  the following options and arguments.	 The keyletter options
       can be specified	in any order.  The file	... names must be last.

       file ...	      Print each named file.  If no file names are  specified,
		      standard input is	assumed.  The hyphen symbol also spec-
		      ifies standard input and can be intermixed on  the  com-
		      mand  line  with file names.  If more than one is	speci-
		      fied, all	but first are ignored.	Files are  printed  in
		      the  same	 order in which	they are specified.  A maximum
		      of 832 file names	can be specified.

       Copy the	named files to LP subsystem spooling directories.

		      Normally,	the files are linked into a  spool  directory.
		      The  ownership  and  mode	 of  the  linked  files	remain
		      unchanged.  If the option	is given, or  linking  is  not
		      possible (perhaps	because	the files do not reside	on the
		      same filesystem as that of the spooling directory),  the
		      files are	copied into the	spool directories.  The	owner-
		      ship and mode of the copies are set to  allow  read  and
		      write access to owner and	read access to group only.

		      If  the files are	linked rather than copied, any changes
		      made to the named	files after the	request	 is  made  but
		      before  it  is  printed will be reflected	in the printed
		      output.  Standard	input  is  always  copied  instead  of
		      linked.

       Select	      dest  as	the printer or class of	printers that is to do
		      the printing.  If	dest is	a printer, the request will be
		      printed  only  on	 that  specific	printer.  If dest is a
		      class, the request will be printed on the	 first	avail-
		      able  printer that is a member of	the class.  Under cer-
		      tain conditions (printer unavailability, file space lim-
		      itation,	etc.),	requests for a specific	dest might not
		      be accepted (see accept(1M) and lpadmin(1M)).

		      If the option is omitted,	dest is	taken from  the	 envi-
		      ronment  variable	 If  that  variable is unset or	empty,
		      dest is taken from  the  environment  variable  If  that
		      variable	is  unset or empty, the	default	queue is used.
		      If there is no default queue, or	default	 queue	exists
		      but is empty or has invalid destination entry, or	is set
		      but invalid, is set but invalid, issues an error message
		      and  the request is not queued.  Printer and class names
		      and the default queue are	defined	by your	 LP  subsystem
		      administrator (see lpadmin(1M) and lpstat(1)).

       Send a mail message (see
		      mail(1)) to the user after the request has been printed.
		      By default, no mail is sent upon	normal	completion  of
		      the print	request.

       Print	      number  copies  of  the  output.	 If  illegal number of
		      copies is	specified with this option, the	default	number
		      of copies	is 1.

       Specify a printer-dependent
		      option.	You  can  specify  several  printer options by
		      repeating	the option.  For information about the options
		      that  are	available for a	printer	supported on your sys-
		      tem, see the interface script for	the  printer  name  in
		      the directory.

       Set the priority	of the print request.
		      priority	must  be in the	range 0	(lowest	priority) to 7
		      (highest priority).  The priority	is used	by the	sched-
		      uler  to	select	the next spooled file for the targeted
		      printer or class of printers.  If	the priority  is  less
		      than  the	 fence,	 the  minimum  priority	 set  for  the
		      printer, the print request is deferred until  the	 fence
		      is lowered or the	priority is raised.  The default for a
		      printer queue is the default priority set	by the or com-
		      mand (see	lpadmin(1M) and	lpsched(1M)).  The default for
		      a	class queue is	the  highest  default  priority	 among
		      printers in the class.

       Suppress	standard output	messages from
		      such as "".  Error messages are still displayed on stan-
		      dard error.

       Print	      title on the banner page of  the	output.	  The  maximum
		      length  of  the  title  is  79  bytes.   title of	length
		      greater than 79 bytes is truncated to 79 bytes.

       Write a message to the user's  terminal	after  the  request  has  been
       printed.
		      If the user is not logged	in, or if the user has	denied
		      messages	to  his	terminal (see mesg(1)),	or (for	remote
		      printing)	if (see	rlpdaemon(1M)) is not running  on  the
		      user's local system, mail	will be	sent instead.

   lpalt Command
       The  command  alters a request made by a	previous command, if it	is not
       currently printing.  (To	requeue	a currently printing request, use  the
       command (see enable(1)) to stop the printer.)

   lpalt Options
       recognizes  the following options and arguments,	which can be specified
       in any order.  Blanks are not permitted between	a  keyletter  and  its
       argument.

       id	      Specifies	the request to be altered.  id is a request ID
		      returned by or

       Requeue the request to the named	printer	or class
		      dest.  A new unique request ID is	 written  to  standard
		      output.

       Alter only local	requests.

       Send mail upon normal completion	of the print request.

       Change the number of copies to
		      number.

       Specify a printer-dependent
		      option.	You  can  specify  several  printer options by
		      repeating	the option.  All  options  from	 previous  and
		      commands for this	request	ID are deleted.

       Change the request's priority to
		      priority.

       Suppress	standard output	messages from
		      such as "".  Error messages are still displayed on stan-
		      dard error.

       Change the     title on the banner page of the output.

       Write a message to the user's  terminal	after  the  request  has  been
       printed.
		      If the user is not logged	in or if the user  has	denied
		      messages	to  his	 terminal (see mesg(1))	or (for	remote
		      printing)	if (see	rlpdaemon(1M)).	 is not	running	on the
		      user's local system, mail	will be	sent instead.

   cancel Command
       The  command  cancels requests that were	made with the command, even if
       they are	currently printing.

       The cancellation	of a request that  is  currently  printing  frees  the
       printer to print	its next available request.

   cancel Options and Arguments
       recognizes  the following options and arguments,	which can be specified
       in any order.  Blanks are not permitted between	a  keyletter  and  its
       argument.   When	 cancel	 is  used  with	a mix of different options and
       arguments, it will operate first	on id ..., next	on dest	...,  next  on
       next  on	 and finally on	irrespective of	the order in which the options
       and arguments are specified in the command line.

       id ...	      Specifies	one or more requests to	be canceled.  id is  a
		      request ID returned by or

       dest ...	      Specifies	one or more printers or	printer	classes.  If a
		      or option	is not specified, cancel the request  that  is
		      currently	 printing  on  each  dest.  In this case, dest
		      must be a	printer, not a class.  If a or option is spec-
		      ified,  specify  the destination on which	to perform the
		      corresponding cancel operation.  In this case, dest  can
		      be a printer or a	class.

       Remove all requests the user owns on each
		      dest,  or	 if dest is not	specified and option is	speci-
		      fied, remove all requests	the user owns on all  destina-
		      tions  in	 the system.  The owner	of a request is	deter-
		      mined by the user's login	name and the host name of  the
		      machine where the	command	was invoked.

       Empty the spool queue of	each
		      dest,  or	 if dest is not	specified and option is	speci-
		      fied, empty the spool queue of all destinations  in  the
		      system.	Only users with	appropriate privileges can use
		      this option.

       Cancel only local requests.

       Remove all requests belonging to
		      user on each dest, or  if	 dest  is  not	specified  and
		      option  is  specified,  remove all requests belonging to
		      user on all destinations in the system.  You can	repeat
		      the  option  to  specify	more  users.   Only users with
		      appropriate privileges can use this option.

       Force cancel   to act on	all destinations in the	system.

   Printing Overview
       A printer can print requests from one or	two  destination  queues:  its
       own  private  queue and an optional class queue,	which can serve	one or
       more printers.  The destination queues are set  up  with	 the  command.
       The  command places a printing request into a printer or	class destina-
       tion queue as directed by a user.  The scheduler	directs	 the  requests
       from  the destination queues to the printers.  The and commands control
       whether can place requests in the destination queues.  The and commands
       control	whether	 can send a queued request to a	printer.  If a printer
       has two queues and one queue is rejecting  requests,  users  can	 still
       direct  requests	 to  the other destination queue and have the requests
       printed.	 reports the current status of the destination queues and  the
       scheduler.  See enable(1), lpstat(1), accept(1M), and lpadmin(1M).

EXTERNAL INFLUENCES
   Environment Variables
       determines  the	locale	to use for the locale categories when both and
       the corresponding environment variable (beginning with do not specify a
       locale.	 If is not set or is set to the	empty string, a	default	of "C"
       (see lang(5)) is	used.

       determines the locale to	use to override	any values  for	 locale	 cate-
       gories  specified by the	setting	of or any environment variables	begin-
       ning with

       determines the locale for interpretation	of sequences of	bytes of  text
       data  as	characters (e.g., single- verses multibyte characters in argu-
       ments and input files).

       determines the language in which	messages are displayed.

       determines the output device or destination.  If	the environment	 vari-
       able  is	 not  set, the environment variable is used.  The option takes
       precedence over

       determines the output device or destination.  If	 the  and  environment
       variables  are  not set,	the default queue is used.  The	option and the
       environment variable takes precedence over

       If any internationalization variable contains an	invalid	 setting,  the
       commands	 behave	 as  if	 all internationalization variables are	set to
       "C".  See environ(5).

   International Code Set Support
       Single- and multibyte character code sets are supported.

RETURN VALUE
       Exit values are:

	      Successful completion.
	      Error condition occurred.

EXAMPLES
       For a laserjet printer named configured with an interface  script  that
       defines	the option to cause the	printer	to print in a compressed mode,
       use the following command to print with compressed print	on

       can be used at the end of a pipeline to print the results of a previous
       command.	  It  is  commonly  used with the command (see pr(1)) to print
       formatted output.  For a	default	printer, to format file	into pages and
       print three copies of it:

WARNINGS
       A  remote print request can be canceled only from the system from which
       the the original	command	was issued, and	if the restrict	cancel feature
       (see  lpadmin(1M))  is  enabled	for  the  specified printer, a request
       belonging to this printer can be	canceled only by administrator or  the
       user who	requested it.

       A  remote  print	request	can be altered only from the system from which
       the the original	command	was issued, and	only by	administrator  or  the
       user who	requested it. The remote system	will ignore this alter request
       if the request is being printed.

       For a remote system, cannot change dest and priority.

       The information on destination queues and print requests	are maintained
       in  and files under directory.  These files should not be directly read
       by any application other	than the LP subsystem, because the  format  of
       data stored in these files may change in	future.

FILES
       Directory of spooler configuration data
       Directory of active LP device interface scripts
       Directory of model and font file	directories
       Directory of spooler log	files
       Directory of LP spooling	files and directories

SEE ALSO
       enable(1),   lpstat(1),	 mail(1),   slp(1),  accept(1M),  lpadmin(1M),
       lpana(1M),  lpsched(1M),	 rcancel(1M),  rlp(1M),	 rlpdaemon(1M),	  rlp-
       stat(1M).

STANDARDS CONFORMANCE
									 lp(1)

NAME | SYNOPSIS | DESCRIPTION | EXTERNAL INFLUENCES | RETURN VALUE | EXAMPLES | WARNINGS | FILES | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lp&sektion=1&manpath=HP-UX+11.22>

home | help