lpset

 

---

 
 
 
 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
 
 
 

---