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/18 09:30:13 UTC

[22/48] mesos-site git commit: Updated the website built from mesos SHA: c020a13.

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/d7774475/content/api/latest/c++/posix_2su_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/posix_2su_8hpp_source.html b/content/api/latest/c++/posix_2su_8hpp_source.html
index 83633ea..5cd72d7 100644
--- a/content/api/latest/c++/posix_2su_8hpp_source.html
+++ b/content/api/latest/c++/posix_2su_8hpp_source.html
@@ -55,14 +55,14 @@
 <a href="posix_2su_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 to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// or more contributor license agreements.  See the NOTICE file</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">// regarding copyright ownership.  The ASF licenses this file</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">// to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00006"></a><span c
 lass="lineno">    6</span>&#160;<span class="comment">// &quot;License&quot;); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// with the License.  You may obtain a copy of the License at</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">//     http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;<span class="comment">// distrib
 uted under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;</div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="preprocessor">#ifndef __STOUT_OS_POSIX_SU_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#define __STOUT_OS_POSIX_SU_HPP__</span></div><div class="l
 ine"><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;errno.h&gt;</span></div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;grp.h&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;limits.h&gt;</span></div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;<span class="preprocessor">#include &lt;pwd.h&gt;</span></div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;<span class="preprocessor">#include &lt;unistd.h&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;sys/syscall.h&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="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="preprocessor">#include &lt;vector&gt;</span></div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;</div><div class="line"><a name="l00031"></a><span class="lineno">   31</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="l00032"></a><span class="lineno">   32</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="none_8hpp.html">stout/none.hpp</a>&gt;</span></div><div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="nothing_8
 hpp.html">stout/nothing.hpp</a>&gt;</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</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="l00035"></a><span class="lineno">   35</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="result_8hpp.html">stout/result.hpp</a>&gt;</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</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="l00037"></a><span class="lineno">   37</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="l00038"></a><span class="lineno">   38</span>&#160;</div><div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;<sp
 an class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;</div><div class="line"><a name="l00041"></a><span class="lineno"><a class="line" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">   41</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classResult.html">Result&lt;uid_t&gt;</a> <a class="code" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">getuid</a>(<span class="keyword">const</span> <a class="code" href="classOption.html">Option&lt;std::string&gt;</a>&amp; <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a> = <a class="code" href="structNone.html">None</a>())</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="keywordflow">if</span> (<a class="code" href="namespa
 ceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>.isNone()) {</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;    <a class="code" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">return ::getuid</a>();</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;</div><div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;  <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a> = sysconf(_SC_GETPW_R_SIZE_MAX);</div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;  <span class="keywordflow">if</span> (size == -1) {</div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;    <span class="comment">// Initial value for buffer size.</span></div><div class="line"><a name="l00050"></a>
 <span class="lineno">   50</span>&#160;    size = 1024;</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;  <span class="keywordflow">while</span> (<span class="keyword">true</span>) {</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;    <span class="keyword">struct </span><a class="code" href="structpasswd.html">passwd</a> pwd;</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;    <span class="keyword">struct </span><a class="code" href="structpasswd.html">passwd</a>* result;</div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;    <span class="keywordtype">char</span>* buffer = <span class="keyword">new</span> <span class="keywordtype">char</span>[<a class="code" href="namespaceos_1_1s
 tat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>];</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="keywordflow">if</span> (getpwnam_r(<a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>-&gt;c_str(), &amp;pwd, buffer, <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>, &amp;result) == 0) {</div><div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;      <span class="comment">// Per POSIX, if the user name is not found, `getpwnam_r` returns</span></div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;      <span class="comment">// zero and sets `result` to the null pointer. (Linux behaves</span></div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;      <span class="comment">// differently for in
 valid user names; see below).</span></div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;      <span class="keywordflow">if</span> (result == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;        <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;      }</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;      <span class="comment">// Entry found.</span></div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;      <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp
 .html#afc544433253791fc5f87b8203c9b6e63">uid_t</a> <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a> = pwd.<a class="code" href="structpasswd.html#aa6e0e62ee3cf5152f2697a0104f627c1">pw_uid</a>;</div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;      <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>;</div><div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;    } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;      <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;</div><div class="line"><a name="l00074"></a><span class="lin
 eno">   74</span>&#160;      <span class="keywordflow">if</span> (errno == ERANGE) {</div><div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;        <span class="comment">// Buffer too small; enlarge it and retry.</span></div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;        size *= 2;</div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;        <span class="keywordflow">continue</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;</div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;      <span class="comment">// According to POSIX, a non-zero return value from `getpwnam_r`</span></div><div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;      <span class="comment">// indicates an error. However, some version
 s of glibc return</span></div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;      <span class="comment">// non-zero and set errno to ENOENT, ESRCH, EBADF, EPERM,</span></div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;      <span class="comment">// EINVAL, or other values if the user name was invalid and/or</span></div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;      <span class="comment">// not found. POSIX and Linux manpages also list certain errno</span></div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;      <span class="comment">// values (e.g., EIO, EMFILE) as definitely indicating an error.</span></div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;      <span class="comment">//</span></div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;      <span class="comment">// Hence, we check 
 for those specific error values and return an</span></div><div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;      <span class="comment">// error to the caller; for any errno value not in that list, we</span></div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;      <span class="comment">// assume the user name wasn&#39;t found.</span></div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;      <span class="comment">//</span></div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;      <span class="comment">// TODO(neilc): Consider retrying on EINTR.</span></div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;      <span class="keywordflow">if</span> (errno != EIO &amp;&amp;</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;          errno != EINTR &amp;&amp;</div><div class="line"><a name="l00094"></a><span
  class="lineno">   94</span>&#160;          errno != EMFILE &amp;&amp;</div><div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;          errno != ENFILE &amp;&amp;</div><div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;          errno != ENOMEM) {</div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</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="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to get username information&quot;</span>);</div><div class="line"><a name="l00101"></a><span class="lineno">
   101</span>&#160;    }</div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;  }</div><div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;</div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;  <a class="code" href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</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;</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"><a class="line" href="namespaceos.html#ae4b3b2f098e140e75c4bcc5dc15abf30">  108</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;Nothing&gt;</a> <a class="code" href="namespaceos.html#ae4b3b2f098e140e75c4bcc5dc15abf30">setuid</a>(<a class="code" href="3r
 dparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">uid_t</a> <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>)</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;{</div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#ae4b3b2f098e140e75c4bcc5dc15abf30">setuid</a>(uid) == -1) {</div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</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;  <span class="keywordflow">return</span> <a class="code" hre
 f="structNothing.html">Nothing</a>();</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;</div><div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;</div><div class="line"><a name="l00118"></a><span class="lineno"><a class="line" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">  118</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classResult.html">Result&lt;gid_t&gt;</a> <a class="code" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">getgid</a>(<span class="keyword">const</span> <a class="code" href="classOption.html">Option&lt;std::string&gt;</a>&amp; <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a> = <a class="code" href="structNone.html">None</a>())</div><div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;{</div><div class="line"><a nam
 e="l00120"></a><span class="lineno">  120</span>&#160;  <span class="keywordflow">if</span> (<a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>.isNone()) {</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;    <a class="code" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">return ::getgid</a>();</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">int</span> <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a> = sysconf(_SC_GETPW_R_SIZE_MAX);</div><div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;  <span class="keywordflow">if</span> (size == -1) {</div><div class="line"><a name="l00126"></a><span class="lineno">  126</
 span>&#160;    <span class="comment">// Initial value for buffer size.</span></div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;    size = 1024;</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;</div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;  <span class="keywordflow">while</span> (<span class="keyword">true</span>) {</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;    <span class="keyword">struct </span><a class="code" href="structpasswd.html">passwd</a> pwd;</div><div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;    <span class="keyword">struct </span><a class="code" href="structpasswd.html">passwd</a>* result;</div><div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;    <span class="keywordtype">char</spa
 n>* buffer = <span class="keyword">new</span> <span class="keywordtype">char</span>[<a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</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;    <span class="keywordflow">if</span> (getpwnam_r(<a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>-&gt;c_str(), &amp;pwd, buffer, <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>, &amp;result) == 0) {</div><div class="line"><a name="l00136"></a><span class="lineno">  136</span>&#160;      <span class="comment">// Per POSIX, if the user name is not found, `getpwnam_r` returns</span></div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;      <span class="comment">// zero and sets `result` to the null pointer. (Linux behaves</span></div><div 
 class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;      <span class="comment">// differently for invalid user names; see below).</span></div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;      <span class="keywordflow">if</span> (result == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;        <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div><div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;      }</div><div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;</div><div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;      <span class="comment">// Entry found.</span></div><div class="line"><a name="l0
 0145"></a><span class="lineno">  145</span>&#160;      <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a> gid = pwd.<a class="code" href="structpasswd.html#aefbacfb7dc7f7f47313d08707253e4c6">pw_gid</a>;</div><div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;      <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;      <span class="keywordflow">return</span> gid;</div><div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;    } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;      <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;</div><div class="line"><a name="l00151"></a><span class="lineno">  151</span>&#160;      <span class="keywordf
 low">if</span> (errno == ERANGE) {</div><div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;        <span class="comment">// Buffer too small; enlarge it and retry.</span></div><div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;        size *= 2;</div><div class="line"><a name="l00154"></a><span class="lineno">  154</span>&#160;        <span class="keywordflow">continue</span>;</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;      <span class="comment">// According to POSIX, a non-zero return value from `getpwnam_r`</span></div><div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;      <span class="comment">// indicates an error. However, some versions of glibc return</span></div><div class="line"><a
  name="l00159"></a><span class="lineno">  159</span>&#160;      <span class="comment">// non-zero and set errno to ENOENT, ESRCH, EBADF, EPERM,</span></div><div class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;      <span class="comment">// EINVAL, or other values if the user name was invalid and/or</span></div><div class="line"><a name="l00161"></a><span class="lineno">  161</span>&#160;      <span class="comment">// not found. POSIX and Linux manpages also list certain errno</span></div><div class="line"><a name="l00162"></a><span class="lineno">  162</span>&#160;      <span class="comment">// values (e.g., EIO, EMFILE) as definitely indicating an error.</span></div><div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160;      <span class="comment">//</span></div><div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;      <span class="comment">// Hence, we check for those specific error values and return an</spa
 n></div><div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;      <span class="comment">// error to the caller; for any errno value not in that list, we</span></div><div class="line"><a name="l00166"></a><span class="lineno">  166</span>&#160;      <span class="comment">// assume the user name wasn&#39;t found.</span></div><div class="line"><a name="l00167"></a><span class="lineno">  167</span>&#160;      <span class="comment">//</span></div><div class="line"><a name="l00168"></a><span class="lineno">  168</span>&#160;      <span class="comment">// TODO(neilc): Consider retrying on EINTR.</span></div><div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;      <span class="keywordflow">if</span> (errno != EIO &amp;&amp;</div><div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;          errno != EINTR &amp;&amp;</div><div class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;          errno 
 != EMFILE &amp;&amp;</div><div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;          errno != ENFILE &amp;&amp;</div><div class="line"><a name="l00173"></a><span class="lineno">  173</span>&#160;          errno != ENOMEM) {</div><div class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div><div class="line"><a name="l00175"></a><span class="lineno">  175</span>&#160;      }</div><div class="line"><a name="l00176"></a><span class="lineno">  176</span>&#160;</div><div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to get username information&quot;</span>);</div><div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;    }</div><div class="line"><a 
 name="l00179"></a><span class="lineno">  179</span>&#160;  }</div><div class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;</div><div class="line"><a name="l00181"></a><span class="lineno">  181</span>&#160;  <a class="code" href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div class="line"><a name="l00182"></a><span class="lineno">  182</span>&#160;}</div><div class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;</div><div class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;</div><div class="line"><a name="l00185"></a><span class="lineno"><a class="line" href="namespaceos.html#a34d621fcc9ff30cfe4869b40644a3b2b">  185</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;Nothing&gt;</a> <a class="code" href="namespaceos.html#a34d621fcc9ff30cfe4869b40644a3b2b">setgid</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a
 78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a> gid)</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="keywordflow">if</span> (::<a class="code" href="namespaceos.html#a34d621fcc9ff30cfe4869b40644a3b2b">setgid</a>(gid) == -1) {</div><div class="line"><a name="l00188"></a><span class="lineno">  188</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div><div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;  }</div><div class="line"><a name="l00190"></a><span class="lineno">  190</span>&#160;</div><div class="line"><a name="l00191"></a><span class="lineno">  191</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div><div class="line"><a name="l00192"></a><span class="lineno">  192</span>&#160;}</div><div cla
 ss="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;</div><div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;</div><div class="line"><a name="l00195"></a><span class="lineno"><a class="line" href="namespaceos.html#a5f12facb4a752145ca6b7657bb6b35e7">  195</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;std::vector&lt;gid_t&gt;</a>&gt; <a class="code" href="namespaceos.html#a5f12facb4a752145ca6b7657bb6b35e7">getgrouplist</a>(<span class="keyword">const</span> std::string&amp; <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>)</div><div class="line"><a name="l00196"></a><span class="lineno">  196</span>&#160;{</div><div class="line"><a name="l00197"></a><span class="lineno">  197</span>&#160;  <span class="comment">// TODO(jieyu): Consider adding a &#39;gid&#39; parameter and avoid calling</span></div><div class="line"><a name="l00198"></a><span class="lineno"> 
  198</span>&#160;  <span class="comment">// getgid here. In some cases, the primary gid might be known.</span></div><div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;  <a class="code" href="classResult.html">Result&lt;gid_t&gt;</a> gid = <a class="code" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">os::getgid</a>(user);</div><div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;  <span class="keywordflow">if</span> (!gid.<a class="code" href="classResult.html#a85eaa52037223d71092e65701c166562">isSome</a>()) {</div><div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to get the gid of the user: &quot;</span> +</div><div class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;                 (gid.<a class="code" href="classResult.html#aeca16ad17d29
 9ad885c9b46c83b12a3d">isError</a>() ? gid.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">error</a>() : <span class="stringliteral">&quot;group not found&quot;</span>));</div><div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;  }</div><div class="line"><a name="l00204"></a><span class="lineno">  204</span>&#160;</div><div class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;<span class="preprocessor">#ifdef __APPLE__</span></div><div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;  <span class="comment">// TODO(gilbert): Instead of setting &#39;ngroups&#39; as a large value,</span></div><div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;  <span class="comment">// we should figure out a way to probe &#39;ngroups&#39; on OS X. Currently</span></div><div class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;  <span class="comment">// neither &
 #39;_SC_NGROUPS_MAX&#39; nor &#39;NGROUPS_MAX&#39; is appropriate,</span></div><div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;  <span class="comment">// because both are fixed as 16 on Darwin kernel, which is the</span></div><div class="line"><a name="l00210"></a><span class="lineno">  210</span>&#160;  <span class="comment">// cache size.</span></div><div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;  <span class="keywordtype">int</span> ngroups = 65536;</div><div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;  <span class="keywordtype">int</span> gids[ngroups];</div><div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l00214"></a><span class="lineno">  214</span>&#160;  <span class="keywordtype">int</span> ngroups = NGROUPS_MAX;</div><div class="line"><a name="l00215"></a><span class="lineno">  215</s
 pan>&#160;  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a> gids[ngroups];</div><div class="line"><a name="l00216"></a><span class="lineno">  216</span>&#160;<span class="preprocessor">#endif</span></div><div class="line"><a name="l00217"></a><span class="lineno">  217</span>&#160;  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#a5f12facb4a752145ca6b7657bb6b35e7">getgrouplist</a>(user.c_str(), gid.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>(), gids, &amp;ngroups) == -1) {</div><div class="line"><a name="l00218"></a><span class="lineno">  218</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div><div class="line"><a name="l00219"></a><span class="lineno">  219</span>&#160;  }</div><div class="line"><a name="l00220"></a><span class="lineno">  220</span>&#160;</div><div class="line
 "><a name="l00221"></a><span class="lineno">  221</span>&#160;  <span class="keywordflow">return</span> std::vector&lt;gid_t&gt;(gids, gids + ngroups);</div><div class="line"><a name="l00222"></a><span class="lineno">  222</span>&#160;}</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"><a class="line" href="namespaceos.html#a84b1082a4cacbb147c1ded91d860b4b5">  225</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;Nothing&gt;</a> <a class="code" href="namespaceos.html#a84b1082a4cacbb147c1ded91d860b4b5">setgroups</a>(</div><div class="line"><a name="l00226"></a><span class="lineno">  226</span>&#160;    <span class="keyword">const</span> std::vector&lt;gid_t&gt;&amp; gids,</div><div class="line"><a name="l00227"></a><span class="lineno">  227</span>&#160;    <
 span class="keyword">const</span> <a class="code" href="classOption.html">Option&lt;uid_t&gt;</a>&amp; <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a> = <a class="code" href="structNone.html">None</a>())</div><div class="line"><a name="l00228"></a><span class="lineno">  228</span>&#160;{</div><div class="line"><a name="l00229"></a><span class="lineno">  229</span>&#160;  <span class="keywordtype">int</span> ngroups = <span class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span class="keyword">&gt;</span>(gids.size());</div><div class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a> _gids[ngroups];</div><div class="line"><a name="l00231"></a><span class="lineno">  231</span>&#160;</div><div class="line"><a name="l00232"></a><span class="lineno">  232</span>&#160;  <span class="keywo
 rdflow">for</span> (<span class="keywordtype">int</span> i = 0; i &lt; ngroups; i++) {</div><div class="line"><a name="l00233"></a><span class="lineno">  233</span>&#160;    _gids[i] = gids[i];</div><div class="line"><a name="l00234"></a><span class="lineno">  234</span>&#160;  }</div><div class="line"><a name="l00235"></a><span class="lineno">  235</span>&#160;</div><div class="line"><a name="l00236"></a><span class="lineno">  236</span>&#160;<span class="preprocessor">#ifdef __APPLE__</span></div><div class="line"><a name="l00237"></a><span class="lineno">  237</span>&#160;  <span class="comment">// Cannot simply call &#39;setgroups&#39; here because it only updates</span></div><div class="line"><a name="l00238"></a><span class="lineno">  238</span>&#160;  <span class="comment">// the list of groups in kernel cache, but not the ones in</span></div><div class="line"><a name="l00239"></a><span class="lineno">  239</span>&#160;  <span class="comment">// opendirectoryd. Darwin kernel 
 caches part of the groups in</span></div><div class="line"><a name="l00240"></a><span class="lineno">  240</span>&#160;  <span class="comment">// kernel, and the rest in opendirectoryd.</span></div><div class="line"><a name="l00241"></a><span class="lineno">  241</span>&#160;  <span class="comment">// For more detail please see:</span></div><div class="line"><a name="l00242"></a><span class="lineno">  242</span>&#160;  <span class="comment">// https://github.com/practicalswift/osx/blob/master/src/samba/patches/support-darwin-initgroups-syscall // NOLINT</span></div><div class="line"><a name="l00243"></a><span class="lineno">  243</span>&#160;  <span class="keywordtype">int</span> maxgroups = sysconf(_SC_NGROUPS_MAX);</div><div class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;  <span class="keywordflow">if</span> (maxgroups == -1) {</div><div class="line"><a name="l00245"></a><span class="lineno">  245</span>&#160;    <span class="keywordflow">return</span> <a
  class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to get sysconf(_SC_NGROUPS_MAX)&quot;</span>);</div><div class="line"><a name="l00246"></a><span class="lineno">  246</span>&#160;  }</div><div class="line"><a name="l00247"></a><span class="lineno">  247</span>&#160;</div><div class="line"><a name="l00248"></a><span class="lineno">  248</span>&#160;  <span class="keywordflow">if</span> (ngroups &gt; maxgroups) {</div><div class="line"><a name="l00249"></a><span class="lineno">  249</span>&#160;    ngroups = maxgroups;</div><div class="line"><a name="l00250"></a><span class="lineno">  250</span>&#160;  }</div><div class="line"><a name="l00251"></a><span class="lineno">  251</span>&#160;</div><div class="line"><a name="l00252"></a><span class="lineno">  252</span>&#160;  <span class="keywordflow">if</span> (<a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>.isNone()) {</div><div class="line"><a name="l00253">
 </a><span class="lineno">  253</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(</div><div class="line"><a name="l00254"></a><span class="lineno">  254</span>&#160;        <span class="stringliteral">&quot;The uid of the user who is associated with the group &quot;</span></div><div class="line"><a name="l00255"></a><span class="lineno">  255</span>&#160;        <span class="stringliteral">&quot;list we are setting is missing&quot;</span>);</div><div class="line"><a name="l00256"></a><span class="lineno">  256</span>&#160;  }</div><div class="line"><a name="l00257"></a><span class="lineno">  257</span>&#160;</div><div class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;  <span class="comment">// NOTE: By default, the maxgroups on Darwin kernel is fixed</span></div><div class="line"><a name="l00259"></a><span class="lineno">  259</span>&#160;  <span class="comment">// as 16. If we have more than 16 gids to se
 t for a specific</span></div><div class="line"><a name="l00260"></a><span class="lineno">  260</span>&#160;  <span class="comment">// user, then SYS_initgroups would send up to 16 of them to</span></div><div class="line"><a name="l00261"></a><span class="lineno">  261</span>&#160;  <span class="comment">// kernel cache, while the rest would still be performed</span></div><div class="line"><a name="l00262"></a><span class="lineno">  262</span>&#160;  <span class="comment">// correctly by the kernel (asking Directory Service to resolve</span></div><div class="line"><a name="l00263"></a><span class="lineno">  263</span>&#160;  <span class="comment">// the groups membership).</span></div><div class="line"><a name="l00264"></a><span class="lineno">  264</span>&#160;  <span class="keywordflow">if</span> (::syscall(SYS_initgroups, ngroups, _gids, <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>.get()) == -1) {</div><div class="line"><a name="l00265"
 ></a><span class="lineno">  265</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div><div class="line"><a name="l00266"></a><span class="lineno">  266</span>&#160;  }</div><div class="line"><a name="l00267"></a><span class="lineno">  267</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l00268"></a><span class="lineno">  268</span>&#160;  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#a84b1082a4cacbb147c1ded91d860b4b5">setgroups</a>(ngroups, _gids) == -1) {</div><div class="line"><a name="l00269"></a><span class="lineno">  269</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div><div class="line"><a name="l00270"></a><span class="lineno">  270</span>&#160;  }</div><div class="line"><a name="l00271"></a><span class="lineno">  271</span>&#160;<span class="preprocessor">#endif</span><
 /div><div class="line"><a name="l00272"></a><span class="lineno">  272</span>&#160;</div><div class="line"><a name="l00273"></a><span class="lineno">  273</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div><div class="line"><a name="l00274"></a><span class="lineno">  274</span>&#160;}</div><div class="line"><a name="l00275"></a><span class="lineno">  275</span>&#160;</div><div class="line"><a name="l00276"></a><span class="lineno">  276</span>&#160;</div><div class="line"><a name="l00277"></a><span class="lineno"><a class="line" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">  277</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classResult.html">Result&lt;std::string&gt;</a> <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>(<a class="code" href="classOption.html">Option&lt;uid_t&gt;</a> <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62f
 c25b56f6915800eb">uid</a> = <a class="code" href="structNone.html">None</a>())</div><div class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;{</div><div class="line"><a name="l00279"></a><span class="lineno">  279</span>&#160;  <span class="keywordflow">if</span> (<a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>.isNone()) {</div><div class="line"><a name="l00280"></a><span class="lineno">  280</span>&#160;    <a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a> = <a class="code" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">::getuid</a>();</div><div class="line"><a name="l00281"></a><span class="lineno">  281</span>&#160;  }</div><div class="line"><a name="l00282"></a><span class="lineno">  282</span>&#160;</div><div class="line"><a name="l00283"></a><span class="lineno">  283</span>&#160;  <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#
 a7a116891923bc8b5d8c50f78da8657be">size</a> = sysconf(_SC_GETPW_R_SIZE_MAX);</div><div class="line"><a name="l00284"></a><span class="lineno">  284</span>&#160;  <span class="keywordflow">if</span> (size == -1) {</div><div class="line"><a name="l00285"></a><span class="lineno">  285</span>&#160;    <span class="comment">// Initial value for buffer size.</span></div><div class="line"><a name="l00286"></a><span class="lineno">  286</span>&#160;    size = 1024;</div><div class="line"><a name="l00287"></a><span class="lineno">  287</span>&#160;  }</div><div class="line"><a name="l00288"></a><span class="lineno">  288</span>&#160;</div><div class="line"><a name="l00289"></a><span class="lineno">  289</span>&#160;  <span class="keywordflow">while</span> (<span class="keyword">true</span>) {</div><div class="line"><a name="l00290"></a><span class="lineno">  290</span>&#160;    <span class="keyword">struct </span><a class="code" href="structpasswd.html">passwd</a> pwd;</div><div class="line
 "><a name="l00291"></a><span class="lineno">  291</span>&#160;    <span class="keyword">struct </span><a class="code" href="structpasswd.html">passwd</a>* result;</div><div class="line"><a name="l00292"></a><span class="lineno">  292</span>&#160;    <span class="keywordtype">char</span>* buffer = <span class="keyword">new</span> <span class="keywordtype">char</span>[<a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>];</div><div class="line"><a name="l00293"></a><span class="lineno">  293</span>&#160;</div><div class="line"><a name="l00294"></a><span class="lineno">  294</span>&#160;    <span class="keywordflow">if</span> (getpwuid_r(<a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>.get(), &amp;pwd, buffer, <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>, &amp;result) == 0) {</div><div class="line"><a name="l00295"></a><span class="lineno">  295</span>&#160;     
  <span class="comment">// getpwuid_r will return 0 but set result == nullptr if the uid is</span></div><div class="line"><a name="l00296"></a><span class="lineno">  296</span>&#160;      <span class="comment">// not found.</span></div><div class="line"><a name="l00297"></a><span class="lineno">  297</span>&#160;      <span class="keywordflow">if</span> (result == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00298"></a><span class="lineno">  298</span>&#160;        <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00299"></a><span class="lineno">  299</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div><div class="line"><a name="l00300"></a><span class="lineno">  300</span>&#160;      }</div><div class="line"><a name="l00301"></a><span class="lineno">  301</span>&#160;</div><div class="line"><a name="l00302"></a><span class="lineno">  302</span>&#160;      std::str
 ing <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>(pwd.<a class="code" href="structpasswd.html#a6de92e6d2e3dd348ee82472d2b219556">pw_name</a>);</div><div class="line"><a name="l00303"></a><span class="lineno">  303</span>&#160;      <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00304"></a><span class="lineno">  304</span>&#160;      <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>;</div><div class="line"><a name="l00305"></a><span class="lineno">  305</span>&#160;    } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00306"></a><span class="lineno">  306</span>&#160;      <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00307"></a><span class="lineno">  307</span>&#160;</div><div class="line"><a name="l00308"></a><span class="lineno">  308</span>&#160;      <span class="keywordflow">if</sp
 an> (errno != ERANGE) {</div><div class="line"><a name="l00309"></a><span class="lineno">  309</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div><div class="line"><a name="l00310"></a><span class="lineno">  310</span>&#160;      }</div><div class="line"><a name="l00311"></a><span class="lineno">  311</span>&#160;</div><div class="line"><a name="l00312"></a><span class="lineno">  312</span>&#160;      <span class="comment">// getpwuid_r set ERANGE so try again with a larger buffer.</span></div><div class="line"><a name="l00313"></a><span class="lineno">  313</span>&#160;      size *= 2;</div><div class="line"><a name="l00314"></a><span class="lineno">  314</span>&#160;    }</div><div class="line"><a name="l00315"></a><span class="lineno">  315</span>&#160;  }</div><div class="line"><a name="l00316"></a><span class="lineno">  316</span>&#160;}</div><div class="line"><a name="l00317"></a><span class="lineno"> 
  317</span>&#160;</div><div class="line"><a name="l00318"></a><span class="lineno">  318</span>&#160;</div><div class="line"><a name="l00319"></a><span class="lineno"><a class="line" href="namespaceos.html#acae67fc8bd809c609bf1ffb281d921c6">  319</a></span>&#160;<span class="keyword">inline</span> <a class="code" href="classTry.html">Try&lt;Nothing&gt;</a> <a class="code" href="namespaceos.html#acae67fc8bd809c609bf1ffb281d921c6">su</a>(<span class="keyword">const</span> std::string&amp; <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>)</div><div class="line"><a name="l00320"></a><span class="lineno">  320</span>&#160;{</div><div class="line"><a name="l00321"></a><span class="lineno">  321</span>&#160;  <a class="code" href="classResult.html">Result&lt;gid_t&gt;</a> gid = <a class="code" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">os::getgid</a>(user);</div><div class="line"><a name="l00322"></a><span class="lineno">  322</span>&#160;  
 <span class="keywordflow">if</span> (gid.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>() || gid.<a class="code" href="classResult.html#ac2cdc0db9f9d29a5bb2f1cf19c29da49">isNone</a>()) {</div><div class="line"><a name="l00323"></a><span class="lineno">  323</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to getgid: &quot;</span> +</div><div class="line"><a name="l00324"></a><span class="lineno">  324</span>&#160;        (gid.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>() ? gid.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">error</a>() : <span class="stringliteral">&quot;unknown user&quot;</span>));</div><div class="line"><a name="l00325"></a><span class="lineno">  325</span>&#160;  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (::<a class="code" href="
 namespaceos.html#a34d621fcc9ff30cfe4869b40644a3b2b">setgid</a>(gid.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>())) {</div><div class="line"><a name="l00326"></a><span class="lineno">  326</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to set gid&quot;</span>);</div><div class="line"><a name="l00327"></a><span class="lineno">  327</span>&#160;  }</div><div class="line"><a name="l00328"></a><span class="lineno">  328</span>&#160;</div><div class="line"><a name="l00329"></a><span class="lineno">  329</span>&#160;  <span class="comment">// Set the supplementary group list. We ignore EPERM because</span></div><div class="line"><a name="l00330"></a><span class="lineno">  330</span>&#160;  <span class="comment">// performing a no-op call (switching to same group) still</span></div><div class="line"><a name="l00331"></a><span class="lineno">  331
 </span>&#160;  <span class="comment">// requires being privileged, unlike &#39;setgid&#39; and &#39;setuid&#39;.</span></div><div class="line"><a name="l00332"></a><span class="lineno">  332</span>&#160;  <span class="keywordflow">if</span> (::initgroups(user.c_str(), gid.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>()) == -1 &amp;&amp; errno != EPERM) {</div><div class="line"><a name="l00333"></a><span class="lineno">  333</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to set supplementary groups&quot;</span>);</div><div class="line"><a name="l00334"></a><span class="lineno">  334</span>&#160;  }</div><div class="line"><a name="l00335"></a><span class="lineno">  335</span>&#160;</div><div class="line"><a name="l00336"></a><span class="lineno">  336</span>&#160;  <a class="code" href="classResult.html">Result&lt;uid_t&gt;</a> <a class="code
 " href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a> = <a class="code" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">os::getuid</a>(user);</div><div class="line"><a name="l00337"></a><span class="lineno">  337</span>&#160;  <span class="keywordflow">if</span> (uid.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>() || uid.<a class="code" href="classResult.html#ac2cdc0db9f9d29a5bb2f1cf19c29da49">isNone</a>()) {</div><div class="line"><a name="l00338"></a><span class="lineno">  338</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">&quot;Failed to getuid: &quot;</span> +</div><div class="line"><a name="l00339"></a><span class="lineno">  339</span>&#160;        (uid.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>() ? uid.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">erro
 r</a>() : <span class="stringliteral">&quot;unknown user&quot;</span>));</div><div class="line"><a name="l00340"></a><span class="lineno">  340</span>&#160;  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#ae4b3b2f098e140e75c4bcc5dc15abf30">setuid</a>(uid.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>())) {</div><div class="line"><a name="l00341"></a><span class="lineno">  341</span>&#160;    <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">&quot;Failed to setuid&quot;</span>);</div><div class="line"><a name="l00342"></a><span class="lineno">  342</span>&#160;  }</div><div class="line"><a name="l00343"></a><span class="lineno">  343</span>&#160;</div><div class="line"><a name="l00344"></a><span class="lineno">  344</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="structNothing
 .html">Nothing</a>();</div><div class="line"><a name="l00345"></a><span class="lineno">  345</span>&#160;}</div><div class="line"><a name="l00346"></a><span class="lineno">  346</span>&#160;</div><div class="line"><a name="l00347"></a><span class="lineno">  347</span>&#160;} <span class="comment">// namespace os {</span></div><div class="line"><a name="l00348"></a><span class="lineno">  348</span>&#160;</div><div class="line"><a name="l00349"></a><span class="lineno">  349</span>&#160;<span class="preprocessor">#endif // __STOUT_OS_POSIX_SU_HPP__</span></div><div class="ttc" id="classResult_html_ac2cdc0db9f9d29a5bb2f1cf19c29da49"><div class="ttname"><a href="classResult.html#ac2cdc0db9f9d29a5bb2f1cf19c29da49">Result::isNone</a></div><div class="ttdeci">bool isNone() const </div><div class="ttdef"><b>Definition:</b> result.hpp:112</div></div>
 <div class="ttc" id="namespaceos_1_1stat_html_a96066cfc01f1f62fc25b56f6915800eb"><div class="ttname"><a href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">os::stat::uid</a></div><div class="ttdeci">Try&lt; uid_t &gt; uid(const std::string &amp;path, const FollowSymlink follow=FollowSymlink::FOLLOW_SYMLINK)</div><div class="ttdef"><b>Definition:</b> stat.hpp:213</div></div>
 <div class="ttc" id="structNothing_html"><div class="ttname"><a href="structNothing.html">Nothing</a></div><div class="ttdef"><b>Definition:</b> nothing.hpp:16</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="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="classOption_html"><div class="ttname"><a href="classOption.html">Option&lt; std::string &gt;</a></div></div>
 <div class="ttc" id="namespaceos_1_1stat_html_a7a116891923bc8b5d8c50f78da8657be"><div class="ttname"><a href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">os::stat::size</a></div><div class="ttdeci">Try&lt; Bytes &gt; size(const std::string &amp;path, const FollowSymlink follow=FollowSymlink::FOLLOW_SYMLINK)</div><div class="ttdef"><b>Definition:</b> stat.hpp:119</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="classResult_html_a521adf96f5c27d26d6b1d580aae8aaee"><div class="ttname"><a href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">Result::error</a></div><div class="ttdeci">static Result&lt; T &gt; error(const std::string &amp;message)</div><div class="ttdef"><b>Definition:</b> result.hpp:53</div></div>
 <div class="ttc" id="namespaceos_html_a698aa27e5ea6b1dc1c190b978c2f7960"><div class="ttname"><a href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">os::user</a></div><div class="ttdeci">Result&lt; std::string &gt; user(Option&lt; uid_t &gt; uid=None())</div><div class="ttdef"><b>Definition:</b> su.hpp:277</div></div>
 <div class="ttc" id="none_8hpp_html"><div class="ttname"><a href="none_8hpp.html">none.hpp</a></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="classErrnoError_html"><div class="ttname"><a href="classErrnoError.html">ErrnoError</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:50</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="structpasswd_html_aefbacfb7dc7f7f47313d08707253e4c6"><div class="ttname"><a href="structpasswd.html#aefbacfb7dc7f7f47313d08707253e4c6">passwd::pw_gid</a></div><div class="ttdeci">gid_t pw_gid</div><div class="ttdef"><b>Definition:</b> pwd.hpp:30</div></div>
 <div class="ttc" id="result_8hpp_html"><div class="ttname"><a href="result_8hpp.html">result.hpp</a></div></div>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/d7774475/content/api/latest/c++/posix_2xattr_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/posix_2xattr_8hpp_source.html b/content/api/latest/c++/posix_2xattr_8hpp_source.html
index e31d594..90f3fa1 100644
--- a/content/api/latest/c++/posix_2xattr_8hpp_source.html
+++ b/content/api/latest/c++/posix_2xattr_8hpp_source.html
@@ -59,7 +59,7 @@
 <div class="ttc" id="namespaceos_1_1stat_html_a7a116891923bc8b5d8c50f78da8657be"><div class="ttname"><a href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">os::stat::size</a></div><div class="ttdeci">Try&lt; Bytes &gt; size(const std::string &amp;path, const FollowSymlink follow=FollowSymlink::FOLLOW_SYMLINK)</div><div class="ttdef"><b>Definition:</b> stat.hpp:119</div></div>
 <div class="ttc" id="namespaceos_html_aa5f9db540e463927feff9b1e20de9ded"><div class="ttname"><a href="namespaceos.html#aa5f9db540e463927feff9b1e20de9ded">os::setxattr</a></div><div class="ttdeci">Try&lt; Nothing &gt; setxattr(const std::string &amp;path, const std::string &amp;name, const std::string &amp;value, int flags)</div><div class="ttdef"><b>Definition:</b> xattr.hpp:31</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="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="classErrnoError_html"><div class="ttname"><a href="classErrnoError.html">ErrnoError</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:50</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="nothing_8hpp_html"><div class="ttname"><a href="nothing_8hpp.html">nothing.hpp</a></div></div>
 <div class="ttc" id="decoder_8hpp_html_abb0829cce9dd20a40ae0d86890ae85c6"><div class="ttname"><a href="decoder_8hpp.html#abb0829cce9dd20a40ae0d86890ae85c6">flags</a></div><div class="ttdeci">#define flags</div><div class="ttdef"><b>Definition:</b> decoder.hpp:18</div></div>

http://git-wip-us.apache.org/repos/asf/mesos-site/blob/d7774475/content/api/latest/c++/proc_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/proc_8hpp_source.html b/content/api/latest/c++/proc_8hpp_source.html
index 1235724..f9a917d 100644
--- a/content/api/latest/c++/proc_8hpp_source.html
+++ b/content/api/latest/c++/proc_8hpp_source.html
@@ -59,7 +59,7 @@
 <div class="ttc" id="structproc_1_1ProcessStatus_html_a3ae685cf9da43d9751f12dbbd7384c18"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#a3ae685cf9da43d9751f12dbbd7384c18">proc::ProcessStatus::pgrp</a></div><div class="ttdeci">const pid_t pgrp</div><div class="ttdef"><b>Definition:</b> proc.hpp:130</div></div>
 <div class="ttc" id="structproc_1_1ProcessStatus_html_a20a702269174af3c3ef88540baf037ec"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#a20a702269174af3c3ef88540baf037ec">proc::ProcessStatus::signal</a></div><div class="ttdeci">const unsigned long signal</div><div class="ttdef"><b>Definition:</b> proc.hpp:155</div></div>
 <div class="ttc" id="structproc_1_1ProcessStatus_html_a0bd23f09e3d1bade63c0b5c3164ae41d"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#a0bd23f09e3d1bade63c0b5c3164ae41d">proc::ProcessStatus::cmajflt</a></div><div class="ttdeci">const unsigned long cmajflt</div><div class="ttdef"><b>Definition:</b> proc.hpp:138</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="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="structproc_1_1ProcessStatus_html_aac90b41880a20697bf7d227859f5f2ef"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#aac90b41880a20697bf7d227859f5f2ef">proc::ProcessStatus::tpgid</a></div><div class="ttdeci">const pid_t tpgid</div><div class="ttdef"><b>Definition:</b> proc.hpp:133</div></div>
 <div class="ttc" id="classOption_html"><div class="ttname"><a href="classOption.html">Option&lt; pid_t &gt;</a></div></div>
 <div class="ttc" id="structproc_1_1ProcessStatus_html_a7a541d6b5a176cc2f0c3888f888d4c62"><div class="ttname"><a href="structproc_1_1ProcessStatus.html#a7a541d6b5a176cc2f0c3888f888d4c62">proc::ProcessStatus::vsize</a></div><div class="ttdeci">const unsigned long vsize</div><div class="ttdef"><b>Definition:</b> proc.hpp:148</div></div>