doc/help/ref-printers-conf.html

   1 <HTML>
   2 <!-- SECTION: References -->
   3 <HEAD>
   4         <TITLE>printers.conf</TITLE>
   5 </HEAD>
   6 <BODY>
   7
   8 <P>The CUPS scheduler (cupsd) uses the
   9 <VAR>/etc/cups/printers.conf</VAR> file to store the list of
  10 available printers. This file contains only locally defined
  11 printers, not remote printers that are created automatically via
  12 browsing. Each directive is listed on a line by itself followed
  13 by its value. Comments are introduced using the number sign ("#")
  14 character at the beginning of a line.</P>
  15
  16 <P>While the printer configuration file consists of plain text
  17 and can be modified using your favorite text editor, you should
  18 normally use the <A HREF="man-lpadmin.html">lpadmin(8)</A>
  19 command, web interface, or any of the available GUIs to manage
  20 your printers instead. If you do choose to edit this file
  21 manually, you will need to restart the scheduler to make them
  22 active.</P>
  23
  24
  25 <H2 CLASS="title"><A NAME="Accepting">Accepting</A></H2>
  26
  27 <H3>Examples</H3>
  28
  29 <PRE CLASS="command">
  30 &lt;Printer name&gt;
  31   ...
  32   Accepting yes
  33 &lt;/Printer&gt;
  34 </PRE>
  35
  36 <H3>Description</H3>
  37
  38 <P>The <CODE>Accepting</CODE> directive defines the initial state
  39 of the <VAR>printer-is-accepting-jobs</VAR> attribute. This state
  40 is also set by the <CODE>cupsaccept(8)</CODE> and
  41 <CODE>cupsreject(8)</CODE> commands:</P>
  42
  43 <PRE CLASS="command">
  44 <KBD>/usr/sbin/cupsaccept printername
  45 /usr/sbin/cupsreject printername</KBD>
  46 </PRE>
  47
  48 <P>This directive must appear inside a <A
  49 HREF="#Printer"><CODE>Printer</CODE></A> or <A
  50 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
  51 section.</P>
  52
  53
  54 <H2 CLASS="title"><A NAME="AllowUser">AllowUser</A></H2>
  55
  56 <H3>Examples</H3>
  57
  58 <PRE CLASS="command">
  59 &lt;Printer name&gt;
  60   ...
  61   AllowUser foo_user
  62   AllowUser @bar_group
  63 &lt;/Printer&gt;
  64 </PRE>
  65
  66 <H3>Description</H3>
  67
  68 <P>The <CODE>AllowUser</CODE> directive adds a username or group
  69 name to the <VAR>requesting-user-name-allowed</VAR> attribute
  70 which can be set by the <CODE>lpadmin(8)</CODE> command:</P>
  71
  72 <PRE CLASS="command">
  73 <KBD>/usr/sbin/lpadmin -p printername -u allow:foo_user,@bar_group</KBD>
  74 </PRE>
  75
  76 <P>This directive must appear inside a <A
  77 HREF="#Printer"><CODE>Printer</CODE></A> or <A
  78 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> directive.
  79 This directive cannot be used with <A
  80 HREF="#DenyUser"><CODE>DenyUser</CODE></A>.</P>
  81
  82
  83 <H2 CLASS="title"><A NAME="DefaultPrinter">DefaultPrinter</A></H2>
  84
  85 <H3>Examples</H3>
  86
  87 <PRE CLASS="command">
  88 &lt;DefaultPrinter name&gt;
  89   ...
  90 &lt;/Printer&gt;
  91 </PRE>
  92
  93 <H3>Description</H3>
  94
  95 <P>The <CODE>DefaultPrinter</CODE> directive begins a printer
  96 definition as the default server destination. The default server
  97 destination can be set using the <CODE>lpadmin(8)</CODE>
  98 command:</P>
  99
 100 <PRE CLASS="command">
 101 <KBD>/usr/sbin/lpadmin -d printername</KBD>
 102 </PRE>
 103
 104 <P>Note that the server default destination settings can be
 105 overridden by the user's default destination settings which are
 106 normally set using the <CODE>lpoptions(1)</CODE> command.</P>
 107
 108
 109 <H2 CLASS="title"><A NAME="DenyUser">DenyUser</A></H2>
 110
 111 <H3>Examples</H3>
 112
 113 <PRE CLASS="command">
 114 &lt;Printer name&gt;
 115   ...
 116   DenyUser foo_user
 117   DenyUser @bar_group
 118 &lt;/Printer&gt;
 119 </PRE>
 120
 121 <H3>Description</H3>
 122
 123 <P>The <CODE>DenyUser</CODE> directive adds a username or group
 124 name to the <VAR>requesting-user-name-denied</VAR> attribute
 125 which can be set by the <CODE>lpadmin(8)</CODE> command:</P>
 126
 127 <PRE CLASS="command">
 128 <KBD>/usr/sbin/lpadmin -p printername -u deny:foo_user,@bar_group</KBD>
 129 </PRE>
 130
 131 <P>This directive must appear inside a <A
 132 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 133 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> directive.
 134 This directive cannot be used with <A
 135 HREF="#AllowUser"><CODE>AllowUser</CODE></A></P>
 136
 137
 138 <H2 CLASS="title"><A NAME="DeviceURI">DeviceURI</A></H2>
 139
 140 <H3>Examples</H3>
 141
 142 <PRE CLASS="command">
 143 &lt;Printer name&gt;
 144   ...
 145   DeviceURI socket://foo.bar.com:9100
 146 &lt;/Printer&gt;
 147 </PRE>
 148
 149 <H3>Description</H3>
 150
 151 <P>The <CODE>DeviceURI</CODE> directive defines the value of the
 152 <VAR>device-uri-attribute</VAR> attribute. It is normally set
 153 using the <CODE>lpadmin(8)</CODE> command:</P>
 154
 155 <PRE CLASS="command">
 156 <KBD>/usr/sbin/lpadmin -p printername -v device-uri</KBD>
 157 </PRE>
 158
 159 <P>This directive must appear inside a <A
 160 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 161 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 162 section.</P>
 163
 164
 165 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="ErrorPolicy">ErrorPolicy</A></H2>
 166
 167 <H3>Examples</H3>
 168
 169 <PRE CLASS="command">
 170 &lt;Printer name&gt;
 171   ...
 172   ErrorPolicy abort-job
 173 &lt;/Printer&gt;
 174 </PRE>
 175
 176 <H3>Description</H3>
 177
 178 <P>The <CODE>ErrorPolicy</CODE> directive defines the policy that
 179 is used when a backend is unable to send a print job to the
 180 printer. The <CODE>lpadmin(8)</CODE> command sets the current
 181 error policy:</P>
 182
 183 <PRE CLASS="command">
 184 <KBD>/usr/sbin/lpadmin -p printername -o printer-error-policy=stop-printer</KBD>
 185 </PRE>
 186
 187 <P>The following values are supported:</P>
 188
 189 <UL>
 190
 191         <LI><CODE>abort-job</CODE> - Abort the job and proceed
 192         with the next job in the queue</LI>
 193
 194         <LI><CODE>retry-current-job</CODE> - Retry the current job
 195         immediately</LI>
 196
 197         <LI><CODE>retry-job</CODE> - Retry the job after waiting
 198         for N seconds; the <VAR>cupsd.conf</VAR> <A
 199         HREF="ref-cupsd-conf.html#JobRetryInterval"><CODE>JobRetryInterval</CODE></A>
 200         directive controls the value of N</LI>
 201
 202         <LI><CODE>stop-printer</CODE> - Stop the printer and keep
 203         the job for future printing; this is the default
 204         value</LI>
 205
 206 </UL>
 207
 208 <P>This directive must appear inside a <A
 209 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 210 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 211 section.</P>
 212
 213
 214 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4</SPAN><A NAME="Filter">Filter</A></H2>
 215
 216 <H3>Examples</H3>
 217
 218 <PRE CLASS="command">
 219 &lt;Printer name&gt;
 220   ...
 221   Filter mime/type 100 program
 222 &lt;/Printer&gt;
 223 </PRE>
 224
 225 <H3>Description</H3>
 226
 227 <P>The <CODE>Filter</CODE> directive lists a single filter program as defined
 228 in the printer's PPD file.</P>
 229
 230 <P>This directive must appear inside a
 231 <A HREF="#Printer"><CODE>Printer</CODE></A> or
 232 <A HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> section.</P>
 233
 234
 235 <H2 CLASS="title"><A NAME="Info">Info</A></H2>
 236
 237 <H3>Examples</H3>
 238
 239 <PRE CLASS="command">
 240 &lt;Printer name&gt;
 241   ...
 242   Info My Printer
 243 &lt;/Printer&gt;
 244 </PRE>
 245
 246 <H3>Description</H3>
 247
 248 <P>The <CODE>Info</CODE> directive defines the string for the
 249 <VAR>printer-info</VAR> attribute. It is normally set using the
 250 <CODE>lpadmin(8)</CODE> command:</P>
 251
 252 <PRE CLASS="command">
 253 <KBD>/usr/sbin/lpadmin -p printername -D "My Printer"</KBD>
 254 </PRE>
 255
 256 <P>This directive must appear inside a <A
 257 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 258 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 259 section.</P>
 260
 261
 262 <H2 CLASS="title"><A NAME="JobSheets">JobSheets</A></H2>
 263
 264 <H3>Examples</H3>
 265
 266 <PRE CLASS="command">
 267 &lt;Printer name&gt;
 268   ...
 269   JobSheets none,standard
 270 &lt;/Printer&gt;
 271 </PRE>
 272
 273 <H3>Description</H3>
 274
 275 <P>The <CODE>JobSheets</CODE> directive specifies the default
 276 banner pages  to print before and after a print job. In the above
 277 example, only a <VAR>standard</VAR> banner will print after each
 278 job. The <CODE>lpadmin(8)</CODE> command is normally used to set
 279 the default banners:
 280
 281 <PRE CLASS="command">
 282 <KBD>/usr/sbin/lpadmin -p printername -o job-sheets-default=none,standard</KBD>
 283 </PRE>
 284
 285 <P>If only one banner file is specified, it will be printed
 286 before the files in the job. If a second banner file is
 287 specified, it is printed  after the files in the job.</P>
 288
 289 <P>The available banner pages depend on the local system
 290 configuration; CUPS includes the following standard banner
 291 files:</P>
 292
 293 <UL>
 294
 295         <LI><CODE>none</CODE> - Do not produce a banner
 296         page.</LI>
 297
 298         <LI><CODE>classified</CODE> - A banner page with a
 299         &quot;classified&quot; label at the top and bottom.</LI>
 300
 301         <LI><CODE>confidential</CODE> - A banner page with a
 302         &quot;confidential&quot; label at the top and bottom.</LI>
 303
 304         <LI><CODE>secret</CODE> - A banner page with a
 305         &quot;secret&quot; label at the top and bottom.</LI>
 306
 307         <LI><CODE>standard</CODE> - A banner page with no label
 308         at the top and bottom.</LI>
 309
 310         <LI><CODE>topsecret</CODE> - A banner page with a
 311         &quot;top secret&quot; label at the top and bottom.</LI>
 312
 313         <LI><CODE>unclassified</CODE> - A banner page with an
 314         &quot;unclassified&quot; label at the top and bottom.</LI>
 315
 316 </UL>
 317
 318 <P>This directive must appear inside a <A
 319 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 320 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 321 section.</P>
 322
 323
 324 <H2 CLASS="title"><A NAME="KLimit">KLimit</A></H2>
 325
 326 <H3>Examples</H3>
 327
 328 <PRE CLASS="command">
 329 &lt;Printer name&gt;
 330   ...
 331   KLimit 1234
 332 &lt;/Printer&gt;
 333 </PRE>
 334
 335 <H3>Description</H3>
 336
 337 <P>The <CODE>KLimit</CODE> directive defines the value of the
 338 <VAR>job-k-limit</VAR> attribute. It is normally set using the
 339 <CODE>lpadmin(8)</CODE> command:</P>
 340
 341 <PRE CLASS="command">
 342 <KBD>/usr/sbin/lpadmin -p printername -o job-k-limit=1234</KBD>
 343 </PRE>
 344
 345 <P>This directive must appear inside a <A
 346 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 347 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 348 section.</P>
 349
 350
 351 <H2 CLASS="title"><A NAME="Location">Location</A></H2>
 352
 353 <H3>Examples</H3>
 354
 355 <PRE CLASS="command">
 356 &lt;Printer name&gt;
 357   ...
 358   Location Building 3321
 359 &lt;/Printer&gt;
 360 </PRE>
 361
 362 <H3>Description</H3>
 363
 364 <P>The <CODE>Location</CODE> directive defines the string for the
 365 <VAR>printer-location</VAR> attribute. It is normally set using the
 366 <CODE>lpadmin(8)</CODE> command:</P>
 367
 368 <PRE CLASS="command">
 369 <KBD>/usr/sbin/lpadmin -p printername -L "Building 3321"</KBD>
 370 </PRE>
 371
 372 <P>This directive must appear inside a <A
 373 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 374 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 375 section.</P>
 376
 377
 378 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="OpPolicy">OpPolicy</A></H2>
 379
 380 <H3>Examples</H3>
 381
 382 <PRE CLASS="command">
 383 &lt;Printer name&gt;
 384   ...
 385   OpPolicy default
 386 &lt;/Printer&gt;
 387 </PRE>
 388
 389 <H3>Description</H3>
 390
 391 <P>The <CODE>OpPolicy</CODE> directive sets the operation policy
 392 that is used for the printer. The <CODE>lpadmin(8)</CODE> command
 393 sets the current operation policy:</P>
 394
 395 <PRE CLASS="command">
 396 <KBD>/usr/sbin/lpadmin -p printername -o printer-op-policy=default</KBD>
 397 </PRE>
 398
 399 <P>The default policy is named "default". All policies correspond
 400 to those defined using the <VAR>cupsd.conf</VAR> <A
 401 HREF="ref-cupsd-conf.html#Policy"><CODE>Policy</CODE></A>
 402 section.</P>
 403
 404 <P>This directive must appear inside a <A
 405 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 406 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 407 section.</P>
 408
 409
 410 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="Option">Option</A></H2>
 411
 412 <H3>Examples</H3>
 413
 414 <PRE CLASS="command">
 415 &lt;Printer name&gt;
 416   ...
 417   Option name value
 418   Option scaling 100
 419   Option page-left 72
 420 &lt;/Printer&gt;
 421 </PRE>
 422
 423 <H3>Description</H3>
 424
 425 <P>The <CODE>Option</CODE> directive specifies a default job
 426 template attribute value. It is mapped to
 427 <CODE>name-default</CODE> in the printer attributes and applied
 428 to jobs as <CODE>name</CODE>.</P>
 429
 430 <P>This directive must appear inside a <A
 431 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 432 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 433 section.</P>
 434
 435
 436 <H2 CLASS="title"><A NAME="PageLimit">PageLimit</A></H2>
 437
 438 <H3>Examples</H3>
 439
 440 <PRE CLASS="command">
 441 &lt;Printer name&gt;
 442   ...
 443   PageLimit 1234
 444 &lt;/Printer&gt;
 445 </PRE>
 446
 447 <H3>Description</H3>
 448
 449 <P>The <CODE>PageLimit</CODE> directive defines the value of the
 450 <VAR>job-page-limit</VAR> attribute. It can be set using the
 451 <CODE>lpadmin(8)</CODE> command:</P>
 452
 453 <PRE CLASS="command">
 454 <KBD>/usr/sbin/lpadmin -p printername -o job-page-limit=1234</KBD>
 455 </PRE>
 456
 457 <P>This directive must appear inside a <A
 458 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 459 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 460 section.</P>
 461
 462
 463 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="PortMonitor">PortMonitor</A></H2>
 464
 465 <H3>Examples</H3>
 466
 467 <PRE CLASS="command">
 468 &lt;Printer name&gt;
 469   ...
 470   PortMonitor bcp
 471 &lt;/Printer&gt;
 472 </PRE>
 473
 474 <H3>Description</H3>
 475
 476 <P>The <CODE>PortMonitor</CODE> directive sets the filter program that
 477 is used for every print job, typically to encode or package the print
 478 data in a format acceptable for a particular printer interface. It is
 479 set using the <CODE>lpadmin(8)</CODE> command:</P>
 480
 481 <PRE CLASS="command">
 482 <KBD>/usr/sbin/lpadmin -p printername -o port-monitor=tbcp</KBD>
 483 </PRE>
 484
 485 <P>The following standard port monitors are included with CUPS:</P>
 486
 487 <UL>
 488
 489         <LI><CODE>bcp</CODE> - Encode PostScript print data using
 490         the Adobe Binary Control Protocol (BCP)</LI>
 491
 492         <LI><CODE>none</CODE> - Do not use a port monitor</LI>
 493
 494         <LI><CODE>tbcp</CODE> - Encode PostScript print data
 495         using the Adobe Tagged Binary Control Protocol
 496         (TBCP)</LI>
 497
 498 </UL>
 499
 500 <P>This directive must appear inside a <A
 501 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 502 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 503 section.</P>
 504
 505
 506 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4</SPAN><A NAME="PreFilter">PreFilter</A></H2>
 507
 508 <H3>Examples</H3>
 509
 510 <PRE CLASS="command">
 511 &lt;Printer name&gt;
 512   ...
 513   PreFilter mime/type 100 program
 514 &lt;/Printer&gt;
 515 </PRE>
 516
 517 <H3>Description</H3>
 518
 519 <P>The <CODE>PreFilter</CODE> directive lists a single pre-filter program as
 520 defined in the printer's PPD file.</P>
 521
 522 <P>This directive must appear inside a
 523 <A HREF="#Printer"><CODE>Printer</CODE></A> or
 524 <A HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> section.</P>
 525
 526
 527 <H2 CLASS="title"><A NAME="Printer">Printer</A></H2>
 528
 529 <H3>Examples</H3>
 530
 531 <PRE CLASS="command">
 532 &lt;Printer name&gt;
 533   ...
 534 &lt;/Printer&gt;
 535 </PRE>
 536
 537 <H3>Description</H3>
 538
 539 <P>The <CODE>Printer</CODE> directive begins a printer
 540 definition. Printers are added using the <CODE>lpadmin(8)</CODE>
 541 command:
 542
 543 <PRE CLASS="command">
 544 <KBD>/usr/sbin/lpadmin -p printername ...</KBD>
 545 </PRE>
 546
 547
 548 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.4</SPAN><A NAME="Product">Product</A></H2>
 549
 550 <H3>Examples</H3>
 551
 552 <PRE CLASS="command">
 553 &lt;Printer name&gt;
 554   ...
 555   Product Acme PaperWriter
 556 &lt;/Printer&gt;
 557 </PRE>
 558
 559 <H3>Description</H3>
 560
 561 <P>The <CODE>Product</CODE> directive defines the main product string from the
 562 printer's PPD file and is used when advertising the queue via DNS-SD.</P>
 563
 564 <P>This directive must appear inside a
 565 <A HREF="#Printer"><CODE>Printer</CODE></A> or
 566 <A HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A> section.</P>
 567
 568
 569 <H2 CLASS="title"><A NAME="QuotaPeriod">QuotaPeriod</A></H2>
 570
 571 <H3>Examples</H3>
 572
 573 <PRE CLASS="command">
 574 &lt;Printer name&gt;
 575   ...
 576   QuotaPeriod 604800
 577 &lt;/Printer&gt;
 578 </PRE>
 579
 580 <H3>Description</H3>
 581
 582 <P>The <CODE>QuotaPeriod</CODE> directive defines the value of
 583 the  <VAR>job-quota-period</VAR> attribute. Typical values are
 584 86400 (1 day), 604800 (1 week), 2592000 (1 month), and 31536000
 585 (1 year). It is set using the <CODE>lpadmin(8)</CODE>
 586 command:</P>
 587
 588 <PRE CLASS="command">
 589 <KBD>/usr/sbin/lpadmin -p printername -o job-quota-period=604800</KBD>
 590 </PRE>
 591
 592 <P>This directive must appear inside a <A
 593 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 594 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 595 section.</P>
 596
 597
 598 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="Shared">Shared</A></H2>
 599
 600 <H3>Examples</H3>
 601
 602 <PRE CLASS="command">
 603 &lt;Printer name&gt;
 604   ...
 605   Shared yes
 606 &lt;/Printer&gt;
 607 </PRE>
 608
 609 <H3>Description</H3>
 610
 611 <P>The <CODE>Shared</CODE> directive defines the initial value of
 612 the <VAR>printer-is-shared</VAR> attribute. The strings
 613 <VAR>yes</VAR> and <VAR>no</VAR> correspond to the true and false
 614 values, respectively. The <CODE>lpadmin(8)</CODE> command sets
 615 the current state:</P>
 616
 617 <PRE CLASS="command">
 618 <KBD>/usr/sbin/lpadmin -p printername -o printer-is-shared=true</KBD>
 619 </PRE>
 620
 621 <P>This directive must appear inside a <A
 622 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 623 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 624 section.</P>
 625
 626
 627 <H2 CLASS="title"><A NAME="State">State</A></H2>
 628
 629 <H3>Examples</H3>
 630
 631 <PRE CLASS="command">
 632 &lt;Printer name&gt;
 633   ...
 634   State idle
 635 &lt;/Printer&gt;
 636 </PRE>
 637
 638 <H3>Description</H3>
 639
 640 <P>The <CODE>State</CODE> directive defines the initial value of
 641 the <VAR>printer-state</VAR> attribute. The strings
 642 <VAR>idle</VAR> and <VAR>stopped</VAR> correspond to the IPP
 643 enumeration values 3 and 5, respectively. The
 644 <CODE>cupsenable(8)</CODE> and <CODE>cupsdisable(8)</CODE>
 645 commands set the current state:</P>
 646
 647 <PRE CLASS="command">
 648 <KBD>/usr/sbin/cupsenable printername</KBD>
 649 <KBD>/usr/sbin/cupsdisable printername</KBD>
 650 </PRE>
 651
 652 <P>This directive must appear inside a <A
 653 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 654 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 655 section.</P>
 656
 657
 658 <H2 CLASS="title"><A NAME="StateMessage">StateMessage</A></H2>
 659
 660 <H3>Examples</H3>
 661
 662 <PRE CLASS="command">
 663 &lt;Printer name&gt;
 664   ...
 665   StateMessage Ready to print.
 666 &lt;/Printer&gt;
 667 </PRE>
 668
 669 <H3>Description</H3>
 670
 671 <P>The <CODE>StateMessage</CODE> directive defines the initial
 672 string for the  <VAR>printer-state-message</VAR> attribute. The
 673 following are some example messages:</P>
 674
 675 <PRE CLASS="command">
 676 StateMessage Connected to host_name...
 677 StateMessage Connecting to printer_queue on port port_number...
 678 StateMessage Network host host_name is busy; will retry in 30 seconds...
 679 StateMessage Printer busy; will retry in 10 seconds...
 680 StateMessage Printer is busy; retrying print job...
 681 StateMessage Print file accepted - job ID id_number.
 682 StateMessage Ready to print.
 683 StateMessage Waiting for job to complete
 684 </PRE>
 685
 686 <P>This directive must appear inside a <A
 687 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 688 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 689 section.</P>
 690
 691
 692 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="StateTime">StateTime</A></H2>
 693
 694 <H3>Examples</H3>
 695
 696 <PRE CLASS="command">
 697 &lt;Printer name&gt;
 698   ...
 699   StateTime 1133542425
 700 &lt;/Printer&gt;
 701 </PRE>
 702
 703 <H3>Description</H3>
 704
 705 <P>The <CODE>StateTime</CODE> directive defines the UNIX time
 706 (seconds since Jan 1, 1970) for the last state change of the
 707 queue. It is mapped to the <VAR>printer-state-change-time</VAR>
 708 attribute.</P>
 709
 710 <P>This directive must appear inside a <A
 711 HREF="#Printer"><CODE>Printer</CODE></A> or <A
 712 HREF="#DefaultPrinter"><CODE>DefaultPrinter</CODE></A>
 713 section.</P>
 714
 715
 716 </BODY>
 717 </HTML>