[thirdparty/cups.git] / doc / help / ref-subscriptions-conf.html

<HTML>
<!-- SECTION: References -->
<HEAD>
	<TITLE>subscriptions.conf</TITLE>
</HEAD>
<BODY>

<P>The CUPS scheduler (cupsd) uses the <VAR>/etc/cups/subscriptions.conf</VAR> file 
to store the list of active subscriptions.  This file contains only locally defined
classes, but not remote or implicit classes that are created automatically.  
Each directive is listed on a line by itself followed by its value. 
Comments are introduced using the number sign ("#") character at the beginning of a line.

<P>Since the classes configuration file consists of plain text, you can
use your favorite text editor to make changes to it.

<P>The <VAR>subscription.conf</VAR> file contains many directives that
determine how the subscriptions behave:</P>

<P ALIGN="CENTER">
<TABLE CELLPADDING="0" CELLSPACING="0" BORDER="0">
<TR>
<TD VALIGN="TOP">

	<LI><A HREF="#ClassAccepting"><CODE>Accepting</CODE></A>
	<LI><A HREF="#ClassAllowUser"><CODE>AllowUser</CODE></A>
	<LI><A HREF="#Class"><CODE>Class</CODE></A>
	<LI><A HREF="#DefaultClass"><CODE>DefaultClass</CODE></A>
	<LI><A HREF="#ClassDenyUser"><CODE>DenyUser</CODE></A>

</TD>
<TD VALIGN="TOP">
&nbsp;&nbsp;&nbsp;
</TD>
<TD VALIGN="TOP">

	<LI><A HREF="#ClassInfo"><CODE>Info</CODE></A>
	<LI><A HREF="#ClassJobSheets"><CODE>JobSheets</CODE></A>
	<LI><A HREF="#ClassKLimit"><CODE>KLimit</CODE></A>
	<LI><A HREF="#ClassLocation"><CODE>Location</CODE></A>
	<LI><A HREF="#ClassPageLimit"><CODE>PageLimit</CODE></A>

</TD>
<TD VALIGN="TOP">
&nbsp;&nbsp;&nbsp;
</TD>
<TD VALIGN="TOP">

	<LI><A HREF="#ClassPrinter"><CODE>Printer</CODE></A>
	<LI><A HREF="#ClassQuotaPeriod"><CODE>QuotaPeriod</CODE></A>
	<LI><A HREF="#ClassState"><CODE>State</CODE></A>
	<LI><A HREF="#ClassStateMessage"><CODE>StateMessage</CODE></A>

</TD>
</TR>
</TABLE>
</P>

<!-- HALF PAGE -->
<H3><A NAME="ClassAccepting">Accepting</A></H3>
<HR>

<H4>Examples</H4>

<UL><PRE>
Accepting yes

Accepting no
</PRE></UL>

<H4>Description</H4>

<P>The <CODE>Accepting</CODE> directive defines the initial Boolean
value for the <VAR>printer-is-accepting-job</VAR> attribute which can
be set by the <CODE>accept</CODE> and <CODE>reject</CODE> commands. 

<P>This directive must appear inside a <A HREF="#Class"><CODE>Class</CODE></A> 
or <A HREF="#DefaultClass"><CODE>DefaultClass</CODE></A> directive.  

</BODY>
</HTML>
Commit	Line	Data
ef416fc2	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
	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
	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>