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 normally located in the /etc/cups direc- tory. Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character. The configuration directives 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, Sys- tem) AuthGroupName Specifies the authentication group. AuthType Specifies the authentication type (None, Basic, Digest) AutoPurgeJobs Specifies whether to purge job history data automati- cally when it is no longer required for quotas. BrowseAddress Specifies a broadcast address for outgoing printer information packets. BrowseAllow Allows incoming printer information packets from the named host or address. BrowseDeny Denies incoming printer information packets from the named host or address. BrowseInterval Specifies the maximum interval between printer 18 August 2004 Common UNIX Printing System 1 cupsd.conf(5) Easy Software Products cupsd.conf(5) 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 informa- tion 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 infor- mation updates before remote printers will be removed from the list of available printers. 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 individual print jobs. ConfigFilePerm Specifies the permissions for all configuration files that the scheduler writes. DataDir Specified the directory where data files can be found. DefaultCharset Specifies the default character set to use for text. 18 August 2004 Common UNIX Printing System 2 cupsd.conf(5) Easy Software Products cupsd.conf(5) 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 external programs. HideImplicitMembers Specifies whether to hide members of implicit classes. HostNameLookups Specifies whether or not to do reverse lookups on client addresses. 18 August 2004 Common UNIX Printing System 3 cupsd.conf(5) Easy Software Products cupsd.conf(5) ImplicitAnyClasses Specifies whether or not to create implicit classes for local and remote printers, e.g. "AnyPrinter" from "Printer", "Printer@server1", and "Printer@server2". ImplicitClasses Specifies whether or not to create implicit classes from identical remote 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 debug2) 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. 18 August 2004 Common UNIX Printing System 4 cupsd.conf(5) Easy Software Products cupsd.conf(5) MaxJobs Specifies the maximum number of simultaneous jobs to support. MaxJobsPerPrinter Specifies the maximum number of simultaneous jobs per printer to support. 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 automatically with a list of available print- ers (needed for legacy applications) 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 comple- tion before restarting the scheduler. 18 August 2004 Common UNIX Printing System 5 cupsd.conf(5) Easy Software Products cupsd.conf(5) RemoteRoot Specifies the username that is associated with unau- thenticated 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 Loca- tion must be satisfied to allow access. ServerAdmin Specifies the email address of the server administra- tor. ServerBin Specifies the directory where backends, CGIs, dae- mons, 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 configura- tion 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. 18 August 2004 Common UNIX Printing System 6 cupsd.conf(5) Easy Software Products cupsd.conf(5) SSLPort Listens on the specified port for encrypted connec- tions. SystemGroup Specifies the group to use for System class authenti- cation. 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 run- ning external programs. SEE ALSO classes.conf(5), cupsd(8), mime.convs(5), mime.types(5), printers.conf(5), CUPS Software Administrators Manual, http://localhost:631/documentation.html COPYRIGHT Copyright 1993-2005 by Easy Software Products, All Rights Reserved. 18 August 2004 Common UNIX Printing System 7