http://git-wip-us.apache.org/repos/asf/mesos-site/blob/78eea43c/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 9f330b4..2e5d403 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 @@ -67,451 +67,460 @@ <div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#ifndef __STOUT_WINDOWS_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_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> <span class="comment">// For `_mkdir`.</span></div> -<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#include <errno.h></span> <span class="comment">// For `_set_errno`.</span></div> -<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#include <fcntl.h></span> <span class="comment">// For file access flags like `_O_CREAT`.</span></div> -<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="preprocessor">#include <io.h></span> <span class="comment">// For `_read`, `_write`.</span></div> -<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <process.h></span> <span class="comment">// For `_getpid`.</span></div> -<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <stdlib.h></span> <span class="comment">// For `_PATH_MAX`.</span></div> -<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> </div> -<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <sys/stat.h></span> <span class="comment">// For permissions flags.</span></div> -<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> </div> -<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="preprocessor">#include <BaseTsd.h></span> <span class="comment">// For `SSIZE_T`.</span></div> -<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment">// We include `Winsock2.h` before `Windows.h` explicitly to avoid symbold</span></div> -<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment">// re-definitions. This is a known pattern in the windows community.</span></div> -<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <WS2tcpip.h></span></div> -<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <Winsock2.h></span></div> -<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <iphlpapi.h></span></div> -<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <mswsock.h></span></div> -<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <winioctl.h></span></div> -<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <Windows.h></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 <memory></span></div> -<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div> -<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <glog/logging.h></span></div> -<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div> +<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment">// We include `WinSock2.h` before `Windows.h` explicitly to avoid symbol</span></div> +<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">// re-definitions. This is a documented pattern, because `Windows.h` will</span></div> +<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">// otherwise include `winsock.h` for "historical reasons". Note that</span></div> +<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">// `winsock.h` is for Windows Sockets 1.1, last used in Windows 2000.</span></div> +<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">//</span></div> +<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">// NOTE: The capitalization of these headers is based on the files</span></div> +<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">// included in the SDK, rather than MSDN documentation.</span></div> +<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">//</span></div> +<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">// https://msdn.microsoft.com/en-us/library/windows/desktop/ms738562(v=vs.85).aspx</span></div> +<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment">// NOLINT(whitespace/line_length)</span></div> +<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <WinSock2.h></span> <span class="comment">// For Windows Sockets 2.</span></div> +<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include <WS2tcpip.h></span> <span class="comment">// For `getaddrinfo` etc.</span></div> +<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <iphlpapi.h></span> <span class="comment">// For `GetAdaptersInfo`.</span></div> +<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <MSWSock.h></span> <span class="comment">// For `TransmitFile`.</span></div> +<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <winioctl.h></span> <span class="comment">// For `DeviceIoControl`</span></div> +<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <Windows.h></span> <span class="comment">// For everything else.</span></div> +<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> </div> +<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <direct.h></span> <span class="comment">// For `_mkdir`.</span></div> +<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <errno.h></span> <span class="comment">// For `_set_errno`.</span></div> +<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <fcntl.h></span> <span class="comment">// For file access flags like `_O_CREAT`.</span></div> +<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <io.h></span> <span class="comment">// For `_read`, `_write`.</span></div> +<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <process.h></span> <span class="comment">// For `_getpid`.</span></div> +<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#include <stdlib.h></span> <span class="comment">// For `_PATH_MAX`.</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">#if !defined(_UNICODE) || !defined(UNICODE)</span></div> -<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <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="l00042"></a><span class="lineno"> 42</span> <span class="comment">// varieties. To avoid polluting the namespace with two versions of every</span></div> -<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// function, a common pattern in the Windows headers is to offer a single macro</span></div> -<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// that expands to the `string` or `wstring` version, depending on whether the</span></div> -<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// `_UNICODE` and `UNICODE` preprocessor symbols are set. For example,</span></div> -<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// `GetMessage` will expand to either `GetMessageA` (the `string` version) or</span></div> -<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// `GetMessageW` (the `wstring` version) depending on whether these symbols are</span></div> -<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// defined.</span></div> -<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">//</span></div> -<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// Unfortunately the `string` version is not UTF-8, like a developer would</span></div> -<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// expect on Linux, but is instead the current Windows code page, and thus may</span></div> -<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// take a different value at runtime. This makes it potentially difficult to</span></div> -<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// decode, whereas the `wstring` version is always encoded as UTF-16, and thus</span></div> -<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// can be programatically converted to UTF-8 using the `stringify()` function</span></div> -<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// (converting UTF-8 to UTF-16 is done with `wide_stringify()`).</span></div> -<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">//</span></div> -<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// Furthermore, support for NTFS long paths requires the use of the `wstring`</span></div> -<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment">// APIs, coupled with the `\\?\` long path prefix marker for paths longer than</span></div> -<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment">// the max path limit. This is accomplished by wrapping paths sent to Windows</span></div> -<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment">// APIs with the `internal::windows::longpath()` helper. In order to prevent</span></div> -<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment">// future regressions, we enforce the definitions of `_UNICODE` and `UNICODE`.</span></div> -<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment">//</span></div> -<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment">// NOTE: The Mesos code should always use the explicit `W` suffixed APIs in</span></div> -<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment">// order to avoid type ambiguity.</span></div> -<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">#error "Mesos must be built with `_UNICODE` and `UNICODE` defined."</span></div> -<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="preprocessor"></span><span class="preprocessor">#endif // !defined(_UNICODE) || !defined(UNICODE)</span></div> -<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment">// An RAII `HANDLE`.</span></div> -<div class="line"><a name="l00069"></a><span class="lineno"><a class="line" href="classSharedHandle.html"> 69</a></span> <span class="keyword">class </span><a class="code" href="classSharedHandle.html">SharedHandle</a> : <span class="keyword">public</span> std::shared_ptr<void></div> -<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> {</div> -<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  static_assert(std::is_same<HANDLE, void*>::value,</div> -<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="stringliteral">"Expected `HANDLE` to be of type `void*`."</span>);</div> -<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> </div> -<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="keyword">public</span>:</div> -<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="comment">// We delete the default constructor so that the callsite is forced to make</span></div> -<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="comment">// an explicit decision about what the empty `HANDLE` value should be, as it</span></div> -<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="comment">// is not the same for all `HANDLE` types. For example, `OpenProcess`</span></div> -<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="comment">// returns a `nullptr` for an invalid handle, but `CreateFile` returns an</span></div> -<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="comment">// `INVALID_HANDLE_VALUE` instead. This inconsistency is inherent in the</span></div> -<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <span class="comment">// Windows API.</span></div> -<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <a class="code" href="classSharedHandle.html#ad2cfca1ab3db9839e617b569b225e0c0">SharedHandle</a>() = <span class="keyword">delete</span>;</div> +<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#include <sys/stat.h></span> <span class="comment">// For permissions flags.</span></div> +<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> </div> +<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor">#include <basetsd.h></span> <span class="comment">// For `SSIZE_T`.</span></div> +<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> </div> +<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="preprocessor">#include <memory></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 <glog/logging.h></span></div> +<div class="line"><a name="l00047"></a><span class="lineno"> 47</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="preprocessor">#if !defined(_UNICODE) || !defined(UNICODE)</span></div> +<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <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="l00051"></a><span class="lineno"> 51</span> <span class="comment">// varieties. To avoid polluting the namespace with two versions of every</span></div> +<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// function, a common pattern in the Windows headers is to offer a single macro</span></div> +<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// that expands to the `string` or `wstring` version, depending on whether the</span></div> +<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// `_UNICODE` and `UNICODE` preprocessor symbols are set. For example,</span></div> +<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// `GetMessage` will expand to either `GetMessageA` (the `string` version) or</span></div> +<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// `GetMessageW` (the `wstring` version) depending on whether these symbols are</span></div> +<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// defined.</span></div> +<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment">//</span></div> +<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment">// Unfortunately the `string` version is not UTF-8, like a developer would</span></div> +<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment">// expect on Linux, but is instead the current Windows code page, and thus may</span></div> +<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment">// take a different value at runtime. This makes it potentially difficult to</span></div> +<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment">// decode, whereas the `wstring` version is always encoded as UTF-16, and thus</span></div> +<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment">// can be programatically converted to UTF-8 using the `stringify()` function</span></div> +<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment">// (converting UTF-8 to UTF-16 is done with `wide_stringify()`).</span></div> +<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment">//</span></div> +<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment">// Furthermore, support for NTFS long paths requires the use of the `wstring`</span></div> +<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="comment">// APIs, coupled with the `\\?\` long path prefix marker for paths longer than</span></div> +<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment">// the max path limit. This is accomplished by wrapping paths sent to Windows</span></div> +<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment">// APIs with the `internal::windows::longpath()` helper. In order to prevent</span></div> +<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment">// future regressions, we enforce the definitions of `_UNICODE` and `UNICODE`.</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: The Mesos code should always use the explicit `W` suffixed APIs in</span></div> +<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment">// order to avoid type ambiguity.</span></div> +<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="preprocessor">#error "Mesos must be built with `_UNICODE` and `UNICODE` defined."</span></div> +<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="preprocessor"></span><span class="preprocessor">#endif // !defined(_UNICODE) || !defined(UNICODE)</span></div> +<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="preprocessor"></span></div> +<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment">// An RAII `HANDLE`.</span></div> +<div class="line"><a name="l00078"></a><span class="lineno"><a class="line" href="classSharedHandle.html"> 78</a></span> <span class="keyword">class </span><a class="code" href="classSharedHandle.html">SharedHandle</a> : <span class="keyword">public</span> std::shared_ptr<void></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>  static_assert(std::is_same<HANDLE, void*>::value,</div> +<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="stringliteral">"Expected `HANDLE` to be of type `void*`."</span>);</div> <div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div> -<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Deleter></div> -<div class="line"><a name="l00084"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a67dea37bc1c958578f992ccc40a40899"> 84</a></span>  <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="l00085"></a><span class="lineno"> 85</span>  : std::shared_ptr<void>(handle, deleter) {}</div> -<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> </div> -<div class="line"><a name="l00087"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa"> 87</a></span>  <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-><span class="keyword">get</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> </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> <span class="comment">// Definitions and constants used for Windows compat.</span></div> -<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="comment">//</span></div> -<div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="comment">// Gathers most of the Windows-compatibility definitions. This makes it</span></div> -<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="comment">// possible for files throughout the codebase to remain relatively free of all</span></div> -<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="comment">// the #if's we'd need to make them work.</span></div> -<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="comment">//</span></div> -<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="comment">// Roughly, the things that should go in this file are definitions and</span></div> -<div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment">// declarations that one would not mind being:</span></div> -<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <span class="comment">// * in global scope.</span></div> -<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment">// * globally available throughout both the Stout codebase, and any code</span></div> -<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment">// that uses it (such as Mesos).</span></div> -<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div> -<div class="line"><a name="l00103"></a><span class="lineno"> 103</span> </div> -<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment">// This code un-defines the global `GetMessage` macro defined by the Windows</span></div> -<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment">// headers, and replaces it with an inline function that is equivalent.</span></div> -<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="comment">//</span></div> -<div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment">// There are two reasons for doing this. The first is because this macro</span></div> -<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment">// interferes with `google::protobufs::Reflection::GetMessage`. Replacing the</span></div> -<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment">// `GetMessage` macro with an inline function allows people calling the</span></div> -<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment">// `GetMessage` macro to carry on doing so with no code changes, but it will</span></div> -<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment">// also allow us to use `google::protobufs::Reflection::GetMessage` without</span></div> -<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment">// interference from the macro.</span></div> -<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="comment">//</span></div> -<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment">// The second is because we don't want to obliterate the `GetMessage` macro for</span></div> -<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment">// people who include this header, either on purpose, or incidentally as part</span></div> -<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment">// of some other Mesos header. The effect is that our need to call protobuf's</span></div> -<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment">// `GetMessage` function has no deleterious effect on customers of this API.</span></div> -<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">//</span></div> -<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment">// NOTE: the Windows headers also don't use define-once semantics for the</span></div> -<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment">// `GetMessage` macro. In particular, this means that every time you include</span></div> -<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment">// `Winuser.h` and a `GetMessage` macro isn't defined, the Windows headers will</span></div> -<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <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="l00123"></a><span class="lineno"> 123</span> <span class="comment">// macro every time you include `Windows.h`; since we should be including</span></div> -<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment">// `Windows.h` only from this file, we un-define it just after we include</span></div> -<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment">// `Windows.h`.</span></div> -<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="preprocessor">#ifdef GetMessage</span></div> -<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessageWindows(</div> -<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  LPMSG lpMsg,</div> -<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  HWND hWnd,</div> -<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  UINT wMsgFilterMin,</div> -<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  UINT wMsgFilterMax)</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>  <span class="keywordflow">return</span> GetMessage(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</div> -<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> }</div> -<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="preprocessor">#undef GetMessage</span></div> -<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessage(</div> +<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="keyword">public</span>:</div> +<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="comment">// We delete the default constructor so that the callsite is forced to make</span></div> +<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <span class="comment">// an explicit decision about what the empty `HANDLE` value should be, as it</span></div> +<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <span class="comment">// is not the same for all `HANDLE` types. For example, `OpenProcess`</span></div> +<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="comment">// returns a `nullptr` for an invalid handle, but `CreateFile` returns an</span></div> +<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// `INVALID_HANDLE_VALUE` instead. This inconsistency is inherent in the</span></div> +<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// Windows API.</span></div> +<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <a class="code" href="classSharedHandle.html#ad2cfca1ab3db9839e617b569b225e0c0">SharedHandle</a>() = <span class="keyword">delete</span>;</div> +<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> </div> +<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Deleter></div> +<div class="line"><a name="l00093"></a><span class="lineno"><a class="line" href="classSharedHandle.html#a67dea37bc1c958578f992ccc40a40899"> 93</a></span>  <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="l00094"></a><span class="lineno"> 94</span>  : std::shared_ptr<void>(handle, deleter) {}</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="classSharedHandle.html#a800385e17e17cb826147968e748fd8fa"> 96</a></span>  <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-><span class="keyword">get</span>(); }</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> </div> +<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> </div> +<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment">// Definitions and constants used for Windows compat.</span></div> +<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment">//</span></div> +<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <span class="comment">// Gathers most of the Windows-compatibility definitions. This makes it</span></div> +<div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <span class="comment">// possible for files throughout the codebase to remain relatively free of all</span></div> +<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment">// the #if's we'd need to make them work.</span></div> +<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment">//</span></div> +<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="comment">// Roughly, the things that should go in this file are definitions and</span></div> +<div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment">// declarations that one would not mind being:</span></div> +<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment">// * in global scope.</span></div> +<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment">// * globally available throughout both the Stout codebase, and any code</span></div> +<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment">// that uses it (such as Mesos).</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"> 113</span> <span class="comment">// This code un-defines the global `GetMessage` macro defined by the Windows</span></div> +<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment">// headers, and replaces it with an inline function that is equivalent.</span></div> +<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment">//</span></div> +<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment">// There are two reasons for doing this. The first is because this macro</span></div> +<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment">// interferes with `google::protobufs::Reflection::GetMessage`. Replacing the</span></div> +<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">// `GetMessage` macro with an inline function allows people calling the</span></div> +<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment">// `GetMessage` macro to carry on doing so with no code changes, but it will</span></div> +<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment">// also allow us to use `google::protobufs::Reflection::GetMessage` without</span></div> +<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment">// interference from the macro.</span></div> +<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment">//</span></div> +<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment">// The second is because we don't want to obliterate the `GetMessage` macro for</span></div> +<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment">// people who include this header, either on purpose, or incidentally as part</span></div> +<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment">// of some other Mesos header. The effect is that our need to call protobuf's</span></div> +<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment">// `GetMessage` function has no deleterious effect on customers of this API.</span></div> +<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment">//</span></div> +<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="comment">// NOTE: the Windows headers also don't use define-once semantics for the</span></div> +<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment">// `GetMessage` macro. In particular, this means that every time you include</span></div> +<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment">// `Winuser.h` and a `GetMessage` macro isn't defined, the Windows headers will</span></div> +<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <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="l00132"></a><span class="lineno"> 132</span> <span class="comment">// macro every time you include `Windows.h`; since we should be including</span></div> +<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">// `Windows.h` only from this file, we un-define it just after we include</span></div> +<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment">// `Windows.h`.</span></div> +<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="preprocessor">#ifdef GetMessage</span></div> +<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessageWindows(</div> <div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  LPMSG lpMsg,</div> <div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  HWND hWnd,</div> <div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  UINT wMsgFilterMin,</div> <div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  UINT wMsgFilterMax)</div> <div class="line"><a name="l00141"></a><span class="lineno"> 141</span> {</div> -<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <span class="keywordflow">return</span> GetMessageWindows(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</div> +<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <span class="keywordflow">return</span> GetMessage(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</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="preprocessor">#endif // GetMessage</span></div> -<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="preprocessor"></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">// Define constants used for Windows compat. Allows a lot of code on</span></div> -<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment">// Windows and POSIX systems to be the same, because we can pass the</span></div> -<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment">// same constants to functions we call to do things like file I/O.</span></div> -<div class="line"><a name="l00150"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afcf80a6d91178952d107ad00b165752b"> 150</a></span> <span class="preprocessor">#define STDIN_FILENO 0</span></div> -<div class="line"><a name="l00151"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abd165ee6474b5b75bf075842fff13a04"> 151</a></span> <span class="preprocessor"></span><span class="preprocessor">#define STDOUT_FILENO 1</span></div> -<div class="line"><a name="l00152"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae2fe1725bb5e9823d089c46b9ed5266e"> 152</a></span> <span class="preprocessor"></span><span class="preprocessor">#define STDERR_FILENO 2</span></div> -<div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <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#a24a7a0ceb1e8f5f44cb1038bb829030d"> 154</a></span> <span class="preprocessor">#define R_OK 0x4</span></div> -<div class="line"><a name="l00155"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae5acf4043c0903cda7436b108e29e8e6"> 155</a></span> <span class="preprocessor"></span><span class="preprocessor">#define W_OK 0x2</span></div> -<div class="line"><a name="l00156"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a5e995ef7690698b62bf016b14fbc45ca"> 156</a></span> <span class="preprocessor"></span><span class="preprocessor">#define X_OK 0x0 // No such permission on Windows.</span></div> -<div class="line"><a name="l00157"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#af837744613408b57dc3654fbc3bcf900"> 157</a></span> <span class="preprocessor"></span><span class="preprocessor">#define F_OK 0x0</span></div> -<div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00159"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a7a68c9ffaac7dbcd652225dd7c06a54b"> 159</a></span> <span class="preprocessor">#define O_RDONLY _O_RDONLY</span></div> -<div class="line"><a name="l00160"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a11b644a8526139c4cc1850dac1271ced"> 160</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_WRONLY _O_WRONLY</span></div> -<div class="line"><a name="l00161"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abb0586253488ee61072b73557eeb873b"> 161</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_RDWR _O_RDWR</span></div> -<div class="line"><a name="l00162"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1cf6b1de1fffedaa1d26b189e9a8d2cc"> 162</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_CREAT _O_CREAT</span></div> -<div class="line"><a name="l00163"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad1d67e453fb3031f40f8cd3403773813"> 163</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_TRUNC _O_TRUNC</span></div> -<div class="line"><a name="l00164"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae036f789407d21f07b211552d67b3214"> 164</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_APPEND _O_APPEND</span></div> -<div class="line"><a name="l00165"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad6d8fbe4e494b4dbe051612572d3f757"> 165</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_CLOEXEC _O_NOINHERIT</span></div> -<div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00167"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afd80ecbe3170ca4fc85b65cda8659f82"> 167</a></span> <span class="preprocessor">#define MAXHOSTNAMELEN NI_MAXHOST</span></div> -<div class="line"><a name="l00168"></a><span class="lineno"> 168</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00169"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae688d728e1acdfe5988c7db45d6f0166"> 169</a></span> <span class="preprocessor">#define PATH_MAX _MAX_PATH</span></div> -<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="comment">// NOTE: for details on what this value should be, consult [1], [2], and [3].</span></div> -<div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="comment">//</span></div> -<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <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="l00174"></a><span class="lineno"> 174</span> <span class="comment">// [2] https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits</span></div> -<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment">// [3] https://msdn.microsoft.com/en-us/library/930f87yf.aspx</span></div> -<div class="line"><a name="l00176"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1381461ccf8dfff5cf9aba8e7b741b1a"> 176</a></span> <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="l00177"></a><span class="lineno"> 177</span> </div> -<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">// Corresponds to `mode_t` defined in sys/types.h of the POSIX spec.</span></div> -<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="comment">// See large "permissions API" comment below for an explanation of</span></div> -<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment">// why this is an int instead of unsigned short (as is common on</span></div> -<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment">// POSIX).</span></div> -<div class="line"><a name="l00182"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c"> 182</a></span> <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="l00183"></a><span class="lineno"> 183</span> </div> -<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment">// `DWORD` is expected to be the type holding PIDs throughout the Windows API,</span></div> -<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="comment">// including functions like `OpenProcess`.</span></div> -<div class="line"><a name="l00186"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9"> 186</a></span> <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="l00187"></a><span class="lineno"> 187</span> </div> -<div class="line"><a name="l00188"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63"> 188</a></span> <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="l00189"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb"> 189</a></span> <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="l00190"></a><span class="lineno"> 190</span> </div> -<div class="line"><a name="l00191"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386"> 191</a></span> <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="l00144"></a><span class="lineno"> 144</span> <span class="preprocessor">#undef GetMessage</span></div> +<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="preprocessor"></span><span class="keyword">inline</span> BOOL GetMessage(</div> +<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  LPMSG lpMsg,</div> +<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  HWND hWnd,</div> +<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  UINT wMsgFilterMin,</div> +<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  UINT wMsgFilterMax)</div> +<div class="line"><a name="l00150"></a><span class="lineno"> 150</span> {</div> +<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="keywordflow">return</span> GetMessageWindows(lpMsg, hWnd, wMsgFilterMin, wMsgFilterMax);</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> <span class="preprocessor">#endif // GetMessage</span></div> +<div class="line"><a name="l00154"></a><span class="lineno"> 154</span> <span class="preprocessor"></span></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> <span class="comment">// Define constants used for Windows compat. Allows a lot of code on</span></div> +<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="comment">// Windows and POSIX systems to be the same, because we can pass the</span></div> +<div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="comment">// same constants to functions we call to do things like file I/O.</span></div> +<div class="line"><a name="l00159"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afcf80a6d91178952d107ad00b165752b"> 159</a></span> <span class="preprocessor">#define STDIN_FILENO 0</span></div> +<div class="line"><a name="l00160"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abd165ee6474b5b75bf075842fff13a04"> 160</a></span> <span class="preprocessor"></span><span class="preprocessor">#define STDOUT_FILENO 1</span></div> +<div class="line"><a name="l00161"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae2fe1725bb5e9823d089c46b9ed5266e"> 161</a></span> <span class="preprocessor"></span><span class="preprocessor">#define STDERR_FILENO 2</span></div> +<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="preprocessor"></span></div> +<div class="line"><a name="l00163"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a24a7a0ceb1e8f5f44cb1038bb829030d"> 163</a></span> <span class="preprocessor">#define R_OK 0x4</span></div> +<div class="line"><a name="l00164"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae5acf4043c0903cda7436b108e29e8e6"> 164</a></span> <span class="preprocessor"></span><span class="preprocessor">#define W_OK 0x2</span></div> +<div class="line"><a name="l00165"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a5e995ef7690698b62bf016b14fbc45ca"> 165</a></span> <span class="preprocessor"></span><span class="preprocessor">#define X_OK 0x0 // No such permission on Windows.</span></div> +<div class="line"><a name="l00166"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#af837744613408b57dc3654fbc3bcf900"> 166</a></span> <span class="preprocessor"></span><span class="preprocessor">#define F_OK 0x0</span></div> +<div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <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#a7a68c9ffaac7dbcd652225dd7c06a54b"> 168</a></span> <span class="preprocessor">#define O_RDONLY _O_RDONLY</span></div> +<div class="line"><a name="l00169"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a11b644a8526139c4cc1850dac1271ced"> 169</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_WRONLY _O_WRONLY</span></div> +<div class="line"><a name="l00170"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abb0586253488ee61072b73557eeb873b"> 170</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_RDWR _O_RDWR</span></div> +<div class="line"><a name="l00171"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1cf6b1de1fffedaa1d26b189e9a8d2cc"> 171</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_CREAT _O_CREAT</span></div> +<div class="line"><a name="l00172"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad1d67e453fb3031f40f8cd3403773813"> 172</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_TRUNC _O_TRUNC</span></div> +<div class="line"><a name="l00173"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae036f789407d21f07b211552d67b3214"> 173</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_APPEND _O_APPEND</span></div> +<div class="line"><a name="l00174"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ad6d8fbe4e494b4dbe051612572d3f757"> 174</a></span> <span class="preprocessor"></span><span class="preprocessor">#define O_CLOEXEC _O_NOINHERIT</span></div> +<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="preprocessor"></span></div> +<div class="line"><a name="l00176"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afd80ecbe3170ca4fc85b65cda8659f82"> 176</a></span> <span class="preprocessor">#define MAXHOSTNAMELEN NI_MAXHOST</span></div> +<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="preprocessor"></span></div> +<div class="line"><a name="l00178"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ae688d728e1acdfe5988c7db45d6f0166"> 178</a></span> <span class="preprocessor">#define PATH_MAX _MAX_PATH</span></div> +<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="preprocessor"></span></div> +<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment">// NOTE: for details on what this value should be, consult [1], [2], and [3].</span></div> +<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment">//</span></div> +<div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <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="l00183"></a><span class="lineno"> 183</span> <span class="comment">// [2] https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits</span></div> +<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment">// [3] https://msdn.microsoft.com/en-us/library/930f87yf.aspx</span></div> +<div class="line"><a name="l00185"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a1381461ccf8dfff5cf9aba8e7b741b1a"> 185</a></span> <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="l00186"></a><span class="lineno"> 186</span> </div> +<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="comment">// Corresponds to `mode_t` defined in sys/types.h of the POSIX spec.</span></div> +<div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment">// See large "permissions API" comment below for an explanation of</span></div> +<div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="comment">// why this is an int instead of unsigned short (as is common on</span></div> +<div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment">// POSIX).</span></div> +<div class="line"><a name="l00191"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c"> 191</a></span> <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="l00192"></a><span class="lineno"> 192</span> </div> -<div class="line"><a name="l00193"></a><span class="lineno"> 193</span> <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="l00194"></a><span class="lineno"> 194</span> <span class="comment">// the Windows versions of these flags to their POSIX equivalents so we don't</span></div> -<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="comment">// have to change any socket code.</span></div> -<div class="line"><a name="l00196"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a337bdc938215c39cd21ddd11106189c6"> 196</a></span> 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="l00197"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac3d4e32482af3ec2158643d9996d78da"> 197</a></span> 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="l00198"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc5dbd13b73a0a66d7fa25364a3f7d77"> 198</a></span> 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="l00199"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8810ebeb993fc304af15b6cb1544ddf1"> 199</a></span> 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="l00200"></a><span class="lineno"> 200</span> </div> -<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="comment">// The following functions are usually macros on POSIX; we provide them here as</span></div> -<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <span class="comment">// functions to avoid having global macros lying around. Note that these</span></div> -<div class="line"><a name="l00203"></a><span class="lineno"> 203</span> <span class="comment">// operate on the `_stat` struct (a Windows version of the standard POSIX</span></div> -<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// `stat` struct), of which the `st_mode` field is known to be an `int`.</span></div> -<div class="line"><a name="l00205"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc71c1741c013cc1f2fb33c5e1e6f139"> 205</a></span> <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="l00206"></a><span class="lineno"> 206</span> {</div> -<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == S_IFDIR; <span class="comment">// Directory.</span></div> -<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> }</div> +<div class="line"><a name="l00193"></a><span class="lineno"> 193</span> <span class="comment">// `DWORD` is expected to be the type holding PIDs throughout the Windows API,</span></div> +<div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="comment">// including functions like `OpenProcess`.</span></div> +<div class="line"><a name="l00195"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9"> 195</a></span> <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="l00196"></a><span class="lineno"> 196</span> </div> +<div class="line"><a name="l00197"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63"> 197</a></span> <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="l00198"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb"> 198</a></span> <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="l00199"></a><span class="lineno"> 199</span> </div> +<div class="line"><a name="l00200"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386"> 200</a></span> <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="l00201"></a><span class="lineno"> 201</span> </div> +<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <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="l00203"></a><span class="lineno"> 203</span> <span class="comment">// the Windows versions of these flags to their POSIX equivalents so we don't</span></div> +<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// have to change any socket code.</span></div> +<div class="line"><a name="l00205"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a337bdc938215c39cd21ddd11106189c6"> 205</a></span> 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="l00206"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac3d4e32482af3ec2158643d9996d78da"> 206</a></span> 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="l00207"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc5dbd13b73a0a66d7fa25364a3f7d77"> 207</a></span> 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="l00208"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8810ebeb993fc304af15b6cb1544ddf1"> 208</a></span> 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="l00209"></a><span class="lineno"> 209</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"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a4c11a40f6ccc71f875e8f11929aad707"> 211</a></span> <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="l00212"></a><span class="lineno"> 212</span> {</div> -<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == S_IFREG; <span class="comment">// File.</span></div> -<div class="line"><a name="l00214"></a><span class="lineno"> 214</span> }</div> -<div class="line"><a name="l00215"></a><span class="lineno"> 215</span> </div> -<div class="line"><a name="l00216"></a><span class="lineno"> 216</span> </div> -<div class="line"><a name="l00217"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a74ba556c8168bb9556a34cf25d5fbb4a"> 217</a></span> <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="l00218"></a><span class="lineno"> 218</span> {</div> -<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == S_IFCHR; <span class="comment">// Character device.</span></div> -<div class="line"><a name="l00220"></a><span class="lineno"> 220</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"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac0d1cccc8a710f9b2ca7e8f25892d2a5"> 223</a></span> <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="l00224"></a><span class="lineno"> 224</span> {</div> -<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == _S_IFIFO; <span class="comment">// Pipe.</span></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"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a292ccd479f68ea0e4b53ee393f165872"> 229</a></span> <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="l00230"></a><span class="lineno"> 230</span> {</div> -<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Block special device.</span></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> </div> -<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> </div> -<div class="line"><a name="l00235"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a953b4d8769906f7afe486c0ee0955fd3"> 235</a></span> <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="l00236"></a><span class="lineno"> 236</span> {</div> -<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Socket.</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> </div> -<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> </div> -<div class="line"><a name="l00241"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a255249008157db126b6981929505f9e4"> 241</a></span> <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="l00242"></a><span class="lineno"> 242</span> {</div> -<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Symbolic link.</span></div> -<div class="line"><a name="l00244"></a><span class="lineno"> 244</span> }</div> -<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> </div> -<div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="comment">// Permissions API. (cf. MESOS-3176 to track ongoing permissions work.)</span></div> -<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="comment">//</span></div> -<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <span class="comment">// We are currently able to emulate a subset of the POSIX permissions model</span></div> -<div class="line"><a name="l00249"></a><span class="lineno"> 249</span> <span class="comment">// with the Windows model:</span></div> -<div class="line"><a name="l00250"></a><span class="lineno"> 250</span> <span class="comment">// [x] User write permissions.</span></div> -<div class="line"><a name="l00251"></a><span class="lineno"> 251</span> <span class="comment">// [x] User read permissions.</span></div> -<div class="line"><a name="l00252"></a><span class="lineno"> 252</span> <span class="comment">// [ ] User execute permissions.</span></div> -<div class="line"><a name="l00253"></a><span class="lineno"> 253</span> <span class="comment">// [ ] Group permissions of any sort.</span></div> -<div class="line"><a name="l00254"></a><span class="lineno"> 254</span> <span class="comment">// [ ] Other permissions of any sort.</span></div> -<div class="line"><a name="l00255"></a><span class="lineno"> 255</span> <span class="comment">// [x] Flags to control "fallback" behavior (e.g., we might choose</span></div> -<div class="line"><a name="l00256"></a><span class="lineno"> 256</span> <span class="comment">// to fall back to user readability when the user passes the</span></div> -<div class="line"><a name="l00257"></a><span class="lineno"> 257</span> <span class="comment">// group readability flag in, since we currently do not support</span></div> -<div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="comment">// group readability).</span></div> -<div class="line"><a name="l00259"></a><span class="lineno"> 259</span> <span class="comment">//</span></div> -<div class="line"><a name="l00260"></a><span class="lineno"> 260</span> <span class="comment">//</span></div> -<div class="line"><a name="l00261"></a><span class="lineno"> 261</span> <span class="comment">// Rationale:</span></div> -<div class="line"><a name="l00262"></a><span class="lineno"> 262</span> <span class="comment">// Windows currently implements two permissions models: (1) an extremely</span></div> -<div class="line"><a name="l00263"></a><span class="lineno"> 263</span> <span class="comment">// primitive permission model it largely inherited from DOS, and (2) the Access</span></div> -<div class="line"><a name="l00264"></a><span class="lineno"> 264</span> <span class="comment">// Control List (ACL) API. Because there is no trivial way to map the classic</span></div> -<div class="line"><a name="l00265"></a><span class="lineno"> 265</span> <span class="comment">// POSIX model into the ACL model, we have implemented POSIX-style permissions</span></div> -<div class="line"><a name="l00266"></a><span class="lineno"> 266</span> <span class="comment">// in terms of the DOS model. The result is the permissions limitations above.</span></div> -<div class="line"><a name="l00267"></a><span class="lineno"> 267</span> <span class="comment">//</span></div> +<div class="line"><a name="l00210"></a><span class="lineno"> 210</span> <span class="comment">// The following functions are usually macros on POSIX; we provide them here as</span></div> +<div class="line"><a name="l00211"></a><span class="lineno"> 211</span> <span class="comment">// functions to avoid having global macros lying around. Note that these</span></div> +<div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="comment">// operate on the `_stat` struct (a Windows version of the standard POSIX</span></div> +<div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="comment">// `stat` struct), of which the `st_mode` field is known to be an `int`.</span></div> +<div class="line"><a name="l00214"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#abc71c1741c013cc1f2fb33c5e1e6f139"> 214</a></span> <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="l00215"></a><span class="lineno"> 215</span> {</div> +<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == S_IFDIR; <span class="comment">// Directory.</span></div> +<div class="line"><a name="l00217"></a><span class="lineno"> 217</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"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a4c11a40f6ccc71f875e8f11929aad707"> 220</a></span> <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="l00221"></a><span class="lineno"> 221</span> {</div> +<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == S_IFREG; <span class="comment">// File.</span></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"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a74ba556c8168bb9556a34cf25d5fbb4a"> 226</a></span> <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="l00227"></a><span class="lineno"> 227</span> {</div> +<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == S_IFCHR; <span class="comment">// Character device.</span></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> </div> +<div class="line"><a name="l00231"></a><span class="lineno"> 231</span> </div> +<div class="line"><a name="l00232"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ac0d1cccc8a710f9b2ca7e8f25892d2a5"> 232</a></span> <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="l00233"></a><span class="lineno"> 233</span> {</div> +<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  <span class="keywordflow">return</span> (mode & S_IFMT) == _S_IFIFO; <span class="comment">// Pipe.</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> </div> +<div class="line"><a name="l00237"></a><span class="lineno"> 237</span> </div> +<div class="line"><a name="l00238"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a292ccd479f68ea0e4b53ee393f165872"> 238</a></span> <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="l00239"></a><span class="lineno"> 239</span> {</div> +<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Block special device.</span></div> +<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> }</div> +<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> </div> +<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> </div> +<div class="line"><a name="l00244"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a953b4d8769906f7afe486c0ee0955fd3"> 244</a></span> <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="l00245"></a><span class="lineno"> 245</span> {</div> +<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Socket.</span></div> +<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> }</div> +<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> </div> +<div class="line"><a name="l00249"></a><span class="lineno"> 249</span> </div> +<div class="line"><a name="l00250"></a><span class="lineno"><a class="line" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a255249008157db126b6981929505f9e4"> 250</a></span> <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="l00251"></a><span class="lineno"> 251</span> {</div> +<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Symbolic link.</span></div> +<div class="line"><a name="l00253"></a><span class="lineno"> 253</span> }</div> +<div class="line"><a name="l00254"></a><span class="lineno"> 25
<TRUNCATED>
