NAME

uprint-lp - selects spooler and submits print job


SYNOPSIS

uprint-lp switches [filename ...]


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 System V Unix lp program.

-d queue
This option specifies the print queue in which the job should be entered. If this option is omited then the LPDEST and PRINTER environment variables are searched in that order. If they are both undefined, then a queue name is taken from the ``uprint-lp='' setting in the ``[default destinations] section of uprint.conf. If that too is not defined, then a setting of ''lp`` is assumed.

-i requestid
This switch is used to specify the request id of a job to be manipulated as discribed by the -? switch. This switch is not yet supported by uprint-lp.

-H handling
This switch requests ``special handling''. The valid values for handling are ``hold'', ``resume'', and ``immediate''. This switch does not work yet in uprint-lp.

-c
This switch indicates that the spooler should make its own copy of the job rather than reading the origional when it is ready to print. This option should be used if you will delete or modify the origional before printing is likely to be finished.

-f formname
This switch specifies a ``form'' (generally a kind of paper) on which the job should be printed. Naturally, this will work with lp queues. For PPR queues, the values is considered to be a PPR medium name fed to ppr using its -D (default medium) switch. For lpr queues this switch will have no effect.

-m
Send email when the job has been printed.

-w
Write a message to the user's terminal when the job is done.

-n n
Print the indicated number of copies.

-o options
This sets ``interface options''. The options are expressed as name=value pairs. The standard interface options were conceived in the days when line printers dominated. It is often difficult to determine how they ought to apply to modern printers such as laser printers.

If the queue is an lp queue then the -o swith with its option is simply passed on to lp. In the case of a PPR or lpr queue, Uprint attempt to perform a suitable convertion. Those conversions are in a state of flux and are undocumented at this time.

The standard interface options are as follows:

nobanner
nofilebreak
length=
width=
lpi=
cpi=
stty=
-y list
This switch gives a list of ``modes''. These are operations performed on the file by filters. The list of available modes is defined by the system administrator. The effect of this switch on non-lp queue is not yet defined.

-P list
This option can be used to indicate that only certain page should be printed. The real lp man page says that requests of this type can only be satisfied when a filter exists that can extract pages and that the job will be rejected if the request cannot be satisfied. This option is presently ignored when the queue is a lpr queue. PPR does not yet implement page selection and so will ignore such a request.

-p
This option ``enables notification'', according to the real lp man page. It is unclear what this means.

-q n
This sets the queue priority of the job. Queue priorities range from 0 (the highest) to 39 (the lowest). This parameter has not effect on lpr queues but it works with lp and PPR queues.

-s
This option suppresses the display of certain messages. Precisely what messages ought to be suppressed is unclear but the message which indicates the request id of the newly created job is among them.

-S charset
Specify the character set. For the lp spooler it appears that the list of character set names is defined by the system administrator, though there may be some standard names. This option is ignored by lpr queues. For PPR queues, the charset is passed using PPR's ``charset='' filter option. Acceptable character set names for PPR include ``latin1'' and ``cp437''.

-t string
This switch is used to specify a job name (title) for the banner page.

-T type
This switch indicates the format (type) of the input file.

For lp queues, these types are defined by the system administrator, however there are a few common type name including ``simple'' and ``postscript''.

For lpr queues, a few common type names are converted to the appropriate lpr switch. The translation mechanism is in flux and is not documented at this time.

For PPR queues, the indicated type is passed to ppr's -T switch.

-r
This indicates that the input file should be passed through to the printer without filtering. The precise effect of this switch on non-lp queues is not yet defined.


AUTHOR

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


BUGS

Many options are simply passed to the remote spooler without any validity checking. Most often this will result in the option doing nothing.