diff options
| author | Patrick Steinhardt <ps@pks.im> | 2024-05-13 10:18:28 +0200 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2024-05-13 17:02:38 -0700 |
| commit | 90db611c2a1f4ca2123ef5a8d7e592fa348bb23b (patch) | |
| tree | 9ffa56012f5adff03bd384ed3dd309a43f42fa92 /Documentation/config | |
| parent | 8e9e136d6172824dd77f8f83569ec3e5f7bc08cd (diff) | |
| download | git-90db611c2a1f4ca2123ef5a8d7e592fa348bb23b.tar.xz | |
refs/reftable: allow configuring restart interval
Add a new option `reftable.restartInterval` that allows the user to
control the restart interval when writing reftable records used by the
reftable library.
Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/config')
| -rw-r--r-- | Documentation/config/reftable.txt | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/Documentation/config/reftable.txt b/Documentation/config/reftable.txt index fa7c4be014..2374be71d7 100644 --- a/Documentation/config/reftable.txt +++ b/Documentation/config/reftable.txt @@ -12,3 +12,21 @@ readers during access. + The largest block size is `16777215` bytes (15.99 MiB). The default value is `4096` bytes (4kB). A value of `0` will use the default value. + +reftable.restartInterval:: + The interval at which to create restart points. The reftable backend + determines the restart points at file creation. Every 16 may be + more suitable for smaller block sizes (4k or 8k), every 64 for larger + block sizes (64k). ++ +More frequent restart points reduces prefix compression and increases +space consumed by the restart table, both of which increase file size. ++ +Less frequent restart points makes prefix compression more effective, +decreasing overall file size, with increased penalties for readers +walking through more records after the binary search step. ++ +A maximum of `65535` restart points per block is supported. ++ +The default value is to create restart points every 16 records. A value of `0` +will use the default value. |