System Administration Commands lpadmin(1M)
NAME
lpadmin - configure the LP print service
SYNOPSIS
lpadmin -p printer {options}
lpadmin -x dest
lpadmin -d [dest]
lpadmin -S print-wheel -T [-A alert-type] [-W minutes]
[-Q requests]
DESCRIPTION
lpadmin configures the LP print service by defining printers
and devices. It is used to add and change printers, to
remove printers from service, to set or change the system
default destination, to define alerts for printer faults,
and to mount print wheels.
OPTIONS
The lpadmin command has options for:
o Adding or changing a printer
o Removing a printer destination
o Setting or changing the system default destination
o Setting an alert for a print wheel
The options for each of the above categories are specified
in the following subsections.
Several options support the use of lists. A list might con-
tain, for example, user names, printers, printer forms, or
content types. A list of multiple items can have the form of
either comma-separated names or have the entire list
enclosed by double quotes with a space between each name.
For example, both lists below are acceptable:
one,two,three
"one two three"
SunOS 5.11 Last change: 24 May 2006 1
System Administration Commands lpadmin(1M)
Adding or Changing a Printer
The first form of the lpadmin command (lpadmin -p printer
{options}) configures a new printer or changes the confi-
guration of an existing printer. It also starts the print
scheduler.
When creating a new printer, one of three options (-v, -U,
or -s) must be supplied. In addition, only one of the fol-
lowing can be supplied: -e, -i, or -m; if none of these
three options is supplied, the model standard is used. The
-h and -l options are mutually exclusive. Printer and class
names must be no longer than 14 characters and must consist
entirely of the characters A-Z, a-z, 0-9, dash (-) and
underscore (). If -s is specified, the following options
are invalid: -A, -e, -F, -h, -i, -l, -M, -m, -o, -U, -v, and
-W.
The following options can appear in any order.
-A alert-type [-W minutes]
The -A option is used to define an alert that informs
the administrator when a printer fault is detected, and
periodically thereafter, until the printer fault is
cleared by the administrator. The alert-types are:
mail Send the alert message using mail (see
mail(1)) to the administrator.
write Write the message to the terminal on
which the administrator is logged in.
If the administrator is logged in on
several terminals, one is chosen arbi-
trarily.
quiet Do not send messages for the current
condition. An administrator can use
this option to temporarily stop receiv-
ing further messages about a known
problem. Once the fault has been
cleared and printing resumes, messages
are sent again when another fault
occurs with the printer.
showfault Attempt to execute a fault handler on
each system that has a print job in the
queue. The fault handler is
SunOS 5.11 Last change: 24 May 2006 2
System Administration Commands lpadmin(1M)
/etc/lp/alerts/printer. It is invoked
with three parameters: printername,
date, filename. The filename is the
name of a file containing the fault
message.
none Do not send messages; any existing
alert definition for the printer is
removed. No alert is sent when the
printer faults until a different
alert-type (except quiet) is used.
shell-command Run the shell-command each time the
alert needs to be sent. The shell com-
mand should expect the message in stan-
dard input. If there are blank spaces
embedded in the command, enclose the
command in quotes. Notice that the mail
and write values for this option are
equivalent to the values mail user-name
and write user-name respectively, where
user-name is the current name for the
administrator. This is the login name
of the person submitting this command
unless he or she has used the su com-
mand to change to another user ID. If
the su command has been used to change
the user ID, then the user-name for the
new ID is used.
list Display the type of the alert for the
printer fault. No change is made to the
alert.
When a fault occurs, the printing subsystem displays a
message indicating that printing for a specified printer
has stopped and the reason for the stoppage. The message
also indicates that printing will restart in a few
minutes and that you can enter an enable command if you
want to restart sooner than that.
Following a fault that occurs in the middle of a print
job, the job is reprinted from the beginning. An excep-
tion to this occurs when you enter a command, such as
the one shown below, that changes the page list to be
printed.
% lp -i request-id -P ...
SunOS 5.11 Last change: 24 May 2006 3
System Administration Commands lpadmin(1M)
For a given print request, the presence of multiple rea-
sons for failure indicate multiple attempts at printing.
The LP print service can detect printer faults only
through an adequate fast filter and only when the stan-
dard interface program or a suitable customized inter-
face program is used. Furthermore, the level of recovery
after a fault depends on the capabilities of the filter.
If, instead of a single printer, the keyword all is
displayed in an alert, the alert applies to all
printers.
If the -W option is not used to arrange fault alerting
for printer, the default procedure is to mail one mes-
sage to the administrator of printer per fault. This is
equivalent to specifying -W once or -W 0. If minutes is
a number greater than zero, an alert is sent at inter-
vals specified by minutes.
-c class
Insert printer into the specified class. class is
created if it does not already exist. This option
requires the -U dial-info or -v device options.
-D comment
Save this comment for display whenever a user asks for a
full description of printer (see lpstat(1)). The LP
print service does not interpret this comment.
-e printer
Copy the interface program of an existing printer to be
the interface program for printer. (Options -i and -m
must not be specified with this option.)
-f allow:form-list
-f deny:form-list
Allow or deny the forms in form-list to be printed on
printer. By default no forms are allowed on a new
printer.
For each printer, the LP print service keeps two lists
of forms: an ``allow-list'' of forms that can be used
with the printer, and a ``deny-list'' of forms that
SunOS 5.11 Last change: 24 May 2006 4
System Administration Commands lpadmin(1M)
cannot be used with the printer. With the -f allow
option, the forms listed are added to the allow-list and
removed from the deny-list. With the -f deny option, the
forms listed are added to the deny-list and removed from
the allow-list.
If the allow-list is not empty, only the forms in the
list can be used on the printer, regardless of the con-
tents of the deny-list. If the allow-list is empty, but
the deny-list is not, the forms in the deny-list cannot
be used with the printer. All forms can be excluded from
a printer by specifying -f deny:all. All forms can be
used on a printer (provided the printer can handle all
the characteristics of each form) by specifying -f
allow:all.
The LP print service uses this information as a set of
guidelines for determining where a form can be mounted.
Administrators, however, are not restricted from mount-
ing a form on any printer. If mounting a form on a par-
ticular printer is in disagreement with the information
in the allow-list or deny-list, the administrator is
warned but the mount is accepted. Nonetheless, if a user
attempts to issue a print or change request for a form
and printer combination that is in disagreement with the
information, the request is accepted only if the form is
currently mounted on the printer. If the form is later
unmounted before the request can print, the request is
canceled and the user is notified by mail.
If the administrator tries to specify a form as accept-
able for use on a printer that does not have the capa-
bilities needed by the form, the command is rejected.
Notice the other use of -f, with the -M option, below.
The -T option must be invoked first with lpadmin to
identify the printer type before the -f option can be
used.
-F fault-recovery
This option specifies the recovery to be used for any
print request that is stopped because of a printer
fault, according to the value of fault-recovery:
continue Continue printing on the top of the page
where printing stopped. This requires a
filter to wait for the fault to clear
before automatically continuing.
SunOS 5.11 Last change: 24 May 2006 5
System Administration Commands lpadmin(1M)
beginning Start printing the request again from the
beginning.
wait Disable printing on printer and wait for
the administrator or a user to enable
printing again.
During the wait, the administrator or the
user who submitted the stopped print
request can issue a change request that
specifies where printing should resume.
(See the -i option of the lp command.) If
no change request is made before printing
is enabled, printing resumes at the top of
the page where stopped, if the filter
allows; otherwise, the request is printed
from the beginning.
-h
Indicate that the device associated with the printer is
hardwired. If neither of the mutually exclusive options,
-h and -l, is specified, -h is assumed.
-i interface
Establish a new interface program for printer. interface
is the pathname of the new program. (The -e and -m
options must not be specified with this option.)
-I content-type-list
Allow printer to handle print requests with the content
types listed in a content-type-list.
The type simple is recognized as the default content
type for files in the UNIX system. A simple type of file
is a data stream containing only printable ASCI charac-
ters and the following control characters:
Control Char Octal Value Meaning
BACKSPACE 10 Move back one char, except
at beginning of line
TAB 11 Move to next tab stop
LINEFED 12 Move to beginning of
SunOS 5.11 Last change: 24 May 2006 6
System Administration Commands lpadmin(1M)
(newline) next line
FORMFED 14 Move to beginning of
next page
RETURN 15 Move to beginning of
current line
To prevent the print service from considering simple a
valid type for the printer, specify either an explicit
value (such as the printer type) in the content-type-
list, or an empty list. If you do want simple included
along with other types, you must include simple in the
content-type-list.
In addition to content types defined by the print
administrator, the type PostScript is recognized and
supported by the Solaris print subsystem. This includes
filters to support PostScript as the printer content
type.
The type any is recognized as a special content type for
files. When declared as the input type for a printer, it
signals the print sub-system not to do any filtering on
the file before sending it to the printer.
Except for simple and any, each content-type name is
determined by the administrator. If the printer type is
specified by the -T option, then the printer type is
implicitly considered to be also a valid content type.
-l
Indicate that the device associated with printer is a
login terminal. The LP scheduler (lpsched) disables all
login terminals automatically each time it is started.
(The -h option must not be specified with this option.)
-m model
Select model interface program, provided with the LP
print service, for the printer. (Options -e and -i must
not be specified with this option.)
-M -f form-name [-a [-o filebreak] [-t tray-number]
Mount the form form-name on printer. Print requests that
need the pre-printed form form-name is printed on
printer. If more than one printer has the form mounted
and the user has specified any (with the -d option of
the lp command) as the printer destination, then the
SunOS 5.11 Last change: 24 May 2006 7
System Administration Commands lpadmin(1M)
print request is printed on the one printer that also
meets the other needs of the request.
The page length and width, and character and line
pitches needed by the form are compared with those
allowed for the printer, by checking the capabilities in
the terminfo database for the type of printer. If the
form requires attributes that are not available with the
printer, the administrator is warned but the mount is
accepted. If the form lists a print wheel as mandatory,
but the print wheel mounted on the printer is different,
the administrator is also warned but the mount is
accepted.
If the -a option is given, an alignment pattern is
printed, preceded by the same initialization of the phy-
sical printer that precedes a normal print request, with
one exception: no banner page is printed. Printing is
assumed to start at the top of the first page of the
form. After the pattern is printed, the administrator
can adjust the mounted form in the printer and press
return for another alignment pattern (no initialization
this time), and can continue printing as many alignment
patterns as desired. The administrator can quit the
printing of alignment patterns by typing q.
If the -o filebreak option is given, a formfeed is
inserted between each copy of the alignment pattern. By
default, the alignment pattern is assumed to correctly
fill a form, so no formfeed is added.
If the -t tray-number option is specified, printer tray
tray-number is used.
A form is ``unmounted'' either by mounting a new form in
its place or by using the -f none option. By default, a
new printer has no form mounted.
Notice the other use of -f without the -M option above.
-M -S print-wheel
Mount the print-wheel on printer. Print requests that
need the print-wheel are printed on printer. If more
than one printer has print-wheel mounted and the user
has specified any (with the -d option of the lp command)
as the printer destination, then the print request is
printed on the one printer that also meets the other
needs of the request.
If the print-wheel is not listed as acceptable for the
SunOS 5.11 Last change: 24 May 2006 8
System Administration Commands lpadmin(1M)
printer, the administrator is warned but the mount is
accepted. If the printer does not take print wheels, the
command is rejected.
A print wheel is ``unmounted'' either by mounting a new
print wheel in its place or by using the option -S none.
By default, a new printer has no print wheel mounted.
Notice the other uses of the -S option without the -M
option described below.
-n ppdfilename
Specify a PD file for creating and modifying printer
queues. ppdfilename is the full path and file name to
the PD file. Used in conjunction with the -p, -d, -x,
or -S options.
-o option
The -o option defines default printer configuration
values given to an interface program. The default can be
explicitly overwritten for individual requests by the
user (see lp(1)), or taken from a preprinted form
description (see lpforms(1M) and lp(1)).
There are several options which are predefined by the
system. In addition, any number of key-value pairs can
be defined. See the section "Predefined Options Used
with the -o Option", below.
-P paper-name
Specify a paper type list that the printer supports.
-r class
Remove printer from the specified class. If printer is
the last member of class, then class is removed.
-S list
Allow either the print wheels or aliases for character
sets named in list to be used on the printer.
If the printer is a type that takes print wheels, then
list is a comma or space separated list of print wheel
SunOS 5.11 Last change: 24 May 2006 9
System Administration Commands lpadmin(1M)
names. These are the only print wheels considered mount-
able on the printer. (You can always force a different
print wheel to be mounted.) Until the option is used to
specify a list, no print wheels are considered mountable
on the printer, and print requests that ask for a par-
ticular print wheel with this printer are rejected.
If the printer is a type that has selectable character
sets, then list is a list of character set name ``map-
pings'' or aliases. Each ``mapping'' is of the form
known-name=alias The known-name is a character set
number preceded by cs (such as cs3 for character set
three) or a character set name from the terminfo data-
base entry csnm. See terminfo(4). If this option is not
used to specify a list, only the names already known
from the terminfo database or numbers with a prefix of
cs is acceptable for the printer. If list is the word
none, any existing print wheel lists or character set
aliases are removed.
Notice the other uses of the -S with the -M option
described above.
The -T option must be invoked first with lpadmin to
identify the printer type before the -S option can be
used.
-s system-name
The -s option can be used for both remote or local
printers. For remote printers:
-s system-name[!printer-name] (UCP format)
-s printer-name@system-name (RCMD format)
Make a remote printer (one that must be accessed
through another system) accessible to users on your
system. system-name is the name of the remote system
on which the remote printer is located it. printer-
name is the name used on the remote system for that
printer. For example, if you want to access printer1
on system1 and you want it called printer2 on your
system:
-p printer2 -s system1!printer1
-p printer2 -s printer1@system1
SunOS 5.11 Last change: 24 May 2006 10
System Administration Commands lpadmin(1M)
-s scheme:/end-point (URI format)
Make a remote printer (one that must be accessed
through another system) accessible to users on your
system. The supported schemes include lpd and ipp.
Specify URI's using the lpd format as follows:
lpd:/server/printers/queue[#Solaris]
URI's using the ipp format are defined by the remote
print server. They are generally of the format:
ipp:/server/printers/queue
In either case, server specifies the hostname or IP
address of the remote print server, queue specifies
the name of the print queue on the remote print
server, and the optional #Solarisspecifies that the
remote print server is a Solaris server when lpd URI
format is being used.
For example:
-p printer -s lpd:/server/printers/queue#Solaris
-p printer -s ipp:/server/printers/queue
For local printers:
-s "localhost" Use localhost for the system-name to
be used by the print service. In an
environment where the nodename is
variable, print queues are invalidated
when the nodename changes. Using
localhost as the system-name allows
print queues to be maintained across
changing nodenames. The system-name,
as used by the print service, is only
set to localhost when explicitely set
with this option; by default, lpadmin
sets system-name to nodename. For
example, if you want to configure a
new printer on the local system, and
want it called printer3:
-p printer3 -s localhost -v device
This option should never be used when
creating name service maps.
SunOS 5.11 Last change: 24 May 2006 11
System Administration Commands lpadmin(1M)
-T printer-type-list
Identify the printer as being of one or more printer-
types. Each printer-type is used to extract data from
the terminfo database; this information is used to ini-
tialize the printer before printing each user's request.
Some filters might also use a printer-type to convert
content for the printer. If this option is not used, the
default printer-type is unknown. No information is
extracted from terminfo so each user request is printed
without first initializing the printer. Also, this
option must be used if the following are to work: -o
cpi, -o lpi, -o width, and -o length options of the
lpadmin and lp commands, and the -S and -f options of
the lpadmin command.
If the printer-type-list contains more than one type,
then the content-type-list of the -I option must either
be specified as simple, as empty (-I ""), or not speci-
fied at all.
-tnumber-of-trays
Specify the number of trays when creating the printer.
-u allow:login-ID-list
-u deny:login-ID-list
Allow or deny the users in login-ID-list access to the
printer. By default all users are allowed on a new
printer. The login-ID-list argument can include any or
all of the following constructs:
login-ID a user on any system
system-name!login-ID a user on system system-name
system-name!all all users on system system-name
all!login-ID a user on all systems
all all users on all systems
For each printer, the LP print service keeps two lists
of users: an ``allow-list'' of people allowed to use the
printer, and a ``deny-list'' of people denied access to
SunOS 5.11 Last change: 24 May 2006 12
System Administration Commands lpadmin(1M)
the printer. With the -u allow option, the users listed
are added to the allow-list and removed from the deny-
list. With the -u deny option, the users listed are
added to the deny-list and removed from the allow-list.
If the allow-list is not empty, only the users in the
list can use the printer, regardless of the contents of
the deny-list. If the allow-list is empty, but the
deny-list is not, the users in the deny-list cannot use
the printer. All users can be denied access to the
printer by specifying -u deny:all. All users can use the
printer by specifying -u allow:all.
The -U option allows your print service to access a
remote printer. (It does not enable your print service
to access a remote printer service.) Specifically, -U
assigns the ``dialing'' information dial-info to the
printer. dial-info is used with the dial routine to call
the printer. Any network connection supported by the
Basic Networking Utilities works. dial-info can be
either a phone number for a modem connection, or a sys-
tem name for other kinds of connections. Or, if -U
direct is given, no dialing takes place, because the
name direct is reserved for a printer that is directly
connected. If a system name is given, it is used to
search for connection details from the file
/etc/uucp/Systems or related files. The Basic Networking
Utilities are required to support this option. By
default, -U direct is assumed.
-v device
Associate a device with printer. device is the path name
of a file that is writable by lp. Notice that the same
device can be associated with more than one printer.
-v scheme:/end-point
Associate a network attached device with printer.
scheme is the method or protocol used to access the net-
work attached device and end-point is the information
necessary to contact that network attached device. Use
of this device format requires the use of the uri inter-
face script and can only be used with the smb scheme at
this time.
SunOS 5.11 Last change: 24 May 2006 13
System Administration Commands lpadmin(1M)
For example:
# lpadmin -p queue -v smb:/smb-service/printer -m uri
See the /usr/sfw/man/man1m/smbspool.1m man page for
details.
Removing a Printer Destination
The -x dest option removes the destination dest (a printer
or a class), from the LP print service. If dest is a printer
and is the only member of a class, then the class is
deleted, too. If dest is all, all printers and classes are
removed. If there are no remaining local printers and the
scheduler is still running, the scheduler is shut down.
No other options are allowed with -x.
Setting/Changing the System Default Destination
The -d [dest] option makes dest (an existing printer or
class) the new system default destination. If dest is not
supplied, then there is no system default destination. No
other options are allowed with -d.
Setting an Alert for a Print Wheel
-S print-wheel [-A alert-type] [-W minutes] [-Q requests] -T
The -S print-wheel option is used with the -A alert-type
option to define an alert to mount the print wheel when
there are jobs queued for it. If this command is not
used to arrange alerting for a print wheel, no alert is
sent for the print wheel. Notice the other use of -A,
with the -p option, above.
The alert-types are:
mail Send the alert message using the mail
command to the administrator.
write Write the message, using the write com-
mand, to the terminal on which the
administrator is logged in. If the
administrator is logged in on several
terminals, one is arbitrarily chosen.
quiet Do not send messages for the current
condition. An administrator can use
this option to temporarily stop
SunOS 5.11 Last change: 24 May 2006 14
System Administration Commands lpadmin(1M)
receiving further messages about a
known problem. Once the print-wheel has
been mounted and subsequently
unmounted, messages are sent againwhen
the number of print requests reaches
the threshold specified by the -Q
option.
none Do not send messages until the -A
option is given again with a different
alert-type (other than quiet).
shell-command Run the shell-command each time the
alert needs to be sent. The shell com-
mand should expect the message in stan-
dard input. If there are blanks embed-
ded in the command, enclose the command
in quotes. Notice that the mail and
write values for this option are
equivalent to the values mail user-name
and write user-name respectively, where
user-name is the current name for the
administrator. This is the login name
of the person submitting this command
unless he or she has used the su com-
mand to change to another user ID. If
the su command has been used to change
the user ID, then the user-name for the
new ID is used.
list Display the type of the alert for the
print wheel on standard output. No
change is made to the alert.
The message sent appears as follows:
The print wheel print-wheel needs to be mounted
on the printer(s):
printer(integer1requests) integer2 print requests
await this print wheel.
The printers listed are those that the administrator had
earlier specified were candidates for this print wheel.
The number integer1 listed next to each printer is the
number of requests eligible for the printer. The number
integer2 shown after the printer list is the total
number of requests awaiting the print wheel. It is less
than the sum of the other numbers if some requests can
SunOS 5.11 Last change: 24 May 2006 15
System Administration Commands lpadmin(1M)
be handled by more than one printer.
If the print-wheel is all, the alerting defined in this
command applies to all print wheels already defined to
have an alert.
If the -W option is not given, the default procedure is
that only one message is sent per need to mount the
print wheel. Not specifying the -W option is equivalent
to specifying -W once or -W 0. If minutes is a number
greater than zero, an alert is sent at intervals speci-
fied by minutes.
If the -Q option is also given, the alert is sent when a
certain number (specified by the argument requests) of
print requests that need the print wheel are waiting. If
the -Q option is not given, or requests is 1 or any
(which are both the default), a message is sent as soon
as anyone submits a print request for the print wheel
when it is not mounted.
PREDEFINED OPTIONS USED WITH THE -o
A number of options, described below, are predefined for use
with -o. These options are used for adjusting printer capa-
bilities, adjusting printer port characteristics, configur-
ing network printers, and controlling the use of banner. The
-o also supports an arbitrary keyword=value format, which is
referred to below as an undefined option.
Adjusting Printer Capabilities
The length, width, cpi, and lpi parameters can be used in
conjunction with the -o option to adjust printer capabili-
ties. The format of the parameters and their values is as
follows:
length=scaled-decimal-number
width=scaled-decimal-number
cpi=scaled-decimal-number
lpi=scaled-decimal-number
The term scaled-decimal-number refers to a non-negative
number used to indicate a unit of size. The type of unit is
shown by a ``trailing'' letter attached to the number. Three
types of scaled-decimal-numbers can be used with the LP
print service: numbers that show sizes in centimeters
(marked with a trailing c); numbers that show sizes in
inches (marked with a trailing i); and numbers that show
sizes in units appropriate to use (without a trailing
SunOS 5.11 Last change: 24 May 2006 16
System Administration Commands lpadmin(1M)
letter), that is, lines, characters, lines per inch, or
characters per inch.
The option values must agree with the capabilities of the
type of physical printer, as defined in the terminfo data-
base for the printer type. If they do not, the command is
rejected.
The defaults are defined in the terminfo entry for the
specified printer type. The defaults can be reset by:
lpadmin -p printername -o length=
lpadmin -p printername -o width=
lpadmin -p printername -o cpi=
lpadmin -p printername -o lpi=
Adjusting Printer Port Characteristics
You use the stty keyword in conjunction with the o option to
adjust printer port characteristics. The general form of the
stty portion of the command is:
stty="'stty-option-list'"
The stty-option-list is not checked for allowed values, but
is passed directly to the stty program by the standard
interface program. Any error messages produced by stty when
a request is processed (by the standard interface program)
are mailed to the user submitting the request.
The default for stty is:
stty="'9600 cs8 -cstopb -parenb ixon
-ixany opost -olcuc onlcr
-ocrnl -onocr
-onlret -ofill nl0 cr0 tab0 bs0 vt0 ff0'"
The default can be reset by:
lpadmin -p printername -o stty=
SunOS 5.11 Last change: 24 May 2006 17
System Administration Commands lpadmin(1M)
Configuring Network Printers
The dest, protocol, bsdctrl, and timeout parameters are used
in conjunction with the -o option to configure network
printers. The format of these keywords and their assigned
values is as follows:
dest=string protocol=string bsdctrl=string \
timeout=non-negative-integer-seconds
These four options are provided to support network printing.
Each option is passed directly to the interface program; any
checking for allowed values is done there.
The value of dest is the name of the destination for the
network printer; the semantics for value dest are dependent
on the printer and the configuration. There is no default.
The value of option protocol sets the over-the-wire protocol
to the printer. The default for option protocol is bsd. The
value of option bsdctrl sets the print order of control and
data files (BSD protocol only); the default for this option
is control file first. The value of option timeout sets the
seed value for backoff time when the printer is busy. The
default value for the timeout option is 10 seconds. The
defaults can be reset by:
lpadmin -p printername -o protocol=
lpadmin -p printername -o bsdctrl=
lpadmin -p printername -o timeout=
Controlling the Use of the Banner Page
Use the following commands to control the use of the banner
page:
lpadmin -p printer -o nobanner
lpadmin -p printer -o banner
lpadmin -p printer -o banner=always
lpadmin -p printer -o banner=never
lpadmin -p printer -o banner=optional
The first and fifth commands (-o nobanner and -o
banner=optional) are equivalent. The default is to print the
SunOS 5.11 Last change: 24 May 2006 18
System Administration Commands lpadmin(1M)
banner page, unless a user specifies -o nobanner on an lp
command line.
The second and third commands (-o banner and -o
banner=always) are equivalent. Both cause a banner page to
be printed always, even if a user specifies lp -o nobanner.
The root user can override this command.
The fourth command (-o banner=never) causes a banner page
never to be printed, even if a user specifies lp -o banner.
The root user can override this command.
Undefined Options
The -o option supports the use of arbitrary, user-defined
options with the following format:
key=value
Each key=value is passed directly to the interface pro-
gram. Any checking for allowed values is done in the
interface program.
Any default values for a given key=value option are
defined in the interface program. If a default is pro-
vided, it can be reset by typing the key without any
value:
lpadmin -p printername -o key=
lpadmin -p printer -o foo nofoo
Sets boolean values foo=true foo=false.
EXAMPLES
In the following examples, prtr can be any name up to 14
characters and can be the same name as the ping(1M) name.
Example 1 Configuring an HP Postscript Printer with a Jet
Direct Network Interface
The following example configures an HP postscript printer
with a jet direct network interface:
example# lpadmin -p prtr -v /dev/null -m netstandard \
SunOS 5.11 Last change: 24 May 2006 19
System Administration Commands lpadmin(1M)
-o dest=pingnameofprtr:9100 -o protocol=tcp -T PS -I \
postscript
example# enable prtr
example# accept prtr
Example 2 Configuring a Standard Postscript Network Printer
The following example configures a standard postscript net-
work printer:
example# lpadmin -p prtr -v /dev/null -m netstandard \
-o dest=pingnameofprtr -T PS -I postscript
example# enable prtr
example# accept prtr
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero An error occurred.
FILES
/var/spool/lp/*
/etc/lp
/etc/lp/alerts/printer Fault handler for lpadmin
/etc/printers.conf System printer configuration data-
base
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 24 May 2006 20
System Administration Commands lpadmin(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWpcu
Interface Stability Obsolete
SEE ALSO
enable(1), lp(1), lpstat(1), mail(1), stty(1), accept(1M),
lpforms(1M), lpsched(1M), lpsystem(1M), ping(1M),
dial(3NSL), terminfo(4), attributes(5)
NOTES
When using lpadmin to provide access to a remote printer,
remote configuration data is stored in /etc/printers.conf.
This data includes a bsdaddr and a printer-uri-supported
attribute. The data in this file can be shared through the
use of a network name service or replicated across multiple
systems. If the data is shared, it is important to make sure
that the bsdaddr and printer-uri-supported contain hostname
information that is correctly resolved on all hosts sharing
this data. Also, the printer-uri-supported is the preferred
means of accessing remote print service. The bsdaddr is sup-
plied for backward compatability with Solaris 2.6-10 sys-
tems.
SunOS 5.11 Last change: 24 May 2006 21
|
