xref: /openbmc/debug-trigger/README.md (revision 11cd254b)
1# BMC Debug Trigger #
2
3`debug-trigger` listens for an external signal that the BMC is in some way
4unresponsive. When the signal is received it triggers a crash to collect debug
5data and reboots the system in the hope that it will recover.
6
7## Trigger sources ##
8
9`debug-trigger` implements a simple protocol over an LPC KCS device as its
10trigger source.
11
12## Debug actions ##
13
14`debug-trigger` implements a single action once the trigger event is received,
15which is to crash the kernel via `/proc/sysrq-trigger`. For systems with kdump
16configured this results in collection of system state as context for why the
17system was externally unresponsive.
18