http://git-wip-us.apache.org/repos/asf/mesos-site/blob/f7b524b3/content/api/latest/c++/posix_2os_8hpp_source.html ---------------------------------------------------------------------- diff --git a/content/api/latest/c++/posix_2os_8hpp_source.html b/content/api/latest/c++/posix_2os_8hpp_source.html index 0ac337b..fa675c9 100644 --- a/content/api/latest/c++/posix_2os_8hpp_source.html +++ b/content/api/latest/c++/posix_2os_8hpp_source.html @@ -119,464 +119,462 @@ <div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">#include <<a class="code" href="os_2os_8hpp.html">stout/os/os.hpp</a>></span></div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="preprocessor">#include <<a class="code" href="permissions_8hpp.html">stout/os/permissions.hpp</a>></span></div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2read_8hpp.html">stout/os/read.hpp</a>></span></div> -<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="preprocessor">#include <<a class="code" href="realpath_8hpp.html">stout/os/realpath.hpp</a>></span></div> -<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="preprocessor">#include <<a class="code" href="rename_8hpp.html">stout/os/rename.hpp</a>></span></div> -<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="preprocessor">#include <<a class="code" href="sendfile_8hpp.html">stout/os/sendfile.hpp</a>></span></div> -<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="preprocessor">#include <<a class="code" href="signals_8hpp.html">stout/os/signals.hpp</a>></span></div> -<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="preprocessor">#include <<a class="code" href="strerror_8hpp.html">stout/os/strerror.hpp</a>></span></div> -<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="preprocessor">#include <<a class="code" href="write_8hpp.html">stout/os/write.hpp</a>></span></div> -<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div> -<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="preprocessor">#ifdef __FreeBSD__</span></div> -<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="freebsd_8hpp.html">stout/os/freebsd.hpp</a>></span></div> -<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="preprocessor">#endif</span></div> -<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="preprocessor"></span><span class="preprocessor">#ifdef __linux__</span></div> -<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2linux_8hpp.html">stout/os/linux.hpp</a>></span></div> -<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="preprocessor">#endif // __linux__</span></div> -<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="open_8hpp.html">stout/os/open.hpp</a>></span></div> -<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="preprocessor">#ifdef __APPLE__</span></div> -<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="osx_8hpp.html">stout/os/osx.hpp</a>></span></div> -<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="preprocessor">#endif // __APPLE__</span></div> -<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="preprocessor"></span><span class="preprocessor">#ifdef __sun</span></div> -<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="sunos_8hpp.html">stout/os/sunos.hpp</a>></span></div> -<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="preprocessor">#endif // __sun</span></div> -<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="preprocessor"></span></div> -<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="preprocessor">#include <<a class="code" href="chown_8hpp.html">stout/os/posix/chown.hpp</a>></span></div> -<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2raw_2environment_8hpp.html">stout/os/raw/environment.hpp</a>></span></div> -<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> </div> -<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="preprocessor">#include <<a class="code" href="shell_8hpp.html">stout/os/shell.hpp</a>></span></div> -<div class="line"><a name="l00093"></a><span class="lineno"> 93</span> </div> -<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="keyword">namespace </span>os {</div> -<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> </div> -<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="comment">// Import `::gmtime_r` into `os::` namespace.</span></div> -<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <a class="code" href="namespaceos.html#a5e0295f0e3bae2bd29d86803f9293b5d">using ::gmtime_r</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> <span class="comment">// Import `::hstrerror` into `os::` namespace.</span></div> -<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <a class="code" href="namespaceos.html#a73c0258b355f6a38f3809bcd16a8f25a">using ::hstrerror</a>;</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> <span class="comment">// Import `::random` into `os::` namespace.</span></div> -<div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <a class="code" href="namespaceos.html#aede9f61dcb4b7d1f276302a7bce37446">using ::random</a>;</div> -<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> </div> -<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment">// Forward declarations.</span></div> -<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#a818327458964860a86fc8964e4795b4d">utime</a>(<span class="keyword">const</span> std::string&);</div> -<div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<Process></a>> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>();</div> +<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="preprocessor">#include <<a class="code" href="rename_8hpp.html">stout/os/rename.hpp</a>></span></div> +<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="preprocessor">#include <<a class="code" href="sendfile_8hpp.html">stout/os/sendfile.hpp</a>></span></div> +<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="preprocessor">#include <<a class="code" href="signals_8hpp.html">stout/os/signals.hpp</a>></span></div> +<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="preprocessor">#include <<a class="code" href="strerror_8hpp.html">stout/os/strerror.hpp</a>></span></div> +<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="preprocessor">#include <<a class="code" href="write_8hpp.html">stout/os/write.hpp</a>></span></div> +<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> </div> +<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="preprocessor">#ifdef __FreeBSD__</span></div> +<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="freebsd_8hpp.html">stout/os/freebsd.hpp</a>></span></div> +<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="preprocessor">#endif</span></div> +<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="preprocessor"></span><span class="preprocessor">#ifdef __linux__</span></div> +<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2linux_8hpp.html">stout/os/linux.hpp</a>></span></div> +<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="preprocessor">#endif // __linux__</span></div> +<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="open_8hpp.html">stout/os/open.hpp</a>></span></div> +<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="preprocessor">#ifdef __APPLE__</span></div> +<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="osx_8hpp.html">stout/os/osx.hpp</a>></span></div> +<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="preprocessor">#endif // __APPLE__</span></div> +<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="preprocessor"></span><span class="preprocessor">#ifdef __sun</span></div> +<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="sunos_8hpp.html">stout/os/sunos.hpp</a>></span></div> +<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="preprocessor">#endif // __sun</span></div> +<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="preprocessor"></span></div> +<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="preprocessor">#include <<a class="code" href="chown_8hpp.html">stout/os/posix/chown.hpp</a>></span></div> +<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="preprocessor">#include <<a class="code" href="3rdparty_2stout_2include_2stout_2os_2raw_2environment_8hpp.html">stout/os/raw/environment.hpp</a>></span></div> +<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> </div> +<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> <span class="preprocessor">#include <<a class="code" href="shell_8hpp.html">stout/os/shell.hpp</a>></span></div> +<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> </div> +<div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="keyword">namespace </span>os {</div> +<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> </div> +<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="comment">// Import `::gmtime_r` into `os::` namespace.</span></div> +<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <a class="code" href="namespaceos.html#a5e0295f0e3bae2bd29d86803f9293b5d">using ::gmtime_r</a>;</div> +<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> </div> +<div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment">// Import `::hstrerror` into `os::` namespace.</span></div> +<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <a class="code" href="namespaceos.html#a73c0258b355f6a38f3809bcd16a8f25a">using ::hstrerror</a>;</div> +<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div> +<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment">// Import `::random` into `os::` namespace.</span></div> +<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <a class="code" href="namespaceos.html#aede9f61dcb4b7d1f276302a7bce37446">using ::random</a>;</div> +<div class="line"><a name="l00103"></a><span class="lineno"> 103</span> </div> +<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment">// Forward declarations.</span></div> +<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#a818327458964860a86fc8964e4795b4d">utime</a>(<span class="keyword">const</span> std::string&);</div> +<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<Process></a>> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>();</div> +<div class="line"><a name="l00107"></a><span class="lineno"> 107</span> </div> <div class="line"><a name="l00108"></a><span class="lineno"> 108</span> </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="comment">// Suspends execution of the calling process until a child specified by `pid`</span></div> -<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment">// has changed state. Unlike the POSIX standard function `::waitpid`, this</span></div> -<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment">// function does not use -1 and 0 to signify errors and nonblocking return.</span></div> -<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="comment">// Instead, we return `Result<pid_t>`:</span></div> -<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment">// * In case of error, we return `Error` rather than -1. For example, we</span></div> -<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment">// would return an `Error` in case of `EINVAL`.</span></div> -<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment">// * In case of nonblocking return, we return `None` rather than 0. For</span></div> -<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment">// example, if we pass `WNOHANG` in the `options`, we would expect 0 to be</span></div> -<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">// returned in the case that children specified by `pid` exist, but have</span></div> -<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment">// not changed state yet. In this case we return `None` instead.</span></div> -<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment">//</span></div> -<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment">// NOTE: There are important differences between the POSIX and Windows</span></div> -<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment">// implementations of this function:</span></div> -<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment">// * On POSIX, `pid_t` is a signed number, but on Windows, PIDs are `DWORD`,</span></div> -<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment">// which is `unsigned long`. Thus, if we use `DWORD` to represent the `pid`</span></div> -<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment">// argument, we would not be able to pass -1 as the `pid`.</span></div> -<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment">// * Since it is important to be able to detect -1 has been passed to</span></div> -<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment">// `os::waitpid`, as a matter of practicality, we choose to:</span></div> -<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="comment">// (1) Use `long` to represent the `pid` argument.</span></div> -<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment">// (2) Disable using any value <= 0 for `pid` on Windows.</span></div> -<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment">// * This decision is pragmatic. The reasoning is:</span></div> -<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment">// (1) The Windows code paths call `os::waitpid` in only a handful of</span></div> -<div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment">// places, and in none of these conditions do we need `-1` as a value.</span></div> -<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">// (2) Since PIDs virtually never take on values outside the range of</span></div> -<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment">// vanilla signed `long` it is likely that an accidental conversion</span></div> -<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment">// will never happen.</span></div> -<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment">// (3) Even though it is not formalized in the C specification, the</span></div> -<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">// implementation of `long` on the vast majority of production servers</span></div> -<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="comment">// is 2's complement, so we expect that when we accidentally do</span></div> -<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="comment">// implicitly convert from `unsigned long` to `long`, we will "wrap</span></div> -<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="comment">// around" to negative values. And since we've disabled the negative</span></div> -<div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">// `pid` in the Windows implementation, we should error out.</span></div> -<div class="line"><a name="l00142"></a><span class="lineno"><a class="line" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba"> 142</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<pid_t></a> <a class="code" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba">waitpid</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid, <span class="keywordtype">int</span>* <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>, <span class="keywordtype">int</span> options)</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="keyword">const</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> child_pid = <a class="code" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba">::waitpid</a>(pid, status, options);</div> -<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div> -<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="keywordflow">if</span> (child_pid == 0) {</div> -<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div> -<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (child_pid < 0) {</div> -<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"os::waitpid: Call to `waitpid` failed"</span>);</div> -<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  } <span class="keywordflow">else</span> {</div> -<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="keywordflow">return</span> child_pid;</div> -<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  }</div> -<div class="line"><a name="l00153"></a><span class="lineno"> 153</span> }</div> +<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment">// Suspends execution of the calling process until a child specified by `pid`</span></div> +<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment">// has changed state. Unlike the POSIX standard function `::waitpid`, this</span></div> +<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment">// function does not use -1 and 0 to signify errors and nonblocking return.</span></div> +<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment">// Instead, we return `Result<pid_t>`:</span></div> +<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="comment">// * In case of error, we return `Error` rather than -1. For example, we</span></div> +<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment">// would return an `Error` in case of `EINVAL`.</span></div> +<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment">// * In case of nonblocking return, we return `None` rather than 0. For</span></div> +<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment">// example, if we pass `WNOHANG` in the `options`, we would expect 0 to be</span></div> +<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment">// returned in the case that children specified by `pid` exist, but have</span></div> +<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">// not changed state yet. In this case we return `None` instead.</span></div> +<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment">//</span></div> +<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment">// NOTE: There are important differences between the POSIX and Windows</span></div> +<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment">// implementations of this function:</span></div> +<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment">// * On POSIX, `pid_t` is a signed number, but on Windows, PIDs are `DWORD`,</span></div> +<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment">// which is `unsigned long`. Thus, if we use `DWORD` to represent the `pid`</span></div> +<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment">// argument, we would not be able to pass -1 as the `pid`.</span></div> +<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment">// * Since it is important to be able to detect -1 has been passed to</span></div> +<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment">// `os::waitpid`, as a matter of practicality, we choose to:</span></div> +<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment">// (1) Use `long` to represent the `pid` argument.</span></div> +<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="comment">// (2) Disable using any value <= 0 for `pid` on Windows.</span></div> +<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment">// * This decision is pragmatic. The reasoning is:</span></div> +<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment">// (1) The Windows code paths call `os::waitpid` in only a handful of</span></div> +<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment">// places, and in none of these conditions do we need `-1` as a value.</span></div> +<div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment">// (2) Since PIDs virtually never take on values outside the range of</span></div> +<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">// vanilla signed `long` it is likely that an accidental conversion</span></div> +<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment">// will never happen.</span></div> +<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment">// (3) Even though it is not formalized in the C specification, the</span></div> +<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment">// implementation of `long` on the vast majority of production servers</span></div> +<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">// is 2's complement, so we expect that when we accidentally do</span></div> +<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="comment">// implicitly convert from `unsigned long` to `long`, we will "wrap</span></div> +<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="comment">// around" to negative values. And since we've disabled the negative</span></div> +<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="comment">// `pid` in the Windows implementation, we should error out.</span></div> +<div class="line"><a name="l00141"></a><span class="lineno"><a class="line" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba"> 141</a></span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<pid_t></a> <a class="code" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba">waitpid</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid, <span class="keywordtype">int</span>* <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a>, <span class="keywordtype">int</span> options)</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>  <span class="keyword">const</span> <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> child_pid = <a class="code" href="namespaceos.html#a48c86262928f59c5c54d0cb0012e2aba">::waitpid</a>(pid, status, options);</div> +<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div> +<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <span class="keywordflow">if</span> (child_pid == 0) {</div> +<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="keywordflow">return</span> <a class="code" href="structNone.html">None</a>();</div> +<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (child_pid < 0) {</div> +<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"os::waitpid: Call to `waitpid` failed"</span>);</div> +<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  } <span class="keywordflow">else</span> {</div> +<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  <span class="keywordflow">return</span> child_pid;</div> +<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  }</div> +<div class="line"><a name="l00152"></a><span class="lineno"> 152</span> }</div> +<div class="line"><a name="l00153"></a><span class="lineno"> 153</span> </div> <div class="line"><a name="l00154"></a><span class="lineno"> 154</span> </div> -<div class="line"><a name="l00155"></a><span class="lineno"> 155</span> </div> -<div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="comment">// Sets the value associated with the specified key in the set of</span></div> -<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="comment">// environment variables.</span></div> -<div class="line"><a name="l00158"></a><span class="lineno"><a class="line" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d"> 158</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d">setenv</a>(<span class="keyword">const</span> std::string& key,</div> -<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keyword">const</span> std::string& value,</div> -<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="keywordtype">bool</span> overwrite = <span class="keyword">true</span>)</div> -<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> {</div> -<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <a class="code" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d">::setenv</a>(key.c_str(), value.c_str(), overwrite ? 1 : 0);</div> -<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> }</div> +<div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="comment">// Sets the value associated with the specified key in the set of</span></div> +<div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="comment">// environment variables.</span></div> +<div class="line"><a name="l00157"></a><span class="lineno"><a class="line" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d"> 157</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d">setenv</a>(<span class="keyword">const</span> std::string& key,</div> +<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <span class="keyword">const</span> std::string& value,</div> +<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keywordtype">bool</span> overwrite = <span class="keyword">true</span>)</div> +<div class="line"><a name="l00160"></a><span class="lineno"> 160</span> {</div> +<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <a class="code" href="namespaceos.html#ac0f608e2a32764327e38c53d0d51527d">::setenv</a>(key.c_str(), value.c_str(), overwrite ? 1 : 0);</div> +<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> }</div> +<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> </div> <div class="line"><a name="l00164"></a><span class="lineno"> 164</span> </div> -<div class="line"><a name="l00165"></a><span class="lineno"> 165</span> </div> -<div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="comment">// Unsets the value associated with the specified key in the set of</span></div> -<div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <span class="comment">// environment variables.</span></div> -<div class="line"><a name="l00168"></a><span class="lineno"><a class="line" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5"> 168</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5">unsetenv</a>(<span class="keyword">const</span> std::string& key)</div> -<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> {</div> -<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <a class="code" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5">::unsetenv</a>(key.c_str());</div> -<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> }</div> +<div class="line"><a name="l00165"></a><span class="lineno"> 165</span> <span class="comment">// Unsets the value associated with the specified key in the set of</span></div> +<div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="comment">// environment variables.</span></div> +<div class="line"><a name="l00167"></a><span class="lineno"><a class="line" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5"> 167</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5">unsetenv</a>(<span class="keyword">const</span> std::string& key)</div> +<div class="line"><a name="l00168"></a><span class="lineno"> 168</span> {</div> +<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <a class="code" href="namespaceos.html#a7471e14f4cbd7e23b5daa21e556f4eb5">::unsetenv</a>(key.c_str());</div> +<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> }</div> +<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> </div> <div class="line"><a name="l00172"></a><span class="lineno"> 172</span> </div> -<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> </div> -<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="comment">// This function is a portable version of execvpe ('p' means searching</span></div> -<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment">// executable from PATH and 'e' means setting environments). We add</span></div> -<div class="line"><a name="l00176"></a><span class="lineno"> 176</span> <span class="comment">// this function because it is not available on all systems.</span></div> -<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment">//</span></div> -<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">// NOTE: This function is not thread safe. It is supposed to be used</span></div> -<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="comment">// only after fork (when there is only one thread). This function is</span></div> -<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment">// async signal safe.</span></div> -<div class="line"><a name="l00181"></a><span class="lineno"><a class="line" href="namespaceos.html#a4cfd127336013491258ee10a8985e226"> 181</a></span> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos.html#aebc3586b2be0d2b9093ccfbf25dfcde8">execvpe</a>(<span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="namespacemesos_1_1uri.html#a0a3b30c1eb427c4053aaef120b1f453c">file</a>, <span class="keywordtype">char</span>** argv, <span class="keywordtype">char</span>** envp)</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>  <span class="keywordtype">char</span>** saved = <a class="code" href="namespaceos_1_1raw.html#aad2bd3acb3ca09c75a1a1db58075f9f4">os::raw::environment</a>();</div> -<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> </div> -<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  *<a class="code" href="namespaceos_1_1raw.html#a255f9fd6996adf47571d24586f9ba8fe">os::raw::environmentp</a>() = envp;</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="keywordtype">int</span> result = <a class="code" href="namespaceos.html#a0b80877b34088be8d5ba3eb9b0567ed7">execvp</a>(file, argv);</div> -<div class="line"><a name="l00188"></a><span class="lineno"> 188</span> </div> -<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  *<a class="code" href="namespaceos_1_1raw.html#a255f9fd6996adf47571d24586f9ba8fe">os::raw::environmentp</a>() = saved;</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> result;</div> -<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> }</div> +<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="comment">// This function is a portable version of execvpe ('p' means searching</span></div> +<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="comment">// executable from PATH and 'e' means setting environments). We add</span></div> +<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment">// this function because it is not available on all systems.</span></div> +<div class="line"><a name="l00176"></a><span class="lineno"> 176</span> <span class="comment">//</span></div> +<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment">// NOTE: This function is not thread safe. It is supposed to be used</span></div> +<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">// only after fork (when there is only one thread). This function is</span></div> +<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="comment">// async signal safe.</span></div> +<div class="line"><a name="l00180"></a><span class="lineno"><a class="line" href="namespaceos.html#a4cfd127336013491258ee10a8985e226"> 180</a></span> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="namespaceos.html#aebc3586b2be0d2b9093ccfbf25dfcde8">execvpe</a>(<span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="namespacemesos_1_1uri.html#a0a3b30c1eb427c4053aaef120b1f453c">file</a>, <span class="keywordtype">char</span>** argv, <span class="keywordtype">char</span>** envp)</div> +<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> {</div> +<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keywordtype">char</span>** saved = <a class="code" href="namespaceos_1_1raw.html#aad2bd3acb3ca09c75a1a1db58075f9f4">os::raw::environment</a>();</div> +<div class="line"><a name="l00183"></a><span class="lineno"> 183</span> </div> +<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  *<a class="code" href="namespaceos_1_1raw.html#a255f9fd6996adf47571d24586f9ba8fe">os::raw::environmentp</a>() = envp;</div> +<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> </div> +<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keywordtype">int</span> result = <a class="code" href="namespaceos.html#a0b80877b34088be8d5ba3eb9b0567ed7">execvp</a>(file, argv);</div> +<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> </div> +<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  *<a class="code" href="namespaceos_1_1raw.html#a255f9fd6996adf47571d24586f9ba8fe">os::raw::environmentp</a>() = saved;</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>  <span class="keywordflow">return</span> result;</div> +<div class="line"><a name="l00191"></a><span class="lineno"> 191</span> }</div> +<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> </div> <div class="line"><a name="l00193"></a><span class="lineno"> 193</span> </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#ab9f08ced036cc5156a11a86090768bb5"> 195</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#ab9f08ced036cc5156a11a86090768bb5">chmod</a>(<span class="keyword">const</span> std::string& path, <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</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="keywordflow">if</span> (::<a class="code" href="namespaceos.html#ab9f08ced036cc5156a11a86090768bb5">chmod</a>(path.c_str(), <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>) < 0) {</div> -<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> -<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  }</div> -<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> </div> -<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div> -<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> }</div> +<div class="line"><a name="l00194"></a><span class="lineno"><a class="line" href="namespaceos.html#ab9f08ced036cc5156a11a86090768bb5"> 194</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#ab9f08ced036cc5156a11a86090768bb5">chmod</a>(<span class="keyword">const</span> std::string& path, <span class="keywordtype">int</span> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>)</div> +<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> {</div> +<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#ab9f08ced036cc5156a11a86090768bb5">chmod</a>(path.c_str(), <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>) < 0) {</div> +<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> +<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  }</div> +<div class="line"><a name="l00199"></a><span class="lineno"> 199</span> </div> +<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div> +<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> }</div> +<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> </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"><a class="line" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd"> 205</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd">mknod</a>(</div> -<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keyword">const</span> std::string& path,</div> -<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>,</div> -<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  dev_t <a class="code" href="namespaceos_1_1stat.html#a083c9ff4aefeba1a75a27e6a6d6e2a71">dev</a>)</div> -<div class="line"><a name="l00209"></a><span class="lineno"> 209</span> {</div> -<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd">mknod</a>(path.c_str(), <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>, <a class="code" href="namespaceos_1_1stat.html#a083c9ff4aefeba1a75a27e6a6d6e2a71">dev</a>) < 0) {</div> -<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> -<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  }</div> -<div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div> -<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div> -<div class="line"><a name="l00215"></a><span class="lineno"> 215</span> }</div> +<div class="line"><a name="l00204"></a><span class="lineno"><a class="line" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd"> 204</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd">mknod</a>(</div> +<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keyword">const</span> std::string& path,</div> +<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a8a35dd1207a16dfa8b1d4163176d828c">mode_t</a> <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>,</div> +<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  dev_t <a class="code" href="namespaceos_1_1stat.html#a083c9ff4aefeba1a75a27e6a6d6e2a71">dev</a>)</div> +<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> {</div> +<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#accb0757a8d9eca48dd31c4c433d17cfd">mknod</a>(path.c_str(), <a class="code" href="namespaceos_1_1stat.html#afc51654ad486693167c300612bf8ebfa">mode</a>, <a class="code" href="namespaceos_1_1stat.html#a083c9ff4aefeba1a75a27e6a6d6e2a71">dev</a>) < 0) {</div> +<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> +<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  }</div> +<div class="line"><a name="l00212"></a><span class="lineno"> 212</span> </div> +<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div> +<div class="line"><a name="l00214"></a><span class="lineno"> 214</span> }</div> +<div class="line"><a name="l00215"></a><span class="lineno"> 215</span> </div> <div class="line"><a name="l00216"></a><span class="lineno"> 216</span> </div> <div class="line"><a name="l00217"></a><span class="lineno"> 217</span> </div> <div class="line"><a name="l00218"></a><span class="lineno"> 218</span> </div> -<div class="line"><a name="l00219"></a><span class="lineno"> 219</span> </div> -<div class="line"><a name="l00220"></a><span class="lineno"> 220</span> <span class="comment">// Suspends execution for the given duration.</span></div> -<div class="line"><a name="l00221"></a><span class="lineno"><a class="line" href="namespaceos.html#ab2b826c68a25af9e9ef47c570c36e137"> 221</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#ab2b826c68a25af9e9ef47c570c36e137">sleep</a>(<span class="keyword">const</span> <a class="code" href="classDuration.html">Duration</a>& duration)</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>  timespec remaining;</div> -<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  remaining.tv_sec = <span class="keyword">static_cast<</span><span class="keywordtype">long</span><span class="keyword">></span>(duration.<a class="code" href="classDuration.html#a31ebb8d92dc93914cb830d70753d802b">secs</a>());</div> -<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  remaining.tv_nsec =</div> -<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <span class="keyword">static_cast<</span><span class="keywordtype">long</span><span class="keyword">></span>((duration - <a class="code" href="classSeconds.html">Seconds</a>(remaining.tv_sec)).ns());</div> -<div class="line"><a name="l00227"></a><span class="lineno"> 227</span> </div> -<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keywordflow">while</span> (nanosleep(&remaining, &remaining) == -1) {</div> -<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keywordflow">if</span> (errno == EINTR) {</div> -<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <span class="keywordflow">continue</span>;</div> -<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  } <span class="keywordflow">else</span> {</div> -<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> -<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  }</div> -<div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  }</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="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div> -<div class="line"><a name="l00237"></a><span class="lineno"> 237</span> }</div> +<div class="line"><a name="l00219"></a><span class="lineno"> 219</span> <span class="comment">// Suspends execution for the given duration.</span></div> +<div class="line"><a name="l00220"></a><span class="lineno"><a class="line" href="namespaceos.html#ab2b826c68a25af9e9ef47c570c36e137"> 220</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#ab2b826c68a25af9e9ef47c570c36e137">sleep</a>(<span class="keyword">const</span> <a class="code" href="classDuration.html">Duration</a>& duration)</div> +<div class="line"><a name="l00221"></a><span class="lineno"> 221</span> {</div> +<div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  timespec remaining;</div> +<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  remaining.tv_sec = <span class="keyword">static_cast<</span><span class="keywordtype">long</span><span class="keyword">></span>(duration.<a class="code" href="classDuration.html#a31ebb8d92dc93914cb830d70753d802b">secs</a>());</div> +<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  remaining.tv_nsec =</div> +<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="keyword">static_cast<</span><span class="keywordtype">long</span><span class="keyword">></span>((duration - <a class="code" href="classSeconds.html">Seconds</a>(remaining.tv_sec)).ns());</div> +<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> </div> +<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <span class="keywordflow">while</span> (nanosleep(&remaining, &remaining) == -1) {</div> +<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keywordflow">if</span> (errno == EINTR) {</div> +<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keywordflow">continue</span>;</div> +<div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  } <span class="keywordflow">else</span> {</div> +<div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> +<div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  }</div> +<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  }</div> +<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> </div> +<div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div> +<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> }</div> +<div class="line"><a name="l00237"></a><span class="lineno"> 237</span> </div> <div class="line"><a name="l00238"></a><span class="lineno"> 238</span> </div> -<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> </div> -<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment">// Returns the list of files that match the given (shell) pattern.</span></div> -<div class="line"><a name="l00241"></a><span class="lineno"><a class="line" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422"> 241</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<std::string></a>> <a class="code" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422">glob</a>(<span class="keyword">const</span> std::string& pattern)</div> -<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> {</div> -<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  glob_t g;</div> -<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <span class="keywordtype">int</span> <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a> = <a class="code" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422">::glob</a>(pattern.c_str(), GLOB_NOSORT, <span class="keyword">nullptr</span>, &g);</div> -<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> </div> -<div class="line"><a name="l00246"></a><span class="lineno"> 246</span>  std::list<std::string> result;</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> (status != 0) {</div> -<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  <span class="keywordflow">if</span> (status == GLOB_NOMATCH) {</div> -<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  <span class="keywordflow">return</span> result; <span class="comment">// Empty list.</span></div> -<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  } <span class="keywordflow">else</span> {</div> -<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> -<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  }</div> -<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  }</div> -<div class="line"><a name="l00255"></a><span class="lineno"> 255</span> </div> -<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < g.gl_pathc; ++i) {</div> -<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  result.push_back(g.gl_pathv[i]);</div> -<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  }</div> -<div class="line"><a name="l00259"></a><span class="lineno"> 259</span> </div> -<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  globfree(&g); <span class="comment">// Best-effort free of dynamically allocated memory.</span></div> -<div class="line"><a name="l00261"></a><span class="lineno"> 261</span> </div> -<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <span class="keywordflow">return</span> result;</div> -<div class="line"><a name="l00263"></a><span class="lineno"> 263</span> }</div> +<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="comment">// Returns the list of files that match the given (shell) pattern.</span></div> +<div class="line"><a name="l00240"></a><span class="lineno"><a class="line" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422"> 240</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<std::string></a>> <a class="code" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422">glob</a>(<span class="keyword">const</span> std::string& pattern)</div> +<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> {</div> +<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  glob_t g;</div> +<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  <span class="keywordtype">int</span> <a class="code" href="namespaceproc.html#a34396c6140a28f583dc13fee3c3c35d4">status</a> = <a class="code" href="namespaceos.html#a781ae694650dd3c6addab2a383a8c422">::glob</a>(pattern.c_str(), GLOB_NOSORT, <span class="keyword">nullptr</span>, &g);</div> +<div class="line"><a name="l00244"></a><span class="lineno"> 244</span> </div> +<div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  std::list<std::string> result;</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>  <span class="keywordflow">if</span> (status != 0) {</div> +<div class="line"><a name="l00248"></a><span class="lineno"> 248</span>  <span class="keywordflow">if</span> (status == GLOB_NOMATCH) {</div> +<div class="line"><a name="l00249"></a><span class="lineno"> 249</span>  <span class="keywordflow">return</span> result; <span class="comment">// Empty list.</span></div> +<div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  } <span class="keywordflow">else</span> {</div> +<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> +<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  }</div> +<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  }</div> +<div class="line"><a name="l00254"></a><span class="lineno"> 254</span> </div> +<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < g.gl_pathc; ++i) {</div> +<div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  result.push_back(g.gl_pathv[i]);</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> </div> +<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  globfree(&g); <span class="comment">// Best-effort free of dynamically allocated memory.</span></div> +<div class="line"><a name="l00260"></a><span class="lineno"> 260</span> </div> +<div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  <span class="keywordflow">return</span> result;</div> +<div class="line"><a name="l00262"></a><span class="lineno"> 262</span> }</div> +<div class="line"><a name="l00263"></a><span class="lineno"> 263</span> </div> <div class="line"><a name="l00264"></a><span class="lineno"> 264</span> </div> -<div class="line"><a name="l00265"></a><span class="lineno"> 265</span> </div> -<div class="line"><a name="l00266"></a><span class="lineno"> 266</span> <span class="comment">// Returns the total number of cpus (cores).</span></div> -<div class="line"><a name="l00267"></a><span class="lineno"><a class="line" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd"> 267</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<long></a> <a class="code" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</a>()</div> -<div class="line"><a name="l00268"></a><span class="lineno"> 268</span> {</div> -<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <span class="keywordtype">long</span> <a class="code" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</a> = sysconf(_SC_NPROCESSORS_ONLN);</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="keywordflow">if</span> (cpus < 0) {</div> -<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> -<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  }</div> -<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</a>;</div> -<div class="line"><a name="l00275"></a><span class="lineno"> 275</span> }</div> +<div class="line"><a name="l00265"></a><span class="lineno"> 265</span> <span class="comment">// Returns the total number of cpus (cores).</span></div> +<div class="line"><a name="l00266"></a><span class="lineno"><a class="line" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd"> 266</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<long></a> <a class="code" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</a>()</div> +<div class="line"><a name="l00267"></a><span class="lineno"> 267</span> {</div> +<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  <span class="keywordtype">long</span> <a class="code" href="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</a> = sysconf(_SC_NPROCESSORS_ONLN);</div> +<div class="line"><a name="l00269"></a><span class="lineno"> 269</span> </div> +<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <span class="keywordflow">if</span> (cpus < 0) {</div> +<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</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="namespaceos.html#afd08813156fea899c86b340d9767a8cd">cpus</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"> 277</span> </div> -<div class="line"><a name="l00278"></a><span class="lineno"> 278</span> <span class="comment">// Returns load struct with average system loads for the last</span></div> -<div class="line"><a name="l00279"></a><span class="lineno"> 279</span> <span class="comment">// 1, 5 and 15 minutes respectively.</span></div> -<div class="line"><a name="l00280"></a><span class="lineno"> 280</span> <span class="comment">// Load values should be interpreted as usual average loads from</span></div> -<div class="line"><a name="l00281"></a><span class="lineno"> 281</span> <span class="comment">// uptime(1).</span></div> -<div class="line"><a name="l00282"></a><span class="lineno"><a class="line" href="namespaceos.html#ad932e3876b339c61b03abc575ad3943b"> 282</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Load></a> <a class="code" href="namespaceos.html#ad932e3876b339c61b03abc575ad3943b">loadavg</a>()</div> -<div class="line"><a name="l00283"></a><span class="lineno"> 283</span> {</div> -<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <span class="keywordtype">double</span> loadArray[3];</div> -<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="keywordflow">if</span> (getloadavg(loadArray, 3) == -1) {</div> -<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to determine system load averages"</span>);</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>  <a class="code" href="structos_1_1Load.html">Load</a> load;</div> -<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  load.<a class="code" href="structos_1_1Load.html#ac65d8819bbf8201cfa6975d853061e93">one</a> = loadArray[0];</div> -<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  load.<a class="code" href="structos_1_1Load.html#acff27912cf063f465aaf72fbda6ad3a7">five</a> = loadArray[1];</div> -<div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  load.<a class="code" href="structos_1_1Load.html#ac4a959c47204e8cd9e67930ac6b9bb63">fifteen</a> = loadArray[2];</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">return</span> load;</div> -<div class="line"><a name="l00295"></a><span class="lineno"> 295</span> }</div> +<div class="line"><a name="l00277"></a><span class="lineno"> 277</span> <span class="comment">// Returns load struct with average system loads for the last</span></div> +<div class="line"><a name="l00278"></a><span class="lineno"> 278</span> <span class="comment">// 1, 5 and 15 minutes respectively.</span></div> +<div class="line"><a name="l00279"></a><span class="lineno"> 279</span> <span class="comment">// Load values should be interpreted as usual average loads from</span></div> +<div class="line"><a name="l00280"></a><span class="lineno"> 280</span> <span class="comment">// uptime(1).</span></div> +<div class="line"><a name="l00281"></a><span class="lineno"><a class="line" href="namespaceos.html#ad932e3876b339c61b03abc575ad3943b"> 281</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<Load></a> <a class="code" href="namespaceos.html#ad932e3876b339c61b03abc575ad3943b">loadavg</a>()</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">double</span> loadArray[3];</div> +<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <span class="keywordflow">if</span> (getloadavg(loadArray, 3) == -1) {</div> +<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(<span class="stringliteral">"Failed to determine system load averages"</span>);</div> +<div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  }</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>  <a class="code" href="structos_1_1Load.html">Load</a> load;</div> +<div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  load.<a class="code" href="structos_1_1Load.html#ac65d8819bbf8201cfa6975d853061e93">one</a> = loadArray[0];</div> +<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  load.<a class="code" href="structos_1_1Load.html#acff27912cf063f465aaf72fbda6ad3a7">five</a> = loadArray[1];</div> +<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  load.<a class="code" href="structos_1_1Load.html#ac4a959c47204e8cd9e67930ac6b9bb63">fifteen</a> = loadArray[2];</div> +<div class="line"><a name="l00292"></a><span class="lineno"> 292</span> </div> +<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="keywordflow">return</span> load;</div> +<div class="line"><a name="l00294"></a><span class="lineno"> 294</span> }</div> +<div class="line"><a name="l00295"></a><span class="lineno"> 295</span> </div> <div class="line"><a name="l00296"></a><span class="lineno"> 296</span> </div> -<div class="line"><a name="l00297"></a><span class="lineno"> 297</span> </div> -<div class="line"><a name="l00298"></a><span class="lineno"> 298</span> <span class="comment">// Return the system information.</span></div> -<div class="line"><a name="l00299"></a><span class="lineno"><a class="line" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919"> 299</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<UTSInfo></a> <a class="code" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919">uname</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>  <span class="keyword">struct </span>utsname name;</div> -<div class="line"><a name="l00302"></a><span class="lineno"> 302</span> </div> -<div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919">uname</a>(&name) < 0) {</div> -<div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> -<div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  }</div> -<div class="line"><a name="l00306"></a><span class="lineno"> 306</span> </div> -<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  <a class="code" href="structos_1_1UTSInfo.html">UTSInfo</a> info;</div> -<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a6d960255088be07cac7157b7cbe94cbf">sysname</a> = name.sysname;</div> -<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a03dd23e9031a68b633dc6e405e32bab0">nodename</a> = name.nodename;</div> -<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  info.<a class="code" href="structos_1_1UTSInfo.html#aea5e6121d79c970b5abe84d9e2736663">release</a> = name.release;</div> -<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a0abdea1c2c12389c3413c006a186b0a4">version</a> = name.version;</div> -<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a493fadfa45429ab755d01d02d2f8be17">machine</a> = name.machine;</div> -<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  <span class="keywordflow">return</span> info;</div> -<div class="line"><a name="l00314"></a><span class="lineno"> 314</span> }</div> +<div class="line"><a name="l00297"></a><span class="lineno"> 297</span> <span class="comment">// Return the system information.</span></div> +<div class="line"><a name="l00298"></a><span class="lineno"><a class="line" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919"> 298</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<UTSInfo></a> <a class="code" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919">uname</a>()</div> +<div class="line"><a name="l00299"></a><span class="lineno"> 299</span> {</div> +<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <span class="keyword">struct </span>utsname name;</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>  <span class="keywordflow">if</span> (::<a class="code" href="namespaceos.html#afc96a896b632cb0942b317a1f8543919">uname</a>(&name) < 0) {</div> +<div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>();</div> +<div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  }</div> +<div class="line"><a name="l00305"></a><span class="lineno"> 305</span> </div> +<div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  <a class="code" href="structos_1_1UTSInfo.html">UTSInfo</a> info;</div> +<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a6d960255088be07cac7157b7cbe94cbf">sysname</a> = name.sysname;</div> +<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a03dd23e9031a68b633dc6e405e32bab0">nodename</a> = name.nodename;</div> +<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  info.<a class="code" href="structos_1_1UTSInfo.html#aea5e6121d79c970b5abe84d9e2736663">release</a> = name.release;</div> +<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a0abdea1c2c12389c3413c006a186b0a4">version</a> = name.version;</div> +<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  info.<a class="code" href="structos_1_1UTSInfo.html#a493fadfa45429ab755d01d02d2f8be17">machine</a> = name.machine;</div> +<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  <span class="keywordflow">return</span> info;</div> +<div class="line"><a name="l00313"></a><span class="lineno"> 313</span> }</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> <span class="comment">// Overload of os::pids for filtering by groups and sessions.</span></div> -<div class="line"><a name="l00318"></a><span class="lineno"> 318</span> <span class="comment">// A group / session id of 0 will fitler on the group / session ID</span></div> -<div class="line"><a name="l00319"></a><span class="lineno"> 319</span> <span class="comment">// of the calling process.</span></div> -<div class="line"><a name="l00320"></a><span class="lineno"><a class="line" href="namespaceos.html#abdecf7ea8278e2d8b2110ecd2e8ca0ec"> 320</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::set<pid_t></a>> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">pids</a>(<a class="code" href="classOption.html">Option<pid_t></a> <a class="code" href="structgroup.html">group</a>, <a class="code" href="classOption.html">Option<pid_t></a> session)</div> -<div class="line"><a name="l00321"></a><span class="lineno"> 321</span> {</div> -<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  <span class="keywordflow">if</span> (group.<a class="code" href="classOption.html#a06eab791122ebc1f8af4ad310e5e7d7e">isNone</a>() && session.<a class="code" href="classOption.html#a06eab791122ebc1f8af4ad310e5e7d7e">isNone</a>()) {</div> -<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">os::pids</a>();</div> -<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (group.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && group.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() < 0) {</div> -<div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"Invalid group"</span>);</div> -<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (session.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && session.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() < 0) {</div> -<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(<span class="stringliteral">"Invalid session"</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> </div> -<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  <span class="keyword">const</span> <a class="code" href="classTry.html">Try<std::list<Process></a>> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a> = <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">os::processes</a>();</div> -<div class="line"><a name="l00331"></a><span class="lineno"> 331</span> </div> -<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <span class="keywordflow">if</span> (processes.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div> -<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(processes.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</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>  <span class="comment">// Obtain the calling process group / session ID when 0 is provided.</span></div> -<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="keywordflow">if</span> (group.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && group.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == 0) {</div> -<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  group = getpgid(0);</div> -<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  }</div> -<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  <span class="keywordflow">if</span> (session.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && session.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == 0) {</div> -<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  session = getsid(0);</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>  std::set<pid_t> result;</div> -<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>, processes.<a class="code" href="classTry.html#a7be0768038e0628632492edf6cc1515a">get</a>()) {</div> -<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  <span class="comment">// Group AND Session (intersection).</span></div> -<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  <span class="keywordflow">if</span> (group.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && session.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>()) {</div> -<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  <span class="keywordflow">if</span> (group.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == process.<a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</a> &&</div> -<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() &&</div> -<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  session.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>()) {</div> -<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  result.insert(process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div> -<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  }</div> -<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (group.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && group.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == process.<a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</a>) {</div> -<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  result.insert(process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div> -<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (session.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && process.<a class="code" h
<TRUNCATED>
