From 7f3b57f4c1cbbb7ddfa41dde6d25276ee96d3fd4 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sun, 28 Apr 2024 21:15:24 +0000 Subject: extindex: support --no-multi-pack-index git multi-pack-index files were creating swap storms and OOM-ing on my system; so providing an option to disable it seems prudent given the minor startup time regression. --- Documentation/public-inbox-extindex.pod | 13 +++++++++++++ Documentation/public-inbox-index.pod | 7 +++++++ 2 files changed, 20 insertions(+) (limited to 'Documentation') diff --git a/Documentation/public-inbox-extindex.pod b/Documentation/public-inbox-extindex.pod index b53e45ed..2db7d7e9 100644 --- a/Documentation/public-inbox-extindex.pod +++ b/Documentation/public-inbox-extindex.pod @@ -80,6 +80,19 @@ doubles the size of the already-large Xapian database. Used with C<--reindex>, it will only look for new and stale entries and not touch already-indexed messages. +=item --no-multi-pack-index + +Disable writing a L file to save memory. +Normally, enabling multi-pack-index speeds up startup time of +subsequent L processes by 3-4%, but generating +this file requires several GB of memory with large repos. + +Unlike the C directive in git, it's still +possible to read existing multi-pack-index files if they are +created elsewhere. + +Available in public-inbox 2.0.0+ + =back =head1 FILES diff --git a/Documentation/public-inbox-index.pod b/Documentation/public-inbox-index.pod index 14f157a5..f1a2180a 100644 --- a/Documentation/public-inbox-index.pod +++ b/Documentation/public-inbox-index.pod @@ -192,6 +192,13 @@ external indices are configured. Do not update the C external index by default. This negates all uses of C<-E> / C<--update-extindex=> on the command-line. +=item --no-multi-pack-index + +Disables writing the multi-pack-index when using L. +See L for details. + +Available in public-inbox 2.0.0+ + =item --since=DATESTRING =item --after=DATESTRING -- cgit v1.2.3-24-ge0c7