man/cups-files.conf.man.in

   1 .\"
   2 .\" "$Id: cups-files.conf.man.in 11201 2013-07-26 21:27:27Z msweet $"
   3 .\"
   4 .\"   cupsd.conf man page for CUPS.
   5 .\"
   6 .\"   Copyright 2007-2013 by Apple Inc.
   7 .\"   Copyright 1997-2006 by Easy Software Products.
   8 .\"
   9 .\"   These coded instructions, statements, and computer programs are the
  10 .\"   property of Apple Inc. and are protected by Federal copyright
  11 .\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  12 .\"   which should have been included with this file.  If this file is
  13 .\"   file is missing or damaged, see the license at "http://www.cups.org/".
  14 .\"
  15 .TH cups-files.conf 5 "CUPS" "26 July 2013" "Apple Inc."
  16 .SH NAME
  17 cups-files.conf \- file and directory configuration file for cups
  18 .SH DESCRIPTION
  19 The \fIcups-files.conf\fR file configures the files and directories used by the
  20 CUPS scheduler, \fIcupsd(8)\fR.  It is normally located in the
  21 \fI/etc/cups\fR directory.
  22 .LP
  23 Each line in the file can be a configuration directive, a blank line,
  24 or a comment. Comment lines start with the # character.
  25 .SH DIRECTIVES
  26 The following directives are understood by \fIcupsd(8)\fR. Consult the
  27 on-line help for detailed descriptions:
  28 .TP 5
  29 AccessLog filename
  30 .TP 5
  31 AccessLog syslog
  32 .br
  33 Defines the access log filename.
  34 .TP 5
  35 ConfigFilePerm mode
  36 .br
  37 Specifies the permissions for all configuration files that the scheduler
  38 writes.
  39 .TP 5
  40 DataDir path
  41 .br
  42 Specified the directory where data files can be found.
  43 .TP 5
  44 DocumentRoot directory
  45 .br
  46 Specifies the root directory for the internal web server documents.
  47 .TP 5
  48 ErrorLog filename
  49 .TP 5
  50 ErrorLog syslog
  51 .br
  52 Specifies the error log filename.
  53 .TP 5
  54 FatalErrors none
  55 .TP 5
  56 FatalErrors all -kind [... -kind]
  57 .TP 5
  58 FatalErrors kind [... kind]
  59 .br
  60 Specifies which errors are fatal, causing the scheduler to exit. "Kind" is
  61 "browse", "config", "listen", "log", or "permissions".
  62 .TP 5
  63 FileDevice Yes
  64 .TP 5
  65 FileDevice No
  66 .br
  67 Specifies whether the file pseudo-device can be used for new
  68 printer queues.
  69 .TP 5
  70 FontPath directory[:directory:...]
  71 .br
  72 Specifies the search path for fonts.
  73 .TP 5
  74 Group group-name-or-number
  75 .br
  76 Specifies the group name or ID that will be used when executing
  77 external programs.
  78 .TP 5
  79 LogFilePerm mode
  80 .br
  81 Specifies the permissions for all log files that the scheduler writes.
  82 .TP 5
  83 PageLog filename
  84 .TP 5
  85 PageLog syslog
  86 .br
  87 Specifies the page log filename.
  88 .TP 5
  89 Printcap
  90 .TP 5
  91 Printcap filename
  92 .br
  93 Specifies the filename for a printcap file that is updated
  94 automatically with a list of available printers (needed for
  95 legacy applications); specifying Printcap with no filename
  96 disables printcap generation.
  97 .TP 5
  98 RemoteRoot user-name
  99 .br
 100 Specifies the username that is associated with unauthenticated root
 101 accesses.
 102 .TP 5
 103 RequestRoot directory
 104 .br
 105 Specifies the directory to store print jobs and other HTTP request
 106 data.
 107 .TP 5
 108 ServerBin directory
 109 .br
 110 Specifies the directory where backends, CGIs, daemons, and filters may
 111 be found.
 112 .TP 5
 113 ServerCertificate filename
 114 .br
 115 Specifies the encryption certificate to use.
 116 .TP 5
 117 ServerKey filename
 118 .br
 119 Specifies the encryption key to use.
 120 .TP 5
 121 ServerRoot directory
 122 .br
 123 Specifies the directory where the server configuration files can be found.
 124 .TP 5
 125 SyncOnClose Yes
 126 .TP 5
 127 SyncOnClose No
 128 Specifies whether the scheduler calls \fIfsync(2)\fR after writing configuration
 129 or state files. The default is No.
 130 .TP 5
 131 SystemGroup group-name [group-name ...]
 132 .br
 133 Specifies the group(s) to use for System class authentication.
 134 .TP 5
 135 TempDir directory
 136 .br
 137 Specifies the directory where temporary files are stored.
 138 .TP 5
 139 User user-name
 140 .br
 141 Specifies the user name or ID that is used when running external programs.
 142 .SH SEE ALSO
 143 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, \fImime.convs(5)\fR,
 144 \fImime.types(5)\fR, \fIprinters.conf(5)\fR,
 145 \fIsubscriptions.conf(5)\fR,
 146 .br
 147 http://localhost:631/help
 148 .SH COPYRIGHT
 149 Copyright 2007-2013 by Apple Inc.
 150 .\"
 151 .\" End of "$Id: cups-files.conf.man.in 11201 2013-07-26 21:27:27Z msweet $".
 152 .\"