lpset(1M)
NAME
lpset − set printing configuration in /etc/printers.conf or FNS
SYNOPSIS
lpset [ −n system | fns ] [ −x ] [ −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 Federated Naming System (FNS). See printers.conf(4) and fns(5).
Only a superuser or a member of Group 14 may execute lpset.
OPTIONS
[−n system|fns]
Creates or updates the configuration information for the destination entry in /etc/printers.conf or FNS. system specifies that the information is created or updated in /etc/printers.conf. fns specifies that the information is written using federated naming context.
If −n is not specified, system is the default.
−x Removes all configuration for the destination entry in /etc/printers.conf or FNS.
−a key=value Configures the specified key=value pair for the destination entry in /etc/printers.conf or FNS. See printers.conf(4) for information regarding the specification of key=value pairs.
−d key Deletes the configuration option specified by key for the destination entry in /etc/printers.conf or FNS. See printers.conf(4) for information regarding the specification of key and key=value pairs.
OPERANDS
destination Specifies the entry in /etc/printers.conf 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 destination 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
The following example removes all existing printing configuration information for destination dogs from /etc/printers.conf.
example% lpset -x dogs
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
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero An error occurred.
FILES
/etc/printers.conf System configuration database.
$HOME/.printers User-configurable printer database.
printer.conf.byname (NIS) NIS version of /etc/printers.conf.
fns.ctx_dir.domain NIS+ 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
lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), lpget(1M), printers(4), printers.conf(4), attributes(5), fns(5), standards(5)
SunOS 5.6 — Last change: 13 Mar 1997