doveadm-force-resync(1)

1DOVEADM-FORCE-RESYNC(1)             Dovecot            DOVEADM-FORCE-RESYNC(1)
2
3
4

NAME

6       doveadm-force-resync - Repair broken mailboxes
7

SYNOPSIS

9       doveadm [-Dv] force-resync [-S socket_path] mailbox
10       doveadm [-Dv] force-resync [-S socket_path] -A mailbox
11       doveadm [-Dv] force-resync [-S socket_path] -u user mailbox
12

DESCRIPTION

14       Under certain circumstances it may happen, that dovecot(1) is unable to
15       automatically solve problems with mailboxes.  In  such  situations  the
16       force-resync  command  may  be  helpful.  It tries to fix all problems.
17       For sdbox and mdbox mailboxes the storage files will be also checked.
18

OPTIONS

20       Global doveadm(1) options:
21
22       -D     Enables verbosity and debug messages.
23
24       -v     Enables verbosity, including progress counter.
25
26       Command specific options:
27
28       -A     If the -A option is present, the command will be  performed  for
29              all  users.   Using this option in combination with system users
30              from userdb { driver = passwd } is not recommended,  because  it
31              contains  also  users  with  a lower UID than the one configured
32              with the first_valid_uid setting.
33
34              When the SQL userdb module is used  make  sure  that  the  iter‐
35              ate_query  setting  in /etc/dovecot/dovecot-sql.conf.ext matches
36              your database layout.  When using the LDAP userdb  module,  make
37              sure  that  the  iterate_attrs  and  iterate_filter  settings in
38              /etc/dovecot/dovecot-ldap.conf.ext match your LDAP schema.  Oth‐
39              erwise doveadm(1) will be unable to iterate over all users.
40
41       -S socket_path
42              The option's argument is either an absolute path to a local UNIX
43              domain socket, or a hostname and port (hostname:port), in  order
44              to connect a remote host via a TCP socket.
45
46              This allows an administrator to execute doveadm(1) mail commands
47              through the given socket.
48
49       -u user/mask
50              Run the command only for the given user.  It's also possible  to
51              use '*' and '?' wildcards (e.g. -u *@example.org).
52              When  neither  the -A option nor -u user was specified, the com‐
53              mand will be executed with  the  environment  of  the  currently
54              logged in user.
55

ARGUMENTS

57       mailbox
58              The  name of the mailbox to fix. With mdbox all of the mailboxes
59              are fixed, so you can use for example INBOX as the name.
60

EXAMPLE

62       Fix bob's INBOX:
63
64       doveadm force-resync -u bob INBOX
65

REPORTING BUGS

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