Annotation of doc/install/linux/centos-rhes-fedora-sl/httpd.conf, revision 1.2
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: #
1.2 ! raeburn 63: PidFile /var/run/httpd.pid
1.1 raeburn 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
1.2 ! raeburn 202: LoadModule file_cache_module modules/mod_file_cache.so
! 203: LoadModule mem_cache_module modules/mod_mem_cache.so
1.1 raeburn 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>
![[BACK]](/icons/back.gif){kind=icon}
Return to httpd.conf CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / install / linux / centos-rhes-fedora-sl