Maintenance Commands                                    lpget(1M)

NAME
     lpget - get printing configuration

SYNOPSIS
     lpget [ -k key ]  [ destination ... | list ]

DESCRIPTION
     The lpget utility reads printing  configuration  information
     from   the   configuration   databases  in  $HOME/.printers,
     /etc/printers.conf, printers.conf.byname,  printers.org_dir,
     and  FNS printer contexts. This information (called a confi-
     guration report) is displayed to the  standard  output.  See
     printers(4)  and  printers.conf(4) for information about the
     printer configuration databases.

     lpget displays a configuration report for all keys  for  the
     specified destination or destinations by default. Use the -k
     option  to display a configuration report for specific keys.
     Use  the  list operand to display a configuration report for
     all configured destinations.

OPTIONS
     The following option is supported:

     -k key
           Displays  a  configuration   report   for   key.   See
           printers.conf(4) for information about specifying
            key.

OPERANDS
     The following operands are supported:

     destination
           Displays a configuration report for  destination. Des-
           tination  can  be  either  a  printer  of  a  class of
           printers,  (see  lpadmin(1M)).   Specify   destination
           using  atomic,  POSIX-style  (server:destination),  or
           Federated         Naming         Service         (FNS)
           (.../service/printer/...)  names.   See  printers.conf
           (4) for information regarding the  naming  conventions
           for  atomic and FNS names, and standards(5) for infor-
           mation concerning POSIX.

     list  Displays a configuration  report  for  all  configured
           destinations.

EXAMPLES
     Example 1: Displaying a configuration report for the
      bsdaddr key

     The following example displays a  configuration  report  for
     the  bsdaddr key for printer catalpa.

SunOS 5.8           Last change: 10 Nov 1999                    1

Maintenance Commands                                    lpget(1M)

     example% lpget -k bsdaddr catalpa

     Example 2: A configuration report for all keys for
      all configured destinations

     The following example displays a  configuration  report  for
     all keys for   all configured destinations.

     example% lpget list

EXIT STATUS
     The following exit values are returned:

     0     Successful completion.

     non-zero
           An error occurred.

FILES
     /etc/printers.conf
           System printer configuration database.

     $HOME/.printers
           User-configurable printer database.

     printers.conf.byname
           NIS version of /etc/printers.conf.

     printers.org_dir
           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:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpcu                     |
    |_____________________________|_____________________________|
    | Stability Level             | Stable                      |
    |_____________________________|_____________________________|

SEE ALSO
     lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1),  lpadmin  (1M),
     lpset(1M),   printers(4),  printers.conf(4),  attributes(5),
     standards(5)

SunOS 5.8           Last change: 10 Nov 1999                    2