This is the mail archive of the
elfutils-devel@sourceware.org
mailing list for the elfutils project.
[Committed] README: Document that tools and libraries should be upgraded together.
- From: Mark Wielaard <mjw at redhat dot com>
- To: elfutils-devel at lists dot fedorahosted dot org
- Date: Mon, 04 Nov 2013 15:24:46 +0100
- Subject: [Committed] README: Document that tools and libraries should be upgraded together.
On some distributions it was possible to upgrade separate parts of elfutils
individually. That causes hard to debug issues since some tools (e.g. readelf)
and some libraries (e.g. libdw) depend on libelf internal data structures,
which could be different between versions (or when configured with different
flags). So explicitly document that they should always be upgraded together.
Signed-off-by: Mark Wielaard <mjw@redhat.com>
---
README | 7 +++++++
1 files changed, 7 insertions(+), 0 deletions(-)
diff --git a/README b/README
index 33cac74..138717b 100644
--- a/README
+++ b/README
@@ -10,3 +10,10 @@ Fundamental design decision:
users must match. No third-party EBL module are supported or allowed.
The only reason there are separate modules is to not have the code for
all architectures in all the binaries.
+
+- although the public libraries (libasm, libdw) have a stable API and are
+ backwards ABI compatbile they, and the elfutils tools, do depend on each
+ others internals, and on internals of libelf to provide their interfaces.
+ So they should always be upgraded in lockstep when packaging the tools
+ and libraries separately. For one example of how to do that, see the
+ config/elfutils.spec.
--
1.7.1