You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by gi...@apache.org on 2018/06/28 18:44:57 UTC
[04/50] mesos-site git commit: Updated the website built from mesos
SHA: 7c9c72d.
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/09fd0301/content/api/latest/c++/windows_2os_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/windows_2os_8hpp_source.html b/content/api/latest/c++/windows_2os_8hpp_source.html
index a9d126c..78e0f95 100644
--- a/content/api/latest/c++/windows_2os_8hpp_source.html
+++ b/content/api/latest/c++/windows_2os_8hpp_source.html
@@ -52,7 +52,7 @@
<div class="title">os.hpp</div> </div>
</div><!--header-->
<div class="contents">
-<a href="windows_2os_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 under the Apache License, Version 2.0 (the "License");</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <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> <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> <span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <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> <span class="comment">//</
span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <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> <span class="comment">// distributed under the License is distributed on an "AS IS" BASIS,</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <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> <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> <span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> </div><div class=
"line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#ifndef __STOUT_WINDOWS_OS_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#define __STOUT_WINDOWS_OS_HPP__</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> </div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="preprocessor">#include <sys/utime.h></span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> </div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#include <algorithm></span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="preprocessor">#include <list></span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#inclu
de <map></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <memory></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <numeric></span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <set></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <string></span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="preprocessor">#include <vector></span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <<a class="code" href="bytes_8hpp.html">stout/bytes.hpp</a>></s
pan></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="duration_8hpp.html">stout/duration.hpp</a>></span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="none_8hpp.html">stout/none.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="path_8hpp.html">stout/path.hpp</a>></span></div><div class="li
ne"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="stringify_8hpp.html">stout/stringify.hpp</a>></span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <<a class="code" href="strings_8hpp.html">stout/strings.hpp</a>></span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2version_8hpp.html">stout/version.hpp</a>></span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">st
out/windows.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="os_2os_8hpp.html">stout/os/os.hpp</a>></span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#include <<a class="code" href="getenv_8hpp.html">stout/os/getenv.hpp</a>></span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2os_2process_8hpp.html">stout/os/process.hpp</a>></span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2read_8hpp.html">stout/os/read.hpp</a>></span></div><div class="line"><a name="
l00043"></a><span class="lineno"> 43</span> </div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2raw_2environment_8hpp.html">stout/os/raw/environment.hpp</a>></span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> </div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// NOTE: These system headers must be included after `stout/windows.hpp`</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// as they may include `Windows.h`. See comments in `stout/windows.hpp`</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// for why this ordering is important.</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <spa
n class="preprocessor">#include <Psapi.h></span> <span class="comment">// For `EnumProcesses` and `GetProcessMemoryInfo`.</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="preprocessor">#include <TlHelp32.h></span> <span class="comment">// For `PROCESSENTRY32W` and `CreateToolhelp32Snapshot`.</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="preprocessor">#include <Userenv.h></span> <span class="comment">// For `GetAllUsersProfileDirectoryW`.</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="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="keyword">namespace </span><a class="code" href="namespaceinterna
l.html">internal</a> {</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> </div><div class="line"><a name="l00056"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a02c567b1b6bb441a3a29433a126cedec"> 56</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::string></a> <a class="code" href="namespaceos_1_1internal.html#a02c567b1b6bb441a3a29433a126cedec">nodename</a>()</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> {</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="comment">// MSDN documentation states "The names are established at system startup,</span></div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <span class="comment">// when the system reads them from the registry." This is akin to the</span></div><div class="line"><a name="l00060"></a><spa
n class="lineno"> 60</span>  <span class="comment">// Linux `gethostname` which calls `uname`, thus avoiding a DNS lookup.</span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="comment">// The `net::getHostname` function can be used for an explicit DNS lookup.</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <span class="comment">//</span></div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="comment">// NOTE: This returns the hostname of the local computer, or the local</span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="comment">// node if this computer is part of a cluster.</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  COMPUTER_NAME_FORMAT <a class="code" href="namespacestrings_1_1internal.html#a870e2db270d980f83de20525ec414d2a">format</a>
= ComputerNamePhysicalDnsHostname;</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  DWORD <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a> = 0;</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="keywordflow">if</span> (::GetComputerNameExW(format, <span class="keyword">nullptr</span>, &size) == 0) {</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <span class="keywordflow">if</span> (::GetLastError() != ERROR_MORE_DATA) {</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  }</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  }</div><div class="line"><a name="
l00072"></a><span class="lineno"> 72</span> </div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  std::vector<wchar_t> buffer;</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  buffer.reserve(size);</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="keywordflow">if</span> (::GetComputerNameExW(format, buffer.data(), &<a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>) == 0) {</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  }</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> 
</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <span class="keywordflow">return</span> <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(std::wstring(buffer.data()));</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span> }</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span> } <span class="comment">// namespace internal {</span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> </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> <span class="comment">// Overload of os::pids for filtering by groups and sessions. A group / session</span></div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <sp
an class="comment">// id of 0 will fitler on the group / session ID of the calling process.</span></div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="comment">// NOTE: Windows does not have the concept of a process group, so we need to</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="comment">// enumerate all processes.</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::set<pid_t></a>> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">pids</a>(<a class="code" href="classOption.html">Option<pid_t></a> <a class="code" href="structgroup.html">group</a>, <a class="code" href="classOption.html">Option<pid_t></a> session)</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> {</div><div class="lin
e"><a name="l00092"></a><span class="lineno"> 92</span>  DWORD max_items = 4096;</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  DWORD bytes_returned;</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  std::vector<pid_t> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>;</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keywordtype">size_t</span> size_in_bytes;</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span> </div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="comment">// Attempt to populate `processes` with PIDs. We repeatedly call</span></div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="comment">// `EnumProcesses` with increasingly large arrays until it "succeeds" at</span></d
iv><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="comment">// populating the array with PIDs. The criteria for determining when</span></div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="comment">// `EnumProcesses` has succeeded are:</span></div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="comment">// (1) the return value is nonzero.</span></div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="comment">// (2) the `bytes_returned` is less than the number of bytes in the array.</span></div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="keywordflow">do</span> {</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="comment">// TODO(alexnaparu): Set a limit to the memory that can be used.</span></div><div class="
line"><a name="l00105"></a><span class="lineno"> 105</span>  processes.resize(max_items);</div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  size_in_bytes = processes.size() * <span class="keyword">sizeof</span>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>);</div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  CHECK_LE(size_in_bytes, MAXDWORD);</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> </div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  BOOL result = ::EnumProcesses(</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  processes.data(),</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  <span class="keyword">static_cast<</span>DWORD<span class="keyword">></span>(size_in_bytes
),</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  &bytes_returned);</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span> </div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keywordflow">if</span> (!result) {</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::pids: Call to `EnumProcesses` failed"</span>);</div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  }</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span> </div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  max_items *= 2;</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  } <span class="keyw
ordflow">while</span> (bytes_returned >= size_in_bytes);</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span> </div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  std::set<pid_t> pids_set(processes.begin(), processes.end());</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span> </div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="comment">// NOTE: The PID `0` will always be returned by `EnumProcesses`; however, it</span></div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="comment">// is the PID of Windows' System Idle Process. While the PID is valid, using</span></div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="comment">// it for anything is almost always invalid. For instance, `OpenProcess` will</span></div><div class="line"><a name="l00126
"></a><span class="lineno"> 126</span>  <span class="comment">// fail with an invalid parameter error if the user tries to get a handle for</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="comment">// PID `0`. In the interest of safety, we prevent the `pids` API from ever</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="comment">// including the PID `0`.</span></div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  pids_set.erase(0);</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="keywordflow">return</span> pids_set;</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> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span> </div><div class="line"
><a name="l00134"></a><span class="lineno"> 134</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::set<pid_t></a>> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">pids</a>()</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>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">pids</a>(<a class="code" href="structNone.html">None</a>(), <a class="code" href="structNone.html">None</a>());</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span> }</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span> </div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span cla
ss="comment">// Sets the value associated with the specified key in the set of</span></div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">// environment variables.</span></div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d">setenv</a>(</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <span class="keyword">const</span> std::string& key,</div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="keyword">const</span> std::string& value,</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <span class="keywordtype">bool</span> overwrite = <span class="keyword">true</span>)</div><div class="line"><a name="l00146"></a><span class="lineno"> 1
46</span> {</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// Do not set the variable if already set and `overwrite` was not specified.</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">//</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="comment">// Per MSDN, `GetEnvironmentVariable` returns 0 on error and sets the</span></div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  <span class="comment">// error code to `ERROR_ENVVAR_NOT_FOUND` if the variable was not found.</span></div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="comment">//</span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="comment">// https://msdn.microsoft.com/en-us/library/windows/desktop/ms683188(v=vs.85)
.aspx // NOLINT(whitespace/line_length)</span></div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <span class="keywordflow">if</span> (!overwrite &&</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  ::GetEnvironmentVariableW(wide_stringify(key).data(), <span class="keyword">nullptr</span>, 0) != 0 &&</div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  ::GetLastError() == ERROR_ENVVAR_NOT_FOUND) {</div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordflow">return</span>;</div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  }</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span> </div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// `SetEnvironmentVariable` returns an error code, but we can'
;t act on it.</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  ::SetEnvironmentVariableW(</div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  wide_stringify(key).data(), wide_stringify(value).data());</div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span> }</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span> </div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span> </div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span> <span class="comment">// Unsets the value associated with the specified key in the set of</span></div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="comment">// environment variables.</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <span class="keyword">inline</span> <span class="keywordtype">
void</span> <a class="code" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5">unsetenv</a>(<span class="keyword">const</span> std::string& key)</div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span> {</div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <span class="comment">// Per MSDN documentation[1], passing `nullptr` as the value will cause</span></div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="comment">// `SetEnvironmentVariable` to delete the key from the process's environment.</span></div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  ::SetEnvironmentVariableW(wide_stringify(key).data(), <span class="keyword">nullptr</span>);</div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span> }</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span> </div><div class="line"><a n
ame="l00174"></a><span class="lineno"> 174</span> </div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment">// NOTE: This exists for compatibility with the POSIX API. On Windows,</span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span> <span class="comment">// either function is suitable for clearing a secret from the</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment">// environment, as the pointers returned by `GetEnvironmentVariable`</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">// and `GetEnvironmentStrings` are to blocks allocated on invocation.</span></div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceos.html#afe5b6cbeb92f2df4f8f6211
d8b0c8be4">eraseenv</a>(<span class="keyword">const</span> std::string& key)</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span> {</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <a class="code" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5">unsetenv</a>(key);</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> </div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span> </div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="comment">// Suspends execution of the calling process until a child specified by `pid`</span></div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="comment">// has changed state. Unlike the POSIX standard function `::waitpid`, this</span></div><div class="line">
<a name="l00187"></a><span class="lineno"> 187</span> <span class="comment">// function does not use -1 and 0 to signify errors and nonblocking return.</span></div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment">// Instead, we return `Result<pid_t>`:</span></div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="comment">// * In case of error, we return `Error` rather than -1. For example, we</span></div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment">// would return an `Error` in case of `EINVAL`.</span></div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="comment">// * In case of nonblocking return, we return `None` rather than 0. For</span></div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span> <span class="comment">// example, if we pass `WNOHA
NG` in the `options`, we would expect 0 to be</span></div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> <span class="comment">// returned in the case that children specified by `pid` exist, but have</span></div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="comment">// not changed state yet. In this case we return `None` instead.</span></div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="comment">//</span></div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="comment">// NOTE: There are important differences between the POSIX and Windows</span></div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span> <span class="comment">// implementations of this function:</span></div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="comment">// * On POSIX, `pid_
t` is a signed number, but on Windows, PIDs are `DWORD`,</span></div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span> <span class="comment">// which is `unsigned long`. Thus, if we use `DWORD` to represent the `pid`</span></div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="comment">// argument, passing -1 as the `pid` would (on most modern servers)</span></div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="comment">// silently convert to a really large `pid`. This is undesirable.</span></div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <span class="comment">// * Since it is important to be able to detect -1 has been passed to</span></div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span> <span class="comment">// `os::waitpid`, as a matter of practicality, we choose to:</span></div><div clas
s="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// (1) Use `long` to represent the `pid` argument.</span></div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment">// (2) Disable using any value <= 0 for `pid` on Windows.</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span> <span class="comment">// * This decision is pragmatic. The reasoning is:</span></div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span> <span class="comment">// (1) The Windows code paths call `os::waitpid` in only a handful of</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="comment">// places, and in none of these conditions do we need `-1` as a value.</span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="comment">// (2) Since PID
s virtually never take on values outside the range of</span></div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span> <span class="comment">// vanilla signed `long` it is likely that an accidental conversion</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span> <span class="comment">// will never happen.</span></div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="comment">// (3) Even though it is not formalized in the C specification, the</span></div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="comment">// implementation of `long` on the vast majority of production servers</span></div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span> <span class="comment">// is 2's complement, so we expect that when we accidentally do</span></div><div class="line"><a name="l00215"></a
><span class="lineno"> 215</span> <span class="comment">// implicitly convert from `unsigned long` to `long`, we will "wrap</span></div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span> <span class="comment">// around" to negative values. And since we've disabled the negative</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span> <span class="comment">// `pid` in the Windows implementation, we should error out.</span></div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> <span class="comment">// * Finally, on Windows, we currently do not check that the process we are</span></div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span> <span class="comment">// attempting to await is a child process.</span></div><div class="line"><a name="l00220"></a><span class="lineno"><a class="line" href="namespaceos.html#a59caf358baf81d
e389c29d983b8e21ad"> 220</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<pid_t></a> <a class="code" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba">waitpid</a>(<span class="keywordtype">long</span> pid, <span class="keywordtype">int</span>* <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>, <span class="keywordtype">int</span> options)</div><div class="line"><a name="l00221"></a><span class="lineno"> 221</span> {</div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> wait_for_child = (options & <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afa288d86b242c3005425a9c0f1682544">WNOHANG</a>) == 0;</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> </div><div class="line"><a name="l00224"></a><span class="lineno"> 2
24</span>  <span class="comment">// NOTE: Windows does not implement pids <= 0.</span></div><div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="keywordflow">if</span> (pid <= 0) {</div><div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  errno = ENOSYS;</div><div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div><div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="stringliteral">"os::waitpid: Value of pid is '"</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(pid) +</div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="stringliteral">"'; the Windows implementation currently does not allow values <= 0"
</span>);</div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (options != 0 && options != <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afa288d86b242c3005425a9c0f1682544">WNOHANG</a>) {</div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="comment">// NOTE: We only support `options == 0` or `options == WNOHANG`. On Windows</span></div><div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  <span class="comment">// no flags other than `WNOHANG` are supported.</span></div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  errno = ENOSYS;</div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div><div class="line
"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="stringliteral">"os::waitpid: Only flag `WNOHANG` is implemented on Windows"</span>);</div><div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  }</div><div class="line"><a name="l00237"></a><span class="lineno"> 237</span> </div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <span class="comment">// TODO(hausdorff): Check that `pid` is one of the child processes. If not,</span></div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="comment">// set `errno` to `ECHILD` and return -1.</span></div><div class="line"><a name="l00240"></a><span class="lineno"> 240</span> </div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  <span class="comment">// Open the child process as a safe `SharedHandle`.</span></div><div class="line"><a name="l00242"></a><span cl
ass="lineno"> 242</span>  <span class="keyword">const</span> <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> <a class="code" href="namespaceprocess.html">process</a> = ::OpenProcess(</div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  PROCESS_QUERY_INFORMATION | SYNCHRONIZE,</div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  FALSE,</div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  static_cast<DWORD>(pid));</div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span> </div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  <span class="keywordflow">if</span> (process == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  <span class="keywordflow">return</span> <a class="c
ode" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::waitpid: Failed to open process for pid '"</span> +</div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(pid) + <span class="stringliteral">"'"</span>);</div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  }</div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span> </div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <a class="code" href="classSharedHandle.html">SharedHandle</a> scoped_process(process, ::CloseHandle);</div><div class="line"><a name="l00253"></a><span class="lineno"> 253</span> </div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  <span class="comment">// If `WNOHANG` flag is set, don't
wait. Otherwise, wait for child to</span></div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  <span class="comment">// terminate.</span></div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  <span class="keyword">const</span> DWORD wait_time = wait_for_child ? INFINITE : 0;</div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <span class="keyword">const</span> DWORD wait_results = ::WaitForSingleObject(</div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  scoped_process.get(),</div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  wait_time);</div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span> </div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  <span class="comment">// Verify our wait exited correctly.</span></div><div class="line"><a name="l00262"></a><sp
an class="lineno"> 262</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> state_signaled = wait_results == WAIT_OBJECT_0;</div><div class="line"><a name="l00263"></a><span class="lineno"> 263</span>  <span class="keywordflow">if</span> (options == 0 && !state_signaled) {</div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <span class="comment">// If `WNOHANG` is not set, then we should have stopped waiting only for a</span></div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  <span class="comment">// state change in `scoped_process`.</span></div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  errno = ECHILD;</div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div><div class="line"><a name="l00
268"></a><span class="lineno"> 268</span>  <span class="stringliteral">"os::waitpid: Failed to wait for pid '"</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(pid) +</div><div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <span class="stringliteral">"'. `::WaitForSingleObject` should have waited for child process to "</span> +</div><div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <span class="stringliteral">"exit, but returned code '"</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(wait_results) +</div><div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  <span class="stringliteral">"' instead"</span>);</div><div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  } <span class="keywordflow">el
se</span> <span class="keywordflow">if</span> (wait_for_child && !state_signaled &&</div><div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  wait_results != WAIT_TIMEOUT) {</div><div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <span class="comment">// If `WNOHANG` is set, then a successful wait should report either a</span></div><div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  <span class="comment">// timeout (since we set the time to wait to `0`), or a successful state</span></div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <span class="comment">// change of `scoped_process`. Anything else is an error.</span></div><div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  errno = ECHILD;</div><div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="keywordflow">retu
rn</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <span class="stringliteral">"os::waitpid: Failed to wait for pid '"</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(pid) +</div><div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  <span class="stringliteral">"'. `ENOHANG` flag was passed in, so `::WaitForSingleObject` should "</span> +</div><div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="stringliteral">"have either returned `WAIT_OBJECT_0` or `WAIT_TIMEOUT` (the "</span> +</div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  <span class="stringliteral">"timeout was set to 0, because we are not waiting for the child), "</span> +</div><div class="line"><a n
ame="l00283"></a><span class="lineno"> 283</span>  <span class="stringliteral">"but instead returned code '"</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(wait_results) + <span class="stringliteral">"'"</span>);</div><div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  }</div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span> </div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="keywordflow">if</span> (!wait_for_child && wait_results == WAIT_TIMEOUT) {</div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <span class="comment">// Success. `ENOHANG` was set and we got a timeout, so return `None` (POSIX</span></div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  <span class="comment">// `::waitpid` would return 0 here).</sp
an></div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  }</div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span> </div><div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  <span class="comment">// Attempt to retrieve exit code from child process. Store that exit code in</span></div><div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="comment">// the `status` variable if it's `nullptr`.</span></div><div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  DWORD child_exit_code = 0;</div><div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  <span class="keywordflow">if</span> (!::GetExitCodeProcess(scoped_process.get(), &child_ex
it_code)) {</div><div class="line"><a name="l00296"></a><span class="lineno"> 296</span>  errno = ECHILD;</div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <span class="stringliteral">"os::waitpid: Successfully waited on child process with pid '"</span> +</div><div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  std::to_string(pid) + <span class="stringliteral">"', but could not retrieve exit code"</span>);</div><div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  }</div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span> </div><div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  <span class="keywordflow">if
</span> (status != <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  *status = child_exit_code;</div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  }</div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span> </div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  <span class="comment">// Success. Return pid of the child process for which the status is reported.</span></div><div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  <span class="keywordflow">return</span> pid;</div><div class="line"><a name="l00308"></a><span class="lineno"> 308</span> }</div><div class="line"><a name="l00309"></a><span class="lineno"> 309</span> </div><div class="line"><a name="l00310"></a><span class="lineno"> 310</span> </div><div class="line"><a name="l00311"></a><span class="lineno"> 311</span>&
#160;<span class="keyword">inline</span> std::string <a class="code" href="namespaceos.html#a73c0258b355f6a38f3809bcd16a8f25a">hstrerror</a>(<span class="keywordtype">int</span> err) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00312"></a><span class="lineno"> 312</span> </div><div class="line"><a name="l00313"></a><span class="lineno"> 313</span> </div><div class="line"><a name="l00314"></a><span class="lineno"> 314</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#a9ea4b5bd8ccef02c74ceb9b4a497baab">chown</a>(</div><div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">uid_t</a> <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>,</div><div class="line"><a name="l00316"></a><sp
an class="lineno"> 316</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a> gid,</div><div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  <span class="keyword">const</span> std::string& <a class="code" href="namespacepath.html">path</a>,</div><div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  <span class="keywordtype">bool</span> recursive) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00319"></a><span class="lineno"> 319</span> </div><div class="line"><a name="l00320"></a><span class="lineno"> 320</span> </div><div class="line"><a name="l00321"></a><span class="lineno"> 321</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#ab9f08ced036cc5156a11a86090768bb5">chmod</a>(<span class="keyword">const</span> st
d::string& path, <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00322"></a><span class="lineno"> 322</span> </div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span> </div><div class="line"><a name="l00324"></a><span class="lineno"> 324</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd">mknod</a>(</div><div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  <span class="keyword">const</span> std::string& path,</div><div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a> mode,</div><div class="li
ne"><a name="l00327"></a><span class="lineno"> 327</span>  dev_t <a class="code" href="namespaceos_1_1stat.html#a083c9ff4aefeba1a75a27e6a6d6e2a71">dev</a>) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span> </div><div class="line"><a name="l00329"></a><span class="lineno"> 329</span> </div><div class="line"><a name="l00330"></a><span class="lineno"> 330</span> <span class="comment">// Suspends execution for the given duration.</span></div><div class="line"><a name="l00331"></a><span class="lineno"> 331</span> <span class="comment">// NOTE: This implementation features a millisecond-resolution sleep API, while</span></div><div class="line"><a name="l00332"></a><span class="lineno"> 332</span> <span class="comment">// the POSIX version uses a nanosecond-resolution sleep API. As of this writing,</span></div><div class="line"><a name="l00333"></a><span class="lineno"> 333</span> 
;<span class="comment">// Mesos only requires millisecond resolution, so this is ok for now.</span></div><div class="line"><a name="l00334"></a><span class="lineno"> 334</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#ab2b826c68a25af9e9ef47c570c36e137">sleep</a>(<span class="keyword">const</span> <a class="code" href="classDuration.html">Duration</a>& duration)</div><div class="line"><a name="l00335"></a><span class="lineno"> 335</span> {</div><div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  <span class="keywordflow">if</span> (duration.<a class="code" href="classDuration.html#a05ddd6a9f21b82dba6313f81418f53d2">ms</a>() < 0) {</div><div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(ERROR_INVALID_PARAMETER);</d
iv><div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  }</div><div class="line"><a name="l00339"></a><span class="lineno"> 339</span> </div><div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  ::Sleep(static_cast<DWORD>(duration.<a class="code" href="classDuration.html#a05ddd6a9f21b82dba6313f81418f53d2">ms</a>()));</div><div class="line"><a name="l00341"></a><span class="lineno"> 341</span> </div><div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div><div class="line"><a name="l00343"></a><span class="lineno"> 343</span> }</div><div class="line"><a name="l00344"></a><span class="lineno"> 344</span> </div><div class="line"><a name="l00345"></a><span class="lineno"> 345</span> </div><div class="line"><a name="l00346"></a><span class="lineno"> 346</span> <span class
="comment">// Returns the list of files that match the given (shell) pattern.</span></div><div class="line"><a name="l00347"></a><span class="lineno"> 347</span> <span class="comment">// NOTE: Deleted on Windows, as a POSIX-API-compliant `glob` is much more</span></div><div class="line"><a name="l00348"></a><span class="lineno"> 348</span> <span class="comment">// trouble than its worth, considering our relatively simple usage.</span></div><div class="line"><a name="l00349"></a><span class="lineno"> 349</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<std::string></a>> <a class="code" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422">glob</a>(<span class="keyword">const</span> std::string& pattern) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00350"></a><span class="lineno"> 350</span> </div><div class="line"><a name="l00351"></a><span class="lineno"> 351</span>&#
160;</div><div class="line"><a name="l00352"></a><span class="lineno"> 352</span> <span class="comment">// Returns the total number of cpus (cores).</span></div><div class="line"><a name="l00353"></a><span class="lineno"> 353</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<long></a> <a class="code" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</a>()</div><div class="line"><a name="l00354"></a><span class="lineno"> 354</span> {</div><div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  SYSTEM_INFO sys_info;</div><div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  ::GetSystemInfo(&sys_info);</div><div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span><span class="keywordtype">long</span><span class="keyword">></span>(sys_info.dwNumberOfProces
sors);</div><div class="line"><a name="l00358"></a><span class="lineno"> 358</span> }</div><div class="line"><a name="l00359"></a><span class="lineno"> 359</span> </div><div class="line"><a name="l00360"></a><span class="lineno"> 360</span> <span class="comment">// Returns load struct with average system loads for the last</span></div><div class="line"><a name="l00361"></a><span class="lineno"> 361</span> <span class="comment">// 1, 5 and 15 minutes respectively.</span></div><div class="line"><a name="l00362"></a><span class="lineno"> 362</span> <span class="comment">// Load values should be interpreted as usual average loads from</span></div><div class="line"><a name="l00363"></a><span class="lineno"> 363</span> <span class="comment">// uptime(1).</span></div><div class="line"><a name="l00364"></a><span class="lineno"> 364</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Load></a> <a class="code" hre
f="namespaceos.html#ad932e3876b339c61b03abc575ad3943b">loadavg</a>()</div><div class="line"><a name="l00365"></a><span class="lineno"> 365</span> {</div><div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  <span class="comment">// No Windows equivalent, return an error until there is a need. We can</span></div><div class="line"><a name="l00367"></a><span class="lineno"> 367</span>  <span class="comment">// construct an approximation of this function by periodically polling</span></div><div class="line"><a name="l00368"></a><span class="lineno"> 368</span>  <span class="comment">// `GetSystemTimes` and using a sliding window of statistics.</span></div><div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(ERROR_NOT_SUPPORTED,</div><div class="line"><a name="l00370"></a><span class="lineno"> 370</span> 
<span class="stringliteral">"Failed to determine system load averages"</span>);</div><div class="line"><a name="l00371"></a><span class="lineno"> 371</span> }</div><div class="line"><a name="l00372"></a><span class="lineno"> 372</span> </div><div class="line"><a name="l00373"></a><span class="lineno"> 373</span> </div><div class="line"><a name="l00374"></a><span class="lineno"> 374</span> <span class="comment">// Returns the total size of main and free memory.</span></div><div class="line"><a name="l00375"></a><span class="lineno"> 375</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Memory></a> <a class="code" href="namespaceos.html#a23a7b8f4b4c145ad212381e89d4b6dc4">memory</a>()</div><div class="line"><a name="l00376"></a><span class="lineno"> 376</span> {</div><div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  <a class="code" href="structos_1_1Memo
ry.html">Memory</a> <a class="code" href="namespaceos.html#a23a7b8f4b4c145ad212381e89d4b6dc4">memory</a>;</div><div class="line"><a name="l00378"></a><span class="lineno"> 378</span> </div><div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  MEMORYSTATUSEX memory_status;</div><div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  memory_status.dwLength = <span class="keyword">sizeof</span>(MEMORYSTATUSEX);</div><div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  <span class="keywordflow">if</span> (!::GlobalMemoryStatusEx(&memory_status)) {</div><div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::memory: Call to `GlobalMemoryStatusEx` failed"</span>);</div><div class="line"><a name="l00383"></a><span class="lineno"> 383<
/span>  }</div><div class="line"><a name="l00384"></a><span class="lineno"> 384</span> </div><div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  memory.<a class="code" href="structos_1_1Memory.html#a3670204f7fb13a96ca0e278f49b91282">total</a> = <a class="code" href="classBytes.html">Bytes</a>(memory_status.ullTotalPhys);</div><div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  memory.<a class="code" href="structos_1_1Memory.html#ab447e8e30892e0d5f0e3a976e6d80cde">free</a> = <a class="code" href="classBytes.html">Bytes</a>(memory_status.ullAvailPhys);</div><div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  memory.<a class="code" href="structos_1_1Memory.html#a00f1a2071778c1ce10eff411fae079d5">totalSwap</a> = <a class="code" href="classBytes.html">Bytes</a>(memory_status.ullTotalPageFile);</div><div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  memory.<a class=
"code" href="structos_1_1Memory.html#a99857d2d965390fe2e88f417037dce55">freeSwap</a> = <a class="code" href="classBytes.html">Bytes</a>(memory_status.ullAvailPageFile);</div><div class="line"><a name="l00389"></a><span class="lineno"> 389</span> </div><div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#a23a7b8f4b4c145ad212381e89d4b6dc4">memory</a>;</div><div class="line"><a name="l00391"></a><span class="lineno"> 391</span> }</div><div class="line"><a name="l00392"></a><span class="lineno"> 392</span> </div><div class="line"><a name="l00393"></a><span class="lineno"> 393</span> </div><div class="line"><a name="l00394"></a><span class="lineno"> 394</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Version></a> <a class="code" href="namespaceos.html#a079aa1b108c567735620a14ea2a2e506">release</a>() = <span class
="keyword">delete</span>;</div><div class="line"><a name="l00395"></a><span class="lineno"> 395</span> </div><div class="line"><a name="l00396"></a><span class="lineno"> 396</span> </div><div class="line"><a name="l00397"></a><span class="lineno"> 397</span> <span class="comment">// Return the system information.</span></div><div class="line"><a name="l00398"></a><span class="lineno"> 398</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<UTSInfo></a> <a class="code" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919">uname</a>() = <span class="keyword">delete</span>;</div><div class="line"><a name="l00399"></a><span class="lineno"> 399</span> </div><div class="line"><a name="l00400"></a><span class="lineno"> 400</span> </div><div class="line"><a name="l00401"></a><span class="lineno"><a class="line" href="namespaceos.html#a5e0295f0e3bae2bd29d86803f9293b5d"> 401</a></span> <span class="keyword">in
line</span> tm* <a class="code" href="namespaceos.html#a5e0295f0e3bae2bd29d86803f9293b5d">gmtime_r</a>(<span class="keyword">const</span> time_t* timep, tm* result)</div><div class="line"><a name="l00402"></a><span class="lineno"> 402</span> {</div><div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  return ::gmtime_s(result, timep) == ERROR_SUCCESS ? result : <span class="keyword">nullptr</span>;</div><div class="line"><a name="l00404"></a><span class="lineno"> 404</span> }</div><div class="line"><a name="l00405"></a><span class="lineno"> 405</span> </div><div class="line"><a name="l00406"></a><span class="lineno"> 406</span> </div><div class="line"><a name="l00407"></a><span class="lineno"><a class="line" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747"> 407</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<PROCESSENTRY32W></a> <a class="code" href="namespaceos.html#
a64774f3176080d29eedcee42ae23c747">process_entry</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid)</div><div class="line"><a name="l00408"></a><span class="lineno"> 408</span> {</div><div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  <span class="comment">// Get a snapshot of the processes in the system. NOTE: We should not check</span></div><div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  <span class="comment">// whether the handle is `nullptr`, because this API will always return</span></div><div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  <span class="comment">// `INVALID_HANDLE_VALUE` on error.</span></div><div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> snapshot_han
dle = CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, pid);</div><div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="keywordflow">if</span> (snapshot_handle == INVALID_HANDLE_VALUE) {</div><div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div><div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <span class="stringliteral">"os::process_entry: Call to `CreateToolhelp32Snapshot` failed"</span>);</div><div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  }</div><div class="line"><a name="l00417"></a><span class="lineno"> 417</span> </div><div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <a class="code" href="classSharedHandle.html">SharedHandle</a> safe_snapshot_handle(snapshot_handle, ::CloseHandle);</div><div
class="line"><a name="l00419"></a><span class="lineno"> 419</span> </div><div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <span class="comment">// Initialize process entry.</span></div><div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  PROCESSENTRY32W <a class="code" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747">process_entry</a>;</div><div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  memset(&process_entry, 0, <span class="keyword">sizeof</span>(process_entry));</div><div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  process_entry.dwSize = <span class="keyword">sizeof</span>(<a class="code" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747">process_entry</a>);</div><div class="line"><a name="l00424"></a><span class="lineno"> 424</span> </div><div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <span class
="comment">// Get first process so that we can loop through process entries until we</span></div><div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  <span class="comment">// find the one we care about.</span></div><div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  SetLastError(ERROR_SUCCESS);</div><div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  BOOL has_next = Process32First(safe_snapshot_handle.get(), &<a class="code" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747">process_entry</a>);</div><div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  <span class="keywordflow">if</span> (has_next == FALSE) {</div><div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  <span class="comment">// No first process was found. We should never be here; it is arguable we</span></div><div class="line"><a name="l00431"></a><span class="lineno"> 431
</span>  <span class="comment">// should return `None`, since we won't find the PID we're looking for, but</span></div><div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  <span class="comment">// we elect to return `Error` because something terrible has probably</span></div><div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="comment">// happened.</span></div><div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  <span class="keywordflow">if</span> (::GetLastError() != ERROR_SUCCESS) {</div><div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::process_entry: Call to `Process32First` failed"</span>);</div><div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  } <span clas
s="keywordflow">else</span> {</div><div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"os::process_entry: Call to `Process32First` failed"</span>);</div><div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  }</div><div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  }</div><div class="line"><a name="l00440"></a><span class="lineno"> 440</span> </div><div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  <span class="comment">// Loop through processes until we find the one we're looking for.</span></div><div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  <span class="keywordflow">while</span> (has_next == TRUE) {</div><div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  <span class=
"keywordflow">if</span> (process_entry.th32ProcessID == pid) {</div><div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <span class="comment">// Process found.</span></div><div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747">process_entry</a>;</div><div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  }</div><div class="line"><a name="l00447"></a><span class="lineno"> 447</span> </div><div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  has_next = Process32Next(safe_snapshot_handle.get(), &<a class="code" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747">process_entry</a>);</div><div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <span class="keywordflow">if</span> (has_next == FALSE) {</div><div class="li
ne"><a name="l00450"></a><span class="lineno"> 450</span>  DWORD last_error = ::GetLastError();</div><div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <span class="keywordflow">if</span> (last_error != ERROR_NO_MORE_FILES && last_error != ERROR_SUCCESS) {</div><div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div><div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  <span class="stringliteral">"os::process_entry: Call to `Process32Next` failed"</span>);</div><div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  }</div><div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  }</div><div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  }</div><div class="line"><a name="
l00457"></a><span class="lineno"> 457</span> </div><div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div><div class="line"><a name="l00459"></a><span class="lineno"> 459</span> }</div><div class="line"><a name="l00460"></a><span class="lineno"> 460</span> </div><div class="line"><a name="l00461"></a><span class="lineno"> 461</span> </div><div class="line"><a name="l00462"></a><span class="lineno"> 462</span> <span class="comment">// Generate a `Process` object for the process associated with `pid`. If</span></div><div class="line"><a name="l00463"></a><span class="lineno"> 463</span> <span class="comment">// process is not found, we return `None`; error is reserved for the case where</span></div><div class="line"><a name="l00464"></a><span class="lineno"> 464</span> <span class="comment">// something went wrong.</span></d
iv><div class="line"><a name="l00465"></a><span class="lineno"> 465</span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<Process></a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid)</div><div class="line"><a name="l00466"></a><span class="lineno"> 466</span> {</div><div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <span class="keywordflow">if</span> (pid == 0) {</div><div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  <span class="comment">// The 0th PID is that of the System Idle Process on Windows. However, it is</span></div><div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="comment">// invalid to attempt to get a proces handle or else perform any operation</span></d
iv><div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  <span class="comment">// on this pseudo-process.</span></div><div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"os::process: Invalid parameter: pid == 0"</span>);</div><div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  }</div><div class="line"><a name="l00473"></a><span class="lineno"> 473</span> </div><div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">// Find process with pid.</span></div><div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <a class="code" href="classResult.html">Result<PROCESSENTRY32W></a> entry = <a class="code" href="namespaceos.html#a64774f3176080d29eedcee42ae23c747">process_entry</a>(pid);</div><div clas
s="line"><a name="l00476"></a><span class="lineno"> 476</span> </div><div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  <span class="keywordflow">if</span> (entry.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>()) {</div><div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(entry.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">error</a>());</div><div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (entry.<a class="code" href="classResult.html#ac2cdc0db9f9d29a5bb2f1cf19c29da49">isNone</a>()) {</div><div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  <span class="keywordflow">return</span> <a class="code" href="structNone.html">
None</a>();</div><div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  }</div><div class="line"><a name="l00482"></a><span class="lineno"> 482</span> </div><div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> process_handle = ::OpenProcess(</div><div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  PROCESS_QUERY_LIMITED_INFORMATION | PROCESS_VM_READ,</div><div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <span class="keyword">false</span>,</div><div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  pid);</div><div class="line"><a name="l00487"></a><span class="lineno"> 487</span> </div><div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <span class="comment">// ::OpenProcess returns `NULL`
, not `INVALID_HANDLE_VALUE` on failure.</span></div><div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="keywordflow">if</span> (process_handle == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::process: Call to `OpenProcess` failed"</span>);</div><div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  }</div><div class="line"><a name="l00492"></a><span class="lineno"> 492</span> </div><div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  <a class="code" href="classSharedHandle.html">SharedHandle</a> safe_process_handle(process_handle, ::CloseHandle);</div><div class="line"><a name="l00494"></a><span class="lineno"> 494</span> </div><div class="line"><a name="l
00495"></a><span class="lineno"> 495</span>  <span class="comment">// Get Windows Working set size (Resident set size in linux).</span></div><div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  PROCESS_MEMORY_COUNTERS proc_mem_counters;</div><div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  BOOL get_process_memory_info = ::GetProcessMemoryInfo(</div><div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  safe_process_handle.<a class="code" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa">get_handle</a>(),</div><div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  &proc_mem_counters,</div><div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <span class="keyword">sizeof</span>(proc_mem_counters));</div><div class="line"><a name="l00501"></a><span class="lineno"> 501</span> </div><div class="line"><a name="l005
02"></a><span class="lineno"> 502</span>  <span class="keywordflow">if</span> (!get_process_memory_info) {</div><div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::process: Call to `GetProcessMemoryInfo` failed"</span>);</div><div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  }</div><div class="line"><a name="l00505"></a><span class="lineno"> 505</span> </div><div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <span class="comment">// Get session Id.</span></div><div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> session_id;</div><div class="line"><a name="l00508"></a><span class="lineno"> 508</sp
an>  BOOL process_id_to_session_id = ::ProcessIdToSessionId(pid, &session_id);</div><div class="line"><a name="l00509"></a><span class="lineno"> 509</span> </div><div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  <span class="keywordflow">if</span> (!process_id_to_session_id) {</div><div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::process: Call to `ProcessIdToSessionId` failed"</span>);</div><div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  }</div><div class="line"><a name="l00513"></a><span class="lineno"> 513</span> </div><div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  <span class="comment">// Get Process CPU time.</span></div><div class="line"><a name="l00515"></a><span class="lineno"> 515</s
pan>  FILETIME create_filetime, exit_filetime, kernel_filetime, user_filetime;</div><div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  BOOL get_process_times = ::GetProcessTimes(</div><div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  safe_process_handle.<a class="code" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa">get_handle</a>(),</div><div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  &create_filetime,</div><div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  &exit_filetime,</div><div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  &kernel_filetime,</div><div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  &user_filetime);</div><div class="line"><a name="l00522"></a><span class="lineno"> 522</span> </div><div class="line"><a name="l00523"></a><span c
lass="lineno"> 523</span>  <span class="keywordflow">if</span> (!get_process_times) {</div><div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(<span class="stringliteral">"os::process: Call to `GetProcessTimes` failed"</span>);</div><div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  }</div><div class="line"><a name="l00526"></a><span class="lineno"> 526</span> </div><div class="line"><a name="l00527"></a><span class="lineno"> 527</span>  <span class="comment">// Get utime and stime.</span></div><div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  ULARGE_INTEGER lKernelTime, lUserTime; <span class="comment">// In 100 nanoseconds.</span></div><div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  lKernelTime.HighPart = kernel_filetime.dwHighDate
Time;</div><div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  lKernelTime.LowPart = kernel_filetime.dwLowDateTime;</div><div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  lUserTime.HighPart = user_filetime.dwHighDateTime;</div><div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  lUserTime.LowPart = user_filetime.dwLowDateTime;</div><div class="line"><a name="l00533"></a><span class="lineno"> 533</span> </div><div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  <a class="code" href="classTry.html">Try<Duration></a> <a class="code" href="namespaceos.html#a818327458964860a86fc8964e4795b4d">utime</a> = <a class="code" href="classNanoseconds.html">Nanoseconds</a>(lKernelTime.QuadPart * 100);</div><div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  <a class="code" href="classTry.html">Try<Duration></a> stime = <a class="code" href="c
lassNanoseconds.html">Nanoseconds</a>(lUserTime.QuadPart * 100);</div><div class="line"><a name="l00536"></a><span class="lineno"> 536</span> </div><div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <span class="keywordflow">return</span> <a class="code" href="structos_1_1Process.html">Process</a>(</div><div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  pid,</div><div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  entry.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>().th32ParentProcessID, <span class="comment">// Parent process id.</span></div><div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  0, <span class="comment">// Group id.</span></div><div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  session_id,</div><div class="line"><a name="l005
42"></a><span class="lineno"> 542</span>  <a class="code" href="classBytes.html">Bytes</a>(proc_mem_counters.WorkingSetSize),</div><div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  utime.<a class="code" href="classTry.html#a6543d7d5db4f298bcd673bf3cd509acc">isSome</a>() ? utime.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>() : <a class="code" href="classOption.html#aca73609603df4687dba70c2a5df47ef8">Option<Duration>::none</a>(),</div><div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  stime.<a class="code" href="classTry.html#a6543d7d5db4f298bcd673bf3cd509acc">isSome</a>() ? stime.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>() : <a class="code" href="classOption.html#aca73609603df4687dba70c2a5df47ef8">Option<Duration>::none</a>(),</div><div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <a class="c
ode" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(entry.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>().szExeFile), <span class="comment">// Executable filename.</span></div><div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <span class="keyword">false</span>); <span class="comment">// Is not zombie process.</span></div><div class="line"><a name="l00547"></a><span class="lineno"> 547</span> }</div><div class="line"><a name="l00548"></a><span class="lineno"> 548</span> </div><div class="line"><a name="l00549"></a><span class="lineno"> 549</span> </div><div class="line"><a name="l00550"></a><span class="lineno"><a class="line" href="namespaceos.html#aede9f61dcb4b7d1f276302a7bce37446"> 550</a></span> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos.html#aede9f61dcb4b7d1f2
76302a7bce37446">random</a>()</div><div class="line"><a name="l00551"></a><span class="lineno"> 551</span> {</div><div class="line"><a name="l00552"></a><span class="lineno"> 552</span> 
<TRUNCATED>