.\" Copyright (c) 2010 Dovecot authors, see the included COPYING file
.TH DOVEADM\-FORCE\-RESYNC 1M "2010-11-25" "Dovecot v2.0" "Dovecot"
.SH NAME
doveadm\-force\-resync \- Repair broken mailboxes
.\"------------------------------------------------------------------------
.SH SYNOPSIS
.BR doveadm " [" \-Dv "] " force\-resync " [" \-S
.IR socket_path "] " mailbox
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " force\-resync " [" \-S
.IR socket_path "] "
.BI \-A \ mailbox
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " force\-resync " [" \-S
.IR socket_path "] "
.BI \-u " user mailbox"
.\"------------------------------------------------------------------------
.SH DESCRIPTION
Under certain circumstances it may happen, that
.BR dovecot (1M)
is unable to automatically solve problems with mailboxes.
In such situations the
.B force\-resync
command may be helpful.
It tries to fix all problems.
For sdbox and mdbox mailboxes the storage files will be also checked.
.\"------------------------------------------------------------------------
.SH OPTIONS
Global
.BR doveadm (1M)
.IR options :
.TP
.B \-D
Enables verbosity and debug messages.
.TP
.B \-v
Enables verbosity, including progress counter.
.\" --- command specific options --- "/.
.PP
Command specific
.IR options :
.\"-------------------------------------
.TP
.B \-A
If the
.B \-A
option is present, the
.I command
will be performed for all users.
Using this option in combination with system users from
.B userdb { driver = passwd }
is not recommended, because it contains also users with a lower UID than
the one configured with the
.I first_valid_uid
setting.
.sp
When the SQL userdb module is used make sure that the
.I iterate_query
setting in
.I /etc/dovecot/conf.d/dovecot\-sql.conf
matches your database layout.
When using the LDAP userdb module, make sure that the
.IR iterate_attrs " and " iterate_filter
settings in
.I /etc/dovecot/conf.d/dovecot\-ldap.conf
match your LDAP schema.
Otherwise
.BR doveadm (1M)
will be unable to iterate over all users.
.\"-------------------------------------
.TP
.BI \-S\  socket_path
The option\(aqs argument is either an absolute path to a local UNIX domain
socket, or a hostname and port
.RI ( hostname : port ),
in order to connect a remote host via a TCP socket.
.sp
This allows an administrator to execute
.BR doveadm (1M)
mail commands through the given socket.
.\"-------------------------------------
.TP
.BI \-u\  user/mask
Run the
.I command
only for the given
.IR user .
It\(aqs also possible to use
.RB \(aq * \(aq
and
.RB \(aq ? \(aq
wildcards (e.g. \-u *@example.org).
.br
When neither the
.B \-A
option nor
.BI \-u\  user
was specified, the
.I command
will be executed with the environment of the
currently logged in user.
.\"------------------------------------------------------------------------
.SH ARGUMENTS
.TP
.I mailbox
The name of the mailbox to fix. With mdbox all of the mailboxes are fixed,
so you can use for example INBOX as the name.
.\"------------------------------------------------------------------------
.SH EXAMPLE
Fix bob\(aqs INBOX:
.PP
.nf
.B doveadm force\-resync \-u bob INBOX
.fi
.\"------------------------------------------------------------------------
.SH REPORTING BUGS
Report bugs, including
.I doveconf \-n
output, to the Dovecot Mailing List <dovecot@dovecot.org>.
Information about reporting bugs is available at:
http://dovecot.org/bugreport.html
.\"------------------------------------------------------------------------
.SH SEE ALSO