/[apache]/trunk/dist/2.2/conf/httpd.conf
Gentoo

Contents of /trunk/dist/2.2/conf/httpd.conf

Parent Directory Parent Directory | Revision Log Revision Log


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

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

  ViewVC Help
Powered by ViewVC 1.1.20