]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - doc/help/policies.html
Greatly simplify the man page handling.
[thirdparty/cups.git] / doc / help / policies.html
index 42b789aaf159dba07e09bf07e15233dde334fbdd..8a0fc313d51396f1c306559e367db7d99c41a1d1 100644 (file)
 
 <H2 CLASS="title"><A NAME="BASICS">The Basics</A></H2>
 
-<P>Operation policies are used for all IPP requests sent to the scheduler and are evaluated <em>after</em> the <A HREF="ref-cupsd-conf.html#Location"><TT>Location</TT></A> based access control rules. This means that operation policies can only add additional security restrictions to a request, never relax them. Use <TT>Location</TT> based access control rules for server-wide limits and operation policies for limits on individual printers, tasks, or services.</P>
+<P>Operation policies are used for all IPP requests sent to the scheduler and are evaluated <em>after</em> the <A HREF="man-cupsd.conf.html#Location"><TT>Location</TT></A> based access control rules. This means that operation policies can only add additional security restrictions to a request, never relax them. Use <TT>Location</TT> based access control rules for server-wide limits and operation policies for limits on individual printers, tasks, or services.</P>
 
-<P>Policies are stored in the <VAR>cupsd.conf</VAR> file in <A HREF="ref-cupsd-conf.html#Policy"><TT>Policy</TT></A> sections. Each policy has an alphanumeric name that is used to select it. Inside the policy section are one or more <A
-HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list the operations that are affected by the rules inside it. <A HREF="#LISTING01">Listing 1</A> shows the default operation policy, appropriately called "default", that is shipped with CUPS.</P>
+<P>Policies are stored in the <VAR>cupsd.conf</VAR> file in <A HREF="man-cupsd.conf.html#Policy"><TT>Policy</TT></A> sections. Each policy has an alphanumeric name that is used to select it. Inside the policy section are one or more <A
+HREF="man-cupsd.conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list the operations that are affected by the rules inside it. <A HREF="#LISTING01">Listing 1</A> shows the default operation policy, appropriately called "default", that is shipped with CUPS.</P>
 
-<P>The easiest way to add a policy to the <VAR>cupsd.conf</VAR> file is to use the web interface. Click on the <VAR>Administration</VAR> tab and then the <VAR>Edit Configuration File</VAR> button to edit the current <VAR>cupsd.conf</VAR> file. Click on the <VAR>Save Changes</VAR> button to save the changes and restart the scheduler. If you edit the <VAR>cupsd.conf</VAR> file from the console, make sure to <A HREF="ref-cupsd-conf.html">restart the cupsd process</A> before trying to use the new policy.</P>
+<P>The easiest way to add a policy to the <VAR>cupsd.conf</VAR> file is to use the web interface. Click on the <VAR>Administration</VAR> tab and then the <VAR>Edit Configuration File</VAR> button to edit the current <VAR>cupsd.conf</VAR> file. Click on the <VAR>Save Changes</VAR> button to save the changes and restart the scheduler. If you edit the <VAR>cupsd.conf</VAR> file from the console, make sure to <A HREF="man-cupsd.conf.html">restart the cupsd process</A> before trying to use the new policy.</P>
 
 <PRE CLASS="example">
 <EM>Listing 1: <A NAME="LISTING01">Default Operation Policy</A></EM>
@@ -97,7 +97,7 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
 
 <P>The operation names are listed on a single line with spaces separating them. Each name corresponds to the IPP operation described in any of the IETF or PWG standards documents for the Internet Printing Protocol. <A HREF="#TABLE01">Table 1</A> lists all of the operations that have been defined along with their usage in CUPS.</P>
 
-<P>The access control rules are listed after the <TT>Limit</TT> line and are the same as those used for <A HREF="ref-cupsd-conf.html#Location"><TT>Location</TT></A> sections. In this case, we require the owner of the job ("@OWNER") or a member of the <A HREF="ref-cupsd-conf.html#SystemGroup"><TT>SystemGroup</TT></A> ("@SYSTEM") to do the operation. Because we do not include an <A HREF="ref-cupsd-conf.html#AuthType"><TT>AuthType</TT></A> directive here, the user information can come from the IPP request itself or the authenticated username from the HTTP request. The administrative operations starting on line 9, however, <em>do</em> use the <TT>AuthType</TT> directive, and so administrative operations need to be authenticated:</P>
+<P>The access control rules are listed after the <TT>Limit</TT> line and are the same as those used for <A HREF="man-cupsd.conf.html#Location"><TT>Location</TT></A> sections. In this case, we require the owner of the job ("@OWNER") or a member of the <A HREF="man-cups-files.conf.html#SystemGroup"><TT>SystemGroup</TT></A> ("@SYSTEM") to do the operation. Because we do not include an <A HREF="man-cupsd.conf.html#AuthType"><TT>AuthType</TT></A> directive here, the user information can come from the IPP request itself or the authenticated username from the HTTP request. The administrative operations starting on line 9, however, <em>do</em> use the <TT>AuthType</TT> directive, and so administrative operations need to be authenticated:</P>
 
 <PRE CLASS="example">
  9      &lt;Limit CUPS-Add-Modify-Printer CUPS-Delete-Printer CUPS-Add-Modify-Class
@@ -154,19 +154,39 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
 </THEAD>
 <TBODY>
 <TR>
-       <TD NOWRAP><TT>Print-Job</TT></TD>
-       <TD>Yes</TD>
-       <TD>Creates a print job with a single file.</TD>
+       <TD NOWRAP><TT>Activate-Printer</TT></TD>
+       <TD>No</TD>
+       <TD>Activates a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Print-URI</TT></TD>
+       <TD NOWRAP><TT>Cancel-Current-Job</TT></TD>
        <TD>No</TD>
-       <TD>Create a print job with a single URI.</TD>
+       <TD>Cancels the current job on a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Validate-Job</TT></TD>
+       <TD NOWRAP><TT>Cancel-Job</TT></TD>
        <TD>Yes</TD>
-       <TD>Validates a print request before printing.</TD>
+       <TD>Cancels a print job.</TD>
+</TR>
+<TR>
+       <TD NOWRAP><TT>Cancel-Jobs</TT></TD>
+       <TD>Yes</TD>
+       <TD>Cancels all print jobs.</TD>
+</TR>
+<TR>
+       <TD NOWRAP><TT>Cancel-My-Jobs</TT></TD>
+       <TD>Yes</TD>
+       <TD>Cancels a user's print job.</TD>
+</TR>
+<TR>
+       <TD NOWRAP><TT>Cancel-Subscription</TT></TD>
+       <TD>Yes</TD>
+       <TD>Cancels an event subscription.</TD>
+</TR>
+<TR>
+       <TD NOWRAP><TT>Close-Job</TT></TD>
+       <TD>Yes</TD>
+       <TD>Closes a user's print job so that it can be printed.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>Create-Job</TT></TD>
@@ -174,19 +194,29 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
        <TD>Creates a print job with no files or URIs.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Send-Document</TT></TD>
+       <TD NOWRAP><TT>Create-Job-Subscriptions</TT></TD>
        <TD>Yes</TD>
-       <TD>Adds a file to a print job.</TD>
+       <TD>Creates one or more event subscriptions for a job.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Send-URI</TT></TD>
+       <TD NOWRAP><TT>Create-Printer-Subscriptions</TT></TD>
+       <TD>Yes</TD>
+       <TD>Creates one or more event subscriptions for a printer or the server.</TD>
+</TR>
+<TR>
+       <TD NOWRAP><TT>Deactivate-Printer</TT></TD>
        <TD>No</TD>
-       <TD>Adds a URI to a print job.</TD>
+       <TD>Deactivates a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Cancel-Job</TT></TD>
+       <TD NOWRAP><TT>Disable-Printer</TT></TD>
        <TD>Yes</TD>
-       <TD>Cancels a print job.</TD>
+       <TD>Stops a printer or class.</TD>
+</TR>
+<TR>
+       <TD NOWRAP><TT>Enable-Printer</TT></TD>
+       <TD>Yes</TD>
+       <TD>Starts a printer or class.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>Get-Job-Attributes</TT></TD>
@@ -198,79 +228,83 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
        <TD>Yes</TD>
        <TD>Gets a list of jobs.</TD>
 </TR>
+<TR>
+       <TD NOWRAP><TT>Get-Notifications</TT></TD>
+       <TD>Yes</TD>
+       <TD>Gets (pending) events for an event subscription.</TD>
+</TR>
 <TR>
        <TD NOWRAP><TT>Get-Printer-Attributes</TT></TD>
        <TD>Yes</TD>
        <TD>Gets information and options associated with a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Hold-Job</TT></TD>
+       <TD NOWRAP><TT>Get-Printer-Supported-Values</TT></TD>
        <TD>Yes</TD>
-       <TD>Holds a print job for printing.</TD>
+       <TD>Gets -supported attributes for a printer based on job
+       options.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Release-Job</TT></TD>
+       <TD NOWRAP><TT>Get-Subscription-Attributes</TT></TD>
        <TD>Yes</TD>
-       <TD>Releases a print job for printing.</TD>
+       <TD>Gets information for an event subscription.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Restart-Job</TT></TD>
+       <TD NOWRAP><TT>Get-Subscriptions</TT></TD>
        <TD>Yes</TD>
-       <TD>Reprints a print job.</TD>
+       <TD>Gets a list of event subscriptions.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Pause-Printer</TT></TD>
+       <TD NOWRAP><TT>Hold-Job</TT></TD>
        <TD>Yes</TD>
-       <TD>Stops a printer or class.</TD>
+       <TD>Holds a print job for printing.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Resume-Printer</TT></TD>
+       <TD NOWRAP><TT>Hold-New-Jobs</TT></TD>
        <TD>Yes</TD>
-       <TD>Starts a printer or class.</TD>
+       <TD>Holds new jobs submitted to a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Purge-Jobs</TT></TD>
+       <TD NOWRAP><TT>Pause-Printer</TT></TD>
        <TD>Yes</TD>
-       <TD>Cancels all jobs on the server or a printer or class
-       and removes the job history information.</TD>
+       <TD>Stops a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Set-Printer-Attributes</TT></TD>
+       <TD NOWRAP><TT>Pause-Printer-After-Current-Job</TT></TD>
        <TD>No</TD>
-       <TD>Sets printer or class information; CUPS uses
-       CUPS-Add-Modify-Printer and CUPS-Add-Modify-Class
-       instead.</TD>
+       <TD>Stops a printer or class after the current job is finished.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Set-Job-Attributes</TT></TD>
+       <TD NOWRAP><TT>Print-Job</TT></TD>
        <TD>Yes</TD>
-       <TD>Changes job options.</TD>
+       <TD>Creates a print job with a single file.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Get-Printer-Supported-Values</TT></TD>
+       <TD NOWRAP><TT>Print-URI</TT></TD>
        <TD>No</TD>
-       <TD>Gets -supported attributes for a printer based on job
-       options.</TD>
+       <TD>Create a print job with a single URI.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Create-Printer-Subscription</TT></TD>
-       <TD>Yes</TD>
-       <TD>Creates an event subscription for a printer or the server.</TD>
+       <TD NOWRAP><TT>Promote-Job</TT></TD>
+       <TD>No</TD>
+       <TD>Prints a job before others.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Create-Job-Subscription</TT></TD>
+       <TD NOWRAP><TT>Purge-Jobs</TT></TD>
        <TD>Yes</TD>
-       <TD>Creates an event subscription for a job.</TD>
+       <TD>Cancels all jobs on the server or a printer or class
+       and removes the job history information.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Get-Subscription-Attributes</TT></TD>
+       <TD NOWRAP><TT>Release-Held-New-Jobs</TT></TD>
        <TD>Yes</TD>
-       <TD>Gets information for an event subscription.</TD>
+       <TD>Releases jobs that were held because of the
+       Hold-New-Jobs operation.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Get-Subscriptions</TT></TD>
+       <TD NOWRAP><TT>Release-Job</TT></TD>
        <TD>Yes</TD>
-       <TD>Gets a list of event subscriptions.</TD>
+       <TD>Releases a print job for printing.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>Renew-Subscription</TT></TD>
@@ -278,65 +312,62 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
        <TD>Renews an event subscription that is about to expire.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Cancel-Subscription</TT></TD>
-       <TD>Yes</TD>
-       <TD>Cancels an event subscription.</TD>
+       <TD NOWRAP><TT>Reprocess-Job</TT></TD>
+       <TD>No</TD>
+       <TD>Reprints a job on a different printer or class; CUPS has the
+       CUPS-Move-Job operation instead.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Get-Notifications</TT></TD>
+       <TD NOWRAP><TT>Restart-Job</TT></TD>
        <TD>Yes</TD>
-       <TD>Gets (pending) events for an event subscription.</TD>
+       <TD>Reprints a print job.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Send-Notifications</TT></TD>
+       <TD NOWRAP><TT>Restart-Printer</TT></TD>
        <TD>No</TD>
-       <TD>Sends events for an event subscription.</TD>
+       <TD>Restarts a printer or class, resuming print jobs as needed.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Get-Printer-Support-Files</TT></TD>
+       <TD NOWRAP><TT>Resubmit-Job</TT></TD>
        <TD>No</TD>
-       <TD>Gets printer driver files for a Novell client.</TD>
+       <TD>Reprints a job with new options.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Enable-Printer</TT></TD>
-       <TD>Yes</TD>
-       <TD>Starts a printer or class.</TD>
+       <TD NOWRAP><TT>Resume-Job</TT></TD>
+       <TD>No</TD>
+       <TD>Resumes printing of a stopped job.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Disable-Printer</TT></TD>
+       <TD NOWRAP><TT>Resume-Printer</TT></TD>
        <TD>Yes</TD>
-       <TD>Stops a printer or class.</TD>
-</TR>
-<TR>
-       <TD NOWRAP><TT>Pause-Printer-After-Current-Job</TT></TD>
-       <TD>No</TD>
-       <TD>Stops a printer or class after the current job is finished.</TD>
+       <TD>Starts a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Hold-New-Jobs</TT></TD>
+       <TD NOWRAP><TT>Schedule-Job-After</TT></TD>
        <TD>No</TD>
-       <TD>Holds new jobs submitted to a printer or class.</TD>
+       <TD>Prints a job after others.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Release-Held-New-Jobs</TT></TD>
-       <TD>No</TD>
-       <TD>Releases jobs that were held because of the
-       Hold-New-Jobs operation.</TD>
+       <TD NOWRAP><TT>Send-Document</TT></TD>
+       <TD>Yes</TD>
+       <TD>Adds a file to a print job.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Deactivate-Printer</TT></TD>
+       <TD NOWRAP><TT>Send-URI</TT></TD>
        <TD>No</TD>
-       <TD>Deactivates a printer or class.</TD>
+       <TD>Adds a URI to a print job.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Activate-Printer</TT></TD>
-       <TD>No</TD>
-       <TD>Activates a printer or class.</TD>
+       <TD NOWRAP><TT>Set-Printer-Attributes</TT></TD>
+       <TD>Yes</TD>
+       <TD>Sets printer or class information; CUPS uses
+       CUPS-Add-Modify-Printer and CUPS-Add-Modify-Class
+       for most attributes instead.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Restart-Printer</TT></TD>
-       <TD>No</TD>
-       <TD>Restarts a printer or class, resuming print jobs as needed.</TD>
+       <TD NOWRAP><TT>Set-Job-Attributes</TT></TD>
+       <TD>Yes</TD>
+       <TD>Changes job options.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>Shutdown-Printer</TT></TD>
@@ -348,46 +379,31 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
        <TD>No</TD>
        <TD>Powers a printer or class on.</TD>
 </TR>
-<TR>
-       <TD NOWRAP><TT>Reprocess-Job</TT></TD>
-       <TD>No</TD>
-       <TD>Reprints a job on a different printer or class; CUPS has the
-       CUPS-Move-Job operation instead.</TD>
-</TR>
-<TR>
-       <TD NOWRAP><TT>Cancel-Current-Job</TT></TD>
-       <TD>No</TD>
-       <TD>Cancels the current job on a printer or class.</TD>
-</TR>
 <TR>
        <TD NOWRAP><TT>Suspend-Current-Job</TT></TD>
        <TD>No</TD>
        <TD>Stops the current job on a printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Resume-Job</TT></TD>
+       <TD NOWRAP><TT>Validate-Document</TT></TD>
        <TD>No</TD>
-       <TD>Resumes printing of a stopped job.</TD>
+       <TD>Validates a document request before sending.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>Promote-Job</TT></TD>
-       <TD>No</TD>
-       <TD>Prints a job before others.</TD>
-</TR>
-<TR>
-       <TD NOWRAP><TT>Schedule-Job-After</TT></TD>
-       <TD>No</TD>
-       <TD>Prints a job after others.</TD>
+       <TD NOWRAP><TT>Validate-Job</TT></TD>
+       <TD>Yes</TD>
+       <TD>Validates a print request before printing.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Get-Default</TT> *</TD>
+       <TD NOWRAP><TT>CUPS-Accept-Jobs</TT></TD>
        <TD>Yes</TD>
-       <TD>Gets the server/network default printer or class.</TD>
+       <TD>Sets a printer's or class' printer-is-accepting-jobs
+       attribute to true.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Get-Printers</TT> *</TD>
+       <TD NOWRAP><TT>CUPS-Add-Modify-Class</TT></TD>
        <TD>Yes</TD>
-       <TD>Gets a list of printers and/or classes.</TD>
+       <TD>Adds or modifies a class.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>CUPS-Add-Modify-Printer</TT></TD>
@@ -395,19 +411,9 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
        <TD>Adds or modifies a printer.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Delete-Printer</TT> *</TD>
-       <TD>Yes</TD>
-       <TD>Removes a printer.</TD>
-</TR>
-<TR>
-       <TD NOWRAP><TT>CUPS-Get-Classes</TT> *</TD>
-       <TD>Yes</TD>
-       <TD>Gets a list of classes.</TD>
-</TR>
-<TR>
-       <TD NOWRAP><TT>CUPS-Add-Modify-Class</TT></TD>
+       <TD NOWRAP><TT>CUPS-Authenticate-Job</TT></TD>
        <TD>Yes</TD>
-       <TD>Adds or modifies a class.</TD>
+       <TD>Authenticates a job for printing.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>CUPS-Delete-Class</TT> *</TD>
@@ -415,46 +421,55 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
        <TD>Removes a class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Accept-Jobs</TT></TD>
+       <TD NOWRAP><TT>CUPS-Delete-Printer</TT> *</TD>
        <TD>Yes</TD>
-       <TD>Sets a printer's or class' printer-is-accepting-jobs
-       attribute to true.</TD>
+       <TD>Removes a printer.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Reject-Jobs</TT></TD>
+       <TD NOWRAP><TT>CUPS-Get-Classes</TT> *</TD>
        <TD>Yes</TD>
-       <TD>Sets a printer's or class' printer-is-accepting-jobs
-       attribute to false.</TD>
+       <TD>Gets a list of classes.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Set-Default</TT> *</TD>
+       <TD NOWRAP><TT>CUPS-Get-Default</TT> *</TD>
        <TD>Yes</TD>
-       <TD>Sets the server/network default printer or class.</TD>
+       <TD>Gets the server/network default printer or class.</TD>
 </TR>
 <TR>
        <TD NOWRAP><TT>CUPS-Get-Devices</TT> *</TD>
        <TD>Yes</TD>
        <TD>Gets a list of printer devices.</TD>
 </TR>
+<TR>
+       <TD NOWRAP><TT>CUPS-Get-Document</TT></TD>
+       <TD>Yes</TD>
+       <TD>Retrieves a document file from a job.</TD>
+</TR>
 <TR>
        <TD NOWRAP><TT>CUPS-Get-PPDs</TT> *</TD>
        <TD>Yes</TD>
        <TD>Gets a list of printer drivers or manufacturers.</TD>
 </TR>
+<TR>
+       <TD NOWRAP><TT>CUPS-Get-Printers</TT> *</TD>
+       <TD>Yes</TD>
+       <TD>Gets a list of printers and/or classes.</TD>
+</TR>
 <TR>
        <TD NOWRAP><TT>CUPS-Move-Job</TT></TD>
        <TD>Yes</TD>
        <TD>Moves a job to a different printer or class.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Authenticate-Job</TT></TD>
+       <TD NOWRAP><TT>CUPS-Reject-Jobs</TT></TD>
        <TD>Yes</TD>
-       <TD>Authenticates a job for printing.</TD>
+       <TD>Sets a printer's or class' printer-is-accepting-jobs
+       attribute to false.</TD>
 </TR>
 <TR>
-       <TD NOWRAP><TT>CUPS-Get-Document</TT></TD>
+       <TD NOWRAP><TT>CUPS-Set-Default</TT> *</TD>
        <TD>Yes</TD>
-       <TD>Retrieves a document file from a job.</TD>
+       <TD>Sets the server/network default printer or class.</TD>
 </TR>
 </TBODY>
 </TABLE></DIV>
@@ -477,7 +492,7 @@ HREF="ref-cupsd-conf.html#LimitIPP"><TT>Limit</TT></A> subsections which list th
 &lt;/Limit>
 </PRE>
 
-<P>The directives inside the <TT>Limit</TT> subsection can use any of the normal limiting directives: <A HREF="ref-cupsd-conf.html#Allow"><TT>Allow</TT></A>, <A HREF="ref-cupsd-conf.html#AuthType"><TT>AuthType</TT></A>, <A HREF="ref-cupsd-conf.html#Deny"><TT>Deny</TT></A>, <A HREF="ref-cupsd-conf.html#Encryption"><TT>Encryption</TT></A>, <A HREF="ref-cupsd-conf.html#Require"><TT>Require</TT></A>, and <A HREF="ref-cupsd-conf.html#Satisfy"><TT>Satisfy</TT></A>. <A HREF="#TABLE02">Table 2</A> lists some basic "recipes" for different access control rules.</P>
+<P>The directives inside the <TT>Limit</TT> subsection can use any of the normal limiting directives: <A HREF="man-cupsd.conf.html#Allow"><TT>Allow</TT></A>, <A HREF="man-cupsd.conf.html#AuthType"><TT>AuthType</TT></A>, <A HREF="man-cupsd.conf.html#Deny"><TT>Deny</TT></A>, <A HREF="man-cupsd.conf.html#Encryption"><TT>Encryption</TT></A>, <A HREF="man-cupsd.conf.html#Require"><TT>Require</TT></A>, and <A HREF="man-cupsd.conf.html#Satisfy"><TT>Satisfy</TT></A>. <A HREF="#TABLE02">Table 2</A> lists some basic "recipes" for different access control rules.</P>
 
 <DIV CLASS="table"><TABLE WIDTH="80%" SUMMARY="Access Control Recipes">
 <CAPTION>Table 2: <A NAME="TABLE02">Access Control Recipes</A></CAPTION>
@@ -584,7 +599,7 @@ Allow from @LOCAL</PRE></TD>
 
 <H2 CLASS="title"><A NAME="SELECT">Using Policies</A></H2>
 
-<P>Once you have created a policy, you can use it in two ways. The first way is to assign it as the default policy for the system using the <A HREF="ref-cupsd-conf.html#DefaultPolicy"><TT>DefaultPolicy</TT></A> directive in the <VAR>cupsd.conf</VAR> file. For example, add the following line to the <VAR>cupsd.conf</VAR> file to use the "lab999" policy from the previous section:</P>
+<P>Once you have created a policy, you can use it in two ways. The first way is to assign it as the default policy for the system using the <A HREF="man-cupsd.conf.html#DefaultPolicy"><TT>DefaultPolicy</TT></A> directive in the <VAR>cupsd.conf</VAR> file. For example, add the following line to the <VAR>cupsd.conf</VAR> file to use the "lab999" policy from the previous section:</P>
 
 <PRE CLASS="example">
 DefaultPolicy lab999