System Administration 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,         and
     printers.orgdir  printer. 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  destina-
                    tion.  Destination can be either a printer of
                    a class of printers. See lpadmin(1M). Specify
                    destination   using   atomic  or  POSIX-style
                    (server:destination) names. See printers.conf
                    (4) for information regarding the naming con-
                    ventions for atomic  names  and  standards(5)
                    for information concerning POSIX.


     list           Displays a configuration report for all  con-
                    figured destinations.


EXAMPLES
     Example 1 Displaying a Configuration Report for the  bsdaddr
     Key




SunOS 5.11          Last change: 23 May 2003                    1






System Administration Commands                          lpget(1M)



     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  data-
                             base.


     $HOME/.printers         User-configurable printer database.


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


     printers.orgdir        NIS] version of /etc/printers.conf.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:









SunOS 5.11          Last change: 23 May 2003                    2






System Administration Commands                          lpget(1M)



     
           ATRIBUTE TYPE               ATRIBUTE 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)


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  for more information on LDAP replication.





























SunOS 5.11          Last change: 23 May 2003                    3