granicus.if.org Git - apache/blob - docs/manual/mod/mod_mime.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <HTML>
   3 <HEAD>
   4 <TITLE>Apache module mod_mime</TITLE>
   5 </HEAD>
   6
   7 <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
   8 <BODY
   9  BGCOLOR="#FFFFFF"
  10  TEXT="#000000"
  11  LINK="#0000FF"
  12  VLINK="#000080"
  13  ALINK="#FF0000"
  14 >
  15 <!--#include virtual="header.html" -->
  16 <H1 ALIGN="CENTER">Module mod_mime</H1>
  17
  18 This module is contained in the <CODE>mod_mime.c</CODE> file, and is
  19 compiled in by default. It provides for determining the types of files
  20 from the filename.
  21
  22 <H2>Summary</H2>
  23
  24 This module is used to determine various bits of "meta information"
  25 about documents. This information relates to the content of the
  26 document and is returned to the browser or used in content-negotiation
  27 within the server. In addition, a "handler" can be set for a document,
  28 which determines how the document will be processed within the server.
  29
  30 <P>
  31
  32 The directives <a href="#addcharset">AddCharset</a>,
  33 <A HREF="#addencoding">AddEncoding</A>, <A HREF="#addhandler">AddHandler</A>,
  34 <A HREF="#addlanguage">AddLanguage</A> and <A HREF="#addtype">AddType</A>
  35 are all used to map file extensions onto the meta-information for that
  36 file.  Respectively they set the character set, content-encoding, handler,
  37 content-language, and MIME-type (content-type) of documents.  The
  38 directive <A HREF="#typesconfig">TypesConfig</A> is used to specify a
  39 file which also maps extensions onto MIME types. The directives <A
  40 HREF="#forcetype">ForceType</A> and <A
  41 HREF="#sethandler">SetHandler</A> are used to associated all the files
  42 in a given location (<EM>e.g.</EM>, a particular directory) onto a particular
  43 MIME type or handler.
  44
  45 <P>
  46
  47 Note that changing the type or encoding of a file does not change the
  48 value of the <CODE>Last-Modified</CODE> header. Thus, previously cached
  49 copies may still be used by a client or proxy, with the previous headers.
  50
  51 <H2><A NAME="multipleext">Files with Multiple Extensions</A></H2>
  52
  53 Files can have more than one extension, and the order of the
  54 extensions is <EM>normally</EM> irrelevant. For example, if the file
  55 <CODE>welcome.html.fr</CODE> maps onto content type text/html and
  56 language French then the file <CODE>welcome.fr.html</CODE> will map
  57 onto exactly the same information. The only exception to this is if an
  58 extension is given which Apache does not know how to handle. In this
  59 case it will "forget" about any information it obtained from
  60 extensions to the left of the unknown extension. So, for example, if
  61 the extensions fr and html are mapped to the appropriate language and
  62 type but extension xxx is not assigned to anything, then the file
  63 <CODE>welcome.fr.xxx.html</CODE> will be associated with content-type
  64 text/html but <EM>no</EM> language.
  65
  66 <P>
  67
  68 If more than one extension is given which maps onto the same type of
  69 meta-information, then the one to the right will be used. For example,
  70 if ".gif" maps to the MIME-type image/gif and ".html" maps to the
  71 MIME-type text/html, then the file <CODE>welcome.gif.html</CODE> will
  72 be associated with the MIME-type "text/html".
  73
  74 <P>
  75
  76 Care should be taken when a file with multiple extensions gets
  77 associated with both a MIME-type and a handler. This will usually
  78 result in the request being by the module associated with the
  79 handler. For example, if the <CODE>.imap</CODE> extension is mapped to
  80 the handler "imap-file" (from mod_imap) and the <CODE>.html</CODE>
  81 extension is mapped to the MIME-type "text/html", then the file
  82 <CODE>world.imap.html</CODE> will be associated with both the
  83 "imap-file" handler and "text/html" MIME-type. When it is processed,
  84 the "imap-file" handler will be used, and so it will be treated as a
  85 mod_imap imagemap file.
  86
  87 <H2>Directives</H2>
  88 <UL>
  89 <li><a href="#addcharset">AddCharset</a></li>
  90 <LI><A HREF="#addencoding">AddEncoding</A>
  91 <LI><A HREF="#addhandler">AddHandler</A>
  92 <LI><A HREF="#addlanguage">AddLanguage</A>
  93 <LI><A HREF="#addtype">AddType</A>
  94 <LI><A HREF="#defaultlanguage">DefaultLanguage</A>
  95 <LI><A HREF="#forcetype">ForceType</A>
  96 <LI><A HREF="#removehandler">RemoveHandler</A>
  97 <LI><A HREF="#sethandler">SetHandler</A>
  98 <LI><A HREF="#typesconfig">TypesConfig</A>
  99 </UL>
 100 <HR>
 101
 102 <H2><A NAME="addcharset">AddCharset</A></H2>
 103 <A HREF="directive-dict.html#Syntax" REL="Help"
 104 ><STRONG>Syntax:</STRONG></A> AddCharset <i>charset extension
 105  [extension...]</i><br>
 106 <A HREF="directive-dict.html#Context" REL="Help"
 107 ><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
 108 <A
 109  HREF="directive-dict.html#Override"
 110  REL="Help"
 111 ><STRONG>Override:</STRONG></A> FileInfo<BR>
 112 <A
 113  HREF="directive-dict.html#Status"
 114  REL="Help"
 115 ><STRONG>Status:</STRONG></A> Base<BR>
 116 <A
 117  HREF="directive-dict.html#Module"
 118  REL="Help"
 119 ><STRONG>Module:</STRONG></A> mod_mime
 120 <br>
 121 <A HREF="directive-dict.html#Compatibility" REL="Help"
 122 ><STRONG>Compatibility:</STRONG></A> AddCharset is only available in Apache
 123 1.3.10 and later
 124
 125 <P>
 126 The AddCharset directive maps the given filename extensions to the
 127 specified content charset. <i>charset</i> is the MIME charset
 128 parameter of filenames containing <i>extension</i>.  This mapping is
 129 added to any already in force, overriding any mappings that already
 130 exist for the same <i>extension</i>.
 131 </P>
 132 <P>
 133 Example:
 134 <pre>
 135     AddLanguage ja .ja
 136     AddCharset EUC-JP .euc
 137     AddCharset ISO-2022-JP .jis
 138     AddCharset SHIFT_JIS .sjis
 139 </pre>
 140
 141 <P>
 142 Then the document <CODE>xxxx.ja.jis</CODE> will be treated as being a
 143 Japanese document whose charset is ISO-2022-JP (as will the document
 144 <CODE>xxxx.jis.ja</CODE>). The AddCharset directive is useful for both
 145 to inform the client about the character encoding of the document so
 146 that the document can be interpreted and displayed appropriately, and
 147 for <A HREF="../content-negotiation.html">content negotiation</A>, where
 148 the server returns one from several documents based on the client's
 149 charset preference.
 150 </P>
 151 <P>
 152 <STRONG>See also</STRONG>: <A HREF="mod_negotiation.html">mod_negotiation</A>
 153 </P>
 154
 155 <hr>
 156
 157 <H2><A NAME="addencoding">AddEncoding</A></H2>
 158 <!--%plaintext &lt;?INDEX {\tt AddEncoding} directive&gt; -->
 159 <A
 160  HREF="directive-dict.html#Syntax"
 161  REL="Help"
 162 ><STRONG>Syntax:</STRONG></A> AddEncoding <EM>MIME-enc extension extension...</EM><BR>
 163 <A
 164  HREF="directive-dict.html#Context"
 165  REL="Help"
 166 ><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
 167 <A
 168  HREF="directive-dict.html#Override"
 169  REL="Help"
 170 ><STRONG>Override:</STRONG></A> FileInfo<BR>
 171 <A
 172  HREF="directive-dict.html#Status"
 173  REL="Help"
 174 ><STRONG>Status:</STRONG></A> Base<BR>
 175 <A
 176  HREF="directive-dict.html#Module"
 177  REL="Help"
 178 ><STRONG>Module:</STRONG></A> mod_mime<P>
 179
 180 The AddEncoding directive maps the given filename extensions to the
 181 specified encoding type. <EM>MIME-enc</EM> is the MIME encoding to use
 182 for documents containing the <EM>extension</EM>. This mapping is added
 183 to any already in force, overriding any mappings that already exist
 184 for the same <EM>extension</EM>.
 185
 186 Example:
 187 <BLOCKQUOTE><CODE> AddEncoding x-gzip gz<BR> AddEncoding x-compress Z
 188 </CODE></BLOCKQUOTE>
 189
 190 This will cause filenames containing the .gz extension to be marked as
 191 encoded using the x-gzip encoding, and filenames containing the .Z
 192 extension to be marked as encoded with x-compress.<P>
 193
 194 Old clients expect <CODE>x-gzip</CODE> and <CODE>x-compress</CODE>,
 195 however the standard dictates that they're equivalent to <CODE>gzip</CODE>
 196 and <CODE>compress</CODE> respectively.  Apache does content encoding
 197 comparisons by ignoring any leading <CODE>x-</CODE>.  When responding
 198 with an encoding Apache will use whatever form (<EM>i.e.</EM>, <CODE>x-foo</CODE>
 199 or <CODE>foo</CODE>) the client requested.  If the client didn't
 200 specifically request a particular form Apache will use the form given by
 201 the <CODE>AddEncoding</CODE> directive.  To make this long story short,
 202 you should always use <CODE>x-gzip</CODE> and <CODE>x-compress</CODE>
 203 for these two specific encodings.  More recent encodings, such as
 204 <CODE>deflate</CODE> should be specified without the <CODE>x-</CODE>.
 205
 206 <P>
 207
 208 <STRONG>See also</STRONG>: <A HREF="#multipleext">Files with
 209 multiple extensions</A>
 210
 211 <P><HR>
 212
 213 <H2><A NAME="addhandler">AddHandler</A></H2>
 214
 215 <A
 216  HREF="directive-dict.html#Syntax"
 217  REL="Help"
 218 ><STRONG>Syntax:</STRONG></A> AddHandler <EM>handler-name extension extension...</EM><BR>
 219 <A
 220  HREF="directive-dict.html#Context"
 221  REL="Help"
 222 ><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
 223 <A
 224  HREF="directive-dict.html#Override"
 225  REL="Help"
 226 ><STRONG>Override:</STRONG></A> FileInfo<BR>
 227 <A
 228  HREF="directive-dict.html#Status"
 229  REL="Help"
 230 ><STRONG>Status:</STRONG></A> Base<BR>
 231 <A
 232  HREF="directive-dict.html#Module"
 233  REL="Help"
 234 ><STRONG>Module:</STRONG></A> mod_mime<BR>
 235 <A
 236  HREF="directive-dict.html#Compatibility"
 237  REL="Help"
 238 ><STRONG>Compatibility:</STRONG></A> AddHandler is only available in Apache
 239 1.1 and later<P>
 240
 241 <P>AddHandler maps the filename extensions <EM>extension</EM> to the
 242 <A HREF="../handler.html">handler</A> <EM>handler-name</EM>.  This
 243 mapping is added to any already in force, overriding any mappings that
 244 already exist for the same <EM>extension</EM>.
 245
 246 For example, to activate CGI scripts
 247 with the file extension "<CODE>.cgi</CODE>", you might use:
 248 <PRE>
 249     AddHandler cgi-script cgi
 250 </PRE>
 251
 252 <P>Once that has been put into your srm.conf or httpd.conf file, any
 253 file containing the "<CODE>.cgi</CODE>" extension will be treated as a
 254 CGI program.</P>
 255
 256 <P>
 257
 258 <STRONG>See also</STRONG>: <A HREF="#multipleext">Files with
 259 multiple extensions</A>
 260
 261 <HR>
 262
 263 <H2><A NAME="addlanguage">AddLanguage</A></H2>
 264 <!--%plaintext &lt;?INDEX {\tt AddLanguage} directive&gt; -->
 265 <A
 266  HREF="directive-dict.html#Syntax"
 267  REL="Help"
 268 ><STRONG>Syntax:</STRONG></A> AddLanguage <EM>MIME-lang extension extension...</EM><BR>
 269 <A
 270  HREF="directive-dict.html#Context"
 271  REL="Help"
 272 ><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
 273 <A
 274  HREF="directive-dict.html#Override"
 275  REL="Help"
 276 ><STRONG>Override:</STRONG></A> FileInfo<BR>
 277 <A
 278  HREF="directive-dict.html#Status"
 279  REL="Help"
 280 ><STRONG>Status:</STRONG></A> Base<BR>
 281 <A
 282  HREF="directive-dict.html#Module"
 283  REL="Help"
 284 ><STRONG>Module:</STRONG></A> mod_mime
 285
 286 <P>
 287 The AddLanguage directive maps the given filename extensions to the
 288 specified content language. <EM>MIME-lang</EM> is the MIME language of
 289 filenames containing <EM>extension</EM>.  This mapping is added to any
 290 already in force, overriding any mappings that already exist for the
 291 same <EM>extension</EM>.
 292 </P>
 293 <P>
 294 Example: <BLOCKQUOTE><CODE>
 295 AddEncoding x-compress Z<BR> AddLanguage en .en<BR> AddLanguage fr
 296 .fr<BR> </CODE></BLOCKQUOTE>
 297 </P>
 298 <P>
 299 Then the document <CODE>xxxx.en.Z</CODE> will be treated as being a
 300 compressed English document (as will the document
 301 <CODE>xxxx.Z.en</CODE>). Although the content language is reported to
 302 the client, the browser is unlikely to use this information. The
 303 AddLanguage directive is more useful for
 304 <A HREF="../content-negotiation.html">content negotiation</A>, where
 305 the server returns one from several documents based on the client's
 306 language preference.
 307 </P>
 308 <P>
 309 If multiple language assignments are made for the same extension,
 310 the last one encountered is the one that is used.  That is, for the
 311 case of:
 312 </P>
 313 <PRE>
 314     AddLanguage en .en
 315     AddLanguage en-uk .en
 316     AddLanguage en-us .en
 317 </PRE>
 318 <P>
 319 documents with the extension "<CODE>.en</CODE>" would be treated as
 320 being "<CODE>en-us</CODE>".
 321 </P>
 322 <P>
 323 <STRONG>See also</STRONG>: <A HREF="#multipleext">Files with
 324 multiple extensions</A>
 325 <BR>
 326 <STRONG>See also</STRONG>: <A
 327 HREF="./mod_negotiation.html">mod_negotiation</A>
 328 </P>
 329
 330 <HR>
 331
 332 <H2><A NAME="addtype">AddType</A></H2>
 333 <!--%plaintext &lt;?INDEX {\tt AddType} directive&gt; -->
 334 <A
 335  HREF="directive-dict.html#Syntax"
 336  REL="Help"
 337 ><STRONG>Syntax:</STRONG></A> AddType <EM>MIME-type extension extension...</EM><BR>
 338 <A
 339  HREF="directive-dict.html#Context"
 340  REL="Help"
 341 ><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
 342 <A
 343  HREF="directive-dict.html#Override"
 344  REL="Help"
 345 ><STRONG>Override:</STRONG></A> FileInfo<BR>
 346 <A
 347  HREF="directive-dict.html#Status"
 348  REL="Help"
 349 ><STRONG>Status:</STRONG></A> Base<BR>
 350 <A
 351  HREF="directive-dict.html#Module"
 352  REL="Help"
 353 ><STRONG>Module:</STRONG></A> mod_mime<P>
 354
 355 The AddType directive maps the given filename extensions onto the
 356 specified content type. <EM>MIME-enc</EM> is the MIME type to use for
 357 filenames containing <EM>extension</EM>.  This mapping is added to any
 358 already in force, overriding any mappings that already exist for the
 359 same <EM>extension</EM>. This directive can be used to add mappings
 360 not listed in the MIME types file (see the <CODE><A
 361 HREF="#typesconfig">TypesConfig</A></CODE> directive).
 362
 363 Example:
 364 <BLOCKQUOTE><CODE>
 365 AddType image/gif GIF
 366 </CODE></BLOCKQUOTE>
 367 It is recommended that new MIME types be added using the AddType directive
 368 rather than changing the <A HREF="#typesconfig">TypesConfig</A> file.<P>
 369 Note that, unlike the NCSA httpd, this directive cannot be used to set the
 370 type of particular files.<P>
 371
 372 <P>
 373
 374 <STRONG>See also</STRONG>: <A HREF="#multipleext">Files with
 375 multiple extensions</A>
 376
 377 <HR>
 378
 379 <H2><A NAME="defaultlanguage">DefaultLanguage</A></H2>
 380 <!--%plaintext &lt;?INDEX {\tt DefaultLanguage} directive&gt; -->
 381 <A
 382  HREF="directive-dict.html#Syntax"
 383  REL="Help"
 384 ><STRONG>Syntax:</STRONG></A> DefaultLanguage <EM>MIME-lang</EM><BR>
 385 <A
 386  HREF="directive-dict.html#Context"
 387  REL="Help"
 388 ><STRONG>Context:</STRONG></A> server config, virtual host, directory, .htaccess<BR>
 389 <A
 390  HREF="directive-dict.html#Override"
 391  REL="Help"
 392 ><STRONG>Override:</STRONG></A> FileInfo<BR>
 393 <A
 394  HREF="directive-dict.html#Status"
 395  REL="Help"
 396 ><STRONG>Status:</STRONG></A> Base<BR>
 397 <A
 398  HREF="directive-dict.html#Module"
 399  REL="Help"
 400 ><STRONG>Module:</STRONG></A> mod_mime<BR>
 401 <A
 402  HREF="directive-dict.html#Compatibility"
 403  REL="Help"
 404 ><STRONG>Compatibility:</STRONG></A> DefaultLanguage is only available in Apache
 405 1.3.4 and later.<P>
 406
 407 The DefaultLanguage directive tells Apache that all files in the
 408 directive's scope (<EM>e.g.</EM>, all files covered by the current
 409 <CODE>&lt;Directory&gt;</CODE> container) that don't have an explicit
 410 language extension (such as <SAMP>.fr</SAMP> or <SAMP>.de</SAMP> as
 411 configured by <SAMP>AddLanguage</SAMP>) should be considered to be in
 412 the specified <EM>MIME-lang</EM> language.  This allows entire
 413 directories to be marked as containing Dutch content, for instance,
 414 without having to rename each file. Note that unlike using extensions
 415 to specify languages, <SAMP>DefaultLanguage</SAMP> can only specify a
 416 single language.
 417
 418 <P>
 419
 420 If no <SAMP>DefaultLanguage</SAMP> directive is in force, and a file
 421 does not have any language extensions as configured by
 422 <SAMP>AddLanguage</SAMP>, then that file will be considered to have no
 423 language attribute.
 424
 425 <P>
 426
 427 <STRONG>See also</STRONG>: <A
 428 HREF="./mod_negotiation.html">mod_negotiation</A>
 429 <BR>
 430 <STRONG>See also</STRONG>: <A HREF="#multipleext">Files with
 431 multiple extensions</A>
 432
 433 <HR>
 434
 435 <H2><A NAME="forcetype">ForceType</A></H2>
 436
 437 <A
 438  HREF="directive-dict.html#Syntax"
 439  REL="Help"
 440 ><STRONG>Syntax:</STRONG></A> ForceType <EM>media type</EM><BR>
 441 <A
 442  HREF="directive-dict.html#Context"
 443  REL="Help"
 444 ><STRONG>Context:</STRONG></A> directory, .htaccess<BR>
 445 <A
 446  HREF="directive-dict.html#Status"
 447  REL="Help"
 448 ><STRONG>Status:</STRONG></A> Base<BR>
 449 <A
 450  HREF="directive-dict.html#Module"
 451  REL="Help"
 452 ><STRONG>Module:</STRONG></A> mod_mime<BR>
 453 <A
 454  HREF="directive-dict.html#Compatibility"
 455  REL="Help"
 456 ><STRONG>Compatibility:</STRONG></A> ForceType is only available in Apache
 457 1.1 and later.<P>
 458
 459 <P>When placed into an <CODE>.htaccess</CODE> file or a
 460 <CODE>&lt;Directory&gt;</CODE> or <CODE>&lt;Location&gt;</CODE> section,
 461 this directive forces all matching files to be served
 462 as the content type given by <EM>media type</EM>. For example, if you
 463 had a directory full of GIF files, but did not want to label them all with
 464 ".gif", you might want to use:
 465 <PRE>
 466     ForceType image/gif
 467 </PRE>
 468 <P>Note that this will override any filename extensions that might determine
 469 the media type.</P><HR>
 470
 471 <H2><A NAME="removehandler">RemoveHandler</A></H2>
 472
 473 <A
 474  HREF="directive-dict.html#Syntax"
 475  REL="Help"
 476 ><STRONG>Syntax:</STRONG></A> RemoveHandler <EM>extension extension...</EM><BR>
 477 <A
 478  HREF="directive-dict.html#Context"
 479  REL="Help"
 480 ><STRONG>Context:</STRONG></A> directory, .htaccess<BR>
 481 <A
 482  HREF="directive-dict.html#Status"
 483  REL="Help"
 484 ><STRONG>Status:</STRONG></A> Base<BR>
 485 <A
 486  HREF="directive-dict.html#Module"
 487  REL="Help"
 488 ><STRONG>Module:</STRONG></A> mod_mime<BR>
 489 <A
 490  HREF="directive-dict.html#Compatibility"
 491  REL="Help"
 492 ><STRONG>Compatibility:</STRONG></A> RemoveHandler is only available in Apache
 493 1.3.4 and later.<P>
 494
 495 <P>
 496 The <SAMP>RemoveHandler</SAMP> directive removes any
 497 handler associations for files with the given extensions.
 498 This allows <CODE>.htaccess</CODE> files in subdirectories to undo
 499 any associations inherited from parent directories or the server
 500 config files.  An example of its use might be:
 501 </P>
 502 <DL>
 503  <DT><CODE>/foo/.htaccess:</CODE></DT>
 504  <DD><CODE>AddHandler server-parsed .html</CODE></DD>
 505  <DT><CODE>/foo/bar/.htaccess:</CODE></DT>
 506  <DD><CODE>RemoveHandler .html</CODE></DD>
 507 </DL>
 508 <P>
 509 This has the effect of returning <SAMP>.html</SAMP> files in the
 510 <SAMP>/foo/bar</SAMP> directory to being treated as normal
 511 files, rather than as candidates for parsing (see the
 512 <A HREF="mod_include.html"><SAMP>mod_include</SAMP></A> module).
 513 </P>
 514 <HR>
 515
 516 <H2><A NAME="sethandler">SetHandler</A></H2>
 517
 518 <A
 519  HREF="directive-dict.html#Syntax"
 520  REL="Help"
 521 ><STRONG>Syntax:</STRONG></A> SetHandler <EM>handler-name</EM><BR>
 522 <A
 523  HREF="directive-dict.html#Context"
 524  REL="Help"
 525 ><STRONG>Context:</STRONG></A> directory, .htaccess<BR>
 526 <A
 527  HREF="directive-dict.html#Status"
 528  REL="Help"
 529 ><STRONG>Status:</STRONG></A> Base<BR>
 530 <A
 531  HREF="directive-dict.html#Module"
 532  REL="Help"
 533 ><STRONG>Module:</STRONG></A> mod_mime<BR>
 534 <A
 535  HREF="directive-dict.html#Compatibility"
 536  REL="Help"
 537 ><STRONG>Compatibility:</STRONG></A> SetHandler is only available in Apache
 538 1.1 and later.<P>
 539
 540 <P>When placed into an <CODE>.htaccess</CODE> file or a
 541 <CODE>&lt;Directory&gt;</CODE> or <CODE>&lt;Location&gt;</CODE> section,
 542 this directive forces all matching files to be parsed through the
 543 <A HREF="../handler.html">handler</A>
 544 given by <EM>handler-name</EM>. For example, if you had a
 545 directory you wanted to be parsed entirely as imagemap rule files,
 546 regardless of extension, you might put the following into an
 547 <CODE>.htaccess</CODE> file in that directory:
 548 <PRE>
 549     SetHandler imap-file
 550 </PRE>
 551
 552 <P>Another example: if you wanted to have the server display a status
 553 report whenever a URL of <CODE>http://servername/status</CODE> was
 554 called, you might put the following into access.conf:
 555 <PRE>
 556     &lt;Location /status&gt;
 557     SetHandler server-status
 558     &lt;/Location&gt;
 559 </PRE>
 560 <HR>
 561
 562 <H2><A NAME="typesconfig">TypesConfig</A></H2>
 563 <!--%plaintext &lt;?INDEX {\tt TypesConfig} directive&gt; -->
 564 <A
 565  HREF="directive-dict.html#Syntax"
 566  REL="Help"
 567 ><STRONG>Syntax:</STRONG></A> TypesConfig <EM>filename</EM><BR>
 568 <A
 569  HREF="directive-dict.html#Default"
 570  REL="Help"
 571 ><STRONG>Default:</STRONG></A> <CODE>TypesConfig conf/MIME.types</CODE><BR>
 572 <A
 573  HREF="directive-dict.html#Context"
 574  REL="Help"
 575 ><STRONG>Context:</STRONG></A> server config<BR>
 576 <A
 577  HREF="directive-dict.html#Status"
 578  REL="Help"
 579 ><STRONG>Status:</STRONG></A> Base<BR>
 580 <A
 581  HREF="directive-dict.html#Module"
 582  REL="Help"
 583 ><STRONG>Module:</STRONG></A> mod_mime<P>
 584
 585 The TypesConfig directive sets the location of the MIME types configuration
 586 file. <EM>Filename</EM> is relative to the
 587 <A HREF="core.html#serverroot">ServerRoot</A>. This file sets the default list of
 588 mappings from filename extensions to content types; changing this file is not
 589 recommended. Use the <A HREF="#addtype">AddType</A> directive instead. The
 590 file contains lines in the format of the arguments to an AddType command:
 591 <BLOCKQUOTE><EM>MIME-type extension extension ...</EM></BLOCKQUOTE>
 592 The extensions are lower-cased. Blank lines, and lines beginning with a hash
 593 character (`#') are ignored.<P>
 594
 595 <!--#include virtual="footer.html" -->
 596 </BODY>
 597 </HTML>
 598