]>
Commit | Line | Data |
---|---|---|
c41769ff MS |
1 | .\" |
2 | .\" "$Id$" | |
3 | .\" | |
c390f212 | 4 | .\" cups-files.conf man page for CUPS. |
c41769ff | 5 | .\" |
8fe0183a MS |
6 | .\" Copyright 2007-2014 by Apple Inc. |
7 | .\" Copyright 1997-2006 by Easy Software Products. | |
c41769ff | 8 | .\" |
8fe0183a MS |
9 | .\" These coded instructions, statements, and computer programs are the |
10 | .\" property of Apple Inc. and are protected by Federal copyright | |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
c41769ff | 14 | .\" |
c390f212 | 15 | .TH cups-files.conf 5 "CUPS" "15 April 2014" "Apple Inc." |
c41769ff | 16 | .SH NAME |
c390f212 | 17 | cups\-files.conf \- file and directory configuration file for cups |
c41769ff | 18 | .SH DESCRIPTION |
c390f212 MS |
19 | The \fBcups\-files.conf\fR file configures the files and directories used by the CUPS scheduler, |
20 | .BR cupsd (8). | |
21 | It is normally located in the \fI/etc/cups\fR directory. | |
c41769ff | 22 | .LP |
c390f212 MS |
23 | Each line in the file can be a configuration directive, a blank line, or a comment. |
24 | Comment lines start with the # character. | |
25 | .SS DIRECTIVES | |
26 | The following directives are understood by | |
27 | .BR cupsd (8): | |
c41769ff | 28 | .TP 5 |
c390f212 | 29 | \fBAccessLog \fIfilename\fR |
c41769ff | 30 | .TP 5 |
c390f212 MS |
31 | \fBAccessLog \fR[ \fIfilename\fR ] |
32 | .TP 5 | |
33 | \fBAccessLog syslog\fR | |
c41769ff | 34 | Defines the access log filename. |
c390f212 MS |
35 | The value "syslog" causes log entries to be sent to the system log daemon. |
36 | Specifying a blank filename disables access log generation. | |
37 | The server name may be included in filenames using the string "%s", for example: | |
38 | .nf | |
39 | ||
40 | AccessLog /var/log/cups/%s-access_log | |
41 | ||
42 | .fi | |
c41769ff | 43 | .TP 5 |
c390f212 MS |
44 | \fBConfigFilePerm \fImode\fR |
45 | Specifies the permissions for all configuration files that the scheduler writes. | |
46 | The default is 0644 on OS X and 0640 on all other operating systems. | |
47 | \fBNote:\fR The permissions for the printers.conf file are currently masked to only allow access from the scheduler user (typically root). | |
48 | This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system. | |
49 | There is no way to disable this security feature. | |
c41769ff | 50 | .TP 5 |
c390f212 MS |
51 | \fBDataDir \fIpath\fR |
52 | Specifies the directory where data files can be found. The default is usually \fI/usr/share/cups\fR. | |
c41769ff | 53 | .TP 5 |
c390f212 MS |
54 | \fBDocumentRoot \fIdirectory\fR |
55 | Specifies the root directory for the CUPS web interface content. The default is usually \fI/usr/share/doc/cups\fR. | |
c41769ff | 56 | .TP 5 |
c390f212 | 57 | \fBErrorLog \fR[ \fIfilename\fR ] |
c41769ff | 58 | .TP 5 |
c390f212 MS |
59 | \fBErrorLog syslog\fR |
60 | Defines the error log filename. | |
61 | The value "syslog" causes log entries to be sent to the system log daemon. | |
62 | Specifying a blank filename disables error log generation. | |
63 | The server name may be included in filenames using the string "%s", for example: | |
64 | .nf | |
65 | ||
66 | ErrorLog /var/log/cups/%s-error_log | |
67 | ||
68 | .fi | |
c41769ff | 69 | .TP 5 |
c390f212 | 70 | \fBFatalErrors none\fR |
c41769ff | 71 | .TP 5 |
c390f212 | 72 | \fBFatalErrors all \fI\-kind \fR[ \fI... \-kind \fR] |
c41769ff | 73 | .TP 5 |
c390f212 MS |
74 | \fBFatalErrors \fIkind \fR[ \fI... kind \fR] |
75 | Specifies which errors are fatal, causing the scheduler to exit. | |
76 | The default setting is "config". | |
77 | The \fIkind\fR strings are: | |
78 | .RS 5 | |
c41769ff | 79 | .TP 5 |
c390f212 MS |
80 | .B none |
81 | No errors are fatal. | |
c41769ff | 82 | .TP 5 |
c390f212 MS |
83 | .B all |
84 | All of the errors below are fatal. | |
c41769ff | 85 | .TP 5 |
c390f212 MS |
86 | .B browse |
87 | Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon. | |
88 | .TP 5 | |
89 | .B config | |
90 | Configuration file syntax errors are fatal. | |
91 | .TP 5 | |
92 | .B listen | |
93 | Listen or Port errors are fatal, except for IPv6 failures on the loopback or "any" addresses. | |
94 | .TP 5 | |
95 | .B log | |
96 | Log file creation or write errors are fatal. | |
c41769ff | 97 | .TP 5 |
c390f212 MS |
98 | .B permissions |
99 | Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions. | |
100 | .RE | |
101 | .TP 5 | |
102 | \fBFileDevice Yes\fR | |
103 | .TP 5 | |
104 | \fBFileDevice No\fR | |
105 | Specifies whether the file pseudo-device can be used for new printer queues. | |
106 | The URI "file:///dev/null" is always allowed. | |
107 | .TP 5 | |
108 | \fBFontPath \fIdirectory\fR[:\fI...\fR:\fIdirectory\fR] | |
109 | Specifies the search path for fonts. | |
110 | \fBThis directive is deprecated and will no longer be supported in a future release of CUPS.\fR | |
c41769ff | 111 | .TP 5 |
c390f212 MS |
112 | \fBGroup \fIgroup-name-or-number\fR |
113 | Specifies the group name or ID that will be used when executing external programs. | |
114 | The default group is operating system specific but is usually \fIlp\fR or \fInobody\fR. | |
c41769ff | 115 | .TP 5 |
c390f212 MS |
116 | \fBLogFilePerm \fImode\fR |
117 | Specifies the permissions of all log files that the scheduler writes. The default is 0644. | |
c41769ff | 118 | .TP 5 |
c390f212 | 119 | \fBPageLog \fR[ \fIfilename\fR ] |
c41769ff | 120 | .TP 5 |
c390f212 MS |
121 | \fBPageLog syslog\fR |
122 | Defines the page log filename. | |
123 | The value "syslog" causes log entries to be sent to the system log daemon. | |
124 | Specifying a blank filename disables page log generation. | |
125 | The server name may be included in filenames using the string "%s", for example: | |
126 | .nf | |
127 | ||
128 | PageLog /var/log/cups/%s-page_log | |
129 | ||
130 | .fi | |
c41769ff | 131 | .TP 5 |
c390f212 MS |
132 | \fBPrintcap \fR[ \fIfilename\fR ] |
133 | Defines the printcap filename that the scheduler automatically updates with the current list of available printers, which is sometimes used by legacy applications. | |
134 | Specifying a blank filename disables printcap generation. | |
135 | \fBThis directive is deprecated and will no longer be supported in a future release of CUPS.\fR | |
c41769ff | 136 | .TP 5 |
c390f212 MS |
137 | \fBRemoteRoot \fIusername\fR |
138 | Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user. | |
c41769ff | 139 | .TP 5 |
c390f212 MS |
140 | \fBRequestRoot \fIdirectory\fR |
141 | Specifies the directory that contains print jobs and other HTTP request data. | |
c41769ff | 142 | .TP 5 |
c390f212 | 143 | \fBSandboxing off\fR |
8fe0183a | 144 | .TP 5 |
c390f212 | 145 | \fBSandboxing relaxed\fR |
8fe0183a | 146 | .TP 5 |
c390f212 MS |
147 | \fBSandboxing strict\fR |
148 | Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler. | |
149 | The default is "strict". | |
150 | This directive is currently only used on OS X. | |
8fe0183a | 151 | .TP 5 |
c390f212 MS |
152 | \fBServerBin \fIdirectory\fR |
153 | Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors. | |
c41769ff | 154 | .TP 5 |
c390f212 | 155 | \fBServerKeychain \fIpath\fR |
8fe0183a | 156 | Specifies the location of TLS certificates and private keys. |
c41769ff | 157 | .TP 5 |
c390f212 MS |
158 | \fBServerRoot \fIdirectory\fR |
159 | Specifies the directory containing the server configuration files. | |
c41769ff | 160 | .TP 5 |
c390f212 | 161 | \fBSyncOnClose Yes\fR |
8a259669 | 162 | .TP 5 |
c390f212 MS |
163 | \fBSyncOnClose No\fR |
164 | Specifies whether the scheduler calls | |
165 | .BR fsync (2) | |
166 | after writing configuration or state files. The default is No. | |
8a259669 | 167 | .TP 5 |
c390f212 MS |
168 | \fBSystemGroup \fIgroup-name \fR[ \fI... group-name\fR ] |
169 | Specifies the group(s) to use for \fI@SYSTEM\fR group authentication. | |
c41769ff | 170 | .TP 5 |
c390f212 | 171 | \fBTempDir \fIdirectory\fR |
c41769ff MS |
172 | Specifies the directory where temporary files are stored. |
173 | .TP 5 | |
c390f212 | 174 | \fBUser \fIusername\fR |
c41769ff MS |
175 | Specifies the user name or ID that is used when running external programs. |
176 | .SH SEE ALSO | |
c390f212 MS |
177 | .BR classes.conf (5), |
178 | .BR cups (1), | |
179 | .BR cupsd (8), | |
180 | .BR cupsd.conf (5), | |
181 | .BR mime.convs (5), | |
182 | .BR mime.types (5), | |
183 | .BR printers.conf (5), | |
184 | .BR subscriptions.conf (5), | |
185 | CUPS Online Help (http://localhost:631/help) | |
c41769ff | 186 | .SH COPYRIGHT |
c390f212 | 187 | Copyright \[co] 2007-2014 by Apple Inc. |
c41769ff MS |
188 | .\" |
189 | .\" End of "$Id$". | |
190 | .\" |