You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by tr...@apache.org on 2002/06/26 21:54:54 UTC
cvs commit: httpd-2.0/docs/manual/mod mod_ext_filter.html.en mod_ext_filter.xml
trawick 2002/06/26 12:54:54
Modified: docs/manual/mod mod_ext_filter.html.en mod_ext_filter.xml
Log:
add another example filter, try to clarify how parameters to the filter
program are specified
Revision Changes Path
1.3 +23 -3 httpd-2.0/docs/manual/mod/mod_ext_filter.html.en
Index: mod_ext_filter.html.en
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_ext_filter.html.en,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- mod_ext_filter.html.en 28 May 2002 07:35:00 -0000 1.2
+++ mod_ext_filter.html.en 26 Jun 2002 19:54:53 -0000 1.3
@@ -2,9 +2,9 @@
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
- --><title>mod_ext_filter- Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_ext_filter</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td>Pass the response body
+ --><title>mod_ext_filter- Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mod_ext_filter</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap" valign="top"><span class="help">Description:</span></td><td>Pass the response body
through an external program before delivery to the
- client</td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>ext_filter_module</td></tr></table></td></tr></table><h2>Summary</h2>
+ client</td></tr><tr><td nowrap="nowrap"><a href="module-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td nowrap="nowrap"><a href="module-dict.html#ModuleIdentifier" class="help">Module Identifier:</a></td><td>ext_filter_module</td></tr></table></td></tr></table><h2>Summary</h2>
<p>This is an <strong>experimental</strong> module and should
be used with care. Test your <code><a href="mod_ext_filter.html">mod_ext_filter</a></code>
configuration carefully to ensure that it performs the desired
@@ -105,6 +105,24 @@
</code></td></tr></table></blockquote>
+<h3>Using sed to replace text in the response</h3>
+<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
+<pre>
+ # mod_ext_filter directive to define a filter which replaces text in
+ # the response
+ ExtFilterDefine fixtext mode=output cmd="/bin/sed s/verdana/arial/g" intype=text/html
+
+ <Location />
+
+ # core directive to cause the fixtext filter to be run on output
+ # output
+ SetOutputFilter fixtext
+
+ </Location>
+</pre>
+</code></td></tr></table></blockquote>
+
+
<hr/><h2><a name="ExtFilterDefine">ExtFilterDefine</a> <a name="extfilterdefine">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td nowrap="nowrap"><strong>Description: </strong></td><td/></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>ExtFilterDefine <em>filtername</em> <em>parameters</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>Experimental</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mod_ext_filter</td></tr></table></td></tr></table>
<p>The <code class="directive">ExtFilterDefine</code> directive defines the
characteristics of an external filter, including the program to
@@ -128,7 +146,9 @@
<dd>The <code>cmd=</code> keyword allows you to specify the
external command to run. If there are arguments after the
program name, the command line should be surrounded in
- quotation marks.</dd>
+ quotation marks (e.g., <em>cmd="/bin/mypgm arg1 arg2"</em>.
+ Normal shell quoting is not necessary since the program is
+ run directly, bypassing the shell.</dd>
<dt>mode=<em>mode</em></dt>
1.3 +21 -1 httpd-2.0/docs/manual/mod/mod_ext_filter.xml
Index: mod_ext_filter.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_ext_filter.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- mod_ext_filter.xml 23 May 2002 14:50:11 -0000 1.2
+++ mod_ext_filter.xml 26 Jun 2002 19:54:53 -0000 1.3
@@ -114,6 +114,24 @@
</example>
</section>
+<section><title>Using sed to replace text in the response</title>
+<example>
+<pre>
+ # mod_ext_filter directive to define a filter which replaces text in
+ # the response
+ ExtFilterDefine fixtext mode=output cmd="/bin/sed s/verdana/arial/g" intype=text/html
+
+ <Location />
+
+ # core directive to cause the fixtext filter to be run on output
+ # output
+ SetOutputFilter fixtext
+
+ </Location>
+</pre>
+</example>
+</section>
+
</section> <!-- Examples -->
<directivesynopsis>
@@ -144,7 +162,9 @@
<dd>The <code>cmd=</code> keyword allows you to specify the
external command to run. If there are arguments after the
program name, the command line should be surrounded in
- quotation marks.</dd>
+ quotation marks (e.g., <em>cmd="/bin/mypgm arg1 arg2"</em>.
+ Normal shell quoting is not necessary since the program is
+ run directly, bypassing the shell.</dd>
<dt>mode=<em>mode</em></dt>