sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

ref-manual: Updated the "Recipe Logging Mechanisms" section 

Fixes [YOCTO #9950]

Added more detail on the functions for logging.

(From yocto-docs rev: b7ed4d84ae5221765201fe661af3741fb01da738)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2016-07-16 12:51:53 -07:00 committed by Richard Purdie
parent 451334a841
commit aae4c2a629
1 changed files with 53 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
documentation/ref-manual/usingpoky.xml
View File

@ -356,23 +356,63 @@
<section id='recipe-logging-mechanisms'> <section id='recipe-logging-mechanisms'>
<title>Recipe Logging Mechanisms</title> <title>Recipe Logging Mechanisms</title>
<para> <para>
Best practices exist while writing recipes that both log build progress and Best practices exist while writing recipes that both log build
act on build conditions such as warnings and errors. progress and act on build conditions such as warnings and errors.
Both Python and Bash language bindings exist for the logging mechanism: For Python functions, the following logging functions exist.
All of these functions log to
<filename>${T}/log.do_</filename><replaceable>task</replaceable>,
and can also log to standard output (stdout) with the right
settings:
<itemizedlist> <itemizedlist>
<listitem><para><emphasis>Python:</emphasis> For Python functions, BitBake <listitem><para>
supports several loglevels: <filename>bb.fatal</filename>, <filename>bb.plain(</filename><replaceable>msg</replaceable><filename>)</filename>:
<filename>bb.error</filename>, <filename>bb.warn</filename>, Writes <replaceable>msg</replaceable> as is to the log while
<filename>bb.note</filename>, <filename>bb.plain</filename>, also logging to stdout.
and <filename>bb.debug</filename>.</para></listitem> </para></listitem>
<listitem><para><emphasis>Bash:</emphasis> For Bash functions, the same set <listitem><para>
of loglevels exist and are accessed with a similar syntax: <filename>bb.note(</filename><replaceable>msg</replaceable><filename>)</filename>:
<filename>bbfatal</filename>, <filename>bberror</filename>, Writes "NOTE: <replaceable>msg</replaceable>" to the log.
<filename>bbwarn</filename>, <filename>bbnote</filename>, Also logs to stdout if BitBake is called with "-v".
<filename>bbplain</filename>, and <filename>bbdebug</filename>.</para></listitem> </para></listitem>
<listitem><para>
<filename>bb.debug(</filename><replaceable>level</replaceable><filename>,&nbsp;</filename><replaceable>msg</replaceable><filename>)</filename>:
Writes "DEBUG: <replaceable>msg</replaceable>" to the log.
Also logs to stdout if the log level is greater than or
equal to <replaceable>level</replaceable>.
See the
"<ulink url='&YOCTO_DOCS_BB_URL;#usage-and-syntax'>-D</ulink>"
option in the BitBake User Manual for more information.
</para></listitem>
<listitem><para>
<filename>bb.warn(</filename><replaceable>msg</replaceable><filename>)</filename>:
Writes "WARNING: <replaceable>msg</replaceable>" to the log
while also logging to stdout.
</para></listitem>
<listitem><para>
<filename>bb.error(</filename><replaceable>msg</replaceable><filename>)</filename>:
Writes "ERROR: <replaceable>msg</replaceable>" to the log
while also logging to stdout.
<note>
Calling this function does not cause the task to fail.
</note>
</para></listitem>
<listitem><para>
<filename>bb.fatal(</filename><replaceable>msg</replaceable><filename>)</filename>:
This logging function is similar to
<filename>bb.error(</filename><replaceable>msg</replaceable><filename>)</filename>
but also causes the calling task to fail.
</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para>
The same logging functions are also available in shell functions,
under the names
<filename>bbplain</filename>, <filename>bbnote</filename>,
<filename>bbdebug</filename>, <filename>bbwarn</filename>,
<filename>bberror</filename>, and <filename>bbfatal</filename>.
</para>
<para> <para>
For guidance on how logging is handled in both Python and Bash recipes, see the For guidance on how logging is handled in both Python and Bash recipes, see the
<filename>logging.bbclass</filename> file in the <filename>logging.bbclass</filename> file in the