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:21:23 UTC
[08/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++/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 80a89f8..83633ea 100644
--- a/content/api/latest/c++/posix_2su_8hpp_source.html
+++ b/content/api/latest/c++/posix_2su_8hpp_source.html
@@ -53,11 +53,11 @@
</div><!--header-->
<div class="contents">
<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> <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> <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> <span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <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> <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> <span class="comment">// "License"); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <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> <span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <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> <span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <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> <span class="comment">// distrib
uted under the License is distributed on an "AS IS" BASIS,</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <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> <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> <span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#ifndef __STOUT_OS_POSIX_SU_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __STOUT_OS_POSIX_SU_HPP__</span></div><div class="l
ine"><a name="l00019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <errno.h></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <grp.h></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <limits.h></span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <pwd.h></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <unistd.h></span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <sys/syscall.h>
;</span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <string></span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <vector></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="error_8hpp.html">stout/error.hpp</a>></span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="none_8hpp.html">stout/none.hpp</a>></span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="nothing_8
hpp.html">stout/nothing.hpp</a>></span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="result_8hpp.html">stout/result.hpp</a>></span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <<a class="code" href="unreachable_8hpp.html">stout/unreachable.hpp</a>></span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <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> </div><div class="line"><a name="l00041"></a><span class="lineno"><a class="line" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4"> 41</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<uid_t></a> <a class="code" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">getuid</a>(<span class="keyword">const</span> <a class="code" href="classOption.html">Option<std::string></a>& <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> {</div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <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>  <a class="code" href="namespaceos.html#ab20654c3bd05280d32833e654c61b1e4">return ::getuid</a>();</div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  }</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> </div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <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>  <span class="keywordflow">if</span> (size == -1) {</div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  <span class="comment">// Initial value for buffer size.</span></div><div class="line"><a name="l00050"></a>
<span class="lineno"> 50</span>  size = 1024;</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  }</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> </div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <span class="keywordflow">while</span> (<span class="keyword">true</span>) {</div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  <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>  <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>  <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> </div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="keywordflow">if</span> (getpwnam_r(<a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>->c_str(), &pwd, buffer, <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>, &result) == 0) {</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <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>  <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>  <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>  <span class="keywordflow">if</span> (result == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <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>  }</div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> </div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="comment">// Entry found.</span></div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <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>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  <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>  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> </div><div class="line"><a name="l00074"></a><span class="lin
eno"> 74</span>  <span class="keywordflow">if</span> (errno == ERANGE) {</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="comment">// Buffer too small; enlarge it and retry.</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  size *= 2;</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  }</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> </div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  <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>  <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>  <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>  <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>  <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>  <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>  <span class="comment">//</span></div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <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>  <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>  <span class="comment">// assume the user name wasn't found.</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="comment">//</span></div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="comment">// TODO(neilc): Consider retrying on EINTR.</span></div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keywordflow">if</span> (errno != EIO &&</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  errno != EINTR &&</div><div class="line"><a name="l00094"></a><span
class="lineno"> 94</span>  errno != EMFILE &&</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  errno != ENFILE &&</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  errno != ENOMEM) {</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <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>  }</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span> </div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to get username information"</span>);</div><div class="line"><a name="l00101"></a><span class="lineno">
101</span>  }</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  }</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span> </div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <a class="code" href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> }</div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span> </div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> </div><div class="line"><a name="l00108"></a><span class="lineno"><a class="line" href="namespaceos.html#ae4b3b2f098e140e75c4bcc5dc15abf30"> 108</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></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> {</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <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>  <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>  }</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span> </div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <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> }</div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span> </div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span> </div><div class="line"><a name="l00118"></a><span class="lineno"><a class="line" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206"> 118</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<gid_t></a> <a class="code" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">getgid</a>(<span class="keyword">const</span> <a class="code" href="classOption.html">Option<std::string></a>& <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> {</div><div class="line"><a nam
e="l00120"></a><span class="lineno"> 120</span>  <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>  <a class="code" href="namespaceos.html#a3d46f808886a786c2daab6eb1d81b206">return ::getgid</a>();</div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  }</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span> </div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <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>  <span class="keywordflow">if</span> (size == -1) {</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</
span>  <span class="comment">// Initial value for buffer size.</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  size = 1024;</div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  }</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span> </div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="keywordflow">while</span> (<span class="keyword">true</span>) {</div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <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>  <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>  <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> </div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="keywordflow">if</span> (getpwnam_r(<a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>->c_str(), &pwd, buffer, <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>, &result) == 0) {</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <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>  <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>  <span class="comment">// differently for invalid user names; see below).</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="keywordflow">if</span> (result == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <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>  }</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="comment">// Entry found.</span></div><div class="line"><a name="l0
0145"></a><span class="lineno"> 145</span>  <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>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="keywordflow">return</span> gid;</div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> </div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="keywordf
low">if</span> (errno == ERANGE) {</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="comment">// Buffer too small; enlarge it and retry.</span></div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  size *= 2;</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  }</div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span> </div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <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>  <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>  <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>  <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>  <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>  <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>  <span class="comment">//</span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <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>  <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>  <span class="comment">// assume the user name wasn't found.</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="comment">//</span></div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="comment">// TODO(neilc): Consider retrying on EINTR.</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <span class="keywordflow">if</span> (errno != EIO &&</div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  errno != EINTR &&</div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  errno
!= EMFILE &&</div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  errno != ENFILE &&</div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  errno != ENOMEM) {</div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  <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>  }</div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span> </div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to get username information"</span>);</div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  }</div><div class="line"><a
name="l00179"></a><span class="lineno"> 179</span>  }</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span> </div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <a class="code" href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span> }</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span> </div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span> </div><div class="line"><a name="l00185"></a><span class="lineno"><a class="line" href="namespaceos.html#a34d621fcc9ff30cfe4869b40644a3b2b"> 185</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></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> {</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <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>  <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>  }</div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span> </div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <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> }</div><div cla
ss="line"><a name="l00193"></a><span class="lineno"> 193</span> </div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span> </div><div class="line"><a name="l00195"></a><span class="lineno"><a class="line" href="namespaceos.html#a5f12facb4a752145ca6b7657bb6b35e7"> 195</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::vector<gid_t></a>> <a class="code" href="namespaceos.html#a5f12facb4a752145ca6b7657bb6b35e7">getgrouplist</a>(<span class="keyword">const</span> std::string& <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>)</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span> {</div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="comment">// TODO(jieyu): Consider adding a 'gid' parameter and avoid calling</span></div><div class="line"><a name="l00198"></a><span class="lineno">
198</span>  <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>  <a class="code" href="classResult.html">Result<gid_t></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>  <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>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"Failed to get the gid of the user: "</span> +</div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  (gid.<a class="code" href="classResult.html#aeca16ad17d29
9ad885c9b46c83b12a3d">isError</a>() ? gid.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">error</a>() : <span class="stringliteral">"group not found"</span>));</div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  }</div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span> </div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="preprocessor">#ifdef __APPLE__</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="comment">// TODO(gilbert): Instead of setting 'ngroups' as a large value,</span></div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="comment">// we should figure out a way to probe 'ngroups' on OS X. Currently</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="comment">// neither &
#39;_SC_NGROUPS_MAX' nor 'NGROUPS_MAX' is appropriate,</span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <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>  <span class="comment">// cache size.</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="keywordtype">int</span> ngroups = 65536;</div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keywordtype">int</span> gids[ngroups];</div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="keywordtype">int</span> ngroups = NGROUPS_MAX;</div><div class="line"><a name="l00215"></a><span class="lineno"> 215</s
pan>  <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> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <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, &ngroups) == -1) {</div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  <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>  }</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span> </div><div class="line
"><a name="l00221"></a><span class="lineno"> 221</span>  <span class="keywordflow">return</span> std::vector<gid_t>(gids, gids + ngroups);</div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span> }</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> </div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span> </div><div class="line"><a name="l00225"></a><span class="lineno"><a class="line" href="namespaceos.html#a84b1082a4cacbb147c1ded91d860b4b5"> 225</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#a84b1082a4cacbb147c1ded91d860b4b5">setgroups</a>(</div><div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <span class="keyword">const</span> std::vector<gid_t>& gids,</div><div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <
span class="keyword">const</span> <a class="code" href="classOption.html">Option<uid_t></a>& <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> {</div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keywordtype">int</span> ngroups = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(gids.size());</div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <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> </div><div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  <span class="keywo
rdflow">for</span> (<span class="keywordtype">int</span> i = 0; i < ngroups; i++) {</div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  _gids[i] = gids[i];</div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  }</div><div class="line"><a name="l00235"></a><span class="lineno"> 235</span> </div><div class="line"><a name="l00236"></a><span class="lineno"> 236</span> <span class="preprocessor">#ifdef __APPLE__</span></div><div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="comment">// Cannot simply call 'setgroups' here because it only updates</span></div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <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>  <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>  <span class="comment">// kernel, and the rest in opendirectoryd.</span></div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  <span class="comment">// For more detail please see:</span></div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  <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>  <span class="keywordtype">int</span> maxgroups = sysconf(_SC_NGROUPS_MAX);</div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <span class="keywordflow">if</span> (maxgroups == -1) {</div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keywordflow">return</span> <a
class="code" href="classError.html">Error</a>(<span class="stringliteral">"Failed to get sysconf(_SC_NGROUPS_MAX)"</span>);</div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  }</div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span> </div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  <span class="keywordflow">if</span> (ngroups > maxgroups) {</div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  ngroups = maxgroups;</div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  }</div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span> </div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <span class="keywordflow">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>  <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>  <span class="stringliteral">"The uid of the user who is associated with the group "</span></div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  <span class="stringliteral">"list we are setting is missing"</span>);</div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  }</div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span> </div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <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>  <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>  <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>  <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>  <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>  <span class="comment">// the groups membership).</span></div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <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>  <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>  }</div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  <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>  <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>  }</div><div class="line"><a name="l00271"></a><span class="lineno"> 271</span> <span class="preprocessor">#endif</span><
/div><div class="line"><a name="l00272"></a><span class="lineno"> 272</span> </div><div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <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> }</div><div class="line"><a name="l00275"></a><span class="lineno"> 275</span> </div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span> </div><div class="line"><a name="l00277"></a><span class="lineno"><a class="line" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960"> 277</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<std::string></a> <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>(<a class="code" href="classOption.html">Option<uid_t></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> {</div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <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>  <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>  }</div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span> </div><div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  <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>  <span class="keywordflow">if</span> (size == -1) {</div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="comment">// Initial value for buffer size.</span></div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  size = 1024;</div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  }</div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span> </div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  <span class="keywordflow">while</span> (<span class="keyword">true</span>) {</div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <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>  <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>  <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> </div><div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  <span class="keywordflow">if</span> (getpwuid_r(<a class="code" href="namespaceos_1_1stat.html#a96066cfc01f1f62fc25b56f6915800eb">uid</a>.get(), &pwd, buffer, <a class="code" href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>, &result) == 0) {</div><div class="line"><a name="l00295"></a><span class="lineno"> 295</span> 
<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>  <span class="comment">// not found.</span></div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span>  <span class="keywordflow">if</span> (result == <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  <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>  }</div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span> </div><div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  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>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <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>  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  <span class="keyword">delete</span>[] buffer;</div><div class="line"><a name="l00307"></a><span class="lineno"> 307</span> </div><div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  <span class="keywordflow">if</sp
an> (errno != ERANGE) {</div><div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <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>  }</div><div class="line"><a name="l00311"></a><span class="lineno"> 311</span> </div><div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  <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>  size *= 2;</div><div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  }</div><div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  }</div><div class="line"><a name="l00316"></a><span class="lineno"> 316</span> }</div><div class="line"><a name="l00317"></a><span class="lineno">
317</span> </div><div class="line"><a name="l00318"></a><span class="lineno"> 318</span> </div><div class="line"><a name="l00319"></a><span class="lineno"><a class="line" href="namespaceos.html#acae67fc8bd809c609bf1ffb281d921c6"> 319</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#acae67fc8bd809c609bf1ffb281d921c6">su</a>(<span class="keyword">const</span> std::string& <a class="code" href="namespaceos.html#a698aa27e5ea6b1dc1c190b978c2f7960">user</a>)</div><div class="line"><a name="l00320"></a><span class="lineno"> 320</span> {</div><div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  <a class="code" href="classResult.html">Result<gid_t></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> 
<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>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"Failed to getgid: "</span> +</div><div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  (gid.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>() ? gid.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">error</a>() : <span class="stringliteral">"unknown user"</span>));</div><div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  } <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>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to set gid"</span>);</div><div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  }</div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span> </div><div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  <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>  <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>  <span class="comment">// requires being privileged, unlike 'setgid' and 'setuid'.</span></div><div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <span class="keywordflow">if</span> (::initgroups(user.c_str(), gid.<a class="code" href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>()) == -1 && errno != EPERM) {</div><div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to set supplementary groups"</span>);</div><div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  }</div><div class="line"><a name="l00335"></a><span class="lineno"> 335</span> </div><div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  <a class="code" href="classResult.html">Result<uid_t></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>  <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>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"Failed to getuid: "</span> +</div><div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  (uid.<a class="code" href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">isError</a>() ? uid.<a class="code" href="classResult.html#a521adf96f5c27d26d6b1d580aae8aaee">erro
r</a>() : <span class="stringliteral">"unknown user"</span>));</div><div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  } <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>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to setuid"</span>);</div><div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  }</div><div class="line"><a name="l00343"></a><span class="lineno"> 343</span> </div><div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <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> }</div><div class="line"><a name="l00346"></a><span class="lineno"> 346</span> </div><div class="line"><a name="l00347"></a><span class="lineno"> 347</span> } <span class="comment">// namespace os {</span></div><div class="line"><a name="l00348"></a><span class="lineno"> 348</span> </div><div class="line"><a name="l00349"></a><span class="lineno"> 349</span> <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< uid_t > uid(const std::string &path, const FollowSymlink follow=FollowSymlink::FOLLOW_SYMLINK)</div><div class="ttdef"><b>Definition:</b> stat.hpp:182</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< uid_t > uid(const std::string &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="classOption_html"><div class="ttname"><a href="classOption.html">Option< std::string ></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< Bytes > size(const std::string &path, const FollowSymlink follow=FollowSymlink::FOLLOW_SYMLINK)</div><div class="ttdef"><b>Definition:</b> stat.hpp:100</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< Bytes > size(const std::string &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< T > error(const std::string &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< std::string > user(Option< uid_t > uid=None())</div><div class="ttdef"><b>Definition:</b> su.hpp:277</div></div>
@@ -75,7 +75,7 @@
<div class="ttc" id="nothing_8hpp_html"><div class="ttname"><a href="nothing_8hpp.html">nothing.hpp</a></div></div>
<div class="ttc" id="namespaceos_html_a34d621fcc9ff30cfe4869b40644a3b2b"><div class="ttname"><a href="namespaceos.html#a34d621fcc9ff30cfe4869b40644a3b2b">os::setgid</a></div><div class="ttdeci">Try< Nothing > setgid(gid_t gid)</div><div class="ttdef"><b>Definition:</b> su.hpp:185</div></div>
<div class="ttc" id="structpasswd_html_aa6e0e62ee3cf5152f2697a0104f627c1"><div class="ttname"><a href="structpasswd.html#aa6e0e62ee3cf5152f2697a0104f627c1">passwd::pw_uid</a></div><div class="ttdeci">uid_t pw_uid</div><div class="ttdef"><b>Definition:</b> pwd.hpp:29</div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_afc544433253791fc5f87b8203c9b6e63"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">uid_t</a></div><div class="ttdeci">int uid_t</div><div class="ttdef"><b>Definition:</b> windows.hpp:189</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_afc544433253791fc5f87b8203c9b6e63"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#afc544433253791fc5f87b8203c9b6e63">uid_t</a></div><div class="ttdeci">int uid_t</div><div class="ttdef"><b>Definition:</b> windows.hpp:183</div></div>
<div class="ttc" id="namespaceos_html_acae67fc8bd809c609bf1ffb281d921c6"><div class="ttname"><a href="namespaceos.html#acae67fc8bd809c609bf1ffb281d921c6">os::su</a></div><div class="ttdeci">Try< Nothing > su(const std::string &user)</div><div class="ttdef"><b>Definition:</b> su.hpp:319</div></div>
<div class="ttc" id="classResult_html_aedf79f3b14dcda5791b84a64ada4d412"><div class="ttname"><a href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">Result::get</a></div><div class="ttdeci">const T & get() const </div><div class="ttdef"><b>Definition:</b> result.hpp:115</div></div>
<div class="ttc" id="option_8hpp_html"><div class="ttname"><a href="option_8hpp.html">option.hpp</a></div></div>
@@ -86,7 +86,7 @@
<div class="ttc" id="try_8hpp_html"><div class="ttname"><a href="try_8hpp.html">try.hpp</a></div></div>
<div class="ttc" id="classResult_html_a85eaa52037223d71092e65701c166562"><div class="ttname"><a href="classResult.html#a85eaa52037223d71092e65701c166562">Result::isSome</a></div><div class="ttdeci">bool isSome() const </div><div class="ttdef"><b>Definition:</b> result.hpp:111</div></div>
<div class="ttc" id="classResult_html_aeca16ad17d299ad885c9b46c83b12a3d"><div class="ttname"><a href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">Result::isError</a></div><div class="ttdeci">bool isError() const </div><div class="ttdef"><b>Definition:</b> result.hpp:113</div></div>
-<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a78ecefd3a9f3f0c110b9f6f038b690eb"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a></div><div class="ttdeci">int gid_t</div><div class="ttdef"><b>Definition:</b> windows.hpp:190</div></div>
+<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a78ecefd3a9f3f0c110b9f6f038b690eb"><div class="ttname"><a href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a78ecefd3a9f3f0c110b9f6f038b690eb">gid_t</a></div><div class="ttdeci">int gid_t</div><div class="ttdef"><b>Definition:</b> windows.hpp:184</div></div>
<div class="ttc" id="unreachable_8hpp_html"><div class="ttname"><a href="unreachable_8hpp.html">unreachable.hpp</a></div></div>
<div class="ttc" id="namespaceos_html_ae4b3b2f098e140e75c4bcc5dc15abf30"><div class="ttname"><a href="namespaceos.html#ae4b3b2f098e140e75c4bcc5dc15abf30">os::setuid</a></div><div class="ttdeci">Try< Nothing > setuid(uid_t uid)</div><div class="ttdef"><b>Definition:</b> su.hpp:108</div></div>
</div><!-- fragment --></div><!-- contents -->
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/e6085b1f/content/api/latest/c++/posix_2write_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/posix_2write_8hpp_source.html b/content/api/latest/c++/posix_2write_8hpp_source.html
index 77bd006..1af218a 100644
--- a/content/api/latest/c++/posix_2write_8hpp_source.html
+++ b/content/api/latest/c++/posix_2write_8hpp_source.html
@@ -53,7 +53,7 @@
</div><!--header-->
<div class="contents">
<a href="posix_2write_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> <span class="comment">// Licensed under the Apache License, Version 2.0 (the "License");</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <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> <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> <span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <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> <span class="comment">//<
/span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <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> <span class="comment">// distributed under the License is distributed on an "AS IS" BASIS,</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <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> <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> <span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> </div><div class
="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#ifndef __STOUT_OS_POSIX_WRITE_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#define __STOUT_OS_POSIX_WRITE_HPP__</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> </div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="preprocessor">#include <errno.h></span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#include <unistd.h></span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> </div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a
> {</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">// Compatibility function. On POSIX, this function is trivial, but on Windows,</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">// we have to check whether the file descriptor is a socket or a file to write</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">// to it.</span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <a class="code" href="namespaceos.html#aa0e3acff8992055da620cae8b455d93d">using ::write</a>;</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> } <span class="comment">// namespace os {</span></div><div cla
ss="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> </div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#endif // __STOUT_OS_POSIX_READ_HPP__</span></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="namespaceos_html_aa0e3acff8992055da620cae8b455d93d"><div class="ttname"><a href="namespaceos.html#aa0e3acff8992055da620cae8b455d93d">os::write</a></div><div class="ttdeci">Try< Nothing > write(const char *path, const std::string &message)</div><div class="ttdef"><b>Definition:</b> write.hpp:131</div></div>
+<div class="ttc" id="namespaceos_html_aa0e3acff8992055da620cae8b455d93d"><div class="ttname"><a href="namespaceos.html#aa0e3acff8992055da620cae8b455d93d">os::write</a></div><div class="ttdeci">Try< Nothing > write(const char *path, const std::string &message)</div><div class="ttdef"><b>Definition:</b> write.hpp:139</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>