LPADMIN(1M-SysV)    RISC/os Reference Manual     LPADMIN(1M-SysV)



NAME
     lpadmin - configure the LP spooling system

SYNOPSIS
     /usr/lib/lpadmin -pprinter [options]
     /usr/lib/lpadmin -xdest
     /usr/lib/lpadmin -d[dest]

DESCRIPTION
     lpadmin configures line printer (LP) spooling systems to
     describe printers, classes and devices.  It is used to add
     and remove destinations, change membership in classes,
     change devices for printers, change printer interface pro-
     grams and to change the system default destination.  lpadmin
     may not be used when the LP scheduler, lpsched(1M), is run-
     ning, except where noted below.

     Exactly one of the -p, -d or -x options must be present for
     every legal invocation of lpadmin.

     -pprinter      names a printer to which all of the options
                    below refer.  If printer does not exist then
                    it will be created.

     -xdest         removes destination dest from the LP system.
                    If dest is a printer and is the only member
                    of a class, then the class will be deleted,
                    too.  No other options are allowed with -x.

     -d[dest]       makes dest, an existing destination, the new
                    system default destination.  If dest is not
                    supplied, then there is no system default
                    destination.  This option may be used when
                    lpsched(1M) is running.  No other options are
                    allowed with -d.

     The following options are only useful with -p and may appear
     in any order.  For ease of discussion, the printer will be
     referred to as P below.

     -cclass        inserts printer P into the specified class.
                    class will be created if it does not already
                    exist.

     -eprinter      copies an existing printer's interface pro-
                    gram to be the new interface program for P.

     -h             indicates that the device associated with P
                    is hardwired.  This option is assumed when
                    adding a new printer unless the -l option is
                    supplied.




                         Printed 1/15/91                   Page 1

LPADMIN(1M-SysV)    RISC/os Reference Manual     LPADMIN(1M-SysV)



     -iinterface    establishes a new interface program for P.
                    interface is the path name of the new pro-
                    gram.

     -l             indicates that the device associated with P
                    is a login terminal.  The LP scheduler,
                    lpsched, disables all login terminals
                    automatically each time it is started.
                    Before re-enabling P, its current device
                    should be established using lpadmin.

     -mmodel        selects a model interface program for P.
                    model is one of the model interface names
                    supplied with the LP Spooling Utilities (see
                    models below).

     -rclass        removes printer P from the specified class.
                    If P is the last member of the class, then
                    the class will be removed.

     -vdevice       associates a new device with printer P.  dev-
                    ice is the pathname of a file that is writ-
                    able by lp.  Note that the same device can be
                    associated with more than one printer.  If
                    only the -p and -v options are supplied, then
                    lpadmin may be used while the scheduler is
                    running.

   Restrictions.
     When creating a new printer, the -v option and one of the
     -e, -i or -m options must be supplied.  Only one of the -e,
     -i or -m options may be supplied.  The -h and -l keyletters
     are mutually exclusive.  Printer and class names may be no
     longer than 14 characters and must consist entirely of the
     characters A-Z, a-z, 0-9 and  (underscore).

   Models.
     Model printer interface programs are supplied with the LP
     Spooling Utilities.  They are shell procedures which inter-
     face between lpsched and devices.  All models reside in the
     directory /usr/spool/lp/model and may be used as is with
     lpadmin -m.  Copies of model interface programs may also be
     modified and then associated with printers using lpadmin -i.
     The following describes the models which may be given on the
     lp command line using the -o keyletter:

     LQP-40
          Letter quality printer using XON/XOFF protocol at 9600
          baud.

     DQP-10
          Dot matrix draft quality printer using XON/XOFF



 Page 2                  Printed 1/15/91

LPADMIN(1M-SysV)    RISC/os Reference Manual     LPADMIN(1M-SysV)



          protocol at 9600 baud.

EXAMPLES
     1.  For a DQP-10 printer named cI8, it will use the DQP-10
         model interface after the command:

               /usr/lib/lpadmin -pcI8 -mdqp10

     2.  A LQP-40 printer called pr1 can be added to the lp con-
         figuration with the command:

               /usr/lib/lpadmin -ppr1 -v/dev/contty -mlqp40

FILES
     /usr/spool/lp/*

SEE ALSO
     accept(1M), lpsched(1M).
     enable(1), lp(1), lpstat(1) in the User's Reference Manual.




































                         Printed 1/15/91                   Page 3