You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by gi...@apache.org on 2018/05/23 22:00:04 UTC

[04/13] mesos-site git commit: Updated the website built from mesos SHA: 21305ab.

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/0a0aa73e/content/api/latest/c++/windows_2dup_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/windows_2dup_8hpp_source.html b/content/api/latest/c++/windows_2dup_8hpp_source.html
index 8537c3b..b052c41 100644
--- a/content/api/latest/c++/windows_2dup_8hpp_source.html
+++ b/content/api/latest/c++/windows_2dup_8hpp_source.html
@@ -52,7 +52,7 @@
 <div class="title">dup.hpp</div>  </div>
 </div><!--header-->
 <div class="contents">
-<a href="windows_2dup_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// you may not use this file except in compliance with the License.</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy of the License at</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">//  http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00006"></a><span class="lineno">    6</span>&#160;<span class="comment">//<
 /span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;</div><div class
 ="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#ifndef __STOUT_OS_WINDOWS_DUP_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#define __STOUT_OS_WINDOWS_DUP_HPP__</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;</div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="error_8hpp.html">stout/error.hpp</a>&gt;</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="try_8hpp.html">stout/try.hpp</a>&gt;</span></div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="unreachable_8hpp.html">stout/unreachable.hpp</a>&gt;</span></div><div class="line"><a name="l
 00019"></a><span class="lineno">   19</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>&gt;</span> <span class="comment">// For `WinSock2.h`.</span></div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;</div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;</div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;</div><div class="line"><a name="l00025"></a><span class="lineno"><a class="line" href="namespaceos.html#ac6a52f61ab8f31856757007
 b4be7f5e6">   25</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;int_fd&gt;</a> <a class="code" href="namespaceos.html#a622be738276833e635a7db06cff31a35">dup</a>(<span class="keyword">const</span> <a class="code" href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&amp; fd)</div><div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;{</div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;  <span class="keywordflow">switch</span> (fd.type()) {</div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5ad09c4cb1265f1772bb757a7af277b49f">WindowsFD::Type::HANDLE</a>: {</div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;      <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a9342
 08b6017d0a9aed90b6594bb8292f">HANDLE</a> duplicate = INVALID_HANDLE_VALUE;</div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;      <span class="keyword">const</span> BOOL result = ::DuplicateHandle(</div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;          ::GetCurrentProcess(),  <span class="comment">// Source process == current.</span></div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;          fd,                     <span class="comment">// Handle to duplicate.</span></div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;          ::GetCurrentProcess(),  <span class="comment">// Target process == current.</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;          &amp;duplicate,</div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;          0,                      <span class="comm
 ent">// Ignored (DUPLICATE_SAME_ACCESS).</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;          FALSE,                  <span class="comment">// Non-inheritable handle.</span></div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;          DUPLICATE_SAME_ACCESS); <span class="comment">// Same access level as source.</span></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="keywordflow">if</span> (result == FALSE) {</div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;      }</div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#16
 0;</div><div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;      <span class="keywordflow">return</span> duplicate;</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;    }</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">WindowsFD::Type::SOCKET</a>: {</div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;      WSAPROTOCOL_INFOW info;</div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;      <span class="keyword">const</span> <span class="keywordtype">int</span> result =</div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;        ::WSADuplicateSocketW(fd, ::GetCurrentProcessId(), &amp;info);</div><div class="line"><a name="l00049"></a><span class=
 "lineno">   49</span>&#160;      <span class="keywordflow">if</span> (result != 0) {</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="error_8hpp.html#a176f6fc34ea37d40201853a52a475762">SocketError</a>();</div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;      }</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;      return ::WSASocketW(0, 0, 0, &amp;info, 0, 0);</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;    }</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;  }</div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;</div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;  <a class="code" href="unreachable
 _8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</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;</div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;} <span class="comment">// namespace os {</span></div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;</div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;<span class="preprocessor">#endif // __STOUT_OS_WINDOWS_DUP_HPP__</span></div><div class="ttc" id="classTry_html"><div class="ttname"><a href="classTry.html">Try</a></div><div class="ttdef"><b>Definition:</b> check.hpp:33</div></div>
+<a href="windows_2dup_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// you may not use this file except in compliance with the License.</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy of the License at</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">//  http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00006"></a><span class="lineno">    6</span>&#160;<span class="comment">//<
 /span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;</div><div class
 ="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#ifndef __STOUT_OS_WINDOWS_DUP_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#define __STOUT_OS_WINDOWS_DUP_HPP__</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;</div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="error_8hpp.html">stout/error.hpp</a>&gt;</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="try_8hpp.html">stout/try.hpp</a>&gt;</span></div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="unreachable_8hpp.html">stout/unreachable.hpp</a>&gt;</span></div><div class="line"><a name="l
 00019"></a><span class="lineno">   19</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>&gt;</span> <span class="comment">// For `WinSock2.h`.</span></div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;</div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;</div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;</div><div class="line"><a name="l00025"></a><span class="lineno"><a class="line" href="namespaceos.html#ac6a52f61ab8f31856757007
 b4be7f5e6">   25</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;int_fd&gt;</a> <a class="code" href="namespaceos.html#a622be738276833e635a7db06cff31a35">dup</a>(<span class="keyword">const</span> <a class="code" href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&amp; fd)</div><div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;{</div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;  <span class="keywordflow">switch</span> (fd.type()) {</div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5ad09c4cb1265f1772bb757a7af277b49f">WindowsFD::Type::HANDLE</a>: {</div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;      <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a9342
 08b6017d0a9aed90b6594bb8292f">HANDLE</a> duplicate = INVALID_HANDLE_VALUE;</div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;      <span class="keyword">const</span> BOOL result = ::DuplicateHandle(</div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;          ::GetCurrentProcess(),  <span class="comment">// Source process == current.</span></div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;          fd,                     <span class="comment">// Handle to duplicate.</span></div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;          ::GetCurrentProcess(),  <span class="comment">// Target process == current.</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;          &amp;duplicate,</div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;          0,                      <span class="comm
 ent">// Ignored (DUPLICATE_SAME_ACCESS).</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;          FALSE,                  <span class="comment">// Non-inheritable handle.</span></div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;          DUPLICATE_SAME_ACCESS); <span class="comment">// Same access level as source.</span></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="keywordflow">if</span> (result == FALSE) {</div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;      }</div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#16
 0;</div><div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>(duplicate, fd.is_overlapped());</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;    }</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">WindowsFD::Type::SOCKET</a>: {</div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;      WSAPROTOCOL_INFOW info;</div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;      <span class="keyword">const</span> <span class="keywordtype">int</span> result =</div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;        ::WSADuplica
 teSocketW(fd, ::GetCurrentProcessId(), &amp;info);</div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;      <span class="keywordflow">if</span> (result != 0) {</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="error_8hpp.html#a176f6fc34ea37d40201853a52a475762">SocketError</a>();</div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;      }</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;      return ::WSASocketW(0, 0, 0, &amp;info, 0, 0);</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;    }</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;  }</div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;</div><div c
 lass="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;  <a class="code" href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</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;</div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;} <span class="comment">// namespace os {</span></div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;</div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;<span class="preprocessor">#endif // __STOUT_OS_WINDOWS_DUP_HPP__</span></div><div class="ttc" id="classTry_html"><div class="ttname"><a href="classTry.html">Try</a></div><div class="ttdef"><b>Definition:</b> check.hpp:33</div></div>
 <div class="ttc" id="classWindowsError_html"><div class="ttname"><a href="classWindowsError.html">WindowsError</a></div><div class="ttdef"><b>Definition:</b> error.hpp:108</div></div>
 <div class="ttc" id="namespaceos_html"><div class="ttname"><a href="namespaceos.html">os</a></div><div class="ttdef"><b>Definition:</b> posix_signalhandler.hpp:23</div></div>
 <div class="ttc" id="classos_1_1WindowsFD_html_ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa"><div class="ttname"><a href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">os::WindowsFD::Type::SOCKET</a></div></div>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/0a0aa73e/content/api/latest/c++/windows_2open_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/windows_2open_8hpp_source.html b/content/api/latest/c++/windows_2open_8hpp_source.html
index cd1a556..79ad81c 100644
--- a/content/api/latest/c++/windows_2open_8hpp_source.html
+++ b/content/api/latest/c++/windows_2open_8hpp_source.html
@@ -52,10 +52,10 @@
 <div class="title">open.hpp</div>  </div>
 </div><!--header-->
 <div class="contents">
-<a href="windows_2open_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// you may not use this file except in compliance with the License.</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy of the License at</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">//  http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00006"></a><span class="lineno">    6</span>&#160;<span class="comment">//
 </span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;</div><div clas
 s="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#ifndef __STOUT_OS_WINDOWS_OPEN_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#define __STOUT_OS_WINDOWS_OPEN_HPP__</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;</div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;<span class="preprocessor">#include &lt;fcntl.h&gt;</span> <span class="comment">// For file access flags like `_O_CREAT`.</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;</div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a name="l00019"></a><span class="lineno">   19</span>&#160;</div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;<span class=
 "preprocessor">#include &lt;<a class="code" href="error_8hpp.html">stout/error.hpp</a>&gt;</span></div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="try_8hpp.html">stout/try.hpp</a>&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>&gt;</span> <span class="comment">// For `mode_t`.</span></div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;</div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>&gt;</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;</div><div class="line"><a name="l00026"></a><span class="lineno">  
  26</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="longpath_8hpp.html">stout/internal/windows/longpath.hpp</a>&gt;</span></div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;</div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;<span class="comment">// TODO(andschwa): Windows does not support the Linux extension</span></div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="comment">// O_NONBLOCK, as asynchronous I/O is done through other mechanisms.</span></div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="comment">// Overlapped I/O will be implemented later.</span></div><div class="line"><a name="l00031"></a><span class="lineno"><a class="line" href="windows_2open_8hpp.html#a3e8a4870d44496f4236c6c7e32722d97">   31</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="windows_2open
 _8hpp.html#a3e8a4870d44496f4236c6c7e32722d97">O_NONBLOCK</a> = 0;</div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;</div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;<span class="comment">// Windows does not support the Linux extension O_SYNC, as buffering</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;<span class="comment">// is done differently.</span></div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="comment">// TODO(andschwa): This could be equivalent to</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="comment">// `FILE_FLAG_WRITE_THROUGH`, but we don&#39;t seem to need it.</span></div><div class="line"><a name="l00037"></a><span class="lineno"><a class="line" href="windows_2open_8hpp.html#a90f563755a3487471e47a64aa01daf2c">   37</a></span>&#160;constexpr <span class="keyw
 ordtype">int</span> <a class="code" href="windows_2open_8hpp.html#a90f563755a3487471e47a64aa01daf2c">O_SYNC</a> = 0;</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="comment">// Windows does not support the Linux extension O_CLOEXEC. Instead, by</span></div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="comment">// default we set all handles to be non-inheritable.</span></div><div class="line"><a name="l00041"></a><span class="lineno"><a class="line" href="windows_2open_8hpp.html#ae477ca5323e49dcb433426280be75067">   41</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="windows_2open_8hpp.html#ae477ca5323e49dcb433426280be75067">O_CLOEXEC</a> = 0;</div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;</div><div class="line"><a name="l00043"></a><span
  class="lineno">   43</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;<span class="comment">// TODO(andschwa): Handle specified creation permissions in `mode_t mode`. See</span></div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="comment">// MESOS-3176.</span></div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;int_fd&gt;</a> <a class="code" href="namespaceos.html#aaf5d5468adc1b85cf9bb7126e70807ca">open</a>(<span class="keyword">const</span> std::string&amp; <a class="code" href="namespacepath.html">path</a>, <span class="keywordtype">int</span> oflag, <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8
 hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a> = 0)</div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;{</div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;  std::wstring <a class="code" href="namespaceinternal_1_1windows.html#abd7dbdbc8d95626d0c66455078380aa1">longpath</a> = <a class="code" href="namespaceinternal_1_1windows.html#abd7dbdbc8d95626d0c66455078380aa1">::internal::windows::longpath</a>(path);</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;</div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;  <span class="comment">// Map the POSIX `oflag` access flags.</span></div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;  <span class="commen
 t">// O_APPEND: Write only appends.</span></div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;  <span class="comment">//</span></div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;  <span class="comment">// NOTE: We choose a `write` flag here because emulating `O_APPEND`</span></div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;  <span class="comment">// requires granting the `FILE_APPEND_DATA` access right, but not</span></div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;  <span class="comment">// the `FILE_WRITE_DATA` access right, which `GENERIC_WRITE` would</span></div><div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;  <span class="comment">// otherwise grant.</span></div><div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;  <span class="keyword">const</span> DWORD <a class="code" href="namespaceos.
 html#a73da9d49515dfff761c4887c3d6032c0">write</a> = (oflag &amp; O_APPEND) ? FILE_APPEND_DATA : GENERIC_WRITE;</div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;</div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;  DWORD <a class="code" href="namespaceos.html#a426a9c189f65b7e3f63e16eb11ec73c3">access</a>;</div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;  <span class="keywordflow">switch</span> (oflag &amp; (O_RDONLY | O_WRONLY | O_RDWR)) {</div><div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;    <span class="keywordflow">case</span> O_RDONLY: {</div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;      access = GENERIC_READ;</div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00066"></a><span class="lineno">   66</spa
 n>&#160;    }</div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;    <span class="keywordflow">case</span> O_WRONLY: {</div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;      access = <a class="code" href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a>;</div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;    }</div><div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;    <span class="keywordflow">case</span> O_RDWR: {</div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;      access = GENERIC_READ | <a class="code" href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a>;</div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;      <span class="keywordflo
 w">break</span>;</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;    <span class="keywordflow">default</span>: {</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Access mode not specified.&quot;</span>);</div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;    }</div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;  }</div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;</div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;  <span class="comment">// Map the POSIX `oflag` creation flags.</span></div><div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;  DWORD 
 <a class="code" href="namespacecgroups.html#a2ecc89636706df947027a4c3c2100fbe">create</a>;</div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;  <span class="keywordflow">switch</span> (oflag &amp; (O_CREAT | O_EXCL | O_TRUNC)) {</div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;    <span class="keywordflow">case</span> O_CREAT: {</div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;      <span class="comment">// Create a new file or open an existing file.</span></div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;      create = OPEN_ALWAYS;</div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;      <span class="keywordflow">break</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;    <span class="keywor
 dflow">case</span> O_CREAT | O_EXCL:</div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;    <span class="keywordflow">case</span> O_CREAT | O_EXCL | O_TRUNC: {</div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;      <span class="comment">// Create a new file, but fail if it already exists.</span></div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;      <span class="comment">// Ignore `O_TRUNC` with `O_CREAT | O_EXCL`</span></div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;      create = CREATE_NEW;</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;    }</div><div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;    <span class="keywordflow">case</span> O_CREAT | O_TRUNC: 
 {</div><div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;      <span class="comment">// Truncate file if it already exists.</span></div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;      create = CREATE_ALWAYS;</div><div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;    }</div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;    <span class="keywordflow">case</span> O_EXCL:</div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;    <span class="keywordflow">case</span> O_EXCL | O_TRUNC: {</div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;`O_EXCL` is undef
 ined without `O_CREAT`.&quot;</span>);</div><div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;    }</div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;    <span class="keywordflow">case</span> O_TRUNC: {</div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;      <span class="comment">// Truncate file if it exists, otherwise fail.</span></div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;      create = TRUNCATE_EXISTING;</div><div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;    }</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;    <span class="keywordflow">default</span>: {</div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;      <span class="
 comment">// Open file if it exists, otherwise fail.</span></div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;      create = OPEN_EXISTING;</div><div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;    }</div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;  }</div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;</div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;  <span class="keyword">const</span> <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> handle = ::CreateFileW(</div><div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;      longpath.data(),</div><div class="line"><a name="l00118"></a><span class="lineno">  118</s
 pan>&#160;      <a class="code" href="namespaceos.html#a426a9c189f65b7e3f63e16eb11ec73c3">access</a>,</div><div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;      <span class="comment">// Share all access so we don&#39;t lock the file.</span></div><div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;      FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;      <span class="comment">// Disable inheritance by default.</span></div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;      <span class="keyword">nullptr</span>,</div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;      <a class="code" href="namespacecgroups.html#a2ecc89636706df947027a4c3c2100fbe">create</a>,</div><div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;      FILE_ATTRIBUTE_NORMAL,</div><div
  class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;      <span class="comment">// No template file.</span></div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;      <span class="keyword">nullptr</span>);</div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;</div><div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;  <span class="keywordflow">if</span> (handle == INVALID_HANDLE_VALUE) {</div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;  }</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> handle;</d
 iv><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;</div><div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160;} <span class="comment">// namespace os {</span></div><div class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;</div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;<span class="preprocessor">#endif // __STOUT_OS_WINDOWS_OPEN_HPP__</span></div><div class="ttc" id="namespacepath_html"><div class="ttname"><a href="namespacepath.html">path</a></div><div class="ttdef"><b>Definition:</b> path.hpp:26</div></div>
+<a href="windows_2open_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// you may not use this file except in compliance with the License.</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy of the License at</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">//  http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00006"></a><span class="lineno">    6</span>&#160;<span class="comment">//
 </span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;</div><div clas
 s="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#ifndef __STOUT_OS_WINDOWS_OPEN_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#define __STOUT_OS_WINDOWS_OPEN_HPP__</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;</div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;<span class="preprocessor">#include &lt;fcntl.h&gt;</span> <span class="comment">// For file access flags like `_O_CREAT`.</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;</div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a name="l00019"></a><span class="lineno">   19</span>&#160;</div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;<span class=
 "preprocessor">#include &lt;<a class="code" href="error_8hpp.html">stout/error.hpp</a>&gt;</span></div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="try_8hpp.html">stout/try.hpp</a>&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>&gt;</span> <span class="comment">// For `mode_t`.</span></div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;</div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>&gt;</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;</div><div class="line"><a name="l00026"></a><span class="lineno">  
  26</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="longpath_8hpp.html">stout/internal/windows/longpath.hpp</a>&gt;</span></div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;</div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;<span class="comment">// TODO(andschwa): Windows does not support the Linux extension</span></div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="comment">// O_NONBLOCK, as asynchronous I/O is done through other mechanisms.</span></div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="comment">// Overlapped I/O will be implemented later.</span></div><div class="line"><a name="l00031"></a><span class="lineno"><a class="line" href="windows_2open_8hpp.html#a3e8a4870d44496f4236c6c7e32722d97">   31</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="windows_2open
 _8hpp.html#a3e8a4870d44496f4236c6c7e32722d97">O_NONBLOCK</a> = 0;</div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;</div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;<span class="comment">// Windows does not support the Linux extension O_SYNC, as buffering</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;<span class="comment">// is done differently.</span></div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="comment">// TODO(andschwa): This could be equivalent to</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="comment">// `FILE_FLAG_WRITE_THROUGH`, but we don&#39;t seem to need it.</span></div><div class="line"><a name="l00037"></a><span class="lineno"><a class="line" href="windows_2open_8hpp.html#a90f563755a3487471e47a64aa01daf2c">   37</a></span>&#160;constexpr <span class="keyw
 ordtype">int</span> <a class="code" href="windows_2open_8hpp.html#a90f563755a3487471e47a64aa01daf2c">O_SYNC</a> = 0;</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="comment">// Windows does not support the Linux extension O_CLOEXEC. Instead, by</span></div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="comment">// default we set all handles to be non-inheritable.</span></div><div class="line"><a name="l00041"></a><span class="lineno"><a class="line" href="windows_2open_8hpp.html#ae477ca5323e49dcb433426280be75067">   41</a></span>&#160;constexpr <span class="keywordtype">int</span> <a class="code" href="windows_2open_8hpp.html#ae477ca5323e49dcb433426280be75067">O_CLOEXEC</a> = 0;</div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;</div><div class="line"><a name="l00043"></a><span
  class="lineno">   43</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;<span class="comment">// TODO(andschwa): Handle specified creation permissions in `mode_t mode`. See</span></div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="comment">// MESOS-3176.</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">// NOTE: This function always opens files in non-overlapped mode, because</span></div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;<span class="comment">// we only support overlapped pipes and sockets through the `os::pi
 pe`</span></div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;<span class="comment">// and `os::socket` functions.</span></div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;int_fd&gt;</a> <a class="code" href="namespaceos.html#aaf5d5468adc1b85cf9bb7126e70807ca">open</a>(<span class="keyword">const</span> std::string&amp; <a class="code" href="namespacepath.html">path</a>, <span class="keywordtype">int</span> oflag, <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a> = 0)</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;{</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;  std::wstring <a class="code" href="namespaceinter
 nal_1_1windows.html#abd7dbdbc8d95626d0c66455078380aa1">longpath</a> = <a class="code" href="namespaceinternal_1_1windows.html#abd7dbdbc8d95626d0c66455078380aa1">::internal::windows::longpath</a>(path);</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;  <span class="comment">// Map the POSIX `oflag` access flags.</span></div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;</div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;  <span class="comment">// O_APPEND: Write only appends.</span></div><div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;  <span class="comment">//</span></div><div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;  <span class="comment">// NOTE: We choose a `write` flag here because emulating `O_APPEND`</span></div><div class="line"><a na
 me="l00060"></a><span class="lineno">   60</span>&#160;  <span class="comment">// requires granting the `FILE_APPEND_DATA` access right, but not</span></div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;  <span class="comment">// the `FILE_WRITE_DATA` access right, which `GENERIC_WRITE` would</span></div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;  <span class="comment">// otherwise grant.</span></div><div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;  <span class="keyword">const</span> DWORD <a class="code" href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a> = (oflag &amp; O_APPEND) ? FILE_APPEND_DATA : GENERIC_WRITE;</div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;</div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;  DWORD <a class="code" href="namespaceos.html#a426a9c189f65b7e3f63e16eb11ec73c3">access</a>
 ;</div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;  <span class="keywordflow">switch</span> (oflag &amp; (O_RDONLY | O_WRONLY | O_RDWR)) {</div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;    <span class="keywordflow">case</span> O_RDONLY: {</div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;      access = GENERIC_READ;</div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;    }</div><div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;    <span class="keywordflow">case</span> O_WRONLY: {</div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;      access = <a class="code" href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a>;</div><div class="line"><a name="l000
 73"></a><span class="lineno">   73</span>&#160;      <span class="keywordflow">break</span>;</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;    <span class="keywordflow">case</span> O_RDWR: {</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;      access = GENERIC_READ | <a class="code" href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a>;</div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;    }</div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;    <span class="keywordflow">default</span>: {</div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;      <span class="keywordflow">return</span> <a c
 lass="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Access mode not specified.&quot;</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;  }</div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;</div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;  <span class="comment">// Map the POSIX `oflag` creation flags.</span></div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;  DWORD <a class="code" href="namespacecgroups.html#a2ecc89636706df947027a4c3c2100fbe">create</a>;</div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;  <span class="keywordflow">switch</span> (oflag &amp; (O_CREAT | O_EXCL | O_TRUNC)) {</div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;    <span class="keywordfl
 ow">case</span> O_CREAT: {</div><div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;      <span class="comment">// Create a new file or open an existing file.</span></div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;      create = OPEN_ALWAYS;</div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;    }</div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;    <span class="keywordflow">case</span> O_CREAT | O_EXCL:</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;    <span class="keywordflow">case</span> O_CREAT | O_EXCL | O_TRUNC: {</div><div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;      <span class="comment">// Create a new file, but fail if it already exists.</span></div><d
 iv class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;      <span class="comment">// Ignore `O_TRUNC` with `O_CREAT | O_EXCL`</span></div><div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;      create = CREATE_NEW;</div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;    }</div><div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;    <span class="keywordflow">case</span> O_CREAT | O_TRUNC: {</div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;      <span class="comment">// Truncate file if it already exists.</span></div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;      create = CREATE_ALWAYS;</div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;      <span cla
 ss="keywordflow">break</span>;</div><div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;    }</div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;    <span class="keywordflow">case</span> O_EXCL:</div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;    <span class="keywordflow">case</span> O_EXCL | O_TRUNC: {</div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;`O_EXCL` is undefined without `O_CREAT`.&quot;</span>);</div><div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;    }</div><div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;    <span class="keywordflow">case</span> O_TRUNC: {</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;      <span class="comm
 ent">// Truncate file if it exists, otherwise fail.</span></div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;      create = TRUNCATE_EXISTING;</div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;    }</div><div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;    <span class="keywordflow">default</span>: {</div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;      <span class="comment">// Open file if it exists, otherwise fail.</span></div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;      create = OPEN_EXISTING;</div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00117"></a><span class="lineno">  11
 7</span>&#160;    }</div><div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;  }</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="keyword">const</span> <a class="code" href="namespacerouting_1_1queueing_1_1ingress.html#a934208b6017d0a9aed90b6594bb8292f">HANDLE</a> handle = ::CreateFileW(</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;      longpath.data(),</div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;      <a class="code" href="namespaceos.html#a426a9c189f65b7e3f63e16eb11ec73c3">access</a>,</div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;      <span class="comment">// Share all access so we don&#39;t lock the file.</span></div><div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;      FILE_SHARE
 _READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,</div><div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;      <span class="comment">// Disable inheritance by default.</span></div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;      <span class="keyword">nullptr</span>,</div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;      <a class="code" href="namespacecgroups.html#a2ecc89636706df947027a4c3c2100fbe">create</a>,</div><div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;      FILE_ATTRIBUTE_NORMAL,</div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;      <span class="comment">// No template file.</span></div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;      <span class="keyword">nullptr</span>);</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;</div><div class="line"><a na
 me="l00132"></a><span class="lineno">  132</span>&#160;  <span class="keywordflow">if</span> (handle == INVALID_HANDLE_VALUE) {</div><div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classWindowsError.html">WindowsError</a>();</div><div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;  }</div><div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160;</div><div class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;  <span class="keywordflow">return</span> handle;</div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;}</div><div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;</div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;} <span class="comment">// namespace os {</span></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="preprocessor">#endif // __STOUT_OS_WINDOWS_OPEN_HPP__</span></div><div class="ttc" id="namespacepath_html"><div class="ttname"><a href="namespacepath.html">path</a></div><div class="ttdef"><b>Definition:</b> path.hpp:26</div></div>
 <div class="ttc" id="windows_2open_8hpp_html_a3e8a4870d44496f4236c6c7e32722d97"><div class="ttname"><a href="windows_2open_8hpp.html#a3e8a4870d44496f4236c6c7e32722d97">O_NONBLOCK</a></div><div class="ttdeci">constexpr int O_NONBLOCK</div><div class="ttdef"><b>Definition:</b> open.hpp:31</div></div>
 <div class="ttc" id="classError_html"><div class="ttname"><a href="classError.html">Error</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:36</div></div>
-<div class="ttc" id="namespaceos_html_a73da9d49515dfff761c4887c3d6032c0"><div class="ttname"><a href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">os::write</a></div><div class="ttdeci">ssize_t write(const int_fd &amp;fd, const void *data, size_t size)</div><div class="ttdef"><b>Definition:</b> write.hpp:26</div></div>
+<div class="ttc" id="namespaceos_html_a73da9d49515dfff761c4887c3d6032c0"><div class="ttname"><a href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">os::write</a></div><div class="ttdeci">ssize_t write(const int_fd &amp;fd, const void *data, size_t size)</div><div class="ttdef"><b>Definition:</b> write.hpp:72</div></div>
 <div class="ttc" id="classTry_html"><div class="ttname"><a href="classTry.html">Try</a></div><div class="ttdef"><b>Definition:</b> check.hpp:33</div></div>
 <div class="ttc" id="windows_2open_8hpp_html_a90f563755a3487471e47a64aa01daf2c"><div class="ttname"><a href="windows_2open_8hpp.html#a90f563755a3487471e47a64aa01daf2c">O_SYNC</a></div><div class="ttdeci">constexpr int O_SYNC</div><div class="ttdef"><b>Definition:</b> open.hpp:37</div></div>
 <div class="ttc" id="namespaceos_html_aaf5d5468adc1b85cf9bb7126e70807ca"><div class="ttname"><a href="namespaceos.html#aaf5d5468adc1b85cf9bb7126e70807ca">os::open</a></div><div class="ttdeci">Try&lt; int_fd &gt; open(const std::string &amp;path, int oflag, mode_t mode=0)</div><div class="ttdef"><b>Definition:</b> open.hpp:35</div></div>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/0a0aa73e/content/api/latest/c++/windows_2pipe_8hpp.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/windows_2pipe_8hpp.html b/content/api/latest/c++/windows_2pipe_8hpp.html
index cadb0b5..c8d3795 100644
--- a/content/api/latest/c++/windows_2pipe_8hpp.html
+++ b/content/api/latest/c++/windows_2pipe_8hpp.html
@@ -56,8 +56,12 @@
 </div><!--header-->
 <div class="contents">
 <div class="textblock"><code>#include &lt;array&gt;</code><br />
+<code>#include &lt;string&gt;</code><br />
+<code>#include &lt;<a class="el" href="stout_2include_2stout_2check_8hpp_source.html">stout/check.hpp</a>&gt;</code><br />
 <code>#include &lt;<a class="el" href="error_8hpp_source.html">stout/error.hpp</a>&gt;</code><br />
 <code>#include &lt;<a class="el" href="try_8hpp_source.html">stout/try.hpp</a>&gt;</code><br />
+<code>#include &lt;<a class="el" href="uuid_8hpp_source.html">stout/uuid.hpp</a>&gt;</code><br />
+<code>#include &lt;<a class="el" href="3rdparty_2stout_2include_2stout_2windows_8hpp_source.html">stout/windows.hpp</a>&gt;</code><br />
 <code>#include &lt;<a class="el" href="int__fd_8hpp_source.html">stout/os/int_fd.hpp</a>&gt;</code><br />
 </div>
 <p><a href="windows_2pipe_8hpp_source.html">Go to the source code of this file.</a></p>
@@ -69,8 +73,8 @@ Namespaces</h2></td></tr>
 </table><table class="memberdecls">
 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
 Functions</h2></td></tr>
-<tr class="memitem:aada7738a90123ea91fcd4b60693c2a51"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classTry.html">Try</a>&lt; std::array&lt; int, 2 &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceos.html#aada7738a90123ea91fcd4b60693c2a51">os::pipe</a> ()</td></tr>
-<tr class="separator:aada7738a90123ea91fcd4b60693c2a51"><td class="memSeparator" colspan="2">&#160;</td></tr>
+<tr class="memitem:aaf74ddc18d833f8cbea1bdc81a4b24b8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classTry.html">Try</a>&lt; std::array&lt; <a class="el" href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>, 2 &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceos.html#aaf74ddc18d833f8cbea1bdc81a4b24b8">os::pipe</a> (bool read_overlapped=true, bool write_overlapped=true)</td></tr>
+<tr class="separator:aaf74ddc18d833f8cbea1bdc81a4b24b8"><td class="memSeparator" colspan="2">&#160;</td></tr>
 </table>
 </div><!-- contents -->
 <!-- start footer part -->