diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2015-04-20 07:55:41 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2015-04-24 11:07:50 +0100 |
commit | 4a90b6b0d9aabef42da231ac9181829ba42ad7da (patch) | |
tree | 18fe4c6319de7caa88d4575728b4bad9e48618ad | |
parent | 0c7340105edbfb2d5467e9635de6008d2d28e7e7 (diff) | |
download | 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>
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 6 | ||||
-rw-r--r-- | documentation/ref-manual/ref-qa-checks.xml | 7 |
2 files changed, 7 insertions, 6 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 54cd4336eb..7eaeb7fa04 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. | |||
467 | </para> | 467 | </para> |
468 | 468 | ||
469 | <para> | 469 | <para> |
470 | Typically, the way to solve this performance issue is to | 470 | Typically, the way to solve this performance issue is |
471 | add "-fPIC" to the compiler command-line options. | 471 | to add "-fPIC" to the compiler command-line options. |
472 | For example, given software that reads | 472 | For example, given software that reads |
473 | <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link> | 473 | <link linkend='var-CFLAGS'><filename>CFLAGS</filename></link> |
474 | when you build it, you can add the following to your | 474 | 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. | |||
476 | <literallayout class='monospaced'> | 476 | <literallayout class='monospaced'> |
477 | CFLAGS_append = " -fPIC " | 477 | CFLAGS_append = " -fPIC " |
478 | </literallayout> | 478 | </literallayout> |
479 | </para> | ||
480 | |||
481 | <para> | ||
482 | For more information on text relocations at runtime, see | 479 | For more information on text relocations at runtime, see |
483 | <ulink url='http://www.akkadia.org/drepper/textrelocs.html'></ulink>. | 480 | <ulink url='http://www.akkadia.org/drepper/textrelocs.html'></ulink>. |
484 | </para> | 481 | </para> |