man/printers.conf.man

   1 .\"
   2 .\" "$Id: printers.conf.man 7600 2008-05-20 21:06:23Z mike $"
   3 .\"
   4 .\"   printers.conf man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 2007-2009 by Apple Inc.
   7 .\"   Copyright 1997-2006 by Easy Software Products.
   8 .\"
   9 .\"   These coded instructions, statements, and computer programs are the
  10 .\"   property of Apple Inc. and are protected by Federal copyright
  11 .\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  12 .\"   which should have been included with this file.  If this file is
  13 .\"   file is missing or damaged, see the license at "http://www.cups.org/".
  14 .\"
  15 .TH printers.conf 5 "CUPS" "29 April 2009" "Apple Inc."
  16 .SH NAME
  17 printers.conf \- printer configuration file for cups
  18 .SH DESCRIPTION
  19 The \fIprinters.conf\fR file defines the local printers that are
  20 available. It is normally located in the \fI/etc/cups\fR directory and
  21 is generated automatically by the \fIcupsd(8)\fR program when printers
  22 are added or deleted.
  23 .LP
  24 Each line in the file can be a configuration directive, a blank line,
  25 or a comment. Comment lines start with the # character.
  26 .SH DIRECTIVES
  27 .TP 5
  28 <Printer name> ... </Printer>
  29 .br
  30 Defines a specific printer.
  31 .TP 5
  32 <DefaultPrinter name> ... </Printer>
  33 .br
  34 Defines a default printer.
  35 .TP 5
  36 Accepting Yes
  37 .TP 5
  38 Accepting No
  39 .br
  40 Specifies whether the printer is accepting new jobs.
  41 .TP 5
  42 AllowUser [ user @group ... ]
  43 .br
  44 Allows specific users and groups to print to the printer.
  45 .TP 5
  46 DenyUser [ user @group ... ]
  47 .br
  48 Prevents specific users and groups from printing to the printer.
  49 .TP 5
  50 DeviceURI uri
  51 .br
  52 Specifies the device URI for a printer.
  53 .TP 5
  54 ErrorPolicy abort-job
  55 .TP 5
  56 ErrorPolicy retry-current-job
  57 .TP 5
  58 ErrorPolicy retry-job
  59 .TP 5
  60 ErrorPolicy stop-printer
  61 .br
  62 Specifies the error policy for the printer.
  63 .TP 5
  64 Info text
  65 .br
  66 Specifies human-readable text describing the printer.
  67 .TP 5
  68 JobSheets banner banner
  69 .br
  70 Specifies the banner pages to use for the printer.
  71 .TP 5
  72 KLimit number
  73 .br
  74 Specifies the job-k-limit value for the printer.
  75 .TP 5
  76 Location text
  77 .br
  78 Specifies human-readable text describing the location of the printer.
  79 .TP 5
  80 OpPolicy name
  81 .br
  82 Specifies the operation policy for the printer.
  83 .TP 5
  84 PageLimit number
  85 .br
  86 Specifies the job-page-limit value for the printer.
  87 .TP 5
  88 PortMonitor monitor
  89 .br
  90 Specifies the port monitor for a printer.
  91 .TP 5
  92 QuotaPeriod seconds
  93 .br
  94 Specifies the job-quota-period value for the printer.
  95 .TP 5
  96 Shared Yes
  97 .TP 5
  98 Shared No
  99 .br
 100 Specifies whether the printer is shared.
 101 .TP 5
 102 State idle
 103 .TP 5
 104 State stopped
 105 .br
 106 Specifies the initial state of the printer (Idle or Stopped)
 107 .TP 5
 108 StateMessage text
 109 .br
 110 Specifies the message associated with the state.
 111 .TP 5
 112 StateTime seconds
 113 .br
 114 Specifies the date/time associated with the state.
 115 .SH SEE ALSO
 116 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
 117 \fImime.convs(5)\fR, \fImime.types(5)\fR,
 118 .br
 119 http://localhost:631/help
 120 .SH COPYRIGHT
 121 Copyright 2007-2009 by Apple Inc.
 122 .\"
 123 .\" End of "$Id: printers.conf.man 7600 2008-05-20 21:06:23Z mike $".
 124 .\"