summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorFrank Ch. Eigler <fche@redhat.com>2020-03-26 13:48:20 -0400
committerFrank Ch. Eigler <fche@redhat.com>2020-03-26 14:35:06 -0400
commitb77ac36a0810692bd847c935f147b0e3f66abf9c (patch)
treea2264dc00a9cc4348f935d27c8aae0eab0ae0e86 /doc
parent12305ff528ad9365b4d4e5ebcd307373cdd5bf83 (diff)
downloadelfutils-b77ac36a0810692bd847c935f147b0e3f66abf9c.tar.gz
debuginfod: document and workaround fedora31 zstd compressionfche/zstd
Old enough (RHEL7 era) rpm/libarchive tools cannot grok fedora31 zstd-compressed rpms. Disable those tests if necessary. Document -Z based workaround for debuginfod users. https://fedoraproject.org/wiki/Changes/Switch_RPMs_to_zstd_compression Signed-off-by: Frank Ch. Eigler <fche@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog5
-rw-r--r--doc/debuginfod.85
2 files changed, 9 insertions, 1 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 564644f4..cfb03b38 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2020-03-26 Frank Ch. Eigler <fche@redhat.com>
+
+ * debuginfod.8 (-R): Note zstd compression complications
+ and workaround.
+
2020-03-24 Frank Ch. Eigler <fche@redhat.com>
* debuginfod-find.1, debuginfod_find_debuginfo.3: Document
diff --git a/doc/debuginfod.8 b/doc/debuginfod.8
index 64795c24..d8fbbea0 100644
--- a/doc/debuginfod.8
+++ b/doc/debuginfod.8
@@ -100,7 +100,10 @@ additional patterns. This option may be repeated.
.B "\-R"
Activate RPM patterns in archive scanning. The default is off.
Equivalent to \fB\%\-Z\~.rpm=cat\fP, since libarchive can natively
-process RPM archives.
+process RPM archives. If your version of libarchive is much older
+than 2020, be aware that some distributions have switched to an
+incompatible zstd compression for their payload. You may experiment
+with \fB\%\-Z\ .rpm='(rpm2cpio|zstdcat)<'\fP instead of \fB\-R\fP.
.TP
.B "\-U"