lpset(1M)
NAME
lpset - set printing configuration in /etc/printers.conf or
other supported databases
SYNOPSIS
lpset [-n system | nisplus | fns | ldap] [-x] [ [-D
binddn] [-w passwd] [-h ldaphost]] [-a key=value] [-d key]
destination
DESCRIPTION
The lpset utility sets printing configuration information in
the system configuration databases. Use lpset to create and
update printing configuration in /etc/printers.conf,
printers.org_dir (NIS+), or Federated Naming System (FNS).
See nsswitch.conf(4), printers.conf(4), and fns(5).
Only a superuser or a member of Group 14 may execute lpset.
OPTIONS
The following options are supported:
-n system|nisplus|fns|ldap
Create or update the configuration information for
the destination entry in /etc/printers.conf,
printers.org_dir (NIS+), LDAP or FNS printer contexts.
system specifies that the information is created or
updated in /etc/printers.conf. nisplus specifies that
the information is created or updated in the
printers.org_dir NIS+ table. ldap specifies that the
information is written to an LDAP server. See NOTES.
fns specifies that the information is written using
federated naming context.
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 desti-
nation. See printers.conf(4) for information regard-
ing the specification of key=value pairs.
-d key
Delete the configuration option specified by key for
the destination entry. See printers.conf(4) 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 speci-
fied as the naming service. If this option is not
specified, the default is the current host system.
OPERANDS
The following operand is supported:
destination
Specifies the entry in /etc/printers.conf,
printers.org_dir, LDAP, or FNS, in which to create or
modify information. destination names a printer of
class of printers. See lpadmin(1M). Each entry in
printers.conf describes one destination. Specify des-
tination using atomic or Federated Naming Service
(FNS) (.../service/printer/...) names. POSIX-style
destination names are not acceptable. See
printers.conf(4) for information regarding the naming
conventions for atomic and FNS names and standards(5)
for information regarding POSIX.
EXAMPLES
Example 1: Removing All Existing Printing Configuration
Information
The following example removes all existing printing confi-
guration information for destination dogs from
/etc/printers.conf:
example% lpset -x dogs
Example 2: Setting a key=value Pair
The following example sets the user-equivalence =true
key=value pair for destination tabloid in FNS context:
example% lpset -n fns -a user-equivalence=true tabloid
Example 3: Setting a key=value Pair in LDAP
example% lpset -n ldap -h ldapl.xyz.com -D "cn=Directory Manager" \
-w passwd -a key1=value1 printer1
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero
An error occurred.
FILES
/etc/printers.conf
System configuration database.
printer.org_dir (NIS+)
NIS+ version of /etc/printers.conf.
fns.ctx_dir.domain
FNS version of /etc/printers.conf.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWpcu |
|_____________________________|_____________________________|
| Stability Level | Stable |
|_____________________________|_____________________________|
SEE ALSO
ldap(1), lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1),
ldapclient(1M), lpadmin(1M), lpget(1M), nsswitch.conf(4),
printers(4), printers.conf(4), attributes(5), fns(5), stan-
dards(5)
System Administration Guide: Naming and Directory Services
(DNS, NIS, and LDAP)
NOTES
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(1M) configura-
tion, the LDAP server being updated must host the same
domain that is used by the current ldapclient(1M) 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 immediatedly, 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: Advanced
Administration for information on LDAP server replica-
tion.
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. Oth-
erwise, if the ldapadd and ldapmodify utilities are used,
the administrator must ensure that the printer-name
attribute value is unique within the ou=printers con-
tainer on the LDAP server. If the value is not unique,
the result of modifications done using lpset or the
Solaris Print Manager, printmgr(1M) may be unpredictable.
Man(1) output converted with
man2html