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

l
lpadmin(1M) lpadmin(1M)
id request id returned by lp.
user login name of the user who made the request.
title optional title specified with the
-t option of lp.
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. 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 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 interface
program should return a error value. This will make lpsched 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:
/usr/sbin/lpadmin -plp3 -v/dev/null -mrmodel -ocmrcmodel -osmrsmodel
-ormsystem2 -orplp
causes the spool system to use the local line printer lp3 and the model rmodel. The spool system also
uses the model
rcmodel to cancel remote requests and rsmodel to get status from system2.In
addition, the remote system name
system2 and the remote printer lp are used.
The following command performs the same operation as above.
/usr/sbin/lpadmin -plp3 -v/dev/null -mrmodel -ormsystem2 -orplp
Here the default remote cancel model rcmodel and the default remote status model rsmodel are used.
WARNINGS
When installing remote printers, use the option -ocmrcmodel instead of
-oci/usr/sbin/rcancel to specify the method used to cancel remote requests. The option
-osmrsmodel should be used instead of -osi/usr/sbin/rlpstat to specify the method used for
displaying remote status.
classes must not include remote printers. HP-UX systems do not have the ability to distribute print jobs in
this way. Printing to a class of printers on a remote system (
systemB for example) must be accomplished
by creating the class on the remote system, then identifying that class by using a command resembling the
following (although you might have to change some of the specific values shown in the example):
HP-UX 11i Version 3: February 2007 − 3 − Hewlett-Packard Company 451