[thirdparty/cups.git] / doc / help / man-cups-files.conf.html

<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>cups-files.conf(5)</title>
</head>
<body>
<h1 class="title">cups-files.conf(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
cups-files.conf - file and directory configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>cups-files.conf</b> file configures the files and directories used by the CUPS scheduler,
<b>cupsd</b>(8).
It is normally located in the <i>/etc/cups</i> directory.
<p>Each line in the file can be a configuration directive, a blank line, or a comment.
Configuration directives typically consist of a name and zero or more values separated by whitespace.
The configuration directive name and values are case-insensitive.
Comment lines start with the # character.
<h3><a name="DIRECTIVES">Directives</a></h3>
The following directives are understood by
<b>cupsd</b>(8):
<dl class="man">
<dt><a name="AccessLog"></a><b>AccessLog</b>
<dd style="margin-left: 5.0em"><dt><b>AccessLog </b><i>filename</i>
<dd style="margin-left: 5.0em"><dt><b>AccessLog stderr</b>
<dd style="margin-left: 5.0em"><dt><b>AccessLog syslog</b>
<dd style="margin-left: 5.0em">Defines the access log filename.
Specifying a blank filename disables access log generation.
The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
The value "syslog" causes log entries to be sent to the system log daemon.
The server name may be included in filenames using the string "%s", for example:
<pre class="man">

    AccessLog /var/log/cups/%s-access_log

</pre>
The default is "/var/log/cups/access_log".
<dt><a name="CacheDir"></a><b>CacheDir </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the directory to use for long-lived temporary (cache) files.
The default is "/var/spool/cups/cache" or "/var/cache/cups" depending on the platform.
<dt><a name="ConfigFilePerm"></a><b>ConfigFilePerm </b><i>mode</i>
<dd style="margin-left: 5.0em">Specifies the permissions for all configuration files that the scheduler writes.
The default is "0644" on macOS and "0640" on all other operating systems.
</dl>
<p><b>Note:</b> The permissions for the <i>printers.conf</i> file are currently masked to only allow access from the scheduler user (typically root).
This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system.
There is no way to disable this security feature.
<dl class="man">
<dt><a name="CreateSelfSignedCerts"></a><b>CreateSelfSignedCerts yes</b>
<dd style="margin-left: 5.0em"><dt><b>CreateSelfSignedCerts no</b>
<dd style="margin-left: 5.0em">Specifies whether the scheduler automatically creates self-signed certificates for client connections using TLS.
The default is yes.
<dt><a name="DataDir"></a><b>DataDir </b><i>path</i>
<dd style="margin-left: 5.0em">Specifies the directory where data files can be found.
The default is usually "/usr/share/cups".
<dt><a name="DocumentRoot"></a><b>DocumentRoot </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the root directory for the CUPS web interface content.
The default is usually "/usr/share/doc/cups".
<dt><a name="ErrorLog"></a><b>ErrorLog</b>
<dd style="margin-left: 5.0em"><dt><b>ErrorLog </b><i>filename</i>
<dd style="margin-left: 5.0em"><dt><b>ErrorLog stderr</b>
<dd style="margin-left: 5.0em"><dt><b>ErrorLog syslog</b>
<dd style="margin-left: 5.0em">Defines the error log filename.
Specifying a blank filename disables error log generation.
The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
The value "syslog" causes log entries to be sent to the system log daemon.
The server name may be included in filenames using the string "%s", for example:
<pre class="man">

    ErrorLog /var/log/cups/%s-error_log

</pre>
The default is "/var/log/cups/error_log".
<dt><a name="FatalErrors"></a><b>FatalErrors none</b>
<dd style="margin-left: 5.0em"><dt><b>FatalErrors all </b><i>-kind </i>[ ... <i>-kind </i>]
<dd style="margin-left: 5.0em"><dt><b>FatalErrors </b><i>kind </i>[ ... <i>kind </i>]
<dd style="margin-left: 5.0em">Specifies which errors are fatal, causing the scheduler to exit.
The default is "config".
The <i>kind</i> strings are:
<div style="margin-left: 0.0em;">
<dl class="man">
<dt><b>none</b>
<dd style="margin-left: 5.0em">No errors are fatal.
<dt><b>all</b>
<dd style="margin-left: 5.0em">All of the errors below are fatal.
<dt><b>browse</b>
<dd style="margin-left: 5.0em">Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon.
<dt><b>config</b>
<dd style="margin-left: 5.0em">Configuration file syntax errors are fatal.
<dt><b>listen</b>
<dd style="margin-left: 5.0em">Listen or Port errors are fatal, except for IPv6 failures on the loopback or "any" addresses.
<dt><b>log</b>
<dd style="margin-left: 5.0em">Log file creation or write errors are fatal.
<dt><b>permissions</b>
<dd style="margin-left: 5.0em">Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions.
</div>
<dt><a name="Group"></a><b>Group </b><i>group-name-or-number</i>
<dd style="margin-left: 5.0em">Specifies the group name or ID that will be used when executing external programs.
The default group is operating system specific but is usually "lp" or "nobody".
<dt><a name="LogFilePerm"></a><b>LogFilePerm </b><i>mode</i>
<dd style="margin-left: 5.0em">Specifies the permissions of all log files that the scheduler writes.
The default is "0644".
<dt><a name="PageLog"></a><b>PageLog </b>[ <i>filename</i> ]
<dd style="margin-left: 5.0em"><dt><b>PageLog stderr</b>
<dd style="margin-left: 5.0em"><dt><b>PageLog syslog</b>
<dd style="margin-left: 5.0em">Defines the page log filename.
The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
The value "syslog" causes log entries to be sent to the system log daemon.
Specifying a blank filename disables page log generation.
The server name may be included in filenames using the string "%s", for example:
<pre class="man">

    PageLog /var/log/cups/%s-page_log

</pre>
The default is "/var/log/cups/page_log".
<dt><a name="PassEnv"></a><b>PassEnv </b><i>variable </i>[ ... <i>variable </i>]
<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
<dt><a name="RemoteRoot"></a><b>RemoteRoot </b><i>username</i>
<dd style="margin-left: 5.0em">Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
The default is "remroot".
<dt><a name="RequestRoot"></a><b>RequestRoot </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the directory that contains print jobs and other HTTP request data.
The default is "/var/spool/cups".
<dt><a name="Sandboxing"></a><b>Sandboxing relaxed</b>
<dd style="margin-left: 5.0em"><dt><b>Sandboxing strict</b>
<dd style="margin-left: 5.0em">Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler.
The default is "strict".
This directive is currently only used/supported on macOS.
<dt><a name="ServerBin"></a><b>ServerBin </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors.
The default is "/usr/lib/cups" or "/usr/libexec/cups" depending on the platform.
<dt><a name="ServerKeychain"></a><b>ServerKeychain </b><i>path</i>
<dd style="margin-left: 5.0em">Specifies the location of TLS certificates and private keys.
The default is "/Library/Keychains/System.keychain" on macOS and "/etc/cups/ssl" on all other operating systems.
macOS uses its keychain database to store certificates and keys while other platforms use separate files in the specified directory, *.crt for PEM-encoded certificates and *.key for PEM-encoded private keys.
<dt><a name="ServerRoot"></a><b>ServerRoot </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the directory containing the server configuration files.
The default is "/etc/cups".
<dt><a name="SetEnv"></a><b>SetEnv </b><i>variable value</i>
<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
<dt><a name="StateDir"></a><b>StateDir </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the directory to use for PID and local certificate files.
The default is "/var/run/cups" or "/etc/cups" depending on the platform.
<dt><a name="SyncOnClose"></a><b>SyncOnClose Yes</b>
<dd style="margin-left: 5.0em"><dt><b>SyncOnClose No</b>
<dd style="margin-left: 5.0em">Specifies whether the scheduler calls
<b>fsync</b>(2)
after writing configuration or state files.
The default is "No".
<dt><a name="SystemGroup"></a><b>SystemGroup </b><i>group-name </i>[ ... <i>group-name</i> ]
<dd style="margin-left: 5.0em">Specifies the group(s) to use for <i>@SYSTEM</i> group authentication.
The default contains "admin", "lpadmin", "root", "sys", and/or "system".
<dt><a name="TempDir"></a><b>TempDir </b><i>directory</i>
<dd style="margin-left: 5.0em">Specifies the directory where short-term temporary files are stored.
The default is "/var/spool/cups/tmp".
<dt><a name="User"></a><b>User </b><i>username</i>
<dd style="margin-left: 5.0em">Specifies the user name or ID that is used when running external programs.
The default is "lp".
</dl>
<h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3>
The following directives are deprecated and will be removed from a future version of CUPS:
<dl class="man">
<dt><a name="FileDevice"></a><b>FileDevice Yes</b>
<dd style="margin-left: 5.0em"><dt><b>FileDevice No</b>
<dd style="margin-left: 5.0em">Specifies whether the file pseudo-device can be used for new printer queues.
The URI "file:///dev/null" is always allowed.
File devices cannot be used with "raw" print queues - a PPD file is required.
The specified file is overwritten for every print job.
Writing to directories is not supported.
<dt><a name="FontPath"></a><b>FontPath </b><i>directory[:...:directoryN]</i>
<dd style="margin-left: 5.0em">Specifies a colon separated list of directories where fonts can be found.
On Linux the
<b>font-config</b>(1)
mechanism is used instead.
On macOS the Font Book application manages system-installed fonts.
<dt><a name="LPDConfigFile"></a><b> LPDConfigFile </b><i>filename</i>
<dd style="margin-left: 5.0em">Specifies the LPD service configuration file to update.
<dt><a name="Printcap"></a><b>Printcap </b><i>filename</i>
<dd style="margin-left: 5.0em">Specifies a file that is filled with a list of local print queues.
<dt><a name="PrintcapFormat"></a><b>PrintcapFormat bsd</b>
<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat plist</b>
<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat solaris</b>
<dd style="margin-left: 5.0em">Specifies the format to use for the Printcap file.
"bsd" is the historical LPD printcap file format.
"plist" is the Apple plist file format.
"solaris" is the historical Solaris LPD printcap file format.
<dt><a name="SMBConfigFile"></a><b>SMBConfigFile </b><i>filename</i>
<dd style="margin-left: 5.0em">Specifies the SMB service configuration file to update.
</dl>
<h2 class="title"><a name="NOTES">Notes</a></h2>
The scheduler MUST be restarted manually after making changes to the <b>cups-files.conf</b> file.
On Linux this is typically done using the
<b>systemctl</b>(8)
command, while on macOS the
<b>launchctl</b>(8)
command is used instead.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>classes.conf</b>(5),
<b>cups</b>(1),
<b>cupsd</b>(8),
<b>cupsd.conf</b>(5),
<b>mime.convs</b>(5),
<b>mime.types</b>(5),
<b>printers.conf</b>(5),
<b>subscriptions.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright &copy; 2007-2019 by Apple Inc.

</body>
</html>
Commit	Line	Data
c277f98c	1	<!DOCTYPE HTML>
94436c5a MS	2	<html>
	3	<!-- SECTION: Man Pages -->
	4	<head>
	5	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	6	<title>cups-files.conf(5)</title>
	7	</head>
	8	<body>
	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>
651e0a22	13	The <b>cups-files.conf</b> file configures the files and directories used by the CUPS scheduler,
87030afb	14	<b>cupsd</b>(8).
651e0a22 MS	15	It is normally located in the <i>/etc/cups</i> directory.
651e0a22 MS	16	<p>Each line in the file can be a configuration directive, a blank line, or a comment.
25d0c3fe MS	17	Configuration directives typically consist of a name and zero or more values separated by whitespace.
25d0c3fe MS	18	The configuration directive name and values are case-insensitive.
651e0a22 MS	19	Comment lines start with the # character.
	20	<h3><a name="DIRECTIVES">Directives</a></h3>
	21	The following directives are understood by
87030afb	22	<b>cupsd</b>(8):
2909c66c	23	<dl class="man">
37d9646b	24	<dt><a name="AccessLog"></a><b>AccessLog</b>
25d0c3fe	25	<dd style="margin-left: 5.0em"><dt><b>AccessLog </b><i>filename</i>
c59e07c6	26	<dd style="margin-left: 5.0em"><dt><b>AccessLog stderr</b>
651e0a22 MS	27	<dd style="margin-left: 5.0em"><dt><b>AccessLog syslog</b>
651e0a22 MS	28	<dd style="margin-left: 5.0em">Defines the access log filename.
651e0a22	29	Specifying a blank filename disables access log generation.
c59e07c6	30	The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
25d0c3fe	31	The value "syslog" causes log entries to be sent to the system log daemon.
651e0a22 MS	32	The server name may be included in filenames using the string "%s", for example:
	33	<pre class="man">
	34
	35	AccessLog /var/log/cups/%s-access_log
	36
	37	</pre>
25d0c3fe	38	The default is "/var/log/cups/access_log".
7c7347a3 MS	39	<dt><a name="CacheDir"></a><b>CacheDir </b><i>directory</i>
	40	<dd style="margin-left: 5.0em">Specifies the directory to use for long-lived temporary (cache) files.
	41	The default is "/var/spool/cups/cache" or "/var/cache/cups" depending on the platform.
37d9646b	42	<dt><a name="ConfigFilePerm"></a><b>ConfigFilePerm </b><i>mode</i>
651e0a22	43	<dd style="margin-left: 5.0em">Specifies the permissions for all configuration files that the scheduler writes.
8072030b	44	The default is "0644" on macOS and "0640" on all other operating systems.
b4a8492a MS	45	</dl>
b4a8492a MS	46	<p><b>Note:</b> The permissions for the <i>printers.conf</i> file are currently masked to only allow access from the scheduler user (typically root).
651e0a22 MS	47	This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system.
651e0a22 MS	48	There is no way to disable this security feature.
b4a8492a	49	<dl class="man">
47eb8d30 MS	50	<dt><a name="CreateSelfSignedCerts"></a><b>CreateSelfSignedCerts yes</b>
	51	<dd style="margin-left: 5.0em"><dt><b>CreateSelfSignedCerts no</b>
	52	<dd style="margin-left: 5.0em">Specifies whether the scheduler automatically creates self-signed certificates for client connections using TLS.
	53	The default is yes.
37d9646b	54	<dt><a name="DataDir"></a><b>DataDir </b><i>path</i>
25d0c3fe MS	55	<dd style="margin-left: 5.0em">Specifies the directory where data files can be found.
25d0c3fe MS	56	The default is usually "/usr/share/cups".
37d9646b	57	<dt><a name="DocumentRoot"></a><b>DocumentRoot </b><i>directory</i>
25d0c3fe MS	58	<dd style="margin-left: 5.0em">Specifies the root directory for the CUPS web interface content.
25d0c3fe MS	59	The default is usually "/usr/share/doc/cups".
37d9646b	60	<dt><a name="ErrorLog"></a><b>ErrorLog</b>
25d0c3fe	61	<dd style="margin-left: 5.0em"><dt><b>ErrorLog </b><i>filename</i>
c59e07c6	62	<dd style="margin-left: 5.0em"><dt><b>ErrorLog stderr</b>
651e0a22 MS	63	<dd style="margin-left: 5.0em"><dt><b>ErrorLog syslog</b>
651e0a22 MS	64	<dd style="margin-left: 5.0em">Defines the error log filename.
651e0a22	65	Specifying a blank filename disables error log generation.
c59e07c6	66	The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
25d0c3fe	67	The value "syslog" causes log entries to be sent to the system log daemon.
651e0a22 MS	68	The server name may be included in filenames using the string "%s", for example:
	69	<pre class="man">
	70
	71	ErrorLog /var/log/cups/%s-error_log
	72
	73	</pre>
25d0c3fe	74	The default is "/var/log/cups/error_log".
37d9646b	75	<dt><a name="FatalErrors"></a><b>FatalErrors none</b>
25d0c3fe MS	76	<dd style="margin-left: 5.0em"><dt><b>FatalErrors all </b><i>-kind </i>[ ... <i>-kind </i>]
25d0c3fe MS	77	<dd style="margin-left: 5.0em"><dt><b>FatalErrors </b><i>kind </i>[ ... <i>kind </i>]
651e0a22	78	<dd style="margin-left: 5.0em">Specifies which errors are fatal, causing the scheduler to exit.
25d0c3fe	79	The default is "config".
651e0a22 MS	80	The <i>kind</i> strings are:
	81	<div style="margin-left: 0.0em;">
	82	<dl class="man">
	83	<dt><b>none</b>
	84	<dd style="margin-left: 5.0em">No errors are fatal.
	85	<dt><b>all</b>
	86	<dd style="margin-left: 5.0em">All of the errors below are fatal.
	87	<dt><b>browse</b>
	88	<dd style="margin-left: 5.0em">Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon.
	89	<dt><b>config</b>
	90	<dd style="margin-left: 5.0em">Configuration file syntax errors are fatal.
	91	<dt><b>listen</b>
	92	<dd style="margin-left: 5.0em">Listen or Port errors are fatal, except for IPv6 failures on the loopback or "any" addresses.
	93	<dt><b>log</b>
	94	<dd style="margin-left: 5.0em">Log file creation or write errors are fatal.
	95	<dt><b>permissions</b>
	96	<dd style="margin-left: 5.0em">Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions.
	97	</div>
37d9646b	98	<dt><a name="Group"></a><b>Group </b><i>group-name-or-number</i>
651e0a22	99	<dd style="margin-left: 5.0em">Specifies the group name or ID that will be used when executing external programs.
25d0c3fe	100	The default group is operating system specific but is usually "lp" or "nobody".
37d9646b	101	<dt><a name="LogFilePerm"></a><b>LogFilePerm </b><i>mode</i>
25d0c3fe MS	102	<dd style="margin-left: 5.0em">Specifies the permissions of all log files that the scheduler writes.
25d0c3fe MS	103	The default is "0644".
37d9646b	104	<dt><a name="PageLog"></a><b>PageLog </b>[ <i>filename</i> ]
c59e07c6	105	<dd style="margin-left: 5.0em"><dt><b>PageLog stderr</b>
651e0a22 MS	106	<dd style="margin-left: 5.0em"><dt><b>PageLog syslog</b>
651e0a22 MS	107	<dd style="margin-left: 5.0em">Defines the page log filename.
c59e07c6	108	The value "stderr" causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background.
651e0a22 MS	109	The value "syslog" causes log entries to be sent to the system log daemon.
	110	Specifying a blank filename disables page log generation.
	111	The server name may be included in filenames using the string "%s", for example:
	112	<pre class="man">
	113
	114	PageLog /var/log/cups/%s-page_log
	115
	116	</pre>
25d0c3fe	117	The default is "/var/log/cups/page_log".
d5d64778 MS	118	<dt><a name="PassEnv"></a><b>PassEnv </b><i>variable </i>[ ... <i>variable </i>]
	119	<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
	120	Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
37d9646b	121	<dt><a name="RemoteRoot"></a><b>RemoteRoot </b><i>username</i>
651e0a22	122	<dd style="margin-left: 5.0em">Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
25d0c3fe	123	The default is "remroot".
37d9646b	124	<dt><a name="RequestRoot"></a><b>RequestRoot </b><i>directory</i>
651e0a22	125	<dd style="margin-left: 5.0em">Specifies the directory that contains print jobs and other HTTP request data.
25d0c3fe	126	The default is "/var/spool/cups".
e9f9e650	127	<dt><a name="Sandboxing"></a><b>Sandboxing relaxed</b>
651e0a22 MS	128	<dd style="margin-left: 5.0em"><dt><b>Sandboxing strict</b>
	129	<dd style="margin-left: 5.0em">Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler.
	130	The default is "strict".
8072030b	131	This directive is currently only used/supported on macOS.
37d9646b	132	<dt><a name="ServerBin"></a><b>ServerBin </b><i>directory</i>
651e0a22	133	<dd style="margin-left: 5.0em">Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors.
25d0c3fe	134	The default is "/usr/lib/cups" or "/usr/libexec/cups" depending on the platform.
37d9646b	135	<dt><a name="ServerKeychain"></a><b>ServerKeychain </b><i>path</i>
651e0a22	136	<dd style="margin-left: 5.0em">Specifies the location of TLS certificates and private keys.
8072030b MS	137	The default is "/Library/Keychains/System.keychain" on macOS and "/etc/cups/ssl" on all other operating systems.
8072030b MS	138	macOS uses its keychain database to store certificates and keys while other platforms use separate files in the specified directory, .crt for PEM-encoded certificates and .key for PEM-encoded private keys.
37d9646b	139	<dt><a name="ServerRoot"></a><b>ServerRoot </b><i>directory</i>
651e0a22	140	<dd style="margin-left: 5.0em">Specifies the directory containing the server configuration files.
25d0c3fe	141	The default is "/etc/cups".
d5d64778 MS	142	<dt><a name="SetEnv"></a><b>SetEnv </b><i>variable value</i>
	143	<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
	144	Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
7c7347a3 MS	145	<dt><a name="StateDir"></a><b>StateDir </b><i>directory</i>
	146	<dd style="margin-left: 5.0em">Specifies the directory to use for PID and local certificate files.
	147	The default is "/var/run/cups" or "/etc/cups" depending on the platform.
37d9646b	148	<dt><a name="SyncOnClose"></a><b>SyncOnClose Yes</b>
651e0a22 MS	149	<dd style="margin-left: 5.0em"><dt><b>SyncOnClose No</b>
	150	<dd style="margin-left: 5.0em">Specifies whether the scheduler calls
	151	<b>fsync</b>(2)
25d0c3fe MS	152	after writing configuration or state files.
25d0c3fe MS	153	The default is "No".
37d9646b	154	<dt><a name="SystemGroup"></a><b>SystemGroup </b><i>group-name </i>[ ... <i>group-name</i> ]
651e0a22	155	<dd style="margin-left: 5.0em">Specifies the group(s) to use for <i>@SYSTEM</i> group authentication.
25d0c3fe	156	The default contains "admin", "lpadmin", "root", "sys", and/or "system".
37d9646b	157	<dt><a name="TempDir"></a><b>TempDir </b><i>directory</i>
7c7347a3	158	<dd style="margin-left: 5.0em">Specifies the directory where short-term temporary files are stored.
25d0c3fe	159	The default is "/var/spool/cups/tmp".
37d9646b	160	<dt><a name="User"></a><b>User </b><i>username</i>
651e0a22	161	<dd style="margin-left: 5.0em">Specifies the user name or ID that is used when running external programs.
25d0c3fe	162	The default is "lp".
2909c66c	163	</dl>
7c7347a3 MS	164	<h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3>
	165	The following directives are deprecated and will be removed from a future version of CUPS:
	166	<dl class="man">
dda99de9 MS	167	<dt><a name="FileDevice"></a><b>FileDevice Yes</b>
	168	<dd style="margin-left: 5.0em"><dt><b>FileDevice No</b>
	169	<dd style="margin-left: 5.0em">Specifies whether the file pseudo-device can be used for new printer queues.
	170	The URI "file:///dev/null" is always allowed.
	171	File devices cannot be used with "raw" print queues - a PPD file is required.
	172	The specified file is overwritten for every print job.
	173	Writing to directories is not supported.
7c7347a3 MS	174	<dt><a name="FontPath"></a><b>FontPath </b><i>directory[:...:directoryN]</i>
	175	<dd style="margin-left: 5.0em">Specifies a colon separated list of directories where fonts can be found.
	176	On Linux the
	177	<b>font-config</b>(1)
	178	mechanism is used instead.
	179	On macOS the Font Book application manages system-installed fonts.
	180	<dt><a name="LPDConfigFile"></a><b> LPDConfigFile </b><i>filename</i>
	181	<dd style="margin-left: 5.0em">Specifies the LPD service configuration file to update.
	182	<dt><a name="Printcap"></a><b>Printcap </b><i>filename</i>
	183	<dd style="margin-left: 5.0em">Specifies a file that is filled with a list of local print queues.
	184	<dt><a name="PrintcapFormat"></a><b>PrintcapFormat bsd</b>
	185	<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat plist</b>
	186	<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat solaris</b>
	187	<dd style="margin-left: 5.0em">Specifies the format to use for the Printcap file.
	188	"bsd" is the historical LPD printcap file format.
	189	"plist" is the Apple plist file format.
	190	"solaris" is the historical Solaris LPD printcap file format.
	191	<dt><a name="SMBConfigFile"></a><b>SMBConfigFile </b><i>filename</i>
	192	<dd style="margin-left: 5.0em">Specifies the SMB service configuration file to update.
	193	</dl>
51c22b86 MS	194	<h2 class="title"><a name="NOTES">Notes</a></h2>
	195	The scheduler MUST be restarted manually after making changes to the <b>cups-files.conf</b> file.
	196	On Linux this is typically done using the
	197	<b>systemctl</b>(8)
	198	command, while on macOS the
	199	<b>launchctl</b>(8)
	200	command is used instead.
94436c5a	201	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
87030afb MS	202	<b>classes.conf</b>(5),
	203	<b>cups</b>(1),
	204	<b>cupsd</b>(8),
	205	<b>cupsd.conf</b>(5),
	206	<b>mime.convs</b>(5),
	207	<b>mime.types</b>(5),
	208	<b>printers.conf</b>(5),
	209	<b>subscriptions.conf</b>(5),
651e0a22	210	CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
94436c5a	211	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
87030afb	212	Copyright © 2007-2019 by Apple Inc.
94436c5a MS	213
	214	</body>
	215	</html>