LPSET(8) Maintenance Commands and Procedures LPSET(8)

NAME

lpset - set printing configuration in /etc/printers.conf or other
supported databases

SYNOPSIS

lpset [-n system | 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. See nsswitch.conf(5)
and printers.conf(5).


Only a superuser or a member of Group 14 may execute lpset.

OPTIONS

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.

OPERANDS

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.

EXAMPLES

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

EXIT STATUS

The following exit values are returned:

0
Successful completion.


non-zero
An error occurred.

FILES

/etc/printers.conf
System configuration database.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+----------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+----------------+-----------------+
|Stability Level | Stable |
+----------------+-----------------+

SEE ALSO

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)

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(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.

March 12, 2023 LPSET(8)