From: Joshua Slive Date: Thu, 2 May 2002 15:10:28 +0000 (+0000) Subject: Some cleanup, cross-referencing, and description additions for mod_mime. X-Git-Tag: 2.0.37~532 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a44c5833fd801a4994585b831f5784ec35296316;p=apache Some cleanup, cross-referencing, and description additions for mod_mime. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@94905 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_mime.html b/docs/manual/mod/mod_mime.html index 3b4283f3c7..3cd71e0617 100644 --- a/docs/manual/mod/mod_mime.html +++ b/docs/manual/mod/mod_mime.html @@ -2,8 +2,8 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --->mod_mime - Apache HTTP Server
[APACHE DOCUMENTATION]

Apache HTTP Server Version 2.0

Apache Module mod_mime

Description:Associates the request filename's extensions - (e.g. .html) with the file's behavior (handlers and filters) +-->mod_mime - Apache HTTP Server
[APACHE DOCUMENTATION]

Apache HTTP Server Version 2.0

Apache Module mod_mime

Description:Associates the requested filename's extensions + with the file's behavior (handlers and filters) and content (mime-type, language, character set and encoding)
Status:Base
Module Identifier:mime_module

Summary

This module is used to associate various bits of "meta @@ -16,41 +16,35 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX mod_negotiation for more information about content negotiation.

-

The directives AddCharset, - AddEncoding, - AddLanguage and - AddType all used to map file extensions - onto the meta-information for that file. Respectively they set - the character set, content-encoding, content-language, and - MIME-type (content-type) of documents.

- -

In addition, mod_mime may define the "handler" for a - document, which controls which module or script will serve the - document. With the introduction of "filters" in Apache 2.0, - mod_mime can also define the filters that the the content - should be processed through (e.g. the Includes output filter - for server side scripting) and what filters the client request - and POST content should be processed through (the input +

The directives AddCharset, AddEncoding, AddLanguage and AddType are all used to map file + extensions onto the meta-information for that file. Respectively + they set the character set, content-encoding, content-language, + and MIME-type (content-type) of documents.

+ +

In addition, mod_mime may define the "handler" + for a document, which controls what module or script will serve + the document. With the introduction of "filters" in Apache 2.0, + mod_mime can also define the filters that the the + content should be processed through (e.g. the Includes output + filter for server side scripting) and what filters the client + request and POST content should be processed through (the input filters.)

-

The directives AddHandler, - AddOutputFilter, and - AddInputFilter control the modules - or scripts that serve the document. The - MultiviewsMatch directive allows - mod_negotiation to consider these - file extensions to included when testing Multiviews matches.

- -

The directive TypesConfig is used - to specify a file which also maps extensions onto MIME types. - Most administrators use the provided mime.types file which - associates common filename extensions with IANA registered - content types. The current list is maintained at - http://www.isi.edu/in-notes/iana/assignments/media-types/media-types - although it may be mirrored elsewhere). This simplifies the - httpd.conf file by providing the majority of media-type - definitions, and they may be overridden by - AddType directives as needed.

+

The directives AddHandler, AddOutputFilter, and AddInputFilter control the modules + or scripts that serve the document. The MultiviewsMatch directive allows + mod_negotiation to consider these file extensions + to included when testing Multiviews matches.

+ +

The directive TypesConfig is used to specify a + file which also maps extensions onto MIME types. Most + administrators use the provided mime.types file which associates + common filename extensions with IANA registered content types. The + current list is maintained at + http://www.isi.edu/in-notes/iana/assignments/media-types/media-types. This + simplifies the httpd.conf file by providing the + majority of media-type definitions, and they may be overridden by + AddType directives as + needed.

Please do not send requests to the Apache httpd Project to add any new entries in the distributed mime.types file @@ -61,14 +55,12 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX likely conflict later with the already crowded language and character set namespace.
-

The core directives ForceType and - SetHandler are used to - associate all the files in a given container (e.g., - <location>, <directory>, or <Files>) with a - particular MIME-type or handler. These settings override any - filename extension mappings defined in mod_mime.

+

The core directives ForceType and SetHandler are used to associate all the + files in a given container (e.g., <location>, <director>, or <Files>) with a particular + MIME-type or handler. These settings override any filename + extension mappings defined in mod_mime.

-

Note that changing the type or encoding of a file does not +

Note that changing the meta-information for a file does not change the value of the Last-Modified header. Thus, previously cached copies may still be used by a client or proxy, with the previous headers. If you change the @@ -76,7 +68,7 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX encoding) you may need to 'touch' affected files (updating their last modified date) to ensure that all visitors are receive the corrected content headers.

-

Directives

See also

Files with Multiple Extensions

+

Directives

See also

Files with Multiple Extensions

Files can have more than one extension, and the order of the @@ -192,7 +184,7 @@ Content-Type: text/plain; charset=ISO-8859-2

AddCharset Directive

Description: Maps the given filename extensions to the specified content charset
Syntax:AddCharset charset extension -[extension] ...
Default:None
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Base
Module:mod_mime
Compatibility:AddCharset is only available in Apache +[extension] ...
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Base
Module:mod_mime
Compatibility:AddCharset is only available in Apache 1.3.10 and later

The AddCharset directive maps the given filename extensions @@ -221,9 +213,9 @@ Content-Type: text/plain; charset=ISO-8859-2

The extension argument is case-insensitive, and can be specified with or without a leading dot.

-

See also

AddEncoding Directive

Description: Maps the given filename extensions +

See also

AddEncoding Directive

Description: Maps the given filename extensions to the specified encoding type
Syntax:AddEncoding - MIME-enc extension [extension] ...
Default:None
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Base
Module:mod_mime
+ MIME-enc extension [extension] ...
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Base
Module:mod_mime

The AddEncoding directive maps the given filename extensions to the specified encoding type. MIME-enc is the MIME @@ -261,10 +253,9 @@ Content-Type: text/plain; charset=ISO-8859-2 be specified with or without a leading dot.

See also

AddHandler Directive

Description: AddHandler maps the filename extensions -to the handler -handler-name
Syntax:AddHandler - handler-name extension [extension] ...
Default:None
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Base
Module:mod_mime
Compatibility:
+ multiple extensions

AddHandler Directive

Description: Maps the filename extensions +to the specified handler
Syntax:AddHandler + handler-name extension [extension] ...
Context:server config, virtual host, directory, .htaccess
Override:FileInfo
Status:Base
Module:mod_mime
Compatibility:

This mapping is added to any already in force, overriding any mappings that already exist for the same extension. For example, to activate CGI scripts with @@ -282,11 +273,11 @@ handler-name

be specified with or without a leading dot.

See also

AddInputFilter Directive

Description: Maps the filename extensions - to the filter or filters which will process + multiple extensions
  • Handlers
  • SetHandler

    • AddInputFilter Directive

    Description: Maps filename extensions + to the filters that will process client requests
    Syntax:AddInputFilter filter[;filter...] extension - [extension ...]
    Default:None
    Context:server config, virtual host, directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:AddInputFilter + [extension ...]
    Context:server config, virtual host, directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:AddInputFilter is only available in Apache 2.0.26 and later.

    AddInputFilter maps the filename extensions @@ -305,9 +296,9 @@ handler-name

    without a leading dot.

    See also

    AddLanguage Directive

    Description: Maps the given filename extension + documentation.
  • SetInputFilter

    • AddLanguage Directive

    Description: Maps the given filename extension to the specified content language
    Syntax:AddLanguage - MIME-lang extension [extension] ...
    Default:None
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime
    + MIME-lang extension [extension] ...
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime

    The AddLanguage directive maps the given filename extension to the specified content language. MIME-lang is the @@ -353,7 +344,7 @@ to the specified content language

    Syntax:AddOutputFilter filter[;filter...] extension - [extension ...]
    Default:None
    Context:server config, virtual host, directory, .htaccess
    Override:
    Status:Base
    Module:mod_mime
    Compatibility:AddOutputFilter + [extension ...]
    Context:server config, virtual host, directory, .htaccess
    Override:
    Status:Base
    Module:mod_mime
    Compatibility:AddOutputFilter is only available in Apache 2.0.26 and later.

    The AddOutputFilter directive maps the filename @@ -379,9 +370,9 @@ responses from the server

    Filters documentation

    AddType Directive

    Description: Maps the given filename extensions +

    See also

    AddType Directive

    Description: Maps the given filename extensions onto the specified content type
    Syntax:AddType MIME-type - extension [extension] ...
    Default:None
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime
    + extension [extension] ...
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime

    The AddType directive maps the given filename extensions onto the specified content type. MIME-type is the MIME @@ -409,9 +400,9 @@ onto the specified content type

    Files with - multiple extensions

    DefaultLanguage Directive

    Description: Sets all files in the given scope to the + multiple extensions
  • DefaultType

    • DefaultLanguage Directive

    Description: Sets all files in the given scope to the specified language
    Syntax:DefaultLanguage - MIME-lang
    Default:None
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime
    Compatibility:DefaultLanguage + MIME-lang
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime
    Compatibility:DefaultLanguage is only available in Apache 1.3.4 and later.

    The DefaultLanguage directive tells Apache that all files in @@ -432,8 +423,9 @@ specified language

    Files with - multiple extensions
  • mod_negotiation

    • MultiviewsMatch Directive

    Description:
    Syntax:MultiviewsMatch - [NegotiatedOnly] [Handlers] [Filters] [Any]
    Default:None
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime
    Compatibility:only available + multiple extensions
  • mod_negotiation

    • MultiviewsMatch Directive

    Description: The types of files that will be included when +searching for a matching file with MultiViews
    Syntax:MultiviewsMatch + [NegotiatedOnly] [Handlers] [Filters] [Any]
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    Status:Base
    Module:mod_mime
    Compatibility:Available in Apache 2.0.26 and later.

    MultiviewsMatch permits three different behaviors for @@ -460,8 +452,9 @@ specified language

    RemoveCharset Directive
    Description:
    Syntax:RemoveCharset - extension [extension] ...
    Default:None
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveCharset is +

    See also

    RemoveCharset Directive

    Description: Removes any character set associations for a set of file +extensions
    Syntax:RemoveCharset + extension [extension] ...
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveCharset is only available in Apache 2.0.24 and later.

    The RemoveCharset directive removes any character set associations for files with the given extensions. @@ -471,8 +464,9 @@ specified language

    RemoveEncoding Directive
    Description:
    Syntax:RemoveEncoding - extension [extension] ...
    Default:None
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveEncoding +

    RemoveEncoding Directive

    Description: Removes any content encoding associations for a set of file +extensions
    Syntax:RemoveEncoding + extension [extension] ...
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveEncoding is only available in Apache 1.3.13 and later.

    The RemoveEncoding directive removes any @@ -505,8 +499,9 @@ specified language

    RemoveHandler Directive
    Description:
    Syntax:RemoveHandler - extension [extension] ...
    Default:None
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveHandler is +

    RemoveHandler Directive

    Description: Removes any handler associations for a set of file +extensions
    Syntax:RemoveHandler + extension [extension] ...
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveHandler is only available in Apache 1.3.4 and later.

    The RemoveHandler directive removes any handler @@ -534,8 +529,9 @@ specified language

    RemoveInputFilter Directive
    Description:
    Syntax:RemoveInputFilter - extension [extension] ...
    Default:None
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveInputFilter is only available in Apache +

    RemoveInputFilter Directive

    Description: Removes any input filter associations for a set of file +extensions
    Syntax:RemoveInputFilter + extension [extension] ...
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveInputFilter is only available in Apache 2.0.26 and later.

    The RemoveInputFilter directive removes any @@ -546,8 +542,9 @@ specified language

    RemoveLanguage Directive
    Description:
    Syntax:RemoveLanguage - extension [extension] ...
    Default:None
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveLanguage +

    RemoveLanguage Directive

    Description: Removes any language associations for a set of file +extensions
    Syntax:RemoveLanguage + extension [extension] ...
    Context:directory, .htaccess
    Status:Base
    Module:mod_mime
    Compatibility:RemoveLanguage is only available in Apache 2.0.24 and later.

    The RemoveLanguage directive removes any @@ -558,8 +555,9 @@ specified language

    RemoveOutputFilter Directive
    Description:
    Syntax:RemoveOutputFilter - extension [extension] ...
    Default:
    Context:directory, .htaccess
    Override:
    Status:Base
    Module:mod_mime
    Compatibility:RemoveOutputFilter is only available in Apache +

    RemoveOutputFilter Directive

    Description: Removes any output filter associations for a set of file +extensions
    Syntax:RemoveOutputFilter + extension [extension] ...
    Context:directory, .htaccess
    Override:
    Status:Base
    Module:mod_mime
    Compatibility:RemoveOutputFilter is only available in Apache 2.0.26 and later.

    The RemoveOutputFilter directive removes any @@ -570,8 +568,9 @@ specified language

    RemoveType Directive
    Description:
    Syntax:RemoveType - extension [extension] ...
    Default:
    Context:directory, .htaccess
    Override:
    Status:Base
    Module:mod_mime
    Compatibility:RemoveType is +

    RemoveType Directive

    Description: Removes any content type associations for a set of file +extensions
    Syntax:RemoveType + extension [extension] ...
    Context:directory, .htaccess
    Override:
    Status:Base
    Module:mod_mime
    Compatibility:RemoveType is only available in Apache 1.3.13 and later.

    The RemoveType directive removes any MIME type associations for files with the given extensions. This allows @@ -599,7 +598,7 @@ specified language

    TypesConfig Directive
    Description:
    Syntax:TypesConfig file-path
    Default:TypesConfig conf/mime.types
    Context:server config
    Status:Base
    Module:mod_mime
    +

    TypesConfig Directive

    Description: The location of the mime.types file
    Syntax:TypesConfig file-path
    Default:TypesConfig conf/mime.types
    Context:server config
    Status:Base
    Module:mod_mime

    The TypesConfig directive sets the location of the MIME types configuration file. Filename is relative to the diff --git a/docs/manual/mod/mod_mime.xml b/docs/manual/mod/mod_mime.xml index 4b0738d43a..70140dff55 100644 --- a/docs/manual/mod/mod_mime.xml +++ b/docs/manual/mod/mod_mime.xml @@ -4,8 +4,8 @@ mod_mime -Associates the request filename's extensions - (e.g. .html) with the file's behavior (handlers and filters) +Associates the requested filename's extensions + with the file's behavior (handlers and filters) and content (mime-type, language, character set and encoding) Base @@ -23,41 +23,44 @@ mod_negotiation for more information about content negotiation.

    -

    The directives AddCharset, - AddEncoding, - AddLanguage and - AddType all used to map file extensions - onto the meta-information for that file. Respectively they set - the character set, content-encoding, content-language, and - MIME-type (content-type) of documents.

    - -

    In addition, mod_mime may define the "handler" for a - document, which controls which module or script will serve the - document. With the introduction of "filters" in Apache 2.0, - mod_mime can also define the filters that the the content - should be processed through (e.g. the Includes output filter - for server side scripting) and what filters the client request - and POST content should be processed through (the input +

    The directives AddCharset, AddEncoding, AddLanguage and AddType are all used to map file + extensions onto the meta-information for that file. Respectively + they set the character set, content-encoding, content-language, + and MIME-type (content-type) of documents.

    + +

    In addition, mod_mime may define the "handler" + for a document, which controls what module or script will serve + the document. With the introduction of "filters" in Apache 2.0, + mod_mime can also define the filters that the the + content should be processed through (e.g. the Includes output + filter for server side scripting) and what filters the client + request and POST content should be processed through (the input filters.)

    -

    The directives AddHandler, - AddOutputFilter, and - AddInputFilter control the modules - or scripts that serve the document. The - MultiviewsMatch directive allows - mod_negotiation to consider these - file extensions to included when testing Multiviews matches.

    - -

    The directive TypesConfig is used - to specify a file which also maps extensions onto MIME types. - Most administrators use the provided mime.types file which - associates common filename extensions with IANA registered - content types. The current list is maintained at - http://www.isi.edu/in-notes/iana/assignments/media-types/media-types - although it may be mirrored elsewhere). This simplifies the - httpd.conf file by providing the majority of media-type - definitions, and they may be overridden by - AddType directives as needed.

    +

    The directives AddHandler, AddOutputFilter, and AddInputFilter control the modules + or scripts that serve the document. The MultiviewsMatch directive allows + mod_negotiation to consider these file extensions + to included when testing Multiviews matches.

    + +

    The directive TypesConfig is used to specify a + file which also maps extensions onto MIME types. Most + administrators use the provided mime.types file which associates + common filename extensions with IANA registered content types. The + current list is maintained at + http://www.isi.edu/in-notes/iana/assignments/media-types/media-types. This + simplifies the httpd.conf file by providing the + majority of media-type definitions, and they may be overridden by + AddType directives as + needed.

    Please do not send requests to the Apache httpd Project to add any new entries in the distributed mime.types file @@ -69,14 +72,16 @@ character set namespace.

    The core directives ForceType and - SetHandler are used to - associate all the files in a given container (e.g., - <location>, <directory>, or <Files>) with a - particular MIME-type or handler. These settings override any - filename extension mappings defined in mod_mime.

    - -

    Note that changing the type or encoding of a file does not + module="core">ForceType and SetHandler are used to associate all the + files in a given container (e.g., location, director, or Files) with a particular + MIME-type or handler. These settings override any filename + extension mappings defined in mod_mime.

    + +

    Note that changing the meta-information for a file does not change the value of the Last-Modified header. Thus, previously cached copies may still be used by a client or proxy, with the previous headers. If you change the @@ -86,8 +91,14 @@ receive the corrected content headers.

    - See also: MimeMagicFile +DefaultType +AddDefaultCharset +SetHandler +SetInputFilter +SetOutputFilter +
    Files with Multiple Extensions @@ -217,7 +228,6 @@ Content-Type: text/plain; charset=ISO-8859-2 to the specified content charset AddCharset charset extension [extension] ... -None server config virtual host @@ -259,6 +269,7 @@ Content-Type: text/plain; charset=ISO-8859-2 mod_negotiation +AddDefaultCharset @@ -268,7 +279,6 @@ Content-Type: text/plain; charset=ISO-8859-2 to the specified encoding type AddEncoding MIME-enc extension [extension] ... -None server config virtual host @@ -322,12 +332,10 @@ Content-Type: text/plain; charset=ISO-8859-2 AddHandler -AddHandler maps the filename extensions -to the handler -handler-name +Maps the filename extensions +to the specified handler AddHandler handler-name extension [extension] ... -None server config virtual host @@ -357,17 +365,18 @@ to the handler Files with multiple extensions +Handlers +SetHandler AddInputFilter -Maps the filename extensions - to the filter or filters which will process +Maps filename extensions + to the filters that will process client requests AddInputFilter filter[;filter...] extension [extension ...] -None server config virtual host @@ -398,6 +407,7 @@ to the handler Filters documentation. +SetInputFilter @@ -408,7 +418,6 @@ to the handler to the specified content language AddLanguage MIME-lang extension [extension] ... -None server config virtual host @@ -473,7 +482,6 @@ responses from the server AddOutputFilter filter[;filter...] extension [extension ...] -None server config virtual host @@ -511,7 +519,7 @@ responses from the server Filters documentation - +SetOutputFilter @@ -520,7 +528,6 @@ responses from the server onto the specified content type AddType MIME-type extension [extension] ... -None server config virtual host @@ -559,13 +566,15 @@ onto the specified content type Files with multiple extensions +DefaultType MultiviewsMatch +The types of files that will be included when +searching for a matching file with MultiViews MultiviewsMatch [NegotiatedOnly] [Handlers] [Filters] [Any] -None server config virtual host @@ -573,7 +582,7 @@ onto the specified content type .htaccess FileInfo -only available +Available in Apache 2.0.26 and later. @@ -603,6 +612,8 @@ onto the specified content type and can cause unpredicatable results, such as serving .old or .bak files the webmaster never expected to be served.

     +mod_negotiation +Options     @@ -611,7 +622,6 @@ onto the specified content type specified language DefaultLanguage MIME-lang -None server config virtual host @@ -650,9 +660,10 @@ specified language RemoveCharset +Removes any character set associations for a set of file +extensions RemoveCharset extension [extension] ... -None directory .htaccess @@ -674,9 +685,10 @@ specified language RemoveEncoding +Removes any content encoding associations for a set of file +extensions RemoveEncoding extension [extension] ... -None directory .htaccess @@ -722,9 +734,10 @@ specified language RemoveHandler +Removes any handler associations for a set of file +extensions RemoveHandler extension [extension] ... -None directory .htaccess @@ -766,9 +779,10 @@ specified language RemoveInputFilter +Removes any input filter associations for a set of file +extensions RemoveInputFilter extension [extension] ... -None directory .htaccess @@ -791,9 +805,10 @@ specified language RemoveLanguage +Removes any language associations for a set of file +extensions RemoveLanguage extension [extension] ... -None directory .htaccess @@ -817,9 +832,10 @@ specified language RemoveOutputFilter +Removes any output filter associations for a set of file +extensions RemoveOutputFilter extension [extension] ... - directory .htaccess @@ -844,9 +860,10 @@ specified language RemoveType +Removes any content type associations for a set of file +extensions RemoveType extension [extension] ... - directory .htaccess @@ -890,6 +907,7 @@ specified language TypesConfig +The location of the mime.types file TypesConfig file-path TypesConfig conf/mime.types