aboutsummaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-02-08 11:05:48 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-02-14 17:25:44 +0000
commit717c56caff3fa47d346fb0c35d1faf5011131702 (patch)
treea69b59ea907d7b61d76a3c18c744dc510d77140f /documentation
parentdc7221b2fcb29ed9799037ca331f03c12ba0e5b8 (diff)
downloadopenembedded-core-contrib-717c56caff3fa47d346fb0c35d1faf5011131702.tar.gz
ref-manual: Created "Development Host System Issues" section
Fixes YOCTO #2790 Created a new section in the "Debugging Build Failures" section to deal with host issues that cause a build to fail. (From yocto-docs rev: 9efc00146764086646b0c558d12168ab9813d683) 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/usingpoky.xml31
1 files changed, 31 insertions, 0 deletions
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index 149490969a..0b0f02005c 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -222,6 +222,37 @@
</para>
</section>
+ <section id='development-host-system-issues'>
+ <title>Development Host System Issues</title>
+
+ <para>
+ Sometimes issues on the host development system can cause your
+ build to fail.
+ Following are known, host-specific problems.
+ Be sure to always consult the
+ <ulink url='&YOCTO_HOME_URL;/download/yocto/yocto-project-&DISTRO;-release-notes-poky-&POKYVERSION;'>Release Notes</ulink>
+ for a look at all release-related issues.
+ <itemizedlist>
+ <listitem><para><emphasis><filename>eglibc-initial</filename> fails to build</emphasis>:
+ If your development host system has the unpatched
+ <filename>GNU Make 3.82</filename>,
+ the <filename>do_install</filename> task
+ fails for <filename>eglibc-initial</filename> during the
+ build.</para>
+ <para>Typically, every distrobution that ships
+ <filename>GNU Make 3.82</filename> as
+ the default already has the patched version.
+ However, some distributions, such as Debian, have
+ <filename>GNU Make 3.82</filename> as an option, which
+ is unpatched.
+ You will see this error on these types of distributions.
+ Switch to <filename>GNU Make 3.81</filename> or patch
+ your <filename>make</filename> to solve the problem.
+ </para></listitem>
+ </itemizedlist>
+ </para>
+ </section>
+
<section id='usingpoky-debugging-buildfile'>
<title>Building with No Dependencies</title>
<para>