http://git-wip-us.apache.org/repos/asf/mesos-site/blob/33d26065/content/api/latest/c++/docker__common_8hpp_source.html ---------------------------------------------------------------------- diff --git a/content/api/latest/c++/docker__common_8hpp_source.html b/content/api/latest/c++/docker__common_8hpp_source.html index 41b47ea..7cc541d 100644 --- a/content/api/latest/c++/docker__common_8hpp_source.html +++ b/content/api/latest/c++/docker__common_8hpp_source.html @@ -52,7 +52,7 @@ <div class="title">docker_common.hpp</div> </div> </div><!--header--> <div class="contents"> -<a href="docker__common_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><s pan 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">// di stributed 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 __TEST_DOCKER_COMMON_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __TEST_DOCKER_COMMON_HPP__</span></div><div c lass="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="libprocess_2include_2process_2gtest_8hpp.html">process/gtest.hpp</a>></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2libprocess_2include_2process_2io_8hpp.html">process/io.hpp</a>></span></div><div class="line"><a name="l00025"></a><spa n class="lineno"> 25</span> <span class="preprocessor">#include <<a class="code" href="owned_8hpp.html">process/owned.hpp</a>></span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <<a class="code" href="include_2process_2subprocess_8hpp.html">process/subprocess.hpp</a>></span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="format_8hpp.html">stout/format.hpp</a>></span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2gtest_8hpp.html">stout/gtest.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class= "code" href="lambda_8hpp.html">stout/lambda.hpp</a>></span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="mkdtemp_8hpp.html">stout/os/mkdtemp.hpp</a>></span></div><div class="line"><a name="l00036"></a><span class="lineno"> 3 6</span> </div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include "<a class="code" href="docker_2docker_8hpp.html">docker/docker.hpp</a>"</span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#include "<a class="code" href="src_2tests_2flags_8hpp.html">tests/flags.hpp</a>"</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="keyword">namespace </span><a class="code" href="namespacemesos.html">mesos</a> {</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="keyword">namespace </span><a class="code" href="namespaceinternal.html">internal</a> {</div><div class="line"><a name="l0004 3"></a><span class="lineno"> 43</span> <span class="keyword">namespace </span>tests {</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> </div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// The following image is the microsoft/nanoserver image with</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// ContainerAdministrator as the default user. There are some permission bugs</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// with accessing volume mounts in process (but not Hyper-V) isolation as</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// the regular ContainerUser user, but accesing them as ContainerAdministrator</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// works fine.</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_TEST_IMAGE[] = <span class="stringliteral">"akagup/nano-admin"</span>;</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> </div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// We use a custom HTTP(S) server here, because the official `microsoft/iis`</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// HTTP server image is ~20x larger than this one, so pulling it takes too</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="co mment">// long. This server supports HTTP and HTTPS listening on port 80 and 443.</span></div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// For more information, see https://github.com/gupta-ak/https-server.</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_IMAGE[] = <span class="stringliteral">"akagup/https-server"</span>;</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_COMMAND[] = <span class="stringliteral">"http.exe"</span>;</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_IMAGE[] = <span class="stringliteral">&q uot;akagup/https-server"</span>;</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_COMMAND[] = <span class="stringliteral">"http.exe"</span>;</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_TEST_IMAGE[] = <span class="stringliteral">"alpine"</span>;</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> </div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment">// The HTTP server is netcat running on alpine.</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="key word">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_IMAGE[] = <span class="stringliteral">"alpine"</span>;</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_COMMAND[] =</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="stringliteral">"nc -lk -p 80 -e echo -e \"HTTP/1.1 200 OK\r\nContent-Length: 0\r\n\""</span>;</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="comment">// Refer to https://github.com/qianzhangxa/https-server for</span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment">// how the Docker image `zhq527725/https-server` works.</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_IMAGE[] = <span class="stringliteral">"zhq527725/https-server"</span>;</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_COMMAND[] = <span class="stringliteral">"python https_server.py 443"</span>;</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div><div class="line"><a name="l00075"></a><span class="lineno"><a class="line" href="namespacemesos_1_1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e"> 75</a></span> constexpr <span class="keywordtype">char</span> <a class="code" href="namespacemesos_1 _1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e">DOCKER_IPv6_NETWORK</a>[] = <span class="stringliteral">"mesos-docker-ip6-test"</span>;</div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> </div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> </div><div class="line"><a name="l00078"></a><span class="lineno"><a class="line" href="namespacemesos_1_1internal_1_1tests.html#a15c592efe4e9ba851ddcf2c79f4b2dcf"> 78</a></span> <span class="keyword">inline</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a15c592efe4e9ba851ddcf2c79f4b2dcf">pullDockerImage</a>(<span class="keyword">const</span> std::string& imageName)</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> {</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="cod e" href="classTry.html">Try<process::Owned<Docker></a>> <a class="code" href="namespacedocker.html">docker</a> =</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <a class="code" href="classDocker.html#a370c1d613e35cc8b8e393dc8c83876e6">Docker::create</a>(<a class="code" href="namespacemesos_1_1internal_1_1tests.html#af8289f648a916c3f66923867452c7b1b">tests::flags</a>.docker, <a class="code" href="namespacemesos_1_1internal_1_1tests.html#af8289f648a916c3f66923867452c7b1b">tests::flags</a>.docker_socket, <span class="keyword">false</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="keywordflow">if</span> (docker.isError()) {</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="keywordflow">return</span> <a class="code" href="structprocess_1_1Failure.ht ml">process::Failure</a>(docker.error());</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  }</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span> </div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="keyword">const</span> <a class="code" href="classTry.html">Try<std::string></a> directory = <a class="code" href="namespaceos.html#afe70fd86d13b8f10cafb222bb80adcf6">os::mkdtemp</a>();</div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="keywordflow">if</span> (directory.isError()) {</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="keywordflow">return</span> <a class="code" href="structprocess_1_1Failure.html">process::Failure</a>(docker.error());</div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  }</div><div class="line"><a name="l00091"></a>< span class="lineno"> 91</span> </div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keywordflow">return</span> docker.get()->pull(directory.get(), imageName)</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  .<a class="code" href="namespaceprocess_1_1internal.html#a7885011cf6470b707294a6ef4ec7a0a6">then</a>([]() {</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="comment">// `Docker::pull` returns a `Future<Docker::Image`>, but we only really</span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="comment">// if the pull was successful, so we just return `Nothing` to match the</span></div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="comment">// return type of `pullDockerImage`.</span></div><div class="line"><a name="l00097"></a><sp an class="lineno"> 97</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  })</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  .onAny([directory]() -> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> {</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#a84298b990ad52dfd353358427b04ff3f">rmdir</a> = <a class="code" href="namespaceos.html#a84298b990ad52dfd353358427b04ff3f">os::rmdir</a>(directory.get());</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keywordflow">if</span> (rmdir.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div> <div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="keywordflow">return</span> <a class="code" href="structprocess_1_1Failure.html">process::Failure</a>(rmdir.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  }</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</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> }</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> </div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> </div><div class="line"><a name="l00109"></a><span class="lineno"><a class="line" href ="namespacemesos_1_1internal_1_1tests.html#a971a18f563bfbd01896a97a7a72ccde1"> 109</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a971a18f563bfbd01896a97a7a72ccde1">createDockerIPv6UserNetwork</a>()</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>  <span class="comment">// Docker IPv6 is not supported on Windows, so no-op on that platform.</span></div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <span class="comment">// TODO(akagup): Remove the #ifdef when Windows supports IPv6 networks</span></div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="comment">// in docker containers. See MESOS-8566.</span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span> 0;<span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="comment">// Create a Docker user network with IPv6 enabled.</span></div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <a class="code" href="classTry.html">Try<std::string></a> dockerCommand = <a class="code" href="namespacestrings.html#a7884a23bea2a6543b8a93ad48faabe0c">strings::format</a>(</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="stringliteral">"docker network create --driver=bridge --ipv6 "</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="stringliteral">"--subnet=fd01::/64 %s"</span>,</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  DOCKER_IPv6_NETWORK);</div><div class="line"><a name="l00120"></a><span class="li neno"> 120</span> </div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <a class="code" href="classTry.html">Try<process::Subprocess></a> s = <a class="code" href="namespaceprocess.html#a2d7e0a283bc0c9eca8a8b0532e026269">process::subprocess</a>(</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  dockerCommand.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(),</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null"</span>),</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null&quo t;</span>),</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <a class="code" href="classprocess_1_1Subprocess.html#a6af5024bd1932707893908fceb86ddad">process::Subprocess::PIPE</a>());</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> </div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s) << <span class="stringliteral">"Unable to create the Docker IPv6 network: "</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  << <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e">DOCKER_IPv6_NETWORK</a>;</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span> </div><div class="line"><a name="l00130"></a><span class="lineno"> 130</sp an>  <a class="code" href="classprocess_1_1Future.html">process::Future<std::string></a> err = <a class="code" href="namespaceprocess_1_1io.html#a4c34d22e475e29f12ac739921dcc580f">process::io::read</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a98180558f1427a64a03cf3f656310bc4">err</a>().<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>());</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="comment">// Wait for the network to be created.</span></div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>());</div><div class="line"><a name="l00134">< /a><span class="lineno"> 134</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(err);</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span> </div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>().<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>());</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  ASSERT_EQ(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>()-><a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>(), 0)</div><div class="line"><a name="l00138"></a><sp an class="lineno"> 138</span>  << <span class="stringliteral">"Unable to create the Docker IPv6 network "</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  << DOCKER_IPv6_NETWORK</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  << <span class="stringliteral">" : "</span> << err.<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>();</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="preprocessor">#endif // __WINDOWS__</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> </div><div class="line"><a name="l00145"></a><span class="lineno"><a class="line" href="namespac emesos_1_1internal_1_1tests.html#a4143a755ba48009f54529ab97cb3beb3"> 145</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a4143a755ba48009f54529ab97cb3beb3">removeDockerIPv6UserNetwork</a>()</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span> {</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// Docker IPv6 is not supported on Windows, so no-op on that platform.</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// TODO(akagup): Remove the #ifdef when Windows supports IPv6 networks</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="comment">// in docker containers. See MESOS-8566.</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span cl ass="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="comment">// Delete the Docker user network.</span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <a class="code" href="classTry.html">Try<std::string></a> dockerCommand =</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <a class="code" href="namespacestrings.html#a7884a23bea2a6543b8a93ad48faabe0c">strings::format</a>(<span class="stringliteral">"docker network rm %s"</span>, DOCKER_IPv6_NETWORK);</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>  <a class="code" href="classTry.html">Try<process::Subprocess></a> s = <a class="code" href="namespaceprocess.html#a2d7e0a283bc0c9eca8a8b0532e026269">subprocess</a>(</div><div class="lin e"><a name="l00156"></a><span class="lineno"> 156</span>  dockerCommand.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(),</div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null"</span>),</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null"</span>),</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <a class="code" href="classprocess_1_1Subprocess.html#a6af5024bd1932707893908fceb86ddad">process::Subprocess::PIPE</a>());</div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span> </d iv><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="comment">// This is best effort cleanup. In case of an error just a log an</span></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// error.</span></div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s) << <span class="stringliteral">"Unable to delete the Docker IPv6 network: "</span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  << <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e">DOCKER_IPv6_NETWORK</a>;</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span> </div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span> 60; <a class="code" href="classprocess_1_1Future.html">process::Future<std::string></a> err = <a class="code" href="namespaceprocess_1_1io.html#a4c34d22e475e29f12ac739921dcc580f">process::io::read</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a98180558f1427a64a03cf3f656310bc4">err</a>().<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>());</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span> </div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="comment">// Wait for the network to be deleted.</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>());</div><div class="line"><a name="l00170"></a><sp an class="lineno"> 170</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(err);</div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span> </div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>().<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>());</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  ASSERT_EQ(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>()-><a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>(), 0)</div><div class="line"><a name="l00174"></a><span cla ss="lineno"> 174</span>  << <span class="stringliteral">"Unable to delete the Docker IPv6 network "</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  << DOCKER_IPv6_NETWORK</div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  << <span class="stringliteral">" : "</span> << err.<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>();</div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span> }</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</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"><a class="line" href="namespacemesos _1_1internal_1_1tests.html#af386ecbbf46a9598c02450185b4ba3e2"> 181</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#af386ecbbf46a9598c02450185b4ba3e2">assertDockerKillStatus</a>(<a class="code" href="classprocess_1_1Future.html">process::Future</a><<a class="code" href="classOption.html">Option<int></a>>& <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>)</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span> {</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="comment">// On Windows, there is no standard exit code for determining if a process</span></div><div class="line"><a name="l00185"></a><span class="lineno"> 185< /span>  <span class="comment">// as been killed. However, in Docker, it will not return 0.</span></div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#ae4d00c37c2287bce910fff6885429cfb">AWAIT_EXPECT_WEXITSTATUS_NE</a>(0, <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>.get());</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a222e5f770c87370e0f92d2a597b95b2d">AWAIT_EXPECT_WEXITSTATUS_EQ</a>(128 + <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1c2b5693161bbc9d516ef5d16c7b54f5">SIGKILL</a>, <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>);</div><div class= "line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span> }</div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span> </div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span> } <span class="comment">// namespace tests {</span></div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> } <span class="comment">// namespace internal {</span></div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span> } <span class="comment">// namespace mesos {</span></div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span> </div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="preprocessor">#endif // __TEST_DOCKER_COMMON_HPP__</span></div><div class="ttc" id="namespaceos_html_a84298b990ad52df d353358427b04ff3f"><div class="ttname"><a href="namespaceos.html#a84298b990ad52dfd353358427b04ff3f">os::rmdir</a></div><div class="ttdeci">Try< Nothing > rmdir(const std::string &directory, bool recursive=true, bool removeRoot=true, bool continueOnError=false)</div><div class="ttdef"><b>Definition:</b> rmdir.hpp:43</div></div> +<a href="docker__common_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><s pan 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">// di stributed 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 __TEST_DOCKER_COMMON_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __TEST_DOCKER_COMMON_HPP__</span></div><div c lass="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="libprocess_2include_2process_2gtest_8hpp.html">process/gtest.hpp</a>></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2libprocess_2include_2process_2io_8hpp.html">process/io.hpp</a>></span></div><div class="line"><a name="l00025"></a><spa n class="lineno"> 25</span> <span class="preprocessor">#include <<a class="code" href="owned_8hpp.html">process/owned.hpp</a>></span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <<a class="code" href="include_2process_2subprocess_8hpp.html">process/subprocess.hpp</a>></span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="format_8hpp.html">stout/format.hpp</a>></span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2gtest_8hpp.html">stout/gtest.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class= "code" href="lambda_8hpp.html">stout/lambda.hpp</a>></span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="mkdtemp_8hpp.html">stout/os/mkdtemp.hpp</a>></span></div><div class="line"><a name="l00036"></a><span class="lineno"> 3 6</span> </div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include "<a class="code" href="docker_2docker_8hpp.html">docker/docker.hpp</a>"</span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#include "<a class="code" href="src_2tests_2flags_8hpp.html">tests/flags.hpp</a>"</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="keyword">namespace </span><a class="code" href="namespacemesos.html">mesos</a> {</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="keyword">namespace </span><a class="code" href="namespaceinternal.html">internal</a> {</div><div class="line"><a name="l0004 3"></a><span class="lineno"> 43</span> <span class="keyword">namespace </span>tests {</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> </div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// The following image is the microsoft/nanoserver image with</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// ContainerAdministrator as the default user. There are some permission bugs</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// with accessing volume mounts in process (but not Hyper-V) isolation as</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// the regular ContainerUser user, but accesing them as ContainerAdministrator</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// works fine.</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_TEST_IMAGE[] = <span class="stringliteral">"akagup/nano-admin"</span>;</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> </div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// We use a custom HTTP(S) server here, because the official `microsoft/iis`</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// HTTP server image is ~20x larger than this one, so pulling it takes too</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="co mment">// long. This server supports HTTP and HTTPS listening on port 80 and 443.</span></div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// For more information, see https://github.com/gupta-ak/https-server.</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_IMAGE[] = <span class="stringliteral">"akagup/https-server"</span>;</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_COMMAND[] = <span class="stringliteral">"http.exe"</span>;</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_IMAGE[] = <span class="stringliteral">&q uot;akagup/https-server"</span>;</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_COMMAND[] = <span class="stringliteral">"http.exe"</span>;</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_TEST_IMAGE[] = <span class="stringliteral">"alpine"</span>;</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> </div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment">// The HTTP server is netcat running on alpine.</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="key word">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_IMAGE[] = <span class="stringliteral">"alpine"</span>;</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTP_COMMAND[] =</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="stringliteral">"nc -lk -p 80 -e echo -e \"HTTP/1.1 200 OK\r\nContent-Length: 0\r\n\""</span>;</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="comment">// Refer to https://github.com/qianzhangxa/https-server for</span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment">// how the Docker image `zhq527725/https-server` works.</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_IMAGE[] = <span class="stringliteral">"zhq527725/https-server"</span>;</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="keyword">static</span> constexpr <span class="keywordtype">char</span> DOCKER_HTTPS_COMMAND[] = <span class="stringliteral">"python https_server.py 443"</span>;</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div><div class="line"><a name="l00075"></a><span class="lineno"><a class="line" href="namespacemesos_1_1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e"> 75</a></span> constexpr <span class="keywordtype">char</span> <a class="code" href="namespacemesos_1 _1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e">DOCKER_IPv6_NETWORK</a>[] = <span class="stringliteral">"mesos-docker-ip6-test"</span>;</div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> </div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> </div><div class="line"><a name="l00078"></a><span class="lineno"><a class="line" href="namespacemesos_1_1internal_1_1tests.html#a15c592efe4e9ba851ddcf2c79f4b2dcf"> 78</a></span> <span class="keyword">inline</span> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a15c592efe4e9ba851ddcf2c79f4b2dcf">pullDockerImage</a>(<span class="keyword">const</span> std::string& imageName)</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> {</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <a class="cod e" href="classTry.html">Try<process::Owned<Docker></a>> <a class="code" href="namespacedocker.html">docker</a> =</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <a class="code" href="classDocker.html#a370c1d613e35cc8b8e393dc8c83876e6">Docker::create</a>(<a class="code" href="namespacemesos_1_1internal_1_1tests.html#af8289f648a916c3f66923867452c7b1b">tests::flags</a>.docker, <a class="code" href="namespacemesos_1_1internal_1_1tests.html#af8289f648a916c3f66923867452c7b1b">tests::flags</a>.docker_socket, <span class="keyword">false</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="keywordflow">if</span> (docker.isError()) {</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="keywordflow">return</span> <a class="code" href="structprocess_1_1Failure.ht ml">process::Failure</a>(docker.error());</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  }</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span> </div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="keyword">const</span> <a class="code" href="classTry.html">Try<std::string></a> directory = <a class="code" href="namespaceos.html#afe70fd86d13b8f10cafb222bb80adcf6">os::mkdtemp</a>();</div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="keywordflow">if</span> (directory.isError()) {</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="keywordflow">return</span> <a class="code" href="structprocess_1_1Failure.html">process::Failure</a>(docker.error());</div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  }</div><div class="line"><a name="l00091"></a>< span class="lineno"> 91</span> </div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keywordflow">return</span> docker.get()->pull(directory.get(), imageName)</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  .<a class="code" href="namespaceprocess_1_1internal.html#a7885011cf6470b707294a6ef4ec7a0a6">then</a>([]() {</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="comment">// `Docker::pull` returns a `Future<Docker::Image`>, but we only really</span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="comment">// if the pull was successful, so we just return `Nothing` to match the</span></div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="comment">// return type of `pullDockerImage`.</span></div><div class="line"><a name="l00097"></a><sp an class="lineno"> 97</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  })</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  .onAny([directory]() -> <a class="code" href="classprocess_1_1Future.html">process::Future<Nothing></a> {</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#a84298b990ad52dfd353358427b04ff3f">rmdir</a> = <a class="code" href="namespaceos.html#a84298b990ad52dfd353358427b04ff3f">os::rmdir</a>(directory.get());</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keywordflow">if</span> (rmdir.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div> <div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="keywordflow">return</span> <a class="code" href="structprocess_1_1Failure.html">process::Failure</a>(rmdir.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  }</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</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> }</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> </div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> </div><div class="line"><a name="l00109"></a><span class="lineno"><a class="line" href ="namespacemesos_1_1internal_1_1tests.html#a971a18f563bfbd01896a97a7a72ccde1"> 109</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a971a18f563bfbd01896a97a7a72ccde1">createDockerIPv6UserNetwork</a>()</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>  <span class="comment">// Docker IPv6 is not supported on Windows, so no-op on that platform.</span></div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <span class="comment">// TODO(akagup): Remove the #ifdef when Windows supports IPv6 networks</span></div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="comment">// in docker containers. See MESOS-8566.</span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span> 0;<span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="comment">// Create a Docker user network with IPv6 enabled.</span></div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <a class="code" href="classTry.html">Try<std::string></a> dockerCommand = <a class="code" href="namespacestrings.html#a7884a23bea2a6543b8a93ad48faabe0c">strings::format</a>(</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="stringliteral">"docker network create --driver=bridge --ipv6 "</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="stringliteral">"--subnet=fd01::/64 %s"</span>,</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  DOCKER_IPv6_NETWORK);</div><div class="line"><a name="l00120"></a><span class="li neno"> 120</span> </div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <a class="code" href="classTry.html">Try<process::Subprocess></a> s = <a class="code" href="namespaceprocess.html#a2d7e0a283bc0c9eca8a8b0532e026269">process::subprocess</a>(</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  dockerCommand.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(),</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null"</span>),</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null&quo t;</span>),</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <a class="code" href="classprocess_1_1Subprocess.html#a6af5024bd1932707893908fceb86ddad">process::Subprocess::PIPE</a>());</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> </div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s) << <span class="stringliteral">"Unable to create the Docker IPv6 network: "</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  << <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e">DOCKER_IPv6_NETWORK</a>;</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span> </div><div class="line"><a name="l00130"></a><span class="lineno"> 130</sp an>  <a class="code" href="classprocess_1_1Future.html">process::Future<std::string></a> err = <a class="code" href="namespaceprocess_1_1io.html#a4c34d22e475e29f12ac739921dcc580f">process::io::read</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a98180558f1427a64a03cf3f656310bc4">err</a>().<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>());</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="comment">// Wait for the network to be created.</span></div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>());</div><div class="line"><a name="l00134">< /a><span class="lineno"> 134</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(err);</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span> </div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>().<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>());</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  ASSERT_EQ(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>()-><a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>(), 0)</div><div class="line"><a name="l00138"></a><sp an class="lineno"> 138</span>  << <span class="stringliteral">"Unable to create the Docker IPv6 network "</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  << DOCKER_IPv6_NETWORK</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  << <span class="stringliteral">" : "</span> << err.<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>();</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="preprocessor">#endif // __WINDOWS__</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> </div><div class="line"><a name="l00145"></a><span class="lineno"><a class="line" href="namespac emesos_1_1internal_1_1tests.html#a4143a755ba48009f54529ab97cb3beb3"> 145</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a4143a755ba48009f54529ab97cb3beb3">removeDockerIPv6UserNetwork</a>()</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span> {</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// Docker IPv6 is not supported on Windows, so no-op on that platform.</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// TODO(akagup): Remove the #ifdef when Windows supports IPv6 networks</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="comment">// in docker containers. See MESOS-8566.</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span cl ass="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="comment">// Delete the Docker user network.</span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <a class="code" href="classTry.html">Try<std::string></a> dockerCommand =</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <a class="code" href="namespacestrings.html#a7884a23bea2a6543b8a93ad48faabe0c">strings::format</a>(<span class="stringliteral">"docker network rm %s"</span>, DOCKER_IPv6_NETWORK);</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>  <a class="code" href="classTry.html">Try<process::Subprocess></a> s = <a class="code" href="namespaceprocess.html#a2d7e0a283bc0c9eca8a8b0532e026269">subprocess</a>(</div><div class="lin e"><a name="l00156"></a><span class="lineno"> 156</span>  dockerCommand.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(),</div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null"</span>),</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <a class="code" href="classprocess_1_1Subprocess.html#a54793e9c516257d68776f63f0872c3c7">process::Subprocess::PATH</a>(<span class="stringliteral">"/dev/null"</span>),</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <a class="code" href="classprocess_1_1Subprocess.html#a6af5024bd1932707893908fceb86ddad">process::Subprocess::PIPE</a>());</div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span> </d iv><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="comment">// This is best effort cleanup. In case of an error just a log an</span></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// error.</span></div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s) << <span class="stringliteral">"Unable to delete the Docker IPv6 network: "</span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  << <a class="code" href="namespacemesos_1_1internal_1_1tests.html#a3e9b4c80f181d9d31576c268120dd49e">DOCKER_IPv6_NETWORK</a>;</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span> </div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span> 60; <a class="code" href="classprocess_1_1Future.html">process::Future<std::string></a> err = <a class="code" href="namespaceprocess_1_1io.html#a4c34d22e475e29f12ac739921dcc580f">process::io::read</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a98180558f1427a64a03cf3f656310bc4">err</a>().<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>());</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span> </div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="comment">// Wait for the network to be deleted.</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>());</div><div class="line"><a name="l00170"></a><sp an class="lineno"> 170</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a269c59ba4bb2bec7ac8e361e45f52d43">AWAIT_READY</a>(err);</div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span> </div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <a class="code" href="stout_2include_2stout_2gtest_8hpp.html#a0add664e84bbf99f845f1b715dd63f90">ASSERT_SOME</a>(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>().<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>());</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  ASSERT_EQ(s-><a class="code" href="classprocess_1_1Subprocess.html#a3946c31d16c0625ea554d5216cd4fa3b">status</a>()-><a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>(), 0)</div><div class="line"><a name="l00174"></a><span cla ss="lineno"> 174</span>  << <span class="stringliteral">"Unable to delete the Docker IPv6 network "</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  << DOCKER_IPv6_NETWORK</div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  << <span class="stringliteral">" : "</span> << err.<a class="code" href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>();</div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span> }</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</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"><a class="line" href="namespacemesos _1_1internal_1_1tests.html#af386ecbbf46a9598c02450185b4ba3e2"> 181</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacemesos_1_1internal_1_1tests.html#af386ecbbf46a9598c02450185b4ba3e2">assertDockerKillStatus</a>(<a class="code" href="classprocess_1_1Future.html">process::Future</a><<a class="code" href="classOption.html">Option<int></a>>& <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>)</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span> {</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="comment">// On Windows, there is no standard exit code for determining if a process</span></div><div class="line"><a name="l00185"></a><span class="lineno"> 185< /span>  <span class="comment">// as been killed. However, in Docker, it will not return 0.</span></div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#ae4d00c37c2287bce910fff6885429cfb">AWAIT_EXPECT_WEXITSTATUS_NE</a>(0, <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>.get());</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <a class="code" href="libprocess_2include_2process_2gtest_8hpp.html#a222e5f770c87370e0f92d2a597b95b2d">AWAIT_EXPECT_WEXITSTATUS_EQ</a>(128 + <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1c2b5693161bbc9d516ef5d16c7b54f5">SIGKILL</a>, <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>);</div><div class= "line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span> }</div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span> </div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span> } <span class="comment">// namespace tests {</span></div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> } <span class="comment">// namespace internal {</span></div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span> } <span class="comment">// namespace mesos {</span></div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span> </div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="preprocessor">#endif // __TEST_DOCKER_COMMON_HPP__</span></div><div class="ttc" id="namespaceos_html_a84298b990ad52df d353358427b04ff3f"><div class="ttname"><a href="namespaceos.html#a84298b990ad52dfd353358427b04ff3f">os::rmdir</a></div><div class="ttdeci">Try< Nothing > rmdir(const std::string &directory, bool recursive=true, bool removeRoot=true, bool continueOnError=false)</div><div class="ttdef"><b>Definition:</b> rmdir.hpp:42</div></div> <div class="ttc" id="structNothing_html"><div class="ttname"><a href="structNothing.html">Nothing</a></div><div class="ttdef"><b>Definition:</b> nothing.hpp:16</div></div> <div class="ttc" id="classOption_html"><div class="ttname"><a href="classOption.html">Option< int ></a></div></div> <div class="ttc" id="classTry_html_a8bc7f43e75a47111ea18e9c83b007be5"><div class="ttname"><a href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">Try::get</a></div><div class="ttdeci">T & get()&</div><div class="ttdef"><b>Definition:</b> try.hpp:73</div></div>
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/33d26065/content/api/latest/c++/posix_2rmdir_8hpp.html ---------------------------------------------------------------------- diff --git a/content/api/latest/c++/posix_2rmdir_8hpp.html b/content/api/latest/c++/posix_2rmdir_8hpp.html index 3973400..ca0b9de 100644 --- a/content/api/latest/c++/posix_2rmdir_8hpp.html +++ b/content/api/latest/c++/posix_2rmdir_8hpp.html @@ -61,7 +61,6 @@ <code>#include <glog/logging.h></code><br /> <code>#include <<a class="el" href="error_8hpp_source.html">stout/error.hpp</a>></code><br /> <code>#include <<a class="el" href="nothing_8hpp_source.html">stout/nothing.hpp</a>></code><br /> -<code>#include <<a class="el" href="path_8hpp_source.html">stout/path.hpp</a>></code><br /> <code>#include <<a class="el" href="stringify_8hpp_source.html">stout/stringify.hpp</a>></code><br /> <code>#include <<a class="el" href="try_8hpp_source.html">stout/try.hpp</a>></code><br /> <code>#include <<a class="el" href="exists_8hpp_source.html">stout/os/exists.hpp</a>></code><br />