http://git-wip-us.apache.org/repos/asf/mesos-site/blob/ac68e329/content/api/latest/c++/windows_2shell_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/windows_2shell_8hpp_source.html 
b/content/api/latest/c++/windows_2shell_8hpp_source.html
index a0f9559..61b1a6e 100644
--- a/content/api/latest/c++/windows_2shell_8hpp_source.html
+++ b/content/api/latest/c++/windows_2shell_8hpp_source.html
@@ -52,13 +52,15 @@
 <div class="title">shell.hpp</div>  </div>
 </div><!--header-->
 <div class="contents">
-<a href="windows_2shell_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>&#160;<span class="comment">// Licensed under the 
Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div 
class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span 
class="comment">// you may not use this file except in compliance with the 
License.</span></div><div class="line"><a name="l00003"></a><span 
class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy 
of the License at</span></div><div class="line"><a name="l00004"></a><span 
class="lineno">    4</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span 
class="comment">//  http://www.apache.org/licenses/LICENSE-2.0</span></div><div 
class="line"><a name="l00006"></a><span class="lineno">    6</span>&#160;<span 
class="comment">/
 /</span></div><div class="line"><a name="l00007"></a><span class="lineno">    
7</span>&#160;<span class="comment">// Unless required by applicable law or 
agreed to in writing, software</span></div><div class="line"><a 
name="l00008"></a><span class="lineno">    8</span>&#160;<span 
class="comment">// distributed under the License is distributed on an &quot;AS 
IS&quot; BASIS,</span></div><div class="line"><a name="l00009"></a><span 
class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR 
CONDITIONS OF ANY KIND, either express or implied.</span></div><div 
class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span 
class="comment">// See the License for the specific language governing 
permissions and</span></div><div class="line"><a name="l00011"></a><span 
class="lineno">   11</span>&#160;<span class="comment">// limitations under the 
License.</span></div><div class="line"><a name="l00012"></a><span 
class="lineno">   12</span>&#160;</div><div cla
 ss="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span 
class="preprocessor">#ifndef __STOUT_OS_WINDOWS_SHELL_HPP__</span></div><div 
class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span 
class="preprocessor">#define __STOUT_OS_WINDOWS_SHELL_HPP__</span></div><div 
class="line"><a name="l00015"></a><span class="lineno">   
15</span>&#160;</div><div class="line"><a name="l00016"></a><span 
class="lineno">   16</span>&#160;<span class="preprocessor">#include 
&lt;process.h&gt;</span></div><div class="line"><a name="l00017"></a><span 
class="lineno">   17</span>&#160;<span class="preprocessor">#include 
&lt;stdarg.h&gt;</span> <span class="comment">// For va_list, va_start, 
etc.</span></div><div class="line"><a name="l00018"></a><span class="lineno">   
18</span>&#160;</div><div class="line"><a name="l00019"></a><span 
class="lineno">   19</span>&#160;<span class="preprocessor">#include 
&lt;algorithm&gt;</span></div><div class="line"><a name="l00020"
 ></a><span class="lineno">   20</span>&#160;<span 
 >class="preprocessor">#include &lt;array&gt;</span></div><div class="line"><a 
 >name="l00021"></a><span class="lineno">   21</span>&#160;<span 
 >class="preprocessor">#include &lt;map&gt;</span></div><div class="line"><a 
 >name="l00022"></a><span class="lineno">   22</span>&#160;<span 
 >class="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a 
 >name="l00023"></a><span class="lineno">   23</span>&#160;<span 
 >class="preprocessor">#include &lt;vector&gt;</span></div><div class="line"><a 
 >name="l00024"></a><span class="lineno">   24</span>&#160;</div><div 
 >class="line"><a name="l00025"></a><span class="lineno">   
 >25</span>&#160;<span class="preprocessor">#include &lt;<a class="code" 
 >href="error_8hpp.html">stout/error.hpp</a>&gt;</span></div><div 
 >class="line"><a name="l00026"></a><span class="lineno">   
 >26</span>&#160;<span class="preprocessor">#include &lt;<a class="code" 
 >href="foreach_8hpp.html">stout/foreach.hpp</a>&gt;</span></d
 iv><div class="line"><a name="l00027"></a><span class="lineno">   
27</span>&#160;<span class="preprocessor">#include &lt;<a class="code" 
href="none_8hpp.html">stout/none.hpp</a>&gt;</span></div><div class="line"><a 
name="l00028"></a><span class="lineno">   28</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="option_8hpp.html">stout/option.hpp</a>&gt;</span></div><div 
class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="os_8hpp.html">stout/os.hpp</a>&gt;</span></div><div class="line"><a 
name="l00030"></a><span class="lineno">   30</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="try_8hpp.html">stout/try.hpp</a>&gt;</span></div><div class="line"><a 
name="l00031"></a><span class="lineno">   31</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>&gt;</span></div><d
 iv class="line"><a name="l00032"></a><span class="lineno">   
32</span>&#160;</div><div class="line"><a name="l00033"></a><span 
class="lineno">   33</span>&#160;<span class="preprocessor">#include &lt;<a 
class="code" 
href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>&gt;</span></div><div 
class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="pipe_8hpp.html">stout/os/pipe.hpp</a>&gt;</span></div><div 
class="line"><a name="l00035"></a><span class="lineno">   
35</span>&#160;</div><div class="line"><a name="l00036"></a><span 
class="lineno">   36</span>&#160;<span class="preprocessor">#include &lt;<a 
class="code" 
href="inherit_8hpp.html">stout/internal/windows/inherit.hpp</a>&gt;</span></div><div
 class="line"><a name="l00037"></a><span class="lineno">   
37</span>&#160;</div><div class="line"><a name="l00038"></a><span 
class="lineno">   38</span>&#160;<span class="keyword">namespace </span><a 
class="code" href="n
 amespaceinternal.html">internal</a> {</div><div class="line"><a 
name="l00039"></a><span class="lineno">   39</span>&#160;<span 
class="keyword">namespace </span>windows {</div><div class="line"><a 
name="l00040"></a><span class="lineno">   40</span>&#160;</div><div 
class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;<span 
class="comment">// Retrieves system environment in a `std::map`, 
ignoring</span></div><div class="line"><a name="l00042"></a><span 
class="lineno">   42</span>&#160;<span class="comment">// the current 
process&#39;s environment variables.</span></div><div class="line"><a 
name="l00043"></a><span class="lineno"><a class="line" 
href="namespaceinternal_1_1windows.html#a8fc9ccf78565ac55f90070486d385227">   
43</a></span>&#160;<span class="keyword">inline</span> <a class="code" 
href="classOption.html">Option&lt;std::map&lt;std::wstring, 
std::wstring&gt;</a>&gt; <a class="code" 
href="namespaceinternal_1_1windows.html#a8fc9ccf78565ac55f90070486d385227">get
 _system_env</a>()</div><div class="line"><a name="l00044"></a><span 
class="lineno">   44</span>&#160;{</div><div class="line"><a 
name="l00045"></a><span class="lineno">   45</span>&#160;  
std::map&lt;std::wstring, std::wstring&gt; system_env;</div><div 
class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;  
<span class="keywordtype">wchar_t</span>* env_entry = <span 
class="keyword">nullptr</span>;</div><div class="line"><a 
name="l00047"></a><span class="lineno">   47</span>&#160;</div><div 
class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;  
<span class="comment">// Get the system environment.</span></div><div 
class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;  
<span class="comment">// The third parameter (bool) tells the function *not* to 
inherit</span></div><div class="line"><a name="l00050"></a><span 
class="lineno">   50</span>&#160;  <span class="comment">// variables from the 
current process.</span></div><div class
 ="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;  <span 
class="keywordflow">if</span> 
(!::CreateEnvironmentBlock((LPVOID*)&amp;env_entry, <span 
class="keyword">nullptr</span>, FALSE)) {</div><div class="line"><a 
name="l00052"></a><span class="lineno">   52</span>&#160;    <span 
class="keywordflow">return</span> <a class="code" 
href="structNone.html">None</a>();</div><div class="line"><a 
name="l00053"></a><span class="lineno">   53</span>&#160;  }</div><div 
class="line"><a name="l00054"></a><span class="lineno">   
54</span>&#160;</div><div class="line"><a name="l00055"></a><span 
class="lineno">   55</span>&#160;  <span class="comment">// Save the 
environment block in order to destroy it later.</span></div><div 
class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;  
<span class="keywordtype">wchar_t</span>* env_block = env_entry;</div><div 
class="line"><a name="l00057"></a><span class="lineno">   
57</span>&#160;</div><div class="line"><a name="l0
 0058"></a><span class="lineno">   58</span>&#160;  <span 
class="keywordflow">while</span> (*env_entry != L<span 
class="charliteral">&#39;\0&#39;</span>) {</div><div class="line"><a 
name="l00059"></a><span class="lineno">   59</span>&#160;    <span 
class="comment">// Each environment block contains the environment variables as 
follows:</span></div><div class="line"><a name="l00060"></a><span 
class="lineno">   60</span>&#160;    <span class="comment">// 
Var1=Value1\0</span></div><div class="line"><a name="l00061"></a><span 
class="lineno">   61</span>&#160;    <span class="comment">// 
Var2=Value2\0</span></div><div class="line"><a name="l00062"></a><span 
class="lineno">   62</span>&#160;    <span class="comment">// 
Var3=Value3\0</span></div><div class="line"><a name="l00063"></a><span 
class="lineno">   63</span>&#160;    <span class="comment">// 
...</span></div><div class="line"><a name="l00064"></a><span class="lineno">   
64</span>&#160;    <span class="comment">// VarN=ValueN\0\0</sp
 an></div><div class="line"><a name="l00065"></a><span class="lineno">   
65</span>&#160;    <span class="comment">// The name of an environment variable 
cannot include an equal sign (=).</span></div><div class="line"><a 
name="l00066"></a><span class="lineno">   66</span>&#160;</div><div 
class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;    
<span class="comment">// Construct a string from the pointer up to the first 
&#39;\0&#39;,</span></div><div class="line"><a name="l00068"></a><span 
class="lineno">   68</span>&#160;    <span class="comment">// e.g. 
&quot;Var1=Value1\0&quot;, then split into name and value.</span></div><div 
class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;    
std::wstring entry(env_entry);</div><div class="line"><a 
name="l00070"></a><span class="lineno">   70</span>&#160;    
std::wstring::size_type separator = entry.find(L<span 
class="stringliteral">&quot;=&quot;</span>);</div><div class="line"><a 
name="l00071"></a><spa
 n class="lineno">   71</span>&#160;    std::wstring var_name(entry.substr(0, 
separator));</div><div class="line"><a name="l00072"></a><span class="lineno">  
 72</span>&#160;    std::wstring varVal(entry.substr(separator + 1));</div><div 
class="line"><a name="l00073"></a><span class="lineno">   
73</span>&#160;</div><div class="line"><a name="l00074"></a><span 
class="lineno">   74</span>&#160;    <span class="comment">// Mesos variables 
are upper case. Convert system variables to</span></div><div class="line"><a 
name="l00075"></a><span class="lineno">   75</span>&#160;    <span 
class="comment">// match the name provided by the scheduler in case of a 
collision.</span></div><div class="line"><a name="l00076"></a><span 
class="lineno">   76</span>&#160;    <span class="comment">// This is safe 
because Windows environment variables are case insensitive.</span></div><div 
class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;    <a 
class="code" href="namespacemesos_1_1inte
 
rnal_1_1recordio.html#a5fcab68176c462aaeed909f304c91bdf">std::transform</a>(</div><div
 class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;      
  var_name.begin(), var_name.end(), var_name.begin(), ::towupper);</div><div 
class="line"><a name="l00079"></a><span class="lineno">   
79</span>&#160;</div><div class="line"><a name="l00080"></a><span 
class="lineno">   80</span>&#160;    <span class="comment">// The system 
environment has priority.</span></div><div class="line"><a 
name="l00081"></a><span class="lineno">   81</span>&#160;    
system_env.insert_or_assign(var_name.data(), varVal.data());</div><div 
class="line"><a name="l00082"></a><span class="lineno">   
82</span>&#160;</div><div class="line"><a name="l00083"></a><span 
class="lineno">   83</span>&#160;    <span class="comment">// Advance the 
pointer the length of the entry string plus the &#39;\0&#39;.</span></div><div 
class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;    
env_entry +=
  entry.length() + 1;</div><div class="line"><a name="l00085"></a><span 
class="lineno">   85</span>&#160;  }</div><div class="line"><a 
name="l00086"></a><span class="lineno">   86</span>&#160;</div><div 
class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;  
::DestroyEnvironmentBlock(env_block);</div><div class="line"><a 
name="l00088"></a><span class="lineno">   88</span>&#160;</div><div 
class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;  
<span class="keywordflow">return</span> system_env;</div><div class="line"><a 
name="l00090"></a><span class="lineno">   90</span>&#160;}</div><div 
class="line"><a name="l00091"></a><span class="lineno">   
91</span>&#160;</div><div class="line"><a name="l00092"></a><span 
class="lineno">   92</span>&#160;</div><div class="line"><a 
name="l00093"></a><span class="lineno">   93</span>&#160;<span 
class="comment">// Creates a null-terminated array of null-terminated strings 
that will be</span></div><div class="line
 "><a name="l00094"></a><span class="lineno">   94</span>&#160;<span 
class="comment">// passed to `CreateProcessW` as the `lpEnvironment` argument, 
as described by</span></div><div class="line"><a name="l00095"></a><span 
class="lineno">   95</span>&#160;<span class="comment">// MSDN[1]. This array 
needs to be sorted in alphabetical order, but the `map`</span></div><div 
class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;<span 
class="comment">// already takes care of that. Note that this function 
explicitly handles</span></div><div class="line"><a name="l00097"></a><span 
class="lineno">   97</span>&#160;<span class="comment">// UTF-16 environments, 
so it must be used in conjunction with the</span></div><div class="line"><a 
name="l00098"></a><span class="lineno">   98</span>&#160;<span 
class="comment">// `CREATE_UNICODE_ENVIRONMENT` flag.</span></div><div 
class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;<span 
class="comment">//</span></div><
 div class="line"><a name="l00100"></a><span class="lineno">  
100</span>&#160;<span class="comment">// NOTE: This function will add the 
system&#39;s environment variables into</span></div><div class="line"><a 
name="l00101"></a><span class="lineno">  101</span>&#160;<span 
class="comment">// the returned string. These variables take precedence over 
the provided</span></div><div class="line"><a name="l00102"></a><span 
class="lineno">  102</span>&#160;<span class="comment">// `env` and are 
generally necessary in order to launch things on Windows.</span></div><div 
class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00104"></a><span 
class="lineno">  104</span>&#160;<span class="comment">// [1] 
https://msdn.microsoft.com/en-us/library/windows/desktop/ms682425(v=vs.85).aspx</span></div><div
 class="line"><a name="l00105"></a><span class="lineno"><a class="line" 
href="namespaceinternal_1_1windows.html#a7b6974
 b9ba88dd5d9658c40268147581">  105</a></span>&#160;<span 
class="keyword">inline</span> <a class="code" 
href="classOption.html">Option&lt;std::wstring&gt;</a> <a class="code" 
href="namespaceinternal_1_1windows.html#a7b6974b9ba88dd5d9658c40268147581">create_process_env</a>(</div><div
 class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;    
<span class="keyword">const</span> <a class="code" 
href="classOption.html">Option</a>&lt;std::map&lt;std::string, 
std::string&gt;&gt;&amp; env)</div><div class="line"><a name="l00107"></a><span 
class="lineno">  107</span>&#160;{</div><div class="line"><a 
name="l00108"></a><span class="lineno">  108</span>&#160;  <span 
class="keywordflow">if</span> (env.isNone() || (env.isSome() &amp;&amp; 
env.get().size() == 0)) {</div><div class="line"><a name="l00109"></a><span 
class="lineno">  109</span>&#160;    <span class="keywordflow">return</span> <a 
class="code" href="structNone.html">None</a>();</div><div class="line"><a 
name="l00110"></
 a><span class="lineno">  110</span>&#160;  }</div><div class="line"><a 
name="l00111"></a><span class="lineno">  111</span>&#160;</div><div 
class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;  <a 
class="code" href="classOption.html">Option&lt;std::map&lt;std::wstring, 
std::wstring&gt;</a>&gt; system_env = <a class="code" 
href="namespaceinternal_1_1windows.html#a8fc9ccf78565ac55f90070486d385227">get_system_env</a>();</div><div
 class="line"><a name="l00113"></a><span class="lineno">  
113</span>&#160;</div><div class="line"><a name="l00114"></a><span 
class="lineno">  114</span>&#160;  <span class="comment">// The system 
environment must be non-empty.</span></div><div class="line"><a 
name="l00115"></a><span class="lineno">  115</span>&#160;  <span 
class="comment">// No subprocesses will be able to launch if the system 
environment is blank.</span></div><div class="line"><a name="l00116"></a><span 
class="lineno">  116</span>&#160;  CHECK(system_env.<a class="code" hre
 f="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() &amp;&amp; 
system_env.<a class="code" 
href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>().size() &gt; 
0);</div><div class="line"><a name="l00117"></a><span class="lineno">  
117</span>&#160;</div><div class="line"><a name="l00118"></a><span 
class="lineno">  118</span>&#160;  std::map&lt;std::wstring, std::wstring&gt; 
combined_env;</div><div class="line"><a name="l00119"></a><span class="lineno"> 
 119</span>&#160;</div><div class="line"><a name="l00120"></a><span 
class="lineno">  120</span>&#160;  <span class="comment">// Populate the 
combined environment first with the system environment.</span></div><div 
class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;  <a 
class="code" 
href="foreach_8hpp.html#a66900b166526abe66464d6597536b111">foreachpair</a> 
(<span class="keyword">const</span> std::wstring&amp; key,</div><div 
class="line"><a name="l00122"></a><span class="lineno">  122</span
 >&#160;               <span class="keyword">const</span> std::wstring&amp; 
 >value,</div><div class="line"><a name="l00123"></a><span class="lineno">  
 >123</span>&#160;               system_env.<a class="code" 
 >href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>()) 
 >{</div><div class="line"><a name="l00124"></a><span class="lineno">  
 >124</span>&#160;    combined_env[key] = value;</div><div class="line"><a 
 >name="l00125"></a><span class="lineno">  125</span>&#160;  }</div><div 
 >class="line"><a name="l00126"></a><span class="lineno">  
 >126</span>&#160;</div><div class="line"><a name="l00127"></a><span 
 >class="lineno">  127</span>&#160;  <span class="comment">// Now override with 
 >the supplied environment.</span></div><div class="line"><a 
 >name="l00128"></a><span class="lineno">  128</span>&#160;  <a class="code" 
 >href="foreach_8hpp.html#a66900b166526abe66464d6597536b111">foreachpair</a> 
 >(<span class="keyword">const</span> std::string&amp; key,</div><div 
 >class="line"><a name="l00129"
 ></a><span class="lineno">  129</span>&#160;               <span 
 >class="keyword">const</span> std::string&amp; value,</div><div 
 >class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;     
 >          env.get()) {</div><div class="line"><a name="l00131"></a><span 
 >class="lineno">  131</span>&#160;    combined_env[wide_stringify(key)] = 
 >wide_stringify(value);</div><div class="line"><a name="l00132"></a><span 
 >class="lineno">  132</span>&#160;  }</div><div class="line"><a 
 >name="l00133"></a><span class="lineno">  133</span>&#160;</div><div 
 >class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;  
 >std::wstring env_string;</div><div class="line"><a name="l00135"></a><span 
 >class="lineno">  135</span>&#160;  <a class="code" 
 >href="foreach_8hpp.html#a66900b166526abe66464d6597536b111">foreachpair</a> 
 >(<span class="keyword">const</span> std::wstring&amp; key,</div><div 
 >class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;     
 >          <span cl
 ass="keyword">const</span> std::wstring&amp; value,</div><div class="line"><a 
name="l00137"></a><span class="lineno">  137</span>&#160;               
combined_env) {</div><div class="line"><a name="l00138"></a><span 
class="lineno">  138</span>&#160;    env_string += key + L<span 
class="charliteral">&#39;=&#39;</span> + value + L<span 
class="charliteral">&#39;\0&#39;</span>;</div><div class="line"><a 
name="l00139"></a><span class="lineno">  139</span>&#160;  }</div><div 
class="line"><a name="l00140"></a><span class="lineno">  
140</span>&#160;</div><div class="line"><a name="l00141"></a><span 
class="lineno">  141</span>&#160;  <span class="comment">// Append final null 
terminating character.</span></div><div class="line"><a name="l00142"></a><span 
class="lineno">  142</span>&#160;  env_string.push_back(L<span 
class="charliteral">&#39;\0&#39;</span>);</div><div class="line"><a 
name="l00143"></a><span class="lineno">  143</span>&#160;  <span 
class="keywordflow">return</span> env_string;
 </div><div class="line"><a name="l00144"></a><span class="lineno">  
144</span>&#160;}</div><div class="line"><a name="l00145"></a><span 
class="lineno">  145</span>&#160;</div><div class="line"><a 
name="l00146"></a><span class="lineno">  146</span>&#160;</div><div 
class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;<span 
class="comment">// Concatenates multiple command-line arguments and escapes the 
values.</span></div><div class="line"><a name="l00148"></a><span 
class="lineno">  148</span>&#160;<span class="comment">// NOTE: This is 
necessary even when using Windows APIs that &quot;appear&quot;</span></div><div 
class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;<span 
class="comment">// to take arguments as a list, because those APIs will 
themselves</span></div><div class="line"><a name="l00150"></a><span 
class="lineno">  150</span>&#160;<span class="comment">// concatenate 
command-line arguments *without* escaping them.</span></div><div cla
 ss="line"><a name="l00151"></a><span class="lineno">  151</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00152"></a><span 
class="lineno">  152</span>&#160;<span class="comment">// This function escapes 
arguments with the following rules:</span></div><div class="line"><a 
name="l00153"></a><span class="lineno">  153</span>&#160;<span 
class="comment">//   1) Any argument with a space, tab, newline, vertical 
tab,</span></div><div class="line"><a name="l00154"></a><span class="lineno">  
154</span>&#160;<span class="comment">//      or double-quote must be 
surrounded in double-quotes.</span></div><div class="line"><a 
name="l00155"></a><span class="lineno">  155</span>&#160;<span 
class="comment">//   2) Backslashes at the very end of an argument must be 
escaped.</span></div><div class="line"><a name="l00156"></a><span 
class="lineno">  156</span>&#160;<span class="comment">//   3) Backslashes that 
precede a double-quote must be escaped.</span></div><div class="
 line"><a name="l00157"></a><span class="lineno">  157</span>&#160;<span 
class="comment">//      The double-quote must also be escaped.</span></div><div 
class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00159"></a><span 
class="lineno">  159</span>&#160;<span class="comment">// NOTE: The below 
algorithm is adapted from Daniel Colascione&#39;s public 
domain</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 
 160</span>&#160;<span class="comment">// algorithm for quoting command line 
arguments on Windows for `CreateProcess`.</span></div><div class="line"><a 
name="l00161"></a><span class="lineno">  161</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00162"></a><span 
class="lineno">  162</span>&#160;<span class="comment">// 
https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/</sp
 an></div><div class="line"><a name="l00163"></a><span class="lineno">  
163</span>&#160;<span class="comment">// 
NOLINT(whitespace/line_length)</span></div><div class="line"><a 
name="l00164"></a><span class="lineno"><a class="line" 
href="namespaceinternal_1_1windows.html#a80d683d0925b1bfbff4bea3a5aa2e9b9">  
164</a></span>&#160;<span class="keyword">inline</span> std::wstring <a 
class="code" 
href="namespaceinternal_1_1windows.html#a80d683d0925b1bfbff4bea3a5aa2e9b9">stringify_args</a>(<span
 class="keyword">const</span> std::vector&lt;std::string&gt;&amp; 
argv)</div><div class="line"><a name="l00165"></a><span class="lineno">  
165</span>&#160;{</div><div class="line"><a name="l00166"></a><span 
class="lineno">  166</span>&#160;  std::wstring command;</div><div 
class="line"><a name="l00167"></a><span class="lineno">  167</span>&#160;  
<span class="keywordflow">for</span> (<span class="keyword">auto</span> argit = 
argv.cbegin(); argit != argv.cend(); ++argit) {</div><div class="line"><a na
 me="l00168"></a><span class="lineno">  168</span>&#160;    std::wstring arg = 
wide_stringify(*argit);</div><div class="line"><a name="l00169"></a><span 
class="lineno">  169</span>&#160;    <span class="comment">// Don&#39;t quote 
empty arguments or those without troublesome characters.</span></div><div 
class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;    
<span class="keywordflow">if</span> (!arg.empty() &amp;&amp; 
arg.find_first_of(L<span class="stringliteral">&quot; 
\t\n\v\&quot;&quot;</span>) == arg.npos) {</div><div class="line"><a 
name="l00171"></a><span class="lineno">  171</span>&#160;      
command.append(arg);</div><div class="line"><a name="l00172"></a><span 
class="lineno">  172</span>&#160;    } <span class="keywordflow">else</span> 
{</div><div class="line"><a name="l00173"></a><span class="lineno">  
173</span>&#160;      <span class="comment">// Beginning double quotation 
mark.</span></div><div class="line"><a name="l00174"></a><span class="lineno">
   174</span>&#160;      command.push_back(L<span 
class="charliteral">&#39;&quot;&#39;</span>);</div><div class="line"><a 
name="l00175"></a><span class="lineno">  175</span>&#160;      <span 
class="keywordflow">for</span> (<span class="keyword">auto</span> it = 
arg.cbegin(); it != arg.cend(); ++it) {</div><div class="line"><a 
name="l00176"></a><span class="lineno">  176</span>&#160;        <span 
class="comment">// Count existent backslashes in argument.</span></div><div 
class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;       
 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> 
backslashes = 0;</div><div class="line"><a name="l00178"></a><span 
class="lineno">  178</span>&#160;        <span class="keywordflow">while</span> 
(it != arg.cend() &amp;&amp; *it == L<span 
class="charliteral">&#39;\\&#39;</span>) {</div><div class="line"><a 
name="l00179"></a><span class="lineno">  179</span>&#160;          
++it;</div><div class="line"><a name=
 "l00180"></a><span class="lineno">  180</span>&#160;          
++backslashes;</div><div class="line"><a name="l00181"></a><span 
class="lineno">  181</span>&#160;        }</div><div class="line"><a 
name="l00182"></a><span class="lineno">  182</span>&#160;</div><div 
class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;       
 <span class="keywordflow">if</span> (it == arg.cend()) {</div><div 
class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;       
   <span class="comment">// Escape all backslashes, but let the terminating 
double quotation</span></div><div class="line"><a name="l00185"></a><span 
class="lineno">  185</span>&#160;          <span class="comment">// mark we add 
below be interpreted as a metacharacter.</span></div><div class="line"><a 
name="l00186"></a><span class="lineno">  186</span>&#160;          
command.append(backslashes * 2, L<span 
class="charliteral">&#39;\\&#39;</span>);</div><div class="line"><a 
name="l00187"></a><span cla
 ss="lineno">  187</span>&#160;          <span 
class="keywordflow">break</span>;</div><div class="line"><a 
name="l00188"></a><span class="lineno">  188</span>&#160;        } <span 
class="keywordflow">else</span> <span class="keywordflow">if</span> (*it == 
L<span class="charliteral">&#39;&quot;&#39;</span>) {</div><div class="line"><a 
name="l00189"></a><span class="lineno">  189</span>&#160;          <span 
class="comment">// Escape all backslashes and the following double quotation 
mark.</span></div><div class="line"><a name="l00190"></a><span class="lineno">  
190</span>&#160;          command.append(backslashes * 2 + 1, L<span 
class="charliteral">&#39;\\&#39;</span>);</div><div class="line"><a 
name="l00191"></a><span class="lineno">  191</span>&#160;          
command.push_back(*it);</div><div class="line"><a name="l00192"></a><span 
class="lineno">  192</span>&#160;        } <span 
class="keywordflow">else</span> {</div><div class="line"><a 
name="l00193"></a><span class="lineno">  193<
 /span>&#160;          <span class="comment">// Backslashes aren&#39;t special 
here.</span></div><div class="line"><a name="l00194"></a><span class="lineno">  
194</span>&#160;          command.append(backslashes, L<span 
class="charliteral">&#39;\\&#39;</span>);</div><div class="line"><a 
name="l00195"></a><span class="lineno">  195</span>&#160;          
command.push_back(*it);</div><div class="line"><a name="l00196"></a><span 
class="lineno">  196</span>&#160;        }</div><div class="line"><a 
name="l00197"></a><span class="lineno">  197</span>&#160;      }</div><div 
class="line"><a name="l00198"></a><span class="lineno">  
198</span>&#160;</div><div class="line"><a name="l00199"></a><span 
class="lineno">  199</span>&#160;      <span class="comment">// Terminating 
double quotation mark.</span></div><div class="line"><a name="l00200"></a><span 
class="lineno">  200</span>&#160;      command.push_back(L<span 
class="charliteral">&#39;&quot;&#39;</span>);</div><div class="line"><a 
name="l00
 201"></a><span class="lineno">  201</span>&#160;    }</div><div 
class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;    
<span class="comment">// Space separate arguments (but don&#39;t append at 
end).</span></div><div class="line"><a name="l00203"></a><span class="lineno">  
203</span>&#160;    <span class="keywordflow">if</span> (argit != argv.cend() - 
1) {</div><div class="line"><a name="l00204"></a><span class="lineno">  
204</span>&#160;      command.push_back(L<span class="charliteral">&#39; 
&#39;</span>);</div><div class="line"><a name="l00205"></a><span 
class="lineno">  205</span>&#160;    }</div><div class="line"><a 
name="l00206"></a><span class="lineno">  206</span>&#160;  }</div><div 
class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;  
<span class="comment">// Append final null terminating 
character.</span></div><div class="line"><a name="l00208"></a><span 
class="lineno">  208</span>&#160;  command.push_back(L<span class="charlitera
 l">&#39;\0&#39;</span>);</div><div class="line"><a name="l00209"></a><span 
class="lineno">  209</span>&#160;  <span class="keywordflow">return</span> 
command;</div><div class="line"><a name="l00210"></a><span class="lineno">  
210</span>&#160;}</div><div class="line"><a name="l00211"></a><span 
class="lineno">  211</span>&#160;</div><div class="line"><a 
name="l00212"></a><span class="lineno">  212</span>&#160;</div><div 
class="line"><a name="l00213"></a><span class="lineno"><a class="line" 
href="structinternal_1_1windows_1_1ProcessData.html">  
213</a></span>&#160;<span class="keyword">struct </span><a class="code" 
href="structinternal_1_1windows_1_1ProcessData.html">ProcessData</a> 
{</div><div class="line"><a name="l00214"></a><span class="lineno"><a 
class="line" 
href="structinternal_1_1windows_1_1ProcessData.html#a96c76121644bd430e9ca67cf57636c0d">
  214</a></span>&#160;  <a class="code" 
href="classSharedHandle.html">SharedHandle</a> <a class="code" 
href="structinternal_1_1windows_1_1
 
ProcessData.html#a96c76121644bd430e9ca67cf57636c0d">process_handle</a>;</div><div
 class="line"><a name="l00215"></a><span class="lineno"><a class="line" 
href="structinternal_1_1windows_1_1ProcessData.html#a7160cf48fc6e70d9390233b246b93bee">
  215</a></span>&#160;  <a class="code" 
href="classSharedHandle.html">SharedHandle</a> <a class="code" 
href="structinternal_1_1windows_1_1ProcessData.html#a7160cf48fc6e70d9390233b246b93bee">thread_handle</a>;</div><div
 class="line"><a name="l00216"></a><span class="lineno"><a class="line" 
href="structinternal_1_1windows_1_1ProcessData.html#a65a4a4aba5450087363bfffdb30eea25">
  216</a></span>&#160;  <a class="code" 
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>
 <a class="code" 
href="structinternal_1_1windows_1_1ProcessData.html#a65a4a4aba5450087363bfffdb30eea25">pid</a>;</div><div
 class="line"><a name="l00217"></a><span class="lineno">  
217</span>&#160;};</div><div class="line"><a name="l00218">
 </a><span class="lineno">  218</span>&#160;</div><div class="line"><a 
name="l00219"></a><span class="lineno">  219</span>&#160;</div><div 
class="line"><a name="l00220"></a><span class="lineno">  220</span>&#160;<span 
class="comment">// Provides an interface for creating a child process on 
Windows.</span></div><div class="line"><a name="l00221"></a><span 
class="lineno">  221</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00222"></a><span class="lineno">  222</span>&#160;<span 
class="comment">// The `command` argument is given for compatibility, and is 
ignored. This is</span></div><div class="line"><a name="l00223"></a><span 
class="lineno">  223</span>&#160;<span class="comment">// because the 
`CreateProcess` will use `argv[0]` as the command to be 
executed,</span></div><div class="line"><a name="l00224"></a><span 
class="lineno">  224</span>&#160;<span class="comment">// and will perform a 
`PATH` lookup. If `command` were to be used instead,</span></div><
 div class="line"><a name="l00225"></a><span class="lineno">  
225</span>&#160;<span class="comment">// `CreateProcess` would require an 
absolute path.</span></div><div class="line"><a name="l00226"></a><span 
class="lineno">  226</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00227"></a><span class="lineno">  227</span>&#160;<span 
class="comment">// If `create_suspended` is `true`, the process will not be 
started, and the</span></div><div class="line"><a name="l00228"></a><span 
class="lineno">  228</span>&#160;<span class="comment">// caller must use 
`ResumeThread` to start the process.</span></div><div class="line"><a 
name="l00229"></a><span class="lineno">  229</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00230"></a><span 
class="lineno">  230</span>&#160;<span class="comment">// The caller can 
specify explicit `stdin`, `stdout`, and `stderr` handles,</span></div><div 
class="line"><a name="l00231"></a><span class="lineno">
   231</span>&#160;<span class="comment">// in that order, for the process via 
the `pipes` argument.</span></div><div class="line"><a name="l00232"></a><span 
class="lineno">  232</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00233"></a><span class="lineno">  233</span>&#160;<span 
class="comment">// NOTE: If `pipes` are specified, they will be temporarily set 
to</span></div><div class="line"><a name="l00234"></a><span class="lineno">  
234</span>&#160;<span class="comment">// inheritable, and then set to 
uninheritable. This is a side effect</span></div><div class="line"><a 
name="l00235"></a><span class="lineno">  235</span>&#160;<span 
class="comment">// on each `HANDLE`.</span></div><div class="line"><a 
name="l00236"></a><span class="lineno">  236</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00237"></a><span 
class="lineno">  237</span>&#160;<span class="comment">// The return value is a 
`ProcessData` struct, with the proces
 s and thread</span></div><div class="line"><a name="l00238"></a><span 
class="lineno">  238</span>&#160;<span class="comment">// handles each saved in 
a `SharedHandle`, ensuring they are closed when struct</span></div><div 
class="line"><a name="l00239"></a><span class="lineno">  239</span>&#160;<span 
class="comment">// goes out of scope.</span></div><div class="line"><a 
name="l00240"></a><span class="lineno"><a class="line" 
href="namespaceinternal_1_1windows.html#aaaa193083fd4f24a2e92e57ee8a8319f">  
240</a></span>&#160;<span class="keyword">inline</span> <a class="code" 
href="classTry.html">Try&lt;ProcessData&gt;</a> <a class="code" 
href="namespaceinternal_1_1windows.html#aaaa193083fd4f24a2e92e57ee8a8319f">create_process</a>(</div><div
 class="line"><a name="l00241"></a><span class="lineno">  241</span>&#160;    
<span class="keyword">const</span> std::string&amp; command,</div><div 
class="line"><a name="l00242"></a><span class="lineno">  242</span>&#160;    
<span class="keyword">const
 </span> std::vector&lt;std::string&gt;&amp; argv,</div><div class="line"><a 
name="l00243"></a><span class="lineno">  243</span>&#160;    <span 
class="keyword">const</span> <a class="code" 
href="classOption.html">Option</a>&lt;std::map&lt;std::string, 
std::string&gt;&gt;&amp; <a class="code" 
href="namespacemesos_1_1internal_1_1tests.html#a1396c5e3b0a179220de2792d74770ec2">environment</a>,</div><div
 class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;    
<span class="keyword">const</span> <span class="keywordtype">bool</span> 
create_suspended = <span class="keyword">false</span>,</div><div 
class="line"><a name="l00245"></a><span class="lineno">  245</span>&#160;    
<span class="keyword">const</span> <a class="code" 
href="classOption.html">Option</a>&lt;std::array&lt;int_fd, 3&gt;&gt;&amp; 
pipes = <a class="code" href="structNone.html">None</a>())</div><div 
class="line"><a name="l00246"></a><span class="lineno">  
246</span>&#160;{</div><div class="line"><a name="l0
 0247"></a><span class="lineno">  247</span>&#160;  <span class="comment">// 
TODO(andschwa): Assert that `command` and `argv[0]` are the 
same.</span></div><div class="line"><a name="l00248"></a><span class="lineno">  
248</span>&#160;  <span class="keyword">const</span> std::wstring arg_string = 
<a class="code" 
href="namespaceinternal_1_1windows.html#a80d683d0925b1bfbff4bea3a5aa2e9b9">stringify_args</a>(argv);</div><div
 class="line"><a name="l00249"></a><span class="lineno">  249</span>&#160;  
std::vector&lt;wchar_t&gt; arg_buffer(arg_string.begin(), 
arg_string.end());</div><div class="line"><a name="l00250"></a><span 
class="lineno">  250</span>&#160;  arg_buffer.push_back(L<span 
class="charliteral">&#39;\0&#39;</span>);</div><div class="line"><a 
name="l00251"></a><span class="lineno">  251</span>&#160;</div><div 
class="line"><a name="l00252"></a><span class="lineno">  252</span>&#160;  
<span class="comment">// Create the process with a Unicode 
environment.</span></div><div class="lin
 e"><a name="l00253"></a><span class="lineno">  253</span>&#160;  DWORD 
creation_flags = CREATE_UNICODE_ENVIRONMENT;</div><div class="line"><a 
name="l00254"></a><span class="lineno">  254</span>&#160;  <span 
class="keywordflow">if</span> (create_suspended) {</div><div class="line"><a 
name="l00255"></a><span class="lineno">  255</span>&#160;    creation_flags |= 
CREATE_SUSPENDED;</div><div class="line"><a name="l00256"></a><span 
class="lineno">  256</span>&#160;  }</div><div class="line"><a 
name="l00257"></a><span class="lineno">  257</span>&#160;</div><div 
class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;  
<span class="comment">// Construct the environment that will be passed to 
`::CreateProcessW`.</span></div><div class="line"><a name="l00259"></a><span 
class="lineno">  259</span>&#160;  <span class="keyword">const</span> <a 
class="code" href="classOption.html">Option&lt;std::wstring&gt;</a> env_string 
= <a class="code" href="namespaceinternal_1_1windows.html
 #a7b6974b9ba88dd5d9658c40268147581">create_process_env</a>(<a class="code" 
href="namespacemesos_1_1internal_1_1tests.html#a1396c5e3b0a179220de2792d74770ec2">environment</a>);</div><div
 class="line"><a name="l00260"></a><span class="lineno">  260</span>&#160;  
std::vector&lt;wchar_t&gt; env_buffer;</div><div class="line"><a 
name="l00261"></a><span class="lineno">  261</span>&#160;  <span 
class="keywordflow">if</span> (env_string.<a class="code" 
href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>()) 
{</div><div class="line"><a name="l00262"></a><span class="lineno">  
262</span>&#160;    <span class="comment">// This string contains the necessary 
null characters.</span></div><div class="line"><a name="l00263"></a><span 
class="lineno">  263</span>&#160;    env_buffer.assign(env_string.<a 
class="code" 
href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>().begin(), 
env_string.<a class="code" 
href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>().
 end());</div><div class="line"><a name="l00264"></a><span class="lineno">  
264</span>&#160;  }</div><div class="line"><a name="l00265"></a><span 
class="lineno">  265</span>&#160;</div><div class="line"><a 
name="l00266"></a><span class="lineno">  266</span>&#160;  <span 
class="keywordtype">wchar_t</span>* process_env = env_buffer.empty() ? <span 
class="keyword">nullptr</span> : env_buffer.data();</div><div class="line"><a 
name="l00267"></a><span class="lineno">  267</span>&#160;</div><div 
class="line"><a name="l00268"></a><span class="lineno">  268</span>&#160;  
PROCESS_INFORMATION process_info = {};</div><div class="line"><a 
name="l00269"></a><span class="lineno">  269</span>&#160;</div><div 
class="line"><a name="l00270"></a><span class="lineno">  270</span>&#160;  
STARTUPINFOW startup_info = {};</div><div class="line"><a 
name="l00271"></a><span class="lineno">  271</span>&#160;  startup_info.cb = 
<span class="keyword">sizeof</span>(STARTUPINFOW);</div><div class="line"><a 
name="l00
 272"></a><span class="lineno">  272</span>&#160;</div><div class="line"><a 
name="l00273"></a><span class="lineno">  273</span>&#160;  <span 
class="comment">// Hook up the stdin/out/err pipes and use the 
`STARTF_USESTDHANDLES`</span></div><div class="line"><a name="l00274"></a><span 
class="lineno">  274</span>&#160;  <span class="comment">// flag to instruct 
the child to use them [1].</span></div><div class="line"><a 
name="l00275"></a><span class="lineno">  275</span>&#160;  <span 
class="comment">// A more user-friendly example can be found in 
[2].</span></div><div class="line"><a name="l00276"></a><span class="lineno">  
276</span>&#160;  <span class="comment">//</span></div><div class="line"><a 
name="l00277"></a><span class="lineno">  277</span>&#160;  <span 
class="comment">// [1] 
https://msdn.microsoft.com/en-us/library/windows/desktop/ms686331(v=vs.85).aspx</span></div><div
 class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;  
<span class="comment">// [2] http
 
s://msdn.microsoft.com/en-us/library/windows/desktop/ms682499(v=vs.85).aspx</span></div><div
 class="line"><a name="l00279"></a><span class="lineno">  279</span>&#160;  
<span class="keywordflow">if</span> (pipes.isSome()) {</div><div 
class="line"><a name="l00280"></a><span class="lineno">  280</span>&#160;    
<span class="comment">// Each of these handles must be 
inheritable.</span></div><div class="line"><a name="l00281"></a><span 
class="lineno">  281</span>&#160;    <span class="keywordflow">foreach</span> 
(<span class="keyword">const</span> <a class="code" 
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&amp; fd, 
pipes.get()) {</div><div class="line"><a name="l00282"></a><span 
class="lineno">  282</span>&#160;      <span class="keyword">const</span> <a 
class="code" href="classTry.html">Try&lt;Nothing&gt;</a> inherit = <a 
class="code" 
href="namespaceinternal_1_1windows.html#a9dc48dc50b21cb8cee5237630460c4bd">set_inherit</a>(fd,
 <span class="keyword">true</span>
 );</div><div class="line"><a name="l00283"></a><span class="lineno">  
283</span>&#160;      <span class="keywordflow">if</span> (inherit.<a 
class="code" 
href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) 
{</div><div class="line"><a name="l00284"></a><span class="lineno">  
284</span>&#160;        <span class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(inherit.<a class="code" 
href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div 
class="line"><a name="l00285"></a><span class="lineno">  285</span>&#160;      
}</div><div class="line"><a name="l00286"></a><span class="lineno">  
286</span>&#160;    }</div><div class="line"><a name="l00287"></a><span 
class="lineno">  287</span>&#160;</div><div class="line"><a 
name="l00288"></a><span class="lineno">  288</span>&#160;    
startup_info.dwFlags |= STARTF_USESTDHANDLES;</div><div class="line"><a 
name="l00289"></a><span class="lineno">  289</span>&#160;    startup_info.hS
 tdInput = std::get&lt;0&gt;(pipes.get());</div><div class="line"><a 
name="l00290"></a><span class="lineno">  290</span>&#160;    
startup_info.hStdOutput = std::get&lt;1&gt;(pipes.get());</div><div 
class="line"><a name="l00291"></a><span class="lineno">  291</span>&#160;    
startup_info.hStdError = std::get&lt;2&gt;(pipes.get());</div><div 
class="line"><a name="l00292"></a><span class="lineno">  292</span>&#160;  
}</div><div class="line"><a name="l00293"></a><span class="lineno">  
293</span>&#160;</div><div class="line"><a name="l00294"></a><span 
class="lineno">  294</span>&#160;  <span class="keyword">const</span> BOOL 
result = ::CreateProcessW(</div><div class="line"><a name="l00295"></a><span 
class="lineno">  295</span>&#160;      <span class="comment">// This is 
replaced by the first token of `arg_buffer` string.</span></div><div 
class="line"><a name="l00296"></a><span class="lineno">  296</span>&#160;      
static_cast&lt;LPCWSTR&gt;(<span class="keyword">nullptr</span>),</div><d
 iv class="line"><a name="l00297"></a><span class="lineno">  297</span>&#160;   
   static_cast&lt;LPWSTR&gt;(arg_buffer.data()),</div><div class="line"><a 
name="l00298"></a><span class="lineno">  298</span>&#160;      
static_cast&lt;LPSECURITY_ATTRIBUTES&gt;(<span 
class="keyword">nullptr</span>),</div><div class="line"><a 
name="l00299"></a><span class="lineno">  299</span>&#160;      <span 
class="keyword">static_cast&lt;</span>LPSECURITY_ATTRIBUTES<span 
class="keyword">&gt;</span>(<span class="keyword">nullptr</span>),</div><div 
class="line"><a name="l00300"></a><span class="lineno">  300</span>&#160;      
TRUE, <span class="comment">// Inherit parent process handles (such as those in 
`pipes`).</span></div><div class="line"><a name="l00301"></a><span 
class="lineno">  301</span>&#160;      creation_flags,</div><div 
class="line"><a name="l00302"></a><span class="lineno">  302</span>&#160;      
static_cast&lt;LPVOID&gt;(process_env),</div><div class="line"><a 
name="l00303"></a><span cla
 ss="lineno">  303</span>&#160;      <span 
class="keyword">static_cast&lt;</span>LPCWSTR<span 
class="keyword">&gt;</span>(<span class="keyword">nullptr</span>), <span 
class="comment">// Inherit working directory.</span></div><div class="line"><a 
name="l00304"></a><span class="lineno">  304</span>&#160;      
&amp;startup_info,</div><div class="line"><a name="l00305"></a><span 
class="lineno">  305</span>&#160;      &amp;process_info);</div><div 
class="line"><a name="l00306"></a><span class="lineno">  
306</span>&#160;</div><div class="line"><a name="l00307"></a><span 
class="lineno">  307</span>&#160;  <span class="comment">// NOTE: The MSDN 
documentation for `CreateProcess` states that it</span></div><div 
class="line"><a name="l00308"></a><span class="lineno">  308</span>&#160;  
<span class="comment">// returns before the process has &quot;finished 
initialization,&quot; but is</span></div><div class="line"><a 
name="l00309"></a><span class="lineno">  309</span>&#160;  <span class="commen
 t">// not clear on precisely what initialization entails. It would 
seem</span></div><div class="line"><a name="l00310"></a><span class="lineno">  
310</span>&#160;  <span class="comment">// that this does not affect inherited 
handles, as it stands to</span></div><div class="line"><a 
name="l00311"></a><span class="lineno">  311</span>&#160;  <span 
class="comment">// reason that the system call to `CreateProcess` causes 
inheritable</span></div><div class="line"><a name="l00312"></a><span 
class="lineno">  312</span>&#160;  <span class="comment">// handles to become 
inherited, and not some &quot;initialization&quot; of the</span></div><div 
class="line"><a name="l00313"></a><span class="lineno">  313</span>&#160;  
<span class="comment">// child process. However, if an inheritance race 
condition</span></div><div class="line"><a name="l00314"></a><span 
class="lineno">  314</span>&#160;  <span class="comment">// manifests, this 
assumption should be re-evaluated.</span></div><div class="line"
 ><a name="l00315"></a><span class="lineno">  315</span>&#160;</div><div 
 >class="line"><a name="l00316"></a><span class="lineno">  316</span>&#160;  
 ><span class="keywordflow">if</span> (pipes.isSome()) {</div><div 
 >class="line"><a name="l00317"></a><span class="lineno">  317</span>&#160;    
 ><span class="comment">// These handles should no longer be inheritable. This 
 >prevents other child</span></div><div class="line"><a name="l00318"></a><span 
 >class="lineno">  318</span>&#160;    <span class="comment">// processes from 
 >accidentally inheriting the wrong handles.</span></div><div class="line"><a 
 >name="l00319"></a><span class="lineno">  319</span>&#160;    <span 
 >class="comment">//</span></div><div class="line"><a name="l00320"></a><span 
 >class="lineno">  320</span>&#160;    <span class="comment">// NOTE: This is 
 >explicit, and does not take into account the</span></div><div class="line"><a 
 >name="l00321"></a><span class="lineno">  321</span>&#160;    <span 
 >class="comment">// previous inherita
 nce semantics of each `HANDLE`. It is assumed</span></div><div class="line"><a 
name="l00322"></a><span class="lineno">  322</span>&#160;    <span 
class="comment">// that users of this function send non-inheritable 
handles.</span></div><div class="line"><a name="l00323"></a><span 
class="lineno">  323</span>&#160;    <span class="keywordflow">foreach</span> 
(<span class="keyword">const</span> <a class="code" 
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&amp; fd, 
pipes.get()) {</div><div class="line"><a name="l00324"></a><span 
class="lineno">  324</span>&#160;      <span class="keyword">const</span> <a 
class="code" href="classTry.html">Try&lt;Nothing&gt;</a> inherit = <a 
class="code" 
href="namespaceinternal_1_1windows.html#a9dc48dc50b21cb8cee5237630460c4bd">set_inherit</a>(fd,
 <span class="keyword">false</span>);</div><div class="line"><a 
name="l00325"></a><span class="lineno">  325</span>&#160;      <span 
class="keywordflow">if</span> (inherit.<a class="code" h
 ref="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) 
{</div><div class="line"><a name="l00326"></a><span class="lineno">  
326</span>&#160;        <span class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(inherit.<a class="code" 
href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div 
class="line"><a name="l00327"></a><span class="lineno">  327</span>&#160;      
}</div><div class="line"><a name="l00328"></a><span class="lineno">  
328</span>&#160;    }</div><div class="line"><a name="l00329"></a><span 
class="lineno">  329</span>&#160;  }</div><div class="line"><a 
name="l00330"></a><span class="lineno">  330</span>&#160;</div><div 
class="line"><a name="l00331"></a><span class="lineno">  331</span>&#160;  
<span class="keywordflow">if</span> (result == FALSE) {</div><div 
class="line"><a name="l00332"></a><span class="lineno">  332</span>&#160;    
<span class="keywordflow">return</span> <a class="code" href="classWindows
 Error.html">WindowsError</a>(</div><div class="line"><a 
name="l00333"></a><span class="lineno">  333</span>&#160;        <span 
class="stringliteral">&quot;Failed to call `CreateProcess`: &quot;</span> + <a 
class="code" 
href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(arg_string));</div><div
 class="line"><a name="l00334"></a><span class="lineno">  334</span>&#160;  
}</div><div class="line"><a name="l00335"></a><span class="lineno">  
335</span>&#160;</div><div class="line"><a name="l00336"></a><span 
class="lineno">  336</span>&#160;  <span class="keywordflow">return</span> <a 
class="code" 
href="structinternal_1_1windows_1_1ProcessData.html">ProcessData</a>{<a 
class="code" 
href="classSharedHandle.html">SharedHandle</a>{process_info.hProcess, 
::CloseHandle},</div><div class="line"><a name="l00337"></a><span 
class="lineno">  337</span>&#160;                     <a class="code" 
href="classSharedHandle.html">SharedHandle</a>{process_info.hThread, 
::CloseHandle},</div
 ><div class="line"><a name="l00338"></a><span class="lineno">  
 >338</span>&#160;                     <span 
 >class="keyword">static_cast&lt;</span><a class="code" 
 >href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a><span
 > class="keyword">&gt;</span>(process_info.dwProcessId)};</div><div 
 >class="line"><a name="l00339"></a><span class="lineno">  
 >339</span>&#160;}</div><div class="line"><a name="l00340"></a><span 
 >class="lineno">  340</span>&#160;</div><div class="line"><a 
 >name="l00341"></a><span class="lineno">  341</span>&#160;} <span 
 >class="comment">// namespace windows {</span></div><div class="line"><a 
 >name="l00342"></a><span class="lineno">  342</span>&#160;} <span 
 >class="comment">// namespace internal {</span></div><div class="line"><a 
 >name="l00343"></a><span class="lineno">  343</span>&#160;</div><div 
 >class="line"><a name="l00344"></a><span class="lineno">  
 >344</span>&#160;<span class="keyword">namespace </span><a class="code" 
 >href="na
 mespaceos.html">os</a> {</div><div class="line"><a name="l00345"></a><span 
class="lineno">  345</span>&#160;<span class="keyword">namespace </span>Shell 
{</div><div class="line"><a name="l00346"></a><span class="lineno">  
346</span>&#160;</div><div class="line"><a name="l00347"></a><span 
class="lineno">  347</span>&#160;<span class="comment">// Canonical constants 
used as platform-dependent args to `exec` calls.</span></div><div 
class="line"><a name="l00348"></a><span class="lineno">  348</span>&#160;<span 
class="comment">// `name` is the command name, `arg0` is the first argument 
received</span></div><div class="line"><a name="l00349"></a><span 
class="lineno">  349</span>&#160;<span class="comment">// by the callee, 
usually the command name and `arg1` is the second</span></div><div 
class="line"><a name="l00350"></a><span class="lineno">  350</span>&#160;<span 
class="comment">// command argument received by the callee.</span></div><div 
class="line"><a name="l00351"></a><span class="
 lineno">  351</span>&#160;constexpr <span class="keyword">const</span> <span 
class="keywordtype">char</span>* <a class="code" 
href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">name</a> = 
<span class="stringliteral">&quot;cmd.exe&quot;</span>;</div><div 
class="line"><a name="l00352"></a><span class="lineno">  
352</span>&#160;constexpr <span class="keyword">const</span> <span 
class="keywordtype">char</span>* <a class="code" 
href="namespaceos_1_1Shell.html#adeacb41dacfa03ad5ceebd9a53582997">arg0</a> = 
<span class="stringliteral">&quot;cmd.exe&quot;</span>;</div><div 
class="line"><a name="l00353"></a><span class="lineno">  
353</span>&#160;constexpr <span class="keyword">const</span> <span 
class="keywordtype">char</span>* <a class="code" 
href="namespaceos_1_1Shell.html#a44f50f66f2a231de974b53c9f4384ba5">arg1</a> = 
<span class="stringliteral">&quot;/c&quot;</span>;</div><div class="line"><a 
name="l00354"></a><span class="lineno">  354</span>&#160;</div><div 
class="line"><
 a name="l00355"></a><span class="lineno">  355</span>&#160;} <span 
class="comment">// namespace Shell {</span></div><div class="line"><a 
name="l00356"></a><span class="lineno">  356</span>&#160;</div><div 
class="line"><a name="l00357"></a><span class="lineno">  357</span>&#160;<span 
class="comment">// Runs a shell command (with `cmd.exe`) with optional 
arguments.</span></div><div class="line"><a name="l00358"></a><span 
class="lineno">  358</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00359"></a><span class="lineno">  359</span>&#160;<span 
class="comment">// This assumes that a successful execution will result in the 
exit</span></div><div class="line"><a name="l00360"></a><span class="lineno">  
360</span>&#160;<span class="comment">// code for the command to be `0`; in 
this case, the contents of the</span></div><div class="line"><a 
name="l00361"></a><span class="lineno">  361</span>&#160;<span 
class="comment">// `Try` will be the contents of `stdout`.<
 /span></div><div class="line"><a name="l00362"></a><span class="lineno">  
362</span>&#160;<span class="comment">//</span></div><div class="line"><a 
name="l00363"></a><span class="lineno">  363</span>&#160;<span 
class="comment">// If the exit code is non-zero, we will return an appropriate 
error</span></div><div class="line"><a name="l00364"></a><span class="lineno">  
364</span>&#160;<span class="comment">// message; but *not* 
`stderr`.</span></div><div class="line"><a name="l00365"></a><span 
class="lineno">  365</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00366"></a><span class="lineno">  366</span>&#160;<span 
class="comment">// If the caller needs to examine the contents of `stderr` it 
should</span></div><div class="line"><a name="l00367"></a><span class="lineno"> 
 367</span>&#160;<span class="comment">// be redirected to `stdout` (using, 
e.g., `2&gt;&amp;1 || exit /b 0` in the</span></div><div class="line"><a 
name="l00368"></a><span class="lineno">
   368</span>&#160;<span class="comment">// command string). The `|| exit /b 0` 
is required to obtain a success</span></div><div class="line"><a 
name="l00369"></a><span class="lineno">  369</span>&#160;<span 
class="comment">// exit code in case of errors, and still obtain `stderr`, as 
piped to</span></div><div class="line"><a name="l00370"></a><span 
class="lineno">  370</span>&#160;<span class="comment">// 
`stdout`.</span></div><div class="line"><a name="l00371"></a><span 
class="lineno">  371</span>&#160;<span class="keyword">template</span> 
&lt;<span class="keyword">typename</span>... T&gt;</div><div class="line"><a 
name="l00372"></a><span class="lineno">  372</span>&#160;<a class="code" 
href="classTry.html">Try&lt;std::string&gt;</a> <a class="code" 
href="namespaceos.html#a0d86320d7799ea761599bc356c02a4fa">shell</a>(<span 
class="keyword">const</span> std::string&amp; fmt, <span 
class="keyword">const</span> T&amp;... t)</div><div class="line"><a 
name="l00373"></a><span class="lineno
 ">  373</span>&#160;{</div><div class="line"><a name="l00374"></a><span 
class="lineno">  374</span>&#160;  <span class="keyword">using</span> 
std::array;</div><div class="line"><a name="l00375"></a><span class="lineno">  
375</span>&#160;  <span class="keyword">using</span> std::string;</div><div 
class="line"><a name="l00376"></a><span class="lineno">  376</span>&#160;  
<span class="keyword">using</span> std::vector;</div><div class="line"><a 
name="l00377"></a><span class="lineno">  377</span>&#160;</div><div 
class="line"><a name="l00378"></a><span class="lineno">  378</span>&#160;  
<span class="keyword">const</span> <a class="code" 
href="classTry.html">Try&lt;string&gt;</a> command = <a class="code" 
href="namespacestrings_1_1internal.html#a870e2db270d980f83de20525ec414d2a">strings::internal::format</a>(fmt,
 t...);</div><div class="line"><a name="l00379"></a><span class="lineno">  
379</span>&#160;  <span class="keywordflow">if</span> (command.<a class="code" 
href="classTry.html#a0b98
 f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a 
name="l00380"></a><span class="lineno">  380</span>&#160;    <span 
class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(command.<a class="code" 
href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div 
class="line"><a name="l00381"></a><span class="lineno">  381</span>&#160;  
}</div><div class="line"><a name="l00382"></a><span class="lineno">  
382</span>&#160;</div><div class="line"><a name="l00383"></a><span 
class="lineno">  383</span>&#160;  <span class="comment">// This function is 
intended to pass the arguments to the default</span></div><div class="line"><a 
name="l00384"></a><span class="lineno">  384</span>&#160;  <span 
class="comment">// shell, so we first add the arguments `cmd.exe cmd.exe 
/c`,</span></div><div class="line"><a name="l00385"></a><span class="lineno">  
385</span>&#160;  <span class="comment">// followed by the command and 
arguments given.
 </span></div><div class="line"><a name="l00386"></a><span class="lineno">  
386</span>&#160;  vector&lt;string&gt; args = {<a class="code" 
href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">os::Shell::name</a>,
 <a class="code" 
href="namespaceos_1_1Shell.html#adeacb41dacfa03ad5ceebd9a53582997">os::Shell::arg0</a>,
 <a class="code" 
href="namespaceos_1_1Shell.html#a44f50f66f2a231de974b53c9f4384ba5">os::Shell::arg1</a>};</div><div
 class="line"><a name="l00387"></a><span class="lineno">  
387</span>&#160;</div><div class="line"><a name="l00388"></a><span 
class="lineno">  388</span>&#160;  { <span class="comment">// Minimize the 
lifetime of the system allocated buffer.</span></div><div class="line"><a 
name="l00389"></a><span class="lineno">  389</span>&#160;    <span 
class="comment">//</span></div><div class="line"><a name="l00390"></a><span 
class="lineno">  390</span>&#160;    <span class="comment">// NOTE: This API 
returns a pointer to an array of `wchar_t*`,</span></div><d
 iv class="line"><a name="l00391"></a><span class="lineno">  391</span>&#160;   
 <span class="comment">// similar to `argv`. Each pointer to a null-terminated 
Unicode</span></div><div class="line"><a name="l00392"></a><span 
class="lineno">  392</span>&#160;    <span class="comment">// string represents 
an individual argument found on the command</span></div><div class="line"><a 
name="l00393"></a><span class="lineno">  393</span>&#160;    <span 
class="comment">// line. We use this because we cannot just split on 
whitespace.</span></div><div class="line"><a name="l00394"></a><span 
class="lineno">  394</span>&#160;    <span class="keywordtype">int</span> 
argc;</div><div class="line"><a name="l00395"></a><span class="lineno">  
395</span>&#160;    <span class="keyword">const</span> 
std::unique_ptr&lt;wchar_t*, decltype(&amp;::LocalFree)&gt; argv(</div><div 
class="line"><a name="l00396"></a><span class="lineno">  396</span>&#160;      
::CommandLineToArgvW(wide_stringify(command.<a class="c
 ode" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()).data(), 
&amp;argc),</div><div class="line"><a name="l00397"></a><span class="lineno">  
397</span>&#160;      &amp;::LocalFree);</div><div class="line"><a 
name="l00398"></a><span class="lineno">  398</span>&#160;    <span 
class="keywordflow">if</span> (argv == <span class="keyword">nullptr</span>) 
{</div><div class="line"><a name="l00399"></a><span class="lineno">  
399</span>&#160;      <span class="keywordflow">return</span> <a class="code" 
href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a 
name="l00400"></a><span class="lineno">  400</span>&#160;    }</div><div 
class="line"><a name="l00401"></a><span class="lineno">  
401</span>&#160;</div><div class="line"><a name="l00402"></a><span 
class="lineno">  402</span>&#160;    <span class="keywordflow">for</span> 
(<span class="keywordtype">int</span> i = 0; i &lt; argc; ++i) {</div><div 
class="line"><a name="l00403"></a><span class="lineno">  40
 3</span>&#160;      args.push_back(<a class="code" 
href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(std::wstring(argv.get()[i])));</div><div
 class="line"><a name="l00404"></a><span class="lineno">  404</span>&#160;    
}</div><div class="line"><a name="l00405"></a><span class="lineno">  
405</span>&#160;  }</div><div class="line"><a name="l00406"></a><span 
class="lineno">  406</span>&#160;</div><div class="line"><a 
name="l00407"></a><span class="lineno">  407</span>&#160;  <span 
class="comment">// This function is intended to return only the `stdout` of 
the</span></div><div class="line"><a name="l00408"></a><span class="lineno">  
408</span>&#160;  <span class="comment">// command; but since we have to 
redirect all of `stdin`, `stdout`,</span></div><div class="line"><a 
name="l00409"></a><span class="lineno">  409</span>&#160;  <span 
class="comment">// `stderr` if we want to redirect any one of them, we 
redirect</span></div><div class="line"><a name="l00410"></a><
 span class="lineno">  410</span>&#160;  <span class="comment">// `stdin` and 
`stderr` to `NUL`, and `stdout` to a pipe.</span></div><div class="line"><a 
name="l00411"></a><span class="lineno">  411</span>&#160;  <a class="code" 
href="classTry.html">Try&lt;int_fd&gt;</a> stdin_ = <a class="code" 
href="namespaceos.html#aaf5d5468adc1b85cf9bb7126e70807ca">os::open</a>(<a 
class="code" 
href="namespaceos.html#a8d90278daa51c4fe9fcb9e54757187b5">os::DEV_NULL</a>, 
O_RDONLY);</div><div class="line"><a name="l00412"></a><span class="lineno">  
412</span>&#160;  <span class="keywordflow">if</span> (stdin_.<a class="code" 
href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) 
{</div><div class="line"><a name="l00413"></a><span class="lineno">  
413</span>&#160;    <span class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(stdin_.<a class="code" 
href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div 
class="line"><a name="l00414"></
 a><span class="lineno">  414</span>&#160;  }</div><div class="line"><a 
name="l00415"></a><span class="lineno">  415</span>&#160;</div><div 
class="line"><a name="l00416"></a><span class="lineno">  416</span>&#160;  <a 
class="code" href="classTry.html">Try&lt;array&lt;int_fd, 2&gt;</a>&gt; stdout_ 
= <a class="code" 
href="namespaceos.html#afefbea8a88b84bed66580372accb18a9">os::pipe</a>();</div><div
 class="line"><a name="l00417"></a><span class="lineno">  417</span>&#160;  
<span class="keywordflow">if</span> (stdout_.isError()) {</div><div 
class="line"><a name="l00418"></a><span class="lineno">  418</span>&#160;    
<span class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(stdout_.error());</div><div class="line"><a 
name="l00419"></a><span class="lineno">  419</span>&#160;  }</div><div 
class="line"><a name="l00420"></a><span class="lineno">  
420</span>&#160;</div><div class="line"><a name="l00421"></a><span 
class="lineno">  421</span>&#160;  <a class="code"
  href="classTry.html">Try&lt;int_fd&gt;</a> stderr_ = <a class="code" 
href="namespaceos.html#aaf5d5468adc1b85cf9bb7126e70807ca">os::open</a>(<a 
class="code" 
href="namespaceos.html#a8d90278daa51c4fe9fcb9e54757187b5">os::DEV_NULL</a>, 
O_WRONLY);</div><div class="line"><a name="l00422"></a><span class="lineno">  
422</span>&#160;  <span class="keywordflow">if</span> (stderr_.isError()) 
{</div><div class="line"><a name="l00423"></a><span class="lineno">  
423</span>&#160;    <span class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(stderr_.error());</div><div class="line"><a 
name="l00424"></a><span class="lineno">  424</span>&#160;  }</div><div 
class="line"><a name="l00425"></a><span class="lineno">  
425</span>&#160;</div><div class="line"><a name="l00426"></a><span 
class="lineno">  426</span>&#160;  <span class="comment">// Ensure the file 
descriptors are closed when we leave this scope.</span></div><div 
class="line"><a name="l00427"></a><span class="lineno
 ">  427</span>&#160;  <span class="keyword">struct </span>Closer</div><div 
class="line"><a name="l00428"></a><span class="lineno">  428</span>&#160;  
{</div><div class="line"><a name="l00429"></a><span class="lineno">  
429</span>&#160;    vector&lt;int_fd&gt; fds;</div><div class="line"><a 
name="l00430"></a><span class="lineno">  430</span>&#160;    
~Closer()</div><div class="line"><a name="l00431"></a><span class="lineno">  
431</span>&#160;    {</div><div class="line"><a name="l00432"></a><span 
class="lineno">  432</span>&#160;      <span class="keywordflow">foreach</span> 
(<a class="code" 
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&amp; fd, 
fds) {</div><div class="line"><a name="l00433"></a><span class="lineno">  
433</span>&#160;        <a class="code" 
href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a>(fd);</div><div
 class="line"><a name="l00434"></a><span class="lineno">  434</span>&#160;      
}</div><div class="line"><a name="l00435
 "></a><span class="lineno">  435</span>&#160;    }</div><div class="line"><a 
name="l00436"></a><span class="lineno">  436</span>&#160;  } closer = 
{{stdin_.<a class="code" 
href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(), 
stdout_.get()[0], stderr_.get()}};</div><div class="line"><a 
name="l00437"></a><span class="lineno">  437</span>&#160;</div><div 
class="line"><a name="l00438"></a><span class="lineno">  438</span>&#160;  
array&lt;int_fd, 3&gt; pipes = {stdin_.<a class="code" 
href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(), 
stdout_.get()[1], stderr_.get()};</div><div class="line"><a 
name="l00439"></a><span class="lineno">  439</span>&#160;</div><div 
class="line"><a name="l00440"></a><span class="lineno">  440</span>&#160;  
<span class="keyword">using namespace </span>::<a class="code" 
href="namespaceinternal_1_1windows.html">internal::windows</a>;</div><div 
class="line"><a name="l00441"></a><span class="lineno">  
441</span>&#160;</div><div class="lin
 e"><a name="l00442"></a><span class="lineno">  442</span>&#160;  <a 
class="code" href="classTry.html">Try&lt;ProcessData&gt;</a> process_data 
=</div><div class="line"><a name="l00443"></a><span class="lineno">  
443</span>&#160;    <a class="code" 
href="namespaceinternal_1_1windows.html#aaaa193083fd4f24a2e92e57ee8a8319f">create_process</a>(args.front(),
 args, <a class="code" href="structNone.html">None</a>(), <span 
class="keyword">false</span>, pipes);</div><div class="line"><a 
name="l00444"></a><span class="lineno">  444</span>&#160;</div><div 
class="line"><a name="l00445"></a><span class="lineno">  445</span>&#160;  
<span class="keywordflow">if</span> (process_data.<a class="code" 
href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) 
{</div><div class="line"><a name="l00446"></a><span class="lineno">  
446</span>&#160;    <span class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(process_data.<a class="code" 
href="classTry.html#aec4a11dd
 d3c036e889d90b7eb6258ba7">error</a>());</div><div class="line"><a 
name="l00447"></a><span class="lineno">  447</span>&#160;  }</div><div 
class="line"><a name="l00448"></a><span class="lineno">  
448</span>&#160;</div><div class="line"><a name="l00449"></a><span 
class="lineno">  449</span>&#160;  <span class="comment">// Close the child end 
of the stdout pipe and then read until EOF.</span></div><div class="line"><a 
name="l00450"></a><span class="lineno">  450</span>&#160;  <a class="code" 
href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a>(stdout_.get()[1]);</div><div
 class="line"><a name="l00451"></a><span class="lineno">  451</span>&#160;  
<span class="keywordtype">string</span> out;</div><div class="line"><a 
name="l00452"></a><span class="lineno">  452</span>&#160;  <a class="code" 
href="classResult.html">Result&lt;string&gt;</a> part = <a class="code" 
href="structNone.html">None</a>();</div><div class="line"><a 
name="l00453"></a><span class="lineno">  453</spa
 n>&#160;  <span class="keywordflow">do</span> {</div><div class="line"><a 
name="l00454"></a><span class="lineno">  454</span>&#160;    part = <a 
class="code" 
href="namespaceos.html#aa1d97ff0a93229e1fe6b33e3e2d567f7">os::read</a>(stdout_.get()[0],
 1024);</div><div class="line"><a name="l00455"></a><span class="lineno">  
455</span>&#160;    <span class="keywordflow">if</span> (part.<a class="code" 
href="classResult.html#a85eaa52037223d71092e65701c166562">isSome</a>()) 
{</div><div class="line"><a name="l00456"></a><span class="lineno">  
456</span>&#160;      out += part.<a class="code" 
href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>();</div><div 
class="line"><a name="l00457"></a><span class="lineno">  457</span>&#160;    
}</div><div class="line"><a name="l00458"></a><span class="lineno">  
458</span>&#160;  } <span class="keywordflow">while</span> (part.<a 
class="code" 
href="classResult.html#a85eaa52037223d71092e65701c166562">isSome</a>());</div><div
 class="line"><a na
 me="l00459"></a><span class="lineno">  459</span>&#160;</div><div 
class="line"><a name="l00460"></a><span class="lineno">  460</span>&#160;  
<span class="comment">// Wait for the process synchronously.</span></div><div 
class="line"><a name="l00461"></a><span class="lineno">  461</span>&#160;  
::WaitForSingleObject(process_data-&gt;process_handle.get_handle(), 
INFINITE);</div><div class="line"><a name="l00462"></a><span class="lineno">  
462</span>&#160;</div><div class="line"><a name="l00463"></a><span 
class="lineno">  463</span>&#160;  DWORD <a class="code" 
href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>;</div><div
 class="line"><a name="l00464"></a><span class="lineno">  464</span>&#160;  
<span class="keywordflow">if</span> (!::GetExitCodeProcess(</div><div 
class="line"><a name="l00465"></a><span class="lineno">  465</span>&#160;       
 process_data-&gt;process_handle.get_handle(), &amp;<a class="code" 
href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4
 ">status</a>)) {</div><div class="line"><a name="l00466"></a><span 
class="lineno">  466</span>&#160;    <span class="keywordflow">return</span> <a 
class="code" href="classError.html">Error</a>(<span 
class="stringliteral">&quot;Failed to `GetExitCodeProcess`: &quot;</span> + 
command.<a class="code" 
href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div 
class="line"><a name="l00467"></a><span class="lineno">  467</span>&#160;  
}</div><div class="line"><a name="l00468"></a><span class="lineno">  
468</span>&#160;</div><div class="line"><a name="l00469"></a><span 
class="lineno">  469</span>&#160;  <span class="keywordflow">if</span> (status 
== 0) {</div><div class="line"><a name="l00470"></a><span class="lineno">  
470</span>&#160;    <span class="keywordflow">return</span> out;</div><div 
class="line"><a name="l00471"></a><span class="lineno">  471</span>&#160;  
}</div><div class="line"><a name="l00472"></a><span class="lineno">  
472</span>&#160;</div><div class="lin
 e"><a name="l00473"></a><span class="lineno">  473</span>&#160;  <span 
class="keywordflow">return</span> <a class="code" 
href="classError.html">Error</a>(</div><div class="line"><a 
name="l00474"></a><span class="lineno">  474</span>&#160;    <span 
class="stringliteral">&quot;Failed to execute &#39;&quot;</span> + command.<a 
class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>() 
+</div><div class="line"><a name="l00475"></a><span class="lineno">  
475</span>&#160;    <span class="stringliteral">&quot;&#39;; the command was 
either &quot;</span></div><div class="line"><a name="l00476"></a><span 
class="lineno">  476</span>&#160;    <span class="stringliteral">&quot;not 
found or exited with a non-zero exit status: &quot;</span> +</div><div 
class="line"><a name="l00477"></a><span class="lineno">  477</span>&#160;    <a 
class="code" 
href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(status));</div><div
 class="line"><a name="l00478"></a><span class
 ="lineno">  478</span>&#160;}</div><div class="line"><a 
name="l00479"></a><span class="lineno">  479</span>&#160;</div><div 
class="line"><a name="l00480"></a><span class="lineno">  
480</span>&#160;</div><div class="line"><a name="l00481"></a><span 
class="lineno">  481</span>&#160;<span class="keyword">template</span>&lt;<span 
class="keyword">typename</span>... T&gt;</div><div class="line"><a 
name="l00482"></a><span class="lineno">  482</span>&#160;<span 
class="keyword">inline</span> <span class="keywordtype">int</span> <a 
class="code" 
href="namespaceos.html#a4b727e301623549c37cdfcd8c553a2c7">execlp</a>(<span 
class="keyword">const</span> <span class="keywordtype">char</span>* <a 
class="code" 
href="namespacemesos_1_1uri.html#a0a3b30c1eb427c4053aaef120b1f453c">file</a>, 
T... t) = <span class="keyword">delete</span>;</div><div class="line"><a 
name="l00483"></a><span class="lineno">  483</span>&#160;</div><div 
class="line"><a name="l00484"></a><span class="lineno">  484</span>&#160;</div
 ><div class="line"><a name="l00485"></a><span class="lineno">  
 >485</span>&#160;<span class="comment">// Executes a command by calling 
 >&quot;&lt;command&gt; &lt;arguments...&gt;&quot;, and</span></div><div 
 >class="line"><a name="l00486"></a><span class="lineno">  
 >486</span>&#160;<span class="comment">// returns after the command has been 
 >completed. Returns the process exit</span></div><div class="line"><a 
 >name="l00487"></a><span class="lineno">  487</span>&#160;<span 
 >class="comment">// code on success and `None` on error.</span></div><div 
 >class="line"><a name="l00488"></a><span class="lineno"><a class="line" 
 >href="namespaceos.html#abedec07e6e468b54920d3b921a49eb36">  
 >488</a></span>&#160;<span class="keyword">inline</span> <a class="code" 
 >href="classOption.html">Option&lt;int&gt;</a> <a class="code" 
 >href="namespaceos.html#abedec07e6e468b54920d3b921a49eb36">spawn</a>(</div><div
 > class="line"><a name="l00489"></a><span class="lineno">  489</span>&#160;    
 ><span class="keyword">const</span
 > std::string&amp; command,</div><div class="line"><a name="l00490"></a><span 
 > class="lineno">  490</span>&#160;    <span class="keyword">const</span> 
 > std::vector&lt;std::string&gt;&amp; arguments,</div><div class="line"><a 
 > name="l00491"></a><span class="lineno">  491</span>&#160;    <span 
 > class="keyword">const</span> <a class="code" 
 > href="classOption.html">Option</a>&lt;std::map&lt;std::string, 
 > std::string&gt;&gt;&amp; <a class="code" 
 > href="namespacemesos_1_1internal_1_1tests.html#a1396c5e3b0a179220de2792d74770ec2">environment</a>
 >  = <a class="code" href="structNone.html">None</a>())</div><div 
 > class="line"><a name="l00492"></a><span class="lineno">  
 > 492</span>&#160;{</div><div class="line"><a name="l00493"></a><span 
 > class="lineno">  493</span>&#160;  <span class="keyword">using namespace 
 > </span>::<a class="code" 
 > href="namespaceinternal_1_1windows.html">internal::windows</a>;</div><div 
 > class="line"><a name="l00494"></a><span class="lineno">  
 > 494</span>&#160;</div><div class="line"><a 
 name="l00495"></a><span class="lineno">  495</span>&#160;  <a class="code" 
href="classTry.html">Try&lt;ProcessData&gt;</a> process_data =</div><div 
class="line"><a name="l00496"></a><span class="lineno">  496</span>&#160;    <a 
class="code" 
href="namespaceinternal_1_1windows.html#aaaa193083fd4f24a2e92e57ee8a8319f">create_process</a>(command,
 arguments, <a class="code" 
href="namespacemesos_1_1internal_1_1tests.html#a1396c5e3b0a179220de2792d74770ec2">environment</a>);</div><div
 class="line"><a name="l00497"></a><span class="lineno">  
497</span>&#160;</div><div class="line"><a name="l00498"></a><span 
class="lineno">  498</span>&#160;  <span class="keywordflow">if</span> 
(process_data.<a class="code" 
href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) 
{</div><div class="line"><a name="l00499"></a><span class="lineno">  
499</span>&#160;    LOG(WARNING) &lt;&lt; process_data.<a class="code" 
href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>();</div><div 
cla
 ss="line"><a name="l00500"></a><span class="lineno">  500</span>&#160;    
<span class="keywordflow">return</span> <a class="code" 
href="structNone.html">None</a>();</div><div class="line"><a 
name="l00501"></a><span class="lineno">  501</span>&#160;  }</div><div 
class="line"><a name="l00502"></a><span class="lineno">  
502</span>&#160;</div><div class="line"><a name="l00503"></a><span 
class="lineno">  503</span>&#160;  <span class="comment">// Wait for the 
process synchronously.</span></div><div class="line"><a name="l00504"></a><span 
class="lineno">  504</span>&#160;  
::WaitForSingleObject(process_data-&gt;process_handle.get_handle(), 
INFINITE);</div><div class="line"><a name="l00505"></a><span class="lineno">  
505</span>&#160;</div><div class="line"><a name="l00506"></a><span 
class="lineno">  506</span>&#160;  DWORD <a class="code" 
href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>;</div><div
 class="line"><a name="l00507"></a><span class="lineno">  507</span>&#16
 0;  <span class="keywordflow">if</span> (!::GetExitCodeProcess(</div><div 
class="line"><a name="l00508"></a><span class="lineno">  508</span>&#160;       
 process_data-&gt;process_handle.get_handle(), &amp;<a class="code" 
href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>)) 
{</div><div class="line"><a name="l00509"></a><span class="lineno">  
509</span>&#160;    LOG(WARNING) &lt;&lt; <span 
class="stringliteral">&quot;Failed to `GetExitCodeProcess`: &quot;</span> 
&lt;&lt; command;</div><div class="line"><a name="l00510"></a><span 
class="lineno">  510</span>&#160;    <span class="keywordflow">return</span> <a 
class="code" href="structNone.html">None</a>();</div><div class="line"><a 
name="l00511"></a><span class="lineno">  511</span>&#160;  }</div><div 
class="line"><a name="l00512"></a><span class="lineno">  
512</span>&#160;</div><div class="line"><a name="l00513"></a><span 
class="lineno">  513</span>&#160;  <span class="comment">// Return the child 
exit code.</span>
 </div><div class="line"><a name="l00514"></a><span class="lineno">  
514</span>&#160;  <span class="keywordflow">return</span> <span 
class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span 
class="keyword">&gt;</span>(<a class="code" 
href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>);</div><div
 class="line"><a name="l00515"></a><span class="lineno">  
515</span>&#160;}</div><div class="line"><a name="l00516"></a><span 
class="lineno">  516</span>&#160;</div><div class="line"><a 
name="l00517"></a><span class="lineno">  517</span>&#160;</div><div 
class="line"><a name="l00518"></a><span class="lineno">  518</span>&#160;<span 
class="comment">// Executes a command by calling &quot;cmd /c 
&lt;command&gt;&quot;, and returns</span></div><div class="line"><a 
name="l00519"></a><span class="lineno">  519</span>&#160;<span 
class="comment">// after the command has been completed. Returns the process 
exit</span></div><div class="line"><a name="l00520"></a>
 <span class="lineno">  520</span>&#160;<span class="comment">// code on 
success and `None` on error.</span></div><div class="line"><a 
name="l00521"></a><span class="lineno">  521</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00522"></a><span 
class="lineno">  522</span>&#160;<span class="comment">// Note: Be cautious 
about shell injection</span></div><div class="line"><a name="l00523"></a><span 
class="lineno">  523</span>&#160;<span class="comment">// 
(https://en.wikipedia.org/wiki/Code_injection#Shell_injection)</span></div><div 
class="line"><a name="l00524"></a><span class="lineno">  524</span>&#160;<span 
class="comment">// when using this method and use proper validation and 
sanitization</span></div><div class="line"><a name="l00525"></a><span 
class="lineno">  525</span>&#160;<span class="comment">// on the `command`. For 
this reason in general `os::spawn` is</span></div><div class="line"><a 
name="l00526"></a><span class="lineno">  526</span>&#160;<s
 pan class="comment">// preferred if a shell is not required.</span></div><div 
class="line"><a name="l00527"></a><span class="lineno">  527</span>&#160;<span 
class="keyword">inline</span> <a class="code" 
href="classOption.html">Option&lt;int&gt;</a> <a class="code" 
href="namespaceos.html#a75eb48541200e89e498d3d324ffc3089">system</a>(<span 
class="keyword">const</span> std::string&amp; command)</div><div 
class="line"><a name="l00528"></a><span class="lineno">  
528</span>&#160;{</div><div class="line"><a name="l00529"></a><span 
class="lineno">  529</span>&#160;  <span class="keywordflow">return</span> <a 
class="code" 
href="namespaceos.html#a18f614e5bdf40984c33888a5fa9599ca">os::spawn</a>(<a 
class="code" 
href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">Shell::name</a>,
 {<a class="code" 
href="namespaceos_1_1Shell.html#adeacb41dacfa03ad5ceebd9a53582997">Shell::arg0</a>,
 <a class="code" 
href="namespaceos_1_1Shell.html#a44f50f66f2a231de974b53c9f4384ba5">Shell::arg1</a>,
 com
 mand});</div><div class="line"><a name="l00530"></a><span class="lineno">  
530</span>&#160;}</div><div class="line"><a name="l00531"></a><span 
class="lineno">  531</span>&#160;</div><div class="line"><a 
name="l00532"></a><span class="lineno">  532</span>&#160;</div><div 
class="line"><a name="l00533"></a><span class="lineno">  533</span>&#160;<span 
class="comment">// In order to emulate the semantics of `execvp`, `os::spawn` 
waits for the new</span></div><div class="line"><a name="l00534"></a><span 
class="lineno">  534</span>&#160;<span class="comment">// process to exit, and 
returns its error code, which is propogated back to the</span></div><div 
class="line"><a name="l00535"></a><span class="lineno">  535</span>&#160;<span 
class="comment">// parent via `exit` here.</span></div><div class="line"><a 
name="l00536"></a><span class="lineno"><a class="line" 
href="namespaceos.html#a1de77f208d0bc72cf79e7eb9a6b487c7">  
536</a></span>&#160;<span class="keyword">inline</span> <span class="key
 wordtype">int</span> <a class="code" 
href="namespaceos.html#a1de77f208d0bc72cf79e7eb9a6b487c7">execvp</a>(</div><div 
class="line"><a name="l00537"></a><span class="lineno">  537</span>&#160;    
<span class="keyword">const</span> std::string&amp; command,</div><div 
class="line"><a name="l00538"></a><span class="lineno">  538</span>&#160;    
<span class="keyword">const</span> std::vector&lt;std::string&gt;&amp; 
argv)</div><div class="line"><a name="l00539"></a><span class="lineno">  
539</span>&#160;{</div><div class="line"><a name="l00540"></a><span 
class="lineno">  540</span>&#160;  exit(<a class="code" 
href="namespaceos.html#a18f614e5bdf40984c33888a5fa9599ca">os::spawn</a>(command,
 argv).getOrElse(-1));</div><div class="line"><a name="l00541"></a><span 
class="lineno">  541</span>&#160;  <span class="keywordflow">return</span> 
-1;</div><div class="line"><a name="l00542"></a><span class="lineno">  
542</span>&#160;}</div><div class="line"><a name="l00543"></a><span 
class="lineno">  543
 </span>&#160;</div><div class="line"><a name="l00544"></a><span 
class="lineno">  544</span>&#160;</div><div class="line"><a 
name="l00545"></a><span class="lineno">  545</span>&#160;<span 
class="comment">// NOTE: This function can accept `Argv` and `Envp` constructs 
through their</span></div><div class="line"><a name="l00546"></a><span 
class="lineno">  546</span>&#160;<span class="comment">// explicit type 
conversions, but unlike the POSIX implementations, it cannot</span></div><div 
class="line"><a name="l00547"></a><span class="lineno">  547</span>&#160;<span 
class="comment">// accept the raw forms.</span></div><div class="line"><a 
name="l00548"></a><span class="lineno"><a class="line" 
href="namespaceos.html#aebc3586b2be0d2b9093ccfbf25dfcde8">  
548</a></span>&#160;<span class="keyword">inline</span> <span 
class="keywordtype">int</span> <a class="code" 
href="namespaceos.html#aebc3586b2be0d2b9093ccfbf25dfcde8">execvpe</a>(</div><div
 class="line"><a name="l00549"></a><span class="linen
 o">  549</span>&#160;    <span class="keyword">const</span> std::string&amp; 
command,</div><div class="line"><a name="l00550"></a><span class="lineno">  
550</span>&#160;    <span

<TRUNCATED>

Reply via email to