[0m


LPR(1)		    UNIX Programmer's Manual		   LPR(1)



[1mNAME
     [0mlpr - off line print

[1mSYNOPSIS
     lpr [0m[ [1m-P[0m_p_r_i_n_t_e_r ] [ [1m-#[0m_n_u_m ] [ [1m-C [0m_c_l_a_s_s ] [ [1m-J [0m_j_o_b ] [ [1m-T
     [0m_t_i_t_l_e ] [ [1m-i [0m[ _n_u_m_c_o_l_s ]] [ [1m-1234 [0m_f_o_n_t ] [ [1m-w[0m_n_u_m ] [
     [1m-pltndgvcfrmhs [0m] [ name ...  ]

[1mDESCRIPTION
     Lpr [0muses a spooling daemon to print the named files when
     facilities become available.  If no names appear, the stan-
     dard input is assumed.  The [1m-P [0moption may be used to force
     output to a specific printer.  Normally, the default printer
     is used (site dependent), or the value of the environment
     variable PRINTER is used.

     The following single letter options are used to notify the
     line printer spooler that the files are not standard text
     files. The spooling daemon will use the appropriate filters
     to print the data accordingly.  With the exception of [1m-p [0mand
     [1m-l[0m, these filters are not supplied; see the section entitled
     _F_i_l_t_e_r_s below.

     [1m-p   [0mUse _p_r(1) to format the files

     [1m-l   [0mUse filter from the [1mif [0mentry in /etc/printcap; normally
	  set to /usr/lib/lpf/lpf, which allows control charac-
	  ters to be printed and suppresses page breaks.

     [1m-t   [0mUse filter from the [1mtf [0mentry in /etc/printcap, conven-
	  tionally used to process _t_r_o_f_f output (CAT photo-
	  typesetter commands).

     [1m-n   [0mUse filter from the [1mnf [0mentry in /etc/printcap, conven-
	  tionally used to process the output of _d_i_t_r_o_f_f (device
	  independent troff).

     [1m-d   [0mUse filter from the [1mdf [0mentry in /etc/printcap, conven-
	  tionally used to process the output of _t_e_x (DVI format
	  from Stanford).

     [1m-g   [0mUse the filter from the [1mgf [0mentry in /etc/printcap, con-
	  ventionally used to process standard plot data as pro-
	  duced by the _p_l_o_t(3X) routines.

     [1m-v   [0mUse the filter from the [1mvf [0mentry in /etc/printcap, con-
	  ventionally used to process a raster image for devices
	  like the Benson Varian.

     [1m-c   [0mUse the filter from the [1mcf [0mentry in /etc/printcap.

     [1m-f   [0mUse the filter from the [1mrf [0mentry in /etc/printcap,



Printed 25/10/91    Revision 1.5 of 24/07/90			1






LPR(1)		    UNIX Programmer's Manual		   LPR(1)



	  conventionally used to interpret the first character of
	  each line as a standard FORTRAN carriage control char-
	  acter.

     The remaining single letter options have the following mean-
     ing.

     [1m-r   [0mRemove the file upon completion of spooling or upon
	  completion of printing (with the [1m-s [0moption).

     [1m-m   [0mSend mail upon completion.

     [1m-h   [0mSuppress the printing of the burst page.

     [1m-s   [0mUse symbolic links.  Usually files are copied to the
	  spool directory.

     The [1m-C [0moption takes the following argument as a job classif-
     ication for use on the burst page.  For example,

	  lpr -C EECS foo.c

     causes the system name (the name returned by _h_o_s_t_n_a_m_e(1)) to
     be replaced on the burst page by EECS, and the file foo.c to
     be printed.

     The [1m-J [0moption takes the following argument as the job name
     to print on the burst page.  Normally, the first file's name
     is used.

     The [1m-T [0moption uses the next argument as the title used by
     _p_r(1) instead of the file name.

     To get multiple copies of output, use the [1m-#[0m_n_u_m option,
     where _n_u_m is the number of copies desired of each file
     named.  For example,

	  lpr -#3 foo.c bar.c more.c

     would result in 3 copies of the file foo.c, followed by 3
     copies of the file bar.c, etc.  On the other hand,

	  cat foo.c bar.c more.c | lpr -#3

     will give three copies of the concatenation of the files.

     The [1m-i [0moption causes the output to be indented. If the next
     argument is numeric, it is used as the number of blanks to
     be printed before each line; otherwise, 8 characters are
     printed.





Printed 25/10/91    Revision 1.5 of 24/07/90			2






LPR(1)		    UNIX Programmer's Manual		   LPR(1)



     The [1m-w [0moption takes the immediately following number to be
     the page width for _p_r.

     The [1m-s [0moption will use _s_y_m_l_i_n_k(2) to link data files rather
     than trying to copy them so large files can be printed.
     This means the files should not be modified or removed until
     they have been printed.  This option only works for local
     files. Print jobs from remote hosts are always copied into
     the spool area.

     The option [1m-1234 [0mSpecifies a font to be mounted on font
     position _i.  The daemon will construct a ._r_a_i_l_m_a_g file
     referencing /_u_s_r/_l_i_b/_v_f_o_n_t/_n_a_m_e._s_i_z_e.

[1mFILTERS
     [0mAlthough [1mlpr [0mprovides options for selecting various output
     filters, the filters are actually run by the line printer
     daemon, _l_p_d(8).  In the case of a remote printer, therefore,
     the filters must be installed on the remote machine.
     Instructions for writing line printer filters can be found
     in _4._3_B_S_D _L_i_n_e _P_r_i_n_t_e_r _S_p_o_o_l_e_r _M_a_n_u_a_l, section _S_M_M:_6 of the
     _U_n_i_x _S_y_s_t_e_m _M_a_n_a_g_e_r'_s _M_a_n_u_a_l.

[1mFILES
     [0m/etc/passwd	    personal identification
     /etc/printcap	    printer capabilities data base
     /usr/lib/lpd*	    line printer daemons
     /var/spool/*	    directories used for spooling
     /var/spool/*/cf*	    daemon control files
     /var/spool/*/df*	    data files specified in "cf" files
     /var/spool/*/tf*	    temporary copies of "cf" files
     /var/adm/lpd-errs	    messages from the printer daemon

[1mSEE ALSO
     [0mlpq(1), lprm(1), pr(1), symlink(2), printcap(5), lpc(8),
     lpd(8)
     _4._3_B_S_D _L_i_n_e _P_r_i_n_t_e_r _S_p_o_o_l_e_r _M_a_n_u_a_l, section _S_M_M:_6 of the
     _U_n_i_x _S_y_s_t_e_m _M_a_n_a_g_e_r'_s _M_a_n_u_a_l.

[1mDIAGNOSTICS
     [0mIf you try to spool too large a file, it will be truncated.
     _L_p_r will object to printing binary files.	If a user other
     than root prints a file and spooling is disabled, _l_p_r will
     print a message saying so and will not put jobs in the
     queue.  If a connection to _l_p_d on the local machine cannot
     be made, _l_p_r will say that the daemon cannot be started.
     Diagnostics may be printed in the daemon's log file regard-
     ing missing spool files by _l_p_d.

[1mBUGS
     [0mFonts for _t_r_o_f_f and _t_e_x reside on the host with the printer.
     It is currently not possible to use local font libraries.



Printed 25/10/91    Revision 1.5 of 24/07/90			3






LPR(1)		    UNIX Programmer's Manual		   LPR(1)



     Those error messages which come from _l_p_d rather than _l_p_r are
     not reported to the user's terminal, but instead to a log
     file, usually /var/adm/lpd-errs.  In the case of a remote
     printer, this log file is on the remote machine.  The most
     common reason for such an error is an attempt to use a non-
     existent filter.

















































Printed 25/10/91    Revision 1.5 of 24/07/90			4



[0m