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 15:00:18 -0400
commit6ae21361ab8b9ba0b18d55d595d9b20dedfcb132 (patch)
tree63908c2fb5354773eb1936c44d0b447d47cf6b64 /doc
parent12305ff528ad9365b4d4e5ebcd307373cdd5bf83 (diff)
downloadelfutils-6ae21361ab8b9ba0b18d55d595d9b20dedfcb132.tar.gz
debuginfod: document and workaround fedora31 zstd compression
Old enough (even RHEL8 era) rpm/libarchive tools cannot grok fedora31 zstd-compressed rpms. Disable those tests if necessary. Document -Z based workaround for these 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"