summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
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:32 +0100
commit2eb48c227e673bd1c06829c24e2043a164dd0124 (patch)
treece54871d2a4e64c4f0c2800ae1340189b5040042 /documentation/ref-manual
parentf06cd40f08f0c683a29abc30cf586cf538bf2321 (diff)
downloadpoky-2eb48c227e673bd1c06829c24e2043a164dd0124.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: f7ba2fd03ee40c5dbe6a07a24a63d9147857ed78) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-classes.xml6
-rw-r--r--documentation/ref-manual/ref-qa-checks.xml10
2 files changed, 15 insertions, 1 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index a000b2ae28..3889473b6e 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -1697,7 +1697,11 @@
1697 <listitem><para><emphasis><filename>textrel:</filename></emphasis> 1697 <listitem><para><emphasis><filename>textrel:</filename></emphasis>
1698 Checks for ELF binaries that contain relocations in their 1698 Checks for ELF binaries that contain relocations in their
1699 <filename>.text</filename> sections, which can result in a 1699 <filename>.text</filename> sections, which can result in a
1700 performance impact at runtime.</para></listitem> 1700 performance impact at runtime.
1701 See the explanation for the
1702 <link linkend='qa-issue-textrel'><filename>ELF binary</filename></link>
1703 message for more information regarding runtime performance issues.
1704 </para></listitem>
1701 <listitem><para><emphasis><filename>unsafe-references-in-binaries:</filename></emphasis> 1705 <listitem><para><emphasis><filename>unsafe-references-in-binaries:</filename></emphasis>
1702 Reports when a binary installed in 1706 Reports when a binary installed in
1703 <filename>${base_libdir}</filename>, 1707 <filename>${base_libdir}</filename>,
diff --git a/documentation/ref-manual/ref-qa-checks.xml b/documentation/ref-manual/ref-qa-checks.xml
index 43cb26db4c..b4657e2ced 100644
--- a/documentation/ref-manual/ref-qa-checks.xml
+++ b/documentation/ref-manual/ref-qa-checks.xml
@@ -464,6 +464,16 @@ can be found then it should be implemented. I can't find one at the moment.
464 <filename>.text</filename> sections. 464 <filename>.text</filename> sections.
465 This situation can result in a performance impact 465 This situation can result in a performance impact
466 at runtime. 466 at runtime.
467 <note><title>Tip</title>
468 If you do experience runtime performance issues,
469 you could try assigning "-fPIC/-fpic" to
470 <filename>gcc</filename>.
471 </note>
472 </para>
473
474 <para>
475 For more information on text relocations at runtime, see
476 <ulink url='http://www.akkadia.org/drepper/textrelocs.html'></ulink>.
467 </para> 477 </para>
468 478
469 <para> 479 <para>