System Administration Commands lpset(1M)
NAME
lpset - set printing configuration in /etc/printers.conf or
other supported databases
SYNOPSIS
lpset [-n system nisplus fnsldap] [-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, or
printers.orgdir (NIS]). See nsswitch.conf(4) and
printers.conf(4).
Only a superuser or a member of Group 14 may execute lpset.
OPTIONS
The following options are supported:
-n systemnisplusldap Create or update the configuration
information for the destination
entry in /etc/printers.conf,
printers.orgdir (NIS]), or LDAP
printer contexts. system specifies
that the information is created or
updated in /etc/printers.conf.
nisplus specifies that the infor-
mation is created or updated in
the printers.orgdir NIS] table.
ldap specifies that the informa-
tion is written to an LDAP server.
See .
If -n is not specified, system is
the default.
-x Remove all configuration for the
destination entry from the data-
base specified by the -n option.
-a key=value Configure the specified key=value
pair for the destination. See
printers.conf(4) for information
regarding the specification of
key=value pairs.
SunOS 5.11 Last change: 23 May 2003 1
System Administration Commands lpset(1M)
-d key Delete the configuration option
specified by key for the destina-
tion 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 direc-
tory server.
-w passwd Use passwd as the password for
authentication to the LDAP direc-
tory 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.
OPERANDS
The following operand is supported:
destination Specifies the entry in /etc/printers.conf,
printers.orgdir, or LDAP, 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 destina-
tion using atomic names. POSIX-style destina-
tion names are not acceptable. See
printers.conf(4) for information regarding
the naming conventions for atomic 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:
SunOS 5.11 Last change: 23 May 2003 2
System Administration Commands lpset(1M)
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 the NIS] context:
example% lpset -n nisplus -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.orgdir (NIS]) NIS] version of
/etc/printers.conf.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 23 May 2003 3
System Administration Commands lpset(1M)
ATRIBUTE TYPE ATRIBUTE 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), standards(5)
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)
configuration, 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 mas-
ter. See System Administration Guide: Solaris
Printing for information on LDAP server replica-
tion.
3. Although users can use the LDAP command line utili-
ties ldapadd(1) and ldapmodify(1) to update printer
entries in the directory, the preferred method is
to use lpset. Otherwise, if the ldapadd and ldapmo-
dify 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 or the Solaris Print
Manager, printmgr(1M) may be unpredictable.
SunOS 5.11 Last change: 23 May 2003 4
|
