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 mountā
points 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.
-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 ALSOdoveadm(1)Dovecot v2.2 2012-02-16 DOVEADM-MOUNT(1)