HP-UX Reference (11i v2 07/12) - 1M System Administration Commands A-M (vol 3)

l
lpadmin(1M) lpadmin(1M)
-senable Enable email notification.
-sdisable Disable email notification. This email notification setting is ignored if the print
request is queued using the lp command and the
-w or -m option. See lp(1).
Models
Model interface programs are supplied with the LP software. They are shell procedures, C programs, or
other executable programs that interface between lpsched(1M) and devices. All printer models reside in
directory
/usr/lib/lp/model
and can be used without modification with
lpadmin -m. All cancel
models reside in directory
/usr/lib/lp/cmodel
and can be used without modification with
lpad-
min -ocm
. All status models reside in directory
/usr/lib/lp/smodel
and can be used without
modification with
lpadmin -osm. Models should have 644 permission if owned by
lp and bin, or 664
permission if owned by
bin and bin. Model file names must not exceed 14 characters. Alternatively, LP
administrators can modify copies of models then use
lpadmin -m
to associate them with printers.
The LP model interface program does the actual printing on the device that is currently associated with the
printer. The LP spooler sets standard input to
/dev/null and standard output and standard error out-
put to the device specified in the
-v option of lpadmin. The interface program is then invoked for printer
P from the directory
/etc/lp as follows:
interface/ P id user title copies options file ...
where arguments are as follows:
id request id returned by lp(1).
user login name of the user who made the request.
title optional title specified with the -t option of lp(1).
copies number of copies to be printed.
options blank-separated list of class-dependent or printer-dependent options specified with the
-o option of lp(1). Options from a BSD system have the character sequence BSD
attached to the beginning of the option (for example, BSDl).
file full pathname of the file to be printed.
Given the command line arguments and the output directed to the device, interface programs can format
their output in any way they choose.
When printing is completed, it is the responsibility of the interface program to exit with a code indicative of
the success of the print job. Only return values of
0 indicating that the job completed successfully, or
values of positive 1 through 127 indicating that some error was encountered that does not affect future
print jobs should be used. Negative values and positive values greater than 127 are reserved for system
use and should not be used by interface programs. lpsched(1M) notifies users by mail when there is an
error in printing the request. If problems are detected that are likely to affect future print jobs, the inter-
face program should return a error value. This will make lpsched(1M) disable the printer so that other
pending print requests are not lost.
The cancel and status model interface programs perform the actual communication with the remote system
to cancel requests or get the status of requests. See rcancel(1M) and rlpstat(1M) for command line argu-
ments.
EXTERNAL INFLUENCES
Environment Variables
LANG determines the language in which messages are displayed.
If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG.
If any internationalization variable contains an invalid setting, lpadmin behaves as if all internationaliza-
tion variables are set to "C" (see environ(5)).
EXAMPLES
Assuming an existing Hewlett-Packard laserjet printer named
lp1, it will use the laserjet model
interface through
/dev/lp after the command:
/usr/sbin/lpadmin -plp1 -mlaserjet -v/dev/lp
Assuming a printer lp on a remote system system2, the command:
HP-UX 11i Version 2: December 2007 Update − 3 − Hewlett-Packard Company 509