svn commit: r919222 - /incubator/trafficserver/site/trunk/docs/v2/admin/files.htm

[ml...@apache.org]

Author: mlibbey
Date: Thu Mar  4 22:41:55 2010
New Revision: 919222

URL: http://svn.apache.org/viewvc?rev=919222&view=rev
Log:
Add Plugin Chaining description

Modified:
    incubator/trafficserver/site/trunk/docs/v2/admin/files.htm

Modified: incubator/trafficserver/site/trunk/docs/v2/admin/files.htm
URL: http://svn.apache.org/viewvc/incubator/trafficserver/site/trunk/docs/v2/admin/files.htm?rev=919222&r1=919221&r2=919222&view=diff
==============================================================================
--- incubator/trafficserver/site/trunk/docs/v2/admin/files.htm (original)
+++ incubator/trafficserver/site/trunk/docs/v2/admin/files.htm Thu Mar  4 22:41:55 2010
@@ -2690,7 +2690,7 @@
   
   
   <h4>
-    <a name="regex_support">Regular Expression Support</a><a class="moz-txt-link-freetext" href="http://new.$1.z.com"></a></h4>
+    <a name="regex_support">Regular Expression Support</a></h4>
 <p>Regular expressions can be specified in remapping rules, with the limitations below:</p><ul><li>Only the <code>host</code> field can contain regexes; the <code>scheme</code>, <code>port</code>, and other fields cannot.  For path manipulation via regexes, use the <code>regex_remap</code> plugin. </li>
        <li>The number of capturing subpatterns is limited to 9. This means that <code>$0</code> thru <code>$9</code> can be used as subtraction placeholders (<code>$0</code> will be the entire input string).</li>
        <li>The number of substitutions in the expansion string is limited to 10.</li>
@@ -2699,8 +2699,15 @@
     Examples</h4>
   <p><code>regex_map http://x ([0-9]+).z.com http://real-x$1.z.com</code><br />
   <code>regex_redirect http://old.(.*).z.com http://new.$1.z.com</code></p>
-<h2>
-  <a name="splitdns.config">splitdns.config</a></h2>
+
+<h4><a name="plugin_chaining">Plugin Chaining</a></h4>
+<p>Plugins can be configured to be evaluated in a specific order, passing the results from one in to the next (unless a plugin returns 0, then the "chain" is broken).</p>
+<h4>Examples</h4>
+<p><code>map http://url/path http://url/path @plugin=/etc/traffic_server/config/plugins/plugin1.so @pparam=1 @pparam=2 @plugin=/etc/traffic_server/config/plugins/plugin2.so @pparam=3</code><br>
+will pass "1" and "2" to plugin1.so and "3" to plugin2.so.</p>
+
+This will pass "1" and "2" to plugin1.so and "3" to plugin2.so 
+<h2><a name="splitdns.config">splitdns.config</a></h2>
      <p>The <code>splitdns.config</code> file enables you to specify the DNS server that Traffic Server should use for resolving hosts under specific conditions.  For more information, refer to <a href="secure.htm">Configuring DNS Server Selection (Split DNS)</a>. </p>
   <p>To specify a DNS server, you must supply the following information in each active line within the file: </p>
      <ul>