View Source: lpr(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
LPR
!!!LPR
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILENAMES
AUTHENTICATED TRANSFERS
COMPATIBILITY
THE -B, -Y, -X filter ULTRA-LIGHTWEIGHT PRINTING OPTIONS
ENVIRONMENT
EXIT STATUS
PRINTCAP INFORMATION
FILES
SEE ALSO
DIAGNOSTICS
HISTORY
AUTHOR
----
!!NAME


lpr - off line print
!!SYNOPSIS


__lpr__ [[ __-A__ ] [[ __-B__ ] [[ __-b,l__ ] [[
__-C__ ''class'' ] [[ __-D__ ''debugopt''
]


[[ __-F__ ''filterformat'' ] [[ __-G__ ] [[ __-h__
] [[ __-i__ ''indentcols'' ] [[ __-k__ ] [[ __-J__
''job'' ] [[ __-K,#__ ''copies'' ] [[ __-m__
''mailTo'' ] [[ __-P__ ''printer'' ] [[ __-r__ ] [[
__-R__ ''remoteAccount'' ] [[ __-s__ ] [[ __-T__
''title'' ] [[ __-U__ ''user'' ] [[ __-V__ ] [[
__-w__ ''width'' ] [[ __-X__ ''userfile'' ] [[
__-Y__ ] [[ __-Z__ ''options'' ] [[ __-1,2,3,4__
''font'' ] [[ __--__ ] [[ ''filename'' ...
]
!!DESCRIPTION


__Lpr__ uses a spooling daemon to print the named files
when facilities become available. If no names appear, the
standard input is assumed.
!!OPTIONS


__-A__


The authentication type is set by the value of the AUTH
environment variable.


__-B__


Do filtering of job files by the filters specified by the
printcap. Combine the output of the filtering operation into
a single job file and then send the single file to the lpd
print spooler.


__-b, -l__


either of these flags specifies a binary or literal file,
and no (or minimial) processing is to be done by the print
spooling system. Printed using the ''f'' format filter
(:if=... or :filter=...).


__-C__ ''class''


Specify the job classification for use on the burst page and
to set the priority. Priorities range from A (lowest) to Z
(highest); the default priority is A. For
example,


lpr -C B foo.c


sets the priority/class to B and the file foo.c is
printed.


__-D__ ''debugoptions''


Debugging is controlled using the __-D__ option. This
accepts a comma-separated list of debugging settings. These
settings take one of two forms:
__facility__''=value,'' or __value__ to set an
overall default value.


__-F__ ''filterformat''


Filter or format specification. By default, input is assumed
to a standard text file and the ''f'' format is used; the
output device is assmed to be a simple line printer. Other
formats available are listed below. Not all formats may be
available on all printers; see printcap(5) for
details. Formats are single lower case letters; the
following are the valid arguments for __-F__ together
with the assumed type of data. For compatibility with
previous versions of __lpr__, the format types can be
used as options themselves (i.e. by omitting the __F__)
except where noted below, a warning may be issued in such
cases.


__-G__


Similar to the __-B__ option, but only processes
individual files.


__-h__


No banner or header for this job.


__-i__ ''indentcols''


Indent input by indentcols. Note that this option is not
supported on all printers.


__-J__ ''jobname''


Specify the job name to print on the burst page; defaults to
the name of files in the job or ''(STDIN)'' if input is
from a pipe.


__-K__''copies'', __-#__''copies''


Specify the number of copies of each file to be printed. You
may or may not get the requested number of copies depending
on the intelligence of the remote printing
system.


__-k__


__lpr__ normally creates a temporary file for the input
read from stdin before sending it to the remote printer. The
__-k__ (kut-through) option will simply copy from STDIN
to the destination print spooling system. If you kill the
job in the middle of creation then the partly transferred
file will get printed. This option may not work with very
large jobs, non-LPRng spoolers, or when you have encryption
or authentication enabled.


__-m__ ''mailTo''


Send mail upon unsuccessful completion to user
''mailTo''. The mailTo value has been used to do such
things as specify email (user@host), paging
(page:user@host), both (user@host,page:user@host) and all
sorts of other notifier information. See the LPRng HOWTO for
details on how this is implemented.


__-P__ ''printer''


By default, the destination printer is taken from the
command line ''-P printer'' value, then the environment
variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
entry in the printcap information, and and finally the
default_printer entry from the configuration file, and then
the compile time default.


__-R__ ''remoteAccount''


Specify accounting information to be used by a remote system
that prints your output.


This parameter can be used to specify a billing code to be
charged for the printing.


__-r__


The DREADED __REMOVE AFTER PRINTING__ option. Beware, for
''lpr'' will delete the files after spooling them.
Present by demand from users for compatibility with other
Berkeley lpr implementation, but really should NOT be
present.


__-T__ ''title''


Specify the title used by pr(1); defaults to the file
name.


__-U__ ''username''


The __-U__ option is used to specify a user name for the
job. This is available only to ROOT or users listed in the
''allow_user_setting'' configuration option. This is
obviously a security loophole, but it is present to allow
systems such as SAMBA to submit jobs on behalf of users. See
__Authenticated Transfers__ below.


__-V__


Verbose mode. Additional -V flags increase verbosity. Use
debug flags for extreme verbosity.


__-w__ ''width''


Specify the page width for printing the job. __-X__
''path'' User specified filter for job files. Processing
is done on the client host. __-Y__ Make a direct
connection to the printer device and do not
spool.


__-Z__ ''options''


Pass the specified options to the print spooler. Used when
additional or specialized information must be provided to
the spooler.


__OBSOLETE OPTIONS Lower case -c, -d, -g, -n, -t,
-v__


Used to indicate: __-c__ is data produced by
__cifplot__(l), __-d__ is __tex__(l) (DVI format
from Stanford), __-g__ is standard plot data as produced
by the __plot__(3X) routines, __-n__ and __-t__ is
output from (device independent) __troff__, __-v__ a
raster image for devices like the Benson Varian. __These
are obsolete.__ These are retained for historical
compatibility, but most of their functionality has been
replaced by the abilities of the printer support system to
determine the file type and do the appropriate
conversions.


__OBSOLETE OPTION -p__


__This is obsolete.__ This option is retained for
historical compatibility, but this functionality should be
implemented on the client system before sending the job to
the printer. Use pr(1) to format the files, then
print using ''f'' format. This may not be supported on
the print system.


__OBSOLETE -s__


This flag is included for compatibility with other versions
of __lpr__. In these versions it will create a symbolic
link to the files to be printed. __Lpr__ now sends files
directly to the server and it is irrelevant.


__OBSOLETE OPTIONS -1,2,3,4__''fontname''


Specify a font to be mounted on font position ''i'' for
TROFF printing (Obsolete).
!!FILENAMES


By default, if no filenames are specified __lpr__ will
read stdin and print it.
!!AUTHENTICATED TRANSFERS


The original LPR network protocol defined in RFC1179 did not
provide for user to server authentication. This is now
supported by LPRng. See the LPRng support documentation for
details on its operation and support.
!!COMPATIBILITY


The LPRng version of __lpr__ attempts to be functionaly
compatible with common implementations of __lpr__.
However, there are some commands and functionality that are
deliberately missing.


__-s__ Symbolic Links


(Berkeley LPR) This option specified that a symbolic link to
the original data file rather than a copy of the data file
was to be used when spooling jobs. This opens up a variety
of security problems, as well as being ineffective when
printing to a remote host.
!!THE -B, -Y, -X filter ULTRA-LIGHTWEIGHT PRINTING OPTIONS


LPRng supports ultra-lightweight printing by eliminating the
need for a print spooler. This is quite dangerous, but makes
the lpr client very lightweight. The __-Y__ command line
option and the __:direct__ printcap option enables lpr to
connect directly to a specified port or use a program to
send a job. This filter also enables client side filtering,
so if there are any filters specified in the printcap entry
they will be used. For example:


lpr -Y -Phost%port file1 file2 ...
approximately equivalent to:
for i in file1 file2 ...; do
${filter}
The __-B__ option or the :lpr_bounce is used to filter and make a single file out of a set of print files and then forward them.


lpr -B -Ppr@host
approximately equivalent to:
lpr -Y -P/tmp/tempfile file1 file2 ...
lpr -Ppr@host /tmp/tempfile


You can also use a printcap entry and the __:direct__
options.


Printcap:
lp:direct:lp=h14%9100:remote_support=R
lpr -Plp file1 file2
Same as:
lpr -Plp -Y -Ph14%9100 file1 file2


The __:remote_support__ option is used to prevent the
__lpq__ and __lpc__ program from attempting to send
jobs to the device.
!!ENVIRONMENT


By default, the destination printer is taken from the
command line ''-P printer'' value, then the environment
variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
entry in the printcap information, and and finally the
default_printer entry from the configuration file, and then
the compile time default.
!!EXIT STATUS


The following exit values are returned:


__zero (0)__


Successful completion.


__non-zero (!=0)__


An error occurred.
!!PRINTCAP INFORMATION


The printer names and other information is obtained by using
a printcap file or some other database. The
${HOME}/.printcap file can be used to specify user level
options and configuration information. See printcap(5) for
more information.
!!FILES


The files used by LPRng are set by values in the printer
configuration file. The following are a commonly used set of
default values.


/etc/lprng/lpd.conf                          LPRng configuration file
${HOME}/.printcap                            user printer description file
/etc/lprng/printcap                          printer description file
/etc/lprng/lpd.perms                         permissions
/var/run/lprng/lpd                           lock file for queue control
/var/spool/lpd                               spool directories
/var/spool/lpd/QUEUE/control                 queue control
/var/spool/lpd/QUEUE/log                     trace or debug log file
/var/spool/lpd/QUEUE/acct                    accounting file
/var/spool/lpd/QUEUE/status                  status file
!!SEE ALSO


lpd.conf(5), lpc(8), lpd(8),
checkpc(8), lpq(1), lprm(1),
checkpc(8), printcap(5), lpd.perms(5),
pr(1).
!!DIAGNOSTICS


Most of the diagnostics are self explanatory.
If you are puzzled over the exact cause of failure,
set the debugging level on (-D5) and run again.
The debugging information will
help you to pinpoint the exact cause of failure.
!!HISTORY


LPRng is a enhanced printer spooler system with
functionality similar to the Berkeley LPR software. The
LPRng mailing list is lprng@lprng.com; subscribe by sending
mail to lprng-request@lprng.com with the word subscribe in
the body. The software is available from
ftp://ftp.lprng.com/pub/LPRng.
!!AUTHOR


Patrick Powell
----
26 pages link to lpr(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:22:17 am by "perry"
Edit PageHistory Diff Info LikePages