lpadmin(1M) lpadmin(1M)NAME lpadmin - configures the lp spooling system SYNOPSIS lpadmin -pprinter [-cclass] [-eprinter] [-h] [-iinterface] [-l] [-mmodel] [-rclass] [-vdevice] lpadmin -xdest lpadmin -d [dest] ARGUMENTS -pprinter Names a printer to which the -c, -e, -h, -i, -l, -m, -r, or -v options refer. If printer does not exist, then it is created. -cclass Inserts the printer into the specified class, which is created if it does not already exist. -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 is running. No other options are allowed with this option. -eprinter Copies the existing interface program of printer to be the new interface program for the printer. -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 the printer with interface being the pathname of the new program. -l Indicates that the device associated with the printer is a login terminal. The lp scheduler lpsched disables all login terminals automatically each time it is started. Before enabling the printer again, its current device should be established using lpadmin. -mmodel Selects a model interface program for the printer with model being one of the model interface names supplied with the lp software (see ``Models'' below). -rclass January 1992 1
lpadmin(1M) lpadmin(1M)Removes the printer from the specified class. If the printer is the last member of class, then class is removed. -vdevice Associates a new device with the printer with device being 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. -xdest Removes the 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 options are allowed with this option. 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 change the system default destination. The lpadmin command cannot be used when the lp scheduler, lpsched(1M), is running, except where noted below. One of the -p, -d, or -x options must be present for every legal invocation of lpadmin. 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. Alternatively, 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 that they may be given on the lp command line by using the -o 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 modify 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: 2 January 1992
lpadmin(1M) lpadmin(1M)-12 Specifies 12-pitch. The default is 10-pitch. -f Does 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 Uses compressed print. -e Uses 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 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. January 1992 3
lpadmin(1M) lpadmin(1M)LIMITATIONS When creating a new printer, the -v option and one of the -e, -i, or -m options must be supplied, but only one. The -h and -l options are mutually exclusive. Printer and class names may be no longer than 14 characters and must consist entirely of the characters AtoZ, atoz, 0to9, and underscore (_). FILES /usr/lib/lpadmin Executable file /usr/spool/lp/* Spooler files /usr/lib/OUTQLCK Lock file SEE ALSO accept(1M), lpsched(1M) enable(1), lp(1), lpstat(1), nroff(1) in A/UX Command Reference 4 January 1992