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. 

−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 two models which may be given on the lp command line using the −o keyletter:

PS A 300-dpi PostScript laser printer, such as the Apple LaserWriter. 

tek4693
The Tektronix 4693D 300-dpi color thermal transfer printer.

EXAMPLES

1.  Use the following command to connect a PostScript printer named PS1:

/usr/lib/lpadmin −pPS −v/dev/tty0 −mPS.interface

2.  Use the following command to install a Tektronix 4693D color printer:

/usr/lib/lpadmin −pTEK −v/dev/tek −mtek4693

FILES

/usr/spool/lp/∗

SEE ALSO

accept(1M), enable(1), lp(1), lpsched(1M), lpstat(1). 

September 02, 1992