diff options
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/RelNotes/v2.0.0.wip | 2 | ||||
-rw-r--r-- | Documentation/public-inbox-extindex.pod | 13 | ||||
-rw-r--r-- | Documentation/public-inbox-index.pod | 7 | ||||
-rw-r--r-- | Documentation/public-inbox-tuning.pod | 7 |
4 files changed, 25 insertions, 4 deletions
diff --git a/Documentation/RelNotes/v2.0.0.wip b/Documentation/RelNotes/v2.0.0.wip index 794d7956..f04d8144 100644 --- a/Documentation/RelNotes/v2.0.0.wip +++ b/Documentation/RelNotes/v2.0.0.wip @@ -56,7 +56,7 @@ treewide * for daemons serving public traffic, MALLOC_MMAP_THRESHOLD_=131072 is recommended to reduce fragmentation in glibc malloc, while jemalloc - (tested as an LD_PRELOAD) is another option. + (tested as an LD_PRELOAD) is another option (at least for 64-bit). PublicInbox::WWW 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 diff --git a/Documentation/public-inbox-tuning.pod b/Documentation/public-inbox-tuning.pod index 892ee0f2..b56c2b10 100644 --- a/Documentation/public-inbox-tuning.pod +++ b/Documentation/public-inbox-tuning.pod @@ -166,9 +166,10 @@ capacity planning. Bursts of small object allocations late in process life contribute to fragmentation of the heap due to arenas (slabs) used internally by Perl. glibc malloc users should use C<MALLOC_MMAP_THRESHOLD_=131072> to reduce -fragmentation from the sliding mmap window. jemalloc (tested as an -LD_PRELOAD on GNU/Linux) also reduces fragmentation compared to an -unconfigured glibc malloc in long-lived processes. +fragmentation from the sliding mmap window. On 64-bit systems, jemalloc +(tested as an LD_PRELOAD on GNU/Linux) reduces fragmentation at the +expense of VM space. 32-bit systems may be better off sticking with +glibc and MALLOC_MMAP_THRESHOLD_. =head2 Other OS tuning knobs |