[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,
<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
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
<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
<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="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.
<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="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="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="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="SEE_ALSO">See Also</a></h2>
<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
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-2017 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 MS	13	The <b>cups-files.conf</b> file configures the files and directories used by the CUPS scheduler,
	14	<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
	15	It is normally located in the <i>/etc/cups</i> directory.
	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
	22	<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
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="FileDevice"></a><b>FileDevice Yes</b>
651e0a22 MS	99	<dd style="margin-left: 5.0em"><dt><b>FileDevice No</b>
	100	<dd style="margin-left: 5.0em">Specifies whether the file pseudo-device can be used for new printer queues.
	101	The URI "file:///dev/null" is always allowed.
37d9646b	102	<dt><a name="Group"></a><b>Group </b><i>group-name-or-number</i>
651e0a22	103	<dd style="margin-left: 5.0em">Specifies the group name or ID that will be used when executing external programs.
25d0c3fe	104	The default group is operating system specific but is usually "lp" or "nobody".
37d9646b	105	<dt><a name="LogFilePerm"></a><b>LogFilePerm </b><i>mode</i>
25d0c3fe MS	106	<dd style="margin-left: 5.0em">Specifies the permissions of all log files that the scheduler writes.
25d0c3fe MS	107	The default is "0644".
37d9646b	108	<dt><a name="PageLog"></a><b>PageLog </b>[ <i>filename</i> ]
c59e07c6	109	<dd style="margin-left: 5.0em"><dt><b>PageLog stderr</b>
651e0a22 MS	110	<dd style="margin-left: 5.0em"><dt><b>PageLog syslog</b>
651e0a22 MS	111	<dd style="margin-left: 5.0em">Defines the page log filename.
c59e07c6	112	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	113	The value "syslog" causes log entries to be sent to the system log daemon.
	114	Specifying a blank filename disables page log generation.
	115	The server name may be included in filenames using the string "%s", for example:
	116	<pre class="man">
	117
	118	PageLog /var/log/cups/%s-page_log
	119
	120	</pre>
25d0c3fe	121	The default is "/var/log/cups/page_log".
37d9646b	122	<dt><a name="RemoteRoot"></a><b>RemoteRoot </b><i>username</i>
651e0a22	123	<dd style="margin-left: 5.0em">Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
25d0c3fe	124	The default is "remroot".
37d9646b	125	<dt><a name="RequestRoot"></a><b>RequestRoot </b><i>directory</i>
651e0a22	126	<dd style="margin-left: 5.0em">Specifies the directory that contains print jobs and other HTTP request data.
25d0c3fe	127	The default is "/var/spool/cups".
e9f9e650	128	<dt><a name="Sandboxing"></a><b>Sandboxing relaxed</b>
651e0a22 MS	129	<dd style="margin-left: 5.0em"><dt><b>Sandboxing strict</b>
	130	<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.
	131	The default is "strict".
8072030b	132	This directive is currently only used/supported on macOS.
37d9646b	133	<dt><a name="ServerBin"></a><b>ServerBin </b><i>directory</i>
651e0a22	134	<dd style="margin-left: 5.0em">Specifies the directory containing the backends, CGI programs, filters, helper programs, notifiers, and port monitors.
25d0c3fe	135	The default is "/usr/lib/cups" or "/usr/libexec/cups" depending on the platform.
37d9646b	136	<dt><a name="ServerKeychain"></a><b>ServerKeychain </b><i>path</i>
651e0a22	137	<dd style="margin-left: 5.0em">Specifies the location of TLS certificates and private keys.
8072030b MS	138	The default is "/Library/Keychains/System.keychain" on macOS and "/etc/cups/ssl" on all other operating systems.
8072030b MS	139	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	140	<dt><a name="ServerRoot"></a><b>ServerRoot </b><i>directory</i>
651e0a22	141	<dd style="margin-left: 5.0em">Specifies the directory containing the server configuration files.
25d0c3fe	142	The default is "/etc/cups".
7c7347a3 MS	143	<dt><a name="StateDir"></a><b>StateDir </b><i>directory</i>
	144	<dd style="margin-left: 5.0em">Specifies the directory to use for PID and local certificate files.
	145	The default is "/var/run/cups" or "/etc/cups" depending on the platform.
37d9646b	146	<dt><a name="SyncOnClose"></a><b>SyncOnClose Yes</b>
651e0a22 MS	147	<dd style="margin-left: 5.0em"><dt><b>SyncOnClose No</b>
	148	<dd style="margin-left: 5.0em">Specifies whether the scheduler calls
	149	<b>fsync</b>(2)
25d0c3fe MS	150	after writing configuration or state files.
25d0c3fe MS	151	The default is "No".
37d9646b	152	<dt><a name="SystemGroup"></a><b>SystemGroup </b><i>group-name </i>[ ... <i>group-name</i> ]
651e0a22	153	<dd style="margin-left: 5.0em">Specifies the group(s) to use for <i>@SYSTEM</i> group authentication.
25d0c3fe	154	The default contains "admin", "lpadmin", "root", "sys", and/or "system".
37d9646b	155	<dt><a name="TempDir"></a><b>TempDir </b><i>directory</i>
7c7347a3	156	<dd style="margin-left: 5.0em">Specifies the directory where short-term temporary files are stored.
25d0c3fe	157	The default is "/var/spool/cups/tmp".
37d9646b	158	<dt><a name="User"></a><b>User </b><i>username</i>
651e0a22	159	<dd style="margin-left: 5.0em">Specifies the user name or ID that is used when running external programs.
25d0c3fe	160	The default is "lp".
2909c66c	161	</dl>
7c7347a3 MS	162	<h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3>
	163	The following directives are deprecated and will be removed from a future version of CUPS:
	164	<dl class="man">
	165	<dt><a name="FontPath"></a><b>FontPath </b><i>directory[:...:directoryN]</i>
	166	<dd style="margin-left: 5.0em">Specifies a colon separated list of directories where fonts can be found.
	167	On Linux the
	168	<b>font-config</b>(1)
	169	mechanism is used instead.
	170	On macOS the Font Book application manages system-installed fonts.
	171	<dt><a name="LPDConfigFile"></a><b> LPDConfigFile </b><i>filename</i>
	172	<dd style="margin-left: 5.0em">Specifies the LPD service configuration file to update.
	173	<dt><a name="Printcap"></a><b>Printcap </b><i>filename</i>
	174	<dd style="margin-left: 5.0em">Specifies a file that is filled with a list of local print queues.
	175	<dt><a name="PrintcapFormat"></a><b>PrintcapFormat bsd</b>
	176	<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat plist</b>
	177	<dd style="margin-left: 5.0em"><dt><b>PrintcapFormat solaris</b>
	178	<dd style="margin-left: 5.0em">Specifies the format to use for the Printcap file.
	179	"bsd" is the historical LPD printcap file format.
	180	"plist" is the Apple plist file format.
	181	"solaris" is the historical Solaris LPD printcap file format.
	182	<dt><a name="SMBConfigFile"></a><b>SMBConfigFile </b><i>filename</i>
	183	<dd style="margin-left: 5.0em">Specifies the SMB service configuration file to update.
	184	</dl>
94436c5a	185	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
651e0a22 MS	186	<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
	187	<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
	188	<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
	189	<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
	190	<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
	191	<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
	192	<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
	193	<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
	194	CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
94436c5a	195	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
16365104	196	Copyright © 2007-2017 by Apple Inc.
94436c5a MS	197
	198	</body>
	199	</html>