Debian Codegraph @

doc/html/_sources/imap/reference/manpages/systemcommands/mbtool.rst.txt

raw
1 .. cyrusman:: mbtool(8)
2
3 .. _imap-reference-manpages-systemcommands-mbtool:
4
5 ==========
6 **mbtool**
7 ==========
8
9 intro
10
11 Synopsis
12 ========
13
14 .. parsed-literal::
15
16 **mbtool** [ **-C** *config-file* ] **-r** *mailbox*...
17 **mbtool** [ **-C** *config-file* ] **-t** *mailbox*...
18
19 Description
20 ===========
21
22 **mbtool** is a tool for performing various actions on the indexes of a
23 list of mailboxes. The only actions currently supported are **-t**,
24 which will normalize the ``internaldate`` time stamp of each record in
25 the index to GMT, and **-r** which will create a new unique ID for each
26 mailbox.
27
28 Only one action may be given and at least mailbox must be listed.
29
30 It is intended that **mbtool** will be extended over time to perform
31 more such actions.
32
33 **mbtool** |default-conf-text|
34
35 Options
36 =======
37
38 .. program:: mbtool
39
40 .. option:: -C config-file
41
42 |cli-dash-c-text|
43
44 .. option:: -t, --normalize-internaldate
45
46 Normalize ``internaldate`` on all index records of all listed
47 *mailbox*\ es to match the *Date:* header if they're off by more
48 than a day, which can be used to fix up a mailbox which has been
49 restored from backup and lost its internaldate information.
50
51 .. option:: -r, --new-uniqueid
52
53 Create a new unique ID for all listed *mailbox*\ es. Only works
54 for legacy mailboxes.
55
56 Examples
57 ========
58
59 .. parsed-literal::
60
61 **mbtool -r** user.jsmith
62
63 ..
64
65 Create new UUID for mailbox *user.jsmith*.
66
67 .. parsed-literal::
68
69 **mbtool -t** user.jsmith
70
71 ..
72
73 Normalize ``internaldate`` on all index records in
74 *user.jsmith*.
75
76 .. only:: html
77
78 ::
79
80 Working on user.jsmith...
81 00000001: Tue, 08 Jul 2014 16:45:18 -0500 => Mon, 07 Jul 2014 20:44:18 +0000
82 00000002: Tue Jul 08 16:45:13 CDT 2013 => Fri, 30 Aug 2013 19:46:03 +0000
83 <...>
84
85 ..
86
87
88 Files
89 =====
90
91 /etc/imapd.conf
92
93 See Also
94 ========
95
96 :cyrusman:`imapd.conf(5)`