]> granicus.if.org Git - apache/blob - docs/conf/httpd-std.conf
Nasty backwards compatibility breaking 'fix' to get rid of
[apache] / docs / conf / httpd-std.conf
1 #
2 # Based upon the NCSA server configuration files originally by Rob McCool.
3 #
4 # This is the main Apache server configuration file.  It contains the
5 # configuration directives that give the server its instructions.
6 # See <URL:http://www.apache.org/docs/> for detailed information about
7 # the directives.
8 #
9 # Do NOT simply read the instructions in here without understanding
10 # what they do.  They're here only as hints or reminders.  If you are unsure
11 # consult the online docs. You have been warned.  
12 #
13 # After this file is processed, the server will look for and process
14 # @@ServerRoot@@/conf/srm.conf and then @@ServerRoot@@/conf/access.conf
15 # unless you have overridden these with ResourceConfig and/or
16 # AccessConfig directives here.
17 #
18 # The configuration directives are grouped into three basic sections:
19 #  1. Directives that control the operation of the Apache server process as a
20 #     whole (the 'global environment').
21 #  2. Directives that define the parameters of the 'main' or 'default' server,
22 #     which responds to requests that aren't handled by a virtual host.
23 #     These directives also provide default values for the settings
24 #     of all virtual hosts.
25 #  3. Settings for virtual hosts, which allow Web requests to be sent to
26 #     different IP addresses or hostnames and have them handled by the
27 #     same Apache server process.
28 #
29 # Configuration and logfile names: If the filenames you specify for many
30 # of the server's control files begin with "/" (or "drive:/" for Win32), the
31 # server will use that explicit path.  If the filenames do *not* begin
32 # with "/", the value of ServerRoot is prepended -- so "logs/foo.log"
33 # with ServerRoot set to "/usr/local/apache" will be interpreted by the
34 # server as "/usr/local/apache/logs/foo.log".
35 #
36
37 ### Section 1: Global Environment
38 #
39 # The directives in this section affect the overall operation of Apache,
40 # such as the number of concurrent requests it can handle or where it
41 # can find its configuration files.
42 #
43
44 #
45 # ServerType is either inetd, or standalone.  Inetd mode is only supported on
46 # Unix platforms.
47 #
48 #ServerType standalone
49
50 #
51 # ServerRoot: The top of the directory tree under which the server's
52 # configuration, error, and log files are kept.
53 #
54 # NOTE!  If you intend to place this on an NFS (or otherwise network)
55 # mounted filesystem then please read the LockFile documentation
56 # (available at <URL:http://www.apache.org/docs/mod/core.html#lockfile>);
57 # you will save yourself a lot of trouble.
58 #
59 # Do NOT add a slash at the end of the directory path.
60 #
61 ServerRoot "@@ServerRoot@@"
62
63 #
64 # The LockFile directive sets the path to the lockfile used when Apache
65 # is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
66 # USE_FLOCK_SERIALIZED_ACCEPT. This directive should normally be left at
67 # its default value. The main reason for changing it is if the logs
68 # directory is NFS mounted, since the lockfile MUST BE STORED ON A LOCAL
69 # DISK. The PID of the main server process is automatically appended to
70 # the filename. 
71 #
72 #LockFile logs/accept.lock
73
74 #
75 # PidFile: The file in which the server should record its process
76 # identification number when it starts.
77 #
78 PidFile logs/httpd.pid
79
80 #
81 # ScoreBoardFile: File used to store internal server process information.
82 # Not all architectures require this.  But if yours does (you'll know because
83 # this file will be  created when you run Apache) then you *must* ensure that
84 # no two invocations of Apache share the same scoreboard file.
85 #
86 <IfModule !dexter.c>
87 ScoreBoardFile logs/apache_runtime_status
88 </IfModule>
89
90 #
91 # In the standard configuration, the server will process this file,
92 # srm.conf, and access.conf in that order.  The latter two files are
93 # now distributed empty, as it is recommended that all directives
94 # be kept in a single file for simplicity.  The commented-out values
95 # below are the built-in defaults.  You can have the server ignore
96 # these files altogether by using "/dev/null" (for Unix) or
97 # "nul" (for Win32) for the arguments to the directives.
98 #
99 #ResourceConfig conf/srm.conf
100 #AccessConfig conf/access.conf
101
102 #
103 # Timeout: The number of seconds before receives and sends time out.
104 #
105 Timeout 300
106
107 #
108 # KeepAlive: Whether or not to allow persistent connections (more than
109 # one request per connection). Set to "Off" to deactivate.
110 #
111 KeepAlive On
112
113 #
114 # MaxKeepAliveRequests: The maximum number of requests to allow
115 # during a persistent connection. Set to 0 to allow an unlimited amount.
116 # We recommend you leave this number high, for maximum performance.
117 #
118 MaxKeepAliveRequests 100
119
120 #
121 # KeepAliveTimeout: Number of seconds to wait for the next request from the
122 # same client on the same connection.
123 #
124 KeepAliveTimeout 15
125
126 ##
127 ## Server-Pool Size Regulation (MPM specific)
128 ## 
129
130 # prefork MPM
131 # StartServers ......... number of server processes to start
132 # MinSpareServers ...... minimum number of server processes which are kept spare
133 # MaxSpareServers ...... maximum number of server processes which are kept spare
134 # MaxClients ........... maximum number of server processes allowed to start
135 # MaxRequestsPerChild .. maximum number of requests a server process serves
136 <IfModule prefork.c>
137 StartServers         5
138 MinSpareServers      5
139 MaxSpareServers     10
140 MaxClients          20
141 MaxRequestsPerChild  0
142 </IfModule>
143
144 # pthread MPM
145 # StartServers ......... initial  number of server processes to start
146 # MaxClients ........... maximum  number of server processes allowed to start
147 # MinSpareThreads ...... minimum  number of worker threads which are kept spare
148 # MaxSpareThreads ...... maximum  number of worker threads which are kept spare
149 # ThreadsPerChild ...... constant number of worker threads in each server process
150 # MaxRequestsPerChild .. maximum  number of requests a server process serves
151 <IfModule mpmt_pthread.c>
152 StartServers         5
153 MaxClients           8
154 MinSpareThreads      5
155 MaxSpareThreads     10
156 ThreadsPerChild     20
157 MaxRequestsPerChild  0
158 </IfModule>
159
160 # dexter MPM
161 # NumServers ........... constant number of server processes
162 # StartThreads ......... initial  number of worker threads in each server process
163 # MinSpareThreads ...... minimum  number of worker threads which are kept spare
164 # MaxSpareThreads ...... maximum  number of worker threads which are kept spare
165 # MaxThreadsPerChild ... maximum  number of worker threads in each server process
166 # MaxRequestsPerChild .. maximum  number of connections per server process (then it dies)
167 <IfModule dexter.c>
168 NumServers           5
169 StartThreads         5
170 MinSpareThreads      5
171 MaxSpareThreads     10
172 MaxThreadsPerChild  20
173 MaxRequestsPerChild  0
174 </IfModule>
175
176 #
177 # Listen: Allows you to bind Apache to specific IP addresses and/or
178 # ports, in addition to the default. See also the <VirtualHost>
179 # directive.
180 #
181 #Listen 3000
182 #Listen 12.34.56.78:80
183
184 #
185 # BindAddress: You can support virtual hosts with this option. This directive
186 # is used to tell the server which IP address to listen to. It can either
187 # contain "*", an IP address, or a fully qualified Internet domain name.
188 # See also the <VirtualHost> and Listen directives.
189 #
190 #BindAddress *
191
192 #
193 # Dynamic Shared Object (DSO) Support
194 #
195 # To be able to use the functionality of a module which was built as a DSO you
196 # have to place corresponding `LoadModule' lines at this location so the
197 # directives contained in it are actually available _before_ they are used.
198 # Please read the file README.DSO in the Apache 1.3 distribution for more
199 # details about the DSO mechanism and run `httpd -l' for the list of already
200 # built-in (statically linked and thus always available) modules in your httpd
201 # binary.
202 #
203 # Note: The order is which modules are loaded is important.  Don't change
204 # the order below without expert advice.
205 #
206 # Example:
207 # LoadModule foo_module libexec/mod_foo.so
208
209 #
210 # ExtendedStatus controls whether Apache will generate "full" status
211 # information (ExtendedStatus On) or just basic information (ExtendedStatus
212 # Off) when the "server-status" handler is called. The default is Off.
213 #
214 #ExtendedStatus On
215
216 ### Section 2: 'Main' server configuration
217 #
218 # The directives in this section set up the values used by the 'main'
219 # server, which responds to any requests that aren't handled by a
220 # <VirtualHost> definition.  These values also provide defaults for
221 # any <VirtualHost> containers you may define later in the file.
222 #
223 # All of these directives may appear inside <VirtualHost> containers,
224 # in which case these default settings will be overridden for the
225 # virtual host being defined.
226 #
227
228 #
229 # If your ServerType directive (set earlier in the 'Global Environment'
230 # section) is set to "inetd", the next few directives don't have any
231 # effect since their settings are defined by the inetd configuration.
232 # Skip ahead to the ServerAdmin directive.
233 #
234
235 #
236 # Port: The port to which the standalone server listens. For
237 # ports < 1023, you will need httpd to be run as root initially.
238 #
239 Port 80
240
241 #
242 # If you wish httpd to run as a different user or group, you must run
243 # httpd as root initially and it will switch.  
244 #
245 # User/Group: The name (or #number) of the user/group to run httpd as.
246 #  . On SCO (ODT 3) use "User nouser" and "Group nogroup".
247 #  . On HPUX you may not be able to use shared memory as nobody, and the
248 #    suggested workaround is to create a user www and use that user.
249 #  NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)
250 #  when the value of (unsigned)Group is above 60000; 
251 #  don't use Group #-1 on these systems!
252 #
253 User nobody
254 Group #-1
255
256 #
257 # ServerAdmin: Your address, where problems with the server should be
258 # e-mailed.  This address appears on some server-generated pages, such
259 # as error documents.
260 #
261 ServerAdmin you@your.address
262
263 #
264 # ServerName allows you to set a host name which is sent back to clients for
265 # your server if it's different than the one the program would get (i.e., use
266 # "www" instead of the host's real name).
267 #
268 # Note: You cannot just invent host names and hope they work. The name you 
269 # define here must be a valid DNS name for your host. If you don't understand
270 # this, ask your network administrator.
271 # If your host doesn't have a registered DNS name, enter its IP address here.
272 # You will have to access it by its address (e.g., http://123.45.67.89/)
273 # anyway, and this will make redirections work in a sensible way.
274 #
275 #ServerName new.host.name
276
277 #
278 # DocumentRoot: The directory out of which you will serve your
279 # documents. By default, all requests are taken from this directory, but
280 # symbolic links and aliases may be used to point to other locations.
281 #
282 DocumentRoot "@@ServerRoot@@/htdocs"
283
284 #
285 # Each directory to which Apache has access, can be configured with respect
286 # to which services and features are allowed and/or disabled in that
287 # directory (and its subdirectories). 
288 #
289 # First, we configure the "default" to be a very restrictive set of 
290 # permissions.  
291 #
292 <Directory />
293     Options FollowSymLinks
294     AllowOverride None
295 </Directory>
296
297 #
298 # Note that from this point forward you must specifically allow
299 # particular features to be enabled - so if something's not working as
300 # you might expect, make sure that you have specifically enabled it
301 # below.
302 #
303
304 #
305 # This should be changed to whatever you set DocumentRoot to.
306 #
307 <Directory "@@ServerRoot@@/htdocs">
308
309 #
310 # This may also be "None", "All", or any combination of "Indexes",
311 # "Includes", "FollowSymLinks", "ExecCGI", or "MultiViews".
312 #
313 # Note that "MultiViews" must be named *explicitly* --- "Options All"
314 # doesn't give it to you.
315 #
316     Options Indexes FollowSymLinks
317
318 #
319 # This controls which options the .htaccess files in directories can
320 # override. Can also be "All", or any combination of "Options", "FileInfo", 
321 # "AuthConfig", and "Limit"
322 #
323     AllowOverride None
324
325 #
326 # Controls who can get stuff from this server.
327 #
328     Order allow,deny
329     Allow from all
330 </Directory>
331
332 #
333 # UserDir: The name of the directory which is appended onto a user's home
334 # directory if a ~user request is received.
335 #
336 UserDir public_html
337
338 #
339 # Control access to UserDir directories.  The following is an example
340 # for a site where these directories are restricted to read-only.
341 #
342 #<Directory /home/*/public_html>
343 #    AllowOverride FileInfo AuthConfig Limit
344 #    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
345 #    <Limit GET POST OPTIONS PROPFIND>
346 #        Order allow,deny
347 #        Allow from all
348 #    </Limit>
349 #    <Limit PUT DELETE PATCH PROPPATCH MKCOL COPY MOVE LOCK UNLOCK>
350 #        Order deny,allow
351 #        Deny from all
352 #    </Limit>
353 #</Directory>
354
355 #
356 # DirectoryIndex: Name of the file or files to use as a pre-written HTML
357 # directory index.  Separate multiple entries with spaces.
358 #
359 DirectoryIndex index.html
360
361 #
362 # AccessFileName: The name of the file to look for in each directory
363 # for access control information.
364 #
365 AccessFileName .htaccess
366
367 #
368 # The following lines prevent .htaccess files from being viewed by
369 # Web clients.  Since .htaccess files often contain authorization
370 # information, access is disallowed for security reasons.  Comment
371 # these lines out if you want Web visitors to see the contents of
372 # .htaccess files.  If you change the AccessFileName directive above,
373 # be sure to make the corresponding changes here.
374 #
375 # Also, folks tend to use names such as .htpasswd for password
376 # files, so this will protect those as well.
377 #
378 <Files ~ "^\.ht">
379     Order allow,deny
380     Deny from all
381 </Files>
382
383 #
384 # CacheNegotiatedDocs: By default, Apache sends "Pragma: no-cache" with each
385 # document that was negotiated on the basis of content. This asks proxy
386 # servers not to cache the document. Uncommenting the following line disables
387 # this behavior, and proxies will be allowed to cache the documents.
388 #
389 #CacheNegotiatedDocs
390
391 #
392 # UseCanonicalName:  (new for 1.3)  With this setting turned on, whenever
393 # Apache needs to construct a self-referencing URL (a URL that refers back
394 # to the server the response is coming from) it will use ServerName and
395 # Port to form a "canonical" name.  With this setting off, Apache will
396 # use the hostname:port that the client supplied, when possible.  This
397 # also affects SERVER_NAME and SERVER_PORT in CGI scripts.
398 #
399 UseCanonicalName On
400
401 #
402 # TypesConfig describes where the mime.types file (or equivalent) is
403 # to be found.
404 #
405 TypesConfig conf/mime.types
406
407 #
408 # DefaultType is the default MIME type the server will use for a document
409 # if it cannot otherwise determine one, such as from filename extensions.
410 # If your server contains mostly text or HTML documents, "text/plain" is
411 # a good value.  If most of your content is binary, such as applications
412 # or images, you may want to use "application/octet-stream" instead to
413 # keep browsers from trying to display binary files as though they are
414 # text.
415 #
416 DefaultType text/plain
417
418 #
419 # The mod_mime_magic module allows the server to use various hints from the
420 # contents of the file itself to determine its type.  The MIMEMagicFile
421 # directive tells the module where the hint definitions are located.
422 # mod_mime_magic is not part of the default server (you have to add
423 # it yourself with a LoadModule [see the DSO paragraph in the 'Global
424 # Environment' section], or recompile the server and include mod_mime_magic
425 # as part of the configuration), so it's enclosed in an <IfModule> container.
426 # This means that the MIMEMagicFile directive will only be processed if the
427 # module is part of the server.
428 #
429 <IfModule mod_mime_magic.c>
430     MIMEMagicFile conf/magic
431 </IfModule>
432
433 #
434 # HostnameLookups: Log the names of clients or just their IP addresses
435 # e.g., www.apache.org (on) or 204.62.129.132 (off).
436 # The default is off because it'd be overall better for the net if people
437 # had to knowingly turn this feature on, since enabling it means that
438 # each client request will result in AT LEAST one lookup request to the
439 # nameserver.
440 #
441 HostnameLookups Off
442
443 #
444 # ErrorLog: The location of the error log file.
445 # If you do not specify an ErrorLog directive within a <VirtualHost>
446 # container, error messages relating to that virtual host will be
447 # logged here.  If you *do* define an error logfile for a <VirtualHost>
448 # container, that host's errors will be logged there and not here.
449 #
450 ErrorLog logs/error_log
451
452 #
453 # LogLevel: Control the number of messages logged to the error_log.
454 # Possible values include: debug, info, notice, warn, error, crit,
455 # alert, emerg.
456 #
457 LogLevel warn
458
459 #
460 # The following directives define some format nicknames for use with
461 # a CustomLog directive (see below).
462 #
463 LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
464 LogFormat "%h %l %u %t \"%r\" %>s %b" common
465 LogFormat "%{Referer}i -> %U" referer
466 LogFormat "%{User-agent}i" agent
467
468 #
469 # The location and format of the access logfile (Common Logfile Format).
470 # If you do not define any access logfiles within a <VirtualHost>
471 # container, they will be logged here.  Contrariwise, if you *do*
472 # define per-<VirtualHost> access logfiles, transactions will be
473 # logged therein and *not* in this file.
474 #
475 CustomLog logs/access_log common
476
477 #
478 # If you would like to have agent and referer logfiles, uncomment the
479 # following directives.
480 #
481 #CustomLog logs/referer_log referer
482 #CustomLog logs/agent_log agent
483
484 #
485 # If you prefer a single logfile with access, agent, and referer information
486 # (Combined Logfile Format) you can use the following directive.
487 #
488 #CustomLog logs/access_log combined
489
490 #
491 # Optionally add a line containing the server version and virtual host
492 # name to server-generated pages (error documents, FTP directory listings,
493 # mod_status and mod_info output etc., but not CGI generated documents).
494 # Set to "EMail" to also include a mailto: link to the ServerAdmin.
495 # Set to one of:  On | Off | EMail
496 #
497 ServerSignature On
498
499 #
500 # Aliases: Add here as many aliases as you need (with no limit). The format is 
501 # Alias fakename realname
502 #
503 # Note that if you include a trailing / on fakename then the server will
504 # require it to be present in the URL.  So "/icons" isn't aliased in this
505 # example, only "/icons/"..
506 #
507 Alias /icons/ "@@ServerRoot@@/icons/"
508
509 <Directory "@@ServerRoot@@/icons">
510     Options Indexes MultiViews
511     AllowOverride None
512     Order allow,deny
513     Allow from all
514 </Directory>
515
516 #
517 # ScriptAlias: This controls which directories contain server scripts.
518 # ScriptAliases are essentially the same as Aliases, except that
519 # documents in the realname directory are treated as applications and
520 # run by the server when requested rather than as documents sent to the client.
521 # The same rules about trailing "/" apply to ScriptAlias directives as to
522 # Alias.
523 #
524 ScriptAlias /cgi-bin/ "@@ServerRoot@@/cgi-bin/"
525
526 #
527 # "@@ServerRoot@@/cgi-bin" should be changed to whatever your ScriptAliased
528 # CGI directory exists, if you have that configured.
529 #
530 <Directory "@@ServerRoot@@/cgi-bin">
531     AllowOverride None
532     Options None
533     Order allow,deny
534     Allow from all
535 </Directory>
536
537 #
538 # Redirect allows you to tell clients about documents which used to exist in
539 # your server's namespace, but do not anymore. This allows you to tell the
540 # clients where to look for the relocated document.
541 # Format: Redirect old-URI new-URL
542 #
543
544 #
545 # Directives controlling the display of server-generated directory listings.
546 #
547
548 #
549 # FancyIndexing is whether you want fancy directory indexing or standard
550 #
551 IndexOptions FancyIndexing
552
553 #
554 # AddIcon* directives tell the server which icon to show for different
555 # files or filename extensions.  These are only displayed for
556 # FancyIndexed directories.
557 #
558 AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
559
560 AddIconByType (TXT,/icons/text.gif) text/*
561 AddIconByType (IMG,/icons/image2.gif) image/*
562 AddIconByType (SND,/icons/sound2.gif) audio/*
563 AddIconByType (VID,/icons/movie.gif) video/*
564
565 AddIcon /icons/binary.gif .bin .exe
566 AddIcon /icons/binhex.gif .hqx
567 AddIcon /icons/tar.gif .tar
568 AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
569 AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
570 AddIcon /icons/a.gif .ps .ai .eps
571 AddIcon /icons/layout.gif .html .shtml .htm .pdf
572 AddIcon /icons/text.gif .txt
573 AddIcon /icons/c.gif .c
574 AddIcon /icons/p.gif .pl .py
575 AddIcon /icons/f.gif .for
576 AddIcon /icons/dvi.gif .dvi
577 AddIcon /icons/uuencoded.gif .uu
578 AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
579 AddIcon /icons/tex.gif .tex
580 AddIcon /icons/bomb.gif core
581
582 AddIcon /icons/back.gif ..
583 AddIcon /icons/hand.right.gif README
584 AddIcon /icons/folder.gif ^^DIRECTORY^^
585 AddIcon /icons/blank.gif ^^BLANKICON^^
586
587 #
588 # DefaultIcon is which icon to show for files which do not have an icon
589 # explicitly set.
590 #
591 DefaultIcon /icons/unknown.gif
592
593 #
594 # AddDescription allows you to place a short description after a file in
595 # server-generated indexes.  These are only displayed for FancyIndexed
596 # directories.
597 # Format: AddDescription "description" filename
598 #
599 #AddDescription "GZIP compressed document" .gz
600 #AddDescription "tar archive" .tar
601 #AddDescription "GZIP compressed tar archive" .tgz
602
603 #
604 # ReadmeName is the name of the README file the server will look for by
605 # default, and append to directory listings.
606 #
607 # HeaderName is the name of a file which should be prepended to
608 # directory indexes. 
609 #
610 # The server will first look for name.html and include it if found.
611 # If name.html doesn't exist, the server will then look for name.txt
612 # and include it as plaintext if found.
613 #
614 ReadmeName README
615 HeaderName HEADER
616
617 #
618 # IndexIgnore is a set of filenames which directory indexing should ignore
619 # and not include in the listing.  Shell-style wildcarding is permitted.
620 #
621 IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
622
623 #
624 # AddEncoding allows you to have certain browsers (Mosaic/X 2.1+) uncompress
625 # information on the fly. Note: Not all browsers support this.
626 # Despite the name similarity, the following Add* directives have nothing
627 # to do with the FancyIndexing customization directives above.
628 #
629 AddEncoding x-compress Z
630 AddEncoding x-gzip gz tgz
631
632 #
633 # AddLanguage allows you to specify the language of a document. You can
634 # then use content negotiation to give a browser a file in a language
635 # it can understand.  Note that the suffix does not have to be the same
636 # as the language keyword --- those with documents in Polish (whose
637 # net-standard language code is pl) may wish to use "AddLanguage pl .po" 
638 # to avoid the ambiguity with the common suffix for perl scripts.
639 #
640 AddLanguage en .en
641 AddLanguage fr .fr
642 AddLanguage de .de
643 AddLanguage da .da
644 AddLanguage el .el
645 AddLanguage it .it
646
647 #
648 # LanguagePriority allows you to give precedence to some languages
649 # in case of a tie during content negotiation.
650 # Just list the languages in decreasing order of preference.
651 #
652 LanguagePriority en fr de
653
654 #
655 # AddType allows you to tweak mime.types without actually editing it, or to
656 # make certain files to be certain types.
657 #
658 # For example, the PHP3 module (not part of the Apache distribution - see
659 # http://www.php.net) will typically use:
660 #
661 #AddType application/x-httpd-php3 .php3
662 #AddType application/x-httpd-php3-source .phps
663
664 AddType application/x-tar .tgz
665
666 #
667 # AddHandler allows you to map certain file extensions to "handlers",
668 # actions unrelated to filetype. These can be either built into the server
669 # or added with the Action command (see below)
670 #
671 # If you want to use server side includes, or CGI outside
672 # ScriptAliased directories, uncomment the following lines.
673 #
674 # To use CGI scripts:
675 #
676 #AddHandler cgi-script .cgi
677
678 #
679 # To use server-parsed HTML files
680 #
681 #AddType text/html .shtml
682 #AddHandler server-parsed .shtml
683
684 #
685 # Uncomment the following line to enable Apache's send-asis HTTP file
686 # feature
687 #
688 #AddHandler send-as-is asis
689
690 #
691 # If you wish to use server-parsed imagemap files, use
692 #
693 #AddHandler imap-file map
694
695 #
696 # To enable type maps, you might want to use
697 #
698 #AddHandler type-map var
699
700 #
701 # Action lets you define media types that will execute a script whenever
702 # a matching file is called. This eliminates the need for repeated URL
703 # pathnames for oft-used CGI file processors.
704 # Format: Action media/type /cgi-script/location
705 # Format: Action handler-name /cgi-script/location
706 #
707
708 #
709 # MetaDir: specifies the name of the directory in which Apache can find
710 # meta information files. These files contain additional HTTP headers
711 # to include when sending the document
712 #
713 #MetaDir .web
714
715 #
716 # MetaSuffix: specifies the file name suffix for the file containing the
717 # meta information.
718 #
719 #MetaSuffix .meta
720
721 #
722 # Customizable error response (Apache style)
723 #  these come in three flavors
724 #
725 #    1) plain text
726 #ErrorDocument 500 "The server made a boo boo."
727 #
728 #    2) local redirects
729 #ErrorDocument 404 /missing.html
730 #  to redirect to local URL /missing.html
731 #ErrorDocument 404 "/cgi-bin/missing_handlder.pl"
732 #    i.e. any string which starts with a '/' and has
733 #    no spaces. 
734 #  N.B.: You can redirect to a script or a document using server-side-includes.
735 #
736 #    3) external redirects
737 #ErrorDocument 402 http://some.other_server.com/subscription_info.html
738 #    i.e. any string whichis a valid  URL.
739 #  N.B.: Many of the environment variables associated with the original
740 #  request will *not* be available to such a script.
741 #
742 #    4) borderline case
743 #ErrorDocument 402 "http://some.other_server.com/info.html is the place to look"
744 #    treated as case '1' as it has spaces and thus is not a valid URL
745 #
746 # The following directives modify normal HTTP response behavior.
747 # The first directive disables keepalive for Netscape 2.x and browsers that
748 # spoof it. There are known problems with these browser implementations.
749 # The second directive is for Microsoft Internet Explorer 4.0b2
750 # which has a broken HTTP/1.1 implementation and does not properly
751 # support keepalive when it is used on 301 or 302 (redirect) responses.
752 #
753 BrowserMatch "Mozilla/2" nokeepalive
754 BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
755
756 #
757 # The following directive disables HTTP/1.1 responses to browsers which
758 # are in violation of the HTTP/1.0 spec by not being able to grok a
759 # basic 1.1 response.
760 #
761 BrowserMatch "RealPlayer 4\.0" force-response-1.0
762 BrowserMatch "Java/1\.0" force-response-1.0
763 BrowserMatch "JDK/1\.0" force-response-1.0
764
765 #
766 # Allow server status reports, with the URL of http://servername/server-status
767 # Change the ".your_domain.com" to match your domain to enable.
768 #
769 #<Location /server-status>
770 #    SetHandler server-status
771 #    Order deny,allow
772 #    Deny from all
773 #    Allow from .your_domain.com
774 #</Location>
775
776 #
777 # Allow remote server configuration reports, with the URL of
778 #  http://servername/server-info (requires that mod_info.c be loaded).
779 # Change the ".your_domain.com" to match your domain to enable.
780 #
781 #<Location /server-info>
782 #    SetHandler server-info
783 #    Order deny,allow
784 #    Deny from all
785 #    Allow from .your_domain.com
786 #</Location>
787
788 #
789 # There have been reports of people trying to abuse an old bug from pre-1.1
790 # days.  This bug involved a CGI script distributed as a part of Apache.
791 # By uncommenting these lines you can redirect these attacks to a logging 
792 # script on phf.apache.org.  Or, you can record them yourself, using the script
793 # support/phf_abuse_log.cgi.
794 #
795 #<Location /cgi-bin/phf*>
796 #    Deny from all
797 #    ErrorDocument 403 http://phf.apache.org/phf_abuse_log.cgi
798 #</Location>
799
800 #
801 # Proxy Server directives. Uncomment the following lines to
802 # enable the proxy server:
803 #
804 #<IfModule mod_proxy.c>
805 #ProxyRequests On
806 #
807 #<Directory proxy:*>
808 #    Order deny,allow
809 #    Deny from all
810 #    Allow from .your_domain.com
811 #</Directory>
812
813 #
814 # Enable/disable the handling of HTTP/1.1 "Via:" headers.
815 # ("Full" adds the server version; "Block" removes all outgoing Via: headers)
816 # Set to one of: Off | On | Full | Block
817 #
818 #ProxyVia On
819
820 #
821 # To enable the cache as well, edit and uncomment the following lines:
822 # (no cacheing without CacheRoot)
823 #
824 #CacheRoot "@@ServerRoot@@/proxy"
825 #CacheSize 5
826 #CacheGcInterval 4
827 #CacheMaxExpire 24
828 #CacheLastModifiedFactor 0.1
829 #CacheDefaultExpire 1
830 #NoCache a_domain.com another_domain.edu joes.garage_sale.com
831
832 #</IfModule>
833 # End of proxy directives.
834
835 ### Section 3: Virtual Hosts
836 #
837 # VirtualHost: If you want to maintain multiple domains/hostnames on your
838 # machine you can setup VirtualHost containers for them.
839 # Please see the documentation at <URL:http://www.apache.org/docs/vhosts/>
840 # for further details before you try to setup virtual hosts.
841 # You may use the command line option '-S' to verify your virtual host
842 # configuration.
843
844 #
845 # If you want to use name-based virtual hosts you need to define at
846 # least one IP address (and port number) for them.
847 #
848 #NameVirtualHost 12.34.56.78:80
849 #NameVirtualHost 12.34.56.78
850
851 #
852 # VirtualHost example:
853 # Almost any Apache directive may go into a VirtualHost container.
854 #
855 #<VirtualHost ip.address.of.host.some_domain.com>
856 #    ServerAdmin webmaster@host.some_domain.com
857 #    DocumentRoot /www/docs/host.some_domain.com
858 #    ServerName host.some_domain.com
859 #    ErrorLog logs/host.some_domain.com-error_log
860 #    CustomLog logs/host.some_domain.com-access_log common
861 #</VirtualHost>
862
863 #<VirtualHost _default_:*>
864 #</VirtualHost>