3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>cups-files.conf(
5)
</title>
9 <h1 class=
"title">cups-files.conf(
5)
</h1>
10 <h2 class=
"title"><a name=
"NAME">Name
</a></h2>
11 cups-files.conf - file and directory configuration file for cups
12 <h2 class=
"title"><a name=
"DESCRIPTION">Description
</a></h2>
13 The
<i>cups-files.conf
</i> file configures the files and directories used by the
14 CUPS scheduler,
<i>cupsd(
8)
</i>. It is normally located in the
15 <i>/etc/cups
</i> directory.
16 <p>Each line in the file can be a configuration directive, a blank line,
17 or a comment. Comment lines start with the # character.
18 <h2 class=
"title"><a name=
"DIRECTIVES">Directives
</a></h2>
19 The following directives are understood by
<i>cupsd(
8)
</i>. Consult the
20 on-line help for detailed descriptions:
21 <p style=
"margin-left: 5.0em; text-indent: -5.0em">AccessLog filename
23 <p style=
"margin-left: 5.0em; text-indent: -5.0em">AccessLog syslog
26 Defines the access log filename.
27 <p style=
"margin-left: 5.0em; text-indent: -5.0em">ConfigFilePerm mode
30 Specifies the permissions for all configuration files that the scheduler
32 <p style=
"margin-left: 5.0em; text-indent: -5.0em">DataDir path
35 Specified the directory where data files can be found.
36 <p style=
"margin-left: 5.0em; text-indent: -5.0em">DocumentRoot directory
39 Specifies the root directory for the internal web server documents.
40 <p style=
"margin-left: 5.0em; text-indent: -5.0em">ErrorLog filename
42 <p style=
"margin-left: 5.0em; text-indent: -5.0em">ErrorLog syslog
45 Specifies the error log filename.
46 <p style=
"margin-left: 5.0em; text-indent: -5.0em">FatalErrors none
48 <p style=
"margin-left: 5.0em; text-indent: -5.0em">FatalErrors all -kind [... -kind]
50 <p style=
"margin-left: 5.0em; text-indent: -5.0em">FatalErrors kind [... kind]
53 Specifies which errors are fatal, causing the scheduler to exit.
"Kind" is
54 "browse",
"config",
"listen",
"log", or
"permissions".
55 <p style=
"margin-left: 5.0em; text-indent: -5.0em">FileDevice Yes
57 <p style=
"margin-left: 5.0em; text-indent: -5.0em">FileDevice No
60 Specifies whether the file pseudo-device can be used for new
62 <p style=
"margin-left: 5.0em; text-indent: -5.0em">FontPath directory[:directory:...]
65 Specifies the search path for fonts.
66 <p style=
"margin-left: 5.0em; text-indent: -5.0em">Group group-name-or-number
69 Specifies the group name or ID that will be used when executing
71 <p style=
"margin-left: 5.0em; text-indent: -5.0em">LogFilePerm mode
74 Specifies the permissions for all log files that the scheduler writes.
75 <p style=
"margin-left: 5.0em; text-indent: -5.0em">PageLog filename
77 <p style=
"margin-left: 5.0em; text-indent: -5.0em">PageLog syslog
80 Specifies the page log filename.
81 <p style=
"margin-left: 5.0em; text-indent: -5.0em">Printcap
83 <p style=
"margin-left: 5.0em; text-indent: -5.0em">Printcap filename
86 Specifies the filename for a printcap file that is updated
87 automatically with a list of available printers (needed for
88 legacy applications); specifying Printcap with no filename
89 disables printcap generation.
90 <p style=
"margin-left: 5.0em; text-indent: -5.0em">RemoteRoot user-name
93 Specifies the username that is associated with unauthenticated root
95 <p style=
"margin-left: 5.0em; text-indent: -5.0em">RequestRoot directory
98 Specifies the directory to store print jobs and other HTTP request
100 <p style=
"margin-left: 5.0em; text-indent: -5.0em">Sandboxing off
102 <p style=
"margin-left: 5.0em; text-indent: -5.0em">Sandboxing relaxed
104 <p style=
"margin-left: 5.0em; text-indent: -5.0em">Sandboxing strict
106 Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler. The default is
"strict". (OS X only)
107 <p style=
"margin-left: 5.0em; text-indent: -5.0em">ServerBin directory
110 Specifies the directory where backends, CGIs, daemons, and filters may
112 <p style=
"margin-left: 5.0em; text-indent: -5.0em">ServerKeychain path
115 Specifies the location of TLS certificates and private keys.
116 <p style=
"margin-left: 5.0em; text-indent: -5.0em">ServerRoot directory
119 Specifies the directory where the server configuration files can be found.
120 <p style=
"margin-left: 5.0em; text-indent: -5.0em">SyncOnClose Yes
122 <p style=
"margin-left: 5.0em; text-indent: -5.0em">SyncOnClose No
124 Specifies whether the scheduler calls
<i>fsync(
2)
</i> after writing configuration
125 or state files. The default is No.
126 <p style=
"margin-left: 5.0em; text-indent: -5.0em">SystemGroup group-name [group-name ...]
129 Specifies the group(s) to use for System class authentication.
130 <p style=
"margin-left: 5.0em; text-indent: -5.0em">TempDir directory
133 Specifies the directory where temporary files are stored.
134 <p style=
"margin-left: 5.0em; text-indent: -5.0em">User user-name
137 Specifies the user name or ID that is used when running external programs.
138 <h2 class=
"title"><a name=
"SEE_ALSO">See Also
</a></h2>
139 <i>classes.conf(
5)
</i>,
<i>cupsd(
8)
</i>,
<i>cupsd.conf(
5)
</i>,
<i>mime.convs(
5)
</i>,
140 <i>mime.types(
5)
</i>,
<i>printers.conf(
5)
</i>,
141 <i>subscriptions.conf(
5)
</i>,
143 <a href=
"http://localhost:631/help">http://localhost:
631/help
</a>
144 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
145 Copyright
2007-
2014 by Apple Inc.