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
       assumes 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
       request-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
       executed, 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
	     regarding	the  naming  conventions  for atomic and FNS names and
	     standards(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
	     defined  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

		   Print  the  print  request  next.  If  more	than one print
		   request is assigned,	 the  most  recent  print  request  is
		   printed  next.  If a	print request is currently printing on
		   the desired 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
	     applies 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
	     option  ).	 Printer-dependent options may also be specified using
	     the -o keyletter once, followed by	a list of options enclosed  in
	     double 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
	     indicate  the  highest priority; 39 to indicate the lowest	prior-
	     ity. If no	priority is specified,	the  default  priority	for  a
	     print  service is assigned	by the LP administrator. The LP	admin-
	     istrator 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

       -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

       -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