doc/help/subscriptions-conf-reference.html

   1 <HTML>
   2 <!-- SECTION: References -->
   3 <HEAD>
   4         <TITLE>subscriptions.conf</TITLE>
   5 </HEAD>
   6 <BODY>
   7
   8 <P>The CUPS scheduler (cupsd) uses the <VAR>/etc/cups/subscriptions.conf</VAR> file
   9 to store the list of active subscriptions.  This file contains only locally defined
  10 classes, but not remote or implicit classes that are created automatically.
  11 Each directive is listed on a line by itself followed by its value.
  12 Comments are introduced using the number sign ("#") character at the beginning of a line.
  13
  14 <P>Since the classes configuration file consists of plain text, you can
  15 use your favorite text editor to make changes to it.
  16
  17 <P>The <VAR>subscription.conf</VAR> file contains many directives that
  18 determine how the subscriptions behave:</P>
  19
  20 <P ALIGN="CENTER">
  21 <TABLE CELLPADDING="0" CELLSPACING="0" BORDER="0">
  22 <TR>
  23 <TD VALIGN="TOP">
  24
  25         <LI><A HREF="#ClassAccepting"><CODE>Accepting</CODE></A>
  26         <LI><A HREF="#ClassAllowUser"><CODE>AllowUser</CODE></A>
  27         <LI><A HREF="#Class"><CODE>Class</CODE></A>
  28         <LI><A HREF="#DefaultClass"><CODE>DefaultClass</CODE></A>
  29         <LI><A HREF="#ClassDenyUser"><CODE>DenyUser</CODE></A>
  30
  31 </TD>
  32 <TD VALIGN="TOP">
  33 &nbsp;&nbsp;&nbsp;
  34 </TD>
  35 <TD VALIGN="TOP">
  36
  37         <LI><A HREF="#ClassInfo"><CODE>Info</CODE></A>
  38         <LI><A HREF="#ClassJobSheets"><CODE>JobSheets</CODE></A>
  39         <LI><A HREF="#ClassKLimit"><CODE>KLimit</CODE></A>
  40         <LI><A HREF="#ClassLocation"><CODE>Location</CODE></A>
  41         <LI><A HREF="#ClassPageLimit"><CODE>PageLimit</CODE></A>
  42
  43 </TD>
  44 <TD VALIGN="TOP">
  45 &nbsp;&nbsp;&nbsp;
  46 </TD>
  47 <TD VALIGN="TOP">
  48
  49         <LI><A HREF="#ClassPrinter"><CODE>Printer</CODE></A>
  50         <LI><A HREF="#ClassQuotaPeriod"><CODE>QuotaPeriod</CODE></A>
  51         <LI><A HREF="#ClassState"><CODE>State</CODE></A>
  52         <LI><A HREF="#ClassStateMessage"><CODE>StateMessage</CODE></A>
  53
  54 </TD>
  55 </TR>
  56 </TABLE>
  57 </P>
  58
  59 <!-- HALF PAGE -->
  60 <H3><A NAME="ClassAccepting">Accepting</A></H3>
  61 <HR>
  62
  63 <H4>Examples</H4>
  64
  65 <UL><PRE>
  66 Accepting yes
  67
  68 Accepting no
  69 </PRE></UL>
  70
  71 <H4>Description</H4>
  72
  73 <P>The <CODE>Accepting</CODE> directive defines the initial Boolean
  74 value for the <VAR>printer-is-accepting-job</VAR> attribute which can
  75 be set by the <CODE>accept</CODE> and <CODE>reject</CODE> commands.
  76
  77 <P>This directive must appear inside a <A HREF="#Class"><CODE>Class</CODE></A>
  78 or <A HREF="#DefaultClass"><CODE>DefaultClass</CODE></A> directive.
  79
  80 </BODY>
  81 </HTML>