summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/usingpoky.xml
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-08-12 13:48:58 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-08-18 23:50:47 +0100
commitf82a65776bd6fa33a0b5b6ecbb322384629f222a (patch)
treebe01c0672ebaba2e07fb2d102c7d94f46d089991 /documentation/ref-manual/usingpoky.xml
parent3db5ff63866475fda6400fe8ead4390a18797910 (diff)
downloadpoky-f82a65776bd6fa33a0b5b6ecbb322384629f222a.tar.gz
ref-manual: Updated the "Viewing Logs from Failed Tasks" section.
Fixes [YOCTO #10132] Provided a better description and removed a deprecated sentence near the end. (From yocto-docs rev: bbe588e19bb9ed58883ae7c770da551de659e982) 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, 23 insertions, 10 deletions
diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index a7a63bd8cb..79322dd198 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -166,19 +166,32 @@
166 <section id='usingpoky-debugging-viewing-logs-from-failed-tasks'> 166 <section id='usingpoky-debugging-viewing-logs-from-failed-tasks'>
167 <title>Viewing Logs from Failed Tasks</title> 167 <title>Viewing Logs from Failed Tasks</title>
168 168
169 <para>The log file for shell tasks is available in 169 <para>
170 <filename>${WORKDIR}/temp/log.do_<replaceable>taskname</replaceable>.pid</filename>. 170 You can find the log for a task in the file
171 For example, the <filename>do_compile</filename> task for the QEMU minimal image for the x86 171 <filename>${WORKDIR}/temp/log.do_</filename><replaceable>taskname</replaceable><filename>.</filename><replaceable>pid</replaceable>.
172 machine (<filename>qemux86</filename>) might be 172 For example, the log for the
173 <filename>tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/temp/log.do_compile.20830</filename>. 173 <link linkend='ref-tasks-compile'><filename>do_compile</filename></link>
174 To see what 174 task of the QEMU minimal image for the x86 machine
175 <ulink url='&YOCTO_DOCS_DEV_URL;#bitbake-term'>BitBake</ulink> 175 (<filename>qemux86</filename>) might be in
176 runs to generate that log, look at the corresponding 176 <filename>tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/temp/log.do_compile.</filename><replaceable>pid</replaceable>.
177 <filename>run.do_<replaceable>taskname</replaceable>.pid</filename> file located in the same directory. 177 To see the commands
178 <ulink url='&YOCTO_DOCS_DEV_URL;#bitbake-term'>BitBake</ulink> ran
179 to generate a log, look at the corresponding
180 <filename>run.do_</filename><replaceable>taskname</replaceable><filename>.</filename><replaceable>pid</replaceable>
181 file in the same directory.
178 </para> 182 </para>
179 183
180 <para> 184 <para>
181 Presently, the output from Python tasks is sent directly to the console. 185 <filename>log.do_</filename><replaceable>taskname</replaceable> and
186 <filename>run.do_</filename><replaceable>taskname</replaceable>
187 are actually symbolic links to
188 <filename>log.do_</filename><replaceable>taskname</replaceable><filename>.</filename><replaceable>pid</replaceable>
189 and
190 <filename>log.run_</filename><replaceable>taskname</replaceable><filename>.</filename><replaceable>pid</replaceable>,
191 where <replaceable>pid</replaceable> is the PID the task had when
192 it ran.
193 The symlinks always point to the files corresponding to the most
194 recent run.
182 </para> 195 </para>
183 </section> 196 </section>
184 197