
WebDAV
******


Configuration
=============


davdriveprefix
^^^^^^^^^^^^^^

   *This shows the default value: change it in imapd.conf to suit your
   needs.*

   "davdriveprefix:" #drive

      The prefix for the DAV storage mailboxes hierarchies.  The
      hierarchy delimiter will be automatically appended.  The public
      storage hierarchy will be at the toplevel of the shared
      namespace.  A user's personal storage hierarchy will be a child
      of their Inbox.

When enabled, the WebDAV module allows Cyrus to function as a storage
server. This module uses a subset of the mailbox hierarchy as
collections, the toplevel of which is specified by the
"davdriveprefix" option. The public storage hierarchy lives at the
toplevel of the shared mailbox namespace. A user's personal storage
hierarchy will be a child of their Inbox.

For example, using the default value for davdriveprefix, an collection
named photos for user "murch" would reside in the mailbox named
"user.murch.#drive.photos". A user would access their storage at
"https://<servername>/dav/<davdriveprefix>/user/<userid>", which for
the example above, comes to:
"https://<servername>/dav/drive/user/murch".

Warning: Note that mailboxes in the storage hierarchies (those under
  *davdriveprefix*) **should not** be accessed with an IMAP client as
  doing so will leave a mailbox in a state unsuitable for WebDAV. To
  this end, storage mailboxes will not returned by Cyrus imapd in
  response to an IMAP client's request for the available mailbox list,
  but Cyrus imapd can not otherwise prevent an IMAP client from
  accessing them.


Administration
==============


Provisioning
------------

The WebDAV module will automatically create a toplevel (root)
collection for a user the first time that the user authenticates to
the WebDAV server. Note that the user MUST have an existing IMAP Inbox
in order for the root collection to be created.


Storage access controls
-----------------------

Cyrus uses the same access controls for storage  as it does for
calendars, except that the scheduling rights (7, 8, 9) have no use
with storage and are ignored.
