mod_allowmethods.xml revision 135c1278adef96d36fd421c536b1acc54a341cfb
<?xml version="1.0"?>
<!-- $LastChangedRevision$ -->
<!--
Upon adding a new module XML doc, you will need to:
svn ps svn:eol-style native <alltextfiles>
svn ps svn:keywords LastChangedRevision mod_allowmethods.xml
in order for it to rebuild correctly.
-->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_allowmethods.xml.meta">
<name>mod_allowmethods</name>
<description>Easily restrict what HTTP methods can be used on the server</description>
<status>experimental</status>
<identifier>allowmethods_module</identifier>
<summary>
<p>This modules makes it easy to restrict what HTTP methods can
used on an server. The most common configuration would be:</p>
<example><title>Example</title>
<Directory /><br />
<indent>
AllowMethods GET HEAD OPTIONS<br />
</indent>
</Directory>
</example>
</summary>
<directivesynopsis>
<name>AllowMethods</name>
<description>Changes absolutely nothing</description>
<syntax>AllowMethods reset|<em>HTTP-method</em>
[<em>HTTP-method</em>]...</syntax>
<default>AllowMethods reset</default>
<contextlist><context>directory</context></contextlist>
<status>Experimental</status>
<usage>
<p>The HTTP-methods are case sensitive, and are generally as per
RFC given in upper case. The <code>reset</code> keyword can be used
turn off <module>mod_allowmethods</module> in a deeper nested context:</p>
<example><title>Example</title>
<Location /svn><br />
<indent>
AllowMethods reset<br />
</indent>
</Location>
</example>
<p><module>mod_allowmethods</module> was written to replace the rather
kludgy implementation of <directive module="core">Limit</directive> and
<directive module="core">LimitExcept</directive>.</p>
</usage>
</directivesynopsis>
</modulesynopsis>