1 .\"
   2 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for
   3 .\" permission to reproduce portions of its copyrighted documentation.
   4 .\" Original documentation from The Open Group can be obtained online at
   5 .\" http://www.opengroup.org/bookstore/.
   6 .\"
   7 .\" The Institute of Electrical and Electronics Engineers and The Open
   8 .\" Group, have given us permission to reprint portions of their
   9 .\" documentation.
  10 .\"
  11 .\" In the following statement, the phrase ``this text'' refers to portions
  12 .\" of the system documentation.
  13 .\"
  14 .\" Portions of this text are reprinted and reproduced in electronic form
  15 .\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
  16 .\" Standard for Information Technology -- Portable Operating System
  17 .\" Interface (POSIX), The Open Group Base Specifications Issue 6,
  18 .\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
  19 .\" Engineers, Inc and The Open Group.  In the event of any discrepancy
  20 .\" between these versions and the original IEEE and The Open Group
  21 .\" Standard, the original IEEE and The Open Group Standard is the referee
  22 .\" document.  The original Standard can be obtained online at
  23 .\" http://www.opengroup.org/unix/online.html.
  24 .\"
  25 .\" This notice shall appear on any product containing this material.
  26 .\"
  27 .\" The contents of this file are subject to the terms of the
  28 .\" Common Development and Distribution License (the "License").
  29 .\" You may not use this file except in compliance with the License.
  30 .\"
  31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  32 .\" or http://www.opensolaris.org/os/licensing.
  33 .\" See the License for the specific language governing permissions
  34 .\" and limitations under the License.
  35 .\"
  36 .\" When distributing Covered Code, include this CDDL HEADER in each
  37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  38 .\" If applicable, add the following below this CDDL HEADER, with the
  39 .\" fields enclosed by brackets "[]" replaced with your own identifying
  40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  41 .\"
  42 .\"
  43 .\" Copyright 1989 AT&T
  44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
  45 .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved
  46 .\"
  47 .TH LP 1 "Feb 25, 2017"
  48 .SH NAME
  49 lp \- submit print request
  50 .SH SYNOPSIS
  51 .LP
  52 .nf
  53 \fBlp\fR [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR] [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR]
  54      [\fB-H\fR \fIspecial-handling\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR]
  55      [\fB-P\fR \fIpage-list\fR] [\fB-q\fR \fIpriority-level\fR]
  56      [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR] [\fB-t\fR \fItitle\fR]
  57      [\fB-T\fR \fIcontent-type\fR [\fB-r\fR]] [\fB-y\fR \fImode-list\fR] [\fIfile\fR]...
  58 .fi
  59 
  60 .LP
  61 .nf
  62 \fBlp\fR \fB-i\fR \fIrequest-ID\fR... [\fB-c\fR] [\fB-m\fR] [\fB-p\fR] [\fB-s\fR] [\fB-w\fR]
  63      [\fB-d\fR \fIdestination\fR] [\fB-f\fR \fIform-name\fR] [\fB-H\fR \fIspecial-handling\fR]
  64      [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIoption\fR] [\fB-P\fR \fIpage-list\fR]
  65      [\fB-q\fR \fIpriority-level\fR] [\fB-S\fR \fIcharacter-set\fR | \fIprint-wheel\fR]
  66      [\fB-t\fR \fItitle\fR] [\fB-T\fR \fIcontent-type\fR [\fB-r\fR]] [\fB-y\fR \fImode-list\fR]
  67 .fi
  68 
  69 .SH DESCRIPTION
  70 .LP
  71 The \fBlp\fR utility submits print requests to a destination. There are two
  72 formats of the \fBlp\fR command.
  73 .sp
  74 .LP
  75 The first form of \fBlp\fR prints files (\fIfile\fR) and associated information
  76 (collectively called a \fIprint request\fR). If \fIfile\fR is not specified,
  77 \fBlp\fR assumes the standard input. Use a hyphen (\fB\(mi\fR) with \fIfile\fR
  78 to specify the standard input. Files are printed in the order in which they
  79 appear on the command line.
  80 .sp
  81 .LP
  82 The second form of \fBlp\fR changes print request options. This form of
  83 \fBlp\fR can only be used with print services and protocols that support job
  84 modification. The LP print service allows print requests to be modified when
  85 they are in a queue local to the system that the lp commands was executed on.
  86 The Internet Print Protocol (IPP) allows job modification on remote ipp print
  87 services.
  88 .sp
  89 .LP
  90 The print request identified by \fIrequest-ID\fR is changed according to the
  91 printing options specified. The printing options available are the same as
  92 those with the first form of the \fBlp\fR. If the request has finished printing
  93 when the \fBlp\fR command is executed, the change is rejected. If the request
  94 is in the process of printing, it is stopped and restarted from the beginning
  95 (unless the \fB-P\fR option has been given).
  96 .sp
  97 .LP
  98 The print client commands locate destination information using the "printers"
  99 database in the name service switch. See \fBnsswitch.conf\fR(4),
 100 \fBprinters\fR(4), and \fBprinters.conf\fR(4) for details.
 101 .SH OPTIONS
 102 .LP
 103 Printers that have a 4.\fIx\fR or \fBBSD-based print server\fR are not
 104 configured to handle \fBBSD\fR protocol extensions. \fBlp\fR handles print
 105 requests sent to such destinations differently (see NOTES).
 106 .sp
 107 .LP
 108 The following options are supported:
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB-c\fR\fR
 113 .ad
 114 .RS 23n
 115 Copies \fIfile\fR before printing.
 116 .sp
 117 Unless \fB-c\fR is specified, users should not remove any \fIfile\fR before the
 118 print request has completely printed. Changes made to \fIfile\fR after the
 119 print request is made but before it is printed might be reflected in the
 120 printed output. \fIfile\fR is linked (as opposed to copied).
 121 .RE
 122 
 123 .sp
 124 .ne 2
 125 .na
 126 \fB\fB-d\fR \fIdestination\fR\fR
 127 .ad
 128 .RS 23n
 129 Prints \fIfile\fR on a specific destination. The \fB-d\fR option is used to set
 130 the destination only when the job is first created. (\fBNote:\fR To move
 131 existing jobs to a different destination, see \fBlpmove\fR(1M).)
 132 \fIdestination\fR can be either a printer or a class of printers (see
 133 \fBlpadmin\fR(1M)). Specify \fIdestination\fR using atomic, URI-style
 134 (\fIscheme\fR://\fIendpoint\fR), or POSIX-style
 135 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
 136 more information.
 137 .RE
 138 
 139 .sp
 140 .ne 2
 141 .na
 142 \fB\fB-f\fR \fIform-name\fR\fR
 143 .ad
 144 .RS 23n
 145 Prints \fIfile\fR on \fIform-name\fR. The \fBLP\fR print service ensures that
 146 the form is mounted on the printer. The print request is rejected if the
 147 printer does not support \fIform-name\fR, if \fIform-name\fR is not defined for
 148 the system, or if the user is not allowed to use \fIform-name\fR (see
 149 \fBlpforms\fR(1M)).
 150 .RE
 151 
 152 .sp
 153 .ne 2
 154 .na
 155 \fB\fB-H\fR \fIspecial-handling\fR\fR
 156 .ad
 157 .RS 23n
 158 Prints the print request according to the value of \fIspecial-handling\fR. The
 159 following \fIspecial-handling\fR values are acceptable:
 160 .sp
 161 .ne 2
 162 .na
 163 \fB\fBhold\fR\fR
 164 .ad
 165 .RS 13n
 166 Do not print the print request until notified. If printing has already begun,
 167 stop it. Other print requests are placed ahead of a request that has been put
 168 on hold (\fIheld print request\fR) until the print request is resumed.
 169 .RE
 170 
 171 .sp
 172 .ne 2
 173 .na
 174 \fB\fBresume\fR\fR
 175 .ad
 176 .RS 13n
 177 Resume a held print request. If the print request had begun to print when held,
 178 it is the next print request printed, unless it is superseded by an
 179 \fIimmediate\fR print request.
 180 .RE
 181 
 182 .sp
 183 .ne 2
 184 .na
 185 \fB\fBimmediate\fR\fR
 186 .ad
 187 .RS 13n
 188 Print the print request next. If more than one print request is assigned, the
 189 most recent print request is printed next. If a print request is currently
 190 printing on the desired printer, a \fBhold\fR request must be issued to allow
 191 the immediate request to print. The \fBimmediate\fR request is only available
 192 to \fBLP\fR administrators.
 193 .RE
 194 
 195 .RE
 196 
 197 .sp
 198 .ne 2
 199 .na
 200 \fB\fB-i\fR \fIrequest-ID\fR\fR
 201 .ad
 202 .RS 23n
 203 Changes options for the print request identified by \fIrequest-ID\fR. There
 204 must be a space between \fB-i\fR and \fIrequest-ID\fR.
 205 .sp
 206 This option applies to jobs that are in a local queue on a print server. This
 207 also applies to remote queues on when the remote print server supports IPP with
 208 job modification.
 209 .RE
 210 
 211 .sp
 212 .ne 2
 213 .na
 214 \fB\fB-m\fR\fR
 215 .ad
 216 .RS 23n
 217 Sends mail after \fIfile\fR has printed (see \fBmail\fR(1)). By default, no
 218 mail is sent upon normal completion of a print request.
 219 .RE
 220 
 221 .sp
 222 .ne 2
 223 .na
 224 \fB\fB-n\fR \fInumber\fR\fR
 225 .ad
 226 .RS 23n
 227 Prints a specific number of copies of \fIfile\fR. Specify \fInumber\fR as a
 228 digit. The default for \fInumber\fR is \fB1\fR.
 229 .RE
 230 
 231 .sp
 232 .ne 2
 233 .na
 234 \fB\fB-o\fR \fIoption\fR\fR
 235 .ad
 236 .RS 23n
 237 Specifies printer-dependent \fIoptions\fR. Specify several options by
 238 specifying \fB-o\fR \fIoption\fR multiple times (\fB-o\fR \fIoption\fR \fB-o\fR
 239 \fIoption\fR \fB-o\fR \fIoption\fR ). Printer-dependent options can also be
 240 specified using the \fB-o\fR keyletter once, followed by a list of options
 241 enclosed in double quotes (\fB-o\fR"\fIoption\fR \fIoption option\fR").
 242 .sp
 243 \fIoption\fRs take the following forms:
 244 .sp
 245 .ne 2
 246 .na
 247 \fB\fIkey\fR\fB=\fR\fIvalue\fR\fR
 248 .ad
 249 .RS 13n
 250 Associates information with the request for use by the backend print service.
 251 The keys and values that can be used are specific to the backend print service
 252 and queue configuration.
 253 .RE
 254 
 255 .sp
 256 .ne 2
 257 .na
 258 \fB\fB[no]key\fR\fR
 259 .ad
 260 .RS 13n
 261  Associates boolean information with the request for use by the backend print
 262 service. The keys that can be used are specific to the backend print service
 263 and queue configuration.
 264 .RE
 265 
 266 The following options are commonly used with the LP print service:
 267 .sp
 268 .ne 2
 269 .na
 270 \fB\fBnobanner\fR\fR
 271 .ad
 272 .sp .6
 273 .RS 4n
 274 Does not print a banner page with the request. This option can be disallowed by
 275 the \fBLP\fR administrator.
 276 .sp
 277 On a system that is configured with Trusted Extensions, use of this option
 278 requires the \fBsolaris.print.nobanner\fR authorization.
 279 .RE
 280 
 281 .sp
 282 .ne 2
 283 .na
 284 \fB\fBnofilebreak\fR\fR
 285 .ad
 286 .sp .6
 287 .RS 4n
 288 Prints multiple files without inserting a form feed between them.
 289 .RE
 290 
 291 .sp
 292 .ne 2
 293 .na
 294 \fB\fBnolabels\fR\fR
 295 .ad
 296 .sp .6
 297 .RS 4n
 298 On a system that is configured with Trusted Extensions, specifies suppression
 299 of page header and footer labels. Use of this option requires the
 300 \fBsolaris.print.unlabeled\fR authorization.
 301 .RE
 302 
 303 .sp
 304 .ne 2
 305 .na
 306 \fB\fBlength=\fR\fInumber\fR\fBi\fR | \fInumber\fR\fBc\fR | \fInumber\fR\fR
 307 .ad
 308 .sp .6
 309 .RS 4n
 310 Prints the print request with pages of a specific length in inches,
 311 centimeters, or number of lines. Append the letter \fBi\fR for inches or
 312 \fBc\fR for centimeters to \fInumber\fR. Indicate the number of lines by
 313 specifying \fInumber\fR alone. \fBlength=66\fR indicates a page length of
 314 \fB66\fR lines. \fBlength=11i\fR indicates a page length of \fB11\fR inches.
 315 \fBlength=27.94c\fR indicates a page length of \fB27.94\fR centimeters.
 316 .sp
 317 This option can not be used with the \fB-f\fR option.
 318 .RE
 319 
 320 .sp
 321 .ne 2
 322 .na
 323 \fB\fBwidth=\fR\fInumber\fR\fBi\fR | \fInumber\fR\fBc\fR | \fInumber\fR\fR
 324 .ad
 325 .sp .6
 326 .RS 4n
 327 Prints the print request with pages of a specific width in inches, centimeters,
 328 or number of columns. Append the letter \fBi\fR for inches or \fBc\fR for
 329 centimeters to \fInumber\fR. Indicate the number of columns by specifying
 330 \fInumber\fR alone. \fBwidth=65\fR indicates a page width of \fB65\fR columns.
 331 \fBwidth=6.5i\fR indicates a page width of \fB6.5\fR inches. \fBwidth=10c\fR
 332 indicates a page width of \fB10\fR centimeters.
 333 .sp
 334 This option can not be used with the \fB-f\fR option.
 335 .RE
 336 
 337 .sp
 338 .ne 2
 339 .na
 340 \fB\fBlpi=\fR\fInumber\fR\fR
 341 .ad
 342 .sp .6
 343 .RS 4n
 344 Prints the print request with the line pitch set to \fInumber\fR lines in an
 345 inch. Use \fInumber\fR to specify the number of lines in an inch.
 346 .sp
 347 This option can not be used with the \fB-f\fR option.
 348 .RE
 349 
 350 .sp
 351 .ne 2
 352 .na
 353 \fB\fBcpi=\fR\fIn\fR|\fBpica\fR|\fBelite\fR|\fBcompressed\fR\fR
 354 .ad
 355 .sp .6
 356 .RS 4n
 357 Prints the print request with the character pitch set to \fInumber\fR
 358 characters in an inch. Use \fInumber\fR to specify the number of characters in
 359 an inch. Use \fBpica\fR to set character pitch to pica (\fB10\fR characters per
 360 inch), or \fBelite\fR to set character pitch to elite (\fB12\fR characters per
 361 inch) Use \fBcompressed\fR to set character pitch to as many characters as the
 362 printer can handle. There is no standard number of characters per inch for all
 363 printers; see the \fBterminfo\fR database (see \fBterminfo\fR(4)) for the
 364 default character pitch for your printer. This option can not be used with the
 365 \fB-f\fR option.
 366 .RE
 367 
 368 .sp
 369 .ne 2
 370 .na
 371 \fB\fBstty=\fR\fIstty-option-list\fR\fR
 372 .ad
 373 .sp .6
 374 .RS 4n
 375 Prints the request using a list of options valid for the \fBstty\fR command
 376 (see \fBstty\fR(1). Enclose the list in single quotes (\fB`'\fR) if it contains
 377 blanks.
 378 .RE
 379 
 380 .RE
 381 
 382 .sp
 383 .ne 2
 384 .na
 385 \fB\fB-P\fR \fIpage-list\fR\fR
 386 .ad
 387 .RS 23n
 388 Prints the pages specified in \fIpage-list\fR in ascending order. Specify
 389 \fIpage-list\fR as a of range of numbers, single page number, or a combination
 390 of both.
 391 .sp
 392 The \fB-P\fR option can only be used if there is a filter available to handle
 393 it; otherwise, the print request is rejected.
 394 .RE
 395 
 396 .sp
 397 .ne 2
 398 .na
 399 \fB\fB-p\fR\fR
 400 .ad
 401 .RS 23n
 402 Enables notification on completion of the print request. Delivery of the
 403 notification is dependent on additional software.
 404 .RE
 405 
 406 .sp
 407 .ne 2
 408 .na
 409 \fB\fB-q\fR \fIpriority-level\fR\fR
 410 .ad
 411 .RS 23n
 412 Assigns the print request a priority in the print queue. Specify
 413 \fIpriority-level\fR as an integer between from \fB0\fR and \fB39\fR. Use
 414 \fB0\fR to indicate the highest priority; \fB39\fR to indicate the lowest
 415 priority. If no priority is specified, the default priority for a print service
 416 is assigned by the \fBLP\fR administrator. The \fBLP\fR administrator can also
 417 assign a default priority to individual users.
 418 .RE
 419 
 420 .sp
 421 .ne 2
 422 .na
 423 \fB\fB-s\fR\fR
 424 .ad
 425 .RS 23n
 426 Suppresses the display of messages sent from \fBlp\fR.
 427 .RE
 428 
 429 .sp
 430 .ne 2
 431 .na
 432 \fB\fB-S\fR \fIcharacter-set\fR \fB|\fR\fR
 433 .ad
 434 .br
 435 .na
 436 \fB\fB-S\fR \fIprint-wheel\fR\fR
 437 .ad
 438 .RS 23n
 439 Prints the request using the \fIcharacter-set\fR or \fIprint-wheel\fR. If a
 440 form was requested and requires a character set or print wheel other than the
 441 one specified with the \fB-S\fR option, the request is rejected. Printers using
 442 mountable print wheels or font cartridges use the print wheel or font cartridge
 443 mounted at the time of the print request, unless the \fB-S\fR option is
 444 specified.
 445 .sp
 446 Printers Using Print Wheels: If \fBprint\fR \fIwheel\fR is not one listed by
 447 the \fBLP\fR administrator as acceptable for the printer the request is
 448 rejected unless the print wheel is already mounted on the printer.
 449 .sp
 450 Printers Using Selectable or Programmable Character Sets: If the \fB-S\fR
 451 option is not specified, \fBlp\fR uses the standard character set. If
 452 \fIcharacter-set\fR is not defined in the \fBterminfo\fR database for the
 453 printer (see \fBterminfo\fR(4)), or is not an alias defined by the \fBLP\fR
 454 administrator, the request is rejected.
 455 .RE
 456 
 457 .sp
 458 .ne 2
 459 .na
 460 \fB\fB-t\fR \fItitle\fR\fR
 461 .ad
 462 .RS 23n
 463 Prints a title on the banner page of the output. Enclose \fItitle\fR in quotes
 464 if it contains blanks. If \fItitle\fR is not not specified, the name of the
 465 file is printed on the banner page.
 466 .RE
 467 
 468 .sp
 469 .ne 2
 470 .na
 471 \fB\fB\fR\fB-T\fR\fIcontent-type\fR [\fB-r\fR]\fR
 472 .ad
 473 .RS 23n
 474 Prints the request on a printer that can support the specified
 475 \fIcontent-type\fR. If no printer accepts this type directly, a filter is used
 476 to convert the content into an acceptable type. If the \fB-r\fR option is
 477 specified, a filter is not used. If \fB-r\fR is specified, and no printer
 478 accepts the \fIcontent-type\fR directly, the request is rejected. If the
 479 \fIcontent-type\fR is not acceptable to any printer, either directly or with a
 480 filter, the request is rejected.
 481 .RE
 482 
 483 .sp
 484 .ne 2
 485 .na
 486 \fB\fB-w\fR\fR
 487 .ad
 488 .RS 23n
 489 Writes a message on the user's terminal after the \fIfile\fRs have been
 490 printed. If the user is not logged in, then mail is sent instead.
 491 .RE
 492 
 493 .sp
 494 .ne 2
 495 .na
 496 \fB\fB-y\fR \fImode-list\fR\fR
 497 .ad
 498 .RS 23n
 499 Prints the request according to the printing modes listed in \fImode-list\fR.
 500 The allowed values for \fImode-list\fR are locally defined.
 501 .sp
 502 This option can be used only if there is a filter available to handle it;
 503 otherwise, the print request is rejected.
 504 .RE
 505 
 506 .SH OPERANDS
 507 .LP
 508 The following operand is supported:
 509 .sp
 510 .ne 2
 511 .na
 512 \fB\fIfile\fR\fR
 513 .ad
 514 .RS 8n
 515 The name of the file to be printed. Specify \fIfile\fR as a pathname or as a
 516 hyphen (\fB\(mi\fR) to indicate the standard input. If \fIfile\fR is not
 517 specified, \fBlp\fR uses the standard input.
 518 .RE
 519 
 520 .SH USAGE
 521 .LP
 522 See \fBlargefile\fR(5) for the description of the behavior of \fBlp\fR when
 523 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
 524 .SH ENVIRONMENT VARIABLES
 525 .LP
 526 See \fBenviron\fR(5) for descriptions of the following environment variables
 527 that affect the execution of \fBlp\fR: \fBLANG\fR, \fBLC_ALL\fR,
 528 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBNLSPATH\fR, and \fBPATH\fR.
 529 .sp
 530 .ne 2
 531 .na
 532 \fB\fBLC_TIME\fR\fR
 533 .ad
 534 .RS 11n
 535 Determine the format and contents of date and time strings displayed in the
 536 \fBlp\fR banner page, if any.
 537 .RE
 538 
 539 .sp
 540 .ne 2
 541 .na
 542 \fB\fBLPDEST\fR\fR
 543 .ad
 544 .RS 11n
 545 Determine the destination. If the \fBLPDEST\fR environment variable is not set,
 546 the \fBPRINTER\fR environment variable shall be used. The \fB-d\fR \fIdest\fR
 547 option takes precedence over \fBLPDEST\fR. Results are undefined when \fB-d\fR
 548 is not specified and \fBLPDEST\fR contains a value that is not a valid
 549 destination name.
 550 .RE
 551 
 552 .sp
 553 .ne 2
 554 .na
 555 \fB\fBPRINTER\fR\fR
 556 .ad
 557 .RS 11n
 558 Determine the output device or destination. If the \fBLPDEST\fR and
 559 \fBPRINTER\fR environment variables are not set, an unspecified output device
 560 is used. The \fB-d\fR \fIdest\fR option and the \fBLPDEST\fR environment
 561 variable shall take precedence over \fBPRINTER\fR. Results are undefined when
 562 \fB-d\fR is not specified, \fBLPDEST\fR is unset, and \fBPRINTER\fR contains a
 563 value that is not a valid device or destination name.
 564 .RE
 565 
 566 .sp
 567 .ne 2
 568 .na
 569 \fB\fBTZ\fR\fR
 570 .ad
 571 .RS 11n
 572 Determine the timezone used to calculate date and time strings displayed in the
 573 \fBlp\fR banner page, if any. If \fBTZ\fR is unset or null, an unspecified
 574 default timezone shall be used.
 575 .RE
 576 
 577 .SH EXIT STATUS
 578 .LP
 579 The following exit values are returned:
 580 .sp
 581 .ne 2
 582 .na
 583 \fB\fB0\fR\fR
 584 .ad
 585 .RS 12n
 586 Successful completion.
 587 .RE
 588 
 589 .sp
 590 .ne 2
 591 .na
 592 \fBnon-zero\fR
 593 .ad
 594 .RS 12n
 595 An error occurred.
 596 .RE
 597 
 598 .SH FILES
 599 .ne 2
 600 .na
 601 \fB\fB/etc/printers.conf\fR\fR
 602 .ad
 603 .RS 24n
 604 System printer configuration database
 605 .RE
 606 
 607 .sp
 608 .ne 2
 609 .na
 610 \fB\fB$HOME/.printers\fR\fR
 611 .ad
 612 .RS 24n
 613 User-configurable printer database
 614 .RE
 615 
 616 .sp
 617 .ne 2
 618 .na
 619 \fB\fBou=printers\fR\fR
 620 .ad
 621 .RS 24n
 622 LDAP version of \fB/etc/printers.conf\fR
 623 .RE
 624 
 625 .sp
 626 .ne 2
 627 .na
 628 \fB\fBprinters.conf.byname\fR\fR
 629 .ad
 630 .RS 24n
 631 \fBNIS\fR version of \fB/etc/printers.conf\fR
 632 .RE
 633 
 634 .SH ATTRIBUTES
 635 .LP
 636 See \fBattributes\fR(5) for descriptions of the following attributes:
 637 .sp
 638 
 639 .sp
 640 .TS
 641 box;
 642 c | c
 643 l | l .
 644 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 645 _
 646 CSI     Enabled. See \fBNOTES\fR.
 647 _
 648 Interface Stability     Standard
 649 .TE
 650 
 651 .SH SEE ALSO
 652 .LP
 653 \fBcancel\fR(1), \fBenable\fR(1), \fBlpq\fR(1B), \fBlpr\fR(1B), \fBlprm\fR(1B),
 654 \fBlpstat\fR(1), \fBmail\fR(1), \fBpostprint\fR(1), \fBpr\fR(1), \fBstty\fR(1),
 655 \fBaccept\fR(1M), \fBlpadmin\fR(1M), \fBlpfilter\fR(1M), \fBlpforms\fR(1M),
 656 \fBlpmove\fR(1M), \fBlpsched\fR(1M), \fBlpshut\fR(1M), \fBlpsystem\fR(1M),
 657 \fBlpusers\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4),
 658 \fBprinters.conf\fR(4), \fBterminfo\fR(4), \fBattributes\fR(5),
 659 \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
 660 .SH NOTES
 661 .LP
 662 \fBCSI\fR-capability assumes that printer names are composed of \fBASCII\fR
 663 characters.
 664 .sp
 665 .LP
 666 Print jobs are assumed to contain one type of data. That type of data is either
 667 specified on the command line or autodetected (simple, PostScript) based on the
 668 contents of the first file in the job.
 669 .sp
 670 .LP
 671 When using the BSD printing protocol to send print requests to a remote print
 672 service, functionality is limited.
 673 .sp
 674 .LP
 675 Printers that have a 4.\fIx\fR or BSD-based print server are not configured to
 676 handle BSD protocol extensions. \fBlp\fR handles print requests sent to such
 677 printers in the following ways:
 678 .RS +4
 679 .TP
 680 1.
 681 Print requests with more than 52 filenames are truncated to 52 files.
 682 .RE
 683 .RS +4
 684 .TP
 685 2.
 686 The \fB-f\fR, \fB-H\fR, \fB-o\fR, \fB-P\fR, \fB-p\fR, \fB-q\fR, \fB-S\fR,
 687 \fB-T\fR, and \fB-y\fR options might require a protocol extension to pass to a
 688 print server. If \fBlp\fR cannot handle the print request, it displays a
 689 warning message.
 690 .sp
 691 \fBLP\fR administrators enable protocol extensions by setting a printer's
 692 \fBprinter-uri-supported\fR (or \fBbsdaddr\fR) entry in
 693 \fB/etc/printers.conf\fR. Changing the \fBprinter-uri-supported\fR entry in
 694 \fB/etc/printers.conf\fR to:
 695 .sp
 696 .in +2
 697 .nf
 698 \fBprinter-uri-supported=lpd\e://\fR\fIserver\fR\fB/\fR\fIprinters\fR\fB/\fR\fIdestination\fR\fB#Solaris\fR
 699 .fi
 700 .in -2
 701 .sp
 702 
 703 .sp
 704 .in +2
 705 .nf
 706 \fBbsdaddr=\fR\fIserver\fR\fB,\fR\fIdestination\fR\fB,Solaris\fR
 707 .fi
 708 .in -2
 709 .sp
 710 
 711 Adding \fBSolaris\fR to either of these values causes the \fBlp\fR command to
 712 generate a set of BSD print protocol extensions that can be processed by a
 713 Solaris print server.
 714 .RE
 715 .sp
 716 .LP
 717 As a result of several limitations in the BSD print protocol, it is recommended
 718 that the IPP protocol be used for communication with print servers.
 719 .sp
 720 .LP
 721 When IPP is in use, the user is prompted for a passphrase if the remote print
 722 service is configured to require authentication.