lpget(1M)						  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, print-
       ers.conf.byname, and printers.org_dir printer.  This information, called a configuration 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. Destination can be either a printer of a class  of  printers.	See  lpad-
		       min(1M).  Specify destination using atomic or POSIX-style (server:destination) names. See printers.conf(4) for information
		       regarding the naming conventions for atomic names and standards(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 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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpcu			   |
       +-----------------------------+-----------------------------+
       |Stability Level 	     |Stable			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ldap(1), lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), lpset(1M), printers(4), printers.conf(4), attributes(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 master. Refer to the System Adminis-
       tration Guide: Naming and Directory Services (DNS, NIS, and LDAP) for more information on LDAP replication.

SunOS 5.10							    23 May 2003 							 lpget(1M)