FreeBSD Manual Pages
lpset(1M) System Administration Commands lpset(1M) NAME lpset - set printing configuration in /etc/printers.conf or other sup- ported 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 sys- tem configuration databases. Use lpset to create and update printing configuration in /etc/printers.conf, printers.org_dir (NIS+), or Feder- ated 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 destina- tion 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 destination. See printers.conf(4) for information regarding the specification of key=value pairs. -d key Delete the configuration option specified by key for the desti- nation 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 cur- rent 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. destina- tion names a printer of class of printers. See lpadmin(1M). Each entry in printers.conf describes one destination. Specify desti- nation using atomic or Federated Naming Service (FNS) (.../ser- vice/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 configuration in- formation 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 attributes: +-----------------------------+-----------------------------+ | 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), print- ers.conf(4), attributes(5), fns(5), standards(5) System Administration Guide: Naming and Directory Services 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 ex- tracted from the ldapclient(1M) configuration, the LDAP server being updated must host the same domain that is used by the current ldap- client(1M) server. 2. If the LDAP server being updated is a replica LDAP server, the up- dates 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 repli- cation. 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 or the Solaris Print Manager, printmgr(1M) may be unpredictable. SunOS 5.9 6 Aug 2001 lpset(1M)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lpset&sektion=1m&manpath=SunOS+5.9>