HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

l
lpadmin(1M) lpadmin(1M)
NAME
lpadmin - configure the LP spooling system
SYNOPSIS
/usr/sbin/lpadmin -p
printer [ options ]
/usr/sbin/lpadmin -x
dest
/usr/sbin/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 cannot 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, 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, the class is deleted, too. No other options are allowed with -x
.
-d[dest ] Makes existing destination dest the new system default destination. If dest is not
supplied, there is no system default destination. This option can be used when
lpsched(1M) is running. No other options are allowed with
-d.
The following options are only useful with -p and can appear in any order. For ease of discussion, the
printer is referred to below as printer P.
-cclass Inserts printer P into the specified class. class is created if it does not already
exist.
-eprinter Copies an existing printer’s interface program to be the new interface program for
printer P.
-gpriority Sets the default priority for printer P associated with lp(1). If omitted, the default
priority is set to 0.
-h Indicates that the device associated with printer P is hardwired. This option is
assumed when creating a new printer unless the -l option is specified.
-iinterface Establishes a new interface program for printer P. interface is the pathname of
the new program.
-l Indicates that the device associated with printer P is a login terminal. The LP
scheduler (see lpsched(1M)) disables all login terminals automatically each time it
is started. Before re-enabling printer P, its current device should be established
using lpadmin.
-mmodel Selects a model interface program for printer P. model is one of the model inter-
face names supplied with the LP software (see Models below).
-rclass Removes printer P from the specified class. If printer P is the last member of the
class, the class is 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, lpadmin can be used while the
scheduler is running.
The following options are only useful with -p and can appear in any order. They are provided with sys-
tems that provide remote spooling.
-ob3 Uses three-digit request numbers associated with the printer directory. This is for
contact with BSD systems. The default is to not use three-digit request numbers.
-ociremcancel Specifies that the local command remcancel is used to cancel requests to remote
printers. To ensure that the correct command is used, specify the full path name.
Section 1M−−432 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005