README.md
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