lpset - set printing configuration in /etc/printers.conf or other
supported databases
lpset [-n system | fnsldap] [-x]
[ [-D binddn] [-w passwd] [-h ldaphost]]
[-a key=value] [-d key] destination
The lpset utility sets printing configuration information
in the system configuration databases. Use lpset to create and update
printing configuration in /etc/printers.conf. See
nsswitch.conf(5) and printers.conf(5).
Only a superuser or a member of Group 14 may execute
lpset.
The following options are supported:
-n system|ldap
Create or update the configuration information for the
destination entry in
/etc/printers.conf or LDAP printer
contexts.
system specifies that the information is created or updated
in
/etc/printers.conf.
ldap specifies that the information is
written to an LDAP server.
If -n is not specified, system is the default.
-x
Remove all configuration for the destination entry
from the database specified by the -n option.
-a key=value
Configure the specified
key=value
pair for the
destination. See
printers.conf(5) for information
regarding the specification of
key=value pairs.
-d key
Delete the configuration option specified by
key
for the
destination entry. See
printers.conf(5) for information
regarding the specification of
key and
key=value
pairs.
-D binddn
Use the distinguished name (DN) binddn to bind to
the LDAP directory server.
-w passwd
Use passwd as the password for authentication to
the LDAP directory server.
-h ldaphost
Specify an alternate host on which the LDAP server is
running. This option is only used when ldap is specified as the naming
service. If this option is not specified, the default is the current host
system.
The following operand is supported:
destination
Specifies the entry in
/etc/printers.conf or LDAP,
in which to create or modify information.
destination names a printer
of class of printers. See
lpadmin(8). Each entry in
printers.conf describes one destination. Specify
destination
using atomic names. POSIX-style destination names are not acceptable. See
printers.conf(5) for information regarding the naming conventions for
atomic names and
standards(7) for information regarding POSIX.
Example 1 Removing All Existing Printing Configuration
Information
The following example removes all existing printing configuration
information for destination dogs from /etc/printers.conf:
example% lpset -x dogs
Example 2 Setting a key=value Pair in LDAP
example% lpset -n ldap -h ldapl.example.com -D "cn=Directory Manager" \
-w passwd -a key1=value1 printer1
The following exit values are returned:
0
Successful completion.
non-zero
An error occurred.
/etc/printers.conf
System configuration database.
See attributes(7) for descriptions of the following
attributes:
| ATTRIBUTE
TYPE |
ATTRIBUTE VALUE |
| Stability Level |
Stable |
ldap(1), lp(1), lpstat(1), lpc(1B),
lpq(1B), lpr(1B), nsswitch.conf(5), printers(5),
printers.conf(5), attributes(7), standards(7),
ldapclient(8), lpadmin(8), lpget(8)
If the ldap database is used, the printer administrator
should be mindful of the following when updating printer information.
- 1.
- Because the domain information for the printer being updated is extracted
from the ldapclient(8) configuration, the LDAP server being updated
must host the same domain that is used by the current ldapclient(8)
server.
- 2.
- If the LDAP server being updated is a replica LDAP server, the updates
will be referred to the master LDAP server and completed there. The
updates might be out of sync and not appear immediately, as the replica
server may not have been updated by the master server. For example, a
printer that you deleted by using lpset may still appear in the
printer list you display with lpget until the replica is updated
from the master. Replica servers vary as to how often they are updated
from the master. See System Administration Guide: Solaris
Printing for information on LDAP server replication.
- 3.
- Although users can use the LDAP command line utilities ldapadd(1)
and ldapmodify(1) to update printer entries in the directory, the
preferred method is to use lpset. Otherwise, if the ldapadd
and ldapmodify utilities are used, the administrator must ensure
that the printer-name attribute value is unique within the
ou=printers container on the LDAP server. If the value is not
unique, the result of modifications done using lpset may be
unpredictable.