You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by gi...@apache.org on 2018/05/18 09:30:17 UTC
[26/48] mesos-site git commit: Updated the website built from mesos
SHA: c020a13.
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/d7774475/content/api/latest/c++/posix_2ftruncate_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/posix_2ftruncate_8hpp_source.html b/content/api/latest/c++/posix_2ftruncate_8hpp_source.html
index 6d39bf6..bbaf5b8 100644
--- a/content/api/latest/c++/posix_2ftruncate_8hpp_source.html
+++ b/content/api/latest/c++/posix_2ftruncate_8hpp_source.html
@@ -54,7 +54,7 @@
<div class="contents">
<a href="posix_2ftruncate_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 c
lass="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#ifndef __STOUT_OS_POSIX_FTRUNCATE_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#define __STOUT_OS_POSIX_FTRUNCATE_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 <sys/types.h></span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> </div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#include <<a class="code" href="error_8hpp.html">stout/error.hpp</a>></span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>
></span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <<a class="code" href="stringify_8hpp.html">stout/stringify.hpp</a>></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> </div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"><a class="line" href="namespaceos.html#af41b169df092f5afbd41de13c450e959"> 26</a></span> <span class
="keyword">inline</span> <a class="code" href="classTry.html">Try<Nothing></a> <a class="code" href="namespaceos.html#af41b169df092f5afbd41de13c450e959">ftruncate</a>(<span class="keywordtype">int</span> fd, off_t length)</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="keywordflow">if</span> (::<a class="code" href="namespaceos.html#af41b169df092f5afbd41de13c450e959">ftruncate</a>(fd, length) != 0) {</div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  <span class="keywordflow">return</span> <a class="code" href="classErrnoError.html">ErrnoError</a>(</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  <span class="stringliteral">"Failed to truncate file at file descriptor '"</span> + <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stri
ngify</a>(fd) + <span class="stringliteral">"' to "</span> +</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <a class="code" href="namespacens.html#a28116b46e6543597a11733424cd1aa20">stringify</a>(length) + <span class="stringliteral">" bytes."</span>);</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  }</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  <span class="keywordflow">return</span> <a class="code" href="structNothing.html">Nothing</a>();</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> }</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> } <span class="comment">// namespace os {</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> <span class="preprocessor">#endif // __STOUT_OS_POSIX_FTRUNCATE_HPP__</span></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="classTry_html"><div class="ttname"><a href="classTry.html">Try</a></div><div class="ttdef"><b>Definition:</b> check.hpp:33</div></div>
-<div class="ttc" id="classErrnoError_html"><div class="ttname"><a href="classErrnoError.html">ErrnoError</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:49</div></div>
+<div class="ttc" id="classErrnoError_html"><div class="ttname"><a href="classErrnoError.html">ErrnoError</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:50</div></div>
<div class="ttc" id="namespaceos_html"><div class="ttname"><a href="namespaceos.html">os</a></div><div class="ttdef"><b>Definition:</b> posix_signalhandler.hpp:23</div></div>
<div class="ttc" id="nothing_8hpp_html"><div class="ttname"><a href="nothing_8hpp.html">nothing.hpp</a></div></div>
<div class="ttc" id="error_8hpp_html"><div class="ttname"><a href="error_8hpp.html">error.hpp</a></div></div>
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/d7774475/content/api/latest/c++/posix_2killtree_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/posix_2killtree_8hpp_source.html b/content/api/latest/c++/posix_2killtree_8hpp_source.html
index b9cdfad..e4653cc 100644
--- a/content/api/latest/c++/posix_2killtree_8hpp_source.html
+++ b/content/api/latest/c++/posix_2killtree_8hpp_source.html
@@ -52,7 +52,7 @@
<div class="title">killtree.hpp</div> </div>
</div><!--header-->
<div class="contents">
-<a href="posix_2killtree_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 cl
ass="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#ifndef __STOUT_OS_POSIX_KILLTREE_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#define __STOUT_OS_POSIX_KILLTREE_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 <stdlib.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> <span class="preprocessor">#include <list></span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="prepro
cessor">#include <queue></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <set></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> </div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2check_8hpp.html">stout/check.hpp</a>></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="os_8hpp.html">stout/os.hpp</a>></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 <<a class="code" href="pstree_8hpp.html">stout/os/pstree.hpp</a>></span></div><div class="line"><a name="l00027"></a><span cl
ass="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</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="comment">// Forward declarations from os.hpp.</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="keyword">inline</span> std::set<pid_t> <a class="code" href="namespaceos.html#a363f959e94e301ec8ec483e3c22258a6">children</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>, <span class="keyword">const</span> std::list<Process>&, <span class="keywordtype">bool</span>);</div><div class="line"><
a name="l00033"></a><span class="lineno"> 33</span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<Process></a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>);</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="keyword">inline</span> <a class="code" href="classOption.html">Option<Process></a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>, <span class="keyword">const</span> std::list<Process>&);</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list&
lt;Process></a>> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>();</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<ProcessTree></a>> <a class="code" href="namespaceos.html#ae610a9542f877147b89a2a6b7745c80f">pstrees</a>(</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="keyword">const</span> std::set<pid_t>&,</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <span class="keyword">const</span> std::list<Process>&);</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> </div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// Sends a signal t
o a process tree rooted at the specified pid.</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">// If groups is true, this also sends the signal to all encountered</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// process groups.</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// If sessions is true, this also sends the signal to all encountered</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// process sessions.</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// Note that processes of the group and session of the parent of the</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// root process is not included
unless they are part of the root</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// process tree.</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// Note that if the process 'pid' has exited we'll signal the process</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// tree(s) rooted at pids in the group or session led by the process</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// if groups = true or sessions = true, respectively.</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// Returns the process trees that were successfully or unsuccessfully</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">
// signaled. Note that the process trees can be stringified.</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// TODO(benh): Allow excluding the root pid from stopping, killing,</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// and continuing so as to provide a means for expressing "kill all of</span></div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// my children". This is non-trivial because of the current</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// implementation.</span></div><div class="line"><a name="l00058"></a><span class="lineno"><a class="line" href="namespaceos.html#ae7bf571af786eae39cb025d516566168"> 58</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<
;ProcessTree></a>> <a class="code" href="namespaceos.html#ae7bf571af786eae39cb025d516566168">killtree</a>(</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid,</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywordtype">int</span> signal,</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="keywordtype">bool</span> groups = <span class="keyword">false</span>,</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <span class="keywordtype">bool</span> sessions = <span class="keyword">false</span>)</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> {</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</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="l00065"></a><span class="lineno"> 65</span> </div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="keywordflow">if</span> (processes.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</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="l00068"></a><span class="lineno"> 68</span>  }</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div><div class="li
ne"><a name="l00070"></a><span class="lineno"> 70</span>  <a class="code" href="classResult.html">Result<Process></a> <a class="code" href="namespaceprocess.html">process</a> = <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">os::process</a>(pid, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> </div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  std::queue<pid_t> queue;</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="comment">// If the root process has already terminated we'll add in any pids</span></div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="comment">// that are in the process group original
ly led by pid or in the</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="comment">// session originally led by pid, if instructed.</span></div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keywordflow">if</span> (process.isNone()) {</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& _process, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()) {</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keywordflow">if</span> (groups && _process.<a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</a> == pid) {</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</s
pan>  queue.push(_process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (sessions &&</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</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="l00083"></a><span class="lineno"> 83</span>  _process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == pid) {</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> 
queue.push(_process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  }</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  }</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// Root process is not running and no processes found in the</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// process group or session so nothing we can do.</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="keywordflow">if</span> (queue.empty()) {</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keywordflow">return</span>
std::list<ProcessTree>();</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="keywordflow">else</span> {</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="comment">// Start the traversal from pid as the root.</span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  queue.push(pid);</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  }</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="keyword">struct </span>{</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  std::set<pid_t> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">pids</a
>;</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  std::set<pid_t> groups;</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  std::set<pid_t> sessions;</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  std::list<Process> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>;</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  } visited;</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">// If we are following groups and/or sessions then we try and make</span></div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="comment">// the group and session of the parent process "already visited" so</span></div
><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="comment">// that we don't kill "up the tree". This can only be done if the</span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="comment">// process is present.</span></div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  <span class="keywordflow">if</span> (process.isSome() && (groups || sessions)) {</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <a class="code" href="classOption.html">Option<Process></a> parent = <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">os::process</a>(process->parent, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span> </div><div class="line"><a name="l00112"></a><sp
an class="lineno"> 112</span>  <span class="keywordflow">if</span> (parent.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>()) {</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="keywordflow">if</span> (groups) {</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  visited.groups.insert(parent-><a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</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>  <span class="keywordflow">if</span> (sessions && parent-><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="l0011
7"></a><span class="lineno"> 117</span>  visited.sessions.insert(parent-><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="l00118"></a><span class="lineno"> 118</span>  }</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  }</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  }</div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span> </div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="keywordflow">while</span> (!queue.empty()) {</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid = queue.front();</div><di
v class="line"><a name="l00124"></a><span class="lineno"> 124</span>  queue.pop();</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="keywordflow">if</span> (visited.pids.count(pid) != 0) {</div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="keywordflow">continue</span>;</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="comment">// Make sure this process still exists.</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  process = <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">os::process</a>(pid);</div><div c
lass="line"><a name="l00132"></a><span class="lineno"> 132</span> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="keywordflow">if</span> (process.isError()) {</div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(process.error());</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (process.isNone()) {</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  }</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span c
lass="comment">// Stop the process to keep it from forking while we are killing</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="comment">// it since a forked child might get re-parented by init and</span></div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="comment">// become impossible to find.</span></div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="namespaceos.html#a45423d28aabced8c82165ee906930732">kill</a>(pid, SIGSTOP);</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>  visited.pids.insert(pid);</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  visited.processes.push_back(process.get());</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</sp
an> </div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// Now refresh the process list knowing that the current process</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// can't fork any more children (since it's stopped).</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  processes = <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">os::processes</a>();</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="keywordflow">if</span> (processes.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</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="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>  <span class="comment">// Enqueue the children for visiting.</span></div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordflow">foreach</span> (<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> child, <a class="code" href="namespaceos.html#a363f959e94e301ec8ec483e3c22258a6">os::children</a>(pid, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(), <span class="keyword">false</span>)) {</div><div class="line"><a name="l00157"></a>
<span class="lineno"> 157</span>  queue.push(child);</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  }</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">// Now "visit" the group and/or session of the current process.</span></div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="keywordflow">if</span> (groups) {</div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> <a class="code" href="structgroup.html">group</a> = process->group;</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="keywordflow">if</span> (visited.groups.count(group) == 0
) {</div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& process, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()) {</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keywordflow">if</span> (process.<a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</a> == group) {</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  queue.push(process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  }</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>  visited.groups.insert(group);</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>  <span class="comment">// If we do not have a session for the process, it's likely</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  <span class="comment">// because the process is a zombie on OS X. This implies it has</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="comment">// not been reaped and thus is located somewhere in the tree we</span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span
class="comment">// are trying to kill. Therefore, we should discover it from our</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="comment">// tree traversal, or through its group (which is always present).</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="keywordflow">if</span> (sessions && process->session.isSome()) {</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> session = process->session.get();</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="keywordflow">if</span> (visited.sessions.count(session) == 0) {</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <span class="keywordflow">foreach</span> (<span c
lass="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& process, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()) {</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keywordflow">if</span> (process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == session) {</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  queue.push(process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</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>  }</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  visited.sessions.insert(session);</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>  }</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="comment">// Now that all processes are stopped, we send the signal.</span></div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="keywordflow">foreach</span> (<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669
493997f9">pid_t</a> pid, visited.pids) {</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <a class="code" href="namespaceos.html#a45423d28aabced8c82165ee906930732">kill</a>(pid, signal);</div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  }</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="comment">// There is a concern that even though some process is stopped,</span></div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="comment">// sending a signal to any of its children may cause a SIGCLD to</span></div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="comment">// be delivered to it which wakes it up (or any other signal maybe</span></div><div class="line"><a name="l00199"></a><span class="lineno
"> 199</span>  <span class="comment">// delivered). However, from the Open Group standards on "Signal</span></div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="comment">// Concepts":</span></div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="comment">//</span></div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="comment">// "While a process is stopped, any additional signals that are</span></div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="comment">// sent to the process shall not be delivered until the process</span></div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="comment">// is continued, except SIGKILL which always terminates the</span></div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span> 
<span class="comment">// receiving process."</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="comment">//</span></div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="comment">// In practice, this is not what has been witnessed. Rather, a</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="comment">// process that has been stopped will respond to SIGTERM, SIGINT,</span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="comment">// etc. That being said, we still continue the process below in the</span></div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="comment">// event that it doesn't terminate from the sending signal but it</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span clas
s="comment">// also doesn't get continued (as per the specifications above).</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="comment">// Try and continue the processes in case the signal is</span></div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="comment">// non-terminating but doesn't continue the process.</span></div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keywordflow">foreach</span> (<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid, visited.pids) {</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <a class="code" href="namespaceos.html#a45423d28aabced8c82165ee906930732">kill</a>(pid, SIGCONT);</div><div class="line"><a name="l
00217"></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>  <span class="comment">// Return the process trees representing the visited pids.</span></div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#ae610a9542f877147b89a2a6b7745c80f">pstrees</a>(visited.pids, visited.processes);</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> </div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> } <span class="comment">// namespace os {</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"> 225</span> <span class="preprocessor">#endif // __STOUT_OS_POSIX_KILLTREE_HPP__</span></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>
+<a href="posix_2killtree_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 cl
ass="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#ifndef __STOUT_OS_POSIX_KILLTREE_HPP__</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#define __STOUT_OS_POSIX_KILLTREE_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 <stdlib.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> <span class="preprocessor">#include <list></span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="prepro
cessor">#include <queue></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <set></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> </div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2check_8hpp.html">stout/check.hpp</a>></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <<a class="code" href="os_8hpp.html">stout/os.hpp</a>></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 <<a class="code" href="pstree_8hpp.html">stout/os/pstree.hpp</a>></span></div><div class="line"><a name="l00027"></a><span cl
ass="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a> {</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="comment">// Forward declarations from os.hpp.</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="keyword">inline</span> std::set<pid_t> <a class="code" href="namespaceos.html#a363f959e94e301ec8ec483e3c22258a6">children</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>, <span class="keyword">const</span> std::list<Process>&, <span class="keywordtype">bool</span>);</div><div class="line"><
a name="l00033"></a><span class="lineno"> 33</span> <span class="keyword">inline</span> <a class="code" href="classResult.html">Result<Process></a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>);</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="keyword">inline</span> <a class="code" href="classOption.html">Option<Process></a> <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">process</a>(<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a>, <span class="keyword">const</span> std::list<Process>&);</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list&
lt;Process></a>> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>();</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<ProcessTree></a>> <a class="code" href="namespaceos.html#ae610a9542f877147b89a2a6b7745c80f">pstrees</a>(</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="keyword">const</span> std::set<pid_t>&,</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <span class="keyword">const</span> std::list<Process>&);</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> </div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// Sends a signal t
o a process tree rooted at the specified pid.</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">// If groups is true, this also sends the signal to all encountered</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// process groups.</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// If sessions is true, this also sends the signal to all encountered</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// process sessions.</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// Note that processes of the group and session of the parent of the</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// root process is not included
unless they are part of the root</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// process tree.</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// Note that if the process 'pid' has exited we'll signal the process</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// tree(s) rooted at pids in the group or session led by the process</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// if groups = true or sessions = true, respectively.</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// Returns the process trees that were successfully or unsuccessfully</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">
// signaled. Note that the process trees can be stringified.</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// TODO(benh): Allow excluding the root pid from stopping, killing,</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// and continuing so as to provide a means for expressing "kill all of</span></div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// my children". This is non-trivial because of the current</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// implementation.</span></div><div class="line"><a name="l00058"></a><span class="lineno"><a class="line" href="namespaceos.html#ae7bf571af786eae39cb025d516566168"> 58</a></span> <span class="keyword">inline</span> <a class="code" href="classTry.html">Try<std::list<
;ProcessTree></a>> <a class="code" href="namespaceos.html#ae7bf571af786eae39cb025d516566168">killtree</a>(</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid,</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywordtype">int</span> signal,</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="keywordtype">bool</span> groups = <span class="keyword">false</span>,</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <span class="keywordtype">bool</span> sessions = <span class="keyword">false</span>)</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> {</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</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="l00065"></a><span class="lineno"> 65</span> </div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="keywordflow">if</span> (processes.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</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="l00068"></a><span class="lineno"> 68</span>  }</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div><div class="li
ne"><a name="l00070"></a><span class="lineno"> 70</span>  <a class="code" href="classResult.html">Result<Process></a> <a class="code" href="namespaceprocess.html">process</a> = <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">os::process</a>(pid, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> </div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  std::queue<pid_t> queue;</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="comment">// If the root process has already terminated we'll add in any pids</span></div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="comment">// that are in the process group original
ly led by pid or in the</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  <span class="comment">// session originally led by pid, if instructed.</span></div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="keywordflow">if</span> (process.isNone()) {</div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& _process, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()) {</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keywordflow">if</span> (groups && _process.<a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</a> == pid) {</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</s
pan>  queue.push(_process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (sessions &&</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</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="l00083"></a><span class="lineno"> 83</span>  _process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == pid) {</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> 
queue.push(_process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  }</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  }</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// Root process is not running and no processes found in the</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// process group or session so nothing we can do.</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="keywordflow">if</span> (queue.empty()) {</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keywordflow">return</span>
std::list<ProcessTree>();</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="keywordflow">else</span> {</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="comment">// Start the traversal from pid as the root.</span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  queue.push(pid);</div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  }</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="keyword">struct </span>{</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  std::set<pid_t> <a class="code" href="namespaceos.html#a42af1cab63434cedf2b698cd6f49f073">pids</a
>;</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  std::set<pid_t> groups;</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  std::set<pid_t> sessions;</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  std::list<Process> <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">processes</a>;</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  } visited;</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">// If we are following groups and/or sessions then we try and make</span></div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="comment">// the group and session of the parent process "already visited" so</span></div
><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="comment">// that we don't kill "up the tree". This can only be done if the</span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="comment">// process is present.</span></div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  <span class="keywordflow">if</span> (process.isSome() && (groups || sessions)) {</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <a class="code" href="classOption.html">Option<Process></a> parent = <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">os::process</a>(process->parent, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>());</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span> </div><div class="line"><a name="l00112"></a><sp
an class="lineno"> 112</span>  <span class="keywordflow">if</span> (parent.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>()) {</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="keywordflow">if</span> (groups) {</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  visited.groups.insert(parent-><a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</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>  <span class="keywordflow">if</span> (sessions && parent-><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="l0011
7"></a><span class="lineno"> 117</span>  visited.sessions.insert(parent-><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="l00118"></a><span class="lineno"> 118</span>  }</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  }</div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  }</div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span> </div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="keywordflow">while</span> (!queue.empty()) {</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid = queue.front();</div><di
v class="line"><a name="l00124"></a><span class="lineno"> 124</span>  queue.pop();</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="keywordflow">if</span> (visited.pids.count(pid) != 0) {</div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="keywordflow">continue</span>;</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="comment">// Make sure this process still exists.</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  process = <a class="code" href="namespaceos.html#ae19e4161a51b86a1f330f3bf1dc75389">os::process</a>(pid);</div><div c
lass="line"><a name="l00132"></a><span class="lineno"> 132</span> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="keywordflow">if</span> (process.isError()) {</div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(process.error());</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (process.isNone()) {</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  }</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span c
lass="comment">// Stop the process to keep it from forking while we are killing</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="comment">// it since a forked child might get re-parented by init and</span></div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="comment">// become impossible to find.</span></div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <a class="code" href="namespaceos.html#a45423d28aabced8c82165ee906930732">kill</a>(pid, SIGSTOP);</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>  visited.pids.insert(pid);</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  visited.processes.push_back(process.get());</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</sp
an> </div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// Now refresh the process list knowing that the current process</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// can't fork any more children (since it's stopped).</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  processes = <a class="code" href="namespaceos.html#aa98ca8ac255e2b9c689979a1b40084d3">os::processes</a>();</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="keywordflow">if</span> (processes.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</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="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>  <span class="comment">// Enqueue the children for visiting.</span></div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordflow">foreach</span> (<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> child, <a class="code" href="namespaceos.html#a363f959e94e301ec8ec483e3c22258a6">os::children</a>(pid, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>(), <span class="keyword">false</span>)) {</div><div class="line"><a name="l00157"></a>
<span class="lineno"> 157</span>  queue.push(child);</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  }</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">// Now "visit" the group and/or session of the current process.</span></div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="keywordflow">if</span> (groups) {</div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> <a class="code" href="structgroup.html">group</a> = process->group;</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="keywordflow">if</span> (visited.groups.count(group) == 0
) {</div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& process, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()) {</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keywordflow">if</span> (process.<a class="code" href="structos_1_1Process.html#a41f9befab165fd224ba2d829e7c35ba6">group</a> == group) {</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  queue.push(process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</a>);</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  }</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>  visited.groups.insert(group);</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>  <span class="comment">// If we do not have a session for the process, it's likely</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  <span class="comment">// because the process is a zombie on OS X. This implies it has</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="comment">// not been reaped and thus is located somewhere in the tree we</span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span
class="comment">// are trying to kill. Therefore, we should discover it from our</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="comment">// tree traversal, or through its group (which is always present).</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="keywordflow">if</span> (sessions && process->session.isSome()) {</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> session = process->session.get();</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  <span class="keywordflow">if</span> (visited.sessions.count(session) == 0) {</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <span class="keywordflow">foreach</span> (<span c
lass="keyword">const</span> <a class="code" href="structos_1_1Process.html">Process</a>& process, processes.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>()) {</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keywordflow">if</span> (process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a4e3bf8416d95246f43c91f1b5c309323">isSome</a>() && process.<a class="code" href="structos_1_1Process.html#a688cf2d2f64d48fc510aa78a952c5ad4">session</a>.<a class="code" href="classOption.html#a21358442c0fac1cc978a67a9a9089a79">get</a>() == session) {</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  queue.push(process.<a class="code" href="structos_1_1Process.html#a8c68e0a8c8693f2acacf0f428ea0a493">pid</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>  }</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  visited.sessions.insert(session);</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>  }</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="comment">// Now that all processes are stopped, we send the signal.</span></div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="keywordflow">foreach</span> (<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669
493997f9">pid_t</a> pid, visited.pids) {</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <a class="code" href="namespaceos.html#a45423d28aabced8c82165ee906930732">kill</a>(pid, signal);</div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  }</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="comment">// There is a concern that even though some process is stopped,</span></div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="comment">// sending a signal to any of its children may cause a SIGCLD to</span></div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="comment">// be delivered to it which wakes it up (or any other signal maybe</span></div><div class="line"><a name="l00199"></a><span class="lineno
"> 199</span>  <span class="comment">// delivered). However, from the Open Group standards on "Signal</span></div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="comment">// Concepts":</span></div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="comment">//</span></div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="comment">// "While a process is stopped, any additional signals that are</span></div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="comment">// sent to the process shall not be delivered until the process</span></div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="comment">// is continued, except SIGKILL which always terminates the</span></div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span> 
<span class="comment">// receiving process."</span></div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="comment">//</span></div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="comment">// In practice, this is not what has been witnessed. Rather, a</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="comment">// process that has been stopped will respond to SIGTERM, SIGINT,</span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="comment">// etc. That being said, we still continue the process below in the</span></div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  <span class="comment">// event that it doesn't terminate from the sending signal but it</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span clas
s="comment">// also doesn't get continued (as per the specifications above).</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="comment">// Try and continue the processes in case the signal is</span></div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="comment">// non-terminating but doesn't continue the process.</span></div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keywordflow">foreach</span> (<a class="code" href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#ab03ced250ed239bc3b50b669493997f9">pid_t</a> pid, visited.pids) {</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <a class="code" href="namespaceos.html#a45423d28aabced8c82165ee906930732">kill</a>(pid, SIGCONT);</div><div class="line"><a name="l
00217"></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>  <span class="comment">// Return the process trees representing the visited pids.</span></div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keywordflow">return</span> <a class="code" href="namespaceos.html#ae610a9542f877147b89a2a6b7745c80f">pstrees</a>(visited.pids, visited.processes);</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> </div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span> } <span class="comment">// namespace os {</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"> 225</span> <span class="preprocessor">#endif // __STOUT_OS_POSIX_KILLTREE_HPP__</span></div><div class="ttc" id="classError_html"><div class="ttname"><a href="classError.html">Error</a></div><div class="ttdef"><b>Definition:</b> errorbase.hpp:36</div></div>
<div class="ttc" id="classOption_html"><div class="ttname"><a href="classOption.html">Option</a></div><div class="ttdef"><b>Definition:</b> option.hpp:28</div></div>
<div class="ttc" id="classTry_html_a8bc7f43e75a47111ea18e9c83b007be5"><div class="ttname"><a href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">Try::get</a></div><div class="ttdeci">T & get()&</div><div class="ttdef"><b>Definition:</b> try.hpp:73</div></div>
<div class="ttc" id="classTry_html"><div class="ttname"><a href="classTry.html">Try</a></div><div class="ttdef"><b>Definition:</b> check.hpp:33</div></div>