mail_sync.sqlite3 needs to be documented, and brings the IPC
section up-to-date while we're in the area.
$SHARD - Integer starting with 0 based on parallelism
~/.local/share/lei/store
$SHARD - Integer starting with 0 based on parallelism
~/.local/share/lei/store
- - ipc.lock # lock file for internal lei IPC
- local/$EPOCH.git # normal bare git repositories
- mail_sync.sqlite3 # sync state IMAP, Maildir, NNTP
- local/$EPOCH.git # normal bare git repositories
- mail_sync.sqlite3 # sync state IMAP, Maildir, NNTP
the Xapian document, thus it is shared across different blobs of
the "same" message.
the Xapian document, thus it is shared across different blobs of
the "same" message.
+=head2 mail_sync.sqlite3
+
+This SQLite database maintained for bidirectional mapping of
+git blobs to IMAP UIDs, Maildir file names, and NNTP article numbers.
+
+It is also used for retrieving messages from Maildirs indexed by
+L<lei-index(1)>.
+
-When L<lei(1)> is run in daemon mode, L<flock(2)> is used on
-C<ipc.lock> is used to serialize writes to C<lei/store> across
-multiple internal lei workers while minimizing commits.
+L<lei-daemon(8)> communicates with the C<lei/store> process using
+L<unix(7)> C<SOCK_SEQPACKET> sockets.