uprint-lpr - selects spooler and submits print job
uprint-lpr switches [filename1 [filename2] ... ]
This program is part of the PPR uprint suite. See the UPRINT(1)
man page
for an explanation of what this means.
This program is designed to accept all of the options accepted by the
BSD lpr program. It also accepts some of the options accepted by
enhanced versions of lpr found on certain other Unix systems.
Your system administrator may have choosen to replace /usr/bin/lpr
with a link to this program.
These are the option that uprint-lpr accepts:
- -P queuename
-
Use this option to select a print queue. If this option is omited, then
the queue name is read from the environment variable PRINTER. If PRINTER
is not defined then the queue name will be read from the ``uprint-lpr='' entry
in the ``[default destinations] section of uprint.conf. If that too is
missing then the queue be ''lp``.
- -m
-
Send email when the job is done.
- -# n
-
Print the indicated number of copies.
- -p
-
The files are plain ASCII text which should be passed through pr before
printing.
- -l
-
The files are in some sort of line printer format. Control characters should
be preserved and no attempt should be made to insert page breaks.
- -f
-
The files use FORTRAN carriage control.
- -c
-
The files are
cifplot(1)
output.
- -g
-
The files are
plot(1)
output.
- -d
-
The files are TeX DVI output.
- -n
-
The files are Ditroff (modern Troff) output.
- -t
-
The files are old Troff (CAT/4 typesetter format) output.
- -v
-
The files are raster images suitable for the ``Benson Varian'', whatever
that is.
- -h
-
Don't print a banner page.
- -C string
-
Set the job classification to be printed on the banner page. If this switch
is ommited then the name of the computer from which the job origionated will
be used instead. (Exactly what a ``job classifcation'' is is unclear.)
- -J string
-
Set the job name for queue listings and banner pages.
- -T string
-
Select the title to appear in the running heads created by pr. (Obviously,
or not so obviously, this switch only makes a difference in combination
with the -p switch.)
- -r
-
Delete the job when printing is done.
- -s
-
Don't make a copy of the files, just make symbolic links to them. If you use
this then you probably shouldn't modify the files until printing is done.
In many cases, Uprint will ignore this option and make its own copy of the
files anyway.
- -1 fontname
- -2 fontname
- -3 fontname
- -4 fontname
-
Select fonts to be mounted in Troff font positions 1 through 4.
- -i n
-
Specifies a number of blanks as a left margin. The default is supposedly 8.
It is unclear when this switch is supposed to be effective. It probably
will have an effect when printing plain ASCII text (no file type switch)
and when using the -p switch.
- -w n
-
This specifies the page width (in columns) for pr.
- -U user
-
Supposedly, this switch is used specify the owner of this job. Only certain
users can use it. It is used by filters that requeue jobs. At least that
is what the BSD
lpr(1)
man page says. Likely, this switch does not work
correctly in uprint-lpr.
The lpr program in OSF/1 and Digital Unix has additional options.
Uprint-lpr understands these additional options.
- -I trayname
-
Specifies the input tray name. Valid values depend on the queue. For PPR
queues this will be the tray name from the PPD file. There will probably
not be any warning if you select a non-existent tray.
- -K duplexmode
-
This option selects double sided printing. It can also be used to select
printing modes which are useful when the printing will be done on one
side but will be photocopied onto two sides. Here are the options:
-
The various duplex modes control three things. On is how many sides of the
page are used. The other is, if both sides are used, how is the page flipped.
The third thing is page layout.
-
Page layout often changes according to how a document will be bound.
When a document is going to be bound
along one edge it is customary to make that margin a little wider. If a
document is printed on one side only and bound along the left hand edge,
the extra space is added to the left margin. If it is printed on two sides
and bound on the left hand edge then the extra space is added to the left
margin on odd numbered pages and to the right margin on even numbered pages.
This extra space is sometimes called a gutter. Also, if page numbers are
printed and they are printed off center then when printing on two sides they
are generall placed on the right on odd numbered pages and on the left on
even numbered pages.
- <one_sided> or 1 or one_sided_simplex
-
This is the default. Page are printed on one side. Where the spooler can
adjust margins, it will put any ``gutter'' (extra space for the bound edge)
on the left hand side.
- two_sided or 2 or two_sided_duplex
-
The document is printed on both sides of the paper. This is probabaly
the duplex option you want. The pages are flipped over the long edge
(generally the left edge, like most books). If a gutter is used,
it will alternate between the left and right margins.
- tumble or two_sided_tumble
-
The document is printed on both sides of the paper. The pages
are flipped over the short edge (generally the top edge, like
most calendars). If a gutter is used, it will alternate between
the top and buttom margins.
- one_sided_duplex
-
The document is printed on one side of the paper only, but if there
is a gutter it alternates betwen the left and right margins. The idea is
that the finished pages can then be photocopied onto both sides.
- one_sided_tumble
-
This is like one_sided_duplex but the gutter alternates between the top
and bottom margins.
- two_sided_simplex
-
The document is printed on both sides of the paper (duplexed) but the
gutter is always added to the left margin. It is unclear why you might want
to do this. The option is probably present only for the sake of completeness.
- -O orientation
-
This selects the orientation of the output. The choices are ``portrait''
and ``landscape''. In the case of a PPR queue this parameter will only make
a difference if the input file must be converted to PostScript, and then
only if the filter understands the ``orientation='' option.
- -j
-
Print the jobid.
- -N n
-
Print the pages N-Up.
- -o n
- -o tray
-
This option specifies the output tray. The Digital Unix
lpr(1)
man page says
that the parameter should be a number, but for a PPR queue it should be an
output tray name. The output tray name should be one of the machine
readable names mentioned in the PPD file. If you select a non-existent
output tray there will be no warning
and the job will probably be sent to an output tray you did not intend.
- -x
-
Indicates that the file does not require filtering before printing.
This option may not work when printing to PPR queues.
David Chappell, Trinity College Computing Center, Hartford, Connecticut.
Many options are simply passed to the remote spooler without any validity
checking. This means that incorrect options will often simply be ignored.