lpadmin(1M) lpadmin(1M)NAME lpadmin - configure the lp spooling system SYNOPSIS /usr/lib/lpadmin -pprinter [-cclass] [-eprinter] [-h] [-iinterface] [-l] [-mmodel] [-rclass] [-vdevice] /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 destina- tions, change membership in classes, change devices for printers, change printer interface programs, and change the system default destination. lpadmin may not be used when the lp scheduler, lpsched(1M), is running, except where not- ed below. Exactly one of the -p, -d, or -x flag options must be present for every legal invocation of lpadmin. -d[dest] Make dest, an existing destination, the new system default destination. If dest is not supplied, then there is no system default destination. This flag option may be used when lpsched is running. No other flag op- tions are allowed with -d. -xdest Remove destination dest from the lp system. If dest is a printer and is the only member of a class, then the class is deleted, too. No other flag options are allowed with -x. -pprinter Name a printer to which all of the flag op- tions below refer. If printer does not ex- ist, then it is created. The following flag options are only useful with -p and may appear in any order. For ease of discussion, the printer is referred to as P. -cclass Insert printer P into the specified class, which is created if it does not already ex- ist. -eprinter Copy the existing interface program of printer to be the new interface program for P. -h Indicate that the device associated with P is April, 1990 1
lpadmin(1M) lpadmin(1M)hardwired. This flag option is assumed when creating a new printer, unless the -l flag option is supplied. -iinterface Establish a new interface program for P, with interface being the pathname of the new pro- gram. -l Indicate 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 enabling P again, its current device should be esta- blished using lpadmin. -mmodel Select a model interface program for P, with model being one of the model interface names supplied with the lp software (see ``Models'' below). -rclass Remove the printer P from the specified class. If P is the last member of class, then class is removed. -vdevice Associate a new device with printer P, with device being the pathname of a file that is writable by the lp administrator, lp. Note that there is nothing to stop an administra- tor from associating the same device with more than one printer. If only the -p and -v flag options are supplied, then lpadmin may be used while the scheduler is running. Restrictions When creating a new printer, the -v flag option and one of the -e, -i, or -m flag options must be supplied, but only one. The -h and -l flag options 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 that interface between lpsched and devices. All models reside in the directory /usr/spool/lp/model and may be used as they are with lpadmin -m. Models should have 644 permission if owned by lp and bin, or 664 permission if owned by bin and bin. Alterna- tively, lp administrators may modify copies of models and then use lpadmin -i to associate them with printers. 2 April, 1990
lpadmin(1M) lpadmin(1M)The following list describes the models and lists the op- tions that they may be given on the lp command line by using the -o flag option: dumb This model is the interface for a line printer without special functions and protocol. Form feeds are assumed. This is a good model to copy and modi- fy for printers that do not have models. 1640 This model is the interface for a Diablo 1640 printer using XON/XOFF protocol at 1200 baud. The options are: -12 Specify 12-pitch. The default is 10-pitch. -f Do not use the 450(1) filter. The output has been preprocessed by either 450(1) or the nroff 450 driving table. hp This model is the interface for a Hewlett-Packard 2631A line printer at 2400 baud. The options are: -c Use compressed print. -e Use expanded print. prx This model is the interface for a Printronix P300 or P600 printer using the XON/XOFF protocol at 1200 baud. EXAMPLES Here are some examples of how to use the various printers: 1. Assuming there is an existing Hewlett-Packard 2631A line printer named hp2, it will use the hp model interface after the command: /usr/lib/lpadmin -php2 -mhp To obtain compressed print on hp2, use the command: lp -dhp2 -o-c files 2. A Diablo 1640 printer named st1 can be added to the lp 1 configuration with the command: /usr/lib/lpadmin -pst1 -v/dev/tty20 -m1640 An nroff document may be printed on st1 in any of the following ways: nroff -T450 files | lp -dst1 -of nroff -T450-12 files | lp -dst1 -of April, 1990 3
lpadmin(1M) lpadmin(1M)nroff -T37 files | col | lp -dst1 The following command prints the password file on st1 in 12-pitch: lp -dst1 -o12 /etc/passwd Note: The -12 option of the 1640 model should never be used in conjunction with nroff. FILES /usr/lib/lpadmin /usr/spool/lp/* /usr/lib/OUTQLCK SEE ALSO enable(1), lp(1), lpstat(1), nroff(1), accept(1M), lpsched(1M). 4 April, 1990