mod_sed.html.en revision 4aa603e6448b99f9371397d439795c91a93637ea
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<?xml version="1.0" encoding="ISO-8859-1"?>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering This file is generated from xml source: DO NOT EDIT
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<title>mod_sed - Apache HTTP Server</title>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<script src="/style/scripts/prettify.min.js" type="text/javascript">
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<link href="/images/favicon.ico" rel="shortcut icon" /></head>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p class="apache">Apache HTTP Server Version 2.5</p>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<img alt="" src="/images/feather.gif" /></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div id="preamble"><h1>Apache Module mod_sed</h1>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p><span>Available Languages: </span><a href="/en/mod/mod_sed.html" title="English"> en </a> |
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<a href="/fr/mod/mod_sed.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a></p>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Filter Input (request) and Output (response) content using <code>sed</code> syntax</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>sed_module</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.3 and later</td></tr></table>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> is an in-process content filter. The <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> filter implements the <code>sed</code> editing
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringcommands implemented by the Solaris 10 <code>sed</code>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringprogram as described in the <a href="http://www.gnu.org/software/sed/manual/sed.txt">manual
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringpage</a>. However, unlike <code>sed</code>, <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> doesn't take data from
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringinput. Instead, the filter acts on the entity data sent between client and
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringserver. <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> can be used as an input or output filter. <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> is a
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringcontent filter, which means that it cannot be used to modify client or
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringserver http headers.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart PoetteringThe <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> output filter accepts a chunk of data, executes the <code>sed</code> scripts on the data, and generates the output which is passed to the next filter in the chain.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart PoetteringThe <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code> input filter reads the data from the next filter in the chain, executes the <code>sed</code> scripts, and returns the generated data to the caller filter in the filter chain.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart PoetteringBoth the input and output filters only process the data if newline characters are seen in the content. At the end of the data, the rest of the data is treated as the last line.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p>A tutorial article on <code class="module"><a href="/mod/mod_sed.html">mod_sed</a></code>, and why it is more powerful than simple
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringstring or regular expression search and replace, is available <a href="https://blogs.oracle.com/basant/entry/using_mod_sed_to_filter">on
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div id="quickview"><h3 class="directives">Directives</h3>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#inputsed">InputSed</a></li>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#outputsed">OutputSed</a></li>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#sampleconf">Sample Configuration</a></li>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<li><img alt="" src="/images/down.gif" /> <a href="#sed_commands">Sed Commands</a></li>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<h2><a name="sampleconf" id="sampleconf">Sample Configuration</a></h2>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <div class="example"><h3>Adding an output filter </h3><pre class="prettyprint lang-config"># In the following example, the sed filter will change the string
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering# "monday" to "MON" and the string "sunday" to SUN in html documents
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering# before sending to the client.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering AddOutputFilter Sed html
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering</Directory></pre>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <div class="example"><h3>Adding an input filter </h3><pre class="prettyprint lang-config"># In the following example, the sed filter will change the string
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering# "monday" to "MON" and the string "sunday" to SUN in the POST data
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering AddInputFilter Sed php
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering</Directory></pre>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<h2><a name="sed_commands" id="sed_commands">Sed Commands</a></h2>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering Complete details of the <code>sed</code> command can be found from the
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <a href="http://www.gnu.org/software/sed/manual/sed.txt">sed manual
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <dd>Branch to the label specified (similar to goto).</dd>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <dd>Copy the current line to the hold buffer.</dd>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <dd>Append the current line to the hold buffer.</dd>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <dd>Copy the hold buffer to the current line.</dd>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <dd>Append the hold buffer to the current line.</dd>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <dd>Swap the contents of the hold buffer and the current line.</dd>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div class="directive-section"><h2><a name="InputSed" id="InputSed">InputSed</a> <a name="inputsed" id="inputsed">Directive</a></h2>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sed command to filter request data (typically <code>POST</code> data)</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>InputSed <var>sed-command</var></code></td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_sed</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <p>The <code class="directive">InputSed</code> directive specifies the <code>sed</code> command
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering to execute on the request data e.g., <code>POST</code> data.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<div class="directive-section"><h2><a name="OutputSed" id="OutputSed">OutputSed</a> <a name="outputsed" id="outputsed">Directive</a></h2>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sed command for filtering response content</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>OutputSed <var>sed-command</var></code></td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Experimental</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_sed</td></tr>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering <p>The <code class="directive">OutputSed</code> directive specifies the <code>sed</code>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering command to execute on the response.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p><span>Available Languages: </span><a href="/en/mod/mod_sed.html" title="English"> en </a> |
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<a href="/fr/mod/mod_sed.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a></p>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<script type="text/javascript"><!--//--><![CDATA[//><!--
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringvar comments_shortname = 'httpd';
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringvar comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_sed.html';
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering(function(w, d) {
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering d.write('<div id="comments_thread"><\/div>');
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering var s = d.createElement('script');
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering})(window, document);
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering//--><!]]></script></div><div id="footer">
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poetteringif (typeof(prettyPrint) !== 'undefined') {
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering prettyPrint();