diff options
author | Arno Töll <arno@debian.org> | 2013-12-23 23:50:09 -1100 |
---|---|---|
committer | Arno Töll <arno@debian.org> | 2013-12-23 23:50:09 -1100 |
commit | 86d5cc79d9d6750da8771fdb0c9ab22c19b8ad45 (patch) | |
tree | 5037da70bf37c0ee93f0ea09f054bdfb278befe0 /docs/manual/mod/mod_headers.html.en | |
parent | 4a336a5b117419c33c29eadd6409c69df78cd586 (diff) | |
download | apache2-86d5cc79d9d6750da8771fdb0c9ab22c19b8ad45.tar.gz |
Imported Upstream version 2.4.7upstream/2.4.7
Diffstat (limited to 'docs/manual/mod/mod_headers.html.en')
-rw-r--r-- | docs/manual/mod/mod_headers.html.en | 24 |
1 files changed, 20 insertions, 4 deletions
diff --git a/docs/manual/mod/mod_headers.html.en b/docs/manual/mod/mod_headers.html.en index 5cebddcd..1f403a01 100644 --- a/docs/manual/mod/mod_headers.html.en +++ b/docs/manual/mod/mod_headers.html.en @@ -216,7 +216,7 @@ Header merge Cache-Control no-store env=NO_STORE <div class="directive-section"><h2><a name="Header" id="Header">Header</a> <a name="header" id="header">Directive</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure HTTP response headers</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|unset +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>Header [<var>condition</var>] add|append|echo|edit|edit*|merge|set|unset|note <var>header</var> [<var>value</var>] [<var>replacement</var>] [early|env=[!]<var>variable</var>]|expr=<var>expression</var>] </code></td></tr> @@ -287,7 +287,7 @@ Header merge Cache-Control no-store env=NO_STORE <dd>If this response header exists, its value is transformed according to a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a> search-and-replace. The <var>value</var> argument is a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a>, and the <var>replacement</var> - is a replacement string, which may contain backreferences. + is a replacement string, which may contain backreferences or format specifiers. The <code>edit</code> form will match and replace exactly once in a header value, whereas the <code>edit*</code> form will replace <em>every</em> instance of the search pattern if it appears more @@ -307,10 +307,21 @@ Header merge Cache-Control no-store env=NO_STORE <dd>The response header is set, replacing any previous header with this name. The <var>value</var> may be a format string.</dd> + <dt><code>setifempty</code></dt> + <dd>The request header is set, but only if there is no previous header + with this name</dd> + <dt><code>unset</code></dt> <dd>The response header of this name is removed, if it exists. If there are multiple headers of the same name, all will be removed. <var>value</var> must be omitted.</dd> + + <dt><code>note</code></dt> + <dd>The value of the named response <var>header</var> is copied into an + internal note whose name is given by <var>value</var>. This is useful + if a header sent by a CGI or proxied resource is configured to be unset + but should also be logged.</dd> + </dl> <p>This argument is followed by a <var>header</var> name, which @@ -375,7 +386,8 @@ Header merge Cache-Control no-store env=NO_STORE <p>For <code>edit</code> there is both a <var>value</var> argument which is a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a>, - and an additional <var>replacement</var> string.</p> + and an additional <var>replacement</var> string.</p> As of version 2.4.7 + the replacement string may also contain format specifiers. <p>The <code class="directive">Header</code> directive may be followed by an additional argument, which may be any of:</p> @@ -439,7 +451,7 @@ Header merge Cache-Control no-store env=NO_STORE <dd>If this request header exists, its value is transformed according to a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a> search-and-replace. The <var>value</var> argument is a <a class="glossarylink" href="../glossary.html#regex" title="see glossary">regular expression</a>, and the <var>replacement</var> - is a replacement string, which may contain backreferences. + is a replacement string, which may contain backreferences or format specifiers. The <code>edit</code> form will match and replace exactly once in a header value, whereas the <code>edit*</code> form will replace <em>every</em> instance of the search pattern if it appears more @@ -458,6 +470,10 @@ Header merge Cache-Control no-store env=NO_STORE <dt><code>set</code></dt> <dd>The request header is set, replacing any previous header with this name</dd> + + <dt><code>setifempty</code></dt> + <dd>The request header is set, but only if there is no previous header + with this name</dd> <dt><code>unset</code></dt> <dd>The request header of this name is removed, if it exists. If |