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

FreeBSD Manual Pages


home | help
lp(1)				 User Commands				 lp(1)

       lp - submit print request

       lp  [-c]	 [-m]  [-p] [-s] [-w] [-d destination] [-f form-name] [-H spe-
       cial-handling]  [-n number]  [-o	option]	 [-P page-list]	 [-q priority-
       level]  [-S character-set  | print-wheel]  [-t title] [ -T content-type
       [-r]] [-y mode-list] [file...]

       lp -i request-ID... [-c]	[-m] [-p] [-s] [-w] [-d	destination] [-f form-
       name]   [-H special-handling]  [-n number]  [-o option]	[-P page-list]
       [-q priority-level]  [-S	character-set  |  print-wheel]	 [-t title]  [
       -T content-type [-r]] [-y mode-list]

       The  lp	utility	submits	print requests to a destination. There are two
       formats of the lp command.

       The first form of lp prints files  (file)  and  associated  information
       (collectively called a print request). If file is not specified,	lp as-
       sumes the standard input. Use a hyphen (-) with	file  to  specify  the
       standard	 input.	Files are printed in the order in which	they appear on
       the command line.

       The second form of lp changes print request options. This  form	of  lp
       can  only  be used on a Solaris 2.6 Operating Environment or compatible
       versions	of the LP print	server.	The print request  identified  by  re-
       quest-ID	 is  changed  according	to the printing	options	specified. The
       printing	options	available are the same as those	with the first form of
       the lp. If the request has finished printing when the lp	command	is ex-
       ecuted, the change is rejected. If the request is  in  the  process  of
       printing,  it  will be stopped and restarted from the beginning (unless
       the -P option has been given).

       The print client	commands  locate  destination  information  using  the
       "printers"  database  in	the name service switch. See nsswitch.conf(4),
       printers(4), and	printers.conf(4) for details.

       Printers	that have a 4.x	or BSD-based print server are  not  configured
       to  handle  BSD	protocol extensions. lp	handles	print requests sent to
       such destinations differently (see NOTES).

       The following options are supported:

       -c    Copies file before	printing.

	     Unless -c is specified, users should not remove any  file	before
	     the  print	 request  has completely printed. Changes made to file
	     after the print request is	made but before	it is printed will  be
	     reflected	in the printed output. file will be linked (as opposed
	     to	copied).

       -d destination
	     Prints file on a specific destination. The	-d option is  used  to
	     set the destination only when the job is first created. (Note: To
	     move existing jobs	to a different destination,  see  lpmove(1M).)
	     destination  can  be either a printer or a	class of printers (see
	     lpadmin(1M)).  Specify  destination  using	 atomic,   POSIX-style
	     (server:destination), or Federated	Naming Service (FNS) (.../ser-
	     vice/printer/...) names. See printers.conf(4) for information re-
	     garding the naming	conventions for	atomic and FNS names and stan-
	     dards(5) for information regarding	POSIX.

       -f form-name
	     Prints file on form-name. The LP print service ensures  that  the
	     form  is mounted on the printer. The print	request	is rejected if
	     the  printer does not support form-name, if form-name is not  de-
	     fined  for	the system, or if the user is not allowed to use form-
	     name (see lpforms(1M)).

       -H special-handling
	     Prints the	print request according	to the value  of  special-han-
	     dling. The	following special-handling values are acceptable:

	     hold  Do  not print the print request until notified. If printing
		   has already begun, stop it. Other print  requests  will  go
		   ahead  of  a	 request that has been put on hold (held print
		   request) until the print request is resumed.

		   Resume a held print request.	If the print request had begun
		   to  print  when  held,  it  will  be	the next print request
		   printed, unless it is superseded by an immediate print  re-

		   Print  the  print  request next. If more than one print re-
		   quest is assigned, the most recent print request is printed
		   next.  If  a	print request is currently printing on the de-
		   sired printer, a hold request must be issued	to  allow  the
		   immediate  request  to print. The immediate request is only
		   available to	LP administrators.

       -i request-ID
	     Changes options for the print request identified  by  request-ID.
	     There  must be a space between -i and request-ID. This option ap-
	     plies only	to jobs	that are in a local queue on a print server.

       -m    Sends mail	after file has printed (see mail(1)). By  default,  no
	     mail is sent upon normal completion of a print request.

       -n number
	     Prints  a	specific number	of copies of file. Specify number as a
	     digit. The	default	for number is 1.

       -o option
	     Specifies printer-dependent options. Specify several  options  by
	     specifying	 -o  option multiple times (-o option -o option	-o op-
	     tion ). Printer-dependent options may also	be specified using the
	     -o	keyletter once,	followed by a list of options enclosed in dou-
	     ble quotes	(-o " option option option").  The  following  options
	     are valid:

		   Does	 not print a banner page with the request. This	option
		   can be disallowed by	the LP administrator.

		   Prints multiple files without inserting a form feed between

	     length=numberi | numberc |	number
		   Prints the print request with pages of a specific length in
		   inches, centimeters,	or number of lines. Append the	letter
		   i  for inches or c for centimenters to number. Indicate the
		   number of lines by specifying number	alone. length=66 indi-
		   cates  a  page  length  of 66 lines.	length=11i indicates a
		   page	length of 11 inches. length=27.94c  indicates  a  page
		   length of 27.94 centimeters.

		   This	option may not be used with the	-f option.

	     width=numberi | numberc | number
		   Prints  the print request with pages	of a specific width in
		   inches, centimeters,	or number of columns. Append the  let-
		   ter	i  for inches or c for centimeters to number. Indicate
		   the number of columns by specifying number alone.  width=65
		   indicates  a	page width of 65 columns. width=6.5i indicates
		   a page width	of 6.5	inches.	 width=10c  indicates  a  page
		   width of 10 centimeters.

		   This	option may not be used with the	-f option.

		   Prints  the print request with the line pitch set to	number
		   lines in an inch. Use number	to specify the number of lines
		   in an inch.

		   This	option may not be used with the	-f option.

		   Prints  the	print  request with the	character pitch	set to
		   number characters in	an inch. Use  number  to  specify  the
		   number  of characters in an inch. Use pica to set character
		   pitch to pica (10 characters	per inch),  or	elite  to  set
		   character  pitch to elite (12 characters per	inch) Use com-
		   pressed to set character pitch to as	many characters	as the
		   printer  can	handle.	There is no standard number of charac-
		   ters	per inch for all printers; see the  terminfo  database
		   (see	 terminfo(4)) for the default character	pitch for your
		   printer. This option	may not	be used	with the -f option.

		   Prints the request using a list of options  valid  for  the
		   stty	 command  (see	stty(1).  Enclose  the	list in	single
		   quotes (`') if it contains blanks.

       -P page-list
	     Prints the	pages specified	in page-list in	ascending order. Spec-
	     ify  page-list as a of range of numbers, single page number, or a
	     combination of both.

	     The -P option can only be used if there is	a filter available  to
	     handle it;	otherwise, the print request will be rejected.

       -p    Enables notification on completion	of the print request. Delivery
	     of	the notification is dependent on additional software.

       -q priority-level
	     Assigns the print request a priority in the print queue.  Specify
	     priority-level  as	an integer between from	0 and 39. Use 0	to in-
	     dicate the	highest	priority; 39 to	indicate the lowest  priority.
	     If	 no  priority  is  specified, the default priority for a print
	     service is	assigned by the	LP administrator. The LP administrator
	     may also assign a default priority	to individual users.

       -s    Suppresses	the display of messages	sent from lp.

       -S character-set	|

       -S print-wheel
	     Prints  the  request using	the character-set or print-wheel. If a
	     form was requested	and requires a character set  or  print	 wheel
	     other  than  the one specified with the -S	option,	the request is
	     rejected. Printers	using mountable	 print	wheels	or  font  car-
	     tridges use the print wheel or font cartridge mounted at the time
	     of	the print request, unless the -S option	is specified.

	     Printers Using Print Wheels: If print wheel is not	one listed  by
	     the LP administrator as acceptable	for the	printer	the request is
	     rejected unless  the  print  wheel	 is  already  mounted  on  the

	     Printers  Using Selectable	or Programmable	Character Sets:	If the
	     -S	option is not specified, lp uses the standard  character  set.
	     If	 character-set is not defined in the terminfo database for the
	     printer (see terminfo(4)),	or is not an alias defined by  the  LP
	     administrator, the	request	is rejected.

       -t title
	     Prints a title on the banner page of the output. Enclose title in
	     quotes if it contains blanks. If title is not not specified,  the
	     name of the file is printed on the	banner page.

       -T content-type [-r]
	     Prints  the  request  on a	printer	that can support the specified
	     content-type. If no printer accepts this type directly, a	filter
	     will  be  used to convert the content into	an acceptable type. If
	     the -r option is specified, a filter will not be used. If	-r  is
	     specified,	 and no	printer	accepts	the content-type directly, the
	     request is	rejected. If the content-type is not acceptable	to any
	     printer,  either  directly	 or  with a filter, the	request	is re-

       -w    Writes a message on the user's terminal after the files have been
	     printed. If the user is not logged	in, then mail will be sent in-

       -y mode-list
	     Prints the	request	according to  the  printing  modes  listed  in
	     mode-list.	The allowed values for mode-list are locally defined.

	     This  option  may	be used	only if	there is a filter available to
	     handle it;	otherwise, the print request will be rejected.

       The following operand is	supported:

       file  The name of the file to be	printed. Specify file as a pathname or
	     as	 a  hyphen  (-)	to indicate the	standard input.	If file	is not
	     specified,	lp uses	the standard input.

       See largefile(5)	for the	description of the behavior of lp when encoun-
       tering files greater than or equal to 2 Gbyte ( 2**31 bytes).

       The following exit values are returned:

       0     Successful	completion.

	     An	error occurred.

	     LP	print queue.

	     User-configurable printer database.

	     System printer configuration database.

	     NIS version of /etc/printers.conf.

	     NIS+ version of /etc/printers.conf.

	     FNS version of /etc/printers.conf.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWpcu			   |
       |CSI			     |Enabled (see NOTES)	   |

       cancel(1),  enable(1),  lpq(1B),	lpr(1B), lprm(1B), lpstat(1), mail(1),
       postprint(1), pr(1), stty(1),  accept(1M),  lpadmin(1M),	 lpfilter(1M),
       lpforms(1M),   lpmove(1M),   lpsched(1M),   lpshut(1M),	 lpsystem(1M),
       lpusers(1M),  nsswitch.conf(4),	printers(4),  printers.conf(4),	  ter-
       minfo(4), attributes(5),	 environ(5), largefile(5), standards(5)

       CSI-capability assumes that printer names are composed of ASCII charac-

       Print jobs are assumed to contain one type of data. That	type  of  data
       is  either specified on the command line	or autodetected	(simple, Post-
       Script) based on	the contents of	the first file in the job.

       Printers	that have a 4.x	or BSD-based print server. are not  configured
       to  handle  BSD	protocol extensions. lp	handles	print requests sent to
       such printers in	the following ways:

       1. Print	requests with more than	52 filenames will be truncated	to  52
	  files. lp displays a warning message.

       2. The  -f,  -H,	 -o,  -P, -p, -q, -S, -T, and -y options may require a
	  protocol extension to	pass to	a print	server.	If  lp	cannot	handle
	  the print request, it	displays a warning message.

	  LP  administrators enable protocol extensions	by setting a printer's
	  bsdaddr entry	in /etc/printers.conf. Changing	the bsdaddr  entry  in
	  /etc/printers.conf to:


	  generates  a	set  of	BSD print protocol extensions that can be pro-
	  cessed by a Solaris print server. lp supports	only Solaris  protocol
	  extensions at	this time.

SunOS 5.9			  1 Dec	2000				 lp(1)


Want to link to this manual page? Use this URL:

home | help