summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2015-02-04 09:02:20 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2015-02-17 15:16:59 +0000
commitef959e61c48539837b3f501126df969ec22f4f78 (patch)
treebd65de33222878374cc704e5bffafe56bd0d1080 /documentation
parenta0999ab4dff3e0f37d071a9066f53cd01713c349 (diff)
downloadast2050-yocto-poky-ef959e61c48539837b3f501126df969ec22f4f78.zip
ast2050-yocto-poky-ef959e61c48539837b3f501126df969ec22f4f78.tar.gz
ref-manual: Added "leakage" FAQ entry.
Fixes [YOCTO #6852] I added a new FAQ entry to address situations where during a native build, the build fails due to previously installed stuff on the system from /usr/local/include and /opt. The entry tries to cover "leakage" issues in general but calls out the specific case involving libiconv and iconv.h. (From yocto-docs rev: 2c09c7ee0970189953bfbbdcaac49a1ebe8482fe) 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/faq.xml35
1 files changed, 35 insertions, 0 deletions
diff --git a/documentation/ref-manual/faq.xml b/documentation/ref-manual/faq.xml
index da6ce20..c53d458 100644
--- a/documentation/ref-manual/faq.xml
+++ b/documentation/ref-manual/faq.xml
@@ -364,6 +364,41 @@
<qandaentry>
<question>
<para>
+ When I try to build a native recipe, the build fails with <filename>iconv.h</filename> problems.
+ </para>
+ </question>
+ <answer>
+ <para>
+ If you get an error message that indicates GNU
+ <filename>libiconv</filename> is not in use but
+ <filename>iconv.h</filename> has been included from
+ <filename>libiconv</filename>, you need to check to see if
+ you have a previously installed version of the header file
+ in <filename>/usr/local/include</filename>.
+ <literallayout class='monospaced'>
+ #error GNU libiconv not in use but included iconv.h is from libiconv
+ </literallayout>
+ If you find a previously installed file, you should either
+ uninstall it or temporarily rename it and try the build again.
+ </para>
+
+ <para>
+ This issue is just a single manifestation of "system
+ leakage" issues caused when the OpenEbedded build system
+ finds and uses previously installed files during a native
+ build.
+ This type of issue might not be limited to
+ <filename>iconv.h</filename>.
+ Be sure that leakage cannot occur from
+ <filename>/usr/local/include</filename> and
+ <filename>/opt</filename> locations.
+ </para>
+ </answer>
+ </qandaentry>
+
+ <qandaentry>
+ <question>
+ <para>
What do we need to ship for license compliance?
</para>
</question>
OpenPOWER on IntegriCloud