From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 3FC7D1F9FC for ; Tue, 26 Oct 2021 10:35:58 +0000 (UTC) From: Eric Wong To: meta@public-inbox.org Subject: [PATCH 2/9] doc: lei-store-format: mail sync section, update IPC Date: Tue, 26 Oct 2021 10:35:50 +0000 Message-Id: <20211026103557.2738-3-e@80x24.org> In-Reply-To: <20211026103557.2738-1-e@80x24.org> References: <20211026103557.2738-1-e@80x24.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: mail_sync.sqlite3 needs to be documented, and brings the IPC section up-to-date while we're in the area. --- Documentation/lei-store-format.pod | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/Documentation/lei-store-format.pod b/Documentation/lei-store-format.pod index 71aa72cb96e3..625c60f436a8 100644 --- a/Documentation/lei-store-format.pod +++ b/Documentation/lei-store-format.pod @@ -30,7 +30,6 @@ prevent them from being accidentally treated as a v2 inbox. $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 @@ -66,11 +65,18 @@ stored in Xapian indices, volatile metadata is associated with 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. + =head1 IPC -When L is run in daemon mode, L is used on -C is used to serialize writes to C across -multiple internal lei workers while minimizing commits. +L communicates with the C process using +L C sockets. =head1 CAVEATS