mails

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 han-
       dling 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 avail-
       able at: http://dovecot.org/bugreport.html

SEE ALSO

       doveadm(1)

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