diff options
| author | Eric Wong <e@80x24.org> | 2024-04-28 21:15:24 +0000 |
|---|---|---|
| committer | Eric Wong <e@80x24.org> | 2024-04-29 17:10:02 +0000 |
| commit | 7f3b57f4c1cbbb7ddfa41dde6d25276ee96d3fd4 (patch) | |
| tree | 8d223fc78c0f27fc44b0877dfc29ce0669f0f3d4 /Documentation | |
| parent | 31ca305f28d747a094a2e82c8193ac5546c44cb5 (diff) | |
| download | public-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')
| -rw-r--r-- | Documentation/public-inbox-extindex.pod | 13 | ||||
| -rw-r--r-- | Documentation/public-inbox-index.pod | 7 |
2 files changed, 20 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 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<all> 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</--update-extindex>. +See L<public-inbox-extindex(1)/--no-multi-pack-index> for details. + +Available in public-inbox 2.0.0+ + =item --since=DATESTRING =item --after=DATESTRING |