1*5e7646d2SAndroid Build Coastguard Worker<!DOCTYPE HTML> 2*5e7646d2SAndroid Build Coastguard Worker<html> 3*5e7646d2SAndroid Build Coastguard Worker<!-- SECTION: Man Pages --> 4*5e7646d2SAndroid Build Coastguard Worker<head> 5*5e7646d2SAndroid Build Coastguard Worker <link rel="stylesheet" type="text/css" href="../cups-printable.css"> 6*5e7646d2SAndroid Build Coastguard Worker <title>cupsd.conf(5)</title> 7*5e7646d2SAndroid Build Coastguard Worker</head> 8*5e7646d2SAndroid Build Coastguard Worker<body> 9*5e7646d2SAndroid Build Coastguard Worker<h1 class="title">cupsd.conf(5)</h1> 10*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NAME">Name</a></h2> 11*5e7646d2SAndroid Build Coastguard Workercupsd.conf - server configuration file for cups 12*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="DESCRIPTION">Description</a></h2> 13*5e7646d2SAndroid Build Coastguard WorkerThe 14*5e7646d2SAndroid Build Coastguard Worker<i>cupsd.conf</i> 15*5e7646d2SAndroid Build Coastguard Workerfile configures the CUPS scheduler, 16*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8). 17*5e7646d2SAndroid Build Coastguard WorkerIt is normally located in the 18*5e7646d2SAndroid Build Coastguard Worker<i>/etc/cups</i> 19*5e7646d2SAndroid Build Coastguard Workerdirectory. 20*5e7646d2SAndroid Build Coastguard WorkerEach line in the file can be a configuration directive, a blank line, or a comment. 21*5e7646d2SAndroid Build Coastguard WorkerConfiguration directives typically consist of a name and zero or more values separated by whitespace. 22*5e7646d2SAndroid Build Coastguard WorkerThe configuration directive name and values are case-insensitive. 23*5e7646d2SAndroid Build Coastguard WorkerComment lines start with the # character. 24*5e7646d2SAndroid Build Coastguard Worker<h3><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h3> 25*5e7646d2SAndroid Build Coastguard WorkerThe following top-level directives are understood by 26*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8): 27*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 28*5e7646d2SAndroid Build Coastguard Worker<dt><a name="AccessLogLevel"></a><b>AccessLogLevel config</b> 29*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>AccessLogLevel actions</b> 30*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>AccessLogLevel all</b> 31*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the logging level for the AccessLog file. 32*5e7646d2SAndroid Build Coastguard WorkerThe "config" level logs when printers and classes are added, deleted, or modified and when configuration files are accessed or updated. 33*5e7646d2SAndroid Build Coastguard WorkerThe "actions" level logs when print jobs are submitted, held, released, modified, or canceled, and any of the conditions for "config". 34*5e7646d2SAndroid Build Coastguard WorkerThe "all" level logs all requests. 35*5e7646d2SAndroid Build Coastguard WorkerThe default access log level is "actions". 36*5e7646d2SAndroid Build Coastguard Worker<dt><a name="AutoPurgeJobs"></a><b>AutoPurgeJobs Yes</b> 37*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>AutoPurgeJobs No</b> 38*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><br> 39*5e7646d2SAndroid Build Coastguard WorkerSpecifies whether to purge job history data automatically when it is no longer required for quotas. 40*5e7646d2SAndroid Build Coastguard WorkerThe default is "No". 41*5e7646d2SAndroid Build Coastguard Worker<dt><a name="BrowseDNSSDSubTypes"></a><b>BrowseDNSSDSubTypes</b><i>_subtype[,...]</i> 42*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies a list of Bonjour sub-types to advertise for each shared printer. 43*5e7646d2SAndroid Build Coastguard WorkerFor example, "BrowseDNSSDSubTypes _cups,_print" will tell network clients that both CUPS sharing and IPP Everywhere are supported. 44*5e7646d2SAndroid Build Coastguard WorkerThe default is "_cups" which is necessary for printer sharing to work between systems using CUPS. 45*5e7646d2SAndroid Build Coastguard Worker<dt><a name="BrowseLocalProtocols"></a><b>BrowseLocalProtocols all</b> 46*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>BrowseLocalProtocols dnssd</b> 47*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>BrowseLocalProtocols none</b> 48*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies which protocols to use for local printer sharing. 49*5e7646d2SAndroid Build Coastguard WorkerThe default is "dnssd" on systems that support Bonjour and "none" otherwise. 50*5e7646d2SAndroid Build Coastguard Worker<dt><a name="BrowseWebIF"></a><b>BrowseWebIF Yes</b> 51*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>BrowseWebIF No</b> 52*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><br> 53*5e7646d2SAndroid Build Coastguard WorkerSpecifies whether the CUPS web interface is advertised. 54*5e7646d2SAndroid Build Coastguard WorkerThe default is "No". 55*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Browsing"></a><b>Browsing Yes</b> 56*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Browsing No</b> 57*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><br> 58*5e7646d2SAndroid Build Coastguard WorkerSpecifies whether shared printers are advertised. 59*5e7646d2SAndroid Build Coastguard WorkerThe default is "No". 60*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DefaultAuthType"></a><b>DefaultAuthType Basic</b> 61*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>DefaultAuthType Negotiate</b> 62*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><br> 63*5e7646d2SAndroid Build Coastguard WorkerSpecifies the default type of authentication to use. 64*5e7646d2SAndroid Build Coastguard WorkerThe default is "Basic". 65*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DefaultEncryption"></a><b>DefaultEncryption Never</b> 66*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>DefaultEncryption IfRequested</b> 67*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>DefaultEncryption Required</b> 68*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether encryption will be used for authenticated requests. 69*5e7646d2SAndroid Build Coastguard WorkerThe default is "Required". 70*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DefaultLanguage"></a><b>DefaultLanguage </b><i>locale</i> 71*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the default language to use for text and web content. 72*5e7646d2SAndroid Build Coastguard WorkerThe default is "en". 73*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DefaultPaperSize"></a><b>DefaultPaperSize Auto</b> 74*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>DefaultPaperSize None</b> 75*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>DefaultPaperSize </b><i>sizename</i> 76*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the default paper size for new print queues. "Auto" uses a locale-specific default, while "None" specifies there is no default paper size. 77*5e7646d2SAndroid Build Coastguard WorkerSpecific size names are typically "Letter" or "A4". 78*5e7646d2SAndroid Build Coastguard WorkerThe default is "Auto". 79*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DefaultPolicy"></a><b>DefaultPolicy </b><i>policy-name</i> 80*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the default access policy to use. 81*5e7646d2SAndroid Build Coastguard WorkerThe default access policy is "default". 82*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DefaultShared"></a><b>DefaultShared Yes</b> 83*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>DefaultShared No</b> 84*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether local printers are shared by default. 85*5e7646d2SAndroid Build Coastguard WorkerThe default is "Yes". 86*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DirtyCleanInterval"></a><b>DirtyCleanInterval </b><i>seconds</i> 87*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the delay for updating of configuration and state files. 88*5e7646d2SAndroid Build Coastguard WorkerA value of 0 causes the update to happen as soon as possible, typically within a few milliseconds. 89*5e7646d2SAndroid Build Coastguard WorkerThe default value is "30". 90*5e7646d2SAndroid Build Coastguard Worker<dt><a name="DNSSDHostName"></a><b>DNSSDHostName</b><i>hostname.example.com</i> 91*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the fully-qualified domain name for the server that is used for Bonjour sharing. 92*5e7646d2SAndroid Build Coastguard WorkerThe default is typically the server's ".local" hostname. 93*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ErrorPolicy"></a><b>ErrorPolicy abort-job</b> 94*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that a failed print job should be aborted (discarded) unless otherwise specified for the printer. 95*5e7646d2SAndroid Build Coastguard Worker<dt><b>ErrorPolicy retry-current-job</b> 96*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that a failed print job should be retried immediately unless otherwise specified for the printer. 97*5e7646d2SAndroid Build Coastguard Worker<dt><b>ErrorPolicy retry-job</b> 98*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that a failed print job should be retried at a later time unless otherwise specified for the printer. 99*5e7646d2SAndroid Build Coastguard Worker<dt><b>ErrorPolicy stop-printer</b> 100*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that a failed print job should stop the printer unless otherwise specified for the printer. The 'stop-printer' error policy is the default. 101*5e7646d2SAndroid Build Coastguard Worker<dt><a name="FilterLimit"></a><b>FilterLimit </b><i>limit</i> 102*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum cost of filters that are run concurrently, which can be used to minimize disk, memory, and CPU resource problems. 103*5e7646d2SAndroid Build Coastguard WorkerA limit of 0 disables filter limiting. 104*5e7646d2SAndroid Build Coastguard WorkerAn average print to a non-PostScript printer needs a filter limit of about 200. 105*5e7646d2SAndroid Build Coastguard WorkerA PostScript printer needs about half that (100). 106*5e7646d2SAndroid Build Coastguard WorkerSetting the limit below these thresholds will effectively limit the scheduler to printing a single job at any time. 107*5e7646d2SAndroid Build Coastguard WorkerThe default limit is "0". 108*5e7646d2SAndroid Build Coastguard Worker<dt><a name="FilterNice"></a><b>FilterNice </b><i>nice-value</i> 109*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the scheduling priority ( 110*5e7646d2SAndroid Build Coastguard Worker<b>nice</b>(8) 111*5e7646d2SAndroid Build Coastguard Workervalue) of filters that are run to print a job. 112*5e7646d2SAndroid Build Coastguard WorkerThe nice value ranges from 0, the highest priority, to 19, the lowest priority. 113*5e7646d2SAndroid Build Coastguard WorkerThe default is 0. 114*5e7646d2SAndroid Build Coastguard Worker<dt><a name="GSSServiceName"></a><b>GSSServiceName </b><i>name</i> 115*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the service name when using Kerberos authentication. 116*5e7646d2SAndroid Build Coastguard WorkerThe default service name is "http." 117*5e7646d2SAndroid Build Coastguard Worker<dt><b>HostNameLookups On</b> 118*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><a name="HostNameLookups"></a><b>HostNameLookups Off</b> 119*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>HostNameLookups Double</b> 120*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether to do reverse lookups on connecting clients. 121*5e7646d2SAndroid Build Coastguard WorkerThe "Double" setting causes 122*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8) 123*5e7646d2SAndroid Build Coastguard Workerto verify that the hostname resolved from the address matches one of the addresses returned for that hostname. 124*5e7646d2SAndroid Build Coastguard WorkerDouble lookups also prevent clients with unregistered addresses from connecting to your server. 125*5e7646d2SAndroid Build Coastguard WorkerThe default is "Off" to avoid the potential server performance problems with hostname lookups. 126*5e7646d2SAndroid Build Coastguard WorkerOnly set this option to "On" or "Double" if absolutely required. 127*5e7646d2SAndroid Build Coastguard Worker<dt><a name="IdleExitTimeout"></a><b>IdleExitTimeout </b><i>seconds</i> 128*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the length of time to wait before shutting down due to inactivity. 129*5e7646d2SAndroid Build Coastguard WorkerThe default is "60" seconds. 130*5e7646d2SAndroid Build Coastguard WorkerNote: Only applicable when 131*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8) 132*5e7646d2SAndroid Build Coastguard Workeris run on-demand (e.g., with <b>-l</b>). 133*5e7646d2SAndroid Build Coastguard Worker<dt><a name="JobKillDelay"></a><b>JobKillDelay </b><i>seconds</i> 134*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the number of seconds to wait before killing the filters and backend associated with a canceled or held job. 135*5e7646d2SAndroid Build Coastguard WorkerThe default is "30". 136*5e7646d2SAndroid Build Coastguard Worker<dt><a name="JobRetryInterval"></a><b>JobRetryInterval </b><i>seconds</i> 137*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the interval between retries of jobs in seconds. 138*5e7646d2SAndroid Build Coastguard WorkerThis is typically used for fax queues but can also be used with normal print queues whose error policy is "retry-job" or "retry-current-job". 139*5e7646d2SAndroid Build Coastguard WorkerThe default is "30". 140*5e7646d2SAndroid Build Coastguard Worker<dt><a name="JobRetryLimit"></a><b>JobRetryLimit </b><i>count</i> 141*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the number of retries that are done for jobs. 142*5e7646d2SAndroid Build Coastguard WorkerThis is typically used for fax queues but can also be used with normal print queues whose error policy is "retry-job" or "retry-current-job". 143*5e7646d2SAndroid Build Coastguard WorkerThe default is "5". 144*5e7646d2SAndroid Build Coastguard Worker<dt><a name="KeepAlive"></a><b>KeepAlive Yes</b> 145*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>KeepAlive No</b> 146*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether to support HTTP keep-alive connections. 147*5e7646d2SAndroid Build Coastguard WorkerThe default is "Yes". 148*5e7646d2SAndroid Build Coastguard Worker<dt><a name="LimitIPP"></a><b><Limit </b><i>operation </i>...<b>> </b>... <b></Limit></b> 149*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the IPP operations that are being limited inside a Policy section. IPP operation names are listed below in the section "IPP OPERATION NAMES". 150*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Limit"></a><b><Limit </b><i>method </i>...<b>> </b>... <b></Limit></b> 151*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><a name="LimitExcept"></a><b><LimitExcept </b><i>method </i>...<b>> </b>... <b></LimitExcept></b> 152*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the HTTP methods that are being limited inside a Location section. HTTP method names are listed below in the section "HTTP METHOD NAMES". 153*5e7646d2SAndroid Build Coastguard Worker<dt><a name="LimitRequestBody"></a><b>LimitRequestBody </b><i>size</i> 154*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum size of print files, IPP requests, and HTML form data. 155*5e7646d2SAndroid Build Coastguard WorkerThe default is "0" which disables the limit check. 156*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Listen"></a><b>Listen </b><i>ipv4-address</i><b>:</b><i>port</i> 157*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Listen [</b><i>ipv6-address</i><b>]:</b><i>port</i> 158*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Listen *:</b><i>port</i> 159*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Listen </b><i>/path/to/domain/socket</i> 160*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Listens to the specified address and port or domain socket path for connections. 161*5e7646d2SAndroid Build Coastguard WorkerMultiple Listen directives can be provided to listen on multiple addresses. 162*5e7646d2SAndroid Build Coastguard WorkerThe Listen directive is similar to the Port directive but allows you to restrict access to specific interfaces or networks. 163*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Location"></a><b><Location </b><i>/path</i><b>> </b>... <b></Location></b> 164*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies access control for the named location. 165*5e7646d2SAndroid Build Coastguard WorkerPaths are documented below in the section "LOCATION PATHS". 166*5e7646d2SAndroid Build Coastguard Worker<dt><a name="LogDebugHistory"></a><b>LogDebugHistory </b><i>number</i> 167*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the number of debugging messages that are retained for logging if an error occurs in a print job. Debug messages are logged regardless of the LogLevel setting. 168*5e7646d2SAndroid Build Coastguard Worker<dt><a name="LogLevel"></a><b>LogLevel </b>none 169*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>emerg 170*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>alert 171*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>crit 172*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>error 173*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>warn 174*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>notice 175*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>info 176*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>debug 177*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogLevel </b>debug2 178*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the level of logging for the ErrorLog file. 179*5e7646d2SAndroid Build Coastguard WorkerThe value "none" stops all logging while "debug2" logs everything. 180*5e7646d2SAndroid Build Coastguard WorkerThe default is "warn". 181*5e7646d2SAndroid Build Coastguard Worker<dt><a name="LogTimeFormat"></a><b>LogTimeFormat </b>standard 182*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>LogTimeFormat </b>usecs 183*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the format of the date and time in the log files. 184*5e7646d2SAndroid Build Coastguard WorkerThe value "standard" is the default and logs whole seconds while "usecs" logs microseconds. 185*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxClients"></a><b>MaxClients </b><i>number</i> 186*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients that are allowed by the scheduler. 187*5e7646d2SAndroid Build Coastguard WorkerThe default is "100". 188*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxClientPerHost"></a><b>MaxClientsPerHost </b><i>number</i> 189*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous clients that are allowed from a 190*5e7646d2SAndroid Build Coastguard Workersingle address. 191*5e7646d2SAndroid Build Coastguard WorkerThe default is the MaxClients value. 192*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxCopies"></a><b>MaxCopies </b><i>number</i> 193*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum number of copies that a user can print of each job. 194*5e7646d2SAndroid Build Coastguard WorkerThe default is "9999". 195*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxHoldTime"></a><b>MaxHoldTime </b><i>seconds</i> 196*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum time a job may remain in the "indefinite" hold state before it is canceled. 197*5e7646d2SAndroid Build Coastguard WorkerThe default is "0" which disables cancellation of held jobs. 198*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxJobs"></a><b>MaxJobs </b><i>number</i> 199*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs that are allowed. 200*5e7646d2SAndroid Build Coastguard WorkerSet to "0" to allow an unlimited number of jobs. 201*5e7646d2SAndroid Build Coastguard WorkerThe default is "500". 202*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxJobsPerPrinter"></a><b>MaxJobsPerPrinter </b><i>number</i> 203*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs that are allowed per printer. 204*5e7646d2SAndroid Build Coastguard WorkerThe default is "0" which allows up to MaxJobs jobs per printer. 205*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxJobsPerUser"></a><b>MaxJobsPerUser </b><i>number</i> 206*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum number of simultaneous jobs that are allowed per user. 207*5e7646d2SAndroid Build Coastguard WorkerThe default is "0" which allows up to MaxJobs jobs per user. 208*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxJobTime"></a><b>MaxJobTime </b><i>seconds</i> 209*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum time a job may take to print before it is canceled. 210*5e7646d2SAndroid Build Coastguard WorkerSet to "0" to disable cancellation of "stuck" jobs. 211*5e7646d2SAndroid Build Coastguard WorkerThe default is "10800" (3 hours). 212*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MaxLogSize"></a><b>MaxLogSize </b><i>size</i> 213*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum size of the log files before they are rotated. 214*5e7646d2SAndroid Build Coastguard WorkerThe value "0" disables log rotation. 215*5e7646d2SAndroid Build Coastguard WorkerThe default is "1048576" (1MB). 216*5e7646d2SAndroid Build Coastguard Worker<dt><a name="MultipleOperationTimeout"></a><b>MultipleOperationTimeout </b><i>seconds</i> 217*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum amount of time to allow between files in a multiple file print job. 218*5e7646d2SAndroid Build Coastguard WorkerThe default is "900" (15 minutes). 219*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Policy"></a><b><Policy </b><i>name</i><b>> </b>... <b></Policy></b> 220*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies access control for the named policy. 221*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Port"></a><b>Port </b><i>number</i> 222*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Listens to the specified port number for connections. 223*5e7646d2SAndroid Build Coastguard Worker<dt><a name="PreserveJobFiles"></a><b>PreserveJobFiles Yes</b> 224*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>PreserveJobFiles No</b> 225*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>PreserveJobFiles </b><i>seconds</i> 226*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether job files (documents) are preserved after a job is printed. 227*5e7646d2SAndroid Build Coastguard WorkerIf a numeric value is specified, job files are preserved for the indicated number of seconds after printing. 228*5e7646d2SAndroid Build Coastguard WorkerThe default is "86400" (preserve 1 day). 229*5e7646d2SAndroid Build Coastguard Worker<dt><a name="PreserveJobHistory"></a><b>PreserveJobHistory Yes</b> 230*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>PreserveJobHistory No</b> 231*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>PreserveJobHistory </b><i>seconds</i> 232*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether the job history is preserved after a job is printed. 233*5e7646d2SAndroid Build Coastguard WorkerIf a numeric value is specified, the job history is preserved for the indicated number of seconds after printing. 234*5e7646d2SAndroid Build Coastguard WorkerIf "Yes", the job history is preserved until the MaxJobs limit is reached. 235*5e7646d2SAndroid Build Coastguard WorkerThe default is "Yes". 236*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ReloadTimeout"></a><b>ReloadTimeout </b><i>seconds</i> 237*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the amount of time to wait for job completion before restarting the scheduler. 238*5e7646d2SAndroid Build Coastguard WorkerThe default is "30". 239*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ServerAdmin"></a><b>ServerAdmin </b><i>email-address</i> 240*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the email address of the server administrator. 241*5e7646d2SAndroid Build Coastguard WorkerThe default value is "root@ServerName". 242*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ServerAlias"></a><b>ServerAlias </b><i>hostname </i>[ ... <i>hostname </i>] 243*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerAlias *</b> 244*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The ServerAlias directive is used for HTTP Host header validation when clients connect to the scheduler from external interfaces. 245*5e7646d2SAndroid Build Coastguard WorkerUsing the special name "*" can expose your system to known browser-based DNS rebinding attacks, even when accessing sites through a firewall. 246*5e7646d2SAndroid Build Coastguard WorkerIf the auto-discovery of alternate names does not work, we recommend listing each alternate name with a ServerAlias directive instead of using "*". 247*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ServerName"></a><b>ServerName </b><i>hostname</i> 248*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the fully-qualified hostname of the server. 249*5e7646d2SAndroid Build Coastguard WorkerThe default is the value reported by the 250*5e7646d2SAndroid Build Coastguard Worker<b>hostname</b>(1) 251*5e7646d2SAndroid Build Coastguard Workercommand. 252*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ServerTokens"></a><b>ServerTokens None</b> 253*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerTokens ProductOnly</b> 254*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerTokens Major</b> 255*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerTokens Minor</b> 256*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerTokens Minimal</b> 257*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerTokens OS</b> 258*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ServerTokens Full</b> 259*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies what information is included in the Server header of HTTP responses. 260*5e7646d2SAndroid Build Coastguard Worker"None" disables the Server header. 261*5e7646d2SAndroid Build Coastguard Worker"ProductOnly" reports "CUPS". 262*5e7646d2SAndroid Build Coastguard Worker"Major" reports "CUPS/major IPP/2". 263*5e7646d2SAndroid Build Coastguard Worker"Minor" reports "CUPS/major.minor IPP/2.1". 264*5e7646d2SAndroid Build Coastguard Worker"Minimal" reports "CUPS/major.minor.patch IPP/2.1". 265*5e7646d2SAndroid Build Coastguard Worker"OS" reports "CUPS/major.minor.path (osname osversion) IPP/2.1". 266*5e7646d2SAndroid Build Coastguard Worker"Full" reports "CUPS/major.minor.path (osname osversion; architecture) IPP/2.1". 267*5e7646d2SAndroid Build Coastguard WorkerThe default is "Minimal". 268*5e7646d2SAndroid Build Coastguard Worker<dt><a name="SSLListen"></a><b>SSLListen </b><i>ipv4-address</i><b>:</b><i>port</i> 269*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SSLListen [</b><i>ipv6-address</i><b>]:</b><i>port</i> 270*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SSLListen *:</b><i>port</i> 271*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Listens on the specified address and port for encrypted connections. 272*5e7646d2SAndroid Build Coastguard Worker<dt><a name="SSLOptions"></a><dt><b>SSLOptions </b>[<i>AllowDH</i>] [<i>AllowRC4</i>] [<i>AllowSSL3</i>] [<i>DenyCBC</i>] [<i>DenyTLS1.0</i>] [<i>MaxTLS1.0</i>] [<i>MaxTLS1.1</i>] [<i>MaxTLS1.2</i>] [<i>MaxTLS1.3</i>] [<i>MinTLS1.0</i>] [<i>MinTLS1.1</i>] [<i>MinTLS1.2</i>] [<i>MinTLS1.3</i>] 273*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SSLOptions None</b> 274*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets encryption options (only in /etc/cups/client.conf). 275*5e7646d2SAndroid Build Coastguard WorkerBy default, CUPS only supports encryption using TLS v1.0 or higher using known secure cipher suites. 276*5e7646d2SAndroid Build Coastguard WorkerSecurity is reduced when <i>Allow</i> options are used. 277*5e7646d2SAndroid Build Coastguard WorkerSecurity is enhanced when <i>Deny</i> options are used. 278*5e7646d2SAndroid Build Coastguard WorkerThe <i>AllowDH</i> option enables cipher suites using plain Diffie-Hellman key negotiation (not supported on systems using GNU TLS). 279*5e7646d2SAndroid Build Coastguard WorkerThe <i>AllowRC4</i> option enables the 128-bit RC4 cipher suites, which are required for some older clients. 280*5e7646d2SAndroid Build Coastguard WorkerThe <i>AllowSSL3</i> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0. 281*5e7646d2SAndroid Build Coastguard WorkerThe <i>DenyCBC</i> option disables all CBC cipher suites. 282*5e7646d2SAndroid Build Coastguard WorkerThe <i>DenyTLS1.0</i> option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1. 283*5e7646d2SAndroid Build Coastguard WorkerThe <i>MinTLS</i> options set the minimum TLS version to support. 284*5e7646d2SAndroid Build Coastguard WorkerThe <i>MaxTLS</i> options set the maximum TLS version to support. 285*5e7646d2SAndroid Build Coastguard WorkerNot all operating systems support TLS 1.3 at this time. 286*5e7646d2SAndroid Build Coastguard Worker<dt><a name="SSLPort"></a><b>SSLPort </b><i>port</i> 287*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Listens on the specified port for encrypted connections. 288*5e7646d2SAndroid Build Coastguard Worker<dt><a name="StrictConformance"></a><b>StrictConformance Yes</b> 289*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>StrictConformance No</b> 290*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether the scheduler requires clients to strictly adhere to the IPP specifications. 291*5e7646d2SAndroid Build Coastguard WorkerThe default is "No". 292*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Timeout"></a><b>Timeout </b><i>seconds</i> 293*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the HTTP request timeout. 294*5e7646d2SAndroid Build Coastguard WorkerThe default is "900" (15 minutes). 295*5e7646d2SAndroid Build Coastguard Worker<dt><a name="WebInterface"></a><b>WebInterface yes</b> 296*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>WebInterface no</b> 297*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies whether the web interface is enabled. 298*5e7646d2SAndroid Build Coastguard WorkerThe default is "No". 299*5e7646d2SAndroid Build Coastguard Worker</dl> 300*5e7646d2SAndroid Build Coastguard Worker<h3><a name="HTTP_METHOD_NAMES">Http Method Names</a></h3> 301*5e7646d2SAndroid Build Coastguard WorkerThe following HTTP methods are supported by 302*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8): 303*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 304*5e7646d2SAndroid Build Coastguard Worker<dt>GET 305*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Used by a client to download icons and other printer resources and to access the CUPS web interface. 306*5e7646d2SAndroid Build Coastguard Worker<dt>HEAD 307*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Used by a client to get the type, size, and modification date of resources. 308*5e7646d2SAndroid Build Coastguard Worker<dt>OPTIONS 309*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Used by a client to establish a secure (SSL/TLS) connection. 310*5e7646d2SAndroid Build Coastguard Worker<dt>POST 311*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Used by a client to submit IPP requests and HTML forms from the CUPS web interface. 312*5e7646d2SAndroid Build Coastguard Worker<dt>PUT 313*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Used by a client to upload configuration files. 314*5e7646d2SAndroid Build Coastguard Worker</dl> 315*5e7646d2SAndroid Build Coastguard Worker<h3><a name="IPP_OPERATION_NAMES">Ipp Operation Names</a></h3> 316*5e7646d2SAndroid Build Coastguard WorkerThe following IPP operations are supported by 317*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8): 318*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 319*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Accept-Jobs 320*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Allows a printer to accept new jobs. 321*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Add-Modify-Class 322*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Adds or modifies a printer class. 323*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Add-Modify-Printer 324*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Adds or modifies a printer. 325*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Authenticate-Job 326*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Releases a job that is held for authentication. 327*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Delete-Class 328*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Deletes a printer class. 329*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Delete-Printer 330*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Deletes a printer. 331*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-Classes 332*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of printer classes. 333*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-Default 334*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets the server default printer or printer class. 335*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-Devices 336*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of devices that are currently available. 337*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-Document 338*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a document file for a job. 339*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-PPD 340*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a PPD file. 341*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-PPDs 342*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of installed PPD files. 343*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Get-Printers 344*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of printers. 345*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Move-Job 346*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Moves a job. 347*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Reject-Jobs 348*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Prevents a printer from accepting new jobs. 349*5e7646d2SAndroid Build Coastguard Worker<dt>CUPS-Set-Default 350*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Sets the server default printer or printer class. 351*5e7646d2SAndroid Build Coastguard Worker<dt>Cancel-Job 352*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Cancels a job. 353*5e7646d2SAndroid Build Coastguard Worker<dt>Cancel-Jobs 354*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Cancels one or more jobs. 355*5e7646d2SAndroid Build Coastguard Worker<dt>Cancel-My-Jobs 356*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Cancels one or more jobs creates by a user. 357*5e7646d2SAndroid Build Coastguard Worker<dt>Cancel-Subscription 358*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Cancels a subscription. 359*5e7646d2SAndroid Build Coastguard Worker<dt>Close-Job 360*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Closes a job that is waiting for more documents. 361*5e7646d2SAndroid Build Coastguard Worker<dt>Create-Job 362*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Creates a new job with no documents. 363*5e7646d2SAndroid Build Coastguard Worker<dt>Create-Job-Subscriptions 364*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Creates a subscription for job events. 365*5e7646d2SAndroid Build Coastguard Worker<dt>Create-Printer-Subscriptions 366*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Creates a subscription for printer events. 367*5e7646d2SAndroid Build Coastguard Worker<dt>Get-Job-Attributes 368*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets information about a job. 369*5e7646d2SAndroid Build Coastguard Worker<dt>Get-Jobs 370*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of jobs. 371*5e7646d2SAndroid Build Coastguard Worker<dt>Get-Notifications 372*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of event notifications for a subscription. 373*5e7646d2SAndroid Build Coastguard Worker<dt>Get-Printer-Attributes 374*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets information about a printer or printer class. 375*5e7646d2SAndroid Build Coastguard Worker<dt>Get-Subscription-Attributes 376*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets information about a subscription. 377*5e7646d2SAndroid Build Coastguard Worker<dt>Get-Subscriptions 378*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Gets a list of subscriptions. 379*5e7646d2SAndroid Build Coastguard Worker<dt>Hold-Job 380*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Holds a job from printing. 381*5e7646d2SAndroid Build Coastguard Worker<dt>Hold-New-Jobs 382*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Holds all new jobs from printing. 383*5e7646d2SAndroid Build Coastguard Worker<dt>Pause-Printer 384*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Stops processing of jobs by a printer or printer class. 385*5e7646d2SAndroid Build Coastguard Worker<dt>Pause-Printer-After-Current-Job 386*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Stops processing of jobs by a printer or printer class after the current job is finished. 387*5e7646d2SAndroid Build Coastguard Worker<dt>Print-Job 388*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Creates a new job with a single document. 389*5e7646d2SAndroid Build Coastguard Worker<dt>Purge-Jobs 390*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Cancels one or more jobs and deletes the job history. 391*5e7646d2SAndroid Build Coastguard Worker<dt>Release-Held-New-Jobs 392*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Allows previously held jobs to print. 393*5e7646d2SAndroid Build Coastguard Worker<dt>Release-Job 394*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Allows a job to print. 395*5e7646d2SAndroid Build Coastguard Worker<dt>Renew-Subscription 396*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Renews a subscription. 397*5e7646d2SAndroid Build Coastguard Worker<dt>Restart-Job 398*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Reprints a job, if possible. 399*5e7646d2SAndroid Build Coastguard Worker<dt>Send-Document 400*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Adds a document to a job. 401*5e7646d2SAndroid Build Coastguard Worker<dt>Set-Job-Attributes 402*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Changes job information. 403*5e7646d2SAndroid Build Coastguard Worker<dt>Set-Printer-Attributes 404*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Changes printer or printer class information. 405*5e7646d2SAndroid Build Coastguard Worker<dt>Validate-Job 406*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Validates options for a new job. 407*5e7646d2SAndroid Build Coastguard Worker</dl> 408*5e7646d2SAndroid Build Coastguard Worker<h3><a name="LOCATION_PATHS">Location Paths</a></h3> 409*5e7646d2SAndroid Build Coastguard WorkerThe following paths are commonly used when configuring 410*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8): 411*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 412*5e7646d2SAndroid Build Coastguard Worker<dt>/ 413*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for all get operations (get-printers, get-jobs, etc.) 414*5e7646d2SAndroid Build Coastguard Worker<dt>/admin 415*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for all administration operations (add-printer, delete-printer, start-printer, etc.) 416*5e7646d2SAndroid Build Coastguard Worker<dt>/admin/conf 417*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for access to the CUPS configuration files (cupsd.conf, client.conf, etc.) 418*5e7646d2SAndroid Build Coastguard Worker<dt>/admin/log 419*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for access to the CUPS log files (access_log, error_log, page_log) 420*5e7646d2SAndroid Build Coastguard Worker<dt>/classes 421*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for all printer classes 422*5e7646d2SAndroid Build Coastguard Worker<dt>/classes/name 423*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The resource for the named printer class 424*5e7646d2SAndroid Build Coastguard Worker<dt>/jobs 425*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for all jobs (hold-job, release-job, etc.) 426*5e7646d2SAndroid Build Coastguard Worker<dt>/jobs/id 427*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for the specified job 428*5e7646d2SAndroid Build Coastguard Worker<dt>/printers 429*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for all printers 430*5e7646d2SAndroid Build Coastguard Worker<dt>/printers/name 431*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The path for the named printer 432*5e7646d2SAndroid Build Coastguard Worker<dt>/printers/name.png 433*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The icon file path for the named printer 434*5e7646d2SAndroid Build Coastguard Worker<dt>/printers/name.ppd 435*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">The PPD file path for the named printer 436*5e7646d2SAndroid Build Coastguard Worker</dl> 437*5e7646d2SAndroid Build Coastguard Worker<h3><a name="DIRECTIVES_VALID_WITHIN_LOCATION_AND_LIMIT_SECTIONS">Directives Valid Within Location And Limit Sections</a></h3> 438*5e7646d2SAndroid Build Coastguard WorkerThe following directives may be placed inside Location and Limit sections in the <b>cupsd.conf</b> file: 439*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 440*5e7646d2SAndroid Build Coastguard Worker<dt><b>Allow all</b> 441*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow none</b> 442*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>host.domain.com</i> 443*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow *.</b><i>domain.com</i> 444*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>ipv4-address</i> 445*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>ipv4-address</i><b>/</b><i>netmask</i> 446*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow </b><i>ipv4-address</i><b>/</b><i>mm</i> 447*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow [</b><i>ipv6-address</i><b>]</b> 448*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow [</b><i>ipv6-address</i><b>]/</b><i>mm</i> 449*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow @IF(</b><i>name</i><b>)</b> 450*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Allow @LOCAL</b> 451*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Allows access from the named hosts, domains, addresses, or interfaces. 452*5e7646d2SAndroid Build Coastguard WorkerThe @IF(name) form uses the current subnets configured for the named interface. 453*5e7646d2SAndroid Build Coastguard WorkerThe @LOCAL form uses the current subnets configured for all interfaces that are not point-to-point, for example Ethernet and Wi-Fi interfaces are used but DSL and VPN interfaces are not. 454*5e7646d2SAndroid Build Coastguard WorkerThe Order directive controls whether Allow lines are evaluated before or after Deny lines. 455*5e7646d2SAndroid Build Coastguard Worker<dt><b>AuthType None</b> 456*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>AuthType Basic</b> 457*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>AuthType Default</b> 458*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>AuthType Negotiate</b> 459*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the type of authentication required. 460*5e7646d2SAndroid Build Coastguard WorkerThe value "Default" corresponds to the DefaultAuthType value. 461*5e7646d2SAndroid Build Coastguard Worker<dt><b>Deny all</b> 462*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny none</b> 463*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>host.domain.com</i> 464*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny *.</b><i>domain.com</i> 465*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>ipv4-address</i> 466*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>ipv4-address</i><b>/</b><i>netmask</i> 467*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny </b><i>ipv4-address</i><b>/</b><i>mm</i> 468*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny [</b><i>ipv6-address</i><b>]</b> 469*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny [</b><i>ipv6-address</i><b>]/</b><i>mm</i> 470*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny @IF(</b><i>name</i><b>)</b> 471*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Deny @LOCAL</b> 472*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Denies access from the named hosts, domains, addresses, or interfaces. 473*5e7646d2SAndroid Build Coastguard WorkerThe @IF(name) form uses the current subnets configured for the named interface. 474*5e7646d2SAndroid Build Coastguard WorkerThe @LOCAL form uses the current subnets configured for all interfaces that are not point-to-point, for example Ethernet and Wi-Fi interfaces are used but DSL and VPN interfaces are not. 475*5e7646d2SAndroid Build Coastguard WorkerThe Order directive controls whether Deny lines are evaluated before or after Allow lines. 476*5e7646d2SAndroid Build Coastguard Worker<dt><b>Encryption IfRequested</b> 477*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Encryption Never</b> 478*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>Encryption Required</b> 479*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the level of encryption that is required for a particular location. 480*5e7646d2SAndroid Build Coastguard WorkerThe default value is "IfRequested". 481*5e7646d2SAndroid Build Coastguard Worker<dt><b>Order allow,deny</b> 482*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that access is denied by default. Allow lines are then processed followed by Deny lines to determine whether a client may access a particular resource. 483*5e7646d2SAndroid Build Coastguard Worker<dt><b>Order deny,allow</b> 484*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that access is allowed by default. Deny lines are then processed followed by Allow lines to determine whether a client may access a particular resource. 485*5e7646d2SAndroid Build Coastguard Worker<dt><b>Require group </b><i>group-name </i>[ <i>group-name </i>... ] 486*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that an authenticated user must be a member of one of the named groups. 487*5e7646d2SAndroid Build Coastguard Worker<dt><b>Require user {</b><i>user-name</i>|<b>@</b><i>group-name</i>} ... 488*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that an authenticated user must match one of the named users or be a member of one of the named groups. 489*5e7646d2SAndroid Build Coastguard WorkerThe group name "@SYSTEM" corresponds to the list of groups defined by the SystemGroup directive in the 490*5e7646d2SAndroid Build Coastguard Worker<b>cups-files.conf</b>(5) 491*5e7646d2SAndroid Build Coastguard Workerfile. 492*5e7646d2SAndroid Build Coastguard WorkerThe group name "@OWNER" corresponds to the owner of the resource, for example the person that submitted a print job. 493*5e7646d2SAndroid Build Coastguard WorkerNote: The 'root' user is not special and must be granted privileges like any other user account. 494*5e7646d2SAndroid Build Coastguard Worker<dt><b>Require valid-user</b> 495*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that any authenticated user is acceptable. 496*5e7646d2SAndroid Build Coastguard Worker<dt><b>Satisfy all</b> 497*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that all Allow, AuthType, Deny, Order, and Require conditions must be satisfied to allow access. 498*5e7646d2SAndroid Build Coastguard Worker<dt><b>Satisfy any</b> 499*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies that any a client may access a resource if either the authentication (AuthType/Require) or address (Allow/Deny/Order) conditions are satisfied. 500*5e7646d2SAndroid Build Coastguard WorkerFor example, this can be used to require authentication only for remote accesses. 501*5e7646d2SAndroid Build Coastguard Worker</dl> 502*5e7646d2SAndroid Build Coastguard Worker<h3><a name="DIRECTIVES_VALID_WITHIN_POLICY_SECTIONS">Directives Valid Within Policy Sections</a></h3> 503*5e7646d2SAndroid Build Coastguard WorkerThe following directives may be placed inside Policy sections in the <b>cupsd.conf</b> file: 504*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 505*5e7646d2SAndroid Build Coastguard Worker<dt><b>JobPrivateAccess all</b> 506*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>JobPrivateAccess default</b> 507*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>JobPrivateAccess </b>{<i>user</i>|<b>@</b><i>group</i>|<b>@ACL</b>|<b>@OWNER</b>|<b>@SYSTEM</b>} ... 508*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies an access list for a job's private values. 509*5e7646d2SAndroid Build Coastguard WorkerThe "default" access list is "@OWNER @SYSTEM". 510*5e7646d2SAndroid Build Coastguard Worker"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values. 511*5e7646d2SAndroid Build Coastguard Worker"@OWNER" maps to the job's owner. 512*5e7646d2SAndroid Build Coastguard Worker"@SYSTEM" maps to the groups listed for the SystemGroup directive in the 513*5e7646d2SAndroid Build Coastguard Worker<b>cups-files.conf</b>(5) 514*5e7646d2SAndroid Build Coastguard Workerfile. 515*5e7646d2SAndroid Build Coastguard Worker<dt><b>JobPrivateValues all</b> 516*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues default</b> 517*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues none</b> 518*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues </b><i>attribute-name </i>[ ... <i>attribute-name </i>] 519*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the list of job values to make private. 520*5e7646d2SAndroid Build Coastguard WorkerThe "default" values are "job-name", "job-originating-host-name", "job-originating-user-name", and "phone". 521*5e7646d2SAndroid Build Coastguard Worker<dt><b>SubscriptionPrivateAccess all</b> 522*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateAccess default</b> 523*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateAccess </b>{<i>user</i>|<b>@</b><i>group</i>|<b>@ACL</b>|<b>@OWNER</b>|<b>@SYSTEM</b>} ... 524*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies an access list for a subscription's private values. 525*5e7646d2SAndroid Build Coastguard WorkerThe "default" access list is "@OWNER @SYSTEM". 526*5e7646d2SAndroid Build Coastguard Worker"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values. 527*5e7646d2SAndroid Build Coastguard Worker"@OWNER" maps to the job's owner. 528*5e7646d2SAndroid Build Coastguard Worker"@SYSTEM" maps to the groups listed for the SystemGroup directive in the 529*5e7646d2SAndroid Build Coastguard Worker<b>cups-files.conf</b>(5) 530*5e7646d2SAndroid Build Coastguard Workerfile. 531*5e7646d2SAndroid Build Coastguard Worker<dt><b>SubscriptionPrivateValues all</b> 532*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues default</b> 533*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues none</b> 534*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues </b><i>attribute-name </i>[ ... <i>attribute-name </i>] 535*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the list of subscription values to make private. 536*5e7646d2SAndroid Build Coastguard WorkerThe "default" values are "notify-events", "notify-pull-method", "notify-recipient-uri", "notify-subscriber-user-name", and "notify-user-data". 537*5e7646d2SAndroid Build Coastguard Worker</dl> 538*5e7646d2SAndroid Build Coastguard Worker<h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3> 539*5e7646d2SAndroid Build Coastguard WorkerThe following directives are deprecated and will be removed in a future release of CUPS: 540*5e7646d2SAndroid Build Coastguard Worker<dl class="man"> 541*5e7646d2SAndroid Build Coastguard Worker<dt><a name="Classification"></a><b>Classification </b><i>banner</i> 542*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><br> 543*5e7646d2SAndroid Build Coastguard WorkerSpecifies the security classification of the server. 544*5e7646d2SAndroid Build Coastguard WorkerAny valid banner name can be used, including "classified", "confidential", "secret", "topsecret", and "unclassified", or the banner can be omitted to disable secure printing functions. 545*5e7646d2SAndroid Build Coastguard WorkerThe default is no classification banner. 546*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ClassifyOverride"></a><b>ClassifyOverride Yes</b> 547*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><dt><b>ClassifyOverride No</b> 548*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em"><br> 549*5e7646d2SAndroid Build Coastguard WorkerSpecifies whether users may override the classification (cover page) of individual print jobs using the "job-sheets" option. 550*5e7646d2SAndroid Build Coastguard WorkerThe default is "No". 551*5e7646d2SAndroid Build Coastguard Worker<dt><a name="ListenBackLog"></a><b>ListenBackLog </b><i>number</i> 552*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specified the number of pending connections that will be allowed. 553*5e7646d2SAndroid Build Coastguard WorkerThe scheduler now uses the value "128" on all platforms. 554*5e7646d2SAndroid Build Coastguard Worker<dt><a name="PageLogFormat"></a><b>PageLogFormat </b><i>format-string</i> 555*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the format of PageLog lines. 556*5e7646d2SAndroid Build Coastguard WorkerSequences beginning with percent (%) characters are replaced with the corresponding information, while all other characters are copied literally. 557*5e7646d2SAndroid Build Coastguard WorkerThe following percent sequences are recognized: 558*5e7646d2SAndroid Build Coastguard Worker<pre class="man"> 559*5e7646d2SAndroid Build Coastguard Worker 560*5e7646d2SAndroid Build Coastguard Worker "%%" inserts a single percent character. 561*5e7646d2SAndroid Build Coastguard Worker "%{name}" inserts the value of the specified IPP attribute. 562*5e7646d2SAndroid Build Coastguard Worker "%C" inserts the number of copies for the current page. 563*5e7646d2SAndroid Build Coastguard Worker "%P" inserts the current page number. 564*5e7646d2SAndroid Build Coastguard Worker "%T" inserts the current date and time in common log format. 565*5e7646d2SAndroid Build Coastguard Worker "%j" inserts the job ID. 566*5e7646d2SAndroid Build Coastguard Worker "%p" inserts the printer name. 567*5e7646d2SAndroid Build Coastguard Worker "%u" inserts the username. 568*5e7646d2SAndroid Build Coastguard Worker 569*5e7646d2SAndroid Build Coastguard Worker</pre> 570*5e7646d2SAndroid Build Coastguard WorkerThe default is the empty string, which disables page logging. 571*5e7646d2SAndroid Build Coastguard WorkerThe string "%p %u %j %T %P %C %{job-billing} %{job-originating-host-name} %{job-name} %{media} %{sides}" creates a page log with the standard items. 572*5e7646d2SAndroid Build Coastguard WorkerUse "%{job-impressions-completed}" to insert the number of pages (sides) that were printed, or "%{job-media-sheets-completed}" to insert the number of sheets that were printed. 573*5e7646d2SAndroid Build Coastguard Worker<dt><a name="RIPCache"></a><b>RIPCache </b><i>size</i> 574*5e7646d2SAndroid Build Coastguard Worker<dd style="margin-left: 5.0em">Specifies the maximum amount of memory to use when converting documents into bitmaps for a printer. 575*5e7646d2SAndroid Build Coastguard WorkerThe default is "128m". 576*5e7646d2SAndroid Build Coastguard Worker</dl> 577*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="NOTES">Notes</a></h2> 578*5e7646d2SAndroid Build Coastguard WorkerFile, directory, and user configuration directives that used to be allowed in the <b>cupsd.conf</b> file are now stored in the 579*5e7646d2SAndroid Build Coastguard Worker<b>cups-files.conf</b>(5) 580*5e7646d2SAndroid Build Coastguard Workerfile instead in order to prevent certain types of privilege escalation attacks. 581*5e7646d2SAndroid Build Coastguard Worker<p>The scheduler MUST be restarted manually after making changes to the <b>cupsd.conf</b> file. 582*5e7646d2SAndroid Build Coastguard WorkerOn Linux this is typically done using the 583*5e7646d2SAndroid Build Coastguard Worker<b>systemctl</b>(8) 584*5e7646d2SAndroid Build Coastguard Workercommand, while on macOS the 585*5e7646d2SAndroid Build Coastguard Worker<b>launchctl</b>(8) 586*5e7646d2SAndroid Build Coastguard Workercommand is used instead. 587*5e7646d2SAndroid Build Coastguard Worker<p>The @LOCAL macro name can be confusing since the system running 588*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b> 589*5e7646d2SAndroid Build Coastguard Workeroften belongs to a different set of subnets from its clients. 590*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2> 591*5e7646d2SAndroid Build Coastguard WorkerThe <b>cupsd.conf</b> file format is based on the Apache HTTP Server configuration file format. 592*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="EXAMPLES">Examples</a></h2> 593*5e7646d2SAndroid Build Coastguard WorkerLog everything with a maximum log file size of 32 megabytes: 594*5e7646d2SAndroid Build Coastguard Worker<pre class="man"> 595*5e7646d2SAndroid Build Coastguard Worker 596*5e7646d2SAndroid Build Coastguard Worker AccessLogLevel all 597*5e7646d2SAndroid Build Coastguard Worker LogLevel debug2 598*5e7646d2SAndroid Build Coastguard Worker MaxLogSize 32m 599*5e7646d2SAndroid Build Coastguard Worker 600*5e7646d2SAndroid Build Coastguard Worker</pre> 601*5e7646d2SAndroid Build Coastguard WorkerRequire authentication for accesses from outside the 10. network: 602*5e7646d2SAndroid Build Coastguard Worker<pre class="man"> 603*5e7646d2SAndroid Build Coastguard Worker 604*5e7646d2SAndroid Build Coastguard Worker <Location /> 605*5e7646d2SAndroid Build Coastguard Worker Order allow,deny 606*5e7646d2SAndroid Build Coastguard Worker Allow from 10./8 607*5e7646d2SAndroid Build Coastguard Worker AuthType Basic 608*5e7646d2SAndroid Build Coastguard Worker Require valid-user 609*5e7646d2SAndroid Build Coastguard Worker Satisfy any 610*5e7646d2SAndroid Build Coastguard Worker </Location> 611*5e7646d2SAndroid Build Coastguard Worker</pre> 612*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="SEE_ALSO">See Also</a></h2> 613*5e7646d2SAndroid Build Coastguard Worker<b>classes.conf</b>(5), 614*5e7646d2SAndroid Build Coastguard Worker<b>cups-files.conf</b>(5), 615*5e7646d2SAndroid Build Coastguard Worker<b>cupsd</b>(8), 616*5e7646d2SAndroid Build Coastguard Worker<b>mime.convs</b>(5), 617*5e7646d2SAndroid Build Coastguard Worker<b>mime.types</b>(5), 618*5e7646d2SAndroid Build Coastguard Worker<b>printers.conf</b>(5), 619*5e7646d2SAndroid Build Coastguard Worker<b>subscriptions.conf</b>(5), 620*5e7646d2SAndroid Build Coastguard WorkerCUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) 621*5e7646d2SAndroid Build Coastguard Worker<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> 622*5e7646d2SAndroid Build Coastguard WorkerCopyright © 2007-2021 by Apple Inc. 623*5e7646d2SAndroid Build Coastguard Worker 624*5e7646d2SAndroid Build Coastguard Worker</body> 625*5e7646d2SAndroid Build Coastguard Worker</html> 626
