Maintenance Commands                                    lpset(1M)

NAME
     lpset - set printing configuration in /etc/printers.conf  or
     FNS

SYNOPSIS
     lpset [ -n system | nisplus  | 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,
     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]
           Creates or updates the configuration information   for
           the    destination    entry   in   /etc/printers.conf,
           printers.org_dir (NIS+), or FNS printer contexts. sys-
           tem  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. 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,  printers.org_dir  (NIS+),  or
           FNS.

     -a key=value
           Configures the specified key=value pair for the desti-
           nation  entry in /etc/printers.conf, printers.org_dir,
           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
     The following operand is supported:

     destination

SunOS 5.8           Last change: 10 Nov 1999                    1

Maintenance Commands                                    lpset(1M)

           Specifies   the    entry    in     /etc/printers.conf,
           printers.org_dir,  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

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:

SunOS 5.8           Last change: 10 Nov 1999                    2

Maintenance Commands                                    lpset(1M)

     ____________________________________________________________
    |       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),  nsswitch.conf(4), printers(4), printers.conf(4),
     attributes(5), fns(5), standards(5)

SunOS 5.8           Last change: 10 Nov 1999                    3