mesos-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From git-site-r...@apache.org
Subject [42/51] [partial] mesos-site git commit: Updated the website built from mesos SHA: d724747.
Date Fri, 28 Jul 2017 16:06:31 GMT
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/ba48e30e/content/api/latest/c++/3rdparty_2stout_2include_2stout_2windows_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/3rdparty_2stout_2include_2stout_2windows_8hpp_source.html b/content/api/latest/c++/3rdparty_2stout_2include_2stout_2windows_8hpp_source.html
index ea002d2..35caa8e 100644
--- a/content/api/latest/c++/3rdparty_2stout_2include_2stout_2windows_8hpp_source.html
+++ b/content/api/latest/c++/3rdparty_2stout_2include_2stout_2windows_8hpp_source.html
@@ -90,489 +90,427 @@
 <div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="preprocessor">#include &lt;glog/logging.h&gt;</span></div>
 <div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;</div>
 <div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;</div>
-<div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;<span class="preprocessor">#ifdef _UNICODE</span></div>
-<div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="preprocessor"></span><span class="comment">// Much of the core Windows API is available both in `string` and `wstring`</span></div>
+<div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;<span class="preprocessor">#if !defined(_UNICODE) || !defined(UNICODE)</span></div>
+<div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="preprocessor"></span><span class="comment">// Much of the Windows API is available both in `string` and `wstring`</span></div>
 <div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;<span class="comment">// varieties. To avoid polluting the namespace with two versions of every</span></div>
 <div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;<span class="comment">// function, a common pattern in the Windows headers is to offer a single macro</span></div>
 <div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;<span class="comment">// that expands to the `string` or `wstring` version, depending on whether the</span></div>
-<div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;<span class="comment">// `_UNICODE` preprocessor symbol is set. For example, `GetMessage` will expand</span></div>
-<div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;<span class="comment">// to either `GetMessageA` (the `string` version) or `GetMessageW` (the</span></div>
-<div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="comment">// `wstring` version) depending on whether this symbol is defined.</span></div>
-<div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;<span class="comment">// The downside of this is that it makes POSIX interop really hard. Hence, we</span></div>
-<div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;<span class="comment">// refuse to compile if such a symbol is passed in during compilation.</span></div>
-<div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;<span class="preprocessor">#error &quot;Mesos doesn&#39;t currently support the `_UNICODE` Windows header constant&quot;</span></div>
-<div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#endif // _UNICODE</span></div>
-<div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;<span class="comment">// An RAII `HANDLE`.</span></div>
-<div class="line"><a name="l00054"></a><span class="lineno"><a class="line" href="classSharedHandle.html">   54</a></span>&#160;<span class="keyword">class </span><a class="code" href="classSharedHandle.html">SharedHandle</a> : <span class="keyword">public</span> std::shared_ptr&lt;void&gt;</div>
-<div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;{</div>
-<div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;  static_assert(std::is_same&lt;HANDLE, void*&gt;::value,</div>
-<div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;                <span class="stringliteral">&quot;Expected `HANDLE` to be of type `void*`.&quot;</span>);</div>
-<div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;</div>
-<div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;<span class="keyword">public</span>:</div>
-<div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;  <span class="comment">// We delete the default constructor so that the callsite is forced to make</span></div>
-<div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;  <span class="comment">// an explicit decision about what the empty `HANDLE` value should be, as it</span></div>
-<div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;  <span class="comment">// is not the same for all `HANDLE` types.  For example, `OpenProcess`</span></div>
-<div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;  <span class="comment">// returns a `nullptr` for an invalid handle, but `CreateFile` returns an</span></div>
-<div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;  <span class="comment">// `INVALID_HANDLE_VALUE` instead. This inconsistency is inherent in the</span></div>
-<div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;  <span class="comment">// Windows API.</span></div>
-<div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;  <a class="code" href="classSharedHandle.html#ad2cfca1ab3db9839e617b569b225e0c0">SharedHandle</a>() = <span class="keyword">delete</span>;</div>
-<div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;</div>
-<div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Deleter&gt;</div>
-<div class="line"><a name="l00069"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a67dea37bc1c958578f992ccc40a40899">   69</a></span>&#160;  <a class="code" href="classSharedHandle.html#a67dea37bc1c958578f992ccc40a40899">SharedHandle</a>(<a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> handle, Deleter deleter)</div>
-<div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;      : std::shared_ptr&lt;void&gt;(handle, deleter) {}</div>
-<div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;</div>
-<div class="line"><a name="l00072"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa">   72</a></span>&#160;  <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> <a class="code" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa">get_handle</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> this-&gt;<span class="keyword">get</span>(); }</div>
-<div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;};</div>
-<div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;</div>
-<div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;</div>
-<div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;<span class="comment">// Definitions and constants used for Windows compat.</span></div>
-<div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;<span class="comment">// Gathers most of the Windows-compatibility definitions.  This makes it</span></div>
-<div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;<span class="comment">// possible for files throughout the codebase to remain relatively free of all</span></div>
-<div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;<span class="comment">// the #if&#39;s we&#39;d need to make them work.</span></div>
-<div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;<span class="comment">// Roughly, the things that should go in this file are definitions and</span></div>
-<div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;<span class="comment">// declarations that one would not mind being:</span></div>
-<div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;<span class="comment">//   * in global scope.</span></div>
-<div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;<span class="comment">//   * globally available throughout both the Stout codebase, and any code</span></div>
-<div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;<span class="comment">//     that uses it (such as Mesos).</span></div>
-<div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;</div>
+<div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;<span class="comment">// `_UNICODE` and `UNICODE` preprocessor symbols are set. For example,</span></div>
+<div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;<span class="comment">// `GetMessage` will expand to either `GetMessageA` (the `string` version) or</span></div>
+<div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="comment">// `GetMessageW` (the `wstring` version) depending on whether these symbols are</span></div>
+<div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;<span class="comment">// defined.</span></div>
+<div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;<span class="comment">// Unfortunately the `string` version is not UTF-8, like a developer would</span></div>
+<div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;<span class="comment">// expect on Linux, but is instead the current Windows code page, and thus may</span></div>
+<div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;<span class="comment">// take a different value at runtime. This makes it potentially difficult to</span></div>
+<div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;<span class="comment">// decode, whereas the `wstring` version is always encoded as UTF-16, and thus</span></div>
+<div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;<span class="comment">// can be programatically converted to UTF-8 using the `stringify()` function</span></div>
+<div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;<span class="comment">// (converting UTF-8 to UTF-16 is done with `wide_stringify()`).</span></div>
+<div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;<span class="comment">// Furthermore, support for NTFS long paths requires the use of the `wstring`</span></div>
+<div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;<span class="comment">// APIs, coupled with the `\\?\` long path prefix marker for paths longer than</span></div>
+<div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;<span class="comment">// the max path limit. This is accomplished by wrapping paths sent to Windows</span></div>
+<div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;<span class="comment">// APIs with the `internal::windows::longpath()` helper. In order to prevent</span></div>
+<div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;<span class="comment">// future regressions, we enforce the definitions of `_UNICODE` and `UNICODE`.</span></div>
+<div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;<span class="comment">// NOTE: The Mesos code should always use the explicit `W` suffixed APIs in</span></div>
+<div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;<span class="comment">// order to avoid type ambiguity.</span></div>
+<div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;<span class="preprocessor">#error &quot;Mesos must be built with `_UNICODE` and `UNICODE` defined.&quot;</span></div>
+<div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;<span class="preprocessor"></span><span class="preprocessor">#endif // !defined(_UNICODE) || !defined(UNICODE)</span></div>
+<div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;<span class="comment">// An RAII `HANDLE`.</span></div>
+<div class="line"><a name="l00068"></a><span class="lineno"><a class="line" href="classSharedHandle.html">   68</a></span>&#160;<span class="keyword">class </span><a class="code" href="classSharedHandle.html">SharedHandle</a> : <span class="keyword">public</span> std::shared_ptr&lt;void&gt;</div>
+<div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;{</div>
+<div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;  static_assert(std::is_same&lt;HANDLE, void*&gt;::value,</div>
+<div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;                <span class="stringliteral">&quot;Expected `HANDLE` to be of type `void*`.&quot;</span>);</div>
+<div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;</div>
+<div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<span class="keyword">public</span>:</div>
+<div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;  <span class="comment">// We delete the default constructor so that the callsite is forced to make</span></div>
+<div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;  <span class="comment">// an explicit decision about what the empty `HANDLE` value should be, as it</span></div>
+<div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;  <span class="comment">// is not the same for all `HANDLE` types.  For example, `OpenProcess`</span></div>
+<div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;  <span class="comment">// returns a `nullptr` for an invalid handle, but `CreateFile` returns an</span></div>
+<div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;  <span class="comment">// `INVALID_HANDLE_VALUE` instead. This inconsistency is inherent in the</span></div>
+<div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;  <span class="comment">// Windows API.</span></div>
+<div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;  <a class="code" href="classSharedHandle.html#ad2cfca1ab3db9839e617b569b225e0c0">SharedHandle</a>() = <span class="keyword">delete</span>;</div>
+<div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;</div>
+<div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Deleter&gt;</div>
+<div class="line"><a name="l00083"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a67dea37bc1c958578f992ccc40a40899">   83</a></span>&#160;  <a class="code" href="classSharedHandle.html#a67dea37bc1c958578f992ccc40a40899">SharedHandle</a>(<a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> handle, Deleter deleter)</div>
+<div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;      : std::shared_ptr&lt;void&gt;(handle, deleter) {}</div>
+<div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;</div>
+<div class="line"><a name="l00086"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa">   86</a></span>&#160;  <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> <a class="code" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa">get_handle</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> this-&gt;<span class="keyword">get</span>(); }</div>
+<div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;};</div>
 <div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;</div>
-<div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;<span class="comment">// This code un-defines the global `GetMessage` macro defined by the Windows</span></div>
-<div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;<span class="comment">// headers, and replaces it with an inline function that is equivalent.</span></div>
+<div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;</div>
+<div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;<span class="comment">// Definitions and constants used for Windows compat.</span></div>
 <div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;<span class="comment">// There are two reasons for doing this. The first is because this macro</span></div>
-<div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;<span class="comment">// interferes with `google::protobufs::Reflection::GetMessage`. Replacing the</span></div>
-<div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;<span class="comment">// `GetMessage` macro with an inline function allows people calling the</span></div>
-<div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;<span class="comment">// `GetMessage` macro to carry on doing so with no code changes, but it will</span></div>
-<div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;<span class="comment">// also allow us to use `google::protobufs::Reflection::GetMessage` without</span></div>
-<div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;<span class="comment">// interference from the macro.</span></div>
-<div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;<span class="comment">// The second is because we don&#39;t want to obliterate the `GetMessage` macro for</span></div>
-<div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;<span class="comment">// people who include this header, either on purpose, or incidentally as part</span></div>
-<div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span class="comment">// of some other Mesos header. The effect is that our need to call protobuf&#39;s</span></div>
-<div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;<span class="comment">// `GetMessage` function has no deleterious effect on customers of this API.</span></div>
-<div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;<span class="comment">// NOTE: the Windows headers also don&#39;t use define-once semantics for the</span></div>
-<div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;<span class="comment">// `GetMessage` macro. In particular, this means that every time you include</span></div>
-<div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;<span class="comment">// `Winuser.h` and a `GetMessage` macro isn&#39;t defined, the Windows headers will</span></div>
-<div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;<span class="comment">// redefine it for you. The impact of this is that you should re-un-define the</span></div>
-<div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;<span class="comment">// macro every time you include `Windows.h`; since we should be including</span></div>
-<div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;<span class="comment">// `Windows.h` only from this file, we un-define it just after we include</span></div>
-<div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;<span class="comment">// `Windows.h`.</span></div>
-<div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;<span class="preprocessor">#ifdef GetMessage</span></div>
-<div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;<span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessageWindows(</div>
-<div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;    LPMSG lpMsg,</div>
-<div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;    HWND hWnd,</div>
-<div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;    UINT wMsgFilterMin,</div>
-<div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;    UINT wMsgFilterMax)</div>
-<div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;{</div>
-<div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;  <span class="keywordflow">return</span> GetMessage(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</div>
-<div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;}</div>
-<div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;<span class="preprocessor">#undef GetMessage</span></div>
-<div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;<span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessage(</div>
-<div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;    LPMSG lpMsg,</div>
-<div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;    HWND hWnd,</div>
-<div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;    UINT wMsgFilterMin,</div>
-<div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;    UINT wMsgFilterMax)</div>
-<div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;{</div>
-<div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;  <span class="keywordflow">return</span> GetMessageWindows(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</div>
-<div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;}</div>
-<div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;<span class="preprocessor">#endif // GetMessage</span></div>
-<div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;</div>
-<div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;<span class="comment">// Define constants used for Windows compat. Allows a lot of code on</span></div>
-<div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;<span class="comment">// Windows and POSIX systems to be the same, because we can pass the</span></div>
-<div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;<span class="comment">// same constants to functions we call to do things like file I/O.</span></div>
-<div class="line"><a name="l00135"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afcf80a6d91178952d107ad00b165752b">  135</a></span>&#160;<span class="preprocessor">#define STDIN_FILENO 0</span></div>
-<div class="line"><a name="l00136"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abd165ee6474b5b75bf075842fff13a04">  136</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define STDOUT_FILENO 1</span></div>
-<div class="line"><a name="l00137"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae2fe1725bb5e9823d089c46b9ed5266e">  137</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define STDERR_FILENO 2</span></div>
-<div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00139"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a24a7a0ceb1e8f5f44cb1038bb829030d">  139</a></span>&#160;<span class="preprocessor">#define R_OK 0x4</span></div>
-<div class="line"><a name="l00140"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae5acf4043c0903cda7436b108e29e8e6">  140</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define W_OK 0x2</span></div>
-<div class="line"><a name="l00141"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a5e995ef7690698b62bf016b14fbc45ca">  141</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define X_OK 0x0 // No such permission on Windows.</span></div>
-<div class="line"><a name="l00142"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#af837744613408b57dc3654fbc3bcf900">  142</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define F_OK 0x0</span></div>
-<div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00144"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a7a68c9ffaac7dbcd652225dd7c06a54b">  144</a></span>&#160;<span class="preprocessor">#define O_RDONLY _O_RDONLY</span></div>
-<div class="line"><a name="l00145"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a11b644a8526139c4cc1850dac1271ced">  145</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_WRONLY _O_WRONLY</span></div>
-<div class="line"><a name="l00146"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abb0586253488ee61072b73557eeb873b">  146</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_RDWR _O_RDWR</span></div>
-<div class="line"><a name="l00147"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1cf6b1de1fffedaa1d26b189e9a8d2cc">  147</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_CREAT _O_CREAT</span></div>
-<div class="line"><a name="l00148"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad1d67e453fb3031f40f8cd3403773813">  148</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_TRUNC _O_TRUNC</span></div>
-<div class="line"><a name="l00149"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae036f789407d21f07b211552d67b3214">  149</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_APPEND _O_APPEND</span></div>
-<div class="line"><a name="l00150"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad6d8fbe4e494b4dbe051612572d3f757">  150</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_CLOEXEC _O_NOINHERIT</span></div>
-<div class="line"><a name="l00151"></a><span class="lineno">  151</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00152"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afd80ecbe3170ca4fc85b65cda8659f82">  152</a></span>&#160;<span class="preprocessor">#define MAXHOSTNAMELEN NI_MAXHOST</span></div>
-<div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00154"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae688d728e1acdfe5988c7db45d6f0166">  154</a></span>&#160;<span class="preprocessor">#define PATH_MAX _MAX_PATH</span></div>
-<div class="line"><a name="l00155"></a><span class="lineno">  155</span>&#160;<span class="preprocessor"></span></div>
-<div class="line"><a name="l00156"></a><span class="lineno">  156</span>&#160;<span class="comment">// NOTE: for details on what this value should be, consult [1], [2], and [3].</span></div>
-<div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;<span class="comment">// [1] http://www.opensource.apple.com/source/gnumake/gnumake-119/make/w32/include/dirent.h</span></div>
-<div class="line"><a name="l00159"></a><span class="lineno">  159</span>&#160;<span class="comment">// [2] https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits</span></div>
-<div class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;<span class="comment">// [3] https://msdn.microsoft.com/en-us/library/930f87yf.aspx</span></div>
-<div class="line"><a name="l00161"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1381461ccf8dfff5cf9aba8e7b741b1a">  161</a></span>&#160;<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1381461ccf8dfff5cf9aba8e7b741b1a">NAME_MAX</a> = <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae688d728e1acdfe5988c7db45d6f0166">PATH_MAX</a>;</div>
-<div class="line"><a name="l00162"></a><span class="lineno">  162</span>&#160;</div>
-<div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160;<span class="comment">// Corresponds to `mode_t` defined in sys/types.h of the POSIX spec.</span></div>
-<div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;<span class="comment">// See large &quot;permissions API&quot; comment below for an explanation of</span></div>
-<div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;<span class="comment">// why this is an int instead of unsigned short (as is common on</span></div>
-<div class="line"><a name="l00166"></a><span class="lineno">  166</span>&#160;<span class="comment">// POSIX).</span></div>
-<div class="line"><a name="l00167"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">  167</a></span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a>;</div>
-<div class="line"><a name="l00168"></a><span class="lineno">  168</span>&#160;</div>
-<div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;<span class="comment">// `DWORD` is expected to be the type holding PIDs throughout the Windows API,</span></div>
-<div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;<span class="comment">// including functions like `OpenProcess`.</span></div>
-<div class="line"><a name="l00171"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">  171</a></span>&#160;<span class="keyword">typedef</span> DWORD <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>;</div>
-<div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;</div>
-<div class="line"><a name="l00173"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">  173</a></span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">uid_t</a>;</div>
-<div class="line"><a name="l00174"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">  174</a></span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a>;</div>
-<div class="line"><a name="l00175"></a><span class="lineno">  175</span>&#160;</div>
-<div class="line"><a name="l00176"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">  176</a></span>&#160;<span class="keyword">typedef</span> SSIZE_T <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a>;</div>
-<div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;</div>
-<div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;<span class="comment">// Socket flags. Define behavior of a socket when it (e.g.) shuts down. We map</span></div>
-<div class="line"><a name="l00179"></a><span class="lineno">  179</span>&#160;<span class="comment">// the Windows versions of these flags to their POSIX equivalents so we don&#39;t</span></div>
-<div class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;<span class="comment">// have to change any socket code.</span></div>
-<div class="line"><a name="l00181"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a337bdc938215c39cd21ddd11106189c6">  181</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a337bdc938215c39cd21ddd11106189c6">SHUT_RD</a> = SD_RECEIVE;</div>
-<div class="line"><a name="l00182"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac3d4e32482af3ec2158643d9996d78da">  182</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac3d4e32482af3ec2158643d9996d78da">SHUT_WR</a> = SD_SEND;</div>
-<div class="line"><a name="l00183"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc5dbd13b73a0a66d7fa25364a3f7d77">  183</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc5dbd13b73a0a66d7fa25364a3f7d77">SHUT_RDWR</a> = SD_BOTH;</div>
-<div class="line"><a name="l00184"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8810ebeb993fc304af15b6cb1544ddf1">  184</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8810ebeb993fc304af15b6cb1544ddf1">MSG_NOSIGNAL</a> = 0; <span class="comment">// `SIGPIPE` signal does not exist on Windows.</span></div>
-<div class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;</div>
-<div class="line"><a name="l00186"></a><span class="lineno">  186</span>&#160;<span class="comment">// The following functions are usually macros on POSIX; we provide them here as</span></div>
-<div class="line"><a name="l00187"></a><span class="lineno">  187</span>&#160;<span class="comment">// functions to avoid having global macros lying around. Note that these</span></div>
-<div class="line"><a name="l00188"></a><span class="lineno">  188</span>&#160;<span class="comment">// operate on the `_stat` struct (a Windows version of the standard POSIX</span></div>
-<div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;<span class="comment">// `stat` struct), of which the `st_mode` field is known to be an `int`.</span></div>
-<div class="line"><a name="l00190"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc71c1741c013cc1f2fb33c5e1e6f139">  190</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc71c1741c013cc1f2fb33c5e1e6f139">S_ISDIR</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00191"></a><span class="lineno">  191</span>&#160;{</div>
-<div class="line"><a name="l00192"></a><span class="lineno">  192</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == S_IFDIR; <span class="comment">// Directory.</span></div>
-<div class="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;}</div>
-<div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;</div>
-<div class="line"><a name="l00195"></a><span class="lineno">  195</span>&#160;</div>
-<div class="line"><a name="l00196"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a4c11a40f6ccc71f875e8f11929aad707">  196</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a4c11a40f6ccc71f875e8f11929aad707">S_ISREG</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00197"></a><span class="lineno">  197</span>&#160;{</div>
-<div class="line"><a name="l00198"></a><span class="lineno">  198</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == S_IFREG;  <span class="comment">// File.</span></div>
-<div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;}</div>
-<div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;</div>
-<div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;</div>
-<div class="line"><a name="l00202"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a74ba556c8168bb9556a34cf25d5fbb4a">  202</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a74ba556c8168bb9556a34cf25d5fbb4a">S_ISCHR</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;{</div>
-<div class="line"><a name="l00204"></a><span class="lineno">  204</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == S_IFCHR;  <span class="comment">// Character device.</span></div>
-<div class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;}</div>
-<div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;</div>
-<div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;</div>
-<div class="line"><a name="l00208"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac0d1cccc8a710f9b2ca7e8f25892d2a5">  208</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac0d1cccc8a710f9b2ca7e8f25892d2a5">S_ISFIFO</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;{</div>
-<div class="line"><a name="l00210"></a><span class="lineno">  210</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == _S_IFIFO; <span class="comment">// Pipe.</span></div>
-<div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;}</div>
-<div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;</div>
-<div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;</div>
-<div class="line"><a name="l00214"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a292ccd479f68ea0e4b53ee393f165872">  214</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a292ccd479f68ea0e4b53ee393f165872">S_ISBLK</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00215"></a><span class="lineno">  215</span>&#160;{</div>
-<div class="line"><a name="l00216"></a><span class="lineno">  216</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">false</span>;                       <span class="comment">// Block special device.</span></div>
-<div class="line"><a name="l00217"></a><span class="lineno">  217</span>&#160;}</div>
-<div class="line"><a name="l00218"></a><span class="lineno">  218</span>&#160;</div>
-<div class="line"><a name="l00219"></a><span class="lineno">  219</span>&#160;</div>
-<div class="line"><a name="l00220"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a953b4d8769906f7afe486c0ee0955fd3">  220</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a953b4d8769906f7afe486c0ee0955fd3">S_ISSOCK</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00221"></a><span class="lineno">  221</span>&#160;{</div>
-<div class="line"><a name="l00222"></a><span class="lineno">  222</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">false</span>;                       <span class="comment">// Socket.</span></div>
-<div class="line"><a name="l00223"></a><span class="lineno">  223</span>&#160;}</div>
-<div class="line"><a name="l00224"></a><span class="lineno">  224</span>&#160;</div>
-<div class="line"><a name="l00225"></a><span class="lineno">  225</span>&#160;</div>
-<div class="line"><a name="l00226"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a255249008157db126b6981929505f9e4">  226</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a255249008157db126b6981929505f9e4">S_ISLNK</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a0b77d3699a25c2c39a29b36062f07321">mode</a>)</div>
-<div class="line"><a name="l00227"></a><span class="lineno">  227</span>&#160;{</div>
-<div class="line"><a name="l00228"></a><span class="lineno">  228</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">false</span>;                       <span class="comment">// Symbolic link.</span></div>
-<div class="line"><a name="l00229"></a><span class="lineno">  229</span>&#160;}</div>
-<div class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;</div>
-<div class="line"><a name="l00231"></a><span class="lineno">  231</span>&#160;<span class="comment">// Permissions API. (cf. MESOS-3176 to track ongoing permissions work.)</span></div>
-<div class="line"><a name="l00232"></a><span class="lineno">  232</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00233"></a><span class="lineno">  233</span>&#160;<span class="comment">// We are currently able to emulate a subset of the POSIX permissions model</span></div>
-<div class="line"><a name="l00234"></a><span class="lineno">  234</span>&#160;<span class="comment">// with the Windows model:</span></div>
-<div class="line"><a name="l00235"></a><span class="lineno">  235</span>&#160;<span class="comment">//   [x] User write permissions.</span></div>
-<div class="line"><a name="l00236"></a><span class="lineno">  236</span>&#160;<span class="comment">//   [x] User read permissions.</span></div>
-<div class="line"><a name="l00237"></a><span class="lineno">  237</span>&#160;<span class="comment">//   [ ] User execute permissions.</span></div>
-<div class="line"><a name="l00238"></a><span class="lineno">  238</span>&#160;<span class="comment">//   [ ] Group permissions of any sort.</span></div>
-<div class="line"><a name="l00239"></a><span class="lineno">  239</span>&#160;<span class="comment">//   [ ] Other permissions of any sort.</span></div>
-<div class="line"><a name="l00240"></a><span class="lineno">  240</span>&#160;<span class="comment">//   [x] Flags to control &quot;fallback&quot; behavior (e.g., we might choose</span></div>
-<div class="line"><a name="l00241"></a><span class="lineno">  241</span>&#160;<span class="comment">//       to fall back to user readability when the user passes the</span></div>
-<div class="line"><a name="l00242"></a><span class="lineno">  242</span>&#160;<span class="comment">//       group readability flag in, since we currently do not support</span></div>
-<div class="line"><a name="l00243"></a><span class="lineno">  243</span>&#160;<span class="comment">//       group readability).</span></div>
-<div class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00245"></a><span class="lineno">  245</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00246"></a><span class="lineno">  246</span>&#160;<span class="comment">// Rationale:</span></div>
-<div class="line"><a name="l00247"></a><span class="lineno">  247</span>&#160;<span class="comment">// Windows currently implements two permissions models: (1) an extremely</span></div>
-<div class="line"><a name="l00248"></a><span class="lineno">  248</span>&#160;<span class="comment">// primitive permission model it largely inherited from DOS, and (2) the Access</span></div>
-<div class="line"><a name="l00249"></a><span class="lineno">  249</span>&#160;<span class="comment">// Control List (ACL) API. Because there is no trivial way to map the classic</span></div>
-<div class="line"><a name="l00250"></a><span class="lineno">  250</span>&#160;<span class="comment">// POSIX model into the ACL model, we have implemented POSIX-style permissions</span></div>
-<div class="line"><a name="l00251"></a><span class="lineno">  251</span>&#160;<span class="comment">// in terms of the DOS model. The result is the permissions limitations above.</span></div>
-<div class="line"><a name="l00252"></a><span class="lineno">  252</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00253"></a><span class="lineno">  253</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00254"></a><span class="lineno">  254</span>&#160;<span class="comment">// Flag implementation:</span></div>
-<div class="line"><a name="l00255"></a><span class="lineno">  255</span>&#160;<span class="comment">// Flags fall into the following two categories.</span></div>
-<div class="line"><a name="l00256"></a><span class="lineno">  256</span>&#160;<span class="comment">//   (1) Flags which exist in both permission models, but which have</span></div>
-<div class="line"><a name="l00257"></a><span class="lineno">  257</span>&#160;<span class="comment">//       different names (e.g., `S_IRUSR` in POSIX is called `_S_IREAD` on</span></div>
-<div class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;<span class="comment">//       Windows). In this case, we define the POSIX name to be the Windows</span></div>
-<div class="line"><a name="l00259"></a><span class="lineno">  259</span>&#160;<span class="comment">//       value (e.g., we define `S_IRUSR` to have the same value as `_S_IREAD`),</span></div>
-<div class="line"><a name="l00260"></a><span class="lineno">  260</span>&#160;<span class="comment">//       so that we can pass the POSIX name into Windows functions like</span></div>
-<div class="line"><a name="l00261"></a><span class="lineno">  261</span>&#160;<span class="comment">//       `_open`.</span></div>
-<div class="line"><a name="l00262"></a><span class="lineno">  262</span>&#160;<span class="comment">//   (2) Flags which exist only on POSIX (e.g., `S_IXUSR`). Here we</span></div>
-<div class="line"><a name="l00263"></a><span class="lineno">  263</span>&#160;<span class="comment">//       define the POSIX name to be the value given in the glibc</span></div>
-<div class="line"><a name="l00264"></a><span class="lineno">  264</span>&#160;<span class="comment">//       documentation[1], shifted left by 16 bits (since `mode_t`</span></div>
-<div class="line"><a name="l00265"></a><span class="lineno">  265</span>&#160;<span class="comment">//       is unsigned short on POSIX and `int` on Windows). We give these</span></div>
-<div class="line"><a name="l00266"></a><span class="lineno">  266</span>&#160;<span class="comment">//       flags glibc values to stay consistent, and so that existing</span></div>
-<div class="line"><a name="l00267"></a><span class="lineno">  267</span>&#160;<span class="comment">//       calls to functions like `open` do not break when they try to</span></div>
-<div class="line"><a name="l00268"></a><span class="lineno">  268</span>&#160;<span class="comment">//       use a flag that doesn&#39;t exist on Windows. But, of course,</span></div>
-<div class="line"><a name="l00269"></a><span class="lineno">  269</span>&#160;<span class="comment">//       these flags do not affect the execution of these functions.</span></div>
-<div class="line"><a name="l00270"></a><span class="lineno">  270</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00271"></a><span class="lineno">  271</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00272"></a><span class="lineno">  272</span>&#160;<span class="comment">// Flag strictness:</span></div>
-<div class="line"><a name="l00273"></a><span class="lineno">  273</span>&#160;<span class="comment">// Because the current implementation does not directly support setting or</span></div>
-<div class="line"><a name="l00274"></a><span class="lineno">  274</span>&#160;<span class="comment">// getting group or other permission bits on the Windows platform, there is a</span></div>
-<div class="line"><a name="l00275"></a><span class="lineno">  275</span>&#160;<span class="comment">// question of what we should fall back to when these flags are passed in to</span></div>
-<div class="line"><a name="l00276"></a><span class="lineno">  276</span>&#160;<span class="comment">// Stout methods.</span></div>
-<div class="line"><a name="l00277"></a><span class="lineno">  277</span>&#160;<span class="comment">//</span></div>
-<div class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;<span class="comment">// TODO(hausdorff): Investigate permissions mappings.</span></div>
-<div class="line"><a name="l00279"></a><span class="lineno">  279</span>&#160;<span class="comment">// We force &quot;strictness&quot; of the permission flag semantics:</span></div>
-<div class="line"><a name="l00280"></a><span class="lineno">  280</span>&#160;<span class="comment">//   * The group permissions flags will not fall back to anything, and will be</span></div>
-<div class="line"><a name="l00281"></a><span class="lineno">  281</span>&#160;<span class="comment">//     completely ignored.</span></div>
-<div class="line"><a name="l00282"></a><span class="lineno">  282</span>&#160;<span class="comment">//   * Other permissions: Same as above, but with other permissions.</span></div>
-<div class="line"><a name="l00283"></a><span class="lineno">  283</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;<span class="comment">// Gathers most of the Windows-compatibility definitions.  This makes it</span></div>
+<div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;<span class="comment">// possible for files throughout the codebase to remain relatively free of all</span></div>
+<div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;<span class="comment">// the #if&#39;s we&#39;d need to make them work.</span></div>
+<div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;<span class="comment">// Roughly, the things that should go in this file are definitions and</span></div>
+<div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;<span class="comment">// declarations that one would not mind being:</span></div>
+<div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;<span class="comment">//   * in global scope.</span></div>
+<div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;<span class="comment">//   * globally available throughout both the Stout codebase, and any code</span></div>
+<div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;<span class="comment">//     that uses it (such as Mesos).</span></div>
+<div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;</div>
+<div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;</div>
+<div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;<span class="comment">// This code un-defines the global `GetMessage` macro defined by the Windows</span></div>
+<div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;<span class="comment">// headers, and replaces it with an inline function that is equivalent.</span></div>
+<div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;<span class="comment">// There are two reasons for doing this. The first is because this macro</span></div>
+<div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;<span class="comment">// interferes with `google::protobufs::Reflection::GetMessage`. Replacing the</span></div>
+<div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;<span class="comment">// `GetMessage` macro with an inline function allows people calling the</span></div>
+<div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;<span class="comment">// `GetMessage` macro to carry on doing so with no code changes, but it will</span></div>
+<div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;<span class="comment">// also allow us to use `google::protobufs::Reflection::GetMessage` without</span></div>
+<div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;<span class="comment">// interference from the macro.</span></div>
+<div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;<span class="comment">// The second is because we don&#39;t want to obliterate the `GetMessage` macro for</span></div>
+<div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;<span class="comment">// people who include this header, either on purpose, or incidentally as part</span></div>
+<div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;<span class="comment">// of some other Mesos header. The effect is that our need to call protobuf&#39;s</span></div>
+<div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;<span class="comment">// `GetMessage` function has no deleterious effect on customers of this API.</span></div>
+<div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;<span class="comment">// NOTE: the Windows headers also don&#39;t use define-once semantics for the</span></div>
+<div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;<span class="comment">// `GetMessage` macro. In particular, this means that every time you include</span></div>
+<div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;<span class="comment">// `Winuser.h` and a `GetMessage` macro isn&#39;t defined, the Windows headers will</span></div>
+<div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;<span class="comment">// redefine it for you. The impact of this is that you should re-un-define the</span></div>
+<div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;<span class="comment">// macro every time you include `Windows.h`; since we should be including</span></div>
+<div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;<span class="comment">// `Windows.h` only from this file, we un-define it just after we include</span></div>
+<div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;<span class="comment">// `Windows.h`.</span></div>
+<div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;<span class="preprocessor">#ifdef GetMessage</span></div>
+<div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;<span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessageWindows(</div>
+<div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;    LPMSG lpMsg,</div>
+<div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;    HWND hWnd,</div>
+<div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;    UINT wMsgFilterMin,</div>
+<div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;    UINT wMsgFilterMax)</div>
+<div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;{</div>
+<div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;  <span class="keywordflow">return</span> GetMessage(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</div>
+<div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;}</div>
+<div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;<span class="preprocessor">#undef GetMessage</span></div>
+<div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160;<span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessage(</div>
+<div class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;    LPMSG lpMsg,</div>
+<div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;    HWND hWnd,</div>
+<div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;    UINT wMsgFilterMin,</div>
+<div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;    UINT wMsgFilterMax)</div>
+<div class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;{</div>
+<div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;  <span class="keywordflow">return</span> GetMessageWindows(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</div>
+<div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;}</div>
+<div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;<span class="preprocessor">#endif // GetMessage</span></div>
+<div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;</div>
+<div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;<span class="comment">// Define constants used for Windows compat. Allows a lot of code on</span></div>
+<div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;<span class="comment">// Windows and POSIX systems to be the same, because we can pass the</span></div>
+<div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;<span class="comment">// same constants to functions we call to do things like file I/O.</span></div>
+<div class="line"><a name="l00149"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afcf80a6d91178952d107ad00b165752b">  149</a></span>&#160;<span class="preprocessor">#define STDIN_FILENO 0</span></div>
+<div class="line"><a name="l00150"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abd165ee6474b5b75bf075842fff13a04">  150</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define STDOUT_FILENO 1</span></div>
+<div class="line"><a name="l00151"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae2fe1725bb5e9823d089c46b9ed5266e">  151</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define STDERR_FILENO 2</span></div>
+<div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00153"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a24a7a0ceb1e8f5f44cb1038bb829030d">  153</a></span>&#160;<span class="preprocessor">#define R_OK 0x4</span></div>
+<div class="line"><a name="l00154"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae5acf4043c0903cda7436b108e29e8e6">  154</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define W_OK 0x2</span></div>
+<div class="line"><a name="l00155"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a5e995ef7690698b62bf016b14fbc45ca">  155</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define X_OK 0x0 // No such permission on Windows.</span></div>
+<div class="line"><a name="l00156"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#af837744613408b57dc3654fbc3bcf900">  156</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define F_OK 0x0</span></div>
+<div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00158"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a7a68c9ffaac7dbcd652225dd7c06a54b">  158</a></span>&#160;<span class="preprocessor">#define O_RDONLY _O_RDONLY</span></div>
+<div class="line"><a name="l00159"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a11b644a8526139c4cc1850dac1271ced">  159</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_WRONLY _O_WRONLY</span></div>
+<div class="line"><a name="l00160"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abb0586253488ee61072b73557eeb873b">  160</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_RDWR _O_RDWR</span></div>
+<div class="line"><a name="l00161"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1cf6b1de1fffedaa1d26b189e9a8d2cc">  161</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_CREAT _O_CREAT</span></div>
+<div class="line"><a name="l00162"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad1d67e453fb3031f40f8cd3403773813">  162</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_TRUNC _O_TRUNC</span></div>
+<div class="line"><a name="l00163"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae036f789407d21f07b211552d67b3214">  163</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_APPEND _O_APPEND</span></div>
+<div class="line"><a name="l00164"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad6d8fbe4e494b4dbe051612572d3f757">  164</a></span>&#160;<span class="preprocessor"></span><span class="preprocessor">#define O_CLOEXEC _O_NOINHERIT</span></div>
+<div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00166"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afd80ecbe3170ca4fc85b65cda8659f82">  166</a></span>&#160;<span class="preprocessor">#define MAXHOSTNAMELEN NI_MAXHOST</span></div>
+<div class="line"><a name="l00167"></a><span class="lineno">  167</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00168"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae688d728e1acdfe5988c7db45d6f0166">  168</a></span>&#160;<span class="preprocessor">#define PATH_MAX _MAX_PATH</span></div>
+<div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;<span class="preprocessor"></span></div>
+<div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;<span class="comment">// NOTE: for details on what this value should be, consult [1], [2], and [3].</span></div>
+<div class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;<span class="comment">// [1] http://www.opensource.apple.com/source/gnumake/gnumake-119/make/w32/include/dirent.h</span></div>
+<div class="line"><a name="l00173"></a><span class="lineno">  173</span>&#160;<span class="comment">// [2] https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits</span></div>
+<div class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;<span class="comment">// [3] https://msdn.microsoft.com/en-us/library/930f87yf.aspx</span></div>
+<div class="line"><a name="l00175"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1381461ccf8dfff5cf9aba8e7b741b1a">  175</a></span>&#160;<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1381461ccf8dfff5cf9aba8e7b741b1a">NAME_MAX</a> = <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae688d728e1acdfe5988c7db45d6f0166">PATH_MAX</a>;</div>
+<div class="line"><a name="l00176"></a><span class="lineno">  176</span>&#160;</div>
+<div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;<span class="comment">// Corresponds to `mode_t` defined in sys/types.h of the POSIX spec.</span></div>
+<div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;<span class="comment">// See large &quot;permissions API&quot; comment below for an explanation of</span></div>
+<div class="line"><a name="l00179"></a><span class="lineno">  179</span>&#160;<span class="comment">// why this is an int instead of unsigned short (as is common on</span></div>
+<div class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;<span class="comment">// POSIX).</span></div>
+<div class="line"><a name="l00181"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">  181</a></span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a>;</div>
+<div class="line"><a name="l00182"></a><span class="lineno">  182</span>&#160;</div>
+<div class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;<span class="comment">// `DWORD` is expected to be the type holding PIDs throughout the Windows API,</span></div>
+<div class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;<span class="comment">// including functions like `OpenProcess`.</span></div>
+<div class="line"><a name="l00185"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">  185</a></span>&#160;<span class="keyword">typedef</span> DWORD <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>;</div>
+<div class="line"><a name="l00186"></a><span class="lineno">  186</span>&#160;</div>
+<div class="line"><a name="l00187"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">  187</a></span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">uid_t</a>;</div>
+<div class="line"><a name="l00188"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">  188</a></span>&#160;<span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a>;</div>
+<div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;</div>
+<div class="line"><a name="l00190"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">  190</a></span>&#160;<span class="keyword">typedef</span> SSIZE_T <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a>;</div>
+<div class="line"><a name="l00191"></a><span class="lineno">  191</span>&#160;</div>
+<div class="line"><a name="l00192"></a><span class="lineno">  192</span>&#160;<span class="comment">// Socket flags. Define behavior of a socket when it (e.g.) shuts down. We map</span></div>
+<div class="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;<span class="comment">// the Windows versions of these flags to their POSIX equivalents so we don&#39;t</span></div>
+<div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;<span class="comment">// have to change any socket code.</span></div>
+<div class="line"><a name="l00195"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a337bdc938215c39cd21ddd11106189c6">  195</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a337bdc938215c39cd21ddd11106189c6">SHUT_RD</a> = SD_RECEIVE;</div>
+<div class="line"><a name="l00196"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac3d4e32482af3ec2158643d9996d78da">  196</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac3d4e32482af3ec2158643d9996d78da">SHUT_WR</a> = SD_SEND;</div>
+<div class="line"><a name="l00197"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc5dbd13b73a0a66d7fa25364a3f7d77">  197</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc5dbd13b73a0a66d7fa25364a3f7d77">SHUT_RDWR</a> = SD_BOTH;</div>
+<div class="line"><a name="l00198"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8810ebeb993fc304af15b6cb1544ddf1">  198</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8810ebeb993fc304af15b6cb1544ddf1">MSG_NOSIGNAL</a> = 0; <span class="comment">// `SIGPIPE` signal does not exist on Windows.</span></div>
+<div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;</div>
+<div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;<span class="comment">// The following functions are usually macros on POSIX; we provide them here as</span></div>
+<div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;<span class="comment">// functions to avoid having global macros lying around. Note that these</span></div>
+<div class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;<span class="comment">// operate on the `_stat` struct (a Windows version of the standard POSIX</span></div>
+<div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;<span class="comment">// `stat` struct), of which the `st_mode` field is known to be an `int`.</span></div>
+<div class="line"><a name="l00204"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc71c1741c013cc1f2fb33c5e1e6f139">  204</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc71c1741c013cc1f2fb33c5e1e6f139">S_ISDIR</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;{</div>
+<div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == S_IFDIR; <span class="comment">// Directory.</span></div>
+<div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;}</div>
+<div class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;</div>
+<div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;</div>
+<div class="line"><a name="l00210"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a4c11a40f6ccc71f875e8f11929aad707">  210</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a4c11a40f6ccc71f875e8f11929aad707">S_ISREG</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;{</div>
+<div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == S_IFREG;  <span class="comment">// File.</span></div>
+<div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;}</div>
+<div class="line"><a name="l00214"></a><span class="lineno">  214</span>&#160;</div>
+<div class="line"><a name="l00215"></a><span class="lineno">  215</span>&#160;</div>
+<div class="line"><a name="l00216"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a74ba556c8168bb9556a34cf25d5fbb4a">  216</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a74ba556c8168bb9556a34cf25d5fbb4a">S_ISCHR</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00217"></a><span class="lineno">  217</span>&#160;{</div>
+<div class="line"><a name="l00218"></a><span class="lineno">  218</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == S_IFCHR;  <span class="comment">// Character device.</span></div>
+<div class="line"><a name="l00219"></a><span class="lineno">  219</span>&#160;}</div>
+<div class="line"><a name="l00220"></a><span class="lineno">  220</span>&#160;</div>
+<div class="line"><a name="l00221"></a><span class="lineno">  221</span>&#160;</div>
+<div class="line"><a name="l00222"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac0d1cccc8a710f9b2ca7e8f25892d2a5">  222</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac0d1cccc8a710f9b2ca7e8f25892d2a5">S_ISFIFO</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00223"></a><span class="lineno">  223</span>&#160;{</div>
+<div class="line"><a name="l00224"></a><span class="lineno">  224</span>&#160;  <span class="keywordflow">return</span> (mode &amp; S_IFMT) == _S_IFIFO; <span class="comment">// Pipe.</span></div>
+<div class="line"><a name="l00225"></a><span class="lineno">  225</span>&#160;}</div>
+<div class="line"><a name="l00226"></a><span class="lineno">  226</span>&#160;</div>
+<div class="line"><a name="l00227"></a><span class="lineno">  227</span>&#160;</div>
+<div class="line"><a name="l00228"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a292ccd479f68ea0e4b53ee393f165872">  228</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a292ccd479f68ea0e4b53ee393f165872">S_ISBLK</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00229"></a><span class="lineno">  229</span>&#160;{</div>
+<div class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">false</span>;                       <span class="comment">// Block special device.</span></div>
+<div class="line"><a name="l00231"></a><span class="lineno">  231</span>&#160;}</div>
+<div class="line"><a name="l00232"></a><span class="lineno">  232</span>&#160;</div>
+<div class="line"><a name="l00233"></a><span class="lineno">  233</span>&#160;</div>
+<div class="line"><a name="l00234"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a953b4d8769906f7afe486c0ee0955fd3">  234</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a953b4d8769906f7afe486c0ee0955fd3">S_ISSOCK</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00235"></a><span class="lineno">  235</span>&#160;{</div>
+<div class="line"><a name="l00236"></a><span class="lineno">  236</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">false</span>;                       <span class="comment">// Socket.</span></div>
+<div class="line"><a name="l00237"></a><span class="lineno">  237</span>&#160;}</div>
+<div class="line"><a name="l00238"></a><span class="lineno">  238</span>&#160;</div>
+<div class="line"><a name="l00239"></a><span class="lineno">  239</span>&#160;</div>
+<div class="line"><a name="l00240"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a255249008157db126b6981929505f9e4">  240</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a255249008157db126b6981929505f9e4">S_ISLNK</a>(<span class="keyword">const</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div>
+<div class="line"><a name="l00241"></a><span class="lineno">  241</span>&#160;{</div>
+<div class="line"><a name="l00242"></a><span class="lineno">  242</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">false</span>;                       <span class="comment">// Symbolic link.</span></div>
+<div class="line"><a name="l00243"></a><span class="lineno">  243</span>&#160;}</div>
+<div class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;</div>
+<div class="line"><a name="l00245"></a><span class="lineno">  245</span>&#160;<span class="comment">// Permissions API. (cf. MESOS-3176 to track ongoing permissions work.)</span></div>
+<div class="line"><a name="l00246"></a><span class="lineno">  246</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00247"></a><span class="lineno">  247</span>&#160;<span class="comment">// We are currently able to emulate a subset of the POSIX permissions model</span></div>
+<div class="line"><a name="l00248"></a><span class="lineno">  248</span>&#160;<span class="comment">// with the Windows model:</span></div>
+<div class="line"><a name="l00249"></a><span class="lineno">  249</span>&#160;<span class="comment">//   [x] User write permissions.</span></div>
+<div class="line"><a name="l00250"></a><span class="lineno">  250</span>&#160;<span class="comment">//   [x] User read permissions.</span></div>
+<div class="line"><a name="l00251"></a><span class="lineno">  251</span>&#160;<span class="comment">//   [ ] User execute permissions.</span></div>
+<div class="line"><a name="l00252"></a><span class="lineno">  252</span>&#160;<span class="comment">//   [ ] Group permissions of any sort.</span></div>
+<div class="line"><a name="l00253"></a><span class="lineno">  253</span>&#160;<span class="comment">//   [ ] Other permissions of any sort.</span></div>
+<div class="line"><a name="l00254"></a><span class="lineno">  254</span>&#160;<span class="comment">//   [x] Flags to control &quot;fallback&quot; behavior (e.g., we might choose</span></div>
+<div class="line"><a name="l00255"></a><span class="lineno">  255</span>&#160;<span class="comment">//       to fall back to user readability when the user passes the</span></div>
+<div class="line"><a name="l00256"></a><span class="lineno">  256</span>&#160;<span class="comment">//       group readability flag in, since we currently do not support</span></div>
+<div class="line"><a name="l00257"></a><span class="lineno">  257</span>&#160;<span class="comment">//       group readability).</span></div>
+<div class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00259"></a><span class="lineno">  259</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00260"></a><span class="lineno">  260</span>&#160;<span class="comment">// Rationale:</span></div>
+<div class="line"><a name="l00261"></a><span class="lineno">  261</span>&#160;<span class="comment">// Windows currently implements two permissions models: (1) an extremely</span></div>
+<div class="line"><a name="l00262"></a><span class="lineno">  262</span>&#160;<span class="comment">// primitive permission model it largely inherited from DOS, and (2) the Access</span></div>
+<div class="line"><a name="l00263"></a><span class="lineno">  263</span>&#160;<span class="comment">// Control List (ACL) API. Because there is no trivial way to map the classic</span></div>
+<div class="line"><a name="l00264"></a><span class="lineno">  264</span>&#160;<span class="comment">// POSIX model into the ACL model, we have implemented POSIX-style permissions</span></div>
+<div class="line"><a name="l00265"></a><span class="lineno">  265</span>&#160;<span class="comment">// in terms of the DOS model. The result is the permissions limitations above.</span></div>
+<div class="line"><a name="l00266"></a><span class="lineno">  266</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00267"></a><span class="lineno">  267</span>&#160;<span class="comment">//</span></div>
+<div class="line"><a name="l00268"></a><span class="lineno">  268</span>&#160;<span class="comment">// Flag implementation:</span></div>
+<div class="line"><a name="l00269"></a><span class="lineno">  269</span>&#160;<span class="comment">// Flags fall into the following two categories.</span></div>
+<div class="line"><a name="l00270"></a><span class="lineno">  270</span>&#160;<span class="comment">//   (1) Flags which exist in both permission models, but which have</span></div>
+<div class="line"><a name="l00271"></a><span class="lineno">  271</span>&#160;<span class="comment">//       different names (e.g., `S_IRUSR` in POSIX is called `_S_IREAD` on</span></div>
+<div class="line"><a name="l00272"></a><span class="lineno">  272</span>&#160;<span class="comment">//       Windows). In this case, we define the POSIX name to be the Windows</span></div>
+<div class="line"><a name="l00273"></a><span class="lineno">  273</span>&#160;<span class="comment">//       value (e.g., we define `S_IRUSR` to have the same value as `_S_IREAD`),</span></div>
+<div class="line"><a name="l00274"></a><span class="lineno">  274</span>&#160;<span class="comment">//       so that we can pass the POSIX name into Windows functions like</span></div>
+<div class="line"><a name="l00275"></a><span class="lineno">  275</span>&#160;<span class="comment">//       `_open`.</span></div>
+<div class="line"><a name="l00276"></a><span class="lineno">  276</span>&#160;<span class="comment">//   (2) Flags which exist only on POSIX (e.g., `S_IXUSR`). Here we</span></div>
+<div class="line"><a name="l00277"></a><span class="lineno">  277</span>&#160;<span class="comment">//       define the POSIX name to be the value given in the glibc</span></div>
+<div class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;<span class="comment">//       documentation[1], shifted left by 16 bits (since `mode_t`</span></div>
+<div class="line"><a name="l00279"></a><span class="lineno">  279</span>&#160;<span class="comment">//       is unsigned short on POSIX and `int` on Windows). We give these</span></div>
+<div class="line"><a name="l00280"></a><span class="lineno">  280</span>&#160;<span class="comment">//       flags glibc values to stay consistent, and so that existing</span></div>
+<div class="line"><a name="l00281"></a><span class="lineno">  281</span>&#160;<span class="comment">//       calls to functions like `open` do not break when they try to</span></div>
+<div class="line"><a name="l00282"></a><span class="lineno">  282</span>&#160;<span class="comment">//       use a flag that doesn&#39;t exist on Windows. But, of course,</span></div>
+<div class="line"><a 

<TRUNCATED>

Mime
View raw message