File:  [LON-CAPA] / loncom / Attic / httpd.conf
Revision 1.1: download - view: text, annotated - select for diffs
Tue Feb 22 21:32:17 2000 UTC (24 years, 2 months ago) by harris41
Branches: MAIN
CVS tags: HEAD, Bacillus
Integrating loncom file into CVS archive.

    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>