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 stan-
           dards(5) for information 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.

     example% lpget -k bsdaddr catalpa

     Example 2: A Configuration Report for all Keys for all  Con-
     figured 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

     ldap(1), lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1),  lpad-
     min  (1M),  lpset(1M), printers(4), printers.conf(4), attri-
     butes(5), standards(5)

     System Administration Guide: Naming and  Directory  Services
     (DNS, NIS, and LDAP)

NOTES

     Be mindful of the following if the LDAP database is used  as
     the  name service. If the ldapclient(1M) server is a replica
     LDAP server, LDAP printer database updates  may  not  appear
     immediately,  as  the  replica  server may not not have been
     updated by the master server and can be  out  of  sync.  For
     example,  a  printer that you deleted by using lpset(1M) 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  mas-
     ter.  Refer  to  the System Administration Guide: Naming and
     Directory Services (DNS, NIS, and LDAP) for more information
     on LDAP replication.