LPADMIN(1M) 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.
lpadmin may not be used when the LP scheduler, lpsched(1M),
is running, 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
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.
Page 1 (last mod. 8/20/87)
LPADMIN(1M) LPADMIN(1M)
-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 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.
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
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
Page 2 (last mod. 8/20/87)
LPADMIN(1M) LPADMIN(1M)
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/*
SEE ALSO
accept(1M), lpsched(1M).
enable(1), lp(1), lpstat(1) in the User's Reference Manual.
ORIGIN
AT&T V.3
Page 3 (last mod. 8/20/87)