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/02 03:22:01 UTC

[46/51] [partial] mesos-site git commit: Updated the website built from mesos SHA: 8e2d6d2.

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/e6085b1f/content/api/latest/c++/3rdparty_2stout_2include_2stout_2net_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/3rdparty_2stout_2include_2stout_2net_8hpp_source.html b/content/api/latest/c++/3rdparty_2stout_2include_2stout_2net_8hpp_source.html
index d99191f..16bbbcc 100644
--- a/content/api/latest/c++/3rdparty_2stout_2include_2stout_2net_8hpp_source.html
+++ b/content/api/latest/c++/3rdparty_2stout_2include_2stout_2net_8hpp_source.html
@@ -52,23 +52,23 @@
 <div class="title">net.hpp</div>  </div>
 </div><!--header-->
 <div class="contents">
-<a href="3rdparty_2stout_2include_2stout_2net_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</spa
 n>&#160;</div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#ifndef __STOUT_NET_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#define __STOUT_NET_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">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="preprocessor">#include &lt;netdb.h&gt;</span></div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</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">#inclu
 de &lt;stdint.h&gt;</span></div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;stdio.h&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;stdlib.h&gt;</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">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span class="preprocessor">#include &lt;arpa/inet.h&gt;</span></div><div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</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=
 "preprocessor">#ifdef __APPLE__</span></div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="preprocessor">#include &lt;net/if.h&gt;</span></div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="preprocessor">#include &lt;net/if_dl.h&gt;</span></div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;<span class="preprocessor">#include &lt;net/if_types.h&gt;</span></div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span class="preprocessor">#endif // __APPLE__</span></div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;</div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;<span class="preprocessor">#ifdef __FreeBSD__</span></div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="preprocessor">#include &lt;ifaddrs.h&gt;</span></div><div class="li
 ne"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="preprocessor">#endif // __FreeBSD__</span></div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;</div><div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;<span class="comment">// Note: Header grouping and ordering is considered before</span></div><div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;<span class="comment">// inclusion/exclusion by platform.</span></div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;<span class="preprocessor">#include &lt;sys/param.h&gt;</span></div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00043"></a><span cl
 ass="lineno">   43</span>&#160;</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;<span class="preprocessor">#include &lt;curl/curl.h&gt;</span></div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;</div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="preprocessor">#include &lt;iostream&gt;</span></div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;<span class="preprocessor">#include &lt;set&gt;</span></div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;<span class="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="bytes_8hpp.html">stout/bytes.hpp</a>&gt;</span></div><div class="line"><a name="l000
 51"></a><span class="lineno">   51</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="duration_8hpp.html">stout/duration.hpp</a>&gt;</span></div><div class="line"><a name="l00052"></a><span class="lineno">   52</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="l00053"></a><span class="lineno">   53</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2ip_8hpp.html">stout/ip.hpp</a>&gt;</span></div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="option_8hpp.html">stout/option.hpp</a>&gt;</span></div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="stringify_8hpp.html">stout/stringify.hpp</a>&gt;</span></div><div class="line"><a
  name="l00056"></a><span class="lineno">   56</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="l00057"></a><span class="lineno">   57</span>&#160;</div><div class="line"><a name="l00058"></a><span class="lineno">   58</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="l00059"></a><span class="lineno">   59</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="open_8hpp.html">stout/os/open.hpp</a>&gt;</span></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;<span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;<span class="preprocessor">#include &lt;<a class="cod
 e" href="3rdparty_2stout_2include_2stout_2windows_2net_8hpp.html">stout/windows/net.hpp</a>&gt;</span></div><div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2posix_2net_8hpp.html">stout/posix/net.hpp</a>&gt;</span></div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;</div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;</div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;<span class="comment">// Network utilities.</span></div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;<span class=
 "keyword">namespace </span><a class="code" href="namespacenet.html">net</a> {</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="comment">// Initializes libraries that net:: functions depend on, in a</span></div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;<span class="comment">// thread-safe way. This does not have to be called explicitly by</span></div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<span class="comment">// the user of any functions in question. They will call this</span></div><div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;<span class="comment">// themselves by need.</span></div><div class="line"><a name="l00075"></a><span class="lineno"><a class="line" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">   75</a></span>&#160;<span class=
 "keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">initialize</a>()</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;{</div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;  <span class="comment">// We use a static struct variable to initialize in a thread-safe</span></div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;  <span class="comment">// way, at least with respect to calls within net::*, since there</span></div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;  <span class="comment">// is no way to guarantee that another library is not concurrently</span></div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;  <span class="comment">// initializing CURL. Thread safety is provided by the fact that</span></div><div class="line"><a name="l00081
 "></a><span class="lineno">   81</span>&#160;  <span class="comment">// the value &#39;curl&#39; should get constructed (i.e., the CURL</span></div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;  <span class="comment">// constructor invoked) in a thread safe way (as of GCC 4.3 and</span></div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;  <span class="comment">// required for C++11).</span></div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;  <span class="keyword">struct </span>CURL</div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;  {</div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;    CURL()</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="comment">// This is the only one functio
 n in libcurl that is not deemed</span></div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;      <span class="comment">// thread-safe. (And it must be called at least once before any</span></div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;      <span class="comment">// other libcurl function is used.)</span></div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;      curl_global_init(CURL_GLOBAL_ALL);</div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;    }</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;  };</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="keyword">static</span> CURL curl;</div><div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;}</div><div class="lin
 e"><a name="l00097"></a><span class="lineno">   97</span>&#160;</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="comment">// Downloads the header of the specified HTTP URL with a HEAD request</span></div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;<span class="comment">// and queries its &quot;content-length&quot; field. (Note that according to the</span></div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span class="comment">// HTTP specification there is no guarantee that this field contains</span></div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;<span class="comment">// any useful value.)</span></div><div class="line"><a name="l00103"></a><span class="lineno"><a class="line" href="namespacenet.html#aa3d8cac2c33d11239203ab0f06aa5a4f">  103</a></span>&#1
 60;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;Bytes&gt;</a> <a class="code" href="namespacenet.html#aa3d8cac2c33d11239203ab0f06aa5a4f">contentLength</a>(<span class="keyword">const</span> std::string&amp; url)</div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;{</div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;  <a class="code" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">initialize</a>();</div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;</div><div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;  CURL* curl = curl_easy_init();</div><div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;  <span class="keywordflow">if</span> (curl == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;    curl_easy_cleanup(curl);</div>
 <div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to initialize libcurl&quot;</span>);</div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;  }</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;  curl_easy_setopt(curl, CURLOPT_URL, url.c_str());</div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, <span class="keyword">true</span>);</div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;  curl_easy_setopt(curl, CURLOPT_HEADER, 1);</div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;  curl_easy_setopt(curl, CURLOPT_NOBODY, 1);</div><div class="l
 ine"><a name="l00117"></a><span class="lineno">  117</span>&#160;</div><div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;  CURLcode curlErrorCode = curl_easy_perform(curl);</div><div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;  <span class="keywordflow">if</span> (curlErrorCode != 0) {</div><div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(curl_easy_strerror(curlErrorCode));</div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;  }</div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;</div><div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;  <span class="keywordtype">double</span> result;</div><div class="line"><
 a name="l00125"></a><span class="lineno">  125</span>&#160;  curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &amp;result);</div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;</div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;  curl_easy_cleanup(curl);</div><div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;</div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;  <span class="keywordflow">if</span> (result &lt; 0) {</div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;No URL content-length available&quot;</span>);</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;  }</div><div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;</div><div class="li
 ne"><a name="l00133"></a><span class="lineno">  133</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classBytes.html">Bytes</a>(uint64_t(result));</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;</div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;<span class="comment">// Returns the HTTP response code resulting from attempting to</span></div><div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;<span class="comment">// download the specified HTTP or FTP URL into a file at the specified</span></div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;<span class="comment">// path. The `stall_timeout` parameter controls how long the download</span></div><div class="line"><a name
 ="l00140"></a><span class="lineno">  140</span>&#160;<span class="comment">// waits before aborting when the download speed keeps below 1 byte/sec.</span></div><div class="line"><a name="l00141"></a><span class="lineno"><a class="line" href="namespacenet.html#ace14e175f117e4e3e73f164538bcfea2">  141</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;int&gt;</a> <a class="code" href="namespacenet.html#ace14e175f117e4e3e73f164538bcfea2">download</a>(</div><div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;    <span class="keyword">const</span> std::string&amp; url,</div><div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;    <span class="keyword">const</span> std::string&amp; <a class="code" href="namespacepath.html">path</a>,</div><div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;    <span class="keyword">const</span> <a class="code" href="classOption.html">Op
 tion&lt;Duration&gt;</a>&amp; stall_timeout = <a class="code" href="structNone.html">None</a>())</div><div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;{</div><div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;  <a class="code" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">initialize</a>();</div><div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;</div><div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;  <a class="code" href="classTry.html">Try&lt;int_fd&gt;</a> fd = <a class="code" href="namespaceos.html#abbdbbbe902fd8dc271077d94b99994e7">os::open</a>(</div><div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;      path,</div><div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;      <a class="code" href="windows_2fcntl_8hpp.html#a1cf6b1de1fffedaa1d26b189e9a8d2cc">O_CREAT</a> | <a class="code" href="windows_2fcntl
 _8hpp.html#a11b644a8526139c4cc1850dac1271ced">O_WRONLY</a> | <a class="code" href="windows_2fcntl_8hpp.html#ad6d8fbe4e494b4dbe051612572d3f757">O_CLOEXEC</a>,</div><div class="line"><a name="l00151"></a><span class="lineno">  151</span>&#160;      <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a66cff14a0638cde9f422c7a4b0938e61">S_IRUSR</a> | <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#aead39710af2622ee9b0d412f62e90aa5">S_IWUSR</a> | <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a55fad1c3746e1b8a6a00c10998e91d91">S_IRGRP</a> | <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a90d7514882640a8cd7b8da14138103b7">S_IROTH</a>);</div><div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;</div><div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;  <span class="keywordflow">if</span> (fd.<a class="code" href="classTry.html#a0b98f95163b8a38d
 aafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00154"></a><span class="lineno">  154</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(fd.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div class="line"><a name="l00155"></a><span class="lineno">  155</span>&#160;  }</div><div class="line"><a name="l00156"></a><span class="lineno">  156</span>&#160;</div><div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;  CURL* curl = curl_easy_init();</div><div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;</div><div class="line"><a name="l00159"></a><span class="lineno">  159</span>&#160;  <span class="keywordflow">if</span> (curl == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00161"></a><
 span class="lineno">  161</span>&#160;    <a class="code" href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a>(fd.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00162"></a><span class="lineno">  162</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to initialize libcurl&quot;</span>);</div><div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160;  }</div><div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;</div><div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;  curl_easy_setopt(curl, CURLOPT_URL, url.c_str());</div><div class="line"><a name="l00166"></a><span class="lineno">  166</span>&#160;  curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, <span class="keyword">nullptr</span>);</div><div class="line"><a name="l00167"></a><span c
 lass="lineno">  167</span>&#160;  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, <span class="keyword">true</span>);</div><div class="line"><a name="l00168"></a><span class="lineno">  168</span>&#160;</div><div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;  <span class="comment">// We don&#39;t bother introducing a `os::fdopen` since this is the only place</span></div><div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;  <span class="comment">// we use `fdopen` in the entire codebase as of writing this comment.</span></div><div class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;<span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;  <span class="comment">// We open in &quot;binary&quot; mode on Windows to avoid line-ending translation.</span></div><div class="line"><a name="l00173"></a><span class="lineno">  173</span>&#160;  F
 ILE* <a class="code" href="namespacemesos_1_1uri.html#a0a3b30c1eb427c4053aaef120b1f453c">file</a> = ::_fdopen(fd-&gt;crt(), <span class="stringliteral">&quot;wb&quot;</span>);</div><div class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l00175"></a><span class="lineno">  175</span>&#160;  FILE* file = ::fdopen(fd.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(), <span class="stringliteral">&quot;w&quot;</span>);</div><div class="line"><a name="l00176"></a><span class="lineno">  176</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;  <span class="keywordflow">if</span> (file == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00179"></a><span
  class="lineno">  179</span>&#160;    <a class="code" href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a>(fd.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to open file handle of &#39;&quot;</span> + path + <span class="stringliteral">&quot;&#39;&quot;</span>);</div><div class="line"><a name="l00181"></a><span class="lineno">  181</span>&#160;  }</div><div class="line"><a name="l00182"></a><span class="lineno">  182</span>&#160;  curl_easy_setopt(curl, CURLOPT_WRITEDATA, file);</div><div class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;</div><div class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;  <span class="keywordflow">if</span> (stall_timeout.isSome()) {
 </div><div class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;    <span class="comment">// Set the options to abort the download if the speed keeps below</span></div><div class="line"><a name="l00186"></a><span class="lineno">  186</span>&#160;    <span class="comment">// 1 byte/sec during the timeout. See:</span></div><div class="line"><a name="l00187"></a><span class="lineno">  187</span>&#160;    <span class="comment">// https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_LIMIT.html</span></div><div class="line"><a name="l00188"></a><span class="lineno">  188</span>&#160;    <span class="comment">// https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_TIME.html</span></div><div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;    curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 1L);</div><div class="line"><a name="l00190"></a><span class="lineno">  190</span>&#160;    curl_easy_setopt(</div><div class="line"><a name="l00191"></a><span class="
 lineno">  191</span>&#160;        curl, CURLOPT_LOW_SPEED_TIME, static_cast&lt;long&gt;(stall_timeout-&gt;secs()));</div><div class="line"><a name="l00192"></a><span class="lineno">  192</span>&#160;  }</div><div class="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;</div><div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;  CURLcode curlErrorCode = curl_easy_perform(curl);</div><div class="line"><a name="l00195"></a><span class="lineno">  195</span>&#160;  <span class="keywordflow">if</span> (curlErrorCode != 0) {</div><div class="line"><a name="l00196"></a><span class="lineno">  196</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00197"></a><span class="lineno">  197</span>&#160;    fclose(file);</div><div class="line"><a name="l00198"></a><span class="lineno">  198</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(curl_easy_strerror(curlErrorCode));</div><
 div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;  }</div><div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;</div><div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;  <span class="keywordtype">long</span> code;</div><div class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;  curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &amp;code);</div><div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;  curl_easy_cleanup(curl);</div><div class="line"><a name="l00204"></a><span class="lineno">  204</span>&#160;</div><div class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;  <span class="keywordflow">if</span> (fclose(file) != 0) {</div><div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;F
 ailed to close file handle of &#39;&quot;</span> + path + <span class="stringliteral">&quot;&#39;&quot;</span>);</div><div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;  }</div><div class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;</div><div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classTry.html#ac6304ce9dfd0042726f8b813ac64f06a">Try&lt;int&gt;::some</a>(code);</div><div class="line"><a name="l00210"></a><span class="lineno">  210</span>&#160;}</div><div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;</div><div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;} <span class="comment">// namespace net {</span></div><div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;</div><div class="line"><a name="l00214"></a><span class="lineno">  214</span>&#160;<span class="pre
 processor">#endif // __STOUT_NET_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_2fcntl_8hpp_html_a11b644a8526139c4cc1850dac1271ced"><div class="ttname"><a href="windows_2fcntl_8hpp.html#a11b644a8526139c4cc1850dac1271ced">O_WRONLY</a></div><div class="ttdeci">#define O_WRONLY</div><div class="ttdef"><b>Definition:</b> fcntl.hpp:26</div></div>
+<a href="3rdparty_2stout_2include_2stout_2net_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</spa
 n>&#160;</div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#ifndef __STOUT_NET_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#define __STOUT_NET_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">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="preprocessor">#include &lt;netdb.h&gt;</span></div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</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">#inclu
 de &lt;stdint.h&gt;</span></div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;stdio.h&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;stdlib.h&gt;</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">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span class="preprocessor">#include &lt;arpa/inet.h&gt;</span></div><div class="line"><a name="l00026"></a><span class="lineno">   26</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</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=
 "preprocessor">#ifdef __APPLE__</span></div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="preprocessor">#include &lt;net/if.h&gt;</span></div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="preprocessor">#include &lt;net/if_dl.h&gt;</span></div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;<span class="preprocessor">#include &lt;net/if_types.h&gt;</span></div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span class="preprocessor">#endif // __APPLE__</span></div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;</div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;<span class="preprocessor">#ifdef __FreeBSD__</span></div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="preprocessor">#include &lt;ifaddrs.h&gt;</span></div><div class="li
 ne"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="preprocessor">#endif // __FreeBSD__</span></div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;</div><div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;<span class="comment">// Note: Header grouping and ordering is considered before</span></div><div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;<span class="comment">// inclusion/exclusion by platform.</span></div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;<span class="preprocessor">#ifndef __WINDOWS__</span></div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;<span class="preprocessor">#include &lt;sys/param.h&gt;</span></div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00043"></a><span cl
 ass="lineno">   43</span>&#160;</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;<span class="preprocessor">#include &lt;curl/curl.h&gt;</span></div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;</div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="preprocessor">#include &lt;iostream&gt;</span></div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;<span class="preprocessor">#include &lt;set&gt;</span></div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;<span class="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="bytes_8hpp.html">stout/bytes.hpp</a>&gt;</span></div><div class="line"><a name="l000
 51"></a><span class="lineno">   51</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="duration_8hpp.html">stout/duration.hpp</a>&gt;</span></div><div class="line"><a name="l00052"></a><span class="lineno">   52</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="l00053"></a><span class="lineno">   53</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2ip_8hpp.html">stout/ip.hpp</a>&gt;</span></div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="option_8hpp.html">stout/option.hpp</a>&gt;</span></div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="stringify_8hpp.html">stout/stringify.hpp</a>&gt;</span></div><div class="line"><a
  name="l00056"></a><span class="lineno">   56</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="l00057"></a><span class="lineno">   57</span>&#160;</div><div class="line"><a name="l00058"></a><span class="lineno">   58</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="l00059"></a><span class="lineno">   59</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="close_8hpp.html">stout/os/close.hpp</a>&gt;</span></div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="open_8hpp.html">stout/os/open.hpp</a>&gt;</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">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2windows_2net_8hpp.html">stout/windows/net.hpp</a>&gt;</span></div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="3rdparty_2stout_2include_2stout_2posix_2net_8hpp.html">stout/posix/net.hpp</a>&gt;</span></div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;</div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;</div><div class="line"><a name="l
 00069"></a><span class="lineno">   69</span>&#160;<span class="comment">// Network utilities.</span></div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespacenet.html">net</a> {</div><div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;</div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;<span class="comment">// Initializes libraries that net:: functions depend on, in a</span></div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<span class="comment">// thread-safe way. This does not have to be called explicitly by</span></div><div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;<span class="comment">// the user of any functions in question. They will call this</span></div><div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;<span class="comment">// thems
 elves by need.</span></div><div class="line"><a name="l00076"></a><span class="lineno"><a class="line" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">   76</a></span>&#160;<span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">initialize</a>()</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;  <span class="comment">// We use a static struct variable to initialize in a thread-safe</span></div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;  <span class="comment">// way, at least with respect to calls within net::*, since there</span></div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;  <span class="comment">// is no way to guarantee that another library is not concurrently</span></div><div class="line
 "><a name="l00081"></a><span class="lineno">   81</span>&#160;  <span class="comment">// initializing CURL. Thread safety is provided by the fact that</span></div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;  <span class="comment">// the value &#39;curl&#39; should get constructed (i.e., the CURL</span></div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;  <span class="comment">// constructor invoked) in a thread safe way (as of GCC 4.3 and</span></div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;  <span class="comment">// required for C++11).</span></div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;  <span class="keyword">struct </span>CURL</div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;  {</div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;    CURL()</div><div class="line"><a name="l00
 088"></a><span class="lineno">   88</span>&#160;    {</div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;      <span class="comment">// This is the only one function in libcurl that is not deemed</span></div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;      <span class="comment">// thread-safe. (And it must be called at least once before any</span></div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;      <span class="comment">// other libcurl function is used.)</span></div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;      curl_global_init(CURL_GLOBAL_ALL);</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;    }</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;</div><div class="line"><a name="l00096"><
 /a><span class="lineno">   96</span>&#160;  <span class="keyword">static</span> CURL curl;</div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;}</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;</div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;<span class="comment">// Downloads the header of the specified HTTP URL with a HEAD request</span></div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span class="comment">// and queries its &quot;content-length&quot; field. (Note that according to the</span></div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;<span class="comment">// HTTP specification there is no guarantee that this field contains</span></div><div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;<span class="c
 omment">// any useful value.)</span></div><div class="line"><a name="l00104"></a><span class="lineno"><a class="line" href="namespacenet.html#aa3d8cac2c33d11239203ab0f06aa5a4f">  104</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;Bytes&gt;</a> <a class="code" href="namespacenet.html#aa3d8cac2c33d11239203ab0f06aa5a4f">contentLength</a>(<span class="keyword">const</span> std::string&amp; url)</div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;{</div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;  <a class="code" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">initialize</a>();</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;  CURL* curl = curl_easy_init();</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;  <span 
 class="keywordflow">if</span> (curl == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to initialize libcurl&quot;</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;</div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;  curl_easy_setopt(curl, CURLOPT_URL, url.c_str());</div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, <span class="keyword">true</span>);</div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&
 #160;  curl_easy_setopt(curl, CURLOPT_HEADER, 1);</div><div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;  curl_easy_setopt(curl, CURLOPT_NOBODY, 1);</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;  CURLcode curlErrorCode = curl_easy_perform(curl);</div><div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;  <span class="keywordflow">if</span> (curlErrorCode != 0) {</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(curl_easy_strerror(curlErrorCode));</div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;  }</div><div class="line"><a name="l00124"></a><
 span class="lineno">  124</span>&#160;</div><div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;  <span class="keywordtype">double</span> result;</div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;  curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &amp;result);</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;  curl_easy_cleanup(curl);</div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;</div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;  <span class="keywordflow">if</span> (result &lt; 0) {</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;No URL content-length available&quot;</sp
 an>);</div><div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;  }</div><div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;</div><div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classBytes.html">Bytes</a>(uint64_t(result));</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;</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;<span class="comment">// Returns the HTTP response code resulting from attempting to</span></div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;<span class="comment">// download the specified HTTP or FTP URL into a file at the specified</span></div><div class=
 "line"><a name="l00140"></a><span class="lineno">  140</span>&#160;<span class="comment">// path. The `stall_timeout` parameter controls how long the download</span></div><div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;<span class="comment">// waits before aborting when the download speed keeps below 1 byte/sec.</span></div><div class="line"><a name="l00142"></a><span class="lineno"><a class="line" href="namespacenet.html#ace14e175f117e4e3e73f164538bcfea2">  142</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;int&gt;</a> <a class="code" href="namespacenet.html#ace14e175f117e4e3e73f164538bcfea2">download</a>(</div><div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;    <span class="keyword">const</span> std::string&amp; url,</div><div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;    <span class="keyword">const</span> std::string&amp; <a class="code" href
 ="namespacepath.html">path</a>,</div><div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;    <span class="keyword">const</span> <a class="code" href="classOption.html">Option&lt;Duration&gt;</a>&amp; stall_timeout = <a class="code" href="structNone.html">None</a>())</div><div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;{</div><div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;  <a class="code" href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">initialize</a>();</div><div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;</div><div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;  <a class="code" href="classTry.html">Try&lt;int_fd&gt;</a> fd = <a class="code" href="namespaceos.html#aaf5d5468adc1b85cf9bb7126e70807ca">os::open</a>(</div><div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;      path,</div><div class="line"><a
  name="l00151"></a><span class="lineno">  151</span>&#160;      O_CREAT | O_WRONLY | <a class="code" href="windows_2open_8hpp.html#ae477ca5323e49dcb433426280be75067">O_CLOEXEC</a>,</div><div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;      <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a66cff14a0638cde9f422c7a4b0938e61">S_IRUSR</a> | <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#aead39710af2622ee9b0d412f62e90aa5">S_IWUSR</a> | <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a55fad1c3746e1b8a6a00c10998e91d91">S_IRGRP</a> | <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a90d7514882640a8cd7b8da14138103b7">S_IROTH</a>);</div><div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;</div><div class="line"><a name="l00154"></a><span class="lineno">  154</span>&#160;  <span class="keywordflow">if</span> (fd.<a class="code" href="classTry
 .html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00155"></a><span class="lineno">  155</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(fd.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div><div class="line"><a name="l00156"></a><span class="lineno">  156</span>&#160;  }</div><div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;</div><div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;  CURL* curl = curl_easy_init();</div><div class="line"><a name="l00159"></a><span class="lineno">  159</span>&#160;</div><div class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;  <span class="keywordflow">if</span> (curl == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00161"></a><span class="lineno">  161</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"
 ><a name="l00162"></a><span class="lineno">  162</span>&#160;    <a class="code" href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a>(fd.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to initialize libcurl&quot;</span>);</div><div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;  }</div><div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;</div><div class="line"><a name="l00166"></a><span class="lineno">  166</span>&#160;  curl_easy_setopt(curl, CURLOPT_URL, url.c_str());</div><div class="line"><a name="l00167"></a><span class="lineno">  167</span>&#160;  curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, <span class="keyword">nullptr</span>);</div><div class="line"><a na
 me="l00168"></a><span class="lineno">  168</span>&#160;  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, <span class="keyword">true</span>);</div><div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;</div><div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;  <span class="comment">// We don&#39;t bother introducing a `os::fdopen()` since this is the</span></div><div class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;  <span class="comment">// only place we use `fdopen()` in the entire codebase as of writing</span></div><div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;  <span class="comment">// this comment.</span></div><div class="line"><a name="l00173"></a><span class="lineno">  173</span>&#160;<span class="preprocessor">#ifdef __WINDOWS__</span></div><div class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;  <span class="comment">// This explicitly allocates a C
 RT integer file descriptor, which</span></div><div class="line"><a name="l00175"></a><span class="lineno">  175</span>&#160;  <span class="comment">// when closed, also closes the underlying handle, so we do not call</span></div><div class="line"><a name="l00176"></a><span class="lineno">  176</span>&#160;  <span class="comment">// `CloseHandle()` (or `os::close()`).</span></div><div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;  <span class="keyword">const</span> <span class="keywordtype">int</span> crt = fd-&gt;crt();</div><div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;  <span class="comment">// We open in &quot;binary&quot; mode on Windows to avoid line-ending translation.</span></div><div class="line"><a name="l00179"></a><span class="lineno">  179</span>&#160;  FILE* <a class="code" href="namespacemesos_1_1uri.html#a0a3b30c1eb427c4053aaef120b1f453c">file</a> = ::_fdopen(crt, <span class="stringliteral">&quot;wb&quot;</s
 pan>);</div><div class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;  <span class="keywordflow">if</span> (file == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00181"></a><span class="lineno">  181</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00182"></a><span class="lineno">  182</span>&#160;    <span class="comment">// NOTE: This is not `os::close()` because we allocated a CRT int</span></div><div class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;    <span class="comment">// fd earlier.</span></div><div class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;    ::_close(crt);</div><div class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to open file handle of &#39;&quot;</span> + path + <span class="st
 ringliteral">&quot;&#39;&quot;</span>);</div><div class="line"><a name="l00186"></a><span class="lineno">  186</span>&#160;  }</div><div class="line"><a name="l00187"></a><span class="lineno">  187</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l00188"></a><span class="lineno">  188</span>&#160;  FILE* file = ::fdopen(fd.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(), <span class="stringliteral">&quot;w&quot;</span>);</div><div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;  <span class="keywordflow">if</span> (file == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00190"></a><span class="lineno">  190</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00191"></a><span class="lineno">  191</span>&#160;    <a class="code" href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a>(fd.<a class="code" href="classTry.html#a8bc7f43
 e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00192"></a><span class="lineno">  192</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to open file handle of &#39;&quot;</span> + path + <span class="stringliteral">&quot;&#39;&quot;</span>);</div><div class="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;  }</div><div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;<span class="preprocessor">#endif // __WINDOWS__</span></div><div class="line"><a name="l00195"></a><span class="lineno">  195</span>&#160;</div><div class="line"><a name="l00196"></a><span class="lineno">  196</span>&#160;  curl_easy_setopt(curl, CURLOPT_WRITEDATA, file);</div><div class="line"><a name="l00197"></a><span class="lineno">  197</span>&#160;</div><div class="line"><a name="l00198"></a><span class="lineno">  198</span>&#160;  <span class=
 "keywordflow">if</span> (stall_timeout.isSome()) {</div><div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;    <span class="comment">// Set the options to abort the download if the speed keeps below</span></div><div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;    <span class="comment">// 1 byte/sec during the timeout. See:</span></div><div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;    <span class="comment">// https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_LIMIT.html</span></div><div class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;    <span class="comment">// https://curl.haxx.se/libcurl/c/CURLOPT_LOW_SPEED_TIME.html</span></div><div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;    curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 1L);</div><div class="line"><a name="l00204"></a><span class="lineno">  204</span>&#160;    curl_easy_setopt(</div><d
 iv class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;        curl, CURLOPT_LOW_SPEED_TIME, static_cast&lt;long&gt;(stall_timeout-&gt;secs()));</div><div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;  }</div><div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;</div><div class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;  CURLcode curlErrorCode = curl_easy_perform(curl);</div><div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;  <span class="keywordflow">if</span> (curlErrorCode != 0) {</div><div class="line"><a name="l00210"></a><span class="lineno">  210</span>&#160;    curl_easy_cleanup(curl);</div><div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;    <span class="comment">// NOTE: `fclose()` also closes the associated file descriptor, so</span></div><div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;   
  <span class="comment">// we do not call `close()`.</span></div><div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;    ::fclose(file);</div><div class="line"><a name="l00214"></a><span class="lineno">  214</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(curl_easy_strerror(curlErrorCode));</div><div class="line"><a name="l00215"></a><span class="lineno">  215</span>&#160;  }</div><div class="line"><a name="l00216"></a><span class="lineno">  216</span>&#160;</div><div class="line"><a name="l00217"></a><span class="lineno">  217</span>&#160;  <span class="keywordtype">long</span> code;</div><div class="line"><a name="l00218"></a><span class="lineno">  218</span>&#160;  curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &amp;code);</div><div class="line"><a name="l00219"></a><span class="lineno">  219</span>&#160;  curl_easy_cleanup(curl);</div><div class="line"><a name="l00220"></a><span class="lineno">  2
 20</span>&#160;</div><div class="line"><a name="l00221"></a><span class="lineno">  221</span>&#160;  <span class="keywordflow">if</span> (::fclose(file) != 0) {</div><div class="line"><a name="l00222"></a><span class="lineno">  222</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to close file handle of &#39;&quot;</span> + path + <span class="stringliteral">&quot;&#39;&quot;</span>);</div><div class="line"><a name="l00223"></a><span class="lineno">  223</span>&#160;  }</div><div class="line"><a name="l00224"></a><span class="lineno">  224</span>&#160;</div><div class="line"><a name="l00225"></a><span class="lineno">  225</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classTry.html#ac6304ce9dfd0042726f8b813ac64f06a">Try&lt;int&gt;::some</a>(code);</div><div class="line"><a name="l00226"></a><span class="lineno">  226</span>&#160;}</div><div class="l
 ine"><a name="l00227"></a><span class="lineno">  227</span>&#160;</div><div class="line"><a name="l00228"></a><span class="lineno">  228</span>&#160;} <span class="comment">// namespace net {</span></div><div class="line"><a name="l00229"></a><span class="lineno">  229</span>&#160;</div><div class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;<span class="preprocessor">#endif // __STOUT_NET_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="classError_html"><div class="ttname"><a href="classError.html">Error</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:35</div></div>
 <div class="ttc" id="classOption_html"><div class="ttname"><a href="classOption.html">Option&lt; Duration &gt;</a></div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a55fad1c3746e1b8a6a00c10998e91d91"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a55fad1c3746e1b8a6a00c10998e91d91">S_IRGRP</a></div><div class="ttdeci">const mode_t S_IRGRP</div><div class="ttdef"><b>Definition:</b> windows.hpp:319</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a55fad1c3746e1b8a6a00c10998e91d91"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a55fad1c3746e1b8a6a00c10998e91d91">S_IRGRP</a></div><div class="ttdeci">const mode_t S_IRGRP</div><div class="ttdef"><b>Definition:</b> windows.hpp:313</div></div>
 <div class="ttc" id="classTry_html_a8bc7f43e75a47111ea18e9c83b007be5"><div class="ttname"><a href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">Try::get</a></div><div class="ttdeci">T &amp; get()&amp;</div><div class="ttdef"><b>Definition:</b> try.hpp:73</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_2fcntl_8hpp_html_ad6d8fbe4e494b4dbe051612572d3f757"><div class="ttname"><a href="windows_2fcntl_8hpp.html#ad6d8fbe4e494b4dbe051612572d3f757">O_CLOEXEC</a></div><div class="ttdeci">#define O_CLOEXEC</div><div class="ttdef"><b>Definition:</b> fcntl.hpp:33</div></div>
 <div class="ttc" id="3rdparty_2stout_2include_2stout_2ip_8hpp_html"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2ip_8hpp.html">ip.hpp</a></div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_aead39710af2622ee9b0d412f62e90aa5"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#aead39710af2622ee9b0d412f62e90aa5">S_IWUSR</a></div><div class="ttdeci">const mode_t S_IWUSR</div><div class="ttdef"><b>Definition:</b> windows.hpp:312</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_aead39710af2622ee9b0d412f62e90aa5"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#aead39710af2622ee9b0d412f62e90aa5">S_IWUSR</a></div><div class="ttdeci">const mode_t S_IWUSR</div><div class="ttdef"><b>Definition:</b> windows.hpp:306</div></div>
 <div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_2net_8hpp_html"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_2net_8hpp.html">net.hpp</a></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>
 <div class="ttc" id="classErrnoError_html"><div class="ttname"><a href="classErrnoError.html">ErrnoError</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:49</div></div>
-<div class="ttc" id="windows_2fcntl_8hpp_html_a1cf6b1de1fffedaa1d26b189e9a8d2cc"><div class="ttname"><a href="windows_2fcntl_8hpp.html#a1cf6b1de1fffedaa1d26b189e9a8d2cc">O_CREAT</a></div><div class="ttdeci">#define O_CREAT</div><div class="ttdef"><b>Definition:</b> fcntl.hpp:28</div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a66cff14a0638cde9f422c7a4b0938e61"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a66cff14a0638cde9f422c7a4b0938e61">S_IRUSR</a></div><div class="ttdeci">const mode_t S_IRUSR</div><div class="ttdef"><b>Definition:</b> windows.hpp:311</div></div>
-<div class="ttc" id="namespacenet_html_a418ace8fe7728f38b2124b5445e52775"><div class="ttname"><a href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">net::initialize</a></div><div class="ttdeci">void initialize()</div><div class="ttdef"><b>Definition:</b> net.hpp:75</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a66cff14a0638cde9f422c7a4b0938e61"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a66cff14a0638cde9f422c7a4b0938e61">S_IRUSR</a></div><div class="ttdeci">const mode_t S_IRUSR</div><div class="ttdef"><b>Definition:</b> windows.hpp:305</div></div>
+<div class="ttc" id="close_8hpp_html"><div class="ttname"><a href="close_8hpp.html">close.hpp</a></div></div>
+<div class="ttc" id="namespacenet_html_a418ace8fe7728f38b2124b5445e52775"><div class="ttname"><a href="namespacenet.html#a418ace8fe7728f38b2124b5445e52775">net::initialize</a></div><div class="ttdeci">void initialize()</div><div class="ttdef"><b>Definition:</b> net.hpp:76</div></div>
 <div class="ttc" id="open_8hpp_html"><div class="ttname"><a href="open_8hpp.html">open.hpp</a></div></div>
 <div class="ttc" id="duration_8hpp_html"><div class="ttname"><a href="duration_8hpp.html">duration.hpp</a></div></div>
+<div class="ttc" id="windows_2open_8hpp_html_ae477ca5323e49dcb433426280be75067"><div class="ttname"><a href="windows_2open_8hpp.html#ae477ca5323e49dcb433426280be75067">O_CLOEXEC</a></div><div class="ttdeci">constexpr int O_CLOEXEC</div><div class="ttdef"><b>Definition:</b> open.hpp:41</div></div>
 <div class="ttc" id="namespacemesos_1_1uri_html_a0a3b30c1eb427c4053aaef120b1f453c"><div class="ttname"><a href="namespacemesos_1_1uri.html#a0a3b30c1eb427c4053aaef120b1f453c">mesos::uri::file</a></div><div class="ttdeci">URI file(const std::string &amp;path)</div><div class="ttdoc">Creates a file URI with the given path on the local host. </div><div class="ttdef"><b>Definition:</b> file.hpp:33</div></div>
 <div class="ttc" id="bytes_8hpp_html"><div class="ttname"><a href="bytes_8hpp.html">bytes.hpp</a></div></div>
 <div class="ttc" id="namespaceos_html_a8df77ec6d6b8d32d9b287a41bc74cfdc"><div class="ttname"><a href="namespaceos.html#a8df77ec6d6b8d32d9b287a41bc74cfdc">os::close</a></div><div class="ttdeci">Try&lt; Nothing &gt; close(int fd)</div><div class="ttdef"><b>Definition:</b> close.hpp:24</div></div>
@@ -80,14 +80,13 @@
 <div class="ttc" id="error_8hpp_html"><div class="ttname"><a href="error_8hpp.html">error.hpp</a></div></div>
 <div class="ttc" id="structNone_html"><div class="ttname"><a href="structNone.html">None</a></div><div class="ttdef"><b>Definition:</b> none.hpp:27</div></div>
 <div class="ttc" id="classTry_html_a0b98f95163b8a38daafd1651b043a276"><div class="ttname"><a href="classTry.html#a0b98f95163b8a38daafd1651b043a276">Try::isError</a></div><div class="ttdeci">bool isError() const </div><div class="ttdef"><b>Definition:</b> try.hpp:71</div></div>
-<div class="ttc" id="namespaceos_html_abbdbbbe902fd8dc271077d94b99994e7"><div class="ttname"><a href="namespaceos.html#abbdbbbe902fd8dc271077d94b99994e7">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:40</div></div>
 <div class="ttc" id="stringify_8hpp_html"><div class="ttname"><a href="stringify_8hpp.html">stringify.hpp</a></div></div>
 <div class="ttc" id="try_8hpp_html"><div class="ttname"><a href="try_8hpp.html">try.hpp</a></div></div>
 <div class="ttc" id="int__fd_8hpp_html"><div class="ttname"><a href="int__fd_8hpp.html">int_fd.hpp</a></div></div>
-<div class="ttc" id="namespacenet_html_aa3d8cac2c33d11239203ab0f06aa5a4f"><div class="ttname"><a href="namespacenet.html#aa3d8cac2c33d11239203ab0f06aa5a4f">net::contentLength</a></div><div class="ttdeci">Try&lt; Bytes &gt; contentLength(const std::string &amp;url)</div><div class="ttdef"><b>Definition:</b> net.hpp:103</div></div>
+<div class="ttc" id="namespacenet_html_aa3d8cac2c33d11239203ab0f06aa5a4f"><div class="ttname"><a href="namespacenet.html#aa3d8cac2c33d11239203ab0f06aa5a4f">net::contentLength</a></div><div class="ttdeci">Try&lt; Bytes &gt; contentLength(const std::string &amp;url)</div><div class="ttdef"><b>Definition:</b> net.hpp:104</div></div>
 <div class="ttc" id="classBytes_html"><div class="ttname"><a href="classBytes.html">Bytes</a></div><div class="ttdef"><b>Definition:</b> bytes.hpp:30</div></div>
-<div class="ttc" id="namespacenet_html_ace14e175f117e4e3e73f164538bcfea2"><div class="ttname"><a href="namespacenet.html#ace14e175f117e4e3e73f164538bcfea2">net::download</a></div><div class="ttdeci">Try&lt; int &gt; download(const std::string &amp;url, const std::string &amp;path, const Option&lt; Duration &gt; &amp;stall_timeout=None())</div><div class="ttdef"><b>Definition:</b> net.hpp:141</div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a90d7514882640a8cd7b8da14138103b7"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a90d7514882640a8cd7b8da14138103b7">S_IROTH</a></div><div class="ttdeci">const mode_t S_IROTH</div><div class="ttdef"><b>Definition:</b> windows.hpp:327</div></div>
+<div class="ttc" id="namespacenet_html_ace14e175f117e4e3e73f164538bcfea2"><div class="ttname"><a href="namespacenet.html#ace14e175f117e4e3e73f164538bcfea2">net::download</a></div><div class="ttdeci">Try&lt; int &gt; download(const std::string &amp;url, const std::string &amp;path, const Option&lt; Duration &gt; &amp;stall_timeout=None())</div><div class="ttdef"><b>Definition:</b> net.hpp:142</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a90d7514882640a8cd7b8da14138103b7"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a90d7514882640a8cd7b8da14138103b7">S_IROTH</a></div><div class="ttdeci">const mode_t S_IROTH</div><div class="ttdef"><b>Definition:</b> windows.hpp:321</div></div>
 </div><!-- fragment --></div><!-- contents -->
 <!-- start footer part -->
 <hr class="footer"/><address class="footer"><small>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/e6085b1f/content/api/latest/c++/3rdparty_2stout_2include_2stout_2os_2linux_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/3rdparty_2stout_2include_2stout_2os_2linux_8hpp_source.html b/content/api/latest/c++/3rdparty_2stout_2include_2stout_2os_2linux_8hpp_source.html
index 474bb49..a8cbc3f 100644
--- a/content/api/latest/c++/3rdparty_2stout_2include_2stout_2os_2linux_8hpp_source.html
+++ b/content/api/latest/c++/3rdparty_2stout_2include_2stout_2os_2linux_8hpp_source.html
@@ -71,7 +71,7 @@
 <div class="ttc" id="structos_1_1Memory_html_a99857d2d965390fe2e88f417037dce55"><div class="ttname"><a href="structos_1_1Memory.html#a99857d2d965390fe2e88f417037dce55">os::Memory::freeSwap</a></div><div class="ttdeci">Bytes freeSwap</div><div class="ttdef"><b>Definition:</b> os.hpp:39</div></div>
 <div class="ttc" id="lambda_8hpp_html"><div class="ttname"><a href="lambda_8hpp.html">lambda.hpp</a></div></div>
 <div class="ttc" id="structproc_1_1ProcessStatus_html_a42c4886162f88b8efd2422df00083955"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#a42c4886162f88b8efd2422df00083955">proc::ProcessStatus::rss</a></div><div class="ttdeci">const long rss</div><div class="ttdef"><b>Definition:</b> proc.hpp:149</div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_ab03ced250ed239bc3b50b669493997f9"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a></div><div class="ttdeci">DWORD pid_t</div><div class="ttdef"><b>Definition:</b> windows.hpp:187</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_ab03ced250ed239bc3b50b669493997f9"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a></div><div class="ttdeci">DWORD pid_t</div><div class="ttdef"><b>Definition:</b> windows.hpp:181</div></div>
 <div class="ttc" id="structos_1_1Process_html"><div class="ttname"><a href="structos_1_1Process.html">os::Process</a></div><div class="ttdef"><b>Definition:</b> process.hpp:32</div></div>
 <div class="ttc" id="structos_1_1Memory_html_a00f1a2071778c1ce10eff411fae079d5"><div class="ttname"><a href="structos_1_1Memory.html#a00f1a2071778c1ce10eff411fae079d5">os::Memory::totalSwap</a></div><div class="ttdeci">Bytes totalSwap</div><div class="ttdef"><b>Definition:</b> os.hpp:38</div></div>
 <div class="ttc" id="structproc_1_1ProcessStatus_html_a9095310f297abb51a4391a9f7c5f1b2d"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#a9095310f297abb51a4391a9f7c5f1b2d">proc::ProcessStatus::utime</a></div><div class="ttdeci">const unsigned long utime</div><div class="ttdef"><b>Definition:</b> proc.hpp:139</div></div>