-a PrinterSystemDNSName | PrinterSystemAddress |
Associates a DNS name or network address with the system.
If the argument given can be interpreted as an IPv4 or IPv6 address, it is
an address, if not it is assumed to be a DNS name. The -a flag causes the
network entity object specified by -s to be modified,
or else created if it does not already exist. The administrator should ensure
that network entity objects are given unique names, so as to avoid modifying
existing UNIX system objects instead of adding new print system objects. This
flag requires the -s flag. |
-A [ mail | none ] |
Instructs the print system to generate a mail message
if a print request fails. The mail is sent to the owner of the physical printer,
or to the root user of the system hosting the print queue, if the printer
has no owner or the user has no mail address. The default is none. This flag requires the -q flag. |
-D QueueDescription |
Defines a description comment for the print queue object
specified with the -q flag. This description is displayed
whenever a user asks for a full description of a print queue using the lpstat command. Strings containing whitespace should be
double quoted. This flag requires the -q flag. |
-F FaultRecovery |
Defines the print queue's fault recovery mode. This
flag specifies the recovery to be used if the printer on a print queue fails
while printing a print request. The value of FaultRecovery can be any of the following:
- 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.
- beginning
- Start printing the request again from the beginning.
- wait
- Disable printing on PhysicalPrinterName 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. If
no change request is made before printing is enabled, printing resumes at
the top of the page where it stopped, if the filter allows; otherwise, the
request is printed from the beginning.
The default value of FaultRecovery is beginning. This flag requires the -q flag. |
-h |
Displays a brief help screen. |
-i InterfaceScript |
Pathname for the printer's InterfaceScript when accessed through the specified print queue. This flag is not valid
if the -P flag has not been specified. The interface
scripts are usually supplied by the user. This flag cannot be used when -m has also been specified. This flag requires both the -q and the -P flags. |
-I ContentType[, ContentType, ...] |
Specifies the print queue's content types. Allows the
print queue to handle print requests with the content types in the list. If
the list contains more than one ContentType, the ContentType parameters must be separated by commas. See
the lpadmin manual page for a full description of the
format. This also requires the -P flag and the -q flag. |
-l Location |
Defines the printer's location. This is a string identifying
where a printer is physically located, for example "Building X, Room 6". It
can be searched on by the dslpsearch command. Once set,
this value can only be overwritten, not removed. This flag requires the -P flag. |
-L PDL[, PDL, ...] |
Specifies the list of Page Description Languages (PDLs)
supported by the printer. This is used to advertise any PDL the printer supports,
and can be searched on, using the dslpsearch command.
The AUTOSW, PCL, PCLXL, POSTSCRIPT, TEXT, ESCP, PJL, SIMPLE, and OTHER PDLs are supported. If the -L flag is used to modify an existing physical printer object, the list
replaces the existing list. This flag requires the -P flag. |
-m [ standard | PS ] |
Model interface program for the printer when accessed
through the specified print queue. It selects the model interface script to
be used by the print queue. When a physical printer object is being created,
and neither the -m nor the -i flag
has been specified, the default is standard. This flag
cannot be used when -i has also been specified. This
flag requires both the -q and the -P flags. |
-n LocalQueueName |
Defines the local name of a print queue. This name normally
only differs from the queue's RDN when the queue is on a non-directory-enabled
host. It is used by incoming remote network connections to identify the print
queue on the receiving system. The default value is the print queue's RDN.
This flag requires the -q flag. |
-o [ banner | nobanner ] |
Defines if a banner page will always be produced by
this print queue. The default value, banner, forces
a banner page to be printed for all print requests, whereas nobanner allows the user to submit a print job specifying that no banner
page is to be printed. This flag requires the -q flag. |
-o PrintOption=Value[, ...] |
Specifies values for print options. See the lpadmin documentation for a detailed description of the print options
available with the -o flag. This flag requires both
the -q and the -P flags. |
-P PhysicalPrinterName |
Create or modify a physical printer object. The PhysicalPrinterName argument specifies the RDN of a printer
object. If the object does not already exist, dslpadmin creates
it. |
-q PrintQueueName |
dlspadmin Creates or modifies
a print queue object. The PrintQueueName argument
specifies the RDN of a print queue object. When adding a new print queue,
you must specify the -s and -P flags
so the command knows the NetworkEntityName and PhysicalPrinterName for the print queue being added. If
the print queue object does not exist, dslpadmin creates
it.
A command line can contain any combinations of the -q, -P and -sflags , or any
combination of the -x, -X and -r flags, but only one of each flag. When multiple directory
objects are simultaneously created or modified, appropriate links are set
up between the three object types (printers, print queues and network entities). |
-r NetworkEntityName |
Delete the network entity system object. Care needs
to be taken not to delete a non-printer system object. It is the responsibility
of the administrator to ensure that the correct object is deleted. |
-s NetworkEntityName |
Specifies the network entity system object that hosts
the print queue. If -a is also given, the object is
created or modified. The NetworkEntityName argument
specifies the RDN of an object in the current directory context. The network
entity object defines the network address that remote clients need to use
to access the print queue. |
-t [ BSD | HPNP ] |
Defines the print protocol used by this "networked printer"
print queue. Retry and timeout values are set to their default values for
a networked printer. To change these values, the dslpprotocol command should be used. Note that this flag should only be used for
networked printers supporting the BSD or HPNP protocol. This flag requires
the -q flag. |
-T PrinterType[, PrinterType, ...] |
List of printer types. It identifies the printer as
being of one or more printer types, for example "hplaserjet". See the lpadmin manual page for details. This flag requires the -P flag. |
-u PhysicalPrinterName |
Unlinks the named physical printer from the print queue
(specified with the -q flag) without deleting its object.
This flag requires the -q flag. |
-U ObjectRDN |
Unlinks either the physical printer or the print queue
object (specified by ObjectRDN) from the print queue
(specified with the -q flag), without deleting its object.
This flag requires the -q flag. |
-x PrintQueueName |
Delete a print queue object. |
-X PhysicalPrinterName |
Delete a physical printer object. |