openpower-hw-diags/attn/Attention_Handler.md

24 attention handler will query the state of the host to determine the nature of
69 the host is started. When the attention handler is started it will register
71 resident in memory waiting for attentions. The attention handler will be stopped
74 If the attention handler terminates due to an error condition it will
81 When the attention signal becomes active the attention handler will begin
82 handling attentions. Using the PDBG interface the attention handler will query
84 enabled processor will be queried and a map of active attentions will be
85 created. The first attention of highest priority will be the one that is
94 dump. The attention handler will wait, up to one hour, for the dump to complete
113 will consider two cases namely a TI with SRC and a TI with EID.
115 For a TI with SRC, using the TI info, the attention handler will create and
121 For a TI with EID, the attention handler will, based upon flags in the TI info,
123 of the dump the attention handler will request a re-IPL of the host via the dbus
124 interface. For a TI with EID the attention handler will forgo creating a PEL
130 When servicing a PHYPTI the attention handler will generate a PEL entry and then
139 attention is assumed. When a BP attention occurs the attention handler will use
141 encountered. The attention handler will then go back to listening for
148 a TI the attention handler will note whether or not the host is reporting
149 recoverable errors. If recoverable errors are present the attention handler will
157 checkstop attention the attention handler will call the analyzer and then wait
159 will use the dbus interface to request a system dump and upon completetion, or
160 timeout, will request a re-IPL of the host.
176 Regardless of the type of special attention the attention handler will always
181 handler will return to listening for attentions. In most cases no more
182 attentions will be detected unless the currently active attentions are cleared.
183 Normally active attentions will be cleared by the host re-IPL but any component
188 will generate a PEL entry to indicate the error that was encountered.