From: Rich Bowen <rbowen@apache.org>
Date: Wed, 20 May 2026 20:02:21 +0000 (+0000)
Subject: mod_dav: Document DavHonorMtimeHeader directive
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=31ea075d61d6de6542ff44cd3aa1e66db1d087bf;p=thirdparty%2Fapache%2Fhttpd.git

mod_dav: Document DavHonorMtimeHeader directive

When enabled, allows WebDAV clients to set resource modification
times via the X-OC-Mtime request header on PUT and MKCOL requests.

Resolves: bz#70054

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1934445 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_dav.xml b/docs/manual/mod/mod_dav.xml
index 7f95512abe..a94a246ca0 100644
--- a/docs/manual/mod/mod_dav.xml
+++ b/docs/manual/mod/mod_dav.xml
@@ -286,6 +286,51 @@ a DAV resource</description>
 </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>DavHonorMtimeHeader</name>
+<description>Allow clients to set resource modification times via the
+X-OC-Mtime request header</description>
+<syntax>DavHonorMtimeHeader on|off</syntax>
+<default>DavHonorMtimeHeader off</default>
+<contextlist><context>directory</context></contextlist>
+
+<usage>
+    <p>The <directive>DavHonorMtimeHeader</directive> directive controls
+    whether <module>mod_dav</module> will honor the
+    <code>X-OC-Mtime</code> request header when processing
+    <code>PUT</code> and <code>MKCOL</code> requests. This header
+    is used by some WebDAV sync clients to preserve the
+    original modification time of uploaded files.</p>
+
+    <p>When enabled, if a client sends a <code>PUT</code> or
+    <code>MKCOL</code> request with an <code>X-OC-Mtime</code>
+    header, the server will set the resource's modification time to
+    the value specified in that header. The header value must be a
+    Unix timestamp (seconds since epoch), expressed as a decimal
+    integer.</p>
+
+    <p>If the header is present but malformed (contains non-digit
+    characters), the server will respond with a 400 Bad Request
+    error.</p>
+
+    <note type="warning">
+    <p>Enabling this directive allows clients to manipulate file
+    modification times on the server. Only enable it in locations
+    where clients are trusted, and always protect access with
+    authentication.</p>
+    </note>
+
+    <example><title>Example</title>
+    <highlight language="config">
+&lt;Directory "/var/www/dav/sync"&gt;
+    Dav On
+    DavHonorMtimeHeader on
+&lt;/Directory&gt;
+    </highlight>
+    </example>
+</usage>
+</directivesynopsis>
+
 </modulesynopsis>