summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/usingpoky.xml
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2017-01-06 08:16:09 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-01-11 17:23:18 +0000
commit81021bc0aa0f64e67535f6a9551e921a64fe4395 (patch)
tree5fce9ca64374f777c7008fad728827419c8b6f64 /documentation/ref-manual/usingpoky.xml
parent3ecc502b8dcad84e23031589671b918cdd6a2487 (diff)
downloadpoky-81021bc0aa0f64e67535f6a9551e921a64fe4395.tar.gz
yocto-project-qs, ref-manual: Added note for "resources temporarily unavailable" error
Fixes [YOCTO #10818] There is a weird and intermittant error that can occur on any given distribution that has a 4.3+ Linux kernel and a version 228+ systemd. The error happens during an initial build of an image and indicates that resources are unavailable. Investigation determines that resources are available. The combination of the kernel and the systemd in a distro is causing issues when a distro is upgraded. yocto-project-qs: I added a note in the two areas where the user is stepped through the bitbake process to build an image. The note mentions the possibility of the error, the host configuration situation, and a couple work-arounds, which are to reboot the machine or to set the "DefaultTaskMax" systemd parameter to "infinity". ref-manual: Added the same note in the "Building an Image" section. (From yocto-docs rev: 3516803f9e6b5a29e4f95d31742c6e03ff63ef41) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/usingpoky.xml')
-rw-r--r--documentation/ref-manual/usingpoky.xml33
1 files changed, 33 insertions, 0 deletions
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index f7345547c5..dcf0b95ae4 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -69,6 +69,39 @@
69 <literallayout class='monospaced'> 69 <literallayout class='monospaced'>
70 $ bitbake <replaceable>target</replaceable> 70 $ bitbake <replaceable>target</replaceable>
71 </literallayout> 71 </literallayout>
72 <note>
73 <para>
74 If you experience a build error due to resources
75 temporarily being unavailable and it appears you
76 should not be having this issue, it might be due
77 to the combination of a 4.3+ Linux kernel and
78 <filename>systemd</filename> version 228+
79 (i.e. see this
80 <ulink url='http://unix.stackexchange.com/questions/253903/creating-threads-fails-with-resource-temporarily-unavailable-with-4-3-kernel'>link</ulink>
81 for information).
82 </para>
83
84 <para>
85 To work around this issue, you can try either
86 of the following:
87 <itemizedlist>
88 <listitem><para>
89 Try the build again.
90 </para></listitem>
91 <listitem><para>
92 Modify the "DefaultTasksMax"
93 <filename>systemd</filename> parameter
94 by uncommenting it and setting it to
95 "infinity".
96 You can find this parameter in the
97 <filename>system.conf</filename> file
98 located in
99 <filename>/etc/systemd</filename>
100 on most systems.
101 </para></listitem>
102 </itemizedlist>
103 </para>
104 </note>
72 </para> 105 </para>
73 106
74 <para> 107 <para>