LPADMIN(1M) Printing Tools LPADMIN(1M)
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 programs and to change the system default
destination.
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. 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 program 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.
-iinterface establishes a new interface program for P. Interface is
the path name of the new program.
-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
Page 1
LPADMIN(1M) Printing Tools LPADMIN(1M)
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. Device is the
pathname of a file that is writable by lp. Note that the
same device can be associated with more than one printer.
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 interface 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 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 configuration with
the command:
/usr/lib/lpadmin -ppr1 -v/dev/contty -mlqp40
FILES
/usr/spool/lp/*
Page 2
LPADMIN(1M) Printing Tools LPADMIN(1M)
SEE ALSO
enable(1), lp(1), lpstat(1), accept(1M), lpsched(1M)
Page 3