diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-08-15 09:01:49 +0300 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-12-09 22:25:36 +0000 |
commit | d5a808d6b3f09736a7bf2a145b82ff8f340fd500 (patch) | |
tree | 59ba36db69ae42ba767207d8123d215f105d32db /bitbake/doc | |
parent | 1aae44787cf09a997e3a9ab8b4d64a417a4ee49e (diff) | |
download | ast2050-yocto-poky-d5a808d6b3f09736a7bf2a145b82ff8f340fd500.zip ast2050-yocto-poky-d5a808d6b3f09736a7bf2a145b82ff8f340fd500.tar.gz |
bitbake: bitbake-user-manual-metadata.xml: Added [eventmask] flag information.
Reported-by: Laszlo Papp <lpapp@kde.org>
(Bitbake rev: 38150bc53c6bda5be7194f9acd112d362506d2ea)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake/doc')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | 25 |
1 files changed, 23 insertions, 2 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml index 992f650..26699fc 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml @@ -1308,8 +1308,8 @@ BitBake allows installation of event handlers within recipe and class files. Events are triggered at certain points during operation, - such as the beginning of operation against a given - <filename>.bb</filename>, the start of a given task, + such as the beginning of an operation against a given recipe + (<filename>*.bb</filename> file), the start of a given task, task failure, task success, and so forth. The intent is to make it easy to do things like email notification on build failure. @@ -1338,6 +1338,27 @@ </para> <para> + Because you probably are only interested in a subset of events, + you would likely use the <filename>[eventmask]</filename> flag + for your event handler to be sure that only certain events + trigger the handler. + Given the previous example, suppose you only wanted the + <filename>bb.build.TaskFailed</filename> event to trigger that + event handler. + Use the flag as follows: + <literallayout class='monospaced'> + addhandler myclass_eventhandler + myclass_eventhandler[eventmask] = "bb.build.TaskFailed" + python myclass_eventhandler() { + from bb.event import getName + from bb import data + print("The name of the Event is %s" % getName(e)) + print("The file we run for is %s" % data.getVar('FILE', e.data, True)) + } + </literallayout> + </para> + + <para> During a standard build, the following common events might occur: <itemizedlist> <listitem><para> |