mod_charset_lite.html.en revision 8574d86b9ec3be36b7f54ed0547a0ee5d60dbd6b
0066eddda7203f6345b56f77d146a759298dc635gryzor<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
0066eddda7203f6345b56f77d146a759298dc635gryzor<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0066eddda7203f6345b56f77d146a759298dc635gryzor This file is generated from xml source: DO NOT EDIT
0066eddda7203f6345b56f77d146a759298dc635gryzor XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0066eddda7203f6345b56f77d146a759298dc635gryzor<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
0066eddda7203f6345b56f77d146a759298dc635gryzor<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
0066eddda7203f6345b56f77d146a759298dc635gryzor<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
0066eddda7203f6345b56f77d146a759298dc635gryzor<link href="/images/favicon.ico" rel="shortcut icon" /></head>
0066eddda7203f6345b56f77d146a759298dc635gryzor<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
0066eddda7203f6345b56f77d146a759298dc635gryzor<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
0066eddda7203f6345b56f77d146a759298dc635gryzor<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">Modules</a></div>
0066eddda7203f6345b56f77d146a759298dc635gryzor<div id="preamble"><h1>Apache Module mod_charset_lite</h1>
0066eddda7203f6345b56f77d146a759298dc635gryzor<p><span>Available Languages: </span><a href="/en/mod/mod_charset_lite.html"> en </a> | <a href="/ko/mod/mod_charset_lite.html"> ko </a></p>
0066eddda7203f6345b56f77d146a759298dc635gryzor<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Specify character set translation or recoding</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>charset_lite_module</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_charset_lite.c</td></tr></table>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>This is an <strong>experimental</strong> module and should
0066eddda7203f6345b56f77d146a759298dc635gryzor be used with care. Experiment with your
0066eddda7203f6345b56f77d146a759298dc635gryzor <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> configuration to ensure that it
0066eddda7203f6345b56f77d146a759298dc635gryzor performs the desired function.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p><code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> allows the administrator to
e2f05529a1835546e17527f56074c023e6a47366lgentis specify the source character set of objects as well as the
e2f05529a1835546e17527f56074c023e6a47366lgentis character set they should be translated into before sending to the
e2f05529a1835546e17527f56074c023e6a47366lgentis client. <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> does not translate the
e2f05529a1835546e17527f56074c023e6a47366lgentis data itself but instead tells Apache what translation to
e2f05529a1835546e17527f56074c023e6a47366lgentis perform. <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> is applicable to EBCDIC
0066eddda7203f6345b56f77d146a759298dc635gryzor and ASCII host environments. In an EBCDIC environment, Apache
ac64493966b7b75e373c78e99b8e5e86fc954d72lgentis normally translates text content from the code page of the Apache
0066eddda7203f6345b56f77d146a759298dc635gryzor process locale to ISO-8859-1. <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code>
0066eddda7203f6345b56f77d146a759298dc635gryzor can be used to specify that a different translation is to be
0066eddda7203f6345b56f77d146a759298dc635gryzor performed. In an ASCII environment, Apache normally performs no
0066eddda7203f6345b56f77d146a759298dc635gryzor translation, so <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> is needed in
e2f05529a1835546e17527f56074c023e6a47366lgentis order for any translation to take place.</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis <p>This module provides a small subset of configuration
e2f05529a1835546e17527f56074c023e6a47366lgentis mechanisms implemented by Russian Apache and its associated
0066eddda7203f6345b56f77d146a759298dc635gryzor<div id="quickview"><h3 class="directives">Directives</h3>
0066eddda7203f6345b56f77d146a759298dc635gryzor<li><img alt="" src="/images/down.gif" /> <a href="#charsetdefault">CharsetDefault</a></li>
0066eddda7203f6345b56f77d146a759298dc635gryzor<li><img alt="" src="/images/down.gif" /> <a href="#charsetoptions">CharsetOptions</a></li>
0066eddda7203f6345b56f77d146a759298dc635gryzor<li><img alt="" src="/images/down.gif" /> <a href="#charsetsourceenc">CharsetSourceEnc</a></li>
0066eddda7203f6345b56f77d146a759298dc635gryzor<li><img alt="" src="/images/down.gif" /> <a href="#problems">Common Problems</a></li>
0066eddda7203f6345b56f77d146a759298dc635gryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
0066eddda7203f6345b56f77d146a759298dc635gryzor<h2><a name="problems" id="problems">Common Problems</a></h2>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>The character set name parameters of <code class="directive"><a href="#charsetsourceenc">CharsetSourceEnc</a></code> and
0066eddda7203f6345b56f77d146a759298dc635gryzor <code class="directive"><a href="#charsetdefault">CharsetDefault</a></code>
0066eddda7203f6345b56f77d146a759298dc635gryzor must be acceptable to the translation mechanism used by APR on the
0066eddda7203f6345b56f77d146a759298dc635gryzor system where <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> is deployed. These
0066eddda7203f6345b56f77d146a759298dc635gryzor character set names are not standardized and are usually not the
0066eddda7203f6345b56f77d146a759298dc635gryzor same as the corresponding values used in http headers. Currently,
0066eddda7203f6345b56f77d146a759298dc635gryzor APR can only use iconv(3), so you can easily test your character
0066eddda7203f6345b56f77d146a759298dc635gryzor set names using the iconv(1) program, as follows:</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis iconv -f charsetsourceenc-value -t charsetdefault-value
e2f05529a1835546e17527f56074c023e6a47366lgentis <h3>Mismatch between character set of content and translation
e2f05529a1835546e17527f56074c023e6a47366lgentis <p>If the translation rules don't make sense for the content,
e2f05529a1835546e17527f56074c023e6a47366lgentis translation can fail in various ways, including:</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>The translation mechanism may return a bad return code,
0066eddda7203f6345b56f77d146a759298dc635gryzor and the connection will be aborted.</li>
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>The translation mechanism may silently place special
0066eddda7203f6345b56f77d146a759298dc635gryzor characters (e.g., question marks) in the output buffer when
0066eddda7203f6345b56f77d146a759298dc635gryzor it cannot translate the input buffer.</li>
0066eddda7203f6345b56f77d146a759298dc635gryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
0066eddda7203f6345b56f77d146a759298dc635gryzor<div class="directive-section"><h2><a name="CharsetDefault" id="CharsetDefault">CharsetDefault</a> <a name="charsetdefault" id="charsetdefault">Directive</a></h2>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Charset to translate into</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CharsetDefault <var>charset</var></code></td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_charset_lite</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>The <code class="directive">CharsetDefault</code> directive specifies the
0066eddda7203f6345b56f77d146a759298dc635gryzor charset that content in the associated container should be
0066eddda7203f6345b56f77d146a759298dc635gryzor translated to.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>The value of the <var>charset</var> argument must be accepted
0066eddda7203f6345b56f77d146a759298dc635gryzor as a valid character set name by the character set support in
0066eddda7203f6345b56f77d146a759298dc635gryzor APR. Generally, this means that it must be supported by
0066eddda7203f6345b56f77d146a759298dc635gryzor <Directory /export/home/trawick/apacheinst/htdocs/convert><br />
0066eddda7203f6345b56f77d146a759298dc635gryzor CharsetSourceEnc UTF-16BE<br />
8194a1b0db760af7e588c1bad92a1d933d39886elgentis CharsetDefault ISO-8859-1<br />
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis </Directory>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<div class="directive-section"><h2><a name="CharsetOptions" id="CharsetOptions">CharsetOptions</a> <a name="charsetoptions" id="charsetoptions">Directive</a></h2>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configures charset translation behavior</td></tr>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CharsetOptions <var>option</var> [<var>option</var>] ...</code></td></tr>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>CharsetOptions DebugLevel=0 NoImplicitAdd</code></td></tr>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_charset_lite</td></tr>
8194a1b0db760af7e588c1bad92a1d933d39886elgentis <p>The <code class="directive">CharsetOptions</code> directive configures certain
0066eddda7203f6345b56f77d146a759298dc635gryzor behaviors of <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code>. <var>Option</var> can
0066eddda7203f6345b56f77d146a759298dc635gryzor be one of</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <dd>The <code>DebugLevel</code> keyword allows you to specify
0066eddda7203f6345b56f77d146a759298dc635gryzor the level of debug messages generated by
0066eddda7203f6345b56f77d146a759298dc635gryzor <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code>. By default, no messages are
0066eddda7203f6345b56f77d146a759298dc635gryzor generated. This is equivalent to <code>DebugLevel=0</code>.
0066eddda7203f6345b56f77d146a759298dc635gryzor With higher numbers, more debug messages are generated, and
0066eddda7203f6345b56f77d146a759298dc635gryzor server performance will be degraded. The actual meanings of
0066eddda7203f6345b56f77d146a759298dc635gryzor the numeric values are described with the definitions of the
0066eddda7203f6345b56f77d146a759298dc635gryzor DBGLVL_ constants near the beginning of
0066eddda7203f6345b56f77d146a759298dc635gryzor <dd>The <code>ImplicitAdd</code> keyword specifies that
0066eddda7203f6345b56f77d146a759298dc635gryzor <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code> should implicitly insert its
0066eddda7203f6345b56f77d146a759298dc635gryzor filter when the configuration specifies that the character
0066eddda7203f6345b56f77d146a759298dc635gryzor set of content should be translated. If the filter chain is
0066eddda7203f6345b56f77d146a759298dc635gryzor explicitly configured using the <code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> directive, <code>NoImplicitAdd</code>
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis should be specified so that <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code>
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis doesn't add its filter.</dd>
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
0066eddda7203f6345b56f77d146a759298dc635gryzor<div class="directive-section"><h2><a name="CharsetSourceEnc" id="CharsetSourceEnc">CharsetSourceEnc</a> <a name="charsetsourceenc" id="charsetsourceenc">Directive</a></h2>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Source charset of files</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CharsetSourceEnc <var>charset</var></code></td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_charset_lite</td></tr>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>The <code class="directive">CharsetSourceEnc</code> directive specifies the
0066eddda7203f6345b56f77d146a759298dc635gryzor source charset of files in the associated container.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>The value of the <var>charset</var> argument must be accepted
0066eddda7203f6345b56f77d146a759298dc635gryzor as a valid character set name by the character set support in
0066eddda7203f6345b56f77d146a759298dc635gryzor APR. Generally, this means that it must be supported by
0066eddda7203f6345b56f77d146a759298dc635gryzor <Directory /export/home/trawick/apacheinst/htdocs/convert><br />
e2f05529a1835546e17527f56074c023e6a47366lgentis CharsetSourceEnc UTF-16BE<br />
7ddfde8cc1587a70759084db65c83a02e51380d1lgentis CharsetDefault ISO-8859-1<br />
e2f05529a1835546e17527f56074c023e6a47366lgentis </Directory>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>The character set names in this example work with the iconv
0066eddda7203f6345b56f77d146a759298dc635gryzor translation support in Solaris 8.</p>
<p><span>Available Languages: </span><a href="/en/mod/mod_charset_lite.html"> en </a> | <a href="/ko/mod/mod_charset_lite.html"> ko </a></p>
<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>