443 lines
60 KiB
HTML
443 lines
60 KiB
HTML
<!-- HTML header for doxygen 1.9.1-->
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.15.0"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
<title>L4Re Operating System Framework: l4/re/util/counting_cap_alloc Source File</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="navtree.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="navtreedata.js"></script>
|
|
<script type="text/javascript" src="navtree.js"></script>
|
|
<script type="text/javascript" src="cookie.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
<link href="doxygen-awesome.css" rel="stylesheet" type="text/css"/>
|
|
<link href="l4re-awesome.css" rel="stylesheet" type="text/css"/>
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td id="projectlogo"><img alt="Logo" src="L4Re_rgb_logo_quer_hg_h55.png"/></td>
|
|
<td id="projectalign" style="padding-left: 0.5em;">
|
|
<div id="projectname">L4Re Operating System Framework
|
|
</div>
|
|
<div id="projectbrief">Interface and Usage Documentation</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.15.0 -->
|
|
<script type="text/javascript">
|
|
var searchBox = new SearchBox("searchBox", "search/",'.html');
|
|
</script>
|
|
<script type="text/javascript">
|
|
$(function() { codefold.init(); });
|
|
</script>
|
|
<script type="text/javascript" src="menudata.js"></script>
|
|
<script type="text/javascript" src="menu.js"></script>
|
|
<script type="text/javascript">
|
|
$(function() {
|
|
initMenu('',true,false,'search.php','Search',true);
|
|
$(function() { init_search(); });
|
|
});
|
|
</script>
|
|
<div id="main-nav"></div>
|
|
</div><!-- top -->
|
|
<div id="side-nav" class="ui-resizable side-nav-resizable">
|
|
<div id="nav-tree">
|
|
<div id="nav-tree-contents">
|
|
<div id="nav-sync" class="sync"></div>
|
|
</div>
|
|
</div>
|
|
<div id="splitbar" style="-moz-user-select:none;"
|
|
class="ui-resizable-handle">
|
|
</div>
|
|
</div>
|
|
<script type="text/javascript">
|
|
$(function(){initNavTree('counting__cap__alloc_source.html','',''); });
|
|
</script>
|
|
<div id="container">
|
|
<div id="doc-content">
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<div id="MSearchResults">
|
|
<div class="SRPage">
|
|
<div id="SRIndex">
|
|
<div id="SRResults"></div>
|
|
<div class="SRStatus" id="Loading">Loading...</div>
|
|
<div class="SRStatus" id="Searching">Searching...</div>
|
|
<div class="SRStatus" id="NoMatches">No Matches</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="header">
|
|
<div class="headertitle"><div class="title">counting_cap_alloc</div></div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<a href="counting__cap__alloc.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno"> 1</span><span class="comment">// vim:set ft=cpp: -*- Mode: C++ -*-</span></div>
|
|
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno"> 6</span><span class="comment">/*</span></div>
|
|
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno"> 7</span><span class="comment"> * (c) 2008-2010 Alexander Warg <warg@os.inf.tu-dresden.de></span></div>
|
|
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno"> 8</span><span class="comment"> * economic rights: Technische Universität Dresden (Germany)</span></div>
|
|
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno"> 9</span><span class="comment"> *</span></div>
|
|
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno"> 10</span><span class="comment"> * License: see LICENSE.spdx (in this directory or the directories above)</span></div>
|
|
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno"> 11</span><span class="comment"> */</span></div>
|
|
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno"> 12</span> </div>
|
|
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno"> 13</span><span class="preprocessor">#pragma once</span></div>
|
|
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno"> 14</span> </div>
|
|
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno"> 15</span><span class="preprocessor">#include <<a class="code" href="task.html">l4/sys/task</a>></span></div>
|
|
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno"> 16</span><span class="preprocessor">#include <<a class="code" href="sys_2assert_8h.html">l4/sys/assert.h</a>></span></div>
|
|
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno"> 17</span><span class="preprocessor">#include <<a class="code" href="re_2consts.html">l4/re/consts</a>></span></div>
|
|
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno"> 18</span> </div>
|
|
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno"> 19</span><span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceL4Re.html">L4Re</a> { <span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceL4Re_1_1Util.html">Util</a> {</div>
|
|
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno"> 20</span></div>
|
|
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno"> 26</span><span class="keyword">template</span>< <span class="keyword">typename</span> COUNTER = <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> ></div>
|
|
<div class="foldopen" id="foldopen00027" data-start="{" data-end="};">
|
|
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno"><a class="line" href="structL4Re_1_1Util_1_1Counter.html"> 27</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structL4Re_1_1Util_1_1Counter.html">Counter</a></div>
|
|
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno"> 28</span>{</div>
|
|
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno"> 29</span> <span class="keyword">typedef</span> COUNTER Type;</div>
|
|
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno"> 30</span> Type _cnt;</div>
|
|
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno"> 31</span> </div>
|
|
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno"> 32</span> <span class="keyword">static</span> Type nil() { <span class="keywordflow">return</span> 0; }</div>
|
|
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno"> 33</span> <span class="keyword">static</span> Type unused() { <span class="keywordflow">return</span> 0; }</div>
|
|
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno"> 34</span> </div>
|
|
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno"> 35</span> <span class="keywordtype">void</span> free() { _cnt = 0; }</div>
|
|
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno"> 36</span> <span class="keywordtype">bool</span> is_free()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> _cnt == 0; }</div>
|
|
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno"> 37</span> <span class="keywordtype">bool</span> is_saturated()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>Type<span class="keyword">></span>(_cnt + 1) == 0; }</div>
|
|
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno"> 38</span></div>
|
|
<div class="foldopen" id="foldopen00050" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno"><a class="line" href="structL4Re_1_1Util_1_1Counter.html#a8c4c3b5cb74c1943fede7a7919559d80"> 50</a></span> <span class="keywordtype">bool</span> <a class="code hl_function" href="structL4Re_1_1Util_1_1Counter.html#a8c4c3b5cb74c1943fede7a7919559d80">inc</a>()</div>
|
|
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno"> 51</span> {</div>
|
|
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno"> 52</span> <span class="keywordflow">if</span> (is_saturated())</div>
|
|
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno"> 53</span> <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// no change and no warning</span></div>
|
|
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno"> 54</span> ++_cnt;</div>
|
|
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno"> 55</span> <span class="keywordflow">if</span> (is_saturated())</div>
|
|
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno"> 56</span> <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// warn caller that counter is now saturated</span></div>
|
|
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno"> 57</span> <span class="keywordflow">else</span></div>
|
|
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno"> 58</span> <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// success</span></div>
|
|
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno"> 59</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno"> 60</span></div>
|
|
<div class="foldopen" id="foldopen00067" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno"><a class="line" href="structL4Re_1_1Util_1_1Counter.html#a2079acbfe2b03fb95d4e5f5912880958"> 67</a></span> Type <a class="code hl_function" href="structL4Re_1_1Util_1_1Counter.html#a2079acbfe2b03fb95d4e5f5912880958">dec</a>()</div>
|
|
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno"> 68</span> {</div>
|
|
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno"> 69</span> <span class="keywordflow">if</span> (is_saturated())</div>
|
|
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno"> 70</span> <span class="keywordflow">return</span> _cnt; <span class="comment">// no change</span></div>
|
|
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno"> 71</span> <span class="keywordflow">else</span></div>
|
|
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno"> 72</span> <span class="keywordflow">return</span> --_cnt; <span class="comment">// success</span></div>
|
|
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno"> 73</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno"> 74</span> </div>
|
|
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno"> 75</span> <span class="keywordtype">bool</span> try_alloc()</div>
|
|
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno"> 76</span> {</div>
|
|
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno"> 77</span> <span class="keywordflow">if</span> (_cnt == 0)</div>
|
|
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno"> 78</span> {</div>
|
|
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno"> 79</span> _cnt = 1;</div>
|
|
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno"> 80</span> <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
|
|
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno"> 81</span> }</div>
|
|
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno"> 82</span> <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
|
|
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno"> 83</span> }</div>
|
|
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno"> 84</span>};</div>
|
|
</div>
|
|
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno"> 85</span></div>
|
|
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno"> 97</span><span class="keyword">template</span>< <span class="keyword">typename</span> COUNTER = <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> ></div>
|
|
<div class="foldopen" id="foldopen00098" data-start="{" data-end="};">
|
|
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno"><a class="line" href="structL4Re_1_1Util_1_1Counter__atomic.html"> 98</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structL4Re_1_1Util_1_1Counter__atomic.html">Counter_atomic</a></div>
|
|
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno"> 99</span>{</div>
|
|
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno"> 100</span> <span class="keyword">typedef</span> COUNTER Type;</div>
|
|
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno"> 101</span> Type _cnt;</div>
|
|
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno"> 102</span> </div>
|
|
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno"> 103</span> <span class="keyword">static</span> Type nil() { <span class="keywordflow">return</span> 0; }</div>
|
|
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno"> 104</span> <span class="keyword">static</span> Type unused() { <span class="keywordflow">return</span> 1; }</div>
|
|
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno"> 105</span> </div>
|
|
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno"> 106</span> <span class="keywordtype">bool</span> is_free()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> __atomic_load_n(&_cnt, __ATOMIC_RELAXED) == 0; }</div>
|
|
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno"> 107</span> <span class="keyword">static</span> <span class="keywordtype">bool</span> is_saturated(Type cnt) { <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>Type<span class="keyword">></span>(cnt + 1) == 0; }</div>
|
|
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno"> 108</span> </div>
|
|
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno"> 109</span> <span class="keywordtype">bool</span> try_alloc()</div>
|
|
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno"> 110</span> {</div>
|
|
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno"> 111</span> Type expected = nil();</div>
|
|
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno"> 112</span> <span class="comment">// Use "acquire" memory ordering. Any operations tied to the capability slot</span></div>
|
|
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno"> 113</span> <span class="comment">// must only be observable after the slot has been occupied.</span></div>
|
|
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno"> 114</span> <span class="keywordflow">return</span> __atomic_compare_exchange_n(&_cnt, &expected, 2, <span class="keyword">false</span>,</div>
|
|
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno"> 115</span> __ATOMIC_ACQUIRE, __ATOMIC_RELAXED);</div>
|
|
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno"> 116</span> }</div>
|
|
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno"> 117</span></div>
|
|
<div class="foldopen" id="foldopen00121" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno"><a class="line" href="structL4Re_1_1Util_1_1Counter__atomic.html#abd26ba4101dec265a47fbfce99f02546"> 121</a></span> <span class="keywordtype">bool</span> <a class="code hl_function" href="structL4Re_1_1Util_1_1Counter__atomic.html#abd26ba4101dec265a47fbfce99f02546">inc</a>()</div>
|
|
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno"> 122</span> {</div>
|
|
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno"> 123</span> Type old_cnt = __atomic_load_n(&_cnt, __ATOMIC_RELAXED);</div>
|
|
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno"> 124</span> Type new_cnt;</div>
|
|
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno"> 125</span> <span class="keywordflow">do</span></div>
|
|
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno"> 126</span> {</div>
|
|
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno"> 127</span> <span class="keywordflow">if</span> (is_saturated(old_cnt))</div>
|
|
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno"> 128</span> <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// no change and no warning</span></div>
|
|
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno"> 129</span> new_cnt = old_cnt + 1;</div>
|
|
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno"> 130</span> }</div>
|
|
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno"> 131</span> <span class="keywordflow">while</span> (!__atomic_compare_exchange_n(&_cnt, &old_cnt, new_cnt, <span class="keyword">false</span>,</div>
|
|
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno"> 132</span> __ATOMIC_RELAXED, __ATOMIC_RELAXED));</div>
|
|
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno"> 133</span> <span class="keywordflow">if</span> (is_saturated(new_cnt))</div>
|
|
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno"> 134</span> <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// warn caller that counter is now saturated</span></div>
|
|
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno"> 135</span> <span class="keywordflow">else</span></div>
|
|
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno"> 136</span> <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// success</span></div>
|
|
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno"> 137</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno"> 138</span></div>
|
|
<div class="foldopen" id="foldopen00142" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno"><a class="line" href="structL4Re_1_1Util_1_1Counter__atomic.html#a6159fa39e4497e2ded0f22b392105d16"> 142</a></span> Type <a class="code hl_function" href="structL4Re_1_1Util_1_1Counter__atomic.html#a6159fa39e4497e2ded0f22b392105d16">dec</a>()</div>
|
|
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno"> 143</span> {</div>
|
|
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno"> 144</span> Type old_cnt = __atomic_load_n(&_cnt, __ATOMIC_RELAXED);</div>
|
|
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno"> 145</span> Type new_cnt;</div>
|
|
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno"> 146</span> <span class="keywordflow">do</span></div>
|
|
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno"> 147</span> {</div>
|
|
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno"> 148</span> <span class="keywordflow">if</span> (is_saturated(old_cnt))</div>
|
|
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno"> 149</span> <span class="keywordflow">return</span> old_cnt; <span class="comment">// no change</span></div>
|
|
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno"> 150</span> new_cnt = old_cnt - 1;</div>
|
|
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno"> 151</span> }</div>
|
|
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno"> 152</span> <span class="keywordflow">while</span> (!__atomic_compare_exchange_n(&_cnt, &old_cnt, new_cnt, <span class="keyword">false</span>,</div>
|
|
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno"> 153</span> __ATOMIC_RELAXED, __ATOMIC_RELAXED));</div>
|
|
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno"> 154</span> <span class="keywordflow">return</span> new_cnt; <span class="comment">// success</span></div>
|
|
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno"> 155</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno"> 156</span> </div>
|
|
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno"> 157</span> <span class="keywordtype">void</span> free()</div>
|
|
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno"> 158</span> {</div>
|
|
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno"> 159</span> <span class="comment">// Use "release" memory ordering to make sure that any operations tied to</span></div>
|
|
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno"> 160</span> <span class="comment">// the capability slot are observable by other threads before the slot can</span></div>
|
|
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno"> 161</span> <span class="comment">// be reused.</span></div>
|
|
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno"> 162</span> __atomic_store_n(&_cnt, 0, __ATOMIC_RELEASE);</div>
|
|
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno"> 163</span> }</div>
|
|
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno"> 164</span>};</div>
|
|
</div>
|
|
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno"> 165</span></div>
|
|
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno"> 190</span><span class="keyword">template</span> <<span class="keyword">typename</span> COUNTERTYPE, <span class="keyword">typename</span> Dbg></div>
|
|
<div class="foldopen" id="foldopen00191" data-start="{" data-end="};">
|
|
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html"> 191</a></span><span class="keyword">class </span>Counting_cap_alloc</div>
|
|
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno"> 192</span>{</div>
|
|
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno"> 193</span><span class="keyword">private</span>:</div>
|
|
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno"> 194</span> <span class="keywordtype">void</span> operator = (Counting_cap_alloc <span class="keyword">const</span> &) { }</div>
|
|
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno"> 195</span> <span class="keyword">typedef</span> COUNTERTYPE Counter;</div>
|
|
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno"> 196</span> </div>
|
|
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno"> 197</span> COUNTERTYPE *_items;</div>
|
|
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno"> 198</span> <span class="keywordtype">long</span> _free_hint;</div>
|
|
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno"> 199</span> <span class="keywordtype">long</span> _bias;</div>
|
|
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno"> 200</span> <span class="keywordtype">long</span> _capacity;</div>
|
|
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno"> 201</span> Dbg *_dbg;</div>
|
|
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno"> 202</span> </div>
|
|
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno"> 203</span><span class="keyword">public</span>:</div>
|
|
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno"> 204</span> </div>
|
|
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno"> 205</span> <span class="keyword">template</span> <<span class="keywordtype">unsigned</span> COUNT></div>
|
|
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno"> 206</span> <span class="keyword">struct </span>Storage</div>
|
|
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno"> 207</span> {</div>
|
|
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno"> 208</span> COUNTERTYPE _buf[COUNT];</div>
|
|
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno"> 209</span> <span class="keyword">typedef</span> COUNTERTYPE Buf_type[COUNT];</div>
|
|
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno"> 210</span> <span class="keyword">enum</span> { Size = COUNT };</div>
|
|
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno"> 211</span> };</div>
|
|
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno"> 212</span> </div>
|
|
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno"> 213</span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#af2fe4673eb75d7badb49a3615673f169">Counting_cap_alloc</a>(<span class="keywordtype">long</span> capacity, <span class="keywordtype">void</span> *m, <span class="keywordtype">long</span> bias, Dbg *dbg) noexcept</div>
|
|
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno"> 214</span> : _items((Counter*)m), _free_hint(0), _bias(bias), _capacity(capacity),</div>
|
|
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno"> 215</span> _dbg(dbg)</div>
|
|
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno"> 216</span> {}</div>
|
|
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno"> 217</span> </div>
|
|
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno"> 218</span><span class="keyword">protected</span>:</div>
|
|
<div class="foldopen" id="foldopen00224" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#af2fe4673eb75d7badb49a3615673f169"> 224</a></span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#af2fe4673eb75d7badb49a3615673f169">Counting_cap_alloc</a>() noexcept</div>
|
|
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno"> 225</span> : _items(0), _free_hint(0), _bias(0), _capacity(0)</div>
|
|
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno"> 226</span> {}</div>
|
|
</div>
|
|
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno"> 227</span></div>
|
|
<div class="foldopen" id="foldopen00242" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a0ad59cfc028e0e77e33182f2858cb1f1"> 242</a></span> <span class="keywordtype">void</span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a0ad59cfc028e0e77e33182f2858cb1f1">setup</a>(<span class="keywordtype">void</span> *m, <span class="keywordtype">long</span> capacity, <span class="keywordtype">long</span> bias, Dbg *dbg) <span class="keyword">noexcept</span></div>
|
|
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno"> 243</span> {</div>
|
|
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno"> 244</span> _items = <span class="keyword">static_cast<</span>Counter*<span class="keyword">></span>(m);</div>
|
|
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno"> 245</span> _capacity = capacity;</div>
|
|
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno"> 246</span> _bias = bias;</div>
|
|
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno"> 247</span> _dbg = dbg;</div>
|
|
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno"> 248</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno"> 249</span> </div>
|
|
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno"> 250</span><span class="keyword">public</span>:</div>
|
|
<div class="foldopen" id="foldopen00257" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#acbcdb89371502dd5bc820cd977176fe9"> 257</a></span> <a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#acbcdb89371502dd5bc820cd977176fe9">alloc</a>() noexcept</div>
|
|
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno"> 258</span> {</div>
|
|
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno"> 259</span> <span class="keywordtype">long</span> free_hint = __atomic_load_n(&_free_hint, __ATOMIC_RELAXED);</div>
|
|
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno"> 260</span> </div>
|
|
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno"> 261</span> <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = free_hint; i < _capacity; ++i)</div>
|
|
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno"> 262</span> <span class="keywordflow">if</span> (_items[i].try_alloc())</div>
|
|
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno"> 263</span> {</div>
|
|
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno"> 264</span> _free_hint = i + 1;</div>
|
|
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno"> 265</span> <span class="keywordflow">return</span> <a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a>((i + _bias) << <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879ac13ad59620aeba353454514a42950a85">L4_CAP_SHIFT</a>);</div>
|
|
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno"> 266</span> }</div>
|
|
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno"> 267</span> </div>
|
|
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno"> 268</span> <span class="comment">// _free_hint is not necessarily correct in case of multi-threading! Make</span></div>
|
|
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno"> 269</span> <span class="comment">// sure we don't miss any potentially free slots.</span></div>
|
|
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno"> 270</span> <span class="keywordflow">for</span> (<span class="keywordtype">long</span> i = 0; i < free_hint && i < _capacity; ++i)</div>
|
|
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno"> 271</span> <span class="keywordflow">if</span> (_items[i].try_alloc())</div>
|
|
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno"> 272</span> {</div>
|
|
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno"> 273</span> _free_hint = i + 1;</div>
|
|
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno"> 274</span> <span class="keywordflow">return</span> <a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a>((i + _bias) << <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879ac13ad59620aeba353454514a42950a85">L4_CAP_SHIFT</a>);</div>
|
|
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno"> 275</span> }</div>
|
|
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno"> 276</span> </div>
|
|
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno"> 277</span> <span class="keywordflow">return</span> <a class="code hl_enumvalue" href="classL4_1_1Cap__base.html#ac74dbedb04347341ba30ece923c12fe7af425c8e16afcd760ecb1f30bd6c1437a">L4::Cap<void>::Invalid</a>;</div>
|
|
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno"> 278</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno"> 279</span></div>
|
|
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno"> 281</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
|
|
<div class="foldopen" id="foldopen00282" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#ade1824504edcf74b1c8781128af995ec"> 282</a></span> <a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<T></a> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#ade1824504edcf74b1c8781128af995ec">alloc</a>() noexcept</div>
|
|
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno"> 283</span> {</div>
|
|
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno"> 284</span> <span class="keywordflow">return</span> <a class="code hl_function" href="namespaceL4.html#ac674c8e32808f504f4fa0aa8e5276e84">L4::cap_cast<T></a>(<a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#acbcdb89371502dd5bc820cd977176fe9">alloc</a>());</div>
|
|
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno"> 285</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno"> 286</span> </div>
|
|
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno"> 287</span></div>
|
|
<div class="foldopen" id="foldopen00296" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a8d405da49fa938178a8188696d36b42b"> 296</a></span> <span class="keywordtype">void</span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a8d405da49fa938178a8188696d36b42b">take</a>(<a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a> cap) <span class="keyword">noexcept</span></div>
|
|
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno"> 297</span> {</div>
|
|
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno"> 298</span> <span class="keywordtype">long</span> c;</div>
|
|
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno"> 299</span> <span class="keywordflow">if</span> (!range_check_and_get_idx(cap, &c))</div>
|
|
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno"> 300</span> <span class="keywordflow">return</span>;</div>
|
|
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno"> 301</span> </div>
|
|
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno"> 302</span> <span class="keywordflow">if</span> (!<a class="code hl_define" href="group__l4sys__defines.html#ga3df4200910f2664b97397c23693beeb0">L4_UNLIKELY</a>(_items[c].inc()))</div>
|
|
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno"> 303</span> _dbg->printf(<span class="stringliteral">"Warning: Reference counter of cap 0x%lx now saturated!\n"</span>,</div>
|
|
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno"> 304</span> cap.cap() >> <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879ac13ad59620aeba353454514a42950a85">L4_CAP_SHIFT</a>);</div>
|
|
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno"> 305</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno"> 306</span> </div>
|
|
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno"> 307</span></div>
|
|
<div class="foldopen" id="foldopen00321" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a7aef62ca4affa236882604e4c774eb88"> 321</a></span> <span class="keywordtype">bool</span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a7aef62ca4affa236882604e4c774eb88">free</a>(<a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a> cap, <a class="code hl_typedef" href="group__l4__cap__api.html#ga1445e923ce73029130d569d6e69a4dd8">l4_cap_idx_t</a> task = <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879aff9320ed307e76cebfca6c2871136102">L4_INVALID_CAP</a>,</div>
|
|
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno"> 322</span> <span class="keywordtype">unsigned</span> unmap_flags = <a class="code hl_enumvalue" href="group__l4__task__api.html#gga3c24e67b976870a3e911c43c83382f66aa85d4766b182308e5847d543e7d59055">L4_FP_ALL_SPACES</a>) <span class="keyword">noexcept</span></div>
|
|
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno"> 323</span> {</div>
|
|
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno"> 324</span> <span class="keywordtype">long</span> c;</div>
|
|
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno"> 325</span> <span class="keywordflow">if</span> (!range_check_and_get_idx(cap, &c))</div>
|
|
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno"> 326</span> <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
|
|
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno"> 327</span> </div>
|
|
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno"> 328</span> <a class="code hl_define" href="sys_2assert_8h.html#a01be6aeab808dab408e341a7a8bd17a6">l4_assert</a>(!_items[c].is_free());</div>
|
|
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno"> 329</span> </div>
|
|
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno"> 330</span> <span class="keywordflow">if</span> (<a class="code hl_function" href="group__l4__cap__api.html#ga539da15c2a1be4803ed7a3f3a5742194">l4_is_valid_cap</a>(task))</div>
|
|
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno"> 331</span> <a class="code hl_function" href="group__l4__task__api.html#gaa5558855716b35c1790b61249cf2974b">l4_task_unmap</a>(task, cap.fpage(), unmap_flags);</div>
|
|
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno"> 332</span> </div>
|
|
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno"> 333</span> <span class="keywordflow">if</span> (c < _free_hint)</div>
|
|
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno"> 334</span> _free_hint = c;</div>
|
|
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno"> 335</span> </div>
|
|
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno"> 336</span> _items[c].free();</div>
|
|
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno"> 337</span> </div>
|
|
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno"> 338</span> <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
|
|
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno"> 339</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno"> 340</span></div>
|
|
<div class="foldopen" id="foldopen00359" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a09fcc26693f7e41bb69b1a9b3aa4aa6d"> 359</a></span> <span class="keywordtype">bool</span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a09fcc26693f7e41bb69b1a9b3aa4aa6d">release</a>(<a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a> cap, <a class="code hl_typedef" href="group__l4__cap__api.html#ga1445e923ce73029130d569d6e69a4dd8">l4_cap_idx_t</a> task = <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879aff9320ed307e76cebfca6c2871136102">L4_INVALID_CAP</a>,</div>
|
|
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno"> 360</span> <span class="keywordtype">unsigned</span> unmap_flags = <a class="code hl_enumvalue" href="group__l4__task__api.html#gga3c24e67b976870a3e911c43c83382f66aa85d4766b182308e5847d543e7d59055">L4_FP_ALL_SPACES</a>) <span class="keyword">noexcept</span></div>
|
|
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno"> 361</span> {</div>
|
|
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno"> 362</span> <span class="keywordtype">long</span> c;</div>
|
|
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno"> 363</span> <span class="keywordflow">if</span> (!range_check_and_get_idx(cap, &c))</div>
|
|
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno"> 364</span> <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
|
|
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno"> 365</span> </div>
|
|
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno"> 366</span> <a class="code hl_define" href="sys_2assert_8h.html#a01be6aeab808dab408e341a7a8bd17a6">l4_assert</a>(!_items[c].is_free());</div>
|
|
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno"> 367</span> </div>
|
|
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno"> 368</span> <span class="keywordflow">if</span> (_items[c].dec() == Counter::unused())</div>
|
|
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno"> 369</span> {</div>
|
|
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno"> 370</span> <span class="keywordflow">if</span> (task != <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879aff9320ed307e76cebfca6c2871136102">L4_INVALID_CAP</a>)</div>
|
|
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno"> 371</span> <a class="code hl_function" href="group__l4__task__api.html#gaa5558855716b35c1790b61249cf2974b">l4_task_unmap</a>(task, cap.fpage(), unmap_flags);</div>
|
|
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno"> 372</span> </div>
|
|
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno"> 373</span> <span class="keywordflow">if</span> (c < _free_hint)</div>
|
|
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno"> 374</span> _free_hint = c;</div>
|
|
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno"> 375</span> </div>
|
|
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno"> 376</span> <span class="comment">// Let others allocate this slot only after the l4_task_unmap() has</span></div>
|
|
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno"> 377</span> <span class="comment">// finished.</span></div>
|
|
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno"> 378</span> _items[c].free();</div>
|
|
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno"> 379</span> </div>
|
|
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno"> 380</span> <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
|
|
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno"> 381</span> }</div>
|
|
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno"> 382</span> <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
|
|
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno"> 383</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno"> 384</span></div>
|
|
<div class="foldopen" id="foldopen00388" data-start="{" data-end="}">
|
|
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno"><a class="line" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a5ee4809d1ce19f356d8294ae6905f1ea"> 388</a></span> <span class="keywordtype">long</span> <a class="code hl_function" href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a5ee4809d1ce19f356d8294ae6905f1ea">last</a>() noexcept</div>
|
|
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno"> 389</span> {</div>
|
|
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno"> 390</span> <span class="keywordflow">return</span> _capacity + _bias - 1;</div>
|
|
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno"> 391</span> }</div>
|
|
</div>
|
|
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno"> 392</span> </div>
|
|
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno"> 393</span><span class="keyword">private</span>:</div>
|
|
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno"> 394</span> <span class="keywordtype">bool</span> range_check_and_get_idx(<a class="code hl_class" href="classL4_1_1Cap.html">L4::Cap<void></a> cap, <span class="keywordtype">long</span> *c)</div>
|
|
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno"> 395</span> {</div>
|
|
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno"> 396</span> *c = cap.<a class="code hl_function" href="classL4_1_1Cap__base.html#a90ff089ca2442b128c2b2b0e1c22c6d7">cap</a>() >> <a class="code hl_enumvalue" href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879ac13ad59620aeba353454514a42950a85">L4_CAP_SHIFT</a>;</div>
|
|
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno"> 397</span> <span class="keywordflow">if</span> (*c < _bias)</div>
|
|
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno"> 398</span> <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
|
|
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno"> 399</span> </div>
|
|
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno"> 400</span> *c -= _bias;</div>
|
|
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno"> 401</span> </div>
|
|
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno"> 402</span> <span class="keywordflow">return</span> *c < _capacity;</div>
|
|
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno"> 403</span> }</div>
|
|
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno"> 404</span>};</div>
|
|
</div>
|
|
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno"> 405</span> </div>
|
|
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno"> 406</span>}}</div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_a09fcc26693f7e41bb69b1a9b3aa4aa6d"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a09fcc26693f7e41bb69b1a9b3aa4aa6d">L4Re::Util::Counting_cap_alloc::release</a></div><div class="ttdeci">bool release(L4::Cap< void > cap, l4_cap_idx_t task=L4_INVALID_CAP, unsigned unmap_flags=L4_FP_ALL_SPACES) noexcept</div><div class="ttdoc">Decrease the reference counter for a capability.</div><div class="ttdef"><b>Definition</b> <a href="#l00359">counting_cap_alloc:359</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_a0ad59cfc028e0e77e33182f2858cb1f1"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a0ad59cfc028e0e77e33182f2858cb1f1">L4Re::Util::Counting_cap_alloc::setup</a></div><div class="ttdeci">void setup(void *m, long capacity, long bias, Dbg *dbg) noexcept</div><div class="ttdoc">Set up the backing memory for the allocator and the area of managed capability slots.</div><div class="ttdef"><b>Definition</b> <a href="#l00242">counting_cap_alloc:242</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_a5ee4809d1ce19f356d8294ae6905f1ea"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a5ee4809d1ce19f356d8294ae6905f1ea">L4Re::Util::Counting_cap_alloc::last</a></div><div class="ttdeci">long last() noexcept</div><div class="ttdoc">Return highest capability id managed by this allocator.</div><div class="ttdef"><b>Definition</b> <a href="#l00388">counting_cap_alloc:388</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_a7aef62ca4affa236882604e4c774eb88"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a7aef62ca4affa236882604e4c774eb88">L4Re::Util::Counting_cap_alloc::free</a></div><div class="ttdeci">bool free(L4::Cap< void > cap, l4_cap_idx_t task=L4_INVALID_CAP, unsigned unmap_flags=L4_FP_ALL_SPACES) noexcept</div><div class="ttdoc">Free the capability.</div><div class="ttdef"><b>Definition</b> <a href="#l00321">counting_cap_alloc:321</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_a8d405da49fa938178a8188696d36b42b"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#a8d405da49fa938178a8188696d36b42b">L4Re::Util::Counting_cap_alloc::take</a></div><div class="ttdeci">void take(L4::Cap< void > cap) noexcept</div><div class="ttdoc">Increase the reference counter for the capability.</div><div class="ttdef"><b>Definition</b> <a href="#l00296">counting_cap_alloc:296</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_acbcdb89371502dd5bc820cd977176fe9"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#acbcdb89371502dd5bc820cd977176fe9">L4Re::Util::Counting_cap_alloc::alloc</a></div><div class="ttdeci">L4::Cap< void > alloc() noexcept</div><div class="ttdoc">Allocate a new capability slot.</div><div class="ttdef"><b>Definition</b> <a href="#l00257">counting_cap_alloc:257</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_ade1824504edcf74b1c8781128af995ec"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#ade1824504edcf74b1c8781128af995ec">L4Re::Util::Counting_cap_alloc::alloc</a></div><div class="ttdeci">L4::Cap< T > alloc() noexcept</div><div class="ttdoc">Allocate a new capability slot.</div><div class="ttdef"><b>Definition</b> <a href="#l00282">counting_cap_alloc:282</a></div></div>
|
|
<div class="ttc" id="aclassL4Re_1_1Util_1_1Counting__cap__alloc_html_af2fe4673eb75d7badb49a3615673f169"><div class="ttname"><a href="classL4Re_1_1Util_1_1Counting__cap__alloc.html#af2fe4673eb75d7badb49a3615673f169">L4Re::Util::Counting_cap_alloc::Counting_cap_alloc</a></div><div class="ttdeci">Counting_cap_alloc() noexcept</div><div class="ttdoc">Create a new, empty allocator.</div><div class="ttdef"><b>Definition</b> <a href="#l00224">counting_cap_alloc:224</a></div></div>
|
|
<div class="ttc" id="aclassL4_1_1Cap__base_html_a90ff089ca2442b128c2b2b0e1c22c6d7"><div class="ttname"><a href="classL4_1_1Cap__base.html#a90ff089ca2442b128c2b2b0e1c22c6d7">L4::Cap_base::cap</a></div><div class="ttdeci">l4_cap_idx_t cap() const noexcept</div><div class="ttdoc">Return capability selector.</div><div class="ttdef"><b>Definition</b> <a href="capability_8h_source.html#l00049">capability.h:49</a></div></div>
|
|
<div class="ttc" id="aclassL4_1_1Cap__base_html_ac74dbedb04347341ba30ece923c12fe7af425c8e16afcd760ecb1f30bd6c1437a"><div class="ttname"><a href="classL4_1_1Cap__base.html#ac74dbedb04347341ba30ece923c12fe7af425c8e16afcd760ecb1f30bd6c1437a">L4::Cap_base::Invalid</a></div><div class="ttdeci">@ Invalid</div><div class="ttdoc">Invalid capability selector.</div><div class="ttdef"><b>Definition</b> <a href="capability_8h_source.html#l00042">capability.h:42</a></div></div>
|
|
<div class="ttc" id="aclassL4_1_1Cap_html"><div class="ttname"><a href="classL4_1_1Cap.html">L4::Cap</a></div><div class="ttdoc">C++ interface for capabilities.</div><div class="ttdef"><b>Definition</b> <a href="capability_8h_source.html#l00223">capability.h:224</a></div></div>
|
|
<div class="ttc" id="agroup__l4__cap__api_html_ga1445e923ce73029130d569d6e69a4dd8"><div class="ttname"><a href="group__l4__cap__api.html#ga1445e923ce73029130d569d6e69a4dd8">l4_cap_idx_t</a></div><div class="ttdeci">unsigned long l4_cap_idx_t</div><div class="ttdoc">Capability selector type.</div><div class="ttdef"><b>Definition</b> <a href="l4_2sys_2types_8h_source.html#l00336">types.h:336</a></div></div>
|
|
<div class="ttc" id="agroup__l4__cap__api_html_ga539da15c2a1be4803ed7a3f3a5742194"><div class="ttname"><a href="group__l4__cap__api.html#ga539da15c2a1be4803ed7a3f3a5742194">l4_is_valid_cap</a></div><div class="ttdeci">unsigned l4_is_valid_cap(l4_cap_idx_t c) L4_NOTHROW</div><div class="ttdoc">Test if a capability selector is a valid selector.</div><div class="ttdef"><b>Definition</b> <a href="l4_2sys_2types_8h_source.html#l00393">types.h:393</a></div></div>
|
|
<div class="ttc" id="agroup__l4__cap__api_html_ggafee0421c2fe0e5cfc59f17f16ea10879ac13ad59620aeba353454514a42950a85"><div class="ttname"><a href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879ac13ad59620aeba353454514a42950a85">L4_CAP_SHIFT</a></div><div class="ttdeci">@ L4_CAP_SHIFT</div><div class="ttdoc">Capability index shift.</div><div class="ttdef"><b>Definition</b> <a href="l4_2sys_2consts_8h_source.html#l00142">consts.h:142</a></div></div>
|
|
<div class="ttc" id="agroup__l4__cap__api_html_ggafee0421c2fe0e5cfc59f17f16ea10879aff9320ed307e76cebfca6c2871136102"><div class="ttname"><a href="group__l4__cap__api.html#ggafee0421c2fe0e5cfc59f17f16ea10879aff9320ed307e76cebfca6c2871136102">L4_INVALID_CAP</a></div><div class="ttdeci">@ L4_INVALID_CAP</div><div class="ttdoc">Invalid capability selector.</div><div class="ttdef"><b>Definition</b> <a href="l4_2sys_2consts_8h_source.html#l00153">consts.h:153</a></div></div>
|
|
<div class="ttc" id="agroup__l4__task__api_html_gaa5558855716b35c1790b61249cf2974b"><div class="ttname"><a href="group__l4__task__api.html#gaa5558855716b35c1790b61249cf2974b">l4_task_unmap</a></div><div class="ttdeci">l4_msgtag_t l4_task_unmap(l4_cap_idx_t task, l4_fpage_t fpage, l4_umword_t map_mask) L4_NOTHROW</div><div class="ttdoc">Revoke rights from the task.</div><div class="ttdef"><b>Definition</b> <a href="l4_2sys_2task_8h_source.html#l00440">task.h:440</a></div></div>
|
|
<div class="ttc" id="agroup__l4__task__api_html_gga3c24e67b976870a3e911c43c83382f66aa85d4766b182308e5847d543e7d59055"><div class="ttname"><a href="group__l4__task__api.html#gga3c24e67b976870a3e911c43c83382f66aa85d4766b182308e5847d543e7d59055">L4_FP_ALL_SPACES</a></div><div class="ttdeci">@ L4_FP_ALL_SPACES</div><div class="ttdoc">Flag to tell the unmap operation to revoke permissions from all child mappings including the mapping ...</div><div class="ttdef"><b>Definition</b> <a href="l4_2sys_2consts_8h_source.html#l00183">consts.h:183</a></div></div>
|
|
<div class="ttc" id="agroup__l4sys__defines_html_ga3df4200910f2664b97397c23693beeb0"><div class="ttname"><a href="group__l4sys__defines.html#ga3df4200910f2664b97397c23693beeb0">L4_UNLIKELY</a></div><div class="ttdeci">#define L4_UNLIKELY(x)</div><div class="ttdoc">Expression is unlikely to execute.</div><div class="ttdef"><b>Definition</b> <a href="compiler_8h_source.html#l00284">compiler.h:284</a></div></div>
|
|
<div class="ttc" id="anamespaceL4Re_1_1Util_html"><div class="ttname"><a href="namespaceL4Re_1_1Util.html">L4Re::Util</a></div><div class="ttdoc">Documentation of the L4 Runtime Environment utility functionality in C++.</div><div class="ttdef"><b>Definition</b> <a href="pkg_2l4re-core_2l4re_2doc_2l4re_8dox_source.html#l00021">l4re.dox:21</a></div></div>
|
|
<div class="ttc" id="anamespaceL4Re_html"><div class="ttname"><a href="namespaceL4Re.html">L4Re</a></div><div class="ttdoc">L4Re C++ Interfaces.</div><div class="ttdef"><b>Definition</b> <a href="cmd__control_source.html#l00014">cmd_control:14</a></div></div>
|
|
<div class="ttc" id="anamespaceL4_html_ac674c8e32808f504f4fa0aa8e5276e84"><div class="ttname"><a href="namespaceL4.html#ac674c8e32808f504f4fa0aa8e5276e84">L4::cap_cast</a></div><div class="ttdeci">Cap< T > cap_cast(Cap< F > const &c) noexcept</div><div class="ttdoc">static_cast for capabilities.</div><div class="ttdef"><b>Definition</b> <a href="capability_8h_source.html#l00416">capability.h:416</a></div></div>
|
|
<div class="ttc" id="are_2consts_html"><div class="ttname"><a href="re_2consts.html">consts</a></div><div class="ttdoc">Constants.</div></div>
|
|
<div class="ttc" id="astructL4Re_1_1Util_1_1Counter__atomic_html"><div class="ttname"><a href="structL4Re_1_1Util_1_1Counter__atomic.html">L4Re::Util::Counter_atomic</a></div><div class="ttdoc">Thread safe version of counter for Counting_cap_alloc.</div><div class="ttdef"><b>Definition</b> <a href="#l00098">counting_cap_alloc:99</a></div></div>
|
|
<div class="ttc" id="astructL4Re_1_1Util_1_1Counter__atomic_html_a6159fa39e4497e2ded0f22b392105d16"><div class="ttname"><a href="structL4Re_1_1Util_1_1Counter__atomic.html#a6159fa39e4497e2ded0f22b392105d16">L4Re::Util::Counter_atomic::dec</a></div><div class="ttdeci">Type dec()</div><div class="ttdoc">Decrement counter if not saturated.</div><div class="ttdef"><b>Definition</b> <a href="#l00142">counting_cap_alloc:142</a></div></div>
|
|
<div class="ttc" id="astructL4Re_1_1Util_1_1Counter__atomic_html_abd26ba4101dec265a47fbfce99f02546"><div class="ttname"><a href="structL4Re_1_1Util_1_1Counter__atomic.html#abd26ba4101dec265a47fbfce99f02546">L4Re::Util::Counter_atomic::inc</a></div><div class="ttdeci">bool inc()</div><div class="ttdoc">Increment counter if not yet saturated.</div><div class="ttdef"><b>Definition</b> <a href="#l00121">counting_cap_alloc:121</a></div></div>
|
|
<div class="ttc" id="astructL4Re_1_1Util_1_1Counter_html"><div class="ttname"><a href="structL4Re_1_1Util_1_1Counter.html">L4Re::Util::Counter</a></div><div class="ttdoc">Counter for Counting_cap_alloc with variable data width.</div><div class="ttdef"><b>Definition</b> <a href="#l00027">counting_cap_alloc:28</a></div></div>
|
|
<div class="ttc" id="astructL4Re_1_1Util_1_1Counter_html_a2079acbfe2b03fb95d4e5f5912880958"><div class="ttname"><a href="structL4Re_1_1Util_1_1Counter.html#a2079acbfe2b03fb95d4e5f5912880958">L4Re::Util::Counter::dec</a></div><div class="ttdeci">Type dec()</div><div class="ttdoc">Decrement counter if not saturated.</div><div class="ttdef"><b>Definition</b> <a href="#l00067">counting_cap_alloc:67</a></div></div>
|
|
<div class="ttc" id="astructL4Re_1_1Util_1_1Counter_html_a8c4c3b5cb74c1943fede7a7919559d80"><div class="ttname"><a href="structL4Re_1_1Util_1_1Counter.html#a8c4c3b5cb74c1943fede7a7919559d80">L4Re::Util::Counter::inc</a></div><div class="ttdeci">bool inc()</div><div class="ttdoc">Increment counter if not yet saturated.</div><div class="ttdef"><b>Definition</b> <a href="#l00050">counting_cap_alloc:50</a></div></div>
|
|
<div class="ttc" id="asys_2assert_8h_html"><div class="ttname"><a href="sys_2assert_8h.html">assert.h</a></div><div class="ttdoc">Low-level assert implementation.</div></div>
|
|
<div class="ttc" id="asys_2assert_8h_html_a01be6aeab808dab408e341a7a8bd17a6"><div class="ttname"><a href="sys_2assert_8h.html#a01be6aeab808dab408e341a7a8bd17a6">l4_assert</a></div><div class="ttdeci">#define l4_assert(expr)</div><div class="ttdoc">Low-level assert.</div><div class="ttdef"><b>Definition</b> <a href="sys_2assert_8h_source.html#l00032">assert.h:32</a></div></div>
|
|
<div class="ttc" id="atask_html"><div class="ttname"><a href="task.html">task</a></div><div class="ttdoc">Common task related definitions.</div></div>
|
|
</div><!-- fragment --></div><!-- contents -->
|
|
</div><!-- doc-content -->
|
|
</div><!-- container -->
|
|
<!-- HTML footer for doxygen 1.9.1-->
|
|
<!-- start footer part -->
|
|
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
|
|
<ul>
|
|
<li class="navelem"><b>l4</b></li><li class="navelem"><b>re</b></li><li class="navelem"><b>util</b></li><li class="navelem"><a href="counting__cap__alloc.html">counting_cap_alloc</a></li>
|
|
<li class="footer">Generated on <span class="timestamp"></span> for L4Re Operating System Framework by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.15.0 </li>
|
|
</ul>
|
|
</div>
|
|
</body>
|
|
</html>
|