Annotation of doc/install/linux/centos-rhes-fedora-sl/new/httpd.conf, revision 1.1

1.1     ! raeburn     1: #
        !             2: # This is the main Apache server configuration file.  It contains the
        !             3: # configuration directives that give the server its instructions.
        !             4: # See <URL:http://httpd.apache.org/docs/2.2/> for detailed information.
        !             5: # In particular, see
        !             6: # <URL:http://httpd.apache.org/docs/2.2/mod/directives.html>
        !             7: # for a discussion of each configuration directive.
        !             8: #
        !             9: #
        !            10: # Do NOT simply read the instructions in here without understanding
        !            11: # what they do.  They're here only as hints or reminders.  If you are unsure
        !            12: # consult the online docs. You have been warned.  
        !            13: #
        !            14: # The configuration directives are grouped into three basic sections:
        !            15: #  1. Directives that control the operation of the Apache server process as a
        !            16: #     whole (the 'global environment').
        !            17: #  2. Directives that define the parameters of the 'main' or 'default' server,
        !            18: #     which responds to requests that aren't handled by a virtual host.
        !            19: #     These directives also provide default values for the settings
        !            20: #     of all virtual hosts.
        !            21: #  3. Settings for virtual hosts, which allow Web requests to be sent to
        !            22: #     different IP addresses or hostnames and have them handled by the
        !            23: #     same Apache server process.
        !            24: #
        !            25: # Configuration and logfile names: If the filenames you specify for many
        !            26: # of the server's control files begin with "/" (or "drive:/" for Win32), the
        !            27: # server will use that explicit path.  If the filenames do *not* begin
        !            28: # with "/", the value of ServerRoot is prepended -- so "logs/foo.log"
        !            29: # with ServerRoot set to "/etc/httpd" will be interpreted by the
        !            30: # server as "/etc/httpd/logs/foo.log".
        !            31: #
        !            32: 
        !            33: ### Section 1: Global Environment
        !            34: #
        !            35: # The directives in this section affect the overall operation of Apache,
        !            36: # such as the number of concurrent requests it can handle or where it
        !            37: # can find its configuration files.
        !            38: #
        !            39: 
        !            40: #
        !            41: # Don't give away too much information about all the subcomponents
        !            42: # we are running.  Comment out this line if you don't mind remote sites
        !            43: # finding out what major optional modules you are running
        !            44: ServerTokens OS
        !            45: 
        !            46: #
        !            47: # ServerRoot: The top of the directory tree under which the server's
        !            48: # configuration, error, and log files are kept.
        !            49: #
        !            50: # NOTE!  If you intend to place this on an NFS (or otherwise network)
        !            51: # mounted filesystem then please read the LockFile documentation
        !            52: # (available at <URL:http://httpd.apache.org/docs/2.2/mod/mpm_common.html#lockfile>);
        !            53: # you will save yourself a lot of trouble.
        !            54: #
        !            55: # Do NOT add a slash at the end of the directory path.
        !            56: #
        !            57: ServerRoot "/etc/httpd"
        !            58: 
        !            59: #
        !            60: # PidFile: The file in which the server should record its process
        !            61: # identification number when it starts.
        !            62: #
        !            63: PidFile /var/run/httpd/httpd.pid
        !            64: 
        !            65: #
        !            66: # Timeout: The number of seconds before receives and sends time out.
        !            67: #
        !            68: Timeout 300
        !            69: 
        !            70: #
        !            71: # KeepAlive: Whether or not to allow persistent connections (more than
        !            72: # one request per connection). Set to "Off" to deactivate.
        !            73: #
        !            74: KeepAlive Off
        !            75: 
        !            76: #
        !            77: # MaxKeepAliveRequests: The maximum number of requests to allow
        !            78: # during a persistent connection. Set to 0 to allow an unlimited amount.
        !            79: # We recommend you leave this number high, for maximum performance.
        !            80: #
        !            81: MaxKeepAliveRequests 100
        !            82: 
        !            83: #
        !            84: # KeepAliveTimeout: Number of seconds to wait for the next request from the
        !            85: # same client on the same connection.
        !            86: #
        !            87: KeepAliveTimeout 15
        !            88: 
        !            89: ##
        !            90: ## Server-Pool Size Regulation (MPM specific)
        !            91: ## 
        !            92: 
        !            93: # prefork MPM
        !            94: # StartServers: number of server processes to start
        !            95: # MinSpareServers: minimum number of server processes which are kept spare
        !            96: # MaxSpareServers: maximum number of server processes which are kept spare
        !            97: # ServerLimit: maximum value for MaxClients for the lifetime of the server
        !            98: # MaxClients: maximum number of server processes allowed to start
        !            99: # MaxRequestsPerChild: maximum number of requests a server process serves
        !           100: <IfModule prefork.c>
        !           101: StartServers       8
        !           102: MinSpareServers    5
        !           103: MaxSpareServers   20
        !           104: ServerLimit      150
        !           105: MaxClients       150
        !           106: MaxRequestsPerChild  1000
        !           107: </IfModule>
        !           108: 
        !           109: # worker MPM
        !           110: # StartServers: initial number of server processes to start
        !           111: # MaxClients: maximum number of simultaneous client connections
        !           112: # MinSpareThreads: minimum number of worker threads which are kept spare
        !           113: # MaxSpareThreads: maximum number of worker threads which are kept spare
        !           114: # ThreadsPerChild: constant number of worker threads in each server process
        !           115: # MaxRequestsPerChild: maximum number of requests a server process serves
        !           116: <IfModule worker.c>
        !           117: StartServers         2
        !           118: MaxClients         150
        !           119: MinSpareThreads     25
        !           120: MaxSpareThreads     75 
        !           121: ThreadsPerChild     25
        !           122: MaxRequestsPerChild  0
        !           123: </IfModule>
        !           124: 
        !           125: #
        !           126: # Listen: Allows you to bind Apache to specific IP addresses and/or
        !           127: # ports, in addition to the default. See also the <VirtualHost>
        !           128: # directive.
        !           129: #
        !           130: # Change this to Listen on specific IP addresses as shown below to 
        !           131: # prevent Apache from glomming onto all bound IP addresses (0.0.0.0)
        !           132: #
        !           133: #Listen 12.34.56.78:80
        !           134: Listen 80
        !           135: 
        !           136: #
        !           137: # Dynamic Shared Object (DSO) Support
        !           138: #
        !           139: # To be able to use the functionality of a module which was built as a DSO you
        !           140: # have to place corresponding `LoadModule' lines at this location so the
        !           141: # directives contained in it are actually available _before_ they are used.
        !           142: # Statically compiled modules (those listed by `httpd -l') do not need
        !           143: # to be loaded here.
        !           144: #
        !           145: # Example:
        !           146: # LoadModule foo_module modules/mod_foo.so
        !           147: #
        !           148: <IfDefine HAVE_BANDWIDTH>
        !           149: #LoadModule bandwidth_module   modules/mod_bandwidth.so
        !           150: </IfDefine>
        !           151: <IfDefine HAVE_THROTTLE>
        !           152: #LoadModule throttle_module    modules/mod_throttle.so
        !           153: </IfDefine>
        !           154: LoadModule auth_basic_module modules/mod_auth_basic.so
        !           155: LoadModule auth_digest_module modules/mod_auth_digest.so
        !           156: LoadModule authn_file_module modules/mod_authn_file.so
        !           157: LoadModule authn_alias_module modules/mod_authn_alias.so
        !           158: LoadModule authn_anon_module modules/mod_authn_anon.so
        !           159: LoadModule authn_dbm_module modules/mod_authn_dbm.so
        !           160: LoadModule authn_default_module modules/mod_authn_default.so
        !           161: LoadModule authz_host_module modules/mod_authz_host.so
        !           162: LoadModule authz_user_module modules/mod_authz_user.so
        !           163: LoadModule authz_owner_module modules/mod_authz_owner.so
        !           164: LoadModule authz_groupfile_module modules/mod_authz_groupfile.so
        !           165: #LoadModule authz_dbm_module modules/mod_authz_dbm.so
        !           166: LoadModule authz_default_module modules/mod_authz_default.so
        !           167: LoadModule ldap_module modules/mod_ldap.so
        !           168: LoadModule authnz_ldap_module modules/mod_authnz_ldap.so
        !           169: LoadModule include_module modules/mod_include.so
        !           170: LoadModule log_config_module modules/mod_log_config.so
        !           171: LoadModule logio_module modules/mod_logio.so
        !           172: LoadModule env_module modules/mod_env.so
        !           173: LoadModule ext_filter_module modules/mod_ext_filter.so
        !           174: #LoadModule mime_magic_module modules/mod_mime_magic.so
        !           175: LoadModule expires_module modules/mod_expires.so
        !           176: LoadModule deflate_module modules/mod_deflate.so
        !           177: LoadModule headers_module modules/mod_headers.so
        !           178: #LoadModule usertrack_module modules/mod_usertrack.so
        !           179: LoadModule setenvif_module modules/mod_setenvif.so
        !           180: LoadModule mime_module modules/mod_mime.so
        !           181: LoadModule dav_module modules/mod_dav.so
        !           182: LoadModule status_module modules/mod_status.so
        !           183: LoadModule autoindex_module modules/mod_autoindex.so
        !           184: LoadModule info_module modules/mod_info.so
        !           185: LoadModule dav_fs_module modules/mod_dav_fs.so
        !           186: LoadModule vhost_alias_module modules/mod_vhost_alias.so
        !           187: LoadModule negotiation_module modules/mod_negotiation.so
        !           188: LoadModule dir_module modules/mod_dir.so
        !           189: LoadModule actions_module modules/mod_actions.so
        !           190: #LoadModule speling_module modules/mod_speling.so
        !           191: LoadModule userdir_module modules/mod_userdir.so
        !           192: LoadModule alias_module modules/mod_alias.so
        !           193: #LoadModule substitute_module modules/mod_substitute.so
        !           194: LoadModule rewrite_module modules/mod_rewrite.so
        !           195: LoadModule proxy_module modules/mod_proxy.so
        !           196: LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
        !           197: LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
        !           198: LoadModule proxy_http_module modules/mod_proxy_http.so
        !           199: LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
        !           200: LoadModule proxy_connect_module modules/mod_proxy_connect.so
        !           201: LoadModule cache_module modules/mod_cache.so
        !           202: LoadModule suexec_module modules/mod_suexec.so
        !           203: LoadModule disk_cache_module modules/mod_disk_cache.so
        !           204: LoadModule cgi_module modules/mod_cgi.so
        !           205: #LoadModule version_module modules/mod_version.so
        !           206: 
        !           207: #
        !           208: # The following modules are not loaded by default:
        !           209: #
        !           210: #LoadModule asis_module modules/mod_asis.so
        !           211: #LoadModule authn_dbd_module modules/mod_authn_dbd.so
        !           212: #LoadModule cern_meta_module modules/mod_cern_meta.so
        !           213: #LoadModule cgid_module modules/mod_cgid.so
        !           214: #LoadModule dbd_module modules/mod_dbd.so
        !           215: #LoadModule dumpio_module modules/mod_dumpio.so
        !           216: #LoadModule filter_module modules/mod_filter.so
        !           217: #LoadModule ident_module modules/mod_ident.so
        !           218: #LoadModule log_forensic_module modules/mod_log_forensic.so
        !           219: #LoadModule unique_id_module modules/mod_unique_id.so
        !           220: #
        !           221: 
        !           222: #
        !           223: # Load config files from the config directory "/etc/httpd/conf.d".
        !           224: #
        !           225: Include conf.d/*.conf
        !           226: 
        !           227: #
        !           228: # ExtendedStatus controls whether Apache will generate "full" status
        !           229: # information (ExtendedStatus On) or just basic information (ExtendedStatus
        !           230: # Off) when the "server-status" handler is called. The default is Off.
        !           231: #
        !           232: #ExtendedStatus On
        !           233: 
        !           234: #
        !           235: # If you wish httpd to run as a different user or group, you must run
        !           236: # httpd as root initially and it will switch.  
        !           237: #
        !           238: # User/Group: The name (or #number) of the user/group to run httpd as.
        !           239: #  . On SCO (ODT 3) use "User nouser" and "Group nogroup".
        !           240: #  . On HPUX you may not be able to use shared memory as nobody, and the
        !           241: #    suggested workaround is to create a user www and use that user.
        !           242: #  NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)
        !           243: #  when the value of (unsigned)Group is above 60000; 
        !           244: #  don't use Group #-1 on these systems!
        !           245: #
        !           246: User www
        !           247: Group www 
        !           248: 
        !           249: ### Section 2: 'Main' server configuration
        !           250: #
        !           251: # The directives in this section set up the values used by the 'main'
        !           252: # server, which responds to any requests that aren't handled by a
        !           253: # <VirtualHost> definition.  These values also provide defaults for
        !           254: # any <VirtualHost> containers you may define later in the file.
        !           255: #
        !           256: # All of these directives may appear inside <VirtualHost> containers,
        !           257: # in which case these default settings will be overridden for the
        !           258: # virtual host being defined.
        !           259: #
        !           260: 
        !           261: #
        !           262: # ServerAdmin: Your address, where problems with the server should be
        !           263: # e-mailed.  This address appears on some server-generated pages, such
        !           264: # as error documents.  e.g. admin@your-domain.com
        !           265: #
        !           266: ServerAdmin root@localhost
        !           267: 
        !           268: #
        !           269: # ServerName gives the name and port that the server uses to identify itself.
        !           270: # This can often be determined automatically, but we recommend you specify
        !           271: # it explicitly to prevent problems during startup.
        !           272: #
        !           273: # If this is not set to valid DNS name for your host, server-generated
        !           274: # redirections will not work.  See also the UseCanonicalName directive.
        !           275: #
        !           276: # If your host doesn't have a registered DNS name, enter its IP address here.
        !           277: # You will have to access it by its address anyway, and this will make 
        !           278: # redirections work in a sensible way.
        !           279: #
        !           280: #ServerName www.example.com:80
        !           281: 
        !           282: #
        !           283: # UseCanonicalName: Determines how Apache constructs self-referencing 
        !           284: # URLs and the SERVER_NAME and SERVER_PORT variables.
        !           285: # When set "Off", Apache will use the Hostname and Port supplied
        !           286: # by the client.  When set "On", Apache will use the value of the
        !           287: # ServerName directive.
        !           288: #
        !           289: UseCanonicalName Off
        !           290: 
        !           291: #
        !           292: # DocumentRoot: The directory out of which you will serve your
        !           293: # documents. By default, all requests are taken from this directory, but
        !           294: # symbolic links and aliases may be used to point to other locations.
        !           295: #
        !           296: #DocumentRoot "/home/httpd/html"
        !           297: 
        !           298: #
        !           299: # Each directory to which Apache has access can be configured with respect
        !           300: # to which services and features are allowed and/or disabled in that
        !           301: # directory (and its subdirectories). 
        !           302: #
        !           303: # First, we configure the "default" to be a very restrictive set of 
        !           304: # features.  
        !           305: #
        !           306: #<Directory />
        !           307: #    Options FollowSymLinks
        !           308: #    AllowOverride None
        !           309: #</Directory>
        !           310: 
        !           311: #
        !           312: # Note that from this point forward you must specifically allow
        !           313: # particular features to be enabled - so if something's not working as
        !           314: # you might expect, make sure that you have specifically enabled it
        !           315: # below.
        !           316: #
        !           317: 
        !           318: #
        !           319: # This should be changed to whatever you set DocumentRoot to.
        !           320: #
        !           321: #<Directory "/home/httpd/html">
        !           322: 
        !           323: #
        !           324: # Possible values for the Options directive are "None", "All",
        !           325: # or any combination of:
        !           326: #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
        !           327: #
        !           328: # Note that "MultiViews" must be named *explicitly* --- "Options All"
        !           329: # doesn't give it to you.
        !           330: #
        !           331: # The Options directive is both complicated and important.  Please see
        !           332: # http://httpd.apache.org/docs/2.2/mod/core.html#options
        !           333: # for more information.
        !           334: #
        !           335: #    Options Indexes FollowSymLinks
        !           336: 
        !           337: #
        !           338: # AllowOverride controls what directives may be placed in .htaccess files.
        !           339: # It can be "All", "None", or any combination of the keywords:
        !           340: #   Options FileInfo AuthConfig Limit
        !           341: #
        !           342: #    AllowOverride None
        !           343: 
        !           344: #
        !           345: # Controls who can get stuff from this server.
        !           346: #
        !           347: #    Order allow,deny
        !           348: #    Allow from all
        !           349: 
        !           350: #</Directory>
        !           351: 
        !           352: #
        !           353: # UserDir: The name of the directory that is appended onto a user's home
        !           354: # directory if a ~user request is received.
        !           355: #
        !           356: # The path to the end user account 'public_html' directory must be
        !           357: # accessible to the webserver userid.  This usually means that ~userid
        !           358: # must have permissions of 711, ~userid/public_html must have permissions
        !           359: # of 755, and documents contained therein must be world-readable.
        !           360: # Otherwise, the client will only receive a "403 Forbidden" message.
        !           361: #
        !           362: # See also: http://httpd.apache.org/docs/misc/FAQ.html#forbidden
        !           363: #
        !           364: <IfModule mod_userdir.c>
        !           365:     #
        !           366:     # UserDir is disabled by default since it can confirm the presence
        !           367:     # of a username on the system (depending on home directory
        !           368:     # permissions).
        !           369:     #
        !           370:     UserDir disable
        !           371: 
        !           372:     #
        !           373:     # To enable requests to /~user/ to serve the user's public_html
        !           374:     # directory, remove the "UserDir disable" line above, and uncomment
        !           375:     # the following line instead:
        !           376:     # 
        !           377:     #UserDir public_html
        !           378: 
        !           379: </IfModule>
        !           380: 
        !           381: #
        !           382: # Control access to UserDir directories.  The following is an example
        !           383: # for a site where these directories are restricted to read-only.
        !           384: #
        !           385: #<Directory /home/*/public_html>
        !           386: #    AllowOverride FileInfo AuthConfig Limit
        !           387: #    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
        !           388: #    <Limit GET POST OPTIONS>
        !           389: #        Order allow,deny
        !           390: #        Allow from all
        !           391: #    </Limit>
        !           392: #    <LimitExcept GET POST OPTIONS>
        !           393: #        Order deny,allow
        !           394: #        Deny from all
        !           395: #    </LimitExcept>
        !           396: #</Directory>
        !           397: 
        !           398: #
        !           399: # DirectoryIndex: sets the file that Apache will serve if a directory
        !           400: # is requested.
        !           401: #
        !           402: # The index.html.var file (a type-map) is used to deliver content-
        !           403: # negotiated documents.  The MultiViews Option can be used for the 
        !           404: # same purpose, but it is much slower.
        !           405: #
        !           406: DirectoryIndex index.html index.html.var
        !           407: 
        !           408: #
        !           409: # AccessFileName: The name of the file to look for in each directory
        !           410: # for additional configuration directives.  See also the AllowOverride
        !           411: # directive.
        !           412: #
        !           413: AccessFileName .htaccess
        !           414: 
        !           415: #
        !           416: # The following lines prevent .htaccess and .htpasswd files from being 
        !           417: # viewed by Web clients. 
        !           418: #
        !           419: <Files ~ "^\.ht">
        !           420:     Order allow,deny
        !           421:     Deny from all
        !           422: </Files>
        !           423: 
        !           424: #
        !           425: # TypesConfig describes where the mime.types file (or equivalent) is
        !           426: # to be found.
        !           427: #
        !           428: TypesConfig /etc/mime.types
        !           429: 
        !           430: #
        !           431: # DefaultType is the default MIME type the server will use for a document
        !           432: # if it cannot otherwise determine one, such as from filename extensions.
        !           433: # If your server contains mostly text or HTML documents, "text/plain" is
        !           434: # a good value.  If most of your content is binary, such as applications
        !           435: # or images, you may want to use "application/octet-stream" instead to
        !           436: # keep browsers from trying to display binary files as though they are
        !           437: # text.
        !           438: #
        !           439: DefaultType text/plain
        !           440: 
        !           441: #
        !           442: # The mod_mime_magic module allows the server to use various hints from the
        !           443: # contents of the file itself to determine its type.  The MIMEMagicFile
        !           444: # directive tells the module where the hint definitions are located.
        !           445: #
        !           446: <IfModule mod_mime_magic.c>
        !           447: #   MIMEMagicFile /usr/share/magic.mime
        !           448:     MIMEMagicFile conf/magic
        !           449: </IfModule>
        !           450: 
        !           451: #
        !           452: # HostnameLookups: Log the names of clients or just their IP addresses
        !           453: # e.g., www.apache.org (on) or 204.62.129.132 (off).
        !           454: # The default is off because it'd be overall better for the net if people
        !           455: # had to knowingly turn this feature on, since enabling it means that
        !           456: # each client request will result in AT LEAST one lookup request to the
        !           457: # nameserver.
        !           458: #
        !           459: HostnameLookups Off
        !           460: 
        !           461: #
        !           462: # EnableMMAP: Control whether memory-mapping is used to deliver
        !           463: # files (assuming that the underlying OS supports it).
        !           464: # The default is on; turn this off if you serve from NFS-mounted 
        !           465: # filesystems.  On some systems, turning it off (regardless of
        !           466: # filesystem) can improve performance; for details, please see
        !           467: # http://httpd.apache.org/docs/2.2/mod/core.html#enablemmap
        !           468: #
        !           469: #EnableMMAP off
        !           470: 
        !           471: #
        !           472: # EnableSendfile: Control whether the sendfile kernel support is 
        !           473: # used to deliver files (assuming that the OS supports it). 
        !           474: # The default is on; turn this off if you serve from NFS-mounted 
        !           475: # filesystems.  Please see
        !           476: # http://httpd.apache.org/docs/2.2/mod/core.html#enablesendfile
        !           477: #
        !           478: #EnableSendfile off
        !           479: 
        !           480: #
        !           481: # ErrorLog: The location of the error log file.
        !           482: # If you do not specify an ErrorLog directive within a <VirtualHost>
        !           483: # container, error messages relating to that virtual host will be
        !           484: # logged here.  If you *do* define an error logfile for a <VirtualHost>
        !           485: # container, that host's errors will be logged there and not here.
        !           486: #
        !           487: ErrorLog logs/error_log
        !           488: 
        !           489: #
        !           490: # LogLevel: Control the number of messages logged to the error_log.
        !           491: # Possible values include: debug, info, notice, warn, error, crit,
        !           492: # alert, emerg.
        !           493: #
        !           494: LogLevel warn
        !           495: 
        !           496: #
        !           497: # The following directives define some format nicknames for use with
        !           498: # a CustomLog directive (see below).
        !           499: #
        !           500: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
        !           501: LogFormat "%h %l %u %t \"%r\" %>s %b" common
        !           502: LogFormat "%{Referer}i -> %U" referer
        !           503: LogFormat "%{User-agent}i" agent
        !           504: 
        !           505: # "combinedio" includes actual counts of actual bytes received (%I) and sent (%O); this
        !           506: # requires the mod_logio module to be loaded.
        !           507: #LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
        !           508: 
        !           509: #
        !           510: # The location and format of the access logfile (Common Logfile Format).
        !           511: # If you do not define any access logfiles within a <VirtualHost>
        !           512: # container, they will be logged here.  Contrariwise, if you *do*
        !           513: # define per-<VirtualHost> access logfiles, transactions will be
        !           514: # logged therein and *not* in this file.
        !           515: #
        !           516: #CustomLog logs/access_log common
        !           517: 
        !           518: #
        !           519: # If you would like to have separate agent and referer logfiles, uncomment
        !           520: # the following directives.
        !           521: #
        !           522: #CustomLog logs/referer_log referer
        !           523: #CustomLog logs/agent_log agent
        !           524: 
        !           525: #
        !           526: # For a single logfile with access, agent, and referer information
        !           527: # (Combined Logfile Format), use the following directive:
        !           528: #
        !           529: CustomLog logs/access_log combined
        !           530: 
        !           531: #
        !           532: # Optionally add a line containing the server version and virtual host
        !           533: # name to server-generated pages (internal error documents, FTP directory
        !           534: # listings, mod_status and mod_info output etc., but not CGI generated
        !           535: # documents or custom error documents).
        !           536: # Set to "EMail" to also include a mailto: link to the ServerAdmin.
        !           537: # Set to one of:  On | Off | EMail
        !           538: #
        !           539: ServerSignature On
        !           540: 
        !           541: #
        !           542: # Aliases: Add here as many aliases as you need (with no limit). The format is 
        !           543: # Alias fakename realname
        !           544: #
        !           545: # Note that if you include a trailing / on fakename then the server will
        !           546: # require it to be present in the URL.  So "/icons" isn't aliased in this
        !           547: # example, only "/icons/".  If the fakename is slash-terminated, then the 
        !           548: # realname must also be slash terminated, and if the fakename omits the 
        !           549: # trailing slash, the realname must also omit it.
        !           550: #
        !           551: # We include the /icons/ alias for FancyIndexed directory listings.  If you
        !           552: # do not use FancyIndexing, you may comment this out.
        !           553: #
        !           554: Alias /icons/ "/var/www/icons/"
        !           555: 
        !           556: <Directory "/var/www/icons">
        !           557:     Options Indexes MultiViews
        !           558:     AllowOverride None
        !           559:     Order allow,deny
        !           560:     Allow from all
        !           561: </Directory>
        !           562: 
        !           563: #
        !           564: # WebDAV module configuration section.
        !           565: # 
        !           566: <IfModule mod_dav_fs.c>
        !           567:     # Location of the WebDAV lock database.
        !           568:     DAVLockDB /var/lib/dav/lockdb
        !           569: </IfModule>
        !           570: 
        !           571: #
        !           572: # ScriptAlias: This controls which directories contain server scripts.
        !           573: # ScriptAliases are essentially the same as Aliases, except that
        !           574: # documents in the realname directory are treated as applications and
        !           575: # run by the server when requested rather than as documents sent to the client.
        !           576: # The same rules about trailing "/" apply to ScriptAlias directives as to
        !           577: # Alias.
        !           578: #
        !           579: #ScriptAlias /cgi-bin/ "/home/httpd/cgi-bin/"
        !           580: 
        !           581: #
        !           582: # "/var/www/cgi-bin" should be changed to whatever your ScriptAliased
        !           583: # CGI directory exists, if you have that configured.
        !           584: #
        !           585: #<Directory "/home/httpd/cgi-bin">
        !           586: #    AllowOverride None
        !           587: #    Options None
        !           588: #    Order allow,deny
        !           589: #    Allow from all
        !           590: #</Directory>
        !           591: 
        !           592: #
        !           593: # Redirect allows you to tell clients about documents which used to exist in
        !           594: # your server's namespace, but do not anymore. This allows you to tell the
        !           595: # clients where to look for the relocated document.
        !           596: # Example:
        !           597: # Redirect permanent /foo http://www.example.com/bar
        !           598: 
        !           599: #
        !           600: # Directives controlling the display of server-generated directory listings.
        !           601: #
        !           602: 
        !           603: #
        !           604: # IndexOptions: Controls the appearance of server-generated directory
        !           605: # listings.
        !           606: #
        !           607: IndexOptions FancyIndexing VersionSort NameWidth=* HTMLTable
        !           608: 
        !           609: #
        !           610: # AddIcon* directives tell the server which icon to show for different
        !           611: # files or filename extensions.  These are only displayed for
        !           612: # FancyIndexed directories.
        !           613: #
        !           614: AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
        !           615: 
        !           616: AddIconByType (TXT,/icons/text.gif) text/*
        !           617: AddIconByType (IMG,/icons/image2.gif) image/*
        !           618: AddIconByType (SND,/icons/sound2.gif) audio/*
        !           619: AddIconByType (VID,/icons/movie.gif) video/*
        !           620: 
        !           621: AddIcon /icons/binary.gif .bin .exe
        !           622: AddIcon /icons/binhex.gif .hqx
        !           623: AddIcon /icons/tar.gif .tar
        !           624: AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
        !           625: AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
        !           626: AddIcon /icons/a.gif .ps .ai .eps
        !           627: AddIcon /icons/layout.gif .html .shtml .htm .pdf
        !           628: AddIcon /icons/text.gif .txt
        !           629: AddIcon /icons/c.gif .c
        !           630: AddIcon /icons/p.gif .pl .py
        !           631: AddIcon /icons/f.gif .for
        !           632: AddIcon /icons/dvi.gif .dvi
        !           633: AddIcon /icons/uuencoded.gif .uu
        !           634: AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
        !           635: AddIcon /icons/tex.gif .tex
        !           636: AddIcon /icons/bomb.gif core
        !           637: 
        !           638: AddIcon /icons/back.gif ..
        !           639: AddIcon /icons/hand.right.gif README
        !           640: AddIcon /icons/folder.gif ^^DIRECTORY^^
        !           641: AddIcon /icons/blank.gif ^^BLANKICON^^
        !           642: 
        !           643: #
        !           644: # DefaultIcon is which icon to show for files which do not have an icon
        !           645: # explicitly set.
        !           646: #
        !           647: DefaultIcon /icons/unknown.gif
        !           648: 
        !           649: #
        !           650: # AddDescription allows you to place a short description after a file in
        !           651: # server-generated indexes.  These are only displayed for FancyIndexed
        !           652: # directories.
        !           653: # Format: AddDescription "description" filename
        !           654: #
        !           655: #AddDescription "GZIP compressed document" .gz
        !           656: #AddDescription "tar archive" .tar
        !           657: #AddDescription "GZIP compressed tar archive" .tgz
        !           658: 
        !           659: #
        !           660: # ReadmeName is the name of the README file the server will look for by
        !           661: # default, and append to directory listings.
        !           662: #
        !           663: # HeaderName is the name of a file which should be prepended to
        !           664: # directory indexes. 
        !           665: ReadmeName README.html
        !           666: HeaderName HEADER.html
        !           667: 
        !           668: #
        !           669: # IndexIgnore is a set of filenames which directory indexing should ignore
        !           670: # and not include in the listing.  Shell-style wildcarding is permitted.
        !           671: #
        !           672: IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
        !           673: 
        !           674: #
        !           675: # DefaultLanguage and AddLanguage allows you to specify the language of 
        !           676: # a document. You can then use content negotiation to give a browser a 
        !           677: # file in a language the user can understand.
        !           678: #
        !           679: # Specify a default language. This means that all data
        !           680: # going out without a specific language tag (see below) will 
        !           681: # be marked with this one. You probably do NOT want to set
        !           682: # this unless you are sure it is correct for all cases.
        !           683: #
        !           684: # * It is generally better to not mark a page as 
        !           685: # * being a certain language than marking it with the wrong
        !           686: # * language!
        !           687: #
        !           688: # DefaultLanguage nl
        !           689: #
        !           690: # Note 1: The suffix does not have to be the same as the language
        !           691: # keyword --- those with documents in Polish (whose net-standard
        !           692: # language code is pl) may wish to use "AddLanguage pl .po" to
        !           693: # avoid the ambiguity with the common suffix for perl scripts.
        !           694: #
        !           695: # Note 2: The example entries below illustrate that in some cases 
        !           696: # the two character 'Language' abbreviation is not identical to 
        !           697: # the two character 'Country' code for its country,
        !           698: # E.g. 'Danmark/dk' versus 'Danish/da'.
        !           699: #
        !           700: # Note 3: In the case of 'ltz' we violate the RFC by using a three char
        !           701: # specifier. There is 'work in progress' to fix this and get
        !           702: # the reference data for rfc1766 cleaned up.
        !           703: #
        !           704: # Catalan (ca) - Croatian (hr) - Czech (cs) - Danish (da) - Dutch (nl)
        !           705: # English (en) - Esperanto (eo) - Estonian (et) - French (fr) - German (de)
        !           706: # Greek-Modern (el) - Hebrew (he) - Italian (it) - Japanese (ja)
        !           707: # Korean (ko) - Luxembourgeois* (ltz) - Norwegian Nynorsk (nn)
        !           708: # Norwegian (no) - Polish (pl) - Portugese (pt)
        !           709: # Brazilian Portuguese (pt-BR) - Russian (ru) - Swedish (sv)
        !           710: # Simplified Chinese (zh-CN) - Spanish (es) - Traditional Chinese (zh-TW)
        !           711: #
        !           712: AddLanguage ca .ca
        !           713: AddLanguage cs .cz .cs
        !           714: AddLanguage da .dk
        !           715: AddLanguage de .de
        !           716: AddLanguage el .el
        !           717: AddLanguage en .en
        !           718: AddLanguage eo .eo
        !           719: AddLanguage es .es
        !           720: AddLanguage et .et
        !           721: AddLanguage fr .fr
        !           722: AddLanguage he .he
        !           723: AddLanguage hr .hr
        !           724: AddLanguage it .it
        !           725: AddLanguage ja .ja
        !           726: AddLanguage ko .ko
        !           727: AddLanguage ltz .ltz
        !           728: AddLanguage nl .nl
        !           729: AddLanguage nn .nn
        !           730: AddLanguage no .no
        !           731: AddLanguage pl .po
        !           732: AddLanguage pt .pt
        !           733: AddLanguage pt-BR .pt-br
        !           734: AddLanguage ru .ru
        !           735: AddLanguage sv .sv
        !           736: AddLanguage zh-CN .zh-cn
        !           737: AddLanguage zh-TW .zh-tw
        !           738: 
        !           739: #
        !           740: # LanguagePriority allows you to give precedence to some languages
        !           741: # in case of a tie during content negotiation.
        !           742: #
        !           743: # Just list the languages in decreasing order of preference. We have
        !           744: # more or less alphabetized them here. You probably want to change this.
        !           745: #
        !           746: LanguagePriority en ca cs da de el eo es et fr he hr it ja ko ltz nl nn no pl pt pt-BR ru sv zh-CN zh-TW
        !           747: 
        !           748: #
        !           749: # ForceLanguagePriority allows you to serve a result page rather than
        !           750: # MULTIPLE CHOICES (Prefer) [in case of a tie] or NOT ACCEPTABLE (Fallback)
        !           751: # [in case no accepted languages matched the available variants]
        !           752: #
        !           753: ForceLanguagePriority Prefer Fallback
        !           754: 
        !           755: #
        !           756: # Specify a default charset for all content served; this enables
        !           757: # interpretation of all content as UTF-8 by default.  To use the 
        !           758: # default browser choice (ISO-8859-1), or to allow the META tags
        !           759: # in HTML content to override this choice, comment out this
        !           760: # directive:
        !           761: #
        !           762: AddDefaultCharset UTF-8
        !           763: 
        !           764: #
        !           765: # AddType allows you to add to or override the MIME configuration
        !           766: # file mime.types for specific file types.
        !           767: #
        !           768: #AddType application/x-tar .tgz
        !           769: 
        !           770: #
        !           771: # AddEncoding allows you to have certain browsers uncompress
        !           772: # information on the fly. Note: Not all browsers support this.
        !           773: # Despite the name similarity, the following Add* directives have nothing
        !           774: # to do with the FancyIndexing customization directives above.
        !           775: #
        !           776: #AddEncoding x-compress .Z
        !           777: #AddEncoding x-gzip .gz .tgz
        !           778: 
        !           779: # If the AddEncoding directives above are commented-out, then you
        !           780: # probably should define those extensions to indicate media types:
        !           781: #
        !           782: AddType application/x-compress .Z
        !           783: AddType application/x-gzip .gz .tgz
        !           784: 
        !           785: #
        !           786: # AddHandler allows you to map certain file extensions to "handlers":
        !           787: # actions unrelated to filetype. These can be either built into the server
        !           788: # or added with the Action directive (see below)
        !           789: #
        !           790: # To use CGI scripts outside of ScriptAliased directories:
        !           791: # (You will also need to add "ExecCGI" to the "Options" directive.)
        !           792: #
        !           793: #AddHandler cgi-script .cgi
        !           794: 
        !           795: #
        !           796: # For files that include their own HTTP headers:
        !           797: #
        !           798: #AddHandler send-as-is asis
        !           799: 
        !           800: #
        !           801: # For type maps (negotiated resources):
        !           802: # (This is enabled by default to allow the Apache "It Worked" page
        !           803: #  to be distributed in multiple languages.)
        !           804: #
        !           805: AddHandler type-map var
        !           806: 
        !           807: #
        !           808: # Filters allow you to process content before it is sent to the client.
        !           809: #
        !           810: # To parse .shtml files for server-side includes (SSI):
        !           811: # (You will also need to add "Includes" to the "Options" directive.)
        !           812: #
        !           813: AddType text/html .shtml
        !           814: AddOutputFilter INCLUDES .shtml
        !           815: 
        !           816: #
        !           817: # Action lets you define media types that will execute a script whenever
        !           818: # a matching file is called. This eliminates the need for repeated URL
        !           819: # pathnames for oft-used CGI file processors.
        !           820: # Format: Action media/type /cgi-script/location
        !           821: # Format: Action handler-name /cgi-script/location
        !           822: #
        !           823: 
        !           824: #
        !           825: # Customizable error responses come in three flavors:
        !           826: # 1) plain text 2) local redirects 3) external redirects
        !           827: #
        !           828: # Some examples:
        !           829: #ErrorDocument 500 "The server made a boo boo."
        !           830: #ErrorDocument 404 /missing.html
        !           831: #ErrorDocument 404 "/cgi-bin/missing_handler.pl"
        !           832: #ErrorDocument 402 http://www.example.com/subscription_info.html
        !           833: #
        !           834: 
        !           835: #
        !           836: # Putting this all together, we can internationalize error responses.
        !           837: #
        !           838: # We use Alias to redirect any /error/HTTP_<error>.html.var response to
        !           839: # our collection of by-error message multi-language collections.  We use 
        !           840: # includes to substitute the appropriate text.
        !           841: #
        !           842: # You can modify the messages' appearance without changing any of the
        !           843: # default HTTP_<error>.html.var files by adding the line:
        !           844: #
        !           845: #   Alias /error/include/ "/your/include/path/"
        !           846: #
        !           847: # which allows you to create your own set of files by starting with the
        !           848: # /var/www/error/include/ files and
        !           849: # copying them to /your/include/path/, even on a per-VirtualHost basis.
        !           850: #
        !           851: 
        !           852: Alias /error/ "/var/www/error/"
        !           853: 
        !           854: <IfModule mod_negotiation.c>
        !           855: <IfModule mod_include.c>
        !           856:     <Directory "/var/www/error">
        !           857:         AllowOverride None
        !           858:         Options IncludesNoExec
        !           859:         AddOutputFilter Includes html
        !           860:         AddHandler type-map var
        !           861:         Order allow,deny
        !           862:         Allow from all
        !           863:         LanguagePriority en es de fr
        !           864:         ForceLanguagePriority Prefer Fallback
        !           865:     </Directory>
        !           866: 
        !           867: #    ErrorDocument 400 /error/HTTP_BAD_REQUEST.html.var
        !           868: #    ErrorDocument 401 /error/HTTP_UNAUTHORIZED.html.var
        !           869: #    ErrorDocument 403 /error/HTTP_FORBIDDEN.html.var
        !           870: #    ErrorDocument 404 /error/HTTP_NOT_FOUND.html.var
        !           871: #    ErrorDocument 405 /error/HTTP_METHOD_NOT_ALLOWED.html.var
        !           872: #    ErrorDocument 408 /error/HTTP_REQUEST_TIME_OUT.html.var
        !           873: #    ErrorDocument 410 /error/HTTP_GONE.html.var
        !           874: #    ErrorDocument 411 /error/HTTP_LENGTH_REQUIRED.html.var
        !           875: #    ErrorDocument 412 /error/HTTP_PRECONDITION_FAILED.html.var
        !           876: #    ErrorDocument 413 /error/HTTP_REQUEST_ENTITY_TOO_LARGE.html.var
        !           877: #    ErrorDocument 414 /error/HTTP_REQUEST_URI_TOO_LARGE.html.var
        !           878: #    ErrorDocument 415 /error/HTTP_UNSUPPORTED_MEDIA_TYPE.html.var
        !           879: #    ErrorDocument 500 /error/HTTP_INTERNAL_SERVER_ERROR.html.var
        !           880: #    ErrorDocument 501 /error/HTTP_NOT_IMPLEMENTED.html.var
        !           881: #    ErrorDocument 502 /error/HTTP_BAD_GATEWAY.html.var
        !           882: #    ErrorDocument 503 /error/HTTP_SERVICE_UNAVAILABLE.html.var
        !           883: #    ErrorDocument 506 /error/HTTP_VARIANT_ALSO_VARIES.html.var
        !           884: 
        !           885: </IfModule>
        !           886: </IfModule>
        !           887: 
        !           888: #
        !           889: # The following directives modify normal HTTP response behavior to
        !           890: # handle known problems with browser implementations.
        !           891: #
        !           892: BrowserMatch "Mozilla/2" nokeepalive
        !           893: BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
        !           894: BrowserMatch "RealPlayer 4\.0" force-response-1.0
        !           895: BrowserMatch "Java/1\.0" force-response-1.0
        !           896: BrowserMatch "JDK/1\.0" force-response-1.0
        !           897: 
        !           898: #
        !           899: # The following directive disables redirects on non-GET requests for
        !           900: # a directory that does not include the trailing slash.  This fixes a 
        !           901: # problem with Microsoft WebFolders which does not appropriately handle 
        !           902: # redirects for folders with DAV methods.
        !           903: # Same deal with Apple's DAV filesystem and Gnome VFS support for DAV.
        !           904: #
        !           905: BrowserMatch "Microsoft Data Access Internet Publishing Provider" redirect-carefully
        !           906: BrowserMatch "MS FrontPage" redirect-carefully
        !           907: BrowserMatch "^WebDrive" redirect-carefully
        !           908: BrowserMatch "^WebDAVFS/1.[0123]" redirect-carefully
        !           909: BrowserMatch "^gnome-vfs/1.0" redirect-carefully
        !           910: BrowserMatch "^XML Spy" redirect-carefully
        !           911: BrowserMatch "^Dreamweaver-WebDAV-SCM1" redirect-carefully
        !           912: 
        !           913: #
        !           914: # Allow server status reports generated by mod_status,
        !           915: # with the URL of http://servername/server-status
        !           916: # Change the ".example.com" to match your domain to enable.
        !           917: #
        !           918: #<Location /server-status>
        !           919: #    SetHandler server-status
        !           920: #    Order deny,allow
        !           921: #    Deny from all
        !           922: #    Allow from .example.com
        !           923: #</Location>
        !           924: 
        !           925: #
        !           926: # Allow remote server configuration reports, with the URL of
        !           927: #  http://servername/server-info (requires that mod_info.c be loaded).
        !           928: # Change the ".example.com" to match your domain to enable.
        !           929: #
        !           930: #<Location /server-info>
        !           931: #    SetHandler server-info
        !           932: #    Order deny,allow
        !           933: #    Deny from all
        !           934: #    Allow from .example.com
        !           935: #</Location>
        !           936: 
        !           937: #
        !           938: # Proxy Server directives. Uncomment the following lines to
        !           939: # enable the proxy server:
        !           940: #
        !           941: #<IfModule mod_proxy.c>
        !           942: #ProxyRequests On
        !           943: #
        !           944: #<Proxy *>
        !           945: #    Order deny,allow
        !           946: #    Deny from all
        !           947: #    Allow from .example.com
        !           948: #</Proxy>
        !           949: 
        !           950: #
        !           951: # Enable/disable the handling of HTTP/1.1 "Via:" headers.
        !           952: # ("Full" adds the server version; "Block" removes all outgoing Via: headers)
        !           953: # Set to one of: Off | On | Full | Block
        !           954: #
        !           955: #ProxyVia On
        !           956: 
        !           957: #
        !           958: # To enable a cache of proxied content, uncomment the following lines.
        !           959: # See http://httpd.apache.org/docs/2.2/mod/mod_cache.html for more details.
        !           960: #
        !           961: #<IfModule mod_disk_cache.c>
        !           962: #   CacheEnable disk /
        !           963: #   CacheRoot "/var/cache/mod_proxy"
        !           964: #</IfModule>
        !           965: #
        !           966: 
        !           967: #</IfModule>
        !           968: # End of proxy directives.
        !           969: 
        !           970: ### Section 3: Virtual Hosts
        !           971: #
        !           972: # VirtualHost: If you want to maintain multiple domains/hostnames on your
        !           973: # machine you can setup VirtualHost containers for them. Most configurations
        !           974: # use only name-based virtual hosts so the server doesn't need to worry about
        !           975: # IP addresses. This is indicated by the asterisks in the directives below.
        !           976: #
        !           977: # Please see the documentation at 
        !           978: # <URL:http://httpd.apache.org/docs/2.2/vhosts/>
        !           979: # for further details before you try to setup virtual hosts.
        !           980: #
        !           981: # You may use the command line option '-S' to verify your virtual host
        !           982: # configuration.
        !           983: 
        !           984: #
        !           985: # Use name-based virtual hosting.
        !           986: #
        !           987: #NameVirtualHost *:80
        !           988: #
        !           989: # NOTE: NameVirtualHost cannot be used without a port specifier 
        !           990: # (e.g. :80) if mod_ssl is being used, due to the nature of the
        !           991: # SSL protocol.
        !           992: #
        !           993: 
        !           994: #
        !           995: # VirtualHost example:
        !           996: # Almost any Apache directive may go into a VirtualHost container.
        !           997: # The first VirtualHost section is used for requests without a known
        !           998: # server name.
        !           999: #
        !          1000: #<VirtualHost *:80>
        !          1001: #    ServerAdmin webmaster@dummy-host.example.com
        !          1002: #    DocumentRoot /www/docs/dummy-host.example.com
        !          1003: #    ServerName dummy-host.example.com
        !          1004: #    ErrorLog logs/dummy-host.example.com-error_log
        !          1005: #    CustomLog logs/dummy-host.example.com-access_log common
        !          1006: #</VirtualHost>
        !          1007: 
        !          1008: Include conf/loncapa_apache.conf
        !          1009: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>