Windows PowerShell command on Get-command lpadmin

Manual Pages for UNIX Operating System command usage for man lpadmin

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: printer_name,

date, file_name. The file_name 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 ASCII 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 LINEFEED 12 Move to beginning of

SunOS 5.11 Last change: 24 May 2006 6

System Administration Commands lpadmin(1M)

(newline) next line FORMFEED 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 PPD file for creating and modifying printer queues. ppdfilename is the full path and file name to

the PPD 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] (UUCP 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:

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=ping_name_of_prtr: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=ping_name_of_prtr -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

ATTRIBUTES

See attributes(5) for descriptions of the following attri-

butes:

SunOS 5.11 Last change: 24 May 2006 20

System Administration Commands lpadmin(1M)

______________________________________________________________

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

|_____________________________|_______________________________|

| Availability | print/lp/print-client-commands|

|_____________________________|_______________________________|

| Interface Stability | Obsolete |

|_____________________________|_______________________________|

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

Manual Pages for UNIX Operating System command usage for man lpadmin

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]

DESCRIPTION

lpadmin configures the LP print service by defining printers

The lpadmin command has options for:

System Administration Commands lpadmin(1M)

The first form of the lpadmin command (lpadmin -p printer

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

The -T option must be invoked first with lpadmin to

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

The -T option must be invoked first with lpadmin to

System Administration Commands lpadmin(1M)

with this option; by default, lpadmin

System Administration Commands lpadmin(1M)

lpadmin and lp commands, and the -S and -f options of

the lpadmin command.

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

# lpadmin -p queue -v smb://smb-service/printer -m uri

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

System Administration Commands lpadmin(1M)

lpadmin -p printername -o length=

lpadmin -p printername -o width=

lpadmin -p printername -o cpi=

lpadmin -p printername -o lpi=

lpadmin -p printername -o stty=

System Administration Commands lpadmin(1M)

lpadmin -p printername -o protocol=

lpadmin -p printername -o bsdctrl=

lpadmin -p printername -o timeout=

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

System Administration Commands lpadmin(1M)

lpadmin -p printername -o key=

lpadmin -p printer -o foo | nofoo

EXAMPLES

example# lpadmin -p prtr -v /dev/null -m netstandard \

System Administration Commands lpadmin(1M)

example# lpadmin -p prtr -v /dev/null -m netstandard \

/etc/lp/alerts/printer Fault handler for lpadmin

ATTRIBUTES

System Administration Commands lpadmin(1M)

| ATTRIBUTE TYPE | ATTRIBUTE VALUE |

SEE ALSO

When using lpadmin to provide access to a remote printer,