| blob | d790018360ce72d4d86e698c244a68a34499d19d |
1 '\" te
2 .\" Copyright (C) 2006, 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 PRINTERS 4 "Feb 25, 2017"
7 .SH NAME
8 printers \- user-configurable printer alias database
9 .SH SYNOPSIS
10 .LP
11 .nf
12 $HOME/.printers
13 .fi
15 .SH DESCRIPTION
16 .LP
17 The \fB$HOME/.printers\fR file is a simplified version of the system
18 \fB/etc/printers.conf\fR file. See \fBprinters.conf\fR(4). Users create the
19 \fB$HOME/.printers\fR file in their home directory. This optional file is
20 customizable by the user.
21 .sp
22 .LP
23 The \fB$HOME/.printers\fR file performs the following functions:
24 .RS +4
25 .TP
26 1.
27 Sets personal aliases for all print commands.
28 .RE
29 .RS +4
30 .TP
31 2.
32 Sets the interest list for the \fBlpget\fR, \fBlpstat\fR, and \fBcancel\fR
33 commands. See \fBlpget\fR(1M), \fBlpstat\fR(1) and \fBcancel\fR(1).
34 .RE
35 .RS +4
36 .TP
37 3.
38 Sets the default printer for the \fBlp\fR, \fBlpr\fR, \fBlpq\fR, and
39 \fBlprm\fR commands. See \fBlp\fR(1), \fBlpr\fR(1B), \fBlpq\fR(1B), and
40 \fBlprm\fR(1B).
41 .RE
42 .SS "Entries"
43 .LP
44 Use a line or full screen editor to create or modify the \fB$HOME/.printers\fR
45 file.
46 .sp
47 .LP
48 Each entry in \fB$HOME/.printers\fR describes one destination. Entries are one
49 line consisting of two fields separated by either BLANKs or TABs and terminated
50 by a NEWLINE. Format for an entry in \fB$HOME/.printers\fR varies according to
51 the purpose of the entry.
52 .sp
53 .LP
54 Empty lines can be included for readability. Entries can continue on to
55 multiple lines by adding a backslash (`\fB\e\fR\&') as the last character in
56 the line. The \fB$HOME/.printers\fR file can include comments. Comments have a
57 pound sign (`\fB#\fR') as the first character in the line, and are terminated
58 by a NEWLINE.
59 .SS "Setting Personal Aliases"
60 .LP
61 Specify the alias or aliases in the first field. Separate multiple aliases by a
62 pipe sign (`\fB|\fR'). Specify the destination in the second field. A
63 destination names a printer or class of printers, See \fBlpadmin\fR(1M).
64 Specify the destination using atomic, URI-style
65 (\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style
66 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
67 information regarding the naming conventions for destination names.
68 .SS "Setting the Interest List for lpget, lpstat and cancel"
69 .LP
70 Specify \fB_all\fR in the first field. Specify the list of destinations for the
71 interest list in the second field. Separate each destinations by a comma
72 (`\fB,\fR'). Specify destinations using atomic, URI-style
73 (\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style
74 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
75 information regarding the naming conventions for destination names. This list
76 of destinations can refer to an alias defined in \fB$HOME/.printers\fR.
77 .SS "Setting the Default Destination"
78 .LP
79 Specify \fB_default\fR in the first field. Specify the default destination in
80 the second field. Specify the default destination using atomic, URI-style
81 (\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style
82 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
83 information regarding the naming conventions for destination names. The default
84 destination can refer to an alias defined in \fB$HOME/.printers\fR.
85 .SS "Locating Destination Information"
86 .LP
87 The print client commands locate destination information based on the
88 "printers" database entry in the \fB/etc/nsswitch.conf\fR file. See
89 \fBnsswitch.conf\fR(4).
90 .SS "Locating the Personal Default Destination"
91 .LP
92 The default destination is located differently depending on the command.
93 .sp
94 .LP
95 The \fBlp\fR command locates the default destination in the following order:
96 .RS +4
97 .TP
98 1.
99 \fBlp\fR command's \fB-d\fR \fIdestination\fR option.
100 .RE
101 .RS +4
102 .TP
103 2.
104 \fBLPDEST\fR environment variable.
105 .RE
106 .RS +4
107 .TP
108 3.
109 \fBPRINTER\fR environment variable.
110 .RE
111 .RS +4
112 .TP
113 4.
114 \fB_default\fR destination in \fB$HOME/.printers\fR.
115 .RE
116 .RS +4
117 .TP
118 5.
119 \fB_default\fR destination in \fB/etc/printers.conf\fR.
120 .RE
121 .sp
122 .LP
123 The \fBlpr\fR, \fBlpq\fR, and \fBlprm\fR commands locate the default
124 destination in the following order:
125 .RS +4
126 .TP
127 1.
128 \fBlpr\fR command's \fB-P\fR \fIdestination\fR option.
129 .RE
130 .RS +4
131 .TP
132 2.
133 \fBPRINTER\fR environment variable.
134 .RE
135 .RS +4
136 .TP
137 3.
138 \fBLPDEST\fR environment variable.
139 .RE
140 .RS +4
141 .TP
142 4.
143 \fB_default\fR destination in \fB$HOME/.printers\fR.
144 .RE
145 .RS +4
146 .TP
147 5.
148 \fB_default\fR destination in \fB/etc/printers.conf\fR.
149 .RE
150 .SS "Locating the Interest List for lpget, lpstat, and cancel"
151 .LP
152 The \fBlpget\fR, \fBlpstat\fR, and \fBcancel\fR commands locate the interest
153 list in the following order:
154 .RS +4
155 .TP
156 1.
157 \fB_all\fR list in \fB$HOME/.printers\fR.
158 .RE
159 .RS +4
160 .TP
161 2.
162 \fB_all\fR list in \fB/etc/printers.conf\fR.
163 .RE
164 .SH EXAMPLES
165 .LP
166 \fBExample 1 \fRSetting the Interest List
167 .sp
168 .LP
169 The following entry sets the interest list to destinations \fBps\fR,
170 \fBsecure\fR, and \fBdog\fR at server \fBwest\fR and \fBfinance_ps\fR:
172 .sp
173 .in +2
174 .nf
175 \fB_all ps,secure,west:dog,lpd://server/printers/queue\fR
176 .fi
177 .in -2
178 .sp
180 .LP
181 \fBExample 2 \fRSetting Aliases to a Printer
182 .sp
183 .LP
184 The following entry sets the aliases \fBps\fR, \fBlp\fR, and \fBlw\fR to
185 \fBsparc_printer\fR:
187 .sp
188 .in +2
189 .nf
190 \fBps|lp|lw sparc_printer\fR
191 .fi
192 .in -2
193 .sp
195 .LP
196 \fBExample 3 \fRSetting an Alias as a Default Destination
197 .sp
198 .LP
199 The following entry sets the alias \fBpcl\fR to \fBhplj\fR and sets it as the
200 default destination:
202 .sp
203 .in +2
204 .nf
205 \fBpcl|_default hplj\fR
206 .fi
207 .in -2
208 .sp
210 .LP
211 \fBExample 4 \fRSetting an Alias to a Server Destination
212 .sp
213 .LP
214 The following entry sets the alias \fBsecure\fR to destination \fBcatalpa\fR at
215 server \fBtabloid\fR:
217 .sp
218 .in +2
219 .nf
220 \fBsecure tabloid:catalpa\fR
221 .fi
222 .in -2
223 .sp
225 .LP
226 \fBExample 5 \fRSetting an Alias to a Site Destination
227 .sp
228 .LP
229 The following entry sets the alias \fBinsecure\fR to destination \fBlegal_ps\fR
230 using IPP:
232 .sp
233 .in +2
234 .nf
235 \fBinsecure ipp://server/printers/legal_ps\fR
236 .fi
237 .in -2
238 .sp
240 .SH FILES
241 .ne 2
242 .na
243 \fB\fB/etc/printers.conf\fR\fR
244 .ad
245 .RS 24n
246 System printer configuration database
247 .RE
249 .sp
250 .ne 2
251 .na
252 \fB\fB$HOME/.printers\fR\fR
253 .ad
254 .RS 24n
255 User-configurable printer database
256 .RE
258 .sp
259 .ne 2
260 .na
261 \fB\fBou=printers\fR\fR
262 .ad
263 .RS 24n
264 LDAP version of \fB/etc/printers.conf\fR
265 .RE
267 .sp
268 .ne 2
269 .na
270 \fB\fBprinters.conf.byname\fR\fR
271 .ad
272 .RS 24n
273 \fBNIS\fR version of \fB/etc/printers.conf\fR
274 .RE
276 .SH ATTRIBUTES
277 .LP
278 See \fBattributes\fR(5) for descriptions of the following attributes:
279 .sp
281 .sp
282 .TS
283 box;
284 c | c
285 l | l .
286 ATTRIBUTE TYPE ATTRIBUTE VALUE
287 _
288 Interface Stability Stable
289 .TE
291 .SH SEE ALSO
292 .LP
293 \fBcancel\fR(1), \fBlp\fR(1), \fBlpq\fR(1B), \fBlpr\fR(1B), \fBlprm\fR(1B),
294 \fBlpstat\fR(1), \fBlpadmin\fR(1M), \fBlpget\fR(1M), \fBnsswitch.conf\fR(4),
295 \fBprinters.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)
296 .sp
297 .LP
298 \fISystem Administration Guide: Basic Administration\fR
299 .SH NOTES
300 .LP
301 \fB$HOME/.printers\fR is referenced by the printing commands before further
302 name resolution is made in \fB/etc/printers.conf\fR or the name service. If the
303 alias references a destination defined in \fB/etc/printers.conf\fR, it is
304 possible that the destination is defined differently on different systems. This
305 could cause output to be sent to an unintended destination if the user is
306 logged in to a different system.