about summary refs log tree commit homepage
path: root/Documentation/public-inbox-extindex.pod
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2024-04-28 21:15:24 +0000
committerEric Wong <e@80x24.org>2024-04-29 17:10:02 +0000
commit7f3b57f4c1cbbb7ddfa41dde6d25276ee96d3fd4 (patch)
tree8d223fc78c0f27fc44b0877dfc29ce0669f0f3d4 /Documentation/public-inbox-extindex.pod
parent31ca305f28d747a094a2e82c8193ac5546c44cb5 (diff)
downloadpublic-inbox-master.tar.gz
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.
Diffstat (limited to 'Documentation/public-inbox-extindex.pod')
-rw-r--r--Documentation/public-inbox-extindex.pod13
1 files changed, 13 insertions, 0 deletions
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<git-multi-pack-index(1)> file to save memory.
+Normally, enabling multi-pack-index speeds up startup time of
+subsequent L<git-cat-file(1)> processes by 3-4%, but generating
+this file requires several GB of memory with large repos.
+
+Unlike the C<core.multiPackIndex> 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