~ubuntu-branches/ubuntu/feisty/apache2/feisty

« back to all changes in this revision

Viewing changes to docs/conf/httpd.conf.in

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Barth
  • Date: 2006-12-09 21:05:45 UTC
  • mfrom: (0.6.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209210545-h70s0xaqc2v8vqr2
Tags: 2.2.3-3.2
* Non-maintainer upload.
* 043_ajp_connection_reuse: Patch from upstream Bugzilla, fixing a critical
  issue with regard to connection reuse in mod_proxy_ajp.
  Closes: #396265

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
#
 
2
# This is the main Apache HTTP 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
# 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
# Configuration and logfile names: If the filenames you specify for many
 
14
# of the server's control files begin with "/" (or "drive:/" for Win32), the
 
15
# server will use that explicit path.  If the filenames do *not* begin
 
16
# with "/", the value of ServerRoot is prepended -- so "@rel_logfiledir@/foo.log"
 
17
# with ServerRoot set to "@@ServerRoot@@" will be interpreted by the
 
18
# server as "@@ServerRoot@@/@rel_logfiledir@/foo.log".
 
19
 
 
20
#
 
21
# ServerRoot: The top of the directory tree under which the server's
 
22
# configuration, error, and log files are kept.
 
23
#
 
24
# Do not add a slash at the end of the directory path.  If you point
 
25
# ServerRoot at a non-local disk, be sure to point the LockFile directive
 
26
# at a local disk.  If you wish to share the same ServerRoot for multiple
 
27
# httpd daemons, you will need to change at least LockFile and PidFile.
 
28
#
 
29
ServerRoot "@@ServerRoot@@"
 
30
 
 
31
#
 
32
# Listen: Allows you to bind Apache to specific IP addresses and/or
 
33
# ports, instead of the default. See also the <VirtualHost>
 
34
# directive.
 
35
#
 
36
# Change this to Listen on specific IP addresses as shown below to 
 
37
# prevent Apache from glomming onto all bound IP addresses.
 
38
#
 
39
#Listen 12.34.56.78:80
 
40
Listen @@Port@@
 
41
 
 
42
#
 
43
# Dynamic Shared Object (DSO) Support
 
44
#
 
45
# To be able to use the functionality of a module which was built as a DSO you
 
46
# have to place corresponding `LoadModule' lines at this location so the
 
47
# directives contained in it are actually available _before_ they are used.
 
48
# Statically compiled modules (those listed by `httpd -l') do not need
 
49
# to be loaded here.
 
50
#
 
51
# Example:
 
52
# LoadModule foo_module modules/mod_foo.so
 
53
#
 
54
@@LoadModule@@
 
55
 
 
56
<IfModule !mpm_netware_module>
 
57
#
 
58
# If you wish httpd to run as a different user or group, you must run
 
59
# httpd as root initially and it will switch.  
 
60
#
 
61
# User/Group: The name (or #number) of the user/group to run httpd as.
 
62
# It is usually good practice to create a dedicated user and group for
 
63
# running httpd, as with most system services.
 
64
#
 
65
User daemon
 
66
Group daemon
 
67
</IfModule>
 
68
 
 
69
# 'Main' server configuration
 
70
#
 
71
# The directives in this section set up the values used by the 'main'
 
72
# server, which responds to any requests that aren't handled by a
 
73
# <VirtualHost> definition.  These values also provide defaults for
 
74
# any <VirtualHost> containers you may define later in the file.
 
75
#
 
76
# All of these directives may appear inside <VirtualHost> containers,
 
77
# in which case these default settings will be overridden for the
 
78
# virtual host being defined.
 
79
#
 
80
 
 
81
#
 
82
# ServerAdmin: Your address, where problems with the server should be
 
83
# e-mailed.  This address appears on some server-generated pages, such
 
84
# as error documents.  e.g. admin@your-domain.com
 
85
#
 
86
ServerAdmin you@example.com
 
87
 
 
88
#
 
89
# ServerName gives the name and port that the server uses to identify itself.
 
90
# This can often be determined automatically, but we recommend you specify
 
91
# it explicitly to prevent problems during startup.
 
92
#
 
93
# If your host doesn't have a registered DNS name, enter its IP address here.
 
94
#
 
95
#ServerName www.example.com:80
 
96
 
 
97
#
 
98
# DocumentRoot: The directory out of which you will serve your
 
99
# documents. By default, all requests are taken from this directory, but
 
100
# symbolic links and aliases may be used to point to other locations.
 
101
#
 
102
DocumentRoot "@exp_htdocsdir@"
 
103
 
 
104
#
 
105
# Each directory to which Apache has access can be configured with respect
 
106
# to which services and features are allowed and/or disabled in that
 
107
# directory (and its subdirectories). 
 
108
#
 
109
# First, we configure the "default" to be a very restrictive set of 
 
110
# features.  
 
111
#
 
112
<Directory />
 
113
    Options FollowSymLinks
 
114
    AllowOverride None
 
115
    Order deny,allow
 
116
    Deny from all
 
117
</Directory>
 
118
 
 
119
#
 
120
# Note that from this point forward you must specifically allow
 
121
# particular features to be enabled - so if something's not working as
 
122
# you might expect, make sure that you have specifically enabled it
 
123
# below.
 
124
#
 
125
 
 
126
#
 
127
# This should be changed to whatever you set DocumentRoot to.
 
128
#
 
129
<Directory "@exp_htdocsdir@">
 
130
    #
 
131
    # Possible values for the Options directive are "None", "All",
 
132
    # or any combination of:
 
133
    #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
 
134
    #
 
135
    # Note that "MultiViews" must be named *explicitly* --- "Options All"
 
136
    # doesn't give it to you.
 
137
    #
 
138
    # The Options directive is both complicated and important.  Please see
 
139
    # http://httpd.apache.org/docs/2.2/mod/core.html#options
 
140
    # for more information.
 
141
    #
 
142
    Options Indexes FollowSymLinks
 
143
 
 
144
    #
 
145
    # AllowOverride controls what directives may be placed in .htaccess files.
 
146
    # It can be "All", "None", or any combination of the keywords:
 
147
    #   Options FileInfo AuthConfig Limit
 
148
    #
 
149
    AllowOverride None
 
150
 
 
151
    #
 
152
    # Controls who can get stuff from this server.
 
153
    #
 
154
    Order allow,deny
 
155
    Allow from all
 
156
 
 
157
</Directory>
 
158
 
 
159
#
 
160
# DirectoryIndex: sets the file that Apache will serve if a directory
 
161
# is requested.
 
162
#
 
163
<IfModule dir_module>
 
164
    DirectoryIndex index.html
 
165
</IfModule>
 
166
 
 
167
#
 
168
# The following lines prevent .htaccess and .htpasswd files from being 
 
169
# viewed by Web clients. 
 
170
#
 
171
<FilesMatch "^\.ht">
 
172
    Order allow,deny
 
173
    Deny from all
 
174
    Satisfy All
 
175
</FilesMatch>
 
176
 
 
177
#
 
178
# ErrorLog: The location of the error log file.
 
179
# If you do not specify an ErrorLog directive within a <VirtualHost>
 
180
# container, error messages relating to that virtual host will be
 
181
# logged here.  If you *do* define an error logfile for a <VirtualHost>
 
182
# container, that host's errors will be logged there and not here.
 
183
#
 
184
ErrorLog @rel_logfiledir@/error_log
 
185
 
 
186
#
 
187
# LogLevel: Control the number of messages logged to the error_log.
 
188
# Possible values include: debug, info, notice, warn, error, crit,
 
189
# alert, emerg.
 
190
#
 
191
LogLevel warn
 
192
 
 
193
<IfModule log_config_module>
 
194
    #
 
195
    # The following directives define some format nicknames for use with
 
196
    # a CustomLog directive (see below).
 
197
    #
 
198
    LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
 
199
    LogFormat "%h %l %u %t \"%r\" %>s %b" common
 
200
 
 
201
    <IfModule logio_module>
 
202
      # You need to enable mod_logio.c to use %I and %O
 
203
      LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
 
204
    </IfModule>
 
205
 
 
206
    #
 
207
    # The location and format of the access logfile (Common Logfile Format).
 
208
    # If you do not define any access logfiles within a <VirtualHost>
 
209
    # container, they will be logged here.  Contrariwise, if you *do*
 
210
    # define per-<VirtualHost> access logfiles, transactions will be
 
211
    # logged therein and *not* in this file.
 
212
    #
 
213
    CustomLog @rel_logfiledir@/access_log common
 
214
 
 
215
    #
 
216
    # If you prefer a logfile with access, agent, and referer information
 
217
    # (Combined Logfile Format) you can use the following directive.
 
218
    #
 
219
    #CustomLog @rel_logfiledir@/access_log combined
 
220
</IfModule>
 
221
 
 
222
<IfModule alias_module>
 
223
    #
 
224
    # Redirect: Allows you to tell clients about documents that used to 
 
225
    # exist in your server's namespace, but do not anymore. The client 
 
226
    # will make a new request for the document at its new location.
 
227
    # Example:
 
228
    # Redirect permanent /foo http://www.example.com/bar
 
229
 
 
230
    #
 
231
    # Alias: Maps web paths into filesystem paths and is used to
 
232
    # access content that does not live under the DocumentRoot.
 
233
    # Example:
 
234
    # Alias /webpath /full/filesystem/path
 
235
    #
 
236
    # If you include a trailing / on /webpath then the server will
 
237
    # require it to be present in the URL.  You will also likely
 
238
    # need to provide a <Directory> section to allow access to
 
239
    # the filesystem path.
 
240
 
 
241
    #
 
242
    # ScriptAlias: This controls which directories contain server scripts. 
 
243
    # ScriptAliases are essentially the same as Aliases, except that
 
244
    # documents in the target directory are treated as applications and
 
245
    # run by the server when requested rather than as documents sent to the
 
246
    # client.  The same rules about trailing "/" apply to ScriptAlias
 
247
    # directives as to Alias.
 
248
    #
 
249
    ScriptAlias /cgi-bin/ "@exp_cgidir@/"
 
250
 
 
251
</IfModule>
 
252
 
 
253
<IfModule cgid_module>
 
254
    #
 
255
    # ScriptSock: On threaded servers, designate the path to the UNIX
 
256
    # socket used to communicate with the CGI daemon of mod_cgid.
 
257
    #
 
258
    #Scriptsock @rel_runtimedir@/cgisock
 
259
</IfModule>
 
260
 
 
261
#
 
262
# "@exp_cgidir@" should be changed to whatever your ScriptAliased
 
263
# CGI directory exists, if you have that configured.
 
264
#
 
265
<Directory "@exp_cgidir@">
 
266
    AllowOverride None
 
267
    Options None
 
268
    Order allow,deny
 
269
    Allow from all
 
270
</Directory>
 
271
 
 
272
#
 
273
# DefaultType: the default MIME type the server will use for a document
 
274
# if it cannot otherwise determine one, such as from filename extensions.
 
275
# If your server contains mostly text or HTML documents, "text/plain" is
 
276
# a good value.  If most of your content is binary, such as applications
 
277
# or images, you may want to use "application/octet-stream" instead to
 
278
# keep browsers from trying to display binary files as though they are
 
279
# text.
 
280
#
 
281
DefaultType text/plain
 
282
 
 
283
<IfModule mime_module>
 
284
    #
 
285
    # TypesConfig points to the file containing the list of mappings from
 
286
    # filename extension to MIME-type.
 
287
    #
 
288
    TypesConfig @rel_sysconfdir@/mime.types
 
289
 
 
290
    #
 
291
    # AddType allows you to add to or override the MIME configuration
 
292
    # file specified in TypesConfig for specific file types.
 
293
    #
 
294
    #AddType application/x-gzip .tgz
 
295
    #
 
296
    # AddEncoding allows you to have certain browsers uncompress
 
297
    # information on the fly. Note: Not all browsers support this.
 
298
    #
 
299
    #AddEncoding x-compress .Z
 
300
    #AddEncoding x-gzip .gz .tgz
 
301
    #
 
302
    # If the AddEncoding directives above are commented-out, then you
 
303
    # probably should define those extensions to indicate media types:
 
304
    #
 
305
    AddType application/x-compress .Z
 
306
    AddType application/x-gzip .gz .tgz
 
307
 
 
308
    #
 
309
    # AddHandler allows you to map certain file extensions to "handlers":
 
310
    # actions unrelated to filetype. These can be either built into the server
 
311
    # or added with the Action directive (see below)
 
312
    #
 
313
    # To use CGI scripts outside of ScriptAliased directories:
 
314
    # (You will also need to add "ExecCGI" to the "Options" directive.)
 
315
    #
 
316
    #AddHandler cgi-script .cgi
 
317
 
 
318
    # For type maps (negotiated resources):
 
319
    #AddHandler type-map var
 
320
 
 
321
    #
 
322
    # Filters allow you to process content before it is sent to the client.
 
323
    #
 
324
    # To parse .shtml files for server-side includes (SSI):
 
325
    # (You will also need to add "Includes" to the "Options" directive.)
 
326
    #
 
327
    #AddType text/html .shtml
 
328
    #AddOutputFilter INCLUDES .shtml
 
329
</IfModule>
 
330
 
 
331
#
 
332
# The mod_mime_magic module allows the server to use various hints from the
 
333
# contents of the file itself to determine its type.  The MIMEMagicFile
 
334
# directive tells the module where the hint definitions are located.
 
335
#
 
336
#MIMEMagicFile @rel_sysconfdir@/magic
 
337
 
 
338
#
 
339
# Customizable error responses come in three flavors:
 
340
# 1) plain text 2) local redirects 3) external redirects
 
341
#
 
342
# Some examples:
 
343
#ErrorDocument 500 "The server made a boo boo."
 
344
#ErrorDocument 404 /missing.html
 
345
#ErrorDocument 404 "/cgi-bin/missing_handler.pl"
 
346
#ErrorDocument 402 http://www.example.com/subscription_info.html
 
347
#
 
348
 
 
349
#
 
350
# EnableMMAP and EnableSendfile: On systems that support it, 
 
351
# memory-mapping or the sendfile syscall is used to deliver
 
352
# files.  This usually improves server performance, but must
 
353
# be turned off when serving from networked-mounted 
 
354
# filesystems or if support for these functions is otherwise
 
355
# broken on your system.
 
356
#
 
357
#EnableMMAP off
 
358
#EnableSendfile off
 
359
 
 
360
# Supplemental configuration
 
361
#
 
362
# The configuration files in the @rel_sysconfdir@/extra/ directory can be 
 
363
# included to add extra features or to modify the default configuration of 
 
364
# the server, or you may simply copy their contents here and change as 
 
365
# necessary.
 
366
 
 
367
# Server-pool management (MPM specific)
 
368
#Include @rel_sysconfdir@/extra/httpd-mpm.conf
 
369
 
 
370
# Multi-language error messages
 
371
#Include @rel_sysconfdir@/extra/httpd-multilang-errordoc.conf
 
372
 
 
373
# Fancy directory listings
 
374
#Include @rel_sysconfdir@/extra/httpd-autoindex.conf
 
375
 
 
376
# Language settings
 
377
#Include @rel_sysconfdir@/extra/httpd-languages.conf
 
378
 
 
379
# User home directories
 
380
#Include @rel_sysconfdir@/extra/httpd-userdir.conf
 
381
 
 
382
# Real-time info on requests and configuration
 
383
#Include @rel_sysconfdir@/extra/httpd-info.conf
 
384
 
 
385
# Virtual hosts
 
386
#Include @rel_sysconfdir@/extra/httpd-vhosts.conf
 
387
 
 
388
# Local access to the Apache HTTP Server Manual
 
389
#Include @rel_sysconfdir@/extra/httpd-manual.conf
 
390
 
 
391
# Distributed authoring and versioning (WebDAV)
 
392
#Include @rel_sysconfdir@/extra/httpd-dav.conf
 
393
 
 
394
# Various default settings
 
395
#Include @rel_sysconfdir@/extra/httpd-default.conf
 
396
 
 
397
# Secure (SSL/TLS) connections
 
398
#Include @rel_sysconfdir@/extra/httpd-ssl.conf
 
399
#
 
400
# Note: The following must must be present to support
 
401
#       starting without SSL on platforms with no /dev/random equivalent
 
402
#       but a statically compiled-in mod_ssl.
 
403
#
 
404
<IfModule ssl_module>
 
405
SSLRandomSeed startup builtin
 
406
SSLRandomSeed connect builtin
 
407
</IfModule>