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