for my own benefit, i categorized the options one might find in
the configuration file /etc/cups/cupsd.conf. it's not meant to be
an explanation of these directives, just a categorization. if it
makes your life easier, enjoy.
(the strange format is because i wrote it in emacs outline mode
for the moment. if you have suggestions for improvement, drop me
a note. some day, i'll come up with an XML format and stylesheet
for reference cards, unless someone wants to send me one. :-)
================= cut here ==================
***** Server identity settings
ServerName # default hostname
ServerAdmin # default root@<servername>
User # default lp
RunAsUser {*No|Yes}
Group # one of sys, system or root, probably
***** Networking info
Listen <IP>:<port> # can have multiple directives
Port <port> # default 631
HostNameLookups {*Off|On|Double}
***** Authentication settings
SystemGroup # sys, system, root
RemoteRoot # default remroot
SSLListen # can have multiple directives
SSLPort # can have multiple directives
ServerCertificate # default /etc/cups/ssl/server.crt
ServerKey # default /etc/cups/ssl/server.key
***** Browsing settings
Browsing {*On|Off}
BrowseAddress # can have multiple directives
BrowseAllow # default to accept all browse packets
BrowseDeny # default to deny no browse packets
BrowseOrder {*deny,allow|allow,deny}
BrowsePoll # can have multiple directives
BrowseInterval <seconds>
BrowseTimeout <seconds>
BrowsePort # default 631
BrowseProtocols # default CUPS
BrowseRelay # can have multiple directives
BrowseShortNames {*Yes|No}
***** Configuration info inclusion
Include <filename>
***** Character and language settings
DefaultCharset # default utf-8
DefaultLanguage # default en
***** File/directory locations
ServerRoot # default /etc/cups
ServerBin # default /usr/lib/cups
DocumentRoot # default /usr/share/doc/cups, for httpd web content
FontPath # default /usr/share/cups/fonts
DataDir # the directory to use for data files
TempDir # default /var/tmp, should have sticky bit
RequestRoot # default /var/spool/cups
***** File attributes
ConfigFilePerm # default 0600
LogFilePerm # default 0644
***** Classification info
Classification {unclassified|classified|confidential|secret|topsecret}
ClassifyOverride {*No|Yes}
***** Job limits
MaxClients # default 100
MaxJobs # default 0 (no maximum)
MaxJobsPerPrinter # default 0 (no maximum)
MaxJobsPerUser # default 0 (no maximum)
MaxRequestSize # default 0 (no maximum)
LimitRequestBody # default 0 (no limit)
RIPCache # default 8M
FilterLimit # default 0 (no filter limiting)
***** Logging/recording
AccessLog # name of access log file
ErrorLog # default /var/log/cups/error_log
PageLog # default /var/log/cups/page_log
MaxLogSize # default 1M
AutoPurgeJobs {Yes|*No}
LogLevel {none|debug2|debug|info|notice|warn|error|crit|alert|emerg}
PreserveJobHistory {*On|Off}
PreserveJobFiles {On|*Off}
***** Timeout settings
KeepAlive {*On|Off} # support persistent HTTP connections?
KeepAliveTimeout # default 60 seconds
Timeout # default 300 seconds
***** Printcap settings
Printcap # default /etc/printcap
PrintcapFormat {*BSD|Solaris}
PrintcapGUI # for IRIX applications only
***** Implicit printer settings
ImplicitClasses {*On|Off}
ImplicitAnyClasses {On|*Off}
HideImplicitMembers {*no|Yes}
***** Location directive and contents
<Location
/
/admin
/admin/conf
/classes
/classes/name
/jobs
/jobs/id
/printers
/printers/name
/printers/name.ppd
</Location>
Allow
Deny
Order {Allow,Deny|Deny,Allow}
Require
Satisfy {*all|any}
AuthClass {*Anonymous|User|System|Group}
AuthGroupName
AuthType {*None|Basic|Digest|BasicDigest}
Encryption {Never|*IfRequested|Required|Always}
Limit
LimitExcept
============== cut here ==============
rday
Robert P. J. Day, RHCE, RHCI
Eno River Technologies, Chapel Hill NC
Unix, Linux and Open Source corporate training
http://www.linux-migration.org
