1DOVEADM-FORCE-RESYNC(1) Dovecot DOVEADM-FORCE-RESYNC(1)
2
3
4
6 doveadm-force-resync - Repair broken mailboxes
7
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] -F file mailbox
12 doveadm [-Dv] force-resync [-S socket_path] -u user mailbox
13
15 Under certain circumstances it may happen, that dovecot(1) is unable to
16 automatically solve problems with mailboxes. In such situations the
17 force-resync command may be helpful. It tries to fix all problems.
18 For sdbox and mdbox mailboxes the storage files will be also checked.
19
21 Global doveadm(1) options:
22
23 -D Enables verbosity and debug messages.
24
25 -o setting=value
26 Overrides the configuration setting from /etc/dovecot/dove‐
27 cot.conf and from the userdb with the given value. In order to
28 override multiple settings, the -o option may be specified mul‐
29 tiple times.
30
31 -v Enables verbosity, including progress counter.
32
33 Command specific options:
34
35 -A If the -A option is present, the command will be performed for
36 all users. Using this option in combination with system users
37 from userdb { driver = passwd } is not recommended, because it
38 contains also users with a lower UID than the one configured
39 with the first_valid_uid setting.
40
41 When the SQL userdb module is used make sure that the iter‐
42 ate_query setting in /etc/dovecot/dovecot-sql.conf.ext matches
43 your database layout. When using the LDAP userdb module, make
44 sure that the iterate_attrs and iterate_filter settings in
45 /etc/dovecot/dovecot-ldap.conf.ext match your LDAP schema. Oth‐
46 erwise doveadm(1) will be unable to iterate over all users.
47
48 -F file
49 Execute the command for all the users in the file. This is sim‐
50 ilar to the -A option, but instead of getting the list of users
51 from the userdb, they are read from the given file. The file
52 contains one username per line.
53
54 -S socket_path
55 The option's argument is either an absolute path to a local UNIX
56 domain socket, or a hostname and port (hostname:port), in order
57 to connect a remote host via a TCP socket.
58
59 This allows an administrator to execute doveadm(1) mail commands
60 through the given socket.
61
62 -u user/mask
63 Run the command only for the given user. It's also possible to
64 use '*' and '?' wildcards (e.g. -u *@example.org).
65 When neither the -A option, nor the -F file option, nor the
66 -u user was specified, the command will be executed with the
67 environment of the currently logged in user.
68
70 mailbox
71 The name of the mailbox to fix. With mdbox all of the mailboxes
72 are fixed, so you can use for example INBOX as the name.
73
75 Fix bob's INBOX:
76
77 doveadm force-resync -u bob INBOX
78
80 Report bugs, including doveconf -n output, to the Dovecot Mailing List
81 <dovecot@dovecot.org>. Information about reporting bugs is available
82 at: http://dovecot.org/bugreport.html
83
85 doveadm(1)
86
87
88
89Dovecot v2.3 2015-05-09 DOVEADM-FORCE-RESYNC(1)