doveadm-mount.1.in revision d6745154e4e3478c9657a1d4b942a7bc6722bb6c
Copyright (c) 2012 Dovecot authors, see the included COPYING file
DOVEADM-MOUNT 1 "2012-02-16" "Dovecot v2.2" "Dovecot"
NAME
doveadm-mount - Manage the list of mountpoints where mails are stored ------------------------------------------------------------------------
SYNOPSIS
doveadm " [" -Dv "] [" -f formatter ] mount command " [" arguments ] ------------------------------------------------------------------------
DESCRIPTION
The doveadm mount command s 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\(aqt mounted for some reason:

4 * If a mail directory doesn\(aqt exist, it\(aqs autocreated. If the user\(aqs mails aren\(aqt 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\(aqt 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\(aqt necessarily become visible anymore for IMAP clients. If the mountpoint is known to be unmounted, Dovecot won\(aqt rebuild indexes and lose the mails.

Dovecot automatically adds mountpoints to this list at startup. If you don\(aqt want some of the mountpoints added, you can add a wildcard ignore for it. ------------------------------------------------------------------------
@INCLUDE:global-options-formatter@ ------------------------------------------------------------------------

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\(aqs added as a mountpoint. The state can currently be either \(dq online \(dq (default) or \(dq ignore \(dq. 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. ------------------------------------------------------------------------
@INCLUDE:reporting-bugs@ ------------------------------------------------------------------------

SEE ALSO
doveadm (1)