NAME

uprint-lpr - selects spooler and submits print job


SYNOPSIS

uprint-lpr switches [filename1 [filename2] ... ]


DESCRIPTION

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.

Input File Type Options

-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.

Banner Page Options

-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.)

Other Standard Options

-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.

OSF/1 and Digital Unix Compatibility Options

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.


AUTHOR

David Chappell, Trinity College Computing Center, Hartford, Connecticut.


BUGS

Many options are simply passed to the remote spooler without any validity checking. This means that incorrect options will often simply be ignored.