aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorFrank Ch. Eigler <fche@redhat.com>2020-01-25 18:43:07 -0500
committerFrank Ch. Eigler <fche@redhat.com>2020-02-25 12:05:28 -0500
commit577170fc84e1a347076bc6150a7b152da0a882ac (patch)
treec82a7c0bd991cac61e9d53c6921d9ac0e448784a /doc
parent8f430df5eee70da920ca1e0b00aae73eb2a38b18 (diff)
downloadplatform_external_elfutils-577170fc84e1a347076bc6150a7b152da0a882ac.tar.gz
platform_external_elfutils-577170fc84e1a347076bc6150a7b152da0a882ac.tar.bz2
platform_external_elfutils-577170fc84e1a347076bc6150a7b152da0a882ac.zip
PR25375: fdcache prefetching to reduce repeated archive decompression
Introduce new option --fdcache-prefetch to accelerate repeated queries from the same debuginfo archive. Signed-off-by: Frank Ch. Eigler <fche@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/debuginfod.817
2 files changed, 14 insertions, 7 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 36094d00..3e57491c 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2020-02-25 Frank Ch. Eigler <fche@redhat.com>
+
+ * debuginfod.8: Document new --fdcache-prefetch option.
+
2020-02-05 Frank Ch. Eigler <fche@redhat.com>
* debuginfod.8: Document new -Z flag and tweak other bits.
diff --git a/doc/debuginfod.8 b/doc/debuginfod.8
index ca844aed..ed9724d6 100644
--- a/doc/debuginfod.8
+++ b/doc/debuginfod.8
@@ -193,14 +193,17 @@ loops in the symbolic directory tree might lead to \fIinfinite
traversal\fP.
.TP
-.B "\-\-fdcache-fds=NUM" "\-\-fdcache-mbs=MB"
+.B "\-\-fdcache\-fds=NUM" "\-\-fdcache\-mbs=MB" "\-\-fdcache\-prefetch=NUM2"
Configure limits on a cache that keeps recently extracted files from
-archives. Up to NUM files and up to a total of MB megabytes will be
-kept extracted, in order to avoid having to decompress their archives
-again. The default NUM and MB values depend on the concurrency of the
-system, and on the available disk space on the $TMPDIR or \fB/tmp\fP
-filesystem. This is because that is where the most recently used
-extracted files are kept. Grooming cleans this cache.
+archives. Up to NUM requested files and up to a total of MB megabytes
+will be kept extracted, in order to avoid having to decompress their
+archives over and over again. In addition, up to NUM2 other files
+from an archive may be prefetched into the cache before they are even
+requested. The default NUM, NUM2, and MB values depend on the
+concurrency of the system, and on the available disk space on the
+$TMPDIR or \fB/tmp\fP filesystem. This is because that is where the
+most recently used extracted files are kept. Grooming cleans this
+cache.
.TP
.B "\-v"