LPADMIN(1M) DOMAIN/IX SYS5 LPADMIN(1M)
NAME
lpadmin - configure the lp spooling system
USAGE
/usr/lib/lpadmin -pprinter [ options ]
/usr/lib/lpadmin -xdest
/usr/lib/lpadmin -d[dest]
DESCRIPTION
Lpadmin configures lp spooling systems and describes
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 lpsched(1M) is running, except where noted below.
OPTIONS
You can only specify one of the -p, -d or -x options in a
legal invocation of lpadmin.
-d[dest] Makes dest, an existing destination, the new sys-
tem 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.
-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.
-pprinter Names a printer to which all of the options below
refer. If printer does not exist, then it will be
created.
These 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 as
the new interface program for P.
-h Indicates that the device associated with P is
hardwired. This option is assumed when creating a
new printer unless the -l option is supplied.
-iinterface
Printed 12/4/86 LPADMIN-1
LPADMIN(1M) DOMAIN/IX SYS5 LPADMIN(1M)
Establishes a new interface program for P. Inter-
face is the path name of the new program.
-l Indicates that the device associated with P is a
log-in terminal. The lp scheduler, lpsched, dis-
ables all log-in 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 software (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 the lp
administrator, whose log-in name is lp. Note that
there is nothing to stop an administrator from
associating the same device with more than one
printer. If only the -p and -v options are sup-
plied, 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
software. 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.
Lp administrators may modify copies of models and then use
lpadmin -i to associate them with printers. The following
list describes the models and lists the options which they
may be given on the lp command line by using the -o
keyletter:
dumb Interface for a line printer without special func-
tions and protocol. Form feeds are assumed. This
LPADMIN-2 Printed 12/4/86
LPADMIN(1M) DOMAIN/IX SYS5 LPADMIN(1M)
is a good model to copy and modify for printers
which do not have models.
1640 Diablo 1640 terminal running at 1200 baud, using
XON/XOFF protocol. Options:
-12 12-pitch (10-pitch is the default)
-f don't use the 450(1) filter. The output has
been pre-processed by either 450(1) or the
nroff 450 driving table.
hp Hewlett Packard 2631A line printer at 2400 baud.
Options:
-c compressed print
-e expanded print
prx Printronix P300 printer using XON/XOFF protocol at
1200 baud.
p /com/prf interface to a Printronix printer.
Options:
-in Indent n inches
-w Wrap text if line length is exceeded.
-m Send a message via the alarm_server when the
file is printed.
ge /com/prf interface to a GE printer. Options:
-in Indent n inches
-w Wrap text if line length is exceeded.
-m Send a message via the alarm_server when the
file is printed.
-pn Set printer to n pitch.
-l Set printer to letter quality.
s /com/prf interface to a NEC Spinwriter. (Same as
p.)
The last three models are Shell scripts that invoke the
DOMAIN /com/prf printer command. Use /dev/null as the dev-
ice to associate with these printers (see -v option).
FILES
/usr/spool/lp/* spooling directories
Printed 12/4/86 LPADMIN-3
LPADMIN(1M) DOMAIN/IX SYS5 LPADMIN(1M)
RELATED INFORMATION
accept(1M)
enable(1)
lp(1)
lpsched(1M)
lpstat(1)
LPADMIN-4 Printed 12/4/86