cupsd.conf(5)

cupsd.conf - server configuration file for cups

As shipped in IRIX 6.5.30. Added in IRIX 6.5.30.

NAME
     cupsd.conf - server configuration file for cups

DESCRIPTION
     The  cupsd.conf  file  configures the CUPS scheduler, cupsd(8).  It is nor-
     mally located in the /etc/cups directory.

     Each line in the file can be a configuration directive, a blank line, or  a
     comment. Comment lines start with the # character. The configuration direc-
     tives  are  intentionally  similar  to those used by the popular Apache web
     server software and are described below.

DIRECTIVES
     The following directives are understood by cupsd. Consult the CUPS Software
     Administrators Manual for a detailed description:

     AccessLog
          Defines the access log filename.

     Allow
          Allows access from the named hosts or addresses.

     AuthClass
          Specifies the authentication class (User, Group, System)

     AuthGroupName
          Specifies the authentication group.

     AuthType
          Specifies the authentication type (None, Basic, Digest)

     AutoPurgeJobs
          Specifies whether to purge job history data automatically when  it  is
          no longer required for quotas.

     BrowseAddress
          Specifies  a  broadcast address for outgoing printer information pack-
          ets.

     BrowseAllow
          Allows incoming printer information packets from the named host or ad-
          dress.

     BrowseDeny
          Denies incoming printer information packets from the named host or ad-
          dress.

     BrowseInterval
          Specifies the maximum interval between printer information broadcasts.

     BrowseOrder
          Specifies the order of printer information access control  (allow,deny
          or deny,allow)

     BrowsePoll
          Specifies a server to poll for printer information.

     BrowsePort
          Specifies the port to listen to for printer information packets.

     BrowseProtocols
          Specifies the protocols to use for printer browsing.

     BrowseRelay
          Specifies  that printer information packets should be relayed from one
          host or network to another.

     BrowseShortNames
          Specifies whether remote printers will use short names ("printer")  or
          not ("printer@server"). This option is ignored if more than one remote
          printer exists with the same name.

     BrowseTimeout
          Specifies the maximum interval between printer information updates be-
          fore remote printers will be removed from the list of available print-
          ers.

     Browsing
          Specifies whether or not remote printer browsing should be enabled.

     Classification
          Specifies the security classification of the server.

     ClassifyOverride
          Specifies whether to allow users to override the classification of in-
          dividual print jobs.

     ConfigFilePerm
          Specifies  the permissions for all configuration files that the sched-
          uler writes.

     DataDir
          Specified the directory where data files can be found.

     DefaultCharset
          Specifies the default character set to use for text.

     DefaultLanguage
          Specifies the default language to use for text and web content.

     Deny
          Denies access to the named host or address.

     DocumentRoot
          Specifies the root directory for the internal web server documents.

     Encryption
          Specifies the level of encryption that is required  for  a  particular
          location.

     ErrorLog
          Specifies the error log filename.

     FaxRetryInterval
          Specifies the interval between retries of fax jobs in seconds.

     FaxRetryLimit
          Specifies the number of retries that are done for fax jobs.

     FileDevice
          Specifies  whether  the file pseudo-device can be used for new printer
          queues.

     FilterLimit
          Specifies the maximum cost of filters that are run concurrently.

     FilterNice
          Specifies the scheduling priority ("nice" value) of filters  that  are
          run to print a job.

     FontPath
          Specifies the search path for fonts.

     Group
          Specifies the group name or ID that will be used when executing exter-
          nal programs.

     HideImplicitMembers
          Specifies whether to hide members of implicit classes.

     HostNameLookups
          Specifies whether or not to do reverse lookups on client addresses.

     ImplicitAnyClasses
          Specifies  whether or not to create implicit classes for local and re-
          mote printers, e.g. "AnyPrinter"  from  "Printer",  "Printer@server1",
          and "Printer@server2".

     ImplicitClasses
          Specifies whether or not to create implicit classes from identical re-
          mote printers.

     Include
          Includes the named file.

     KeepAlive
          Specifies whether or not to support HTTP Keep-Alive.

     KeepAliveTimeout
          Specifies the connection timeout for HTTP Keep-Alive.

     <Limit methods> ... </Limit>

     <LimitExcept methods> ... </LimitExcept>
          Specifies the HTTP methods that are being limited inside a location.

     LimitRequestBody
          Specifies the maximum size of any print job request.

     Listen
          Listens to the specified address and port.

     <Location /path> ... </Location>
          Specifies access control for the named location.

     LogFilePerm
          Specifies the permissions for all log files that the scheduler writes.

     LogLevel
          Specifies  the  logging  level (none, warn, error, info, debug, or de-
          bug2)

     MaxClients
          Specifies the maximum number of simultaneous clients to support.

     MaxClientsPerHost
          Specifies the maximum number of simultaneous clients to support from a
          single address.

     MaxCopies
          Specifies the maximum number of copies that a user can print  of  each
          job.

     MaxJobs
          Specifies the maximum number of simultaneous jobs to support.

     MaxJobsPerPrinter
          Specifies  the maximum number of simultaneous jobs per printer to sup-
          port.

     MaxJobsPerUser
          Specifies the maximum number of simultaneous jobs per user to support.

     MaxLogSize
          Specifies the maximum size of the log files before they are rotated (0
          to disable rotation)

     MaxRequestSize
          Specifies the maximum request/file size in bytes (0 for no limit)

     Order
          Specifies the order of HTTP access control (allow,deny or deny,allow)

     PageLog
          Specifies the page log filename.

     Port
          Specifies a port number to listen to for HTTP requests.

     PreserveJobFiles
          Specifies whether or not to preserve job files after they are printed.

     PreserveJobHistory
          Specifies whether or not to preserve the job history  after  they  are
          printed.

     Printcap
          Specifies  the  filename for a printcap file that is updated automati-
          cally with a list of available printers (needed  for  legacy  applica-
          tions)

     PrintcapFormat
          Specifies the format of the printcap file.

     PrintcapGUI
          Specifies  whether  to  generate option panel definition files on some
          operating systems.

     ReloadTimeout
          Specifies the amount  of  time  to  wait  for  job  completion  before
          restarting the scheduler.

     RemoteRoot
          Specifies  the  username  that is associated with unauthenticated root
          accesses.

     RequestRoot
          Specifies the directory to store print jobs  and  other  HTTP  request
          data.

     Require
          Specifies that user or group authentication is required.

     RIPCache
          Specifies  the  maximum amount of memory to use when converting images
          and PostScript files to bitmaps for a printer.

     RunAsUser
          Specifies that the scheduler should run as the unpriviledged user  set
          with the User directive.

     Satisfy
          Specifies  whether all or any limits set for a Location must be satis-
          fied to allow access.

     ServerAdmin
          Specifies the email address of the server administrator.

     ServerBin
          Specifies the directory where backends, CGIs, daemons, and filters may
          be found.

     ServerCertificate
          Specifies the encryption certificate to use.

     ServerKey
          Specifies the encryption key to use.

     ServerName
          Specifies the fully-qualified hostname of the server.

     ServerRoot
          Specifies the directory where the server configuration  files  can  be
          found.

     ServerTokens
          Specifies  what  information  is included in the Server header of HTTP
          responses.

     SSLListen
          Listens on the specified address and port for encrypted connections.

     SSLPort
          Listens on the specified port for encrypted connections.

     SystemGroup
          Specifies the group to use for System class authentication.

     TempDir
          Specifies the directory where temporary files are stored.

     Timeout
          Specifies the HTTP request timeout in seconds.

     User
          Specifies the user name or ID that is used when running external  pro-
          grams.

SEE ALSO
     classes.conf(5),  cupsd(8), mime.convs(5), mime.types(5), printers.conf(5),
     CUPS  Software   Administrators   Manual,   http://localhost:631/documenta-
     tion.html

COPYRIGHT
     Copyright 1993-2005 by Easy Software Products, All Rights Reserved.