You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by gi...@apache.org on 2018/05/31 03:12:22 UTC
[02/46] mesos-site git commit: Updated the website built from mesos
SHA: a52e528.
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/e42c5d57/content/api/latest/c++/switchboard_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/switchboard_8hpp_source.html b/content/api/latest/c++/switchboard_8hpp_source.html
index 5c6352d..c5769c0 100644
--- a/content/api/latest/c++/switchboard_8hpp_source.html
+++ b/content/api/latest/c++/switchboard_8hpp_source.html
@@ -52,7 +52,7 @@
<div class="title">switchboard.hpp</div> </div>
</div><!--header-->
<div class="contents">
-<a href="switchboard_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment">// or more contributor license agreements. See the NOTICE file</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">// regarding copyright ownership. The ASF licenses this file</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">// to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00006"></a><span
class="lineno"> 6</span> <span class="comment">// "License"); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">// with the License. You may obtain a copy of the License at</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">// distr
ibuted under the License is distributed on an "AS IS" BASIS,</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#ifndef __MESOS_CONTAINERIZER_IO_SWITCHBOARD_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __MESOS_CONTAINERIZER_IO_SWITCHB
OARD_HPP__</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <string></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <<a class="code" href="future_8hpp.html">process/future.hpp</a>></span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2libprocess_2include_2process_2http_8hpp.html">process/http.hpp</a>></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="owned_8hpp.html">process/owned.hpp</a>></span></div><div class="line"><a name="l00025"></a><
span class="lineno"> 25</span> <span class="preprocessor">#include <<a class="code" href="libprocess_2include_2process_2socket_8hpp.html">process/socket.hpp</a>></span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="include_2mesos_2slave_2containerizer_8hpp.html">mesos/slave/containerizer.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="slave_2container__logger_8hpp.html">mesos/slave/container_logger.hpp</a>>
;</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include "<a class="code" href="src_2slave_2flags_8hpp.html">slave/flags.hpp</a>"</span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include "<a class="code" href="src_2slave_2containerizer_2mesos_2isolator_8hpp.html">slave/containerizer/mesos/isolator.hpp</a>"</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> </div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="keyword">namespace </span><a class="code" href="namespacemesos.html">mesos</a> {</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span clas
s="keyword">namespace </span><a class="code" href="namespaceinternal.html">internal</a> {</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="keyword">namespace </span>slave {</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> </div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">// The `IOSwitchboard` is a component in the agent whose job it is to</span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// instantiate an `IOSwitchboardServer` that can be used to feed the</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">// stdin to a container from an external source, as well as redirect</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// the stdin/stdout of a container to multip
le targets.</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">//</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// The primary motivation of this component is to enable support in</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// mesos similar to `docker attach` and `docker exec` whereby an</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// external client can attach to the stdin/stdout/stderr of a running</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// container as well as launch arbitrary subcommands inside a</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// container and attach to its stdin/stdout/s
tderr.</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">//</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// The I/O switchboard is integrated with `MesosContainerizer` through</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// the `Isolator` interface.</span></div><div class="line"><a name="l00053"></a><span class="lineno"><a class="line" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html"> 53</a></span> <span class="keyword">class </span><a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html">IOSwitchboard</a> : <span class="keyword">public</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1MesosIsolatorProcess.html">MesosIsolatorProcess</a></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> {</div><div class="l
ine"><a name="l00055"></a><span class="lineno"> 55</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<IOSwitchboard*></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a99a26ff439ca948c0bf5f822d55f1628">create</a>(</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <span class="keyword">const</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1Flags.html">Flags</a>& <a class="code" href="namespaceflags.html">flags</a>,</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="keywordtype">bool</span> local);</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> </div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywo
rd">virtual</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a60f9214954b1664959cfd6a32b5bc959">~IOSwitchboard</a>();</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> </div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a50fc15a892743e6dc4e56585bcf6d08a">supportsNesting</a>();</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a1a3bc4ad72074b5d3e21b21442217375">supportsStandalone</a>();</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> </div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <
span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a502c8a09876e5a6f5ca0654297999a18">recover</a>(</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="keyword">const</span> std::list<mesos::slave::ContainerState>& states,</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="keyword">const</span> <a class="code" href="classhashset.html">hashset<ContainerID></a>& orphans);</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> </div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerLaunchInfo></a>> <a class="code" href="classme
sos_1_1internal_1_1slave_1_1IOSwitchboard.html#ad58eafeb96f1c2b760e6f2652c1fbabc">prepare</a>(</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <span class="keyword">const</span> ContainerID& containerId,</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="keyword">const</span> mesos::slave::ContainerConfig& containerConfig);</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> </div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<mesos::slave::ContainerLimitation></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#aa383182ee41d05570c9e52278c073a6c">watch</a>(</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <span class="keyword">const</span> Container
ID& containerId);</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#aa4c0bb4d89a195ceaaba6a8aae97eabb">cleanup</a>(</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keyword">const</span> ContainerID& containerId);</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> </div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="comment">// Connect to the `IOSwitchboard` associated with `containerId`.</span></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="code" href="classprocess_1_1Future.html">proce
ss::Future<process::http::Connection></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#acd44076631fa55207e19b315a13cbdd3">connect</a>(</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="keyword">const</span> ContainerID& containerId) <span class="keyword">const</span>;</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <span class="comment">// Transfer ownership of a `ContainerIO` struct for a given</span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="comment">// container out of the `IOSwitchboard` and into the caller.</span></div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerIO></a>>
<a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a12117c45cfd218537f0c5f562542c4f1">extractContainerIO</a>(</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <span class="keyword">const</span> ContainerID& containerID);</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// Helper function that returns `true` if `IOSwitchboardServer`</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// needs to be enabled for the given `ContainerConfig`. It must</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="comment">// be enabled for `DEBUG` containers and ones that need `TTYInfo`.</span></div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> 
<span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a57df4d6ba6123bf8af2f4fb15850f2ed">requiresServer</a>(</div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keyword">const</span> mesos::slave::ContainerConfig& containerConfig);</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span> </div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="keyword">private</span>:</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keyword">struct </span>Info</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  {</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  Info(<a class="code" href="classOption.html">Option<pid_t></a> _pid, <span class="keyword">const</span>
<a class="code" href="classprocess_1_1Future.html">process::Future</a><<a class="code" href="classOption.html">Option<int></a>>& _status)</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  : pid(_pid),</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1MesosIsolatorProcess.html#a7542c128af52b0fc7ffbf16767440c94">status</a>(_status) {}</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <a class="code" href="classOption.html">Option<pid_t></a> pid;</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<int></a>> <a class="code" href="classmesos_1_1internal_1_1slave_1_1MesosIsolatorProcess.html#a75
42c128af52b0fc7ffbf16767440c94">status</a>;</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <a class="code" href="classprocess_1_1Promise.html">process::Promise<mesos::slave::ContainerLimitation></a> limitation;</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  };</div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> </div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html">IOSwitchboard</a>(</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="keyword">const</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1Flags.html">Flags</a>& flags,</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordtype">bool</span> local,</div><div class="line"><a name="l00109
"></a><span class="lineno"> 109</span>  <a class="code" href="classprocess_1_1Owned.html">process::Owned<mesos::slave::ContainerLogger></a> logger);</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span> </div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerLaunchInfo></a>> _prepare(</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <span class="keyword">const</span> ContainerID& containerId,</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="keyword">const</span> mesos::slave::ContainerConfig& containerConfig,</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keyword">const</span> <a class="code" href="structmesos_1_1slave_1_1ContainerIO.html">mesos::s
lave::ContainerIO</a>& loggerIO);</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<process::http::Connection></a> _connect(</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="keyword">const</span> ContainerID& containerId) <span class="keyword">const</span>;</div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span> </div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerIO></a>> _extractContainerIO(</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="keyword">const</span> ContainerID& containerID);</div><div class="line">
<a name="l00121"></a><span class="lineno"> 121</span> </div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="keywordtype">void</span> reaped(</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keyword">const</span> ContainerID& containerId,</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="keyword">const</span> <a class="code" href="classprocess_1_1Future.html">process::Future</a><<a class="code" href="classOption.html">Option<int></a>>& future);</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span> </div><div cla
ss="line"><a name="l00128"></a><span class="lineno"> 128</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1Flags.html">Flags</a> flags;</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <span class="keywordtype">bool</span> local;</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <a class="code" href="classprocess_1_1Owned.html">process::Owned<mesos::slave::ContainerLogger></a> logger;</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <a class="code" href="classhashmap.html">hashmap<ContainerID, process::Owned<Info></a>> infos;</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="comment">// We use a separate hashmap to hold the `ContainerIO` for each</span></div><div class="line"><a name="l00134"></a><span class=
"lineno"> 134</span>  <span class="comment">// container because we need to maintain this information even in</span></div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="comment">// the case were we only instantiate the logger and never spawn an</span></div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="comment">// `IOSwitchbaordProcess`. Also, the lifetime of the `ContainerIO`</span></div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <span class="comment">// is shorter lived than the `Info` struct, as it should be removed</span></div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="comment">// from this hash as soon as ownership is transferred out of the</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="comment">// `IOSwitchboard` via a call to `extractCo
ntainerIO()`.</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <a class="code" href="classhashmap.html">hashmap<ContainerID, mesos::slave::ContainerIO></a> containerIOs;</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> };</div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span> </div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span> <span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="comment">// The `IOSwitchboardServer` encapsulates the server side logic for</span></div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment">// redirecting the `stdin/stdout/stderr` of a container to/from</span></div><div class="line"><a name=
"l00147"></a><span class="lineno"> 147</span> <span class="comment">// multiple sources/targets. It runs an HTTP server over a unix domain</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment">// socket in order to process incoming `ATTACH_CONTAINER_INPUT` and</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment">// `ATTACH_CONTAINER_OUTPUT` calls and redirect a containers</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span class="comment">// `stdin/stdout/stderr` through them. In 'local' mode, it is run</span></div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="comment">// inside the agent itself. In 'non-local' mode, it is run as an</span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="comment">// external proc
ess to survive agent restarts.</span></div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="keyword">class </span>IOSwitchboardServerProcess;</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span> </div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span> </div><div class="line"><a name="l00156"></a><span class="lineno"><a class="line" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboardServer.html"> 156</a></span> <span class="keyword">class </span><a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboardServer.html">IOSwitchboardServer</a></div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span> {</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// The set of flags t
o pass to the io switchboard server when</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">// launched in an external binary.</span></div><div class="line"><a name="l00161"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html"> 161</a></span>  <span class="keyword">struct </span><a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html">Flags</a> : <span class="keyword">public</span> <span class="keyword">virtual</span> <a class="code" href="classflags_1_1FlagsBase.html">flags::FlagsBase</a></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  {</div><div class="line"><a name="l00163"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a9ba1cc27c2d698c02272691cd71011ca"> 163</a></span>  <a class="code" href="stru
ctmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a9ba1cc27c2d698c02272691cd71011ca">Flags</a>()</div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  {</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  setUsageMessage(</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="stringliteral">"Usage: "</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(<a class="code" href="namespacemesos_1_1internal_1_1logger_1_1rotate.html#aee5dc359a1b6d22c5d912b166c895854">NAME</a>) + <span class="stringliteral">" [options]\n"</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="stringliteral">"The io switchboard server is designed to feed stdin to a container\n"</span></div><div class="line"><a name="l00168"></a><span class="lineno">
168</span>  <span class="stringliteral">"from an external source, as well as redirect the stdin/stdout of a\n"</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <span class="stringliteral">"container to multiple targets.\n"</span></div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="stringliteral">"\n"</span></div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <span class="stringliteral">"It runs an HTTP server over a unix domain socket in order to process\n"</span></div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="stringliteral">"incoming `ATTACH_CONTAINER_INPUT` and `ATTACH_CONTAINER_OUTPUT`\n"</span></div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="stringliteral">"calls
and redirect a containers `stdin/stdout/stderr` through them.\n"</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  <span class="stringliteral">"\n"</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="stringliteral">"The primary motivation of this component is to enable support in\n"</span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span class="stringliteral">"mesos similar to `docker attach` and `docker exec` whereby an\n"</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="stringliteral">"external client can attach to the stdin/stdout/stderr of a running\n"</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="stringliteral">"container as well as launch arbitrary s
ubcommands inside a container\n"</span></div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="stringliteral">"and attach to its stdin/stdout/stderr.\n"</span>);</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span> </div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::tty,</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="stringliteral">"tty"</span>,</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="stringliteral">"If a pseudo terminal has been allocated for the container."</span>,</div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keyword">false</span>);</div><d
iv class="line"><a name="l00185"></a><span class="lineno"> 185</span> </div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stdin_to_fd,</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="stringliteral">"stdin_to_fd"</span>,</div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="stringliteral">"The file descriptor where incoming stdin data should be written."</span>);</div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span> </div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stdout_from_fd,</div><div class="line"><a name="l00191"></a><span
class="lineno"> 191</span>  <span class="stringliteral">"stdout_from_fd"</span>,</div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="stringliteral">"The file descriptor that should be read to consume stdout data."</span>);</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> </div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stdout_to_fd,</div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="stringliteral">"stdout_to_fd"</span>,</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  <span class="stringliteral">"A file descriptor where data read from\n"</span></div><div class="line"><a name="l00197"></a><span cl
ass="lineno"> 197</span>  <span class="stringliteral">"'stdout_from_fd' should be redirected to."</span>);</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span> </div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stderr_from_fd,</div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="stringliteral">"stderr_from_fd"</span>,</div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="stringliteral">"The file descriptor that should be read to consume stderr data."</span>);</div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span> </div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <a class="code" href="n
amespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stderr_to_fd,</div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="stringliteral">"stderr_to_fd"</span>,</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="stringliteral">"A file descriptor where data read from\n"</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="stringliteral">"'stderr_from_fd' should be redirected to."</span>);</div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span> </div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::wait_for_connection,</div><div class="line"><a name="l00209"></a><span class="lineno">
209</span>  <span class="stringliteral">"wait_for_connection"</span>,</div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="stringliteral">"A boolean indicating whether the server should wait for the\n"</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="stringliteral">"first connection before reading any data from the '*_from_fd's."</span>,</div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keyword">false</span>);</div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::socket_path,</div><div class="line"><a name="l00215"></a><span class="lin
eno"> 215</span>  <span class="stringliteral">"socket_address"</span>,</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="stringliteral">"The path of the unix domain socket this\n"</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="stringliteral">"io switchboard should attach itself to."</span>);</div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> </div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::heartbeat_interval,</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="stringliteral">"heartbeat_interval"</span>,</div><div class="line"><a name="l00221"></a><span class="lineno"> 221</sp
an>  <span class="stringliteral">"A heartbeat interval (e.g. '5secs', '10mins') for messages to\n"</span></div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="stringliteral">"be sent to any open 'ATTACH_CONTAINER_OUTPUT' connections."</span>);</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  }</div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span> </div><div class="line"><a name="l00225"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a7aeae38f9e0a65be598f1e0bb4c5a6f7"> 225</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a7aeae38f9e0a65be598f1e0bb4c5a6f7">tty</a>;</div><div class="line"><a name="l00226"></a><span class="lineno"><a class="li
ne" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#ab24d7876b7ce75aa3a3d74cbaf33db36"> 226</a></span>  <a class="code" href="classOption.html">Option<int></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#ab24d7876b7ce75aa3a3d74cbaf33db36">stdin_to_fd</a>;</div><div class="line"><a name="l00227"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a8ed39aae84487878322e6d8788689324"> 227</a></span>  <a class="code" href="classOption.html">Option<int></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a8ed39aae84487878322e6d8788689324">stdout_from_fd</a>;</div><div class="line"><a name="l00228"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a0b96a9db77cecec1cf4b184500349c7e"> 228</a></span>  <a cl
ass="code" href="classOption.html">Option<int></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a0b96a9db77cecec1cf4b184500349c7e">stdout_to_fd</a>;</div><div class="line"><a name="l00229"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a1bf9244c976c6542fdf1a840bfa9d875"> 229</a></span>  <a class="code" href="classOption.html">Option<int></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a1bf9244c976c6542fdf1a840bfa9d875">stderr_from_fd</a>;</div><div class="line"><a name="l00230"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a2e6dec0912f5dba98ea388cd01097c95"> 230</a></span>  <a class="code" href="classOption.html">Option<int></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.h
tml#a2e6dec0912f5dba98ea388cd01097c95">stderr_to_fd</a>;</div><div class="line"><a name="l00231"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a88f0b27d5cd8be525d9e1c6832876d68"> 231</a></span>  <a class="code" href="classOption.html">Option<std::string></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a88f0b27d5cd8be525d9e1c6832876d68">socket_path</a>;</div><div class="line"><a name="l00232"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#ac9c75249757d61c631871cac0da8c8ac"> 232</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#ac9c75249757d61c631871cac0da8c8ac">wait_for_connection</a>;</div><div class="line"><a name="l00233"></a><span class="lineno"><a class="line" href="structmesos_1
_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a5785a4d321a8d16b8ac8387bacbeb9b9"> 233</a></span>  <a class="code" href="classOption.html">Option<Duration></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a5785a4d321a8d16b8ac8387bacbeb9b9">heartbeat_interval</a>;</div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  };</div><div class="line"><a name="l00235"></a><span class="lineno"> 235</span> </div><div class="line"><a name="l00236"></a><span class="lineno"><a class="line" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboardServer.html#ac74af0b8d192b61a99f24fe6a6266ccc"> 236</a></span>  <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> <a class="code" href="namespacemesos_1_1internal_1_1logger_1_1rotate.html#aee5dc359a1b6d22c5d912b166c895854">NAME</a>[];</div><div class="line"><a name="l00237"></a><span cla
ss="lineno"> 237</span> </div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<process::Owned<IOSwitchboardServer></a>> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a99a26ff439ca948c0bf5f822d55f1628">create</a>(</div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="keywordtype">bool</span> tty,</div><div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  <span class="keywordtype">int</span> stdinToFd,</div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  <span class="keywordtype">int</span> stdoutFromFd,</div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  <span class="keywordtype">int</span> stdoutToFd,</div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span>
0; <span class="keywordtype">int</span> stderrFromFd,</div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <span class="keywordtype">int</span> stderrToFd,</div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keyword">const</span> std::string& socketPath,</div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  <span class="keywordtype">bool</span> waitForConnection = <span class="keyword">false</span>,</div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  <a class="code" href="classOption.html">Option<Duration></a> heartbeatInterval = <a class="code" href="structNone.html">None</a>());</div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span> </div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  ~<a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchb
oardServer.html">IOSwitchboardServer</a>();</div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span> </div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="comment">// Run the io switchboard server.</span></div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="namespaceprocess_1_1internal.html#a4c8e1d1a64b9ebccdd0c2bdf34233212">run</a>();</div><div class="line"><a name="l00253"></a><span class="lineno"> 253</span> </div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  <span class="comment">// Forcibly unblock the io switchboard server if it</span></div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  <span class="comment">// has been started with `waitForConnection` set to `true`.</span></div><div class="line"><
a name="l00256"></a><span class="lineno"> 256</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="namespaceos_1_1signals.html#af3a85f6669d18ed19b920de56006e372">unblock</a>();</div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span> </div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="keyword">private</span>:</div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboardServer.html">IOSwitchboardServer</a>(</div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  <span class="keywordtype">bool</span> tty,</div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  <span class="keywordtype">int</span> stdinToFd,</div><div class="line"><a name="l00262"></a><span class="lineno"> 262</span> 
<span class="keywordtype">int</span> stdoutFromFd,</div><div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  <span class="keywordtype">int</span> stdoutToFd,</div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <span class="keywordtype">int</span> stderrFromFd,</div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  <span class="keywordtype">int</span> stderrToFd,</div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  <span class="keyword">const</span> <a class="code" href="classprocess_1_1network_1_1internal_1_1Socket.html">process::network::unix::Socket</a>& <a class="code" href="namespacerouting.html#aee51d4e36a57bab7d6ada56e15467370">socket</a>,</div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="keywordtype">bool</span> waitForConnection,</div><div class="line"><a name="l00268"></a><span
class="lineno"> 268</span>  <a class="code" href="classOption.html">Option<Duration></a> heartbeatInterval);</div><div class="line"><a name="l00269"></a><span class="lineno"> 269</span> </div><div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <a class="code" href="classprocess_1_1Owned.html">process::Owned<IOSwitchboardServerProcess></a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>;</div><div class="line"><a name="l00271"></a><span class="lineno"> 271</span> };</div><div class="line"><a name="l00272"></a><span class="lineno"> 272</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00273"></a><span class="lineno"> 273</span> </div><div class="line"><a name="l00274"></a><span class="lineno"> 274</span> } <span class="comment">// namespace slave {</span></div><div class="line"><a name="l00275"></a><span class="lineno">
275</span> } <span class="comment">// namespace internal {</span></div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span> } <span class="comment">// namespace mesos {</span></div><div class="line"><a name="l00277"></a><span class="lineno"> 277</span> </div><div class="line"><a name="l00278"></a><span class="lineno"> 278</span> <span class="preprocessor">#endif // __MESOS_CONTAINERIZER_IO_SWITCHBOARD_HPP__</span></div><div class="ttc" id="classmesos_1_1internal_1_1slave_1_1IOSwitchboard_html_a50fc15a892743e6dc4e56585bcf6d08a"><div class="ttname"><a href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a50fc15a892743e6dc4e56585bcf6d08a">mesos::internal::slave::IOSwitchboard::supportsNesting</a></div><div class="ttdeci">virtual bool supportsNesting()</div></div>
+<a href="switchboard_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment">// or more contributor license agreements. See the NOTICE file</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">// regarding copyright ownership. The ASF licenses this file</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">// to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00006"></a><span
class="lineno"> 6</span> <span class="comment">// "License"); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">// with the License. You may obtain a copy of the License at</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">// distr
ibuted under the License is distributed on an "AS IS" BASIS,</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#ifndef __MESOS_CONTAINERIZER_IO_SWITCHBOARD_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __MESOS_CONTAINERIZER_IO_SWITCHB
OARD_HPP__</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <string></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <<a class="code" href="future_8hpp.html">process/future.hpp</a>></span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2libprocess_2include_2process_2http_8hpp.html">process/http.hpp</a>></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="owned_8hpp.html">process/owned.hpp</a>></span></div><div class="line"><a name="l00025"></a><
span class="lineno"> 25</span> <span class="preprocessor">#include <<a class="code" href="libprocess_2include_2process_2socket_8hpp.html">process/socket.hpp</a>></span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="include_2mesos_2slave_2containerizer_8hpp.html">mesos/slave/containerizer.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="slave_2container__logger_8hpp.html">mesos/slave/container_logger.hpp</a>>
;</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include "<a class="code" href="src_2slave_2flags_8hpp.html">slave/flags.hpp</a>"</span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include "<a class="code" href="src_2slave_2containerizer_2mesos_2isolator_8hpp.html">slave/containerizer/mesos/isolator.hpp</a>"</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> </div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="keyword">namespace </span><a class="code" href="namespacemesos.html">mesos</a> {</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span clas
s="keyword">namespace </span><a class="code" href="namespaceinternal.html">internal</a> {</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="keyword">namespace </span>slave {</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> </div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">// The `IOSwitchboard` is a component in the agent whose job it is to</span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// instantiate an `IOSwitchboardServer` that can be used to feed the</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">// stdin to a container from an external source, as well as redirect</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// the stdin/stdout of a container to multip
le targets.</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">//</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// The primary motivation of this component is to enable support in</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// mesos similar to `docker attach` and `docker exec` whereby an</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// external client can attach to the stdin/stdout/stderr of a running</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// container as well as launch arbitrary subcommands inside a</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// container and attach to its stdin/stdout/s
tderr.</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">//</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// The I/O switchboard is integrated with `MesosContainerizer` through</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// the `Isolator` interface.</span></div><div class="line"><a name="l00053"></a><span class="lineno"><a class="line" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html"> 53</a></span> <span class="keyword">class </span><a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html">IOSwitchboard</a> : <span class="keyword">public</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1MesosIsolatorProcess.html">MesosIsolatorProcess</a></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> {</div><div class="l
ine"><a name="l00055"></a><span class="lineno"> 55</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<IOSwitchboard*></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a99a26ff439ca948c0bf5f822d55f1628">create</a>(</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <span class="keyword">const</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1Flags.html">Flags</a>& <a class="code" href="namespaceflags.html">flags</a>,</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="keywordtype">bool</span> local);</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> </div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywo
rd">virtual</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a60f9214954b1664959cfd6a32b5bc959">~IOSwitchboard</a>();</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> </div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a50fc15a892743e6dc4e56585bcf6d08a">supportsNesting</a>();</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a1a3bc4ad72074b5d3e21b21442217375">supportsStandalone</a>();</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> </div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <
span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#ab1d7d003cfa4c8c25bdc98f91619e71a">recover</a>(</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="keyword">const</span> std::vector<mesos::slave::ContainerState>& states,</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="keyword">const</span> <a class="code" href="classhashset.html">hashset<ContainerID></a>& orphans);</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> </div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerLaunchInfo></a>> <a class="code" href="class
mesos_1_1internal_1_1slave_1_1IOSwitchboard.html#ad58eafeb96f1c2b760e6f2652c1fbabc">prepare</a>(</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <span class="keyword">const</span> ContainerID& containerId,</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="keyword">const</span> mesos::slave::ContainerConfig& containerConfig);</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> </div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<mesos::slave::ContainerLimitation></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#aa383182ee41d05570c9e52278c073a6c">watch</a>(</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <span class="keyword">const</span> Contain
erID& containerId);</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="keyword">virtual</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#aa4c0bb4d89a195ceaaba6a8aae97eabb">cleanup</a>(</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keyword">const</span> ContainerID& containerId);</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> </div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="comment">// Connect to the `IOSwitchboard` associated with `containerId`.</span></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="code" href="classprocess_1_1Future.html">pro
cess::Future<process::http::Connection></a> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#acd44076631fa55207e19b315a13cbdd3">connect</a>(</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="keyword">const</span> ContainerID& containerId) <span class="keyword">const</span>;</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <span class="comment">// Transfer ownership of a `ContainerIO` struct for a given</span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="comment">// container out of the `IOSwitchboard` and into the caller.</span></div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerIO></a>&g
t; <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a12117c45cfd218537f0c5f562542c4f1">extractContainerIO</a>(</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <span class="keyword">const</span> ContainerID& containerID);</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// Helper function that returns `true` if `IOSwitchboardServer`</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// needs to be enabled for the given `ContainerConfig`. It must</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="comment">// be enabled for `DEBUG` containers and ones that need `TTYInfo`.</span></div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> 
<span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html#a57df4d6ba6123bf8af2f4fb15850f2ed">requiresServer</a>(</div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keyword">const</span> mesos::slave::ContainerConfig& containerConfig);</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span> </div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="keyword">private</span>:</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keyword">struct </span>Info</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  {</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  Info(<a class="code" href="classOption.html">Option<pid_t></a> _pid, <span class="keyword">const</span
> <a class="code" href="classprocess_1_1Future.html">process::Future</a><<a class="code" href="classOption.html">Option<int></a>>& _status)</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  : pid(_pid),</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1MesosIsolatorProcess.html#a7542c128af52b0fc7ffbf16767440c94">status</a>(_status) {}</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <a class="code" href="classOption.html">Option<pid_t></a> pid;</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<int></a>> <a class="code" href="classmesos_1_1internal_1_1slave_1_1MesosIsolatorProcess.html#a
7542c128af52b0fc7ffbf16767440c94">status</a>;</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <a class="code" href="classprocess_1_1Promise.html">process::Promise<mesos::slave::ContainerLimitation></a> limitation;</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  };</div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> </div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboard.html">IOSwitchboard</a>(</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="keyword">const</span> <a class="code" href="classmesos_1_1internal_1_1slave_1_1Flags.html">Flags</a>& flags,</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordtype">bool</span> local,</div><div class="line"><a name="l001
09"></a><span class="lineno"> 109</span>  <a class="code" href="classprocess_1_1Owned.html">process::Owned<mesos::slave::ContainerLogger></a> logger);</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span> </div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerLaunchInfo></a>> _prepare(</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <span class="keyword">const</span> ContainerID& containerId,</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="keyword">const</span> mesos::slave::ContainerConfig& containerConfig,</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keyword">const</span> <a class="code" href="structmesos_1_1slave_1_1ContainerIO.html">mesos:
:slave::ContainerIO</a>& loggerIO);</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<process::http::Connection></a> _connect(</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="keyword">const</span> ContainerID& containerId) <span class="keyword">const</span>;</div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span> </div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <a class="code" href="classprocess_1_1Future.html">process::Future<Option<mesos::slave::ContainerIO></a>> _extractContainerIO(</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="keyword">const</span> ContainerID& containerID);</div><div class="line
"><a name="l00121"></a><span class="lineno"> 121</span> </div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="keywordtype">void</span> reaped(</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keyword">const</span> ContainerID& containerId,</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="keyword">const</span> <a class="code" href="classprocess_1_1Future.html">process::Future</a><<a class="code" href="classOption.html">Option<int></a>>& future);</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span> </div><div c
lass="line"><a name="l00128"></a><span class="lineno"> 128</span>  <a class="code" href="classmesos_1_1internal_1_1slave_1_1Flags.html">Flags</a> flags;</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <span class="keywordtype">bool</span> local;</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <a class="code" href="classprocess_1_1Owned.html">process::Owned<mesos::slave::ContainerLogger></a> logger;</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <a class="code" href="classhashmap.html">hashmap<ContainerID, process::Owned<Info></a>> infos;</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="comment">// We use a separate hashmap to hold the `ContainerIO` for each</span></div><div class="line"><a name="l00134"></a><span clas
s="lineno"> 134</span>  <span class="comment">// container because we need to maintain this information even in</span></div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="comment">// the case were we only instantiate the logger and never spawn an</span></div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="comment">// `IOSwitchbaordProcess`. Also, the lifetime of the `ContainerIO`</span></div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <span class="comment">// is shorter lived than the `Info` struct, as it should be removed</span></div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="comment">// from this hash as soon as ownership is transferred out of the</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="comment">// `IOSwitchboard` via a call to `extract
ContainerIO()`.</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <a class="code" href="classhashmap.html">hashmap<ContainerID, mesos::slave::ContainerIO></a> containerIOs;</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> };</div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span> </div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span> <span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="comment">// The `IOSwitchboardServer` encapsulates the server side logic for</span></div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment">// redirecting the `stdin/stdout/stderr` of a container to/from</span></div><div class="line"><a nam
e="l00147"></a><span class="lineno"> 147</span> <span class="comment">// multiple sources/targets. It runs an HTTP server over a unix domain</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment">// socket in order to process incoming `ATTACH_CONTAINER_INPUT` and</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment">// `ATTACH_CONTAINER_OUTPUT` calls and redirect a containers</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span class="comment">// `stdin/stdout/stderr` through them. In 'local' mode, it is run</span></div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="comment">// inside the agent itself. In 'non-local' mode, it is run as an</span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="comment">// external pr
ocess to survive agent restarts.</span></div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="keyword">class </span>IOSwitchboardServerProcess;</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span> </div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span> </div><div class="line"><a name="l00156"></a><span class="lineno"><a class="line" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboardServer.html"> 156</a></span> <span class="keyword">class </span><a class="code" href="classmesos_1_1internal_1_1slave_1_1IOSwitchboardServer.html">IOSwitchboardServer</a></div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span> {</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// The set of flags
to pass to the io switchboard server when</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">// launched in an external binary.</span></div><div class="line"><a name="l00161"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html"> 161</a></span>  <span class="keyword">struct </span><a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html">Flags</a> : <span class="keyword">public</span> <span class="keyword">virtual</span> <a class="code" href="classflags_1_1FlagsBase.html">flags::FlagsBase</a></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  {</div><div class="line"><a name="l00163"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a9ba1cc27c2d698c02272691cd71011ca"> 163</a></span>  <a class="code" href="st
ructmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a9ba1cc27c2d698c02272691cd71011ca">Flags</a>()</div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  {</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  setUsageMessage(</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="stringliteral">"Usage: "</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(<a class="code" href="namespacemesos_1_1internal_1_1logger_1_1rotate.html#aee5dc359a1b6d22c5d912b166c895854">NAME</a>) + <span class="stringliteral">" [options]\n"</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="stringliteral">"The io switchboard server is designed to feed stdin to a container\n"</span></div><div class="line"><a name="l00168"></a><span class="lineno
"> 168</span>  <span class="stringliteral">"from an external source, as well as redirect the stdin/stdout of a\n"</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <span class="stringliteral">"container to multiple targets.\n"</span></div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="stringliteral">"\n"</span></div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <span class="stringliteral">"It runs an HTTP server over a unix domain socket in order to process\n"</span></div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="stringliteral">"incoming `ATTACH_CONTAINER_INPUT` and `ATTACH_CONTAINER_OUTPUT`\n"</span></div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="stringliteral">"cal
ls and redirect a containers `stdin/stdout/stderr` through them.\n"</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  <span class="stringliteral">"\n"</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="stringliteral">"The primary motivation of this component is to enable support in\n"</span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span class="stringliteral">"mesos similar to `docker attach` and `docker exec` whereby an\n"</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="stringliteral">"external client can attach to the stdin/stdout/stderr of a running\n"</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="stringliteral">"container as well as launch arbitrary
subcommands inside a container\n"</span></div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="stringliteral">"and attach to its stdin/stdout/stderr.\n"</span>);</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span> </div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::tty,</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="stringliteral">"tty"</span>,</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="stringliteral">"If a pseudo terminal has been allocated for the container."</span>,</div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keyword">false</span>);</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> </div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stdin_to_fd,</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="stringliteral">"stdin_to_fd"</span>,</div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="stringliteral">"The file descriptor where incoming stdin data should be written."</span>);</div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span> </div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stdout_from_fd,</div><div class="line"><a name="l00191"></a><sp
an class="lineno"> 191</span>  <span class="stringliteral">"stdout_from_fd"</span>,</div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="stringliteral">"The file descriptor that should be read to consume stdout data."</span>);</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> </div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stdout_to_fd,</div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="stringliteral">"stdout_to_fd"</span>,</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  <span class="stringliteral">"A file descriptor where data read from\n"</span></div><div class="line"><a name="l00197"></a><span
class="lineno"> 197</span>  <span class="stringliteral">"'stdout_from_fd' should be redirected to."</span>);</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span> </div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stderr_from_fd,</div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="stringliteral">"stderr_from_fd"</span>,</div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="stringliteral">"The file descriptor that should be read to consume stderr data."</span>);</div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span> </div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <a class="code" href=
"namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::stderr_to_fd,</div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="stringliteral">"stderr_to_fd"</span>,</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="stringliteral">"A file descriptor where data read from\n"</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="stringliteral">"'stderr_from_fd' should be redirected to."</span>);</div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span> </div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::wait_for_connection,</div><div class="line"><a name="l00209"></a><span class="lineno
"> 209</span>  <span class="stringliteral">"wait_for_connection"</span>,</div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="stringliteral">"A boolean indicating whether the server should wait for the\n"</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="stringliteral">"first connection before reading any data from the '*_from_fd's."</span>,</div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keyword">false</span>);</div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::socket_path,</div><div class="line"><a name="l00215"></a><span class="l
ineno"> 215</span>  <span class="stringliteral">"socket_address"</span>,</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="stringliteral">"The path of the unix domain socket this\n"</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="stringliteral">"io switchboard should attach itself to."</span>);</div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> </div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <a class="code" href="namespaceprocess_1_1metrics.html#a15af50f3f4dbcca2f7c619ccfbaa70b2">add</a>(&Flags::heartbeat_interval,</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="stringliteral">"heartbeat_interval"</span>,</div><div class="line"><a name="l00221"></a><span class="lineno"> 221</
span>  <span class="stringliteral">"A heartbeat interval (e.g. '5secs', '10mins') for messages to\n"</span></div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="stringliteral">"be sent to any open 'ATTACH_CONTAINER_OUTPUT' connections."</span>);</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  }</div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span> </div><div class="line"><a name="l00225"></a><span class="lineno"><a class="line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a7aeae38f9e0a65be598f1e0bb4c5a6f7"> 225</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#a7aeae38f9e0a65be598f1e0bb4c5a6f7">tty</a>;</div><div class="line"><a name="l00226"></a><span class="lineno"><a class="
line" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#ab24d7876b7ce75aa3a3d74cbaf33db36"> 226</a></span>  <a class="code" href="classOption.html">Option<int></a> <a class="code" href="structmesos_1_1internal_1_1slave_1_1IOSwitchboardServer_1_1Flags.html#ab24d7876b7ce75aa3a3d74cbaf33db36">stdin_to_fd</a>;</div><div class=
<TRUNCATED>