Annotation of loncom/httpd.conf, revision 1.1
1.1 ! harris41 1: ##
! 2: ## httpd.conf -- Apache HTTP server configuration file
! 3: ##
! 4:
! 5: # This is the main server configuration file. See URL http://www.apache.org/
! 6: # for instructions.
! 7:
! 8: # Do NOT simply read the instructions in here without understanding
! 9: # what they do, if you are unsure consult the online docs. You have been
! 10: # warned.
! 11:
! 12: # Originally by Rob McCool
! 13:
! 14: # ServerType is either inetd, or standalone.
! 15:
! 16: ServerType standalone
! 17:
! 18: # If you are running from inetd, go to "ServerAdmin".
! 19:
! 20: # Port: The port the standalone listens to. For ports < 1023, you will
! 21: # need httpd to be run as root initially.
! 22:
! 23: Port 80
! 24:
! 25: # HostnameLookups: Log the names of clients or just their IP numbers
! 26: # e.g. www.apache.org (on) or 204.62.129.132 (off)
! 27: # The default is off because it'd be overall better for the net if people
! 28: # had to knowingly turn this feature on.
! 29:
! 30: HostnameLookups off
! 31:
! 32: # If you wish httpd to run as a different user or group, you must run
! 33: # httpd as root initially and it will switch.
! 34:
! 35: # User/Group: The name (or #number) of the user/group to run httpd as.
! 36: # On SCO (ODT 3) use User nouser and Group nogroup
! 37: # On HPUX you may not be able to use shared memory as nobody, and the
! 38: # suggested workaround is to create a user www and use that user.
! 39: # NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)
! 40: # when the value of (unsigned)Group is above 60000;
! 41: # don't use Group nobody on these systems!
! 42:
! 43: User www
! 44: Group users
! 45:
! 46: # ServerAdmin: Your address, where problems with the server should be
! 47: # e-mailed.
! 48:
! 49: ServerAdmin korte@lite.msu.edu
! 50:
! 51: # ServerRoot: The directory the server's config, error, and log files
! 52: # are kept in.
! 53: # NOTE! If you intend to place this on a NFS (or otherwise network)
! 54: # mounted filesystem then please read the LockFile documentation,
! 55: # you will save yourself a lot of trouble.
! 56:
! 57: ServerRoot /etc/httpd
! 58:
! 59: # BindAddress: You can support virtual hosts with this option. This option
! 60: # is used to tell the server which IP address to listen to. It can either
! 61: # contain "*", an IP address, or a fully qualified Internet domain name.
! 62: # See also the VirtualHost directive.
! 63:
! 64: #BindAddress *
! 65:
! 66: # ErrorLog: The location of the error log file. If this does not start
! 67: # with /, ServerRoot is prepended to it.
! 68:
! 69: ErrorLog logs/error_log
! 70:
! 71: # LogLevel: Control the number of messages logged to the error_log.
! 72: # Possible values include: debug, info, notice, warn, error, crit,
! 73: # alert, emerg.
! 74:
! 75: LogLevel warn
! 76:
! 77: # Dynamic Shared Object (DSO) Support
! 78: #
! 79: # To be able to use the functionality of a module which was built as a DSO you
! 80: # have to place corresponding `LoadModule' lines at this location so the
! 81: # directives contained in it are actually available _before_ they are used.
! 82: # Please read the file README.DSO in the Apache 1.3 distribution for more
! 83: # details about the DSO mechanism and run `httpd -l' for the list of already
! 84: # built-in (statically linked and thus always available) modules in your httpd
! 85: # binary.
! 86: #
! 87: # Example:
! 88: # LoadModule foo_module libexec/mod_foo.so
! 89: #
! 90: # Documentation for modules is in "/home/httpd/manual/mod" in HTML format.
! 91:
! 92: #LoadModule mmap_static_module modules/mod_mmap_static.so
! 93: LoadModule env_module modules/mod_env.so
! 94: LoadModule config_log_module modules/mod_log_config.so
! 95: LoadModule agent_log_module modules/mod_log_agent.so
! 96: LoadModule referer_log_module modules/mod_log_referer.so
! 97: #LoadModule mime_magic_module modules/mod_mime_magic.so
! 98: LoadModule mime_module modules/mod_mime.so
! 99: LoadModule negotiation_module modules/mod_negotiation.so
! 100: LoadModule status_module modules/mod_status.so
! 101: LoadModule info_module modules/mod_info.so
! 102: LoadModule includes_module modules/mod_include.so
! 103: LoadModule autoindex_module modules/mod_autoindex.so
! 104: LoadModule dir_module modules/mod_dir.so
! 105: LoadModule cgi_module modules/mod_cgi.so
! 106: LoadModule asis_module modules/mod_asis.so
! 107: LoadModule imap_module modules/mod_imap.so
! 108: LoadModule action_module modules/mod_actions.so
! 109: #LoadModule speling_module modules/mod_speling.so
! 110: LoadModule userdir_module modules/mod_userdir.so
! 111: LoadModule proxy_module modules/libproxy.so
! 112: LoadModule alias_module modules/mod_alias.so
! 113: LoadModule rewrite_module modules/mod_rewrite.so
! 114: LoadModule access_module modules/mod_access.so
! 115: LoadModule auth_module modules/mod_auth.so
! 116: LoadModule anon_auth_module modules/mod_auth_anon.so
! 117: #LoadModule dbm_auth_module modules/mod_auth_dbm.so
! 118: LoadModule db_auth_module modules/mod_auth_db.so
! 119: LoadModule digest_module modules/mod_digest.so
! 120: #LoadModule cern_meta_module modules/mod_cern_meta.so
! 121: LoadModule expires_module modules/mod_expires.so
! 122: LoadModule headers_module modules/mod_headers.so
! 123: LoadModule usertrack_module modules/mod_usertrack.so
! 124: #LoadModule example_module modules/mod_example.so
! 125: #LoadModule unique_id_module modules/mod_unique_id.so
! 126: LoadModule setenvif_module modules/mod_setenvif.so
! 127:
! 128: # Extra Modules
! 129: #LoadModule php_module modules/mod_php.so
! 130: #LoadModule php3_module modules/libphp3.so
! 131: LoadModule perl_module modules/libperl.so
! 132:
! 133: # Reconstruction of the complete module list from all available modules
! 134: # (static and shared ones) to achieve correct module execution order.
! 135: # [WHENEVER YOU CHANGE THE LOADMODULE SECTION ABOVE UPDATE THIS, TOO]
! 136: ClearModuleList
! 137: #AddModule mod_mmap_static.c
! 138: AddModule mod_env.c
! 139: AddModule mod_log_config.c
! 140: AddModule mod_log_agent.c
! 141: AddModule mod_log_referer.c
! 142: #AddModule mod_mime_magic.c
! 143: AddModule mod_mime.c
! 144: AddModule mod_negotiation.c
! 145: AddModule mod_status.c
! 146: AddModule mod_info.c
! 147: AddModule mod_include.c
! 148: AddModule mod_autoindex.c
! 149: AddModule mod_dir.c
! 150: AddModule mod_cgi.c
! 151: AddModule mod_asis.c
! 152: AddModule mod_imap.c
! 153: AddModule mod_actions.c
! 154: #AddModule mod_speling.c
! 155: AddModule mod_userdir.c
! 156: AddModule mod_proxy.c
! 157: AddModule mod_alias.c
! 158: AddModule mod_rewrite.c
! 159: AddModule mod_access.c
! 160: AddModule mod_auth.c
! 161: AddModule mod_auth_anon.c
! 162: #AddModule mod_auth_dbm.c
! 163: AddModule mod_auth_db.c
! 164: AddModule mod_digest.c
! 165: #AddModule mod_cern_meta.c
! 166: AddModule mod_expires.c
! 167: AddModule mod_headers.c
! 168: AddModule mod_usertrack.c
! 169: #AddModule mod_example.c
! 170: #AddModule mod_unique_id.c
! 171: AddModule mod_so.c
! 172: AddModule mod_setenvif.c
! 173:
! 174: # Extra Modules
! 175: #AddModule mod_php.c
! 176: #AddModule mod_php3.c
! 177: AddModule mod_perl.c
! 178:
! 179:
! 180: # The following directives define some format nicknames for use with
! 181: # a CustomLog directive (see below).
! 182:
! 183: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
! 184: LogFormat "%h %l %u %t \"%r\" %>s %b" common
! 185: LogFormat "%{Referer}i -> %U" referer
! 186: LogFormat "%{User-agent}i" agent
! 187:
! 188: # The location of the access logfile (Common Logfile Format).
! 189: # If this does not start with /, ServerRoot is prepended to it.
! 190:
! 191: CustomLog logs/access_log common
! 192:
! 193: # If you would like to have an agent and referer logfile uncomment the
! 194: # following directives.
! 195:
! 196: #CustomLog logs/referer_log referer
! 197: #CustomLog logs/agent_log agent
! 198:
! 199: # If you prefer a single logfile with access, agent and referer information
! 200: # (Combined Logfile Format) you can use the following directive.
! 201:
! 202: #CustomLog logs/access_log combined
! 203:
! 204: # PidFile: The file the server should log its pid to
! 205: PidFile /var/run/httpd.pid
! 206:
! 207: # ScoreBoardFile: File used to store internal server process information.
! 208: # Not all architectures require this. But if yours does (you'll know because
! 209: # this file is created when you run Apache) then you *must* ensure that
! 210: # no two invocations of Apache share the same scoreboard file.
! 211: ScoreBoardFile /var/run/httpd.scoreboard
! 212:
! 213: # The LockFile directive sets the path to the lockfile used when Apache
! 214: # is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
! 215: # USE_FLOCK_SERIALIZED_ACCEPT. This directive should normally be left at
! 216: # its default value. The main reason for changing it is if the logs
! 217: # directory is NFS mounted, since the lockfile MUST BE STORED ON A LOCAL
! 218: # DISK. The PID of the main server process is automatically appended to
! 219: # the filename.
! 220: #
! 221: #LockFile /var/lock/httpd.lock
! 222:
! 223: # ServerName allows you to set a host name which is sent back to clients for
! 224: # your server if it's different than the one the program would get (i.e. use
! 225: # "www" instead of the host's real name).
! 226: #
! 227: # Note: You cannot just invent host names and hope they work. The name you
! 228: # define here must be a valid DNS name for your host. If you don't understand
! 229: # this, ask your network administrator.
! 230:
! 231: #ServerName new.host.name
! 232:
! 233: # UseCanonicalName: (new for 1.3) With this setting turned on, whenever
! 234: # Apache needs to construct a self-referencing URL (a url that refers back
! 235: # to the server the response is coming from) it will use ServerName and
! 236: # Port to form a "canonical" name. With this setting off, Apache will
! 237: # use the hostname:port that the client supplied, when possible. This
! 238: # also affects SERVER_NAME and SERVER_PORT in CGIs.
! 239: UseCanonicalName on
! 240:
! 241: # CacheNegotiatedDocs: By default, Apache sends Pragma: no-cache with each
! 242: # document that was negotiated on the basis of content. This asks proxy
! 243: # servers not to cache the document. Uncommenting the following line disables
! 244: # this behavior, and proxies will be allowed to cache the documents.
! 245:
! 246: #CacheNegotiatedDocs
! 247:
! 248: # Timeout: The number of seconds before receives and sends time out
! 249:
! 250: Timeout 300
! 251:
! 252: # KeepAlive: Whether or not to allow persistent connections (more than
! 253: # one request per connection). Set to "Off" to deactivate.
! 254:
! 255: KeepAlive On
! 256:
! 257: # MaxKeepAliveRequests: The maximum number of requests to allow
! 258: # during a persistent connection. Set to 0 to allow an unlimited amount.
! 259: # We reccomend you leave this number high, for maximum performance.
! 260:
! 261: MaxKeepAliveRequests 100
! 262:
! 263: # KeepAliveTimeout: Number of seconds to wait for the next request
! 264:
! 265: KeepAliveTimeout 15
! 266:
! 267: # Server-pool size regulation. Rather than making you guess how many
! 268: # server processes you need, Apache dynamically adapts to the load it
! 269: # sees --- that is, it tries to maintain enough server processes to
! 270: # handle the current load, plus a few spare servers to handle transient
! 271: # load spikes (e.g., multiple simultaneous requests from a single
! 272: # Netscape browser).
! 273:
! 274: # It does this by periodically checking how many servers are waiting
! 275: # for a request. If there are fewer than MinSpareServers, it creates
! 276: # a new spare. If there are more than MaxSpareServers, some of the
! 277: # spares die off. These values are probably OK for most sites ---
! 278:
! 279: MinSpareServers 8
! 280: MaxSpareServers 20
! 281:
! 282: # Number of servers to start --- should be a reasonable ballpark figure.
! 283:
! 284: StartServers 10
! 285:
! 286: # Limit on total number of servers running, i.e., limit on the number
! 287: # of clients who can simultaneously connect --- if this limit is ever
! 288: # reached, clients will be LOCKED OUT, so it should NOT BE SET TOO LOW.
! 289: # It is intended mainly as a brake to keep a runaway server from taking
! 290: # Unix with it as it spirals down...
! 291:
! 292: MaxClients 150
! 293:
! 294: # MaxRequestsPerChild: the number of requests each child process is
! 295: # allowed to process before the child dies.
! 296: # The child will exit so as to avoid problems after prolonged use when
! 297: # Apache (and maybe the libraries it uses) leak. On most systems, this
! 298: # isn't really needed, but a few (such as Solaris) do have notable leaks
! 299: # in the libraries.
! 300:
! 301: MaxRequestsPerChild 100
! 302:
! 303: # Proxy Server directives. Uncomment the following line to
! 304: # enable the proxy server:
! 305:
! 306: #ProxyRequests On
! 307:
! 308: # To enable the cache as well, edit and uncomment the following lines:
! 309:
! 310: #CacheRoot /var/cache/httpd
! 311: #CacheSize 5
! 312: #CacheGcInterval 4
! 313: #CacheMaxExpire 24
! 314: #CacheLastModifiedFactor 0.1
! 315: #CacheDefaultExpire 1
! 316: #NoCache a_domain.com another_domain.edu joes.garage_sale.com
! 317:
! 318: # Listen: Allows you to bind Apache to specific IP addresses and/or
! 319: # ports, in addition to the default. See also the VirtualHost command
! 320:
! 321: #Listen 3000
! 322: #Listen 12.34.56.78:80
! 323:
! 324: # VirtualHost: Allows the daemon to respond to requests for more than one
! 325: # server address, if your server machine is configured to accept IP packets
! 326: # for multiple addresses. This can be accomplished with the ifconfig
! 327: # alias flag, or through kernel patches like VIF.
! 328:
! 329: # Any httpd.conf or srm.conf directive may go into a VirtualHost command.
! 330: # See also the BindAddress entry.
! 331:
! 332: #<VirtualHost host.some_domain.com>
! 333: #ServerAdmin webmaster@host.some_domain.com
! 334: #DocumentRoot /www/docs/host.some_domain.com
! 335: #ServerName host.some_domain.com
! 336: #ErrorLog logs/host.some_domain.com-error_log
! 337: #TransferLog logs/host.some_domain.com-access_log
! 338: #</VirtualHost>
! 339:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to httpd.conf CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom