usr/src/man/man1m/lpget.1m

   1 '\" te
   2 .\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH LPGET 1M "May 23, 2003"
   7 .SH NAME
   8 lpget \- get printing configuration
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBlpget\fR [\fB-k\fR \fIkey\fR] [\fIdestination\fR... | list]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBlpget\fR utility reads printing configuration information from the
  19 configuration databases in \fB$HOME/.printers\fR, \fB/etc/printers.conf\fR,
  20 \fBprinters.conf.byname\fR, and \fBprinters.org_dir\fR printer. This
  21 information, called a \fIconfiguration report\fR, is displayed to the standard
  22 output. See \fBprinters\fR(4) and \fBprinters.conf\fR(4) for information about
  23 the printer configuration databases.
  24 .sp
  25 .LP
  26 \fBlpget\fR displays a configuration report for all keys for the specified
  27 destination or destinations by default. Use the \fB-k\fR option  to display a
  28 configuration report for specific keys. Use the \fBlist\fR operand to display a
  29 configuration report for all configured destinations.
  30 .SH OPTIONS
  31 .sp
  32 .LP
  33 The following option is supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-k\fR \fIkey\fR\fR
  38 .ad
  39 .RS 10n
  40 Displays a configuration report for \fIkey\fR. See \fBprinters.conf\fR(4) for
  41 information about specifying  \fIkey\fR.
  42 .RE
  43
  44 .SH OPERANDS
  45 .sp
  46 .LP
  47 The following operands are supported:
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fIdestination\fR\fR
  52 .ad
  53 .RS 15n
  54 Displays a configuration report for  \fIdestination\fR. Destination can be
  55 either a printer of a class of printers. See \fBlpadmin\fR(1M). Specify
  56 \fIdestination\fR using atomic or POSIX-style
  57 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf \fR(4) for
  58 information regarding the naming conventions for atomic names and
  59 \fBstandards\fR(5) for information concerning POSIX.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fBlist\fR\fR
  66 .ad
  67 .RS 15n
  68 Displays a configuration report for all configured destinations.
  69 .RE
  70
  71 .SH EXAMPLES
  72 .LP
  73 \fBExample 1 \fRDisplaying a Configuration Report for the \fBbsdaddr\fR Key
  74 .sp
  75 .LP
  76 The following example displays a configuration report for the  \fBbsdaddr\fR
  77 key for printer \fBcatalpa\fR.
  78
  79 .sp
  80 .in +2
  81 .nf
  82 example% \fBlpget -k bsdaddr catalpa\fR
  83 .fi
  84 .in -2
  85 .sp
  86
  87 .LP
  88 \fBExample 2 \fRA Configuration Report for all Keys for all Configured
  89 Destinations
  90 .sp
  91 .LP
  92 The following example displays a configuration report for all keys for all
  93 configured destinations.
  94
  95 .sp
  96 .in +2
  97 .nf
  98 example% \fBlpget list\fR
  99 .fi
 100 .in -2
 101 .sp
 102
 103 .SH EXIT STATUS
 104 .sp
 105 .LP
 106 The following exit values are returned:
 107 .sp
 108 .ne 2
 109 .na
 110 \fB\fB0\fR\fR
 111 .ad
 112 .RS 12n
 113 Successful completion.
 114 .RE
 115
 116 .sp
 117 .ne 2
 118 .na
 119 \fBnon-zero\fR
 120 .ad
 121 .RS 12n
 122 An error occurred.
 123 .RE
 124
 125 .SH FILES
 126 .sp
 127 .ne 2
 128 .na
 129 \fB\fB/etc/printers.conf\fR\fR
 130 .ad
 131 .RS 24n
 132 System printer configuration database.
 133 .RE
 134
 135 .sp
 136 .ne 2
 137 .na
 138 \fB\fB$HOME/.printers\fR \fR
 139 .ad
 140 .RS 24n
 141 User-configurable printer database.
 142 .RE
 143
 144 .sp
 145 .ne 2
 146 .na
 147 \fB\fBprinters.conf.byname\fR\fR
 148 .ad
 149 .RS 24n
 150 \fBNIS\fR version of \fB/etc/printers.conf\fR.
 151 .RE
 152
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fBprinters.org_dir\fR\fR
 157 .ad
 158 .RS 24n
 159 \fBNIS+\fR version of \fB/etc/printers.conf\fR.
 160 .RE
 161
 162 .SH ATTRIBUTES
 163 .sp
 164 .LP
 165 See \fBattributes\fR(5) for descriptions of the following attributes:
 166 .sp
 167
 168 .sp
 169 .TS
 170 box;
 171 c | c
 172 l | l .
 173 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 174 _
 175 Stability Level Stable
 176 .TE
 177
 178 .SH SEE ALSO
 179 .sp
 180 .LP
 181 \fBldap\fR(1), \fBlp\fR(1), \fBlpc\fR(1B), \fBlpq\fR(1B), \fBlpr\fR(1B),
 182 \fBlpstat\fR(1), \fBlpadmin \fR(1M), \fBlpset\fR(1M), \fBprinters\fR(4),
 183 \fBprinters.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)
 184 .sp
 185 .LP
 186 \fI\fR
 187 .SH NOTES
 188 .sp
 189 .LP
 190 Be mindful of the following if the LDAP database is used as the name service.
 191 If the \fBldapclient\fR(1M) server is a replica LDAP server, LDAP printer
 192 database updates may not appear immediately, as the replica server may not not
 193 have been updated by the master server and can be out of sync. For example, a
 194 printer that you deleted by using \fBlpset\fR(1M) may still appear in the
 195 printer list you display with \fBlpget\fR until the replica is updated from the
 196 master. Replica servers vary as to how often they are updated from the master.
 197 Refer to the \fI\fR for more information on LDAP replication.