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 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 "Common UNIX Printing System" "12 February 2006" "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-job
  57 .TP 5
  58 ErrorPolicy stop-printer
  59 .br
  60 Specifies the error policy for the printer.
  61 .TP 5
  62 Info text
  63 .br
  64 Specifies human-readable text describing the printer.
  65 .TP 5
  66 JobSheets banner banner
  67 .br
  68 Specifies the banner pages to use for the printer.
  69 .TP 5
  70 KLimit number
  71 .br
  72 Specifies the job-k-limit value for the printer.
  73 .TP 5
  74 Location text
  75 .br
  76 Specifies human-readable text describing the location of the printer.
  77 .TP 5
  78 OpPolicy name
  79 .br
  80 Specifies the operation policy for the printer.
  81 .TP 5
  82 PageLimit number
  83 .br
  84 Specifies the job-page-limit value for the printer.
  85 .TP 5
  86 PortMonitor monitor
  87 .br
  88 Specifies the port monitor for a printer.
  89 .TP 5
  90 QuotaPeriod seconds
  91 .br
  92 Specifies the job-quota-period value for the printer.
  93 .TP 5
  94 Shared Yes
  95 .TP 5
  96 Shared No
  97 .br
  98 Specifies whether the printer is shared.
  99 .TP 5
 100 State idle
 101 .TP 5
 102 State stopped
 103 .br
 104 Specifies the initial state of the printer (Idle or Stopped)
 105 .TP 5
 106 StateMessage text
 107 .br
 108 Specifies the message associated with the state.
 109 .TP 5
 110 StateTime seconds
 111 .br
 112 Specifies the date/time associated with the state.
 113 .SH SEE ALSO
 114 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
 115 \fImime.convs(5)\fR, \fImime.types(5)\fR,
 116 .br
 117 http://localhost:631/help
 118 .SH COPYRIGHT
 119 Copyright 2007 by Apple Inc.
 120 .\"
 121 .\" End of "$Id: printers.conf.man 7600 2008-05-20 21:06:23Z mike $".
 122 .\"