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 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, −x or −d 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 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 LP scheduler, lpsched(1M), 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 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, 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 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 key letters 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, C programs, or other executable programs which interface between lpsched(1M) and devices. All 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 and bin, or 664 permission if owned by bin and bin.  Alternatively, LP administrators may modify copies of models and then use lpadmin −i to associate them with printers.  See mklp(1M) for details of the printer models provided with your HP−UX system.

The LP model interface program does the actual printing on the device that is currently associated with the printer.  The LP spooler sets standard in to /dev/null and standard out and standard error to the device specified in the −v option of lpadmin. The interface program is invoked then for printer P from the directory /usr/spool/lp as follows:

interface/P id user title copies options file ... 

id is the request returned by lp.

user is the logname of the user who made the request. 

title is the optional title specified with the −t option of lp.

copies is the number of copies to be printed. 

options is a blank separated list of class-dependent or printer-dependent options specified with the −o option of lp.

file is the full pathname of the file to be printed. 

Given the command line arguments and the output directed to the device, interface programs may format their output in any way they choose. 

When the printing is completed, it is the responsibility of the interface program to exit with a code indicative of the success of the print job.  A return value of 0 indicates that the job completed successfully.  Values of 1 to 127 indicate that some error was encountered.  This problem will not effect future print jobs.  lpsched notifies users by mail that there was an error in printing the request.  When problems are detected which are likely to effect future print jobs, the interface program would be well to disable the printer so that print requests are not lost. 

EXAMPLES

Assuming there is an existing Hewlett-Packard 2934A line printer named lp2, it will use the hp2934a model interface after the command:

/usr/lib/lpadmin  −plp2  −mhp2934a

FILES

/usr/spool/lp/∗

SEE ALSO

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

INTERNATIONAL SUPPORT

messages. 

Hewlett-Packard Company  —  Version B.1,  April 12, 1993