385 lines
33 KiB
HTML
385 lines
33 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::Server< LOOP_HOOKS > Class Template Reference</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('classL4_1_1Server.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">L4::Server< LOOP_HOOKS > Class Template Reference<div class="ingroups"><a class="el" href="group__client__server__ipc.html">The L4Re IPC Framework</a> » <a class="el" href="group__cxx__ipc__server.html">Server-Side IPC framework</a></div></div></div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
|
|
<p>Basic server loop for handling client requests.
|
|
<a href="#details">More...</a></p>
|
|
|
|
<p><code>#include <<a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a>></code></p>
|
|
<div id="dynsection-0" onclick="return dynsection.toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;"><span class="dynarrow"><span class="arrowhead closed"></span></span>Inheritance diagram for L4::Server< LOOP_HOOKS >:</div>
|
|
<div id="dynsection-0-summary" class="dynsummary" style="display:block;">
|
|
</div>
|
|
<div id="dynsection-0-content" class="dyncontent" style="display:none;">
|
|
<div class="center"><iframe scrolling="no" loading="lazy" frameborder="0" src="classL4_1_1Server__inherit__graph.svg" width="727" height="1364"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div>
|
|
</div>
|
|
<div id="dynsection-1" onclick="return dynsection.toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;"><span class="dynarrow"><span class="arrowhead closed"></span></span>Collaboration diagram for L4::Server< LOOP_HOOKS >:</div>
|
|
<div id="dynsection-1-summary" class="dynsummary" style="display:block;">
|
|
</div>
|
|
<div id="dynsection-1-content" class="dyncontent" style="display:none;">
|
|
<div class="center"><iframe scrolling="no" loading="lazy" frameborder="0" src="classL4_1_1Server__coll__graph.svg" width="691" height="840"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div>
|
|
</div>
|
|
<table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 id="header-pub-methods" class="groupheader"><a id="pub-methods" name="pub-methods"></a>
|
|
Public Member Functions</h2></td></tr>
|
|
<tr class="memitem:aefd92e70b235771898428fc98675b96e" id="r_aefd92e70b235771898428fc98675b96e"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#aefd92e70b235771898428fc98675b96e">Server</a> (<a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *)</td></tr>
|
|
<tr class="memdesc:aefd92e70b235771898428fc98675b96e"><td class="mdescLeft"> </td><td class="mdescRight">Initializes the server loop. <br /></td></tr>
|
|
<tr class="memitem:a4d2db3d761228ed6ed282f20f6d4da9d" id="r_a4d2db3d761228ed6ed282f20f6d4da9d"><td class="memItemLeft" align="right" valign="top"><a id="a4d2db3d761228ed6ed282f20f6d4da9d" name="a4d2db3d761228ed6ed282f20f6d4da9d"></a>
|
|
 </td><td class="memItemRight" valign="bottom"><b>Server</b> ()</td></tr>
|
|
<tr class="memdesc:a4d2db3d761228ed6ed282f20f6d4da9d"><td class="mdescLeft"> </td><td class="mdescRight">Initializes the server loop. <br /></td></tr>
|
|
<tr class="memitem:a59c8957072a390acf8d8557021c67059" id="r_a59c8957072a390acf8d8557021c67059"><td class="memTemplParams" colspan="2">template<typename DISPATCH> </td></tr>
|
|
<tr class="memitem:a59c8957072a390acf8d8557021c67059 template"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a59c8957072a390acf8d8557021c67059">internal_loop</a> (DISPATCH dispatch, <a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *)</td></tr>
|
|
<tr class="memdesc:a59c8957072a390acf8d8557021c67059"><td class="mdescLeft"> </td><td class="mdescRight">The server loop. <br /></td></tr>
|
|
<tr class="memitem:ae30bfa9ee9facb019e348bdac2779eea" id="r_ae30bfa9ee9facb019e348bdac2779eea"><td class="memTemplParams" colspan="2"><a id="ae30bfa9ee9facb019e348bdac2779eea" name="ae30bfa9ee9facb019e348bdac2779eea"></a>
|
|
template<typename R> </td></tr>
|
|
<tr class="memitem:ae30bfa9ee9facb019e348bdac2779eea template"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void </td><td class="memItemRight" valign="bottom"><b>loop_noexc</b> (R r, <a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *u=<a class="el" href="group__l4__utcb__api.html#gadc099b4a59e1d99638c72c11a8c8b644">l4_utcb</a>())</td></tr>
|
|
<tr class="memdesc:ae30bfa9ee9facb019e348bdac2779eea"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classL4_1_1Server.html" title="Basic server loop for handling client requests.">Server</a> loop without exception handling. <br /></td></tr>
|
|
<tr class="memitem:a81de12837c9c5bb6e0a11f2338341934" id="r_a81de12837c9c5bb6e0a11f2338341934"><td class="memTemplParams" colspan="2">template<typename EXC, typename R> </td></tr>
|
|
<tr class="memitem:a81de12837c9c5bb6e0a11f2338341934 template"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a81de12837c9c5bb6e0a11f2338341934">loop</a> (R r, <a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *u=<a class="el" href="group__l4__utcb__api.html#gadc099b4a59e1d99638c72c11a8c8b644">l4_utcb</a>())</td></tr>
|
|
<tr class="memdesc:a81de12837c9c5bb6e0a11f2338341934"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classL4_1_1Server.html" title="Basic server loop for handling client requests.">Server</a> loop with internal exception handling. <br /></td></tr>
|
|
<tr class="memitem:a0743ae07d8b2de841d3059f8fa7ed368" id="r_a0743ae07d8b2de841d3059f8fa7ed368"><td class="memTemplParams" colspan="2">template<typename EXC, typename R, typename Printer> </td></tr>
|
|
<tr class="memitem:a0743ae07d8b2de841d3059f8fa7ed368 template"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void </td><td class="memItemRight" valign="bottom"><a class="el" href="#a0743ae07d8b2de841d3059f8fa7ed368">loop_dbg</a> (R r, Printer p, <a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *u=<a class="el" href="group__l4__utcb__api.html#gadc099b4a59e1d99638c72c11a8c8b644">l4_utcb</a>())</td></tr>
|
|
<tr class="memdesc:a0743ae07d8b2de841d3059f8fa7ed368"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classL4_1_1Server.html" title="Basic server loop for handling client requests.">Server</a> loop with internal exception handling including message printing. <br /></td></tr>
|
|
<tr class="inherit_header pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td colspan="2" onclick="javascript:dynsection.toggleInherit('pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers')"><span class="dynarrow"><span class="arrowhead closed"></span></span>Public Member Functions inherited from <a class="el" href="classL4_1_1Ipc__svr_1_1Br__manager__no__buffers.html">L4::Ipc_svr::Br_manager_no_buffers</a></td></tr>
|
|
<tr class="memitem:a48d7b04f600248f991ec2967bfc85138 inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_a48d7b04f600248f991ec2967bfc85138"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classL4_1_1Ipc__svr_1_1Br__manager__no__buffers.html#a48d7b04f600248f991ec2967bfc85138">alloc_buffer_demand</a> (<a class="el" href="classL4_1_1Ipc__svr_1_1Server__iface.html#a06e47dba2ba71662337758f0cbf37053">Demand</a> const &demand) override</td></tr>
|
|
<tr class="memdesc:a48d7b04f600248f991ec2967bfc85138 inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Tells the server to allocate buffers for the given demand. <br /></td></tr>
|
|
<tr class="memitem:a06b75be0f30872bcb6d2e5d43e9e53c4 inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_a06b75be0f30872bcb6d2e5d43e9e53c4"><td class="memItemLeft" align="right" valign="top">
|
|
<a class="el" href="classL4_1_1Cap.html">L4::Cap</a>< void > </td><td class="memItemRight" valign="bottom"><b>get_rcv_cap</b> (int) const override</td></tr>
|
|
<tr class="memdesc:a06b75be0f30872bcb6d2e5d43e9e53c4 inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Returns <a class="el" href="classL4_1_1Cap__base.html#ac74dbedb04347341ba30ece923c12fe7af425c8e16afcd760ecb1f30bd6c1437a" title="Invalid capability selector.">L4::Cap<void>::Invalid</a>, we have no buffer management. <br /></td></tr>
|
|
<tr class="memitem:a8253d0dd0fb677174c6747383713f37f inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_a8253d0dd0fb677174c6747383713f37f"><td class="memItemLeft" align="right" valign="top">
|
|
int </td><td class="memItemRight" valign="bottom"><b>realloc_rcv_cap</b> (int) override</td></tr>
|
|
<tr class="memdesc:a8253d0dd0fb677174c6747383713f37f inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Returns -L4_ENOMEM, we have no buffer management. <br /></td></tr>
|
|
<tr class="memitem:a92ee65f7a387ad6c3b335904c6f4d7cb inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_a92ee65f7a387ad6c3b335904c6f4d7cb"><td class="memItemLeft" align="right" valign="top">
|
|
int </td><td class="memItemRight" valign="bottom"><b>add_timeout</b> (<a class="el" href="classL4_1_1Ipc__svr_1_1Timeout.html">Timeout</a> *, <a class="el" href="group__l4__basic__types.html#gab71da24eb7cda2c035f18b862309b101">l4_kernel_clock_t</a>) override</td></tr>
|
|
<tr class="memdesc:a92ee65f7a387ad6c3b335904c6f4d7cb inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Returns -L4_ENOSYS, we have no timeout queue. <br /></td></tr>
|
|
<tr class="memitem:a212e3c2e826b36125d0311ff575de5fc inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_a212e3c2e826b36125d0311ff575de5fc"><td class="memItemLeft" align="right" valign="top">
|
|
int </td><td class="memItemRight" valign="bottom"><b>remove_timeout</b> (<a class="el" href="classL4_1_1Ipc__svr_1_1Timeout.html">Timeout</a> *) override</td></tr>
|
|
<tr class="memdesc:a212e3c2e826b36125d0311ff575de5fc inherit pub_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Returns -L4_ENOSYS, we have no timeout queue. <br /></td></tr>
|
|
<tr class="inherit_header pub_methods_classL4_1_1Ipc__svr_1_1Server__iface"><td colspan="2" onclick="javascript:dynsection.toggleInherit('pub_methods_classL4_1_1Ipc__svr_1_1Server__iface')"><span class="dynarrow"><span class="arrowhead closed"></span></span>Public Member Functions inherited from <a class="el" href="classL4_1_1Ipc__svr_1_1Server__iface.html">L4::Ipc_svr::Server_iface</a></td></tr>
|
|
<tr class="memitem:aa17aa10ace494b229a3e0879599e23b9 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface" id="r_aa17aa10ace494b229a3e0879599e23b9"><td class="memItemLeft" align="right" valign="top">
|
|
 </td><td class="memItemRight" valign="bottom"><b>Server_iface</b> ()</td></tr>
|
|
<tr class="memdesc:aa17aa10ace494b229a3e0879599e23b9 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface"><td class="mdescLeft"> </td><td class="mdescRight">Make a server interface. <br /></td></tr>
|
|
<tr class="memitem:ade41083183a509c9cefe6663a2af7b97 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface" id="r_ade41083183a509c9cefe6663a2af7b97"><td class="memTemplParams" colspan="2">template<typename T> </td></tr>
|
|
<tr class="memitem:ade41083183a509c9cefe6663a2af7b97 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface template"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classL4_1_1Cap.html">L4::Cap</a>< T > </td><td class="memItemRight" valign="bottom"><a class="el" href="classL4_1_1Ipc__svr_1_1Server__iface.html#ade41083183a509c9cefe6663a2af7b97">rcv_cap</a> (int index) const</td></tr>
|
|
<tr class="memdesc:ade41083183a509c9cefe6663a2af7b97 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface"><td class="mdescLeft"> </td><td class="mdescRight">Get given receive buffer as typed capability. <br /></td></tr>
|
|
<tr class="memitem:adbf5b2414f63b348de3a4005c4164e47 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface" id="r_adbf5b2414f63b348de3a4005c4164e47"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classL4_1_1Cap.html">L4::Cap</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classL4_1_1Ipc__svr_1_1Server__iface.html#adbf5b2414f63b348de3a4005c4164e47">rcv_cap</a> (int index) const</td></tr>
|
|
<tr class="memdesc:adbf5b2414f63b348de3a4005c4164e47 inherit pub_methods_classL4_1_1Ipc__svr_1_1Server__iface"><td class="mdescLeft"> </td><td class="mdescRight">Get receive cap with the given index as generic (void) type. <br /></td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 id="header-pro-methods" class="groupheader"><a id="pro-methods" name="pro-methods"></a>
|
|
Protected Member Functions</h2></td></tr>
|
|
<tr class="memitem:a21578e92d497db8ab2a2a88b356fa427" id="r_a21578e92d497db8ab2a2a88b356fa427"><td class="memItemLeft" align="right" valign="top"><a id="a21578e92d497db8ab2a2a88b356fa427" name="a21578e92d497db8ab2a2a88b356fa427"></a>
|
|
<a class="el" href="structl4__msgtag__t.html">l4_msgtag_t</a> </td><td class="memItemRight" valign="bottom"><b>reply_n_wait</b> (<a class="el" href="structl4__msgtag__t.html">l4_msgtag_t</a> reply, <a class="el" href="group__l4__basic__types.html#ga1c2c4b333f75b1d05b59855910f2b9cb">l4_umword_t</a> *p, <a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *)</td></tr>
|
|
<tr class="memdesc:a21578e92d497db8ab2a2a88b356fa427"><td class="mdescLeft"> </td><td class="mdescRight">Internal implementation for reply and wait. <br /></td></tr>
|
|
<tr class="inherit_header pro_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td colspan="2" onclick="javascript:dynsection.toggleInherit('pro_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers')"><span class="dynarrow"><span class="arrowhead closed"></span></span>Protected Member Functions inherited from <a class="el" href="classL4_1_1Ipc__svr_1_1Br__manager__no__buffers.html">L4::Ipc_svr::Br_manager_no_buffers</a></td></tr>
|
|
<tr class="memitem:a6a21ac56918c605ca9796c99edfd8ec0 inherit pro_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_a6a21ac56918c605ca9796c99edfd8ec0"><td class="memItemLeft" align="right" valign="top">
|
|
unsigned </td><td class="memItemRight" valign="bottom"><b>first_free_br</b> () const</td></tr>
|
|
<tr class="memdesc:a6a21ac56918c605ca9796c99edfd8ec0 inherit pro_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Returns 1 as first free buffer. <br /></td></tr>
|
|
<tr class="memitem:ae41eef8a74be7b2d9ce4472bf0204204 inherit pro_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers" id="r_ae41eef8a74be7b2d9ce4472bf0204204"><td class="memItemLeft" align="right" valign="top">
|
|
void </td><td class="memItemRight" valign="bottom"><b>setup_wait</b> (<a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *utcb, <a class="el" href="group__cxx__ipc__server.html#ga53acccae8e5dc9803ebb8583e1e9de30">L4::Ipc_svr::Reply_mode</a>)</td></tr>
|
|
<tr class="memdesc:ae41eef8a74be7b2d9ce4472bf0204204 inherit pro_methods_classL4_1_1Ipc__svr_1_1Br__manager__no__buffers"><td class="mdescLeft"> </td><td class="mdescRight">Setup wait function for the server loop (<a class="el" href="classL4_1_1Server.html" title="Basic server loop for handling client requests.">Server<></a>). <br /></td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 id="header-inherited" class="groupheader"><a id="inherited" name="inherited"></a>
|
|
Additional Inherited Members</h2></td></tr>
|
|
<tr class="inherit_header pub_types_classL4_1_1Ipc__svr_1_1Server__iface"><td colspan="2" onclick="javascript:dynsection.toggleInherit('pub_types_classL4_1_1Ipc__svr_1_1Server__iface')"><span class="dynarrow"><span class="arrowhead closed"></span></span>Public Types inherited from <a class="el" href="classL4_1_1Ipc__svr_1_1Server__iface.html">L4::Ipc_svr::Server_iface</a></td></tr>
|
|
<tr class="memitem:a06e47dba2ba71662337758f0cbf37053 inherit pub_types_classL4_1_1Ipc__svr_1_1Server__iface" id="r_a06e47dba2ba71662337758f0cbf37053"><td class="memItemLeft" align="right" valign="top">
|
|
typedef <a class="el" href="classL4_1_1Type__info_1_1Demand.html">L4::Type_info::Demand</a> </td><td class="memItemRight" valign="bottom"><b>Demand</b></td></tr>
|
|
<tr class="memdesc:a06e47dba2ba71662337758f0cbf37053 inherit pub_types_classL4_1_1Ipc__svr_1_1Server__iface"><td class="mdescLeft"> </td><td class="mdescRight">Data type expressing server-side demand for receive buffers. <br /></td></tr>
|
|
</table>
|
|
<a name="details" id="details"></a><h2 id="header-details" class="groupheader">Detailed Description</h2>
|
|
<div class="textblock"><div class="compoundTemplParams">template<typename LOOP_HOOKS = Ipc_svr::Default_loop_hooks><br />
|
|
class L4::Server< LOOP_HOOKS ></div><p>Basic server loop for handling client requests. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">LOOP_HOOKS</td><td>the server inherits from LOOP_HOOKS and calls the hooks defined in LOOP_HOOKS in the server loop. See <a class="el" href="structL4_1_1Ipc__svr_1_1Default__loop__hooks.html" title="Default LOOP_HOOKS.">Ipc_svr::Default_loop_hooks</a>, <a class="el" href="structL4_1_1Ipc__svr_1_1Ignore__errors.html" title="Mix in for LOOP_HOOKS to ignore IPC errors.">Ipc_svr::Ignore_errors</a>, <a class="el" href="structL4_1_1Ipc__svr_1_1Default__timeout.html" title="Mix in for LOOP_HOOKS to use a 0 send and a infinite receive timeout.">Ipc_svr::Default_timeout</a>, <a class="el" href="structL4_1_1Ipc__svr_1_1Compound__reply.html" title="Mix in for LOOP_HOOKS to always use compound reply and wait.">Ipc_svr::Compound_reply</a>, and <a class="el" href="classL4_1_1Ipc__svr_1_1Br__manager__no__buffers.html" title="Empty implementation of Server_iface.">Ipc_svr::Br_manager_no_buffers</a>.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<p>This is basically a simple server loop that uses a single message buffer for receiving requests and sending replies. The dispatcher determines how incoming messages are handled. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="ipc__server__loop_source.html#l00307">307</a> of file <a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a>.</p>
|
|
</div><a name="doc-constructors" id="doc-constructors"></a><h2 id="header-doc-constructors" class="groupheader">Constructor & Destructor Documentation</h2>
|
|
<a id="aefd92e70b235771898428fc98675b96e" name="aefd92e70b235771898428fc98675b96e"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#aefd92e70b235771898428fc98675b96e">◆ </a></span>Server()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<div class="memtemplate">
|
|
template<typename LOOP_HOOKS = Ipc_svr::Default_loop_hooks> </div>
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="classL4_1_1Server.html">L4::Server</a>< LOOP_HOOKS >::Server </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *</td> <td class="paramname"><span class="paramname"><em></em></span></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel inline">inline</span><span class="mlabel explicit">explicit</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Initializes the server loop. </p>
|
|
<p>Note that this variant is deprecated. The UTCB can be specified with the server loop function (<a class="el" href="group__l4__utcb__api.html#gadc099b4a59e1d99638c72c11a8c8b644" title="Get the UTCB address.">l4_utcb()</a> is the default). (2021-10) </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="ipc__server__loop_source.html#l00319">319</a> of file <a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a name="doc-func-members" id="doc-func-members"></a><h2 id="header-doc-func-members" class="groupheader">Member Function Documentation</h2>
|
|
<a id="a59c8957072a390acf8d8557021c67059" name="a59c8957072a390acf8d8557021c67059"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a59c8957072a390acf8d8557021c67059">◆ </a></span>internal_loop()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<div class="memtemplate">
|
|
template<typename L> </div>
|
|
<div class="memtemplate">
|
|
template<typename DISPATCH> </div>
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void <a class="el" href="classL4_1_1Server.html">L4::Server</a>< L >::internal_loop </td>
|
|
<td>(</td>
|
|
<td class="paramtype">DISPATCH</td> <td class="paramname"><span class="paramname"><em>dispatch</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *</td> <td class="paramname"><span class="paramname"><em>utcb</em></span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel inline">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>The server loop. </p>
|
|
<p>This function usually never returns, it waits for incoming messages calls the dispatcher, sends a reply and waits again. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="ipc__server__loop_source.html#l00405">405</a> of file <a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a>.</p>
|
|
|
|
<p class="reference">References <a class="el" href="l4_2sys_2types_8h_source.html#l00191">l4_msgtag_t::has_error()</a>, <a class="el" href="err_8h_source.html#l00055">L4_ENOREPLY</a>, <a class="el" href="l4_2sys_2types_8h_source.html#l00405">l4_msgtag()</a>, and <a class="el" href="ipc__server__loop_source.html#l00381">reply_n_wait()</a>.</p>
|
|
|
|
<p class="reference">Referenced by <a class="el" href="ipc__server__loop_source.html#l00355">loop()</a>, <a class="el" href="ipc__server__loop_source.html#l00368">loop_dbg()</a>, and <a class="el" href="ipc__server__loop_source.html#l00344">loop_noexc()</a>.</p>
|
|
<div id="dynsection-2" onclick="return dynsection.toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;"><span class="dynarrow"><span class="arrowhead closed"></span></span>Here is the call graph for this function:</div>
|
|
<div id="dynsection-2-summary" class="dynsummary" style="display:block;">
|
|
</div>
|
|
<div id="dynsection-2-content" class="dyncontent" style="display:none;">
|
|
<div class="center"><iframe scrolling="no" loading="lazy" frameborder="0" src="classL4_1_1Server_a59c8957072a390acf8d8557021c67059_cgraph.svg" width="752" height="299"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div>
|
|
</div>
|
|
<div id="dynsection-3" onclick="return dynsection.toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;"><span class="dynarrow"><span class="arrowhead closed"></span></span>Here is the caller graph for this function:</div>
|
|
<div id="dynsection-3-summary" class="dynsummary" style="display:block;">
|
|
</div>
|
|
<div id="dynsection-3-content" class="dyncontent" style="display:none;">
|
|
<div class="center"><iframe scrolling="no" loading="lazy" frameborder="0" src="classL4_1_1Server_a59c8957072a390acf8d8557021c67059_icgraph.svg" width="430" height="179"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div>
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a81de12837c9c5bb6e0a11f2338341934" name="a81de12837c9c5bb6e0a11f2338341934"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a81de12837c9c5bb6e0a11f2338341934">◆ </a></span>loop()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<div class="memtemplate">
|
|
template<typename LOOP_HOOKS = Ipc_svr::Default_loop_hooks> </div>
|
|
<div class="memtemplate">
|
|
template<typename EXC, typename R> </div>
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void <a class="el" href="classL4_1_1Server.html">L4::Server</a>< LOOP_HOOKS >::loop </td>
|
|
<td>(</td>
|
|
<td class="paramtype">R</td> <td class="paramname"><span class="paramname"><em>r</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *</td> <td class="paramname"><span class="paramname"><em>u</em></span><span class="paramdefsep"> = </span><span class="paramdefval"><a class="el" href="group__l4__utcb__api.html#gadc099b4a59e1d99638c72c11a8c8b644">l4_utcb</a>()</span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel inline">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p><a class="el" href="classL4_1_1Server.html" title="Basic server loop for handling client requests.">Server</a> loop with internal exception handling. </p>
|
|
<p>This server loop translates <a class="el" href="classL4_1_1Runtime__error.html" title="Exception for an abstract runtime error.">L4::Runtime_error</a> exceptions into negative error return codes sent to the caller. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="ipc__server__loop_source.html#l00355">355</a> of file <a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a0743ae07d8b2de841d3059f8fa7ed368" name="a0743ae07d8b2de841d3059f8fa7ed368"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a0743ae07d8b2de841d3059f8fa7ed368">◆ </a></span>loop_dbg()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<div class="memtemplate">
|
|
template<typename LOOP_HOOKS = Ipc_svr::Default_loop_hooks> </div>
|
|
<div class="memtemplate">
|
|
template<typename EXC, typename R, typename Printer> </div>
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="group__l4sys__defines.html#gab2364b91355f435e015c5b85b7d93a73">L4_NORETURN</a> void <a class="el" href="classL4_1_1Server.html">L4::Server</a>< LOOP_HOOKS >::loop_dbg </td>
|
|
<td>(</td>
|
|
<td class="paramtype">R</td> <td class="paramname"><span class="paramname"><em>r</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">Printer</td> <td class="paramname"><span class="paramname"><em>p</em></span>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype"><a class="el" href="group__l4__utcb__api.html#ga89be8a86d11c1d532b636cc2df1330fb">l4_utcb_t</a> *</td> <td class="paramname"><span class="paramname"><em>u</em></span><span class="paramdefsep"> = </span><span class="paramdefval"><a class="el" href="group__l4__utcb__api.html#gadc099b4a59e1d99638c72c11a8c8b644">l4_utcb</a>()</span> )</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel inline">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p><a class="el" href="classL4_1_1Server.html" title="Basic server loop for handling client requests.">Server</a> loop with internal exception handling including message printing. </p>
|
|
<p>Exceptions are translated into error codes, just like in <a class="el" href="#a81de12837c9c5bb6e0a11f2338341934" title="Server loop with internal exception handling.">loop()</a>. In addition, error messages are printed using the Printer argument. </p>
|
|
|
|
<p class="definition">Definition at line <a class="el" href="ipc__server__loop_source.html#l00368">368</a> of file <a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<hr/>The documentation for this class was generated from the following file:<ul>
|
|
<li>l4/sys/cxx/<a class="el" href="ipc__server__loop_source.html">ipc_server_loop</a></li>
|
|
</ul>
|
|
</div><!-- contents -->
|
|
</div><!-- doc-content -->
|
|
<div id="page-nav" class="page-nav-panel">
|
|
<div id="page-nav-resize-handle"></div>
|
|
<div id="page-nav-tree">
|
|
<div id="page-nav-contents">
|
|
</div><!-- page-nav-contents -->
|
|
</div><!-- page-nav-tree -->
|
|
</div><!-- page-nav -->
|
|
</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"><a href="namespaceL4.html">L4</a></li><li class="navelem"><a href="classL4_1_1Server.html">Server</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>
|