Provided by: cups-daemon_2.1.3-4_amd64 bug

NAME

       cups-files.conf - file and directory configuration file for cups

DESCRIPTION

       The  cups-files.conf file configures the files and directories used by the CUPS scheduler,
       cupsd(8).  It is normally located in the /etc/cups directory.

       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.

   DIRECTIVES
       The following directives are understood by cupsd(8):

       AccessLog

       AccessLog filename

       AccessLog stderr

       AccessLog syslog
            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:

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

            The default is "/var/log/cups/access_log".

       ConfigFilePerm mode
            Specifies the permissions for all configuration files that the scheduler writes.  The
            default is "0644" on OS X and "0640" on all other operating systems.

       Note: The permissions for the printers.conf 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.

       DataDir path
            Specifies the directory where data files  can  be  found.   The  default  is  usually
            "/usr/share/cups".

       DocumentRoot directory
            Specifies  the  root  directory  for  the CUPS web interface content.  The default is
            usually "/usr/share/doc/cups".

       ErrorLog

       ErrorLog filename

       ErrorLog stderr

       ErrorLog syslog
            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:

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

            The default is "/var/log/cups/error_log".

       FatalErrors none

       FatalErrors all -kind [ ... -kind ]

       FatalErrors kind [ ... kind ]
            Specifies  which  errors  are  fatal,  causing the scheduler to exit.  The default is
            "config".  The kind strings are:

            none No errors are fatal.

            all  All of the errors below are fatal.

            browse
                 Browsing initialization errors are fatal, for example failed connections to  the
                 DNS-SD daemon.

            config
                 Configuration file syntax errors are fatal.

            listen
                 Listen  or  Port  errors  are fatal, except for IPv6 failures on the loopback or
                 "any" addresses.

            log  Log file creation or write errors are fatal.

            permissions
                 Bad startup file permissions are fatal, for example shared TLS  certificate  and
                 key files with world-read permissions.

       FileDevice Yes

       FileDevice No
            Specifies whether the file pseudo-device can be used for new printer queues.  The URI
            "file:///dev/null" is always allowed.

       Group group-name-or-number
            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".

       LogFilePerm mode
            Specifies the permissions of all log files that the scheduler writes.  The default is
            "0644".

       PageLog [ filename ]

       PageLog stderr

       PageLog syslog
            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:

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

            The default is "/var/log/cups/page_log".

       RemoteRoot username
            Specifies  the  username  that is associated with unauthenticated accesses by clients
            claiming to be the root user.  The default is "remroot".

       RequestRoot directory
            Specifies the directory that contains print jobs and other HTTP  request  data.   The
            default is "/var/spool/cups".

       Sandboxing relaxed

       Sandboxing strict
            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 OS X.

       ServerBin directory
            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.

       ServerKeychain path
            Specifies  the  location  of  TLS  certificates  and  private  keys.   The default is
            "/Library/Keychains/System.keychain"  on  OS  X  and  "/etc/cups/ssl"  on  all  other
            operating  systems.   OS  X 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.

       ServerRoot directory
            Specifies  the  directory  containing the server configuration files.  The default is
            "/etc/cups".

       SyncOnClose Yes

       SyncOnClose No
            Specifies whether the scheduler calls fsync(2) after writing configuration  or  state
            files.  The default is "Yes".

       SystemGroup group-name [ ... group-name ]
            Specifies the group(s) to use for @SYSTEM group authentication.  The default contains
            "admin", "lpadmin", "root", "sys", and/or "system".

       TempDir directory
            Specifies  the  directory  where  temporary  files  are  stored.   The   default   is
            "/var/spool/cups/tmp".

       User username
            Specifies  the  user  name  or  ID  that is used when running external programs.  The
            default is "lp".

SEE ALSO

       classes.conf(5),   cups(1),   cupsd(8),   cupsd.conf(5),   mime.convs(5),   mime.types(5),
       printers.conf(5), subscriptions.conf(5), CUPS Online Help (http://localhost:631/help)

COPYRIGHT

       Copyright © 2007-2015 by Apple Inc.