DragonFly On-Line Manual Pages

DOVEADM-MOUNT(1)                    Dovecot                   DOVEADM-MOUNT(1)

NAME
       doveadm-mount - Manage the list of mountpoints where mails are stored

SYNOPSIS
       doveadm [-Dv] [-f formatter] mount command [arguments]

DESCRIPTION
       The doveadm mount commands can be used to manage the list of
       mountpoints where mails are stored.  This is used mainly for better
       error handling when a mountpoint isn't mounted for some reason:

       *   If a mail directory doesn't exist, it's autocreated.  If the user's
           mails aren't mounted and filesystem permissions still allow the
           autocreation, the user will see an empty mailbox and later will
           have to redownload all mails.  If the mountpoint is known to be
           unmounted, Dovecot will simply fail opening any mailboxes.

       *   If dbox alternate storage isn't mounted and a mail in it is
           attempted to be accessed, Dovecot normally rebuilds the indexes and
           notices that all the mails in alt storage are expunged.  When the
           alt storage is mounted back and even if index is again rebuilt, the
           mails won't necessarily become visible anymore for IMAP clients.
           If the mountpoint is known to be unmounted, Dovecot won't rebuild
           indexes and lose the mails.

       Dovecot automatically adds mountpoints to this list at startup.  If you
       don't want some of the mountpoints added, you can add a wildcard ignore
       for it.

OPTIONS
       Global doveadm(1) options:

       -D     Enables verbosity and debug messages.

       -f formatter
              Specifies the formatter for formatting the output.  Supported
              formatters are:

              flow   prints each line with key=value pairs.

              pager  prints each key: value pair on its own line and separates
                     records with form feed character (^L).

              tab    prints a table header followed by tab separated value
                     lines.

              table  prints a table header followed by adjusted value lines.

       -o setting=value
              Overrides the configuration setting from
              /usr/local/etc/dovecot/dovecot.conf and from the userdb with the
              given value.  In order to override multiple settings, the -o
              option may be specified multiple times.

       -v     Enables verbosity, including progress counter.

ARGUMENTS
       path   The directory name of a mountpoint

       state  The state of a mountpoint.  Either online or ignore.

COMMANDS
   mount add
       doveadm mount add [path [state]]

       If this command is run without any parameters, doveadm detects all
       missing mountpoints and adds them (the same way as when Dovecot does at
       startup).

       When a mountpoint path is given, it's added as a mountpoint.  The state
       can currently be either "online" (default) or "ignore".  The ignore
       state is mainly useful with path wildcards to add mountpoints that you
       never want Dovecot to automatically add, such as: doveadm mount add
       '/mnt/*' ignore

   mount list
       doveadm [-Dv ] [-f formatter] mount list

       This command lists the mountpoints known to Dovecot and their state.

   mount remove
       doveadm mount remove path

       This command removes the specified path from the mountpoint list.

REPORTING BUGS
       Report bugs, including doveconf -n output, to the Dovecot Mailing List
       <dovecot@dovecot.org>.  Information about reporting bugs is available
       at: http://dovecot.org/bugreport.html

SEE ALSO
       doveadm(1)

Dovecot v2.2                      2012-02-16                  DOVEADM-MOUNT(1)