Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ lpr(1MDQS) — UTek 3.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

lpq(1mdqs)

lprm(1mdqs)

qstat(1mdqs)

qmod(1mdqs)

forms(5mdqs)

mdqsd(8mdqs)

batch(1mdqs)

rsh(1n)



LPR(1MDQS)              COMMAND REFERENCE              LPR(1MDQS)



NAME
     lpr - queued printing via MDQS

SYNOPSIS
     lpr [ -a atime ] [ -b ] [ -c count ] [ -f form ] [ -h
     headerfile ] [ -H Headerfile ]
     [ -l limit ] [ -m ] [ -n ] [ -p priority ] [ -q queue ] [ -r
     ] [ -t title ] [ -u useraddr ] [ -v ] [ -R ruser ] [
     filename...  ]

DESCRIPTION
     Named files are queued for printing in a lineprinter queue
     using the lpr command.  If no files are specified, the
     standard input is read until an end-of-file is encountered.
     The original file(s) can be modified or deleted and the
     file(s) printed will be the file(s) as of the time of the
     request submission.  If the -n or -r options are used, the
     original file(s) are not spooled, hence the original file(s)
     should not be modified or deleted until printing of the
     file(s) has completed.

     Once the request has been queued, it can be deleted using
     the lprm program or modified using the qmod program, and the
     current status can be determined using the lpq program.

     A print request may be directed to either a local or a
     remote printer.

OPTIONS
     -a atime
             Do not start this job until after atime.  See
             getdate(5mdqs) for a full description of time
             specifications.  The most useful time specification
             is hour:minute [meridian]; if no meridian (am or pm)
             is specified, a 24-hour clock is used.

     -b      Print a banner page only for the first file.
             Normally a banner page is printed preceding each
             printed file.

     -c count
             Print count copies of the specified files.

     -f form Print the files on the specified form.  The default
             form is specified in /etc/qconf; the command qdev(8)
             can be executed to determine appropriate forms.

     -h headerfile
             Use the file headerfile for banner page logo
             information instead of the system default.  The full
             path name of headerfile must be specified; the first
             ~20 lines of this file will be printed and the rest



Printed 5/12/88                                                 1





LPR(1MDQS)              COMMAND REFERENCE              LPR(1MDQS)



             of the page is reserved for system provided
             information.

     -H Headerfile
             Use the file Headerfile for banner page logo
             information instead of the system default.
             Headerfile should be specified by a simple path name
             and should reside in the print-hdrdir directory
             specified in /etc/qconf.

     -l limit
             Limit the print request to limit pages.  The default
             limit is specified in /etc/qconf.  The limit should
             be in the range 0-32767; a limit of 0 indicates no
             limit.

     -m      Generate a message upon completion of the print
             request and send it via mail(1mh) to the requesting
             user.

     -n      Do not spool the specified files, instead, enter the
             file name only; this option may be used when files
             to be printed are extremely long and available space
             for second copies is limited.  When using this
             option and directing the request to a remote
             printer, local spooling is bypassed but remote
             spooling is always done.

     -p priority
             Request a priority other than the default.  The
             priority is in the range 0-10, with 5 the default
             value.  Only the superuser, the mdqs user or a
             member of the systems group may request a priority
             of 0.

     -q queue
             Send a request to a queue other than the default.
             Queueing a request to other than a print queue will
             give unpredictable results.  The default print queue
             is specified in /etc/qconf.

     -r      Remove the specified files upon successful
             completion of the request.  If the request is to be
             printed on a remote host the files will not be
             removed.  (The -r option implies the -n option.)

     -R ruser
             If printing on a remote host, MDQS normally requires
             the requesting local user name to exist on the
             remote host with rsh(1n) privileges.  This option
             allows you to specify another user on the remote
             host for rsh privileges.



Printed 5/12/88                                                 2





LPR(1MDQS)              COMMAND REFERENCE              LPR(1MDQS)



     -t title
             Override the default header page title with the
             string title.

     -u useraddr
             Overrides the default notification address with the
             address useraddr; this address should be a valid
             address to your mail system.  The default
             notification address is the name of the invoker on
             the current host.

     -v      Normally lpr does its work silently.  The -v
             (verbose) option makes lpr acknowledge that the
             request has been queued and prints the request
             number.

EXAMPLES
     The command
          lpr file1 file2

     prints two files to the default printer with added
     pagination only between files.

     The command
          pr file1 | lpr

     paginates and prints one file to the wide printer.

     Qconf Queue/Device Mapping Description entry:
          lp lp0 /usr/lib/mdqs/lpserver

     shows the qconf entry for a file to be printed on the
     current host.

     Qconf Queue/Device Mapping Description entry:
          lp2 net /usr/lib/mdqs/netsend jondoe lp

     (qconf file at jondoe contains Queue-Device Mapping and
     Device Description for queue lp2) shows the qconf entry for
     a file to be rerouted to a remote host (jondoe) and printed
     there.

     The command
          lpr -c 3 -h headerfile file1

     prints three copies of a file with the first 40 lines of
     headerfile included on the banner page.

FILES
     /etc/qconf        configuration information for MDQS

     /usr/lib/mdqs/forms



Printed 5/12/88                                                 3





LPR(1MDQS)              COMMAND REFERENCE              LPR(1MDQS)



                       restriction list of available forms

     /usr/lib/mdqs/lpserver
                       program called by the daemon to print
                       files

     /usr/lib/mdqs/netsend
                       program called to send to remote queue

     /usr/lib/mdqs/queue2
                       second stage queuer, called by lpr

     /usr/spool/q      top of spooling directory tree

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     When specifying -n (no copy), remote requests are always
     spooled.

SEE ALSO
     lpq(1mdqs), lprm(1mdqs), qstat(1mdqs), qmod(1mdqs),
     forms(5mdqs), mdqsd(8mdqs), batch(1mdqs), and rsh(1n).














Printed 5/12/88                                                 4





































































%%index%%
na:312,82;
sy:394,835;
de:1229,1020;
op:2249,1398;4031,2690;7105,791;
ex:7896,998;
fi:8894,186;9464,559;
rv:10023,836;
ca:10859,175;
se:11034,349;
%%index%%000000000180

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026