lpr(1)								       lpr(1)



NAME

<h2>   lpr -	Sends files to spooling	daemon for printing </h2>

SYNOPSIS

<h2>   lpr [flags] filename </h2>

FLAGS

<h2>   The lpr flags	-c, -d,	-f, -g,	-l, -n,	-p, -t,	and -v are used	to notify the </h2>
  line printer spooler that the	files are not standard text files; therefore
  these	flags are mutually exclusive.  The spooling daemon uses	the appropri-
  ate filters to print the data	if you specify one of these flags.

<h2>   [Digital] In an international	environment, the lpr command needs locale </h2>
<h2>   information to use the appropriate filter to print a text file. The -A flag </h2>
  allows you to	specify, among other things, locales for text files and
  printers.

<h2>   The lpr command supports the following flags: </h2>

<h2>   -A "option_list" </h2>
      [Digital]	 Specifies one or more country-specific	options, separated by
      spaces.  For a list of valid options, refer to the Country-Specific
      Options section.

<h2>   -c  Assumes that the files contain data produced by the cifplot filter. </h2>

<h2>   -C class </h2>
      Specifies	a print	class as the request classification on the burst
      page.

<h2>   -d  Assumes that files contain data from tex (DVI format from	Stanford </h2>
      University).

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

<h2>   -g  Assumes that files contain standard plot data as produced	by plot	rou- </h2>
      tines.

<h2>   -h  Suppresses the printing of the burst page. </h2>

<h2>   -i [number] </h2>
<h2>       Indents the output number	spaces.	 If number is not given, the indenta- </h2>
      tion is 8	spaces.

<h2>   -Itray </h2>
      Selects the input	paper tray that	supplies paper for the print job.
      The tray name is printer dependent.  The following list shows the	valid
<h2>       tray variable values for the printers that support the -I	flag: </h2>

      ln05 and ln05r printers:
<h2>        cassette, upper,	or manual </h2>

      ln06 and ln06r printers:
<h2>        upper, envelope_feeder, lower, or manual </h2>

      ln07 and ln07r printers:
<h2>        upper, manual, lower, or	cassette </h2>

      ln08 and ln08r printers:
<h2>        envelope_feeder,	mmf, manual, upper, lower, or lcit </h2>

      ln14 printer:
<h2>        front, manual, upper, or	lower </h2>

      ln10ja (Japanese-specific) printers:
<h2>        upper, lower, or	manual </h2>

      dl1152 printers (supported only for Asian	language printing):
<h2>        front, manual, or cassette </h2>

      dl5100 printers:
<h2>        envelope_feeder,	front, manual, internal, or upper </h2>

      For more information on the input	options, refer to the documentation
      for your printer.

      If you have one of the previously	listed printers	connected locally,
<h2>       there are	two additional forms of	the -I flag.  You can specify the </h2>
<h2>       flag in the form -Itray_name, where the tray_name	variable specifies </h2>
      the name of a tray that is supported by the particular printer (for
<h2>       example, -Ilettertray).  You also	can specify the	flag in	the form -In, </h2>
<h2>       where the	n variable specifies an	integer	value.	Refer to your printer </h2>
      documentation for	information on specifying valid	tray selections.

<h2>   -j  Causes the request ID of the printer request to be displayed on stan- </h2>
      dard output after	it is entered in the print spooling queue.

<h2>   -J name </h2>
      Specifies	the request name to appear on the burst	page.  Normally, the
<h2>       lpr command uses the name	of the first file. </h2>

<h2>   -Ksides </h2>
<h2>       Prints the job in	a way specified	by the sides variable.	You can </h2>
<h2>       specify sides as follows: </h2>

<h2>       1	or one_sided or	one_sided_simplex </h2>
		Prints only on one side	of the sheet.

<h2>       2	or two_sided or	two_sided_duplex </h2>
		Prints on both sides of	the sheet; the second side is reached
		by flipping the	sheet about its	left edge, as in the binding
		of a book.

<h2>       tumble or	two_sided_tumble </h2>
		Prints on both sides of	the sheet, but prints the opposite
		way up on each side, so	the second side	can be read by flip-
		ping the sheet along its top axis.

<h2>       one_sided_duplex </h2>
		Prints only on one side	of the sheet, but retains the page
<h2> 		layout intended	for two_sided_duplex printing.	The layout </h2>
		refers to such things as where the margins are and where the
		page numbers are.

<h2>       one_sided_tumble </h2>
		Prints only on one side	of the paper, but retains the page
		layout intended	for tumble printing.

<h2>       two_sided_simplex </h2>
		Prints on two sides of the paper, but retains the page layout
<h2> 		intended for one_sided_simplex printing. </h2>

<h2>   -l  Prints control characters	and suppresses page breaks. </h2>

<h2>   -m  Sends mail (see the mailx(1) reference page) when	spooling is com- </h2>
      pleted.

<h2>   -n  Assumes that files contain data output by	the ditroff (device- </h2>
<h2>       independent troff) command. </h2>

<h2>   -Nnumber </h2>
      Prints one or more pages on one sheet of paper.  The printer automati-
      cally adjusts to handle the number of pages printed on one sheet of
      paper.  The maximum that may be specified	is 100 pages.

<h2>   -on Selects the output tray where the	printed	job will be deposited.	The n </h2>
      variable specifies an integer value that depends on the printer.	Refer
      to your printer documentation to determine the correct values.

<h2>   -Oorientation </h2>
<h2>       Prints the page in the way specified by the orientation variable,	which </h2>
      can be the following:

<h2>       portrait	The printed output is parallel to the short side of the	page. </h2>

<h2>       landscape	The printed output is parallel to the long side	of the page. </h2>

<h2>   -p  Formats the files	using pr as a filter. </h2>

<h2>   -Pprinter </h2>
<h2>       Specifies	printer	as the output device (print job	destination).  If you </h2>
<h2>       do not specify the -P flag, the default printer or the value of the </h2>
<h2>       PRINTER environment variable is used. </h2>

<h2>   -r  Removes the file when spooling or	printing is completed. </h2>

<h2>   -s  Uses symbolic links to print.  Usually, files are	copied to the spool- </h2>
<h2>       ing directory, but the -s	flag uses symlink() to link data files, </h2>
      rather than trying to copy them.	This allows you	to print large files.
<h2>       If you specify the -s flag, files	should not be modified or removed </h2>
<h2>       until they have been printed. Note that the -s flag disables codeset </h2>
      conversion that may be necessary when printer and	file locales differ,
<h2>       even when	you explicitly specify different plocale and flocale values </h2>
<h2>       with the -A flag. </h2>

<h2>   -t  Assumes that files contain data output by	the troff (cat photo- </h2>
      typesetter) command.

<h2>   -T title </h2>
<h2>       Specifies	the title to be	used by	the pr command instead of the </h2>
<h2>       filename.	 The -p	flag also must be specified. </h2>

<h2>   -v  Assumes that the files contain a raster image for	devices	like the Ben- </h2>
      son Varian.

<h2>   -wnumber </h2>
<h2>       Defines the page width for the pr	command. </h2>

<h2>   -x  Assumes the files	do not require filtering before	printing. </h2>

<h2>   -#number </h2>
<h2>       Produces number copies of	the output. </h2>

<h2>   -1 font, -2 font, -3 font, -4	font </h2>
      Mounts the specified font	on font	position 1, 2, 3, or 4,	respectively.


DESCRIPTION

<h2>   The lpr command uses the lpd spooling	daemon to print	files. </h2>

<h2>   If you specify a hyphen (-) for a file name, the lpr command reads from </h2>
  standard input; this can be used in conjunction with specified file names.

<h2>   If you do not	specify	a particular printer with the -P flag, the default </h2>
<h2>   printer or the value of the PRINTER environment variable is used. </h2>

<h2>   To check the status of a printer, use	either the lpq or lpstat command.  To </h2>
<h2>   cancel printer requests, use the lprm	or cancel command. </h2>

  Country-Specific Options


<h2>   [Digital]  The -A flag allows	you to specify options that are	required to </h2>
  print	files in various native	languages and also supports some country-
  specific printers.  Each option includes a keyword, most of which require a
<h2>   value	assignment.  See i18n_printing(5) for a	general	description of </h2>
  country-specific support and to determine which options may be required for
  particular languages and printers.

<h2> 				     Note </h2>

<h2>        You may need to use the wwlpspr command in place	of the lpspr and </h2>
<h2>        lpr commands when sending Asian language	files to a PrintServer </h2>
<h2>        printer.	 See wwlpspr(1)	if you are sending files to a </h2>
       PrintServer printer.


<h2>   The -A flag options are supported by software	installed by optional world- </h2>
  wide support subsets.	In other words,	a country-specific option will not
  work unless an associated country-specific software subset is	installed.

<h2>   For the lpr command, the following options can be included through the -A </h2>
  flag:

<h2>   flocale=locale_name </h2>
      Specifies	the locale for the source text file.  Print filters use	this
<h2>       locale to	validate the characters	in the text.  If the flocale option </h2>
<h2>       is not set, the text is interpreted in the current locale.  The flocale </h2>
      setting is particularly important	for correct interpretation of charac-
<h2>       ters in multibyte	codesets.  Moreover, if	the plocale option is also </h2>
<h2>       set, the lpr command automatically converts characters from the text </h2>
      file codeset to the printer codeset before printing the file.  For
      example, the following command converts a	file created in	a Traditional
      Chinese locale from the Big 5 codeset to the DEC Hanyu codeset before
      printing it:


<h2> 	   % lpr -A "flocale=zh_TW.big5	plocale=zh_TW.dechanyu"	big5.txt </h2>

<h2>   plocale=locale_name </h2>

      Specifies	the locale for the printer.  Some printers, like the LA380-
      CB, are country-specific and have	builtin	fonts encoded in a particular
      codeset.	For example, the builtin fonts for the LA380-CB	printer	are
<h2>       encoded in DEC Hanzi.  For these printers, the codeset part of the plo- </h2>
<h2>       cale value should	match the codeset (dechanzi) of	the printer's builtin </h2>
      fonts.  Other printers are generic and suitable for use with files in a
      variety of languages.  For example, the DEClaser 5100, when used with
<h2>       the dl5100wrof print filter, can handle fonts for	different codesets. </h2>
<h2>       For these	printers, the plocale value should match the font used in the </h2>
      text file.  The following	example	prints a file encoded in DEC Hanyu by
      using the	Sung-Light-CNS11643 font, which	supports DEC Hanyu
      characters:


<h2> 	   % lpr -A"font=Sung-Light-CNS11643 plocale=zh_TW.dechanyu" \ </h2>
<h2> 	   dechanyu.txt </h2>

<h2>       When the plocale value is	inappropriate for the font codeset, printed </h2>
      output is	useless.

      To determine printer locale for country-specific printers, refer to
<h2>       i18n_printing(5).	 To find out which fonts are available for a particu- </h2>
      lar locale, refer	to the reference page for the corresponding codeset.
<h2>       For example, if locale_name is zh_TW.dechanyu, see dechanyu(5) for a </h2>
      list of appropriate fonts.

<h2>   font=font_name </h2>
      Specifies	the outline font name for printing source text files on	a
      PostScript printer. For more information,	refer to the entry for the
<h2>       plocale option. </h2>

<h2>   length=number_of_lines </h2>
<h2>       Specifies	the number of lines per	page.  When used with the -w flag, </h2>
<h2>       the length option	can control the	font size and orientation of the </h2>
      printed output.

<h2>   odldb=odl_database_path </h2>
      Specifies	the path of the	software on-demand loading (SoftODL) database
<h2>       files.  The odldb	option overrides the default path, which specifies </h2>
<h2>       the systemwide SoftODL database.	Therefore, users can set odldb to </h2>
      specify private SoftODL databases.  For example, the following command
<h2>       directs lpr to use the SoftODL database in /usr/tmp: </h2>


<h2> 	   % lpr -A "odldb=/usr/tmp/odl" </h2>

<h2>       Refer to odl(5) for more information on SoftODL. </h2>

<h2>   odlstyle=style-NxN </h2>
<h2>       Specifies	what SoftODL font style	and size to use, for example normal- </h2>
<h2>       24x24.  If the odlstyle is not specified,	the system default SoftODL </h2>
<h2>       style and	size is	used.  Refer to	odl(5) for more	information on Sof- </h2>
      tODL.

<h2>   spcom </h2>
      Enables space-compensation mode for languages, such as Thai, that	con-
      tain nonspacing characters.  Nonspacing characters can combine with
      other characters for display and therefore do not	occupy space.  Many
      of the existing tools for	text alignment do not handle nonspacing	char-
      acters properly.	If you want to print Thai output from such utilities,
      you should enable	space compensation mode	to ensure proper text align-
      ment in the printed file.

      Space compensation is be done line by line.  The print filter keeps
      count of the number of nonspacing	characters found in a line.  When two
      or more consecutive spaces are encountered, the print filter inserts
      the appropriate number of	spaces,	therefore compensating for spaces
      added by the nonspacing characters.

      Space-compensation mode is valid only for	printing Thai characters.

<h2>   tm  Enables text morphing for	Thai printing.	Text morphing replaces some </h2>
      characters with others to	produce	better output in desktop publishing
<h2>       environments.  Refer to Thai(5) for more details on text morphing. </h2>
      Text morphing rules are proprietary.  Therefore, text morphing is	sup-
      ported only by Digital Thai outline fonts	and are	available only for
      PostScript printing.

<h2>   onehalf </h2>
      Specifies	that Thai characters be	printed	on one and a half lines,
      rather than on three lines, to produce more compressed and natural
<h2>       looking output.  The onehalf option works	only with the thailpof print </h2>
<h2>       filter.  Refer to	i18n_printing(5) for general information on text </h2>
      morphing.

<h2>   tacdata=tac_data_path </h2>
<h2>       Specifies	where the character code tables	for the	printer	(thailpof </h2>
      filter only) can be found.  These	tables are selected for	use with the
<h2>       yp value in the /etc/printcap file.  The default path is </h2>
<h2>       /usr/lbin/tac_data. </h2>

NOTES

<h2>    1.  DIGITAL UNIX software does not include ditroff or troff.	Therefore, </h2>
<h2>        files suitable for use with the -n or -t	flags may not be available on </h2>
       your system.

<h2>    2.  If you try to print too large a file, the file is truncated.  The lpr </h2>
       command does not	print binary files.  If	a user other than the root
<h2>        user prints a file and spooling is disabled, lpr	will print a message </h2>
<h2>        and will	not put	requests in the	queue.	If a connection	to lpd on the </h2>
<h2>        local machine cannot be made, lpr will indicate that the	daemon cannot </h2>
       be started.

<h2>    3.  Fonts for troff and text	reside on the host with	the printer. </h2>
       Currently, it is	not possible to	use local font libraries.  DIGITAL
<h2>        UNIX does not supply troff, so local font libraries for troff may not </h2>
       exist on	your system.

EXAMPLES

<h2>   The following	example	prints three copies of the new.index.c, </h2>
<h2>   print.index.c, and more.c files: </h2>

<h2>        % lpr -#3 new.index.c print.index.c more.c </h2>


<h2>   The following	example	prints three copies of the concatenated	new.index.c, </h2>
<h2>   print.index.c, and more.c files: </h2>

<h2>        # cat new.index.c print.index.c more.c |	lpr -#3 </h2>

<h2>   The following	example	prints Operations on the burst page instead of the </h2>
<h2>   node name before printing the	new.index.c file: </h2>

<h2>        # lpr -C	Operations new.index.c </h2>

FILES

<h2>   /etc/passwd </h2>
	    User information

<h2>   /etc/printcap </h2>
	    Printer description	file

<h2>   /usr/lbin/lpd </h2>
	    Line printer daemon

<h2>   /var/spool/* </h2>
	    Spool directories

<h2>   /var/spool/*/cf* </h2>
	    Daemon control files

<h2>   /var/spool/*/df* </h2>
<h2> 	    Data files specified in cf files </h2>

<h2>   /var/spool/*/tf* </h2>
<h2> 	    Temporary copies of	cf files </h2>

<h2>   /usr/lbin/tac/tac_data/* </h2>
	    Character encoding tables for Thai

RELATED	INFORMATION

<h2>   Commands: cancel(1), checknr(1), lp(1), lpc(8), lpd(8), lpq(1), lprm(1), </h2>
<h2>        lpstat(1), mailx(1), neqn(1), nroff(1), pr(1), tbl(1), wwlpspr(1) </h2>

<h2>   Functions: symlink(2) </h2>

<h2>   Others: dechanyu(5), i18n_intro(5), i18n_printing(5),	l10n_intro(5), </h2>
<h2>        odl(5), Thai(5) </h2>