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