LPADMIN(ADM) XENIX System V LPADMIN(ADM)
Name
lpadmin - Configures the lineprinter spooling system.
Syntax
/usr/lib/lpadmin -pprinter [options...]
/usr/lib/lpadmin -xdest
/usr/lib/lpadmin -d[dest]
Description
lpadmin configures the lineprinter spooling system 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.
System managers may also use lpinit(ADM) to add new printing
destinations to the system. lpadmin may not be used when
the lineprinter scheduler, lpsched(ADM), is running, except
where noted below.
Exactly one of the -p, -d, or -x options must be present for
every legal invocation of lpadmin.
-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(ADM) 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.
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
Page 1 (printed 2/7/91)
LPADMIN(ADM) XENIX System V LPADMIN(ADM)
creating a new printer unless the -l option
is supplied.
-iinterface Establishes a new interface program for p.
Interface is the pathname of the new program.
-l Indicates that the device associated with p
is a login terminal. The lineprinter
scheduler, lpsched(ADM), disables all login
terminals used as printers automatically each
time it is started. Before re-enabling p,
its current device should be established
using lpadmin.
-mmodel specifies model interface program to be used
(See ``Models'').
-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 print system manager, lp.
Note that there is nothing to stop a print
system manager from associating the same
device 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 shell procedures which
interface between lpsched(ADM) and devices. Models reside
in the directory /usr/spool/lp/model and may be used as is
with lpadmin-m. Models should have 644 permission if owned
by lp & bin, or 664 permission if owned by bin & bin.
System managers may modify copies of models and then use
lpadmin-i to associate them with printers. If printers have
special options, these can be included in the interface
program. Users can then choose an option with the lp -o
command.
Several model interface programs are supplied.
Page 2 (printed 2/7/91)
LPADMIN(ADM) XENIX System V LPADMIN(ADM)
Serial printers that need delays or other special stty(C)
options (such as mapping CR to newline) should have this
string included in the model interface program:
stty [ options ... ] 0<&1
Files
/usr/spool/lp/*
See Also
accept(C), enable(C), lp(C), lpinit(ADM), lpsched(ADM),
lpstat(C)
Page 3 (printed 2/7/91)