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

FreeBSD Manual Pages


home | help
lpr(1B)		   SunOS/BSD Compatibility Package Commands	       lpr(1B)

       lpr - submit print requests

       /usr/ucb/lpr    [-P destination]	   [-# number]	 [-C class]   [-J job]
       [-T title] [ -i [indent]] [-1 | -2 | -3 | -4 font]  [-w cols] [-m] [-h]
       [-s] [-filter_option] [file...]

       The  lpr	 utility  submits  print requests to a destination. lpr	prints
       files (file) and	associated information,	collectively  called  a	 print
       request.	 If  file is not specified, lpr	assumes	the standard input.

       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.

       Print  requests with more  than 52 files	specified will be truncated to
       52 files. lpr displays a	warning	message.

       The following options are supported:

       - P destination
	     Prints file on a specific printer or class	of printers(see	 lpad-
	     min(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.

       -# number
	     Prints a specific number of copies. Specify  number as a positive
	     integer. The default for  number is  1.

       -C class
	     Prints class as the  job classification
	      on the banner page of the	 output.   Enclose   class  in	double
	     quotes  if	 it  contains  blanks. If  class is not	specified, the
	     name of the system	(as returned by	 hostname) is printed  as  the
	     job classification. See hostname(1).

       -J job
	     Prints  job  as  the   job	name on	the banner page	of the output.
	     Enclose  job in double quotes if it contains blanks.  If  job  is
	     not specified,  file (or in the case of multiple files, the first
	     file specified on the command line) is printed as the job name on
	     the banner	page of	the output.

       -T title
	     Prints a title on the page	header of the output. Enclose title in
	     double quotes if it contains blanks. The  -T  option  is  ignored
	     unless it is specified with the -p	filter option.

       -i indent
	     Indents  the  output  a  specific number of SPACE characters. Use
	     indent to indicate	the number of SPACE characters to be indented.
	     Specify   indent  as a positive integer. If the optional argument
	     to	indent is not specified, then eight SPACE  characters  is  the
	     default. The -i option is ignored unless it is specified with the
	     -p	filter option.

       -1|-2|- 3|-4 font
	     Mounts the	specified font in the font position 1,	2,  3,	or  4.
	     Specify font as a valid font name.

       -w cols
	     Prints  file  with	 pages of a specific width. cols indicates the
	     number of columns wide.  The -w option is ignored	unless	it  is
	     specified with the	-p filter option.

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

       -h    Suppresses	printing of the	banner page of the output.

       -s    Uses full pathnames (as  opposed  to  symbolic  links)   to  file
	     rather  than  trying  to copy them. This means file should	not be
	     modified or removed until it has completed	printing.   Option  -s
	     only  prevents copies of local files from being made on the local
	     machine. Option -s	only works with	specified files.  If  the  lpr
	     command is	at the end of a	pipeline, file is copied to the	spool.

       - filter_option
	     Notifies the print	spooler	that file is not a standard text file.
	     Enables  the  spooling  daemon  to	use the	appropriate filters to
	     print file.

	     filter_options offer  a  standard	user  interface.   All	filter
	     options may not be	available for, or applicable to, all printers.

	     Specify filter_option as a	single character.

	     If	filter_option is not specified and the printer	can  interpret
	     PostScript(R), inserting `%!' as the first	two characters of file
	     causes file to be interpreted as PostScript.

	     The following filter options are supported:

p     Use pr to	format the files. See pr(1).

l     Print control characters and suppress page breaks.

t     file contains troff (cat phototypesetter)	binary data.

n     file contains  ditroff data from device independent troff.

d     file contains  tex data in DVI format from Stanford.

g     file contains standard plot data produced	by plot(1B) routines.

v     file contains a raster image. printer must support an appropriate	 imag-
      ing model	such as	PostScript in order to print the image.

c     file contains data produced by cifplot.

f     Interprets  the  first character of each line as a standard FORTRAN car-
      riage control character.

       The following operand is	supported:

	file The name of the file to be	printed.  Specify file as a  pathname.
	     If	file is	not specified,	lpr uses the standard input.

       See  largefile(5)  for  the  description	 of  the  behavior of lpr when
       encountering files greater than or equal	to 2 Gbyte ( 2**31bytes).

       The following exit values are returned:

	0    Successful	completion.

	     An	error occurred.

	     File containing the sequence numbers for job ID assignment.

	     Spooling directories and files.

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

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

       hostname(1), lp(1), lpc(1B),  lpq(1B),  lprm(1B),  lpstat(1),  mail(1),
       plot(1B),  pr(1), troff(1), lpadmin(1M),	nsswitch.conf(4), printers(4),
       printers.conf(4), attributes(5),	largefile(5), standards(5)

       lpr:  destination |: unknown destination
	     destination was not found in the LP configuration database.  Usu-
	     ally this is a typing mistake; however, it	 may indicate that the
	     destination does not exist	on the system. Use  lpstat -p to  dis-
	     play information about the	status of the print service.

       lpr is CSI-enabled except for the printer name.

       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.

SunOS 5.9			  20 Dec 1999			       lpr(1B)


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

home | help