summaryrefslogtreecommitdiff
path: root/doc/develop/event.rst
diff options
context:
space:
mode:
authorTom Rini <trini@konsulko.com>2023-01-27 22:48:14 +0300
committerTom Rini <trini@konsulko.com>2023-01-27 22:48:14 +0300
commitaa7c61f62923a1c9e9ec7f588ad37016d8c7323c (patch)
tree1342a4a1602a41c8b9b58d21516ba1bb638cbe50 /doc/develop/event.rst
parent424d4f4509a97887647fae9a2a390f043cd60772 (diff)
parent15436faa46a9958b019aea22d24bc52eb1da15ff (diff)
downloadu-boot-aa7c61f62923a1c9e9ec7f588ad37016d8c7323c.tar.xz
Merge tag 'efi-2023-04-rc1-3' of https://source.denx.de/u-boot/custodians/u-boot-efi
Pull request efi-2023-04-rc1-3 Documentation: * Improve the sl-mx8mm documenation * Clean up README, move some section to HTML * Man-pages for the mtime and sleep command * Description of reducible builds * Document dynamic event handlers UEFI: * Support scrolling in eficonfig command Other: * fix mtest on 64 bit systems
Diffstat (limited to 'doc/develop/event.rst')
-rw-r--r--doc/develop/event.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/develop/event.rst b/doc/develop/event.rst
index 6951ec97e7..4ff5934837 100644
--- a/doc/develop/event.rst
+++ b/doc/develop/event.rst
@@ -64,3 +64,26 @@ in an image, use $(CROSS_COMPILE)nm::
nm u-boot |grep evspy |grep list
00000000002d6300 D _u_boot_list_2_evspy_info_2_EVT_MISC_INIT_F
+
+Logging is also available. Events use category `LOGC_EVENT`, so you can enable
+logging on that, or add `#define LOG_DEBUG` to the top of `common/event.c` to
+see events being sent.
+
+
+Dynamic events
+--------------
+
+Static events provide a way of dealing with events known at build time. In some
+cases we want to attach an event handler at runtime. For example, we may wish
+to be notified when a particular device is probed or removed.
+
+This can be handled by enabling `CONFIG_EVENT_DYNAMIC`. It is then possible to
+call `event_register()` to register a new handler for a particular event.
+
+Dynamic event handlers are called after all the static event spy handlers have
+been processed. Of course, since dynamic event handlers are created at runtime
+it is not possible to use the `event_dump.py` to see them.
+
+At present there is no way to list dynamic event handlers from the command line,
+nor to deregister a dynamic event handler. These features can be added when
+needed.