mod_charset_lite.html revision dff77f20d3ca0296e740d4369989e57949a06e92
2454dfa32c93c20a8522c6ed42fe057baaac9f9aStephan Bosch<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<HTML>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <HEAD>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <TITLE>Apache module mod_charset_lite</TITLE>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen </HEAD>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BODY
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen BGCOLOR="#FFFFFF"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen TEXT="#000000"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen LINK="#0000FF"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen VLINK="#000080"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen ALINK="#FF0000"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen >
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen<!--#include virtual="header.html" -->
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <H1 ALIGN="CENTER">Module mod_charset_lite</H1>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<p>This module provides the ability to specify character set
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen translation or recoding.</p>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<P><A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo SirainenHREF="module-dict.html#Status"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo SirainenREL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen><STRONG>Status:</STRONG></A> Experimental
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo SirainenHREF="module-dict.html#SourceFile"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo SirainenREL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen><STRONG>Source File:</STRONG></A> mod_charset_lite.c
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen<A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo SirainenHREF="module-dict.html#ModuleIdentifier"
5da08ab71623953f248b24a21d45b02555bbb24bTimo SirainenREL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen><STRONG>Module Identifier:</STRONG></A> charset_lite_module
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen</P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <H2>Summary</H2>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen This is an <STRONG>experimental</STRONG> module and should be used with
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen care. Experiment with your <CODE>mod_charset_lite</CODE> configuration to
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ensure that it performs the desired function.
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen </P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <CODE>mod_charset_lite</CODE> allows the administrator to specify the
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen source character set of objects as well as the character set they should
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen be translated into before sending to the client.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <CODE>mod_charset_lite</CODE> does not translate the data itself but
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen instead tells Apache what translation to perform.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <CODE>mod_charset_lite</CODE> is applicable to EBCDIC and ASCII
d861bc0977b229cdaeb3fb77377e2a2bd9d40d3dTimo Sirainen host environments. In an EBCDIC environment, Apache normally translates
661998e2ccd772ad92a9d4a75cb712692a8c94b3Timo Sirainen text content from the code page of the Apache process locale to
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi ISO-8859-1. <CODE>mod_charset_lite</CODE> can be used to specify that
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen a different translation is to be performed. In an ASCII environment,
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen Apache normally performs no translation, so <CODE>mod_charset_lite</CODE>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen is needed in order for any translation to take place.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </P>
f39a06c378f6ea80a4ae9d257f0d79221a945a57Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <p>This module will only work if <code>APACHE_XLATE</code> is defined
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen at compile time.</p>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen This module provides a small subset of configuration mechanisms
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen implemented by Russian Apache and its associated <CODE>mod_charset</CODE>.
d861bc0977b229cdaeb3fb77377e2a2bd9d40d3dTimo Sirainen </P>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <H2>Directives</H2>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi <UL>
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <LI><A HREF="#charsetsourceenc">CharsetSourceEnc</A>
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <LI><A HREF="#charsetdefault">CharsetDefault</A>
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <LI><A HREF="#charsetoptions">CharsetOptions</A>
d861bc0977b229cdaeb3fb77377e2a2bd9d40d3dTimo Sirainen </LI>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </UL>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <H2>Common Problems</H2>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <H3>Invalid character set names</H3>
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi
cf41318871bd42358df3420e50614f5310b08c77Martti Rannanjärvi <P>
d861bc0977b229cdaeb3fb77377e2a2bd9d40d3dTimo Sirainen The character set name parameters of CharsetSourceEnc and CharsetDefault
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen must be acceptable to the translation mechanism used by APR on the system
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi where mod_charset_lite is deployed. These character set names are not
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi standardized and are usually not the same as the corresponding values used
2e07e3182f355cf04a1461dd7f893d0ebc818764Timo Sirainen in http headers. Currently, APR can only use iconv(3), so you can easily
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen test your character set names using the iconv(1) program, as follows:
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen </P>
d861bc0977b229cdaeb3fb77377e2a2bd9d40d3dTimo Sirainen
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi <PRE>
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen iconv -f charsetsourceenc-value -t charsetdefault-value
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi </PRE>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi <H3>Mismatch between character set of content and translation rules</H3>
d861bc0977b229cdaeb3fb77377e2a2bd9d40d3dTimo Sirainen
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi <P>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi If the translation rules don't make sense for the content, translation
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen can fail in various ways, including:
47a5a7e8296f3b8f2fac9a0659d4de3f2723ba4aMartti Rannanjärvi </P>
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi <UL>
bb11a1957aefbd2a2edf7ae25af4032899c34c41Martti Rannanjärvi <LI>
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen The translation mechanism may return a bad return code, and the connection
47a5a7e8296f3b8f2fac9a0659d4de3f2723ba4aMartti Rannanjärvi will be aborted.
a022e47f45597650f71f00c3af3fa783982a65adTimo Sirainen <LI>
661998e2ccd772ad92a9d4a75cb712692a8c94b3Timo Sirainen The translation mechanism may silently place special characters (e.g., question
661998e2ccd772ad92a9d4a75cb712692a8c94b3Timo Sirainen marks) in the output buffer when it cannot translate the input buffer.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </UL>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <HR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <H2><A NAME="charsetsourceenc">CharsetSourceEnc</A></H2>
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <P>
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <A
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen HREF="directive-dict.html#Syntax"
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen REL="Help"
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen ><STRONG>Syntax:</STRONG></A> CharsetSourceEnc <EM>charset</EM>
0d1b8b6bec79746c5d89d57dd8c1688946bd9237Josef 'Jeff' Sipek <BR>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <A
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen HREF="directive-dict.html#Default"
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen REL="Help"
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen ><STRONG>Default:</STRONG></A> <EM>None</EM>
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <BR>
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <A
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen HREF="directive-dict.html#Context"
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen REL="Help"
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen ><STRONG>Context:</STRONG></A> directory, virtual host
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <BR>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <A
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen HREF="directive-dict.html#Override"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen REL="Help"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen ><STRONG>Override:</STRONG></A> <EM>FileInfo</EM>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <BR>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <A
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen HREF="directive-dict.html#Status"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen REL="Help"
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen ><STRONG>Status:</STRONG></A> Experimental
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <BR>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Module"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Module:</STRONG></A> mod_charset_lite
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen The <CODE>CharsetSourceEnc</CODE> directive specifies the source charset
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen of files in the associated container.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen The value of the <EM>charset</EM> argument must be accepted as a valid
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen character set name by the character set support in APR. Generally, this
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen means that it must be supported by iconv.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </P>
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen Example:
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <PRE>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen &lt;Directory "/export/home/trawick/apacheinst/htdocs/convert"&gt;
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen CharsetSourceEnc UTF-16BE
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen CharsetDefault ISO8859-1
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen &lt;/Directory&gt;
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </PRE>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen The character set names in this example work with the iconv
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen translation support in Solaris 8.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
5de0c65da362236080fa699af3da03e45e480ab8Timo Sirainen<hr>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <H2><A NAME="charsetdefault">CharsetDefault</A></H2>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Syntax"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Syntax:</STRONG></A> CharsetDefault <EM>charset</EM>
8705e45564a2e87d32bd825e0e997a8177846f77Timo Sirainen <BR>
588a0579058849aed9f7b59d8259e0c58d9fd23cTimo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Default"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Default:</STRONG></A> <EM>None</EM>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Context"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Context:</STRONG></A> directory, virtual host
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Override"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Override:</STRONG></A> <EM>FileInfo</EM>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Status"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Status:</STRONG></A> Experimental
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Module"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Module:</STRONG></A> mod_charset_lite
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen The <CODE>CharsetDefault</CODE> directive specifies the charset that
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen content in the associated container should be translated to.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen The value of the <EM>charset</EM> argument must be accepted as a valid
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen character set name by the character set support in APR. Generally, this
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen means that it must be supported by iconv.
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen </P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen Example:
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <PRE>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen &lt;Directory "/export/home/trawick/apacheinst/htdocs/convert"&gt;
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen CharsetSourceEnc UTF-16BE
0d1d485939b9b7f1a0f588aea40c504e3d26e35bJ. Nick Koston CharsetDefault ISO8859-1
0d1d485939b9b7f1a0f588aea40c504e3d26e35bJ. Nick Koston &lt;/Directory&gt;
0d1d485939b9b7f1a0f588aea40c504e3d26e35bJ. Nick Koston </PRE>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
efe78d3ba24fc866af1c79b9223dc0809ba26cadStephan Bosch<hr>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <H2><A NAME="charsetoptions">CharsetOptions</A></H2>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <P>
20e04227229970d148801c507946666e2a9bd838Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Syntax"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Syntax:</STRONG></A> CharsetOptions <EM>option</em>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen [<em>option</em>] ...
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Default"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Default:</STRONG></A> <EM>DebugLevel=0</EM> <EM>NoImplicitAdd</EM>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Context"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Context:</STRONG></A> directory, virtual host
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Override"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Override:</STRONG></A> <EM>FileInfo</EM>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Status"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Status:</STRONG></A> Experimental
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <BR>
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen <A
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen HREF="directive-dict.html#Module"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen REL="Help"
1f2f38f518ea14d1042c98ab039e6df053f7b285Timo Sirainen ><STRONG>Module:</STRONG></A> mod_charset_lite
<BR>
<P>
The <CODE>CharsetOptions</CODE> directive configures certain behaviors
of <CODE>mod_charset_lite</CODE>. <EM>Option</EM> can be one of
<DL>
<DT>DebugLevel=<EM>n</EM>
<DD>
The <SAMP>DebugLevel</SAMP> keyword allows you to specify the level of
debug messages generated by <CODE>mod_charset_lite</CODE>. By default, no
messages are generated. This is equivalent to <SAMP>DebugLevel=0</SAMP>.
With higher numbers, more debug messages are generated, and server
performance will be degraded. The actual meanings of the numeric values
are described with the definitions of the DBGLVL_ constants near the
beginning of <CODE>mod_charset_lite.c</CODE>.
<DT>ImplicitAdd | NoImplicitAdd
<DD>
The <SAMP>ImplicitAdd</SAMP> keyword specifies that
<CODE>mod_charset_lite</CODE> should implicitly insert its filter when
the configuration specifies that the character set of content should be
translated. If the filter chain is explicitly configured using the
AddOutputFilter directive, <SAMP>NoImplicitAdd</SAMP> should be specified so
that <CODE>mod_charset_lite</CODE> doesn't add its filter.
</DL>
</P>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>