standard.html.in   [plain text]


<HTML>
<!-- SECTION: Getting Started -->
<HEAD>
	<TITLE>Standard Configuration</TITLE>
	<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
</HEAD>
<BODY>

<H1 CLASS="title">Standard Configuration</H1>

<P>This document describes the standard configuration for this CUPS
server.</P>

<BLOCKQUOTE><B>Note:</B>

<!-- Packagers: Change the following statement and the following sections
     if you make any changes to the standard CUPS distribution that are
     not automatically updated by the configure script. -->
<P>This file reflects the standard CUPS configuration as distributed
by Apple Inc, the developer of CUPS.</P>

</BLOCKQUOTE>


<H2 CLASS="title"><A NAME="CUPSD">cupsd Configuration</A></H2>

<P><CODE>cupsd(8)</CODE> is configured by default to show
printers shared by other systems and only allow local access to
the system and its printers. Administration operations require
Basic authentication with membership in the group
"@CUPS_GROUP@".</P>

<P>Connections are accepted via domain socket
(<VAR>@CUPS_DEFAULT_DOMAINSOCKET@</VAR>) or "localhost"
(127.0.0.1).</P>

<H3><A NAME="SETTINGS">Settings</A></H3>

<DIV CLASS="table"><TABLE SUMMARY="Default Values">
<CAPTION>Table 1: Default Values</CAPTION>
<TR>
	<TH>Directive</TH>
	<TH>Value</TH>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#Browsing">Browsing</A></CODE></TD>
	<TD><CODE>@CUPS_BROWSING@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#BrowseLocalProtocols">BrowseLocalProtocols</A></CODE></TD>
	<TD><CODE>@CUPS_BROWSE_LOCAL_PROTOCOLS@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#BrowseRemoteProtocols">BrowseRemoteProtocols</A></CODE></TD>
	<TD><CODE>@CUPS_BROWSE_REMOTE_PROTOCOLS@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#BrowseShortNames">BrowseShortNames</A></CODE></TD>
	<TD><CODE>@CUPS_BROWSE_SHORT_NAMES@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#ConfigFilePerm">ConfigFilePerm</A></CODE></TD>
	<TD><CODE>@CUPS_CONFIG_FILE_PERM@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#DefaultShared">DefaultShared</A></CODE></TD>
	<TD><CODE>@CUPS_DEFAULT_SHARED@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#ImplicitClasses">ImplicitClasses</A></CODE></TD>
	<TD><CODE>@CUPS_IMPLICIT_CLASSES@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#LogFilePerm">LogFilePerm</A></CODE></TD>
	<TD><CODE>@CUPS_LOG_FILE_PERM@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#MaxCopies">MaxCopies</A></CODE></TD>
	<TD><CODE>@CUPS_MAX_COPIES@</CODE></TD>
</TR>
<TR>
	<TD><CODE><A HREF="ref-cupsd-conf.html#UseNetworkDefault">UseNetworkDefault</A></CODE></TD>
	<TD><CODE>@CUPS_USE_NETWORK_DEFAULT@</CODE></TD>
</TR>
</TABLE></DIV>


<H2 CLASS="title"><A NAME="DIRECTORIES">Directories</A></H2>

<DIV CLASS="table"><TABLE SUMMARY="Directories">
<CAPTION>Table 2: Directories</CAPTION>
<TR>
	<TH>Directory</TH>
	<TH>Purpose</TH>
</TR>
<TR>
	<TD><VAR>@CUPS_SERVERROOT@</VAR></TD>
	<TD>The location of configuration files such as
	<VAR>printers.conf</VAR>. Overridden by the <A
	HREF="ref-cupsd-conf.html#ServerRoot"><CODE>ServerRoot</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@bindir@</VAR></TD>
	<TD>The location of user programs.</TD>
</TR>
<TR>
	<TD><VAR>@includedir@</VAR></TD>
	<TD>The location of CUPS include files.</TD>
</TR>
<TR>
	<TD><VAR>@libdir@</VAR></TD>
	<TD>The location of CUPS library files.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_SERVERBIN@</VAR></TD>
	<TD>The location of server programs such as backends and
	filters. Overridden by the <A
	HREF="ref-cupsd-conf.html#ServerBin"><CODE>ServerBin</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@sbindir@</VAR></TD>
	<TD>The location of administrator programs.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_DATADIR@</VAR></TD>
	<TD>The location of data files such as fonts. Overridden
	by the <A
	HREF="ref-cupsd-conf.html#DataDir"><CODE>DataDir</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_DOCROOT@</VAR></TD>
	<TD>The location of documentation files. Overridden by
	the <A
	HREF="ref-cupsd-conf.html#DocumentRoot"><CODE>DocumentRoot</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_LOCALEDIR@</VAR></TD>
	<TD>The location of localization files.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_CACHEDIR@</VAR></TD>
	<TD>The location of cache files such as
	<VAR>ppds.dat</VAR> and <VAR>remote.cache</VAR>.
	Overridden by the <A
	HREF="ref-cupsd-conf.html#CacheDir"><CODE>CacheDir</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_LOGDIR@</VAR></TD>
	<TD>The location of the <VAR>access_log</VAR>,
	<VAR>error_log</VAR>, and <VAR>page_log</VAR> files.
	Overridden by the <A
	HREF="ref-cupsd-conf.html#AccessLog"><CODE>AccessLog</CODE></A>,
	<A
	HREF="ref-cupsd-conf.html#ErrorLog"><CODE>ErrorLog</CODE></A>,
	<A
	HREF="ref-cupsd-conf.html#PageLog"><CODE>PageLog</CODE></A>,
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_STATEDIR@</VAR></TD>
	<TD>The location of the domain socket file and state data
	such as authentication certificates. Overridden by the <A
	HREF="ref-cupsd-conf.html#StateDir"><CODE>StateDir</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
<TR>
	<TD><VAR>@CUPS_REQUESTS@</VAR></TD>
	<TD>The location of spooled print jobs. Overridden by the
	<A
	HREF="ref-cupsd-conf.html#RequestRoot"><CODE>RequestRoot</CODE></A>
	directive in <VAR>cupsd.conf</VAR>.</TD>
</TR>
</TABLE></DIV>

</BODY>
</HTML>