summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-04-20 07:55:41 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-04-24 11:07:50 +0100
commit4a90b6b0d9aabef42da231ac9181829ba42ad7da (patch)
tree18fe4c6319de7caa88d4575728b4bad9e48618ad /documentation
parent0c7340105edbfb2d5467e9635de6008d2d28e7e7 (diff)
downloadast2050-yocto-poky-4a90b6b0d9aabef42da231ac9181829ba42ad7da.zip
ast2050-yocto-poky-4a90b6b0d9aabef42da231ac9181829ba42ad7da.tar.gz
ref-manual: Updates to ELF binary QA warning
Fixes [YOCTO #7630] Apparently the text relocation being done here can cause runtime performance issues. I documented a potential work-around for the issue and provided a cross-reference link to an external site for more general information about text relocation at runtime. Reported-by: Laszlo Papp <lpapp@kde.org> (From yocto-docs rev: f7f611a6668b6cd2ee3928ad44c72dbbe5307c38) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/ref-classes.xml6
-rw-r--r--documentation/ref-manual/ref-qa-checks.xml7
2 files changed, 7 insertions, 6 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index a000b2a..3889473 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -1697,7 +1697,11 @@
<listitem><para><emphasis><filename>textrel:</filename></emphasis>
Checks for ELF binaries that contain relocations in their
<filename>.text</filename> sections, which can result in a
- performance impact at runtime.</para></listitem>
+ performance impact at runtime.
+ See the explanation for the
+ <link linkend='qa-issue-textrel'><filename>ELF binary</filename></link>
+ message for more information regarding runtime performance issues.
+ </para></listitem>
<listitem><para><emphasis><filename>unsafe-references-in-binaries:</filename></emphasis>
Reports when a binary installed in
<filename>${base_libdir}</filename>,
diff --git a/documentation/ref-manual/ref-qa-checks.xml b/documentation/ref-manual/ref-qa-checks.xml
index 54cd433..7eaeb7f 100644
--- a/documentation/ref-manual/ref-qa-checks.xml
+++ b/documentation/ref-manual/ref-qa-checks.xml
@@ -467,8 +467,8 @@ can be found then it should be implemented. I can't find one at the moment.
</para>
<para>
- Typically, the way to solve this performance issue is to
- add "-fPIC" to the compiler command-line options.
+ Typically, the way to solve this performance issue is
+ to add "-fPIC" to the compiler command-line options.
For example, given software that reads
<link linkend='var-CFLAGS'><filename>CFLAGS</filename></link>
when you build it, you can add the following to your
@@ -476,9 +476,6 @@ can be found then it should be implemented. I can't find one at the moment.
<literallayout class='monospaced'>
CFLAGS_append = " -fPIC "
</literallayout>
- </para>
-
- <para>
For more information on text relocations at runtime, see
<ulink url='http://www.akkadia.org/drepper/textrelocs.html'></ulink>.
</para>
OpenPOWER on IntegriCloud