€•Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œdocutils.nodes”Œsubstitution_definition”“”)”}”(hŒ&.. |AArch32| replace:: :term:`AArch32`”h]”hŒpending_xref”“”)”}”(hŒ:term:`AArch32`”h]”h Œinline”“”)”}”(hhh]”h ŒText”“”ŒAArch32”…””}”(hhŒparent”hubaŒ attributes”}”(Œids”]”Œclasses”]”(Œxref”Œstd”Œstd-term”eŒnames”]”Œdupnames”]”Œbackrefs”]”uŒtagname”hh!hubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”Œcomponents/sdei”Œ refdomain”h)Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆŒ reftarget”ŒAArch32”uh1hŒsource”Œ”Œline”Kh!hubah"}”(h$]”h&]”h+]”ŒAArch32”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ&.. |AArch64| replace:: :term:`AArch64`”h]”h)”}”(hŒ:term:`AArch64`”h]”h)”}”(hhQh]”hŒAArch64”…””}”(hhh!hSubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hOubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”h]Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒAArch64”uh1hhAhBhCKh!hKubah"}”(h$]”h&]”h+]”ŒAArch64”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |AMU| replace:: :term:`AMU`”h]”h)”}”(hŒ:term:`AMU`”h]”h)”}”(hh|h]”hŒAMU”…””}”(hhh!h~ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hzubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”hˆŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒAMU”uh1hhAhBhCKh!hvubah"}”(h$]”h&]”h+]”ŒAMU”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ&.. |AMUs| replace:: :term:`AMUs `”h]”h)”}”(hŒ:term:`AMUs `”h]”h)”}”(hh§h]”hŒAMUs”…””}”(hhh!h©ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!h¥ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”h³Œreftype”Œterm”Œrefexplicit”ˆŒrefwarn”ˆh?ŒAMU”uh1hhAhBhCKh!h¡ubah"}”(h$]”h&]”h+]”ŒAMUs”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |API| replace:: :term:`API`”h]”h)”}”(hŒ:term:`API`”h]”h)”}”(hhÒh]”hŒAPI”…””}”(hhh!hÔubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hÐubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”hÞŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒAPI”uh1hhAhBhCKh!hÌubah"}”(h$]”h&]”h+]”ŒAPI”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |BTI| replace:: :term:`BTI`”h]”h)”}”(hŒ:term:`BTI`”h]”h)”}”(hhýh]”hŒBTI”…””}”(hhh!hÿubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!hûubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒBTI”uh1hhAhBhCKh!h÷ubah"}”(h$]”h&]”h+]”ŒBTI”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |CoT| replace:: :term:`CoT`”h]”h)”}”(hŒ:term:`CoT`”h]”h)”}”(hj(h]”hŒCoT”…””}”(hhh!j*ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j&ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j4Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCoT”uh1hhAhBhCKh!j"ubah"}”(h$]”h&]”h+]”ŒCoT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |COT| replace:: :term:`COT`”h]”h)”}”(hŒ:term:`COT`”h]”h)”}”(hjSh]”hŒCOT”…””}”(hhh!jUubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jQubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j_Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCOT”uh1hhAhBhCKh!jMubah"}”(h$]”h&]”h+]”ŒCOT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |CSS| replace:: :term:`CSS`”h]”h)”}”(hŒ:term:`CSS`”h]”h)”}”(hj~h]”hŒCSS”…””}”(hhh!j€ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j|ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŠŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCSS”uh1hhAhBhCK h!jxubah"}”(h$]”h&]”h+]”ŒCSS”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |CVE| replace:: :term:`CVE`”h]”h)”}”(hŒ:term:`CVE`”h]”h)”}”(hj©h]”hŒCVE”…””}”(hhh!j«ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j§ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jµŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒCVE”uh1hhAhBhCK h!j£ubah"}”(h$]”h&]”h+]”ŒCVE”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |DTB| replace:: :term:`DTB`”h]”h)”}”(hŒ:term:`DTB`”h]”h)”}”(hjÔh]”hŒDTB”…””}”(hhh!jÖubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÒubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jàŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDTB”uh1hhAhBhCKh!jÎubah"}”(h$]”h&]”h+]”ŒDTB”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |DS-5| replace:: :term:`DS-5`”h]”h)”}”(hŒ:term:`DS-5`”h]”h)”}”(hjÿh]”hŒDS-5”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jýubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDS-5”uh1hhAhBhCKh!jùubah"}”(h$]”h&]”h+]”ŒDS-5”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |DSU| replace:: :term:`DSU`”h]”h)”}”(hŒ:term:`DSU`”h]”h)”}”(hj*h]”hŒDSU”…””}”(hhh!j,ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j(ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j6Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDSU”uh1hhAhBhCK h!j$ubah"}”(h$]”h&]”h+]”ŒDSU”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |DT| replace:: :term:`DT`”h]”h)”}”(hŒ :term:`DT`”h]”h)”}”(hjUh]”hŒDT”…””}”(hhh!jWubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jSubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jaŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒDT”uh1hhAhBhCKh!jOubah"}”(h$]”h&]”h+]”ŒDT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |EL| replace:: :term:`EL`”h]”h)”}”(hŒ :term:`EL`”h]”h)”}”(hj€h]”hŒEL”…””}”(hhh!j‚ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j~ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒEL”uh1hhAhBhCKh!jzubah"}”(h$]”h&]”h+]”ŒEL”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |EHF| replace:: :term:`EHF`”h]”h)”}”(hŒ:term:`EHF`”h]”h)”}”(hj«h]”hŒEHF”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j©ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j·Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒEHF”uh1hhAhBhCKh!j¥ubah"}”(h$]”h&]”h+]”ŒEHF”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ".. |FCONF| replace:: :term:`FCONF`”h]”h)”}”(hŒ :term:`FCONF`”h]”h)”}”(hjÖh]”hŒFCONF”…””}”(hhh!jØubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÔubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jâŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFCONF”uh1hhAhBhCKh!jÐubah"}”(h$]”h&]”h+]”ŒFCONF”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FDT| replace:: :term:`FDT`”h]”h)”}”(hŒ:term:`FDT`”h]”h)”}”(hjh]”hŒFDT”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÿubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFDT”uh1hhAhBhCKh!jûubah"}”(h$]”h&]”h+]”ŒFDT”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |FF-A| replace:: :term:`FF-A`”h]”h)”}”(hŒ:term:`FF-A`”h]”h)”}”(hj,h]”hŒFF-A”…””}”(hhh!j.ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j*ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j8Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFF-A”uh1hhAhBhCKh!j&ubah"}”(h$]”h&]”h+]”ŒFF-A”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FIP| replace:: :term:`FIP`”h]”h)”}”(hŒ:term:`FIP`”h]”h)”}”(hjWh]”hŒFIP”…””}”(hhh!jYubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jUubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jcŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFIP”uh1hhAhBhCKh!jQubah"}”(h$]”h&]”h+]”ŒFIP”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FVP| replace:: :term:`FVP`”h]”h)”}”(hŒ:term:`FVP`”h]”h)”}”(hj‚h]”hŒFVP”…””}”(hhh!j„ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j€ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŽŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFVP”uh1hhAhBhCKh!j|ubah"}”(h$]”h&]”h+]”ŒFVP”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |FWU| replace:: :term:`FWU`”h]”h)”}”(hŒ:term:`FWU`”h]”h)”}”(hjh]”hŒFWU”…””}”(hhh!j¯ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j«ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j¹Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒFWU”uh1hhAhBhCKh!j§ubah"}”(h$]”h&]”h+]”ŒFWU”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |GIC| replace:: :term:`GIC`”h]”h)”}”(hŒ:term:`GIC`”h]”h)”}”(hjØh]”hŒGIC”…””}”(hhh!jÚubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÖubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jäŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒGIC”uh1hhAhBhCKh!jÒubah"}”(h$]”h&]”h+]”ŒGIC”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |ISA| replace:: :term:`ISA`”h]”h)”}”(hŒ:term:`ISA`”h]”h)”}”(hjh]”hŒISA”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒISA”uh1hhAhBhCKh!jýubah"}”(h$]”h&]”h+]”ŒISA”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ$.. |Linaro| replace:: :term:`Linaro`”h]”h)”}”(hŒ:term:`Linaro`”h]”h)”}”(hj.h]”hŒLinaro”…””}”(hhh!j0ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j,ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j:Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒLinaro”uh1hhAhBhCKh!j(ubah"}”(h$]”h&]”h+]”ŒLinaro”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |MMU| replace:: :term:`MMU`”h]”h)”}”(hŒ:term:`MMU`”h]”h)”}”(hjYh]”hŒMMU”…””}”(hhh!j[ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jWubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jeŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMMU”uh1hhAhBhCKh!jSubah"}”(h$]”h&]”h+]”ŒMMU”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |MPAM| replace:: :term:`MPAM`”h]”h)”}”(hŒ:term:`MPAM`”h]”h)”}”(hj„h]”hŒMPAM”…””}”(hhh!j†ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j‚ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMPAM”uh1hhAhBhCKh!j~ubah"}”(h$]”h&]”h+]”ŒMPAM”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ .. |MPMM| replace:: :term:`MPMM`”h]”h)”}”(hŒ:term:`MPMM`”h]”h)”}”(hj¯h]”hŒMPMM”…””}”(hhh!j±ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j»Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMPMM”uh1hhAhBhCKh!j©ubah"}”(h$]”h&]”h+]”ŒMPMM”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ".. |MPIDR| replace:: :term:`MPIDR`”h]”h)”}”(hŒ :term:`MPIDR`”h]”h)”}”(hjÚh]”hŒMPIDR”…””}”(hhh!jÜubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jØubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jæŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMPIDR”uh1hhAhBhCKh!jÔubah"}”(h$]”h&]”h+]”ŒMPIDR”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |MTE| replace:: :term:`MTE`”h]”h)”}”(hŒ:term:`MTE`”h]”h)”}”(hjh]”hŒMTE”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒMTE”uh1hhAhBhCKh!jÿubah"}”(h$]”h&]”h+]”ŒMTE”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ.. |OEN| replace:: :term:`OEN`”h]”h)”}”(hŒ:term:`OEN`”h]”h)”}”(hj0h]”hŒOEN”…””}”(hhh!j2ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j.ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j<Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒOEN”uh1hhAhBhCKh!j*ubah"}”(h$]”h&]”h+]”ŒOEN”ah-]”h/]”uh1h hAhBhCKh!hhhubh)”}”(hŒ$.. |OP-TEE| replace:: :term:`OP-TEE`”h]”h)”}”(hŒ:term:`OP-TEE`”h]”h)”}”(hj[h]”hŒOP-TEE”…””}”(hhh!j]ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jYubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jgŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒOP-TEE”uh1hhAhBhCK h!jUubah"}”(h$]”h&]”h+]”ŒOP-TEE”ah-]”h/]”uh1h hAhBhCK h!hhhubh)”}”(hŒ.. |OTE| replace:: :term:`OTE`”h]”h)”}”(hŒ:term:`OTE`”h]”h)”}”(hj†h]”hŒOTE”…””}”(hhh!jˆubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j„ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j’Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒOTE”uh1hhAhBhCK!h!j€ubah"}”(h$]”h&]”h+]”ŒOTE”ah-]”h/]”uh1h hAhBhCK!h!hhhubh)”}”(hŒ.. |PDD| replace:: :term:`PDD`”h]”h)”}”(hŒ:term:`PDD`”h]”h)”}”(hj±h]”hŒPDD”…””}”(hhh!j³ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j¯ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j½Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPDD”uh1hhAhBhCK"h!j«ubah"}”(h$]”h&]”h+]”ŒPDD”ah-]”h/]”uh1h hAhBhCK"h!hhhubh)”}”(hŒ".. |PAUTH| replace:: :term:`PAUTH`”h]”h)”}”(hŒ :term:`PAUTH`”h]”h)”}”(hjÜh]”hŒPAUTH”…””}”(hhh!jÞubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÚubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jèŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPAUTH”uh1hhAhBhCK#h!jÖubah"}”(h$]”h&]”h+]”ŒPAUTH”ah-]”h/]”uh1h hAhBhCK#h!hhhubh)”}”(hŒ.. |PMF| replace:: :term:`PMF`”h]”h)”}”(hŒ:term:`PMF`”h]”h)”}”(hjh]”hŒPMF”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPMF”uh1hhAhBhCK$h!jubah"}”(h$]”h&]”h+]”ŒPMF”ah-]”h/]”uh1h hAhBhCK$h!hhhubh)”}”(hŒ .. |PSCI| replace:: :term:`PSCI`”h]”h)”}”(hŒ:term:`PSCI`”h]”h)”}”(hj2h]”hŒPSCI”…””}”(hhh!j4ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j0ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j>Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒPSCI”uh1hhAhBhCK%h!j,ubah"}”(h$]”h&]”h+]”ŒPSCI”ah-]”h/]”uh1h hAhBhCK%h!hhhubh)”}”(hŒ.. |RAS| replace:: :term:`RAS`”h]”h)”}”(hŒ:term:`RAS`”h]”h)”}”(hj]h]”hŒRAS”…””}”(hhh!j_ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j[ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jiŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒRAS”uh1hhAhBhCK&h!jWubah"}”(h$]”h&]”h+]”ŒRAS”ah-]”h/]”uh1h hAhBhCK&h!hhhubh)”}”(hŒ.. |ROT| replace:: :term:`ROT`”h]”h)”}”(hŒ:term:`ROT`”h]”h)”}”(hjˆh]”hŒROT”…””}”(hhh!jŠubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j†ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j”Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒROT”uh1hhAhBhCK'h!j‚ubah"}”(h$]”h&]”h+]”ŒROT”ah-]”h/]”uh1h hAhBhCK'h!hhhubh)”}”(hŒ .. |SCMI| replace:: :term:`SCMI`”h]”h)”}”(hŒ:term:`SCMI`”h]”h)”}”(hj³h]”hŒSCMI”…””}”(hhh!jµubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j±ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j¿Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSCMI”uh1hhAhBhCK(h!jubah"}”(h$]”h&]”h+]”ŒSCMI”ah-]”h/]”uh1h hAhBhCK(h!hhhubh)”}”(hŒ.. |SCP| replace:: :term:`SCP`”h]”h)”}”(hŒ:term:`SCP`”h]”h)”}”(hjÞh]”hŒSCP”…””}”(hhh!jàubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÜubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jêŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSCP”uh1hhAhBhCK)h!jØubah"}”(h$]”h&]”h+]”ŒSCP”ah-]”h/]”uh1h hAhBhCK)h!hhhubh)”}”(hŒ .. |SDEI| replace:: :term:`SDEI`”h]”h)”}”(hŒ:term:`SDEI`”h]”h)”}”(hj h]”hŒSDEI”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSDEI”uh1hhAhBhCK*h!jubah"}”(h$]”h&]”h+]”ŒSDEI”ah-]”h/]”uh1h hAhBhCK*h!hhhubh)”}”(hŒ.. |SDS| replace:: :term:`SDS`”h]”h)”}”(hŒ:term:`SDS`”h]”h)”}”(hj4h]”hŒSDS”…””}”(hhh!j6ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j2ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j@Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSDS”uh1hhAhBhCK+h!j.ubah"}”(h$]”h&]”h+]”ŒSDS”ah-]”h/]”uh1h hAhBhCK+h!hhhubh)”}”(hŒ.. |SEA| replace:: :term:`SEA`”h]”h)”}”(hŒ:term:`SEA`”h]”h)”}”(hj_h]”hŒSEA”…””}”(hhh!jaubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j]ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jkŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSEA”uh1hhAhBhCK,h!jYubah"}”(h$]”h&]”h+]”ŒSEA”ah-]”h/]”uh1h hAhBhCK,h!hhhubh)”}”(hŒ.. |SiP| replace:: :term:`SiP`”h]”h)”}”(hŒ:term:`SiP`”h]”h)”}”(hjŠh]”hŒSiP”…””}”(hhh!jŒubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jˆubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j–Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSiP”uh1hhAhBhCK-h!j„ubah"}”(h$]”h&]”h+]”ŒSiP”ah-]”h/]”uh1h hAhBhCK-h!hhhubh)”}”(hŒ.. |SIP| replace:: :term:`SIP`”h]”h)”}”(hŒ:term:`SIP`”h]”h)”}”(hjµh]”hŒSIP”…””}”(hhh!j·ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j³ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÁŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSIP”uh1hhAhBhCK.h!j¯ubah"}”(h$]”h&]”h+]”ŒSIP”ah-]”h/]”uh1h hAhBhCK.h!hhhubh)”}”(hŒ.. |SMC| replace:: :term:`SMC`”h]”h)”}”(hŒ:term:`SMC`”h]”h)”}”(hjàh]”hŒSMC”…””}”(hhh!jâubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jÞubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jìŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSMC”uh1hhAhBhCK/h!jÚubah"}”(h$]”h&]”h+]”ŒSMC”ah-]”h/]”uh1h hAhBhCK/h!hhhubh)”}”(hŒ".. |SMCCC| replace:: :term:`SMCCC`”h]”h)”}”(hŒ :term:`SMCCC`”h]”h)”}”(hjh]”hŒSMCCC”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSMCCC”uh1hhAhBhCK0h!jubah"}”(h$]”h&]”h+]”ŒSMCCC”ah-]”h/]”uh1h hAhBhCK0h!hhhubh)”}”(hŒ.. |SoC| replace:: :term:`SoC`”h]”h)”}”(hŒ:term:`SoC`”h]”h)”}”(hj6h]”hŒSoC”…””}”(hhh!j8ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j4ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jBŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSoC”uh1hhAhBhCK1h!j0ubah"}”(h$]”h&]”h+]”ŒSoC”ah-]”h/]”uh1h hAhBhCK1h!hhhubh)”}”(hŒ.. |SP| replace:: :term:`SP`”h]”h)”}”(hŒ :term:`SP`”h]”h)”}”(hjah]”hŒSP”…””}”(hhh!jcubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j_ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jmŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSP”uh1hhAhBhCK2h!j[ubah"}”(h$]”h&]”h+]”ŒSP”ah-]”h/]”uh1h hAhBhCK2h!hhhubh)”}”(hŒ.. |SPD| replace:: :term:`SPD`”h]”h)”}”(hŒ:term:`SPD`”h]”h)”}”(hjŒh]”hŒSPD”…””}”(hhh!jŽubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jŠubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j˜Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSPD”uh1hhAhBhCK3h!j†ubah"}”(h$]”h&]”h+]”ŒSPD”ah-]”h/]”uh1h hAhBhCK3h!hhhubh)”}”(hŒ.. |SPM| replace:: :term:`SPM`”h]”h)”}”(hŒ:term:`SPM`”h]”h)”}”(hj·h]”hŒSPM”…””}”(hhh!j¹ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jµubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÃŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSPM”uh1hhAhBhCK4h!j±ubah"}”(h$]”h&]”h+]”ŒSPM”ah-]”h/]”uh1h hAhBhCK4h!hhhubh)”}”(hŒ .. |SSBS| replace:: :term:`SSBS`”h]”h)”}”(hŒ:term:`SSBS`”h]”h)”}”(hjâh]”hŒSSBS”…””}”(hhh!jäubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jàubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jîŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSSBS”uh1hhAhBhCK5h!jÜubah"}”(h$]”h&]”h+]”ŒSSBS”ah-]”h/]”uh1h hAhBhCK5h!hhhubh)”}”(hŒ.. |SVE| replace:: :term:`SVE`”h]”h)”}”(hŒ:term:`SVE`”h]”h)”}”(hj h]”hŒSVE”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒSVE”uh1hhAhBhCK6h!j ubah"}”(h$]”h&]”h+]”ŒSVE”ah-]”h/]”uh1h hAhBhCK6h!hhhubh)”}”(hŒ.. |TBB| replace:: :term:`TBB`”h]”h)”}”(hŒ:term:`TBB`”h]”h)”}”(hj8 h]”hŒTBB”…””}”(hhh!j: ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j6 ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jD Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTBB”uh1hhAhBhCK7h!j2 ubah"}”(h$]”h&]”h+]”ŒTBB”ah-]”h/]”uh1h hAhBhCK7h!hhhubh)”}”(hŒ .. |TBBR| replace:: :term:`TBBR`”h]”h)”}”(hŒ:term:`TBBR`”h]”h)”}”(hjc h]”hŒTBBR”…””}”(hhh!je ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!ja ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jo Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTBBR”uh1hhAhBhCK8h!j] ubah"}”(h$]”h&]”h+]”ŒTBBR”ah-]”h/]”uh1h hAhBhCK8h!hhhubh)”}”(hŒ.. |TEE| replace:: :term:`TEE`”h]”h)”}”(hŒ:term:`TEE`”h]”h)”}”(hjŽ h]”hŒTEE”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jŒ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jš Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTEE”uh1hhAhBhCK9h!jˆ ubah"}”(h$]”h&]”h+]”ŒTEE”ah-]”h/]”uh1h hAhBhCK9h!hhhubh)”}”(hŒ .. |TF-A| replace:: :term:`TF-A`”h]”h)”}”(hŒ:term:`TF-A`”h]”h)”}”(hj¹ h]”hŒTF-A”…””}”(hhh!j» ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j· ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÅ Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTF-A”uh1hhAhBhCK:h!j³ ubah"}”(h$]”h&]”h+]”ŒTF-A”ah-]”h/]”uh1h hAhBhCK:h!hhhubh)”}”(hŒ .. |TF-M| replace:: :term:`TF-M`”h]”h)”}”(hŒ:term:`TF-M`”h]”h)”}”(hjä h]”hŒTF-M”…””}”(hhh!jæ ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jâ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jð Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTF-M”uh1hhAhBhCK;h!jÞ ubah"}”(h$]”h&]”h+]”ŒTF-M”ah-]”h/]”uh1h hAhBhCK;h!hhhubh)”}”(hŒ.. |TLB| replace:: :term:`TLB`”h]”h)”}”(hŒ:term:`TLB`”h]”h)”}”(hj h]”hŒTLB”…””}”(hhh!j ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”j Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTLB”uh1hhAhBhCKh!j_ ubah"}”(h$]”h&]”h+]”ŒTRNG”ah-]”h/]”uh1h hAhBhCK>h!hhhubh)”}”(hŒ.. |TSP| replace:: :term:`TSP`”h]”h)”}”(hŒ:term:`TSP`”h]”h)”}”(hj h]”hŒTSP”…””}”(hhh!j’ ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jŽ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jœ Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTSP”uh1hhAhBhCK?h!jŠ ubah"}”(h$]”h&]”h+]”ŒTSP”ah-]”h/]”uh1h hAhBhCK?h!hhhubh)”}”(hŒ.. |TZC| replace:: :term:`TZC`”h]”h)”}”(hŒ:term:`TZC`”h]”h)”}”(hj» h]”hŒTZC”…””}”(hhh!j½ ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j¹ ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÇ Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒTZC”uh1hhAhBhCK@h!jµ ubah"}”(h$]”h&]”h+]”ŒTZC”ah-]”h/]”uh1h hAhBhCK@h!hhhubh)”}”(hŒ".. |UBSAN| replace:: :term:`UBSAN`”h]”h)”}”(hŒ :term:`UBSAN`”h]”h)”}”(hjæ h]”hŒUBSAN”…””}”(hhh!jè ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jä ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jò Œreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒUBSAN”uh1hhAhBhCKAh!jà ubah"}”(h$]”h&]”h+]”ŒUBSAN”ah-]”h/]”uh1h hAhBhCKAh!hhhubh)”}”(hŒ .. |UEFI| replace:: :term:`UEFI`”h]”h)”}”(hŒ:term:`UEFI`”h]”h)”}”(hjh]”hŒUEFI”…””}”(hhh!jubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒUEFI”uh1hhAhBhCKBh!jubah"}”(h$]”h&]”h+]”ŒUEFI”ah-]”h/]”uh1h hAhBhCKBh!hhhubh)”}”(hŒ .. |WDOG| replace:: :term:`WDOG`”h]”h)”}”(hŒ:term:`WDOG`”h]”h)”}”(hj<h]”hŒWDOG”…””}”(hhh!j>ubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!j:ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jHŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒWDOG”uh1hhAhBhCKCh!j6ubah"}”(h$]”h&]”h+]”ŒWDOG”ah-]”h/]”uh1h hAhBhCKCh!hhhubh)”}”(hŒ!.. |XLAT| replace:: :term:`XLAT` ”h]”h)”}”(hŒ:term:`XLAT`”h]”h)”}”(hjgh]”hŒXLAT”…””}”(hhh!jiubah"}”(h$]”h&]”(h(Œstd”Œstd-term”eh+]”h-]”h/]”uh1hh!jeubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jsŒreftype”Œterm”Œrefexplicit”‰Œrefwarn”ˆh?ŒXLAT”uh1hhAhBhCKDh!jaubah"}”(h$]”h&]”h+]”ŒXLAT”ah-]”h/]”uh1h hAhBhCKDh!hhhubh Œsection”“”)”}”(hhh]”(h Œtitle”“”)”}”(hŒ,SDEI: Software Delegated Exception Interface”h]”hŒ,SDEI: Software Delegated Exception Interface”…””}”(hj•h!j“hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jŽhhhAŒP/home/test/workspace/code/optee_3.16/trusted-firmware-a/docs/components/sdei.rst”hCKubh Œ paragraph”“”)”}”(hŒfThis document provides an overview of the SDEI dispatcher implementation in Trusted Firmware-A (TF-A).”h]”hŒfThis document provides an overview of the SDEI dispatcher implementation in Trusted Firmware-A (TF-A).”…””}”(hj¦h!j¤hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKh!jŽhhubj)”}”(hhh]”(j’)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hj·h!jµhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j²hhhAj¡hCKubj£)”}”(hXTSoftware Delegated Exception Interface (|SDEI|) is an Arm specification for Non-secure world to register handlers with firmware to receive notifications about system events. Firmware will first receive the system events by way of asynchronous exceptions and, in response, arranges for the registered handler to execute in the Non-secure EL.”h]”(hŒ(Software Delegated Exception Interface (”…””}”(hŒ(Software Delegated Exception Interface (”h!jÃhhhANhCNubh)”}”(hj h]”h)”}”(hj h]”hŒSDEI”…””}”(hhh!jÏubah"}”(h$]”h&]”(h(jjeh+]”h-]”h/]”uh1hhANhCNh!jÌubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŒreftype”j#Œrefexplicit”‰Œrefwarn”ˆŒ reftarget”j&uh1hhAhBhCK*h!jÃhhubhX&) is an Arm specification for Non-secure world to register handlers with firmware to receive notifications about system events. Firmware will first receive the system events by way of asynchronous exceptions and, in response, arranges for the registered handler to execute in the Non-secure EL.”…””}”(hX&) is an Arm specification for Non-secure world to register handlers with firmware to receive notifications about system events. Firmware will first receive the system events by way of asynchronous exceptions and, in response, arranges for the registered handler to execute in the Non-secure EL.”h!jÃhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK h!j²hhubj£)”}”(hXˆNormal world software that interacts with the SDEI dispatcher (makes SDEI requests and receives notifications) is referred to as the *SDEI Client*. A client receives the event notification at the registered handler even when it was executing with exceptions masked. The list of SDEI events available to the client are specific to the platform [#std-event]_. See also `Determining client EL`_.”h]”(hŒ…Normal world software that interacts with the SDEI dispatcher (makes SDEI requests and receives notifications) is referred to as the ”…””}”(hŒ…Normal world software that interacts with the SDEI dispatcher (makes SDEI requests and receives notifications) is referred to as the ”h!jóhhhANhCNubh Œemphasis”“”)”}”(hŒ *SDEI Client*”h]”hŒSDEI Client”…””}”(hhh!jþubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jóubhŒÅ. A client receives the event notification at the registered handler even when it was executing with exceptions masked. The list of SDEI events available to the client are specific to the platform ”…””}”(hŒÅ. A client receives the event notification at the registered handler even when it was executing with exceptions masked. The list of SDEI events available to the client are specific to the platform ”h!jóhhhANhCNubh Œfootnote_reference”“”)”}”(hŒ [#std-event]_”h]”hŒ1”…””}”(hhh!jubah"}”(h$]”Œid1”ah&]”h+]”h-]”h/]”Œauto”KŒrefid”Œ std-event”Œdocname”h9uh1jh!jóŒresolved”KubhŒ. See also ”…””}”(hŒ. See also ”h!jóhhhANhCNubh Œ reference”“”)”}”(hŒ`Determining client EL`_”h]”hŒDetermining client EL”…””}”(hŒDetermining client EL”h!j.ubah"}”(h$]”h&]”h+]”h-]”h/]”Œname”ŒDetermining client EL”j#Œdetermining-client-el”uh1j,h!jój&KubhŒ.”…””}”(hŒ.”h!jóhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKh!j²hhubh Œtarget”“”)”}”(hŒ.. _general SDEI dispatch:”h]”h"}”(h$]”h&]”h+]”h-]”h/]”j#Œgeneral-sdei-dispatch”uh1jKhCK\h!j²hhhAj¡Œ referenced”Kubj£)”}”(hŒÀThe following figure depicts a general sequence involving SDEI client executing at EL2 and an event dispatch resulting from the triggering of a bound interrupt. A commentary is provided below:”h]”hŒÀThe following figure depicts a general sequence involving SDEI client executing at EL2 and an event dispatch resulting from the triggering of a bound interrupt. A commentary is provided below:”…””}”(hj[h!jYhhhANhCNubah"}”(h$]”jWah&]”h+]”Œgeneral sdei dispatch”ah-]”h/]”uh1j¢hAj¡hCKh!j²hhŒexpect_referenced_by_name”}”jejMsŒexpect_referenced_by_id”}”jWjMsjXKubŒsphinxcontrib.plantuml”Œplantuml”“”)”}”(hŒ:.. uml:: ../resources/diagrams/plantuml/sdei_general.puml ”h]”h"}”(h$]”h&]”h+]”h-]”h/]”Œuml”Xž/' ' Copyright (c) 2017, ARM Limited and Contributors. All rights reserved. ' ' SPDX-License-Identifier: BSD-3-Clause '/ @startuml autonumber "[#]" participant "SDEI client" as EL2 participant EL3 participant "SDEI interrupt source" as SDEI activate EL2 EL2->EL3: **SDEI_INTERRUPT_BIND**(irq) EL3->EL2: event number: ev EL2->EL3: **SDEI_EVENT_REGISTER**(ev, handler, ...) EL3->EL2: success EL2->EL3: **SDEI_EVENT_ENABLE**(ev) EL3->EL2: success EL2->EL3: **SDEI_PE_UNMASK**() EL3->EL2: 1 ... <> ... SDEI-->EL3: SDEI interrupt activate SDEI #salmon activate EL3 #red note over EL3: Prepare SDEI dispatch EL3->EL2: dispatch activate EL2 #salmon note over EL2: SDEI handler EL2->EL3: **SDEI_EVENT_COMPLETE()** deactivate EL2 note over EL3: Complete SDEI dispatch EL3-->SDEI: EOI deactivate SDEI EL3->EL2: resumes preempted execution deactivate EL3 ... <> ... @enduml ”Œincdir”Œresources/diagrams/plantuml”Œfilename”Œsdei_general.puml”uh1jmh!j²hhhAj¡hCKubj£)”}”(hXdAs part of initialisation, the SDEI client binds a Non-secure interrupt [1], and the SDEI dispatcher returns a platform dynamic event number [2]. The client then registers a handler for that event [3], enables the event [5], and unmasks all events on the current PE [7]. This sequence is typical of an SDEI client, but it may involve additional SDEI calls.”h]”hXdAs part of initialisation, the SDEI client binds a Non-secure interrupt [1], and the SDEI dispatcher returns a platform dynamic event number [2]. The client then registers a handler for that event [3], enables the event [5], and unmasks all events on the current PE [7]. This sequence is typical of an SDEI client, but it may involve additional SDEI calls.”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKh!j²hhubj£)”}”(hXÇAt a later point in time, when the bound interrupt triggers [9], it's trapped to EL3. The interrupt is handed over to the SDEI dispatcher, which then arranges to execute the registered handler [10]. The client terminates its execution with ``SDEI_EVENT_COMPLETE`` [11], following which the dispatcher resumes the original EL2 execution [13]. Note that the SDEI interrupt remains active until the client handler completes, at which point EL3 does EOI [12].”h]”(hŒòAt a later point in time, when the bound interrupt triggers [9], itâ€™s trapped to EL3. The interrupt is handed over to the SDEI dispatcher, which then arranges to execute the registered handler [10]. The client terminates its execution with ”…””}”(hŒðAt a later point in time, when the bound interrupt triggers [9], it's trapped to EL3. The interrupt is handed over to the SDEI dispatcher, which then arranges to execute the registered handler [10]. The client terminates its execution with ”h!jhhhANhCNubh Œliteral”“”)”}”(hŒ``SDEI_EVENT_COMPLETE``”h]”hŒSDEI_EVENT_COMPLETE”…””}”(hhh!j˜ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!jubhŒÀ [11], following which the dispatcher resumes the original EL2 execution [13]. Note that the SDEI interrupt remains active until the client handler completes, at which point EL3 does EOI [12].”…””}”(hŒÀ [11], following which the dispatcher resumes the original EL2 execution [13]. Note that the SDEI interrupt remains active until the client handler completes, at which point EL3 does EOI [12].”h!jhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK%h!j²hhubj£)”}”(hXOther than events bound to interrupts, as depicted in the sequence above, SDEI events can be explicitly dispatched in response to other exceptions, for example, upon receiving an *SError* or *Synchronous External Abort*. See `Explicit dispatch of events`_.”h]”(hŒ³Other than events bound to interrupts, as depicted in the sequence above, SDEI events can be explicitly dispatched in response to other exceptions, for example, upon receiving an ”…””}”(hŒ³Other than events bound to interrupts, as depicted in the sequence above, SDEI events can be explicitly dispatched in response to other exceptions, for example, upon receiving an ”h!j±hhhANhCNubjý)”}”(hŒ*SError*”h]”hŒSError”…””}”(hhh!jºubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!j±ubhŒ or ”…””}”(hŒ or ”h!j±hhhANhCNubjý)”}”(hŒ*Synchronous External Abort*”h]”hŒSynchronous External Abort”…””}”(hhh!jÍubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!j±ubhŒ. See ”…””}”(hŒ. See ”h!j±hhhANhCNubj-)”}”(hŒ`Explicit dispatch of events`_”h]”hŒExplicit dispatch of events”…””}”(hŒExplicit dispatch of events”h!jàubah"}”(h$]”h&]”h+]”h-]”h/]”Œname”ŒExplicit dispatch of events”j#Œid2”uh1j,h!j±j&KubhŒ.”…””}”(hjDh!j±hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK,h!j²hhubj£)”}”(hŒÔThe remainder of this document only discusses the design and implementation of SDEI dispatcher in TF-A, and assumes that the reader is familiar with the SDEI specification, the interfaces, and their requirements.”h]”hŒÔThe remainder of this document only discusses the design and implementation of SDEI dispatcher in TF-A, and assumes that the reader is familiar with the SDEI specification, the interfaces, and their requirements.”…””}”(hjþh!jühhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK1h!j²hhubeh"}”(h$]”Œintroduction”ah&]”h+]”Œintroduction”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCKubj)”}”(hhh]”(j’)”}”(hŒDefining events”h]”hŒDefining events”…””}”(hj h!j hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j hhhAj¡hCK6ubj£)”}”(hŒ†A platform choosing to include the SDEI dispatcher must also define the events available on the platform, along with their attributes.”h]”hŒ†A platform choosing to include the SDEI dispatcher must also define the events available on the platform, along with their attributes.”…””}”(hj% h!j# hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK8h!j hhubj£)”}”(hXThe platform is expected to provide two arrays of event descriptors: one for private events, and another for shared events. The SDEI dispatcher provides ``SDEI_PRIVATE_EVENT()`` and ``SDEI_SHARED_EVENT()`` macros to populate the event descriptors. Both macros take 3 arguments:”h]”(hŒ™The platform is expected to provide two arrays of event descriptors: one for private events, and another for shared events. The SDEI dispatcher provides ”…””}”(hŒ™The platform is expected to provide two arrays of event descriptors: one for private events, and another for shared events. The SDEI dispatcher provides ”h!j1 hhhANhCNubj—)”}”(hŒ``SDEI_PRIVATE_EVENT()``”h]”hŒSDEI_PRIVATE_EVENT()”…””}”(hhh!j: ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j1 ubhŒ and ”…””}”(hŒ and ”h!j1 hhhANhCNubj—)”}”(hŒ``SDEI_SHARED_EVENT()``”h]”hŒSDEI_SHARED_EVENT()”…””}”(hhh!jM ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j1 ubhŒH macros to populate the event descriptors. Both macros take 3 arguments:”…””}”(hŒH macros to populate the event descriptors. Both macros take 3 arguments:”h!j1 hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK;h!j hhubh Œbullet_list”“”)”}”(hhh]”(h Œ list_item”“”)”}”(hŒ:The event number: this must be a positive 32-bit integer. ”h]”j£)”}”(hŒ9The event number: this must be a positive 32-bit integer.”h]”hŒ9The event number: this must be a positive 32-bit integer.”…””}”(hjs h!jq ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK@h!jm ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jh hhhAj¡hCNubjl )”}”(hŒåFor an event that has a backing interrupt, the interrupt number the event is bound to: - If it's not applicable to an event, this shall be left as ``0``. - If the event is dynamic, this should be specified as ``SDEI_DYN_IRQ``. ”h]”(j£)”}”(hŒVFor an event that has a backing interrupt, the interrupt number the event is bound to:”h]”hŒVFor an event that has a backing interrupt, the interrupt number the event is bound to:”…””}”(hj‹ h!j‰ ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKBh!j… ubjg )”}”(hhh]”(jl )”}”(hŒAIf it's not applicable to an event, this shall be left as ``0``. ”h]”j£)”}”(hŒ@If it's not applicable to an event, this shall be left as ``0``.”h]”(hŒubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!j5ubhŒ4. Additionally, on GICv2 systems, the build option ”…””}”(hŒ4. Additionally, on GICv2 systems, the build option ”h!j5ubj—)”}”(hŒ``GICV2_G0_FOR_EL3``”h]”hŒGICV2_G0_FOR_EL3”…””}”(hhh!jQubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j5ubhŒ must be set to ”…””}”(hŒ must be set to ”h!j5ubj—)”}”(hŒ``1``”h]”hŒ1”…””}”(hhh!jdubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j5ubhŒ.”…””}”(hjDh!j5ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK»h!jubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jôhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jö j÷ uh1jf hAj¡hCKµh!jÕhhubj£)”}”(hŒ0See also :ref:`porting_guide_sdei_requirements`.”h]”(hŒ See also ”…””}”(hŒ See also ”h!jˆhhhANhCNubh)”}”(hŒ&:ref:`porting_guide_sdei_requirements`”h]”h)”}”(hj“h]”hŒporting_guide_sdei_requirements”…””}”(hhh!j•ubah"}”(h$]”h&]”(h(Œstd”Œstd-ref”eh+]”h-]”h/]”uh1hh!j‘ubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jŸŒreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆh?Œporting_guide_sdei_requirements”uh1hhAj¡hCK¿h!jˆubhŒ.”…””}”(hjDh!jˆhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCK¿h!jÕhhubeh"}”(h$]”jÏah&]”h+]”Œ1configuration within exception handling framework”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCK¯jXKubj)”}”(hhh]”(j’)”}”(hŒDetermining client EL”h]”hŒDetermining client EL”…””}”(hjÇh!jÅhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jÂhhhAj¡hCKÂubj£)”}”(hŒËThe SDEI specification requires that the *physical* SDEI client executes in the highest Non-secure EL implemented on the system. This means that the dispatcher will only allow SDEI calls to be made from:”h]”(hŒ)The SDEI specification requires that the ”…””}”(hŒ)The SDEI specification requires that the ”h!jÓhhhANhCNubjý)”}”(hŒ *physical*”h]”hŒphysical”…””}”(hhh!jÜubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jÓubhŒ˜ SDEI client executes in the highest Non-secure EL implemented on the system. This means that the dispatcher will only allow SDEI calls to be made from:”…””}”(hŒ˜ SDEI client executes in the highest Non-secure EL implemented on the system. This means that the dispatcher will only allow SDEI calls to be made from:”h!jÓhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKÄh!jÂhhubjg )”}”(hhh]”(jl )”}”(hŒ°EL2, if EL2 is implemented. The Hypervisor is expected to implement a *virtual* SDEI dispatcher to support SDEI clients in Guest Operating Systems executing in Non-secure EL1. ”h]”j£)”}”(hŒ¯EL2, if EL2 is implemented. The Hypervisor is expected to implement a *virtual* SDEI dispatcher to support SDEI clients in Guest Operating Systems executing in Non-secure EL1.”h]”(hŒFEL2, if EL2 is implemented. The Hypervisor is expected to implement a ”…””}”(hŒFEL2, if EL2 is implemented. The Hypervisor is expected to implement a ”h!jüubjý)”}”(hŒ *virtual*”h]”hŒvirtual”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jüubhŒ` SDEI dispatcher to support SDEI clients in Guest Operating Systems executing in Non-secure EL1.”…””}”(hŒ` SDEI dispatcher to support SDEI clients in Guest Operating Systems executing in Non-secure EL1.”h!jüubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKÈh!jøubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jõhhhAj¡hCNubjl )”}”(hŒ7Non-secure EL1, if EL2 is not implemented or disabled. ”h]”j£)”}”(hŒ6Non-secure EL1, if EL2 is not implemented or disabled.”h]”hŒ6Non-secure EL1, if EL2 is not implemented or disabled.”…””}”(hj*h!j(ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKÌh!j$ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jõhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jö j÷ uh1jf hAj¡hCKÈh!jÂhhubj£)”}”(hŒ[#]" participant "SDEI client" as EL2 participant EL3 participant SDEI participant "RAS Driver" as RAS activate EL2 EL2->EL3: **SDEI_EVENT_REGISTER**(ev, handler, ...) EL3->EL2: success EL2->EL3: **SDEI_EVENT_ENABLE**(ev) EL3->EL2: success EL2->EL3: **SDEI_PE_UNMASK**() EL3->EL2: 1 ... <> ... EL3<--]: **CRITICAL EVENT** activate EL3 #red note over EL3: Critical event triage EL3->RAS: dispatch to handle deactivate EL3 activate RAS #salmon note over RAS: Critical event handling RAS-->SDEI: sdei_dispatch_event(ev) deactivate RAS activate SDEI #salmon note over SDEI: Prepare SDEI dispatch SDEI->EL2: dispatch activate EL2 #salmon note over EL2: SDEI handler EL2->SDEI: **SDEI_EVENT_COMPLETE()** deactivate EL2 note over SDEI: Complete SDEI dispatch SDEI-->RAS: return deactivate SDEI activate RAS #salmon RAS->EL3: error handling done deactivate RAS EL3->EL2: resumes preempted execution ... <> ... @enduml ”j{Œresources/diagrams/plantuml”j}Œsdei_explicit_dispatch.puml”uh1jmh!jˆhhhAj¡hCKèubj£)”}”(hX9As part of initialisation, the SDEI client registers a handler for a platform event [1], enables the event [3], and unmasks the current PE [5]. Note that, unlike in `general SDEI dispatch`_, this doesn't involve interrupt binding, as bound or dynamic events can't be explicitly dispatched (see the section below).”h]”(hŒ¥As part of initialisation, the SDEI client registers a handler for a platform event [1], enables the event [3], and unmasks the current PE [5]. Note that, unlike in ”…””}”(hŒ¥As part of initialisation, the SDEI client registers a handler for a platform event [1], enables the event [3], and unmasks the current PE [5]. Note that, unlike in ”h!j=hhhANhCNubj-)”}”(hŒ`general SDEI dispatch`_”h]”hŒgeneral SDEI dispatch”…””}”(hŒgeneral SDEI dispatch”h!jFubah"}”(h$]”h&]”h+]”h-]”h/]”Œname”Œgeneral SDEI dispatch”j#jWuh1j,h!j=j&KubhŒ€, this doesnâ€™t involve interrupt binding, as bound or dynamic events canâ€™t be explicitly dispatched (see the section below).”…””}”(hŒ|, this doesn't involve interrupt binding, as bound or dynamic events can't be explicitly dispatched (see the section below).”h!j=hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKéh!jˆhhubj£)”}”(hX`At a later point in time, a critical event [#critical-event]_ is trapped into EL3 [7]. EL3 performs a first-level triage of the event, and a RAS component assumes further handling [8]. The dispatch completes, but intends to involve Non-secure world in further handling, and therefore decides to explicitly dispatch an event [10] (which the client had already registered for [1]). The rest of the sequence is similar to that in the `general SDEI dispatch`_: the requested event is dispatched to the client (assuming all the conditions are met), and when the handler completes, the preempted execution resumes.”h]”(hŒ+At a later point in time, a critical event ”…””}”(hŒ+At a later point in time, a critical event ”h!jbhhhANhCNubj)”}”(hŒ[#critical-event]_”h]”hŒ2”…””}”(hhh!jkubah"}”(h$]”Œid3”ah&]”h+]”h-]”h/]”j"Kj#Œcritical-event”j%h9uh1jh!jbj&KubhXr is trapped into EL3 [7]. EL3 performs a first-level triage of the event, and a RAS component assumes further handling [8]. The dispatch completes, but intends to involve Non-secure world in further handling, and therefore decides to explicitly dispatch an event [10] (which the client had already registered for [1]). The rest of the sequence is similar to that in the ”…””}”(hXr is trapped into EL3 [7]. EL3 performs a first-level triage of the event, and a RAS component assumes further handling [8]. The dispatch completes, but intends to involve Non-secure world in further handling, and therefore decides to explicitly dispatch an event [10] (which the client had already registered for [1]). The rest of the sequence is similar to that in the ”h!jbhhhANhCNubj-)”}”(hŒ`general SDEI dispatch`_”h]”hŒgeneral SDEI dispatch”…””}”(hŒgeneral SDEI dispatch”h!j€ubah"}”(h$]”h&]”h+]”h-]”h/]”Œname”Œgeneral SDEI dispatch”j#jWuh1j,h!jbj&KubhŒ™: the requested event is dispatched to the client (assuming all the conditions are met), and when the handler completes, the preempted execution resumes.”…””}”(hŒ™: the requested event is dispatched to the client (assuming all the conditions are met), and when the handler completes, the preempted execution resumes.”h!jbhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKîh!jˆhhubj)”}”(hhh]”(j’)”}”(hŒConditions for event dispatch”h]”hŒConditions for event dispatch”…””}”(hj¡h!jŸhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jœhhhAj¡hCKøubj£)”}”(hŒeAll of the following requirements must be met for the API to return ``0`` and event to be dispatched:”h]”(hŒDAll of the following requirements must be met for the API to return ”…””}”(hŒDAll of the following requirements must be met for the API to return ”h!jhhhANhCNubj—)”}”(hŒ``0``”h]”hŒ0”…””}”(hhh!j¶ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!jubhŒ and event to be dispatched:”…””}”(hŒ and event to be dispatched:”h!jhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKúh!jœhhubjg )”}”(hhh]”(jl )”}”(hŒcSDEI events must be unmasked on the PE. I.e. the client must have called ``PE_UNMASK`` beforehand. ”h]”j£)”}”(hŒbSDEI events must be unmasked on the PE. I.e. the client must have called ``PE_UNMASK`` beforehand.”h]”(hŒISDEI events must be unmasked on the PE. I.e. the client must have called ”…””}”(hŒISDEI events must be unmasked on the PE. I.e. the client must have called ”h!jÖubj—)”}”(hŒ ``PE_UNMASK``”h]”hŒ PE_UNMASK”…””}”(hhh!jßubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!jÖubhŒ beforehand.”…””}”(hŒ beforehand.”h!jÖubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCKýh!jÒubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhAj¡hCNubjl )”}”(hŒEvent 0 can't be dispatched. ”h]”j£)”}”(hŒEvent 0 can't be dispatched.”h]”hŒEvent 0 canâ€™t be dispatched.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jþubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhAj¡hCNubjl )”}”(hŒVThe event must be declared using the ``SDEI_EXPLICIT_EVENT()`` macro described above. ”h]”j£)”}”(hŒUThe event must be declared using the ``SDEI_EXPLICIT_EVENT()`` macro described above.”h]”(hŒ%The event must be declared using the ”…””}”(hŒ%The event must be declared using the ”h!jubj—)”}”(hŒ``SDEI_EXPLICIT_EVENT()``”h]”hŒSDEI_EXPLICIT_EVENT()”…””}”(hhh!j#ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!jubhŒ macro described above.”…””}”(hŒ macro described above.”h!jubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhAj¡hCNubjl )”}”(hŒ%The event must be private to the PE. ”h]”j£)”}”(hŒ$The event must be private to the PE.”h]”hŒ$The event must be private to the PE.”…””}”(hjHh!jFubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jBubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhAj¡hCNubjl )”}”(hŒ5The event must have been registered for and enabled. ”h]”j£)”}”(hŒ4The event must have been registered for and enabled.”h]”hŒ4The event must have been registered for and enabled.”…””}”(hj`h!j^ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jZubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhAj¡hCNubjl )”}”(hŒzA dispatch for the same event must not be outstanding. I.e. it hasn't already been dispatched and is yet to be completed. ”h]”j£)”}”(hŒyA dispatch for the same event must not be outstanding. I.e. it hasn't already been dispatched and is yet to be completed.”h]”hŒ{A dispatch for the same event must not be outstanding. I.e. it hasnâ€™t already been dispatched and is yet to be completed.”…””}”(hjxh!jvubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM h!jrubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhAj¡hCNubjl )”}”(hXgThe priority of the event (either Critical or Normal, as configured by the platform at build-time) shouldn't cause priority inversion. This means: - If it's of Normal priority, neither Normal nor Critical priority dispatch must be outstanding on the PE. - If it's of a Critical priority, no Critical priority dispatch must be outstanding on the PE. ”h]”(j£)”}”(hŒ’The priority of the event (either Critical or Normal, as configured by the platform at build-time) shouldn't cause priority inversion. This means:”h]”hŒ”The priority of the event (either Critical or Normal, as configured by the platform at build-time) shouldnâ€™t cause priority inversion. This means:”…””}”(hjh!jŽubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jŠubjg )”}”(hhh]”(jl )”}”(hŒiIf it's of Normal priority, neither Normal nor Critical priority dispatch must be outstanding on the PE. ”h]”j£)”}”(hŒhIf it's of Normal priority, neither Normal nor Critical priority dispatch must be outstanding on the PE.”h]”hŒjIf itâ€™s of Normal priority, neither Normal nor Critical priority dispatch must be outstanding on the PE.”…””}”(hj¥h!j£ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jŸubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jœubjl )”}”(hŒ]If it's of a Critical priority, no Critical priority dispatch must be outstanding on the PE. ”h]”j£)”}”(hŒ\If it's of a Critical priority, no Critical priority dispatch must be outstanding on the PE.”h]”hŒ^If itâ€™s of a Critical priority, no Critical priority dispatch must be outstanding on the PE.”…””}”(hj½h!j»ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!j·ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jœubeh"}”(h$]”h&]”h+]”h-]”h/]”jö j÷ uh1jf hAj¡hCMh!jŠubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jÏhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jö j÷ uh1jf hAj¡hCKýh!jœhhubj£)”}”(hŒXFurther, the caller should be aware of the following assumptions made by the dispatcher:”h]”hŒXFurther, the caller should be aware of the following assumptions made by the dispatcher:”…””}”(hjãh!jáhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jœhhubjg )”}”(hhh]”(jl )”}”(hŒPThe caller of the API is a component running in EL3; for example, a RAS driver. ”h]”j£)”}”(hŒOThe caller of the API is a component running in EL3; for example, a RAS driver.”h]”hŒOThe caller of the API is a component running in EL3; for example, a RAS driver.”…””}”(hjøh!jöubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!jòubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jïhhhAj¡hCNubjl )”}”(hŒòThe requested dispatch will be permitted by the Exception Handling Framework. I.e. the caller must make sure that the requested dispatch has sufficient priority so as not to cause priority level inversion within Exception Handling Framework. ”h]”j£)”}”(hŒñThe requested dispatch will be permitted by the Exception Handling Framework. I.e. the caller must make sure that the requested dispatch has sufficient priority so as not to cause priority level inversion within Exception Handling Framework.”h]”hŒñThe requested dispatch will be permitted by the Exception Handling Framework. I.e. the caller must make sure that the requested dispatch has sufficient priority so as not to cause priority level inversion within Exception Handling Framework.”…””}”(hjh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jïhhhAj¡hCNubjl )”}”(hŒyThe caller must be prepared for the SDEI dispatcher to restore the Non-secure context, and mark that the active context. ”h]”j£)”}”(hŒxThe caller must be prepared for the SDEI dispatcher to restore the Non-secure context, and mark that the active context.”h]”hŒxThe caller must be prepared for the SDEI dispatcher to restore the Non-secure context, and mark that the active context.”…””}”(hj(h!j&ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM h!j"ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jïhhhAj¡hCNubjl )”}”(hŒ›The call will block until the SDEI client completes the event (i.e. when the client calls either ``SDEI_EVENT_COMPLETE`` or ``SDEI_COMPLETE_AND_RESUME``). ”h]”j£)”}”(hŒšThe call will block until the SDEI client completes the event (i.e. when the client calls either ``SDEI_EVENT_COMPLETE`` or ``SDEI_COMPLETE_AND_RESUME``).”h]”(hŒaThe call will block until the SDEI client completes the event (i.e. when the client calls either ”…””}”(hŒaThe call will block until the SDEI client completes the event (i.e. when the client calls either ”h!j>ubj—)”}”(hŒ``SDEI_EVENT_COMPLETE``”h]”hŒSDEI_EVENT_COMPLETE”…””}”(hhh!jGubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j>ubhŒ or ”…””}”(hŒ or ”h!j>ubj—)”}”(hŒ``SDEI_COMPLETE_AND_RESUME``”h]”hŒSDEI_COMPLETE_AND_RESUME”…””}”(hhh!jZubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j>ubhŒ).”…””}”(hŒ).”h!j>ubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM#h!j:ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jïhhhAj¡hCNubjl )”}”(hŒSThe caller must be prepared for this API to return failure and handle accordingly. ”h]”j£)”}”(hŒRThe caller must be prepared for this API to return failure and handle accordingly.”h]”hŒRThe caller must be prepared for this API to return failure and handle accordingly.”…””}”(hjh!j}ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM&h!jyubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jk h!jïhhhAj¡hCNubeh"}”(h$]”h&]”h+]”h-]”h/]”jö j÷ uh1jf hAj¡hCMh!jœhhubeh"}”(h$]”Œconditions-for-event-dispatch”ah&]”h+]”Œconditions for event dispatch”ah-]”h/]”uh1jŒh!jˆhhhAj¡hCKøubeh"}”(h$]”(j€jñeh&]”h+]”(Œexplicit dispatch of events”Œexplicit-dispatch-of-events”eh-]”h/]”uh1jŒh!jŽhhhAj¡hCKÓjh}”j¤jvsjj}”j€jvsjXKubj)”}”(hhh]”(j’)”}”(hŒPorting requirements”h]”hŒPorting requirements”…””}”(hj®h!j¬hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!j©hhhAj¡hCM*ubj£)”}”(hŒ{The porting requirements of the SDEI dispatcher are outlined in the :ref:`Porting Guide `.”h]”(hŒDThe porting requirements of the SDEI dispatcher are outlined in the ”…””}”(hŒDThe porting requirements of the SDEI dispatcher are outlined in the ”h!jºhhhANhCNubh)”}”(hŒ6:ref:`Porting Guide `”h]”h)”}”(hjÅh]”hŒ Porting Guide”…””}”(hhh!jÇubah"}”(h$]”h&]”(h(Œstd”Œstd-ref”eh+]”h-]”h/]”uh1hh!jÃubah"}”(h$]”h&]”h+]”h-]”h/]”Œrefdoc”h9Œ refdomain”jÑŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆh?Œporting_guide_sdei_requirements”uh1hhAj¡hCM,h!jºubhŒ.”…””}”(hjDh!jºhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM,h!j©hhubeh"}”(h$]”Œporting-requirements”ah&]”h+]”Œporting requirements”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCM*ubj)”}”(hhh]”(j’)”}”(hŒ#Note on writing SDEI event handlers”h]”hŒ#Note on writing SDEI event handlers”…””}”(hjúh!jøhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j‘h!jõhhhAj¡hCM0ubj£)”}”(hŒh*This section pertains to SDEI event handlers in general, not just when using the TF-A SDEI dispatcher.*”h]”jý)”}”(hjh]”hŒfThis section pertains to SDEI event handlers in general, not just when using the TF-A SDEI dispatcher.”…””}”(hhh!j ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM2h!jõhhubj£)”}”(hXZThe SDEI specification requires that event handlers preserve the contents of all registers except ``x0`` to ``x17``. This has significance if event handler is written in C: compilers typically adjust the stack frame at the beginning and end of C functions. For example, AArch64 GCC typically produces the following function prologue and epilogue:”h]”(hŒbThe SDEI specification requires that event handlers preserve the contents of all registers except ”…””}”(hŒbThe SDEI specification requires that event handlers preserve the contents of all registers except ”h!jhhhANhCNubj—)”}”(hŒ``x0``”h]”hŒx0”…””}”(hhh!j&ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!jubhŒ to ”…””}”(hŒ to ”h!jhhhANhCNubj—)”}”(hŒ``x17``”h]”hŒx17”…””}”(hhh!j9ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!jubhŒç. This has significance if event handler is written in C: compilers typically adjust the stack frame at the beginning and end of C functions. For example, AArch64 GCC typically produces the following function prologue and epilogue:”…””}”(hŒç. This has significance if event handler is written in C: compilers typically adjust the stack frame at the beginning and end of C functions. For example, AArch64 GCC typically produces the following function prologue and epilogue:”h!jhhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCM5h!jõhhubj¸)”}”(hŒ¬c_event_handler: stp x29, x30, [sp,#-32]! mov x29, sp ... bl ... ... ldp x29, x30, [sp],#32 ret”h]”hŒ¬c_event_handler: stp x29, x30, [sp,#-32]! mov x29, sp ... bl ... ... ldp x29, x30, [sp],#32 ret”…””}”(hhh!jRubah"}”(h$]”h&]”h+]”h-]”h/]”jÊjËuh1j·hAj¡hCM=h!jõhhubj£)”}”(hX–The register ``x29`` is used as frame pointer in the prologue. Because neither a valid ``SDEI_EVENT_COMPLETE`` nor ``SDEI_EVENT_COMPLETE_AND_RESUME`` calls return to the handler, the epilogue never gets executed, and registers ``x29`` and ``x30`` (in the case above) are inadvertently corrupted. This violates the SDEI specification, and the normal execution thereafter will result in unexpected behaviour.”h]”(hŒ The register ”…””}”(hŒ The register ”h!j`hhhANhCNubj—)”}”(hŒ``x29``”h]”hŒx29”…””}”(hhh!jiubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j`ubhŒC is used as frame pointer in the prologue. Because neither a valid ”…””}”(hŒC is used as frame pointer in the prologue. Because neither a valid ”h!j`hhhANhCNubj—)”}”(hŒ``SDEI_EVENT_COMPLETE``”h]”hŒSDEI_EVENT_COMPLETE”…””}”(hhh!j|ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j`ubhŒ nor ”…””}”(hŒ nor ”h!j`hhhANhCNubj—)”}”(hŒ"``SDEI_EVENT_COMPLETE_AND_RESUME``”h]”hŒSDEI_EVENT_COMPLETE_AND_RESUME”…””}”(hhh!jubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j`ubhŒN calls return to the handler, the epilogue never gets executed, and registers ”…””}”(hŒN calls return to the handler, the epilogue never gets executed, and registers ”h!j`hhhANhCNubj—)”}”(hŒ``x29``”h]”hŒx29”…””}”(hhh!j¢ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j`ubhŒ and ”…””}”(hŒ and ”h!j`hhhANhCNubj—)”}”(hŒ``x30``”h]”hŒx30”…””}”(hhh!jµubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j–h!j`ubhŒ (in the case above) are inadvertently corrupted. This violates the SDEI specification, and the normal execution thereafter will result in unexpected behaviour.”…””}”(hŒ (in the case above) are inadvertently corrupted. This violates the SDEI specification, and the normal execution thereafter will result in unexpected behaviour.”h!j`hhhANhCNubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMJh!jõhhubj£)”}”(hŒ†To work this around, it's advised that the top-level event handlers are implemented in assembly, following a similar pattern as below:”h]”hŒˆTo work this around, itâ€™s advised that the top-level event handlers are implemented in assembly, following a similar pattern as below:”…””}”(hjÐh!jÎhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMQh!jõhhubj¸)”}”(hXPasm_event_handler: /* Save link register whilst maintaining stack alignment */ stp xzr, x30, [sp, #-16]! bl c_event_handler /* Restore link register */ ldp xzr, x30, [sp], #16 /* Complete call */ ldr x0, =SDEI_EVENT_COMPLETE smc #0 b .”h]”hXPasm_event_handler: /* Save link register whilst maintaining stack alignment */ stp xzr, x30, [sp, #-16]! bl c_event_handler /* Restore link register */ ldp xzr, x30, [sp], #16 /* Complete call */ ldr x0, =SDEI_EVENT_COMPLETE smc #0 b .”…””}”(hhh!jÜubah"}”(h$]”h&]”h+]”h-]”h/]”jÊjËuh1j·hAj¡hCMVh!jõhhubh Œ transition”“”)”}”(hŒ--------------”h]”h"}”(h$]”h&]”h+]”h-]”h/]”uh1jêhAj¡hCMch!jõhhubj£)”}”(hŒM*Copyright (c) 2017-2019, Arm Limited and Contributors. All rights reserved.*”h]”jý)”}”(hjøh]”hŒKCopyright (c) 2017-2019, Arm Limited and Contributors. All rights reserved.”…””}”(hhh!júubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jöubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMeh!jõhhubh Œrubric”“”)”}”(hŒ Footnotes”h]”hŒ Footnotes”…””}”(hjh!jhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j h!jõhhhAj¡hCMhubh Œfootnote”“”)”}”(hŒPExcept event 0, which is defined by the SDEI specification as a standard event. ”h]”(h Œlabel”“”)”}”(hhh]”hŒ1”…””}”(hhh!j%hhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j#h!jhhhANhCNubj£)”}”(hŒOExcept event 0, which is defined by the SDEI specification as a standard event.”h]”hŒOExcept event 0, which is defined by the SDEI specification as a standard event.”…””}”(hj4h!j2ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMih!jubeh"}”(h$]”j$ah&]”h+]”Œ std-event”ah-]”h/]”jaj"Kj%h9uh1jhAj¡hCMih!jõhhubj)”}”(hŒ¦Examples of critical events are *SError*, *Synchronous External Abort*, *Fault Handling interrupt* or *Error Recovery interrupt* from one of RAS nodes in the system. ”h]”(j$)”}”(hhh]”hŒ2”…””}”(hhh!jKhhhANhCNubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j#h!jGhhhANhCNubj£)”}”(hŒ¥Examples of critical events are *SError*, *Synchronous External Abort*, *Fault Handling interrupt* or *Error Recovery interrupt* from one of RAS nodes in the system.”h]”(hŒ Examples of critical events are ”…””}”(hŒ Examples of critical events are ”h!jXubjý)”}”(hŒ*SError*”h]”hŒSError”…””}”(hhh!jaubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jXubhŒ, ”…””}”(hŒ, ”h!jXubjý)”}”(hŒ*Synchronous External Abort*”h]”hŒSynchronous External Abort”…””}”(hhh!jtubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jXubhŒ, ”…””}”(hjsh!jXubjý)”}”(hŒ*Fault Handling interrupt*”h]”hŒFault Handling interrupt”…””}”(hhh!j†ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jXubhŒ or ”…””}”(hŒ or ”h!jXubjý)”}”(hŒ*Error Recovery interrupt*”h]”hŒError Recovery interrupt”…””}”(hhh!j™ubah"}”(h$]”h&]”h+]”h-]”h/]”uh1jüh!jXubhŒ% from one of RAS nodes in the system.”…””}”(hŒ% from one of RAS nodes in the system.”h!jXubeh"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢hAj¡hCMlh!jGubeh"}”(h$]”jzah&]”h+]”Œcritical-event”ah-]”h/]”juaj"Kj%h9uh1jhAj¡hCMlh!jõhhubjL)”}”(hŒ‰.. _SDEI specification: http://infocenter.arm.com/help/topic/com.arm.doc.den0054a/ARM_DEN0054A_Software_Delegated_Exception_Interface.pdf”h]”h"}”(h$]”Œsdei-specification”ah&]”h+]”Œsdei specification”ah-]”h/]”Œrefuri”Œqhttp://infocenter.arm.com/help/topic/com.arm.doc.den0054a/ARM_DEN0054A_Software_Delegated_Exception_Interface.pdf”uh1jKhCMµh!jõhhhAj¡jXKubjL)”}”(hŒA.. _Software Delegated Exception Interface: `SDEI specification`_”h]”h"}”(h$]”Œ&software-delegated-exception-interface”ah&]”h+]”Œ&software delegated exception interface”ah-]”h/]”jÅjÆuh1jKŒindirect_reference_name”ŒSDEI specification”hCM¶h!jõhhhAj¡j&Kubeh"}”(h$]”Œ#note-on-writing-sdei-event-handlers”ah&]”h+]”Œ#note on writing sdei event handlers”ah-]”h/]”uh1jŒh!jŽhhhAj¡hCM0ubeh"}”(h$]”Œ+sdei-software-delegated-exception-interface”ah&]”h+]”Œ,sdei: software delegated exception interface”ah-]”h/]”uh1jŒh!hhhhAj¡hCKubeh"}”(h$]”h&]”h+]”h-]”h/]”Œsource”j¡uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(j‘NŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”j¡Œ_destination”NŒ _config_files”]”Œpep_references”NŒpep_base_url”Œ https://www.python.org/dev/peps/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œhttps://tools.ietf.org/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒenv”NubŒreporter”NŒindirect_targets”]”jÇaŒsubstitution_defs”}”(hHhhshKhžhvhÉh¡hôhÌjh÷jJj"jujMj jxjËj£jöjÎj!jùjLj$jwjOj¢jzjÍj¥jøjÐj#jûjNj&jyjQj¤j|jÏj§jújÒj%jýjPj(j{jSj¦j~jÑj©jüjÔj'jÿjRj*j}jUj¨j€jÓj«jþjÖj)jjTj,jjWjªj‚jÕjjjØj+jjVj.jjYj¬j„j×j¯jjÚj-jjXj0jƒj[j®j†jÙj±j jÜj/ j jZ j2 j… j] j° jˆ jÛ j³ j jÞ j1 j j\ j4 j‡ j_ j² jŠ jÝ jµ jjà j3jj^j6j‰jauŒsubstitution_names”}”(Œaarch32”hHŒaarch64”hsŒamu”hžŒamus”hÉŒapi”hôŒbti”jŒcot”juŒcss”j Œcve”jËŒdtb”jöŒds-5”j!Œdsu”jLŒdt”jwŒel”j¢Œehf”jÍŒfconf”jøŒfdt”j#Œff-a”jNŒfip”jyŒfvp”j¤Œfwu”jÏŒgic”júŒisa”j%Œlinaro”jPŒmmu”j{Œmpam”j¦Œmpmm”jÑŒmpidr”jüŒmte”j'Œoen”jRŒop-tee”j}Œote”j¨Œpdd”jÓŒpauth”jþŒpmf”j)Œpsci”jTŒras”jŒrot”jªŒscmi”jÕŒscp”jŒsdei”j+Œsds”jVŒsea”jŒsip”j×Œsmc”jŒsmccc”j-Œsoc”jXŒsp”jƒŒspd”j®Œspm”jÙŒssbs”j Œsve”j/ Œtbb”jZ Œtbbr”j… Œtee”j° Œtf-a”jÛ Œtf-m”j Œtlb”j1 Œtlk”j\ Œtrng”j‡ Œtsp”j² Œtzc”jÝ Œubsan”jŒuefi”j3Œwdog”j^Œxlat”j‰uŒrefnames”}”(Œ std-event”]”jaŒdetermining client el”]”j.aŒexplicit dispatch of events”]”jàaŒevent flags”]”jaŒ1configuration within exception handling framework”]”j¾aŒevent definition example”]”jAaŒdefining events”]”jŠaŒgeneral sdei dispatch”]”(jFj€eŒcritical-event”]”jkaŒsdei specification”]”jÇauŒrefids”}”(jW]”jMaj€]”jvaj$]”jajz]”jkauŒnameids”}”(jâjßj j jejWj£j›jœjjÒjRj¿jÏj…j?j¤j€j£jñjœj™jòjïjÚj×jDj$j¶jzjÂj¿jÐjÍuŒ nametypes”}”(jâNj Njeˆj£NjœNjÒNj¿Nj…Nj¤ˆj£NjœNjòNjÚNjDˆj¶ˆjÂˆjÐˆuh$}”(jßjŽj j²jjjWjYj›j jj]jRj¦jÏjÕj?jÂj€jˆjñjˆjujkj™jœjïj©j×jõj$jjzjGj¿j¹jÍjÇuŒ footnote_refs”}”(j…]”jaj•]”jkauŒ citation_refs”}”Œ autofootnotes”]”(jjGeŒautofootnote_refs”]”(jjkeŒsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œcollections”ŒCounter”“”}”jKs…”R”Œparse_messages”]”Œtransform_messages”]”(h Œsystem_message”“”)”}”(hhh]”j£)”}”(hhh]”hŒAHyperlink target "explicit-dispatch-of-events" is not referenced.”…””}”(hhh!jÈubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢h!jÅubah"}”(h$]”h&]”h+]”h-]”h/]”Œlevel”KŒtype”ŒINFO”Œsource”j¡Œline”Muh1jÃubjÄ)”}”(hhh]”j£)”}”(hhh]”hŒLHyperlink target "software delegated exception interface" is not referenced.”…””}”(hhh!jãubah"}”(h$]”h&]”h+]”h-]”h/]”uh1j¢h!jàubah"}”(h$]”h&]”h+]”h-]”h/]”Œlevel”KŒtype”jÝŒsource”j¡Œline”M¶uh1jÃubeŒtransformer”NŒ decoration”Nhhub.