HP-UX Reference (11i v2 03/08) - 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 esta-
blished 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.
-orc Restricts users to canceling only their own requests. Default is to not restrict the
cancel command.
-ob3 This is a dummy option and is maintained for binary compatibility with older
releases.
The following options are only useful with
-p and can appear in any order. They are provided with sys-
tems that provide remote spooling.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−377