http://git-wip-us.apache.org/repos/asf/mesos-site/blob/78eea43c/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 21b1437..21feff5 100644 --- a/content/api/latest/c++/windows_2os_8hpp_source.html +++ b/content/api/latest/c++/windows_2os_8hpp_source.html @@ -67,833 +67,836 @@ <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"></span><span class="preprocessor">#define __STOUT_WINDOWS_OS_HPP__</span></div> <div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="preprocessor">#include <direct.h></span></div> -<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#include <io.h></span></div> -<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#include <Psapi.h></span></div> -<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="preprocessor">#include <TlHelp32.h></span></div> -<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <Userenv.h></span></div> -<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div> -<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <sys/utime.h></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 <list></span></div> +<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="preprocessor">#include <map></span></div> +<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <memory></span></div> +<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <set></span></div> +<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <string></span></div> <div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div> -<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <list></span></div> -<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="preprocessor">#include <map></span></div> -<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <memory></span></div> -<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <set></span></div> -<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <string></span></div> -<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> </div> -<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="duration_8hpp.html">stout/duration.hpp</a>></span></div> -<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="none_8hpp.html">stout/none.hpp</a>></span></div> -<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div> -<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div> -<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <<a class="code" href="path_8hpp.html">stout/path.hpp</a>></span></div> -<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="stringify_8hpp.html">stout/stringify.hpp</a>></span></div> -<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <<a class="code" href="strings_8hpp.html">stout/strings.hpp</a>></span></div> -<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div> -<div class="line"><a name="l00038"></a><span class="lineno"> 38</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="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>></span></div> -<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div> -<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor">#include <<a class="code" href="os_2os_8hpp.html">stout/os/os.hpp</a>></span></div> -<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor">#include <<a class="code" href="getenv_8hpp.html">stout/os/getenv.hpp</a>></span></div> -<div class="line"><a name="l00043"></a><span class="lineno"> 43</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="l00044"></a><span class="lineno"> 44</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="l00045"></a><span class="lineno"> 45</span> </div> -<div class="line"><a name="l00046"></a><span class="lineno"> 46</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="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor">#include <<a class="code" href="fd_8hpp.html">stout/os/windows/fd.hpp</a>></span></div> -<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> </div> -<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="keyword">namespace </span>os {</div> -<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="keyword">namespace </span>internal {</div> +<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="duration_8hpp.html">stout/duration.hpp</a>></span></div> +<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="preprocessor">#include <<a class="code" href="none_8hpp.html">stout/none.hpp</a>></span></div> +<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div> +<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div> +<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="path_8hpp.html">stout/path.hpp</a>></span></div> +<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="stringify_8hpp.html">stout/stringify.hpp</a>></span></div> +<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="strings_8hpp.html">stout/strings.hpp</a>></span></div> +<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div> +<div class="line"><a name="l00032"></a><span class="lineno"> 32</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="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>></span></div> +<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div> +<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="os_2os_8hpp.html">stout/os/os.hpp</a>></span></div> +<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <<a class="code" href="getenv_8hpp.html">stout/os/getenv.hpp</a>></span></div> +<div class="line"><a name="l00037"></a><span class="lineno"> 37</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="l00038"></a><span class="lineno"> 38</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="l00039"></a><span class="lineno"> 39</span> </div> +<div class="line"><a name="l00040"></a><span class="lineno"> 40</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="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor">#include <<a class="code" href="fd_8hpp.html">stout/os/windows/fd.hpp</a>></span></div> +<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> </div> +<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// NOTE: These system headers must be included after `stout/windows.hpp`</span></div> +<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// as they may include `Windows.h`. See comments in `stout/windows.hpp`</span></div> +<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// for why this ordering is important.</span></div> +<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="preprocessor">#include <direct.h></span></div> +<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor">#include <io.h></span></div> +<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="preprocessor">#include <Psapi.h></span></div> +<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="preprocessor">#include <TlHelp32.h></span></div> +<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="preprocessor">#include <Userenv.h></span></div> <div class="line"><a name="l00051"></a><span class="lineno"> 51</span> </div> -<div class="line"><a name="l00052"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e"> 52</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<OSVERSIONINFOEXW></a> <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>()</div> -<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> {</div> -<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>;</div> -<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  os_version.dwOSVersionInfoSize = <span class="keyword">sizeof</span>(<a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>);</div> -<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  <span class="keywordflow">if</span> (!::GetVersionExW(reinterpret_cast<LPOSVERSIONINFO>(&os_version))) {</div> -<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div> -<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="stringliteral">"os::internal::os_version: Call to `GetVersionEx` failed"</span>);</div> -<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  }</div> -<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div> -<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>;</div> -<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> }</div> +<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="keyword">namespace </span>os {</div> +<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="keyword">namespace </span>internal {</div> +<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div> +<div class="line"><a name="l00055"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e"> 55</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<OSVERSIONINFOEXW></a> <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>()</div> +<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> {</div> +<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>;</div> +<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  os_version.dwOSVersionInfoSize = <span class="keyword">sizeof</span>(<a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>);</div> +<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <span class="keywordflow">if</span> (!::GetVersionExW(reinterpret_cast<LPOSVERSIONINFO>(&os_version))) {</div> +<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>(</div> +<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="stringliteral">"os::internal::os_version: Call to `GetVersionEx` failed"</span>);</div> +<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  }</div> <div class="line"><a name="l00063"></a><span class="lineno"> 63</span> </div> -<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> </div> -<div class="line"><a name="l00065"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a02c567b1b6bb441a3a29433a126cedec"> 65</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="l00066"></a><span class="lineno"> 66</span> {</div> -<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="comment">// MSDN documentation states "The names are established at system startup,</span></div> -<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <span class="comment">// when the system reads them from the registry." This is akin to the</span></div> -<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="comment">// Linux `gethostname` which calls `uname`, thus avoiding a DNS lookup.</span></div> -<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <span class="comment">// The `net::getHostname` function can be used for an explicit DNS lookup.</span></div> -<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="comment">// NOTE: This returns the hostname of the local computer, or the local</span></div> -<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <span class="comment">// node if this computer is part of a cluster.</span></div> -<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  COMPUTER_NAME_FORMAT <a class="code" href="namespacestrings_1_1internal.html#a870e2db270d980f83de20525ec414d2a">format</a> = ComputerNamePhysicalDnsHostname;</div> -<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  DWORD <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a> = 0;</div> -<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="keywordflow">if</span> (::GetComputerNameExW(format, <span class="keyword">nullptr</span>, &size) == 0) {</div> -<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keywordflow">if</span> (GetLastError() != ERROR_MORE_DATA) {</div> -<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</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>  }</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>  std::vector<wchar_t> buffer;</div> -<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  buffer.reserve(size);</div> +<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>;</div> +<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> }</div> +<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> </div> +<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> </div> +<div class="line"><a name="l00068"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a02c567b1b6bb441a3a29433a126cedec"> 68</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="l00069"></a><span class="lineno"> 69</span> {</div> +<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <span class="comment">// MSDN documentation states "The names are established at system startup,</span></div> +<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="comment">// when the system reads them from the registry." This is akin to the</span></div> +<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="comment">// Linux `gethostname` which calls `uname`, thus avoiding a DNS lookup.</span></div> +<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <span class="comment">// The `net::getHostname` function can be used for an explicit DNS lookup.</span></div> +<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <span class="comment">//</span></div> +<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="comment">// NOTE: This returns the hostname of the local computer, or the local</span></div> +<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="comment">// node if this computer is part of a cluster.</span></div> +<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  COMPUTER_NAME_FORMAT <a class="code" href="namespacestrings_1_1internal.html#a870e2db270d980f83de20525ec414d2a">format</a> = ComputerNamePhysicalDnsHostname;</div> +<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  DWORD <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a> = 0;</div> +<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keywordflow">if</span> (::GetComputerNameExW(format, <span class="keyword">nullptr</span>, &size) == 0) {</div> +<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <span class="keywordflow">if</span> (GetLastError() != ERROR_MORE_DATA) {</div> +<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</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>  }</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>  <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="l00086"></a><span class="lineno"> 86</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div> -<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  }</div> -<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> </div> -<div class="line"><a name="l00089"></a><span class="lineno"> 89</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="l00090"></a><span class="lineno"> 90</span> }</div> +<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  std::vector<wchar_t> buffer;</div> +<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  buffer.reserve(size);</div> +<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div> +<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="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="l00089"></a><span class="lineno"> 89</span>  <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div> +<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  }</div> <div class="line"><a name="l00091"></a><span class="lineno"> 91</span> </div> -<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> </div> -<div class="line"><a name="l00093"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a9dedf4c97a863505b3cccfa298b40f21"> 93</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a9dedf4c97a863505b3cccfa298b40f21">machine</a>()</div> -<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> {</div> -<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  SYSTEM_INFO system_info;</div> -<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  ::GetNativeSystemInfo(&system_info);</div> -<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> </div> -<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="keywordflow">switch</span> (system_info.wProcessorArchitecture) {</div> -<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_AMD64:</div> -<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="keywordflow">return</span> <span class="stringliteral">"AMD64"</span>;</div> -<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_ARM:</div> -<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="keywordflow">return</span> <span class="stringliteral">"ARM"</span>;</div> -<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_IA64:</div> -<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">return</span> <span class="stringliteral">"IA64"</span>;</div> -<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_INTEL:</div> -<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="keywordflow">return</span> <span class="stringliteral">"x86"</span>;</div> -<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="keywordflow">default</span>:</div> -<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordflow">return</span> <span class="stringliteral">"Unknown"</span>;</div> -<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  }</div> -<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> }</div> -<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> </div> -<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> </div> -<div class="line"><a name="l00113"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a8b5c098f8cba7112737a263e5a36a5f5"> 113</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a8b5c098f8cba7112737a263e5a36a5f5">sysname</a>(OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>)</div> -<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> {</div> -<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="keywordflow">switch</span> (os_version.wProductType) {</div> -<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="keywordflow">case</span> VER_NT_DOMAIN_CONTROLLER:</div> -<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="keywordflow">case</span> VER_NT_SERVER:</div> -<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="keywordflow">return</span> <span class="stringliteral">"Windows Server"</span>;</div> -<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="keywordflow">default</span>:</div> -<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="keywordflow">return</span> <span class="stringliteral">"Windows"</span>;</div> -<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  }</div> -<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> }</div> -<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> </div> -<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> </div> -<div class="line"><a name="l00125"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a4d26540f62137132c011bfe7076ea99f"> 125</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a4d26540f62137132c011bfe7076ea99f">release</a>(OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>)</div> -<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> {</div> -<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="keywordflow">return</span> <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(</div> -<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <a class="code" href="structVersion.html">Version</a>(os_version.dwMajorVersion, os_version.dwMinorVersion, 0));</div> -<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> }</div> -<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> </div> -<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div> -<div class="line"><a name="l00132"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835"> 132</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835">version</a>(OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>)</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>  std::string <a class="code" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835">version</a> = std::to_string(os_version.dwBuildNumber);</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">if</span> (os_version.szCSDVersion[0] != L<span class="charliteral">'\0'</span>) {</div> -<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  version.append(<span class="stringliteral">" "</span>);</div> -<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  version.append(<a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(os_version.szCSDVersion));</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> </div> -<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835">version</a>;</div> -<div class="line"><a name="l00142"></a><span class="lineno"> 142</span> }</div> +<div class="line"><a name="l00092"></a><span class="lineno"> 92</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="l00093"></a><span class="lineno"> 93</span> }</div> +<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> </div> +<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> </div> +<div class="line"><a name="l00096"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a9dedf4c97a863505b3cccfa298b40f21"> 96</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a9dedf4c97a863505b3cccfa298b40f21">machine</a>()</div> +<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> {</div> +<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  SYSTEM_INFO system_info;</div> +<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  ::GetNativeSystemInfo(&system_info);</div> +<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div> +<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keywordflow">switch</span> (system_info.wProcessorArchitecture) {</div> +<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_AMD64:</div> +<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="keywordflow">return</span> <span class="stringliteral">"AMD64"</span>;</div> +<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_ARM:</div> +<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="keywordflow">return</span> <span class="stringliteral">"ARM"</span>;</div> +<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_IA64:</div> +<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="keywordflow">return</span> <span class="stringliteral">"IA64"</span>;</div> +<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordflow">case</span> PROCESSOR_ARCHITECTURE_INTEL:</div> +<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  <span class="keywordflow">return</span> <span class="stringliteral">"x86"</span>;</div> +<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="keywordflow">default</span>:</div> +<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  <span class="keywordflow">return</span> <span class="stringliteral">"Unknown"</span>;</div> +<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  }</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> </div> +<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div> +<div class="line"><a name="l00116"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a8b5c098f8cba7112737a263e5a36a5f5"> 116</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a8b5c098f8cba7112737a263e5a36a5f5">sysname</a>(OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>)</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>  <span class="keywordflow">switch</span> (os_version.wProductType) {</div> +<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="keywordflow">case</span> VER_NT_DOMAIN_CONTROLLER:</div> +<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="keywordflow">case</span> VER_NT_SERVER:</div> +<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <span class="keywordflow">return</span> <span class="stringliteral">"Windows Server"</span>;</div> +<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="keywordflow">default</span>:</div> +<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="keywordflow">return</span> <span class="stringliteral">"Windows"</span>;</div> +<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  }</div> +<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> }</div> +<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> </div> +<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> </div> +<div class="line"><a name="l00128"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a4d26540f62137132c011bfe7076ea99f"> 128</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a4d26540f62137132c011bfe7076ea99f">release</a>(OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>)</div> +<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> {</div> +<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="keywordflow">return</span> <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(</div> +<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <a class="code" href="structVersion.html">Version</a>(os_version.dwMajorVersion, os_version.dwMinorVersion, 0));</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> </div> +<div class="line"><a name="l00135"></a><span class="lineno"><a class="line" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835"> 135</a></span> <span class="keyword">inline</span> std::string <a class="code" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835">version</a>(OSVERSIONINFOEXW <a class="code" href="namespaceos_1_1internal.html#a9fa879fd2d953386a2472e612cf99d0e">os_version</a>)</div> +<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> {</div> +<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  std::string <a class="code" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835">version</a> = std::to_string(os_version.dwBuildNumber);</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>  <span class="keywordflow">if</span> (os_version.szCSDVersion[0] != L<span class="charliteral">'\0'</span>) {</div> +<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  version.append(<span class="stringliteral">" "</span>);</div> +<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  version.append(<a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(os_version.szCSDVersion));</div> +<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  }</div> <div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div> -<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> } <span class="comment">// namespace internal {</span></div> -<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div> +<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos_1_1internal.html#a04a1a24433409d4181f799198af5d835">version</a>;</div> +<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> }</div> <div class="line"><a name="l00146"></a><span class="lineno"> 146</span> </div> -<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="comment">// Overload of os::pids for filtering by groups and sessions. A group / session</span></div> -<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment">// id of 0 will fitler on the group / session ID of the calling process.</span></div> -<div class="line"><a name="l00149"></a><span class="lineno"> 149</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="l00150"></a><span class="lineno"> 150</span> <span class="comment">// enumerate all processes.</span></div> -<div class="line"><a name="l00151"></a><span class="lineno"> 151</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="l00152"></a><span class="lineno"> 152</span> {</div> -<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  DWORD max_items = 4096;</div> -<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  DWORD bytes_returned;</div> -<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  std::vector<pid_t> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>;</div> -<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordtype">size_t</span> size_in_bytes;</div> -<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> </div> -<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <span class="comment">// Attempt to populate `processes` with PIDs. We repeatedly call</span></div> -<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// `EnumProcesses` with increasingly large arrays until it "succeeds" at</span></div> -<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">// populating the array with PIDs. The criteria for determining when</span></div> -<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="comment">// `EnumProcesses` has succeeded are:</span></div> -<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// (1) the return value is nonzero.</span></div> -<div class="line"><a name="l00163"></a><span class="lineno"> 163</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="l00164"></a><span class="lineno"> 164</span>  <span class="keywordflow">do</span> {</div> -<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="comment">// TODO(alexnaparu): Set a limit to the memory that can be used.</span></div> -<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  processes.resize(max_items);</div> -<div class="line"><a name="l00167"></a><span class="lineno"> 167</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="l00168"></a><span class="lineno"> 168</span>  CHECK_LE(size_in_bytes, MAXDWORD);</div> -<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> </div> -<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  BOOL result = ::EnumProcesses(</div> -<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  processes.data(),</div> -<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="keyword">static_cast<</span>DWORD<span class="keyword">></span>(size_in_bytes),</div> -<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  &bytes_returned);</div> -<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> </div> -<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="keywordflow">if</span> (!result) {</div> -<div class="line"><a name="l00176"></a><span class="lineno"> 176</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="l00177"></a><span class="lineno"> 177</span>  }</div> -<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> </div> -<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  max_items *= 2;</div> -<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  } <span class="keywordflow">while</span> (bytes_returned >= size_in_bytes);</div> +<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> } <span class="comment">// namespace internal {</span></div> +<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> </div> +<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> </div> +<div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span class="comment">// Overload of os::pids for filtering by groups and sessions. A group / session</span></div> +<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="comment">// id of 0 will fitler on the group / session ID of the calling process.</span></div> +<div class="line"><a name="l00152"></a><span class="lineno"> 152</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="l00153"></a><span class="lineno"> 153</span> <span class="comment">// enumerate all processes.</span></div> +<div class="line"><a name="l00154"></a><span class="lineno"> 154</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="l00155"></a><span class="lineno"> 155</span> {</div> +<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  DWORD max_items = 4096;</div> +<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  DWORD bytes_returned;</div> +<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  std::vector<pid_t> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>;</div> +<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keywordtype">size_t</span> size_in_bytes;</div> +<div class="line"><a name="l00160"></a><span class="lineno"> 160</span> </div> +<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="comment">// Attempt to populate `processes` with PIDs. We repeatedly call</span></div> +<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// `EnumProcesses` with increasingly large arrays until it "succeeds" at</span></div> +<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="comment">// populating the array with PIDs. The criteria for determining when</span></div> +<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="comment">// `EnumProcesses` has succeeded are:</span></div> +<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="comment">// (1) the return value is nonzero.</span></div> +<div class="line"><a name="l00166"></a><span class="lineno"> 166</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="l00167"></a><span class="lineno"> 167</span>  <span class="keywordflow">do</span> {</div> +<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="comment">// TODO(alexnaparu): Set a limit to the memory that can be used.</span></div> +<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  processes.resize(max_items);</div> +<div class="line"><a name="l00170"></a><span class="lineno"> 170</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="l00171"></a><span class="lineno"> 171</span>  CHECK_LE(size_in_bytes, MAXDWORD);</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>  BOOL result = ::EnumProcesses(</div> +<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  processes.data(),</div> +<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="keyword">static_cast<</span>DWORD<span class="keyword">></span>(size_in_bytes),</div> +<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  &bytes_returned);</div> +<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> </div> +<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="keywordflow">if</span> (!result) {</div> +<div class="line"><a name="l00179"></a><span class="lineno"> 179</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="l00180"></a><span class="lineno"> 180</span>  }</div> <div class="line"><a name="l00181"></a><span class="lineno"> 181</span> </div> -<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  std::set<pid_t> pids_set(processes.begin(), processes.end());</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>  <span class="comment">// NOTE: The PID `0` will always be returned by `EnumProcesses`; however, it</span></div> -<div class="line"><a name="l00185"></a><span class="lineno"> 185</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="l00186"></a><span class="lineno"> 186</span>  <span class="comment">// it for anything is almost always invalid. For instance, `OpenProcess` will</span></div> -<div class="line"><a name="l00187"></a><span class="lineno"> 187</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="l00188"></a><span class="lineno"> 188</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="l00189"></a><span class="lineno"> 189</span>  <span class="comment">// including the PID `0`.</span></div> -<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  pids_set.erase(0);</div> -<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keywordflow">return</span> pids_set;</div> -<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> }</div> -<div class="line"><a name="l00193"></a><span class="lineno"> 193</span> </div> -<div class="line"><a name="l00194"></a><span class="lineno"> 194</span> </div> -<div class="line"><a name="l00195"></a><span class="lineno"> 195</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="l00196"></a><span class="lineno"> 196</span> {</div> -<div class="line"><a name="l00197"></a><span class="lineno"> 197</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="l00198"></a><span class="lineno"> 198</span> }</div> -<div class="line"><a name="l00199"></a><span class="lineno"> 199</span> </div> -<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> </div> -<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="comment">// Sets the value associated with the specified key in the set of</span></div> -<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <span class="comment">// environment variables.</span></div> -<div class="line"><a name="l00203"></a><span class="lineno"> 203</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="l00204"></a><span class="lineno"> 204</span>  <span class="keyword">const</span> std::string& key,</div> -<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keyword">const</span> std::string& value,</div> -<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keywordtype">bool</span> overwrite = <span class="keyword">true</span>)</div> -<div class="line"><a name="l00207"></a><span class="lineno"> 207</span> {</div> -<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="comment">// Do not set the variable if already set and `overwrite` was not specified.</span></div> -<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="comment">// Per MSDN[1], `GetEnvironmentVariable` returns 0 on error and sets the</span></div> -<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="comment">// error code to `ERROR_ENVVAR_NOT_FOUND` if the variable was not found.</span></div> +<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  max_items *= 2;</div> +<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  } <span class="keywordflow">while</span> (bytes_returned >= size_in_bytes);</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>  std::set<pid_t> pids_set(processes.begin(), processes.end());</div> +<div class="line"><a name="l00186"></a><span class="lineno"> 186</span> </div> +<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="comment">// NOTE: The PID `0` will always be returned by `EnumProcesses`; however, it</span></div> +<div class="line"><a name="l00188"></a><span class="lineno"> 188</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="l00189"></a><span class="lineno"> 189</span>  <span class="comment">// it for anything is almost always invalid. For instance, `OpenProcess` will</span></div> +<div class="line"><a name="l00190"></a><span class="lineno"> 190</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="l00191"></a><span class="lineno"> 191</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="l00192"></a><span class="lineno"> 192</span>  <span class="comment">// including the PID `0`.</span></div> +<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  pids_set.erase(0);</div> +<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="keywordflow">return</span> pids_set;</div> +<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> }</div> +<div class="line"><a name="l00196"></a><span class="lineno"> 196</span> </div> +<div class="line"><a name="l00197"></a><span class="lineno"> 197</span> </div> +<div class="line"><a name="l00198"></a><span class="lineno"> 198</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="l00199"></a><span class="lineno"> 199</span> {</div> +<div class="line"><a name="l00200"></a><span class="lineno"> 200</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="l00201"></a><span class="lineno"> 201</span> }</div> +<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> </div> +<div class="line"><a name="l00203"></a><span class="lineno"> 203</span> </div> +<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// Sets the value associated with the specified key in the set of</span></div> +<div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment">// environment variables.</span></div> +<div class="line"><a name="l00206"></a><span class="lineno"> 206</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="l00207"></a><span class="lineno"> 207</span>  <span class="keyword">const</span> std::string& key,</div> +<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="keyword">const</span> std::string& value,</div> +<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keywordtype">bool</span> overwrite = <span class="keyword">true</span>)</div> +<div class="line"><a name="l00210"></a><span class="lineno"> 210</span> {</div> +<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="comment">// Do not set the variable if already set and `overwrite` was not specified.</span></div> <div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="comment">// [1] https://msdn.microsoft.com/en-us/library/windows/desktop/ms683188(v=vs.85).aspx</span></div> -<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="keywordflow">if</span> (!overwrite &&</div> -<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  ::GetEnvironmentVariableW(wide_stringify(key).data(), <span class="keyword">nullptr</span>, 0) != 0 &&</div> -<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  ::GetLastError() == ERROR_ENVVAR_NOT_FOUND) {</div> -<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="keywordflow">return</span>;</div> -<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  }</div> -<div class="line"><a name="l00219"></a><span class="lineno"> 219</span> </div> -<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="comment">// `SetEnvironmentVariable` returns an error code, but we can't act on it.</span></div> -<div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  ::SetEnvironmentVariableW(</div> -<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  wide_stringify(key).data(), wide_stringify(value).data());</div> -<div class="line"><a name="l00223"></a><span class="lineno"> 223</span> }</div> -<div class="line"><a name="l00224"></a><span class="lineno"> 224</span> </div> -<div class="line"><a name="l00225"></a><span class="lineno"> 225</span> </div> -<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> <span class="comment">// Unsets the value associated with the specified key in the set of</span></div> -<div class="line"><a name="l00227"></a><span class="lineno"> 227</span> <span class="comment">// environment variables.</span></div> -<div class="line"><a name="l00228"></a><span class="lineno"> 228</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="l00229"></a><span class="lineno"> 229</span> {</div> -<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <span class="comment">// Per MSDN documentation[1], passing `nullptr` as the value will cause</span></div> -<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="comment">// `SetEnvironmentVariable` to delete the key from the process's environment.</span></div> -<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  ::SetEnvironmentVariableW(wide_stringify(key).data(), <span class="keyword">nullptr</span>);</div> -<div class="line"><a name="l00233"></a><span class="lineno"> 233</span> }</div> -<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> </div> -<div class="line"><a name="l00235"></a><span class="lineno"> 235</span> </div> -<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> <span class="comment">// Suspends execution of the calling process until a child specified by `pid`</span></div> -<div class="line"><a name="l00237"></a><span class="lineno"> 237</span> <span class="comment">// has changed state. Unlike the POSIX standard function `::waitpid`, this</span></div> -<div class="line"><a name="l00238"></a><span class="lineno"> 238</span> <span class="comment">// function does not use -1 and 0 to signify errors and nonblocking return.</span></div> -<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="comment">// Instead, we return `Result<pid_t>`:</span></div> -<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment">// * In case of error, we return `Error` rather than -1. For example, we</span></div> -<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="comment">// would return an `Error` in case of `EINVAL`.</span></div> -<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> <span class="comment">// * In case of nonblocking return, we return `None` rather than 0. For</span></div> -<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="comment">// example, if we pass `WNOHANG` in the `options`, we would expect 0 to be</span></div> -<div class="line"><a name="l00244"></a><span class="lineno"> 244</span> <span class="comment">// returned in the case that children specified by `pid` exist, but have</span></div> -<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> <span class="comment">// not changed state yet. In this case we return `None` instead.</span></div> -<div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="comment">//</span></div> -<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="comment">// NOTE: There are important differences between the POSIX and Windows</span></div> -<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <span class="comment">// implementations of this function:</span></div> -<div class="line"><a name="l00249"></a><span class="lineno"> 249</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="l00250"></a><span class="lineno"> 250</span> <span class="comment">// which is `unsigned long`. Thus, if we use `DWORD` to represent the `pid`</span></div> -<div class="line"><a name="l00251"></a><span class="lineno"> 251</span> <span class="comment">// argument, passing -1 as the `pid` would (on most modern servers)</span></div> -<div class="line"><a name="l00252"></a><span class="lineno"> 252</span> <span class="comment">// silently convert to a really large `pid`. This is undesirable.</span></div> -<div class="line"><a name="l00253"></a><span class="lineno"> 253</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="l00254"></a><span class="lineno"> 254</span> <span class="comment">// `os::waitpid`, as a matter of practicality, we choose to:</span></div> -<div class="line"><a name="l00255"></a><span class="lineno"> 255</span> <span class="comment">// (1) Use `long` to represent the `pid` argument.</span></div> -<div class="line"><a name="l00256"></a><span class="lineno"> 256</span> <span class="comment">// (2) Disable using any value <= 0 for `pid` on Windows.</span></div> -<div class="line"><a name="l00257"></a><span class="lineno"> 257</span> <span class="comment">// * This decision is pragmatic. The reasoning is:</span></div> -<div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="comment">// (1) The Windows code paths call `os::waitpid` in only a handful of</span></div> -<div class="line"><a name="l00259"></a><span class="lineno"> 259</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="l00260"></a><span class="lineno"> 260</span> <span class="comment">// (2) Since PIDs virtually never take on values outside the range of</span></div> -<div class="line"><a name="l00261"></a><span class="lineno"> 261</span> <span class="comment">// vanilla signed `long` it is likely that an accidental conversion</span></div> -<div class="line"><a name="l00262"></a><span class="lineno"> 262</span> <span class="comment">// will never happen.</span></div> -<div class="line"><a name="l00263"></a><span class="lineno"> 263</span> <span class="comment">// (3) Even though it is not formalized in the C specification, the</span></div> -<div class="line"><a name="l00264"></a><span class="lineno"> 264</span> <span class="comment">// implementation of `long` on the vast majority of production servers</span></div> -<div class="line"><a name="l00265"></a><span class="lineno"> 265</span> <span class="comment">// is 2's complement, so we expect that when we accidentally do</span></div> -<div class="line"><a name="l00266"></a><span class="lineno"> 266</span> <span class="comment">// implicitly convert from `unsigned long` to `long`, we will "wrap</span></div> -<div class="line"><a name="l00267"></a><span class="lineno"> 267</span> <span class="comment">// around" to negative values. And since we've disabled the negative</span></div> -<div class="line"><a name="l00268"></a><span class="lineno"> 268</span> <span class="comment">// `pid` in the Windows implementation, we should error out.</span></div> -<div class="line"><a name="l00269"></a><span class="lineno"> 269</span> <span class="comment">// * Finally, on Windows, we currently do not check that the process we are</span></div> -<div class="line"><a name="l00270"></a><span class="lineno"> 270</span> <span class="comment">// attempting to await is a child process.</span></div> -<div class="line"><a name="l00271"></a><span class="lineno"><a class="line" href="namespaceos.html#a59caf358baf81de389c29d983b8e21ad"> 271</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="l00272"></a><span class="lineno"> 272</span> {</div> -<div class="line"><a name="l00273"></a><span class="lineno"> 273</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="l00274"></a><span class="lineno"> 274</span> </div> -<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  <span class="comment">// NOTE: Windows does not implement pids <= 0.</span></div> -<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <span class="keywordflow">if</span> (pid <= 0) {</div> -<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  errno = ENOSYS;</div> -<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div> -<div class="line"><a name="l00279"></a><span class="lineno"> 279</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="l00280"></a><span class="lineno"> 280</span>  <span class="stringliteral">"'; the Windows implementation currently does not allow values <= 0"</span>);</div> -<div class="line"><a name="l00281"></a><span class="lineno"> 281</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="l00282"></a><span class="lineno"> 282</span>  <span class="comment">// NOTE: We only support `options == 0` or `options == WNOHANG`. On Windows</span></div> -<div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  <span class="comment">// no flags other than `WNOHANG` are supported.</span></div> -<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  errno = ENOSYS;</div> -<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div> -<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="stringliteral">"os::waitpid: Only flag `WNOHANG` is implemented on Windows"</span>);</div> -<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  }</div> -<div class="line"><a name="l00288"></a><span class="lineno"> 288</span> </div> -<div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  <span class="comment">// TODO(hausdorff): Check that `pid` is one of the child processes. If not,</span></div> -<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <span class="comment">// set `errno` to `ECHILD` and return -1.</span></div> +<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="comment">// Per MSDN[1], `GetEnvironmentVariable` returns 0 on error and sets the</span></div> +<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="comment">// error code to `ERROR_ENVVAR_NOT_FOUND` if the variable was not found.</span></div> +<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="comment">//</span></div> +<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="comment">// [1] https://msdn.microsoft.com/en-us/library/windows/desktop/ms683188(v=vs.85).aspx</span></div> +<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="keywordflow">if</span> (!overwrite &&</div> +<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  ::GetEnvironmentVariableW(wide_stringify(key).data(), <span class="keyword">nullptr</span>, 0) != 0 &&</div> +<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  ::GetLastError() == ERROR_ENVVAR_NOT_FOUND) {</div> +<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keywordflow">return</span>;</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> </div> +<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  <span class="comment">// `SetEnvironmentVariable` returns an error code, but we can't act on it.</span></div> +<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  ::SetEnvironmentVariableW(</div> +<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  wide_stringify(key).data(), wide_stringify(value).data());</div> +<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> }</div> +<div class="line"><a name="l00227"></a><span class="lineno"> 227</span> </div> +<div class="line"><a name="l00228"></a><span class="lineno"> 228</span> </div> +<div class="line"><a name="l00229"></a><span class="lineno"> 229</span> <span class="comment">// Unsets the value associated with the specified key in the set of</span></div> +<div class="line"><a name="l00230"></a><span class="lineno"> 230</span> <span class="comment">// environment variables.</span></div> +<div class="line"><a name="l00231"></a><span class="lineno"> 231</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="l00232"></a><span class="lineno"> 232</span> {</div> +<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  <span class="comment">// Per MSDN documentation[1], passing `nullptr` as the value will cause</span></div> +<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="comment">// `SetEnvironmentVariable` to delete the key from the process's environment.</span></div> +<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  ::SetEnvironmentVariableW(wide_stringify(key).data(), <span class="keyword">nullptr</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> </div> +<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="comment">// Suspends execution of the calling process until a child specified by `pid`</span></div> +<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment">// has changed state. Unlike the POSIX standard function `::waitpid`, this</span></div> +<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="comment">// function does not use -1 and 0 to signify errors and nonblocking return.</span></div> +<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> <span class="comment">// Instead, we return `Result<pid_t>`:</span></div> +<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="comment">// * In case of error, we return `Error` rather than -1. For example, we</span></div> +<div class="line"><a name="l00244"></a><span class="lineno"> 244</span> <span class="comment">// would return an `Error` in case of `EINVAL`.</span></div> +<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> <span class="comment">// * In case of nonblocking return, we return `None` rather than 0. For</span></div> +<div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="comment">// example, if we pass `WNOHANG` in the `options`, we would expect 0 to be</span></div> +<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="comment">// returned in the case that children specified by `pid` exist, but have</span></div> +<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <span class="comment">// not changed state yet. In this case we return `None` instead.</span></div> +<div class="line"><a name="l00249"></a><span class="lineno"> 249</span> <span class="comment">//</span></div> +<div class="line"><a name="l00250"></a><span class="lineno"> 250</span> <span class="comment">// NOTE: There are important differences between the POSIX and Windows</span></div> +<div class="line"><a name="l00251"></a><span class="lineno"> 251</span> <span class="comment">// implementations of this function:</span></div> +<div class="line"><a name="l00252"></a><span class="lineno"> 252</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="l00253"></a><span class="lineno"> 253</span> <span class="comment">// which is `unsigned long`. Thus, if we use `DWORD` to represent the `pid`</span></div> +<div class="line"><a name="l00254"></a><span class="lineno"> 254</span> <span class="comment">// argument, passing -1 as the `pid` would (on most modern servers)</span></div> +<div class="line"><a name="l00255"></a><span class="lineno"> 255</span> <span class="comment">// silently convert to a really large `pid`. This is undesirable.</span></div> +<div class="line"><a name="l00256"></a><span class="lineno"> 256</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="l00257"></a><span class="lineno"> 257</span> <span class="comment">// `os::waitpid`, as a matter of practicality, we choose to:</span></div> +<div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="comment">// (1) Use `long` to represent the `pid` argument.</span></div> +<div class="line"><a name="l00259"></a><span class="lineno"> 259</span> <span class="comment">// (2) Disable using any value <= 0 for `pid` on Windows.</span></div> +<div class="line"><a name="l00260"></a><span class="lineno"> 260</span> <span class="comment">// * This decision is pragmatic. The reasoning is:</span></div> +<div class="line"><a name="l00261"></a><span class="lineno"> 261</span> <span class="comment">// (1) The Windows code paths call `os::waitpid` in only a handful of</span></div> +<div class="line"><a name="l00262"></a><span class="lineno"> 262</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="l00263"></a><span class="lineno"> 263</span> <span class="comment">// (2) Since PIDs virtually never take on values outside the range of</span></div> +<div class="line"><a name="l00264"></a><span class="lineno"> 264</span> <span class="comment">// vanilla signed `long` it is likely that an accidental conversion</span></div> +<div class="line"><a name="l00265"></a><span class="lineno"> 265</span> <span class="comment">// will never happen.</span></div> +<div class="line"><a name="l00266"></a><span class="lineno"> 266</span> <span class="comment">// (3) Even though it is not formalized in the C specification, the</span></div> +<div class="line"><a name="l00267"></a><span class="lineno"> 267</span> <span class="comment">// implementation of `long` on the vast majority of production servers</span></div> +<div class="line"><a name="l00268"></a><span class="lineno"> 268</span> <span class="comment">// is 2's complement, so we expect that when we accidentally do</span></div> +<div class="line"><a name="l00269"></a><span class="lineno"> 269</span> <span class="comment">// implicitly convert from `unsigned long` to `long`, we will "wrap</span></div> +<div class="line"><a name="l00270"></a><span class="lineno"> 270</span> <span class="comment">// around" to negative values. And since we've disabled the negative</span></div> +<div class="line"><a name="l00271"></a><span class="lineno"> 271</span> <span class="comment">// `pid` in the Windows implementation, we should error out.</span></div> +<div class="line"><a name="l00272"></a><span class="lineno"> 272</span> <span class="comment">// * Finally, on Windows, we currently do not check that the process we are</span></div> +<div class="line"><a name="l00273"></a><span class="lineno"> 273</span> <span class="comment">// attempting to await is a child process.</span></div> +<div class="line"><a name="l00274"></a><span class="lineno"><a class="line" href="namespaceos.html#a59caf358baf81de389c29d983b8e21ad"> 274</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="l00275"></a><span class="lineno"> 275</span> {</div> +<div class="line"><a name="l00276"></a><span class="lineno"> 276</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="l00277"></a><span class="lineno"> 277</span> </div> +<div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="comment">// NOTE: Windows does not implement pids <= 0.</span></div> +<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <span class="keywordflow">if</span> (pid <= 0) {</div> +<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  errno = ENOSYS;</div> +<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div> +<div class="line"><a name="l00282"></a><span class="lineno"> 282</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="l00283"></a><span class="lineno"> 283</span>  <span class="stringliteral">"'; the Windows implementation currently does not allow values <= 0"</span>);</div> +<div class="line"><a name="l00284"></a><span class="lineno"> 284</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="l00285"></a><span class="lineno"> 285</span>  <span class="comment">// NOTE: We only support `options == 0` or `options == WNOHANG`. On Windows</span></div> +<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="comment">// no flags other than `WNOHANG` are supported.</span></div> +<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  errno = ENOSYS;</div> +<div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div> +<div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  <span class="stringliteral">"os::waitpid: Only flag `WNOHANG` is implemented on Windows"</span>);</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">// Open the child process as a safe `SharedHandle`.</span></div> -<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="keyword">const</span> <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a> = ::OpenProcess(</div> -<div class
<TRUNCATED>
