blob: dd8659099dede228a9c85458b5ee05ebd4e3ff10 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>LCOV - skiboot.info - include/opal-internal.h</title>
<link rel="stylesheet" type="text/css" href="../gcov.css">
</head>
<body>
<table width="100%" border=0 cellspacing=0 cellpadding=0>
<tr><td class="title">LCOV - code coverage report</td></tr>
<tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
<tr>
<td width="100%">
<table cellpadding=1 border=0 width="100%">
<tr>
<td width="10%" class="headerItem">Current view:</td>
<td width="10%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">include</a> - opal-internal.h<span style="font-size: 80%;"> (source / <a href="opal-internal.h.func-c.html">functions</a>)</span></td>
<td width="5%"></td>
<td width="5%"></td>
<td width="5%" class="headerCovTableHead">Coverage</td>
<td width="5%" class="headerCovTableHead" title="Covered + Uncovered code">Total</td>
<td width="5%" class="headerCovTableHead" title="Exercised code only">Hit</td>
</tr>
<tr>
<td class="headerItem">Test:</td>
<td class="headerValue">skiboot.info</td>
<td></td>
<td class="headerItem">Lines:</td>
<td class="headerCovTableEntryHi">100.0&nbsp;%</td>
<td class="headerCovTableEntry">8</td>
<td class="headerCovTableEntry">8</td>
</tr>
<tr>
<td class="headerItem">Test Date:</td>
<td class="headerValue">2025-06-27 16:54:26</td>
<td></td>
<td class="headerItem">Functions:</td>
<td class="headerCovTableEntryHi">100.0&nbsp;%</td>
<td class="headerCovTableEntry">1</td>
<td class="headerCovTableEntry">1</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td class="headerItem">Branches:</td>
<td class="headerCovTableEntryHi">-</td>
<td class="headerCovTableEntry">0</td>
<td class="headerCovTableEntry">0</td>
</tr>
<tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
</table>
</td>
</tr>
<tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
</table>
<table cellpadding=0 cellspacing=0 border=0>
<tr>
<td><br></td>
</tr>
<tr>
<td>
<pre class="sourceHeading"> Branch data Line data Source code</pre>
<pre class="source">
<span id="L1"><span class="lineNum"> 1</span> : : // SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later</span>
<span id="L2"><span class="lineNum"> 2</span> : : /*</span>
<span id="L3"><span class="lineNum"> 3</span> : : * Internal header for OPAL API related things in skiboot</span>
<span id="L4"><span class="lineNum"> 4</span> : : *</span>
<span id="L5"><span class="lineNum"> 5</span> : : * Copyright 2013-2019 IBM Corp.</span>
<span id="L6"><span class="lineNum"> 6</span> : : */</span>
<span id="L7"><span class="lineNum"> 7</span> : : </span>
<span id="L8"><span class="lineNum"> 8</span> : : #ifndef __OPAL_INTERNAL_H</span>
<span id="L9"><span class="lineNum"> 9</span> : : #define __OPAL_INTERNAL_H</span>
<span id="L10"><span class="lineNum"> 10</span> : : </span>
<span id="L11"><span class="lineNum"> 11</span> : : </span>
<span id="L12"><span class="lineNum"> 12</span> : : #include &lt;skiboot.h&gt;</span>
<span id="L13"><span class="lineNum"> 13</span> : : </span>
<span id="L14"><span class="lineNum"> 14</span> : : /* An opal table entry */</span>
<span id="L15"><span class="lineNum"> 15</span> : : struct opal_table_entry {</span>
<span id="L16"><span class="lineNum"> 16</span> : : void *func;</span>
<span id="L17"><span class="lineNum"> 17</span> : : u32 token;</span>
<span id="L18"><span class="lineNum"> 18</span> : : u32 nargs;</span>
<span id="L19"><span class="lineNum"> 19</span> : : };</span>
<span id="L20"><span class="lineNum"> 20</span> : : </span>
<span id="L21"><span class="lineNum"> 21</span> : : #ifdef __CHECKER__</span>
<span id="L22"><span class="lineNum"> 22</span> : : #define __opal_func_test_arg(__func, __nargs) 0</span>
<span id="L23"><span class="lineNum"> 23</span> : : #else</span>
<span id="L24"><span class="lineNum"> 24</span> : : #define __opal_func_test_arg(__func, __nargs) \</span>
<span id="L25"><span class="lineNum"> 25</span> : : sizeof(__func( __test_args##__nargs ))</span>
<span id="L26"><span class="lineNum"> 26</span> : : #endif</span>
<span id="L27"><span class="lineNum"> 27</span> : : </span>
<span id="L28"><span class="lineNum"> 28</span> : : #define opal_call(__tok, __func, __nargs) \</span>
<span id="L29"><span class="lineNum"> 29</span> : : static struct opal_table_entry __e_##__func __used __section(&quot;.opal_table&quot;) = \</span>
<span id="L30"><span class="lineNum"> 30</span> : : { .func = __func, .token = __tok, \</span>
<span id="L31"><span class="lineNum"> 31</span> : : .nargs = __nargs + 0 * __opal_func_test_arg(__func, __nargs) }</span>
<span id="L32"><span class="lineNum"> 32</span> : : </span>
<span id="L33"><span class="lineNum"> 33</span> : : /* Make sure function takes args they claim. Look away now... */</span>
<span id="L34"><span class="lineNum"> 34</span> : : #define __test_args0</span>
<span id="L35"><span class="lineNum"> 35</span> : : #define __test_args1 0</span>
<span id="L36"><span class="lineNum"> 36</span> : : #define __test_args2 0,0</span>
<span id="L37"><span class="lineNum"> 37</span> : : #define __test_args3 0,0,0</span>
<span id="L38"><span class="lineNum"> 38</span> : : #define __test_args4 0,0,0,0</span>
<span id="L39"><span class="lineNum"> 39</span> : : #define __test_args5 0,0,0,0,0</span>
<span id="L40"><span class="lineNum"> 40</span> : : #define __test_args6 0,0,0,0,0,0</span>
<span id="L41"><span class="lineNum"> 41</span> : : #define __test_args7 0,0,0,0,0,0,0</span>
<span id="L42"><span class="lineNum"> 42</span> : : </span>
<span id="L43"><span class="lineNum"> 43</span> : : extern struct opal_table_entry __opal_table_start[];</span>
<span id="L44"><span class="lineNum"> 44</span> : : extern struct opal_table_entry __opal_table_end[];</span>
<span id="L45"><span class="lineNum"> 45</span> : : </span>
<span id="L46"><span class="lineNum"> 46</span> : : extern uint64_t opal_pending_events;</span>
<span id="L47"><span class="lineNum"> 47</span> : : </span>
<span id="L48"><span class="lineNum"> 48</span> : : extern struct dt_node *opal_node;</span>
<span id="L49"><span class="lineNum"> 49</span> : : </span>
<span id="L50"><span class="lineNum"> 50</span> : : extern void opal_table_init(void);</span>
<span id="L51"><span class="lineNum"> 51</span> : : extern void opal_update_pending_evt(uint64_t evt_mask, uint64_t evt_values);</span>
<span id="L52"><span class="lineNum"> 52</span> : : uint64_t opal_dynamic_event_alloc(void);</span>
<span id="L53"><span class="lineNum"> 53</span> : : void opal_dynamic_event_free(uint64_t event);</span>
<span id="L54"><span class="lineNum"> 54</span> : : extern void add_opal_node(void);</span>
<span id="L55"><span class="lineNum"> 55</span> : : </span>
<span id="L56"><span class="lineNum"> 56</span> : : #define opal_register(token, func, nargs) \</span>
<span id="L57"><span class="lineNum"> 57</span> : : __opal_register((token) + 0*__opal_func_test_arg(func, nargs), \</span>
<span id="L58"><span class="lineNum"> 58</span> : : (func), (nargs))</span>
<span id="L59"><span class="lineNum"> 59</span> : : extern void __opal_register(uint64_t token, void *func, unsigned num_args);</span>
<span id="L60"><span class="lineNum"> 60</span> : : </span>
<span id="L61"><span class="lineNum"> 61</span> : : int64_t opal_quiesce(uint32_t shutdown_type, int32_t cpu);</span>
<span id="L62"><span class="lineNum"> 62</span> : : </span>
<span id="L63"><span class="lineNum"> 63</span> : : /* Warning: no locking at the moment, do at init time only</span>
<span id="L64"><span class="lineNum"> 64</span> : : *</span>
<span id="L65"><span class="lineNum"> 65</span> : : * XXX TODO: Add the big RCU-ish &quot;opal API lock&quot; to protect us here</span>
<span id="L66"><span class="lineNum"> 66</span> : : * which will also be used for other things such as runtime updates</span>
<span id="L67"><span class="lineNum"> 67</span> : : */</span>
<span id="L68"><span class="lineNum"> 68</span> : : extern void opal_add_poller(void (*poller)(void *data), void *data);</span>
<span id="L69"><span class="lineNum"> 69</span> : : extern void opal_del_poller(void (*poller)(void *data));</span>
<span id="L70"><span class="lineNum"> 70</span> : : extern void opal_run_pollers(void);</span>
<span id="L71"><span class="lineNum"> 71</span> : : </span>
<span id="L72"><span class="lineNum"> 72</span> : : /*</span>
<span id="L73"><span class="lineNum"> 73</span> : : * Warning: no locking, only call that from the init processor</span>
<span id="L74"><span class="lineNum"> 74</span> : : */</span>
<span id="L75"><span class="lineNum"> 75</span> : : extern void opal_add_host_sync_notifier(bool (*notify)(void *data), void *data);</span>
<span id="L76"><span class="lineNum"> 76</span> : : extern void opal_del_host_sync_notifier(bool (*notify)(void *data), void *data);</span>
<span id="L77"><span class="lineNum"> 77</span> : : </span>
<span id="L78"><span class="lineNum"> 78</span> : : /*</span>
<span id="L79"><span class="lineNum"> 79</span> : : * Opal internal function prototype</span>
<span id="L80"><span class="lineNum"> 80</span> : : */</span>
<span id="L81"><span class="lineNum"> 81</span> : : struct OpalHMIEvent;</span>
<span id="L82"><span class="lineNum"> 82</span> : : extern int occ_msg_queue_occ_reset(void);</span>
<span id="L83"><span class="lineNum"> 83</span> : : </span>
<span id="L84"><span class="lineNum"> 84</span> : : extern unsigned long top_of_ram;</span>
<span id="L85"><span class="lineNum"> 85</span> : : </span>
<span id="L86"><span class="lineNum"> 86</span> : : /*</span>
<span id="L87"><span class="lineNum"> 87</span> : : * Returns true if the address is valid, false otherwise</span>
<span id="L88"><span class="lineNum"> 88</span> : : *</span>
<span id="L89"><span class="lineNum"> 89</span> : : * Checks if the passed address belongs to real address space</span>
<span id="L90"><span class="lineNum"> 90</span> : : * or 0xc000... kernel address space. It also checks that</span>
<span id="L91"><span class="lineNum"> 91</span> : : * addr &lt;= total physical memory. The magic value 60 comes</span>
<span id="L92"><span class="lineNum"> 92</span> : : * from 60 bit real address mentioned in section 5.7 of the</span>
<span id="L93"><span class="lineNum"> 93</span> : : * Power ISA (Book 3S).</span>
<span id="L94"><span class="lineNum"> 94</span> : : */</span>
<span id="L95"><span class="lineNum"> 95</span> :<span class="tlaGNC tlaBgGNC"> 45 : static inline bool opal_addr_valid(const void *addr)</span></span>
<span id="L96"><span class="lineNum"> 96</span> : : {</span>
<span id="L97"><span class="lineNum"> 97</span> :<span class="tlaGNC"> 45 : unsigned long val = (unsigned long)addr;</span></span>
<span id="L98"><span class="lineNum"> 98</span> :<span class="tlaGNC"> 45 : if ((val &gt;&gt; 60) != 0xc &amp;&amp; (val &gt;&gt; 60) != 0x0)</span></span>
<span id="L99"><span class="lineNum"> 99</span> :<span class="tlaGNC"> 2 : return false;</span></span>
<span id="L100"><span class="lineNum"> 100</span> :<span class="tlaGNC"> 43 : val &amp;= ~0xf000000000000000UL;</span></span>
<span id="L101"><span class="lineNum"> 101</span> :<span class="tlaGNC"> 43 : if (val &gt; top_of_ram)</span></span>
<span id="L102"><span class="lineNum"> 102</span> :<span class="tlaGNC"> 1 : return false;</span></span>
<span id="L103"><span class="lineNum"> 103</span> :<span class="tlaGNC"> 42 : return true;</span></span>
<span id="L104"><span class="lineNum"> 104</span> : : }</span>
<span id="L105"><span class="lineNum"> 105</span> : : </span>
<span id="L106"><span class="lineNum"> 106</span> : : #endif /* __OPAL_INTERNAL_H */</span>
</pre>
</td>
</tr>
</table>
<br>
<table width="100%" border=0 cellspacing=0 cellpadding=0>
<tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
<tr><td class="versionInfo">Generated by: <a href="https://github.com//linux-test-project/lcov" target="_parent">LCOV version 2.0-1</a></td></tr>
</table>
<br>
</body>
</html>