Debian Codegraph @

doc/html/_sources/imap/developer/guidance/var_directory_structure.rst.txt

raw
1 .. _imap-developer-guidance-var_directory_structure:
2
3 .. Note: This document was converted from the original by Nic Bernstein
4 (Onlight). Any formatting mistakes are my fault and not the
5 original author's.
6
7 Cyrus IMAP Server: var directory structure
8 ==========================================
9
10 Directory structure under /var/spool/imap
11 -----------------------------------------
12
13 ::
14
15 stage./
16 Normal staging directory
17
18 sync./
19 Staging directory for replication system
20 Includes
21 sync./locks/*
22
23 which are lock files for each user on the system to prevent two
24 replication runs from trying to update the same account at the same time
25 (nothing disastrous should happen even without this lock, but the second
26 job in will get a bit confused if the target end changes under its feet,
27 and will probably drop back to a recovery mode.
28
29 user/
30 Familiar user.userid space.
31
32 Directory structure under /var/imap
33 -----------------------------------
34
35 Complete list::
36
37 drwxr-xr-x 2 cyrus cyrus 232 Sep 7 08:21 db
38 drwxr-x--- 2 cyrus cyrus 112 Sep 7 19:51 db.backup1
39 drwxr-x--- 2 cyrus cyrus 112 Sep 7 19:21 db.backup2
40 -rw-r----- 1 cyrus cyrus 20799488 Sep 7 19:51 deliver.db
41 drwxr-xr-x 2 cyrus cyrus 48 Sep 7 10:16 log
42 -rw-r----- 1 cyrus cyrus 1995000 Sep 7 19:38 mailboxes.db
43 -rw-r--r-- 1 cyrus cyrus 10 Jun 2 10:08 master_machine
44 -rw-r--r-- 1 cyrus cyrus 71 Sep 7 08:21 master_uuid
45 drwxr-xr-x 2 cyrus cyrus 48 Jun 2 10:08 msg
46 drwxr-xr-x 2 cyrus cyrus 1872 Sep 7 19:55 proc
47 drwxr-xr-x 28 cyrus cyrus 672 Jun 2 10:08 quota
48 drwxr-xr-x 2 cyrus cyrus 224 Sep 7 08:21 socket
49 drwxr-xr-x 2 cyrus cyrus 72 Sep 7 10:19 sync
50 drwxr-xr-x 28 cyrus cyrus 672 Jun 2 10:08 user
51
52 Most of that will be familiar. New entries are::
53
54 master_machine
55 Defines machine number in replication cluster. Used as sanity check
56 against master_uuid file. Sample content:
57
58 machine=1
59
60 master_uuid
61 Full information about UUID schema in use. See ./uuid for details.
62 Sample content:
63
64 schema=1
65 machine=1
66 timestamp_generation=0
67 master_start_time=1062919294
68
69 sync/current
70 Transaction log from IMAP, POP and LMTP daemons, typically feed into
71 sync_client running as asynchronous replication engine.
72
73 Rotated to be sync/current-<pid> by asynchronous runner.