Dav Directive

- - - - + + + diff --git a/docs/manual/sitemap.html.en b/docs/manual/sitemap.html.en index f99fa41dd6..d16e215df6 100644 --- a/docs/manual/sitemap.html.en +++ b/docs/manual/sitemap.html.en @@ -107,6 +107,7 @@ Server on HPUX

You may wish to add a <Limit> clause inside the <Location> directive to limit access to + DAV-enabled locations. If you want to set the maximum amount of + bytes that a DAV client can send at one request, you have to use + the LimitXMLRequestBody + directive. The "normal" LimitRequestBody directive has no effect on DAV + requests.

+ +

Full Example

+ DavLockDB /tmp/DavLock + + <Location /foo> + + Dav On + + AuthType Basic + AuthName DAV + AuthUserFile user.passwd + + <LimitExcept GET HEAD OPTIONS> + + require user admin + + </LimitExcept> + + </Location> +

+ +

Security

The use of HTTP Basic Authentication is not recommended. You + should use at least HTTP Digest Authentication, which is provided by + the mod_auth_digest module. Nearly all WebDAV clients + support this authentication method. Of course, Basic Authentication + over an SSL enabled connection is secure, + too.

Dav Directive

Description:	Enable WebDAV HTTP methods
Syntax: -	`Dav on\|off`
Default: -	`Dav off`
Context: +	`Dav On\|Off\|provider-name`
Default: +	`Dav Off`
Context:	directory
Status:	Extension
Module:	mod_dav

Use the Dav directive to enable the - WebDAV HTTP methods for the given container. You may wish to add a - <Limit> clause - inside the <location> directive to limit access to - DAV-enabled locations.

+ WebDAV HTTP methods for the given container:

Example

- DavLockDB /tmp/DavLock - - <Location /foo> - Dav On - - AuthType Basic - AuthName DAV - AuthUserFile user.passwd - - <LimitExcept GET HEAD OPTIONS> - require user admin - </LimitExcept> - </Location> -

+ <Location /foo> + + Dav On + + </Location> +

+ +

The value On is actually an alias for the default + provider filesystem which is served by the mod_dav_fs module. Note, that once you have DAV enabled + for some location, it cannot be disabled for sublocations. + For a complete configuration example have a look at the section above.

+ +

+ Do not enable WebDAV until you have secured your server. Otherwise + everyone will be able to distribute files on your system. +

DavDepthInfinity Directive

Description:	Allow PROPFIND, Depth: Infinity requests
Syntax:	`DavDepthInfinity on\|off`
Default:	`DavDepthInfinity off`
Context: -	directory
Status: +	server config, virtual host, directory
Status:	Extension
Module:	mod_dav

Use the DavDepthInfinity directive to - allow the processing of PROPFIND requests containing the header - 'Depth: Infinity'. Because this type of request could constitute a - denial-of-service attack, by default it is not allowed.

DavLockDB Directive

Description: -	Location of the DAV lock database
Syntax: -	`DavLockDB file-path`
Context: -	server config, virtual host
Status: -	Extension
Module: -	mod_dav

Use the DavLockDB directive to specify - the full path to the lock database, excluding an extension. The - default (file system) implementation of mod_dav uses a SDBM - database to track user locks. The utility - modules/dav/util/lockview can be used from the server - to display all locks in a lock database.

- -

Example

-DavLockDB /tmp/DavLock -

+ allow the processing of PROPFIND requests containing the + header 'Depth: Infinity'. Because this type of request could constitute + a denial-of-service attack, by default it is not allowed.

DavMinTimeout Directive

Description:	Minimum amount of time the server holds a lock on a DAV resource
Syntax: -	`DavMinTimeout seconds`
Default: +	`DavMinTimeout seconds`
Default:	`DavMinTimeout 0`
Context: -	directory
Status: +	server config, virtual host, directory
Status:	Extension
Module:	mod_dav

When a client requests a DAV resource lock, it can also @@ -108,9 +130,11 @@ a DAV resource

Syntax: (like 600 seconds) to reduce the chance of the client losing the lock due to network latency.

Example

- <Location /MSWord> - DavMinTimeout 600 - </Location> -

Example

+ <Location /MSWord> + + DavMinTimeout 600 + + </Location> +

\ No newline at end of file diff --git a/docs/manual/mod/mod_dav_fs.html.en b/docs/manual/mod/mod_dav_fs.html.en new file mode 100644 index 0000000000..bb18de98c8 --- /dev/null +++ b/docs/manual/mod/mod_dav_fs.html.en @@ -0,0 +1,43 @@ + + +mod_dav_fs - Apache HTTP Server

Apache > HTTP Server > Documentation > Version 2.0 > Modules

Apache Module mod_dav_fs

Description: +	filesystem provider for `mod_dav`
Status: +	Extension
Module Identifier: +	dav_fs_module
Source File: +	mod_dav_fs.c

Summary

This module requires the service of mod_dav. It acts as a support module for mod_dav and provides access to resources located in the + server's file system. The formal name of this provider is + filesystem. mod_dav backend providers + will be invoked by using the Dav + directive:

+ +

Example

+ Dav filesystem +

+ +

Since filesystem is the default provider for + mod_dav, you may simply use the value + On instead.

Directives

DavLockDB

DavLockDB Directive

Description: +	Location of the DAV lock database
Syntax: +	`DavLockDB file-path`
Context: +	server config, virtual host
Status: +	Extension
Module: +	mod_dav_fs

Use the DavLockDB directive to specify + the full path to the lock database, excluding an extension. If + the path is not absolute, it will be taken relative to ServerRoot. The implementation of + mod_dav_fs uses a SDBM database to track user + locks.

+ + + +

Example

+ DavLockDB logs/DavLock +

\ No newline at end of file diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en index ae8355a79f..dd94942ac2 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -207,10 +207,10 @@ switch before dumping core

CustomLog file|pipe format|nickname [env=[!]environment-variable] sv B

Sets filename and format of log file

Dav on|off off d E

Enable WebDAV HTTP methods

DavDepthInfinity on|off off d E

Allow PROPFIND, Depth: Infinity requests

DavLockDB file-path sv E

Location of the DAV lock database

DavMinTimeout seconds 0 d E

Minimum amount of time the server holds a lock on +

Dav On|Off|provider-name Off d E

Enable WebDAV HTTP methods

DavDepthInfinity on|off off svd E

Allow PROPFIND, Depth: Infinity requests

DavLockDB file-path sv E

Location of the DAV lock database

DavMinTimeout seconds 0 svd E

Minimum amount of time the server holds a lock on a DAV resource

DefaultIcon url-path svdh B

Icon to display for files when no specific icon is configured

Directives

Topics

See also

Enabling WebDAV

Directives

Dav Directive

Full Example

Security

Dav Directive

Example

DavDepthInfinity Directive

DavLockDB Directive

Example

DavMinTimeout Directive

Example

Example

Apache Module mod_dav_fs

Summary

Example

Directives

See also

DavLockDB Directive

Example