Merge changes from CUPS 1.7svn-r10710.

[thirdparty/cups.git] / man / cups-files.conf.man.in

.\"
.\" "$Id$"
.\"
.\"   cupsd.conf man page for CUPS.
.\"
.\"   Copyright 2007-2012 by Apple Inc.
.\"   Copyright 1997-2006 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Apple Inc. and are protected by Federal copyright
.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\"   which should have been included with this file.  If this file is
.\"   file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.TH cups-files.conf 5 "CUPS" "19 November 2012" "Apple Inc."
.SH NAME
cups-files.conf \- file and directory configuration file for cups
.SH DESCRIPTION
The \fIcups-file.conf\fR file configures the files and directories used by the
CUPS scheduler, \fIcupsd(8)\fR.  It is normally located in the
\fI@CUPS_SERVERROOT@\fR directory.
.LP
Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
.SH DIRECTIVES
The following directives are understood by \fIcupsd(8)\fR. Consult the
on-line help for detailed descriptions:
.TP 5
AccessLog filename
.TP 5
AccessLog syslog
.br
Defines the access log filename.
.TP 5
ConfigFilePerm mode
.br
Specifies the permissions for all configuration files that the scheduler
writes.
.TP 5
DataDir path
.br
Specified the directory where data files can be found.
.TP 5
DocumentRoot directory
.br
Specifies the root directory for the internal web server documents.
.TP 5
ErrorLog filename
.TP 5
ErrorLog syslog
.br
Specifies the error log filename.
.TP 5
FatalErrors none
.TP 5
FatalErrors all -kind [... -kind]
.TP 5
FatalErrors kind [... kind]
.br
Specifies which errors are fatal, causing the scheduler to exit. "Kind" is
"browse", "config", "listen", "log", or "permissions".
.TP 5
FileDevice Yes
.TP 5
FileDevice No
.br
Specifies whether the file pseudo-device can be used for new
printer queues.
.TP 5
FontPath directory[:directory:...]
.br
Specifies the search path for fonts.
.TP 5
Group group-name-or-number
.br
Specifies the group name or ID that will be used when executing
external programs.
.TP 5
LogFilePerm mode
.br
Specifies the permissions for all log files that the scheduler writes.
.TP 5
PageLog filename
.TP 5
PageLog syslog
.br
Specifies the page log filename.
.TP 5
Printcap
.TP 5
Printcap filename
.br
Specifies the filename for a printcap file that is updated
automatically with a list of available printers (needed for
legacy applications); specifying Printcap with no filename
disables printcap generation.
.TP 5
RemoteRoot user-name
.br
Specifies the username that is associated with unauthenticated root
accesses.
.TP 5
RequestRoot directory
.br
Specifies the directory to store print jobs and other HTTP request
data.
.TP 5
ServerBin directory
.br
Specifies the directory where backends, CGIs, daemons, and filters may
be found.
.TP 5
ServerCertificate filename
.br
Specifies the encryption certificate to use.
.TP 5
ServerKey filename
.br
Specifies the encryption key to use.
.TP 5
ServerRoot directory
.br
Specifies the directory where the server configuration files can be found.
.TP 5
SystemGroup group-name [group-name ...]
.br
Specifies the group(s) to use for System class authentication.
.TP 5
TempDir directory
.br
Specifies the directory where temporary files are stored.
.TP 5
User user-name
.br
Specifies the user name or ID that is used when running external programs.
.SH SEE ALSO
\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, \fImime.convs(5)\fR,
\fImime.types(5)\fR, \fIprinters.conf(5)\fR,
\fIsubscriptions.conf(5)\fR,
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007-2012 by Apple Inc.
.\"
.\" End of "$Id$".
.\"