cupsd(5) -- Linux man page

 

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 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 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, 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 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 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 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.
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.
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.
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 printers (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 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 satisfied 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 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.php  

COPYRIGHT

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